@tscaps/engine 0.1.1

package/dist/modules/video/mediabunny/audio/DiscardAudioTrackBridge.js

@@ -0,0 +1,14 @@
+/**
+ * No-op bridge used when the input has no audio or when its audio codec
+ * cannot be put into the chosen output container without a transcode
+ * step the host can't perform. The output ends up with no audio track.
+ */
+export class DiscardAudioTrackBridge {
+    async attachTo() {
+    }
+    async pumpUntil() {
+    }
+    async finish() {
+    }
+}
+//# sourceMappingURL=DiscardAudioTrackBridge.js.map

package/dist/modules/video/mediabunny/audio/DiscardAudioTrackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscardAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/DiscardAudioTrackBridge.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAElC,KAAK,CAAC,QAAQ;IACd,CAAC;IAED,KAAK,CAAC,SAAS;IACf,CAAC;IAED,KAAK,CAAC,MAAM;IACZ,CAAC;CACF"}

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.d.ts

@@ -0,0 +1,28 @@
+import { type AudioCodec, type InputAudioTrack, type Output } from 'mediabunny';
+import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+export interface PassthroughAudioTrackBridgeConfig {
+    inputTrack: InputAudioTrack;
+    codec: AudioCodec;
+}
+/**
+ * Copies the input's encoded audio packets straight into the output
+ * without decoding or re-encoding. The first packet carries the input's
+ * decoder config so downstream consumers can decode the rest.
+ *
+ * Requires that the chosen output container can hold the input audio
+ * codec; otherwise pick a different bridge or change the container.
+ */
+export declare class PassthroughAudioTrackBridge implements AudioTrackBridge {
+    private readonly config;
+    private readonly source;
+    private readonly sink;
+    private nextPacket;
+    private decoderConfig;
+    private firstPacketPending;
+    constructor(config: PassthroughAudioTrackBridgeConfig);
+    attachTo(output: Output): Promise<void>;
+    pumpUntil(videoTimestamp: number): Promise<void>;
+    finish(): Promise<void>;
+    private emit;
+}
+//# sourceMappingURL=PassthroughAudioTrackBridge.d.ts.map

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassthroughAudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,eAAe,EACpB,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,MAAM,WAAW,iCAAiC;IAChD,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,2BAA4B,YAAW,gBAAgB;IAQtD,OAAO,CAAC,QAAQ,CAAC,MAAM;IANnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,kBAAkB,CAAQ;gBAEL,MAAM,EAAE,iCAAiC;IAKhE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAOf,IAAI;CAWnB"}

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.js

@@ -0,0 +1,52 @@
+import { EncodedAudioPacketSource, EncodedPacketSink, } from 'mediabunny';
+/**
+ * Copies the input's encoded audio packets straight into the output
+ * without decoding or re-encoding. The first packet carries the input's
+ * decoder config so downstream consumers can decode the rest.
+ *
+ * Requires that the chosen output container can hold the input audio
+ * codec; otherwise pick a different bridge or change the container.
+ */
+export class PassthroughAudioTrackBridge {
+    config;
+    source;
+    sink;
+    nextPacket = null;
+    decoderConfig = null;
+    firstPacketPending = true;
+    constructor(config) {
+        this.config = config;
+        this.source = new EncodedAudioPacketSource(config.codec);
+        this.sink = new EncodedPacketSink(config.inputTrack);
+    }
+    async attachTo(output) {
+        output.addAudioTrack(this.source);
+        this.nextPacket = await this.sink.getFirstPacket();
+        this.decoderConfig = await this.config.inputTrack.getDecoderConfig();
+    }
+    async pumpUntil(videoTimestamp) {
+        while (this.nextPacket && this.nextPacket.timestamp <= videoTimestamp) {
+            await this.emit(this.nextPacket);
+            this.nextPacket = await this.sink.getNextPacket(this.nextPacket);
+        }
+    }
+    async finish() {
+        while (this.nextPacket) {
+            await this.emit(this.nextPacket);
+            this.nextPacket = await this.sink.getNextPacket(this.nextPacket);
+        }
+    }
+    async emit(packet) {
+        // Packets before t=0 (timestamp offsets from container metadata) are
+        // discarded — the output writer rejects negative timestamps.
+        if (packet.timestamp < 0)
+            return;
+        if (this.firstPacketPending && this.decoderConfig) {
+            await this.source.add(packet, { decoderConfig: this.decoderConfig });
+            this.firstPacketPending = false;
+            return;
+        }
+        await this.source.add(packet);
+    }
+}
+//# sourceMappingURL=PassthroughAudioTrackBridge.js.map

package/dist/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PassthroughAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/PassthroughAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAKlB,MAAM,YAAY,CAAC;AAQpB;;;;;;;GAOG;AACH,MAAM,OAAO,2BAA2B;IAQT;IANZ,MAAM,CAA2B;IACjC,IAAI,CAAoB;IACjC,UAAU,GAAyB,IAAI,CAAC;IACxC,aAAa,GAA8B,IAAI,CAAC;IAChD,kBAAkB,GAAG,IAAI,CAAC;IAElC,YAA6B,MAAyC;QAAzC,WAAM,GAAN,MAAM,CAAmC;QACpE,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACnD,IAAI,CAAC,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAqB;QACtC,qEAAqE;QACrE,6DAA6D;QAC7D,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC;YAAE,OAAO;QACjC,IAAI,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;YAChC,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.d.ts

@@ -0,0 +1,25 @@
+import { type AudioCodec, type InputAudioTrack, type Output } from 'mediabunny';
+import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+export interface TranscodeAudioTrackBridgeConfig {
+    inputTrack: InputAudioTrack;
+    /** Target codec to encode into. Must be supported by the output container. */
+    codec: AudioCodec;
+}
+/**
+ * Decodes the input audio track and re-encodes it into the requested
+ * target codec on the fly. Used when the input's codec cannot be copied
+ * into the chosen output container as-is.
+ */
+export declare class TranscodeAudioTrackBridge implements AudioTrackBridge {
+    private readonly source;
+    private readonly sink;
+    private iterator;
+    private nextSample;
+    constructor(config: TranscodeAudioTrackBridgeConfig);
+    attachTo(output: Output): Promise<void>;
+    pumpUntil(videoTimestamp: number): Promise<void>;
+    finish(): Promise<void>;
+    private emit;
+    private advance;
+}
+//# sourceMappingURL=TranscodeAudioTrackBridge.d.ts.map

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscodeAudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAEf,KAAK,eAAe,EACpB,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF,MAAM,WAAW,+BAA+B;IAC9C,UAAU,EAAE,eAAe,CAAC;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAEhE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,UAAU,CAA4B;gBAElC,MAAM,EAAE,+BAA+B;IAK7C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAOf,IAAI;YAYJ,OAAO;CAKtB"}

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.js

@@ -0,0 +1,52 @@
+import { AudioSampleSink, AudioSampleSource, QUALITY_HIGH, } from 'mediabunny';
+/**
+ * Decodes the input audio track and re-encodes it into the requested
+ * target codec on the fly. Used when the input's codec cannot be copied
+ * into the chosen output container as-is.
+ */
+export class TranscodeAudioTrackBridge {
+    source;
+    sink;
+    iterator = null;
+    nextSample = null;
+    constructor(config) {
+        this.source = new AudioSampleSource({ codec: config.codec, bitrate: QUALITY_HIGH });
+        this.sink = new AudioSampleSink(config.inputTrack);
+    }
+    async attachTo(output) {
+        output.addAudioTrack(this.source);
+        this.iterator = this.sink.samples()[Symbol.asyncIterator]();
+        this.nextSample = await this.advance();
+    }
+    async pumpUntil(videoTimestamp) {
+        while (this.nextSample && this.nextSample.timestamp <= videoTimestamp) {
+            await this.emit(this.nextSample);
+            this.nextSample = await this.advance();
+        }
+    }
+    async finish() {
+        while (this.nextSample) {
+            await this.emit(this.nextSample);
+            this.nextSample = await this.advance();
+        }
+    }
+    async emit(sample) {
+        try {
+            // Samples before t=0 (container offsets) are discarded because the
+            // muxer rejects negative timestamps.
+            if (sample.timestamp >= 0) {
+                await this.source.add(sample);
+            }
+        }
+        finally {
+            sample.close();
+        }
+    }
+    async advance() {
+        if (!this.iterator)
+            return null;
+        const { value, done } = await this.iterator.next();
+        return done || !value ? null : value;
+    }
+}
+//# sourceMappingURL=TranscodeAudioTrackBridge.js.map

package/dist/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscodeAudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/TranscodeAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAKb,MAAM,YAAY,CAAC;AASpB;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IAEnB,MAAM,CAAoB;IAC1B,IAAI,CAAkB;IAC/B,QAAQ,GAAsC,IAAI,CAAC;IACnD,UAAU,GAAuB,IAAI,CAAC;IAE9C,YAAY,MAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;YACtE,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAmB;QACpC,IAAI,CAAC;YACH,mEAAmE;YACnE,qCAAqC;YACrC,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;CACF"}

package/dist/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.d.ts

@@ -0,0 +1,32 @@
+import type { Document } from '../../../document/Document';
+import type { SubtitleFrame, SubtitleFrameRenderer, SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+import type { SubtitleLayerSource } from '../../../video/mediabunny/caption/SubtitleLayerSource';
+/**
+ * `SubtitleLayerSource` that renders ahead in chunks sized to the
+ * underlying renderer's preferred batch size, amortizing the fixed
+ * cost of a batch fetch across many video frames. The decoded video
+ * frame passed to `frameAt` is ignored.
+ *
+ * Picks the right strategy for sections whose stylesheets are
+ * independent of the underlying video pixels.
+ *
+ * Times handed to `frameAt` are expected to land on a caption tick
+ * (a multiple of the `captionInterval` supplied at `open`); the
+ * source rounds to absorb the FP roundtrip but does not snap from
+ * arbitrary timestamps.
+ */
+export declare class BatchedSubtitleLayerSource implements SubtitleLayerSource {
+    private readonly subtitleRenderer;
+    private captionInterval;
+    private batchSize;
+    private currentChunkFirstIdx;
+    private currentChunkFrames;
+    private opened;
+    constructor(subtitleRenderer: SubtitleFrameRenderer);
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, captionInterval: number): Promise<void>;
+    frameAt(time: number, _videoFrame: DecodedVideoFrame): Promise<SubtitleFrame | null>;
+    close(): void;
+    private loadNextChunk;
+}
+//# sourceMappingURL=BatchedSubtitleLayerSource.d.ts.map

package/dist/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchedSubtitleLayerSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAEjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IAQxD,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAN7C,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,kBAAkB,CAA2C;IACrE,OAAO,CAAC,MAAM,CAAS;gBAEM,gBAAgB,EAAE,qBAAqB;IAE9D,IAAI,CACR,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAWV,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAS1F,KAAK,IAAI,IAAI;YAMC,aAAa;CAU5B"}

package/dist/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.js

@@ -0,0 +1,60 @@
+/**
+ * `SubtitleLayerSource` that renders ahead in chunks sized to the
+ * underlying renderer's preferred batch size, amortizing the fixed
+ * cost of a batch fetch across many video frames. The decoded video
+ * frame passed to `frameAt` is ignored.
+ *
+ * Picks the right strategy for sections whose stylesheets are
+ * independent of the underlying video pixels.
+ *
+ * Times handed to `frameAt` are expected to land on a caption tick
+ * (a multiple of the `captionInterval` supplied at `open`); the
+ * source rounds to absorb the FP roundtrip but does not snap from
+ * arbitrary timestamps.
+ */
+export class BatchedSubtitleLayerSource {
+    subtitleRenderer;
+    captionInterval = 0;
+    batchSize = 0;
+    currentChunkFirstIdx = 0;
+    currentChunkFrames = [];
+    opened = false;
+    constructor(subtitleRenderer) {
+        this.subtitleRenderer = subtitleRenderer;
+    }
+    async open(doc, styles, width, height, captionInterval) {
+        await this.subtitleRenderer.open(doc, styles, width, height);
+        this.captionInterval = captionInterval;
+        this.batchSize = await this.subtitleRenderer.getMaxBatchSize();
+        // Sentinel: the first `frameAt` call's while-condition fires one
+        // `loadNextChunk` that lands the resident window at index 0.
+        this.currentChunkFirstIdx = -this.batchSize;
+        this.currentChunkFrames = [];
+        this.opened = true;
+    }
+    async frameAt(time, _videoFrame) {
+        if (!this.opened)
+            return null;
+        const captionIdx = Math.round(time / this.captionInterval);
+        while (captionIdx >= this.currentChunkFirstIdx + this.batchSize) {
+            await this.loadNextChunk();
+        }
+        return this.currentChunkFrames[captionIdx - this.currentChunkFirstIdx] ?? null;
+    }
+    close() {
+        this.subtitleRenderer.close();
+        this.currentChunkFrames = [];
+        this.opened = false;
+    }
+    async loadNextChunk() {
+        this.currentChunkFirstIdx += this.batchSize;
+        const timestamps = [];
+        for (let i = 0; i < this.batchSize; i++) {
+            // Each timestamp is freshly computed from its absolute index
+            // to avoid floating-point accumulation drift across long videos.
+            timestamps.push((this.currentChunkFirstIdx + i) * this.captionInterval);
+        }
+        this.currentChunkFrames = await this.subtitleRenderer.getFrames(timestamps);
+    }
+}
+//# sourceMappingURL=BatchedSubtitleLayerSource.js.map

package/dist/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchedSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/BatchedSubtitleLayerSource.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,0BAA0B;IAQR;IANrB,eAAe,GAAG,CAAC,CAAC;IACpB,SAAS,GAAG,CAAC,CAAC;IACd,oBAAoB,GAAG,CAAC,CAAC;IACzB,kBAAkB,GAAwC,EAAE,CAAC;IAC7D,MAAM,GAAG,KAAK,CAAC;IAEvB,YAA6B,gBAAuC;QAAvC,qBAAgB,GAAhB,gBAAgB,CAAuB;IAAG,CAAC;IAExE,KAAK,CAAC,IAAI,CACR,GAAa,EACb,MAA+C,EAC/C,KAAa,EACb,MAAc,EACd,eAAuB;QAEvB,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,eAAe,EAAE,CAAC;QAC/D,iEAAiE;QACjE,6DAA6D;QAC7D,IAAI,CAAC,oBAAoB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;QAC5C,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,WAA8B;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3D,OAAO,UAAU,IAAI,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChE,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,UAAU,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC;IACjF,CAAC;IAED,KAAK;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,SAAS,CAAC;QAC5C,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,6DAA6D;YAC7D,iEAAiE;YACjE,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.d.ts

@@ -0,0 +1,27 @@
+import type { Document } from '../../../document/Document';
+import type { SubtitleFrame, SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+import type { SubtitleLayerSource } from '../../../video/mediabunny/caption/SubtitleLayerSource';
+/**
+ * Composes two `SubtitleLayerSource`s, routing each Section to one
+ * of them by whether its style declares
+ * `rendering.videoFrame.required`. Snaps the time of each
+ * `frameAt` call to the nearest caption tick and merges the rasters
+ * produced by sub-sources with active sections into a single frame.
+ *
+ * `frameAt` expects monotonically advancing times.
+ */
+export declare class ComposedSubtitleLayerSource implements SubtitleLayerSource {
+    private readonly batchedSource;
+    private readonly videoBoundSource;
+    private captionInterval;
+    private captionIdx;
+    private readonly openedSources;
+    constructor(batchedSource: SubtitleLayerSource, videoBoundSource: SubtitleLayerSource);
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, captionInterval: number): Promise<void>;
+    frameAt(time: number, videoFrame: DecodedVideoFrame): Promise<SubtitleFrame | null>;
+    close(): void;
+    private partitionStyles;
+    private advanceCaptionIdxToTime;
+}
+//# sourceMappingURL=ComposedSubtitleLayerSource.d.ts.map

package/dist/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposedSubtitleLayerSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,0CAA0C,CAAC;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAajG;;;;;;;;GAQG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IAOnE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IANnC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAGxC,aAAa,EAAE,mBAAmB,EAClC,gBAAgB,EAAE,mBAAmB;IAGlD,IAAI,CACR,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAcV,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IASzF,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,uBAAuB;CAOhC"}

package/dist/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.js

@@ -0,0 +1,72 @@
+import { LayeredSubtitleFrame } from '../../../rendering/LayeredSubtitleFrame';
+// 1 µs tolerance: absorbs IEEE-754 rounding at exact interval
+// boundaries (a video frame whose timestamp matches a caption
+// midpoint to the last few ULPs) without affecting any real
+// sub-frame difference.
+const CAPTION_BOUNDARY_EPSILON_S = 1e-6;
+/**
+ * Composes two `SubtitleLayerSource`s, routing each Section to one
+ * of them by whether its style declares
+ * `rendering.videoFrame.required`. Snaps the time of each
+ * `frameAt` call to the nearest caption tick and merges the rasters
+ * produced by sub-sources with active sections into a single frame.
+ *
+ * `frameAt` expects monotonically advancing times.
+ */
+export class ComposedSubtitleLayerSource {
+    batchedSource;
+    videoBoundSource;
+    captionInterval = 0;
+    captionIdx = 0;
+    openedSources = [];
+    constructor(batchedSource, videoBoundSource) {
+        this.batchedSource = batchedSource;
+        this.videoBoundSource = videoBoundSource;
+    }
+    async open(doc, styles, width, height, captionInterval) {
+        this.captionInterval = captionInterval;
+        this.captionIdx = 0;
+        const { batched, videoBound } = this.partitionStyles(styles);
+        if (Object.keys(batched).length > 0) {
+            await this.batchedSource.open(doc, batched, width, height, captionInterval);
+            this.openedSources.push(this.batchedSource);
+        }
+        if (Object.keys(videoBound).length > 0) {
+            await this.videoBoundSource.open(doc, videoBound, width, height, captionInterval);
+            this.openedSources.push(this.videoBoundSource);
+        }
+    }
+    async frameAt(time, videoFrame) {
+        this.captionIdx = this.advanceCaptionIdxToTime(this.captionIdx, time);
+        const captionTime = this.captionIdx * this.captionInterval;
+        const layers = await Promise.all(this.openedSources.map((source) => source.frameAt(captionTime, videoFrame)));
+        return LayeredSubtitleFrame.from(...layers);
+    }
+    close() {
+        for (const source of this.openedSources)
+            source.close();
+        this.openedSources.length = 0;
+    }
+    partitionStyles(styles) {
+        const batched = {};
+        const videoBound = {};
+        for (const [kind, style] of Object.entries(styles)) {
+            if (style.rendering.videoFrame.required)
+                videoBound[kind] = style;
+            else
+                batched[kind] = style;
+        }
+        return { batched, videoBound };
+    }
+    // Caption N covers `[(N-0.5)·interval, (N+0.5)·interval)`. This
+    // halves the worst-case timing error vs. floor-only mapping at
+    // the cost of letting a caption appear up to `interval/2` early.
+    advanceCaptionIdxToTime(currentIdx, time) {
+        let idx = currentIdx;
+        while ((idx + 0.5) * this.captionInterval <= time + CAPTION_BOUNDARY_EPSILON_S) {
+            idx++;
+        }
+        return idx;
+    }
+}
+//# sourceMappingURL=ComposedSubtitleLayerSource.js.map

package/dist/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposedSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAI/E,8DAA8D;AAC9D,8DAA8D;AAC9D,4DAA4D;AAC5D,wBAAwB;AACxB,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAOxC;;;;;;;;GAQG;AACH,MAAM,OAAO,2BAA2B;IAOnB;IACA;IANX,eAAe,GAAG,CAAC,CAAC;IACpB,UAAU,GAAG,CAAC,CAAC;IACN,aAAa,GAA0B,EAAE,CAAC;IAE3D,YACmB,aAAkC,EAClC,gBAAqC;QADrC,kBAAa,GAAb,aAAa,CAAqB;QAClC,qBAAgB,GAAhB,gBAAgB,CAAqB;IACrD,CAAC;IAEJ,KAAK,CAAC,IAAI,CACR,GAAa,EACb,MAA+C,EAC/C,KAAa,EACb,MAAc,EACd,eAAuB;QAEvB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;YAC5E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;YAClF,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,UAA6B;QACvD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAC5E,CAAC;QACF,OAAO,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACxD,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAEO,eAAe,CAAC,MAA+C;QACrE,MAAM,OAAO,GAAkC,EAAE,CAAC;QAClD,MAAM,UAAU,GAAkC,EAAE,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;;gBAC7D,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC7B,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,gEAAgE;IAChE,+DAA+D;IAC/D,iEAAiE;IACzD,uBAAuB,CAAC,UAAkB,EAAE,IAAY;QAC9D,IAAI,GAAG,GAAG,UAAU,CAAC;QACrB,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,GAAG,0BAA0B,EAAE,CAAC;YAC/E,GAAG,EAAE,CAAC;QACR,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/modules/video/mediabunny/caption/SubtitleLayerSource.d.ts

@@ -0,0 +1,32 @@
+import type { Document } from '../../../document/Document';
+import type { SubtitleFrame, SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/**
+ * Produces one caption raster per video frame for a render.
+ *
+ * Lifecycle is per-render: {@link open} prepares the source for a
+ * specific document and style set, {@link frameAt} services each
+ * video frame of that render in monotonically advancing `time`
+ * order, and {@link close} releases the underlying resources.
+ * Open/close pairs may repeat against the same instance, but a
+ * source cannot serve two renders concurrently.
+ */
+export interface SubtitleLayerSource {
+    /**
+     * Prepares the source for a render at the given dimensions, scoped
+     * to `styles` keyed by `Section.kind`.
+     *
+     * @param captionInterval Seconds between successive caption ticks.
+     */
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, captionInterval: number): Promise<void>;
+    /**
+     * Resolves to the caption raster at `time`, or `null` when no
+     * Section served by this source is active.
+     *
+     * @param time Presentation timestamp of `videoFrame` in seconds.
+     * @param videoFrame Decoded video frame at `time`.
+     */
+    frameAt(time: number, videoFrame: DecodedVideoFrame): Promise<SubtitleFrame | null>;
+    close(): void;
+}
+//# sourceMappingURL=SubtitleLayerSource.d.ts.map

package/dist/modules/video/mediabunny/caption/SubtitleLayerSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleLayerSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/SubtitleLayerSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,IAAI,CACF,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEpF,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/modules/video/mediabunny/caption/SubtitleLayerSource.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SubtitleLayerSource.js.map

package/dist/modules/video/mediabunny/caption/SubtitleLayerSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/SubtitleLayerSource.ts"],"names":[],"mappings":""}

package/dist/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.d.ts

@@ -0,0 +1,25 @@
+import type { Document } from '../../../document/Document';
+import type { SubtitleFrame, SubtitleFrameRenderer, SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+import type { SubtitleLayerSource } from '../../../video/mediabunny/caption/SubtitleLayerSource';
+/**
+ * `SubtitleLayerSource` that publishes each decoded video frame into
+ * a single-slot `VideoFrameSource` and asks the underlying renderer
+ * for the matching caption tile, one render per call. The
+ * `captionInterval` argument is unused; the cadence is whatever the
+ * caller drives `frameAt` at.
+ *
+ * Picks the right strategy for sections whose stylesheets sample the
+ * underlying video pixels (background-image filters, blur sourced
+ * from the frame, etc.). The per-call render is expensive — use
+ * only for the style subset that genuinely needs the sampling.
+ */
+export declare class VideoBoundSubtitleLayerSource implements SubtitleLayerSource {
+    private readonly subtitleRenderer;
+    private videoFrameSource;
+    constructor(subtitleRenderer: SubtitleFrameRenderer);
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, _captionInterval: number): Promise<void>;
+    frameAt(time: number, videoFrame: DecodedVideoFrame): Promise<SubtitleFrame | null>;
+    close(): void;
+}
+//# sourceMappingURL=VideoBoundSubtitleLayerSource.d.ts.map

package/dist/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoBoundSubtitleLayerSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAE3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAEjG;;;;;;;;;;;GAWG;AACH,qBAAa,6BAA8B,YAAW,mBAAmB;IAI3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAF7C,OAAO,CAAC,gBAAgB,CAAwC;gBAEnC,gBAAgB,EAAE,qBAAqB;IAE9D,IAAI,CACR,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAKV,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAQzF,KAAK,IAAI,IAAI;CAId"}

package/dist/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.js

@@ -0,0 +1,37 @@
+import { CurrentFrameVideoSource } from '../../../video/mediabunny/frame/CurrentFrameVideoSource';
+/**
+ * `SubtitleLayerSource` that publishes each decoded video frame into
+ * a single-slot `VideoFrameSource` and asks the underlying renderer
+ * for the matching caption tile, one render per call. The
+ * `captionInterval` argument is unused; the cadence is whatever the
+ * caller drives `frameAt` at.
+ *
+ * Picks the right strategy for sections whose stylesheets sample the
+ * underlying video pixels (background-image filters, blur sourced
+ * from the frame, etc.). The per-call render is expensive — use
+ * only for the style subset that genuinely needs the sampling.
+ */
+export class VideoBoundSubtitleLayerSource {
+    subtitleRenderer;
+    videoFrameSource = null;
+    constructor(subtitleRenderer) {
+        this.subtitleRenderer = subtitleRenderer;
+    }
+    async open(doc, styles, width, height, _captionInterval) {
+        this.videoFrameSource = new CurrentFrameVideoSource(width, height);
+        await this.subtitleRenderer.open(doc, styles, width, height, this.videoFrameSource);
+    }
+    async frameAt(time, videoFrame) {
+        if (!this.videoFrameSource)
+            return null;
+        // Publish before fetching: the renderer's stylesheets pull the
+        // frame back through `videoFrameSource` while `getFrame` runs.
+        this.videoFrameSource.setCurrent(time, videoFrame);
+        return this.subtitleRenderer.getFrame(time);
+    }
+    close() {
+        this.subtitleRenderer.close();
+        this.videoFrameSource = null;
+    }
+}
+//# sourceMappingURL=VideoBoundSubtitleLayerSource.js.map

package/dist/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoBoundSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAGlG;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,6BAA6B;IAIX;IAFrB,gBAAgB,GAAmC,IAAI,CAAC;IAEhE,YAA6B,gBAAuC;QAAvC,qBAAgB,GAAhB,gBAAgB,CAAuB;IAAG,CAAC;IAExE,KAAK,CAAC,IAAI,CACR,GAAa,EACb,MAA+C,EAC/C,KAAa,EACb,MAAc,EACd,gBAAwB;QAExB,IAAI,CAAC,gBAAgB,GAAG,IAAI,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnE,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,UAA6B;QACvD,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QACxC,+DAA+D;QAC/D,+DAA+D;QAC/D,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;CACF"}

package/dist/modules/video/mediabunny/codec/CodecPolicy.d.ts

@@ -0,0 +1,32 @@
+import type { VideoCodec } from 'mediabunny';
+import type { RenderQuality } from '../../../video/RenderJob';
+export interface VideoCodecResolutionRequest {
+    /** Codecs the chosen output container can hold. */
+    supportedCodecs: VideoCodec[];
+    /** Display width of the input video, in pixels. */
+    width: number;
+    /** Display height of the input video, in pixels. */
+    height: number;
+    /** Average frame rate of the input video, in Hz. */
+    fps: number;
+    /** Subjective quality preset selected by the caller. */
+    quality: RenderQuality | undefined;
+}
+export interface VideoCodecResolution {
+    codec: VideoCodec;
+    /** Target bitrate in bits per second. */
+    bitrate: number;
+    bitrateMode: 'constant' | 'variable';
+    latencyMode: 'quality' | 'realtime';
+    /** Optional hint about the content being encoded, e.g. `'text'` for high-contrast overlays. */
+    contentHint?: string;
+}
+/**
+ * Resolves codec, bitrate and encoder knobs for a render.
+ *
+ * Throws if no codec in `supportedCodecs` can be encoded by the host.
+ */
+export interface CodecPolicy {
+    resolveVideo(request: VideoCodecResolutionRequest): Promise<VideoCodecResolution>;
+}
+//# sourceMappingURL=CodecPolicy.d.ts.map

package/dist/modules/video/mediabunny/codec/CodecPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodecPolicy.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/CodecPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,GAAG,UAAU,CAAC;IACrC,WAAW,EAAE,SAAS,GAAG,UAAU,CAAC;IACpC,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnF"}

package/dist/modules/video/mediabunny/codec/CodecPolicy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CodecPolicy.js.map

package/dist/modules/video/mediabunny/codec/CodecPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodecPolicy.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/codec/CodecPolicy.ts"],"names":[],"mappings":""}