@tscaps/engine 0.1.1 → 0.3.0

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":"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"}

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

@@ -0,0 +1,246 @@
+import { Decoration } from '../../document/Decoration';
+import { CssVariable } from '../../document/CssVariable';
+import { Letter } from '../../document/Letter';
+import { CssClass } from '../../document/CssClass';
+import { DataAttribute } from '../../document/DataAttribute';
+// Words are emitted already ordered as they paint, so the line must lay its
+// children out left to right no matter what direction it would inherit —
+// an inherited `rtl` would reverse an order that is already final.
+const LINE_LAYOUT_STYLE = 'direction: ltr; ';
+/**
+ * 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;
+    wordFragmenter;
+    constructor(wordSplitter, wordFragmenter) {
+        this.wordSplitter = wordSplitter;
+        this.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, 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.buildWordsHtml(style, [{ word, indexInLine }], t, segTime);
+        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}`;
+    }
+    // The extra classes ride the segment element, not the scope wrapper:
+    // scoped stylesheets prefix every selector with the scope class as an
+    // ancestor, so a class sharing the wrapper node would be unreachable
+    // from them.
+    composeSegmentHtml(style, seg, t, indexInSection, innerHtml) {
+        const classes = [...seg.getCssClasses(t), ...style.extraSegmentClasses].join(' ');
+        const segStyle = style.inlineStyleEmitter.serializeStyles(seg.getCssVariables(t, { indexInSection }));
+        return `<div class="${classes}" style="${segStyle}"${this.elementIdAttr(style, seg.id)}>${innerHtml}</div>`;
+    }
+    buildLineWrapperHtml(style, line, t, segTime, innerHtml) {
+        const classes = line.getCssClasses(t).join(' ');
+        const lineStyle = LINE_LAYOUT_STYLE
+            + style.inlineStyleEmitter.serializeStyles(line.getCssVariables(t, { segTime }));
+        return `<div class="${classes}" style="${lineStyle}"${this.elementIdAttr(style, line.id)}>${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 = this.buildWordsHtml(style, visibleWords, t, segTime);
+        return this.buildLineWrapperHtml(style, line, t, segTime, wordsHtml);
+    }
+    /**
+     * 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.
+     */
+    buildWordsHtml(style, visibleWords, t, segTime) {
+        const fragments = this.wordFragmenter.fragment(visibleWords.map(({ word }) => word.displayText), style.textDirection);
+        return fragments
+            .map((fragment, index) => this.buildWordFragmentHtml(style, {
+            fragment,
+            word: visibleWords[fragment.wordIndex].word,
+            indexInLine: visibleWords[fragment.wordIndex].indexInLine,
+            gapStyle: this.buildGapStyle(fragments, index),
+        }, t, segTime))
+            .join('');
+    }
+    // Two fragments that read as one uninterrupted stretch must not be pushed
+    // apart by the per-word margin templates set for the spaces between words.
+    buildGapStyle(fragments, index) {
+        let style = '';
+        if (fragments[index].joinedToPrevious)
+            style += 'margin-left: 0; ';
+        if (fragments[index + 1]?.joinedToPrevious)
+            style += 'margin-right: 0; ';
+        return style;
+    }
+    // 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="${CssClass.VIDEO_FRAME_LAYER}"></div>`
+            : '';
+    }
+    buildWordFragmentHtml(style, input, t, segTime) {
+        const { fragment, word, indexInLine } = input;
+        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 = fragment.carriesWordTail && this.shouldEmitInlineDecoration(style, word)
+            ? this.buildDecorationSpanHtml(style, word.decoration, t, segTime, word.time)
+            : '';
+        const trailHtml = fragment.carriesWordTail && word.decoration ? this.escapeHtml(word.decoration.trail) : '';
+        const fragmentStyle = this.buildDirectionStyle(fragment) + input.gapStyle;
+        // Every painted fragment of a word carries the word's id: a word split
+        // across two embedding levels is two elements and one word, and a rule
+        // addressing it means all of it.
+        const wordIdAttr = this.elementIdAttr(style, word.id);
+        // Letters of a joining script take their shape from their neighbours, so
+        // painting them one box at a time would leave the word disconnected.
+        if (!style.splitWordsIntoLetters || fragment.charactersJoin) {
+            const wordStyle = style.inlineStyleEmitter.serializeStyles(wordVars) + overrideStyle + fragmentStyle;
+            return `<span class="${wordClasses.join(' ')}" style="${wordStyle}"${wordIdAttr}>${this.escapeHtml(fragment.text)}${decorationHtml}${trailHtml}</span>`;
+        }
+        const letters = this.wordSplitter.split(fragment.text);
+        const wordStyle = style.inlineStyleEmitter.serializeStyles({ ...wordVars, [CssVariable.LETTER_COUNT]: String(letters.length) }) + overrideStyle + fragmentStyle;
+        const lettersHtml = letters.map((letter, i) => {
+            const letterStyle = style.inlineStyleEmitter.serializeStyles({ [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}"${wordIdAttr}>${lettersHtml}${decorationHtml}${trailHtml}</span>`;
+    }
+    // Only a fragment reading against the line's left-to-right flow has to say
+    // so; the rest inherit it, and spelling it out would add bytes to every
+    // word of every frame.
+    buildDirectionStyle(fragment) {
+        return fragment.direction === 'rtl' ? 'direction: rtl; ' : '';
+    }
+    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' ? CssClass.SEGMENT_DECORATIONS_ABOVE : CssClass.SEGMENT_DECORATIONS_BELOW;
+        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.serializeStyles(decoration.getCssVariables(t, { segTime, wordTime }));
+        return `<span class="${Decoration.CSS_CLASS}" style="${animatedVars}${overrideStyle}"${this.elementIdAttr(style, decoration.id)}>${this.escapeHtml(decoration.glyph)}</span>`;
+    }
+    /**
+     * The id attribute for an element the stylesheet addresses, or an
+     * empty string for one it does not.
+     */
+    elementIdAttr(style, id) {
+        if (!style.addressableElementIds.has(id))
+            return '';
+        return ` ${DataAttribute.ELEMENT_ID}="${this.escapeHtml(id)}"`;
+    }
+    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,40 @@
+import type { Segment } from '../../document/Segment';
+import type { HorizontalPlacementResolver } from '../../rendering/HorizontalPlacementResolver';
+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 horizontalPlacementResolver;
+    private readonly width;
+    private readonly height;
+    constructor(subtreeBuilder: SegmentSubtreeHtmlBuilder, subtreeDecomposer: SegmentSubtreeDecomposer, filterMaterializer: SvgFilterMaterializer, videoFrameVarsBuilder: VideoFrameVarsBuilder, horizontalPlacementResolver: HorizontalPlacementResolver, width: number, height: number);
+    buildWrapperHtml(style: PreparedStyle, seg: Segment, t: number, indexInSection: number, nextUid: () => number): Promise<WrapperRender>;
+    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;AAGzD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAElG,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;AAG9D,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,2BAA2B;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBANN,cAAc,EAAE,yBAAyB,EACzC,iBAAiB,EAAE,wBAAwB,EAC3C,kBAAkB,EAAE,qBAAqB,EACzC,qBAAqB,EAAE,qBAAqB,EAC5C,2BAA2B,EAAE,2BAA2B,EACxD,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;YA8CX,uBAAuB;YA0BvB,8BAA8B;YA2B9B,oCAAoC;IA+BlD,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;CAezB"}

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

@@ -0,0 +1,132 @@
+import { profiler } from '../../profiling/Profiler';
+/**
+ * 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 class SegmentWrapperRenderer {
+    subtreeBuilder;
+    subtreeDecomposer;
+    filterMaterializer;
+    videoFrameVarsBuilder;
+    horizontalPlacementResolver;
+    width;
+    height;
+    constructor(subtreeBuilder, subtreeDecomposer, filterMaterializer, videoFrameVarsBuilder, horizontalPlacementResolver, width, height) {
+        this.subtreeBuilder = subtreeBuilder;
+        this.subtreeDecomposer = subtreeDecomposer;
+        this.filterMaterializer = filterMaterializer;
+        this.videoFrameVarsBuilder = videoFrameVarsBuilder;
+        this.horizontalPlacementResolver = horizontalPlacementResolver;
+        this.width = width;
+        this.height = height;
+    }
+    async buildWrapperHtml(style, seg, t, indexInSection, nextUid) {
+        const segmentOverride = style.segmentOverrides.get(seg.id);
+        const segmentAlignment = { ...style.alignment, ...segmentOverride?.alignment };
+        const segmentInlineStylesOverride = segmentOverride?.inlineStyles;
+        const baseInlineStyles = segmentInlineStylesOverride
+            ? { ...style.inlineStyles, ...segmentInlineStylesOverride }
+            : style.inlineStyles;
+        const segmentClasses = segmentOverride?.classes ?? [];
+        const decomposition = this.subtreeDecomposer.decompose(seg, style.wordOverrides);
+        // Skip the main segment subtree entirely when every word has been
+        // pulled into a positioned-word sibling — otherwise the segment's
+        // own decorations (background, ::before chrome, padding) would
+        // paint as an empty shell. Positioned words render below regardless.
+        let html = '';
+        let defs = '';
+        if (!decomposition.everyWordIsPositioned) {
+            const main = await this.buildSegmentSubtreeHtml(style, seg, t, indexInSection, segmentAlignment, baseInlineStyles, segmentClasses, decomposition.excludedWordIds, nextUid);
+            html = main.html;
+            defs = main.defs;
+        }
+        for (const positioned of decomposition.positionedWords) {
+            const wordAlignmentOverride = style.wordOverrides.get(positioned.word.id)?.alignment;
+            const wordAlignment = { ...segmentAlignment, ...wordAlignmentOverride };
+            const built = await this.buildPositionedWordSubtreeHtml(style, seg, positioned, t, indexInSection, wordAlignment, baseInlineStyles, nextUid);
+            html += built.html;
+            defs += built.defs;
+        }
+        for (const positioned of decomposition.positionedDecorations) {
+            const decorationAlignmentOverride = style.wordOverrides.get(positioned.decoration.id)?.alignment;
+            const decorationAlignment = { ...segmentAlignment, ...decorationAlignmentOverride };
+            const built = await this.buildPositionedDecorationSubtreeHtml(style, seg, positioned, t, indexInSection, decorationAlignment, baseInlineStyles, nextUid);
+            html += built.html;
+            defs += built.defs;
+        }
+        return { html, defs };
+    }
+    async buildSegmentSubtreeHtml(style, seg, t, indexInSection, alignment, baseInlineStyles, segmentClasses, excludedWordIds, nextUid) {
+        const resolved = this.resolveAlignment(alignment, style.rendering.textDirection);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = profiler.time('SegmentWrapperRenderer.filterDefs', () => this.filterMaterializer.materialize(style, t, engineVars, nextUid));
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles), segmentClasses);
+        const subtreeHtml = profiler.time('SegmentWrapperRenderer.subtreeHtml', () => this.subtreeBuilder.buildSegmentSubtree(styleInput, seg, t, excludedWordIds, indexInSection));
+        const anchorStyle = this.composeAnchorStyle(resolved);
+        return { html: `<div style="${anchorStyle}">${subtreeHtml}</div>`, defs };
+    }
+    async buildPositionedWordSubtreeHtml(style, seg, positioned, t, indexInSection, alignment, baseInlineStyles, nextUid) {
+        const resolved = this.resolveAlignment(alignment, style.rendering.textDirection);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = profiler.time('SegmentWrapperRenderer.filterDefs', () => this.filterMaterializer.materialize(style, t, engineVars, nextUid));
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles));
+        const subtreeHtml = profiler.time('SegmentWrapperRenderer.subtreeHtml', () => this.subtreeBuilder.buildSingleWordSubtree(styleInput, seg, positioned.line, positioned.word, t, indexInSection, positioned.indexInLine));
+        const anchorStyle = this.composeAnchorStyle(resolved);
+        return { html: `<div style="${anchorStyle}">${subtreeHtml}</div>`, defs };
+    }
+    async buildPositionedDecorationSubtreeHtml(style, seg, positioned, t, indexInSection, alignment, baseInlineStyles, nextUid) {
+        const resolved = this.resolveAlignment(alignment, style.rendering.textDirection);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = profiler.time('SegmentWrapperRenderer.filterDefs', () => this.filterMaterializer.materialize(style, t, engineVars, nextUid));
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles));
+        const subtreeHtml = profiler.time('SegmentWrapperRenderer.subtreeHtml', () => this.subtreeBuilder.buildSingleDecorationSubtree(styleInput, seg, positioned.line, positioned.word, t, indexInSection));
+        const anchorStyle = this.composeAnchorStyle(resolved);
+        return { html: `<div style="${anchorStyle}">${subtreeHtml}</div>`, defs };
+    }
+    // Zero-sized grid anchor places the wrapper via `place-items`
+    // so the wrapper stays transform-free and doesn't form a
+    // stacking context (which would trap descendant
+    // `mix-blend-mode` away from the layer).
+    composeAnchorStyle(resolved) {
+        return `position: absolute; top: ${resolved.yPx}px; left: ${resolved.xPx}px; width: 0; height: 0; display: grid; grid-template: 0 / 0; align-items: ${resolved.vGridAlign}; justify-items: ${resolved.hGridAlign};`;
+    }
+    // Positioned sibling subtrees never receive segment classes: they pin
+    // an element at its own explicit anchor, and a style rule reacting to
+    // segment state (e.g. a lift) would displace it from that spot.
+    composeStyleInput(style, extraWrapperStyles, extraSegmentClasses = []) {
+        return {
+            scopeClass: style.scopeClass,
+            baseInlineStyles: style.inlineStyles,
+            wordOverrides: style.wordOverrides,
+            splitWordsIntoLetters: style.rendering.splitWordsIntoLetters,
+            includeVideoFrameLayer: style.rendering.videoFrame.required,
+            textDirection: style.rendering.textDirection,
+            extraWrapperStyles,
+            extraSegmentClasses,
+            decorationPlacements: style.decorationPlacements,
+            addressableElementIds: style.addressableElementIds,
+            inlineStyleEmitter: style.inlineStyleEmitter,
+        };
+    }
+    mergeExtras(engineVars, bindings, baseInlineStyles) {
+        return { ...baseInlineStyles, ...engineVars, ...Object.fromEntries(bindings) };
+    }
+    resolveAlignment(alignment, textDirection) {
+        const horizontal = this.horizontalPlacementResolver.resolve(alignment.horizontalAlign, alignment.horizontalOffset, textDirection);
+        return {
+            yPx: Math.round(alignment.verticalOffset * this.height),
+            xPx: Math.round(horizontal.offsetFromLeft * this.width),
+            vAnchorPct: alignment.verticalAlign === 'top' ? 0 : alignment.verticalAlign === 'center' ? 50 : 100,
+            hAnchorPct: horizontal.side === 'left' ? 0 : horizontal.side === 'center' ? 50 : 100,
+            vGridAlign: alignment.verticalAlign === 'top' ? 'start' : alignment.verticalAlign === 'center' ? 'center' : 'end',
+            hGridAlign: horizontal.side === 'left' ? 'start' : horizontal.side === 'center' ? 'center' : 'end',
+        };
+    }
+}
+//# sourceMappingURL=SegmentWrapperRenderer.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { SubtitleFrame } from '../../rendering/SubtitleFrameRenderer';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+import type { BaselineCssComposer } from '../../rendering/styles/BaselineCssComposer';
+import type { SegmentWrapperRenderer } from '../../rendering/subtitle/SegmentWrapperRenderer';
+import type { AssetGroup, TileAssignment } from '../../rendering/subtitle/BatchPlan';
+/**
+ * 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 declare class SpriteSheetCompositor {
+    private readonly styles;
+    private readonly wrapperRenderer;
+    private readonly baselineCssComposer;
+    private readonly width;
+    private readonly height;
+    constructor(styles: Readonly<Record<string, PreparedStyle>>, wrapperRenderer: SegmentWrapperRenderer, baselineCssComposer: BaselineCssComposer, width: number, height: number);
+    renderGroups(groups: ReadonlyMap<string, AssetGroup>): Promise<Map<string, HTMLImageElement>>;
+    buildFrames(assignments: ReadonlyArray<TileAssignment | null>, sprites: ReadonlyMap<string, HTMLImageElement>): Array<SubtitleFrame | null>;
+    private renderSpriteSheet;
+    private buildTiles;
+    private composeStyleSheet;
+    /**
+     * 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. */
+    private composeStyleBlock;
+    private buildTileHtml;
+    private composeBaselineCssForKinds;
+    private collectActiveKinds;
+    private joinByKind;
+    private decodeSvg;
+    /**
+     * 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.).
+     */
+    private extractXmlParseError;
+}
+//# sourceMappingURL=SpriteSheetCompositor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSheetCompositor.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SpriteSheetCompositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAc,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAQpG;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJN,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,eAAe,EAAE,sBAAsB,EACvC,mBAAmB,EAAE,mBAAmB,EACxC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAG3B,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IASnG,WAAW,CACT,WAAW,EAAE,aAAa,CAAC,cAAc,GAAG,IAAI,CAAC,EACjD,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;YAchB,iBAAiB;YAiBjB,UAAU;IAWxB,OAAO,CAAC,iBAAiB;IAOzB;;;;;;uCAMmC;IACnC,OAAO,CAAC,iBAAiB;YAKX,aAAa;IAiB3B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,UAAU;YAIJ,SAAS;IA4BvB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAK7B"}