Specificatie vsa-templates (draft)¶
Status: draft v0 (getoetst met voorbeelden + schema-toets).
Deze map is de specificatie van vsa-templates: YAML voor formulematige melodieën met template-frasen, herhaling of vaste volgorde, reciteertonen, frase-ankers en SATB-laddergraden binnen een do-context.
Lees eerst het idee: Doel en scope.
Relatie tot VSA 1.0¶
| Map | Rol |
|---|---|
docs/specification/ |
Normatieve VSA 1.0 (tekst + relatieve melodie) |
docs/specification-vsa-templates/ (deze) |
Draft-spec voor melodietemplates |
Integratie in de VSA 1.0-tree volgt zodra glossary/org-termen en mapping stabiel
zijn. Tool-termen staan al in docs/terminologie/ (zie glossary).
Documenten¶
| Document | Inhoud |
|---|---|
| Doel en scope | Idee, niet-doelen, TermRefs |
| Requirements-inventory | Feature-eisen uit toonboekbladen |
| Metamodel | Concepten en relaties |
| Syntax | Canonieke YAML-vorm |
| Semantiek | Betekenis cycle/sequence/recite/ankers |
| Validatie | Geldigheidsregels |
| Mapping VSA | Contract VSA-tekst ↔ template (experimenteel) |
| Rendering-valkuilen | Probleem → oorzaak → regel (MSCZ/MXL/instance) |
| Voorbeelden | Library + invalid cases |
| Library | Werkmappen per genre × toon |
| Conformiteit | Wanneer template/tool conform is |
| Open punten | Open vragen |
| Versionering | Versiebeleid van deze draft |
| JSON Schema | Structurele toetsing |
Criteria draft v0 (getoetst)¶
- Inventory, metamodel, syntax, semantiek, validation en conformance geschreven;
- ≥2 geldige voorbeelden (verschillend genre/toon) en ≥3 ongeldige cases;
- Schema-/documenttoets via
tests/test_vsa_template_schema.pygroen; - Open punten expliciet;
- Begrippen via curated texts + TermRefs leesbaar op de docs-site.
Bewust buiten scope (nu)¶
- MusicXML-/SVG-export uit templates;
- OMR / automatische pitch-extractie uit PDF;
- wijzigingen aan de VSA 1.0-parser.