avbridge 2.2.0 → 2.2.1

package/dist/element-browser.js

@@ -31978,6 +31978,10 @@ async function createRemuxPipeline(ctx, video) {
         console.error("[avbridge] remux pipeline reseek failed:", err);
       });
     },
+    setAutoPlay(autoPlay) {
+      pendingAutoPlay = autoPlay;
+      if (sink) sink.setPlayOnSeek(autoPlay);
+    },
     async destroy() {
       destroyed = true;
       pumpToken++;
@@ -32018,7 +32022,11 @@ async function createRemuxSession(context, video) {
         await pipeline.start(video.currentTime || 0, true);
         return;
       }
-      await video.play();
+      pipeline.setAutoPlay(true);
+      try {
+        await video.play();
+      } catch {
+      }
     },
     pause() {
       wantPlay = false;
@@ -32066,7 +32074,7 @@ var VideoRenderer = class {
       this.resolveFirstFrame = resolve;
     });
     this.canvas = document.createElement("canvas");
-    this.canvas.style.cssText = "position:absolute;left:0;top:0;width:100%;height:100%;background:black;";
+    this.canvas.style.cssText = "position:absolute;left:0;top:0;width:100%;height:100%;background:black;object-fit:contain;";
     const parent = target.parentElement ?? target.parentNode;
     if (parent && parent instanceof HTMLElement) {
       if (getComputedStyle(parent).position === "static") {
@@ -32308,9 +32316,13 @@ var AudioOutput = class {
     const node3 = this.ctx.createBufferSource();
     node3.buffer = buffer;
     node3.connect(this.gain);
-    const ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor);
-    const safeStart = Math.max(ctxStart, this.ctx.currentTime);
-    node3.start(safeStart);
+    let ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor);
+    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++;
   }
@@ -32905,6 +32917,10 @@ async function createHybridSession(ctx, target) {
       void doSeek(v);
     }
   });
+  Object.defineProperty(target, "paused", {
+    configurable: true,
+    get: () => !audio.isPlaying()
+  });
   if (ctx.duration && Number.isFinite(ctx.duration)) {
     Object.defineProperty(target, "duration", {
       configurable: true,
@@ -32969,6 +32985,7 @@ async function createHybridSession(ctx, target) {
       try {
         delete target.currentTime;
         delete target.duration;
+        delete target.paused;
       } catch {
       }
     },
@@ -33049,7 +33066,8 @@ async function startDecoder(opts) {
   let audioFramesDecoded = 0;
   let watchdogFirstFrameMs = 0;
   let watchdogSlowSinceMs = 0;
-  let watchdogWarned = false;
+  let watchdogSlowWarned = false;
+  let watchdogOverflowWarned = false;
   let syntheticVideoUs = 0;
   let syntheticAudioUs = 0;
   const videoTrackInfo = opts.context.videoTracks.find((t) => t.id === videoStream?.index);
@@ -33061,7 +33079,7 @@ async function startDecoder(opts) {
       let packets;
       try {
         [readErr, packets] = await libav.ff_read_frame_multi(fmt_ctx, readPkt, {
-          limit: 64 * 1024
+          limit: 16 * 1024
         });
       } catch (err) {
         console.error("[avbridge] ff_read_frame_multi failed:", err);
@@ -33070,26 +33088,26 @@ async function startDecoder(opts) {
       if (myToken !== pumpToken || destroyed) return;
       const videoPackets = videoStream ? packets[videoStream.index] : void 0;
       const audioPackets = audioStream ? packets[audioStream.index] : void 0;
-      if (videoDec && videoPackets && videoPackets.length > 0) {
-        await decodeVideoBatch(videoPackets, myToken);
-      }
-      if (myToken !== pumpToken || destroyed) return;
       if (audioDec && audioPackets && audioPackets.length > 0) {
         await decodeAudioBatch(audioPackets, myToken);
       }
+      if (myToken !== pumpToken || destroyed) return;
+      if (videoDec && videoPackets && videoPackets.length > 0) {
+        await decodeVideoBatch(videoPackets, myToken);
+      }
       packetsRead += (videoPackets?.length ?? 0) + (audioPackets?.length ?? 0);
       if (videoFramesDecoded > 0) {
         if (watchdogFirstFrameMs === 0) {
           watchdogFirstFrameMs = performance.now();
         }
         const elapsedSinceFirst = (performance.now() - watchdogFirstFrameMs) / 1e3;
-        if (elapsedSinceFirst > 1 && !watchdogWarned) {
+        if (elapsedSinceFirst > 1 && !watchdogSlowWarned) {
           const expectedFrames = elapsedSinceFirst * videoFps;
           const ratio = videoFramesDecoded / expectedFrames;
           if (ratio < 0.6) {
             if (watchdogSlowSinceMs === 0) watchdogSlowSinceMs = performance.now();
             if ((performance.now() - watchdogSlowSinceMs) / 1e3 > 5) {
-              watchdogWarned = true;
+              watchdogSlowWarned = true;
               console.warn(
                 "[avbridge:decode-rate]",
                 `decoder is running slower than realtime: ${videoFramesDecoded} frames in ${elapsedSinceFirst.toFixed(1)}s (${(videoFramesDecoded / elapsedSinceFirst).toFixed(1)} fps vs ${videoFps} fps source \u2014 ${(ratio * 100).toFixed(0)}% of realtime). Playback will stutter. Typical causes: software decode of a codec with no WebCodecs support (rv40, mpeg4 @ 720p+, wmv3), or a resolution too large for single-threaded WASM to keep up with.`
@@ -33099,6 +33117,17 @@ async function startDecoder(opts) {
             watchdogSlowSinceMs = 0;
           }
         }
+        if (!watchdogOverflowWarned && videoFramesDecoded > 100) {
+          const rendererStats = opts.renderer.stats();
+          const overflow = rendererStats.framesDroppedOverflow ?? 0;
+          if (overflow / videoFramesDecoded > 0.1) {
+            watchdogOverflowWarned = true;
+            console.warn(
+              "[avbridge:overflow-drop]",
+              `renderer is dropping ${overflow}/${videoFramesDecoded} frames (${(overflow / videoFramesDecoded * 100).toFixed(0)}%) because the decoder is producing bursts faster than the canvas can drain. Symptom: choppy playback despite decoder keeping up on average. Fix would be smaller read batches in the pump loop or a lower queueHighWater cap \u2014 see src/strategies/fallback/decoder.ts.`
+            );
+          }
+        }
       }
       while (!destroyed && myToken === pumpToken && (opts.audio.bufferAhead() > 2 || opts.renderer.queueDepth() >= opts.renderer.queueHighWater)) {
         await new Promise((r) => setTimeout(r, 50));
@@ -33456,6 +33485,10 @@ async function createFallbackSession(ctx, target) {
       void doSeek(v);
     }
   });
+  Object.defineProperty(target, "paused", {
+    configurable: true,
+    get: () => !audio.isPlaying()
+  });
   if (ctx.duration && Number.isFinite(ctx.duration)) {
     Object.defineProperty(target, "duration", {
       configurable: true,
@@ -33464,25 +33497,35 @@ async function createFallbackSession(ctx, target) {
   }
   async function waitForBuffer() {
     const start = performance.now();
+    let firstFrameAtMs = 0;
     dbg.info(
       "cold-start",
-      `gate entry: need audio >= ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms + 1 frame`
+      `gate entry: want audio \u2265 ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms + 1 frame`
     );
     while (true) {
       const audioAhead = audio.isNoAudio() ? Infinity : audio.bufferAhead();
       const audioReady = audio.isNoAudio() || audioAhead >= READY_AUDIO_BUFFER_SECONDS2;
       const hasFrames = renderer.hasFrames();
+      const nowMs = performance.now();
+      if (hasFrames && firstFrameAtMs === 0) firstFrameAtMs = nowMs;
       if (audioReady && hasFrames) {
         dbg.info(
           "cold-start",
-          `gate satisfied in ${(performance.now() - start).toFixed(0)}ms (audio=${(audioAhead * 1e3).toFixed(0)}ms, frames=${renderer.queueDepth()})`
+          `gate satisfied in ${(nowMs - start).toFixed(0)}ms (audio=${(audioAhead * 1e3).toFixed(0)}ms, frames=${renderer.queueDepth()})`
         );
         return;
       }
-      if ((performance.now() - start) / 1e3 > READY_TIMEOUT_SECONDS2) {
+      if (hasFrames && firstFrameAtMs > 0 && nowMs - firstFrameAtMs >= 500) {
+        dbg.info(
+          "cold-start",
+          `gate released on video-only grace at ${(nowMs - start).toFixed(0)}ms (frames=${renderer.queueDepth()}, audio=${(audioAhead * 1e3).toFixed(0)}ms \u2014 demuxer hasn't delivered audio packets yet, starting anyway and letting the audio scheduler catch up at its media-time anchor)`
+        );
+        return;
+      }
+      if ((nowMs - start) / 1e3 > READY_TIMEOUT_SECONDS2) {
         dbg.diag(
           "cold-start",
-          `gate TIMEOUT after ${READY_TIMEOUT_SECONDS2}s \u2014 audio=${(audioAhead * 1e3).toFixed(0)}ms (needed ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms), frames=${renderer.queueDepth()} (needed \u22651). Software decoder is producing output slower than realtime \u2014 playback will stutter. Check getDiagnostics().runtime for the decode rate.`
+          `gate TIMEOUT after ${READY_TIMEOUT_SECONDS2}s \u2014 audio=${(audioAhead * 1e3).toFixed(0)}ms (needed ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms), frames=${renderer.queueDepth()} (needed \u22651). Decoder produced nothing in ${READY_TIMEOUT_SECONDS2}s \u2014 either a corrupt source, a missing codec, or WASM is catastrophically slow on this file. Check getDiagnostics().runtime for decode counters.`
         );
         return;
       }
@@ -33531,6 +33574,7 @@ async function createFallbackSession(ctx, target) {
       try {
         delete target.currentTime;
         delete target.duration;
+        delete target.paused;
       } catch {
       }
     },
@@ -33704,6 +33748,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
   lastProgressTime = 0;
   lastProgressPosition = -1;
   errorListener = null;
+  // Bound so we can removeEventListener in destroy(); without this the
+  // listener outlives the player and accumulates on elements that swap
+  // source (e.g. <avbridge-video>).
+  endedListener = null;
   // Serializes escalation / setStrategy calls
   switchingPromise = Promise.resolve();
   // Owns blob URLs created during sidecar discovery + SRT->VTT conversion.
@@ -33789,7 +33837,8 @@ var UnifiedPlayer = class _UnifiedPlayer {
         subtitle: ctx.subtitleTracks
       });
       this.startTimeupdateLoop();
-      this.options.target.addEventListener("ended", () => this.emitter.emit("ended", void 0));
+      this.endedListener = () => this.emitter.emit("ended", void 0);
+      this.options.target.addEventListener("ended", this.endedListener);
       this.emitter.emitSticky("ready", void 0);
       const bootstrapElapsed = performance.now() - bootstrapStart;
       dbg.info("bootstrap", `ready in ${bootstrapElapsed.toFixed(0)}ms`);
@@ -34075,6 +34124,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
       this.timeupdateInterval = null;
     }
     this.clearSupervisor();
+    if (this.endedListener) {
+      this.options.target.removeEventListener("ended", this.endedListener);
+      this.endedListener = null;
+    }
     if (this.session) {
       await this.session.destroy();
       this.session = null;
@@ -34089,11 +34142,13 @@ async function createPlayer(options) {
 function buildInitialDecision(initial, ctx) {
   const natural = classifyContext(ctx);
   const cls = strategyToClass(initial, natural);
+  const inherited = natural.fallbackChain ?? defaultFallbackChain(initial);
+  const fallbackChain = inherited.filter((s) => s !== initial);
   return {
     class: cls,
     strategy: initial,
     reason: `initial strategy "${initial}" requested via options.initialStrategy`,
-    fallbackChain: natural.fallbackChain ?? defaultFallbackChain(initial)
+    fallbackChain
   };
 }
 function strategyToClass(strategy, natural) {