tonus 0.7.0 → 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/{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/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.7.0",
+  "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>",