@songram/songram-daw-engine 3.4.1 → 3.5.0

package/dist/index.d.ts

@@ -1913,6 +1913,7 @@ export declare class MidiToneTrack implements PlayableTrack {
     private muteGain;
     private track;
     private effectsCleanup?;
+    private _destination;
     constructor(options: MidiToneTrackOptions);
     /**
      * Trigger a note using the appropriate synth.
@@ -1946,6 +1947,10 @@ export declare class MidiToneTrack implements PlayableTrack {
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
+    /**
+     * Hot-swap the effects chain without stopping playback.
+     */
+    setEffects(effectsFn?: TrackEffectsFunction): void;
     dispose(): void;
     get id(): string;
     get duration(): number;
@@ -2173,6 +2178,8 @@ export declare interface PlayableTrack {
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
+    /** Hot-swap effects chain without stopping playback. */
+    setEffects(effectsFn?: TrackEffectsFunction): void;
     dispose(): void;
 }
 
@@ -2261,6 +2268,12 @@ export declare class PlaylistEngine {
     setTrackMute(trackId: string, muted: boolean): void;
     setTrackSolo(trackId: string, soloed: boolean): void;
     setTrackPan(trackId: string, pan: number): void;
+    /**
+     * Hot-swap a track's effects chain without stopping playback or rebuilding.
+     * The effects function is called with the track's audio graph end node and
+     * the master volume destination. Returns an optional cleanup function.
+     */
+    setTrackEffects(trackId: string, effectsFn?: ClipTrack['effects']): void;
     zoomIn(): void;
     zoomOut(): void;
     setZoomLevel(samplesPerPixel: number): void;
@@ -2302,6 +2315,8 @@ export declare interface PlayoutAdapter {
     setTracks(tracks: ClipTrack[]): void;
     /** Incrementally add a single track without rebuilding the entire playout. */
     addTrack?(track: ClipTrack): void;
+    /** Hot-swap a track's effects chain without stopping playback or rebuilding. */
+    setTrackEffects?(trackId: string, effectsFn?: ClipTrack['effects']): void;
     play(startTime: number, endTime?: number): void;
     pause(): void;
     stop(): void;
@@ -2870,6 +2885,7 @@ export declare class SoundFontToneTrack implements PlayableTrack {
     private muteGain;
     private track;
     private effectsCleanup?;
+    private _destination;
     constructor(options: SoundFontToneTrackOptions);
     /**
      * Trigger a note by creating a native AudioBufferSourceNode from the SoundFont cache.
@@ -2898,6 +2914,10 @@ export declare class SoundFontToneTrack implements PlayableTrack {
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
+    /**
+     * Hot-swap the effects chain without stopping playback.
+     */
+    setEffects(effectsFn?: TrackEffectsFunction): void;
     dispose(): void;
     get id(): string;
     get duration(): number;
@@ -3437,6 +3457,7 @@ export declare class ToneTrack {
     private muteGain;
     private track;
     private effectsCleanup?;
+    private _destination;
     private _scheduleGuardOffset;
     constructor(options: ToneTrackOptions);
     /**
@@ -3485,6 +3506,12 @@ export declare class ToneTrack {
     setPan(pan: number): void;
     setMute(muted: boolean): void;
     setSolo(soloed: boolean): void;
+    /**
+     * Hot-swap the effects chain without stopping playback.
+     * Disconnects the old effects (if any), runs the new effects function,
+     * and reconnects the audio graph. Active sources keep playing.
+     */
+    setEffects(effectsFn?: TrackEffectsFunction): void;
     dispose(): void;
     get id(): string;
     get duration(): number;