@agile-team/mach-report 1.1.1 → 1.2.0

package/dist/plugin-C4qpbdMJ.cjs

@@ -0,0 +1 @@
+"use strict";const E=require("vue");function p(r){return r==null?[]:Array.isArray(r)?r.map(String).filter(e=>e!==""):String(r).split(",").map(e=>e.trim()).filter(e=>e!=="")}function O(r){return p(r).join(",")}class o extends Error{constructor(e){super(e),this.name="PlanLoadError"}}function m(r={}){const{baseUrl:e="",headers:i,credentials:c,timeoutMs:l=3e4}=r,h=e.replace(/\/+$/,"");return async({url:a,method:s,params:t})=>{const d=t&&Object.keys(t).length>0?`?${new URLSearchParams(t)}`:"",n=new AbortController,f=setTimeout(()=>n.abort(),l);let R;try{R=await fetch(`${h}${a}${d}`,{method:s.toUpperCase(),headers:{Accept:"application/json",...i},credentials:c,signal:n.signal})}catch(u){throw u instanceof DOMException&&u.name==="AbortError"?new o(`请求超时(${l}ms): ${a}`):new o(`请求失败(${a}): ${u instanceof Error?u.message:String(u)}`)}finally{clearTimeout(f)}if(!R.ok)throw new o(`HTTP ${R.status} ${a}`);return R.json()}}function P(r){const{request:e,baseUrl:i=""}=r,c=i.replace(/\/+$/,"");return async({tempIds:l,furnitureTempId:h,params:a})=>{if(l.length===0)throw new o("缺少报表模板 ID");const s={};for(const[n,f]of Object.entries(a||{}))n&&n!=="tempId"&&n!=="furnitureTempId"&&f!=null&&f!==""&&(s[n]=String(f));s.tempId=l.join(","),h&&(s.furnitureTempId=h);const t=await e({url:`${c}/report/codePrintReport/gridPlan`,method:"get",params:s});if(t&&t.code!=null&&t.code!==200)throw new o(String(t.message||"预览加载失败"));const d=t?.data?.pages;if(!Array.isArray(d))throw new o("预览响应缺少 pages 数组，请检查 gridPlan 接口契约");return{schemaVersion:"jh4j-compatible",pages:d}}}const _="mach-report/fetcher",g="mach-report/pdf-exporter",T="mach-report/config",C="mach-report/controller",w=E.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-CJLvkTVn.cjs")).then(r=>r.ReportPreview$1)),A={install(r,e={}){const i=e.fetcher??P({request:e.request??m(),baseUrl:e.baseUrl});r.provide(_,i),e.pdfExporter&&r.provide(g,e.pdfExporter),r.provide(T,E.computed(()=>{if(e.pdfFontUrl===void 0)return e.config??null;const c=e.config??{defaults:{},presets:{}};return{...c,defaults:{...c.defaults,pdfFontUrl:e.pdfFontUrl}}})),e.globalComponent!==!1&&r.component("MachReportPreview",w)}};exports.MACH_REPORT_CONFIG_KEY=T;exports.MACH_REPORT_CONTROLLER_KEY=C;exports.MACH_REPORT_FETCHER_KEY=_;exports.MACH_REPORT_PDF_EXPORTER_KEY=g;exports.MachReportPreview=w;exports.PlanLoadError=o;exports.createFetchRequest=m;exports.createJh4jGridPlanFetcher=P;exports.joinTempIds=O;exports.machReportPlugin=A;exports.normalizeTempIds=p;

package/dist/plugin-DcmAPK_K.js

@@ -0,0 +1,85 @@
+import { defineAsyncComponent as m, computed as g } from "vue";
+function E(r) {
+  return r == null ? [] : Array.isArray(r) ? r.map(String).filter((e) => e !== "") : String(r).split(",").map((e) => e.trim()).filter((e) => e !== "");
+}
+function y(r) {
+  return E(r).join(",");
+}
+class c extends Error {
+  constructor(e) {
+    super(e), this.name = "PlanLoadError";
+  }
+}
+function R(r = {}) {
+  const { baseUrl: e = "", headers: i, credentials: o, timeoutMs: l = 3e4 } = r, d = e.replace(/\/+$/, "");
+  return async ({ url: a, method: s, params: t }) => {
+    const h = t && Object.keys(t).length > 0 ? `?${new URLSearchParams(t)}` : "", n = new AbortController(), f = setTimeout(() => n.abort(), l);
+    let p;
+    try {
+      p = await fetch(`${d}${a}${h}`, {
+        method: s.toUpperCase(),
+        headers: { Accept: "application/json", ...i },
+        credentials: o,
+        signal: n.signal
+      });
+    } catch (u) {
+      throw u instanceof DOMException && u.name === "AbortError" ? new c(`请求超时(${l}ms): ${a}`) : new c(`请求失败(${a}): ${u instanceof Error ? u.message : String(u)}`);
+    } finally {
+      clearTimeout(f);
+    }
+    if (!p.ok)
+      throw new c(`HTTP ${p.status} ${a}`);
+    return p.json();
+  };
+}
+function w(r) {
+  const { request: e, baseUrl: i = "" } = r, o = i.replace(/\/+$/, "");
+  return async ({ tempIds: l, furnitureTempId: d, params: a }) => {
+    if (l.length === 0) throw new c("缺少报表模板 ID");
+    const s = {};
+    for (const [n, f] of Object.entries(a || {}))
+      n && n !== "tempId" && n !== "furnitureTempId" && f != null && f !== "" && (s[n] = String(f));
+    s.tempId = l.join(","), d && (s.furnitureTempId = d);
+    const t = await e({
+      url: `${o}/report/codePrintReport/gridPlan`,
+      method: "get",
+      params: s
+    });
+    if (t && t.code != null && t.code !== 200)
+      throw new c(String(t.message || "预览加载失败"));
+    const h = t?.data?.pages;
+    if (!Array.isArray(h))
+      throw new c("预览响应缺少 pages 数组，请检查 gridPlan 接口契约");
+    return {
+      schemaVersion: "jh4j-compatible",
+      pages: h
+    };
+  };
+}
+const P = "mach-report/fetcher", T = "mach-report/pdf-exporter", b = "mach-report/config", A = "mach-report/controller", _ = m(() => import("./ReportPreview-mZiGtf0L.js").then((r) => r.n)), j = {
+  install(r, e = {}) {
+    const i = e.fetcher ?? w({
+      // 网关前缀由 jh4j adapter 统一添加；内置 fetch 不再重复拼接。
+      request: e.request ?? R(),
+      baseUrl: e.baseUrl
+    });
+    r.provide(P, i), e.pdfExporter && r.provide(T, e.pdfExporter), r.provide(b, g(() => {
+      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", _);
+  }
+};
+export {
+  A as M,
+  c as P,
+  b as a,
+  P as b,
+  T as c,
+  _ as d,
+  R as e,
+  w as f,
+  y as j,
+  j as m,
+  E as n
+};

package/dist/style.css

@@ -1 +1 @@
-.mrp-toolbar[data-v-f3aa8dfd]{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-f3aa8dfd]{font-size:13px;font-weight:600;margin-right:8px;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-nav[data-v-f3aa8dfd]{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-f3aa8dfd]:hover:not(:disabled){background:var(--mrp-btn-hover-bg, #414549);color:var(--mrp-btn-hover-fg, #fff)}.mrp-nav[data-v-f3aa8dfd]:disabled{opacity:.4;cursor:not-allowed}.mrp-active[data-v-f3aa8dfd]{background:var(--mrp-btn-active-bg, #2d5fb8);border-color:var(--mrp-btn-active-bg, #2d5fb8);color:#fff}.mrp-pageinfo[data-v-f3aa8dfd]{font-size:12px;min-width:56px;text-align:center;color:var(--mrp-toolbar-fg, #e8e8e8)}.mrp-spacer[data-v-f3aa8dfd]{flex:1}.mrp-search[data-v-f3aa8dfd]{display:flex;align-items:center;gap:4px}.mrp-search-input[data-v-f3aa8dfd]{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-f3aa8dfd]:focus{border-color:var(--mrp-btn-active-bg, #2d5fb8)}.mrp-search-count[data-v-f3aa8dfd]{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-4648d204]{--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-4648d204]{display:flex;flex:1;min-height:0}.mrp-body[data-v-4648d204]{flex:1;overflow:auto;padding:24px;outline:none}.mrp-scale[data-v-4648d204]{margin:0 auto}.mrp-scale-inner[data-v-4648d204]{display:flex;flex-direction:column;align-items:center}.mrp-page-holder[data-v-4648d204]{background:#fff;box-shadow:0 2px 8px #00000059;margin-bottom:var(--db73374c);flex:none}.mrp-state[data-v-4648d204]{padding:40px;text-align:center;color:#bfbfbf;font-size:13px}.mrp-error[data-v-4648d204]{color:#ff9d9d}.mrp-retry[data-v-4648d204]{margin-left:12px;background:transparent;color:#8fb7ff;border:1px solid #5a7fbf;border-radius:4px;padding:1px 10px;cursor:pointer}.mrp-overlay[data-v-4648d204]{position:absolute;inset:0;pointer-events:none}.mrp-page-holder[data-v-4648d204] mark.mrp-hit{background:#ffe066;color:#7a5c00;border-radius:2px;padding:0 1px}.mrp-thumbs[data-v-4648d204]{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-4648d204]{cursor:pointer;text-align:center}.mrp-thumb-box[data-v-4648d204]{width:116px;background:#fff;box-shadow:0 1px 4px #0006;overflow:hidden;border:2px solid transparent}.mrp-thumb-active .mrp-thumb-box[data-v-4648d204]{border-color:var(--mrp-btn-active-bg)}.mrp-thumb-no[data-v-4648d204]{font-size:11px;color:var(--mrp-toolbar-fg)}.mrp-debug[data-v-4648d204]{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-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-a0054844]{--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-a0054844]{display:flex;flex:1;min-height:0}.mrp-body[data-v-a0054844]{flex:1;overflow:auto;padding:24px;outline:none}.mrp-scale[data-v-a0054844]{margin:0 auto}.mrp-scale-inner[data-v-a0054844]{display:flex;flex-direction:column;align-items:center}.mrp-page-holder[data-v-a0054844]{background:#fff;box-shadow:0 2px 8px #00000059;margin-bottom:var(--a2716f8c);flex:none}.mrp-state[data-v-a0054844]{padding:40px;text-align:center;color:#bfbfbf;font-size:13px}.mrp-error[data-v-a0054844]{color:#ff9d9d}.mrp-export-notice[data-v-a0054844]{padding:7px 12px;font-size:12px;background:#fff0c2;color:#613c00}.mrp-export-error[data-v-a0054844]{background:#ffe0df;color:#8e1f1f}.mrp-export-progress[data-v-a0054844]{background:#e7f0ff;color:#1a4d86}.mrp-retry[data-v-a0054844]{margin-left:12px;background:transparent;color:#8fb7ff;border:1px solid #5a7fbf;border-radius:4px;padding:1px 10px;cursor:pointer}.mrp-overlay[data-v-a0054844]{position:absolute;inset:0;pointer-events:none}.mrp-page-holder[data-v-a0054844] mark.mrp-hit{background:#ffe066;color:#7a5c00;border-radius:2px;padding:0 1px}.mrp-thumbs[data-v-a0054844]{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-a0054844]{cursor:pointer;text-align:center}.mrp-thumb-box[data-v-a0054844]{width:116px;background:#fff;box-shadow:0 1px 4px #0006;overflow:hidden;border:2px solid transparent}.mrp-thumb-active .mrp-thumb-box[data-v-a0054844]{border-color:var(--mrp-btn-active-bg)}.mrp-thumb-no[data-v-a0054844]{font-size:11px;color:var(--mrp-toolbar-fg)}.mrp-debug[data-v-a0054844]{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/vue/ReportPreview.d.ts

@@ -103,6 +103,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         cause?: unknown;
     } | undefined) => any;
     loaded: (pageCount: number) => any;
+    warning: (message: string) => any;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
     tempId: {
         type: PropType<string | string[] | null>;
@@ -177,6 +178,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         cause?: unknown;
     } | undefined) => any) | undefined;
     onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
 }>, {
     height: string;
     gapPx: number;

package/dist/vue/ReportToolbar.d.ts

@@ -17,7 +17,7 @@ type __VLS_Props = {
     thumbsVisible: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    export: (format: "html" | "png" | "pdf" | "word") => any;
+    export: (format: "html" | "png" | "pdf" | "xlsx" | "word") => any;
     zoom: (mode: number | "fit") => any;
     print: () => any;
     goto: (page: number) => any;
@@ -27,7 +27,7 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "search-toggle": () => any;
     "thumbs-toggle": () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onExport?: ((format: "html" | "png" | "pdf" | "word") => any) | undefined;
+    onExport?: ((format: "html" | "png" | "pdf" | "xlsx" | "word") => any) | undefined;
     onZoom?: ((mode: number | "fit") => any) | undefined;
     onPrint?: (() => any) | undefined;
     onGoto?: ((page: number) => any) | undefined;

package/dist/vue/async.d.cts

@@ -81,6 +81,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -96,6 +97,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any;
         loaded: (pageCount: number) => any;
+        warning: (message: string) => any;
     }, import('vue').PublicProps, {
         height: string;
         gapPx: number;
@@ -190,6 +192,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -286,6 +289,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any) | undefined;
     onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
 }>, {
     reload: () => Promise<void>;
     print: () => Promise<void>;
@@ -301,6 +305,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any;
     loaded: (pageCount: number) => any;
+    warning: (message: string) => any;
 }, string, {
     height: string;
     gapPx: number;

package/dist/vue/async.d.ts

@@ -81,6 +81,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -96,6 +97,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any;
         loaded: (pageCount: number) => any;
+        warning: (message: string) => any;
     }, import('vue').PublicProps, {
         height: string;
         gapPx: number;
@@ -190,6 +192,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -286,6 +289,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any) | undefined;
     onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
 }>, {
     reload: () => Promise<void>;
     print: () => Promise<void>;
@@ -301,6 +305,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any;
     loaded: (pageCount: number) => any;
+    warning: (message: string) => any;
 }, string, {
     height: string;
     gapPx: number;

package/dist/vue/composables/usePageWindow.d.ts

@@ -9,7 +9,7 @@ import { PlanPage, RenderPlan } from '@agile-team/mach-report';
  */
 export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<number>, options?: {
     pxPerMm?: number;
-    gapPx?: number;
+    gapPx?: number | Ref<number>;
 }): {
     contentSize: import('vue').ComputedRef<{
         w: number;

package/dist/vue/composables/usePrintExport.d.ts

@@ -5,7 +5,7 @@ interface PrintHtmlResult {
     head: string;
     pageChunks: string[];
 }
-/** 构建打印文档：head（含按尺寸分组的 @page 规则）+ 每页一段 HTML（供流式写入） */
+/** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
 export declare function buildPrintDocument(p: RenderPlan): PrintHtmlResult;
 /**
  * 批量打印（多单连打）：把多份计划合并为一个打印文档——
@@ -27,6 +27,8 @@ export declare function buildWordHtml(p: RenderPlan): {
 export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     getPdfExporter: () => PdfExporter;
     onError: (message: string, code?: string) => void;
+    onWarning?: (message: string) => void;
+    onBusy?: (format: string | null) => void;
 }): {
     print: () => Promise<void>;
     exportAs: (format: string) => void;

package/dist/vue/config.d.ts

@@ -15,8 +15,11 @@ export interface MachReportMessages {
     fitWidth: string;
     exportHtml: string;
     exportPdf: string;
+    exportExcel: string;
     exportImage: string;
     exportWord: string;
+    /** 导出进行中提示，{format} 占位 */
+    exporting: string;
     print: string;
     pdfWindow: string;
     loading: string;

package/dist/vue/controller.d.ts

@@ -5,7 +5,8 @@
 export interface MachReportController {
     reload(): Promise<void>;
     print(): Promise<void>;
-    exportAs(format: "html" | "pdf" | string): void;
+    /** 支持 html/pdf/xlsx/png/word（excel/image/doc 为兼容别名）；未知格式报 export 错误。 */
+    exportAs(format: string): void;
     openPdfWindow(): void;
     gotoPage(page: number): void;
     /** 编程式设置参数并查询（合并进面板值；opts.reload=false 仅设值不重载） */

package/dist/vue/pdf-exporter.d.ts

@@ -1,6 +1,6 @@
 import { RenderPlan } from '@agile-team/mach-report';
-/** PDF 导出器：RenderPlan → PDF 字节。宿主可注入自定义实现（自研后端/Worker 化等）。 */
-export type PdfExporter = (plan: RenderPlan) => Promise<Uint8Array>;
+/** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
+export type PdfExporter = (plan: RenderPlan, onWarning?: (message: string) => void) => Promise<Uint8Array>;
 export interface DefaultPdfExporterOptions {
     /** 中文字体 URL（浏览器 fetch）；空串跳过字体加载（西文报表） */
     fontUrl: string;

package/dist/vue/plugin.d.ts

@@ -74,6 +74,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -89,6 +90,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any;
         loaded: (pageCount: number) => any;
+        warning: (message: string) => any;
     }, import('vue').PublicProps, {
         height: string;
         gapPx: number;
@@ -183,6 +185,7 @@ export declare const MachReportPreview: {
             cause?: unknown;
         } | undefined) => any) | undefined;
         onLoaded?: ((pageCount: number) => any) | undefined;
+        onWarning?: ((message: string) => any) | undefined;
     }>, {
         reload: () => Promise<void>;
         print: () => Promise<void>;
@@ -279,6 +282,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any) | undefined;
     onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
 }>, {
     reload: () => Promise<void>;
     print: () => Promise<void>;
@@ -294,6 +298,7 @@ export declare const MachReportPreview: {
         cause?: unknown;
     } | undefined) => any;
     loaded: (pageCount: number) => any;
+    warning: (message: string) => any;
 }, string, {
     height: string;
     gapPx: number;

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-DxneRya8.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-kNbuSmbL.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-kNbuSmbL.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-C4qpbdMJ.cjs"),r=n.defineAsyncComponent(()=>Promise.resolve().then(()=>require("./ReportPreview-CJLvkTVn.cjs")).then(e=>e.ReportPreview$1));function c(){return Promise.resolve().then(()=>require("./ReportPreview-CJLvkTVn.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,17 +1,17 @@
-import { defineAsyncComponent as e } from "vue";
-import { m as n } from "./plugin-CVYs7wAj.js";
-const r = e(() => import("./ReportPreview-Do-x4E3Z.js").then((t) => t.m));
-function c() {
-  return import("./ReportPreview-Do-x4E3Z.js").then((t) => t.m);
+import { defineAsyncComponent as o } from "vue";
+import { m as e } from "./plugin-DcmAPK_K.js";
+const r = o(() => import("./ReportPreview-mZiGtf0L.js").then((t) => t.n));
+function m() {
+  return import("./ReportPreview-mZiGtf0L.js").then((t) => t.n);
 }
 const p = {
-  install(t, o = {}) {
-    n.install(t, o), t.component("MachReportPreview", r);
+  install(t, n = {}) {
+    e.install(t, n), t.component("MachReportPreview", r);
   }
 };
 export {
   r as MachReportPreview,
   p as default,
   p as machReportAsyncPlugin,
-  c as preloadMachReport
+  m as preloadMachReport
 };

package/dist/vue.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ReportPreview-kNbuSmbL.cjs"),r=require("./plugin-DxneRya8.cjs"),c=require("@agile-team/mach-report"),s=require("vue");function l(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.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.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=l;exports.useReportPreview=P;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./ReportPreview-CJLvkTVn.cjs"),r=require("./plugin-C4qpbdMJ.cjs"),c=require("@agile-team/mach-report"),s=require("vue");function l(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.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.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.createFetchRequest=r.createFetchRequest;exports.createJh4jGridPlanFetcher=r.createJh4jGridPlanFetcher;exports.joinTempIds=r.joinTempIds;exports.machReportPlugin=r.machReportPlugin;exports.normalizeTempIds=r.normalizeTempIds;exports.createLocalFetcher=l;exports.useReportPreview=P;

package/dist/vue.js

@@ -1,9 +1,9 @@
-import { D as T, a as _, M as d, R as g, b as M, c as C, S as w, d as O, e as D, f as F, g as L, p as A, h as H, r as b, t as j, i as v, u as x, j as G, k as S, l as I } from "./ReportPreview-Do-x4E3Z.js";
-import { P as t, M as c } from "./plugin-CVYs7wAj.js";
-import { a as Y, b as N, c as y, d as U, e as V, f as W, g as k, j as q, m as z, n as J } from "./plugin-CVYs7wAj.js";
+import { D as T, a as _, M as d, R as g, b as M, c as C, S as w, d as O, e as D, f as F, g as L, h as A, p as H, i as b, r as j, t as v, j as x, u as G, k as S, l as I, m as K } from "./ReportPreview-mZiGtf0L.js";
+import { P as t, M as c } from "./plugin-DcmAPK_K.js";
+import { a as N, b as y, c as U, d as V, e as W, f as k, j as q, m as z, n as J } from "./plugin-DcmAPK_K.js";
 import { paginateTemplate as p } from "@agile-team/mach-report";
 import { inject as l } from "vue";
-function m(n) {
+function f(n) {
   return async ({ tempIds: a }) => {
     if (a.length === 0) throw new t("缺少报表模板 ID");
     const r = [];
@@ -22,12 +22,12 @@ function P() {
 export {
   T as DEFAULT_MESSAGES,
   _ as DEFAULT_THEME,
-  Y as MACH_REPORT_CONFIG_KEY,
+  N as MACH_REPORT_CONFIG_KEY,
   c as MACH_REPORT_CONTROLLER_KEY,
-  N as MACH_REPORT_FETCHER_KEY,
-  y as MACH_REPORT_PDF_EXPORTER_KEY,
+  y as MACH_REPORT_FETCHER_KEY,
+  U as MACH_REPORT_PDF_EXPORTER_KEY,
   d as MachReportError,
-  U as MachReportPreview,
+  V as MachReportPreview,
   t as PlanLoadError,
   g as ReportParamPanel,
   M as ReportPreview,
@@ -35,23 +35,23 @@ export {
   w as SILENT_LOGGER,
   O as buildPrintDocument,
   D as buildWordHtml,
-  V as createDefaultPdfExporter,
+  F as createDefaultPdfExporter,
   W as createFetchRequest,
   k as createJh4jGridPlanFetcher,
-  m as createLocalFetcher,
-  F as defineMachReportConfig,
-  L as defineMachReportPreset,
+  f as createLocalFetcher,
+  L as defineMachReportConfig,
+  A as defineMachReportPreset,
   q as joinTempIds,
   z as machReportPlugin,
   J as normalizeTempIds,
-  A as printPlans,
-  H as provideMachReportConfig,
-  b as resolveConfig,
-  j as themeToCssVars,
-  v as toErrorDetail,
-  x as useMachReportConfig,
-  G as usePageWindow,
-  S as usePrintExport,
+  H as printPlans,
+  b as provideMachReportConfig,
+  j as resolveConfig,
+  v as themeToCssVars,
+  x as toErrorDetail,
+  G as useMachReportConfig,
+  S as usePageWindow,
+  I as usePrintExport,
   P as useReportPreview,
-  I as useZoom
+  K as useZoom
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/mach-report",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "MachReport 报表引擎单包：RenderPlan 模型 + 分页 + DOM/Canvas/PDF 渲染 + 动态 SQL + 管理端 API + Vue 3 契约组件（零运行时依赖；./vue 为框架子路径，vue 为可选 peer）",
   "type": "module",
   "sideEffects": [