velo-text 1.0.0-beta.1

package/dist/export/layout/layout-blocks.js

@@ -0,0 +1,91 @@
+import { breakLines, findMissingGlyphs } from "./text.js";
+import { box, ensureSpace, pushPage } from "./layout-flow.js";
+import { layoutStructuredBlock } from "./layout-structured.js";
+export function layoutBlock(flow, block) {
+    if (layoutStructuredBlock(flow, block))
+        return;
+    const { margin, usableWidthUm, lineHeightDefault, opts, diagnostics } = flow;
+    switch (block.type) {
+        case "paragraph":
+        case "heading":
+        case "quote": {
+            const text = (block.children ?? [])
+                .map((c) => {
+                if (c.type === "text")
+                    return c.text;
+                if (c.type === "variable")
+                    return c.source;
+                if (c.type === "equation")
+                    return `$${c.latex}$`;
+                if (c.type === "hard-break")
+                    return "\n";
+                return "";
+            })
+                .join("");
+            const fontSizePt = block.type === "heading" ? 14 + (6 - block.level) : 11;
+            const lines = breakLines(text, { maxWidthUm: usableWidthUm, defaultFontSizePt: fontSizePt });
+            const missing = findMissingGlyphs(text);
+            if (missing.length) {
+                diagnostics.push({ code: "missing-glyph", message: `Missing glyphs: ${missing.slice(0, 5).join("")}`, severity: "warn" });
+            }
+            const widows = opts.widows ?? 2;
+            const orphans = opts.orphans ?? 2;
+            const paraHeight = lines.length * lineHeightDefault;
+            const wouldSplit = flow.cursorY + paraHeight > margin.top + flow.usableHeightUm;
+            const linesOnCurrentPage = Math.floor((margin.top + flow.usableHeightUm - flow.cursorY) / lineHeightDefault);
+            if (wouldSplit && linesOnCurrentPage < widows && lines.length >= widows + orphans) {
+                pushPage(flow);
+            }
+            for (let i = 0; i < lines.length; i++) {
+                ensureSpace(flow, lineHeightDefault);
+                const line = lines[i];
+                flow.currentPage.boxes.push(box({
+                    id: `${block.id}_line_${i}`,
+                    type: block.type,
+                    xUm: margin.left,
+                    yUm: flow.cursorY,
+                    widthUm: usableWidthUm,
+                    heightUm: lineHeightDefault,
+                    content: line.text,
+                }));
+                flow.cursorY += lineHeightDefault;
+            }
+            flow.cursorY += Math.round(lineHeightDefault * 0.3);
+            break;
+        }
+        case "list": {
+            for (const item of block.items) {
+                const text = item.content
+                    .map((c) => {
+                    const cc = c;
+                    if (cc.type === "equation")
+                        return `$${cc.latex}$`;
+                    return cc.text ?? cc.source ?? "";
+                })
+                    .join("");
+                const prefix = block.kind === "ordered" ? "1. " : "• ";
+                const lines = breakLines(prefix + text, { maxWidthUm: usableWidthUm });
+                for (const line of lines) {
+                    ensureSpace(flow, lineHeightDefault);
+                    flow.currentPage.boxes.push(box({
+                        id: `${item.id}_line`,
+                        type: "list-item",
+                        xUm: margin.left,
+                        yUm: flow.cursorY,
+                        widthUm: usableWidthUm,
+                        heightUm: lineHeightDefault,
+                        content: line.text,
+                    }));
+                    flow.cursorY += lineHeightDefault;
+                }
+                if (item.nested)
+                    layoutBlock(flow, item.nested);
+            }
+            flow.cursorY += Math.round(lineHeightDefault * 0.2);
+            break;
+        }
+        default:
+            diagnostics.push({ code: "unknown-block", message: `Unknown block type ${block.type}`, severity: "warn" });
+    }
+}
+//# sourceMappingURL=layout-blocks.js.map

package/dist/export/layout/layout-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-blocks.js","sourceRoot":"","sources":["../../../src/export/layout/layout-blocks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,KAAgB;IAC5D,IAAI,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO;IAC/C,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;iBAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,CAAC,CAAC,IAAI,CAAC;gBACrC,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;oBAAE,OAAO,CAAC,CAAC,MAAM,CAAC;gBAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU;oBAAE,OAAO,IAAK,CAAkC,CAAC,KAAK,GAAG,CAAC;gBACnF,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;oBAAE,OAAO,IAAI,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;iBACD,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAI,KAAsC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5G,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7F,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5H,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC;YACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;YAChF,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;YAC7G,IAAI,UAAU,IAAI,kBAAkB,GAAG,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,OAAO,EAAE,CAAC;gBAClF,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;gBACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACvB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC9B,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,SAAS,CAAC,EAAE;oBAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,GAAG,EAAE,MAAM,CAAC,IAAI;oBAChB,GAAG,EAAE,IAAI,CAAC,OAAO;oBACjB,OAAO,EAAE,aAAa;oBACtB,QAAQ,EAAE,iBAAiB;oBAC3B,OAAO,EAAE,IAAI,CAAC,IAAI;iBACnB,CAAC,CAAC,CAAC;gBACJ,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC;YACpC,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC;YACpD,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;qBACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,EAAE,GAAG,CAAgF,CAAC;oBAC5F,IAAI,EAAE,CAAC,IAAI,KAAK,UAAU;wBAAE,OAAO,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC;oBACnD,OAAO,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;gBACpC,CAAC,CAAC;qBACD,IAAI,CAAC,EAAE,CAAC,CAAC;gBACZ,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;gBACvD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;gBACvE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;oBACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;wBAC9B,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO;wBACrB,IAAI,EAAE,WAAW;wBACjB,GAAG,EAAE,MAAM,CAAC,IAAI;wBAChB,GAAG,EAAE,IAAI,CAAC,OAAO;wBACjB,OAAO,EAAE,aAAa;wBACtB,QAAQ,EAAE,iBAAiB;wBAC3B,OAAO,EAAE,IAAI,CAAC,IAAI;qBACnB,CAAC,CAAC,CAAC;oBACJ,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC;gBACpC,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM;oBAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,MAA8B,CAAC,CAAC;YAC1E,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC;YACpD,MAAM;QACR,CAAC;QACD;YACE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAuB,KAA0B,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACrI,CAAC;AACH,CAAC"}

package/dist/export/layout/layout-flow.d.ts

@@ -0,0 +1,25 @@
+import type { LayoutPage, PageBox, PaginationOptions, PaginationResult } from "./layout-types.js";
+export interface LayoutFlow {
+    opts: PaginationOptions;
+    diagnostics: PaginationResult["diagnostics"];
+    margin: {
+        top: number;
+        left: number;
+        right: number;
+        bottom: number;
+    };
+    usableWidthUm: number;
+    usableHeightUm: number;
+    lineHeightDefault: number;
+    pages: LayoutPage[];
+    pageSize: {
+        widthUm: number;
+        heightUm: number;
+    };
+    currentPage: LayoutPage;
+    cursorY: number;
+}
+export declare function pushPage(flow: LayoutFlow): void;
+export declare function ensureSpace(flow: LayoutFlow, neededHeightUm: number): boolean;
+export declare function box(partial: PageBox): PageBox;
+//# sourceMappingURL=layout-flow.d.ts.map

package/dist/export/layout/layout-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-flow.d.ts","sourceRoot":"","sources":["../../../src/export/layout/layout-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAElG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,WAAW,EAAE,UAAU,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAW/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAM7E;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7C"}

package/dist/export/layout/layout-flow.js

@@ -0,0 +1,23 @@
+export function pushPage(flow) {
+    flow.pages.push(flow.currentPage);
+    flow.currentPage = {
+        index: flow.pages.length,
+        widthUm: flow.pageSize.widthUm,
+        heightUm: flow.pageSize.heightUm,
+        usableWidthUm: flow.usableWidthUm,
+        usableHeightUm: flow.usableHeightUm,
+        boxes: [],
+    };
+    flow.cursorY = flow.margin.top;
+}
+export function ensureSpace(flow, neededHeightUm) {
+    if (flow.cursorY + neededHeightUm > flow.margin.top + flow.usableHeightUm) {
+        pushPage(flow);
+        return true;
+    }
+    return false;
+}
+export function box(partial) {
+    return partial;
+}
+//# sourceMappingURL=layout-flow.js.map

package/dist/export/layout/layout-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-flow.js","sourceRoot":"","sources":["../../../src/export/layout/layout-flow.ts"],"names":[],"mappings":"AAeA,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,CAAC,WAAW,GAAG;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;QACxB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;QAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,KAAK,EAAE,EAAE;KACV,CAAC;IACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,cAAsB;IAClE,IAAI,IAAI,CAAC,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC1E,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAgB;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/export/layout/layout-structured.d.ts

@@ -0,0 +1,4 @@
+import type { BlockNode } from "../../core/model/types.js";
+import { type LayoutFlow } from "./layout-flow.js";
+export declare function layoutStructuredBlock(flow: LayoutFlow, block: BlockNode): boolean;
+//# sourceMappingURL=layout-structured.d.ts.map

package/dist/export/layout/layout-structured.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-structured.d.ts","sourceRoot":"","sources":["../../../src/export/layout/layout-structured.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAmJjF"}

package/dist/export/layout/layout-structured.js

@@ -0,0 +1,153 @@
+import { breakLines } from "./text.js";
+import { box, ensureSpace, pushPage } from "./layout-flow.js";
+export function layoutStructuredBlock(flow, block) {
+    const { margin, usableWidthUm, usableHeightUm, lineHeightDefault, diagnostics } = flow;
+    if (block.type === "table") {
+        const colCount = block.columns.length;
+        const colWidth = Math.floor(usableWidthUm / Math.max(1, colCount));
+        const headerHeight = lineHeightDefault * 1.2;
+        for (let ri = 0; ri < block.rows.length; ri++) {
+            const row = block.rows[ri];
+            let rowHeight = headerHeight;
+            for (const cell of row.cells) {
+                for (const b of cell.blocks) {
+                    if (b.type === "paragraph") {
+                        const txt = (b.children ?? []).map((c) => c.text ?? "").join("");
+                        const lines = breakLines(txt, { maxWidthUm: colWidth - 2000 });
+                        rowHeight = Math.max(rowHeight, lines.length * lineHeightDefault + 800);
+                    }
+                }
+            }
+            if (flow.cursorY + rowHeight > margin.top + usableHeightUm) {
+                if (rowHeight > usableHeightUm) {
+                    diagnostics.push({
+                        code: "row-too-tall",
+                        message: `Table row ${row.id} height ${rowHeight} exceeds usable height ${usableHeightUm}`,
+                        severity: "warn",
+                    });
+                }
+                pushPage(flow);
+                if (ri > 0 && block.rows[0].header) {
+                    flow.currentPage.boxes.push(box({
+                        id: `${block.id}_header_repeat`,
+                        type: "table-header",
+                        xUm: margin.left,
+                        yUm: flow.cursorY,
+                        widthUm: usableWidthUm,
+                        heightUm: headerHeight,
+                        content: "Header repeat",
+                    }));
+                    flow.cursorY += headerHeight;
+                }
+            }
+            flow.currentPage.boxes.push(box({
+                id: row.id,
+                type: "table-row",
+                xUm: margin.left,
+                yUm: flow.cursorY,
+                widthUm: usableWidthUm,
+                heightUm: rowHeight,
+                content: `row ${ri}`,
+            }));
+            flow.cursorY += rowHeight;
+        }
+        flow.cursorY += Math.round(lineHeightDefault * 0.4);
+        return true;
+    }
+    if (block.type === "columns") {
+        const n = Math.max(1, block.columns.length);
+        const gap = block.gapUm ?? 4000;
+        const colW = Math.floor((usableWidthUm - gap * (n - 1)) / n);
+        let maxH = 0;
+        for (let i = 0; i < n; i++) {
+            const col = block.columns[i];
+            let h = 0;
+            for (const b of col.blocks) {
+                if (b.type === "paragraph" || b.type === "heading" || b.type === "quote") {
+                    const txt = (b.children ?? [])
+                        .map((c) => c.text ?? c.source ?? "")
+                        .join("");
+                    const lines = breakLines(txt, { maxWidthUm: colW - 1000 });
+                    h += lines.length * lineHeightDefault + Math.round(lineHeightDefault * 0.2);
+                }
+                else if (b.type === "image") {
+                    h += b.heightUm ?? 30_000;
+                }
+                else {
+                    h += lineHeightDefault * 2;
+                }
+            }
+            maxH = Math.max(maxH, h);
+        }
+        ensureSpace(flow, maxH);
+        flow.currentPage.boxes.push(box({
+            id: block.id,
+            type: "columns",
+            xUm: margin.left,
+            yUm: flow.cursorY,
+            widthUm: usableWidthUm,
+            heightUm: maxH,
+            content: `${n} columns`,
+        }));
+        flow.cursorY += maxH + Math.round(lineHeightDefault * 0.3);
+        return true;
+    }
+    if (block.type === "image") {
+        const w = block.widthUm ?? 50_000;
+        const h = block.heightUm ?? 30_000;
+        if (w > usableWidthUm || h > usableHeightUm) {
+            diagnostics.push({
+                code: "image-too-large",
+                message: `Image ${block.id} ${w}x${h} exceeds usable ${usableWidthUm}x${usableHeightUm}`,
+                severity: "warn",
+            });
+        }
+        ensureSpace(flow, h);
+        flow.currentPage.boxes.push(box({
+            id: block.id,
+            type: "image",
+            xUm: margin.left,
+            yUm: flow.cursorY,
+            widthUm: Math.min(w, usableWidthUm),
+            heightUm: h,
+            content: block.assetId,
+        }));
+        flow.cursorY += h + Math.round(lineHeightDefault * 0.3);
+        return true;
+    }
+    if (block.type === "equation-block") {
+        const h = lineHeightDefault * 1.6;
+        ensureSpace(flow, h);
+        flow.currentPage.boxes.push(box({
+            id: block.id,
+            type: "equation-block",
+            xUm: margin.left,
+            yUm: flow.cursorY,
+            widthUm: usableWidthUm,
+            heightUm: h,
+            content: block.latex,
+        }));
+        flow.cursorY += h + Math.round(lineHeightDefault * 0.4);
+        return true;
+    }
+    if (block.type === "page-break") {
+        pushPage(flow);
+        return true;
+    }
+    if (block.type === "horizontal-rule") {
+        ensureSpace(flow, lineHeightDefault);
+        flow.currentPage.boxes.push(box({
+            id: block.id,
+            type: "horizontal-rule",
+            xUm: margin.left,
+            yUm: flow.cursorY,
+            widthUm: usableWidthUm,
+            heightUm: 400,
+            content: "---",
+        }));
+        flow.cursorY += 800;
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=layout-structured.js.map

package/dist/export/layout/layout-structured.js.map

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

package/dist/export/layout/layout-types.d.ts

@@ -0,0 +1,35 @@
+export interface PageBox {
+    id: string;
+    type: string;
+    xUm: number;
+    yUm: number;
+    widthUm: number;
+    heightUm: number;
+    content?: string;
+    lines?: Array<{
+        text: string;
+        yUm: number;
+    }>;
+}
+export interface LayoutPage {
+    index: number;
+    widthUm: number;
+    heightUm: number;
+    usableWidthUm: number;
+    usableHeightUm: number;
+    boxes: PageBox[];
+}
+export interface PaginationOptions {
+    widows?: number;
+    orphans?: number;
+}
+export interface PaginationResult {
+    pages: LayoutPage[];
+    diagnostics: Array<{
+        code: string;
+        message: string;
+        severity: "warn" | "error" | "info";
+    }>;
+    hash: string;
+}
+//# sourceMappingURL=layout-types.d.ts.map

package/dist/export/layout/layout-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-types.d.ts","sourceRoot":"","sources":["../../../src/export/layout/layout-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3F,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/export/layout/layout-types.js

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

package/dist/export/layout/layout-types.js.map

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

package/dist/export/layout/pagination.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pagination — Phase 6.2
+ * Vertical flow, forced breaks, basic widows/orphans, image size diagnostics, deterministic output.
+ */
+import type { PortableDocument } from "../../core/model/types.js";
+export type { LayoutPage, PageBox, PaginationOptions, PaginationResult } from "./layout-types.js";
+import type { PaginationOptions, PaginationResult } from "./layout-types.js";
+export declare function paginateDocument(doc: PortableDocument, opts?: PaginationOptions): PaginationResult;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/export/layout/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/export/layout/pagination.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,KAAK,EAAc,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAmCtG"}

package/dist/export/layout/pagination.js

@@ -0,0 +1,38 @@
+import { getFontMetrics } from "./text.js";
+import { layoutBlock } from "./layout-blocks.js";
+export function paginateDocument(doc, opts = {}) {
+    const diagnostics = [];
+    const pageWidthUm = doc.page.widthUm;
+    const pageHeightUm = doc.page.heightUm;
+    const margin = doc.page.marginUm;
+    const usableWidthUm = pageWidthUm - margin.left - margin.right;
+    const usableHeightUm = pageHeightUm - margin.top - margin.bottom;
+    const lineHeightDefault = getFontMetrics({ text: "x" }).lineHeightUm;
+    const pages = [];
+    const flow = {
+        opts,
+        diagnostics,
+        margin,
+        usableWidthUm,
+        usableHeightUm,
+        lineHeightDefault,
+        pages,
+        pageSize: { widthUm: pageWidthUm, heightUm: pageHeightUm },
+        currentPage: {
+            index: 0,
+            widthUm: pageWidthUm,
+            heightUm: pageHeightUm,
+            usableWidthUm,
+            usableHeightUm,
+            boxes: [],
+        },
+        cursorY: margin.top,
+    };
+    for (const block of doc.root.children)
+        layoutBlock(flow, block);
+    if (flow.currentPage.boxes.length > 0 || pages.length === 0)
+        pages.push(flow.currentPage);
+    const hash = `layout_${pages.length}_${pages.reduce((n, p) => n + p.boxes.length, 0)}`;
+    return { pages, diagnostics, hash };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/export/layout/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../src/export/layout/pagination.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD,MAAM,UAAU,gBAAgB,CAAC,GAAqB,EAAE,OAA0B,EAAE;IAClF,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;IACrC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;IACvC,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;IACjC,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/D,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IACjE,MAAM,iBAAiB,GAAG,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC;IACrE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAe;QACvB,IAAI;QACJ,WAAW;QACX,MAAM;QACN,aAAa;QACb,cAAc;QACd,iBAAiB;QACjB,KAAK;QACL,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE;QAC1D,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,YAAY;YACtB,aAAa;YACb,cAAc;YACd,KAAK,EAAE,EAAE;SACV;QACD,OAAO,EAAE,MAAM,CAAC,GAAG;KACpB,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ;QAAE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEhE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE1F,MAAM,IAAI,GAAG,UAAU,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACvF,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/export/layout/text.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Text metrics and line breaking — Phase 6.1.2
+ * Provides font metrics, line breaking, handling of spaces/tabs/hard breaks, fallback and missing glyphs.
+ * For v1 we use a deterministic monospace approximation without external font files or DOM measurement,
+ * ensuring backend/frontend parity and determinism. Real font shaping is deferred.
+ */
+export interface FontMetrics {
+    family: string;
+    sizePt: number;
+    avgCharWidthUm: number;
+    lineHeightUm: number;
+    ascentUm: number;
+    descentUm: number;
+}
+export interface TextRun {
+    text: string;
+    bold?: boolean;
+    italic?: boolean;
+    fontSizePt?: number;
+    fontFamily?: string;
+}
+export declare function getFontMetrics(run: TextRun, defaultSizePt?: number): FontMetrics;
+export interface LineBreakOptions {
+    maxWidthUm: number;
+    defaultFontSizePt?: number;
+}
+/**
+ * Greedy line breaker — splits text into lines that fit within maxWidthUm.
+ * Handles spaces, tabs, hard breaks and preserves words (no hyphenation in v1).
+ * Returns lines with width estimates; used for pagination and PDF text placement.
+ * Deterministic: no randomness, same input always yields same lines.
+ */
+export declare function breakLines(text: string, opts: LineBreakOptions): Array<{
+    text: string;
+    widthUm: number;
+    metrics: FontMetrics;
+}>;
+/**
+ * Estimate width of a run without breaking — used for inline layout.
+ */
+export declare function estimateRunWidth(run: TextRun, maxWidthUm: number): number;
+/**
+ * Check for missing glyphs — for MVP we consider all BMP characters as present.
+ * Returns list of code points not in the assumed font coverage.
+ */
+export declare function findMissingGlyphs(text: string): string[];
+//# sourceMappingURL=text.d.ts.map

package/dist/export/layout/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/export/layout/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,SAAK,GAAG,WAAW,CAe5E;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CA8D/H;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAcxD"}

package/dist/export/layout/text.js

@@ -0,0 +1,119 @@
+/**
+ * Text metrics and line breaking — Phase 6.1.2
+ * Provides font metrics, line breaking, handling of spaces/tabs/hard breaks, fallback and missing glyphs.
+ * For v1 we use a deterministic monospace approximation without external font files or DOM measurement,
+ * ensuring backend/frontend parity and determinism. Real font shaping is deferred.
+ */
+// Simple font registry — for MVP we approximate metrics derived from pt size
+export function getFontMetrics(run, defaultSizePt = 11) {
+    const sizePt = run.fontSizePt ?? defaultSizePt;
+    // Approximate: 1 pt ≈ 0.35mm width for average char; line height 1.2 * size
+    const avgCharWidthUm = Math.round(sizePt * 220); // tuned for ~0.22mm per pt -> ~2.5 chars per cm at 11pt
+    const lineHeightUm = Math.round(sizePt * 352.777 * 1.2);
+    const ascentUm = Math.round(lineHeightUm * 0.8);
+    const descentUm = lineHeightUm - ascentUm;
+    return {
+        family: run.fontFamily ?? "system-ui",
+        sizePt,
+        avgCharWidthUm,
+        lineHeightUm,
+        ascentUm,
+        descentUm,
+    };
+}
+/**
+ * Greedy line breaker — splits text into lines that fit within maxWidthUm.
+ * Handles spaces, tabs, hard breaks and preserves words (no hyphenation in v1).
+ * Returns lines with width estimates; used for pagination and PDF text placement.
+ * Deterministic: no randomness, same input always yields same lines.
+ */
+export function breakLines(text, opts) {
+    const { maxWidthUm, defaultFontSizePt = 11 } = opts;
+    const metrics = getFontMetrics({ text, fontSizePt: defaultFontSizePt });
+    const lines = [];
+    // Split on hard breaks first
+    const paragraphs = text.split("\n");
+    for (let p = 0; p < paragraphs.length; p++) {
+        const para = paragraphs[p];
+        if (para === "") {
+            lines.push({ text: "", widthUm: 0, metrics });
+            continue;
+        }
+        const words = para.split(/(\s+)/); // keep spaces
+        let current = "";
+        let currentWidth = 0;
+        const spaceWidth = metrics.avgCharWidthUm * 0.5;
+        const charWidth = metrics.avgCharWidthUm;
+        const flush = () => {
+            if (current) {
+                lines.push({ text: current, widthUm: currentWidth, metrics });
+                current = "";
+                currentWidth = 0;
+            }
+        };
+        for (const token of words) {
+            if (token === "")
+                continue;
+            const isSpace = /^\s+$/.test(token);
+            const tokenWidth = isSpace ? token.length * spaceWidth : token.length * charWidth;
+            // Handle tabs as 4 spaces
+            const normalizedWidth = token.includes("\t") ? token.replace(/\t/g, "    ").length * charWidth : tokenWidth;
+            const normalizedToken = token.replace(/\t/g, "    ");
+            if (normalizedWidth > maxWidthUm) {
+                // Word longer than line — break inside word (fallback)
+                flush();
+                let remaining = normalizedToken;
+                while (remaining.length > 0) {
+                    const charsFit = Math.max(1, Math.floor(maxWidthUm / charWidth));
+                    const chunk = remaining.slice(0, charsFit);
+                    lines.push({ text: chunk, widthUm: chunk.length * charWidth, metrics });
+                    remaining = remaining.slice(charsFit);
+                }
+                continue;
+            }
+            if (currentWidth + normalizedWidth > maxWidthUm && current) {
+                flush();
+                // Skip leading spaces on new line
+                if (isSpace)
+                    continue;
+            }
+            current += normalizedToken;
+            currentWidth += normalizedWidth;
+        }
+        flush();
+        // Preserve paragraph break as empty line between paragraphs except last
+        if (p < paragraphs.length - 1)
+            lines.push({ text: "", widthUm: 0, metrics });
+    }
+    return lines;
+}
+/**
+ * Estimate width of a run without breaking — used for inline layout.
+ */
+export function estimateRunWidth(run, maxWidthUm) {
+    const metrics = getFontMetrics(run);
+    const lines = breakLines(run.text, { maxWidthUm, defaultFontSizePt: metrics.sizePt });
+    return lines.length > 0 ? Math.max(...lines.map((l) => l.widthUm)) : 0;
+}
+/**
+ * Check for missing glyphs — for MVP we consider all BMP characters as present.
+ * Returns list of code points not in the assumed font coverage.
+ */
+export function findMissingGlyphs(text) {
+    const missing = [];
+    for (const ch of text) {
+        const cp = ch.codePointAt(0) ?? 0;
+        // Assume font covers Basic Latin + Latin-1 + common punctuation up to 0x4FF (Cyrillic)
+        // Anything beyond is flagged as missing for diagnostics
+        if (cp > 0x4ff && cp < 0x1f000) {
+            // Allow CJK and emoji as fallback (not missing, just fallback)
+            if (cp >= 0x4e00 && cp <= 0x9fff)
+                continue;
+            if (cp >= 0xac00 && cp <= 0xd7af)
+                continue;
+            missing.push(ch);
+        }
+    }
+    return [...new Set(missing)];
+}
+//# sourceMappingURL=text.js.map

package/dist/export/layout/text.js.map

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