@waveform-playlist/playout 9.5.2 → 10.1.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { Gain, ToneAudioNode, SynthOptions, Volume, BaseContext, Context } from 'tone';
 import { Fade, Track, MidiNoteData } from '@waveform-playlist/core';
+export { FadeConfig, FadeType, applyFadeIn, applyFadeOut } from '@waveform-playlist/core';
 import { ZoneMap, Generator, GeneratorType } from 'soundfont2';
 import { PlayoutAdapter } from '@waveform-playlist/engine';
 
@@ -536,44 +537,11 @@ declare function releaseMediaStreamSource(stream: MediaStream): void;
 declare function hasMediaStreamSource(stream: MediaStream): boolean;
 
 /**
- * Fade utilities for Web Audio API
- *
- * Applies fade in/out envelopes to AudioParam (typically gain)
- * using various curve types.
+ * Fade utilities — re-exports from @waveform-playlist/core
+ * plus Tone.js-specific helpers
  */
+
 declare function getUnderlyingAudioParam(signal: unknown): AudioParam | undefined;
-type FadeType = 'linear' | 'logarithmic' | 'exponential' | 'sCurve';
-/**
- * Simple fade configuration - just duration and type
- */
-interface FadeConfig {
-    /** Duration of the fade in seconds */
-    duration: number;
-    /** Type of fade curve (default: 'linear') */
-    type?: FadeType;
-}
-/**
- * Apply a fade in to an AudioParam
- *
- * @param param - The AudioParam to apply the fade to (usually gain)
- * @param startTime - When the fade starts (in seconds, AudioContext time)
- * @param duration - Duration of the fade in seconds
- * @param type - Type of fade curve
- * @param startValue - Starting value (default: 0)
- * @param endValue - Ending value (default: 1)
- */
-declare function applyFadeIn(param: AudioParam, startTime: number, duration: number, type?: FadeType, startValue?: number, endValue?: number): void;
-/**
- * Apply a fade out to an AudioParam
- *
- * @param param - The AudioParam to apply the fade to (usually gain)
- * @param startTime - When the fade starts (in seconds, AudioContext time)
- * @param duration - Duration of the fade in seconds
- * @param type - Type of fade curve
- * @param startValue - Starting value (default: 1)
- * @param endValue - Ending value (default: 0)
- */
-declare function applyFadeOut(param: AudioParam, startTime: number, duration: number, type?: FadeType, startValue?: number, endValue?: number): void;
 
 interface ToneAdapterOptions {
     effects?: EffectsFunction;
@@ -582,4 +550,4 @@ interface ToneAdapterOptions {
 }
 declare function createToneAdapter(options?: ToneAdapterOptions): PlayoutAdapter;
 
-export { type EffectsFunction, type FadeConfig, type FadeType, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, applyFadeIn, applyFadeOut, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };
+export { type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Gain, ToneAudioNode, SynthOptions, Volume, BaseContext, Context } from 'tone';
 import { Fade, Track, MidiNoteData } from '@waveform-playlist/core';
+export { FadeConfig, FadeType, applyFadeIn, applyFadeOut } from '@waveform-playlist/core';
 import { ZoneMap, Generator, GeneratorType } from 'soundfont2';
 import { PlayoutAdapter } from '@waveform-playlist/engine';
 
@@ -536,44 +537,11 @@ declare function releaseMediaStreamSource(stream: MediaStream): void;
 declare function hasMediaStreamSource(stream: MediaStream): boolean;
 
 /**
- * Fade utilities for Web Audio API
- *
- * Applies fade in/out envelopes to AudioParam (typically gain)
- * using various curve types.
+ * Fade utilities — re-exports from @waveform-playlist/core
+ * plus Tone.js-specific helpers
  */
+
 declare function getUnderlyingAudioParam(signal: unknown): AudioParam | undefined;
-type FadeType = 'linear' | 'logarithmic' | 'exponential' | 'sCurve';
-/**
- * Simple fade configuration - just duration and type
- */
-interface FadeConfig {
-    /** Duration of the fade in seconds */
-    duration: number;
-    /** Type of fade curve (default: 'linear') */
-    type?: FadeType;
-}
-/**
- * Apply a fade in to an AudioParam
- *
- * @param param - The AudioParam to apply the fade to (usually gain)
- * @param startTime - When the fade starts (in seconds, AudioContext time)
- * @param duration - Duration of the fade in seconds
- * @param type - Type of fade curve
- * @param startValue - Starting value (default: 0)
- * @param endValue - Ending value (default: 1)
- */
-declare function applyFadeIn(param: AudioParam, startTime: number, duration: number, type?: FadeType, startValue?: number, endValue?: number): void;
-/**
- * Apply a fade out to an AudioParam
- *
- * @param param - The AudioParam to apply the fade to (usually gain)
- * @param startTime - When the fade starts (in seconds, AudioContext time)
- * @param duration - Duration of the fade in seconds
- * @param type - Type of fade curve
- * @param startValue - Starting value (default: 1)
- * @param endValue - Ending value (default: 0)
- */
-declare function applyFadeOut(param: AudioParam, startTime: number, duration: number, type?: FadeType, startValue?: number, endValue?: number): void;
 
 interface ToneAdapterOptions {
     effects?: EffectsFunction;
@@ -582,4 +550,4 @@ interface ToneAdapterOptions {
 }
 declare function createToneAdapter(options?: ToneAdapterOptions): PlayoutAdapter;
 
-export { type EffectsFunction, type FadeConfig, type FadeType, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, applyFadeIn, applyFadeOut, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };
+export { type EffectsFunction, type LoopAndEnvelopeParams, type MidiClipInfo, MidiToneTrack, type MidiToneTrackOptions, type PlayableTrack, type PlaybackRateParams, SoundFontCache, type SoundFontSample, SoundFontToneTrack, type SoundFontToneTrackOptions, type ToneAdapterOptions, TonePlayout, type TonePlayoutOptions, ToneTrack, type ToneTrackOptions, type TrackEffectsFunction, calculatePlaybackRate, closeGlobalAudioContext, createToneAdapter, extractLoopAndEnvelope, getGeneratorValue, getGlobalAudioContext, getGlobalAudioContextState, getGlobalContext, getGlobalToneContext, getMediaStreamSource, getUnderlyingAudioParam, hasMediaStreamSource, int16ToFloat32, releaseMediaStreamSource, resumeGlobalAudioContext, timecentsToSeconds };

package/dist/index.js

@@ -25,8 +25,8 @@ __export(index_exports, {
   SoundFontToneTrack: () => SoundFontToneTrack,
   TonePlayout: () => TonePlayout,
   ToneTrack: () => ToneTrack,
-  applyFadeIn: () => applyFadeIn,
-  applyFadeOut: () => applyFadeOut,
+  applyFadeIn: () => import_core.applyFadeIn,
+  applyFadeOut: () => import_core.applyFadeOut,
   calculatePlaybackRate: () => calculatePlaybackRate,
   closeGlobalAudioContext: () => closeGlobalAudioContext,
   createToneAdapter: () => createToneAdapter,
@@ -53,6 +53,7 @@ var import_tone4 = require("tone");
 var import_tone = require("tone");
 
 // src/fades.ts
+var import_core = require("@waveform-playlist/core");
 var hasWarned = false;
 function getUnderlyingAudioParam(signal) {
   const param = signal._param;
@@ -64,92 +65,6 @@ function getUnderlyingAudioParam(signal) {
   }
   return param;
 }
-function linearCurve(length, fadeIn) {
-  const curve = new Float32Array(length);
-  const scale = length - 1;
-  for (let i = 0; i < length; i++) {
-    const x = i / scale;
-    curve[i] = fadeIn ? x : 1 - x;
-  }
-  return curve;
-}
-function exponentialCurve(length, fadeIn) {
-  const curve = new Float32Array(length);
-  const scale = length - 1;
-  for (let i = 0; i < length; i++) {
-    const x = i / scale;
-    const index = fadeIn ? i : length - 1 - i;
-    curve[index] = Math.exp(2 * x - 1) / Math.E;
-  }
-  return curve;
-}
-function sCurveCurve(length, fadeIn) {
-  const curve = new Float32Array(length);
-  const phase = fadeIn ? Math.PI / 2 : -Math.PI / 2;
-  for (let i = 0; i < length; i++) {
-    curve[i] = Math.sin(Math.PI * i / length - phase) / 2 + 0.5;
-  }
-  return curve;
-}
-function logarithmicCurve(length, fadeIn, base = 10) {
-  const curve = new Float32Array(length);
-  for (let i = 0; i < length; i++) {
-    const index = fadeIn ? i : length - 1 - i;
-    const x = i / length;
-    curve[index] = Math.log(1 + base * x) / Math.log(1 + base);
-  }
-  return curve;
-}
-function generateCurve(type, length, fadeIn) {
-  switch (type) {
-    case "linear":
-      return linearCurve(length, fadeIn);
-    case "exponential":
-      return exponentialCurve(length, fadeIn);
-    case "sCurve":
-      return sCurveCurve(length, fadeIn);
-    case "logarithmic":
-      return logarithmicCurve(length, fadeIn);
-    default:
-      return linearCurve(length, fadeIn);
-  }
-}
-function applyFadeIn(param, startTime, duration, type = "linear", startValue = 0, endValue = 1) {
-  if (duration <= 0) return;
-  if (type === "linear") {
-    param.setValueAtTime(startValue, startTime);
-    param.linearRampToValueAtTime(endValue, startTime + duration);
-  } else if (type === "exponential") {
-    param.setValueAtTime(Math.max(startValue, 1e-3), startTime);
-    param.exponentialRampToValueAtTime(Math.max(endValue, 1e-3), startTime + duration);
-  } else {
-    const curve = generateCurve(type, 1e4, true);
-    const scaledCurve = new Float32Array(curve.length);
-    const range = endValue - startValue;
-    for (let i = 0; i < curve.length; i++) {
-      scaledCurve[i] = startValue + curve[i] * range;
-    }
-    param.setValueCurveAtTime(scaledCurve, startTime, duration);
-  }
-}
-function applyFadeOut(param, startTime, duration, type = "linear", startValue = 1, endValue = 0) {
-  if (duration <= 0) return;
-  if (type === "linear") {
-    param.setValueAtTime(startValue, startTime);
-    param.linearRampToValueAtTime(endValue, startTime + duration);
-  } else if (type === "exponential") {
-    param.setValueAtTime(Math.max(startValue, 1e-3), startTime);
-    param.exponentialRampToValueAtTime(Math.max(endValue, 1e-3), startTime + duration);
-  } else {
-    const curve = generateCurve(type, 1e4, false);
-    const scaledCurve = new Float32Array(curve.length);
-    const range = startValue - endValue;
-    for (let i = 0; i < curve.length; i++) {
-      scaledCurve[i] = endValue + curve[i] * range;
-    }
-    param.setValueCurveAtTime(scaledCurve, startTime, duration);
-  }
-}
 
 // src/ToneTrack.ts
 var ToneTrack = class {
@@ -164,7 +79,7 @@ var ToneTrack = class {
     this._scheduleGuardOffset = 0;
     this.track = options.track;
     this.volumeNode = new import_tone.Volume(this.gainToDb(options.track.gain));
-    this.panNode = new import_tone.Panner(options.track.stereoPan);
+    this.panNode = new import_tone.Panner({ pan: options.track.stereoPan, channelCount: 2 });
     this.muteGain = new import_tone.Gain(options.track.muted ? 0 : 1);
     this.volumeNode.chain(this.panNode, this.muteGain);
     const destination = options.destination || (0, import_tone.getDestination)();
@@ -291,7 +206,7 @@ var ToneTrack = class {
     if (clipInfo.fadeIn && skipTime < clipInfo.fadeIn.duration) {
       const fadeInDuration = clipInfo.fadeIn.duration;
       if (skipTime <= 0) {
-        applyFadeIn(
+        (0, import_core.applyFadeIn)(
           audioParam,
           clipStartTime2,
           fadeInDuration,
@@ -303,7 +218,7 @@ var ToneTrack = class {
         const remainingFadeDuration = fadeInDuration - skipTime;
         const fadeProgress = skipTime / fadeInDuration;
         const startValue = clipInfo.gain * fadeProgress;
-        applyFadeIn(
+        (0, import_core.applyFadeIn)(
           audioParam,
           clipStartTime2,
           remainingFadeDuration,
@@ -320,7 +235,7 @@ var ToneTrack = class {
       const fadeOutStartInClip = fadeOutStart - skipTime;
       if (fadeOutStartInClip > 0) {
         const absoluteFadeOutStart = clipStartTime2 + fadeOutStartInClip;
-        applyFadeOut(
+        (0, import_core.applyFadeOut)(
           audioParam,
           absoluteFadeOutStart,
           clipInfo.fadeOut.duration,
@@ -333,7 +248,7 @@ var ToneTrack = class {
         const remainingFadeDuration = clipInfo.fadeOut.duration - elapsedFadeOut;
         const fadeProgress = elapsedFadeOut / clipInfo.fadeOut.duration;
         const startValue = clipInfo.gain * (1 - fadeProgress);
-        applyFadeOut(
+        (0, import_core.applyFadeOut)(
           audioParam,
           clipStartTime2,
           remainingFadeDuration,
@@ -1543,7 +1458,7 @@ function hasMediaStreamSource(stream) {
 }
 
 // src/TonePlayoutAdapter.ts
-var import_core = require("@waveform-playlist/core");
+var import_core2 = require("@waveform-playlist/core");
 var import_tone7 = require("tone");
 function createToneAdapter(options) {
   let playout = null;
@@ -1553,6 +1468,84 @@ function createToneAdapter(options) {
   let _loopStart = 0;
   let _loopEnd = 0;
   let _audioInitialized = false;
+  function addTrackToPlayout(p, track) {
+    const audioClips = track.clips.filter((c) => c.audioBuffer && !c.midiNotes);
+    const midiClips = track.clips.filter((c) => c.midiNotes && c.midiNotes.length > 0);
+    if (audioClips.length > 0) {
+      const startTime = Math.min(...audioClips.map(import_core2.clipStartTime));
+      const endTime = Math.max(...audioClips.map(import_core2.clipEndTime));
+      const trackObj = {
+        id: track.id,
+        name: track.name,
+        gain: track.volume,
+        muted: track.muted,
+        soloed: track.soloed,
+        stereoPan: track.pan,
+        startTime,
+        endTime
+      };
+      const clipInfos = audioClips.map((clip) => ({
+        buffer: clip.audioBuffer,
+        startTime: (0, import_core2.clipStartTime)(clip) - startTime,
+        duration: (0, import_core2.clipDurationTime)(clip),
+        offset: (0, import_core2.clipOffsetTime)(clip),
+        fadeIn: clip.fadeIn,
+        fadeOut: clip.fadeOut,
+        gain: clip.gain
+      }));
+      p.addTrack({
+        clips: clipInfos,
+        track: trackObj,
+        effects: track.effects
+      });
+    }
+    if (midiClips.length > 0) {
+      const startTime = Math.min(...midiClips.map(import_core2.clipStartTime));
+      const endTime = Math.max(...midiClips.map(import_core2.clipEndTime));
+      const trackId = audioClips.length > 0 ? `${track.id}:midi` : track.id;
+      const trackObj = {
+        id: trackId,
+        name: track.name,
+        gain: track.volume,
+        muted: track.muted,
+        soloed: track.soloed,
+        stereoPan: track.pan,
+        startTime,
+        endTime
+      };
+      const midiClipInfos = midiClips.map((clip) => ({
+        notes: clip.midiNotes,
+        startTime: (0, import_core2.clipStartTime)(clip) - startTime,
+        duration: (0, import_core2.clipDurationTime)(clip),
+        offset: (0, import_core2.clipOffsetTime)(clip)
+      }));
+      if (options?.soundFontCache?.isLoaded) {
+        const firstClip = midiClips[0];
+        const midiChannel = firstClip.midiChannel;
+        const isPercussion = midiChannel === 9;
+        const programNumber = firstClip.midiProgram ?? 0;
+        p.addSoundFontTrack({
+          clips: midiClipInfos,
+          track: trackObj,
+          soundFontCache: options.soundFontCache,
+          programNumber,
+          isPercussion,
+          effects: track.effects
+        });
+      } else {
+        if (options?.soundFontCache) {
+          console.warn(
+            `[waveform-playlist] SoundFont not loaded for track "${track.name}" \u2014 falling back to PolySynth.`
+          );
+        }
+        p.addMidiTrack({
+          clips: midiClipInfos,
+          track: trackObj,
+          effects: track.effects
+        });
+      }
+    }
+  }
   function buildPlayout(tracks) {
     if (playout) {
       try {
@@ -1577,82 +1570,7 @@ function createToneAdapter(options) {
       });
     }
     for (const track of tracks) {
-      const audioClips = track.clips.filter((c) => c.audioBuffer && !c.midiNotes);
-      const midiClips = track.clips.filter((c) => c.midiNotes && c.midiNotes.length > 0);
-      if (audioClips.length > 0) {
-        const startTime = Math.min(...audioClips.map(import_core.clipStartTime));
-        const endTime = Math.max(...audioClips.map(import_core.clipEndTime));
-        const trackObj = {
-          id: track.id,
-          name: track.name,
-          gain: track.volume,
-          muted: track.muted,
-          soloed: track.soloed,
-          stereoPan: track.pan,
-          startTime,
-          endTime
-        };
-        const clipInfos = audioClips.map((clip) => ({
-          buffer: clip.audioBuffer,
-          startTime: (0, import_core.clipStartTime)(clip) - startTime,
-          duration: (0, import_core.clipDurationTime)(clip),
-          offset: (0, import_core.clipOffsetTime)(clip),
-          fadeIn: clip.fadeIn,
-          fadeOut: clip.fadeOut,
-          gain: clip.gain
-        }));
-        playout.addTrack({
-          clips: clipInfos,
-          track: trackObj,
-          effects: track.effects
-        });
-      }
-      if (midiClips.length > 0) {
-        const startTime = Math.min(...midiClips.map(import_core.clipStartTime));
-        const endTime = Math.max(...midiClips.map(import_core.clipEndTime));
-        const trackId = audioClips.length > 0 ? `${track.id}:midi` : track.id;
-        const trackObj = {
-          id: trackId,
-          name: track.name,
-          gain: track.volume,
-          muted: track.muted,
-          soloed: track.soloed,
-          stereoPan: track.pan,
-          startTime,
-          endTime
-        };
-        const midiClipInfos = midiClips.map((clip) => ({
-          notes: clip.midiNotes,
-          startTime: (0, import_core.clipStartTime)(clip) - startTime,
-          duration: (0, import_core.clipDurationTime)(clip),
-          offset: (0, import_core.clipOffsetTime)(clip)
-        }));
-        if (options?.soundFontCache?.isLoaded) {
-          const firstClip = midiClips[0];
-          const midiChannel = firstClip.midiChannel;
-          const isPercussion = midiChannel === 9;
-          const programNumber = firstClip.midiProgram ?? 0;
-          playout.addSoundFontTrack({
-            clips: midiClipInfos,
-            track: trackObj,
-            soundFontCache: options.soundFontCache,
-            programNumber,
-            isPercussion,
-            effects: track.effects
-          });
-        } else {
-          if (options?.soundFontCache) {
-            console.warn(
-              `[waveform-playlist] SoundFont not loaded for track "${track.name}" \u2014 falling back to PolySynth.`
-            );
-          }
-          playout.addMidiTrack({
-            clips: midiClipInfos,
-            track: trackObj,
-            effects: track.effects
-          });
-        }
-      }
+      addTrackToPlayout(playout, track);
     }
     playout.applyInitialSoloState();
     playout.setLoop(_loopEnabled, _loopStart, _loopEnd);
@@ -1672,6 +1590,15 @@ function createToneAdapter(options) {
     setTracks(tracks) {
       buildPlayout(tracks);
     },
+    addTrack(track) {
+      if (!playout) {
+        throw new Error(
+          "[waveform-playlist] adapter.addTrack() called but no playout exists. Call setTracks() first to initialize the playout."
+        );
+      }
+      addTrackToPlayout(playout, track);
+      playout.applyInitialSoloState();
+    },
     play(startTime, endTime) {
       if (!playout) {
         console.warn(