JSON Score

README.md

@@ -76,6 +76,27 @@ python3 -m generator --data-dir data --output-dir /tmp/product-vamp-generated --
 
 The `--check` path compares generation invariants against `data/expected/performance_summary.json`.
 
+Authored score files use compact JSON. Metadata stays as normal JSON fields, while each measure is a readable notation string:
+
+```json
+{
+  "title": "Autumn Leaves",
+  "key": "F",
+  "time": "4/4",
+  "clef": "treble",
+  "part": "Vocal",
+  "role": "vocal",
+  "measures": [
+    "[G-7] Bb4:1~ \"leaves\"",
+    "[C7] ~Bb4:4 C4:4 \"drift\" D4:4 \"by\" E4:4 \"my\"",
+    "{5:2 C4:4 D4:4 E4:4 F4:4 G4:4}",
+    "[G7] (G4 B4 F5):4 r:4"
+  ]
+}
+```
+
+Notation tokens are `PITCH:DURATION`, `r:DURATION`, and `(PITCH PITCH ...):DURATION` for written chord tones. Durations use `1`, `2`, `4`, `8`, `16`, `32`, plus `.` for dotted values. `[Chord]` applies to the next token, quoted text applies as a lyric to the previous note, `~` starts or ends ties, and `{N:M ...}` writes tuplets such as five quarter notes in the space of two quarter notes.
+
 Bundled third-party font assets live in `package/assets/fonts/petaluma`. Petaluma is from Steinberg and is distributed under the SIL Open Font License; the package keeps `OFL.txt` next to the font files. If the Pico bitmap font needs to be refreshed after changing the bundled UI font, run:
 
 ```sh