@tscaps/engine 0.1.1 → 0.2.1

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

@@ -0,0 +1,19 @@
+import type { Document } from '../../document/Document';
+import type { WordSplitter } from '../../splitting/WordSplitter';
+import type { VideoFrameSource } from '../../rendering/types/VideoFrameSource';
+import type { BaselineCssComposer } from '../../rendering/styles/BaselineCssComposer';
+import { ActiveRenderSession } from '../../rendering/subtitle/ActiveRenderSession';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/**
+ * Assembles an `ActiveRenderSession` and its per-session collaborator
+ * graph: animation probe, segment paint-region cache, video-frame
+ * vars builder, segment wrapper renderer, batch planner, and sprite
+ * sheet compositor.
+ */
+export declare class ActiveRenderSessionFactory {
+    private readonly wordSplitter;
+    private readonly baselineCssComposer;
+    constructor(wordSplitter: WordSplitter, baselineCssComposer: BaselineCssComposer);
+    create(doc: Document, styles: Readonly<Record<string, PreparedStyle>>, width: number, height: number, videoFrameSource: VideoFrameSource | null): ActiveRenderSession;
+}
+//# sourceMappingURL=ActiveRenderSessionFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveRenderSessionFactory.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/ActiveRenderSessionFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAazF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;GAKG;AACH,qBAAa,0BAA0B;IAGnC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBADnB,YAAY,EAAE,YAAY,EAC1B,mBAAmB,EAAE,mBAAmB;IAG3D,MAAM,CACJ,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GACxC,mBAAmB;CA0CvB"}

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

@@ -0,0 +1,41 @@
+import { SvgFilterScoper } from '../../svg-filter/SvgFilterScoper';
+import { SvgFilterLengthResolver } from '../../svg-filter/SvgFilterLengthResolver';
+import { SegmentSubtreeHtmlBuilder } from '../../rendering/subtitle/SegmentSubtreeHtmlBuilder';
+import { SegmentSubtreeDecomposer } from '../../rendering/subtitle/SegmentSubtreeDecomposer';
+import { SegmentPaintRegionResolver } from '../../rendering/subtitle/SegmentPaintRegionResolver';
+import { SegmentPaintRegionCache } from '../../rendering/subtitle/SegmentPaintRegionCache';
+import { VideoFrameVarsBuilder } from '../../rendering/subtitle/VideoFrameVarsBuilder';
+import { SvgFilterMaterializer } from '../../rendering/subtitle/SvgFilterMaterializer';
+import { SegmentWrapperRenderer } from '../../rendering/subtitle/SegmentWrapperRenderer';
+import { AnimationProbe } from '../../rendering/subtitle/AnimationProbe';
+import { BatchPlanner } from '../../rendering/subtitle/BatchPlanner';
+import { SpriteSheetCompositor } from '../../rendering/subtitle/SpriteSheetCompositor';
+import { ActiveRenderSession } from '../../rendering/subtitle/ActiveRenderSession';
+/**
+ * Assembles an `ActiveRenderSession` and its per-session collaborator
+ * graph: animation probe, segment paint-region cache, video-frame
+ * vars builder, segment wrapper renderer, batch planner, and sprite
+ * sheet compositor.
+ */
+export class ActiveRenderSessionFactory {
+    wordSplitter;
+    baselineCssComposer;
+    constructor(wordSplitter, baselineCssComposer) {
+        this.wordSplitter = wordSplitter;
+        this.baselineCssComposer = baselineCssComposer;
+    }
+    create(doc, styles, width, height, videoFrameSource) {
+        const subtreeBuilder = new SegmentSubtreeHtmlBuilder(this.wordSplitter);
+        const subtreeDecomposer = new SegmentSubtreeDecomposer();
+        const paintRegionResolver = new SegmentPaintRegionResolver();
+        const paintRegionCache = new SegmentPaintRegionCache();
+        const filterMaterializer = new SvgFilterMaterializer(new SvgFilterScoper(), new SvgFilterLengthResolver(), height);
+        const videoFrameVarsBuilder = new VideoFrameVarsBuilder(subtreeBuilder, paintRegionResolver, paintRegionCache, width, height, videoFrameSource);
+        const wrapperRenderer = new SegmentWrapperRenderer(subtreeBuilder, subtreeDecomposer, filterMaterializer, videoFrameVarsBuilder, width, height);
+        const animationProbe = new AnimationProbe();
+        const batchPlanner = new BatchPlanner(doc, styles, animationProbe);
+        const spriteSheetCompositor = new SpriteSheetCompositor(styles, wrapperRenderer, this.baselineCssComposer, width, height);
+        return new ActiveRenderSession(batchPlanner, spriteSheetCompositor, animationProbe, paintRegionCache);
+    }
+}
+//# sourceMappingURL=ActiveRenderSessionFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveRenderSessionFactory.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/ActiveRenderSessionFactory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AAGtF;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAGlB;IACA;IAFnB,YACmB,YAA0B,EAC1B,mBAAwC;QADxC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,wBAAmB,GAAnB,mBAAmB,CAAqB;IACxD,CAAC;IAEJ,MAAM,CACJ,GAAa,EACb,MAA+C,EAC/C,KAAa,EACb,MAAc,EACd,gBAAyC;QAEzC,MAAM,cAAc,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACzD,MAAM,mBAAmB,GAAG,IAAI,0BAA0B,EAAE,CAAC;QAC7D,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,EAAE,CAAC;QACvD,MAAM,kBAAkB,GAAG,IAAI,qBAAqB,CAClD,IAAI,eAAe,EAAE,EACrB,IAAI,uBAAuB,EAAE,EAC7B,MAAM,CACP,CAAC;QACF,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CACrD,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,EACL,MAAM,EACN,gBAAgB,CACjB,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,sBAAsB,CAChD,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,EACL,MAAM,CACP,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QACnE,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CACrD,MAAM,EACN,eAAe,EACf,IAAI,CAAC,mBAAmB,EACxB,KAAK,EACL,MAAM,CACP,CAAC;QACF,OAAO,IAAI,mBAAmB,CAC5B,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,gBAAgB,CACjB,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+import type { Segment } from '../../document/Segment';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/**
+ * Decides whether a render item should redraw every frame: builds
+ * throw-away DOM chains matching the CSS classes the engine emits,
+ * reads back resolved `animation-duration` / `animation-delay` from
+ * `getComputedStyle`, and decodes each timing back to the CSS
+ * variable that anchored its window. Caches per `(style, class
+ * chain)` so the same chain is probed at most once. `clear` empties
+ * the cache.
+ */
+export declare class AnimationProbe {
+    private readonly timingByKey;
+    isItemAnimating(style: PreparedStyle, seg: Segment, t: number): boolean;
+    clear(): void;
+    private wordTiming;
+    private lineTiming;
+    private segmentTiming;
+    private injectProbeMagic;
+    private getOrProbeTiming;
+    private readAnimTimings;
+    private parseDurationsS;
+    private evalAnims;
+}
+//# sourceMappingURL=AnimationProbe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationProbe.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AnimationProbe.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAK/E;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IA2BvE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,SAAS;CA+BlB"}

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

@@ -0,0 +1,198 @@
+import { CssVariable } from '../../document/CssVariable';
+const FINGERPRINT_BASE_S = 10000;
+/**
+ * Decides whether a render item should redraw every frame: builds
+ * throw-away DOM chains matching the CSS classes the engine emits,
+ * reads back resolved `animation-duration` / `animation-delay` from
+ * `getComputedStyle`, and decodes each timing back to the CSS
+ * variable that anchored its window. Caches per `(style, class
+ * chain)` so the same chain is probed at most once. `clear` empties
+ * the cache.
+ */
+export class AnimationProbe {
+    timingByKey = new Map();
+    isItemAnimating(style, seg, t) {
+        // Letter-level CSS typically combines time vars via calc(), which
+        // destroys the fingerprint-based probe; treat the segment as
+        // always animating in that mode and redraw every frame.
+        if (style.rendering.splitWordsIntoLetters)
+            return true;
+        // Styles that bake the underlying video frame into their visuals
+        // change every tick by definition — no two timestamps share state.
+        if (style.rendering.videoFrame.required)
+            return true;
+        // Filter definitions whose materialized output can vary with
+        // `currentTime` likewise force per-frame redraw; conservatively
+        // treat any non-empty filter set as time-varying.
+        if (!style.filters.definitions.isEmpty())
+            return true;
+        const segClasses = seg.getCssClasses(t);
+        if (this.evalAnims(this.segmentTiming(style, segClasses), t, seg.time.start, seg.time.end))
+            return true;
+        return [...seg.lines].some((line) => {
+            const lineClasses = line.getCssClasses(t);
+            if (this.evalAnims(this.lineTiming(style, lineClasses, segClasses), t, seg.time.start, seg.time.end, line.time.start, line.time.end))
+                return true;
+            return [...line.words].some((word) => {
+                const wordClasses = word.getCssClasses(t);
+                return this.evalAnims(this.wordTiming(style, wordClasses, lineClasses, segClasses), t, seg.time.start, seg.time.end, line.time.start, line.time.end, word.time.start, word.time.end);
+            });
+        });
+    }
+    clear() {
+        this.timingByKey.clear();
+    }
+    wordTiming(style, wordClasses, lineClasses, segClasses) {
+        const key = `${style.kind}|w:${wordClasses.join(' ')}|l:${lineClasses.join(' ')}|s:${segClasses.join(' ')}`;
+        return this.getOrProbeTiming(key, () => {
+            const seg = document.createElement('div');
+            seg.className = segClasses.join(' ');
+            const line = document.createElement('div');
+            line.className = lineClasses.join(' ');
+            const word = document.createElement('span');
+            word.className = wordClasses.join(' ');
+            this.injectProbeMagic(word);
+            line.appendChild(word);
+            seg.appendChild(line);
+            style.probeContainer.appendChild(seg);
+            const timing = this.readAnimTimings(word);
+            style.probeContainer.removeChild(seg);
+            return timing;
+        });
+    }
+    lineTiming(style, lineClasses, segClasses) {
+        const key = `${style.kind}|l:${lineClasses.join(' ')}|s:${segClasses.join(' ')}`;
+        return this.getOrProbeTiming(key, () => {
+            const seg = document.createElement('div');
+            seg.className = segClasses.join(' ');
+            const line = document.createElement('div');
+            line.className = lineClasses.join(' ');
+            this.injectProbeMagic(line);
+            seg.appendChild(line);
+            style.probeContainer.appendChild(seg);
+            const timing = this.readAnimTimings(line);
+            style.probeContainer.removeChild(seg);
+            return timing;
+        });
+    }
+    segmentTiming(style, segClasses) {
+        const key = `${style.kind}|s:${segClasses.join(' ')}`;
+        return this.getOrProbeTiming(key, () => {
+            const seg = document.createElement('div');
+            seg.className = segClasses.join(' ');
+            this.injectProbeMagic(seg);
+            style.probeContainer.appendChild(seg);
+            const timing = this.readAnimTimings(seg);
+            style.probeContainer.removeChild(seg);
+            return timing;
+        });
+    }
+    // Each CssVariable gets a fingerprint-shaped duration value so the
+    // computed `animation-delay` on a probed element identifies which
+    // variable a rule consumed.
+    injectProbeMagic(el) {
+        Object.values(CssVariable).forEach((cssVar, index) => {
+            el.style.setProperty(cssVar, `${(index + 1) * FINGERPRINT_BASE_S}s`);
+        });
+    }
+    getOrProbeTiming(key, probe) {
+        let timing = this.timingByKey.get(key);
+        if (!timing) {
+            timing = probe();
+            this.timingByKey.set(key, timing);
+        }
+        return timing;
+    }
+    readAnimTimings(el) {
+        const computed = window.getComputedStyle(el);
+        const durations = this.parseDurationsS(computed.animationDuration);
+        const delays = this.parseDurationsS(computed.animationDelay);
+        const iterations = computed.animationIterationCount.split(',').map((s) => s.trim());
+        if (durations.every((d) => d === 0))
+            return [];
+        const anims = [];
+        const variables = Object.values(CssVariable);
+        for (let i = 0; i < durations.length; i++) {
+            const d = durations[i] ?? 0;
+            if (d === 0)
+                continue;
+            const dl = delays[i] ?? 0;
+            const fingerprintIndex = (dl / FINGERPRINT_BASE_S) - 1;
+            const cssVar = variables[fingerprintIndex];
+            if (!cssVar)
+                continue;
+            const isInfinite = (iterations[i] ?? '1') === 'infinite';
+            anims.push({ cssVar, durationS: isInfinite ? Infinity : d + 0.05 });
+        }
+        return anims;
+    }
+    parseDurationsS(value) {
+        if (!value)
+            return [0];
+        return value.split(',').map((s) => {
+            s = s.trim();
+            if (s.endsWith('ms'))
+                return parseFloat(s) / 1000;
+            if (s.endsWith('s'))
+                return parseFloat(s);
+            return 0;
+        });
+    }
+    evalAnims(anims, t, segStart, segEnd, lineStart, lineEnd, wordStart, wordEnd) {
+        return anims.some((a) => {
+            let startT;
+            switch (a.cssVar) {
+                case CssVariable.SECTION_STARTS:
+                case CssVariable.SECTION_ENDS:
+                    // Section-level animations are not yet wired into per-frame
+                    // timing — treat them as never active.
+                    return false;
+                case CssVariable.SEGMENT_STARTS:
+                    startT = segStart;
+                    break;
+                case CssVariable.SEGMENT_ENDS:
+                    startT = segEnd;
+                    break;
+                case CssVariable.LINE_NOT_NARRATED_YET_STARTS:
+                    startT = segStart;
+                    break;
+                case CssVariable.LINE_NOT_NARRATED_YET_ENDS:
+                    startT = lineStart ?? segStart;
+                    break;
+                case CssVariable.LINE_BEING_NARRATED_STARTS:
+                    startT = lineStart ?? segStart;
+                    break;
+                case CssVariable.LINE_BEING_NARRATED_ENDS:
+                    startT = lineEnd ?? segEnd;
+                    break;
+                case CssVariable.LINE_ALREADY_NARRATED_STARTS:
+                    startT = lineEnd ?? segEnd;
+                    break;
+                case CssVariable.LINE_ALREADY_NARRATED_ENDS:
+                    startT = segEnd;
+                    break;
+                case CssVariable.WORD_NOT_NARRATED_YET_STARTS:
+                    startT = segStart;
+                    break;
+                case CssVariable.WORD_NOT_NARRATED_YET_ENDS:
+                    startT = wordStart ?? segStart;
+                    break;
+                case CssVariable.WORD_BEING_NARRATED_STARTS:
+                    startT = wordStart ?? segStart;
+                    break;
+                case CssVariable.WORD_BEING_NARRATED_ENDS:
+                    startT = wordEnd ?? segEnd;
+                    break;
+                case CssVariable.WORD_ALREADY_NARRATED_STARTS:
+                    startT = wordEnd ?? segEnd;
+                    break;
+                case CssVariable.WORD_ALREADY_NARRATED_ENDS:
+                    startT = segEnd;
+                    break;
+                default: return false;
+            }
+            return t >= startT && t < startT + a.durationS;
+        });
+    }
+}
+//# sourceMappingURL=AnimationProbe.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { RenderItem, UniqueTile, AssetGroup } from '../../rendering/subtitle/BatchPlan';
+/**
+ * Builds one asset group: tracks the unique tiles accumulated for an
+ * asset key, deduplicates new arrivals by state key, and finalizes
+ * into an {@link AssetGroup}.
+ */
+export declare class AssetGroupBuilder {
+    readonly assetKey: string;
+    private readonly tiles;
+    private readonly tileByStateKey;
+    constructor(assetKey: string);
+    upsertTile(stateKey: string, items: RenderItem[]): UniqueTile;
+    build(): AssetGroup;
+}
+//# sourceMappingURL=AssetGroupBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssetGroupBuilder.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AssetGroupBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEhG;;;;GAIG;AACH,qBAAa,iBAAiB;IAIhB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAHrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;gBAE3C,QAAQ,EAAE,MAAM;IAErC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU;IAU7D,KAAK,IAAI,UAAU;CAGpB"}

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

@@ -0,0 +1,26 @@
+/**
+ * Builds one asset group: tracks the unique tiles accumulated for an
+ * asset key, deduplicates new arrivals by state key, and finalizes
+ * into an {@link AssetGroup}.
+ */
+export class AssetGroupBuilder {
+    assetKey;
+    tiles = [];
+    tileByStateKey = new Map();
+    constructor(assetKey) {
+        this.assetKey = assetKey;
+    }
+    upsertTile(stateKey, items) {
+        let tile = this.tileByStateKey.get(stateKey);
+        if (!tile) {
+            tile = { items, tileIndex: this.tiles.length };
+            this.tiles.push(tile);
+            this.tileByStateKey.set(stateKey, tile);
+        }
+        return tile;
+    }
+    build() {
+        return { assetKey: this.assetKey, uniqueTiles: this.tiles };
+    }
+}
+//# sourceMappingURL=AssetGroupBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssetGroupBuilder.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AssetGroupBuilder.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAIP;IAHJ,KAAK,GAAiB,EAAE,CAAC;IACzB,cAAc,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEhE,YAAqB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEzC,UAAU,CAAC,QAAgB,EAAE,KAAmB;QAC9C,IAAI,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC9D,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+import type { Segment } from '../../document/Segment';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+export interface RenderItem {
+    seg: Segment;
+    style: PreparedStyle;
+    t: number;
+    /** Zero-based position of `seg` inside its owning section, propagated to the subtree builder for `--segment-index`. */
+    indexInSection: number;
+}
+export interface UniqueTile {
+    items: RenderItem[];
+    tileIndex: number;
+}
+export interface AssetGroup {
+    assetKey: string;
+    uniqueTiles: UniqueTile[];
+}
+export interface TileAssignment {
+    assetKey: string;
+    tileIndex: number;
+}
+/**
+ * Output of the batch planner: one asset group per disjoint kind
+ * combination at the timestamps in this batch, plus a per-timestamp
+ * assignment naming the group and the tile within it. A `null`
+ * assignment marks a timestamp with no active segment.
+ */
+export interface BatchPlan {
+    groups: Map<string, AssetGroup>;
+    assignments: Array<TileAssignment | null>;
+}
+//# sourceMappingURL=BatchPlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchPlan.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/BatchPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,uHAAuH;IACvH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,WAAW,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC3C"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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