@sudobility/music_types 0.11.19 → 0.11.21

package/dist/domain/score/queries.js

@@ -0,0 +1,132 @@
+import { isNoteEvent } from '../../index.js';
+import { pitchToMidi } from '../pitch/pitch.js';
+/** Finds a track by id, or `null` if no track has that id. */
+export function findTrack(score, trackId) {
+    return score.tracks.find(track => track.id === trackId) ?? null;
+}
+/** Finds a measure by id across all tracks, or `null` if none has that id. */
+export function findMeasure(score, measureId) {
+    for (const track of score.tracks) {
+        const measure = track.measures.find(m => m.id === measureId);
+        if (measure)
+            return measure;
+    }
+    return null;
+}
+/** Finds an event (note or rest) by id across all tracks/measures/voices, or `null`. */
+export function findEvent(score, eventId) {
+    for (const track of score.tracks) {
+        for (const measure of track.measures) {
+            for (const voice of measure.voices) {
+                const event = voice.events.find(e => e.id === eventId);
+                if (event)
+                    return event;
+            }
+        }
+    }
+    return null;
+}
+/** Whether track `trackId` is included by a range's `trackIds` (empty array means "all tracks"). */
+function rangeIncludesTrack(range, trackId) {
+    return range.trackIds.length === 0 || range.trackIds.includes(trackId);
+}
+/** Whether `[startTick, startTick + durationTicks)` overlaps `[range.startTick, range.endTick)`. */
+function overlapsRange(startTick, durationTicks, range) {
+    return (startTick < range.endTick && startTick + durationTicks > range.startTick);
+}
+/** All note events (rests excluded) on the requested tracks overlapping the tick range. */
+export function eventsInRange(score, range) {
+    const result = [];
+    for (const track of score.tracks) {
+        if (!rangeIncludesTrack(range, track.id))
+            continue;
+        for (const measure of track.measures) {
+            for (const voice of measure.voices) {
+                for (const event of voice.events) {
+                    if (isNoteEvent(event) &&
+                        overlapsRange(event.startTick, event.durationTicks, range)) {
+                        result.push(event);
+                    }
+                }
+            }
+        }
+    }
+    return result;
+}
+/** Measures overlapping the tick range, grouped by track. */
+export function measuresInRange(score, range) {
+    const result = [];
+    for (const track of score.tracks) {
+        if (!rangeIncludesTrack(range, track.id))
+            continue;
+        const measures = track.measures.filter(m => overlapsRange(m.startTick, m.durationTicks, range));
+        result.push({ trackId: track.id, measures });
+    }
+    return result;
+}
+/**
+ * Finds a note event on `trackId` whose span covers `tick`
+ * (`startTick <= tick < startTick + durationTicks`), optionally also
+ * matching a specific MIDI pitch. Returns `null` if none match.
+ */
+export function noteAt(score, trackId, tick, midi) {
+    const track = findTrack(score, trackId);
+    if (!track)
+        return null;
+    for (const measure of track.measures) {
+        for (const voice of measure.voices) {
+            for (const event of voice.events) {
+                if (!isNoteEvent(event))
+                    continue;
+                if (tick < event.startTick ||
+                    tick >= event.startTick + event.durationTicks)
+                    continue;
+                if (midi !== undefined && pitchToMidi(event.pitch) !== midi)
+                    continue;
+                return event;
+            }
+        }
+    }
+    return null;
+}
+/** The tick at which the score's last measure (across all tracks) ends; 0 if there are none. */
+export function scoreEndTick(score) {
+    let end = 0;
+    for (const track of score.tracks) {
+        const lastMeasure = track.measures[track.measures.length - 1];
+        if (lastMeasure) {
+            end = Math.max(end, lastMeasure.startTick + lastMeasure.durationTicks);
+        }
+    }
+    return end;
+}
+/** All note events (rests excluded) across every track/measure/voice. */
+export function allNotes(score) {
+    const notes = [];
+    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))
+                        notes.push(event);
+                }
+            }
+        }
+    }
+    return notes;
+}
+/**
+ * `score` with only the named tracks, in score order.
+ *
+ * Returns `score` itself when `trackIds` names every track, so the common
+ * "nothing is hidden" export path costs nothing. Kept tracks are returned by
+ * reference — this filters, it never rewrites the music.
+ */
+export function scoreWithTracks(score, trackIds) {
+    const wanted = new Set(trackIds);
+    const tracks = score.tracks.filter(track => wanted.has(track.id));
+    if (tracks.length === score.tracks.length)
+        return score;
+    return { ...score, tracks };
+}
+//# sourceMappingURL=queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/domain/score/queries.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,OAAa;IACnD,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,SAAe;IACvD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QAC7D,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,OAAa;IACnD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;gBACvD,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,SAAS,kBAAkB,CAAC,KAAiB,EAAE,OAAa;IAC1D,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,oGAAoG;AACpG,SAAS,aAAa,CACpB,SAAiB,EACjB,aAAqB,EACrB,KAAiB;IAEjB,OAAO,CACL,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,SAAS,GAAG,aAAa,GAAG,KAAK,CAAC,SAAS,CACzE,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,KAAiB;IAC3D,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAAE,SAAS;QACnD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,IACE,WAAW,CAAC,KAAK,CAAC;wBAClB,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,EAC1D,CAAC;wBACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,KAAiB;IAEjB,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;YAAE,SAAS;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACzC,aAAa,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,aAAa,EAAE,KAAK,CAAC,CACnD,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACpB,KAAY,EACZ,OAAa,EACb,IAAY,EACZ,IAAa;IAEb,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAClC,IACE,IAAI,GAAG,KAAK,CAAC,SAAS;oBACtB,IAAI,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa;oBAE7C,SAAS;gBACX,IAAI,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;oBAAE,SAAS;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,WAAW,EAAE,CAAC;YAChB,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,QAAQ,CAAC,KAAY;IACnC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,IAAI,WAAW,CAAC,KAAK,CAAC;wBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,QAAkB;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,73 @@
+import type { MusicalEvent, NoteEvent, Score, Track, UUID } from '../../index.js';
+/**
+ * Splits a note at every measure boundary that falls strictly inside its
+ * span, returning contiguous tied segments that together cover the
+ * original note. The first segment keeps the original id and any incoming
+ * tie (`tieStop`); the last keeps any outgoing tie (`tieStart`); segments
+ * in between are tied on both sides. Returns `[note]` unchanged if no
+ * boundary falls inside its span.
+ *
+ * Every returned segment inherits `note`'s `voiceId`/`trackId` verbatim.
+ * This function has no `Score`/`Measure` context, so it cannot know which
+ * voice a later segment will actually land in once inserted into the
+ * score — the caller (which does have that context) is responsible for
+ * reassigning each segment's `voiceId` to its destination measure's voice
+ * before/while inserting it (the same normalization `fragment.ts`'s
+ * `replaceFragment` performs).
+ */
+export declare function splitNoteAcrossMeasures(note: NoteEvent, measureBoundaries: number[]): NoteEvent[];
+/**
+ * Merges runs of contiguous, same-pitch, tie-linked note events into single
+ * notes spanning the combined duration. Partners are matched by
+ * `(startTick, pitch, tie flags)`, not raw array adjacency, so tied chord
+ * members can be joined even when another chord member sits between them.
+ * Rests and non-tied notes pass through unchanged. Assumes `events` are
+ * already in ascending `startTick` order (e.g. one voice's events).
+ */
+export declare function joinTiedNotes(events: MusicalEvent[]): MusicalEvent[];
+/** A note event annotated with the index (within its track) of the measure it came from. */
+export type ChannelCandidate = {
+    event: NoteEvent;
+    measureIndex: number;
+};
+/**
+ * Every note event from the voice at ordinal position `voiceIndex` in
+ * each of `track`'s measures (a measure with no voice at that index
+ * contributes nothing), in measure/tick order. This is the "channel" a
+ * tie chain is searched within.
+ *
+ * Voice ids are freshly generated per measure and so are not stable
+ * across a barline (spec §25 permits per-measure voice reallocation), so
+ * they can't be used to correlate "the same voice" from one measure to
+ * the next. A voice's *ordinal position* in `measure.voices` is used as
+ * a stand-in instead — a deliberate, documented approximation, not a
+ * guarantee that voice N in one measure is musically continuous with
+ * voice N in the next.
+ *
+ * Exported (Task 17) so `validation/validator.ts`'s `checkTieTargets` can
+ * build each track/voice-ordinal channel once and index it for O(1)-average
+ * partner lookups, instead of paying for a fresh `tieChainFor` walk (which
+ * itself rebuilds a channel from scratch) per tied note — see that
+ * function's doc comment for the super-linear-worst-case history.
+ */
+export declare function voiceChannel(track: Track, voiceIndex: number): ChannelCandidate[];
+/**
+ * Returns the full chain of tied note events (in tick order) that `noteId`
+ * belongs to, searching across all of its track's measures. A chain may
+ * span measure boundaries. Returns `[]` if `noteId` does not exist or is
+ * not a note event; returns a single-element array for a note with no
+ * ties.
+ *
+ * Chain membership is searched only within the target's own "voice
+ * channel" (`voiceChannel`, above — the voice at the same ordinal
+ * position across every measure of the track), never across voices. This
+ * matters once a measure has more than one voice (spec §25 voice
+ * allocation): searching across all voices indiscriminately would let a
+ * coincidental same-pitch, tie-flagged note in an unrelated voice at a
+ * barline get spliced into the chain, or shadow the true partner when
+ * both share the same tick. Within the channel, a partner is found by
+ * explicit (tick, pitch, tie-flag) matching, not raw array adjacency, for
+ * the same reason.
+ */
+export declare function tieChainFor(score: Score, noteId: UUID): NoteEvent[];
+//# sourceMappingURL=ties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ties.d.ts","sourceRoot":"","sources":["../../../src/domain/score/ties.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAET,KAAK,EACL,KAAK,EACL,IAAI,EACL,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,EACf,iBAAiB,EAAE,MAAM,EAAE,GAC1B,SAAS,EAAE,CAsBb;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAmCpE;AAED,4FAA4F;AAC5F,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,GACjB,gBAAgB,EAAE,CAcpB;AAqCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,SAAS,EAAE,CA8BnE"}

package/dist/domain/score/ties.js

@@ -0,0 +1,200 @@
+import { createId } from './ids.js';
+import { findEvent, findTrack } from './queries.js';
+import { isNoteEvent } from '../../index.js';
+import { splitAtBoundaries } from '../time/durations.js';
+/** Whether two pitches have identical spelling (step, accidental, and octave). */
+function samePitch(a, b) {
+    return (a.step === b.step && a.accidental === b.accidental && a.octave === b.octave);
+}
+/**
+ * Splits a note at every measure boundary that falls strictly inside its
+ * span, returning contiguous tied segments that together cover the
+ * original note. The first segment keeps the original id and any incoming
+ * tie (`tieStop`); the last keeps any outgoing tie (`tieStart`); segments
+ * in between are tied on both sides. Returns `[note]` unchanged if no
+ * boundary falls inside its span.
+ *
+ * Every returned segment inherits `note`'s `voiceId`/`trackId` verbatim.
+ * This function has no `Score`/`Measure` context, so it cannot know which
+ * voice a later segment will actually land in once inserted into the
+ * score — the caller (which does have that context) is responsible for
+ * reassigning each segment's `voiceId` to its destination measure's voice
+ * before/while inserting it (the same normalization `fragment.ts`'s
+ * `replaceFragment` performs).
+ */
+export function splitNoteAcrossMeasures(note, measureBoundaries) {
+    const segments = splitAtBoundaries(note.startTick, note.durationTicks, measureBoundaries);
+    if (segments.length <= 1) {
+        return [note];
+    }
+    return segments.map((segment, i) => {
+        const isFirst = i === 0;
+        const isLast = i === segments.length - 1;
+        return {
+            ...note,
+            id: isFirst ? note.id : createId(),
+            startTick: segment.startTick,
+            durationTicks: segment.durationTicks,
+            tieStart: isLast ? note.tieStart : true,
+            tieStop: isFirst ? note.tieStop : true,
+        };
+    });
+}
+/**
+ * Merges runs of contiguous, same-pitch, tie-linked note events into single
+ * notes spanning the combined duration. Partners are matched by
+ * `(startTick, pitch, tie flags)`, not raw array adjacency, so tied chord
+ * members can be joined even when another chord member sits between them.
+ * Rests and non-tied notes pass through unchanged. Assumes `events` are
+ * already in ascending `startTick` order (e.g. one voice's events).
+ */
+export function joinTiedNotes(events) {
+    const result = [];
+    const consumed = new Set();
+    for (const event of events) {
+        if (consumed.has(event.id))
+            continue;
+        if (!isNoteEvent(event) || !event.tieStart) {
+            result.push(event);
+            continue;
+        }
+        let merged = event;
+        consumed.add(event.id);
+        while (merged.tieStart) {
+            const next = events.find((candidate) => !consumed.has(candidate.id) &&
+                isNoteEvent(candidate) &&
+                Boolean(candidate.tieStop) &&
+                candidate.startTick === merged.startTick + merged.durationTicks &&
+                samePitch(candidate.pitch, merged.pitch));
+            if (!next)
+                break;
+            consumed.add(next.id);
+            merged = {
+                ...merged,
+                durationTicks: merged.durationTicks + next.durationTicks,
+                tieStart: next.tieStart,
+            };
+        }
+        result.push(merged);
+    }
+    return result;
+}
+/**
+ * The ordinal index (position within `measure.voices`) of the voice
+ * containing `noteId`, searching every measure of `track` in order.
+ * Returns -1 if `noteId` isn't found in any voice of this track.
+ */
+function locateVoiceIndex(track, noteId) {
+    for (const measure of track.measures) {
+        const voiceIndex = measure.voices.findIndex(voice => voice.events.some(e => e.id === noteId));
+        if (voiceIndex !== -1)
+            return voiceIndex;
+    }
+    return -1;
+}
+/**
+ * Every note event from the voice at ordinal position `voiceIndex` in
+ * each of `track`'s measures (a measure with no voice at that index
+ * contributes nothing), in measure/tick order. This is the "channel" a
+ * tie chain is searched within.
+ *
+ * Voice ids are freshly generated per measure and so are not stable
+ * across a barline (spec §25 permits per-measure voice reallocation), so
+ * they can't be used to correlate "the same voice" from one measure to
+ * the next. A voice's *ordinal position* in `measure.voices` is used as
+ * a stand-in instead — a deliberate, documented approximation, not a
+ * guarantee that voice N in one measure is musically continuous with
+ * voice N in the next.
+ *
+ * Exported (Task 17) so `validation/validator.ts`'s `checkTieTargets` can
+ * build each track/voice-ordinal channel once and index it for O(1)-average
+ * partner lookups, instead of paying for a fresh `tieChainFor` walk (which
+ * itself rebuilds a channel from scratch) per tied note — see that
+ * function's doc comment for the super-linear-worst-case history.
+ */
+export function voiceChannel(track, voiceIndex) {
+    const channel = [];
+    track.measures.forEach((measure, measureIndex) => {
+        const voice = measure.voices[voiceIndex];
+        if (!voice)
+            return;
+        for (const event of voice.events) {
+            if (isNoteEvent(event))
+                channel.push({ event, measureIndex });
+        }
+    });
+    channel.sort((a, b) => a.measureIndex - b.measureIndex || a.event.startTick - b.event.startTick);
+    return channel;
+}
+/**
+ * The note in `channel` that `note` ties into (its `tieStart` partner),
+ * found by explicit (tick, pitch, tie-flag) matching — never by array
+ * adjacency, so an unrelated same-tick note (e.g. a coincidental chord
+ * tone sharing `note`'s channel) can't be picked up by accident.
+ */
+function findForwardPartner(channel, note) {
+    if (!note.tieStart)
+        return undefined;
+    return channel.find(c => c.event.id !== note.id &&
+        c.event.startTick === note.startTick + note.durationTicks &&
+        Boolean(c.event.tieStop) &&
+        samePitch(c.event.pitch, note.pitch))?.event;
+}
+/** The note in `channel` that ties into `note` (its `tieStop` partner); see `findForwardPartner`. */
+function findBackwardPartner(channel, note) {
+    if (!note.tieStop)
+        return undefined;
+    return channel.find(c => c.event.id !== note.id &&
+        c.event.startTick + c.event.durationTicks === note.startTick &&
+        Boolean(c.event.tieStart) &&
+        samePitch(c.event.pitch, note.pitch))?.event;
+}
+/**
+ * Returns the full chain of tied note events (in tick order) that `noteId`
+ * belongs to, searching across all of its track's measures. A chain may
+ * span measure boundaries. Returns `[]` if `noteId` does not exist or is
+ * not a note event; returns a single-element array for a note with no
+ * ties.
+ *
+ * Chain membership is searched only within the target's own "voice
+ * channel" (`voiceChannel`, above — the voice at the same ordinal
+ * position across every measure of the track), never across voices. This
+ * matters once a measure has more than one voice (spec §25 voice
+ * allocation): searching across all voices indiscriminately would let a
+ * coincidental same-pitch, tie-flagged note in an unrelated voice at a
+ * barline get spliced into the chain, or shadow the true partner when
+ * both share the same tick. Within the channel, a partner is found by
+ * explicit (tick, pitch, tie-flag) matching, not raw array adjacency, for
+ * the same reason.
+ */
+export function tieChainFor(score, noteId) {
+    const target = findEvent(score, noteId);
+    if (!target || !isNoteEvent(target))
+        return [];
+    const track = findTrack(score, target.trackId);
+    if (!track)
+        return [target];
+    const voiceIndex = locateVoiceIndex(track, target.id);
+    if (voiceIndex === -1)
+        return [target];
+    const channel = voiceChannel(track, voiceIndex);
+    const chain = [target];
+    let current = target;
+    for (let guard = 0; guard < channel.length; guard += 1) {
+        const partner = findBackwardPartner(channel, current);
+        if (!partner)
+            break;
+        chain.unshift(partner);
+        current = partner;
+    }
+    current = target;
+    for (let guard = 0; guard < channel.length; guard += 1) {
+        const partner = findForwardPartner(channel, current);
+        if (!partner)
+            break;
+        chain.push(partner);
+        current = partner;
+    }
+    return chain;
+}
+//# sourceMappingURL=ties.js.map

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

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

package/dist/domain/selection/selection.d.ts

@@ -0,0 +1,63 @@
+import type { Score } from '../../index.js';
+import type { ScoreRange, ScoreSelection } from './types.js';
+/**
+ * The smallest tick range, aligned to full-measure boundaries on every
+ * implicated track, that covers everything named by `sel` (selected
+ * events, measures, an explicit `range`, and/or `trackIds`). Returns
+ * `null` when the selection carries no tick information at all (no
+ * resolvable events, no resolvable measures, and no `range`) — a bare
+ * `trackIds` selection has no timeline extent to convert.
+ *
+ * Track scope for the result is the union of: `sel.trackIds`, the owning
+ * track of every resolved event/measure, and `sel.range?.trackIds`. An
+ * id that doesn't resolve to anything in `score` (stale selection) is
+ * simply skipped when gathering tick anchors, but is still carried
+ * through into the result's `trackIds` (see `selectionIsRegenerable`,
+ * which treats that as a disqualifying condition).
+ */
+export declare function selectionToRange(score: Score, sel: ScoreSelection): ScoreRange | null;
+/**
+ * Returns a selection with: duplicate ids removed; event/measure/track ids
+ * that no longer resolve in `score` dropped (a stale reference left over
+ * from an edit that deleted the selected object); and, if present, `range`
+ * normalized (its own `trackIds` deduplicated, and `startTick`/`endTick`
+ * swapped into ascending order if given reversed).
+ */
+export declare function normalizeSelection(score: Score, sel: ScoreSelection): ScoreSelection;
+/**
+ * Whether `sel` can be converted (via `selectionToRange`) into a valid
+ * regeneration region: a non-empty, nonnegative tick span that doesn't
+ * extend past the end of the score, on tracks that all actually exist.
+ */
+export declare function selectionIsRegenerable(score: Score, sel: ScoreSelection): boolean;
+/**
+ * A short, human-readable summary of what's selected (e.g. "3 note(s)
+ * selected"), checked in the same priority order `selectionToRange`
+ * resolves tick anchors in (events, then measures, then bare tracks).
+ * Spec §27: screen-reader text summarizing the current selection, shared
+ * between `AppLayout`'s status bar and the score-editor/piano-roll
+ * containers' own SR-only summaries (`ScoreEditorView`/`PianoRollView`) so
+ * all three always agree on the same wording.
+ *
+ * `regenerated` appends ", regenerated". Note state is carried by color
+ * alone on the canvas now (the highlight overlay's solid/dashed/dotted
+ * stroke patterns went away with it), so this label is the non-color
+ * channel keeping that state perceivable — not a cosmetic extra.
+ */
+/**
+ * The words this summary is built from, supplied by the caller.
+ *
+ * Functions rather than strings because the counts have to agree with their
+ * nouns, and which forms a number takes is a property of the language, not of
+ * a selection — English has two, Chinese one, Polish three.
+ */
+export type SelectionSummaryCopy = {
+    notes: (count: number) => string;
+    measures: (count: number) => string;
+    tracks: (count: number) => string;
+    none: string;
+    /** Wraps a summary to say it describes regenerated music. */
+    regenerated: (summary: string) => string;
+};
+export declare function selectionSummaryLabel(sel: ScoreSelection, copy: SelectionSummaryCopy, regenerated?: boolean): string;
+//# sourceMappingURL=selection.d.ts.map

package/dist/domain/selection/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../../src/domain/selection/selection.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAS,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,GAClB,UAAU,GAAG,IAAI,CA6DnB;AAOD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,GAClB,cAAc,CA2BhB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,CAMT;AAED;;;;;;;;;;;;;GAaG;AACH;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,oBAAoB,EAC1B,WAAW,UAAQ,GAClB,MAAM,CAQR"}

package/dist/domain/selection/selection.js

@@ -0,0 +1,129 @@
+/**
+ * Selection helpers (spec §9). Pure, read-only functions over `Score` +
+ * `ScoreSelection`/`ScoreRange` — no UI, store, or rendering concerns.
+ */
+import { findEvent, findMeasure, findTrack, scoreEndTick, } from '../score/queries.js';
+/**
+ * The smallest tick range, aligned to full-measure boundaries on every
+ * implicated track, that covers everything named by `sel` (selected
+ * events, measures, an explicit `range`, and/or `trackIds`). Returns
+ * `null` when the selection carries no tick information at all (no
+ * resolvable events, no resolvable measures, and no `range`) — a bare
+ * `trackIds` selection has no timeline extent to convert.
+ *
+ * Track scope for the result is the union of: `sel.trackIds`, the owning
+ * track of every resolved event/measure, and `sel.range?.trackIds`. An
+ * id that doesn't resolve to anything in `score` (stale selection) is
+ * simply skipped when gathering tick anchors, but is still carried
+ * through into the result's `trackIds` (see `selectionIsRegenerable`,
+ * which treats that as a disqualifying condition).
+ */
+export function selectionToRange(score, sel) {
+    let minTick = Infinity;
+    let maxTick = -Infinity;
+    const trackIds = new Set();
+    for (const eventId of sel.eventIds) {
+        const event = findEvent(score, eventId);
+        if (!event)
+            continue;
+        minTick = Math.min(minTick, event.startTick);
+        maxTick = Math.max(maxTick, event.startTick + event.durationTicks);
+        trackIds.add(event.trackId);
+    }
+    for (const measureId of sel.measureIds) {
+        const measure = findMeasure(score, measureId);
+        if (!measure)
+            continue;
+        minTick = Math.min(minTick, measure.startTick);
+        maxTick = Math.max(maxTick, measure.startTick + measure.durationTicks);
+        const owningTrack = score.tracks.find(t => t.measures.some(m => m.id === measureId));
+        if (owningTrack)
+            trackIds.add(owningTrack.id);
+    }
+    if (sel.range) {
+        minTick = Math.min(minTick, sel.range.startTick);
+        maxTick = Math.max(maxTick, sel.range.endTick);
+        for (const id of sel.range.trackIds)
+            trackIds.add(id);
+    }
+    for (const id of sel.trackIds)
+        trackIds.add(id);
+    if (!Number.isFinite(minTick) || !Number.isFinite(maxTick)) {
+        return null;
+    }
+    const scopedTrackIds = [...trackIds];
+    const tracksInScope = scopedTrackIds.length > 0
+        ? scopedTrackIds
+            .map(id => findTrack(score, id))
+            .filter((t) => t !== null)
+        : score.tracks;
+    let alignedStart = minTick;
+    let alignedEnd = maxTick;
+    for (const track of tracksInScope) {
+        for (const measure of track.measures) {
+            const measureEnd = measure.startTick + measure.durationTicks;
+            if (measure.startTick < maxTick && measureEnd > minTick) {
+                alignedStart = Math.min(alignedStart, measure.startTick);
+                alignedEnd = Math.max(alignedEnd, measureEnd);
+            }
+        }
+    }
+    return {
+        startTick: alignedStart,
+        endTick: alignedEnd,
+        trackIds: scopedTrackIds,
+    };
+}
+/** Deduplicates an array while preserving first-seen order. */
+function dedupe(ids) {
+    return [...new Set(ids)];
+}
+/**
+ * Returns a selection with: duplicate ids removed; event/measure/track ids
+ * that no longer resolve in `score` dropped (a stale reference left over
+ * from an edit that deleted the selected object); and, if present, `range`
+ * normalized (its own `trackIds` deduplicated, and `startTick`/`endTick`
+ * swapped into ascending order if given reversed).
+ */
+export function normalizeSelection(score, sel) {
+    const eventIds = dedupe(sel.eventIds).filter(id => findEvent(score, id) !== null);
+    const measureIds = dedupe(sel.measureIds).filter(id => findMeasure(score, id) !== null);
+    const trackIds = dedupe(sel.trackIds).filter(id => findTrack(score, id) !== null);
+    const normalized = { eventIds, measureIds, trackIds };
+    if (sel.range) {
+        const startTick = Math.max(0, Math.min(sel.range.startTick, sel.range.endTick));
+        const endTick = Math.max(sel.range.startTick, sel.range.endTick);
+        normalized.range = {
+            startTick,
+            endTick,
+            trackIds: dedupe(sel.range.trackIds),
+        };
+    }
+    return normalized;
+}
+/**
+ * Whether `sel` can be converted (via `selectionToRange`) into a valid
+ * regeneration region: a non-empty, nonnegative tick span that doesn't
+ * extend past the end of the score, on tracks that all actually exist.
+ */
+export function selectionIsRegenerable(score, sel) {
+    const range = selectionToRange(score, sel);
+    if (!range)
+        return false;
+    if (range.startTick < 0 || range.startTick >= range.endTick)
+        return false;
+    if (range.endTick > scoreEndTick(score))
+        return false;
+    return range.trackIds.every(id => findTrack(score, id) !== null);
+}
+export function selectionSummaryLabel(sel, copy, regenerated = false) {
+    const mark = (summary) => regenerated ? copy.regenerated(summary) : summary;
+    if (sel.eventIds.length > 0)
+        return mark(copy.notes(sel.eventIds.length));
+    if (sel.measureIds.length > 0)
+        return mark(copy.measures(sel.measureIds.length));
+    if (sel.trackIds.length > 0)
+        return mark(copy.tracks(sel.trackIds.length));
+    return copy.none;
+}
+//# sourceMappingURL=selection.js.map

package/dist/domain/selection/selection.js.map

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

package/dist/domain/selection/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Selection model (spec §9). The `ScoreRange`/`ScoreSelection` types are
+ * canonical in @sudobility/music_types and re-exported here so domain
+ * modules keep one import site; `emptySelection` is the runtime helper.
+ */
+export type { ScoreRange, ScoreSelection } from '../../index.js';
+import type { ScoreSelection } from '../../index.js';
+/** An empty selection: no events, measures, tracks, or range selected. */
+export declare function emptySelection(): ScoreSelection;
+//# sourceMappingURL=types.d.ts.map

package/dist/domain/selection/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/domain/selection/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,0EAA0E;AAC1E,wBAAgB,cAAc,IAAI,cAAc,CAE/C"}

package/dist/domain/selection/types.js

@@ -0,0 +1,5 @@
+/** An empty selection: no events, measures, tracks, or range selected. */
+export function emptySelection() {
+    return { eventIds: [], measureIds: [], trackIds: [] };
+}
+//# sourceMappingURL=types.js.map