tonus 0.1.8 → 0.6.1

package/dist/engines/harmonia/data/zodiac.js

@@ -0,0 +1,163 @@
+// ---------------------------------------------------------------------------
+// engines/harmonia/data/zodiac — what the twelve signs MEAN
+// ---------------------------------------------------------------------------
+//
+// `caelum` answers WHERE: a body's ecliptic longitude becomes `zodiac` (the
+// index), `sign` and `signum`. This table answers WHAT IT MEANS — the doctrine
+// a medieval reader brought to that position.
+//
+// DELIBERATELY NO DATES. When the Sun enters a sign is the ephemeris's
+// business and changes with precession; a table that carried "March 21" would
+// be wrong for most of the period this library models, and wrong differently
+// every century. The index is the join, and `caelum` computes it.
+//
+// The join: `SIGNS[i]`, `SIGNA[i]` (engines/planet/planet.ts) and `ZODIACA[i]`
+// are one list three ways, so `ZODIACA[body.zodiac]` is always that body's
+// doctrine. The two name arrays live with the ephemeris because drawing the
+// wheel needs them without any of this; the meanings live here because nothing
+// in computing a position depends on them.
+//
+// Sources, per field:
+//   domicile    Ptolemy, Tetrabiblos I.17 [biblio: ptolemy-tetrabiblos],
+//               transmitted whole through the medieval Latin tradition and
+//               uncontested across sources.
+//   exaltation  Tetrabiblos I.19 and the standard medieval list, THE SEVEN
+//               PLANETS ONLY. The lunar nodes' exaltations (Caput Draconis in
+//               Gemini, Cauda in Sagittarius) are omitted because the nodes are
+//               not tonus bodies. The exaltation DEGREES (Sun at 19° Arietis
+//               and the rest) are omitted as more precision than any consumer
+//               here reads — five signs simply have no exaltation, and that
+//               absence is the tradition's, not an omission.
+//   element,    the Ptolemaic triplicities and quadruplicities. The Latin
+//   quality     quality terms are the scholastic mobile/fixum/commune, where
+//               Ptolemy writes tropic/solid/bicorporeal.
+//   humor       the Galenic element→humor square — fire/cholera, earth/
+//               melancholia, air/sanguis, water/phlegma — ubiquitous in
+//               medieval medicine.
+//   melothesia  the homo signorum of medieval calendars and medical
+//               manuscripts, Aries at the head down to Pisces at the feet (the
+//               Très Riches Heures anatomical man is the familiar picture).
+//               Practice, not decoration: phlebotomy was timed against it.
+//
+// Where the tradition wobbles, the entry says so in `variant` rather than
+// picking a winner quietly. Uncertainty is data.
+export const ZODIACA = [
+    {
+        index: 0, sign: "Aries", signum: "Aries", symbol: "♈",
+        element: "fire", elementum: "ignis",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Mars", exaltation: "Sun",
+        melothesia: { latin: "caput", english: "the head and face" },
+    },
+    {
+        index: 1, sign: "Taurus", signum: "Taurus", symbol: "♉",
+        element: "earth", elementum: "terra",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Venus", exaltation: "Moon",
+        melothesia: { latin: "collum", english: "the neck and throat" },
+    },
+    {
+        index: 2, sign: "Gemini", signum: "Gemini", symbol: "♊",
+        element: "air", elementum: "aer",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Mercury", exaltation: null,
+        melothesia: { latin: "umeri", english: "the shoulders, arms and hands" },
+    },
+    {
+        index: 3, sign: "Cancer", signum: "Cancer", symbol: "♋",
+        element: "water", elementum: "aqua",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Moon", exaltation: "Jupiter",
+        melothesia: { latin: "pectus", english: "the breast and chest" },
+        variant: "the melothesia wobbles here more than anywhere: some manuscripts "
+            + "extend Cancer to the lungs and stomach",
+    },
+    {
+        index: 4, sign: "Leo", signum: "Leo", symbol: "♌",
+        element: "fire", elementum: "ignis",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Sun", exaltation: null,
+        melothesia: { latin: "cor", english: "the heart, back and sides" },
+    },
+    {
+        index: 5, sign: "Virgo", signum: "Virgo", symbol: "♍",
+        element: "earth", elementum: "terra",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Mercury", exaltation: "Mercury",
+        melothesia: { latin: "venter", english: "the belly and bowels" },
+    },
+    {
+        index: 6, sign: "Libra", signum: "Libra", symbol: "♎",
+        element: "air", elementum: "aer",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Venus", exaltation: "Saturn",
+        melothesia: { latin: "renes", english: "the kidneys and loins" },
+    },
+    {
+        index: 7, sign: "Scorpio", signum: "Scorpius", symbol: "♏",
+        element: "water", elementum: "aqua",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Mars", exaltation: null,
+        melothesia: { latin: "genitalia", english: "the genitals" },
+    },
+    {
+        index: 8, sign: "Sagittarius", signum: "Sagittarius", symbol: "♐",
+        element: "fire", elementum: "ignis",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "calidum", moisture: "siccum" },
+        genus: "masculinum", humor: "cholera", temperament: "cholericum",
+        domicile: "Jupiter", exaltation: null,
+        melothesia: { latin: "femora", english: "the thighs" },
+    },
+    {
+        index: 9, sign: "Capricorn", signum: "Capricornus", symbol: "♑",
+        element: "earth", elementum: "terra",
+        quality: "cardinal", qualitas: "mobile",
+        nature: { heat: "frigidum", moisture: "siccum" },
+        genus: "femininum", humor: "melancholia", temperament: "melancholicum",
+        domicile: "Saturn", exaltation: "Mars",
+        melothesia: { latin: "genua", english: "the knees" },
+    },
+    {
+        index: 10, sign: "Aquarius", signum: "Aquarius", symbol: "♒",
+        element: "air", elementum: "aer",
+        quality: "fixed", qualitas: "fixum",
+        nature: { heat: "calidum", moisture: "humidum" },
+        genus: "masculinum", humor: "sanguis", temperament: "sanguineum",
+        domicile: "Saturn", exaltation: null,
+        melothesia: { latin: "crura", english: "the shins and ankles" },
+    },
+    {
+        index: 11, sign: "Pisces", signum: "Pisces", symbol: "♓",
+        element: "water", elementum: "aqua",
+        quality: "mutable", qualitas: "commune",
+        nature: { heat: "frigidum", moisture: "humidum" },
+        genus: "femininum", humor: "phlegma", temperament: "phlegmaticum",
+        domicile: "Jupiter", exaltation: "Venus",
+        melothesia: { latin: "pedes", english: "the feet" },
+    },
+];
+// THE LUNAR PROHIBITION, recorded here rather than exported: while the Moon
+// stands in a sign, that sign's member is not to be touched. It is the reason
+// the zodiac man is in a physician's calendar at all — it was "dangerous, if
+// not fatal, to treat that member if the Moon was in the sign at the time" —
+// and it is one line of doctrine that any consumer can state for itself from
+// `ZODIACA[moon.zodiac].melothesia`. A constant holding a sentence of English
+// would be prose pretending to be data.
+//# sourceMappingURL=zodiac.js.map

package/dist/engines/harmonia/tabula.d.ts

@@ -11,6 +11,9 @@ export interface HarmonyTabulaRow {
     oct: number;
     spn: string;
     hz: number;
+    /** The doctrina's ratio against the mese, [num, den] — what the sphere IS
+     *  in the scheme, of which spn and hz are the sounding. */
+    ratio: readonly [number, number];
     presence: number;
     motion: number;
     velocity: number;

package/dist/engines/harmonia/tabula.js

@@ -15,6 +15,7 @@ export function computeHarmonyTabula(bodies, aspects) {
         oct: b.nota.pitch.oct,
         spn: b.nota.pitch.spn,
         hz: b.nota.pitch.hz,
+        ratio: b.ratio,
         presence: b.presence,
         motion: b.motion,
         velocity: b.nota.performance.velocity,

package/dist/engines/harmonia/voice.d.ts

@@ -13,6 +13,10 @@ export interface VoicedBody extends Body {
     presence: number;
     motion: number;
     greekName: string;
+    /** The doctrina's own ratio for this sphere, [num, den] against the mese.
+     *  The pitch is DERIVED from it, so this is the primary datum and the note
+     *  name is the reading — a caller comparing doctrinae wants the fraction. */
+    ratio: readonly [number, number];
     vowel: PlanetVowel;
 }
 export declare function voiceBodies(bodies: Body[], doctrina: Doctrina, scale: Scale): VoicedBody[];

package/dist/engines/harmonia/voice.js

@@ -5,9 +5,8 @@ import { computePresence, computeMotion } from "./presence.js";
 // reference. Ratios in the doctrina are multiplied by this anchor to produce Hz.
 const ANCHOR_MIDI = 69;
 function voiceOne(body, voice, vowel, scale) {
-    const pliny = voice.greekName === "proslambanomenos" && body.name === "Earth";
-    const presence = pliny ? 1 : computePresence(body);
-    const motion = pliny ? 0 : computeMotion(body);
+    const presence = computePresence(body);
+    const motion = computeMotion(body);
     // Direct Hz from anchor (A4) and doctrina ratio — bypass scale quantization
     // so the ratio's pure Hz relationship is preserved.
     const ratioVal = voice.ratio[0] / voice.ratio[1];
@@ -28,6 +27,7 @@ function voiceOne(body, voice, vowel, scale) {
         presence,
         motion,
         greekName: voice.greekName,
+        ratio: voice.ratio,
         vowel,
     };
 }
@@ -41,9 +41,13 @@ export function voiceBodies(bodies, doctrina, scale) {
         const voice = voiceByBody.get(body.name);
         if (!voice)
             continue; // body not part of this doctrina (e.g. Earth in Boethius)
+        // Only the seven vowel-bearing planets voice. Earth stays silent even
+        // under Pliny, whose table assigns it proslambanomenos — the ratio is
+        // kept in the doctrina as documentation, but no classical vowel exists
+        // for Earth, and tonus does not invent one.
         const vowel = PLANET_VOWELS[body.name];
         if (!vowel)
-            continue; // body has no classical vowel mapping (e.g. Earth, FixedStars)
+            continue;
         result.push(voiceOne(body, voice, vowel, scale));
     }
     return result;

package/dist/engines/imprint.js

@@ -84,6 +84,10 @@ export function computeImprint(phrases, scale, opts = {}) {
     const cadenceNotes = opts.cadenceNotes;
     const pcCounts = new Array(12).fill(0);
     let total = 0;
+    // For the tessitura signal: the mean MIDI of every note, and the last note.
+    let midiSum = 0;
+    let noteCount = 0;
+    let lastNote = null;
     for (let pi = 0; pi < phrases.length; pi++) {
         const phrase = phrases[pi];
         for (let si = 0; si < phrase.syllables.length; si++) {
@@ -97,6 +101,9 @@ export function computeImprint(phrases, scale, opts = {}) {
                     w *= CADENCE_WEIGHT;
                 pcCounts[note.pitch.pc] += w;
                 total += w;
+                midiSum += note.pitch.midi;
+                noteCount++;
+                lastNote = { pc: note.pitch.pc, midi: note.pitch.midi };
             }
         }
     }
@@ -105,11 +112,17 @@ export function computeImprint(phrases, scale, opts = {}) {
         pcDistribution[pc] = total > 0 ? pcCounts[pc] / total : 0;
     }
     const firstNotePc = phrases[0]?.syllables[0]?.notes[0]?.pitch.pc;
+    // Tessitura = the melody's mean height above where it comes to rest.
+    const tessitura = lastNote && noteCount > 0 ? midiSum / noteCount - lastNote.midi : undefined;
     return {
         pcDistribution,
         attractors: computeAttractors(pcDistribution, scale),
         vowelAttractors: computeVowelAttractors(phrases, scale),
-        modalAffinity: computeModalAffinity(pcDistribution, firstNotePc),
+        modalAffinity: computeModalAffinity(pcDistribution, {
+            firstNotePc,
+            lastNotePc: lastNote?.pc,
+            tessitura,
+        }),
     };
 }
 /** Build an Imprint from voiced planetary bodies (presence-weighted pc counts). */

package/dist/engines/planet/orbital.js

@@ -34,7 +34,7 @@ export const ORBITAL_ELEMENTS = new Map([
             datasets: [
                 [
                     [0.72333566, 0.0000039],
-                    [0.00676399, -0.00005107],
+                    [0.00677672, -0.00004107],
                     [3.39467605, -0.0007889],
                     [181.9790995, 58517.81538729],
                     [131.60246718, 0.00268329],
@@ -42,7 +42,7 @@ export const ORBITAL_ELEMENTS = new Map([
                 ],
                 [
                     [0.72332102, -0.00000026],
-                    [-0.00005107, 0.01673163],
+                    [0.00676399, -0.00005107],
                     [3.39777545, 0.00043494],
                     [181.9797085, 58517.8156026],
                     [131.76755713, 0.05679648],
@@ -68,7 +68,7 @@ export const ORBITAL_ELEMENTS = new Map([
                     [0, 0],
                 ],
                 [
-                    [1.00000018, 1.52371243],
+                    [1.00000018, -0.00000003],
                     [0.01673163, -0.00003661],
                     [-0.00054346, -0.01337178],
                     [100.46691572, 35999.37306329],
@@ -129,7 +129,7 @@ export const ORBITAL_ELEMENTS = new Map([
                     [14.27495244, 0.18199196],
                     [100.29282654, 0.13024619],
                 ],
-                [0.00012452, 0.0606406, -0.35635438, 38.35125],
+                [-0.00012452, 0.0606406, -0.35635438, 38.35125],
             ],
             radius: 69911,
             rotation_period: 0.41354,

package/dist/engines/planet/planet.d.ts

@@ -1,4 +1,14 @@
 import type { Cosmos, CosmosQuery } from "./types.js";
+/** The twelve signs, in ecliptic order from the vernal point — the machine
+ * codes. Exported because a body's `sign` is one of these and a consumer
+ * drawing the zodiac needs the same twelve in the same order; copying them out
+ * is how a second, drifting list gets written. */
+export declare const SIGNS: readonly ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"];
+/** The same twelve as the books name them. Eight are already their own Latin
+ * nominative; the four that differ are the ones English clipped — Scorpius for
+ * Scorpio, and the -us/-i endings the others dropped. Parallel to a body's
+ * `name`/`nomen` pair: the code stays English, the Latin rides beside it. */
+export declare const SIGNA: readonly ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo", "Libra", "Scorpius", "Sagittarius", "Capricornus", "Aquarius", "Pisces"];
 /**
  * Ephemeris lookup (`tonus.caelum`). Computes geocentric and heliocentric
  * positions, zodiac signs, retrogradation, and aspects for the classical

package/dist/engines/planet/planet.js

@@ -10,12 +10,25 @@ import { latinName } from "./types.js";
 import { DEFAULT_EPOCH } from "../epoch.js";
 const MS_PER_DAY = 86400000;
 const ALL_BODIES = ["Sun", "Moon", "Mercury", "Venus", "Earth", "Mars", "Jupiter", "Saturn"];
-const SIGNS = [
+/** The twelve signs, in ecliptic order from the vernal point — the machine
+ * codes. Exported because a body's `sign` is one of these and a consumer
+ * drawing the zodiac needs the same twelve in the same order; copying them out
+ * is how a second, drifting list gets written. */
+export const SIGNS = [
     "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
     "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces",
 ];
+/** The same twelve as the books name them. Eight are already their own Latin
+ * nominative; the four that differ are the ones English clipped — Scorpius for
+ * Scorpio, and the -us/-i endings the others dropped. Parallel to a body's
+ * `name`/`nomen` pair: the code stays English, the Latin rides beside it. */
+export const SIGNA = [
+    "Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+    "Libra", "Scorpius", "Sagittarius", "Capricornus", "Aquarius", "Pisces",
+];
 const zodiac = (lon) => Math.floor(wrapAngle(lon) / 30) % 12;
 const sign = (lon) => SIGNS[zodiac(lon)];
+const signum = (lon) => SIGNA[zodiac(lon)];
 function computeSpeed(geoLon, name, ts) {
     const nextState = getState(ts + MS_PER_DAY);
     const nextSun = sunPos(nextState);
@@ -50,6 +63,7 @@ function buildSun(ts) {
         apparentDiameter: app.apparentDiameter,
         zodiac: zodiac(pos.geo.lon),
         sign: sign(pos.geo.lon),
+        signum: signum(pos.geo.lon),
     };
 }
 function buildMoon(ts) {
@@ -82,6 +96,7 @@ function buildMoon(ts) {
         apparentDiameter: app.apparentDiameter,
         zodiac: zodiac(pos.geo.lon),
         sign: sign(pos.geo.lon),
+        signum: signum(pos.geo.lon),
         distEarthRadii: pos.distEarthRadii,
     };
 }
@@ -115,8 +130,14 @@ function buildPlanet(name, ts) {
         elongation: app.elongation,
         phase: app.phase,
         apparentDiameter: app.apparentDiameter,
-        zodiac: zodiac(pos.helio.lon),
-        sign: sign(pos.helio.lon),
+        // GEOCENTRIC, as the Sun's and Moon's are: a sign placement says where a
+        // body appears from here, which is the only frame in which "Mars in
+        // Sagittarius" means anything. Reading the heliocentric longitude put a
+        // body's own sign at odds with its own geo.lon — Mercury reported in Aries
+        // while appearing in Taurus.
+        zodiac: zodiac(pos.geo.lon),
+        sign: sign(pos.geo.lon),
+        signum: signum(pos.geo.lon),
     };
 }
 function buildEarth(ts) {
@@ -142,6 +163,7 @@ function buildEarth(ts) {
         apparentDiameter: 0,
         zodiac: zodiac(pos.helio.lon),
         sign: sign(pos.helio.lon),
+        signum: signum(pos.helio.lon),
     };
 }
 const BODY_BUILDERS = {
@@ -192,7 +214,12 @@ export function getCosmos(query = {}) {
         }
         return frames;
     }
+    if (query.feast != null &&
+        (typeof query.feast !== "object" || !(query.feast.date instanceof Date)))
+        throw new Error("caelum: feast must be a Feast (from tonus.festum) — its date places the sky");
     const date = query.date ?? query.feast?.date ?? DEFAULT_EPOCH;
+    if (!(date instanceof Date) || Number.isNaN(date.getTime()))
+        throw new Error(`caelum: date must be a Date — e.g. new Date("2026-12-25") (UTC-canonical)`);
     return snapshotAt(date, requested, query.orbLimit);
 }
 //# sourceMappingURL=planet.js.map

package/dist/engines/planet/position.js

@@ -16,8 +16,8 @@
 // So the reader should not expect the same constants or solver across bodies.
 //
 // A few time-scale models here are standard astronomy but not yet catalogued in
-// BIBLIOGRAPHY.md (marked "source TBD" at each): the ΔT (TT−UT) polynomial and
-// the mean-obliquity expansion.
+// ../../../BIBLIOGRAPHY.md (marked "source TBD" at each): the ΔT (TT−UT)
+// polynomial and the mean-obliquity expansion.
 import { sinDeg, cosDeg, atan2Deg, kepler, wrapAngle, toAu, toCartesian, toSpherical, toEquatorial } from "./math.js";
 import { ORBITAL_ELEMENTS } from "./orbital.js";
 const MS_PER_DAY = 86400000;
@@ -157,18 +157,21 @@ export function planetPos(name, state, sun) {
         throw new Error(`Unknown body: ${name}`);
     const { J, T, eps } = state;
     const oe = body.datasets;
-    // Two Standish element sets per body (see orbital.ts): [1] is fitted tightly
-    // for 1800–2050, [0] trades accuracy for 3000 BC–3000 AD coverage. The bounds
-    // are J (days from J2000): −73048.5 ≈ 1800, 18626.5 ≈ 2050. Inside the window
-    // use the precise set, outside fall back to the long-range one.
-    const dataset = J > -73048.5 && J < 18626.5 ? oe[1] : oe[0];
+    // Two Standish element sets per body (see orbital.ts): [0] is Table 1, fitted
+    // tightly for 1800–2050; [1] is Table 2a, trading accuracy for 3000 BC–3000 AD
+    // coverage. The bounds are J (days from J2000): −73048.5 ≈ 1800, 18626.5 ≈
+    // 2050. Inside the window use the precise set, outside fall back to the
+    // long-range one — which is the set tonus's medieval epoch runs on.
+    const inWindow = J > -73048.5 && J < 18626.5;
+    const dataset = inWindow ? oe[0] : oe[1];
     const [a, e, I, L, wBar, Omega] = dataset.map(([x0, x1]) => x0 + x1 * T);
     const omega = wBar - Omega; // argument of periapsis
     let M = L - wBar; // mean anomaly
     // Standish's great-inequality correction for the outer planets (Jupiter–Neptune):
-    // a secular b·T² plus a long-period cos/sin term at frequency f. Only bodies
-    // that carry a datasets[2] (see orbital.ts) get it. [biblio: standish-jpl]
-    if (oe[2]) {
+    // a secular b·T² plus a long-period cos/sin term at frequency f. Table 2b is
+    // defined for use with the Table 2a elements only, so it applies exactly when
+    // the long-range set is in play. [biblio: standish-jpl]
+    if (!inWindow && oe[2]) {
         const [b, c, s, f] = oe[2];
         M += b * T * T + c * cosDeg(f * T) + s * sinDeg(f * T);
     }

package/dist/engines/planet/types.d.ts

@@ -33,6 +33,7 @@ export interface Body {
     };
     zodiac: number;
     sign: string;
+    signum: string;
     distEarthRadii?: number;
 }
 export interface Aspect {

package/dist/engines/score/api.d.ts

@@ -3,8 +3,6 @@ import { type Prosody } from "./prosody.js";
 import { type Cadence } from "./cadence.js";
 import { type Modulation } from "./modulation.js";
 import { type ChantTabulaRow } from "./tabula.js";
-import { type MidiOpts, type MidiEmitResult } from "./emitters/midi.js";
-import { type MusicXmlOpts, type MusicXmlEmitResult } from "./emitters/musicxml.js";
 import type { Chant } from "../chant/types.js";
 import type { Temperamentum } from "../temper/api.js";
 import type { ArticulationProfile, PhrasingProfile, ParseError, Phrase as IRPhrase } from "./types.js";
@@ -36,14 +34,6 @@ export interface Score {
     /** Passages where the tonal centre leans away from the home mode. */
     modulations: Modulation[];
     imprint: Imprint;
-    /**
-     * Emit a Standard MIDI File from the score's tabula. Returns the file bytes
-     * by default; `format: "json"` returns the event structure, `"both"` an
-     * object. The score's pondus/accentus reach the output via the tabula.
-     */
-    midi(opts?: MidiOpts): Uint8Array | MidiEmitResult;
-    /** Emit a MusicXML 4.0 partwise document from the score's tabula. */
-    musicxml(opts?: MusicXmlOpts): MusicXmlEmitResult;
 }
 /**
  * Score builder (`tonus.notatio`). Parses a chant's GABC into a musical
@@ -55,8 +45,7 @@ export interface Score {
  */
 export declare function buildScore(chant: Chant, opts?: ScoreOpts): Score;
 export type { ParseError };
-export type { Cadence, CadenceTarget, CadenceApproach } from "./cadence.js";
+export type { Cadence, CadenceTarget, CadenceApproach, CadenceKeyEvent } from "./cadence.js";
+export { cadenceKeys } from "./cadence.js";
 export type { Modulation } from "./modulation.js";
-export type { MidiOpts, MidiEmitResult, MidiJsonResult, MidiJsonEvent } from "./emitters/midi.js";
-export type { MusicXmlOpts, MusicXmlEmitResult } from "./emitters/musicxml.js";
 //# sourceMappingURL=api.d.ts.map

package/dist/engines/score/api.js

@@ -11,8 +11,7 @@ import { detectCadences } from "./cadence.js";
 import { detectModulations } from "./modulation.js";
 import { computeTabula } from "./tabula.js";
 import { MODES } from "../temper/modes.js";
-import { toMidi } from "./emitters/midi.js";
-import { toMusicXML } from "./emitters/musicxml.js";
+import { cadentiaFamilia } from "../../data/cadentiae.js";
 const PONDUS_TO_ARTICULATION = {
     restrained: "restrained",
     balanced: "balanced",
@@ -40,6 +39,8 @@ function resolveAccentus(input) {
  * @throws Error on invalid Chant input or unparseable GABC.
  */
 export function buildScore(chant, opts) {
+    if (!chant || typeof chant !== "object" || typeof chant.gabc !== "string")
+        throw new Error("notatio needs a Chant with a gabc string — build one with tonus.cantus({ gabc })");
     const pondus = resolvePondus(opts?.pondus);
     const accentus = resolveAccentus(opts?.accentus);
     const parsed = parseGABC(chant.gabc, {
@@ -62,10 +63,24 @@ export function buildScore(chant, opts) {
     // Cadence detection runs here, where the resolved mode (and its cadence
     // figures) is in hand. Pure data — mirrors the arsis/thesis pass in ir.ts.
     const cadences = detectCadences(ir.phrases, meta.mode != null ? MODES.get(meta.mode) : undefined);
+    // The corpus join, on the same footing as MODES above: a resolved table
+    // meeting detected data. The detector computes the signature and stops, so
+    // this is the one place a cadence learns how often its family closes.
+    // Below the catalogue's floor there is no family, and finality stays null —
+    // an uncatalogued close, not a close that never closes.
+    for (const cadence of cadences) {
+        cadence.finality = cadence.signature
+            ? (cadentiaFamilia(cadence.signature)?.finality ?? null)
+            : null;
+    }
     // Modulation: where the tonal centre leans away from the home mode.
     const modulations = detectModulations(ir.phrases, meta.mode ?? undefined);
     const tabula = computeTabula(ir, {
         mode: meta.mode ?? undefined,
+        // The office gate: a chant that names its liturgical type gets phrasing
+        // even when its mode must be inferred — the gate computeTabula always had,
+        // now actually fed.
+        office: chant.office,
         a4Hz: opts?.temperamentum?.a4,
         transpose: opts?.temperamentum?.transpose,
         cadences,
@@ -93,12 +108,10 @@ export function buildScore(chant, opts) {
                 return `${pi}:${si}:${ni}`;
             })),
         }),
-        midi(emitOpts) {
-            return toMidi(tabula, emitOpts);
-        },
-        musicxml(emitOpts) {
-            return toMusicXML(tabula, chant, emitOpts);
-        },
     };
 }
+// THE cadence family key, exported as a FUNCTION and not only a type: the
+// census and the CADENTIAE miner need to key a flat tabula, and re-deriving
+// the algorithm is exactly the fork this shared export forbids.
+export { cadenceKeys } from "./cadence.js";
 //# sourceMappingURL=api.js.map

package/dist/engines/score/articulation.js

@@ -3,8 +3,8 @@
 // ---------------------------------------------------------------------------
 // The pondus ("weight") tables. Each GABC performance mark — episema, quilisma,
 // liquescent, strophicus, oriscus, ictus — carries a weight delta and a
-// duration delta that the parser folds into a note's rhythmicShape (see the
-// tanh compressor in parse.ts). The signs encode the semiological reading of
+// duration delta that the parser folds into a note's weight and duration (see
+// the tanh compressor in parse.ts). The signs encode the semiological reading of
 // the mark [biblio: cardine-semiology], and the durational values the Solesmes
 // rhythmic tradition [biblio: desrocquettes-values, liber-usualis]: POSITIVE
 // lengthens/stresses, NEGATIVE lightens/shortens. So an episema lengthens

package/dist/engines/score/cadence.d.ts

@@ -28,7 +28,83 @@ export interface Cadence {
     confidence: number;
     /** Note positions forming this cadence: [phraseIndex, syllableIndex, noteIndex]. */
     notes: Array<[number, number, number]>;
+    /**
+     * The corpus-catalogue key, "shape @arrival" (e.g. "2,0,-2 @0" — see
+     * CADENTIAE). A single-note phrase keys with an empty shape (" @0"):
+     * a landing with no gesture is still a cadence.
+     */
+    signature: string | null;
+    /** Interval signature of the closing tail (<=4 notes), in semitones. */
+    shape: number[];
+    /** Closing note minus the CHANT'S OWN closing note (its sounded final —
+     *  not the labeled mode's final, which may disagree on a transposed or
+     *  mislabeled chant), in SIGNED semitones — not octave-reduced. */
+    arrival: number;
+    /**
+     * The catalogued family's measured finality: the share of THIS FAMILY's
+     * corpus occurrences that fall at a final close. null when the signature is
+     * below the catalogue's floor (about a third of cadences), and null on a
+     * cadence taken straight from `detectCadences` — the join happens in the
+     * score builder, not the detector.
+     *
+     * A measurement, not a name, which is why it rides here while `familia`
+     * does not: the signature is already the family's name, but how often that
+     * family CLOSES cannot be read off the signature. Families landing on the
+     * final range from 0.054 to 1.000, so `arrival === 0` does not imply a close.
+     */
+    finality: number | null;
 }
+/**
+ * Octave-reduce a semitone offset to [-5..+6].
+ *
+ * NOT part of the family key — kept because the folded value is still worth
+ * reporting (it is the scale DEGREE, mode-theoretically real). As a key the
+ * fold made a fifth ABOVE the final share a family with a fourth BELOW:
+ * measured over 27,985 phrase ends, 3,499 landed on @-5, of which 2,427 were
+ * really +7 and 1,072 really -5. Two opposite gestures, one key. Arrival in
+ * the key is therefore the SIGNED offset; see cadenceKeys().
+ */
+export declare function reduceArrival(semitones: number): number;
+/** One phrase-end event: the family key, and whether it closes the chant. */
+export interface CadenceKeyEvent {
+    /** `"<interval,interval,…> @<signed arrival>"` — empty shape for a 1-note phrase. */
+    key: string;
+    /** Shape only: the tail's successive semitone intervals. */
+    shape: number[];
+    /** Signed semitone offset of the landing note from the chant's closing note. */
+    arrival: number;
+    /** The arrival octave-reduced to [-5..+6] — the scale degree, not the key. */
+    degree: number;
+    /** A chant end, or a full-bar "::" — as opposed to an interior phrase end. */
+    isFinal: boolean;
+    /** Index of the phrase this closes. */
+    phraseIndex: number;
+}
+/**
+ * THE cadence family key — one implementation, shared by every consumer.
+ *
+ * This once existed three times: here (keyed off the Phrase tree), in
+ * tonus-corpus `census/_shared.mjs` (keyed off flat tabula rows), and in the
+ * CADENTIAE miner (a character-for-character copy of the census one). They
+ * agreed — measured corpus-wide, 28,051 engine cadences against 27,985 census
+ * phrase ends with ZERO key disagreements — but agreement by luck across three
+ * copies is what "no second parser, no drift" forbids; hence this one shared
+ * function.
+ *
+ * Takes the FLAT shape, because that is what the census and the miner have; the
+ * engine's own detection flattens into it. A phrase end is a `phraseIndex`
+ * transition or the last row.
+ *
+ * A ONE-NOTE PHRASE IS A CADENCE — it has a landing but no gesture, so it is
+ * emitted with an empty shape rather than skipped. (The census once dropped
+ * these — 68 corpus-wide, all real phrases carrying a real divisio, mostly
+ * "::" at the chant end — a hole this shared key closes.)
+ */
+export declare function cadenceKeys(rows: readonly {
+    phraseIndex: number;
+    midi: number;
+    divisio: string | null;
+}[], finalMidi?: number): CadenceKeyEvent[];
 /**
  * Detect the cadence closing each phrase. One Cadence per phrase that carries a
  * divisio. With no mode, targets/approach are still classified but no figure is