@tscaps/engine 0.1.1 → 0.2.1

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,
+            behindActor: style.rendering.behindActor.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(),
+            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;AAElF;;;;;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;IAezD,OAAO,CAAC,aAAa;CAuBtB"}

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":"AA+BA;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA0B;IAErC,OAAO,CAAC,KAA8B;QACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,gCAAgC,KAAK,CAAC,aAAa,eAAe,KAAK,CAAC,cAAc,KAAK,CAAC;QACjH,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC5C,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAC;QAC9C,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,IAAiB,EAAE,KAA8B;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAgC,CAAC;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,iBAAgC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC,aAAa,CAAC;QAElD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,GAAG,CAAC;QACjG,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,GAAG,GAAG,CAAC;QACjG,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC;QACvD,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC;QAEpD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC;QACvG,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC;QACzG,OAAO;YACL,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,GAAG;YACN,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;SAClC,CAAC;IACJ,CAAC;CACF"}

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,80 @@
+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';
+/**
+ * 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;
+    /** 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;
+}
+/**
+ * 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;
+    constructor(wordSplitter: WordSplitter);
+    /**
+     * 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;
+    private maybeVideoFrameLayerHtml;
+    private buildWordHtml;
+    private shouldEmitInlineDecoration;
+    private buildPromotedDecorationsContainerHtml;
+    private collectPromotedDecorationsHtml;
+    private buildDecorationSpanHtml;
+    private escapeHtml;
+}
+//# sourceMappingURL=SegmentSubtreeHtmlBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentSubtreeHtmlBuilder.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentSubtreeHtmlBuilder.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;AAKnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kDAAkD,CAAC;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAMpE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,cAAc,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,cAAc,CAAC;IAC5C,qHAAqH;IACrH,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAC5E,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,yBAAyB;IAExB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEvD;;;;;;;;OAQG;IACH,mBAAmB,CACjB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,OAAO,EACZ,CAAC,EAAE,MAAM,EACT,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,EACpC,cAAc,EAAE,MAAM,GACrB,MAAM;IAWT;;;;;;;;;OASG;IACH,sBAAsB,CACpB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,CAAC,EAAE,MAAM,EACT,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM;IAQT;;;;;OAKG;IACH,4BAA4B,CAC1B,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,CAAC,EAAE,MAAM,EACT,cAAc,EAAE,MAAM,GACrB,MAAM;IAQT,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,qCAAqC;IAc7C,OAAO,CAAC,8BAA8B;IAuBtC,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,UAAU;CAGnB"}

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

@@ -0,0 +1,188 @@
+import { Decoration } from '../../document/Decoration';
+import { CssVariable } from '../../document/CssVariable';
+import { Letter } from '../../document/Letter';
+import { VIDEO_FRAME_LAYER_CLASS } from '../../rendering/styles/VideoFrameLayerClass';
+const SEGMENT_DECORATIONS_ABOVE_CLASS = 'segment-decorations-above';
+const SEGMENT_DECORATIONS_BELOW_CLASS = 'segment-decorations-below';
+/**
+ * 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 class SegmentSubtreeHtmlBuilder {
+    wordSplitter;
+    constructor(wordSplitter) {
+        this.wordSplitter = wordSplitter;
+    }
+    /**
+     * 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, seg, t, excludedWordIds, indexInSection) {
+        const segTime = seg.time;
+        const linesHtml = [...seg.lines]
+            .map((line) => this.buildLineHtml(style, line, t, excludedWordIds, segTime))
+            .join('');
+        const aboveHtml = this.buildPromotedDecorationsContainerHtml(style, seg, t, 'above', segTime);
+        const belowHtml = this.buildPromotedDecorationsContainerHtml(style, seg, t, 'below', segTime);
+        const innerHtml = this.maybeVideoFrameLayerHtml(style) + aboveHtml + linesHtml + belowHtml;
+        return this.wrapInScope(style, seg, t, indexInSection, innerHtml);
+    }
+    /**
+     * 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, seg, line, word, t, indexInSection, indexInLine) {
+        const segTime = seg.time;
+        const wordHtml = this.buildWordHtml(style, word, t, segTime, indexInLine);
+        const lineHtml = this.buildLineWrapperHtml(style, line, t, segTime, wordHtml);
+        const innerHtml = this.maybeVideoFrameLayerHtml(style) + lineHtml;
+        return this.wrapInScope(style, seg, t, indexInSection, innerHtml);
+    }
+    /**
+     * 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, seg, line, word, t, indexInSection) {
+        const segTime = seg.time;
+        const decorationHtml = this.buildDecorationSpanHtml(style, word.decoration, t, segTime, word.time);
+        const lineHtml = this.buildLineWrapperHtml(style, line, t, segTime, decorationHtml);
+        const innerHtml = this.maybeVideoFrameLayerHtml(style) + lineHtml;
+        return this.wrapInScope(style, seg, t, indexInSection, innerHtml);
+    }
+    wrapInScope(style, seg, t, indexInSection, innerHtml) {
+        const wrapperStyle = this.composeWrapperStyle(style);
+        const segHtml = this.composeSegmentHtml(style, seg, t, indexInSection, innerHtml);
+        return `<div class="${style.scopeClass}" style="${wrapperStyle}">${segHtml}</div>`;
+    }
+    composeWrapperStyle(style) {
+        const merged = { ...style.baseInlineStyles, ...style.extraWrapperStyles };
+        const inlineStyleString = style.inlineStyleEmitter.serializeStyles(merged);
+        return `display: inline-block; width: max-content; min-width: 0; min-height: 0; ${inlineStyleString}`;
+    }
+    composeSegmentHtml(style, seg, t, indexInSection, innerHtml) {
+        const classes = seg.getCssClasses(t).join(' ');
+        const segStyle = style.inlineStyleEmitter.serializeAnimatedVars(seg.getCssVariables(t, { indexInSection }));
+        return `<div class="${classes}" style="${segStyle}">${innerHtml}</div>`;
+    }
+    buildLineWrapperHtml(style, line, t, segTime, innerHtml) {
+        const classes = line.getCssClasses(t).join(' ');
+        const lineStyle = style.inlineStyleEmitter.serializeAnimatedVars(line.getCssVariables(t, { segTime }));
+        return `<div class="${classes}" style="${lineStyle}">${innerHtml}</div>`;
+    }
+    buildLineHtml(style, line, t, excludedWordIds, segTime) {
+        const visibleWords = [];
+        for (let i = 0; i < line.words.length; i++) {
+            const word = line.words[i];
+            if (excludedWordIds.has(word.id))
+                continue;
+            visibleWords.push({ word, indexInLine: i });
+        }
+        // A line with no remaining words is omitted entirely — emitting an
+        // empty `<div class="line">` would still paint line-level
+        // decorations (bubble backgrounds, tails, sibling-combinator gaps)
+        // with no content to anchor them.
+        if (visibleWords.length === 0)
+            return '';
+        const wordsHtml = visibleWords
+            .map(({ word, indexInLine }) => this.buildWordHtml(style, word, t, segTime, indexInLine))
+            .join('');
+        return this.buildLineWrapperHtml(style, line, t, segTime, wordsHtml);
+    }
+    // Lives inside `.segment` so the segment's own clipping and
+    // stacking context apply to the layer the same way they apply
+    // to any other child.
+    maybeVideoFrameLayerHtml(style) {
+        return style.includeVideoFrameLayer
+            ? `<div class="${VIDEO_FRAME_LAYER_CLASS}"></div>`
+            : '';
+    }
+    buildWordHtml(style, word, t, segTime, indexInLine) {
+        const wordClasses = word.getCssClasses(t);
+        const wordVars = word.getCssVariables(t, { segTime, indexInLine });
+        const overrideStyle = style.inlineStyleEmitter.serializeStyles(style.wordOverrides.get(word.id)?.inlineStyles);
+        const decorationHtml = this.shouldEmitInlineDecoration(style, word)
+            ? this.buildDecorationSpanHtml(style, word.decoration, t, segTime, word.time)
+            : '';
+        const trailHtml = word.decoration ? this.escapeHtml(word.decoration.trail) : '';
+        if (!style.splitWordsIntoLetters) {
+            const wordStyle = style.inlineStyleEmitter.serializeAnimatedVars(wordVars) + overrideStyle;
+            return `<span class="${wordClasses.join(' ')}" style="${wordStyle}">${this.escapeHtml(word.displayText)}${decorationHtml}${trailHtml}</span>`;
+        }
+        const letters = this.wordSplitter.split(word.displayText);
+        const wordStyle = style.inlineStyleEmitter.serializeAnimatedVars({ ...wordVars, [CssVariable.LETTER_COUNT]: String(letters.length) }) + overrideStyle;
+        const lettersHtml = letters.map((letter, i) => {
+            const letterStyle = style.inlineStyleEmitter.serializeAnimatedVars({ [CssVariable.LETTER_INDEX]: String(i) });
+            return `<span class="${Letter.CSS_CLASS}" style="${letterStyle}">${this.escapeHtml(letter)}</span>`;
+        }).join('');
+        return `<span class="${wordClasses.join(' ')}" style="${wordStyle}">${lettersHtml}${decorationHtml}${trailHtml}</span>`;
+    }
+    shouldEmitInlineDecoration(style, word) {
+        if (!word.decoration)
+            return false;
+        const decorationId = word.decoration.id;
+        if (style.wordOverrides.get(decorationId)?.alignment)
+            return false;
+        if (style.decorationPlacements.has(decorationId))
+            return false;
+        return true;
+    }
+    buildPromotedDecorationsContainerHtml(style, seg, t, side, segTime) {
+        if (style.decorationPlacements.size === 0)
+            return '';
+        const decorationsHtml = this.collectPromotedDecorationsHtml(style, seg, t, side, segTime);
+        if (!decorationsHtml)
+            return '';
+        const containerClass = side === 'above' ? SEGMENT_DECORATIONS_ABOVE_CLASS : SEGMENT_DECORATIONS_BELOW_CLASS;
+        return `<div class="${containerClass}">${decorationsHtml}</div>`;
+    }
+    collectPromotedDecorationsHtml(style, seg, t, side, segTime) {
+        let html = '';
+        for (const line of seg.lines) {
+            for (const word of line.words) {
+                if (!word.decoration)
+                    continue;
+                const decorationId = word.decoration.id;
+                if (style.decorationPlacements.get(decorationId) !== side)
+                    continue;
+                // A manual alignment override takes the decoration out of the
+                // segment subtree entirely — the caller paints it at its own
+                // anchor, so the segment-side container must skip it too.
+                if (style.wordOverrides.get(decorationId)?.alignment)
+                    continue;
+                html += this.buildDecorationSpanHtml(style, word.decoration, t, segTime, word.time);
+            }
+        }
+        return html;
+    }
+    buildDecorationSpanHtml(style, decoration, t, segTime, wordTime) {
+        if (!decoration)
+            return '';
+        const overrideStyle = style.inlineStyleEmitter.serializeStyles(style.wordOverrides.get(decoration.id)?.inlineStyles);
+        const animatedVars = style.inlineStyleEmitter.serializeAnimatedVars(decoration.getCssVariables(t, { segTime, wordTime }));
+        return `<span class="${Decoration.CSS_CLASS}" style="${animatedVars}${overrideStyle}">${this.escapeHtml(decoration.glyph)}</span>`;
+    }
+    escapeHtml(text) {
+        return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    }
+}
+//# sourceMappingURL=SegmentSubtreeHtmlBuilder.js.map

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

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

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

@@ -0,0 +1,45 @@
+import type { Segment } from '../../document/Segment';
+import type { SegmentSubtreeHtmlBuilder } from '../../rendering/subtitle/SegmentSubtreeHtmlBuilder';
+import type { VideoFrameVarsBuilder } from '../../rendering/subtitle/VideoFrameVarsBuilder';
+import type { SvgFilterMaterializer } from '../../rendering/subtitle/SvgFilterMaterializer';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+import type { SegmentSubtreeDecomposer } from '../../rendering/subtitle/SegmentSubtreeDecomposer';
+export interface WrapperRender {
+    html: string;
+    defs: string;
+}
+/**
+ * Builds the HTML wrapper for one render tile. Handles three subtree
+ * shapes: the main segment subtree, a sibling subtree for a per-word
+ * alignment override that pulls the word out of line flow, and a
+ * sibling subtree for a decoration-only override that pins the glyph
+ * at its own anchor. Each subtree carries its own anchor; the
+ * positioned siblings appear after the main wrapper, with their
+ * original slot in the line omitted so neighbours reflow. Aggregates
+ * the SVG `<filter>` defs each subtree needs into the tile's `defs`.
+ */
+export declare class SegmentWrapperRenderer {
+    private readonly subtreeBuilder;
+    private readonly subtreeDecomposer;
+    private readonly filterMaterializer;
+    private readonly videoFrameVarsBuilder;
+    private readonly width;
+    private readonly height;
+    constructor(subtreeBuilder: SegmentSubtreeHtmlBuilder, subtreeDecomposer: SegmentSubtreeDecomposer, filterMaterializer: SvgFilterMaterializer, videoFrameVarsBuilder: VideoFrameVarsBuilder, width: number, height: number);
+    buildWrapperHtml(style: PreparedStyle, seg: Segment, t: number, indexInSection: number, nextUid: () => number): Promise<WrapperRender>;
+    /**
+     * The positioned siblings pin an element at its own explicit anchor,
+     * so the text-behind-actor state variables stay off their wrapper —
+     * a style rule reacting to the state (e.g. a lift) would displace
+     * the element from the exact spot it was pinned to.
+     */
+    private withoutBehindActorState;
+    private buildSegmentSubtreeHtml;
+    private buildPositionedWordSubtreeHtml;
+    private buildPositionedDecorationSubtreeHtml;
+    private composeAnchorStyle;
+    private composeStyleInput;
+    private mergeExtras;
+    private resolveAlignment;
+}
+//# sourceMappingURL=SegmentWrapperRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentWrapperRenderer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SegmentWrapperRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD,OAAO,KAAK,EAAE,yBAAyB,EAA4B,MAAM,uDAAuD,CAAC;AACjI,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAGV,wBAAwB,EACzB,MAAM,sDAAsD,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAWD;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IAG/B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBALN,cAAc,EAAE,yBAAyB,EACzC,iBAAiB,EAAE,wBAAwB,EAC3C,kBAAkB,EAAE,qBAAqB,EACzC,qBAAqB,EAAE,qBAAqB,EAC5C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAG3B,gBAAgB,CACpB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,OAAO,EACZ,CAAC,EAAE,MAAM,EACT,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,MAAM,GACpB,OAAO,CAAC,aAAa,CAAC;IA8CzB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;YAYjB,uBAAuB;YAqBvB,8BAA8B;YAuB9B,oCAAoC;IA2BlD,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;CAUzB"}