@tscaps/engine 0.1.1 → 0.3.0

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

@@ -0,0 +1,32 @@
+import type { Document } from '../../document/Document';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+import type { AnimationProbe } from '../../rendering/subtitle/AnimationProbe';
+import type { BatchPlan } from '../../rendering/subtitle/BatchPlan';
+/**
+ * Plans one batch: for each timestamp, finds the active prepared
+ * styles, groups timestamps by their disjoint kind sets so each
+ * rendered sprite carries only the asset payload its tiles need, and
+ * deduplicates timestamps that resolve to the same visual state into
+ * a single tile inside their group.
+ */
+export declare class BatchPlanner {
+    private readonly doc;
+    private readonly styles;
+    private readonly animationProbe;
+    constructor(doc: Document, styles: Readonly<Record<string, PreparedStyle>>, animationProbe: AnimationProbe);
+    plan(timestamps: ReadonlyArray<number>): BatchPlan;
+    private assignTile;
+    private itemsAt;
+    private computeAssetKey;
+    private computeStateKey;
+    /**
+     * Captures every time-varying CSS class the segment subtree
+     * exposes (segment, lines, words) so two timestamps that resolve
+     * to the same computed style — and therefore the same rendered
+     * frame outside active animation windows — share a tile, while two
+     * timestamps with different class states stay distinct.
+     */
+    private fingerprintSegmentState;
+    private fingerprintLineState;
+}
+//# sourceMappingURL=BatchPlanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchPlanner.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/BatchPlanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAEjF,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,uCAAuC,CAAC;AAG/G;;;;;;GAMG;AACH,qBAAa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,cAAc,EAAE,cAAc;IAGjD,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS;IAalD,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAOvB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,oBAAoB;CAK7B"}

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

@@ -0,0 +1,93 @@
+import { AssetGroupBuilder } from '../../rendering/subtitle/AssetGroupBuilder';
+import { profiler } from '../../profiling/Profiler';
+/**
+ * Plans one batch: for each timestamp, finds the active prepared
+ * styles, groups timestamps by their disjoint kind sets so each
+ * rendered sprite carries only the asset payload its tiles need, and
+ * deduplicates timestamps that resolve to the same visual state into
+ * a single tile inside their group.
+ */
+export class BatchPlanner {
+    doc;
+    styles;
+    animationProbe;
+    constructor(doc, styles, animationProbe) {
+        this.doc = doc;
+        this.styles = styles;
+        this.animationProbe = animationProbe;
+    }
+    plan(timestamps) {
+        const builders = new Map();
+        const assignments = profiler.time('BatchPlanner.assignTiles', () => timestamps.map((t) => this.assignTile(t, builders)));
+        const groups = new Map();
+        for (const builder of builders.values()) {
+            groups.set(builder.assetKey, builder.build());
+        }
+        return { groups, assignments };
+    }
+    assignTile(t, builders) {
+        const items = profiler.time('BatchPlanner.itemsAt', () => this.itemsAt(t));
+        if (items.length === 0)
+            return null;
+        const assetKey = this.computeAssetKey(items);
+        let builder = builders.get(assetKey);
+        if (!builder) {
+            builder = new AssetGroupBuilder(assetKey);
+            builders.set(assetKey, builder);
+        }
+        const stateKey = profiler.time('BatchPlanner.computeStateKey', () => this.computeStateKey(items, t));
+        const tile = builder.upsertTile(stateKey, items);
+        return { assetKey, tileIndex: tile.tileIndex };
+    }
+    itemsAt(t) {
+        const items = [];
+        for (const section of this.doc.sections) {
+            const style = this.styles[section.kind];
+            if (!style)
+                continue;
+            for (let indexInSection = 0; indexInSection < section.segments.length; indexInSection++) {
+                const seg = section.segments[indexInSection];
+                if (!seg.time.contains(t))
+                    continue;
+                items.push({ seg, style, t, indexInSection });
+            }
+        }
+        items.sort((a, b) => {
+            const ds = a.seg.time.start - b.seg.time.start;
+            if (ds !== 0)
+                return ds;
+            return a.seg.time.end - b.seg.time.end;
+        });
+        return items;
+    }
+    computeAssetKey(items) {
+        const kinds = new Set();
+        for (const it of items)
+            kinds.add(it.style.kind);
+        return [...kinds].sort().join(',');
+    }
+    computeStateKey(items, t) {
+        return items.map(({ seg, style }) => {
+            const base = `${style.kind}:${seg.id}:${this.fingerprintSegmentState(seg, t)}`;
+            return this.animationProbe.isItemAnimating(style, seg, t) ? `${base}:${t.toFixed(3)}` : base;
+        }).join('|');
+    }
+    /**
+     * Captures every time-varying CSS class the segment subtree
+     * exposes (segment, lines, words) so two timestamps that resolve
+     * to the same computed style — and therefore the same rendered
+     * frame outside active animation windows — share a tile, while two
+     * timestamps with different class states stay distinct.
+     */
+    fingerprintSegmentState(seg, t) {
+        const segClasses = seg.getCssClasses(t).join(',');
+        const lineFingerprints = [...seg.lines].map((line) => this.fingerprintLineState(line, t));
+        return `${segClasses}|{${lineFingerprints.join(';')}}`;
+    }
+    fingerprintLineState(line, t) {
+        const lineClasses = line.getCssClasses(t).join(',');
+        const wordClasses = [...line.words].map((w) => w.getCssClasses(t).join(',')).join('|');
+        return `${lineClasses}[${wordClasses}]`;
+    }
+}
+//# sourceMappingURL=BatchPlanner.js.map

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

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

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

@@ -0,0 +1,36 @@
+import type { AlignmentConfig } from '../../rendering/types/AlignmentConfig';
+import type { DecorationPlacementSide } from '../../rendering/types/DecorationPlacementSide';
+import type { ElementRenderOverrides } from '../../rendering/types/ElementRenderOverrides';
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+import type { RenderingConfig } from '../../rendering/types/RenderingConfig';
+import type { SvgFilterBundle } from '../../svg-filter/SvgFilterBundle';
+import type { InlineStyleEmitter } from '../../rendering/styles/InlineStyleEmitter';
+import type { BaselineNeeds } from '../../rendering/styles/BaselineCssComposer';
+/**
+ * A `SubtitleStyle` after preparation: CSS minified, embedded, and
+ * scoped to a unique class; the probe `<style>` and probe container
+ * mounted in the host document; baseline needs computed; per-style
+ * `InlineStyleEmitter` wired to filter unused CSS custom properties
+ * from inline `style` attributes. Consumers tear the prepared style
+ * down by removing `probeStyleElement` and `probeContainer` from the
+ * document.
+ */
+export interface PreparedStyle {
+    kind: string;
+    scopedCss: string;
+    filters: SvgFilterBundle;
+    inlineStyles: InlineStyleMap;
+    alignment: AlignmentConfig;
+    rendering: RenderingConfig;
+    wordOverrides: ElementRenderOverrides;
+    segmentOverrides: ElementRenderOverrides;
+    decorationPlacements: ReadonlyMap<string, DecorationPlacementSide>;
+    addressableElementIds: ReadonlySet<string>;
+    probeStyleElement: HTMLStyleElement;
+    probeContainer: HTMLElement;
+    scopeClass: string;
+    inlineStyleEmitter: InlineStyleEmitter;
+    baselineNeeds: BaselineNeeds;
+    baselineCss: string;
+}
+//# sourceMappingURL=PreparedStyle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreparedStyle.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/PreparedStyle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAA+C,CAAC;AAEnF;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,aAAa,EAAE,sBAAsB,CAAC;IACtC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACnE,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,cAAc,EAAE,WAAW,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB"}

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

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

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

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

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

@@ -0,0 +1,31 @@
+import type { Document } from '../../document/Document';
+import type { SubtitleStyle } from '../../rendering/SubtitleFrameRenderer';
+import type { CssResourceEmbedder } from '../../css/CssResourceEmbedder';
+import type { CssScoper } from '../../css/CssScoper';
+import type { CssMinifier } from '../../css/CssMinifier';
+import type { CssVarReferenceScanner } from '../../css/CssVarReferenceScanner';
+import type { BaselineCssComposer } from '../../rendering/styles/BaselineCssComposer';
+import type { SvgFilterScoper } from '../../svg-filter/SvgFilterScoper';
+import type { SegmentPaddingCssRuleBuilder } from '../../rendering/styles/SegmentPaddingCssRuleBuilder';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/**
+ * Prepares a `SubtitleStyle` for downstream rendering: minifies and
+ * embeds the CSS, scopes it to a unique class, mounts a probe
+ * container in the host document, computes the baseline needs, and
+ * wires the per-style `InlineStyleEmitter` that filters unused CSS
+ * custom properties from inline styles.
+ */
+export declare class PreparedStyleFactory {
+    private readonly cssEmbedder;
+    private readonly cssScoper;
+    private readonly cssMinifier;
+    private readonly cssVarReferenceScanner;
+    private readonly baselineCssComposer;
+    private readonly svgFilterScoper;
+    private readonly segmentPaddingCssRuleBuilder;
+    constructor(cssEmbedder: CssResourceEmbedder, cssScoper: CssScoper, cssMinifier: CssMinifier, cssVarReferenceScanner: CssVarReferenceScanner, baselineCssComposer: BaselineCssComposer, svgFilterScoper: SvgFilterScoper, segmentPaddingCssRuleBuilder: SegmentPaddingCssRuleBuilder);
+    create(kind: string, style: SubtitleStyle, doc: Document): Promise<PreparedStyle>;
+    private prependSegmentPaddingRule;
+    private hasDecorationsForKind;
+}
+//# sourceMappingURL=PreparedStyleFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PreparedStyleFactory.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/PreparedStyleFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,+CAA+C,CAAC;AACxG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wDAAwD,CAAC;AAO3G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;gBAN5B,WAAW,EAAE,mBAAmB,EAChC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,WAAW,EACxB,sBAAsB,EAAE,sBAAsB,EAC9C,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,eAAe,EAChC,4BAA4B,EAAE,4BAA4B;IAGvE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC;IAoDvF,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,qBAAqB;CAS9B"}

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

@@ -0,0 +1,91 @@
+import { SvgFilterBundle } from '../../svg-filter/SvgFilterBundle';
+import { SvgFilterScope } from '../../svg-filter/SvgFilterScope';
+import { ElementRenderOverrides } from '../../rendering/types/ElementRenderOverrides';
+import { InlineStyleEmitter } from '../../rendering/styles/InlineStyleEmitter';
+/**
+ * Prepares a `SubtitleStyle` for downstream rendering: minifies and
+ * embeds the CSS, scopes it to a unique class, mounts a probe
+ * container in the host document, computes the baseline needs, and
+ * wires the per-style `InlineStyleEmitter` that filters unused CSS
+ * custom properties from inline styles.
+ */
+export class PreparedStyleFactory {
+    cssEmbedder;
+    cssScoper;
+    cssMinifier;
+    cssVarReferenceScanner;
+    baselineCssComposer;
+    svgFilterScoper;
+    segmentPaddingCssRuleBuilder;
+    constructor(cssEmbedder, cssScoper, cssMinifier, cssVarReferenceScanner, baselineCssComposer, svgFilterScoper, segmentPaddingCssRuleBuilder) {
+        this.cssEmbedder = cssEmbedder;
+        this.cssScoper = cssScoper;
+        this.cssMinifier = cssMinifier;
+        this.cssVarReferenceScanner = cssVarReferenceScanner;
+        this.baselineCssComposer = baselineCssComposer;
+        this.svgFilterScoper = svgFilterScoper;
+        this.segmentPaddingCssRuleBuilder = segmentPaddingCssRuleBuilder;
+    }
+    async create(kind, style, doc) {
+        const cssWithPadding = this.prependSegmentPaddingRule(style.css, style.rendering);
+        const minified = this.cssMinifier.minify(cssWithPadding);
+        const embedded = await this.cssEmbedder.embed(minified);
+        const scopeClass = `tscaps-render-${kind}-${Math.random().toString(36).slice(2, 8)}`;
+        const { css: cssWithIndirectFilters } = this.svgFilterScoper.rewriteCss(embedded);
+        const scopedCss = this.cssScoper.scope(cssWithIndirectFilters, `.${scopeClass}`);
+        const baselineNeeds = {
+            decorations: this.hasDecorationsForKind(doc, kind),
+            videoFrame: style.rendering.videoFrame.required,
+        };
+        const baselineCss = this.baselineCssComposer.compose(baselineNeeds);
+        // Probe styles live in `document.head` while a render is open;
+        // without the scopeClass guard, any `.word`/`.line`/etc on the
+        // host page would inherit them.
+        const scopedBaseline = this.cssScoper.scope(baselineCss, `.${scopeClass}`);
+        const probeStyleEl = document.createElement('style');
+        probeStyleEl.textContent = scopedBaseline + scopedCss;
+        document.head.appendChild(probeStyleEl);
+        const probeContainer = document.createElement('div');
+        probeContainer.className = scopeClass;
+        probeContainer.style.cssText = 'position:fixed;left:-99999px;visibility:hidden;pointer-events:none;';
+        document.body.appendChild(probeContainer);
+        const usedCssVars = this.cssVarReferenceScanner.scan(baselineCss + scopedCss);
+        return {
+            kind,
+            scopedCss,
+            filters: style.svgFilters ?? SvgFilterBundle.empty({
+                scopeAt: () => SvgFilterScope.empty(),
+                lengthFactorsAt: () => ({ pxPerEm: 0, pxPerCqh: 0 }),
+            }),
+            inlineStyles: style.inlineStyles,
+            alignment: style.alignment,
+            rendering: style.rendering,
+            wordOverrides: style.wordOverrides ?? ElementRenderOverrides.empty(),
+            segmentOverrides: style.segmentOverrides ?? ElementRenderOverrides.empty(),
+            decorationPlacements: style.decorationPlacements ?? new Map(),
+            addressableElementIds: style.addressableElementIds ?? new Set(),
+            probeStyleElement: probeStyleEl,
+            probeContainer,
+            scopeClass,
+            inlineStyleEmitter: new InlineStyleEmitter(usedCssVars),
+            baselineNeeds,
+            baselineCss,
+        };
+    }
+    prependSegmentPaddingRule(css, rendering) {
+        const rule = this.segmentPaddingCssRuleBuilder.build(rendering.padding);
+        return rule ? `${rule}\n${css}` : css;
+    }
+    hasDecorationsForKind(doc, kind) {
+        for (const section of doc.sections) {
+            if (section.kind !== kind)
+                continue;
+            for (const word of section.getWords()) {
+                if (word.decoration)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=PreparedStyleFactory.js.map

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

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

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

@@ -0,0 +1,13 @@
+import type { VideoFrameRegion } from '../../rendering/types/VideoFrameSource';
+/**
+ * Cache of segment paint regions keyed by `(kind, segmentId)`. Looks
+ * up an entry or computes and stores one in a single call. `clear`
+ * drops every entry.
+ */
+export declare class SegmentPaintRegionCache {
+    private readonly regionByKey;
+    getOrCompute(kind: string, segmentId: string, compute: () => VideoFrameRegion): VideoFrameRegion;
+    clear(): void;
+    private composeKey;
+}
+//# sourceMappingURL=SegmentPaintRegionCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentPaintRegionCache.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentPaintRegionCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAElF;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,GAAG,gBAAgB;IAUhG,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,UAAU;CAGnB"}

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

@@ -0,0 +1,24 @@
+/**
+ * Cache of segment paint regions keyed by `(kind, segmentId)`. Looks
+ * up an entry or computes and stores one in a single call. `clear`
+ * drops every entry.
+ */
+export class SegmentPaintRegionCache {
+    regionByKey = new Map();
+    getOrCompute(kind, segmentId, compute) {
+        const key = this.composeKey(kind, segmentId);
+        let region = this.regionByKey.get(key);
+        if (!region) {
+            region = compute();
+            this.regionByKey.set(key, region);
+        }
+        return region;
+    }
+    clear() {
+        this.regionByKey.clear();
+    }
+    composeKey(kind, segmentId) {
+        return `${kind}:${segmentId}`;
+    }
+}
+//# sourceMappingURL=SegmentPaintRegionCache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentPaintRegionCache.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentPaintRegionCache.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IACjB,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEnE,YAAY,CAAC,IAAY,EAAE,SAAiB,EAAE,OAA+B;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,UAAU,CAAC,IAAY,EAAE,SAAiB;QAChD,OAAO,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/modules/rendering/{SegmentPaintRegionResolver.d.ts → subtitle/SegmentPaintRegionResolver.d.ts}

@@ -1,4 +1,4 @@
-import type { VideoFrameRegion } from '../rendering/VideoFrameSource';
+import type { VideoFrameRegion } from '../../rendering/types/VideoFrameSource';
 /**
  * Anchor placement of a wrapper element within the viewport: the
  * absolute point its anchor edge lands on (in viewport pixels) and

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentPaintRegionResolver.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentPaintRegionResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAGlF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IAErC,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,gBAAgB;IAiBzD,OAAO,CAAC,aAAa;CAuBtB"}

package/dist/modules/rendering/{SegmentPaintRegionResolver.js → subtitle/SegmentPaintRegionResolver.js}

@@ -1,3 +1,4 @@
+import { profiler } from '../../profiling/Profiler';
 /**
  * Computes the viewport-pixel sub-rectangle a rendered segment
  * subtree paints into. The consumer supplies the HTML, the
@@ -12,11 +13,13 @@ export class SegmentPaintRegionResolver {
         host.style.cssText = `container-type: size; width: ${input.viewportWidth}px; height: ${input.viewportHeight}px;`;
         const inner = document.createElement('div');
         inner.style.cssText = 'display:inline-block;';
-        inner.innerHTML = input.segmentHtml;
-        host.appendChild(inner);
-        input.probeContainer.appendChild(host);
+        profiler.time('SegmentPaintRegionResolver.mount', () => {
+            inner.innerHTML = input.segmentHtml;
+            host.appendChild(inner);
+            input.probeContainer.appendChild(host);
+        });
         try {
-            return this.composeRegion(inner, input);
+            return profiler.time('SegmentPaintRegionResolver.measure', () => this.composeRegion(inner, input));
         }
         finally {
             input.probeContainer.removeChild(host);

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

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

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

@@ -0,0 +1,45 @@
+import type { Segment } from '../../document/Segment';
+import type { Line } from '../../document/Line';
+import type { Word } from '../../document/Word';
+import type { Decoration } from '../../document/Decoration';
+import type { ElementRenderOverrides } from '../../rendering/types/ElementRenderOverrides';
+/** A word the segment subtree pulls out of line flow because its id carries an alignment override. */
+export interface PositionedSubtreeWord {
+    readonly word: Word;
+    readonly line: Line;
+    readonly indexInLine: number;
+}
+/** A decoration the segment subtree pulls out of line flow because its id carries an alignment override. */
+export interface PositionedSubtreeDecoration {
+    readonly word: Word;
+    readonly line: Line;
+    readonly indexInLine: number;
+    readonly decoration: Decoration;
+}
+/**
+ * The breakdown of a segment into the subtrees a consumer needs to
+ * render: the words that move to their own anchor, the decorations
+ * that move to their own anchor, the set of word ids the main subtree
+ * skips, and whether every word in the segment has been positioned
+ * (in which case the main subtree is skipped entirely so its
+ * background chrome doesn't paint as an empty shell).
+ */
+export interface SegmentSubtreeDecomposition {
+    readonly positionedWords: ReadonlyArray<PositionedSubtreeWord>;
+    readonly positionedDecorations: ReadonlyArray<PositionedSubtreeDecoration>;
+    readonly excludedWordIds: ReadonlySet<string>;
+    readonly everyWordIsPositioned: boolean;
+}
+/**
+ * Pure policy: given the segment and its style's word-level alignment
+ * overrides, decides which words and decorations leave the main flow
+ * and what the main subtree must skip. Stateless, DOM-free, side-
+ * effect free.
+ */
+export declare class SegmentSubtreeDecomposer {
+    decompose(segment: Segment, wordOverrides: ElementRenderOverrides): SegmentSubtreeDecomposition;
+    private collectPositionedWords;
+    private collectPositionedDecorations;
+    private allWordsExcluded;
+}
+//# sourceMappingURL=SegmentSubtreeDecomposer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentSubtreeDecomposer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentSubtreeDecomposer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAE9F,sGAAsG;AACtG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4GAA4G;AAC5G,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC/D,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;IAC3E,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IAEnC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,sBAAsB,GAAG,2BAA2B;IAQ/F,OAAO,CAAC,sBAAsB;IAW9B,OAAO,CAAC,4BAA4B;IAapC,OAAO,CAAC,gBAAgB;CAQzB"}

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

@@ -0,0 +1,50 @@
+/**
+ * Pure policy: given the segment and its style's word-level alignment
+ * overrides, decides which words and decorations leave the main flow
+ * and what the main subtree must skip. Stateless, DOM-free, side-
+ * effect free.
+ */
+export class SegmentSubtreeDecomposer {
+    decompose(segment, wordOverrides) {
+        const positionedWords = this.collectPositionedWords(segment, wordOverrides);
+        const positionedDecorations = this.collectPositionedDecorations(segment, wordOverrides);
+        const excludedWordIds = new Set(positionedWords.map((p) => p.word.id));
+        const everyWordIsPositioned = this.allWordsExcluded(segment, excludedWordIds);
+        return { positionedWords, positionedDecorations, excludedWordIds, everyWordIsPositioned };
+    }
+    collectPositionedWords(segment, wordOverrides) {
+        const out = [];
+        for (const line of segment.lines) {
+            for (let indexInLine = 0; indexInLine < line.words.length; indexInLine++) {
+                const word = line.words[indexInLine];
+                if (wordOverrides.get(word.id)?.alignment)
+                    out.push({ word, line, indexInLine });
+            }
+        }
+        return out;
+    }
+    collectPositionedDecorations(segment, wordOverrides) {
+        const out = [];
+        for (const line of segment.lines) {
+            for (let indexInLine = 0; indexInLine < line.words.length; indexInLine++) {
+                const word = line.words[indexInLine];
+                const decoration = word.decoration;
+                if (!decoration)
+                    continue;
+                if (wordOverrides.get(decoration.id)?.alignment)
+                    out.push({ word, line, indexInLine, decoration });
+            }
+        }
+        return out;
+    }
+    allWordsExcluded(segment, excludedWordIds) {
+        for (const line of segment.lines) {
+            for (const word of line.words) {
+                if (!excludedWordIds.has(word.id))
+                    return false;
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=SegmentSubtreeDecomposer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentSubtreeDecomposer.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentSubtreeDecomposer.ts"],"names":[],"mappings":"AAoCA;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAEnC,SAAS,CAAC,OAAgB,EAAE,aAAqC;QAC/D,MAAM,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC5E,MAAM,qBAAqB,GAAG,IAAI,CAAC,4BAA4B,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACxF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC9E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC;IAC5F,CAAC;IAEO,sBAAsB,CAAC,OAAgB,EAAE,aAAqC;QACpF,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;gBACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAE,CAAC;gBACtC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,SAAS;oBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,4BAA4B,CAAC,OAAgB,EAAE,aAAqC;QAC1F,MAAM,GAAG,GAAkC,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,IAAI,WAAW,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;gBACzE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;gBACnC,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAC1B,IAAI,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,SAAS;oBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YACrG,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,gBAAgB,CAAC,OAAgB,EAAE,eAAoC;QAC7E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,OAAO,KAAK,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,108 @@
+import type { Segment } from '../../document/Segment';
+import type { Line } from '../../document/Line';
+import type { Word } from '../../document/Word';
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+import type { InlineStyleEmitter } from '../../rendering/styles/InlineStyleEmitter';
+import type { ElementRenderOverrides } from '../../rendering/types/ElementRenderOverrides';
+import type { DecorationPlacementSide } from '../../rendering/types/DecorationPlacementSide';
+import type { WordSplitter } from '../../splitting/WordSplitter';
+import type { TextDirection } from '../../bidi/TextDirection';
+import type { WordFragmenter } from '../../bidi/WordFragmenter';
+/**
+ * Per-style inputs every build call needs. `inlineStyleEmitter`
+ * encapsulates inline-style serialization so the builder stays free
+ * of CSS-variable filtering and escaping concerns.
+ */
+export interface SegmentSubtreeStyleInput {
+    readonly scopeClass: string;
+    readonly baseInlineStyles: InlineStyleMap;
+    readonly wordOverrides: ElementRenderOverrides;
+    readonly splitWordsIntoLetters: boolean;
+    readonly includeVideoFrameLayer: boolean;
+    readonly extraWrapperStyles: InlineStyleMap;
+    /** Classes appended to the `.segment` element's class list, after the structural ones. */
+    readonly extraSegmentClasses: ReadonlyArray<string>;
+    /** Decorations lifted out of line flow, keyed by decoration id. Absent ids render inline next to their host word. */
+    readonly decorationPlacements: ReadonlyMap<string, DecorationPlacementSide>;
+    readonly inlineStyleEmitter: InlineStyleEmitter;
+    /** Paragraph direction every line is resolved against. */
+    readonly textDirection: TextDirection;
+    /**
+     * Ids of elements the stylesheet addresses individually. Each such
+     * element is stamped with {@link DataAttribute.ELEMENT_ID}; the rest
+     * carry no id, because the markup is serialized once per frame and
+     * stamping everything grows it by roughly a quarter.
+     */
+    readonly addressableElementIds: ReadonlySet<string>;
+}
+/**
+ * Builds the `wrapper → segment → lines → words/letters` HTML
+ * subtree for a segment at a given time, applying the segment's
+ * classes, time-driven CSS variables, base typography styles, and
+ * per-word overrides consistently. The output is the same HTML
+ * shape every consumer embeds (an SVG `<foreignObject>`, a
+ * measurement probe, etc.).
+ *
+ * Stateless — all per-style inputs arrive on every call through
+ * {@link SegmentSubtreeStyleInput}.
+ */
+export declare class SegmentSubtreeHtmlBuilder {
+    private readonly wordSplitter;
+    private readonly wordFragmenter;
+    constructor(wordSplitter: WordSplitter, wordFragmenter: WordFragmenter);
+    /**
+     * Builds the wrapper + segment subtree containing every line and
+     * word of the segment. Words whose ids appear in `excludedWordIds`
+     * are skipped entirely — they are not rendered in the line, so
+     * neighbours reflow into the freed slot.
+     *
+     * `indexInSection` is the segment's zero-based position inside its
+     * owning section; published as `--segment-index` on the segment node.
+     */
+    buildSegmentSubtree(style: SegmentSubtreeStyleInput, seg: Segment, t: number, excludedWordIds: ReadonlySet<string>, indexInSection: number): string;
+    /**
+     * Builds the wrapper + segment subtree containing a single
+     * line-and-word chain around `word`. Used for synthesizing the
+     * minimum context a word needs when it has been promoted out of
+     * the main flow by a per-word alignment override.
+     *
+     * `indexInSection` / `indexInLine` keep the published timing /
+     * structural variables (`--segment-index`, `--word-index`) consistent
+     * with the original tree position.
+     */
+    buildSingleWordSubtree(style: SegmentSubtreeStyleInput, seg: Segment, line: Line, word: Word, t: number, indexInSection: number, indexInLine: number): string;
+    /**
+     * Builds the wrapper + segment subtree containing only the
+     * decoration glyph attached to `word`. Used when a per-decoration
+     * alignment override paints the glyph at its own anchor instead of
+     * inline next to its host word.
+     */
+    buildSingleDecorationSubtree(style: SegmentSubtreeStyleInput, seg: Segment, line: Line, word: Word, t: number, indexInSection: number): string;
+    private wrapInScope;
+    private composeWrapperStyle;
+    private composeSegmentHtml;
+    private buildLineWrapperHtml;
+    private buildLineHtml;
+    /**
+     * Emits the words of one line as `<span>`s already ordered the way they
+     * paint. The words are fragmented together rather than one at a time,
+     * because the direction the algorithm resolves for a word depends on
+     * the words beside it.
+     */
+    private buildWordsHtml;
+    private buildGapStyle;
+    private maybeVideoFrameLayerHtml;
+    private buildWordFragmentHtml;
+    private buildDirectionStyle;
+    private shouldEmitInlineDecoration;
+    private buildPromotedDecorationsContainerHtml;
+    private collectPromotedDecorationsHtml;
+    private buildDecorationSpanHtml;
+    /**
+     * The id attribute for an element the stylesheet addresses, or an
+     * empty string for one it does not.
+     */
+    private elementIdAttr;
+    private escapeHtml;
+}
+//# sourceMappingURL=SegmentSubtreeHtmlBuilder.d.ts.map