avbridge 2.1.2 → 2.2.0

package/dist/element.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkDPVIOYGC_cjs = require('./chunk-DPVIOYGC.cjs');
-require('./chunk-Y5FYF5KG.cjs');
-require('./chunk-JQH6D4OE.cjs');
+var chunkOE66B34H_cjs = require('./chunk-OE66B34H.cjs');
+require('./chunk-HZLQNKFN.cjs');
+require('./chunk-G4APZMCP.cjs');
 require('./chunk-NZU7W256.cjs');
 
 // src/element/avbridge-video.ts
@@ -226,7 +226,7 @@ var AvbridgeVideoElement = class extends HTMLElementCtor {
     this._dispatch("loadstart", {});
     let player;
     try {
-      player = await chunkDPVIOYGC_cjs.createPlayer({
+      player = await chunkOE66B34H_cjs.createPlayer({
         source,
         target: this._videoEl,
         // Honor the consumer's preferred initial strategy. "auto" means

package/dist/element.d.cts

@@ -1,4 +1,4 @@
-import { a as MediaInput, m as StrategyName, S as StrategyClass, U as UnifiedPlayer, d as AudioTrackInfo, n as SubtitleTrackInfo, D as DiagnosticsSnapshot } from './player-BdtUG4rh.cjs';
+import { a as MediaInput, m as StrategyName, S as StrategyClass, U as UnifiedPlayer, d as AudioTrackInfo, n as SubtitleTrackInfo, D as DiagnosticsSnapshot } from './player-DUyvltvy.cjs';
 
 /**
  * `<avbridge-video>` — `HTMLMediaElement`-compatible primitive backed by the

package/dist/element.d.ts

@@ -1,4 +1,4 @@
-import { a as MediaInput, m as StrategyName, S as StrategyClass, U as UnifiedPlayer, d as AudioTrackInfo, n as SubtitleTrackInfo, D as DiagnosticsSnapshot } from './player-BdtUG4rh.js';
+import { a as MediaInput, m as StrategyName, S as StrategyClass, U as UnifiedPlayer, d as AudioTrackInfo, n as SubtitleTrackInfo, D as DiagnosticsSnapshot } from './player-DUyvltvy.js';
 
 /**
  * `<avbridge-video>` — `HTMLMediaElement`-compatible primitive backed by the

package/dist/element.js

@@ -1,6 +1,6 @@
-import { createPlayer } from './chunk-3AUGRKPY.js';
-import './chunk-PQTZS7OA.js';
-import './chunk-EJH67FXG.js';
+import { createPlayer } from './chunk-C5VA5U5O.js';
+import './chunk-ILKDNBSE.js';
+import './chunk-5DMTJVIU.js';
 import './chunk-J5MCMN3S.js';
 
 // src/element/avbridge-video.ts

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkDPVIOYGC_cjs = require('./chunk-DPVIOYGC.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 chunkDPVIOYGC_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 = chunkDPVIOYGC_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 = chunkDPVIOYGC_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 chunkDPVIOYGC_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 ? chunkDPVIOYGC_cjs.avbridgeVideoToMediabunny(videoTrackInfo.codec) : null;
-  const mbAudioCodec = audioTrackInfo ? chunkDPVIOYGC_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 chunkDPVIOYGC_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 chunkDPVIOYGC_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 chunkDPVIOYGC_cjs.UnifiedPlayer; }
+  get: function () { return chunkOE66B34H_cjs.UnifiedPlayer; }
 });
 Object.defineProperty(exports, "classify", {
   enumerable: true,
-  get: function () { return chunkDPVIOYGC_cjs.classifyContext; }
+  get: function () { return chunkOE66B34H_cjs.classifyContext; }
 });
 Object.defineProperty(exports, "createPlayer", {
   enumerable: true,
-  get: function () { return chunkDPVIOYGC_cjs.createPlayer; }
+  get: function () { return chunkOE66B34H_cjs.createPlayer; }
 });
 Object.defineProperty(exports, "probe", {
   enumerable: true,
-  get: function () { return chunkDPVIOYGC_cjs.probe; }
+  get: function () { return chunkOE66B34H_cjs.probe; }
 });
 Object.defineProperty(exports, "srtToVtt", {
   enumerable: true,
-  get: function () { return chunkDPVIOYGC_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.

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.

package/dist/index.js

@@ -1,8 +1,8 @@
-import { probe, avbridgeVideoToMediabunny, avbridgeAudioToMediabunny, buildMediabunnySourceFromInput } from './chunk-3AUGRKPY.js';
-export { UnifiedPlayer, classifyContext as classify, createPlayer, probe, srtToVtt } from './chunk-3AUGRKPY.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.2",
+  "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/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/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++;

package/src/strategies/fallback/decoder.ts

@@ -135,6 +135,20 @@ export async function startDecoder(opts: StartDecoderOptions): Promise<DecoderHa
   let videoFramesDecoded = 0;
   let audioFramesDecoded = 0;
 
+  // Decode-rate watchdog. Samples framesDecoded every second and
+  // compares against realtime expected frames for the source fps. If
+  // the decoder sustains less than 60% of realtime for more than
+  // 5 seconds (counting only time since the first frame emerged),
+  // emits a one-shot diagnostic so users know why playback is
+  // stuttering instead of guessing. A second one-shot fires if the
+  // renderer's overflow-drop rate exceeds 10% of decoded frames —
+  // that symptom means the decoder is BURSTING faster than the
+  // renderer can drain, which is a different bug from "decoder slow".
+  let watchdogFirstFrameMs = 0;
+  let watchdogSlowSinceMs = 0;
+  let watchdogSlowWarned = false;
+  let watchdogOverflowWarned = false;
+
   // Synthetic timestamp counters. Reset on seek.
   let syntheticVideoUs = 0;
   let syntheticAudioUs = 0;
@@ -150,10 +164,18 @@ export async function startDecoder(opts: StartDecoderOptions): Promise<DecoderHa
       let readErr: number;
       let packets: Record<number, LibavPacket[]>;
       try {
-        // Smaller batch = fewer frames per decode round = less queue burst.
-        // 16 KB ≈ 4 video packets + ~12 audio packets at typical DivX
-        // bitrates. The renderer drains ~1 frame per 33ms rAF tick, so
-        // keeping bursts ≤ 4-6 frames prevents queue overflow.
+        // Batch size tunes the tradeoff between JS↔WASM call overhead
+        // (small = more crossings per second) and queue burstiness
+        // (large = decoder hands the renderer big bursts at once that
+        // can blow past the renderer's 64-frame hard cap before the
+        // per-batch `queueHighWater` throttle runs).
+        //
+        // We tried 64 KB and saw ~30% overflow drops on RMVB:rv40 at
+        // 1024x768 because one decode batch regularly produced >30
+        // frames. 16 KB keeps each batch ≈ 4-6 video packets at
+        // typical bitrates, so the worst-case queue spike stays under
+        // `queueHighWater` and the throttle has a chance to apply
+        // backpressure *between* batches rather than within one.
         [readErr, packets] = await libav.ff_read_frame_multi(fmt_ctx, readPkt, {
           limit: 16 * 1024,
         });
@@ -167,16 +189,82 @@ export async function startDecoder(opts: StartDecoderOptions): Promise<DecoderHa
       const videoPackets = videoStream ? packets[videoStream.index] : undefined;
       const audioPackets = audioStream ? packets[audioStream.index] : undefined;
 
-      if (videoDec && videoPackets && videoPackets.length > 0) {
-        await decodeVideoBatch(videoPackets, myToken);
-      }
-      if (myToken !== pumpToken || destroyed) return;
+      // Decode audio BEFORE video. On software-decode-bound content
+      // (rv40/mpeg4/wmv3 @ 720p+) a single video batch can take
+      // 200-400 ms of wall time; if the scheduler hasn't been fed
+      // during that window, audio output runs dry and the user hears
+      // clicks/gaps. Audio is time-critical; video can drop a frame
+      // and nobody notices. Audio decode is also typically <1 ms per
+      // packet for cook/mp3/aac, so doing it first barely delays
+      // video decoding at all.
       if (audioDec && audioPackets && audioPackets.length > 0) {
         await decodeAudioBatch(audioPackets, myToken);
       }
+      if (myToken !== pumpToken || destroyed) return;
+      if (videoDec && videoPackets && videoPackets.length > 0) {
+        await decodeVideoBatch(videoPackets, myToken);
+      }
 
       packetsRead += (videoPackets?.length ?? 0) + (audioPackets?.length ?? 0);
 
+      // ── Decode-rate watchdog ──────────────────────────────────────
+      if (videoFramesDecoded > 0) {
+        if (watchdogFirstFrameMs === 0) {
+          watchdogFirstFrameMs = performance.now();
+        }
+        const elapsedSinceFirst = (performance.now() - watchdogFirstFrameMs) / 1000;
+
+        // 1. Slow-decode detection (sustained <60% of realtime fps).
+        if (elapsedSinceFirst > 1 && !watchdogSlowWarned) {
+          const expectedFrames = elapsedSinceFirst * videoFps;
+          const ratio = videoFramesDecoded / expectedFrames;
+          if (ratio < 0.6) {
+            if (watchdogSlowSinceMs === 0) watchdogSlowSinceMs = performance.now();
+            if ((performance.now() - watchdogSlowSinceMs) / 1000 > 5) {
+              watchdogSlowWarned = 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 — ` +
+                `${(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;
+          }
+        }
+
+        // 2. Overflow-drop detection (>10% of decoded frames dropped
+        //    by the renderer's hard cap). This means the decoder
+        //    produces BURSTS — it's fast enough on average but one
+        //    batch delivers >30 frames at a time, overflowing before
+        //    the queueHighWater throttle can apply backpressure.
+        //    Symptom is different from "decoder slow": here the fps
+        //    ratio looks fine but the user sees choppy playback.
+        if (
+          !watchdogOverflowWarned &&
+          videoFramesDecoded > 100 // wait for a meaningful sample
+        ) {
+          const rendererStats = opts.renderer.stats() as { framesDroppedOverflow?: number };
+          const overflow = rendererStats.framesDroppedOverflow ?? 0;
+          if (overflow / videoFramesDecoded > 0.1) {
+            watchdogOverflowWarned = true;
+            console.warn(
+              "[avbridge:overflow-drop]",
+              `renderer is dropping ${overflow}/${videoFramesDecoded} frames ` +
+              `(${((overflow / videoFramesDecoded) * 100).toFixed(0)}%) because the decoder ` +
+              `is producing bursts faster than the canvas can drain. Symptom: choppy ` +
+              `playback despite decoder keeping up on average. Fix would be smaller ` +
+              `read batches in the pump loop or a lower queueHighWater cap — see ` +
+              `src/strategies/fallback/decoder.ts.`,
+            );
+          }
+        }
+      }
+
       // Throttle: don't run too far ahead of playback. Two backpressure
       // signals:
       //   - Audio buffer (mediaTimeOfNext - now()) > 2 sec — we have