Monorepoize

Author: dy

.npmignore

@@ -0,0 +1,5 @@
+packages/
+fixtures/
+test.js
+test.browser.js
+.work/

package-lock.json

@@ -13,6 +13,9 @@
     },
     "./package.json": "./package.json"
   },
+  "workspaces": [
+    "packages/*"
+  ],
   "dependencies": {
     "@audio/aac-decode": "^1.0.2",
     "@audio/aiff-decode": "^1.0.0",

package.json

@@ -0,0 +1,4 @@
+node_modules/
+lib/faad2/
+src/aac.wasm.cjs
+/.claude

packages/aac-decode/.gitignore

@@ -0,0 +1,9 @@
+This work is offered to Krishna (https://github.com/krishnized/license).
+
+---
+
+This package is licensed under the GNU General Public License v2.0 (GPL-2.0),
+as required by the included FAAD2 library.
+
+FAAD2 Copyright (C) 2003-2005 M. Bakker, Nero AG, http://www.nero.com
+Full GPL-2.0 text: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

packages/aac-decode/LICENSE

@@ -0,0 +1,60 @@
+# aac-decode
+
+Decode AAC/M4A audio to PCM float samples. FAAD2 compiled to WASM — works in Node.js and browsers, no native dependencies.
+
+## Install
+
+```
+npm i @audio/aac-decode
+```
+
+## Usage
+
+```js
+import decode from '@audio/aac-decode'
+
+// M4A or raw ADTS — auto-detected
+let { channelData, sampleRate } = await decode(uint8array)
+// channelData: Float32Array[] (one per channel)
+// sampleRate: number
+```
+
+### Streaming
+
+```js
+import { decoder } from '@audio/aac-decode'
+
+let dec = await decoder()
+let { channelData, sampleRate } = dec.decode(chunk)
+dec.free()
+```
+
+## API
+
+### `decode(src: Uint8Array | ArrayBuffer): Promise<AudioData>`
+
+Whole-file decode. Auto-detects M4A (MP4 container) vs raw ADTS.
+
+### `decoder(): Promise<AACDecoder>`
+
+Creates a decoder instance for manual control.
+
+- **`dec.decode(data)`** — decode chunk, returns `{ channelData, sampleRate }`
+- **`dec.flush()`** — flush remaining (returns empty for AAC)
+- **`dec.free()`** — release WASM memory
+
+### `AudioData`
+
+```ts
+{ channelData: Float32Array[], sampleRate: number }
+```
+
+## Formats
+
+- M4A / MP4 with AAC audio
+- Raw ADTS streams (.aac)
+- LC, HE-AAC v1/v2 (SBR, PS)
+
+## License
+
+GPL-2.0 (FAAD2) — [krishnized](https://github.com/krishnized/license)

packages/aac-decode/README.md

@@ -0,0 +1,16 @@
+interface AudioData {
+  channelData: Float32Array[];
+  sampleRate: number;
+}
+
+interface AACDecoder {
+  decode(data: Uint8Array): AudioData;
+  flush(): AudioData;
+  free(): void;
+}
+
+/** Whole-file decode — auto-detects M4A vs ADTS */
+export default function decode(src: ArrayBuffer | Uint8Array): Promise<AudioData>;
+
+/** Create streaming decoder instance */
+export function decoder(): Promise<AACDecoder>;