@mcptoolshop/ai_jam_session 0.1.0

package/dist/playback/controls.js.map

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

package/dist/playback/midi-engine.d.ts

@@ -0,0 +1,68 @@
+import type { ParsedMidi } from "../midi/types.js";
+import type { VmpkConnector, ProgressCallback } from "../types.js";
+/** Options for MIDI playback. */
+export interface MidiPlaybackOptions {
+    /** Speed multiplier (0.1–4.0). Default: 1.0. */
+    speed?: number;
+    /** Progress callback. */
+    onProgress?: ProgressCallback;
+    /** AbortSignal for external cancellation. */
+    signal?: AbortSignal;
+}
+/** Playback state. */
+export type MidiPlaybackState = "idle" | "playing" | "paused" | "stopped" | "finished";
+/**
+ * MIDI Playback Engine.
+ *
+ * Takes a ParsedMidi (from the parser) and plays it through a VmpkConnector.
+ * Events are scheduled sequentially — sleep between events, fire noteOn/noteOff.
+ * Active notes are tracked for clean pause/stop (all-notes-off).
+ */
+export declare class MidiPlaybackEngine {
+    private readonly connector;
+    private readonly midi;
+    private _state;
+    private _speed;
+    private _eventIndex;
+    private _playbackTime;
+    private _wallStartTime;
+    private _pausedAtTime;
+    private _activeNotes;
+    private _abortController;
+    private _resolveWait;
+    constructor(connector: VmpkConnector, midi: ParsedMidi);
+    /** Current playback state. */
+    get state(): MidiPlaybackState;
+    /** Current speed multiplier. */
+    get speed(): number;
+    /** Total duration in seconds (at speed 1.0). */
+    get durationSeconds(): number;
+    /** Current playback position in seconds (logical, at speed 1.0). */
+    get positionSeconds(): number;
+    /** Number of events played so far. */
+    get eventsPlayed(): number;
+    /** Total number of note events. */
+    get totalEvents(): number;
+    /**
+     * Play the MIDI file from the current position.
+     * Resolves when playback finishes or is stopped.
+     */
+    play(options?: MidiPlaybackOptions): Promise<void>;
+    /** Pause playback. Can be resumed with play(). */
+    pause(): void;
+    /** Resume after pause. */
+    resume(options?: MidiPlaybackOptions): Promise<void>;
+    /** Stop playback and reset to beginning. */
+    stop(): void;
+    /** Change speed during playback. Takes effect on next event. */
+    setSpeed(speed: number): void;
+    /** Reset to beginning without stopping state. */
+    reset(): void;
+    /** Send all-notes-off to silence everything. */
+    private silenceAll;
+    /** Schedule a noteOff after a delay. */
+    private scheduleNoteOff;
+    /** Sleep that can be interrupted by AbortSignal. */
+    private sleepInterruptible;
+}
+//# sourceMappingURL=midi-engine.d.ts.map

package/dist/playback/midi-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midi-engine.d.ts","sourceRoot":"","sources":["../../src/playback/midi-engine.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAoB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErF,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,sBAAsB;AACtB,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAEvF;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAZvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,YAAY,CAA6B;gBAG9B,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,UAAU;IAGnC,8BAA8B;IAC9B,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,gCAAgC;IAChC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,gDAAgD;IAChD,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,oEAAoE;IACpE,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,sCAAsC;IACtC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,mCAAmC;IACnC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;OAGG;IACG,IAAI,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwF5D,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAQb,0BAA0B;IACpB,MAAM,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAQZ,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7B,iDAAiD;IACjD,KAAK,IAAI,IAAI;IASb,gDAAgD;IAChD,OAAO,CAAC,UAAU;IASlB,wCAAwC;IACxC,OAAO,CAAC,eAAe;IAWvB,oDAAoD;IACpD,OAAO,CAAC,kBAAkB;CA8B3B"}

package/dist/playback/midi-engine.js

@@ -0,0 +1,227 @@
+// ─── MIDI Playback Engine ────────────────────────────────────────────────────
+//
+// Plays parsed MIDI file events through any VmpkConnector (audio engine or MIDI).
+// Deterministic scheduling: walks the sorted event list, sleeps between events,
+// fires noteOn/noteOff at the right times. Supports speed control, pause/resume,
+// and abort via AbortSignal.
+//
+// This is the engine that makes `pianoai play song.mid` actually work.
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * MIDI Playback Engine.
+ *
+ * Takes a ParsedMidi (from the parser) and plays it through a VmpkConnector.
+ * Events are scheduled sequentially — sleep between events, fire noteOn/noteOff.
+ * Active notes are tracked for clean pause/stop (all-notes-off).
+ */
+export class MidiPlaybackEngine {
+    connector;
+    midi;
+    _state = "idle";
+    _speed = 1.0;
+    _eventIndex = 0;
+    _playbackTime = 0; // seconds into the piece (logical time)
+    _wallStartTime = 0;
+    _pausedAtTime = 0;
+    _activeNotes = new Set(); // "channel-note" keys
+    _abortController = null;
+    _resolveWait = null;
+    constructor(connector, midi) {
+        this.connector = connector;
+        this.midi = midi;
+    }
+    /** Current playback state. */
+    get state() {
+        return this._state;
+    }
+    /** Current speed multiplier. */
+    get speed() {
+        return this._speed;
+    }
+    /** Total duration in seconds (at speed 1.0). */
+    get durationSeconds() {
+        return this.midi.durationSeconds;
+    }
+    /** Current playback position in seconds (logical, at speed 1.0). */
+    get positionSeconds() {
+        return this._playbackTime;
+    }
+    /** Number of events played so far. */
+    get eventsPlayed() {
+        return this._eventIndex;
+    }
+    /** Total number of note events. */
+    get totalEvents() {
+        return this.midi.events.length;
+    }
+    /**
+     * Play the MIDI file from the current position.
+     * Resolves when playback finishes or is stopped.
+     */
+    async play(options = {}) {
+        if (this._state === "playing")
+            return;
+        this._speed = options.speed ?? this._speed;
+        this._state = "playing";
+        this._abortController = new AbortController();
+        this._wallStartTime = Date.now();
+        const signal = options.signal;
+        const onProgress = options.onProgress;
+        const internalSignal = this._abortController.signal;
+        // Build a schedule: for each event, calculate when noteOn and noteOff fire
+        const events = this.midi.events;
+        const totalDuration = this.midi.durationSeconds;
+        try {
+            while (this._eventIndex < events.length) {
+                if (internalSignal.aborted || signal?.aborted) {
+                    this._state = "stopped";
+                    this.silenceAll();
+                    return;
+                }
+                const event = events[this._eventIndex];
+                const targetTime = event.time; // seconds at speed 1.0
+                // Sleep until this event's time
+                if (targetTime > this._playbackTime) {
+                    const waitSeconds = (targetTime - this._playbackTime) / this._speed;
+                    await this.sleepInterruptible(waitSeconds * 1000, internalSignal);
+                    if (internalSignal.aborted || signal?.aborted) {
+                        this._state = "stopped";
+                        this.silenceAll();
+                        return;
+                    }
+                }
+                this._playbackTime = targetTime;
+                // Fire noteOn
+                const key = `${event.channel}-${event.note}`;
+                this.connector.noteOn(event.note, event.velocity, event.channel);
+                this._activeNotes.add(key);
+                // Schedule noteOff after duration
+                const offDelay = (event.duration / this._speed) * 1000;
+                this.scheduleNoteOff(event, offDelay, key);
+                this._eventIndex++;
+                // Progress
+                if (onProgress && totalDuration > 0) {
+                    const ratio = this._playbackTime / totalDuration;
+                    onProgress({
+                        currentMeasure: this._eventIndex,
+                        totalMeasures: events.length,
+                        ratio: Math.min(1, ratio),
+                        percent: `${Math.round(ratio * 100)}%`,
+                        elapsedMs: Date.now() - this._wallStartTime,
+                    });
+                }
+            }
+            // Wait for the last notes to finish
+            if (events.length > 0) {
+                const lastEvent = events[events.length - 1];
+                const remainingMs = (lastEvent.duration / this._speed) * 1000;
+                if (remainingMs > 0) {
+                    await this.sleepInterruptible(remainingMs, internalSignal);
+                }
+            }
+            if (!internalSignal.aborted && !signal?.aborted) {
+                this._state = "finished";
+            }
+        }
+        catch (err) {
+            if (internalSignal.aborted || signal?.aborted) {
+                this._state = "stopped";
+            }
+            else {
+                throw err;
+            }
+        }
+        finally {
+            this.silenceAll();
+        }
+    }
+    /** Pause playback. Can be resumed with play(). */
+    pause() {
+        if (this._state !== "playing")
+            return;
+        this._state = "paused";
+        this._pausedAtTime = this._playbackTime;
+        this._abortController?.abort();
+        this.silenceAll();
+    }
+    /** Resume after pause. */
+    async resume(options = {}) {
+        if (this._state !== "paused")
+            return;
+        this._playbackTime = this._pausedAtTime;
+        await this.play(options);
+    }
+    /** Stop playback and reset to beginning. */
+    stop() {
+        this._state = "stopped";
+        this._abortController?.abort();
+        this.silenceAll();
+        this._eventIndex = 0;
+        this._playbackTime = 0;
+    }
+    /** Change speed during playback. Takes effect on next event. */
+    setSpeed(speed) {
+        if (speed <= 0 || speed > 4) {
+            throw new Error(`Speed must be between 0 (exclusive) and 4: got ${speed}`);
+        }
+        this._speed = speed;
+    }
+    /** Reset to beginning without stopping state. */
+    reset() {
+        this._eventIndex = 0;
+        this._playbackTime = 0;
+        this._state = "idle";
+        this._activeNotes.clear();
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────────
+    /** Send all-notes-off to silence everything. */
+    silenceAll() {
+        try {
+            this.connector.allNotesOff();
+        }
+        catch {
+            /* connector may already be disconnected */
+        }
+        this._activeNotes.clear();
+    }
+    /** Schedule a noteOff after a delay. */
+    scheduleNoteOff(event, delayMs, key) {
+        setTimeout(() => {
+            try {
+                this.connector.noteOff(event.note, event.channel);
+            }
+            catch {
+                /* ok */
+            }
+            this._activeNotes.delete(key);
+        }, delayMs);
+    }
+    /** Sleep that can be interrupted by AbortSignal. */
+    sleepInterruptible(ms, signal) {
+        if (ms <= 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            if (signal.aborted) {
+                resolve();
+                return;
+            }
+            const timer = setTimeout(() => {
+                signal.removeEventListener("abort", onAbort);
+                this._resolveWait = null;
+                resolve();
+            }, ms);
+            const onAbort = () => {
+                clearTimeout(timer);
+                this._resolveWait = null;
+                resolve();
+            };
+            this._resolveWait = () => {
+                clearTimeout(timer);
+                signal.removeEventListener("abort", onAbort);
+                resolve();
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+}
+//# sourceMappingURL=midi-engine.js.map

package/dist/playback/midi-engine.js.map

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

package/dist/playback/position.d.ts

@@ -0,0 +1,95 @@
+import type { ParsedMidi, MidiNoteEvent } from "../midi/types.js";
+/** Snapshot of playback position at a given moment. */
+export interface PositionSnapshot {
+    /** Absolute time in seconds (at speed 1.0). */
+    timeSec: number;
+    /** Current beat number (0-based, fractional). */
+    beat: number;
+    /** Estimated measure/bar number (1-based). */
+    measure: number;
+    /** Beat within the current measure (1-based, fractional). */
+    beatInMeasure: number;
+    /** Current tempo in BPM. */
+    bpm: number;
+    /** Event index of the nearest event at or before this position. */
+    nearestEventIndex: number;
+    /** Ratio through the total duration (0–1). */
+    ratio: number;
+}
+/** Position change callback. */
+export type PositionCallback = (snapshot: PositionSnapshot) => void;
+/**
+ * Playback position tracker for MIDI files.
+ *
+ * Given a ParsedMidi, provides:
+ * - `snapshotAt(timeSec)` — position info at any time
+ * - `eventIndexForTime(timeSec)` — find the event index at a given time
+ * - `timeForMeasure(measure)` — seek target for a given measure
+ * - `seekEventIndex(timeSec)` — find the event index to resume from
+ * - `measures` — estimated total measure count
+ *
+ * Assumes 4/4 time signature (most MIDI files). Tempo changes are respected.
+ */
+export declare class PositionTracker {
+    readonly midi: ParsedMidi;
+    /** Beats per measure (default 4 for 4/4). */
+    readonly beatsPerMeasure: number;
+    /** Pre-computed beat positions for each tempo segment. */
+    private tempoSegments;
+    /** Total duration in beats. */
+    readonly totalBeats: number;
+    /** Estimated total measure count. */
+    readonly totalMeasures: number;
+    constructor(midi: ParsedMidi, beatsPerMeasure?: number);
+    /**
+     * Get a position snapshot at a given time (seconds, at speed 1.0).
+     */
+    snapshotAt(timeSec: number): PositionSnapshot;
+    /**
+     * Find the event index of the first event at or after the given time.
+     * Returns events.length if past the end.
+     */
+    eventIndexForTime(timeSec: number): number;
+    /**
+     * Get the time (seconds) at the start of a given measure (1-based).
+     * Useful for seek operations.
+     */
+    timeForMeasure(measure: number): number;
+    /**
+     * Get the event index to resume playback from after seeking to a time.
+     * Same as eventIndexForTime but named clearly for seek use.
+     */
+    seekEventIndex(timeSec: number): number;
+    /**
+     * Get the BPM at a given time.
+     */
+    bpmAt(timeSec: number): number;
+    /**
+     * Get all events within a measure (1-based).
+     */
+    eventsInMeasure(measure: number): MidiNoteEvent[];
+    /**
+     * Get a summary of what's happening at a given measure for teaching purposes.
+     */
+    measureSummary(measure: number): {
+        measure: number;
+        events: MidiNoteEvent[];
+        noteCount: number;
+        avgVelocity: number;
+        minNote: number;
+        maxNote: number;
+        hasChord: boolean;
+        bpm: number;
+    };
+    /** Build tempo segments from the MIDI's tempo changes. */
+    private buildTempoSegments;
+    /** Convert absolute time (seconds) to beat number. */
+    private timeToBeat;
+    /** Convert beat number to absolute time (seconds). */
+    private beatToTime;
+}
+/**
+ * Create a PositionTracker for a parsed MIDI file.
+ */
+export declare function createPositionTracker(midi: ParsedMidi, beatsPerMeasure?: number): PositionTracker;
+//# sourceMappingURL=position.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../src/playback/position.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAc,MAAM,kBAAkB,CAAC;AAI9E,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAIpE;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;aAmBR,IAAI,EAAE,UAAU;IAlBlC,6CAA6C;IAC7C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,0DAA0D;IAC1D,OAAO,CAAC,aAAa,CAKlB;IAEH,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAGb,IAAI,EAAE,UAAU,EAChC,eAAe,GAAE,MAAU;IAQ7B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IAsB7C;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgB1C;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAKvC;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIvC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAY9B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE;IAMjD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;QAC/B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;KACb;IAyCD,0DAA0D;IAC1D,OAAO,CAAC,kBAAkB;IA0C1B,sDAAsD;IACtD,OAAO,CAAC,UAAU;IAelB,sDAAsD;IACtD,OAAO,CAAC,UAAU;CAcnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,eAAe,GAAE,MAAU,GAC1B,eAAe,CAEjB"}

package/dist/playback/position.js

@@ -0,0 +1,223 @@
+// ─── Playback Position Tracker ──────────────────────────────────────────────
+//
+// Tracks position within a MIDI file during playback: current time, beat,
+// estimated measure number, tempo, and provides seek-to-time support.
+//
+// MIDI files don't inherently have "measures" — we estimate them from the
+// time signature (assumed 4/4) and tempo. This gives a good-enough bar
+// number for display and teaching hook triggers.
+// ─────────────────────────────────────────────────────────────────────────────
+// ─── Position Tracker ───────────────────────────────────────────────────────
+/**
+ * Playback position tracker for MIDI files.
+ *
+ * Given a ParsedMidi, provides:
+ * - `snapshotAt(timeSec)` — position info at any time
+ * - `eventIndexForTime(timeSec)` — find the event index at a given time
+ * - `timeForMeasure(measure)` — seek target for a given measure
+ * - `seekEventIndex(timeSec)` — find the event index to resume from
+ * - `measures` — estimated total measure count
+ *
+ * Assumes 4/4 time signature (most MIDI files). Tempo changes are respected.
+ */
+export class PositionTracker {
+    midi;
+    /** Beats per measure (default 4 for 4/4). */
+    beatsPerMeasure;
+    /** Pre-computed beat positions for each tempo segment. */
+    tempoSegments;
+    /** Total duration in beats. */
+    totalBeats;
+    /** Estimated total measure count. */
+    totalMeasures;
+    constructor(midi, beatsPerMeasure = 4) {
+        this.midi = midi;
+        this.beatsPerMeasure = beatsPerMeasure;
+        this.tempoSegments = this.buildTempoSegments();
+        this.totalBeats = this.timeToBeat(midi.durationSeconds);
+        this.totalMeasures = Math.ceil(this.totalBeats / beatsPerMeasure);
+    }
+    /**
+     * Get a position snapshot at a given time (seconds, at speed 1.0).
+     */
+    snapshotAt(timeSec) {
+        const clampedTime = Math.max(0, Math.min(timeSec, this.midi.durationSeconds));
+        const beat = this.timeToBeat(clampedTime);
+        const measure = Math.floor(beat / this.beatsPerMeasure) + 1;
+        const beatInMeasure = (beat % this.beatsPerMeasure) + 1;
+        const bpm = this.bpmAt(clampedTime);
+        const nearestEventIndex = this.eventIndexForTime(clampedTime);
+        const ratio = this.midi.durationSeconds > 0
+            ? clampedTime / this.midi.durationSeconds
+            : 0;
+        return {
+            timeSec: clampedTime,
+            beat,
+            measure,
+            beatInMeasure,
+            bpm,
+            nearestEventIndex,
+            ratio,
+        };
+    }
+    /**
+     * Find the event index of the first event at or after the given time.
+     * Returns events.length if past the end.
+     */
+    eventIndexForTime(timeSec) {
+        const events = this.midi.events;
+        // Binary search for efficiency
+        let lo = 0;
+        let hi = events.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >>> 1;
+            if (events[mid].time < timeSec) {
+                lo = mid + 1;
+            }
+            else {
+                hi = mid;
+            }
+        }
+        return lo;
+    }
+    /**
+     * Get the time (seconds) at the start of a given measure (1-based).
+     * Useful for seek operations.
+     */
+    timeForMeasure(measure) {
+        const targetBeat = (measure - 1) * this.beatsPerMeasure;
+        return this.beatToTime(targetBeat);
+    }
+    /**
+     * Get the event index to resume playback from after seeking to a time.
+     * Same as eventIndexForTime but named clearly for seek use.
+     */
+    seekEventIndex(timeSec) {
+        return this.eventIndexForTime(timeSec);
+    }
+    /**
+     * Get the BPM at a given time.
+     */
+    bpmAt(timeSec) {
+        let bpm = this.midi.bpm;
+        for (const seg of this.tempoSegments) {
+            if (seg.startTimeSec <= timeSec) {
+                bpm = seg.bpm;
+            }
+            else {
+                break;
+            }
+        }
+        return bpm;
+    }
+    /**
+     * Get all events within a measure (1-based).
+     */
+    eventsInMeasure(measure) {
+        const startTime = this.timeForMeasure(measure);
+        const endTime = this.timeForMeasure(measure + 1);
+        return this.midi.events.filter((e) => e.time >= startTime && e.time < endTime);
+    }
+    /**
+     * Get a summary of what's happening at a given measure for teaching purposes.
+     */
+    measureSummary(measure) {
+        const events = this.eventsInMeasure(measure);
+        if (events.length === 0) {
+            return {
+                measure,
+                events,
+                noteCount: 0,
+                avgVelocity: 0,
+                minNote: 0,
+                maxNote: 0,
+                hasChord: false,
+                bpm: this.bpmAt(this.timeForMeasure(measure)),
+            };
+        }
+        const velocities = events.map((e) => e.velocity);
+        const notes = events.map((e) => e.note);
+        // Detect chords: multiple notes within 10ms of each other
+        let hasChord = false;
+        for (let i = 1; i < events.length; i++) {
+            if (events[i].time - events[i - 1].time < 0.01) {
+                hasChord = true;
+                break;
+            }
+        }
+        return {
+            measure,
+            events,
+            noteCount: events.length,
+            avgVelocity: Math.round(velocities.reduce((a, b) => a + b, 0) / velocities.length),
+            minNote: Math.min(...notes),
+            maxNote: Math.max(...notes),
+            hasChord,
+            bpm: this.bpmAt(events[0].time),
+        };
+    }
+    // ─── Internal ─────────────────────────────────────────────────────────────
+    /** Build tempo segments from the MIDI's tempo changes. */
+    buildTempoSegments() {
+        const changes = this.midi.tempoChanges;
+        if (changes.length === 0) {
+            const spb = 60 / this.midi.bpm;
+            return [{ startTimeSec: 0, startBeat: 0, bpm: this.midi.bpm, secondsPerBeat: spb }];
+        }
+        const segments = [];
+        let accumulatedBeats = 0;
+        for (let i = 0; i < changes.length; i++) {
+            const change = changes[i];
+            const spb = 60 / change.bpm;
+            if (i > 0) {
+                const prevSeg = segments[i - 1];
+                const timeDelta = change.time - prevSeg.startTimeSec;
+                accumulatedBeats = prevSeg.startBeat + timeDelta / prevSeg.secondsPerBeat;
+            }
+            segments.push({
+                startTimeSec: change.time,
+                startBeat: accumulatedBeats,
+                bpm: change.bpm,
+                secondsPerBeat: spb,
+            });
+        }
+        return segments;
+    }
+    /** Convert absolute time (seconds) to beat number. */
+    timeToBeat(timeSec) {
+        // Find the active tempo segment
+        let seg = this.tempoSegments[0];
+        for (const s of this.tempoSegments) {
+            if (s.startTimeSec <= timeSec) {
+                seg = s;
+            }
+            else {
+                break;
+            }
+        }
+        const timeSinceSegStart = timeSec - seg.startTimeSec;
+        return seg.startBeat + timeSinceSegStart / seg.secondsPerBeat;
+    }
+    /** Convert beat number to absolute time (seconds). */
+    beatToTime(beat) {
+        // Find the active tempo segment for this beat
+        let seg = this.tempoSegments[0];
+        for (const s of this.tempoSegments) {
+            if (s.startBeat <= beat) {
+                seg = s;
+            }
+            else {
+                break;
+            }
+        }
+        const beatsSinceSegStart = beat - seg.startBeat;
+        return seg.startTimeSec + beatsSinceSegStart * seg.secondsPerBeat;
+    }
+}
+/**
+ * Create a PositionTracker for a parsed MIDI file.
+ */
+export function createPositionTracker(midi, beatsPerMeasure = 4) {
+    return new PositionTracker(midi, beatsPerMeasure);
+}
+//# sourceMappingURL=position.js.map

package/dist/playback/position.js.map

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