avbridge 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkO34444ID_cjs = require('./chunk-O34444ID.cjs');
-var chunkY5FYF5KG_cjs = require('./chunk-Y5FYF5KG.cjs');
+var chunkOE66B34H_cjs = require('./chunk-OE66B34H.cjs');
+var chunkHZLQNKFN_cjs = require('./chunk-HZLQNKFN.cjs');
 var chunkL4NPOJ36_cjs = require('./chunk-L4NPOJ36.cjs');
-require('./chunk-JQH6D4OE.cjs');
+require('./chunk-G4APZMCP.cjs');
 require('./chunk-NZU7W256.cjs');
 
 // src/convert/remux.ts
@@ -21,7 +21,7 @@ var MEDIABUNNY_CONTAINERS = /* @__PURE__ */ new Set([
 async function remux(source, options = {}) {
   const outputFormat = options.outputFormat ?? "mp4";
   options.signal?.throwIfAborted();
-  const ctx = await chunkO34444ID_cjs.probe(source);
+  const ctx = await chunkOE66B34H_cjs.probe(source);
   options.signal?.throwIfAborted();
   validateRemuxEligibility(ctx, options.strict ?? false);
   if (MEDIABUNNY_CONTAINERS.has(ctx.container)) {
@@ -33,7 +33,7 @@ function validateRemuxEligibility(ctx, strict) {
   const video = ctx.videoTracks[0];
   const audio = ctx.audioTracks[0];
   if (video) {
-    const mbCodec = chunkO34444ID_cjs.avbridgeVideoToMediabunny(video.codec);
+    const mbCodec = chunkOE66B34H_cjs.avbridgeVideoToMediabunny(video.codec);
     if (!mbCodec) {
       throw new Error(
         `Cannot remux: video codec "${video.codec}" is not supported for remuxing. Use transcode() to re-encode to a modern codec.`
@@ -41,7 +41,7 @@ function validateRemuxEligibility(ctx, strict) {
     }
   }
   if (audio) {
-    const mbCodec = chunkO34444ID_cjs.avbridgeAudioToMediabunny(audio.codec);
+    const mbCodec = chunkOE66B34H_cjs.avbridgeAudioToMediabunny(audio.codec);
     if (!mbCodec) {
       throw new Error(
         `Cannot remux: audio codec "${audio.codec}" is not supported for remuxing. Use transcode() to re-encode to a modern codec.`
@@ -60,7 +60,7 @@ function validateRemuxEligibility(ctx, strict) {
 async function remuxViaMediAbunny(ctx, outputFormat, options) {
   const mb = await import('mediabunny');
   const input = new mb.Input({
-    source: await chunkO34444ID_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
+    source: await chunkOE66B34H_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
     formats: mb.ALL_FORMATS
   });
   const target = new mb.BufferTarget();
@@ -117,7 +117,7 @@ async function remuxViaLibav(ctx, outputFormat, options) {
   let loadLibav;
   let pickLibavVariant;
   try {
-    const loader = await import('./libav-loader-6APXVNIV.cjs');
+    const loader = await import('./libav-loader-IV4AJ2HW.cjs');
     const routing = await import('./variant-routing-GOHB2RZN.cjs');
     loadLibav = loader.loadLibav;
     pickLibavVariant = routing.pickLibavVariant;
@@ -128,7 +128,7 @@ async function remuxViaLibav(ctx, outputFormat, options) {
   }
   const variant = pickLibavVariant(ctx);
   const libav = await loadLibav(variant);
-  const normalized = await chunkY5FYF5KG_cjs.normalizeSource(ctx.source);
+  const normalized = await chunkHZLQNKFN_cjs.normalizeSource(ctx.source);
   const filename = ctx.name ?? `remux-input-${Date.now()}`;
   const handle = await chunkL4NPOJ36_cjs.prepareLibavInput(libav, filename, normalized);
   try {
@@ -146,8 +146,8 @@ async function doLibavRemux(libav, filename, ctx, outputFormat, options) {
   const audioStream = streams.find((s) => s.codec_type === libav.AVMEDIA_TYPE_AUDIO) ?? null;
   const videoTrackInfo = ctx.videoTracks[0];
   const audioTrackInfo = ctx.audioTracks[0];
-  const mbVideoCodec = videoTrackInfo ? chunkO34444ID_cjs.avbridgeVideoToMediabunny(videoTrackInfo.codec) : null;
-  const mbAudioCodec = audioTrackInfo ? chunkO34444ID_cjs.avbridgeAudioToMediabunny(audioTrackInfo.codec) : null;
+  const mbVideoCodec = videoTrackInfo ? chunkOE66B34H_cjs.avbridgeVideoToMediabunny(videoTrackInfo.codec) : null;
+  const mbAudioCodec = audioTrackInfo ? chunkOE66B34H_cjs.avbridgeAudioToMediabunny(audioTrackInfo.codec) : null;
   const target = new mb.BufferTarget();
   const output = new mb.Output({
     format: createOutputFormat(mb, outputFormat),
@@ -358,7 +358,7 @@ async function transcode(source, options = {}) {
   const quality = options.quality ?? "medium";
   validateCodecCompatibility(outputFormat, videoCodec, audioCodec);
   options.signal?.throwIfAborted();
-  const ctx = await chunkO34444ID_cjs.probe(source);
+  const ctx = await chunkOE66B34H_cjs.probe(source);
   options.signal?.throwIfAborted();
   if (!MEDIABUNNY_CONTAINERS2.has(ctx.container)) {
     throw new Error(
@@ -370,7 +370,7 @@ async function transcode(source, options = {}) {
 async function attemptTranscode(ctx, outputFormat, videoCodec, audioCodec, quality, options) {
   const mb = await import('mediabunny');
   const input = new mb.Input({
-    source: await chunkO34444ID_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
+    source: await chunkOE66B34H_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
     formats: mb.ALL_FORMATS
   });
   const target = new mb.BufferTarget();
@@ -552,23 +552,23 @@ function qualityToMediabunny(mb, quality) {
 
 Object.defineProperty(exports, "UnifiedPlayer", {
   enumerable: true,
-  get: function () { return chunkO34444ID_cjs.UnifiedPlayer; }
+  get: function () { return chunkOE66B34H_cjs.UnifiedPlayer; }
 });
 Object.defineProperty(exports, "classify", {
   enumerable: true,
-  get: function () { return chunkO34444ID_cjs.classifyContext; }
+  get: function () { return chunkOE66B34H_cjs.classifyContext; }
 });
 Object.defineProperty(exports, "createPlayer", {
   enumerable: true,
-  get: function () { return chunkO34444ID_cjs.createPlayer; }
+  get: function () { return chunkOE66B34H_cjs.createPlayer; }
 });
 Object.defineProperty(exports, "probe", {
   enumerable: true,
-  get: function () { return chunkO34444ID_cjs.probe; }
+  get: function () { return chunkOE66B34H_cjs.probe; }
 });
 Object.defineProperty(exports, "srtToVtt", {
   enumerable: true,
-  get: function () { return chunkO34444ID_cjs.srtToVtt; }
+  get: function () { return chunkOE66B34H_cjs.srtToVtt; }
 });
 exports.remux = remux;
 exports.transcode = transcode;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MediaContext, C as Classification, a as MediaInput, b as ConvertOptions, c as ConvertResult, T as TranscodeOptions } from './player-BdtUG4rh.cjs';
-export { A as AudioCodec, d as AudioTrackInfo, e as ContainerKind, f as CreatePlayerOptions, D as DiagnosticsSnapshot, H as HardwareAccelerationHint, O as OutputAudioCodec, g as OutputFormat, h as OutputVideoCodec, P as PlaybackSession, i as PlayerEventMap, j as PlayerEventName, k as Plugin, l as ProgressInfo, S as StrategyClass, m as StrategyName, n as SubtitleTrackInfo, o as TranscodeQuality, U as UnifiedPlayer, V as VideoCodec, p as VideoTrackInfo, q as createPlayer } from './player-BdtUG4rh.cjs';
+import { M as MediaContext, C as Classification, a as MediaInput, b as ConvertOptions, c as ConvertResult, T as TranscodeOptions } from './player-DUyvltvy.cjs';
+export { A as AudioCodec, d as AudioTrackInfo, e as ContainerKind, f as CreatePlayerOptions, D as DiagnosticsSnapshot, H as HardwareAccelerationHint, O as OutputAudioCodec, g as OutputFormat, h as OutputVideoCodec, P as PlaybackSession, i as PlayerEventMap, j as PlayerEventName, k as Plugin, l as ProgressInfo, S as StrategyClass, m as StrategyName, n as SubtitleTrackInfo, o as TranscodeQuality, U as UnifiedPlayer, V as VideoCodec, p as VideoTrackInfo, q as createPlayer } from './player-DUyvltvy.cjs';
 
 /**
  * Pure classification — no I/O, no async. Test-friendly.
@@ -11,12 +11,16 @@ declare function classifyContext(ctx: MediaContext): Classification;
  *
  * Routing:
  * 1. Sniff the magic header. Cheap, deterministic, ignores file extensions.
- * 2. If the container is one mediabunny supports → mediabunny. If mediabunny
- *    rejects, surface the real error rather than blindly falling through to
- *    libav (which would mask the real failure with a confusing libav error).
- * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js, lazy-loaded.
- *    `unknown` is included so genuinely unfamiliar files at least get a shot
- *    at the broader libav demuxer set.
+ * 2. If the container is one mediabunny supports → try mediabunny first
+ *    (fast path — it's a single pass of WASM-free JS parsing). If mediabunny
+ *    throws (e.g. an assertion on an unsupported sample entry like `mp4v`
+ *    for MPEG-4 Part 2 in ISOBMFF, or an exotic MKV codec), fall through to
+ *    libav.js which handles the long tail of codecs mediabunny doesn't.
+ *    The combined-error case surfaces *both* failures so the user sees
+ *    which path each step took.
+ * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js directly.
+ *    mediabunny can't read those containers at all, so there's no fast path
+ *    to try.
  */
 declare function probe(source: MediaInput): Promise<MediaContext>;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MediaContext, C as Classification, a as MediaInput, b as ConvertOptions, c as ConvertResult, T as TranscodeOptions } from './player-BdtUG4rh.js';
-export { A as AudioCodec, d as AudioTrackInfo, e as ContainerKind, f as CreatePlayerOptions, D as DiagnosticsSnapshot, H as HardwareAccelerationHint, O as OutputAudioCodec, g as OutputFormat, h as OutputVideoCodec, P as PlaybackSession, i as PlayerEventMap, j as PlayerEventName, k as Plugin, l as ProgressInfo, S as StrategyClass, m as StrategyName, n as SubtitleTrackInfo, o as TranscodeQuality, U as UnifiedPlayer, V as VideoCodec, p as VideoTrackInfo, q as createPlayer } from './player-BdtUG4rh.js';
+import { M as MediaContext, C as Classification, a as MediaInput, b as ConvertOptions, c as ConvertResult, T as TranscodeOptions } from './player-DUyvltvy.js';
+export { A as AudioCodec, d as AudioTrackInfo, e as ContainerKind, f as CreatePlayerOptions, D as DiagnosticsSnapshot, H as HardwareAccelerationHint, O as OutputAudioCodec, g as OutputFormat, h as OutputVideoCodec, P as PlaybackSession, i as PlayerEventMap, j as PlayerEventName, k as Plugin, l as ProgressInfo, S as StrategyClass, m as StrategyName, n as SubtitleTrackInfo, o as TranscodeQuality, U as UnifiedPlayer, V as VideoCodec, p as VideoTrackInfo, q as createPlayer } from './player-DUyvltvy.js';
 
 /**
  * Pure classification — no I/O, no async. Test-friendly.
@@ -11,12 +11,16 @@ declare function classifyContext(ctx: MediaContext): Classification;
  *
  * Routing:
  * 1. Sniff the magic header. Cheap, deterministic, ignores file extensions.
- * 2. If the container is one mediabunny supports → mediabunny. If mediabunny
- *    rejects, surface the real error rather than blindly falling through to
- *    libav (which would mask the real failure with a confusing libav error).
- * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js, lazy-loaded.
- *    `unknown` is included so genuinely unfamiliar files at least get a shot
- *    at the broader libav demuxer set.
+ * 2. If the container is one mediabunny supports → try mediabunny first
+ *    (fast path — it's a single pass of WASM-free JS parsing). If mediabunny
+ *    throws (e.g. an assertion on an unsupported sample entry like `mp4v`
+ *    for MPEG-4 Part 2 in ISOBMFF, or an exotic MKV codec), fall through to
+ *    libav.js which handles the long tail of codecs mediabunny doesn't.
+ *    The combined-error case surfaces *both* failures so the user sees
+ *    which path each step took.
+ * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js directly.
+ *    mediabunny can't read those containers at all, so there's no fast path
+ *    to try.
  */
 declare function probe(source: MediaInput): Promise<MediaContext>;
 

package/dist/index.js

@@ -1,8 +1,8 @@
-import { probe, avbridgeVideoToMediabunny, avbridgeAudioToMediabunny, buildMediabunnySourceFromInput } from './chunk-CUQD23WO.js';
-export { UnifiedPlayer, classifyContext as classify, createPlayer, probe, srtToVtt } from './chunk-CUQD23WO.js';
-import { normalizeSource } from './chunk-PQTZS7OA.js';
+import { probe, avbridgeVideoToMediabunny, avbridgeAudioToMediabunny, buildMediabunnySourceFromInput } from './chunk-C5VA5U5O.js';
+export { UnifiedPlayer, classifyContext as classify, createPlayer, probe, srtToVtt } from './chunk-C5VA5U5O.js';
+import { normalizeSource } from './chunk-ILKDNBSE.js';
 import { prepareLibavInput } from './chunk-WD2ZNQA7.js';
-import './chunk-EJH67FXG.js';
+import './chunk-5DMTJVIU.js';
 import './chunk-J5MCMN3S.js';
 
 // src/convert/remux.ts
@@ -116,7 +116,7 @@ async function remuxViaLibav(ctx, outputFormat, options) {
   let loadLibav;
   let pickLibavVariant;
   try {
-    const loader = await import('./libav-loader-XKH2TKUW.js');
+    const loader = await import('./libav-loader-27RDIN2I.js');
     const routing = await import('./variant-routing-JOBWXYKD.js');
     loadLibav = loader.loadLibav;
     pickLibavVariant = routing.pickLibavVariant;

package/dist/libav-loader-27RDIN2I.js

@@ -0,0 +1,3 @@
+export { loadLibav } from './chunk-5DMTJVIU.js';
+//# sourceMappingURL=libav-loader-27RDIN2I.js.map
+//# sourceMappingURL=libav-loader-27RDIN2I.js.map

package/dist/{libav-loader-XKH2TKUW.js.map → libav-loader-27RDIN2I.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"libav-loader-XKH2TKUW.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"libav-loader-27RDIN2I.js"}

package/dist/libav-loader-IV4AJ2HW.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkG4APZMCP_cjs = require('./chunk-G4APZMCP.cjs');
+
+
+
+Object.defineProperty(exports, "loadLibav", {
+  enumerable: true,
+  get: function () { return chunkG4APZMCP_cjs.loadLibav; }
+});
+//# sourceMappingURL=libav-loader-IV4AJ2HW.cjs.map
+//# sourceMappingURL=libav-loader-IV4AJ2HW.cjs.map

package/dist/{libav-loader-6APXVNIV.cjs.map → libav-loader-IV4AJ2HW.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"libav-loader-6APXVNIV.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"libav-loader-IV4AJ2HW.cjs"}

package/dist/{player-BdtUG4rh.d.cts → player-DUyvltvy.d.cts}

@@ -13,11 +13,11 @@
  */
 type MediaInput = File | Blob | string | URL | ArrayBuffer | Uint8Array;
 /** Container format families we know about. */
-type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
+type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "rm" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
 /** Video codec families. Strings, not enums, so plugins can extend. */
-type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
+type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
 /** Audio codec families. */
-type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | (string & {});
+type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | (string & {});
 interface VideoTrackInfo {
     id: number;
     codec: VideoCodec;

package/dist/{player-BdtUG4rh.d.ts → player-DUyvltvy.d.ts}

@@ -13,11 +13,11 @@
  */
 type MediaInput = File | Blob | string | URL | ArrayBuffer | Uint8Array;
 /** Container format families we know about. */
-type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
+type ContainerKind = "mp4" | "mov" | "mkv" | "webm" | "avi" | "asf" | "flv" | "rm" | "ogg" | "wav" | "mp3" | "flac" | "adts" | "mpegts" | "unknown";
 /** Video codec families. Strings, not enums, so plugins can extend. */
-type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
+type VideoCodec = "h264" | "h265" | "vp8" | "vp9" | "av1" | "mpeg4" | "wmv3" | "vc1" | "rv10" | "rv20" | "rv30" | "rv40" | "mpeg2" | "mpeg1" | "theora" | (string & {});
 /** Audio codec families. */
-type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | (string & {});
+type AudioCodec = "aac" | "mp3" | "opus" | "vorbis" | "flac" | "pcm" | "ac3" | "eac3" | "wmav2" | "wmapro" | "alac" | "cook" | "ra_144" | "ra_288" | "sipr" | "atrac3" | (string & {});
 interface VideoTrackInfo {
     id: number;
     codec: VideoCodec;

package/dist/source-CN43EI7Z.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunkHZLQNKFN_cjs = require('./chunk-HZLQNKFN.cjs');
+
+
+
+Object.defineProperty(exports, "isInMemorySource", {
+  enumerable: true,
+  get: function () { return chunkHZLQNKFN_cjs.isInMemorySource; }
+});
+Object.defineProperty(exports, "normalizeSource", {
+  enumerable: true,
+  get: function () { return chunkHZLQNKFN_cjs.normalizeSource; }
+});
+Object.defineProperty(exports, "sniffContainer", {
+  enumerable: true,
+  get: function () { return chunkHZLQNKFN_cjs.sniffContainer; }
+});
+Object.defineProperty(exports, "sniffContainerFromBytes", {
+  enumerable: true,
+  get: function () { return chunkHZLQNKFN_cjs.sniffContainerFromBytes; }
+});
+Object.defineProperty(exports, "sniffNormalizedSource", {
+  enumerable: true,
+  get: function () { return chunkHZLQNKFN_cjs.sniffNormalizedSource; }
+});
+//# sourceMappingURL=source-CN43EI7Z.cjs.map
+//# sourceMappingURL=source-CN43EI7Z.cjs.map

package/dist/{source-SC6ZEQYR.cjs.map → source-CN43EI7Z.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"source-SC6ZEQYR.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"source-CN43EI7Z.cjs"}

package/dist/source-FFZ7TW2B.js

@@ -0,0 +1,3 @@
+export { isInMemorySource, normalizeSource, sniffContainer, sniffContainerFromBytes, sniffNormalizedSource } from './chunk-ILKDNBSE.js';
+//# sourceMappingURL=source-FFZ7TW2B.js.map
+//# sourceMappingURL=source-FFZ7TW2B.js.map

package/dist/{source-ZFS4H7J3.js.map → source-FFZ7TW2B.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"source-ZFS4H7J3.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"source-FFZ7TW2B.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbridge",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Play and convert arbitrary video files in the browser. Native, remux, hybrid, fallback, and transcode — one API.",
   "license": "MIT",
   "author": "Keishi Hattori",

package/src/classify/rules.ts

@@ -25,8 +25,15 @@ const NATIVE_AUDIO_CODECS = new Set<AudioCodec>([
 /**
  * Codecs no major browser plays, period. These force the WASM fallback.
  */
-const FALLBACK_VIDEO_CODECS = new Set<VideoCodec>(["wmv3", "vc1", "mpeg4", "rv40", "mpeg2", "mpeg1", "theora"]);
-const FALLBACK_AUDIO_CODECS = new Set<AudioCodec>(["wmav2", "wmapro", "ac3", "eac3"]);
+const FALLBACK_VIDEO_CODECS = new Set<VideoCodec>([
+  "wmv3", "vc1", "mpeg4",
+  "rv10", "rv20", "rv30", "rv40",
+  "mpeg2", "mpeg1", "theora",
+]);
+const FALLBACK_AUDIO_CODECS = new Set<AudioCodec>([
+  "wmav2", "wmapro", "ac3", "eac3",
+  "cook", "ra_144", "ra_288", "sipr", "atrac3",
+]);
 
 /**
  * Containers `<video>` plays directly. Anything else with otherwise-supported

package/src/element/avbridge-video.ts

@@ -170,11 +170,22 @@ export class AvbridgeVideoElement extends HTMLElementCtor {
   constructor() {
     super();
     const root = this.attachShadow({ mode: "open" });
+
+    // A positioned wrapper inside the shadow root. The fallback strategy
+    // overlays a canvas on top of the <video> via `target.parentNode` —
+    // that only works if the parent is a real Element with layout. Without
+    // this wrapper, `target.parentElement` would be null (ShadowRoot is
+    // not an Element) and the canvas would never attach to the DOM.
+    const stage = document.createElement("div");
+    stage.setAttribute("part", "stage");
+    stage.style.cssText = "position:relative;width:100%;height:100%;display:block;";
+    root.appendChild(stage);
+
     this._videoEl = document.createElement("video");
     this._videoEl.setAttribute("part", "video");
     this._videoEl.style.cssText = "width:100%;height:100%;display:block;background:#000;";
     this._videoEl.playsInline = true;
-    root.appendChild(this._videoEl);
+    stage.appendChild(this._videoEl);
 
     // Forward the underlying <video>'s `progress` event so consumers can
     // observe buffered-range updates without reaching into the shadow DOM.

package/src/player.ts

@@ -5,6 +5,7 @@ import { Diagnostics } from "./diagnostics.js";
 import { PluginRegistry } from "./plugins/registry.js";
 import { registerBuiltins } from "./plugins/builtin.js";
 import { discoverSidecars, attachSubtitleTracks, SubtitleResourceBag } from "./subtitles/index.js";
+import { dbg } from "./util/debug.js";
 import type {
   Classification,
   CreatePlayerOptions,
@@ -65,8 +66,14 @@ export class UnifiedPlayer {
   }
 
   private async bootstrap(): Promise<void> {
+    const bootstrapStart = performance.now();
     try {
-      const ctx = await probe(this.options.source);
+      dbg.info("bootstrap", "start");
+      const ctx = await dbg.timed("probe", "probe", 3000, () => 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;
 
@@ -99,6 +106,10 @@ export class UnifiedPlayer {
       const decision = this.options.initialStrategy
         ? buildInitialDecision(this.options.initialStrategy, ctx)
         : classify(ctx);
+      dbg.info("classify",
+        `strategy=${decision.strategy} class=${decision.class} reason="${decision.reason}"` +
+        (decision.fallbackChain ? ` fallback=${decision.fallbackChain.join("→")}` : ""),
+      );
       this.classification = decision;
       this.diag.recordClassification(decision);
 
@@ -137,6 +148,16 @@ export class UnifiedPlayer {
       this.startTimeupdateLoop();
       this.options.target.addEventListener("ended", () => this.emitter.emit("ended", undefined));
       this.emitter.emitSticky("ready", undefined);
+      const bootstrapElapsed = performance.now() - bootstrapStart;
+      dbg.info("bootstrap", `ready in ${bootstrapElapsed.toFixed(0)}ms`);
+      if (bootstrapElapsed > 5000) {
+        // eslint-disable-next-line no-console
+        console.warn(
+          "[avbridge:bootstrap]",
+          `total bootstrap time ${bootstrapElapsed.toFixed(0)}ms — 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);

package/src/probe/avi.ts

@@ -177,7 +177,9 @@ function ffmpegToAvbridgeVideo(name: string): VideoCodec {
     case "mpeg2video": return "mpeg2";
     case "mpeg1video": return "mpeg1";
     case "theora": return "theora";
-    case "rv30":
+    case "rv10":   return "rv10";
+    case "rv20":   return "rv20";
+    case "rv30":   return "rv30";
     case "rv40":   return "rv40";
     default:       return name as VideoCodec;
   }
@@ -198,6 +200,11 @@ function ffmpegToAvbridgeAudio(name: string): AudioCodec {
     case "wmav2":  return "wmav2";
     case "wmapro": 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 as AudioCodec;
   }
 }

package/src/probe/index.ts

@@ -21,12 +21,16 @@ const MEDIABUNNY_CONTAINERS = new Set<ContainerKind>([
  *
  * Routing:
  * 1. Sniff the magic header. Cheap, deterministic, ignores file extensions.
- * 2. If the container is one mediabunny supports → mediabunny. If mediabunny
- *    rejects, surface the real error rather than blindly falling through to
- *    libav (which would mask the real failure with a confusing libav error).
- * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js, lazy-loaded.
- *    `unknown` is included so genuinely unfamiliar files at least get a shot
- *    at the broader libav demuxer set.
+ * 2. If the container is one mediabunny supports → try mediabunny first
+ *    (fast path — it's a single pass of WASM-free JS parsing). If mediabunny
+ *    throws (e.g. an assertion on an unsupported sample entry like `mp4v`
+ *    for MPEG-4 Part 2 in ISOBMFF, or an exotic MKV codec), fall through to
+ *    libav.js which handles the long tail of codecs mediabunny doesn't.
+ *    The combined-error case surfaces *both* failures so the user sees
+ *    which path each step took.
+ * 3. If sniffing identifies AVI/ASF/FLV (or `unknown`) → libav.js directly.
+ *    mediabunny can't read those containers at all, so there's no fast path
+ *    to try.
  */
 export async function probe(source: MediaInput): Promise<MediaContext> {
   const normalized = await normalizeSource(source);
@@ -35,10 +39,27 @@ export async function probe(source: MediaInput): Promise<MediaContext> {
   if (MEDIABUNNY_CONTAINERS.has(sniffed)) {
     try {
       return await probeWithMediabunny(normalized, sniffed);
-    } catch (err) {
-      throw new Error(
-        `mediabunny failed to probe a ${sniffed} file: ${(err as Error).message}`,
+    } catch (mediabunnyErr) {
+      // mediabunny rejected the file. Before giving up, try libav — it can
+      // demux a much wider range of codec combinations in ISOBMFF/MKV/etc.
+      // than mediabunny's pure-JS parser (e.g. mp4v, wmv3-in-asf, flac in
+      // an MP4 container). This is "escalation", not "masking": if libav
+      // also fails we surface both errors below.
+      // eslint-disable-next-line no-console
+      console.warn(
+        `[avbridge] mediabunny rejected ${sniffed} file, falling back to libav:`,
+        (mediabunnyErr as Error).message,
       );
+      try {
+        const { probeWithLibav } = await import("./avi.js");
+        return await probeWithLibav(normalized, sniffed);
+      } catch (libavErr) {
+        const mbMsg = (mediabunnyErr as Error).message || String(mediabunnyErr);
+        const lvMsg = libavErr instanceof Error ? libavErr.message : String(libavErr);
+        throw new Error(
+          `failed to probe ${sniffed} file. mediabunny: ${mbMsg}. libav fallback: ${lvMsg}.`,
+        );
+      }
     }
   }
 

package/src/strategies/fallback/audio-output.ts

@@ -172,9 +172,31 @@ export class AudioOutput implements ClockSource {
     node.connect(this.gain);
 
     // Convert media time → ctx time using the anchor.
-    const ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor);
-    const safeStart = Math.max(ctxStart, this.ctx.currentTime);
-    node.start(safeStart);
+    let ctxStart = this.ctxTimeAtAnchor + (this.mediaTimeOfNext - this.mediaTimeOfAnchor);
+
+    // When the decoder is slower than realtime, `ctxStart` falls into
+    // the past (ctx.currentTime has already passed it). Clamping each
+    // sample to `ctx.currentTime` individually (the old behavior)
+    // caused every stale sample in a burst to start at *the same
+    // instant*, stacking them on top of each other — the audible
+    // symptom was a series of clicks / a chord of stuttering cook
+    // packets.
+    //
+    // Correct behavior: when the first sample of a burst is behind,
+    // *rebase the anchor forward* so ctxStart = ctx.currentTime now.
+    // Subsequent samples in the same burst then schedule at
+    // ctxStart + offset as usual, laying out sequentially on the
+    // timeline instead of piling up. The downside is a visible jump
+    // in the audio clock — but the alternative was silent corruption.
+    // `now()` readers (the video renderer) just see the clock step
+    // forward and drop any frames older than the new time.
+    if (ctxStart < this.ctx.currentTime) {
+      this.ctxTimeAtAnchor = this.ctx.currentTime;
+      this.mediaTimeOfAnchor = this.mediaTimeOfNext;
+      ctxStart = this.ctx.currentTime;
+    }
+
+    node.start(ctxStart);
 
     this.mediaTimeOfNext += frameCount / sampleRate;
     this.framesScheduled++;