@tscaps/engine 0.3.1 → 0.4.0

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

@@ -3,11 +3,12 @@ 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 type { AnimationStateFingerprintStrategy } from '../../rendering/subtitle/AnimationStateFingerprint';
 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
+ * graph: animation state fingerprint, segment paint-region cache, video-frame
  * vars builder, segment wrapper renderer, batch planner, and sprite
  * sheet compositor.
  */
@@ -15,7 +16,9 @@ export declare class ActiveRenderSessionFactory {
     private readonly wordSplitter;
     private readonly wordFragmenter;
     private readonly baselineCssComposer;
-    constructor(wordSplitter: WordSplitter, wordFragmenter: WordFragmenter, baselineCssComposer: BaselineCssComposer);
+    private readonly animationStrategy;
+    constructor(wordSplitter: WordSplitter, wordFragmenter: WordFragmenter, baselineCssComposer: BaselineCssComposer, animationStrategy: AnimationStateFingerprintStrategy);
     create(doc: Document, styles: Readonly<Record<string, PreparedStyle>>, width: number, height: number, videoFrameSource: VideoFrameSource | null): ActiveRenderSession;
+    private buildAnimationFingerprint;
 }
 //# sourceMappingURL=ActiveRenderSessionFactory.d.ts.map

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

@@ -1 +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"}
+{"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;AAezF,OAAO,KAAK,EAA6B,iCAAiC,EAAE,MAAM,uDAAuD,CAAC;AAO1I,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;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAHjB,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,mBAAmB,EAAE,mBAAmB,EACxC,iBAAiB,EAAE,iCAAiC;IAGvE,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;IAgDtB,OAAO,CAAC,yBAAyB;CAWlC"}

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

@@ -8,15 +8,22 @@ import { SegmentSubtreeDecomposer } from '../../rendering/subtitle/SegmentSubtre
 import { SegmentPaintRegionResolver } from '../../rendering/subtitle/SegmentPaintRegionResolver';
 import { SegmentPaintRegionCache } from '../../rendering/subtitle/SegmentPaintRegionCache';
 import { VideoFrameVarsBuilder } from '../../rendering/subtitle/VideoFrameVarsBuilder';
+import { SegmentAnchorVarsBuilder } from '../../rendering/subtitle/SegmentAnchorVarsBuilder';
+import { ElementWidthMeasurer } from '../../rendering/subtitle/ElementWidthMeasurer';
 import { SvgFilterMaterializer } from '../../rendering/subtitle/SvgFilterMaterializer';
+import { SvgFilterStateFingerprint } from '../../rendering/subtitle/SvgFilterStateFingerprint';
 import { SegmentWrapperRenderer } from '../../rendering/subtitle/SegmentWrapperRenderer';
-import { AnimationProbe } from '../../rendering/subtitle/AnimationProbe';
+import { CssKeyframesScanner } from '../../css/CssKeyframesScanner';
+import { KeyframeScanAnimationStateFingerprint } from '../../rendering/subtitle/KeyframeScanAnimationStateFingerprint';
+import { SubtreeMountAnimationStateFingerprint } from '../../rendering/subtitle/SubtreeMountAnimationStateFingerprint';
+import { UnknownAnimationStateFingerprint } from '../../rendering/subtitle/UnknownAnimationStateFingerprint';
+import { SubtreeAnimationSupport } from '../../rendering/subtitle/SubtreeAnimationSupport';
 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
+ * graph: animation state fingerprint, segment paint-region cache, video-frame
  * vars builder, segment wrapper renderer, batch planner, and sprite
  * sheet compositor.
  */
@@ -24,23 +31,34 @@ export class ActiveRenderSessionFactory {
     wordSplitter;
     wordFragmenter;
     baselineCssComposer;
-    constructor(wordSplitter, wordFragmenter, baselineCssComposer) {
+    animationStrategy;
+    constructor(wordSplitter, wordFragmenter, baselineCssComposer, animationStrategy) {
         this.wordSplitter = wordSplitter;
         this.wordFragmenter = wordFragmenter;
         this.baselineCssComposer = baselineCssComposer;
+        this.animationStrategy = animationStrategy;
     }
     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 elementWidthMeasurer = new ElementWidthMeasurer(subtreeBuilder, width, height);
+        const filterDefsRenderer = new SvgFilterDefsRenderer(new SvgFilterScoper(), new SvgFilterLengthResolver());
+        const filterMaterializer = new SvgFilterMaterializer(filterDefsRenderer, 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 wrapperRenderer = new SegmentWrapperRenderer(subtreeBuilder, subtreeDecomposer, filterMaterializer, videoFrameVarsBuilder, new SegmentAnchorVarsBuilder(), elementWidthMeasurer, new HorizontalPlacementResolver(new HorizontalSideResolver()), width, height);
+        const batchPlanner = new BatchPlanner(doc, styles, this.buildAnimationFingerprint(wrapperRenderer, width, height), new SvgFilterStateFingerprint(filterDefsRenderer, height));
         const spriteSheetCompositor = new SpriteSheetCompositor(styles, wrapperRenderer, this.baselineCssComposer, width, height);
-        return new ActiveRenderSession(batchPlanner, spriteSheetCompositor, animationProbe, paintRegionCache);
+        return new ActiveRenderSession(batchPlanner, spriteSheetCompositor, paintRegionCache, elementWidthMeasurer);
+    }
+    buildAnimationFingerprint(wrapperRenderer, width, height) {
+        if (this.animationStrategy === 'none')
+            return new UnknownAnimationStateFingerprint();
+        if (this.animationStrategy === 'subtree-mount') {
+            return new SubtreeMountAnimationStateFingerprint(wrapperRenderer, new SubtreeAnimationSupport(), width, height);
+        }
+        return new KeyframeScanAnimationStateFingerprint(new CssKeyframesScanner());
     }
 }
 //# sourceMappingURL=ActiveRenderSessionFactory.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { Segment } from '../../document/Segment';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+/** Which implementation answers. `keyframe-scan` is the default; see `history/captions-rendering.md`. */
+export type AnimationStateFingerprintStrategy = 'keyframe-scan' | 'subtree-mount' | 'none';
+/**
+ * Describes where a segment's animations stand at one timestamp.
+ *
+ * Two timestamps described by the same value hold every animation at
+ * the same point, so the segment resolves to the same computed styles
+ * at both. `null` is not a description: it says the state at that
+ * timestamp cannot be compared with the state at any other.
+ *
+ * `classFingerprint` describes the classes the segment's elements
+ * carry at `t`. Two timestamps given the same one match the same
+ * rules.
+ */
+export interface AnimationStateFingerprint {
+    at(style: PreparedStyle, seg: Segment, t: number, indexInSection: number, classFingerprint: string): Promise<string | null>;
+}
+//# sourceMappingURL=AnimationStateFingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AnimationStateFingerprint.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AnimationStateFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAE/E,yGAAyG;AACzG,MAAM,MAAM,iCAAiC,GAAG,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC;AAE3F;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,CACA,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,OAAO,EACZ,CAAC,EAAE,MAAM,EACT,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B"}

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

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

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

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

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

@@ -3,12 +3,16 @@ import type { RenderItem, UniqueTile, AssetGroup } from '../../rendering/subtitl
  * 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);
+    /** Whether this group already holds the tile for `stateKey`, so admitting it costs no room. */
+    holds(stateKey: string): boolean;
+    get tileCount(): number;
     upsertTile(stateKey: string, items: RenderItem[]): UniqueTile;
     build(): AssetGroup;
 }

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

@@ -1 +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"}
+{"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;;;;;GAKG;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,+FAA+F;IAC/F,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIhC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU;IAU7D,KAAK,IAAI,UAAU;CAGpB"}

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

@@ -2,6 +2,7 @@
  * 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;
@@ -10,6 +11,13 @@ export class AssetGroupBuilder {
     constructor(assetKey) {
         this.assetKey = assetKey;
     }
+    /** Whether this group already holds the tile for `stateKey`, so admitting it costs no room. */
+    holds(stateKey) {
+        return this.tileByStateKey.has(stateKey);
+    }
+    get tileCount() {
+        return this.tiles.length;
+    }
     upsertTile(stateKey, items) {
         let tile = this.tileByStateKey.get(stateKey);
         if (!tile) {

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

@@ -1 +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"}
+{"version":3,"file":"AssetGroupBuilder.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/AssetGroupBuilder.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;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,+FAA+F;IAC/F,KAAK,CAAC,QAAgB;QACpB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,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/BatchPlanner.d.ts

@@ -1,6 +1,7 @@
 import type { Document } from '../../document/Document';
 import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
-import type { AnimationProbe } from '../../rendering/subtitle/AnimationProbe';
+import type { AnimationStateFingerprint } from '../../rendering/subtitle/AnimationStateFingerprint';
+import type { SvgFilterStateFingerprint } from '../../rendering/subtitle/SvgFilterStateFingerprint';
 import type { BatchPlan } from '../../rendering/subtitle/BatchPlan';
 /**
  * Plans one batch: for each timestamp, finds the active prepared
@@ -8,17 +9,61 @@ import type { BatchPlan } from '../../rendering/subtitle/BatchPlan';
  * 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.
+ *
+ * A batch ends when a group has no room for the picture the next
+ * timestamp needs, so the plan covers a prefix of the timestamps it
+ * was offered and the caller reads how far it got from the
+ * assignments. Offering more than one sheet could ever hold is the
+ * point: how much video a sheet covers is then decided by how much
+ * the captions move, not by a count fixed before anything was looked
+ * at. A still caption can carry a sheet for as long as it stays
+ * still.
  */
 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 assignTile;
+    private readonly animationFingerprint;
+    private readonly filterFingerprint;
+    constructor(doc: Document, styles: Readonly<Record<string, PreparedStyle>>, animationFingerprint: AnimationStateFingerprint, filterFingerprint: SvgFilterStateFingerprint);
+    /**
+     * Plans as many of `timestamps`, in order, as `maxTiles` distinct
+     * pictures can serve. The returned assignments cover a prefix of the
+     * input, never fewer than one entry, and the timestamps past it
+     * belong to the next batch.
+     *
+     * The budget is the batch's, not each group's: groups become one
+     * sprite sheet each, and it is their total that has to stay inside
+     * whatever raster the caller sized `maxTiles` against.
+     */
+    plan(timestamps: ReadonlyArray<number>, maxTiles: number): Promise<BatchPlan>;
+    /**
+     * What this timestamp needs painted — which sprite it belongs in and
+     * which picture inside it — or `null` where no Section is active and
+     * nothing is painted at all.
+     */
+    private pictureAt;
+    private builderFor;
     private itemsAt;
     private computeAssetKey;
+    /**
+     * What every active item paints at `t`. Two timestamps sharing this
+     * value paint the same picture, so they share a tile.
+     *
+     * JSON-encoded rather than joined: two of the parts carry text an
+     * author writes — a filter body and the name of a `@keyframes` rule
+     * — and no separator can be assumed absent from either.
+     */
     private computeStateKey;
+    /**
+     * The item's state in four parts: the state its classes are in,
+     * where its animations stand, the filter markup it is painted
+     * through, and the timestamp itself where any of them cannot answer
+     * for the whole frame — an animation is mid-run, a filter reads a
+     * variable this side cannot resolve, or the style paints the video
+     * frame itself, which differs at every timestamp by definition and
+     * is invisible from here.
+     */
+    private describeItemState;
     /**
      * Captures every time-varying CSS class the segment subtree
      * exposes (segment, lines, words) so two timestamps that resolve

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

@@ -1 +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;AAG/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;IAalD,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAOvB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,oBAAoB;CAK7B"}
+{"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,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AACvG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAA0C,MAAM,uCAAuC,CAAC;AAU/G;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAHjB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,oBAAoB,EAAE,yBAAyB,EAC/C,iBAAiB,EAAE,yBAAyB;IAG/D;;;;;;;;;OASG;IACG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BnF;;;;OAIG;YACW,SAAS;IAUvB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,eAAe;IAMvB;;;;;;;OAOG;YACW,eAAe;IAM7B;;;;;;;;OAQG;YACW,iBAAiB;IAkB/B;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAM/B,OAAO,CAAC,oBAAoB;CAK7B"}

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

@@ -6,38 +6,86 @@ import { profiler } from '../../profiling/Profiler';
  * 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.
+ *
+ * A batch ends when a group has no room for the picture the next
+ * timestamp needs, so the plan covers a prefix of the timestamps it
+ * was offered and the caller reads how far it got from the
+ * assignments. Offering more than one sheet could ever hold is the
+ * point: how much video a sheet covers is then decided by how much
+ * the captions move, not by a count fixed before anything was looked
+ * at. A still caption can carry a sheet for as long as it stays
+ * still.
  */
 export class BatchPlanner {
     doc;
     styles;
-    animationProbe;
-    constructor(doc, styles, animationProbe) {
+    animationFingerprint;
+    filterFingerprint;
+    constructor(doc, styles, animationFingerprint, filterFingerprint) {
         this.doc = doc;
         this.styles = styles;
-        this.animationProbe = animationProbe;
+        this.animationFingerprint = animationFingerprint;
+        this.filterFingerprint = filterFingerprint;
     }
-    plan(timestamps) {
+    /**
+     * Plans as many of `timestamps`, in order, as `maxTiles` distinct
+     * pictures can serve. The returned assignments cover a prefix of the
+     * input, never fewer than one entry, and the timestamps past it
+     * belong to the next batch.
+     *
+     * The budget is the batch's, not each group's: groups become one
+     * sprite sheet each, and it is their total that has to stay inside
+     * whatever raster the caller sized `maxTiles` against.
+     */
+    async plan(timestamps, maxTiles) {
         const builders = new Map();
-        const assignments = profiler.time('BatchPlanner.assignTiles', () => timestamps.map((t) => this.assignTile(t, builders)));
+        const assignments = [];
+        await profiler.time('BatchPlanner.assignTiles', async () => {
+            let tilesTaken = 0;
+            for (const t of timestamps) {
+                const picture = await this.pictureAt(t);
+                if (picture === null) {
+                    assignments.push(null);
+                    continue;
+                }
+                const builder = this.builderFor(picture.assetKey, builders);
+                const isNewPicture = !builder.holds(picture.stateKey);
+                if (isNewPicture && tilesTaken === maxTiles)
+                    break;
+                if (isNewPicture)
+                    tilesTaken++;
+                const tile = builder.upsertTile(picture.stateKey, picture.items);
+                assignments.push({ assetKey: picture.assetKey, tileIndex: tile.tileIndex });
+            }
+        });
         const groups = new Map();
         for (const builder of builders.values()) {
             groups.set(builder.assetKey, builder.build());
         }
         return { groups, assignments };
     }
-    assignTile(t, builders) {
+    /**
+     * What this timestamp needs painted — which sprite it belongs in and
+     * which picture inside it — or `null` where no Section is active and
+     * nothing is painted at all.
+     */
+    async pictureAt(t) {
         const items = profiler.time('BatchPlanner.itemsAt', () => this.itemsAt(t));
         if (items.length === 0)
             return null;
-        const assetKey = this.computeAssetKey(items);
+        return {
+            assetKey: this.computeAssetKey(items),
+            stateKey: await profiler.time('BatchPlanner.computeStateKey', () => this.computeStateKey(items, t)),
+            items,
+        };
+    }
+    builderFor(assetKey, builders) {
         let builder = builders.get(assetKey);
         if (!builder) {
             builder = new AssetGroupBuilder(assetKey);
             builders.set(assetKey, builder);
         }
-        const stateKey = profiler.time('BatchPlanner.computeStateKey', () => this.computeStateKey(items, t));
-        const tile = builder.upsertTile(stateKey, items);
-        return { assetKey, tileIndex: tile.tileIndex };
+        return builder;
     }
     itemsAt(t) {
         const items = [];
@@ -66,11 +114,45 @@ export class BatchPlanner {
             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('|');
+    /**
+     * What every active item paints at `t`. Two timestamps sharing this
+     * value paint the same picture, so they share a tile.
+     *
+     * JSON-encoded rather than joined: two of the parts carry text an
+     * author writes — a filter body and the name of a `@keyframes` rule
+     * — and no separator can be assumed absent from either.
+     */
+    async computeStateKey(items, t) {
+        const described = [];
+        for (const item of items)
+            described.push(await this.describeItemState(item, t));
+        return JSON.stringify(described);
+    }
+    /**
+     * The item's state in four parts: the state its classes are in,
+     * where its animations stand, the filter markup it is painted
+     * through, and the timestamp itself where any of them cannot answer
+     * for the whole frame — an animation is mid-run, a filter reads a
+     * variable this side cannot resolve, or the style paints the video
+     * frame itself, which differs at every timestamp by definition and
+     * is invisible from here.
+     */
+    async describeItemState({ seg, style, indexInSection }, t) {
+        const filters = this.filterFingerprint.at(style.kind, style.filters, t);
+        const classes = this.fingerprintSegmentState(seg, t);
+        // A style painting the video frame takes a tile per timestamp
+        // whatever its animations do, so it is never described.
+        const animations = style.rendering.videoFrame.required
+            ? null
+            : await this.animationFingerprint.at(style, seg, t, indexInSection, classes);
+        const perFrame = filters === null || animations === null;
+        return [
+            `${style.kind}:${seg.id}`,
+            classes,
+            animations ?? '',
+            perFrame ? t.toFixed(3) : '',
+            filters ?? '',
+        ];
     }
     /**
      * Captures every time-varying CSS class the segment subtree

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

@@ -1 +1 @@
-{"version":3,"file":"BatchPlanner.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/BatchPlanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAGJ;IACA;IACA;IAHnB,YACmB,GAAa,EACb,MAA+C,EAC/C,cAA8B;QAF9B,QAAG,GAAH,GAAG,CAAU;QACb,WAAM,GAAN,MAAM,CAAyC;QAC/C,mBAAc,GAAd,cAAc,CAAgB;IAC9C,CAAC;IAEJ,IAAI,CAAC,UAAiC;QACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;QACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE,CACjE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CACpD,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,CAAS,EAAE,QAAwC;QACpE,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC1C,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACrG,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACjD,CAAC;IAEO,OAAO,CAAC,CAAS;QACvB,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;gBACxF,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAE,CAAC;gBAC9C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAAE,SAAS;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/C,IAAI,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,eAAe,CAAC,KAAgC;QACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,KAAK;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAEO,eAAe,CAAC,KAAgC,EAAE,CAAS;QACjE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/F,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACK,uBAAuB,CAAC,GAAY,EAAE,CAAS;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,gBAAgB,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1F,OAAO,GAAG,UAAU,KAAK,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACzD,CAAC;IAEO,oBAAoB,CAAC,IAAU,EAAE,CAAS;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvF,OAAO,GAAG,WAAW,IAAI,WAAW,GAAG,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"BatchPlanner.js","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/BatchPlanner.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,56 @@
+import type { Segment } from '../../document/Segment';
+import type { PreparedStyle } from '../../rendering/subtitle/PreparedStyle';
+import type { SegmentSubtreeHtmlBuilder, SegmentSubtreeStyleInput } from '../../rendering/subtitle/SegmentSubtreeHtmlBuilder';
+import { ElementWidths } from '../../rendering/subtitle/ElementWidths';
+/**
+ * How wide a caption's elements lay out, measured by mounting the
+ * subtree under the consumer's own stylesheet and reading the boxes
+ * back. Answers once per caption per style and reuses that for every
+ * frame the caption is on screen; `clear` drops what it kept.
+ *
+ * Segments, lines and words answer, and nothing else does. They are the
+ * three a stylesheet lays text out in, and every extra kind costs
+ * another custom property on every rendered element for a question no
+ * stylesheet has asked yet. Adding a kind is adding its variable here.
+ *
+ * A style whose CSS reads none of the properties is never measured: the
+ * work is a mount and a layout read, and nothing would consume it.
+ *
+ * Measuring the subtree as it is really built is what keeps the answer
+ * honest. Whatever classes the caption carries at that moment are on
+ * it, so a template that restyles a whole caption on a render state is
+ * measured in the typography that state produces, with no second
+ * description of that state to keep in step.
+ */
+export declare class ElementWidthMeasurer {
+    private readonly subtreeBuilder;
+    private readonly viewportWidth;
+    private readonly viewportHeight;
+    private readonly widthsByKey;
+    constructor(subtreeBuilder: SegmentSubtreeHtmlBuilder, viewportWidth: number, viewportHeight: number);
+    widthsFor(style: PreparedStyle, styleInput: SegmentSubtreeStyleInput, segment: Segment, t: number, indexInSection: number): ElementWidths;
+    clear(): void;
+    private styleReadsAnyWidth;
+    private measure;
+    /**
+     * The subtree as it will really be built, with every element named so
+     * its box can be found again afterwards.
+     *
+     * The widths are deliberately absent from it. A stylesheet sizing text
+     * from its own width would otherwise have to be measured at the size
+     * it is being asked to produce; leaving the properties unset lets the
+     * rule fall back, and since the answer is a multiple of the font size,
+     * whichever size the fallback lands on gives the same one.
+     */
+    private buildMeasurableSubtree;
+    private everyElementId;
+    /**
+     * An element that generates no box reports zero. That is the true
+     * answer rather than a missing one — a stylesheet asking the width of
+     * something it took out of flow is asking about a box that is not
+     * there.
+     */
+    private readWidths;
+    private widthEmOf;
+}
+//# sourceMappingURL=ElementWidthMeasurer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElementWidthMeasurer.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/subtitle/ElementWidthMeasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AACjI,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAS1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc;IALjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;gBAG7C,cAAc,EAAE,yBAAyB,EACzC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM;IAGzC,SAAS,CACP,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,wBAAwB,EACpC,OAAO,EAAE,OAAO,EAChB,CAAC,EAAE,MAAM,EACT,cAAc,EAAE,MAAM,GACrB,aAAa;IAWhB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,OAAO;IAuBf;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,cAAc;IAStB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;CAKlB"}