tonus 0.8.0 → 0.9.1

package/dist/engines/temper/gabc.js

@@ -18,26 +18,52 @@ const LETTERS = "abcdefghijklm";
 // A higher c-clef (c4 vs c1) moves "do" up the staff, so the same letter reads a
 // lower pitch — hence doIdx climbs 3→5→7→9 across c1→c4. The f-clefs anchor on
 // fa (MIDI 53) and are used for lower-tessitura chant.
-const CLEFS = {
-    c1: { doMidi: 60, doIdx: 3 },
-    c2: { doMidi: 60, doIdx: 5 },
-    c3: { doMidi: 60, doIdx: 7 },
-    c4: { doMidi: 60, doIdx: 9 },
-    // f-clefs anchor fa on the named line. Staff lines (bottom→top) sit at
-    // letters d/f/h/j (per the Gregorio spec: 2-line staff = a–i, 3-line = a–k,
-    // 4-line = a–m, pinning the lines at slots 3/5/7/9), so f3 puts fa at 'h'
-    // (7) and f4 at 'j' (9). Previous values (5 and 3) were off by a third and
-    // read every f-clef chant at the wrong staff position.
-    f3: { doMidi: 53, doIdx: 7 },
-    f4: { doMidi: 53, doIdx: 9 },
-};
+// The staff-line slots the clefs anchor to, low to high: letters d/f/h/j per
+// the Gregorio spec (2-line staff = a–i, 3-line = a–k, 4-line = a–m).
+const LINE_SLOTS = [3, 5, 7, 9];
+// Every clef GABC can declare, built from the same two rules rather than listed
+// by hand: a c-clef puts "do" (MIDI 60) on its named line, an f-clef puts "fa"
+// (MIDI 53) there. cN/fN for N in 1–4, plus the `b` variants (cbN/fbN) that
+// additionally declare a B-flat key signature.
+//
+// This table used to hold six entries — c1–c4, f3, f4 — while `parse.ts`'s
+// CLEF_OFFSETS held all sixteen. Two tables disagreeing about what a clef is,
+// with the smaller one throwing "Unknown clef" on inputs the parser accepts
+// happily. Deriving them removes the chance of a third disagreement.
+const CLEFS = {};
+for (let n = 1; n <= 4; n++) {
+    const doIdx = LINE_SLOTS[n - 1];
+    // An f-clef names fa's line, and fa is the 4th diatonic step (index 3), so
+    // "do" sits three slots below the named line — which is what doMidi 53
+    // (the F below middle C) is measured from.
+    CLEFS[`c${n}`] = { doMidi: 60, doIdx };
+    CLEFS[`cb${n}`] = { doMidi: 60, doIdx };
+    CLEFS[`f${n}`] = { doMidi: 53, doIdx };
+    CLEFS[`fb${n}`] = { doMidi: 53, doIdx };
+}
+/**
+ * The GABC letter for a MIDI pitch under `clef` — with `x` appended when the
+ * pitch is a B-flat (`jx`, the flat sign then the note).
+ *
+ * B-flat is the ONE accidental chant sings — the b molle of the medieval gamut,
+ * the whole reason `parse.ts` carries a flat state machine and the `b` clefs
+ * exist. This function used to throw "is not diatonic" on it, which made the
+ * apparent inverse of `gabcToMidi` unable to spell a pitch the parser reads on
+ * every other page. Every other chromatic pitch class still throws: those are
+ * outside the gamut, and inventing a spelling for them would be a worse answer
+ * than refusing.
+ */
 export function midiToGabc(midi, clef = "c4") {
     const def = CLEFS[clef];
     if (!def)
         throw new Error(`Unknown clef: ${clef}`);
-    const octave = Math.floor(midi / 12) - 1;
     const pc = midi % 12;
-    const diatIdx = DIATONIC.indexOf(pc);
+    // A flat is spelled on the staff slot of the natural ABOVE it: B-flat takes
+    // B's line with an `x`. Resolve to that natural, then mark the result.
+    const flat = pc === 10;
+    const natural = flat ? midi + 1 : midi;
+    const octave = Math.floor(natural / 12) - 1;
+    const diatIdx = DIATONIC.indexOf(natural % 12);
     if (diatIdx === -1)
         throw new Error(`MIDI note ${midi} (pc ${pc}) is not diatonic`);
     const doOctave = Math.floor(def.doMidi / 12) - 1;
@@ -45,13 +71,19 @@ export function midiToGabc(midi, clef = "c4") {
     const letter = LETTERS[staffPos];
     if (!letter)
         throw new Error(`MIDI ${midi} out of GABC range for clef ${clef}`);
-    return letter;
+    return flat ? `${letter}x` : letter;
 }
 export function gabcToMidi(letter, clef = "c4") {
     const def = CLEFS[clef];
     if (!def)
         throw new Error(`Unknown clef: ${clef}`);
-    const staffPos = LETTERS.indexOf(letter.toLowerCase());
+    // Accept the `x` that `midiToGabc` emits, so the two stay inverses. A flat
+    // lowers the natural it marks by a semitone; only B carries one in the gamut,
+    // but the arithmetic is written once for whatever letter arrives.
+    const raw = letter.toLowerCase();
+    const flat = raw.endsWith("x");
+    const bare = flat ? raw.slice(0, -1) : raw;
+    const staffPos = LETTERS.indexOf(bare);
     if (staffPos === -1)
         throw new Error(`Unknown GABC letter: ${letter}`);
     // Diatonic steps from "do", split into whole octaves (÷7) and the step within
@@ -61,7 +93,8 @@ export function gabcToMidi(letter, clef = "c4") {
     const octOffset = Math.floor(stepsFromDo / 7);
     const diatStep = ((stepsFromDo % 7) + 7) % 7;
     const doOctave = Math.floor(def.doMidi / 12) - 1;
-    return (doOctave + octOffset + 1) * 12 + DIATONIC[diatStep];
+    const natural = (doOctave + octOffset + 1) * 12 + DIATONIC[diatStep];
+    return flat ? natural - 1 : natural;
 }
 export function pcToGabc(pc, clef = "c4", oct = 0) {
     const def = CLEFS[clef];

package/dist/engines/temper/neume.d.ts

@@ -2,7 +2,7 @@ import type { Interval } from "./interval.js";
 import type { Pitch, PitchInput } from "./pitch.js";
 import type { Scale } from "./scale.js";
 export type { Interval };
-export type NeumeShape = "punctum" | "pes" | "clivis" | "torculus" | "porrectus" | "scandicus" | "salicus" | "climacus" | "torculus resupinus" | "porrectus flexus" | "scandicus flexus" | "climacus resupinus" | "pes subpunctis" | "compound";
+export type NeumeShape = "punctum" | "pes" | "clivis" | "torculus" | "porrectus" | "scandicus" | "salicus" | "climacus" | "torculus resupinus" | "porrectus flexus" | "scandicus flexus" | "climacus resupinus" | "pes subpunctis" | "distropha" | "tristropha" | "tristropha flexa" | "pressus" | "pressus maior" | "scandicus subpunctis" | "compound";
 export interface Neume {
     pitches: Pitch[];
     intervals: Interval[];

package/dist/engines/temper/neume.js

@@ -9,9 +9,12 @@ export function classifyShape(dirs) {
         return "punctum";
     const up = (d) => d === "up";
     const dn = (d) => d === "down";
+    const un = (d) => d === "unison";
     switch (n) {
         case 1:
-            return up(dirs[0]) ? "pes" : dn(dirs[0]) ? "clivis" : "punctum";
+            // A unison here is two notes on one pitch — a distropha, not a punctum.
+            // Reporting "punctum" said a two-note figure was one note.
+            return up(dirs[0]) ? "pes" : dn(dirs[0]) ? "clivis" : "distropha";
         case 2: {
             const [d0, d1] = dirs;
             if (up(d0) && dn(d1))
@@ -22,6 +25,10 @@ export function classifyShape(dirs) {
                 return "scandicus";
             if (dn(d0) && dn(d1))
                 return "climacus";
+            if (un(d0) && un(d1))
+                return "tristropha";
+            if (un(d0) && dn(d1))
+                return "pressus";
             return "compound";
         }
         case 3: {
@@ -36,12 +43,26 @@ export function classifyShape(dirs) {
                 return "climacus resupinus";
             if (up(d0) && dn(d1) && dn(d2))
                 return "pes subpunctis";
+            if (un(d0) && un(d1) && dn(d2))
+                return "tristropha flexa";
+            if (dn(d0) && un(d1) && dn(d2))
+                return "pressus maior";
             return "compound";
         }
-        default:
-            if (up(dirs[0]) && dirs.slice(1).every((d) => dn(d)))
+        default: {
+            // The long forms: a head, then an unbroken descent. Only the head
+            // distinguishes them, and the descent must be total — a figure that
+            // turns again is a compound melisma, which at this length most are.
+            if (up(dirs[0]) && dirs.slice(1).every(dn))
                 return "pes subpunctis";
+            if (up(dirs[0]) && up(dirs[1]) && dirs.slice(2).every(dn)) {
+                return "scandicus subpunctis";
+            }
+            if (dirs.slice(0, -1).every(un) && dn(dirs[dirs.length - 1])) {
+                return "tristropha flexa";
+            }
             return "compound";
+        }
     }
 }
 export function buildNeume(inputs, scala) {

package/docs/api/calendar.md

@@ -108,7 +108,7 @@ The feast returned **carries the view** (`feast.before`), and every chant
 verb reads it back: `proprium`, `ordinarium`, and `officium`
 serve only chants attested by the same year, without being told the year
 twice. One `before` at the calendar door views the whole day. The chant side
-— what "attested" means, and what a slot the view excludes does — is in
+(what "attested" means, and what a slot the view excludes does) is in
 [chant.md](chant.md#the-repertoire-as-of-a-date--the-era-view).
 
 ```ts
@@ -142,12 +142,12 @@ interface Feast {
 }
 ```
 
-The `masses` list is derived from the Kyriale's own printed rubric — one
+The `masses` list is derived from the Kyriale's own printed rubric, one
 category per mass, by RANK: "In Paschal Time", "For feasts of the I class",
 "For Sundays throughout the Year", "For ferias". A day resolves to exactly
 one rubric (a BVM feast is "of the Blessed Virgin" even in Paschaltide),
 and the masses carrying that rubric are the masses it may sing, in the
-book's own numbering — where a rubric names several (II class 1–5), that
+book's own numbering. Where a rubric names several (II class 1–5), that
 numbering is the book's invitation to choose, and `ordinarium` rotates
 among them by year. The book's per-mass nicknames (_Orbis factor_ for
 Sundays, and so on) record customary use, which disagrees with the rubric for 9
@@ -211,7 +211,7 @@ derived from the date; overflow entries, such as the Epiphany weeks
 resumed before Septuagesima, take the season of the day they fall on.
 
 Season drives real liturgy in the ordinary: in the penitential seasons
-(`adv`, `quadp`, `quad`) the Gloria is omitted, and the Ite with it — the
+(`adv`, `quadp`, `quad`) the Gloria is omitted, and the Ite with it. The
 Benedicamus dismissal appears only where the selected mass carries a
 setting ([chant.md](chant.md#the-ordinary--ordinarium)).
 

package/docs/api/census.md

@@ -20,7 +20,7 @@ is, where it is unusual, and what it is near.
 tonus.census({ id: "gregobase:1210" });
 ```
 
-Everything comes back in one call — profile, balance, neighbors:
+Everything comes back in one call: profile, balance, neighbors.
 
 ```js
 {
@@ -56,7 +56,7 @@ interface CensusQuery {
 }
 ```
 
-The census covers the **2,187 chants tonus ships** — the same population
+The census covers the **2,187 chants tonus ships**, the same population
 `cantus({ id })` addresses, one block per chant. An id with no block throws
 rather than returning an empty answer, because a silent nothing reads as "this
 chant is unlike everything," which is a different claim.
@@ -78,24 +78,24 @@ what they describe:
 | `textual`       |      7 | vowel distribution by sung duration, accent rate, melisma mean                    |
 
 Four more fields ride in the block and are **not** similarity dimensions:
-`flags` (a bitfield), `attest` (dating — that is what `before` reads),
+`flags` (a bitfield), `attest` (dating, which is what `before` reads),
 `extras`, and `reserve`. `by` will not accept them.
 
 ## How the measurement works
 
-Every number in a block reads off a single `notatio()` parse — the same parse
-`score` gives you — so the census can never disagree with the library about
+Every number in a block reads off a single `notatio()` parse (the same parse
+`score` gives you), so the census can never disagree with the library about
 what a chant is.
 
 Each float is a named measurement, not a learned one: time spent on the
 subfinal, how often a rising second follows a falling third. When the census
 calls two chants near, the profile says in what respect.
 
-Most groups are normalized to sum to one, so a group holds a distribution —
-where the melody's time goes, not how much of it there is; length is not a
+Most groups are normalized to sum to one, so a group holds a distribution:
+where the melody's time goes, not how much of it there is. Length is not a
 similarity. The trigram and cadence groups count against dictionaries mined
-from the corpus itself — its commonest motifs, its commonest closing gestures,
-one bucket for the rest — so the corpus supplies the vocabulary and the chant
+from the corpus itself (its commonest motifs, its commonest closing gestures,
+one bucket for the rest), so the corpus supplies the vocabulary and the chant
 supplies the usage.
 
 The reference is the mean block over all 2,187 chants, group by group. Because
@@ -105,15 +105,15 @@ divided by their count, are the season's mean profile in the same 221 slots.
 ## Distance is cosine per field group
 
 **This is a contract, not an implementation note.** The census answers about
-one chant at a time; grouping — "all Communions," "this season," "this
-manuscript" — is yours to do. The moment you pool blocks yourself you are
+one chant at a time. Grouping ("all Communions," "this season," "this
+manuscript") is yours to do. The moment you pool blocks yourself you are
 computing a distance, and if you compute it differently from the rule below
 your numbers will not agree with `census()`'s. Nothing will error.
 
 The rule, in three lines:
 
 1. Cosine **per field group**, never over the flat 221.
-2. `by: "all"` is the **equal-weight mean** of the per-group cosines — every
+2. `by: "all"` is the **equal-weight mean** of the per-group cosines: every
    dimension one vote, no tunable weights.
 3. Ties break to the lower id, so the same question always has the same answer.
 
@@ -122,7 +122,7 @@ sheer magnitude, so a long Tract would neighbor other long chants for being
 long. Per-group cosine asks about **shape within each dimension**.
 
 [`CENSUS_GROUPS`](index.md#the-appendix) gives you the group names and their
-field counts, and [`CENSUS_ORDER`](index.md#the-appendix) every censused id —
+field counts, and [`CENSUS_ORDER`](index.md#the-appendix) every censused id,
 so you can pool a set without guessing at either.
 
 ### Reading the numbers
@@ -140,7 +140,7 @@ per-group version spreads from about 0.85 down to 0.65. That compression comes
 from one wide block outvoting the other eight.
 
 **`before` filters before ranking.** It restricts the candidate pool, then
-ranks — so `k` stays satisfiable, and a filtered list is *not* a subset of the
+ranks, so `k` stays satisfiable, and a filtered list is *not* a subset of the
 unfiltered one. Chants that were ranked out by later material rise into it.
 Typicality is unaffected: it is always measured against the whole shipped
 corpus (see [Profile and typicality](#profile-and-typicality)).
@@ -201,7 +201,7 @@ const ranked = ids
 
 The per-group breakdown is where the answer becomes legible. _Quinque
 prudentes_ leads on `textual`, `cadenceMedial` and `trigram`, at about 0.99 on
-each — it sets its text and turns its phrases the way Communions do — while its
+each (it sets its text and turns its phrases the way Communions do), while its
 `cadenceFinal` is only about 0.82, so the one thing it does unlike a typical
 Communion is end. A chant is typical of its genus in some dimensions and not
 others.
@@ -213,8 +213,8 @@ Each group's `typicality` is its cosine against the corpus mean for that group:
 "unlike the rest."
 
 The two numbers above are a fair illustration. _Ab occultis meis_ is a mode-2
-Gradual whose `modal` typicality is about 0.99 — modally it is a typical
-mode-2 chant — while its `melodic` typicality is about 0.70, because its
+Gradual whose `modal` typicality is about 0.99, so modally it is a typical
+mode-2 chant. Its `melodic` typicality is about 0.70, because its
 interval
 vocabulary is its own. One chant can be conventional in one dimension and
 distinctive in another, which is the reason the groups are kept apart.
@@ -233,7 +233,7 @@ balance: { distance: 0.091, deviantGroups: ["degreeHist", "melodic"] }
 the corpus mean, 1 has nothing in common with it.
 
 `deviantGroups` names where a chant is unusual **relative to its own mean**,
-most deviant first — not against an absolute threshold. The question it answers
+most deviant first, not against an absolute threshold. The question it answers
 is "given how typical this chant is overall, where does it depart from
 itself?", which is what makes the answer legible for a chant that is unusual
 everywhere or nowhere.
@@ -273,12 +273,12 @@ tonus.census({ id: "gregobase:1210", before: 1100 });
 ```
 
 Restricts neighbors to chants a manuscript of the 11th century or earlier
-already holds — 1,790 of the 2,186 candidates. This is the same rule as
+already holds, 1,790 of the 2,186 candidates. This is the same rule as
 [`cantus({ before })`](chant.md#the-repertoire-as-of-a-date--the-era-view),
 through the same admissibility door: **evidence, not existence**, so a chant
 with no dated witness is excluded rather than assumed old.
 
-The seed chant itself is never filtered — you asked about it by name.
+The seed chant itself is never filtered, because you asked about it by name.
 
 ## What the census is not
 

package/docs/api/chant.md

@@ -69,7 +69,7 @@ those marks too.
 The corpus is **assignment-driven**: a chant ships when some day of the
 liturgical year calls for it. The calendar is walked year by year until it stops
 finding new assignments (39 years, in the event), and what it never reaches is
-not shipped — 10,156 book chants become 2,187.
+not shipped: 10,156 book chants become 2,187.
 
 Everything here answers "what was sung on this day". A query for a chant the
 calendar never calls for returns nothing.
@@ -77,11 +77,11 @@ calendar never calls for returns nothing.
 ## The books — `corpus`
 
 `corpus(code)` returns one book's bibliographic identity and a breakdown of what
-it holds — how many chants, in what genres, in what modes. `corpus({ book })` is
+it holds: how many chants, in what genres, in what modes. `corpus({ book })` is
 the same question in the query form every other verb uses; both spellings return
 one answer.
 
-`corpus()` with no argument returns **the whole shelf** — the rollup plus every
+`corpus()` with no argument returns **the whole shelf**, the rollup plus every
 book's ledger:
 
 ```js
@@ -94,10 +94,10 @@ tonus.corpus();
 //   books:  [ …10 Corpus entries, in registry order ] }
 ```
 
-**`count` is the number of chants** — the one to quote. `listings` is how long
-the shelf is, and `listings - count` is 580 extra rows, over the 683 chants
-printed in more than one book. The breakdowns describe the same population
-`count` does, so `genera` and `modes` sum to it.
+**`count` is the number of chants**, the one to quote. `listings` is how long
+the shelf is: a melody printed in several books is stored once and listed under
+each, so the shelf runs longer than the repertory. The breakdowns describe the
+same population `count` does, so `genera` and `modes` sum to it.
 
 ```js
 tonus.corpus("am");
@@ -141,7 +141,7 @@ am.genera[0];         // { office: "an", genus: "Antiphona", count: 458 }
 am.full.genera[0];    // { office: "an", genus: "Antiphona", count: 1049 }
 ```
 
-Reading the two tallies side by side names what was left out — 1,049 antiphons
+Reading the two tallies side by side names what was left out: 1,049 antiphons
 in the book, 458 sung.
 
 Only the extractor can measure this. By the time tonus loads, the keep set has
@@ -163,7 +163,7 @@ is largely the Graduale and the Antiphonarius bound together (it shares hundreds
 of chants with each), while the Antiphonale Monasticum is almost entirely its own.
 
 The Nocturnale (`nr`) is compared differently, because it has no GregoBase
-catalogue: its counts come from its own extract, and it shares **nothing** —
+catalogue: its counts come from its own extract, and it shares **nothing**, so
 `unique` is all 1,564 chants it holds. That is a measurement, not a gap. The
 nocturnale–GregoBase crosswalk is a route to metadata, not a claim that the two
 books print the same chant, so it does not count as sharing.
@@ -295,34 +295,34 @@ A plain search does not sweep it in: `{ mode: 5 }` returns the shelf. Ask for a
 Kyrie and you get Kyries.
 
 For the setting a given DAY calls for, [`ordinarium`](#the-ordinary--ordinarium)
-is the verb — it applies the Kyriale's own rubrics. This is flat retrieval.
+is the verb, and it applies the Kyriale's own rubrics. This is flat retrieval.
 
 ### On chant ids
 
-An id's prefix names **the catalogue the identifier came from** — not the book
+An id's prefix names **the catalogue the identifier came from**, not the book
 the chant is printed in, and not a claim about who the melody belongs to. A
 chant carrying `gregobase:1210` is a Solesmes book chant that GregoBase happens
 to have catalogued; the corpus is assembled from ten books, and GregoBase is
 one source among several.
 
 The prefix is therefore **not a namespace you can query against**. GregoBase
-holds 18,148 chants; tonus ships 1,717 of them — 9.5% — because the corpus is
+holds 18,148 chants; tonus ships 1,717 of them (9.5%), because the corpus is
 assignment-driven, so an id copied from the GregoBase site will usually return
 `[]` here. That is not a lookup failure; it means no day of the calendar calls
 for that chant. The two prefixes in the shipped corpus are `gregobase:` (1,717)
 and `nocturnale:` (470), the latter carrying the Nocturnale's own alphanumeric
 keys rather than numbers.
 
-Within tonus an id is exactly one chant. A melody printed in several books —
-683 of them are — is stored once, under the record `cantus({ id })` returns, so
-`id` is a stable key to a chant rather than to a printing.
+Within tonus an id is exactly one chant. A melody printed in several books is
+stored once, under the record `cantus({ id })` returns, so `id` is a stable key
+to a chant rather than to a printing.
 
 ## The repertoire as of a date — the era view
 
 `before: 1098` keeps only chants a manuscript of the 10th century or earlier
 already holds. This is **evidence, not existence**: the dates come from
 CANTUS's manuscript index, a terminus ante quem, so the filter answers "what
-is attested by then," never "what existed then" — and a chant with no dated
+is attested by then," never "what existed then." A chant with no dated
 witness is excluded rather than assumed old. CANTUS dates only to the century,
 so a year admits the centuries that have CLOSED before it (`before: 1098` →
 through the 900s).
@@ -339,7 +339,7 @@ tonus.ordinarium({ feast: easter }); // the ordinary the view attests
 ```
 
 What happens to a slot the view excludes differs by verb, on the rubric's
-own logic: `ordinarium` **re-picks** — the Kyriale offers ranked
+own logic: `ordinarium` **re-picks**, because the Kyriale offers ranked
 alternatives by design, so the rotation runs over the admissible pool and
 the day still sings. `proprium` and `officium` have no pool
 of alternatives, so an excluded chant **falls silent**. A `before` given to a
@@ -371,15 +371,15 @@ interface PropriumQuery extends CantusQuery {
 ## The ordinary — `ordinarium`
 
 `ordinarium(query?)` retrieves the fixed chants of the Mass from the
-Kyriale. A feast drives mass selection through its `masses` list — the
+Kyriale. A feast drives mass selection through its `masses` list, the
 masses the day's Kyriale RUBRIC appoints, derived as described in
 [calendar.md](calendar.md#the-days-feasts--festum); `mass` pins a kyriale
 number directly. Where the rubric names several masses, the year rotates
 through them (same feast, same year → same answer, every time), and sibling
 printings under one number (Mass I prints two dismissals; Mass XVII prints
 Kyrie A/B/C) rotate with it. Slots resolve independently, which the book
-licenses outright — "chants from one Mass may be used together with those
-from others" — with one exception, the book's own: **"the Ferial Masses
+licenses outright ("chants from one Mass may be used together with those
+from others") with one exception, the book's own: **"the Ferial Masses
 excepted."** Under a ferial rubric the sung ordinary is not gathered from
 several masses; only the dismissal travels.
 
@@ -397,10 +397,10 @@ tonus.ordinarium({ feast: easter });
 
 The **Gloria follows the day's rank rubric, not its season**: the ferial
 masses print none (XVI, XVIII) and the penitential-Sunday mass none (XVII),
-while a I-class feast inside Advent or Lent — the Immaculate Conception —
+while a I-class feast inside Advent or Lent (the Immaculate Conception)
 keeps its Gloria. At a Gloria-less Mass the dismissal is the Benedicamus
 Domino, and a mass with no dismissal of its own borrows one exactly as the
-book directs: "Benedicamus Domino **as in Mass II**" — so a green feria
+book directs: "Benedicamus Domino **as in Mass II**," so a green feria
 sings Mass XVI whole with the Mass II Benedicamus. The ad libitum appendix
 is a **solemnity boost**, reachable only under the festal rubrics (it takes
 its turn in the rotation once every _n + 1_ years); it never reaches a
@@ -475,7 +475,7 @@ seasonal ordo and returned in liturgical order. With no feast, each resolves
 for the [default epoch](index.md#dates).
 
 **Matins is returned flat.** The night office answers like any other hour,
-its responsories drawn from the Nocturnale Romanum (`nr`) — but the
+its responsories drawn from the Nocturnale Romanum (`nr`). But the
 three-nocturn, twelve-psalm division is not modelled: the chants are right,
 their grouping into nocturns is not expressed.
 
@@ -492,7 +492,7 @@ interface OfficiumQuery extends CantusQuery {
 }
 ```
 
-The eight hours ship as [`HORAE`](index.md#the-appendix), Matins first — read
+The eight hours ship as [`HORAE`](index.md#the-appendix), Matins first. Read
 them from there rather than transcribing them, and an unrecognised `hora`
 throws rather than matching nothing, so a misspelling cannot read as an empty
 hour.
@@ -507,9 +507,9 @@ tonus.officium({ hora: "vespers" });  // throws: unknown hora "vespers"
 
 ### One cursus, the Benedictine
 
-tonus assembles a single office — the monastic cursus — with no option to
+tonus assembles a single office (the monastic cursus) with no option to
 choose another. The chants come from the Antiphonale Monasticum (`am`) and its
-companions; the psalmody follows the Benedictine distribution — the little
+companions; the psalmody follows the Benedictine distribution, the little
 hours take the gradual psalms (Terce 119–121, Sext 122–124, None 125–127),
 with Sunday and Monday walking their portions of Ps 118 instead; Prime walks
 Pss 1–19 across the week (Sunday opens Ps 118); and Compline is the fixed
@@ -530,7 +530,7 @@ the opening formula is included, as it is for a psalm's first verse.
 mediant, as a psalm sung without an antiphon; `solemn` uses a tone's
 ornamented mediant where it has one. Canticles are addressed by name:
 `benedictus`, `magnificat`, `nunc dimittis`, `benedicite`. (The Te Deum
-is not psalmody — it carries its own melody and is not addressable here.)
+is not psalmody: it carries its own melody and is not addressable here.)
 
 ```js
 tonus.psalmus({ psalm: 109, verse: "1a", mode: 1 });

package/docs/api/heavens.md

@@ -168,12 +168,12 @@ and moves with precession; a table carrying "March 21" would be wrong for most
 of the period this library models, and wrong differently every century.
 
 **What is omitted, and why.** The exaltation degrees Ptolemy gives (the Sun at
-19° Arietis and the rest) are not carried — the sign is the resolution anything
-here reads. Nor are the lunar nodes' exaltations, because the nodes are not
+19° Arietis and the rest) are not carried, because the sign is the resolution
+anything here reads. Nor are the lunar nodes' exaltations, because the nodes are not
 tonus bodies. Five signs exalt nobody: that silence is the tradition's, not a
 gap in the table.
 
-The `melothesia` is the *homo signorum* of medieval calendars — Aries at the
+The `melothesia` is the *homo signorum* of medieval calendars, Aries at the
 head down to Pisces at the feet. It was practice, not decoration: phlebotomy
 was timed against it, and while the Moon stood in a sign its member was not to
 be touched. Sourced from Ptolemy's *Tetrabiblos* I.17 and I.19
@@ -216,7 +216,7 @@ The doctrinae:
 Sphere pitches are computed directly from the doctrina's pure ratios,
 anchored at the temperamentum's A4, so historical coherence holds:
 `temperamentum("ptolemy-intense")` with `harmonia({ doctrina: "ptolemy" })`
-gives pure Ptolemaic intervals throughout — Sun→Jupiter a pure 3/2,
+gives pure Ptolemaic intervals throughout: Sun→Jupiter a pure 3/2,
 Sun→Saturn a pure 2/1. The temperamentum's scale governs pitch naming and
 the imprint.
 
@@ -322,7 +322,7 @@ h.tabula.find((r) => r.name === "Jupiter");
 ```
 
 `ratio` is the doctrina's own fraction against the mese, the primary datum of
-the whole scheme — `spn` and `hz` are that ratio sounded against A4, not
+the whole scheme. `spn` and `hz` are that ratio sounded against A4, not
 independent claims. Comparing doctrinae means comparing these: the table
 under [Theory & Context](#theory--context) is what the field returns.
 
@@ -364,7 +364,7 @@ The doctrina ratios are reconstructed from the primary texts through
 Joscelyn Godwin's syntheses, mapping each body to a Greek tone-name and
 deriving its ratio by Pythagorean interval arithmetic normalized to the
 mese (Sun = 1/1). The full method, the taxonomy, and the decisions taken
-along the way are documented at the data — see `DOCTRINAE` in
+along the way are documented at the data. See `DOCTRINAE` in
 [`harmonia/data/doctrines.ts`](https://github.com/jeffreypierce/tonus/blob/main/src/engines/harmonia/data/doctrines.ts).
 The same arithmetic is laid out from the tuning side in
 [tuning.md](tuning.md#theory--context).
@@ -385,7 +385,7 @@ The resulting ratios, by sphere from the outermost:
 
 The single pitch separating Pythagoras from Boethius is Venus: a whole
 tone above the Sun in the disjunct system (9/8, B durum), a semitone in
-the conjunct (256/243, B molle) — the origin of the durum/molle
+the conjunct (256/243, B molle). This is the origin of the durum/molle
 distinction that runs through all of medieval music theory.
 
 ## Sources

package/docs/api/index.md

@@ -4,7 +4,7 @@ The technical center of tonus: the full public API, the conventions every method
 obeys, and the error contract. The API is **fourteen methods on the `tonus`
 namespace**, no sub-namespaces.
 
-**[Interactive demo →](https://jeffreypierce.github.io/tonus/)**
+**[Interactive demo](https://orreliquum.com/)**
 
 ```js
 import tonus from "tonus";
@@ -123,7 +123,7 @@ is for.
 | `CENSUS_GROUPS` | the field groups → `{ offset, count }`; the keys are the valid `by:` values **and** the `profile` keys |
 | `CENSUS_ORDER`  | every censused chant id, in block order — so membership is a lookup, not a `try/catch`                 |
 
-Use these to pool blocks without reproducing the distance rule — see [the census
+Use these to pool blocks without reproducing the distance rule. See [the census
 contract](census.md#distance-is-cosine-per-field-group).
 
 ## Full contents
@@ -218,7 +218,7 @@ Other fields carry only one register. Latin-only, _e.g._ `genus`, `ordinarium`,
 `incipit`, `differentia`, `accentus`. English-only, _e.g._ `date`, `velocity`, `hz`.
 
 Display strings live in exported maps (_e.g._ `SEASON_LABEL`),
-never as label fields on objects — the maps are [the appendix](#the-appendix).
+never as label fields on objects. The maps are [the appendix](#the-appendix).
 
 ### Dates
 
@@ -238,14 +238,14 @@ an ensemble) it is seeded, so the same seed yields byte-identical output.
 
 ### Error contract
 
-- Query functions return `[]` on no match, never throw — but an **empty or
+- Query functions return `[]` on no match, never throw. But an **empty or
   unknown-key query** throws (a mistyped filter is a bug, not an empty result):
   `festum({ month: 12 })` and `cantus({})` throw rather than silently resolving a
   plausible-looking answer.
 - Builder functions throw `Error` with a descriptive message on invalid input.
 - `notatio` throws on invalid `Chant` input.
 - `inscriptio` throws on a non-`Score` argument or an unknown notation species.
-- `temperamentum.tonus()` throws if `mode` is `"auto"` — mode must be set
+- `temperamentum.tonus()` throws if `mode` is `"auto"`. Mode must be set
   explicitly.
 - Malformed `comma`, ratio, or Scala input throws `RangeError`; custom scales
   must supply 7 or 12 steps, beginning at `1/1` (a degree list) or ending at