@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/transcription/WhisperWindowCoverage.js

@@ -0,0 +1,129 @@
+/**
+ * Records what the decoder did in each pipeline window — how far its
+ * last real segment got, how many tokens it emitted, whether the loop
+ * guard cut it, whether it stopped mid-segment — and answers which
+ * audio regions were left uncovered.
+ *
+ * Segment boundaries are counted with window-local parity: within one
+ * window the decoder strictly alternates open / close starting at
+ * open, so odd-numbered events open a segment and even-numbered ones
+ * close it. The upstream streamer's own open/close labels are not
+ * trusted — its alternation state carries across windows, so one
+ * window that stops mid-segment mislabels every event that follows.
+ *
+ * Only segments whose close timestamp is strictly greater than their
+ * open timestamp count as "closed". A degenerate repetition loop can
+ * emit `<|t|>text<|t|>` pairs at a single timestamp forever — trusting
+ * those bogus closes leaves the whole loop tail looking legitimate
+ * and defeats every downstream cutoff.
+ */
+export class WhisperWindowCoverage {
+    windows = [];
+    currentLastClosedEnd = null;
+    currentTokenCount = 0;
+    currentTimestampEvents = 0;
+    currentOpenTimestamp = null;
+    /** Feeds one segment-boundary timestamp, relative to the current window. */
+    recordTimestamp(timeWithinWindow) {
+        this.currentTimestampEvents += 1;
+        if (this.isOpenEvent()) {
+            this.currentOpenTimestamp = timeWithinWindow;
+            return;
+        }
+        if (this.isRealClose(timeWithinWindow)) {
+            this.currentLastClosedEnd = Math.max(this.currentLastClosedEnd ?? 0, timeWithinWindow);
+        }
+        this.currentOpenTimestamp = null;
+    }
+    isOpenEvent() {
+        return this.currentTimestampEvents % 2 === 1;
+    }
+    isRealClose(closeTimestamp) {
+        return this.currentOpenTimestamp !== null && closeTimestamp > this.currentOpenTimestamp;
+    }
+    /** Counts one generated token towards the current window. */
+    recordToken() {
+        this.currentTokenCount += 1;
+    }
+    /** Marks the end of the current window's generation pass. */
+    windowEnded(abortedByLoopGuard) {
+        this.windows.push({
+            lastClosedEndSeconds: this.currentLastClosedEnd,
+            tokenCount: this.currentTokenCount,
+            abortedByLoopGuard,
+            endedWithOpenSegment: this.currentTimestampEvents % 2 === 1,
+        });
+        this.currentLastClosedEnd = null;
+        this.currentTokenCount = 0;
+        this.currentTimestampEvents = 0;
+        this.currentOpenTimestamp = null;
+    }
+    /** Number of generation passes observed so far. */
+    get windowsObserved() {
+        return this.windows.length;
+    }
+    /**
+     * The uncovered regions among non-final windows. A window whose
+     * trustworthy coverage ends before the pipeline's window advance
+     * leaves the audio from that point up to the next window's start
+     * transcribed by nobody.
+     *
+     * A window is degenerate when the loop guard cut it or its token
+     * count reached `tokenCeiling` — either way it did not end by its
+     * own end-of-sequence, and its gap is not rescuable.
+     */
+    uncoveredGaps(advanceSeconds, tokenCeiling) {
+        const gaps = [];
+        for (let window = 0; window < this.windows.length - 1; window++) {
+            const record = this.windows[window];
+            if (!record)
+                continue;
+            const degenerate = this.isDegenerate(record, tokenCeiling);
+            const gapStart = this.gapStartFor(record, degenerate);
+            if (gapStart === null || gapStart >= advanceSeconds)
+                continue;
+            gaps.push({
+                startSeconds: window * advanceSeconds + gapStart,
+                endSeconds: (window + 1) * advanceSeconds,
+                rescuable: !degenerate,
+            });
+        }
+        return gaps;
+    }
+    /**
+     * The uncovered tail of the final window, or `null` when there is
+     * nothing trustworthy to report. Reported only when that window's
+     * generation was cut from outside or stopped mid-segment. A clean
+     * close is trusted as the genuine end of speech: with no following
+     * window, an early-but-clean close cannot be told apart from a video
+     * that simply ends in silence. Never rescuable.
+     */
+    finalWindowGap(advanceSeconds, tokenCeiling, audioEndSeconds) {
+        const record = this.windows[this.windows.length - 1];
+        if (!record)
+            return null;
+        const degenerate = this.isDegenerate(record, tokenCeiling);
+        if (!degenerate && !record.endedWithOpenSegment)
+            return null;
+        const startSeconds = (this.windows.length - 1) * advanceSeconds + (record.lastClosedEndSeconds ?? 0);
+        if (startSeconds >= audioEndSeconds)
+            return null;
+        return { startSeconds, endSeconds: audioEndSeconds, rescuable: false };
+    }
+    isDegenerate(record, tokenCeiling) {
+        return record.abortedByLoopGuard || record.tokenCount >= tokenCeiling;
+    }
+    /**
+     * Where the window's trustworthy coverage ends. A clean window that
+     * closed no segment reports `null`: re-decoding its identical input
+     * is deterministic and would reproduce the same empty result. A
+     * degenerate window with no closed segment still gaps from zero —
+     * its region gets dropped, not re-decoded.
+     */
+    gapStartFor(record, degenerate) {
+        if (record.lastClosedEndSeconds !== null)
+            return record.lastClosedEndSeconds;
+        return degenerate ? 0 : null;
+    }
+}
+//# sourceMappingURL=WhisperWindowCoverage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WhisperWindowCoverage.js","sourceRoot":"","sources":["../../../src/modules/transcription/WhisperWindowCoverage.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,qBAAqB;IACf,OAAO,GAAmB,EAAE,CAAC;IACtC,oBAAoB,GAAkB,IAAI,CAAC;IAC3C,iBAAiB,GAAG,CAAC,CAAC;IACtB,sBAAsB,GAAG,CAAC,CAAC;IAC3B,oBAAoB,GAAkB,IAAI,CAAC;IAEnD,4EAA4E;IAC5E,eAAe,CAAC,gBAAwB;QACtC,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,oBAAoB,GAAG,gBAAgB,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACnC,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,sBAAsB,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEO,WAAW,CAAC,cAAsB;QACxC,OAAO,IAAI,CAAC,oBAAoB,KAAK,IAAI,IAAI,cAAc,GAAG,IAAI,CAAC,oBAAoB,CAAC;IAC1F,CAAC;IAED,6DAA6D;IAC7D,WAAW;QACT,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,6DAA6D;IAC7D,WAAW,CAAC,kBAA2B;QACrC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,UAAU,EAAE,IAAI,CAAC,iBAAiB;YAClC,kBAAkB;YAClB,oBAAoB,EAAE,IAAI,CAAC,sBAAsB,GAAG,CAAC,KAAK,CAAC;SAC5D,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IACnC,CAAC;IAED,mDAAmD;IACnD,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa,CAAC,cAAsB,EAAE,YAAoB;QACxD,MAAM,IAAI,GAAkB,EAAE,CAAC;QAC/B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;YAChE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACtD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,IAAI,cAAc;gBAAE,SAAS;YAC9D,IAAI,CAAC,IAAI,CAAC;gBACR,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,QAAQ;gBAChD,UAAU,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,cAAc;gBACzC,SAAS,EAAE,CAAC,UAAU;aACvB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,cAAsB,EAAE,YAAoB,EAAE,eAAuB;QAClF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,oBAAoB;YAAE,OAAO,IAAI,CAAC;QAC7D,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,cAAc,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC;QACrG,IAAI,YAAY,IAAI,eAAe;YAAE,OAAO,IAAI,CAAC;QACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzE,CAAC;IAEO,YAAY,CAAC,MAAoB,EAAE,YAAoB;QAC7D,OAAO,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,UAAU,IAAI,YAAY,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACK,WAAW,CAAC,MAAoB,EAAE,UAAmB;QAC3D,IAAI,MAAM,CAAC,oBAAoB,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,oBAAoB,CAAC;QAC7E,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+import { Word } from '../document/Word';
+/**
+ * Invents a window for each word of a span the source only timed as a
+ * whole, sharing the span out in proportion to how long each word is to
+ * write. A rough stand-in for measured timings, and the best a file
+ * that never recorded them can offer.
+ *
+ * A span of no length, or words that are all empty, leaves every word
+ * covering the whole span rather than dividing by zero.
+ */
+export declare class WordTimingEstimator {
+    spread(tokens: ReadonlyArray<string>, startSeconds: number, endSeconds: number): ReadonlyArray<Word>;
+}
+//# sourceMappingURL=WordTimingEstimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WordTimingEstimator.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/WordTimingEstimator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAE9B,MAAM,CACJ,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,aAAa,CAAC,IAAI,CAAC;CAmBvB"}

package/dist/modules/transcription/WordTimingEstimator.js

@@ -0,0 +1,33 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { Word } from '../document/Word';
+/**
+ * Invents a window for each word of a span the source only timed as a
+ * whole, sharing the span out in proportion to how long each word is to
+ * write. A rough stand-in for measured timings, and the best a file
+ * that never recorded them can offer.
+ *
+ * A span of no length, or words that are all empty, leaves every word
+ * covering the whole span rather than dividing by zero.
+ */
+export class WordTimingEstimator {
+    spread(tokens, startSeconds, endSeconds) {
+        const totalWeight = tokens.reduce((sum, token) => sum + token.length, 0);
+        const duration = endSeconds - startSeconds;
+        if (totalWeight === 0 || duration <= 0) {
+            return tokens.map((token) => new Word({
+                text: token,
+                time: new TimeFragment(startSeconds, endSeconds),
+            }));
+        }
+        const words = [];
+        let elapsedWeight = 0;
+        for (const token of tokens) {
+            const wordStart = startSeconds + (elapsedWeight / totalWeight) * duration;
+            elapsedWeight += token.length;
+            const wordEnd = startSeconds + (elapsedWeight / totalWeight) * duration;
+            words.push(new Word({ text: token, time: new TimeFragment(wordStart, wordEnd) }));
+        }
+        return words;
+    }
+}
+//# sourceMappingURL=WordTimingEstimator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WordTimingEstimator.js","sourceRoot":"","sources":["../../../src/modules/transcription/WordTimingEstimator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IAE9B,MAAM,CACJ,MAA6B,EAC7B,YAAoB,EACpB,UAAkB;QAElB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;QAC3C,IAAI,WAAW,KAAK,CAAC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;gBACpC,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,IAAI,YAAY,CAAC,YAAY,EAAE,UAAU,CAAC;aACjD,CAAC,CAAC,CAAC;QACN,CAAC;QACD,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,YAAY,GAAG,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC;YAC1E,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC;YAC9B,MAAM,OAAO,GAAG,YAAY,GAAG,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -1,8 +1,15 @@
-export type { Transcriber, TranscriberOptions, TranscriberProgressEvent, } from '../transcription/Transcriber';
+export type { Transcriber, TranscriberOptions, TranscriberProgressEvent, UntranscribedRegion, } from '../transcription/Transcriber';
 export type { AudioDecoder } from '../transcription/AudioDecoder';
 export { PreDecodedAudioDecoder } from '../transcription/PreDecodedAudioDecoder';
-export { BrowserAudioDecoder } from '../transcription/BrowserAudioDecoder';
+export { MediaBunnyAudioDecoder } from '../transcription/MediaBunnyAudioDecoder';
 export { PassthroughTranscriber } from '../transcription/PassthroughTranscriber';
 export { SrtTranscriber } from '../transcription/SrtTranscriber';
+export { VttTranscriber } from '../transcription/VttTranscriber';
+export { SubtitleFileUnreadableError } from '../transcription/SubtitleFileUnreadableError';
+export type { CueParseResult } from '../transcription/CueParseResult';
 export { WhisperTranscriber, WHISPER_SAMPLE_RATE, type WhisperModel, type WhisperDevice, type WhisperTranscriberConfig, } from '../transcription/WhisperTranscriber';
+export { WhisperDeviceUnavailableError } from '../transcription/WhisperDeviceUnavailableError';
+export type { ModelFileCache } from '../transcription/ModelFileCache';
+export { CacheStorageModelFileCache } from '../transcription/CacheStorageModelFileCache';
+export { ModelFileCacheUnavailableError } from '../transcription/ModelFileCacheUnavailableError';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,wBAAwB,GAC9B,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/transcription/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,wBAAwB,GAC9B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uDAAuD,CAAC"}

package/dist/modules/transcription/index.js

@@ -1,6 +1,11 @@
 export { PreDecodedAudioDecoder } from '../transcription/PreDecodedAudioDecoder';
-export { BrowserAudioDecoder } from '../transcription/BrowserAudioDecoder';
+export { MediaBunnyAudioDecoder } from '../transcription/MediaBunnyAudioDecoder';
 export { PassthroughTranscriber } from '../transcription/PassthroughTranscriber';
 export { SrtTranscriber } from '../transcription/SrtTranscriber';
+export { VttTranscriber } from '../transcription/VttTranscriber';
+export { SubtitleFileUnreadableError } from '../transcription/SubtitleFileUnreadableError';
 export { WhisperTranscriber, WHISPER_SAMPLE_RATE, } from '../transcription/WhisperTranscriber';
+export { WhisperDeviceUnavailableError } from '../transcription/WhisperDeviceUnavailableError';
+export { CacheStorageModelFileCache } from '../transcription/CacheStorageModelFileCache';
+export { ModelFileCacheUnavailableError } from '../transcription/ModelFileCacheUnavailableError';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/transcription/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/transcription/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAEjG,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAErG,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uDAAuD,CAAC"}

package/dist/modules/video/RenderJob.d.ts

@@ -1,5 +1,7 @@
 import type { Document } from '../document/Document';
 import type { SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+import type { TimeRange } from '../video/RenderTimeMap';
+import type { TopLayerSource } from '../video/mediabunny/painter/TopLayerSource';
 export type OutputFormat = 'mp4' | 'webm';
 export type RenderQuality = 'low' | 'medium' | 'high' | 'very-high';
 /**
@@ -44,6 +46,12 @@ export interface RenderJob {
      * SVG `foreignObject`. Self-contained: any styling must be inline.
      */
     overlayHtml?: string;
+    /**
+     * Optional per-frame layer painted on top of the captions. Used by
+     * effects that must occlude the caption raster (e.g. a person
+     * cutout). When unset, no top layer is drawn.
+     */
+    topLayer?: TopLayerSource;
     outputFormat?: OutputFormat;
     quality?: RenderQuality;
     /**
@@ -67,6 +75,15 @@ export interface RenderJob {
      * via `RenderResult.blob`.
      */
     outputStream?: WritableStream<RenderOutputChunk>;
+    /**
+     * Time windows (in seconds, source-time) to exclude from the
+     * output. Each excluded window collapses to a single point in the
+     * output timeline: video frames and audio inside the window are
+     * dropped, and everything after the window is shifted earlier by
+     * the window's duration. Ranges should be non-overlapping; the
+     * renderer sorts them internally.
+     */
+    skipRanges?: ReadonlyArray<TimeRange>;
     /**
      * Called when the input had an audio track but the renderer has to
      * drop it. Not invoked when the input has no audio at all.

package/dist/modules/video/RenderJob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderJob.d.ts","sourceRoot":"","sources":["../../../src/modules/video/RenderJob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAE9E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB;AAC5B,0EAA0E;AACxE,sBAAsB;AACxB,4EAA4E;GAC1E,2BAA2B,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAChD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"RenderJob.d.ts","sourceRoot":"","sources":["../../../src/modules/video/RenderJob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAEvF,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB;AAC5B,0EAA0E;AACxE,sBAAsB;AACxB,4EAA4E;GAC1E,2BAA2B,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAChD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACjD;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/modules/video/RenderTimeMap.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A half-open time window in seconds. The end is exclusive: a sample
+ * at `endSec` is considered outside the range.
+ */
+export interface TimeRange {
+    readonly startSec: number;
+    readonly endSec: number;
+}
+/**
+ * Maps source timestamps to output timestamps for a render that
+ * excludes one or more time windows. Source positions inside an
+ * excluded window collapse to the window's start in output time;
+ * positions past a window are shifted earlier by the cumulative
+ * skipped duration.
+ *
+ * Constructed once per render and queried per video frame and per
+ * audio packet/sample. Ranges are sorted internally and assumed
+ * non-overlapping (callers should merge touching/overlapping
+ * intervals before passing them in).
+ *
+ * An empty mapper is the identity: `isSkipped` is always false and
+ * `toOutputTime` returns the input unchanged.
+ */
+export declare class RenderTimeMap {
+    private readonly sortedRanges;
+    constructor(ranges: ReadonlyArray<TimeRange>);
+    isEmpty(): boolean;
+    isSkipped(sourceTimeSec: number): boolean;
+    /**
+     * Returns the skipped range that contains the given source-time
+     * position, or `null` when the position lies outside every range.
+     */
+    findContainingRange(sourceTimeSec: number): TimeRange | null;
+    /**
+     * Returns the first skipped range whose start lies strictly after
+     * the given source-time position, or `null` when no such range
+     * exists.
+     */
+    findFirstRangeStartingAfter(sourceTimeSec: number): TimeRange | null;
+    toOutputTime(sourceTimeSec: number): number;
+    /**
+     * Inverse of {@link toOutputTime}. An output position that lands
+     * exactly on a collapsed window — the multiple source positions
+     * mapping to the same output value — resolves to the window's
+     * right-hand source side so playback continues past the skip.
+     */
+    toSourceTime(outputTimeSec: number): number;
+    totalSkipDuration(): number;
+}
+//# sourceMappingURL=RenderTimeMap.d.ts.map

package/dist/modules/video/RenderTimeMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTimeMap.d.ts","sourceRoot":"","sources":["../../../src/modules/video/RenderTimeMap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;gBAE5C,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC;IAI5C,OAAO,IAAI,OAAO;IAIlB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAQzC;;;OAGG;IACH,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQ5D;;;;OAIG;IACH,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOpE,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAU3C;;;;;OAKG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAS3C,iBAAiB,IAAI,MAAM;CAK5B"}

package/dist/modules/video/RenderTimeMap.js

@@ -0,0 +1,90 @@
+/**
+ * Maps source timestamps to output timestamps for a render that
+ * excludes one or more time windows. Source positions inside an
+ * excluded window collapse to the window's start in output time;
+ * positions past a window are shifted earlier by the cumulative
+ * skipped duration.
+ *
+ * Constructed once per render and queried per video frame and per
+ * audio packet/sample. Ranges are sorted internally and assumed
+ * non-overlapping (callers should merge touching/overlapping
+ * intervals before passing them in).
+ *
+ * An empty mapper is the identity: `isSkipped` is always false and
+ * `toOutputTime` returns the input unchanged.
+ */
+export class RenderTimeMap {
+    sortedRanges;
+    constructor(ranges) {
+        this.sortedRanges = [...ranges].sort((a, b) => a.startSec - b.startSec);
+    }
+    isEmpty() {
+        return this.sortedRanges.length === 0;
+    }
+    isSkipped(sourceTimeSec) {
+        for (const range of this.sortedRanges) {
+            if (sourceTimeSec < range.startSec)
+                return false;
+            if (sourceTimeSec < range.endSec)
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Returns the skipped range that contains the given source-time
+     * position, or `null` when the position lies outside every range.
+     */
+    findContainingRange(sourceTimeSec) {
+        for (const range of this.sortedRanges) {
+            if (sourceTimeSec < range.startSec)
+                return null;
+            if (sourceTimeSec < range.endSec)
+                return range;
+        }
+        return null;
+    }
+    /**
+     * Returns the first skipped range whose start lies strictly after
+     * the given source-time position, or `null` when no such range
+     * exists.
+     */
+    findFirstRangeStartingAfter(sourceTimeSec) {
+        for (const range of this.sortedRanges) {
+            if (range.startSec > sourceTimeSec)
+                return range;
+        }
+        return null;
+    }
+    toOutputTime(sourceTimeSec) {
+        let skipped = 0;
+        for (const range of this.sortedRanges) {
+            if (sourceTimeSec < range.startSec)
+                break;
+            const end = Math.min(sourceTimeSec, range.endSec);
+            skipped += end - range.startSec;
+        }
+        return sourceTimeSec - skipped;
+    }
+    /**
+     * Inverse of {@link toOutputTime}. An output position that lands
+     * exactly on a collapsed window — the multiple source positions
+     * mapping to the same output value — resolves to the window's
+     * right-hand source side so playback continues past the skip.
+     */
+    toSourceTime(outputTimeSec) {
+        let sourceTime = outputTimeSec;
+        for (const range of this.sortedRanges) {
+            if (sourceTime < range.startSec)
+                break;
+            sourceTime += range.endSec - range.startSec;
+        }
+        return sourceTime;
+    }
+    totalSkipDuration() {
+        let total = 0;
+        for (const range of this.sortedRanges)
+            total += range.endSec - range.startSec;
+        return total;
+    }
+}
+//# sourceMappingURL=RenderTimeMap.js.map

package/dist/modules/video/RenderTimeMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTimeMap.js","sourceRoot":"","sources":["../../../src/modules/video/RenderTimeMap.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,aAAa;IAEP,YAAY,CAA2B;IAExD,YAAY,MAAgC;QAC1C,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,CAAC,aAAqB;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,aAAa,GAAG,KAAK,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACjD,IAAI,aAAa,GAAG,KAAK,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,aAAqB;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,aAAa,GAAG,KAAK,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAChD,IAAI,aAAa,GAAG,KAAK,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,2BAA2B,CAAC,aAAqB;QAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,GAAG,aAAa;gBAAE,OAAO,KAAK,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,aAAqB;QAChC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,aAAa,GAAG,KAAK,CAAC,QAAQ;gBAAE,MAAM;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAClD,OAAO,IAAI,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClC,CAAC;QACD,OAAO,aAAa,GAAG,OAAO,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,aAAqB;QAChC,IAAI,UAAU,GAAG,aAAa,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,IAAI,UAAU,GAAG,KAAK,CAAC,QAAQ;gBAAE,MAAM;YACvC,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC9C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iBAAiB;QACf,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY;YAAE,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/modules/video/index.d.ts

@@ -2,6 +2,12 @@ export type { VideoRenderer } from '../video/VideoRenderer';
 export type { RenderJob, RenderResult, RenderProgress, RenderOutputChunk, OutputFormat, RenderQuality, AudioDiscardReason, FallbackDecoderInfo, } from '../video/RenderJob';
 export { MediaBunnyVideoRenderer } from '../video/mediabunny/MediaBunnyVideoRenderer';
 export type { MediaBunnyVideoRendererConfig } from '../video/mediabunny/MediaBunnyVideoRenderer';
+export { MediaBunnyTranscodeCoordinator } from '../video/mediabunny/MediaBunnyTranscodeCoordinator';
+export type { MediaBunnyTranscodeCoordinatorConfig, MediaBunnyTranscodeRequest, MediaBunnyTranscodeResult, } from '../video/mediabunny/MediaBunnyTranscodeCoordinator';
+export type { FramePainter } from '../video/mediabunny/painter/FramePainter';
+export { CaptionsOverlayFramePainter } from '../video/mediabunny/painter/CaptionsOverlayFramePainter';
+export { CaptionsOverlayFramePainterFactory } from '../video/mediabunny/painter/CaptionsOverlayFramePainterFactory';
+export { RenderTimeMap } from '../video/RenderTimeMap';
 export type { CodecPolicy, VideoCodecResolution, VideoCodecResolutionRequest, } from '../video/mediabunny/codec/CodecPolicy';
 export { DefaultCodecPolicy } from '../video/mediabunny/codec/DefaultCodecPolicy';
 export type { VideoFrameDecoder, DecodedVideoFrame, } from '../video/mediabunny/frame/VideoFrameDecoder';
@@ -9,7 +15,7 @@ export type { VideoFrameDecoderFactory, VideoFrameDecoderRequest, } from '../vid
 export { DefaultVideoFrameDecoderFactory } from '../video/mediabunny/frame/DefaultVideoFrameDecoderFactory';
 export { WebCodecsVideoFrameDecoder } from '../video/mediabunny/frame/WebCodecsVideoFrameDecoder';
 export { HtmlVideoElementVideoFrameDecoder } from '../video/mediabunny/frame/HtmlVideoElementVideoFrameDecoder';
-export type { VideoTrackEncoder } from '../video/mediabunny/encoder/VideoTrackEncoder';
+export type { VideoTrackEncoder, PaintFrame } from '../video/mediabunny/encoder/VideoTrackEncoder';
 export type { VideoTrackEncoderFactory, VideoTrackEncoderFactoryRequest, } from '../video/mediabunny/encoder/VideoTrackEncoderFactory';
 export { MediaBunnyCanvasVideoTrackEncoder, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
 export type { MediaBunnyCanvasVideoTrackEncoderConfig, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
@@ -20,6 +26,7 @@ export type { SubtitleLayerSource } from '../video/mediabunny/caption/SubtitleLa
 export { BatchedSubtitleLayerSource } from '../video/mediabunny/caption/BatchedSubtitleLayerSource';
 export { VideoBoundSubtitleLayerSource } from '../video/mediabunny/caption/VideoBoundSubtitleLayerSource';
 export { ComposedSubtitleLayerSource } from '../video/mediabunny/caption/ComposedSubtitleLayerSource';
+export type { TopLayerSource } from '../video/mediabunny/painter/TopLayerSource';
 export type { AudioTrackBridge } from '../video/mediabunny/audio/AudioTrackBridge';
 export type { AudioTrackBridgeFactory, AudioTrackBridgeRequest, } from '../video/mediabunny/audio/AudioTrackBridgeFactory';
 export { DefaultAudioTrackBridgeFactory } from '../video/mediabunny/audio/DefaultAudioTrackBridgeFactory';

package/dist/modules/video/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,YAAY,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAEvG,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAEtH,YAAY,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EACV,uCAAuC,GACxC,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAEpF,YAAY,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG,YAAY,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,YAAY,EACV,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAC1G,YAAY,EACV,iCAAiC,GAClC,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,YAAY,EACV,+BAA+B,GAChC,MAAM,2DAA2D,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,YAAY,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAEvG,OAAO,EAAE,8BAA8B,EAAE,MAAM,0DAA0D,CAAC;AAC1G,YAAY,EACV,oCAAoC,EACpC,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,0DAA0D,CAAC;AAElE,YAAY,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAC5G,OAAO,EAAE,kCAAkC,EAAE,MAAM,sEAAsE,CAAC;AAE1H,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAEtH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qDAAqD,CAAC;AACzG,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EACV,uCAAuC,GACxC,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAEpF,YAAY,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG,YAAY,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAC5G,YAAY,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAEvF,YAAY,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,YAAY,EACV,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAC1G,YAAY,EACV,iCAAiC,GAClC,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,YAAY,EACV,+BAA+B,GAChC,MAAM,2DAA2D,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/modules/video/index.js

@@ -1,4 +1,8 @@
 export { MediaBunnyVideoRenderer } from '../video/mediabunny/MediaBunnyVideoRenderer';
+export { MediaBunnyTranscodeCoordinator } from '../video/mediabunny/MediaBunnyTranscodeCoordinator';
+export { CaptionsOverlayFramePainter } from '../video/mediabunny/painter/CaptionsOverlayFramePainter';
+export { CaptionsOverlayFramePainterFactory } from '../video/mediabunny/painter/CaptionsOverlayFramePainterFactory';
+export { RenderTimeMap } from '../video/RenderTimeMap';
 export { DefaultCodecPolicy } from '../video/mediabunny/codec/DefaultCodecPolicy';
 export { DefaultVideoFrameDecoderFactory } from '../video/mediabunny/frame/DefaultVideoFrameDecoderFactory';
 export { WebCodecsVideoFrameDecoder } from '../video/mediabunny/frame/WebCodecsVideoFrameDecoder';

package/dist/modules/video/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAQ5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAUxF,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAOtH,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAI7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAGpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAO5G,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAI1G,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAOlG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAG5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,0DAA0D,CAAC;AAQ1G,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAC5G,OAAO,EAAE,kCAAkC,EAAE,MAAM,sEAAsE,CAAC;AAE1H,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAO7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAUxF,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAOtH,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAI7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAGpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAQ5G,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAI1G,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAOlG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/modules/video/mediabunny/MediaBunnyTranscodeCoordinator.d.ts

@@ -0,0 +1,102 @@
+import { RenderTimeMap } from '../../video/RenderTimeMap';
+import type { OutputFormat, RenderOutputChunk, RenderProgress, RenderQuality, AudioDiscardReason, FallbackDecoderInfo } from '../../video/RenderJob';
+import type { CodecPolicy } from '../../video/mediabunny/codec/CodecPolicy';
+import type { VideoFrameDecoderFactory } from '../../video/mediabunny/frame/VideoFrameDecoderFactory';
+import type { AudioTrackBridgeFactory } from '../../video/mediabunny/audio/AudioTrackBridgeFactory';
+import type { OutputTargetBuilder } from '../../video/mediabunny/output/OutputTargetBuilder';
+import type { VideoTrackEncoderFactory } from '../../video/mediabunny/encoder/VideoTrackEncoderFactory';
+import type { FramePainter } from '../../video/mediabunny/painter/FramePainter';
+export interface MediaBunnyTranscodeCoordinatorConfig {
+    videoFrameDecoderFactory: VideoFrameDecoderFactory;
+    videoTrackEncoderFactory: VideoTrackEncoderFactory;
+    audioTrackBridgeFactory: AudioTrackBridgeFactory;
+    outputTargetBuilder: OutputTargetBuilder;
+}
+export interface MediaBunnyTranscodeRequest {
+    source: File;
+    /**
+     * Resolves the codec, bitrate, and encoder knobs for this run. Per-request
+     * so consumers can supply a fixed policy (e.g. a proxy generator that
+     * always wants low-bitrate AVC) without swapping the coordinator instance.
+     */
+    codecPolicy: CodecPolicy;
+    /**
+     * Owns the per-frame pixel work. See {@link FramePainter} for the
+     * lifecycle contract.
+     */
+    painter: FramePainter;
+    /**
+     * Target output dimensions. When omitted, the coordinator keeps the
+     * input track's intrinsic display dimensions. When set, the source
+     * frames are painted at these dimensions; the coordinator never
+     * upscales beyond the source and snaps both axes to even numbers,
+     * which most hardware video encoders require. Callers are
+     * responsible for keeping the aspect ratio consistent — the
+     * coordinator does not letterbox or crop.
+     */
+    outputResolution?: {
+        width: number;
+        height: number;
+    };
+    outputFormat?: OutputFormat;
+    quality?: RenderQuality;
+    /**
+     * Sink for the encoded bytes. When set, the coordinator writes chunks
+     * to it as the encoder produces them and the result's `blob` is
+     * `null`. When unset, the encoded file accumulates in memory and is
+     * returned via the result's `blob`.
+     */
+    outputStream?: WritableStream<RenderOutputChunk>;
+    /**
+     * Time windows to exclude from the output. Frames and audio inside
+     * each window are dropped, and everything after is shifted earlier by
+     * the window's duration. Defaults to an empty map (nothing skipped).
+     */
+    timeMap?: RenderTimeMap;
+    onProgress?: (progress: RenderProgress) => void;
+    onAudioDiscarded?: (reason: AudioDiscardReason) => void;
+    confirmFallbackDecoder?: (info: FallbackDecoderInfo) => Promise<boolean>;
+}
+export interface MediaBunnyTranscodeResult {
+    /** Encoded file in memory, or `null` when the request supplied `outputStream`. */
+    blob: Blob | null;
+    mimeType: string;
+    /** Final output width, after clamping to the source and snapping to even. */
+    width: number;
+    /** Final output height, after clamping to the source and snapping to even. */
+    height: number;
+}
+/**
+ * Runs one mediabunny transcode: opens the source input, resolves the
+ * output dimensions / frame rate / duration, wires the encoder and the
+ * audio bridge, and drives the decode → paint → encode loop.
+ *
+ * Consumer-specific per-frame composition (captions, overlay, raw-frame
+ * passthrough) lives behind the request's {@link FramePainter}; codec
+ * choice, container format, time-range skipping, and audio-loss and
+ * fallback-decoder notifications are per-request inputs. The coordinator
+ * itself knows nothing about documents, styles, or overlays — those
+ * live inside the painter.
+ *
+ * One run at a time per instance; concurrent {@link execute} calls on
+ * the same instance are not supported.
+ */
+export declare class MediaBunnyTranscodeCoordinator {
+    private readonly videoFrameDecoderFactory;
+    private readonly videoTrackEncoderFactory;
+    private readonly audioTrackBridgeFactory;
+    private readonly outputTargetBuilder;
+    constructor(config: MediaBunnyTranscodeCoordinatorConfig);
+    execute(request: MediaBunnyTranscodeRequest): Promise<MediaBunnyTranscodeResult>;
+    private runEncodeLoop;
+    private toEncoderConfig;
+    private computeDuration;
+    private resolveOutputDimensions;
+    private toEven;
+    private readFrameRate;
+    private toProgress;
+    private safeCancel;
+    private assertWebCodecsAvailable;
+    private buildResult;
+}
+//# sourceMappingURL=MediaBunnyTranscodeCoordinator.d.ts.map

package/dist/modules/video/mediabunny/MediaBunnyTranscodeCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyTranscodeCoordinator.d.ts","sourceRoot":"","sources":["../../../../src/modules/video/mediabunny/MediaBunnyTranscodeCoordinator.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,6CAA6C,CAAC;AACrG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AAEzG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAEvG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAEhG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAC;AAC3G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAEnF,MAAM,WAAW,oCAAoC;IACnD,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,IAAI,CAAC;IACb;;;;OAIG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;;OAGG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,8BAA8B;IAEzC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;gBAE9C,MAAM,EAAE,oCAAoC;IAOlD,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC;YAmFxE,aAAa;IA+B3B,OAAO,CAAC,eAAe;YAYT,eAAe;IAQ7B,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,MAAM;YAKA,aAAa;IAe3B,OAAO,CAAC,UAAU;YAKJ,UAAU;IASxB,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,WAAW;CAepB"}