tonus 0.6.1 → 0.8.0

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

@@ -1,5 +1,5 @@
 import { type Imprint } from "../imprint.js";
-import { type Prosody } from "./prosody.js";
+import { type Metrics } from "./metrics.js";
 import { type Cadence } from "./cadence.js";
 import { type Modulation } from "./modulation.js";
 import { type ChantTabulaRow } from "./tabula.js";
@@ -28,7 +28,7 @@ export interface Score {
     phrases: IRPhrase[];
     errors: ParseError[];
     tabula: ChantTabulaRow[];
-    prosody: Prosody;
+    metrics: Metrics;
     /** Mode-specific cadence at each phrase-ending divisio. */
     cadences: Cadence[];
     /** Passages where the tonal centre leans away from the home mode. */
@@ -38,7 +38,7 @@ export interface Score {
 /**
  * Score builder (`tonus.notatio`). Parses a chant's GABC into a musical
  * IR — phrases, syllables, notes with tuned pitches, arsis/thesis
- * rhythm, prosody, imprint, and a tabula. Options: a temperamentum
+ * rhythm, metrics, imprint, and a tabula. Options: a temperamentum
  * (tuning), a pondus (articulation weight, style name or opts), and an
  * accentus (phrasing, style name or opts).
  * @throws Error on invalid Chant input or unparseable GABC.

package/dist/engines/score/api.js

@@ -6,7 +6,7 @@ import { buildIR } from "./ir.js";
 import { buildRatios } from "../temper/scale.js";
 import { computeMeta } from "./meta.js";
 import { computeImprint } from "../imprint.js";
-import { computeProsody } from "./prosody.js";
+import { computeMetrics } from "./metrics.js";
 import { detectCadences } from "./cadence.js";
 import { detectModulations } from "./modulation.js";
 import { computeTabula } from "./tabula.js";
@@ -33,7 +33,7 @@ function resolveAccentus(input) {
 /**
  * Score builder (`tonus.notatio`). Parses a chant's GABC into a musical
  * IR — phrases, syllables, notes with tuned pitches, arsis/thesis
- * rhythm, prosody, imprint, and a tabula. Options: a temperamentum
+ * rhythm, metrics, imprint, and a tabula. Options: a temperamentum
  * (tuning), a pondus (articulation weight, style name or opts), and an
  * accentus (phrasing, style name or opts).
  * @throws Error on invalid Chant input or unparseable GABC.
@@ -98,7 +98,7 @@ export function buildScore(chant, opts) {
         phrases: ir.phrases,
         errors: ir.errors,
         tabula,
-        prosody: computeProsody(ir.phrases),
+        metrics: computeMetrics(ir.phrases),
         cadences,
         modulations,
         imprint: computeImprint(ir.phrases, scale, {

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

@@ -34,14 +34,14 @@ export declare const STROKE: {
 };
 /** The type scale, and it is THE PAGE'S: a modular scale on 15px stepped by
  *  the Pythagorean minor third, 32:27 — the same six `--micro` … `--display-size`
- *  that ../../../../docs/styles.css declares. So a wheel's label and a table's
+ *  that the site's stylesheet declares. So a wheel's label and a table's
  *  label at the same step are the same size.
  *
  *  It was 9/11/13.5/17/21/26, derived from what the diagrams happened to use.
  *  That was honest when the page had no scale of its own; once the page took
  *  one, the two agreed on `title` alone and every drawn label sat 1.5–2px under
- *  the prose around it. ../../../../scripts/vendor-ink.mjs asserts the pairing
- *  now, so this cannot drift again silently.
+ *  the prose around it. The site's vendor step asserts the pairing now, so this
+ *  cannot drift again silently.
  *
  *  Nothing inside tonus reads STEP — the site's diagrams are its only consumer
  *  — so moving it changes no emitted SVG for a package consumer. */
@@ -63,7 +63,7 @@ export declare const HOUSE_SERIF = "Junicode, 'Crimson Pro', Georgia, serif";
 export declare const HOUSE_MONO = "'IBM Plex Mono', ui-monospace, Menlo, monospace";
 /** The fourth stack, and NOT a fourth face: neither text face carries the
  *  planetary or musical signs (see fonts/README.md), so a figure that draws one
- *  falls back to the system. Mirrors `--symbol` in ../../../../docs/styles.css
+ *  falls back to the system. Mirrors `--symbol` in the site's stylesheet
  *  — the same sharing-by-numbers seam as HOUSE_SERIF and HOUSE_MONO, and it was duplicated
  *  inline in mutatio.js as a local SIGN_FACE before this existed. */
 export declare const HOUSE_SYMBOL: string;
@@ -79,9 +79,9 @@ export declare const HOUSE_SYMBOL: string;
  *  of digits must line up; that is the setting that does work.
  *
  *  Nothing in the library's own emitters uses this yet. It lives here because
- *  this file is the ONE definition of the ink system and the site vendors it
- *  (../../../../scripts/vendor-ink.mjs) — a second copy in the site would be
- *  the drift this module exists to prevent. */
+ *  this file is the ONE definition of the ink system and the site vendors it —
+ *  a second copy in the site would be the drift this module exists to
+ *  prevent. */
 export declare const FIGURES: {
     readonly family: "Junicode, 'Crimson Pro', Georgia, serif";
     readonly features: "";

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

@@ -24,9 +24,8 @@
 // draw.
 //
 // ─── HOW THIS MEETS THE PAGE ───────────────────────────────────────────────
-// The documentation site keeps a system of its own, stated at the top of
-// ../../../../docs/styles.css. The two are separate and they AGREE BY SHARING
-// NUMBERS,
+// The site (orreliquum-next) keeps a system of its own, stated at the top of
+// its stylesheet. The two are separate and they AGREE BY SHARING NUMBERS,
 // not by one importing the other:
 //
 //   STEP        mirrors the six CSS type steps  (--micro … --display-size)
@@ -92,14 +91,14 @@ export const STROKE = {
 };
 /** The type scale, and it is THE PAGE'S: a modular scale on 15px stepped by
  *  the Pythagorean minor third, 32:27 — the same six `--micro` … `--display-size`
- *  that ../../../../docs/styles.css declares. So a wheel's label and a table's
+ *  that the site's stylesheet declares. So a wheel's label and a table's
  *  label at the same step are the same size.
  *
  *  It was 9/11/13.5/17/21/26, derived from what the diagrams happened to use.
  *  That was honest when the page had no scale of its own; once the page took
  *  one, the two agreed on `title` alone and every drawn label sat 1.5–2px under
- *  the prose around it. ../../../../scripts/vendor-ink.mjs asserts the pairing
- *  now, so this cannot drift again silently.
+ *  the prose around it. The site's vendor step asserts the pairing now, so this
+ *  cannot drift again silently.
  *
  *  Nothing inside tonus reads STEP — the site's diagrams are its only consumer
  *  — so moving it changes no emitted SVG for a package consumer. */
@@ -128,7 +127,7 @@ export const HOUSE_SERIF = "Junicode, 'Crimson Pro', Georgia, serif";
 export const HOUSE_MONO = "'IBM Plex Mono', ui-monospace, Menlo, monospace";
 /** The fourth stack, and NOT a fourth face: neither text face carries the
  *  planetary or musical signs (see fonts/README.md), so a figure that draws one
- *  falls back to the system. Mirrors `--symbol` in ../../../../docs/styles.css
+ *  falls back to the system. Mirrors `--symbol` in the site's stylesheet
  *  — the same sharing-by-numbers seam as HOUSE_SERIF and HOUSE_MONO, and it was duplicated
  *  inline in mutatio.js as a local SIGN_FACE before this existed. */
 export const HOUSE_SYMBOL = "'Apple Symbols', 'Segoe UI Symbol', "
@@ -145,9 +144,9 @@ export const HOUSE_SYMBOL = "'Apple Symbols', 'Segoe UI Symbol', "
  *  of digits must line up; that is the setting that does work.
  *
  *  Nothing in the library's own emitters uses this yet. It lives here because
- *  this file is the ONE definition of the ink system and the site vendors it
- *  (../../../../scripts/vendor-ink.mjs) — a second copy in the site would be
- *  the drift this module exists to prevent. */
+ *  this file is the ONE definition of the ink system and the site vendors it —
+ *  a second copy in the site would be the drift this module exists to
+ *  prevent. */
 export const FIGURES = {
     family: HOUSE_SERIF,
     features: "",

package/dist/engines/score/{prosody.d.ts → metrics.d.ts}

@@ -48,7 +48,7 @@ export interface Arcus {
      */
     archIndex: number;
 }
-export interface Prosody {
+export interface Metrics {
     noteCount: number;
     syllableCount: number;
     phraseCount: number;
@@ -69,5 +69,5 @@ export interface Prosody {
     cadenceWeight: number;
     cadenceDistribution: CadenceDistribution;
 }
-export declare function computeProsody(phrases: Phrase[]): Prosody;
-//# sourceMappingURL=prosody.d.ts.map
+export declare function computeMetrics(phrases: Phrase[]): Metrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/engines/score/{prosody.js → metrics.js}

@@ -1,4 +1,4 @@
-export function computeProsody(phrases) {
+export function computeMetrics(phrases) {
     let phraseCount = 0;
     let noteCount = 0;
     let syllableCount = 0;
@@ -175,4 +175,4 @@ export function computeProsody(phrases) {
         cadenceDistribution: cadDist,
     };
 }
-//# sourceMappingURL=prosody.js.map
+//# sourceMappingURL=metrics.js.map

package/dist/engines/score/phrasing.js

@@ -163,7 +163,7 @@ const CADENCE_VELOCITY_FACTOR = 0.5;
 const CADENCE_DURATION_FACTOR = 0.6;
 // The phrasing-side reading of the divisio (bar-line) hierarchy. This is the
 // same bar hierarchy tabulated canonically in ../../../docs/api/score.md and
-// weighted for analysis by prosody.ts's cadenceWeight ladder — but here the
+// weighted for analysis by metrics.ts's cadenceWeight ladder — but here the
 // weights differ on purpose:
 // this is a *shaping* factor, so the virgula (`) gets 0 (a breath, no cadential
 // stress), where the analytic ladder still counts it. Do not unify the three.

package/dist/engines/temper/data/guido.js

@@ -2,7 +2,13 @@
 // begin at the thumb tip, come down the thumb, cross the finger BASES
 // index→little, climb the little finger, return across the finger TIPS
 // little→index, descend the index, then spiral inward; ee (76) floats above the
-// middle fingertip (region "super"). The two b/♮ pairs (58/59, 70/71) share a
+// middle fingertip (region "super"). THE INWARD TURN IS ONE TURN: after g on
+// the index the line runs in to aa, out to bb/♮♮ on the ring, then UP that
+// finger to cc before crossing to the middle for dd and ee. Reading it with
+// cc on the middle and dd on the ring makes the line cross three times where
+// the hand turns once. The figure that DRAWS the turn lives in the site
+// (orreliquum-next), and its LOCUS table must agree with the fingers named
+// here; the test that holds the two together lives there beside it. The two b/♮ pairs (58/59, 70/71) share a
 // locus by design — one joint, two readings (fa in molle, mi in durum), the
 // tradition, not a duplication to fix. They are one distinction, named for the
 // two shapes of the letter: b rotundum (the round b) against b quadratum (the
@@ -31,8 +37,8 @@ export const GUIDONIAN_DATA = new Map([
     [69, { hand: { finger: "middle", region: "mid" }, name: ["aa", "Alamire"], variants: [{ hexachord: "durum", solmization: "RE" }, { hexachord: "naturale", solmization: "LA" }, { hexachord: "molle", solmization: "MI" }] }],
     [70, { hand: { finger: "ring", region: "mid" }, name: ["bb", "Befa"], variants: [{ hexachord: "molle", solmization: "FA" }] }],
     [71, { hand: { finger: "ring", region: "mid" }, name: ["♮♮", "Bemi"], variants: [{ hexachord: "durum", solmization: "MI" }] }],
-    [72, { hand: { finger: "middle", region: "top" }, name: ["cc", "Cesolfa"], variants: [{ hexachord: "durum", solmization: "FA" }, { hexachord: "naturale", solmization: "UT" }, { hexachord: "molle", solmization: "SOL" }] }],
-    [74, { hand: { finger: "ring", region: "top" }, name: ["dd", "Delasol"], variants: [{ hexachord: "durum", solmization: "SOL" }, { hexachord: "naturale", solmization: "RE" }, { hexachord: "molle", solmization: "LA" }] }],
+    [72, { hand: { finger: "ring", region: "top" }, name: ["cc", "Cesolfa"], variants: [{ hexachord: "durum", solmization: "FA" }, { hexachord: "naturale", solmization: "UT" }, { hexachord: "molle", solmization: "SOL" }] }],
+    [74, { hand: { finger: "middle", region: "top" }, name: ["dd", "Delasol"], variants: [{ hexachord: "durum", solmization: "SOL" }, { hexachord: "naturale", solmization: "RE" }, { hexachord: "molle", solmization: "LA" }] }],
     [76, { hand: { finger: "middle", region: "super" }, name: ["ee", "Ela"], variants: [{ hexachord: "durum", solmization: "LA" }, { hexachord: "naturale", solmization: "MI" }] }],
 ]);
 //# sourceMappingURL=guido.js.map

package/dist/index.d.ts

@@ -17,7 +17,7 @@ import type { Score, ScoreOpts, PondusInput, PondusOpts, AccentusInput, Accentus
 import type { InscriptioOpts, Inscriptio, NoteGeometry, FontSpec, FontSlot, FontEmbed } from "./engines/score/inscriptio.js";
 import type { ChantTabulaRow } from "./engines/score/tabula.js";
 import type { Imprint, Attractor, VowelAttractor, ModalAffinity } from "./engines/imprint.js";
-import type { Prosody, RhythmicProfile, NoteRange, CadenceDistribution } from "./engines/score/prosody.js";
+import type { Metrics, RhythmicProfile, NoteRange, CadenceDistribution } from "./engines/score/metrics.js";
 import type { Harmony, HarmoniaOpts, VoicedBody, VoicedAspect, Frame, Author } from "./engines/harmonia/api.js";
 import type { HarmonyTabulaRow } from "./engines/harmonia/tabula.js";
 import type { PlanetVowel } from "./engines/harmonia/data/vowels.js";
@@ -58,5 +58,5 @@ export { CADENTIAE, CADENTIAE_POPULATION } from "./data/cadentiae.js";
 export type { CadentiaFamilia } from "./data/cadentiae.js";
 export { ZODIACA } from "./engines/harmonia/data/zodiac.js";
 export { CENSUS_GROUPS, CENSUS_ORDER } from "./data/census.js";
-export type { Feast, FeastQuery, Pascha, Season, Grade, Chant, CantusQuery, OrdinaryChant, PropriumQuery, OrdinariumQuery, OfficiumQuery, PsalmusQuery, Corpus, GenusCount, ModeCount, SharedCount, CorpusLedger, CorpusFullCount, CorpusQuery, Census, CensusQuery, CensusBy, CensusGroup, CensusGroupProfile, CensusNeighbor, 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, InscriptioOpts, Inscriptio, NoteGeometry, FontSpec, FontSlot, FontEmbed, ChantTabulaRow, Note, Performance, Phrase, Syllable, LyricRun, 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, Corpus, GenusCount, ModeCount, SharedCount, CorpusLedger, CorpusFullCount, CorpusQuery, Census, CensusQuery, CensusBy, CensusGroup, CensusGroupProfile, CensusNeighbor, 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, InscriptioOpts, Inscriptio, NoteGeometry, FontSpec, FontSlot, FontEmbed, ChantTabulaRow, Note, Performance, Phrase, Syllable, LyricRun, RestEvent, ParseError, ArsisThesis, RhythmicType, CompoundBeat, VoicedPitch, Cosmos, CosmosQuery, Body, BodyName, Aspect, Imprint, Attractor, VowelAttractor, ModalAffinity, Metrics, RhythmicProfile, NoteRange, CadenceDistribution, Harmony, HarmoniaOpts, VoicedBody, VoicedAspect, Frame, Author, HarmonyTabulaRow, PlanetVowel, };
 //# sourceMappingURL=index.d.ts.map

package/docs/api/chant.md

@@ -601,7 +601,7 @@ phrase punctuation ([score.md](score.md#the-tabula)).
 
 Because the encoding is textual, lyrics and neumes stay aligned syllable
 by syllable, which is what lets `tonus.notatio` reconstruct syllables,
-neumes, and prosody without images.
+neumes, and metrics without images.
 
 ### The Mass: proper and ordinary
 

package/docs/api/index.md

@@ -173,7 +173,7 @@ the list resolve their pitches through the ones before.
 - [The tabula](score.md#the-tabula)
 - [Rendering — `inscriptio`](score.md#rendering) · [theme](score.md#theme--faces-and-ink) · [The analysis tracks](score.md#the-analysis-tracks)
 - [The imprint](score.md#the-imprint)
-- [Prosody](score.md#prosody)
+- [Metrics](score.md#metrics)
 - [Cadences](score.md#cadences) · [One spine, two annotations](score.md#one-spine-two-annotations)
 - [Modulations](score.md#modulations)
 - [Theory & Context](score.md#theory--context) · [Sources](score.md#sources)

package/docs/api/score.md

@@ -2,7 +2,7 @@
 
 `tonus.notatio` renders a chant into a score: the analyzed, tuned, and
 rhythm-classified reading of one GABC melody. The score is data: `phrases`,
-`tabula`, `prosody`, `cadences`, `modulations`, and `imprint`. The
+`tabula`, `metrics`, `cadences`, `modulations`, and `imprint`. The
 standalone `tonus.inscriptio(score)` draws it to SVG.
 
 - [Score](#score)
@@ -15,7 +15,7 @@ standalone `tonus.inscriptio(score)` draws it to SVG.
     - [theme — faces and ink](#theme--faces-and-ink)
     - [The analysis tracks](#the-analysis-tracks)
   - [The imprint](#the-imprint)
-  - [Prosody](#prosody)
+  - [Metrics](#metrics)
   - [Cadences](#cadences)
     - [One spine, two annotations](#one-spine-two-annotations)
     - [`finality` — how often this family closes](#finality--how-often-this-family-closes)
@@ -54,7 +54,7 @@ notation, signs of punctuation rather than measure:
 | `::`    | divisio finalis (double bar) |
 
 This hierarchy is read three ways in the engine, each weighting the bars for its
-own end: an analytic cadence weight (prosody), a phrasing strength (which zeroes
+own end: an analytic cadence weight (metrics), a phrasing strength (which zeroes
 the virgula), and a rest duration (the divisio's pause length). Each weighting
 is documented at its table in the code.
 
@@ -64,7 +64,7 @@ interface Score {
   phrases: Phrase[];
   errors: ParseError[];
   tabula: ChantTabulaRow[];
-  prosody: Prosody;
+  metrics: Metrics;
   cadences: Cadence[];
   modulations: Modulation[];
   imprint: Imprint;
@@ -665,16 +665,16 @@ interface ModalAffinity {
 }
 ```
 
-## Prosody
+## Metrics
 
-`score.prosody` measures the chant's shape — counts, range, melisma,
+`score.metrics` measures the chant's shape — counts, range, melisma,
 melodic motion, contour, tessitura, rhythm, cadence. It is chant-specific;
-`Harmony` has no prosody. For _Puer natus est_: ambitus 10 semitones, melisma
+`Harmony` has no metrics. For _Puer natus est_: ambitus 10 semitones, melisma
 ratio 2.04 notes per syllable, tessitura ~5 semitones above the final, a near-
 perfect melodic arch, mostly stepwise motion (leap rate ~5%).
 
 ```ts
-interface Prosody {
+interface Metrics {
   noteCount: number;
   syllableCount: number;
   phraseCount: number;
@@ -730,7 +730,7 @@ interface CadenceDistribution {
 
 ## Cadences
 
-`score.cadences` names the melodic close of each phrase — where prosody
+`score.cadences` names the melodic close of each phrase — where metrics
 only counts the divisio bars, this identifies the figure. One `Cadence` per
 phrase-ending divisio: its resolution `target`, the melodic `approach`, and the
 `divisio` that tells medial from final (the double bar `::` is the final

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonus",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "type": "module",
   "description": "Medieval music analysis and performance: GABC plainchant exports, liturgical calendar, tuning systems, ephemeris, and the harmony of the spheres",
   "author": "Jeffrey Pierce <jeffrey@jeffreypierce.net>",
@@ -50,10 +50,6 @@
     "clean": "rm -rf dist",
     "test": "npm run build && node --test --test-reporter=spec tests/*.test.mjs",
     "prepublishOnly": "npm run clean && npm run build",
-    "check:links": "node scripts/check-doc-links.mjs",
-    "site": "npm run build && node scripts/vendor-ink.mjs && rm -rf docs/dist && cp -R dist docs/dist",
-    "serve": "npm run site && node scripts/serve.mjs",
-    "diagrams": "npm run site && node scripts/diagram-lab.mjs",
     "lab": "npm run build && node scripts/render-lab.mjs",
     "stress": "npm run build && node scripts/render-stress.mjs",
     "glyphs": "node scripts/extract-smufl-glyphs.mjs"