avbridge 2.12.1 → 2.13.0

package/dist/element-browser.js

@@ -32255,22 +32255,25 @@ async function createRemuxPipeline(ctx, video) {
       }
     }
     let mimePromise = null;
+    const myToken = pumpToken;
     const writable = new WritableStream({
       write: async (chunk) => {
-        if (destroyed) return;
+        if (destroyed || pumpToken !== myToken) return;
         if (!sink) {
           const mime = await (mimePromise ??= output.getMimeType());
+          if (destroyed || pumpToken !== myToken) return;
           sink = new MseSink({ mime, video });
           await sink.ready();
+          if (destroyed || pumpToken !== myToken) return;
           if (pendingStartTime > 0) {
             sink.invalidate(pendingStartTime);
           }
           sink.setPlayOnSeek(pendingAutoPlay);
         }
-        while (sink && !destroyed && (sink.queueLength() > 10 || sink.bufferedAhead() > 60 || sink.totalBuffered() > 120)) {
+        while (sink && !destroyed && pumpToken === myToken && (sink.queueLength() > 10 || sink.bufferedAhead() > 60 || sink.totalBuffered() > 120)) {
           await new Promise((r) => setTimeout(r, 500));
         }
-        if (destroyed) return;
+        if (destroyed || pumpToken !== myToken) return;
         sink.append(chunk.data);
         stats.bytesWritten += chunk.data.byteLength;
         stats.fragments++;
@@ -32538,7 +32541,21 @@ var VideoRenderer = class {
   framesPainted = 0;
   framesDroppedLate = 0;
   framesDroppedOverflow = 0;
+  /** True once the head frame has been painted as a pre-roll poster
+   *  since the last flush. Used to ensure pre-roll paints exactly one
+   *  frame (held static) during the post-seek discard window. */
   prerolled = false;
+  /** PTS (µs) of the most recently painted frame. Used as the calibration
+   *  reference on the first post-flush snap: the pre-roll path paints one
+   *  frame *before* PTS-based playback starts, so the queue head's PTS at
+   *  first PTS-based paint is the *next* frame, off by one frameDur from
+   *  the actually-displayed frame. Calibrating against the painted frame
+   *  instead of the queue head removes that one-frame offset and yields
+   *  calib ≈ 0 instead of +frameDur. */
+  lastPaintedPtsUs = 0;
+  hasLastPaintedPts = false;
+  /** Audio-clock reading (ms) at the previous paint, for overlay Δaud. */
+  lastPaintAudMs = 0;
   /** Wall-clock time of the last paint, in ms (performance.now()). */
   lastPaintWall = 0;
   /** Minimum ms between paints — paces video at roughly source fps. */
@@ -32588,13 +32605,17 @@ var VideoRenderer = class {
     return this.queue.length;
   }
   /**
-   * Soft cap for decoder backpressure. The decoder pump throttles when
-   * `queueDepth() >= queueHighWater`. Set high enough that normal decode
-   * bursts don't trigger the renderer's overflow-drop loop (which runs at
-   * every paint), but low enough that the decoder doesn't run unboundedly
-   * ahead. The hard cap in `enqueue()` is 64.
+   * Cap the decoder may fill the queue up to. Used by the decoder's
+   * enqueue-side discard logic (it closes new frames instead of pushing
+   * them when this is reached). Sized so a long post-seek catch-up
+   * fits — the decoder produces frames at PTS T_kf onwards rapidly
+   * while the demuxer is chewing through pre-target audio; if the
+   * queue can hold the whole post-seek burst, the renderer plays
+   * smoothly from pre-roll without a frozen-video gap when audio.start
+   * fires. At ~340 KB per SD frame the cap is ~85 MB peak; at HD it's
+   * larger but still bounded.
    */
-  queueHighWater = 30;
+  queueHighWater = 256;
   enqueue(frame) {
     if (this.destroyed) {
       frame.close();
@@ -32605,7 +32626,7 @@ var VideoRenderer = class {
     if (this.queue.length === 1 && this.framesPainted === 0) {
       this.resolveFirstFrame();
     }
-    while (this.queue.length > 60) {
+    while (this.queue.length > this.queueHighWater + 8) {
       this.queue.shift()?.close();
       this.framesDroppedOverflow++;
     }
@@ -32687,12 +32708,9 @@ var VideoRenderer = class {
     if (this.queue.length === 0) return;
     const playing = this.clock.isPlaying();
     if (!playing) {
-      if (!this.prerolled) {
-        const head = this.queue.shift();
-        this.paint(head);
-        head.close();
+      if (!this.prerolled && this.queue.length > 0) {
         this.prerolled = true;
-        this.lastPaintWall = performance.now();
+        this.paint(this.queue[0]);
       }
       return;
     }
@@ -32701,14 +32719,29 @@ var VideoRenderer = class {
     const hasPts = headTs > 0 || this.queue.length > 1;
     if (hasPts) {
       const wallNow2 = performance.now();
-      if (!this.ptsCalibrated || wallNow2 - this.lastCalibrationWall > 1e4) {
-        this.ptsCalibrationUs = headTs - rawAudioNowUs;
+      if (!this.ptsCalibrated) {
+        const anchorUs = (this.clock.anchorTime?.() ?? this.clock.now()) * 1e6;
+        const referencePtsUs = this.hasLastPaintedPts ? this.lastPaintedPtsUs : headTs;
+        this.ptsCalibrationUs = referencePtsUs - anchorUs;
         this.ptsCalibrated = true;
         this.lastCalibrationWall = wallNow2;
+        if (isDebug()) {
+          console.log(
+            `[avbridge:renderer] CALIB-FIRST audioAnchor=${(anchorUs / 1e3).toFixed(1)}ms prerolledPTS=${this.hasLastPaintedPts ? (this.lastPaintedPtsUs / 1e3).toFixed(1) : "n/a"}ms queueHeadPTS=${(headTs / 1e3).toFixed(1)}ms rawAudioNow=${(rawAudioNowUs / 1e3).toFixed(1)}ms \u2192 calib=${(this.ptsCalibrationUs / 1e3).toFixed(1)}ms`
+          );
+        }
+      } else if (wallNow2 - this.lastCalibrationWall > 1e4) {
+        const oldCalib = this.ptsCalibrationUs;
+        this.ptsCalibrationUs = headTs - rawAudioNowUs;
+        this.lastCalibrationWall = wallNow2;
+        if (isDebug()) {
+          console.log(
+            `[avbridge:renderer] CALIB-RESNAP headPTS=${(headTs / 1e3).toFixed(1)}ms rawAudioNow=${(rawAudioNowUs / 1e3).toFixed(1)}ms calib ${(oldCalib / 1e3).toFixed(1)}ms \u2192 ${(this.ptsCalibrationUs / 1e3).toFixed(1)}ms (\u0394=${((this.ptsCalibrationUs - oldCalib) / 1e3).toFixed(1)}ms after 10s)`
+          );
+        }
       }
       const audioNowUs = rawAudioNowUs + this.ptsCalibrationUs;
-      const frameDurationUs = this.paintIntervalMs * 1e3;
-      const deadlineUs = audioNowUs + frameDurationUs;
+      const deadlineUs = audioNowUs;
       let bestIdx = -1;
       for (let i = 0; i < this.queue.length; i++) {
         const ts = this.queue[i].timestamp ?? 0;
@@ -32736,19 +32769,20 @@ var VideoRenderer = class {
         return;
       }
       const _relaxDrop = globalThis.AVBRIDGE_RELAX_DROP === true;
-      const dropThresholdUs = _relaxDrop ? audioNowUs - 60 * 1e6 : audioNowUs - frameDurationUs * 2;
       let dropped = 0;
-      while (bestIdx > 0) {
-        const ts = this.queue[0].timestamp ?? 0;
-        if (ts < dropThresholdUs) {
+      const initialBestIdx = bestIdx;
+      if (!_relaxDrop) {
+        while (bestIdx > 0) {
           this.queue.shift()?.close();
           this.framesDroppedLate++;
           bestIdx--;
           dropped++;
-        } else {
-          break;
         }
       }
+      const paintTs = this.queue[0]?.timestamp ?? 0;
+      if (isDebug()) {
+        console.log(`[TRACE] PAINT bestIdx_initial=${initialBestIdx} dropped=${dropped} paintPts=${(paintTs / 1e3).toFixed(1)}ms audioNow=${(audioNowUs / 1e3).toFixed(1)}ms deadline=${(deadlineUs / 1e3).toFixed(1)}ms queueLen=${this.queue.length} wall=${performance.now().toFixed(0)}`);
+      }
       this.ticksPainted++;
       if (isDebug()) {
         const now = performance.now();
@@ -32784,6 +32818,33 @@ var VideoRenderer = class {
     }
     try {
       this.ctx.drawImage(frame, 0, 0, this.canvas.width, this.canvas.height);
+      if (isDebug()) {
+        const wallNow = performance.now();
+        const audNowMs = this.clock.now() * 1e3;
+        const ptsMs = (frame.timestamp ?? 0) / 1e3;
+        const dWall = this.lastPaintWall > 0 ? wallNow - this.lastPaintWall : 0;
+        const dAud = this.lastPaintAudMs > 0 ? audNowMs - this.lastPaintAudMs : 0;
+        const dPts = this.hasLastPaintedPts ? ptsMs - this.lastPaintedPtsUs / 1e3 : 0;
+        this.ctx.save();
+        this.ctx.font = "bold 18px monospace";
+        const lines = [
+          `#${this.framesPainted + 1}  pts=${ptsMs.toFixed(0)}  aud=${audNowMs.toFixed(0)}  wall=${wallNow.toFixed(0)}`,
+          `\u0394pts=${dPts.toFixed(0)}  \u0394aud=${dAud.toFixed(0)}  \u0394wall=${dWall.toFixed(0)}`
+        ];
+        const lineHeight = 22;
+        const padTop = 6;
+        const stripH = padTop + lineHeight * lines.length;
+        this.ctx.fillStyle = "rgba(0,0,0,0.7)";
+        this.ctx.fillRect(0, 0, this.canvas.width, stripH);
+        this.ctx.fillStyle = "#0f0";
+        for (let i = 0; i < lines.length; i++) {
+          this.ctx.fillText(lines[i], 8, padTop + lineHeight * (i + 1) - 4);
+        }
+        this.ctx.restore();
+      }
+      this.lastPaintedPtsUs = frame.timestamp ?? 0;
+      this.hasLastPaintedPts = true;
+      this.lastPaintAudMs = this.clock.now() * 1e3;
       this.framesPainted++;
     } catch (err) {
       if (this.framesPainted === 0 && this.framesDroppedLate === 0) {
@@ -32796,6 +32857,7 @@ var VideoRenderer = class {
     const count = this.queue.length;
     while (this.queue.length > 0) this.queue.shift()?.close();
     this.prerolled = false;
+    this.hasLastPaintedPts = false;
     this.ptsCalibrated = false;
     this.hasEverEnqueuedSinceFlush = false;
     if (isDebug() && count > 0) {
@@ -32836,6 +32898,9 @@ var VideoRenderer = class {
 };
 
 // src/strategies/fallback/audio-output.ts
+function isDebug2() {
+  return typeof globalThis !== "undefined" && !!globalThis.AVBRIDGE_DEBUG;
+}
 var AudioOutput = class {
   ctx;
   gain;
@@ -32857,6 +32922,16 @@ var AudioOutput = class {
   mediaTimeOfNext = 0;
   /** Anchor: media time `mediaTimeOfAnchor` corresponds to ctx time `ctxTimeAtAnchor`. */
   mediaTimeOfAnchor = 0;
+  /**
+   * Ctx time at which the first audible chunk will start playing. `-1`
+   * before any chunk has been scheduled successfully (clock is frozen);
+   * the actual ctx time once one has. The renderer's `clock.now()` uses
+   * this to avoid advancing during the silent-gap window between
+   * `audio.start()` and the first chunk that schedules without being
+   * dropped — that gap is what produces the "audio-less fast-forward"
+   * the user sees post-seek when the gate releases on video-only grace.
+   */
+  firstAudibleCtxStart = -1;
   ctxTimeAtAnchor = 0;
   pendingQueue = [];
   framesScheduled = 0;
@@ -32929,10 +33004,16 @@ var AudioOutput = class {
       return this.mediaTimeOfAnchor;
     }
     if (this.state === "playing") {
+      if (this.firstAudibleCtxStart < 0) {
+        return this.mediaTimeOfAnchor;
+      }
       return this.mediaTimeOfAnchor + (this.ctx.currentTime - this.ctxTimeAtAnchor) * this._rate;
     }
     return this.mediaTimeOfAnchor;
   }
+  anchorTime() {
+    return this.mediaTimeOfAnchor;
+  }
   isPlaying() {
     return this.state === "playing";
   }
@@ -32959,18 +33040,81 @@ var AudioOutput = class {
    * Schedule a chunk of decoded samples. Queues internally while idle (cold
    * start or post-seek), schedules directly to the audio graph while playing.
    * In wall-clock mode, samples are silently discarded.
+   *
+   * `ptsSec` is the chunk's source-domain content PTS in seconds, from
+   * the demuxer. When provided, the chunk plays at the ctx-time
+   * corresponding to that PTS — so pre-target audio after a seek
+   * naturally drops (its computed `ctxStart` falls in the past) and
+   * post-target audio plays at its true content time, without any
+   * external trim or anchor rebase. When `ptsSec` is null (cold start
+   * with no PTS yet, or codecs whose packet→frame mapping isn't 1:1),
+   * the chunk is scheduled sequentially after `mediaTimeOfNext` — the
+   * pre-refactor behavior.
    */
-  schedule(samples, channels, sampleRate) {
+  schedule(samples, channels, sampleRate, ptsSec) {
     if (this.destroyed || this.noAudio) return;
     const frameCount = samples.length / channels;
     const durationSec = frameCount / sampleRate;
+    const hasPts = ptsSec != null && Number.isFinite(ptsSec);
+    if (hasPts && ptsSec + durationSec / this._rate < this.mediaTimeOfAnchor) {
+      return;
+    }
     if (this.state === "idle" || this.state === "paused") {
-      this.pendingQueue.push({ samples, channels, sampleRate, frameCount, durationSec });
+      this.pendingQueue.push({
+        samples,
+        channels,
+        sampleRate,
+        frameCount,
+        durationSec,
+        ptsSec: hasPts ? ptsSec : null
+      });
       return;
     }
-    this.scheduleNow(samples, channels, sampleRate, frameCount);
+    this.scheduleNow(
+      samples,
+      channels,
+      sampleRate,
+      frameCount,
+      hasPts ? ptsSec : null
+    );
   }
-  scheduleNow(samples, channels, sampleRate, frameCount) {
+  scheduleNow(samples, channels, sampleRate, frameCount, ptsSec) {
+    const durationSec = frameCount / sampleRate;
+    let ctxStart;
+    if (ptsSec != null) {
+      ctxStart = this.ctxTimeAtAnchor + (ptsSec - this.mediaTimeOfAnchor) / this._rate;
+      if (isDebug2()) {
+        console.log(`[TRACE-AUD] PTS sched #${this.framesScheduled} pts=${ptsSec.toFixed(3)} dur=${durationSec.toFixed(4)} ctxStart=${ctxStart.toFixed(4)} ctxNow=${this.ctx.currentTime.toFixed(4)} anchor=${this.mediaTimeOfAnchor.toFixed(3)} ctxAnchor=${this.ctxTimeAtAnchor.toFixed(4)} mtNext=${this.mediaTimeOfNext.toFixed(3)} rate=${this._rate}`);
+      }
+      if (ctxStart < this.ctx.currentTime - 1e-3) {
+        if (isDebug2()) {
+          console.log(`[TRACE-AUD] DROP late chunk pts=${ptsSec.toFixed(3)} ctxStart=${ctxStart.toFixed(4)} < ctxNow=${this.ctx.currentTime.toFixed(4)}`);
+        }
+        return;
+      }
+      if (this.firstAudibleCtxStart < 0) {
+        this.firstAudibleCtxStart = ctxStart;
+        this.mediaTimeOfAnchor = ptsSec;
+        this.ctxTimeAtAnchor = ctxStart;
+        if (isDebug2()) {
+          console.log(`[TRACE-AUD] UNFREEZE clock \u2014 first audible chunk pts=${ptsSec.toFixed(3)} ctxStart=${ctxStart.toFixed(4)} \u2192 anchor=${this.mediaTimeOfAnchor.toFixed(3)} ctxAnchor=${this.ctxTimeAtAnchor.toFixed(4)}`);
+        }
+      }
+      const endMediaTime = ptsSec + durationSec / this._rate;
+      if (endMediaTime > this.mediaTimeOfNext) {
+        this.mediaTimeOfNext = endMediaTime;
+      }
+    } else {
+      ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor) / this._rate;
+      console.warn(`[TRACE-AUD] LEGACY (no PTS) sched dur=${durationSec.toFixed(4)} ctxStart=${ctxStart.toFixed(4)} ctxNow=${this.ctx.currentTime.toFixed(4)}`);
+      if (ctxStart < this.ctx.currentTime) {
+        console.warn(`[TRACE-AUD] REBASE anchor was=${this.mediaTimeOfAnchor.toFixed(3)} ctxAnchor was=${this.ctxTimeAtAnchor.toFixed(4)} \u2192 anchor=${this.mediaTimeOfNext.toFixed(3)} ctxAnchor=${this.ctx.currentTime.toFixed(4)}`);
+        this.ctxTimeAtAnchor = this.ctx.currentTime;
+        this.mediaTimeOfAnchor = this.mediaTimeOfNext;
+        ctxStart = this.ctx.currentTime;
+      }
+      this.mediaTimeOfNext += durationSec;
+    }
     const buffer = this.ctx.createBuffer(channels, frameCount, sampleRate);
     for (let ch = 0; ch < channels; ch++) {
       const channelData = buffer.getChannelData(ch);
@@ -32982,14 +33126,7 @@ var AudioOutput = class {
     node3.buffer = buffer;
     node3.connect(this.gain);
     if (this._rate !== 1) node3.playbackRate.value = this._rate;
-    let ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor) / this._rate;
-    if (ctxStart < this.ctx.currentTime) {
-      this.ctxTimeAtAnchor = this.ctx.currentTime;
-      this.mediaTimeOfAnchor = this.mediaTimeOfNext;
-      ctxStart = this.ctx.currentTime;
-    }
     node3.start(ctxStart);
-    this.mediaTimeOfNext += frameCount / sampleRate;
     this.framesScheduled++;
   }
   // ── Lifecycle ─────────────────────────────────────────────────────────
@@ -33014,12 +33151,15 @@ var AudioOutput = class {
     } catch {
     }
     if (this.state === "paused") {
+      if (isDebug2()) {
+        console.log(`[TRACE-AUD] START(resume) anchor=${this.mediaTimeOfAnchor.toFixed(3)} ctxAnchor=${this.ctxTimeAtAnchor.toFixed(4)} \u2192 ctxAnchor=${this.ctx.currentTime.toFixed(4)} ctxNow=${this.ctx.currentTime.toFixed(4)} pendingCount=${this.pendingQueue.length}`);
+      }
       this.ctxTimeAtAnchor = this.ctx.currentTime;
       this.state = "playing";
       const drain2 = this.pendingQueue;
       this.pendingQueue = [];
       for (const c of drain2) {
-        this.scheduleNow(c.samples, c.channels, c.sampleRate, c.frameCount);
+        this.scheduleNow(c.samples, c.channels, c.sampleRate, c.frameCount, c.ptsSec);
       }
       return;
     }
@@ -33027,10 +33167,13 @@ var AudioOutput = class {
     this.ctxTimeAtAnchor = this.ctx.currentTime + STARTUP_DELAY;
     this.mediaTimeOfNext = this.mediaTimeOfAnchor;
     this.state = "playing";
+    if (isDebug2()) {
+      console.log(`[TRACE-AUD] START(cold) anchor=${this.mediaTimeOfAnchor.toFixed(3)} ctxAnchor=${this.ctxTimeAtAnchor.toFixed(4)} mtNext=${this.mediaTimeOfNext.toFixed(3)} ctxNow=${this.ctx.currentTime.toFixed(4)} pendingCount=${this.pendingQueue.length}`);
+    }
     const drain = this.pendingQueue;
     this.pendingQueue = [];
     for (const c of drain) {
-      this.scheduleNow(c.samples, c.channels, c.sampleRate, c.frameCount);
+      this.scheduleNow(c.samples, c.channels, c.sampleRate, c.frameCount, c.ptsSec);
     }
   }
   /** Pause playback. Suspends the audio context. */
@@ -33056,6 +33199,9 @@ var AudioOutput = class {
    * supplying new samples) and then call `start()` to resume playback.
    */
   async reset(newMediaTime) {
+    if (isDebug2()) {
+      console.log(`[TRACE-AUD] RESET to=${newMediaTime.toFixed(3)} prev_anchor=${this.mediaTimeOfAnchor.toFixed(3)} prev_mtNext=${this.mediaTimeOfNext.toFixed(3)} prev_ctxAnchor=${this.ctxTimeAtAnchor.toFixed(4)} ctxNow=${this.ctx.currentTime.toFixed(4)} state=${this.state}`);
+    }
     if (this.noAudio) {
       this.pendingQueue = [];
       this.mediaTimeOfAnchor = newMediaTime;
@@ -33074,6 +33220,7 @@ var AudioOutput = class {
     this.mediaTimeOfAnchor = newMediaTime;
     this.mediaTimeOfNext = newMediaTime;
     this.ctxTimeAtAnchor = this.ctx.currentTime;
+    this.firstAudibleCtxStart = -1;
     this.state = "idle";
     if (this.ctx.state === "running") {
       await this.ctx.suspend();
@@ -33257,28 +33404,6 @@ function asUint8(x) {
   const ta = x;
   return new Uint8Array(ta.buffer, ta.byteOffset, ta.byteLength);
 }
-function sanitizeFrameTimestamp(frame, nextUs, fallbackTimeBase) {
-  const lo = frame.pts ?? 0;
-  const hi = frame.ptshi ?? 0;
-  const isInvalid = hi === -2147483648 && lo === 0 || !Number.isFinite(lo);
-  if (isInvalid) {
-    const us2 = nextUs();
-    frame.pts = us2;
-    frame.ptshi = 0;
-    return;
-  }
-  const tb = fallbackTimeBase ?? [1, 1e6];
-  const pts64 = hi * 4294967296 + lo;
-  const us = Math.round(pts64 * 1e6 * tb[0] / tb[1]);
-  if (Number.isFinite(us) && Math.abs(us) <= Number.MAX_SAFE_INTEGER) {
-    frame.pts = us;
-    frame.ptshi = us < 0 ? -1 : 0;
-    return;
-  }
-  const fallback = nextUs();
-  frame.pts = fallback;
-  frame.ptshi = 0;
-}
 
 // src/strategies/hybrid/decoder.ts
 async function startHybridDecoder(opts) {
@@ -33426,7 +33551,6 @@ async function startHybridDecoder(opts) {
   let videoChunksFed = 0;
   let bufferedUntilSec = 0;
   let syntheticVideoUs = 0;
-  let syntheticAudioUs = 0;
   const videoTrackInfo = opts.context.videoTracks.find((t) => t.id === videoStream?.index);
   const videoFps = videoTrackInfo?.fps && videoTrackInfo.fps > 0 ? videoTrackInfo.fps : 30;
   const videoFrameStepUs = Math.max(1, Math.round(1e6 / videoFps));
@@ -33458,7 +33582,13 @@ async function startHybridDecoder(opts) {
         }
       }
       if (audioDec && audioPackets && audioPackets.length > 0) {
-        await decodeAudioBatch(audioPackets, myToken);
+        await decodeAudioBatch(
+          audioPackets,
+          myToken,
+          /*flush*/
+          false,
+          audioTimeBase
+        );
       }
       if (myToken !== pumpToken || destroyed) return;
       await new Promise((r) => setTimeout(r, 0));
@@ -33505,8 +33635,11 @@ async function startHybridDecoder(opts) {
       }
     }
   }
-  async function decodeAudioBatch(pkts, myToken, flush = false) {
+  async function decodeAudioBatch(pkts, myToken, flush = false, tb) {
     if (!audioDec || destroyed || myToken !== pumpToken) return;
+    const pktPtsSec = pkts.map(
+      (p) => tb ? packetPtsSec(p, tb) : null
+    );
     const AUDIO_SUB_BATCH = 4;
     let allFrames = [];
     for (let i = 0; i < pkts.length; i += AUDIO_SUB_BATCH) {
@@ -33544,22 +33677,13 @@ async function startHybridDecoder(opts) {
     }
     if (myToken !== pumpToken || destroyed) return;
     const frames = allFrames;
-    for (const f of frames) {
+    for (let i = 0; i < frames.length; i++) {
       if (myToken !== pumpToken || destroyed) return;
-      sanitizeFrameTimestamp(
-        f,
-        () => {
-          const ts = syntheticAudioUs;
-          const samples2 = f.nb_samples ?? 1024;
-          const sampleRate = f.sample_rate ?? 44100;
-          syntheticAudioUs += Math.round(samples2 * 1e6 / sampleRate);
-          return ts;
-        },
-        audioTimeBase
-      );
+      const f = frames[i];
       const samples = libavFrameToInterleavedFloat32(f);
       if (samples) {
-        opts.audio.schedule(samples.data, samples.channels, samples.sampleRate);
+        const pts = pktPtsSec[i] ?? null;
+        opts.audio.schedule(samples.data, samples.channels, samples.sampleRate, pts);
         audioFramesDecoded++;
       }
     }
@@ -33669,7 +33793,6 @@ async function startHybridDecoder(opts) {
       }
       await flushBSF();
       syntheticVideoUs = Math.round(timeSec * 1e6);
-      syntheticAudioUs = Math.round(timeSec * 1e6);
       pumpRunning = pumpLoop(newToken).catch(
         (err) => console.error("[avbridge] hybrid pump failed (post-setAudioTrack):", err)
       );
@@ -33708,7 +33831,6 @@ async function startHybridDecoder(opts) {
       }
       await flushBSF();
       syntheticVideoUs = Math.round(timeSec * 1e6);
-      syntheticAudioUs = Math.round(timeSec * 1e6);
       pumpRunning = pumpLoop(newToken).catch(
         (err) => console.error("[avbridge] hybrid pump failed (post-seek):", err)
       );
@@ -33963,6 +34085,9 @@ async function createHybridSession(ctx, target, transport) {
 // src/strategies/fallback/decoder.ts
 init_libav_loader();
 init_debug();
+function isDebug3() {
+  return typeof globalThis !== "undefined" && !!globalThis.AVBRIDGE_DEBUG;
+}
 async function startDecoder(opts) {
   const variant = "avbridge";
   const libav = await loadLibav(variant);
@@ -34094,8 +34219,15 @@ async function startDecoder(opts) {
   let watchdogSlowSinceMs = 0;
   let watchdogSlowWarned = false;
   let watchdogOverflowWarned = false;
-  let syntheticVideoUs = 0;
-  let syntheticAudioUs = 0;
+  let lastContentUs = -1;
+  let firstValidPtsLoggedSinceSeek = false;
+  let seenFirstAudioPacketSinceSeek = false;
+  let seekTargetSec = 0;
+  let diagPktsLoggedSinceSeek = 0;
+  let diagFramesLoggedSinceSeek = 0;
+  let diagFrameKeysDumped = false;
+  const DIAG_MAX_PKTS = 100;
+  const DIAG_MAX_FRAMES = 300;
   let videoDecodeMsTotal = 0;
   let audioDecodeMsTotal = 0;
   let videoDecodeBatches = 0;
@@ -34134,6 +34266,18 @@ async function startDecoder(opts) {
         for (const pkt of videoPackets) {
           const sec = packetPtsSec(pkt, videoTimeBase);
           if (sec != null && sec > bufferedUntilSec) bufferedUntilSec = sec;
+          if (isDebug3() && diagPktsLoggedSinceSeek < DIAG_MAX_PKTS) {
+            const rawHi = pkt.ptshi ?? 0;
+            const rawLo = pkt.pts ?? 0;
+            const isInvalidPts = rawHi === -2147483648 && rawLo === 0;
+            const rawPts64 = isInvalidPts ? null : rawHi * 4294967296 + rawLo;
+            const rawSec = rawPts64 != null && videoTimeBase ? rawPts64 * videoTimeBase[0] / videoTimeBase[1] : null;
+            const pktKeys = diagPktsLoggedSinceSeek === 0 ? `[keys: ${Object.keys(pkt).join(",")}]` : "";
+            console.log(
+              `[DIAG-PKT] vidx=${diagPktsLoggedSinceSeek} pts=${isInvalidPts ? "NOPTS" : rawPts64} pts_sec=${rawSec != null ? rawSec.toFixed(3) : "n/a"} ptshi=${rawHi} ptslo=${rawLo} flags=0x${(pkt.flags ?? 0).toString(16)} keyframe=${(pkt.flags ?? 0) & 1 ? "Y" : "N"} stream=${pkt.stream_index} dataLen=${pkt.data?.length ?? 0} seekTarget=${seekTargetSec.toFixed(3)} ` + pktKeys
+            );
+            diagPktsLoggedSinceSeek++;
+          }
         }
       }
       if (audioPackets && audioTimeBase) {
@@ -34141,9 +34285,25 @@ async function startDecoder(opts) {
           const sec = packetPtsSec(pkt, audioTimeBase);
           if (sec != null && sec > bufferedUntilSec) bufferedUntilSec = sec;
         }
+        if (!seenFirstAudioPacketSinceSeek && audioPackets.length > 0) {
+          const firstSec = packetPtsSec(audioPackets[0], audioTimeBase);
+          if (firstSec != null && Number.isFinite(firstSec)) {
+            seenFirstAudioPacketSinceSeek = true;
+            dbg.info(
+              "av-anchor",
+              `seek-target=${seekTargetSec.toFixed(3)}s, first-audio-pkt-pts=${firstSec.toFixed(3)}s (\u0394=${((firstSec - seekTargetSec) * 1e3).toFixed(1)}ms \u2014 pre-target packets will be skipped by AudioOutput)`
+            );
+          }
+        }
       }
       if (audioDec && audioPackets && audioPackets.length > 0) {
-        await decodeAudioBatch(audioPackets, myToken);
+        await decodeAudioBatch(
+          audioPackets,
+          myToken,
+          /*flush*/
+          false,
+          audioTimeBase
+        );
       }
       if (myToken !== pumpToken || destroyed) return;
       if (videoDec && videoPackets && videoPackets.length > 0) {
@@ -34187,7 +34347,7 @@ async function startDecoder(opts) {
       {
         const _throttleStart = performance.now();
         let _throttled = false;
-        while (!destroyed && myToken === pumpToken && (opts.audio.bufferAhead() > 2 || opts.renderer.queueDepth() >= opts.renderer.queueHighWater)) {
+        while (!destroyed && myToken === pumpToken && opts.audio.bufferAhead() > 2) {
           _throttled = true;
           await new Promise((r) => setTimeout(r, 50));
         }
@@ -34242,18 +34402,83 @@ async function startDecoder(opts) {
     if (myToken !== pumpToken || destroyed) return;
     for (const f of frames) {
       if (myToken !== pumpToken || destroyed) return;
-      sanitizeFrameTimestamp(
-        f,
-        () => {
-          const base = lastEmittedPtsUs >= 0 ? lastEmittedPtsUs + videoFrameStepUs : syntheticVideoUs;
-          syntheticVideoUs = base + videoFrameStepUs;
-          return base;
-        },
-        videoTimeBase
-      );
-      const _fPts = (f.ptshi ?? 0) * 4294967296 + (f.pts ?? 0);
+      const _diagShouldLog = isDebug3() && diagFramesLoggedSinceSeek < DIAG_MAX_FRAMES;
+      const _diagRawHi = f.ptshi ?? 0;
+      const _diagRawLo = f.pts ?? 0;
+      const _diagInvalid = _diagRawHi === -2147483648 && _diagRawLo === 0;
+      const _diagRawPts64 = _diagInvalid ? null : _diagRawHi * 4294967296 + _diagRawLo;
+      const _diagRawSec = _diagRawPts64 != null && videoTimeBase ? _diagRawPts64 * videoTimeBase[0] / videoTimeBase[1] : null;
+      if (_diagShouldLog && !diagFrameKeysDumped) {
+        diagFrameKeysDumped = true;
+        const allKeys = Object.keys(f);
+        const fieldDump = {};
+        for (const k of allKeys) {
+          const v = f[k];
+          if (k === "data") continue;
+          if (typeof v === "object" && v !== null && "length" in v) continue;
+          fieldDump[k] = v;
+        }
+        console.log(`[DIAG-FRAME] FIRST FRAME post-seek \u2014 all keys: ${allKeys.join(",")}`);
+        console.log(`[DIAG-FRAME] FIRST FRAME field dump:`, fieldDump);
+      }
+      let rawUs = null;
+      if (!_diagInvalid && _diagRawPts64 != null) {
+        const tb = videoTimeBase ?? [1, 1e6];
+        const us = Math.round(_diagRawPts64 * 1e6 * tb[0] / tb[1]);
+        if (Number.isFinite(us) && Math.abs(us) <= Number.MAX_SAFE_INTEGER) {
+          rawUs = us;
+        }
+      }
+      const _diagLog = (decision, finalPtsUs, sanFallback) => {
+        if (!_diagShouldLog) return;
+        const ptsSrc = sanFallback ? `SYNTHETIC(${_diagInvalid ? "NOPTS" : "invalid-range"})` : "LIBAV";
+        console.log(
+          `[DIAG-FRAME] vidx=${diagFramesLoggedSinceSeek} raw_pts=${_diagInvalid ? "NOPTS" : _diagRawPts64} raw_pts_sec=${_diagRawSec != null ? _diagRawSec.toFixed(3) : "n/a"} pts_src=${ptsSrc} final_pts_us=${finalPtsUs} final_pts_sec=${(finalPtsUs / 1e6).toFixed(3)} seekTarget=${seekTargetSec.toFixed(3)} offset_to_target_ms=${(finalPtsUs / 1e3 - seekTargetSec * 1e3).toFixed(1)} lastEmittedPts_us=${lastEmittedPtsUs} decision=${decision}`
+        );
+        diagFramesLoggedSinceSeek++;
+      };
+      let _diagSanFallbackFired = false;
+      const seekTargetUs = Math.round(seekTargetSec * 1e6);
+      if (lastContentUs < 0) {
+        if (rawUs == null) {
+          const isColdStartKeyframe = seekTargetSec === 0 && f.key_frame === 1;
+          if (isColdStartKeyframe) {
+            lastContentUs = 0;
+            _diagSanFallbackFired = true;
+          } else {
+            _diagLog("PRE-ANCHOR-DROP", 0, true);
+            continue;
+          }
+        } else {
+          lastContentUs = rawUs;
+          if (!firstValidPtsLoggedSinceSeek) {
+            firstValidPtsLoggedSinceSeek = true;
+            if (isDebug3()) {
+              console.log(
+                `[avbridge:decoder] post-seek anchor established: first valid raw pts = ${(rawUs / 1e3).toFixed(1)}ms (seekTarget = ${(seekTargetSec * 1e3).toFixed(1)}ms, \u0394 = ${((rawUs - seekTargetUs) / 1e3).toFixed(1)}ms)`
+              );
+            }
+            if (rawUs >= seekTargetUs) {
+              console.warn(
+                `[avbridge:decoder] first valid raw pts \u2265 seek target \u2014 pre-anchor NOPTS frames may have straddled the target and been mis-discarded. First painted frame may be late by up to one keyframe interval.`
+              );
+            }
+          }
+        }
+      } else {
+        if (rawUs != null) {
+          lastContentUs = rawUs;
+        } else {
+          lastContentUs += videoFrameStepUs;
+          _diagSanFallbackFired = true;
+        }
+      }
+      f.pts = lastContentUs;
+      f.ptshi = lastContentUs < 0 ? -1 : 0;
+      const _fPts = lastContentUs;
       if (_fPts > newestVideoPtsUs) newestVideoPtsUs = _fPts;
       if (lastEmittedPtsUs >= 0 && _fPts < lastEmittedPtsUs) {
+        _diagLog("REGRESSED-DROP", _fPts, _diagSanFallbackFired);
         ptsRegressions++;
         const regressMs = (lastEmittedPtsUs - _fPts) / 1e3;
         if (regressMs > worstPtsRegressionMs) worstPtsRegressionMs = regressMs;
@@ -34265,19 +34490,34 @@ async function startDecoder(opts) {
         continue;
       }
       lastEmittedPtsUs = _fPts;
+      const targetUs = Math.round(seekTargetSec * 1e6);
+      if (_fPts < targetUs - videoFrameStepUs) {
+        _diagLog("PRE-TARGET-DROP", _fPts, _diagSanFallbackFired);
+        continue;
+      }
       try {
         const vf = bridge.laFrameToVideoFrame(f, { timeBase: [1, 1e6] });
-        opts.renderer.enqueue(vf);
+        if (opts.renderer.queueDepth() >= opts.renderer.queueHighWater) {
+          vf.close();
+          _diagLog("OVERFLOW-DROP", _fPts, _diagSanFallbackFired);
+        } else {
+          opts.renderer.enqueue(vf);
+          _diagLog("ENQUEUED", _fPts, _diagSanFallbackFired);
+        }
         videoFramesDecoded++;
       } catch (err) {
         if (videoFramesDecoded === 0) {
           console.warn("[avbridge] laFrameToVideoFrame failed:", err);
         }
+        _diagLog("BRIDGE-ERROR", _fPts, _diagSanFallbackFired);
       }
     }
   }
-  async function decodeAudioBatch(pkts, myToken, flush = false) {
+  async function decodeAudioBatch(pkts, myToken, flush = false, tb) {
     if (!audioDec || destroyed || myToken !== pumpToken) return;
+    const pktPtsSec = pkts.map(
+      (p) => tb ? packetPtsSec(p, tb) : null
+    );
     let frames;
     const _t0 = performance.now();
     try {
@@ -34295,22 +34535,17 @@ async function startDecoder(opts) {
     audioDecodeMsTotal += performance.now() - _t0;
     audioDecodeBatches++;
     if (myToken !== pumpToken || destroyed) return;
-    for (const f of frames) {
+    for (let i = 0; i < frames.length; i++) {
       if (myToken !== pumpToken || destroyed) return;
-      sanitizeFrameTimestamp(
-        f,
-        () => {
-          const ts = syntheticAudioUs;
-          const samples2 = f.nb_samples ?? 1024;
-          const sampleRate = f.sample_rate ?? 44100;
-          syntheticAudioUs += Math.round(samples2 * 1e6 / sampleRate);
-          return ts;
-        },
-        audioTimeBase
-      );
+      const f = frames[i];
       const samples = libavFrameToInterleavedFloat32(f);
       if (samples) {
-        opts.audio.schedule(samples.data, samples.channels, samples.sampleRate);
+        const pts = pktPtsSec[i] ?? null;
+        if (isDebug3()) {
+          const dur = samples.data.length / samples.channels / samples.sampleRate;
+          console.log(`[TRACE-DEC] audio frame #${audioFramesDecoded} pts=${pts != null ? pts.toFixed(4) : "NULL"} dur=${dur.toFixed(4)} samples=${samples.data.length / samples.channels} sr=${samples.sampleRate} ch=${samples.channels} pktsIn=${pkts.length} framesOut=${frames.length}`);
+        }
+        opts.audio.schedule(samples.data, samples.channels, samples.sampleRate, pts);
         audioFramesDecoded++;
       }
     }
@@ -34413,14 +34648,17 @@ async function startDecoder(opts) {
       } catch {
       }
       await flushBSF();
-      syntheticVideoUs = Math.round(timeSec * 1e6);
-      syntheticAudioUs = Math.round(timeSec * 1e6);
+      lastContentUs = -1;
       lastEmittedPtsUs = -1;
+      firstValidPtsLoggedSinceSeek = false;
       pumpRunning = pumpLoop(newToken).catch(
         (err) => console.error("[avbridge] fallback pump failed (post-setAudioTrack):", err)
       );
     },
     async seek(timeSec) {
+      if (isDebug3()) {
+        console.log(`[SEEK] target=${timeSec.toFixed(3)}s (${(timeSec * 1e3).toFixed(0)}ms) wall=${performance.now().toFixed(0)}`);
+      }
       const newToken = ++pumpToken;
       if (pumpRunning) {
         try {
@@ -34451,9 +34689,14 @@ async function startDecoder(opts) {
       } catch {
       }
       await flushBSF();
-      syntheticVideoUs = Math.round(timeSec * 1e6);
-      syntheticAudioUs = Math.round(timeSec * 1e6);
+      lastContentUs = -1;
       lastEmittedPtsUs = -1;
+      firstValidPtsLoggedSinceSeek = false;
+      seenFirstAudioPacketSinceSeek = false;
+      seekTargetSec = timeSec;
+      diagPktsLoggedSinceSeek = 0;
+      diagFramesLoggedSinceSeek = 0;
+      diagFrameKeysDumped = false;
       pumpRunning = pumpLoop(newToken).catch(
         (err) => console.error("[avbridge] decoder pump failed (post-seek):", err)
       );