@audio/decode 3.12.0 → 3.13.0

package/audio-decode.js

@@ -124,14 +124,17 @@ function fmt(name, init) {
 
 // --- codecs ---
 // dedupe (3rd arg): decoder upmixes mono sources to duplicate stereo (verified for mp3;
-// aac/wma flagged conservatively — same lossy-wasm family). Exact containers never dedupe.
+// aac/wma flagged conservatively — same lossy-wasm family). Exact containers never dedupe;
+// video containers that may carry AAC or MP3 (mp4/mov, mkv, avi) do.
 
 reg('mp3', () => import('@audio/decode-mp3'), true)
 reg('flac', () => import('@audio/decode-flac'))
 reg('opus', () => import('@audio/decode-opus'))
 reg('oga', () => import('@audio/decode-vorbis'))
 
-reg('m4a', () => import('@audio/decode-aac'), true)
+reg('m4a', () => import('@audio/decode-mp4'), true)
+reg('mp4', () => import('@audio/decode-mp4'), true)
+reg('mov', () => import('@audio/decode-mp4'), true)
 
 reg('wav', () => import('@audio/decode-wav'))
 reg('qoa', () => import('@audio/decode-qoa'))
@@ -140,6 +143,8 @@ reg('aac', () => import('@audio/decode-aac'), true)
 reg('aiff', () => import('@audio/decode-aiff'))
 reg('caf', () => import('@audio/decode-caf'))
 reg('webm', () => import('@audio/decode-webm'))
+reg('mkv', () => import('@audio/decode-webm'), true)
+reg('avi', () => import('@audio/decode-avi'), true)
 reg('amr', () => import('@audio/decode-amr'))
 reg('wma', () => import('@audio/decode-wma'), true)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audio/decode",
-  "version": "3.12.0",
+  "version": "3.13.0",
   "description": "Decode audio data in node or browser",
   "type": "module",
   "sideEffects": false,
@@ -28,19 +28,21 @@
     "packages/*"
   ],
   "dependencies": {
-    "@audio/decode-aac": "^1.4.0",
+    "@audio/decode-aac": "^1.5.0",
     "@audio/decode-aiff": "^1.3.0",
     "@audio/decode-amr": "^1.3.0",
+    "@audio/decode-avi": "^1.0.0",
     "@audio/decode-caf": "^1.4.0",
     "@audio/decode-flac": "^1.3.0",
     "@audio/decode-mp3": "^1.3.0",
+    "@audio/decode-mp4": "^1.0.0",
     "@audio/decode-opus": "^1.3.0",
     "@audio/decode-qoa": "^1.2.0",
     "@audio/decode-vorbis": "^1.3.0",
     "@audio/decode-wav": "^1.5.0",
-    "@audio/decode-webm": "^1.4.0",
+    "@audio/decode-webm": "^1.5.0",
     "@audio/decode-wma": "^1.3.0",
-    "audio-type": "^2.4.0"
+    "audio-type": "^2.5.0"
   },
   "devDependencies": {
     "audio-lena": "^3.0.0",
@@ -79,7 +81,13 @@
     "amr",
     "wma",
     "pcm",
-    "streaming"
+    "streaming",
+    "mp4",
+    "mov",
+    "mkv",
+    "avi",
+    "video",
+    "extract"
   ],
   "author": "Dmitry Iv. <dfcreative@gmail.com>",
   "license": "MIT",

package/readme.md

@@ -22,10 +22,12 @@ const { channelData, sampleRate } = await decode(anyAudioBuffer);
 | FLAC | [@audio/decode-flac](./packages/decode-flac) | 135 KB | WASM |
 | Opus | [@audio/decode-opus](./packages/decode-opus) | 166 KB | WASM |
 | M4A / AAC / ALAC | [@audio/decode-aac](./packages/decode-aac) | 368 KB | WASM + JS |
+| MP4 / MOV / M4V / 3GP video | [@audio/decode-mp4](./packages/decode-mp4) | 12 KB + codec | JS demux |
 | QOA | [@audio/decode-qoa](./packages/decode-qoa) | 8 KB | JS |
 | AIFF | [@audio/decode-aiff](./packages/decode-aiff) | 20 KB | JS |
 | CAF | [@audio/decode-caf](./packages/decode-caf) | 9 KB | JS |
-| WebM | [@audio/decode-webm](./packages/decode-webm) | 250 KB | WASM |
+| WebM / MKV video | [@audio/decode-webm](./packages/decode-webm) | 250 KB | WASM |
+| AVI video | [@audio/decode-avi](./packages/decode-avi) | 8 KB + codec | JS demux |
 | AMR | [@audio/decode-amr](./packages/decode-amr) | 241 KB | WASM |
 | WMA | [@audio/decode-wma](./packages/decode-wma) | 91 KB | WASM |
 
@@ -42,28 +44,6 @@ let fromFile = await decode(fileInput.files[0])   // File
 let fromUrl  = await decode(await fetch(url))      // Response
 ```
 
-### Synchronous codecs
-
-The umbrella remains async for detection, lazy imports, and `Blob`/`Response` inputs.
-Import a codec package directly for synchronous calls.
-
-`wav`, `qoa`, `aiff`, and `caf` are synchronous:
-
-```js
-import decode from '@audio/decode-wav'
-let pcm = decode(wavBytes)
-```
-
-WASM codecs initialize asynchronously, then decode synchronously:
-
-```js
-import { decoder } from '@audio/decode-flac'
-let dec = await decoder()
-let pcm = dec.decode(bytes)
-let tail = dec.flush()
-dec.free()
-```
-
 ### Chunked
 
 ```js
@@ -85,7 +65,23 @@ for await (let { channelData, sampleRate } of decode.mp3(response.body)) {
 
 Works with `ReadableStream`, `fetch` body, Node stream, or any async iterable.
 
-Formats: `mp3`, `flac`, `opus`, `oga`, `m4a`, `wav`, `qoa`, `aac`, `aiff`, `caf`, `webm`, `amr`, `wma`.
+Formats: `mp3`, `flac`, `opus`, `oga`, `m4a`, `mp4`, `mov`, `wav`, `qoa`, `aac`, `aiff`, `caf`, `webm`, `mkv`, `avi`, `amr`, `wma`.
+
+### Video files
+
+Video containers decode straight to their audio track — the video stream is skipped, no ffmpeg involved:
+
+```js
+let { channelData, sampleRate } = await decode(await fetch('trailer.mp4'))
+```
+
+| Container | Package | Audio codecs |
+|---|---|---|
+| MP4, MOV, M4V, 3GP | [@audio/decode-mp4](./packages/decode-mp4) | AAC, ALAC, MP3, FLAC, Opus, AMR, PCM, G.711 |
+| WebM, MKV | [@audio/decode-webm](./packages/decode-webm) | Opus, Vorbis, AAC, ALAC, MP3, FLAC, PCM |
+| AVI | [@audio/decode-avi](./packages/decode-avi) | PCM, MP3, AAC, G.711 |
+
+AC-3, E-AC-3 and DTS tracks throw an error naming the codec.
 
 ### Browser
 
@@ -100,6 +96,32 @@ Works from a CDN without a bundler. Codecs load on demand via dynamic import, on
 
 For self-hosting, use an import map to point `@audio/decode` and each needed `@audio/decode-*` package to local files. Codec-internal files load by relative path.
 
+Each codec package's main export works in an `AudioWorklet` without `Blob`, `TextDecoder`, `Worker`, or `fetch`. Import codec packages directly because `@audio/decode` uses dynamic imports.
+
+Initialize WASM before rendering. Decoding runs on the worklet thread and can interrupt audio output.
+
+### Synchronous codecs
+
+The umbrella remains async for detection, lazy imports, and `Blob`/`Response` inputs.
+Import a codec package directly for synchronous calls.
+
+`wav`, `qoa`, `aiff`, and `caf` are synchronous:
+
+```js
+import decode from '@audio/decode-wav'
+let pcm = decode(wavBytes)
+```
+
+WASM codecs initialize asynchronously, then decode synchronously:
+
+```js
+import { decoder } from '@audio/decode-flac'
+let dec = await decoder()
+let pcm = dec.decode(bytes)
+let tail = dec.flush()
+dec.free()
+```
+
 ### Metadata
 
 Read tags, pictures, markers and regions without decoding samples. Available for
@@ -151,6 +173,8 @@ worker.onmessage = ({ data }) => { /* { channelData, sampleRate } */ }
 * [ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm) – full encoding/decoding library.
 -->
 
-<p align="center">Licensing: the umbrella and most codec packages are MIT. Three codecs use another license: <a href="./packages/decode-aac">@audio/decode-aac</a> GPL-2.0, <a href="./packages/decode-wma">@audio/decode-wma</a> GPL-2.0-or-later, and <a href="./packages/decode-amr">@audio/decode-amr</a> Apache-2.0. Install only the codecs whose licenses fit your project. The umbrella loads them on demand.</p>
+## Licensing
+
+The umbrella and most codec packages are MIT. Three codecs use another license: <a href="./packages/decode-aac">@audio/decode-aac</a> GPL-2.0, <a href="./packages/decode-wma">@audio/decode-wma</a> GPL-2.0-or-later, and <a href="./packages/decode-amr">@audio/decode-amr</a> Apache-2.0. Install only the codecs whose licenses fit your project. The umbrella loads them on demand.
 
 <p align="center"><a href="https://github.com/krishnized/license/">ॐ</a> · <a href="./LICENSE">MIT</a>

package/test.html

@@ -32,6 +32,9 @@
     "@audio/decode-aiff": "./packages/decode-aiff/decode-aiff.js",
     "@audio/decode-caf": "./packages/decode-caf/decode-caf.js",
     "@audio/decode-webm": "./packages/decode-webm/decode-webm.js",
+    "@audio/decode-mp4": "./packages/decode-mp4/decode-mp4.js",
+    "@audio/decode-avi": "./packages/decode-avi/decode-avi.js",
+    "@audio/decode-opus/core": "./packages/decode-opus/core.js",
     "@audio/decode-amr": "./packages/decode-amr/decode-amr.js",
     "@audio/decode-wma": "./packages/decode-wma/decode-wma.js"
   }