@dawcore/components 0.0.21 → 0.0.23

package/dist/index.d.mts

@@ -961,10 +961,17 @@ declare class DawEditorElement extends LitElement implements MidiLoaderHost {
     set ppqn(value: number);
     private _ppqn;
     snapTo: SnapTo;
-    /** Optional tempo-aware conversion: seconds → PPQN ticks. When provided, enables variable tempo. */
+    /** Optional tempo-aware conversion: seconds → PPQN ticks. When provided
+     *  together with ticksToSeconds, enables variable tempo AND makes `bpm`
+     *  display/grid-only (no engine/adapter tempo forwarding — #407). */
     secondsToTicks?: (seconds: number) => number;
-    /** Optional tempo-aware conversion: PPQN ticks → seconds. Required alongside secondsToTicks. */
+    /** Optional tempo-aware conversion: PPQN ticks → seconds. Required alongside
+     *  secondsToTicks — see that property for the variable-tempo and bpm
+     *  display-only semantics enabled when both are set (#407). */
     ticksToSeconds?: (ticks: number) => number;
+    /** True when the consumer provided BOTH tick conversion callbacks — the
+     *  external tempo map is authoritative and `bpm` is display/grid-only (#407). */
+    get _hasTickCallbacks(): boolean;
     /** Sample rate — reads from adapter's AudioContext when available, otherwise falls back to 48000. */
     get sampleRate(): number;
     /** Resolved sample rate — falls back to sampleRate property until first audio decode. */

package/dist/index.d.ts

@@ -961,10 +961,17 @@ declare class DawEditorElement extends LitElement implements MidiLoaderHost {
     set ppqn(value: number);
     private _ppqn;
     snapTo: SnapTo;
-    /** Optional tempo-aware conversion: seconds → PPQN ticks. When provided, enables variable tempo. */
+    /** Optional tempo-aware conversion: seconds → PPQN ticks. When provided
+     *  together with ticksToSeconds, enables variable tempo AND makes `bpm`
+     *  display/grid-only (no engine/adapter tempo forwarding — #407). */
     secondsToTicks?: (seconds: number) => number;
-    /** Optional tempo-aware conversion: PPQN ticks → seconds. Required alongside secondsToTicks. */
+    /** Optional tempo-aware conversion: PPQN ticks → seconds. Required alongside
+     *  secondsToTicks — see that property for the variable-tempo and bpm
+     *  display-only semantics enabled when both are set (#407). */
     ticksToSeconds?: (ticks: number) => number;
+    /** True when the consumer provided BOTH tick conversion callbacks — the
+     *  external tempo map is authoritative and `bpm` is display/grid-only (#407). */
+    get _hasTickCallbacks(): boolean;
     /** Sample rate — reads from adapter's AudioContext when available, otherwise falls back to 48000. */
     get sampleRate(): number;
     /** Resolved sample rate — falls back to sampleRate property until first audio decode. */

package/dist/index.js

@@ -4652,7 +4652,7 @@ var DawEditorElement = class extends import_lit15.LitElement {
     const old = this._bpm;
     if (!Number.isFinite(value) || value <= 0) return;
     this._bpm = value;
-    if (this._engine) {
+    if (this._engine && !this._hasTickCallbacks) {
       this._engine.setTempo(value);
     }
     this.requestUpdate("bpm", old);
@@ -4671,6 +4671,11 @@ var DawEditorElement = class extends import_lit15.LitElement {
     this._ppqn = value;
     this.requestUpdate("ppqn", old);
   }
+  /** True when the consumer provided BOTH tick conversion callbacks — the
+   *  external tempo map is authoritative and `bpm` is display/grid-only (#407). */
+  get _hasTickCallbacks() {
+    return !!(this.secondsToTicks && this.ticksToSeconds);
+  }
   /** Sample rate — reads from adapter's AudioContext when available, otherwise falls back to 48000. */
   get sampleRate() {
     return this._resolvedSampleRate ?? this._externalAdapter?.audioContext.sampleRate ?? 48e3;
@@ -5556,12 +5561,14 @@ var DawEditorElement = class extends import_lit15.LitElement {
     }
     const { PlaylistEngine } = await import("@waveform-playlist/engine");
     const adapter = this._externalAdapter;
-    if (adapter.setTempo) {
-      adapter.setTempo(this._bpm);
-    } else if (this._bpm !== 120) {
-      console.warn(
-        "[dawcore] Adapter does not implement setTempo. Initial BPM " + this._bpm + " will not be applied \u2014 clips may use wrong tempo."
-      );
+    if (!this._hasTickCallbacks) {
+      if (adapter.setTempo) {
+        adapter.setTempo(this._bpm);
+      } else if (this._bpm !== 120) {
+        console.warn(
+          "[dawcore] Adapter does not implement setTempo. Initial BPM " + this._bpm + " will not be applied \u2014 clips may use wrong tempo."
+        );
+      }
     }
     adapter.setPpqn?.(this._ppqn);
     this.ppqn = adapter.ppqn;
@@ -6097,12 +6104,7 @@ var DawEditorElement = class extends import_lit15.LitElement {
     const playhead = this._getPlayhead();
     if (!playhead || !this._engine) return;
     const engine = this._engine;
-    const ctx = this.audioContext;
-    const audibleTime = () => {
-      const outputLatency = "outputLatency" in ctx ? ctx.outputLatency : 0;
-      const t = engine.getCurrentTime() - outputLatency - engine.lookAhead;
-      return Number.isFinite(t) ? Math.max(0, t) : 0;
-    };
+    const audibleTime = () => engine.getAudibleTime();
     if (this.scaleMode === "beats") {
       const secondsToTicksFn = (s) => this._secondsToTicks(s);
       playhead.startBeatsAnimationWithMap(audibleTime, secondsToTicksFn, this.ticksPerPixel);
@@ -6113,10 +6115,7 @@ var DawEditorElement = class extends import_lit15.LitElement {
   _stopPlayhead() {
     const playhead = this._getPlayhead();
     if (!playhead) return;
-    const ctx = this.audioContext;
-    const outputLatency = "outputLatency" in ctx ? ctx.outputLatency : 0;
-    const lookAhead = this._engine?.lookAhead ?? 0;
-    const t = this._currentTime - outputLatency - lookAhead;
+    const t = this._currentTime;
     const visualTime = Number.isFinite(t) ? Math.max(0, t) : 0;
     if (this.scaleMode === "beats") {
       playhead.stopBeatsAnimationWithMap(