@sudobility/music_types 0.11.20 → 0.11.21

package/dist/test/fixtures.js

@@ -0,0 +1,420 @@
+/**
+ * Score fixtures for the codec suites.
+ *
+ * Copied from `music_lib`'s test tree when the codecs moved here, minus
+ * `testRenderTheme` — that one needs a `RenderTheme`, and nothing in this
+ * package renders anything.
+ */
+import { measureDurationTicks, ticksFor } from '../index.js';
+const FIXED_TIMESTAMP = '2024-01-01T00:00:00.000Z';
+/** A per-call, per-prefix incrementing id generator (deterministic, cheap). */
+function makeIdFactory() {
+    const counters = new Map();
+    return {
+        next(prefix) {
+            const n = counters.get(prefix) ?? 0;
+            counters.set(prefix, n + 1);
+            return `${prefix}-${n}`;
+        },
+    };
+}
+/** Builds consecutive single-voice melody measures from a per-measure list of note specs. */
+function buildMelodyMeasures(measuresOfNotes, ppq, timeSignature, keySignature, trackId, ids) {
+    const measureTicks = measureDurationTicks(timeSignature, ppq);
+    return measuresOfNotes.map((notes, index) => {
+        const startTick = index * measureTicks;
+        const voiceId = ids.next('voice');
+        let cursor = startTick;
+        const events = notes.map(spec => {
+            const durationTicks = ticksFor(spec.duration, ppq);
+            const event = {
+                id: ids.next('note'),
+                pitch: spec.pitch,
+                startTick: cursor,
+                durationTicks,
+                velocity: 80,
+                voiceId,
+                trackId,
+            };
+            cursor += durationTicks;
+            return event;
+        });
+        return {
+            id: ids.next('measure'),
+            index,
+            startTick,
+            durationTicks: measureTicks,
+            timeSignature,
+            keySignature,
+            voices: [{ id: voiceId, name: 'Voice 1', events }],
+        };
+    });
+}
+/** Builds consecutive single-voice measures, each a block chord spanning the full measure. */
+function buildChordMeasures(chordsByMeasure, ppq, timeSignature, keySignature, trackId, ids) {
+    const measureTicks = measureDurationTicks(timeSignature, ppq);
+    return chordsByMeasure.map((pitches, index) => {
+        const startTick = index * measureTicks;
+        const voiceId = ids.next('voice');
+        const events = pitches.map(pitch => ({
+            id: ids.next('note'),
+            pitch,
+            startTick,
+            durationTicks: measureTicks,
+            velocity: 80,
+            voiceId,
+            trackId,
+        }));
+        return {
+            id: ids.next('measure'),
+            index,
+            startTick,
+            durationTicks: measureTicks,
+            timeSignature,
+            keySignature,
+            voices: [{ id: voiceId, name: 'Voice 1', events }],
+        };
+    });
+}
+const C_MAJOR = { fifths: 0, mode: 'major' };
+const FOUR_FOUR = { numerator: 4, denominator: 4 };
+function naturalPitch(step, octave) {
+    return { step, accidental: 0, octave };
+}
+/** An 8-measure C-major "Twinkle Twinkle Little Star" melody on a single piano track. */
+export function twinkleScore() {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const q = (step, octave = 4) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'quarter',
+    });
+    const h = (step, octave = 4) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'half',
+    });
+    const measures = [
+        [q('C'), q('C'), q('G'), q('G')],
+        [q('A'), q('A'), h('G')],
+        [q('F'), q('F'), q('E'), q('E')],
+        [q('D'), q('D'), h('C')],
+        [q('G'), q('G'), q('F'), q('F')],
+        [q('E'), q('E'), h('D')],
+        [q('G'), q('G'), q('F'), q('F')],
+        [q('E'), q('E'), h('D')],
+    ];
+    const trackId = ids.next('track');
+    const track = {
+        id: trackId,
+        name: 'Piano',
+        instrumentName: 'Piano',
+        midiProgram: 0,
+        midiChannel: 0,
+        clef: 'treble',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildMelodyMeasures(measures, ppq, FOUR_FOUR, C_MAJOR, trackId, ids),
+    };
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: 'Twinkle Twinkle Little Star',
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 120 }],
+        tracks: [track],
+    };
+}
+/** A 4-measure two-track score: a treble melody and a supporting bass line. */
+export function twoTrackScore() {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const q = (step, octave) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'quarter',
+    });
+    const w = (step, octave) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'whole',
+    });
+    const trebleMeasures = [
+        [q('C', 4), q('D', 4), q('E', 4), q('F', 4)],
+        [q('G', 4), q('F', 4), q('E', 4), q('D', 4)],
+        [q('C', 4), q('D', 4), q('E', 4), q('F', 4)],
+        [q('G', 4), q('F', 4), q('E', 4), q('D', 4)],
+    ];
+    const bassMeasures = [
+        [w('C', 2)],
+        [w('G', 2)],
+        [w('C', 2)],
+        [w('G', 2)],
+    ];
+    const trebleId = ids.next('track');
+    const bassId = ids.next('track');
+    const treble = {
+        id: trebleId,
+        name: 'Treble',
+        instrumentName: 'Piano',
+        midiProgram: 0,
+        midiChannel: 0,
+        clef: 'treble',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildMelodyMeasures(trebleMeasures, ppq, FOUR_FOUR, C_MAJOR, trebleId, ids),
+    };
+    const bass = {
+        id: bassId,
+        name: 'Bass',
+        instrumentName: 'Acoustic Bass',
+        midiProgram: 32,
+        midiChannel: 1,
+        clef: 'bass',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildMelodyMeasures(bassMeasures, ppq, FOUR_FOUR, C_MAJOR, bassId, ids),
+    };
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: 'Two Track Demo',
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 120 }],
+        tracks: [treble, bass],
+    };
+}
+/**
+ * Three tracks over 2 measures, deliberately plain.
+ *
+ * For tests about *which* tracks are involved — visibility, active-track
+ * resolution, per-track filtering — where two tracks cannot tell "the first
+ * one" apart from "the first visible one", and the music itself is beside the
+ * point.
+ */
+export function threeTrackScore() {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const q = (step, octave) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'quarter',
+    });
+    const measures = [
+        [q('C', 4), q('D', 4), q('E', 4), q('F', 4)],
+        [q('G', 4), q('F', 4), q('E', 4), q('D', 4)],
+    ];
+    const tracks = ['Alpha', 'Beta', 'Gamma'].map((name, index) => {
+        const trackId = ids.next('track');
+        return {
+            id: trackId,
+            name,
+            instrumentName: 'Piano',
+            midiProgram: 0,
+            midiChannel: index,
+            clef: 'treble',
+            volume: 1,
+            pan: 0,
+            muted: false,
+            solo: false,
+            measures: buildMelodyMeasures(measures, ppq, FOUR_FOUR, C_MAJOR, trackId, ids),
+        };
+    });
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: 'Three Track Demo',
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 120 }],
+        tracks,
+    };
+}
+/**
+ * Two tracks with sharply different densities: a treble line of 16
+ * sixteenth notes per measure over a bass of one whole note per measure.
+ * Exercises cross-track timeline sync — the dense track needs a wider
+ * measure than `BASE_MEASURE_WIDTH` and must still share barlines and
+ * tick-aligned x positions with the sparse track.
+ */
+export function denseVsSparseScore() {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const s = (step, octave) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'sixteenth',
+    });
+    const w = (step, octave) => ({
+        pitch: naturalPitch(step, octave),
+        duration: 'whole',
+    });
+    const runUp = ['C', 'D', 'E', 'F', 'G', 'A', 'B']
+        .flatMap(step => [s(step, 4), s(step, 4)])
+        .concat([s('C', 5), s('C', 5)]);
+    const denseMeasures = [runUp, runUp, runUp, runUp];
+    const sparseMeasures = [
+        [w('C', 2)],
+        [w('G', 2)],
+        [w('C', 2)],
+        [w('G', 2)],
+    ];
+    const denseId = ids.next('track');
+    const sparseId = ids.next('track');
+    const dense = {
+        id: denseId,
+        name: 'Dense',
+        instrumentName: 'Piano',
+        midiProgram: 0,
+        midiChannel: 0,
+        clef: 'treble',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildMelodyMeasures(denseMeasures, ppq, FOUR_FOUR, C_MAJOR, denseId, ids),
+    };
+    const sparse = {
+        id: sparseId,
+        name: 'Sparse',
+        instrumentName: 'Acoustic Bass',
+        midiProgram: 32,
+        midiChannel: 1,
+        clef: 'bass',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildMelodyMeasures(sparseMeasures, ppq, FOUR_FOUR, C_MAJOR, sparseId, ids),
+    };
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: 'Dense vs Sparse',
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 120 }],
+        tracks: [dense, sparse],
+    };
+}
+/** A 4-measure I-IV-V-I block-chord progression on a single piano track. */
+export function chordScore() {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const chords = [
+        [naturalPitch('C', 4), naturalPitch('E', 4), naturalPitch('G', 4)], // I
+        [naturalPitch('F', 4), naturalPitch('A', 4), naturalPitch('C', 5)], // IV
+        [naturalPitch('G', 4), naturalPitch('B', 4), naturalPitch('D', 5)], // V
+        [naturalPitch('C', 4), naturalPitch('E', 4), naturalPitch('G', 4)], // I
+    ];
+    const trackId = ids.next('track');
+    const track = {
+        id: trackId,
+        name: 'Piano',
+        instrumentName: 'Piano',
+        midiProgram: 0,
+        midiChannel: 0,
+        clef: 'treble',
+        volume: 1,
+        pan: 0,
+        muted: false,
+        solo: false,
+        measures: buildChordMeasures(chords, ppq, FOUR_FOUR, C_MAJOR, trackId, ids),
+    };
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: 'Chord Progression Demo',
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 90 }],
+        tracks: [track],
+    };
+}
+const STRESS_SCALE = ['C', 'D', 'E', 'F', 'G', 'A', 'B'];
+/**
+ * Generates a score with `trackCount` tracks of `measureCount` measures
+ * each (4 quarter notes per measure, cycling through a C-major scale), for
+ * performance/stress tests. Deterministic and allocation-light.
+ */
+export function stressScore(trackCount, measureCount) {
+    const ids = makeIdFactory();
+    const ppq = 480;
+    const measureTicks = measureDurationTicks(FOUR_FOUR, ppq);
+    const quarterTicks = ticksFor('quarter', ppq);
+    const tracks = [];
+    for (let t = 0; t < trackCount; t += 1) {
+        const trackId = ids.next('track');
+        const measures = [];
+        for (let m = 0; m < measureCount; m += 1) {
+            const startTick = m * measureTicks;
+            const voiceId = ids.next('voice');
+            const events = [];
+            for (let beat = 0; beat < 4; beat += 1) {
+                const step = STRESS_SCALE[(t + m + beat) % STRESS_SCALE.length];
+                events.push({
+                    id: ids.next('note'),
+                    pitch: naturalPitch(step, 4),
+                    startTick: startTick + beat * quarterTicks,
+                    durationTicks: quarterTicks,
+                    velocity: 80,
+                    voiceId,
+                    trackId,
+                });
+            }
+            measures.push({
+                id: ids.next('measure'),
+                index: m,
+                startTick,
+                durationTicks: measureTicks,
+                timeSignature: FOUR_FOUR,
+                keySignature: C_MAJOR,
+                voices: [{ id: voiceId, name: 'Voice 1', events }],
+            });
+        }
+        tracks.push({
+            id: trackId,
+            name: `Track ${t + 1}`,
+            instrumentName: 'Piano',
+            midiProgram: 0,
+            midiChannel: t % 16,
+            clef: 'treble',
+            volume: 1,
+            pan: 0,
+            muted: false,
+            solo: false,
+            measures,
+        });
+    }
+    return {
+        id: ids.next('score'),
+        version: 1,
+        ppq,
+        metadata: {
+            title: `Stress ${trackCount}x${measureCount}`,
+            createdAt: FIXED_TIMESTAMP,
+            updatedAt: FIXED_TIMESTAMP,
+        },
+        tempoMap: [{ id: ids.next('tempo'), tick: 0, bpm: 120 }],
+        tracks,
+    };
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/test/fixtures.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/music_types",
-  "version": "0.11.20",
+  "version": "0.11.21",
   "description": "TypeScript types and Zod schemas for the ScoreSmith music API - scores, generation contracts, project payloads",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,6 +36,7 @@
   "author": "Sudobility",
   "license": "BUSL-1.1",
   "dependencies": {
+    "immer": "^10.0.0 || ^11.0.0",
     "zod": "^4.0.0"
   },
   "peerDependencies": {