@dawcore/transport 0.0.9 → 0.0.11

package/dist/index.mjs

@@ -224,15 +224,27 @@ function curveNormalizedAt(x, slope) {
   const p = Math.max(CURVE_EPSILON, Math.min(1 - CURVE_EPSILON, slope));
   return p * p / (1 - p * 2) * (Math.pow((1 - p) / p, 2 * x) - 1);
 }
-var TempoMap = class {
+var TempoMap = class _TempoMap {
   constructor(ppqn = 960, initialBpm = 120) {
+    _TempoMap._validateBpm(initialBpm);
     this._ppqn = ppqn;
     this._entries = [{ tick: 0, bpm: initialBpm, interpolation: "step", secondsAtTick: 0 }];
   }
+  /** A non-finite or non-positive BPM silently corrupts the secondsAtTick
+   *  cache (Infinity, or non-monotonic values that break the binary search
+   *  in secondsToTicks) — reject it at the boundary instead. */
+  static _validateBpm(bpm) {
+    if (!Number.isFinite(bpm) || bpm <= 0) {
+      throw new Error(
+        "[waveform-playlist] TempoMap: bpm must be a finite positive number, got " + bpm
+      );
+    }
+  }
   getTempo(atTick = 0) {
     return this._getTempoAt(atTick);
   }
   setTempo(bpm, atTick = 0, options) {
+    _TempoMap._validateBpm(bpm);
     const interpolation = options?.interpolation ?? "step";
     if (typeof interpolation === "object" && interpolation.type === "curve") {
       const s = interpolation.slope;
@@ -470,6 +482,7 @@ function isPowerOf2(n) {
 var MeterMap = class {
   constructor(ppqn, numerator = 4, denominator = 4) {
     this._ppqn = ppqn;
+    this._validateMeter(numerator, denominator);
     this._entries = [{ tick: 0, numerator, denominator, barAtTick: 0 }];
   }
   get ppqn() {
@@ -654,7 +667,7 @@ var MasterNode = class {
     try {
       this._gainNode.disconnect();
     } catch (err) {
-      console.warn("[waveform-playlist] MasterNode.dispose: error disconnecting:", String(err));
+      console.warn("[waveform-playlist] MasterNode.dispose: error disconnecting: " + String(err));
     }
   }
 };
@@ -763,11 +776,19 @@ var ClipPlayer = class {
         const clipTick = clip.startTick !== void 0 ? clip.startTick : this._sampleTimeline.samplesToTicks(clip.startSample);
         if (clipTick < fromTick) continue;
         if (clipTick >= toTick) continue;
-        const fadeInDurationSamples = clip.fadeIn ? clip.fadeIn.duration ?? 0 : 0;
-        const fadeOutDurationSamples = clip.fadeOut ? clip.fadeOut.duration ?? 0 : 0;
+        const timelineRate = this._sampleTimeline.sampleRate;
+        const bufferRate = clip.audioBuffer.sampleRate;
+        const fadeInDurationSamples = clip.fadeIn ? Math.round((clip.fadeIn.duration ?? 0) * timelineRate) : 0;
+        const fadeOutDurationSamples = clip.fadeOut ? Math.round((clip.fadeOut.duration ?? 0) * timelineRate) : 0;
         let durationSamples = clip.durationSamples;
-        if (this._loopEnabled && clip.startSample + durationSamples > this._loopEndSamples) {
-          durationSamples = this._loopEndSamples - clip.startSample;
+        if (this._loopEnabled) {
+          const durationTimelineSamples = Math.round(
+            clip.durationSamples / bufferRate * timelineRate
+          );
+          const allowedTimelineSamples = this._loopEndSamples - clip.startSample;
+          if (durationTimelineSamples > allowedTimelineSamples) {
+            durationSamples = Math.round(allowedTimelineSamples / timelineRate * bufferRate);
+          }
         }
         events.push({
           trackId,
@@ -793,9 +814,9 @@ var ClipPlayer = class {
       );
       return;
     }
-    const sampleRate = this._sampleTimeline.sampleRate;
-    const offsetSeconds = event.offsetSamples / sampleRate;
-    const durationSeconds = event.durationSamples / sampleRate;
+    const bufferRate = event.audioBuffer.sampleRate;
+    const offsetSeconds = event.offsetSamples / bufferRate;
+    const durationSeconds = event.durationSamples / bufferRate;
     if (offsetSeconds >= event.audioBuffer.duration) {
       console.warn(
         "[waveform-playlist] ClipPlayer.consume: offset (" + offsetSeconds + "s) exceeds audioBuffer.duration (" + event.audioBuffer.duration + 's) for clipId "' + event.clipId + '" \u2014 clip will not play'
@@ -808,8 +829,9 @@ var ClipPlayer = class {
     const when = this._toAudioTime(transportSeconds);
     const gainNode = this._audioContext.createGain();
     gainNode.gain.value = event.gain;
-    let fadeIn = event.fadeInDurationSamples / sampleRate;
-    let fadeOut = event.fadeOutDurationSamples / sampleRate;
+    const timelineRate = this._sampleTimeline.sampleRate;
+    let fadeIn = event.fadeInDurationSamples / timelineRate;
+    let fadeOut = event.fadeOutDurationSamples / timelineRate;
     if (fadeIn + fadeOut > durationSeconds) {
       const ratio = durationSeconds / (fadeIn + fadeOut);
       fadeIn *= ratio;
@@ -849,16 +871,21 @@ var ClipPlayer = class {
         if (!clip.audioBuffer) continue;
         const clipTick = clip.startTick !== void 0 ? clip.startTick : this._sampleTimeline.samplesToTicks(clip.startSample);
         if (clipTick >= newTick) continue;
-        const clipEndSample = clip.startSample + clip.durationSamples;
+        const timelineRate = this._sampleTimeline.sampleRate;
+        const bufferRate = clip.audioBuffer.sampleRate;
+        const bufToTimeline = (n) => Math.round(n / bufferRate * timelineRate);
+        const timelineToBuf = (n) => Math.round(n / timelineRate * bufferRate);
+        const clipEndSample = clip.startSample + bufToTimeline(clip.durationSamples);
         if (clipEndSample <= newSample) continue;
         const offsetIntoClipSamples = newSample - clip.startSample;
-        const offsetSamples = clip.offsetSamples + offsetIntoClipSamples;
-        let durationSamples = clipEndSample - newSample;
-        if (this._loopEnabled && newSample + durationSamples > this._loopEndSamples) {
-          durationSamples = this._loopEndSamples - newSample;
+        const offsetSamples = clip.offsetSamples + timelineToBuf(offsetIntoClipSamples);
+        let remainingTimelineSamples = clipEndSample - newSample;
+        if (this._loopEnabled && newSample + remainingTimelineSamples > this._loopEndSamples) {
+          remainingTimelineSamples = this._loopEndSamples - newSample;
         }
-        if (durationSamples <= 0) continue;
-        const fadeOutDurationSamples = clip.fadeOut ? clip.fadeOut.duration ?? 0 : 0;
+        if (remainingTimelineSamples <= 0) continue;
+        const durationSamples = timelineToBuf(remainingTimelineSamples);
+        const fadeOutDurationSamples = clip.fadeOut ? Math.round((clip.fadeOut.duration ?? 0) * timelineRate) : 0;
         this.consume({
           trackId,
           clipId: clip.id,
@@ -1575,6 +1602,11 @@ var _Transport = class _Transport {
     }
     trackNode.disconnectEffects();
   }
+  /** The master output AudioNode. Connect your own nodes (analyzers, recorders, etc.)
+   *  in parallel. The transport already routes this to audioContext.destination. */
+  get masterOutputNode() {
+    return this._masterNode.output;
+  }
   // --- Events ---
   on(event, cb) {
     if (!this._listeners.has(event)) {
@@ -1887,6 +1919,9 @@ var NativePlayoutAdapter = class {
   secondsToTicks(seconds) {
     return this._transport.timeToTick(seconds);
   }
+  get masterOutputNode() {
+    return this._transport.masterOutputNode;
+  }
   dispose() {
     this._transport.dispose();
   }