@tscaps/engine 0.3.0 → 0.4.0

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

@@ -5,20 +5,33 @@ import { LayeredSubtitleFrame } from '../../../rendering/LayeredSubtitleFrame';
 // 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.
+ * Composes two `SubtitleLayerSource`s, routing each Section to one of
+ * them by whether its style declares `rendering.videoFrame.required`,
+ * and merging what they paint into one raster per request.
  *
- * `frameAt` expects monotonically advancing times.
+ * The two halves are handed **different times for the same request**,
+ * and that difference is the reason this class exists:
+ *
+ * - the batched half is given the request snapped to a caption tick,
+ *   which is what lets the frames that resolve to one picture share a
+ *   tile;
+ * - the video-bound half is given the frame's own time, because it
+ *   bakes the pixels under the caption into its picture, and those
+ *   differ at every frame the decoder hands over.
+ *
+ * Snapping both would tie a whole run of frames to one backdrop
+ * wherever the video runs faster than the tick rate, leaving the
+ * caption sitting on pixels the video has already moved past.
+ *
+ * `framesFor` expects monotonically advancing times.
  */
 export class ComposedSubtitleLayerSource {
     batchedSource;
     videoBoundSource;
     captionInterval = 0;
     captionIdx = 0;
-    openedSources = [];
+    openedBatched = null;
+    openedVideoBound = null;
     constructor(batchedSource, videoBoundSource) {
         this.batchedSource = batchedSource;
         this.videoBoundSource = videoBoundSource;
@@ -29,23 +42,41 @@ export class ComposedSubtitleLayerSource {
         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);
+            this.openedBatched = this.batchedSource;
         }
         if (Object.keys(videoBound).length > 0) {
             await this.videoBoundSource.open(doc, videoBound, width, height, captionInterval);
-            this.openedSources.push(this.videoBoundSource);
+            this.openedVideoBound = 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);
+    /**
+     * The largest either open half asks for, so a run gathered for this
+     * composite is long enough to serve the hungriest of them. The other
+     * is handed the same run and is free to ignore its length.
+     */
+    lookAhead() {
+        return Math.max(1, this.openedBatched?.lookAhead() ?? 1, this.openedVideoBound?.lookAhead() ?? 1);
+    }
+    async framesFor(requests) {
+        // Walked here and nowhere else: the tick index carries across
+        // calls, so a request snapped twice would advance it twice.
+        const onTicks = requests.map((request) => this.snapToCaptionTick(request));
+        const [batchedLayers, videoBoundLayers] = await Promise.all([
+            this.openedBatched?.framesFor(onTicks) ?? [],
+            this.openedVideoBound?.framesFor(requests) ?? [],
+        ]);
+        // Batched first: the video-bound layer paints over it.
+        return requests.map((_, i) => LayeredSubtitleFrame.from(batchedLayers[i] ?? null, videoBoundLayers[i] ?? null));
+    }
+    snapToCaptionTick(request) {
+        this.captionIdx = this.advanceCaptionIdxToTime(this.captionIdx, request.time);
+        return { time: this.captionIdx * this.captionInterval, videoFrame: request.videoFrame };
     }
     close() {
-        for (const source of this.openedSources)
-            source.close();
-        this.openedSources.length = 0;
+        this.openedBatched?.close();
+        this.openedVideoBound?.close();
+        this.openedBatched = null;
+        this.openedVideoBound = null;
     }
     partitionStyles(styles) {
         const batched = {};

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

@@ -1 +1 @@
-{"version":3,"file":"ComposedSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ComposedSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/ComposedSubtitleLayerSource.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAM/E,8DAA8D;AAC9D,8DAA8D;AAC9D,4DAA4D;AAC5D,wBAAwB;AACxB,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,2BAA2B;IAQnB;IACA;IAPX,eAAe,GAAG,CAAC,CAAC;IACpB,UAAU,GAAG,CAAC,CAAC;IACf,aAAa,GAA+B,IAAI,CAAC;IACjD,gBAAgB,GAA+B,IAAI,CAAC;IAE5D,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,GAAG,IAAI,CAAC,aAAa,CAAC;QAC1C,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,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,EACpC,IAAI,CAAC,gBAAgB,EAAE,SAAS,EAAE,IAAI,CAAC,CACxC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAA6C;QAC3D,8DAA8D;QAC9D,4DAA4D;QAC5D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1D,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE;YAC5C,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE;SACjD,CAAC,CAAC;QACH,uDAAuD;QACvD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC3B,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CACjF,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,OAA6B;QACrD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;IAC1F,CAAC;IAED,KAAK;QACH,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,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

@@ -1,15 +1,21 @@
 import type { Document } from '../../../document/Document';
 import type { SubtitleFrame, SubtitleStyle } from '../../../rendering/SubtitleFrameRenderer';
 import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/** One output frame's caption: the time it lands on and the video frame under it. */
+export interface SubtitleLayerRequest {
+    /** Presentation timestamp of `videoFrame` in seconds. */
+    readonly time: number;
+    readonly videoFrame: DecodedVideoFrame;
+}
 /**
- * Produces one caption raster per video frame for a render.
+ * Produces caption rasters for a render, a run of frames at a time.
  *
  * 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.
+ * specific document and style set, {@link framesFor} services runs of
+ * frames 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 {
     /**
@@ -20,13 +26,24 @@ export interface SubtitleLayerSource {
      */
     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.
+     * How many consecutive requests the source wants in one call to work
+     * at its best. `1` means it can answer frame by frame; a larger
+     * number means it amortizes work across a run and the caller should
+     * gather that many before asking. It is a preference, not a
+     * requirement: a call with fewer is always valid, and the last run of
+     * a render is short by nature.
+     *
+     * Meaningful only after {@link open}.
+     */
+    lookAhead(): number;
+    /**
+     * Resolves to one raster per request, in the order given, with
+     * `null` wherever no Section served by this source is active.
      *
-     * @param time Presentation timestamp of `videoFrame` in seconds.
-     * @param videoFrame Decoded video frame at `time`.
+     * The rasters are owned by the source and stay valid only until the
+     * next {@link framesFor} call or until {@link close}.
      */
-    frameAt(time: number, videoFrame: DecodedVideoFrame): Promise<SubtitleFrame | null>;
+    framesFor(requests: ReadonlyArray<SubtitleLayerRequest>): Promise<Array<SubtitleFrame | null>>;
     close(): void;
 }
 //# sourceMappingURL=SubtitleLayerSource.d.ts.map

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

@@ -1 +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"}
+{"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,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAED;;;;;;;;;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;;;;;;;;;OASG;IACH,SAAS,IAAI,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IAE/F,KAAK,IAAI,IAAI,CAAC;CACf"}

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

@@ -1,25 +1,46 @@
 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';
+import type { SubtitleLayerRequest, 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.
+ * `SubtitleLayerSource` for sections whose stylesheets sample the
+ * underlying video pixels — a backdrop blur, a frame-fed filter, text
+ * behind the actor.
  *
- * 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.
+ * Such a caption cannot be rendered ahead of the video the way a
+ * document-driven one can: its picture is only knowable once the frame
+ * beneath it exists. So the source batches the other way round, over
+ * frames the caller has already gathered: it publishes the whole run
+ * into a `BufferedVideoFrameSource` and asks the renderer for all of
+ * their tiles in one go, so a run of frames costs one rasterization
+ * instead of one each.
+ *
+ * The caller decides how large a run to gather, and {@link lookAhead}
+ * tells it what this source can use — which is however many tiles the
+ * renderer's sheet holds, since a run longer than that would spill into
+ * a second rasterization and buy nothing.
  */
 export declare class VideoBoundSubtitleLayerSource implements SubtitleLayerSource {
     private readonly subtitleRenderer;
     private videoFrameSource;
+    private maxTilesPerBatch;
     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>;
+    /**
+     * However many tiles the sheet holds, since a run longer than that
+     * would spill into a second rasterization and buy nothing.
+     *
+     * It is an exact fit rather than an estimate: every timestamp served
+     * here takes a tile of its own — the planner forces that for a style
+     * that reads the frame — so a run of N costs exactly N tiles and one
+     * of `maxTilesPerBatch` fills the sheet without ever overflowing it.
+     *
+     * The frames the run holds are a second buffer beside the sheet, but
+     * not one this number should be shrunk for: what caps the sheet is
+     * partly the raster length a host will decode without blanking its
+     * far edge, and a run of separate canvases has no such edge.
+     */
+    lookAhead(): number;
+    framesFor(requests: ReadonlyArray<SubtitleLayerRequest>): Promise<Array<SubtitleFrame | null>>;
     close(): void;
 }
 //# sourceMappingURL=VideoBoundSubtitleLayerSource.d.ts.map

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

@@ -1 +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"}
+{"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;AAElD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uDAAuD,CAAC;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,6BAA8B,YAAW,mBAAmB;IAK3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAH7C,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,gBAAgB,CAAK;gBAEA,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;IAMhB;;;;;;;;;;;;;OAaG;IACH,SAAS,IAAI,MAAM;IAIb,SAAS,CAAC,QAAQ,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAsBpG,KAAK,IAAI,IAAI;CAId"}

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

@@ -1,33 +1,68 @@
-import { CurrentFrameVideoSource } from '../../../video/mediabunny/frame/CurrentFrameVideoSource';
+import { BufferedVideoFrameSource } from '../../../video/mediabunny/frame/BufferedVideoFrameSource';
 /**
- * `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.
+ * `SubtitleLayerSource` for sections whose stylesheets sample the
+ * underlying video pixels — a backdrop blur, a frame-fed filter, text
+ * behind the actor.
  *
- * 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.
+ * Such a caption cannot be rendered ahead of the video the way a
+ * document-driven one can: its picture is only knowable once the frame
+ * beneath it exists. So the source batches the other way round, over
+ * frames the caller has already gathered: it publishes the whole run
+ * into a `BufferedVideoFrameSource` and asks the renderer for all of
+ * their tiles in one go, so a run of frames costs one rasterization
+ * instead of one each.
+ *
+ * The caller decides how large a run to gather, and {@link lookAhead}
+ * tells it what this source can use — which is however many tiles the
+ * renderer's sheet holds, since a run longer than that would spill into
+ * a second rasterization and buy nothing.
  */
 export class VideoBoundSubtitleLayerSource {
     subtitleRenderer;
     videoFrameSource = null;
+    maxTilesPerBatch = 1;
     constructor(subtitleRenderer) {
         this.subtitleRenderer = subtitleRenderer;
     }
     async open(doc, styles, width, height, _captionInterval) {
-        this.videoFrameSource = new CurrentFrameVideoSource(width, height);
+        this.videoFrameSource = new BufferedVideoFrameSource(width, height);
         await this.subtitleRenderer.open(doc, styles, width, height, this.videoFrameSource);
+        this.maxTilesPerBatch = await this.subtitleRenderer.getMaxTilesPerBatch();
+    }
+    /**
+     * However many tiles the sheet holds, since a run longer than that
+     * would spill into a second rasterization and buy nothing.
+     *
+     * It is an exact fit rather than an estimate: every timestamp served
+     * here takes a tile of its own — the planner forces that for a style
+     * that reads the frame — so a run of N costs exactly N tiles and one
+     * of `maxTilesPerBatch` fills the sheet without ever overflowing it.
+     *
+     * The frames the run holds are a second buffer beside the sheet, but
+     * not one this number should be shrunk for: what caps the sheet is
+     * partly the raster length a host will decode without blanking its
+     * far edge, and a run of separate canvases has no such edge.
+     */
+    lookAhead() {
+        return this.maxTilesPerBatch;
     }
-    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);
+    async framesFor(requests) {
+        if (!this.videoFrameSource || requests.length === 0)
+            return requests.map(() => null);
+        // Published before the fetch: the renderer's stylesheets pull each
+        // frame back through the source while its tile rasterizes.
+        this.videoFrameSource.hold(requests.map((request) => ({ time: request.time, frame: request.videoFrame })));
+        const times = requests.map((request) => request.time);
+        const frames = await this.subtitleRenderer.getFrames(times);
+        // A batch normally covers a prefix, but not one asked for here: a
+        // run never exceeds the sheet's tile capacity and every timestamp
+        // costs exactly one tile, so the whole run fits by construction.
+        // Serving the tail as `null` instead would silently ship frames
+        // with no caption on them.
+        if (frames.length !== times.length) {
+            throw new Error(`Subtitle renderer covered ${frames.length} of ${times.length} video-bound timestamps in one batch.`);
+        }
+        return frames;
     }
     close() {
         this.subtitleRenderer.close();

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

@@ -1 +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"}
+{"version":3,"file":"VideoBoundSubtitleLayerSource.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/caption/VideoBoundSubtitleLayerSource.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AAMpG;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,6BAA6B;IAKX;IAHrB,gBAAgB,GAAoC,IAAI,CAAC;IACzD,gBAAgB,GAAG,CAAC,CAAC;IAE7B,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,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACpF,IAAI,CAAC,gBAAgB,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAA6C;QAC3D,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrF,mEAAmE;QACnE,2DAA2D;QAC3D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CACxB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAC/E,CAAC;QACF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5D,kEAAkE;QAClE,kEAAkE;QAClE,iEAAiE;QACjE,gEAAgE;QAChE,2BAA2B;QAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,uCAAuC,CACrG,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,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/encoder/MediaBunnyCanvasVideoTrackEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,qDAAqD,CAAC;AAE7D,MAAM,WAAW,uCAAuC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,qBAAa,iCAAkC,YAAW,iBAAiB;IAEzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,MAAM,EAAE,uCAAuC;IAoB3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAIpF"}
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAClB,MAAM,qDAAqD,CAAC;AAE7D,MAAM,WAAW,uCAAuC;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,qBAAa,iCAAkC,YAAW,iBAAiB;IAEzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,MAAM,EAAE,uCAAuC;IAwB3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAIpF"}

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.js

@@ -18,9 +18,13 @@ export class MediaBunnyCanvasVideoTrackEncoder {
         this.width = config.width;
         this.height = config.height;
         this.canvas = new OffscreenCanvas(config.width, config.height);
-        // alpha:false — the compositor paints an opaque source frame first;
-        // imageSmoothingEnabled:false — compositor always draws at native
-        // size, so smoothing is a pure no-op cost.
+        // alpha:false — the compositor paints an opaque source frame first.
+        // imageSmoothingEnabled:false — free whenever the output keeps the
+        // source's dimensions, which is the common path. It is not free when
+        // an export asks for smaller ones: the source frame is then scaled
+        // down unsmoothed, straight into the encoder. Whether that shows
+        // enough to be worth the smoothing is unmeasured, so the flag stays
+        // as it was rather than moving on an argument alone.
         const ctx = this.canvas.getContext('2d', {
             alpha: false,
             desynchronized: false,

package/dist/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.js.map

@@ -1 +1 @@
-{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAYjF;;;;;;;;GAQG;AACH,MAAM,OAAO,iCAAiC;IAEnC,KAAK,CAAS;IACd,MAAM,CAAS;IAEP,MAAM,CAAkB;IACxB,OAAO,CAAoC;IAC3C,YAAY,CAAe;IAE5C,YAAY,MAA+C;QACzD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,oEAAoE;QACpE,kEAAkE;QAClE,2CAA2C;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;YACvC,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,KAAK;YACrB,kBAAkB,EAAE,KAAK;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAiB;QACjE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}
+{"version":3,"file":"MediaBunnyCanvasVideoTrackEncoder.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAYjF;;;;;;;;GAQG;AACH,MAAM,OAAO,iCAAiC;IAEnC,KAAK,CAAS;IACd,MAAM,CAAS;IAEP,MAAM,CAAkB;IACxB,OAAO,CAAoC;IAC3C,YAAY,CAAe;IAE5C,YAAY,MAA+C;QACzD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,oEAAoE;QACpE,mEAAmE;QACnE,qEAAqE;QACrE,mEAAmE;QACnE,iEAAiE;QACjE,oEAAoE;QACpE,qDAAqD;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE;YACvC,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,KAAK;YACrB,kBAAkB,EAAE,KAAK;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAiB;QACjE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/modules/video/mediabunny/frame/BufferedVideoFrameSource.d.ts

@@ -0,0 +1,45 @@
+import type { VideoFrameSource, VideoFrameRegion } from '../../../rendering/types/VideoFrameSource';
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/** One frame of the resident group, under the time it answers to. */
+export interface HeldFrame {
+    readonly time: number;
+    readonly frame: DecodedVideoFrame;
+}
+/**
+ * `VideoFrameSource` over a resident group of frames. {@link hold}
+ * publishes the group and the times it answers to; {@link getFrameAt}
+ * serves any of them and nothing else. Querying a time outside the
+ * resident group throws.
+ *
+ * Holding several at once is what lets a batch of caption tiles cover
+ * several frames: every tile in the batch pulls its own frame while
+ * the batch renders.
+ */
+export declare class BufferedVideoFrameSource implements VideoFrameSource {
+    private readonly width;
+    private readonly height;
+    private static readonly TIMESTAMP_TOLERANCE_S;
+    private held;
+    constructor(width: number, height: number);
+    /**
+     * Makes `frames` the only ones {@link getFrameAt} will serve, each
+     * under its paired time, until the next call. Does not take ownership:
+     * the frames must stay usable until then and are closed by whoever
+     * produced them.
+     */
+    hold(frames: ReadonlyArray<HeldFrame>): void;
+    getFrameAt(timeSeconds: number, jpegQuality: number, region?: VideoFrameRegion): Promise<string>;
+    private frameAt;
+    private encode;
+    /**
+     * Draws `region` of the frame onto a canvas sized to that region,
+     * which is what the JPEG is then encoded from. Drawing straight from
+     * the frame rather than from a full-size copy of it is one fewer trip
+     * through the pixels per tile.
+     */
+    private drawInto;
+    private encodeJpeg;
+    private createCanvas;
+    private clipToFrame;
+}
+//# sourceMappingURL=BufferedVideoFrameSource.d.ts.map

package/dist/modules/video/mediabunny/frame/BufferedVideoFrameSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BufferedVideoFrameSource.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/BufferedVideoFrameSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAG3F,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAQnD,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAU,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAQ;IAErD,OAAO,CAAC,IAAI,CAAgC;gBAEf,KAAK,EAAE,MAAM,EAAmB,MAAM,EAAE,MAAM;IAE3E;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI;IAItC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOtG,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,MAAM;IAYd;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAwBhB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/modules/video/mediabunny/frame/BufferedVideoFrameSource.js

@@ -0,0 +1,93 @@
+import { profiler } from '../../../profiling/Profiler';
+/**
+ * `VideoFrameSource` over a resident group of frames. {@link hold}
+ * publishes the group and the times it answers to; {@link getFrameAt}
+ * serves any of them and nothing else. Querying a time outside the
+ * resident group throws.
+ *
+ * Holding several at once is what lets a batch of caption tiles cover
+ * several frames: every tile in the batch pulls its own frame while
+ * the batch renders.
+ */
+export class BufferedVideoFrameSource {
+    width;
+    height;
+    // Any mismatch beyond IEEE-754 noise is a coordination bug between
+    // the producer and the subtitle renderer.
+    static TIMESTAMP_TOLERANCE_S = 1e-6;
+    held = [];
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+    }
+    /**
+     * Makes `frames` the only ones {@link getFrameAt} will serve, each
+     * under its paired time, until the next call. Does not take ownership:
+     * the frames must stay usable until then and are closed by whoever
+     * produced them.
+     */
+    hold(frames) {
+        this.held = frames;
+    }
+    async getFrameAt(timeSeconds, jpegQuality, region) {
+        const frame = this.frameAt(timeSeconds);
+        return profiler.time('BufferedVideoFrameSource.encode', () => this.encode(frame, region, jpegQuality));
+    }
+    frameAt(timeSeconds) {
+        const match = this.held.find((candidate) => Math.abs(candidate.time - timeSeconds) <= BufferedVideoFrameSource.TIMESTAMP_TOLERANCE_S);
+        if (!match) {
+            const times = this.held.map((candidate) => candidate.time).join(', ');
+            throw new Error(`BufferedVideoFrameSource: requested time ${timeSeconds}, but the resident group holds [${times}].`);
+        }
+        return match.frame;
+    }
+    encode(frame, region, jpegQuality) {
+        const clipped = region ? this.clipToFrame(region) : null;
+        if (!clipped || clipped.width === 0 || clipped.height === 0) {
+            return this.encodeJpeg(this.drawInto(frame, { x: 0, y: 0, width: this.width, height: this.height }), jpegQuality);
+        }
+        return this.encodeJpeg(this.drawInto(frame, clipped), jpegQuality);
+    }
+    /**
+     * Draws `region` of the frame onto a canvas sized to that region,
+     * which is what the JPEG is then encoded from. Drawing straight from
+     * the frame rather than from a full-size copy of it is one fewer trip
+     * through the pixels per tile.
+     */
+    drawInto(frame, region) {
+        const canvas = this.createCanvas(region.width, region.height);
+        const context = profiler.time('BufferedVideoFrameSource.cropCanvasContext', () => canvas.getContext('2d', { alpha: false }));
+        if (!context) {
+            throw new Error('Canvas 2D context is not available for cropping.');
+        }
+        profiler.time('BufferedVideoFrameSource.cropDraw', () => frame.draw(context, -region.x, -region.y, this.width, this.height));
+        return canvas;
+    }
+    // Chosen for predictability over raw speed. `toDataURL` encodes inline;
+    // `OffscreenCanvas.convertToBlob` defers to the browser's async image
+    // scheduler, which was measured taking ~1s per call instead of the usual
+    // few ms, under a load that could not be pinned down or reproduced.
+    // Output is byte-identical between the two on Chrome and Firefox, and the
+    // async overhead is per-call rather than per-pixel, so the two only differ
+    // meaningfully at small crop sizes. The tradeoff accepted here is that
+    // encoding inline blocks the main thread for the whole encode, and that a
+    // DOM canvas rules out ever running this step in a Worker.
+    // Benchmarked in experiments/jpeg-encode-apis/.
+    encodeJpeg(canvas, jpegQuality) {
+        return profiler.time('BufferedVideoFrameSource.encodeJpeg', () => canvas.toDataURL('image/jpeg', jpegQuality));
+    }
+    createCanvas(width, height) {
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        return canvas;
+    }
+    clipToFrame(region) {
+        const x = Math.max(0, Math.floor(region.x));
+        const y = Math.max(0, Math.floor(region.y));
+        const right = Math.min(this.width, Math.ceil(region.x + region.width));
+        const bottom = Math.min(this.height, Math.ceil(region.y + region.height));
+        return { x, y, width: Math.max(0, right - x), height: Math.max(0, bottom - y) };
+    }
+}
+//# sourceMappingURL=BufferedVideoFrameSource.js.map

package/dist/modules/video/mediabunny/frame/BufferedVideoFrameSource.js.map

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

package/dist/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultVideoFrameDecoderFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,0DAA0D,CAAC;AAIlE;;;;;GAKG;AACH,qBAAa,+BAAgC,YAAW,wBAAwB;IAExE,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAc5E"}
+{"version":3,"file":"DefaultVideoFrameDecoderFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,0DAA0D,CAAC;AAIlE;;;;;GAKG;AACH,qBAAa,+BAAgC,YAAW,wBAAwB;IAExE,MAAM,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgB5E"}

package/dist/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.js

@@ -9,16 +9,18 @@ import { HtmlVideoElementVideoFrameDecoder } from '../../../video/mediabunny/fra
 export class DefaultVideoFrameDecoderFactory {
     async create(request) {
         const webCodecsCapable = await request.track.canDecode();
+        const inputCodec = (await request.track.getCodec()) ?? 'unknown';
         if (webCodecsCapable) {
+            request.onDecoderSelected?.({ kind: 'web-codecs', inputCodec });
             return new WebCodecsVideoFrameDecoder(request.track);
         }
-        const inputCodec = (await request.track.getCodec()) ?? 'unknown';
         if (request.confirmFallback) {
             const accepted = await request.confirmFallback({ inputCodec });
             if (!accepted) {
                 throw new DOMException('Fallback decoder declined by the caller.', 'AbortError');
             }
         }
+        request.onDecoderSelected?.({ kind: 'html-video-element', inputCodec });
         return new HtmlVideoElementVideoFrameDecoder(request.source, inputCodec);
     }
 }

package/dist/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultVideoFrameDecoderFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAEtH;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAE1C,KAAK,CAAC,MAAM,CAAC,OAAiC;QAC5C,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACzD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC;QACjE,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,YAAY,CAAC,0CAA0C,EAAE,YAAY,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,IAAI,iCAAiC,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;CACF"}
+{"version":3,"file":"DefaultVideoFrameDecoderFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/DefaultVideoFrameDecoderFactory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAEtH;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAE1C,KAAK,CAAC,MAAM,CAAC,OAAiC;QAC5C,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACzD,MAAM,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC;QACjE,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;YAChE,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,YAAY,CAAC,0CAA0C,EAAE,YAAY,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,iCAAiC,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/modules/video/mediabunny/frame/RetainedVideoFrame.d.ts

@@ -0,0 +1,26 @@
+import type { DecodedVideoFrame } from '../../../video/mediabunny/frame/VideoFrameDecoder';
+/**
+ * A decoded frame's pixels copied onto a canvas of the caller's own, so
+ * they outlive the decoder's frame.
+ *
+ * A decoder hands out frames it expects back promptly: holding several
+ * at once back-pressures the frame pool into a stall. Copying breaks
+ * that tie — the decoder's frame closes immediately and what stays
+ * alive is an ordinary canvas, at the cost of one full-frame draw and
+ * `width × height × 4` bytes per frame held.
+ */
+export declare class RetainedVideoFrame implements DecodedVideoFrame {
+    readonly timestamp: number;
+    readonly duration: number;
+    /**
+     * Copies `frame` at the given dimensions. Does not close `frame`;
+     * the caller keeps that responsibility and may do so as soon as this
+     * returns.
+     */
+    static copyOf(frame: DecodedVideoFrame, width: number, height: number): RetainedVideoFrame;
+    private canvas;
+    private constructor();
+    draw(context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D, dx: number, dy: number, dWidth: number, dHeight: number): void;
+    close(): void;
+}
+//# sourceMappingURL=RetainedVideoFrame.d.ts.map

package/dist/modules/video/mediabunny/frame/RetainedVideoFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetainedVideoFrame.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/frame/RetainedVideoFrame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AAG3F;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAwBxD,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAvB3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB;IAa1F,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO;IAQP,IAAI,CACF,OAAO,EAAE,iCAAiC,GAAG,wBAAwB,EACrE,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI;IAOP,KAAK,IAAI,IAAI;CAUd"}