@waveform-playlist/playout 12.1.0 → 12.3.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,9 +1633,15 @@ 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;
@@ -1821,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();
@@ -1885,6 +1906,9 @@ function createToneAdapter(options) {
     get audioContext() {
       return getGlobalAudioContext();
     },
+    get lookAhead() {
+      return getGlobalContext().lookAhead ?? 0;
+    },
     get ppqn() {
       return _ppqn;
     },
@@ -1921,6 +1945,14 @@ function createToneAdapter(options) {
     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();