@worm-vue3-print/core 1.3.0 → 1.3.1

package/dist/index.cjs

@@ -40,6 +40,7 @@ __export(index_exports, {
   TilingError: () => TilingError,
   WATERMARK_DEFAULTS: () => WATERMARK_DEFAULTS,
   WATERMARK_DENSITY_PRESETS: () => WATERMARK_DENSITY_PRESETS,
+  addNumbers: () => addNumbers,
   applyTextFitSizes: () => applyTextFitSizes,
   avg: () => avg,
   bindData: () => bindData,
@@ -64,6 +65,7 @@ __export(index_exports, {
   createCollectingCodeRenderer: () => createCollectingCodeRenderer,
   createDomHostRuntime: () => createDomHostRuntime,
   createMapCodeRenderer: () => createMapCodeRenderer,
+  divideNumbers: () => divideNumbers,
   elementPositionStyle: () => elementPositionStyle,
   escapeHeightMm: () => escapeHeightMm,
   escapeInlineStyleValue: () => escapeInlineStyleValue,
@@ -91,6 +93,7 @@ __export(index_exports, {
   min: () => min,
   mm: () => mm,
   mmToPx: () => mmToPx,
+  multiplyNumbers: () => multiplyNumbers,
   normalizeMeasurements: () => normalizeMeasurements,
   normalizePrintData: () => normalizePrintData,
   normalizeTemplate: () => normalizeTemplate,
@@ -115,11 +118,16 @@ __export(index_exports, {
   resolveSystemVariables: () => resolveSystemVariables,
   resolveWatermarkLayout: () => resolveWatermarkLayout,
   resolveWatermarkText: () => resolveWatermarkText,
+  round: () => round,
+  roundDown: () => roundDown,
   roundFontSize: () => roundFontSize,
+  roundHalfEven: () => roundHalfEven,
   roundMm: () => roundMm,
+  roundUp: () => roundUp,
   safeEval: () => safeEval,
   setPageIndex: () => setPageIndex,
   setTotalPages: () => setTotalPages,
+  subtractNumbers: () => subtractNumbers,
   sum: () => sum,
   systemVars: () => systemVars,
   tableDesignBottom: () => tableDesignBottom,
@@ -477,6 +485,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,
@@ -542,16 +657,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 ">":
@@ -580,15 +696,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) {
@@ -822,6 +952,34 @@ var systemVars = {
   printTime: () => Date.now()
 };
 
+// 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() {
@@ -847,8 +1005,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);
@@ -893,7 +1062,7 @@ function evaluateTemplate(text, ctx) {
 
 // src/render/data-binder.ts
 function bindData(template, printData, baseUrl, fontBaseUrl) {
-  const data = printData ?? {};
+  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));
@@ -922,7 +1091,12 @@ function bindData(template, printData, baseUrl, fontBaseUrl) {
 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") {
@@ -969,39 +1143,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);
@@ -1011,13 +1171,20 @@ 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,
@@ -1045,16 +1212,35 @@ function makeRenderRow(row, resolve, keepRaw = false) {
   };
 }
 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 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 {
@@ -1064,6 +1250,9 @@ function resolveSystemVariables(now = /* @__PURE__ */ new Date(), page = {}) {
     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);
@@ -2144,6 +2333,13 @@ function barcodeAvailableBoxMm(boxMm, maxMm) {
 }
 
 // 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 = buildFontFaceCss(template.fonts) + buildPageCss(template, options?.pageHeightMm);
   const isMeasure = options?.isMeasurementPass === true;
@@ -2228,22 +2424,25 @@ function renderPage(template, page, pageNum, totalPages, ctx, printData, pageCla
     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));
   const pageInner = `
@@ -2260,6 +2459,39 @@ function renderPage(template, page, pageNum, totalPages, ctx, printData, pageCla
   ${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) {
@@ -2412,7 +2644,7 @@ function matrixCellStyle(cell, opts) {
   }
   return parts.join(";");
 }
-function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOwner = { elementId: "", kind: "b" }) {
+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++) {
@@ -2420,12 +2652,14 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOw
     if (!row) continue;
     const idxAttr = withRowIndex ? ` data-row-index="${r}"` : "";
     const tds = row.cells.map((cell, ci) => ({ cell, ci })).filter(({ cell }) => !cell.merged).map(({ cell, ci }) => {
-      const span = `${cell.rowspan > 1 ? ` rowspan="${cell.rowspan}"` : ""}${cell.colspan > 1 ? ` colspan="${cell.colspan}"` : ""}`;
+      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") {
-        inner = `<div style="width:100%;height:100%;display:flex;align-items:center;justify-content:center;overflow:hidden;">${codeImgHtml(cell.content, cell.cellType, cell, {
-          fallback: esc(cell.content),
+        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,
@@ -2439,9 +2673,9 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOw
         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 = renderTextCellInner(renderRows, r, colIndex, cell, opts, fitOwner, defaultPadding);
+        inner = renderTextCellInner(renderRows, r, colIndex, cell, opts, fitOwner, defaultPadding, ctx);
       }
       return `<td${span} style="${matrixCellStyle(cell, opts)}">${inner}</td>`;
     }).join("");
@@ -2449,9 +2683,9 @@ function renderMatrixRows(renderRows, start, end, opts, withRowIndex, ctx, fitOw
   }
   return trs.join("\n");
 }
-function renderTextCellInner(renderRows, rowIndex, colIndex, cell, opts, fitOwner, defaultPadding) {
+function renderTextCellInner(renderRows, rowIndex, colIndex, cell, opts, fitOwner, defaultPadding, ctx) {
   const fit = resolveCellTextFit(cell);
-  const text = esc(cell.content);
+  const text = esc(resolveCellContent(cell, ctx));
   if (fit === "autoHeight") return text;
   const capMm = cellFitCapMm(renderRows, rowIndex, cell, defaultPadding);
   const nowrap = cell.wordWrap === false;
@@ -2489,7 +2723,7 @@ 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, { elementId: el.id, kind: "b" }) : "";
+  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) : "";
@@ -2510,9 +2744,15 @@ 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, { elementId: el.id, kind: "st" });
 }
@@ -2535,7 +2775,7 @@ 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, { elementId: el.id, kind: "b" }) : "";
+    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) : "";
@@ -3576,6 +3816,7 @@ var TemplateEngine = class {
   TilingError,
   WATERMARK_DEFAULTS,
   WATERMARK_DENSITY_PRESETS,
+  addNumbers,
   applyTextFitSizes,
   avg,
   bindData,
@@ -3600,6 +3841,7 @@ var TemplateEngine = class {
   createCollectingCodeRenderer,
   createDomHostRuntime,
   createMapCodeRenderer,
+  divideNumbers,
   elementPositionStyle,
   escapeHeightMm,
   escapeInlineStyleValue,
@@ -3627,6 +3869,7 @@ var TemplateEngine = class {
   min,
   mm,
   mmToPx,
+  multiplyNumbers,
   normalizeMeasurements,
   normalizePrintData,
   normalizeTemplate,
@@ -3651,11 +3894,16 @@ var TemplateEngine = class {
   resolveSystemVariables,
   resolveWatermarkLayout,
   resolveWatermarkText,
+  round,
+  roundDown,
   roundFontSize,
+  roundHalfEven,
   roundMm,
+  roundUp,
   safeEval,
   setPageIndex,
   setTotalPages,
+  subtractNumbers,
   sum,
   systemVars,
   tableDesignBottom,

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { T as TemplateData, C as CodeRenderer, P as PageLayout, I as MeasuredElement, J as TemplateElement, W as WatermarkOptions, K as PaperMm, L as ViewportPx, N as HeightSource, O as MarginsMm, Q as PdfTargetSpec, X as ScreenshotTargetSpec, R as RawMeasurement, a as CodeSpec, Y as CodeRenderOptions, D as DriverFactory, Z as ExecutorBundle, _ as TileLayout, $ as PrintJob, a0 as PreparedDocument, a1 as RenderPdfResult, M as MultiPageTemplateData, a2 as PrintFontDeclaration } from './driver-CsWkGK4a.cjs';
-export { a3 as ContinuousPaperSize, a4 as EXECUTOR_TARGETS, a5 as ExecutorMethod, a6 as ExecutorTargetKind, a7 as FALLBACK_FONT_STACK, a8 as MAX_BATCH_COPIES, a9 as NormalizedPrintData, aa as PAPER_DIMENSIONS, ab as PageDriver, ac as PageSection, ad as PaperSize, ae as PrintDataInput, af as PrintFontFile, ag as RenderCell, ah as RenderRequest, ai as RenderRow, aj as SheetPaperSize, ak as TILE_DEFAULTS, G as TextFit, al as TilingError, am as TilingIssue, an as TilingIssueCode, ao as TilingOptions, ap as TilingResolveOptions, aq as TilingTemplateInput, ar as buildFontFaceCss, as as computeMaxColumns, at as computeTileLayout, au as escapeInlineStyleValue, av as getPaperDimensions, aw as isContinuousPaper, ax as isContinuousPaperSize, ay as normalizePrintData, az as normalizeTilingOptions, aA as resolveSheetMm, aB as roundMm, aC as tilePosition, aD as toFontFamilyStack, aE as validateTiling } from './driver-CsWkGK4a.cjs';
-import { F as FitFontSize, P as PrintRuntime } from './ports-q934kIC7.cjs';
-export { C as CellFitRowKind, h as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, i as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, j as MeasureResult, k as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, d as resolveElementTextFit, e as resolveShrinkMinFontSize, g as roundFontSize } from './ports-q934kIC7.cjs';
+import { T as TemplateData, C as CodeRenderer, P as PageLayout, I as MeasuredElement, J as TemplateElement, W as WatermarkOptions, K as PaperMm, L as ViewportPx, N as HeightSource, O as MarginsMm, Q as PdfTargetSpec, X as ScreenshotTargetSpec, R as RawMeasurement, a as CodeSpec, Y as CodeRenderOptions, D as DriverFactory, Z as ExecutorBundle, _ as TileLayout, $ as PrintJob, a0 as PreparedDocument, a1 as RenderPdfResult, M as MultiPageTemplateData, a2 as PrintFontDeclaration } from './driver-Dn_YAzO5.cjs';
+export { a3 as ContinuousPaperSize, a4 as EXECUTOR_TARGETS, a5 as ExecutorMethod, a6 as ExecutorTargetKind, a7 as FALLBACK_FONT_STACK, a8 as MAX_BATCH_COPIES, a9 as NormalizedPrintData, aa as PAPER_DIMENSIONS, ab as PageDriver, ac as PageSection, ad as PaperSize, ae as PrintDataInput, af as PrintFontFile, ag as RenderCell, ah as RenderRequest, ai as RenderRow, aj as SheetPaperSize, ak as TILE_DEFAULTS, G as TextFit, al as TilingError, am as TilingIssue, an as TilingIssueCode, ao as TilingOptions, ap as TilingResolveOptions, aq as TilingTemplateInput, ar as buildFontFaceCss, as as computeMaxColumns, at as computeTileLayout, au as escapeInlineStyleValue, av as getPaperDimensions, aw as isContinuousPaper, ax as isContinuousPaperSize, ay as normalizePrintData, az as normalizeTilingOptions, aA as resolveSheetMm, aB as roundMm, aC as tilePosition, aD as toFontFamilyStack, aE as validateTiling } from './driver-Dn_YAzO5.cjs';
+import { F as FitFontSize, P as PrintRuntime } from './ports-Cf5sjwls.cjs';
+export { C as CellFitRowKind, h as DEFAULT_READINESS_MS, D as DEFAULT_SHRINK_MIN_FONT_SIZE_PT, i as DEFAULT_TIMEOUT_MS, M as MIN_SHRINK_FONT_SIZE_PT, j as MeasureResult, k as PrintSession, S as SessionBudget, c as cellFitCapMm, a as cellFitKey, f as floorFontSize, p as parseCellFitKey, r as resolveCellTextFit, d as resolveElementTextFit, e as resolveShrinkMinFontSize, g as roundFontSize } from './ports-Cf5sjwls.cjs';
 
 type TokenType = 'num' | 'str' | 'bool' | 'ident' | 'punc';
 interface Token {
@@ -131,6 +131,25 @@ declare const systemVars: {
     printTime: () => number;
 };
 
+/** ADD(a, b, …)：相加，无法解析为数字的参数按 0 处理 */
+declare function addNumbers(...values: unknown[]): number;
+/** SUB(a, b, …)：首项依次减去后续各项 */
+declare function subtractNumbers(...values: unknown[]): number;
+/** MUL(a, b, …)：相乘 */
+declare function multiplyNumbers(...values: unknown[]): number;
+/** DIV(a, b)：相除，除数为 0 返回 0（不产生 Infinity / NaN） */
+declare function divideNumbers(a: unknown, b: unknown): number;
+/**
+ * ROUND(n, d)：四舍五入到 d 位小数（d 缺省 2；负数修约到整十/整百，如 -2 → 百位）
+ */
+declare function round(value: unknown, digits?: unknown): number;
+/** ROUNDUP / CEIL(n, d)：进一法（远离零方向） */
+declare function roundUp(value: unknown, digits?: unknown): number;
+/** ROUNDDOWN / FLOOR(n, d)：去尾法（朝零方向） */
+declare function roundDown(value: unknown, digits?: unknown): number;
+/** ROUNDBANK(n, d)：四舍六入五成双（GB/T 8170 数值修约规则） */
+declare function roundHalfEven(value: unknown, digits?: unknown): number;
+
 /**
  * 将模板中元素的 formatter 表达式求值为实际值。
  * 返回新的模板对象（深拷贝），不修改原始模板。
@@ -551,4 +570,4 @@ declare class TemplateEngine {
     render(template: string, context: Record<string, any>): string;
 }
 
-export { type ASTNode, type BatchCopyInput, CodeRenderOptions, CodeRenderer, CodeSpec, type CollectingCodeRenderer, DriverFactory, type ElectronPrintToPdfOptions, type EngineOptions, ExecutorBundle, type ExprFunction, FitFontSize, type GenerateOptions, HeightSource, MICROMETERS_PER_INCH, MICROMETERS_PER_MM, MIN_CONTINUOUS_HEIGHT_MM, MM_PER_INCH, MM_PER_PX, MarginsMm, MeasuredElement, type MultiPageCopyInput, type MultiPageDocument, MultiPageTemplateData, PX_PER_MM, PageLayout, PaperMm, type PaperOverride, PdfTargetSpec, type PlaywrightPdfOptions, PreparedDocument, PrintFailure, type PrintFailureCode, PrintFontDeclaration, PrintJob, PrintRuntime, TemplateData as PrintTemplateData, TemplateElement as PrintTemplateElement, RawMeasurement, type RenderFinalPagesOptions, RenderPdfResult, type ResolvePaperInput, type ResolvedWatermark, ScreenshotTargetSpec, type SystemVariableContext, type TemplateAST, TemplateEngine, type TileInput, TileLayout, ViewportPx, WATERMARK_DEFAULTS, WATERMARK_DENSITY_PRESETS, WatermarkOptions, type WatermarkPaper, type WatermarkTile, applyTextFitSizes, avg, bindData, buildBasePageCss, buildPageCss, buildPageGeometryCss, buildPageRuleCss, buildPdfTargetSpec, buildScreenshotTargetSpec, codeSpecKey, compileTemplate, composeBatchHtml, composeContinuousHeight, composeMultiPageDocument, composeTiledHtml, count, createCollectingCodeRenderer, createDomHostRuntime, createMapCodeRenderer, elementPositionStyle, escapeHeightMm, evaluate, evaluateTemplate, formatDate, formatMoney, formatTimestamp, generateHtml, getByPath, ifFn, injectSystemVariables, isMultiPageTemplate, isWatermarkVisible, max, mergeCodeMaps, mergeFontDeclarations, micrometersToMillimeters, millimetersToInches, millimetersToMicrometers, min, mm, mmToPx, normalizeMeasurements, normalizeTemplate, paginate, paperViewportPx, parse, parseTemplate, prepareDocument, pxToMm, renderPdf, renderScreenshot, renderTemplate, renderWatermarkLayerHtml, renderWatermarkTileSvg, resolvePaperMm, resolveSystemVariables, resolveWatermarkLayout, resolveWatermarkText, safeEval, setPageIndex, setTotalPages, sum, systemVars, tableDesignBottom, toElectronPrintToPdfOptions, toPlaywrightPdfOptions, toPrintFailure, toUpperCaseAmount, tokenize, withTimeout };
+export { type ASTNode, type BatchCopyInput, CodeRenderOptions, CodeRenderer, CodeSpec, type CollectingCodeRenderer, DriverFactory, type ElectronPrintToPdfOptions, type EngineOptions, ExecutorBundle, type ExprFunction, FitFontSize, type GenerateOptions, HeightSource, MICROMETERS_PER_INCH, MICROMETERS_PER_MM, MIN_CONTINUOUS_HEIGHT_MM, MM_PER_INCH, MM_PER_PX, MarginsMm, MeasuredElement, type MultiPageCopyInput, type MultiPageDocument, MultiPageTemplateData, PX_PER_MM, PageLayout, PaperMm, type PaperOverride, PdfTargetSpec, type PlaywrightPdfOptions, PreparedDocument, PrintFailure, type PrintFailureCode, PrintFontDeclaration, PrintJob, PrintRuntime, TemplateData as PrintTemplateData, TemplateElement as PrintTemplateElement, RawMeasurement, type RenderFinalPagesOptions, RenderPdfResult, type ResolvePaperInput, type ResolvedWatermark, ScreenshotTargetSpec, type SystemVariableContext, type TemplateAST, TemplateEngine, type TileInput, TileLayout, ViewportPx, WATERMARK_DEFAULTS, WATERMARK_DENSITY_PRESETS, WatermarkOptions, type WatermarkPaper, type WatermarkTile, addNumbers, applyTextFitSizes, avg, bindData, buildBasePageCss, buildPageCss, buildPageGeometryCss, buildPageRuleCss, buildPdfTargetSpec, buildScreenshotTargetSpec, codeSpecKey, compileTemplate, composeBatchHtml, composeContinuousHeight, composeMultiPageDocument, composeTiledHtml, count, createCollectingCodeRenderer, createDomHostRuntime, createMapCodeRenderer, divideNumbers, elementPositionStyle, escapeHeightMm, evaluate, evaluateTemplate, formatDate, formatMoney, formatTimestamp, generateHtml, getByPath, ifFn, injectSystemVariables, isMultiPageTemplate, isWatermarkVisible, max, mergeCodeMaps, mergeFontDeclarations, micrometersToMillimeters, millimetersToInches, millimetersToMicrometers, min, mm, mmToPx, multiplyNumbers, normalizeMeasurements, normalizeTemplate, paginate, paperViewportPx, parse, parseTemplate, prepareDocument, pxToMm, renderPdf, renderScreenshot, renderTemplate, renderWatermarkLayerHtml, renderWatermarkTileSvg, resolvePaperMm, resolveSystemVariables, resolveWatermarkLayout, resolveWatermarkText, round, roundDown, roundHalfEven, roundUp, safeEval, setPageIndex, setTotalPages, subtractNumbers, sum, systemVars, tableDesignBottom, toElectronPrintToPdfOptions, toPlaywrightPdfOptions, toPrintFailure, toUpperCaseAmount, tokenize, withTimeout };