@mcptoolshop/ai-jam-sessions 0.1.0

package/dist/songs/midi/ingest.js

@@ -0,0 +1,197 @@
+// ─── MIDI → SongEntry Converter ──────────────────────────────────────────────
+//
+// Parses a standard MIDI file and merges it with a human-authored SongConfig
+// to produce a complete SongEntry ready for the registry.
+//
+// The MIDI provides: notes, timing, duration, structure.
+// The config provides: metadata, musical language, teaching notes, fingering.
+// ─────────────────────────────────────────────────────────────────────────────
+import { parseMidi } from "midi-file";
+import { ticksPerMeasure, computeTotalMeasures, sliceIntoMeasures, resolveTimeSignature, } from "./measures.js";
+import { separateHands, formatHand, DEFAULT_SPLIT_POINT, } from "./hands.js";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_TEMPO = 120;
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Convert a MIDI buffer + human-authored config into a complete SongEntry.
+ */
+export function midiToSongEntry(midiBuffer, config) {
+    const midi = parseMidi(midiBuffer);
+    const tpb = midi.header.ticksPerBeat ?? 480;
+    const splitPoint = config.splitPoint ?? DEFAULT_SPLIT_POINT;
+    // 1. Collect tempo + time signature events across all tracks
+    const tempoEvents = extractTempoEvents(midi);
+    const timeSigEvents = extractTimeSigEvents(midi);
+    // 2. Resolve all notes to absolute ticks + durations
+    const notes = resolveNotes(midi);
+    // 3. Determine effective tempo and time signature
+    const effectiveTempo = config.tempo ?? tempoFromEvents(tempoEvents);
+    const effectiveTimeSig = resolveTimeSignature(timeSigEvents, config.timeSignature);
+    // 4. Compute ticks per measure
+    const tpm = ticksPerMeasure(tpb, effectiveTimeSig.numerator, effectiveTimeSig.denominator);
+    // 5. Determine total measures
+    const totalMeasures = computeTotalMeasures(notes, tpm);
+    // 6. Slice notes into measure buckets
+    const buckets = sliceIntoMeasures(notes, totalMeasures, tpm);
+    // 7. Build measure objects with hand separation + formatting
+    const measures = buildMeasures(buckets, tpb, splitPoint, config);
+    // 8. Compute duration in seconds
+    const lastNoteTick = notes.length > 0
+        ? Math.max(...notes.map(n => n.startTick + n.durationTicks))
+        : 0;
+    const durationSeconds = ticksToSeconds(lastNoteTick, tempoEvents, tpb);
+    return {
+        id: config.id,
+        title: config.title,
+        genre: config.genre,
+        composer: config.composer,
+        arranger: config.arranger,
+        difficulty: config.difficulty,
+        key: config.key,
+        tempo: effectiveTempo,
+        timeSignature: `${effectiveTimeSig.numerator}/${effectiveTimeSig.denominator}`,
+        durationSeconds: Math.round(durationSeconds),
+        musicalLanguage: config.musicalLanguage ?? {
+            description: "",
+            structure: "",
+            keyMoments: [],
+            teachingGoals: [],
+            styleTips: [],
+        },
+        measures,
+        tags: config.tags,
+        source: config.source,
+    };
+}
+// Re-export for barrel convenience
+export { midiNoteToScientific } from "./hands.js";
+// ─── Internal: Extract Events ────────────────────────────────────────────────
+function extractTempoEvents(midi) {
+    const events = [];
+    for (const track of midi.tracks) {
+        let tick = 0;
+        for (const event of track) {
+            tick += event.deltaTime;
+            if (event.type === "setTempo") {
+                events.push({ tick, microsecondsPerBeat: event.microsecondsPerBeat });
+            }
+        }
+    }
+    events.sort((a, b) => a.tick - b.tick);
+    return events;
+}
+function extractTimeSigEvents(midi) {
+    const events = [];
+    for (const track of midi.tracks) {
+        let tick = 0;
+        for (const event of track) {
+            tick += event.deltaTime;
+            if (event.type === "timeSignature") {
+                events.push({
+                    tick,
+                    numerator: event.numerator,
+                    denominator: event.denominator,
+                });
+            }
+        }
+    }
+    events.sort((a, b) => a.tick - b.tick);
+    return events;
+}
+/** Get the initial tempo from MIDI events. */
+function tempoFromEvents(events) {
+    if (events.length === 0)
+        return DEFAULT_TEMPO;
+    return Math.round(60_000_000 / events[0].microsecondsPerBeat);
+}
+// ─── Internal: Resolve Notes ─────────────────────────────────────────────────
+/** Flatten all tracks into resolved notes with absolute tick positions. */
+function resolveNotes(midi) {
+    const notes = [];
+    for (const track of midi.tracks) {
+        let tick = 0;
+        const pending = new Map();
+        for (const event of track) {
+            tick += event.deltaTime;
+            if (event.type === "noteOn" && event.velocity > 0) {
+                const key = `${event.channel}:${event.noteNumber}`;
+                pending.set(key, {
+                    startTick: tick,
+                    velocity: event.velocity,
+                    channel: event.channel,
+                    noteNumber: event.noteNumber,
+                });
+            }
+            else if (event.type === "noteOff" ||
+                (event.type === "noteOn" && event.velocity === 0)) {
+                const key = `${event.channel}:${event.noteNumber}`;
+                const start = pending.get(key);
+                if (start) {
+                    notes.push({
+                        noteNumber: start.noteNumber,
+                        startTick: start.startTick,
+                        durationTicks: tick - start.startTick,
+                        velocity: start.velocity,
+                        channel: start.channel,
+                    });
+                    pending.delete(key);
+                }
+            }
+        }
+    }
+    notes.sort((a, b) => a.startTick - b.startTick || a.noteNumber - b.noteNumber);
+    return notes;
+}
+// ─── Internal: Build Measures ────────────────────────────────────────────────
+/** Build Measure objects from measure buckets. */
+function buildMeasures(buckets, ticksPerBeat, splitPoint, config) {
+    const overrides = new Map();
+    if (config.measureOverrides) {
+        for (const ov of config.measureOverrides) {
+            overrides.set(ov.measure, ov);
+        }
+    }
+    return buckets.map(bucket => {
+        const { rightHand, leftHand } = separateHands(bucket.notes, splitPoint);
+        const measure = {
+            number: bucket.number,
+            rightHand: formatHand(rightHand, ticksPerBeat),
+            leftHand: formatHand(leftHand, ticksPerBeat),
+        };
+        const ov = overrides.get(bucket.number);
+        if (ov?.fingering)
+            measure.fingering = ov.fingering;
+        if (ov?.teachingNote)
+            measure.teachingNote = ov.teachingNote;
+        if (ov?.dynamics)
+            measure.dynamics = ov.dynamics;
+        if (ov?.tempoOverride)
+            measure.tempoOverride = ov.tempoOverride;
+        return measure;
+    });
+}
+// ─── Internal: Tick-to-Time Conversion ───────────────────────────────────────
+/** Convert a tick position to seconds, respecting tempo changes. */
+function ticksToSeconds(targetTick, tempoEvents, ticksPerBeat) {
+    let seconds = 0;
+    let currentTick = 0;
+    let microsecondsPerBeat = tempoEvents.length > 0
+        ? tempoEvents[0].microsecondsPerBeat
+        : 500_000; // 120 BPM default
+    for (const event of tempoEvents) {
+        if (event.tick >= targetTick)
+            break;
+        if (event.tick > currentTick) {
+            const deltaTicks = event.tick - currentTick;
+            seconds += (deltaTicks / ticksPerBeat) * (microsecondsPerBeat / 1_000_000);
+            currentTick = event.tick;
+        }
+        microsecondsPerBeat = event.microsecondsPerBeat;
+    }
+    if (currentTick < targetTick) {
+        const deltaTicks = targetTick - currentTick;
+        seconds += (deltaTicks / ticksPerBeat) * (microsecondsPerBeat / 1_000_000);
+    }
+    return seconds;
+}
+//# sourceMappingURL=ingest.js.map

package/dist/songs/midi/ingest.js.map

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

package/dist/songs/midi/measures.d.ts

@@ -0,0 +1,41 @@
+import type { ResolvedNote, TimeSigEvent } from "./types.js";
+/** A bucket of notes belonging to a single measure. */
+export interface MeasureBucket {
+    /** 1-based measure number. */
+    number: number;
+    /** Absolute tick where this measure starts. */
+    startTick: number;
+    /** Absolute tick where this measure ends. */
+    endTick: number;
+    /** Notes whose startTick falls within this measure. */
+    notes: ResolvedNote[];
+}
+/**
+ * Compute ticks per measure for a given time signature.
+ */
+export declare function ticksPerMeasure(ticksPerBeat: number, numerator: number, denominator: number): number;
+/**
+ * Determine total number of measures needed to contain all notes.
+ */
+export declare function computeTotalMeasures(notes: ResolvedNote[], tpm: number): number;
+/**
+ * Slice notes into measure buckets.
+ */
+export declare function sliceIntoMeasures(notes: ResolvedNote[], totalMeasures: number, tpm: number): MeasureBucket[];
+/**
+ * Parse a time signature string like "4/4" or "3/4".
+ * Returns { numerator, denominator } or defaults to 4/4 on invalid input.
+ */
+export declare function parseTimeSignature(timeSig?: string): {
+    numerator: number;
+    denominator: number;
+};
+/**
+ * Get effective time signature from MIDI events or config string.
+ * Config string takes priority over MIDI events.
+ */
+export declare function resolveTimeSignature(events: TimeSigEvent[], configTimeSig?: string): {
+    numerator: number;
+    denominator: number;
+};
+//# sourceMappingURL=measures.d.ts.map

package/dist/songs/midi/measures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measures.d.ts","sourceRoot":"","sources":["../../../src/songs/midi/measures.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI7D,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,MAAM,GACV,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,aAAa,EAAE,CAgBjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAO5C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EAAE,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAM5C"}

package/dist/songs/midi/measures.js

@@ -0,0 +1,64 @@
+// ─── Measure Slicing ─────────────────────────────────────────────────────────
+//
+// Slices a flat array of resolved notes into measure buckets based on
+// time signature and ticks-per-beat.
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Compute ticks per measure for a given time signature.
+ */
+export function ticksPerMeasure(ticksPerBeat, numerator, denominator) {
+    return ticksPerBeat * numerator * (4 / denominator);
+}
+/**
+ * Determine total number of measures needed to contain all notes.
+ */
+export function computeTotalMeasures(notes, tpm) {
+    if (notes.length === 0)
+        return 1;
+    const lastNoteTick = Math.max(...notes.map(n => n.startTick + n.durationTicks));
+    return Math.max(1, Math.ceil(lastNoteTick / tpm));
+}
+/**
+ * Slice notes into measure buckets.
+ */
+export function sliceIntoMeasures(notes, totalMeasures, tpm) {
+    const buckets = [];
+    for (let m = 0; m < totalMeasures; m++) {
+        const startTick = m * tpm;
+        const endTick = (m + 1) * tpm;
+        buckets.push({
+            number: m + 1,
+            startTick,
+            endTick,
+            notes: notes.filter(n => n.startTick >= startTick && n.startTick < endTick),
+        });
+    }
+    return buckets;
+}
+/**
+ * Parse a time signature string like "4/4" or "3/4".
+ * Returns { numerator, denominator } or defaults to 4/4 on invalid input.
+ */
+export function parseTimeSignature(timeSig) {
+    if (!timeSig)
+        return { numerator: 4, denominator: 4 };
+    const parts = timeSig.split("/").map(Number);
+    if (parts.length === 2 && parts[0] > 0 && parts[1] > 0) {
+        return { numerator: parts[0], denominator: parts[1] };
+    }
+    return { numerator: 4, denominator: 4 };
+}
+/**
+ * Get effective time signature from MIDI events or config string.
+ * Config string takes priority over MIDI events.
+ */
+export function resolveTimeSignature(events, configTimeSig) {
+    if (configTimeSig)
+        return parseTimeSignature(configTimeSig);
+    if (events.length > 0) {
+        return { numerator: events[0].numerator, denominator: events[0].denominator };
+    }
+    return { numerator: 4, denominator: 4 };
+}
+//# sourceMappingURL=measures.js.map

package/dist/songs/midi/measures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measures.js","sourceRoot":"","sources":["../../../src/songs/midi/measures.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,sEAAsE;AACtE,qCAAqC;AACrC,gFAAgF;AAkBhF,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,SAAiB,EACjB,WAAmB;IAEnB,OAAO,YAAY,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,GAAW;IAEX,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,aAAqB,EACrB,GAAW;IAEX,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAE9B,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,CAAC,GAAG,CAAC;YACb,SAAS;YACT,OAAO;YACP,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgB;IAEhB,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,aAAsB;IAEtB,IAAI,aAAa;QAAE,OAAO,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC1C,CAAC"}

package/dist/songs/midi/types.d.ts

@@ -0,0 +1,25 @@
+/** A resolved note with absolute timing from MIDI. */
+export interface ResolvedNote {
+    /** MIDI note number 0-127. */
+    noteNumber: number;
+    /** Start time in ticks from the beginning. */
+    startTick: number;
+    /** Duration in ticks. */
+    durationTicks: number;
+    /** Velocity 0-127. */
+    velocity: number;
+    /** MIDI channel. */
+    channel: number;
+}
+/** A tempo change event with absolute tick position. */
+export interface IngestTempoEvent {
+    tick: number;
+    microsecondsPerBeat: number;
+}
+/** A time signature event with absolute tick position. */
+export interface TimeSigEvent {
+    tick: number;
+    numerator: number;
+    denominator: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/songs/midi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/songs/midi/types.ts"],"names":[],"mappings":"AAOA,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/songs/midi/types.js

@@ -0,0 +1,8 @@
+// ─── MIDI Ingest Types ──────────────────────────────────────────────────────
+//
+// Tick-based types for the MIDI-to-SongEntry conversion pipeline.
+// These are separate from src/midi/types.ts which uses seconds-based timing
+// for real-time playback.
+// ─────────────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/songs/midi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/songs/midi/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,kEAAkE;AAClE,4EAA4E;AAC5E,0BAA0B;AAC1B,gFAAgF"}

package/dist/songs/registry.d.ts

@@ -0,0 +1,37 @@
+import type { SongEntry, Genre, Difficulty, SearchOptions, RegistryStats } from "./types.js";
+/**
+ * Register a song in the global registry.
+ * Throws if the ID is already taken or validation fails.
+ */
+export declare function registerSong(song: SongEntry): void;
+/**
+ * Register multiple songs at once.
+ */
+export declare function registerSongs(entries: SongEntry[]): void;
+/**
+ * Validate a single song entry. Returns an array of error messages (empty = valid).
+ */
+export declare function validateSong(song: SongEntry): string[];
+/**
+ * Validate the entire registry. Throws on first invalid song.
+ */
+export declare function validateRegistry(): void;
+/** Get a song by its unique ID. */
+export declare function getSong(id: string): SongEntry | undefined;
+/** Get all registered songs. */
+export declare function getAllSongs(): SongEntry[];
+/** Get all songs in a specific genre. */
+export declare function getSongsByGenre(genre: Genre): SongEntry[];
+/** Get all songs at a specific difficulty level. */
+export declare function getSongsByDifficulty(difficulty: Difficulty): SongEntry[];
+/**
+ * Search songs with flexible filtering.
+ * The `query` field does a case-insensitive match against title, composer, tags,
+ * and musicalLanguage.description.
+ */
+export declare function searchSongs(options: SearchOptions): SongEntry[];
+/** Get summary statistics about the registry. */
+export declare function getStats(): RegistryStats;
+/** Clear all registered songs. Used when reloading or in tests. */
+export declare function clearRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/songs/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/songs/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AASpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAWlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAIxD;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAuFtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC;AAID,mCAAmC;AACnC,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAEzD;AAED,gCAAgC;AAChC,wBAAgB,WAAW,IAAI,SAAS,EAAE,CAEzC;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,EAAE,CAEzD;AAED,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,CAExE;AAID;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,CAsC/D;AAID,iDAAiD;AACjD,wBAAgB,QAAQ,IAAI,aAAa,CAsBxC;AAID,mEAAmE;AACnE,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/songs/registry.js

@@ -0,0 +1,197 @@
+// ─── Song Registry ──────────────────────────────────────────────────────────
+//
+// Single source of truth for all songs loaded at runtime.
+// Songs are loaded from JSON files (builtin + user directories).
+// The registry provides validation, search, filtering, and stats.
+// ─────────────────────────────────────────────────────────────────────────────
+import { GENRES, DIFFICULTIES } from "./types.js";
+// ─── Internal state ─────────────────────────────────────────────────────────
+const songs = new Map();
+// ─── Registration ───────────────────────────────────────────────────────────
+/**
+ * Register a song in the global registry.
+ * Throws if the ID is already taken or validation fails.
+ */
+export function registerSong(song) {
+    const errors = validateSong(song);
+    if (errors.length > 0) {
+        throw new Error(`Invalid song "${song.id}":\n  - ${errors.join("\n  - ")}`);
+    }
+    if (songs.has(song.id)) {
+        throw new Error(`Duplicate song ID: "${song.id}"`);
+    }
+    songs.set(song.id, song);
+}
+/**
+ * Register multiple songs at once.
+ */
+export function registerSongs(entries) {
+    for (const song of entries) {
+        registerSong(song);
+    }
+}
+// ─── Validation ─────────────────────────────────────────────────────────────
+/**
+ * Validate a single song entry. Returns an array of error messages (empty = valid).
+ */
+export function validateSong(song) {
+    const errors = [];
+    if (!song.id || typeof song.id !== "string") {
+        errors.push("id is required and must be a non-empty string");
+    }
+    else if (!/^[a-z0-9-]+$/.test(song.id)) {
+        errors.push("id must be kebab-case (lowercase alphanumeric + hyphens)");
+    }
+    if (!song.title || typeof song.title !== "string") {
+        errors.push("title is required");
+    }
+    if (!GENRES.includes(song.genre)) {
+        errors.push(`genre must be one of: ${GENRES.join(", ")}`);
+    }
+    if (!DIFFICULTIES.includes(song.difficulty)) {
+        errors.push(`difficulty must be one of: ${DIFFICULTIES.join(", ")}`);
+    }
+    if (!song.key || typeof song.key !== "string") {
+        errors.push("key signature is required");
+    }
+    if (typeof song.tempo !== "number" || song.tempo < 20 || song.tempo > 300) {
+        errors.push("tempo must be a number between 20 and 300 BPM");
+    }
+    if (!song.timeSignature || !/^\d+\/\d+$/.test(song.timeSignature)) {
+        errors.push('timeSignature must be in "N/N" format');
+    }
+    if (typeof song.durationSeconds !== "number" ||
+        song.durationSeconds <= 0) {
+        errors.push("durationSeconds must be a positive number");
+    }
+    // Musical language layer
+    if (!song.musicalLanguage) {
+        errors.push("musicalLanguage is required");
+    }
+    else {
+        if (!song.musicalLanguage.description) {
+            errors.push("musicalLanguage.description is required");
+        }
+        if (!song.musicalLanguage.structure) {
+            errors.push("musicalLanguage.structure is required");
+        }
+        if (!Array.isArray(song.musicalLanguage.keyMoments) ||
+            song.musicalLanguage.keyMoments.length === 0) {
+            errors.push("musicalLanguage.keyMoments must have at least one entry");
+        }
+        if (!Array.isArray(song.musicalLanguage.teachingGoals) ||
+            song.musicalLanguage.teachingGoals.length === 0) {
+            errors.push("musicalLanguage.teachingGoals must have at least one entry");
+        }
+        if (!Array.isArray(song.musicalLanguage.styleTips)) {
+            errors.push("musicalLanguage.styleTips must be an array");
+        }
+    }
+    // Measures
+    if (!Array.isArray(song.measures) || song.measures.length === 0) {
+        errors.push("measures must be a non-empty array");
+    }
+    else {
+        for (let i = 0; i < song.measures.length; i++) {
+            const m = song.measures[i];
+            if (typeof m.number !== "number" || m.number !== i + 1) {
+                errors.push(`measure[${i}].number should be ${i + 1}, got ${m.number}`);
+            }
+            if (!m.rightHand && !m.leftHand) {
+                errors.push(`measure[${i}] must have at least rightHand or leftHand`);
+            }
+        }
+    }
+    if (!Array.isArray(song.tags)) {
+        errors.push("tags must be an array");
+    }
+    return errors;
+}
+/**
+ * Validate the entire registry. Throws on first invalid song.
+ */
+export function validateRegistry() {
+    const allSongs = getAllSongs();
+    if (allSongs.length === 0) {
+        throw new Error("Registry is empty — no songs registered");
+    }
+    console.error(`Registry valid: ${allSongs.length} songs across ${new Set(allSongs.map((s) => s.genre)).size} genres.`);
+}
+// ─── Lookup ─────────────────────────────────────────────────────────────────
+/** Get a song by its unique ID. */
+export function getSong(id) {
+    return songs.get(id);
+}
+/** Get all registered songs. */
+export function getAllSongs() {
+    return [...songs.values()];
+}
+/** Get all songs in a specific genre. */
+export function getSongsByGenre(genre) {
+    return getAllSongs().filter((s) => s.genre === genre);
+}
+/** Get all songs at a specific difficulty level. */
+export function getSongsByDifficulty(difficulty) {
+    return getAllSongs().filter((s) => s.difficulty === difficulty);
+}
+// ─── Search ─────────────────────────────────────────────────────────────────
+/**
+ * Search songs with flexible filtering.
+ * The `query` field does a case-insensitive match against title, composer, tags,
+ * and musicalLanguage.description.
+ */
+export function searchSongs(options) {
+    let results = getAllSongs();
+    if (options.genre) {
+        results = results.filter((s) => s.genre === options.genre);
+    }
+    if (options.difficulty) {
+        results = results.filter((s) => s.difficulty === options.difficulty);
+    }
+    if (options.tags && options.tags.length > 0) {
+        const wanted = new Set(options.tags.map((t) => t.toLowerCase()));
+        results = results.filter((s) => s.tags.some((t) => wanted.has(t.toLowerCase())));
+    }
+    if (options.maxDuration !== undefined) {
+        results = results.filter((s) => s.durationSeconds <= options.maxDuration);
+    }
+    if (options.minDuration !== undefined) {
+        results = results.filter((s) => s.durationSeconds >= options.minDuration);
+    }
+    if (options.query) {
+        const q = options.query.toLowerCase();
+        results = results.filter((s) => s.title.toLowerCase().includes(q) ||
+            s.composer?.toLowerCase().includes(q) ||
+            s.tags.some((t) => t.toLowerCase().includes(q)) ||
+            s.musicalLanguage.description.toLowerCase().includes(q));
+    }
+    return results;
+}
+// ─── Stats ──────────────────────────────────────────────────────────────────
+/** Get summary statistics about the registry. */
+export function getStats() {
+    const allSongs = getAllSongs();
+    const byGenre = {};
+    for (const g of GENRES)
+        byGenre[g] = 0;
+    for (const s of allSongs)
+        byGenre[s.genre]++;
+    const byDifficulty = {};
+    for (const d of DIFFICULTIES)
+        byDifficulty[d] = 0;
+    for (const s of allSongs)
+        byDifficulty[s.difficulty]++;
+    const totalMeasures = allSongs.reduce((sum, s) => sum + s.measures.length, 0);
+    return {
+        totalSongs: allSongs.length,
+        byGenre,
+        byDifficulty,
+        totalMeasures,
+    };
+}
+// ─── Reset ──────────────────────────────────────────────────────────────────
+/** Clear all registered songs. Used when reloading or in tests. */
+export function clearRegistry() {
+    songs.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/songs/registry.js.map

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