avbridge 2.10.0 → 2.12.0

package/dist/player.d.cts

@@ -209,6 +209,14 @@ interface CreatePlayerOptions {
      * for interceptors, logging, or environments without a global fetch.
      */
     fetchFn?: FetchFn;
+    /**
+     * Byte budget for the libav HTTP reader's LRU cache of fetched ranges.
+     * Defaults to 8 MB. Set to `0` to disable caching. Raise this when the
+     * app plays seek-heavy legacy-container media from URLs — hot regions
+     * (header/moov, tail index, current window) stay resident instead of
+     * being re-fetched on every bounce.
+     */
+    cacheBytes?: number;
 }
 /** Signature-compatible with `globalThis.fetch`. */
 type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
@@ -216,6 +224,13 @@ type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Respons
 interface TransportConfig {
     requestInit?: RequestInit;
     fetchFn?: FetchFn;
+    /**
+     * Byte budget for the libav HTTP reader's LRU cache of fetched ranges.
+     * Defaults to 8 MB. Set to `0` to disable caching entirely. Higher
+     * values help seek-heavy network playback keep hot regions
+     * (header/moov, tail index, current read) resident.
+     */
+    cacheBytes?: number;
 }
 /** Events emitted by {@link UnifiedPlayer}. Strongly typed. */
 interface PlayerEventMap {
@@ -345,6 +360,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _state;
     private _controlsTimer;
     private _settingsOpen;
+    private _activeAudioTrackId;
+    private _activeSubtitleTrackId;
     private _userSeeking;
     private _holdTimer;
     private _holdSpeedActive;
@@ -369,11 +386,21 @@ 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;
     private _updateSeekVisuals;
     private _updateTime;
+    /**
+     * Render every buffered range as its own segment so gaps (common on MSE
+     * after seeks) are visible. Not gated by `_userSeeking` — ranges should
+     * keep updating while the user scrubs, and runs cheaply on `progress`.
+     */
+    private _updateBuffered;
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
@@ -399,8 +426,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
@@ -412,6 +445,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;

package/dist/player.d.ts

@@ -209,6 +209,14 @@ interface CreatePlayerOptions {
      * for interceptors, logging, or environments without a global fetch.
      */
     fetchFn?: FetchFn;
+    /**
+     * Byte budget for the libav HTTP reader's LRU cache of fetched ranges.
+     * Defaults to 8 MB. Set to `0` to disable caching. Raise this when the
+     * app plays seek-heavy legacy-container media from URLs — hot regions
+     * (header/moov, tail index, current window) stay resident instead of
+     * being re-fetched on every bounce.
+     */
+    cacheBytes?: number;
 }
 /** Signature-compatible with `globalThis.fetch`. */
 type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
@@ -216,6 +224,13 @@ type FetchFn = (input: RequestInfo | URL, init?: RequestInit) => Promise<Respons
 interface TransportConfig {
     requestInit?: RequestInit;
     fetchFn?: FetchFn;
+    /**
+     * Byte budget for the libav HTTP reader's LRU cache of fetched ranges.
+     * Defaults to 8 MB. Set to `0` to disable caching entirely. Higher
+     * values help seek-heavy network playback keep hot regions
+     * (header/moov, tail index, current read) resident.
+     */
+    cacheBytes?: number;
 }
 /** Events emitted by {@link UnifiedPlayer}. Strongly typed. */
 interface PlayerEventMap {
@@ -345,6 +360,8 @@ declare class AvbridgePlayerElement extends HTMLElement {
     private _state;
     private _controlsTimer;
     private _settingsOpen;
+    private _activeAudioTrackId;
+    private _activeSubtitleTrackId;
     private _userSeeking;
     private _holdTimer;
     private _holdSpeedActive;
@@ -369,11 +386,21 @@ 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;
     private _updateSeekVisuals;
     private _updateTime;
+    /**
+     * Render every buffered range as its own segment so gaps (common on MSE
+     * after seeks) are visible. Not gated by `_userSeeking` — ranges should
+     * keep updating while the user scrubs, and runs cheaply on `progress`.
+     */
+    private _updateBuffered;
     private _toggleMute;
     private _updateVolume;
     private _toggleSettings;
@@ -399,8 +426,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
@@ -412,6 +445,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;

package/dist/player.js

@@ -1,7 +1,7 @@
 import { AvbridgeError, ERR_ALL_STRATEGIES_EXHAUSTED, ERR_PLAYER_NOT_READY, normalizeSource, sniffNormalizedSource, ERR_PROBE_FAILED, ERR_PROBE_UNKNOWN_CONTAINER, ERR_LIBAV_NOT_REACHABLE, ERR_MSE_NOT_SUPPORTED, ERR_MSE_CODEC_NOT_SUPPORTED } from './chunk-E76AMWI4.js';
 import { dbg, loadLibav } from './chunk-IAYKFGFG.js';
-import './chunk-DCSOQH2N.js';
-import { SubtitleResourceBag, discoverSidecars, attachSubtitleTracks, SubtitleOverlay } from './chunk-5KVLE6YI.js';
+import './chunk-3AI5WFFN.js';
+import { SubtitleResourceBag, discoverSidecars, attachSubtitleTracks, SubtitleOverlay } from './chunk-EDDWAN2L.js';
 import './chunk-LUFA47FP.js';
 
 // src/events.ts
@@ -237,7 +237,7 @@ async function probe(source, transport) {
       const hasUnknownCodec = result.videoTracks.some((t) => t.codec === "unknown") || result.audioTracks.some((t) => t.codec === "unknown");
       if (hasUnknownCodec) {
         try {
-          const { probeWithLibav } = await import('./avi-JXU4GQL2.js');
+          const { probeWithLibav } = await import('./avi-S7EY54YA.js');
           return await probeWithLibav(normalized, sniffed);
         } catch {
           return result;
@@ -250,7 +250,7 @@ async function probe(source, transport) {
         mediabunnyErr.message
       );
       try {
-        const { probeWithLibav } = await import('./avi-JXU4GQL2.js');
+        const { probeWithLibav } = await import('./avi-S7EY54YA.js');
         return await probeWithLibav(normalized, sniffed);
       } catch (libavErr) {
         const mbMsg = mediabunnyErr.message || String(mediabunnyErr);
@@ -264,7 +264,7 @@ async function probe(source, transport) {
     }
   }
   try {
-    const { probeWithLibav } = await import('./avi-JXU4GQL2.js');
+    const { probeWithLibav } = await import('./avi-S7EY54YA.js');
     return await probeWithLibav(normalized, sniffed);
   } catch (err) {
     const inner = err instanceof Error ? err.message : String(err);
@@ -1749,6 +1749,10 @@ var AudioOutput = class {
     if (this.ctx.state === "suspended") {
       await this.ctx.resume();
     }
+    try {
+      this.gain.connect(this.ctx.destination);
+    } catch {
+    }
     if (this.state === "paused") {
       this.ctxTimeAtAnchor = this.ctx.currentTime;
       this.state = "playing";
@@ -1775,6 +1779,10 @@ var AudioOutput = class {
     this.mediaTimeOfAnchor = this.now();
     this.state = "paused";
     if (this.noAudio) return;
+    try {
+      this.gain.disconnect();
+    } catch {
+    }
     if (this.ctx.state === "running") {
       await this.ctx.suspend();
     }
@@ -2013,7 +2021,7 @@ async function startHybridDecoder(opts) {
   const variant = pickLibavVariant(opts.context);
   const libav = await loadLibav(variant);
   const bridge = await loadBridge();
-  const { prepareLibavInput } = await import('./libav-http-reader-WXG3Z7AI.js');
+  const { prepareLibavInput } = await import('./libav-http-reader-2S5HAHW4.js');
   const inputHandle = await prepareLibavInput(libav, opts.filename, opts.source, opts.transport);
   const readPkt = await libav.av_packet_alloc();
   const [fmt_ctx, streams] = await libav.ff_init_demuxer_file(opts.filename);
@@ -2683,7 +2691,7 @@ async function startDecoder(opts) {
   const variant = "avbridge";
   const libav = await loadLibav(variant);
   const bridge = await loadBridge2();
-  const { prepareLibavInput } = await import('./libav-http-reader-WXG3Z7AI.js');
+  const { prepareLibavInput } = await import('./libav-http-reader-2S5HAHW4.js');
   const inputHandle = await prepareLibavInput(libav, opts.filename, opts.source, opts.transport);
   const readPkt = await libav.av_packet_alloc();
   const [fmt_ctx, streams] = await libav.ff_init_demuxer_file(opts.filename);
@@ -3412,9 +3420,9 @@ var UnifiedPlayer = class _UnifiedPlayer {
   constructor(options, registry) {
     this.options = options;
     this.registry = registry;
-    const { requestInit, fetchFn } = options;
-    if (requestInit || fetchFn) {
-      this.transport = { requestInit, fetchFn };
+    const { requestInit, fetchFn, cacheBytes } = options;
+    if (requestInit || fetchFn || cacheBytes !== void 0) {
+      this.transport = { requestInit, fetchFn, cacheBytes };
     }
   }
   options;
@@ -4565,7 +4573,7 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
    * strategies pick up the new track via their textTracks watcher.
    */
   async addSubtitle(subtitle) {
-    const { attachSubtitleTracks: attachSubtitleTracks2 } = await import('./subtitles-4T74JRGT.js');
+    const { attachSubtitleTracks: attachSubtitleTracks2 } = await import('./subtitles-5H24MEBJ.js');
     const format = subtitle.format ?? (subtitle.url.endsWith(".srt") ? "srt" : "vtt");
     const track = {
       id: this._subtitleTracks.length,
@@ -4574,14 +4582,27 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
       sidecarUrl: subtitle.url
     };
     this._subtitleTracks.push(track);
+    console.log(`[avbridge:subs] addSubtitle id=${track.id} format=${format} lang=${subtitle.language ?? "?"}`);
     await attachSubtitleTracks2(
       this._videoEl,
       this._subtitleTracks,
       void 0,
       (err, t) => {
-        console.warn(`[avbridge] subtitle ${t.id} failed: ${err.message}`);
+        console.warn(`[avbridge:subs] subtitle ${t.id} failed: ${err.message}`);
       }
     );
+    const textTracks = this._videoEl.textTracks;
+    for (let i = 0; i < textTracks.length; i++) {
+      if (textTracks[i].label === (subtitle.language ?? `Subtitle ${track.id}`)) {
+        textTracks[i].mode = "showing";
+        console.log(`[avbridge:subs] enabled textTrack[${i}] mode=showing`);
+        break;
+      }
+    }
+    this._dispatch("trackschange", {
+      audioTracks: this._audioTracks,
+      subtitleTracks: this.subtitleTracks
+    });
   }
   /**
    * Disable the automatic `screen.orientation.lock()` that runs on
@@ -5012,6 +5033,12 @@ var PLAYER_STYLES = (
   display: flex;
   align-items: center;
   cursor: pointer;
+  /* Claim all touch gestures on the seek bar. Without this, Android
+   * browsers (Chrome, Samsung Internet) treat horizontal drags as
+   * scroll candidates and cancel pointermove once the gesture
+   * resolves, breaking scrub. touch-action must be set in CSS \u2014
+   * preventDefault() on pointerdown is too late. */
+  touch-action: none;
 }
 
 .avp-seek-track {
@@ -5029,7 +5056,13 @@ var PLAYER_STYLES = (
 
 .avp-seek-buffered {
   position: absolute;
-  left: 0;
+  inset: 0;
+  pointer-events: none;
+}
+
+.avp-seek-buffered-range {
+  position: absolute;
+  top: 0;
   height: 100%;
   background: rgba(255, 255, 255, 0.35);
   border-radius: inherit;
@@ -5395,7 +5428,7 @@ function formatTime(sec) {
   return h > 0 ? `${h}:${mm}:${ss}` : `${mm}:${ss}`;
 }
 var PLAYBACK_SPEEDS = [0.25, 0.5, 0.75, 1, 1.25, 1.5, 1.75, 2];
-var CONTROLS_HIDE_MS = 3e3;
+var DEFAULT_CONTROLS_HIDE_MS = 3e3;
 var FORWARDED_EVENTS = [
   "ready",
   "error",
@@ -5438,7 +5471,7 @@ var PROXY_ATTRIBUTES = [
 ];
 var PLAYER_ATTRIBUTES = ["show-fit"];
 var FIT_MODES = ["contain", "cover", "fill"];
-var AvbridgePlayerElement = class extends HTMLElement {
+var AvbridgePlayerElement = class _AvbridgePlayerElement extends HTMLElement {
   static observedAttributes = [...PROXY_ATTRIBUTES, ...PLAYER_ATTRIBUTES];
   // ── Internal DOM refs ──────────────────────────────────────────────────
   _video;
@@ -5466,6 +5499,8 @@ var AvbridgePlayerElement = class extends HTMLElement {
   _state = "idle";
   _controlsTimer = null;
   _settingsOpen = false;
+  _activeAudioTrackId = null;
+  _activeSubtitleTrackId = null;
   _userSeeking = false;
   _holdTimer = null;
   _holdSpeedActive = false;
@@ -5587,6 +5622,7 @@ var AvbridgePlayerElement = class extends HTMLElement {
     on(this._video, "ended", () => this._setState("ended"));
     on(this._video, "error", () => this._setState("error"));
     on(this._video, "timeupdate", () => this._updateTime());
+    on(this._video, "progress", () => this._updateBuffered());
     on(this._video, "volumechange", () => this._updateVolume());
     on(this._video, "trackschange", () => this._buildSettingsMenu());
     on(this._video, "durationchange", () => {
@@ -5729,6 +5765,10 @@ var AvbridgePlayerElement = class extends HTMLElement {
     const frac = Math.max(0, Math.min(1, (clientX - rect.left) / rect.width));
     return frac * (this._video.duration || 0);
   }
+  /** 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. */
+  static SCRUB_WIDTH_THRESHOLD = 400;
   _onSeekPointerDown(e) {
     if (e.button !== 0 && e.pointerType === "mouse") return;
     e.preventDefault();
@@ -5736,15 +5776,26 @@ var AvbridgePlayerElement = class extends HTMLElement {
     const seekBar = this.shadowRoot.querySelector(".avp-seek");
     seekBar.setPointerCapture(e.pointerId);
     seekBar.setAttribute("data-seeking", "");
+    const scrubMode = seekBar.getBoundingClientRect().width < _AvbridgePlayerElement.SCRUB_WIDTH_THRESHOLD;
+    let lastScrubCommit = 0;
     const initial = this._timeFromSeekPointer(e.clientX);
     this._seekInput.value = String(initial);
     this._onSeekInput();
     this._updateSeekTooltip(e.clientX);
+    if (scrubMode) this._onSeekCommit();
     const onMove = (ev) => {
       const t = this._timeFromSeekPointer(ev.clientX);
       this._seekInput.value = String(t);
       this._onSeekInput();
       this._updateSeekTooltip(ev.clientX);
+      if (scrubMode) {
+        const now = performance.now();
+        if (now - lastScrubCommit > 250) {
+          lastScrubCommit = now;
+          this._onSeekCommit();
+          this._userSeeking = true;
+        }
+      }
     };
     const onUp = (ev) => {
       const t = this._timeFromSeekPointer(ev.clientX);
@@ -5788,13 +5839,45 @@ var AvbridgePlayerElement = class extends HTMLElement {
     this._seekInput.value = String(t);
     this._updateSeekVisuals(t);
     this._timeDisplay.textContent = `${formatTime(t)} / ${formatTime(d)}`;
+    this._updateBuffered();
+  }
+  /**
+   * Render every buffered range as its own segment so gaps (common on MSE
+   * after seeks) are visible. Not gated by `_userSeeking` — ranges should
+   * keep updating while the user scrubs, and runs cheaply on `progress`.
+   */
+  _updateBuffered() {
+    const d = this._video.duration;
+    if (!(d > 0)) return;
+    let buf;
     try {
-      const buf = this._video.buffered;
-      if (buf && buf.length > 0 && d > 0) {
-        const end = buf.end(buf.length - 1);
-        this._seekBuffered.style.width = `${end / d * 100}%`;
-      }
+      buf = this._video.buffered;
     } catch {
+      return;
+    }
+    const count = buf ? buf.length : 0;
+    const host = this._seekBuffered;
+    while (host.childElementCount > count) host.lastElementChild.remove();
+    while (host.childElementCount < count) {
+      const seg = document.createElement("div");
+      seg.className = "avp-seek-buffered-range";
+      host.appendChild(seg);
+    }
+    for (let i = 0; i < count; i++) {
+      let start;
+      let end;
+      try {
+        start = buf.start(i);
+        end = buf.end(i);
+      } catch {
+        continue;
+      }
+      const s = Math.max(0, start);
+      const e = Math.min(d, end);
+      if (e <= s) continue;
+      const seg = host.children[i];
+      seg.style.left = `${s / d * 100}%`;
+      seg.style.width = `${(e - s) / d * 100}%`;
     }
   }
   // ── Controls: volume ───────────────────────────────────────────────────
@@ -5845,19 +5928,27 @@ var AvbridgePlayerElement = class extends HTMLElement {
     sections.push(selectRow("Speed", speedValue, speedOpts, `data-action="speed"`));
     const audios = this._video.audioTracks ?? [];
     if (audios.length > 1) {
+      const activeAudioId = this._activeAudioTrackId ?? audios[0]?.id;
+      const activeAudio = audios.find((t) => t.id === activeAudioId) ?? audios[0];
+      const audioValue = activeAudio?.language ?? `Track ${activeAudio?.id ?? 1}`;
       let audioOpts = "";
       for (const t of audios) {
-        audioOpts += `<option value="${t.id}">${t.language ?? `Track ${t.id}`}</option>`;
+        const sel = t.id === activeAudioId ? " selected" : "";
+        audioOpts += `<option value="${t.id}"${sel}>${t.language ?? `Track ${t.id}`}</option>`;
       }
-      sections.push(selectRow("Audio", audios[0]?.language ?? "Track 1", audioOpts, `data-action="audio"`));
+      sections.push(selectRow("Audio", audioValue, audioOpts, `data-action="audio"`));
     }
     const subs = this._video.subtitleTracks ?? [];
     if (subs.length > 0) {
-      let subOpts = `<option value="-1" selected>Off</option>`;
+      const activeSubId = this._activeSubtitleTrackId;
+      const activeSub = activeSubId != null ? subs.find((t) => t.id === activeSubId) : null;
+      const subValue = activeSub ? activeSub.language ?? `Track ${activeSub.id}` : "Off";
+      let subOpts = `<option value="-1"${activeSubId == null ? " selected" : ""}>Off</option>`;
       for (const t of subs) {
-        subOpts += `<option value="${t.id}">${t.language ?? `Track ${t.id}`}</option>`;
+        const sel = t.id === activeSubId ? " selected" : "";
+        subOpts += `<option value="${t.id}"${sel}>${t.language ?? `Track ${t.id}`}</option>`;
       }
-      sections.push(selectRow("Subtitles", "Off", subOpts, `data-action="subtitle"`));
+      sections.push(selectRow("Subtitles", subValue, subOpts, `data-action="subtitle"`));
     }
     if (this.hasAttribute("show-fit")) {
       const currentFit = this._video.fit ?? "contain";
@@ -5897,11 +5988,15 @@ var AvbridgePlayerElement = class extends HTMLElement {
             this._video.playbackRate = Number(val);
             break;
           case "audio":
+            this._activeAudioTrackId = Number(val);
             void this._video.setAudioTrack(Number(val));
             break;
-          case "subtitle":
-            void this._video.setSubtitleTrack(Number(val) >= 0 ? Number(val) : null);
+          case "subtitle": {
+            const subId = Number(val);
+            this._activeSubtitleTrackId = subId >= 0 ? subId : null;
+            void this._video.setSubtitleTrack(subId >= 0 ? subId : null);
             break;
+          }
           case "fit":
             this.setAttribute("fit", val);
             break;
@@ -5996,16 +6091,26 @@ var AvbridgePlayerElement = class extends HTMLElement {
   _showControls() {
     this.showControls();
   }
-  _scheduleHide(durationMs = CONTROLS_HIDE_MS) {
+  _scheduleHide(durationMs) {
+    const ms = durationMs ?? this._getControlsTimeout();
     if (this._controlsTimer) clearTimeout(this._controlsTimer);
     if (this._state !== "playing" && this._state !== "buffering") return;
     if (this._settingsOpen) return;
+    if (ms <= 0) return;
     this._controlsTimer = setTimeout(() => {
       if (this._state === "playing") {
         this.setAttribute("data-controls-hidden", "");
         this._toolbarTop.setAttribute("data-visible", "false");
       }
-    }, durationMs);
+    }, ms);
+  }
+  /** Read the controls-timeout attribute. 0 or negative = never hide.
+   *  Unset = default 3000ms. */
+  _getControlsTimeout() {
+    const attr = this.getAttribute("controls-timeout");
+    if (attr == null) return DEFAULT_CONTROLS_HIDE_MS;
+    const n = Number(attr);
+    return Number.isFinite(n) ? n : DEFAULT_CONTROLS_HIDE_MS;
   }
   // Strategy is visible in Stats for Nerds, no badge in controls bar.
   // ── Click / tap handling (YouTube delayed-tap pattern) ──────────────────
@@ -6017,6 +6122,9 @@ var AvbridgePlayerElement = class extends HTMLElement {
   // it's treated as a double-click and the single-click action is cancelled.
   /** Track whether the last interaction was touch so click handler can skip. */
   _lastPointerTypeWasTouch = false;
+  /** True for ~50ms after a touch double-tap was handled, so the
+   *  synthetic dblclick from the browser doesn't also fire fullscreen. */
+  _touchDoubleTapConsumed = false;
   /** 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
@@ -6050,6 +6158,7 @@ var AvbridgePlayerElement = class extends HTMLElement {
   _onContainerDblClick(e) {
     if (e.target.closest?.(".avp-controls, .avp-settings")) return;
     if (this._isSlottedContentEvent(e)) return;
+    if (this._touchDoubleTapConsumed) return;
     if (this._tapTimer) {
       clearTimeout(this._tapTimer);
       this._tapTimer = null;
@@ -6091,6 +6200,10 @@ var AvbridgePlayerElement = class extends HTMLElement {
       } else {
         this._toggleFullscreen();
       }
+      this._touchDoubleTapConsumed = true;
+      setTimeout(() => {
+        this._touchDoubleTapConsumed = false;
+      }, 100);
       this._lastTapTime = 0;
       return;
     }
@@ -6124,6 +6237,13 @@ var AvbridgePlayerElement = class extends HTMLElement {
     this._video.currentTime = Math.max(0, this._video.currentTime + delta);
   }
   // ── Keyboard shortcuts ─────────────────────────────────────────────────
+  /** Duration of one frame in seconds, derived from diagnostics fps or
+   *  a 30fps default. Used for frame-step shortcuts (`,` / `.`). */
+  _frameDuration() {
+    const diag = this._video.getDiagnostics();
+    const fps = diag?.fps && diag.fps > 0 ? diag.fps : 30;
+    return 1 / fps;
+  }
   _onKeydown(e) {
     if (e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement) return;
     switch (e.key) {
@@ -6168,6 +6288,19 @@ var AvbridgePlayerElement = class extends HTMLElement {
         this._video.playbackRate = Math.max(0.25, this._video.playbackRate - 0.25);
         this._buildSettingsMenu();
         break;
+      case ",":
+        e.preventDefault();
+        if (!this._video.paused) this._video.pause();
+        this._video.currentTime = Math.max(0, this._video.currentTime - this._frameDuration());
+        break;
+      case ".":
+        e.preventDefault();
+        if (!this._video.paused) this._video.pause();
+        this._video.currentTime = Math.min(
+          this._video.duration || 0,
+          this._video.currentTime + this._frameDuration()
+        );
+        break;
       case "Escape":
         if (this._settingsOpen) {
           e.preventDefault();