avbridge 2.7.0 → 2.8.2

package/CHANGELOG.md

@@ -4,6 +4,112 @@ 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.8.2]
+
+Small ergonomics release driven by downstream `<avbridge-player>`
+consumer feedback.
+
+### Added
+
+- **Opt-in "Fit" entry in the `<avbridge-player>` settings menu.** Set
+  the new `show-fit` attribute on `<avbridge-player>` and the settings
+  menu gains a Fit section with Contain / Cover / Fill choices; picking
+  one writes the `fit` attribute (which proxies through to the inner
+  `<avbridge-video>`). Off by default — chromeless consumers don't get
+  a surprise entry.
+- **`data-visible="true|false"` on `part="toolbar-top"`.** Mirrors the
+  controls auto-hide state so slotted toolbar buttons can drive JS
+  behavior (focus management, screen-reader announcements, disabling
+  clicks) without listening to the host's `data-controls-hidden`. The
+  existing CSS fade on opacity is unchanged.
+
+## [2.8.1]
+
+Cross-browser playback validation — second slice of the v2.7.0 Playwright
+tier. Bootstrap → play → destroy lifecycle tested across Chromium,
+Firefox, and WebKit. Surfaced and fixed three real bugs along the way:
+
+### Fixed
+
+- **`<avbridge-player>` constructor violated the Custom Elements spec**
+  by setting attributes (`tabindex`, `data-toolbar-empty`) on `this`.
+  Browsers allow this when the parser constructs the element, but
+  `document.createElement("avbridge-player")` fails with "The result
+  must not have attributes" — so programmatic creation, including all
+  Playwright tests, was broken. Moved attribute writes to
+  `connectedCallback`. Caught by the new browser matrix.
+- **classify() didn't feature-detect MSE for remuxable non-native
+  containers.** On open-source Chromium (no proprietary codecs),
+  MKV+HEVC was classified as `remux` even though MSE rejected the
+  target mime — playback stalled silently. classify() now calls
+  `MediaSource.isTypeSupported()` for the remux target and gracefully
+  degrades to hybrid/fallback when it says no.
+- **Fallback strategy was loading the wrong libav variant for some
+  codecs.** `pickLibavVariant` would choose the "webcodecs" companion
+  variant (smaller, assumes the browser decodes natively) for codecs
+  like HEVC — but fallback does *full* software decode, and that
+  variant lacks HEVC's software decoder. Fallback now unconditionally
+  loads the "avbridge" variant, which is correct since we're there
+  specifically because the browser can't decode.
+
+### Added
+
+- **`tests/browser/playback.spec.ts`** — bootstrap → play → destroy per
+  fixture per browser. Asserts playback actually advances (either via
+  audio-clock `currentTime` for native/remux, or `framesPainted` for
+  canvas strategies) and that the runtime strategy after escalation
+  matches the per-browser matrix. 29 passed, 1 skipped (documented).
+- **`playbackStrategy` field on `_expectations.ts`** for codifying
+  per-browser runtime expectations distinct from initial classify
+  output. Firefox HEVC is the one skip, pending a decode-stall
+  detection follow-up.
+
+### Known deferred
+
+- **Firefox HEVC**: MSE optimistically reports `hev1.*` supported but
+  the decoder can't decode it. Audio plays, video is black. No signal
+  currently reaches escalation. Runtime decode-stall detection
+  (buffered but `currentTime` not advancing) is the right fix; tracked
+  as a follow-up, skipped in the matrix for now.
+
+## [2.8.0]
+
+Element feature release — fit mode, consumer-slotted toolbar chrome, and
+orientation-aware fullscreen.
+
+### Added
+
+- **`fit` attribute on `<avbridge-video>`.** `fit="contain|cover|fill"`
+  (also reflected as the `fit` property, with a `fitchange` event) maps to
+  `object-fit` on the inner `<video>` and the fallback canvas via a new
+  `--avbridge-fit` CSS custom property on the stage wrapper. Default
+  `contain`; invalid values fall back to `contain`. Proxied through
+  `<avbridge-player>`.
+- **Top toolbar slots on `<avbridge-player>`.** `<slot name="top-left">`
+  and `<slot name="top-right">` inside a new `part="toolbar-top"`
+  wrapper let consumers place back / title / translate buttons inside the
+  auto-hide chrome so they fade together with the bottom controls. A
+  `slotchange` listener toggles a `data-toolbar-empty` host attribute so
+  the gradient band disappears when no content is slotted. Click,
+  double-click, and tap handlers ignore events originating from slotted
+  content via `composedPath()` — so consumer buttons don't trigger
+  play/pause or seek.
+- **Orientation-aware fullscreen on `<avbridge-video>`.** On fullscreen
+  entry (including fullscreen applied to an ancestor like
+  `<avbridge-player>` whose shadow DOM hosts the video), the element
+  derives the target orientation from the video's intrinsic
+  `videoWidth`/`videoHeight` (already SAR-corrected by the browser) and
+  calls `screen.orientation.lock('landscape'|'portrait')`. Releases the
+  lock on exit. iOS Safari rejections are swallowed (iOS handles rotation
+  via `webkitEnterFullscreen` on `<video>` itself). Opt out per element
+  with the `no-orientation-lock` attribute / `noOrientationLock` property.
+
+### Notes
+
+- `<avbridge-player>` is no longer a "reserved" name — it's the
+  shipping chrome-bearing player. `<avbridge-video>` remains the bare
+  HTMLMediaElement-compatible primitive.
+
 ## [2.7.0]
 
 Cross-browser confidence release. A Playwright-based test tier now

package/README.md

@@ -329,6 +329,35 @@ automatically via `import.meta.url` in the generated chunk.
 <avbridge-video src="/video.mkv" autoplay playsinline></avbridge-video>
 ```
 
+**Two elements ship.** `<avbridge-video>` is the bare
+`HTMLMediaElement`-compatible primitive with zero UI; `<avbridge-player>`
+(from `avbridge/player-element`) wraps it with YouTube-style chrome.
+Both support:
+
+- `fit="contain|cover|fill"` — how the video fills the element's box
+  (maps to `object-fit`; default `contain`). Fires a `fitchange` event.
+- `no-orientation-lock` — opt out of the default behavior that locks
+  `screen.orientation` to the video's intrinsic aspect on fullscreen
+  entry (landscape video → landscape, portrait video → portrait). Safe
+  on iOS / desktop — the lock call is swallowed where unsupported.
+
+`<avbridge-player>` also exposes `top-left` and `top-right` slots
+inside its auto-hiding top chrome for consumer buttons (back, title,
+translate, etc.), and an opt-in `show-fit` attribute that adds a
+Contain / Cover / Fill entry to the settings menu:
+
+```html
+<avbridge-player src="/video.mkv" fit="cover" show-fit>
+  <button slot="top-left">← Back</button>
+  <button slot="top-right">Translate</button>
+</avbridge-player>
+```
+
+The toolbar-top `part` exposes a `data-visible="true|false"`
+attribute mirroring the controls auto-hide state — useful if slotted
+buttons need to drive JS behavior (focus, announcements) in sync with
+the fade, not just CSS opacity.
+
 This is a second tsup entry (`dist/element-browser.js`) that inlines
 mediabunny + libavjs-webcodecs-bridge into a single ~1.3 MB file with
 zero bare specifiers at runtime. Perfect for self-hosted tools or static
@@ -378,6 +407,12 @@ LGPL compliance — see [`NOTICE.md`](./NOTICE.md) and
 
 ## Demos
 
+Try it live: **https://keishi.github.io/avbridge/** — player + converter
+running against the latest release, served from GitHub Pages with the
+COOP/COEP headers needed for SharedArrayBuffer.
+
+Or run locally:
+
 ```bash
 npm install
 npm run demo

package/dist/{chunk-6SOFJV44.cjs → chunk-IUSFLVLJ.cjs}

@@ -217,6 +217,22 @@ function classifyContext(ctx) {
     };
   }
   if (REMUXABLE_CONTAINERS.has(ctx.container)) {
+    const mime = mp4MimeFor(video, audio);
+    if (mime && typeof MediaSource !== "undefined" && !mseSupports(mime)) {
+      if (webCodecsAvailable()) {
+        return {
+          class: "HYBRID_CANDIDATE",
+          strategy: "hybrid",
+          reason: `${ctx.container} container with ${video.codec}${audio ? "/" + audio.codec : ""}; MSE rejects the remux target mime \u2014 routing to WebCodecs hardware decode`,
+          fallbackChain: ["fallback"]
+        };
+      }
+      return {
+        class: "FALLBACK_REQUIRED",
+        strategy: "fallback",
+        reason: `${ctx.container} container with ${video.codec}${audio ? "/" + audio.codec : ""}; MSE rejects the remux target mime and WebCodecs is unavailable \u2014 falling back to WASM decode`
+      };
+    }
     return {
       class: "REMUX_CANDIDATE",
       strategy: "remux",
@@ -1008,7 +1024,7 @@ var VideoRenderer = class {
       this.resolveFirstFrame = resolve;
     });
     this.canvas = document.createElement("canvas");
-    this.canvas.style.cssText = "position:absolute;left:0;top:0;width:100%;height:100%;background:black;object-fit:contain;";
+    this.canvas.style.cssText = "position:absolute;left:0;top:0;width:100%;height:100%;background:black;object-fit:var(--avbridge-fit, contain);";
     const parent = target.parentElement ?? target.parentNode;
     if (parent && parent instanceof HTMLElement) {
       if (getComputedStyle(parent).position === "static") {
@@ -2182,7 +2198,7 @@ async function createHybridSession(ctx, target, transport) {
 
 // src/strategies/fallback/decoder.ts
 async function startDecoder(opts) {
-  const variant = chunkF3LQJKXK_cjs.pickLibavVariant(opts.context);
+  const variant = "avbridge";
   const libav = await chunkG4APZMCP_cjs.loadLibav(variant);
   const bridge = await loadBridge2();
   const { prepareLibavInput } = await import('./libav-http-reader-AZLE7YFS.cjs');
@@ -2238,9 +2254,8 @@ async function startDecoder(opts) {
       videoStream ? `video: ${opts.context.videoTracks[0]?.codec ?? "unknown"}` : null,
       audioStream ? `audio: ${opts.context.audioTracks[0]?.codec ?? "unknown"}` : null
     ].filter(Boolean).join(", ");
-    const hint = variant === "webcodecs" ? ` The "${variant}" libav variant does not include software decoders for these codecs. Try the custom "avbridge" variant (scripts/build-libav.sh) for broader codec support, or use a lighter strategy (native, remux, hybrid) instead.` : "";
     throw new Error(
-      `fallback decoder: could not initialize any libav decoders (${codecs}).${hint}`
+      `fallback decoder: could not initialize any libav decoders (${codecs}). The "${variant}" libav variant lacks software decoders for these codecs \u2014 rebuild with scripts/build-libav.sh including the missing decoder, or use a lighter strategy (native, remux, hybrid) instead.`
     );
   }
   let bsfCtx = null;
@@ -3366,5 +3381,5 @@ exports.NATIVE_VIDEO_CODECS = NATIVE_VIDEO_CODECS;
 exports.UnifiedPlayer = UnifiedPlayer;
 exports.classifyContext = classifyContext;
 exports.createPlayer = createPlayer;
-//# sourceMappingURL=chunk-6SOFJV44.cjs.map
-//# sourceMappingURL=chunk-6SOFJV44.cjs.map
+//# sourceMappingURL=chunk-IUSFLVLJ.cjs.map
+//# sourceMappingURL=chunk-IUSFLVLJ.cjs.map