@waveform-playlist/playout 12.0.0 → 12.2.0

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/TonePlayout.ts
 import {
   Volume as Volume4,
+  Gain as Gain4,
   getDestination as getDestination4,
   start,
   now,
@@ -1047,13 +1048,15 @@ var TonePlayout = class {
     this._loopStart = 0;
     this._loopEnd = 0;
     this.masterVolume = new Volume4(gainToDb4(options.masterGain ?? 1));
+    this._masterTap = new Gain4(1);
     if (options.effects) {
-      const cleanup = options.effects(this.masterVolume, getDestination4(), false);
+      const cleanup = options.effects(this.masterVolume, this._masterTap, false);
       if (cleanup) {
         this.effectsCleanup = cleanup;
       }
+      this._masterTap.connect(getDestination4());
     } else {
-      this.masterVolume.toDestination();
+      this.masterVolume.chain(this._masterTap, getDestination4());
     }
     if (options.tracks) {
       options.tracks.forEach((track) => {
@@ -1258,6 +1261,12 @@ var TonePlayout = class {
   setMasterGain(gain) {
     this.masterVolume.volume.value = gainToDb4(gain);
   }
+  /** The master output tap node. In the signal chain: masterVolume → tap → destination.
+   *  Connect analyzers/effects/recorders here — parallel or serial.
+   *  The tap's native GainNode is on the same standardized-audio-context as adapter.audioContext. */
+  get masterOutputNode() {
+    return this._masterTap.input;
+  }
   setSolo(trackId, soloed) {
     const track = this.tracks.get(trackId);
     if (track) {
@@ -1357,10 +1366,15 @@ var TonePlayout = class {
         console.warn("[waveform-playlist] Error during master effects cleanup:", err);
       }
     }
+    try {
+      this._masterTap.dispose();
+    } catch (err) {
+      console.warn("[waveform-playlist] Error disposing master tap: " + String(err));
+    }
     try {
       this.masterVolume.dispose();
     } catch (err) {
-      console.warn("[waveform-playlist] Error disposing master volume:", err);
+      console.warn("[waveform-playlist] Error disposing master volume: " + String(err));
     }
   }
   get context() {
@@ -1619,14 +1633,22 @@ import {
 } from "@waveform-playlist/core";
 import { now as now2 } from "tone";
 function createToneAdapter(options) {
-  let playout = null;
+  getGlobalContext();
+  let _playoutGeneration = 1;
+  let playout = new TonePlayout({ effects: options?.effects });
+  playout.setOnPlaybackComplete(() => {
+    if (_playoutGeneration === 1) {
+      _isPlaying = false;
+    }
+  });
   let _isPlaying = false;
-  let _playoutGeneration = 0;
   let _loopEnabled = false;
   let _loopStart = 0;
   let _loopEnd = 0;
   let _audioInitialized = false;
   let _pendingInit = null;
+  const _ppqn = options?.ppqn ?? 192;
+  let _bpm = 120;
   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);
@@ -1819,9 +1841,10 @@ function createToneAdapter(options) {
     },
     addTrack(track) {
       if (!playout) {
-        throw new Error(
-          "[waveform-playlist] adapter.addTrack() called but no playout exists. Call setTracks() first to initialize the playout."
+        console.warn(
+          "[waveform-playlist] adapter.addTrack() called but playout is not available (adapter may have been disposed)."
         );
+        return;
       }
       addTrackToPlayout(playout, track);
       playout.applyInitialSoloState();
@@ -1880,11 +1903,58 @@ function createToneAdapter(options) {
       _loopEnd = end;
       playout?.setLoop(enabled, start2, end);
     },
+    get audioContext() {
+      return getGlobalAudioContext();
+    },
+    get ppqn() {
+      return _ppqn;
+    },
+    setTempo(bpm, atTick) {
+      if (atTick !== void 0) {
+        throw new Error(
+          "Multiple tempo changes not supported by TonePlayoutAdapter. Use NativePlayoutAdapter from @dawcore/transport for multi-tempo support."
+        );
+      }
+      _bpm = bpm;
+    },
+    setMeter(_numerator, _denominator, atTick) {
+      if (atTick !== void 0) {
+        throw new Error(
+          "Multiple meter changes not supported by TonePlayoutAdapter. Use NativePlayoutAdapter from @dawcore/transport for multi-meter support."
+        );
+      }
+    },
+    ticksToSeconds(tick) {
+      return tick * 60 / (_bpm * _ppqn);
+    },
+    secondsToTicks(seconds) {
+      return seconds * _bpm * _ppqn / 60;
+    },
+    // --- Cross-context worklet support ---
+    // Tone.js wraps standardized-audio-context. Native AudioWorkletNode constructor
+    // rejects it ("parameter 1 is not of type 'BaseAudioContext'").
+    // These methods use Tone.js Context wrappers that handle both context types.
+    // Note: addWorkletModule is NOT needed — rawContext.audioWorklet.addModule() works
+    // identically for both native and standardized contexts. Only node/source creation differs.
+    createAudioWorkletNode(name, options2) {
+      return getGlobalContext().createAudioWorkletNode(name, options2);
+    },
+    createMediaStreamSource(stream) {
+      return getGlobalContext().createMediaStreamSource(stream);
+    },
+    get masterOutputNode() {
+      if (!playout) {
+        throw new Error(
+          "[waveform-playlist] adapter.masterOutputNode accessed after dispose. Disconnect your analyzer before disposing the adapter."
+        );
+      }
+      return playout.masterOutputNode;
+    },
     dispose() {
       try {
         playout?.dispose();
       } catch (err) {
-        console.warn("[waveform-playlist] Error disposing playout:", err);
+        console.warn("[waveform-playlist] Error disposing playout: " + String(err));
       }
       playout = null;
       _isPlaying = false;