avbridge 2.9.0 → 2.11.0

package/CHANGELOG.md

@@ -4,6 +4,71 @@ All notable changes to **avbridge.js** are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.11.0]
+
+Subtitle panel, interaction fixes, and quality-of-life.
+
+### Added
+
+- **`<avbridge-subtitles>` element** — scrollable cue timeline panel.
+  Connects to a player via `for` attribute, renders all subtitle cues
+  as timestamped rows, highlights the active cue, auto-scrolls to
+  follow playback, and click-to-seek. Shadow DOM with dark styles.
+- **Frame-by-frame keyboard shortcuts** (`,` / `.`) — YouTube-style.
+  Pauses if playing, then steps back/forward one frame (1/fps).
+- **Real-time scrub seeking on narrow seekbars** — when the seekbar
+  is <400px wide, dragging seeks in real-time (throttled to 4 Hz)
+  instead of preview-only. Immediate video feedback on small players.
+- **`controls-timeout` attribute** on `<avbridge-player>`. Customize
+  the auto-hide duration (default 3000ms). Set to `"0"` to disable
+  auto-hide entirely (always-visible controls).
+
+### Fixed
+
+- **Subtitles not showing** — `addSubtitle()` didn't dispatch
+  `trackschange` (settings sheet never showed the new track) and the
+  `<track>` element was created with `mode="disabled"` (never
+  rendered on native strategy). Now dispatches + auto-enables.
+- **Audio bleed on pause** for hybrid/fallback — already-scheduled
+  AudioBufferSourceNodes kept playing ~200ms after pause. Now
+  disconnects the gain node immediately (same pattern as seek/reset).
+- **Double-tap fires both ff/rw AND fullscreen on touch** — browser's
+  synthetic `dblclick` after two rapid taps was calling fullscreen
+  on top of the touch handler's ff/rw. Blocked via a consumed flag.
+- **Settings sheet didn't show active audio/subtitle selection** —
+  always displayed "Track 1" / "Off" regardless of actual state.
+
+## [2.10.0]
+
+Settings UI overhaul + playback rate on all strategies.
+
+### Added
+
+- **Bottom-sheet settings panel** replacing the popup menu. Slides up
+  from the controls bar with a scrim overlay. Each section uses a
+  native `<select>` picker overlaid on a styled row — the OS picker
+  renders outside the player bounds (intentional for small players).
+  Rows show label left, current value right. Tapping anywhere outside
+  the sheet or pressing Escape dismisses it.
+- **Consumer extensibility API**: `player.addSettingsSection({ id,
+  label, items, onSelect })` / `player.removeSettingsSection(id)`.
+  Custom sections render after built-in ones using the same native
+  `<select>` pattern. New `SettingsSectionConfig` type exported.
+- **Playback rate on hybrid + fallback strategies.** `playbackRate`
+  was a no-op on canvas strategies because the inner `<video>` has
+  no `src`. Now patched via `Object.defineProperty` — drives the
+  `AudioOutput` clock speed + `AudioBufferSourceNode.playbackRate`
+  for pitch-shifted audio. Video renderer follows automatically
+  since it syncs to `audio.now()`. The `ratechange` event fires.
+
+### Fixed
+
+- **Settings menu sizing** — JS-measured max-height (70% of player)
+  replaces the broken CSS percentage approach.
+- **Blue tap-highlight flash** suppressed on `<avbridge-player>`.
+- **`cursor: pointer` removed** from the player container — the
+  video surface isn't a button.
+
 ## [2.9.0]
 
 Player chrome ergonomics — four changes driven by explorer integration

package/dist/{chunk-EY6DZEDT.cjs → chunk-37UOSAVI.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkS4WAZC2T_cjs = require('./chunk-S4WAZC2T.cjs');
+var chunkWRKO6Q42_cjs = require('./chunk-WRKO6Q42.cjs');
 var chunkBYGZN4Z5_cjs = require('./chunk-BYGZN4Z5.cjs');
 var chunk2IJ66NTD_cjs = require('./chunk-2IJ66NTD.cjs');
 var chunkL7A3ECI2_cjs = require('./chunk-L7A3ECI2.cjs');
@@ -1055,7 +1055,7 @@ var VideoRenderer = class {
     }
     target.style.visibility = "hidden";
     const overlayParent = parent instanceof HTMLElement ? parent : document.body;
-    this.subtitleOverlay = new chunkS4WAZC2T_cjs.SubtitleOverlay(overlayParent);
+    this.subtitleOverlay = new chunkWRKO6Q42_cjs.SubtitleOverlay(overlayParent);
     this.watchTextTracks(target);
     const ctx = this.canvas.getContext("2d");
     if (!ctx) throw new Error("video renderer: failed to acquire 2D context");
@@ -1376,6 +1376,10 @@ var AudioOutput = class {
   _volume = 1;
   /** User-set muted flag. When true, gain is forced to 0. */
   _muted = false;
+  /** Playback rate. Scales the media clock and each AudioBufferSourceNode's
+   *  playbackRate so audio pitches up/down accordingly (same as native
+   *  <video>.playbackRate). Default 1. */
+  _rate = 1;
   constructor() {
     this.ctx = new AudioContext();
     this.gain = this.ctx.createGain();
@@ -1397,6 +1401,20 @@ var AudioOutput = class {
   getMuted() {
     return this._muted;
   }
+  /** Set playback rate. Scales the media clock and pitches audio output
+   *  (same as native <video>.playbackRate — speed without pitch correction).
+   *  Rebases the anchor so the clock transition is seamless. */
+  setPlaybackRate(rate) {
+    if (rate === this._rate) return;
+    const t = this.now();
+    this.mediaTimeOfAnchor = t;
+    this.ctxTimeAtAnchor = this.ctx.currentTime;
+    this.wallAnchorMs = performance.now();
+    this._rate = rate;
+  }
+  getPlaybackRate() {
+    return this._rate;
+  }
   applyGain() {
     const target = this._muted ? 0 : this._volume;
     try {
@@ -1417,12 +1435,12 @@ var AudioOutput = class {
   now() {
     if (this.noAudio) {
       if (this.state === "playing") {
-        return this.mediaTimeOfAnchor + (performance.now() - this.wallAnchorMs) / 1e3;
+        return this.mediaTimeOfAnchor + (performance.now() - this.wallAnchorMs) / 1e3 * this._rate;
       }
       return this.mediaTimeOfAnchor;
     }
     if (this.state === "playing") {
-      return this.mediaTimeOfAnchor + (this.ctx.currentTime - this.ctxTimeAtAnchor);
+      return this.mediaTimeOfAnchor + (this.ctx.currentTime - this.ctxTimeAtAnchor) * this._rate;
     }
     return this.mediaTimeOfAnchor;
   }
@@ -1474,7 +1492,8 @@ var AudioOutput = class {
     const node = this.ctx.createBufferSource();
     node.buffer = buffer;
     node.connect(this.gain);
-    let ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor);
+    if (this._rate !== 1) node.playbackRate.value = this._rate;
+    let ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor) / this._rate;
     if (ctxStart < this.ctx.currentTime) {
       this.ctxTimeAtAnchor = this.ctx.currentTime;
       this.mediaTimeOfAnchor = this.mediaTimeOfNext;
@@ -1501,6 +1520,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";
@@ -1527,6 +1550,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();
     }
@@ -2122,6 +2149,14 @@ async function createHybridSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "playbackRate", {
+    configurable: true,
+    get: () => audio.getPlaybackRate(),
+    set: (v) => {
+      audio.setPlaybackRate(v);
+      target.dispatchEvent(new Event("ratechange"));
+    }
+  });
   Object.defineProperty(target, "readyState", {
     configurable: true,
     get: () => {
@@ -2232,6 +2267,7 @@ async function createHybridSession(ctx, target, transport) {
         delete target.muted;
         delete target.readyState;
         delete target.seekable;
+        delete target.playbackRate;
       } catch {
       }
     },
@@ -2767,6 +2803,14 @@ async function createFallbackSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "playbackRate", {
+    configurable: true,
+    get: () => audio.getPlaybackRate(),
+    set: (v) => {
+      audio.setPlaybackRate(v);
+      target.dispatchEvent(new Event("ratechange"));
+    }
+  });
   Object.defineProperty(target, "readyState", {
     configurable: true,
     get: () => {
@@ -2898,6 +2942,7 @@ async function createFallbackSession(ctx, target, transport) {
         delete target.muted;
         delete target.readyState;
         delete target.seekable;
+        delete target.playbackRate;
       } catch {
       }
     },
@@ -3008,7 +3053,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
   switchingPromise = Promise.resolve();
   // Owns blob URLs created during sidecar discovery + SRT->VTT conversion.
   // Revoked at destroy() so repeated source swaps don't leak.
-  subtitleResources = new chunkS4WAZC2T_cjs.SubtitleResourceBag();
+  subtitleResources = new chunkWRKO6Q42_cjs.SubtitleResourceBag();
   // Transport config extracted from CreatePlayerOptions. Threaded to probe,
   // subtitle fetches, and strategy session creators. Not stored on MediaContext
   // because it's runtime config, not media analysis.
@@ -3054,7 +3099,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
         }
       }
       if (this.options.directory && this.options.source instanceof File) {
-        const found = await chunkS4WAZC2T_cjs.discoverSidecars(this.options.source, this.options.directory);
+        const found = await chunkWRKO6Q42_cjs.discoverSidecars(this.options.source, this.options.directory);
         for (const s of found) {
           this.subtitleResources.track(s.url);
           ctx.subtitleTracks.push({
@@ -3077,7 +3122,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
         reason: decision.reason
       });
       await this.startSession(decision.strategy, decision.reason);
-      await chunkS4WAZC2T_cjs.attachSubtitleTracks(
+      await chunkWRKO6Q42_cjs.attachSubtitleTracks(
         this.options.target,
         ctx.subtitleTracks,
         this.subtitleResources,
@@ -3506,5 +3551,5 @@ exports.NATIVE_VIDEO_CODECS = NATIVE_VIDEO_CODECS;
 exports.UnifiedPlayer = UnifiedPlayer;
 exports.classifyContext = classifyContext;
 exports.createPlayer = createPlayer;
-//# sourceMappingURL=chunk-EY6DZEDT.cjs.map
-//# sourceMappingURL=chunk-EY6DZEDT.cjs.map
+//# sourceMappingURL=chunk-37UOSAVI.cjs.map
+//# sourceMappingURL=chunk-37UOSAVI.cjs.map