avbridge 2.9.0 → 2.11.0

package/dist/player.d.cts

@@ -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;
@@ -321,6 +345,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _state;
     private _controlsTimer;
     private _settingsOpen;
+    private _activeAudioTrackId;
+    private _activeSubtitleTrackId;
     private _userSeeking;
     private _holdTimer;
     private _holdSpeedActive;
@@ -345,6 +371,10 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _onSeekCommit;
     /** Linear click-to-time mapping across the full track width (no edge clamping). */
     private _timeFromSeekPointer;
+    /** Seekbar width below which drag-to-scrub seeks in real-time (vs
+     *  preview-only). On narrow bars precise positioning is hard, so
+     *  immediate video feedback is more useful than a time tooltip. */
+    private static readonly SCRUB_WIDTH_THRESHOLD;
     private _onSeekPointerDown;
     private _onSeekHover;
     private _updateSeekTooltip;
@@ -353,6 +383,7 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
+    private _fitSettingsToPlayer;
     private _closeSettings;
     private _buildSettingsMenu;
     private _toggleStats;
@@ -374,8 +405,14 @@ declare class AvbridgePlayerElement extends HTMLElement {
     showControls(durationMs?: number): void;
     private _showControls;
     private _scheduleHide;
+    /** Read the controls-timeout attribute. 0 or negative = never hide.
+     *  Unset = default 3000ms. */
+    private _getControlsTimeout;
     /** Track whether the last interaction was touch so click handler can skip. */
     private _lastPointerTypeWasTouch;
+    /** True for ~50ms after a touch double-tap was handled, so the
+     *  synthetic dblclick from the browser doesn't also fire fullscreen. */
+    private _touchDoubleTapConsumed;
     /** 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
@@ -387,6 +424,9 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _onPointerUp;
     private _cancelHold;
     private _doDoubleTap;
+    /** Duration of one frame in seconds, derived from diagnostics fps or
+     *  a 30fps default. Used for frame-step shortcuts (`,` / `.`). */
+    private _frameDuration;
     private _onKeydown;
     private _clearTimers;
     get src(): string;
@@ -437,6 +477,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;

package/dist/player.d.ts

@@ -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;
@@ -321,6 +345,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _state;
     private _controlsTimer;
     private _settingsOpen;
+    private _activeAudioTrackId;
+    private _activeSubtitleTrackId;
     private _userSeeking;
     private _holdTimer;
     private _holdSpeedActive;
@@ -345,6 +371,10 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _onSeekCommit;
     /** Linear click-to-time mapping across the full track width (no edge clamping). */
     private _timeFromSeekPointer;
+    /** Seekbar width below which drag-to-scrub seeks in real-time (vs
+     *  preview-only). On narrow bars precise positioning is hard, so
+     *  immediate video feedback is more useful than a time tooltip. */
+    private static readonly SCRUB_WIDTH_THRESHOLD;
     private _onSeekPointerDown;
     private _onSeekHover;
     private _updateSeekTooltip;
@@ -353,6 +383,7 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
+    private _fitSettingsToPlayer;
     private _closeSettings;
     private _buildSettingsMenu;
     private _toggleStats;
@@ -374,8 +405,14 @@ declare class AvbridgePlayerElement extends HTMLElement {
     showControls(durationMs?: number): void;
     private _showControls;
     private _scheduleHide;
+    /** Read the controls-timeout attribute. 0 or negative = never hide.
+     *  Unset = default 3000ms. */
+    private _getControlsTimeout;
     /** Track whether the last interaction was touch so click handler can skip. */
     private _lastPointerTypeWasTouch;
+    /** True for ~50ms after a touch double-tap was handled, so the
+     *  synthetic dblclick from the browser doesn't also fire fullscreen. */
+    private _touchDoubleTapConsumed;
     /** 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
@@ -387,6 +424,9 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _onPointerUp;
     private _cancelHold;
     private _doDoubleTap;
+    /** Duration of one frame in seconds, derived from diagnostics fps or
+     *  a 30fps default. Used for frame-step shortcuts (`,` / `.`). */
+    private _frameDuration;
     private _onKeydown;
     private _clearTimers;
     get src(): string;
@@ -437,6 +477,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;