avbridge 2.6.0 → 2.8.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DGXeCNfD.cjs';
-export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DGXeCNfD.cjs';
+import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DXEKOky8.cjs';
+export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DXEKOky8.cjs';
 
 /**
  * Codecs we know `<video>` and MSE support across modern desktop + Android.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DGXeCNfD.js';
-export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DGXeCNfD.js';
+import { A as AudioCodec, V as VideoCodec, M as MediaContext, C as Classification, a as MediaInput, T as TransportConfig, b as ConvertOptions, c as ConvertResult, d as TranscodeOptions } from './player-DXEKOky8.js';
+export { e as AudioTrackInfo, f as ContainerKind, g as CreatePlayerOptions, D as DiagnosticsSnapshot, F as FetchFn, H as HardwareAccelerationHint, O as OutputAudioCodec, h as OutputFormat, i as OutputVideoCodec, P as PlaybackSession, j as PlayerEventMap, k as PlayerEventName, l as Plugin, m as ProgressInfo, S as StrategyClass, n as StrategyName, o as SubtitleTrackInfo, p as TranscodeQuality, U as UnifiedPlayer, q as VideoTrackInfo, r as createPlayer } from './player-DXEKOky8.js';
 
 /**
  * Codecs we know `<video>` and MSE support across modern desktop + Android.

package/dist/index.js

@@ -1,6 +1,6 @@
 import { mimeForFormat, generateFilename, createOutputFormat } from './chunk-SMH6IOP2.js';
 export { remux } from './chunk-SMH6IOP2.js';
-export { FALLBACK_AUDIO_CODECS, FALLBACK_VIDEO_CODECS, NATIVE_AUDIO_CODECS, NATIVE_VIDEO_CODECS, UnifiedPlayer, classifyContext as classify, createPlayer } from './chunk-OGYHFY6K.js';
+export { FALLBACK_AUDIO_CODECS, FALLBACK_VIDEO_CODECS, NATIVE_AUDIO_CODECS, NATIVE_VIDEO_CODECS, UnifiedPlayer, classifyContext as classify, createPlayer } from './chunk-JSQOBUQB.js';
 export { srtToVtt } from './chunk-5KVLE6YI.js';
 import { probe, buildMediabunnySourceFromInput } from './chunk-SR3MPV4D.js';
 export { probe } from './chunk-SR3MPV4D.js';

package/dist/{player-DGXeCNfD.d.cts → player-DXEKOky8.d.cts}

@@ -293,6 +293,9 @@ interface AvbridgeVideoElementEventMap {
         buffered: TimeRanges;
     }>;
     loadstart: CustomEvent<Record<string, never>>;
+    fitchange: CustomEvent<{
+        fit: "contain" | "cover" | "fill";
+    }>;
 }
 /** Target output format for conversion functions. */
 type OutputFormat = "mp4" | "webm" | "mkv";

package/dist/{player-DGXeCNfD.d.ts → player-DXEKOky8.d.ts}

@@ -293,6 +293,9 @@ interface AvbridgeVideoElementEventMap {
         buffered: TimeRanges;
     }>;
     loadstart: CustomEvent<Record<string, never>>;
+    fitchange: CustomEvent<{
+        fit: "contain" | "cover" | "fill";
+    }>;
 }
 /** Target output format for conversion functions. */
 type OutputFormat = "mp4" | "webm" | "mkv";

package/dist/player.cjs

@@ -496,6 +496,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",
@@ -1239,7 +1255,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") {
@@ -2582,7 +2598,7 @@ async function createHybridSession(ctx, target, transport) {
 
 // src/strategies/fallback/decoder.ts
 async function startDecoder(opts) {
-  const variant = pickLibavVariant(opts.context);
+  const variant = "avbridge";
   const libav = await chunkNNVOHKXJ_cjs.loadLibav(variant);
   const bridge = await loadBridge2();
   const { prepareLibavInput } = await import('./libav-http-reader-AZLE7YFS.cjs');
@@ -2638,9 +2654,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;
@@ -3767,6 +3782,8 @@ var PREFERRED_STRATEGY_VALUES = /* @__PURE__ */ new Set([
   "hybrid",
   "fallback"
 ]);
+var FIT_VALUES = /* @__PURE__ */ new Set(["contain", "cover", "fill"]);
+var DEFAULT_FIT = "contain";
 var FORWARDED_VIDEO_EVENTS = [
   "loadstart",
   "loadedmetadata",
@@ -3801,7 +3818,9 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
     "crossorigin",
     "disableremoteplayback",
     "diagnostics",
-    "preferstrategy"
+    "preferstrategy",
+    "fit",
+    "no-orientation-lock"
   ];
   // ── Internal state ─────────────────────────────────────────────────────
   /** The shadow DOM `<video>` element that strategies render into. */
@@ -3853,23 +3872,38 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
    * native fails.
    */
   _preferredStrategy = "auto";
+  /** Current fit mode. Applied to the inner `<video>` via object-fit, and
+   *  to the fallback canvas via the `--avbridge-fit` CSS custom property on
+   *  the stage wrapper (see `src/strategies/fallback/video-renderer.ts`). */
+  _fit = DEFAULT_FIT;
+  /** The stage wrapper — the element the canvas attaches into, and where
+   *  the `--avbridge-fit` CSS custom property lives. */
+  _stageEl;
   /** Set if currentTime was assigned before the player was ready. */
   _pendingSeek = null;
   /** Set if play() was called before the player was ready. */
   _pendingPlay = false;
   /** MutationObserver tracking light-DOM `<track>` children. */
   _trackObserver = null;
+  /** Document-level fullscreenchange handler — installed while connected so
+   *  the element can lock/unlock screen orientation to match the video's
+   *  intrinsic aspect. */
+  _fullscreenChangeHandler = null;
+  /** True if we successfully called screen.orientation.lock() on the last
+   *  fullscreen entry. Used to know whether to unlock on exit. */
+  _orientationLocked = false;
   // ── Construction & lifecycle ───────────────────────────────────────────
   constructor() {
     super();
     const root = this.attachShadow({ mode: "open" });
     const stage = document.createElement("div");
     stage.setAttribute("part", "stage");
-    stage.style.cssText = "position:relative;width:100%;height:100%;display:block;";
+    stage.style.cssText = `position:relative;width:100%;height:100%;display:block;--avbridge-fit:${DEFAULT_FIT};`;
     root.appendChild(stage);
+    this._stageEl = stage;
     this._videoEl = document.createElement("video");
     this._videoEl.setAttribute("part", "video");
-    this._videoEl.style.cssText = "width:100%;height:100%;display:block;background:#000;";
+    this._videoEl.style.cssText = `width:100%;height:100%;display:block;background:#000;object-fit:var(--avbridge-fit, ${DEFAULT_FIT});`;
     this._videoEl.playsInline = true;
     stage.appendChild(this._videoEl);
     this._videoEl.addEventListener("progress", () => {
@@ -3890,6 +3924,10 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
       this._trackObserver = new MutationObserver(() => this._syncTextTracks());
       this._trackObserver.observe(this, { childList: true, subtree: false });
     }
+    if (!this._fullscreenChangeHandler) {
+      this._fullscreenChangeHandler = () => this._onFullscreenChange();
+      document.addEventListener("fullscreenchange", this._fullscreenChangeHandler);
+    }
     const source = this._activeSource();
     if (source != null) {
       void this._bootstrap(source);
@@ -3901,6 +3939,11 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
       this._trackObserver.disconnect();
       this._trackObserver = null;
     }
+    if (this._fullscreenChangeHandler) {
+      document.removeEventListener("fullscreenchange", this._fullscreenChangeHandler);
+      this._fullscreenChangeHandler = null;
+    }
+    this._releaseOrientationLock();
     this._bootstrapId++;
     void this._teardown();
   }
@@ -3934,6 +3977,14 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
           this._preferredStrategy = "auto";
         }
         break;
+      case "fit": {
+        const next = newValue && FIT_VALUES.has(newValue) ? newValue : DEFAULT_FIT;
+        if (next === this._fit) break;
+        this._fit = next;
+        this._stageEl.style.setProperty("--avbridge-fit", next);
+        this._dispatch("fitchange", { fit: next });
+        break;
+      }
     }
   }
   // ── Source handling ────────────────────────────────────────────────────
@@ -4175,6 +4226,13 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
     if (value) this.setAttribute("diagnostics", "");
     else this.removeAttribute("diagnostics");
   }
+  get fit() {
+    return this._fit;
+  }
+  set fit(value) {
+    if (!FIT_VALUES.has(value)) return;
+    this.setAttribute("fit", value);
+  }
   get preferredStrategy() {
     return this._preferredStrategy;
   }
@@ -4348,6 +4406,87 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
       }
     );
   }
+  /**
+   * Disable the automatic `screen.orientation.lock()` that runs on
+   * fullscreen entry. Set when you want to honor the device's native
+   * auto-rotate instead of matching the video's intrinsic orientation.
+   */
+  get noOrientationLock() {
+    return this.hasAttribute("no-orientation-lock");
+  }
+  set noOrientationLock(value) {
+    if (value) this.setAttribute("no-orientation-lock", "");
+    else this.removeAttribute("no-orientation-lock");
+  }
+  // ── Fullscreen orientation lock ────────────────────────────────────────
+  /** Called whenever `document.fullscreenchange` fires. If this element (or
+   *  any of its ancestors) is now fullscreen, derive the target orientation
+   *  from the video's intrinsic size and call `screen.orientation.lock()`.
+   *  On exit, release the lock we took. iOS Safari rejects `lock()` — we
+   *  swallow the rejection so nothing breaks on that path. */
+  _onFullscreenChange() {
+    if (this._destroyed) return;
+    const fsEl = document.fullscreenElement;
+    const nowFullscreen = fsEl != null && this._isInsideOrEquals(fsEl);
+    if (nowFullscreen && !this._orientationLocked) {
+      if (this.noOrientationLock) return;
+      const target = this._desiredOrientation();
+      if (!target) return;
+      void this._lockOrientation(target);
+    } else if (!nowFullscreen && this._orientationLocked) {
+      this._releaseOrientationLock();
+    }
+  }
+  /** Walk composed-tree ancestors to see if `target` is this element or
+   *  any ancestor across shadow boundaries. `Node.contains()` can't cross
+   *  shadow roots, so when `<avbridge-player>` (the fullscreen element)
+   *  hosts this `<avbridge-video>` inside its shadow DOM, `contains()`
+   *  returns false. */
+  _isInsideOrEquals(target) {
+    let node = this;
+    while (node) {
+      if (node === target) return true;
+      const parent = node.parentNode;
+      if (parent instanceof ShadowRoot) node = parent.host;
+      else node = parent;
+    }
+    return false;
+  }
+  /** Derive "landscape" / "portrait" from the intrinsic video dimensions.
+   *  Returns null when dimensions aren't known yet or the video is square.
+   *  Uses `videoWidth` / `videoHeight` from the inner `<video>`, which the
+   *  browser sets to the display-aspect-corrected size (so anamorphic
+   *  content is judged by its display aspect, not pixel aspect). */
+  _desiredOrientation() {
+    const w = this._videoEl.videoWidth;
+    const h = this._videoEl.videoHeight;
+    if (!w || !h) return null;
+    if (w === h) return null;
+    return w > h ? "landscape" : "portrait";
+  }
+  /** Attempt to lock screen orientation. Swallows rejections — iOS Safari
+   *  doesn't implement `lock()`, and desktop / non-fullscreen contexts will
+   *  reject too. Records success so we know whether to unlock on exit. */
+  async _lockOrientation(target) {
+    const so = screen.orientation;
+    if (!so || typeof so.lock !== "function") return;
+    try {
+      await so.lock(target);
+      this._orientationLocked = true;
+    } catch {
+    }
+  }
+  _releaseOrientationLock() {
+    if (!this._orientationLocked) return;
+    this._orientationLocked = false;
+    const so = screen.orientation;
+    if (so && typeof so.unlock === "function") {
+      try {
+        so.unlock();
+      } catch {
+      }
+    }
+  }
   // ── Public methods ─────────────────────────────────────────────────────
   /** Force a (re-)bootstrap if a source is currently set. */
   async load() {
@@ -4607,6 +4746,50 @@ var PLAYER_STYLES = (
 
 :host([data-controls-hidden]) { cursor: none; }
 
+/* \u2500\u2500 Top toolbar (slotted consumer chrome) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+   Two named slots (top-left, top-right) let consumers place back / title /
+   translate buttons inside the auto-hide chrome. Wrapper has
+   pointer-events:none so empty slots don't block container clicks; each
+   side re-enables pointer-events so real buttons remain interactive. */
+
+.avp-toolbar-top {
+  position: absolute;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 5;
+  padding: 8px 12px 24px;
+  background: linear-gradient(rgba(0, 0, 0, 0.6), transparent);
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 8px;
+  opacity: 1;
+  pointer-events: none;
+  transition: opacity 0.25s;
+}
+
+.avp-toolbar-top-left,
+.avp-toolbar-top-right {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  pointer-events: auto;
+}
+
+.avp-toolbar-top-right { margin-left: auto; }
+
+/* Hide the gradient band when no consumer has slotted anything \u2014 we
+   toggle data-toolbar-empty from JS via slotchange. */
+:host([data-toolbar-empty]) .avp-toolbar-top {
+  background: none;
+}
+
+:host([data-controls-hidden]) .avp-toolbar-top {
+  opacity: 0;
+  pointer-events: none;
+}
+
 /* \u2500\u2500 Seek bar \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 */
 
 .avp-seek {
@@ -4958,7 +5141,8 @@ var PROXY_ATTRIBUTES = [
   "playsinline",
   "crossorigin",
   "disableremoteplayback",
-  "preferstrategy"
+  "preferstrategy",
+  "fit"
 ];
 var AvbridgePlayerElement = class extends HTMLElement {
   static observedAttributes = [...PROXY_ATTRIBUTES];
@@ -4996,6 +5180,8 @@ var AvbridgePlayerElement = class extends HTMLElement {
   _statsEl;
   _statsInterval = null;
   _eventCleanup = [];
+  _updateToolbarEmpty = () => {
+  };
   // ── Constructor ────────────────────────────────────────────────────────
   constructor() {
     super();
@@ -5019,12 +5205,23 @@ var AvbridgePlayerElement = class extends HTMLElement {
     this._statsEl = shadow.querySelector(".avp-stats");
     this._rippleLeft = shadow.querySelector(".avp-ripple-left");
     this._rippleRight = shadow.querySelector(".avp-ripple-right");
+    const slots = shadow.querySelectorAll('slot[name="top-left"], slot[name="top-right"]');
+    this._updateToolbarEmpty = () => {
+      const hasContent = Array.from(slots).some((s) => s.assignedNodes({ flatten: true }).length > 0);
+      if (hasContent) this.removeAttribute("data-toolbar-empty");
+      else this.setAttribute("data-toolbar-empty", "");
+    };
+    for (const s of slots) s.addEventListener("slotchange", this._updateToolbarEmpty);
     this._bindEvents();
   }
   _template() {
     return `
 <div part="container" class="avp">
   <avbridge-video part="video"></avbridge-video>
+  <div part="toolbar-top" class="avp-toolbar-top">
+    <div part="toolbar-top-left" class="avp-toolbar-top-left"><slot name="top-left"></slot></div>
+    <div part="toolbar-top-right" class="avp-toolbar-top-right"><slot name="top-right"></slot></div>
+  </div>
   <div part="overlay" class="avp-overlay">
     <button class="avp-overlay-btn" aria-label="Play">${ICON_PLAY}</button>
     <div class="avp-spinner"></div>
@@ -5177,13 +5374,14 @@ var AvbridgePlayerElement = class extends HTMLElement {
       });
     });
     on(this, "keydown", (e) => this._onKeydown(e));
-    if (!this.hasAttribute("tabindex")) {
-      this.setAttribute("tabindex", "0");
-    }
   }
   // ── Lifecycle ──────────────────────────────────────────────────────────
   connectedCallback() {
     this._setState("idle");
+    if (!this.hasAttribute("tabindex")) {
+      this.setAttribute("tabindex", "0");
+    }
+    this._updateToolbarEmpty();
   }
   disconnectedCallback() {
     this._clearTimers();
@@ -5445,8 +5643,19 @@ 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 if the event's composed path passes through consumer-slotted toolbar
+   *  content. Slotted content lives in the light DOM so `.closest(".avp-toolbar-top")`
+   *  on the event target won't find the shadow-DOM wrapper — `composedPath()`
+   *  does. */
+  _isToolbarEvent(e) {
+    for (const node of e.composedPath()) {
+      if (node instanceof HTMLElement && node.classList.contains("avp-toolbar-top")) return true;
+    }
+    return false;
+  }
   _onContainerClick(e) {
     if (e.target.closest?.(".avp-controls, .avp-settings, .avp-overlay-btn")) return;
+    if (this._isToolbarEvent(e)) return;
     if (this._lastPointerTypeWasTouch) {
       this._lastPointerTypeWasTouch = false;
       return;
@@ -5462,6 +5671,7 @@ var AvbridgePlayerElement = class extends HTMLElement {
   }
   _onContainerDblClick(e) {
     if (e.target.closest?.(".avp-controls, .avp-settings")) return;
+    if (this._isToolbarEvent(e)) return;
     if (this._tapTimer) {
       clearTimeout(this._tapTimer);
       this._tapTimer = null;
@@ -5483,6 +5693,7 @@ var AvbridgePlayerElement = class extends HTMLElement {
     if (e.pointerType !== "touch") return;
     this._lastPointerTypeWasTouch = true;
     if (e.target.closest?.(".avp-controls, .avp-settings, .avp-overlay-btn")) return;
+    if (this._isToolbarEvent(e)) return;
     const now = Date.now();
     if (now - this._lastTapTime < 300) {
       if (this._tapTimer) {