@agile-team/mach-report 2.2.0 → 2.3.1

package/dist/vue/index.d.ts

@@ -173,13 +173,13 @@ onWarning?: ((message: string) => any) | undefined;
 height: string;
 gapPx: number;
 params: Record<string, string>;
+reportId: string | string[] | null;
 debug: boolean;
 showExport: boolean;
 showPrint: boolean;
 showPdfWindow: boolean;
 showParams: boolean;
 messages: Partial<MachReportMessages>;
-reportId: string | string[] | null;
 autoLoad: boolean;
 preset: string;
 paramDefs: ReportParamDef[] | undefined;
@@ -405,6 +405,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;
@@ -724,13 +728,13 @@ export declare const MachReportPreview: {
     height: string;
     gapPx: number;
     params: Record<string, string>;
+    reportId: string | string[] | null;
     debug: boolean;
     showExport: boolean;
     showPrint: boolean;
     showPdfWindow: boolean;
     showParams: boolean;
     messages: Partial<MachReportMessages>;
-    reportId: string | string[] | null;
     autoLoad: boolean;
     preset: string;
     paramDefs: ReportParamDef[] | undefined;
@@ -825,13 +829,13 @@ export declare const MachReportPreview: {
     height: string;
     gapPx: number;
     params: Record<string, string>;
+    reportId: string | string[] | null;
     debug: boolean;
     showExport: boolean;
     showPrint: boolean;
     showPdfWindow: boolean;
     showParams: boolean;
     messages: Partial<MachReportMessages>;
-    reportId: string | string[] | null;
     autoLoad: boolean;
     preset: string;
     paramDefs: ReportParamDef[] | undefined;
@@ -926,13 +930,13 @@ warning: (message: string) => any;
 height: string;
 gapPx: number;
 params: Record<string, string>;
+reportId: string | string[] | null;
 debug: boolean;
 showExport: boolean;
 showPrint: boolean;
 showPdfWindow: boolean;
 showParams: boolean;
 messages: Partial<MachReportMessages>;
-reportId: string | string[] | null;
 autoLoad: boolean;
 preset: string;
 paramDefs: ReportParamDef[] | undefined;
@@ -1035,6 +1039,7 @@ declare interface PlanComponent {
     richParagraphs?: RichParagraph[];
     imageData?: string;
     grid?: PlanGrid;
+    table?: PlanTableFragment;
     style?: ComponentStyle;
     meta?: Record<string, unknown>;
     /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
@@ -1052,6 +1057,8 @@ declare interface PlanGrid {
     colWidthsMm?: number[];
     rowHeightsMm?: number[];
     gapMm?: number;
+    /** 单元格四边内距；旧静态网格默认 0.5mm，分页列表使用其真实测量内距。 */
+    paddingMm?: number;
 }
 
 export declare class PlanLoadError extends Error {
@@ -1059,6 +1066,8 @@ export declare class PlanLoadError extends Error {
 }
 
 declare interface PlanPage {
+    /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
+    layout?: "page" | "wide";
     pageWidthMm: number;
     pageHeightMm: number;
     marginTopMm?: number;
@@ -1068,6 +1077,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 function print_2(): Promise<void>;
 
 declare interface PrintHtmlResult {
@@ -1244,6 +1266,8 @@ declare type TemplateComponent = PlanComponent | ListComponent;
 declare interface TemplatePage {
     widthMm: number;
     heightMm: number;
+    /** 宽表保持全列自然宽度，页高只控制内部纵向分段。 */
+    layout?: "page" | "wide";
     marginTopMm?: number;
     marginBottomMm?: number;
     marginLeftMm?: number;
@@ -1340,8 +1364,8 @@ export declare function useReportPreview(): MachReportController | null;
 
 /**
  * 缩放状态（transform: scale 方案）：
- * - fit 模式：按视口宽自适应（clamp 0.3~1）
- * - raw 模式：固定百分比
+ * - fit 模式：按视口宽自适应，超宽表也能完整缩入视口
+ * - raw 模式：固定百分比（30%~300%）
  * transform 而非 CSS zoom：标准属性、跨浏览器、零重排。
  */
 export declare function useZoom(getFitInputs: () => {
@@ -1363,11 +1387,13 @@ export declare function useZoom(getFitInputs: () => {
  * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
  */
 declare interface XlsxRenderOptions {
-    /** 工作表命名（默认 "Sheet1" 起序） */
-    sheetName?: (pageIndex: number) => string;
-    /** 默认 text 保留显示文本；raw 使用列表自动保留的原始数值、布尔、文本与空值。 */
+    /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */
+    sheetName?: (sheetIndex: number) => string;
+    /** auto 默认将 wide 逻辑表合并为连续 Sheet；pages 保留逐页；continuous 要求明确的表来源。 */
+    sheetMode?: "auto" | "pages" | "continuous";
+    /** 宽表或连续表默认 raw，其余默认 text；显式配置可覆盖默认值。 */
     valueMode?: "text" | "raw";
-    /** 默认 auto 按计划识别 A3/A4/A5；自定义尺寸回退 A4 并返回告警。 */
+    /** 连续表默认不限制打印纸型；显式 A3/A4/A5 仅设置打印适配，不改变 Excel 列宽。 */
     paperSize?: "auto" | "a3" | "a4" | "a5";
 }
 

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-BMoMUxrw.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-DY0PGGqF.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){r.machReportPlugin.install(e,o)}};exports.MachReportPreview=r.MachReportPreview;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=i;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-2lqgTX26.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-B-mwUSk9.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){r.machReportPlugin.install(e,o)}};exports.MachReportPreview=r.MachReportPreview;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=i;

package/dist/vue-async.js

@@ -1,7 +1,7 @@
-import { m as o } from "./plugin-CAcNe0FT.js";
-import { M as l } from "./plugin-CAcNe0FT.js";
+import { m as o } from "./plugin-5R00MJQs.js";
+import { M as l } from "./plugin-5R00MJQs.js";
 function a() {
-  return import("./ReportPreview-BWrQCj9M.js").then((t) => t.s);
+  return import("./ReportPreview-DKjr4cwO.js").then((t) => t.s);
 }
 const n = {
   install(t, r = {}) {

package/dist/vue.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("@agile-team/mach-report"),e=require("./ReportPreview-DY0PGGqF.cjs"),c=require("./plugin-BMoMUxrw.cjs"),s=require("vue");function p(r){const o=u.createReportSource(r),i=async n=>{if(n.reportIds.length===0)throw new e.PlanLoadError("缺少报表 ID");for(const t of n.reportIds)if(!Object.prototype.hasOwnProperty.call(r,t)||!r[t])throw new e.PlanLoadError(`本地模板 ${t} 不存在`);return o(n)};return i.getParamDefs=o.getParamDefs,i}const l=Object.freeze({loading:!1,hasPlan:!1,pageCount:0,currentPage:1,exporting:null,printing:!1,canExport:!1,canPrint:!1,error:null,pdfFont:Object.freeze({status:"unchecked",fontUrl:""})});function P(){const r=s.shallowRef(null),o=()=>r.value?.state??l,i=Object.freeze({get loading(){return o().loading},get hasPlan(){return o().hasPlan},get pageCount(){return o().pageCount},get currentPage(){return o().currentPage},get exporting(){return o().exporting},get printing(){return o().printing},get canExport(){return o().canExport},get canPrint(){return o().canPrint},get error(){return o().error},get pdfFont(){return o().pdfFont}});function n(){if(!r.value)throw new e.MachReportError("config","报表预览尚未挂载，请在 ready 后调用控制器");return r.value}return{ref(t){const a=t;r.value=a&&typeof a.reload=="function"&&typeof a.print=="function"&&typeof a.exportAs=="function"&&typeof a.openPdfWindow=="function"&&typeof a.gotoPage=="function"&&typeof a.setParams=="function"?a:null},ready:s.computed(()=>r.value!==null),state:i,async checkPdfFont(){const t=n();return t.checkPdfFont?t.checkPdfFont():{status:"unverified",fontUrl:"",message:"旧自定义控制器未提供字体检查，请由宿主确认字体配置"}},async reload(){await n().reload()},async print(){await n().print()},async exportAs(t){await n().exportAs(t)},openPdfWindow(){n().openPdfWindow()},gotoPage(t){n().gotoPage(t)},async setParams(t,a){await n().setParams(t,a)}}}function f(){return s.inject(c.MACH_REPORT_CONTROLLER_KEY,null)}exports.DEFAULT_MESSAGES=e.DEFAULT_MESSAGES;exports.DEFAULT_THEME=e.DEFAULT_THEME;exports.MachReportError=e.MachReportError;exports.PlanLoadError=e.PlanLoadError;exports.ReportParamPanel=e.ReportParamPanel;exports.ReportPreview=e.ReportPreview;exports.ReportToolbar=e.ReportToolbar;exports.SILENT_LOGGER=e.SILENT_LOGGER;exports.buildPrintDocument=e.buildPrintDocument;exports.buildWordHtml=e.buildWordHtml;exports.createDefaultPdfExporter=e.createDefaultPdfExporter;exports.createFetchRequest=e.createFetchRequest;exports.defineMachReportConfig=e.defineMachReportConfig;exports.defineMachReportPreset=e.defineMachReportPreset;exports.joinReportIds=e.joinReportIds;exports.normalizeReportIds=e.normalizeReportIds;exports.printPlans=e.printPlans;exports.provideMachReportConfig=e.provideMachReportConfig;exports.resolveConfig=e.resolveConfig;exports.themeToCssVars=e.themeToCssVars;exports.toErrorDetail=e.toErrorDetail;exports.useMachReportConfig=e.useMachReportConfig;exports.usePageWindow=e.usePageWindow;exports.usePrintExport=e.usePrintExport;exports.useZoom=e.useZoom;exports.MACH_REPORT_CONFIG_KEY=c.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=c.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=c.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=c.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=c.MachReportPreview;exports.machReportPlugin=c.machReportPlugin;exports.createLocalFetcher=p;exports.useMachReport=P;exports.useReportPreview=f;Object.keys(u).forEach(r=>{r!=="default"&&!Object.prototype.hasOwnProperty.call(exports,r)&&Object.defineProperty(exports,r,{enumerable:!0,get:()=>u[r]})});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("@agile-team/mach-report"),e=require("./ReportPreview-B-mwUSk9.cjs"),c=require("./plugin-2lqgTX26.cjs"),s=require("vue");function p(r){const o=u.createReportSource(r),i=async n=>{if(n.reportIds.length===0)throw new e.PlanLoadError("缺少报表 ID");for(const t of n.reportIds)if(!Object.prototype.hasOwnProperty.call(r,t)||!r[t])throw new e.PlanLoadError(`本地模板 ${t} 不存在`);return o(n)};return i.getParamDefs=o.getParamDefs,i}const l=Object.freeze({loading:!1,hasPlan:!1,pageCount:0,currentPage:1,exporting:null,printing:!1,canExport:!1,canPrint:!1,error:null,pdfFont:Object.freeze({status:"unchecked",fontUrl:""})});function P(){const r=s.shallowRef(null),o=()=>r.value?.state??l,i=Object.freeze({get loading(){return o().loading},get hasPlan(){return o().hasPlan},get pageCount(){return o().pageCount},get currentPage(){return o().currentPage},get exporting(){return o().exporting},get printing(){return o().printing},get canExport(){return o().canExport},get canPrint(){return o().canPrint},get error(){return o().error},get pdfFont(){return o().pdfFont}});function n(){if(!r.value)throw new e.MachReportError("config","报表预览尚未挂载，请在 ready 后调用控制器");return r.value}return{ref(t){const a=t;r.value=a&&typeof a.reload=="function"&&typeof a.print=="function"&&typeof a.exportAs=="function"&&typeof a.openPdfWindow=="function"&&typeof a.gotoPage=="function"&&typeof a.setParams=="function"?a:null},ready:s.computed(()=>r.value!==null),state:i,async checkPdfFont(){const t=n();return t.checkPdfFont?t.checkPdfFont():{status:"unverified",fontUrl:"",message:"旧自定义控制器未提供字体检查，请由宿主确认字体配置"}},async reload(){await n().reload()},async print(){await n().print()},async exportAs(t){await n().exportAs(t)},openPdfWindow(){n().openPdfWindow()},gotoPage(t){n().gotoPage(t)},async setParams(t,a){await n().setParams(t,a)}}}function f(){return s.inject(c.MACH_REPORT_CONTROLLER_KEY,null)}exports.DEFAULT_MESSAGES=e.DEFAULT_MESSAGES;exports.DEFAULT_THEME=e.DEFAULT_THEME;exports.MachReportError=e.MachReportError;exports.PlanLoadError=e.PlanLoadError;exports.ReportParamPanel=e.ReportParamPanel;exports.ReportPreview=e.ReportPreview;exports.ReportToolbar=e.ReportToolbar;exports.SILENT_LOGGER=e.SILENT_LOGGER;exports.buildPrintDocument=e.buildPrintDocument;exports.buildWordHtml=e.buildWordHtml;exports.createDefaultPdfExporter=e.createDefaultPdfExporter;exports.createFetchRequest=e.createFetchRequest;exports.defineMachReportConfig=e.defineMachReportConfig;exports.defineMachReportPreset=e.defineMachReportPreset;exports.joinReportIds=e.joinReportIds;exports.normalizeReportIds=e.normalizeReportIds;exports.printPlans=e.printPlans;exports.provideMachReportConfig=e.provideMachReportConfig;exports.resolveConfig=e.resolveConfig;exports.themeToCssVars=e.themeToCssVars;exports.toErrorDetail=e.toErrorDetail;exports.useMachReportConfig=e.useMachReportConfig;exports.usePageWindow=e.usePageWindow;exports.usePrintExport=e.usePrintExport;exports.useZoom=e.useZoom;exports.MACH_REPORT_CONFIG_KEY=c.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=c.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=c.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=c.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=c.MachReportPreview;exports.machReportPlugin=c.machReportPlugin;exports.createLocalFetcher=p;exports.useMachReport=P;exports.useReportPreview=f;Object.keys(u).forEach(r=>{r!=="default"&&!Object.prototype.hasOwnProperty.call(exports,r)&&Object.defineProperty(exports,r,{enumerable:!0,get:()=>u[r]})});

package/dist/vue.js

@@ -1,9 +1,9 @@
 import { createReportSource as c } from "@agile-team/mach-report";
 export * from "@agile-team/mach-report";
-import { P as s, M as i } from "./ReportPreview-BWrQCj9M.js";
-import { D as M, a as T, R as x, b as O, c as F, S as v, d as A, e as D, f as b, g as L, h as S, i as j, j as H, n as I, p as k, k as W, r as Y, t as z, l as G, u as K, m as U, o as N, q } from "./ReportPreview-BWrQCj9M.js";
-import { a as f } from "./plugin-CAcNe0FT.js";
-import { b as X, c as Z, d as $, M as B, m as J } from "./plugin-CAcNe0FT.js";
+import { P as s, M as i } from "./ReportPreview-DKjr4cwO.js";
+import { D as M, a as T, R as x, b as O, c as F, S as v, d as A, e as D, f as b, g as L, h as S, i as j, j as H, n as I, p as k, k as W, r as Y, t as z, l as G, u as K, m as U, o as N, q } from "./ReportPreview-DKjr4cwO.js";
+import { a as f } from "./plugin-5R00MJQs.js";
+import { b as X, c as Z, d as $, M as B, m as J } from "./plugin-5R00MJQs.js";
 import { shallowRef as u, computed as p, inject as l } from "vue";
 function m(n) {
   const t = c(n), a = async (r) => {