avbridge 2.8.2 → 2.8.4

package/dist/player.d.cts

@@ -358,6 +358,19 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _updateStats;
     private _toggleFullscreen;
     private _updateFullscreenIcon;
+    /**
+     * 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?: number): void;
     private _showControls;
     private _scheduleHide;
     /** Track whether the last interaction was touch so click handler can skip. */
@@ -446,6 +459,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.d.ts

@@ -358,6 +358,19 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _updateStats;
     private _toggleFullscreen;
     private _updateFullscreenIcon;
+    /**
+     * 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?: number): void;
     private _showControls;
     private _scheduleHide;
     /** Track whether the last interaction was touch so click handler can skip. */
@@ -446,6 +459,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.js

@@ -510,10 +510,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()) {
@@ -3258,6 +3260,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.
@@ -3283,6 +3308,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
@@ -3527,22 +3559,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 = () => {
@@ -5646,12 +5697,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;
@@ -5660,7 +5726,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) ──────────────────