Review and complete the examples/test chart fixtures

examples/test/10key-dp.bms

@@ -0,0 +1,61 @@
+*---------------------- METADATA FIELD
+
+#TITLE 10 KEY DP Lane Mode
+#SUBTITLE IIDX 5-key double play - channels 11..16 and 21..26
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 2
+#TOTAL 250
+#DIFFICULTY 2
+
+*---------------------- EXTENDED HEADER FIELD
+* The 2P-side, no-6/7 corner of the IIDX lane-mode table: five keys plus scratch
+* on both sides, which must resolve to 10 KEY DP.
+*
+* This chart is also the counter-example for the PMS-STD content rule. That rule
+* claims any chart touching `22..25` for 9 KEY, but only when the traditional
+* IIDX 2P channels (`21` and `26..29`) are absent. A real 5-key DP chart authors
+* `21` and `26` alongside `22..25`, so it has to stay 10 KEY DP.
+*
+* See 5key-sp.bms for the rest of the lane-mode fixture family.
+
+#PLAYER 2
+#LNTYPE 1
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - one eighth note per lane, sweeping 1P left to right then 2P.
+#00011:0100000000000000
+#00012:0001000000000000
+#00013:0000010000000000
+#00014:0000000100000000
+#00015:0000000001000000
+#00021:0000000000010000
+#00022:0000000000000100
+#00023:0000000000000001
+
+* Measure 1 - scratch on both sides, keys alternating between the two players.
+#00016:02000200
+#00026:00020002
+#00111:01000100
+#00115:01000100
+#00121:00010001
+#00125:00010001
+
+* Measure 2 - the 2P keyboard columns 22..25 on their own. Without 21 / 26 in
+* the chart this measure alone would look like PMS-STD, so it exists to keep the
+* 10 KEY DP classification honest.
+#00222:01010101
+#00223:01010101
+#00224:01010101
+#00225:01010101
+
+*---------------------- CONTROL FLOW FIELD

examples/test/5key-sp.bms

@@ -0,0 +1,59 @@
+*---------------------- METADATA FIELD
+
+#TITLE 5 KEY SP Lane Mode
+#SUBTITLE IIDX 5-key single play - channels 11..16, no 18 / 19
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 1
+#TOTAL 200
+#DIFFICULTY 1
+
+*---------------------- EXTENDED HEADER FIELD
+* Lane-mode detection falls through to the IIDX family when no POPN or keyboard
+* marker matches, and then splits on two signals only: whether the chart uses
+* the 2P side, and whether it uses the 6th / 7th columns (`18` / `19` / `28` /
+* `29`). This chart is the 1P-side, no-6/7 corner of that table: five keys plus
+* scratch, which must resolve to 5 KEY SP.
+*
+* Keeping it as `.bms` matters - the extension carries no lane information for
+* this family, so the classification has to come from the channels alone.
+*
+* Companion fixtures for the rest of the family:
+*   10key-dp.bms                - 5 keys on both sides            -> 10 KEY DP
+*   ln-mode-1-long-note.bms     - 1P side with 18 / 19            -> 7 KEY SP
+*   lane-order-test.bms         - both sides with 18 / 19 / 28 / 29 -> 14 KEY DP
+*   9key-all-keys-quarter.pms   - PMS-STD                          -> 9 KEY
+*   24key-keyboard-sp.bme       - extended 1A..1O columns          -> 24 KEY SP
+*   48key-keyboard-dp.bme       - extended columns on both sides    -> 48 KEY DP
+
+#PLAYER 1
+#LNTYPE 1
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - one eighth note per lane, left to right, then scratch.
+#00011:0100000000000000
+#00012:0001000000000000
+#00013:0000010000000000
+#00014:0000000100000000
+#00015:0000000001000000
+#00016:0000000000020000
+
+* Measure 1 - all five keys as a chord on every quarter note, scratch on the
+* backbeat.
+#00111:01010101
+#00112:01010101
+#00113:01010101
+#00114:01010101
+#00115:01010101
+#00116:00020002
+
+*---------------------- CONTROL FLOW FIELD

examples/test/7key-longnote.bml

@@ -0,0 +1,62 @@
+*---------------------- METADATA FIELD
+
+#TITLE 7 KEY Long Note (BML)
+#SUBTITLE The .bml extension - 7 keys plus scratch with #LNOBJ long notes
+#ARTIST be-music
+#GENRE TEST
+#BPM 140
+#PLAYLEVEL 5
+#TOTAL 300
+#DIFFICULTY 3
+
+*---------------------- EXTENDED HEADER FIELD
+* `.bml` is the fourth chart extension the toolchain accepts, alongside `.bms`,
+* `.bme` and `.pms`. It carries no parsing rule of its own - by convention it
+* marks a 7-key chart that uses long notes - so it only shows up in the
+* extension allow-lists (the player-tui chart picker, the player-web drop
+* handler, the CLI usage line) and in lane-mode detection's "not .pms" path.
+*
+* Without a real `.bml` file in this directory those allow-list entries were
+* only ever tested against synthetic paths, so this chart exists to be opened:
+* it has to parse like any other BMS chart and classify as 7 KEY SP.
+
+#PLAYER 1
+#LNTYPE 1
+#LNMODE 1
+#LNOBJ ZZ
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+#WAV03 right.wav
+#WAVZZ sample.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - count-in on the seven keys, scratch on the backbeat.
+#00011:01010101
+#00013:00020002
+#00015:02000200
+#00016:00030003
+
+* Measure 1 - a 2-beat long note per key group, which is what the extension is
+* conventionally used to advertise.
+#00111:0100ZZ00
+#00113:0100ZZ00
+#00115:0100ZZ00
+
+* Measure 2 - the 6th and 7th columns (18 / 19), which are what separate 7 KEY
+* from 5 KEY in lane-mode detection.
+#00218:010000ZZ
+#00219:010000ZZ
+
+* Measure 3 - scratch plus a chord, no long notes.
+#00311:01010101
+#00318:00020002
+#00319:02000200
+#00316:00030003
+
+*---------------------- CONTROL FLOW FIELD

examples/test/README.ja.md

@@ -0,0 +1,121 @@
+# テスト譜面フィクスチャ
+
+[English version](./README.md)
+
+be-music のテストスイートが共有する譜面・音声フィクスチャ置き場です。各譜面は「ひとつのまとまった機能群」を対象にし、
+かつ必ずどこかのテストから読まれます。どのテストからも読まれないフィクスチャは誰にも気づかれないまま古くなり、
+実際にこのディレクトリで見つかった不具合はすべてそれが原因でした。
+
+コーパス全体の番人は [`packages/parser/src/fixtures.test.ts`](../../packages/parser/src/fixtures.test.ts) です。
+このディレクトリを走査してすべての譜面をディスクから読み、制御フロー解決後にプレイ可能なイベントが残ることを要求します。
+譜面を追加すれば自動的に対象に入り、壊せばこのテストが落ちます。
+
+## 規約
+
+- 譜面名は対象機能に合わせた kebab-case にする。
+- 拡張子は意図して選ぶ。`.bms` / `.bme` / `.bml` / `.pms` はレーンモード判定に効くため、拡張子自体がフィクスチャの
+  検証対象の一部になる。
+- 既存譜面と同じ `*---------------------- ... FIELD` のセクション見出しで始め、`*` コメントブロックに
+  「何のための譜面か」「変えると何が壊れるか」を書く。
+- `#WAV` などで参照する音声は、このディレクトリに実在するファイルだけにする。そうすれば全譜面が手動プレイでも鳴る。
+
+## 機能別の譜面
+
+### ヘッダ・命令カバレッジ
+
+| ファイル                              | 対象                                                                                                                     |
+| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `four-measure-command-combo-test.bms` | パーサが振り分ける拡張ヘッダとオブジェクトチャネルを網羅。コマンド群ごとに 4 小節ブロック。検証しているのは振り分けとラウンドトリップ保持で、ペイロードの妥当性ではない。 |
+| `extended-directives.bms`             | 同じ命令群を `@be-music/chart` の値パーサが受け付けるペイロードで記述。`#EXWAV` の `pvf`、`#EXBMP` の ARGB タプル、`#ARGB` の 16 進と 10 進、`#BGA` 部分矩形、`#SWBGA` アニメーション、`#WAVCMD` の pitch/volume/loop、チャネル `A0` からの `#EXRANK`、チャネル `A6` からの `#CHANGEOPTION`、`#STP`。 |
+| `base62-ids.bms`                      | `#BASE 62` — 大文字・小文字・混在の ID を別スロットとして扱う。インデックス付きヘッダ、チャネルストリーム、`#LNOBJ`、`#RANDOM` / `#IF` ブロック内のすべてで検証。 |
+| `sjis-encoding-test.bms`              | Shift_JIS の自動判定。パース結果の IR は `sjis-encoding-test.json` に固定してある。                                        |
+| `benchmark-command-mix-100.bms`       | 混在コマンド 100 小節でのパーサスループット。`pnpm bench` は独自のインライン譜面を使うため、こちらには繋がっていない。       |
+
+### タイミング・描画ギミック
+
+| ファイル                   | 対象                                                                                                                       |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| `scroll-speed-gimmick.bms` | ギミック 1 種につき 1 小節。`#xxx02` 小節長、`#xxx03` 16 進 BPM、`#xxx08` `#BPMxx` 参照、`#xxx09` STOP、`#xxxSC` `#SCROLLxx`（`0` と負値を含む）、`#xxxSP` `#SPEEDxx`、最後に全部を同一小節に。 |
+| `measure-length.bms`       | 通常小節に挟まれた 1 小節だけの短縮。                                                                                       |
+| `bus-volume-channels.bms`  | チャネル `97`（BGM バス）と `98`（キー音バス）の動的音量。両バスが同一拍で動くケースも含む。                                 |
+| `nonpositive-bpm.bms`      | チャネル `08` が 0 のスロット・負のスロット・未定義スロットを指すケース。タイムラインが捨てざるを得ないテンポ点と、それでも譜面が成立し続けることを検証。 |
+
+### ロングノート
+
+| ファイル                         | 対象                                                                             |
+| -------------------------------- | -------------------------------------------------------------------------------- |
+| `ln-mode-1-long-note.bms`        | `#LNMODE 1`（LN）を `#LNOBJ` の始点／終点ペアで。7 KEY SP のレーンフィクスチャ兼用。 |
+| `ln-mode-2-charge-note.bms`      | `#LNMODE 2`（CN）— 譜面データは同一、モードのみ差分。                             |
+| `ln-mode-3-hell-charge-note.bms` | `#LNMODE 3`（HCN）— 譜面データは同一、モードのみ差分。                            |
+| `lntype2-long-note.bms`          | `#LNTYPE 2` の連続記法。1 小節内の 1 連、空きスロットで分かれた 2 連、小節境界をまたぐ 1 連。 |
+| `ln-9key-popn.bms`               | `#PLAYER 3` で POPN 9 レーン全部にロングノート。                                  |
+
+### レーンモード
+
+`resolveChartPlayVariant` の分岐ごとに 1 譜面。
+
+| ファイル                    | レーンモード                        |
+| --------------------------- | ----------------------------------- |
+| `5key-sp.bms`               | 5 KEY SP                            |
+| `ln-mode-1-long-note.bms`   | 7 KEY SP                            |
+| `9key-all-keys-quarter.pms` | 9 KEY（PMS-STD）                    |
+| `ln-9key-popn.bms`          | 9 KEY（`#PLAYER 3` + チャネル `17`） |
+| `10key-dp.bms`              | 10 KEY DP                           |
+| `lane-order-test.bms`       | 14 KEY DP — レーン順序の譜面も兼ねる。両サイドの全クラシックカラムを使用。 |
+| `24key-keyboard-sp.bme`     | 24 KEY SP — 拡張 `1A..1O` カラム    |
+| `48key-keyboard-dp.bme`     | 48 KEY DP — 両サイドの拡張カラム    |
+| `7key-longnote.bml`         | 7 KEY SP — `.bml` 拡張子。独自のパース規則は持たないが、譜面ファイルの許可リストにはすべて載っている。 |
+
+### レーンとハザード
+
+| ファイル              | 対象                                                                                                            |
+| --------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `invisible-notes.bms` | 不可視キー音チャネル `3x` / `4x` — 鳴るが描画も判定もされない。かつ 2P 側の `4x` があっても 1 人プレイ譜面が DP 扱いになってはいけない。 |
+
+### 制御フロー
+
+| ファイル                       | 対象                                                                                                       |
+| ------------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| `control-flow-random-demo.bms` | `#RANDOM` / `#IF` / `#ELSE`（メタデータ上書きあり）と `#SWITCH` / `#CASE` / `#DEF` を 2 ブロック。全オブジェクトが分岐内にあるため、制御フローを解決するまで譜面は空。 |
+
+### bmson
+
+| ファイル                            | 対象                                                                                          |
+| ----------------------------------- | --------------------------------------------------------------------------------------------- |
+| `bmson-strict-features.bmson`       | `info` ブロック一式、`bga` のヘッダとイベント、`lines`、`notes[].l` / `.c`。                    |
+| `bmson-lines-resolution-test.bmson` | 不均等な `lines` と、解像度に依存する `stop_events.duration` の換算。                           |
+| `bmson-key-channels-mines.bmson`    | beatoraja 拡張。`mode_hint` のレーンマップ経由で `Dx` / `Ex` に載る `key_channels` 地雷、`info.ln_type`、`notes[].t`。 |
+
+### フォーマット間ラウンドトリップ
+
+次の 5 ファイルは組でしか意味を持たず、
+[`packages/editor/src/index.test.ts`](../../packages/editor/src/index.test.ts) が実パイプラインと突き合わせています。
+
+| ファイル                 | 役割                                       |
+| ------------------------ | ------------------------------------------ |
+| `sample.bms`             | 元譜面。                                    |
+| `sample.json`            | `importChart` の出力。                      |
+| `sample.roundtrip.bmson` | 同じ譜面を bmson へエクスポートしたもの。    |
+| `sample.edit.json`       | タイトル変更 1 回とノート追加 1 回を適用後。 |
+| `sample.edited.bms`      | その編集結果を `exportChart` で書き戻したもの。 |
+
+手書きで直さず、必ずエディタ API 経由で再生成してください。それが整合性を保つ唯一の方法です。
+
+### オーディオ再生
+
+| ファイル                              | 対象                                                                            |
+| ------------------------------------- | ------------------------------------------------------------------------------- |
+| `retrigger-same-key-cut.bms`          | BMS のモノフォニック再生。同一レーンの 2 発目が 1 発目を切る。                    |
+| `retrigger-different-key-overlap.bms` | 別レーンなら、両スロットが同一ファイルを指していても切らない。                    |
+| `ogg-test.bms`                        | `#WAV` が wav 以外のコーデックを指す譜面。ローダが Vorbis デコーダまで到達する必要がある。 |
+
+## 音声アセット
+
+| ファイル                                   | 用途                                                                  |
+| ------------------------------------------ | --------------------------------------------------------------------- |
+| `sample.wav`                               | ほとんどの譜面の既定キー音。audio-renderer の基準サンプルでもある。     |
+| `branch.wav`, `right.wav`, `wrong.wav`     | 副次的なキー音。主に制御フローの分岐を耳で聞き分けるため。               |
+| `retrigger_a.wav`, `retrigger_b.wav`       | リトリガー譜面が重なりを作るために必要な 2.2 秒サンプル。               |
+| `ogg-test.ogg`                             | `ogg-test.bms` が宣言する Vorbis サンプル。                            |
+| `ogg-test.wav`                             | `ogg-test.ogg` の非圧縮元データ。素材として残しているだけで、テストは読んでいない。 |
+| `render-codec-test.mp3` / `.ogg` / `.opus` | audio-renderer のコーデック別デコードケースと、`.wav` 不在時のフォールバックケース。 |