@mcptoolshop/ai_jam_session 0.1.0

package/dist/note-parser.js

@@ -0,0 +1,278 @@
+// ─── pianoai: Note Parser ────────────────────────────────────────────────────
+//
+// Converts scientific pitch notation (e.g. "C4:q", "F#5:e", "Bb3:h")
+// into MIDI note numbers and durations for playback.
+// ─────────────────────────────────────────────────────────────────────────────
+import { NOTE_OFFSETS, DURATION_MAP } from "./types.js";
+/**
+ * Parse a scientific pitch string into a MIDI note number.
+ *
+ * Examples:
+ *   "C4"  → 60  (middle C)
+ *   "A4"  → 69  (concert A)
+ *   "F#5" → 78
+ *   "Bb3" → 58
+ *   "R"   → -1  (rest)
+ */
+export function parseNoteToMidi(noteStr) {
+    const trimmed = noteStr.trim();
+    if (trimmed === "R" || trimmed === "r")
+        return -1; // rest
+    // Match: letter + optional accidental + octave
+    // e.g. "C4", "F#5", "Bb3", "G#4"
+    const match = trimmed.match(/^([A-Ga-g])(#|b)?(\d)$/);
+    if (!match) {
+        throw new Error(`Invalid note: "${noteStr}"`);
+    }
+    const [, letter, accidental, octaveStr] = match;
+    const base = NOTE_OFFSETS[letter.toUpperCase()];
+    if (base === undefined) {
+        throw new Error(`Unknown note letter: "${letter}"`);
+    }
+    const octave = parseInt(octaveStr, 10);
+    let midi = (octave + 1) * 12 + base;
+    if (accidental === "#")
+        midi += 1;
+    if (accidental === "b")
+        midi -= 1;
+    if (midi < 0 || midi > 127) {
+        throw new Error(`MIDI note out of range: ${midi} (from "${noteStr}")`);
+    }
+    return midi;
+}
+/**
+ * Parse a duration suffix into a multiplier relative to a quarter note.
+ *
+ * ":w" → 4.0 (whole), ":h" → 2.0 (half), ":q" → 1.0 (quarter),
+ * ":e" → 0.5 (eighth), ":s" → 0.25 (sixteenth).
+ * Default (no suffix) → 1.0 (quarter).
+ */
+export function parseDuration(suffix) {
+    const mult = DURATION_MAP[suffix];
+    if (mult === undefined) {
+        throw new Error(`Unknown duration suffix: "${suffix}"`);
+    }
+    return mult;
+}
+/**
+ * Convert a BPM tempo + duration multiplier → milliseconds.
+ *
+ * At 120 BPM, a quarter note = 500ms.
+ * A half note at 120 BPM = 1000ms.
+ */
+export function durationToMs(multiplier, bpm) {
+    const quarterMs = 60_000 / bpm;
+    return quarterMs * multiplier;
+}
+/**
+ * Parse a single note token like "C4:q" or "R:h" into a MidiNote.
+ *
+ * @param token   - e.g. "C4:q", "F#5:e", "Bb3:h", "R:q"
+ * @param bpm     - tempo in beats per minute
+ * @param channel - MIDI channel (0-15)
+ * @param velocity - MIDI velocity (0-127)
+ */
+export function parseNoteToken(token, bpm, channel = 0, velocity = 80) {
+    const trimmed = token.trim();
+    const parts = trimmed.split(":");
+    const noteStr = parts[0];
+    const durationSuffix = parts[1] ?? "q"; // default to quarter note
+    const midi = parseNoteToMidi(noteStr);
+    const mult = parseDuration(durationSuffix);
+    const durationMs = durationToMs(mult, bpm);
+    return {
+        note: midi,
+        velocity: midi === -1 ? 0 : velocity, // rests have 0 velocity
+        durationMs,
+        channel,
+    };
+}
+/**
+ * Parse a hand string like "C4:q E4:q G4:q" into an array of Beats.
+ *
+ * Each space-separated token becomes a sequential beat.
+ * For chords (simultaneous notes), we'd need a different notation,
+ * but the current ai-music-sheets format treats each token as sequential.
+ */
+export function parseHandString(handStr, hand, bpm, channel = 0, velocity = 80) {
+    if (!handStr || handStr.trim() === "")
+        return [];
+    const tokens = handStr.trim().split(/\s+/);
+    return tokens.map((token) => ({
+        notes: [parseNoteToken(token, bpm, channel, velocity)],
+        hand,
+    }));
+}
+/**
+ * Parse a full Measure into a PlayableMeasure with MIDI-ready beats.
+ */
+export function parseMeasure(measure, bpm, velocity = 80) {
+    return {
+        source: measure,
+        rightBeats: parseHandString(measure.rightHand, "right", bpm, 0, velocity),
+        leftBeats: parseHandString(measure.leftHand, "left", bpm, 0, velocity),
+    };
+}
+/**
+ * Safely parse a note token — returns null on error instead of throwing.
+ * Collects a warning in the provided array when parsing fails.
+ */
+export function safeParseNoteToken(token, bpm, location, warnings, channel = 0, velocity = 80) {
+    try {
+        return parseNoteToken(token, bpm, channel, velocity);
+    }
+    catch (err) {
+        warnings.push({
+            location,
+            token,
+            message: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+/**
+ * Safe version of parseHandString — skips bad tokens, collects warnings.
+ */
+export function safeParseHandString(handStr, hand, bpm, measureNumber, warnings, channel = 0, velocity = 80) {
+    if (!handStr || handStr.trim() === "")
+        return [];
+    const tokens = handStr.trim().split(/\s+/);
+    const beats = [];
+    for (const token of tokens) {
+        const note = safeParseNoteToken(token, bpm, `measure ${measureNumber} ${hand} hand`, warnings, channel, velocity);
+        if (note) {
+            beats.push({ notes: [note], hand });
+        }
+    }
+    return beats;
+}
+/**
+ * Safe version of parseMeasure — skips bad notes, collects warnings.
+ */
+export function safeParseMeasure(measure, bpm, warnings, velocity = 80) {
+    return {
+        source: measure,
+        rightBeats: safeParseHandString(measure.rightHand, "right", bpm, measure.number, warnings, 0, velocity),
+        leftBeats: safeParseHandString(measure.leftHand, "left", bpm, measure.number, warnings, 0, velocity),
+    };
+}
+/**
+ * Convert a MIDI note number back to a note name (for display).
+ *
+ * 60 → "C4", 69 → "A4", 78 → "F#5"
+ */
+export function midiToNoteName(midi) {
+    if (midi < 0)
+        return "R";
+    const noteNames = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+    const octave = Math.floor(midi / 12) - 1;
+    const noteIndex = midi % 12;
+    return `${noteNames[noteIndex]}${octave}`;
+}
+/** Solfege mapping: note name (with optional accidental) → solfege syllable. */
+const SOLFEGE_MAP = {
+    C: "Do", "C#": "Di", Db: "Ra",
+    D: "Re", "D#": "Ri", Eb: "Me",
+    E: "Mi",
+    F: "Fa", "F#": "Fi", Gb: "Se",
+    G: "Sol", "G#": "Si", Ab: "Le",
+    A: "La", "A#": "Li", Bb: "Te",
+    B: "Ti",
+};
+/**
+ * Convert a single note string (e.g. "C4", "F#5") to a singable syllable.
+ *
+ * - "note-names": "C", "F sharp", "B flat"
+ * - "solfege": "Do", "Fi", "Te"
+ * - "syllables": always "da"
+ * - "contour": falls back to letter (contour handled at measure level)
+ */
+export function noteToSingable(noteStr, mode) {
+    const trimmed = noteStr.trim();
+    if (trimmed === "R" || trimmed === "r")
+        return mode === "syllables" ? "..." : "rest";
+    const match = trimmed.match(/^([A-Ga-g])(#|b)?(\d)?$/);
+    if (!match)
+        return trimmed; // pass through unparseable
+    const [, letter, accidental] = match;
+    const upperLetter = letter.toUpperCase();
+    switch (mode) {
+        case "note-names": {
+            const acc = accidental === "#" ? " sharp" : accidental === "b" ? " flat" : "";
+            return `${upperLetter}${acc}`;
+        }
+        case "solfege": {
+            const key = accidental ? `${upperLetter}${accidental}` : upperLetter;
+            return SOLFEGE_MAP[key] ?? upperLetter;
+        }
+        case "syllables":
+            return "da";
+        case "contour":
+            return upperLetter; // fallback — contour handled at measure level
+    }
+}
+/**
+ * Convert a hand string (e.g. "C4:q E4:q G4:q") to singable text.
+ *
+ * For "contour" mode, compares consecutive MIDI pitches and returns
+ * direction words: "up", "down", "same".
+ *
+ * For other modes, maps each note token through noteToSingable and
+ * joins with "... " (speech pause).
+ */
+export function handToSingableText(handStr, mode) {
+    if (!handStr || handStr.trim() === "")
+        return "";
+    const tokens = handStr.trim().split(/\s+/);
+    if (mode === "contour") {
+        if (tokens.length <= 1)
+            return "hold";
+        const midis = tokens.map((t) => {
+            const noteStr = t.split(":")[0];
+            try {
+                return parseNoteToMidi(noteStr);
+            }
+            catch {
+                return -1;
+            }
+        });
+        const dirs = [];
+        for (let i = 1; i < midis.length; i++) {
+            if (midis[i] < 0 || midis[i - 1] < 0) {
+                dirs.push("rest");
+                continue;
+            }
+            const diff = midis[i] - midis[i - 1];
+            dirs.push(diff > 0 ? "up" : diff < 0 ? "down" : "same");
+        }
+        return dirs.join("... ");
+    }
+    // note-names, solfege, syllables
+    const syllables = tokens.map((t) => {
+        const noteStr = t.split(":")[0];
+        return noteToSingable(noteStr, mode);
+    });
+    return syllables.join("... ");
+}
+/**
+ * Convert a Measure to singable text for voice narration.
+ *
+ * Returns the singable syllables for the specified hand(s).
+ * When hand="both", right hand text comes first, then "Left hand:" prefix.
+ */
+export function measureToSingableText(measure, options) {
+    const { mode, hand } = options;
+    if (hand === "right")
+        return handToSingableText(measure.rightHand, mode);
+    if (hand === "left")
+        return handToSingableText(measure.leftHand, mode);
+    // both
+    const right = handToSingableText(measure.rightHand, mode);
+    const left = handToSingableText(measure.leftHand, mode);
+    if (!left)
+        return right;
+    if (!right)
+        return left;
+    return `${right}. Left hand: ${left}`;
+}
+//# sourceMappingURL=note-parser.js.map

package/dist/note-parser.js.map

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

package/dist/playback/controls.d.ts

@@ -0,0 +1,124 @@
+import type { ParsedMidi } from "../midi/types.js";
+import type { VmpkConnector, TeachingHook, ProgressCallback } from "../types.js";
+import type { MidiPlaybackState } from "./midi-engine.js";
+/** Events emitted during playback. */
+export type PlaybackEventType = "stateChange" | "noteOn" | "noteOff" | "speedChange" | "progress" | "error";
+/** Payload for playback events. */
+export interface PlaybackEvent {
+    type: PlaybackEventType;
+    /** Playback position in seconds (at speed 1.0) when this event occurred. */
+    positionSeconds: number;
+    /** Current playback state. */
+    state: MidiPlaybackState;
+}
+export interface NoteOnEvent extends PlaybackEvent {
+    type: "noteOn";
+    note: number;
+    noteName: string;
+    velocity: number;
+    channel: number;
+    duration: number;
+    eventIndex: number;
+    totalEvents: number;
+}
+export interface NoteOffEvent extends PlaybackEvent {
+    type: "noteOff";
+    note: number;
+    noteName: string;
+    channel: number;
+}
+export interface StateChangeEvent extends PlaybackEvent {
+    type: "stateChange";
+    previousState: MidiPlaybackState;
+}
+export interface SpeedChangeEvent extends PlaybackEvent {
+    type: "speedChange";
+    previousSpeed: number;
+    newSpeed: number;
+}
+export interface ProgressEvent extends PlaybackEvent {
+    type: "progress";
+    ratio: number;
+    percent: string;
+    eventsPlayed: number;
+    totalEvents: number;
+    elapsedMs: number;
+}
+export interface ErrorEvent extends PlaybackEvent {
+    type: "error";
+    error: Error;
+}
+/** Union of all event types. */
+export type AnyPlaybackEvent = NoteOnEvent | NoteOffEvent | StateChangeEvent | SpeedChangeEvent | ProgressEvent | ErrorEvent;
+/** Listener callback. */
+export type PlaybackListener = (event: AnyPlaybackEvent) => void;
+export interface PlaybackControlOptions {
+    /** Speed multiplier (0.1–4.0). Default: 1.0. */
+    speed?: number;
+    /** Teaching hook to invoke during playback. */
+    teachingHook?: TeachingHook;
+    /** Progress callback (in addition to event-based listeners). */
+    onProgress?: ProgressCallback;
+    /** AbortSignal for external cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Real-time playback controller for MIDI files.
+ *
+ * Wraps MidiPlaybackEngine with:
+ * - Event listeners (noteOn, noteOff, stateChange, speedChange, progress)
+ * - Teaching hook integration (fires at note boundaries)
+ * - Clean pause/resume/stop with hook notification
+ * - Speed change during playback with listener notification
+ */
+export declare class PlaybackController {
+    private readonly connector;
+    readonly midi: ParsedMidi;
+    private engine;
+    private listeners;
+    private _teachingHook;
+    private _lastState;
+    constructor(connector: VmpkConnector, midi: ParsedMidi);
+    get state(): MidiPlaybackState;
+    get speed(): number;
+    get durationSeconds(): number;
+    get positionSeconds(): number;
+    get eventsPlayed(): number;
+    get totalEvents(): number;
+    /** Subscribe to a specific event type or "*" for all events. */
+    on(type: PlaybackEventType | "*", listener: PlaybackListener): () => void;
+    /** Remove a listener. */
+    off(type: PlaybackEventType | "*", listener: PlaybackListener): void;
+    /** Remove all listeners. */
+    removeAllListeners(): void;
+    private emit;
+    private emitStateChange;
+    /**
+     * Start or resume MIDI playback with real-time event emission.
+     *
+     * Wraps the underlying engine, intercepting noteOn/noteOff events
+     * to fire listeners and invoke teaching hooks at note boundaries.
+     */
+    play(options?: PlaybackControlOptions): Promise<void>;
+    /** Pause playback. Fires stateChange event. */
+    pause(): void;
+    /** Resume playback after pause. Fires stateChange event. */
+    resume(options?: PlaybackControlOptions): Promise<void>;
+    /** Stop playback and reset. Fires stateChange event. */
+    stop(): void;
+    /** Change playback speed. Fires speedChange event. Takes effect on next note. */
+    setSpeed(speed: number): void;
+    /** Reset to beginning. */
+    reset(): void;
+    /**
+     * Create a connector wrapper that intercepts noteOn/noteOff to emit events
+     * and invoke teaching hooks.
+     */
+    private createWrappedConnector;
+}
+/**
+ * Create a PlaybackController for a parsed MIDI file.
+ * Shorthand for `new PlaybackController(connector, midi)`.
+ */
+export declare function createPlaybackController(connector: VmpkConnector, midi: ParsedMidi): PlaybackController;
+//# sourceMappingURL=controls.d.ts.map

package/dist/playback/controls.d.ts.map

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

package/dist/playback/controls.js

@@ -0,0 +1,252 @@
+// ─── Real-Time Playback Controls ────────────────────────────────────────────
+//
+// Wraps MidiPlaybackEngine with an event-driven control layer.
+// External systems (teaching hooks, singing, UI) subscribe to playback events
+// and react in real time. All state changes flow through here.
+// ─────────────────────────────────────────────────────────────────────────────
+import { MidiPlaybackEngine } from "./midi-engine.js";
+import { midiToNoteName } from "../note-parser.js";
+// ─── PlaybackController ─────────────────────────────────────────────────────
+/**
+ * Real-time playback controller for MIDI files.
+ *
+ * Wraps MidiPlaybackEngine with:
+ * - Event listeners (noteOn, noteOff, stateChange, speedChange, progress)
+ * - Teaching hook integration (fires at note boundaries)
+ * - Clean pause/resume/stop with hook notification
+ * - Speed change during playback with listener notification
+ */
+export class PlaybackController {
+    connector;
+    midi;
+    engine;
+    listeners = new Map();
+    _teachingHook = null;
+    _lastState = "idle";
+    constructor(connector, midi) {
+        this.connector = connector;
+        this.midi = midi;
+        this.engine = new MidiPlaybackEngine(connector, midi);
+    }
+    // ─── State Accessors ────────────────────────────────────────────────────
+    get state() { return this.engine.state; }
+    get speed() { return this.engine.speed; }
+    get durationSeconds() { return this.engine.durationSeconds; }
+    get positionSeconds() { return this.engine.positionSeconds; }
+    get eventsPlayed() { return this.engine.eventsPlayed; }
+    get totalEvents() { return this.engine.totalEvents; }
+    // ─── Event System ───────────────────────────────────────────────────────
+    /** Subscribe to a specific event type or "*" for all events. */
+    on(type, listener) {
+        if (!this.listeners.has(type)) {
+            this.listeners.set(type, new Set());
+        }
+        this.listeners.get(type).add(listener);
+        // Return unsubscribe function
+        return () => {
+            this.listeners.get(type)?.delete(listener);
+        };
+    }
+    /** Remove a listener. */
+    off(type, listener) {
+        this.listeners.get(type)?.delete(listener);
+    }
+    /** Remove all listeners. */
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+    emit(event) {
+        // Fire type-specific listeners
+        const typeListeners = this.listeners.get(event.type);
+        if (typeListeners) {
+            for (const fn of typeListeners) {
+                try {
+                    fn(event);
+                }
+                catch { /* listener errors don't break playback */ }
+            }
+        }
+        // Fire wildcard listeners
+        const allListeners = this.listeners.get("*");
+        if (allListeners) {
+            for (const fn of allListeners) {
+                try {
+                    fn(event);
+                }
+                catch { /* listener errors don't break playback */ }
+            }
+        }
+    }
+    emitStateChange(previousState) {
+        if (this.engine.state === previousState)
+            return;
+        this.emit({
+            type: "stateChange",
+            state: this.engine.state,
+            previousState,
+            positionSeconds: this.engine.positionSeconds,
+        });
+        this._lastState = this.engine.state;
+    }
+    // ─── Playback Controls ──────────────────────────────────────────────────
+    /**
+     * Start or resume MIDI playback with real-time event emission.
+     *
+     * Wraps the underlying engine, intercepting noteOn/noteOff events
+     * to fire listeners and invoke teaching hooks at note boundaries.
+     */
+    async play(options = {}) {
+        const previousState = this.engine.state;
+        this._teachingHook = options.teachingHook ?? null;
+        // Wrap the connector to intercept note events
+        const wrappedConnector = this.createWrappedConnector();
+        // Swap the engine to use the wrapped connector (recreate)
+        this.engine = new MidiPlaybackEngine(wrappedConnector, this.midi);
+        // Emit state change
+        const onProgress = (p) => {
+            this.emit({
+                type: "progress",
+                state: this.engine.state,
+                positionSeconds: this.engine.positionSeconds,
+                ratio: p.ratio,
+                percent: p.percent,
+                eventsPlayed: p.currentMeasure,
+                totalEvents: p.totalMeasures,
+                elapsedMs: p.elapsedMs,
+            });
+            options.onProgress?.(p);
+        };
+        this.emitStateChange(previousState);
+        try {
+            await this.engine.play({
+                speed: options.speed,
+                onProgress,
+                signal: options.signal,
+            });
+        }
+        catch (err) {
+            this.emit({
+                type: "error",
+                state: this.engine.state,
+                positionSeconds: this.engine.positionSeconds,
+                error: err instanceof Error ? err : new Error(String(err)),
+            });
+            throw err;
+        }
+        finally {
+            this.emitStateChange(this._lastState);
+            // Notify teaching hook of completion
+            if (this._teachingHook && this.engine.state === "finished") {
+                try {
+                    await this._teachingHook.onSongComplete(this.engine.eventsPlayed, this.midi.trackNames[0] ?? "MIDI file");
+                }
+                catch { /* hook errors don't break playback */ }
+            }
+        }
+    }
+    /** Pause playback. Fires stateChange event. */
+    pause() {
+        const prev = this.engine.state;
+        this.engine.pause();
+        this.emitStateChange(prev);
+    }
+    /** Resume playback after pause. Fires stateChange event. */
+    async resume(options = {}) {
+        if (this.engine.state !== "paused")
+            return;
+        const prev = this.engine.state;
+        this.emitStateChange(prev);
+        await this.engine.resume({
+            speed: options.speed,
+            onProgress: options.onProgress,
+            signal: options.signal,
+        });
+        this.emitStateChange(this._lastState);
+    }
+    /** Stop playback and reset. Fires stateChange event. */
+    stop() {
+        const prev = this.engine.state;
+        this.engine.stop();
+        this.emitStateChange(prev);
+    }
+    /** Change playback speed. Fires speedChange event. Takes effect on next note. */
+    setSpeed(speed) {
+        const prev = this.engine.speed;
+        this.engine.setSpeed(speed);
+        this.emit({
+            type: "speedChange",
+            state: this.engine.state,
+            positionSeconds: this.engine.positionSeconds,
+            previousSpeed: prev,
+            newSpeed: speed,
+        });
+    }
+    /** Reset to beginning. */
+    reset() {
+        const prev = this.engine.state;
+        this.engine.reset();
+        this.emitStateChange(prev);
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────
+    /**
+     * Create a connector wrapper that intercepts noteOn/noteOff to emit events
+     * and invoke teaching hooks.
+     */
+    createWrappedConnector() {
+        const self = this;
+        const inner = this.connector;
+        let noteIndex = 0;
+        return {
+            connect: () => inner.connect(),
+            disconnect: () => inner.disconnect(),
+            status: () => inner.status(),
+            listPorts: () => inner.listPorts(),
+            noteOn(note, velocity, channel) {
+                inner.noteOn(note, velocity, channel);
+                const ch = channel ?? 0;
+                const event = {
+                    type: "noteOn",
+                    state: self.engine.state,
+                    positionSeconds: self.engine.positionSeconds,
+                    note,
+                    noteName: midiToNoteName(note),
+                    velocity,
+                    channel: ch,
+                    duration: 0, // filled by engine scheduling
+                    eventIndex: noteIndex++,
+                    totalEvents: self.midi.events.length,
+                };
+                self.emit(event);
+                // Fire teaching hook (non-blocking — don't await)
+                if (self._teachingHook) {
+                    const noteName = midiToNoteName(note);
+                    self._teachingHook.onMeasureStart(noteIndex, // use event index as measure proxy for MIDI files
+                    `Note: ${noteName} (${note}) vel=${velocity}`, undefined).catch(() => { });
+                }
+            },
+            noteOff(note, channel) {
+                inner.noteOff(note, channel);
+                self.emit({
+                    type: "noteOff",
+                    state: self.engine.state,
+                    positionSeconds: self.engine.positionSeconds,
+                    note,
+                    noteName: midiToNoteName(note),
+                    channel: channel ?? 0,
+                });
+            },
+            allNotesOff(channel) {
+                inner.allNotesOff(channel);
+            },
+            playNote: (midiNote) => inner.playNote(midiNote),
+        };
+    }
+}
+/**
+ * Create a PlaybackController for a parsed MIDI file.
+ * Shorthand for `new PlaybackController(connector, midi)`.
+ */
+export function createPlaybackController(connector, midi) {
+    return new PlaybackController(connector, midi);
+}
+//# sourceMappingURL=controls.js.map