@agile-team/mach-report 2.11.2 → 2.12.0

package/dist/validate-BJ5HIWY8.cjs

@@ -0,0 +1 @@
+"use strict";const v=require("./code-options-BUTChiZZ.cjs");function g(e,s,i){e.editable!==void 0&&typeof e.editable!="boolean"&&i.push({path:`${s}.editable`,message:"编辑控制应为布尔值"}),e.valueType!==void 0&&!["text","number","boolean"].includes(e.valueType)&&i.push({path:`${s}.valueType`,message:"编辑类型应为 text、number 或 boolean"})}function A(e,s,i){g(e,s,i),e.indentMm!==void 0&&(typeof e.indentMm!="number"||!Number.isFinite(e.indentMm)||e.indentMm<0)&&i.push({path:`${s}.indentMm`,message:"单元格缩进应为有限非负数"}),e.derived!==void 0&&typeof e.derived!="boolean"&&i.push({path:`${s}.derived`,message:"派生结果标记应为布尔值"}),m(e.source,`${s}.source`,i,!0),e.formula!==void 0&&typeof e.formula!="string"&&i.push({path:`${s}.formula`,message:"单元格公式应为字符串"})}function m(e,s,i,n=!1){if(e===void 0)return;if(!e||typeof e!="object"||Array.isArray(e)){i.push({path:s,message:"业务来源应为对象"});return}const t=e;for(const a of["datasetId",...n?["field"]:[]])(typeof t[a]!="string"||!t[a].trim())&&i.push({path:`${s}.${a}`,message:"业务标识应为非空字符串"});for(const a of["rowKey","revision"]){const o=t[a];o===void 0&&!(n&&a==="rowKey")||typeof o!="string"&&!(typeof o=="number"&&Number.isFinite(o))&&i.push({path:`${s}.${a}`,message:"业务键及修订号应为字符串或有限数字"})}t.sourceToken!==void 0&&typeof t.sourceToken!="string"&&i.push({path:`${s}.sourceToken`,message:"来源令牌应为字符串"})}const b=new Set(["text","image","barcode","qrcode","chart","line","rect","ellipse"]);function d(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function M(e,s,i,n){const t=e[s];(typeof t!="number"||!Number.isFinite(t))&&n.push({path:`${i}.${s}`,message:`应为有限数字，实际 ${JSON.stringify(t)}`})}function w(e,s,i){if(e!==void 0){const n=`${s}.table`;if(!d(e))i.push({path:n,message:"逻辑表来源应为对象"});else{m(e.source,`${n}.source`,i),(typeof e.id!="string"||!e.id.trim())&&i.push({path:`${n}.id`,message:"逻辑表 ID 应为非空字符串"});const t=e.role;["header","body","group-header","subtotal","grand-total"].includes(t)||i.push({path:`${n}.role`,message:"未知逻辑表行角色"});const a=e.rowIndex;(typeof a!="number"||!Number.isInteger(a)||(t==="header"?a!==-1:a<0))&&i.push({path:`${n}.rowIndex`,message:"表头索引应为 -1，内容行索引应为非负整数"}),(!Array.isArray(e.columnKeys)||e.columnKeys.some(o=>typeof o!="string"))&&i.push({path:`${n}.columnKeys`,message:"逻辑列字段应为字符串数组"}),e.layout!==void 0&&e.layout!=="page"&&e.layout!=="wide"&&i.push({path:`${n}.layout`,message:"布局应为 page 或 wide"}),e.title!==void 0&&typeof e.title!="string"&&i.push({path:`${n}.title`,message:"逻辑表名称应为字符串"})}}}function k(e,s,i,n){if(e!==void 0)if(!d(e)||!Array.isArray(e.cells))i.push({path:`${s}.grid.cells`,message:"grid.cells 应为二维数组"});else{const t=e.paddingMm;t!==void 0&&(typeof t!="number"||!Number.isFinite(t)||t<0)&&i.push({path:`${s}.grid.paddingMm`,message:"单元格内距应为有限非负数"}),e.cells.forEach((a,o)=>{if(!Array.isArray(a)){i.push({path:`${s}.grid.cells.${o}`,message:"行应为数组"});return}a.forEach((u,f)=>{if(u==null)return;const r=`${s}.grid.cells.${o}.${f}`;if(!d(u)){i.push({path:r,message:"网格单元格应为对象或 null"});return}A(u,r,i),Array.isArray(u.children)&&u.children.forEach((y,$)=>{h(y,`${s}.grid.cells.${o}.${f}.children.${$}`,i,n)})})})}}function N(e,s,i){e!==void 0&&(Array.isArray(e)?e.forEach((n,t)=>{(!d(n)||!Array.isArray(n.segments))&&i.push({path:`${s}.richParagraphs.${t}`,message:"段落缺少 segments 数组"})}):i.push({path:`${s}.richParagraphs`,message:"richParagraphs 应为数组"}))}function h(e,s,i,n=[]){if(!d(e)){i.push({path:s,message:"组件应为对象"});return}const t=e.kind;typeof t!="string"?i.push({path:`${s}.kind`,message:"组件缺少 kind 字符串"}):b.has(t)||n.push({path:`${s}.kind`,message:`未知组件类型 ${JSON.stringify(t)}，将以兜底方式渲染`});for(const a of["leftMm","topMm","widthMm","heightMm"])M(e,a,s,i);typeof e.leftMm=="number"&&e.leftMm<-100&&i.push({path:`${s}.leftMm`,message:"几何数值异常（leftMm<-100）"});for(const a of["widthMm","heightMm"])typeof e[a]=="number"&&e[a]<0&&i.push({path:`${s}.${a}`,message:"组件尺寸不能为负数"});w(e.table,s,i),E(e.code,t,s,i),e.pageAnchor!==void 0&&!["header","footer"].includes(e.pageAnchor)&&i.push({path:`${s}.pageAnchor`,message:"页面锚点应为 header 或 footer"}),e.lineDirection!==void 0&&!["down","up"].includes(e.lineDirection)&&i.push({path:`${s}.lineDirection`,message:"线段方向应为 down 或 up"}),k(e.grid,s,i,n),N(e.richParagraphs,s,i)}function E(e,s,i,n){if(e!==void 0)for(const t of v.codeOptionIssues(e,s))n.push({path:`${i}.code${t.path?`.${t.path}`:""}`,message:t.message})}function p(e,s,i){if(!d(e))return;e.binding!==void 0&&i.push({path:`${s}.binding`,message:"渲染计划不允许未解析字段绑定"});const n=e.grid;!d(n)||!Array.isArray(n.cells)||n.cells.forEach((t,a)=>{Array.isArray(t)&&t.forEach((o,u)=>{!d(o)||!Array.isArray(o.children)||o.children.forEach((f,r)=>p(f,`${s}.grid.cells.${a}.${u}.children.${r}`,i))})})}function c(e,s,i,n=[]){if(!d(e)){i.push({path:s,message:"页应为对象"});return}const t=e.pageWidthMm,a=e.pageHeightMm;(typeof t!="number"||!Number.isFinite(t)||t<=0)&&i.push({path:`${s}.pageWidthMm`,message:`页宽非法: ${JSON.stringify(t)}`}),(typeof a!="number"||!(a>0&&a<5e3))&&i.push({path:`${s}.pageHeightMm`,message:`页高非法: ${JSON.stringify(a)}`}),e.layout!==void 0&&e.layout!=="page"&&e.layout!=="wide"&&i.push({path:`${s}.layout`,message:"布局应为 page 或 wide"});const o=e.components;Array.isArray(o)?Array.isArray(o)&&o.forEach((u,f)=>{h(u,`${s}.components.${f}`,i,n),p(u,`${s}.components.${f}`,i)}):i.push({path:`${s}.components`,message:"components 应为数组"})}function l(e){const s=[],i=[],n=d(e)?e.pages:void 0;if(d(e)&&e.requiresRecalculation!==void 0&&typeof e.requiresRecalculation!="boolean"&&s.push({path:"$.requiresRecalculation",message:"重算能力要求应为布尔值"}),!Array.isArray(n))s.push({path:"$.pages",message:e==null?"渲染计划为空":"渲染计划缺少 pages 数组"});else{n.forEach((a,o)=>c(a,`$.pages.${o}`,s,i)),n.length>2e3&&i.push({path:"$.pages",message:`页数异常大（${n.length} 页），渲染与打印耗时可能显著增加`});const t=n.reduce((a,o)=>a+(d(o)&&Array.isArray(o.components)?o.components.length:0),0);t>5e4&&i.push({path:"$.pages",message:`组件总数异常大（${t} 个），可能触发浏览器性能限制`})}return{ok:s.length===0,errors:s,warnings:i}}function P(e){const s=l(e);if(!s.ok){const i=s.errors.slice(0,3).map(n=>`${n.path}: ${n.message}`).join("; ");throw new Error(`渲染计划校验失败(${s.errors.length} 处): ${i}`)}return e.pages}exports.assertRenderPlan=P;exports.validateComponent=h;exports.validateEditableMetadata=g;exports.validatePage=c;exports.validateRenderPlan=l;

package/dist/validate-DbgEM1Hh.js

@@ -0,0 +1,163 @@
+import { c as y } from "./code-options-BKXXY7NI.js";
+function $(e, s, i) {
+  e.editable !== void 0 && typeof e.editable != "boolean" && i.push({ path: `${s}.editable`, message: "编辑控制应为布尔值" }), e.valueType !== void 0 && !["text", "number", "boolean"].includes(e.valueType) && i.push({ path: `${s}.valueType`, message: "编辑类型应为 text、number 或 boolean" });
+}
+function l(e, s, i) {
+  $(e, s, i), e.indentMm !== void 0 && (typeof e.indentMm != "number" || !Number.isFinite(e.indentMm) || e.indentMm < 0) && i.push({ path: `${s}.indentMm`, message: "单元格缩进应为有限非负数" }), e.derived !== void 0 && typeof e.derived != "boolean" && i.push({ path: `${s}.derived`, message: "派生结果标记应为布尔值" }), h(e.source, `${s}.source`, i, !0), e.formula !== void 0 && typeof e.formula != "string" && i.push({ path: `${s}.formula`, message: "单元格公式应为字符串" });
+}
+function h(e, s, i, t = !1) {
+  if (e === void 0) return;
+  if (!e || typeof e != "object" || Array.isArray(e)) {
+    i.push({ path: s, message: "业务来源应为对象" });
+    return;
+  }
+  const n = e;
+  for (const a of ["datasetId", ...t ? ["field"] : []])
+    (typeof n[a] != "string" || !n[a].trim()) && i.push({ path: `${s}.${a}`, message: "业务标识应为非空字符串" });
+  for (const a of ["rowKey", "revision"]) {
+    const o = n[a];
+    o === void 0 && !(t && a === "rowKey") || typeof o != "string" && !(typeof o == "number" && Number.isFinite(o)) && i.push({ path: `${s}.${a}`, message: "业务键及修订号应为字符串或有限数字" });
+  }
+  n.sourceToken !== void 0 && typeof n.sourceToken != "string" && i.push({ path: `${s}.sourceToken`, message: "来源令牌应为字符串" });
+}
+const v = /* @__PURE__ */ new Set([
+  "text",
+  "image",
+  "barcode",
+  "qrcode",
+  "chart",
+  "line",
+  "rect",
+  "ellipse"
+]);
+function f(e) {
+  return typeof e == "object" && e !== null && !Array.isArray(e);
+}
+function A(e, s, i, t) {
+  const n = e[s];
+  (typeof n != "number" || !Number.isFinite(n)) && t.push({ path: `${i}.${s}`, message: `应为有限数字，实际 ${JSON.stringify(n)}` });
+}
+function b(e, s, i) {
+  if (e !== void 0) {
+    const t = `${s}.table`;
+    if (!f(e)) i.push({ path: t, message: "逻辑表来源应为对象" });
+    else {
+      h(e.source, `${t}.source`, i), (typeof e.id != "string" || !e.id.trim()) && i.push({ path: `${t}.id`, message: "逻辑表 ID 应为非空字符串" });
+      const n = e.role;
+      ["header", "body", "group-header", "subtotal", "grand-total"].includes(n) || i.push({ path: `${t}.role`, message: "未知逻辑表行角色" });
+      const a = e.rowIndex;
+      (typeof a != "number" || !Number.isInteger(a) || (n === "header" ? a !== -1 : a < 0)) && i.push({ path: `${t}.rowIndex`, message: "表头索引应为 -1，内容行索引应为非负整数" }), (!Array.isArray(e.columnKeys) || e.columnKeys.some((o) => typeof o != "string")) && i.push({ path: `${t}.columnKeys`, message: "逻辑列字段应为字符串数组" }), e.layout !== void 0 && e.layout !== "page" && e.layout !== "wide" && i.push({ path: `${t}.layout`, message: "布局应为 page 或 wide" }), e.title !== void 0 && typeof e.title != "string" && i.push({ path: `${t}.title`, message: "逻辑表名称应为字符串" });
+    }
+  }
+}
+function M(e, s, i, t) {
+  if (e !== void 0)
+    if (!f(e) || !Array.isArray(e.cells))
+      i.push({ path: `${s}.grid.cells`, message: "grid.cells 应为二维数组" });
+    else {
+      const n = e.paddingMm;
+      n !== void 0 && (typeof n != "number" || !Number.isFinite(n) || n < 0) && i.push({ path: `${s}.grid.paddingMm`, message: "单元格内距应为有限非负数" }), e.cells.forEach((a, o) => {
+        if (!Array.isArray(a)) {
+          i.push({ path: `${s}.grid.cells.${o}`, message: "行应为数组" });
+          return;
+        }
+        a.forEach((u, d) => {
+          if (u == null) return;
+          const r = `${s}.grid.cells.${o}.${d}`;
+          if (!f(u)) {
+            i.push({ path: r, message: "网格单元格应为对象或 null" });
+            return;
+          }
+          l(u, r, i), Array.isArray(u.children) && u.children.forEach((p, c) => {
+            g(p, `${s}.grid.cells.${o}.${d}.children.${c}`, i, t);
+          });
+        });
+      });
+    }
+}
+function w(e, s, i) {
+  e !== void 0 && (Array.isArray(e) ? e.forEach((t, n) => {
+    (!f(t) || !Array.isArray(t.segments)) && i.push({ path: `${s}.richParagraphs.${n}`, message: "段落缺少 segments 数组" });
+  }) : i.push({ path: `${s}.richParagraphs`, message: "richParagraphs 应为数组" }));
+}
+function g(e, s, i, t = []) {
+  if (!f(e)) {
+    i.push({ path: s, message: "组件应为对象" });
+    return;
+  }
+  const n = e.kind;
+  typeof n != "string" ? i.push({ path: `${s}.kind`, message: "组件缺少 kind 字符串" }) : v.has(n) || t.push({
+    path: `${s}.kind`,
+    message: `未知组件类型 ${JSON.stringify(n)}，将以兜底方式渲染`
+  });
+  for (const a of ["leftMm", "topMm", "widthMm", "heightMm"])
+    A(e, a, s, i);
+  typeof e.leftMm == "number" && e.leftMm < -100 && i.push({ path: `${s}.leftMm`, message: "几何数值异常（leftMm<-100）" });
+  for (const a of ["widthMm", "heightMm"])
+    typeof e[a] == "number" && e[a] < 0 && i.push({ path: `${s}.${a}`, message: "组件尺寸不能为负数" });
+  b(e.table, s, i), k(e.code, n, s, i), e.pageAnchor !== void 0 && !["header", "footer"].includes(e.pageAnchor) && i.push({ path: `${s}.pageAnchor`, message: "页面锚点应为 header 或 footer" }), e.lineDirection !== void 0 && !["down", "up"].includes(e.lineDirection) && i.push({ path: `${s}.lineDirection`, message: "线段方向应为 down 或 up" }), M(e.grid, s, i, t), w(e.richParagraphs, s, i);
+}
+function k(e, s, i, t) {
+  if (e !== void 0)
+    for (const n of y(e, s)) t.push({ path: `${i}.code${n.path ? `.${n.path}` : ""}`, message: n.message });
+}
+function m(e, s, i) {
+  if (!f(e)) return;
+  e.binding !== void 0 && i.push({ path: `${s}.binding`, message: "渲染计划不允许未解析字段绑定" });
+  const t = e.grid;
+  !f(t) || !Array.isArray(t.cells) || t.cells.forEach((n, a) => {
+    Array.isArray(n) && n.forEach((o, u) => {
+      !f(o) || !Array.isArray(o.children) || o.children.forEach((d, r) => m(d, `${s}.grid.cells.${a}.${u}.children.${r}`, i));
+    });
+  });
+}
+function N(e, s, i, t = []) {
+  if (!f(e)) {
+    i.push({ path: s, message: "页应为对象" });
+    return;
+  }
+  const n = e.pageWidthMm, a = e.pageHeightMm;
+  (typeof n != "number" || !Number.isFinite(n) || n <= 0) && i.push({ path: `${s}.pageWidthMm`, message: `页宽非法: ${JSON.stringify(n)}` }), (typeof a != "number" || !(a > 0 && a < 5e3)) && i.push({ path: `${s}.pageHeightMm`, message: `页高非法: ${JSON.stringify(a)}` }), e.layout !== void 0 && e.layout !== "page" && e.layout !== "wide" && i.push({ path: `${s}.layout`, message: "布局应为 page 或 wide" });
+  const o = e.components;
+  Array.isArray(o) ? Array.isArray(o) && o.forEach((u, d) => {
+    g(u, `${s}.components.${d}`, i, t), m(u, `${s}.components.${d}`, i);
+  }) : i.push({ path: `${s}.components`, message: "components 应为数组" });
+}
+function E(e) {
+  const s = [], i = [], t = f(e) ? e.pages : void 0;
+  if (f(e) && e.requiresRecalculation !== void 0 && typeof e.requiresRecalculation != "boolean" && s.push({ path: "$.requiresRecalculation", message: "重算能力要求应为布尔值" }), !Array.isArray(t))
+    s.push({
+      path: "$.pages",
+      message: e == null ? "渲染计划为空" : "渲染计划缺少 pages 数组"
+    });
+  else {
+    t.forEach((a, o) => N(a, `$.pages.${o}`, s, i)), t.length > 2e3 && i.push({
+      path: "$.pages",
+      message: `页数异常大（${t.length} 页），渲染与打印耗时可能显著增加`
+    });
+    const n = t.reduce(
+      (a, o) => a + (f(o) && Array.isArray(o.components) ? o.components.length : 0),
+      0
+    );
+    n > 5e4 && i.push({
+      path: "$.pages",
+      message: `组件总数异常大（${n} 个），可能触发浏览器性能限制`
+    });
+  }
+  return { ok: s.length === 0, errors: s, warnings: i };
+}
+function I(e) {
+  const s = E(e);
+  if (!s.ok) {
+    const i = s.errors.slice(0, 3).map((t) => `${t.path}: ${t.message}`).join("; ");
+    throw new Error(`渲染计划校验失败(${s.errors.length} 处): ${i}`);
+  }
+  return e.pages;
+}
+export {
+  I as a,
+  N as b,
+  E as c,
+  $ as d,
+  g as v
+};

package/dist/vue/async.d.cts

@@ -36,6 +36,39 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions {
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_2 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_3 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
 /**
  * 列值格式化（声明式、JSON 可序列化）。
  * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
@@ -80,6 +113,52 @@ declare type ColumnFormat_2 = {
     kind: "date";
     pattern?: string;
 };
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+declare type ColumnFormat_3 = {
+    kind: "number";
+    thousands?: boolean;
+    digits?: number;
+} | {
+    kind: "percent";
+    digits?: number;
+} | {
+    kind: "date";
+    pattern?: string;
+};
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding {
+    field: string;
+    format?: ValueFormat;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_2 {
+    field: string;
+    format?: ValueFormat_2;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_3 {
+    field: string;
+    format?: ValueFormat_3;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -394,7 +473,7 @@ declare interface ListColumn_2 {
     /** 独立的表头样式，优先于列表级表头样式。 */
     headerStyle?: ComponentStyle_3;
     /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
-    format?: ColumnFormat_2;
+    format?: ColumnFormat_3;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule_2[];
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
@@ -1007,6 +1086,10 @@ declare interface PdfFontCheckResult {
 /** available 仅表示字体资源可达；实际导出仍会校验文字能否编码。 */
 declare type PdfFontStatus = "unchecked" | "checking" | "available" | "disabled" | "unverified" | "error";
 declare interface PlanComponent {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind;
@@ -1031,6 +1114,10 @@ declare interface PlanComponent {
     fallbackText?: string;
 }
 declare interface PlanComponent_2 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_2;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_2;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_2;
@@ -1055,6 +1142,10 @@ declare interface PlanComponent_2 {
     fallbackText?: string;
 }
 declare interface PlanComponent_3 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_3;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_3;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_3;
@@ -1626,7 +1717,7 @@ declare interface ReportSaveResult {
 declare interface ReportTaskEvent {
     taskId: string;
     correlationId?: string;
-    stage: "query" | "validate" | "layout" | "encode";
+    stage: "query" | "validate" | "layout" | "assets" | "encode";
     status: "started" | "completed" | "failed";
     reportId?: string;
     completed?: number;
@@ -1642,12 +1733,16 @@ declare interface ReportTemplate {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat;
     pages: TemplatePage[];
 }
 declare interface ReportTemplate_2 {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef_2[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat_2;
     pages: TemplatePage_2[];
 }
 /** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
@@ -1669,6 +1764,24 @@ declare interface ReportTemplateProvider {
         signal?: AbortSignal;
     }): Promise<ReportTemplateDocument | undefined>;
 }
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat_2 {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
 declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 declare interface RichParagraph {
     segments: RichSegment[];
@@ -1822,6 +1935,12 @@ declare interface TreeTableOptions_2 {
     /** Bounded leaf-to-ancestor aggregate work; default one million. */
     maxAggregationVisits?: number;
 }
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat = ColumnFormat;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_2 = ColumnFormat_2;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_3 = ColumnFormat_3;
 declare interface XlsxImageOptions {
     /** Decoded bytes per unique embedded image; default 16 MiB. */
     maxImageBytes?: number;

package/dist/vue/async.d.ts

@@ -36,6 +36,39 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions {
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_2 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_3 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
 /**
  * 列值格式化（声明式、JSON 可序列化）。
  * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
@@ -80,6 +113,52 @@ declare type ColumnFormat_2 = {
     kind: "date";
     pattern?: string;
 };
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+declare type ColumnFormat_3 = {
+    kind: "number";
+    thousands?: boolean;
+    digits?: number;
+} | {
+    kind: "percent";
+    digits?: number;
+} | {
+    kind: "date";
+    pattern?: string;
+};
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding {
+    field: string;
+    format?: ValueFormat;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_2 {
+    field: string;
+    format?: ValueFormat_2;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_3 {
+    field: string;
+    format?: ValueFormat_3;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -394,7 +473,7 @@ declare interface ListColumn_2 {
     /** 独立的表头样式，优先于列表级表头样式。 */
     headerStyle?: ComponentStyle_3;
     /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
-    format?: ColumnFormat_2;
+    format?: ColumnFormat_3;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule_2[];
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
@@ -1007,6 +1086,10 @@ declare interface PdfFontCheckResult {
 /** available 仅表示字体资源可达；实际导出仍会校验文字能否编码。 */
 declare type PdfFontStatus = "unchecked" | "checking" | "available" | "disabled" | "unverified" | "error";
 declare interface PlanComponent {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind;
@@ -1031,6 +1114,10 @@ declare interface PlanComponent {
     fallbackText?: string;
 }
 declare interface PlanComponent_2 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_2;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_2;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_2;
@@ -1055,6 +1142,10 @@ declare interface PlanComponent_2 {
     fallbackText?: string;
 }
 declare interface PlanComponent_3 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_3;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_3;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_3;
@@ -1626,7 +1717,7 @@ declare interface ReportSaveResult {
 declare interface ReportTaskEvent {
     taskId: string;
     correlationId?: string;
-    stage: "query" | "validate" | "layout" | "encode";
+    stage: "query" | "validate" | "layout" | "assets" | "encode";
     status: "started" | "completed" | "failed";
     reportId?: string;
     completed?: number;
@@ -1642,12 +1733,16 @@ declare interface ReportTemplate {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat;
     pages: TemplatePage[];
 }
 declare interface ReportTemplate_2 {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef_2[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat_2;
     pages: TemplatePage_2[];
 }
 /** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
@@ -1669,6 +1764,24 @@ declare interface ReportTemplateProvider {
         signal?: AbortSignal;
     }): Promise<ReportTemplateDocument | undefined>;
 }
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat_2 {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
 declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 declare interface RichParagraph {
     segments: RichSegment[];
@@ -1822,6 +1935,12 @@ declare interface TreeTableOptions_2 {
     /** Bounded leaf-to-ancestor aggregate work; default one million. */
     maxAggregationVisits?: number;
 }
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat = ColumnFormat;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_2 = ColumnFormat_2;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_3 = ColumnFormat_3;
 declare interface XlsxImageOptions {
     /** Decoded bytes per unique embedded image; default 16 MiB. */
     maxImageBytes?: number;