@sudobility/music_types 0.11.19 → 0.11.21

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/selection/types.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,MAAM,UAAU,cAAc;IAC5B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACxD,CAAC"}

package/dist/domain/time/durations.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Greedily decomposes a tick length into the largest renderable (non-triplet,
+ * dotted-allowed) note values that fit, largest first. If a remainder is
+ * smaller than the smallest available duration, it is emitted as-is so the
+ * returned segments always sum back to the original `ticks` (the caller is
+ * responsible for deciding how such a remainder is notated/tied).
+ */
+export declare function decomposeDuration(ticks: number, ppq: number): number[];
+export type TickSegment = {
+    startTick: number;
+    durationTicks: number;
+};
+/**
+ * Splits a note spanning `[startTick, startTick + durationTicks)` at every
+ * given absolute-tick boundary that falls strictly inside that range (e.g.
+ * measure start ticks), returning contiguous segments that together cover
+ * the original span. The caller is responsible for tying split segments
+ * back together.
+ */
+export declare function splitAtBoundaries(startTick: number, durationTicks: number, boundaries: number[]): TickSegment[];
+//# sourceMappingURL=durations.d.ts.map

package/dist/domain/time/durations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durations.d.ts","sourceRoot":"","sources":["../../../src/domain/time/durations.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBtE;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW,EAAE,CAef"}

package/dist/domain/time/durations.js

@@ -0,0 +1,53 @@
+import { DURATIONS, ticksFor } from './ticks.js';
+const NON_TRIPLET_DURATION_NAMES = Object.keys(DURATIONS).filter(name => !name.startsWith('triplet-'));
+/** Distinct, descending tick lengths for every renderable (non-triplet) duration at a given PPQ. */
+function decomposableDurationTicks(ppq) {
+    const ticks = new Set(NON_TRIPLET_DURATION_NAMES.map(name => ticksFor(name, ppq)));
+    return [...ticks].filter(t => t > 0).sort((a, b) => b - a);
+}
+/**
+ * Greedily decomposes a tick length into the largest renderable (non-triplet,
+ * dotted-allowed) note values that fit, largest first. If a remainder is
+ * smaller than the smallest available duration, it is emitted as-is so the
+ * returned segments always sum back to the original `ticks` (the caller is
+ * responsible for deciding how such a remainder is notated/tied).
+ */
+export function decomposeDuration(ticks, ppq) {
+    if (ticks <= 0)
+        return [];
+    const candidates = decomposableDurationTicks(ppq);
+    const result = [];
+    let remaining = ticks;
+    while (remaining > 0) {
+        const next = candidates.find(c => c <= remaining);
+        if (next === undefined) {
+            result.push(remaining);
+            break;
+        }
+        result.push(next);
+        remaining -= next;
+    }
+    return result;
+}
+/**
+ * Splits a note spanning `[startTick, startTick + durationTicks)` at every
+ * given absolute-tick boundary that falls strictly inside that range (e.g.
+ * measure start ticks), returning contiguous segments that together cover
+ * the original span. The caller is responsible for tying split segments
+ * back together.
+ */
+export function splitAtBoundaries(startTick, durationTicks, boundaries) {
+    const endTick = startTick + durationTicks;
+    const cutPoints = [...new Set(boundaries)]
+        .filter(b => b > startTick && b < endTick)
+        .sort((a, b) => a - b);
+    const segments = [];
+    let cursor = startTick;
+    for (const cut of cutPoints) {
+        segments.push({ startTick: cursor, durationTicks: cut - cursor });
+        cursor = cut;
+    }
+    segments.push({ startTick: cursor, durationTicks: endTick - cursor });
+    return segments;
+}
+//# sourceMappingURL=durations.js.map

package/dist/domain/time/durations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durations.js","sourceRoot":"","sources":["../../../src/domain/time/durations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,0BAA0B,GAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,CACtB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;AAE/C,oGAAoG;AACpG,SAAS,yBAAyB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAC5D,CAAC;IACF,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,GAAW;IAC1D,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE1B,MAAM,UAAU,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,SAAS,IAAI,IAAI,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,aAAqB,EACrB,UAAoB;IAEpB,MAAM,OAAO,GAAG,SAAS,GAAG,aAAa,CAAC;IAC1C,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,GAAG,OAAO,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC;QAClE,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;IAEtE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/domain/time/fraction.d.ts

@@ -0,0 +1,19 @@
+import type { Fraction } from '../../index.js';
+/** Constructs a `Fraction` from a numerator and denominator, unnormalized. */
+export declare function fraction(numerator: number, denominator: number): Fraction;
+/**
+ * Reduces a fraction to lowest terms with a positive denominator.
+ * Zero always normalizes to `0/1`. Throws on a zero denominator.
+ */
+export declare function normalizeFraction(f: Fraction): Fraction;
+export declare function addFractions(a: Fraction, b: Fraction): Fraction;
+export declare function subtractFractions(a: Fraction, b: Fraction): Fraction;
+/** Returns -1, 0, or 1 depending on whether `a` is less than, equal to, or greater than `b`. */
+export declare function compareFractions(a: Fraction, b: Fraction): -1 | 0 | 1;
+/**
+ * Converts a fraction of a whole note to integer ticks at the given PPQ.
+ * A quarter note (1/4) equals `ppq` ticks, so a whole note equals `4 * ppq`.
+ * Rounds to the nearest integer tick.
+ */
+export declare function fractionToTicks(f: Fraction, ppq: number): number;
+//# sourceMappingURL=fraction.d.ts.map

package/dist/domain/time/fraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fraction.d.ts","sourceRoot":"","sources":["../../../src/domain/time/fraction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAY/C,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAEzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAevD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAK/D;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAKpE;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAMrE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/domain/time/fraction.js

@@ -0,0 +1,60 @@
+/** Greatest common divisor (non-negative). */
+function gcd(a, b) {
+    let x = Math.abs(a);
+    let y = Math.abs(b);
+    while (y !== 0) {
+        [x, y] = [y, x % y];
+    }
+    return x;
+}
+/** Constructs a `Fraction` from a numerator and denominator, unnormalized. */
+export function fraction(numerator, denominator) {
+    return { numerator, denominator };
+}
+/**
+ * Reduces a fraction to lowest terms with a positive denominator.
+ * Zero always normalizes to `0/1`. Throws on a zero denominator.
+ */
+export function normalizeFraction(f) {
+    if (f.denominator === 0) {
+        throw new Error('normalizeFraction: denominator cannot be zero');
+    }
+    if (f.numerator === 0) {
+        return { numerator: 0, denominator: 1 };
+    }
+    const sign = Math.sign(f.numerator) * Math.sign(f.denominator);
+    const divisor = gcd(f.numerator, f.denominator);
+    return {
+        numerator: sign * (Math.abs(f.numerator) / divisor),
+        denominator: Math.abs(f.denominator) / divisor,
+    };
+}
+export function addFractions(a, b) {
+    return normalizeFraction({
+        numerator: a.numerator * b.denominator + b.numerator * a.denominator,
+        denominator: a.denominator * b.denominator,
+    });
+}
+export function subtractFractions(a, b) {
+    return normalizeFraction({
+        numerator: a.numerator * b.denominator - b.numerator * a.denominator,
+        denominator: a.denominator * b.denominator,
+    });
+}
+/** Returns -1, 0, or 1 depending on whether `a` is less than, equal to, or greater than `b`. */
+export function compareFractions(a, b) {
+    const left = a.numerator * b.denominator;
+    const right = b.numerator * a.denominator;
+    const sign = Math.sign(a.denominator) * Math.sign(b.denominator);
+    const diff = sign * (left - right);
+    return diff < 0 ? -1 : diff > 0 ? 1 : 0;
+}
+/**
+ * Converts a fraction of a whole note to integer ticks at the given PPQ.
+ * A quarter note (1/4) equals `ppq` ticks, so a whole note equals `4 * ppq`.
+ * Rounds to the nearest integer tick.
+ */
+export function fractionToTicks(f, ppq) {
+    return Math.round((f.numerator / f.denominator) * 4 * ppq);
+}
+//# sourceMappingURL=fraction.js.map

package/dist/domain/time/fraction.js.map

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

package/dist/domain/time/tempo-map.d.ts

@@ -0,0 +1,24 @@
+import type { TempoEvent } from '../../index.js';
+/**
+ * Maps between ticks and seconds given a (possibly empty) set of tempo
+ * change events. Tempo is piecewise-constant (a bpm value applies from its
+ * event's tick until the next event's tick), which makes the tick <-> second
+ * mapping piecewise-linear. An empty map behaves as a constant 120 bpm.
+ */
+export declare class TempoMap {
+    private readonly breakpoints;
+    private readonly ppq;
+    constructor(events: TempoEvent[], ppq: number);
+    private static buildBreakpoints;
+    /** Finds the last breakpoint at or before `tick` (breakpoints[0].tick is always 0). */
+    private breakpointForTick;
+    /** Finds the last breakpoint whose seconds offset is at or before `seconds`. */
+    private breakpointForSeconds;
+    /** The bpm in effect at the given tick. */
+    bpmAt(tick: number): number;
+    /** Converts an integer tick position to seconds. */
+    ticksToSeconds(tick: number): number;
+    /** Converts a time in seconds to a (possibly fractional) tick position. */
+    secondsToTicks(seconds: number): number;
+}
+//# sourceMappingURL=tempo-map.d.ts.map

package/dist/domain/time/tempo-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo-map.d.ts","sourceRoot":"","sources":["../../../src/domain/time/tempo-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgBjD;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM;IAK7C,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA6C/B,uFAAuF;IACvF,OAAO,CAAC,iBAAiB;IASzB,gFAAgF;IAChF,OAAO,CAAC,oBAAoB;IAS5B,2CAA2C;IAC3C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,oDAAoD;IACpD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKpC,2EAA2E;IAC3E,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAKxC"}

package/dist/domain/time/tempo-map.js

@@ -0,0 +1,85 @@
+const DEFAULT_BPM = 120;
+/** Seconds elapsed for a given tick delta at a constant bpm. */
+function deltaTicksToSeconds(deltaTicks, ppq, bpm) {
+    return (deltaTicks / ppq) * (60 / bpm);
+}
+/**
+ * Maps between ticks and seconds given a (possibly empty) set of tempo
+ * change events. Tempo is piecewise-constant (a bpm value applies from its
+ * event's tick until the next event's tick), which makes the tick <-> second
+ * mapping piecewise-linear. An empty map behaves as a constant 120 bpm.
+ */
+export class TempoMap {
+    constructor(events, ppq) {
+        this.ppq = ppq;
+        this.breakpoints = TempoMap.buildBreakpoints(events, ppq);
+    }
+    static buildBreakpoints(events, ppq) {
+        const sorted = [...events].sort((a, b) => a.tick - b.tick);
+        const breakpoints = [];
+        let currentTick = 0;
+        let currentSeconds = 0;
+        let currentBpm = DEFAULT_BPM;
+        if (sorted.length === 0 || sorted[0].tick > 0) {
+            breakpoints.push({ tick: 0, seconds: 0, bpm: DEFAULT_BPM });
+        }
+        for (const event of sorted) {
+            if (event.tick === currentTick && breakpoints.length > 0) {
+                // Event at the same tick as the running breakpoint: it overrides
+                // the bpm effective from that tick (no time has elapsed).
+                breakpoints[breakpoints.length - 1] = {
+                    tick: event.tick,
+                    seconds: currentSeconds,
+                    bpm: event.bpm,
+                };
+                currentBpm = event.bpm;
+                continue;
+            }
+            currentSeconds += deltaTicksToSeconds(event.tick - currentTick, ppq, currentBpm);
+            currentTick = event.tick;
+            breakpoints.push({
+                tick: currentTick,
+                seconds: currentSeconds,
+                bpm: event.bpm,
+            });
+            currentBpm = event.bpm;
+        }
+        return breakpoints;
+    }
+    /** Finds the last breakpoint at or before `tick` (breakpoints[0].tick is always 0). */
+    breakpointForTick(tick) {
+        let result = this.breakpoints[0];
+        for (const bp of this.breakpoints) {
+            if (bp.tick > tick)
+                break;
+            result = bp;
+        }
+        return result;
+    }
+    /** Finds the last breakpoint whose seconds offset is at or before `seconds`. */
+    breakpointForSeconds(seconds) {
+        let result = this.breakpoints[0];
+        for (const bp of this.breakpoints) {
+            if (bp.seconds > seconds)
+                break;
+            result = bp;
+        }
+        return result;
+    }
+    /** The bpm in effect at the given tick. */
+    bpmAt(tick) {
+        return this.breakpointForTick(tick).bpm;
+    }
+    /** Converts an integer tick position to seconds. */
+    ticksToSeconds(tick) {
+        const bp = this.breakpointForTick(tick);
+        return bp.seconds + deltaTicksToSeconds(tick - bp.tick, this.ppq, bp.bpm);
+    }
+    /** Converts a time in seconds to a (possibly fractional) tick position. */
+    secondsToTicks(seconds) {
+        const bp = this.breakpointForSeconds(seconds);
+        const deltaSeconds = seconds - bp.seconds;
+        return bp.tick + deltaSeconds * (bp.bpm / 60) * this.ppq;
+    }
+}
+//# sourceMappingURL=tempo-map.js.map

package/dist/domain/time/tempo-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo-map.js","sourceRoot":"","sources":["../../../src/domain/time/tempo-map.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,gEAAgE;AAChE,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,GAAW,EACX,GAAW;IAEX,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;AACzC,CAAC;AAKD;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IAInB,YAAY,MAAoB,EAAE,GAAW;QAC3C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAC7B,MAAoB,EACpB,GAAW;QAEX,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,UAAU,GAAG,WAAW,CAAC;QAE7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,iEAAiE;gBACjE,0DAA0D;gBAC1D,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;oBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,cAAc;oBACvB,GAAG,EAAE,KAAK,CAAC,GAAG;iBACf,CAAC;gBACF,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC;gBACvB,SAAS;YACX,CAAC;YAED,cAAc,IAAI,mBAAmB,CACnC,KAAK,CAAC,IAAI,GAAG,WAAW,EACxB,GAAG,EACH,UAAU,CACX,CAAC;YACF,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,cAAc;gBACvB,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC,CAAC;YACH,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC;QACzB,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,uFAAuF;IAC/E,iBAAiB,CAAC,IAAY;QACpC,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,EAAE,CAAC,IAAI,GAAG,IAAI;gBAAE,MAAM;YAC1B,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gFAAgF;IACxE,oBAAoB,CAAC,OAAe;QAC1C,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,EAAE,CAAC,OAAO,GAAG,OAAO;gBAAE,MAAM;YAChC,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,cAAc,CAAC,IAAY;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,GAAG,mBAAmB,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;IAED,2EAA2E;IAC3E,cAAc,CAAC,OAAe;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;QAC1C,OAAO,EAAE,CAAC,IAAI,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IAC3D,CAAC;CACF"}

package/dist/domain/time/ticks.d.ts

@@ -0,0 +1,34 @@
+import type { DurationName, Fraction, TimeSignature } from '../../index.js';
+/**
+ * Duration name -> fraction of a whole note. Values are consumed by
+ * `fractionToTicks`, where a quarter note (1/4) equals `ppq` ticks.
+ */
+export declare const DURATIONS: Record<DurationName, Fraction>;
+/** Integer tick length of a named duration at the given PPQ. */
+export declare function ticksFor(duration: DurationName, ppq: number): number;
+/**
+ * The name of a duration `ticks` long, or `null` when nothing is exactly that.
+ *
+ * The inverse of `ticksFor`, and deliberately exact: a note that is 500 ticks
+ * at 480 PPQ is not a quarter note, it is 500 ticks, and a control that
+ * rounded it to "quarter" would relabel music it cannot represent. Callers
+ * asking "what should the duration selector show" want `null` to mean "no
+ * single name fits", which is a different answer from any name at all.
+ *
+ * Plain search rather than a reverse map: PPQ varies per score, so the tick
+ * values are not constants and a cached map would have to be keyed by it for
+ * the sake of eighteen comparisons.
+ */
+export declare function durationNameForTicks(ticks: number, ppq: number): DurationName | null;
+/** Integer tick length of one full measure in the given time signature. */
+export declare function measureDurationTicks(ts: TimeSignature, ppq: number): number;
+/**
+ * Integer tick length of one beat in the given time signature. Simple meters
+ * beat on a single denominator-note (e.g. 4/4 -> quarter). Compound meters
+ * (numerator a multiple of 3, > 3) beat on a dotted denominator-note grouping
+ * three denominator-notes (e.g. 6/8 -> dotted quarter).
+ */
+export declare function beatDurationTicks(ts: TimeSignature, ppq: number): number;
+/** Tick offsets (relative to measure start) of each beat within a measure. */
+export declare function beatBoundaries(ts: TimeSignature, ppq: number): number[];
+//# sourceMappingURL=ticks.d.ts.map

package/dist/domain/time/ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticks.d.ts","sourceRoot":"","sources":["../../../src/domain/time/ticks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACd,MAAM,gBAAgB,CAAC;AA0BxB;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAyBpD,CAAC;AAEF,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpE;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,YAAY,GAAG,IAAI,CAErB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3E;AAUD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQvE"}

package/dist/domain/time/ticks.js

@@ -0,0 +1,93 @@
+import { fraction, fractionToTicks } from './fraction.js';
+/** Multiplies a fraction by a positive integer/rational scalar expressed as a fraction. */
+function scaleFraction(f, scale) {
+    return fraction(f.numerator * scale.numerator, f.denominator * scale.denominator);
+}
+const DOTTED_SCALE = fraction(3, 2);
+const TRIPLET_SCALE = fraction(2, 3);
+const BASE_DURATIONS = {
+    whole: fraction(1, 1),
+    half: fraction(1, 2),
+    quarter: fraction(1, 4),
+    eighth: fraction(1, 8),
+    sixteenth: fraction(1, 16),
+    thirtysecond: fraction(1, 32),
+};
+/**
+ * Duration name -> fraction of a whole note. Values are consumed by
+ * `fractionToTicks`, where a quarter note (1/4) equals `ppq` ticks.
+ */
+export const DURATIONS = {
+    whole: BASE_DURATIONS.whole,
+    half: BASE_DURATIONS.half,
+    quarter: BASE_DURATIONS.quarter,
+    eighth: BASE_DURATIONS.eighth,
+    sixteenth: BASE_DURATIONS.sixteenth,
+    thirtysecond: BASE_DURATIONS.thirtysecond,
+    'dotted-whole': scaleFraction(BASE_DURATIONS.whole, DOTTED_SCALE),
+    'dotted-half': scaleFraction(BASE_DURATIONS.half, DOTTED_SCALE),
+    'dotted-quarter': scaleFraction(BASE_DURATIONS.quarter, DOTTED_SCALE),
+    'dotted-eighth': scaleFraction(BASE_DURATIONS.eighth, DOTTED_SCALE),
+    'dotted-sixteenth': scaleFraction(BASE_DURATIONS.sixteenth, DOTTED_SCALE),
+    'dotted-thirtysecond': scaleFraction(BASE_DURATIONS.thirtysecond, DOTTED_SCALE),
+    'triplet-whole': scaleFraction(BASE_DURATIONS.whole, TRIPLET_SCALE),
+    'triplet-half': scaleFraction(BASE_DURATIONS.half, TRIPLET_SCALE),
+    'triplet-quarter': scaleFraction(BASE_DURATIONS.quarter, TRIPLET_SCALE),
+    'triplet-eighth': scaleFraction(BASE_DURATIONS.eighth, TRIPLET_SCALE),
+    'triplet-sixteenth': scaleFraction(BASE_DURATIONS.sixteenth, TRIPLET_SCALE),
+    'triplet-thirtysecond': scaleFraction(BASE_DURATIONS.thirtysecond, TRIPLET_SCALE),
+};
+/** Integer tick length of a named duration at the given PPQ. */
+export function ticksFor(duration, ppq) {
+    return fractionToTicks(DURATIONS[duration], ppq);
+}
+/** Every duration name, in the order the table declares them. */
+const DURATION_NAMES = Object.keys(DURATIONS);
+/**
+ * The name of a duration `ticks` long, or `null` when nothing is exactly that.
+ *
+ * The inverse of `ticksFor`, and deliberately exact: a note that is 500 ticks
+ * at 480 PPQ is not a quarter note, it is 500 ticks, and a control that
+ * rounded it to "quarter" would relabel music it cannot represent. Callers
+ * asking "what should the duration selector show" want `null` to mean "no
+ * single name fits", which is a different answer from any name at all.
+ *
+ * Plain search rather than a reverse map: PPQ varies per score, so the tick
+ * values are not constants and a cached map would have to be keyed by it for
+ * the sake of eighteen comparisons.
+ */
+export function durationNameForTicks(ticks, ppq) {
+    return DURATION_NAMES.find(name => ticksFor(name, ppq) === ticks) ?? null;
+}
+/** Integer tick length of one full measure in the given time signature. */
+export function measureDurationTicks(ts, ppq) {
+    return fractionToTicks(fraction(ts.numerator, ts.denominator), ppq);
+}
+/**
+ * Whether a time signature is compound (the beat subdivides into three,
+ * e.g. 6/8, 9/8, 12/8, 6/4): numerator is a multiple of 3 greater than 3.
+ */
+function isCompoundMeter(ts) {
+    return ts.numerator % 3 === 0 && ts.numerator > 3;
+}
+/**
+ * Integer tick length of one beat in the given time signature. Simple meters
+ * beat on a single denominator-note (e.g. 4/4 -> quarter). Compound meters
+ * (numerator a multiple of 3, > 3) beat on a dotted denominator-note grouping
+ * three denominator-notes (e.g. 6/8 -> dotted quarter).
+ */
+export function beatDurationTicks(ts, ppq) {
+    const denominatorNoteTicks = fractionToTicks(fraction(1, ts.denominator), ppq);
+    return isCompoundMeter(ts) ? 3 * denominatorNoteTicks : denominatorNoteTicks;
+}
+/** Tick offsets (relative to measure start) of each beat within a measure. */
+export function beatBoundaries(ts, ppq) {
+    const measureTicks = measureDurationTicks(ts, ppq);
+    const beatTicks = beatDurationTicks(ts, ppq);
+    const boundaries = [];
+    for (let offset = 0; offset < measureTicks; offset += beatTicks) {
+        boundaries.push(offset);
+    }
+    return boundaries;
+}
+//# sourceMappingURL=ticks.js.map

package/dist/domain/time/ticks.js.map

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

package/dist/domain/validation/issues.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Validation issue types (spec §23). `validateScore` (`./validator.ts`)
+ * returns `ValidationIssue[]`; the UI displays them and, via `objectId`/
+ * `trackId`/`measureId`, navigates to the affected object on click.
+ */
+export type ValidationSeverity = 'error' | 'warning';
+export type ValidationIssue = {
+    severity: ValidationSeverity;
+    code: string;
+    message: string;
+    objectId?: string;
+    trackId?: string;
+    measureId?: string;
+};
+/**
+ * Stable, machine-readable codes for every rule `validateScore` checks.
+ * Kept as a `const` object (not a string-literal union on `ValidationIssue`)
+ * so new rules can be added without a breaking type change to consumers
+ * that only pattern-match on known codes.
+ */
+export declare const ISSUE_CODES: {
+    readonly DUPLICATE_ID: "duplicate-id";
+    readonly INVALID_PITCH_RANGE: "invalid-pitch-range";
+    readonly NON_POSITIVE_DURATION: "non-positive-duration";
+    readonly NEGATIVE_TICK: "negative-tick";
+    readonly INVALID_VELOCITY: "invalid-velocity";
+    readonly INVALID_MIDI_PROGRAM: "invalid-midi-program";
+    readonly INVALID_MIDI_CHANNEL: "invalid-midi-channel";
+    readonly INVALID_TIME_SIGNATURE: "invalid-time-signature";
+    readonly INVALID_KEY_SIGNATURE: "invalid-key-signature";
+    readonly MEASURE_OVERFULL: "measure-overfull";
+    readonly MEASURE_UNDERFULL: "measure-underfull";
+    readonly EVENT_OUTSIDE_MEASURE: "event-outside-measure";
+    readonly MISSING_TIE_TARGET: "missing-tie-target";
+    readonly INVALID_TRACK_REFERENCE: "invalid-track-reference";
+    readonly INVALID_VOICE_REFERENCE: "invalid-voice-reference";
+    readonly OVERLAPPING_SAME_PITCH: "overlapping-same-pitch";
+    readonly TOO_MANY_SIMULTANEOUS_NOTES: "too-many-simultaneous-notes";
+    readonly TEMPO_MAP_UNSORTED: "tempo-map-unsorted";
+    readonly INVALID_TEMPO_BPM: "invalid-tempo-bpm";
+    readonly MEASURE_ORDERING: "measure-ordering";
+};
+export type IssueCode = (typeof ISSUE_CODES)[keyof typeof ISSUE_CODES];
+//# sourceMappingURL=issues.d.ts.map

package/dist/domain/validation/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../src/domain/validation/issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;CAqBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/domain/validation/issues.js

@@ -0,0 +1,34 @@
+/**
+ * Validation issue types (spec §23). `validateScore` (`./validator.ts`)
+ * returns `ValidationIssue[]`; the UI displays them and, via `objectId`/
+ * `trackId`/`measureId`, navigates to the affected object on click.
+ */
+/**
+ * Stable, machine-readable codes for every rule `validateScore` checks.
+ * Kept as a `const` object (not a string-literal union on `ValidationIssue`)
+ * so new rules can be added without a breaking type change to consumers
+ * that only pattern-match on known codes.
+ */
+export const ISSUE_CODES = {
+    DUPLICATE_ID: 'duplicate-id',
+    INVALID_PITCH_RANGE: 'invalid-pitch-range',
+    NON_POSITIVE_DURATION: 'non-positive-duration',
+    NEGATIVE_TICK: 'negative-tick',
+    INVALID_VELOCITY: 'invalid-velocity',
+    INVALID_MIDI_PROGRAM: 'invalid-midi-program',
+    INVALID_MIDI_CHANNEL: 'invalid-midi-channel',
+    INVALID_TIME_SIGNATURE: 'invalid-time-signature',
+    INVALID_KEY_SIGNATURE: 'invalid-key-signature',
+    MEASURE_OVERFULL: 'measure-overfull',
+    MEASURE_UNDERFULL: 'measure-underfull',
+    EVENT_OUTSIDE_MEASURE: 'event-outside-measure',
+    MISSING_TIE_TARGET: 'missing-tie-target',
+    INVALID_TRACK_REFERENCE: 'invalid-track-reference',
+    INVALID_VOICE_REFERENCE: 'invalid-voice-reference',
+    OVERLAPPING_SAME_PITCH: 'overlapping-same-pitch',
+    TOO_MANY_SIMULTANEOUS_NOTES: 'too-many-simultaneous-notes',
+    TEMPO_MAP_UNSORTED: 'tempo-map-unsorted',
+    INVALID_TEMPO_BPM: 'invalid-tempo-bpm',
+    MEASURE_ORDERING: 'measure-ordering',
+};
+//# sourceMappingURL=issues.js.map

package/dist/domain/validation/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../../src/domain/validation/issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,uBAAuB,EAAE,yBAAyB;IAClD,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,2BAA2B,EAAE,6BAA6B;IAC1D,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,gBAAgB,EAAE,kBAAkB;CAC5B,CAAC"}

package/dist/domain/validation/validator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Score-validation engine (spec §23). `validateScore` checks a `Score`
+ * against every rule in the Task 4 brief and returns `ValidationIssue[]`
+ * (empty when the score is fully consistent). Pure and read-only: never
+ * mutates its input.
+ */
+import type { Score } from '../../index.js';
+import type { ValidationIssue } from './issues.js';
+/** Validates a `Score` against every rule in spec §23 (Task 4 brief scope). Read-only; never mutates `score`. */
+export declare function validateScore(score: Score): ValidationIssue[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/domain/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/domain/validation/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAGV,KAAK,EAGN,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA0lBnD,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,EAAE,CAsB7D"}