@dawcore/transport 0.0.11 → 0.0.13

package/dist/index.mjs

@@ -212,7 +212,7 @@ var SampleTimeline = class {
         "[waveform-playlist] SampleTimeline: tempoMap not set \u2014 call setTempoMap() first"
       );
     }
-    return this._tempoMap.secondsToTicks(samples / this._sampleRate);
+    return Math.round(this._tempoMap.secondsToTicks(samples / this._sampleRate));
   }
 };
 
@@ -243,6 +243,11 @@ var TempoMap = class _TempoMap {
   getTempo(atTick = 0) {
     return this._getTempoAt(atTick);
   }
+  /** Number of tempo entries in the map. Always >= 1 — the tick-0 entry is
+   *  permanent. Used by Transport.setTempo to detect multi-entry maps. */
+  get entryCount() {
+    return this._entries.length;
+  }
   setTempo(bpm, atTick = 0, options) {
     _TempoMap._validateBpm(bpm);
     const interpolation = options?.interpolation ?? "step";
@@ -321,6 +326,18 @@ var TempoMap = class _TempoMap {
     const first = this._entries[0];
     this._entries = [{ tick: 0, bpm: first.bpm, interpolation: "step", secondsAtTick: 0 }];
   }
+  /** Remove the tempo entry at exactly `atTick`, if one exists. The tick-0
+   *  entry is permanent (a map must always have a tempo) — removing it is a
+   *  no-op, matching removeMeter's treatment of the initial meter. The
+   *  seconds cache is recomputed from the removal point, the same partial
+   *  update setTempo uses. */
+  removeTempo(atTick) {
+    if (atTick === 0) return;
+    const i = this._entries.findIndex((e) => e.tick === atTick);
+    if (i === -1) return;
+    this._entries = [...this._entries.slice(0, i), ...this._entries.slice(i + 1)];
+    this._recomputeCache(i);
+  }
   /** Get the interpolated BPM at a tick position */
   _getTempoAt(atTick) {
     const entryIndex = this._entryIndexAt(atTick);
@@ -646,12 +663,19 @@ var MeterMap = class {
         "[waveform-playlist] MeterMap: denominator must be a power of 2 (1-32), got " + denominator
       );
     }
+    if (!Number.isInteger(this._ppqn * 4 / denominator)) {
+      throw new Error(
+        "[waveform-playlist] MeterMap: ppqn (" + this._ppqn + ") * 4 is not divisible by denominator (" + denominator + ") \u2014 bar boundaries would fall on fractional ticks"
+      );
+    }
   }
 };
 
 // src/audio/master-node.ts
 var MasterNode = class {
   constructor(audioContext) {
+    this._destination = null;
+    this._effectsInput = null;
     this._gainNode = audioContext.createGain();
   }
   get input() {
@@ -660,6 +684,37 @@ var MasterNode = class {
   get output() {
     return this._gainNode;
   }
+  /** Connect the master output to its final destination (audioContext.destination) */
+  connectOutput(destination) {
+    this._destination = destination;
+    this._gainNode.connect(destination);
+  }
+  /**
+   * Insert an effects chain between the master gain and the destination.
+   * Only the destination edge is severed (targeted disconnect), so parallel
+   * taps on the master output (analyzers, recorders) keep working.
+   * The caller is responsible for routing the chain's output onward.
+   */
+  connectEffects(effectsInput) {
+    if (this._effectsInput) {
+      this._gainNode.disconnect(this._effectsInput);
+    } else if (this._destination) {
+      this._gainNode.disconnect(this._destination);
+    }
+    this._gainNode.connect(effectsInput);
+    this._effectsInput = effectsInput;
+  }
+  /** Remove the effects chain and restore direct routing to the destination */
+  disconnectEffects() {
+    if (!this._effectsInput) {
+      return;
+    }
+    this._gainNode.disconnect(this._effectsInput);
+    if (this._destination) {
+      this._gainNode.connect(this._destination);
+    }
+    this._effectsInput = null;
+  }
   setVolume(value) {
     this._gainNode.gain.value = value;
   }
@@ -669,6 +724,8 @@ var MasterNode = class {
     } catch (err) {
       console.warn("[waveform-playlist] MasterNode.dispose: error disconnecting: " + String(err));
     }
+    this._destination = null;
+    this._effectsInput = null;
   }
 };
 
@@ -1319,6 +1376,7 @@ var _Transport = class _Transport {
       this._clipPlayer.onPositionJump(seekTick);
       this._timer.start();
     }
+    this._emit("seek", { seconds: time });
   }
   getCurrentTime() {
     if (this._countingIn) {
@@ -1489,12 +1547,22 @@ var _Transport = class _Transport {
     this._emit("loop");
   }
   // --- Tempo ---
+  /** Returns true when the tempo was applied, false when a defaulted (no
+   *  atTick) write was refused because the tempo map has multiple entries —
+   *  pass an explicit atTick to modify a multi-entry map (#407). */
   setTempo(bpm, atTick, options) {
+    if (atTick === void 0 && this._tempoMap.entryCount > 1) {
+      console.warn(
+        "[waveform-playlist] Transport.setTempo: refusing defaulted tick-0 write of " + bpm + " BPM \u2014 the tempo map has " + this._tempoMap.entryCount + " entries. Pass an explicit atTick to modify a multi-entry tempo map."
+      );
+      return false;
+    }
     this._tempoMap.setTempo(bpm, atTick, options);
     if (this._loopEnabled) {
       this._loopStartSeconds = this._tempoMap.ticksToSeconds(this._loopStartTick);
     }
     this._emit("tempochange", { bpm, atTick: atTick ?? 0 });
+    return true;
   }
   getTempo(atTick) {
     return this._tempoMap.getTempo(atTick);
@@ -1532,6 +1600,17 @@ var _Transport = class _Transport {
     }
     this._emit("tempochange", { bpm: this._tempoMap.getTempo(), atTick: 0 });
   }
+  /** Remove the tempo entry at exactly `atTick` (tick 0 is permanent — a
+   *  no-op, like removeMeter's initial entry). Mirrors setTempo's loop-cache
+   *  invalidation and event; the emitted bpm is the tempo now in force at
+   *  the removed position. */
+  removeTempo(atTick) {
+    this._tempoMap.removeTempo(atTick);
+    if (this._loopEnabled) {
+      this._loopStartSeconds = this._tempoMap.ticksToSeconds(this._loopStartTick);
+    }
+    this._emit("tempochange", { bpm: this._tempoMap.getTempo(atTick), atTick });
+  }
   barToTick(bar) {
     return this._meterMap.barToTick(bar);
   }
@@ -1607,6 +1686,20 @@ var _Transport = class _Transport {
   get masterOutputNode() {
     return this._masterNode.output;
   }
+  /**
+   * Insert an effects chain on the master bus, between the master gain and
+   * audioContext.destination. Accepts any AudioNode chain (Tone.js effects,
+   * WAM plugins, native nodes). The caller is responsible for connecting the
+   * chain's output to audioContext.destination. Calling again replaces the
+   * previous chain. Parallel taps on `masterOutputNode` are unaffected.
+   */
+  connectMasterOutput(node) {
+    this._masterNode.connectEffects(node);
+  }
+  /** Remove the master effects chain and restore direct routing to audioContext.destination. */
+  disconnectMasterOutput() {
+    this._masterNode.disconnectEffects();
+  }
   // --- Events ---
   on(event, cb) {
     if (!this._listeners.has(event)) {
@@ -1660,7 +1753,7 @@ var _Transport = class _Transport {
   }
   _initAudioGraph(audioContext) {
     this._masterNode = new MasterNode(audioContext);
-    this._masterNode.output.connect(audioContext.destination);
+    this._masterNode.connectOutput(audioContext.destination);
     const toAudioTime = (transportTime) => this._clock.toAudioTime(transportTime);
     this._clipPlayer = new ClipPlayer(
       audioContext,
@@ -1904,7 +1997,7 @@ var NativePlayoutAdapter = class {
     return this._transport.isCountingIn();
   }
   setTempo(bpm, atTick) {
-    this._transport.setTempo(bpm, atTick !== void 0 ? atTick : void 0);
+    return this._transport.setTempo(bpm, atTick !== void 0 ? atTick : void 0);
   }
   setMeter(numerator, denominator, atTick) {
     this._transport.setMeter(