avbridge 2.3.0 → 2.6.0

package/dist/element-browser.js

@@ -30085,6 +30085,60 @@ var init_avi = __esm({
   }
 });
 
+// src/subtitles/render.ts
+function parseVtt(text) {
+  const cues = [];
+  const blocks = text.replace(/\r\n/g, "\n").split(/\n{2,}/);
+  for (const block of blocks) {
+    const lines = block.split("\n").filter(Boolean);
+    if (lines.length === 0 || lines[0] === "WEBVTT") continue;
+    const timingIdx = lines.findIndex((l) => l.includes("-->"));
+    if (timingIdx < 0) continue;
+    const m = /(\d{2}):(\d{2}):(\d{2})\.(\d{3})\s*-->\s*(\d{2}):(\d{2}):(\d{2})\.(\d{3})/.exec(
+      lines[timingIdx]
+    );
+    if (!m) continue;
+    const t = (h, mm, s, ms) => Number(h) * 3600 + Number(mm) * 60 + Number(s) + Number(ms) / 1e3;
+    cues.push({
+      start: t(m[1], m[2], m[3], m[4]),
+      end: t(m[5], m[6], m[7], m[8]),
+      text: lines.slice(timingIdx + 1).join("\n")
+    });
+  }
+  return cues;
+}
+var SubtitleOverlay;
+var init_render = __esm({
+  "src/subtitles/render.ts"() {
+    SubtitleOverlay = class {
+      el;
+      cues = [];
+      constructor(parent) {
+        this.el = document.createElement("div");
+        this.el.style.cssText = "position:absolute;left:0;right:0;bottom:8%;text-align:center;color:white;text-shadow:0 0 4px black;font-family:sans-serif;font-size:1.4em;pointer-events:none;";
+        parent.appendChild(this.el);
+      }
+      loadVtt(text) {
+        this.cues = parseVtt(text);
+      }
+      update(currentTime) {
+        const active = this.cues.find((c) => currentTime >= c.start && currentTime <= c.end);
+        this.el.textContent = active?.text ?? "";
+      }
+      /** Set the currently-displayed text directly (bypasses loadVtt/update). */
+      setText(text) {
+        if (this.el.textContent !== text) {
+          this.el.textContent = text;
+        }
+      }
+      destroy() {
+        this.el.remove();
+        this.cues = [];
+      }
+    };
+  }
+});
+
 // node_modules/libavjs-webcodecs-bridge/dist/libavjs-webcodecs-bridge.mjs
 var libavjs_webcodecs_bridge_exports = {};
 __export(libavjs_webcodecs_bridge_exports, {
@@ -31002,6 +31056,145 @@ var init_libav_import = __esm({
   }
 });
 
+// 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 fmt2 = (h, mm, s, ms) => `${h.padStart(2, "0")}:${mm}:${s}.${ms.padEnd(3, "0").slice(0, 3)}`;
+  return `${fmt2(m[1], m[2], m[3], m[4])} --> ${fmt2(m[5], m[6], m[7], m[8])}${m[9] ?? ""}`;
+}
+var init_srt = __esm({
+  "src/subtitles/srt.ts"() {
+  }
+});
+
+// src/subtitles/vtt.ts
+function isVtt(text) {
+  const trimmed = text.replace(/^\ufeff/, "").trimStart();
+  return trimmed.startsWith("WEBVTT");
+}
+var init_vtt = __esm({
+  "src/subtitles/vtt.ts"() {
+  }
+});
+
+// src/subtitles/index.ts
+var subtitles_exports = {};
+__export(subtitles_exports, {
+  SubtitleOverlay: () => SubtitleOverlay,
+  SubtitleResourceBag: () => SubtitleResourceBag,
+  attachSubtitleTracks: () => attachSubtitleTracks,
+  discoverSidecars: () => discoverSidecars,
+  srtToVtt: () => srtToVtt
+});
+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 url2 = URL.createObjectURL(sidecarFile);
+    const langMatch = name.slice(baseName.length).match(/[._-]([a-z]{2,3})(?:[._-]|\.)/i);
+    found.push({
+      url: url2,
+      format,
+      language: langMatch?.[1]
+    });
+  }
+  return found;
+}
+async function attachSubtitleTracks(video, tracks, bag, onError, transport) {
+  const doFetch = fetchWith(transport);
+  for (const t of Array.from(video.querySelectorAll("track[data-avbridge]"))) {
+    t.remove();
+  }
+  for (const t of tracks) {
+    if (!t.sidecarUrl) continue;
+    try {
+      let url2 = t.sidecarUrl;
+      if (t.format === "srt") {
+        const res = await doFetch(t.sidecarUrl, transport?.requestInit);
+        const text = await res.text();
+        const vtt = srtToVtt(text);
+        const blob = new Blob([vtt], { type: "text/vtt" });
+        url2 = bag ? bag.createObjectURL(blob) : URL.createObjectURL(blob);
+      } else if (t.format === "vtt") {
+        const res = await doFetch(t.sidecarUrl, transport?.requestInit);
+        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 = url2;
+      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);
+    }
+  }
+}
+var SubtitleResourceBag;
+var init_subtitles2 = __esm({
+  "src/subtitles/index.ts"() {
+    init_transport();
+    init_srt();
+    init_vtt();
+    init_srt();
+    init_render();
+    SubtitleResourceBag = class {
+      urls = /* @__PURE__ */ new Set();
+      /** Track an externally-created blob URL (e.g. from `discoverSidecars`). */
+      track(url2) {
+        this.urls.add(url2);
+      }
+      /** Convenience: create a blob URL and track it in one call. */
+      createObjectURL(blob) {
+        const url2 = URL.createObjectURL(blob);
+        this.urls.add(url2);
+        return url2;
+      }
+      /** Revoke every tracked URL. Idempotent — safe to call multiple times. */
+      revokeAll() {
+        for (const u of this.urls) URL.revokeObjectURL(u);
+        this.urls.clear();
+      }
+    };
+  }
+});
+
 // src/events.ts
 var TypedEmitter = class {
   listeners = {};
@@ -31692,7 +31885,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;
       }
@@ -31941,30 +32134,49 @@ var MseSink = class {
 async function createRemuxPipeline(ctx, video) {
   const mb = await Promise.resolve().then(() => (init_src(), src_exports));
   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;
@@ -32089,6 +32301,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++;
@@ -32148,7 +32384,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;
@@ -32172,6 +32420,7 @@ async function createRemuxSession(context, video) {
 }
 
 // src/strategies/fallback/video-renderer.ts
+init_render();
 function isDebug() {
   return typeof globalThis !== "undefined" && !!globalThis.AVBRIDGE_DEBUG;
 }
@@ -32201,6 +32450,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;
@@ -32226,6 +32478,15 @@ var VideoRenderer = class {
   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
@@ -32269,9 +32530,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) {
@@ -32400,6 +32732,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 = "";
   }
@@ -32658,67 +32995,222 @@ function pickLibavVariant(ctx) {
   return "webcodecs";
 }
 
-// src/strategies/hybrid/decoder.ts
-async function startHybridDecoder(opts) {
-  const variant = pickLibavVariant(opts.context);
-  const libav = await loadLibav(variant);
-  const bridge = await loadBridge();
-  const { prepareLibavInput: prepareLibavInput2 } = await Promise.resolve().then(() => (init_libav_http_reader(), libav_http_reader_exports));
-  const inputHandle = await prepareLibavInput2(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;
-  if (!videoStream && !audioStream) {
-    throw new Error("hybrid decoder: file has no decodable streams");
-  }
-  let fatalHandler = null;
-  let fatalFired = false;
-  function fireFatal(reason) {
-    if (fatalFired) return;
-    fatalFired = true;
-    fatalHandler?.(reason);
+// src/util/libav-demux.ts
+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;
   }
-  let videoDecoder = null;
-  let videoTimeBase;
-  if (videoStream) {
-    try {
-      const config = await bridge.videoStreamToConfig(libav, videoStream);
-      if (!config) throw new Error("bridge returned null config");
-      const supported = await VideoDecoder.isConfigSupported(config);
-      if (!supported.supported) throw new Error(`VideoDecoder does not support config: ${JSON.stringify(config)}`);
-      videoDecoder = new VideoDecoder({
-        output: (frame) => {
-          opts.renderer.enqueue(frame);
-          videoFramesDecoded++;
-        },
-        error: (err) => {
-          console.error("[avbridge] WebCodecs VideoDecoder error:", err);
-          fireFatal(`WebCodecs VideoDecoder error: ${err.message}`);
-        }
-      });
-      videoDecoder.configure(config);
-      if (videoStream.time_base_num && videoStream.time_base_den) {
-        videoTimeBase = [videoStream.time_base_num, videoStream.time_base_den];
-      }
-    } catch (err) {
-      console.error("[avbridge] hybrid: failed to init WebCodecs VideoDecoder:", err);
-      fireFatal(`WebCodecs VideoDecoder init failed: ${err.message}`);
-      await inputHandle.detach().catch(() => {
-      });
-      throw err;
-    }
+  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;
   }
-  let audioDec = null;
-  let audioTimeBase;
-  if (audioStream) {
-    try {
-      const [, c, pkt, frame] = await libav.ff_init_decoder(audioStream.codec_id, {
-        codecpar: audioStream.codecpar
-      });
-      audioDec = { c, pkt, frame };
-      if (audioStream.time_base_num && audioStream.time_base_den) {
-        audioTimeBase = [audioStream.time_base_num, audioStream.time_base_den];
+  const fallback = nextUs();
+  pkt.pts = fallback;
+  pkt.ptshi = 0;
+  pkt.time_base_num = 1;
+  pkt.time_base_den = 1e6;
+}
+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);
+}
+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;
+}
+
+// src/strategies/hybrid/decoder.ts
+async function startHybridDecoder(opts) {
+  const variant = pickLibavVariant(opts.context);
+  const libav = await loadLibav(variant);
+  const bridge = await loadBridge();
+  const { prepareLibavInput: prepareLibavInput2 } = await Promise.resolve().then(() => (init_libav_http_reader(), libav_http_reader_exports));
+  const inputHandle = await prepareLibavInput2(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 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");
+  }
+  let fatalHandler = null;
+  let fatalFired = false;
+  function fireFatal(reason) {
+    if (fatalFired) return;
+    fatalFired = true;
+    fatalHandler?.(reason);
+  }
+  let videoDecoder = null;
+  let videoTimeBase;
+  if (videoStream) {
+    try {
+      const config = await bridge.videoStreamToConfig(libav, videoStream);
+      if (!config) throw new Error("bridge returned null config");
+      const supported = await VideoDecoder.isConfigSupported(config);
+      if (!supported.supported) throw new Error(`VideoDecoder does not support config: ${JSON.stringify(config)}`);
+      videoDecoder = new VideoDecoder({
+        output: (frame) => {
+          opts.renderer.enqueue(frame);
+          videoFramesDecoded++;
+        },
+        error: (err) => {
+          console.error("[avbridge] WebCodecs VideoDecoder error:", err);
+          fireFatal(`WebCodecs VideoDecoder error: ${err.message}`);
+        }
+      });
+      videoDecoder.configure(config);
+      if (videoStream.time_base_num && videoStream.time_base_den) {
+        videoTimeBase = [videoStream.time_base_num, videoStream.time_base_den];
+      }
+    } catch (err) {
+      console.error("[avbridge] hybrid: failed to init WebCodecs VideoDecoder:", err);
+      fireFatal(`WebCodecs VideoDecoder init failed: ${err.message}`);
+      await inputHandle.detach().catch(() => {
+      });
+      throw err;
+    }
+  }
+  let audioDec = null;
+  let audioTimeBase;
+  if (audioStream) {
+    try {
+      const [, c, pkt, frame] = await libav.ff_init_decoder(audioStream.codec_id, {
+        codecpar: audioStream.codecpar
+      });
+      audioDec = { c, pkt, frame };
+      if (audioStream.time_base_num && audioStream.time_base_den) {
+        audioTimeBase = [audioStream.time_base_num, audioStream.time_base_den];
       }
     } catch (err) {
       console.warn(
@@ -32964,6 +33456,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) {
@@ -33021,158 +33578,6 @@ 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 Promise.resolve().then(() => (init_libav_import(), libav_import_exports));
@@ -33184,6 +33589,35 @@ async function loadBridge() {
   }
 }
 
+// src/util/time-ranges.ts
+function makeTimeRanges(ranges) {
+  const frozen = ranges.slice();
+  const impl = {
+    get length() {
+      return frozen.length;
+    },
+    start(index) {
+      if (index < 0 || index >= frozen.length) {
+        throw new DOMException(
+          `TimeRanges.start: index ${index} out of range (length=${frozen.length})`,
+          "IndexSizeError"
+        );
+      }
+      return frozen[index][0];
+    },
+    end(index) {
+      if (index < 0 || index >= frozen.length) {
+        throw new DOMException(
+          `TimeRanges.end: index ${index} out of range (length=${frozen.length})`,
+          "IndexSizeError"
+        );
+      }
+      return frozen[index][1];
+    }
+  };
+  return impl;
+}
+
 // src/strategies/hybrid/index.ts
 var READY_AUDIO_BUFFER_SECONDS = 0.3;
 var READY_TIMEOUT_SECONDS = 10;
@@ -33241,6 +33675,18 @@ async function createHybridSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "readyState", {
+    configurable: true,
+    get: () => {
+      if (!renderer.hasFrames()) return 0;
+      if (!audio.isPlaying() && audio.bufferAhead() <= 0 && !audio.isNoAudio()) return 1;
+      return 2;
+    }
+  });
+  Object.defineProperty(target, "seekable", {
+    configurable: true,
+    get: () => makeTimeRanges(ctx.duration && Number.isFinite(ctx.duration) && ctx.duration > 0 ? [[0, ctx.duration]] : [])
+  });
   async function waitForBuffer() {
     const start = performance.now();
     while (true) {
@@ -33285,7 +33731,24 @@ async function createHybridSession(ctx, target, transport) {
     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) {
     },
@@ -33305,6 +33768,8 @@ async function createHybridSession(ctx, target, transport) {
         delete target.paused;
         delete target.volume;
         delete target.muted;
+        delete target.readyState;
+        delete target.seekable;
       } catch {
       }
     },
@@ -33326,7 +33791,8 @@ async function startDecoder(opts) {
   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");
   }
@@ -33542,7 +34008,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;
@@ -33552,7 +34018,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) {
@@ -33580,7 +34046,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;
@@ -33591,7 +34057,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++;
@@ -33627,17 +34093,80 @@ async function startDecoder(opts) {
       } catch {
       }
       try {
-        await libav.av_packet_free?.(readPkt);
-      } catch {
+        await libav.av_packet_free?.(readPkt);
+      } catch {
+      }
+      try {
+        await libav.avformat_close_input_js(fmt_ctx);
+      } catch {
+      }
+      try {
+        await inputHandle.detach();
+      } 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 {
-        await libav.avformat_close_input_js(fmt_ctx);
-      } catch {
+        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 {
-        await inputHandle.detach();
+        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;
@@ -33695,135 +34224,6 @@ 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 Promise.resolve().then(() => (init_libav_import(), libav_import_exports));
@@ -33893,6 +34293,18 @@ async function createFallbackSession(ctx, target, transport) {
       get: () => ctx.duration ?? NaN
     });
   }
+  Object.defineProperty(target, "readyState", {
+    configurable: true,
+    get: () => {
+      if (!renderer.hasFrames()) return 0;
+      if (!audio.isPlaying() && audio.bufferAhead() <= 0 && !audio.isNoAudio()) return 1;
+      return 2;
+    }
+  });
+  Object.defineProperty(target, "seekable", {
+    configurable: true,
+    get: () => makeTimeRanges(ctx.duration && Number.isFinite(ctx.duration) && ctx.duration > 0 ? [[0, ctx.duration]] : [])
+  });
   async function waitForBuffer() {
     const start = performance.now();
     let firstFrameAtMs = 0;
@@ -33961,7 +34373,24 @@ async function createFallbackSession(ctx, target, transport) {
     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) {
     },
@@ -33978,6 +34407,8 @@ async function createFallbackSession(ctx, target, transport) {
         delete target.paused;
         delete target.volume;
         delete target.muted;
+        delete target.readyState;
+        delete target.seekable;
       } catch {
       }
     },
@@ -34015,123 +34446,8 @@ function registerBuiltins(registry) {
   registry.register(fallbackPlugin);
 }
 
-// src/subtitles/index.ts
-init_transport();
-
-// 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 fmt2 = (h, mm, s, ms) => `${h.padStart(2, "0")}:${mm}:${s}.${ms.padEnd(3, "0").slice(0, 3)}`;
-  return `${fmt2(m[1], m[2], m[3], m[4])} --> ${fmt2(m[5], m[6], m[7], m[8])}${m[9] ?? ""}`;
-}
-
-// 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 url2 = URL.createObjectURL(sidecarFile);
-    const langMatch = name.slice(baseName.length).match(/[._-]([a-z]{2,3})(?:[._-]|\.)/i);
-    found.push({
-      url: url2,
-      format,
-      language: langMatch?.[1]
-    });
-  }
-  return found;
-}
-var SubtitleResourceBag = class {
-  urls = /* @__PURE__ */ new Set();
-  /** Track an externally-created blob URL (e.g. from `discoverSidecars`). */
-  track(url2) {
-    this.urls.add(url2);
-  }
-  /** Convenience: create a blob URL and track it in one call. */
-  createObjectURL(blob) {
-    const url2 = URL.createObjectURL(blob);
-    this.urls.add(url2);
-    return url2;
-  }
-  /** 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, transport) {
-  const doFetch = fetchWith(transport);
-  for (const t of Array.from(video.querySelectorAll("track[data-avbridge]"))) {
-    t.remove();
-  }
-  for (const t of tracks) {
-    if (!t.sidecarUrl) continue;
-    try {
-      let url2 = t.sidecarUrl;
-      if (t.format === "srt") {
-        const res = await doFetch(t.sidecarUrl, transport?.requestInit);
-        const text = await res.text();
-        const vtt = srtToVtt(text);
-        const blob = new Blob([vtt], { type: "text/vtt" });
-        url2 = bag ? bag.createObjectURL(blob) : URL.createObjectURL(blob);
-      } else if (t.format === "vtt") {
-        const res = await doFetch(t.sidecarUrl, transport?.requestInit);
-        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 = url2;
-      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
+init_subtitles2();
 init_debug();
 init_errors();
 var UnifiedPlayer = class _UnifiedPlayer {
@@ -34245,17 +34561,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}`);
-          },
-          this.transport
-        );
-      }
+      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,
@@ -34721,7 +35035,20 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
   _strategy = null;
   _strategyClass = null;
   _audioTracks = [];
+  /** Subtitle tracks reported by the active UnifiedPlayer (options.subtitles
+   *  + embedded container tracks + programmatic addSubtitle calls). */
   _subtitleTracks = [];
+  /** Subtitle tracks derived from light-DOM `<track>` children. Maintained
+   *  by _syncTextTracks on every mutation. Merged into the public
+   *  `subtitleTracks` getter so the player's settings menu sees them. */
+  _htmlTrackInfo = [];
+  /**
+   * External subtitle list forwarded to `createPlayer()` on the next
+   * bootstrap. Setting this after bootstrap queues it for the next
+   * source change; consumers that need to swap subtitles mid-playback
+   * should set `source` to reload.
+   */
+  _subtitles = null;
   /**
    * Initial strategy preference. `"auto"` means "let the classifier decide";
    * any other value is passed to `createPlayer({ initialStrategy })` and
@@ -34834,12 +35161,28 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
   _syncTextTracks() {
     const existing = this._videoEl.querySelectorAll("track");
     for (const t of Array.from(existing)) t.remove();
+    this._htmlTrackInfo = [];
+    let htmlIdx = 0;
     for (const child of Array.from(this.children)) {
       if (child.tagName === "TRACK") {
-        const clone = child.cloneNode(true);
+        const track = child;
+        const clone = track.cloneNode(true);
         this._videoEl.appendChild(clone);
+        const src = track.getAttribute("src") ?? void 0;
+        const format = src?.toLowerCase().endsWith(".srt") ? "srt" : "vtt";
+        this._htmlTrackInfo.push({
+          id: 1e4 + htmlIdx,
+          format,
+          language: track.srclang || track.getAttribute("label") || void 0,
+          sidecarUrl: src
+        });
+        htmlIdx++;
       }
     }
+    this._dispatch("trackschange", {
+      audioTracks: this._audioTracks,
+      subtitleTracks: this.subtitleTracks
+    });
   }
   /** Internal src setter — separate from the property setter so the
    * attributeChangedCallback can use it without re-entering reflection. */
@@ -34877,7 +35220,8 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
         // Honor the consumer's preferred initial strategy. "auto" means
         // "let the classifier decide" — the createPlayer call simply doesn't
         // pass initialStrategy in that case.
-        ...this._preferredStrategy !== "auto" ? { initialStrategy: this._preferredStrategy } : {}
+        ...this._preferredStrategy !== "auto" ? { initialStrategy: this._preferredStrategy } : {},
+        ...this._subtitles ? { subtitles: this._subtitles } : {}
       });
     } catch (err) {
       if (id !== this._bootstrapId || this._destroyed) return;
@@ -35166,7 +35510,48 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
     return this._audioTracks;
   }
   get subtitleTracks() {
-    return this._subtitleTracks;
+    return this._htmlTrackInfo.length === 0 ? this._subtitleTracks : [...this._subtitleTracks, ...this._htmlTrackInfo];
+  }
+  /**
+   * External subtitle files to attach when the source loads. Takes effect
+   * on the next bootstrap — set before assigning `source`, or reload via
+   * `load()` after changing. For dynamic post-bootstrap addition, use
+   * `addSubtitle()` instead.
+   *
+   * @example
+   * el.subtitles = [{ url: "/en.srt", format: "srt", language: "en" }];
+   * el.src = "/movie.mp4";
+   */
+  get subtitles() {
+    return this._subtitles;
+  }
+  set subtitles(value) {
+    this._subtitles = value;
+  }
+  /**
+   * Attach a subtitle track to the current playback without rebuilding
+   * the player. Works while the element is playing — converts SRT to
+   * VTT if needed, adds a `<track>` to the inner `<video>`. Canvas
+   * strategies pick up the new track via their textTracks watcher.
+   */
+  async addSubtitle(subtitle) {
+    const { attachSubtitleTracks: attachSubtitleTracks2 } = await Promise.resolve().then(() => (init_subtitles2(), subtitles_exports));
+    const format = subtitle.format ?? (subtitle.url.endsWith(".srt") ? "srt" : "vtt");
+    const track = {
+      id: this._subtitleTracks.length,
+      format,
+      language: subtitle.language,
+      sidecarUrl: subtitle.url
+    };
+    this._subtitleTracks.push(track);
+    await attachSubtitleTracks2(
+      this._videoEl,
+      this._subtitleTracks,
+      void 0,
+      (err, t) => {
+        console.warn(`[avbridge] subtitle ${t.id} failed: ${err.message}`);
+      }
+    );
   }
   // ── Public methods ─────────────────────────────────────────────────────
   /** Force a (re-)bootstrap if a source is currently set. */
@@ -35214,6 +35599,12 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
   getDiagnostics() {
     return this._player?.getDiagnostics() ?? null;
   }
+  addEventListener(type, listener, options) {
+    super.addEventListener(type, listener, options);
+  }
+  removeEventListener(type, listener, options) {
+    super.removeEventListener(type, listener, options);
+  }
   // ── Event helpers ──────────────────────────────────────────────────────
   _dispatch(name, detail) {
     this.dispatchEvent(new CustomEvent(name, { detail, bubbles: false }));