tonus 0.1.6 → 0.1.8

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

@@ -1,4 +1,10 @@
-import type { Chant, CantusQuery } from "./types.js";
+import type { Chant, CantusQuery, ChantSource, Corpus } from "./types.js";
+/**
+ * Metadata and content breakdown for one corpus book (`tonus.corpus`). Pass a
+ * source code; get the book's bibliographic identity plus its genre and mode
+ * distributions. Computed on first access from the loaded corpus, then cached.
+ */
+export declare function getCorpus(code: ChantSource): Corpus;
 export declare function resolveChant(id: string | null): Chant | null;
 export declare function resolveChants(ids: string[]): Chant[];
 /**

package/dist/engines/chant/chant.js

@@ -1,9 +1,11 @@
 import { OFFICE_LABELS, MODE_LABELS } from "./types.js";
+import { CORPUS_OVERLAP } from "../../data/corpus-overlap.js";
 import { GR_DATA, GR_SOURCE } from "../../data/gr.js";
 import { LU_DATA, LU_SOURCE } from "../../data/lu.js";
 import { LA_DATA, LA_SOURCE } from "../../data/la.js";
 import { LH_DATA, LH_SOURCE } from "../../data/lh.js";
 import { AM_DATA, AM_SOURCE } from "../../data/am.js";
+import { NR_DATA, NR_SOURCE } from "../../data/nocturnale-romanum.js";
 function modusOf(mode) {
     return mode != null ? (MODE_LABELS[mode] ?? null) : null;
 }
@@ -65,6 +67,7 @@ const CORPUS = [
     ...LA_DATA.map((c) => withLabels(c, LA_SOURCE)),
     ...LH_DATA.map((c) => withLabels(c, LH_SOURCE)),
     ...AM_DATA.map((c) => withLabels(c, AM_SOURCE)),
+    ...NR_DATA.map((c) => withLabels(c, NR_SOURCE)),
 ];
 let _byId = null;
 function byId() {
@@ -72,6 +75,73 @@ function byId() {
         _byId = new Map(CORPUS.map((c) => [c.id, c]));
     return _byId;
 }
+const SOURCES = {
+    gr: GR_SOURCE, lu: LU_SOURCE, la: LA_SOURCE, lh: LH_SOURCE, am: AM_SOURCE, nr: NR_SOURCE,
+};
+// Tally a book's genre and mode distribution — computed once per code, cached.
+const _corpusCache = new Map();
+/**
+ * Metadata and content breakdown for one corpus book (`tonus.corpus`). Pass a
+ * source code; get the book's bibliographic identity plus its genre and mode
+ * distributions. Computed on first access from the loaded corpus, then cached.
+ */
+export function getCorpus(code) {
+    const cached = _corpusCache.get(code);
+    if (cached)
+        return cached;
+    const src = SOURCES[code];
+    if (!src)
+        throw new Error(`Unknown corpus code: "${code}" (expected gr, lu, la, lh, or am)`);
+    const chants = CORPUS.filter((c) => c.source.code === code);
+    // Genre distribution — count by office code, descending by count.
+    const officeCounts = new Map();
+    // Mode distribution — count by mode 1–8; everything else (p/d/e, null) into one bucket.
+    const modeCounts = new Map();
+    let otherModes = 0;
+    for (const c of chants) {
+        officeCounts.set(c.office, (officeCounts.get(c.office) ?? 0) + 1);
+        if (c.mode != null && MODE_LABELS[c.mode]) {
+            modeCounts.set(c.mode, (modeCounts.get(c.mode) ?? 0) + 1);
+        }
+        else {
+            otherModes++;
+        }
+    }
+    const genera = [...officeCounts.entries()]
+        .map(([office, count]) => ({ office, genus: OFFICE_LABELS[office] ?? office, count }))
+        .sort((a, b) => b.count - a.count);
+    const modes = [];
+    for (const m of ["1", "2", "3", "4", "5", "6", "7", "8"]) {
+        const count = modeCounts.get(m);
+        if (count)
+            modes.push({ mode: m, modus: MODE_LABELS[m], count });
+    }
+    if (otherModes > 0)
+        modes.push({ mode: null, modus: null, count: otherModes });
+    // Pre-dedup relationships (precomputed in tonus-corpus — tonus can't derive
+    // them, since it stores only one copy of each shared chant).
+    const ov = CORPUS_OVERLAP[code];
+    const shared = Object.entries(ov?.shared ?? {})
+        .map(([c, count]) => ({ code: c, count }))
+        .sort((a, b) => b.count - a.count);
+    const result = {
+        code,
+        book: src.book,
+        fullTitle: src.fullTitle ?? null,
+        edition: src.edition ?? null,
+        year: src.year,
+        editor: src.editor,
+        scanSource: src.scanSource ?? null,
+        count: chants.length,
+        total: ov?.total ?? chants.length,
+        unique: ov?.unique ?? chants.length,
+        shared,
+        genera,
+        modes,
+    };
+    _corpusCache.set(code, result);
+    return result;
+}
 function toArray(v) {
     if (v === undefined)
         return undefined;

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

@@ -0,0 +1,33 @@
+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

@@ -0,0 +1,81 @@
+// ---------------------------------------------------------------------------
+// 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/chant/types.d.ts

@@ -2,7 +2,7 @@ import type { Season, Grade, Feast } from "../cal/types.js";
 export type { Season, Grade, Feast };
 export type OfficeCode = "an" | "al" | "ca" | "co" | "gr" | "hy" | "in" | "of" | "ps" | "re" | "rb" | "se" | "tr" | "tp" | "or";
 export type OrdinaryCode = "ky" | "gl" | "cr" | "sa" | "ag" | "be" | "it" | "as" | "va";
-export type ChantSource = "gr" | "lu" | "la" | "lh" | "am";
+export type ChantSource = "gr" | "lu" | "la" | "lh" | "am" | "nr";
 export type CanonicalHour = "matutinum" | "laudes" | "prima" | "tertia" | "sexta" | "nona" | "vesperae" | "completorium";
 export declare const MODE_LABELS: Readonly<Record<string, string>>;
 export declare const OFFICE_LABELS: Readonly<Record<OfficeCode, string>>;
@@ -22,8 +22,11 @@ export interface Chant {
     }[];
     source: {
         book: string;
+        fullTitle?: string | null;
+        edition?: string | null;
         year: number | null;
         editor: string | null;
+        scanSource?: string | null;
         code?: ChantSource | "user";
     };
     ordinary?: OrdinaryCode;
@@ -35,6 +38,35 @@ export interface OrdinaryChant extends Chant {
     ordinarium: string;
     mass: number;
 }
+export interface GenusCount {
+    office: OfficeCode;
+    genus: string;
+    count: number;
+}
+export interface ModeCount {
+    mode: string | null;
+    modus: string | null;
+    count: number;
+}
+export interface SharedCount {
+    code: ChantSource;
+    count: number;
+}
+export interface Corpus {
+    code: ChantSource;
+    book: string;
+    fullTitle: string | null;
+    edition: string | null;
+    year: number | null;
+    editor: string | null;
+    scanSource: string | null;
+    count: number;
+    total: number;
+    unique: number;
+    shared: SharedCount[];
+    genera: GenusCount[];
+    modes: ModeCount[];
+}
 export interface CantusQuery {
     id?: string | string[];
     gabc?: string;

package/dist/index.d.ts

@@ -1,15 +1,17 @@
 import { getFeast, getPascha } from "./engines/cal/calendar.js";
-import { getChants } from "./engines/chant/chant.js";
+import { getChants, getCorpus } from "./engines/chant/chant.js";
 import { getPropers } from "./engines/chant/propers.js";
 import { getOrdinary } from "./engines/chant/ordinary.js";
 import { getHour } from "./engines/chant/hour.js";
+import { getMatins } from "./engines/chant/matutinum.js";
 import { getPsalm } from "./engines/chant/psalm.js";
 import { buildTemper } from "./engines/temper/api.js";
 import { buildScore } from "./engines/score/api.js";
 import { getCosmos } from "./engines/planet/planet.js";
 import { buildHarmonia } from "./engines/harmonia/api.js";
 import type { FeastQuery, Feast, Pascha, Season, Grade } from "./engines/cal/types.js";
-import type { CantusQuery, Chant, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Rite } from "./engines/chant/types.js";
+import type { CantusQuery, Chant, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Rite, Corpus, GenusCount, ModeCount, SharedCount } from "./engines/chant/types.js";
+import type { Matins, Nocturn } from "./engines/chant/matutinum.js";
 import type { TemperamentumInput, Temperamentum, Tuning, TemperamentumOpts, Pitch, PitchInput, Step, Neume, NeumeShape, Interval, ModeData, CadenceFigure, Modus, TunedNote, GamutOptions, Tonus, TonusOpts } from "./engines/temper/api.js";
 import type { Score, ScoreOpts, PondusInput, PondusOpts, AccentusInput, AccentusOpts, Cadence, CadenceTarget, CadenceApproach, Modulation, MidiOpts, MidiEmitResult, MidiJsonResult, MidiJsonEvent, MusicXmlOpts, MusicXmlEmitResult } from "./engines/score/api.js";
 import type { ChantTabulaRow } from "./engines/score/tabula.js";
@@ -25,9 +27,11 @@ declare const tonus: {
     festum: typeof getFeast;
     pascha: typeof getPascha;
     cantus: typeof getChants;
+    corpus: typeof getCorpus;
     proprium: typeof getPropers;
     ordinarium: typeof getOrdinary;
     officium: typeof getHour;
+    matutinum: typeof getMatins;
     psalmus: typeof getPsalm;
     temperamentum: typeof buildTemper;
     notatio: typeof buildScore;
@@ -36,5 +40,5 @@ declare const tonus: {
 };
 export default tonus;
 export { SEASON_LABELS, TEMPUS_NAMES, GRADE_ORDER, GRADE_NAMES, gradeOrder, compareGrade, ritusToGrade, } from "./engines/cal/types.js";
-export type { Feast, FeastQuery, Pascha, Season, Grade, Chant, CantusQuery, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Rite, Temperamentum, TemperamentumInput, TemperamentumOpts, Tuning, Pitch, PitchInput, Step, Neume, NeumeShape, Interval, ModeData, CadenceFigure, Modus, TunedNote, GamutOptions, Tonus, TonusOpts, Score, ScoreOpts, PondusInput, PondusOpts, AccentusInput, AccentusOpts, Cadence, CadenceTarget, CadenceApproach, Modulation, MidiOpts, MidiEmitResult, MidiJsonResult, MidiJsonEvent, MusicXmlOpts, MusicXmlEmitResult, ChantTabulaRow, Note, Performance, Phrase, Syllable, RestEvent, ParseError, ArsisThesis, RhythmicType, CompoundBeat, VoicedPitch, Cosmos, CosmosQuery, Body, BodyName, Aspect, Imprint, Attractor, VowelAttractor, ModalAffinity, Prosody, RhythmicProfile, NoteRange, CadenceDistribution, Harmony, HarmoniaOpts, VoicedBody, VoicedAspect, Frame, Author, HarmonyTabulaRow, PlanetVowel, };
+export type { Feast, FeastQuery, Pascha, Season, Grade, Chant, CantusQuery, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Rite, Corpus, GenusCount, ModeCount, SharedCount, Matins, Nocturn, Temperamentum, TemperamentumInput, TemperamentumOpts, Tuning, Pitch, PitchInput, Step, Neume, NeumeShape, Interval, ModeData, CadenceFigure, Modus, TunedNote, GamutOptions, Tonus, TonusOpts, Score, ScoreOpts, PondusInput, PondusOpts, AccentusInput, AccentusOpts, Cadence, CadenceTarget, CadenceApproach, Modulation, MidiOpts, MidiEmitResult, MidiJsonResult, MidiJsonEvent, MusicXmlOpts, MusicXmlEmitResult, ChantTabulaRow, Note, Performance, Phrase, Syllable, RestEvent, ParseError, ArsisThesis, RhythmicType, CompoundBeat, VoicedPitch, Cosmos, CosmosQuery, Body, BodyName, Aspect, Imprint, Attractor, VowelAttractor, ModalAffinity, Prosody, RhythmicProfile, NoteRange, CadenceDistribution, Harmony, HarmoniaOpts, VoicedBody, VoicedAspect, Frame, Author, HarmonyTabulaRow, PlanetVowel, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,8 +1,9 @@
 import { getFeast, getPascha } from "./engines/cal/calendar.js";
-import { getChants } from "./engines/chant/chant.js";
+import { getChants, getCorpus } from "./engines/chant/chant.js";
 import { getPropers } from "./engines/chant/propers.js";
 import { getOrdinary } from "./engines/chant/ordinary.js";
 import { getHour } from "./engines/chant/hour.js";
+import { getMatins } from "./engines/chant/matutinum.js";
 import { getPsalm } from "./engines/chant/psalm.js";
 import { buildTemper } from "./engines/temper/api.js";
 import { buildScore } from "./engines/score/api.js";
@@ -12,9 +13,11 @@ const tonus = {
     festum: getFeast,
     pascha: getPascha,
     cantus: getChants,
+    corpus: getCorpus,
     proprium: getPropers,
     ordinarium: getOrdinary,
     officium: getHour,
+    matutinum: getMatins,
     psalmus: getPsalm,
     temperamentum: buildTemper,
     notatio: buildScore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonus",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "description": "Medieval music analysis and performance: GABC plainchant exports, liturgical calendar, tuning systems, ephemeris, and the harmony of the spheres",