avbridge 2.8.3 → 2.9.0

package/dist/player.d.cts

@@ -15,7 +15,7 @@ type MediaInput = File | Blob | string | URL | ArrayBuffer | Uint8Array;
 /** Container format families we know about. */
 type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "rm" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
 /** Video codec families. Strings, not enums, so plugins can extend. */
-type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
+type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | "dv" | "hq_hqa" | "rawvideo" | "qtrle" | "png" | "vp6f" | (string & {});
 /** Audio codec families. */
 type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | "dts" | "truehd" | (string & {});
 interface VideoTrackInfo {
@@ -347,6 +347,7 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _timeFromSeekPointer;
     private _onSeekPointerDown;
     private _onSeekHover;
+    private _updateSeekTooltip;
     private _updateSeekVisuals;
     private _updateTime;
     private _toggleMute;
@@ -358,15 +359,28 @@ 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. */
     private _lastPointerTypeWasTouch;
-    /** True if the event's composed path passes through consumer-slotted toolbar
-     *  content. Slotted content lives in the light DOM so `.closest(".avp-toolbar-top")`
-     *  on the event target won't find the shadow-DOM wrapper — `composedPath()`
-     *  does. */
-    private _isToolbarEvent;
+    /** True if the event's composed path passes through consumer-slotted
+     *  content (toolbar or content-overlay). Slotted content lives in the
+     *  light DOM so `.closest(".avp-toolbar-top")` on the event target won't
+     *  find the shadow-DOM wrapper — `composedPath()` does. */
+    private _isSlottedContentEvent;
     private _onContainerClick;
     private _onContainerDblClick;
     private _onPointerDown;
@@ -446,6 +460,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;
@@ -674,11 +695,16 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     get readyState(): number;
     /**
      * Buffered time ranges for the active source. Mirrors the standard
-     * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
-     * this reflects the underlying SourceBuffer / progressive download state.
-     * For the hybrid and fallback (canvas-rendered) strategies it currently
-     * returns an empty TimeRanges; a future release will synthesize a coarse
-     * range from the decoder's read position.
+     * `<video>.buffered` `TimeRanges` API.
+     *
+     * - **Native / remux:** pass-through to the real `<video>.buffered`
+     *   (reflects the browser's SourceBuffer / progressive-download state).
+     * - **Hybrid / fallback:** a single `[0, frontier]` range synthesized
+     *   from the demuxer's read progress — "how far libav has ever pumped
+     *   packets through." Monotonic; does not shrink on seek. This is an
+     *   approximation, not MSE-fidelity: decoded frames on canvas strategies
+     *   are consumed in flight, so we can't report per-range availability
+     *   the way MSE does. Enough for a seek-bar buffered indicator.
      */
     get buffered(): TimeRanges;
     get poster(): string;

package/dist/player.d.ts

@@ -15,7 +15,7 @@ type MediaInput = File | Blob | string | URL | ArrayBuffer | Uint8Array;
 /** Container format families we know about. */
 type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "rm" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
 /** Video codec families. Strings, not enums, so plugins can extend. */
-type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
+type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | "dv" | "hq_hqa" | "rawvideo" | "qtrle" | "png" | "vp6f" | (string & {});
 /** Audio codec families. */
 type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | "dts" | "truehd" | (string & {});
 interface VideoTrackInfo {
@@ -347,6 +347,7 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _timeFromSeekPointer;
     private _onSeekPointerDown;
     private _onSeekHover;
+    private _updateSeekTooltip;
     private _updateSeekVisuals;
     private _updateTime;
     private _toggleMute;
@@ -358,15 +359,28 @@ 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. */
     private _lastPointerTypeWasTouch;
-    /** True if the event's composed path passes through consumer-slotted toolbar
-     *  content. Slotted content lives in the light DOM so `.closest(".avp-toolbar-top")`
-     *  on the event target won't find the shadow-DOM wrapper — `composedPath()`
-     *  does. */
-    private _isToolbarEvent;
+    /** True if the event's composed path passes through consumer-slotted
+     *  content (toolbar or content-overlay). Slotted content lives in the
+     *  light DOM so `.closest(".avp-toolbar-top")` on the event target won't
+     *  find the shadow-DOM wrapper — `composedPath()` does. */
+    private _isSlottedContentEvent;
     private _onContainerClick;
     private _onContainerDblClick;
     private _onPointerDown;
@@ -446,6 +460,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;
@@ -674,11 +695,16 @@ declare class AvbridgeVideoElement extends HTMLElementCtor {
     get readyState(): number;
     /**
      * Buffered time ranges for the active source. Mirrors the standard
-     * `<video>.buffered` `TimeRanges` API. For the native and remux strategies
-     * this reflects the underlying SourceBuffer / progressive download state.
-     * For the hybrid and fallback (canvas-rendered) strategies it currently
-     * returns an empty TimeRanges; a future release will synthesize a coarse
-     * range from the decoder's read position.
+     * `<video>.buffered` `TimeRanges` API.
+     *
+     * - **Native / remux:** pass-through to the real `<video>.buffered`
+     *   (reflects the browser's SourceBuffer / progressive-download state).
+     * - **Hybrid / fallback:** a single `[0, frontier]` range synthesized
+     *   from the demuxer's read progress — "how far libav has ever pumped
+     *   packets through." Monotonic; does not shrink on seek. This is an
+     *   approximation, not MSE-fidelity: decoded frames on canvas strategies
+     *   are consumed in flight, so we can't report per-range availability
+     *   the way MSE does. Enough for a seek-bar buffered indicator.
      */
     get buffered(): TimeRanges;
     get poster(): string;