tonus 0.11.1 → 0.13.0

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 All notable changes to tonus. Newest first.
 
+## 0.13.0 — 2026-10-01
+
+Every written head reaches its glyph.
+
+### Changed
+
+- **Breaking: the hollow is a flag, not a shape.** `WrittenShape` loses
+  `cavum` and `linea` and gains `lineaPunctum` (gabc `R`, the punctum between
+  two vertical lines). A hollow note keeps its shape and sets `hollow`, since
+  gregorio empties a punctum, an inclinatum or a lineaPunctum alike. `linea`
+  could never be parsed; its glyph was the lineaPunctum's under a wrong label.
+- `gr1`–`gr5` were read as hollow notes. They are full notes carrying a sign.
+
+### Added
+
+- Rows carry `liquescence` (`~` deminutive, `<` ascending, `>` descending),
+  `oriscusDirection` (written `o0`/`o1`, or toward the next pitch that differs,
+  as gregorio resolves it), `hollow`, and `signum` (gabc `r1`–`r5`).
+- The quadrata emitter draws the liquescent puncta and inclinata, the orisci
+  both ways and liquescent, the stropha and its auctus, the cavum and the
+  lineaPunctum (full and hollow) from their own Bravura glyphs, where it drew a
+  shrunk punctum for every liquescence. The signa print over the note; the
+  reversed accentus and the cup semicircle are Bravura's mirrored. A hollow
+  inclinatum, which Bravura does not carry, is the diamond's outline traced at
+  the staff line's weight — the way the score app already hollows it.
+- A lone `s` is a stropha, as in gregorio.
+
+## 0.12.0 — 2026-09-24
+
+A mass number is a Mass.
+
+### Changed
+
+- **Breaking: `mass` is one of Masses I–XVIII, or 0.** The Kyriale's appendix
+  carried its Graduale page as a mass number, so Clemens Rector read as mass
+  75 and the Requiem as 94, 101 and 102. Two ad libitum Kyries whose incipits
+  carry a numeral were worse: they read as Masses VI and X, so
+  `ordinarium({ mass: 6 })` returned an appendix Kyrie beside Mass VI's own,
+  and the era rule dated it by Mass VI's century. Every entry now carries a
+  `section` (`mass`, `credo`, `sprinkling`, `ad-libitum`, `requiem`), and only
+  the `mass` section is numbered. `ordinarium({ section: "requiem" })` replaces
+  `ordinarium({ mass: 102 })`. The appendix still rotates in the book's order,
+  now read from its Graduale pages.
+
 ## 0.11.1 — 2026-09-10
 
 The Kyriale says where it is printed.

package/dist/data/gabc-glyphs.d.ts

@@ -13,14 +13,21 @@ export declare const GLYPH: {
     readonly cClef: "E906";
     readonly punctum: "E990";
     readonly punctumInclinatum: "E991";
+    readonly punctumInclinatumAuctum: "E992";
+    readonly punctumInclinatumDeminutum: "E993";
+    readonly auctumAsc: "E994";
+    readonly auctumDesc: "E995";
     readonly virga: "E996";
     readonly virgaReversa: "E997";
     readonly cavum: "E998";
-    readonly linea: "E999";
+    readonly lineaPunctum: "E999";
+    readonly lineaPunctumCavum: "E99A";
     readonly quilisma: "E99B";
     readonly oriscusAsc: "E99C";
     readonly oriscusDesc: "E99D";
+    readonly oriscusLiquescens: "E99E";
     readonly strophicus: "E99F";
+    readonly strophicusAuctus: "E9A0";
     readonly punctumDeminutum: "E9A1";
     readonly custosUp: readonly ["EA04", "EA05", "EA06"];
     readonly custosDown: readonly ["EA07", "EA08", "EA09"];
@@ -28,14 +35,39 @@ export declare const GLYPH: {
     readonly podatusUpper: "E9B1";
     readonly ictusAbove: "E9D0";
     readonly ictusBelow: "E9D1";
+    readonly circulus: "E9D2";
+    readonly semicirculus: "E9D4";
+    readonly accentus: "E9D6";
     readonly episema: "E9D8";
     readonly mora: "E9D9";
     readonly flat: "E9E0";
     readonly natural: "E9E1";
     readonly sharp: "E262";
 };
-/** Written note shape → notehead glyph codepoint. */
+/** Written note shape → notehead glyph codepoint, before liquescence and the hollow. */
 export declare const SHAPE_GLYPH: Readonly<Record<string, string>>;
+/** The fields of a note that choose its head. */
+export interface HeadSpec {
+    shape: string;
+    liquescence: "deminutive" | "ascending" | "descending" | null;
+    oriscusDirection: "ascending" | "descending" | null;
+    hollow: boolean;
+}
+/**
+ * The notehead for a note, or null when Bravura draws no head for that
+ * combination (a liquescent virga or quilisma) and the caller keeps its
+ * fallback. Gregorio's rules: an oriscus takes only the deminutive
+ * liquescence; a strophicus either augmentation as its auctus. A hollow
+ * inclinatum returns the full diamond: Bravura has no cavum of it, so the
+ * emitter traces that outline instead (see `tracedHollow`).
+ */
+export declare function headGlyph(n: HeadSpec): string | null;
+/**
+ * A hollow head Bravura does not carry, drawn as its full glyph's outline:
+ * the inclinatum (gabc Gr, G<r). The score app hollows its diamond the same
+ * way, so the two agree.
+ */
+export declare function tracedHollow(n: HeadSpec): boolean;
 /** Divisio mark → glyph codepoint. */
 export declare const DIVISIO_GLYPH: Readonly<Record<string, string>>;
 /** EntryLineAsc component for a rising interval of `steps` diatonic degrees. */

package/dist/data/gabc-glyphs.js

@@ -30,17 +30,27 @@ export const GLYPH = {
     // clefs
     fClef: "E902",
     cClef: "E906",
-    // single notes
+    // single notes (SMuFL plainchant, E990–E9A1)
     punctum: "E990",
     punctumInclinatum: "E991",
+    punctumInclinatumAuctum: "E992",
+    punctumInclinatumDeminutum: "E993",
+    auctumAsc: "E994",
+    auctumDesc: "E995",
     virga: "E996",
     virgaReversa: "E997",
     cavum: "E998",
-    linea: "E999",
+    // chantPunctumLinea: a punctum BETWEEN two vertical lines, gabc R (and, hollow,
+    // r0). Not the linea — gabc's `=` bar-shaped note, which SMuFL does not carry.
+    // gabc-smufl's map labels it "bar note, no notehead"; the outline says otherwise.
+    lineaPunctum: "E999",
+    lineaPunctumCavum: "E99A",
     quilisma: "E99B",
     oriscusAsc: "E99C",
     oriscusDesc: "E99D",
+    oriscusLiquescens: "E99E",
     strophicus: "E99F",
+    strophicusAuctus: "E9A0",
     punctumDeminutum: "E9A1",
     // THE CUSTOS, added to the bake 2026-08-12. Bravura carries it at EA00-EA09
     // and the subset did not, so the emitter drew a plain punctum at a line's
@@ -75,6 +85,9 @@ export const GLYPH = {
     // rhythmic signs
     ictusAbove: "E9D0",
     ictusBelow: "E9D1",
+    circulus: "E9D2",
+    semicirculus: "E9D4",
+    accentus: "E9D6",
     episema: "E9D8",
     mora: "E9D9",
     // accidentals (medieval soft-b flat / natural; standard sharp fallback).
@@ -85,7 +98,7 @@ export const GLYPH = {
     natural: "E9E1",
     sharp: "E262",
 };
-/** Written note shape → notehead glyph codepoint. */
+/** Written note shape → notehead glyph codepoint, before liquescence and the hollow. */
 export const SHAPE_GLYPH = Object.freeze({
     punctum: GLYPH.punctum,
     inclinatum: GLYPH.punctumInclinatum,
@@ -94,9 +107,53 @@ export const SHAPE_GLYPH = Object.freeze({
     quilisma: GLYPH.quilisma,
     oriscus: GLYPH.oriscusAsc,
     strophicus: GLYPH.strophicus,
-    cavum: GLYPH.cavum,
-    linea: GLYPH.linea,
+    lineaPunctum: GLYPH.lineaPunctum,
 });
+/**
+ * The notehead for a note, or null when Bravura draws no head for that
+ * combination (a liquescent virga or quilisma) and the caller keeps its
+ * fallback. Gregorio's rules: an oriscus takes only the deminutive
+ * liquescence; a strophicus either augmentation as its auctus. A hollow
+ * inclinatum returns the full diamond: Bravura has no cavum of it, so the
+ * emitter traces that outline instead (see `tracedHollow`).
+ */
+export function headGlyph(n) {
+    const liq = n.liquescence;
+    switch (n.shape) {
+        case "punctum":
+            if (liq === "deminutive")
+                return GLYPH.punctumDeminutum;
+            if (liq === "ascending")
+                return GLYPH.auctumAsc;
+            if (liq === "descending")
+                return GLYPH.auctumDesc;
+            return n.hollow ? GLYPH.cavum : GLYPH.punctum;
+        case "inclinatum":
+            if (liq === "deminutive")
+                return GLYPH.punctumInclinatumDeminutum;
+            if (liq)
+                return GLYPH.punctumInclinatumAuctum;
+            return GLYPH.punctumInclinatum;
+        case "oriscus":
+            if (liq === "deminutive")
+                return GLYPH.oriscusLiquescens;
+            return n.oriscusDirection === "descending" ? GLYPH.oriscusDesc : GLYPH.oriscusAsc;
+        case "strophicus":
+            return liq ? GLYPH.strophicusAuctus : GLYPH.strophicus;
+        case "lineaPunctum":
+            return n.hollow ? GLYPH.lineaPunctumCavum : GLYPH.lineaPunctum;
+        default:
+            return liq ? null : SHAPE_GLYPH[n.shape] ?? null;
+    }
+}
+/**
+ * A hollow head Bravura does not carry, drawn as its full glyph's outline:
+ * the inclinatum (gabc Gr, G<r). The score app hollows its diamond the same
+ * way, so the two agree.
+ */
+export function tracedHollow(n) {
+    return n.hollow && n.shape === "inclinatum";
+}
 /** Divisio mark → glyph codepoint. */
 export const DIVISIO_GLYPH = Object.freeze({
     ",": GLYPH.divisioMinima,

package/dist/data/kyriale.d.ts

@@ -1,7 +1,11 @@
 export type KyrialeOffice = "ke" | "gl" | "cr" | "sa" | "ag" | "be" | "it" | "as" | "va";
+/** Where the Kyriale prints an entry. Only `mass` entries carry a mass number. */
+export type KyrialeSection = "mass" | "credo" | "sprinkling" | "ad-libitum" | "requiem";
 export interface KyrialeEntry {
     id: string;
     office: KyrialeOffice;
+    section: KyrialeSection;
+    /** One of Masses I–XVIII, or null outside the numbered Masses. */
     mass: number | null;
     mode: string | null;
     incipit: string;