@tscaps/engine 0.1.1 → 0.2.1

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

@@ -0,0 +1,141 @@
+import { CssVariable } from '../../document/CssVariable';
+/**
+ * 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;
+    width;
+    height;
+    constructor(subtreeBuilder, subtreeDecomposer, filterMaterializer, videoFrameVarsBuilder, width, height) {
+        this.subtreeBuilder = subtreeBuilder;
+        this.subtreeDecomposer = subtreeDecomposer;
+        this.filterMaterializer = filterMaterializer;
+        this.videoFrameVarsBuilder = videoFrameVarsBuilder;
+        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 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, decomposition.excludedWordIds, nextUid);
+            html = main.html;
+            defs = main.defs;
+        }
+        const positionedInlineStyles = this.withoutBehindActorState(baseInlineStyles);
+        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, positionedInlineStyles, 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, positionedInlineStyles, nextUid);
+            html += built.html;
+            defs += built.defs;
+        }
+        return { html, defs };
+    }
+    /**
+     * 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.
+     */
+    withoutBehindActorState(styles) {
+        if (!(CssVariable.BEHIND_ACTOR_SCENE_VALID in styles) && !(CssVariable.BEHIND_ACTOR_FORCED in styles)) {
+            return styles;
+        }
+        const rest = {};
+        for (const [key, value] of Object.entries(styles)) {
+            if (key === CssVariable.BEHIND_ACTOR_SCENE_VALID || key === CssVariable.BEHIND_ACTOR_FORCED)
+                continue;
+            rest[key] = value;
+        }
+        return rest;
+    }
+    async buildSegmentSubtreeHtml(style, seg, t, indexInSection, alignment, baseInlineStyles, excludedWordIds, nextUid) {
+        const resolved = this.resolveAlignment(alignment);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = this.filterMaterializer.materialize(style, t, engineVars, nextUid);
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles));
+        const 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);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = this.filterMaterializer.materialize(style, t, engineVars, nextUid);
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles));
+        const 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);
+        const engineVars = await this.videoFrameVarsBuilder.build(style, seg, resolved, t);
+        const { defs, bindings } = this.filterMaterializer.materialize(style, t, engineVars, nextUid);
+        const styleInput = this.composeStyleInput(style, this.mergeExtras(engineVars, bindings, baseInlineStyles));
+        const 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};`;
+    }
+    composeStyleInput(style, extraWrapperStyles) {
+        return {
+            scopeClass: style.scopeClass,
+            baseInlineStyles: style.inlineStyles,
+            wordOverrides: style.wordOverrides,
+            splitWordsIntoLetters: style.rendering.splitWordsIntoLetters,
+            includeVideoFrameLayer: style.rendering.videoFrame.required,
+            extraWrapperStyles,
+            decorationPlacements: style.decorationPlacements,
+            inlineStyleEmitter: style.inlineStyleEmitter,
+        };
+    }
+    mergeExtras(engineVars, bindings, baseInlineStyles) {
+        return { ...baseInlineStyles, ...engineVars, ...Object.fromEntries(bindings) };
+    }
+    resolveAlignment(alignment) {
+        return {
+            yPx: Math.round(alignment.verticalOffset * this.height),
+            xPx: Math.round(alignment.horizontalOffset * this.width),
+            vAnchorPct: alignment.verticalAlign === 'top' ? 0 : alignment.verticalAlign === 'center' ? 50 : 100,
+            hAnchorPct: alignment.horizontalAlign === 'left' ? 0 : alignment.horizontalAlign === 'center' ? 50 : 100,
+            vGridAlign: alignment.verticalAlign === 'top' ? 'start' : alignment.verticalAlign === 'center' ? 'center' : 'end',
+            hGridAlign: alignment.horizontalAlign === 'left' ? 'start' : alignment.horizontalAlign === '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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AA2B5D;;;;;;;;;GASG;AACH,MAAM,OAAO,sBAAsB;IAGd;IACA;IACA;IACA;IACA;IACA;IANnB,YACmB,cAAyC,EACzC,iBAA2C,EAC3C,kBAAyC,EACzC,qBAA4C,EAC5C,KAAa,EACb,MAAc;QALd,mBAAc,GAAd,cAAc,CAA2B;QACzC,sBAAiB,GAAjB,iBAAiB,CAA0B;QAC3C,uBAAkB,GAAlB,kBAAkB,CAAuB;QACzC,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,KAAK,CAAC,gBAAgB,CACpB,KAAoB,EACpB,GAAY,EACZ,CAAS,EACT,cAAsB,EACtB,OAAqB;QAErB,MAAM,eAAe,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,gBAAgB,GAAoB,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,GAAG,eAAe,EAAE,SAAS,EAAE,CAAC;QAEhG,MAAM,2BAA2B,GAAG,eAAe,EAAE,YAAY,CAAC;QAClE,MAAM,gBAAgB,GAAmB,2BAA2B;YAClE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,GAAG,2BAA2B,EAAE;YAC3D,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QAEvB,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAEjF,kEAAkE;QAClE,kEAAkE;QAClE,+DAA+D;QAC/D,qEAAqE;QACrE,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC7C,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,CAAC,eAAe,EAAE,OAAO,CAC1G,CAAC;YACF,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QACD,MAAM,sBAAsB,GAAG,IAAI,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;QAC9E,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,eAAe,EAAE,CAAC;YACvD,MAAM,qBAAqB,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;YACrF,MAAM,aAAa,GAAoB,EAAE,GAAG,gBAAgB,EAAE,GAAG,qBAAqB,EAAE,CAAC;YACzF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,8BAA8B,CACrD,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,OAAO,CAC1F,CAAC;YACF,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YACnB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,qBAAqB,EAAE,CAAC;YAC7D,MAAM,2BAA2B,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;YACjG,MAAM,mBAAmB,GAAoB,EAAE,GAAG,gBAAgB,EAAE,GAAG,2BAA2B,EAAE,CAAC;YACrG,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,oCAAoC,CAC3D,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,OAAO,CAChG,CAAC;YACF,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;YACnB,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACK,uBAAuB,CAAC,MAAsB;QACpD,IAAI,CAAC,CAAC,WAAW,CAAC,wBAAwB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,mBAAmB,IAAI,MAAM,CAAC,EAAE,CAAC;YACtG,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,GAAG,KAAK,WAAW,CAAC,wBAAwB,IAAI,GAAG,KAAK,WAAW,CAAC,mBAAmB;gBAAE,SAAS;YACtG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,KAAoB,EACpB,GAAY,EACZ,CAAS,EACT,cAAsB,EACtB,SAA0B,EAC1B,gBAAgC,EAChC,eAAoC,EACpC,OAAqB;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE9F,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3G,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;QACjH,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEtD,OAAO,EAAE,IAAI,EAAE,eAAe,WAAW,KAAK,WAAW,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,8BAA8B,CAC1C,KAAoB,EACpB,GAAY,EACZ,UAAiC,EACjC,CAAS,EACT,cAAsB,EACtB,SAA0B,EAC1B,gBAAgC,EAChC,OAAqB;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE9F,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3G,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAC5D,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,cAAc,EAAE,UAAU,CAAC,WAAW,CAC7F,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEtD,OAAO,EAAE,IAAI,EAAE,eAAe,WAAW,KAAK,WAAW,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,oCAAoC,CAChD,KAAoB,EACpB,GAAY,EACZ,UAAuC,EACvC,CAAS,EACT,cAAsB,EACtB,SAA0B,EAC1B,gBAAgC,EAChC,OAAqB;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAE9F,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3G,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,4BAA4B,CAClE,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,cAAc,CACrE,CAAC;QACF,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEtD,OAAO,EAAE,IAAI,EAAE,eAAe,WAAW,KAAK,WAAW,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;IAED,8DAA8D;IAC9D,yDAAyD;IACzD,gDAAgD;IAChD,yCAAyC;IACjC,kBAAkB,CAAC,QAA2B;QACpD,OAAO,4BAA4B,QAAQ,CAAC,GAAG,aAAa,QAAQ,CAAC,GAAG,8EAA8E,QAAQ,CAAC,UAAU,oBAAoB,QAAQ,CAAC,UAAU,GAAG,CAAC;IACtN,CAAC;IAEO,iBAAiB,CAAC,KAAoB,EAAE,kBAAkC;QAChF,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,gBAAgB,EAAE,KAAK,CAAC,YAAY;YACpC,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,qBAAqB,EAAE,KAAK,CAAC,SAAS,CAAC,qBAAqB;YAC5D,sBAAsB,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ;YAC3D,kBAAkB;YAClB,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;SAC7C,CAAC;IACJ,CAAC;IAEO,WAAW,CACjB,UAA0B,EAC1B,QAAqC,EACrC,gBAAgC;QAEhC,OAAO,EAAE,GAAG,gBAAgB,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;IACjF,CAAC;IAEO,gBAAgB,CAAC,SAA0B;QACjD,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;YACvD,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC;YACxD,UAAU,EAAE,SAAS,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;YACnG,UAAU,EAAE,SAAS,CAAC,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;YACxG,UAAU,EAAE,SAAS,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YACjH,UAAU,EAAE,SAAS,CAAC,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;SACvH,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,46 @@
+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;
+    /**
+     * 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;AAOpG;;;;;;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;IAqB/B;;;;;;uCAMmC;IACnC,OAAO,CAAC,iBAAiB;YAKX,aAAa;IAiB3B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,UAAU;YAIJ,SAAS;IA0BvB;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;CAK7B"}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,27 @@
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+import type { SvgFilterScoper } from '../../svg-filter/SvgFilterScoper';
+import type { SvgFilterLengthResolver } from '../../svg-filter/SvgFilterLengthResolver';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+export interface FilterMaterialization {
+    defs: string;
+    bindings: ReadonlyMap<string, string>;
+}
+/**
+ * Materializes the SVG `<filter>` defs declared by a style's filter
+ * bundle for one render tile. Resolves each filter's length units
+ * against the render-surface pixel factors, layers the engine-
+ * injected vars onto the consumer's scope, and rebinds local ids to
+ * scope-unique ids so two tiles using the same source filter don't
+ * collide in the sprite-sheet SVG.
+ *
+ * Returns empty defs and empty bindings when the style declares no
+ * filters.
+ */
+export declare class SvgFilterMaterializer {
+    private readonly svgFilterScoper;
+    private readonly svgFilterLengthResolver;
+    private readonly renderHeightPx;
+    constructor(svgFilterScoper: SvgFilterScoper, svgFilterLengthResolver: SvgFilterLengthResolver, renderHeightPx: number);
+    materialize(style: PreparedStyle, t: number, engineVars: InlineStyleMap, nextUid: () => number): FilterMaterialization;
+}
+//# sourceMappingURL=SvgFilterMaterializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterMaterializer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SvgFilterMaterializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,eAAe,EAAE,eAAe,EAChC,uBAAuB,EAAE,uBAAuB,EAChD,cAAc,EAAE,MAAM;IAGzC,WAAW,CACT,KAAK,EAAE,aAAa,EACpB,CAAC,EAAE,MAAM,EACT,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,MAAM,MAAM,GACpB,qBAAqB;CAmBzB"}

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

@@ -0,0 +1,40 @@
+import { SvgFilterScope } from '../../svg-filter/SvgFilterScope';
+/**
+ * Materializes the SVG `<filter>` defs declared by a style's filter
+ * bundle for one render tile. Resolves each filter's length units
+ * against the render-surface pixel factors, layers the engine-
+ * injected vars onto the consumer's scope, and rebinds local ids to
+ * scope-unique ids so two tiles using the same source filter don't
+ * collide in the sprite-sheet SVG.
+ *
+ * Returns empty defs and empty bindings when the style declares no
+ * filters.
+ */
+export class SvgFilterMaterializer {
+    svgFilterScoper;
+    svgFilterLengthResolver;
+    renderHeightPx;
+    constructor(svgFilterScoper, svgFilterLengthResolver, renderHeightPx) {
+        this.svgFilterScoper = svgFilterScoper;
+        this.svgFilterLengthResolver = svgFilterLengthResolver;
+        this.renderHeightPx = renderHeightPx;
+    }
+    materialize(style, t, engineVars, nextUid) {
+        const definitions = style.filters.definitions;
+        if (definitions.isEmpty())
+            return { defs: '', bindings: new Map() };
+        const context = { currentTime: t, renderHeightPx: this.renderHeightPx };
+        const consumerScope = style.filters.scopeProvider.scopeAt(context);
+        const scope = consumerScope.with(SvgFilterScope.fromEntries(Object.entries(engineVars)));
+        const lengthFactors = style.filters.scopeProvider.lengthFactorsAt(context);
+        const { idByLocal, bindings } = this.svgFilterScoper.scopeIds(definitions.ids, `${style.scopeClass}-${nextUid()}`);
+        const defs = definitions.filters
+            .map((filter) => {
+            const body = this.svgFilterLengthResolver.resolve(filter.materialize(scope), lengthFactors);
+            return `<filter id="${idByLocal.get(filter.id)}">${body}</filter>`;
+        })
+            .join('');
+        return { defs, bindings };
+    }
+}
+//# sourceMappingURL=SvgFilterMaterializer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SvgFilterMaterializer.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/SvgFilterMaterializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAUpE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAqB;IAGb;IACA;IACA;IAHnB,YACmB,eAAgC,EAChC,uBAAgD,EAChD,cAAsB;QAFtB,oBAAe,GAAf,eAAe,CAAiB;QAChC,4BAAuB,GAAvB,uBAAuB,CAAyB;QAChD,mBAAc,GAAd,cAAc,CAAQ;IACtC,CAAC;IAEJ,WAAW,CACT,KAAoB,EACpB,CAAS,EACT,UAA0B,EAC1B,OAAqB;QAErB,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAC9C,IAAI,WAAW,CAAC,OAAO,EAAE;YAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;QACxE,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC3E,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAC3D,WAAW,CAAC,GAAG,EACf,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,EAAE,EAAE,CACnC,CAAC;QACF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO;aAC7B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;YAC5F,OAAO,eAAe,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,WAAW,CAAC;QACrE,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;CACF"}

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

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

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

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