avbridge 2.2.1 → 2.5.0

package/dist/{chunk-DMWARSEF.js → chunk-KY2GPCT7.js}

@@ -1,217 +1,9 @@
-import { normalizeSource, sniffNormalizedSource } from './chunk-ILKDNBSE.js';
+import { SubtitleResourceBag, discoverSidecars, attachSubtitleTracks, SubtitleOverlay } from './chunk-5KVLE6YI.js';
+import { probe, avbridgeVideoToMediabunny, buildMediabunnySourceFromInput, avbridgeAudioToMediabunny } from './chunk-SR3MPV4D.js';
+import { AvbridgeError, ERR_ALL_STRATEGIES_EXHAUSTED, ERR_PLAYER_NOT_READY, ERR_MSE_NOT_SUPPORTED, ERR_MSE_CODEC_NOT_SUPPORTED } from './chunk-CPJLFFCC.js';
+import { sanitizePacketTimestamp, sanitizeFrameTimestamp, libavFrameToInterleavedFloat32 } from './chunk-X2K3GIWE.js';
 import { dbg, loadLibav } from './chunk-5DMTJVIU.js';
-import { pickLibavVariant } from './chunk-J5MCMN3S.js';
-
-// src/probe/mediabunny.ts
-async function probeWithMediabunny(source, sniffedContainer) {
-  const mb = await import('mediabunny');
-  const input = new mb.Input({
-    source: await buildMediabunnySource(mb, source),
-    formats: mb.ALL_FORMATS
-  });
-  const allTracks = await input.getTracks();
-  const duration = await safeNumber(() => input.computeDuration());
-  const videoTracks = [];
-  const audioTracks = [];
-  for (const track of allTracks) {
-    if (track.isVideoTrack()) {
-      const codecParam = await safe(() => track.getCodecParameterString());
-      videoTracks.push({
-        id: track.id,
-        codec: mediabunnyVideoToAvbridge(track.codec),
-        width: track.displayWidth ?? track.codedWidth ?? 0,
-        height: track.displayHeight ?? track.codedHeight ?? 0,
-        codecString: codecParam ?? void 0
-      });
-    } else if (track.isAudioTrack()) {
-      const codecParam = await safe(() => track.getCodecParameterString());
-      audioTracks.push({
-        id: track.id,
-        codec: mediabunnyAudioToAvbridge(track.codec),
-        channels: track.numberOfChannels ?? 0,
-        sampleRate: track.sampleRate ?? 0,
-        language: track.languageCode,
-        codecString: codecParam ?? void 0
-      });
-    }
-  }
-  const format = await safe(() => input.getFormat());
-  const container = resolveContainer(format?.name, sniffedContainer);
-  return {
-    source: source.original,
-    name: source.name,
-    byteLength: source.byteLength,
-    container,
-    videoTracks,
-    audioTracks,
-    subtitleTracks: [],
-    probedBy: "mediabunny",
-    duration
-  };
-}
-async function buildMediabunnySource(mb, source) {
-  if (source.kind === "url") {
-    return new mb.UrlSource(source.url);
-  }
-  return new mb.BlobSource(source.blob);
-}
-async function buildMediabunnySourceFromInput(mb, source) {
-  if (typeof source === "string") return new mb.UrlSource(source);
-  if (source instanceof URL) return new mb.UrlSource(source.toString());
-  if (source instanceof Blob) return new mb.BlobSource(source);
-  if (source instanceof ArrayBuffer) return new mb.BlobSource(new Blob([source]));
-  if (source instanceof Uint8Array) return new mb.BlobSource(new Blob([source]));
-  throw new TypeError("unsupported source type for mediabunny");
-}
-function resolveContainer(formatName, sniffed) {
-  const name = (formatName ?? "").toLowerCase();
-  if (name.includes("matroska") || name.includes("mkv")) return "mkv";
-  if (name.includes("webm")) return "webm";
-  if (name.includes("mp4") || name.includes("isom")) return "mp4";
-  if (name.includes("mov") || name.includes("quicktime")) return "mov";
-  if (name.includes("ogg")) return "ogg";
-  if (name.includes("wav")) return "wav";
-  if (name.includes("flac")) return "flac";
-  if (name.includes("mp3")) return "mp3";
-  if (name.includes("adts") || name.includes("aac")) return "adts";
-  if (name.includes("mpegts") || name.includes("mpeg-ts") || name.includes("transport")) return "mpegts";
-  return sniffed;
-}
-function mediabunnyVideoToAvbridge(c) {
-  switch (c) {
-    case "avc":
-      return "h264";
-    case "hevc":
-      return "h265";
-    case "vp8":
-      return "vp8";
-    case "vp9":
-      return "vp9";
-    case "av1":
-      return "av1";
-    default:
-      return c ? c : "unknown";
-  }
-}
-function avbridgeVideoToMediabunny(c) {
-  switch (c) {
-    case "h264":
-      return "avc";
-    case "h265":
-      return "hevc";
-    case "vp8":
-      return "vp8";
-    case "vp9":
-      return "vp9";
-    case "av1":
-      return "av1";
-    default:
-      return null;
-  }
-}
-function mediabunnyAudioToAvbridge(c) {
-  switch (c) {
-    case "aac":
-      return "aac";
-    case "mp3":
-      return "mp3";
-    case "opus":
-      return "opus";
-    case "vorbis":
-      return "vorbis";
-    case "flac":
-      return "flac";
-    case "ac3":
-      return "ac3";
-    case "eac3":
-      return "eac3";
-    default:
-      return c ? c : "unknown";
-  }
-}
-function avbridgeAudioToMediabunny(c) {
-  switch (c) {
-    case "aac":
-      return "aac";
-    case "mp3":
-      return "mp3";
-    case "opus":
-      return "opus";
-    case "vorbis":
-      return "vorbis";
-    case "flac":
-      return "flac";
-    case "ac3":
-      return "ac3";
-    case "eac3":
-      return "eac3";
-    default:
-      return null;
-  }
-}
-async function safeNumber(fn) {
-  try {
-    const v = await fn();
-    return typeof v === "number" && Number.isFinite(v) ? v : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function safe(fn) {
-  try {
-    return await fn();
-  } catch {
-    return void 0;
-  }
-}
-
-// src/probe/index.ts
-var MEDIABUNNY_CONTAINERS = /* @__PURE__ */ new Set([
-  "mp4",
-  "mov",
-  "mkv",
-  "webm",
-  "ogg",
-  "wav",
-  "mp3",
-  "flac",
-  "adts",
-  "mpegts"
-]);
-async function probe(source) {
-  const normalized = await normalizeSource(source);
-  const sniffed = await sniffNormalizedSource(normalized);
-  if (MEDIABUNNY_CONTAINERS.has(sniffed)) {
-    try {
-      return await probeWithMediabunny(normalized, sniffed);
-    } catch (mediabunnyErr) {
-      console.warn(
-        `[avbridge] mediabunny rejected ${sniffed} file, falling back to libav:`,
-        mediabunnyErr.message
-      );
-      try {
-        const { probeWithLibav } = await import('./avi-GCGM7OJI.js');
-        return await probeWithLibav(normalized, sniffed);
-      } catch (libavErr) {
-        const mbMsg = mediabunnyErr.message || String(mediabunnyErr);
-        const lvMsg = libavErr instanceof Error ? libavErr.message : String(libavErr);
-        throw new Error(
-          `failed to probe ${sniffed} file. mediabunny: ${mbMsg}. libav fallback: ${lvMsg}.`
-        );
-      }
-    }
-  }
-  try {
-    const { probeWithLibav } = await import('./avi-GCGM7OJI.js');
-    return await probeWithLibav(normalized, sniffed);
-  } catch (err) {
-    const inner = err instanceof Error ? err.message : String(err);
-    console.error("[avbridge] libav probe failed for", sniffed, "file:", err);
-    throw new Error(
-      sniffed === "unknown" ? `unable to probe source: container could not be identified, and the libav.js fallback also failed: ${inner || "(no message \u2014 see browser console for the original error)"}` : `${sniffed.toUpperCase()} files require libav.js, which failed to load: ${inner || "(no message \u2014 see browser console for the original error)"}`
-    );
-  }
-}
+import { pickLibavVariant } from './chunk-5YAWWKA3.js';
 
 // src/util/codec-strings.ts
 function videoCodecString(track) {
@@ -309,7 +101,9 @@ var FALLBACK_AUDIO_CODECS = /* @__PURE__ */ new Set([
   "ra_144",
   "ra_288",
   "sipr",
-  "atrac3"
+  "atrac3",
+  "dts",
+  "truehd"
 ]);
 var NATIVE_CONTAINERS = /* @__PURE__ */ new Set([
   "mp4",
@@ -371,7 +165,16 @@ function classifyContext(ctx) {
       reason: `video codec "${video.codec}" has no browser decoder; WASM fallback required`
     };
   }
-  if (audio && FALLBACK_AUDIO_CODECS.has(audio.codec)) {
+  const audioNeedsFallback = audio && (FALLBACK_AUDIO_CODECS.has(audio.codec) || !NATIVE_AUDIO_CODECS.has(audio.codec));
+  if (audioNeedsFallback) {
+    if (NATIVE_VIDEO_CODECS.has(video.codec) && webCodecsAvailable()) {
+      return {
+        class: "HYBRID_CANDIDATE",
+        strategy: "hybrid",
+        reason: `video "${video.codec}" is hardware-decodable via WebCodecs; audio "${audio.codec}" decoded in software by libav`,
+        fallbackChain: ["fallback"]
+      };
+    }
     return {
       class: "FALLBACK_REQUIRED",
       strategy: "fallback",
@@ -451,36 +254,6 @@ function isRiskyNative(video) {
   return false;
 }
 
-// src/subtitles/srt.ts
-function srtToVtt(srt) {
-  if (srt.charCodeAt(0) === 65279) srt = srt.slice(1);
-  const normalized = srt.replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim();
-  const blocks = normalized.split(/\n{2,}/);
-  const out = ["WEBVTT", ""];
-  for (const block of blocks) {
-    const lines = block.split("\n");
-    if (lines.length > 0 && /^\d+$/.test(lines[0].trim())) {
-      lines.shift();
-    }
-    if (lines.length === 0) continue;
-    const timing = lines.shift();
-    const vttTiming = convertTiming(timing);
-    if (!vttTiming) continue;
-    out.push(vttTiming);
-    for (const l of lines) out.push(l);
-    out.push("");
-  }
-  return out.join("\n");
-}
-function convertTiming(line) {
-  const m = /^(\d{1,2}):(\d{2}):(\d{2})[,.](\d{1,3})\s*-->\s*(\d{1,2}):(\d{2}):(\d{2})[,.](\d{1,3})(.*)$/.exec(
-    line.trim()
-  );
-  if (!m) return null;
-  const fmt = (h, mm, s, ms) => `${h.padStart(2, "0")}:${mm}:${s}.${ms.padEnd(3, "0").slice(0, 3)}`;
-  return `${fmt(m[1], m[2], m[3], m[4])} --> ${fmt(m[5], m[6], m[7], m[8])}${m[9] ?? ""}`;
-}
-
 // src/events.ts
 var TypedEmitter = class {
   listeners = {};
@@ -686,7 +459,7 @@ async function createNativeSession(context, video) {
     },
     async setAudioTrack(id) {
       const tracks = video.audioTracks;
-      if (!tracks) return;
+      if (!tracks || tracks.length === 0) return;
       for (let i = 0; i < tracks.length; i++) {
         tracks[i].enabled = tracks[i].id === String(id) || i === id;
       }
@@ -738,10 +511,18 @@ var MseSink = class {
   constructor(options) {
     this.options = options;
     if (typeof MediaSource === "undefined") {
-      throw new Error("MSE not supported in this environment");
+      throw new AvbridgeError(
+        ERR_MSE_NOT_SUPPORTED,
+        "MediaSource Extensions (MSE) are not supported in this environment.",
+        "MSE is required for the remux strategy. Use a browser that supports MSE, or try the fallback strategy."
+      );
     }
     if (!MediaSource.isTypeSupported(options.mime)) {
-      throw new Error(`MSE does not support MIME "${options.mime}" \u2014 cannot remux`);
+      throw new AvbridgeError(
+        ERR_MSE_CODEC_NOT_SUPPORTED,
+        `This browser's MSE does not support "${options.mime}".`,
+        "The codec combination can't be played via remux in this browser. The player will try the next strategy automatically."
+      );
     }
     this.mediaSource = new MediaSource();
     this.objectUrl = URL.createObjectURL(this.mediaSource);
@@ -926,30 +707,49 @@ var MseSink = class {
 async function createRemuxPipeline(ctx, video) {
   const mb = await import('mediabunny');
   const videoTrackInfo = ctx.videoTracks[0];
-  const audioTrackInfo = ctx.audioTracks[0];
   if (!videoTrackInfo) throw new Error("remux: source has no video track");
   const mbVideoCodec = avbridgeVideoToMediabunny(videoTrackInfo.codec);
   if (!mbVideoCodec) {
     throw new Error(`remux: video codec "${videoTrackInfo.codec}" is not supported by mediabunny output`);
   }
-  const mbAudioCodec = audioTrackInfo ? avbridgeAudioToMediabunny(audioTrackInfo.codec) : null;
   const input = new mb.Input({
     source: await buildMediabunnySourceFromInput(mb, ctx.source),
     formats: mb.ALL_FORMATS
   });
   const allTracks = await input.getTracks();
   const inputVideo = allTracks.find((t) => t.id === videoTrackInfo.id && t.isVideoTrack());
-  const inputAudio = audioTrackInfo ? allTracks.find((t) => t.id === audioTrackInfo.id && t.isAudioTrack()) : null;
   if (!inputVideo || !inputVideo.isVideoTrack()) {
     throw new Error("remux: video track not found in input");
   }
-  if (audioTrackInfo && (!inputAudio || !inputAudio.isAudioTrack())) {
-    throw new Error("remux: audio track not found in input");
-  }
   const videoConfig = await inputVideo.getDecoderConfig();
-  const audioConfig = inputAudio && inputAudio.isAudioTrack() ? await inputAudio.getDecoderConfig() : null;
   const videoSink = new mb.EncodedPacketSink(inputVideo);
-  const audioSink = inputAudio?.isAudioTrack() ? new mb.EncodedPacketSink(inputAudio) : null;
+  let selectedAudioTrackId = ctx.audioTracks[0]?.id ?? null;
+  let inputAudio = null;
+  let mbAudioCodec = null;
+  let audioSink = null;
+  let audioConfig = null;
+  async function rebuildAudio() {
+    if (selectedAudioTrackId == null) {
+      inputAudio = null;
+      mbAudioCodec = null;
+      audioSink = null;
+      audioConfig = null;
+      return;
+    }
+    const trackInfo = ctx.audioTracks.find((t) => t.id === selectedAudioTrackId);
+    if (!trackInfo) {
+      throw new Error(`remux: no audio track with id ${selectedAudioTrackId}`);
+    }
+    const newInput = allTracks.find((t) => t.id === trackInfo.id && t.isAudioTrack());
+    if (!newInput || !newInput.isAudioTrack()) {
+      throw new Error("remux: audio track not found in input");
+    }
+    inputAudio = newInput;
+    mbAudioCodec = avbridgeAudioToMediabunny(trackInfo.codec);
+    audioSink = new mb.EncodedPacketSink(newInput);
+    audioConfig = await newInput.getDecoderConfig();
+  }
+  await rebuildAudio();
   let sink = null;
   const stats = { videoPackets: 0, audioPackets: 0, bytesWritten: 0, fragments: 0 };
   let destroyed = false;
@@ -1074,6 +874,30 @@ async function createRemuxPipeline(ctx, video) {
       pendingAutoPlay = autoPlay;
       if (sink) sink.setPlayOnSeek(autoPlay);
     },
+    async setAudioTrack(trackId, time, autoPlay) {
+      if (selectedAudioTrackId === trackId) return;
+      if (!ctx.audioTracks.some((t) => t.id === trackId)) {
+        console.warn("[avbridge] remux: setAudioTrack \u2014 unknown track id", trackId);
+        return;
+      }
+      pumpToken++;
+      selectedAudioTrackId = trackId;
+      await rebuildAudio().catch((err) => {
+        console.warn("[avbridge] remux: rebuildAudio failed:", err.message);
+      });
+      if (sink) {
+        try {
+          sink.destroy();
+        } catch {
+        }
+        sink = null;
+      }
+      pendingAutoPlay = autoPlay;
+      pendingStartTime = time;
+      pumpLoop(++pumpToken, time).catch((err) => {
+        console.error("[avbridge] remux pipeline setAudioTrack pump failed:", err);
+      });
+    },
     async destroy() {
       destroyed = true;
       pumpToken++;
@@ -1133,7 +957,19 @@ async function createRemuxSession(context, video) {
       const wasPlaying = !video.paused;
       await pipeline.seek(time, wasPlaying || wantPlay);
     },
-    async setAudioTrack(_id) {
+    async setAudioTrack(id) {
+      if (!context.audioTracks.some((t) => t.id === id)) {
+        console.warn("[avbridge] remux: setAudioTrack \u2014 unknown track id", id);
+        return;
+      }
+      const wasPlaying = !video.paused;
+      const time = video.currentTime || 0;
+      if (!started) {
+        started = true;
+        await pipeline.setAudioTrack(id, time, wantPlay || wasPlaying);
+        return;
+      }
+      await pipeline.setAudioTrack(id, time, wasPlaying || wantPlay);
     },
     async setSubtitleTrack(id) {
       const tracks = video.textTracks;
@@ -1157,6 +993,10 @@ async function createRemuxSession(context, video) {
 }
 
 // src/strategies/fallback/video-renderer.ts
+function isDebug() {
+  return typeof globalThis !== "undefined" && !!globalThis.AVBRIDGE_DEBUG;
+}
+var lastDebugLog = 0;
 var VideoRenderer = class {
   constructor(target, clock, fps = 30) {
     this.target = target;
@@ -1182,6 +1022,9 @@ var VideoRenderer = class {
       document.body.appendChild(this.canvas);
     }
     target.style.visibility = "hidden";
+    const overlayParent = parent instanceof HTMLElement ? parent : document.body;
+    this.subtitleOverlay = new SubtitleOverlay(overlayParent);
+    this.watchTextTracks(target);
     const ctx = this.canvas.getContext("2d");
     if (!ctx) throw new Error("video renderer: failed to acquire 2D context");
     this.ctx = ctx;
@@ -1203,6 +1046,29 @@ var VideoRenderer = class {
   lastPaintWall = 0;
   /** Minimum ms between paints — paces video at roughly source fps. */
   paintIntervalMs;
+  /** Cumulative count of frames skipped because all PTS are in the future. */
+  ticksWaiting = 0;
+  /** Cumulative count of ticks where PTS mode painted a frame. */
+  ticksPainted = 0;
+  /**
+   * Subtitle overlay div attached to the stage wrapper alongside the
+   * canvas. Created lazily when subtitle tracks are attached via the
+   * target's `<track>` children. Canvas strategies (hybrid, fallback)
+   * hide the <video>, so we can't rely on the browser's native cue
+   * rendering; we read TextTrack.cues and render into this overlay.
+   */
+  subtitleOverlay = null;
+  subtitleTrack = null;
+  /**
+   * Calibration offset (microseconds) between video PTS and audio clock.
+   * Video PTS and AudioContext.currentTime can drift ~0.1% relative to
+   * each other (different clock domains). Over 45 minutes that's 2.6s.
+   * We measure the offset on the first painted frame and update it
+   * periodically so the PTS comparison stays calibrated.
+   */
+  ptsCalibrationUs = 0;
+  ptsCalibrated = false;
+  lastCalibrationWall = 0;
   /** Resolves once the first decoded frame has been enqueued. */
   firstFrameReady;
   resolveFirstFrame;
@@ -1236,9 +1102,80 @@ var VideoRenderer = class {
       this.framesDroppedOverflow++;
     }
   }
+  /**
+   * Watch the target <video>'s textTracks list. When a track is added,
+   * grab it and start polling cues on each render tick. Existing tracks
+   * (if any) are picked up immediately.
+   */
+  watchTextTracks(target) {
+    const pick = () => {
+      if (this.subtitleTrack) return;
+      const tracks = target.textTracks;
+      if (isDebug()) {
+        console.log(`[avbridge:subs] watchTextTracks pick() \u2014 ${tracks.length} tracks`);
+      }
+      for (let i = 0; i < tracks.length; i++) {
+        const t = tracks[i];
+        if (isDebug()) {
+          console.log(`[avbridge:subs] track ${i}: kind=${t.kind} mode=${t.mode} cues=${t.cues?.length ?? 0}`);
+        }
+        if (t.kind === "subtitles" || t.kind === "captions") {
+          this.subtitleTrack = t;
+          t.mode = "hidden";
+          if (isDebug()) {
+            console.log(`[avbridge:subs] picked track, mode=hidden`);
+          }
+          const trackEl = target.querySelector(`track[srclang="${t.language}"]`);
+          if (trackEl) {
+            trackEl.addEventListener("load", () => {
+              if (isDebug()) {
+                console.log(`[avbridge:subs] track element loaded, cues=${t.cues?.length ?? 0}`);
+              }
+            });
+            trackEl.addEventListener("error", (ev) => {
+              console.warn(`[avbridge:subs] track element error:`, ev);
+            });
+          }
+          break;
+        }
+      }
+    };
+    pick();
+    if (typeof target.textTracks.addEventListener === "function") {
+      target.textTracks.addEventListener("addtrack", (e) => {
+        if (isDebug()) {
+          console.log("[avbridge:subs] addtrack event fired");
+        }
+        pick();
+      });
+    }
+  }
+  _loggedCues = false;
+  /** Find the active cue (if any) for the given media time. */
+  updateSubtitles() {
+    if (!this.subtitleOverlay || !this.subtitleTrack) return;
+    const cues = this.subtitleTrack.cues;
+    if (!cues || cues.length === 0) return;
+    if (isDebug() && !this._loggedCues) {
+      this._loggedCues = true;
+      console.log(`[avbridge:subs] cues available: ${cues.length}, first start=${cues[0].startTime}, last end=${cues[cues.length - 1].endTime}`);
+    }
+    const t = this.clock.now();
+    let activeText = "";
+    for (let i = 0; i < cues.length; i++) {
+      const c = cues[i];
+      if (t >= c.startTime && t <= c.endTime) {
+        const vttCue = c;
+        activeText = vttCue.text ?? "";
+        break;
+      }
+    }
+    this.subtitleOverlay.setText(activeText.replace(/<[^>]+>/g, ""));
+  }
   tick() {
     if (this.destroyed) return;
     this.rafHandle = requestAnimationFrame(this.tick);
+    this.updateSubtitles();
     if (this.queue.length === 0) return;
     const playing = this.clock.isPlaying();
     if (!playing) {
@@ -1251,21 +1188,81 @@ var VideoRenderer = class {
       }
       return;
     }
-    const wallNow = performance.now();
-    if (wallNow - this.lastPaintWall < this.paintIntervalMs - 2) return;
-    if (this.queue.length === 0) return;
-    if (this.framesPainted > 0 && this.framesPainted % 30 === 0) {
-      const audioNowUs = this.clock.now() * 1e6;
-      const headTs = this.queue[0].timestamp ?? 0;
-      const driftUs = headTs - audioNowUs;
-      if (driftUs < -15e4) {
-        this.queue.shift()?.close();
-        this.framesDroppedLate++;
-        if (this.queue.length === 0) return;
-      } else if (driftUs > 15e4) {
+    const rawAudioNowUs = this.clock.now() * 1e6;
+    const headTs = this.queue[0].timestamp ?? 0;
+    const hasPts = headTs > 0 || this.queue.length > 1;
+    if (hasPts) {
+      const wallNow2 = performance.now();
+      if (!this.ptsCalibrated || wallNow2 - this.lastCalibrationWall > 1e4) {
+        this.ptsCalibrationUs = headTs - rawAudioNowUs;
+        this.ptsCalibrated = true;
+        this.lastCalibrationWall = wallNow2;
+      }
+      const audioNowUs = rawAudioNowUs + this.ptsCalibrationUs;
+      const frameDurationUs = this.paintIntervalMs * 1e3;
+      const deadlineUs = audioNowUs + frameDurationUs;
+      let bestIdx = -1;
+      for (let i = 0; i < this.queue.length; i++) {
+        const ts = this.queue[i].timestamp ?? 0;
+        if (ts <= deadlineUs) {
+          bestIdx = i;
+        } else {
+          break;
+        }
+      }
+      if (bestIdx < 0) {
+        this.ticksWaiting++;
+        if (isDebug()) {
+          const now = performance.now();
+          if (now - lastDebugLog > 1e3) {
+            const headPtsMs = (headTs / 1e3).toFixed(1);
+            const audioMs = (audioNowUs / 1e3).toFixed(1);
+            const rawDriftMs = ((headTs - rawAudioNowUs) / 1e3).toFixed(1);
+            const calibMs = (this.ptsCalibrationUs / 1e3).toFixed(1);
+            console.log(
+              `[avbridge:renderer] WAIT q=${this.queue.length} headPTS=${headPtsMs}ms calibAudio=${audioMs}ms rawDrift=${rawDriftMs}ms calib=${calibMs}ms painted=${this.framesPainted} dropped=${this.framesDroppedLate}`
+            );
+            lastDebugLog = now;
+          }
+        }
         return;
       }
+      const dropThresholdUs = audioNowUs - frameDurationUs * 2;
+      let dropped = 0;
+      while (bestIdx > 0) {
+        const ts = this.queue[0].timestamp ?? 0;
+        if (ts < dropThresholdUs) {
+          this.queue.shift()?.close();
+          this.framesDroppedLate++;
+          bestIdx--;
+          dropped++;
+        } else {
+          break;
+        }
+      }
+      this.ticksPainted++;
+      if (isDebug()) {
+        const now = performance.now();
+        if (now - lastDebugLog > 1e3) {
+          const paintedTs = this.queue[0]?.timestamp ?? 0;
+          const audioMs = (audioNowUs / 1e3).toFixed(1);
+          const ptsMs = (paintedTs / 1e3).toFixed(1);
+          const rawDriftMs = ((paintedTs - rawAudioNowUs) / 1e3).toFixed(1);
+          const calibMs = (this.ptsCalibrationUs / 1e3).toFixed(1);
+          console.log(
+            `[avbridge:renderer] PAINT q=${this.queue.length} calibAudio=${audioMs}ms nextPTS=${ptsMs}ms rawDrift=${rawDriftMs}ms calib=${calibMs}ms dropped=${dropped} total_drops=${this.framesDroppedLate} painted=${this.framesPainted}`
+          );
+          lastDebugLog = now;
+        }
+      }
+      const frame2 = this.queue.shift();
+      this.paint(frame2);
+      frame2.close();
+      this.lastPaintWall = performance.now();
+      return;
     }
+    const wallNow = performance.now();
+    if (wallNow - this.lastPaintWall < this.paintIntervalMs - 2) return;
     const frame = this.queue.shift();
     this.paint(frame);
     frame.close();
@@ -1287,8 +1284,13 @@ var VideoRenderer = class {
   }
   /** Discard all queued frames. Used by seek to drop stale buffers. */
   flush() {
+    const count = this.queue.length;
     while (this.queue.length > 0) this.queue.shift()?.close();
     this.prerolled = false;
+    this.ptsCalibrated = false;
+    if (isDebug() && count > 0) {
+      console.log(`[avbridge:renderer] FLUSH discarded=${count} painted=${this.framesPainted} drops=${this.framesDroppedLate}`);
+    }
   }
   stats() {
     return {
@@ -1302,6 +1304,11 @@ var VideoRenderer = class {
     this.destroyed = true;
     if (this.rafHandle != null) cancelAnimationFrame(this.rafHandle);
     this.flush();
+    if (this.subtitleOverlay) {
+      this.subtitleOverlay.destroy();
+      this.subtitleOverlay = null;
+    }
+    this.subtitleTrack = null;
     this.canvas.remove();
     this.target.style.visibility = "";
   }
@@ -1333,11 +1340,38 @@ var AudioOutput = class {
   pendingQueue = [];
   framesScheduled = 0;
   destroyed = false;
+  /** User-set volume (0..1). Applied to the gain node. */
+  _volume = 1;
+  /** User-set muted flag. When true, gain is forced to 0. */
+  _muted = false;
   constructor() {
     this.ctx = new AudioContext();
     this.gain = this.ctx.createGain();
     this.gain.connect(this.ctx.destination);
   }
+  /** Set volume (0..1). Applied immediately to the gain node. */
+  setVolume(v) {
+    this._volume = Math.max(0, Math.min(1, v));
+    this.applyGain();
+  }
+  getVolume() {
+    return this._volume;
+  }
+  /** Set muted. When true, output is silenced regardless of volume. */
+  setMuted(m) {
+    this._muted = m;
+    this.applyGain();
+  }
+  getMuted() {
+    return this._muted;
+  }
+  applyGain() {
+    const target = this._muted ? 0 : this._volume;
+    try {
+      this.gain.gain.value = target;
+    } catch {
+    }
+  }
   /**
    * Switch into wall-clock fallback mode. Called by the decoder when no
    * audio decoder could be initialized for the source. Once set, this
@@ -1487,6 +1521,7 @@ var AudioOutput = class {
     }
     this.gain = this.ctx.createGain();
     this.gain.connect(this.ctx.destination);
+    this.applyGain();
     this.pendingQueue = [];
     this.mediaTimeOfAnchor = newMediaTime;
     this.mediaTimeOfNext = newMediaTime;
@@ -1518,12 +1553,13 @@ 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-NQJVY273.js');
-  const inputHandle = await prepareLibavInput(libav, opts.filename, opts.source);
+  const { prepareLibavInput } = await import('./libav-http-reader-WXG3Z7AI.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);
   const videoStream = streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_VIDEO) ?? null;
-  const audioStream = streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO) ?? null;
+  const firstAudioTrackId = opts.context.audioTracks[0]?.id;
+  let audioStream = (firstAudioTrackId != null ? streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO && s.index === firstAudioTrackId) : void 0) ?? streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO) ?? null;
   if (!videoStream && !audioStream) {
     throw new Error("hybrid decoder: file has no decodable streams");
   }
@@ -1590,6 +1626,56 @@ async function startHybridDecoder(opts) {
     });
     throw new Error("hybrid decoder: could not initialize any decoders");
   }
+  let bsfCtx = null;
+  let bsfPkt = null;
+  if (videoStream && opts.context.videoTracks[0]?.codec === "mpeg4") {
+    try {
+      bsfCtx = await libav.av_bsf_list_parse_str_js("mpeg4_unpack_bframes");
+      if (bsfCtx != null && bsfCtx >= 0) {
+        const parIn = await libav.AVBSFContext_par_in(bsfCtx);
+        await libav.avcodec_parameters_copy(parIn, videoStream.codecpar);
+        await libav.av_bsf_init(bsfCtx);
+        bsfPkt = await libav.av_packet_alloc();
+        dbg.info("bsf", "mpeg4_unpack_bframes BSF active (hybrid)");
+      } else {
+        console.warn("[avbridge] mpeg4_unpack_bframes BSF not available in hybrid decoder");
+        bsfCtx = null;
+      }
+    } catch (err) {
+      console.warn("[avbridge] hybrid: failed to init BSF:", err.message);
+      bsfCtx = null;
+      bsfPkt = null;
+    }
+  }
+  async function applyBSF(packets) {
+    if (!bsfCtx || !bsfPkt) return packets;
+    const out = [];
+    for (const pkt of packets) {
+      await libav.ff_copyin_packet(bsfPkt, pkt);
+      const sendErr = await libav.av_bsf_send_packet(bsfCtx, bsfPkt);
+      if (sendErr < 0) {
+        out.push(pkt);
+        continue;
+      }
+      while (true) {
+        const recvErr = await libav.av_bsf_receive_packet(bsfCtx, bsfPkt);
+        if (recvErr < 0) break;
+        out.push(await libav.ff_copyout_packet(bsfPkt));
+      }
+    }
+    return out;
+  }
+  async function flushBSF() {
+    if (!bsfCtx || !bsfPkt) return;
+    try {
+      await libav.av_bsf_send_packet(bsfCtx, 0);
+      while (true) {
+        const err = await libav.av_bsf_receive_packet(bsfCtx, bsfPkt);
+        if (err < 0) break;
+      }
+    } catch {
+    }
+  }
   let destroyed = false;
   let pumpToken = 0;
   let pumpRunning = null;
@@ -1617,8 +1703,15 @@ async function startHybridDecoder(opts) {
       if (myToken !== pumpToken || destroyed) return;
       const videoPackets = videoStream ? packets[videoStream.index] : void 0;
       const audioPackets = audioStream ? packets[audioStream.index] : void 0;
+      if (audioDec && audioPackets && audioPackets.length > 0) {
+        await decodeAudioBatch(audioPackets, myToken);
+      }
+      if (myToken !== pumpToken || destroyed) return;
+      await new Promise((r) => setTimeout(r, 0));
+      if (myToken !== pumpToken || destroyed) return;
       if (videoDecoder && videoPackets && videoPackets.length > 0) {
-        for (const pkt of videoPackets) {
+        const processed = await applyBSF(videoPackets);
+        for (const pkt of processed) {
           if (myToken !== pumpToken || destroyed) return;
           sanitizePacketTimestamp(pkt, () => {
             const ts = syntheticVideoUs;
@@ -1638,9 +1731,6 @@ async function startHybridDecoder(opts) {
           }
         }
       }
-      if (audioDec && audioPackets && audioPackets.length > 0) {
-        await decodeAudioBatch(audioPackets, myToken);
-      }
       packetsRead += (videoPackets?.length ?? 0) + (audioPackets?.length ?? 0);
       while (!destroyed && myToken === pumpToken && (videoDecoder && videoDecoder.decodeQueueSize > 10 || opts.audio.bufferAhead() > 2 || opts.renderer.queueDepth() >= opts.renderer.queueHighWater)) {
         await new Promise((r) => setTimeout(r, 50));
@@ -1663,20 +1753,43 @@ async function startHybridDecoder(opts) {
   }
   async function decodeAudioBatch(pkts, myToken, flush = false) {
     if (!audioDec || destroyed || myToken !== pumpToken) return;
-    let frames;
-    try {
-      frames = await libav.ff_decode_multi(
-        audioDec.c,
-        audioDec.pkt,
-        audioDec.frame,
-        pkts,
-        flush ? { fin: true, ignoreErrors: true } : { ignoreErrors: true }
-      );
-    } catch (err) {
-      console.error("[avbridge] hybrid audio decode failed:", err);
-      return;
+    const AUDIO_SUB_BATCH = 4;
+    let allFrames = [];
+    for (let i = 0; i < pkts.length; i += AUDIO_SUB_BATCH) {
+      if (myToken !== pumpToken || destroyed) return;
+      const slice = pkts.slice(i, i + AUDIO_SUB_BATCH);
+      const isLast = i + AUDIO_SUB_BATCH >= pkts.length;
+      try {
+        const frames2 = await libav.ff_decode_multi(
+          audioDec.c,
+          audioDec.pkt,
+          audioDec.frame,
+          slice,
+          isLast && flush ? { fin: true, ignoreErrors: true } : { ignoreErrors: true }
+        );
+        allFrames = allFrames.concat(frames2);
+      } catch (err) {
+        console.error("[avbridge] hybrid audio decode failed:", err);
+        return;
+      }
+      if (!isLast) await new Promise((r) => setTimeout(r, 0));
+    }
+    if (pkts.length === 0 && flush) {
+      try {
+        allFrames = await libav.ff_decode_multi(
+          audioDec.c,
+          audioDec.pkt,
+          audioDec.frame,
+          [],
+          { fin: true, ignoreErrors: true }
+        );
+      } catch (err) {
+        console.error("[avbridge] hybrid audio flush failed:", err);
+        return;
+      }
     }
     if (myToken !== pumpToken || destroyed) return;
+    const frames = allFrames;
     for (const f of frames) {
       if (myToken !== pumpToken || destroyed) return;
       sanitizeFrameTimestamp(
@@ -1713,6 +1826,14 @@ async function startHybridDecoder(opts) {
         await pumpRunning;
       } catch {
       }
+      try {
+        if (bsfCtx) await libav.av_bsf_free(bsfCtx);
+      } catch {
+      }
+      try {
+        if (bsfPkt) await libav.av_packet_free?.(bsfPkt);
+      } catch {
+      }
       try {
         if (videoDecoder && videoDecoder.state !== "closed") videoDecoder.close();
       } catch {
@@ -1734,6 +1855,71 @@ async function startHybridDecoder(opts) {
       } catch {
       }
     },
+    async setAudioTrack(trackId, timeSec) {
+      if (audioStream && audioStream.index === trackId) return;
+      const newStream = streams.find(
+        (s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO && s.index === trackId
+      );
+      if (!newStream) {
+        console.warn("[avbridge] hybrid: setAudioTrack \u2014 no stream with id", trackId);
+        return;
+      }
+      const newToken = ++pumpToken;
+      if (pumpRunning) {
+        try {
+          await pumpRunning;
+        } catch {
+        }
+      }
+      if (destroyed) return;
+      if (audioDec) {
+        try {
+          await libav.ff_free_decoder?.(audioDec.c, audioDec.pkt, audioDec.frame);
+        } catch {
+        }
+        audioDec = null;
+      }
+      try {
+        const [, c, pkt, frame] = await libav.ff_init_decoder(newStream.codec_id, {
+          codecpar: newStream.codecpar
+        });
+        audioDec = { c, pkt, frame };
+        audioTimeBase = newStream.time_base_num && newStream.time_base_den ? [newStream.time_base_num, newStream.time_base_den] : void 0;
+      } catch (err) {
+        console.warn(
+          "[avbridge] hybrid: setAudioTrack init failed \u2014 switching to no-audio:",
+          err.message
+        );
+        audioDec = null;
+        opts.audio.setNoAudio();
+      }
+      audioStream = newStream;
+      try {
+        const tsUs = Math.floor(timeSec * 1e6);
+        const [tsLo, tsHi] = libav.f64toi64 ? libav.f64toi64(tsUs) : [tsUs | 0, Math.floor(tsUs / 4294967296)];
+        await libav.av_seek_frame(
+          fmt_ctx,
+          -1,
+          tsLo,
+          tsHi,
+          libav.AVSEEK_FLAG_BACKWARD ?? 0
+        );
+      } catch (err) {
+        console.warn("[avbridge] hybrid: setAudioTrack seek failed:", err);
+      }
+      try {
+        if (videoDecoder && videoDecoder.state === "configured") {
+          await videoDecoder.flush();
+        }
+      } catch {
+      }
+      await flushBSF();
+      syntheticVideoUs = Math.round(timeSec * 1e6);
+      syntheticAudioUs = Math.round(timeSec * 1e6);
+      pumpRunning = pumpLoop(newToken).catch(
+        (err) => console.error("[avbridge] hybrid pump failed (post-setAudioTrack):", err)
+      );
+    },
     async seek(timeSec) {
       const newToken = ++pumpToken;
       if (pumpRunning) {
@@ -1766,6 +1952,7 @@ async function startHybridDecoder(opts) {
         if (audioDec) await libav.avcodec_flush_buffers?.(audioDec.c);
       } catch {
       }
+      await flushBSF();
       syntheticVideoUs = Math.round(timeSec * 1e6);
       syntheticAudioUs = Math.round(timeSec * 1e6);
       pumpRunning = pumpLoop(newToken).catch(
@@ -1779,6 +1966,7 @@ async function startHybridDecoder(opts) {
         videoFramesDecoded,
         videoChunksFed,
         audioFramesDecoded,
+        bsfApplied: bsfCtx ? ["mpeg4_unpack_bframes"] : [],
         videoDecodeQueueSize: videoDecoder?.decodeQueueSize ?? 0,
         // Confirmed transport info — see fallback decoder for the pattern.
         _transport: inputHandle.transport === "http-range" ? "http-range" : "memory",
@@ -1789,161 +1977,9 @@ async function startHybridDecoder(opts) {
     }
   };
 }
-function sanitizePacketTimestamp(pkt, nextUs, fallbackTimeBase) {
-  const lo = pkt.pts ?? 0;
-  const hi = pkt.ptshi ?? 0;
-  const isInvalid = hi === -2147483648 && lo === 0 || !Number.isFinite(lo);
-  if (isInvalid) {
-    const us2 = nextUs();
-    pkt.pts = us2;
-    pkt.ptshi = 0;
-    pkt.time_base_num = 1;
-    pkt.time_base_den = 1e6;
-    return;
-  }
-  const tb = fallbackTimeBase ?? [1, 1e6];
-  const pts64 = hi * 4294967296 + lo;
-  const us = Math.round(pts64 * 1e6 * tb[0] / tb[1]);
-  if (Number.isFinite(us) && Math.abs(us) <= Number.MAX_SAFE_INTEGER) {
-    pkt.pts = us;
-    pkt.ptshi = us < 0 ? -1 : 0;
-    pkt.time_base_num = 1;
-    pkt.time_base_den = 1e6;
-    return;
-  }
-  const fallback = nextUs();
-  pkt.pts = fallback;
-  pkt.ptshi = 0;
-  pkt.time_base_num = 1;
-  pkt.time_base_den = 1e6;
-}
-function sanitizeFrameTimestamp(frame, nextUs, fallbackTimeBase) {
-  const lo = frame.pts ?? 0;
-  const hi = frame.ptshi ?? 0;
-  const isInvalid = hi === -2147483648 && lo === 0 || !Number.isFinite(lo);
-  if (isInvalid) {
-    const us2 = nextUs();
-    frame.pts = us2;
-    frame.ptshi = 0;
-    return;
-  }
-  const tb = fallbackTimeBase ?? [1, 1e6];
-  const pts64 = hi * 4294967296 + lo;
-  const us = Math.round(pts64 * 1e6 * tb[0] / tb[1]);
-  if (Number.isFinite(us) && Math.abs(us) <= Number.MAX_SAFE_INTEGER) {
-    frame.pts = us;
-    frame.ptshi = us < 0 ? -1 : 0;
-    return;
-  }
-  const fallback = nextUs();
-  frame.pts = fallback;
-  frame.ptshi = 0;
-}
-var AV_SAMPLE_FMT_U8 = 0;
-var AV_SAMPLE_FMT_S16 = 1;
-var AV_SAMPLE_FMT_S32 = 2;
-var AV_SAMPLE_FMT_FLT = 3;
-var AV_SAMPLE_FMT_U8P = 5;
-var AV_SAMPLE_FMT_S16P = 6;
-var AV_SAMPLE_FMT_S32P = 7;
-var AV_SAMPLE_FMT_FLTP = 8;
-function libavFrameToInterleavedFloat32(frame) {
-  const channels = frame.channels ?? frame.ch_layout_nb_channels ?? 1;
-  const sampleRate = frame.sample_rate ?? 44100;
-  const nbSamples = frame.nb_samples ?? 0;
-  if (nbSamples === 0) return null;
-  const out = new Float32Array(nbSamples * channels);
-  switch (frame.format) {
-    case AV_SAMPLE_FMT_FLTP: {
-      const planes = ensurePlanes(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asFloat32(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i];
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_FLT: {
-      const flat = asFloat32(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i];
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S16P: {
-      const planes = ensurePlanes(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asInt16(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i] / 32768;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S16: {
-      const flat = asInt16(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i] / 32768;
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S32P: {
-      const planes = ensurePlanes(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asInt32(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i] / 2147483648;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S32: {
-      const flat = asInt32(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i] / 2147483648;
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_U8P: {
-      const planes = ensurePlanes(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asUint8(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = (plane[i] - 128) / 128;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_U8: {
-      const flat = asUint8(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = (flat[i] - 128) / 128;
-      return { data: out, channels, sampleRate };
-    }
-    default:
-      return null;
-  }
-}
-function ensurePlanes(data, channels) {
-  if (Array.isArray(data)) return data;
-  const arr = data;
-  const len = arr.length;
-  const perChannel = Math.floor(len / channels);
-  const planes = [];
-  for (let ch = 0; ch < channels; ch++) {
-    planes.push(arr.subarray ? arr.subarray(ch * perChannel, (ch + 1) * perChannel) : arr);
-  }
-  return planes;
-}
-function asFloat32(x) {
-  if (x instanceof Float32Array) return x;
-  const ta = x;
-  return new Float32Array(ta.buffer, ta.byteOffset, ta.byteLength / 4);
-}
-function asInt16(x) {
-  if (x instanceof Int16Array) return x;
-  const ta = x;
-  return new Int16Array(ta.buffer, ta.byteOffset, ta.byteLength / 2);
-}
-function asInt32(x) {
-  if (x instanceof Int32Array) return x;
-  const ta = x;
-  return new Int32Array(ta.buffer, ta.byteOffset, ta.byteLength / 4);
-}
-function asUint8(x) {
-  if (x instanceof Uint8Array) return x;
-  const ta = x;
-  return new Uint8Array(ta.buffer, ta.byteOffset, ta.byteLength);
-}
 async function loadBridge() {
   try {
-    const wrapper = await import('./libav-import-2JURFHEW.js');
+    const wrapper = await import('./libav-import-6MGLCXVQ.js');
     return wrapper.libavBridge;
   } catch (err) {
     throw new Error(
@@ -1955,9 +1991,9 @@ async function loadBridge() {
 // src/strategies/hybrid/index.ts
 var READY_AUDIO_BUFFER_SECONDS = 0.3;
 var READY_TIMEOUT_SECONDS = 10;
-async function createHybridSession(ctx, target) {
-  const { normalizeSource: normalizeSource2 } = await import('./source-FFZ7TW2B.js');
-  const source = await normalizeSource2(ctx.source);
+async function createHybridSession(ctx, target, transport) {
+  const { normalizeSource } = await import('./source-4TZ6KMNV.js');
+  const source = await normalizeSource(ctx.source);
   const fps = ctx.videoTracks[0]?.fps ?? 30;
   const audio = new AudioOutput();
   const renderer = new VideoRenderer(target, audio, fps);
@@ -1968,7 +2004,8 @@ async function createHybridSession(ctx, target) {
       filename: ctx.name ?? "input.bin",
       context: ctx,
       renderer,
-      audio
+      audio,
+      transport
     });
   } catch (err) {
     audio.destroy();
@@ -1986,6 +2023,22 @@ async function createHybridSession(ctx, target) {
     configurable: true,
     get: () => !audio.isPlaying()
   });
+  Object.defineProperty(target, "volume", {
+    configurable: true,
+    get: () => audio.getVolume(),
+    set: (v) => {
+      audio.setVolume(v);
+      target.dispatchEvent(new Event("volumechange"));
+    }
+  });
+  Object.defineProperty(target, "muted", {
+    configurable: true,
+    get: () => audio.getMuted(),
+    set: (m) => {
+      audio.setMuted(m);
+      target.dispatchEvent(new Event("volumechange"));
+    }
+  });
   if (ctx.duration && Number.isFinite(ctx.duration)) {
     Object.defineProperty(target, "duration", {
       configurable: true,
@@ -2025,15 +2078,35 @@ async function createHybridSession(ctx, target) {
       if (!audio.isPlaying()) {
         await waitForBuffer();
         await audio.start();
+        target.dispatchEvent(new Event("play"));
+        target.dispatchEvent(new Event("playing"));
       }
     },
     pause() {
       void audio.pause();
+      target.dispatchEvent(new Event("pause"));
     },
     async seek(time) {
       await doSeek(time);
     },
-    async setAudioTrack(_id) {
+    async setAudioTrack(id) {
+      if (!ctx.audioTracks.some((t) => t.id === id)) {
+        console.warn("[avbridge] hybrid: setAudioTrack \u2014 unknown track id", id);
+        return;
+      }
+      const wasPlaying = audio.isPlaying();
+      const currentTime = audio.now();
+      await audio.pause().catch(() => {
+      });
+      await handles.setAudioTrack(id, currentTime).catch(
+        (err) => console.warn("[avbridge] hybrid: handles.setAudioTrack failed:", err)
+      );
+      await audio.reset(currentTime);
+      renderer.flush();
+      if (wasPlaying) {
+        await waitForBuffer();
+        await audio.start();
+      }
     },
     async setSubtitleTrack(_id) {
     },
@@ -2051,6 +2124,8 @@ async function createHybridSession(ctx, target) {
         delete target.currentTime;
         delete target.duration;
         delete target.paused;
+        delete target.volume;
+        delete target.muted;
       } catch {
       }
     },
@@ -2065,12 +2140,13 @@ async function startDecoder(opts) {
   const variant = pickLibavVariant(opts.context);
   const libav = await loadLibav(variant);
   const bridge = await loadBridge2();
-  const { prepareLibavInput } = await import('./libav-http-reader-NQJVY273.js');
-  const inputHandle = await prepareLibavInput(libav, opts.filename, opts.source);
+  const { prepareLibavInput } = await import('./libav-http-reader-WXG3Z7AI.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);
   const videoStream = streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_VIDEO) ?? null;
-  const audioStream = streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO) ?? null;
+  const firstAudioTrackId = opts.context.audioTracks[0]?.id;
+  let audioStream = (firstAudioTrackId != null ? streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO && s.index === firstAudioTrackId) : void 0) ?? streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO) ?? null;
   if (!videoStream && !audioStream) {
     throw new Error("fallback decoder: file has no decodable streams");
   }
@@ -2122,6 +2198,56 @@ async function startDecoder(opts) {
       `fallback decoder: could not initialize any libav decoders (${codecs}).${hint}`
     );
   }
+  let bsfCtx = null;
+  let bsfPkt = null;
+  if (videoStream && opts.context.videoTracks[0]?.codec === "mpeg4") {
+    try {
+      bsfCtx = await libav.av_bsf_list_parse_str_js("mpeg4_unpack_bframes");
+      if (bsfCtx != null && bsfCtx >= 0) {
+        const parIn = await libav.AVBSFContext_par_in(bsfCtx);
+        await libav.avcodec_parameters_copy(parIn, videoStream.codecpar);
+        await libav.av_bsf_init(bsfCtx);
+        bsfPkt = await libav.av_packet_alloc();
+        dbg.info("bsf", "mpeg4_unpack_bframes BSF active");
+      } else {
+        console.warn("[avbridge] mpeg4_unpack_bframes BSF not available \u2014 decoding without it");
+        bsfCtx = null;
+      }
+    } catch (err) {
+      console.warn("[avbridge] failed to init mpeg4_unpack_bframes BSF:", err.message);
+      bsfCtx = null;
+      bsfPkt = null;
+    }
+  }
+  async function applyBSF(packets) {
+    if (!bsfCtx || !bsfPkt) return packets;
+    const out = [];
+    for (const pkt of packets) {
+      await libav.ff_copyin_packet(bsfPkt, pkt);
+      const sendErr = await libav.av_bsf_send_packet(bsfCtx, bsfPkt);
+      if (sendErr < 0) {
+        out.push(pkt);
+        continue;
+      }
+      while (true) {
+        const recvErr = await libav.av_bsf_receive_packet(bsfCtx, bsfPkt);
+        if (recvErr < 0) break;
+        out.push(await libav.ff_copyout_packet(bsfPkt));
+      }
+    }
+    return out;
+  }
+  async function flushBSF() {
+    if (!bsfCtx || !bsfPkt) return;
+    try {
+      await libav.av_bsf_send_packet(bsfCtx, 0);
+      while (true) {
+        const err = await libav.av_bsf_receive_packet(bsfCtx, bsfPkt);
+        if (err < 0) break;
+      }
+    } catch {
+    }
+  }
   let destroyed = false;
   let pumpToken = 0;
   let pumpRunning = null;
@@ -2157,7 +2283,8 @@ async function startDecoder(opts) {
       }
       if (myToken !== pumpToken || destroyed) return;
       if (videoDec && videoPackets && videoPackets.length > 0) {
-        await decodeVideoBatch(videoPackets, myToken);
+        const processed = await applyBSF(videoPackets);
+        await decodeVideoBatch(processed, myToken);
       }
       packetsRead += (videoPackets?.length ?? 0) + (audioPackets?.length ?? 0);
       if (videoFramesDecoded > 0) {
@@ -2235,7 +2362,7 @@ async function startDecoder(opts) {
     if (myToken !== pumpToken || destroyed) return;
     for (const f of frames) {
       if (myToken !== pumpToken || destroyed) return;
-      const bridgeOpts = sanitizeFrameTimestamp2(
+      sanitizeFrameTimestamp(
         f,
         () => {
           const ts = syntheticVideoUs;
@@ -2245,7 +2372,7 @@ async function startDecoder(opts) {
         videoTimeBase
       );
       try {
-        const vf = bridge.laFrameToVideoFrame(f, bridgeOpts);
+        const vf = bridge.laFrameToVideoFrame(f, { timeBase: [1, 1e6] });
         opts.renderer.enqueue(vf);
         videoFramesDecoded++;
       } catch (err) {
@@ -2273,7 +2400,7 @@ async function startDecoder(opts) {
     if (myToken !== pumpToken || destroyed) return;
     for (const f of frames) {
       if (myToken !== pumpToken || destroyed) return;
-      sanitizeFrameTimestamp2(
+      sanitizeFrameTimestamp(
         f,
         () => {
           const ts = syntheticAudioUs;
@@ -2284,7 +2411,7 @@ async function startDecoder(opts) {
         },
         audioTimeBase
       );
-      const samples = libavFrameToInterleavedFloat322(f);
+      const samples = libavFrameToInterleavedFloat32(f);
       if (samples) {
         opts.audio.schedule(samples.data, samples.channels, samples.sampleRate);
         audioFramesDecoded++;
@@ -2303,6 +2430,14 @@ async function startDecoder(opts) {
         await pumpRunning;
       } catch {
       }
+      try {
+        if (bsfCtx) await libav.av_bsf_free(bsfCtx);
+      } catch {
+      }
+      try {
+        if (bsfPkt) await libav.av_packet_free?.(bsfPkt);
+      } catch {
+      }
       try {
         if (videoDec) await libav.ff_free_decoder?.(videoDec.c, videoDec.pkt, videoDec.frame);
       } catch {
@@ -2324,6 +2459,69 @@ async function startDecoder(opts) {
       } catch {
       }
     },
+    async setAudioTrack(trackId, timeSec) {
+      if (audioStream && audioStream.index === trackId) return;
+      const newStream = streams.find(
+        (s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO && s.index === trackId
+      );
+      if (!newStream) {
+        console.warn("[avbridge] fallback: setAudioTrack \u2014 no stream with id", trackId);
+        return;
+      }
+      const newToken = ++pumpToken;
+      if (pumpRunning) {
+        try {
+          await pumpRunning;
+        } catch {
+        }
+      }
+      if (destroyed) return;
+      if (audioDec) {
+        try {
+          await libav.ff_free_decoder?.(audioDec.c, audioDec.pkt, audioDec.frame);
+        } catch {
+        }
+        audioDec = null;
+      }
+      try {
+        const [, c, pkt, frame] = await libav.ff_init_decoder(newStream.codec_id, {
+          codecpar: newStream.codecpar
+        });
+        audioDec = { c, pkt, frame };
+        audioTimeBase = newStream.time_base_num && newStream.time_base_den ? [newStream.time_base_num, newStream.time_base_den] : void 0;
+      } catch (err) {
+        console.warn(
+          "[avbridge] fallback: setAudioTrack init failed \u2014 falling back to no-audio mode:",
+          err.message
+        );
+        audioDec = null;
+        opts.audio.setNoAudio();
+      }
+      audioStream = newStream;
+      try {
+        const tsUs = Math.floor(timeSec * 1e6);
+        const [tsLo, tsHi] = libav.f64toi64 ? libav.f64toi64(tsUs) : [tsUs | 0, Math.floor(tsUs / 4294967296)];
+        await libav.av_seek_frame(
+          fmt_ctx,
+          -1,
+          tsLo,
+          tsHi,
+          libav.AVSEEK_FLAG_BACKWARD ?? 0
+        );
+      } catch (err) {
+        console.warn("[avbridge] fallback: setAudioTrack seek failed:", err);
+      }
+      try {
+        if (videoDec) await libav.avcodec_flush_buffers?.(videoDec.c);
+      } catch {
+      }
+      await flushBSF();
+      syntheticVideoUs = Math.round(timeSec * 1e6);
+      syntheticAudioUs = Math.round(timeSec * 1e6);
+      pumpRunning = pumpLoop(newToken).catch(
+        (err) => console.error("[avbridge] fallback pump failed (post-setAudioTrack):", err)
+      );
+    },
     async seek(timeSec) {
       const newToken = ++pumpToken;
       if (pumpRunning) {
@@ -2354,6 +2552,7 @@ async function startDecoder(opts) {
         if (audioDec) await libav.avcodec_flush_buffers?.(audioDec.c);
       } catch {
       }
+      await flushBSF();
       syntheticVideoUs = Math.round(timeSec * 1e6);
       syntheticAudioUs = Math.round(timeSec * 1e6);
       pumpRunning = pumpLoop(newToken).catch(
@@ -2366,6 +2565,7 @@ async function startDecoder(opts) {
         packetsRead,
         videoFramesDecoded,
         audioFramesDecoded,
+        bsfApplied: bsfCtx ? ["mpeg4_unpack_bframes"] : [],
         // Confirmed transport info: once prepareLibavInput returns
         // successfully, we *know* whether the source is http-range (probe
         // succeeded and returned 206) or in-memory blob. Diagnostics hoists
@@ -2378,138 +2578,9 @@ async function startDecoder(opts) {
     }
   };
 }
-function sanitizeFrameTimestamp2(frame, nextUs, fallbackTimeBase) {
-  const lo = frame.pts ?? 0;
-  const hi = frame.ptshi ?? 0;
-  const isInvalid = hi === -2147483648 && lo === 0 || !Number.isFinite(lo);
-  if (isInvalid) {
-    const us2 = nextUs();
-    frame.pts = us2;
-    frame.ptshi = 0;
-    return { timeBase: [1, 1e6] };
-  }
-  const tb = fallbackTimeBase ?? [1, 1e6];
-  const pts64 = hi * 4294967296 + lo;
-  const us = Math.round(pts64 * 1e6 * tb[0] / tb[1]);
-  if (Number.isFinite(us) && Math.abs(us) <= Number.MAX_SAFE_INTEGER) {
-    frame.pts = us;
-    frame.ptshi = us < 0 ? -1 : 0;
-    return { timeBase: [1, 1e6] };
-  }
-  const fallback = nextUs();
-  frame.pts = fallback;
-  frame.ptshi = 0;
-  return { timeBase: [1, 1e6] };
-}
-var AV_SAMPLE_FMT_U82 = 0;
-var AV_SAMPLE_FMT_S162 = 1;
-var AV_SAMPLE_FMT_S322 = 2;
-var AV_SAMPLE_FMT_FLT2 = 3;
-var AV_SAMPLE_FMT_U8P2 = 5;
-var AV_SAMPLE_FMT_S16P2 = 6;
-var AV_SAMPLE_FMT_S32P2 = 7;
-var AV_SAMPLE_FMT_FLTP2 = 8;
-function libavFrameToInterleavedFloat322(frame) {
-  const channels = frame.channels ?? frame.ch_layout_nb_channels ?? 1;
-  const sampleRate = frame.sample_rate ?? 44100;
-  const nbSamples = frame.nb_samples ?? 0;
-  if (nbSamples === 0) return null;
-  const out = new Float32Array(nbSamples * channels);
-  switch (frame.format) {
-    case AV_SAMPLE_FMT_FLTP2: {
-      const planes = ensurePlanes2(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asFloat322(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i];
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_FLT2: {
-      const flat = asFloat322(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i];
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S16P2: {
-      const planes = ensurePlanes2(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asInt162(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i] / 32768;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S162: {
-      const flat = asInt162(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i] / 32768;
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S32P2: {
-      const planes = ensurePlanes2(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asInt322(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = plane[i] / 2147483648;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_S322: {
-      const flat = asInt322(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = flat[i] / 2147483648;
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_U8P2: {
-      const planes = ensurePlanes2(frame.data, channels);
-      for (let ch = 0; ch < channels; ch++) {
-        const plane = asUint82(planes[ch]);
-        for (let i = 0; i < nbSamples; i++) out[i * channels + ch] = (plane[i] - 128) / 128;
-      }
-      return { data: out, channels, sampleRate };
-    }
-    case AV_SAMPLE_FMT_U82: {
-      const flat = asUint82(frame.data);
-      for (let i = 0; i < nbSamples * channels; i++) out[i] = (flat[i] - 128) / 128;
-      return { data: out, channels, sampleRate };
-    }
-    default:
-      if (!globalThis.__avbridgeLoggedSampleFmt) {
-        globalThis.__avbridgeLoggedSampleFmt = frame.format;
-        console.warn(`[avbridge] unsupported audio sample format from libav: ${frame.format}`);
-      }
-      return null;
-  }
-}
-function ensurePlanes2(data, channels) {
-  if (Array.isArray(data)) return data;
-  const arr = data;
-  const len = arr.length;
-  const perChannel = Math.floor(len / channels);
-  const planes = [];
-  for (let ch = 0; ch < channels; ch++) {
-    planes.push(arr.subarray ? arr.subarray(ch * perChannel, (ch + 1) * perChannel) : arr);
-  }
-  return planes;
-}
-function asFloat322(x) {
-  if (x instanceof Float32Array) return x;
-  const ta = x;
-  return new Float32Array(ta.buffer, ta.byteOffset, ta.byteLength / 4);
-}
-function asInt162(x) {
-  if (x instanceof Int16Array) return x;
-  const ta = x;
-  return new Int16Array(ta.buffer, ta.byteOffset, ta.byteLength / 2);
-}
-function asInt322(x) {
-  if (x instanceof Int32Array) return x;
-  const ta = x;
-  return new Int32Array(ta.buffer, ta.byteOffset, ta.byteLength / 4);
-}
-function asUint82(x) {
-  if (x instanceof Uint8Array) return x;
-  const ta = x;
-  return new Uint8Array(ta.buffer, ta.byteOffset, ta.byteLength);
-}
 async function loadBridge2() {
   try {
-    const wrapper = await import('./libav-import-2JURFHEW.js');
+    const wrapper = await import('./libav-import-6MGLCXVQ.js');
     return wrapper.libavBridge;
   } catch (err) {
     throw new Error(
@@ -2521,9 +2592,9 @@ async function loadBridge2() {
 // src/strategies/fallback/index.ts
 var READY_AUDIO_BUFFER_SECONDS2 = 0.04;
 var READY_TIMEOUT_SECONDS2 = 3;
-async function createFallbackSession(ctx, target) {
-  const { normalizeSource: normalizeSource2 } = await import('./source-FFZ7TW2B.js');
-  const source = await normalizeSource2(ctx.source);
+async function createFallbackSession(ctx, target, transport) {
+  const { normalizeSource } = await import('./source-4TZ6KMNV.js');
+  const source = await normalizeSource(ctx.source);
   const fps = ctx.videoTracks[0]?.fps ?? 30;
   const audio = new AudioOutput();
   const renderer = new VideoRenderer(target, audio, fps);
@@ -2534,7 +2605,8 @@ async function createFallbackSession(ctx, target) {
       filename: ctx.name ?? "input.bin",
       context: ctx,
       renderer,
-      audio
+      audio,
+      transport
     });
   } catch (err) {
     audio.destroy();
@@ -2552,6 +2624,22 @@ async function createFallbackSession(ctx, target) {
     configurable: true,
     get: () => !audio.isPlaying()
   });
+  Object.defineProperty(target, "volume", {
+    configurable: true,
+    get: () => audio.getVolume(),
+    set: (v) => {
+      audio.setVolume(v);
+      target.dispatchEvent(new Event("volumechange"));
+    }
+  });
+  Object.defineProperty(target, "muted", {
+    configurable: true,
+    get: () => audio.getMuted(),
+    set: (m) => {
+      audio.setMuted(m);
+      target.dispatchEvent(new Event("volumechange"));
+    }
+  });
   if (ctx.duration && Number.isFinite(ctx.duration)) {
     Object.defineProperty(target, "duration", {
       configurable: true,
@@ -2615,15 +2703,35 @@ async function createFallbackSession(ctx, target) {
       if (!audio.isPlaying()) {
         await waitForBuffer();
         await audio.start();
+        target.dispatchEvent(new Event("play"));
+        target.dispatchEvent(new Event("playing"));
       }
     },
     pause() {
       void audio.pause();
+      target.dispatchEvent(new Event("pause"));
     },
     async seek(time) {
       await doSeek(time);
     },
-    async setAudioTrack(_id) {
+    async setAudioTrack(id) {
+      if (!ctx.audioTracks.some((t) => t.id === id)) {
+        console.warn("[avbridge] fallback: setAudioTrack \u2014 unknown track id", id);
+        return;
+      }
+      const wasPlaying = audio.isPlaying();
+      const currentTime = audio.now();
+      await audio.pause().catch(() => {
+      });
+      await handles.setAudioTrack(id, currentTime).catch(
+        (err) => console.warn("[avbridge] fallback: handles.setAudioTrack failed:", err)
+      );
+      await audio.reset(currentTime);
+      renderer.flush();
+      if (wasPlaying) {
+        await waitForBuffer();
+        await audio.start();
+      }
     },
     async setSubtitleTrack(_id) {
     },
@@ -2638,6 +2746,8 @@ async function createFallbackSession(ctx, target) {
         delete target.currentTime;
         delete target.duration;
         delete target.paused;
+        delete target.volume;
+        delete target.muted;
       } catch {
       }
     },
@@ -2661,12 +2771,12 @@ var remuxPlugin = {
 var hybridPlugin = {
   name: "hybrid",
   canHandle: () => typeof VideoDecoder !== "undefined",
-  execute: (ctx, video) => createHybridSession(ctx, video)
+  execute: (ctx, video, transport) => createHybridSession(ctx, video, transport)
 };
 var fallbackPlugin = {
   name: "fallback",
   canHandle: () => true,
-  execute: (ctx, video) => createFallbackSession(ctx, video)
+  execute: (ctx, video, transport) => createFallbackSession(ctx, video, transport)
 };
 function registerBuiltins(registry) {
   registry.register(nativePlugin);
@@ -2675,88 +2785,6 @@ function registerBuiltins(registry) {
   registry.register(fallbackPlugin);
 }
 
-// src/subtitles/vtt.ts
-function isVtt(text) {
-  const trimmed = text.replace(/^\ufeff/, "").trimStart();
-  return trimmed.startsWith("WEBVTT");
-}
-
-// src/subtitles/index.ts
-async function discoverSidecars(file, directory) {
-  const baseName = file.name.replace(/\.[^.]+$/, "");
-  const found = [];
-  for await (const [name, handle] of directory) {
-    if (handle.kind !== "file") continue;
-    if (!name.startsWith(baseName)) continue;
-    const lower = name.toLowerCase();
-    let format = null;
-    if (lower.endsWith(".srt")) format = "srt";
-    else if (lower.endsWith(".vtt")) format = "vtt";
-    if (!format) continue;
-    const sidecarFile = await handle.getFile();
-    const url = URL.createObjectURL(sidecarFile);
-    const langMatch = name.slice(baseName.length).match(/[._-]([a-z]{2,3})(?:[._-]|\.)/i);
-    found.push({
-      url,
-      format,
-      language: langMatch?.[1]
-    });
-  }
-  return found;
-}
-var SubtitleResourceBag = class {
-  urls = /* @__PURE__ */ new Set();
-  /** Track an externally-created blob URL (e.g. from `discoverSidecars`). */
-  track(url) {
-    this.urls.add(url);
-  }
-  /** Convenience: create a blob URL and track it in one call. */
-  createObjectURL(blob) {
-    const url = URL.createObjectURL(blob);
-    this.urls.add(url);
-    return url;
-  }
-  /** Revoke every tracked URL. Idempotent — safe to call multiple times. */
-  revokeAll() {
-    for (const u of this.urls) URL.revokeObjectURL(u);
-    this.urls.clear();
-  }
-};
-async function attachSubtitleTracks(video, tracks, bag, onError) {
-  for (const t of Array.from(video.querySelectorAll("track[data-avbridge]"))) {
-    t.remove();
-  }
-  for (const t of tracks) {
-    if (!t.sidecarUrl) continue;
-    try {
-      let url = t.sidecarUrl;
-      if (t.format === "srt") {
-        const res = await fetch(t.sidecarUrl);
-        const text = await res.text();
-        const vtt = srtToVtt(text);
-        const blob = new Blob([vtt], { type: "text/vtt" });
-        url = bag ? bag.createObjectURL(blob) : URL.createObjectURL(blob);
-      } else if (t.format === "vtt") {
-        const res = await fetch(t.sidecarUrl);
-        const text = await res.text();
-        if (!isVtt(text)) {
-          console.warn("[avbridge] subtitle missing WEBVTT header:", t.sidecarUrl);
-        }
-      }
-      const trackEl = document.createElement("track");
-      trackEl.kind = "subtitles";
-      trackEl.src = url;
-      trackEl.srclang = t.language ?? "und";
-      trackEl.label = t.language ?? `Subtitle ${t.id}`;
-      trackEl.dataset.avbridge = "true";
-      video.appendChild(trackEl);
-    } catch (err) {
-      const e = err instanceof Error ? err : new Error(String(err));
-      onError?.(e, t);
-    }
-  }
-}
-
 // src/player.ts
 var UnifiedPlayer = class _UnifiedPlayer {
   /**
@@ -2765,6 +2793,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
   constructor(options, registry) {
     this.options = options;
     this.registry = registry;
+    const { requestInit, fetchFn } = options;
+    if (requestInit || fetchFn) {
+      this.transport = { requestInit, fetchFn };
+    }
   }
   options;
   registry;
@@ -2784,11 +2816,23 @@ var UnifiedPlayer = class _UnifiedPlayer {
   // listener outlives the player and accumulates on elements that swap
   // source (e.g. <avbridge-video>).
   endedListener = null;
+  // Background tab handling. userIntent is what the user last asked for
+  // (play vs pause) — used to decide whether to auto-resume on visibility
+  // return. autoPausedForVisibility tracks whether we paused because the
+  // tab was hidden, so we don't resume playback the user deliberately
+  // paused (e.g. via media keys while hidden).
+  userIntent = "pause";
+  autoPausedForVisibility = false;
+  visibilityListener = null;
   // Serializes escalation / setStrategy calls
   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 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.
+  transport;
   static async create(options) {
     const registry = new PluginRegistry();
     registerBuiltins(registry);
@@ -2812,7 +2856,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
     const bootstrapStart = performance.now();
     try {
       dbg.info("bootstrap", "start");
-      const ctx = await dbg.timed("probe", "probe", 3e3, () => probe(this.options.source));
+      const ctx = await dbg.timed("probe", "probe", 3e3, () => probe(this.options.source, this.transport));
       dbg.info(
         "probe",
         `container=${ctx.container} video=${ctx.videoTracks[0]?.codec ?? "-"} audio=${ctx.audioTracks[0]?.codec ?? "-"} probedBy=${ctx.probedBy}`
@@ -2853,16 +2897,15 @@ var UnifiedPlayer = class _UnifiedPlayer {
         reason: decision.reason
       });
       await this.startSession(decision.strategy, decision.reason);
-      if (this.session.strategy !== "fallback" && this.session.strategy !== "hybrid") {
-        await attachSubtitleTracks(
-          this.options.target,
-          ctx.subtitleTracks,
-          this.subtitleResources,
-          (err, track) => {
-            console.warn(`[avbridge] subtitle ${track.id} failed: ${err.message}`);
-          }
-        );
-      }
+      await attachSubtitleTracks(
+        this.options.target,
+        ctx.subtitleTracks,
+        this.subtitleResources,
+        (err, track) => {
+          console.warn(`[avbridge] subtitle ${track.id} failed: ${err.message}`);
+        },
+        this.transport
+      );
       this.emitter.emitSticky("tracks", {
         video: ctx.videoTracks,
         audio: ctx.audioTracks,
@@ -2871,6 +2914,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
       this.startTimeupdateLoop();
       this.endedListener = () => this.emitter.emit("ended", void 0);
       this.options.target.addEventListener("ended", this.endedListener);
+      if (this.options.backgroundBehavior !== "continue" && typeof document !== "undefined") {
+        this.visibilityListener = () => this.onVisibilityChange();
+        document.addEventListener("visibilitychange", this.visibilityListener);
+      }
       this.emitter.emitSticky("ready", void 0);
       const bootstrapElapsed = performance.now() - bootstrapStart;
       dbg.info("bootstrap", `ready in ${bootstrapElapsed.toFixed(0)}ms`);
@@ -2897,7 +2944,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
       throw new Error(`no plugin available for strategy "${strategy}"`);
     }
     try {
-      this.session = await plugin.execute(this.mediaContext, this.options.target);
+      this.session = await plugin.execute(this.mediaContext, this.options.target, this.transport);
     } catch (err) {
       const chain = this.classification?.fallbackChain;
       if (chain && chain.length > 0) {
@@ -2970,7 +3017,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
         continue;
       }
       try {
-        this.session = await plugin.execute(this.mediaContext, this.options.target);
+        this.session = await plugin.execute(this.mediaContext, this.options.target, this.transport);
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         errors.push(`${nextStrategy}: ${msg}`);
@@ -2993,8 +3040,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
       }
       return;
     }
-    this.emitter.emit("error", new Error(
-      `all fallback strategies failed: ${errors.join("; ")}`
+    this.emitter.emit("error", new AvbridgeError(
+      ERR_ALL_STRATEGIES_EXHAUSTED,
+      `All playback strategies failed: ${errors.join("; ")}`,
+      "This file may require a codec or container that isn't available in this browser. Try the fallback strategy or check browser codec support."
     ));
   }
   // ── Stall supervision ─────────────────────────────────────────────────
@@ -3046,7 +3095,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
   // ── Public: manual strategy switch ────────────────────────────────────
   /** Manually switch to a different playback strategy. Preserves current position and play/pause state. Concurrent calls are serialized. */
   async setStrategy(strategy, reason) {
-    if (!this.mediaContext) throw new Error("player not ready");
+    if (!this.mediaContext) throw new AvbridgeError(ERR_PLAYER_NOT_READY, "Player not ready \u2014 wait for the 'ready' event before calling playback methods.", "Await the 'ready' event or check player.readyState before calling play/pause/seek.");
     if (this.session?.strategy === strategy) return;
     this.switchingPromise = this.switchingPromise.then(
       () => this.doSetStrategy(strategy, reason)
@@ -3075,7 +3124,7 @@ var UnifiedPlayer = class _UnifiedPlayer {
     }
     const plugin = this.registry.findFor(this.mediaContext, strategy);
     if (!plugin) throw new Error(`no plugin available for strategy "${strategy}"`);
-    this.session = await plugin.execute(this.mediaContext, this.options.target);
+    this.session = await plugin.execute(this.mediaContext, this.options.target, this.transport);
     this.emitter.emitSticky("strategy", {
       strategy,
       reason: switchReason
@@ -3109,26 +3158,56 @@ var UnifiedPlayer = class _UnifiedPlayer {
   }
   /** Begin or resume playback. Throws if the player is not ready. */
   async play() {
-    if (!this.session) throw new Error("player not ready");
+    if (!this.session) throw new AvbridgeError(ERR_PLAYER_NOT_READY, "Player not ready \u2014 wait for the 'ready' event before calling playback methods.", "Await the 'ready' event or check player.readyState before calling play/pause/seek.");
+    this.userIntent = "play";
+    this.autoPausedForVisibility = false;
     await this.session.play();
   }
   /** Pause playback. No-op if the player is not ready or already paused. */
   pause() {
+    this.userIntent = "pause";
+    this.autoPausedForVisibility = false;
     this.session?.pause();
   }
+  /**
+   * Handle browser tab visibility changes. On hide: pause if the user
+   * had been playing. On show: resume if we were the one who paused.
+   * Skips when `backgroundBehavior: "continue"` is set (listener isn't
+   * installed in that case).
+   */
+  onVisibilityChange() {
+    if (!this.session) return;
+    const action = decideVisibilityAction({
+      hidden: document.hidden,
+      userIntent: this.userIntent,
+      sessionIsPlaying: !this.options.target.paused,
+      autoPausedForVisibility: this.autoPausedForVisibility
+    });
+    if (action === "pause") {
+      this.autoPausedForVisibility = true;
+      dbg.info("visibility", "tab hidden \u2014 auto-paused");
+      this.session.pause();
+    } else if (action === "resume") {
+      this.autoPausedForVisibility = false;
+      dbg.info("visibility", "tab visible \u2014 auto-resuming");
+      void this.session.play().catch((err) => {
+        console.warn("[avbridge] auto-resume after tab return failed:", err);
+      });
+    }
+  }
   /** Seek to the given time in seconds. Throws if the player is not ready. */
   async seek(time) {
-    if (!this.session) throw new Error("player not ready");
+    if (!this.session) throw new AvbridgeError(ERR_PLAYER_NOT_READY, "Player not ready \u2014 wait for the 'ready' event before calling playback methods.", "Await the 'ready' event or check player.readyState before calling play/pause/seek.");
     await this.session.seek(time);
   }
   /** Switch the active audio track by track ID. Throws if the player is not ready. */
   async setAudioTrack(id) {
-    if (!this.session) throw new Error("player not ready");
+    if (!this.session) throw new AvbridgeError(ERR_PLAYER_NOT_READY, "Player not ready \u2014 wait for the 'ready' event before calling playback methods.", "Await the 'ready' event or check player.readyState before calling play/pause/seek.");
     await this.session.setAudioTrack(id);
   }
   /** Switch the active subtitle track by track ID, or pass `null` to disable subtitles. */
   async setSubtitleTrack(id) {
-    if (!this.session) throw new Error("player not ready");
+    if (!this.session) throw new AvbridgeError(ERR_PLAYER_NOT_READY, "Player not ready \u2014 wait for the 'ready' event before calling playback methods.", "Await the 'ready' event or check player.readyState before calling play/pause/seek.");
     await this.session.setSubtitleTrack(id);
   }
   /** Return a snapshot of current diagnostics: container, codecs, strategy, runtime stats, and strategy history. */
@@ -3160,6 +3239,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
       this.options.target.removeEventListener("ended", this.endedListener);
       this.endedListener = null;
     }
+    if (this.visibilityListener) {
+      document.removeEventListener("visibilitychange", this.visibilityListener);
+      this.visibilityListener = null;
+    }
     if (this.session) {
       await this.session.destroy();
       this.session = null;
@@ -3171,6 +3254,14 @@ var UnifiedPlayer = class _UnifiedPlayer {
 async function createPlayer(options) {
   return UnifiedPlayer.create(options);
 }
+function decideVisibilityAction(state) {
+  if (state.hidden) {
+    if (state.userIntent === "play" && state.sessionIsPlaying) return "pause";
+    return "noop";
+  }
+  if (state.autoPausedForVisibility) return "resume";
+  return "noop";
+}
 function buildInitialDecision(initial, ctx) {
   const natural = classifyContext(ctx);
   const cls = strategyToClass(initial, natural);
@@ -3209,6 +3300,6 @@ function defaultFallbackChain(strategy) {
   }
 }
 
-export { UnifiedPlayer, avbridgeAudioToMediabunny, avbridgeVideoToMediabunny, buildMediabunnySourceFromInput, classifyContext, createPlayer, probe, srtToVtt };
-//# sourceMappingURL=chunk-DMWARSEF.js.map
-//# sourceMappingURL=chunk-DMWARSEF.js.map
+export { FALLBACK_AUDIO_CODECS, FALLBACK_VIDEO_CODECS, NATIVE_AUDIO_CODECS, NATIVE_VIDEO_CODECS, UnifiedPlayer, classifyContext, createPlayer };
+//# sourceMappingURL=chunk-KY2GPCT7.js.map
+//# sourceMappingURL=chunk-KY2GPCT7.js.map