avbridge 2.2.0 → 2.3.0

package/dist/source-73CAH6HW.cjs

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

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

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

package/dist/source-F656KYYV.js

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

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

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

package/dist/source-QJR3OHTW.js

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

package/dist/source-QJR3OHTW.js.map

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

package/dist/source-VB74JQ7Z.cjs

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

package/dist/source-VB74JQ7Z.cjs.map

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

package/dist/variant-routing-434STYAB.js

@@ -0,0 +1,3 @@
+export { pickLibavVariant } from './chunk-5YAWWKA3.js';
+//# sourceMappingURL=variant-routing-434STYAB.js.map
+//# sourceMappingURL=variant-routing-434STYAB.js.map

package/dist/{variant-routing-JOBWXYKD.js.map → variant-routing-434STYAB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"variant-routing-JOBWXYKD.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"variant-routing-434STYAB.js"}

package/dist/variant-routing-HONNAA6R.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkF3LQJKXK_cjs = require('./chunk-F3LQJKXK.cjs');
+
+
+
+Object.defineProperty(exports, "pickLibavVariant", {
+  enumerable: true,
+  get: function () { return chunkF3LQJKXK_cjs.pickLibavVariant; }
+});
+//# sourceMappingURL=variant-routing-HONNAA6R.cjs.map
+//# sourceMappingURL=variant-routing-HONNAA6R.cjs.map

package/dist/{variant-routing-GOHB2RZN.cjs.map → variant-routing-HONNAA6R.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"variant-routing-GOHB2RZN.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"variant-routing-HONNAA6R.cjs"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avbridge",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Play and convert arbitrary video files in the browser. Native, remux, hybrid, fallback, and transcode — one API.",
   "license": "MIT",
   "author": "Keishi Hattori",
@@ -35,6 +35,8 @@
   "sideEffects": [
     "./dist/element.js",
     "./dist/element.cjs",
+    "./dist/player.js",
+    "./dist/player.cjs",
     "./dist/element-browser.js"
   ],
   "main": "./dist/index.cjs",
@@ -51,6 +53,11 @@
       "import": "./dist/element.js",
       "require": "./dist/element.cjs"
     },
+    "./player": {
+      "types": "./dist/player.d.ts",
+      "import": "./dist/player.js",
+      "require": "./dist/player.cjs"
+    },
     "./element-browser": {
       "types": "./dist/element.d.ts",
       "import": "./dist/element-browser.js"
@@ -83,6 +90,7 @@
     "test:playback": "node scripts/playback-test.mjs",
     "test:convert": "node scripts/convert-test.mjs",
     "test:element": "node scripts/element-test.mjs",
+    "test:player-controls": "node scripts/player-controls-test.mjs",
     "test:url-streaming": "node scripts/url-streaming-test.mjs",
     "fixtures": "node scripts/generate-fixtures.mjs",
     "audit:bundle": "node scripts/bundle-audit.mjs"

package/src/classify/rules.ts

@@ -13,8 +13,9 @@ import { mp4MimeFor, mseSupports } from "../util/codec-strings.js";
  * Codecs we know `<video>` and MSE support across modern desktop + Android.
  * The decision to remux instead of decode hinges on this list.
  */
-const NATIVE_VIDEO_CODECS = new Set<VideoCodec>(["h264", "h265", "vp8", "vp9", "av1"]);
-const NATIVE_AUDIO_CODECS = new Set<AudioCodec>([
+/** Codecs the browser can decode natively (also the set WebCodecs can transcode). */
+export const NATIVE_VIDEO_CODECS = new Set<VideoCodec>(["h264", "h265", "vp8", "vp9", "av1"]);
+export const NATIVE_AUDIO_CODECS = new Set<AudioCodec>([
   "aac",
   "mp3",
   "opus",
@@ -25,14 +26,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>([
+export const FALLBACK_VIDEO_CODECS = new Set<VideoCodec>([
   "wmv3", "vc1", "mpeg4",
   "rv10", "rv20", "rv30", "rv40",
   "mpeg2", "mpeg1", "theora",
 ]);
-const FALLBACK_AUDIO_CODECS = new Set<AudioCodec>([
+export const FALLBACK_AUDIO_CODECS = new Set<AudioCodec>([
   "wmav2", "wmapro", "ac3", "eac3",
   "cook", "ra_144", "ra_288", "sipr", "atrac3",
+  "dts", "truehd",
 ]);
 
 /**
@@ -120,7 +122,27 @@ export function classifyContext(ctx: MediaContext): Classification {
       reason: `video codec "${video.codec}" has no browser decoder; WASM fallback required`,
     };
   }
-  if (audio && FALLBACK_AUDIO_CODECS.has(audio.codec)) {
+  // Audio codec needs WASM decode — either it's in the known fallback set
+  // or it's unrecognized ("unknown" / not in native set). Unknown codecs
+  // definitely can't play natively, so they get the same treatment.
+  const audioNeedsFallback = audio && (
+    FALLBACK_AUDIO_CODECS.has(audio.codec) ||
+    !NATIVE_AUDIO_CODECS.has(audio.codec)
+  );
+  if (audioNeedsFallback) {
+    // If the VIDEO codec is native, prefer hybrid (WebCodecs hardware video
+    // decode + libav software audio decode) over full WASM fallback. This is
+    // critical for Blu-ray MKVs: H.264 1080p in WASM is unwatchably slow,
+    // but WebCodecs decodes it at full speed while libav handles the DTS/AC3
+    // audio in software.
+    if (NATIVE_VIDEO_CODECS.has(video.codec) && webCodecsAvailable()) {
+      return {
+        class: "HYBRID_CANDIDATE",
+        strategy: "hybrid",
+        reason: `video "${video.codec}" is hardware-decodable via WebCodecs; audio "${audio.codec}" decoded in software by libav`,
+        fallbackChain: ["fallback"],
+      };
+    }
     return {
       class: "FALLBACK_REQUIRED",
       strategy: "fallback",

package/src/convert/remux.ts

@@ -11,6 +11,7 @@
  */
 
 import { probe } from "../probe/index.js";
+import { isAnnexB, annexBToAvcc } from "../strategies/remux/annexb.js";
 import {
   avbridgeVideoToMediabunny,
   avbridgeAudioToMediabunny,
@@ -304,6 +305,13 @@ async function doLibavRemux(
           return ts;
         }, videoTimeBase);
 
+        // libav demuxes AVI/ASF/FLV H.264 as Annex B (start-code framed),
+        // but mediabunny's fMP4 muxer expects AVCC (length-prefixed). Convert
+        // on the fly. The check is cheap: isAnnexB reads 4 bytes at the head.
+        if (videoTrackInfo && (videoTrackInfo.codec === "h264" || videoTrackInfo.codec === "h265") && isAnnexB(pkt.data)) {
+          pkt.data = annexBToAvcc(pkt.data);
+        }
+
         const mbPacket = libavPacketToMediAbunny(mb, pkt);
         await videoSource.add(
           mbPacket,

package/src/convert/transcode.ts

@@ -79,7 +79,7 @@ async function attemptTranscode(
   audioCodec: OutputAudioCodec,
   quality: TranscodeQuality,
   options: TranscodeOptions,
-): Promise<ArrayBuffer> {
+): Promise<ArrayBuffer | null> {
   const mb = await import("mediabunny");
 
   const input = new mb.Input({
@@ -87,10 +87,25 @@ async function attemptTranscode(
     formats: mb.ALL_FORMATS,
   });
 
-  const target = new mb.BufferTarget();
+  // When outputStream is provided, pipe chunks directly to the stream
+  // instead of accumulating into a buffer. This keeps memory usage flat
+  // regardless of file size.
+  let bytesWritten = 0;
+  const useStream = !!options.outputStream;
+  const bufferTarget = useStream ? null : new mb.BufferTarget();
+  const streamTarget = useStream
+    ? new mb.StreamTarget(new WritableStream({
+        write(chunk: { type: string; data: Uint8Array; position: number }) {
+          bytesWritten += chunk.data.byteLength;
+          const writer = options.outputStream!.getWriter();
+          return writer.write(chunk.data).then(() => writer.releaseLock());
+        },
+      }))
+    : null;
+
   const output = new mb.Output({
     format: createOutputFormat(mb, outputFormat),
-    target,
+    target: (streamTarget ?? bufferTarget)!,
   });
 
   // Build mediabunny ConversionVideoOptions
@@ -160,10 +175,13 @@ async function attemptTranscode(
     }
   }
 
-  if (!target.buffer) {
+  if (useStream) {
+    return null; // data already written to outputStream
+  }
+  if (!bufferTarget!.buffer) {
     throw new Error("Transcode failed: mediabunny produced no output buffer.");
   }
-  return target.buffer;
+  return bufferTarget!.buffer;
 }
 
 /**
@@ -234,14 +252,29 @@ async function doTranscode(
     }
   }
 
+  const mimeType = mimeForFormat(outputFormat);
+  const filename = generateFilename(ctx.name, outputFormat);
+
+  if (options.outputStream) {
+    // Streaming mode — data already written to the stream. Return empty blob.
+    options.onProgress?.({ percent: 100, bytesWritten: 0 });
+    return {
+      blob: new Blob([], { type: mimeType }),
+      mimeType,
+      container: outputFormat,
+      videoCodec: options.dropVideo ? undefined : videoCodec,
+      audioCodec: options.dropAudio ? undefined : audioCodec,
+      duration: ctx.duration,
+      filename,
+      ...(notes.length > 0 ? { notes } : {}),
+    };
+  }
+
   if (!buffer) {
     throw new Error("Transcode failed: no buffer produced (this should be unreachable).");
   }
 
-  const mimeType = mimeForFormat(outputFormat);
   const blob = new Blob([buffer], { type: mimeType });
-  const filename = generateFilename(ctx.name, outputFormat);
-
   options.onProgress?.({ percent: 100, bytesWritten: blob.size });
 
   return {