tonus 0.1.8 → 0.5.0

package/dist/engines/chant/matutinum.d.ts

@@ -1,33 +0,0 @@
-import type { Chant, OfficiumQuery } from "./types.js";
-/** One nocturn of a resolved Matins: its responsories (and any antiphons). */
-export interface Nocturn {
-    /** 1–3. */
-    n: number;
-    /** The nocturn's great responsories, in order, as resolved chants. */
-    responsories: Chant[];
-    /** The nocturn's antiphons, where the Nocturnale carries them (else empty). */
-    antiphons: Chant[];
-}
-/** A feast's structured Roman Matins. */
-export interface Matins {
-    /** The tonus feast id this Matins was resolved for. */
-    feastId: string;
-    /** The feast's Latin name from the Nocturnale. */
-    name: string;
-    /** The rank/class, e.g. "I. classis", "Feria". */
-    rank: string;
-    /** One nocturn (simple) or three (festal). */
-    nocturns: Nocturn[];
-    /** The feast whose chants were borrowed by rubric, if any (provenance). */
-    redirectedFrom: string | null;
-}
-/**
- * Structured Roman Matins (`tonus.matutinum`) for a feast: the nocturns with
- * their responsories (and antiphons where present), assembled from the
- * Nocturnale Romanum. Without a feast, resolves the default epoch's feast (as
- * `officium` does). Only the Roman rite is served today; other rites return
- * null (the monastic night office is not yet modelled — see office-matins-roman).
- * @returns the Matins structure, or null when no Nocturnale match exists.
- */
-export declare function getMatins(query?: OfficiumQuery): Matins | null;
-//# sourceMappingURL=matutinum.d.ts.map

package/dist/engines/chant/matutinum.js

@@ -1,81 +0,0 @@
-// ---------------------------------------------------------------------------
-// engines/chant/matutinum — structured Roman Matins (nocturns)
-// ---------------------------------------------------------------------------
-// The flat `officium({ hora: "matutinum" })` returns Matins chants as an
-// undifferentiated Chant[] (the best-effort flat view, unchanged). This module
-// adds the STRUCTURED night office for the Roman rite: the 3-nocturn assembly
-// from the Nocturnale Romanum, joined to the tonus calendar by feast id.
-//
-// It is additive and separate — a distinct accessor (`tonus.matutinum`), not a
-// reshape of getHour — so the flat path and every other rite stay as they are.
-// Coverage is what the Nocturnale + the calendar bridge give: the sanctorale and
-// Advent today (see office-matins-roman.ts). A feast with no Nocturnale match
-// returns null, the office's graceful-degradation convention.
-import { resolveChant } from "./chant.js";
-import { getFeast } from "../cal/calendar.js";
-import { temporaSundayId } from "../cal/date.js";
-import { MATINS_ROMAN } from "../../data/office-matins-roman.js";
-let _byFeast = null;
-function byFeast() {
-    if (!_byFeast) {
-        _byFeast = new Map();
-        for (const d of MATINS_ROMAN)
-            if (d.tonusFeastId)
-                _byFeast.set(d.tonusFeastId, d);
-    }
-    return _byFeast;
-}
-function resolveDay(day) {
-    const nocturns = day.nocturns.map((noc) => {
-        const responsories = [];
-        const antiphons = [];
-        for (const c of noc.chants) {
-            const chant = resolveChant(c.id);
-            if (!chant)
-                continue;
-            if (c.type === "A")
-                antiphons.push(chant);
-            else
-                responsories.push(chant); // R (and I invitatory) resolve as responsories
-        }
-        return { n: noc.n, responsories, antiphons };
-    });
-    return {
-        feastId: day.tonusFeastId,
-        name: day.name,
-        rank: day.rank,
-        nocturns,
-        redirectedFrom: day.redirectedFrom,
-    };
-}
-/** The Nocturnale Matins for a feast id, or null when the calendar has no match. */
-function matinsForFeastId(feastId) {
-    const map = byFeast();
-    const day = map.get(feastId) ?? (() => {
-        // Temporal feasts resolve their Sunday where a weekday has no proper.
-        const sunday = temporaSundayId(feastId);
-        return sunday ? map.get(sunday) : undefined;
-    })();
-    return day ? resolveDay(day) : null;
-}
-/**
- * Structured Roman Matins (`tonus.matutinum`) for a feast: the nocturns with
- * their responsories (and antiphons where present), assembled from the
- * Nocturnale Romanum. Without a feast, resolves the default epoch's feast (as
- * `officium` does). Only the Roman rite is served today; other rites return
- * null (the monastic night office is not yet modelled — see office-matins-roman).
- * @returns the Matins structure, or null when no Nocturnale match exists.
- */
-export function getMatins(query) {
-    const rite = query?.rite ?? "romanum";
-    if (rite !== "romanum")
-        return null;
-    const feasts = query?.feast
-        ? Array.isArray(query.feast) ? query.feast : [query.feast]
-        : null;
-    const feast = feasts ? feasts[0] : getFeast()[0];
-    if (!feast)
-        return null;
-    return matinsForFeastId(feast.id);
-}
-//# sourceMappingURL=matutinum.js.map

package/dist/engines/score/emitters/midi.d.ts

@@ -1,65 +0,0 @@
-import type { ChantTabulaRow } from "../tabula.js";
-/** Lightweight diagnostic record. */
-interface Diagnostic {
-    code?: string;
-    message: string;
-}
-export interface MidiOpts {
-    /** "file" (default) → Uint8Array; "json" → event structure; "both" → object. */
-    format?: "file" | "json" | "both";
-    ppq?: number;
-    tempoBpm?: number;
-    channel?: number;
-    /** Fallback 0–127 velocity when a row has no phrasing velocity. */
-    velocity?: number;
-    includeMeta?: boolean;
-    trackName?: string;
-    emitPitchBend?: boolean;
-    transpose?: number;
-}
-export type MidiJsonEvent = {
-    type: "noteOn";
-    tick: number;
-    pitch: number;
-    velocity: number;
-    channel: number;
-    hz?: number;
-} | {
-    type: "noteOff";
-    tick: number;
-    pitch: number;
-    velocity: number;
-    channel: number;
-} | {
-    type: "pitchBend";
-    tick: number;
-    channel: number;
-    value14: number;
-} | {
-    type: "meta";
-    tick: number;
-    metaType: "tempo" | "trackName";
-    value: number | string;
-};
-export interface MidiJsonTrack {
-    name?: string;
-    events: MidiJsonEvent[];
-}
-export interface MidiJsonResult {
-    ppq: number;
-    tempoBpm: number;
-    tracks: MidiJsonTrack[];
-    diagnostics: Diagnostic[];
-}
-export interface MidiEmitResult {
-    json?: MidiJsonResult;
-    bytes?: Uint8Array;
-}
-/**
- * Emit a Standard MIDI File from a score's tabula rows. Returns the file bytes
- * (`Uint8Array`) by default; `format: "json"` returns the event structure and
- * `"both"` returns `{ json, bytes }`.
- */
-export declare function toMidi(rows: ChantTabulaRow[], options?: MidiOpts): Uint8Array | MidiEmitResult;
-export {};
-//# sourceMappingURL=midi.d.ts.map

package/dist/engines/score/emitters/midi.js

@@ -1,162 +0,0 @@
-// Divisio → rest duration (in the same beat units as note durations); a phrase's
-// terminal divisio becomes a rest of this length. This is the *durational*
-// reading of the divisio hierarchy (canonical table in docs/score.md), distinct
-// from prosody.ts's analytic weights and phrasing.ts's shaping strengths — three
-// readings of the same bar-lines, each for its own purpose. Values mirror
-// DIVISIO_DURATIONS in parse.ts (the source of the fractional beat lengths).
-const DIVISIO_REST = {
-    ",": 0.54, "`": 0.33, ";": 0.8, ":": 1.1, "::": 1.8,
-};
-const DEFAULT_PPQ = 480;
-const DEFAULT_TEMPO = 120;
-const DEFAULT_CHANNEL = 0;
-const DEFAULT_VELOCITY = 80;
-const PITCH_BEND_CENTER = 8192;
-function resolveOpts(options) {
-    return {
-        format: options.format ?? "file",
-        ppq: options.ppq ?? DEFAULT_PPQ,
-        tempoBpm: options.tempoBpm ?? DEFAULT_TEMPO,
-        channel: options.channel ?? DEFAULT_CHANNEL,
-        velocity: options.velocity ?? DEFAULT_VELOCITY,
-        includeMeta: options.includeMeta ?? true,
-        trackName: options.trackName ?? "tonus",
-        emitPitchBend: options.emitPitchBend ?? true,
-        transpose: options.transpose ?? 0,
-    };
-}
-function encodeVarLen(value) {
-    let val = Math.max(0, value | 0);
-    const bytes = [val & 0x7f];
-    while ((val >>= 7) > 0)
-        bytes.unshift((val & 0x7f) | 0x80);
-    return bytes;
-}
-function writeUInt32BE(value) {
-    return [(value >>> 24) & 0xff, (value >>> 16) & 0xff, (value >>> 8) & 0xff, value & 0xff];
-}
-function writeUInt16BE(value) {
-    return [(value >>> 8) & 0xff, value & 0xff];
-}
-function eventPriority(event) {
-    if (event.type === "meta")
-        return 0;
-    if (event.type === "pitchBend")
-        return 1;
-    if (event.type === "noteOff")
-        return 2;
-    return 3;
-}
-function clampToMidiPitch(step, diagnostics) {
-    if (step < 0 || step > 127) {
-        diagnostics.push({
-            code: "MIDI_PITCH_CLAMPED",
-            message: `Pitch ${step} clamped to MIDI range 0..127`,
-        });
-    }
-    return Math.min(127, Math.max(0, step));
-}
-function buildJson(rows, opts, diagnostics) {
-    const events = [];
-    let tick = 0;
-    if (opts.includeMeta) {
-        events.push({ type: "meta", tick: 0, metaType: "tempo", value: opts.tempoBpm });
-        events.push({ type: "meta", tick: 0, metaType: "trackName", value: opts.trackName });
-    }
-    let prevPhrase = null;
-    for (const row of rows) {
-        // A phrase boundary inserts the previous phrase's terminal divisio as a rest.
-        if (prevPhrase !== null && row.phraseIndex !== prevPhrase) {
-            const restDivisio = rows.find((r) => r.phraseIndex === prevPhrase)?.divisio ?? null;
-            const restBeats = restDivisio ? (DIVISIO_REST[restDivisio] ?? 0) : 0;
-            tick += Math.max(0, Math.round(restBeats * opts.ppq));
-        }
-        prevPhrase = row.phraseIndex;
-        const pitch = clampToMidiPitch(row.midi + opts.transpose, diagnostics);
-        const durationTicks = Math.max(1, Math.round(row.shapedDuration * opts.ppq));
-        const velocity = row.velocity != null && row.velocity > 0
-            ? Math.round(row.velocity * 127)
-            : opts.velocity;
-        const bends = opts.emitPitchBend && Math.abs(row.bend - PITCH_BEND_CENTER) > 1;
-        if (bends) {
-            events.push({ type: "pitchBend", tick, channel: opts.channel, value14: row.bend });
-        }
-        events.push({ type: "noteOn", tick, pitch, velocity, channel: opts.channel, hz: row.hz });
-        events.push({ type: "noteOff", tick: tick + durationTicks, pitch, velocity: 0, channel: opts.channel });
-        if (bends) {
-            events.push({ type: "pitchBend", tick: tick + durationTicks, channel: opts.channel, value14: PITCH_BEND_CENTER });
-        }
-        tick += durationTicks;
-    }
-    events.sort((a, b) => a.tick - b.tick || eventPriority(a) - eventPriority(b));
-    return {
-        ppq: opts.ppq,
-        tempoBpm: opts.tempoBpm,
-        tracks: [{ name: opts.trackName, events }],
-        diagnostics,
-    };
-}
-function buildMidiBytes(json) {
-    const trackEvents = json.tracks[0]?.events ?? [];
-    const trackData = [];
-    let lastTick = 0;
-    for (const event of trackEvents) {
-        const delta = Math.max(0, event.tick - lastTick);
-        lastTick = event.tick;
-        trackData.push(...encodeVarLen(delta));
-        if (event.type === "meta") {
-            if (event.metaType === "tempo") {
-                const mpqn = Math.max(1, Math.round(60000000 / Number(event.value)));
-                trackData.push(0xff, 0x51, 0x03, (mpqn >>> 16) & 0xff, (mpqn >>> 8) & 0xff, mpqn & 0xff);
-            }
-            else if (event.metaType === "trackName") {
-                const textBytes = Array.from(new TextEncoder().encode(String(event.value)));
-                trackData.push(0xff, 0x03, ...encodeVarLen(textBytes.length), ...textBytes);
-            }
-            continue;
-        }
-        if (event.type === "pitchBend") {
-            const lsb = event.value14 & 0x7f;
-            const msb = (event.value14 >> 7) & 0x7f;
-            trackData.push(0xe0 | (event.channel & 0x0f), lsb, msb);
-            continue;
-        }
-        if (event.type === "noteOn") {
-            trackData.push(0x90 | (event.channel & 0x0f), event.pitch & 0x7f, event.velocity & 0x7f);
-        }
-        else {
-            trackData.push(0x80 | (event.channel & 0x0f), event.pitch & 0x7f, event.velocity & 0x7f);
-        }
-    }
-    // End-of-track meta event
-    trackData.push(0x00, 0xff, 0x2f, 0x00);
-    const headerChunk = [
-        0x4d, 0x54, 0x68, 0x64, // "MThd"
-        ...writeUInt32BE(6), // chunk length
-        ...writeUInt16BE(0), // format 0
-        ...writeUInt16BE(1), // 1 track
-        ...writeUInt16BE(json.ppq),
-    ];
-    const trackChunk = [
-        0x4d, 0x54, 0x72, 0x6b, // "MTrk"
-        ...writeUInt32BE(trackData.length),
-        ...trackData,
-    ];
-    return Uint8Array.from([...headerChunk, ...trackChunk]);
-}
-/**
- * Emit a Standard MIDI File from a score's tabula rows. Returns the file bytes
- * (`Uint8Array`) by default; `format: "json"` returns the event structure and
- * `"both"` returns `{ json, bytes }`.
- */
-export function toMidi(rows, options = {}) {
-    const opts = resolveOpts(options);
-    const diagnostics = [];
-    const json = buildJson(rows, opts, diagnostics);
-    if (opts.format === "file")
-        return buildMidiBytes(json);
-    if (opts.format === "json")
-        return { json };
-    return { json, bytes: buildMidiBytes(json) };
-}
-//# sourceMappingURL=midi.js.map

package/dist/engines/score/emitters/musicxml.d.ts

@@ -1,18 +0,0 @@
-import type { ChantTabulaRow } from "../tabula.js";
-import type { Chant } from "../../chant/types.js";
-export interface MusicXmlOpts {
-    /** Emit the arsis/thesis shape + index as an other-notation annotation. */
-    emitWeights?: boolean;
-}
-export interface MusicXmlEmitResult {
-    xml: string;
-    diagnostics: {
-        message: string;
-    }[];
-}
-/**
- * Emit a MusicXML 4.0 partwise document from a score's tabula rows plus the
- * source chant (for titling). Returns `{ xml, diagnostics }`.
- */
-export declare function toMusicXML(rows: ChantTabulaRow[], chant: Chant, options?: MusicXmlOpts): MusicXmlEmitResult;
-//# sourceMappingURL=musicxml.d.ts.map

package/dist/engines/score/emitters/musicxml.js

@@ -1,166 +0,0 @@
-// ── XML helpers ──
-function xmlEscape(s) {
-    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
-        .replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-}
-function elem(tag, content) {
-    return `<${tag}>${content}</${tag}>`;
-}
-// ── Pitch / accidental from a tabula row ──
-function xmlStep(row) {
-    // spn is e.g. "D4", "Bb3" — the first character is the step letter.
-    return row.spn[0] ?? "C";
-}
-function xmlAccidentalGlyph(row) {
-    // Only an explicitly-marked accidental prints a glyph.
-    if (row.accidentalSource !== "explicit")
-        return null;
-    if (row.accidental === -1)
-        return "flat";
-    if (row.accidental === 1)
-        return "sharp";
-    return "natural";
-}
-const BARLINE_STYLE = {
-    ",": "dashed", "`": "dotted", ";": "normal", ":": "light-light", "::": "light-heavy",
-};
-function computeSyllabic(lyric) {
-    const s = lyric.startsWith("-"), e = lyric.endsWith("-");
-    if (!s && !e)
-        return "single";
-    if (!s && e)
-        return "begin";
-    if (s && e)
-        return "middle";
-    return "end";
-}
-function renderNote(row, flags, ctx) {
-    const lines = [`      <note>`];
-    lines.push(`        <pitch>`);
-    lines.push(`          ${elem("step", xmlStep(row))}`);
-    if (row.accidental !== 0)
-        lines.push(`          ${elem("alter", String(row.accidental))}`);
-    lines.push(`          ${elem("octave", String(row.octave))}`);
-    lines.push(`        </pitch>`);
-    lines.push(`        ${elem("duration", "4")}`);
-    lines.push(`        ${elem("type", "eighth")}`);
-    const glyph = xmlAccidentalGlyph(row);
-    if (glyph)
-        lines.push(`        ${elem("accidental", glyph)}`);
-    if (row.quilisma)
-        lines.push(`        ${elem("notehead", "diamond")}`);
-    const notations = [];
-    // Slurs bind a single neume figure (pes, clivis, torculus …), so a syllable
-    // built of several figures shows one arc per figure.
-    if (flags.slurStart)
-        notations.push(`          <slur type="start" number="1"/>`);
-    if (flags.slurStop)
-        notations.push(`          <slur type="stop" number="1"/>`);
-    if (row.ictus) {
-        notations.push(`          <articulations>`, `            <accent/>`, `          </articulations>`);
-    }
-    const technical = [];
-    if (row.quilisma)
-        technical.push(`            <other-technical>quilisma</other-technical>`);
-    if (row.liquescent)
-        technical.push(`            <other-technical>liquescent</other-technical>`);
-    if (row.strophicus)
-        technical.push(`            <other-technical>strophicus</other-technical>`);
-    if (technical.length) {
-        notations.push(`          <technical>`, ...technical, `          </technical>`);
-    }
-    if (flags.syllableStart && row.neume.type !== "punctum") {
-        notations.push(`          <other-notation type="start">${xmlEscape(row.neume.type)}</other-notation>`);
-    }
-    if (ctx.emitWeights) {
-        notations.push(`          <other-notation type="start">shape:${row.rhythmicShape} index:${row.rhythmicIndex}</other-notation>`);
-    }
-    if (notations.length) {
-        lines.push(`        <notations>`, ...notations, `        </notations>`);
-    }
-    if (flags.syllableStart) {
-        const syllabic = computeSyllabic(row.lyric);
-        const clean = row.lyric.replace(/^-+/, "").replace(/-+$/, "").trim();
-        lines.push(`        <lyric number="1">`, `          ${elem("syllabic", syllabic)}`, `          ${elem("text", xmlEscape(clean))}`, `        </lyric>`);
-    }
-    lines.push(`      </note>`);
-    return lines.join("\n");
-}
-function renderMeasure(rows, measureNumber, isFirst, ctx) {
-    const lines = [`    <measure number="${measureNumber}">`];
-    if (isFirst) {
-        lines.push(`      <attributes>`, `        ${elem("divisions", "8")}`, `        <key>`, `          ${elem("fifths", "0")}`, `        </key>`, `        <time symbol="cut">`, `          ${elem("beats", "4")}`, `          ${elem("beat-type", "4")}`, `        </time>`, `        <clef>`, `          ${elem("sign", "G")}`, `          ${elem("line", "2")}`, `        </clef>`, `      </attributes>`);
-    }
-    // Walk the phrase's rows. The lyric attaches at each syllable start; slurs
-    // bind each neume figure (a syllable may hold several), so they are grouped
-    // by (syllableIndex, neumeGroup) and only drawn when a figure has >1 note.
-    const sameFigure = (a, b) => a.syllableIndex === b.syllableIndex && a.neumeGroup === b.neumeGroup;
-    for (let k = 0; k < rows.length; k++) {
-        const row = rows[k];
-        const prev = rows[k - 1];
-        const next = rows[k + 1];
-        const figureStart = !prev || !sameFigure(prev, row);
-        const figureEnd = !next || !sameFigure(next, row);
-        const figureIsMulti = !(figureStart && figureEnd); // >1 note in this figure
-        const syllableStart = !prev || prev.syllableIndex !== row.syllableIndex;
-        lines.push(renderNote(row, {
-            slurStart: figureIsMulti && figureStart,
-            slurStop: figureIsMulti && figureEnd,
-            syllableStart,
-        }, ctx));
-    }
-    const divisio = rows[rows.length - 1]?.divisio ?? "::";
-    const style = BARLINE_STYLE[divisio] ?? "normal";
-    lines.push(`      <barline location="right">`, `        <bar-style>${style}</bar-style>`, `      </barline>`);
-    lines.push(`    </measure>`);
-    return lines.join("\n");
-}
-function renderScore(rows, chant, ctx) {
-    const parts = [
-        `<?xml version="1.0" encoding="UTF-8"?>`,
-        `<!DOCTYPE score-partwise PUBLIC "-//Recordare//DTD MusicXML 4.0 Partwise//EN"`,
-        `  "http://www.musicxml.org/dtds/partwise.dtd">`,
-        `<score-partwise version="4.0">`,
-    ];
-    if (chant.incipit) {
-        parts.push(`  <work>`, `    ${elem("work-title", xmlEscape(chant.incipit))}`, `  </work>`);
-    }
-    parts.push(`  <identification>`);
-    parts.push(`    <encoding>`);
-    parts.push(`      ${elem("software", "tonus")}`, `    </encoding>`, `  </identification>`);
-    for (const text of [
-        chant.mode ? `Mode ${chant.mode}` : null,
-        chant.office,
-    ]) {
-        if (text)
-            parts.push(`  <credit page="1">`, `    ${elem("credit-words", xmlEscape(text))}`, `  </credit>`);
-    }
-    // Group rows into measures by phrase index.
-    const measures = [];
-    let i = 0;
-    let measureNumber = 1;
-    while (i < rows.length) {
-        const phraseIndex = rows[i].phraseIndex;
-        let j = i;
-        while (j < rows.length && rows[j].phraseIndex === phraseIndex)
-            j++;
-        measures.push(renderMeasure(rows.slice(i, j), measureNumber, measureNumber === 1, ctx));
-        measureNumber++;
-        i = j;
-    }
-    parts.push(`  <part-list>`, `    <score-part id="P1">`, `      ${elem("part-name", "Chant")}`, `    </score-part>`, `  </part-list>`, `  <part id="P1">`, ...measures, `  </part>`, `</score-partwise>`);
-    return parts.join("\n");
-}
-/**
- * Emit a MusicXML 4.0 partwise document from a score's tabula rows plus the
- * source chant (for titling). Returns `{ xml, diagnostics }`.
- */
-export function toMusicXML(rows, chant, options = {}) {
-    const diagnostics = [];
-    const ctx = { emitWeights: options.emitWeights ?? false };
-    const xml = rows.length
-        ? renderScore(rows, chant, ctx)
-        : renderScore([], chant, ctx);
-    return { xml, diagnostics };
-}
-//# sourceMappingURL=musicxml.js.map