@waveform-playlist/playout 8.0.0 → 8.1.0

package/dist/index.d.mts

@@ -20,35 +20,67 @@ interface ToneTrackOptions {
     destination?: ToneAudioNode;
 }
 declare class ToneTrack {
-    private clips;
+    private scheduledClips;
+    private activeSources;
     private volumeNode;
     private panNode;
     private muteGain;
     private track;
     private effectsCleanup?;
-    private onStopCallback?;
-    private activePlayers;
+    private _scheduleGuardOffset;
     constructor(options: ToneTrackOptions);
     /**
-     * Schedule fade envelopes for a clip at the given start time
+     * Create and start an AudioBufferSourceNode for a clip.
+     * Sources are one-shot: each play or loop iteration creates a fresh one.
+     */
+    private startClipSource;
+    /**
+     * Set the schedule guard offset. Schedule callbacks for clips before this
+     * offset are suppressed (already handled by startMidClipSources).
+     * Must be called before transport.start() and in the loop handler.
+     */
+    setScheduleGuardOffset(offset: number): void;
+    /**
+     * Start sources for clips that span the given Transport position.
+     * Used for mid-playback seeking and loop boundary handling where
+     * Transport.schedule() callbacks have already passed.
+     *
+     * Uses strict < for absClipStart to avoid double-creation with
+     * schedule callbacks at exact Transport position (e.g., loopStart).
+     */
+    startMidClipSources(transportOffset: number, audioContextTime: number): void;
+    /**
+     * Stop all active AudioBufferSourceNodes and clear the set.
+     * Native AudioBufferSourceNodes ignore Transport state changes —
+     * they must be explicitly stopped.
+     */
+    stopAllSources(): void;
+    /**
+     * Schedule fade envelopes for a clip at the given AudioContext time.
+     * Uses native GainNode.gain (AudioParam) directly — no _param workaround needed.
      */
     private scheduleFades;
+    /**
+     * Prepare fade envelopes for all clips based on Transport offset.
+     * Called before Transport.start() to schedule fades at correct AudioContext times.
+     */
+    prepareFades(when: number, transportOffset: number): void;
+    /**
+     * Cancel all scheduled fade automation and reset to nominal gain.
+     * Called on pause/stop to prevent stale fade envelopes.
+     */
+    cancelFades(): void;
     private gainToDb;
     setVolume(gain: number): void;
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
-    play(when?: number, offset?: number, duration?: number): void;
-    pause(): void;
-    stop(when?: number): void;
     dispose(): void;
     get id(): string;
     get duration(): number;
     get buffer(): AudioBuffer;
-    get isPlaying(): boolean;
     get muted(): boolean;
     get startTime(): number;
-    setOnStopCallback(callback: () => void): void;
 }
 
 type EffectsFunction = (masterGainNode: Volume, destination: ToneAudioNode, isOffline: boolean) => void | (() => void);
@@ -65,10 +97,14 @@ declare class TonePlayout {
     private manualMuteState;
     private effectsCleanup?;
     private onPlaybackCompleteCallback?;
-    private activeTracks;
-    private playbackSessionId;
+    private _completionEventId;
+    private _loopHandler;
+    private _loopEnabled;
+    private _loopStart;
+    private _loopEnd;
     constructor(options?: TonePlayoutOptions);
     private gainToDb;
+    private clearCompletionEvent;
     init(): Promise<void>;
     addTrack(trackOptions: ToneTrackOptions): ToneTrack;
     /**
@@ -85,6 +121,7 @@ declare class TonePlayout {
     setSolo(trackId: string, soloed: boolean): void;
     private updateSoloMuting;
     setMute(trackId: string, muted: boolean): void;
+    setLoop(enabled: boolean, loopStart: number, loopEnd: number): void;
     getCurrentTime(): number;
     seekTo(time: number): void;
     dispose(): void;

package/dist/index.d.ts

@@ -20,35 +20,67 @@ interface ToneTrackOptions {
     destination?: ToneAudioNode;
 }
 declare class ToneTrack {
-    private clips;
+    private scheduledClips;
+    private activeSources;
     private volumeNode;
     private panNode;
     private muteGain;
     private track;
     private effectsCleanup?;
-    private onStopCallback?;
-    private activePlayers;
+    private _scheduleGuardOffset;
     constructor(options: ToneTrackOptions);
     /**
-     * Schedule fade envelopes for a clip at the given start time
+     * Create and start an AudioBufferSourceNode for a clip.
+     * Sources are one-shot: each play or loop iteration creates a fresh one.
+     */
+    private startClipSource;
+    /**
+     * Set the schedule guard offset. Schedule callbacks for clips before this
+     * offset are suppressed (already handled by startMidClipSources).
+     * Must be called before transport.start() and in the loop handler.
+     */
+    setScheduleGuardOffset(offset: number): void;
+    /**
+     * Start sources for clips that span the given Transport position.
+     * Used for mid-playback seeking and loop boundary handling where
+     * Transport.schedule() callbacks have already passed.
+     *
+     * Uses strict < for absClipStart to avoid double-creation with
+     * schedule callbacks at exact Transport position (e.g., loopStart).
+     */
+    startMidClipSources(transportOffset: number, audioContextTime: number): void;
+    /**
+     * Stop all active AudioBufferSourceNodes and clear the set.
+     * Native AudioBufferSourceNodes ignore Transport state changes —
+     * they must be explicitly stopped.
+     */
+    stopAllSources(): void;
+    /**
+     * Schedule fade envelopes for a clip at the given AudioContext time.
+     * Uses native GainNode.gain (AudioParam) directly — no _param workaround needed.
      */
     private scheduleFades;
+    /**
+     * Prepare fade envelopes for all clips based on Transport offset.
+     * Called before Transport.start() to schedule fades at correct AudioContext times.
+     */
+    prepareFades(when: number, transportOffset: number): void;
+    /**
+     * Cancel all scheduled fade automation and reset to nominal gain.
+     * Called on pause/stop to prevent stale fade envelopes.
+     */
+    cancelFades(): void;
     private gainToDb;
     setVolume(gain: number): void;
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
-    play(when?: number, offset?: number, duration?: number): void;
-    pause(): void;
-    stop(when?: number): void;
     dispose(): void;
     get id(): string;
     get duration(): number;
     get buffer(): AudioBuffer;
-    get isPlaying(): boolean;
     get muted(): boolean;
     get startTime(): number;
-    setOnStopCallback(callback: () => void): void;
 }
 
 type EffectsFunction = (masterGainNode: Volume, destination: ToneAudioNode, isOffline: boolean) => void | (() => void);
@@ -65,10 +97,14 @@ declare class TonePlayout {
     private manualMuteState;
     private effectsCleanup?;
     private onPlaybackCompleteCallback?;
-    private activeTracks;
-    private playbackSessionId;
+    private _completionEventId;
+    private _loopHandler;
+    private _loopEnabled;
+    private _loopStart;
+    private _loopEnd;
     constructor(options?: TonePlayoutOptions);
     private gainToDb;
+    private clearCompletionEvent;
     init(): Promise<void>;
     addTrack(trackOptions: ToneTrackOptions): ToneTrack;
     /**
@@ -85,6 +121,7 @@ declare class TonePlayout {
     setSolo(trackId: string, soloed: boolean): void;
     private updateSoloMuting;
     setMute(trackId: string, muted: boolean): void;
+    setLoop(enabled: boolean, loopStart: number, loopEnd: number): void;
     getCurrentTime(): number;
     seekTo(time: number): void;
     dispose(): void;