@worm-vue3-print/core 1.2.2 → 1.3.1

package/dist/browser/index.cjs

@@ -30,11 +30,588 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/browser/index.ts
 var browser_exports = {};
 __export(browser_exports, {
+  EXECUTOR_VERSION: () => EXECUTOR_VERSION,
+  applyTextFit: () => applyTextFit,
   browserCodeRenderer: () => browserCodeRenderer,
-  renderHtmlPages: () => renderHtmlPages
+  createBrowserPrintRuntime: () => createBrowserPrintRuntime,
+  createIframeDriverFactory: () => createIframeDriverFactory,
+  domExecutor: () => domExecutor,
+  fitTextNode: () => fitTextNode,
+  readContentBottom: () => readContentBottom,
+  readMeasurements: () => readMeasurements,
+  renderCodes: () => renderCodes,
+  renderHtmlPages: () => renderHtmlPages,
+  waitReady: () => waitReady
 });
 module.exports = __toCommonJS(browser_exports);
 
+// src/print/errors.ts
+var PrintFailure = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "PrintFailure";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function toPrintFailure(err, fallbackCode, context) {
+  if (err instanceof PrintFailure) return err;
+  const detail = err instanceof Error ? err.message : String(err);
+  return new PrintFailure(fallbackCode, `${context}\uFF1A${detail}`, err);
+}
+async function withTimeout(task, ms, code, message) {
+  let timer;
+  try {
+    return await Promise.race([
+      task,
+      new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new PrintFailure(code, message)), ms);
+      })
+    ]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+
+// src/print/ports.ts
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_READINESS_MS = 5e3;
+
+// src/print/dom-host-runtime.ts
+function createDomHostRuntime(factory, bundle) {
+  return {
+    async withSession(options, fn) {
+      const driver = await factory.createDriver();
+      const deadline = Date.now() + (options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+      const readinessMs = options.readinessMs ?? DEFAULT_READINESS_MS;
+      const budget = () => Math.max(1, deadline - Date.now());
+      const fail = (err, code, context) => toPrintFailure(err, code, context);
+      let injected = false;
+      const ensureExecutor = async () => {
+        if (injected) return;
+        if (driver.requiresExecutor === false) {
+          injected = true;
+          return;
+        }
+        if (!bundle) throw new PrintFailure("INTERNAL", "\u7F3A\u5C11 core DOM \u6267\u884C\u5668\u4EA7\u7269");
+        await driver.injectExecutor(bundle);
+        injected = true;
+      };
+      const load = async (html, viewport) => {
+        await driver.open(viewport);
+        await driver.setContent(html);
+        injected = false;
+        await ensureExecutor();
+        await driver.evaluate("waitReady", [readinessMs]);
+      };
+      const session = {
+        async renderCodes(specs) {
+          if (specs.length === 0) return /* @__PURE__ */ new Map();
+          const ms = budget();
+          return withTimeout(
+            (async () => {
+              try {
+                await ensureExecutor();
+                const map = await driver.evaluate("renderCodes", [specs]);
+                return new Map(Object.entries(map));
+              } catch (err) {
+                throw fail(err, "INTERNAL", "\u7801\u503C\u6E32\u67D3\u5931\u8D25");
+              }
+            })(),
+            ms,
+            "RENDER_TIMEOUT",
+            `\u7801\u503C\u6E32\u67D3\u8D85\u8FC7 ${ms}ms`
+          );
+        },
+        async measure(html, viewport) {
+          const ms = budget();
+          return withTimeout(
+            (async () => {
+              try {
+                await load(html, viewport);
+                const fits = await driver.evaluate("applyTextFit") ?? [];
+                const measurements = await driver.evaluate("readMeasurements");
+                return { measurements, fits };
+              } catch (err) {
+                throw fail(err, "MEASURE_FAILED", "\u6D4B\u91CF\u5931\u8D25");
+              }
+            })(),
+            ms,
+            "RENDER_TIMEOUT",
+            `\u6D4B\u91CF\u8D85\u8FC7 ${ms}ms`
+          );
+        },
+        async probeContentBottom(html, viewport) {
+          const ms = budget();
+          return withTimeout(
+            (async () => {
+              try {
+                await load(html, viewport);
+                return await driver.evaluate("readContentBottom");
+              } catch (err) {
+                throw fail(err, "MEASURE_FAILED", "\u8FDE\u7EED\u7EB8\u63A2\u9488\u5931\u8D25");
+              }
+            })(),
+            ms,
+            "RENDER_TIMEOUT",
+            `\u8FDE\u7EED\u7EB8\u63A2\u9488\u8D85\u8FC7 ${ms}ms`
+          );
+        },
+        async toPdf(html, spec, viewport) {
+          if (!driver.pdf) throw new PrintFailure("UNSUPPORTED_RUNTIME", "\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u751F\u6210 PDF");
+          const ms = budget();
+          return withTimeout(
+            (async () => {
+              try {
+                await load(html, viewport);
+                return await driver.pdf(html, spec);
+              } catch (err) {
+                throw fail(err, "PDF_FAILED", "PDF \u751F\u6210\u5931\u8D25");
+              }
+            })(),
+            ms,
+            "RENDER_TIMEOUT",
+            `PDF \u751F\u6210\u8D85\u8FC7 ${ms}ms`
+          );
+        },
+        async toScreenshot(html, spec, viewport) {
+          if (!driver.screenshot) throw new PrintFailure("UNSUPPORTED_RUNTIME", "\u5F53\u524D\u5BBF\u4E3B\u4E0D\u652F\u6301\u622A\u56FE");
+          const ms = budget();
+          return withTimeout(
+            (async () => {
+              try {
+                await load(html, viewport);
+                return await driver.screenshot(html, spec);
+              } catch (err) {
+                throw fail(err, "SCREENSHOT_FAILED", "\u622A\u56FE\u5931\u8D25");
+              }
+            })(),
+            ms,
+            "RENDER_TIMEOUT",
+            `\u622A\u56FE\u8D85\u8FC7 ${ms}ms`
+          );
+        }
+      };
+      try {
+        return await fn(session);
+      } finally {
+        try {
+          await driver.close();
+        } catch {
+        }
+      }
+    }
+  };
+}
+
+// src/browser/browser-code-renderer.ts
+var import_jsbarcode = __toESM(require("jsbarcode"), 1);
+var import_qrcode = __toESM(require("qrcode"), 1);
+
+// src/render/barcode-dot.ts
+var MM_PER_INCH = 25.4;
+var BARCODE_QUIET_ZONE_MODULES = 10;
+var BARCODE_BAR_HEIGHT_MODULES = 30;
+var BARCODE_TEXT_FONT_SIZE_MODULES = 10;
+var BARCODE_MARGIN_BOTTOM_MODULES = 2;
+var BARCODE_MODULE_WIDTH_MM = 0.25;
+function barcodeUnitsPerModule(barWidth) {
+  const raw = typeof barWidth === "number" && Number.isFinite(barWidth) ? barWidth : 2;
+  return Math.max(1, raw / 2);
+}
+function barcodePreferredModuleWidthMm(barWidth) {
+  return barcodeUnitsPerModule(barWidth) * BARCODE_MODULE_WIDTH_MM;
+}
+function barcodeAvailableBoxMm(boxMm, maxMm) {
+  const box = typeof boxMm === "number" && boxMm > 0 ? boxMm : Number.POSITIVE_INFINITY;
+  const limit = typeof maxMm === "number" && maxMm > 0 ? Math.min(box, maxMm) : box;
+  return Number.isFinite(limit) ? limit : 0;
+}
+function resolveBarcodeSize(input) {
+  const unitWidth = Math.max(1, Math.ceil(input.unitWidth));
+  const unitHeight = Math.max(1, Math.ceil(input.unitHeight));
+  const preferredModuleMm = barcodePreferredModuleWidthMm(input.barWidth);
+  const maxModuleMm = Math.min(
+    input.boxWidthMm > 0 ? input.boxWidthMm / unitWidth : Number.POSITIVE_INFINITY,
+    input.boxHeightMm > 0 ? input.boxHeightMm / unitHeight : Number.POSITIVE_INFINITY
+  );
+  const dpi = input.dpi;
+  if (typeof dpi === "number" && Number.isFinite(dpi) && dpi > 0) {
+    const dotsPerMm = dpi / MM_PER_INCH;
+    const preferredDots = Math.max(1, Math.round(preferredModuleMm * dotsPerMm));
+    const maxDots = Math.floor(maxModuleMm * dotsPerMm);
+    if (maxDots >= 1) {
+      const dotsPerModule = Math.min(preferredDots, maxDots);
+      const moduleWidthMm2 = dotsPerModule / dotsPerMm;
+      return {
+        moduleWidthMm: moduleWidthMm2,
+        widthMm: unitWidth * moduleWidthMm2,
+        heightMm: unitHeight * moduleWidthMm2,
+        dotsPerModule,
+        scaledDown: dotsPerModule < preferredDots
+      };
+    }
+  }
+  const moduleWidthMm = Math.min(preferredModuleMm, maxModuleMm);
+  return {
+    moduleWidthMm,
+    widthMm: unitWidth * moduleWidthMm,
+    heightMm: unitHeight * moduleWidthMm,
+    dotsPerModule: null,
+    scaledDown: moduleWidthMm < preferredModuleMm
+  };
+}
+
+// src/browser/browser-code-renderer.ts
+var SVG_NS = "http://www.w3.org/2000/svg";
+function readViewBox(svg) {
+  const raw = svg.getAttribute("viewBox");
+  if (!raw) return null;
+  const parts = raw.trim().split(/[\s,]+/).map(Number);
+  if (parts.length !== 4 || parts.some((v) => !Number.isFinite(v))) return null;
+  return { width: parts[2], height: parts[3] };
+}
+function renderBarcodeSvg(value, opts) {
+  const svg = document.createElementNS(SVG_NS, "svg");
+  const unitPerModule = barcodeUnitsPerModule(opts.barWidth);
+  (0, import_jsbarcode.default)(svg, value, {
+    format: opts.barcodeType || "CODE128",
+    width: unitPerModule,
+    height: BARCODE_BAR_HEIGHT_MODULES * unitPerModule,
+    displayValue: opts.showText !== false,
+    fontSize: (opts.fontSize ?? BARCODE_TEXT_FONT_SIZE_MODULES) * unitPerModule,
+    // 静区只留左右：上下留白会白白吃掉元素高度（jsbarcode 的 margin 是四边通配）
+    margin: 0,
+    marginLeft: BARCODE_QUIET_ZONE_MODULES * unitPerModule,
+    marginRight: BARCODE_QUIET_ZONE_MODULES * unitPerModule,
+    marginTop: 0,
+    marginBottom: BARCODE_MARGIN_BOTTOM_MODULES * unitPerModule
+  });
+  const viewBox = readViewBox(svg);
+  if (viewBox) {
+    const size = resolveBarcodeSize({
+      unitWidth: viewBox.width / unitPerModule,
+      unitHeight: viewBox.height / unitPerModule,
+      boxWidthMm: opts.targetWidthMm ?? 0,
+      boxHeightMm: opts.targetHeightMm ?? 0,
+      dpi: opts.printerDpi,
+      barWidth: opts.barWidth
+    });
+    svg.setAttribute("width", `${size.widthMm}mm`);
+    svg.setAttribute("height", `${size.heightMm}mm`);
+  }
+  svg.setAttribute("shape-rendering", "crispEdges");
+  return svg.outerHTML;
+}
+function renderQrSvg(value, opts) {
+  const level = (opts.qrCodeLevel ?? "M").toUpperCase();
+  const qr = import_qrcode.default.create(value, {
+    errorCorrectionLevel: ["L", "M", "Q", "H"].includes(level) ? level : "M"
+  });
+  const modules = qr.modules;
+  const size = modules.size;
+  const dot = 4;
+  const quiet = 4 * dot;
+  const dim = size * dot + quiet * 2;
+  let rects = "";
+  for (let y = 0; y < size; y++) {
+    for (let x = 0; x < size; x++) {
+      if (modules.get(x, y)) {
+        rects += `<rect x="${quiet + x * dot}" y="${quiet + y * dot}" width="${dot}" height="${dot}" fill="#000"/>`;
+      }
+    }
+  }
+  return `<svg xmlns="${SVG_NS}" viewBox="0 0 ${dim} ${dim}" width="${dim}" height="${dim}" shape-rendering="crispEdges">${rects}</svg>`;
+}
+function renderCodeSvg(value, cellType, opts = {}) {
+  if (!value) throw new Error("empty barcode value");
+  return cellType === "qrcode" ? renderQrSvg(value, opts) : renderBarcodeSvg(value, opts);
+}
+var browserCodeRenderer = {
+  render(value, cellType, opts = {}) {
+    return renderCodeSvg(value, cellType, opts);
+  }
+};
+
+// src/designer/utils/units.ts
+function ptToMm(pt) {
+  return pt / 2.83464566929;
+}
+function mmToPx(mm2) {
+  return mm2 * (96 / 25.4);
+}
+
+// src/render/text-fit.ts
+var DEFAULT_SHRINK_MIN_FONT_SIZE_PT = 6;
+var MIN_SHRINK_FONT_SIZE_PT = 1;
+var VALID_FITS = ["clip", "shrink", "autoHeight"];
+function normalizeFit(value) {
+  return typeof value === "string" && VALID_FITS.includes(value) ? value : void 0;
+}
+var ELEMENT_DEFAULT_FIT = {
+  text: "clip",
+  longText: "autoHeight"
+};
+function resolveElementTextFit(type, opts) {
+  return normalizeFit(opts?.textFit) ?? ELEMENT_DEFAULT_FIT[type] ?? "clip";
+}
+function resolveCellTextFit(cell) {
+  return normalizeFit(cell?.textFit) ?? (cell?.wordWrap === false ? "clip" : "autoHeight");
+}
+function resolveShrinkMinFontSize(pt) {
+  if (typeof pt !== "number" || !Number.isFinite(pt) || pt <= 0) return DEFAULT_SHRINK_MIN_FONT_SIZE_PT;
+  return Math.max(pt, MIN_SHRINK_FONT_SIZE_PT);
+}
+function roundFontSize(pt) {
+  return Math.round(pt * 100) / 100;
+}
+function floorFontSize(pt) {
+  return Math.floor(pt * 100) / 100;
+}
+function cellFitKey(elementId, kind, rowIndex, colIndex) {
+  return `${elementId}#${kind}#${rowIndex}:${colIndex}`;
+}
+function parseCellFitKey(key) {
+  const first = key.indexOf("#");
+  if (first < 0) return void 0;
+  const last = key.lastIndexOf("#");
+  const kind = key.slice(first + 1, last);
+  if (kind !== "b" && kind !== "st" && kind !== "sm") return void 0;
+  const [rowIndex, colIndex] = key.slice(last + 1).split(":").map(Number);
+  if (!Number.isFinite(rowIndex) || !Number.isFinite(colIndex)) return void 0;
+  return { elementId: key.slice(0, first), kind, rowIndex, colIndex };
+}
+function cellFitWidthMm(colWidths, colIndex, cell, defaultPadding = 1) {
+  const span = Math.max(cell?.colspan ?? 1, 1);
+  let width = 0;
+  for (let i = 0; i < span; i++) {
+    width += colWidths[colIndex + i] ?? 0;
+  }
+  if (width <= 0) return 0;
+  const padding = cell?.padding ?? defaultPadding;
+  const borderMm = (ptToMm(cell?.borders?.left?.width ?? 0) + ptToMm(cell?.borders?.right?.width ?? 0)) / 2;
+  return Math.max(width - padding * 2 - borderMm, 0.5);
+}
+function cellFitCapMm(rows, rowIndex, cell, defaultPadding = 1) {
+  const span = Math.max(cell?.rowspan ?? 1, 1);
+  let height = 0;
+  for (let i = 0; i < span; i++) {
+    height += rows[rowIndex + i]?.height ?? 8;
+  }
+  const padding = cell?.padding ?? defaultPadding;
+  const borderMm = (ptToMm(cell?.borders?.top?.width ?? 0) + ptToMm(cell?.borders?.bottom?.width ?? 0)) / 2;
+  return Math.max(height - padding * 2 - borderMm, 0.5);
+}
+
+// src/browser/text-fit-dom.ts
+var FIT_TOLERANCE_PX = 0.5;
+var SEARCH_STEPS = 12;
+function readAttrNumber(el, name) {
+  const raw = el.getAttribute(name);
+  if (raw === null || raw === "") return void 0;
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : void 0;
+}
+function overflows(el, targetPx) {
+  if (el.scrollWidth > el.clientWidth + FIT_TOLERANCE_PX) return true;
+  const content = el.scrollHeight;
+  if (targetPx !== void 0) return content > targetPx + FIT_TOLERANCE_PX;
+  return content > el.clientHeight + FIT_TOLERANCE_PX;
+}
+function fitTextNode(el) {
+  if (el.getAttribute("data-fit") !== "shrink") return void 0;
+  const minPt = resolveShrinkMinFontSize(readAttrNumber(el, "data-fit-min"));
+  const start = Math.max(readAttrNumber(el, "data-fit-base") ?? minPt, minPt);
+  const targetMm = readAttrNumber(el, "data-fit-mm");
+  const targetPx = targetMm !== void 0 && targetMm > 0 ? mmToPx(targetMm) : void 0;
+  const apply = (pt) => {
+    const size = floorFontSize(pt);
+    el.style.fontSize = `${size}pt`;
+    el.setAttribute("data-fit-size", String(size));
+    return size;
+  };
+  const base = apply(start);
+  if (!overflows(el, targetPx)) return base;
+  if (start <= minPt) return base;
+  let lo = minPt;
+  let hi = start;
+  for (let i = 0; i < SEARCH_STEPS; i++) {
+    const mid = (lo + hi) / 2;
+    apply(mid);
+    if (overflows(el, targetPx)) hi = mid;
+    else lo = mid;
+  }
+  return apply(lo);
+}
+function applyTextFit(doc) {
+  const fits = [];
+  doc.querySelectorAll('[data-fit="shrink"]').forEach((el) => {
+    const size = fitTextNode(el);
+    const key = el.getAttribute("data-fit-key");
+    if (size === void 0 || !key) return;
+    fits.push({ key, fontSizePt: size });
+  });
+  return fits;
+}
+
+// src/browser/dom-executor.ts
+var EXECUTOR_VERSION = "2";
+var DEFAULT_READY_TIMEOUT_MS = 5e3;
+async function waitReady(win, timeoutMs = DEFAULT_READY_TIMEOUT_MS) {
+  const doc = win.document;
+  const wait = (task) => Promise.race([task, new Promise((resolve) => setTimeout(resolve, timeoutMs))]);
+  const ready = (async () => {
+    if (doc.readyState !== "complete") {
+      await wait(new Promise((resolve) => win.addEventListener("load", () => resolve(), { once: true })));
+    }
+    const fonts = doc.fonts;
+    if (fonts) {
+      await wait(Promise.all(declaredFontFaces(doc).map(
+        (face) => fonts.load(`${face.style} ${face.weight} 16px "${face.family}"`).catch(() => void 0)
+      )));
+      if (fonts.ready) await wait(fonts.ready);
+    }
+    await wait(Promise.all(Array.from(doc.images ?? []).map(
+      (img) => img.complete ? Promise.resolve() : new Promise((resolve) => {
+        img.addEventListener("load", () => resolve(), { once: true });
+        img.addEventListener("error", () => resolve(), { once: true });
+      })
+    )));
+  })();
+  await wait(ready);
+}
+function declaredFontFaces(doc) {
+  const out = [];
+  const CSS_FONT_FACE_RULE = 5;
+  for (const sheet of Array.from(doc.styleSheets ?? [])) {
+    let rules;
+    try {
+      rules = sheet.cssRules;
+    } catch {
+      continue;
+    }
+    for (const rule of Array.from(rules ?? [])) {
+      if (rule.type !== CSS_FONT_FACE_RULE) continue;
+      const style = rule.style;
+      const family = (style.getPropertyValue("font-family") || "").replace(/^["']|["']$/g, "");
+      if (!family) continue;
+      out.push({
+        family,
+        weight: style.getPropertyValue("font-weight") || "400",
+        style: style.getPropertyValue("font-style") || "normal"
+      });
+    }
+  }
+  return out;
+}
+function readMeasurements(doc) {
+  const result = [];
+  doc.querySelectorAll("[data-measure-id]").forEach((node) => {
+    const el = node;
+    const id = el.getAttribute("data-measure-id");
+    if (!id) return;
+    const heightPx = el.getBoundingClientRect().height;
+    const table = el.querySelector("table.print-table");
+    if (!table) {
+      result.push({ id, heightPx });
+      return;
+    }
+    const rowHeightsPx = [];
+    table.querySelectorAll("tbody > tr[data-row-index]").forEach((row) => {
+      rowHeightsPx.push(row.getBoundingClientRect().height);
+    });
+    result.push({ id, heightPx, rowHeightsPx });
+  });
+  return result;
+}
+function readContentBottom(doc) {
+  const page = doc.querySelector(".print-page");
+  const area = doc.querySelector(".content-area");
+  if (!page || !area) return 0;
+  const pageTop = page.getBoundingClientRect().top;
+  let maxBottom = 0;
+  area.querySelectorAll("*").forEach((node) => {
+    const rect = node.getBoundingClientRect();
+    if (rect.height > 0) maxBottom = Math.max(maxBottom, rect.bottom - pageTop);
+  });
+  const areaRect = area.getBoundingClientRect();
+  if (areaRect.height > 0) maxBottom = Math.max(maxBottom, areaRect.bottom - pageTop);
+  return maxBottom;
+}
+function renderCodes(specs) {
+  const map = {};
+  for (const spec of specs) {
+    try {
+      map[spec.key] = renderCodeSvg(spec.value, spec.cellType, spec.opts);
+    } catch {
+    }
+  }
+  return map;
+}
+var domExecutor = {
+  version: EXECUTOR_VERSION,
+  waitReady,
+  readMeasurements,
+  readContentBottom,
+  renderCodes,
+  /** 自动缩小（data-fit="shrink"）：须在 readMeasurements 之前调用，返回需回写的字号清单 */
+  applyTextFit
+};
+
+// src/print/driver.ts
+var EXECUTOR_TARGETS = {
+  waitReady: "window",
+  readMeasurements: "document",
+  readContentBottom: "document",
+  renderCodes: "none",
+  applyTextFit: "document"
+};
+
+// src/browser/driver-iframe.ts
+function createIframeDriverFactory() {
+  return {
+    async createDriver() {
+      const iframe = document.createElement("iframe");
+      iframe.setAttribute("aria-hidden", "true");
+      iframe.style.cssText = "position:fixed;left:-10000px;top:0;border:0;visibility:hidden;pointer-events:none;";
+      document.body.appendChild(iframe);
+      let doc = iframe.contentDocument ?? document;
+      return {
+        requiresExecutor: false,
+        async open(viewport) {
+          iframe.style.width = `${viewport.width}px`;
+          iframe.style.height = `${viewport.height}px`;
+          doc = iframe.contentDocument ?? document;
+        },
+        async setContent(html) {
+          doc = iframe.contentDocument ?? document;
+          doc.open();
+          doc.write(html);
+          doc.close();
+        },
+        async injectExecutor(_bundle) {
+        },
+        async evaluate(method, args) {
+          const fn = domExecutor[method];
+          const payload = args ?? [];
+          const target = EXECUTOR_TARGETS[method];
+          if (target === "window") return fn(iframe.contentWindow, ...payload);
+          if (target === "document") return fn(doc, ...payload);
+          return fn(...payload);
+        },
+        async close() {
+          iframe.remove();
+        }
+      };
+    }
+  };
+}
+
+// src/browser/browser-runtime.ts
+function createBrowserPrintRuntime() {
+  return createDomHostRuntime(createIframeDriverFactory());
+}
+
 // src/lexer.ts
 var DANGEROUS_PROPS = /* @__PURE__ */ new Set([
   "constructor",
@@ -377,6 +954,113 @@ var Parser = class {
   }
 };
 
+// src/numeric.ts
+var MAX_DIGITS = 20;
+var EXTRA_SCALE = 8;
+function toNumber(value, fallback = 0) {
+  if (typeof value === "number") return Number.isFinite(value) ? value : fallback;
+  if (typeof value === "string") {
+    const s = value.trim();
+    if (s === "") return fallback;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : fallback;
+  }
+  if (value == null) return fallback;
+  if (typeof value === "boolean") return value ? 1 : 0;
+  return fallback;
+}
+function isNumericLike(value) {
+  if (typeof value === "number") return Number.isFinite(value);
+  if (typeof value === "string") {
+    const s = value.trim();
+    return s !== "" && Number.isFinite(Number(s));
+  }
+  return false;
+}
+function normalizeFloat(value) {
+  if (!Number.isFinite(value) || Number.isInteger(value)) return value;
+  if (Math.abs(value) >= 1e15) return value;
+  return Number(value.toPrecision(12));
+}
+function decimalsOf(n) {
+  if (!Number.isFinite(n) || Number.isInteger(n)) return 0;
+  const s = String(n);
+  if (s.includes("e") || s.includes("E")) return 0;
+  const i = s.indexOf(".");
+  return i === -1 ? 0 : s.length - i - 1;
+}
+function rescale(value, decimals) {
+  if (!Number.isFinite(value)) return 0;
+  const d = Math.min(Math.max(decimals, 0), 12);
+  if (d === 0) return Math.round(value);
+  const f = 10 ** d;
+  const scaled = value * f;
+  if (!Number.isFinite(scaled) || Math.abs(scaled) >= 1e15) return normalizeFloat(value);
+  return Math.round(scaled) / f;
+}
+function decimalAdd(left, right) {
+  const a = toNumber(left);
+  const b = toNumber(right);
+  const raw = a + b;
+  return rescale(raw, Math.max(decimalsOf(a), decimalsOf(b)));
+}
+function decimalSubtract(left, right) {
+  const a = toNumber(left);
+  const b = toNumber(right);
+  const raw = a - b;
+  return rescale(raw, Math.max(decimalsOf(a), decimalsOf(b)));
+}
+function decimalMultiply(left, right) {
+  const a = toNumber(left);
+  const b = toNumber(right);
+  const raw = a * b;
+  return rescale(raw, decimalsOf(a) + decimalsOf(b));
+}
+function decimalDivide(left, right) {
+  const a = toNumber(left);
+  const b = toNumber(right);
+  if (b === 0) return 0;
+  return normalizeFloat(a / b);
+}
+function decimalModulo(left, right) {
+  const a = toNumber(left);
+  const b = toNumber(right);
+  if (b === 0) return 0;
+  return normalizeFloat(a % b);
+}
+function normalizeDigits(digits) {
+  if (digits === void 0 || digits === null) return 2;
+  const d = Math.trunc(toNumber(digits, 2));
+  if (!Number.isFinite(d)) return 2;
+  return Math.min(Math.max(d, -MAX_DIGITS), MAX_DIGITS);
+}
+function roundTo(value, digits, mode) {
+  const n = toNumber(value, 0);
+  const d = normalizeDigits(digits);
+  if (n === 0) return 0;
+  if (Math.abs(n) >= 1e21) return normalizeFloat(n);
+  const scale = Math.max(d, 0) + EXTRA_SCALE;
+  const fixed = n.toFixed(scale);
+  if (!/^-?\d+(\.\d+)?$/.test(fixed)) return normalizeFloat(n);
+  const negative = fixed.startsWith("-");
+  const digitsStr = fixed.replace("-", "").replace(".", "");
+  let scaled = BigInt(digitsStr || "0");
+  if (negative) scaled = -scaled;
+  const pow10 = 10n ** BigInt(scale - d);
+  const sign = scaled < 0n ? -1n : 1n;
+  const abs = scaled < 0n ? -scaled : scaled;
+  let q = abs / pow10;
+  const r = abs % pow10;
+  const doubled = 2n * r;
+  if (mode === "up") {
+    if (r !== 0n) q += 1n;
+  } else if (mode !== "down" && doubled >= pow10) {
+    if (doubled > pow10 || mode === "half-up" || q % 2n === 1n) q += 1n;
+  }
+  const result = sign * q;
+  return normalizeFloat(d >= 0 ? Number(result) / 10 ** d : Number(result) * 10 ** -d);
+}
+
 // src/evaluator.ts
 var SAFE_GLOBALS = {
   Math,
@@ -442,16 +1126,17 @@ function evalBinary(node, context, functions) {
   const left = evaluate(node.left, context, functions);
   const right = evaluate(node.right, context, functions);
   switch (node.op) {
+    // 数值运算统一走十进制精确实现：消除 0.1 + 0.2 类浮点噪声、字符串数字按数值处理、除零兜底 0
     case "+":
-      return left + right;
+      return isNumericOperands(left, right) ? decimalAdd(left, right) : concatOperands(left, right);
     case "-":
-      return left - right;
+      return decimalSubtract(left, right);
     case "*":
-      return left * right;
+      return decimalMultiply(left, right);
     case "/":
-      return left / right;
+      return decimalDivide(left, right);
     case "%":
-      return left % right;
+      return decimalModulo(left, right);
     case "<":
       return left < right;
     case ">":
@@ -480,15 +1165,29 @@ function evalUnary(node, context, functions) {
   const arg = evaluate(node.arg, context, functions);
   switch (node.op) {
     case "-":
-      return -arg;
+      return decimalSubtract(0, arg);
     case "+":
-      return +arg;
+      return toNumber(arg);
     case "!":
       return !arg;
     default:
       throw new Error(`\u672A\u77E5\u4E00\u5143\u8FD0\u7B97\u7B26: ${node.op}`);
   }
 }
+function concatOperands(left, right) {
+  return `${left == null ? "" : String(left)}${right == null ? "" : String(right)}`;
+}
+function isNumericOperands(left, right) {
+  const l = operandKind(left);
+  const r = operandKind(right);
+  if (l === "other" || r === "other") return false;
+  return l === "num" || r === "num";
+}
+function operandKind(value) {
+  if (value == null || value === "") return "neutral";
+  if (isNumericLike(value)) return "num";
+  return "other";
+}
 function evalMember(node, context, functions) {
   const obj = evaluate(node.object, context, functions);
   if (obj == null) {
@@ -608,8 +1307,8 @@ function formatDate(value, fmt) {
     return String(value);
   }
   if (isNaN(date.getTime())) return String(value);
-  const pad = (n) => String(n).padStart(2, "0");
-  return fmt.replace("YYYY", String(date.getFullYear())).replace("MM", pad(date.getMonth() + 1)).replace("DD", pad(date.getDate())).replace("HH", pad(date.getHours())).replace("mm", pad(date.getMinutes())).replace("ss", pad(date.getSeconds()));
+  const pad3 = (n) => String(n).padStart(2, "0");
+  return fmt.replace("YYYY", String(date.getFullYear())).replace("MM", pad3(date.getMonth() + 1)).replace("DD", pad3(date.getDate())).replace("HH", pad3(date.getHours())).replace("mm", pad3(date.getMinutes())).replace("ss", pad3(date.getSeconds()));
 }
 function toUpperCaseAmount(value) {
   const num = Number(value);
@@ -700,6 +1399,34 @@ function max(rows, field) {
   return Math.max(...rows.map((row) => Number(getByPath(row, field)) || 0));
 }
 
+// src/functions/math.ts
+function addNumbers(...values) {
+  return values.reduce((acc, v) => decimalAdd(acc, v), 0);
+}
+function subtractNumbers(...values) {
+  if (values.length === 0) return 0;
+  return values.slice(1).reduce((acc, v) => decimalSubtract(acc, v), decimalAdd(values[0], 0));
+}
+function multiplyNumbers(...values) {
+  if (values.length === 0) return 0;
+  return values.reduce((acc, v) => decimalMultiply(acc, v), 1);
+}
+function divideNumbers(a, b) {
+  return decimalDivide(a, b);
+}
+function round(value, digits) {
+  return roundTo(value, digits, "half-up");
+}
+function roundUp(value, digits) {
+  return roundTo(value, digits, "up");
+}
+function roundDown(value, digits) {
+  return roundTo(value, digits, "down");
+}
+function roundHalfEven(value, digits) {
+  return roundTo(value, digits, "half-even");
+}
+
 // src/render/expression-eval.ts
 var RenderEngine = class {
   constructor() {
@@ -725,8 +1452,19 @@ var FORMAT_FUNCTIONS = {
   IF: ifFn,
   CONCAT: (...args) => args.filter((v) => v != null).map(String).join(""),
   IFEMPTY: (v, d) => v != null && v !== "" ? String(v) : d,
-  ROUND: (n, d) => Number(Number(n).toFixed(d)),
-  LEN: (s) => String(s).length
+  LEN: (s) => String(s).length,
+  // 四则运算（与 +/-/*// 运算符同一套数值语义，供不方便写运算符的场景使用）
+  ADD: addNumbers,
+  SUB: subtractNumbers,
+  MUL: multiplyNumbers,
+  DIV: divideNumbers,
+  // 数值修约
+  ROUND: round,
+  ROUNDUP: roundUp,
+  CEIL: roundUp,
+  ROUNDDOWN: roundDown,
+  FLOOR: roundDown,
+  ROUNDBANK: roundHalfEven
 };
 for (const [name, fn] of Object.entries(FORMAT_FUNCTIONS)) {
   engine.registerFunction(name, fn);
@@ -747,6 +1485,9 @@ function aggregate(fn, field, rows) {
       return 0;
   }
 }
+function safeEval(expr, context) {
+  return engine.evaluate(expr, context);
+}
 function evaluateTemplate(text, ctx) {
   if (!text) return "";
   if (!text.includes("{")) return text;
@@ -767,9 +1508,8 @@ function evaluateTemplate(text, ctx) {
 }
 
 // src/render/data-binder.ts
-function bindData(template, printData, baseUrl) {
-  const raw = printData ?? {};
-  const data = Array.isArray(raw) ? raw[0] ?? {} : raw;
+function bindData(template, printData, baseUrl, fontBaseUrl) {
+  const data = { ...resolveSystemVariables(), ...printData ?? {} };
   const bound = JSON.parse(JSON.stringify(template));
   if (bound.header?.elements) {
     bound.header.elements = bound.header.elements.map((el) => bindElement(el, data, baseUrl));
@@ -781,12 +1521,29 @@ function bindData(template, printData, baseUrl) {
     bound.firstPageOverlay.elements = bound.firstPageOverlay.elements.map((el) => bindElement(el, data, baseUrl));
   }
   bound.elements = bound.elements.map((el) => bindElement(el, data, baseUrl));
+  const fontBase = fontBaseUrl ?? baseUrl;
+  if (fontBase && bound.fonts?.length) {
+    const prefix = fontBase.replace(/\/+$/, "");
+    bound.fonts = bound.fonts.map((font) => ({
+      ...font,
+      files: (font.files ?? []).map((file) => ({
+        ...file,
+        // 绝对 URL（含协议相对 //）原样使用
+        url: file.url?.startsWith("/") && !file.url.startsWith("//") ? prefix + file.url : file.url
+      }))
+    }));
+  }
   return bound;
 }
 function bindElement(el, data, baseUrl) {
   const cloned = { ...el, options: { ...el.options } };
   if (typeof cloned.options.formatter === "string") {
-    cloned.options.formatter = evaluateTemplate(cloned.options.formatter, data);
+    const raw = cloned.options.formatter;
+    if (referencesPageNumbers(raw)) {
+      cloned.options.rawFormatter = raw;
+    } else {
+      cloned.options.formatter = evaluateTemplate(raw, data);
+    }
   }
   const isImage = cloned.type === "image" || cloned.printElementType?.type === "image";
   if (isImage && typeof cloned.options.src === "string") {
@@ -833,39 +1590,25 @@ function bindTableData(el, data) {
         if (dataStartIdx < 0) dataStartIdx = renderRows.length;
         const ctx = itemCtx(item);
         renderRows.push(makeRenderRow(row, (cell) => {
-          const formatter = cell.formatter;
-          if (!formatter) return "";
-          return evaluateTemplate(formatter, ctx);
+          return resolveCellText(cell, ctx);
         }));
         dataRowCtx.push(ctx);
       }
       continue;
     }
     if (mode === "dynamic" && row.type === "subtotal") {
-      const tpl = makeRenderRow(row, (cell) => {
-        const formatter = cell.formatter;
-        if (!formatter) return "";
-        return evaluateTemplate(formatter, { rows: summaryRows, ...data });
-      }, true);
+      const tpl = makeRenderRow(row, (cell) => resolveCellText(cell, { rows: summaryRows, ...data }), true);
       subtotalTemplates.push(tpl);
       renderRows.push(tpl);
       continue;
     }
     if (mode === "dynamic" && row.type === "summary") {
-      const summaryRow = makeRenderRow(row, (cell) => {
-        const formatter = cell.formatter;
-        if (!formatter) return "";
-        return evaluateTemplate(formatter, { rows: summaryRows, ...data });
-      });
+      const summaryRow = makeRenderRow(row, (cell) => resolveCellText(cell, { rows: summaryRows, ...data }));
       summaryRenderRows.push(summaryRow);
       renderRows.push(summaryRow);
       continue;
     }
-    renderRows.push(makeRenderRow(row, (cell) => {
-      const formatter = cell.formatter;
-      if (!formatter) return "";
-      return evaluateTemplate(formatter, data);
-    }));
+    renderRows.push(makeRenderRow(row, (cell) => resolveCellText(cell, data)));
   }
   opts._renderRows = renderRows;
   opts._repeatHeaderCount = countRepeatHeader(rows);
@@ -875,17 +1618,25 @@ function bindTableData(el, data) {
   opts._summaryRows = summaryRenderRows;
   opts._mainData = data;
 }
+function resolveCellText(cell, ctx) {
+  const formatter = cell.formatter;
+  if (!formatter) return "";
+  if (referencesPageNumbers(formatter)) return formatter;
+  return evaluateTemplate(formatter, ctx);
+}
 function makeRenderRow(row, resolve, keepRaw = false) {
   return {
     type: row.type,
     height: row.height ?? 8,
     cells: row.cells.map((cell) => ({
       content: cell.merged ? "" : resolve(cell),
-      ...keepRaw ? { rawFormatter: cell.merged ? "" : cell.formatter ?? "" } : {},
+      // 小计行（keepRaw）与引用页码的单元格都保留原始表达式：前者按当页数据行重算，后者按当页页码重算
+      ...(keepRaw || referencesPageNumbers(cell.formatter)) && !cell.merged ? { rawFormatter: cell.formatter ?? "" } : {},
       cellType: cell.cellType,
       barcodeType: cell.barcodeType,
       qrCodeLevel: cell.qrCodeLevel,
       showBarcodeText: cell.showBarcodeText,
+      printerDpi: cell.printerDpi,
       fit: cell.fit,
       maxWidth: cell.maxWidth,
       maxHeight: cell.maxHeight,
@@ -895,30 +1646,108 @@ function makeRenderRow(row, resolve, keepRaw = false) {
       align: cell.align,
       valign: cell.valign,
       fontSize: cell.fontSize,
+      fontFamily: cell.fontFamily,
       fontWeight: cell.fontWeight,
       color: cell.color,
       backgroundColor: cell.backgroundColor,
       borders: cell.borders,
       padding: cell.padding,
-      wordWrap: cell.wordWrap
+      wordWrap: cell.wordWrap,
+      textFit: cell.textFit,
+      shrinkMinFontSize: cell.shrinkMinFontSize
     }))
   };
 }
 function countRepeatHeader(rows) {
+  const headerCount = countLeadingHeaderRows(rows);
+  if (headerCount === 0) return 0;
+  const enabled = rows.slice(0, headerCount).some((row) => row.repeatOnPage === true);
+  if (!enabled) return 0;
+  return alignToRowspanBoundary(rows, headerCount);
+}
+function countLeadingHeaderRows(rows) {
   let n = 0;
   for (const row of rows) {
-    if (row.type === "header" && row.repeatOnPage === true) {
-      n++;
-    } else {
-      break;
-    }
+    if (row?.type !== "header") break;
+    n++;
   }
   return n;
 }
-function injectSystemVariables(html) {
-  const now = /* @__PURE__ */ new Date();
-  const printDate = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
-  return html.replace(/\{printDate\}/g, printDate);
+function isRowspanComplete(rows, n) {
+  for (let r = 0; r < n; r++) {
+    for (const cell of rows[r]?.cells ?? []) {
+      if (cell?.merged) continue;
+      if (r + (cell?.rowspan ?? 1) > n) return false;
+    }
+  }
+  return true;
+}
+function alignToRowspanBoundary(rows, max2) {
+  for (let n = max2; n >= 1; n--) {
+    if (isRowspanComplete(rows, n)) return n;
+  }
+  return 1;
+}
+var pad2 = (n) => String(n).padStart(2, "0");
+function resolveSystemVariables(now = /* @__PURE__ */ new Date(), page = {}) {
+  return {
+    printDate: `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`,
+    printTime: `${pad2(now.getHours())}:${pad2(now.getMinutes())}:${pad2(now.getSeconds())}`,
+    pageIndex: page.pageIndex ?? 1,
+    totalPages: page.totalPages ?? 1
+  };
+}
+function referencesPageNumbers(expr) {
+  return typeof expr === "string" && /\b(pageIndex|totalPages)\b/.test(expr);
+}
+function injectSystemVariables(html, now = /* @__PURE__ */ new Date()) {
+  const { printDate, printTime } = resolveSystemVariables(now);
+  return html.replace(/\{printDate\}/g, printDate).replace(/\{printTime\}/g, printTime);
+}
+
+// src/print/fonts.ts
+function buildFontFaceCss(fonts) {
+  const blocks = [];
+  for (const font of fonts ?? []) {
+    const family = font?.family?.trim();
+    if (!family) continue;
+    const quoted = `"${family.replace(/"/g, "")}"`;
+    for (const file of font.files ?? []) {
+      const url = file?.url?.trim();
+      if (!url) continue;
+      const weight = Number.isFinite(file.weight) ? Number(file.weight) : 400;
+      const style = file.style === "italic" ? "italic" : "normal";
+      blocks.push(
+        `@font-face{font-family:${quoted};src:url("${url}")${fontFormatHint(url)};font-weight:${weight};font-style:${style};font-display:block;}`
+      );
+    }
+  }
+  return blocks.length ? `${blocks.join("")}
+` : "";
+}
+function fontFormatHint(url) {
+  const path = url.split(/[?#]/)[0].toLowerCase();
+  if (path.endsWith(".woff2")) return ' format("woff2")';
+  if (path.endsWith(".woff")) return ' format("woff")';
+  if (path.endsWith(".ttf")) return ' format("truetype")';
+  if (path.endsWith(".otf")) return ' format("opentype")';
+  return "";
+}
+var FALLBACK_FONT_STACK = [
+  '"Microsoft YaHei"',
+  '"PingFang SC"',
+  '"Helvetica Neue"',
+  "Arial",
+  "sans-serif"
+];
+function escapeInlineStyleValue(cssValue) {
+  return cssValue.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+function toFontFamilyStack(family) {
+  const name = family?.trim();
+  if (!name) return FALLBACK_FONT_STACK.join(", ");
+  const head = name.includes(",") ? name : `"${name.replace(/"/g, "")}"`;
+  return [head, ...FALLBACK_FONT_STACK].join(", ");
 }
 
 // src/render/types.ts
@@ -928,38 +1757,81 @@ var PAPER_DIMENSIONS = {
   A5: { width: 148, height: 210 },
   Letter: { width: 216, height: 279 },
   Legal: { width: 216, height: 356 },
-  CUSTOM: { width: 210, height: 297 }
+  // 针式打印纸（241 系列等分）：11 英寸整张 279.4mm 按等分取整
+  DOT_FULL: { width: 241, height: 279.4 },
+  DOT_HALF: { width: 241, height: 139.7 },
+  DOT_THIRD: { width: 241, height: 93.1 },
+  // 标签纸
+  LABEL_80X60: { width: 80, height: 60 },
+  LABEL_60X40: { width: 60, height: 40 },
+  LABEL_40X30: { width: 40, height: 30 },
+  // 小票纸（热敏卷纸）：高度仅为设计画布高度，出纸按内容推导
+  THERMAL_57: { width: 57, height: 297 },
+  THERMAL_80: { width: 80, height: 297 },
+  THERMAL_110: { width: 110, height: 297 },
+  CUSTOM: { width: 210, height: 297 },
+  // 连续纸：默认 80mm 热敏；高度仅为设计画布高度，出纸按内容推导
+  CONTINUOUS: { width: 80, height: 297 }
 };
+var CONTINUOUS_PAPER_SIZES = /* @__PURE__ */ new Set([
+  "CONTINUOUS",
+  "THERMAL_57",
+  "THERMAL_80",
+  "THERMAL_110"
+]);
+function isContinuousPaperSize(paperSize) {
+  return CONTINUOUS_PAPER_SIZES.has(paperSize);
+}
 function getPaperDimensions(template) {
-  const base = template.paperSize === "CUSTOM" ? { width: template.customWidth ?? 210, height: template.customHeight ?? 297 } : PAPER_DIMENSIONS[template.paperSize];
-  if (template.orientation === "landscape") {
+  const continuous = isContinuousPaperSize(template.paperSize);
+  const base = template.paperSize === "CUSTOM" || continuous ? {
+    width: template.customWidth ?? PAPER_DIMENSIONS[template.paperSize].width,
+    height: template.customHeight ?? PAPER_DIMENSIONS[template.paperSize].height
+  } : PAPER_DIMENSIONS[template.paperSize];
+  if (template.orientation === "landscape" && !continuous) {
     return { width: base.height, height: base.width };
   }
   return { ...base };
 }
+function getOutputPaperDimensions(template) {
+  const continuous = isContinuousPaperSize(template.paperSize);
+  if (continuous || template.tiling?.enabled === true) {
+    return getPaperDimensions(template);
+  }
+  const design = getPaperDimensions(template);
+  const swap = template.outputRotation === 90 || template.outputRotation === 270;
+  return swap ? { width: design.height, height: design.width } : design;
+}
+function getOutputRotationAngle(template) {
+  const continuous = isContinuousPaperSize(template.paperSize);
+  if (continuous || template.tiling?.enabled === true) return 0;
+  return template.outputRotation ?? 0;
+}
+function isContinuousPaper(template) {
+  return isContinuousPaperSize(template.paperSize);
+}
 
 // src/render/css-builder.ts
 function mm(value) {
   return `${value}mm`;
 }
-function buildPageCss(template) {
-  const paper = getPaperDimensions(template);
-  const { top: mt, right: mr, bottom: mb, left: ml } = template.margins;
-  const headerH = template.header?.height ?? 0;
-  const footerH = template.footer?.height ?? 0;
-  const overlayH = template.firstPageOverlay?.height ?? 0;
-  const contentWidth = paper.width - ml - mr;
+function resolveOuterPaper(template, pageHeightMm) {
+  const out = getOutputPaperDimensions(template);
+  return pageHeightMm && pageHeightMm > 0 && isContinuousPaper(template) ? { width: out.width, height: pageHeightMm } : out;
+}
+function resolveAreaPaper(template, pageHeightMm) {
+  const design = getPaperDimensions(template);
+  return pageHeightMm && pageHeightMm > 0 && isContinuousPaper(template) ? { width: design.width, height: pageHeightMm } : design;
+}
+function screenBlock() {
   return `
-/* \u2500\u2500 \u6253\u5370\u7EB8\u5F20\uFF1A\u6D4F\u89C8\u5668\u539F\u751F\u6253\u5370\u6309\u6B64\u5C3A\u5BF8\u5206\u9875\uFF08Playwright page.pdf \u4EE5\u663E\u5F0F\u5BBD\u9AD8\u4E3A\u51C6\uFF0C\u65E0\u526F\u4F5C\u7528\uFF09 \u2500\u2500 */
-@page { size: ${mm(paper.width)} ${mm(paper.height)}; margin: 0; }
-
 /* \u2500\u2500 \u5168\u5C40\u91CD\u7F6E \u2500\u2500 */
 * { margin: 0; padding: 0; box-sizing: border-box; }
 
 /* \u6253\u5370\u5FC5\u987B\u4FDD\u7559\u5143\u7D20\u80CC\u666F\u8272\uFF08Chromium \u9ED8\u8BA4\u5254\u9664\u80CC\u666F\uFF0C\u9700\u663E\u5F0F\u58F0\u660E\uFF09 */
 * { -webkit-print-color-adjust: exact; print-color-adjust: exact; }
 
-body { font-family: "Microsoft YaHei", "PingFang SC", "Helvetica Neue", Arial, sans-serif; }
+body { font-family: ${FALLBACK_FONT_STACK.join(", ")}; }
 
 /* \u2500\u2500 \u5C4F\u5E55\u9884\u89C8\uFF1A\u7070\u5E95 + \u7EB8\u5F20\u9634\u5F71/\u9875\u95F4\u8DDD\uFF1B\u6253\u5370\u65F6\u53BB\u9664 \u2500\u2500 */
 @media screen {
@@ -970,53 +1842,31 @@ body { font-family: "Microsoft YaHei", "PingFang SC", "Helvetica Neue", Arial, s
   body { background: #fff; }
   .print-page { margin: 0; box-shadow: none; }
 }
-
-/* \u2500\u2500 \u7EB8\u5F20\u9875\u9762 \u2500\u2500 */
-.print-page {
-  width: ${mm(paper.width)};
-  min-height: ${mm(paper.height)};
-  background: ${template.pageBackground ?? "#fff"};
-  padding: ${mm(mt)} ${mm(mr)} ${mm(mb)} ${mm(ml)};
-  position: relative;
-  page-break-after: always;
-  overflow: hidden;
-}
-.print-page:last-child {
-  page-break-after: auto;
-}
-
-/* \u2500\u2500 \u9875\u7709 \u2500\u2500 */
-.page-header {
-  width: ${mm(contentWidth)};
-  height: ${mm(headerH)};
-  position: relative;
+`;
 }
-
-/* \u2500\u2500 \u9875\u811A\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D\u56FA\u5B9A\u5728\u9875\u9762\u5E95\u90E8\uFF08\u5185\u5BB9\u4E0D\u8DB3\u65F6\u4E0D\u968F\u6587\u6863\u6D41\u4E0A\u6D6E\uFF09 \u2500\u2500
-   \u7528\u663E\u5F0F top \u5B9A\u4F4D\u5230\u300C\u7EB8\u9AD8 - \u4E0B\u8FB9\u8DDD - \u9875\u811A\u9AD8\u300D\uFF0C\u4FDD\u8BC1\u4E0B\u8FB9\u8DDD\u751F\u6548\u3001
-   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002 */
-.page-footer {
-  width: ${mm(contentWidth)};
-  height: ${mm(footerH)};
+function watermarkBlock() {
+  return `
+/* \u2500\u2500 \u6C34\u5370\u5C42\uFF1A\u8986\u76D6\u6574\u9875\u3001\u4F4D\u4E8E\u6240\u6709\u5185\u5BB9\u4E4B\u4E0B\uFF08\u663E\u5F0F\u77E2\u91CF\u74E6\u7247\uFF0C\u7981\u6B62\u7528 CSS \u5E73\u94FA\u80CC\u666F\uFF1A
+       Chromium \u4F1A\u628A\u5B83\u7F16\u8BD1\u6210 PDF \u5E73\u94FA\u56FE\u6848\uFF0C\u51FA\u7EB8\u94FE\u8DEF\u7684 RIP \u4F1A\u5FFD\u7565\u56FE\u6848\u77E9\u9635\u5BFC\u81F4\u6C34\u5370\u653E\u5927/\u9519\u4F4D\uFF09 \u2500\u2500 */
+.watermark-layer {
   position: absolute;
-  top: ${mm(paper.height - mb - footerH)};
+  top: 0;
   left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 0;
+  pointer-events: none;
+  overflow: hidden;
 }
-
-/* \u2500\u2500 \u5185\u5BB9\u533A \u2500\u2500 */
-.content-area {
-  width: ${mm(contentWidth)};
-  position: relative;
-  overflow: visible;
+/* \u5355\u5757\u6C34\u5370\u74E6\u7247\uFF1A\u4F4D\u7F6E/\u5C3A\u5BF8\u7531 core \u7684\u74E6\u7247\u7F51\u683C\u7ED9\u51FA\uFF08mm\uFF09 */
+.watermark-tile {
+  position: absolute;
+  pointer-events: none;
 }
-
-/* \u2500\u2500 \u9996\u9875\u53E0\u52A0\u533A\u57DF \u2500\u2500 */
-.first-page-overlay {
-  width: ${mm(contentWidth)};
-  height: ${mm(overlayH)};
-  position: relative;
+`;
 }
-
+function elementBlock() {
+  return `
 /* \u2500\u2500 \u5143\u7D20\u901A\u7528\u5B9A\u4F4D \u2500\u2500 */
 .print-element {
   position: absolute;
@@ -1051,46 +1901,380 @@ body { font-family: "Microsoft YaHei", "PingFang SC", "Helvetica Neue", Arial, s
   height: auto;
   overflow: visible;
 }
-`.trim();
+`;
 }
-function elementPositionStyle(left, top, width, height, zIndex) {
-  const parts = [
-    `position:absolute`,
-    `left:${mm(left)}`,
-    `top:${mm(top)}`,
-    `width:${mm(width)}`
-  ];
-  if (height !== void 0 && height > 0) {
-    parts.push(`height:${mm(height)}`);
-  }
-  if (zIndex !== void 0) {
-    parts.push(`z-index:${zIndex}`);
-  }
-  return parts.join(";") + ";";
-}
-
-// src/render/pagination-engine.ts
-function paginationOf(el) {
-  return el.options?.pagination ?? el.pagination;
+function pageRuleBlock(paper) {
+  return `
+/* \u2500\u2500 \u6253\u5370\u7EB8\u5F20\uFF1A\u6D4F\u89C8\u5668\u539F\u751F\u6253\u5370\u6309\u6B64\u5C3A\u5BF8\u5206\u9875\uFF08Playwright page.pdf \u4EE5\u663E\u5F0F\u5BBD\u9AD8\u4E3A\u51C6\uFF0C\u65E0\u526F\u4F5C\u7528\uFF09 \u2500\u2500 */
+@page { size: ${mm(paper.width)} ${mm(paper.height)}; margin: 0; }
+`;
 }
-function tablePaginationOf(el) {
-  return el.options?.tablePagination ?? el.tablePagination;
+function buildRotorCss(area, margins, angle) {
+  const base = `
+/* \u2500\u2500 \u51FA\u7EB8\u8F6C\u5B50\uFF1A\u8BBE\u8BA1\u7A3F\u6574\u9875\u65CB\u8F6C ${angle}\xB0 \u586B\u5165\u51FA\u7EB8\u7EB8\u5F20 \u2500\u2500 */
+.print-page-rotor {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: ${mm(area.width)};
+  height: ${mm(area.height)};
+  padding: ${mm(margins.top)} ${mm(margins.right)} ${mm(margins.bottom)} ${mm(margins.left)};
+  box-sizing: border-box;
+  transform-origin: 0 0;
+}`;
+  if (angle === 0) return base.trim();
+  const transforms = {
+    90: `translate(${mm(area.height)}, 0mm) rotate(90deg)`,
+    180: `translate(${mm(area.width)}, ${mm(area.height)}) rotate(180deg)`,
+    270: `translate(0mm, ${mm(area.width)}) rotate(270deg)`
+  };
+  const tf = transforms[angle];
+  return [
+    base.trim(),
+    `.print-page-rotor-${angle} {
+  transform: ${tf};
+}`
+  ].join("\n");
+}
+function pageGeometryBlock(template, outerPaper, pageSel, rotated) {
+  const { top: mt, right: mr, bottom: mb, left: ml } = template.margins;
+  const padding = rotated ? "0" : `${mm(mt)} ${mm(mr)} ${mm(mb)} ${mm(ml)}`;
+  return `
+/* \u2500\u2500 \u7EB8\u5F20\u9875\u9762 \u2500\u2500 */
+${pageSel} {
+  width: ${mm(outerPaper.width)};
+  min-height: ${mm(outerPaper.height)};
+  background: ${template.pageBackground ?? "#fff"};
+  padding: ${padding};
+  position: relative;
+  page-break-after: always;
+  overflow: hidden;
 }
-var SAFETY_MARGIN = 2;
-function isTableEl(el) {
-  return el.type === "table" || el.printElementType?.type === "table";
+.print-page:last-child {
+  page-break-after: auto;
 }
-function tableDesignBottom(el) {
-  const opts = el.options ?? {};
-  const top = opts.top ?? 0;
-  const rows = opts.tableRows ?? [];
-  if (rows.length > 0) {
-    return top + rows.reduce((s, r) => s + (r.height ?? 0), 0);
-  }
-  return top + (opts.height ?? 0);
+`;
 }
-function buildFollowMap(sorted) {
-  const map = /* @__PURE__ */ new Map();
+function areaGeometryBlock(template, paper, desc) {
+  const { right: mr, left: ml } = template.margins;
+  const { bottom: mb } = template.margins;
+  const headerH = template.header?.height ?? 0;
+  const footerH = template.footer?.height ?? 0;
+  const overlayH = template.firstPageOverlay?.height ?? 0;
+  const contentWidth = paper.width - ml - mr;
+  return `
+/* \u2500\u2500 \u9875\u7709 \u2500\u2500 */
+${desc}.page-header {
+  width: ${mm(contentWidth)};
+  height: ${mm(headerH)};
+  position: relative;
+}
+
+/* \u2500\u2500 \u9875\u811A\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D\u56FA\u5B9A\u5728\u9875\u9762\u5E95\u90E8\uFF08\u5185\u5BB9\u4E0D\u8DB3\u65F6\u4E0D\u968F\u6587\u6863\u6D41\u4E0A\u6D6E\uFF09 \u2500\u2500
+   \u7528\u663E\u5F0F top \u5B9A\u4F4D\u5230\u300C\u7EB8\u9AD8 - \u4E0B\u8FB9\u8DDD - \u9875\u811A\u9AD8\u300D\uFF0C\u4FDD\u8BC1\u4E0B\u8FB9\u8DDD\u751F\u6548\u3001
+   \u4E0E\u8BBE\u8BA1\u5668 CanvasPaper \u7684\u4E09\u533A\u51E0\u4F55\u4E00\u81F4\u3002 */
+${desc}.page-footer {
+  width: ${mm(contentWidth)};
+  height: ${mm(footerH)};
+  position: absolute;
+  top: ${mm(paper.height - mb - footerH)};
+  left: 0;
+}
+
+/* \u2500\u2500 \u5185\u5BB9\u533A \u2500\u2500 */
+${desc}.content-area {
+  width: ${mm(contentWidth)};
+  position: relative;
+  overflow: visible;
+}
+
+/* \u2500\u2500 \u9996\u9875\u53E0\u52A0\u533A\u57DF \u2500\u2500 */
+${desc}.first-page-overlay {
+  width: ${mm(contentWidth)};
+  height: ${mm(overlayH)};
+  position: relative;
+}
+`;
+}
+function buildBasePageCss() {
+  return [screenBlock(), watermarkBlock(), elementBlock()].join("").trim();
+}
+function buildPageRuleCss(template, pageHeightMm) {
+  return pageRuleBlock(resolveOuterPaper(template, pageHeightMm)).trim();
+}
+function buildPageGeometryCss(template, scope, pageHeightMm) {
+  const angle = getOutputRotationAngle(template);
+  const rotated = angle !== 0;
+  const outer = resolveOuterPaper(template, pageHeightMm);
+  const area = resolveAreaPaper(template, pageHeightMm);
+  const pageSel = scope ? `${scope}.print-page` : ".print-page";
+  const desc = scope ? `${scope} ` : "";
+  return [
+    pageGeometryBlock(template, outer, pageSel, rotated),
+    areaGeometryBlock(template, area, desc),
+    ...rotated ? [buildRotorCss(area, template.margins, angle)] : []
+  ].join("").trim();
+}
+function buildPageCss(template, pageHeightMm) {
+  const angle = getOutputRotationAngle(template);
+  const rotated = angle !== 0;
+  const outer = resolveOuterPaper(template, pageHeightMm);
+  const area = resolveAreaPaper(template, pageHeightMm);
+  return [
+    pageRuleBlock(outer),
+    screenBlock(),
+    pageGeometryBlock(template, outer, ".print-page", rotated),
+    watermarkBlock(),
+    areaGeometryBlock(template, area, ""),
+    elementBlock(),
+    ...rotated ? [buildRotorCss(area, template.margins, angle)] : []
+  ].join("").trim();
+}
+var COPY_BREAK_CSS = ".print-copy:not(:last-child){break-after:page;page-break-after:always;}";
+function buildBatchPageCss(template, copies) {
+  if (!isContinuousPaper(template)) {
+    return `${buildPageCss(template)}
+${COPY_BREAK_CSS}`;
+  }
+  const { bottom: mb } = template.margins;
+  const footerH = template.footer?.height ?? 0;
+  const width = getPaperDimensions(template).width;
+  const base = buildPageCss(template, copies[0]?.heightMm);
+  const scoped = copies.map((copy, i) => {
+    const h = copy.heightMm;
+    const rules = [
+      `@page copy${i} { size: ${mm(width)} ${h ? mm(h) : "auto"}; margin: 0; }`,
+      `.print-copy-${i} { page: copy${i}; }`
+    ];
+    if (h) {
+      rules.push(`.print-copy-${i} .print-page { min-height: ${mm(h)}; }`);
+      rules.push(`.print-copy-${i} .page-footer { top: ${mm(h - mb - footerH)}; }`);
+    }
+    return rules.join("\n");
+  }).join("\n");
+  return `${base}
+${scoped}
+${COPY_BREAK_CSS}`;
+}
+function buildSheetPageCss(layout) {
+  return `
+/* \u2500\u2500 \u62FC\u7248\u7EB8\u5F20\uFF1A@page \u5C3A\u5BF8 = \u76EE\u6807\u7EB8\u3002\u670D\u52A1\u7AEF/\u5BA2\u6237\u7AEF\u94FE\u8DEF\u4EE5 paperMm \u663E\u5F0F\u5B9A\u5C3A\u5BF8\u3001\u4E0D\u770B\u8FD9\u91CC\uFF0C
+      \u4F46\u6D4F\u89C8\u5668\u94FE\u8DEF\u53EA\u770B @page\uFF0C\u6545\u8FD9\u6761\u662F\u786C\u9700\u6C42 \u2500\u2500 */
+@page { size: ${mm(layout.sheet.width)} ${mm(layout.sheet.height)}; margin: 0; }
+
+/* \u2500\u2500 \u4E00\u5F20\u76EE\u6807\u7EB8 \u2500\u2500 */
+.print-sheet {
+  width: ${mm(layout.sheet.width)};
+  height: ${mm(layout.sheet.height)};
+  position: relative;
+  overflow: hidden;
+  break-after: page;
+  page-break-after: always;
+}
+.print-sheet:last-child { break-after: auto; page-break-after: auto; }
+
+/* \u2500\u2500 \u4E00\u683C\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D\uFF0C\u4F4D\u7F6E\u7531 tilePosition() \u4EE5\u884C\u5185 style \u7ED9\u51FA \u2500\u2500 */
+.print-tile {
+  position: absolute;
+  width: ${mm(layout.tile.width)};
+  height: ${mm(layout.tile.height)};
+  overflow: hidden;
+}
+/* \u9632\u5FA1\u6027\u58F0\u660E\uFF1A\u7EDD\u5BF9\u5B9A\u4F4D + overflow:hidden \u5BB9\u5668\u5185\u7684\u540E\u4EE3\u4E0D\u4EA7\u751F\u5206\u9875\u70B9\uFF0C\u5F53\u524D\u5E03\u5C40\u4E0B\u65E0\u5B9E\u9645\u4F5C\u7528\uFF1B
+   \u82E5\u5C06\u6765\u6539\u7528 flex/grid \u5E03\u5C40\uFF0C\u683C\u5185\u6574\u9875\u4F1A\u91CD\u65B0\u53C2\u4E0E\u5206\u9875\uFF0C\u6545\u4FDD\u7559 */
+.print-tile > .print-page { break-after: auto; page-break-after: auto; }
+
+@media screen {
+  .print-sheet { margin: 12px auto; box-shadow: 0 2px 12px rgba(0, 0, 0, 0.18); }
+  /* \u5FC5\u9700\uFF1A\u62B5\u6D88\u6807\u7B7E CSS \u7684 @media screen{.print-page{margin:12px auto}}\uFF0C
+     \u5426\u5219\u8BBE\u8BA1\u5668\u9884\u89C8\u9519\u4F4D 3.17mm\u3001\u4E0E\u51FA\u7EB8\u4E0D\u4E00\u81F4 */
+  .print-tile > .print-page { margin: 0; box-shadow: none; }
+}
+`;
+}
+function elementPositionStyle(left, top, width, height, zIndex) {
+  const parts = [
+    `position:absolute`,
+    `left:${mm(left)}`,
+    `top:${mm(top)}`,
+    `width:${mm(width)}`
+  ];
+  if (height !== void 0 && height > 0) {
+    parts.push(`height:${mm(height)}`);
+  }
+  if (zIndex !== void 0) {
+    parts.push(`z-index:${zIndex}`);
+  }
+  return parts.join(";") + ";";
+}
+
+// src/render/watermark.ts
+var PX_PER_MM = 96 / 25.4;
+var MM_PER_PX = 25.4 / 96;
+var WATERMARK_DEFAULTS = {
+  color: "#cccccc",
+  opacity: 0.15,
+  rotate: -30,
+  /** 瓦片默认尺寸（px）：决定平铺疏密，默认 260×180 */
+  tileWidth: 260,
+  tileHeight: 180,
+  /** 瓦片下限（px），防止文字裁剪/异常平铺 */
+  minTileWidth: 140,
+  minTileHeight: 100,
+  /** 瓦片字号固定 16px：密度只改变平铺疏密，不改字体大小 */
+  fontSize: 16
+};
+function clampTile(value, fallback, min2) {
+  const n = typeof value === "number" && Number.isFinite(value) ? value : fallback;
+  return Math.max(min2, Math.round(n));
+}
+function resolveTileSize(wm) {
+  return {
+    width: clampTile(wm?.tileWidth, WATERMARK_DEFAULTS.tileWidth, WATERMARK_DEFAULTS.minTileWidth),
+    height: clampTile(wm?.tileHeight, WATERMARK_DEFAULTS.tileHeight, WATERMARK_DEFAULTS.minTileHeight)
+  };
+}
+function isWatermarkVisible(wm) {
+  if (!wm) return false;
+  if (!wm.mode || wm.mode === "fixed") {
+    return !!wm.content && wm.content.trim().length > 0;
+  }
+  return !!wm.binding && wm.binding.trim().length > 0;
+}
+function resolveWatermarkText(wm, printData, systemVars2) {
+  if (!wm) return "";
+  let text = "";
+  if (!wm.mode || wm.mode === "fixed") {
+    text = wm.content ?? "";
+  } else if (typeof wm.binding === "string" && wm.binding.trim()) {
+    const binding = wm.binding.trim();
+    const data = Array.isArray(printData) ? printData[0] ?? {} : printData ?? {};
+    const ctx = { ...resolveSystemVariables(), ...systemVars2, ...data };
+    let resolved;
+    if (binding.includes("{")) {
+      resolved = evaluateTemplate(binding, ctx);
+    } else {
+      try {
+        resolved = safeEval(binding, ctx);
+      } catch {
+        resolved = void 0;
+      }
+      if (resolved == null || typeof resolved === "object") {
+        resolved = getByPath(data, binding);
+      }
+    }
+    if (resolved != null && typeof resolved !== "object" && String(resolved) !== binding) {
+      text = String(resolved);
+    } else {
+      text = wm.testData ?? `[${wm.binding}]`;
+    }
+  }
+  if (wm.timestamp && text) {
+    text = `${text} ${formatTimestamp(wm.format)}`;
+  }
+  return text;
+}
+function pad(n) {
+  return String(n).padStart(2, "0");
+}
+function formatTimestamp(format) {
+  const fmt = format && format.trim() ? format : "YYYY-MM-DD HH:mm";
+  const d = /* @__PURE__ */ new Date();
+  const map = {
+    YYYY: String(d.getFullYear()),
+    MM: pad(d.getMonth() + 1),
+    DD: pad(d.getDate()),
+    HH: pad(d.getHours()),
+    mm: pad(d.getMinutes()),
+    ss: pad(d.getSeconds())
+  };
+  return fmt.replace(/YYYY|MM|DD|HH|mm|ss/g, (k) => map[k] ?? k);
+}
+function round4(n) {
+  return Math.round(n * 1e4) / 1e4;
+}
+function escXml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function resolveWatermarkLayout(wm, printData, paperMm, systemVars2) {
+  if (!isWatermarkVisible(wm)) return null;
+  const text = resolveWatermarkText(wm, printData, systemVars2);
+  if (!text) return null;
+  const tile = resolveTileSize(wm);
+  const tileWidthMm = round4(tile.width * MM_PER_PX);
+  const tileHeightMm = round4(tile.height * MM_PER_PX);
+  const paper = {
+    width: Math.max(0, Number.isFinite(paperMm?.width) ? paperMm.width : 0),
+    height: Math.max(0, Number.isFinite(paperMm?.height) ? paperMm.height : 0)
+  };
+  const columns = Math.max(1, Math.ceil(paper.width / tileWidthMm));
+  const rows = Math.max(1, Math.ceil(paper.height / tileHeightMm));
+  const tiles = [];
+  for (let r = 0; r < rows; r++) {
+    for (let c = 0; c < columns; c++) {
+      tiles.push({
+        leftMm: round4(c * tileWidthMm),
+        topMm: round4(r * tileHeightMm),
+        widthMm: tileWidthMm,
+        heightMm: tileHeightMm
+      });
+    }
+  }
+  return {
+    text,
+    color: wm?.color || WATERMARK_DEFAULTS.color,
+    rotate: wm?.rotate ?? WATERMARK_DEFAULTS.rotate,
+    opacity: wm?.opacity ?? WATERMARK_DEFAULTS.opacity,
+    fontSizePx: WATERMARK_DEFAULTS.fontSize,
+    tileWidthPx: tile.width,
+    tileHeightPx: tile.height,
+    tileWidthMm,
+    tileHeightMm,
+    columns,
+    rows,
+    tiles
+  };
+}
+function renderWatermarkTileSvg(layout, tile) {
+  const tileWidthPx = layout.tileWidthPx;
+  const tileHeightPx = layout.tileHeightPx;
+  const cx = tileWidthPx / 2;
+  const cy = tileHeightPx / 2;
+  const style = `left:${tile.leftMm}mm;top:${tile.topMm}mm;width:${tile.widthMm}mm;height:${tile.heightMm}mm`;
+  return `<svg class="watermark-tile" style="${style}" viewBox="0 0 ${tileWidthPx} ${tileHeightPx}" xmlns="http://www.w3.org/2000/svg"><text x="${cx}" y="${cy}" font-size="${layout.fontSizePx}" fill="${layout.color}" text-anchor="middle" dominant-baseline="middle" transform="rotate(${layout.rotate},${cx},${cy})">${escXml(layout.text)}</text></svg>`;
+}
+function renderWatermarkLayerHtml(wm, printData, paperMm, systemVars2) {
+  const layout = resolveWatermarkLayout(wm, printData, paperMm, systemVars2);
+  if (!layout) return "";
+  const tiles = layout.tiles.map((t) => renderWatermarkTileSvg(layout, t)).join("\n");
+  return `
+<div class="watermark-layer" style="opacity:${layout.opacity}">
+${tiles}
+</div>`;
+}
+
+// src/render/pagination-engine.ts
+function paginationOf(el) {
+  return el.options?.pagination ?? el.pagination;
+}
+function tablePaginationOf(el) {
+  return el.options?.tablePagination ?? el.tablePagination;
+}
+var SAFETY_MARGIN = 2;
+function isTableEl(el) {
+  return el.type === "table" || el.printElementType?.type === "table";
+}
+function tableDesignBottom(el) {
+  const opts = el.options ?? {};
+  const top = opts.top ?? 0;
+  const rows = opts.tableRows ?? [];
+  if (rows.length > 0) {
+    return top + rows.reduce((s, r) => s + (r.height ?? 0), 0);
+  }
+  return top + (opts.height ?? 0);
+}
+function buildFollowMap(sorted, excludedIds) {
+  const map = /* @__PURE__ */ new Map();
   let currentTableId = null;
   let currentTableBottom = -1;
   for (const el of sorted) {
@@ -1100,6 +2284,7 @@ function buildFollowMap(sorted) {
       map.set(el.id, []);
       continue;
     }
+    if (excludedIds?.has(el.id)) continue;
     const top = el.options?.top ?? 0;
     if (currentTableId && top >= currentTableBottom) {
       map.get(currentTableId).push(el.id);
@@ -1117,28 +2302,110 @@ function followGroupHeight(el, members, template, _measuredElements) {
   }
   return Math.max(maxBottom - tableBottom, 0);
 }
+function effectiveHeight(el, measured) {
+  return Math.max(el.options?.height ?? 0, measured.get(el.id)?.measuredHeight ?? 0);
+}
+function buildPaginationUnits(sorted, measured, groupMap) {
+  const unitOf = /* @__PURE__ */ new Map();
+  for (const members of groupMap.values()) {
+    if (members.length < 2) continue;
+    const unit = {
+      anchorId: members[0].id,
+      ids: members.map((m) => m.id),
+      forceFirstPage: members.some((m) => paginationOf(m)?.pageable === false)
+    };
+    for (const m of members) unitOf.set(m.id, unit);
+  }
+  const eligible = sorted.filter(
+    (el) => !isTableEl(el) && !el.options?.groupId && paginationOf(el)?.pageable !== false
+  );
+  const parent = /* @__PURE__ */ new Map();
+  eligible.forEach((el) => parent.set(el.id, el.id));
+  const find = (id) => {
+    let root = id;
+    while (parent.get(root) !== root) root = parent.get(root);
+    let cur = id;
+    while (parent.get(cur) !== root) {
+      const next = parent.get(cur);
+      parent.set(cur, root);
+      cur = next;
+    }
+    return root;
+  };
+  const union = (a, b) => {
+    const ra = find(a);
+    const rb = find(b);
+    if (ra !== rb) parent.set(rb, ra);
+  };
+  const active = [];
+  for (const el of eligible) {
+    const top = el.options?.top ?? 0;
+    for (let i = active.length - 1; i >= 0; i--) {
+      if (active[i].bottom <= top) active.splice(i, 1);
+    }
+    const bottom = top + effectiveHeight(el, measured);
+    for (const a of active) {
+      if (a.bottom > top) union(el.id, a.id);
+    }
+    active.push({ id: el.id, top, bottom });
+  }
+  const clusters = /* @__PURE__ */ new Map();
+  for (const el of eligible) {
+    const root = find(el.id);
+    const arr = clusters.get(root);
+    if (arr) arr.push(el.id);
+    else clusters.set(root, [el.id]);
+  }
+  for (const ids of clusters.values()) {
+    if (ids.length < 2) continue;
+    const unit = { anchorId: ids[0], ids, forceFirstPage: false };
+    for (const id of ids) unitOf.set(id, unit);
+  }
+  return unitOf;
+}
 function paginate(template, measuredElements) {
   const paper = getPaperDimensions(template);
   const { top: mt, bottom: mb } = template.margins;
   const headerH = template.header?.height ?? 0;
   const footerH = template.footer?.height ?? 0;
   const overlayH = template.firstPageOverlay?.height ?? 0;
-  const contentHeight = paper.height - mt - mb - headerH - footerH;
-  if (contentHeight <= 0) {
+  const continuous = isContinuousPaper(template);
+  const contentHeight = continuous ? Number.POSITIVE_INFINITY : paper.height - mt - mb - headerH - footerH;
+  if (!continuous && contentHeight <= 0) {
     throw new Error(
       `\u9875\u9762\u53EF\u7528\u9AD8\u5EA6\u4E0D\u8DB3: paper=${paper.height}mm, margins=${mt + mb}mm, header=${headerH}mm, footer=${footerH}mm`
     );
   }
+  const orderIndex = /* @__PURE__ */ new Map();
+  template.elements.forEach((e, idx) => orderIndex.set(e.id, idx));
   const sorted = [...template.elements].sort((a, b) => {
     const topA = a.options?.top ?? 0;
     const topB = b.options?.top ?? 0;
-    return topA - topB;
+    if (topA !== topB) return topA - topB;
+    const zA = a.options?.zIndex ?? 0;
+    const zB = b.options?.zIndex ?? 0;
+    if (zA !== zB) return zA - zB;
+    return (orderIndex.get(a.id) ?? 0) - (orderIndex.get(b.id) ?? 0);
   });
-  const followMap = buildFollowMap(sorted);
+  const explicitGroupIds = /* @__PURE__ */ new Set();
+  const groupMap = /* @__PURE__ */ new Map();
+  for (const el of sorted) {
+    if (isTableEl(el)) continue;
+    const gid = el.options?.groupId;
+    if (!gid) continue;
+    explicitGroupIds.add(el.id);
+    const arr = groupMap.get(gid);
+    if (arr) arr.push(el);
+    else groupMap.set(gid, [el]);
+  }
+  const followMap = buildFollowMap(sorted, explicitGroupIds);
   const followOwner = /* @__PURE__ */ new Map();
   for (const [tableId, members] of followMap) {
     for (const m of members) followOwner.set(m, tableId);
   }
+  const elById = /* @__PURE__ */ new Map();
+  for (const el of sorted) elById.set(el.id, el);
+  const unitOf = buildPaginationUnits(sorted, measuredElements, groupMap);
   const pages = [];
   let currentPage = [];
   let remaining = contentHeight - overlayH - SAFETY_MARGIN;
@@ -1150,12 +2417,26 @@ function paginate(template, measuredElements) {
   function fullPageHeight() {
     return isFirstPage ? contentHeight - overlayH - SAFETY_MARGIN : contentHeight - SAFETY_MARGIN;
   }
-  function finishPage() {
-    pages.push({ pageIndex: pages.length, sections: [...currentPage] });
+  let overflowOnCurrent = false;
+  function pushPage() {
+    pages.push(
+      overflowOnCurrent ? { pageIndex: pages.length, sections: [...currentPage], overflow: true } : { pageIndex: pages.length, sections: [...currentPage] }
+    );
+  }
+  function noteOverflow(bottom) {
+    if (bottom > contentHeight) overflowOnCurrent = true;
+  }
+  function finishPage(overflow = false) {
+    if (currentPage.length === 0) {
+      overflowOnCurrent = overflowOnCurrent || overflow;
+      return;
+    }
+    pushPage();
     currentPage = [];
     remaining = contentHeight - SAFETY_MARGIN;
     isFirstPage = false;
     pageBroken = true;
+    overflowOnCurrent = false;
   }
   let i = 0;
   while (i < sorted.length) {
@@ -1164,19 +2445,32 @@ function paginate(template, measuredElements) {
       i++;
       continue;
     }
-    if (paginationOf(el)?.pageable === false) {
-      currentPage.push({ elementId: el.id, type: "element", renderTop: sectionTop(el) });
+    const unit = unitOf.get(el.id);
+    if (unit && unit.anchorId !== el.id) {
+      i++;
+      continue;
+    }
+    if (paginationOf(el)?.pageable === false || unit?.forceFirstPage) {
+      if (unit) {
+        for (const id of unit.ids) {
+          currentPage.push({ elementId: id, type: "element", renderTop: elById.get(id)?.options?.top ?? 0 });
+        }
+      } else {
+        currentPage.push({ elementId: el.id, type: "element", renderTop: sectionTop(el) });
+      }
       i++;
       continue;
     }
     if (isTableEl(el)) {
       i = paginateTable(el, measuredElements, i);
+    } else if (unit) {
+      i = paginateUnit(unit, i);
     } else {
       i = paginateNonTable(el, measuredElements, sorted, i);
     }
   }
   if (currentPage.length > 0) {
-    pages.push({ pageIndex: pages.length, sections: [...currentPage] });
+    pushPage();
   }
   if (pages.length === 0) {
     pages.push({ pageIndex: 0, sections: [] });
@@ -1185,6 +2479,8 @@ function paginate(template, measuredElements) {
   function paginateNonTable(el, measured, sortedList, idx) {
     const elHeight = measured.get(el.id)?.measuredHeight ?? el.options?.height ?? 0;
     if (elHeight <= remaining) {
+      const top2 = pageBroken ? 0 : el.options?.top ?? 0;
+      noteOverflow(top2 + elHeight);
       currentPage.push({ elementId: el.id, type: "element", renderTop: sectionTop(el) });
       remaining -= elHeight;
       if (paginationOf(el)?.keepWithNext && idx + 1 < sortedList.length) {
@@ -1202,11 +2498,43 @@ function paginate(template, measuredElements) {
       }
       return idx + 1;
     }
-    finishPage();
+    const top = pageBroken ? 0 : el.options?.top ?? 0;
+    finishPage(top + elHeight > contentHeight);
     currentPage.push({ elementId: el.id, type: "element", renderTop: sectionTop(el) });
     remaining -= elHeight;
     return idx + 1;
   }
+  function paginateUnit(unit, idx) {
+    const members = unit.ids.map((id) => elById.get(id)).filter((m) => !!m);
+    let minTop = Number.POSITIVE_INFINITY;
+    let maxBottom = Number.NEGATIVE_INFINITY;
+    for (const m of members) {
+      const top2 = m.options?.top ?? 0;
+      minTop = Math.min(minTop, top2);
+      maxBottom = Math.max(maxBottom, top2 + effectiveHeight(m, measuredElements));
+    }
+    const unitHeight = Math.max(maxBottom - minTop, 0);
+    const place = () => {
+      const offset = pageBroken ? -minTop : 0;
+      noteOverflow(minTop + offset + unitHeight);
+      for (const m of members) {
+        currentPage.push({
+          elementId: m.id,
+          type: "element",
+          renderTop: (m.options?.top ?? 0) + offset
+        });
+      }
+      remaining -= unitHeight;
+    };
+    if (unitHeight <= remaining) {
+      place();
+      return idx + 1;
+    }
+    const top = pageBroken ? 0 : minTop;
+    finishPage(top + unitHeight > contentHeight);
+    place();
+    return idx + 1;
+  }
   function paginateTable(el, measured, idx) {
     const opts = el.options ?? {};
     const renderRows = opts._renderRows ?? [];
@@ -1373,17 +2701,27 @@ function specialRowHeight(renderRows, rowHeights, type) {
 }
 
 // src/render/html-generator.ts
+function pageVarsContext(vars) {
+  return { ...vars.data ?? {}, pageIndex: vars.pageIndex, totalPages: vars.totalPages };
+}
+function pageVarsData(printData) {
+  if (Array.isArray(printData)) return printData[0] ?? {};
+  return printData ?? {};
+}
 function generateHtml(template, pageLayouts, printData, options) {
-  const css = buildPageCss(template);
+  const css = buildFontFaceCss(template.fonts) + buildPageCss(template, options?.pageHeightMm);
   const isMeasure = options?.isMeasurementPass === true;
   const totalPages = isMeasure ? 1 : pageLayouts.length;
-  const ctx = { codeRenderer: options?.codeRenderer };
+  const ctx = {
+    codeRenderer: options?.codeRenderer,
+    pageHeightMm: options?.pageHeightMm
+  };
   if (isMeasure) {
-    return generateMeasurementHtml(template, css, ctx);
+    return generateMeasurementHtml(template, css, ctx, printData);
   }
-  return generateFinalHtml(template, pageLayouts, css, totalPages, ctx);
+  return generateFinalHtml(template, pageLayouts, css, totalPages, ctx, printData);
 }
-function generateMeasurementHtml(template, css, ctx) {
+function generateMeasurementHtml(template, css, ctx, printData) {
   const paper = getPaperDims(template);
   const contentWidth = paper.width - template.margins.left - template.margins.right;
   const elementsHtml = template.elements.map((el) => renderElement(el, true, void 0, void 0, ctx)).join("\n");
@@ -1405,6 +2743,7 @@ function generateMeasurementHtml(template, css, ctx) {
 </head>
 <body class="measure-mode">
 <section class="print-page" data-measure-page="0">
+  ${renderWatermarkLayerHtml(template.watermark, printData, getPaperDims(template))}
   <div class="page-header">${headerHtml}</div>
   <div class="first-page-overlay">${overlayHtml}</div>
   <div class="content-area" style="height:auto;overflow:visible;">
@@ -1416,54 +2755,111 @@ function generateMeasurementHtml(template, css, ctx) {
   html = injectSystemVariables(html);
   return html;
 }
-function generateFinalHtml(template, pageLayouts, css, totalPages, ctx) {
+function renderFinalPages(template, pageLayouts, printData, ctx, options) {
+  const pageOffset = options?.pageOffset ?? 0;
+  const totalPages = options?.totalPages ?? pageLayouts.length;
   const pagesHtml = pageLayouts.map((page) => {
-    const pageNum = page.pageIndex + 1;
-    return renderPage(template, page, pageNum, totalPages, ctx);
+    const pageNum = page.pageIndex + 1 + pageOffset;
+    return renderPage(template, page, pageNum, totalPages, ctx, printData, options?.pageClass);
   }).join("\n");
-  let html = `<!DOCTYPE html>
+  return injectSystemVariables(pagesHtml);
+}
+function wrapHtmlDocument(css, bodyInnerHtml, bodyClass) {
+  const html = `<!DOCTYPE html>
 <html lang="zh-CN">
 <head>
 <meta charset="UTF-8">
 <style>${css}</style>
 </head>
-<body>
-${pagesHtml}
+<body${bodyClass ? ` class="${bodyClass}"` : ""}>
+${bodyInnerHtml}
 </body>
 </html>`;
-  html = injectSystemVariables(html);
-  return html;
+  return injectSystemVariables(html);
+}
+function generateFinalHtml(template, pageLayouts, css, _totalPages, ctx, printData) {
+  const bodyInner = renderFinalPages(template, pageLayouts, printData ?? {}, ctx);
+  return wrapHtmlDocument(
+    css,
+    bodyInner,
+    isContinuousPaper(template) ? "continuous" : void 0
+  );
 }
-function renderPage(template, page, pageNum, totalPages, ctx) {
+function renderPage(template, page, pageNum, totalPages, ctx, printData, pageClass) {
   const paper = getPaperDims(template);
+  const paperMm = {
+    width: paper.width,
+    height: ctx.pageHeightMm && ctx.pageHeightMm > 0 ? ctx.pageHeightMm : paper.height
+  };
   const contentWidth = paper.width - template.margins.left - template.margins.right;
+  const pageVars = { pageIndex: pageNum, totalPages, data: pageVarsData(printData) };
+  const scoped = withPageNumbers(template, pageVars);
+  const pageCtx = { ...ctx, pageVars };
   const headerHtml = renderAreaElements(
-    template.header?.elements ?? [],
+    scoped.header?.elements ?? [],
     contentWidth,
     pageNum,
     totalPages,
-    ctx
+    pageCtx
   );
   const footerHtml = renderAreaElements(
-    template.footer?.elements ?? [],
+    scoped.footer?.elements ?? [],
     contentWidth,
     pageNum,
     totalPages,
-    ctx
+    pageCtx
   );
-  const overlayHtml = page.pageIndex === 0 ? `<div class="first-page-overlay">${renderAreaElements(template.firstPageOverlay?.elements ?? [], contentWidth, void 0, void 0, ctx)}</div>` : "";
-  let contentHtml = page.sections.map((section) => renderSection(section, template, ctx)).join("\n");
+  const overlayHtml = page.pageIndex === 0 ? `<div class="first-page-overlay">${renderAreaElements(scoped.firstPageOverlay?.elements ?? [], contentWidth, pageNum, totalPages, pageCtx)}</div>` : "";
+  let contentHtml = page.sections.map((section) => renderSection(section, scoped, pageCtx)).join("\n");
   contentHtml = contentHtml.replace(/\{pageIndex\}/g, String(pageNum));
   contentHtml = contentHtml.replace(/\{totalPages\}/g, String(totalPages));
-  return `<section class="print-page" data-page="${pageNum}">
+  const pageInner = `
+  ${renderWatermarkLayerHtml(template.watermark, printData, paperMm, { pageIndex: pageNum, totalPages })}
   <div class="page-header">${headerHtml}</div>
   ${overlayHtml}
   <div class="content-area">
     ${contentHtml}
   </div>
-  <div class="page-footer">${footerHtml}</div>
+  <div class="page-footer">${footerHtml}</div>`;
+  const rot = getOutputRotationAngle(template);
+  const pageBody = rot !== 0 ? `<div class="print-page-rotor print-page-rotor-${rot}">${pageInner}</div>` : pageInner;
+  return `<section class="print-page${pageClass ? ` ${pageClass}` : ""}" data-page="${pageNum}">
+  ${pageBody}
 </section>`;
 }
+function withPageNumbers(template, vars) {
+  if (!templateReferencesPageNumbers(template)) return template;
+  const context = pageVarsContext(vars);
+  const mapEl = (el) => {
+    const raw = el.options?.rawFormatter;
+    if (typeof raw !== "string") return el;
+    return { ...el, options: { ...el.options, formatter: evaluateTemplate(raw, context) } };
+  };
+  const mapArea = (area) => area ? { ...area, elements: (area.elements ?? []).map(mapEl) } : area;
+  return {
+    ...template,
+    elements: template.elements.map(mapEl),
+    header: mapArea(template.header),
+    footer: mapArea(template.footer),
+    firstPageOverlay: mapArea(template.firstPageOverlay)
+  };
+}
+function templateReferencesPageNumbers(template) {
+  const areas = [
+    template.elements,
+    template.header?.elements,
+    template.footer?.elements,
+    template.firstPageOverlay?.elements
+  ];
+  return areas.some((list) => (list ?? []).some((el) => typeof el.options?.rawFormatter === "string"));
+}
+function resolveCellContent(cell, ctx) {
+  const raw = cell.rawFormatter;
+  if (typeof raw === "string" && raw !== "" && ctx?.pageVars) {
+    return evaluateTemplate(raw, pageVarsContext(ctx.pageVars));
+  }
+  return cell.content;
+}
 function renderSection(section, template, ctx) {
   const el = findElement(template, section.elementId);
   if (!el) {
@@ -1481,8 +2877,9 @@ var V_ALIGN_FLEX = { top: "flex-start", middle: "center", bottom: "flex-end" };
 var H_ALIGN_FLEX = { left: "flex-start", center: "center", right: "flex-end" };
 function textStyle(opts) {
   const parts = [];
-  if (opts.fontSize) parts.push(`font-size:${opts.fontSize}pt`);
-  if (opts.fontFamily) parts.push(`font-family:${opts.fontFamily}`);
+  const fontSize = opts._fitFontSize === void 0 ? opts.fontSize : roundFontSize(opts._fitFontSize);
+  if (fontSize) parts.push(`font-size:${fontSize}pt`);
+  if (opts.fontFamily) parts.push(`font-family:${escapeInlineStyleValue(toFontFamilyStack(opts.fontFamily))}`);
   if (opts.fontWeight) parts.push(`font-weight:${opts.fontWeight}`);
   if (opts.color) parts.push(`color:${opts.color}`);
   if (opts.backgroundColor) parts.push(`background-color:${opts.backgroundColor}`);
@@ -1495,15 +2892,28 @@ function textStyle(opts) {
   if (opts.textAlign) parts.push(`text-align:${opts.textAlign}`);
   return parts.length ? parts.join(";") + ";" : "";
 }
+function elementFitStyle(fit, opts) {
+  if (fit === "autoHeight") return "overflow:visible;";
+  if (opts.wordWrap === false) return "white-space:nowrap;text-overflow:ellipsis;";
+  return "";
+}
+function fitAttrs(fit, key, baseFontSizePt, opts) {
+  if (fit !== "shrink") return "";
+  const min2 = resolveShrinkMinFontSize(opts.shrinkMinFontSize);
+  return ` data-fit="shrink" data-fit-key="${esc(key)}" data-fit-base="${baseFontSizePt}" data-fit-min="${min2}"`;
+}
 function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
   const opts = el.options ?? {};
   const left = opts.left ?? 0;
   const top = overrideTop ?? opts.top ?? 0;
   const width = opts.width ?? 100;
   const height = opts.height ?? void 0;
-  const style = containerStyle ?? elementPositionStyle(left, top, width, height, opts.zIndex);
-  const measureAttr = isMeasure ? ` data-measure-id="${el.id}"` : "";
   const type = el.type || el.printElementType?.type || "text";
+  const fit = resolveElementTextFit(type, opts);
+  const fitHeight = fit === "autoHeight" ? void 0 : height;
+  const style = containerStyle ?? elementPositionStyle(left, top, width, fitHeight, opts.zIndex);
+  const measureAttr = isMeasure ? ` data-measure-id="${el.id}"` : "";
+  const fitAttr = fitAttrs(fit, el.id, opts.fontSize ?? 12, opts);
   switch (type) {
     case "table":
       return renderTableElement(el, isMeasure, measureAttr, ctx);
@@ -1514,9 +2924,17 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
     case "barcode":
     case "qrcode": {
       const codeValue = String(opts.formatter ?? opts.testData ?? "").trim();
-      const fill = type === "barcode";
       return `<div class="print-element" style="${style}"${measureAttr}>
-  ${codeImgHtml(codeValue, type, opts, `<span>${esc(codeValue)}</span>`, fill, ctx?.codeRenderer)}
+  ${codeImgHtml(codeValue, type, opts, {
+        fallback: `<span>${esc(codeValue)}</span>`,
+        codeRenderer: ctx?.codeRenderer,
+        fit: opts.fit,
+        maxWidth: opts.maxWidth,
+        maxHeight: opts.maxHeight,
+        printerDpi: opts.printerDpi,
+        targetWidthMm: opts.width,
+        targetHeightMm: opts.height
+      })}
 </div>`;
     }
     case "hline":
@@ -1528,30 +2946,32 @@ function renderElement(el, isMeasure, containerStyle, overrideTop, ctx) {
     case "oval":
       return `<div class="print-element" style="${style};border:${opts.borderWidth ?? 1}px solid ${opts.borderColor ?? "#000"};border-radius:50%;"${measureAttr}></div>`;
     case "longText":
-      return `<div class="print-element" style="${style}${textStyle(opts)}overflow:visible;"${measureAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
+      return `<div class="print-element" style="${style}${textStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
     case "html":
       return `<div class="print-element" style="${style}"${measureAttr}>${opts.testData ?? opts.title ?? ""}</div>`;
     default:
-      return `<div class="print-element" style="${style}${textStyle(opts)}"${measureAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
+      return `<div class="print-element" style="${style}${textStyle(opts)}${elementFitStyle(fit, opts)}"${measureAttr}${fitAttr}>${esc(opts.formatter ?? opts.testData ?? "")}</div>`;
   }
 }
-function codeImgHtml(value, cellType, opts, fallbackHtml, fill = false, codeRenderer, fit, maxWidth, maxHeight) {
-  if (!value || !codeRenderer) return fallbackHtml;
+function codeImgHtml(value, cellType, opts, io) {
+  if (!value || !io.codeRenderer) return io.fallback;
+  const { fallback, codeRenderer, fit, maxWidth, maxHeight } = io;
+  const isBarcode = cellType === "barcode";
   try {
     const svg = codeRenderer.render(value, cellType, {
       barcodeType: opts.barcodeType,
       qrCodeLevel: opts.qrCodeLevel != null ? String(opts.qrCodeLevel) : void 0,
       showText: opts.hideTitle !== void 0 ? !opts.hideTitle : opts.showBarcodeText,
       barWidth: typeof opts.barWidth === "number" ? opts.barWidth : void 0,
-      fontSize: typeof opts.fontSize === "number" ? opts.fontSize : void 0
+      fontSize: typeof opts.fontSize === "number" ? opts.fontSize : void 0,
+      printerDpi: isBarcode ? io.printerDpi : void 0,
+      targetWidthMm: isBarcode ? barcodeAvailableBoxMm(io.targetWidthMm, maxWidth) : void 0,
+      targetHeightMm: isBarcode ? barcodeAvailableBoxMm(io.targetHeightMm, maxHeight) : void 0
     });
+    if (isBarcode && /^<svg[\s>]/i.test(svg)) return inlineCodeSvgHtml(svg);
     const src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
     const styleParts = [];
-    if (fill) {
-      styleParts.push("width:100%", "height:100%", "object-fit:contain", "display:block", "margin:auto");
-    } else {
-      styleParts.push("max-width:100%", "max-height:100%", "display:block", "margin:auto");
-    }
+    styleParts.push("max-width:100%", "max-height:100%", "display:block", "margin:auto");
     if (fit) {
       styleParts.push(`object-fit:${fit}`);
     }
@@ -1564,15 +2984,20 @@ function codeImgHtml(value, cellType, opts, fallbackHtml, fill = false, codeRend
     const style = styleParts.join(";");
     return `<img src="${src}" style="${style}" />`;
   } catch {
-    return fallbackHtml;
+    return fallback;
   }
 }
+function inlineCodeSvgHtml(svg) {
+  const styled = svg.replace(/<svg\b/, '<svg style="display:block"');
+  return `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;">${styled}</div>`;
+}
 function matrixCellStyle(cell, opts) {
   const parts = [];
-  const fontSize = cell.fontSize ?? opts.tableDefaultFontSize;
+  const fontSize = cell.fittedFontSize ?? cell.fontSize ?? opts.tableDefaultFontSize;
   const color = cell.color ?? opts.tableDefaultColor;
   const padding = cell.padding ?? opts.tableDefaultPadding ?? 1;
   if (fontSize) parts.push(`font-size:${fontSize}pt`);
+  if (cell.fontFamily) parts.push(`font-family:${escapeInlineStyleValue(toFontFamilyStack(cell.fontFamily))}`);
   if (cell.fontWeight) parts.push(`font-weight:${cell.fontWeight}`);
   if (color) parts.push(`color:${color}`);
   if (cell.backgroundColor) parts.push(`background-color:${cell.backgroundColor}`);
@@ -1587,25 +3012,38 @@ function matrixCellStyle(cell, opts) {
   }
   return parts.join(";");
 }
-function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx) {
+function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOwner = { elementId: "", kind: "b" }, rowLimit) {
   const trs = [];
+  const defaultPadding = opts.tableDefaultPadding ?? 1;
   for (let r = start; r < end; r++) {
     const row = renderRows[r];
     if (!row) continue;
     const idxAttr = withRowIndex ? ` data-row-index="${r}"` : "";
-    const tds = row.cells.filter((cell) => !cell.merged).map((cell) => {
-      const span = `${cell.rowspan > 1 ? ` rowspan="${cell.rowspan}"` : ""}${cell.colspan > 1 ? ` colspan="${cell.colspan}"` : ""}`;
+    const tds = row.cells.map((cell, ci) => ({ cell, ci })).filter(({ cell }) => !cell.merged).map(({ cell, ci }) => {
+      const rowspan = rowLimit === void 0 ? cell.rowspan ?? 1 : Math.max(1, Math.min(cell.rowspan ?? 1, rowLimit - r));
+      const span = `${rowspan > 1 ? ` rowspan="${rowspan}"` : ""}${cell.colspan > 1 ? ` colspan="${cell.colspan}"` : ""}`;
+      const colIndex = ci;
       let inner;
       if (cell.cellType === "barcode" || cell.cellType === "qrcode") {
-        const cellFill = cell.cellType === "barcode";
-        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;">${codeImgHtml(cell.content, cell.cellType, cell, esc(cell.content), cellFill, ctx?.codeRenderer, cell.fit, cell.maxWidth, cell.maxHeight)}</div>`;
+        const codeValue = resolveCellContent(cell, ctx);
+        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;">${codeImgHtml(codeValue, cell.cellType, cell, {
+          fallback: esc(codeValue),
+          codeRenderer: ctx?.codeRenderer,
+          fit: cell.fit,
+          maxWidth: cell.maxWidth,
+          maxHeight: cell.maxHeight,
+          printerDpi: cell.printerDpi,
+          // 可用框 = 单元格内容区（列宽/行高扣除内边距与塌陷边框）；列宽缺失时宽度为 0 → 不约束宽度
+          targetWidthMm: cellFitWidthMm(opts.tableColWidths ?? [], ci, cell, defaultPadding),
+          targetHeightMm: cellFitCapMm(renderRows, r, cell, defaultPadding)
+        })}</div>`;
       } else if (cell.cellType === "image") {
         const fit = cell.fit || "contain";
         const maxWidth = cell.maxWidth ? `max-width:${cell.maxWidth}mm;` : "max-width:100%;";
         const maxHeight = cell.maxHeight ? `max-height:${cell.maxHeight}mm;` : "max-height:100%;";
-        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(cell.content)}" style="object-fit:${fit};${maxWidth}${maxHeight}display:block;" /></div>`;
+        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;"><img src="${esc(resolveCellContent(cell, ctx))}" style="object-fit:${fit};${maxWidth}${maxHeight}display:block;" /></div>`;
       } else {
-        inner = esc(cell.content);
+        inner = renderTextCellInner(renderRows, r, colIndex, cell, opts, fitOwner, defaultPadding, ctx);
       }
       return `<td${span} style="${matrixCellStyle(cell, opts)}">${inner}</td>`;
     }).join("");
@@ -1613,6 +3051,20 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx) {
   }
   return trs.join("\n");
 }
+function renderTextCellInner(renderRows, rowIndex, colIndex, cell, opts, fitOwner, defaultPadding, ctx) {
+  const fit = resolveCellTextFit(cell);
+  const text = esc(resolveCellContent(cell, ctx));
+  if (fit === "autoHeight") return text;
+  const capMm = cellFitCapMm(renderRows, rowIndex, cell, defaultPadding);
+  const nowrap = cell.wordWrap === false;
+  const style = [
+    `max-height:${capMm}mm`,
+    "overflow:hidden",
+    ...nowrap ? ["white-space:nowrap", "text-overflow:ellipsis"] : []
+  ].join(";");
+  const attrs = fit === "shrink" && fitOwner.elementId ? ` data-fit="shrink" data-fit-key="${esc(cellFitKey(fitOwner.elementId, fitOwner.kind, rowIndex, colIndex))}" data-fit-base="${cell.fontSize ?? opts.tableDefaultFontSize ?? 12}" data-fit-min="${resolveShrinkMinFontSize(cell.shrinkMinFontSize)}" data-fit-mm="${capMm}"` : "";
+  return `<div class="cell-fit" style="${style}"${attrs}>${text}</div>`;
+}
 function matrixTableHtml(el, bodyHtml) {
   const opts = el.options;
   const colWidths = opts.tableColWidths ?? [];
@@ -1627,7 +3079,7 @@ function renderTableElement(el, isMeasure, measureAttr, ctx) {
   const opts = el.options;
   const style = elementPositionStyle(opts.left ?? 0, opts.top ?? 0, opts.width ?? 100, void 0, opts.zIndex);
   const renderRows = opts._renderRows ?? [];
-  const bodyHtml = renderMatrixRows(renderRows, 0, renderRows.length, opts, isMeasure, ctx);
+  const bodyHtml = renderMatrixRows(renderRows, 0, renderRows.length, opts, isMeasure, ctx, { elementId: el.id, kind: "b" });
   return `<div class="print-element" style="${style};overflow:visible;"${measureAttr}>
   ${matrixTableHtml(el, bodyHtml)}
 </div>`;
@@ -1639,8 +3091,8 @@ function renderTableSlice(el, section, ctx) {
   const startRow = section.startRow ?? 0;
   const endRow = section.endRow ?? renderRows.length;
   const repeatCount = opts._repeatHeaderCount ?? 0;
-  const repeatHtml = section.repeatHeader && repeatCount > 0 ? renderMatrixRows(renderRows, 0, repeatCount, opts, false, ctx) : "";
-  const bodyHtml = renderMatrixRows(renderRows, startRow, endRow, opts, false, ctx);
+  const repeatHtml = section.repeatHeader && repeatCount > 0 ? renderMatrixRows(renderRows, 0, repeatCount, opts, false, ctx, { elementId: el.id, kind: "b" }, repeatCount) : "";
+  const bodyHtml = renderMatrixRows(renderRows, startRow, endRow, opts, false, ctx, { elementId: el.id, kind: "b" });
   const subtotalHtml = section.subtotal ? renderSubtotalRows(el, section, opts, ctx) : "";
   const summaryHtml = section.summary ? renderSummaryRows(el, opts, ctx) : "";
   return `<div class="print-element" style="${style};overflow:visible;">
@@ -1660,16 +3112,22 @@ function renderSubtotalRows(el, section, opts, ctx) {
   const dataStart = Math.max(startRow, dataStartIdx);
   const dataEnd = Math.max(endRow, dataStart);
   const pageCtx = dataEnd > dataStartIdx ? dataRowCtx.slice(Math.max(dataStart - dataStartIdx, 0), dataEnd - dataStartIdx) : [];
+  const pageVars = ctx?.pageVars ? pageVarsContext(ctx.pageVars) : {};
   const rows = templates.map((tpl) => ({
     ...tpl,
-    cells: tpl.cells.map((cell) => cell.rawFormatter ? { ...cell, content: evaluateTemplate(cell.rawFormatter, { rows: pageCtx, ...mainData }) } : cell)
+    cells: tpl.cells.map((cell) => cell.rawFormatter ? {
+      ...cell,
+      content: evaluateTemplate(cell.rawFormatter, { rows: pageCtx, ...mainData, ...pageVars }),
+      // 已按本页上下文求值，清标记避免渲染时再按页码重算一次（会丢掉 rows）
+      rawFormatter: ""
+    } : cell)
   }));
-  return renderMatrixRows(rows, 0, rows.length, opts, false, ctx);
+  return renderMatrixRows(rows, 0, rows.length, opts, false, ctx, { elementId: el.id, kind: "st" });
 }
 function renderSummaryRows(el, opts, ctx) {
   const summaryRows = opts._summaryRows ?? [];
   if (summaryRows.length === 0) return "";
-  return renderMatrixRows(summaryRows, 0, summaryRows.length, opts, false, ctx);
+  return renderMatrixRows(summaryRows, 0, summaryRows.length, opts, false, ctx, { elementId: el.id, kind: "sm" });
 }
 function renderFlowGroup(el, section, template, ctx) {
   const opts = el.options ?? {};
@@ -1685,8 +3143,8 @@ function renderFlowGroup(el, section, template, ctx) {
   if (endRow > startRow || section.subtotal || section.summary) {
     const renderRows = opts._renderRows ?? [];
     const repeatCount = opts._repeatHeaderCount ?? 0;
-    const repeatHtml = section.repeatHeader && repeatCount > 0 ? renderMatrixRows(renderRows, 0, repeatCount, opts, false, ctx) : "";
-    const bodyHtml = renderMatrixRows(renderRows, startRow, endRow, opts, false, ctx);
+    const repeatHtml = section.repeatHeader && repeatCount > 0 ? renderMatrixRows(renderRows, 0, repeatCount, opts, false, ctx, { elementId: el.id, kind: "b" }, repeatCount) : "";
+    const bodyHtml = renderMatrixRows(renderRows, startRow, endRow, opts, false, ctx, { elementId: el.id, kind: "b" });
     const subtotalHtml = section.subtotal ? renderSubtotalRows(el, section, opts, ctx) : "";
     const summaryHtml = section.summary ? renderSummaryRows(el, opts, ctx) : "";
     sliceHtml = `<div class="flow-slice" style="position:relative;width:${mm(tableWidth)};overflow:visible;">
@@ -1754,167 +3212,707 @@ function esc(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 
-// src/browser/browser-pagination.ts
-var PX_PER_MM = 3.7795275591;
-var READY_TIMEOUT_MS = 3e3;
-async function renderHtmlPages(template, printData, baseUrl, codeRenderer) {
-  const boundTemplate = bindData(template, printData, baseUrl);
-  const measuredElements = await measureElements(boundTemplate, codeRenderer);
-  const pageLayouts = paginate(boundTemplate, measuredElements);
-  const html = generateHtml(boundTemplate, pageLayouts, printData, {
-    codeRenderer
-  });
-  return { html, pageCount: pageLayouts.length, pageLayouts };
+// src/render/continuous-paper.ts
+var MIN_CONTINUOUS_HEIGHT_MM = 25.4;
+function composeContinuousHeight(template, contentBottomMm) {
+  const mb = template.margins?.bottom ?? 0;
+  const footerH = template.footer?.height ?? 0;
+  const height = Math.max(contentBottomMm, 0) + footerH + mb;
+  return Math.max(MIN_CONTINUOUS_HEIGHT_MM, Math.round(height * 100) / 100);
 }
-async function measureElements(template, codeRenderer) {
-  const paper = getPaperDimensions(template);
-  const measureHtml = generateHtml(template, [], void 0, {
-    isMeasurementPass: true,
-    codeRenderer
-  });
-  const iframe = document.createElement("iframe");
-  iframe.setAttribute("aria-hidden", "true");
-  iframe.style.cssText = `position:fixed;left:-10000px;top:0;width:${paper.width}mm;height:${paper.height}mm;border:0;visibility:hidden;pointer-events:none;`;
-  document.body.appendChild(iframe);
-  try {
-    const win = iframe.contentWindow;
-    const doc = iframe.contentDocument;
-    if (!win || !doc) throw new Error("\u65E0\u6CD5\u521B\u5EFA\u6D4B\u91CF iframe");
-    doc.open();
-    doc.write(measureHtml);
-    doc.close();
-    await waitForRenderReady(win);
-    const measurements = readMeasurements(doc);
-    const measuredMap = /* @__PURE__ */ new Map();
-    const elementIndex = new Map(template.elements.map((el) => [el.id, el]));
-    for (const m of measurements) {
-      const el = elementIndex.get(m.id);
-      const repeatCount = el?.options?._repeatHeaderCount ?? 0;
-      measuredMap.set(m.id, {
-        id: m.id,
-        measuredHeight: m.height,
-        measuredRowHeights: m.rowHeights,
-        repeatHeaderHeight: m.rowHeights && repeatCount > 0 ? m.rowHeights.slice(0, repeatCount).reduce((s, h) => s + h, 0) : 0
-      });
+
+// src/print/codes.ts
+function codeSpecKey(value, cellType, opts = {}) {
+  return JSON.stringify([
+    value,
+    cellType,
+    opts.barcodeType ?? null,
+    opts.qrCodeLevel ?? null,
+    opts.showText ?? null,
+    opts.barWidth ?? null,
+    opts.fontSize ?? null
+  ]);
+}
+function createMapCodeRenderer(map) {
+  return {
+    render(value, cellType, opts) {
+      const svg = map.get(codeSpecKey(value, cellType, opts));
+      if (!svg) throw new Error(`\u7801\u503C\u672A\u6E32\u67D3\uFF1A${value}`);
+      return svg;
     }
-    return measuredMap;
-  } finally {
-    iframe.remove();
-  }
+  };
 }
-function waitForRenderReady(win) {
-  return new Promise((resolve) => {
-    let settled = false;
-    const finish = () => {
-      if (!settled) {
-        settled = true;
-        resolve();
-      }
-    };
-    const timer = setTimeout(finish, READY_TIMEOUT_MS);
-    const run = async () => {
-      try {
-        const fonts = win.document.fonts;
-        if (fonts?.ready) {
-          await Promise.race([fonts.ready, timeout(READY_TIMEOUT_MS)]);
-        }
-        await Promise.race([waitForImages(win.document), timeout(READY_TIMEOUT_MS)]);
-      } catch {
-      } finally {
-        clearTimeout(timer);
-        finish();
+function createCollectingCodeRenderer(base) {
+  const collected = /* @__PURE__ */ new Map();
+  return {
+    renderer: {
+      render(value, cellType, opts = {}) {
+        const key = codeSpecKey(value, cellType, opts);
+        const hit = base?.get(key);
+        if (hit) return hit;
+        collected.set(key, { key, value, cellType, opts });
+        throw new Error("collect");
       }
+    },
+    takeSpecs() {
+      const specs = [...collected.values()];
+      collected.clear();
+      return specs;
+    }
+  };
+}
+function mergeCodeMaps(...maps) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const map of maps) {
+    for (const [key, svg] of map) merged.set(key, svg);
+  }
+  return merged;
+}
+
+// src/print/units.ts
+var PX_PER_MM2 = 3.7795275591;
+function pxToMm(px) {
+  return px / PX_PER_MM2;
+}
+function mmToPx2(mm2) {
+  return Math.round(mm2 * PX_PER_MM2);
+}
+
+// src/print/paper.ts
+function positive(value) {
+  return typeof value === "number" && value > 0 ? value : void 0;
+}
+function escapeHeightMm(input) {
+  return positive(input.paperHeightMm) ?? positive(input.override?.height);
+}
+function resolvePaperMm(input) {
+  const width = positive(input.override?.width) ?? input.paperMm.width;
+  const overrideHeight = positive(input.override?.height);
+  if (input.continuous) {
+    return overrideHeight ? { paperMm: { width, height: overrideHeight }, heightSource: "config" } : { paperMm: { width, height: input.paperMm.height }, heightSource: "derived" };
+  }
+  return { paperMm: { width, height: overrideHeight ?? input.paperMm.height }, heightSource: "config" };
+}
+function paperViewportPx(paper) {
+  return { width: mmToPx2(paper.width), height: mmToPx2(paper.height) };
+}
+
+// src/print/measure.ts
+function normalizeMeasurements(raw, template) {
+  const index = new Map(template.elements.map((el) => [el.id, el]));
+  const measured = /* @__PURE__ */ new Map();
+  for (const item of raw) {
+    const element = index.get(item.id);
+    const repeatCount = element?.options?._repeatHeaderCount ?? 0;
+    const rowHeights = item.rowHeightsPx?.map(pxToMm);
+    measured.set(item.id, {
+      id: item.id,
+      measuredHeight: pxToMm(item.heightPx),
+      measuredRowHeights: rowHeights,
+      repeatHeaderHeight: rowHeights && rowHeights.length > 0 && repeatCount > 0 ? rowHeights.slice(0, repeatCount).reduce((sum2, h) => sum2 + h, 0) : 0
+    });
+  }
+  return measured;
+}
+
+// src/print/apply-text-fit.ts
+var CELL_ROW_SOURCES = {
+  b: "_renderRows",
+  st: "_subtotalTemplates",
+  sm: "_summaryRows"
+};
+function applyTextFitSizes(template, fits) {
+  if (!fits || fits.length === 0) return;
+  const index = /* @__PURE__ */ new Map();
+  const collect = (elements) => {
+    for (const el of elements ?? []) index.set(el.id, el);
+  };
+  collect(template.elements);
+  collect(template.header?.elements);
+  collect(template.footer?.elements);
+  collect(template.firstPageOverlay?.elements);
+  for (const fit of fits) {
+    const parsed = parseCellFitKey(fit.key);
+    if (!parsed) {
+      const el2 = index.get(fit.key);
+      if (el2) el2.options._fitFontSize = roundFontSize(fit.fontSizePt);
+      continue;
+    }
+    const el = index.get(parsed.elementId);
+    const rows = el?.options?.[CELL_ROW_SOURCES[parsed.kind]];
+    const cell = rows?.[parsed.rowIndex]?.cells?.[parsed.colIndex];
+    if (cell) cell.fittedFontSize = roundFontSize(fit.fontSizePt);
+  }
+}
+
+// src/print/normalize-print-data.ts
+var MAX_BATCH_COPIES = 500;
+function isPlainRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function normalizePrintData(raw) {
+  if (raw === void 0) return { mode: "single", data: {} };
+  if (!Array.isArray(raw)) return { mode: "single", data: raw };
+  if (raw.length === 0) {
+    throw new Error("\u6279\u91CF\u6253\u5370\u6570\u636E\u5FC5\u987B\u662F\u975E\u7A7A\u5BF9\u8C61\u6570\u7EC4");
+  }
+  if (raw.length > MAX_BATCH_COPIES) {
+    throw new Error(`\u6279\u91CF\u6253\u5370\u6700\u591A\u652F\u6301 ${MAX_BATCH_COPIES} \u4EFD\uFF0C\u5F53\u524D ${raw.length} \u4EFD`);
+  }
+  for (let i = 0; i < raw.length; i++) {
+    if (!isPlainRecord(raw[i])) {
+      throw new Error(`\u6279\u91CF\u6253\u5370\u6570\u636E\u7B2C ${i + 1} \u9879\u5FC5\u987B\u662F\u5BF9\u8C61`);
+    }
+  }
+  return { mode: "batch", dataList: raw };
+}
+
+// src/print/batch-compose.ts
+function composeBatchHtml(copies) {
+  const bound = copies[0].bound;
+  const continuous = isContinuousPaper(bound);
+  const bodyInner = copies.map((copy, i) => {
+    const cls = continuous ? `print-copy print-copy-${i}` : "print-copy";
+    const pages = renderFinalPages(copy.bound, copy.pageLayouts, copy.data, {
+      codeRenderer: copy.codeRenderer,
+      pageHeightMm: copy.derivedHeightMm
+    });
+    return `<section class="${cls}">
+${pages}
+</section>`;
+  }).join("\n");
+  const pageCss = continuous ? buildBatchPageCss(bound, copies.map((c) => ({ heightMm: c.derivedHeightMm }))) : `${buildPageCss(bound)}
+.print-copy:not(:last-child){break-after:page;page-break-after:always;}`;
+  const css = buildFontFaceCss(bound.fonts) + pageCss;
+  return {
+    html: wrapHtmlDocument(
+      css,
+      bodyInner,
+      continuous ? "continuous" : void 0
+    ),
+    pageCount: copies.reduce((sum2, c) => sum2 + c.pageLayouts.length, 0),
+    copyPaperMm: copies.map((c) => c.paperMm)
+  };
+}
+
+// src/print/tiling.ts
+var TILE_DEFAULTS = {
+  enabled: true,
+  sheetPaperSize: "A4",
+  sheetOrientation: "portrait",
+  sheetMargin: { top: 10, right: 10, bottom: 10, left: 10 },
+  gapX: 2,
+  gapY: 2,
+  columns: 2
+};
+var TilingError = class extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = "TilingError";
+    this.code = code;
+  }
+};
+function roundMm(value) {
+  return Math.round(value * 10) / 10;
+}
+function normalizeTilingOptions(t) {
+  const raw = t.tiling;
+  return {
+    ...TILE_DEFAULTS,
+    ...raw,
+    sheetMargin: { ...TILE_DEFAULTS.sheetMargin, ...raw?.sheetMargin ?? {} }
+  };
+}
+function resolveSheetMm(t, opts) {
+  const cfg = normalizeTilingOptions(t);
+  const ov = opts?.paperOverride;
+  if (ov && typeof ov.width === "number" && ov.width > 0 && typeof ov.height === "number" && ov.height > 0) {
+    return { width: ov.width, height: ov.height };
+  }
+  if (cfg.sheetPaperSize === "CUSTOM") {
+    return {
+      width: cfg.sheetCustomWidth ?? PAPER_DIMENSIONS.A4.width,
+      height: cfg.sheetCustomHeight ?? PAPER_DIMENSIONS.A4.height
     };
-    if (win.document.readyState === "complete") {
-      void run();
-    } else {
-      win.addEventListener("load", () => void run(), { once: true });
-      setTimeout(finish, READY_TIMEOUT_MS);
+  }
+  const preset = cfg.sheetPaperSize ?? "A4";
+  const base = PAPER_DIMENSIONS[preset] ?? PAPER_DIMENSIONS.A4;
+  return cfg.sheetOrientation === "landscape" ? { width: base.height, height: base.width } : { ...base };
+}
+function availableArea(sheet, margin) {
+  return {
+    w: sheet.width - margin.left - margin.right,
+    h: sheet.height - margin.top - margin.bottom
+  };
+}
+function calcMaxColumns(availW, labelW, gapX) {
+  return Math.max(0, Math.floor((availW + gapX) / (labelW + gapX)));
+}
+function computeTileLayout(t, opts) {
+  const issues = validateTiling(t, opts);
+  if (issues.length) throw new TilingError(issues[0].code, issues[0].message);
+  const cfg = normalizeTilingOptions(t);
+  const sheet = resolveSheetMm(t, opts);
+  const label = getPaperDimensions(t);
+  const avail = availableArea(sheet, cfg.sheetMargin);
+  const rows = Math.floor((avail.h + cfg.gapY) / (label.height + cfg.gapY));
+  return {
+    tile: { width: label.width, height: label.height },
+    sheet,
+    columns: cfg.columns,
+    rows,
+    perSheet: cfg.columns * rows,
+    maxColumns: calcMaxColumns(avail.w, label.width, cfg.gapX),
+    margin: { ...cfg.sheetMargin },
+    gapX: cfg.gapX,
+    gapY: cfg.gapY
+  };
+}
+function tilePosition(layout, index) {
+  const slot = index % layout.perSheet;
+  const col = slot % layout.columns;
+  const row = Math.floor(slot / layout.columns);
+  return {
+    left: roundMm(layout.margin.left + col * (layout.tile.width + layout.gapX)),
+    top: roundMm(layout.margin.top + row * (layout.tile.height + layout.gapY))
+  };
+}
+function validateTiling(t, opts) {
+  const issues = [];
+  const cfg = normalizeTilingOptions(t);
+  if (isContinuousPaper(t)) {
+    issues.push({
+      code: "CONTINUOUS_UNSUPPORTED",
+      message: "\u8FDE\u7EED\u7EB8\u4E0D\u652F\u6301\u62FC\u7248\u6253\u5370\uFF0C\u8BF7\u5C06\u6A21\u677F\u7EB8\u5F20\u6539\u4E3A\u56FA\u5B9A\u7EB8\u5F20\u6216\u5173\u95ED\u62FC\u7248"
+    });
+  }
+  const sheetPaperSize = cfg.sheetPaperSize;
+  const sheetContinuous = isContinuousPaperSize(sheetPaperSize ?? "");
+  if (sheetContinuous) {
+    issues.push({ code: "SHEET_CONTINUOUS", message: "\u62FC\u7248\u76EE\u6807\u7EB8\u5F20\u4E0D\u80FD\u662F\u8FDE\u7EED\u7EB8" });
+  }
+  const customSizeInvalid = cfg.sheetPaperSize === "CUSTOM" && !((cfg.sheetCustomWidth ?? 0) > 0 && (cfg.sheetCustomHeight ?? 0) > 0);
+  if (customSizeInvalid) {
+    issues.push({
+      code: "SHEET_SIZE_INVALID",
+      message: "\u62FC\u7248\u81EA\u5B9A\u4E49\u7EB8\u5F20\u5BBD\u9AD8\u5FC5\u987B\u662F\u5927\u4E8E 0 \u7684\u6570\u503C\uFF08mm\uFF09"
+    });
+  }
+  if (customSizeInvalid || sheetContinuous) return issues;
+  const sheet = resolveSheetMm(t, opts);
+  const label = getPaperDimensions(t);
+  const avail = availableArea(sheet, cfg.sheetMargin);
+  const marginLR = roundMm(cfg.sheetMargin.left + cfg.sheetMargin.right);
+  if (!Number.isInteger(cfg.columns) || cfg.columns < 1) {
+    issues.push({ code: "COLUMNS_INVALID", message: "\u62FC\u7248\u5217\u6570\u5FC5\u987B\u662F\u5927\u4E8E 0 \u7684\u6574\u6570" });
+    return issues;
+  }
+  const maxColumns = calcMaxColumns(avail.w, label.width, cfg.gapX);
+  if (cfg.columns > maxColumns) {
+    const needW = roundMm(cfg.columns * label.width + (cfg.columns - 1) * cfg.gapX);
+    issues.push({
+      code: "COLUMNS_OVERFLOW",
+      message: "\u62FC\u7248\u5217\u6570 " + cfg.columns + " \u8D85\u51FA\u7EB8\u9762\u53EF\u7528\u5BBD\u5EA6\uFF1A" + roundMm(sheet.width) + "mm \u2212 \u5DE6\u53F3\u7559\u767D " + marginLR + "mm = " + roundMm(avail.w) + "mm\uFF0C\u6700\u591A\u53EF\u653E " + maxColumns + " \u5217\uFF1B\u5F53\u524D " + cfg.columns + " \u5217 " + label.width + "mm \u6807\u7B7E\u542B\u95F4\u8DDD\u9700\u8981 " + needW + "mm"
+    });
+  }
+  if (Math.floor((avail.h + cfg.gapY) / (label.height + cfg.gapY)) < 1) {
+    issues.push({
+      code: "LABEL_TOO_TALL",
+      message: "\u6807\u7B7E\u9AD8\u5EA6 " + label.height + "mm \u8D85\u51FA\u7EB8\u9762\u53EF\u7528\u9AD8\u5EA6 " + roundMm(avail.h) + "mm\uFF0C\u62FC\u7248\u6BCF\u5F20 0 \u884C\uFF1B\u8BF7\u7F29\u5C0F\u6807\u7B7E\u9AD8\u5EA6\u6216\u6539\u7528\u6A2A\u5411\u7EB8"
+    });
+  }
+  return issues;
+}
+
+// src/print/tile-compose.ts
+function composeTiledHtml(input) {
+  const { copies, layout } = input;
+  const bound = copies[0].bound;
+  const sheets = [];
+  for (let start = 0; start < copies.length; start += layout.perSheet) {
+    const tiles = copies.slice(start, start + layout.perSheet).map((copy, i) => {
+      const pos = tilePosition(layout, i);
+      const page = renderFinalPages(copy.bound, copy.pageLayouts, copy.data, {
+        codeRenderer: copy.codeRenderer
+      });
+      return `<div class="print-tile" style="left:${pos.left}mm;top:${pos.top}mm">
+${page}
+</div>`;
+    }).join("\n");
+    sheets.push(`<section class="print-sheet">
+${tiles}
+</section>`);
+  }
+  const css = buildFontFaceCss(bound.fonts) + buildPageCss(bound) + "\n" + buildSheetPageCss(layout);
+  return {
+    html: wrapHtmlDocument(css, sheets.join("\n")),
+    sheetCount: sheets.length,
+    perSheet: layout.perSheet
+  };
+}
+
+// src/print/multi-template.ts
+function pageLabel(p, index) {
+  return p.name ? `\u7B2C ${index + 1} \u9875\u300C${p.name}\u300D` : `\u7B2C ${index + 1} \u9875`;
+}
+function normalizeTemplate(templateJson) {
+  const pages = isMultiPageTemplate(templateJson) ? templateJson.pages : [templateJson];
+  if (pages.length === 0) {
+    throw new Error("\u591A\u9875\u9762\u6A21\u677F\u81F3\u5C11\u9700\u8981\u4E00\u9875");
+  }
+  if (pages.length === 1) return pages;
+  const firstPaper = getPaperDimensions(pages[0]);
+  pages.forEach((p, i) => {
+    if (isContinuousPaper(p)) {
+      throw new Error(`\u591A\u9875\u9762\u6A21\u677F\u4E0D\u652F\u6301\u8FDE\u7EED\u7EB8\uFF08${pageLabel(p, i)}\uFF09`);
+    }
+    if (p.tiling?.enabled === true) {
+      throw new Error(`\u591A\u9875\u9762\u6A21\u677F\u4E0D\u652F\u6301\u6807\u7B7E\u62FC\u7248\uFF08${pageLabel(p, i)}\uFF09`);
+    }
+    const d = getPaperDimensions(p);
+    if (d.width !== firstPaper.width || d.height !== firstPaper.height) {
+      throw new Error(
+        `\u591A\u9875\u9762\u6A21\u677F\u5404\u9875\u7EB8\u5F20\u5C3A\u5BF8\u5FC5\u987B\u4E00\u81F4\uFF08${pageLabel(p, i)} ${d.width}\xD7${d.height}mm \u4E0E\u9996\u9875 ${firstPaper.width}\xD7${firstPaper.height}mm \u4E0D\u540C\uFF09`
+      );
     }
   });
+  return pages;
 }
-function timeout(ms) {
-  return new Promise((_resolve, reject) => setTimeout(() => reject(new Error("timeout")), ms));
-}
-function waitForImages(doc) {
-  const imgs = Array.from(doc.images ?? []);
-  return Promise.all(
-    imgs.map(
-      (img) => img.complete ? Promise.resolve() : new Promise((resolve) => {
-        img.addEventListener("load", () => resolve(), { once: true });
-        img.addEventListener("error", () => resolve(), { once: true });
-      })
-    )
-  ).then(() => void 0);
+function isMultiPageTemplate(templateJson) {
+  return Array.isArray(templateJson.pages);
+}
+function mergeFontDeclarations(pages) {
+  const seen = /* @__PURE__ */ new Set();
+  const merged = [];
+  for (const p of pages) {
+    for (const f of p.fonts ?? []) {
+      const key = f.family;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      merged.push(f);
+    }
+  }
+  return merged;
+}
+function composeMultiPageDocument(copies) {
+  if (copies.length === 0) {
+    throw new Error("\u591A\u9875\u9762\u6A21\u677F\u81F3\u5C11\u9700\u8981\u4E00\u4EFD\u6570\u636E");
+  }
+  const templates = copies[0].boundPages;
+  const css = buildFontFaceCss(mergeFontDeclarations(templates)) + [
+    buildPageRuleCss(templates[0]),
+    buildBasePageCss(),
+    ...templates.map((t, i) => buildPageGeometryCss(t, `.mt-${i}`)),
+    ...copies.length > 1 ? [COPY_BREAK_CSS] : []
+  ].join("\n\n");
+  const bodyInner = copies.map((copy) => {
+    const totalPages = copy.layoutsPerPage.reduce((s, ls) => s + ls.length, 0);
+    let offset = 0;
+    const fragments = copy.layoutsPerPage.map((layouts, i) => {
+      const html = renderFinalPages(
+        copy.boundPages[i],
+        layouts,
+        copy.data,
+        { codeRenderer: copy.codeRenderers?.[i] },
+        {
+          pageOffset: offset,
+          totalPages,
+          pageClass: `mt-${i}`
+        }
+      );
+      offset += layouts.length;
+      return html;
+    });
+    const pages = fragments.join("\n");
+    return copies.length > 1 ? `<section class="print-copy">
+${pages}
+</section>` : pages;
+  }).join("\n");
+  const pageCount = copies.reduce(
+    (sum2, c) => sum2 + c.layoutsPerPage.reduce((s, ls) => s + ls.length, 0),
+    0
+  );
+  const pageLayouts = [];
+  let g = 0;
+  for (const c of copies) {
+    for (const ls of c.layoutsPerPage) {
+      for (const p of ls) pageLayouts.push({ ...p, pageIndex: g++ });
+    }
+  }
+  return {
+    html: wrapHtmlDocument(css, bodyInner),
+    pageCount,
+    pageLayouts
+  };
 }
-function readMeasurements(doc) {
-  const result = [];
-  const elements = doc.querySelectorAll("[data-measure-id]");
-  for (const el of elements) {
-    const htmlEl = el;
-    const id = htmlEl.getAttribute("data-measure-id");
-    if (!id) continue;
-    const heightPx = htmlEl.offsetHeight;
-    const table = htmlEl.querySelector("table.print-table");
-    if (table) {
-      const rowHeights = [];
-      const rows = table.querySelectorAll("tbody > tr[data-row-index]");
-      for (const row of rows) {
-        rowHeights.push(row.offsetHeight / PX_PER_MM);
+
+// src/print/pipeline.ts
+async function prepareDocument(job, runtime) {
+  return runtime.withSession(job, (session) => prepareWithSession(job, session));
+}
+async function prepareWithSession(job, session) {
+  const pageTemplates = normalizeTemplate(job.templateJson);
+  if (pageTemplates.length > 1) {
+    const normalized2 = normalizePrintData(job.printData);
+    const rows = normalized2.mode === "batch" ? normalized2.dataList : [normalized2.data];
+    const copies2 = [];
+    for (let i = 0; i < rows.length; i++) {
+      try {
+        copies2.push(await prepareMultiCopy(job, session, rows[i]));
+      } catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`\u7B2C ${i + 1} \u4EFD\u6E32\u67D3\u5931\u8D25\uFF1A${reason}`);
       }
-      result.push({ id, height: heightPx / PX_PER_MM, rowHeights });
-    } else {
-      result.push({ id, height: heightPx / PX_PER_MM });
     }
+    const doc = composeMultiPageDocument(copies2);
+    return {
+      html: doc.html,
+      pageCount: doc.pageCount,
+      paperMm: getOutputPaperDimensions(pageTemplates[0]),
+      continuous: false,
+      heightSource: "config",
+      pageLayouts: doc.pageLayouts,
+      copies: copies2.length
+    };
   }
-  return result;
+  const singleJob = pageTemplates[0] !== job.templateJson ? { ...job, templateJson: pageTemplates[0] } : job;
+  const template = pageTemplates[0];
+  const normalized = normalizePrintData(singleJob.printData);
+  if (normalized.mode === "single") {
+    const single = await prepareSingleWithSession(singleJob, session, normalized.data);
+    if (template.tiling?.enabled === true) {
+      return composeTiledPrepared(singleJob, [{
+        bound: single.bound,
+        pageLayouts: single.pageLayouts,
+        data: normalized.data,
+        codeRenderer: single.codeRenderer,
+        derivedHeightMm: single.derivedHeightMm,
+        paperMm: single.paperMm,
+        heightSource: single.heightSource
+      }]);
+    }
+    return toPreparedDocument(single);
+  }
+  const copies = [];
+  for (let i = 0; i < normalized.dataList.length; i++) {
+    try {
+      const single = await prepareSingleWithSession(singleJob, session, normalized.dataList[i]);
+      copies.push({
+        bound: single.bound,
+        pageLayouts: single.pageLayouts,
+        data: normalized.dataList[i],
+        codeRenderer: single.codeRenderer,
+        derivedHeightMm: single.derivedHeightMm,
+        paperMm: single.paperMm,
+        heightSource: single.heightSource
+      });
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      throw new Error(`\u7B2C ${i + 1} \u4EFD\u6E32\u67D3\u5931\u8D25\uFF1A${reason}`);
+    }
+  }
+  if (template.tiling?.enabled === true) {
+    return composeTiledPrepared(singleJob, copies);
+  }
+  const merged = composeBatchHtml(copies);
+  return {
+    html: merged.html,
+    pageCount: merged.pageCount,
+    paperMm: copies[0].paperMm,
+    continuous: isContinuousPaper(copies[0].bound),
+    // 同模板同参数各份来源必然一致；不能用 derivedHeightMm 是否存在判断——
+    // 连续纸逃生门时该字段有值但来源是 config
+    heightSource: copies[0].heightSource,
+    // 各份 pageIndex 均从 0 开始，批量拼接后该字段仅作调试用途
+    pageLayouts: copies.flatMap((c) => c.pageLayouts),
+    copies: copies.length,
+    copyPaperMm: merged.copyPaperMm
+  };
 }
-
-// src/browser/browser-code-renderer.ts
-var import_jsbarcode = __toESM(require("jsbarcode"), 1);
-var import_qrcode = __toESM(require("qrcode"), 1);
-var SVG_NS = "http://www.w3.org/2000/svg";
-function renderBarcodeSvg(value, opts) {
-  const svg = document.createElementNS(SVG_NS, "svg");
-  (0, import_jsbarcode.default)(svg, value, {
-    format: opts.barcodeType || "CODE128",
-    width: Math.max(1, (opts.barWidth ?? 2) / 2),
-    height: 30,
-    displayValue: opts.showText !== false,
-    fontSize: opts.fontSize ?? 10,
-    margin: 0,
-    marginBottom: 2
+function toPreparedDocument(s) {
+  return {
+    html: s.html,
+    pageCount: s.pageCount,
+    paperMm: s.paperMm,
+    continuous: s.continuous,
+    heightSource: s.heightSource,
+    pageLayouts: s.pageLayouts,
+    copies: 1
+  };
+}
+function composeTiledPrepared(job, copies) {
+  const bound = copies[0].bound;
+  const layout = computeTileLayout(bound, { paperOverride: job.paperOverride });
+  copies.forEach((copy, i) => {
+    const overflow = copy.pageLayouts[0]?.overflow === true;
+    if (copy.pageLayouts.length !== 1 || overflow) {
+      const detail = overflow ? "\u5185\u5BB9\u8D85\u51FA\u7EB8\u5F20\u9AD8\u5EA6" : `\u6E32\u67D3\u51FA ${copy.pageLayouts.length} \u9875`;
+      throw new Error(
+        `\u62FC\u7248\u8981\u6C42\u6BCF\u4EFD\u6807\u7B7E\u6070\u597D 1 \u9875\uFF0C\u7B2C ${i + 1} \u4EFD${detail}\uFF1B\u8BF7\u7F29\u5C0F\u5185\u5BB9\u6216\u8C03\u6574\u6807\u7B7E\u7EB8\u5F20\u9AD8\u5EA6`
+      );
+    }
   });
-  return svg.outerHTML;
+  const tiled = composeTiledHtml({
+    copies: copies.map((c) => ({
+      bound: c.bound,
+      pageLayouts: c.pageLayouts,
+      data: c.data,
+      codeRenderer: c.codeRenderer
+    })),
+    layout
+  });
+  return {
+    html: tiled.html,
+    // 语义变更：pageCount = 实际输出张数（客户端任务历史、预览「共 N 页」都按此口径）
+    pageCount: tiled.sheetCount,
+    paperMm: { width: layout.sheet.width, height: layout.sheet.height },
+    continuous: false,
+    heightSource: "config",
+    // 调试用途；各份 pageIndex 均从 0 开始
+    pageLayouts: copies.flatMap((c) => c.pageLayouts),
+    copies: copies.length
+  };
 }
-function renderQrSvg(value, opts) {
-  const level = (opts.qrCodeLevel ?? "M").toUpperCase();
-  const qr = import_qrcode.default.create(value, {
-    errorCorrectionLevel: ["L", "M", "Q", "H"].includes(level) ? level : "M"
+async function prepareSingleWithSession(job, session, data) {
+  const bound = bindData(job.templateJson, data, job.baseUrl, job.fontBaseUrl);
+  const continuous = isContinuousPaper(bound);
+  const designPaper = getPaperDimensions(bound);
+  const viewport = paperViewportPx(designPaper);
+  const heightEscape = escapeHeightMm({ paperHeightMm: job.paperHeightMm, override: job.paperOverride });
+  const measurement = await buildHtmlWithCodes({
+    bound,
+    job,
+    session,
+    data,
+    pageLayouts: [],
+    isMeasurementPass: true
   });
-  const modules = qr.modules;
-  const size = modules.size;
-  const dot = 4;
-  const quiet = 4 * dot;
-  const dim = size * dot + quiet * 2;
-  let rects = "";
-  for (let y = 0; y < size; y++) {
-    for (let x = 0; x < size; x++) {
-      if (modules.get(x, y)) {
-        rects += `<rect x="${quiet + x * dot}" y="${quiet + y * dot}" width="${dot}" height="${dot}" fill="#000"/>`;
-      }
+  const measurements = await session.measure(measurement.html, viewport);
+  applyTextFitSizes(bound, measurements.fits);
+  const pageLayouts = paginate(bound, normalizeMeasurements(measurements.measurements, bound));
+  const finalBuild = await buildHtmlWithCodes({
+    bound,
+    job,
+    session,
+    data,
+    pageLayouts,
+    isMeasurementPass: false,
+    baseMap: measurement.map
+  });
+  let html = finalBuild.html;
+  let derivedHeightMm;
+  if (continuous) {
+    if (heightEscape && heightEscape > 0) {
+      derivedHeightMm = heightEscape;
+    } else {
+      const bottomPx = await session.probeContentBottom(html, viewport);
+      derivedHeightMm = composeContinuousHeight(bound, pxToMm(bottomPx));
     }
+    html = generateHtml(bound, pageLayouts, data, {
+      codeRenderer: finalBuild.codeRenderer,
+      pageHeightMm: derivedHeightMm
+    });
   }
-  return `<svg xmlns="${SVG_NS}" viewBox="0 0 ${dim} ${dim}" width="${dim}" height="${dim}" shape-rendering="crispEdges">${rects}</svg>`;
+  const overrideForPaper = continuous && heightEscape ? { ...job.paperOverride, height: heightEscape } : job.paperOverride;
+  const outputPaper = getOutputPaperDimensions(bound);
+  const { paperMm, heightSource } = resolvePaperMm({
+    paperMm: { width: outputPaper.width, height: derivedHeightMm ?? outputPaper.height },
+    continuous,
+    override: overrideForPaper
+  });
+  return {
+    html,
+    pageCount: pageLayouts.length,
+    paperMm,
+    continuous,
+    heightSource,
+    pageLayouts,
+    copies: 1,
+    bound,
+    codeRenderer: finalBuild.codeRenderer,
+    derivedHeightMm
+  };
 }
-var browserCodeRenderer = {
-  render(value, cellType, opts = {}) {
-    if (!value) throw new Error("empty barcode value");
-    return cellType === "qrcode" ? renderQrSvg(value, opts) : renderBarcodeSvg(value, opts);
+async function prepareMultiCopy(job, session, data) {
+  const templates = normalizeTemplate(job.templateJson);
+  const viewport = paperViewportPx(getPaperDimensions(templates[0]));
+  const boundPages = [];
+  const layoutsPerPage = [];
+  const codeRenderers = [];
+  for (const t of templates) {
+    const bound = bindData(t, data, job.baseUrl, job.fontBaseUrl);
+    const measurement = await buildHtmlWithCodes({ bound, job, session, data, pageLayouts: [], isMeasurementPass: true });
+    const measurements = await session.measure(measurement.html, viewport);
+    applyTextFitSizes(bound, measurements.fits);
+    const layouts = paginate(bound, normalizeMeasurements(measurements.measurements, bound));
+    const final = await buildHtmlWithCodes({ bound, job, session, data, pageLayouts: layouts, isMeasurementPass: false, baseMap: measurement.map });
+    boundPages.push(bound);
+    layoutsPerPage.push(layouts);
+    codeRenderers.push(final.codeRenderer);
+  }
+  return { boundPages, layoutsPerPage, data, codeRenderers };
+}
+async function buildHtmlWithCodes(input) {
+  const baseMap = input.baseMap ?? /* @__PURE__ */ new Map();
+  if (input.job.codeRenderer) {
+    const html2 = generateHtml(input.bound, input.pageLayouts, input.data, {
+      isMeasurementPass: input.isMeasurementPass,
+      codeRenderer: input.job.codeRenderer
+    });
+    return { html: html2, codeRenderer: input.job.codeRenderer, map: baseMap };
   }
-};
+  const collector = createCollectingCodeRenderer(baseMap);
+  const draft = generateHtml(input.bound, input.pageLayouts, input.data, {
+    isMeasurementPass: input.isMeasurementPass,
+    codeRenderer: collector.renderer
+  });
+  const extra = collector.takeSpecs();
+  const rendered = extra.length > 0 ? await input.session.renderCodes(extra) : /* @__PURE__ */ new Map();
+  const map = mergeCodeMaps(baseMap, rendered);
+  const codeRenderer = map.size > 0 ? createMapCodeRenderer(map) : void 0;
+  if (extra.length === 0) return { html: draft, codeRenderer, map };
+  const html = generateHtml(input.bound, input.pageLayouts, input.data, {
+    isMeasurementPass: input.isMeasurementPass,
+    codeRenderer
+  });
+  return { html, codeRenderer, map };
+}
+
+// src/browser/browser-pagination.ts
+async function renderHtmlPages(template, printData, baseUrl, codeRenderer, options) {
+  const prepared = await prepareDocument(
+    {
+      templateJson: template,
+      printData,
+      baseUrl,
+      fontBaseUrl: options?.fontBaseUrl ?? "",
+      paperHeightMm: options?.paperHeightMm,
+      codeRenderer
+    },
+    createBrowserPrintRuntime()
+  );
+  return {
+    html: prepared.html,
+    pageCount: prepared.pageCount,
+    pageLayouts: prepared.pageLayouts,
+    paperMm: prepared.paperMm,
+    continuous: prepared.continuous,
+    copies: prepared.copies,
+    copyPaperMm: prepared.copyPaperMm
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  EXECUTOR_VERSION,
+  applyTextFit,
   browserCodeRenderer,
-  renderHtmlPages
+  createBrowserPrintRuntime,
+  createIframeDriverFactory,
+  domExecutor,
+  fitTextNode,
+  readContentBottom,
+  readMeasurements,
+  renderCodes,
+  renderHtmlPages,
+  waitReady
 });