avbridge 2.8.4 → 2.10.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 {
@@ -287,6 +287,28 @@ interface AvbridgeVideoElementEventMap {
         fit: "contain" | "cover" | "fill";
     }>;
 }
+/**
+ * Configuration for a custom settings section added to `<avbridge-player>`
+ * via {@link addSettingsSection}. Sections render in the bottom-sheet
+ * settings panel alongside built-in sections (Speed, Audio, Subtitles,
+ * Fit, Stats for Nerds). The player owns rendering — consumers describe
+ * data; avbridge renders it in a consistent visual style.
+ */
+interface SettingsSectionConfig {
+    /** Unique id for this section. Used to update/remove later. */
+    id: string;
+    /** Display label (e.g. "Quality", "Translate"). */
+    label: string;
+    /** Items to show when the section is expanded. */
+    items: Array<{
+        id: string;
+        label: string;
+        /** Mark the currently-selected item. */
+        active?: boolean;
+    }>;
+    /** Called when the user picks an item. */
+    onSelect(itemId: string): void;
+}
 
 /**
  * `<avbridge-player>` — YouTube-style controls element.
@@ -314,6 +336,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _volumeInput;
     private _settingsBtn;
     private _settingsMenu;
+    private _settingsScrim;
+    private _customSections;
     private _fullscreenBtn;
     private _speedIndicator;
     private _rippleLeft;
@@ -347,11 +371,13 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _timeFromSeekPointer;
     private _onSeekPointerDown;
     private _onSeekHover;
+    private _updateSeekTooltip;
     private _updateSeekVisuals;
     private _updateTime;
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
+    private _fitSettingsToPlayer;
     private _closeSettings;
     private _buildSettingsMenu;
     private _toggleStats;
@@ -375,11 +401,11 @@ declare class AvbridgePlayerElement extends HTMLElement {
     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;
@@ -436,6 +462,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     load(): Promise<void>;
     destroy(): Promise<void>;
     setAudioTrack(id: number): Promise<void>;
+    addSettingsSection(config: SettingsSectionConfig): void;
+    removeSettingsSection(id: string): void;
     setSubtitleTrack(id: number | null): Promise<void>;
     getDiagnostics(): unknown;
     canPlayType(mime: string): string;
@@ -694,11 +722,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 {
@@ -287,6 +287,28 @@ interface AvbridgeVideoElementEventMap {
         fit: "contain" | "cover" | "fill";
     }>;
 }
+/**
+ * Configuration for a custom settings section added to `<avbridge-player>`
+ * via {@link addSettingsSection}. Sections render in the bottom-sheet
+ * settings panel alongside built-in sections (Speed, Audio, Subtitles,
+ * Fit, Stats for Nerds). The player owns rendering — consumers describe
+ * data; avbridge renders it in a consistent visual style.
+ */
+interface SettingsSectionConfig {
+    /** Unique id for this section. Used to update/remove later. */
+    id: string;
+    /** Display label (e.g. "Quality", "Translate"). */
+    label: string;
+    /** Items to show when the section is expanded. */
+    items: Array<{
+        id: string;
+        label: string;
+        /** Mark the currently-selected item. */
+        active?: boolean;
+    }>;
+    /** Called when the user picks an item. */
+    onSelect(itemId: string): void;
+}
 
 /**
  * `<avbridge-player>` — YouTube-style controls element.
@@ -314,6 +336,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _volumeInput;
     private _settingsBtn;
     private _settingsMenu;
+    private _settingsScrim;
+    private _customSections;
     private _fullscreenBtn;
     private _speedIndicator;
     private _rippleLeft;
@@ -347,11 +371,13 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _timeFromSeekPointer;
     private _onSeekPointerDown;
     private _onSeekHover;
+    private _updateSeekTooltip;
     private _updateSeekVisuals;
     private _updateTime;
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
+    private _fitSettingsToPlayer;
     private _closeSettings;
     private _buildSettingsMenu;
     private _toggleStats;
@@ -375,11 +401,11 @@ declare class AvbridgePlayerElement extends HTMLElement {
     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;
@@ -436,6 +462,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     load(): Promise<void>;
     destroy(): Promise<void>;
     setAudioTrack(id: number): Promise<void>;
+    addSettingsSection(config: SettingsSectionConfig): void;
+    removeSettingsSection(id: string): void;
     setSubtitleTrack(id: number | null): Promise<void>;
     getDiagnostics(): unknown;
     canPlayType(mime: string): string;
@@ -694,11 +722,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;