@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/rendering/styles/SegmentPaddingCssRuleBuilder.js

@@ -0,0 +1,33 @@
+import { CssVariable } from '../../document/CssVariable';
+/**
+ * Builds the engine-internal CSS rule that applies per-side padding
+ * to `.segment`, cancels its layout shift with a matching negative
+ * margin, and exposes the vertical padding amounts on CSS variables
+ * the decoration containers read to anchor themselves at the content
+ * edge rather than the padded edge. Returns an empty string for
+ * `null` input.
+ */
+export class SegmentPaddingCssRuleBuilder {
+    build(padding) {
+        if (padding === null)
+            return '';
+        const positive = `${padding.top} ${padding.right} ${padding.bottom} ${padding.left}`;
+        const negative = [padding.top, padding.right, padding.bottom, padding.left]
+            .map((length) => this.negate(length))
+            .join(' ');
+        const internalVars = `${CssVariable.SEGMENT_PADDING_TOP}: ${padding.top}; ` +
+            `${CssVariable.SEGMENT_PADDING_BOTTOM}: ${padding.bottom};`;
+        return `.segment { padding: ${positive}; margin: ${negative}; ${internalVars} }`;
+    }
+    negate(length) {
+        if (this.isZero(length))
+            return length;
+        if (length.startsWith('-'))
+            return length.slice(1);
+        return `-${length}`;
+    }
+    isZero(length) {
+        return /^-?0(?:\.0+)?[a-z%]*$/i.test(length);
+    }
+}
+//# sourceMappingURL=SegmentPaddingCssRuleBuilder.js.map

package/dist/modules/rendering/styles/SegmentPaddingCssRuleBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentPaddingCssRuleBuilder.js","sourceRoot":"","sources":["../../../../src/modules/rendering/styles/SegmentPaddingCssRuleBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,OAAO,4BAA4B;IAEvC,KAAK,CAAC,OAAwB;QAC5B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACrF,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;aACxE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aACpC,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,YAAY,GAChB,GAAG,WAAW,CAAC,mBAAmB,KAAK,OAAO,CAAC,GAAG,IAAI;YACtD,GAAG,WAAW,CAAC,sBAAsB,KAAK,OAAO,CAAC,MAAM,GAAG,CAAC;QAC9D,OAAO,uBAAuB,QAAQ,aAAa,QAAQ,KAAK,YAAY,IAAI,CAAC;IACnF,CAAC;IAEO,MAAM,CAAC,MAAc;QAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACvC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,MAAM,EAAE,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,MAAc;QAC3B,OAAO,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/modules/rendering/{VideoFrameLayerClass.d.ts → styles/VideoFrameLayerBaselineCss.d.ts}

@@ -1,13 +1,6 @@
 /**
- * Class on the element the renderer emits inside a Segment when its
- * `RenderingConfig.videoFrame.required` is set. The Section's
- * stylesheet targets this class to position, clip, or filter the
- * video frame.
- */
-export declare const VIDEO_FRAME_LAYER_CLASS = "tscaps-video-frame-layer";
-/**
- * Default rule for {@link VIDEO_FRAME_LAYER_CLASS}: positions the
- * layer over the subtitle's painted region via the
+ * Default rule for the `CssClass.VIDEO_FRAME_LAYER` element: positions
+ * the layer over the subtitle's painted region via the
  * `--subtitle-region-*` custom properties and paints the current
  * frame slice from `--video-frame`. Class-level specificity so
  * sheet-scoped overrides always win.
@@ -18,4 +11,4 @@ export declare const VIDEO_FRAME_LAYER_CLASS = "tscaps-video-frame-layer";
  * the region geometry.
  */
 export declare const VIDEO_FRAME_LAYER_BASELINE_CSS = ".tscaps-video-frame-layer { position: absolute; left: var(--subtitle-region-x, 0); top: var(--subtitle-region-y, 0); width: var(--subtitle-region-width, 100%); height: var(--subtitle-region-height, 100%); max-width: none; max-height: none; background-image: var(--video-frame, none); background-size: 100% 100%; pointer-events: none; object-fit: fill; }";
-//# sourceMappingURL=VideoFrameLayerClass.d.ts.map
+//# sourceMappingURL=VideoFrameLayerBaselineCss.d.ts.map

package/dist/modules/rendering/styles/VideoFrameLayerBaselineCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameLayerBaselineCss.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/styles/VideoFrameLayerBaselineCss.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B,sWAA2W,CAAC"}

package/dist/modules/rendering/styles/VideoFrameLayerBaselineCss.js

@@ -0,0 +1,15 @@
+import { CssClass } from '../../document/CssClass';
+/**
+ * Default rule for the `CssClass.VIDEO_FRAME_LAYER` element: positions
+ * the layer over the subtitle's painted region via the
+ * `--subtitle-region-*` custom properties and paints the current
+ * frame slice from `--video-frame`. Class-level specificity so
+ * sheet-scoped overrides always win.
+ *
+ * `max-width: none; max-height: none` defeats consumer CSS resets
+ * (e.g. Tailwind's `img, video { max-width: 100% }`) that would
+ * clip the layer to its content-hugging segment parent and break
+ * the region geometry.
+ */
+export const VIDEO_FRAME_LAYER_BASELINE_CSS = `.${CssClass.VIDEO_FRAME_LAYER} { position: absolute; left: var(--subtitle-region-x, 0); top: var(--subtitle-region-y, 0); width: var(--subtitle-region-width, 100%); height: var(--subtitle-region-height, 100%); max-width: none; max-height: none; background-image: var(--video-frame, none); background-size: 100% 100%; pointer-events: none; object-fit: fill; }`;
+//# sourceMappingURL=VideoFrameLayerBaselineCss.js.map

package/dist/modules/rendering/styles/VideoFrameLayerBaselineCss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameLayerBaselineCss.js","sourceRoot":"","sources":["../../../../src/modules/rendering/styles/VideoFrameLayerBaselineCss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,QAAQ,CAAC,iBAAiB,0UAA0U,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { CssVariable } from '../../document/CssVariable';
+/**
+ * One animation timing extracted from a probed element's computed
+ * style: the CSS variable whose start moment anchors the active
+ * window, and the duration the rule runs for once that moment passes.
+ * `durationS` is `Infinity` for an `animation-iteration-count:
+ * infinite` rule.
+ */
+export interface AbstractAnim {
+    cssVar: CssVariable;
+    durationS: number;
+}
+//# sourceMappingURL=AbstractAnim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractAnim.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AbstractAnim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

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

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

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

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

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

@@ -0,0 +1,20 @@
+import type { SubtitleFrame } from '../../rendering/SubtitleFrameRenderer';
+import type { BatchPlanner } from '../../rendering/subtitle/BatchPlanner';
+import type { SpriteSheetCompositor } from '../../rendering/subtitle/SpriteSheetCompositor';
+import type { AnimationProbe } from '../../rendering/subtitle/AnimationProbe';
+import type { SegmentPaintRegionCache } from '../../rendering/subtitle/SegmentPaintRegionCache';
+/**
+ * Per-document render session. Routes each `getFrames` batch through
+ * the planner → compositor pipeline and clears the animation-timing
+ * cache and segment paint-region cache on dispose.
+ */
+export declare class ActiveRenderSession {
+    private readonly batchPlanner;
+    private readonly spriteSheetCompositor;
+    private readonly animationProbe;
+    private readonly paintRegionCache;
+    constructor(batchPlanner: BatchPlanner, spriteSheetCompositor: SpriteSheetCompositor, animationProbe: AnimationProbe, paintRegionCache: SegmentPaintRegionCache);
+    getFrames(timestamps: ReadonlyArray<number>): Promise<Array<SubtitleFrame | null>>;
+    dispose(): void;
+}
+//# sourceMappingURL=ActiveRenderSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveRenderSession.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/ActiveRenderSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAEnG;;;;GAIG;AACH,qBAAa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAHhB,YAAY,EAAE,YAAY,EAC1B,qBAAqB,EAAE,qBAAqB,EAC5C,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,uBAAuB;IAGtD,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAQxF,OAAO,IAAI,IAAI;CAIhB"}

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

@@ -0,0 +1,31 @@
+/**
+ * Per-document render session. Routes each `getFrames` batch through
+ * the planner → compositor pipeline and clears the animation-timing
+ * cache and segment paint-region cache on dispose.
+ */
+export class ActiveRenderSession {
+    batchPlanner;
+    spriteSheetCompositor;
+    animationProbe;
+    paintRegionCache;
+    constructor(batchPlanner, spriteSheetCompositor, animationProbe, paintRegionCache) {
+        this.batchPlanner = batchPlanner;
+        this.spriteSheetCompositor = spriteSheetCompositor;
+        this.animationProbe = animationProbe;
+        this.paintRegionCache = paintRegionCache;
+    }
+    async getFrames(timestamps) {
+        if (timestamps.length === 0)
+            return [];
+        const plan = this.batchPlanner.plan(timestamps);
+        if (plan.groups.size === 0)
+            return timestamps.map(() => null);
+        const sprites = await this.spriteSheetCompositor.renderGroups(plan.groups);
+        return this.spriteSheetCompositor.buildFrames(plan.assignments, sprites);
+    }
+    dispose() {
+        this.animationProbe.clear();
+        this.paintRegionCache.clear();
+    }
+}
+//# sourceMappingURL=ActiveRenderSession.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActiveRenderSession.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/ActiveRenderSession.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAGX;IACA;IACA;IACA;IAJnB,YACmB,YAA0B,EAC1B,qBAA4C,EAC5C,cAA8B,EAC9B,gBAAyC;QAHzC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,qBAAgB,GAAhB,gBAAgB,CAAyB;IACzD,CAAC;IAEJ,KAAK,CAAC,SAAS,CAAC,UAAiC;QAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import type { Document } from '../../document/Document';
+import type { WordSplitter } from '../../splitting/WordSplitter';
+import type { WordFragmenter } from '../../bidi/WordFragmenter';
+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 wordFragmenter;
+    private readonly baselineCssComposer;
+    constructor(wordSplitter: WordSplitter, wordFragmenter: WordFragmenter, 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,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAczF,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,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAFnB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,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,46 @@
+import { HorizontalSideResolver } from '../../bidi/HorizontalSideResolver';
+import { HorizontalPlacementResolver } from '../../rendering/HorizontalPlacementResolver';
+import { SvgFilterScoper } from '../../svg-filter/SvgFilterScoper';
+import { SvgFilterLengthResolver } from '../../svg-filter/SvgFilterLengthResolver';
+import { SvgFilterDefsRenderer } from '../../svg-filter/SvgFilterDefsRenderer';
+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;
+    wordFragmenter;
+    baselineCssComposer;
+    constructor(wordSplitter, wordFragmenter, baselineCssComposer) {
+        this.wordSplitter = wordSplitter;
+        this.wordFragmenter = wordFragmenter;
+        this.baselineCssComposer = baselineCssComposer;
+    }
+    create(doc, styles, width, height, videoFrameSource) {
+        const subtreeBuilder = new SegmentSubtreeHtmlBuilder(this.wordSplitter, this.wordFragmenter);
+        const subtreeDecomposer = new SegmentSubtreeDecomposer();
+        const paintRegionResolver = new SegmentPaintRegionResolver();
+        const paintRegionCache = new SegmentPaintRegionCache();
+        const filterMaterializer = new SvgFilterMaterializer(new SvgFilterDefsRenderer(new SvgFilterScoper(), new SvgFilterLengthResolver()), height);
+        const videoFrameVarsBuilder = new VideoFrameVarsBuilder(subtreeBuilder, paintRegionResolver, paintRegionCache, width, height, videoFrameSource);
+        const wrapperRenderer = new SegmentWrapperRenderer(subtreeBuilder, subtreeDecomposer, filterMaterializer, videoFrameVarsBuilder, new HorizontalPlacementResolver(new HorizontalSideResolver()), 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":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAG7F,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,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;IACA;IAHnB,YACmB,YAA0B,EAC1B,cAA8B,EAC9B,mBAAwC;QAFxC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,mBAAc,GAAd,cAAc,CAAgB;QAC9B,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,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7F,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,qBAAqB,CAAC,IAAI,eAAe,EAAE,EAAE,IAAI,uBAAuB,EAAE,CAAC,EAC/E,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,IAAI,2BAA2B,CAAC,IAAI,sBAAsB,EAAE,CAAC,EAC7D,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,39 @@
+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 what the renderer 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 chain so the same one
+ * is probed at most once. `clear` empties the cache.
+ *
+ * A chain carries the element ids the renderer stamps as well as the
+ * classes, because a stylesheet can address one element rather than a
+ * class of them. Built from classes alone, the chain resolves a
+ * different animation than the node it stands for — none at all where
+ * only the element carries one, and the wrong window where the
+ * element's beats the template's. Either way the tile is reused across
+ * a frame that moved, and the animation exports as a still image.
+ *
+ * Only ids the stylesheet actually addresses go on, so a caption
+ * nobody has styled probes one chain per class combination as before.
+ */
+export declare class AnimationProbe {
+    private readonly timingByKey;
+    isItemAnimating(style: PreparedStyle, seg: Segment, t: number): boolean;
+    clear(): void;
+    /** The element as the probe will build it, addressed only where the stylesheet says so. */
+    private probed;
+    private animates;
+    private timingOf;
+    private describe;
+    /** Mounts the chain, reads what the leaf resolved to, and takes it back out. */
+    private probeChain;
+    private createNode;
+    private injectProbeMagic;
+    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":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AA2B/E;;;;;;;;;;;;;;;;;;GAkBG;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;IAwCvE,KAAK,IAAI,IAAI;IAIb,2FAA2F;IAC3F,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ;IAIhB,gFAAgF;IAChF,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,SAAS;CA6BlB"}

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

@@ -0,0 +1,203 @@
+import { CssVariable } from '../../document/CssVariable';
+import { DataAttribute } from '../../document/DataAttribute';
+import { Decoration } from '../../document/Decoration';
+const FINGERPRINT_BASE_S = 10000;
+/**
+ * Decides whether a render item should redraw every frame: builds
+ * throw-away DOM chains matching what the renderer 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 chain so the same one
+ * is probed at most once. `clear` empties the cache.
+ *
+ * A chain carries the element ids the renderer stamps as well as the
+ * classes, because a stylesheet can address one element rather than a
+ * class of them. Built from classes alone, the chain resolves a
+ * different animation than the node it stands for — none at all where
+ * only the element carries one, and the wrong window where the
+ * element's beats the template's. Either way the tile is reused across
+ * a frame that moved, and the animation exports as a still image.
+ *
+ * Only ids the stylesheet actually addresses go on, so a caption
+ * nobody has styled probes one chain per class combination as before.
+ */
+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 segment = this.probed(style, 'div', seg.getCssClasses(t), seg.id);
+        const segmentWindows = { segment: seg.time, line: null, word: null };
+        if (this.animates(style, [segment], t, segmentWindows))
+            return true;
+        return [...seg.lines].some((line) => {
+            const lineElement = this.probed(style, 'div', line.getCssClasses(t), line.id);
+            const lineWindows = { ...segmentWindows, line: line.time };
+            if (this.animates(style, [segment, lineElement], t, lineWindows))
+                return true;
+            return [...line.words].some((word) => {
+                const wordElement = this.probed(style, 'span', word.getCssClasses(t), word.id);
+                const wordChain = [segment, lineElement, wordElement];
+                if (this.animates(style, wordChain, t, { ...lineWindows, word: word.time }))
+                    return true;
+                const decoration = word.decoration;
+                if (!decoration)
+                    return false;
+                const decorationElement = this.probed(style, 'span', [Decoration.CSS_CLASS], decoration.id);
+                return this.animates(style, [...wordChain, decorationElement], t, { ...lineWindows, word: decoration.customTime ?? word.time });
+            });
+        });
+    }
+    clear() {
+        this.timingByKey.clear();
+    }
+    /** The element as the probe will build it, addressed only where the stylesheet says so. */
+    probed(style, tag, classes, elementId) {
+        return { tag, classes, elementId: style.addressableElementIds.has(elementId) ? elementId : null };
+    }
+    animates(style, chain, t, windows) {
+        return this.evalAnims(this.timingOf(style, chain), t, windows);
+    }
+    timingOf(style, chain) {
+        const key = `${style.kind}|${chain.map((element) => this.describe(element)).join('>')}`;
+        let timing = this.timingByKey.get(key);
+        if (!timing) {
+            timing = this.probeChain(style, chain);
+            this.timingByKey.set(key, timing);
+        }
+        return timing;
+    }
+    describe(element) {
+        return `${element.classes.join(' ')}#${element.elementId ?? ''}`;
+    }
+    /** Mounts the chain, reads what the leaf resolved to, and takes it back out. */
+    probeChain(style, chain) {
+        const nodes = chain.map((element) => this.createNode(element));
+        for (let index = 1; index < nodes.length; index++)
+            nodes[index - 1].appendChild(nodes[index]);
+        const root = nodes[0];
+        const leaf = nodes[nodes.length - 1];
+        this.injectProbeMagic(leaf);
+        style.probeContainer.appendChild(root);
+        const timing = this.readAnimTimings(leaf);
+        style.probeContainer.removeChild(root);
+        return timing;
+    }
+    createNode(element) {
+        const node = document.createElement(element.tag);
+        node.className = element.classes.join(' ');
+        if (element.elementId !== null)
+            node.setAttribute(DataAttribute.ELEMENT_ID, element.elementId);
+        return node;
+    }
+    // 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`);
+        });
+    }
+    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, windows) {
+        const { segment } = windows;
+        const line = windows.line ?? segment;
+        const word = windows.word ?? segment;
+        return anims.some((a) => {
+            let startT;
+            switch (a.cssVar) {
+                case CssVariable.SEGMENT_STARTS:
+                    startT = segment.start;
+                    break;
+                case CssVariable.SEGMENT_ENDS:
+                    startT = segment.end;
+                    break;
+                case CssVariable.LINE_NOT_NARRATED_YET_STARTS:
+                    startT = segment.start;
+                    break;
+                case CssVariable.LINE_NOT_NARRATED_YET_ENDS:
+                    startT = line.start;
+                    break;
+                case CssVariable.LINE_BEING_NARRATED_STARTS:
+                    startT = line.start;
+                    break;
+                case CssVariable.LINE_BEING_NARRATED_ENDS:
+                    startT = line.end;
+                    break;
+                case CssVariable.LINE_ALREADY_NARRATED_STARTS:
+                    startT = line.end;
+                    break;
+                case CssVariable.LINE_ALREADY_NARRATED_ENDS:
+                    startT = segment.end;
+                    break;
+                case CssVariable.WORD_NOT_NARRATED_YET_STARTS:
+                    startT = segment.start;
+                    break;
+                case CssVariable.WORD_NOT_NARRATED_YET_ENDS:
+                    startT = word.start;
+                    break;
+                case CssVariable.WORD_BEING_NARRATED_STARTS:
+                    startT = word.start;
+                    break;
+                case CssVariable.WORD_BEING_NARRATED_ENDS:
+                    startT = word.end;
+                    break;
+                case CssVariable.WORD_ALREADY_NARRATED_STARTS:
+                    startT = word.end;
+                    break;
+                case CssVariable.WORD_ALREADY_NARRATED_ENDS:
+                    startT = segment.end;
+                    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":""}