@mcptoolshop/ai_jam_session 0.1.0

package/dist/songs/config/schema.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+export declare const MeasureOverrideSchema: z.ZodObject<{
+    measure: z.ZodNumber;
+    fingering: z.ZodOptional<z.ZodString>;
+    teachingNote: z.ZodOptional<z.ZodString>;
+    dynamics: z.ZodOptional<z.ZodString>;
+    tempoOverride: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MusicalLanguageSchema: z.ZodObject<{
+    description: z.ZodString;
+    structure: z.ZodString;
+    keyMoments: z.ZodArray<z.ZodString>;
+    teachingGoals: z.ZodArray<z.ZodString>;
+    styleTips: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const SongConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    genre: z.ZodEnum<{
+        classical: "classical";
+        jazz: "jazz";
+        pop: "pop";
+        blues: "blues";
+        rock: "rock";
+        rnb: "rnb";
+        latin: "latin";
+        film: "film";
+        ragtime: "ragtime";
+        "new-age": "new-age";
+    }>;
+    composer: z.ZodOptional<z.ZodString>;
+    arranger: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodEnum<{
+        beginner: "beginner";
+        intermediate: "intermediate";
+        advanced: "advanced";
+    }>;
+    key: z.ZodString;
+    tempo: z.ZodOptional<z.ZodNumber>;
+    timeSignature: z.ZodOptional<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    musicalLanguage: z.ZodObject<{
+        description: z.ZodString;
+        structure: z.ZodString;
+        keyMoments: z.ZodArray<z.ZodString>;
+        teachingGoals: z.ZodArray<z.ZodString>;
+        styleTips: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    measureOverrides: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        measure: z.ZodNumber;
+        fingering: z.ZodOptional<z.ZodString>;
+        teachingNote: z.ZodOptional<z.ZodString>;
+        dynamics: z.ZodOptional<z.ZodString>;
+        tempoOverride: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    splitPoint: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SongConfig = z.infer<typeof SongConfigSchema>;
+export type MeasureOverride = z.infer<typeof MeasureOverrideSchema>;
+export interface ConfigError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate a SongConfig object using the zod schema.
+ * Returns an empty array if valid.
+ */
+export declare function validateConfig(config: unknown): ConfigError[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/songs/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/songs/config/schema.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe3B,CAAC;AAIH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,EAAE,CAQ7D"}

package/dist/songs/config/schema.js

@@ -0,0 +1,53 @@
+// ─── Song Config Schema ──────────────────────────────────────────────────────
+//
+// Human-authored config that accompanies each .mid file.
+// The MIDI ingest pipeline merges this config with extracted note data
+// to produce a complete SongEntry.
+// ─────────────────────────────────────────────────────────────────────────────
+import { z } from "zod";
+import { GENRES, DIFFICULTIES } from "../types.js";
+// ─── Zod Schemas ─────────────────────────────────────────────────────────────
+export const MeasureOverrideSchema = z.object({
+    measure: z.number().int().min(1),
+    fingering: z.string().optional(),
+    teachingNote: z.string().optional(),
+    dynamics: z.string().optional(),
+    tempoOverride: z.number().min(10).max(400).optional(),
+});
+export const MusicalLanguageSchema = z.object({
+    description: z.string().min(1),
+    structure: z.string().min(1),
+    keyMoments: z.array(z.string()),
+    teachingGoals: z.array(z.string()),
+    styleTips: z.array(z.string()),
+});
+export const SongConfigSchema = z.object({
+    id: z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, "id must be kebab-case"),
+    title: z.string().min(1),
+    genre: z.enum(GENRES),
+    composer: z.string().optional(),
+    arranger: z.string().optional(),
+    difficulty: z.enum(DIFFICULTIES),
+    key: z.string().min(1),
+    tempo: z.number().min(10).max(400).optional(),
+    timeSignature: z.string().optional(),
+    tags: z.array(z.string()),
+    source: z.string().optional(),
+    musicalLanguage: MusicalLanguageSchema,
+    measureOverrides: z.array(MeasureOverrideSchema).optional(),
+    splitPoint: z.number().int().min(0).max(127).optional(),
+});
+/**
+ * Validate a SongConfig object using the zod schema.
+ * Returns an empty array if valid.
+ */
+export function validateConfig(config) {
+    const result = SongConfigSchema.safeParse(config);
+    if (result.success)
+        return [];
+    return result.error.issues.map((issue) => ({
+        field: issue.path.join(".") || "root",
+        message: issue.message,
+    }));
+}
+//# sourceMappingURL=schema.js.map

package/dist/songs/config/schema.js.map

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

package/dist/songs/index.d.ts

@@ -0,0 +1,16 @@
+export type { SongEntry, Measure, MusicalLanguage, Genre, Difficulty, NoteFormat, RegistryStats, SearchOptions, } from "./types.js";
+export { GENRES, DIFFICULTIES } from "./types.js";
+export { registerSong, registerSongs, validateSong, validateRegistry, getSong, getAllSongs, getSongsByGenre, getSongsByDifficulty, searchSongs, getStats, clearRegistry, } from "./registry.js";
+export { loadSongsFromDir, loadSongFile, saveSong, initializeRegistry, } from "./loader.js";
+export { midiToSongEntry, midiNoteToScientific } from "./midi/ingest.js";
+export { separateHands, groupIntoChords, isChord, formatNote, formatHand, chordToString, ticksToDuration, } from "./midi/hands.js";
+export type { HandSplit } from "./midi/hands.js";
+export { ticksPerMeasure, computeTotalMeasures, sliceIntoMeasures, parseTimeSignature, resolveTimeSignature, } from "./midi/measures.js";
+export type { MeasureBucket } from "./midi/measures.js";
+export type { ResolvedNote, IngestTempoEvent, TimeSigEvent } from "./midi/types.js";
+export { SongConfigSchema, MusicalLanguageSchema, MeasureOverrideSchema, validateConfig, } from "./config/schema.js";
+export type { SongConfig, MeasureOverride, ConfigError } from "./config/schema.js";
+export { loadSongConfigs, loadSongConfig, listConfigIds } from "./config/loader.js";
+export { generateJamBrief, formatJamBrief, inferChord, computeContour, getStyleGuidance } from "./jam.js";
+export type { JamBrief, JamBriefOptions, ChordMeasure, MelodyMeasure } from "./jam.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/songs/index.ts"],"names":[],"mappings":"AAMA,YAAY,EACV,SAAS,EACT,OAAO,EACP,eAAe,EACf,KAAK,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpF,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC1G,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/songs/index.js

@@ -0,0 +1,20 @@
+// ─── Songs Subsystem ────────────────────────────────────────────────────────
+//
+// Everything for the song library: types, registry, loader, MIDI ingest, config.
+// ─────────────────────────────────────────────────────────────────────────────
+export { GENRES, DIFFICULTIES } from "./types.js";
+// Registry
+export { registerSong, registerSongs, validateSong, validateRegistry, getSong, getAllSongs, getSongsByGenre, getSongsByDifficulty, searchSongs, getStats, clearRegistry, } from "./registry.js";
+// Song loader (JSON files → registry)
+export { loadSongsFromDir, loadSongFile, saveSong, initializeRegistry, } from "./loader.js";
+// MIDI ingest pipeline
+export { midiToSongEntry, midiNoteToScientific } from "./midi/ingest.js";
+export { separateHands, groupIntoChords, isChord, formatNote, formatHand, chordToString, ticksToDuration, } from "./midi/hands.js";
+export { ticksPerMeasure, computeTotalMeasures, sliceIntoMeasures, parseTimeSignature, resolveTimeSignature, } from "./midi/measures.js";
+// Config schemas
+export { SongConfigSchema, MusicalLanguageSchema, MeasureOverrideSchema, validateConfig, } from "./config/schema.js";
+// Config loader
+export { loadSongConfigs, loadSongConfig, listConfigIds } from "./config/loader.js";
+// Jam session
+export { generateJamBrief, formatJamBrief, inferChord, computeContour, getStyleGuidance } from "./jam.js";
+//# sourceMappingURL=index.js.map

package/dist/songs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/songs/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAchF,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElD,WAAW;AACX,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,sCAAsC;AACtC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,aAAa,EACb,eAAe,EACf,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAM5B,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpF,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/songs/jam.d.ts

@@ -0,0 +1,48 @@
+import type { SongEntry, Genre, Difficulty } from "./types.js";
+export interface JamBriefOptions {
+    /** Target genre for reinterpretation. */
+    style?: Genre;
+    /** Target mood (e.g., "upbeat", "melancholic", "dreamy"). */
+    mood?: string;
+    /** Target difficulty level. */
+    difficulty?: Difficulty;
+    /** Measure range to focus on, e.g., "1-8". */
+    measures?: string;
+}
+export interface ChordMeasure {
+    measure: number;
+    leftHand: string;
+    impliedChord: string;
+}
+export interface MelodyMeasure {
+    measure: number;
+    rightHand: string;
+    contour: "ascending" | "descending" | "static" | "arc";
+}
+export interface JamBrief {
+    source: {
+        id: string;
+        title: string;
+        composer?: string;
+        genre: Genre;
+        key: string;
+        tempo: number;
+        timeSignature: string;
+        structure: string;
+    };
+    chordProgression: ChordMeasure[];
+    melodyOutline: MelodyMeasure[];
+    styleGuidance: string[];
+    instructions: string[];
+}
+/** Infer a chord symbol from a left-hand notation string. */
+export declare function inferChord(leftHand: string): string;
+/** Classify the melodic contour of a right-hand notation string. */
+export declare function computeContour(rightHand: string): "ascending" | "descending" | "static" | "arc";
+/** Get style guidance strings for a target genre and optional mood. */
+export declare function getStyleGuidance(genre?: Genre, mood?: string): string[];
+/** Generate a jam brief from a source song. */
+export declare function generateJamBrief(song: SongEntry, options?: JamBriefOptions): JamBrief;
+/** Format a JamBrief as readable markdown text for the LLM. */
+export declare function formatJamBrief(brief: JamBrief, options?: JamBriefOptions): string;
+//# sourceMappingURL=jam.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jam.d.ts","sourceRoot":"","sources":["../../src/songs/jam.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAW,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxE,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;CACxD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,KAAK,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA+FD,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUnD;AAID,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,KAAK,CAyB/F;AAsFD,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvE;AAYD,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAsDzF;AAID,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAsDrF"}

package/dist/songs/jam.js

@@ -0,0 +1,324 @@
+// ─── Jam Session ────────────────────────────────────────────────────────────
+//
+// Extracts a structured "jam brief" from a source song so an LLM can create
+// its own interpretation. The brief includes chord analysis, melody outline,
+// structure, and genre-specific style guidance.
+//
+// This is a read-only analysis tool — the LLM uses the brief as source
+// material, then creates its own SongEntry via add_song and plays it.
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Pitch Utilities ────────────────────────────────────────────────────────
+const NOTE_NAMES = {
+    C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11,
+};
+/** Parse a note token (e.g., "C4:q", "F#5", "Bb3:h") into a MIDI number. Returns -1 for rests. */
+function tokenToMidi(token) {
+    const clean = token.split(":")[0].trim();
+    if (clean === "R" || clean === "r")
+        return -1;
+    const match = clean.match(/^([A-Ga-g])(#|b)?(\d)$/);
+    if (!match)
+        return -1;
+    const [, letter, accidental, octStr] = match;
+    let midi = (parseInt(octStr, 10) + 1) * 12 + NOTE_NAMES[letter.toUpperCase()];
+    if (accidental === "#")
+        midi += 1;
+    if (accidental === "b")
+        midi -= 1;
+    return midi;
+}
+/** Extract just the note name (e.g., "C", "F#", "Bb") from a token. */
+function tokenToNoteName(token) {
+    const clean = token.split(":")[0].trim();
+    if (clean === "R" || clean === "r")
+        return null;
+    const match = clean.match(/^([A-Ga-g])(#|b)?(\d)$/);
+    if (!match)
+        return null;
+    const [, letter, accidental] = match;
+    return letter.toUpperCase() + (accidental ?? "");
+}
+/** Convert a note name to pitch class (0-11). */
+function nameToPitchClass(name) {
+    const letter = name.charAt(0);
+    let pc = NOTE_NAMES[letter] ?? 0;
+    if (name.length > 1) {
+        if (name.charAt(1) === "#")
+            pc = (pc + 1) % 12;
+        if (name.charAt(1) === "b")
+            pc = (pc + 11) % 12;
+    }
+    return pc;
+}
+// ─── Chord Inference ────────────────────────────────────────────────────────
+const PC_NAMES = ["C", "C#", "D", "Eb", "E", "F", "F#", "G", "Ab", "A", "Bb", "B"];
+const CHORD_TEMPLATES = [
+    { name: "maj", intervals: [0, 4, 7] },
+    { name: "m", intervals: [0, 3, 7] },
+    { name: "7", intervals: [0, 4, 7, 10] },
+    { name: "maj7", intervals: [0, 4, 7, 11] },
+    { name: "m7", intervals: [0, 3, 7, 10] },
+    { name: "dim", intervals: [0, 3, 6] },
+    { name: "m7b5", intervals: [0, 3, 6, 10] },
+    { name: "aug", intervals: [0, 4, 8] },
+    { name: "sus4", intervals: [0, 5, 7] },
+    { name: "sus2", intervals: [0, 2, 7] },
+];
+/**
+ * Best-effort chord inference from a set of pitch classes.
+ * Tries each pitch class as a potential root and matches against templates.
+ */
+function inferChordFromPitchClasses(pitchClasses) {
+    if (pitchClasses.length === 0)
+        return "N/A";
+    if (pitchClasses.length === 1)
+        return PC_NAMES[pitchClasses[0]];
+    const unique = [...new Set(pitchClasses)];
+    let bestMatch = "";
+    let bestScore = 0;
+    for (const root of unique) {
+        const intervals = unique.map(pc => (pc - root + 12) % 12).sort((a, b) => a - b);
+        for (const tmpl of CHORD_TEMPLATES) {
+            // Count how many template intervals are present
+            const matched = tmpl.intervals.filter(iv => intervals.includes(iv)).length;
+            const score = matched / tmpl.intervals.length;
+            if (score > bestScore || (score === bestScore && tmpl.intervals.length > 3)) {
+                bestScore = score;
+                const suffix = tmpl.name === "maj" ? "" : tmpl.name;
+                bestMatch = PC_NAMES[root] + suffix;
+            }
+        }
+    }
+    return bestScore >= 0.66 ? bestMatch : PC_NAMES[unique[0]]; // fallback to bass note
+}
+/** Infer a chord symbol from a left-hand notation string. */
+export function inferChord(leftHand) {
+    const tokens = leftHand.split(/\s+/).filter(Boolean);
+    const pitchClasses = [];
+    for (const tok of tokens) {
+        const name = tokenToNoteName(tok);
+        if (name)
+            pitchClasses.push(nameToPitchClass(name));
+    }
+    return inferChordFromPitchClasses(pitchClasses);
+}
+// ─── Contour Analysis ───────────────────────────────────────────────────────
+/** Classify the melodic contour of a right-hand notation string. */
+export function computeContour(rightHand) {
+    const tokens = rightHand.split(/\s+/).filter(Boolean);
+    const midis = [];
+    for (const tok of tokens) {
+        const m = tokenToMidi(tok);
+        if (m >= 0)
+            midis.push(m);
+    }
+    if (midis.length <= 1)
+        return "static";
+    const first = midis[0];
+    const last = midis[midis.length - 1];
+    const mid = midis[Math.floor(midis.length / 2)];
+    const diff = last - first;
+    // Check for arc: goes up then down, or down then up
+    if (midis.length >= 3) {
+        const goesUpThenDown = mid > first && mid > last;
+        const goesDownThenUp = mid < first && mid < last;
+        if (goesUpThenDown || goesDownThenUp)
+            return "arc";
+    }
+    if (Math.abs(diff) <= 1)
+        return "static";
+    return diff > 0 ? "ascending" : "descending";
+}
+// ─── Style Guidance ─────────────────────────────────────────────────────────
+const STYLE_HINTS = {
+    classical: [
+        "Maintain strict tempo and dynamic contrasts",
+        "Use rubato sparingly at phrase endings",
+        "Voice the melody above accompaniment figures",
+        "Pedal changes on harmonic shifts",
+        "Observe all articulation markings (legato, staccato)",
+    ],
+    jazz: [
+        "Swing eighths: long-short feel, emphasis on beats 2 and 4",
+        "Add 7th, 9th, and 13th extensions to chords",
+        "Shell voicings in left hand (root + 7th or 3rd + 7th)",
+        "Chromatic approach notes and passing tones in melody",
+        "Walking bass line: stepwise motion connecting chord roots",
+    ],
+    pop: [
+        "Steady eighth-note pulse in left hand (broken chords or arpeggios)",
+        "Keep melody simple and singable",
+        "Build intensity through verse → chorus dynamics",
+        "Use sustain pedal freely for full sound",
+        "Rhythmic consistency matters more than harmonic complexity",
+    ],
+    blues: [
+        "Shuffle feel: dotted-eighth + sixteenth pattern",
+        "Minor pentatonic scale for melody embellishment",
+        "Call-and-response between hands",
+        "12-bar blues form if restructuring",
+        "Blue notes: b3, b5, b7 for authentic color",
+    ],
+    rock: [
+        "Strong downbeats with octave bass",
+        "Power chord voicings (root + fifth) in left hand",
+        "Driving eighth-note rhythm, slight accent on backbeats",
+        "Build tension with dynamics, release on chorus",
+        "Keep it raw — precision matters less than energy",
+    ],
+    rnb: [
+        "Smooth voice leading between chords",
+        "Extended harmonies: 9ths, 11ths, 13ths",
+        "Syncopated rhythm — anticipate the beat",
+        "Gospel-influenced passing chords and suspensions",
+        "Gentle touch, let notes breathe with pedal",
+    ],
+    latin: [
+        "Bossa nova: bass note on 1, chord on the 'and' of 2",
+        "Anticipation: place chords just before the downbeat",
+        "Clave rhythm awareness (3-2 or 2-3 pattern)",
+        "Light touch, minimal sustain pedal",
+        "Melody should float above a steady rhythmic foundation",
+    ],
+    film: [
+        "Cinematic dynamics: start sparse, build to full texture",
+        "Arpeggiated patterns create motion and atmosphere",
+        "Wide voicings spanning 2+ octaves for orchestral feel",
+        "Rubato and tempo flexibility for emotional expression",
+        "Let silence and sustain do the storytelling",
+    ],
+    ragtime: [
+        "Strict tempo — ragtime swings from rhythm, not rubato",
+        "Left hand: oom-pah bass (low note on 1 & 3, chord on 2 & 4)",
+        "Right hand: syncopated melody against steady left hand",
+        "Crisp articulation, minimal pedal",
+        "Accent the off-beat syncopations in the melody",
+    ],
+    "new-age": [
+        "Gentle arpeggiated patterns, let notes ring with pedal",
+        "Slow harmonic rhythm — let each chord breathe",
+        "Use open voicings (root-fifth-octave) for spaciousness",
+        "Dynamics should be subtle, mostly pp to mp",
+        "Create a meditative, flowing atmosphere",
+    ],
+};
+const MOOD_HINTS = {
+    upbeat: ["Increase tempo 10-20%", "Accent rhythmic drive", "Use brighter register (higher octave)"],
+    melancholic: ["Slow down 10-15%", "Minor key reharmonization", "Use lower register, softer dynamics"],
+    dreamy: ["Generous pedal, let harmonies blend", "Rubato tempo", "Arpeggiate chords instead of blocking"],
+    energetic: ["Strong accents on downbeats", "Full dynamic range", "Use octave doublings for power"],
+    gentle: ["Soft dynamics (pp-mp)", "Legato touch throughout", "Sparse left hand, let melody lead"],
+    playful: ["Staccato articulation", "Syncopated accents", "Contrast registers for surprise"],
+};
+/** Get style guidance strings for a target genre and optional mood. */
+export function getStyleGuidance(genre, mood) {
+    const hints = [];
+    if (genre)
+        hints.push(...STYLE_HINTS[genre]);
+    if (mood) {
+        const key = mood.toLowerCase();
+        if (MOOD_HINTS[key]) {
+            hints.push(...MOOD_HINTS[key]);
+        }
+        else {
+            hints.push(`Interpret with a "${mood}" feel — adjust dynamics, tempo, and articulation accordingly`);
+        }
+    }
+    return hints;
+}
+// ─── Jam Brief Generation ───────────────────────────────────────────────────
+/** Parse a measure range string like "1-8" into [start, end] (0-based indices). */
+function parseMeasureRange(rangeStr, total) {
+    const parts = rangeStr.split("-").map(s => parseInt(s.trim(), 10));
+    const start = Math.max(0, (parts[0] ?? 1) - 1);
+    const end = Math.min(total - 1, (parts[1] ?? parts[0] ?? total) - 1);
+    return [start, end];
+}
+/** Generate a jam brief from a source song. */
+export function generateJamBrief(song, options = {}) {
+    // Determine measure range
+    let measures = song.measures;
+    if (options.measures) {
+        const [start, end] = parseMeasureRange(options.measures, song.measures.length);
+        measures = song.measures.slice(start, end + 1);
+    }
+    // Analyze chords
+    const chordProgression = measures.map(m => ({
+        measure: m.number,
+        leftHand: m.leftHand,
+        impliedChord: inferChord(m.leftHand),
+    }));
+    // Analyze melody
+    const melodyOutline = measures.map(m => ({
+        measure: m.number,
+        rightHand: m.rightHand,
+        contour: computeContour(m.rightHand),
+    }));
+    // Style guidance
+    const styleGuidance = getStyleGuidance(options.style ?? song.genre, options.mood);
+    // Build instructions
+    const targetStyle = options.style ?? song.genre;
+    const targetMood = options.mood ? ` with a ${options.mood} feel` : "";
+    const targetDiff = options.difficulty ? ` at ${options.difficulty} level` : "";
+    const instructions = [
+        `Create your own ${targetStyle} interpretation of "${song.title}"${targetMood}${targetDiff}.`,
+        `Use the chord progression and melody outline as your starting point.`,
+        `Reharmonize, embellish, or simplify as you see fit — this is YOUR version.`,
+        `Write a new SongEntry JSON with id "jam-${song.id}-${targetStyle}" and save with add_song.`,
+        `Then play it with play_song to hear your creation.`,
+    ];
+    return {
+        source: {
+            id: song.id,
+            title: song.title,
+            composer: song.composer,
+            genre: song.genre,
+            key: song.key,
+            tempo: song.tempo,
+            timeSignature: song.timeSignature,
+            structure: song.musicalLanguage.structure,
+        },
+        chordProgression,
+        melodyOutline,
+        styleGuidance,
+        instructions,
+    };
+}
+// ─── Brief Formatting ───────────────────────────────────────────────────────
+/** Format a JamBrief as readable markdown text for the LLM. */
+export function formatJamBrief(brief, options = {}) {
+    const s = brief.source;
+    const targetStyle = options.style ?? s.genre;
+    const moodLabel = options.mood ? `, ${options.mood}` : "";
+    const rangeLabel = options.measures ? ` (measures ${options.measures})` : "";
+    const lines = [
+        `# Jam Brief: ${s.title} → ${targetStyle}${moodLabel}`,
+        ``,
+        `## Source Material`,
+        `- **Original:** ${s.title}${s.composer ? ` by ${s.composer}` : ""}`,
+        `- **Genre:** ${s.genre} → ${targetStyle}${s.genre === targetStyle ? " (same genre reinterpretation)" : ""}`,
+        `- **Key:** ${s.key} | **Tempo:** ${s.tempo} BPM | **Time:** ${s.timeSignature}`,
+        `- **Structure:** ${s.structure}`,
+        ``,
+        `## Chord Progression${rangeLabel}`,
+        `| Measure | Left Hand | Implied Chord |`,
+        `|---------|-----------|---------------|`,
+    ];
+    for (const cm of brief.chordProgression) {
+        lines.push(`| ${cm.measure} | ${cm.leftHand} | ${cm.impliedChord} |`);
+    }
+    lines.push(``, `## Melody Outline${rangeLabel}`, `| Measure | Right Hand | Contour |`, `|---------|-----------|---------|`);
+    for (const mm of brief.melodyOutline) {
+        lines.push(`| ${mm.measure} | ${mm.rightHand} | ${mm.contour} |`);
+    }
+    lines.push(``, `## Style Guidance (target: ${targetStyle}${moodLabel})`);
+    for (const hint of brief.styleGuidance) {
+        lines.push(`- ${hint}`);
+    }
+    lines.push(``, `## Your Mission`);
+    for (let i = 0; i < brief.instructions.length; i++) {
+        lines.push(`${i + 1}. ${brief.instructions[i]}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=jam.js.map

package/dist/songs/jam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jam.js","sourceRoot":"","sources":["../../src/songs/jam.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AACvE,sEAAsE;AACtE,gFAAgF;AA8ChF,+EAA+E;AAE/E,MAAM,UAAU,GAA2B;IACzC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;CAC1C,CAAC;AAEF,kGAAkG;AAClG,SAAS,WAAW,CAAC,KAAa;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IAC7C,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9E,IAAI,UAAU,KAAK,GAAG;QAAE,IAAI,IAAI,CAAC,CAAC;IAClC,IAAI,UAAU,KAAK,GAAG;QAAE,IAAI,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;IACrC,OAAO,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,iDAAiD;AACjD,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAE/E,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAOnF,MAAM,eAAe,GAAoB;IACvC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACrC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACnC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;IACvC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;IAC1C,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;IACxC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACrC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE;IAC1C,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACrC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IACtC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;CACvC,CAAC;AAEF;;;GAGG;AACH,SAAS,0BAA0B,CAAC,YAAsB;IACxD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1C,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACnC,gDAAgD;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3E,MAAM,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;YAE9C,IAAI,KAAK,GAAG,SAAS,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5E,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpD,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,wBAAwB;AACtF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,IAAI;YAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED,+EAA+E;AAE/E,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEvC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B,oDAAoD;IACpD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,cAAc,GAAG,GAAG,GAAG,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC;QACjD,MAAM,cAAc,GAAG,GAAG,GAAG,KAAK,IAAI,GAAG,GAAG,IAAI,CAAC;QACjD,IAAI,cAAc,IAAI,cAAc;YAAE,OAAO,KAAK,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAE/E,MAAM,WAAW,GAA4B;IAC3C,SAAS,EAAE;QACT,6CAA6C;QAC7C,wCAAwC;QACxC,8CAA8C;QAC9C,kCAAkC;QAClC,sDAAsD;KACvD;IACD,IAAI,EAAE;QACJ,2DAA2D;QAC3D,6CAA6C;QAC7C,uDAAuD;QACvD,sDAAsD;QACtD,2DAA2D;KAC5D;IACD,GAAG,EAAE;QACH,oEAAoE;QACpE,iCAAiC;QACjC,iDAAiD;QACjD,yCAAyC;QACzC,4DAA4D;KAC7D;IACD,KAAK,EAAE;QACL,iDAAiD;QACjD,iDAAiD;QACjD,iCAAiC;QACjC,oCAAoC;QACpC,4CAA4C;KAC7C;IACD,IAAI,EAAE;QACJ,mCAAmC;QACnC,kDAAkD;QAClD,wDAAwD;QACxD,gDAAgD;QAChD,kDAAkD;KACnD;IACD,GAAG,EAAE;QACH,qCAAqC;QACrC,wCAAwC;QACxC,yCAAyC;QACzC,kDAAkD;QAClD,4CAA4C;KAC7C;IACD,KAAK,EAAE;QACL,qDAAqD;QACrD,qDAAqD;QACrD,6CAA6C;QAC7C,oCAAoC;QACpC,wDAAwD;KACzD;IACD,IAAI,EAAE;QACJ,yDAAyD;QACzD,mDAAmD;QACnD,uDAAuD;QACvD,uDAAuD;QACvD,6CAA6C;KAC9C;IACD,OAAO,EAAE;QACP,uDAAuD;QACvD,6DAA6D;QAC7D,wDAAwD;QACxD,mCAAmC;QACnC,gDAAgD;KACjD;IACD,SAAS,EAAE;QACT,wDAAwD;QACxD,+CAA+C;QAC/C,wDAAwD;QACxD,4CAA4C;QAC5C,yCAAyC;KAC1C;CACF,CAAC;AAEF,MAAM,UAAU,GAA6B;IAC3C,MAAM,EAAE,CAAC,uBAAuB,EAAE,uBAAuB,EAAE,uCAAuC,CAAC;IACnG,WAAW,EAAE,CAAC,kBAAkB,EAAE,2BAA2B,EAAE,qCAAqC,CAAC;IACrG,MAAM,EAAE,CAAC,qCAAqC,EAAE,cAAc,EAAE,uCAAuC,CAAC;IACxG,SAAS,EAAE,CAAC,6BAA6B,EAAE,oBAAoB,EAAE,gCAAgC,CAAC;IAClG,MAAM,EAAE,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,mCAAmC,CAAC;IACjG,OAAO,EAAE,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,iCAAiC,CAAC;CAC5F,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,IAAa;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAE7C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,+DAA+D,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAE/E,mFAAmF;AACnF,SAAS,iBAAiB,CAAC,QAAgB,EAAE,KAAa;IACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,UAA2B,EAAE;IAC7E,0BAA0B;IAC1B,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/E,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,iBAAiB;IACjB,MAAM,gBAAgB,GAAmB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC,CAAC,MAAM;QACjB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;KACrC,CAAC,CAAC,CAAC;IAEJ,iBAAiB;IACjB,MAAM,aAAa,GAAoB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,OAAO,EAAE,CAAC,CAAC,MAAM;QACjB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;KACrC,CAAC,CAAC,CAAC;IAEJ,iBAAiB;IACjB,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,qBAAqB;IACrB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,UAAU,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/E,MAAM,YAAY,GAAG;QACnB,mBAAmB,WAAW,uBAAuB,IAAI,CAAC,KAAK,IAAI,UAAU,GAAG,UAAU,GAAG;QAC7F,sEAAsE;QACtE,4EAA4E;QAC5E,2CAA2C,IAAI,CAAC,EAAE,IAAI,WAAW,2BAA2B;QAC5F,oDAAoD;KACrD,CAAC;IAEF,OAAO;QACL,MAAM,EAAE;YACN,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS;SAC1C;QACD,gBAAgB;QAChB,aAAa;QACb,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,UAA2B,EAAE;IAC3E,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,MAAM,KAAK,GAAa;QACtB,gBAAgB,CAAC,CAAC,KAAK,MAAM,WAAW,GAAG,SAAS,EAAE;QACtD,EAAE;QACF,oBAAoB;QACpB,mBAAmB,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACpE,gBAAgB,CAAC,CAAC,KAAK,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5G,cAAc,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,KAAK,oBAAoB,CAAC,CAAC,aAAa,EAAE;QAChF,oBAAoB,CAAC,CAAC,SAAS,EAAE;QACjC,EAAE;QACF,uBAAuB,UAAU,EAAE;QACnC,yCAAyC;QACzC,yCAAyC;KAC1C,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,MAAM,EAAE,CAAC,QAAQ,MAAM,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,oBAAoB,UAAU,EAAE,EAChC,oCAAoC,EACpC,mCAAmC,CACpC,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,OAAO,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,8BAA8B,WAAW,GAAG,SAAS,GAAG,CACzD,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iBAAiB,CAClB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/songs/loader.d.ts

@@ -0,0 +1,27 @@
+import type { SongEntry } from "./types.js";
+/**
+ * Load all .json song files from a directory.
+ * Validates each file and returns valid SongEntry objects.
+ * Skips (with warning) any files that fail validation.
+ */
+export declare function loadSongsFromDir(dir: string): SongEntry[];
+/**
+ * Load a single song from a JSON file.
+ * Validates the parsed object and returns a typed SongEntry.
+ */
+export declare function loadSongFile(filePath: string): SongEntry;
+/**
+ * Save a SongEntry as a JSON file in the given directory.
+ * Creates the directory if it doesn't exist.
+ * Returns the full path to the saved file.
+ */
+export declare function saveSong(song: SongEntry, dir: string): string;
+/**
+ * Initialize the song registry from builtin and optional user directories.
+ * Clears any existing registry entries first.
+ *
+ * @param builtinDir - Path to the builtin songs directory (ships with package)
+ * @param userDir - Optional path to user songs directory (default: ~/.pianoai/songs/)
+ */
+export declare function initializeRegistry(builtinDir: string, userDir?: string): void;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/songs/loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgBzD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAOxD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CA2B7E"}