tonus 0.10.2 → 0.10.3

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to tonus. Newest first.
 
+## 0.10.3 — 2026-09-04
+
+The close ritards.
+
+### Changed
+
+- **The close now ritards.** Two faults in the phrasing made every phrase
+  hurry into its cadence. The duration arch was a symmetric window, 0 at both
+  ends, so the second half of a phrase ran quicker than its middle; and the
+  cadence lengthened only the one note before the bar, by a term small enough
+  that the arch's fall ate it. A full close was held no longer than a comma,
+  and an ictus two notes earlier often outlasted the final note. The duration
+  arch now rises and holds — the subsiding is a lightening, not a hurrying —
+  and the `accentus` profile gains a rallentando: `ritard` (its depth),
+  `ritardNotes` (its width), `ritardCurve` (how late it gathers), graded by
+  the divisio ladder so a comma leans, a double bar broadens, a breath moves
+  nothing, with `finisBoost` on the piece's own last `::`. `shapedDuration`
+  changes on the second half of every phrase; `duration` and `velocity` do
+  not. Override `ritard: 0` to remove the window.
+
 ## 0.10.2 — 2026-09-02
 
 A stub is not a chant.

package/dist/engines/score/phrasing.js

@@ -6,6 +6,10 @@ const PHRASING_PROFILES = {
         curve: 0.1,
         accent: 0.5,
         cadence: 0.1,
+        ritard: 0.25,
+        ritardNotes: 2,
+        ritardCurve: 1.6,
+        finisBoost: 1.5,
         tenor: 2.3,
         baseVelocity: 0.65,
         contourVel: 0.08,
@@ -19,6 +23,10 @@ const PHRASING_PROFILES = {
         curve: 0.35,
         accent: 0.8,
         cadence: 0.15,
+        ritard: 0.4,
+        ritardNotes: 3,
+        ritardCurve: 1.6,
+        finisBoost: 1.5,
         tenor: 1.2,
         baseVelocity: 0.68,
         contourVel: 0.18,
@@ -32,6 +40,10 @@ const PHRASING_PROFILES = {
         curve: 0.25,
         accent: 0.6,
         cadence: 0.12,
+        ritard: 0.35,
+        ritardNotes: 3,
+        ritardCurve: 1.6,
+        finisBoost: 1.5,
         tenor: 0.9,
         baseVelocity: 0.69,
         contourVel: 0.14,
@@ -45,6 +57,10 @@ const PHRASING_PROFILES = {
         curve: 0.5,
         accent: 1,
         cadence: 0.2,
+        ritard: 0.5,
+        ritardNotes: 4,
+        ritardCurve: 1.6,
+        finisBoost: 1.5,
         tenor: 1.7,
         baseVelocity: 0.71,
         contourVel: 0.22,
@@ -207,8 +223,8 @@ export function applyPhrasing(events, profile, tenorPc) {
     }
     if (currentPhrase.length > 0)
         phrases.push(currentPhrase);
-    for (const phrase of phrases) {
-        const noteEntries = phrase;
+    for (let p = 0; p < phrases.length; p++) {
+        const noteEntries = phrases[p];
         if (noteEntries.length === 0)
             continue;
         let minArsis = Infinity, maxArsis = -Infinity;
@@ -260,14 +276,36 @@ export function applyPhrasing(events, profile, tenorPc) {
             velocity *=
                 1 - profile.cadence * divisioStrength * CADENCE_VELOCITY_FACTOR;
             const finalVelocity = Math.max(VELOCITY_MIN, Math.min(VELOCITY_MAX, velocity * profile.baseVelocity));
+            // The duration arch is one-sided: it rises with the velocity arch over
+            // the first half and then HOLDS. The grand rythme's subsiding is a
+            // lightening, not a hurrying — a symmetric window here made every phrase
+            // accelerate into its cadence.
+            const durArch = t < 0.5 ? arch : 1;
             const baseDur = note.performance.duration;
             let durFactor = DURATION_BASE_FACTOR +
                 arsisRelative * DURATION_ARSIS_FACTOR +
-                arch * DURATION_ARCH_FACTOR;
+                durArch * DURATION_ARCH_FACTOR;
             durFactor += (contourRelative - VELOCITY_CENTER) * profile.contourDur;
             if (note.context.ictus)
                 durFactor *= profile.ictusBoost;
             durFactor += profile.cadence * divisioStrength * CADENCE_DURATION_FACTOR;
+            // The rallentando into the close. The cadence term above lengthens only
+            // the one note before the bar, so without a window a full close was held
+            // no longer than a comma, and an ictus two notes earlier often outlasted
+            // the final note. The window covers the phrase's last `ritardNotes` (or
+            // all of a shorter phrase), rising 0 → 1 toward the bar along a power
+            // curve; the divisio ladder grades it, so a comma leans, a double bar
+            // broadens, a breath moves nothing. The piece's own last bar is not just
+            // another double bar. A ritard is a tempo scaling, so it multiplies.
+            const closing = noteEntries[noteEntries.length - 1].nextDivisio;
+            const span = Math.min(Math.max(1, Math.round(profile.ritardNotes)), noteEntries.length);
+            const tail = order - (noteEntries.length - span);
+            if (tail >= 0) {
+                const ramp = ((tail + 1) / span) ** profile.ritardCurve;
+                const finis = p === phrases.length - 1 && closing === "::" ? profile.finisBoost : 1;
+                durFactor *=
+                    1 + profile.ritard * getDivisioStrength(closing) * finis * ramp;
+            }
             const shapedDuration = Math.max(DURATION_MIN, Math.min(DURATION_MAX, baseDur * durFactor));
             shaped.push({
                 ...note,

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

@@ -132,6 +132,14 @@ export interface PhrasingProfile {
     curve: number;
     accent: number;
     cadence: number;
+    /** The rallentando into a close: how far its last notes broaden, graded by the bar. */
+    ritard: number;
+    /** How many closing notes the rallentando covers. */
+    ritardNotes: number;
+    /** The ramp's power: 1 is linear, above 1 gathers the broadening late, like a singer. */
+    ritardCurve: number;
+    /** A multiplier on the piece's own last `::` — the end of the chant over any other double bar. */
+    finisBoost: number;
     tenor: number;
     baseVelocity: number;
     contourVel: number;

package/docs/api/score.md

@@ -208,6 +208,8 @@ The `accentus` profile (`PhrasingProfile`):
 | `curve`                     | depth of the phrase-level velocity arch            |
 | `accent`                    | accent emphasis within the phrase                  |
 | `cadence`                   | weight given to phrase-final cadences              |
+| `ritard`, `ritardNotes`     | depth and width, in notes, of the rallentando      |
+| `ritardCurve`, `finisBoost` | how late it gathers; the piece's own last `::`     |
 | `tenor`                     | pull toward the reciting tone                      |
 | `baseVelocity`, `velSpread` | the velocity floor and the dynamic range above it  |
 | `contourVel`, `contourDur`  | melodic-contour influence on velocity and duration |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tonus",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "type": "module",
   "description": "Medieval music analysis: GABC plainchant exports, liturgical calendar, tuning systems, ephemeris, and the harmony of the spheres",
   "author": "Jeffrey Pierce <jeffrey@jeffreypierce.net>",