@agile-team/mach-report 2.22.0 → 2.23.0

package/dist/vue/async.d.ts

@@ -1015,6 +1015,20 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>,
     importing?: string;
     editCell?: string;
     editingHint?: string;
+    editCellEditable?: string;
+    editCellReadOnly?: string;
+    editCellFormula?: string;
+    editCellProtected?: string;
+    editCellComplex?: string;
+    editCellStructure?: string;
+    editCellDerived?: string;
+    editCellPermission?: string;
+    editCellBusy?: string;
+    editHistoryLimited?: string;
+    changesSearch?: string;
+    changesAllDatasets?: string;
+    changesNoMatches?: string;
+    changesRange?: string;
     saving?: string;
     editInvalidNumber?: string;
     editInvalidBoolean?: string;
@@ -2068,11 +2082,21 @@ declare interface ReportEditConflict {
     currentValue?: ReportCellValue_2;
     revision?: string | number;
 }
+declare interface ReportEditHistoryOptions {
+    /** Retained undo/redo transactions. Default 100. Zero disables undo retention. */
+    maxSteps?: number;
+    /** Conservative retained transaction size in bytes. Default 8 MiB. */
+    maxBytes?: number;
+}
 /** Opt in with true for local drafts, or provide host validation and persistence. */
 declare interface ReportEditingOptions {
     /** Optional field controls, keyed by source.field / table.columnKey; a resolver supports dataset-specific rules. */
     fields?: Readonly<Record<string, ReportCellFieldOptions>> | ((context: ReportCellContext) => ReportCellFieldOptions | undefined);
     canEdit?(context: ReportCellContext): boolean;
+    /** Optional explanation when canEdit rejects a cell. Does not grant editing access. */
+    readOnlyReason?(context: ReportCellContext): string | undefined;
+    /** Bounds undo/redo retention. Net differences and getChanges remain complete. */
+    history?: ReportEditHistoryOptions;
     /** Return an error message or throw to reject the edit. */
     validate?(edit: Readonly<ReportCellEdit_2>, operation: ReportEditOperation): void | string | Promise<void | string>;
     /** Same declarative rules can be run in Node via validateReportDataset. Requires a source-backed session. */

package/dist/vue/index.d.cts

@@ -1847,6 +1847,20 @@ export declare interface MachReportMessages extends Partial<ReportCalculationMes
     importing?: string;
     editCell?: string;
     editingHint?: string;
+    editCellEditable?: string;
+    editCellReadOnly?: string;
+    editCellFormula?: string;
+    editCellProtected?: string;
+    editCellComplex?: string;
+    editCellStructure?: string;
+    editCellDerived?: string;
+    editCellPermission?: string;
+    editCellBusy?: string;
+    editHistoryLimited?: string;
+    changesSearch?: string;
+    changesAllDatasets?: string;
+    changesNoMatches?: string;
+    changesRange?: string;
     saving?: string;
     editInvalidNumber?: string;
     editInvalidBoolean?: string;
@@ -2486,7 +2500,7 @@ export declare function printPlans(plans: RenderPlan_2[], options?: {
  * 同名 preset 与 messages/theme 均按字段继承；组件 props 仍拥有最高优先级。
  */
 export declare function provideMachReportConfig(overlay: MachReportConfigInput | MachReportDefaults): void;
-export declare interface ProviderEditingOptions extends Pick<ReportEditingOptions, "canEdit" | "validate" | "requireSource"> {
+export declare interface ProviderEditingOptions extends Pick<ReportEditingOptions, "canEdit" | "readOnlyReason" | "history" | "fields" | "validate" | "validation" | "validateBatch" | "requireSource"> {
     reportId: Current<string>;
     params?: Current<Record<string, string>>;
     /** Getters are useful when query metadata is held by the host. Otherwise stable cell sources are used. */
@@ -3052,11 +3066,21 @@ declare interface ReportEditConflict {
     currentValue?: ReportCellValue;
     revision?: string | number;
 }
+export declare interface ReportEditHistoryOptions {
+    /** Retained undo/redo transactions. Default 100. Zero disables undo retention. */
+    maxSteps?: number;
+    /** Conservative retained transaction size in bytes. Default 8 MiB. */
+    maxBytes?: number;
+}
 /** Opt in with true for local drafts, or provide host validation and persistence. */
 export declare interface ReportEditingOptions {
     /** Optional field controls, keyed by source.field / table.columnKey; a resolver supports dataset-specific rules. */
     fields?: Readonly<Record<string, ReportCellFieldOptions>> | ((context: ReportCellContext) => ReportCellFieldOptions | undefined);
     canEdit?(context: ReportCellContext): boolean;
+    /** Optional explanation when canEdit rejects a cell. Does not grant editing access. */
+    readOnlyReason?(context: ReportCellContext): string | undefined;
+    /** Bounds undo/redo retention. Net differences and getChanges remain complete. */
+    history?: ReportEditHistoryOptions;
     /** Return an error message or throw to reject the edit. */
     validate?(edit: Readonly<ReportCellEdit>, operation: ReportEditOperation): void | string | Promise<void | string>;
     /** Same declarative rules can be run in Node via validateReportDataset. Requires a source-backed session. */

package/dist/vue/index.d.ts

@@ -1847,6 +1847,20 @@ export declare interface MachReportMessages extends Partial<ReportCalculationMes
     importing?: string;
     editCell?: string;
     editingHint?: string;
+    editCellEditable?: string;
+    editCellReadOnly?: string;
+    editCellFormula?: string;
+    editCellProtected?: string;
+    editCellComplex?: string;
+    editCellStructure?: string;
+    editCellDerived?: string;
+    editCellPermission?: string;
+    editCellBusy?: string;
+    editHistoryLimited?: string;
+    changesSearch?: string;
+    changesAllDatasets?: string;
+    changesNoMatches?: string;
+    changesRange?: string;
     saving?: string;
     editInvalidNumber?: string;
     editInvalidBoolean?: string;
@@ -2486,7 +2500,7 @@ export declare function printPlans(plans: RenderPlan_2[], options?: {
  * 同名 preset 与 messages/theme 均按字段继承；组件 props 仍拥有最高优先级。
  */
 export declare function provideMachReportConfig(overlay: MachReportConfigInput | MachReportDefaults): void;
-export declare interface ProviderEditingOptions extends Pick<ReportEditingOptions, "canEdit" | "validate" | "requireSource"> {
+export declare interface ProviderEditingOptions extends Pick<ReportEditingOptions, "canEdit" | "readOnlyReason" | "history" | "fields" | "validate" | "validation" | "validateBatch" | "requireSource"> {
     reportId: Current<string>;
     params?: Current<Record<string, string>>;
     /** Getters are useful when query metadata is held by the host. Otherwise stable cell sources are used. */
@@ -3052,11 +3066,21 @@ declare interface ReportEditConflict {
     currentValue?: ReportCellValue;
     revision?: string | number;
 }
+export declare interface ReportEditHistoryOptions {
+    /** Retained undo/redo transactions. Default 100. Zero disables undo retention. */
+    maxSteps?: number;
+    /** Conservative retained transaction size in bytes. Default 8 MiB. */
+    maxBytes?: number;
+}
 /** Opt in with true for local drafts, or provide host validation and persistence. */
 export declare interface ReportEditingOptions {
     /** Optional field controls, keyed by source.field / table.columnKey; a resolver supports dataset-specific rules. */
     fields?: Readonly<Record<string, ReportCellFieldOptions>> | ((context: ReportCellContext) => ReportCellFieldOptions | undefined);
     canEdit?(context: ReportCellContext): boolean;
+    /** Optional explanation when canEdit rejects a cell. Does not grant editing access. */
+    readOnlyReason?(context: ReportCellContext): string | undefined;
+    /** Bounds undo/redo retention. Net differences and getChanges remain complete. */
+    history?: ReportEditHistoryOptions;
     /** Return an error message or throw to reject the edit. */
     validate?(edit: Readonly<ReportCellEdit>, operation: ReportEditOperation): void | string | Promise<void | string>;
     /** Same declarative rules can be run in Node via validateReportDataset. Requires a source-backed session. */

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-AcAQ2m9X.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-Dw-4icG6.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-BFANt-i8.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-FFIryrIr.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-w5Nyt08U.js";
-import { M as l } from "./plugin-w5Nyt08U.js";
+import { m as o } from "./plugin-DeYYAL6F.js";
+import { M as l } from "./plugin-DeYYAL6F.js";
 function a() {
-  return import("./ReportPreview-BDgKssYR.js").then((t) => t.x);
+  return import("./ReportPreview-DeWzG8jQ.js").then((t) => t.x);
 }
 const n = {
   install(t, r = {}) {

package/dist/vue.cjs

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

package/dist/vue.js

@@ -1,17 +1,17 @@
-import { createReportSource as v, ReportCellEditError as A } from "@agile-team/mach-report";
+import { createReportSource as T, ReportCellEditError as A } from "@agile-team/mach-report";
 export * from "@agile-team/mach-report";
-import { P as R, c as h } from "./ReportPreview-BDgKssYR.js";
-import { R as Z, a as Q, _ as ee, b as re, d as te, e as ne, f as oe, g as se, h as ae, i as ie, j as ce, k as ue, l as fe, m as le, n as de, o as ge, p as pe, q as Pe, r as me, s as Ee, t as Re, u as he, v as we, w as ye } from "./ReportPreview-BDgKssYR.js";
-import { M as f } from "./ReportParamPanel-BHSKVL8k.js";
-import { D as Te, a as ve, b as Ae, c as xe, d as Ce, P as _e, R as Ie, S as Me, e as Oe, f as De, n as ke, p as Fe, g as Le, r as be, h as Ue, i as qe, s as je, t as Ge, j as Ne, u as He } from "./ReportParamPanel-BHSKVL8k.js";
+import { P as R, c as h } from "./ReportPreview-DeWzG8jQ.js";
+import { R as Z, a as Q, _ as ee, b as re, d as te, e as ne, f as oe, g as ae, h as se, i as ie, j as ce, k as ue, l as fe, m as le, n as de, o as ge, p as pe, q as Pe, r as me, s as Ee, t as Re, u as he, v as ye, w as we } from "./ReportPreview-DeWzG8jQ.js";
+import { M as f } from "./ReportParamPanel-Dgmqro1Y.js";
+import { D as ve, a as Te, b as Ae, c as xe, d as Ce, P as Oe, R as _e, S as Ie, e as Me, f as De, n as ke, p as Fe, g as Le, r as be, h as Ue, i as qe, s as je, t as Ge, j as Ne, u as He } from "./ReportParamPanel-Dgmqro1Y.js";
 import { M as x } from "./injection-keys-e85udZCp.js";
 import { a as ze, b as Ve, c as Ye } from "./injection-keys-e85udZCp.js";
-import { M as $e, m as Xe } from "./plugin-w5Nyt08U.js";
-import { shallowRef as C, computed as _, inject as I } from "vue";
-import { x as M } from "./json-snapshot-DvQbZlD7.js";
-import { a as O } from "./progress-Hc2vxoCs.js";
+import { M as $e, m as Be } from "./plugin-DeYYAL6F.js";
+import { shallowRef as C, computed as O, inject as _ } from "vue";
+import { v as I } from "./json-snapshot-OqkPyUk5.js";
+import { u as M } from "./progress-ByiOxUD3.js";
 function V(r) {
-  const e = v(r), o = async (t) => {
+  const e = T(r), o = async (t) => {
     if (t.reportIds.length === 0) throw new R("缺少报表 ID");
     for (const n of t.reportIds)
       if (!Object.prototype.hasOwnProperty.call(r, n) || !r[n])
@@ -114,10 +114,10 @@ function Y() {
   }
   return {
     ref(n) {
-      const s = n;
-      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;
+      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: _(() => r.value !== null),
+    ready: O(() => r.value !== null),
     state: o,
     async checkPdfFont() {
       const n = t();
@@ -147,13 +147,13 @@ function Y() {
     gotoPage(n) {
       t().gotoPage(n);
     },
-    async setParams(n, s) {
-      await t().setParams(n, s);
+    async setParams(n, a) {
+      await t().setParams(n, a);
     },
-    async importExcel(n, s) {
+    async importExcel(n, a) {
       const l = t();
       if (!l.importExcel) throw new f("config", "旧自定义控制器未提供 Excel 导入");
-      return l.importExcel(n, s);
+      return l.importExcel(n, a);
     },
     getPlan() {
       return t().getPlan?.() ?? null;
@@ -166,20 +166,20 @@ function Y() {
     redo: async () => await t().redo?.() ?? !1,
     restoreChanges: async () => await t().restoreChanges?.() ?? !1,
     getSelection: () => t().getSelection?.() ?? null,
-    focusCell: async (n, s) => await t().focusCell?.(n, s) ?? !1,
+    focusCell: async (n, a) => await t().focusCell?.(n, a) ?? !1,
     focusField: async (n) => await t().focusField?.(n) ?? !1,
     copySelection: () => t().copySelection?.() ?? "",
     pasteSelection: async (n) => await t().pasteSelection?.(n) ?? !1
   };
 }
 function K() {
-  return I(x, null);
+  return _(x, null);
 }
 function P(r) {
   return !!r && typeof r == "object" && !Array.isArray(r);
 }
 function k(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") && M(e));
+  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") && I(e));
 }
 function F(r, e) {
   return Array.isArray(r) && r.every((o) => P(o) && Number.isSafeInteger(o.editIndex) && o.editIndex >= 0 && o.editIndex < e && typeof o.code == "string" && typeof o.message == "string");
@@ -188,14 +188,14 @@ function L(r, e) {
   let o;
   if (!P(r) || typeof r.revision != "string" || !r.revision.trim() ? o = "非空 revision（请先在适配器解包业务响应）" : r.sourceToken !== void 0 && typeof r.sourceToken != "string" ? o = "字符串 sourceToken" : r.diagnostics !== void 0 && !k(r.diagnostics) ? o = "结构化 diagnostics" : r.conflicts !== void 0 && !F(r.conflicts, e) && (o = "有效 editIndex/code/message conflicts"), o) throw new f("edit", `ReportProvider.save 必须返回${o}；服务器可能已提交，请重新查询确认后再编辑`);
 }
-function w(r) {
+function y(r) {
   return typeof r == "function" ? r() : r;
 }
 function b(r, e) {
   const o = new Set(r.flatMap((t) => t.source?.[e] === void 0 ? [] : [String(t.source[e])]));
   return o.size === 1 ? [...o][0] : void 0;
 }
-function y(r, e, o, t) {
+function w(r, e, o, t) {
   return typeof r == "function" ? r() : b(e, o) ?? t ?? r;
 }
 function U(r) {
@@ -203,42 +203,47 @@ function U(r) {
 }
 function $(r, e) {
   if (!r.save) throw new f("config", "ReportProvider.save 未配置，无法启用业务保存");
-  let o = "", t, n, s = 0;
-  function l(a, i, d) {
-    a.conflicts?.length || i !== o || d !== s || (t = a.revision, n = a.sourceToken);
+  let o = "", t, n, a = 0;
+  function l(s, i, d) {
+    s.conflicts?.length || i !== o || d !== a || (t = s.revision, n = s.sourceToken);
   }
-  async function m(a, i) {
+  async function m(s, i) {
     if (i.signal.aborted) throw i.signal.reason ?? new DOMException("Aborted", "AbortError");
-    const d = w(e.reportId), E = { ...w(e.params ?? {}) }, g = JSON.stringify([d, E]), S = ++s;
-    if (g !== o && (o = g, t = void 0, n = void 0), e.requireSource !== !1 && a.edits.some((c) => !c.source)) throw new A("missing");
+    const d = y(e.reportId), E = { ...y(e.params ?? {}) }, g = JSON.stringify([d, E]), S = ++a;
+    if (g !== o && (o = g, t = void 0, n = void 0), e.requireSource !== !1 && s.edits.some((c) => !c.source)) throw new A("missing");
     const u = await r.save({
       reportId: d,
       params: E,
       signal: i.signal,
-      requestId: a.requestId,
+      requestId: s.requestId,
       action: i.action,
-      edits: h(a.edits),
-      expectedRevision: y(e.expectedRevision, a.edits, "revision", t),
-      sourceToken: y(e.sourceToken, a.edits, "sourceToken", n)
+      edits: h(s.edits),
+      expectedRevision: w(e.expectedRevision, s.edits, "revision", t),
+      sourceToken: w(e.sourceToken, s.edits, "sourceToken", n)
     });
     if (i.signal.aborted) throw i.signal.reason ?? new DOMException("Aborted", "AbortError");
-    L(u, a.edits.length), u.diagnostics?.forEach((c) => O(() => e.onDiagnostic?.(c)));
+    L(u, s.edits.length), u.diagnostics?.forEach((c) => M(() => 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 T = u.conflicts?.map((c) => ({ source: a.edits[c.editIndex]?.source, address: a.edits[c.editIndex]?.address, message: c.message }));
-    return l(u, g, S), { revision: u.revision, sourceToken: u.sourceToken, conflicts: T };
+    const v = u.conflicts?.map((c) => ({ source: s.edits[c.editIndex]?.source, address: s.edits[c.editIndex]?.address, message: c.message }));
+    return l(u, g, S), { revision: u.revision, sourceToken: u.sourceToken, conflicts: v };
   }
   return {
     requireSource: e.requireSource ?? !0,
     canEdit: e.canEdit,
+    readOnlyReason: e.readOnlyReason,
+    history: e.history,
+    fields: e.fields,
     validate: e.validate,
+    validation: e.validation,
+    validateBatch: e.validateBatch,
     saveBatch: m,
-    save: (a, i) => m({ requestId: U(i), edits: [h(a)] }, i)
+    save: (s, i) => m({ requestId: U(i), edits: [h(s)] }, i)
   };
 }
 export {
-  Te as DEFAULT_CALCULATION_MESSAGES,
-  ve as DEFAULT_DATA_REVIEW_MESSAGES,
+  ve as DEFAULT_CALCULATION_MESSAGES,
+  Te as DEFAULT_DATA_REVIEW_MESSAGES,
   Ae as DEFAULT_MESSAGES,
   xe as DEFAULT_PRINT_MESSAGES,
   Ce as DEFAULT_THEME,
@@ -248,21 +253,21 @@ export {
   Ye as MACH_REPORT_PDF_EXPORTER_KEY,
   f as MachReportError,
   $e as MachReportPreview,
-  _e as PARAM_OPTIONS_MESSAGES,
+  Oe as PARAM_OPTIONS_MESSAGES,
   R as PlanLoadError,
   Z as REPORT_EXPORT_FORMATS,
   Q as REPORT_PREVIEW_TOOLS,
   ee as ReportDataComparisonPanel,
   re as ReportExportMenu,
   te as ReportPagination,
-  Ie as ReportParamPanel,
+  _e as ReportParamPanel,
   ne as ReportPrefillPanel,
   oe as ReportPreview,
-  se as ReportPrintResourceError,
-  ae as ReportTaskStatus,
+  ae as ReportPrintResourceError,
+  se as ReportTaskStatus,
   ie as ReportToolbar,
   ce as ReportValidationPanel,
-  Me as SILENT_LOGGER,
+  Ie as SILENT_LOGGER,
   ue as buildPrintDocument,
   fe as buildWordHtml,
   le as createDefaultPdfExporter,
@@ -271,10 +276,10 @@ export {
   ge as createPrintCalibrationPlan,
   $ as createProviderEditing,
   pe as createReportStoragePreferences,
-  Oe as defineMachReportConfig,
+  Me as defineMachReportConfig,
   De as defineMachReportPreset,
   Pe as joinReportIds,
-  Xe as machReportPlugin,
+  Be as machReportPlugin,
   me as normalizeReportIds,
   ke as normalizeReportLoadError,
   Ee as preparePrintResources,
@@ -290,7 +295,7 @@ export {
   Y as useMachReport,
   He as useMachReportConfig,
   he as usePageWindow,
-  we as usePrintExport,
+  ye as usePrintExport,
   K as useReportPreview,
-  ye as useZoom
+  we as useZoom
 };