@sudobility/music_types 0.11.30 → 0.11.32

package/dist/domain/score/dynamics.js

@@ -0,0 +1,142 @@
+import { isNoteEvent } from "../../index.js";
+/**
+ * The velocity each marking sounds at, for a note carrying no deviation.
+ *
+ * The usual MIDI ladder, evenly spread so each step is audibly a step. `mf` is
+ * `DEFAULT_VELOCITY`, which is what makes an unmarked score unchanged.
+ */
+const DYNAMIC_VELOCITY = {
+    ppp: 16,
+    pp: 32,
+    p: 48,
+    mp: 64,
+    mf: 80,
+    f: 96,
+    ff: 112,
+    fff: 127,
+};
+/** The velocity a note is written at when nobody has said otherwise. */
+export const DEFAULT_VELOCITY = 80;
+export function velocityForDynamic(dynamic) {
+    return DYNAMIC_VELOCITY[dynamic];
+}
+/**
+ * The velocity a note actually sounds at under `dynamic`.
+ *
+ * `null` means no dynamic is in force, and the written velocity stands.
+ */
+export function effectiveVelocity(note, dynamic) {
+    if (!dynamic)
+        return note.velocity;
+    const deviation = note.velocity - DEFAULT_VELOCITY;
+    return Math.max(1, Math.min(127, velocityForDynamic(dynamic) + deviation));
+}
+/**
+ * Walks one voice's events in order, reporting the dynamic in force at each.
+ *
+ * Takes an already-ordered channel — the caller has sorted and joined ties —
+ * because "the next dynamic" only means anything in tick order.
+ */
+export function dynamicsInForce(events) {
+    const inForce = new Map();
+    let current = null;
+    for (const event of events) {
+        if (!isNoteEvent(event))
+            continue;
+        if (event.dynamic)
+            current = event.dynamic;
+        if (current)
+            inForce.set(event.id, current);
+    }
+    return inForce;
+}
+/**
+ * The velocity each note in a hairpin ramps to.
+ *
+ * A dynamic sets a level; a hairpin is the *change* between two of them, so
+ * the only honest way to sound one is to ramp. The span runs from the note
+ * carrying `hairpinStart` to the one carrying `hairpinStop`, and velocity
+ * moves linearly from the level in force at the opening to the level in force
+ * just **after** the close — which is how a player reads it: the wedge takes
+ * you to the next marking.
+ *
+ * **Where there is no next marking**, the wedge still has to arrive somewhere.
+ * A crescendo with nothing after it goes one dynamic step up from where it
+ * started, and a diminuendo one step down. That is what a player does with an
+ * unresolved hairpin, and it beats the alternatives: leaving it flat makes the
+ * marking silent, and ramping to full or to nothing turns an unmarked detail
+ * into the loudest or quietest thing in the piece.
+ *
+ * Returns an empty map for a score with no hairpin, so an unmarked passage
+ * costs one allocation and no arithmetic.
+ */
+export function hairpinVelocities(events, inForce) {
+    const ramped = new Map();
+    const notes = events.filter(isNoteEvent);
+    /** The velocity a note would sound at from its dynamic alone. */
+    const levelOf = (index) => {
+        const note = notes[index];
+        if (!note)
+            return DEFAULT_VELOCITY;
+        const dynamic = inForce.get(note.id);
+        return dynamic ? velocityForDynamic(dynamic) : DEFAULT_VELOCITY;
+    };
+    for (let i = 0; i < notes.length; i += 1) {
+        if (!notes[i].hairpinStart)
+            continue;
+        const kind = notes[i].hairpinStart;
+        let stop = -1;
+        for (let j = i; j < notes.length; j += 1) {
+            if (notes[j].hairpinStop) {
+                stop = j;
+                break;
+            }
+        }
+        // An unclosed opening ramps nowhere, matching what the renderer draws.
+        if (stop < 0)
+            break;
+        const from = levelOf(i);
+        const afterIndex = stop + 1;
+        const next = afterIndex < notes.length ? inForce.get(notes[afterIndex].id) : undefined;
+        const startDynamic = inForce.get(notes[i].id);
+        const to = next && next !== startDynamic
+            ? velocityForDynamic(next)
+            : stepFrom(from, kind === "crescendo" ? 1 : -1);
+        const span = stop - i;
+        for (let k = 0; k <= span; k += 1) {
+            const t = span === 0 ? 1 : k / span;
+            ramped.set(notes[i + k].id, Math.round(from + (to - from) * t));
+        }
+        i = stop;
+    }
+    return ramped;
+}
+/**
+ * One dynamic step from `velocity`, in `direction`.
+ *
+ * Used only where a hairpin has nothing to resolve to. Walks the ladder rather
+ * than adding a fixed number so the step is the same size a written marking
+ * would have been.
+ */
+function stepFrom(velocity, direction) {
+    const ladder = DYNAMIC_LADDER.map(velocityForDynamic);
+    const nearest = ladder.reduce((best, v) => Math.abs(v - velocity) < Math.abs(best - velocity) ? v : best);
+    const index = ladder.indexOf(nearest);
+    const target = ladder[Math.max(0, Math.min(ladder.length - 1, index + direction))];
+    // At the top of the ladder a crescendo still has to go somewhere.
+    return target === nearest
+        ? Math.max(1, Math.min(127, velocity + direction * 16))
+        : target;
+}
+/** Softest to loudest, for stepping one marking at a time. */
+const DYNAMIC_LADDER = [
+    "ppp",
+    "pp",
+    "p",
+    "mp",
+    "mf",
+    "f",
+    "ff",
+    "fff",
+];
+//# sourceMappingURL=dynamics.js.map

package/dist/domain/score/dynamics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamics.js","sourceRoot":"","sources":["../../../src/domain/score/dynamics.ts"],"names":[],"mappings":"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"}

package/dist/domain/score/effective-clef.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Which clef is in force at a given bar.
+ *
+ * `Measure.clef` stores only the *changes*, so almost every bar has none and
+ * the answer has to be looked back for. That shape is deliberate — see the
+ * field's own doc — but it means no consumer may read `measure.clef` directly
+ * and expect the truth. They all come here instead: the renderer to draw the
+ * stave, the hit test to turn a y coordinate into a pitch, the exporter to
+ * decide when to emit a `<clef>`.
+ *
+ * Keeping it in one function is what stops the notation and the note-entry
+ * geometry from disagreeing, which would place a clicked note on the line
+ * above or below the one under the pointer — a bug that looks like a rounding
+ * error and is not.
+ */
+import type { Clef, Measure, Track } from "../../index.js";
+/**
+ * The clef `measures[index]` is read in, given the track's own clef as the
+ * starting point.
+ *
+ * Walks back to the most recent change rather than forward from the start, so
+ * the common case — a track that never changes clef — costs one array read and
+ * a miss.
+ *
+ * An index outside the array answers the track clef, which is what an empty
+ * score and a caret past the last barline both need.
+ */
+export declare function clefAtMeasure(measures: readonly Measure[], index: number, trackClef: Clef): Clef;
+/** The clef in force at `index` on `track`. */
+export declare function effectiveClef(track: Track, index: number): Clef;
+/**
+ * Whether `index` is where the clef visibly changes — i.e. the first bar that
+ * reads in a different clef from the one before it.
+ *
+ * Bar 0 is never a change: it is where the clef is first *established*, and
+ * the renderer draws that as part of the system header rather than as a
+ * change. A `Measure.clef` equal to what was already in force is likewise not
+ * a change, so a redundant marking (which an import can produce) prints
+ * nothing.
+ */
+export declare function clefChangesAt(track: Track, index: number): boolean;
+//# sourceMappingURL=effective-clef.d.ts.map

package/dist/domain/score/effective-clef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-clef.d.ts","sourceRoot":"","sources":["../../../src/domain/score/effective-clef.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,IAAI,GACd,IAAI,CAMN;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAGlE"}

package/dist/domain/score/effective-clef.js

@@ -0,0 +1,39 @@
+/**
+ * The clef `measures[index]` is read in, given the track's own clef as the
+ * starting point.
+ *
+ * Walks back to the most recent change rather than forward from the start, so
+ * the common case — a track that never changes clef — costs one array read and
+ * a miss.
+ *
+ * An index outside the array answers the track clef, which is what an empty
+ * score and a caret past the last barline both need.
+ */
+export function clefAtMeasure(measures, index, trackClef) {
+    for (let i = Math.min(index, measures.length - 1); i >= 0; i -= 1) {
+        const clef = measures[i]?.clef;
+        if (clef)
+            return clef;
+    }
+    return trackClef;
+}
+/** The clef in force at `index` on `track`. */
+export function effectiveClef(track, index) {
+    return clefAtMeasure(track.measures, index, track.clef);
+}
+/**
+ * Whether `index` is where the clef visibly changes — i.e. the first bar that
+ * reads in a different clef from the one before it.
+ *
+ * Bar 0 is never a change: it is where the clef is first *established*, and
+ * the renderer draws that as part of the system header rather than as a
+ * change. A `Measure.clef` equal to what was already in force is likewise not
+ * a change, so a redundant marking (which an import can produce) prints
+ * nothing.
+ */
+export function clefChangesAt(track, index) {
+    if (index <= 0 || index >= track.measures.length)
+        return false;
+    return effectiveClef(track, index) !== effectiveClef(track, index - 1);
+}
+//# sourceMappingURL=effective-clef.js.map

package/dist/domain/score/effective-clef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-clef.js","sourceRoot":"","sources":["../../../src/domain/score/effective-clef.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA4B,EAC5B,KAAa,EACb,SAAe;IAEf,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QAC/B,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,KAAa;IACvD,OAAO,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,KAAa;IACvD,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AACzE,CAAC"}

package/dist/domain/score/extract-part.d.ts

@@ -0,0 +1,10 @@
+import type { Score } from "../../index.js";
+/**
+ * The part for `trackId`: that track alone, transposed for its instrument.
+ *
+ * Returns `null` when the track is not in the score, rather than an empty
+ * score — an empty part and a missing one are different problems, and only one
+ * of them is a bug.
+ */
+export declare function extractPart(score: Score, trackId: string): Score | null;
+//# sourceMappingURL=extract-part.d.ts.map

package/dist/domain/score/extract-part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-part.d.ts","sourceRoot":"","sources":["../../../src/domain/score/extract-part.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAsBvE"}

package/dist/domain/score/extract-part.js

@@ -0,0 +1,44 @@
+/**
+ * A single track, written the way its player reads it.
+ *
+ * **Print-only.** The returned score is never saved, never played and never
+ * edited — it is a notation of the music, not the music. Playback uses
+ * sounding pitch, and routing this into it would make a trumpet sound a tone
+ * sharp.
+ *
+ * Features 3 to 5 extend this same function with multi-measure rests,
+ * rehearsal marks and cue notes, which is why part extraction lives in one
+ * place rather than four.
+ */
+import { trackWrittenTransposition } from "../instruments/track-instrument.js";
+import { collapseRests } from "./collapse-rests.js";
+import { applyRehearsalMarks, rehearsalMarks } from "./rehearsal-marks.js";
+import { applyCues, measureCues } from "./cue-notes.js";
+import { transposeMeasure } from "./written-pitch.js";
+/**
+ * The part for `trackId`: that track alone, transposed for its instrument.
+ *
+ * Returns `null` when the track is not in the score, rather than an empty
+ * score — an empty part and a missing one are different problems, and only one
+ * of them is a bug.
+ */
+export function extractPart(score, trackId) {
+    const track = score.tracks.find((t) => t.id === trackId);
+    if (!track)
+        return null;
+    // Cues first, at concert pitch: chosen from the other tracks as they sound,
+    // then carried through the transposition below into the player's own key.
+    const cued = applyCues(track.measures, measureCues(score, trackId));
+    const semitones = trackWrittenTransposition(track);
+    const written = semitones === 0
+        ? cued
+        : cued.map((measure) => transposeMeasure(measure, semitones));
+    // Marks come from the WHOLE score, not this track: "from B" has to mean the
+    // same bar in every part, and a per-track derivation would give each player
+    // different letters.
+    const marked = applyRehearsalMarks(written, rehearsalMarks(score));
+    // Collapse last. Marks and cues must already be on: both end a rest run, and
+    // either one hidden inside a multi-measure rest would point at nothing.
+    return { ...score, tracks: [{ ...track, measures: collapseRests(marked) }] };
+}
+//# sourceMappingURL=extract-part.js.map

package/dist/domain/score/extract-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-part.js","sourceRoot":"","sources":["../../../src/domain/score/extract-part.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAe;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GACX,SAAS,KAAK,CAAC;QACb,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAElE,4EAA4E;IAC5E,4EAA4E;IAC5E,qBAAqB;IACrB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnE,6EAA6E;IAC7E,wEAAwE;IACxE,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/domain/score/factory.d.ts

@@ -1,4 +1,4 @@
-import type { KeySignature, Score, TimeSignature, Track } from '../../index.js';
+import type { KeySignature, Score, TimeSignature, Track } from "../../index.js";
 export type CreateTrackOptions = Partial<Track> & {
     name: string;
 };

package/dist/domain/score/factory.js

@@ -1,20 +1,20 @@
-import { createId } from './ids.js';
-import { measureDurationTicks } from '../time/ticks.js';
+import { createId } from "./ids.js";
+import { measureDurationTicks } from "../time/ticks.js";
 const DEFAULT_PPQ = 480;
 const DEFAULT_TEMPO_BPM = 120;
 const DEFAULT_TIME_SIGNATURE = { numerator: 4, denominator: 4 };
-const DEFAULT_KEY_SIGNATURE = { fifths: 0, mode: 'major' };
+const DEFAULT_KEY_SIGNATURE = { fifths: 0, mode: "major" };
 const DEFAULT_MEASURE_COUNT = 1;
-const DEFAULT_VOICE_NAME = 'Voice 1';
+const DEFAULT_VOICE_NAME = "Voice 1";
 /** Builds a `Track` with sensible defaults, overridden by any fields in `opts`. */
 export function createTrack(opts) {
     return {
         id: opts.id ?? createId(),
         name: opts.name,
-        instrumentName: opts.instrumentName ?? 'Piano',
+        instrumentName: opts.instrumentName ?? "Piano",
         midiProgram: opts.midiProgram ?? 0,
         midiChannel: opts.midiChannel ?? 0,
-        clef: opts.clef ?? 'treble',
+        clef: opts.clef ?? "treble",
         volume: opts.volume ?? 1,
         pan: opts.pan ?? 0,
         muted: opts.muted ?? false,
@@ -63,9 +63,9 @@ export function createEmptyScore(opts) {
     const keySignature = opts.keySignature ?? DEFAULT_KEY_SIGNATURE;
     const measureCount = opts.measures ?? DEFAULT_MEASURE_COUNT;
     const trackOptions = opts.tracks ?? [
-        { name: 'Piano', instrumentName: 'Piano', clef: 'treble' },
+        { name: "Piano", instrumentName: "Piano", clef: "treble" },
     ];
-    const tracks = trackOptions.map(trackOpts => {
+    const tracks = trackOptions.map((trackOpts) => {
         const track = createTrack(trackOpts);
         return {
             ...track,
@@ -95,7 +95,7 @@ export function createEmptyScore(opts) {
  * (falling back to 4/4 C major for a track with no existing measures).
  */
 export function appendMeasure(score) {
-    const tracks = score.tracks.map(track => {
+    const tracks = score.tracks.map((track) => {
         const lastMeasure = track.measures[track.measures.length - 1];
         const timeSignature = lastMeasure?.timeSignature ?? DEFAULT_TIME_SIGNATURE;
         const keySignature = lastMeasure?.keySignature ?? DEFAULT_KEY_SIGNATURE;
@@ -121,7 +121,7 @@ export function appendMeasure(score) {
  * (referentially equal) so unaffected structure is preserved.
  */
 export function rebuildMeasureTicks(score) {
-    const tracks = score.tracks.map(track => {
+    const tracks = score.tracks.map((track) => {
         let cursor = 0;
         const measures = track.measures.map((measure, index) => {
             const startTick = cursor;
@@ -132,9 +132,9 @@ export function rebuildMeasureTicks(score) {
             }
             const voices = delta === 0
                 ? measure.voices
-                : measure.voices.map(voice => ({
+                : measure.voices.map((voice) => ({
                     ...voice,
-                    events: voice.events.map(event => ({
+                    events: voice.events.map((event) => ({
                         ...event,
                         startTick: event.startTick + delta,
                     })),

package/dist/domain/score/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/domain/score/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/domain/score/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AASpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,sBAAsB,GAAkB,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC/E,MAAM,qBAAqB,GAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzE,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAChC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAIrC,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,QAAQ,EAAE;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,OAAO;QAC9C,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;QAClC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;QACxB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK;QAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,gBAAgB,CACvB,KAAa,EACb,SAAiB,EACjB,aAA4B,EAC5B,YAA0B,EAC1B,aAAqB,EACrB,OAAe;IAEf,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;IAC3B,OAAO;QACL,EAAE,EAAE,QAAQ,EAAE;QACd,KAAK;QACL,SAAS;QACT,aAAa;QACb,aAAa;QACb,YAAY;QACZ,MAAM,EAAE;YACN;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE;oBACN,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE;iBAC/D;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,aAAa,CACpB,KAAa,EACb,aAA4B,EAC5B,YAA0B,EAC1B,GAAW,EACX,OAAe;IAEf,MAAM,aAAa,GAAG,oBAAoB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CACX,gBAAgB,CACd,KAAK,EACL,KAAK,GAAG,aAAa,EACrB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAYD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,qBAAqB,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,IAAI;QAClC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,QAAiB,EAAE;KACpE,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO;YACL,GAAG,KAAK;YACR,QAAQ,EAAE,aAAa,CACrB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,GAAG,EACH,KAAK,CAAC,EAAE,CACT;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAkB;QAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,QAAQ,EAAE;QACd,OAAO,EAAE,CAAC;QACV,GAAG;QACH,QAAQ;QACR,QAAQ,EAAE;YACR,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,iBAAiB,EAAE;SAClE;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CACvC,CAAC;QACtB,MAAM,aAAa,GAAG,WAAW,EAAE,aAAa,IAAI,sBAAsB,CAAC;QAC3E,MAAM,YAAY,GAAG,WAAW,EAAE,YAAY,IAAI,qBAAqB,CAAC;QACxE,MAAM,aAAa,GAAG,oBAAoB,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,WAAW;YAC3B,CAAC,CAAC,WAAW,CAAC,SAAS,GAAG,WAAW,CAAC,aAAa;YACnD,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,UAAU,GAAG,gBAAgB,CACjC,KAAK,CAAC,QAAQ,CAAC,MAAM,EACrB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,CAAC,EAAE,CACT,CAAC;QACF,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,KAAK;QACR,MAAM;QACN,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;KACrE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxC,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YACrD,MAAM,SAAS,GAAG,MAAM,CAAC;YACzB,MAAM,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YAC5C,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;YAEhC,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC3C,OAAO,OAAO,CAAC;YACjB,CAAC;YAED,MAAM,MAAM,GACV,KAAK,KAAK,CAAC;gBACT,CAAC,CAAC,OAAO,CAAC,MAAM;gBAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC7B,GAAG,KAAK;oBACR,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBACnC,GAAG,KAAK;wBACR,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK;qBACnC,CAAC,CAAC;iBACJ,CAAC,CAAC,CAAC;YAEV,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/domain/score/fermata-tempo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Making a fermata audible, as a local slowing rather than a longer note.
+ *
+ * A pause holds a note and delays everything after it. The obvious model —
+ * stretch the note and shift the rest — is the wrong one here, because the
+ * score tick *is* the playback tick: the caret, the following-scroll, "play
+ * from here" and the position scrubber all rest on that identity, and moving
+ * notes in time would break every one of them.
+ *
+ * A tempo dip changes none of it. The notes keep their written ticks; the
+ * ticks simply take longer to elapse across the held note, which is what a
+ * fermata means to a player anyway — the beat stretches, the notation does
+ * not. **And it is the reason the caret needed no work at all**: it
+ * dead-reckons between position reports through a `TempoMap`, so a map that
+ * slows down slows the caret down with it. Building the caret's map from
+ * anything else would make it glide past the pause and snap back, which is
+ * exactly the class of bug its interpolation exists to avoid.
+ *
+ * So this is the single derivation, and `playbackPlan`, `renderEvents` and the
+ * caret all read it. Live playback, the exported audio file and the thing on
+ * screen therefore cannot disagree about how long a pause lasts.
+ *
+ * A score with no fermata returns its own `tempoMap` array **unchanged, by
+ * identity**, so nothing about an unmarked score's playback is even
+ * recomputed.
+ */
+import type { Score, TempoEvent } from "../../index.js";
+/**
+ * `score.tempoMap` with a slowing written across every held span.
+ *
+ * Two events per span: one entering it at the reduced tempo, one leaving it
+ * that restores whatever was in force at that point. The restoring event reads
+ * the tempo from the *original* map, so a tempo change that happens to fall
+ * inside a pause is still honoured on the way out rather than being flattened
+ * to whatever the pause started at.
+ *
+ * Returns the score's own array by identity when nothing is held.
+ */
+export declare function fermataTempoMap(score: Score): TempoEvent[];
+//# sourceMappingURL=fermata-tempo.d.ts.map

package/dist/domain/score/fermata-tempo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fermata-tempo.d.ts","sourceRoot":"","sources":["../../../src/domain/score/fermata-tempo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAa,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA8DnE;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,CA2B1D"}

package/dist/domain/score/fermata-tempo.js

@@ -0,0 +1,95 @@
+import { isNoteEvent } from "../../index.js";
+import { createId } from "./ids.js";
+import { TempoMap } from "../time/tempo-map.js";
+/**
+ * How much longer a held note lasts than its written value.
+ *
+ * Two is the conventional reading and the one most notation software uses. It
+ * is deliberately not configurable per fermata: how long to hold is the
+ * performer's judgement, and a score that recorded a number would be claiming
+ * an authority the marking does not have.
+ */
+const HOLD_FACTOR = 2;
+/**
+ * Every span a fermata holds, merged into non-overlapping runs.
+ *
+ * A fermata is observed by the whole ensemble at once, so overlapping spans
+ * are one pause. Merging is not about compounding — each span reads its
+ * reduced tempo from the *original* map, so two identical spans produce the
+ * same slowing twice and cancel out harmlessly. It is about spans of
+ * **different lengths**: a quarter note held in one part and a whole note held
+ * in another both start the pause, but without merging the quarter's restoring
+ * event lands in the middle of the whole note's hold and cuts it short. The
+ * players wait for each other; the pause ends when the longest one ends.
+ */
+function holdSpans(score) {
+    const spans = [];
+    for (const track of score.tracks) {
+        for (const measure of track.measures) {
+            for (const voice of measure.voices) {
+                for (const event of voice.events) {
+                    if (!isNoteEvent(event))
+                        continue;
+                    const note = event;
+                    if (!note.fermata)
+                        continue;
+                    spans.push({
+                        start: note.startTick,
+                        end: note.startTick + note.durationTicks,
+                    });
+                }
+            }
+        }
+    }
+    if (spans.length === 0)
+        return spans;
+    spans.sort((a, b) => a.start - b.start || a.end - b.end);
+    const merged = [spans[0]];
+    for (const span of spans.slice(1)) {
+        const last = merged[merged.length - 1];
+        if (span.start <= last.end) {
+            last.end = Math.max(last.end, span.end);
+        }
+        else {
+            merged.push(span);
+        }
+    }
+    return merged;
+}
+/**
+ * `score.tempoMap` with a slowing written across every held span.
+ *
+ * Two events per span: one entering it at the reduced tempo, one leaving it
+ * that restores whatever was in force at that point. The restoring event reads
+ * the tempo from the *original* map, so a tempo change that happens to fall
+ * inside a pause is still honoured on the way out rather than being flattened
+ * to whatever the pause started at.
+ *
+ * Returns the score's own array by identity when nothing is held.
+ */
+export function fermataTempoMap(score) {
+    const spans = holdSpans(score);
+    if (spans.length === 0)
+        return score.tempoMap;
+    const source = new TempoMap(score.tempoMap, score.ppq);
+    const added = [];
+    for (const span of spans) {
+        if (span.end <= span.start)
+            continue;
+        added.push({
+            id: createId(),
+            tick: span.start,
+            bpm: source.bpmAt(span.start) / HOLD_FACTOR,
+        });
+        added.push({
+            id: createId(),
+            tick: span.end,
+            bpm: source.bpmAt(span.end),
+        });
+    }
+    // The added events win at a tick an original also sits on: a starting tempo
+    // written at the same beat as a pause still has to be paused through.
+    const kept = score.tempoMap.filter((event) => !added.some((a) => a.tick === event.tick));
+    return [...kept, ...added].sort((a, b) => a.tick - b.tick);
+}
+//# sourceMappingURL=fermata-tempo.js.map

package/dist/domain/score/fermata-tempo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fermata-tempo.js","sourceRoot":"","sources":["../../../src/domain/score/fermata-tempo.ts"],"names":[],"mappings":"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"}

package/dist/domain/score/flatten.d.ts

@@ -0,0 +1,32 @@
+import type { MusicalEvent, Score, Track } from "../../index.js";
+/**
+ * One sounding note, in score ticks, with the ids it came from.
+ *
+ * Structurally `PlaybackNote` in music_types, which is what the engine takes —
+ * so a `FlatNote[]` is assignable to it with no mapping step. Declared here
+ * rather than imported because this is domain data: a note the score sounds,
+ * independent of who is going to play it.
+ */
+export type FlatNote = {
+    tick: number;
+    durTicks: number;
+    midi: number;
+    /** As stored on the event, 0-127. Callers that want 0..1 divide. */
+    velocity: number;
+    trackId: string;
+    noteId: string;
+};
+/**
+ * Every voice-ordinal channel of a track: across all measures in tick order,
+ * the events at that ordinal position.
+ *
+ * Voice ids are not stable across a barline, so the ordinal stands in for "the
+ * same voice" from bar to bar — which is what lets `joinTiedNotes` see a tie
+ * that crosses one. `ties.ts` exports a `voiceChannel`, but that takes a single
+ * ordinal and returns measure-annotated notes for tie-*partner* lookup, where
+ * this needs every ordinal at once with rests included.
+ */
+export declare function trackVoiceChannels(track: Track): MusicalEvent[][];
+/** Every note the score sounds, ties joined, in tick order. */
+export declare function flattenScoreNotes(score: Score): FlatNote[];
+//# sourceMappingURL=flatten.d.ts.map

package/dist/domain/score/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../src/domain/score/flatten.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIjE;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,EAAE,CAgBjE;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,CA8F1D"}