@agile-team/mach-report 2.6.1 → 2.8.0

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-BqBkn_kI.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-FSvcBLjH.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-mAfvgSey.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-E3cm67Tk.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-Ds10VnQO.js";
-import { M as l } from "./plugin-Ds10VnQO.js";
+import { m as o } from "./plugin-PCgxBVB2.js";
+import { M as l } from "./plugin-PCgxBVB2.js";
 function a() {
-  return import("./ReportPreview-Dk-28QAi.js").then((t) => t.z);
+  return import("./ReportPreview-BKKDAv8e.js").then((t) => t.C);
 }
 const n = {
   install(t, r = {}) {

package/dist/vue.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("@agile-team/mach-report"),t=require("./ReportPreview-FSvcBLjH.cjs"),f=require("./plugin-BqBkn_kI.cjs"),P=require("vue");function v(e){const r=p.createReportSource(e),n=async o=>{if(o.reportIds.length===0)throw new t.PlanLoadError("缺少报表 ID");for(const i of o.reportIds)if(!Object.prototype.hasOwnProperty.call(e,i)||!e[i])throw new t.PlanLoadError(`本地模板 ${i} 不存在`);return r(o)};return n.getParamDefs=r.getParamDefs,n}const M=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 C(){const e=P.shallowRef(null),r=()=>e.value?.state??M,n=Object.freeze({get loading(){return r().loading},get hasPlan(){return r().hasPlan},get pageCount(){return r().pageCount},get currentPage(){return r().currentPage},get exporting(){return r().exporting},get printing(){return r().printing},get canExport(){return r().canExport},get canPrint(){return r().canPrint},get error(){return r().error},get pdfFont(){return r().pdfFont},get editing(){return r().editing??!1},get saving(){return r().saving??!1},get importing(){return r().importing??!1},get dirty(){return r().dirty??!1},get canUndo(){return r().canUndo??!1},get canRedo(){return r().canRedo??!1},get changeCount(){return r().changeCount??0},get selection(){return r().selection??null}});function o(){if(!e.value)throw new t.MachReportError("config","报表预览尚未挂载，请在 ready 后调用控制器");return e.value}return{ref(i){const s=i;e.value=s&&typeof s.reload=="function"&&typeof s.print=="function"&&typeof s.exportAs=="function"&&typeof s.openPdfWindow=="function"&&typeof s.gotoPage=="function"&&typeof s.setParams=="function"?s:null},ready:P.computed(()=>e.value!==null),state:n,async checkPdfFont(){const i=o();return i.checkPdfFont?i.checkPdfFont():{status:"unverified",fontUrl:"",message:"旧自定义控制器未提供字体检查，请由宿主确认字体配置"}},async reload(){await o().reload()},async print(){await o().print()},async exportAs(i){await o().exportAs(i)},openPdfWindow(){o().openPdfWindow()},gotoPage(i){o().gotoPage(i)},async setParams(i,s){await o().setParams(i,s)},async importExcel(i,s){const l=o();if(!l.importExcel)throw new t.MachReportError("config","旧自定义控制器未提供 Excel 导入");return l.importExcel(i,s)},getPlan(){return o().getPlan?.()??null},getChanges(){return o().getChanges?.()??[]},getDifferences:()=>o().getDifferences?.()??[],undo:async()=>await o().undo?.()??!1,redo:async()=>await o().redo?.()??!1,restoreChanges:async()=>await o().restoreChanges?.()??!1,getSelection:()=>o().getSelection?.()??null,focusCell:async(i,s)=>await o().focusCell?.(i,s)??!1,focusField:async i=>await o().focusField?.(i)??!1,copySelection:()=>o().copySelection?.()??"",pasteSelection:async i=>await o().pasteSelection?.(i)??!1}}function S(){return P.inject(f.MACH_REPORT_CONTROLLER_KEY,null)}function h(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function A(e){return Array.isArray(e)&&e.every(r=>h(r)&&typeof r.code=="string"&&typeof r.message=="string"&&["info","warning","error"].includes(r.severity)&&(r.path===void 0||typeof r.path=="string"))}function I(e,r){return Array.isArray(e)&&e.every(n=>h(n)&&Number.isSafeInteger(n.editIndex)&&n.editIndex>=0&&n.editIndex<r&&typeof n.code=="string"&&typeof n.message=="string")}function x(e,r){let n;if(!h(e)||typeof e.revision!="string"||!e.revision.trim()?n="非空 revision（请先在适配器解包业务响应）":e.sourceToken!==void 0&&typeof e.sourceToken!="string"?n="字符串 sourceToken":e.diagnostics!==void 0&&!A(e.diagnostics)?n="结构化 diagnostics":e.conflicts!==void 0&&!I(e.conflicts,r)&&(n="有效 editIndex/code/message conflicts"),n)throw new t.MachReportError("edit",`ReportProvider.save 必须返回${n}；服务器可能已提交，请重新查询确认后再编辑`)}function y(e){return typeof e=="function"?e():e}function F(e,r){const n=new Set(e.flatMap(o=>o.source?.[r]===void 0?[]:[String(o.source[r])]));return n.size===1?[...n][0]:void 0}function w(e,r,n,o){return typeof e=="function"?e():F(r,n)??o??e}function L(e){return e.requestId??globalThis.crypto?.randomUUID?.()??`mr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}function D(e,r){if(!e.save)throw new t.MachReportError("config","ReportProvider.save 未配置，无法启用业务保存");let n="",o,i,s=0;function l(a,c,g){a.conflicts?.length||c!==n||g!==s||(o=a.revision,i=a.sourceToken)}async function m(a,c){if(c.signal.aborted)throw c.signal.reason??new DOMException("Aborted","AbortError");const g=y(r.reportId),T={...y(r.params??{})},R=JSON.stringify([g,T]),O=++s;if(R!==n&&(n=R,o=void 0,i=void 0),r.requireSource!==!1&&a.edits.some(u=>!u.source))throw new p.ReportCellEditError("missing");const d=await e.save({reportId:g,params:T,signal:c.signal,requestId:a.requestId,action:c.action,edits:t.cloneReportSnapshot(a.edits),expectedRevision:w(r.expectedRevision,a.edits,"revision",o),sourceToken:w(r.sourceToken,a.edits,"sourceToken",i)});if(c.signal.aborted)throw c.signal.reason??new DOMException("Aborted","AbortError");x(d,a.edits.length),d.diagnostics?.forEach(u=>r.onDiagnostic?.(u));const E=d.diagnostics?.filter(u=>u.severity==="error");if(E?.length)throw new t.MachReportError("edit",E.map(u=>u.message).join("；"),{diagnostics:E});const _=d.conflicts?.map(u=>({source:a.edits[u.editIndex]?.source,address:a.edits[u.editIndex]?.address,message:u.message}));return l(d,R,O),{revision:d.revision,sourceToken:d.sourceToken,conflicts:_}}return{requireSource:r.requireSource??!0,canEdit:r.canEdit,validate:r.validate,saveBatch:m,save:(a,c)=>m({requestId:L(c),edits:[t.cloneReportSnapshot(a)]},c)}}exports.DEFAULT_MESSAGES=t.DEFAULT_MESSAGES;exports.DEFAULT_THEME=t.DEFAULT_THEME;exports.MachReportError=t.MachReportError;exports.PlanLoadError=t.PlanLoadError;exports.REPORT_EXPORT_FORMATS=t.REPORT_EXPORT_FORMATS;exports.REPORT_PREVIEW_TOOLS=t.REPORT_PREVIEW_TOOLS;exports.ReportParamPanel=t.ReportParamPanel;exports.ReportPreview=t.ReportPreview;exports.ReportToolbar=t.ReportToolbar;exports.SILENT_LOGGER=t.SILENT_LOGGER;exports.buildPrintDocument=t.buildPrintDocument;exports.buildWordHtml=t.buildWordHtml;exports.createDefaultPdfExporter=t.createDefaultPdfExporter;exports.createFetchRequest=t.createFetchRequest;exports.createReportStoragePreferences=t.createReportStoragePreferences;exports.defineMachReportConfig=t.defineMachReportConfig;exports.defineMachReportPreset=t.defineMachReportPreset;exports.joinReportIds=t.joinReportIds;exports.normalizeReportIds=t.normalizeReportIds;exports.normalizeReportLoadError=t.normalizeReportLoadError;exports.printPlans=t.printPlans;exports.provideMachReportConfig=t.provideMachReportConfig;exports.resolveConfig=t.resolveConfig;exports.themeToCssVars=t.themeToCssVars;exports.toErrorDetail=t.toErrorDetail;exports.useMachReportConfig=t.useMachReportConfig;exports.usePageWindow=t.usePageWindow;exports.usePrintExport=t.usePrintExport;exports.useZoom=t.useZoom;exports.MACH_REPORT_CONFIG_KEY=f.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=f.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=f.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=f.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=f.MachReportPreview;exports.machReportPlugin=f.machReportPlugin;exports.createLocalFetcher=v;exports.createProviderEditing=D;exports.useMachReport=C;exports.useReportPreview=S;Object.keys(p).forEach(e=>{e!=="default"&&!Object.prototype.hasOwnProperty.call(exports,e)&&Object.defineProperty(exports,e,{enumerable:!0,get:()=>p[e]})});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("@agile-team/mach-report"),t=require("./ReportPreview-E3cm67Tk.cjs"),l=require("./plugin-mAfvgSey.cjs"),P=require("vue");function C(r){const e=p.createReportSource(r),i=async o=>{if(o.reportIds.length===0)throw new t.PlanLoadError("缺少报表 ID");for(const n of o.reportIds)if(!Object.prototype.hasOwnProperty.call(r,n)||!r[n])throw new t.PlanLoadError(`本地模板 ${n} 不存在`);return e(o)};return i.getParamDefs=e.getParamDefs,i}const M=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 S(){const r=P.shallowRef(null),e=()=>r.value?.state??M,i=Object.freeze({get loading(){return e().loading},get hasPlan(){return e().hasPlan},get pageCount(){return e().pageCount},get currentPage(){return e().currentPage},get exporting(){return e().exporting},get printing(){return e().printing},get canExport(){return e().canExport},get canPrint(){return e().canPrint},get error(){return e().error},get pdfFont(){return e().pdfFont},get editing(){return e().editing??!1},get saving(){return e().saving??!1},get importing(){return e().importing??!1},get dirty(){return e().dirty??!1},get pendingLocalChanges(){return e().pendingLocalChanges??!1},get task(){return e().task??null},get diagnostics(){return e().diagnostics??[]},get reportIds(){return e().reportIds??[]},get params(){return e().params??{}},get canUndo(){return e().canUndo??!1},get canRedo(){return e().canRedo??!1},get changeCount(){return e().changeCount??0},get selection(){return e().selection??null}});function o(){if(!r.value)throw new t.MachReportError("config","报表预览尚未挂载，请在 ready 后调用控制器");return r.value}return{ref(n){const a=n;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:P.computed(()=>r.value!==null),state:i,async checkPdfFont(){const n=o();return n.checkPdfFont?n.checkPdfFont():{status:"unverified",fontUrl:"",message:"旧自定义控制器未提供字体检查，请由宿主确认字体配置"}},cancelTask(){o().cancelTask?.()},async confirmDiscard(n){return await o().confirmDiscard?.(n)??!0},getOutputDiagnostics(n){return o().getOutputDiagnostics?.(n)??[]},async reload(){await o().reload()},async print(){await o().print()},async exportAs(n){await o().exportAs(n)},openPdfWindow(){o().openPdfWindow()},gotoPage(n){o().gotoPage(n)},async setParams(n,a){await o().setParams(n,a)},async importExcel(n,a){const f=o();if(!f.importExcel)throw new t.MachReportError("config","旧自定义控制器未提供 Excel 导入");return f.importExcel(n,a)},getPlan(){return o().getPlan?.()??null},getChanges(){return o().getChanges?.()??[]},getDifferences:()=>o().getDifferences?.()??[],undo:async()=>await o().undo?.()??!1,redo:async()=>await o().redo?.()??!1,restoreChanges:async()=>await o().restoreChanges?.()??!1,getSelection:()=>o().getSelection?.()??null,focusCell:async(n,a)=>await o().focusCell?.(n,a)??!1,focusField:async n=>await o().focusField?.(n)??!1,copySelection:()=>o().copySelection?.()??"",pasteSelection:async n=>await o().pasteSelection?.(n)??!1}}function v(){return P.inject(l.MACH_REPORT_CONTROLLER_KEY,null)}function h(r){return!!r&&typeof r=="object"&&!Array.isArray(r)}function A(r){return Array.isArray(r)&&r.every(e=>h(e)&&typeof e.code=="string"&&typeof e.message=="string"&&["info","warning","error"].includes(e.severity)&&(e.path===void 0||typeof e.path=="string"))}function I(r,e){return Array.isArray(r)&&r.every(i=>h(i)&&Number.isSafeInteger(i.editIndex)&&i.editIndex>=0&&i.editIndex<e&&typeof i.code=="string"&&typeof i.message=="string")}function L(r,e){let i;if(!h(r)||typeof r.revision!="string"||!r.revision.trim()?i="非空 revision（请先在适配器解包业务响应）":r.sourceToken!==void 0&&typeof r.sourceToken!="string"?i="字符串 sourceToken":r.diagnostics!==void 0&&!A(r.diagnostics)?i="结构化 diagnostics":r.conflicts!==void 0&&!I(r.conflicts,e)&&(i="有效 editIndex/code/message conflicts"),i)throw new t.MachReportError("edit",`ReportProvider.save 必须返回${i}；服务器可能已提交，请重新查询确认后再编辑`)}function y(r){return typeof r=="function"?r():r}function D(r,e){const i=new Set(r.flatMap(o=>o.source?.[e]===void 0?[]:[String(o.source[e])]));return i.size===1?[...i][0]:void 0}function w(r,e,i,o){return typeof r=="function"?r():D(e,i)??o??r}function x(r){return r.requestId??globalThis.crypto?.randomUUID?.()??`mr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}function F(r,e){if(!r.save)throw new t.MachReportError("config","ReportProvider.save 未配置，无法启用业务保存");let i="",o,n,a=0;function f(s,c,g){s.conflicts?.length||c!==i||g!==a||(o=s.revision,n=s.sourceToken)}async function T(s,c){if(c.signal.aborted)throw c.signal.reason??new DOMException("Aborted","AbortError");const g=y(e.reportId),m={...y(e.params??{})},E=JSON.stringify([g,m]),O=++a;if(E!==i&&(i=E,o=void 0,n=void 0),e.requireSource!==!1&&s.edits.some(u=>!u.source))throw new p.ReportCellEditError("missing");const d=await r.save({reportId:g,params:m,signal:c.signal,requestId:s.requestId,action:c.action,edits:t.cloneReportSnapshot(s.edits),expectedRevision:w(e.expectedRevision,s.edits,"revision",o),sourceToken:w(e.sourceToken,s.edits,"sourceToken",n)});if(c.signal.aborted)throw c.signal.reason??new DOMException("Aborted","AbortError");L(d,s.edits.length),d.diagnostics?.forEach(u=>e.onDiagnostic?.(u));const R=d.diagnostics?.filter(u=>u.severity==="error");if(R?.length)throw new t.MachReportError("edit",R.map(u=>u.message).join("；"),{diagnostics:R});const _=d.conflicts?.map(u=>({source:s.edits[u.editIndex]?.source,address:s.edits[u.editIndex]?.address,message:u.message}));return f(d,E,O),{revision:d.revision,sourceToken:d.sourceToken,conflicts:_}}return{requireSource:e.requireSource??!0,canEdit:e.canEdit,validate:e.validate,saveBatch:T,save:(s,c)=>T({requestId:x(c),edits:[t.cloneReportSnapshot(s)]},c)}}exports.DEFAULT_CALCULATION_MESSAGES=t.DEFAULT_CALCULATION_MESSAGES;exports.DEFAULT_MESSAGES=t.DEFAULT_MESSAGES;exports.DEFAULT_THEME=t.DEFAULT_THEME;exports.MachReportError=t.MachReportError;exports.PlanLoadError=t.PlanLoadError;exports.REPORT_EXPORT_FORMATS=t.REPORT_EXPORT_FORMATS;exports.REPORT_PREVIEW_TOOLS=t.REPORT_PREVIEW_TOOLS;exports.ReportPagination=t.ReportPagination;exports.ReportParamPanel=t.ReportParamPanel;exports.ReportPreview=t.ReportPreview;exports.ReportToolbar=t.ReportToolbar;exports.SILENT_LOGGER=t.SILENT_LOGGER;exports.buildPrintDocument=t.buildPrintDocument;exports.buildWordHtml=t.buildWordHtml;exports.createDefaultPdfExporter=t.createDefaultPdfExporter;exports.createFetchRequest=t.createFetchRequest;exports.createReportStoragePreferences=t.createReportStoragePreferences;exports.defineMachReportConfig=t.defineMachReportConfig;exports.defineMachReportPreset=t.defineMachReportPreset;exports.joinReportIds=t.joinReportIds;exports.normalizeReportIds=t.normalizeReportIds;exports.normalizeReportLoadError=t.normalizeReportLoadError;exports.printPlans=t.printPlans;exports.provideMachReportConfig=t.provideMachReportConfig;exports.resolveCalculationMessages=t.resolveCalculationMessages;exports.resolveConfig=t.resolveConfig;exports.themeToCssVars=t.themeToCssVars;exports.toErrorDetail=t.toErrorDetail;exports.useMachReportConfig=t.useMachReportConfig;exports.usePageWindow=t.usePageWindow;exports.usePrintExport=t.usePrintExport;exports.useZoom=t.useZoom;exports.MACH_REPORT_CONFIG_KEY=l.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=l.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=l.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=l.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=l.MachReportPreview;exports.machReportPlugin=l.machReportPlugin;exports.createLocalFetcher=C;exports.createProviderEditing=F;exports.useMachReport=S;exports.useReportPreview=v;Object.keys(p).forEach(r=>{r!=="default"&&!Object.prototype.hasOwnProperty.call(exports,r)&&Object.defineProperty(exports,r,{enumerable:!0,get:()=>p[r]})});

package/dist/vue.js

@@ -1,19 +1,19 @@
-import { createReportSource as x, ReportCellEditError as S } from "@agile-team/mach-report";
+import { createReportSource as S, ReportCellEditError as x } from "@agile-team/mach-report";
 export * from "@agile-team/mach-report";
-import { P as R, M as d, c as y } from "./ReportPreview-Dk-28QAi.js";
-import { D as $, a as V, R as X, b as B, d as J, e as Z, f as Q, S as ee, g as re, h as te, i as ne, j as oe, k as se, l as ie, m as ae, n as ce, o as fe, p as de, q as ue, r as le, s as ge, t as pe, u as Pe, v as me, w as Ee, x as Re, y as ye } from "./ReportPreview-Dk-28QAi.js";
-import { a as C } from "./plugin-Ds10VnQO.js";
-import { b as he, c as ve, d as Te, M as xe, m as Se } from "./plugin-Ds10VnQO.js";
-import { shallowRef as I, computed as O, inject as A } from "vue";
-function H(r) {
-  const e = x(r), n = async (t) => {
-    if (t.reportIds.length === 0) throw new R("缺少报表 ID");
-    for (const o of t.reportIds)
-      if (!Object.prototype.hasOwnProperty.call(r, o) || !r[o])
-        throw new R(`本地模板 ${o} 不存在`);
-    return e(t);
+import { P as R, M as f, c as y } from "./ReportPreview-BKKDAv8e.js";
+import { D as $, a as B, b as V, R as X, d as J, e as Z, f as Q, g as ee, h as te, S as re, i as ne, j as oe, k as se, l as ae, m as ie, n as ce, o as ue, p as fe, q as de, r as ge, s as le, t as pe, u as me, v as Pe, w as Ee, x as Re, y as ye, z as we, A as he, B as Te } from "./ReportPreview-BKKDAv8e.js";
+import { a as C } from "./plugin-PCgxBVB2.js";
+import { b as Se, c as xe, d as Ce, M as Ae, m as Ie } from "./plugin-PCgxBVB2.js";
+import { shallowRef as A, computed as I, inject as O } from "vue";
+function z(t) {
+  const e = S(t), o = async (r) => {
+    if (r.reportIds.length === 0) throw new R("缺少报表 ID");
+    for (const n of r.reportIds)
+      if (!Object.prototype.hasOwnProperty.call(t, n) || !t[n])
+        throw new R(`本地模板 ${n} 不存在`);
+    return e(r);
   };
-  return n.getParamDefs = e.getParamDefs, n;
+  return o.getParamDefs = e.getParamDefs, o;
 }
 const M = Object.freeze({
   loading: !1,
@@ -27,8 +27,8 @@ const M = Object.freeze({
   error: null,
   pdfFont: Object.freeze({ status: "unchecked", fontUrl: "" })
 });
-function z() {
-  const r = I(null), e = () => r.value?.state ?? M, n = Object.freeze({
+function H() {
+  const t = A(null), e = () => t.value?.state ?? M, o = Object.freeze({
     get loading() {
       return e().loading;
     },
@@ -71,6 +71,21 @@ function z() {
     get dirty() {
       return e().dirty ?? !1;
     },
+    get pendingLocalChanges() {
+      return e().pendingLocalChanges ?? !1;
+    },
+    get task() {
+      return e().task ?? null;
+    },
+    get diagnostics() {
+      return e().diagnostics ?? [];
+    },
+    get reportIds() {
+      return e().reportIds ?? [];
+    },
+    get params() {
+      return e().params ?? {};
+    },
     get canUndo() {
       return e().canUndo ?? !1;
     },
@@ -84,164 +99,176 @@ function z() {
       return e().selection ?? null;
     }
   });
-  function t() {
-    if (!r.value)
-      throw new d("config", "报表预览尚未挂载，请在 ready 后调用控制器");
-    return r.value;
+  function r() {
+    if (!t.value)
+      throw new f("config", "报表预览尚未挂载，请在 ready 后调用控制器");
+    return t.value;
   }
   return {
-    ref(o) {
-      const s = o;
-      r.value = s && typeof s.reload == "function" && typeof s.print == "function" && typeof s.exportAs == "function" && typeof s.openPdfWindow == "function" && typeof s.gotoPage == "function" && typeof s.setParams == "function" ? s : null;
+    ref(n) {
+      const s = n;
+      t.value = s && typeof s.reload == "function" && typeof s.print == "function" && typeof s.exportAs == "function" && typeof s.openPdfWindow == "function" && typeof s.gotoPage == "function" && typeof s.setParams == "function" ? s : null;
     },
-    ready: O(() => r.value !== null),
-    state: n,
+    ready: I(() => t.value !== null),
+    state: o,
     async checkPdfFont() {
-      const o = t();
-      return o.checkPdfFont ? o.checkPdfFont() : { status: "unverified", fontUrl: "", message: "旧自定义控制器未提供字体检查，请由宿主确认字体配置" };
+      const n = r();
+      return n.checkPdfFont ? n.checkPdfFont() : { status: "unverified", fontUrl: "", message: "旧自定义控制器未提供字体检查，请由宿主确认字体配置" };
+    },
+    cancelTask() {
+      r().cancelTask?.();
+    },
+    async confirmDiscard(n) {
+      return await r().confirmDiscard?.(n) ?? !0;
+    },
+    getOutputDiagnostics(n) {
+      return r().getOutputDiagnostics?.(n) ?? [];
     },
     async reload() {
-      await t().reload();
+      await r().reload();
     },
     async print() {
-      await t().print();
+      await r().print();
     },
-    async exportAs(o) {
-      await t().exportAs(o);
+    async exportAs(n) {
+      await r().exportAs(n);
     },
     openPdfWindow() {
-      t().openPdfWindow();
+      r().openPdfWindow();
     },
-    gotoPage(o) {
-      t().gotoPage(o);
+    gotoPage(n) {
+      r().gotoPage(n);
     },
-    async setParams(o, s) {
-      await t().setParams(o, s);
+    async setParams(n, s) {
+      await r().setParams(n, s);
     },
-    async importExcel(o, s) {
-      const u = t();
-      if (!u.importExcel) throw new d("config", "旧自定义控制器未提供 Excel 导入");
-      return u.importExcel(o, s);
+    async importExcel(n, s) {
+      const d = r();
+      if (!d.importExcel) throw new f("config", "旧自定义控制器未提供 Excel 导入");
+      return d.importExcel(n, s);
     },
     getPlan() {
-      return t().getPlan?.() ?? null;
+      return r().getPlan?.() ?? null;
     },
     getChanges() {
-      return t().getChanges?.() ?? [];
-    },
-    getDifferences: () => t().getDifferences?.() ?? [],
-    undo: async () => await t().undo?.() ?? !1,
-    redo: async () => await t().redo?.() ?? !1,
-    restoreChanges: async () => await t().restoreChanges?.() ?? !1,
-    getSelection: () => t().getSelection?.() ?? null,
-    focusCell: async (o, s) => await t().focusCell?.(o, s) ?? !1,
-    focusField: async (o) => await t().focusField?.(o) ?? !1,
-    copySelection: () => t().copySelection?.() ?? "",
-    pasteSelection: async (o) => await t().pasteSelection?.(o) ?? !1
+      return r().getChanges?.() ?? [];
+    },
+    getDifferences: () => r().getDifferences?.() ?? [],
+    undo: async () => await r().undo?.() ?? !1,
+    redo: async () => await r().redo?.() ?? !1,
+    restoreChanges: async () => await r().restoreChanges?.() ?? !1,
+    getSelection: () => r().getSelection?.() ?? null,
+    focusCell: async (n, s) => await r().focusCell?.(n, s) ?? !1,
+    focusField: async (n) => await r().focusField?.(n) ?? !1,
+    copySelection: () => r().copySelection?.() ?? "",
+    pasteSelection: async (n) => await r().pasteSelection?.(n) ?? !1
   };
 }
-function W() {
-  return A(C, null);
+function G() {
+  return O(C, null);
 }
-function P(r) {
-  return !!r && typeof r == "object" && !Array.isArray(r);
+function m(t) {
+  return !!t && typeof t == "object" && !Array.isArray(t);
 }
-function _(r) {
-  return Array.isArray(r) && r.every((e) => P(e) && typeof e.code == "string" && typeof e.message == "string" && ["info", "warning", "error"].includes(e.severity) && (e.path === void 0 || typeof e.path == "string"));
+function _(t) {
+  return Array.isArray(t) && t.every((e) => m(e) && typeof e.code == "string" && typeof e.message == "string" && ["info", "warning", "error"].includes(e.severity) && (e.path === void 0 || typeof e.path == "string"));
 }
-function D(r, e) {
-  return Array.isArray(r) && r.every((n) => P(n) && Number.isSafeInteger(n.editIndex) && n.editIndex >= 0 && n.editIndex < e && typeof n.code == "string" && typeof n.message == "string");
+function D(t, e) {
+  return Array.isArray(t) && t.every((o) => m(o) && Number.isSafeInteger(o.editIndex) && o.editIndex >= 0 && o.editIndex < e && typeof o.code == "string" && typeof o.message == "string");
 }
-function F(r, e) {
-  let n;
-  if (!P(r) || typeof r.revision != "string" || !r.revision.trim() ? n = "非空 revision（请先在适配器解包业务响应）" : r.sourceToken !== void 0 && typeof r.sourceToken != "string" ? n = "字符串 sourceToken" : r.diagnostics !== void 0 && !_(r.diagnostics) ? n = "结构化 diagnostics" : r.conflicts !== void 0 && !D(r.conflicts, e) && (n = "有效 editIndex/code/message conflicts"), n) throw new d("edit", `ReportProvider.save 必须返回${n}；服务器可能已提交，请重新查询确认后再编辑`);
+function k(t, e) {
+  let o;
+  if (!m(t) || typeof t.revision != "string" || !t.revision.trim() ? o = "非空 revision（请先在适配器解包业务响应）" : t.sourceToken !== void 0 && typeof t.sourceToken != "string" ? o = "字符串 sourceToken" : t.diagnostics !== void 0 && !_(t.diagnostics) ? o = "结构化 diagnostics" : t.conflicts !== void 0 && !D(t.conflicts, e) && (o = "有效 editIndex/code/message conflicts"), o) throw new f("edit", `ReportProvider.save 必须返回${o}；服务器可能已提交，请重新查询确认后再编辑`);
 }
-function w(r) {
-  return typeof r == "function" ? r() : r;
+function w(t) {
+  return typeof t == "function" ? t() : t;
 }
-function k(r, e) {
-  const n = new Set(r.flatMap((t) => t.source?.[e] === void 0 ? [] : [String(t.source[e])]));
-  return n.size === 1 ? [...n][0] : void 0;
+function F(t, e) {
+  const o = new Set(t.flatMap((r) => r.source?.[e] === void 0 ? [] : [String(r.source[e])]));
+  return o.size === 1 ? [...o][0] : void 0;
 }
-function h(r, e, n, t) {
-  return typeof r == "function" ? r() : k(e, n) ?? t ?? r;
+function h(t, e, o, r) {
+  return typeof t == "function" ? t() : F(e, o) ?? r ?? t;
 }
-function b(r) {
-  return r.requestId ?? globalThis.crypto?.randomUUID?.() ?? `mr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+function L(t) {
+  return t.requestId ?? globalThis.crypto?.randomUUID?.() ?? `mr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
-function G(r, e) {
-  if (!r.save) throw new d("config", "ReportProvider.save 未配置，无法启用业务保存");
-  let n = "", t, o, s = 0;
-  function u(i, a, l) {
-    i.conflicts?.length || a !== n || l !== s || (t = i.revision, o = i.sourceToken);
+function N(t, e) {
+  if (!t.save) throw new f("config", "ReportProvider.save 未配置，无法启用业务保存");
+  let o = "", r, n, s = 0;
+  function d(a, i, g) {
+    a.conflicts?.length || i !== o || g !== s || (r = a.revision, n = a.sourceToken);
   }
-  async function m(i, a) {
-    if (a.signal.aborted) throw a.signal.reason ?? new DOMException("Aborted", "AbortError");
-    const l = w(e.reportId), E = { ...w(e.params ?? {}) }, g = JSON.stringify([l, E]), v = ++s;
-    if (g !== n && (n = g, t = void 0, o = void 0), e.requireSource !== !1 && i.edits.some((c) => !c.source)) throw new S("missing");
-    const f = await r.save({
-      reportId: l,
+  async function P(a, i) {
+    if (i.signal.aborted) throw i.signal.reason ?? new DOMException("Aborted", "AbortError");
+    const g = w(e.reportId), E = { ...w(e.params ?? {}) }, l = JSON.stringify([g, E]), T = ++s;
+    if (l !== o && (o = l, r = void 0, n = void 0), e.requireSource !== !1 && a.edits.some((c) => !c.source)) throw new x("missing");
+    const u = await t.save({
+      reportId: g,
       params: E,
-      signal: a.signal,
-      requestId: i.requestId,
-      action: a.action,
-      edits: y(i.edits),
-      expectedRevision: h(e.expectedRevision, i.edits, "revision", t),
-      sourceToken: h(e.sourceToken, i.edits, "sourceToken", o)
+      signal: i.signal,
+      requestId: a.requestId,
+      action: i.action,
+      edits: y(a.edits),
+      expectedRevision: h(e.expectedRevision, a.edits, "revision", r),
+      sourceToken: h(e.sourceToken, a.edits, "sourceToken", n)
     });
-    if (a.signal.aborted) throw a.signal.reason ?? new DOMException("Aborted", "AbortError");
-    F(f, i.edits.length), f.diagnostics?.forEach((c) => e.onDiagnostic?.(c));
-    const p = f.diagnostics?.filter((c) => c.severity === "error");
-    if (p?.length) throw new d("edit", p.map((c) => c.message).join("；"), { diagnostics: p });
-    const T = f.conflicts?.map((c) => ({ source: i.edits[c.editIndex]?.source, address: i.edits[c.editIndex]?.address, message: c.message }));
-    return u(f, g, v), { revision: f.revision, sourceToken: f.sourceToken, conflicts: T };
+    if (i.signal.aborted) throw i.signal.reason ?? new DOMException("Aborted", "AbortError");
+    k(u, a.edits.length), u.diagnostics?.forEach((c) => e.onDiagnostic?.(c));
+    const p = u.diagnostics?.filter((c) => c.severity === "error");
+    if (p?.length) throw new f("edit", p.map((c) => c.message).join("；"), { diagnostics: p });
+    const v = u.conflicts?.map((c) => ({ source: a.edits[c.editIndex]?.source, address: a.edits[c.editIndex]?.address, message: c.message }));
+    return d(u, l, T), { revision: u.revision, sourceToken: u.sourceToken, conflicts: v };
   }
   return {
     requireSource: e.requireSource ?? !0,
     canEdit: e.canEdit,
     validate: e.validate,
-    saveBatch: m,
-    save: (i, a) => m({ requestId: b(a), edits: [y(i)] }, a)
+    saveBatch: P,
+    save: (a, i) => P({ requestId: L(i), edits: [y(a)] }, i)
   };
 }
 export {
-  $ as DEFAULT_MESSAGES,
+  $ as DEFAULT_CALCULATION_MESSAGES,
+  B as DEFAULT_MESSAGES,
   V as DEFAULT_THEME,
-  he as MACH_REPORT_CONFIG_KEY,
+  Se as MACH_REPORT_CONFIG_KEY,
   C as MACH_REPORT_CONTROLLER_KEY,
-  ve as MACH_REPORT_FETCHER_KEY,
-  Te as MACH_REPORT_PDF_EXPORTER_KEY,
-  d as MachReportError,
-  xe as MachReportPreview,
+  xe as MACH_REPORT_FETCHER_KEY,
+  Ce as MACH_REPORT_PDF_EXPORTER_KEY,
+  f as MachReportError,
+  Ae as MachReportPreview,
   R as PlanLoadError,
   X as REPORT_EXPORT_FORMATS,
-  B as REPORT_PREVIEW_TOOLS,
-  J as ReportParamPanel,
-  Z as ReportPreview,
-  Q as ReportToolbar,
-  ee as SILENT_LOGGER,
-  re as buildPrintDocument,
-  te as buildWordHtml,
-  ne as createDefaultPdfExporter,
-  oe as createFetchRequest,
-  H as createLocalFetcher,
-  G as createProviderEditing,
-  se as createReportStoragePreferences,
-  ie as defineMachReportConfig,
-  ae as defineMachReportPreset,
-  ce as joinReportIds,
-  Se as machReportPlugin,
-  fe as normalizeReportIds,
-  de as normalizeReportLoadError,
-  ue as printPlans,
-  le as provideMachReportConfig,
-  ge as resolveConfig,
-  pe as themeToCssVars,
-  Pe as toErrorDetail,
-  z as useMachReport,
-  me as useMachReportConfig,
-  Ee as usePageWindow,
-  Re as usePrintExport,
-  W as useReportPreview,
-  ye as useZoom
+  J as REPORT_PREVIEW_TOOLS,
+  Z as ReportPagination,
+  Q as ReportParamPanel,
+  ee as ReportPreview,
+  te as ReportToolbar,
+  re as SILENT_LOGGER,
+  ne as buildPrintDocument,
+  oe as buildWordHtml,
+  se as createDefaultPdfExporter,
+  ae as createFetchRequest,
+  z as createLocalFetcher,
+  N as createProviderEditing,
+  ie as createReportStoragePreferences,
+  ce as defineMachReportConfig,
+  ue as defineMachReportPreset,
+  fe as joinReportIds,
+  Ie as machReportPlugin,
+  de as normalizeReportIds,
+  ge as normalizeReportLoadError,
+  le as printPlans,
+  pe as provideMachReportConfig,
+  me as resolveCalculationMessages,
+  Pe as resolveConfig,
+  Ee as themeToCssVars,
+  Re as toErrorDetail,
+  H as useMachReport,
+  ye as useMachReportConfig,
+  we as usePageWindow,
+  he as usePrintExport,
+  G as useReportPreview,
+  Te as useZoom
 };

package/dist/worker.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const W=require("./validate-DfHPD8wX.cjs"),u="mach-report-worker/1";class h extends Error{constructor(e){super(e.message),this.name=e.name,this.code=e.code,this.path=e.path,this.issues=e.issues}}function m(r){return!!r&&typeof r=="object"&&!Array.isArray(r)}function M(r){return m(r)?["rows","pages","cells"].every(e=>typeof r[e]=="number"&&Number.isSafeInteger(r[e])&&r[e]>=0)&&typeof r.durationMs=="number"&&Number.isFinite(r.durationMs)&&r.durationMs>=0:!1}function x(r){return Array.isArray(r)&&r.every(e=>m(e)&&typeof e.code=="string"&&typeof e.message=="string"&&["info","warning","error"].includes(e.severity))}function L(r){return m(r)&&Object.values(r).every(e=>m(e)&&(e.revision===void 0||typeof e.revision=="string")&&(e.sourceToken===void 0||typeof e.sourceToken=="string"))}function T(r,e){if(!m(r)||!M(r.stats)||!x(r.diagnostics)||!L(r.revisions))return!1;if(e==="prepare")return W.validateRenderPlan(r.plan).ok;const t=r.format==="pdf"?"application/pdf":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";return r.bytes instanceof Uint8Array&&(r.format==="pdf"||r.format==="xlsx")&&r.contentType===t}function A(r){if(!r||typeof r!="object")return{message:String(r)};const e={};for(const t of["code","path","field","message"]){const o=r[t];typeof o=="string"&&(e[t]=o)}return e}function j(r){if(!(r instanceof Error))return{name:"Error",message:String(r)};const e=r;return{name:r.name,message:r.message,...typeof e.code=="string"?{code:e.code}:{},...typeof e.path=="string"?{path:e.path}:{},...Array.isArray(e.issues)?{issues:e.issues.map(A)}:{}}}function O(r){if(!r||typeof r!="object")return!1;const e=r;return e.protocol===u&&typeof e.id=="string"&&(e.operation==="prepare"||e.operation==="export")&&!!e.input&&typeof e.input=="object"}async function P(r,e){try{const t=e.operation==="prepare"?await r.prepare(e.input):await r.export(e.input);return{protocol:u,id:e.id,result:t}}catch(t){return{protocol:u,id:e.id,error:j(t)}}}function S(r){const e=r.result;return!e||!("bytes"in e)||!(e.bytes.buffer instanceof ArrayBuffer)?[]:[e.bytes.buffer]}let B=0;function k(r){const e=new Error("报表 Worker 任务已取消");return e.name="AbortError",Object.defineProperty(e,"cause",{value:r}),e}function N(r,e){if(!r||typeof r!="object")return;const t=r;return t.protocol===u&&t.id===e?t:void 0}function $(r,e={}){const t=e.timeoutMs??12e4;if(!Number.isFinite(t)||t<=0||t>2147483647)throw new RangeError("Worker timeoutMs 应为正有限数字，且不能超过 2147483647");const o=(s,c,n)=>n?.aborted?Promise.reject(k(n.reason)):new Promise((p,g)=>{let d;try{d=r()}catch(i){g(i);return}const R=`mach-report-${Date.now()}-${++B}`;let b=!1,y=()=>{},E;const f=(i,a)=>{b||(b=!0,E&&clearTimeout(E),y(),n?.removeEventListener("abort",l),Promise.resolve().then(()=>d.terminate()).then(()=>i===void 0?p(a):g(i),v=>g(i??v)))},l=()=>f(k(n?.reason)),w=i=>{const a=N(i,R);a&&(a.error&&typeof a.error.name=="string"&&typeof a.error.message=="string"?f(new h(a.error)):T(a.result,s)&&(s!=="export"||"format"in a.result&&"format"in c&&a.result.format===c.format)?f(void 0,a.result):f(new Error("报表 Worker 返回无效响应")))};try{if(y=d.subscribe(w,i=>f(i??new Error("报表 Worker 执行失败"))),b){y();return}n?.addEventListener("abort",l,{once:!0}),E=setTimeout(()=>f(new h({name:"ReportRuntimeError",code:"timeout",message:`报表 Worker 执行超过 ${t}ms`})),t),n?.aborted?l():d.postMessage({protocol:u,id:R,operation:s,input:c})}catch(i){f(i)}});return{prepare:(s,c)=>o("prepare",s,c),export:(s,c)=>o("export",s,c)}}function z(r,e={}){return $(()=>{const t=r();return{postMessage:o=>t.postMessage(o),terminate:()=>t.terminate(),subscribe:(o,s)=>{const c=p=>o(p.data),n=p=>s(p instanceof ErrorEvent?new Error(p.message):new Error("报表 Worker 消息无法解码"));return t.addEventListener("message",c),t.addEventListener("error",n),t.addEventListener("messageerror",n),()=>{t.removeEventListener("message",c),t.removeEventListener("error",n),t.removeEventListener("messageerror",n)}}}},e)}function F(r,e=globalThis){const t=o=>{O(o.data)&&P(r,o.data).then(s=>e.postMessage(s,S(s)))};return e.addEventListener("message",t),()=>e.removeEventListener("message",t)}exports.ReportWorkerError=h;exports.createBrowserReportExecutor=z;exports.serveReportWorker=F;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const x=require("./task-events-DQ276fn2.cjs"),A=require("./validate-DfHPD8wX.cjs"),u="mach-report-worker/1";class l extends Error{constructor(r){super(r.message),this.name=r.name,this.code=r.code,this.path=r.path,this.issues=r.issues,this.diagnostics=r.diagnostics}}function p(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function L(e){return p(e)?["rows","pages","cells"].every(r=>typeof e[r]=="number"&&Number.isSafeInteger(e[r])&&e[r]>=0)&&typeof e.durationMs=="number"&&Number.isFinite(e.durationMs)&&e.durationMs>=0:!1}function P(e){return Array.isArray(e)&&e.every(r=>p(r)&&typeof r.code=="string"&&typeof r.message=="string"&&["info","warning","error"].includes(r.severity))}function T(e){return p(e)&&Object.values(e).every(r=>p(r)&&(r.revision===void 0||typeof r.revision=="string")&&(r.sourceToken===void 0||typeof r.sourceToken=="string"))}function v(e,r){if(!p(e)||!L(e.stats)||!P(e.diagnostics)||!T(e.revisions))return!1;if(r==="prepare")return A.validateRenderPlan(e.plan).ok;const t=e.format==="pdf"?"application/pdf":"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";return e.bytes instanceof Uint8Array&&(e.format==="pdf"||e.format==="xlsx")&&e.contentType===t}function W(e){if(!e||typeof e!="object")return{message:String(e)};const r={};for(const t of["code","path","field","message"]){const o=e[t];typeof o=="string"&&(r[t]=o)}return r}function j(e){const r=W(e);if(!p(e))return r;for(const t of["format","severity","kind","nid"])typeof e[t]=="string"&&(r[t]=e[t]);for(const t of["pageIndex","componentIndex"])Number.isSafeInteger(e[t])&&e[t]>=0&&(r[t]=e[t]);return Array.isArray(e.componentPath)&&e.componentPath.every(t=>Number.isSafeInteger(t)&&t>=0)&&(r.componentPath=e.componentPath),r}function O(e){if(!(e instanceof Error))return{name:"Error",message:String(e)};const r=e;return{name:e.name,message:e.message,...typeof r.code=="string"?{code:r.code}:{},...typeof r.path=="string"?{path:r.path}:{},...Array.isArray(r.issues)?{issues:r.issues.map(W)}:{},...Array.isArray(r.diagnostics)?{diagnostics:r.diagnostics.map(j)}:{}}}function S(e){if(!e||typeof e!="object")return!1;const r=e;return r.protocol===u&&typeof r.id=="string"&&(r.operation==="prepare"||r.operation==="export")&&!!r.input&&typeof r.input=="object"}async function N(e,r,t){try{const o=r.operation==="prepare"?await e.prepare({...r.input,onEvent:t}):await e.export({...r.input,onEvent:t});return{protocol:u,id:r.id,result:o}}catch(o){return{protocol:u,id:r.id,error:O(o)}}}function z(e){const r=e.result;return!r||!("bytes"in r)||!(r.bytes.buffer instanceof ArrayBuffer)?[]:[r.bytes.buffer]}function _(e,r){if(!p(e)||typeof e.taskId!="string"||!e.taskId||r.taskId!==void 0&&e.taskId!==r.taskId||e.correlationId!==r.correlationId||e.reportId!==void 0&&(typeof e.reportId!="string"||!r.reportIds.includes(e.reportId))||!["query","validate","layout","encode"].includes(e.stage)||!["started","completed","failed"].includes(e.status))return!1;for(const t of["completed","total"])if(e[t]!==void 0&&(typeof e[t]!="number"||!Number.isFinite(e[t])||e[t]<0))return!1;return e.completed===void 0||e.total===void 0||e.completed<=e.total}let q=0;function w(e){const r=new Error("报表 Worker 任务已取消");return r.name="AbortError",Object.defineProperty(r,"cause",{value:e}),r}function B(e,r){if(!e||typeof e!="object")return;const t=e;return t.protocol===u&&t.id===r?t:void 0}function F(e,r={}){const t=r.timeoutMs??12e4;if(!Number.isFinite(t)||t<=0||t>2147483647)throw new RangeError("Worker timeoutMs 应为正有限数字，且不能超过 2147483647");const o=(i,c,n,d)=>n?.aborted?Promise.reject(w(n.reason)):new Promise((I,b)=>{let g;try{g=e()}catch(a){b(a);return}const R=`mach-report-${Date.now()}-${++q}`;let y=!1,E=()=>{},k;const f=(a,s)=>{y||(y=!0,k&&clearTimeout(k),E(),n?.removeEventListener("abort",h),Promise.resolve().then(()=>g.terminate()).then(()=>a===void 0?I(s):b(a),m=>b(a??m)))},h=()=>f(w(n?.reason)),M=a=>{const s=B(a,R);if(!(!s||y)){if("type"in s&&s.type==="event"){const m="event"in s?s.event:void 0;_(m,c)?x.notifyReportTaskEvent(d,m,n):f(new Error("报表 Worker 返回无效阶段事件"));return}s.error&&typeof s.error.name=="string"&&typeof s.error.message=="string"?f(new l(s.error)):v(s.result,i)&&(i!=="export"||"format"in s.result&&"format"in c&&s.result.format===c.format)?f(void 0,s.result):f(new Error("报表 Worker 返回无效响应"))}};try{if(E=g.subscribe(M,a=>f(a??new Error("报表 Worker 执行失败"))),y){E();return}if(n?.addEventListener("abort",h,{once:!0}),k=setTimeout(()=>f(new l({name:"ReportRuntimeError",code:"timeout",message:`报表 Worker 执行超过 ${t}ms`})),t),n?.aborted)h();else{const{onEvent:a,signal:s,...m}=c;g.postMessage({protocol:u,id:R,operation:i,input:m})}}catch(a){f(a)}});return{prepare:(i,c,n)=>o("prepare",i,c,n),export:(i,c,n)=>o("export",i,c,n)}}function $(e,r={}){return F(()=>{const t=e();return{postMessage:o=>t.postMessage(o),terminate:()=>t.terminate(),subscribe:(o,i)=>{const c=d=>o(d.data),n=d=>i(d instanceof ErrorEvent?new Error(d.message):new Error("报表 Worker 消息无法解码"));return t.addEventListener("message",c),t.addEventListener("error",n),t.addEventListener("messageerror",n),()=>{t.removeEventListener("message",c),t.removeEventListener("error",n),t.removeEventListener("messageerror",n)}}}},r)}function D(e,r=globalThis){const t=o=>{S(o.data)&&N(e,o.data,i=>r.postMessage({protocol:u,id:o.data.id,type:"event",event:i})).then(i=>r.postMessage(i,z(i)))};return r.addEventListener("message",t),()=>r.removeEventListener("message",t)}exports.ReportWorkerError=l;exports.createBrowserReportExecutor=$;exports.serveReportWorker=D;

package/dist/worker.d.cts

@@ -211,12 +211,14 @@ declare interface ReportRuntime {
 
 /** 可用 worker_threads/进程/RPC 实现；接收可序列化请求，signal 由桥接层映射为取消消息。 */
 declare interface ReportRuntimeExecutor {
-    prepare(input: Omit<ReportRuntimeInput, "signal">, signal?: AbortSignal): Promise<PreparedReport>;
-    export(input: Omit<ReportRuntimeExportInput, "signal">, signal?: AbortSignal): Promise<ReportRuntimeExportResult>;
+    prepare(input: Omit<ReportRuntimeInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<PreparedReport>;
+    export(input: Omit<ReportRuntimeExportInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<ReportRuntimeExportResult>;
 }
 
 declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
     format: "pdf" | "xlsx";
+    /** strict 在编码前拒绝已识别的输出降级；默认保留诊断并继续。 */
+    fidelity?: "warn" | "strict";
     /** PDF 中文需宿主显式提供有授权的字体；不隐式下载字体或资源。 */
     pdf?: {
         customFontBytes?: Uint8Array | ArrayBuffer;
@@ -241,7 +243,7 @@ declare interface ReportRuntimeExportResult extends Omit<PreparedReport, "plan">
     contentType: string;
 }
 
-declare interface ReportRuntimeInput {
+declare interface ReportRuntimeInput extends ReportTaskMonitoring {
     reportIds: string[];
     params?: Record<string, string>;
     signal?: AbortSignal;
@@ -255,10 +257,30 @@ declare interface ReportRuntimeStats {
     outputBytes?: number;
 }
 
+/** 阶段事件只包含可序列化值；不表示估算百分比，也不包含业务数据。 */
+declare interface ReportTaskEvent {
+    taskId: string;
+    correlationId?: string;
+    stage: "query" | "validate" | "layout" | "encode";
+    status: "started" | "completed" | "failed";
+    reportId?: string;
+    completed?: number;
+    total?: number;
+}
+
+declare interface ReportTaskMonitoring {
+    taskId?: string;
+    correlationId?: string;
+    onEvent?: ReportTaskObserver;
+}
+
+declare type ReportTaskObserver = (event: ReportTaskEvent) => void;
+
 export declare class ReportWorkerError extends Error {
     readonly code?: string;
     readonly path?: string;
     readonly issues?: unknown;
+    readonly diagnostics?: unknown;
     constructor(error: SerializedReportError);
 }
 
@@ -294,6 +316,7 @@ declare interface SerializedReportError {
     code?: string;
     path?: string;
     issues?: unknown;
+    diagnostics?: unknown;
 }
 
 /** 在 Worker 入口注册一次 runtime；返回函数可清理监听器，浏览器主线程无需引入 Node。 */

package/dist/worker.d.ts

@@ -211,12 +211,14 @@ declare interface ReportRuntime {
 
 /** 可用 worker_threads/进程/RPC 实现；接收可序列化请求，signal 由桥接层映射为取消消息。 */
 declare interface ReportRuntimeExecutor {
-    prepare(input: Omit<ReportRuntimeInput, "signal">, signal?: AbortSignal): Promise<PreparedReport>;
-    export(input: Omit<ReportRuntimeExportInput, "signal">, signal?: AbortSignal): Promise<ReportRuntimeExportResult>;
+    prepare(input: Omit<ReportRuntimeInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<PreparedReport>;
+    export(input: Omit<ReportRuntimeExportInput, "signal" | "onEvent">, signal?: AbortSignal, onEvent?: ReportTaskObserver): Promise<ReportRuntimeExportResult>;
 }
 
 declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
     format: "pdf" | "xlsx";
+    /** strict 在编码前拒绝已识别的输出降级；默认保留诊断并继续。 */
+    fidelity?: "warn" | "strict";
     /** PDF 中文需宿主显式提供有授权的字体；不隐式下载字体或资源。 */
     pdf?: {
         customFontBytes?: Uint8Array | ArrayBuffer;
@@ -241,7 +243,7 @@ declare interface ReportRuntimeExportResult extends Omit<PreparedReport, "plan">
     contentType: string;
 }
 
-declare interface ReportRuntimeInput {
+declare interface ReportRuntimeInput extends ReportTaskMonitoring {
     reportIds: string[];
     params?: Record<string, string>;
     signal?: AbortSignal;
@@ -255,10 +257,30 @@ declare interface ReportRuntimeStats {
     outputBytes?: number;
 }
 
+/** 阶段事件只包含可序列化值；不表示估算百分比，也不包含业务数据。 */
+declare interface ReportTaskEvent {
+    taskId: string;
+    correlationId?: string;
+    stage: "query" | "validate" | "layout" | "encode";
+    status: "started" | "completed" | "failed";
+    reportId?: string;
+    completed?: number;
+    total?: number;
+}
+
+declare interface ReportTaskMonitoring {
+    taskId?: string;
+    correlationId?: string;
+    onEvent?: ReportTaskObserver;
+}
+
+declare type ReportTaskObserver = (event: ReportTaskEvent) => void;
+
 export declare class ReportWorkerError extends Error {
     readonly code?: string;
     readonly path?: string;
     readonly issues?: unknown;
+    readonly diagnostics?: unknown;
     constructor(error: SerializedReportError);
 }
 
@@ -294,6 +316,7 @@ declare interface SerializedReportError {
     code?: string;
     path?: string;
     issues?: unknown;
+    diagnostics?: unknown;
 }
 
 /** 在 Worker 入口注册一次 runtime；返回函数可清理监听器，浏览器主线程无需引入 Node。 */