@agile-team/mach-report 2.15.0 → 2.17.0

package/dist/vue/index.d.ts

@@ -74,6 +74,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -244,6 +248,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -325,6 +333,7 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     showPdfWindow: boolean;
     showSettings: boolean;
     showParams: boolean;
+    exportExecution: ReportExportExecutionOptions;
     drill: ReportDrillOptions;
     loadParamOptions: ReportParamOptionsLoader;
     printOptions: ReportPrintOptions;
@@ -489,13 +498,42 @@ declare interface AssetRenderBudget {
     /** Wall-clock budget, including adapters that ignore AbortSignal. Default 30 seconds. */
     maxDurationMs?: number;
 }
+declare interface AssetRenderBudget_2 {
+    /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
+    maxAssets?: number;
+    /** Maximum image payload bytes per new asset, default 32 MiB. */
+    maxImageBytes?: number;
+    /** Maximum total image payload bytes for new assets, default 128 MiB. */
+    maxTotalImageBytes?: number;
+    /** Wall-clock budget, including adapters that ignore AbortSignal. Default 30 seconds. */
+    maxDurationMs?: number;
+}
 declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+declare interface AssetRenderOptions_2 extends OutputDiagnosticOptions_2, ImageMediaOptions_2 {
+    assetRenderers?: Partial<Record<ImageComponentKind_2, ComponentImageRenderer_2>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry_2;
+    assetBudget?: AssetRenderBudget_2;
+    /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
+    assetFailure?: "throw" | "placeholder";
+    signal?: AbortSignal;
+}
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
 /** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
 export declare function buildPrintDocument(p: RenderPlan, options?: ReportPrintOptions): PrintHtmlResult;
 export declare function buildWordHtml(p: RenderPlan): {
@@ -601,6 +639,14 @@ declare type ColumnFormat_3 = {
     kind: "date";
     pattern?: string;
 };
+declare interface ComponentAssetRegistry {
+    rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
+declare interface ComponentAssetRegistry_2 {
+    rendererFor(component: Readonly<PlanComponent_2>): ComponentImageRenderer_2 | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
 /** A literal own field of the current label record; expressions and paths are not evaluated. */
 declare interface ComponentBinding {
     field: string;
@@ -632,7 +678,15 @@ declare interface ComponentImageContext {
     readonly componentPath: readonly number[];
     readonly signal: AbortSignal;
 }
+declare interface ComponentImageContext_2 {
+    readonly component: Readonly<PlanComponent_2>;
+    readonly pageIndex: number;
+    readonly componentIndex: number;
+    readonly componentPath: readonly number[];
+    readonly signal: AbortSignal;
+}
 declare type ComponentImageRenderer = (context: ComponentImageContext) => string | Promise<string>;
+declare type ComponentImageRenderer_2 = (context: ComponentImageContext_2) => string | Promise<string>;
 declare type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
 declare type ComponentKind_2 = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
 declare type ComponentKind_3 = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
@@ -907,6 +961,8 @@ declare interface FormulaAdapter {
     }): unknown;
 }
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -930,6 +986,8 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_2[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -953,6 +1011,8 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_3[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -984,6 +1044,7 @@ export declare type HostRequest = (config: {
     signal?: AbortSignal;
 }) => Promise<unknown>;
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
+declare type ImageComponentKind_2 = "image" | "chart" | "barcode" | "qrcode";
 /** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
 declare interface ImageMediaOptions {
     maxImageBytes?: number;
@@ -1422,6 +1483,8 @@ export declare interface MachReportController {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 export declare interface MachReportDefaults {
+    /** Small encodes stay local; optional Worker isolation uses the same prepared plan for large output. */
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
@@ -1778,6 +1841,57 @@ export declare interface MachReportToolbarOptions {
     /** 未传时显示全部已有出口；空数组表示不提供导出工具。 */
     exportFormats?: ReportExportFormat[];
 }
+declare interface MatrixAxisOptions {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+declare interface MatrixAxisOptions_2 {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder_2[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+declare interface MatrixAxisOptions_3 {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder_3[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+declare type MatrixDimensionOrder = "source" | "asc" | "desc";
+declare type MatrixDimensionOrder_2 = "source" | "asc" | "desc";
+declare type MatrixDimensionOrder_3 = "source" | "asc" | "desc";
+declare interface MatrixHierarchyOptions {
+    row?: MatrixAxisOptions;
+    column?: MatrixAxisOptions;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+declare interface MatrixHierarchyOptions_2 {
+    row?: MatrixAxisOptions_2;
+    column?: MatrixAxisOptions_2;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+declare interface MatrixHierarchyOptions_3 {
+    row?: MatrixAxisOptions_3;
+    column?: MatrixAxisOptions_3;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
 declare interface MatrixTableOptions {
     rowFields: readonly string[];
     columnFields: readonly string[];
@@ -1792,6 +1906,10 @@ declare interface MatrixTableOptions {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 declare interface MatrixTableOptions_2 {
     rowFields: readonly string[];
@@ -1807,6 +1925,10 @@ declare interface MatrixTableOptions_2 {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions_2;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 declare interface MatrixTableOptions_3 {
     rowFields: readonly string[];
@@ -1822,6 +1944,10 @@ declare interface MatrixTableOptions_3 {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions_3;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 export declare function normalizeReportIds(reportId: ReportIdInput): string[];
 /** Workers preserve stable error codes, not JavaScript class identity. Only known codes cross the UI boundary. */
@@ -1836,6 +1962,11 @@ declare interface OutputDiagnostic {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 declare interface OutputDiagnostic_2 {
@@ -1848,6 +1979,11 @@ declare interface OutputDiagnostic_2 {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 declare interface OutputDiagnosticOptions extends OutputTaskOptions {
@@ -1909,6 +2045,8 @@ export declare interface PdfExporter {
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
     checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+    /** Optional resource preparation for isolated encoding; custom exporters without it keep their own pipeline. */
+    prepare?: (signal?: AbortSignal) => Promise<ReportPdfFontOptions>;
 }
 export declare interface PdfFontCheckResult {
     status: PdfFontStatus;
@@ -2110,6 +2248,16 @@ declare interface PlanTableFragment_3 {
 }
 /** Bounded concurrency, one stage timeout, and cancellation even for a hanging decoder. */
 export declare function preparePrintResources(doc: Document, options?: ReportPrintOptions, signal?: AbortSignal, base?: string): Promise<void>;
+declare interface PreviewEncoding {
+    pdf(plan: RenderPlan, exporter: PdfExporter, warning: (message: string) => void, task?: PreviewEncodingTask): Promise<Uint8Array>;
+    xlsx(plan: RenderPlan, options: XlsxRenderOptions, task: PreviewEncodingTask): Promise<{
+        buffer: Uint8Array;
+        warnings: string[];
+    }>;
+}
+declare type PreviewEncodingTask = OutputTaskOptions_2 & {
+    onDiagnostic?: (entry: OutputDiagnostic) => void;
+};
 export declare function printCalibration(options?: ReportPrintOptions): {
     x: number;
     y: number;
@@ -2462,8 +2610,36 @@ export declare interface ReportEmptyState {
     title?: string;
     description?: string;
 }
+export declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+export declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 export declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+export declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
 declare type ReportExpression = {
     field: string;
 } | {
@@ -2514,7 +2690,13 @@ declare interface ReportFetchInput extends ReportTaskMonitoring {
     /** Index scopes diagnostics when reports share datasets or a report ID is repeated. */
     onQueryResult?: (reportId: string, result: ReportQueryResult, reportIndex?: number) => void;
 }
-declare interface ReportFieldContract {
+declare type ReportFieldAggregation = "sum" | "avg" | "min" | "max" | "count" | "none";
+declare interface ReportFieldCalculation {
+    /** Business-owned explanation, never executable JavaScript or an inferred business formula. */
+    description: string;
+    dependsOn: readonly string[];
+}
+declare interface ReportFieldContract extends ReportFieldSemantics {
     field: string;
     label?: string;
     type: "text" | "number" | "boolean" | "date" | "decimal";
@@ -2528,6 +2710,16 @@ declare interface ReportFieldContract {
     semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
     unit?: string;
 }
+declare interface ReportFieldSemantics {
+    description?: string;
+    /** Explicit meaning of null/missing; does not convert blanks into zero. */
+    missingMeaning?: string;
+    /** Recommended aggregation; none marks non-additive measures such as ratios. No aggregation runs implicitly. */
+    aggregation?: ReportFieldAggregation;
+    /** Shared presentation only; raw values and calculation precision remain unchanged. */
+    format?: ColumnFormat;
+    calculation?: ReportFieldCalculation;
+}
 export declare interface ReportFieldTarget {
     field: string;
     datasetId?: string;
@@ -2707,12 +2899,23 @@ export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     onQuery?: (() => any) | undefined;
     "onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
 }>, {
+    issues: readonly ReportParamIssue[];
     disabled: boolean;
     loadOptions: ReportParamOptionsLoader;
-    issues: readonly ReportParamIssue[];
     showActions: boolean;
     showTitle: boolean;
 }>;
+/** Licensed local font bytes; never downloaded implicitly by the runtime. */
+declare interface ReportPdfFontOptions {
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    customFontFaces?: {
+        regular: Uint8Array | ArrayBuffer;
+        bold?: Uint8Array | ArrayBuffer;
+        italic?: Uint8Array | ArrayBuffer;
+        boldItalic?: Uint8Array | ArrayBuffer;
+    };
+}
 export declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -2811,6 +3014,15 @@ declare interface ReportQueryResult {
     diagnostics?: ReportDiagnostic[];
 }
 declare type ReportRegistry = Record<string, ReportDefinition>;
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
 declare interface ReportSaveInput extends ReportLoadContext {
     requestId: string;
     expectedRevision?: string;
@@ -2928,6 +3140,7 @@ declare type ReportValueState_2 = "missing-source" | "not-applicable" | "not-cal
 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">> & {
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     pdfFontUrl: string;
@@ -3187,6 +3400,8 @@ export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     /** Flush the active editor and await source-backed calculation/persistence before capturing the output plan. */
     beforeOutput?: () => boolean | Promise<boolean>;
     getPdfExporter: () => PdfExporter;
+    /** Optional prepared-plan encoders; legacy callers keep their injected exporter unchanged. */
+    encoding?: PreviewEncoding;
     onError: (message: string, code?: string) => void;
     onWarning?: (message: string) => void;
     onBusy?: (format: string | null) => void;
@@ -3247,7 +3462,7 @@ declare type XlsxImageOptions = ImageMediaOptions_2;
  *   目标是"财务能直接用的对账表"而非复刻版面）
  * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
-declare interface XlsxRenderOptions extends OutputDiagnosticOptions_2, XlsxImageOptions {
+declare interface XlsxRenderOptions extends AssetRenderOptions_2, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */
     sheetName?: (sheetIndex: number) => string;
     /** auto 默认将 wide 逻辑表合并为连续 Sheet；pages 保留逐页；continuous 要求明确的表来源。 */

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-DHO7X8z2.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-DbLvvOUT.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-CtFX9PFG.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-CJC_-j2I.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-Ca_XZG3l.js";
-import { M as l } from "./plugin-Ca_XZG3l.js";
+import { m as o } from "./plugin-BBp74CQZ.js";
+import { M as l } from "./plugin-BBp74CQZ.js";
 function a() {
-  return import("./ReportPreview-ChV19HBp.js").then((t) => t.s);
+  return import("./ReportPreview-BdQawRh0.js").then((t) => t.s);
 }
 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"),i=require("./ReportPreview-DbLvvOUT.cjs"),a=require("./config-D10us76d.cjs"),g=require("./injection-keys-Db_DyLkm.cjs"),y=require("./plugin-DHO7X8z2.cjs"),h=require("vue"),M=require("./data-explanation-DE55G30w.cjs"),A=require("./progress-B0ctFpKf.cjs");function v(r){const e=E.createReportSource(r),o=async t=>{if(t.reportIds.length===0)throw new i.PlanLoadError("缺少报表 ID");for(const n of t.reportIds)if(!Object.prototype.hasOwnProperty.call(r,n)||!r[n])throw new i.PlanLoadError(`本地模板 ${n} 不存在`);return e(t)};return o.getParamDefs=e.getParamDefs,o}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 L(){const r=h.shallowRef(null),e=()=>r.value?.state??I,o=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 t(){if(!r.value)throw new a.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:o,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 f=t();if(!f.importExcel)throw new a.MachReportError("config","旧自定义控制器未提供 Excel 导入");return f.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 D(){return h.inject(g.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")&&M.hasValidDataExplanation(e))}function F(r,e){return Array.isArray(r)&&r.every(o=>T(o)&&Number.isSafeInteger(o.editIndex)&&o.editIndex>=0&&o.editIndex<e&&typeof o.code=="string"&&typeof o.message=="string")}function b(r,e){let o;if(!T(r)||typeof r.revision!="string"||!r.revision.trim()?o="非空 revision（请先在适配器解包业务响应）":r.sourceToken!==void 0&&typeof r.sourceToken!="string"?o="字符串 sourceToken":r.diagnostics!==void 0&&!x(r.diagnostics)?o="结构化 diagnostics":r.conflicts!==void 0&&!F(r.conflicts,e)&&(o="有效 editIndex/code/message conflicts"),o)throw new a.MachReportError("edit",`ReportProvider.save 必须返回${o}；服务器可能已提交，请重新查询确认后再编辑`)}function O(r){return typeof r=="function"?r():r}function q(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 _(r,e,o,t){return typeof r=="function"?r():q(e,o)??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 a.MachReportError("config","ReportProvider.save 未配置，无法启用业务保存");let o="",t,n,s=0;function f(c,u,p){c.conflicts?.length||u!==o||p!==s||(t=c.revision,n=c.sourceToken)}async function S(c,u){if(u.signal.aborted)throw u.signal.reason??new DOMException("Aborted","AbortError");const p=O(e.reportId),m={...O(e.params??{})},R=JSON.stringify([p,m]),C=++s;if(R!==o&&(o=R,t=void 0,n=void 0),e.requireSource!==!1&&c.edits.some(l=>!l.source))throw new E.ReportCellEditError("missing");const d=await r.save({reportId:p,params:m,signal:u.signal,requestId:c.requestId,action:u.action,edits:i.cloneReportSnapshot(c.edits),expectedRevision:_(e.expectedRevision,c.edits,"revision",t),sourceToken:_(e.sourceToken,c.edits,"sourceToken",n)});if(u.signal.aborted)throw u.signal.reason??new DOMException("Aborted","AbortError");b(d,c.edits.length),d.diagnostics?.forEach(l=>A.observeOutput(()=>e.onDiagnostic?.(l)));const P=d.diagnostics?.filter(l=>l.severity==="error");if(P?.length)throw new a.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,C),{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:[i.cloneReportSnapshot(c)]},u)}}exports.PlanLoadError=i.PlanLoadError;exports.REPORT_EXPORT_FORMATS=i.REPORT_EXPORT_FORMATS;exports.REPORT_PREVIEW_TOOLS=i.REPORT_PREVIEW_TOOLS;exports.ReportPagination=i.ReportPagination;exports.ReportPreview=i.ReportPreview;exports.ReportPrintResourceError=i.ReportPrintResourceError;exports.ReportToolbar=i.ReportToolbar;exports.buildPrintDocument=i.buildPrintDocument;exports.buildWordHtml=i.buildWordHtml;exports.createDefaultPdfExporter=i.createDefaultPdfExporter;exports.createFetchRequest=i.createFetchRequest;exports.createPrintCalibrationPlan=i.createPrintCalibrationPlan;exports.createReportStoragePreferences=i.createReportStoragePreferences;exports.joinReportIds=i.joinReportIds;exports.normalizeReportIds=i.normalizeReportIds;exports.preparePrintResources=i.preparePrintResources;exports.printPlans=i.printPlans;exports.usePageWindow=i.usePageWindow;exports.usePrintExport=i.usePrintExport;exports.useZoom=i.useZoom;exports.DEFAULT_CALCULATION_MESSAGES=a.DEFAULT_CALCULATION_MESSAGES;exports.DEFAULT_MESSAGES=a.DEFAULT_MESSAGES;exports.DEFAULT_PRINT_MESSAGES=a.DEFAULT_PRINT_MESSAGES;exports.DEFAULT_THEME=a.DEFAULT_THEME;exports.MachReportError=a.MachReportError;exports.PARAM_OPTIONS_MESSAGES=a.PARAM_OPTIONS_MESSAGES;exports.ReportParamPanel=a.ReportParamPanel;exports.SILENT_LOGGER=a.SILENT_LOGGER;exports.defineMachReportConfig=a.defineMachReportConfig;exports.defineMachReportPreset=a.defineMachReportPreset;exports.normalizeReportLoadError=a.normalizeReportLoadError;exports.printCalibration=a.printCalibration;exports.provideMachReportConfig=a.provideMachReportConfig;exports.resolveCalculationMessages=a.resolveCalculationMessages;exports.resolveConfig=a.resolveConfig;exports.snapshotPrintOptions=a.snapshotPrintOptions;exports.themeToCssVars=a.themeToCssVars;exports.toErrorDetail=a.toErrorDetail;exports.useMachReportConfig=a.useMachReportConfig;exports.MACH_REPORT_CONFIG_KEY=g.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=g.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=g.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=g.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=y.MachReportPreview;exports.machReportPlugin=y.machReportPlugin;exports.createLocalFetcher=v;exports.createProviderEditing=U;exports.useMachReport=L;exports.useReportPreview=D;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"),i=require("./ReportPreview-CJC_-j2I.cjs"),a=require("./config-Dg_o8e7m.cjs"),g=require("./injection-keys-Db_DyLkm.cjs"),y=require("./plugin-CtFX9PFG.cjs"),h=require("vue"),M=require("./json-snapshot-D7PE1NsU.cjs"),A=require("./progress-B0ctFpKf.cjs");function v(r){const e=E.createReportSource(r),o=async t=>{if(t.reportIds.length===0)throw new i.PlanLoadError("缺少报表 ID");for(const n of t.reportIds)if(!Object.prototype.hasOwnProperty.call(r,n)||!r[n])throw new i.PlanLoadError(`本地模板 ${n} 不存在`);return e(t)};return o.getParamDefs=e.getParamDefs,o}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 L(){const r=h.shallowRef(null),e=()=>r.value?.state??I,o=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 t(){if(!r.value)throw new a.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:o,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 f=t();if(!f.importExcel)throw new a.MachReportError("config","旧自定义控制器未提供 Excel 导入");return f.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 D(){return h.inject(g.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")&&M.hasValidDataExplanation(e))}function F(r,e){return Array.isArray(r)&&r.every(o=>T(o)&&Number.isSafeInteger(o.editIndex)&&o.editIndex>=0&&o.editIndex<e&&typeof o.code=="string"&&typeof o.message=="string")}function b(r,e){let o;if(!T(r)||typeof r.revision!="string"||!r.revision.trim()?o="非空 revision（请先在适配器解包业务响应）":r.sourceToken!==void 0&&typeof r.sourceToken!="string"?o="字符串 sourceToken":r.diagnostics!==void 0&&!x(r.diagnostics)?o="结构化 diagnostics":r.conflicts!==void 0&&!F(r.conflicts,e)&&(o="有效 editIndex/code/message conflicts"),o)throw new a.MachReportError("edit",`ReportProvider.save 必须返回${o}；服务器可能已提交，请重新查询确认后再编辑`)}function O(r){return typeof r=="function"?r():r}function q(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 _(r,e,o,t){return typeof r=="function"?r():q(e,o)??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 a.MachReportError("config","ReportProvider.save 未配置，无法启用业务保存");let o="",t,n,s=0;function f(c,u,p){c.conflicts?.length||u!==o||p!==s||(t=c.revision,n=c.sourceToken)}async function S(c,u){if(u.signal.aborted)throw u.signal.reason??new DOMException("Aborted","AbortError");const p=O(e.reportId),m={...O(e.params??{})},R=JSON.stringify([p,m]),C=++s;if(R!==o&&(o=R,t=void 0,n=void 0),e.requireSource!==!1&&c.edits.some(l=>!l.source))throw new E.ReportCellEditError("missing");const d=await r.save({reportId:p,params:m,signal:u.signal,requestId:c.requestId,action:u.action,edits:i.cloneReportSnapshot(c.edits),expectedRevision:_(e.expectedRevision,c.edits,"revision",t),sourceToken:_(e.sourceToken,c.edits,"sourceToken",n)});if(u.signal.aborted)throw u.signal.reason??new DOMException("Aborted","AbortError");b(d,c.edits.length),d.diagnostics?.forEach(l=>A.observeOutput(()=>e.onDiagnostic?.(l)));const P=d.diagnostics?.filter(l=>l.severity==="error");if(P?.length)throw new a.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,C),{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:[i.cloneReportSnapshot(c)]},u)}}exports.PlanLoadError=i.PlanLoadError;exports.REPORT_EXPORT_FORMATS=i.REPORT_EXPORT_FORMATS;exports.REPORT_PREVIEW_TOOLS=i.REPORT_PREVIEW_TOOLS;exports.ReportPagination=i.ReportPagination;exports.ReportPreview=i.ReportPreview;exports.ReportPrintResourceError=i.ReportPrintResourceError;exports.ReportToolbar=i.ReportToolbar;exports.buildPrintDocument=i.buildPrintDocument;exports.buildWordHtml=i.buildWordHtml;exports.createDefaultPdfExporter=i.createDefaultPdfExporter;exports.createFetchRequest=i.createFetchRequest;exports.createPrintCalibrationPlan=i.createPrintCalibrationPlan;exports.createReportStoragePreferences=i.createReportStoragePreferences;exports.joinReportIds=i.joinReportIds;exports.normalizeReportIds=i.normalizeReportIds;exports.preparePrintResources=i.preparePrintResources;exports.printPlans=i.printPlans;exports.usePageWindow=i.usePageWindow;exports.usePrintExport=i.usePrintExport;exports.useZoom=i.useZoom;exports.DEFAULT_CALCULATION_MESSAGES=a.DEFAULT_CALCULATION_MESSAGES;exports.DEFAULT_MESSAGES=a.DEFAULT_MESSAGES;exports.DEFAULT_PRINT_MESSAGES=a.DEFAULT_PRINT_MESSAGES;exports.DEFAULT_THEME=a.DEFAULT_THEME;exports.MachReportError=a.MachReportError;exports.PARAM_OPTIONS_MESSAGES=a.PARAM_OPTIONS_MESSAGES;exports.ReportParamPanel=a.ReportParamPanel;exports.SILENT_LOGGER=a.SILENT_LOGGER;exports.defineMachReportConfig=a.defineMachReportConfig;exports.defineMachReportPreset=a.defineMachReportPreset;exports.normalizeReportLoadError=a.normalizeReportLoadError;exports.printCalibration=a.printCalibration;exports.provideMachReportConfig=a.provideMachReportConfig;exports.resolveCalculationMessages=a.resolveCalculationMessages;exports.resolveConfig=a.resolveConfig;exports.snapshotPrintOptions=a.snapshotPrintOptions;exports.themeToCssVars=a.themeToCssVars;exports.toErrorDetail=a.toErrorDetail;exports.useMachReportConfig=a.useMachReportConfig;exports.MACH_REPORT_CONFIG_KEY=g.MACH_REPORT_CONFIG_KEY;exports.MACH_REPORT_CONTROLLER_KEY=g.MACH_REPORT_CONTROLLER_KEY;exports.MACH_REPORT_FETCHER_KEY=g.MACH_REPORT_FETCHER_KEY;exports.MACH_REPORT_PDF_EXPORTER_KEY=g.MACH_REPORT_PDF_EXPORTER_KEY;exports.MachReportPreview=y.MachReportPreview;exports.machReportPlugin=y.machReportPlugin;exports.createLocalFetcher=v;exports.createProviderEditing=U;exports.useMachReport=L;exports.useReportPreview=D;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,15 +1,15 @@
 import { createReportSource as v, ReportCellEditError as x } from "@agile-team/mach-report";
 export * from "@agile-team/mach-report";
-import { P as R, c as h } from "./ReportPreview-ChV19HBp.js";
-import { R as Z, a as Q, b as ee, d as re, e as te, f as ne, g as oe, h as se, i as ae, j as ie, k as ce, l as ue, m as fe, n as de, p as ge, o as le, u as pe, q as me, r as Pe } from "./ReportPreview-ChV19HBp.js";
-import { M as f } from "./config-BVsJXSqS.js";
-import { D as Re, a as he, b as we, c as ye, P as Se, R as Te, S as ve, d as xe, e as Ce, n as Ae, p as Oe, f as Ie, r as Me, g as _e, s as De, t as ke, h as Fe, u as be } from "./config-BVsJXSqS.js";
+import { P as R, c as h } from "./ReportPreview-BdQawRh0.js";
+import { R as Z, a as Q, b as ee, d as re, e as te, f as ne, g as oe, h as se, i as ae, j as ie, k as ce, l as ue, m as fe, n as de, p as ge, o as le, u as pe, q as me, r as Pe } from "./ReportPreview-BdQawRh0.js";
+import { M as f } from "./config-XQ4qrQ7Q.js";
+import { D as Re, a as he, b as we, c as ye, P as Se, R as Te, S as ve, d as xe, e as Ce, n as Ae, p as Oe, f as Ie, r as Me, g as _e, s as De, t as ke, h as Fe, u as be } from "./config-XQ4qrQ7Q.js";
 import { M as C } from "./injection-keys-e85udZCp.js";
 import { a as qe, b as Ue, c as je } from "./injection-keys-e85udZCp.js";
-import { M as Ne, m as He } from "./plugin-Ca_XZG3l.js";
+import { M as Ne, m as He } from "./plugin-BBp74CQZ.js";
 import { shallowRef as A, computed as O, inject as I } from "vue";
-import { h as M } from "./data-explanation-B8MZRYVS.js";
-import { b as _ } from "./progress-D-OTpEav.js";
+import { u as M } from "./json-snapshot-DYmEe3sO.js";
+import { a as _ } from "./progress-Hc2vxoCs.js";
 function Y(r) {
   const e = v(r), o = async (t) => {
     if (t.reportIds.length === 0) throw new R("缺少报表 ID");