avbridge 2.1.2 → 2.2.0

package/CHANGELOG.md

@@ -4,6 +4,99 @@ All notable changes to **avbridge** are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0]
+
+### Added
+
+- **RealMedia playback support** (`.rm`, `.rmvb`). The custom `avbridge`
+  libav variant now includes the `rm` demuxer and every RealVideo /
+  RealAudio decoder family:
+  - Video: `rv10`, `rv20`, `rv30`, `rv40`
+  - Audio: `cook`, `ra_144`, `ra_288`, `sipr`, `atrac3`
+  These codecs have no browser decoder, so classification routes them
+  to the fallback WASM strategy. The custom variant grows by a few
+  hundred KB of WASM; the webcodecs variant is unchanged.
+- **Sniff layer recognizes `.RMF` magic bytes** and returns the new
+  `"rm"` `ContainerKind`. Probing for a `.rm` or `.rmvb` file goes
+  through libav directly (mediabunny doesn't handle RealMedia).
+- **File-picker accept list** in `demo/index.html` and
+  `demo/convert.html` now includes `.rm` and `.rmvb`.
+
+### Changed
+
+- **`VideoCodec`** gained `rv10`, `rv20`, `rv30` (existing `rv40` kept).
+- **`AudioCodec`** gained `cook`, `ra_144`, `ra_288`, `sipr`, `atrac3`.
+- **`ContainerKind`** gained `rm`.
+- **Classifier** (`src/classify/rules.ts`) — all new RV/RA codecs added
+  to `FALLBACK_VIDEO_CODECS` / `FALLBACK_AUDIO_CODECS`.
+
+### Fallback strategy performance tuning
+
+These are general-purpose improvements motivated by RealMedia testing
+but also benefit MPEG-4 Part 2 (DivX/Xvid), WMV3, and other
+software-decoded content:
+
+- **Cold-start pre-roll gate lowered 300 ms → 40 ms, timeout 10 s → 3 s.**
+  The gate used to wait for 300 ms of buffered audio before starting
+  playback. On software-decode-bound content (rv40, mpeg4 @ 720p+),
+  the decoder produces output slower than realtime, so 300 ms is
+  unreachable — the gate would sit out its 10 s timeout before the
+  first frame appeared, which the user experienced as a silent 10-
+  second hang after clicking Play. The gate now starts on 40 ms
+  audio + first frame, and the safety timeout is 3 s. A diagnostic
+  warning fires loudly if the timeout is ever hit.
+- **Decoder read batch size raised 16 KB → 64 KB.** Fewer JS↔WASM
+  `ff_read_frame_multi` / `ff_decode_multi` round trips per unit of
+  video, which measurably speeds up software decode on slow devices.
+  Queue burstiness is unchanged because the existing
+  `queueHighWater = 30` backpressure still applies.
+
+### Debug + self-diagnosis layer
+
+New: **`src/util/debug.ts`** — a runtime-toggleable verbose logging
+channel, plus unconditional warnings for suspicious conditions. The
+goal is that subtle issues self-identify in the console instead of
+requiring 10 minutes of reading diagnostics JSON.
+
+- Set `globalThis.AVBRIDGE_DEBUG = true` (or append `?avbridge_debug`
+  to a demo page URL) to enable verbose logging. Every log is
+  prefixed `[avbridge:<tag>]` so you can filter.
+- When debug is **off**, the following conditions still emit an
+  unconditional `console.warn`:
+  - **`[avbridge:cold-start] gate TIMEOUT…`** — the fallback
+    strategy's `waitForBuffer` hit its 3 s timeout with a
+    specific underflow (e.g. "audio=0 ms, frames=0"). This used to
+    silently hang playback for 10 seconds.
+  - **`[avbridge:decode-rate] decoder is running slower than
+    realtime…`** — watchdog in the fallback pump loop; fires once
+    per stall when framesDecoded/s stays below 60% of source fps
+    for ≥5 s after the first frame. Tells you the exact fps
+    ratio and names the likely cause.
+  - **`[avbridge:bootstrap] total bootstrap time <N>ms — unusually
+    slow…`** — bootstrap took >5 s end-to-end.
+  - **`[avbridge:probe] probe took <N>ms (>3000ms expected)…`** —
+    slow probe (usually a slow Range request or libav cold-start).
+  - **`[avbridge:libav-load] load "<variant>" took <N>ms
+    (>5000ms expected)…`** — slow WASM download or wrong base
+    path.
+
+### Known limitations
+
+- **rv40 / rv30 at 720p+ may still stutter** on modest CPUs. Single-
+  threaded WASM software decode of RealVideo's motion compensation is
+  fundamentally slower than realtime on many files. libav.js pthreads
+  and a WebGL YUV→RGBA upload path are both plausible follow-ups but
+  not in 2.2.0. For reference: a 1024×768 rv40 file plays at roughly
+  0.5-2× realtime on an M-series Mac depending on the bitrate. The
+  new `[avbridge:decode-rate]` watchdog flags this condition in the
+  console so the symptom is never a silent stutter.
+
+### Tests
+
+- New sniff test for `.RMF` magic bytes (`tests/sniff.test.ts`).
+- Two new classify tests for RealMedia routing (rv40+cook, rv30+ra_288).
+- Test count: 115 → **118**.
+
 ## [2.1.2]
 
 ### Fixed

package/dist/{avi-GNTV5ZOH.cjs → avi-6SJLWIWW.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
 var chunkL4NPOJ36_cjs = require('./chunk-L4NPOJ36.cjs');
-var chunkJQH6D4OE_cjs = require('./chunk-JQH6D4OE.cjs');
+var chunkG4APZMCP_cjs = require('./chunk-G4APZMCP.cjs');
 
 // src/probe/avi.ts
 async function probeWithLibav(source, sniffed) {
-  const libav = await chunkJQH6D4OE_cjs.loadLibav("avbridge");
+  const libav = await chunkG4APZMCP_cjs.loadLibav("avbridge");
   const filename = source.name ?? `input.${sniffed === "unknown" ? "bin" : sniffed}`;
   const handle = await chunkL4NPOJ36_cjs.prepareLibavInput(libav, filename, source);
   let fmt_ctx;
@@ -123,7 +123,12 @@ function ffmpegToAvbridgeVideo(name) {
       return "mpeg1";
     case "theora":
       return "theora";
+    case "rv10":
+      return "rv10";
+    case "rv20":
+      return "rv20";
     case "rv30":
+      return "rv30";
     case "rv40":
       return "rv40";
     default:
@@ -154,11 +159,21 @@ function ffmpegToAvbridgeAudio(name) {
       return "wmapro";
     case "alac":
       return "alac";
+    case "cook":
+      return "cook";
+    case "ra_144":
+      return "ra_144";
+    case "ra_288":
+      return "ra_288";
+    case "sipr":
+      return "sipr";
+    case "atrac3":
+      return "atrac3";
     default:
       return name;
   }
 }
 
 exports.probeWithLibav = probeWithLibav;
-//# sourceMappingURL=avi-GNTV5ZOH.cjs.map
-//# sourceMappingURL=avi-GNTV5ZOH.cjs.map
+//# sourceMappingURL=avi-6SJLWIWW.cjs.map
+//# sourceMappingURL=avi-6SJLWIWW.cjs.map

package/dist/avi-6SJLWIWW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/probe/avi.ts"],"names":["loadLibav","prepareLibavInput"],"mappings":"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","file":"avi-6SJLWIWW.cjs","sourcesContent":["import type {\n  AudioCodec,\n  AudioTrackInfo,\n  ContainerKind,\n  MediaContext,\n  VideoCodec,\n  VideoTrackInfo,\n} from \"../types.js\";\nimport type { NormalizedSource } from \"../util/source.js\";\nimport { prepareLibavInput, type LibavInputHandle } from \"../util/libav-http-reader.js\";\nimport { loadLibav } from \"../strategies/fallback/libav-loader.js\";\n\n/**\n * Probe AVI/ASF/FLV (and any other format mediabunny doesn't speak) via\n * libav.js. This module is `import()`-ed only when sniffing identifies one of\n * those containers.\n *\n * Critical: codec identification goes through `libav.avcodec_get_name(id)`\n * which returns the FFmpeg codec name as a string (e.g. \"h264\", \"mpeg4\",\n * \"wmv3\"). The numeric AV_CODEC_ID_* enum is *not* exposed on the libav\n * instance (only AVMEDIA_TYPE_*, AV_PIX_FMT_*, AV_SAMPLE_FMT_* and a handful\n * of others are), so comparing codec_ids against constants does not work.\n */\nexport async function probeWithLibav(\n  source: NormalizedSource,\n  sniffed: ContainerKind,\n): Promise<MediaContext> {\n  // AVI/ASF/FLV demuxers are not in any libav.js npm variant — they live in\n  // the custom \"avbridge\" build produced by `scripts/build-libav.sh`. The loader\n  // emits an actionable error if the build hasn't been run yet. Threading\n  // is OFF by default in `loadLibav` (see the comment there for why).\n  const libav = (await loadLibav(\"avbridge\")) as unknown as LibavInstance;\n\n  const filename = source.name ?? `input.${sniffed === \"unknown\" ? \"bin\" : sniffed}`;\n  // For Blob/File sources we use libav's in-memory readahead file. For URL\n  // sources we attach an HTTP block reader so libav demuxes via Range\n  // requests instead of buffering the whole file.\n  const handle: LibavInputHandle = await prepareLibavInput(libav as unknown as Parameters<typeof prepareLibavInput>[0], filename, source);\n\n  let fmt_ctx: number | undefined;\n  let streams: LibavStream[] = [];\n  try {\n    const result = await libav.ff_init_demuxer_file(filename);\n    fmt_ctx = result[0];\n    streams = result[1];\n  } catch (err) {\n    await handle.detach().catch(() => {});\n    // Errors thrown across the libav.js worker/pthread boundary aren't\n    // always Error instances — they can be plain objects, numbers (errno\n    // codes), or strings. Stringify defensively so the user-facing message\n    // never has `(undefined)` in it.\n    const inner =\n      err instanceof Error\n        ? err.message\n        : typeof err === \"object\" && err !== null\n          ? JSON.stringify(err)\n          : String(err);\n    // eslint-disable-next-line no-console\n    console.error(\"[avbridge] ff_init_demuxer_file raw error:\", err);\n    throw new Error(\n      `libav.js could not demux ${filename}. The current libav variant likely lacks the required demuxer (e.g. AVI). See vendor/libav/README.md for build instructions. (${inner || \"no message — see console for raw error\"})`,\n    );\n  }\n\n  const videoTracks: VideoTrackInfo[] = [];\n  const audioTracks: AudioTrackInfo[] = [];\n\n  for (const stream of streams) {\n    const codecName = (await safe(() => libav.avcodec_get_name(stream.codec_id))) ?? `unknown(${stream.codec_id})`;\n    // codecpar holds width/height/channels/sample_rate/profile/level/extradata\n    // for the actual stream. We have to copy it out of WASM memory.\n    const codecpar = await safe(() => libav.ff_copyout_codecpar(stream.codecpar));\n\n    if (stream.codec_type === libav.AVMEDIA_TYPE_VIDEO) {\n      videoTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeVideo(codecName),\n        width: codecpar?.width ?? 0,\n        height: codecpar?.height ?? 0,\n        fps: framerate(stream),\n      });\n    } else if (stream.codec_type === libav.AVMEDIA_TYPE_AUDIO) {\n      audioTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeAudio(codecName),\n        channels: codecpar?.channels ?? codecpar?.ch_layout_nb_channels ?? 0,\n        sampleRate: codecpar?.sample_rate ?? 0,\n      });\n    }\n  }\n\n  // We need this duration but cannot reliably get it from the streams alone\n  // for AVI; libav.js exposes it via the AVFormatContext duration helper.\n  const duration = await safeDuration(libav, fmt_ctx!);\n\n  // Close the demuxer; the strategy will reopen it later if it ends up being\n  // chosen. Probing should not pin native resources.\n  await libav.avformat_close_input_js(fmt_ctx!).catch(() => {});\n  await handle.detach().catch(() => {});\n\n  return {\n    source: source.original,\n    name: source.name,\n    byteLength: source.byteLength,\n    container: sniffed === \"unknown\" ? \"unknown\" : sniffed,\n    videoTracks,\n    audioTracks,\n    subtitleTracks: [],\n    probedBy: \"libav\",\n    duration,\n  };\n}\n\nfunction framerate(stream: LibavStream): number | undefined {\n  if (typeof stream.avg_frame_rate_num === \"number\" && stream.avg_frame_rate_den) {\n    return stream.avg_frame_rate_num / stream.avg_frame_rate_den;\n  }\n  if (stream.avg_frame_rate && typeof stream.avg_frame_rate === \"object\") {\n    if (stream.avg_frame_rate.den === 0) return undefined;\n    return stream.avg_frame_rate.num / stream.avg_frame_rate.den;\n  }\n  return undefined;\n}\n\nasync function safeDuration(libav: LibavInstance, fmt_ctx: number): Promise<number | undefined> {\n  try {\n    // `AVFormatContext.duration` is an int64 in microseconds (AV_TIME_BASE).\n    // libav.js exposes it as a split lo/hi pair the same way it does for\n    // packet pts — `AVFormatContext_duration(ctx)` returns the low 32 bits,\n    // `AVFormatContext_durationhi(ctx)` returns the high 32 bits. Reading\n    // only the low half (the previous bug) gave garbage for any file whose\n    // duration > ~35 minutes, and zero for shorter files where the value\n    // happened to live in the high half.\n    const lo = await libav.AVFormatContext_duration?.(fmt_ctx);\n    const hi = await libav.AVFormatContext_durationhi?.(fmt_ctx);\n    if (typeof lo !== \"number\" || typeof hi !== \"number\") return undefined;\n\n    // AV_NOPTS_VALUE = -2^63 → ptshi = -2147483648, pts = 0. Means \"unknown\".\n    if (hi === -2147483648 && lo === 0) return undefined;\n\n    // Reconstruct the 64-bit value. Prefer libav's helper when available\n    // because it correctly handles signed 32-bit two's complement.\n    const us =\n      typeof libav.i64tof64 === \"function\"\n        ? libav.i64tof64(lo, hi)\n        : hi * 0x100000000 + lo + (lo < 0 ? 0x100000000 : 0);\n\n    if (!Number.isFinite(us) || us <= 0) return undefined;\n    return us / 1_000_000;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function safe<T>(fn: () => Promise<T> | T): Promise<T | undefined> {\n  try { return await fn(); } catch { return undefined; }\n}\n\n/** Map FFmpeg codec names to avbridge video codec identifiers. */\nfunction ffmpegToAvbridgeVideo(name: string): VideoCodec {\n  switch (name) {\n    case \"h264\":   return \"h264\";\n    case \"hevc\":   return \"h265\";\n    case \"vp8\":    return \"vp8\";\n    case \"vp9\":    return \"vp9\";\n    case \"av1\":    return \"av1\";\n    case \"mpeg4\":  return \"mpeg4\";   // MPEG-4 Part 2 / DivX / Xvid\n    case \"msmpeg4v1\":\n    case \"msmpeg4v2\":\n    case \"msmpeg4v3\":                 // a.k.a. DIV3\n      return \"mpeg4\";\n    case \"wmv1\":\n    case \"wmv2\":\n    case \"wmv3\":\n      return \"wmv3\";\n    case \"vc1\":    return \"vc1\";\n    case \"mpeg2video\": return \"mpeg2\";\n    case \"mpeg1video\": return \"mpeg1\";\n    case \"theora\": return \"theora\";\n    case \"rv10\":   return \"rv10\";\n    case \"rv20\":   return \"rv20\";\n    case \"rv30\":   return \"rv30\";\n    case \"rv40\":   return \"rv40\";\n    default:       return name as VideoCodec;\n  }\n}\n\nfunction ffmpegToAvbridgeAudio(name: string): AudioCodec {\n  switch (name) {\n    case \"aac\":    return \"aac\";\n    case \"mp3\":\n    case \"mp3float\":\n      return \"mp3\";\n    case \"opus\":   return \"opus\";\n    case \"vorbis\": return \"vorbis\";\n    case \"flac\":   return \"flac\";\n    case \"ac3\":    return \"ac3\";\n    case \"eac3\":   return \"eac3\";\n    case \"wmav1\":\n    case \"wmav2\":  return \"wmav2\";\n    case \"wmapro\": return \"wmapro\";\n    case \"alac\":   return \"alac\";\n    case \"cook\":   return \"cook\";\n    case \"ra_144\": return \"ra_144\";\n    case \"ra_288\": return \"ra_288\";\n    case \"sipr\":   return \"sipr\";\n    case \"atrac3\": return \"atrac3\";\n    default:       return name as AudioCodec;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Minimal structural types for the slice of libav.js we touch.\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface LibavStream {\n  index: number;\n  codec_type: number;\n  codec_id: number;\n  codecpar: number;\n  avg_frame_rate?: { num: number; den: number };\n  avg_frame_rate_num?: number;\n  avg_frame_rate_den?: number;\n}\n\ninterface LibavCodecpar {\n  width?: number;\n  height?: number;\n  channels?: number;\n  ch_layout_nb_channels?: number;\n  sample_rate?: number;\n  profile?: number;\n  level?: number;\n}\n\ninterface LibavInstance {\n  mkreadaheadfile(name: string, blob: Blob): Promise<void>;\n  unlinkreadaheadfile(name: string): Promise<void>;\n  ff_init_demuxer_file(name: string): Promise<[number, LibavStream[]]>;\n  ff_copyout_codecpar(codecpar: number): Promise<LibavCodecpar>;\n  avcodec_get_name(codec_id: number): Promise<string>;\n  avformat_close_input_js(ctx: number): Promise<void>;\n  AVFormatContext_duration?(ctx: number): Promise<number>;\n  AVFormatContext_durationhi?(ctx: number): Promise<number>;\n  i64tof64?(lo: number, hi: number): number;\n\n  AVMEDIA_TYPE_VIDEO: number;\n  AVMEDIA_TYPE_AUDIO: number;\n}\n"]}

package/dist/{avi-V6HYQVR2.js → avi-GCGM7OJI.js}

@@ -1,5 +1,5 @@
 import { prepareLibavInput } from './chunk-WD2ZNQA7.js';
-import { loadLibav } from './chunk-EJH67FXG.js';
+import { loadLibav } from './chunk-5DMTJVIU.js';
 
 // src/probe/avi.ts
 async function probeWithLibav(source, sniffed) {
@@ -121,7 +121,12 @@ function ffmpegToAvbridgeVideo(name) {
       return "mpeg1";
     case "theora":
       return "theora";
+    case "rv10":
+      return "rv10";
+    case "rv20":
+      return "rv20";
     case "rv30":
+      return "rv30";
     case "rv40":
       return "rv40";
     default:
@@ -152,11 +157,21 @@ function ffmpegToAvbridgeAudio(name) {
       return "wmapro";
     case "alac":
       return "alac";
+    case "cook":
+      return "cook";
+    case "ra_144":
+      return "ra_144";
+    case "ra_288":
+      return "ra_288";
+    case "sipr":
+      return "sipr";
+    case "atrac3":
+      return "atrac3";
     default:
       return name;
   }
 }
 
 export { probeWithLibav };
-//# sourceMappingURL=avi-V6HYQVR2.js.map
-//# sourceMappingURL=avi-V6HYQVR2.js.map
+//# sourceMappingURL=avi-GCGM7OJI.js.map
+//# sourceMappingURL=avi-GCGM7OJI.js.map

package/dist/avi-GCGM7OJI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/probe/avi.ts"],"names":[],"mappings":"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","file":"avi-GCGM7OJI.js","sourcesContent":["import type {\n  AudioCodec,\n  AudioTrackInfo,\n  ContainerKind,\n  MediaContext,\n  VideoCodec,\n  VideoTrackInfo,\n} from \"../types.js\";\nimport type { NormalizedSource } from \"../util/source.js\";\nimport { prepareLibavInput, type LibavInputHandle } from \"../util/libav-http-reader.js\";\nimport { loadLibav } from \"../strategies/fallback/libav-loader.js\";\n\n/**\n * Probe AVI/ASF/FLV (and any other format mediabunny doesn't speak) via\n * libav.js. This module is `import()`-ed only when sniffing identifies one of\n * those containers.\n *\n * Critical: codec identification goes through `libav.avcodec_get_name(id)`\n * which returns the FFmpeg codec name as a string (e.g. \"h264\", \"mpeg4\",\n * \"wmv3\"). The numeric AV_CODEC_ID_* enum is *not* exposed on the libav\n * instance (only AVMEDIA_TYPE_*, AV_PIX_FMT_*, AV_SAMPLE_FMT_* and a handful\n * of others are), so comparing codec_ids against constants does not work.\n */\nexport async function probeWithLibav(\n  source: NormalizedSource,\n  sniffed: ContainerKind,\n): Promise<MediaContext> {\n  // AVI/ASF/FLV demuxers are not in any libav.js npm variant — they live in\n  // the custom \"avbridge\" build produced by `scripts/build-libav.sh`. The loader\n  // emits an actionable error if the build hasn't been run yet. Threading\n  // is OFF by default in `loadLibav` (see the comment there for why).\n  const libav = (await loadLibav(\"avbridge\")) as unknown as LibavInstance;\n\n  const filename = source.name ?? `input.${sniffed === \"unknown\" ? \"bin\" : sniffed}`;\n  // For Blob/File sources we use libav's in-memory readahead file. For URL\n  // sources we attach an HTTP block reader so libav demuxes via Range\n  // requests instead of buffering the whole file.\n  const handle: LibavInputHandle = await prepareLibavInput(libav as unknown as Parameters<typeof prepareLibavInput>[0], filename, source);\n\n  let fmt_ctx: number | undefined;\n  let streams: LibavStream[] = [];\n  try {\n    const result = await libav.ff_init_demuxer_file(filename);\n    fmt_ctx = result[0];\n    streams = result[1];\n  } catch (err) {\n    await handle.detach().catch(() => {});\n    // Errors thrown across the libav.js worker/pthread boundary aren't\n    // always Error instances — they can be plain objects, numbers (errno\n    // codes), or strings. Stringify defensively so the user-facing message\n    // never has `(undefined)` in it.\n    const inner =\n      err instanceof Error\n        ? err.message\n        : typeof err === \"object\" && err !== null\n          ? JSON.stringify(err)\n          : String(err);\n    // eslint-disable-next-line no-console\n    console.error(\"[avbridge] ff_init_demuxer_file raw error:\", err);\n    throw new Error(\n      `libav.js could not demux ${filename}. The current libav variant likely lacks the required demuxer (e.g. AVI). See vendor/libav/README.md for build instructions. (${inner || \"no message — see console for raw error\"})`,\n    );\n  }\n\n  const videoTracks: VideoTrackInfo[] = [];\n  const audioTracks: AudioTrackInfo[] = [];\n\n  for (const stream of streams) {\n    const codecName = (await safe(() => libav.avcodec_get_name(stream.codec_id))) ?? `unknown(${stream.codec_id})`;\n    // codecpar holds width/height/channels/sample_rate/profile/level/extradata\n    // for the actual stream. We have to copy it out of WASM memory.\n    const codecpar = await safe(() => libav.ff_copyout_codecpar(stream.codecpar));\n\n    if (stream.codec_type === libav.AVMEDIA_TYPE_VIDEO) {\n      videoTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeVideo(codecName),\n        width: codecpar?.width ?? 0,\n        height: codecpar?.height ?? 0,\n        fps: framerate(stream),\n      });\n    } else if (stream.codec_type === libav.AVMEDIA_TYPE_AUDIO) {\n      audioTracks.push({\n        id: stream.index,\n        codec: ffmpegToAvbridgeAudio(codecName),\n        channels: codecpar?.channels ?? codecpar?.ch_layout_nb_channels ?? 0,\n        sampleRate: codecpar?.sample_rate ?? 0,\n      });\n    }\n  }\n\n  // We need this duration but cannot reliably get it from the streams alone\n  // for AVI; libav.js exposes it via the AVFormatContext duration helper.\n  const duration = await safeDuration(libav, fmt_ctx!);\n\n  // Close the demuxer; the strategy will reopen it later if it ends up being\n  // chosen. Probing should not pin native resources.\n  await libav.avformat_close_input_js(fmt_ctx!).catch(() => {});\n  await handle.detach().catch(() => {});\n\n  return {\n    source: source.original,\n    name: source.name,\n    byteLength: source.byteLength,\n    container: sniffed === \"unknown\" ? \"unknown\" : sniffed,\n    videoTracks,\n    audioTracks,\n    subtitleTracks: [],\n    probedBy: \"libav\",\n    duration,\n  };\n}\n\nfunction framerate(stream: LibavStream): number | undefined {\n  if (typeof stream.avg_frame_rate_num === \"number\" && stream.avg_frame_rate_den) {\n    return stream.avg_frame_rate_num / stream.avg_frame_rate_den;\n  }\n  if (stream.avg_frame_rate && typeof stream.avg_frame_rate === \"object\") {\n    if (stream.avg_frame_rate.den === 0) return undefined;\n    return stream.avg_frame_rate.num / stream.avg_frame_rate.den;\n  }\n  return undefined;\n}\n\nasync function safeDuration(libav: LibavInstance, fmt_ctx: number): Promise<number | undefined> {\n  try {\n    // `AVFormatContext.duration` is an int64 in microseconds (AV_TIME_BASE).\n    // libav.js exposes it as a split lo/hi pair the same way it does for\n    // packet pts — `AVFormatContext_duration(ctx)` returns the low 32 bits,\n    // `AVFormatContext_durationhi(ctx)` returns the high 32 bits. Reading\n    // only the low half (the previous bug) gave garbage for any file whose\n    // duration > ~35 minutes, and zero for shorter files where the value\n    // happened to live in the high half.\n    const lo = await libav.AVFormatContext_duration?.(fmt_ctx);\n    const hi = await libav.AVFormatContext_durationhi?.(fmt_ctx);\n    if (typeof lo !== \"number\" || typeof hi !== \"number\") return undefined;\n\n    // AV_NOPTS_VALUE = -2^63 → ptshi = -2147483648, pts = 0. Means \"unknown\".\n    if (hi === -2147483648 && lo === 0) return undefined;\n\n    // Reconstruct the 64-bit value. Prefer libav's helper when available\n    // because it correctly handles signed 32-bit two's complement.\n    const us =\n      typeof libav.i64tof64 === \"function\"\n        ? libav.i64tof64(lo, hi)\n        : hi * 0x100000000 + lo + (lo < 0 ? 0x100000000 : 0);\n\n    if (!Number.isFinite(us) || us <= 0) return undefined;\n    return us / 1_000_000;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function safe<T>(fn: () => Promise<T> | T): Promise<T | undefined> {\n  try { return await fn(); } catch { return undefined; }\n}\n\n/** Map FFmpeg codec names to avbridge video codec identifiers. */\nfunction ffmpegToAvbridgeVideo(name: string): VideoCodec {\n  switch (name) {\n    case \"h264\":   return \"h264\";\n    case \"hevc\":   return \"h265\";\n    case \"vp8\":    return \"vp8\";\n    case \"vp9\":    return \"vp9\";\n    case \"av1\":    return \"av1\";\n    case \"mpeg4\":  return \"mpeg4\";   // MPEG-4 Part 2 / DivX / Xvid\n    case \"msmpeg4v1\":\n    case \"msmpeg4v2\":\n    case \"msmpeg4v3\":                 // a.k.a. DIV3\n      return \"mpeg4\";\n    case \"wmv1\":\n    case \"wmv2\":\n    case \"wmv3\":\n      return \"wmv3\";\n    case \"vc1\":    return \"vc1\";\n    case \"mpeg2video\": return \"mpeg2\";\n    case \"mpeg1video\": return \"mpeg1\";\n    case \"theora\": return \"theora\";\n    case \"rv10\":   return \"rv10\";\n    case \"rv20\":   return \"rv20\";\n    case \"rv30\":   return \"rv30\";\n    case \"rv40\":   return \"rv40\";\n    default:       return name as VideoCodec;\n  }\n}\n\nfunction ffmpegToAvbridgeAudio(name: string): AudioCodec {\n  switch (name) {\n    case \"aac\":    return \"aac\";\n    case \"mp3\":\n    case \"mp3float\":\n      return \"mp3\";\n    case \"opus\":   return \"opus\";\n    case \"vorbis\": return \"vorbis\";\n    case \"flac\":   return \"flac\";\n    case \"ac3\":    return \"ac3\";\n    case \"eac3\":   return \"eac3\";\n    case \"wmav1\":\n    case \"wmav2\":  return \"wmav2\";\n    case \"wmapro\": return \"wmapro\";\n    case \"alac\":   return \"alac\";\n    case \"cook\":   return \"cook\";\n    case \"ra_144\": return \"ra_144\";\n    case \"ra_288\": return \"ra_288\";\n    case \"sipr\":   return \"sipr\";\n    case \"atrac3\": return \"atrac3\";\n    default:       return name as AudioCodec;\n  }\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Minimal structural types for the slice of libav.js we touch.\n// ─────────────────────────────────────────────────────────────────────────────\n\ninterface LibavStream {\n  index: number;\n  codec_type: number;\n  codec_id: number;\n  codecpar: number;\n  avg_frame_rate?: { num: number; den: number };\n  avg_frame_rate_num?: number;\n  avg_frame_rate_den?: number;\n}\n\ninterface LibavCodecpar {\n  width?: number;\n  height?: number;\n  channels?: number;\n  ch_layout_nb_channels?: number;\n  sample_rate?: number;\n  profile?: number;\n  level?: number;\n}\n\ninterface LibavInstance {\n  mkreadaheadfile(name: string, blob: Blob): Promise<void>;\n  unlinkreadaheadfile(name: string): Promise<void>;\n  ff_init_demuxer_file(name: string): Promise<[number, LibavStream[]]>;\n  ff_copyout_codecpar(codecpar: number): Promise<LibavCodecpar>;\n  avcodec_get_name(codec_id: number): Promise<string>;\n  avformat_close_input_js(ctx: number): Promise<void>;\n  AVFormatContext_duration?(ctx: number): Promise<number>;\n  AVFormatContext_durationhi?(ctx: number): Promise<number>;\n  i64tof64?(lo: number, hi: number): number;\n\n  AVMEDIA_TYPE_VIDEO: number;\n  AVMEDIA_TYPE_AUDIO: number;\n}\n"]}

package/dist/{chunk-EJH67FXG.js → chunk-5DMTJVIU.js}

@@ -1,3 +1,90 @@
+// src/util/debug.ts
+function isDebugEnabled() {
+  if (typeof globalThis === "undefined") return false;
+  const g = globalThis;
+  if (g.AVBRIDGE_DEBUG === true) return true;
+  if (typeof location !== "undefined" && typeof URLSearchParams !== "undefined") {
+    try {
+      const p = new URLSearchParams(location.search);
+      if (p.has("avbridge_debug")) {
+        g.AVBRIDGE_DEBUG = true;
+        return true;
+      }
+    } catch {
+    }
+  }
+  return false;
+}
+function fmt(tag) {
+  return `[avbridge:${tag}]`;
+}
+var dbg = {
+  /** Verbose — only when debug is enabled. The hot-path normal case. */
+  info(tag, ...args) {
+    if (isDebugEnabled()) console.info(fmt(tag), ...args);
+  },
+  /** Warning — only when debug is enabled. Non-fatal oddities. */
+  warn(tag, ...args) {
+    if (isDebugEnabled()) console.warn(fmt(tag), ...args);
+  },
+  /**
+   * Self-diagnosis warning. **Always** emits regardless of debug flag.
+   * Use this only for conditions that mean something is actually wrong
+   * or degraded — not for routine chatter.
+   */
+  diag(tag, ...args) {
+    console.warn(fmt(tag), ...args);
+  },
+  /**
+   * Timing helper: wraps an async call and logs its elapsed time when
+   * debug is on. The callback runs whether debug is on or off — this is
+   * just for the `dbg.info` at the end.
+   *
+   * Also unconditionally fires `dbg.diag` if the elapsed time exceeds
+   * `slowMs`, so "the bootstrap took 8 seconds" shows up even without
+   * debug mode enabled.
+   */
+  async timed(tag, label, slowMs, fn) {
+    const start = performance.now();
+    try {
+      const result = await fn();
+      const elapsed = performance.now() - start;
+      if (isDebugEnabled()) {
+        console.info(fmt(tag), `${label} ${elapsed.toFixed(0)}ms`);
+      }
+      if (elapsed > slowMs) {
+        console.warn(
+          fmt(tag),
+          `${label} took ${elapsed.toFixed(0)}ms (>${slowMs}ms expected) \u2014 this is unusually slow; possible causes: ${hintForTag(tag)}`
+        );
+      }
+      return result;
+    } catch (err) {
+      const elapsed = performance.now() - start;
+      console.warn(
+        fmt(tag),
+        `${label} FAILED after ${elapsed.toFixed(0)}ms:`,
+        err
+      );
+      throw err;
+    }
+  }
+};
+function hintForTag(tag) {
+  switch (tag) {
+    case "probe":
+      return "slow network (range request), large sniff window, or libav cold-start";
+    case "libav-load":
+      return "large .wasm download, misconfigured AVBRIDGE_LIBAV_BASE, or server-side MIME type";
+    case "bootstrap":
+      return "probe+classify+strategy-init chain; enable AVBRIDGE_DEBUG for a phase breakdown";
+    case "cold-start":
+      return "decoder is producing output slower than realtime \u2014 check framesDecoded in getDiagnostics()";
+    default:
+      return "unknown stage \u2014 enable globalThis.AVBRIDGE_DEBUG for more detail";
+  }
+}
+
 // src/strategies/fallback/libav-loader.ts
 var cache = /* @__PURE__ */ new Map();
 function cacheKey(variant, threads) {
@@ -15,9 +102,18 @@ function loadLibav(variant = "webcodecs", opts = {}) {
   return entry;
 }
 async function loadVariant(variant, wantThreads) {
+  return dbg.timed(
+    "libav-load",
+    `load "${variant}" (threads=${wantThreads})`,
+    5e3,
+    () => loadVariantInner(variant, wantThreads)
+  );
+}
+async function loadVariantInner(variant, wantThreads) {
   const key = cacheKey(variant, wantThreads);
   const base = `${libavBaseUrl()}/${variant}`;
   const variantUrl = `${base}/libav-${variant}.mjs`;
+  dbg.info("libav-load", `fetching ${variantUrl}`);
   if (typeof fetch === "function") {
     try {
       const head = await fetch(variantUrl, { method: "GET", headers: { Range: "bytes=0-0" } });
@@ -99,6 +195,6 @@ function chain(message, err) {
   return new Error(`${message}: ${inner || "(no message \u2014 see browser console)"}`);
 }
 
-export { loadLibav };
-//# sourceMappingURL=chunk-EJH67FXG.js.map
-//# sourceMappingURL=chunk-EJH67FXG.js.map
+export { dbg, loadLibav };
+//# sourceMappingURL=chunk-5DMTJVIU.js.map
+//# sourceMappingURL=chunk-5DMTJVIU.js.map

package/dist/chunk-5DMTJVIU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/util/debug.ts","../src/strategies/fallback/libav-loader.ts"],"names":[],"mappings":"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","file":"chunk-5DMTJVIU.js","sourcesContent":["/**\n * Debug + self-diagnosis helper.\n *\n * avbridge has a lot of async stages (probe → classify → libav load →\n * strategy.execute → decoder pump → cold-start gate → first paint) and\n * when something's slow or wrong the symptom — \"it hangs\", \"it stutters\",\n * \"it plays audio without video\" — is usually nowhere near the actual\n * cause. This module gives us two things:\n *\n * 1. **Gated verbose logging.** `dbg.info(tag, ...)` etc. are no-ops\n *    unless the consumer sets `globalThis.AVBRIDGE_DEBUG = true` (or\n *    uses the matching `?avbridge_debug` URL search param at dev time).\n *    When enabled, every log is prefixed with `[avbridge:<tag>]` so the\n *    console is filterable.\n *\n * 2. **Unconditional self-diagnosis.** `dbg.warnIf(cond, tag, ...)`\n *    always fires when a suspicious condition is detected, even with\n *    debug off. These are the things we *know* mean something is\n *    broken or degraded and the user would want to know about — e.g.\n *    the cold-start gate timing out, the decoder running slower than\n *    realtime, a libav variant taking longer to load than any network\n *    should take, >20% of packets getting rejected.\n *\n * The guiding principle: **if a symptom caused more than 10 minutes of\n * human debugging once, add a targeted warning so the next instance\n * self-identifies in the console.** This module is where those\n * warnings live.\n */\n\n/** Read the debug flag fresh on every call so it's runtime-toggleable. */\nfunction isDebugEnabled(): boolean {\n  if (typeof globalThis === \"undefined\") return false;\n  const g = globalThis as { AVBRIDGE_DEBUG?: unknown };\n  if (g.AVBRIDGE_DEBUG === true) return true;\n  // Convenience: if running in a browser with a `?avbridge_debug` search\n  // param, flip the flag on automatically. Useful for demos and quick\n  // user reproduction without editing code.\n  if (typeof location !== \"undefined\" && typeof URLSearchParams !== \"undefined\") {\n    try {\n      const p = new URLSearchParams(location.search);\n      if (p.has(\"avbridge_debug\")) {\n        g.AVBRIDGE_DEBUG = true;\n        return true;\n      }\n    } catch { /* ignore */ }\n  }\n  return false;\n}\n\nfunction fmt(tag: string): string {\n  return `[avbridge:${tag}]`;\n}\n\n/* eslint-disable no-console */\n\nexport const dbg = {\n  /** Verbose — only when debug is enabled. The hot-path normal case. */\n  info(tag: string, ...args: unknown[]): void {\n    if (isDebugEnabled()) console.info(fmt(tag), ...args);\n  },\n\n  /** Warning — only when debug is enabled. Non-fatal oddities. */\n  warn(tag: string, ...args: unknown[]): void {\n    if (isDebugEnabled()) console.warn(fmt(tag), ...args);\n  },\n\n  /**\n   * Self-diagnosis warning. **Always** emits regardless of debug flag.\n   * Use this only for conditions that mean something is actually wrong\n   * or degraded — not for routine chatter.\n   */\n  diag(tag: string, ...args: unknown[]): void {\n    console.warn(fmt(tag), ...args);\n  },\n\n  /**\n   * Timing helper: wraps an async call and logs its elapsed time when\n   * debug is on. The callback runs whether debug is on or off — this is\n   * just for the `dbg.info` at the end.\n   *\n   * Also unconditionally fires `dbg.diag` if the elapsed time exceeds\n   * `slowMs`, so \"the bootstrap took 8 seconds\" shows up even without\n   * debug mode enabled.\n   */\n  async timed<T>(\n    tag: string,\n    label: string,\n    slowMs: number,\n    fn: () => Promise<T>,\n  ): Promise<T> {\n    const start = performance.now();\n    try {\n      const result = await fn();\n      const elapsed = performance.now() - start;\n      if (isDebugEnabled()) {\n        console.info(fmt(tag), `${label} ${elapsed.toFixed(0)}ms`);\n      }\n      if (elapsed > slowMs) {\n        console.warn(\n          fmt(tag),\n          `${label} took ${elapsed.toFixed(0)}ms (>${slowMs}ms expected) — ` +\n          `this is unusually slow; possible causes: ${hintForTag(tag)}`,\n        );\n      }\n      return result;\n    } catch (err) {\n      const elapsed = performance.now() - start;\n      console.warn(\n        fmt(tag),\n        `${label} FAILED after ${elapsed.toFixed(0)}ms:`,\n        err,\n      );\n      throw err;\n    }\n  },\n};\n\nfunction hintForTag(tag: string): string {\n  switch (tag) {\n    case \"probe\":\n      return \"slow network (range request), large sniff window, or libav cold-start\";\n    case \"libav-load\":\n      return \"large .wasm download, misconfigured AVBRIDGE_LIBAV_BASE, or server-side MIME type\";\n    case \"bootstrap\":\n      return \"probe+classify+strategy-init chain; enable AVBRIDGE_DEBUG for a phase breakdown\";\n    case \"cold-start\":\n      return \"decoder is producing output slower than realtime — check framesDecoded in getDiagnostics()\";\n    default:\n      return \"unknown stage — enable globalThis.AVBRIDGE_DEBUG for more detail\";\n  }\n}\n","/**\n * Lazy libav.js loader supporting multiple variants.\n *\n * avbridge recognises three libav variants:\n *\n * - **webcodecs** — npm `@libav.js/variant-webcodecs`, ~5 MB. Modern formats\n *   only (mp4/mkv/webm/ogg/wav/...) — designed to bridge to WebCodecs.\n *\n * - **default** — npm `@libav.js/variant-default`, ~12 MB. Audio-only build\n *   (Opus, FLAC, WAV) despite the name. Useful for audio fallback.\n *\n * - **avbridge** — a custom build produced by `scripts/build-libav.sh` and\n *   landing in `vendor/libav/`. Includes the AVI/ASF/FLV/MKV demuxers plus\n *   the legacy decoders (WMV3, MPEG-4 Part 2, MS-MPEG4 v1/2/3, VC-1, MPEG-1/2,\n *   AC-3/E-AC-3, WMAv1/v2/Pro). This is the only variant that can read AVI;\n *   the npm variants are intentionally minimal and ship none of the legacy\n *   demuxers.\n *\n * Variant resolution always goes through a runtime URL + `/* @vite-ignore *\\/`\n * dynamic import. Static imports trigger Vite's optimized-deps pipeline,\n * which rewrites `import.meta.url` away from the real `dist/` directory and\n * breaks libav's sibling-binary loading.\n */\n\nimport { dbg } from \"../../util/debug.js\";\n\nexport type LibavVariant = \"webcodecs\" | \"default\" | \"avbridge\";\n\nexport interface LoadLibavOptions {\n  /**\n   * Force threading on/off for this load. If unspecified, defaults to\n   * \"true if `crossOriginIsolated`, otherwise false\". Some libav.js code\n   * paths (notably the cross-thread reader-device protocol used during\n   * `avformat_find_stream_info` for AVI) are unreliable in threaded mode,\n   * so probing forces this to `false` while decode keeps it default.\n   */\n  threads?: boolean;\n}\n\n// Cache key includes both variant and threading mode so probe and decode\n// can run different libav instances of the same variant.\nconst cache: Map<string, Promise<LibavInstance>> = new Map();\n\nfunction cacheKey(variant: LibavVariant, threads: boolean): string {\n  return `${variant}:${threads ? \"thr\" : \"wasm\"}`;\n}\n\n/**\n * Load (and cache) a libav.js variant. Pass `\"webcodecs\"` for the small\n * default; pass `\"default\"` for the audio fallback; pass `\"avbridge\"` for the\n * custom build that supports AVI/WMV/legacy codecs.\n */\nexport function loadLibav(\n  variant: LibavVariant = \"webcodecs\",\n  opts: LoadLibavOptions = {},\n): Promise<LibavInstance> {\n  // Threading is OFF by default. The threaded libav.js variant is too\n  // fragile in practice for our usage:\n  //   - Probe (`avformat_find_stream_info` for AVI) throws an `undefined`\n  //     exception out of `ff_init_demuxer_file`, apparently due to the\n  //     cross-thread reader-device protocol racing with the main thread.\n  //   - Decode hits a `TypeError: Cannot read properties of undefined\n  //     (reading 'apply')` inside libav.js's own worker message handler\n  //     within seconds of starting — a bug in libav.js's threaded message\n  //     dispatch that we can't fix from outside.\n  //\n  // Performance work for the fallback strategy needs to come from elsewhere\n  // (WASM SIMD, OffscreenCanvas, larger decode batches) instead of libav's\n  // pthreads. Threading can still be force-enabled with\n  // `globalThis.AVBRIDGE_LIBAV_THREADS = true` for testing if libav.js fixes\n  // those bugs in a future release.\n  const env = globalThis as { AVBRIDGE_LIBAV_THREADS?: boolean };\n  const wantThreads =\n    opts.threads !== undefined\n      ? opts.threads\n      : env.AVBRIDGE_LIBAV_THREADS === true;\n\n  const key = cacheKey(variant, wantThreads);\n  let entry = cache.get(key);\n  if (!entry) {\n    entry = loadVariant(variant, wantThreads);\n    cache.set(key, entry);\n  }\n  return entry;\n}\n\nasync function loadVariant(\n  variant: LibavVariant,\n  wantThreads: boolean,\n): Promise<LibavInstance> {\n  return dbg.timed(\"libav-load\", `load \"${variant}\" (threads=${wantThreads})`, 5000, () =>\n    loadVariantInner(variant, wantThreads),\n  );\n}\n\nasync function loadVariantInner(\n  variant: LibavVariant,\n  wantThreads: boolean,\n): Promise<LibavInstance> {\n  const key = cacheKey(variant, wantThreads);\n  const base = `${libavBaseUrl()}/${variant}`;\n  // The custom variant is named `libav-avbridge.mjs`; the npm variants follow\n  // the same convention (`libav-webcodecs.mjs`, `libav-default.mjs`).\n  const variantUrl = `${base}/libav-${variant}.mjs`;\n  dbg.info(\"libav-load\", `fetching ${variantUrl}`);\n\n  // Preflight HEAD-ish check: issue a bytes=0-0 range request so a missing\n  // file fails fast with a clear error instead of hanging deep inside the\n  // dynamic import or inside libav's own WASM instantiation. Surfaces the\n  // most common mistake (\"libav base path is wrong\") in <100 ms instead of\n  // an indeterminate stall.\n  if (typeof fetch === \"function\") {\n    try {\n      const head = await fetch(variantUrl, { method: \"GET\", headers: { Range: \"bytes=0-0\" } });\n      if (!head.ok && head.status !== 206) {\n        throw new Error(\n          `HTTP ${head.status} ${head.statusText} — check that libav files are served ` +\n          `at ${base}/ (override via globalThis.AVBRIDGE_LIBAV_BASE)`,\n        );\n      }\n      // Drain the tiny response so the connection can be reused.\n      try { await head.arrayBuffer(); } catch { /* ignore */ }\n    } catch (err) {\n      cache.delete(key);\n      throw chain(\n        `libav.js \"${variant}\" variant not reachable at ${variantUrl}`,\n        err,\n      );\n    }\n  }\n\n  let mod: LoadedVariant;\n  try {\n    // @ts-ignore runtime URL\n    const imported: unknown = await import(/* @vite-ignore */ variantUrl);\n    if (!imported || typeof (imported as { LibAV?: unknown }).LibAV !== \"function\") {\n      throw new Error(`module at ${variantUrl} did not export LibAV`);\n    }\n    mod = imported as LoadedVariant;\n  } catch (err) {\n    cache.delete(key);\n    const hint =\n      variant === \"avbridge\"\n        ? `The \"avbridge\" variant is a custom local build. Run \\`./scripts/build-libav.sh\\` ` +\n          `to produce it (requires Emscripten; ~15-30 min the first time).`\n        : `Make sure the variant files are present at ${base}/ (set ` +\n          `globalThis.AVBRIDGE_LIBAV_BASE to override the default lookup path).`;\n    throw new Error(\n      `failed to load libav.js \"${variant}\" variant from ${variantUrl}. ${hint} ` +\n        `Original error: ${(err as Error).message || String(err)}`,\n    );\n  }\n\n  try {\n    const inst = (await mod.LibAV(buildOpts(base, wantThreads))) as LibavInstance;\n    await silenceLibavLogs(inst);\n    return inst;\n  } catch (err) {\n    cache.delete(key);\n    throw chain(`LibAV() factory failed for \"${variant}\" variant (threads=${wantThreads})`, err);\n  }\n}\n\n/**\n * Lower libav's internal log level so the console doesn't get flooded with\n * `[mp3 @ ...] Header missing` and `Video uses a non-standard and wasteful\n * way to store B-frames` warnings on every legacy file. We still get any\n * actual JS-level errors via the normal Error path; this only affects\n * libav's own ffmpeg log channel.\n *\n * AV_LOG_QUIET = -8 (no output at all). If you want to keep fatal errors,\n * use AV_LOG_FATAL = 8 instead.\n */\nasync function silenceLibavLogs(inst: LibavInstance): Promise<void> {\n  try {\n    const setLevel = (inst as { av_log_set_level?: (n: number) => Promise<void> })\n      .av_log_set_level;\n    if (typeof setLevel === \"function\") {\n      const quiet = (inst as { AV_LOG_QUIET?: number }).AV_LOG_QUIET ?? -8;\n      await setLevel(quiet);\n    }\n  } catch {\n    /* not fatal — verbose logs are noise, not an error */\n  }\n}\n\nfunction buildOpts(base: string, wantThreads: boolean): Record<string, unknown> {\n  // The wantThreads decision is made by `loadLibav()` so callers (probe,\n  // decoder) can override per-load. Decode wants pthreads for speed; probe\n  // forces them off because libav.js's cross-thread reader-device protocol\n  // is unreliable mid-`avformat_find_stream_info` for some AVI files.\n  return {\n    base,\n    nothreads: !wantThreads,\n    yesthreads: wantThreads,\n  };\n}\n\nfunction libavBaseUrl(): string {\n  // Consumer override — the documented \"LGPL replaceability\" hook.\n  // Setting `globalThis.AVBRIDGE_LIBAV_BASE = \"/my/path\"` lets anyone swap\n  // in a different libav build (custom fragments, security patches, etc.)\n  // without rebuilding avbridge.\n  const override =\n    typeof globalThis !== \"undefined\"\n      ? (globalThis as { AVBRIDGE_LIBAV_BASE?: string }).AVBRIDGE_LIBAV_BASE\n      : undefined;\n  if (override) return override;\n\n  // Default: resolve relative to this module's URL. When avbridge is installed\n  // under `node_modules/avbridge/`, this module lives at `dist/chunk-*.js` (or\n  // `dist/element-browser.js` for the browser entry) and `../vendor/libav`\n  // resolves to `node_modules/avbridge/vendor/libav`, where the build step\n  // vendored every variant's binaries. That's the zero-config path.\n  //\n  // `import.meta.url` throws in some synthetic environments (CJS tests, some\n  // SSR evaluators). If it fails, fall back to the legacy `/libav` path so\n  // consumers who relied on the pre-2.1 behavior still work.\n  try {\n    return new URL(\"../vendor/libav\", import.meta.url).href;\n  } catch {\n    if (typeof location !== \"undefined\" && location.protocol.startsWith(\"http\")) {\n      return `${location.origin}/libav`;\n    }\n    return \"/libav\";\n  }\n}\n\nfunction chain(message: string, err: unknown): Error {\n  const inner = err instanceof Error ? err.message : String(err);\n  // eslint-disable-next-line no-console\n  console.error(`[avbridge] ${message}:`, err);\n  return new Error(`${message}: ${inner || \"(no message — see browser console)\"}`);\n}\n\ninterface LoadedVariant {\n  LibAV: (opts?: Record<string, unknown>) => Promise<Record<string, unknown>>;\n}\n\n/** Loose structural type — the AVI probe and the fallback decoder add fields. */\nexport type LibavInstance = Record<string, unknown> & {\n  mkreadaheadfile(name: string, blob: Blob): Promise<void>;\n  unlinkreadaheadfile(name: string): Promise<void>;\n};\n"]}

package/dist/{chunk-3AUGRKPY.js → chunk-C5VA5U5O.js}

@@ -1,5 +1,5 @@
-import { normalizeSource, sniffNormalizedSource } from './chunk-PQTZS7OA.js';
-import { loadLibav } from './chunk-EJH67FXG.js';
+import { normalizeSource, sniffNormalizedSource } from './chunk-ILKDNBSE.js';
+import { dbg, loadLibav } from './chunk-5DMTJVIU.js';
 import { pickLibavVariant } from './chunk-J5MCMN3S.js';
 
 // src/probe/mediabunny.ts
@@ -190,7 +190,7 @@ async function probe(source) {
         mediabunnyErr.message
       );
       try {
-        const { probeWithLibav } = await import('./avi-V6HYQVR2.js');
+        const { probeWithLibav } = await import('./avi-GCGM7OJI.js');
         return await probeWithLibav(normalized, sniffed);
       } catch (libavErr) {
         const mbMsg = mediabunnyErr.message || String(mediabunnyErr);
@@ -202,7 +202,7 @@ async function probe(source) {
     }
   }
   try {
-    const { probeWithLibav } = await import('./avi-V6HYQVR2.js');
+    const { probeWithLibav } = await import('./avi-GCGM7OJI.js');
     return await probeWithLibav(normalized, sniffed);
   } catch (err) {
     const inner = err instanceof Error ? err.message : String(err);
@@ -288,8 +288,29 @@ var NATIVE_AUDIO_CODECS = /* @__PURE__ */ new Set([
   "vorbis",
   "flac"
 ]);
-var FALLBACK_VIDEO_CODECS = /* @__PURE__ */ new Set(["wmv3", "vc1", "mpeg4", "rv40", "mpeg2", "mpeg1", "theora"]);
-var FALLBACK_AUDIO_CODECS = /* @__PURE__ */ new Set(["wmav2", "wmapro", "ac3", "eac3"]);
+var FALLBACK_VIDEO_CODECS = /* @__PURE__ */ new Set([
+  "wmv3",
+  "vc1",
+  "mpeg4",
+  "rv10",
+  "rv20",
+  "rv30",
+  "rv40",
+  "mpeg2",
+  "mpeg1",
+  "theora"
+]);
+var FALLBACK_AUDIO_CODECS = /* @__PURE__ */ new Set([
+  "wmav2",
+  "wmapro",
+  "ac3",
+  "eac3",
+  "cook",
+  "ra_144",
+  "ra_288",
+  "sipr",
+  "atrac3"
+]);
 var NATIVE_CONTAINERS = /* @__PURE__ */ new Set([
   "mp4",
   "mov",
@@ -1923,7 +1944,7 @@ async function loadBridge() {
 var READY_AUDIO_BUFFER_SECONDS = 0.3;
 var READY_TIMEOUT_SECONDS = 10;
 async function createHybridSession(ctx, target) {
-  const { normalizeSource: normalizeSource2 } = await import('./source-ZFS4H7J3.js');
+  const { normalizeSource: normalizeSource2 } = await import('./source-FFZ7TW2B.js');
   const source = await normalizeSource2(ctx.source);
   const fps = ctx.videoTracks[0]?.fps ?? 30;
   const audio = new AudioOutput();
@@ -2090,6 +2111,9 @@ async function startDecoder(opts) {
   let packetsRead = 0;
   let videoFramesDecoded = 0;
   let audioFramesDecoded = 0;
+  let watchdogFirstFrameMs = 0;
+  let watchdogSlowSinceMs = 0;
+  let watchdogWarned = false;
   let syntheticVideoUs = 0;
   let syntheticAudioUs = 0;
   const videoTrackInfo = opts.context.videoTracks.find((t) => t.id === videoStream?.index);
@@ -2101,7 +2125,7 @@ async function startDecoder(opts) {
       let packets;
       try {
         [readErr, packets] = await libav.ff_read_frame_multi(fmt_ctx, readPkt, {
-          limit: 16 * 1024
+          limit: 64 * 1024
         });
       } catch (err) {
         console.error("[avbridge] ff_read_frame_multi failed:", err);
@@ -2118,6 +2142,28 @@ async function startDecoder(opts) {
         await decodeAudioBatch(audioPackets, myToken);
       }
       packetsRead += (videoPackets?.length ?? 0) + (audioPackets?.length ?? 0);
+      if (videoFramesDecoded > 0) {
+        if (watchdogFirstFrameMs === 0) {
+          watchdogFirstFrameMs = performance.now();
+        }
+        const elapsedSinceFirst = (performance.now() - watchdogFirstFrameMs) / 1e3;
+        if (elapsedSinceFirst > 1 && !watchdogWarned) {
+          const expectedFrames = elapsedSinceFirst * videoFps;
+          const ratio = videoFramesDecoded / expectedFrames;
+          if (ratio < 0.6) {
+            if (watchdogSlowSinceMs === 0) watchdogSlowSinceMs = performance.now();
+            if ((performance.now() - watchdogSlowSinceMs) / 1e3 > 5) {
+              watchdogWarned = true;
+              console.warn(
+                "[avbridge:decode-rate]",
+                `decoder is running slower than realtime: ${videoFramesDecoded} frames in ${elapsedSinceFirst.toFixed(1)}s (${(videoFramesDecoded / elapsedSinceFirst).toFixed(1)} fps vs ${videoFps} fps source \u2014 ${(ratio * 100).toFixed(0)}% of realtime). Playback will stutter. Typical causes: software decode of a codec with no WebCodecs support (rv40, mpeg4 @ 720p+, wmv3), or a resolution too large for single-threaded WASM to keep up with.`
+              );
+            }
+          } else {
+            watchdogSlowSinceMs = 0;
+          }
+        }
+      }
       while (!destroyed && myToken === pumpToken && (opts.audio.bufferAhead() > 2 || opts.renderer.queueDepth() >= opts.renderer.queueHighWater)) {
         await new Promise((r) => setTimeout(r, 50));
       }
@@ -2444,10 +2490,10 @@ async function loadBridge2() {
 }
 
 // src/strategies/fallback/index.ts
-var READY_AUDIO_BUFFER_SECONDS2 = 0.3;
-var READY_TIMEOUT_SECONDS2 = 10;
+var READY_AUDIO_BUFFER_SECONDS2 = 0.04;
+var READY_TIMEOUT_SECONDS2 = 3;
 async function createFallbackSession(ctx, target) {
-  const { normalizeSource: normalizeSource2 } = await import('./source-ZFS4H7J3.js');
+  const { normalizeSource: normalizeSource2 } = await import('./source-FFZ7TW2B.js');
   const source = await normalizeSource2(ctx.source);
   const fps = ctx.videoTracks[0]?.fps ?? 30;
   const audio = new AudioOutput();
@@ -2481,12 +2527,26 @@ async function createFallbackSession(ctx, target) {
   }
   async function waitForBuffer() {
     const start = performance.now();
+    dbg.info(
+      "cold-start",
+      `gate entry: need audio >= ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms + 1 frame`
+    );
     while (true) {
-      const audioReady = audio.isNoAudio() || audio.bufferAhead() >= READY_AUDIO_BUFFER_SECONDS2;
-      if (audioReady && renderer.hasFrames()) {
+      const audioAhead = audio.isNoAudio() ? Infinity : audio.bufferAhead();
+      const audioReady = audio.isNoAudio() || audioAhead >= READY_AUDIO_BUFFER_SECONDS2;
+      const hasFrames = renderer.hasFrames();
+      if (audioReady && hasFrames) {
+        dbg.info(
+          "cold-start",
+          `gate satisfied in ${(performance.now() - start).toFixed(0)}ms (audio=${(audioAhead * 1e3).toFixed(0)}ms, frames=${renderer.queueDepth()})`
+        );
         return;
       }
       if ((performance.now() - start) / 1e3 > READY_TIMEOUT_SECONDS2) {
+        dbg.diag(
+          "cold-start",
+          `gate TIMEOUT after ${READY_TIMEOUT_SECONDS2}s \u2014 audio=${(audioAhead * 1e3).toFixed(0)}ms (needed ${READY_AUDIO_BUFFER_SECONDS2 * 1e3}ms), frames=${renderer.queueDepth()} (needed \u22651). Software decoder is producing output slower than realtime \u2014 playback will stutter. Check getDiagnostics().runtime for the decode rate.`
+        );
         return;
       }
       await new Promise((r) => setTimeout(r, 50));
@@ -2701,8 +2761,14 @@ var UnifiedPlayer = class _UnifiedPlayer {
     return player;
   }
   async bootstrap() {
+    const bootstrapStart = performance.now();
     try {
-      const ctx = await probe(this.options.source);
+      dbg.info("bootstrap", "start");
+      const ctx = await dbg.timed("probe", "probe", 3e3, () => probe(this.options.source));
+      dbg.info(
+        "probe",
+        `container=${ctx.container} video=${ctx.videoTracks[0]?.codec ?? "-"} audio=${ctx.audioTracks[0]?.codec ?? "-"} probedBy=${ctx.probedBy}`
+      );
       this.diag.recordProbe(ctx);
       this.mediaContext = ctx;
       if (this.options.subtitles) {
@@ -2728,6 +2794,10 @@ var UnifiedPlayer = class _UnifiedPlayer {
         }
       }
       const decision = this.options.initialStrategy ? buildInitialDecision(this.options.initialStrategy, ctx) : classifyContext(ctx);
+      dbg.info(
+        "classify",
+        `strategy=${decision.strategy} class=${decision.class} reason="${decision.reason}"` + (decision.fallbackChain ? ` fallback=${decision.fallbackChain.join("\u2192")}` : "")
+      );
       this.classification = decision;
       this.diag.recordClassification(decision);
       this.emitter.emitSticky("strategy", {
@@ -2753,6 +2823,14 @@ var UnifiedPlayer = class _UnifiedPlayer {
       this.startTimeupdateLoop();
       this.options.target.addEventListener("ended", () => this.emitter.emit("ended", void 0));
       this.emitter.emitSticky("ready", void 0);
+      const bootstrapElapsed = performance.now() - bootstrapStart;
+      dbg.info("bootstrap", `ready in ${bootstrapElapsed.toFixed(0)}ms`);
+      if (bootstrapElapsed > 5e3) {
+        console.warn(
+          "[avbridge:bootstrap]",
+          `total bootstrap time ${bootstrapElapsed.toFixed(0)}ms \u2014 unusually slow. Enable globalThis.AVBRIDGE_DEBUG for a per-phase breakdown.`
+        );
+      }
     } catch (err) {
       const e = err instanceof Error ? err : new Error(String(err));
       this.diag.recordError(e);
@@ -3077,5 +3155,5 @@ function defaultFallbackChain(strategy) {
 }
 
 export { UnifiedPlayer, avbridgeAudioToMediabunny, avbridgeVideoToMediabunny, buildMediabunnySourceFromInput, classifyContext, createPlayer, probe, srtToVtt };
-//# sourceMappingURL=chunk-3AUGRKPY.js.map
-//# sourceMappingURL=chunk-3AUGRKPY.js.map
+//# sourceMappingURL=chunk-C5VA5U5O.js.map
+//# sourceMappingURL=chunk-C5VA5U5O.js.map