parakeet.ts 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcin Bunsch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,286 @@
+# parakeet.ts
+
+TypeScript runtime for Nvidia Parakeet ASR models. Runs on Apple Silicon via MLX, or Nvidia GPUs (Linux) via ONNX Runtime.
+
+> **Not affiliated with NVIDIA.**
+
+## Requirements
+
+- Node.js 18.11+
+- [ffmpeg](https://ffmpeg.org/) in `$PATH` (for audio file decoding)
+- A backend, chosen automatically by [`load()`](#usage):
+  - **MLX** — Apple Silicon Mac (M1 or later). No extra install.
+  - **ONNX Runtime** — everywhere else (CUDA on Linux/Nvidia, CPU otherwise).
+    Install the optional `onnxruntime-node` package.
+
+## Install
+
+```sh
+npm install parakeet.ts
+```
+
+## Backends
+
+The model, audio front-end, decode loop, and alignment are backend-agnostic, and
+`load()` picks the right backend for the machine — you normally don't choose one.
+For explicit control, import a backend's loader directly. Every path returns the
+same `ParakeetModel`, so all the examples below work unchanged.
+
+| Backend | Runs on | `load()` picks it | Explicit import |
+|---------|---------|-------------------|-----------------|
+| **MLX** | Apple Silicon (Metal) | on Apple Silicon | `parakeet.ts/mlx` — `fromPretrained`, `fromLocal` |
+| **ONNX Runtime** | Nvidia GPU (CUDA, Linux) / CPU | everywhere else | `parakeet.ts/onnx` — `fromLocal` |
+
+Each backend has its own default checkpoint (different asset formats, same
+transcripts). The CLI and HTTP server use the MLX backend. See
+[docs/cuda.md](docs/cuda.md) for the dual-backend design and benchmarks.
+
+## Usage
+
+### SDK
+
+```ts
+import { load } from 'parakeet.ts';
+
+const model = await load(); // detects the backend, downloads the model on first run
+const result = await model.transcribe('recording.wav');
+
+console.log(result.text);
+// "Hello world"
+
+console.log(result.sentences);
+// [{ text: 'Hello world', start: 0, end: 1.2, duration: 1.2, tokens: [...] }]
+```
+
+`load()` is the canonical entry point. It selects the backend for the current
+machine — **MLX** on Apple Silicon, **ONNX Runtime** everywhere else — and
+downloads that backend's default checkpoint from HuggingFace Hub on first run,
+caching under `~/.cache/huggingface/hub/`. Subsequent calls load from cache.
+
+```ts
+const model = await load({
+  // backend:  'auto' (default) | 'mlx' | 'onnx'
+  // model:    HF repo id or local directory (default: the backend's checkpoint)
+  // cacheDir: override the HF cache root
+  // executionProvider: ONNX only — 'cuda' | 'cpu' | ...
+  // filterbank: 'interpolated' (default) | 'floor'
+  onProgress(file, downloaded, total) {
+    console.error(`${file}: ${Math.round((downloaded / total) * 100)}%`);
+  },
+});
+
+// Ask which backend load() would choose here, without loading:
+import { detectBackend } from 'parakeet.ts';
+detectBackend(); // 'mlx' | 'onnx'
+```
+
+To pin a backend or load from a local directory instead of auto-selecting, use
+the per-backend loaders — see [Backends](#backends) and
+[ONNX Runtime backend](#onnx-runtime-backend):
+
+```ts
+import { fromPretrained, fromLocal } from 'parakeet.ts/mlx';
+
+const a = await fromPretrained('mlx-community/parakeet-tdt-0.6b-v3');
+const b = fromLocal('/path/to/mlx-model-dir');
+```
+
+#### Streaming
+
+For real-time or incremental transcription, use `StreamingParakeet` directly or the `consumePcmStream` helper:
+
+```ts
+import { consumePcmStream } from 'parakeet.ts';
+
+const stream = model.transcribeStream();
+const result = await consumePcmStream(stream, pcmFrameIterable);
+// pcmFrameIterable: AsyncIterable<Float32Array> — 16kHz mono f32le
+```
+
+`consumePcmStream` returns only once the source is exhausted. To surface partial
+transcripts as audio arrives, drive it manually and read the getters after each
+chunk:
+
+```ts
+const stream = model.transcribeStream();
+
+for await (const chunk of pcmFrameIterable) {
+  await stream.addAudio(chunk);              // async
+  console.log(stream.result.text);           // best current guess (finalized + draft)
+  console.log(stream.finalizedResult.text);  // committed tokens only — never revised
+}
+
+const final = stream.finish();               // commit the remaining draft
+```
+
+Streaming is backend-agnostic — the same `StreamingParakeet` runs on MLX and ONNX.
+
+#### Concurrency
+
+Each model instance has an internal async mutex. Concurrent `await model.transcribe(...)` calls on the same instance are automatically serialized — no GPU-state corruption. For lower tail latency under bursty load, create a pool:
+
+```ts
+const pool = await Promise.all([load(), load()]);
+let i = 0;
+const next = () => pool[i++ % pool.length];
+```
+
+#### Output shape
+
+All entry points return `AlignedResult`:
+
+```ts
+type AlignedResult = {
+  text: string;
+  sentences: AlignedSentence[];
+};
+
+type AlignedSentence = {
+  text: string;
+  start: number;    // seconds
+  end: number;
+  duration: number;
+  tokens: AlignedToken[];
+};
+
+type AlignedToken = {
+  id: number;
+  text: string;
+  start: number;    // seconds
+  duration: number;
+};
+```
+
+### ONNX Runtime backend
+
+On anything other than Apple Silicon, `load()` uses [ONNX Runtime](https://onnxruntime.ai/)
+(CUDA execution provider on Linux/Nvidia, CPU elsewhere). It needs the optional
+runtime:
+
+```sh
+npm install onnxruntime-node
+```
+
+With that installed, `await load()` downloads the default ONNX checkpoint
+([`istupakov/parakeet-tdt-0.6b-v3-onnx`](https://huggingface.co/istupakov/parakeet-tdt-0.6b-v3-onnx))
+and runs — no other setup. Pass the execution provider through if you want to
+override it:
+
+```ts
+const model = await load({ executionProvider: 'cuda' }); // 'cuda' | 'cpu' | 'tensorrt' | 'coreml' | 'dml'
+```
+
+To use your own exported graphs, load a local directory containing
+`encoder-model.onnx` (plus its `encoder-model.onnx.data` sidecar — keep the
+filename), `decoder_joint-model.onnx`, and `vocab.txt`:
+
+```ts
+import { fromLocal } from 'parakeet.ts/onnx';
+
+const model = await fromLocal('/path/to/onnx-model-dir', {
+  executionProvider: 'cuda',        // default: 'cuda' on Linux/Windows x64, 'cpu' elsewhere
+  decoderExecutionProvider: 'cpu',  // optional: run the small per-step decoder on CPU
+});
+```
+
+Either way `model` is the same `ParakeetModel`, so streaming, concurrency, and
+the [output shape](#output-shape) behave identically. Only TDT and RNN-T
+checkpoints are available as ONNX exports.
+
+### CLI
+
+```sh
+# Transcribe a file (auto-downloads model on first run)
+parakeet recording.wav
+
+# JSON output with word-level timestamps
+parakeet recording.wav --json
+
+# Different model
+parakeet recording.wav --model mlx-community/parakeet-tdt-0.6b-v3
+
+# Stream raw f32le mono 16kHz PCM from stdin
+ffmpeg -i recording.wav -f f32le -ar 16000 -ac 1 - | parakeet --stream
+```
+
+Options:
+
+```
+--model, -m <id>   HuggingFace repo ID or local directory (default: mlx-community/parakeet-tdt-0.6b-v3)
+--json, -j         Output full AlignedResult JSON instead of plain text
+--stream, -s       Read raw f32le mono 16kHz PCM from stdin
+--help, -h         Show help
+```
+
+Exit codes: `0` success, `1` file/IO error, `2` model error.
+
+### HTTP server
+
+The `parakeet.ts/mlx/server` entry point exports a [Hono](https://hono.dev/) route factory. Install the extra deps first:
+
+```sh
+npm install hono @hono/node-server
+```
+
+```ts
+import { Hono } from 'hono';
+import { serve } from '@hono/node-server';
+import { fromPretrained } from 'parakeet.ts/mlx';
+import { createParakeetRoutes } from 'parakeet.ts/mlx/server';
+
+const model = await fromPretrained('mlx-community/parakeet-tdt-0.6b-v3');
+
+const app = new Hono();
+app.route('/asr', createParakeetRoutes({
+  model,
+  maxDurationSeconds: 300,  // default
+  idleTimeoutMs: 30_000,    // default
+}));
+
+serve({ fetch: app.fetch, port: 8080 });
+```
+
+#### `POST /asr/transcribe`
+
+Send raw f32le mono 16kHz PCM audio as the request body.
+
+**Request headers:**
+```
+Content-Type: audio/pcm; rate=16000; channels=1; format=f32le
+```
+
+**Response `200`:** `AlignedResult` JSON
+
+**Error responses:**
+```json
+{ "error": "<code>", "message": "<human-readable>" }
+```
+
+| Status | Error code | Cause |
+|--------|------------|-------|
+| 408 | `idle_timeout` | No bytes for `idleTimeoutMs` ms |
+| 413 | `payload_too_large` | Audio exceeds `maxDurationSeconds` |
+| 415 | `unsupported_media_type` | Wrong Content-Type |
+| 500 | `internal_error` | Unexpected error |
+
+## Available models
+
+| Model | HuggingFace ID | Notes |
+|-------|---------------|-------|
+| Parakeet TDT 0.6B v2 | `mlx-community/parakeet-tdt-0.6b-v2` | |
+| Parakeet TDT 0.6B v3 | `mlx-community/parakeet-tdt-0.6b-v3` | **Default** |
+| Parakeet RNNT 0.6B | `mlx-community/parakeet-rnnt-0.6b` | |
+| Parakeet CTC 0.6B | `mlx-community/parakeet-ctc-0.6b` | |
+| Parakeet TDT-CTC 0.6B | `mlx-community/parakeet-tdt-ctc-0.6b` | |
+| Parakeet TDT 1.1B | `mlx-community/parakeet-tdt-1.1b` | |
+
+`load()` downloads a default checkpoint per backend — `mlx-community/parakeet-tdt-0.6b-v3`
+(MLX) or [`istupakov/parakeet-tdt-0.6b-v3-onnx`](https://huggingface.co/istupakov/parakeet-tdt-0.6b-v3-onnx)
+(ONNX). The table lists the MLX (`mlx-community`) checkpoints; pass any of them as
+`load({ model })` or to `fromPretrained`. ONNX exports live in their own repos —
+`load({ backend: 'onnx' })` fetches the default automatically, or point
+`fromLocal` at a local directory of graphs.
+
+## License
+
+MIT

package/dist/alignment.d.ts

@@ -0,0 +1,36 @@
+export interface AlignedToken {
+    id: number;
+    text: string;
+    start: float;
+    duration: float;
+    confidence: float;
+    end: float;
+}
+type float = number;
+export declare function makeAlignedToken(id: number, text: string, start: number, duration: number, confidence?: number): AlignedToken;
+export interface AlignedSentence {
+    text: string;
+    tokens: AlignedToken[];
+    start: number;
+    end: number;
+    duration: number;
+    confidence: number;
+}
+export declare function makeAlignedSentence(text: string, tokens: AlignedToken[]): AlignedSentence;
+export interface AlignedResult {
+    text: string;
+    sentences: AlignedSentence[];
+    tokens: AlignedToken[];
+}
+export declare function makeAlignedResult(text: string, sentences: AlignedSentence[]): AlignedResult;
+export interface SentenceConfig {
+    maxWords?: number;
+    silenceGap?: number;
+    maxDuration?: number;
+}
+export declare function tokensToSentences(tokens: AlignedToken[], config?: SentenceConfig): AlignedSentence[];
+export declare function sentencesToResult(sentences: AlignedSentence[]): AlignedResult;
+export declare function mergeLongestContiguous(a: AlignedToken[], b: AlignedToken[], overlapDuration: number): AlignedToken[];
+export declare function mergeLongestCommonSubsequence(a: AlignedToken[], b: AlignedToken[], overlapDuration: number): AlignedToken[];
+export {};
+//# sourceMappingURL=alignment.d.ts.map

package/dist/alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.d.ts","sourceRoot":"","sources":["../src/alignment.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;IAClB,GAAG,EAAE,KAAK,CAAC;CACZ;AAGD,KAAK,KAAK,GAAG,MAAM,CAAC;AAEpB,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,MAAY,GACvB,YAAY,CAEd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EAAE,GACrB,eAAe,CASjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,eAAe,EAAE,GAC3B,aAAa,CAQf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,GAAE,cAAmB,GAC1B,eAAe,EAAE,CAgDnB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,aAAa,CAG7E;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,YAAY,EAAE,EACjB,CAAC,EAAE,YAAY,EAAE,EACjB,eAAe,EAAE,MAAM,GACtB,YAAY,EAAE,CA2EhB;AAED,wBAAgB,6BAA6B,CAC3C,CAAC,EAAE,YAAY,EAAE,EACjB,CAAC,EAAE,YAAY,EAAE,EACjB,eAAe,EAAE,MAAM,GACtB,YAAY,EAAE,CAsFhB"}

package/dist/alignment.js

@@ -0,0 +1,202 @@
+export function makeAlignedToken(id, text, start, duration, confidence = 1.0) {
+    return { id, text, start, duration, confidence, end: start + duration };
+}
+export function makeAlignedSentence(text, tokens) {
+    const sorted = [...tokens].sort((a, b) => a.start - b.start);
+    const start = sorted[0].start;
+    const end = sorted[sorted.length - 1].end;
+    const duration = end - start;
+    // Geometric mean of token confidences
+    const logSum = sorted.reduce((acc, t) => acc + Math.log(t.confidence + 1e-10), 0);
+    const confidence = Math.exp(logSum / sorted.length);
+    return { text, tokens: sorted, start, end, duration, confidence };
+}
+export function makeAlignedResult(text, sentences) {
+    return {
+        text: text.trim(),
+        sentences,
+        get tokens() {
+            return sentences.flatMap(s => s.tokens);
+        },
+    };
+}
+export function tokensToSentences(tokens, config = {}) {
+    if (tokens.length === 0)
+        return [];
+    const sentences = [];
+    let current = [];
+    for (let idx = 0; idx < tokens.length; idx++) {
+        const token = tokens[idx];
+        current.push(token);
+        const isPunctuation = token.text.includes('!') ||
+            token.text.includes('?') ||
+            token.text.includes('。') ||
+            token.text.includes('？') ||
+            token.text.includes('！') ||
+            (token.text.includes('.') &&
+                (idx === tokens.length - 1 || tokens[idx + 1].text.includes(' ')));
+        const isWordLimit = config.maxWords !== undefined &&
+            idx !== tokens.length - 1 &&
+            current.filter(t => t.text.includes(' ')).length +
+                (tokens[idx + 1].text.includes(' ') ? 1 : 0) >
+                config.maxWords;
+        const isLongSilence = config.silenceGap !== undefined &&
+            idx !== tokens.length - 1 &&
+            tokens[idx + 1].start - token.end >= config.silenceGap;
+        const isOverDuration = config.maxDuration !== undefined &&
+            token.end - current[0].start >= config.maxDuration;
+        if (isPunctuation || isWordLimit || isLongSilence || isOverDuration) {
+            const text = current.map(t => t.text).join('');
+            sentences.push(makeAlignedSentence(text, current));
+            current = [];
+        }
+    }
+    if (current.length > 0) {
+        const text = current.map(t => t.text).join('');
+        sentences.push(makeAlignedSentence(text, current));
+    }
+    return sentences;
+}
+export function sentencesToResult(sentences) {
+    const text = sentences.map(s => s.text).join('');
+    return makeAlignedResult(text, sentences);
+}
+export function mergeLongestContiguous(a, b, overlapDuration) {
+    if (a.length === 0)
+        return b;
+    if (b.length === 0)
+        return a;
+    const aEndTime = a[a.length - 1].end;
+    const bStartTime = b[0].start;
+    if (aEndTime <= bStartTime)
+        return [...a, ...b];
+    const overlapA = a.filter(t => t.end > bStartTime - overlapDuration);
+    const overlapB = b.filter(t => t.start < aEndTime + overlapDuration);
+    const enoughPairs = Math.floor(overlapA.length / 2);
+    if (overlapA.length < 2 || overlapB.length < 2) {
+        const cutoffTime = (aEndTime + bStartTime) / 2;
+        return [
+            ...a.filter(t => t.end <= cutoffTime),
+            ...b.filter(t => t.start >= cutoffTime),
+        ];
+    }
+    // Find longest contiguous matching subsequence
+    let bestContiguous = [];
+    for (let i = 0; i < overlapA.length; i++) {
+        for (let j = 0; j < overlapB.length; j++) {
+            if (overlapA[i].id === overlapB[j].id &&
+                Math.abs(overlapA[i].start - overlapB[j].start) < overlapDuration / 2) {
+                const current = [];
+                let k = i, l = j;
+                while (k < overlapA.length &&
+                    l < overlapB.length &&
+                    overlapA[k].id === overlapB[l].id &&
+                    Math.abs(overlapA[k].start - overlapB[l].start) < overlapDuration / 2) {
+                    current.push([k, l]);
+                    k++;
+                    l++;
+                }
+                if (current.length > bestContiguous.length) {
+                    bestContiguous = current;
+                }
+            }
+        }
+    }
+    if (bestContiguous.length >= enoughPairs) {
+        const aStartIdx = a.length - overlapA.length;
+        const lcsIndicesA = bestContiguous.map(p => aStartIdx + p[0]);
+        const lcsIndicesB = bestContiguous.map(p => p[1]);
+        const result = [];
+        result.push(...a.slice(0, lcsIndicesA[0]));
+        for (let i = 0; i < bestContiguous.length; i++) {
+            result.push(a[lcsIndicesA[i]]);
+            if (i < bestContiguous.length - 1) {
+                const nextA = lcsIndicesA[i + 1];
+                const nextB = lcsIndicesB[i + 1];
+                const gapA = a.slice(lcsIndicesA[i] + 1, nextA);
+                const gapB = b.slice(lcsIndicesB[i] + 1, nextB);
+                result.push(...(gapB.length > gapA.length ? gapB : gapA));
+            }
+        }
+        result.push(...b.slice(lcsIndicesB[lcsIndicesB.length - 1] + 1));
+        return result;
+    }
+    throw new Error(`No pairs exceeding ${enoughPairs}`);
+}
+export function mergeLongestCommonSubsequence(a, b, overlapDuration) {
+    if (a.length === 0)
+        return b;
+    if (b.length === 0)
+        return a;
+    const aEndTime = a[a.length - 1].end;
+    const bStartTime = b[0].start;
+    if (aEndTime <= bStartTime)
+        return [...a, ...b];
+    const overlapA = a.filter(t => t.end > bStartTime - overlapDuration);
+    const overlapB = b.filter(t => t.start < aEndTime + overlapDuration);
+    if (overlapA.length < 2 || overlapB.length < 2) {
+        const cutoffTime = (aEndTime + bStartTime) / 2;
+        return [
+            ...a.filter(t => t.end <= cutoffTime),
+            ...b.filter(t => t.start >= cutoffTime),
+        ];
+    }
+    // LCS dynamic programming
+    const m = overlapA.length;
+    const n = overlapB.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (overlapA[i - 1].id === overlapB[j - 1].id &&
+                Math.abs(overlapA[i - 1].start - overlapB[j - 1].start) < overlapDuration / 2) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    // Backtrack
+    const lcsPairs = [];
+    let i = m, j = n;
+    while (i > 0 && j > 0) {
+        if (overlapA[i - 1].id === overlapB[j - 1].id &&
+            Math.abs(overlapA[i - 1].start - overlapB[j - 1].start) < overlapDuration / 2) {
+            lcsPairs.push([i - 1, j - 1]);
+            i--;
+            j--;
+        }
+        else if (dp[i - 1][j] > dp[i][j - 1]) {
+            i--;
+        }
+        else {
+            j--;
+        }
+    }
+    lcsPairs.reverse();
+    if (lcsPairs.length === 0) {
+        const cutoffTime = (aEndTime + bStartTime) / 2;
+        return [
+            ...a.filter(t => t.end <= cutoffTime),
+            ...b.filter(t => t.start >= cutoffTime),
+        ];
+    }
+    const aStartIdx = a.length - overlapA.length;
+    const lcsIndicesA = lcsPairs.map(p => aStartIdx + p[0]);
+    const lcsIndicesB = lcsPairs.map(p => p[1]);
+    const result = [];
+    result.push(...a.slice(0, lcsIndicesA[0]));
+    for (let k = 0; k < lcsPairs.length; k++) {
+        result.push(a[lcsIndicesA[k]]);
+        if (k < lcsPairs.length - 1) {
+            const nextA = lcsIndicesA[k + 1];
+            const nextB = lcsIndicesB[k + 1];
+            const gapA = a.slice(lcsIndicesA[k] + 1, nextA);
+            const gapB = b.slice(lcsIndicesB[k] + 1, nextB);
+            result.push(...(gapB.length > gapA.length ? gapB : gapA));
+        }
+    }
+    result.push(...b.slice(lcsIndicesB[lcsIndicesB.length - 1] + 1));
+    return result;
+}
+//# sourceMappingURL=alignment.js.map

package/dist/alignment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.js","sourceRoot":"","sources":["../src/alignment.ts"],"names":[],"mappings":"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"}

package/dist/audio.d.ts

@@ -0,0 +1,59 @@
+export interface PreprocessArgs {
+    sampleRate: number;
+    normalize: string;
+    windowSize: number;
+    windowStride: number;
+    window: string;
+    features: number;
+    nFft: number;
+    dither: number;
+    padTo: number;
+    padValue: number;
+    preemph: number | null;
+    magPower: number;
+    winLength: number;
+    hopLength: number;
+    /** [features, nFft/2+1], row-major */
+    filterbanks: Float32Array;
+}
+/** Log-mel output, laid out [nMels, numFrames] — the encoder's `audio_signal` order. */
+export interface LogMel {
+    data: Float32Array;
+    nMels: number;
+    numFrames: number;
+}
+/** Decode any ffmpeg-readable file to mono float32 PCM in [-1, 1]. */
+export declare function loadAudioRaw(filename: string, samplingRate: number): Float32Array;
+export declare function getWindow(name: string, size: number): Float32Array;
+/**
+ * Filterbank as parakeet-mlx builds it: mel points snapped to FFT bins with
+ * `floor`. NOTE: at 16 kHz / nFft 512 / 128 mels this collapses 13 rows to all
+ * zero — see docs/cuda.md. Kept as the default for bit-compatibility with the
+ * existing MLX path and the current test fixtures.
+ */
+export declare function computeMelFilterbanks(sr: number, nFft: number, nMels: number, fMin: number, fMax: number): Float32Array;
+/**
+ * librosa/NeMo-style filterbank: triangles evaluated on continuous frequencies,
+ * so no rows collapse. Matches NVIDIA's reference preprocessor. Opt in via
+ * `makePreprocessArgs({ filterbank: 'interpolated' })`.
+ */
+export declare function computeMelFilterbanksInterpolated(sr: number, nFft: number, nMels: number, fMin: number, fMax: number): Float32Array;
+export declare function makePreprocessArgs(args: {
+    sampleRate: number;
+    normalize: string;
+    windowSize: number;
+    windowStride: number;
+    window: string;
+    features: number;
+    nFft: number;
+    dither: number;
+    padTo?: number;
+    padValue?: number;
+    preemph?: number | null;
+    magPower?: number;
+    /** 'floor' (default, parakeet-mlx compatible) or 'interpolated' (NeMo reference) */
+    filterbank?: 'floor' | 'interpolated';
+}): PreprocessArgs;
+/** Log-mel spectrogram from mono PCM. Output is [nMels, numFrames]. */
+export declare function getLogMel(signalIn: Float32Array, args: PreprocessArgs): LogMel;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,wFAAwF;AACxF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAqBjF;AA6BD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CASlE;AAsGD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAClE,YAAY,CA0Bd;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAClE,YAAY,CAyBd;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;CACvC,GAAG,cAAc,CAkBjB;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CA0D9E"}