tonus 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,130 @@
 
 All notable changes to tonus. Newest first.
 
+## 0.10.0 — 2026-08-31
+
+The corpus stores a melody once instead of once per book, the genus labels say
+what GregoBase says, and the root index stops carrying the anatomy of its own
+return values.
+
+### Changed
+
+- **BREAKING: the Kyrie's ordinary code is `ke`, not `ky`.** GregoBase files
+  every ordinary chant under office-part `ky` = Kyriale, which is the roll-up
+  genus, so the Kyrie itself needed a code of its own. `cantus({ ordinary })`
+  and `ordinarium({ ordinary })` both take `ke` now, and `ORDINARIA` is keyed
+  by it. **A stale `"ky"` throws** rather than returning `[]` — an unknown
+  ordinary code is a malformed query, and this is the one most likely to
+  arrive stale, so the error names the replacement.
+- **BREAKING: three office genus labels were wrong and are corrected.** They
+  were read off the two-letter codes rather than off the source; GregoBase's
+  own vocabulary (`include/txt.php`, `$txt['usage']`) is now followed. `or` is
+  **Toni Communes** (it read "Ordinarium"), `tp` is **Tropa** (it read "Tonus
+  Peregrinus"), and `pa` is **Prosa**. `or` was the costly one: tonus stamped
+  an invented genus on a code the database already used for something else,
+  and 132 real Toni Communes chants were dropped at the extractor for want of
+  a mapping. Anything reading `chant.genus`, or filtering `office: "or"`
+  expecting the Mass ordinary, is affected — the ordinary is `ky` (genus) or
+  `ordinary` (part).
+- **Two office codes are new: `ky` and `va`.** `ky` is the Mass ordinary's
+  roll-up genus; `va` ("Varia") is the catch-all a chant falls to when its
+  office-part is unrecognised. It used to fall to `or`, which was harmless
+  while `or` was an invented label and is not now that it means a recitation
+  formula the census excludes.
+- **BREAKING: type-only names moved off the root entry.** Four subpath entries
+  now hold the grain the index was carrying — `tonus/corpus` (the shelf and its
+  vocabulary), `tonus/score` (what a `Score` is made of), `tonus/inscriptio`
+  (the drawing surface), `tonus/census` (one chant against the corpus). Verbs
+  stay on the root namespace, and the types a root signature names stay on the
+  root too. **Every value export the root carried is still exported from it**,
+  so nothing moved out of a JavaScript consumer's reach — though the code
+  renames above do reach one.
+- **A melody printed in several books is stored once.** It was stored once per
+  book. `books` now lists every printing and `pages` is keyed by book code, so
+  `cantus({ source })` presents a shared chant as the book asked for: that
+  book's source record and page numbers, not those of the file the record
+  happens to live in. 7840 chants, 9758 listings.
+
+### Added
+
+- **Four subpath entries surface types that were reachable but unnameable.**
+  `ChantSource`, `OfficeCode`, `OrdinaryCode`, `CanonicalHour`, `Theme`,
+  `ThemeColors`, `TrackName`, `TrackData`, and `CENSUS_BLOCK_FLOATS` — each a
+  value callers had to spell by hand against a query or an option bag.
+- **The two boundaries are gated instead of described.** `npm run gate` holds
+  the rendering boundary (only `inscriptio.ts` and the emitters may import from
+  `emitters/`) and the entry map (every `exports` subpath has a source module,
+  and every entry module is exported). Prose had already failed to hold the
+  rendering boundary once. It runs as part of `npm test`.
+
+### Removed
+
+- **`ams`, `cot`, and `cse` are no longer separate data files.** Their contents
+  were listings on records the other books already own, and are now reachable
+  through `books`/`pages` on those records.
+
+## 0.9.1 — 2026-08-24
+
+Moderna reads the pitch it was given: the whole page had been sitting a sixth
+too high, and a transposed chant said nothing about its own accidentals.
+
+### Fixed
+
+- **Moderna drew every note a sixth above where it belonged.** `writtenY`
+  measured the note against a reference term that had not been normalised the
+  same way (`4 * 7` against a note term carrying `+2`), so sounding E4 computed
+  as 14 staff steps instead of 0. Every note of every moderna score sat above
+  the top line. The port was faithful — the same expression is in the locked
+  reference generator, which was fed pitches an octave below today's corpus, so
+  two errors cancelled; when the corpus moved to true octaves only one of them
+  moved. The clef's octave lift is now stated once, explicitly.
+- **A transposed chromatic rendered as a silent wrong pitch.** `temperamentum`'s
+  `transpose` moves what a chant sounds, and moderna reads sounding pitch — but
+  the accidental was parsed and discarded, so `Ab3` and `A3` landed on one slot
+  with no sign drawn. The page read a semitone off with nothing to say so.
+  Spelling now follows `spn`: flats stay flats, sharps stay sharps. Signs
+  written in the GABC are unaffected — `computeAccidentals` remains
+  authoritative wherever it has an opinion, keyed on the degree a sign alters
+  rather than the row that carries it.
+- **Moderna had no ledger lines at all.** A note outside the five rendered as a
+  head floating in blank space. One line per staff line the note has passed,
+  drawn behind the head: the spaces immediately outside (steps 9 and −1) get
+  none, and a line-note and the space above it share one.
+- **`midiToGabc` threw on every B-flat** — the one accidental chant sings, and
+  the whole reason `parse.ts` carries a flat state machine. It now spells it
+  `ix`, and `gabcToMidi` reads that back, so the two stay inverses. Other
+  chromatic pitch classes still throw. Verified over 222 round-trips.
+- **The GABC clef tables disagreed about which clefs exist.** `temper/gabc.ts`
+  knew six (`c1`–`c4`, `f3`, `f4`) while `parse.ts` accepted sixteen, so a
+  `cb2` the parser reads happily raised "Unknown clef". `CLEFS` is now derived
+  rather than hand-listed; all six original entries are reproduced exactly.
+
+### Changed
+
+- **A low moderna chant is written an octave up.** One clef throughout — what
+  floats is the written octave, the move the hand already makes when it lifts a
+  chant onto the gamut's fingers. Chant sounds below this staff (corpus median
+  50–62 against a window of 52–65), and transposing down pushes it further: at
+  −4 an unlifted score put 43.6% of all notes under the bottom line, now 9.8%.
+  Untransposed moderna output moves for most chants as a result, always toward
+  the staff (7.8% off-staff to 5.8%). Whole octaves only, and one lift for the
+  whole chant — a page that changed register partway would read as two pieces.
+  The limit is honest: an ambitus straddling the window cannot be aligned by
+  any multiple of 12, and 59 of 200 measured chants are wider than the staff.
+  `notatio`'s `spn` remains the authority on what actually sounds.
+- **Quadrata is untouched by all of this**, by construction: it draws from
+  staff position, which transposition does not move. Verified byte-identical.
+
+### Packaging
+
+- `.npmignore` removed — it contradicted the `files` allowlist, and two
+  mechanisms deciding what ships is one more than can be reasoned about.
+  Measured before and after: the tarball is byte-identical at 216 files.
+- `"sideEffects": false` declared, and verified true — nothing in `dist/` runs
+  at module scope and no data file is read at import time.
+- The description no longer claims "and performance"; the voice lives in
+  tonus-sonus.
+
 ## 0.9.0 — 2026-08-19
 
 The tracks stop promising a contract they never kept, and the geometry says

package/README.md

@@ -8,7 +8,7 @@ belong to which day and returns analysis and notation, and calculates the
 _music of the spheres_ proposed by Pythagoras, Boethius, and more as real
 intervals.
 
-**[Orreliquum — the library at work →](https://jeffreypierce.github.io/orreliquum/)**
+**[Interactive demo](https://orreliquum.com/)**
 
 Everything is computed locally and deterministically: the same question always
 returns the same answer, from data that ships inside the package, with no network
@@ -72,8 +72,8 @@ its final, dominant, ambitus, and ethos, with its psalm tones.
 **The calendar** is Tridentine, resolved against Easter by
 the Julian or the Gregorian computus.
 
-**The repertoire** is 2,187 chants across ten books — nine Solesmes editions and
-the _Nocturnale Romanum_ night office — in
+**The repertoire** is 7,840 chants across seven books, six Solesmes editions and
+the _Nocturnale Romanum_ night office in
 [GABC](https://gregorio-project.github.io/) notation: Mass propers, the Kyriale,
 the Office hours, the psalter, and the Matins nocturns.
 

package/dist/census.d.ts

@@ -0,0 +1,4 @@
+export { getCensus as census } from "./engines/census/census.js";
+export type { Census, CensusQuery, CensusBy, CensusGroup, CensusGroupProfile, CensusNeighbor, } from "./engines/census/types.js";
+export { CENSUS_GROUPS, CENSUS_ORDER, CENSUS_BLOCK_FLOATS, } from "./data/census.js";
+//# sourceMappingURL=census.d.ts.map

package/dist/census.js

@@ -0,0 +1,23 @@
+// ---------------------------------------------------------------------------
+// tonus/census — one chant measured against the corpus that holds it
+// ---------------------------------------------------------------------------
+// The analysis boundary, made addressable. The library never RUNS a census; it
+// CITES one. Everything here reads a baked table — the blocks the corpus
+// pipeline emits — and does arithmetic over it. No mining lives behind this
+// entry and none may be added: a threshold calibrated across many chants is the
+// corpus repo's business, and re-enters as generated data with provenance.
+//
+// Year-shaped questions ("this season," "this manuscript," a window of the
+// calendar) are not here and do not belong here. `data/census.ts` states the
+// same rule from the data side: this is the only census artifact in the
+// package, and the corpus repo's other outputs stay there. Pooling blocks is
+// the caller's to do, under the rule census.md fixes — cosine per field group,
+// never over the flat 221.
+//
+// CENSUS_BLOCK_FLOATS joins the two constants the root already exported. A
+// caller decoding a block had to know the stride and could get it only by
+// counting CENSUS_GROUPS, which is the transcription the appendix rule exists
+// to prevent.
+export { getCensus as census } from "./engines/census/census.js";
+export { CENSUS_GROUPS, CENSUS_ORDER, CENSUS_BLOCK_FLOATS, } from "./data/census.js";
+//# sourceMappingURL=census.js.map

package/dist/corpus.d.ts

@@ -0,0 +1,4 @@
+export { getChants as cantus, getCorpus as corpus, SOURCES } from "./engines/chant/chant.js";
+export { HORAE, OFFICIA, ORDINARIA, MODI } from "./engines/chant/types.js";
+export type { Chant, OrdinaryChant, CantusQuery, CorpusQuery, Corpus, CorpusLedger, CorpusFullCount, GenusCount, ModeCount, SharedCount, ChantSource, OfficeCode, OrdinaryCode, CanonicalHour, } from "./engines/chant/types.js";
+//# sourceMappingURL=corpus.d.ts.map

package/dist/corpus.js

@@ -0,0 +1,17 @@
+// ---------------------------------------------------------------------------
+// tonus/corpus — the shelf: what tonus holds, and how to ask for it
+// ---------------------------------------------------------------------------
+// The repertoire and its vocabulary, separated from the calendar that resolves
+// a DAY. `cantus` and `corpus` ask what is on the shelf; `festum`, `proprium`
+// and `officium` ask what a day calls for. The two questions have been one
+// import since the beginning, which is part of why the shelf reads as though it
+// were a property of the calendar.
+//
+// This entry surfaces four types the root index never exported, each of them a
+// value a caller otherwise had to TYPE OUT against a query: ChantSource (the
+// book codes `cantus({ source })` accepts), OfficeCode and OrdinaryCode (the
+// genus and ordinary codes), and CanonicalHour (what HORAE holds). The appendix
+// rule already admits the tables; the types they range over belong beside them.
+export { getChants as cantus, getCorpus as corpus, SOURCES } from "./engines/chant/chant.js";
+export { HORAE, OFFICIA, ORDINARIA, MODI } from "./engines/chant/types.js";
+//# sourceMappingURL=corpus.js.map