@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/rendering/subtitle/SpriteSheetCompositor.js

@@ -0,0 +1,143 @@
+import { profiler } from '../../profiling/Profiler';
+/**
+ * Composes a sprite sheet per asset group: stacks unique tiles along
+ * the smaller dimension axis, emits the SVG holding one
+ * `foreignObject` per tile, decodes it through an `<img>` so the
+ * bitmap paints into any 2D context without tainting the canvas,
+ * and produces draw callbacks that slice the sheet by tile index.
+ */
+export class SpriteSheetCompositor {
+    styles;
+    wrapperRenderer;
+    baselineCssComposer;
+    width;
+    height;
+    constructor(styles, wrapperRenderer, baselineCssComposer, width, height) {
+        this.styles = styles;
+        this.wrapperRenderer = wrapperRenderer;
+        this.baselineCssComposer = baselineCssComposer;
+        this.width = width;
+        this.height = height;
+    }
+    async renderGroups(groups) {
+        const sprites = new Map();
+        for (const group of groups.values()) {
+            const img = await this.renderSpriteSheet(group.uniqueTiles);
+            sprites.set(group.assetKey, img);
+        }
+        return sprites;
+    }
+    buildFrames(assignments, sprites) {
+        const isPortrait = this.width < this.height;
+        return assignments.map((assn) => {
+            if (!assn)
+                return null;
+            const img = sprites.get(assn.assetKey);
+            const sx = isPortrait ? assn.tileIndex * this.width : 0;
+            const sy = isPortrait ? 0 : assn.tileIndex * this.height;
+            return {
+                draw: (ctx, dx, dy, dw, dh) => ctx.drawImage(img, sx, sy, this.width, this.height, dx, dy, dw, dh),
+            };
+        });
+    }
+    async renderSpriteSheet(tiles) {
+        const isPortrait = this.width < this.height;
+        const sheetW = isPortrait ? tiles.length * this.width : this.width;
+        const sheetH = isPortrait ? this.height : tiles.length * this.height;
+        const content = await profiler.time('SpriteSheetCompositor.buildTiles', () => this.buildTiles(tiles, isPortrait));
+        const styleBlock = profiler.time('SpriteSheetCompositor.composeStyleSheet', () => this.composeStyleSheet(tiles));
+        const defsBlock = content.defs ? `<defs>${content.defs}</defs>` : '';
+        const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${sheetW}" height="${sheetH}">${defsBlock}${styleBlock}${content.html}</svg>`;
+        return this.decodeSvg(svg, tiles, sheetW, sheetH);
+    }
+    async buildTiles(tiles, isPortrait) {
+        let itemUid = 0;
+        const results = await Promise.all(tiles.map((tile, i) => this.buildTileHtml(tile, i, isPortrait, () => itemUid++)));
+        return {
+            html: results.map((r) => r.html).join(''),
+            defs: results.map((r) => r.defs).filter(Boolean).join(''),
+        };
+    }
+    composeStyleSheet(tiles) {
+        const activeKinds = this.collectActiveKinds(tiles);
+        const sectionCss = this.joinByKind(activeKinds, (style) => style.scopedCss);
+        const baselineCss = this.composeBaselineCssForKinds(activeKinds);
+        return this.composeStyleBlock(baselineCss + sectionCss);
+    }
+    /**
+     * Wraps the stylesheet in a `<![CDATA[...]]>` section so the XML
+     * parser that decodes the data-URL SVG ignores any `<` / `>` inside
+     * CSS string values (e.g. `@property syntax: '<integer>'`) instead
+     * of treating them as malformed tags. `]]>` inside the CSS would
+     * close the CDATA early — splitting around it terminates and
+     * re-opens the section cleanly. */
+    composeStyleBlock(css) {
+        const safe = css.split(']]>').join(']]]]><![CDATA[>');
+        return `<style><![CDATA[${safe}]]></style>`;
+    }
+    async buildTileHtml(tile, i, isPortrait, nextUid) {
+        const tx = isPortrait ? i * this.width : 0;
+        const ty = isPortrait ? 0 : i * this.height;
+        const wrapperResults = await Promise.all(tile.items.map(({ style, seg, t, indexInSection }) => this.wrapperRenderer.buildWrapperHtml(style, seg, t, indexInSection, nextUid)));
+        const wrappers = wrapperResults.map((r) => r.html).join('');
+        const defs = wrapperResults.map((r) => r.defs).filter(Boolean).join('');
+        const html = `<foreignObject x="${tx}" y="${ty}" width="${this.width}" height="${this.height}"><div xmlns="http://www.w3.org/1999/xhtml" style="position:relative;width:${this.width}px;height:${this.height}px;overflow:hidden;container-type:size;">${wrappers}</div></foreignObject>`;
+        return { html, defs };
+    }
+    composeBaselineCssForKinds(kinds) {
+        const perStyle = [...kinds].map((kind) => this.styles[kind].baselineNeeds);
+        return this.baselineCssComposer.composeUnion(perStyle);
+    }
+    collectActiveKinds(tiles) {
+        const kinds = new Set();
+        for (const tile of tiles)
+            for (const item of tile.items)
+                kinds.add(item.style.kind);
+        return kinds;
+    }
+    joinByKind(kinds, pick) {
+        return [...kinds].map((kind) => pick(this.styles[kind])).filter(Boolean).join('\n');
+    }
+    async decodeSvg(svg, tiles, sheetW, sheetH) {
+        const img = new Image();
+        img.src = profiler.time('SpriteSheetCompositor.encodeDataUrl', () => `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`);
+        // `onload` can fire before custom fonts have finished applying,
+        // producing visually-laggy captures with foreignObject + @font-face.
+        // `decode()` only resolves once the image is fully paint-ready.
+        try {
+            await profiler.time('SpriteSheetCompositor.decodeImage', () => img.decode());
+        }
+        catch (e) {
+            const kinds = new Set();
+            for (const tile of tiles)
+                for (const item of tile.items)
+                    kinds.add(item.style.kind);
+            console.error('[tscaps] subtitle SVG decode failed', {
+                error: e instanceof Error ? e.message : String(e),
+                xmlParseError: this.extractXmlParseError(svg),
+                kinds: [...kinds],
+                tiles: tiles.length,
+                sheetW,
+                sheetH,
+                svgLength: svg.length,
+                svgHead: svg.slice(0, 400),
+            });
+            throw new Error(`Subtitle render failed: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+        }
+        return img;
+    }
+    /**
+     * Re-parses the SVG through `DOMParser` to recover the XML-level
+     * error message browsers hide behind the opaque "source image cannot
+     * be decoded" image-decode failure. Returns the parser's error
+     * description, or `null` when the SVG parses cleanly (in which case
+     * the decode failed for a different reason — font loading, security,
+     * raster size cap, etc.).
+     */
+    extractXmlParseError(svg) {
+        const parsed = new DOMParser().parseFromString(svg, 'image/svg+xml');
+        const parseError = parsed.querySelector('parsererror');
+        return parseError ? parseError.textContent ?? 'unknown XML parse error' : null;
+    }
+}
+//# sourceMappingURL=SpriteSheetCompositor.js.map

package/dist/modules/rendering/subtitle/SpriteSheetCompositor.js.map

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

package/dist/modules/rendering/subtitle/SpriteSheetSizeProber.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Empirically probes the maximum number of subtitle tiles that fit
+ * into a single sprite sheet at the given output dimensions without
+ * blowing past the host's 2D-canvas raster cap or the configured
+ * pixel budget. No public browser API surfaces the raster cap
+ * directly, and the reported WebGL limits bear no stable relation to
+ * what `img.decode` / `drawImage` accept. Some hosts decode oversize
+ * SVGs but blank the far edges of the raster; the probe reads back a
+ * corner pixel to detect that.
+ */
+export declare class SpriteSheetSizeProber {
+    private readonly maxBufferPixels;
+    constructor(maxBufferPixels?: number);
+    probe(width: number, height: number): Promise<number>;
+    private testTileSize;
+}
+//# sourceMappingURL=SpriteSheetSizeProber.d.ts.map

package/dist/modules/rendering/subtitle/SpriteSheetSizeProber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSheetSizeProber.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SpriteSheetSizeProber.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAEpB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,GAAE,MAAkC;IAE1E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAiB7C,YAAY;CAgB3B"}

package/dist/modules/rendering/subtitle/SpriteSheetSizeProber.js

@@ -0,0 +1,58 @@
+const NUMBER_OF_TILES_TO_TEST = [1, 2, 4, 6, 8, 10, 12, 15, 18, 21, 25, 30];
+// 10 frames at 1080×1920 ≈ 80 MB of pixel buffer.
+// At 4K the same budget admits only ~2 tiles per batch.
+const DEFAULT_MAX_BUFFER_PIXELS = 10 * 1080 * 1920;
+/**
+ * Empirically probes the maximum number of subtitle tiles that fit
+ * into a single sprite sheet at the given output dimensions without
+ * blowing past the host's 2D-canvas raster cap or the configured
+ * pixel budget. No public browser API surfaces the raster cap
+ * directly, and the reported WebGL limits bear no stable relation to
+ * what `img.decode` / `drawImage` accept. Some hosts decode oversize
+ * SVGs but blank the far edges of the raster; the probe reads back a
+ * corner pixel to detect that.
+ */
+export class SpriteSheetSizeProber {
+    maxBufferPixels;
+    constructor(maxBufferPixels = DEFAULT_MAX_BUFFER_PIXELS) {
+        this.maxBufferPixels = maxBufferPixels;
+    }
+    async probe(width, height) {
+        try {
+            let lastPassing = 1;
+            for (const numberOfTiles of NUMBER_OF_TILES_TO_TEST) {
+                const isPortrait = width < height;
+                const scaledWidth = isPortrait ? width * numberOfTiles : width;
+                const scaledHeight = isPortrait ? height : height * numberOfTiles;
+                if (scaledWidth * scaledHeight > this.maxBufferPixels)
+                    return lastPassing;
+                if (!(await this.testTileSize(scaledWidth, scaledHeight)))
+                    return lastPassing;
+                lastPassing = numberOfTiles;
+            }
+            return lastPassing;
+        }
+        catch {
+            return 1;
+        }
+    }
+    async testTileSize(width, height) {
+        const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}"><rect width="100%" height="100%" fill="green"/><rect x="${width - 2}" y="${height - 2}" width="2" height="2" fill="red"/></svg>`;
+        const img = new Image();
+        img.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+        try {
+            await img.decode();
+            const canvas = new OffscreenCanvas(width, height);
+            const ctx = canvas.getContext('2d');
+            if (!ctx)
+                return false;
+            ctx.drawImage(img, 0, 0);
+            const px = ctx.getImageData(width - 1, height - 1, 1, 1).data;
+            return px[0] > 200 && px[1] < 80 && px[2] < 80 && px[3] > 200;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=SpriteSheetSizeProber.js.map

package/dist/modules/rendering/subtitle/SpriteSheetSizeProber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSheetSizeProber.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SpriteSheetSizeProber.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAE5E,kDAAkD;AAClD,wDAAwD;AACxD,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IAEH;IAA7B,YAA6B,kBAA0B,yBAAyB;QAAnD,oBAAe,GAAf,eAAe,CAAoC;IAAG,CAAC;IAEpF,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc;QACvC,IAAI,CAAC;YACH,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,aAAa,IAAI,uBAAuB,EAAE,CAAC;gBACpD,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;gBAClC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC;gBAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,aAAa,CAAC;gBAClE,IAAI,WAAW,GAAG,YAAY,GAAG,IAAI,CAAC,eAAe;oBAAE,OAAO,WAAW,CAAC;gBAC1E,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;oBAAE,OAAO,WAAW,CAAC;gBAC9E,WAAW,GAAG,aAAa,CAAC;YAC9B,CAAC;YACD,OAAO,WAAW,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,MAAc;QACtD,MAAM,GAAG,GAAG,kDAAkD,KAAK,aAAa,MAAM,6DAA6D,KAAK,GAAG,CAAC,QAAQ,MAAM,GAAG,CAAC,2CAA2C,CAAC;QAC1N,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,GAAG,CAAC,GAAG,GAAG,oCAAoC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAC;YACvB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,OAAO,EAAE,CAAC,CAAC,CAAE,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/modules/rendering/subtitle/SvgFilterMaterializer.d.ts

@@ -0,0 +1,20 @@
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+import type { SvgFilterDefs, SvgFilterDefsRenderer } from '../../svg-filter/SvgFilterDefsRenderer';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/**
+ * Materializes the SVG `<filter>` defs declared by a style's filter
+ * bundle for one render tile. Layers the engine-injected vars onto the
+ * consumer's scope and hands the result to the defs renderer under an
+ * id scope unique to the tile, so two tiles using the same source
+ * filter don't collide in the sprite-sheet SVG.
+ *
+ * Returns empty defs and empty bindings when the style declares no
+ * filters.
+ */
+export declare class SvgFilterMaterializer {
+    private readonly defsRenderer;
+    private readonly renderHeightPx;
+    constructor(defsRenderer: SvgFilterDefsRenderer, renderHeightPx: number);
+    materialize(style: PreparedStyle, t: number, engineVars: InlineStyleMap, nextUid: () => number): SvgFilterDefs;
+}
+//# sourceMappingURL=SvgFilterMaterializer.d.ts.map

package/dist/modules/rendering/subtitle/SvgFilterMaterializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterMaterializer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SvgFilterMaterializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAI/E;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,YAAY,EAAE,qBAAqB,EACnC,cAAc,EAAE,MAAM;IAGzC,WAAW,CACT,KAAK,EAAE,aAAa,EACpB,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,MAAM,MAAM,GACpB,aAAa;CAajB"}

package/dist/modules/rendering/subtitle/SvgFilterMaterializer.js

@@ -0,0 +1,30 @@
+import { SvgFilterScope } from '../../svg-filter/SvgFilterScope';
+const EMPTY_DEFS = { defs: '', bindings: new Map() };
+/**
+ * Materializes the SVG `<filter>` defs declared by a style's filter
+ * bundle for one render tile. Layers the engine-injected vars onto the
+ * consumer's scope and hands the result to the defs renderer under an
+ * id scope unique to the tile, so two tiles using the same source
+ * filter don't collide in the sprite-sheet SVG.
+ *
+ * Returns empty defs and empty bindings when the style declares no
+ * filters.
+ */
+export class SvgFilterMaterializer {
+    defsRenderer;
+    renderHeightPx;
+    constructor(defsRenderer, renderHeightPx) {
+        this.defsRenderer = defsRenderer;
+        this.renderHeightPx = renderHeightPx;
+    }
+    materialize(style, t, engineVars, nextUid) {
+        const definitions = style.filters.definitions;
+        if (definitions.isEmpty())
+            return EMPTY_DEFS;
+        const context = { currentTime: t, renderHeightPx: this.renderHeightPx };
+        const consumerScope = style.filters.scopeProvider.scopeAt(context);
+        const scope = consumerScope.with(SvgFilterScope.fromEntries(Object.entries(engineVars)));
+        return this.defsRenderer.render(definitions, scope, style.filters.scopeProvider.lengthFactorsAt(context), `${style.scopeClass}-${nextUid()}`);
+    }
+}
+//# sourceMappingURL=SvgFilterMaterializer.js.map

package/dist/modules/rendering/subtitle/SvgFilterMaterializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterMaterializer.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SvgFilterMaterializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,MAAM,UAAU,GAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,OAAO,qBAAqB;IAGb;IACA;IAFnB,YACmB,YAAmC,EACnC,cAAsB;QADtB,iBAAY,GAAZ,YAAY,CAAuB;QACnC,mBAAc,GAAd,cAAc,CAAQ;IACtC,CAAC;IAEJ,WAAW,CACT,KAAoB,EACpB,CAAS,EACT,UAA0B,EAC1B,OAAqB;QAErB,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAC9C,IAAI,WAAW,CAAC,OAAO,EAAE;YAAE,OAAO,UAAU,CAAC;QAC7C,MAAM,OAAO,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACxE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAC7B,WAAW,EACX,KAAK,EACL,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,EACpD,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,EAAE,EAAE,CACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/rendering/subtitle/VideoFrameVarsBuilder.d.ts

@@ -0,0 +1,42 @@
+import type { Segment } from '../../document/Segment';
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+import type { VideoFrameSource } from '../../rendering/types/VideoFrameSource';
+import type { SegmentSubtreeHtmlBuilder } from '../../rendering/subtitle/SegmentSubtreeHtmlBuilder';
+import type { SegmentPaintRegionResolver, SegmentAnchorPlacement } from '../../rendering/subtitle/SegmentPaintRegionResolver';
+import type { SegmentPaintRegionCache } from '../../rendering/subtitle/SegmentPaintRegionCache';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/**
+ * Builds the inline-style map driving the video-frame backdrop for
+ * one segment: the JPEG data URL holding the painted region of the
+ * underlying frame, plus the region's pixel size and offset within
+ * the segment's anchor box. Caches paint regions per
+ * `(kind, segmentId)` so the JPEG crop is only measured once per
+ * segment.
+ *
+ * Returns an empty map for styles that don't consume the video
+ * frame.
+ */
+export declare class VideoFrameVarsBuilder {
+    private readonly subtreeBuilder;
+    private readonly paintRegionResolver;
+    private readonly paintRegionCache;
+    private readonly width;
+    private readonly height;
+    private readonly videoFrameSource;
+    constructor(subtreeBuilder: SegmentSubtreeHtmlBuilder, paintRegionResolver: SegmentPaintRegionResolver, paintRegionCache: SegmentPaintRegionCache, width: number, height: number, videoFrameSource: VideoFrameSource | null);
+    build(style: PreparedStyle, seg: Segment, placement: SegmentAnchorPlacement, t: number): Promise<InlineStyleMap>;
+    /**
+     * The tight-crop optimization assumes every word stays inside the
+     * segment's in-flow bounding box. As soon as a word is
+     * repositioned outside that bbox, the same crop leaves its
+     * video-frame backdrop sampling pixels that aren't in the JPEG
+     * payload. Falling back to the full viewport for those segments
+     * restores correctness; the optimization recovers automatically
+     * the moment the override is reset.
+     */
+    private resolvePaintRegion;
+    private measureSegmentPaintRegion;
+    private hasPositionedWord;
+    private hasPositionedDecoration;
+}
+//# sourceMappingURL=VideoFrameVarsBuilder.d.ts.map

package/dist/modules/rendering/subtitle/VideoFrameVarsBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameVarsBuilder.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/VideoFrameVarsBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,2CAA2C,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,KAAK,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AACjI,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AACnG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAU/E;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBALhB,cAAc,EAAE,yBAAyB,EACzC,mBAAmB,EAAE,0BAA0B,EAC/C,gBAAgB,EAAE,uBAAuB,EACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,GAAG,IAAI;IAGtD,KAAK,CACT,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,sBAAsB,EACjC,CAAC,EAAE,MAAM,GACR,OAAO,CAAC,cAAc,CAAC;IAsB1B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,yBAAyB;IA4CjC,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,uBAAuB;CAShC"}

package/dist/modules/rendering/subtitle/VideoFrameVarsBuilder.js

@@ -0,0 +1,121 @@
+import { CssVariable } from '../../document/CssVariable';
+import { profiler } from '../../profiling/Profiler';
+const NO_EXCLUDED_WORDS = new Set();
+// Safety bleed applied to the painted region for video-frame styles
+// that don't declare a `rendering.padding`. 0.25em ≈ enough to cover
+// a typical text-shadow, kept narrow so the crop still pays off.
+const UNDECLARED_PADDING_SAFETY_EM = 0.25;
+/**
+ * Builds the inline-style map driving the video-frame backdrop for
+ * one segment: the JPEG data URL holding the painted region of the
+ * underlying frame, plus the region's pixel size and offset within
+ * the segment's anchor box. Caches paint regions per
+ * `(kind, segmentId)` so the JPEG crop is only measured once per
+ * segment.
+ *
+ * Returns an empty map for styles that don't consume the video
+ * frame.
+ */
+export class VideoFrameVarsBuilder {
+    subtreeBuilder;
+    paintRegionResolver;
+    paintRegionCache;
+    width;
+    height;
+    videoFrameSource;
+    constructor(subtreeBuilder, paintRegionResolver, paintRegionCache, width, height, videoFrameSource) {
+        this.subtreeBuilder = subtreeBuilder;
+        this.paintRegionResolver = paintRegionResolver;
+        this.paintRegionCache = paintRegionCache;
+        this.width = width;
+        this.height = height;
+        this.videoFrameSource = videoFrameSource;
+    }
+    async build(style, seg, placement, t) {
+        if (!style.rendering.videoFrame.required)
+            return {};
+        const region = profiler.time('VideoFrameVarsBuilder.paintRegion', () => this.resolvePaintRegion(style, seg, placement));
+        const frameUrl = await profiler.time('VideoFrameVarsBuilder.frameUrl', () => this.videoFrameSource.getFrameAt(t, style.rendering.videoFrame.jpegQuality, region));
+        // Offset vars assume the consuming element is a direct child of
+        // the wrapper: `%` resolves against the wrapper. The region.x/y
+        // bias positions the layer so the cropped frame's (0,0) lands on
+        // viewport (region.x, region.y); when no crop applies the bias
+        // is zero and the layer covers the full viewport.
+        return {
+            [CssVariable.VIDEO_FRAME]: `url("${frameUrl}")`,
+            [CssVariable.SUBTITLE_REGION_WIDTH]: `${region.width}px`,
+            [CssVariable.SUBTITLE_REGION_HEIGHT]: `${region.height}px`,
+            [CssVariable.SUBTITLE_REGION_X]: `calc(${placement.hAnchorPct}% - ${placement.xPx - region.x}px)`,
+            [CssVariable.SUBTITLE_REGION_Y]: `calc(${placement.vAnchorPct}% - ${placement.yPx - region.y}px)`,
+        };
+    }
+    /**
+     * The tight-crop optimization assumes every word stays inside the
+     * segment's in-flow bounding box. As soon as a word is
+     * repositioned outside that bbox, the same crop leaves its
+     * video-frame backdrop sampling pixels that aren't in the JPEG
+     * payload. Falling back to the full viewport for those segments
+     * restores correctness; the optimization recovers automatically
+     * the moment the override is reset.
+     */
+    resolvePaintRegion(style, seg, placement) {
+        return this.paintRegionCache.getOrCompute(style.kind, seg.id, () => this.hasPositionedWord(seg, style.wordOverrides) || this.hasPositionedDecoration(seg, style)
+            ? { x: 0, y: 0, width: this.width, height: this.height }
+            : this.measureSegmentPaintRegion(style, seg, placement));
+    }
+    measureSegmentPaintRegion(style, seg, placement) {
+        const segmentOverride = style.segmentOverrides.get(seg.id);
+        const segmentInlineStylesOverride = segmentOverride?.inlineStyles;
+        const baseInlineStyles = segmentInlineStylesOverride
+            ? { ...style.inlineStyles, ...segmentInlineStylesOverride }
+            : style.inlineStyles;
+        const segmentHtml = this.subtreeBuilder.buildSegmentSubtree({
+            scopeClass: style.scopeClass,
+            baseInlineStyles,
+            wordOverrides: style.wordOverrides,
+            splitWordsIntoLetters: style.rendering.splitWordsIntoLetters,
+            includeVideoFrameLayer: style.rendering.videoFrame.required,
+            textDirection: style.rendering.textDirection,
+            extraWrapperStyles: {},
+            extraSegmentClasses: segmentOverride?.classes ?? [],
+            decorationPlacements: style.decorationPlacements,
+            // The probe measures geometry, so it has to carry the ids the
+            // stylesheet addresses: a rule targeting one element can change
+            // its box, and a region measured without it would be wrong.
+            addressableElementIds: style.addressableElementIds,
+            inlineStyleEmitter: style.inlineStyleEmitter,
+        }, seg, seg.time.start, NO_EXCLUDED_WORDS, 
+        // Paint-region measurement renders the segment in isolation; the
+        // index inside the section doesn't affect layout, so any value works.
+        0);
+        return this.paintRegionResolver.resolve({
+            segmentHtml,
+            probeContainer: style.probeContainer,
+            placement,
+            viewportWidth: this.width,
+            viewportHeight: this.height,
+            safetyBleedEm: style.rendering.padding === null ? UNDECLARED_PADDING_SAFETY_EM : 0,
+        });
+    }
+    hasPositionedWord(seg, wordOverrides) {
+        for (const line of seg.lines) {
+            for (const word of line.words) {
+                if (wordOverrides.get(word.id)?.alignment)
+                    return true;
+            }
+        }
+        return false;
+    }
+    hasPositionedDecoration(seg, style) {
+        for (const line of seg.lines) {
+            for (const word of line.words) {
+                if (!word.decoration)
+                    continue;
+                if (style.wordOverrides.get(word.decoration.id)?.alignment)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=VideoFrameVarsBuilder.js.map

package/dist/modules/rendering/subtitle/VideoFrameVarsBuilder.js.map

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

package/dist/modules/rendering/types/AlignmentConfig.d.ts

@@ -0,0 +1,33 @@
+import type { HorizontalSide } from '../../bidi/HorizontalSide';
+export type VerticalAlign = 'top' | 'center' | 'bottom';
+/** Every vertical anchor, for reading one back off something that was stored. */
+export declare const VERTICAL_ALIGNS: ReadonlyArray<VerticalAlign>;
+export type HorizontalAlign = HorizontalSide;
+/**
+ * Symmetric box-anchor positioning. `*Offset` is the absolute position of
+ * the anchor point as a fraction of the video's dimensions; `*Align`
+ * decides which edge of the caption box lands on that point:
+ *   top/left/start   → 0% of own size
+ *   center           → 50%
+ *   bottom/right/end → 100%
+ *
+ * E.g. `verticalOffset: 1, verticalAlign: 'bottom'` pins the box's bottom
+ * edge to the video's bottom edge. `horizontalOffset: 0.5,
+ * horizontalAlign: 'center'` centers the box horizontally.
+ *
+ * `horizontalAlign` decides how the whole horizontal axis is read: with a
+ * screen side, `horizontalOffset` counts from the video's left edge; with a
+ * reading side, it counts from the edge where reading begins. The two are
+ * never mixed, so `start` at `0.06` sits six percent in from the left in
+ * left-to-right text and six percent in from the right in right-to-left
+ * text, while `left` at `0.06` stays put in both. `center` is treated as a
+ * screen side: it names the same place either way, and leaving its offset
+ * alone keeps a caption the reader positioned by hand where they put it.
+ */
+export interface AlignmentConfig {
+    verticalAlign: VerticalAlign;
+    verticalOffset: number;
+    horizontalAlign: HorizontalAlign;
+    horizontalOffset: number;
+}
+//# sourceMappingURL=AlignmentConfig.d.ts.map

package/dist/modules/rendering/types/AlignmentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlignmentConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/AlignmentConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,iFAAiF;AACjF,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,aAAa,CAA+B,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAE7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IAEjC,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/modules/rendering/types/AlignmentConfig.js

@@ -0,0 +1,3 @@
+/** Every vertical anchor, for reading one back off something that was stored. */
+export const VERTICAL_ALIGNS = ['top', 'center', 'bottom'];
+//# sourceMappingURL=AlignmentConfig.js.map

package/dist/modules/rendering/types/AlignmentConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlignmentConfig.js","sourceRoot":"","sources":["../../../../src/modules/rendering/types/AlignmentConfig.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,MAAM,CAAC,MAAM,eAAe,GAAiC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC"}

package/dist/modules/rendering/types/BoxEdges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxEdges.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/BoxEdges.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/modules/rendering/types/BoxEdges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxEdges.js","sourceRoot":"","sources":["../../../../src/modules/rendering/types/BoxEdges.ts"],"names":[],"mappings":""}

package/dist/modules/rendering/types/DecorationPlacementSide.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Which side of the segment a decoration glyph should be lifted to
+ * when the host sheet's effect config takes it out of line flow. When
+ * a decoration id is absent from the placement map, the glyph stays
+ * inline next to its host word.
+ */
+export type DecorationPlacementSide = 'above' | 'below';
+//# sourceMappingURL=DecorationPlacementSide.d.ts.map

package/dist/modules/rendering/types/DecorationPlacementSide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecorationPlacementSide.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/DecorationPlacementSide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,OAAO,CAAC"}

package/dist/modules/rendering/types/DecorationPlacementSide.js

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

package/dist/modules/rendering/types/DecorationPlacementSide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecorationPlacementSide.js","sourceRoot":"","sources":["../../../../src/modules/rendering/types/DecorationPlacementSide.ts"],"names":[],"mappings":""}

package/dist/modules/rendering/types/ElementRenderOverrides.d.ts

@@ -0,0 +1,23 @@
+import type { ScopedRenderOverride } from '../../rendering/types/ScopedRenderOverride';
+/**
+ * Render-time overrides indexed by element id.
+ * The bitmap renderer looks up each element by
+ * id and layers the resolved override over the style's root defaults.
+ */
+export declare class ElementRenderOverrides {
+    private readonly entries;
+    static empty(): ElementRenderOverrides;
+    static fromEntries(entries: ReadonlyArray<readonly [string, ScopedRenderOverride]>): ElementRenderOverrides;
+    private constructor();
+    isEmpty(): boolean;
+    get(elementId: string): ScopedRenderOverride | undefined;
+    /**
+     * A new instance layering `other` over this one: elements present in
+     * only one side keep their entry; for elements present in both,
+     * `other`'s inline styles merge key-by-key over this one's, and its
+     * alignment and classes replace them when present.
+     */
+    mergedWith(other: ElementRenderOverrides): ElementRenderOverrides;
+    private mergeOverride;
+}
+//# sourceMappingURL=ElementRenderOverrides.d.ts.map

package/dist/modules/rendering/types/ElementRenderOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementRenderOverrides.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ElementRenderOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAE1F;;;;GAIG;AACH,qBAAa,sBAAsB;IAY/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,MAAM,CAAC,KAAK,IAAI,sBAAsB;IAItC,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,GAC9D,sBAAsB;IAIzB,OAAO;IAIP,OAAO,IAAI,OAAO;IAIlB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIxD;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB;IAWjE,OAAO,CAAC,aAAa;CAUtB"}