@songram/songram-daw-engine 3.4.1 → 3.6.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Naomi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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;