avbridge 2.0.0 → 2.1.0

package/dist/element.cjs

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

package/dist/element.js

@@ -1,6 +1,6 @@
-import { createPlayer } from './chunk-HZF5JDOO.js';
+import { createPlayer } from './chunk-CUQD23WO.js';
 import './chunk-PQTZS7OA.js';
-import './chunk-5ISVAODK.js';
+import './chunk-EJH67FXG.js';
 import './chunk-J5MCMN3S.js';
 
 // src/element/avbridge-video.ts

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkTTV56KDB_cjs = require('./chunk-TTV56KDB.cjs');
+var chunkO34444ID_cjs = require('./chunk-O34444ID.cjs');
 var chunkY5FYF5KG_cjs = require('./chunk-Y5FYF5KG.cjs');
 var chunkL4NPOJ36_cjs = require('./chunk-L4NPOJ36.cjs');
-require('./chunk-Z2FJ5TJC.cjs');
+require('./chunk-JQH6D4OE.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 chunkTTV56KDB_cjs.probe(source);
+  const ctx = await chunkO34444ID_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 = chunkTTV56KDB_cjs.avbridgeVideoToMediabunny(video.codec);
+    const mbCodec = chunkO34444ID_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 = chunkTTV56KDB_cjs.avbridgeAudioToMediabunny(audio.codec);
+    const mbCodec = chunkO34444ID_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 chunkTTV56KDB_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
+    source: await chunkO34444ID_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-ZHOERPHW.cjs');
+    const loader = await import('./libav-loader-6APXVNIV.cjs');
     const routing = await import('./variant-routing-GOHB2RZN.cjs');
     loadLibav = loader.loadLibav;
     pickLibavVariant = routing.pickLibavVariant;
@@ -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 ? chunkTTV56KDB_cjs.avbridgeVideoToMediabunny(videoTrackInfo.codec) : null;
-  const mbAudioCodec = audioTrackInfo ? chunkTTV56KDB_cjs.avbridgeAudioToMediabunny(audioTrackInfo.codec) : null;
+  const mbVideoCodec = videoTrackInfo ? chunkO34444ID_cjs.avbridgeVideoToMediabunny(videoTrackInfo.codec) : null;
+  const mbAudioCodec = audioTrackInfo ? chunkO34444ID_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 chunkTTV56KDB_cjs.probe(source);
+  const ctx = await chunkO34444ID_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 chunkTTV56KDB_cjs.buildMediabunnySourceFromInput(mb, ctx.source),
+    source: await chunkO34444ID_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 chunkTTV56KDB_cjs.UnifiedPlayer; }
+  get: function () { return chunkO34444ID_cjs.UnifiedPlayer; }
 });
 Object.defineProperty(exports, "classify", {
   enumerable: true,
-  get: function () { return chunkTTV56KDB_cjs.classifyContext; }
+  get: function () { return chunkO34444ID_cjs.classifyContext; }
 });
 Object.defineProperty(exports, "createPlayer", {
   enumerable: true,
-  get: function () { return chunkTTV56KDB_cjs.createPlayer; }
+  get: function () { return chunkO34444ID_cjs.createPlayer; }
 });
 Object.defineProperty(exports, "probe", {
   enumerable: true,
-  get: function () { return chunkTTV56KDB_cjs.probe; }
+  get: function () { return chunkO34444ID_cjs.probe; }
 });
 Object.defineProperty(exports, "srtToVtt", {
   enumerable: true,
-  get: function () { return chunkTTV56KDB_cjs.srtToVtt; }
+  get: function () { return chunkO34444ID_cjs.srtToVtt; }
 });
 exports.remux = remux;
 exports.transcode = transcode;

package/dist/index.js

@@ -1,8 +1,8 @@
-import { probe, avbridgeVideoToMediabunny, avbridgeAudioToMediabunny, buildMediabunnySourceFromInput } from './chunk-HZF5JDOO.js';
-export { UnifiedPlayer, classifyContext as classify, createPlayer, probe, srtToVtt } from './chunk-HZF5JDOO.js';
+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 { prepareLibavInput } from './chunk-WD2ZNQA7.js';
-import './chunk-5ISVAODK.js';
+import './chunk-EJH67FXG.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-KA2MAWLM.js');
+    const loader = await import('./libav-loader-XKH2TKUW.js');
     const routing = await import('./variant-routing-JOBWXYKD.js');
     loadLibav = loader.loadLibav;
     pickLibavVariant = routing.pickLibavVariant;

package/dist/libav-loader-6APXVNIV.cjs

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

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

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

package/dist/libav-loader-XKH2TKUW.js

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbridge",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Play and convert arbitrary video files in the browser. Native, remux, hybrid, fallback, and transcode — one API.",
   "license": "MIT",
   "author": "Keishi Hattori",
@@ -34,7 +34,8 @@
   "type": "module",
   "sideEffects": [
     "./dist/element.js",
-    "./dist/element.cjs"
+    "./dist/element.cjs",
+    "./dist/element-browser.js"
   ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -49,16 +50,27 @@
       "types": "./dist/element.d.ts",
       "import": "./dist/element.js",
       "require": "./dist/element.cjs"
-    }
+    },
+    "./element-browser": {
+      "types": "./dist/element.d.ts",
+      "import": "./dist/element-browser.js"
+    },
+    "./vendor/*": "./vendor/*"
   },
   "files": [
     "dist",
     "src",
+    "vendor/libav/avbridge",
+    "vendor/libav/webcodecs",
+    "vendor/libav/README.md",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE.md",
+    "THIRD_PARTY_LICENSES.md"
   ],
   "scripts": {
+    "prebuild": "node scripts/copy-libav.mjs",
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
@@ -76,12 +88,12 @@
     "audit:bundle": "node scripts/bundle-audit.mjs"
   },
   "dependencies": {
+    "@libav.js/variant-webcodecs": "^6.8.8",
+    "libavjs-webcodecs-bridge": "^0.3.2",
     "mediabunny": "^1.40.1"
   },
   "optionalDependencies": {
-    "@libav.js/types": "^6.8.8",
-    "@libav.js/variant-webcodecs": "^6.8.8",
-    "libavjs-webcodecs-bridge": "^0.3.2"
+    "@libav.js/types": "^6.8.8"
   },
   "devDependencies": {
     "@types/node": "^20.11.0",

package/src/strategies/fallback/libav-loader.ts

@@ -92,6 +92,31 @@ async function loadVariant(
   // the same convention (`libav-webcodecs.mjs`, `libav-default.mjs`).
   const variantUrl = `${base}/libav-${variant}.mjs`;
 
+  // Preflight HEAD-ish check: issue a bytes=0-0 range request so a missing
+  // file fails fast with a clear error instead of hanging deep inside the
+  // dynamic import or inside libav's own WASM instantiation. Surfaces the
+  // most common mistake ("libav base path is wrong") in <100 ms instead of
+  // an indeterminate stall.
+  if (typeof fetch === "function") {
+    try {
+      const head = await fetch(variantUrl, { method: "GET", headers: { Range: "bytes=0-0" } });
+      if (!head.ok && head.status !== 206) {
+        throw new Error(
+          `HTTP ${head.status} ${head.statusText} — check that libav files are served ` +
+          `at ${base}/ (override via globalThis.AVBRIDGE_LIBAV_BASE)`,
+        );
+      }
+      // Drain the tiny response so the connection can be reused.
+      try { await head.arrayBuffer(); } catch { /* ignore */ }
+    } catch (err) {
+      cache.delete(key);
+      throw chain(
+        `libav.js "${variant}" variant not reachable at ${variantUrl}`,
+        err,
+      );
+    }
+  }
+
   let mod: LoadedVariant;
   try {
     // @ts-ignore runtime URL
@@ -105,10 +130,9 @@ async function loadVariant(
     const hint =
       variant === "avbridge"
         ? `The "avbridge" variant is a custom local build. Run \`./scripts/build-libav.sh\` ` +
-          `to produce it (requires Emscripten; ~15-30 min the first time), then ` +
-          `\`npm run predemo\` to copy it into the demo asset path.`
-        : `Make sure the variant files are present (run \`npm run predemo\` or copy ` +
-          `node_modules/@libav.js/variant-${variant}/dist/* into the URL space).`;
+          `to produce it (requires Emscripten; ~15-30 min the first time).`
+        : `Make sure the variant files are present at ${base}/ (set ` +
+          `globalThis.AVBRIDGE_LIBAV_BASE to override the default lookup path).`;
     throw new Error(
       `failed to load libav.js "${variant}" variant from ${variantUrl}. ${hint} ` +
         `Original error: ${(err as Error).message || String(err)}`,
@@ -161,15 +185,33 @@ function buildOpts(base: string, wantThreads: boolean): Record<string, unknown>
 }
 
 function libavBaseUrl(): string {
+  // Consumer override — the documented "LGPL replaceability" hook.
+  // Setting `globalThis.AVBRIDGE_LIBAV_BASE = "/my/path"` lets anyone swap
+  // in a different libav build (custom fragments, security patches, etc.)
+  // without rebuilding avbridge.
   const override =
     typeof globalThis !== "undefined"
       ? (globalThis as { AVBRIDGE_LIBAV_BASE?: string }).AVBRIDGE_LIBAV_BASE
       : undefined;
   if (override) return override;
-  if (typeof location !== "undefined" && location.protocol.startsWith("http")) {
-    return `${location.origin}/libav`;
+
+  // Default: resolve relative to this module's URL. When avbridge is installed
+  // under `node_modules/avbridge/`, this module lives at `dist/chunk-*.js` (or
+  // `dist/element-browser.js` for the browser entry) and `../vendor/libav`
+  // resolves to `node_modules/avbridge/vendor/libav`, where the build step
+  // vendored every variant's binaries. That's the zero-config path.
+  //
+  // `import.meta.url` throws in some synthetic environments (CJS tests, some
+  // SSR evaluators). If it fails, fall back to the legacy `/libav` path so
+  // consumers who relied on the pre-2.1 behavior still work.
+  try {
+    return new URL("../vendor/libav", import.meta.url).href;
+  } catch {
+    if (typeof location !== "undefined" && location.protocol.startsWith("http")) {
+      return `${location.origin}/libav`;
+    }
+    return "/libav";
   }
-  return "/libav";
 }
 
 function chain(message: string, err: unknown): Error {

package/src/stubs/node-fs-promises.ts

@@ -0,0 +1,29 @@
+/**
+ * Browser stub for `node:fs/promises`.
+ *
+ * mediabunny's ESM entry transitively imports `node:fs/promises` from its
+ * Node-compat `node.js` file (used by `FilePathSource` / `FilePathTarget`).
+ * Its `package.json` has a `browser` field that tells bundlers to stub this
+ * out at build time — but import maps in the browser can't read
+ * `package.json`, so for the pre-bundled `dist/element-browser.js` entry we
+ * have tsup/esbuild alias `node:fs/promises` → this file at bundle time.
+ *
+ * Any caller that reaches this code is trying to use a Node-only feature in
+ * the browser and will fail loudly with a clear message instead of hanging
+ * or throwing an opaque `undefined is not a function` somewhere deep in
+ * mediabunny.
+ */
+function notAvailable(): never {
+  throw new Error(
+    "node:fs/promises is not available in the browser. " +
+    "The file-path APIs (FilePathSource / FilePathTarget) only work in Node.js.",
+  );
+}
+
+export const open = notAvailable;
+export const readFile = notAvailable;
+export const writeFile = notAvailable;
+export const stat = notAvailable;
+export const mkdir = notAvailable;
+export const rm = notAvailable;
+export const unlink = notAvailable;

package/vendor/libav/README.md

@@ -0,0 +1,139 @@
+# vendor/libav — avbridge custom libav.js build
+
+This directory holds a **custom-built libav.js variant** with the demuxers
+and decoders avbridge needs for legacy file playback. The npm-published variants
+of libav.js are intentionally minimal — none of them include the AVI/ASF/FLV
+demuxers or the legacy codec decoders (WMV3, MPEG-4 Part 2, MS-MPEG4, VC-1,
+…). The supported way to get those is to build a custom variant locally.
+
+## TL;DR
+
+```bash
+./scripts/build-libav.sh   # 15-30 minutes the first time
+npm run predemo            # copies vendor/libav/* into demo/public/libav/avbridge/
+npm run demo
+```
+
+After the first run, `~/.cache/avbridge/` contains the emsdk and libav.js source
+trees so subsequent rebuilds (e.g. after editing the fragment list) are
+incremental and much faster.
+
+## What gets built
+
+The fragment list in `scripts/build-libav.sh` enables:
+
+| Demuxers | Decoders (video) | Decoders (audio) | Bitstream filters |
+|---|---|---|---|
+| avi, asf, flv, matroska, mov, mp3, ogg, wav, aac | h264, hevc, mpeg4 (Part 2 / DivX / Xvid), msmpeg4 v1/v2/v3, wmv1/2/3, vc1, mpeg1, mpeg2 | aac, mp3, ac3, eac3, wmav1/v2, wmapro | mpeg4_unpack_bframes |
+
+Plus the parsers needed by each codec, plus `swscale` (video colorspace
+conversion) and `swresample` (audio resampling).
+
+The `mpeg4_unpack_bframes` BSF fixes the "packed B-frames" oddity in some
+DivX files where two frames are stored in one packet — without the BSF the
+decoder produces frames with fuzzy timing that the renderer drops as late.
+
+Output binary is roughly 10–15 MB. It is loaded **lazily** by avbridge — only
+when probe or classification routes a file to it. Users who only ever play
+modern MP4/MKV/WebM never download it.
+
+## Compile flags
+
+The default libav.js Makefile uses `OPTFLAGS=-Oz` (size-optimized, slow).
+We override to `-O3 -msimd128`:
+
+- `-O3` — full optimization, ~1.5–2× speedup over `-Oz` for video decode.
+- `-msimd128` — emit WebAssembly SIMD instructions. emscripten translates
+  ffmpeg's SSE2-style intrinsics into WASM SIMD ops, which gives another
+  ~1.5–2× for IDCT, motion compensation, deblocking. Requires a browser
+  with WASM SIMD (Chrome 91+, Firefox 89+, Safari 16.4+).
+
+Override at invocation time:
+
+```bash
+avbridge_LIBAV_OPTFLAGS="-O2" ./scripts/build-libav.sh
+```
+
+The script tracks the hash of `(fragments, OPTFLAGS)` in
+`~/.cache/avbridge/libav.js/.avbridge-build-inputs`. If you re-run with different
+inputs, it wipes `build/ffmpeg-*` and `build/inst` to force a clean
+rebuild — Make can't detect OPTFLAGS changes on its own, so without the
+hash check stale `-Oz` objects would silently survive.
+
+## Adding or removing codecs
+
+Edit the `VARIANT_FRAGMENTS` heredoc in `scripts/build-libav.sh`. The
+fragment names follow FFmpeg's `--enable-decoder=<name>` /
+`--enable-demuxer=<name>` conventions:
+
+- `demuxer-<format>` — read this container
+- `decoder-<codec>` — decode this codec
+- `parser-<codec>` — parse stream metadata for this codec (tiny, usually
+  needed alongside the matching decoder for seeking)
+
+See [`docs/CONFIG.md`][config-md] in the libav.js repo for the full grammar
+and [`configs/mkconfigs.js`][mkconfigs] for the names of every fragment.
+
+[config-md]: https://github.com/Yahweasel/libav.js/blob/master/docs/CONFIG.md
+[mkconfigs]: https://github.com/Yahweasel/libav.js/blob/master/configs/mkconfigs.js
+
+After editing, re-run `./scripts/build-libav.sh` — the make-based build is
+incremental, so changes only rebuild the affected pieces.
+
+## Build script behavior
+
+- Caches everything under `$avbridge_BUILD_CACHE` (default `~/.cache/avbridge`).
+  Override the cache location by setting that env var.
+- Installs **emsdk** into `~/.cache/avbridge/emsdk` — does **not** touch your
+  system Python, Homebrew, or any global package manager. Only the
+  `emsdk/` directory is modified.
+- Clones **libav.js** into `~/.cache/avbridge/libav.js` and checks out the
+  pinned `v6.8.8.0` tag.
+- Writes a custom variant config via `node configs/mkconfig.js avbridge [...]`.
+- Runs `make build-avbridge`, which downloads ffmpeg sources, applies libav.js's
+  patches, and compiles to WASM.
+- Copies the resulting `libav-6.8.8.0-avbridge.{mjs,wasm.mjs,wasm.wasm,…}` into
+  this directory.
+
+To force a clean rebuild from scratch:
+
+```bash
+avbridge_LIBAV_CLEAN=1 ./scripts/build-libav.sh
+```
+
+## Loader integration
+
+The avbridge runtime knows about three variants — `webcodecs`, `default`, `avbridge`
+— defined in `src/strategies/fallback/libav-loader.ts`. The variant routing
+in `src/strategies/fallback/variant-routing.ts` decides which one a given
+`MediaContext` needs:
+
+- Modern containers + browser-supported codecs → `webcodecs`
+- AVI / ASF / FLV containers, or any of the legacy codec set → `avbridge`
+
+The loader fetches each variant via a runtime URL with `/* @vite-ignore */`,
+so Vite never pre-bundles it. The variant's `import.meta.url` resolves to
+`/libav/<variant>/libav-<variant>.mjs` and its sibling `.wasm.mjs` /
+`.wasm.wasm` files are served from the same directory.
+
+## Licensing
+
+libav.js is **LGPL-2.1**. If you ship a custom variant in a product, you
+must also distribute the corresponding source / build script. Keep
+`scripts/build-libav.sh` and the libav.js repo URL alongside any binaries
+you redistribute.
+
+## Files in this directory after a successful build
+
+```
+vendor/libav/
+├── README.md                              ← this file
+├── libav-avbridge.mjs                         ← entry point (loaded by avbridge)
+├── libav-6.8.8.0-avbridge.wasm.mjs            ← WASM build factory
+├── libav-6.8.8.0-avbridge.wasm.wasm           ← compiled binary
+├── libav-6.8.8.0-avbridge.thr.mjs             ← threaded build factory (optional)
+├── libav-6.8.8.0-avbridge.thr.wasm            ← threaded binary (optional)
+└── libav-6.8.8.0-avbridge.asm.{js,mjs}        ← asm.js fallback (very rarely used)
+```
+
+The script also copies `.dbg.*` debug builds when present.