@agile-team/mach-report 0.4.0

package/dist/render/dom.js

@@ -0,0 +1,311 @@
+import { isImageBackedComponent, isRichText } from "../schema/render-plan";
+import { mmToPx, round } from "../units";
+import { resolveBoxBorders, resolveFontSize, resolveStroke } from "./style";
+const CLS = {
+    root: "mr-root",
+    page: "mr-page",
+    comp: "mr-comp",
+    text: "mr-text",
+    lines: "mr-lines",
+    line: "mr-line",
+    rich: "mr-rich",
+    paragraph: "mr-paragraph",
+    segment: "mr-segment",
+    image: "mr-image",
+    shape: "mr-shape",
+    grid: "mr-grid",
+    row: "mr-row",
+    cell: "mr-cell",
+    unknown: "mr-unknown"
+};
+export function classOf(key, options) {
+    return options?.classNames?.[key] ?? CLS[key];
+}
+/**
+ * 样式收集器：收集结束一次性赋值写入元素。
+ * `cssText = `（整串赋值，非追加）既保持一次 DOM 桥接调用的性能，
+ * 又从根上避免旧实现"cssText += 追加语义"导致的重复写入 bug。
+ */
+class StyleBag {
+    constructor() {
+        this.props = [];
+    }
+    add(prop, value) {
+        if (value === undefined || value === null || value === false || value === "")
+            return this;
+        this.props.push([prop, String(value)]);
+        return this;
+    }
+    mm(prop, valueMm, dpi, digits = 2) {
+        return this.add(prop, `${round(mmToPx(valueMm, dpi), digits)}px`);
+    }
+    toString() {
+        let css = "";
+        for (const [prop, value] of this.props) {
+            css += `${prop}:${value};`;
+        }
+        return css;
+    }
+    applyTo(el) {
+        const css = this.toString();
+        if (css)
+            el.style.cssText = css;
+    }
+}
+function applyComponentStyle(bag, comp, dpi) {
+    const s = comp.style || {};
+    bag
+        .add("color", s.color)
+        .add("background-color", s.backgroundColor)
+        .add("font-family", s.fontFamily)
+        .add("font-weight", s.bold ? "700" : undefined)
+        .add("font-style", s.italic ? "italic" : undefined)
+        .add("text-decoration", s.underline ? "underline" : undefined)
+        .add("letter-spacing", s.letterSpacing != null ? `${s.letterSpacing}pt` : undefined)
+        .add("opacity", s.opacity != null ? String(s.opacity) : undefined)
+        .add("transform", s.rotateDeg ? `rotate(${s.rotateDeg}deg)` : undefined);
+    const font = resolveFontSize(s, dpi);
+    bag.add("font-size", `${round(font.fontSizePx, 2)}px`);
+}
+function renderGrid(grid, comp, dpi, options, doc) {
+    const table = doc.createElement("table");
+    table.className = classOf("grid", options);
+    new StyleBag()
+        .add("width", "100%")
+        .add("height", "100%")
+        .add("border-collapse", "collapse")
+        .add("table-layout", grid.colWidthsMm ? "fixed" : "auto")
+        .applyTo(table);
+    if (grid.colWidthsMm) {
+        const colGroup = doc.createElement("colgroup");
+        for (const w of grid.colWidthsMm) {
+            const col = doc.createElement("col");
+            new StyleBag().mm("width", w, dpi).applyTo(col);
+            colGroup.appendChild(col);
+        }
+        table.appendChild(colGroup);
+    }
+    // 内部网格线由 td 边框承担（border-collapse 下 colSpan/rowSpan 自动正确）
+    const borders = resolveBoxBorders(comp.style);
+    const stroke = resolveStroke(comp.style);
+    const border = borders.inner
+        ? `${round((stroke.widthPt * dpi) / 72, 2)}px solid ${stroke.color}`
+        : "";
+    grid.cells.forEach((row, ri) => {
+        const rowEl = doc.createElement("tr");
+        rowEl.className = classOf("row", options);
+        if (grid.rowHeightsMm?.[ri] != null) {
+            new StyleBag().mm("height", grid.rowHeightsMm[ri], dpi).applyTo(rowEl);
+        }
+        (row || []).forEach((cell) => {
+            const cellEl = doc.createElement("td");
+            cellEl.className = classOf("cell", options);
+            if (cell?.colSpan)
+                cellEl.colSpan = cell.colSpan;
+            if (cell?.rowSpan)
+                cellEl.rowSpan = cell.rowSpan;
+            const cellBag = new StyleBag();
+            if (border)
+                cellBag.add("border", border);
+            if (cell?.style) {
+                const st = cell.style;
+                cellBag
+                    .add("text-align", st.align)
+                    .add("vertical-align", st.verticalAlign)
+                    .add("background-color", st.backgroundColor)
+                    .add("color", st.color)
+                    .add("font-weight", st.bold ? "700" : undefined);
+                cellBag.add("font-size", `${round(resolveFontSize(st, dpi).fontSizePx, 2)}px`);
+            }
+            cellBag.applyTo(cellEl);
+            if (cell?.text != null)
+                cellEl.textContent = cell.text;
+            if (cell?.children?.length) {
+                for (const child of cell.children) {
+                    cellEl.appendChild(renderComponent(child, dpi, options, doc));
+                }
+            }
+            rowEl.appendChild(cellEl);
+        });
+        table.appendChild(rowEl);
+    });
+    return table;
+}
+function renderText(comp, dpi, options, doc) {
+    const el = doc.createElement("div");
+    el.className = classOf("text", options);
+    const s = comp.style || {};
+    const bag = new StyleBag()
+        .add("text-align", s.align)
+        .add("display", "flex")
+        .add("flex-direction", "column")
+        .add("justify-content", s.verticalAlign === "middle" ? "center" : s.verticalAlign === "bottom" ? "flex-end" : "flex-start")
+        .add("overflow", "hidden");
+    applyComponentStyle(bag, comp, dpi);
+    bag.applyTo(el);
+    if (isRichText(comp)) {
+        const richBox = doc.createElement("div");
+        richBox.className = classOf("rich", options);
+        for (const para of comp.richParagraphs) {
+            const p = doc.createElement("div");
+            p.className = classOf("paragraph", options);
+            const pBag = new StyleBag()
+                .add("text-align", para.align)
+                .add("line-height", para.lineHeight != null ? String(para.lineHeight) : undefined)
+                .mm("margin-top", para.spaceBeforeMm ?? 0, dpi)
+                .mm("margin-bottom", para.spaceAfterMm ?? 0, dpi)
+                .mm("text-indent", para.indentMm ?? 0, dpi);
+            pBag.applyTo(p);
+            for (const seg of para.segments || []) {
+                const segEl = doc.createElement("span");
+                segEl.className = classOf("segment", options);
+                segEl.textContent = seg.kind === "field" ? (seg.field ?? "") : (seg.text ?? "");
+                if (seg.style) {
+                    const segBag = new StyleBag()
+                        .add("color", seg.style.color)
+                        .add("font-weight", seg.style.bold ? "700" : undefined);
+                    segBag.add("font-size", `${round(resolveFontSize(seg.style, dpi).fontSizePx, 2)}px`);
+                    segBag.applyTo(segEl);
+                }
+                p.appendChild(segEl);
+            }
+            richBox.appendChild(p);
+        }
+        el.appendChild(richBox);
+        return el;
+    }
+    if (Array.isArray(comp.lines) && comp.lines.length > 0) {
+        const box = doc.createElement("div");
+        box.className = classOf("lines", options);
+        if (s.lineHeight != null)
+            new StyleBag().add("line-height", String(s.lineHeight)).applyTo(box);
+        for (const line of comp.lines) {
+            const lineEl = doc.createElement("div");
+            lineEl.className = classOf("line", options);
+            lineEl.textContent = line;
+            box.appendChild(lineEl);
+        }
+        el.appendChild(box);
+        return el;
+    }
+    el.textContent = comp.text ?? "";
+    return el;
+}
+function renderImage(comp, options, doc) {
+    const img = doc.createElement("img");
+    img.className = classOf("image", options);
+    img.src = comp.imageData;
+    new StyleBag()
+        .add("width", "100%")
+        .add("height", "100%")
+        .add("object-fit", "contain")
+        .add("display", "block")
+        .applyTo(img);
+    img.alt = comp.kind;
+    return img;
+}
+function renderShape(comp, dpi, options, doc) {
+    const el = doc.createElement("div");
+    el.className = classOf("shape", options);
+    const s = comp.style || {};
+    const stroke = resolveStroke(s);
+    const borders = resolveBoxBorders(s);
+    const border = `${round((stroke.widthPt * dpi) / 72, 2)}px solid ${stroke.color}`;
+    const bag = new StyleBag();
+    // 含 grid 的 rect：内线由 td 承担，shape 只画外框四边（按开关）
+    if (comp.grid) {
+        if (borders.top)
+            bag.add("border-top", border);
+        if (borders.right)
+            bag.add("border-right", border);
+        if (borders.bottom)
+            bag.add("border-bottom", border);
+        if (borders.left)
+            bag.add("border-left", border);
+    }
+    else if (comp.kind === "rect") {
+        if (borders.top)
+            bag.add("border-top", border);
+        if (borders.right)
+            bag.add("border-right", border);
+        if (borders.bottom)
+            bag.add("border-bottom", border);
+        if (borders.left)
+            bag.add("border-left", border);
+    }
+    else if (comp.kind === "ellipse") {
+        if (borders.inner)
+            bag.add("border", border).add("border-radius", "50%");
+        if (s.backgroundColor)
+            bag.add("background-color", s.backgroundColor);
+    }
+    else if (comp.kind === "line") {
+        bag.add("height", "0").add("border-top", border);
+    }
+    bag.add("box-sizing", "border-box").add("width", "100%").add("height", "100%");
+    bag.applyTo(el);
+    return el;
+}
+export function renderComponent(comp, dpi, options, doc) {
+    const wrap = doc.createElement("div");
+    wrap.className = `${classOf("comp", options)} mr-kind-${comp.kind}`;
+    const bag = new StyleBag()
+        .add("position", "absolute")
+        .mm("left", comp.leftMm, dpi)
+        .mm("top", comp.topMm, dpi)
+        .mm("width", comp.widthMm, dpi)
+        .mm("height", comp.heightMm, dpi)
+        .add("box-sizing", "border-box");
+    applyComponentStyle(bag, comp, dpi);
+    bag.applyTo(wrap);
+    if (isImageBackedComponent(comp)) {
+        wrap.appendChild(renderImage(comp, options, doc));
+        return wrap;
+    }
+    if (comp.kind === "text") {
+        wrap.appendChild(renderText(comp, dpi, options, doc));
+        return wrap;
+    }
+    if (comp.grid) {
+        const shape = renderShape(comp, dpi, options, doc);
+        shape.appendChild(renderGrid(comp.grid, comp, dpi, options, doc));
+        wrap.appendChild(shape);
+        return wrap;
+    }
+    if (comp.kind === "line" || comp.kind === "rect" || comp.kind === "ellipse" || comp.kind === "chart") {
+        wrap.appendChild(renderShape(comp, dpi, options, doc));
+        return wrap;
+    }
+    const ph = doc.createElement("div");
+    ph.className = classOf("unknown", options);
+    ph.textContent = comp.fallbackText ?? "";
+    wrap.appendChild(ph);
+    return wrap;
+}
+export function renderPage(page, dpi, options, doc) {
+    const el = doc.createElement("div");
+    el.className = classOf("page", options);
+    new StyleBag()
+        .add("position", "relative")
+        .mm("width", page.pageWidthMm, dpi)
+        .mm("height", page.pageHeightMm, dpi)
+        .add("background-color", "#fff")
+        .add("overflow", "hidden")
+        .add("box-sizing", "border-box")
+        .applyTo(el);
+    for (const comp of page.components) {
+        el.appendChild(renderComponent(comp, dpi, options, doc));
+    }
+    return el;
+}
+export function renderPlan(plan, doc, options = {}) {
+    const dpi = options.dpi ?? 96;
+    const root = doc.createElement("div");
+    root.className = classOf("root", options);
+    root.dataset.schemaVersion = plan.schemaVersion;
+    plan.pages.forEach((page) => {
+        root.appendChild(renderPage(page, dpi, options, doc));
+    });
+    return root;
+}
+//# sourceMappingURL=dom.js.map

package/dist/render/dom.js.map

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

package/dist/render/grid-geometry.d.ts

@@ -0,0 +1,41 @@
+import type { GridCell, PlanGrid } from "../schema/render-plan";
+export interface GridCellBox {
+    ri: number;
+    ci: number;
+    cell: GridCell;
+    /** 相对组件左上角（mm，顶点原点） */
+    xMm: number;
+    yMm: number;
+    widthMm: number;
+    heightMm: number;
+}
+/** 网格线段：kind="h" 为水平线（pos=y，from/to=x 区间）；"v" 为垂直线（pos=x，from/to=y 区间） */
+export interface GridEdge {
+    kind: "h" | "v";
+    pos: number;
+    from: number;
+    to: number;
+}
+export interface GridLayout {
+    columns: {
+        pos: number;
+        size: number;
+    }[];
+    rows: {
+        pos: number;
+        size: number;
+    }[];
+    cells: GridCellBox[];
+    /** 内部网格线段（不含外框；已跳过被 colSpan/rowSpan 跨越的边界，相邻段已合并） */
+    edges: GridEdge[];
+}
+/**
+ * 网格几何统一解析（DOM/Canvas/PDF 三后端共用，单位真相源）：
+ * - 列宽：优先 colWidthsMm（等比缩放至组件宽），否则按列数均分
+ * - 行高：优先 rowHeightsMm（等比缩放至组件高），否则按行数均分
+ * - colSpan/rowSpan：占位矩阵展开，跨度取起止行列差；越界收敛到网格内
+ * - 行内 null/undefined 单元格视为占 1 列的空单元格（与 DOM 表格行为一致）
+ * - edges：内部网格线段，跳过被 span 跨越的边界（合并单元格中间无线）
+ * 产出为组件左上角顶点原点的 mm 坐标，各后端自行换算 px/pt。
+ */
+export declare function resolveGridLayout(grid: PlanGrid, compWidthMm: number, compHeightMm: number): GridLayout;

package/dist/render/grid-geometry.js

@@ -0,0 +1,131 @@
+function cumulate(sizesMm, totalMm) {
+    const n = sizesMm.length;
+    if (n === 0)
+        return [];
+    const sum = sizesMm.reduce((s, v) => s + v, 0);
+    const scale = sum > 0 && totalMm > 0 ? totalMm / sum : 1;
+    const out = [];
+    let acc = 0;
+    for (let i = 0; i < n; i++) {
+        const size = Math.max(0, sizesMm[i] * scale);
+        out.push({ pos: acc, size });
+        acc += size;
+    }
+    return out;
+}
+/**
+ * 网格几何统一解析（DOM/Canvas/PDF 三后端共用，单位真相源）：
+ * - 列宽：优先 colWidthsMm（等比缩放至组件宽），否则按列数均分
+ * - 行高：优先 rowHeightsMm（等比缩放至组件高），否则按行数均分
+ * - colSpan/rowSpan：占位矩阵展开，跨度取起止行列差；越界收敛到网格内
+ * - 行内 null/undefined 单元格视为占 1 列的空单元格（与 DOM 表格行为一致）
+ * - edges：内部网格线段，跳过被 span 跨越的边界（合并单元格中间无线）
+ * 产出为组件左上角顶点原点的 mm 坐标，各后端自行换算 px/pt。
+ */
+export function resolveGridLayout(grid, compWidthMm, compHeightMm) {
+    const rowsRaw = grid.cells ?? [];
+    const rowCount = Math.max(rowsRaw.length, 1);
+    const colCount = grid.colWidthsMm?.length ??
+        Math.max(1, ...rowsRaw.map((r) => (Array.isArray(r) ? r.length : 0)));
+    const widths = grid.colWidthsMm?.length
+        ? cumulate(grid.colWidthsMm, compWidthMm)
+        : Array.from({ length: colCount }, (_, i) => ({
+            pos: (compWidthMm * i) / colCount,
+            size: compWidthMm / colCount
+        }));
+    const colPos = (ci) => ci <= 0
+        ? 0
+        : ci >= colCount
+            ? widths[widths.length - 1].pos + widths[widths.length - 1].size
+            : widths[ci].pos;
+    const heights = grid.rowHeightsMm?.length
+        ? cumulate(grid.rowHeightsMm, compHeightMm)
+        : Array.from({ length: rowCount }, (_, i) => ({
+            pos: (compHeightMm * i) / rowCount,
+            size: compHeightMm / rowCount
+        }));
+    const rowPos = (ri) => ri <= 0
+        ? 0
+        : ri >= rowCount
+            ? heights[heights.length - 1].pos + heights[heights.length - 1].size
+            : heights[ri].pos;
+    const occupied = new Set();
+    const key = (r, c) => `${r}:${c}`;
+    const cells = [];
+    // 被跨度抑制的边界：vBridge 列边界 c 在行区间 [r1,r2) 内不画线；hBridge 行边界 r 在列区间 [c1,c2) 内不画线
+    const vBridge = new Set();
+    const hBridge = new Set();
+    const vKey = (c, r) => `v${c}:${r}`;
+    const hKey = (r, c) => `h${r}:${c}`;
+    rowsRaw.forEach((row, ri) => {
+        if (!Array.isArray(row))
+            return;
+        let ci = 0;
+        for (const cell of row) {
+            while (ci < colCount && occupied.has(key(ri, ci)))
+                ci++;
+            if (ci >= colCount)
+                break;
+            const colSpan = Math.max(1, Math.min(cell?.colSpan ?? 1, colCount - ci));
+            const rowSpan = Math.max(1, cell?.rowSpan ?? 1);
+            const rowEnd = Math.min(rowCount, ri + rowSpan);
+            const colEnd = Math.min(colCount, ci + colSpan);
+            for (let dr = ri; dr < rowEnd; dr++) {
+                for (let dc = ci; dc < colEnd; dc++) {
+                    occupied.add(key(dr, dc));
+                }
+            }
+            // 跨度内部边界登记为"桥"（该区间不画分隔线）
+            for (let c = ci + 1; c < colEnd; c++) {
+                for (let r = ri; r < rowEnd; r++)
+                    vBridge.add(vKey(c, r));
+            }
+            for (let r = ri + 1; r < rowEnd; r++) {
+                for (let c = ci; c < colEnd; c++)
+                    hBridge.add(hKey(r, c));
+            }
+            const xMm = colPos(ci);
+            const yMm = rowPos(ri);
+            cells.push({
+                ri,
+                ci,
+                cell: cell ?? {},
+                xMm,
+                yMm,
+                widthMm: colPos(colEnd) - xMm,
+                heightMm: rowPos(rowEnd) - yMm
+            });
+            ci = colEnd;
+        }
+    });
+    // 由占用矩阵直接推导边界（未被任何单元格覆盖的位置同样视为有线，保持闭合）
+    const edges = [];
+    // 垂直内线：列边界 c ∈ [1, colCount-1]，逐行扫描可画区间后合并
+    for (let c = 1; c < colCount; c++) {
+        let runStart = -1;
+        for (let r = 0; r <= rowCount; r++) {
+            const open = r < rowCount && !vBridge.has(vKey(c, r));
+            if (open && runStart < 0)
+                runStart = r;
+            if (!open && runStart >= 0) {
+                edges.push({ kind: "v", pos: colPos(c), from: rowPos(runStart), to: rowPos(r) });
+                runStart = -1;
+            }
+        }
+    }
+    // 水平内线：行边界 r ∈ [1, rowCount-1]
+    for (let r = 1; r < rowCount; r++) {
+        let runStart = -1;
+        for (let c = 0; c <= colCount; c++) {
+            const open = c < colCount && !hBridge.has(hKey(r, c));
+            if (open && runStart < 0)
+                runStart = c;
+            if (!open && runStart >= 0) {
+                edges.push({ kind: "h", pos: rowPos(r), from: colPos(runStart), to: colPos(c) });
+                runStart = -1;
+            }
+        }
+    }
+    return { columns: widths, rows: heights, cells, edges };
+}
+//# sourceMappingURL=grid-geometry.js.map

package/dist/render/grid-geometry.js.map

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

package/dist/render/style.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 组件样式解析（三后端共享的唯一样式语义真相源）。
+ *
+ * DOM/Canvas/PDF 各自把 ComponentStyle 翻译成绘制语义时必须经过这里，
+ * 禁止后端内联写 fontSize/颜色/线宽换算——历史上三处各写一份导致
+ * Canvas 字号 2.13x、网格线口径不一致等漂移 bug。
+ */
+import type { ComponentStyle } from "../schema/render-plan";
+/** 解析后的字号（px 值已按 dpi 换算；pt 值供 PDF 使用） */
+export interface ResolvedFontSize {
+    fontSizePt: number;
+    fontSizePx: number;
+}
+/** 字号解析：fontSizePx 直通；否则 pt→px（与 units.ptToPx 同源） */
+export declare function resolveFontSize(style: Pick<ComponentStyle, "fontSizePx" | "fontSize"> | undefined, dpi?: number, defaultPt?: number): ResolvedFontSize;
+/** 描边解析：颜色 + 线宽（pt） */
+export declare function resolveStroke(style: Pick<ComponentStyle, "borderColor" | "lineColor" | "lineWidthPt"> | undefined, fallbackColor?: string): {
+    color: string;
+    widthPt: number;
+};
+/** 文本颜色解析 */
+export declare function resolveTextColor(style: Pick<ComponentStyle, "color"> | undefined, fallback?: string): string;
+/** 行高解析（倍数，基线距 = 字号 × lineHeight） */
+export declare function resolveLineHeight(style: Pick<ComponentStyle, "lineHeight"> | undefined): number;
+/** 盒子边框语义：四边开关 + 内部网格线（四边全关则内线不画） */
+export interface BoxBorders {
+    top: boolean;
+    right: boolean;
+    bottom: boolean;
+    left: boolean;
+    /** 网格内线（仅当任意外边开启） */
+    inner: boolean;
+}
+/**
+ * 边框开关解析：
+ * - 未声明（undefined）→ 四边全开（与既有 rect 总有边框的行为兼容）
+ * - 显式 false → 对应边关闭
+ * - 四边全关（如 list border:false）→ 内线也不画
+ */
+export declare function resolveBoxBorders(style: Pick<ComponentStyle, "borderTop" | "borderRight" | "borderBottom" | "borderLeft"> | undefined): BoxBorders;

package/dist/render/style.js

@@ -0,0 +1,39 @@
+import { DEFAULT_BORDER_PT, DEFAULT_FONT_PT, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR, LINE_HEIGHT } from "../defaults";
+import { ptToPx } from "../units";
+/** 字号解析：fontSizePx 直通；否则 pt→px（与 units.ptToPx 同源） */
+export function resolveFontSize(style, dpi = 96, defaultPt = DEFAULT_FONT_PT) {
+    if (style?.fontSizePx != null) {
+        return { fontSizePt: (style.fontSizePx * 72) / dpi, fontSizePx: style.fontSizePx };
+    }
+    const pt = style?.fontSize ?? defaultPt;
+    return { fontSizePt: pt, fontSizePx: ptToPx(pt, dpi) };
+}
+/** 描边解析：颜色 + 线宽（pt） */
+export function resolveStroke(style, fallbackColor = DEFAULT_STROKE_COLOR) {
+    return {
+        color: style?.borderColor ?? style?.lineColor ?? fallbackColor,
+        widthPt: style?.lineWidthPt ?? DEFAULT_BORDER_PT
+    };
+}
+/** 文本颜色解析 */
+export function resolveTextColor(style, fallback = DEFAULT_TEXT_COLOR) {
+    return style?.color ?? fallback;
+}
+/** 行高解析（倍数，基线距 = 字号 × lineHeight） */
+export function resolveLineHeight(style) {
+    return style?.lineHeight ?? LINE_HEIGHT;
+}
+/**
+ * 边框开关解析：
+ * - 未声明（undefined）→ 四边全开（与既有 rect 总有边框的行为兼容）
+ * - 显式 false → 对应边关闭
+ * - 四边全关（如 list border:false）→ 内线也不画
+ */
+export function resolveBoxBorders(style) {
+    const top = style?.borderTop !== false;
+    const right = style?.borderRight !== false;
+    const bottom = style?.borderBottom !== false;
+    const left = style?.borderLeft !== false;
+    return { top, right, bottom, left, inner: top || right || bottom || left };
+}
+//# sourceMappingURL=style.js.map

package/dist/render/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/render/style.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAC7B,KAAkE,EAClE,GAAG,GAAG,EAAE,EACR,SAAS,GAAG,eAAe;IAE3B,IAAI,KAAK,EAAE,UAAU,IAAI,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;IACrF,CAAC;IACD,MAAM,EAAE,GAAG,KAAK,EAAE,QAAQ,IAAI,SAAS,CAAC;IACxC,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,aAAa,CAC3B,KAAoF,EACpF,aAAa,GAAG,oBAAoB;IAEpC,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,WAAW,IAAI,KAAK,EAAE,SAAS,IAAI,aAAa;QAC9D,OAAO,EAAE,KAAK,EAAE,WAAW,IAAI,iBAAiB;KACjD,CAAC;AACJ,CAAC;AAED,aAAa;AACb,MAAM,UAAU,gBAAgB,CAC9B,KAAgD,EAChD,QAAQ,GAAG,kBAAkB;IAE7B,OAAO,KAAK,EAAE,KAAK,IAAI,QAAQ,CAAC;AAClC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,iBAAiB,CAAC,KAAqD;IACrF,OAAO,KAAK,EAAE,UAAU,IAAI,WAAW,CAAC;AAC1C,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAoG;IAEpG,MAAM,GAAG,GAAG,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC;IACvC,MAAM,KAAK,GAAG,KAAK,EAAE,WAAW,KAAK,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,EAAE,YAAY,KAAK,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,EAAE,UAAU,KAAK,KAAK,CAAC;IACzC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,KAAK,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/dist/render/window.d.ts

@@ -0,0 +1,23 @@
+export interface PageWindowInput {
+    pageHeightsPx: number[];
+    viewportHeightPx: number;
+    scrollTopPx: number;
+    overscan?: number;
+    /** 页间距（px）。占位高度按“每页高度+间距”累计，与 margin-bottom 布局一致；默认 0 */
+    gapPx?: number;
+}
+export interface PageWindow {
+    start: number;
+    end: number;
+    padTopPx: number;
+    padBottomPx: number;
+}
+/**
+ * 页级视口虚拟化：给定每页高度与滚动位置，返回需要真实渲染的页区间
+ * 与上下占位高度。start/end 为闭区间索引。
+ *
+ * 布局模型：每页占据 height + gap（gap 为页间距，默认 0），
+ * padTop/padBottom 同口径累计，保证 占位+渲染页+间距 还原总滚动高度。
+ * 内部用前缀和 + 二分定位覆盖页与可见终点。
+ */
+export declare function computePageWindow(input: PageWindowInput): PageWindow;