@tscaps/engine 0.1.1 → 0.2.1

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

@@ -0,0 +1,112 @@
+import { CssVariable } from '../../document/CssVariable';
+const NO_EXCLUDED_WORDS = new Set();
+// Safety bleed applied to the painted region for video-frame styles
+// that don't declare a `rendering.padding`. 0.25em ≈ enough to cover
+// a typical text-shadow, kept narrow so the crop still pays off.
+const UNDECLARED_PADDING_SAFETY_EM = 0.25;
+/**
+ * Builds the inline-style map driving the video-frame backdrop for
+ * one segment: the JPEG data URL holding the painted region of the
+ * underlying frame, plus the region's pixel size and offset within
+ * the segment's anchor box. Caches paint regions per
+ * `(kind, segmentId)` so the JPEG crop is only measured once per
+ * segment.
+ *
+ * Returns an empty map for styles that don't consume the video
+ * frame.
+ */
+export class VideoFrameVarsBuilder {
+    subtreeBuilder;
+    paintRegionResolver;
+    paintRegionCache;
+    width;
+    height;
+    videoFrameSource;
+    constructor(subtreeBuilder, paintRegionResolver, paintRegionCache, width, height, videoFrameSource) {
+        this.subtreeBuilder = subtreeBuilder;
+        this.paintRegionResolver = paintRegionResolver;
+        this.paintRegionCache = paintRegionCache;
+        this.width = width;
+        this.height = height;
+        this.videoFrameSource = videoFrameSource;
+    }
+    async build(style, seg, placement, t) {
+        if (!style.rendering.videoFrame.required)
+            return {};
+        const region = this.resolvePaintRegion(style, seg, placement);
+        // Offset vars assume the consuming element is a direct child of
+        // the wrapper: `%` resolves against the wrapper. The region.x/y
+        // bias positions the layer so the cropped frame's (0,0) lands on
+        // viewport (region.x, region.y); when no crop applies the bias
+        // is zero and the layer covers the full viewport.
+        return {
+            [CssVariable.VIDEO_FRAME]: `url("${await this.videoFrameSource.getFrameAt(t, style.rendering.videoFrame.jpegQuality, region)}")`,
+            [CssVariable.SUBTITLE_REGION_WIDTH]: `${region.width}px`,
+            [CssVariable.SUBTITLE_REGION_HEIGHT]: `${region.height}px`,
+            [CssVariable.SUBTITLE_REGION_X]: `calc(${placement.hAnchorPct}% - ${placement.xPx - region.x}px)`,
+            [CssVariable.SUBTITLE_REGION_Y]: `calc(${placement.vAnchorPct}% - ${placement.yPx - region.y}px)`,
+        };
+    }
+    /**
+     * The tight-crop optimization assumes every word stays inside the
+     * segment's in-flow bounding box. As soon as a word is
+     * repositioned outside that bbox, the same crop leaves its
+     * video-frame backdrop sampling pixels that aren't in the JPEG
+     * payload. Falling back to the full viewport for those segments
+     * restores correctness; the optimization recovers automatically
+     * the moment the override is reset.
+     */
+    resolvePaintRegion(style, seg, placement) {
+        return this.paintRegionCache.getOrCompute(style.kind, seg.id, () => this.hasPositionedWord(seg, style.wordOverrides) || this.hasPositionedDecoration(seg, style)
+            ? { x: 0, y: 0, width: this.width, height: this.height }
+            : this.measureSegmentPaintRegion(style, seg, placement));
+    }
+    measureSegmentPaintRegion(style, seg, placement) {
+        const segmentInlineStylesOverride = style.segmentOverrides.get(seg.id)?.inlineStyles;
+        const baseInlineStyles = segmentInlineStylesOverride
+            ? { ...style.inlineStyles, ...segmentInlineStylesOverride }
+            : style.inlineStyles;
+        const segmentHtml = this.subtreeBuilder.buildSegmentSubtree({
+            scopeClass: style.scopeClass,
+            baseInlineStyles,
+            wordOverrides: style.wordOverrides,
+            splitWordsIntoLetters: style.rendering.splitWordsIntoLetters,
+            includeVideoFrameLayer: style.rendering.videoFrame.required,
+            extraWrapperStyles: {},
+            decorationPlacements: style.decorationPlacements,
+            inlineStyleEmitter: style.inlineStyleEmitter,
+        }, seg, seg.time.start, NO_EXCLUDED_WORDS, 
+        // Paint-region measurement renders the segment in isolation; the
+        // index inside the section doesn't affect layout, so any value works.
+        0);
+        return this.paintRegionResolver.resolve({
+            segmentHtml,
+            probeContainer: style.probeContainer,
+            placement,
+            viewportWidth: this.width,
+            viewportHeight: this.height,
+            safetyBleedEm: style.rendering.padding === null ? UNDECLARED_PADDING_SAFETY_EM : 0,
+        });
+    }
+    hasPositionedWord(seg, wordOverrides) {
+        for (const line of seg.lines) {
+            for (const word of line.words) {
+                if (wordOverrides.get(word.id)?.alignment)
+                    return true;
+            }
+        }
+        return false;
+    }
+    hasPositionedDecoration(seg, style) {
+        for (const line of seg.lines) {
+            for (const word of line.words) {
+                if (!word.decoration)
+                    continue;
+                if (style.wordOverrides.get(word.decoration.id)?.alignment)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=VideoFrameVarsBuilder.js.map

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

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

package/dist/modules/rendering/types/AlignmentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlignmentConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/AlignmentConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAE7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IAEjC,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/modules/rendering/types/AlignmentConfig.js.map

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

package/dist/modules/rendering/types/BehindActorRequirement.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether a style participates in the "text-behind-actor" rendering
+ * primitive: the caption is rasterised as usual, and the consumer paints
+ * an actor cutout layer on top at composition time so the actor visually
+ * covers the caption. The engine exposes the state variables and the
+ * baseline CSS that resolves the final `--behind-actor-active` decision;
+ * the consumer supplies the cutout pixels outside the caption HTML.
+ */
+export interface BehindActorRequirement {
+    readonly required: boolean;
+}
+//# sourceMappingURL=BehindActorRequirement.d.ts.map

package/dist/modules/rendering/types/BehindActorRequirement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehindActorRequirement.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/BehindActorRequirement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B"}

package/dist/modules/rendering/types/BehindActorRequirement.js

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

package/dist/modules/rendering/types/BehindActorRequirement.js.map

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

package/dist/modules/rendering/types/BoxEdges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxEdges.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/BoxEdges.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/modules/rendering/types/BoxEdges.js.map

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

package/dist/modules/rendering/types/DecorationPlacementSide.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Which side of the segment a decoration glyph should be lifted to
+ * when the host sheet's effect config takes it out of line flow. When
+ * a decoration id is absent from the placement map, the glyph stays
+ * inline next to its host word.
+ */
+export type DecorationPlacementSide = 'above' | 'below';
+//# sourceMappingURL=DecorationPlacementSide.d.ts.map

package/dist/modules/rendering/types/DecorationPlacementSide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecorationPlacementSide.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/DecorationPlacementSide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,OAAO,CAAC"}

package/dist/modules/rendering/types/DecorationPlacementSide.js

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

package/dist/modules/rendering/types/DecorationPlacementSide.js.map

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

package/dist/modules/rendering/{ElementRenderOverrides.d.ts → types/ElementRenderOverrides.d.ts}

@@ -1,4 +1,4 @@
-import type { ScopedRenderOverride } from '../rendering/ScopedRenderOverride';
+import type { ScopedRenderOverride } from '../../rendering/types/ScopedRenderOverride';
 /**
  * Render-time overrides indexed by element id.
  * The bitmap renderer looks up each element by

package/dist/modules/rendering/types/ElementRenderOverrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementRenderOverrides.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ElementRenderOverrides.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAE1F;;;;GAIG;AACH,qBAAa,sBAAsB;IAY/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,MAAM,CAAC,KAAK,IAAI,sBAAsB;IAItC,MAAM,CAAC,WAAW,CAChB,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,GAC9D,sBAAsB;IAIzB,OAAO;IAIP,OAAO,IAAI,OAAO;IAIlB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;CAGzD"}

package/dist/modules/rendering/types/ElementRenderOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementRenderOverrides.js","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ElementRenderOverrides.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAYd;IAXnB,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,sBAAsB,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,OAA+D;QAE/D,OAAO,IAAI,sBAAsB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,YACmB,OAAkD;QAAlD,YAAO,GAAP,OAAO,CAA2C;IAClE,CAAC;IAEJ,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/modules/rendering/types/InlineStyleMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineStyleMap.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/InlineStyleMap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/modules/rendering/types/InlineStyleMap.js.map

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

package/dist/modules/rendering/{RenderingConfig.d.ts → types/RenderingConfig.d.ts}

@@ -1,4 +1,5 @@
-import type { BoxEdges } from '../rendering/BoxEdges';
+import type { BoxEdges } from '../../rendering/types/BoxEdges';
+import type { BehindActorRequirement } from '../../rendering/types/BehindActorRequirement';
 /**
  * Whether a style consumes the underlying video frame as part of
  * its visuals, and — when it does — at what JPEG quality the frame
@@ -18,5 +19,6 @@ export interface RenderingConfig {
     readonly videoFrame: VideoFrameRequirement;
     /** Extra space around the segment box, per side. `null` when not declared. */
     readonly padding: BoxEdges | null;
+    readonly behindActor: BehindActorRequirement;
 }
 //# sourceMappingURL=RenderingConfig.d.ts.map

package/dist/modules/rendering/types/RenderingConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderingConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/RenderingConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;CAC9C"}

package/dist/modules/rendering/types/RenderingConfig.js.map

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

package/dist/modules/rendering/{ScopedRenderOverride.d.ts → types/ScopedRenderOverride.d.ts}

@@ -1,5 +1,5 @@
-import type { AlignmentConfig } from '../rendering/AlignmentConfig';
-import type { InlineStyleMap } from '../rendering/InlineStyleMap';
+import type { AlignmentConfig } from '../../rendering/types/AlignmentConfig';
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
 /**
  * Render-time overrides for one element (segment or word), layered on
  * top of the style's root-level defaults. Both fields are independent

package/dist/modules/rendering/types/ScopedRenderOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedRenderOverride.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ScopedRenderOverride.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/C"}

package/dist/modules/rendering/types/ScopedRenderOverride.js.map

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

package/dist/modules/rendering/types/VideoFrameSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameSource.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/VideoFrameSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClG"}

package/dist/modules/rendering/types/VideoFrameSource.js.map

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

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.d.ts

@@ -0,0 +1,33 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface BoundaryScoreLimitByCharsConfig {
+    maxChars: number;
+    minChars: number;
+}
+/**
+ * Splits segments by character count, keeping each chunk between
+ * `minChars` and `maxChars` when possible. Among the cut positions
+ * that satisfy both bounds, the one after the word with the highest
+ * `boundaryScore` wins — cuts land where an external scorer marked a
+ * strong boundary. When no word in the valid range carries a score,
+ * the splitter falls back to the greedy behaviour: grow the chunk to
+ * the maximum and retreat only enough to keep the tail above
+ * `minChars`.
+ *
+ * When the residual tail is too short to satisfy both bounds on its
+ * own, its words are absorbed into the current chunk as a last
+ * resort.
+ */
+export declare class BoundaryScoreLimitByCharsSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: BoundaryScoreLimitByCharsConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+    private pickCut;
+    private largestCutWithinMax;
+    private smallestCutMeetingMin;
+    private cutsPreservingTail;
+    private highestScoredCut;
+    private weight;
+}
+//# sourceMappingURL=BoundaryScoreLimitByCharsSegmentSplitter.d.ts.map

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryScoreLimitByCharsSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,wCAAyC,YAAW,eAAe;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,+BAA+B;IAErE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,MAAM;CAMf"}

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.js

@@ -0,0 +1,100 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+/**
+ * Splits segments by character count, keeping each chunk between
+ * `minChars` and `maxChars` when possible. Among the cut positions
+ * that satisfy both bounds, the one after the word with the highest
+ * `boundaryScore` wins — cuts land where an external scorer marked a
+ * strong boundary. When no word in the valid range carries a score,
+ * the splitter falls back to the greedy behaviour: grow the chunk to
+ * the maximum and retreat only enough to keep the tail above
+ * `minChars`.
+ *
+ * When the residual tail is too short to satisfy both bounds on its
+ * own, its words are absorbed into the current chunk as a last
+ * resort.
+ */
+export class BoundaryScoreLimitByCharsSegmentSplitter {
+    _config;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const words = segment.getWords();
+        const n = words.length;
+        if (n === 0)
+            return [];
+        const result = [];
+        let start = 0;
+        while (start < n) {
+            const end = this.pickCut(words, start);
+            result.push(new Segment({ lines: [new Line({ words: words.slice(start, end) })] }));
+            start = end;
+        }
+        return result;
+    }
+    pickCut(words, start) {
+        const n = words.length;
+        const kHigh = this.largestCutWithinMax(words, start);
+        if (kHigh === n)
+            return n;
+        const kLow = this.smallestCutMeetingMin(words, start, kHigh);
+        if (kLow > kHigh)
+            return kHigh;
+        const candidates = this.cutsPreservingTail(words, kLow, kHigh);
+        if (candidates.length === 0)
+            return n;
+        return this.highestScoredCut(words, candidates);
+    }
+    largestCutWithinMax(words, start) {
+        const { maxChars } = this._config;
+        const n = words.length;
+        let end = start + 1;
+        while (end < n && this.weight(words, start, end + 1) <= maxChars)
+            end++;
+        return end;
+    }
+    smallestCutMeetingMin(words, start, upperBound) {
+        const { minChars } = this._config;
+        let k = start + 1;
+        while (k <= upperBound && this.weight(words, start, k) < minChars)
+            k++;
+        return k;
+    }
+    cutsPreservingTail(words, kLow, kHigh) {
+        const { minChars } = this._config;
+        const n = words.length;
+        const candidates = [];
+        for (let k = kLow; k <= kHigh; k++) {
+            if (this.weight(words, k, n) >= minChars)
+                candidates.push(k);
+        }
+        return candidates;
+    }
+    highestScoredCut(words, candidates) {
+        let best = candidates[candidates.length - 1];
+        let bestScore = -Infinity;
+        for (const k of candidates) {
+            const score = words[k - 1].boundaryScore;
+            if (score === null)
+                continue;
+            if (score > bestScore || (score === bestScore && k > best)) {
+                bestScore = score;
+                best = k;
+            }
+        }
+        return best;
+    }
+    weight(words, from, to) {
+        if (to <= from)
+            return 0;
+        let chars = to - from - 1;
+        for (let k = from; k < to; k++)
+            chars += words[k].text.length;
+        return chars;
+    }
+}
+//# sourceMappingURL=BoundaryScoreLimitByCharsSegmentSplitter.js.map

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.js.map

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

package/dist/modules/splitting/FixedTailLineSplitter.d.ts

@@ -0,0 +1,29 @@
+import type { LineSplitter } from '../splitting/LineSplitter';
+import { Segment } from '../document/Segment';
+export interface FixedTailLineSplitterConfig {
+    /**
+     * Word count reserved for the second (tail) line. Honored only when the
+     * segment carries strictly more words than this value; otherwise the
+     * splitter falls back to a one-word head and a tail with the rest, so
+     * neither line is empty.
+     */
+    readonly tailWordCount: number;
+}
+/**
+ * Splits each segment into exactly two lines when possible: the head line
+ * receives every word except the last `tailWordCount`, and the tail line
+ * receives those final words. Segments with one or two words stay on a
+ * single line; segments with three or more words but fewer than
+ * `tailWordCount + 1` fall back to one word on the head and the remainder
+ * on the tail, so neither line ends up empty.
+ */
+export declare class FixedTailLineSplitter implements LineSplitter {
+    private readonly _config;
+    private static readonly MIN_WORDS_TO_SPLIT;
+    constructor(_config: FixedTailLineSplitterConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+    private buildLines;
+    private headSize;
+}
+//# sourceMappingURL=FixedTailLineSplitter.d.ts.map

package/dist/modules/splitting/FixedTailLineSplitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedTailLineSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/FixedTailLineSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IAG5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;gBAElB,OAAO,EAAE,2BAA2B;IAEjE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/modules/splitting/FixedTailLineSplitter.js

@@ -0,0 +1,43 @@
+import { Line } from '../document/Line';
+/**
+ * Splits each segment into exactly two lines when possible: the head line
+ * receives every word except the last `tailWordCount`, and the tail line
+ * receives those final words. Segments with one or two words stay on a
+ * single line; segments with three or more words but fewer than
+ * `tailWordCount + 1` fall back to one word on the head and the remainder
+ * on the tail, so neither line ends up empty.
+ */
+export class FixedTailLineSplitter {
+    _config;
+    static MIN_WORDS_TO_SPLIT = 3;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.map((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const words = segment.getWords();
+        if (words.length === 0)
+            return segment;
+        const lines = this.buildLines(words);
+        return segment.with({ lines });
+    }
+    buildLines(words) {
+        if (words.length < FixedTailLineSplitter.MIN_WORDS_TO_SPLIT) {
+            return [new Line({ words })];
+        }
+        const splitAt = this.headSize(words.length);
+        return [
+            new Line({ words: words.slice(0, splitAt) }),
+            new Line({ words: words.slice(splitAt) }),
+        ];
+    }
+    headSize(totalWords) {
+        if (totalWords > this._config.tailWordCount) {
+            return totalWords - this._config.tailWordCount;
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=FixedTailLineSplitter.js.map

package/dist/modules/splitting/FixedTailLineSplitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedTailLineSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/FixedTailLineSplitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAa9C;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IAGH;IAFrB,MAAM,CAAU,kBAAkB,GAAG,CAAC,CAAC;IAE/C,YAA6B,OAAoC;QAApC,YAAO,GAAP,OAAO,CAA6B;IAAG,CAAC;IAErE,KAAK,CAAC,QAAgC;QACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEO,YAAY,CAAC,OAAgB;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,UAAkB;QACjC,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC5C,OAAO,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC"}

package/dist/modules/splitting/index.d.ts

@@ -6,6 +6,8 @@ export { LimitByCharsSegmentSplitter } from '../splitting/LimitByCharsSegmentSpl
 export type { LimitByCharsConfig } from '../splitting/LimitByCharsSegmentSplitter';
 export { LimitByScaledCharsSegmentSplitter } from '../splitting/LimitByScaledCharsSegmentSplitter';
 export type { LimitByScaledCharsConfig } from '../splitting/LimitByScaledCharsSegmentSplitter';
+export { BoundaryScoreLimitByCharsSegmentSplitter } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
+export type { BoundaryScoreLimitByCharsConfig } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
 export { BoundarySegmentSplitter } from '../splitting/BoundarySegmentSplitter';
 export type { BoundaryConfig } from '../splitting/BoundarySegmentSplitter';
 export { PauseBasedSegmentSplitter } from '../splitting/PauseBasedSegmentSplitter';
@@ -16,6 +18,8 @@ export { BalancedLineSplitter } from '../splitting/BalancedLineSplitter';
 export type { BalancedLineSplitterConfig } from '../splitting/BalancedLineSplitter';
 export { BalancedPixelWidthLineSplitter } from '../splitting/BalancedPixelWidthLineSplitter';
 export type { BalancedPixelWidthLineSplitterConfig } from '../splitting/BalancedPixelWidthLineSplitter';
+export { FixedTailLineSplitter } from '../splitting/FixedTailLineSplitter';
+export type { FixedTailLineSplitterConfig } from '../splitting/FixedTailLineSplitter';
 export type { TextMeasurer } from '../splitting/TextMeasurer';
 export { DomProbeCanvasTextMeasurer } from '../splitting/DomProbeCanvasTextMeasurer';
 export type { DomProbeCanvasTextMeasurerParams } from '../splitting/DomProbeCanvasTextMeasurer';

package/dist/modules/splitting/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,YAAY,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,YAAY,EAAE,oCAAoC,EAAE,MAAM,mDAAmD,CAAC;AAC9G,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,YAAY,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACtG,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,YAAY,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,wCAAwC,EAAE,MAAM,6DAA6D,CAAC;AACvH,YAAY,EAAE,+BAA+B,EAAE,MAAM,6DAA6D,CAAC;AACnH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,YAAY,EAAE,oCAAoC,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,YAAY,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,YAAY,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACtG,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/modules/splitting/index.js

@@ -2,11 +2,13 @@ export { CompositeSegmentSplitter } from '../splitting/CompositeSegmentSplitter'
 export { LimitByWordsSegmentSplitter } from '../splitting/LimitByWordsSegmentSplitter';
 export { LimitByCharsSegmentSplitter } from '../splitting/LimitByCharsSegmentSplitter';
 export { LimitByScaledCharsSegmentSplitter } from '../splitting/LimitByScaledCharsSegmentSplitter';
+export { BoundaryScoreLimitByCharsSegmentSplitter } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
 export { BoundarySegmentSplitter } from '../splitting/BoundarySegmentSplitter';
 export { PauseBasedSegmentSplitter } from '../splitting/PauseBasedSegmentSplitter';
 export { SpeakerChangeSegmentSplitter } from '../splitting/SpeakerChangeSegmentSplitter';
 export { BalancedLineSplitter } from '../splitting/BalancedLineSplitter';
 export { BalancedPixelWidthLineSplitter } from '../splitting/BalancedPixelWidthLineSplitter';
+export { FixedTailLineSplitter } from '../splitting/FixedTailLineSplitter';
 export { DomProbeCanvasTextMeasurer } from '../splitting/DomProbeCanvasTextMeasurer';
 export { GraphemeWordSplitter } from '../splitting/GraphemeWordSplitter';
 //# sourceMappingURL=index.js.map

package/dist/modules/splitting/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AAEzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAE/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AAGnG,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AAEzG,OAAO,EAAE,wCAAwC,EAAE,MAAM,6DAA6D,CAAC;AAEvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAE/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AAEnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/modules/tagging/PauseTagger.d.ts

@@ -0,0 +1,24 @@
+import { Tagger } from '../tagging/Tagger';
+import { Document } from '../document/Document';
+export interface PauseTaggerConfig {
+    /**
+     * Minimum gap, in seconds, between a segment's start and the previous
+     * segment's end for the segment to be marked as following a pause.
+     */
+    readonly minGapSeconds: number;
+}
+/**
+ * Adds `SEGMENT_AFTER_PAUSE` to every segment whose start is preceded by
+ * a silent gap of at least `minGapSeconds`. Gaps are measured only within
+ * the same section: the first segment of each section is never tagged
+ * (positional first/last tags already cover that boundary).
+ */
+export declare class PauseTagger extends Tagger {
+    private readonly _config;
+    constructor(_config: PauseTaggerConfig);
+    tag(document: Document): Document;
+    private tagSection;
+    private tagSegmentIfAfterPause;
+    private followsPause;
+}
+//# sourceMappingURL=PauseTagger.d.ts.map

package/dist/modules/tagging/PauseTagger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PauseTagger.d.ts","sourceRoot":"","sources":["../../../src/modules/tagging/PauseTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAKtD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,MAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,iBAAiB;IAIvD,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAKjC,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,YAAY;CAIrB"}

package/dist/modules/tagging/PauseTagger.js

@@ -0,0 +1,41 @@
+import { Tagger } from '../tagging/Tagger';
+import { Tag, StructureTag } from '../document/Tag';
+/**
+ * Adds `SEGMENT_AFTER_PAUSE` to every segment whose start is preceded by
+ * a silent gap of at least `minGapSeconds`. Gaps are measured only within
+ * the same section: the first segment of each section is never tagged
+ * (positional first/last tags already cover that boundary).
+ */
+export class PauseTagger extends Tagger {
+    _config;
+    constructor(_config) {
+        super();
+        this._config = _config;
+    }
+    tag(document) {
+        const sections = document.sections.map((section) => this.tagSection(section));
+        return document.with({ sections });
+    }
+    tagSection(section) {
+        let previousEndSeconds = null;
+        const segments = section.segments.map((segment) => {
+            const tagged = this.tagSegmentIfAfterPause(segment, previousEndSeconds);
+            previousEndSeconds = segment.time.end;
+            return tagged;
+        });
+        return section.with({ segments });
+    }
+    tagSegmentIfAfterPause(segment, previousEndSeconds) {
+        if (!this.followsPause(segment, previousEndSeconds))
+            return segment;
+        const structureTags = new Set(segment.structureTags);
+        structureTags.add(Tag.of(StructureTag.SEGMENT_AFTER_PAUSE));
+        return segment.with({ structureTags });
+    }
+    followsPause(segment, previousEndSeconds) {
+        if (previousEndSeconds === null)
+            return false;
+        return segment.time.start - previousEndSeconds >= this._config.minGapSeconds;
+    }
+}
+//# sourceMappingURL=PauseTagger.js.map

package/dist/modules/tagging/PauseTagger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PauseTagger.js","sourceRoot":"","sources":["../../../src/modules/tagging/PauseTagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAU1D;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,MAAM;IACR;IAA7B,YAA6B,OAA0B;QACrD,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAmB;IAEvD,CAAC;IAED,GAAG,CAAC,QAAkB;QACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IAEO,UAAU,CAAC,OAAgB;QACjC,IAAI,kBAAkB,GAAkB,IAAI,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;YACxE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YACtC,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC;IAEO,sBAAsB,CAAC,OAAgB,EAAE,kBAAiC;QAChF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC;YAAE,OAAO,OAAO,CAAC;QACpE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAM,OAAO,CAAC,aAAa,CAAC,CAAC;QAC1D,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IACzC,CAAC;IAEO,YAAY,CAAC,OAAgB,EAAE,kBAAiC;QACtE,IAAI,kBAAkB,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,kBAAkB,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;IAC/E,CAAC;CACF"}

package/dist/modules/tagging/StructureTagger.d.ts

@@ -3,7 +3,7 @@ import { Document } from '../document/Document';
 /**
  * Assigns positional structure tags across the Document hierarchy:
  *   - Section-level: FIRST/LAST_SECTION_IN_DOCUMENT
- *   - Segment-level: FIRST/LAST_SEGMENT_IN_SECTION
+ *   - Segment-level: FIRST/LAST_SEGMENT_IN_SECTION, FIRST/LAST_SEGMENT_IN_DOCUMENT
  *   - Line-level:    FIRST/LAST_LINE_IN_SECTION, FIRST/LAST_LINE_IN_SEGMENT
  *   - Word-level:    FIRST/LAST_WORD_IN_SECTION, FIRST/LAST_WORD_IN_SEGMENT,
  *                    FIRST/LAST_WORD_IN_LINE