@agile-team/mach-report 0.7.0 → 0.9.0

package/dist/vue/config.d.ts

@@ -19,8 +19,18 @@ export interface MachReportMessages {
     pdfWindow: string;
     loading: string;
     empty: string;
+    /** @deprecated 未被组件消费，将在下个大版本移除（保留仅为类型兼容） */
     errorPrefix: string;
     retry: string;
+    /** 搜索框占位文案 */
+    searchPlaceholder: string;
+    /** 搜索命中计数，{cur}/{total} 占位 */
+    matchInfo: string;
+    /** 上/下一个命中 */
+    prevMatch: string;
+    nextMatch: string;
+    /** 缩略图侧栏开关 */
+    thumbnails: string;
 }
 export declare const DEFAULT_MESSAGES: MachReportMessages;
 /** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */
@@ -37,6 +47,8 @@ export interface MachReportTheme {
     btnActiveBg: string;
 }
 export declare const DEFAULT_THEME: MachReportTheme;
+/** 日志通道（默认 console；可注入 noop 静默或上报 collector） */
+export type MachReportLogger = Pick<Console, "warn" | "info">;
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 export interface MachReportDefaults {
     showExport?: boolean;
@@ -48,6 +60,8 @@ export interface MachReportDefaults {
     pdfFontUrl?: string;
     theme?: Partial<MachReportTheme>;
     messages?: Partial<MachReportMessages>;
+    /** 校验告警等内部日志通道（默认 console；静默传 { warn: () => {}, info: () => {} }） */
+    logger?: MachReportLogger;
 }
 export type MachReportPreset = MachReportDefaults;
 export interface MachReportConfig {
@@ -64,7 +78,10 @@ export type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "s
     pdfFontUrl: string;
     theme: MachReportTheme;
     messages: MachReportMessages;
+    logger: MachReportLogger;
 };
+declare const SILENT_LOGGER: MachReportLogger;
+export { SILENT_LOGGER };
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
 /** theme 对象 → CSS 自定义属性 style 对象（注入组件外壳） */
 export declare function themeToCssVars(theme: Partial<MachReportTheme>): CSSProperties;
@@ -76,4 +93,3 @@ type ConfigRef = ComputedRef<MachReportConfig | null>;
 export declare function provideMachReportConfig(overlay: MachReportConfig | MachReportDefaults): void;
 /** 组件内部读取当前生效配置层（未提供时返回 null → 走内置缺省） */
 export declare function useMachReportConfig(): ConfigRef;
-export {};

package/dist/vue/plugin.d.ts

@@ -52,6 +52,10 @@ export declare const MachReportPreview: {
             type: StringConstructor;
             default: undefined;
         };
+        debug: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
         fetcher: {
             type: import('vue').PropType<PlanFetcher | null>;
             default: null;
@@ -80,6 +84,7 @@ export declare const MachReportPreview: {
         params: Record<string, string>;
         furnitureTempId: string;
         tempId: string | string[] | null;
+        debug: boolean;
         showExport: boolean;
         showPrint: boolean;
         showPdfWindow: boolean;
@@ -90,6 +95,7 @@ export declare const MachReportPreview: {
     }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
         viewportRef: HTMLDivElement;
         containerRef: HTMLDivElement;
+        thumbsRef: HTMLElement;
     }, HTMLDivElement, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
@@ -142,6 +148,10 @@ export declare const MachReportPreview: {
             type: StringConstructor;
             default: undefined;
         };
+        debug: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
         fetcher: {
             type: import('vue').PropType<PlanFetcher | null>;
             default: null;
@@ -164,6 +174,7 @@ export declare const MachReportPreview: {
         params: Record<string, string>;
         furnitureTempId: string;
         tempId: string | string[] | null;
+        debug: boolean;
         showExport: boolean;
         showPrint: boolean;
         showPdfWindow: boolean;
@@ -220,6 +231,10 @@ export declare const MachReportPreview: {
         type: StringConstructor;
         default: undefined;
     };
+    debug: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     fetcher: {
         type: import('vue').PropType<PlanFetcher | null>;
         default: null;
@@ -248,6 +263,7 @@ export declare const MachReportPreview: {
     params: Record<string, string>;
     furnitureTempId: string;
     tempId: string | string[] | null;
+    debug: boolean;
     showExport: boolean;
     showPrint: boolean;
     showPdfWindow: boolean;

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const n=require("vue"),i=require("./plugin-Cl-IqCqx.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-CrVeTKu1.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-CrVeTKu1.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){i.machReportPlugin.install(e,o),e.component("MachReportPreview",r)}};exports.MachReportPreview=r;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=c;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const n=require("vue"),i=require("./plugin-9eBK7khj.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-D6VHDUvR.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-D6VHDUvR.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){i.machReportPlugin.install(e,o),e.component("MachReportPreview",r)}};exports.MachReportPreview=r;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=c;

package/dist/vue-async.js

@@ -1,8 +1,8 @@
 import { defineAsyncComponent as e } from "vue";
-import { m as n } from "./plugin-Dp3kKWiQ.js";
-const r = e(() => import("./ReportPreview-DgsOdO4y.js").then((t) => t.j));
+import { m as n } from "./plugin-vi2GjP43.js";
+const r = e(() => import("./ReportPreview-BFTfls8h.js").then((t) => t.k));
 function m() {
-  return import("./ReportPreview-DgsOdO4y.js").then((t) => t.j);
+  return import("./ReportPreview-BFTfls8h.js").then((t) => t.k);
 }
 const p = {
   install(t, o = {}) {

package/dist/vue.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ReportPreview-CrVeTKu1.cjs"),r=require("./plugin-Cl-IqCqx.cjs"),c=require("@agile-team/mach-report"),s=require("vue");function p(R){return async({tempIds:t})=>{if(t.length===0)throw new r.PlanLoadError("缺少报表模板 ID");const a=[];for(const n of t){const o=R[n];if(!o)throw new r.PlanLoadError(`本地模板 ${n} 不存在`);const{plan:E,warnings:i}=c.paginateTemplate(o.template,o.datasets??{});i.length>0&&console.warn("[mach-report] 分页告警:",i),a.push(...E.pages)}return{schemaVersion:"mach-local",pages:a}}}function P(){return s.inject(r.MACH_REPORT_CONTROLLER_KEY,null)}exports.DEFAULT_MESSAGES=e.DEFAULT_MESSAGES;exports.DEFAULT_THEME=e.DEFAULT_THEME;exports.MachReportError=e.MachReportError;exports.ReportPreview=e.ReportPreview;exports.ReportToolbar=e.ReportToolbar;exports.buildPrintDocument=e.buildPrintDocument;exports.defineMachReportConfig=e.defineMachReportConfig;exports.defineMachReportPreset=e.defineMachReportPreset;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=r.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=r.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=r.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=r.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=r.MachReportPreview;exports.PlanLoadError=r.PlanLoadError;exports.createDefaultPdfExporter=r.createDefaultPdfExporter;exports.createFetchRequest=r.createFetchRequest;exports.createJh4jGridPlanFetcher=r.createJh4jGridPlanFetcher;exports.joinTempIds=r.joinTempIds;exports.machReportPlugin=r.machReportPlugin;exports.normalizeTempIds=r.normalizeTempIds;exports.createLocalFetcher=p;exports.useReportPreview=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ReportPreview-D6VHDUvR.cjs"),r=require("./plugin-9eBK7khj.cjs"),c=require("@agile-team/mach-report"),s=require("vue");function p(E){return async({tempIds:t})=>{if(t.length===0)throw new r.PlanLoadError("缺少报表模板 ID");const a=[];for(const n of t){const o=E[n];if(!o)throw new r.PlanLoadError(`本地模板 ${n} 不存在`);const{plan:R,warnings:i}=c.paginateTemplate(o.template,o.datasets??{});i.length>0&&console.warn("[mach-report] 分页告警:",i),a.push(...R.pages)}return{schemaVersion:"mach-local",pages:a}}}function P(){return s.inject(r.MACH_REPORT_CONTROLLER_KEY,null)}exports.DEFAULT_MESSAGES=e.DEFAULT_MESSAGES;exports.DEFAULT_THEME=e.DEFAULT_THEME;exports.MachReportError=e.MachReportError;exports.ReportPreview=e.ReportPreview;exports.ReportToolbar=e.ReportToolbar;exports.SILENT_LOGGER=e.SILENT_LOGGER;exports.buildPrintDocument=e.buildPrintDocument;exports.defineMachReportConfig=e.defineMachReportConfig;exports.defineMachReportPreset=e.defineMachReportPreset;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=r.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=r.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=r.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=r.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=r.MachReportPreview;exports.PlanLoadError=r.PlanLoadError;exports.createDefaultPdfExporter=r.createDefaultPdfExporter;exports.createFetchRequest=r.createFetchRequest;exports.createJh4jGridPlanFetcher=r.createJh4jGridPlanFetcher;exports.joinTempIds=r.joinTempIds;exports.machReportPlugin=r.machReportPlugin;exports.normalizeTempIds=r.normalizeTempIds;exports.createLocalFetcher=p;exports.useReportPreview=P;

package/dist/vue.js

@@ -1,53 +1,55 @@
-import { D as g, a as T, M as _, R as M, b as d, c as C, d as w, e as D, p as F, r as O, t as A, f as H, u as L, g as v, h as x, i as b } from "./ReportPreview-DgsOdO4y.js";
-import { P as s, M as c } from "./plugin-Dp3kKWiQ.js";
-import { a as K, b as Y, c as G, d as I, e as S, f as y, g as N, j as U, m as V, n as q } from "./plugin-Dp3kKWiQ.js";
+import { D as T, a as _, M as g, R as M, b as d, S as C, c as w, d as O, e as D, p as F, f as L, r as A, t as H, g as j, u as v, h as x, i as G, j as S } from "./ReportPreview-BFTfls8h.js";
+import { P as t, M as c } from "./plugin-vi2GjP43.js";
+import { a as I, b as K, c as Y, d as N, e as y, f as U, g as V, j as q, m as z, n as J } from "./plugin-vi2GjP43.js";
 import { paginateTemplate as p } from "@agile-team/mach-report";
-import { inject as R } from "vue";
+import { inject as E } from "vue";
 function h(n) {
   return async ({ tempIds: a }) => {
-    if (a.length === 0) throw new s("缺少报表模板 ID");
+    if (a.length === 0) throw new t("缺少报表模板 ID");
     const r = [];
     for (const o of a) {
       const e = n[o];
-      if (!e) throw new s(`本地模板 ${o} 不存在`);
-      const { plan: i, warnings: t } = p(e.template, e.datasets ?? {});
-      t.length > 0 && console.warn("[mach-report] 分页告警:", t), r.push(...i.pages);
+      if (!e) throw new t(`本地模板 ${o} 不存在`);
+      const { plan: i, warnings: s } = p(e.template, e.datasets ?? {});
+      s.length > 0 && console.warn("[mach-report] 分页告警:", s), r.push(...i.pages);
     }
     return { schemaVersion: "mach-local", pages: r };
   };
 }
 function m() {
-  return R(c, null);
+  return E(c, null);
 }
 export {
-  g as DEFAULT_MESSAGES,
-  T as DEFAULT_THEME,
-  K as MACH_REPORT_CONFIG_KEY,
+  T as DEFAULT_MESSAGES,
+  _ as DEFAULT_THEME,
+  I as MACH_REPORT_CONFIG_KEY,
   c as MACH_REPORT_CONTROLLER_KEY,
-  Y as MACH_REPORT_FETCHER_KEY,
-  G as MACH_REPORT_PDF_EXPORTER_KEY,
-  _ as MachReportError,
-  I as MachReportPreview,
-  s as PlanLoadError,
+  K as MACH_REPORT_FETCHER_KEY,
+  Y as MACH_REPORT_PDF_EXPORTER_KEY,
+  g as MachReportError,
+  N as MachReportPreview,
+  t as PlanLoadError,
   M as ReportPreview,
   d as ReportToolbar,
-  C as buildPrintDocument,
-  S as createDefaultPdfExporter,
-  y as createFetchRequest,
-  N as createJh4jGridPlanFetcher,
+  C as SILENT_LOGGER,
+  w as buildPrintDocument,
+  y as createDefaultPdfExporter,
+  U as createFetchRequest,
+  V as createJh4jGridPlanFetcher,
   h as createLocalFetcher,
-  w as defineMachReportConfig,
+  O as defineMachReportConfig,
   D as defineMachReportPreset,
-  U as joinTempIds,
-  V as machReportPlugin,
-  q as normalizeTempIds,
-  F as provideMachReportConfig,
-  O as resolveConfig,
-  A as themeToCssVars,
-  H as toErrorDetail,
-  L as useMachReportConfig,
-  v as usePageWindow,
-  x as usePrintExport,
+  q as joinTempIds,
+  z as machReportPlugin,
+  J as normalizeTempIds,
+  F as printPlans,
+  L as provideMachReportConfig,
+  A as resolveConfig,
+  H as themeToCssVars,
+  j as toErrorDetail,
+  v as useMachReportConfig,
+  x as usePageWindow,
+  G as usePrintExport,
   m as useReportPreview,
-  b as useZoom
+  S as useZoom
 };

package/dist/xlsx/render-xlsx.d.ts

@@ -0,0 +1,20 @@
+import { default as ExcelJS } from 'exceljs';
+import { RenderPlan } from '../schema/render-plan';
+/**
+ * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
+ * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
+ *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
+ * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
+ *   目标是"财务能直接用的对账表"而非复刻版面）
+ * - 图片/条码/图表跳过并计入 warnings（与 PDF 保真告警同口径）
+ */
+export interface XlsxRenderOptions {
+    /** 工作表命名（默认 "Sheet1" 起序） */
+    sheetName?: (pageIndex: number) => string;
+}
+export interface XlsxRenderResult {
+    workbook: ExcelJS.Workbook;
+    buffer: ExcelJS.Buffer;
+    warnings: string[];
+}
+export declare function renderPlanToXlsx(plan: RenderPlan, options?: XlsxRenderOptions): Promise<XlsxRenderResult>;