@agile-team/mach-report 2.7.0 → 2.8.1

package/dist/vue/index.d.ts

@@ -1,7 +1,5 @@
 export * from "@agile-team/mach-report";
-import { AllowedComponentProps } from 'vue';
 import { App } from 'vue';
-import { ComponentCustomProps } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComputedRef } from 'vue';
 import { CSSProperties } from 'vue';
@@ -10,7 +8,6 @@ import { ExtractPropTypes } from 'vue';
 import { InjectionKey } from 'vue';
 import { PropType } from 'vue';
 import { Ref } from 'vue';
-import { VNodeProps } from 'vue';
 declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     reportId: {
         type: PropType<string | string[] | null>;
@@ -164,8 +161,8 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         cause?: unknown;
     } | undefined) => any;
     task: (task: Readonly<ReportPreviewTask>) => any;
-    loaded: (pageCount: number) => any;
     diagnostic: (diagnostic: Readonly<ReportPreviewDiagnostic>) => any;
+    loaded: (pageCount: number) => any;
     "cell-edit": (edit: ReportCellEdit_2) => any;
     "template-import": (result: ExcelImportResult) => any;
     "preferences-change": (preferences: Readonly<ReportPreviewPreferences>) => any;
@@ -285,8 +282,8 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         cause?: unknown;
     } | undefined) => any) | undefined;
     onTask?: ((task: Readonly<ReportPreviewTask>) => any) | undefined;
-    onLoaded?: ((pageCount: number) => any) | undefined;
     onDiagnostic?: ((diagnostic: Readonly<ReportPreviewDiagnostic>) => any) | undefined;
+    onLoaded?: ((pageCount: number) => any) | undefined;
     "onCell-edit"?: ((edit: ReportCellEdit_2) => any) | undefined;
     "onTemplate-import"?: ((result: ExcelImportResult) => any) | undefined;
     "onPreferences-change"?: ((preferences: Readonly<ReportPreviewPreferences>) => any) | undefined;
@@ -317,6 +314,38 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     paramDefs: ReportParamDef[] | undefined;
     fetcher: PlanFetcher | null;
 }>;
+declare const __VLS_component_2: DefineComponent<__VLS_Props, {
+    focusSearch: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    export: (format: ReportExportFormat) => any;
+    print: () => any;
+    zoom: (mode: number | "fit") => any;
+    goto: (page: number) => any;
+    "pdf-window": () => any;
+    "search-input": (query: string) => any;
+    "search-nav": (dir: 1 | -1) => any;
+    "search-toggle": () => any;
+    "thumbs-toggle": () => any;
+    "import-excel": () => any;
+    "settings-toggle": () => any;
+}, string, MachReportVuePublicProps, Readonly<__VLS_Props> & Readonly<{
+    onExport?: ((format: ReportExportFormat) => any) | undefined;
+    onPrint?: (() => any) | undefined;
+    onZoom?: ((mode: number | "fit") => any) | undefined;
+    onGoto?: ((page: number) => any) | undefined;
+    "onPdf-window"?: (() => any) | undefined;
+    "onSearch-input"?: ((query: string) => any) | undefined;
+    "onSearch-nav"?: ((dir: 1 | -1) => any) | undefined;
+    "onSearch-toggle"?: (() => any) | undefined;
+    "onThumbs-toggle"?: (() => any) | undefined;
+    "onImport-excel"?: (() => any) | undefined;
+    "onSettings-toggle"?: (() => any) | undefined;
+}>, {
+    showSearch: boolean;
+    showThumbnails: boolean;
+    showZoom: boolean;
+    exportFormats: readonly ReportExportFormat[];
+}>;
 declare type __VLS_Props = {
     pageCount: number;
     currentPage: number;
@@ -342,8 +371,16 @@ declare type __VLS_Props = {
     showSettings?: boolean;
     settingsOpen?: boolean;
     busy?: boolean;
+    /** Standalone toolbar escape hatch; ReportPreview renders pagination in its footer. */
+    showPagination?: boolean;
 };
 declare type __VLS_Props_2 = {
+    pageCount: number;
+    currentPage: number;
+    messages: MachReportMessages;
+    busy?: boolean;
+};
+declare type __VLS_Props_3 = {
     defs: ReportParamDef[];
     modelValue: Record<string, string>;
     messages: MachReportMessages;
@@ -357,12 +394,29 @@ declare function __VLS_template(): {
         default?(_: {}): any;
     };
 };
+declare function __VLS_template_2(): {
+    attrs: Partial<{}>;
+    slots: {
+        navigation?(_: {}): any;
+    };
+    refs: {
+        searchToggleRef: HTMLButtonElement;
+        searchInputRef: HTMLInputElement;
+    };
+    rootEl: HTMLDivElement;
+};
 declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare type __VLS_TemplateResult_2 = ReturnType<typeof __VLS_template_2>;
 declare type __VLS_WithTemplateSlots<T, S> = T & {
     new (): {
         $slots: S;
     };
 };
+declare type __VLS_WithTemplateSlots_2<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -566,6 +620,7 @@ declare interface DatasetValidationOptions {
     maxCells?: number;
     maxIssues?: number;
 }
+export declare const DEFAULT_CALCULATION_MESSAGES: ReportCalculationMessages;
 export declare const DEFAULT_MESSAGES: MachReportMessages;
 export declare const DEFAULT_THEME: MachReportTheme;
 export declare interface DefaultPdfExporterOptions {
@@ -1121,7 +1176,27 @@ export declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-export declare interface MachReportMessages {
+export declare interface MachReportMessages extends Partial<ReportCalculationMessages> {
+    exportMenu?: string;
+    exportMenuDescription?: string;
+    clearSearch?: string;
+    searchHint?: string;
+    searchNoMatches?: string;
+    pageJump?: string;
+    pageJumpInvalid?: string;
+    pageJumpHint?: string;
+    pagination?: string;
+    columnSearchHint?: string;
+    columnSearchShortcut?: string;
+    closeColumnDirectory?: string;
+    columnResultsMore?: string;
+    columnCount?: string;
+    settingsGeneral?: string;
+    settingsTools?: string;
+    settingsAdvanced?: string;
+    settingsAdvancedDescription?: string;
+    settingsCalculations?: string;
+    settingsCalculationsDescription?: string;
     title: string;
     prevPage: string;
     nextPage: string;
@@ -1330,6 +1405,8 @@ export declare interface MachReportStateError {
 }
 /** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */
 export declare interface MachReportTheme {
+    /** 空态插图强调色，不随正文颜色变灰。 */
+    emptyAccent?: string;
     shellBg: string;
     shellFg: string;
     toolbarBg: string;
@@ -1647,6 +1724,35 @@ export declare interface ReportBeforeDiscardContext {
     /** Local input or a local draft, never a synonym for persisted differences. */
     pendingLocalChanges: true;
 }
+export declare interface ReportCalculationMessages {
+    calculationTitle: string;
+    calculationLocal: string;
+    calculationHint: string;
+    calculationFormula: string;
+    calculationExpression: string;
+    calculationExpressionHint: string;
+    calculationPrecision: string;
+    calculationRun: string;
+    calculationCancel: string;
+    calculationResult: string;
+    calculationIncluded: string;
+    calculationExcluded: string;
+    calculationEmpty: string;
+    calculationNoSelection: string;
+    calculationSum: string;
+    calculationAverage: string;
+    calculationMin: string;
+    calculationMax: string;
+    calculationCount: string;
+    calculationMedian: string;
+    calculationCustom: string;
+    calculationErrorSelection: string;
+    calculationErrorLimit: string;
+    calculationErrorExpression: string;
+    calculationErrorDivision: string;
+    calculationErrorOverflow: string;
+    calculationErrorPrecision: string;
+}
 /** 预览中的物理坐标；合并单元格使用左上角坐标。 */
 declare interface ReportCellAddress {
     pageIndex: number;
@@ -1871,6 +1977,8 @@ export declare interface ReportFieldTarget {
 }
 export declare type ReportIdInput = string | string[] | null | undefined;
 export declare interface ReportInteractionOptions {
+    /** 只读选区计算，默认关闭；不写回业务值或执行导入的 Excel 公式。 */
+    calculations?: boolean;
     /** Screen-only frozen panes; exported geometry is unchanged. */
     freezeHeaders?: boolean;
     /** Leading identity columns, from 0 to 20. */
@@ -1888,6 +1996,11 @@ export declare interface ReportOutputOptions {
     /** warn preserves supported output and shows diagnostics; strict rejects known fidelity loss. */
     fidelity?: "warn" | "strict";
 }
+export declare const ReportPagination: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    goto: (page: number) => any;
+}, string, MachReportVuePublicProps, Readonly<__VLS_Props_2> & Readonly<{
+    onGoto?: ((page: number) => any) | undefined;
+}>, {}>;
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef {
     /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
@@ -1958,13 +2071,13 @@ declare interface ReportParamIssue {
     message: string;
 }
 declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "minimum" | "maximum" | "minLength" | "maxLength";
-export declare const ReportParamPanel: DefineComponent<__VLS_Props_2, {
+export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     focusInvalid: typeof focusInvalid;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     reset: () => any;
     query: () => any;
     "update:modelValue": (value: Record<string, string>) => any;
-}, string, MachReportVuePublicProps, Readonly<__VLS_Props_2> & Readonly<{
+}, string, MachReportVuePublicProps, Readonly<__VLS_Props_3> & Readonly<{
     onReset?: (() => any) | undefined;
     onQuery?: (() => any) | undefined;
     "onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
@@ -2101,33 +2214,9 @@ declare interface ReportTemplateProvider {
     }): Promise<ReportTemplateDocument | undefined>;
 }
 declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
-export declare const ReportToolbar: DefineComponent<__VLS_Props, {
-    focusSearch: () => void;
-}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-    export: (format: "pdf" | "xlsx" | "html" | "png" | "word") => any;
-    print: () => any;
-    zoom: (mode: number | "fit") => any;
-    goto: (page: number) => any;
-    "pdf-window": () => any;
-    "search-input": (query: string) => any;
-    "search-nav": (dir: 1 | -1) => any;
-    "search-toggle": () => any;
-    "thumbs-toggle": () => any;
-    "import-excel": () => any;
-    "settings-toggle": () => any;
-}, string, MachReportVuePublicProps, Readonly<__VLS_Props> & Readonly<{
-    onExport?: ((format: "pdf" | "xlsx" | "html" | "png" | "word") => any) | undefined;
-    onPrint?: (() => any) | undefined;
-    onZoom?: ((mode: number | "fit") => any) | undefined;
-    onGoto?: ((page: number) => any) | undefined;
-    "onPdf-window"?: (() => any) | undefined;
-    "onSearch-input"?: ((query: string) => any) | undefined;
-    "onSearch-nav"?: ((dir: 1 | -1) => any) | undefined;
-    "onSearch-toggle"?: (() => any) | undefined;
-    "onThumbs-toggle"?: (() => any) | undefined;
-    "onImport-excel"?: (() => any) | undefined;
-    "onSettings-toggle"?: (() => any) | undefined;
-}>, {}>;
+export declare const ReportToolbar: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
+/** 新消息保持可选，旧的完整文案对象也能获得新增能力的默认文案。 */
+export declare function resolveCalculationMessages(messages: Partial<ReportCalculationMessages>): ReportCalculationMessages;
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
 export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showSettings" | "showParams" | "gapPx">> & {
     pdfFontUrl: string;

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-9t_ZFwhz.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-BdvoqdOd.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-BAD7Ry8V.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-fKUPcCTN.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-s8Ay8kKk.js";
-import { M as l } from "./plugin-s8Ay8kKk.js";
+import { m as o } from "./plugin-zROi2Bgp.js";
+import { M as l } from "./plugin-zROi2Bgp.js";
 function a() {
-  return import("./ReportPreview-COFkbeEM.js").then((t) => t.z);
+  return import("./ReportPreview-vdZ5XYYb.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-BdvoqdOd.cjs"),l=require("./plugin-9t_ZFwhz.cjs"),P=require("vue");function v(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 C=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 M(){const r=P.shallowRef(null),e=()=>r.value?.state??C,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 S(){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 x(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 L(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 m(s,c){if(c.signal.aborted)throw c.signal.reason??new DOMException("Aborted","AbortError");const g=y(e.reportId),T={...y(e.params??{})},R=JSON.stringify([g,T]),O=++a;if(R!==i&&(i=R,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:T,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");x(d,s.edits.length),d.diagnostics?.forEach(u=>e.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:s.edits[u.editIndex]?.source,address:s.edits[u.editIndex]?.address,message:u.message}));return f(d,R,O),{revision:d.revision,sourceToken:d.sourceToken,conflicts:_}}return{requireSource:e.requireSource??!0,canEdit:e.canEdit,validate:e.validate,saveBatch:m,save:(s,c)=>m({requestId:L(c),edits:[t.cloneReportSnapshot(s)]},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=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=v;exports.createProviderEditing=F;exports.useMachReport=M;exports.useReportPreview=S;Object.keys(p).forEach(r=>{r!=="default"&&!Object.prototype.hasOwnProperty.call(exports,r)&&Object.defineProperty(exports,r,{enumerable:!0,get:()=>p[r]})});
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("@agile-team/mach-report"),t=require("./ReportPreview-fKUPcCTN.cjs"),l=require("./plugin-BAD7Ry8V.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,12 +1,12 @@
-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 f, c as y } from "./ReportPreview-COFkbeEM.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 te, h 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 } from "./ReportPreview-COFkbeEM.js";
-import { a as C } from "./plugin-s8Ay8kKk.js";
-import { b as he, c as Te, d as ve, M as xe, m as Se } from "./plugin-s8Ay8kKk.js";
-import { shallowRef as I, computed as O, inject as A } from "vue";
-function H(t) {
-  const e = x(t), o = async (r) => {
+import { P as R, M as f, c as y } from "./ReportPreview-vdZ5XYYb.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-vdZ5XYYb.js";
+import { a as C } from "./plugin-zROi2Bgp.js";
+import { b as Se, c as xe, d as Ce, M as Ae, m as Ie } from "./plugin-zROi2Bgp.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])
@@ -15,7 +15,7 @@ function H(t) {
   };
   return o.getParamDefs = e.getParamDefs, o;
 }
-const D = Object.freeze({
+const M = Object.freeze({
   loading: !1,
   hasPlan: !1,
   pageCount: 0,
@@ -27,8 +27,8 @@ const D = Object.freeze({
   error: null,
   pdfFont: Object.freeze({ status: "unchecked", fontUrl: "" })
 });
-function z() {
-  const t = I(null), e = () => t.value?.state ?? D, o = Object.freeze({
+function H() {
+  const t = A(null), e = () => t.value?.state ?? M, o = Object.freeze({
     get loading() {
       return e().loading;
     },
@@ -109,7 +109,7 @@ function z() {
       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(() => t.value !== null),
+    ready: I(() => t.value !== null),
     state: o,
     async checkPdfFont() {
       const n = r();
@@ -164,21 +164,21 @@ function z() {
     pasteSelection: async (n) => await r().pasteSelection?.(n) ?? !1
   };
 }
-function W() {
-  return A(C, null);
+function G() {
+  return O(C, null);
 }
 function m(t) {
   return !!t && typeof t == "object" && !Array.isArray(t);
 }
-function M(t) {
+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 _(t, e) {
+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 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 && !M(t.diagnostics) ? o = "结构化 diagnostics" : t.conflicts !== void 0 && !_(t.conflicts, e) && (o = "有效 editIndex/code/message conflicts"), o) throw new f("edit", `ReportProvider.save 必须返回${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(t) {
   return typeof t == "function" ? t() : t;
@@ -190,10 +190,10 @@ function F(t, e) {
 function h(t, e, o, r) {
   return typeof t == "function" ? t() : F(e, o) ?? r ?? t;
 }
-function b(t) {
+function L(t) {
   return t.requestId ?? globalThis.crypto?.randomUUID?.() ?? `mr-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
-function G(t, e) {
+function N(t, e) {
   if (!t.save) throw new f("config", "ReportProvider.save 未配置，无法启用业务保存");
   let o = "", r, n, s = 0;
   function d(a, i, g) {
@@ -202,7 +202,7 @@ function G(t, e) {
   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 S("missing");
+    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,
@@ -225,47 +225,50 @@ function G(t, e) {
     canEdit: e.canEdit,
     validate: e.validate,
     saveBatch: P,
-    save: (a, i) => P({ requestId: b(i), edits: [y(a)] }, i)
+    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,
-  Te as MACH_REPORT_FETCHER_KEY,
-  ve as MACH_REPORT_PDF_EXPORTER_KEY,
+  xe as MACH_REPORT_FETCHER_KEY,
+  Ce as MACH_REPORT_PDF_EXPORTER_KEY,
   f as MachReportError,
-  xe as MachReportPreview,
+  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,
-  te as buildPrintDocument,
-  re as buildWordHtml,
-  ne as createDefaultPdfExporter,
-  oe as createFetchRequest,
-  H as createLocalFetcher,
-  G as createProviderEditing,
-  se as createReportStoragePreferences,
-  ae as defineMachReportConfig,
-  ie as defineMachReportPreset,
-  ce as joinReportIds,
-  Se as machReportPlugin,
-  ue as normalizeReportIds,
-  fe as normalizeReportLoadError,
-  de as printPlans,
-  ge as provideMachReportConfig,
-  le as resolveConfig,
-  pe as themeToCssVars,
-  me as toErrorDetail,
-  z as useMachReport,
-  Pe 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/mach-report",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "独立的 TypeScript 报表引擎：模板分页、DOM/Canvas/PDF/Excel 输出与 Vue 3 预览组件",
   "type": "module",
   "sideEffects": [