@tscaps/engine 0.1.1

package/dist/modules/rendering/SegmentSubtreeHtmlBuilder.js.map

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

package/dist/modules/rendering/SubtitleFrameRenderer.d.ts

@@ -0,0 +1,111 @@
+import type { Document } from '../document/Document';
+import type { AlignmentConfig } from '../rendering/AlignmentConfig';
+import type { RenderingConfig } from '../rendering/RenderingConfig';
+import type { ElementRenderOverrides } from '../rendering/ElementRenderOverrides';
+import type { InlineStyleMap } from '../rendering/InlineStyleMap';
+import type { SvgFilterBundle } from '../svg-filter/SvgFilterBundle';
+import type { VideoFrameSource } from '../rendering/VideoFrameSource';
+/**
+ * The render-time configuration for one Section.kind: the stylesheet
+ * that defines its visual rules, the root-level inline styles that
+ * seed it, where the rendered subtitle anchors inside the video frame,
+ * the structural rendering switches the stylesheet was authored
+ * against, and optional per-segment / per-word overrides.
+ *
+ * The renderer dispatches per active Section using `Section.kind` as
+ * the lookup key into the `styles` map supplied to `open`.
+ */
+export interface SubtitleStyle {
+    /** Stylesheet defining the visual rules for this kind. */
+    css: string;
+    /** Root-level inline styles applied on the wrapper: CSS custom properties consumed by `css`, plus any direct property defaults. Per-segment and per-word overrides layer on top. */
+    inlineStyles: InlineStyleMap;
+    /** Where the rendered subtitle anchors inside the video frame. Per-segment and per-word `alignment` overrides merge over this. */
+    alignment: AlignmentConfig;
+    /** Structural switches the stylesheet was authored against (e.g. letter-level split). */
+    rendering: RenderingConfig;
+    /** Per-segment overrides, keyed by `Segment.id`. */
+    segmentOverrides?: ElementRenderOverrides;
+    /** Per-word overrides, keyed by `Word.id`. */
+    wordOverrides?: ElementRenderOverrides;
+    /** `<filter>` defs the stylesheet references via `filter: url(#id)`, paired with the scope that materializes them. */
+    svgFilters?: SvgFilterBundle;
+}
+/**
+ * A drawable handle for one rendered subtitle frame. The consumer
+ * paints it into its own 2D context through `draw`.
+ *
+ * The underlying raster is owned by the renderer that produced this
+ * frame and stays valid only until the next `getFrames` call on the
+ * same renderer or until `close`. Holding a `SubtitleFrame` past
+ * either event leaves `draw` painting whatever state has since
+ * replaced the raster.
+ */
+export interface SubtitleFrame {
+    /**
+     * Paints the frame into `context` at `(dx, dy)` scaled to
+     * `dWidth × dHeight`. The source rectangle is the full frame.
+     */
+    draw(context: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D, dx: number, dy: number, dWidth: number, dHeight: number): void;
+}
+/**
+ * Produces drawable subtitle frames for a given Document.
+ *
+ * Usage:
+ *   1. `open` once per document.
+ *   2. Either `getFrames(timestamps)` per batch (with at most
+ *      `getMaxBatchSize()` entries), or `getFrame(timestamp)` per
+ *      individual timestamp.
+ *   3. `close` when done.
+ */
+export interface SubtitleFrameRenderer {
+    /**
+     * Prepares the renderer for `doc` and the set of styles its
+     * Sections may reference. `styles` is keyed by `Section.kind`.
+     * Must complete before the first `getFrames`/`getFrame` call.
+     *
+     * `videoFrameSource` is required when any style in `styles` has
+     * `rendering.videoFrame.required` set, and may be omitted
+     * otherwise. Throws if a style requires the frame but no source
+     * is supplied.
+     */
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, videoFrameSource?: VideoFrameSource): Promise<void>;
+    /**
+     * Maximum number of timestamps a single `getFrames` call accepts
+     * at the given output dimensions. Bounded by the renderer's memory
+     * budget and any platform raster-size caps. A caller that exceeds
+     * this may see the call fail outright.
+     */
+    getMaxBatchSize(): Promise<number>;
+    /**
+     * Renders subtitle frames for the given timestamps. The returned
+     * array has the same length and order as `timestamps`; an entry is
+     * `null` for timestamps where no Section is active.
+     *
+     * The implementation may deduplicate internally: timestamps that
+     * hit the same visual state share a single raster tile inside the
+     * batch and their return entries point at the same tile.
+     *
+     * Frames produced by one call may share underlying raster
+     * resources; those resources stay valid until the next
+     * `getFrames`/`getFrame` call or until `close`.
+     */
+    getFrames(timestamps: ReadonlyArray<number>): Promise<Array<SubtitleFrame | null>>;
+    /**
+     * Renders the subtitle frame for a single timestamp. Returns
+     * `null` when no Section is active at `timestamp`. Equivalent in
+     * result to `(await getFrames([timestamp]))[0]`.
+     *
+     * The returned frame's underlying raster follows the same
+     * lifetime as `getFrames` results: valid until the next
+     * `getFrames`/`getFrame` call or until `close`.
+     */
+    getFrame(timestamp: number): Promise<SubtitleFrame | null>;
+    /**
+     * Releases any host-document state the renderer attached during
+     * `open` (probe stylesheets, offscreen containers). After `close`,
+     * `getFrames`/`getFrame` return `null` for every timestamp.
+     */
+    close(): void;
+}
+//# sourceMappingURL=SubtitleFrameRenderer.d.ts.map

package/dist/modules/rendering/SubtitleFrameRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFrameRenderer.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/SubtitleFrameRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,oLAAoL;IACpL,YAAY,EAAE,cAAc,CAAC;IAC7B,kIAAkI;IAClI,SAAS,EAAE,eAAe,CAAC;IAC3B,yFAAyF;IACzF,SAAS,EAAE,eAAe,CAAC;IAC3B,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,8CAA8C;IAC9C,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,sHAAsH;IACtH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CACF,OAAO,EAAE,iCAAiC,GAAG,wBAAwB,EACrE,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CAAC;CACT;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;OASG;IACH,IAAI,CACF,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,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IAEnF;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/modules/rendering/SubtitleFrameRenderer.js

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

package/dist/modules/rendering/SubtitleFrameRenderer.js.map

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

package/dist/modules/rendering/VideoFrameLayerClass.d.ts

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

package/dist/modules/rendering/VideoFrameLayerClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameLayerClass.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/VideoFrameLayerClass.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B,sWAAwW,CAAC"}

package/dist/modules/rendering/VideoFrameLayerClass.js

@@ -0,0 +1,21 @@
+/**
+ * Class on the element the renderer emits inside a Segment when its
+ * `RenderingConfig.videoFrame.required` is set. The Section's
+ * stylesheet targets this class to position, clip, or filter the
+ * video frame.
+ */
+export const VIDEO_FRAME_LAYER_CLASS = 'tscaps-video-frame-layer';
+/**
+ * Default rule for {@link VIDEO_FRAME_LAYER_CLASS}: positions the
+ * layer over the subtitle's painted region via the
+ * `--subtitle-region-*` custom properties and paints the current
+ * frame slice from `--video-frame`. Class-level specificity so
+ * sheet-scoped overrides always win.
+ *
+ * `max-width: none; max-height: none` defeats consumer CSS resets
+ * (e.g. Tailwind's `img, video { max-width: 100% }`) that would
+ * clip the layer to its content-hugging segment parent and break
+ * the region geometry.
+ */
+export const VIDEO_FRAME_LAYER_BASELINE_CSS = `.${VIDEO_FRAME_LAYER_CLASS} { position: absolute; left: var(--subtitle-region-x, 0); top: var(--subtitle-region-y, 0); width: var(--subtitle-region-width, 100%); height: var(--subtitle-region-height, 100%); max-width: none; max-height: none; background-image: var(--video-frame, none); background-size: 100% 100%; pointer-events: none; object-fit: fill; }`;
+//# sourceMappingURL=VideoFrameLayerClass.js.map

package/dist/modules/rendering/VideoFrameLayerClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameLayerClass.js","sourceRoot":"","sources":["../../../src/modules/rendering/VideoFrameLayerClass.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,uBAAuB,0UAA0U,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Sub-rectangle of a video frame, expressed in viewport pixels.
+ * `(x, y)` is the top-left corner; `(x + width, y + height)` is the
+ * bottom-right corner.
+ */
+export interface VideoFrameRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Pull-based access to the underlying video frame at a given moment
+ * in playback time.
+ */
+export interface VideoFrameSource {
+    /**
+     * Resolves to a self-contained `data:` URL for the frame whose
+     * presentation interval contains `timeSeconds`, encoded as JPEG
+     * at the given quality (`0` lowest, `1` highest). When `region`
+     * is supplied, only that sub-rectangle of the frame is encoded.
+     *
+     * Rejects when the requested time falls outside the source's
+     * available range, or when the underlying decoder cannot produce
+     * a frame at that timestamp.
+     */
+    getFrameAt(timeSeconds: number, jpegQuality: number, region?: VideoFrameRegion): Promise<string>;
+}
+//# sourceMappingURL=VideoFrameSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameSource.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/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/VideoFrameSource.js

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

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

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

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

@@ -0,0 +1,14 @@
+export type { SubtitleFrameRenderer, SubtitleFrame, SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+export { BrowserSubtitleFrameRenderer } from '../rendering/BrowserSubtitleFrameRenderer';
+export { LayeredSubtitleFrame } from '../rendering/LayeredSubtitleFrame';
+export type { OverlayFrameRenderer, OverlayFrame } from '../rendering/OverlayFrameRenderer';
+export { BrowserOverlayFrameRenderer } from '../rendering/BrowserOverlayFrameRenderer';
+export type { AlignmentConfig, VerticalAlign } from '../rendering/AlignmentConfig';
+export type { RenderingConfig, VideoFrameRequirement } from '../rendering/RenderingConfig';
+export type { BoxEdges } from '../rendering/BoxEdges';
+export type { VideoFrameSource, VideoFrameRegion } from '../rendering/VideoFrameSource';
+export { VIDEO_FRAME_LAYER_CLASS, VIDEO_FRAME_LAYER_BASELINE_CSS } from '../rendering/VideoFrameLayerClass';
+export { ElementRenderOverrides } from '../rendering/ElementRenderOverrides';
+export type { ScopedRenderOverride } from '../rendering/ScopedRenderOverride';
+export type { InlineStyleMap } from '../rendering/InlineStyleMap';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACpH,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACzF,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACjG,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAClH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/modules/rendering/index.js

@@ -0,0 +1,6 @@
+export { BrowserSubtitleFrameRenderer } from '../rendering/BrowserSubtitleFrameRenderer';
+export { LayeredSubtitleFrame } from '../rendering/LayeredSubtitleFrame';
+export { BrowserOverlayFrameRenderer } from '../rendering/BrowserOverlayFrameRenderer';
+export { VIDEO_FRAME_LAYER_CLASS, VIDEO_FRAME_LAYER_BASELINE_CSS } from '../rendering/VideoFrameLayerClass';
+export { ElementRenderOverrides } from '../rendering/ElementRenderOverrides';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/rendering/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAK7F,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AAClH,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { LineSplitter } from '../splitting/LineSplitter';
+import { Segment } from '../document/Segment';
+export interface BalancedLineSplitterConfig {
+    maxLines: number;
+    minLines: number;
+    maxCharsPerLine: number;
+}
+/**
+ * BalancedLineSplitter implements a line-breaking strategy that aims to distribute
+ * words across lines in a way that minimizes the difference in character count
+ * between lines, while respecting specified constraints on maximum lines,
+ * minimum lines, and maximum characters per line.
+ */
+export declare class BalancedLineSplitter implements LineSplitter {
+    private readonly _config;
+    constructor(_config: BalancedLineSplitterConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+    private buildLines;
+    private splitRecursive;
+    private adjustToMinLines;
+    private charCount;
+}
+//# sourceMappingURL=BalancedLineSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BalancedLineSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/BalancedLineSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,0BAA0B;IAEhE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,SAAS;CAGlB"}

package/dist/modules/splitting/BalancedLineSplitter.js

@@ -0,0 +1,81 @@
+import { Line } from '../document/Line';
+/**
+ * BalancedLineSplitter implements a line-breaking strategy that aims to distribute
+ * words across lines in a way that minimizes the difference in character count
+ * between lines, while respecting specified constraints on maximum lines,
+ * minimum lines, and maximum characters per line.
+ */
+export class BalancedLineSplitter {
+    _config;
+    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);
+        this.adjustToMinLines(lines);
+        return segment.with({ lines });
+    }
+    buildLines(words) {
+        const { maxLines, maxCharsPerLine } = this._config;
+        const totalChars = this.charCount(words);
+        const linesNeeded = Math.ceil(totalChars / maxCharsPerLine);
+        const targetLines = Math.min(linesNeeded, maxLines);
+        if (targetLines <= 1) {
+            return [new Line({ words })];
+        }
+        return this.splitRecursive(words, targetLines);
+    }
+    splitRecursive(words, linesLeft) {
+        if (linesLeft <= 1 || words.length === 0) {
+            return words.length > 0 ? [new Line({ words })] : [];
+        }
+        const total = this.charCount(words);
+        const target = total / linesLeft;
+        let bestSplit = 1;
+        let bestDiff = Infinity;
+        let cumChars = 0;
+        for (let i = 0; i < words.length - 1; i++) {
+            const word = words[i];
+            if (!word)
+                continue;
+            cumChars += i === 0 ? word.text.length : word.text.length + 1;
+            const diff = Math.abs(cumChars - target);
+            if (diff < bestDiff) {
+                bestDiff = diff;
+                bestSplit = i + 1;
+            }
+        }
+        return [
+            new Line({ words: words.slice(0, bestSplit) }),
+            ...this.splitRecursive(words.slice(bestSplit), linesLeft - 1),
+        ];
+    }
+    adjustToMinLines(lines) {
+        const { minLines } = this._config;
+        while (lines.length < minLines) {
+            let longestIdx = 0;
+            for (let i = 1; i < lines.length; i++) {
+                if ((lines[i]?.words.length ?? 0) > (lines[longestIdx]?.words.length ?? 0)) {
+                    longestIdx = i;
+                }
+            }
+            const longest = lines[longestIdx];
+            if (!longest || longest.words.length <= 1)
+                break;
+            const mid = Math.floor(longest.words.length / 2);
+            const first = new Line({ words: [...longest.words].slice(0, mid) });
+            const second = new Line({ words: [...longest.words].slice(mid) });
+            lines.splice(longestIdx, 1, first, second);
+        }
+    }
+    charCount(words) {
+        return words.reduce((sum, w, i) => sum + w.text.length + (i > 0 ? 1 : 0), 0);
+    }
+}
+//# sourceMappingURL=BalancedLineSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BalancedLineSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/BalancedLineSplitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAS9C;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,OAAmC;QAAnC,YAAO,GAAP,OAAO,CAA4B;IAAG,CAAC;IAEpE,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;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,CAAC;QAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEpD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAEO,cAAc,CAAC,KAAa,EAAE,SAAiB;QACrD,IAAI,SAAS,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;QAEjC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,QAAQ,GAAG,QAAQ,CAAC;QACxB,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;YACzC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACpB,QAAQ,GAAG,IAAI,CAAC;gBAChB,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;YAC9C,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC;SAC9D,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,KAAa;QACpC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC/B,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;oBAC3E,UAAU,GAAG,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;YAClC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC;gBAAE,MAAM;YAEjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClE,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;CACF"}

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

@@ -0,0 +1,31 @@
+import type { LineSplitter } from '../splitting/LineSplitter';
+import { Segment } from '../document/Segment';
+import type { TextMeasurer } from '../splitting/TextMeasurer';
+export interface BalancedPixelWidthLineSplitterConfig {
+    maxLines: number;
+    minLines: number;
+    maxWidth: number;
+}
+/**
+ * Greedy first pass picks the minimum number of lines that fit `maxWidth`,
+ * then a recursive split balances widths across that target. Width queries
+ * are delegated to a `TextMeasurer`, so this class stays purely arithmetic
+ * and the consumer chooses how widths are resolved (DOM probe, canvas,
+ * lookup, etc.).
+ */
+export declare class BalancedPixelWidthLineSplitter implements LineSplitter {
+    private readonly _config;
+    private readonly _measurer;
+    constructor(_config: BalancedPixelWidthLineSplitterConfig, _measurer: TextMeasurer);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private buildMeasurements;
+    /**
+     * Width of `words[a..b]` (inclusive, in original segment indices) rendered
+     * alone on a line: sum of word widths plus one inter-word gap per pair.
+     */
+    private rangeWidth;
+    private buildLines;
+    private splitRecursive;
+    private adjustToMinLines;
+}
+//# sourceMappingURL=BalancedPixelWidthLineSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BalancedPixelWidthLineSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/BalancedPixelWidthLineSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,MAAM,WAAW,oCAAoC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAeD;;;;;;GAMG;AACH,qBAAa,8BAA+B,YAAW,YAAY;IAE/D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,OAAO,EAAE,oCAAoC,EAC7C,SAAS,EAAE,YAAY;IAG1C,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAWlD,OAAO,CAAC,iBAAiB;IASzB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/modules/splitting/BalancedPixelWidthLineSplitter.js

@@ -0,0 +1,99 @@
+import { Line } from '../document/Line';
+/**
+ * Greedy first pass picks the minimum number of lines that fit `maxWidth`,
+ * then a recursive split balances widths across that target. Width queries
+ * are delegated to a `TextMeasurer`, so this class stays purely arithmetic
+ * and the consumer chooses how widths are resolved (DOM probe, canvas,
+ * lookup, etc.).
+ */
+export class BalancedPixelWidthLineSplitter {
+    _config;
+    _measurer;
+    constructor(_config, _measurer) {
+        this._config = _config;
+        this._measurer = _measurer;
+    }
+    split(segments) {
+        return segments.map((segment) => {
+            const words = segment.getWords();
+            if (words.length === 0)
+                return segment;
+            const m = this.buildMeasurements(words);
+            const lines = this.buildLines(words, m);
+            this.adjustToMinLines(lines);
+            return segment.with({ lines });
+        });
+    }
+    buildMeasurements(words) {
+        const prefixSums = new Array(words.length + 1);
+        prefixSums[0] = 0;
+        for (let i = 0; i < words.length; i++) {
+            prefixSums[i + 1] = prefixSums[i] + this._measurer.measure(words[i].text);
+        }
+        return { wordWidthPrefixSums: prefixSums, spaceWidth: this._measurer.spaceWidth() };
+    }
+    /**
+     * Width of `words[a..b]` (inclusive, in original segment indices) rendered
+     * alone on a line: sum of word widths plus one inter-word gap per pair.
+     */
+    rangeWidth(m, a, b) {
+        return m.wordWidthPrefixSums[b + 1] - m.wordWidthPrefixSums[a] + (b - a) * m.spaceWidth;
+    }
+    buildLines(words, m) {
+        const { maxLines } = this._config;
+        // Greedy pass to find the minimum number of lines needed
+        let linesNeeded = 1;
+        let lineStart = 0;
+        for (let i = 1; i < words.length; i++) {
+            const width = this.rangeWidth(m, lineStart, i);
+            if (width > this._config.maxWidth && i > lineStart) {
+                linesNeeded++;
+                lineStart = i;
+            }
+        }
+        const targetLines = Math.min(linesNeeded, maxLines);
+        if (targetLines <= 1)
+            return [new Line({ words })];
+        return this.splitRecursive(words, targetLines, m, 0);
+    }
+    splitRecursive(words, linesLeft, m, offset) {
+        if (linesLeft <= 1 || words.length === 0) {
+            return words.length > 0 ? [new Line({ words })] : [];
+        }
+        const totalWidth = this.rangeWidth(m, offset, offset + words.length - 1);
+        const target = totalWidth / linesLeft;
+        let bestSplit = 1;
+        let bestDiff = Infinity;
+        for (let i = 0; i < words.length - 1; i++) {
+            const cumWidth = this.rangeWidth(m, offset, offset + i);
+            const diff = Math.abs(cumWidth - target);
+            if (diff < bestDiff) {
+                bestDiff = diff;
+                bestSplit = i + 1;
+            }
+        }
+        return [
+            new Line({ words: words.slice(0, bestSplit) }),
+            ...this.splitRecursive(words.slice(bestSplit), linesLeft - 1, m, offset + bestSplit),
+        ];
+    }
+    adjustToMinLines(lines) {
+        const { minLines } = this._config;
+        while (lines.length < minLines) {
+            let longestIdx = 0;
+            for (let i = 1; i < lines.length; i++) {
+                if ((lines[i]?.words.length ?? 0) > (lines[longestIdx]?.words.length ?? 0)) {
+                    longestIdx = i;
+                }
+            }
+            const longest = lines[longestIdx];
+            if (!longest || longest.words.length <= 1)
+                break;
+            const mid = Math.floor(longest.words.length / 2);
+            const first = new Line({ words: [...longest.words].slice(0, mid) });
+            const second = new Line({ words: [...longest.words].slice(mid) });
+            lines.splice(longestIdx, 1, first, second);
+        }
+    }
+}
+//# sourceMappingURL=BalancedPixelWidthLineSplitter.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface BoundaryConfig {
+    separators: string[];
+}
+/**
+ * Splits segments at hard boundary characters (e.g. sentence-ending
+ * punctuation, optional clause separators). Boundaries chosen here are
+ * never crossed by downstream segment splitters, so this step decides
+ * which punctuation acts as a "do not merge across" marker. Operates on
+ * the segments of a single Section.
+ */
+export declare class BoundarySegmentSplitter implements SegmentSplitter {
+    private readonly _separators;
+    constructor(config: BoundaryConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+}
+//# sourceMappingURL=BoundarySegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BoundarySegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/BoundarySegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;gBAEtC,MAAM,EAAE,cAAc;IAIlC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;CAsBrB"}

package/dist/modules/splitting/BoundarySegmentSplitter.js

@@ -0,0 +1,38 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+/**
+ * Splits segments at hard boundary characters (e.g. sentence-ending
+ * punctuation, optional clause separators). Boundaries chosen here are
+ * never crossed by downstream segment splitters, so this step decides
+ * which punctuation acts as a "do not merge across" marker. Operates on
+ * the segments of a single Section.
+ */
+export class BoundarySegmentSplitter {
+    _separators;
+    constructor(config) {
+        this._separators = new Set(config.separators);
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        if (this._separators.size === 0)
+            return [segment];
+        const words = segment.getWords();
+        const result = [];
+        let currentChunk = [];
+        for (const word of words) {
+            currentChunk.push(word);
+            const endsWithSeparator = Array.from(this._separators).some((sep) => word.text.endsWith(sep));
+            if (endsWithSeparator) {
+                result.push(new Segment({ lines: [new Line({ words: currentChunk })] }));
+                currentChunk = [];
+            }
+        }
+        if (currentChunk.length > 0) {
+            result.push(new Segment({ lines: [new Line({ words: currentChunk })] }));
+        }
+        return result.length > 0 ? result : [segment];
+    }
+}
+//# sourceMappingURL=BoundarySegmentSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BoundarySegmentSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/BoundarySegmentSplitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAM9C;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IACjB,WAAW,CAAsB;IAElD,YAAY,MAAsB;QAChC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,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,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,YAAY,GAAiB,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9F,IAAI,iBAAiB,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzE,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import type { Segment } from '../document/Segment';
+export declare class CompositeSegmentSplitter implements SegmentSplitter {
+    private readonly _splitters;
+    constructor(_splitters: ReadonlyArray<SegmentSplitter>);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+}
+//# sourceMappingURL=CompositeSegmentSplitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/CompositeSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD,qBAAa,wBAAyB,YAAW,eAAe;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC;IAEvE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;CAMnD"}

package/dist/modules/splitting/CompositeSegmentSplitter.js

@@ -0,0 +1,12 @@
+// Chains multiple SegmentSplitters in sequence. The output of each splitter
+// is fed as input to the next.
+export class CompositeSegmentSplitter {
+    _splitters;
+    constructor(_splitters) {
+        this._splitters = _splitters;
+    }
+    split(segments) {
+        return this._splitters.reduce((segs, splitter) => splitter.split(segs), [...segments]);
+    }
+}
+//# sourceMappingURL=CompositeSegmentSplitter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeSegmentSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/CompositeSegmentSplitter.ts"],"names":[],"mappings":"AAGA,4EAA4E;AAC5E,+BAA+B;AAC/B,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,UAA0C;QAA1C,eAAU,GAAV,UAAU,CAAgC;IAAG,CAAC;IAE3E,KAAK,CAAC,QAAgC;QACpC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAC3B,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EACxC,CAAC,GAAG,QAAQ,CAAC,CACd,CAAC;IACJ,CAAC;CACF"}