avbridge 2.8.3 → 2.8.4

package/dist/element.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkIUSFLVLJ_cjs = require('./chunk-IUSFLVLJ.cjs');
+var chunkYX4AGLNF_cjs = require('./chunk-YX4AGLNF.cjs');
 require('./chunk-S4WAZC2T.cjs');
 require('./chunk-ZCUXHW55.cjs');
 require('./chunk-2IJ66NTD.cjs');
@@ -296,7 +296,7 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
     this._dispatch("loadstart", {});
     let player;
     try {
-      player = await chunkIUSFLVLJ_cjs.createPlayer({
+      player = await chunkYX4AGLNF_cjs.createPlayer({
         source,
         target: this._videoEl,
         // Honor the consumer's preferred initial strategy. "auto" means

package/dist/element.d.cts

@@ -1,4 +1,4 @@
-import { a as MediaInput, n as StrategyName, S as StrategyClass, U as UnifiedPlayer, e as AudioTrackInfo, o as SubtitleTrackInfo, D as DiagnosticsSnapshot, s as AvbridgeVideoElementEventMap } from './player-DXEKOky8.cjs';
+import { a as MediaInput, n as StrategyName, S as StrategyClass, U as UnifiedPlayer, e as AudioTrackInfo, o as SubtitleTrackInfo, D as DiagnosticsSnapshot, s as AvbridgeVideoElementEventMap } from './player-BptSJPfn.cjs';
 
 /**
  * `<avbridge-video>` — `HTMLMediaElement`-compatible primitive backed by the

package/dist/element.d.ts

@@ -1,4 +1,4 @@
-import { a as MediaInput, n as StrategyName, S as StrategyClass, U as UnifiedPlayer, e as AudioTrackInfo, o as SubtitleTrackInfo, D as DiagnosticsSnapshot, s as AvbridgeVideoElementEventMap } from './player-DXEKOky8.js';
+import { a as MediaInput, n as StrategyName, S as StrategyClass, U as UnifiedPlayer, e as AudioTrackInfo, o as SubtitleTrackInfo, D as DiagnosticsSnapshot, s as AvbridgeVideoElementEventMap } from './player-BptSJPfn.js';
 
 /**
  * `<avbridge-video>` — `HTMLMediaElement`-compatible primitive backed by the

package/dist/element.js

@@ -1,4 +1,4 @@
-import { createPlayer } from './chunk-JSQOBUQB.js';
+import { createPlayer } from './chunk-KBWQRGHS.js';
 import './chunk-5KVLE6YI.js';
 import './chunk-SR3MPV4D.js';
 import './chunk-CPJLFFCC.js';

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkQ2VUO52Z_cjs = require('./chunk-Q2VUO52Z.cjs');
-var chunkIUSFLVLJ_cjs = require('./chunk-IUSFLVLJ.cjs');
+var chunkYX4AGLNF_cjs = require('./chunk-YX4AGLNF.cjs');
 var chunkS4WAZC2T_cjs = require('./chunk-S4WAZC2T.cjs');
 var chunkZCUXHW55_cjs = require('./chunk-ZCUXHW55.cjs');
 var chunk2IJ66NTD_cjs = require('./chunk-2IJ66NTD.cjs');
@@ -763,31 +763,31 @@ Object.defineProperty(exports, "remux", {
 });
 Object.defineProperty(exports, "FALLBACK_AUDIO_CODECS", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.FALLBACK_AUDIO_CODECS; }
+  get: function () { return chunkYX4AGLNF_cjs.FALLBACK_AUDIO_CODECS; }
 });
 Object.defineProperty(exports, "FALLBACK_VIDEO_CODECS", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.FALLBACK_VIDEO_CODECS; }
+  get: function () { return chunkYX4AGLNF_cjs.FALLBACK_VIDEO_CODECS; }
 });
 Object.defineProperty(exports, "NATIVE_AUDIO_CODECS", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.NATIVE_AUDIO_CODECS; }
+  get: function () { return chunkYX4AGLNF_cjs.NATIVE_AUDIO_CODECS; }
 });
 Object.defineProperty(exports, "NATIVE_VIDEO_CODECS", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.NATIVE_VIDEO_CODECS; }
+  get: function () { return chunkYX4AGLNF_cjs.NATIVE_VIDEO_CODECS; }
 });
 Object.defineProperty(exports, "UnifiedPlayer", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.UnifiedPlayer; }
+  get: function () { return chunkYX4AGLNF_cjs.UnifiedPlayer; }
 });
 Object.defineProperty(exports, "classify", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.classifyContext; }
+  get: function () { return chunkYX4AGLNF_cjs.classifyContext; }
 });
 Object.defineProperty(exports, "createPlayer", {
   enumerable: true,
-  get: function () { return chunkIUSFLVLJ_cjs.createPlayer; }
+  get: function () { return chunkYX4AGLNF_cjs.createPlayer; }
 });
 Object.defineProperty(exports, "srtToVtt", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DXEKOky8.cjs';
-export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DXEKOky8.cjs';
+import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-BptSJPfn.cjs';
+export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-BptSJPfn.cjs';
 
 /**
  * Codecs we know `<video>` and MSE support across modern desktop + Android.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DXEKOky8.js';
-export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DXEKOky8.js';
+import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-BptSJPfn.js';
+export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-BptSJPfn.js';
 
 /**
  * Codecs we know `<video>` and MSE support across modern desktop + Android.

package/dist/index.js

@@ -1,6 +1,6 @@
 import { mimeForFormat, generateFilename, createOutputFormat } from './chunk-SMH6IOP2.js';
 export { remux } from './chunk-SMH6IOP2.js';
-export { FALLBACK_AUDIO_CODECS, FALLBACK_VIDEO_CODECS, NATIVE_AUDIO_CODECS, NATIVE_VIDEO_CODECS, UnifiedPlayer, classifyContext as classify, createPlayer } from './chunk-JSQOBUQB.js';
+export { FALLBACK_AUDIO_CODECS, FALLBACK_VIDEO_CODECS, NATIVE_AUDIO_CODECS, NATIVE_VIDEO_CODECS, UnifiedPlayer, classifyContext as classify, createPlayer } from './chunk-KBWQRGHS.js';
 export { srtToVtt } from './chunk-5KVLE6YI.js';
 import { probe, buildMediabunnySourceFromInput } from './chunk-SR3MPV4D.js';
 export { probe } from './chunk-SR3MPV4D.js';

package/dist/{player-DXEKOky8.d.cts → player-BptSJPfn.d.cts}

@@ -414,6 +414,13 @@ declare class UnifiedPlayer {
     private stallTimer;
     private lastProgressTime;
     private lastProgressPosition;
+    /** Last observed `HTMLVideoElement.getVideoPlaybackQuality().totalVideoFrames`
+     *  (or `webkitDecodedFrameCount` fallback). Used by the silent-video
+     *  watchdog — catches cases where `currentTime` advances (audio plays)
+     *  but the decoder produces no frames, e.g. Firefox claiming `hev1.*`
+     *  via MSE when the decoder actually can't decode HEVC. */
+    private lastVideoFrameCount;
+    private lastVideoFrameProgressTime;
     private errorListener;
     private endedListener;
     private userIntent;

package/dist/{player-DXEKOky8.d.ts → player-BptSJPfn.d.ts}

@@ -414,6 +414,13 @@ declare class UnifiedPlayer {
     private stallTimer;
     private lastProgressTime;
     private lastProgressPosition;
+    /** Last observed `HTMLVideoElement.getVideoPlaybackQuality().totalVideoFrames`
+     *  (or `webkitDecodedFrameCount` fallback). Used by the silent-video
+     *  watchdog — catches cases where `currentTime` advances (audio plays)
+     *  but the decoder produces no frames, e.g. Firefox claiming `hev1.*`
+     *  via MSE when the decoder actually can't decode HEVC. */
+    private lastVideoFrameCount;
+    private lastVideoFrameProgressTime;
     private errorListener;
     private endedListener;
     private userIntent;

package/dist/player.cjs

@@ -512,10 +512,12 @@ function classifyContext(ctx) {
         reason: `${ctx.container} container with ${video.codec}${audio ? "/" + audio.codec : ""}; MSE rejects the remux target mime and WebCodecs is unavailable \u2014 falling back to WASM decode`
       };
     }
+    const fallbackChain = webCodecsAvailable() ? ["hybrid", "fallback"] : ["fallback"];
     return {
       class: "REMUX_CANDIDATE",
       strategy: "remux",
-      reason: `${ctx.container} container with native-supported codecs \u2014 remux to fragmented MP4 for reliable playback`
+      reason: `${ctx.container} container with native-supported codecs \u2014 remux to fragmented MP4 for reliable playback`,
+      fallbackChain
     };
   }
   if (webCodecsAvailable()) {
@@ -3260,6 +3262,29 @@ function registerBuiltins(registry) {
 }
 
 // src/player.ts
+function readDecodedFrameCount(target) {
+  if (typeof HTMLVideoElement === "undefined" || !(target instanceof HTMLVideoElement)) return 0;
+  const vq = target.getVideoPlaybackQuality;
+  if (typeof vq === "function") {
+    try {
+      return vq.call(target).totalVideoFrames;
+    } catch {
+    }
+  }
+  const legacy = target.webkitDecodedFrameCount;
+  return typeof legacy === "number" ? legacy : 0;
+}
+function evaluateDecodeHealth(input) {
+  const timeThreshold = input.timeStallThresholdMs ?? 5e3;
+  const frameThreshold = input.frameStallThresholdMs ?? 3e3;
+  if (!input.timeAdvanced && input.now - input.lastProgressTime > timeThreshold) {
+    return { escalate: true, kind: "time-stall" };
+  }
+  if (input.hasVideoTrack && input.timeAdvanced && !input.framesAdvanced && input.now - input.lastFrameProgressTime > frameThreshold) {
+    return { escalate: true, kind: "silent-video" };
+  }
+  return { escalate: false };
+}
 var UnifiedPlayer = class _UnifiedPlayer {
   /**
    * @internal Use {@link createPlayer} or {@link UnifiedPlayer.create} instead.
@@ -3285,6 +3310,13 @@ var UnifiedPlayer = class _UnifiedPlayer {
   stallTimer = null;
   lastProgressTime = 0;
   lastProgressPosition = -1;
+  /** Last observed `HTMLVideoElement.getVideoPlaybackQuality().totalVideoFrames`
+   *  (or `webkitDecodedFrameCount` fallback). Used by the silent-video
+   *  watchdog — catches cases where `currentTime` advances (audio plays)
+   *  but the decoder produces no frames, e.g. Firefox claiming `hev1.*`
+   *  via MSE when the decoder actually can't decode HEVC. */
+  lastVideoFrameCount = 0;
+  lastVideoFrameProgressTime = 0;
   errorListener = null;
   // Bound so we can removeEventListener in destroy(); without this the
   // listener outlives the player and accumulates on elements that swap
@@ -3529,22 +3561,41 @@ var UnifiedPlayer = class _UnifiedPlayer {
     if (strategy === "native" || strategy === "remux") {
       this.lastProgressPosition = this.options.target.currentTime;
       this.lastProgressTime = performance.now();
+      this.lastVideoFrameCount = readDecodedFrameCount(this.options.target);
+      this.lastVideoFrameProgressTime = performance.now();
+      const hasVideoTrack = (this.mediaContext?.videoTracks.length ?? 0) > 0;
       this.stallTimer = setInterval(() => {
         const t = this.options.target;
+        const now = performance.now();
         if (t.paused || t.ended || t.readyState < 2) {
           this.lastProgressPosition = t.currentTime;
-          this.lastProgressTime = performance.now();
+          this.lastProgressTime = now;
+          this.lastVideoFrameCount = readDecodedFrameCount(t);
+          this.lastVideoFrameProgressTime = now;
           return;
         }
-        if (t.currentTime !== this.lastProgressPosition) {
+        const timeAdvanced = t.currentTime !== this.lastProgressPosition;
+        const frames = readDecodedFrameCount(t);
+        const framesAdvanced = frames > this.lastVideoFrameCount;
+        const health = evaluateDecodeHealth({
+          hasVideoTrack,
+          timeAdvanced,
+          framesAdvanced,
+          now,
+          lastProgressTime: this.lastProgressTime,
+          lastFrameProgressTime: this.lastVideoFrameProgressTime
+        });
+        if (timeAdvanced) {
           this.lastProgressPosition = t.currentTime;
-          this.lastProgressTime = performance.now();
-          return;
+          this.lastProgressTime = now;
         }
-        if (performance.now() - this.lastProgressTime > 5e3) {
-          void this.escalate(
-            `${strategy} strategy stalled for 5s at ${t.currentTime.toFixed(1)}s`
-          );
+        if (framesAdvanced) {
+          this.lastVideoFrameCount = frames;
+          this.lastVideoFrameProgressTime = now;
+        }
+        if (health.escalate) {
+          const reason = health.kind === "time-stall" ? `${strategy} strategy stalled for 5s at ${t.currentTime.toFixed(1)}s` : `${strategy} strategy: audio is advancing but the video decoder has produced no new frames for 3s \u2014 likely a silent codec failure`;
+          void this.escalate(reason);
         }
       }, 1e3);
       const onError = () => {
@@ -5648,12 +5699,27 @@ var AvbridgePlayerElement = class extends HTMLElement {
     this._fullscreenBtn.innerHTML = fs ? ICON_FULLSCREEN_EXIT : ICON_FULLSCREEN;
   }
   // ── Controls: auto-hide ────────────────────────────────────────────────
-  _showControls() {
+  /**
+   * Reveal the auto-hiding chrome (top toolbar + bottom controls) and
+   * re-start the auto-hide timer. Call this from app-level code to
+   * briefly surface the player UI — e.g. to confirm "you just swiped to
+   * this video" in a carousel, or to flash the title on focus change.
+   *
+   * @param durationMs  How long the chrome stays visible before fading.
+   *                    Defaults to the player's normal 3 s auto-hide.
+   *                    Pointer movement or any other interaction resets
+   *                    the timer, so a user hovering during the flash
+   *                    sees no flicker.
+   */
+  showControls(durationMs) {
     this.removeAttribute("data-controls-hidden");
     this._toolbarTop.setAttribute("data-visible", "true");
-    this._scheduleHide();
+    this._scheduleHide(durationMs);
+  }
+  _showControls() {
+    this.showControls();
   }
-  _scheduleHide() {
+  _scheduleHide(durationMs = CONTROLS_HIDE_MS) {
     if (this._controlsTimer) clearTimeout(this._controlsTimer);
     if (this._state !== "playing" && this._state !== "buffering") return;
     if (this._settingsOpen) return;
@@ -5662,7 +5728,7 @@ var AvbridgePlayerElement = class extends HTMLElement {
         this.setAttribute("data-controls-hidden", "");
         this._toolbarTop.setAttribute("data-visible", "false");
       }
-    }, CONTROLS_HIDE_MS);
+    }, durationMs);
   }
   // Strategy is visible in Stats for Nerds, no badge in controls bar.
   // ── Click / tap handling (YouTube delayed-tap pattern) ──────────────────