@tscaps/engine 0.1.1

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

@@ -0,0 +1,56 @@
+import type { TextMeasurer } from '../splitting/TextMeasurer';
+export interface DomProbeCanvasTextMeasurerParams {
+    /** CSS (raw, unscoped). Cascade source for the probe. */
+    css: string;
+    /** Custom properties to apply on the probe. */
+    cssVars: Record<string, string>;
+    /** Probe container width in px. Anchors `cqw` resolution without layout. */
+    containerWidth: number;
+    /** Probe container height in px. Anchors `cqh` resolution without layout. */
+    containerHeight: number;
+}
+/**
+ * Resolves text width by reading typography from a persistent
+ * shadow-encapsulated DOM probe and measuring with Canvas 2D `measureText`.
+ * Effects that `measureText` does not natively apply — letter-spacing,
+ * word-spacing, padding, margin, `text-transform` — are read from the
+ * probe and added analytically.
+ *
+ * `@font-face` blocks are stripped from `css` before injection: re-applying
+ * them resets `document.fonts.status` to 'loading'.
+ *
+ * Repeated constructions with the same `(css, cssVars, container size)`
+ * reuse a previously resolved typography from a module-level cache and
+ * touch no DOM.
+ */
+export declare class DomProbeCanvasTextMeasurer implements TextMeasurer {
+    private readonly _typography;
+    constructor(params: DomProbeCanvasTextMeasurerParams);
+    measure(text: string): number;
+    spaceWidth(): number;
+    private probe;
+    private signatureOf;
+    private ensureProbe;
+    private syncContainerSize;
+    private syncCss;
+    /**
+     * Diff the requested cssVars against what was last applied to the probe
+     * and write only the deltas. Each `setProperty` invalidates the style
+     * cache for the subtree, so writing unchanged values would inflate the
+     * next computed-style read for no reason.
+     */
+    private syncCssVars;
+    private ensureCanvasContext;
+    /**
+     * Freeze the element at its final keyframe so the read reflects the
+     * resting layout. Without this, computed style for any animated
+     * layout-affecting property (font-size, letter-spacing, padding…)
+     * lands at the `0%` state.
+     */
+    private pinAnimations;
+    private requireValue;
+    private parsePx;
+    private normalizeTextTransform;
+    private applyTransform;
+}
+//# sourceMappingURL=DomProbeCanvasTextMeasurer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomProbeCanvasTextMeasurer.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/DomProbeCanvasTextMeasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAMpE,MAAM,WAAW,gCAAgC;IAC/C,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC;CACzB;AAoCD;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA2B,YAAW,YAAY;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAErC,MAAM,EAAE,gCAAgC;IAYpD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY7B,UAAU,IAAI,MAAM;IAMpB,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,OAAO;IAOf;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,mBAAmB;IAO3B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,cAAc;CAQvB"}

package/dist/modules/splitting/DomProbeCanvasTextMeasurer.js

@@ -0,0 +1,197 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+import { Word } from '../document/Word';
+import { LineState } from '../document/LineState';
+// Probe DOM is persistent and shadow-encapsulated. Re-mounting per call
+// would invalidate the document style + layout cache, and the follow-up
+// `getComputedStyle` read would force a synchronous flush — the very cost
+// this class exists to avoid. The shadow boundary keeps the probe's
+// `<style>` rules from matching elements outside the probe subtree.
+let _styleEl = null;
+let _container = null;
+let _word = null;
+let _cctx = null;
+// Last DOM state actually applied to the probe. A subsequent call that
+// matches a tracked value skips the corresponding write — every write
+// invalidates the style cache and inflates the next computed-style read.
+let _appliedCss = null;
+let _appliedWidth = null;
+let _appliedHeight = null;
+let _appliedCssVars = new Map();
+// Resolved typography keyed by the `(css, size, cssVars)` signature that
+// produced it. Cache hits skip the probe entirely — no DOM writes, no
+// `getComputedStyle`, no style flush.
+const _typographyCache = new Map();
+/**
+ * Resolves text width by reading typography from a persistent
+ * shadow-encapsulated DOM probe and measuring with Canvas 2D `measureText`.
+ * Effects that `measureText` does not natively apply — letter-spacing,
+ * word-spacing, padding, margin, `text-transform` — are read from the
+ * probe and added analytically.
+ *
+ * `@font-face` blocks are stripped from `css` before injection: re-applying
+ * them resets `document.fonts.status` to 'loading'.
+ *
+ * Repeated constructions with the same `(css, cssVars, container size)`
+ * reuse a previously resolved typography from a module-level cache and
+ * touch no DOM.
+ */
+export class DomProbeCanvasTextMeasurer {
+    _typography;
+    constructor(params) {
+        const css = params.css.replace(/@font-face[^{]*\{[^}]*\}/g, '');
+        const signature = this.signatureOf(css, params);
+        const cached = _typographyCache.get(signature);
+        if (cached) {
+            this._typography = cached;
+            return;
+        }
+        this._typography = this.probe(css, params);
+        _typographyCache.set(signature, this._typography);
+    }
+    measure(text) {
+        const t = this.applyTransform(text, this._typography.textTransform);
+        const cctx = this.ensureCanvasContext();
+        cctx.font = this._typography.font;
+        return (cctx.measureText(t).width +
+            Math.max(0, t.length - 1) * this._typography.letterSpacingPx +
+            this._typography.paddingX +
+            this._typography.marginX);
+    }
+    spaceWidth() {
+        const cctx = this.ensureCanvasContext();
+        cctx.font = this._typography.font;
+        return cctx.measureText(' ').width + this._typography.wordSpacingPx + this._typography.letterSpacingPx;
+    }
+    probe(css, params) {
+        const probe = this.ensureProbe();
+        this.syncContainerSize(probe.container, params.containerWidth, params.containerHeight);
+        this.syncCss(css);
+        this.syncCssVars(probe.container, params.cssVars);
+        const cs = getComputedStyle(probe.word);
+        const fontStyle = this.requireValue(cs.fontStyle, 'font-style');
+        const fontWeight = this.requireValue(cs.fontWeight, 'font-weight');
+        const fontSize = this.requireValue(cs.fontSize, 'font-size');
+        const fontFamily = this.requireValue(cs.fontFamily, 'font-family');
+        return {
+            font: `${fontStyle} ${fontWeight} ${fontSize} ${fontFamily}`,
+            letterSpacingPx: this.parsePx(cs.letterSpacing),
+            wordSpacingPx: this.parsePx(cs.wordSpacing),
+            paddingX: this.parsePx(cs.paddingLeft) + this.parsePx(cs.paddingRight),
+            marginX: this.parsePx(cs.marginLeft) + this.parsePx(cs.marginRight),
+            textTransform: this.normalizeTextTransform(cs.textTransform),
+        };
+    }
+    signatureOf(css, params) {
+        const keys = Object.keys(params.cssVars).sort();
+        const cssVarsStr = keys.map((k) => `${k}=${params.cssVars[k]}`).join(';');
+        return `${params.containerWidth}x${params.containerHeight}|${cssVarsStr}|${css}`;
+    }
+    ensureProbe() {
+        if (_container && _word)
+            return { container: _container, word: _word };
+        const host = document.createElement('div');
+        host.style.cssText =
+            `position:fixed;left:-99999px;top:-99999px;visibility:hidden;pointer-events:none;`;
+        const shadow = host.attachShadow({ mode: 'open' });
+        _styleEl = document.createElement('style');
+        shadow.appendChild(_styleEl);
+        _container = document.createElement('div');
+        _container.style.cssText = `container-type:size;`;
+        this.pinAnimations(_container);
+        const segmentEl = document.createElement('div');
+        segmentEl.className = Segment.CSS_CLASS;
+        this.pinAnimations(segmentEl);
+        const lineEl = document.createElement('div');
+        lineEl.className = `${Line.CSS_CLASS} ${LineState.NOT_NARRATED_YET}`;
+        this.pinAnimations(lineEl);
+        _word = document.createElement('span');
+        _word.className = `${Word.CSS_CLASS} ${LineState.NOT_NARRATED_YET}`;
+        _word.textContent = 'M';
+        this.pinAnimations(_word);
+        lineEl.appendChild(_word);
+        segmentEl.appendChild(lineEl);
+        _container.appendChild(segmentEl);
+        shadow.appendChild(_container);
+        document.body.appendChild(host);
+        return { container: _container, word: _word };
+    }
+    syncContainerSize(container, width, height) {
+        if (width !== _appliedWidth) {
+            container.style.width = `${width}px`;
+            _appliedWidth = width;
+        }
+        if (height !== _appliedHeight) {
+            container.style.height = `${height}px`;
+            _appliedHeight = height;
+        }
+    }
+    syncCss(css) {
+        if (css !== _appliedCss) {
+            _styleEl.textContent = css;
+            _appliedCss = css;
+        }
+    }
+    /**
+     * Diff the requested cssVars against what was last applied to the probe
+     * and write only the deltas. Each `setProperty` invalidates the style
+     * cache for the subtree, so writing unchanged values would inflate the
+     * next computed-style read for no reason.
+     */
+    syncCssVars(container, cssVars) {
+        for (const [k, v] of Object.entries(cssVars)) {
+            if (_appliedCssVars.get(k) !== v) {
+                container.style.setProperty(k, v);
+            }
+        }
+        for (const k of _appliedCssVars.keys()) {
+            if (!(k in cssVars)) {
+                container.style.removeProperty(k);
+            }
+        }
+        _appliedCssVars = new Map(Object.entries(cssVars));
+    }
+    ensureCanvasContext() {
+        if (!_cctx) {
+            _cctx = document.createElement('canvas').getContext('2d');
+        }
+        return _cctx;
+    }
+    /**
+     * Freeze the element at its final keyframe so the read reflects the
+     * resting layout. Without this, computed style for any animated
+     * layout-affecting property (font-size, letter-spacing, padding…)
+     * lands at the `0%` state.
+     */
+    pinAnimations(el) {
+        el.style.animationPlayState = 'paused';
+        el.style.animationDelay = '-1000s';
+        el.style.animationFillMode = 'both';
+    }
+    requireValue(value, propertyName) {
+        if (!value) {
+            throw new Error(`DomProbeCanvasTextMeasurer: getComputedStyle returned empty ${propertyName} on the probe word — typography cannot be resolved.`);
+        }
+        return value;
+    }
+    parsePx(value) {
+        if (!value || value === 'normal')
+            return 0;
+        const n = parseFloat(value);
+        return Number.isFinite(n) ? n : 0;
+    }
+    normalizeTextTransform(value) {
+        if (value === 'uppercase' || value === 'lowercase' || value === 'capitalize')
+            return value;
+        return 'none';
+    }
+    applyTransform(text, t) {
+        switch (t) {
+            case 'uppercase': return text.toUpperCase();
+            case 'lowercase': return text.toLowerCase();
+            case 'capitalize': return text.replace(/(?:^|\s)\S/g, (c) => c.toUpperCase());
+            default: return text;
+        }
+    }
+}
+//# sourceMappingURL=DomProbeCanvasTextMeasurer.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { WordSplitter } from '../splitting/WordSplitter';
+/**
+ * Splits text into grapheme clusters — the units the user perceives as
+ * single characters. Correctly handles surrogate pairs, combining marks,
+ * ZWJ sequences, and regional-indicator flags, which `[...str]` shatters.
+ */
+export declare class GraphemeWordSplitter implements WordSplitter {
+    private readonly segmenter;
+    split(text: string): string[];
+}
+//# sourceMappingURL=GraphemeWordSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphemeWordSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/GraphemeWordSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8D;IAExF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;CAG9B"}

package/dist/modules/splitting/GraphemeWordSplitter.js

@@ -0,0 +1,12 @@
+/**
+ * Splits text into grapheme clusters — the units the user perceives as
+ * single characters. Correctly handles surrogate pairs, combining marks,
+ * ZWJ sequences, and regional-indicator flags, which `[...str]` shatters.
+ */
+export class GraphemeWordSplitter {
+    segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+    split(text) {
+        return Array.from(this.segmenter.segment(text), (s) => s.segment);
+    }
+}
+//# sourceMappingURL=GraphemeWordSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphemeWordSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/GraphemeWordSplitter.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IACd,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAExF,KAAK,CAAC,IAAY;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface LimitByCharsConfig {
+    maxChars: number;
+    minChars: number;
+    minDuration: number;
+    minLastWordDuration: number;
+}
+export declare class LimitByCharsSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: LimitByCharsConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+}
+//# sourceMappingURL=LimitByCharsSegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitByCharsSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/LimitByCharsSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAUD,qBAAa,2BAA4B,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAExD,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;CAiDrB"}

package/dist/modules/splitting/LimitByCharsSegmentSplitter.js

@@ -0,0 +1,64 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+// Splits segments so that no segment exceeds `maxChars` characters.
+// If the remaining words after a cut would be fewer than `minChars` characters,
+// or their total duration would be less than `minDuration` seconds, they are
+// absorbed into the current segment instead of forming a new one.
+// `minLastWordDuration` (seconds) protects templates that reveal words as they
+// are narrated: when the chunk's tail word would be on screen for less than
+// the threshold, the cut is deferred forward one word at a time until the
+// tail can stay long enough to be readable. Defaults to 0 (off).
+export class LimitByCharsSegmentSplitter {
+    _config;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const { maxChars, minChars, minDuration, minLastWordDuration } = this._config;
+        const words = segment.getWords();
+        const result = [];
+        let currentChunk = [];
+        let currentLength = 0;
+        for (let i = 0; i < words.length; i++) {
+            const word = words[i];
+            const addedLength = currentLength === 0 ? word.text.length : word.text.length + 1;
+            if (currentLength + addedLength > maxChars && currentChunk.length > 0) {
+                // Defer the cut while the chunk's tail word's narration is too short
+                // to read. Each extra word pushed in becomes the new tail and gets
+                // re-evaluated against the threshold.
+                let nextIndex = i;
+                while (nextIndex < words.length &&
+                    currentChunk[currentChunk.length - 1].time.duration < minLastWordDuration) {
+                    currentChunk.push(words[nextIndex]);
+                    nextIndex++;
+                }
+                if (nextIndex >= words.length)
+                    break;
+                const remaining = words.slice(nextIndex);
+                const remainingChars = remaining.reduce((sum, w) => sum + w.text.length, 0);
+                const remainingDuration = remaining[remaining.length - 1].time.end - remaining[0].time.start;
+                if (remainingChars < minChars || remainingDuration < minDuration) {
+                    currentChunk.push(...remaining);
+                    break;
+                }
+                result.push(new Segment({ lines: [new Line({ words: currentChunk })] }));
+                const startWord = words[nextIndex];
+                currentChunk = [startWord];
+                currentLength = startWord.text.length;
+                i = nextIndex;
+            }
+            else {
+                currentChunk.push(word);
+                currentLength += addedLength;
+            }
+        }
+        if (currentChunk.length > 0) {
+            result.push(new Segment({ lines: [new Line({ words: currentChunk })] }));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=LimitByCharsSegmentSplitter.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface LimitByScaledCharsConfig {
+    maxChars: number;
+    minChars: number;
+    scale: number;
+}
+/**
+ * Splits segments by character count weighted by a scaling factor: each
+ * character contributes `scale` to a running budget and the segment is cut
+ * so that no chunk exceeds `maxChars`. When the tail left after a greedy
+ * cut would weigh less than `minChars`, the current chunk is shrunk word
+ * by word until the tail reaches `minChars` — provided the current chunk
+ * stays at or above `minChars` itself. Only when both bounds cannot be
+ * honoured at once (e.g. the remaining text is shorter than two
+ * `minChars` blocks) are the residual words absorbed into the current
+ * chunk as a last resort.
+ *
+ * At `scale = 1` the behaviour is identical to a plain character-count
+ * limit. A higher `scale` shrinks the effective capacity proportionally,
+ * which lets callers express "how much text per segment" once and have it
+ * adapt to whatever rendered size the text ends up at.
+ */
+export declare class LimitByScaledCharsSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: LimitByScaledCharsConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+}
+//# sourceMappingURL=LimitByScaledCharsSegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitByScaledCharsSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/LimitByScaledCharsSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iCAAkC,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,wBAAwB;IAE9D,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;CA4CrB"}

package/dist/modules/splitting/LimitByScaledCharsSegmentSplitter.js

@@ -0,0 +1,66 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+/**
+ * Splits segments by character count weighted by a scaling factor: each
+ * character contributes `scale` to a running budget and the segment is cut
+ * so that no chunk exceeds `maxChars`. When the tail left after a greedy
+ * cut would weigh less than `minChars`, the current chunk is shrunk word
+ * by word until the tail reaches `minChars` — provided the current chunk
+ * stays at or above `minChars` itself. Only when both bounds cannot be
+ * honoured at once (e.g. the remaining text is shorter than two
+ * `minChars` blocks) are the residual words absorbed into the current
+ * chunk as a last resort.
+ *
+ * At `scale = 1` the behaviour is identical to a plain character-count
+ * limit. A higher `scale` shrinks the effective capacity proportionally,
+ * which lets callers express "how much text per segment" once and have it
+ * adapt to whatever rendered size the text ends up at.
+ */
+export class LimitByScaledCharsSegmentSplitter {
+    _config;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const { maxChars, minChars, scale } = this._config;
+        const words = segment.getWords();
+        const n = words.length;
+        if (n === 0)
+            return [];
+        const weight = (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 * scale;
+        };
+        const result = [];
+        let start = 0;
+        while (start < n) {
+            let end = start + 1;
+            while (end < n && weight(start, end + 1) <= maxChars)
+                end++;
+            if (end === n) {
+                result.push(new Segment({ lines: [new Line({ words: words.slice(start, end) })] }));
+                break;
+            }
+            while (weight(end, n) < minChars &&
+                end > start + 1 &&
+                weight(start, end - 1) >= minChars) {
+                end--;
+            }
+            if (weight(end, n) < minChars) {
+                result.push(new Segment({ lines: [new Line({ words: words.slice(start, n) })] }));
+                break;
+            }
+            result.push(new Segment({ lines: [new Line({ words: words.slice(start, end) })] }));
+            start = end;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=LimitByScaledCharsSegmentSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitByScaledCharsSegmentSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/LimitByScaledCharsSegmentSplitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAQ9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iCAAiC;IACf;IAA7B,YAA6B,OAAiC;QAAjC,YAAO,GAAP,OAAO,CAA0B;IAAG,CAAC;IAElE,KAAK,CAAC,QAAgC;QACpC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,YAAY,CAAC,OAAgB;QACnC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAU,EAAU,EAAE;YAClD,IAAI,EAAE,IAAI,IAAI;gBAAE,OAAO,CAAC,CAAC;YACzB,IAAI,KAAK,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;YAC1B,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;gBAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC;YAC/D,OAAO,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC;YACpB,OAAO,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,QAAQ;gBAAE,GAAG,EAAE,CAAC;YAE5D,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpF,MAAM;YACR,CAAC;YAED,OACE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ;gBACzB,GAAG,GAAG,KAAK,GAAG,CAAC;gBACf,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,QAAQ,EAClC,CAAC;gBACD,GAAG,EAAE,CAAC;YACR,CAAC;YAED,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClF,MAAM;YACR,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpF,KAAK,GAAG,GAAG,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,12 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface LimitByWordsConfig {
+    maxWords: number;
+}
+export declare class LimitByWordsSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: LimitByWordsConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+}
+//# sourceMappingURL=LimitByWordsSegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitByWordsSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/LimitByWordsSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,qBAAa,2BAA4B,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAExD,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;CAYrB"}

package/dist/modules/splitting/LimitByWordsSegmentSplitter.js

@@ -0,0 +1,25 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+// Splits segments so that no segment has more than `maxWords` words.
+export class LimitByWordsSegmentSplitter {
+    _config;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const { maxWords } = this._config;
+        const words = segment.getWords();
+        if (words.length <= maxWords)
+            return [segment];
+        const result = [];
+        for (let i = 0; i < words.length; i += maxWords) {
+            const chunk = words.slice(i, i + maxWords);
+            result.push(new Segment({ lines: [new Line({ words: chunk })] }));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=LimitByWordsSegmentSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LimitByWordsSegmentSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/LimitByWordsSegmentSplitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAO9C,qEAAqE;AACrE,MAAM,OAAO,2BAA2B;IACT;IAA7B,YAA6B,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE5D,KAAK,CAAC,QAAgC;QACpC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,YAAY,CAAC,OAAgB;QACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAClC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAW,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+import type { Segment } from '../document/Segment';
+/**
+ * Splits the words within each segment of a single Section into multiple
+ * Line objects based on layout constraints. Receives the segments of one
+ * Section and runs after SegmentSplitter, before StructureTagger.
+ */
+export interface LineSplitter {
+    split(segments: ReadonlyArray<Segment>): Segment[];
+}
+//# sourceMappingURL=LineSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LineSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/LineSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACpD"}

package/dist/modules/splitting/LineSplitter.js

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

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

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

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

@@ -0,0 +1,24 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface PauseBasedConfig {
+    /**
+     * Minimum gap, in seconds, between the end of one word and the start of
+     * the next that triggers a segment cut. Pauses below this threshold are
+     * left inside the current segment.
+     */
+    minGap: number;
+}
+/**
+ * Splits segments at audible pauses between consecutive words. The cut is
+ * placed wherever the gap between the previous word's `end` and the next
+ * word's `start` exceeds `minGap`. This is the coarsest segmentation step:
+ * it lets downstream splitters (boundary, char/word limits) refine the
+ * pause-bounded chunks without ever merging across a real pause.
+ */
+export declare class PauseBasedSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: PauseBasedConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+}
+//# sourceMappingURL=PauseBasedSegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PauseBasedSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/PauseBasedSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAEtD,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;CA0BrB"}