@mcptoolshop/ai_jam_session 0.1.0

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,oEAAoE;AACpE,qDAAqD;AACrD,yCAAyC;AACzC,iEAAiE;AACjE,gFAAgF;AAEhF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;CACxF,CAAC,CAAC;AAEH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpE,CAAC,CAAC;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAChF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC;IACtC,iBAAiB;IACjB,cAAc;IACd,aAAa;CACd,CAAC,CAAC;AAKH,sDAAsD;AACtD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACzC,QAAQ,CAAC,2DAA2D,CAAC;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SAChD,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC1D,QAAQ,CAAC,eAAe,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC7C,QAAQ,CAAC,uCAAuC,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC3C,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,106 @@
+import type { SongEntry } from "./songs/types.js";
+import type { Session, SessionOptions, SessionState, ProgressCallback, ParseWarning, VmpkConnector, TeachingHook } from "./types.js";
+/**
+ * Create a new practice session for a song.
+ */
+export declare function createSession(song: SongEntry, connector: VmpkConnector, options?: SessionOptions): SessionController;
+/**
+ * Session controller — the main runtime interface for a practice session.
+ *
+ * Holds the session state + connector + teaching hook.
+ * Provides play/pause/stop/skip methods.
+ */
+export declare class SessionController {
+    readonly session: Session;
+    private readonly connector;
+    private readonly teachingHook;
+    private abortController;
+    private playableMeasures;
+    private playStartedAt;
+    private lastProgressMilestone;
+    private readonly onProgress?;
+    private readonly progressInterval;
+    /** Parse warnings collected during measure parsing (bad notes skipped). */
+    readonly parseWarnings: ParseWarning[];
+    constructor(session: Session, connector: VmpkConnector, teachingHook: TeachingHook, onProgress?: ProgressCallback, progressInterval?: number);
+    /**
+     * Re-parse all measures with current effective tempo.
+     * Uses safe parser — collects warnings instead of throwing.
+     */
+    private reParseMeasures;
+    /**
+     * Effective tempo — base tempo (override or song default) * speed multiplier.
+     * This is the actual BPM used for playback timing.
+     */
+    effectiveTempo(): number;
+    /**
+     * Base tempo — override or song default, without speed multiplier.
+     * Useful for display ("Playing at 60 BPM × 0.5 speed").
+     */
+    baseTempo(): number;
+    /** Get current state. */
+    get state(): SessionState;
+    /** Get the current measure (1-based for display). */
+    get currentMeasureDisplay(): number;
+    /** Total measures in the song. */
+    get totalMeasures(): number;
+    /**
+     * Play the session from the current position.
+     *
+     * In "full" mode: plays all remaining measures.
+     * In "measure" mode: plays one measure and pauses.
+     * In "loop" mode: loops the specified range.
+     * In "hands" mode: plays RH, then LH, then both for each measure.
+     */
+    play(): Promise<void>;
+    /** Pause playback. */
+    pause(): void;
+    /** Stop playback and reset to beginning. */
+    stop(): void;
+    /** Skip to next measure (in measure/hands mode). */
+    next(): void;
+    /** Go back to previous measure. */
+    prev(): void;
+    /** Jump to a specific measure (1-based). */
+    goTo(measureNumber: number): void;
+    /** Set tempo override (10–400 BPM). */
+    setTempo(bpm: number): void;
+    /**
+     * Set speed multiplier (0.5 = half speed, 1.0 = normal, 2.0 = double).
+     * Re-parses all measures with the new effective tempo.
+     */
+    setSpeed(speed: number): void;
+    /** Get a summary of the current session state. */
+    summary(): string;
+    /** Build a PlaybackProgress snapshot. */
+    private buildProgress;
+    /**
+     * Emit a progress notification if we've crossed the next milestone.
+     * With progressInterval 0.1, fires at 10%, 20%, 30%, … 100%.
+     * With progressInterval 0, fires after every measure.
+     */
+    private emitProgress;
+    /**
+     * Play a range of measures (inclusive, 0-based indices).
+     * Fires teaching hooks at measure boundaries and key moments.
+     *
+     * In "concurrent" syncMode: voice and piano play simultaneously (duet feel).
+     * In "before" syncMode: voice speaks before piano plays (lecture style).
+     * Key moments always fire before playback in both modes (instructional).
+     */
+    private playRange;
+    /**
+     * Play a single measure — both hands in parallel.
+     */
+    private playMeasure;
+    /**
+     * Play a sequence of beats serially.
+     */
+    private playBeats;
+    /**
+     * Play hands separately then together (for "hands" mode).
+     * Respects syncMode: concurrent voice plays alongside the first hand pass.
+     */
+    private playHandsSeparate;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,YAAY,EAIZ,gBAAgB,EAChB,YAAY,EAEZ,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,aAAa,EACxB,OAAO,GAAE,cAAmB,GAC3B,iBAAiB,CAgCnB;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;aAYV,OAAO,EAAE,OAAO;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAb/B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,qBAAqB,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,YAAY,EAAE,CAAM;gBAG1B,OAAO,EAAE,OAAO,EACf,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,YAAY,EAC3C,UAAU,CAAC,EAAE,gBAAgB,EAC7B,gBAAgB,CAAC,EAAE,MAAM;IAS3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,cAAc,IAAI,MAAM;IAKxB;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB,yBAAyB;IACzB,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,qDAAqD;IACrD,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,kCAAkC;IAClC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsE3B,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAOb,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAOZ,oDAAoD;IACpD,IAAI,IAAI,IAAI;IAMZ,mCAAmC;IACnC,IAAI,IAAI,IAAI;IAMZ,4CAA4C;IAC5C,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAOjC,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ7B,kDAAkD;IAClD,OAAO,IAAI,MAAM;IAcjB,yCAAyC;IACzC,OAAO,CAAC,aAAa;IAarB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;;;;OAOG;YACW,SAAS;IA+CvB;;OAEG;YACW,WAAW;IAWzB;;OAEG;YACW,SAAS;IAavB;;;OAGG;YACW,iBAAiB;CA2ChC"}

package/dist/session.js

@@ -0,0 +1,361 @@
+// ─── pianoai: Session Engine ─────────────────────────────────────────────────
+//
+// Manages the playback session: load a song, parse measures, play through
+// VMPK via the connector, track progress, handle pause/resume/stop.
+//
+// Teaching hooks fire at measure boundaries and key moments, allowing
+// the AI teacher to speak, display tips, or push interjections.
+// ─────────────────────────────────────────────────────────────────────────────
+import { safeParseMeasure } from "./note-parser.js";
+import { createSilentTeachingHook, detectKeyMoments } from "./teaching.js";
+let sessionCounter = 0;
+/**
+ * Create a new practice session for a song.
+ */
+export function createSession(song, connector, options = {}) {
+    const speed = options.speed ?? 1.0;
+    if (speed <= 0 || speed > 4) {
+        throw new Error(`Speed must be between 0 (exclusive) and 4: got ${speed}`);
+    }
+    if (options.tempo !== undefined && (options.tempo < 10 || options.tempo > 400)) {
+        throw new Error(`Tempo must be between 10 and 400 BPM: got ${options.tempo}`);
+    }
+    const session = {
+        id: `session-${++sessionCounter}`,
+        song,
+        state: "loaded",
+        mode: options.mode ?? "full",
+        syncMode: options.syncMode ?? "concurrent",
+        currentMeasure: 0,
+        tempoOverride: options.tempo ?? null,
+        speed,
+        loopRange: options.loopRange ?? null,
+        startedAt: new Date(),
+        measuresPlayed: 0,
+        voiceEnabled: options.voice ?? true,
+    };
+    return new SessionController(session, connector, options.teachingHook ?? createSilentTeachingHook(), options.onProgress, options.progressInterval);
+}
+/**
+ * Session controller — the main runtime interface for a practice session.
+ *
+ * Holds the session state + connector + teaching hook.
+ * Provides play/pause/stop/skip methods.
+ */
+export class SessionController {
+    session;
+    connector;
+    teachingHook;
+    abortController = null;
+    playableMeasures = [];
+    playStartedAt = 0;
+    lastProgressMilestone = -1;
+    onProgress;
+    progressInterval;
+    /** Parse warnings collected during measure parsing (bad notes skipped). */
+    parseWarnings = [];
+    constructor(session, connector, teachingHook, onProgress, progressInterval) {
+        this.session = session;
+        this.connector = connector;
+        this.teachingHook = teachingHook;
+        this.onProgress = onProgress;
+        this.progressInterval = progressInterval ?? 0.1; // default: every 10%
+        // Pre-parse all measures — gracefully skip bad notes
+        this.reParseMeasures();
+    }
+    /**
+     * Re-parse all measures with current effective tempo.
+     * Uses safe parser — collects warnings instead of throwing.
+     */
+    reParseMeasures() {
+        this.parseWarnings.length = 0; // clear previous warnings
+        const bpm = this.effectiveTempo();
+        this.playableMeasures = this.session.song.measures.map((m) => safeParseMeasure(m, bpm, this.parseWarnings));
+    }
+    /**
+     * Effective tempo — base tempo (override or song default) * speed multiplier.
+     * This is the actual BPM used for playback timing.
+     */
+    effectiveTempo() {
+        const base = this.session.tempoOverride ?? this.session.song.tempo;
+        return base * this.session.speed;
+    }
+    /**
+     * Base tempo — override or song default, without speed multiplier.
+     * Useful for display ("Playing at 60 BPM × 0.5 speed").
+     */
+    baseTempo() {
+        return this.session.tempoOverride ?? this.session.song.tempo;
+    }
+    /** Get current state. */
+    get state() {
+        return this.session.state;
+    }
+    /** Get the current measure (1-based for display). */
+    get currentMeasureDisplay() {
+        return this.session.currentMeasure + 1;
+    }
+    /** Total measures in the song. */
+    get totalMeasures() {
+        return this.session.song.measures.length;
+    }
+    /**
+     * Play the session from the current position.
+     *
+     * In "full" mode: plays all remaining measures.
+     * In "measure" mode: plays one measure and pauses.
+     * In "loop" mode: loops the specified range.
+     * In "hands" mode: plays RH, then LH, then both for each measure.
+     */
+    async play() {
+        if (this.session.state === "playing")
+            return;
+        if (this.session.state === "finished") {
+            // Restart from beginning
+            this.session.currentMeasure = 0;
+        }
+        this.session.state = "playing";
+        this.abortController = new AbortController();
+        this.playStartedAt = Date.now();
+        this.lastProgressMilestone = -1;
+        const signal = this.abortController.signal;
+        try {
+            switch (this.session.mode) {
+                case "full":
+                    await this.playRange(this.session.currentMeasure, this.totalMeasures - 1, signal);
+                    break;
+                case "measure":
+                    await this.playRange(this.session.currentMeasure, this.session.currentMeasure, signal);
+                    this.session.state = "paused";
+                    return;
+                case "loop": {
+                    const [start, end] = this.session.loopRange ?? [1, this.totalMeasures];
+                    const startIdx = start - 1; // convert to 0-based
+                    const endIdx = end - 1;
+                    // Loop forever until stopped
+                    while (!signal.aborted) {
+                        await this.playRange(startIdx, endIdx, signal);
+                        this.session.currentMeasure = startIdx;
+                    }
+                    break;
+                }
+                case "hands":
+                    await this.playHandsSeparate(this.session.currentMeasure, signal);
+                    this.session.state = "paused";
+                    return;
+            }
+            if (!signal.aborted) {
+                this.session.state = "finished";
+                // Fire song-complete hook
+                await this.teachingHook.onSongComplete(this.session.measuresPlayed, this.session.song.title);
+            }
+        }
+        catch (err) {
+            if (signal.aborted) {
+                // Expected — user stopped playback
+                return;
+            }
+            throw err;
+        }
+    }
+    /** Pause playback. */
+    pause() {
+        if (this.session.state !== "playing")
+            return;
+        this.abortController?.abort();
+        this.session.state = "paused";
+        this.connector.allNotesOff();
+    }
+    /** Stop playback and reset to beginning. */
+    stop() {
+        this.abortController?.abort();
+        this.session.state = "idle";
+        this.session.currentMeasure = 0;
+        this.connector.allNotesOff();
+    }
+    /** Skip to next measure (in measure/hands mode). */
+    next() {
+        if (this.session.currentMeasure < this.totalMeasures - 1) {
+            this.session.currentMeasure++;
+        }
+    }
+    /** Go back to previous measure. */
+    prev() {
+        if (this.session.currentMeasure > 0) {
+            this.session.currentMeasure--;
+        }
+    }
+    /** Jump to a specific measure (1-based). */
+    goTo(measureNumber) {
+        const idx = measureNumber - 1;
+        if (idx >= 0 && idx < this.totalMeasures) {
+            this.session.currentMeasure = idx;
+        }
+    }
+    /** Set tempo override (10–400 BPM). */
+    setTempo(bpm) {
+        if (bpm < 10 || bpm > 400) {
+            throw new Error(`Tempo must be between 10 and 400 BPM: got ${bpm}`);
+        }
+        this.session.tempoOverride = bpm;
+        this.reParseMeasures();
+    }
+    /**
+     * Set speed multiplier (0.5 = half speed, 1.0 = normal, 2.0 = double).
+     * Re-parses all measures with the new effective tempo.
+     */
+    setSpeed(speed) {
+        if (speed <= 0 || speed > 4) {
+            throw new Error(`Speed must be between 0 (exclusive) and 4: got ${speed}`);
+        }
+        this.session.speed = speed;
+        this.reParseMeasures();
+    }
+    /** Get a summary of the current session state. */
+    summary() {
+        const s = this.session;
+        const speedStr = s.speed !== 1.0 ? ` × ${s.speed}x` : "";
+        const lines = [
+            `Session: ${s.id}`,
+            `Song: ${s.song.title} (${s.song.composer ?? "Traditional"})`,
+            `Genre: ${s.song.genre} | Key: ${s.song.key} | Tempo: ${this.baseTempo()} BPM${speedStr}`,
+            `Mode: ${s.mode} | State: ${s.state}`,
+            `Progress: measure ${this.currentMeasureDisplay} / ${this.totalMeasures}`,
+            `Measures played: ${s.measuresPlayed}`,
+        ];
+        return lines.join("\n");
+    }
+    /** Build a PlaybackProgress snapshot. */
+    buildProgress() {
+        const current = this.session.measuresPlayed;
+        const total = this.totalMeasures;
+        const ratio = total > 0 ? current / total : 0;
+        return {
+            currentMeasure: this.currentMeasureDisplay,
+            totalMeasures: total,
+            ratio,
+            percent: `${Math.round(ratio * 100)}%`,
+            elapsedMs: Date.now() - this.playStartedAt,
+        };
+    }
+    /**
+     * Emit a progress notification if we've crossed the next milestone.
+     * With progressInterval 0.1, fires at 10%, 20%, 30%, … 100%.
+     * With progressInterval 0, fires after every measure.
+     */
+    emitProgress() {
+        if (!this.onProgress)
+            return;
+        const progress = this.buildProgress();
+        if (this.progressInterval <= 0) {
+            // Fire after every measure
+            this.onProgress(progress);
+            return;
+        }
+        // Check if we've crossed the next milestone
+        const currentMilestone = Math.floor(progress.ratio / this.progressInterval);
+        if (currentMilestone > this.lastProgressMilestone) {
+            this.lastProgressMilestone = currentMilestone;
+            this.onProgress(progress);
+        }
+    }
+    // ─── Internal playback ──────────────────────────────────────────────────
+    /**
+     * Play a range of measures (inclusive, 0-based indices).
+     * Fires teaching hooks at measure boundaries and key moments.
+     *
+     * In "concurrent" syncMode: voice and piano play simultaneously (duet feel).
+     * In "before" syncMode: voice speaks before piano plays (lecture style).
+     * Key moments always fire before playback in both modes (instructional).
+     */
+    async playRange(startIdx, endIdx, signal) {
+        const concurrent = this.session.syncMode === "concurrent";
+        for (let i = startIdx; i <= endIdx; i++) {
+            if (signal.aborted)
+                return;
+            this.session.currentMeasure = i;
+            const pm = this.playableMeasures[i];
+            const measureNum = i + 1; // 1-based for display/teaching
+            // ── Teaching: check for key moments (always before playback) ──
+            const keyMoments = detectKeyMoments(this.session.song, measureNum);
+            for (const km of keyMoments) {
+                if (signal.aborted)
+                    return;
+                await this.teachingHook.onKeyMoment(km);
+            }
+            // ── Voice + piano: concurrent or sequential ──
+            if (concurrent) {
+                await Promise.all([
+                    this.teachingHook.onMeasureStart(measureNum, pm.source.teachingNote, pm.source.dynamics),
+                    this.playMeasure(pm, signal),
+                ]);
+            }
+            else {
+                await this.teachingHook.onMeasureStart(measureNum, pm.source.teachingNote, pm.source.dynamics);
+                await this.playMeasure(pm, signal);
+            }
+            this.session.measuresPlayed++;
+            // ── Progress notification ──
+            this.emitProgress();
+        }
+    }
+    /**
+     * Play a single measure — both hands in parallel.
+     */
+    async playMeasure(pm, signal) {
+        // Play both hands simultaneously
+        await Promise.all([
+            this.playBeats(pm.rightBeats, signal),
+            this.playBeats(pm.leftBeats, signal),
+        ]);
+    }
+    /**
+     * Play a sequence of beats serially.
+     */
+    async playBeats(beats, signal) {
+        for (const beat of beats) {
+            if (signal.aborted)
+                return;
+            // Play all notes in this beat simultaneously
+            const notePromises = beat.notes.map((n) => this.connector.playNote(n));
+            await Promise.all(notePromises);
+        }
+    }
+    /**
+     * Play hands separately then together (for "hands" mode).
+     * Respects syncMode: concurrent voice plays alongside the first hand pass.
+     */
+    async playHandsSeparate(measureIdx, signal) {
+        const pm = this.playableMeasures[measureIdx];
+        const measureNum = measureIdx + 1;
+        const concurrent = this.session.syncMode === "concurrent";
+        // ── Teaching: check key moments (always before playback) ──
+        const keyMoments = detectKeyMoments(this.session.song, measureNum);
+        for (const km of keyMoments) {
+            if (signal.aborted)
+                return;
+            await this.teachingHook.onKeyMoment(km);
+        }
+        // ── Voice + first hand pass: concurrent or sequential ──
+        if (concurrent) {
+            await Promise.all([
+                this.teachingHook.onMeasureStart(measureNum, pm.source.teachingNote, pm.source.dynamics),
+                this.playBeats(pm.rightBeats, signal),
+            ]);
+        }
+        else {
+            await this.teachingHook.onMeasureStart(measureNum, pm.source.teachingNote, pm.source.dynamics);
+            await this.playBeats(pm.rightBeats, signal);
+        }
+        if (signal.aborted)
+            return;
+        // Left hand alone
+        await this.playBeats(pm.leftBeats, signal);
+        if (signal.aborted)
+            return;
+        // Both together
+        await this.playMeasure(pm, signal);
+        this.session.measuresPlayed++;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/sfz-parser.d.ts

@@ -0,0 +1,36 @@
+/** A single SFZ region — one sample mapped to a key/velocity range. */
+export interface SfzRegion {
+    /** Path to the WAV file (relative to SFZ file location). */
+    sample: string;
+    /** Lowest MIDI key this region responds to. */
+    lokey: number;
+    /** Highest MIDI key this region responds to. */
+    hikey: number;
+    /** Lowest velocity this region responds to. */
+    lovel: number;
+    /** Highest velocity this region responds to (127 if not specified). */
+    hivel: number;
+    /** The MIDI note at which the sample was recorded (for pitch shifting). */
+    pitchKeycenter: number;
+    /** Volume adjustment in dB. */
+    volume: number;
+    /** Tuning adjustment in cents. */
+    tune: number;
+}
+/** Parsed SFZ data. */
+export interface SfzData {
+    regions: SfzRegion[];
+    /** Global amp_veltrack value (0-100). */
+    ampVeltrack: number;
+    /** Global release time in seconds. */
+    ampegRelease: number;
+}
+/**
+ * Parse an SFZ file and extract all region mappings.
+ */
+export declare function parseSfzFile(filePath: string): SfzData;
+/**
+ * Parse SFZ content string.
+ */
+export declare function parseSfz(content: string): SfzData;
+//# sourceMappingURL=sfz-parser.d.ts.map

package/dist/sfz-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfz-parser.d.ts","sourceRoot":"","sources":["../src/sfz-parser.ts"],"names":[],"mappings":"AASA,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uBAAuB;AACvB,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA0DjD"}

package/dist/sfz-parser.js

@@ -0,0 +1,95 @@
+// ─── SFZ Parser ─────────────────────────────────────────────────────────────
+//
+// Minimal SFZ parser that extracts region mappings from the
+// Accurate-Salamander SFZ files. Not a general-purpose SFZ parser —
+// only handles the opcodes we need for sample playback.
+// ─────────────────────────────────────────────────────────────────────────────
+import { readFileSync } from "node:fs";
+/**
+ * Parse an SFZ file and extract all region mappings.
+ */
+export function parseSfzFile(filePath) {
+    const content = readFileSync(filePath, "utf8");
+    return parseSfz(content);
+}
+/**
+ * Parse SFZ content string.
+ */
+export function parseSfz(content) {
+    const regions = [];
+    let ampVeltrack = 100;
+    let ampegRelease = 0.5;
+    // Track inherited values from <group> headers
+    let groupTune = 0;
+    // Strip comments
+    const lines = content
+        .split("\n")
+        .map(line => {
+        const commentIdx = line.indexOf("//");
+        return commentIdx >= 0 ? line.slice(0, commentIdx) : line;
+    })
+        .map(line => line.trim())
+        .filter(line => line.length > 0);
+    // Rejoin into a single string for header-based parsing
+    const joined = lines.join(" ");
+    // Extract global opcodes
+    const globalMatch = joined.match(/<global>\s*([\s\S]*?)(?=<(?:master|group|region|control)>|$)/);
+    if (globalMatch) {
+        const globalBlock = globalMatch[1];
+        const veltrackMatch = globalBlock.match(/amp_veltrack=([0-9.]+)/);
+        if (veltrackMatch)
+            ampVeltrack = parseFloat(veltrackMatch[1]);
+        const releaseMatch = globalBlock.match(/ampeg_release=([0-9.]+)/);
+        if (releaseMatch)
+            ampegRelease = parseFloat(releaseMatch[1]);
+    }
+    // Split by headers, tracking group-level tune
+    const tokens = joined.split(/(<\w+>)/);
+    let currentHeader = "";
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i].trim();
+        if (!token)
+            continue;
+        if (token.startsWith("<") && token.endsWith(">")) {
+            currentHeader = token;
+            continue;
+        }
+        if (currentHeader === "<group>") {
+            // Extract group-level tune
+            const tuneMatch = token.match(/tune=([+-]?\d+)/);
+            if (tuneMatch)
+                groupTune = parseInt(tuneMatch[1], 10);
+            else
+                groupTune = 0;
+        }
+        if (currentHeader === "<region>") {
+            const region = parseRegion(token, groupTune);
+            if (region)
+                regions.push(region);
+        }
+    }
+    return { regions, ampVeltrack, ampegRelease };
+}
+function parseRegion(opcodeStr, groupTune) {
+    const opcodes = new Map();
+    // Parse key=value pairs, handling paths with backslashes
+    const regex = /(\w+)=(\S+)/g;
+    let match;
+    while ((match = regex.exec(opcodeStr)) !== null) {
+        opcodes.set(match[1], match[2]);
+    }
+    const sample = opcodes.get("sample");
+    if (!sample)
+        return null;
+    return {
+        sample: sample.replace(/\\/g, "/"), // normalize path separators
+        lokey: parseInt(opcodes.get("lokey") ?? "0", 10),
+        hikey: parseInt(opcodes.get("hikey") ?? "127", 10),
+        lovel: parseInt(opcodes.get("lovel") ?? "1", 10),
+        hivel: parseInt(opcodes.get("hivel") ?? "127", 10),
+        pitchKeycenter: parseInt(opcodes.get("pitch_keycenter") ?? "60", 10),
+        volume: parseFloat(opcodes.get("volume") ?? "0"),
+        tune: groupTune + parseInt(opcodes.get("tune") ?? "0", 10),
+    };
+}
+//# sourceMappingURL=sfz-parser.js.map

package/dist/sfz-parser.js.map

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

package/dist/smoke.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smoke.d.ts.map

package/dist/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../src/smoke.ts"],"names":[],"mappings":""}