avbridge 2.12.1 → 2.13.0

package/dist/player.d.cts

@@ -338,6 +338,32 @@ interface SettingsSectionConfig {
 
 declare class AvbridgePlayerElement extends HTMLElement {
     static readonly observedAttributes: ("src" | "muted" | "autoplay" | "loop" | "preload" | "poster" | "playsinline" | "crossorigin" | "disableremoteplayback" | "preferstrategy" | "fit" | "show-fit")[];
+    /**
+     * Returns `true` if a DOM event originated from one of the player's
+     * **interactive chrome elements** (seek bar, control buttons, settings
+     * menu, overlay play button) rather than the bare video surface.
+     *
+     * This is the escape hatch for host pages that wrap the player in a
+     * gesture recognizer (e.g. TikTok-style vertical-swipe pager). For
+     * bubble-phase listeners the player's own handlers already call
+     * `stopPropagation()` on chrome interactions — but **capture-phase**
+     * listeners run *before* the player's handlers, so they need to check
+     * the event's path themselves and bail. This helper does that check
+     * via `composedPath()`, which traverses shadow boundaries correctly.
+     *
+     * Returns `false` for events on the bare video surface — host pages
+     * remain free to claim those for their own gestures (e.g. swipe-to-pan
+     * to the next video). Returns `false` for events that never hit a
+     * player at all.
+     *
+     * @example
+     * // TikTok-style vertical swipe on the document, capture phase:
+     * document.addEventListener("pointerdown", (e) => {
+     *   if (AvbridgePlayerElement.isPlayerChromeEvent(e)) return;
+     *   startSwipeGesture(e);
+     * }, { capture: true });
+     */
+    static isPlayerChromeEvent(event: Event): boolean;
     private _video;
     private _playBtn;
     private _overlayBtn;
@@ -363,6 +389,11 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _activeAudioTrackId;
     private _activeSubtitleTrackId;
     private _userSeeking;
+    /** Last seek target the user committed. The thumb stays here (and
+     *  `_updateTime` skips updating from `timeupdate`) until the underlying
+     *  `currentTime` actually catches up — otherwise the thumb visibly snaps
+     *  back to the pre-seek position while the remux pipeline rebuilds. */
+    private _pendingSeekTarget;
     private _holdTimer;
     private _holdSpeedActive;
     private _savedPlaybackRate;
@@ -386,13 +417,13 @@ 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;
+    /** Position the tooltip over a specific time (vs. pointer X). Used by
+     *  relative-drag scrub on coarse pointers, where the displayed time
+     *  is decoupled from the finger position. */
+    private _updateSeekTooltipAtTime;
     private _updateSeekVisuals;
     private _updateTime;
     /**

package/dist/player.d.ts

@@ -338,6 +338,32 @@ interface SettingsSectionConfig {
 
 declare class AvbridgePlayerElement extends HTMLElement {
     static readonly observedAttributes: ("src" | "muted" | "autoplay" | "loop" | "preload" | "poster" | "playsinline" | "crossorigin" | "disableremoteplayback" | "preferstrategy" | "fit" | "show-fit")[];
+    /**
+     * Returns `true` if a DOM event originated from one of the player's
+     * **interactive chrome elements** (seek bar, control buttons, settings
+     * menu, overlay play button) rather than the bare video surface.
+     *
+     * This is the escape hatch for host pages that wrap the player in a
+     * gesture recognizer (e.g. TikTok-style vertical-swipe pager). For
+     * bubble-phase listeners the player's own handlers already call
+     * `stopPropagation()` on chrome interactions — but **capture-phase**
+     * listeners run *before* the player's handlers, so they need to check
+     * the event's path themselves and bail. This helper does that check
+     * via `composedPath()`, which traverses shadow boundaries correctly.
+     *
+     * Returns `false` for events on the bare video surface — host pages
+     * remain free to claim those for their own gestures (e.g. swipe-to-pan
+     * to the next video). Returns `false` for events that never hit a
+     * player at all.
+     *
+     * @example
+     * // TikTok-style vertical swipe on the document, capture phase:
+     * document.addEventListener("pointerdown", (e) => {
+     *   if (AvbridgePlayerElement.isPlayerChromeEvent(e)) return;
+     *   startSwipeGesture(e);
+     * }, { capture: true });
+     */
+    static isPlayerChromeEvent(event: Event): boolean;
     private _video;
     private _playBtn;
     private _overlayBtn;
@@ -363,6 +389,11 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _activeAudioTrackId;
     private _activeSubtitleTrackId;
     private _userSeeking;
+    /** Last seek target the user committed. The thumb stays here (and
+     *  `_updateTime` skips updating from `timeupdate`) until the underlying
+     *  `currentTime` actually catches up — otherwise the thumb visibly snaps
+     *  back to the pre-seek position while the remux pipeline rebuilds. */
+    private _pendingSeekTarget;
     private _holdTimer;
     private _holdSpeedActive;
     private _savedPlaybackRate;
@@ -386,13 +417,13 @@ 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;
+    /** Position the tooltip over a specific time (vs. pointer X). Used by
+     *  relative-drag scrub on coarse pointers, where the displayed time
+     *  is decoupled from the finger position. */
+    private _updateSeekTooltipAtTime;
     private _updateSeekVisuals;
     private _updateTime;
     /**