From afbcbed295a24ab1d21943e0371d4efff90e732c Mon Sep 17 00:00:00 2001
From: Seiya KONNO <nulltask@gmail.com>
Date: Mon, 24 Aug 2026 01:36:06 +0900
Subject: [PATCH 1/3] fix(examples): repair the broken test chart fixtures

`benchmark-command-mix-100.bms` parsed to zero events. It opened `#SETRANDOM 2` and `#RANDOM 2` back to back, and since both push a control-flow scope while only one `#ENDRANDOM` pops one, the capture stack never drained and all 100 measures of object data were swallowed into the trailing branch. Resolving the control flow recovered 3 events out of ~600. The same mistake repeated for `#SETSWITCH 3` / `#SWITCH 3` and the second `#SETRANDOM 3` / `#RANDOM 3`, so drop the three redundant scope openers and keep the deterministic `#SET*` form.

`sample.roundtrip.bms` was BMSON JSON under a `.bms` name, byte-identical to `sample.roundtrip.bmson`. Delete it.

`sample.json`, `sample.edit.json` and `sjis-encoding-test.json` still carried a pre-`bms`/`bmson`-extension IR shape that no current code path can produce, and `sample.roundtrip.bmson` put `resolution` at the document root instead of inside `info` and omitted `lines`. Regenerate all four through the editor API.

`lane-order-test.bms` and `sjis-encoding-test.bms` declared `#WAV01 test.wav`, which does not exist in this directory, so neither chart was playable. Point both at `sample.wav`.
---
 examples/test/benchmark-command-mix-100.bms |   3 -
 examples/test/lane-order-test.bms           |   2 +-
 examples/test/sample.edit.json              | 418 ++++++++++++++++++--
 examples/test/sample.json                   | 414 +++++++++++++++++--
 examples/test/sample.roundtrip.bms          |  99 -----
 examples/test/sample.roundtrip.bmson        |  18 +-
 examples/test/sjis-encoding-test.bms        |   2 +-
 examples/test/sjis-encoding-test.json       |  95 ++++-
 8 files changed, 870 insertions(+), 181 deletions(-)
 delete mode 100644 examples/test/sample.roundtrip.bms

diff --git a/examples/test/benchmark-command-mix-100.bms b/examples/test/benchmark-command-mix-100.bms
index 22ab10b6..45ae60ea 100644
--- a/examples/test/benchmark-command-mix-100.bms
+++ b/examples/test/benchmark-command-mix-100.bms
@@ -61,7 +61,6 @@
 *---------------------- CONTROL FLOW FIELD
 
 #SETRANDOM 2
-#RANDOM 2
 #IF 1
 #01011:0505
 #01016:05
@@ -71,7 +70,6 @@
 #ENDIF
 #ENDRANDOM
 #SETSWITCH 3
-#SWITCH 3
 #CASE 1
 #02011:01010101
 #SKIP
@@ -83,7 +81,6 @@
 #SKIP
 #ENDSW
 #SETRANDOM 3
-#RANDOM 3
 #IF 1
 #03004:01
 #ELSEIF 2
diff --git a/examples/test/lane-order-test.bms b/examples/test/lane-order-test.bms
index 22f68f84..cbb000db 100644
--- a/examples/test/lane-order-test.bms
+++ b/examples/test/lane-order-test.bms
@@ -8,7 +8,7 @@
 
 *---------------------- RESOURCES FIELD
 
-#WAV01 test.wav
+#WAV01 sample.wav
 
 *---------------------- MEASURE LENGTH FIELD
 
diff --git a/examples/test/sample.edit.json b/examples/test/sample.edit.json
index b002999a..de1a48e3 100644
--- a/examples/test/sample.edit.json
+++ b/examples/test/sample.edit.json
@@ -26,128 +26,472 @@
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "03",
-      "value": "64",
       "position": [
         0,
         1
-      ]
+      ],
+      "value": "64"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 3,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         2
+      ],
+      "value": "01"
+    }
+  ],
+  "bms": {
+    "controlFlow": [],
+    "lnObjs": [],
+    "exRank": {},
+    "argb": {},
+    "stp": [],
+    "wavCmds": [],
+    "changeOption": {},
+    "exWav": {},
+    "exBmp": {},
+    "bga": {},
+    "scroll": {},
+    "speed": {},
+    "swBga": {}
+  },
+  "bmson": {
+    "info": {},
+    "bga": {
+      "header": [],
+      "events": [],
+      "layerEvents": [],
+      "poorEvents": []
+    }
+  },
+  "preservation": {
+    "bms": {
+      "sourceLines": [
+        {
+          "kind": "header",
+          "command": "TITLE",
+          "value": "Sample"
+        },
+        {
+          "kind": "header",
+          "command": "ARTIST",
+          "value": "Codex"
+        },
+        {
+          "kind": "header",
+          "command": "BPM",
+          "value": "120"
+        },
+        {
+          "kind": "header",
+          "command": "WAV01",
+          "value": "sample.wav"
+        },
+        {
+          "kind": "object",
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 1,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 2,
+          "channel": "03",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "03",
+              "position": [
+                0,
+                1
+              ],
+              "value": "64"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 2,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        }
+      ],
+      "objectLines": [
+        {
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "measure": 1,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "measure": 2,
+          "channel": "03",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "03",
+              "position": [
+                0,
+                1
+              ],
+              "value": "64"
+            }
+          ]
+        },
+        {
+          "measure": 2,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        }
       ]
+    },
+    "bmson": {
+      "lines": [],
+      "bpmEvents": [],
+      "stopEvents": [],
+      "soundChannels": []
     }
-  ]
+  }
 }
diff --git a/examples/test/sample.json b/examples/test/sample.json
index ca52eaec..382976ff 100644
--- a/examples/test/sample.json
+++ b/examples/test/sample.json
@@ -21,119 +21,463 @@
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 1,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "03",
-      "value": "64",
       "position": [
         0,
         1
-      ]
+      ],
+      "value": "64"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
-        1
-      ]
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         1,
         4
-      ]
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
-        1,
-        2
-      ]
+        2,
+        4
+      ],
+      "value": "01"
     },
     {
       "measure": 2,
       "channel": "11",
-      "value": "01",
       "position": [
         3,
         4
+      ],
+      "value": "01"
+    }
+  ],
+  "bms": {
+    "controlFlow": [],
+    "lnObjs": [],
+    "exRank": {},
+    "argb": {},
+    "stp": [],
+    "wavCmds": [],
+    "changeOption": {},
+    "exWav": {},
+    "exBmp": {},
+    "bga": {},
+    "scroll": {},
+    "speed": {},
+    "swBga": {}
+  },
+  "bmson": {
+    "info": {},
+    "bga": {
+      "header": [],
+      "events": [],
+      "layerEvents": [],
+      "poorEvents": []
+    }
+  },
+  "preservation": {
+    "bms": {
+      "sourceLines": [
+        {
+          "kind": "header",
+          "command": "TITLE",
+          "value": "Sample"
+        },
+        {
+          "kind": "header",
+          "command": "ARTIST",
+          "value": "Codex"
+        },
+        {
+          "kind": "header",
+          "command": "BPM",
+          "value": "120"
+        },
+        {
+          "kind": "header",
+          "command": "WAV01",
+          "value": "sample.wav"
+        },
+        {
+          "kind": "object",
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 1,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 2,
+          "channel": "03",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "03",
+              "position": [
+                0,
+                1
+              ],
+              "value": "64"
+            }
+          ]
+        },
+        {
+          "kind": "object",
+          "measure": 2,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        }
+      ],
+      "objectLines": [
+        {
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "measure": 1,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 1,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        },
+        {
+          "measure": 2,
+          "channel": "03",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "03",
+              "position": [
+                0,
+                1
+              ],
+              "value": "64"
+            }
+          ]
+        },
+        {
+          "measure": 2,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                0,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                1,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                2,
+                4
+              ],
+              "value": "01"
+            },
+            {
+              "measure": 2,
+              "channel": "11",
+              "position": [
+                3,
+                4
+              ],
+              "value": "01"
+            }
+          ]
+        }
       ]
+    },
+    "bmson": {
+      "lines": [],
+      "bpmEvents": [],
+      "stopEvents": [],
+      "soundChannels": []
     }
-  ]
+  }
 }
diff --git a/examples/test/sample.roundtrip.bms b/examples/test/sample.roundtrip.bms
deleted file mode 100644
index f255169d..00000000
--- a/examples/test/sample.roundtrip.bms
+++ /dev/null
@@ -1,99 +0,0 @@
-{
-  "version": "1.0.0",
-  "info": {
-    "title": "Sample",
-    "subtitle": "",
-    "artist": "Codex",
-    "genre": "",
-    "level": 0,
-    "init_bpm": 120,
-    "mode_hint": "beat-1k"
-  },
-  "resolution": 240,
-  "bpm_events": [
-    {
-      "y": 1920,
-      "bpm": 100
-    }
-  ],
-  "stop_events": [],
-  "sound_channels": [
-    {
-      "name": "sample.wav",
-      "notes": [
-        {
-          "x": 1,
-          "y": 0,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 240,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 480,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 720,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 960,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 1200,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 1440,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 1680,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 1920,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 2160,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 2400,
-          "l": 0,
-          "c": false
-        },
-        {
-          "x": 1,
-          "y": 2640,
-          "l": 0,
-          "c": false
-        }
-      ]
-    }
-  ]
-}
diff --git a/examples/test/sample.roundtrip.bmson b/examples/test/sample.roundtrip.bmson
index f255169d..2ea04ff2 100644
--- a/examples/test/sample.roundtrip.bmson
+++ b/examples/test/sample.roundtrip.bmson
@@ -7,9 +7,23 @@
     "genre": "",
     "level": 0,
     "init_bpm": 120,
-    "mode_hint": "beat-1k"
+    "mode_hint": "beat-1k",
+    "resolution": 240
   },
-  "resolution": 240,
+  "lines": [
+    {
+      "y": 0
+    },
+    {
+      "y": 960
+    },
+    {
+      "y": 1920
+    },
+    {
+      "y": 2880
+    }
+  ],
   "bpm_events": [
     {
       "y": 1920,
diff --git a/examples/test/sjis-encoding-test.bms b/examples/test/sjis-encoding-test.bms
index 669b9f86..954ea67a 100644
--- a/examples/test/sjis-encoding-test.bms
+++ b/examples/test/sjis-encoding-test.bms
@@ -8,7 +8,7 @@
 
 *---------------------- RESOURCES FIELD
 
-#WAV01 test.wav
+#WAV01 sample.wav
 
 *---------------------- MEASURE LENGTH FIELD
 
diff --git a/examples/test/sjis-encoding-test.json b/examples/test/sjis-encoding-test.json
index 464eed60..3fa1df57 100644
--- a/examples/test/sjis-encoding-test.json
+++ b/examples/test/sjis-encoding-test.json
@@ -9,7 +9,7 @@
   },
   "resources": {
     "wav": {
-      "01": "test.wav"
+      "01": "sample.wav"
     },
     "bmp": {},
     "bpm": {},
@@ -21,11 +21,100 @@
     {
       "measure": 0,
       "channel": "11",
-      "value": "01",
       "position": [
         0,
         1
+      ],
+      "value": "01"
+    }
+  ],
+  "bms": {
+    "controlFlow": [],
+    "lnObjs": [],
+    "exRank": {},
+    "argb": {},
+    "stp": [],
+    "wavCmds": [],
+    "changeOption": {},
+    "exWav": {},
+    "exBmp": {},
+    "bga": {},
+    "scroll": {},
+    "speed": {},
+    "swBga": {}
+  },
+  "bmson": {
+    "info": {},
+    "bga": {
+      "header": [],
+      "events": [],
+      "layerEvents": [],
+      "poorEvents": []
+    }
+  },
+  "preservation": {
+    "bms": {
+      "sourceLines": [
+        {
+          "kind": "header",
+          "command": "TITLE",
+          "value": "テスト曲"
+        },
+        {
+          "kind": "header",
+          "command": "ARTIST",
+          "value": "佐藤"
+        },
+        {
+          "kind": "header",
+          "command": "BPM",
+          "value": "120"
+        },
+        {
+          "kind": "header",
+          "command": "WAV01",
+          "value": "sample.wav"
+        },
+        {
+          "kind": "object",
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                1
+              ],
+              "value": "01"
+            }
+          ]
+        }
+      ],
+      "objectLines": [
+        {
+          "measure": 0,
+          "channel": "11",
+          "events": [
+            {
+              "measure": 0,
+              "channel": "11",
+              "position": [
+                0,
+                1
+              ],
+              "value": "01"
+            }
+          ]
+        }
       ]
+    },
+    "bmson": {
+      "lines": [],
+      "bpmEvents": [],
+      "stopEvents": [],
+      "soundChannels": []
     }
-  ]
+  }
 }

From 7ab2b8370d26e78b831b4d0825bfa1ed2af6519f Mon Sep 17 00:00:00 2001
From: Seiya KONNO <nulltask@gmail.com>
Date: Mon, 24 Aug 2026 01:36:33 +0900
Subject: [PATCH 2/3] test(examples): cover the untested feature clusters with
 real chart fixtures
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

19 of the 36 files in `examples/test` were read by no test at all, which is how a benchmark chart that parses to zero events and a stale round-trip pair went unnoticed. Add `packages/parser/src/fixtures.test.ts` as the corpus-level guard: it scans the directory, parses every chart off disk, and requires each one to yield playable events after control-flow resolution, so a new fixture is picked up automatically and a broken one fails a test.

New fixtures, one per feature cluster that had none:

- `extended-directives.bms` — `#EXWAV` / `#EXBMP` / `#ARGB` / `#BGA` / `#SWBGA` / `#WAVCMD` / `#EXRANK` / `#CHANGEOPTION` with payloads the `@be-music/chart` value parsers accept. `four-measure-command-combo-test.bms` proves the parser routes these headers, but its payloads are placeholders (`#EXWAV01 ex_sample.wav`, `#BGA01 01`, `#WAVCMD legacy`) that every value parser rejects, so nothing covered a realistic payload off a real file.
- `scroll-speed-gimmick.bms` — one measure per timing / drawing gimmick, including the `SP` channel and the `#SCROLL 0` / `#SCROLL < 0` cases the player has an explicit compatibility policy for.
- `bus-volume-channels.bms` — the `97` / `98` dynamic volume buses.
- `base62-ids.bms` — `#BASE 62` case-distinct IDs in indexed headers, channel streams, `#LNOBJ`, and inside a `#RANDOM` / `#IF` block.
- `invisible-notes.bms` — `3x` / `4x` invisible keysound channels, and the guarantee that 2P-side invisible channels do not turn a single-player chart into a DP chart.
- `lntype2-long-note.bms` — `#LNTYPE 2` continuous runs, including two runs split by a gap and a run crossing a measure boundary.
- `nonpositive-bpm.bms` — channel `08` pointed at zero, negative and undefined `#BPMxx` slots.
- `5key-sp.bms`, `10key-dp.bms`, `7key-longnote.bml` — the lane-mode branches that had no fixture. Together with the existing charts this covers every `ChartPlayVariant` the resolver can return, and gives the `.bml` extension allow-lists a real file to open.
- `bmson-key-channels-mines.bmson` — beatoraja `key_channels` mines, `info.ln_type` and `notes[].t`.

Move the inline chart text in three tests onto these fixtures (`#SPEED` / `SP`, `#BASE 62`, bmson `key_channels`). Inline inputs stay inline where a file would hide the assertion: malformed-input probes, charset byte sequences, and table-driven micro-cases such as the 20 `resolveChartPlayVariant` channel lists.

Wire up the fixtures that existed but were orphaned: the `sample.*` quintet now backs a live import → edit → export round trip in the editor, and the retrigger and ogg charts are rendered through the audio renderer instead of being described by hand-built IR.
---
 examples/test/10key-dp.bms                    |  61 +++
 examples/test/5key-sp.bms                     |  59 +++
 examples/test/7key-longnote.bml               |  62 +++
 examples/test/base62-ids.bms                  |  67 +++
 examples/test/bmson-key-channels-mines.bmson  |  50 +++
 examples/test/bus-volume-channels.bms         |  63 +++
 examples/test/extended-directives.bms         | 108 +++++
 examples/test/invisible-notes.bms             |  67 +++
 examples/test/lntype2-long-note.bms           |  66 +++
 examples/test/nonpositive-bpm.bms             |  68 +++
 examples/test/scroll-speed-gimmick.bms        | 103 +++++
 packages/audio-renderer/src/index.test.ts     |  66 +++
 packages/editor/src/index.test.ts             |  46 ++
 packages/parser/src/fixtures.test.ts          | 402 ++++++++++++++++++
 packages/parser/src/index.test.ts             |  73 ++--
 .../src/cli/chart-selection.test.ts           |  12 +-
 16 files changed, 1333 insertions(+), 40 deletions(-)
 create mode 100644 examples/test/10key-dp.bms
 create mode 100644 examples/test/5key-sp.bms
 create mode 100644 examples/test/7key-longnote.bml
 create mode 100644 examples/test/base62-ids.bms
 create mode 100644 examples/test/bmson-key-channels-mines.bmson
 create mode 100644 examples/test/bus-volume-channels.bms
 create mode 100644 examples/test/extended-directives.bms
 create mode 100644 examples/test/invisible-notes.bms
 create mode 100644 examples/test/lntype2-long-note.bms
 create mode 100644 examples/test/nonpositive-bpm.bms
 create mode 100644 examples/test/scroll-speed-gimmick.bms
 create mode 100644 packages/parser/src/fixtures.test.ts

diff --git a/examples/test/10key-dp.bms b/examples/test/10key-dp.bms
new file mode 100644
index 00000000..04459aa8
--- /dev/null
+++ b/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
diff --git a/examples/test/5key-sp.bms b/examples/test/5key-sp.bms
new file mode 100644
index 00000000..1bae7e35
--- /dev/null
+++ b/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
diff --git a/examples/test/7key-longnote.bml b/examples/test/7key-longnote.bml
new file mode 100644
index 00000000..a6377869
--- /dev/null
+++ b/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
diff --git a/examples/test/base62-ids.bms b/examples/test/base62-ids.bms
new file mode 100644
index 00000000..6cbfd882
--- /dev/null
+++ b/examples/test/base62-ids.bms
@@ -0,0 +1,67 @@
+*---------------------- METADATA FIELD
+
+#BASE 62
+
+#TITLE Base 62 Object IDs
+#SUBTITLE #BASE 62 keeps upper and lower case as separate slots
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 1
+#TOTAL 200
+#DIFFICULTY 1
+
+*---------------------- EXTENDED HEADER FIELD
+* `#BASE 62` is the beatoraja extension that widens the two-character object ID
+* space from base 36 to base 62 by making lower case letters distinct slots.
+* Under the default base 36 every pair below would collapse onto one key, so
+* this chart is the file-level regression guard for the case-preserving path:
+*
+*   #WAV0a / #WAV0A  - distinct sample slots
+*   #00111:0a0A0z    - distinct channel-stream tokens
+*   #LNOBJ zz        - LN end marker matched case-sensitively
+*
+* `#BASE` must appear before the first object line to take effect, so it is
+* declared at the very top of the file.
+
+#PLAYER 1
+#LNTYPE 1
+#LNMODE 1
+#LNOBJ zz
+
+*---------------------- RESOURCES FIELD
+
+#WAV0a sample.wav
+#WAV0A branch.wav
+#WAV0z right.wav
+#WAV0Z wrong.wav
+#WAVZz sample.wav
+#WAVzz sample.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - four case-distinct slots in one channel stream.
+#00011:0a0A0z0Z
+
+* Measure 1 - the same four slots on a playable lane.
+#00111:0a0A0z0Z
+
+* Measure 2 - a long note whose end marker is the lower case `zz`. Under base 36
+* this would fold to `ZZ` and stop matching the #LNOBJ declaration.
+#00211:0a00zz00
+
+* Measure 4 - lower case, upper case and mixed case IDs in one channel stream.
+#00411:0a0AZz
+
+*---------------------- CONTROL FLOW FIELD
+
+* An indexed header declared inside a control-flow branch still has to register
+* under its lower case key.
+#RANDOM 1
+#IF 1
+#WAV0b wrong.wav
+#00311:0b0b
+#ENDIF
+#ENDRANDOM
diff --git a/examples/test/bmson-key-channels-mines.bmson b/examples/test/bmson-key-channels-mines.bmson
new file mode 100644
index 00000000..144eb968
--- /dev/null
+++ b/examples/test/bmson-key-channels-mines.bmson
@@ -0,0 +1,50 @@
+{
+  "version": "1.0.0",
+  "info": {
+    "title": "BMSON Key Channels Mines",
+    "subtitle": "beatoraja key_channels / ln_type / notes[].t extensions",
+    "artist": "be-music",
+    "genre": "TEST",
+    "level": 4,
+    "init_bpm": 150,
+    "resolution": 240,
+    "mode_hint": "beat-7k",
+    "ln_type": 2,
+    "judge_rank": 100,
+    "total": 260
+  },
+  "lines": [{ "y": 0 }, { "y": 960 }, { "y": 1920 }],
+  "bpm_events": [],
+  "stop_events": [],
+  "sound_channels": [
+    {
+      "name": "sample.wav",
+      "notes": [
+        { "x": 1, "y": 0, "l": 0, "c": false },
+        { "x": 2, "y": 240, "l": 0, "c": false },
+        { "x": 1, "y": 480, "l": 480, "c": false, "t": 3 },
+        { "x": 6, "y": 960, "l": 240, "c": false, "t": 1 },
+        { "x": 7, "y": 1200, "l": 0, "c": false },
+        { "x": 8, "y": 1440, "l": 0, "c": false }
+      ]
+    },
+    {
+      "name": "branch.wav",
+      "notes": [
+        { "y": 0, "l": 0, "c": false },
+        { "y": 960, "l": 0, "c": false },
+        { "y": 1920, "l": 0, "c": false }
+      ]
+    }
+  ],
+  "key_channels": [
+    {
+      "name": "wrong.wav",
+      "notes": [
+        { "x": 1, "y": 1680, "damage": 0 },
+        { "x": 6, "y": 1800, "damage": 50 },
+        { "x": 8, "y": 1920, "damage": 100 }
+      ]
+    }
+  ]
+}
diff --git a/examples/test/bus-volume-channels.bms b/examples/test/bus-volume-channels.bms
new file mode 100644
index 00000000..88bf2294
--- /dev/null
+++ b/examples/test/bus-volume-channels.bms
@@ -0,0 +1,63 @@
+*---------------------- METADATA FIELD
+
+#TITLE Dynamic Bus Volume Channels
+#SUBTITLE Channel 97 (BGM bus) and channel 98 (key bus)
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 1
+#TOTAL 200
+#DIFFICULTY 1
+
+*---------------------- EXTENDED HEADER FIELD
+* Channels `97` and `98` are the two dynamic volume buses:
+*
+*   #xxx97 - BGM-side (autoplay / channel 01) bus volume
+*   #xxx98 - playable-side (key sound) bus volume
+*
+* The token is a base-36 pair read as a 0..FF ratio of the original volume, so
+* `FF` is unity, `80` is roughly half, and `01` is the quietest audible step.
+* `00` is "no event" rather than silence, so it is never authored as a value.
+*
+* Both channels must stay out of the sample-trigger path - authoring a volume
+* change must not itself make a sound - which is what makes a real chart worth
+* having here rather than only the classifier unit tests.
+
+#PLAYER 1
+#LNTYPE 1
+#VOLWAV 100
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - reference bar. BGM on channel 01, key sounds on channel 11, both
+* at the volume the chart declares.
+#00001:02020202
+#00011:01010101
+
+* Measure 1 - duck the BGM bus to half and then to the quietest step while the
+* key bus stays untouched.
+#00197:8001
+#00101:02020202
+#00111:01010101
+
+* Measure 2 - restore the BGM bus and duck the key bus instead.
+#00297:FF00
+#00298:8040
+#00201:02020202
+#00211:01010101
+
+* Measure 3 - both buses move on the same beat, which is where an ordering bug
+* between the two gain stages shows up.
+#00397:40FF
+#00398:FF40
+#00301:02020202
+#00311:01010101
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/examples/test/extended-directives.bms b/examples/test/extended-directives.bms
new file mode 100644
index 00000000..8d02deac
--- /dev/null
+++ b/examples/test/extended-directives.bms
@@ -0,0 +1,108 @@
+*---------------------- METADATA FIELD
+
+#TITLE Extended Directive Payloads
+#SUBTITLE Structurally valid #EXWAV / #EXBMP / #ARGB / #BGA / #SWBGA / #WAVCMD / #EXRANK payloads
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 1
+#TOTAL 200
+#DIFFICULTY 1
+
+*---------------------- EXTENDED HEADER FIELD
+* `four-measure-command-combo-test.bms` proves the parser ROUTES every extended
+* header into the right `bms` field, but its payloads are placeholders
+* (`#EXWAV01 ex_sample.wav`, `#BGA01 01`, `#SWBGA01 02`, `#WAVCMD legacy`) that
+* every `@be-music/chart` value parser rejects. This chart carries the same
+* directive family with payloads that actually parse, so the value parsers are
+* exercised against a real file instead of inline strings only.
+*
+* Payload layouts (hitkey BMS Memo):
+*   #EXWAVxx <flags> <params> <filename>  flags drawn from `pvf`, params positional
+*   #EXBMPxx a,r,g,b,filename             ARGB tuple plus the image filename
+*   #ARGBxx AARRGGBB | a,r,g,b            both accepted spellings
+*   #BGAxx YY x1 y1 x2 y2 dx dy           sub-region crop of #BMPYY
+*   #SWBGAxx fr:tot:lp[:ARGB] N1 N2 ...   switching (animated) BGA, fr in 1/100 s
+*   #WAVCMD pp xx vv                      pp = 00 pitch / 01 volume / 02 loop
+*   #EXRANKxx <percent>                   judge-window scale, cued on channel A0
+*   #CHANGEOPTIONxx <option>              runtime option switch, cued on channel A6
+
+#PLAYER 1
+#LNTYPE 1
+#VOLWAV 90
+#DEFEXRANK 100
+#STP 001.500
+#STP 002.250
+
+* Per-slot playback trims. `01` uses the full `pvf` layout, `02` reorders the
+* flags to prove they are matched positionally, `03` authors an explicit 0 cB
+* (unity) so "authored 0" stays distinguishable from "not authored".
+#EXWAV01 pvf 1024,-200,48000 sample.wav
+#EXWAV02 vp -600,-500 branch.wav
+#EXWAV03 v 0 right.wav
+
+* Opaque backdrop keyed to transparent black, plus a half-alpha layer tint.
+#EXBMP01 255,0,0,0,bga-base.bmp
+#EXBMP02 128,255,255,255,bga-layer.bmp
+
+* Both #ARGBxx spellings: AARRGGBB hex and comma-separated decimal.
+#ARGB01 FF000000
+#ARGB02 128,255,0,0
+
+* Sub-region aliases: `05` is the whole of #BMP01, `06` is a 128x128 crop of
+* #BMP02 drawn at (16, 8) inside the 256x256 BMS canvas.
+#BGA05 01 0 0 256 256 0 0
+#BGA06 02 64 32 192 160 16 8
+
+* Animated BGA cues: `01` loops five frames at 100 ms, `02` plays three frames
+* at 50 ms once and holds the last one (lp = 0).
+#SWBGA01 10:5:1:FF000000 01 02 03 04 05
+#SWBGA02 5:3:0 01 02 03
+
+* One line per parameter byte so all three #WAVCMD params are covered.
+#WAVCMD 01 01 64
+#WAVCMD 00 02 12
+#WAVCMD 02 03 1024
+
+* Dynamic judge windows referenced from channel A0: tighter (48 %) then looser
+* (150 %) than the #DEFEXRANK baseline.
+#EXRANK01 48
+#EXRANK02 150
+
+#CHANGEOPTION01 MIRROR
+#CHANGEOPTION02 RANDOM
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+#WAV03 right.wav
+#BMP01 bga-base.bmp
+#BMP02 bga-layer.bmp
+#BMP03 bga-poor.bmp
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - plain quarter taps so the chart stays playable while the header
+* directives above are what is actually under test.
+#00011:01010101
+
+* Measure 1 - #EXRANKxx cued on channel A0 (dynamic judge window) and
+* #CHANGEOPTIONxx cued on channel A6 (runtime option switch). Neither channel
+* triggers a keysound.
+#001A0:0102
+#001A6:0102
+#00111:01010101
+
+* Measure 2 - BGA base (04), layer (07), layer2 (0A) and POOR (06) cues. Base
+* and layer reference the #BGAxx sub-region slots, layer2 references the
+* #SWBGAxx animation slot.
+#00204:05
+#00207:06
+#0020A:01
+#00206:03
+#00211:01010101
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/examples/test/invisible-notes.bms b/examples/test/invisible-notes.bms
new file mode 100644
index 00000000..2ce9bab9
--- /dev/null
+++ b/examples/test/invisible-notes.bms
@@ -0,0 +1,67 @@
+*---------------------- METADATA FIELD
+
+#TITLE Invisible Keysound Channels
+#SUBTITLE Channels 3x / 4x sound without being drawn or judged
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 2
+#TOTAL 250
+#DIFFICULTY 2
+
+*---------------------- EXTENDED HEADER FIELD
+* The `3x` / `4x` channel families are "invisible" (hidden) keysound objects:
+* they belong to a lane and play through the key bus, but they are never drawn
+* and never judged. Chart authors use them to keep a lane's sample assignment
+* alive across a section where no note should be hit.
+*
+* Two properties are only observable from a whole chart, which is why this
+* fixture exists next to the channel-classifier unit tests:
+*
+*   - invisible channels are play-lane SOUND channels but not PLAYABLE ones, so
+*     they must not contribute a judged note
+*   - they must not influence lane-mode detection either: the 2P-side `4x`
+*     channels below must not turn this single-player chart into a DP chart
+*
+* Visible lanes are `11..13` plus `18` / `19`, so the expected lane mode is
+* 7 KEY SP.
+
+#PLAYER 1
+#LNTYPE 1
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+#WAV03 right.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - visible reference bar only.
+#00011:01010101
+#00018:00020002
+#00019:02000200
+
+* Measure 1 - invisible objects on the 1P side interleaved with visible ones.
+* Only the `11` / `18` / `19` notes should be judged.
+#00111:01000100
+#00131:00030003
+#00132:03030303
+#00133:00000303
+#00118:00020000
+#00119:00000002
+
+* Measure 2 - invisible objects on the 2P side. These must sound but must not
+* make the chart a DP chart.
+#00241:03030303
+#00242:00030003
+#00211:01010101
+
+* Measure 3 - invisible only, no visible notes at all. The lane keeps its sample
+* assignment while nothing is judged.
+#00331:03030303
+#00341:00030003
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/examples/test/lntype2-long-note.bms b/examples/test/lntype2-long-note.bms
new file mode 100644
index 00000000..e9c5d547
--- /dev/null
+++ b/examples/test/lntype2-long-note.bms
@@ -0,0 +1,66 @@
+*---------------------- METADATA FIELD
+
+#TITLE LNTYPE 2 Continuous Long Note
+#SUBTITLE MGQ-style long notes spelled as a run of repeated tokens
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 2
+#TOTAL 250
+#DIFFICULTY 2
+
+*---------------------- EXTENDED HEADER FIELD
+* `#LNTYPE 1` pairs a head and a tail object; `#LNTYPE 2` instead spells a long
+* note as an unbroken RUN of the same object ID across consecutive slots, and the
+* long note lasts from the first token of the run to the end of the last one.
+* Every token after the first is a continuation and must not trigger a keysound.
+*
+* The three cases below are the ones that separate a correct type-2 expander
+* from a naive one:
+*
+*   measure 1 - a single run inside one measure
+*   measure 2 - two runs in the same measure separated by an empty slot, which
+*               must stay two long notes rather than one
+*   measures 3-4 - a run that continues across the measure boundary
+*
+* `ln-mode-1-long-note.bms` covers the same lanes with `#LNTYPE 1` / `#LNOBJ`,
+* so the two files together cover both spellings of a long note.
+
+#PLAYER 1
+#LNTYPE 2
+#LNMODE 1
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+#WAV03 right.wav
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - count-in taps on the visible lanes so the chart is playable.
+#00011:01010101
+#00013:00020002
+#00015:02000200
+
+* Measure 1 - one run of four eighth-note slots on lane 1 (channel 51 -> 11):
+* a single long note from beat 0 to beat 2.
+#00151:0101010100000000
+
+* Measure 2 - two runs on lane 3 (channel 53 -> 13) separated by an empty slot.
+* Expected result is two long notes, not one spanning the gap.
+#00253:0202000002020000
+
+* Measures 3 and 4 - a run that crosses the measure boundary on lane 5
+* (channel 55 -> 15). Expected result is one long note that starts in measure 3
+* and ends in measure 4.
+#00355:0000000000000303
+#00455:0303000000000000
+
+* Measure 5 - follow-up taps, verifying the lane is released and immediately
+* playable again.
+#00511:01010101
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/examples/test/nonpositive-bpm.bms b/examples/test/nonpositive-bpm.bms
new file mode 100644
index 00000000..0662edc7
--- /dev/null
+++ b/examples/test/nonpositive-bpm.bms
@@ -0,0 +1,68 @@
+*---------------------- METADATA FIELD
+
+#TITLE Non-Positive BPM Changes
+#SUBTITLE Zero, negative and undefined #BPMxx slots referenced from channel 08
+#ARTIST be-music
+#GENRE TEST
+#BPM 130
+#PLAYLEVEL 1
+#RANK 2
+#TOTAL 300
+#DIFFICULTY 1
+
+*---------------------- EXTENDED HEADER FIELD
+* Channel `08` looks up a `#BPMxx` slot, and nothing stops a chart from pointing
+* it at a value the timeline cannot use. The timing resolver skips any BPM point
+* that is not finite and positive, which is the only thing keeping these charts
+* from producing infinite or backwards note times:
+*
+*   #BPM02 0    - 240/0 is infinite seconds per measure; every later event would
+*                 land at t = inf and never fire
+*   #BPM03 -65  - a negative tempo runs the chart backwards
+*   ZZ          - an undefined slot, which has no value at all
+*
+* Real players disagree on what these should do (LR2 stops or reverses the
+* scroll), so the fixture pins the one thing that has to hold regardless: the
+* chart still parses, and the notes before the bad change still play at the
+* declared tempo.
+
+#PLAYER 1
+#LNTYPE 1
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+
+#BPM01 130
+#BPM02 0
+#BPM03 -65
+
+*---------------------- MEASURE LENGTH FIELD
+
+*---------------------- OBJECT DATA FIELD
+
+* Measures 0-1 - normal play at the declared 130 BPM.
+#00011:01010101
+#00001:02
+#00111:01010101
+#00101:02
+
+* Measure 2 - a valid BPM change, so the chart proves channel 08 works before it
+* is handed anything broken.
+#00208:0100
+#00211:01010101
+
+* Measure 3 - #BPM02 is 0.
+#00308:02
+#00311:01010101
+
+* Measure 4 - #BPM03 is negative.
+#00408:03
+#00411:01010101
+
+* Measure 5 - channel 08 references #BPMZZ, which is never defined.
+#00508:ZZ
+#00511:01010101
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/examples/test/scroll-speed-gimmick.bms b/examples/test/scroll-speed-gimmick.bms
new file mode 100644
index 00000000..d253039a
--- /dev/null
+++ b/examples/test/scroll-speed-gimmick.bms
@@ -0,0 +1,103 @@
+*---------------------- METADATA FIELD
+
+#TITLE Scroll / Speed / Stop Gimmick
+#SUBTITLE #SCROLLxx on SC, #SPEEDxx on SP, #STOPxx on 09, tempo on 03 and 08
+#ARTIST be-music
+#GENRE TEST
+#BPM 120
+#PLAYLEVEL 4
+#TOTAL 300
+#DIFFICULTY 3
+
+*---------------------- EXTENDED HEADER FIELD
+* Every timing / drawing gimmick channel in one chart, one measure per gimmick,
+* so a change to one of them shows up as a single failing measure:
+*
+*   #xxx02 - measure length multiplier
+*   #xxx03 - direct BPM change, hexadecimal token (`80` = 128 BPM)
+*   #xxx08 - BPM change by #BPMxx reference (the only way to reach non-integers)
+*   #xxx09 - STOP by #STOPxx reference, value in 1/192-measure units
+*   #xxxSC - scroll-speed keyframe by #SCROLLxx reference
+*   #xxxSP - note-spacing keyframe by #SPEEDxx reference (Bemuse extension)
+*
+* `SC` and `SP` are the two channels that carry a slot reference but must never
+* trigger a keysound, and #SCROLL 0 / #SCROLL < 0 are the two values the player
+* has an explicit compatibility policy for (see docs/bms-spec.md), so both are
+* authored here rather than only the well-behaved positive case.
+
+#PLAYER 1
+#LNTYPE 1
+#BASEBPM 120
+
+#SCROLL01 1.0
+#SCROLL02 0.5
+#SCROLL03 0
+#SCROLL04 -1.0
+#SCROLL05 2.0
+
+#SPEED01 1.0
+#SPEED02 0.5
+#SPEED03 2.0
+
+*---------------------- RESOURCES FIELD
+
+#WAV01 sample.wav
+#WAV02 branch.wav
+#BPM01 60
+#BPM02 240
+#BPM03 90.5
+#STOP01 48
+#STOP02 192
+
+*---------------------- MEASURE LENGTH FIELD
+
+#00302:0.75
+#00402:1.50
+
+*---------------------- OBJECT DATA FIELD
+
+* Measure 0 - reference bar at the declared #BPM with no gimmick applied.
+#00011:01010101
+
+* Measure 1 - direct BPM change on channel 03. Tokens are hexadecimal, so `80`
+* is 128 BPM and `3C` is 60 BPM.
+#00103:803C
+#00111:01010101
+
+* Measure 2 - BPM change by reference on channel 08. #BPM03 is fractional,
+* which channel 03 cannot express.
+#00208:010203
+#00211:01010101
+
+* Measure 3 - shortened measure (0.75) combined with a short STOP.
+#00309:0100
+#00311:010101
+
+* Measure 4 - lengthened measure (1.50) combined with a full-measure STOP.
+#00409:0002
+#00411:010101010101
+
+* Measure 5 - scroll-speed keyframes: normal, half, then double.
+#005SC:010205
+#00511:01010101
+
+* Measure 6 - #SCROLL 0 (notes stack away from the judge line) followed by a
+* negative scroll value (drawing distance is taken as an absolute value).
+#006SC:0304
+#00611:01010101
+
+* Measure 7 - note-spacing keyframes on the Bemuse `SP` channel.
+#007SP:010203
+#00711:01010101
+
+* Measure 8 - every gimmick channel in the same measure, which is where
+* ordering bugs between tempo / stop / scroll resolution surface.
+#00803:80
+#00808:0002
+#00809:0100
+#008SC:0205
+#008SP:0203
+#00811:01010101
+#00801:02
+
+*---------------------- CONTROL FLOW FIELD
diff --git a/packages/audio-renderer/src/index.test.ts b/packages/audio-renderer/src/index.test.ts
index f078d047..d23d1336 100644
--- a/packages/audio-renderer/src/index.test.ts
+++ b/packages/audio-renderer/src/index.test.ts
@@ -1,6 +1,7 @@
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createEmptyJson } from '../../json/src/index.ts';
+import { parseChartFile } from '../../parser/src/index.ts';
 import { describe, expect, test } from 'vitest';
 import {
   type RenderResult,
@@ -856,3 +857,68 @@ describe('audio-renderer', () => {
     expect(maxDeltaBetweenResults(overlapResult, singleResult, startFrame, endFrame)).toBeGreaterThan(1e-3);
   });
 });
+
+describe('audio-renderer: examples/test chart fixtures', () => {
+  const SAMPLE_RATE = 44_100;
+
+  async function renderFixture(name: string, dropFirstEvent = false) {
+    const json = await parseChartFile(resolve(fixtureDir, name));
+    if (dropFirstEvent) {
+      json.events = json.events.slice(1);
+    }
+    return renderJson(json, {
+      baseDir: fixtureDir,
+      sampleRate: SAMPLE_RATE,
+      normalize: false,
+      tailSeconds: 0,
+      fallbackToneSeconds: 0,
+    });
+  }
+
+  function peakBetween(result: RenderResult, startSeconds: number, endSeconds: number): number {
+    const start = Math.max(0, Math.round(startSeconds * SAMPLE_RATE));
+    const end = Math.min(result.left.length, Math.round(endSeconds * SAMPLE_RATE));
+    let peak = 0;
+    for (let index = start; index < end; index += 1) {
+      peak = Math.max(peak, Math.abs(result.left[index]), Math.abs(result.right[index]));
+    }
+    return peak;
+  }
+
+  test('retrigger-same-key-cut.bms cuts the previous voice on the same lane', async () => {
+    // `#00011:0101` is the same #WAV01 twice on lane 1, at beat 0 and beat 2 (0 s and 1 s at 120 BPM), and
+    // retrigger_a.wav runs 2.2 s. Under BMS monophonic playback the second trigger has to cut the first, so
+    // everything from 1 s onwards must be indistinguishable from a render of the second note alone.
+    const [full, secondOnly] = await Promise.all([
+      renderFixture('retrigger-same-key-cut.bms'),
+      renderFixture('retrigger-same-key-cut.bms', true),
+    ]);
+
+    expect(peakBetween(full, 0, 1)).toBeGreaterThan(0);
+    expect(
+      maxDeltaBetweenResults(full, secondOnly, Math.round(1 * SAMPLE_RATE), Math.round(2.2 * SAMPLE_RATE)),
+    ).toBeLessThan(1e-6);
+  });
+
+  test('retrigger-different-key-overlap.bms keeps both voices even with the same file', async () => {
+    // Lane 1 fires #WAV01 at 0 s and lane 2 fires #WAV02 at 0.5 s. Both slots point at retrigger_a.wav, but a
+    // different lane must not cut, so the overlap window has to differ from the later-notes-only render.
+    const [full, withoutFirst] = await Promise.all([
+      renderFixture('retrigger-different-key-overlap.bms'),
+      renderFixture('retrigger-different-key-overlap.bms', true),
+    ]);
+
+    expect(
+      maxDeltaBetweenResults(full, withoutFirst, Math.round(0.5 * SAMPLE_RATE), Math.round(2.2 * SAMPLE_RATE)),
+    ).toBeGreaterThan(1e-3);
+  });
+
+  test('ogg-test.bms decodes its #WAV through the Vorbis path', async () => {
+    // `#WAV01 ogg-test.ogg` — the only fixture that names a non-wav codec from the chart itself rather than from a
+    // hand-built IR, so it is what proves the loader reaches the Vorbis decoder off a real chart file.
+    const result = await renderFixture('ogg-test.bms');
+
+    expect(result.durationSeconds).toBeGreaterThan(0);
+    expect(peakBetween(result, 0, result.durationSeconds)).toBeGreaterThan(0);
+  });
+});
diff --git a/packages/editor/src/index.test.ts b/packages/editor/src/index.test.ts
index a2ebc5ac..51624bd0 100644
--- a/packages/editor/src/index.test.ts
+++ b/packages/editor/src/index.test.ts
@@ -207,4 +207,50 @@ describe('editor', () => {
     expect(json.sourceFormat).toBe('bms');
     expect(json.events.length).toBeGreaterThan(0);
   });
+
+  test('editor: the examples/test sample quartet is a live import → edit → export round trip', async () => {
+    // `examples/test` ships four files that only mean anything as a set:
+    //
+    //   sample.bms             the source chart
+    //   sample.json            what `importChart` produces from it
+    //   sample.roundtrip.bmson the same chart exported to bmson
+    //   sample.edit.json       the same chart after one retitle and one added note
+    //   sample.edited.bms      what `exportChart` writes back out from that edit
+    //
+    // Checking them against the live pipeline is what keeps them from silently going stale: before this test they
+    // still carried a pre-`bms`/`bmson`-extension shape that no current code path can produce.
+    const imported = await importChart(resolve(rootDir, 'examples/test/sample.bms'));
+    const expectedImport = await loadJsonFile(resolve(rootDir, 'examples/test/sample.json'));
+    expect(imported).toEqual(expectedImport);
+
+    let edited = setMetadata(imported, 'title', 'Edited Sample');
+    edited = addNote(edited, {
+      measure: 3,
+      channel: '11',
+      positionNumerator: 1,
+      positionDenominator: 2,
+      value: '01',
+    });
+    const expectedEdit = await loadJsonFile(resolve(rootDir, 'examples/test/sample.edit.json'));
+    expect(edited).toEqual(expectedEdit);
+
+    const tempDir = await mkdtemp(resolve(tmpdir(), 'bms-editor-fixture-'));
+    try {
+      const bmsPath = resolve(tempDir, 'sample.edited.bms');
+      const bmsonPath = resolve(tempDir, 'sample.roundtrip.bmson');
+      await exportChart(bmsPath, edited);
+      await exportChart(bmsonPath, imported);
+
+      const [writtenBms, expectedBms, writtenBmson, expectedBmson] = await Promise.all([
+        readFile(bmsPath, 'utf8'),
+        readFile(resolve(rootDir, 'examples/test/sample.edited.bms'), 'utf8'),
+        readFile(bmsonPath, 'utf8'),
+        readFile(resolve(rootDir, 'examples/test/sample.roundtrip.bmson'), 'utf8'),
+      ]);
+      expect(writtenBms).toBe(expectedBms);
+      expect(writtenBmson).toBe(expectedBmson);
+    } finally {
+      await rm(tempDir, { recursive: true, force: true });
+    }
+  });
 });
diff --git a/packages/parser/src/fixtures.test.ts b/packages/parser/src/fixtures.test.ts
new file mode 100644
index 00000000..e6d3fb3a
--- /dev/null
+++ b/packages/parser/src/fixtures.test.ts
@@ -0,0 +1,402 @@
+import { readdir } from 'node:fs/promises';
+import { dirname, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, test } from 'vitest';
+import {
+  eventToBeat,
+  isBmsBgmVolumeChangeChannel,
+  isBmsKeyVolumeChangeChannel,
+  isPlayLaneSoundChannel,
+  isPlayableChannel,
+  isSampleTriggerChannel,
+  parseBmsArgb,
+  parseBmsBga,
+  parseBmsDynamicVolumeGain,
+  parseBmsExBmp,
+  parseBmsExWav,
+  parseBmsSwBga,
+  parseBmsWavCmd,
+  resolveBmsLongNotes,
+  resolveChartPlayVariant,
+  resolveLnobjLongNotes,
+  type ChartPlayVariant,
+} from '../../chart/src/index.ts';
+import { parseChartFile, resolveBmsControlFlow } from './index.ts';
+
+/**
+ * Tests for the shared chart corpus in `examples/test`.
+ *
+ * Every fixture in that directory is meant to exercise one coherent feature cluster end to end. The per-function unit
+ * tests next to each source file stay inline — they need many tiny variations of one input, and a file per case would
+ * hide the assertion. What they cannot show is whether a real chart file, parsed off disk, still carries payloads the
+ * feature's own parser accepts. That is what lives here, so a fixture that drifts away from the code fails a test
+ * instead of quietly rotting.
+ */
+
+const rootDir = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+const fixtureDir = resolve(rootDir, 'examples/test');
+const fixture = (name: string) => resolve(fixtureDir, name);
+
+const CHART_EXTENSIONS = new Set(['.bms', '.bme', '.bml', '.pms', '.bmson']);
+
+describe('examples/test corpus', () => {
+  test('every chart fixture parses off disk', async () => {
+    const entries = await readdir(fixtureDir);
+    const charts = entries.filter((entry) => CHART_EXTENSIONS.has(extname(entry).toLowerCase())).sort();
+
+    // Guards against the directory being silently emptied / renamed out from under this suite.
+    expect(charts.length).toBeGreaterThanOrEqual(18);
+
+    for (const name of charts) {
+      const json = await parseChartFile(fixture(name));
+      expect(json.sourceFormat, name).toBe(extname(name).toLowerCase() === '.bmson' ? 'bmson' : 'bms');
+      expect(json.metadata.title, name).not.toBe('');
+      expect(json.metadata.bpm, name).toBeGreaterThan(0);
+
+      // A chart whose objects all live inside control-flow blocks (control-flow-random-demo.bms) has no top-level
+      // events, so the playable-content check has to run against the resolved chart. Resolving also catches the
+      // failure mode that motivated this test: an unbalanced `#RANDOM` / `#SWITCH` scope swallows every line below
+      // it, which leaves a chart that parses cleanly and plays nothing.
+      const resolved =
+        json.sourceFormat === 'bms' && json.bms.controlFlow.length > 0
+          ? resolveBmsControlFlow(json, { random: () => 0 })
+          : json;
+      expect(resolved.events.length, name).toBeGreaterThan(0);
+    }
+  });
+
+  test('lane-mode fixtures cover every ChartPlayVariant the resolver can return', async () => {
+    // One fixture per branch of `resolveChartPlayVariant`. The resolver's own unit tests drive synthetic channel lists;
+    // this table proves a real chart authored the channels that branch actually needs.
+    const cases: ReadonlyArray<{ file: string; expected: ChartPlayVariant }> = [
+      { file: '5key-sp.bms', expected: '5' },
+      { file: 'ln-mode-1-long-note.bms', expected: '7' },
+      { file: '9key-all-keys-quarter.pms', expected: '9' },
+      { file: 'ln-9key-popn.bms', expected: '9' },
+      { file: '10key-dp.bms', expected: '10' },
+      { file: 'lane-order-test.bms', expected: '14' },
+      { file: '24key-keyboard-sp.bme', expected: '24' },
+      { file: '48key-keyboard-dp.bme', expected: '48' },
+    ];
+
+    const resolved = new Set<ChartPlayVariant>();
+    for (const { file, expected } of cases) {
+      const json = await parseChartFile(fixture(file));
+      expect(resolveChartPlayVariant({ chartPath: fixture(file), events: json.events, bms: json.bms }), file).toBe(
+        expected,
+      );
+      resolved.add(expected);
+    }
+
+    expect([...resolved].sort()).toEqual(['10', '14', '24', '48', '5', '7', '9']);
+  });
+
+  test('extended-directives.bms carries payloads every #directive value parser accepts', async () => {
+    const json = await parseChartFile(fixture('extended-directives.bms'));
+
+    // `#EXWAVxx <flags> <params> <filename>` — flags are matched positionally, in any order.
+    expect(parseBmsExWav(json.bms.exWav['01'] ?? '')).toEqual({
+      pan: 1024,
+      volumeCentibels: -200,
+      frequencyHz: 48_000,
+      filename: 'sample.wav',
+    });
+    expect(parseBmsExWav(json.bms.exWav['02'] ?? '')).toMatchObject({
+      volumeCentibels: -600,
+      pan: -500,
+      filename: 'branch.wav',
+    });
+    // An explicitly authored 0 cB is unity, and must stay distinguishable from an unauthored flag.
+    const unity = parseBmsExWav(json.bms.exWav['03'] ?? '');
+    expect(unity?.volumeCentibels).toBe(0);
+    expect(unity?.pan).toBeUndefined();
+
+    // `#EXBMPxx a,r,g,b,filename`
+    expect(parseBmsExBmp(json.bms.exBmp['01'] ?? '')).toMatchObject({
+      filename: 'bga-base.bmp',
+      argb: { a: 255, r: 0, g: 0, b: 0 },
+    });
+    expect(parseBmsExBmp(json.bms.exBmp['02'] ?? '')?.argb).toEqual({ a: 128, r: 255, g: 255, b: 255 });
+
+    // `#ARGBxx` in both accepted spellings — AARRGGBB hex and comma-separated decimal.
+    expect(parseBmsArgb(json.bms.argb['01'] ?? '')).toEqual({ a: 255, r: 0, g: 0, b: 0 });
+    expect(parseBmsArgb(json.bms.argb['02'] ?? '')).toEqual({ a: 128, r: 255, g: 0, b: 0 });
+
+    // `#BGAxx YY x1 y1 x2 y2 dx dy` sub-region crops.
+    expect(parseBmsBga(json.bms.bga['05'] ?? '')).toEqual({
+      sourceBmp: '01',
+      sx: 0,
+      sy: 0,
+      ex: 256,
+      ey: 256,
+      dx: 0,
+      dy: 0,
+    });
+    expect(parseBmsBga(json.bms.bga['06'] ?? '')).toMatchObject({ sourceBmp: '02', sx: 64, sy: 32, dx: 16, dy: 8 });
+
+    // `#SWBGAxx fr:tot:lp[:ARGB] N1 N2 …` — `fr` is in 1/100 s, so 10 is a 100 ms frame interval.
+    expect(parseBmsSwBga(json.bms.swBga['01'] ?? '')).toEqual({
+      frameIntervalMs: 100,
+      totalFrames: 5,
+      loop: true,
+      argbRaw: 'FF000000',
+      frames: ['01', '02', '03', '04', '05'],
+    });
+    const holdLast = parseBmsSwBga(json.bms.swBga['02'] ?? '');
+    expect(holdLast?.loop).toBe(false);
+    expect(holdLast?.argbRaw).toBeUndefined();
+
+    // One `#WAVCMD pp xx vv` line per parameter byte.
+    const wavCmds = json.bms.wavCmds.map((line) => parseBmsWavCmd(line));
+    expect(wavCmds).toEqual([
+      { param: 'volume', slot: '01', value: 64 },
+      { param: 'pitch', slot: '02', value: 12 },
+      { param: 'loop', slot: '03', value: 1024 },
+    ]);
+
+    // `#EXRANKxx` percentages cued from channel A0, `#CHANGEOPTIONxx` from channel A6.
+    expect(json.bms.exRank['01']).toBe('48');
+    expect(json.bms.exRank['02']).toBe('150');
+    expect(json.bms.changeOption['01']).toBe('MIRROR');
+    const cueChannels = json.events.filter((event) => event.channel === 'A0' || event.channel === 'A6');
+    expect(cueChannels.map((event) => event.value).sort()).toEqual(['01', '01', '02', '02']);
+    // A0 is excluded from the audio path; A6 is not, because its runtime reflection is still unimplemented and it
+    // therefore falls through to the default "an object with a value is a keysound" rule.
+    expect(isSampleTriggerChannel('A0')).toBe(false);
+
+    expect(json.bms.stp).toEqual(['001.500', '002.250']);
+  });
+
+  test('scroll-speed-gimmick.bms authors every timing and drawing gimmick channel', async () => {
+    const json = await parseChartFile(fixture('scroll-speed-gimmick.bms'));
+
+    expect(json.bms.scroll).toEqual({ '01': 1, '02': 0.5, '03': 0, '04': -1, '05': 2 });
+    expect(json.bms.speed).toEqual({ '01': 1, '02': 0.5, '03': 2 });
+    expect(json.resources.bpm).toEqual({ '01': 60, '02': 240, '03': 90.5 });
+    expect(json.resources.stop).toEqual({ '01': 48, '02': 192 });
+    expect(json.measures).toContainEqual({ index: 3, length: 0.75 });
+    expect(json.measures).toContainEqual({ index: 4, length: 1.5 });
+
+    const channels = new Set(json.events.map((event) => event.channel));
+    for (const channel of ['03', '08', '09', 'SC', 'SP']) {
+      expect(channels.has(channel), channel).toBe(true);
+    }
+
+    // The scroll / speed reference channels must never reach the audio path.
+    for (const channel of ['SC', 'SP']) {
+      expect(isSampleTriggerChannel(channel)).toBe(false);
+    }
+
+    // Measure 6 is the compatibility corner: `#SCROLL 0` followed by a negative value.
+    const measure6Scroll = json.events
+      .filter((event) => event.measure === 6 && event.channel === 'SC')
+      .map((event) => json.bms.scroll[event.value]);
+    expect(measure6Scroll).toEqual([0, -1]);
+  });
+
+  test('bus-volume-channels.bms drives the 97 / 98 volume buses without triggering samples', async () => {
+    const json = await parseChartFile(fixture('bus-volume-channels.bms'));
+
+    const bgm = json.events.filter((event) => isBmsBgmVolumeChangeChannel(event.channel));
+    const key = json.events.filter((event) => isBmsKeyVolumeChangeChannel(event.channel));
+    expect(bgm.length).toBeGreaterThan(0);
+    expect(key.length).toBeGreaterThan(0);
+
+    for (const event of [...bgm, ...key]) {
+      // A volume change must not sound, and every authored token must decode to a usable gain.
+      expect(isSampleTriggerChannel(event.channel), event.channel).toBe(false);
+      expect(parseBmsDynamicVolumeGain(event.value), `${event.channel}:${event.value}`).toBeGreaterThan(0);
+    }
+
+    // `FF` is unity and `01` is the quietest audible step, so the authored range spans the whole bus.
+    const gains = bgm.map((event) => parseBmsDynamicVolumeGain(event.value) ?? Number.NaN);
+    expect(Math.max(...gains)).toBeCloseTo(1, 9);
+    expect(Math.min(...gains)).toBeCloseTo(0x01 / 0xff, 9);
+
+    // Measure 3 moves both buses on the same beat.
+    const measure3 = json.events.filter((event) => event.measure === 3 && event.channel.startsWith('9'));
+    expect(new Set(measure3.map((event) => event.channel))).toEqual(new Set(['97', '98']));
+  });
+
+  test('base62-ids.bms keeps upper and lower case object IDs apart', async () => {
+    const json = await parseChartFile(fixture('base62-ids.bms'));
+
+    expect(json.bms.base).toBe(62);
+    expect(json.resources.wav['0a']).toBe('sample.wav');
+    expect(json.resources.wav['0A']).toBe('branch.wav');
+    expect(json.resources.wav['0z']).toBe('right.wav');
+    expect(json.resources.wav['0Z']).toBe('wrong.wav');
+    expect(json.bms.lnObjs).toEqual(['zz']);
+
+    // Channel-stream tokens keep their case too, so the four slots stay four distinct samples.
+    const lane = json.events.filter((event) => event.measure === 0 && event.channel === '11');
+    expect(lane.map((event) => event.value)).toEqual(['0a', '0A', '0z', '0Z']);
+
+    // The LN end marker is the lower case `zz`; folding it to `ZZ` would stop it matching `#LNOBJ`.
+    const lnMeasure = json.events.filter((event) => event.measure === 2 && event.channel === '11');
+    expect(lnMeasure.map((event) => event.value)).toEqual(['0a', 'zz']);
+
+    // An indexed header declared inside a `#RANDOM` / `#IF` block is captured rather than applied, so the case-
+    // preserving path has to survive the control-flow replay too.
+    const captured = json.bms.controlFlow.find((entry) => entry.kind === 'header' && entry.commandRaw === 'WAV0b');
+    expect(captured).toBeDefined();
+    const resolved = resolveBmsControlFlow(json, { random: () => 0 });
+    expect(resolved.resources.wav['0b']).toBe('wrong.wav');
+    expect(resolved.events.some((event) => event.measure === 3 && event.value === '0b')).toBe(true);
+  });
+
+  test('invisible-notes.bms sounds 3x / 4x lanes without making them playable', async () => {
+    const json = await parseChartFile(fixture('invisible-notes.bms'));
+
+    const invisible = json.events.filter((event) => /^[34]/.test(event.channel));
+    expect(invisible.length).toBeGreaterThan(0);
+    for (const event of invisible) {
+      expect(isPlayLaneSoundChannel(event.channel), event.channel).toBe(true);
+      expect(isPlayableChannel(event.channel), event.channel).toBe(false);
+      expect(isSampleTriggerChannel(event.channel), event.channel).toBe(true);
+    }
+
+    // The 2P-side invisible channels must not turn a single-player chart into a DP chart.
+    expect(invisible.some((event) => event.channel.startsWith('4'))).toBe(true);
+    expect(
+      resolveChartPlayVariant({
+        chartPath: fixture('invisible-notes.bms'),
+        events: json.events,
+        bms: json.bms,
+      }),
+    ).toBe('7');
+
+    // Measure 3 is invisible-only: the lane keeps its sample assignment while nothing is judged.
+    const measure3 = json.events.filter((event) => event.measure === 3);
+    expect(measure3.length).toBeGreaterThan(0);
+    expect(measure3.every((event) => !isPlayableChannel(event.channel))).toBe(true);
+  });
+
+  test('lntype2-long-note.bms expands continuous runs into long notes', async () => {
+    const json = await parseChartFile(fixture('lntype2-long-note.bms'));
+    expect(json.bms.lnType).toBe(2);
+
+    const resolved = resolveBmsLongNotes(json);
+    const byLane = new Map<string, typeof resolved.notes>();
+    for (const note of resolved.notes) {
+      byLane.set(note.channel, [...(byLane.get(note.channel) ?? []), note]);
+    }
+
+    // Measure 1 — one run of four eighth-note slots on lane 1: beat 0 to beat 2.
+    const lane1 = byLane.get('11') ?? [];
+    expect(lane1).toHaveLength(1);
+    expect(lane1[0]?.beat).toBeCloseTo(4, 6);
+    expect(lane1[0]?.endBeat).toBeCloseTo(6, 6);
+
+    // Measure 2 — two runs separated by an empty slot must stay two long notes.
+    expect(byLane.get('13')).toHaveLength(2);
+
+    // Measures 3-4 — a run across the measure boundary is one long note.
+    const lane5 = byLane.get('15') ?? [];
+    expect(lane5).toHaveLength(1);
+    expect(lane5[0]?.beat).toBeCloseTo(15, 6);
+    expect(lane5[0]?.endBeat).toBeCloseTo(17, 6);
+
+    // Every token after a run's first is a continuation and must not trigger a keysound.
+    expect(resolved.suppressedTriggerEvents.size).toBeGreaterThan(0);
+    for (const note of resolved.notes) {
+      expect(resolved.suppressedTriggerEvents.has(note.event)).toBe(false);
+    }
+  });
+
+  test('bmson-key-channels-mines.bmson routes key_channels mines and keeps the LN extensions', async () => {
+    const json = await parseChartFile(fixture('bmson-key-channels-mines.bmson'));
+
+    expect(json.bmson.info.lnType).toBe(2);
+    expect(json.bmson.info.modeHint).toBe('beat-7k');
+
+    // `key_channels` notes become landmines on the `Dx` / `Ex` channels via the same `mode_hint` lane map the playable
+    // notes use: x=1 → 11 → D1, x=6 → 18 → D8, x=8 → scratch 16 → D6.
+    const mines = json.events.filter((event) => /^[DE]/.test(event.channel));
+    expect(mines.map((event) => event.channel)).toEqual(['D1', 'D8', 'D6']);
+    expect(mines.map((event) => event.bmson?.damage)).toEqual([0, 50, 100]);
+
+    // The mine WAV is registered after the `sound_channels` block, keeping the WAV ID space contiguous.
+    expect(json.resources.wav['03']).toBe('wrong.wav');
+
+    // `notes[].t` survives only on long notes (`l > 0`).
+    const withNoteType = json.events.filter((event) => event.bmson?.t !== undefined);
+    expect(withNoteType.length).toBeGreaterThan(0);
+    for (const event of withNoteType) {
+      expect(event.bmson?.l ?? 0).toBeGreaterThan(0);
+    }
+  });
+
+  test('nonpositive-bpm.bms keeps its usable tempo points and drops the rest', async () => {
+    const json = await parseChartFile(fixture('nonpositive-bpm.bms'));
+
+    // Zero and negative slots are stored verbatim — the parser's job is to report what the chart says.
+    expect(json.resources.bpm).toEqual({ '01': 130, '02': 0, '03': -65 });
+
+    // All four channel-08 references survive parsing, including the one pointing at an undefined slot.
+    const tempoRefs = json.events.filter((event) => event.channel === '08');
+    expect(tempoRefs.map((event) => event.value)).toEqual(['01', '02', '03', 'ZZ']);
+    expect(json.resources.bpm.ZZ).toBeUndefined();
+
+    // Notes keep playing on every lane through the bad changes, so a consumer that skips the unusable tempo points
+    // still has a chart to render rather than an empty one.
+    for (const measure of [0, 1, 2, 3, 4, 5]) {
+      expect(
+        json.events.some((event) => event.measure === measure && event.channel === '11'),
+        `measure ${measure}`,
+      ).toBe(true);
+    }
+  });
+
+  test('7key-longnote.bml parses and classifies like any other BMS chart', async () => {
+    // The `.bml` extension carries no parsing rule of its own, so the point is that a real file with that extension
+    // reaches the same place a `.bme` chart would.
+    const json = await parseChartFile(fixture('7key-longnote.bml'));
+
+    expect(json.sourceFormat).toBe('bms');
+    expect(json.metadata.title).toBe('7 KEY Long Note (BML)');
+    expect(json.bms.lnObjs).toContain('ZZ');
+    expect(
+      resolveChartPlayVariant({ chartPath: fixture('7key-longnote.bml'), events: json.events, bms: json.bms }),
+    ).toBe('7');
+
+    // The long notes are real head/tail pairs, not stray markers: every head maps to an end beat, and every `ZZ`
+    // object is claimed as the end of one of them.
+    const resolved = resolveLnobjLongNotes(json);
+    expect(resolved.startToEndBeat.size).toBeGreaterThan(0);
+    expect(resolved.endEvents.size).toBe(resolved.startToEndBeat.size);
+    for (const [head, endBeat] of resolved.startToEndBeat) {
+      expect(endBeat, `${head.measure}:${head.channel}`).toBeGreaterThan(eventToBeat(json, head));
+    }
+  });
+
+  test('measure-length.bms shortens a single measure', async () => {
+    const json = await parseChartFile(fixture('measure-length.bms'));
+
+    expect(json.measures).toEqual([{ index: 1, length: 0.5 }]);
+    // One note per measure across three measures, so the shortened middle measure is visible as timing, not as data.
+    expect(json.events.filter((event) => event.channel === '11')).toHaveLength(3);
+  });
+
+  test('control-flow-random-demo.bms resolves every branch shape it authors', async () => {
+    const parsed = await parseChartFile(fixture('control-flow-random-demo.bms'));
+
+    // Unresolved, the chart carries the control-flow commands rather than the branch bodies' objects.
+    expect(parsed.bms.controlFlow.length).toBeGreaterThan(0);
+
+    // `#RANDOM 1` / `#SWITCH 1` — the lowest branch of every block.
+    const first = resolveBmsControlFlow(parsed, { random: () => 0 });
+    expect(first.metadata.title).toBe('Control Flow Random Demo [A]');
+    expect(first.events.some((event) => event.measure === 4 && event.channel === '11')).toBe(true);
+
+    // The top branch of every block. `#RANDOM 2` selects the `#ELSE` body, which retitles the chart.
+    const last = resolveBmsControlFlow(parsed, { random: () => 0.999_999_9 });
+    expect(last.metadata.title).toBe('Control Flow Random Demo [B]');
+    expect(last.events.some((event) => event.measure === 0 && event.channel === '29')).toBe(true);
+    expect(last.events.some((event) => event.measure === 12 && event.channel === '16')).toBe(true);
+
+    // Resolution is exclusive: an object from the branch that was not taken never survives.
+    expect(first.events.some((event) => event.measure === 0 && event.channel === '29')).toBe(false);
+    expect(last.events.some((event) => event.measure === 4 && event.channel === '11')).toBe(false);
+  });
+});
diff --git a/packages/parser/src/index.test.ts b/packages/parser/src/index.test.ts
index 5d8f0469..80c11f5a 100644
--- a/packages/parser/src/index.test.ts
+++ b/packages/parser/src/index.test.ts
@@ -107,6 +107,11 @@ describe('parser', () => {
 
     expect(json.metadata.title).toBe('テスト曲');
     expect(json.metadata.artist).toBe('佐藤');
+
+    // `sjis-encoding-test.json` is the checked-in IR for that chart, so the decoded text is pinned as data rather
+    // than only as two assertions — an encoding regression shows up as a whole-document diff.
+    const expected = JSON.parse(await readFile(resolve(rootDir, 'examples/test/sjis-encoding-test.json'), 'utf8'));
+    expect(json).toEqual(expected);
   });
 
   test('BMS: uses 130 BPM when #BPM is omitted', () => {
@@ -294,14 +299,18 @@ describe('parser', () => {
     expect(json.metadata.extras.CHARSET).toBeUndefined();
   });
 
-  test('BMS: parses SPEED indexed headers and SP keyframes into bms extensions/events', () => {
-    const parsed = parseChart(['#SPEED01 1', '#SPEED02 0.5', '#001SP:0102', ''].join('\n'));
+  test('BMS: parses SPEED indexed headers and SP keyframes into bms extensions/events', async () => {
+    // `scroll-speed-gimmick.bms` is the fixture for the whole timing / drawing gimmick family; measure 7 is its
+    // dedicated `SP` (note-spacing) bar.
+    const parsed = await parseChartFile(resolve(rootDir, 'examples/test/scroll-speed-gimmick.bms'));
 
     expect(parsed.bms.speed['01']).toBe(1);
     expect(parsed.bms.speed['02']).toBe(0.5);
-    expect(parsed.events).toEqual([
-      { measure: 1, channel: 'SP', position: [0, 2], value: '01' },
-      { measure: 1, channel: 'SP', position: [1, 2], value: '02' },
+    expect(parsed.bms.speed['03']).toBe(2);
+    expect(parsed.events.filter((event) => event.measure === 7 && event.channel === 'SP')).toEqual([
+      { measure: 7, channel: 'SP', position: [0, 3], value: '01' },
+      { measure: 7, channel: 'SP', position: [1, 3], value: '02' },
+      { measure: 7, channel: 'SP', position: [2, 3], value: '03' },
     ]);
   });
 
@@ -992,34 +1001,22 @@ describe('parser', () => {
     expect(reparsed.events.find((event) => event.channel === '11')?.bmson?.t).toBe(3);
   });
 
-  test('bmson: key_channels mines route through the same mode_hint lane map onto Dx / Ex channels', () => {
-    const json = parseBmson(
-      JSON.stringify({
-        version: '1.0.0',
-        info: { init_bpm: 120, resolution: 240, mode_hint: 'beat-7k' },
-        sound_channels: [{ name: 'note.wav', notes: [{ x: 1, y: 0 }] }],
-        key_channels: [
-          {
-            name: 'mine.wav',
-            notes: [
-              { x: 6, y: 240, damage: 0 },
-              { x: 8, y: 480, damage: 50 },
-            ],
-          },
-        ],
-      }),
-    );
+  test('bmson: key_channels mines route through the same mode_hint lane map onto Dx / Ex channels', async () => {
+    const json = await parseChartFile(resolve(rootDir, 'examples/test/bmson-key-channels-mines.bmson'));
 
     const mineEvents = json.events.filter((event) => event.channel.startsWith('D') || event.channel.startsWith('E'));
-    expect(mineEvents).toHaveLength(2);
-    // x=6 → 18 (1P key 6) → mine D8
-    expect(mineEvents[0].channel).toBe('D8');
+    expect(mineEvents).toHaveLength(3);
+    // x=1 → 11 (1P key 1) → mine D1
+    expect(mineEvents[0].channel).toBe('D1');
     expect(mineEvents[0].bmson?.damage).toBe(0);
-    // x=8 → 16 (1P scratch) → mine D6
-    expect(mineEvents[1].channel).toBe('D6');
+    // x=6 → 18 (1P key 6) → mine D8
+    expect(mineEvents[1].channel).toBe('D8');
     expect(mineEvents[1].bmson?.damage).toBe(50);
+    // x=8 → 16 (1P scratch) → mine D6
+    expect(mineEvents[2].channel).toBe('D6');
+    expect(mineEvents[2].bmson?.damage).toBe(100);
     // The mine WAV is registered after the sound_channels block.
-    expect(json.resources.wav['02']).toBe('mine.wav');
+    expect(json.resources.wav['03']).toBe('wrong.wav');
   });
 
   test('JSON: normalizes bms/bmson extensions, ignores deprecated bms.lnObj, and rejects invalid positions', () => {
@@ -1349,22 +1346,20 @@ describe('parser', () => {
     });
   });
 
-  test('BMS: `#BASE 62` preserves case for indexed-header keys and channel-stream tokens', () => {
-    const parsed = parseChart(
-      ['#BASE 62', '#WAV0a lower.wav', '#WAV0A upper.wav', '#WAVZz mixed.wav', '#00111:0a0AZz', ''].join('\n'),
-    );
+  test('BMS: `#BASE 62` preserves case for indexed-header keys and channel-stream tokens', async () => {
+    const parsed = await parseChartFile(resolve(rootDir, 'examples/test/base62-ids.bms'));
 
     // Base-62 mode is recorded on the JSON.
     expect(parsed.bms.base).toBe(62);
     // Lowercase / uppercase / mixed-case IDs all live in distinct slots.
-    expect(parsed.resources.wav['0a']).toBe('lower.wav');
-    expect(parsed.resources.wav['0A']).toBe('upper.wav');
-    expect(parsed.resources.wav['Zz']).toBe('mixed.wav');
+    expect(parsed.resources.wav['0a']).toBe('sample.wav');
+    expect(parsed.resources.wav['0A']).toBe('branch.wav');
+    expect(parsed.resources.wav['Zz']).toBe('sample.wav');
     // Channel-stream tokens carry the same case-preserved IDs into events.
-    expect(parsed.events).toEqual([
-      { measure: 1, channel: '11', position: [0, 3], value: '0a' },
-      { measure: 1, channel: '11', position: [1, 3], value: '0A' },
-      { measure: 1, channel: '11', position: [2, 3], value: 'Zz' },
+    expect(parsed.events.filter((event) => event.measure === 4)).toEqual([
+      { measure: 4, channel: '11', position: [0, 3], value: '0a' },
+      { measure: 4, channel: '11', position: [1, 3], value: '0A' },
+      { measure: 4, channel: '11', position: [2, 3], value: 'Zz' },
     ]);
     // The `#BASE` directive itself is consumed — never leaks into extras.
     expect(parsed.metadata.extras.BASE).toBeUndefined();
diff --git a/packages/player-tui/src/cli/chart-selection.test.ts b/packages/player-tui/src/cli/chart-selection.test.ts
index 669eddfe..7271448c 100644
--- a/packages/player-tui/src/cli/chart-selection.test.ts
+++ b/packages/player-tui/src/cli/chart-selection.test.ts
@@ -1,5 +1,5 @@
 import { mkdtemp, mkdir, readFile, rm, stat, utimes, writeFile } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
+import { dirname, extname, join, resolve } from 'node:path';
 import { tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
@@ -57,6 +57,16 @@ describe('chart selection', () => {
     });
   });
 
+  test('listChartFiles: picks up every chart extension the examples/test corpus uses', async () => {
+    // The allow-list has four BMS-family extensions plus `.bmson`. Pointing it at the shared fixture directory keeps
+    // it honest against real files instead of synthetic names — `.bml` in particular had no fixture to open.
+    const files = await listChartFiles(resolve(rootDir, 'examples/test'));
+    const extensions = new Set(files.map((file) => extname(file).toLowerCase()));
+
+    expect(extensions).toEqual(new Set(['.bms', '.bme', '.bml', '.pms', '.bmson']));
+    expect(files.some((file) => file.endsWith('7key-longnote.bml'))).toBe(true);
+  });
+
   test('buildChartSelectionEntries: includes music metadata extras used by music-select', async () => {
     const bmsPath = resolve(rootDir, 'examples/test/four-measure-command-combo-test.bms');
     const bmsonPath = resolve(rootDir, 'examples/test/bmson-strict-features.bmson');

From 48e9b4980884be780274837485bfdebee9386caa Mon Sep 17 00:00:00 2001
From: Seiya KONNO <nulltask@gmail.com>
Date: Mon, 24 Aug 2026 01:36:45 +0900
Subject: [PATCH 3/3] docs(examples): index the test chart fixtures [ci skip]

A directory of 40-plus fixtures with no index is what let the broken and stale ones sit there unnoticed. Document what every chart covers, which tests read the round-trip sets, and the conventions a new fixture should follow.
---
 examples/test/README.ja.md | 121 +++++++++++++++++++++++++++++++++++++
 examples/test/README.md    | 121 +++++++++++++++++++++++++++++++++++++
 2 files changed, 242 insertions(+)
 create mode 100644 examples/test/README.ja.md
 create mode 100644 examples/test/README.md

diff --git a/examples/test/README.ja.md b/examples/test/README.ja.md
new file mode 100644
index 00000000..ee45cf89
--- /dev/null
+++ b/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` 不在時のフォールバックケース。 |
diff --git a/examples/test/README.md b/examples/test/README.md
new file mode 100644
index 00000000..640e054d
--- /dev/null
+++ b/examples/test/README.md
@@ -0,0 +1,121 @@
+# Test Chart Fixtures
+
+[日本語版はこちら](./README.ja.md)
+
+Shared chart and audio fixtures for the be-music test suite. Every chart here targets one coherent feature cluster, and
+every chart is read by at least one test — a fixture no test reads goes stale without anyone noticing, which is how the
+problems fixed in this directory got in.
+
+The corpus-level guard lives in [`packages/parser/src/fixtures.test.ts`](../../packages/parser/src/fixtures.test.ts). It
+scans this directory, parses every chart off disk, and requires each one to yield playable events after control-flow
+resolution. Add a chart here and it is picked up automatically; break one and that test fails.
+
+## Conventions
+
+- Name a chart after the feature it exercises, in kebab-case.
+- Pick the extension deliberately. `.bms` / `.bme` / `.bml` / `.pms` feed lane-mode detection, so the extension is part
+  of what a fixture asserts.
+- Open with the `*---------------------- ... FIELD` section banners the existing charts use, and explain in a `*`
+  comment block what the chart is for and which behaviour would break if it changed.
+- Reference only audio files that already exist in this directory, so every chart is actually playable by hand.
+
+## Charts by feature
+
+### Header and directive coverage
+
+| File                                   | Covers                                                                                                                                                             |
+| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `four-measure-command-combo-test.bms`  | Every extension header and object channel the parser routes, one 4-measure block per command group. Proves routing and roundtrip preservation, not payload validity. |
+| `extended-directives.bms`              | The same directive family with payloads the `@be-music/chart` value parsers accept: `#EXWAV` `pvf`, `#EXBMP` ARGB tuple, `#ARGB` hex and decimal, `#BGA` sub-region, `#SWBGA` animation, `#WAVCMD` pitch/volume/loop, `#EXRANK` on channel `A0`, `#CHANGEOPTION` on channel `A6`, `#STP`. |
+| `base62-ids.bms`                       | `#BASE 62` — upper, lower and mixed case object IDs as distinct slots, in indexed headers, channel streams, `#LNOBJ`, and inside a `#RANDOM` / `#IF` block.          |
+| `sjis-encoding-test.bms`               | Shift_JIS auto-detection. Its parsed IR is pinned in `sjis-encoding-test.json`.                                                                                     |
+| `benchmark-command-mix-100.bms`        | Parser throughput over 100 measures with a mixed command load. Not wired to `pnpm bench`, which uses its own inline chart.                                           |
+
+### Timing and drawing gimmicks
+
+| File                        | Covers                                                                                                                                                        |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `scroll-speed-gimmick.bms`  | One measure per gimmick: `#xxx02` measure length, `#xxx03` hex BPM, `#xxx08` `#BPMxx` reference, `#xxx09` STOP, `#xxxSC` `#SCROLLxx` (including `0` and negative), `#xxxSP` `#SPEEDxx`, then all of them in one measure. |
+| `measure-length.bms`        | A single shortened measure surrounded by normal ones.                                                                                                          |
+| `bus-volume-channels.bms`   | Channels `97` (BGM bus) and `98` (key bus) dynamic volume, including both buses moving on the same beat.                                                       |
+| `nonpositive-bpm.bms`       | Channel `08` pointed at a zero slot, a negative slot, and an undefined slot — the tempo points the timeline has to drop while still leaving a playable chart.   |
+
+### Long notes
+
+| File                              | Covers                                                                          |
+| --------------------------------- | ------------------------------------------------------------------------------- |
+| `ln-mode-1-long-note.bms`         | `#LNMODE 1` (LN) with `#LNOBJ` head/tail pairs. Also the 7 KEY SP lane fixture.  |
+| `ln-mode-2-charge-note.bms`       | `#LNMODE 2` (CN) — same chart data, different mode.                              |
+| `ln-mode-3-hell-charge-note.bms`  | `#LNMODE 3` (HCN) — same chart data, different mode.                             |
+| `lntype2-long-note.bms`           | `#LNTYPE 2` continuous runs: one run in a measure, two runs split by a gap, and a run crossing a measure boundary. |
+| `ln-9key-popn.bms`                | Long notes on all nine POPN lanes with `#PLAYER 3`.                              |
+
+### Lane modes
+
+One fixture per branch of `resolveChartPlayVariant`.
+
+| File                          | Lane mode   |
+| ----------------------------- | ----------- |
+| `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` + channel `17`) |
+| `10key-dp.bms`                | 10 KEY DP   |
+| `lane-order-test.bms`         | 14 KEY DP — also the lane-ordering chart, every classic column on both sides |
+| `24key-keyboard-sp.bme`       | 24 KEY SP — extended `1A..1O` columns |
+| `48key-keyboard-dp.bme`       | 48 KEY DP — extended columns on both sides |
+| `7key-longnote.bml`           | 7 KEY SP — the `.bml` extension, which carries no parsing rule of its own but is on every chart-file allow-list |
+
+### Lanes and hazards
+
+| File                    | Covers                                                                                                        |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `invisible-notes.bms`   | Invisible keysound channels `3x` / `4x` — they sound but are neither drawn nor judged, and the 2P-side `4x` channels must not turn a single-player chart into a DP chart. |
+
+### Control flow
+
+| File                             | Covers                                                                                                  |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `control-flow-random-demo.bms`   | `#RANDOM` / `#IF` / `#ELSE` with a metadata override, plus two `#SWITCH` / `#CASE` / `#DEF` blocks. Every object lives inside a branch, so the chart is empty until control flow is resolved. |
+
+### bmson
+
+| File                                | Covers                                                                                            |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `bmson-strict-features.bmson`       | The full `info` block, `bga` headers and events, `lines`, and `notes[].l` / `.c`.                  |
+| `bmson-lines-resolution-test.bmson` | Non-uniform `lines` and the resolution-dependent conversion of `stop_events.duration`.             |
+| `bmson-key-channels-mines.bmson`    | beatoraja extensions: `key_channels` mines routed through the `mode_hint` lane map onto `Dx` / `Ex`, `info.ln_type`, and `notes[].t`. |
+
+### Format round trips
+
+These five files only mean anything as a set, and
+[`packages/editor/src/index.test.ts`](../../packages/editor/src/index.test.ts) checks them against the live pipeline:
+
+| File                     | Role                                                    |
+| ------------------------ | ------------------------------------------------------- |
+| `sample.bms`             | The source chart.                                       |
+| `sample.json`            | What `importChart` produces from it.                    |
+| `sample.roundtrip.bmson` | The same chart exported to bmson.                       |
+| `sample.edit.json`       | The chart after one retitle and one added note.         |
+| `sample.edited.bms`      | What `exportChart` writes back out from that edit.      |
+
+Regenerate them through the editor API rather than by hand — that is what keeps them honest.
+
+### Audio playback
+
+| File                                    | Covers                                                                                        |
+| --------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `retrigger-same-key-cut.bms`            | BMS monophonic playback: a second trigger on the same lane cuts the first voice.               |
+| `retrigger-different-key-overlap.bms`   | A different lane does not cut, even when both slots point at the same file.                    |
+| `ogg-test.bms`                          | A chart whose `#WAV` names a non-wav codec, so the loader has to reach the Vorbis decoder.     |
+
+## Audio assets
+
+| File                                                       | Used by                                                                          |
+| ---------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `sample.wav`                                               | The default keysound for most charts, and the audio-renderer's reference sample.  |
+| `branch.wav`, `right.wav`, `wrong.wav`                     | Secondary keysounds, mostly for telling control-flow branches apart by ear.       |
+| `retrigger_a.wav`, `retrigger_b.wav`                       | The 2.2 s samples the retrigger charts need in order to overlap at all.           |
+| `ogg-test.ogg`                                             | The Vorbis sample `ogg-test.bms` declares.                                        |
+| `ogg-test.wav`                                             | The uncompressed source for `ogg-test.ogg`. Kept as source material; no test reads it. |
+| `render-codec-test.mp3` / `.ogg` / `.opus`                 | The audio-renderer's per-codec decode cases, and its missing-`.wav` fallback case. |