@sudobility/music_types 0.11.20 → 0.11.21

package/dist/domain/quantization/quantize.js

@@ -0,0 +1,199 @@
+/**
+ * Reusable quantization engine (spec §24). `quantizeEvents` is a pure
+ * function: it never mutates `events` or any event within it, and its
+ * output depends only on its inputs (no randomness — "humanization" here
+ * means a deterministic "already close enough, leave it" tolerance, not
+ * random jitter). Exposed for both MIDI import cleanup and manual editing.
+ */
+import { createId } from '../score/ids.js';
+import { isNoteEvent } from '../../index.js';
+/** `tripletGrid` subdivides `grid` into thirds-of-two (2/3 of `grid`); otherwise the grid unit is used as-is. */
+function effectiveGridTicks(opts) {
+    return opts.tripletGrid ? (opts.grid * 2) / 3 : opts.grid;
+}
+/**
+ * Snaps `original` to the nearest grid line (round-half-up, i.e. a note
+ * exactly at the midpoint between two grid lines snaps to the later one),
+ * then, if `swing` is set, delays every second grid slot (odd slot index)
+ * by `swing` * one grid unit. If `humanizeToleranceTicks` is set and
+ * `original` is already within that many ticks of the computed target, the
+ * event is left at `original` instead (not force-snapped).
+ */
+function computeSnappedStart(original, opts) {
+    const grid = effectiveGridTicks(opts);
+    if (grid <= 0)
+        return original;
+    const slotIndex = Math.round(original / grid);
+    let target = slotIndex * grid;
+    if (opts.swing && slotIndex % 2 !== 0) {
+        target += opts.swing * grid;
+    }
+    target = Math.round(target);
+    if (opts.humanizeToleranceTicks !== undefined &&
+        Math.abs(original - target) <= opts.humanizeToleranceTicks) {
+        return original;
+    }
+    return target;
+}
+/**
+ * Snaps `original` to the nearest multiple of the grid unit, then clamps
+ * the result up to at least `minDurationTicks` (default a hard 1-tick
+ * floor when unset) so quantization can never produce a zero/negative
+ * duration, which every other event in the domain model forbids.
+ */
+function computeSnappedDuration(original, opts) {
+    const grid = effectiveGridTicks(opts);
+    if (grid <= 0)
+        return Math.max(original, opts.minDurationTicks ?? 1);
+    const units = Math.round(original / grid);
+    const snapped = Math.round(units * grid);
+    return Math.max(snapped, opts.minDurationTicks ?? 1);
+}
+/** Drops `NoteEvent`s whose *original* duration is shorter than `minDurationTicks`. `RestEvent`s are never dropped. */
+function dropShortNotes(events, minDurationTicks) {
+    if (minDurationTicks === undefined)
+        return events;
+    return events.filter(event => !isNoteEvent(event) || event.durationTicks >= minDurationTicks);
+}
+/** Groups events by (trackId, voiceId), preserving each group's first-seen order. */
+function groupByVoice(events) {
+    const order = [];
+    const groups = new Map();
+    for (const event of events) {
+        const key = `${event.trackId}::${event.voiceId}`;
+        let group = groups.get(key);
+        if (!group) {
+            group = [];
+            groups.set(key, group);
+            order.push(key);
+        }
+        group.push(event);
+    }
+    return order.map(key => groups.get(key));
+}
+/**
+ * Clusters near-simultaneous onsets (already sorted by `startTick`) onto a
+ * shared start tick: the first event in a run seeds a cluster "anchor";
+ * every subsequent event within `tolerance` ticks of the anchor is
+ * reassigned to the anchor's tick, otherwise it becomes the next cluster's
+ * anchor. Anchoring (rather than comparing each event to its immediate
+ * neighbor) bounds how far a chain of close onsets can drift in total.
+ */
+function applyChordGrouping(sorted, tolerance) {
+    let anchor = 0;
+    return sorted.map((event, index) => {
+        if (index === 0) {
+            anchor = event.startTick;
+            return event;
+        }
+        if (event.startTick - anchor <= tolerance) {
+            return { ...event, startTick: anchor };
+        }
+        anchor = event.startTick;
+        return event;
+    });
+}
+/**
+ * Trims an event that overlaps the following event's start (already
+ * sorted by `startTick`) down to end exactly at that start. Events sharing
+ * an exact start tick are a chord, not an overlap, and are left alone.
+ * Only adjacent pairs are compared, matching the everyday "this note runs
+ * into the next one" meaning of overlap resolution.
+ */
+function applyResolveOverlaps(sorted) {
+    const result = sorted.map(event => ({ ...event }));
+    for (let i = 0; i < result.length - 1; i += 1) {
+        const current = result[i];
+        const next = result[i + 1];
+        if (current.startTick === next.startTick)
+            continue;
+        const currentEnd = current.startTick + current.durationTicks;
+        if (currentEnd > next.startTick) {
+            current.durationTicks = Math.max(1, next.startTick - current.startTick);
+        }
+    }
+    return result;
+}
+/**
+ * Extends an event that falls short of the following event's start
+ * (already sorted by `startTick`) so it ends exactly there, closing small
+ * silent gaps. Never shrinks an event that already reaches or overlaps the
+ * next one. Events sharing an exact start tick (a chord) are left alone.
+ */
+function applyLegatoCleanup(sorted) {
+    const result = sorted.map(event => ({ ...event }));
+    for (let i = 0; i < result.length - 1; i += 1) {
+        const current = result[i];
+        const next = result[i + 1];
+        if (current.startTick === next.startTick)
+            continue;
+        const currentEnd = current.startTick + current.durationTicks;
+        if (currentEnd < next.startTick) {
+            current.durationTicks = next.startTick - current.startTick;
+        }
+    }
+    return result;
+}
+/** Inserts a fresh `RestEvent` for every remaining silent gap between consecutive events (already sorted by `startTick`). */
+function applyFillGaps(sorted, trackId, voiceId) {
+    const result = [];
+    let cursor = null;
+    for (const event of sorted) {
+        if (cursor !== null && event.startTick > cursor) {
+            result.push({
+                id: createId(),
+                startTick: cursor,
+                durationTicks: event.startTick - cursor,
+                voiceId,
+                trackId,
+            });
+        }
+        result.push(event);
+        const end = event.startTick + event.durationTicks;
+        cursor = cursor === null ? end : Math.max(cursor, end);
+    }
+    return result;
+}
+/** Runs the chord-grouping/overlap-resolution/legato/gap-filling stages (each opt-in) over one (trackId, voiceId) group. */
+function processVoiceGroup(group, opts) {
+    let current = [...group].sort((a, b) => a.startTick - b.startTick);
+    if (opts.chordToleranceTicks !== undefined) {
+        current = applyChordGrouping(current, opts.chordToleranceTicks);
+    }
+    if (opts.resolveOverlaps) {
+        current = applyResolveOverlaps(current);
+    }
+    if (opts.legatoCleanup) {
+        current = applyLegatoCleanup(current);
+    }
+    if (opts.fillGaps) {
+        const [{ trackId, voiceId }] = group;
+        current = applyFillGaps(current, trackId, voiceId);
+    }
+    return current;
+}
+/**
+ * Quantizes `events` per `opts` (spec §24): drops undersized notes, snaps
+ * starts (grid/triplet/swing/humanize tolerance) and durations (grid,
+ * clamped to a minimum), then — per (trackId, voiceId) group — clusters
+ * near-simultaneous onsets into chords, resolves overlaps, closes gaps
+ * (legato), and fills remaining silence with rests. Every stage after
+ * dropping is opt-in via `opts`; omitting a field disables that stage.
+ * Returns a new array; never mutates `events` or its elements.
+ */
+export function quantizeEvents(events, opts) {
+    const survivors = dropShortNotes(events, opts.minDurationTicks);
+    const withStarts = survivors.map(event => opts.quantizeStarts
+        ? { ...event, startTick: computeSnappedStart(event.startTick, opts) }
+        : { ...event });
+    const withDurations = withStarts.map(event => opts.quantizeDurations
+        ? {
+            ...event,
+            durationTicks: computeSnappedDuration(event.durationTicks, opts),
+        }
+        : event);
+    return groupByVoice(withDurations)
+        .map(group => processVoiceGroup(group, opts))
+        .flat();
+}
+//# sourceMappingURL=quantize.js.map

package/dist/domain/quantization/quantize.js.map

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

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

@@ -0,0 +1,39 @@
+import type { KeySignature, Score, TimeSignature, Track } from '../../index.js';
+export type CreateTrackOptions = Partial<Track> & {
+    name: string;
+};
+/** Builds a `Track` with sensible defaults, overridden by any fields in `opts`. */
+export declare function createTrack(opts: CreateTrackOptions): Track;
+export type CreateEmptyScoreOptions = {
+    title: string;
+    ppq?: number;
+    tempo?: number;
+    timeSignature?: TimeSignature;
+    keySignature?: KeySignature;
+    measures?: number;
+    tracks?: Array<Partial<Track> & {
+        name: string;
+    }>;
+};
+/**
+ * Builds a new `Score` with `measures` fully-rested measures on each of
+ * `tracks`, one default voice per track per measure. Defaults: 480 PPQ,
+ * 120 bpm, 4/4, C major, one measure, one Piano track.
+ */
+export declare function createEmptyScore(opts: CreateEmptyScoreOptions): Score;
+/**
+ * Appends one fully-rested measure to every track, continuing each track's
+ * own tick numbering and reusing its last measure's time/key signature
+ * (falling back to 4/4 C major for a track with no existing measures).
+ */
+export declare function appendMeasure(score: Score): Score;
+/**
+ * Recomputes `index`/`startTick` for every track's measures from their
+ * current array order (each measure keeps its own `durationTicks`), and
+ * shifts each measure's events by the same delta so they stay positioned
+ * consistently within their (possibly moved) measure. Measures whose
+ * index/startTick are already consistent are returned unchanged
+ * (referentially equal) so unaffected structure is preserved.
+ */
+export declare function rebuildMeasureTicks(score: Score): Score;
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/domain/score/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAEZ,KAAK,EAEL,aAAa,EACb,KAAK,EACN,MAAM,gBAAgB,CAAC;AAUxB,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,KAAK,CAc3D;AAwDD,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,KAAK,CAwCrE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CA0BjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CA6BvD"}

package/dist/domain/score/factory.js

@@ -0,0 +1,148 @@
+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_MEASURE_COUNT = 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',
+        midiProgram: opts.midiProgram ?? 0,
+        midiChannel: opts.midiChannel ?? 0,
+        clef: opts.clef ?? 'treble',
+        volume: opts.volume ?? 1,
+        pan: opts.pan ?? 0,
+        muted: opts.muted ?? false,
+        solo: opts.solo ?? false,
+        measures: opts.measures ?? [],
+    };
+}
+/** Builds a single fully-rested measure at the given index/startTick. */
+function buildRestMeasure(index, startTick, timeSignature, keySignature, durationTicks, trackId) {
+    const voiceId = createId();
+    return {
+        id: createId(),
+        index,
+        startTick,
+        durationTicks,
+        timeSignature,
+        keySignature,
+        voices: [
+            {
+                id: voiceId,
+                name: DEFAULT_VOICE_NAME,
+                events: [
+                    { id: createId(), startTick, durationTicks, voiceId, trackId },
+                ],
+            },
+        ],
+    };
+}
+/** Builds `count` consecutive fully-rested measures starting at tick 0. */
+function buildMeasures(count, timeSignature, keySignature, ppq, trackId) {
+    const durationTicks = measureDurationTicks(timeSignature, ppq);
+    const measures = [];
+    for (let index = 0; index < count; index += 1) {
+        measures.push(buildRestMeasure(index, index * durationTicks, timeSignature, keySignature, durationTicks, trackId));
+    }
+    return measures;
+}
+/**
+ * Builds a new `Score` with `measures` fully-rested measures on each of
+ * `tracks`, one default voice per track per measure. Defaults: 480 PPQ,
+ * 120 bpm, 4/4, C major, one measure, one Piano track.
+ */
+export function createEmptyScore(opts) {
+    const ppq = opts.ppq ?? DEFAULT_PPQ;
+    const timeSignature = opts.timeSignature ?? DEFAULT_TIME_SIGNATURE;
+    const keySignature = opts.keySignature ?? DEFAULT_KEY_SIGNATURE;
+    const measureCount = opts.measures ?? DEFAULT_MEASURE_COUNT;
+    const trackOptions = opts.tracks ?? [
+        { name: 'Piano', instrumentName: 'Piano', clef: 'treble' },
+    ];
+    const tracks = trackOptions.map(trackOpts => {
+        const track = createTrack(trackOpts);
+        return {
+            ...track,
+            measures: buildMeasures(measureCount, timeSignature, keySignature, ppq, track.id),
+        };
+    });
+    const now = new Date().toISOString();
+    const metadata = {
+        title: opts.title,
+        createdAt: now,
+        updatedAt: now,
+    };
+    return {
+        id: createId(),
+        version: 1,
+        ppq,
+        metadata,
+        tempoMap: [
+            { id: createId(), tick: 0, bpm: opts.tempo ?? DEFAULT_TEMPO_BPM },
+        ],
+        tracks,
+    };
+}
+/**
+ * Appends one fully-rested measure to every track, continuing each track's
+ * own tick numbering and reusing its last measure's time/key signature
+ * (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 lastMeasure = track.measures[track.measures.length - 1];
+        const timeSignature = lastMeasure?.timeSignature ?? DEFAULT_TIME_SIGNATURE;
+        const keySignature = lastMeasure?.keySignature ?? DEFAULT_KEY_SIGNATURE;
+        const durationTicks = measureDurationTicks(timeSignature, score.ppq);
+        const startTick = lastMeasure
+            ? lastMeasure.startTick + lastMeasure.durationTicks
+            : 0;
+        const newMeasure = buildRestMeasure(track.measures.length, startTick, timeSignature, keySignature, durationTicks, track.id);
+        return { ...track, measures: [...track.measures, newMeasure] };
+    });
+    return {
+        ...score,
+        tracks,
+        metadata: { ...score.metadata, updatedAt: new Date().toISOString() },
+    };
+}
+/**
+ * Recomputes `index`/`startTick` for every track's measures from their
+ * current array order (each measure keeps its own `durationTicks`), and
+ * shifts each measure's events by the same delta so they stay positioned
+ * consistently within their (possibly moved) measure. Measures whose
+ * index/startTick are already consistent are returned unchanged
+ * (referentially equal) so unaffected structure is preserved.
+ */
+export function rebuildMeasureTicks(score) {
+    const tracks = score.tracks.map(track => {
+        let cursor = 0;
+        const measures = track.measures.map((measure, index) => {
+            const startTick = cursor;
+            const delta = startTick - measure.startTick;
+            cursor += measure.durationTicks;
+            if (delta === 0 && index === measure.index) {
+                return measure;
+            }
+            const voices = delta === 0
+                ? measure.voices
+                : measure.voices.map(voice => ({
+                    ...voice,
+                    events: voice.events.map(event => ({
+                        ...event,
+                        startTick: event.startTick + delta,
+                    })),
+                }));
+            return { ...measure, index, startTick, voices };
+        });
+        return { ...track, measures };
+    });
+    return { ...score, tracks };
+}
+//# sourceMappingURL=factory.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { Score, ScoreFragment } from '../../index.js';
+import type { ScoreRange } from '../selection/types.js';
+/**
+ * `ScoreFragment` is canonical in @sudobility/music_types and re-exported
+ * here so domain modules keep one import site. A fragment is a snapshot of
+ * a tick range of a score (measures shared by reference, not deep-cloned).
+ */
+export type { ScoreFragment } from '../../index.js';
+/** Captures the measures overlapping `range` (per track named in `range.trackIds`, or all tracks if empty). */
+export declare function extractFragment(score: Score, range: ScoreRange): ScoreFragment;
+/**
+ * Splices `fragment`'s measures into `score`, one track at a time. For each
+ * track named in `fragment.tracks`, the contiguous block of that track's
+ * existing measures overlapping `fragment.range` is replaced by the
+ * fragment's measures for that track (deep-replacing their voices); tracks
+ * with no measures overlapping the range are left untouched. Track ids
+ * named in the fragment but absent from the score are ignored.
+ *
+ * Every replaced event's `trackId`/`voiceId` is renumbered to match its
+ * new, actual track and voice (never trusted from the incoming fragment),
+ * so a regenerated fragment's placeholder ids never leak into the score.
+ *
+ * Measure `index`/`startTick` for every track are then recomputed via
+ * `rebuildMeasureTicks`, which leaves measures outside the edited region
+ * referentially unchanged.
+ */
+export declare function replaceFragment(score: Score, fragment: ScoreFragment): Score;
+//# sourceMappingURL=fragment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.d.ts","sourceRoot":"","sources":["../../../src/domain/score/fragment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,+GAA+G;AAC/G,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,GAChB,aAAa,CAMf;AAUD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,KAAK,CA6C5E"}

package/dist/domain/score/fragment.js

@@ -0,0 +1,68 @@
+import { rebuildMeasureTicks } from './factory.js';
+import { measuresInRange } from './queries.js';
+/** Captures the measures overlapping `range` (per track named in `range.trackIds`, or all tracks if empty). */
+export function extractFragment(score, range) {
+    return {
+        range,
+        ppq: score.ppq,
+        tracks: measuresInRange(score, range),
+    };
+}
+/** Whether a measure's span overlaps `[range.startTick, range.endTick)`. */
+function overlapsRange(measure, range) {
+    return (measure.startTick < range.endTick &&
+        measure.startTick + measure.durationTicks > range.startTick);
+}
+/**
+ * Splices `fragment`'s measures into `score`, one track at a time. For each
+ * track named in `fragment.tracks`, the contiguous block of that track's
+ * existing measures overlapping `fragment.range` is replaced by the
+ * fragment's measures for that track (deep-replacing their voices); tracks
+ * with no measures overlapping the range are left untouched. Track ids
+ * named in the fragment but absent from the score are ignored.
+ *
+ * Every replaced event's `trackId`/`voiceId` is renumbered to match its
+ * new, actual track and voice (never trusted from the incoming fragment),
+ * so a regenerated fragment's placeholder ids never leak into the score.
+ *
+ * Measure `index`/`startTick` for every track are then recomputed via
+ * `rebuildMeasureTicks`, which leaves measures outside the edited region
+ * referentially unchanged.
+ */
+export function replaceFragment(score, fragment) {
+    const replacementsByTrackId = new Map(fragment.tracks.map(t => [t.trackId, t.measures]));
+    const tracks = score.tracks.map(track => {
+        const replacementMeasures = replacementsByTrackId.get(track.id);
+        if (!replacementMeasures)
+            return track;
+        const firstIndex = track.measures.findIndex(m => overlapsRange(m, fragment.range));
+        if (firstIndex === -1)
+            return track;
+        let lastIndex = firstIndex;
+        while (lastIndex < track.measures.length &&
+            overlapsRange(track.measures[lastIndex], fragment.range)) {
+            lastIndex += 1;
+        }
+        const normalizedMeasures = replacementMeasures.map(measure => ({
+            ...measure,
+            voices: measure.voices.map(voice => ({
+                ...voice,
+                events: voice.events.map(event => ({
+                    ...event,
+                    trackId: track.id,
+                    voiceId: voice.id,
+                })),
+            })),
+        }));
+        return {
+            ...track,
+            measures: [
+                ...track.measures.slice(0, firstIndex),
+                ...normalizedMeasures,
+                ...track.measures.slice(lastIndex),
+            ],
+        };
+    });
+    return rebuildMeasureTicks({ ...score, tracks });
+}
+//# sourceMappingURL=fragment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragment.js","sourceRoot":"","sources":["../../../src/domain/score/fragment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAW/C,+GAA+G;AAC/G,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,KAAiB;IAEjB,OAAO;QACL,KAAK;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,aAAa,CAAC,OAAgB,EAAE,KAAiB;IACxD,OAAO,CACL,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO;QACjC,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAC5D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,QAAuB;IACnE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CACnC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAClD,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACtC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,mBAAmB;YAAE,OAAO,KAAK,CAAC;QAEvC,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAC9C,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CACjC,CAAC;QACF,IAAI,UAAU,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAEpC,IAAI,SAAS,GAAG,UAAU,CAAC;QAC3B,OACE,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM;YACjC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,EACxD,CAAC;YACD,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7D,GAAG,OAAO;YACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACnC,GAAG,KAAK;gBACR,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;oBACjC,GAAG,KAAK;oBACR,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,OAAO,EAAE,KAAK,CAAC,EAAE;iBAClB,CAAC,CAAC;aACJ,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,GAAG,KAAK;YACR,QAAQ,EAAE;gBACR,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;gBACtC,GAAG,kBAAkB;gBACrB,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;aACnC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,mBAAmB,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { UUID } from '../../index.js';
+/**
+ * Generates a v4 UUID. Uses `crypto.randomUUID` when available, falling back
+ * to a `Math.random`-based generator in non-secure contexts (e.g. `http://`
+ * origins other than `localhost`) where `crypto.randomUUID` is undefined.
+ */
+export declare function createId(): UUID;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/domain/score/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA0B3C;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,IAAI,CAQ/B"}

package/dist/domain/score/ids.js

@@ -0,0 +1,38 @@
+const HEX_CHARS = '0123456789abcdef';
+/**
+ * Fallback v4-UUID generator for non-secure contexts, where
+ * `crypto.randomUUID` is unavailable (it requires a secure context per the
+ * Web Crypto spec). Not cryptographically strong; adequate for local
+ * identifiers only.
+ */
+function randomUuidFallback() {
+    let result = '';
+    for (let i = 0; i < 36; i += 1) {
+        if (i === 8 || i === 13 || i === 18 || i === 23) {
+            result += '-';
+        }
+        else if (i === 14) {
+            result += '4';
+        }
+        else if (i === 19) {
+            result += HEX_CHARS[8 + Math.floor(Math.random() * 4)]; // one of 8, 9, a, b
+        }
+        else {
+            result += HEX_CHARS[Math.floor(Math.random() * 16)];
+        }
+    }
+    return result;
+}
+/**
+ * Generates a v4 UUID. Uses `crypto.randomUUID` when available, falling back
+ * to a `Math.random`-based generator in non-secure contexts (e.g. `http://`
+ * origins other than `localhost`) where `crypto.randomUUID` is undefined.
+ */
+export function createId() {
+    if (typeof crypto !== 'undefined' &&
+        typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return randomUuidFallback();
+}
+//# sourceMappingURL=ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/domain/score/ids.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC;;;;;GAKG;AACH,SAAS,kBAAkB;IACzB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,CAAC;QAChB,CAAC;aAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB;QAC9E,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,IACE,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EACvC,CAAC;QACD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,kBAAkB,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { ScoreRange } from '../selection/types.js';
+import type { Measure, MusicalEvent, NoteEvent, Score, Track, UUID } from '../../index.js';
+/** Finds a track by id, or `null` if no track has that id. */
+export declare function findTrack(score: Score, trackId: UUID): Track | null;
+/** Finds a measure by id across all tracks, or `null` if none has that id. */
+export declare function findMeasure(score: Score, measureId: UUID): Measure | null;
+/** Finds an event (note or rest) by id across all tracks/measures/voices, or `null`. */
+export declare function findEvent(score: Score, eventId: UUID): MusicalEvent | null;
+/** All note events (rests excluded) on the requested tracks overlapping the tick range. */
+export declare function eventsInRange(score: Score, range: ScoreRange): NoteEvent[];
+/** Measures overlapping the tick range, grouped by track. */
+export declare function measuresInRange(score: Score, range: ScoreRange): Array<{
+    trackId: UUID;
+    measures: Measure[];
+}>;
+/**
+ * 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 declare function noteAt(score: Score, trackId: UUID, tick: number, midi?: number): NoteEvent | null;
+/** The tick at which the score's last measure (across all tracks) ends; 0 if there are none. */
+export declare function scoreEndTick(score: Score): number;
+/** All note events (rests excluded) across every track/measure/voice. */
+export declare function allNotes(score: Score): NoteEvent[];
+/**
+ * `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 declare function scoreWithTracks(score: Score, trackIds: string[]): Score;
+//# sourceMappingURL=queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/domain/score/queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,SAAS,EACT,KAAK,EACL,KAAK,EACL,IAAI,EACL,MAAM,gBAAgB,CAAC;AAIxB,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,CAEnE;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,GAAG,IAAI,CAMzE;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,YAAY,GAAG,IAAI,CAU1E;AAkBD,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,EAAE,CAkB1E;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,UAAU,GAChB,KAAK,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAU/C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,IAAI,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,GAAG,IAAI,CAmBlB;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CASjD;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,CAYlD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,KAAK,CAKvE"}