@agile-team/mach-report 0.6.0 → 0.8.0

package/dist/vue/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 结构化错误（code 分类，宿主可按码决定 UX：重试 / 提示 / 降级）。
+ * error 事件契约保持 `(message: string)` 不变，新增第二参数 detail（可选）。
+ */
+export type MachReportErrorCode = "param" | "fetch" | "validate" | "render" | "pdf" | "print" | "config";
+export declare class MachReportError extends Error {
+    readonly code: MachReportErrorCode;
+    readonly cause?: unknown;
+    constructor(code: MachReportErrorCode, message: string, cause?: unknown);
+}
+/** error 事件第二参数的形状（向后兼容：仅监听 message 的旧用法不受影响） */
+export interface MachReportErrorDetail {
+    code: MachReportErrorCode;
+    cause?: unknown;
+}
+export declare function toErrorDetail(error: unknown): MachReportErrorDetail;

package/dist/vue/index.d.cts

@@ -6,6 +6,8 @@ export * from './injection-keys';
 export * from './plugin';
 export * from './config';
 export * from './pdf-exporter';
+export * from './errors';
+export * from './controller';
 export * from './composables/usePageWindow';
 export * from './composables/useZoom';
 export * from './composables/usePrintExport';

package/dist/vue/index.d.ts

@@ -6,6 +6,8 @@ export * from './injection-keys';
 export * from './plugin';
 export * from './config';
 export * from './pdf-exporter';
+export * from './errors';
+export * from './controller';
 export * from './composables/usePageWindow';
 export * from './composables/useZoom';
 export * from './composables/usePrintExport';

package/dist/vue/injection-keys.d.ts

@@ -2,6 +2,7 @@ import { ComputedRef, InjectionKey } from 'vue';
 import { PlanFetcher } from './adapters';
 import { PdfExporter } from './pdf-exporter';
 import { MachReportConfig } from './config';
+import { MachReportController } from './controller';
 /**
  * 注入 key 全部为字符串（而非裸 Symbol）：跨模块联邦边界时宿主与远程
  * 各自打包会生成不同的 Symbol 实例导致 inject 失效；字符串恒等。
@@ -10,3 +11,4 @@ import { MachReportConfig } from './config';
 export declare const MACH_REPORT_FETCHER_KEY: InjectionKey<PlanFetcher>;
 export declare const MACH_REPORT_PDF_EXPORTER_KEY: InjectionKey<PdfExporter>;
 export declare const MACH_REPORT_CONFIG_KEY: InjectionKey<ComputedRef<MachReportConfig | null>>;
+export declare const MACH_REPORT_CONTROLLER_KEY: InjectionKey<MachReportController>;

package/dist/vue/plugin.d.ts

@@ -2,6 +2,280 @@ import { App } from 'vue';
 import { PlanFetcher, HostRequest } from './adapters';
 import { PdfExporter } from './pdf-exporter';
 import { MachReportConfig } from './config';
+/**
+ * 全局组件（懒加载分片：首次渲染才拉取组件与引擎依赖，
+ * 与局部 import 等价——首屏敏感页面零额外成本）
+ */
+export declare const MachReportPreview: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        params: {
+            type: import('vue').PropType<Record<string, string>>;
+            default: () => {};
+        };
+        height: {
+            type: StringConstructor;
+            default: string;
+        };
+        autoLoad: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        showExport: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        showPrint: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        showPdfWindow: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        gapPx: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        messages: {
+            type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
+            default: undefined;
+        };
+        preset: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        debug: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        fetcher: {
+            type: import('vue').PropType<PlanFetcher | null>;
+            default: null;
+        };
+    }>> & Readonly<{
+        onError?: ((message: string, detail?: {
+            code: string;
+            cause?: unknown;
+        } | undefined) => any) | undefined;
+        onLoaded?: ((pageCount: number) => any) | undefined;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        error: (message: string, detail?: {
+            code: string;
+            cause?: unknown;
+        } | undefined) => any;
+        loaded: (pageCount: number) => any;
+    }, import('vue').PublicProps, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        fetcher: PlanFetcher | null;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        viewportRef: HTMLDivElement;
+        containerRef: HTMLDivElement;
+        thumbsRef: HTMLElement;
+    }, HTMLDivElement, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        params: {
+            type: import('vue').PropType<Record<string, string>>;
+            default: () => {};
+        };
+        height: {
+            type: StringConstructor;
+            default: string;
+        };
+        autoLoad: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        showExport: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        showPrint: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        showPdfWindow: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        gapPx: {
+            type: NumberConstructor;
+            default: undefined;
+        };
+        messages: {
+            type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
+            default: undefined;
+        };
+        preset: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        debug: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        fetcher: {
+            type: import('vue').PropType<PlanFetcher | null>;
+            default: null;
+        };
+    }>> & Readonly<{
+        onError?: ((message: string, detail?: {
+            code: string;
+            cause?: unknown;
+        } | undefined) => any) | undefined;
+        onLoaded?: ((pageCount: number) => any) | undefined;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        fetcher: PlanFetcher | null;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    tempId: {
+        type: import('vue').PropType<string | string[] | null>;
+        default: null;
+    };
+    furnitureTempId: {
+        type: StringConstructor;
+        default: string;
+    };
+    params: {
+        type: import('vue').PropType<Record<string, string>>;
+        default: () => {};
+    };
+    height: {
+        type: StringConstructor;
+        default: string;
+    };
+    autoLoad: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showExport: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    showPrint: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    showPdfWindow: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    gapPx: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    messages: {
+        type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
+        default: undefined;
+    };
+    preset: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    debug: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    fetcher: {
+        type: import('vue').PropType<PlanFetcher | null>;
+        default: null;
+    };
+}>> & Readonly<{
+    onError?: ((message: string, detail?: {
+        code: string;
+        cause?: unknown;
+    } | undefined) => any) | undefined;
+    onLoaded?: ((pageCount: number) => any) | undefined;
+}>, {
+    reload: () => Promise<void>;
+    print: () => Promise<void>;
+    exportAs: (format: string) => void;
+    openPdfWindow: () => void;
+    gotoPage: (n: number) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    error: (message: string, detail?: {
+        code: string;
+        cause?: unknown;
+    } | undefined) => any;
+    loaded: (pageCount: number) => any;
+}, string, {
+    height: string;
+    gapPx: number;
+    params: Record<string, string>;
+    furnitureTempId: string;
+    tempId: string | string[] | null;
+    showExport: boolean;
+    showPrint: boolean;
+    showPdfWindow: boolean;
+    messages: Partial<import('./config').MachReportMessages>;
+    autoLoad: boolean;
+    preset: string;
+    debug: boolean;
+    fetcher: PlanFetcher | null;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+});
 export interface MachReportPluginOptions {
     /**
      * 数据面（全部可选——零配置时用全局 fetch 同源直连）：
@@ -17,9 +291,11 @@ export interface MachReportPluginOptions {
     pdfFontUrl?: string;
     /** 自定义 PDF 导出器（缺省用懒加载引擎 /pdf 子路径的默认实现） */
     pdfExporter?: PdfExporter;
+    /** 注册全局组件 <MachReportPreview>（默认 true；懒加载分片不影响首屏） */
+    globalComponent?: boolean;
 }
 /**
- * Vue 插件（零配置可用）：
+ * Vue 插件（零配置可用，对齐 mach-table 的快速集成体验）：
  *
  * ```ts
  * app.use(machReportPlugin)                              // 同源 jh4j 部署，零胶水
@@ -27,7 +303,7 @@ export interface MachReportPluginOptions {
  * app.use(machReportPlugin, { request: axios, config: defineMachReportConfig({...}) })
  * ```
  *
- * 之后业务页面一行使用：`<ReportPreview temp-id="X" />`
+ * 之后业务模板直接写 `<MachReportPreview temp-id="X" />`。
  */
 export declare const machReportPlugin: {
     install(app: App, options?: MachReportPluginOptions): void;

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-BIJxGHZX.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-rBtmbu3W.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-rBtmbu3W.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-7W2Zy3Xc.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-BQE0C_37.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-BQE0C_37.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-DrV67_VW.js";
-const r = e(() => import("./ReportPreview-DWLjYi_p.js").then((t) => t.i));
+import { m as n } from "./plugin-Bc6Px9Lq.js";
+const r = e(() => import("./ReportPreview-D8X75aLV.js").then((t) => t.k));
 function m() {
-  return import("./ReportPreview-DWLjYi_p.js").then((t) => t.i);
+  return import("./ReportPreview-D8X75aLV.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-rBtmbu3W.cjs"),r=require("./plugin-BIJxGHZX.cjs"),E=require("@agile-team/mach-report");function R(c){return async({tempIds:t})=>{if(t.length===0)throw new r.PlanLoadError("缺少报表模板 ID");const a=[];for(const n of t){const o=c[n];if(!o)throw new r.PlanLoadError(`本地模板 ${n} 不存在`);const{plan:s,warnings:i}=E.paginateTemplate(o.template,o.datasets??{});i.length>0&&console.warn("[mach-report] 分页告警:",i),a.push(...s.pages)}return{schemaVersion:"mach-local",pages:a}}}exports.DEFAULT_MESSAGES=e.DEFAULT_MESSAGES;exports.DEFAULT_THEME=e.DEFAULT_THEME;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.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_FETCHER_KEY=r.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=r.MACH_REPORT_PDF_EXPORTER_KEY;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=R;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ReportPreview-BQE0C_37.cjs"),r=require("./plugin-7W2Zy3Xc.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.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,7 +1,8 @@
-import { D as m, a as R, R as P, b as g, c as u, d, e as T, p as _, r as C, t as M, u as w, f as F, g as D, h as A } from "./ReportPreview-DWLjYi_p.js";
-import { P as t } from "./plugin-DrV67_VW.js";
-import { M as H, a as O, b, c as L, d as j, e as v, j as G, m as I, n as K } from "./plugin-DrV67_VW.js";
-import { paginateTemplate as i } from "@agile-team/mach-report";
+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, f as O, r as A, t as H, g as L, u as j, h as v, i as x, j as b } from "./ReportPreview-D8X75aLV.js";
+import { P as t, M as c } from "./plugin-Bc6Px9Lq.js";
+import { a as Y, b as G, c as I, d as S, e as y, f as N, g as U, j as V, m as q, n as z } from "./plugin-Bc6Px9Lq.js";
+import { paginateTemplate as p } from "@agile-team/mach-report";
+import { inject as R } from "vue";
 function h(n) {
   return async ({ tempIds: a }) => {
     if (a.length === 0) throw new t("缺少报表模板 ID");
@@ -9,36 +10,45 @@ function h(n) {
     for (const o of a) {
       const e = n[o];
       if (!e) throw new t(`本地模板 ${o} 不存在`);
-      const { plan: c, warnings: s } = i(e.template, e.datasets ?? {});
-      s.length > 0 && console.warn("[mach-report] 分页告警:", s), r.push(...c.pages);
+      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);
+}
 export {
-  m as DEFAULT_MESSAGES,
-  R as DEFAULT_THEME,
-  H as MACH_REPORT_CONFIG_KEY,
-  O as MACH_REPORT_FETCHER_KEY,
-  b as MACH_REPORT_PDF_EXPORTER_KEY,
+  g as DEFAULT_MESSAGES,
+  T as DEFAULT_THEME,
+  Y as MACH_REPORT_CONFIG_KEY,
+  c as MACH_REPORT_CONTROLLER_KEY,
+  G as MACH_REPORT_FETCHER_KEY,
+  I as MACH_REPORT_PDF_EXPORTER_KEY,
+  _ as MachReportError,
+  S as MachReportPreview,
   t as PlanLoadError,
-  P as ReportPreview,
-  g as ReportToolbar,
-  u as buildPrintDocument,
-  L as createDefaultPdfExporter,
-  j as createFetchRequest,
-  v as createJh4jGridPlanFetcher,
+  M as ReportPreview,
+  d as ReportToolbar,
+  C as buildPrintDocument,
+  y as createDefaultPdfExporter,
+  N as createFetchRequest,
+  U as createJh4jGridPlanFetcher,
   h as createLocalFetcher,
-  d as defineMachReportConfig,
-  T as defineMachReportPreset,
-  G as joinTempIds,
-  I as machReportPlugin,
-  K as normalizeTempIds,
-  _ as provideMachReportConfig,
-  C as resolveConfig,
-  M as themeToCssVars,
-  w as useMachReportConfig,
-  F as usePageWindow,
-  D as usePrintExport,
-  A as useZoom
+  w as defineMachReportConfig,
+  D as defineMachReportPreset,
+  V as joinTempIds,
+  q as machReportPlugin,
+  z as normalizeTempIds,
+  F as printPlans,
+  O as provideMachReportConfig,
+  A as resolveConfig,
+  H as themeToCssVars,
+  L as toErrorDetail,
+  j as useMachReportConfig,
+  v as usePageWindow,
+  x as usePrintExport,
+  m as useReportPreview,
+  b 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>;