@agile-team/mach-report 0.4.0

package/dist/builder/template-builder.d.ts

@@ -0,0 +1,53 @@
+import type { ListColumn, ListComponent, ReportTemplate, TemplatePage } from "../layout/paginate";
+import type { ComponentStyle, PlanComponent } from "../schema/render-plan";
+import { PAPER_SIZES } from "../units";
+type Geometry = Partial<Pick<PlanComponent, "leftMm" | "topMm" | "widthMm" | "heightMm">>;
+/** 纸张预设名（对齐 PAPER_SIZES 表） */
+export type PaperName = keyof typeof PAPER_SIZES;
+export interface PageOptions {
+    /** 横向（宽高互换） */
+    landscape?: boolean;
+    margins?: Partial<Pick<TemplatePage, "marginTopMm" | "marginBottomMm" | "marginLeftMm" | "marginRightMm">>;
+}
+type PageMargins = Partial<Pick<TemplatePage, "marginTopMm" | "marginBottomMm" | "marginLeftMm" | "marginRightMm">>;
+/** 解析纸张参数：数字按宽高使用；字符串查 PAPER_SIZES 预设；缺省 A4 纵向 */
+export declare function resolvePaper(paper: PaperName | {
+    widthMm: number;
+    heightMm: number;
+} | number, heightArg?: number, landscape?: boolean): {
+    widthMm: number;
+    heightMm: number;
+};
+export declare class TemplateBuilder {
+    readonly pages: TemplatePage[];
+    private pending;
+    /**
+     * 新建页。纸张支持三种写法：
+     * - 预设名：.page("a4", { landscape: true, margins: {...} })
+     * - 数字：.page(210, 297)（第三参数兼容旧 margins 对象或新 options）
+     * - 对象：.page({ widthMm: 210, heightMm: 297 })
+     */
+    page(paper?: PaperName | {
+        widthMm: number;
+        heightMm: number;
+    } | number, optionsOrHeight?: number | PageOptions, maybeOptions?: PageOptions | PageMargins): PageBuilder;
+    collect(): void;
+    build(): ReportTemplate;
+}
+export declare class PageBuilder {
+    private readonly parent;
+    private readonly page;
+    private components;
+    constructor(parent: TemplateBuilder, page: Omit<TemplatePage, "components">);
+    text(content: string, geometry?: Geometry, style?: ComponentStyle): this;
+    list(dataset: string, geometry: Partial<Pick<ListComponent, "leftMm" | "topMm" | "widthMm">>, columns: ListColumn[], options?: Partial<Omit<ListComponent, "kind" | "leftMm" | "topMm" | "widthMm" | "dataset" | "columns">>): this;
+    rect(geometry: Required<Pick<PlanComponent, "leftMm" | "topMm" | "widthMm" | "heightMm">>, style?: ComponentStyle): this;
+    line(leftMm: number, topMm: number, widthMm: number, style?: ComponentStyle): this;
+    barcode(content: string, geometry: Required<Geometry>): this;
+    qrcode(content: string, sizeMm: number, leftMm: number, topMm: number): this;
+    buildPage(): TemplatePage;
+    done(): TemplateBuilder;
+    build(): ReportTemplate;
+}
+export declare function createTemplate(): TemplateBuilder;
+export {};

package/dist/builder/template-builder.js

@@ -0,0 +1,153 @@
+import { PAPER_SIZES } from "../units";
+/** 解析纸张参数：数字按宽高使用；字符串查 PAPER_SIZES 预设；缺省 A4 纵向 */
+export function resolvePaper(paper, heightArg, landscape) {
+    let widthMm;
+    let heightMm;
+    if (typeof paper === "string") {
+        const preset = PAPER_SIZES[paper];
+        if (!preset)
+            throw new Error(`未知纸张预设 "${paper}"（可用：${Object.keys(PAPER_SIZES).join("/")}）`);
+        widthMm = preset.widthMm;
+        heightMm = preset.heightMm;
+    }
+    else if (typeof paper === "number") {
+        widthMm = paper;
+        heightMm = heightArg ?? 297;
+    }
+    else {
+        widthMm = paper.widthMm;
+        heightMm = paper.heightMm;
+    }
+    return landscape ? { widthMm: heightMm, heightMm: widthMm } : { widthMm, heightMm };
+}
+export class TemplateBuilder {
+    constructor() {
+        this.pages = [];
+        this.pending = null;
+    }
+    /**
+     * 新建页。纸张支持三种写法：
+     * - 预设名：.page("a4", { landscape: true, margins: {...} })
+     * - 数字：.page(210, 297)（第三参数兼容旧 margins 对象或新 options）
+     * - 对象：.page({ widthMm: 210, heightMm: 297 })
+     */
+    page(paper = "a4", optionsOrHeight = {}, maybeOptions) {
+        this.collect();
+        // 旧签名兼容：.page(w, h, { marginTopMm }) 的第三参数是 margins 本体
+        const legacyMargins = maybeOptions != null &&
+            !("margins" in maybeOptions) &&
+            !("landscape" in maybeOptions) &&
+            ("marginTopMm" in maybeOptions ||
+                "marginBottomMm" in maybeOptions ||
+                "marginLeftMm" in maybeOptions ||
+                "marginRightMm" in maybeOptions);
+        const options = legacyMargins
+            ? { margins: maybeOptions }
+            : (maybeOptions ?? {});
+        const { widthMm, heightMm } = resolvePaper(paper, typeof optionsOrHeight === "number" ? optionsOrHeight : undefined, options.landscape);
+        const margins = options.margins ?? {};
+        this.pending = new PageBuilder(this, {
+            widthMm,
+            heightMm,
+            marginTopMm: margins.marginTopMm ?? 10,
+            marginBottomMm: margins.marginBottomMm ?? 10,
+            marginLeftMm: margins.marginLeftMm ?? 10,
+            marginRightMm: margins.marginRightMm ?? 10
+        });
+        return this.pending;
+    }
+    collect() {
+        if (this.pending) {
+            this.pages.push(this.pending.buildPage());
+            this.pending = null;
+        }
+    }
+    build() {
+        this.collect();
+        if (this.pages.length === 0) {
+            throw new Error("模板至少需要一页：先调用 .page() 添加内容");
+        }
+        return { pages: this.pages };
+    }
+}
+export class PageBuilder {
+    constructor(parent, page) {
+        this.parent = parent;
+        this.page = page;
+        this.components = [];
+    }
+    text(content, geometry = {}, style = {}) {
+        this.components.push({
+            kind: "text",
+            leftMm: geometry.leftMm ?? 0,
+            topMm: geometry.topMm ?? 0,
+            widthMm: geometry.widthMm ?? 60,
+            heightMm: geometry.heightMm ?? 8,
+            text: content,
+            style
+        });
+        return this;
+    }
+    list(dataset, geometry, columns, options = {}) {
+        this.components.push({
+            kind: "list",
+            leftMm: geometry.leftMm ?? 10,
+            topMm: geometry.topMm ?? 30,
+            widthMm: geometry.widthMm ?? 180,
+            dataset,
+            columns,
+            ...options
+        });
+        return this;
+    }
+    rect(geometry, style = {}) {
+        this.components.push({ kind: "rect", ...geometry, style });
+        return this;
+    }
+    line(leftMm, topMm, widthMm, style = {}) {
+        this.components.push({
+            kind: "line",
+            leftMm,
+            topMm,
+            widthMm,
+            heightMm: 0.5,
+            style
+        });
+        return this;
+    }
+    barcode(content, geometry) {
+        this.components.push({
+            kind: "barcode",
+            leftMm: geometry.leftMm ?? 0,
+            topMm: geometry.topMm ?? 0,
+            widthMm: geometry.widthMm ?? 40,
+            heightMm: geometry.heightMm ?? 12,
+            fallbackText: content
+        });
+        return this;
+    }
+    qrcode(content, sizeMm, leftMm, topMm) {
+        this.components.push({
+            kind: "qrcode",
+            leftMm,
+            topMm,
+            widthMm: sizeMm,
+            heightMm: sizeMm,
+            fallbackText: content
+        });
+        return this;
+    }
+    buildPage() {
+        return { ...this.page, components: this.components };
+    }
+    done() {
+        return this.parent;
+    }
+    build() {
+        return this.done().build();
+    }
+}
+export function createTemplate() {
+    return new TemplateBuilder();
+}
+//# sourceMappingURL=template-builder.js.map

package/dist/builder/template-builder.js.map

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

package/dist/compat/jh4j-template.d.ts

@@ -0,0 +1,12 @@
+import type { ReportTemplate } from "../layout/paginate";
+export interface Jh4jImportResult {
+    template: ReportTemplate;
+    warnings: string[];
+}
+type Raw = Record<string, unknown>;
+/**
+ * jh4j 模板 content（exportBackendPrintConfig 产物，见 docs/reverse-findings.md §6）
+ * → MachReport ReportTemplate。单向转换，未知结构降级 + 告警，绝不抛错。
+ */
+export declare function importJh4jTemplateContent(content: string | Raw): Jh4jImportResult;
+export {};

package/dist/compat/jh4j-template.js

@@ -0,0 +1,196 @@
+function num(v, fallback) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function str(v, fallback = "") {
+    return typeof v === "string" ? v : fallback;
+}
+function isRaw(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function mapAlign(h) {
+    if (h === "Center")
+        return "center";
+    if (h === "Right")
+        return "right";
+    return "left";
+}
+function mapVAlign(v) {
+    if (v === "Center")
+        return "middle";
+    if (v === "Bottom")
+        return "bottom";
+    return "top";
+}
+function baseStyle(node) {
+    const fontSize = parseFloat(str(node["FontSize"], "10.5"));
+    return {
+        fontSize: Number.isFinite(fontSize) ? fontSize : 10.5,
+        fontFamily: str(node["FontFamily"], "黑体") || undefined,
+        bold: str(node["FontWeight"]) === "bold" || undefined,
+        italic: str(node["FontStyle"]) === "italic" || undefined,
+        underline: node["Underline"] === true || undefined,
+        color: str(node["FontColor"]) || undefined,
+        backgroundColor: str(node["BackgroundColor"]) || undefined,
+        align: mapAlign(str(node["HorAlignment"], "Left")),
+        verticalAlign: mapVAlign(str(node["VertAlignment"], "Top")),
+        lineHeight: (() => {
+            const lh = parseFloat(str(node["RowSpace"], "1"));
+            return Number.isFinite(lh) && lh !== 1 ? lh : undefined;
+        })(),
+        borderColor: str(node["BorderColor"]) || undefined,
+        borderTop: node["BorderTop"] !== false,
+        borderRight: node["BorderRight"] !== false,
+        borderBottom: node["BorderBottom"] !== false,
+        borderLeft: node["BorderLeft"] !== false
+    };
+}
+function convertElement(node, warnings) {
+    const uitype = str(node["uitype"]);
+    const comp = {
+        kind: "text",
+        leftMm: num(node["left"], 0),
+        topMm: num(node["top"], 0),
+        widthMm: num(node["width"], 40),
+        heightMm: num(node["height"], 8),
+        nid: str(node["nid"]) || undefined,
+        style: baseStyle(node)
+    };
+    switch (uitype) {
+        case "text": {
+            comp.kind = "text";
+            const text = node["Text"] ?? node["text"] ?? node["Value"];
+            comp.text = text == null ? "" : String(text);
+            const lines = node["Lines"] ?? node["lines"];
+            if (Array.isArray(lines)) {
+                comp.lines = lines.map((l) => String(l));
+            }
+            return comp;
+        }
+        case "richtext":
+            comp.kind = "text";
+            comp.text = str(node["Text"]);
+            warnings.push(`富文本 ${comp.nid ?? ""} 导入为纯文本（版式细节可能损失）`);
+            return comp;
+        case "image":
+        case "barcode":
+        case "qrcode":
+        case "chart":
+            comp.kind = uitype === "image" ? "image" : uitype;
+            comp.fallbackText = `[${uitype}]`;
+            warnings.push(`图片类组件 ${comp.nid ?? ""} 需运行时数据（imageData），已导入为占位`);
+            return comp;
+        case "table": {
+            comp.kind = "rect";
+            const cellsRaw = node["Cells"] ?? node["cells"];
+            if (Array.isArray(cellsRaw)) {
+                const grid = {
+                    cells: cellsRaw.map((row) => Array.isArray(row)
+                        ? row.map((cell) => ({
+                            text: isRaw(cell) ? str(cell["Text"] ?? cell["text"]) : "",
+                            colSpan: isRaw(cell) ? num(cell["ColSpan"], 1) : 1
+                        }))
+                        : [])
+                };
+                comp.grid = grid;
+            }
+            else {
+                comp.fallbackText = "[table]";
+                warnings.push(`表格 ${comp.nid ?? ""} 缺少 Cells，导入为空框`);
+            }
+            return comp;
+        }
+        case "subreport":
+            warnings.push(`子报表 ${comp.nid ?? ""} 暂不支持导入，已跳过`);
+            return null;
+        default: {
+            if (str(node["ShapeType"]) === "hline" || uitype === "hline") {
+                comp.kind = "line";
+                return comp;
+            }
+            if (uitype === "vline") {
+                comp.kind = "line";
+                return comp;
+            }
+            if (uitype === "rect" || uitype === "oval" || uitype === "shape") {
+                comp.kind = uitype === "oval" ? "ellipse" : "rect";
+                return comp;
+            }
+            warnings.push(`未知组件类型 ${uitype}，已跳过`);
+            return null;
+        }
+    }
+}
+/**
+ * jh4j 模板 content（exportBackendPrintConfig 产物，见 docs/reverse-findings.md §6）
+ * → MachReport ReportTemplate。单向转换，未知结构降级 + 告警，绝不抛错。
+ */
+export function importJh4jTemplateContent(content) {
+    const warnings = [];
+    let root = null;
+    if (typeof content === "string") {
+        try {
+            const parsed = JSON.parse(content);
+            if (isRaw(parsed))
+                root = parsed;
+        }
+        catch {
+            return {
+                template: { pages: [] },
+                warnings: ["content 不是合法 JSON"]
+            };
+        }
+    }
+    else if (isRaw(content)) {
+        root = content;
+    }
+    if (!root) {
+        return { template: { pages: [] }, warnings: ["content 为空"] };
+    }
+    const globalConfig = isRaw(root["GlobalConfig"]) ? root["GlobalConfig"] : {};
+    const defaultWidth = num(globalConfig["paperWidthMm"], 210);
+    const defaultHeight = num(globalConfig["paperHeightMm"], 297);
+    const defaultMargins = {
+        top: num(globalConfig["marginTop"], 10),
+        bottom: num(globalConfig["marginBottom"], 10),
+        left: num(globalConfig["marginLeft"], 10),
+        right: num(globalConfig["marginRight"], 10)
+    };
+    const pageNodes = Array.isArray(root["children"])
+        ? root["children"].filter((c) => isRaw(c) && str(c["uitype"]) === "page")
+        : [];
+    if (pageNodes.length === 0) {
+        warnings.push("content 中没有 uitype=page 的页节点");
+    }
+    const pages = pageNodes.map((raw) => {
+        const node = raw;
+        const elements = Array.isArray(node["children"]) ? node["children"] : [];
+        const components = [];
+        for (const el of elements) {
+            if (!isRaw(el))
+                continue;
+            const converted = convertElement(el, warnings);
+            if (converted)
+                components.push(converted);
+        }
+        return {
+            widthMm: num(node["width"], defaultWidth),
+            heightMm: num(node["DesignHeight"], defaultHeight),
+            marginTopMm: num(node["MarginTop"], defaultMargins.top),
+            marginBottomMm: num(node["MarginBottom"], defaultMargins.bottom),
+            marginLeftMm: num(node["MarginLeft"], defaultMargins.left),
+            marginRightMm: num(node["MarginRight"], defaultMargins.right),
+            components
+        };
+    });
+    if (pages.length === 0) {
+        warnings.push("转换结果为空页，已回退一张空白页");
+        pages.push({
+            widthMm: defaultWidth,
+            heightMm: defaultHeight,
+            ...defaultMargins,
+            components: []
+        });
+    }
+    return { template: { pages }, warnings };
+}
+//# sourceMappingURL=jh4j-template.js.map

package/dist/compat/jh4j-template.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 全引擎共享默认值（唯一真相源）。
+ *
+ * 修改这里的任何常量前请注意消费方：
+ * - LINE_HEIGHT：分页行高估算 / Canvas / PDF 三处换算必须一致
+ * - DEFAULT_FONT_PT / DEFAULT_BORDER_PT：三后端默认字号与线宽
+ * - SCHEMA_VERSION_*：RenderPlan 版本标识（adapter 产出侧使用）
+ *
+ * 历史：这些值曾散落在 paginate/canvas/pdf/dom 四个文件中各写一份，
+ * 是三后端漂移的温床，收敛于此。
+ */
+/** 默认行高倍数（基线距 = 字号 × 该系数，与 jh4j 打印口径一致） */
+export declare const LINE_HEIGHT = 1.35;
+/** 默认字号（pt），对齐 jh4j 模板缺省值 */
+export declare const DEFAULT_FONT_PT = 10.5;
+/** 默认边框线宽（pt） */
+export declare const DEFAULT_BORDER_PT = 0.75;
+/** 默认描边色（#333 与 jh4j 网格线一致） */
+export declare const DEFAULT_STROKE_COLOR = "#333333";
+/** 默认文本色 */
+export declare const DEFAULT_TEXT_COLOR = "#000000";
+/** RenderPlan 正式 schema 版本（core 分页引擎产出） */
+export declare const SCHEMA_VERSION_MACH = "1.0.0-mach";
+/** 本地渲染适配器产出版本标识（vue/createLocalFetcher） */
+export declare const SCHEMA_VERSION_LOCAL = "mach-local";
+/** jh4j gridPlan 兼容数据标识（vue/createJh4jGridPlanFetcher） */
+export declare const SCHEMA_VERSION_JH4J = "jh4j-compatible";

package/dist/defaults.js

@@ -0,0 +1,28 @@
+/**
+ * 全引擎共享默认值（唯一真相源）。
+ *
+ * 修改这里的任何常量前请注意消费方：
+ * - LINE_HEIGHT：分页行高估算 / Canvas / PDF 三处换算必须一致
+ * - DEFAULT_FONT_PT / DEFAULT_BORDER_PT：三后端默认字号与线宽
+ * - SCHEMA_VERSION_*：RenderPlan 版本标识（adapter 产出侧使用）
+ *
+ * 历史：这些值曾散落在 paginate/canvas/pdf/dom 四个文件中各写一份，
+ * 是三后端漂移的温床，收敛于此。
+ */
+/** 默认行高倍数（基线距 = 字号 × 该系数，与 jh4j 打印口径一致） */
+export const LINE_HEIGHT = 1.35;
+/** 默认字号（pt），对齐 jh4j 模板缺省值 */
+export const DEFAULT_FONT_PT = 10.5;
+/** 默认边框线宽（pt） */
+export const DEFAULT_BORDER_PT = 0.75;
+/** 默认描边色（#333 与 jh4j 网格线一致） */
+export const DEFAULT_STROKE_COLOR = "#333333";
+/** 默认文本色 */
+export const DEFAULT_TEXT_COLOR = "#000000";
+/** RenderPlan 正式 schema 版本（core 分页引擎产出） */
+export const SCHEMA_VERSION_MACH = "1.0.0-mach";
+/** 本地渲染适配器产出版本标识（vue/createLocalFetcher） */
+export const SCHEMA_VERSION_LOCAL = "mach-local";
+/** jh4j gridPlan 兼容数据标识（vue/createJh4jGridPlanFetcher） */
+export const SCHEMA_VERSION_JH4J = "jh4j-compatible";
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEhC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,iBAAiB;AACjB,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,YAAY;AACZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEhD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./defaults";
+export * from "./units";
+export * from "./schema/render-plan";
+export * from "./schema/validate";
+export * from "./layout/textwrap";
+export * from "./layout/paginate";
+export * from "./render/grid-geometry";
+export * from "./render/style";
+export * from "./render/dom";
+export * from "./render/canvas";
+export * from "./render/window";
+export * from "./compat/jh4j-template";
+export * from "./builder/template-builder";

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./defaults";
+export * from "./units";
+export * from "./schema/render-plan";
+export * from "./schema/validate";
+export * from "./layout/textwrap";
+export * from "./layout/paginate";
+export * from "./render/grid-geometry";
+export * from "./render/style";
+export * from "./render/dom";
+export * from "./render/canvas";
+export * from "./render/window";
+export * from "./compat/jh4j-template";
+export * from "./builder/template-builder";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/layout/paginate.d.ts

@@ -0,0 +1,51 @@
+import type { ComponentStyle, PlanComponent, RenderPlan } from "../schema/render-plan";
+import { measureTextMm, wrapText, type TextMeasurer } from "./textwrap";
+export interface ListColumn {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle;
+}
+export interface ListComponent {
+    kind: "list";
+    id?: string;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    dataset: string;
+    columns: ListColumn[];
+    fontSizePt?: number;
+    headerBold?: boolean;
+    rowHeightMm?: number;
+    paddingMm?: number;
+    headerEveryPage?: boolean;
+    headerBackgroundColor?: string;
+    border?: boolean;
+}
+export type TemplateComponent = PlanComponent | ListComponent;
+export interface TemplatePage {
+    widthMm: number;
+    heightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: TemplateComponent[];
+}
+export interface ReportTemplate {
+    schemaVersion?: string;
+    pages: TemplatePage[];
+}
+export type DatasetRows = Record<string, Record<string, unknown>[]>;
+export interface PaginateOptions {
+    /** 每行额外占高（mm），压测专用钩子 */
+    mmPerRow?: number;
+    /** 文本测量器（默认启发式；浏览器端可注入 canvas 测量校准） */
+    measurer?: TextMeasurer;
+}
+export interface PaginateResult {
+    plan: RenderPlan;
+    warnings: string[];
+}
+export declare function paginateTemplate(template: ReportTemplate, datasets: DatasetRows, optionsOrMmPerRow?: number | PaginateOptions): PaginateResult;
+export { measureTextMm, wrapText };