@doxi/core 0.11.0

package/dist/layout/layout-engine.js

@@ -0,0 +1,198 @@
+import { renderNode } from '../view/renderer.js';
+import { resolveDimensions, } from './types.js';
+import { createMeasurer, destroyMeasurer, measureBlockHeight } from './measure.js';
+import { splitParagraphByHeight } from './split-paragraph.js';
+import { splitTableByHeight, buildPartialTable } from './split-table.js';
+import { DEFAULT_WIDOW_ORPHAN, decideBreak } from './widow-orphan.js';
+const SPLIT_LIMIT_PER_BLOCK = 10;
+export class LayoutEngine {
+    dimensions;
+    doc;
+    renderer;
+    measurer;
+    widowOrphan;
+    generation = 0;
+    constructor(doc, renderer, config, options = {}) {
+        this.doc = doc;
+        this.renderer = renderer;
+        this.dimensions = resolveDimensions(config);
+        this.measurer = createMeasurer(doc, this.dimensions.contentWidthPx);
+        this.widowOrphan = options.widowOrphan ?? DEFAULT_WIDOW_ORPHAN;
+    }
+    layout(root) {
+        this.generation++;
+        const pages = [];
+        if (root.content.childCount === 0) {
+            pages.push({
+                index: 0,
+                modelFrom: 0,
+                modelTo: 0,
+                blockIndices: [],
+                contentHeightPx: 0,
+            });
+            return { pages, generation: this.generation, dimensions: this.dimensions };
+        }
+        const pageHeight = this.dimensions.contentHeightPx;
+        let pageIndex = 0;
+        let cursorHeight = 0;
+        let currentBlockIndices = [];
+        let currentModelFrom = 0;
+        let pendingSplitBefore = undefined;
+        let modelOffset = 0;
+        const flushPage = (modelTo, height, splitAfter) => {
+            const box = {
+                index: pageIndex++,
+                modelFrom: currentModelFrom,
+                modelTo,
+                blockIndices: currentBlockIndices,
+                contentHeightPx: height,
+                ...(splitAfter ? { splitAfter } : {}),
+                ...(pendingSplitBefore ? { splitBefore: pendingSplitBefore } : {}),
+            };
+            pages.push(box);
+            currentBlockIndices = [];
+            currentModelFrom = modelTo;
+            cursorHeight = 0;
+            pendingSplitBefore = undefined;
+        };
+        for (let i = 0; i < root.content.childCount; i++) {
+            const block = root.content.child(i);
+            let workingBlock = block;
+            let workingNodeStartOffset = modelOffset;
+            let splitsRemaining = SPLIT_LIMIT_PER_BLOCK;
+            // Table-split bookkeeping: when a table has already been partially placed
+            // on a previous page (via splitTableByHeight), `tableTail` holds the
+            // remaining body row indices to render on this/subsequent pages, and
+            // `tableHeader` holds the header row indices that repeat on every page.
+            let tableTail = null;
+            let tableHeader = [];
+            while (true) {
+                if (workingBlock.type.name === 'page_break') {
+                    // Forced break: place the marker on the current page (it has near-zero
+                    // visual height but a small CSS-induced height; honor whatever measure
+                    // returns), then flush regardless of remaining space.
+                    const h = this.measureBlock(workingBlock);
+                    currentBlockIndices.push(i);
+                    cursorHeight += h;
+                    modelOffset = workingNodeStartOffset + workingBlock.nodeSize;
+                    flushPage(modelOffset, cursorHeight);
+                    break; // exits the while-true; outer for-loop moves to the next block
+                }
+                const blockHeight = this.measureBlock(workingBlock);
+                const remaining = pageHeight - cursorHeight;
+                if (blockHeight <= remaining) {
+                    currentBlockIndices.push(i);
+                    cursorHeight += blockHeight;
+                    modelOffset = workingNodeStartOffset + workingBlock.nodeSize;
+                    break;
+                }
+                // ---- Table row split path ------------------------------------------
+                // Try to split a table BEFORE the "accept whole when alone" fallback.
+                // A tall table on an otherwise-empty page should still be split into
+                // multiple pages; it should never be dumped whole if it has more rows
+                // than fit in the page area.
+                if (workingBlock.type.name === 'table' && splitsRemaining > 0) {
+                    const tableResult = splitTableByHeight(this.measurer, this.doc, workingBlock, this.renderer, remaining);
+                    if (tableResult) {
+                        // Place a portion of the table on the current page; the rest
+                        // becomes the next page's first block.
+                        currentBlockIndices.push(i);
+                        const headBodyForThisPage = tableResult.headRowIndices;
+                        const splitAfter = {
+                            blockIndex: i,
+                            charOffset: 0,
+                            tableSplit: {
+                                headerRowIndices: tableResult.headerRowIndices,
+                                bodyRowIndices: headBodyForThisPage,
+                            },
+                        };
+                        // The next page's splitBefore needs the tail body rows. We point
+                        // modelOffset at the end of the FULL table block — once the tail
+                        // is rendered we don't re-advance modelOffset.
+                        const tailBody = tableResult.tailRowIndices;
+                        // Flush the current page with the table-split splitAfter.
+                        flushPage(workingNodeStartOffset + block.nodeSize, cursorHeight + tableResult.headHeightPx, splitAfter);
+                        // Record continuation context: next page will render the tail.
+                        tableHeader = tableResult.headerRowIndices.slice();
+                        tableTail = tailBody.slice();
+                        const tailSplitBefore = {
+                            blockIndex: i,
+                            charOffset: 0,
+                            tableSplit: {
+                                headerRowIndices: tableHeader,
+                                bodyRowIndices: tableTail,
+                            },
+                        };
+                        pendingSplitBefore = tailSplitBefore;
+                        // Replace workingBlock with a synthesized partial table (header
+                        // rows + remaining body rows). This is what subsequent iterations
+                        // measure against — it's the SHAPE of what we'll render next.
+                        workingBlock = buildPartialTable(workingBlock, tableHeader, tableTail);
+                        // modelOffset for the original block has already been "spent" by
+                        // the flush above (we passed workingNodeStartOffset + block.nodeSize
+                        // as the modelTo). Adjust workingNodeStartOffset so that when the
+                        // tail finally fits, the `modelOffset = workingNodeStartOffset +
+                        // workingBlock.nodeSize` line lands on the same value (no-op).
+                        workingNodeStartOffset = (workingNodeStartOffset + block.nodeSize) - workingBlock.nodeSize;
+                        splitsRemaining--;
+                        continue;
+                    }
+                    // Table split returned null — fall through to push-whole.
+                }
+                // Try in-block split. Only meaningful for inline-content blocks.
+                let split = null;
+                if (!workingBlock.isAtom &&
+                    !workingBlock.isText &&
+                    workingBlock.type.name !== 'table' &&
+                    splitsRemaining > 0) {
+                    split = splitParagraphByHeight(this.measurer, this.doc, workingBlock, this.renderer, remaining);
+                }
+                if (split && decideBreak(split.headLines, split.tailLines, this.widowOrphan) === 'split-here') {
+                    // Place head on current page; flush; tail continues as next-page first block.
+                    currentBlockIndices.push(i);
+                    const splitAfter = { blockIndex: i, charOffset: split.charOffset };
+                    const headSize = split.head.nodeSize;
+                    flushPage(workingNodeStartOffset + headSize, cursorHeight + this.measureBlock(split.head), splitAfter);
+                    pendingSplitBefore = { blockIndex: i, charOffset: split.charOffset };
+                    workingBlock = split.tail;
+                    // The next iteration places head's nodeSize remainder on the new page.
+                    // Adjust workingNodeStartOffset so modelOffset accounting stays correct.
+                    workingNodeStartOffset = workingNodeStartOffset + headSize - (workingBlock.nodeSize - (block.nodeSize - headSize));
+                    // Simpler accounting: modelOffset becomes workingNodeStartOffset on next iteration.
+                    // We need final modelOffset for THIS block = workingNodeStartOffset + workingBlock.nodeSize.
+                    // The cleanest: track endOffset of the FULL block = (original modelOffset + block.nodeSize)
+                    // and set modelOffset to that when we finally place the tail.
+                    splitsRemaining--;
+                    continue;
+                }
+                // Can't split (or split rejected). If the page is empty, we have no
+                // choice but to accept the oversized block whole (otherwise it would
+                // loop forever). Otherwise push the whole block to the next page.
+                if (currentBlockIndices.length === 0) {
+                    currentBlockIndices.push(i);
+                    cursorHeight += blockHeight;
+                    modelOffset = workingNodeStartOffset + workingBlock.nodeSize;
+                    break;
+                }
+                flushPage(modelOffset, cursorHeight);
+                // workingBlock and workingNodeStartOffset unchanged; loop retries placement on the new (empty) page.
+            }
+            // Avoid unused-variable warnings on the table continuation bookkeeping
+            // (the values are consumed via pendingSplitBefore at flush time).
+            void tableTail;
+            void tableHeader;
+        }
+        if (currentBlockIndices.length > 0 || pages.length === 0) {
+            flushPage(modelOffset, cursorHeight);
+        }
+        return { pages, generation: this.generation, dimensions: this.dimensions };
+    }
+    destroy() {
+        destroyMeasurer(this.measurer);
+    }
+    measureBlock(block) {
+        const el = renderNode(this.doc, this.renderer, block, 0);
+        return measureBlockHeight(this.measurer, el);
+    }
+}
+//# sourceMappingURL=layout-engine.js.map

package/dist/layout/layout-engine.js.map

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

package/dist/layout/measure.d.ts

@@ -0,0 +1,9 @@
+export interface Measurer {
+    readonly container: HTMLElement;
+    readonly doc: Document;
+    readonly widthPx: number;
+}
+export declare function createMeasurer(doc: Document, widthPx: number): Measurer;
+export declare function measureBlockHeight(m: Measurer, el: HTMLElement): number;
+export declare function destroyMeasurer(m: Measurer): void;
+//# sourceMappingURL=measure.d.ts.map

package/dist/layout/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/layout/measure.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAWvE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,GAAG,MAAM,CAkBvE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAEjD"}

package/dist/layout/measure.js

@@ -0,0 +1,37 @@
+export function createMeasurer(doc, widthPx) {
+    const container = doc.createElement('div');
+    container.setAttribute('aria-hidden', 'true');
+    container.style.position = 'absolute';
+    container.style.top = '0';
+    container.style.left = '-9999px';
+    container.style.width = `${widthPx}px`;
+    container.style.visibility = 'hidden';
+    container.style.pointerEvents = 'none';
+    doc.body.appendChild(container);
+    return { container, doc, widthPx };
+}
+export function measureBlockHeight(m, el) {
+    m.container.appendChild(el);
+    // Force layout. getBoundingClientRect triggers a synchronous layout pass in
+    // real browsers. happy-dom does not actually compute layout — rect.height
+    // and offsetHeight stay at 0 — so we fall back to the resolved CSS height
+    // from getComputedStyle (which happy-dom does honor) for test determinism.
+    const rect = el.getBoundingClientRect();
+    let h = rect.height || el.offsetHeight || 0;
+    if (h === 0) {
+        const view = m.doc.defaultView;
+        if (view) {
+            const cs = view.getComputedStyle(el).height;
+            const parsed = parseFloat(cs);
+            if (Number.isFinite(parsed) && parsed > 0)
+                h = parsed;
+        }
+    }
+    m.container.removeChild(el);
+    return h;
+}
+export function destroyMeasurer(m) {
+    if (m.container.parentNode)
+        m.container.parentNode.removeChild(m.container);
+}
+//# sourceMappingURL=measure.js.map

package/dist/layout/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../src/layout/measure.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,cAAc,CAAC,GAAa,EAAE,OAAe;IAC3D,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC1C,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC7C,SAAS,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAA;IACrC,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,CAAA;IACzB,SAAS,CAAC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAA;IAChC,SAAS,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,OAAO,IAAI,CAAA;IACtC,SAAS,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAA;IACrC,SAAS,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAA;IACtC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAW,EAAE,EAAe;IAC7D,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAC3B,4EAA4E;IAC5E,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAA;IACvC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,YAAY,IAAI,CAAC,CAAA;IAC3C,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAA;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAA;YAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;YAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;gBAAE,CAAC,GAAG,MAAM,CAAA;QACvD,CAAC;IACH,CAAC;IACD,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAC3B,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAW;IACzC,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU;QAAE,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAC7E,CAAC"}

package/dist/layout/split-paragraph.d.ts

@@ -0,0 +1,28 @@
+import type { DxNode } from '../model/node.js';
+import type { Renderer } from '../view/renderer.js';
+import type { Measurer } from './measure.js';
+export interface LineRect {
+    readonly topPx: number;
+    readonly bottomPx: number;
+    /** Inclusive character offset (in the block's content-coordinate space) where this line starts. */
+    readonly charStart: number;
+    /** Exclusive character offset where this line ends. */
+    readonly charEnd: number;
+}
+export declare function measureLineRects(m: Measurer, blockEl: HTMLElement): LineRect[];
+/**
+ * Try to split a paragraph so that the head fits within maxHeightPx and the
+ * tail contains the remainder. Returns null when no split point is acceptable
+ * (e.g., the paragraph's first line is already taller than maxHeightPx).
+ */
+export interface SplitResult {
+    readonly head: DxNode;
+    readonly tail: DxNode;
+    /** Char-content offset of the split point in the original paragraph. */
+    readonly charOffset: number;
+    /** Lines on the head (≥1) and tail (≥1). */
+    readonly headLines: number;
+    readonly tailLines: number;
+}
+export declare function splitParagraphByHeight(m: Measurer, doc: Document, paragraph: DxNode, renderer: Renderer, maxHeightPx: number): SplitResult | null;
+//# sourceMappingURL=split-paragraph.d.ts.map

package/dist/layout/split-paragraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-paragraph.d.ts","sourceRoot":"","sources":["../../src/layout/split-paragraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,mGAAmG;IACnG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,QAAQ,EAAE,CA0C9E;AA2CD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,QAAQ,EACX,GAAG,EAAE,QAAQ,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,MAAM,GAClB,WAAW,GAAG,IAAI,CA6BpB"}

package/dist/layout/split-paragraph.js

@@ -0,0 +1,122 @@
+import { renderNode } from '../view/renderer.js';
+export function measureLineRects(m, blockEl) {
+    m.container.appendChild(blockEl);
+    try {
+        const lines = [];
+        const text = collectText(blockEl);
+        if (text.length === 0)
+            return lines;
+        const range = blockEl.ownerDocument.createRange();
+        let currentTop = null;
+        let currentStart = 0;
+        for (let i = 0; i < text.length; i++) {
+            const placed = placeRange(range, blockEl, i, i + 1);
+            if (!placed)
+                continue;
+            const rect = firstRect(range);
+            if (!rect)
+                continue;
+            if (currentTop === null) {
+                currentTop = rect.top;
+                currentStart = i;
+            }
+            else if (rect.top !== currentTop) {
+                lines.push({
+                    topPx: currentTop,
+                    bottomPx: rect.top,
+                    charStart: currentStart,
+                    charEnd: i,
+                });
+                currentTop = rect.top;
+                currentStart = i;
+            }
+        }
+        if (currentTop !== null) {
+            const lastRect = firstRect(range);
+            lines.push({
+                topPx: currentTop,
+                bottomPx: lastRect ? lastRect.bottom : currentTop,
+                charStart: currentStart,
+                charEnd: text.length,
+            });
+        }
+        return lines;
+    }
+    finally {
+        if (blockEl.parentNode === m.container)
+            m.container.removeChild(blockEl);
+    }
+}
+function collectText(el) {
+    let out = '';
+    const walker = el.ownerDocument.createTreeWalker(el, NodeFilter.SHOW_TEXT);
+    let n;
+    while ((n = walker.nextNode())) {
+        out += n.data;
+    }
+    return out;
+}
+function placeRange(range, blockEl, charFrom, charTo) {
+    const start = locateText(blockEl, charFrom);
+    const end = locateText(blockEl, charTo);
+    if (!start || !end)
+        return false;
+    range.setStart(start.node, start.offset);
+    range.setEnd(end.node, end.offset);
+    return true;
+}
+function locateText(blockEl, charOffset) {
+    const walker = blockEl.ownerDocument.createTreeWalker(blockEl, NodeFilter.SHOW_TEXT);
+    let acc = 0;
+    let n;
+    while ((n = walker.nextNode())) {
+        const text = n;
+        const len = text.data.length;
+        if (charOffset <= acc + len) {
+            return { node: text, offset: charOffset - acc };
+        }
+        acc += len;
+    }
+    return null;
+}
+function firstRect(range) {
+    const rects = range.getClientRects();
+    if (rects.length === 0)
+        return null;
+    const r = rects[0];
+    return { top: r.top, bottom: r.bottom };
+}
+export function splitParagraphByHeight(m, doc, paragraph, renderer, maxHeightPx) {
+    const rendered = renderNode(doc, renderer, paragraph, 0);
+    const lines = measureLineRects(m, rendered);
+    if (lines.length === 0)
+        return null;
+    if (lines[0].bottomPx - lines[0].topPx > maxHeightPx) {
+        return null; // First line alone is taller than the page area.
+    }
+    // Find the last line that fits.
+    const firstTop = lines[0].topPx;
+    let lastFitIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.bottomPx - firstTop <= maxHeightPx) {
+            lastFitIndex = i;
+        }
+        else {
+            break;
+        }
+    }
+    if (lastFitIndex < 0 || lastFitIndex === lines.length - 1)
+        return null;
+    const splitOffset = lines[lastFitIndex].charEnd;
+    const head = paragraph.cut(0, splitOffset);
+    const tail = paragraph.cut(splitOffset, paragraph.content.size);
+    return {
+        head,
+        tail,
+        charOffset: splitOffset,
+        headLines: lastFitIndex + 1,
+        tailLines: lines.length - 1 - lastFitIndex,
+    };
+}
+//# sourceMappingURL=split-paragraph.js.map

package/dist/layout/split-paragraph.js.map

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

package/dist/layout/split-table.d.ts

@@ -0,0 +1,46 @@
+import type { DxNode } from '../model/node.js';
+import type { Renderer } from '../view/renderer.js';
+import { type Measurer } from './measure.js';
+/**
+ * Result of greedy table-row pagination for the current page.
+ *
+ * The row indices are absolute (i.e. positions in `table.content`), NOT
+ * relative to the body slice — so callers can use them directly when
+ * reconstructing partial tables for rendering.
+ */
+export interface SplitTableResult {
+    /** Body row indices that fit on the current page (after header rows). */
+    readonly headRowIndices: number[];
+    /** Body row indices that overflow to the next page. */
+    readonly tailRowIndices: number[];
+    /** Header row indices (always repeated on continuation pages). */
+    readonly headerRowIndices: number[];
+    /** Measured height of the head portion (header + accepted body rows). */
+    readonly headHeightPx: number;
+}
+/**
+ * Greedy fit: place header rows (rows whose attrs.header === true, in the
+ * contiguous run from the top of the table) on the page, then pack body
+ * rows one-at-a-time until adding another would exceed `remainingHeightPx`.
+ *
+ * Returns null when no body rows fit (caller should push the whole table
+ * to the next page).
+ *
+ * Constraints:
+ *   - Whole-row units only — no cell-content splitting within a row.
+ *   - At least one body row must fit OR we return null.
+ *
+ * Measurement strategy: we render a synthetic `table` node containing
+ * the header rows + the candidate body rows, and use the same Measurer
+ * that splitParagraphByHeight uses. The synthetic table preserves the
+ * source table's attrs so styling (border-collapse, widths, etc.) matches
+ * the real one.
+ */
+export declare function splitTableByHeight(measurer: Measurer, doc: Document, table: DxNode, renderer: Renderer, remainingHeightPx: number): SplitTableResult | null;
+/**
+ * Construct a table node containing only the indicated rows (header subset
+ * + body subset), preserving the source table's type/attrs. Used by the
+ * measurement path here and by the Paginator when rendering partial tables.
+ */
+export declare function buildPartialTable(table: DxNode, headerIdx: ReadonlyArray<number>, bodyIdx: ReadonlyArray<number>): DxNode;
+//# sourceMappingURL=split-table.d.ts.map

package/dist/layout/split-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-table.d.ts","sourceRoot":"","sources":["../../src/layout/split-table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAA;IACjC,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAA;IACjC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;IACnC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,MAAM,GACxB,gBAAgB,GAAG,IAAI,CA+CzB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAChC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAC7B,MAAM,CAKR"}

package/dist/layout/split-table.js

@@ -0,0 +1,84 @@
+import { Fragment } from '../model/fragment.js';
+import { renderNode } from '../view/renderer.js';
+import { measureBlockHeight } from './measure.js';
+/**
+ * Greedy fit: place header rows (rows whose attrs.header === true, in the
+ * contiguous run from the top of the table) on the page, then pack body
+ * rows one-at-a-time until adding another would exceed `remainingHeightPx`.
+ *
+ * Returns null when no body rows fit (caller should push the whole table
+ * to the next page).
+ *
+ * Constraints:
+ *   - Whole-row units only — no cell-content splitting within a row.
+ *   - At least one body row must fit OR we return null.
+ *
+ * Measurement strategy: we render a synthetic `table` node containing
+ * the header rows + the candidate body rows, and use the same Measurer
+ * that splitParagraphByHeight uses. The synthetic table preserves the
+ * source table's attrs so styling (border-collapse, widths, etc.) matches
+ * the real one.
+ */
+export function splitTableByHeight(measurer, doc, table, renderer, remainingHeightPx) {
+    // 1. Partition rows into header (contiguous run from the top with
+    //    attrs.header === true) and body.
+    const totalRows = table.content.childCount;
+    const headerRowIndices = [];
+    for (let i = 0; i < totalRows; i++) {
+        const row = table.content.child(i);
+        if (row.attrs.header === true)
+            headerRowIndices.push(i);
+        else
+            break;
+    }
+    const bodyRowIndices = [];
+    for (let i = headerRowIndices.length; i < totalRows; i++) {
+        bodyRowIndices.push(i);
+    }
+    if (bodyRowIndices.length === 0)
+        return null;
+    // 2. Greedy: extend the accepted body row count by 1 until the measured
+    //    height exceeds the budget.
+    const acceptedBody = [];
+    let lastFitHeight = 0;
+    for (const bodyIdx of bodyRowIndices) {
+        const candidate = [...acceptedBody, bodyIdx];
+        const partial = buildPartialTable(table, headerRowIndices, candidate);
+        const el = renderNode(doc, renderer, partial, 0);
+        const h = measureBlockHeight(measurer, el);
+        if (h <= remainingHeightPx) {
+            acceptedBody.push(bodyIdx);
+            lastFitHeight = h;
+        }
+        else {
+            break;
+        }
+    }
+    if (acceptedBody.length === 0)
+        return null;
+    const tail = [];
+    for (const idx of bodyRowIndices) {
+        if (!acceptedBody.includes(idx))
+            tail.push(idx);
+    }
+    return {
+        headRowIndices: acceptedBody,
+        tailRowIndices: tail,
+        headerRowIndices,
+        headHeightPx: lastFitHeight,
+    };
+}
+/**
+ * Construct a table node containing only the indicated rows (header subset
+ * + body subset), preserving the source table's type/attrs. Used by the
+ * measurement path here and by the Paginator when rendering partial tables.
+ */
+export function buildPartialTable(table, headerIdx, bodyIdx) {
+    const rows = [];
+    for (const i of headerIdx)
+        rows.push(table.content.child(i));
+    for (const i of bodyIdx)
+        rows.push(table.content.child(i));
+    return table.copy(Fragment.from(rows));
+}
+//# sourceMappingURL=split-table.js.map

package/dist/layout/split-table.js.map

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

package/dist/layout/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @doxi/core/layout — shared types for the pagination foundation.
+ *
+ * PageBreakModel is the derived data structure produced by the layout engine
+ * (Track L) and consumed by the page renderer (Track C). It is NOT part of the
+ * document model — it is purely a view-of-state computed from the doc + a
+ * page configuration.
+ */
+export type PageSize = 'Letter' | 'A4' | {
+    widthPx: number;
+    heightPx: number;
+};
+export interface PageMargins {
+    readonly topPx: number;
+    readonly rightPx: number;
+    readonly bottomPx: number;
+    readonly leftPx: number;
+}
+export interface PageConfig {
+    readonly size: PageSize;
+    readonly margins: PageMargins;
+}
+export declare const DEFAULT_PAGE_CONFIG: PageConfig;
+export interface ResolvedPageDimensions {
+    readonly widthPx: number;
+    readonly heightPx: number;
+    readonly contentWidthPx: number;
+    readonly contentHeightPx: number;
+    readonly margins: PageMargins;
+}
+export interface SplitPoint {
+    /** Index of the block (in doc.content.children) being split. */
+    readonly blockIndex: number;
+    /**
+     * For paragraph splits: char-content offset within the block where the
+     * split happens. For table splits this field is unused (zero) and the
+     * `tableSplit` payload below carries the per-row index lists.
+     */
+    readonly charOffset: number;
+    /**
+     * Set when this SplitPoint describes a table split. The renderer (Paginator)
+     * uses `headerRowIndices` + `bodyRowIndices` to assemble a partial table
+     * containing the header rows on every page-portion plus the chosen body
+     * subset for that page.
+     */
+    readonly tableSplit?: TableSplitInfo;
+}
+export interface TableSplitInfo {
+    /** Row indices (in the original table.content) that are header rows.
+     * Repeated on every page-portion of the split table. */
+    readonly headerRowIndices: ReadonlyArray<number>;
+    /** Body row indices to render on the page this SplitPoint refers to. */
+    readonly bodyRowIndices: ReadonlyArray<number>;
+}
+export interface PageBox {
+    readonly index: number;
+    readonly modelFrom: number;
+    readonly modelTo: number;
+    /** Doc-content indices of the blocks placed on this page. */
+    readonly blockIndices: ReadonlyArray<number>;
+    readonly contentHeightPx: number;
+    /** When set, the LAST block in blockIndices is rendered up to charOffset only. */
+    readonly splitAfter?: SplitPoint;
+    /** When set, the FIRST block in blockIndices is rendered FROM charOffset. */
+    readonly splitBefore?: SplitPoint;
+}
+export interface PageBreakModel {
+    readonly pages: ReadonlyArray<PageBox>;
+    readonly generation: number;
+    readonly dimensions: ResolvedPageDimensions;
+}
+export declare function resolveDimensions(config: PageConfig): ResolvedPageDimensions;
+//# sourceMappingURL=types.d.ts.map