waa-play 0.1.0

package/dist/stretcher.d.cts

@@ -0,0 +1,171 @@
+/** State of a single chunk in the conversion pipeline. */
+type ChunkState = "pending" | "queued" | "converting" | "ready" | "failed" | "skipped" | "evicted";
+/** Playback state of the stretcher engine. */
+type StretcherPlaybackState = "waiting" | "playing" | "buffering" | "paused" | "ended";
+/** Buffer health classification. */
+type BufferHealth = "healthy" | "low" | "critical" | "empty";
+/** Metadata and state for a single chunk. */
+interface ChunkInfo {
+    index: number;
+    state: ChunkState;
+    inputStartSample: number;
+    inputEndSample: number;
+    overlapBefore: number;
+    overlapAfter: number;
+    outputBuffer: Float32Array[] | null;
+    outputLength: number;
+    priority: number;
+    retryCount: number;
+}
+/** Stretcher engine configuration. */
+interface StretcherEngineOptions {
+    tempo: number;
+    offset?: number;
+    loop?: boolean;
+    through?: AudioNode[];
+    destination?: AudioNode;
+    timeupdateInterval?: number;
+    workerPoolSize?: number;
+}
+/** Aggregate status of the stretcher engine. */
+interface StretcherStatus {
+    phase: StretcherPlaybackState;
+    conversion: {
+        total: number;
+        ready: number;
+        converting: number;
+        progress: number;
+    };
+    buffer: {
+        health: BufferHealth;
+        aheadSeconds: number;
+    };
+    playback: {
+        position: number;
+        duration: number;
+        tempo: number;
+    };
+}
+/** Snapshot extension for PlaybackSnapshot. */
+interface StretcherSnapshotExtension {
+    tempo: number;
+    converting: boolean;
+    conversionProgress: number;
+    bufferHealth: BufferHealth;
+    aheadSeconds: number;
+    buffering: boolean;
+    chunkStates: ChunkState[];
+    currentChunkIndex: number;
+    activeWindowStart: number;
+    activeWindowEnd: number;
+    totalChunks: number;
+    windowConversionProgress: number;
+}
+/** Events emitted by the stretcher engine. */
+interface StretcherEvents {
+    progress: {
+        total: number;
+        ready: number;
+        progress: number;
+    };
+    bufferhealth: {
+        health: BufferHealth;
+        aheadSeconds: number;
+    };
+    buffering: {
+        reason: "initial" | "seek" | "tempo-change" | "underrun";
+    };
+    buffered: {
+        stallDuration: number;
+    };
+    chunkready: {
+        index: number;
+    };
+    complete: void;
+    ended: void;
+    error: {
+        message: string;
+        chunkIndex?: number;
+        fatal: boolean;
+    };
+}
+/** The stretcher engine interface. */
+interface StretcherEngine {
+    start(): void;
+    pause(): void;
+    resume(): void;
+    seek(position: number): void;
+    stop(): void;
+    setTempo(tempo: number): void;
+    getCurrentPosition(): number;
+    getStatus(): StretcherStatus;
+    getSnapshot(): StretcherSnapshotExtension;
+    on<K extends keyof StretcherEvents>(event: K, handler: (data: StretcherEvents[K]) => void): () => void;
+    off<K extends keyof StretcherEvents>(event: K, handler: (data: StretcherEvents[K]) => void): void;
+    dispose(): void;
+}
+interface WorkerManager {
+    postConvert(chunkIndex: number, inputData: Float32Array[], tempo: number, sampleRate: number): void;
+    cancelCurrent(): void;
+    cancelChunk(chunkIndex: number): void;
+    isBusy(): boolean;
+    hasCapacity(): boolean;
+    getCurrentChunkIndex(): number | null;
+    getLastPostTime(): number | null;
+    getPostTimeForChunk(chunkIndex: number): number | null;
+    terminate(): void;
+}
+interface PriorityQueue<T> {
+    enqueue(item: T): void;
+    dequeue(): T | undefined;
+    peek(): T | undefined;
+    remove(predicate: (item: T) => boolean): boolean;
+    rebuild(): void;
+    clear(): void;
+    size(): number;
+    toArray(): T[];
+}
+interface ConversionScheduler {
+    start(currentChunkIndex: number): void;
+    updatePriorities(currentChunkIndex: number): void;
+    handleSeek(newChunkIndex: number): void;
+    handleTempoChange(newTempo: number): void;
+    restorePreviousTempo(): boolean;
+    dispatchNext(): void;
+    getChunks(): ChunkInfo[];
+    dispose(): void;
+    _handleResult(chunkIndex: number, outputData: Float32Array[], outputLength: number): void;
+    _handleError(chunkIndex: number, error: string): void;
+}
+interface ChunkPlayer {
+    playChunk(buffer: AudioBuffer, startTime: number, offsetInChunk?: number): void;
+    scheduleNext(buffer: AudioBuffer, startTime: number): void;
+    hasNextScheduled(): boolean;
+    handleSeek(buffer: AudioBuffer, offsetInChunk: number): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    getCurrentPosition(): number;
+    setOnChunkEnded(callback: () => void): void;
+    setOnNeedNext(callback: () => void): void;
+    setOnTransition(callback: () => void): void;
+    dispose(): void;
+}
+interface BufferMonitor {
+    getHealth(currentChunkIndex: number, chunks: ChunkInfo[]): BufferHealth;
+    getAheadSeconds(currentChunkIndex: number, chunks: ChunkInfo[]): number;
+    shouldEnterBuffering(currentChunkIndex: number, chunks: ChunkInfo[]): boolean;
+    shouldExitBuffering(currentChunkIndex: number, chunks: ChunkInfo[]): boolean;
+}
+interface ConversionEstimator {
+    recordConversion(durationMs: number): void;
+    estimateRemaining(remainingChunks: number): number;
+    getAverageMs(): number;
+}
+
+/**
+ * Create the stretcher engine that orchestrates all components.
+ */
+declare function createStretcherEngine(ctx: AudioContext, buffer: AudioBuffer, options: StretcherEngineOptions): StretcherEngine;
+
+export { type BufferHealth, type BufferMonitor, type ChunkInfo, type ChunkPlayer, type ChunkState, type ConversionEstimator, type ConversionScheduler, type PriorityQueue, type StretcherEngine, type StretcherEngineOptions, type StretcherEvents, type StretcherPlaybackState, type StretcherSnapshotExtension, type StretcherStatus, type WorkerManager, createStretcherEngine };

package/dist/stretcher.d.ts

@@ -0,0 +1,171 @@
+/** State of a single chunk in the conversion pipeline. */
+type ChunkState = "pending" | "queued" | "converting" | "ready" | "failed" | "skipped" | "evicted";
+/** Playback state of the stretcher engine. */
+type StretcherPlaybackState = "waiting" | "playing" | "buffering" | "paused" | "ended";
+/** Buffer health classification. */
+type BufferHealth = "healthy" | "low" | "critical" | "empty";
+/** Metadata and state for a single chunk. */
+interface ChunkInfo {
+    index: number;
+    state: ChunkState;
+    inputStartSample: number;
+    inputEndSample: number;
+    overlapBefore: number;
+    overlapAfter: number;
+    outputBuffer: Float32Array[] | null;
+    outputLength: number;
+    priority: number;
+    retryCount: number;
+}
+/** Stretcher engine configuration. */
+interface StretcherEngineOptions {
+    tempo: number;
+    offset?: number;
+    loop?: boolean;
+    through?: AudioNode[];
+    destination?: AudioNode;
+    timeupdateInterval?: number;
+    workerPoolSize?: number;
+}
+/** Aggregate status of the stretcher engine. */
+interface StretcherStatus {
+    phase: StretcherPlaybackState;
+    conversion: {
+        total: number;
+        ready: number;
+        converting: number;
+        progress: number;
+    };
+    buffer: {
+        health: BufferHealth;
+        aheadSeconds: number;
+    };
+    playback: {
+        position: number;
+        duration: number;
+        tempo: number;
+    };
+}
+/** Snapshot extension for PlaybackSnapshot. */
+interface StretcherSnapshotExtension {
+    tempo: number;
+    converting: boolean;
+    conversionProgress: number;
+    bufferHealth: BufferHealth;
+    aheadSeconds: number;
+    buffering: boolean;
+    chunkStates: ChunkState[];
+    currentChunkIndex: number;
+    activeWindowStart: number;
+    activeWindowEnd: number;
+    totalChunks: number;
+    windowConversionProgress: number;
+}
+/** Events emitted by the stretcher engine. */
+interface StretcherEvents {
+    progress: {
+        total: number;
+        ready: number;
+        progress: number;
+    };
+    bufferhealth: {
+        health: BufferHealth;
+        aheadSeconds: number;
+    };
+    buffering: {
+        reason: "initial" | "seek" | "tempo-change" | "underrun";
+    };
+    buffered: {
+        stallDuration: number;
+    };
+    chunkready: {
+        index: number;
+    };
+    complete: void;
+    ended: void;
+    error: {
+        message: string;
+        chunkIndex?: number;
+        fatal: boolean;
+    };
+}
+/** The stretcher engine interface. */
+interface StretcherEngine {
+    start(): void;
+    pause(): void;
+    resume(): void;
+    seek(position: number): void;
+    stop(): void;
+    setTempo(tempo: number): void;
+    getCurrentPosition(): number;
+    getStatus(): StretcherStatus;
+    getSnapshot(): StretcherSnapshotExtension;
+    on<K extends keyof StretcherEvents>(event: K, handler: (data: StretcherEvents[K]) => void): () => void;
+    off<K extends keyof StretcherEvents>(event: K, handler: (data: StretcherEvents[K]) => void): void;
+    dispose(): void;
+}
+interface WorkerManager {
+    postConvert(chunkIndex: number, inputData: Float32Array[], tempo: number, sampleRate: number): void;
+    cancelCurrent(): void;
+    cancelChunk(chunkIndex: number): void;
+    isBusy(): boolean;
+    hasCapacity(): boolean;
+    getCurrentChunkIndex(): number | null;
+    getLastPostTime(): number | null;
+    getPostTimeForChunk(chunkIndex: number): number | null;
+    terminate(): void;
+}
+interface PriorityQueue<T> {
+    enqueue(item: T): void;
+    dequeue(): T | undefined;
+    peek(): T | undefined;
+    remove(predicate: (item: T) => boolean): boolean;
+    rebuild(): void;
+    clear(): void;
+    size(): number;
+    toArray(): T[];
+}
+interface ConversionScheduler {
+    start(currentChunkIndex: number): void;
+    updatePriorities(currentChunkIndex: number): void;
+    handleSeek(newChunkIndex: number): void;
+    handleTempoChange(newTempo: number): void;
+    restorePreviousTempo(): boolean;
+    dispatchNext(): void;
+    getChunks(): ChunkInfo[];
+    dispose(): void;
+    _handleResult(chunkIndex: number, outputData: Float32Array[], outputLength: number): void;
+    _handleError(chunkIndex: number, error: string): void;
+}
+interface ChunkPlayer {
+    playChunk(buffer: AudioBuffer, startTime: number, offsetInChunk?: number): void;
+    scheduleNext(buffer: AudioBuffer, startTime: number): void;
+    hasNextScheduled(): boolean;
+    handleSeek(buffer: AudioBuffer, offsetInChunk: number): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    getCurrentPosition(): number;
+    setOnChunkEnded(callback: () => void): void;
+    setOnNeedNext(callback: () => void): void;
+    setOnTransition(callback: () => void): void;
+    dispose(): void;
+}
+interface BufferMonitor {
+    getHealth(currentChunkIndex: number, chunks: ChunkInfo[]): BufferHealth;
+    getAheadSeconds(currentChunkIndex: number, chunks: ChunkInfo[]): number;
+    shouldEnterBuffering(currentChunkIndex: number, chunks: ChunkInfo[]): boolean;
+    shouldExitBuffering(currentChunkIndex: number, chunks: ChunkInfo[]): boolean;
+}
+interface ConversionEstimator {
+    recordConversion(durationMs: number): void;
+    estimateRemaining(remainingChunks: number): number;
+    getAverageMs(): number;
+}
+
+/**
+ * Create the stretcher engine that orchestrates all components.
+ */
+declare function createStretcherEngine(ctx: AudioContext, buffer: AudioBuffer, options: StretcherEngineOptions): StretcherEngine;
+
+export { type BufferHealth, type BufferMonitor, type ChunkInfo, type ChunkPlayer, type ChunkState, type ConversionEstimator, type ConversionScheduler, type PriorityQueue, type StretcherEngine, type StretcherEngineOptions, type StretcherEvents, type StretcherPlaybackState, type StretcherSnapshotExtension, type StretcherStatus, type WorkerManager, createStretcherEngine };

package/dist/stretcher.js

@@ -0,0 +1,4 @@
+export { createStretcherEngine } from './chunk-V2QX5K42.js';
+import './chunk-GYH2JSCY.js';
+//# sourceMappingURL=stretcher.js.map
+//# sourceMappingURL=stretcher.js.map

package/dist/stretcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"stretcher.js"}

package/dist/synth.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunkQWNV2BZ5_cjs = require('./chunk-QWNV2BZ5.cjs');
+
+
+
+Object.defineProperty(exports, "createClickBuffer", {
+  enumerable: true,
+  get: function () { return chunkQWNV2BZ5_cjs.createClickBuffer; }
+});
+Object.defineProperty(exports, "createNoiseBuffer", {
+  enumerable: true,
+  get: function () { return chunkQWNV2BZ5_cjs.createNoiseBuffer; }
+});
+Object.defineProperty(exports, "createSineBuffer", {
+  enumerable: true,
+  get: function () { return chunkQWNV2BZ5_cjs.createSineBuffer; }
+});
+//# sourceMappingURL=synth.cjs.map
+//# sourceMappingURL=synth.cjs.map

package/dist/synth.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"synth.cjs"}

package/dist/synth.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Create an `AudioBuffer` containing a sine wave.
+ * Useful for test tones and debugging.
+ */
+declare function createSineBuffer(ctx: AudioContext, frequency: number, duration: number): AudioBuffer;
+/**
+ * Create an `AudioBuffer` containing white noise.
+ */
+declare function createNoiseBuffer(ctx: AudioContext, duration: number): AudioBuffer;
+/**
+ * Create an `AudioBuffer` containing a short click/impulse.
+ */
+declare function createClickBuffer(ctx: AudioContext, frequency: number, duration: number): AudioBuffer;
+
+export { createClickBuffer, createNoiseBuffer, createSineBuffer };

package/dist/synth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Create an `AudioBuffer` containing a sine wave.
+ * Useful for test tones and debugging.
+ */
+declare function createSineBuffer(ctx: AudioContext, frequency: number, duration: number): AudioBuffer;
+/**
+ * Create an `AudioBuffer` containing white noise.
+ */
+declare function createNoiseBuffer(ctx: AudioContext, duration: number): AudioBuffer;
+/**
+ * Create an `AudioBuffer` containing a short click/impulse.
+ */
+declare function createClickBuffer(ctx: AudioContext, frequency: number, duration: number): AudioBuffer;
+
+export { createClickBuffer, createNoiseBuffer, createSineBuffer };

package/dist/synth.js

@@ -0,0 +1,3 @@
+export { createClickBuffer, createNoiseBuffer, createSineBuffer } from './chunk-LETS7FKB.js';
+//# sourceMappingURL=synth.js.map
+//# sourceMappingURL=synth.js.map

package/dist/synth.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"synth.js"}

package/dist/types-DUrbEbPl.d.cts

@@ -0,0 +1,177 @@
+/** Possible states of a Playback instance. */
+type PlaybackState = "playing" | "paused" | "stopped";
+/** Options accepted by `play()`. */
+interface PlayOptions {
+    /** Start offset in seconds within the buffer. @default 0 */
+    offset?: number;
+    /** Whether the source should loop. @default false */
+    loop?: boolean;
+    /** Loop region start in seconds. */
+    loopStart?: number;
+    /** Loop region end in seconds. */
+    loopEnd?: number;
+    /** Playback speed multiplier. @default 1 */
+    playbackRate?: number;
+    /**
+     * A chain of AudioNodes the source should route through before reaching the
+     * destination. The first node receives the source output; the last node is
+     * connected to `destination`.
+     */
+    through?: AudioNode[];
+    /**
+     * Final destination node. Defaults to `ctx.destination`.
+     */
+    destination?: AudioNode;
+    /**
+     * Interval (ms) for `timeupdate` events. @default 50
+     */
+    timeupdateInterval?: number;
+    /**
+     * Enable pitch-preserving time-stretch via WSOLA.
+     * When true, `playbackRate` controls tempo without changing pitch.
+     * @default true
+     */
+    preservePitch?: boolean;
+}
+/** Stretcher snapshot extension (re-declared here to avoid static import). */
+interface StretcherSnapshotExtension {
+    tempo: number;
+    converting: boolean;
+    conversionProgress: number;
+    bufferHealth: "healthy" | "low" | "critical" | "empty";
+    aheadSeconds: number;
+    buffering: boolean;
+    chunkStates: ("pending" | "queued" | "converting" | "ready" | "failed" | "skipped" | "evicted")[];
+    currentChunkIndex: number;
+    activeWindowStart: number;
+    activeWindowEnd: number;
+    totalChunks: number;
+    windowConversionProgress: number;
+}
+/** An immutable snapshot of a Playback's current state. */
+interface PlaybackSnapshot {
+    state: PlaybackState;
+    position: number;
+    duration: number;
+    progress: number;
+    stretcher?: StretcherSnapshotExtension;
+}
+/** Event map emitted by a Playback instance. */
+interface PlaybackEventMap {
+    play: void;
+    pause: void;
+    resume: void;
+    seek: {
+        position: number;
+    };
+    stop: void;
+    ended: void;
+    loop: void;
+    statechange: {
+        state: PlaybackState;
+    };
+    timeupdate: {
+        position: number;
+        duration: number;
+    };
+    buffering: {
+        reason: "initial" | "seek" | "tempo-change" | "underrun";
+    };
+    buffered: {
+        stallDuration: number;
+    };
+}
+/** The object returned by `play()`. */
+interface Playback {
+    /** Current playback state. */
+    getState(): PlaybackState;
+    /** Current playback position in seconds (AudioContext‑accurate). */
+    getCurrentTime(): number;
+    /** Total duration of the underlying buffer in seconds. */
+    getDuration(): number;
+    /** Current progress as a ratio 0 – 1. */
+    getProgress(): number;
+    pause(): void;
+    resume(): void;
+    togglePlayPause(): void;
+    seek(position: number): void;
+    stop(): void;
+    setPlaybackRate(rate: number): void;
+    setLoop(loop: boolean): void;
+    /** Subscribe to a playback event. Returns an unsubscribe function. */
+    on<K extends keyof PlaybackEventMap>(event: K, handler: (data: PlaybackEventMap[K]) => void): () => void;
+    /** Unsubscribe a previously registered handler. */
+    off<K extends keyof PlaybackEventMap>(event: K, handler: (data: PlaybackEventMap[K]) => void): void;
+    /** Release all resources (source node, timers, listeners). */
+    dispose(): void;
+}
+/** Options for `loadBuffer`. */
+interface LoadBufferOptions {
+    /** Progress callback receiving a value between 0 and 1 (if available). */
+    onProgress?: (progress: number) => void;
+}
+/** Information about an AudioBuffer. */
+interface BufferInfo {
+    duration: number;
+    numberOfChannels: number;
+    sampleRate: number;
+    length: number;
+}
+/** Options for waveform extraction functions. */
+interface ExtractPeaksOptions {
+    /** Number of output data points. @default 200 */
+    resolution?: number;
+    /** Channel index to analyze. @default 0 */
+    channel?: number;
+}
+/** A min/max pair representing a single segment of the waveform. */
+interface PeakPair {
+    min: number;
+    max: number;
+}
+/** Curve types for fade operations. */
+type FadeCurve = "linear" | "exponential" | "equal-power";
+/** Options for fade functions. */
+interface FadeOptions {
+    /** Duration of the fade in seconds. @default 1 */
+    duration?: number;
+    /** Easing curve. @default "linear" */
+    curve?: FadeCurve;
+}
+/** Options for crossfade. */
+interface CrossfadeOptions extends FadeOptions {
+}
+/** Options for autoFade. */
+interface AutoFadeOptions {
+    /** Fade-in duration at the start in seconds. @default 0 */
+    fadeIn?: number;
+    /** Fade-out duration before the end in seconds. @default 0 */
+    fadeOut?: number;
+    /** Curve for both fades. @default "linear" */
+    curve?: FadeCurve;
+}
+/** Options for `createScheduler`. */
+interface SchedulerOptions {
+    /** How far ahead (seconds) to schedule events. @default 0.1 */
+    lookahead?: number;
+    /** Interval (ms) between scheduler ticks. @default 25 */
+    interval?: number;
+}
+/** A scheduled event entry. */
+interface ScheduledEvent {
+    id: string;
+    time: number;
+    callback: (time: number) => void;
+}
+/** Options for `createClock`. */
+interface ClockOptions {
+    /** Beats per minute. @default 120 */
+    bpm?: number;
+}
+/** Options for `createContext`. */
+interface CreateContextOptions {
+    sampleRate?: number;
+    latencyHint?: AudioContextLatencyCategory | number;
+}
+
+export type { AutoFadeOptions as A, BufferInfo as B, ClockOptions as C, ExtractPeaksOptions as E, FadeCurve as F, LoadBufferOptions as L, PeakPair as P, ScheduledEvent as S, CreateContextOptions as a, CrossfadeOptions as b, FadeOptions as c, PlayOptions as d, Playback as e, PlaybackEventMap as f, PlaybackSnapshot as g, PlaybackState as h, SchedulerOptions as i, StretcherSnapshotExtension as j };