@agile-team/mach-report 2.1.0 → 2.3.0

package/dist/pdf.d.cts

@@ -32,6 +32,10 @@ export declare interface FontLoadOptions {
 declare interface GridCell {
     text?: string;
     rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
     children?: PlanComponent[];
     colSpan?: number;
     rowSpan?: number;
@@ -87,6 +91,7 @@ declare interface PlanComponent {
     richParagraphs?: RichParagraph[];
     imageData?: string;
     grid?: PlanGrid;
+    table?: PlanTableFragment;
     style?: ComponentStyle;
     meta?: Record<string, unknown>;
     /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
@@ -102,6 +107,8 @@ declare interface PlanGrid {
 }
 
 declare interface PlanPage {
+    /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
+    layout?: "page" | "wide";
     pageWidthMm: number;
     pageHeightMm: number;
     marginTopMm?: number;
@@ -111,6 +118,19 @@ declare interface PlanPage {
     components: PlanComponent[];
 }
 
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+}
+
 declare interface RenderPlan {
     schemaVersion: string;
     pages: PlanPage[];

package/dist/pdf.d.ts

@@ -32,6 +32,10 @@ export declare interface FontLoadOptions {
 declare interface GridCell {
     text?: string;
     rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
     children?: PlanComponent[];
     colSpan?: number;
     rowSpan?: number;
@@ -87,6 +91,7 @@ declare interface PlanComponent {
     richParagraphs?: RichParagraph[];
     imageData?: string;
     grid?: PlanGrid;
+    table?: PlanTableFragment;
     style?: ComponentStyle;
     meta?: Record<string, unknown>;
     /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
@@ -102,6 +107,8 @@ declare interface PlanGrid {
 }
 
 declare interface PlanPage {
+    /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
+    layout?: "page" | "wide";
     pageWidthMm: number;
     pageHeightMm: number;
     marginTopMm?: number;
@@ -111,6 +118,19 @@ declare interface PlanPage {
     components: PlanComponent[];
 }
 
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+}
+
 declare interface RenderPlan {
     schemaVersion: string;
     pages: PlanPage[];

package/dist/pdf.js

@@ -1,6 +1,6 @@
 import { g as W1 } from "./_commonjsHelpers-DaMA6jEr.js";
-import { h as G1, i as H1, c as So, d as yl, b as ml, L as yu, a as Rd, w as K1 } from "./style-DnmtG7Gl.js";
-import { r as X1 } from "./grid-geometry-Bs8QXz1X.js";
+import { c as So, d as yl, g as G1, L as yu, r as Rd } from "./grid-geometry-CWmJ9c9y.js";
+import { h as H1, i as K1, a as ml, w as X1 } from "./textwrap-BQyrpYSR.js";
 var mu = {}, bl;
 function Kn() {
   return bl || (bl = 1, (function(t) {
@@ -35939,11 +35939,11 @@ async function VE(t, e = {}) {
   r.registerFontkit(Zn);
   const n = [], i = [];
   let a = 0;
-  const o = e.measurer ?? G1, s = await r.embedFont(ao.Helvetica), f = (e.customFontBytes ? await r.embedFont(e.customFontBytes, {
+  const o = e.measurer ?? H1, s = await r.embedFont(ao.Helvetica), f = (e.customFontBytes ? await r.embedFont(e.customFontBytes, {
     subset: !0
   }) : void 0) ?? s, l = /* @__PURE__ */ new Map();
   function h(w, x, T) {
-    return w ? K1(w, x, { fontSizePt: T }, o) : [];
+    return w ? X1(w, x, { fontSizePt: T }, o) : [];
   }
   function d(w) {
     const x = l.get(w);
@@ -35977,7 +35977,7 @@ async function VE(t, e = {}) {
     });
   }
   function g(w, x, T, A, R) {
-    const P = X1(x, T.widthMm, T.heightMm), I = yl(T.style), B = So(T.style), j = oi(B.color, [0.2, 0.2, 0.2]), W = Math.max(0.1, B.widthPt);
+    const P = G1(x, T.widthMm, T.heightMm), I = yl(T.style), B = So(T.style), j = oi(B.color, [0.2, 0.2, 0.2]), W = Math.max(0.1, B.widthPt);
     for (const N of P.cells) {
       const V = N.cell.style?.backgroundColor;
       V && w.drawRectangle({
@@ -36029,7 +36029,7 @@ async function VE(t, e = {}) {
     for (const P of x.components) {
       const I = At(P.leftMm), B = A - At(P.topMm), j = At(P.widthMm), W = At(P.heightMm);
       try {
-        if (H1(P)) {
+        if (K1(P)) {
           const N = await d(P.imageData);
           N ? R.drawImage(N, { x: I, y: B - W, width: j, height: W }) : i.push(
             `page ${w + 1} ${P.nid ?? P.kind}: 图片仅支持 data:image/(png|jpeg) base64，已跳过`

package/dist/{plugin-Bl00j_CP.cjs → plugin-MSh_OhoW.cjs}

@@ -1 +1 @@
-"use strict";var l=Object.create;var n=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var m=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of p(e))!h.call(r,c)&&c!==t&&n(r,c,{get:()=>e[c],enumerable:!(o=s(e,c))||o.enumerable});return r};var C=(r,e,t)=>(t=r!=null?l(d(r)):{},m(e||!r||!r.__esModule?n(t,"default",{value:r,enumerable:!0}):t,r));const E=require("vue"),O=require("./report-params-D1NeY-eR.cjs"),_="mach-report/fetcher",f="mach-report/pdf-exporter",P="mach-report/config",u="mach-report/controller",a=E.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-VHAIfsz1.cjs")).then(r=>r.ReportPreview$1)),T={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const o=e.reports;let c;t=async R=>(c??=import("@agile-team/mach-report").then(({createReportSource:i})=>i(o)),(await c)(R)),t.getParamDefs=R=>O.getReportParamDefs(o,R)}t&&r.provide(_,t),e.pdfExporter&&r.provide(f,e.pdfExporter),r.provide(P,E.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const o=e.config??{defaults:{},presets:{}};return{...o,defaults:{...o.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",a)}};exports.MACH_REPORT_CONFIG_KEY=P;exports.MACH_REPORT_CONTROLLER_KEY=u;exports.MACH_REPORT_FETCHER_KEY=_;exports.MACH_REPORT_PDF_EXPORTER_KEY=f;exports.MachReportPreview=a;exports.machReportPlugin=T;
+"use strict";var l=Object.create;var n=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var d=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var m=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let c of p(e))!h.call(r,c)&&c!==t&&n(r,c,{get:()=>e[c],enumerable:!(o=s(e,c))||o.enumerable});return r};var C=(r,e,t)=>(t=r!=null?l(d(r)):{},m(e||!r||!r.__esModule?n(t,"default",{value:r,enumerable:!0}):t,r));const E=require("vue"),O=require("./report-params-D1gZ1DME.cjs"),_="mach-report/fetcher",f="mach-report/pdf-exporter",P="mach-report/config",u="mach-report/controller",a=E.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-CLENbOCL.cjs")).then(r=>r.ReportPreview$1)),T={install(r,e={}){let t=e.fetcher;if(!t&&e.reports){const o=e.reports;let c;t=async R=>(c??=import("@agile-team/mach-report").then(({createReportSource:i})=>i(o)),(await c)(R)),t.getParamDefs=R=>O.getReportParamDefs(o,R)}t&&r.provide(_,t),e.pdfExporter&&r.provide(f,e.pdfExporter),r.provide(P,E.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const o=e.config??{defaults:{},presets:{}};return{...o,defaults:{...o.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&!r.component("MachReportPreview")&&r.component("MachReportPreview",a)}};exports.MACH_REPORT_CONFIG_KEY=P;exports.MACH_REPORT_CONTROLLER_KEY=u;exports.MACH_REPORT_FETCHER_KEY=_;exports.MACH_REPORT_PDF_EXPORTER_KEY=f;exports.MachReportPreview=a;exports.machReportPlugin=T;

package/dist/{plugin-DVScnZ4C.js → plugin-uoO9VA6O.js}

@@ -1,6 +1,6 @@
 import { defineAsyncComponent as a, computed as s } from "vue";
-import { g as m } from "./report-params-BB85g7mg.js";
-const p = "mach-report/fetcher", l = "mach-report/pdf-exporter", R = "mach-report/config", h = "mach-report/controller", d = a(() => import("./ReportPreview-Dwdsyk9b.js").then((r) => r.s)), _ = {
+import { g as m } from "./report-params-B3Fia6JO.js";
+const p = "mach-report/fetcher", l = "mach-report/pdf-exporter", R = "mach-report/config", h = "mach-report/controller", d = a(() => import("./ReportPreview-CwTGfyTq.js").then((r) => r.s)), _ = {
   install(r, e = {}) {
     let t = e.fetcher;
     if (!t && e.reports) {

package/dist/report-params-B3Fia6JO.js

@@ -0,0 +1,10 @@
+function s(e, f) {
+  const a = /* @__PURE__ */ new Set();
+  return f.flatMap((r) => {
+    const t = Object.prototype.hasOwnProperty.call(e, r) ? e[r] : void 0;
+    return (t?.params ?? (typeof t?.template == "function" ? [] : t?.template.params) ?? []).filter((n) => a.has(n.field) ? !1 : (a.add(n.field), !0));
+  });
+}
+export {
+  s as g
+};

package/dist/report-params-D1gZ1DME.cjs

@@ -0,0 +1 @@
+"use strict";function f(e,s){const a=new Set;return s.flatMap(r=>{const t=Object.prototype.hasOwnProperty.call(e,r)?e[r]:void 0;return(t?.params??(typeof t?.template=="function"?[]:t?.template.params)??[]).filter(n=>a.has(n.field)?!1:(a.add(n.field),!0))})}exports.getReportParamDefs=f;

package/dist/style.css

@@ -1 +1 @@
-.mrp-toolbar[data-v-48cc0980]{display:flex;align-items:center;gap:8px;padding:6px 12px;background:var(--mrp-toolbar-bg, #323639);border-bottom:1px solid var(--mrp-toolbar-border, #22252a);flex:none;flex-wrap:wrap}.mrp-title[data-v-48cc0980]{font-size:13px;font-weight:600;margin-right:8px;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-nav[data-v-48cc0980]{background:transparent;color:var(--mrp-btn-fg, #cfcfcf);border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:2px 8px;font-size:12px;cursor:pointer;white-space:nowrap}.mrp-nav[data-v-48cc0980]:hover:not(:disabled){background:var(--mrp-btn-hover-bg, #414549);color:var(--mrp-btn-hover-fg, #fff)}.mrp-nav[data-v-48cc0980]:disabled{opacity:.4;cursor:not-allowed}.mrp-active[data-v-48cc0980]{background:var(--mrp-btn-active-bg, #2d5fb8);border-color:var(--mrp-btn-active-bg, #2d5fb8);color:#fff}.mrp-pageinfo[data-v-48cc0980]{font-size:12px;min-width:56px;text-align:center;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-spacer[data-v-48cc0980]{flex:1}.mrp-search[data-v-48cc0980]{display:flex;align-items:center;gap:4px}.mrp-search-input[data-v-48cc0980]{background:#22252a;color:#e8e8e8;border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:2px 8px;font-size:12px;width:150px;outline:none}.mrp-search-input[data-v-48cc0980]:focus{border-color:var(--mrp-btn-active-bg, #2d5fb8)}.mrp-search-count[data-v-48cc0980]{font-size:12px;color:var(--mrp-toolbar-fg, #e8e8e8);min-width:42px;text-align:center}.mrp-params[data-v-aafce92d]{display:flex;align-items:flex-end;gap:12px;padding:6px 12px;background:var(--mrp-toolbar-bg, #323639);border-bottom:1px solid var(--mrp-toolbar-border, #22252a);flex:none;flex-wrap:wrap}.mrp-params-title[data-v-aafce92d]{font-size:12px;font-weight:600;color:var(--mrp-toolbar-fg, #e8e8e8);padding-bottom:5px;white-space:nowrap}.mrp-params-grid[data-v-aafce92d]{display:flex;flex-wrap:wrap;gap:8px 12px;flex:1}.mrp-param[data-v-aafce92d]{display:flex;flex-direction:column;gap:2px}.mrp-param-label[data-v-aafce92d]{font-size:11px;color:var(--mrp-toolbar-fg, #e8e8e8);opacity:.85}.mrp-param-star[data-v-aafce92d]{color:#ff7b72;font-style:normal;margin-left:2px}.mrp-param-input[data-v-aafce92d]{background:#22252a;color:#e8e8e8;border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:3px 8px;font-size:12px;min-width:130px;outline:none}.mrp-param-input[data-v-aafce92d]:focus{border-color:var(--mrp-btn-active-bg, #2d5fb8)}.mrp-param-missing .mrp-param-input[data-v-aafce92d]{border-color:#ff7b72}select.mrp-param-input option[data-v-aafce92d]{background:#22252a}.mrp-params-actions[data-v-aafce92d]{display:flex;gap:6px;padding-bottom:1px}.mrp-nav[data-v-aafce92d]{background:transparent;color:var(--mrp-btn-fg, #cfcfcf);border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:4px 14px;font-size:12px;cursor:pointer;white-space:nowrap}.mrp-nav[data-v-aafce92d]:hover{background:var(--mrp-btn-hover-bg, #414549);color:var(--mrp-btn-hover-fg, #fff)}.mrp-param-query[data-v-aafce92d]{background:var(--mrp-btn-active-bg, #2d5fb8);border-color:var(--mrp-btn-active-bg, #2d5fb8);color:#fff}.mach-report-preview[data-v-28af6d98]{--mrp-shell-bg: #525659;--mrp-shell-fg: #e8e8e8;--mrp-toolbar-bg: #323639;--mrp-toolbar-border: #22252a;--mrp-toolbar-fg: #e8e8e8;--mrp-btn-fg: #cfcfcf;--mrp-btn-border: #4a4d52;--mrp-btn-hover-bg: #414549;--mrp-btn-hover-fg: #ffffff;--mrp-btn-active-bg: #2d5fb8;position:relative;display:flex;flex-direction:column;background:var(--mrp-shell-bg);color:var(--mrp-shell-fg);overflow:hidden}.mrp-main[data-v-28af6d98]{display:flex;flex:1;min-height:0}.mrp-body[data-v-28af6d98]{flex:1;overflow:auto;padding:24px;outline:none}.mrp-scale[data-v-28af6d98]{margin:0 auto}.mrp-scale-inner[data-v-28af6d98]{display:flex;flex-direction:column;align-items:center}.mrp-page-holder[data-v-28af6d98]{background:#fff;box-shadow:0 2px 8px #00000059;margin-bottom:var(--v45530c0c);flex:none}.mrp-state[data-v-28af6d98]{padding:40px;text-align:center;color:#bfbfbf;font-size:13px}.mrp-error[data-v-28af6d98]{color:#ff9d9d}.mrp-export-notice[data-v-28af6d98]{padding:7px 12px;font-size:12px;background:#fff0c2;color:#613c00}.mrp-export-error[data-v-28af6d98]{background:#ffe0df;color:#8e1f1f}.mrp-export-progress[data-v-28af6d98]{background:#e7f0ff;color:#1a4d86}.mrp-retry[data-v-28af6d98]{margin-left:12px;background:transparent;color:#8fb7ff;border:1px solid #5a7fbf;border-radius:4px;padding:1px 10px;cursor:pointer}.mrp-overlay[data-v-28af6d98]{position:absolute;inset:0;pointer-events:none}.mrp-page-holder[data-v-28af6d98] mark.mrp-hit{background:#ffe066;color:#7a5c00;border-radius:2px;padding:0 1px}.mrp-thumbs[data-v-28af6d98]{width:140px;flex:none;overflow-y:auto;border-left:1px solid var(--mrp-toolbar-border);background:var(--mrp-toolbar-bg);padding:8px;display:flex;flex-direction:column;gap:8px}.mrp-thumb[data-v-28af6d98]{cursor:pointer;text-align:center}.mrp-thumb-box[data-v-28af6d98]{width:116px;background:#fff;box-shadow:0 1px 4px #0006;overflow:hidden;border:2px solid transparent}.mrp-thumb-active .mrp-thumb-box[data-v-28af6d98]{border-color:var(--mrp-btn-active-bg)}.mrp-thumb-no[data-v-28af6d98]{font-size:11px;color:var(--mrp-toolbar-fg)}.mrp-debug[data-v-28af6d98]{position:absolute;right:8px;bottom:8px;background:#000000c7;color:#7ee787;font:11px/1.6 ui-monospace,monospace;padding:6px 10px;border-radius:6px;pointer-events:none;white-space:pre}
+.mrp-toolbar[data-v-601f8fa8]{display:flex;align-items:center;gap:8px;padding:6px 12px;background:var(--mrp-toolbar-bg, #323639);border-bottom:1px solid var(--mrp-toolbar-border, #22252a);flex:none;flex-wrap:wrap}.mrp-title[data-v-601f8fa8]{font-size:13px;font-weight:600;margin-right:8px;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-nav[data-v-601f8fa8]{background:transparent;color:var(--mrp-btn-fg, #cfcfcf);border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:2px 8px;font-size:12px;cursor:pointer;white-space:nowrap}.mrp-nav[data-v-601f8fa8]:hover:not(:disabled){background:var(--mrp-btn-hover-bg, #414549);color:var(--mrp-btn-hover-fg, #fff)}.mrp-nav[data-v-601f8fa8]:disabled{opacity:.4;cursor:not-allowed}.mrp-active[data-v-601f8fa8]{background:var(--mrp-btn-active-bg, #2d5fb8);border-color:var(--mrp-btn-active-bg, #2d5fb8);color:#fff}.mrp-pageinfo[data-v-601f8fa8]{font-size:12px;min-width:56px;text-align:center;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-spacer[data-v-601f8fa8]{flex:1}.mrp-search[data-v-601f8fa8]{display:flex;align-items:center;gap:4px}.mrp-search-input[data-v-601f8fa8]{background:#22252a;color:#e8e8e8;border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:2px 8px;font-size:12px;width:150px;outline:none}.mrp-search-input[data-v-601f8fa8]:focus{border-color:var(--mrp-btn-active-bg, #2d5fb8)}.mrp-search-count[data-v-601f8fa8]{font-size:12px;color:var(--mrp-toolbar-fg, #e8e8e8);min-width:42px;text-align:center}.mrp-params[data-v-aafce92d]{display:flex;align-items:flex-end;gap:12px;padding:6px 12px;background:var(--mrp-toolbar-bg, #323639);border-bottom:1px solid var(--mrp-toolbar-border, #22252a);flex:none;flex-wrap:wrap}.mrp-params-title[data-v-aafce92d]{font-size:12px;font-weight:600;color:var(--mrp-toolbar-fg, #e8e8e8);padding-bottom:5px;white-space:nowrap}.mrp-params-grid[data-v-aafce92d]{display:flex;flex-wrap:wrap;gap:8px 12px;flex:1}.mrp-param[data-v-aafce92d]{display:flex;flex-direction:column;gap:2px}.mrp-param-label[data-v-aafce92d]{font-size:11px;color:var(--mrp-toolbar-fg, #e8e8e8);opacity:.85}.mrp-param-star[data-v-aafce92d]{color:#ff7b72;font-style:normal;margin-left:2px}.mrp-param-input[data-v-aafce92d]{background:#22252a;color:#e8e8e8;border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:3px 8px;font-size:12px;min-width:130px;outline:none}.mrp-param-input[data-v-aafce92d]:focus{border-color:var(--mrp-btn-active-bg, #2d5fb8)}.mrp-param-missing .mrp-param-input[data-v-aafce92d]{border-color:#ff7b72}select.mrp-param-input option[data-v-aafce92d]{background:#22252a}.mrp-params-actions[data-v-aafce92d]{display:flex;gap:6px;padding-bottom:1px}.mrp-nav[data-v-aafce92d]{background:transparent;color:var(--mrp-btn-fg, #cfcfcf);border:1px solid var(--mrp-btn-border, #4a4d52);border-radius:4px;padding:4px 14px;font-size:12px;cursor:pointer;white-space:nowrap}.mrp-nav[data-v-aafce92d]:hover{background:var(--mrp-btn-hover-bg, #414549);color:var(--mrp-btn-hover-fg, #fff)}.mrp-param-query[data-v-aafce92d]{background:var(--mrp-btn-active-bg, #2d5fb8);border-color:var(--mrp-btn-active-bg, #2d5fb8);color:#fff}.mach-report-preview[data-v-449298a6]{--mrp-shell-bg: #525659;--mrp-shell-fg: #e8e8e8;--mrp-toolbar-bg: #323639;--mrp-toolbar-border: #22252a;--mrp-toolbar-fg: #e8e8e8;--mrp-btn-fg: #cfcfcf;--mrp-btn-border: #4a4d52;--mrp-btn-hover-bg: #414549;--mrp-btn-hover-fg: #ffffff;--mrp-btn-active-bg: #2d5fb8;position:relative;display:flex;flex-direction:column;background:var(--mrp-shell-bg);color:var(--mrp-shell-fg);overflow:hidden}.mrp-main[data-v-449298a6]{display:flex;flex:1;min-height:0}.mrp-body[data-v-449298a6]{flex:1;min-width:0;overflow:auto;padding:24px;outline:none}.mrp-scale[data-v-449298a6]{position:relative;margin:0 auto}.mrp-scale-inner[data-v-449298a6]{position:absolute;left:0;top:0;display:flex;flex-direction:column;align-items:center}.mrp-page-holder[data-v-449298a6]{background:#fff;box-shadow:0 2px 8px #00000059;margin-bottom:var(--v5d32312f);flex:none}.mrp-wide-report .mrp-page-holder[data-v-449298a6]{box-shadow:none}.mrp-state[data-v-449298a6]{padding:40px;text-align:center;color:#bfbfbf;font-size:13px}.mrp-error[data-v-449298a6]{color:#ff9d9d}.mrp-export-notice[data-v-449298a6]{padding:7px 12px;font-size:12px;background:#fff0c2;color:#613c00}.mrp-export-error[data-v-449298a6]{background:#ffe0df;color:#8e1f1f}.mrp-export-progress[data-v-449298a6]{background:#e7f0ff;color:#1a4d86}.mrp-retry[data-v-449298a6]{margin-left:12px;background:transparent;color:#8fb7ff;border:1px solid #5a7fbf;border-radius:4px;padding:1px 10px;cursor:pointer}.mrp-overlay[data-v-449298a6]{position:absolute;inset:0;pointer-events:none}.mrp-page-holder[data-v-449298a6] mark.mrp-hit{background:#ffe066;color:#7a5c00;border-radius:2px;padding:0 1px;scroll-margin:8px}.mrp-thumbs[data-v-449298a6]{width:140px;flex:none;overflow-y:auto;border-left:1px solid var(--mrp-toolbar-border);background:var(--mrp-toolbar-bg);padding:8px;display:flex;flex-direction:column}.mrp-thumb[data-v-449298a6]{cursor:pointer;text-align:center;flex:none;margin-bottom:8px}.mrp-thumb-spacer[data-v-449298a6]{flex:none}.mrp-thumb-box[data-v-449298a6]{box-sizing:border-box;width:116px;background:#fff;box-shadow:0 1px 4px #0006;overflow:hidden;border:2px solid transparent}.mrp-thumb-active .mrp-thumb-box[data-v-449298a6]{border-color:var(--mrp-btn-active-bg)}.mrp-thumb-no[data-v-449298a6]{display:block;margin-top:4px;line-height:16px;font-size:11px;color:var(--mrp-toolbar-fg)}.mrp-debug[data-v-449298a6]{position:absolute;right:8px;bottom:8px;background:#000000c7;color:#7ee787;font:11px/1.6 ui-monospace,monospace;padding:6px 10px;border-radius:6px;pointer-events:none;white-space:pre}

package/dist/textwrap-BQyrpYSR.js

@@ -0,0 +1,117 @@
+import { S as l } from "./grid-geometry-CWmJ9c9y.js";
+const x = l;
+function g(t) {
+  return (t.kind === "image" || t.kind === "barcode" || t.kind === "qrcode" || t.kind === "chart") && !!t.imageData;
+}
+function C(t) {
+  return t.kind === "text" && Array.isArray(t.richParagraphs) && t.richParagraphs.length > 0;
+}
+const m = /[\u3000-\u9fff\uff00-\uffef]/, o = new Uint8Array(128);
+{
+  for (const t of "iljtf.,:;'`|!()[]") o[t.charCodeAt(0)] = 1;
+  for (const t of "mwMW@") o[t.charCodeAt(0)] = 2;
+  for (let t = 48; t <= 57; t++) o[t] = 3;
+  for (let t = 65; t <= 90; t++) o[t] = 4;
+  o[32] = 5;
+}
+const M = [0.54, 0.26, 0.95, 0.59, 0.67, 0.3];
+function w(t) {
+  const e = t.charCodeAt(0);
+  return e < 128 ? M[o[e]] : m.test(t) ? 1 : /[A-Z]/.test(t) ? 0.67 : 0.54;
+}
+const a = {
+  measureMm(t, e) {
+    const { fontSizePt: f, bold: s = !1, letterSpacingPt: u = 0 } = e, i = 25.4 / 72;
+    let r = 0;
+    for (const n of t)
+      r += w(n);
+    return s && (r *= 1.04), (r * f + u * t.length) * i;
+  }
+};
+function S() {
+  return a;
+}
+function E(t, e) {
+  return a.measureMm(t, e);
+}
+function T(t) {
+  let e;
+  return {
+    measureMm(f, s) {
+      if (e === void 0 && (e = t()), !e) return a.measureMm(f, s);
+      const u = s.fontSizePt * 96 / 72;
+      return e.font = `${s.bold ? "bold " : ""}${u}px sans-serif`, e.measureText(f).width * 25.4 / 96;
+    }
+  };
+}
+function A(t, e, f) {
+  const s = [];
+  let u = "", i = 0;
+  const r = () => {
+    u && (s.push({ text: u, widthMm: i, cjk: !1 }), u = "", i = 0);
+  };
+  for (const n of t) {
+    if (n === `
+`) {
+      r(), s.push({ text: `
+`, widthMm: 0, cjk: !1, br: !0 });
+      continue;
+    }
+    if (n === " ") {
+      r(), s.push({ text: n, widthMm: f.measureMm(n, e), cjk: !1, space: !0 });
+      continue;
+    }
+    if (m.test(n)) {
+      r(), s.push({ text: n, widthMm: f.measureMm(n, e), cjk: !0 });
+      continue;
+    }
+    u += n, i += f.measureMm(n, e);
+  }
+  return r(), s;
+}
+function _(t, e, f, s = a) {
+  if (!t) return [""];
+  const u = [];
+  let i = "", r = 0;
+  const n = () => {
+    u.push(i), i = "", r = 0;
+  };
+  for (const c of A(t, f, s)) {
+    if (c.br) {
+      n();
+      continue;
+    }
+    if (r + c.widthMm <= e) {
+      i += c.text, r += c.widthMm;
+      continue;
+    }
+    if (c.space) {
+      n();
+      continue;
+    }
+    if (c.cjk) {
+      i.length > 0 && n(), i = c.text, r = c.widthMm;
+      continue;
+    }
+    if (i.length > 0 && n(), c.widthMm <= e) {
+      i = c.text, r = c.widthMm;
+      continue;
+    }
+    for (const h of c.text) {
+      const d = s.measureMm(h, f);
+      r + d > e && i.length > 0 && n(), i += h, r += d;
+    }
+  }
+  return n(), u;
+}
+export {
+  x as R,
+  C as a,
+  T as b,
+  w as c,
+  S as d,
+  a as h,
+  g as i,
+  E as m,
+  _ as w
+};

package/dist/textwrap-DqiFwAV3.cjs

@@ -0,0 +1,3 @@
+"use strict";const l=require("./grid-geometry-DBH9ExuY.cjs"),w=l.SCHEMA_VERSION_MACH;function A(t){return(t.kind==="image"||t.kind==="barcode"||t.kind==="qrcode"||t.kind==="chart")&&!!t.imageData}function x(t){return t.kind==="text"&&Array.isArray(t.richParagraphs)&&t.richParagraphs.length>0}const m=/[\u3000-\u9fff\uff00-\uffef]/,o=new Uint8Array(128);{for(const t of"iljtf.,:;'`|!()[]")o[t.charCodeAt(0)]=1;for(const t of"mwMW@")o[t.charCodeAt(0)]=2;for(let t=48;t<=57;t++)o[t]=3;for(let t=65;t<=90;t++)o[t]=4;o[32]=5}const g=[.54,.26,.95,.59,.67,.3];function M(t){const e=t.charCodeAt(0);return e<128?g[o[e]]:m.test(t)?1:/[A-Z]/.test(t)?.67:.54}const a={measureMm(t,e){const{fontSizePt:s,bold:c=!1,letterSpacingPt:f=0}=e,i=25.4/72;let n=0;for(const r of t)n+=M(r);return c&&(n*=1.04),(n*s+f*t.length)*i}};function k(){return a}function C(t,e){return a.measureMm(t,e)}function E(t){let e;return{measureMm(s,c){if(e===void 0&&(e=t()),!e)return a.measureMm(s,c);const f=c.fontSizePt*96/72;return e.font=`${c.bold?"bold ":""}${f}px sans-serif`,e.measureText(s).width*25.4/96}}}function S(t,e,s){const c=[];let f="",i=0;const n=()=>{f&&(c.push({text:f,widthMm:i,cjk:!1}),f="",i=0)};for(const r of t){if(r===`
+`){n(),c.push({text:`
+`,widthMm:0,cjk:!1,br:!0});continue}if(r===" "){n(),c.push({text:r,widthMm:s.measureMm(r,e),cjk:!1,space:!0});continue}if(m.test(r)){n(),c.push({text:r,widthMm:s.measureMm(r,e),cjk:!0});continue}f+=r,i+=s.measureMm(r,e)}return n(),c}function T(t,e,s,c=a){if(!t)return[""];const f=[];let i="",n=0;const r=()=>{f.push(i),i="",n=0};for(const u of S(t,s,c)){if(u.br){r();continue}if(n+u.widthMm<=e){i+=u.text,n+=u.widthMm;continue}if(u.space){r();continue}if(u.cjk){i.length>0&&r(),i=u.text,n=u.widthMm;continue}if(i.length>0&&r(),u.widthMm<=e){i=u.text,n=u.widthMm;continue}for(const h of u.text){const d=c.measureMm(h,s);n+d>e&&i.length>0&&r(),i+=h,n+=d}}return r(),f}exports.RENDER_PLAN_SCHEMA_VERSION=w;exports.charWidthEm=M;exports.createCanvasMeasurer=E;exports.createHeuristicMeasurer=k;exports.heuristicMeasurer=a;exports.isImageBackedComponent=A;exports.isRichText=x;exports.measureTextMm=C;exports.wrapText=T;

package/dist/vue/async.d.cts

@@ -69,17 +69,30 @@ declare type DatasetRows = Record<string, Record<string, unknown>[]>;
 declare interface GridCell {
     text?: string;
     rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
     children?: PlanComponent[];
     colSpan?: number;
     rowSpan?: number;
     style?: ComponentStyle;
 }
 
+/** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
+declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
+
 declare interface ListColumn {
     header: string;
     field: string;
     widthMm: number;
     style?: ComponentStyle;
+    /** 内容对齐，优先于 style.align；数值字符串不会自动判为数字。 */
+    align?: ListAlignment;
+    /** 独立的表头对齐，不改变内容对齐。 */
+    headerAlign?: ComponentStyle["align"];
+    /** 独立的表头样式，优先于列表级表头样式。 */
+    headerStyle?: ComponentStyle;
     /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
     format?: ColumnFormat;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
@@ -89,6 +102,10 @@ declare interface ListColumn {
 declare interface ListComponent {
     kind: "list";
     id?: string;
+    /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
+    layout?: "page" | "wide";
+    /** 逻辑表名称，供 Excel Sheet 命名；不额外生成标题组件。 */
+    title?: string;
     leftMm: number;
     topMm: number;
     widthMm: number;
@@ -100,6 +117,11 @@ declare interface ListComponent {
     paddingMm?: number;
     headerEveryPage?: boolean;
     headerBackgroundColor?: string;
+    /** 内容默认对齐，列配置可覆盖；低层模板缺省仍为 left。 */
+    align?: ListAlignment;
+    /** 表头默认对齐，列配置可覆盖。 */
+    headerAlign?: ComponentStyle["align"];
+    headerStyle?: ComponentStyle;
     border?: boolean;
     /** 分组小计（组头/组尾小计/组头防孤行） */
     groupBy?: ListGroupBy;
@@ -159,6 +181,9 @@ declare interface MachReportDefaults {
     messages?: Partial<MachReportMessages>;
     /** 校验告警等内部日志通道（默认 console；静默传 { warn: () => {}, info: () => {} }） */
     logger?: MachReportLogger;
+    preview?: MachReportPreviewOptions;
+    /** Excel 出口配置，按字段继承；不配置使用导出器默认值。 */
+    xlsx?: XlsxRenderOptions;
 }
 
 /**
@@ -215,6 +240,8 @@ declare interface MachReportMessages {
     reset: string;
     /** 必填缺失提示（{label} 占位） */
     paramRequired: string;
+    /** 可选搜索进度文案，旧完整 messages 对象无需新增字段。 */
+    searching?: string;
 }
 
 declare interface MachReportPluginOptions {
@@ -544,6 +571,14 @@ fetcher: PlanFetcher | null;
     };
 });
 
+/** 预览按需调优；默认已经启用正文/缩略图虚拟化及可取消的分片搜索。 */
+declare interface MachReportPreviewOptions {
+    /** 视口前后额外保留的正文页数，默认 1，归一化到 0~10 的整数。 */
+    overscanPages?: number;
+    /** 搜索输入防抖毫秒，默认 200，归一化到 0~2000。 */
+    searchDebounceMs?: number;
+}
+
 /** 只读快照，由组件的同一套状态驱动；无需通过事件另建状态。 */
 declare interface MachReportState {
     readonly loading: boolean;
@@ -617,6 +652,7 @@ declare interface PlanComponent {
     richParagraphs?: RichParagraph[];
     imageData?: string;
     grid?: PlanGrid;
+    table?: PlanTableFragment;
     style?: ComponentStyle;
     meta?: Record<string, unknown>;
     /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
@@ -637,6 +673,8 @@ declare interface PlanGrid {
 }
 
 declare interface PlanPage {
+    /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
+    layout?: "page" | "wide";
     pageWidthMm: number;
     pageHeightMm: number;
     marginTopMm?: number;
@@ -646,6 +684,19 @@ declare interface PlanPage {
     components: PlanComponent[];
 }
 
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+}
+
 /** 预取组件分片（路由 hover / 空闲时调用，正式渲染零等待） */
 export declare function preloadMachReport(): Promise<unknown>;
 
@@ -655,11 +706,12 @@ declare interface RenderPlan {
 }
 
 declare interface ReportDefinition {
-    template: ReportTemplate;
+    /** 静态模板或宿主提供的异步模板加载器；动态模板默认每次重新读取，不缓存版本。 */
+    template: ReportTemplate | ReportTemplateLoader;
     /** 静态数据；load 存在时优先使用 load 的结果。 */
     datasets?: DatasetRows;
     load?: (context: ReportLoadContext) => DatasetRows | Promise<DatasetRows>;
-    /** 覆盖模板参数定义，未提供时自动使用 template.params。 */
+    /** 覆盖模板参数定义；动态模板应在此声明查询面板元数据，避免查询前先请求模板。 */
     params?: ReportParamDef[];
     pagination?: PaginateOptions;
 }
@@ -708,6 +760,8 @@ declare interface ReportTemplate {
     pages: TemplatePage[];
 }
 
+declare type ReportTemplateLoader = (context: ReportLoadContext) => ReportTemplate | Promise<ReportTemplate>;
+
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];
@@ -740,6 +794,8 @@ declare type TemplateComponent = PlanComponent | ListComponent;
 declare interface TemplatePage {
     widthMm: number;
     heightMm: number;
+    /** 宽表保持全列自然宽度，页高只控制内部纵向分段。 */
+    layout?: "page" | "wide";
     marginTopMm?: number;
     marginBottomMm?: number;
     marginLeftMm?: number;
@@ -766,4 +822,23 @@ declare interface TextMeasurer {
     measureMm(text: string, options: TextMeasureOptions): number;
 }
 
+/**
+ * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
+ * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
+ *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
+ * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
+ *   目标是"财务能直接用的对账表"而非复刻版面）
+ * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ */
+declare interface XlsxRenderOptions {
+    /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */
+    sheetName?: (sheetIndex: number) => string;
+    /** auto 默认将 wide 逻辑表合并为连续 Sheet；pages 保留逐页；continuous 要求明确的表来源。 */
+    sheetMode?: "auto" | "pages" | "continuous";
+    /** 宽表或连续表默认 raw，其余默认 text；显式配置可覆盖默认值。 */
+    valueMode?: "text" | "raw";
+    /** 连续表默认不限制打印纸型；显式 A3/A4/A5 仅设置打印适配，不改变 Excel 列宽。 */
+    paperSize?: "auto" | "a3" | "a4" | "a5";
+}
+
 export { }