@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/transcription/TimestampedCueWordReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimestampedCueWordReader.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/TimestampedCueWordReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAYtF;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,YAAW,aAAa;IAE1D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,SAAS,EAAE,gBAAgB,EAC3B,cAAc,EAAE,iBAAiB,EACjC,SAAS,EAAE,mBAAmB;IAGjD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC;IAWjF,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/modules/transcription/TimestampedCueWordReader.js

@@ -0,0 +1,52 @@
+/** A cue timestamp: a position on its own inside the cue's text. */
+const CUE_TIMESTAMP = /<(?:\d{1,3}:)?\d{2}:\d{2}[.,]\d{1,3}>/g;
+/**
+ * Reads a cue from a format that can mark, inside the cue's own text,
+ * when a word is spoken — WebVTT does this so a caption can be revealed
+ * word by word without being broken into an entry per word.
+ *
+ * Each mark cuts the cue into a stretch that runs until the next mark,
+ * and the words of a stretch share it out between them. A mark before
+ * every word therefore yields the timing the file recorded; a mark
+ * every few words yields those, with the words between them estimated.
+ * A cue carrying no marks at all is one stretch, which is the same
+ * answer a format without marks would give.
+ */
+export class TimestampedCueWordReader {
+    tokenizer;
+    timecodeReader;
+    estimator;
+    constructor(tokenizer, timecodeReader, estimator) {
+        this.tokenizer = tokenizer;
+        this.timecodeReader = timecodeReader;
+        this.estimator = estimator;
+    }
+    read(text, startSeconds, endSeconds) {
+        return this.cutIntoStretches(text, startSeconds, endSeconds)
+            .flatMap((stretch) => [
+            ...this.estimator.spread(this.tokenizer.tokenize(stretch.text), stretch.startSeconds, stretch.endSeconds),
+        ]);
+    }
+    cutIntoStretches(text, startSeconds, endSeconds) {
+        const stretches = [];
+        let textFrom = 0;
+        let stretchStart = startSeconds;
+        for (const mark of text.matchAll(CUE_TIMESTAMP)) {
+            const markAt = this.positionOf(mark[0]);
+            const markFrom = mark.index ?? 0;
+            stretches.push({
+                text: text.slice(textFrom, markFrom),
+                startSeconds: stretchStart,
+                endSeconds: markAt,
+            });
+            textFrom = markFrom + mark[0].length;
+            stretchStart = markAt;
+        }
+        stretches.push({ text: text.slice(textFrom), startSeconds: stretchStart, endSeconds });
+        return stretches;
+    }
+    positionOf(mark) {
+        return this.timecodeReader.readPosition(mark.slice(1, -1));
+    }
+}
+//# sourceMappingURL=TimestampedCueWordReader.js.map

package/dist/modules/transcription/TimestampedCueWordReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimestampedCueWordReader.js","sourceRoot":"","sources":["../../../src/modules/transcription/TimestampedCueWordReader.ts"],"names":[],"mappings":"AAMA,oEAAoE;AACpE,MAAM,aAAa,GAAG,wCAAwC,CAAC;AAS/D;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,wBAAwB;IAEhB;IACA;IACA;IAHnB,YACmB,SAA2B,EAC3B,cAAiC,EACjC,SAA8B;QAF9B,cAAS,GAAT,SAAS,CAAkB;QAC3B,mBAAc,GAAd,cAAc,CAAmB;QACjC,cAAS,GAAT,SAAS,CAAqB;IAC9C,CAAC;IAEJ,IAAI,CAAC,IAAY,EAAE,YAAoB,EAAE,UAAkB;QACzD,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC;aACzD,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CACtB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EACrC,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,UAAU,CACnB;SACF,CAAC,CAAC;IACP,CAAC;IAEO,gBAAgB,CACtB,IAAY,EACZ,YAAoB,EACpB,UAAkB;QAElB,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,YAAY,GAAG,YAAY,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBACpC,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,MAAM;aACnB,CAAC,CAAC;YACH,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,YAAY,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/modules/transcription/Transcriber.d.ts

@@ -16,8 +16,21 @@ export type TranscriberProgressEvent = {
     stage: 'inferring';
     progress?: number;
 };
+/**
+ * An audio region, in absolute seconds, that transcription deliberately
+ * left empty because decoding produced no trustworthy output for it.
+ */
+export interface UntranscribedRegion {
+    startSeconds: number;
+    endSeconds: number;
+}
 export interface Transcriber {
     onProgress?: (event: TranscriberProgressEvent) => void;
+    /**
+     * Fired at most once per region, before `transcribe` resolves.
+     * Implementations that always cover the full audio never fire it.
+     */
+    onUntranscribedRegion?: (region: UntranscribedRegion) => void;
     transcribe(audio: Blob, options?: TranscriberOptions): Promise<Document>;
 }
 //# sourceMappingURL=Transcriber.d.ts.map

package/dist/modules/transcription/Transcriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transcriber.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/Transcriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACvD,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC1E"}
+{"version":3,"file":"Transcriber.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/Transcriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACvD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC9D,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC1E"}

package/dist/modules/transcription/TransformersRuntime.d.ts

@@ -0,0 +1,50 @@
+import type * as Transformers from '@huggingface/transformers';
+import type { ModelFileCache } from '../transcription/ModelFileCache';
+/**
+ * The inference library, loaded on first use and configured once.
+ *
+ * It is reached through a dynamic import because a static one makes the
+ * whole ONNX runtime a dependency of merely *naming* a transcriber: the
+ * package's entry point re-exports this module, so a consumer that
+ * imports a document node pulls the runtime with it. In a browser that
+ * is a large bundle nobody asked for; in Node it is a native binding
+ * loaded — and on musl, failed — for code that never runs inference.
+ *
+ * The environment settings live here rather than at the call site
+ * because they have to be applied before the first pipeline is built and
+ * exactly once. Holding the module and the settings together is what
+ * makes "loaded" and "configured" the same event.
+ *
+ * A failed load is not cached: the import can fail on a dead network the
+ * same way the weights can, and a caller retrying deserves to reach the
+ * network again.
+ */
+export declare class TransformersRuntime {
+    private readonly modelFileCache?;
+    private modulePromise;
+    constructor(modelFileCache?: ModelFileCache | undefined);
+    /**
+     * Resolves with the library, configured. Concurrent callers share one
+     * load, and the settings are applied before any of them sees it.
+     */
+    load(): Promise<typeof Transformers>;
+    private configure;
+    /**
+     * Takes over where the downloaded model files are kept.
+     *
+     * Left to itself the library picks a store from the environment and
+     * discards a refused write with nothing but a console warning, so a
+     * caller that wants to know when the files did not survive the run
+     * has to own the store. Without one, that default stands.
+     */
+    private installModelFileCache;
+    /**
+     * Raises the WASM thread count above ORT's built-in ceiling when the
+     * runtime supports it. ORT locks the count to 1 without cross-origin
+     * isolation, and even with isolation its own default caps at 4 no matter
+     * the machine — Whisper's encoder scales past that. On a WebGPU run this
+     * has no effect; the WASM backend is not touched.
+     */
+    private configureWasmThreading;
+}
+//# sourceMappingURL=TransformersRuntime.d.ts.map

package/dist/modules/transcription/TransformersRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformersRuntime.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/TransformersRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,YAAY,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAF5C,OAAO,CAAC,aAAa,CAA6C;gBAErC,cAAc,CAAC,EAAE,cAAc,YAAA;IAE5D;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,OAAO,YAAY,CAAC;IAcpC,OAAO,CAAC,SAAS;IAMjB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;CAM/B"}

package/dist/modules/transcription/TransformersRuntime.js

@@ -0,0 +1,79 @@
+/**
+ * The inference library, loaded on first use and configured once.
+ *
+ * It is reached through a dynamic import because a static one makes the
+ * whole ONNX runtime a dependency of merely *naming* a transcriber: the
+ * package's entry point re-exports this module, so a consumer that
+ * imports a document node pulls the runtime with it. In a browser that
+ * is a large bundle nobody asked for; in Node it is a native binding
+ * loaded — and on musl, failed — for code that never runs inference.
+ *
+ * The environment settings live here rather than at the call site
+ * because they have to be applied before the first pipeline is built and
+ * exactly once. Holding the module and the settings together is what
+ * makes "loaded" and "configured" the same event.
+ *
+ * A failed load is not cached: the import can fail on a dead network the
+ * same way the weights can, and a caller retrying deserves to reach the
+ * network again.
+ */
+export class TransformersRuntime {
+    modelFileCache;
+    modulePromise = null;
+    constructor(modelFileCache) {
+        this.modelFileCache = modelFileCache;
+    }
+    /**
+     * Resolves with the library, configured. Concurrent callers share one
+     * load, and the settings are applied before any of them sees it.
+     */
+    load() {
+        if (this.modulePromise === null) {
+            const attempt = import('@huggingface/transformers').then((module) => {
+                this.configure(module.env);
+                return module;
+            });
+            attempt.catch(() => {
+                if (this.modulePromise === attempt)
+                    this.modulePromise = null;
+            });
+            this.modulePromise = attempt;
+        }
+        return this.modulePromise;
+    }
+    configure(env) {
+        env.allowLocalModels = false;
+        this.installModelFileCache(env);
+        this.configureWasmThreading(env);
+    }
+    /**
+     * Takes over where the downloaded model files are kept.
+     *
+     * Left to itself the library picks a store from the environment and
+     * discards a refused write with nothing but a console warning, so a
+     * caller that wants to know when the files did not survive the run
+     * has to own the store. Without one, that default stands.
+     */
+    installModelFileCache(env) {
+        if (!this.modelFileCache)
+            return;
+        env.useCustomCache = true;
+        env.customCache = this.modelFileCache;
+    }
+    /**
+     * Raises the WASM thread count above ORT's built-in ceiling when the
+     * runtime supports it. ORT locks the count to 1 without cross-origin
+     * isolation, and even with isolation its own default caps at 4 no matter
+     * the machine — Whisper's encoder scales past that. On a WebGPU run this
+     * has no effect; the WASM backend is not touched.
+     */
+    configureWasmThreading(env) {
+        if (typeof self === 'undefined' || !self.crossOriginIsolated)
+            return;
+        const wasm = env.backends.onnx.wasm;
+        if (!wasm)
+            return;
+        wasm.numThreads = Math.min(navigator.hardwareConcurrency || 4, 8);
+    }
+}
+//# sourceMappingURL=TransformersRuntime.js.map

package/dist/modules/transcription/TransformersRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformersRuntime.js","sourceRoot":"","sources":["../../../src/modules/transcription/TransformersRuntime.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,mBAAmB;IAGD;IAFrB,aAAa,GAAwC,IAAI,CAAC;IAElE,YAA6B,cAA+B;QAA/B,mBAAc,GAAd,cAAc,CAAiB;IAAG,CAAC;IAEhE;;;OAGG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBAClE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;gBACjB,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO;oBAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAChE,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAEO,SAAS,CAAC,GAA4B;QAC5C,GAAG,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACK,qBAAqB,CAAC,GAA4B;QACxD,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QACjC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC;QAC1B,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACK,sBAAsB,CAAC,GAA4B;QACzD,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACrE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACpC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/modules/transcription/VttTranscriber.d.ts

@@ -0,0 +1,46 @@
+import type { Document } from '../document/Document';
+import type { Transcriber, TranscriberOptions, TranscriberProgressEvent } from '../transcription/Transcriber';
+/**
+ * Builds a Document by parsing a WebVTT (`.vtt`) caption file. Skips
+ * the mandatory `WEBVTT` header block and any `NOTE`, `STYLE`, or
+ * `REGION` blocks, then reads the cues below them.
+ *
+ * WebVTT can mark inside a cue when each word is spoken, and those
+ * marks are honoured: a file carrying them yields the word timings it
+ * recorded rather than a guess. Where a cue carries no marks, its words
+ * are shared out across it the way a format without marks requires.
+ *
+ * The audio Blob passed to `transcribe` is ignored. Useful when
+ * caption text and timing are already known — burning a hand-authored
+ * VTT into a video, replaying captions from a subtitle-authoring
+ * tool, etc.
+ *
+ * A block that carries no timecode is skipped and announced through
+ * `onSkippedCueBlock`, so a single broken cue costs its own text and
+ * nothing else. Throws only when the file has blocks and none of them
+ * could be read, or when a timecode itself is malformed.
+ *
+ * Builds its own collaborators rather than receiving them. The
+ * constructor is the surface a consumer of the engine reaches for, and
+ * it asks for a source and nothing else, so this class is where the
+ * parsing side is assembled rather than a participant in someone
+ * else's assembly.
+ */
+export declare class VttTranscriber implements Transcriber {
+    private readonly source;
+    onProgress?: (event: TranscriberProgressEvent) => void;
+    /**
+     * Fired once per block left out of the document, before
+     * `transcribe` resolves, carrying the block verbatim.
+     */
+    onSkippedCueBlock?: (block: string) => void;
+    private readonly timecodeReader;
+    private readonly documentBuilder;
+    private readonly wordReader;
+    constructor(source: string);
+    transcribe(_audio: Blob, _options?: TranscriberOptions): Promise<Document>;
+    private extractCueBlocks;
+    private stripWebVttHeader;
+    private isCueBlock;
+}
+//# sourceMappingURL=VttTranscriber.d.ts.map

package/dist/modules/transcription/VttTranscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VttTranscriber.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/VttTranscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAM3D,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,oCAAoC,CAAC;AAI5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,cAAe,YAAW,WAAW;IAiBpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAhBnC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAEvD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+C;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAIzB;gBAE2B,MAAM,EAAE,MAAM;IAErC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOhF,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,UAAU;CAOnB"}

package/dist/modules/transcription/VttTranscriber.js

@@ -0,0 +1,80 @@
+import { CueDocumentBuilder } from '../transcription/CueDocumentBuilder';
+import { CueTextTokenizer } from '../transcription/CueTextTokenizer';
+import { CueTimecodeReader } from '../transcription/CueTimecodeReader';
+import { TimestampedCueWordReader } from '../transcription/TimestampedCueWordReader';
+import { WordTimingEstimator } from '../transcription/WordTimingEstimator';
+const BOM_RE = /^\uFEFF/;
+/**
+ * Builds a Document by parsing a WebVTT (`.vtt`) caption file. Skips
+ * the mandatory `WEBVTT` header block and any `NOTE`, `STYLE`, or
+ * `REGION` blocks, then reads the cues below them.
+ *
+ * WebVTT can mark inside a cue when each word is spoken, and those
+ * marks are honoured: a file carrying them yields the word timings it
+ * recorded rather than a guess. Where a cue carries no marks, its words
+ * are shared out across it the way a format without marks requires.
+ *
+ * The audio Blob passed to `transcribe` is ignored. Useful when
+ * caption text and timing are already known — burning a hand-authored
+ * VTT into a video, replaying captions from a subtitle-authoring
+ * tool, etc.
+ *
+ * A block that carries no timecode is skipped and announced through
+ * `onSkippedCueBlock`, so a single broken cue costs its own text and
+ * nothing else. Throws only when the file has blocks and none of them
+ * could be read, or when a timecode itself is malformed.
+ *
+ * Builds its own collaborators rather than receiving them. The
+ * constructor is the surface a consumer of the engine reaches for, and
+ * it asks for a source and nothing else, so this class is where the
+ * parsing side is assembled rather than a participant in someone
+ * else's assembly.
+ */
+export class VttTranscriber {
+    source;
+    onProgress;
+    /**
+     * Fired once per block left out of the document, before
+     * `transcribe` resolves, carrying the block verbatim.
+     */
+    onSkippedCueBlock;
+    timecodeReader = new CueTimecodeReader();
+    documentBuilder = new CueDocumentBuilder(this.timecodeReader);
+    wordReader = new TimestampedCueWordReader(new CueTextTokenizer(), this.timecodeReader, new WordTimingEstimator());
+    constructor(source) {
+        this.source = source;
+    }
+    async transcribe(_audio, _options) {
+        this.onProgress?.({ stage: 'inferring', progress: 1 });
+        const result = this.documentBuilder.build(this.extractCueBlocks(this.source), this.wordReader);
+        for (const block of result.skippedBlocks)
+            this.onSkippedCueBlock?.(block);
+        return result.document;
+    }
+    extractCueBlocks(source) {
+        const normalized = source.replace(BOM_RE, '').replace(/\r\n?/g, '\n');
+        return this.stripWebVttHeader(normalized)
+            .split(/\n{2,}/)
+            .filter((block) => this.isCueBlock(block))
+            .join('\n\n');
+    }
+    stripWebVttHeader(source) {
+        if (!/^WEBVTT(?:\s|$)/.test(source))
+            return source;
+        const firstBlockEnd = source.indexOf('\n\n');
+        if (firstBlockEnd === -1)
+            return '';
+        return source.slice(firstBlockEnd + 2);
+    }
+    isCueBlock(block) {
+        const firstLine = block.trim().split('\n')[0]?.trim() ?? '';
+        if (firstLine.length === 0)
+            return false;
+        if (firstLine === 'STYLE' || firstLine === 'REGION')
+            return false;
+        if (firstLine === 'NOTE' || firstLine.startsWith('NOTE ') || firstLine.startsWith('NOTE\t'))
+            return false;
+        return true;
+    }
+}
+//# sourceMappingURL=VttTranscriber.js.map

package/dist/modules/transcription/VttTranscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VttTranscriber.js","sourceRoot":"","sources":["../../../src/modules/transcription/VttTranscriber.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAOjF,MAAM,MAAM,GAAG,SAAS,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,OAAO,cAAc;IAiBI;IAhB7B,UAAU,CAA6C;IAEvD;;;OAGG;IACH,iBAAiB,CAA2B;IAE3B,cAAc,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACzC,eAAe,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9D,UAAU,GAAG,IAAI,wBAAwB,CACxD,IAAI,gBAAgB,EAAE,EACtB,IAAI,CAAC,cAAc,EACnB,IAAI,mBAAmB,EAAE,CAC1B,CAAC;IAEF,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,KAAK,CAAC,UAAU,CAAC,MAAY,EAAE,QAA6B;QAC1D,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/F,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,aAAa;YAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEO,gBAAgB,CAAC,MAAc;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC;aACtC,KAAK,CAAC,QAAQ,CAAC;aACf,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACzC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEO,iBAAiB,CAAC,MAAc;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACnD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,aAAa,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/modules/transcription/WhisperChunkStitcher.d.ts

@@ -0,0 +1,51 @@
+/** One word-timestamped chunk as transformers.js reports it. */
+export interface WhisperChunk {
+    text: string;
+    timestamp: [number | null, number | null];
+}
+/**
+ * Reconciles the chunk streams from consecutive pipeline windows into
+ * one non-duplicated timeline.
+ *
+ * transformers.js runs Whisper's chunk-and-stitch long-form strategy:
+ * consecutive windows overlap by `2 * strideLengthSeconds`, and each
+ * window transcribes its full range independently. The library is
+ * supposed to discard the overlap zones at stitch time but its word-
+ * timestamps path leaks them through — both windows' takes on the
+ * same audio land in the final chunks. Under a degenerate loop or a
+ * token-ceiling cut, a window can also flood its overlap zone with
+ * garbage.
+ *
+ * This class re-splits the merged chunk stream back into per-window
+ * groups (detected via timestamp drops in generation order) and crops
+ * each to a single half of every overlap. The split point between two
+ * consecutive windows is the later of the overlap midpoint and the
+ * next window's own first chunk — so if the next window declared
+ * silence over part of its overlap, the previous window's take on
+ * that same audio is kept instead of dropped.
+ */
+export declare class WhisperChunkStitcher {
+    private readonly chunkLengthSeconds;
+    private readonly strideLengthSeconds;
+    constructor(chunkLengthSeconds: number, strideLengthSeconds: number);
+    stitch(chunks: WhisperChunk[], audioDurationSeconds: number): WhisperChunk[];
+    /**
+     * Splits the merged chunk stream into per-window groups. Windows emit
+     * in generation order and each window's own timestamps are monotonic,
+     * so a chunk whose anchor is earlier than the previous chunk's marks
+     * the start of the next window.
+     */
+    private splitByGenerationWindow;
+    /**
+     * The split points between consecutive window groups, in absolute
+     * seconds. `boundaries[i]` is the second at which trust hands over
+     * from window `i` to window `i + 1`.
+     */
+    private trustBoundariesBetween;
+    private leftBoundaryOf;
+    private rightBoundaryOf;
+    private cropGroup;
+    private anchorOf;
+    private firstAnchorOf;
+}
+//# sourceMappingURL=WhisperChunkStitcher.d.ts.map

package/dist/modules/transcription/WhisperChunkStitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperChunkStitcher.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperChunkStitcher.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBADnB,kBAAkB,EAAE,MAAM,EAC1B,mBAAmB,EAAE,MAAM;IAG9C,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,oBAAoB,EAAE,MAAM,GAAG,YAAY,EAAE;IAW5E;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/modules/transcription/WhisperChunkStitcher.js

@@ -0,0 +1,101 @@
+/**
+ * Reconciles the chunk streams from consecutive pipeline windows into
+ * one non-duplicated timeline.
+ *
+ * transformers.js runs Whisper's chunk-and-stitch long-form strategy:
+ * consecutive windows overlap by `2 * strideLengthSeconds`, and each
+ * window transcribes its full range independently. The library is
+ * supposed to discard the overlap zones at stitch time but its word-
+ * timestamps path leaks them through — both windows' takes on the
+ * same audio land in the final chunks. Under a degenerate loop or a
+ * token-ceiling cut, a window can also flood its overlap zone with
+ * garbage.
+ *
+ * This class re-splits the merged chunk stream back into per-window
+ * groups (detected via timestamp drops in generation order) and crops
+ * each to a single half of every overlap. The split point between two
+ * consecutive windows is the later of the overlap midpoint and the
+ * next window's own first chunk — so if the next window declared
+ * silence over part of its overlap, the previous window's take on
+ * that same audio is kept instead of dropped.
+ */
+export class WhisperChunkStitcher {
+    chunkLengthSeconds;
+    strideLengthSeconds;
+    constructor(chunkLengthSeconds, strideLengthSeconds) {
+        this.chunkLengthSeconds = chunkLengthSeconds;
+        this.strideLengthSeconds = strideLengthSeconds;
+    }
+    stitch(chunks, audioDurationSeconds) {
+        const groups = this.splitByGenerationWindow(chunks);
+        if (groups.length <= 1)
+            return chunks;
+        const boundaries = this.trustBoundariesBetween(groups);
+        return groups.flatMap((group, index) => this.cropGroup(group, this.leftBoundaryOf(index, boundaries), this.rightBoundaryOf(index, boundaries, groups.length, audioDurationSeconds)));
+    }
+    /**
+     * Splits the merged chunk stream into per-window groups. Windows emit
+     * in generation order and each window's own timestamps are monotonic,
+     * so a chunk whose anchor is earlier than the previous chunk's marks
+     * the start of the next window.
+     */
+    splitByGenerationWindow(chunks) {
+        const groups = [];
+        let current = [];
+        let previousAnchor = null;
+        for (const chunk of chunks) {
+            const anchor = this.anchorOf(chunk);
+            if (anchor !== null && previousAnchor !== null && anchor < previousAnchor) {
+                groups.push(current);
+                current = [];
+            }
+            current.push(chunk);
+            if (anchor !== null)
+                previousAnchor = anchor;
+        }
+        if (current.length > 0)
+            groups.push(current);
+        return groups;
+    }
+    /**
+     * The split points between consecutive window groups, in absolute
+     * seconds. `boundaries[i]` is the second at which trust hands over
+     * from window `i` to window `i + 1`.
+     */
+    trustBoundariesBetween(groups) {
+        const advance = this.chunkLengthSeconds - 2 * this.strideLengthSeconds;
+        const boundaries = [];
+        for (let index = 0; index < groups.length - 1; index++) {
+            const overlapMidpoint = index * advance + this.chunkLengthSeconds - this.strideLengthSeconds;
+            const nextGroupFirstAnchor = this.firstAnchorOf(groups[index + 1]);
+            boundaries.push(nextGroupFirstAnchor === null
+                ? overlapMidpoint
+                : Math.max(overlapMidpoint, nextGroupFirstAnchor));
+        }
+        return boundaries;
+    }
+    leftBoundaryOf(groupIndex, boundaries) {
+        return groupIndex === 0 ? 0 : boundaries[groupIndex - 1];
+    }
+    rightBoundaryOf(groupIndex, boundaries, groupCount, audioDurationSeconds) {
+        return groupIndex === groupCount - 1 ? audioDurationSeconds : boundaries[groupIndex];
+    }
+    cropGroup(group, leftSeconds, rightSeconds) {
+        return group.filter((chunk) => {
+            const anchor = this.anchorOf(chunk);
+            return anchor !== null && anchor >= leftSeconds && anchor < rightSeconds;
+        });
+    }
+    anchorOf(chunk) {
+        return chunk.timestamp[0] ?? chunk.timestamp[1];
+    }
+    firstAnchorOf(group) {
+        for (const chunk of group) {
+            const anchor = this.anchorOf(chunk);
+            if (anchor !== null)
+                return anchor;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=WhisperChunkStitcher.js.map

package/dist/modules/transcription/WhisperChunkStitcher.js.map

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

package/dist/modules/transcription/WhisperDeviceUnavailableError.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Raised when the device the transcriber was asked to run on is not
+ * usable — either the model does not ship the artefacts needed for
+ * that device, or the browser does not expose the runtime that device
+ * relies on. Fired before any model file is fetched.
+ *
+ * The `.name` string is set explicitly, and exposed as `ERROR_NAME` on
+ * the class, so consumers can recognise the failure across a Worker
+ * boundary (where structured cloning preserves the string fields but
+ * not the class identity) with a single source of truth.
+ */
+export declare class WhisperDeviceUnavailableError extends Error {
+    static readonly ERROR_NAME = "WhisperDeviceUnavailableError";
+    readonly name = "WhisperDeviceUnavailableError";
+}
+//# sourceMappingURL=WhisperDeviceUnavailableError.d.ts.map

package/dist/modules/transcription/WhisperDeviceUnavailableError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperDeviceUnavailableError.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperDeviceUnavailableError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,MAAM,CAAC,QAAQ,CAAC,UAAU,mCAAmC;IAC7D,QAAQ,CAAC,IAAI,mCAA4C;CAC1D"}

package/dist/modules/transcription/WhisperDeviceUnavailableError.js

@@ -0,0 +1,16 @@
+/**
+ * Raised when the device the transcriber was asked to run on is not
+ * usable — either the model does not ship the artefacts needed for
+ * that device, or the browser does not expose the runtime that device
+ * relies on. Fired before any model file is fetched.
+ *
+ * The `.name` string is set explicitly, and exposed as `ERROR_NAME` on
+ * the class, so consumers can recognise the failure across a Worker
+ * boundary (where structured cloning preserves the string fields but
+ * not the class identity) with a single source of truth.
+ */
+export class WhisperDeviceUnavailableError extends Error {
+    static ERROR_NAME = 'WhisperDeviceUnavailableError';
+    name = WhisperDeviceUnavailableError.ERROR_NAME;
+}
+//# sourceMappingURL=WhisperDeviceUnavailableError.js.map

package/dist/modules/transcription/WhisperDeviceUnavailableError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperDeviceUnavailableError.js","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperDeviceUnavailableError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACtD,MAAM,CAAU,UAAU,GAAG,+BAA+B,CAAC;IACpD,IAAI,GAAG,6BAA6B,CAAC,UAAU,CAAC"}

package/dist/modules/transcription/WhisperInferenceFailedError.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Raised when the Whisper pipeline was loaded successfully but the
+ * inference call itself rejected — the model ran out of memory, the
+ * WebGPU device was lost mid-decode, the input audio was too short,
+ * or any other runtime error surfaced while transcribing.
+ *
+ * The `.name` string is set explicitly, and exposed as `ERROR_NAME` on
+ * the class, so consumers can recognise the failure across a Worker
+ * boundary (where structured cloning preserves the string fields but
+ * not the class identity) with a single source of truth.
+ */
+export declare class WhisperInferenceFailedError extends Error {
+    static readonly ERROR_NAME = "WhisperInferenceFailedError";
+    readonly name = "WhisperInferenceFailedError";
+}
+//# sourceMappingURL=WhisperInferenceFailedError.d.ts.map

package/dist/modules/transcription/WhisperInferenceFailedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperInferenceFailedError.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperInferenceFailedError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,MAAM,CAAC,QAAQ,CAAC,UAAU,iCAAiC;IAC3D,QAAQ,CAAC,IAAI,iCAA0C;CACxD"}

package/dist/modules/transcription/WhisperInferenceFailedError.js

@@ -0,0 +1,16 @@
+/**
+ * Raised when the Whisper pipeline was loaded successfully but the
+ * inference call itself rejected — the model ran out of memory, the
+ * WebGPU device was lost mid-decode, the input audio was too short,
+ * or any other runtime error surfaced while transcribing.
+ *
+ * The `.name` string is set explicitly, and exposed as `ERROR_NAME` on
+ * the class, so consumers can recognise the failure across a Worker
+ * boundary (where structured cloning preserves the string fields but
+ * not the class identity) with a single source of truth.
+ */
+export class WhisperInferenceFailedError extends Error {
+    static ERROR_NAME = 'WhisperInferenceFailedError';
+    name = WhisperInferenceFailedError.ERROR_NAME;
+}
+//# sourceMappingURL=WhisperInferenceFailedError.js.map

package/dist/modules/transcription/WhisperInferenceFailedError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperInferenceFailedError.js","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperInferenceFailedError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACpD,MAAM,CAAU,UAAU,GAAG,6BAA6B,CAAC;IAClD,IAAI,GAAG,2BAA2B,CAAC,UAAU,CAAC"}