@agile-team/mach-report 2.9.1 → 2.11.0

package/dist/designer.d.ts

@@ -1,4 +1,5 @@
 import { ComponentOptionsMixin } from 'vue';
+import { ComputedRef } from 'vue';
 import { DefineComponent } from 'vue';
 declare interface AggregateDefinition {
     /** Output column; valueField defaults to this field. */
@@ -30,6 +31,8 @@ declare interface AggregateDefinition_3 {
 declare type AggregateOperation = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
 declare type AggregateOperation_2 = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
 declare type AggregateOperation_3 = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
+declare type AnyExcelBindingDocumentResult = ExcelBindingDocumentResult | ExcelRegionBindingDocumentResult;
+declare type AnyExcelBindingSession = ExcelBindingSession | ExcelRegionBindingSession;
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -260,18 +263,39 @@ declare interface DatasetContract {
     rowKey?: string;
 }
 declare interface DatasetContract_2 {
-    fields: readonly ReportFieldContract_3[];
-    rowKey?: string;
-}
-declare interface DatasetContract_3 {
     fields: readonly ReportFieldContract_2[];
     rowKey?: string;
 }
 declare type DatasetRows = Record<string, Record<string, unknown>[]>;
 declare type DatasetRows_2 = Record<string, Record<string, unknown>[]>;
-declare type DatasetRows_3 = Record<string, Record<string, unknown>[]>;
 /** Optional wizard labels remain independent of the general designer configuration. */
 export declare const EXCEL_BINDING_MESSAGES: {
+    tableMode: string;
+    multiRegions: string;
+    multiHint: string;
+    addRegion: string;
+    removeRegion: string;
+    regionProperties: string;
+    regionCoordinates: string;
+    regionMode: string;
+    recordMode: string;
+    repeatMode: string;
+    recordHint: string;
+    repeatHint: string;
+    bindRegionHeader: string;
+    noRegionHeader: string;
+    clearHeader: string;
+    flowFooter: string;
+    flowFooterHint: string;
+    bindFooter: string;
+    clearFooter: string;
+    concurrency: string;
+    revisionField: string;
+    sourceTokenField: string;
+    selectionCellLabel: string;
+    searchFields: string;
+    fieldLimit: string;
+    restoreDraft: string;
     title: string;
     intro: string;
     upload: string;
@@ -385,21 +409,26 @@ declare interface ExcelBindingSession {
     };
 }
 export declare const ExcelBindingWizard: DefineComponent<ExcelBindingWizardOptions, {
+    pendingLocalChanges: boolean;
     importFile: (file: File) => Promise<void>;
-    apply: () => void;
+    apply: () => Promise<void>;
     cancel: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    dirty: (value: boolean) => any;
     apply: (result: ExcelBindingWizardApply) => any;
 }, string, MachReportVuePublicProps, Readonly<ExcelBindingWizardOptions> & Readonly<{
+    onDirty?: ((value: boolean) => any) | undefined;
     onApply?: ((result: ExcelBindingWizardApply) => any) | undefined;
 }>, {}>;
-export declare interface ExcelBindingWizardApply extends ExcelBindingDocumentResult {
-    session: ExcelBindingSession;
-}
+export declare type ExcelBindingWizardApply = AnyExcelBindingDocumentResult & {
+    session: AnyExcelBindingSession;
+};
 export declare interface ExcelBindingWizardOptions {
     datasets: readonly ExcelBindingDataset[];
+    /** An embedded editor can decline replacement; success is shown only after acceptance. */
+    accept?: (result: ExcelBindingWizardApply) => boolean | Promise<boolean>;
     /** Source + exact coordinates + mappings. No File, functions, network credentials, or live result rows. */
-    session?: ExcelBindingSession;
+    session?: AnyExcelBindingSession;
     identity?: {
         id: string;
         name: string;
@@ -484,6 +513,43 @@ declare interface ExcelImportResult {
     warnings: string[];
     sheets: ExcelImportedSheet[];
 }
+/** A row prototype is replaced, never copied into a generated business report. */
+declare interface ExcelRegionBinding {
+    id: string;
+    /** One physical source row, with any contiguous subset of the sheet columns. */
+    range: string;
+    dataset: string;
+    /** record accepts zero or one row; repeat expands vertically and shifts following bands. */
+    mode: "record" | "repeat";
+    fields: string[];
+    rowKey: string;
+    revisionField?: string;
+    sourceTokenField?: string;
+    /** Optional immediately preceding header, with the same physical columns. */
+    headerRange?: string;
+}
+declare interface ExcelRegionBindingDocumentResult {
+    document: ReportTemplateDocument_2;
+    recipe: ExcelRegionBindingRecipe;
+    warnings: string[];
+}
+/** Version 2 describes several independent, vertically ordered data regions on one Sheet. */
+declare interface ExcelRegionBindingRecipe {
+    version: "2.0";
+    sheet: string;
+    regions: ExcelRegionBinding[];
+    /** Full-width source rows reserved on every page; excluded from flowing content. */
+    footerRange?: string;
+}
+declare interface ExcelRegionBindingSession {
+    version: "2.0";
+    source: ExcelImportResult;
+    recipe: ExcelRegionBindingRecipe;
+    identity: {
+        id: string;
+        name: string;
+    };
+}
 declare interface ExpressionOptions {
     numeric?: "number" | "decimal";
     digits?: number;
@@ -509,11 +575,15 @@ declare interface GridCell {
     value?: string | number | boolean | null;
     /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
     numberFormat?: string;
+    /** Physical left inset for hierarchical labels; raw value stays unchanged. */
+    indentMm?: number;
     /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
     source?: ReportCellSource;
+    /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
+    derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
     formula?: string;
     children?: PlanComponent[];
@@ -528,11 +598,15 @@ declare interface GridCell_2 {
     value?: string | number | boolean | null;
     /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
     numberFormat?: string;
+    /** Physical left inset for hierarchical labels; raw value stays unchanged. */
+    indentMm?: number;
     /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
     source?: ReportCellSource_2;
+    /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
+    derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
     formula?: string;
     children?: PlanComponent_2[];
@@ -547,11 +621,15 @@ declare interface GridCell_3 {
     value?: string | number | boolean | null;
     /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
     numberFormat?: string;
+    /** Physical left inset for hierarchical labels; raw value stays unchanged. */
+    indentMm?: number;
     /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
     source?: ReportCellSource_3;
+    /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
+    derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
     formula?: string;
     children?: PlanComponent_3[];
@@ -643,6 +721,8 @@ declare interface ListColumn_3 {
 }
 declare interface ListComponent {
     kind: "list";
+    /** Opaque serializable layout annotations; interpreted only by explicit optional adapters. */
+    meta?: Record<string, unknown>;
     id?: string;
     /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
     layout?: "page" | "wide";
@@ -652,6 +732,10 @@ declare interface ListComponent {
     topMm: number;
     widthMm: number;
     dataset: string;
+    /** Headerless record/region bindings do not allocate a synthetic list header. */
+    header?: boolean;
+    /** A fixed record region rejects multiple rows instead of dropping source data. */
+    cardinality?: "record";
     /** 数据集中稳定业务主键的字段名；省略时编辑仅有计划内坐标。 */
     rowKey?: string;
     revisionField?: string;
@@ -678,6 +762,8 @@ declare interface ListComponent {
     computed?: ComputedField[];
     /** Dynamic pivot of the current source dataset, with read-only derived identities. */
     matrix?: MatrixTableOptions;
+    /** Full ordered hierarchy; source parent values and descendant-leaf rollups are explicit. */
+    tree?: TreeTableOptions;
     /** Explicit row visibility; hidden rows do not participate in summaries. */
     rowVisibleWhen?: StyleRule["when"];
     /** Master/detail relation is keyed by business identity, never by display row index. */
@@ -687,6 +773,8 @@ declare interface ListComponent {
 }
 declare interface ListComponent_2 {
     kind: "list";
+    /** Opaque serializable layout annotations; interpreted only by explicit optional adapters. */
+    meta?: Record<string, unknown>;
     id?: string;
     /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
     layout?: "page" | "wide";
@@ -696,6 +784,10 @@ declare interface ListComponent_2 {
     topMm: number;
     widthMm: number;
     dataset: string;
+    /** Headerless record/region bindings do not allocate a synthetic list header. */
+    header?: boolean;
+    /** A fixed record region rejects multiple rows instead of dropping source data. */
+    cardinality?: "record";
     /** 数据集中稳定业务主键的字段名；省略时编辑仅有计划内坐标。 */
     rowKey?: string;
     revisionField?: string;
@@ -722,6 +814,8 @@ declare interface ListComponent_2 {
     computed?: ComputedField_2[];
     /** Dynamic pivot of the current source dataset, with read-only derived identities. */
     matrix?: MatrixTableOptions_2;
+    /** Full ordered hierarchy; source parent values and descendant-leaf rollups are explicit. */
+    tree?: TreeTableOptions_2;
     /** Explicit row visibility; hidden rows do not participate in summaries. */
     rowVisibleWhen?: StyleRule_2["when"];
     /** Master/detail relation is keyed by business identity, never by display row index. */
@@ -731,6 +825,8 @@ declare interface ListComponent_2 {
 }
 declare interface ListComponent_3 {
     kind: "list";
+    /** Opaque serializable layout annotations; interpreted only by explicit optional adapters. */
+    meta?: Record<string, unknown>;
     id?: string;
     /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
     layout?: "page" | "wide";
@@ -740,6 +836,10 @@ declare interface ListComponent_3 {
     topMm: number;
     widthMm: number;
     dataset: string;
+    /** Headerless record/region bindings do not allocate a synthetic list header. */
+    header?: boolean;
+    /** A fixed record region rejects multiple rows instead of dropping source data. */
+    cardinality?: "record";
     /** 数据集中稳定业务主键的字段名；省略时编辑仅有计划内坐标。 */
     rowKey?: string;
     revisionField?: string;
@@ -766,6 +866,8 @@ declare interface ListComponent_3 {
     computed?: ComputedField_3[];
     /** Dynamic pivot of the current source dataset, with read-only derived identities. */
     matrix?: MatrixTableOptions_3;
+    /** Full ordered hierarchy; source parent values and descendant-leaf rollups are explicit. */
+    tree?: TreeTableOptions_3;
     /** Explicit row visibility; hidden rows do not participate in summaries. */
     rowVisibleWhen?: StyleRule_3["when"];
     /** Master/detail relation is keyed by business identity, never by display row index. */
@@ -778,6 +880,9 @@ declare interface ListDetail {
     parentKey: string;
     foreignKey: string;
     rowKey?: string;
+    /** 子表独立的并发契约；省略时不继承主表字段。 */
+    revisionField?: string;
+    sourceTokenField?: string;
     columns: ListColumn[];
     rowHeightMm?: number;
     header?: boolean;
@@ -790,6 +895,9 @@ declare interface ListDetail_2 {
     parentKey: string;
     foreignKey: string;
     rowKey?: string;
+    /** 子表独立的并发契约；省略时不继承主表字段。 */
+    revisionField?: string;
+    sourceTokenField?: string;
     columns: ListColumn_2[];
     rowHeightMm?: number;
     header?: boolean;
@@ -802,6 +910,9 @@ declare interface ListDetail_3 {
     parentKey: string;
     foreignKey: string;
     rowKey?: string;
+    /** 子表独立的并发契约；省略时不继承主表字段。 */
+    revisionField?: string;
+    sourceTokenField?: string;
     columns: ListColumn_3[];
     rowHeightMm?: number;
     header?: boolean;
@@ -987,6 +1098,8 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>
     paramPromptDescription?: string;
     paramSelectPlaceholder?: string;
     paramTextPlaceholder?: string;
+    paramRangeStart?: string;
+    paramRangeEnd?: string;
     /** 可选搜索进度文案，旧完整 messages 对象无需新增字段。 */
     searching?: string;
     importExcel?: string;
@@ -1038,6 +1151,171 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>
     conflicts?: string;
     editReadOnly?: string;
     editMissing?: string;
+    editRecalculationUnavailable?: string;
+    editDuplicate?: string;
+    clipboardInvalid?: string;
+    editSaved?: string;
+    settingsPanes?: string;
+    columnDirectory?: string;
+    columnSearch?: string;
+    columnNoMatches?: string;
+    columnResults?: string;
+    columnGroup?: string;
+    discardTitle?: string;
+    discardDescription?: string;
+    discardKeep?: string;
+    discardProceed?: string;
+    taskQuery?: string;
+    taskValidate?: string;
+    taskLayout?: string;
+    taskAssets?: string;
+    taskEncode?: string;
+    taskDownload?: string;
+    taskPrint?: string;
+    taskCancel?: string;
+    taskCancelled?: string;
+    diagnosticsTitle?: string;
+    diagnosticsSearch?: string;
+    diagnosticsMore?: string;
+    diagnosticsLocate?: string;
+    diagnosticsLocation?: string;
+    diagnosticsStrict?: string;
+    diagnosticsDetails?: string;
+    diagnosticMissingImage?: string;
+    diagnosticUnsupported?: string;
+    diagnosticUnsupportedStyle?: string;
+    diagnosticImageFormat?: string;
+    diagnosticRichText?: string;
+    diagnosticNested?: string;
+    diagnosticImageAsync?: string;
+    diagnosticImageDecode?: string;
+    diagnosticAssetFailed?: string;
+    diagnosticAssetBudget?: string;
+}
+/**
+ * 配置中心（对齐 mach-table 的 defineMachTableConfig 体验）：
+ * - 应用级：app.use(machReportPlugin, { config: defineMachReportConfig({...}) })
+ * - 路由级叠加：provideMachReportConfig(overlay)（响应式，就近覆盖）
+ * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
+ */
+/** 工具栏与状态文案（默认简体中文；出海场景覆写） */
+declare interface MachReportMessages_2 extends Partial<ReportCalculationMessages_2> {
+    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;
+    /** 页码显示模板，{cur}/{total} 占位 */
+    pageInfo: string;
+    fitWidth: string;
+    exportHtml: string;
+    exportPdf: string;
+    exportExcel: string;
+    exportImage: string;
+    exportWord: string;
+    /** 导出进行中提示，{format} 占位 */
+    exporting: string;
+    print: string;
+    pdfWindow: string;
+    loading: string;
+    empty: string;
+    /** @deprecated 未被组件消费，将在下个大版本移除（保留仅为类型兼容） */
+    errorPrefix: string;
+    retry: string;
+    /** 可选新增文案，保留旧完整文案对象兼容。 */
+    pdfFontUnavailable?: string;
+    /** 搜索框占位文案 */
+    searchPlaceholder: string;
+    /** 搜索命中计数，{cur}/{total} 占位 */
+    matchInfo: string;
+    /** 上/下一个命中 */
+    prevMatch: string;
+    nextMatch: string;
+    /** 缩略图侧栏开关 */
+    thumbnails: string;
+    /** 参数面板 */
+    paramsTitle: string;
+    query: string;
+    reset: string;
+    /** 必填缺失提示（{label} 占位） */
+    paramRequired: string;
+    paramInvalid?: string;
+    paramPrompt?: string;
+    paramPromptDescription?: string;
+    paramSelectPlaceholder?: string;
+    paramTextPlaceholder?: string;
+    paramRangeStart?: string;
+    paramRangeEnd?: string;
+    /** 可选搜索进度文案，旧完整 messages 对象无需新增字段。 */
+    searching?: string;
+    importExcel?: string;
+    importing?: string;
+    editCell?: string;
+    editingHint?: string;
+    saving?: string;
+    editInvalidNumber?: string;
+    editInvalidBoolean?: string;
+    editConflict?: string;
+    settings?: string;
+    settingsDisplay?: string;
+    settingsExport?: string;
+    settingsData?: string;
+    settingsUnavailable?: string;
+    settingsReset?: string;
+    settingsClose?: string;
+    search?: string;
+    closeSearch?: string;
+    prevSearchMatch?: string;
+    nextSearchMatch?: string;
+    zoom?: string;
+    settingsLocal?: string;
+    editingLocal?: string;
+    editingSaved?: string;
+    importLocal?: string;
+    emptyDescription?: string;
+    undo?: string;
+    redo?: string;
+    restoreChanges?: string;
+    changes?: string;
+    changesCount?: string;
+    changesEmpty?: string;
+    changesBefore?: string;
+    changesAfter?: string;
+    editAtomicRequired?: string;
+    clipboardLimit?: string;
+    preferencesError?: string;
+    freezeHeaders?: string;
+    frozenColumns?: string;
+    sections?: string;
+    locateField?: string;
+    locateFieldPlaceholder?: string;
+    locateFieldMissing?: string;
+    importSummary?: string;
+    importPreserved?: string;
+    importWarnings?: string;
+    importReadOnly?: string;
+    conflicts?: string;
+    editReadOnly?: string;
+    editMissing?: string;
+    editRecalculationUnavailable?: string;
     editDuplicate?: string;
     clipboardInvalid?: string;
     editSaved?: string;
@@ -1175,7 +1453,6 @@ declare interface OutputDiagnosticOptions extends OutputTaskOptions {
     fidelity?: "warn" | "strict";
 }
 declare type OutputFormat = "dom" | "canvas" | "pdf" | "xlsx";
-declare type OutputFormat_2 = "dom" | "canvas" | "pdf" | "xlsx";
 /** Stage counts are exact completed units; encoding libraries may remain indeterminate. */
 declare interface OutputTaskOptions {
     signal?: AbortSignal;
@@ -1186,6 +1463,71 @@ declare interface OutputTaskOptions_2 {
     signal?: AbortSignal;
     onProgress?: (completed: number, total: number) => void;
 }
+export declare const PARAM_EDITOR_MESSAGES: {
+    paramsTool: string;
+    paramsDescription: string;
+    paramsDirectory: string;
+    paramAdd: string;
+    paramEmpty: string;
+    paramEmptyHint: string;
+    paramField: string;
+    paramLabel: string;
+    paramType: string;
+    paramRequired: string;
+    paramPlaceholder: string;
+    paramDefaultEnabled: string;
+    paramDefault: string;
+    paramMinimum: string;
+    paramMaximum: string;
+    paramMinLength: string;
+    paramMaxLength: string;
+    paramOptions: string;
+    paramOptionValue: string;
+    paramOptionLabel: string;
+    paramOptionAdd: string;
+    paramRemove: string;
+    paramOptionRemove: string;
+    paramMoveUp: string;
+    paramMoveDown: string;
+    paramApply: string;
+    paramRestore: string;
+    paramPending: string;
+    paramReady: string;
+    paramInvalid: string;
+    paramConflict: string;
+    paramApplyFailed: string;
+    paramRenameHint: string;
+    paramChanges: string;
+    paramAdded: string;
+    paramRemoved: string;
+    paramWire: string;
+    paramNoDefault: string;
+    paramRangeHint: string;
+    paramText: string;
+    paramNumber: string;
+    paramDate: string;
+    paramMonth: string;
+    paramYear: string;
+    paramDateRange: string;
+    paramSelect: string;
+};
+export declare const ParamEditor: DefineComponent<ParamEditorOptions, {
+    pending: ComputedRef<boolean>;
+    reset: () => void;
+    apply: () => boolean;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    dirty: (pending: boolean) => any;
+}, string, MachReportVuePublicProps, Readonly<ParamEditorOptions> & Readonly<{
+    onDirty?: ((pending: boolean) => any) | undefined;
+}>, {}>;
+export declare type ParamEditorMessages = typeof PARAM_EDITOR_MESSAGES;
+export declare interface ParamEditorOptions {
+    document: ReportTemplateDocument;
+    readonly?: boolean;
+    messages?: Partial<ParamEditorMessages>;
+    /** Return false when the enclosing template transaction rejects the change. */
+    accept(definitions: ReportParamDef[]): boolean;
+}
 declare interface PlanComponent {
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
@@ -1353,6 +1695,7 @@ declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
     canvasHint: string;
     zoom: string;
     sampleRows: string;
+    treeSampleHint: string;
     resizeComponent: string;
     resizeColumn: string;
     insertComponent: string;
@@ -1387,6 +1730,8 @@ declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
     headerRow: string;
     headerFirst: string;
     headerLast: string;
+    flowLayout: string;
+    paramsTool: string;
     excelTool: string;
     rulesTool: string;
     reviewTool: string;
@@ -1434,6 +1779,61 @@ declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
     fieldPosition: string;
     previewFieldDirectory: string;
 };
+export declare const REPORT_BATCH_MESSAGES: {
+    batchTitle: string;
+    batchDescription: string;
+    batchAdd: string;
+    batchDuplicate: string;
+    batchRemove: string;
+    batchRun: string;
+    batchRunning: string;
+    batchRetry: string;
+    batchCancel: string;
+    batchCancelling: string;
+    batchPending: string;
+    batchCompleted: string;
+    batchFailed: string;
+    batchCancelled: string;
+    batchCase: string;
+    batchProgress: string;
+    batchInvalid: string;
+    batchEmpty: string;
+    batchNoInstance: string;
+    batchOpen: string;
+    batchLimit: string;
+    batchChanged: string;
+    batchPages: string;
+    batchPrevious: string;
+    batchNext: string;
+    batchPage: string;
+};
+declare interface ReportBatchCase {
+    id: string;
+    params: Record<string, string>;
+}
+export declare type ReportBatchMessages = typeof REPORT_BATCH_MESSAGES;
+export declare const ReportBatchPanel: DefineComponent<ReportBatchPanelOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    "open-instance": (receipt: ReportBatchReceipt) => any;
+}, string, MachReportVuePublicProps, Readonly<ReportBatchPanelOptions> & Readonly<{
+    "onOpen-instance"?: ((receipt: ReportBatchReceipt) => any) | undefined;
+}>, {}>;
+export declare interface ReportBatchPanelOptions {
+    paramDefs: ReportParamDef[];
+    execute(item: ReportBatchCase, context: {
+        index: number;
+        signal: AbortSignal;
+    }): Promise<ReportBatchReceipt>;
+    initialCases?: ReportBatchCase[];
+    readonly?: boolean;
+    concurrency?: number;
+    maxCases?: number;
+    messages?: Partial<ReportBatchMessages>;
+    paramMessages?: Partial<MachReportMessages_2>;
+}
+export declare interface ReportBatchReceipt {
+    instanceId?: string;
+    label?: string;
+}
 /** Return false to keep the current report. Without a hook the preview asks inline. */
 declare type ReportBeforeDiscard = (context: Readonly<ReportBeforeDiscardContext>) => boolean | Promise<boolean>;
 declare interface ReportBeforeDiscardContext {
@@ -1471,6 +1871,35 @@ declare interface ReportCalculationMessages {
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
 }
+declare interface ReportCalculationMessages_2 {
+    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;
@@ -1530,7 +1959,7 @@ declare type ReportCellFieldOptions = ReportCellFieldBase & ({
     min?: string;
     max?: string;
 });
-declare type ReportCellReadOnlyReason = "cell" | "formula" | "complex" | "structure";
+declare type ReportCellReadOnlyReason = "cell" | "formula" | "complex" | "structure" | "derived";
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
     datasetId: string;
@@ -1670,19 +2099,26 @@ declare interface ReportFieldContract_2 {
     semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
     unit?: string;
 }
-declare interface ReportFieldContract_3 {
-    field: string;
-    label?: string;
-    type: "text" | "number" | "boolean" | "date" | "decimal";
-    required?: boolean;
-    nullable?: boolean;
-    enum?: readonly (string | number | boolean)[];
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
-    unit?: string;
+declare interface ReportFlowBand {
+    /** Exact stable component IDs. Static components use nid, lists use id. */
+    componentIds: string[];
+    /** Source-template coordinates; following bands keep their original gap. */
+    topMm: number;
+    heightMm: number;
+}
+declare interface ReportFlowBand_2 {
+    /** Exact stable component IDs. Static components use nid, lists use id. */
+    componentIds: string[];
+    /** Source-template coordinates; following bands keep their original gap. */
+    topMm: number;
+    heightMm: number;
+}
+declare interface ReportFlowBand_3 {
+    /** Exact stable component IDs. Static components use nid, lists use id. */
+    componentIds: string[];
+    /** Source-template coordinates; following bands keep their original gap. */
+    topMm: number;
+    heightMm: number;
 }
 declare interface ReportInteractionOptions {
     /** 只读选区计算，默认关闭；不写回业务值或执行导入的 Excel 公式。 */
@@ -1698,13 +2134,22 @@ declare interface ReportOutputOptions {
     /** warn preserves supported output and shows diagnostics; strict rejects known fidelity loss. */
     fidelity?: "warn" | "strict";
 }
+declare interface ReportPageFlow {
+    bands: ReportFlowBand[];
+}
+declare interface ReportPageFlow_2 {
+    bands: ReportFlowBand_2[];
+}
+declare interface ReportPageFlow_3 {
+    bands: ReportFlowBand_3[];
+}
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef {
     /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
     /** select 选项 */
     options?: Array<{
         label: string;
@@ -1713,7 +2158,7 @@ declare interface ReportParamDef {
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
-    /** 数字上下界；date 参数使用 YYYY-MM-DD 字符串（含边界）。 */
+    /** 数字上下界；日期/月/年使用对应规范字符串；dateRange 对两端使用 YYYY-MM-DD 边界（含边界）。 */
     min?: number | string;
     max?: number | string;
     minLength?: number;
@@ -1725,7 +2170,7 @@ declare interface ReportParamDef_2 {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
     /** select 选项 */
     options?: Array<{
         label: string;
@@ -1734,7 +2179,7 @@ declare interface ReportParamDef_2 {
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
-    /** 数字上下界；date 参数使用 YYYY-MM-DD 字符串（含边界）。 */
+    /** 数字上下界；日期/月/年使用对应规范字符串；dateRange 对两端使用 YYYY-MM-DD 边界（含边界）。 */
     min?: number | string;
     max?: number | string;
     minLength?: number;
@@ -1746,7 +2191,7 @@ declare interface ReportParamDef_3 {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
     /** select 选项 */
     options?: Array<{
         label: string;
@@ -1755,7 +2200,7 @@ declare interface ReportParamDef_3 {
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
-    /** 数字上下界；date 参数使用 YYYY-MM-DD 字符串（含边界）。 */
+    /** 数字上下界；日期/月/年使用对应规范字符串；dateRange 对两端使用 YYYY-MM-DD 边界（含边界）。 */
     min?: number | string;
     max?: number | string;
     minLength?: number;
@@ -1791,6 +2236,34 @@ declare interface ReportTemplate_3 {
     params?: ReportParamDef_3[];
     pages: TemplatePage_3[];
 }
+declare interface ReportTemplateCatalogEntry extends ReportTemplateSummary {
+    category?: string;
+    tags?: string[];
+    updatedAt?: string;
+}
+declare interface ReportTemplateCatalogPage {
+    items: ReportTemplateCatalogEntry[];
+    next?: string;
+    categories?: Array<{
+        id: string;
+        label: string;
+        count?: number;
+    }>;
+}
+/** Discovery metadata is separate from executable templates and from enterprise account authorization. */
+declare interface ReportTemplateCatalogProvider {
+    search(request: ReportTemplateCatalogQuery): Promise<ReportTemplateCatalogPage>;
+    get(id: string, context: {
+        signal?: AbortSignal;
+    }): Promise<ReportTemplateDocument | undefined>;
+}
+declare interface ReportTemplateCatalogQuery {
+    query?: string;
+    category?: string;
+    cursor?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
 /** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
 declare interface ReportTemplateDocument {
     schemaVersion: "1.0";
@@ -1837,8 +2310,13 @@ export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions
     onSaved?: ((document: ReportTemplateDocument) => any) | undefined;
     "onExcel-bound"?: ((result: ExcelBindingWizardApply) => any) | undefined;
 }>, {}>;
+export declare const ReportTemplateLibrary: DefineComponent<TemplateLibraryOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    open: (document: ReportTemplateDocument_3) => any;
+}, string, MachReportVuePublicProps, Readonly<TemplateLibraryOptions> & Readonly<{
+    onOpen?: ((document: ReportTemplateDocument_3) => any) | undefined;
+}>, {}>;
 declare interface ReportTemplateReviewIssue {
-    code: "template" | "compatibility" | "dataset" | "field" | "sample" | "layout" | "output";
+    code: "template" | "compatibility" | "dataset" | "field" | "sample" | "layout" | "output" | "params";
     severity: "error" | "warning";
     path: string;
     message: string;
@@ -1847,6 +2325,7 @@ declare interface ReportTemplateReviewIssue {
     componentIndex?: number;
     field?: string;
 }
+declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];
@@ -1891,8 +2370,40 @@ declare interface RichSegment_3 {
 }
 /** Optional rule-editor copy; hosts can override without changing core/report messages. */
 export declare const RULE_EDITOR_MESSAGES: {
+    restoreDraft: string;
+    catalog: string;
+    searchFields: string;
+    useField: string;
+    shown: string;
+    explanation: string;
+    sourceValues: string;
+    expression: string;
+    result: string;
+    notChecked: string;
+    nullReason: string;
+    sourceHint: string;
+    pending: string;
     detail: string;
     matrix: string;
+    tree: string;
+    treeInput: string;
+    treeFlat: string;
+    treeNested: string;
+    treeId: string;
+    treeParent: string;
+    treeChildren: string;
+    treeLabel: string;
+    treeIndent: string;
+    treeOrphan: string;
+    treeAsRoot: string;
+    treeValues: string;
+    treeSource: string;
+    treeLeaves: string;
+    treeRows: string;
+    treeDepth: string;
+    treeHint: string;
+    treeReadonly: string;
+    treeBudget: string;
     measureLabel: string;
     childDataset: string;
     parentKey: string;
@@ -2006,17 +2517,21 @@ export declare const RULE_EDITOR_MESSAGES: {
     new: string;
     enabled: string;
 };
-export declare const RuleEditor: DefineComponent<RuleEditorOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+export declare const RuleEditor: DefineComponent<RuleEditorOptions, {
+    pendingLocalChanges: boolean;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     change: (value: ListComponent_3) => any;
+    dirty: (value: boolean) => any;
 }, string, MachReportVuePublicProps, Readonly<RuleEditorOptions> & Readonly<{
     onChange?: ((value: ListComponent_3) => any) | undefined;
+    onDirty?: ((value: boolean) => any) | undefined;
 }>, {}>;
 export declare type RuleEditorMessages = typeof RULE_EDITOR_MESSAGES;
 export declare interface RuleEditorOptions {
     list: ListComponent_2;
-    datasets?: DatasetRows_3;
-    datasetSchema?: DatasetContract_3;
-    datasetSchemas?: Record<string, DatasetContract_3>;
+    datasets?: DatasetRows_2;
+    datasetSchema?: DatasetContract_2;
+    datasetSchemas?: Record<string, DatasetContract_2>;
     readonly?: boolean;
     messages?: Partial<RuleEditorMessages>;
 }
@@ -2076,6 +2591,7 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     canvasHint: string;
     zoom: string;
     sampleRows: string;
+    treeSampleHint: string;
     resizeComponent: string;
     resizeColumn: string;
     insertComponent: string;
@@ -2110,6 +2626,8 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     headerRow: string;
     headerFirst: string;
     headerLast: string;
+    flowLayout: string;
+    paramsTool: string;
     excelTool: string;
     rulesTool: string;
     reviewTool: string;
@@ -2188,8 +2706,55 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     applyJson: string;
     note: string;
     invalid: string;
+    fitWidth: string;
+    fitPage: string;
+    fitSelection: string;
+    wideNavigation: string;
+    alignSelection: string;
+    leftEdges: string;
+    centers: string;
+    rightEdges: string;
+    topEdges: string;
+    middles: string;
+    bottomEdges: string;
+    horizontalSpacing: string;
+    verticalSpacing: string;
+    lockSelection: string;
+    unlockSelection: string;
+    sessionLock: string;
+    toolsPending: string;
+};
+export declare const TEMPLATE_LIBRARY_MESSAGES: {
+    title: string;
+    subtitle: string;
+    search: string;
+    all: string;
+    refresh: string;
+    open: string;
+    copy: string;
+    empty: string;
+    emptyHint: string;
+    loadMore: string;
+    previous: string;
+    page: string;
+    loading: string;
+    retry: string;
+    revision: string;
+    copyTitle: string;
+    newId: string;
+    newName: string;
+    create: string;
+    cancel: string;
+    count: string;
+    missing: string;
+    stale: string;
+    invalid: string;
 };
 export declare const TEMPLATE_REVIEW_MESSAGES: {
+    stale: string;
+    scope: string;
+    datasets: string;
+    treeHint: string;
     title: string;
     run: string;
     running: string;
@@ -2257,7 +2822,7 @@ export declare interface TemplateEditorOptions {
     dataSchemas?: Record<string, DatasetContract>;
     bindingDatasets?: ExcelBindingDataset[];
     /** Optional independently persisted Excel source and binding recipe. */
-    bindingSession?: ExcelBindingSession;
+    bindingSession?: AnyExcelBindingSession;
     readonly?: boolean;
     messages?: Partial<TemplateEditorMessages>;
     preview?: Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "theme" | "assets" | "pdfFontUrl" | "toolbar">;
@@ -2268,6 +2833,15 @@ export declare interface TemplateEditorSaveContext {
     expectedRevision?: string;
     signal: AbortSignal;
 }
+export declare type TemplateLibraryMessages = typeof TEMPLATE_LIBRARY_MESSAGES;
+export declare interface TemplateLibraryOptions {
+    provider: ReportTemplateCatalogProvider;
+    messages?: Partial<TemplateLibraryMessages>;
+    /** Optional real persistence action. No copy button is shown without it. */
+    create?: (document: ReportTemplateDocument, context: {
+        signal: AbortSignal;
+    }) => Promise<ReportTemplateDocument>;
+}
 declare interface TemplatePage {
     widthMm: number;
     heightMm: number;
@@ -2278,6 +2852,9 @@ declare interface TemplatePage {
     marginLeftMm?: number;
     marginRightMm?: number;
     components: TemplateComponent[];
+    /** Explicit vertical bands preserve source gaps as dynamic regions expand. */
+    flow?: ReportPageFlow;
+    meta?: Record<string, unknown>;
 }
 declare interface TemplatePage_2 {
     widthMm: number;
@@ -2289,6 +2866,9 @@ declare interface TemplatePage_2 {
     marginLeftMm?: number;
     marginRightMm?: number;
     components: TemplateComponent_2[];
+    /** Explicit vertical bands preserve source gaps as dynamic regions expand. */
+    flow?: ReportPageFlow_2;
+    meta?: Record<string, unknown>;
 }
 declare interface TemplatePage_3 {
     widthMm: number;
@@ -2300,27 +2880,92 @@ declare interface TemplatePage_3 {
     marginLeftMm?: number;
     marginRightMm?: number;
     components: TemplateComponent_3[];
+    /** Explicit vertical bands preserve source gaps as dynamic regions expand. */
+    flow?: ReportPageFlow_3;
+    meta?: Record<string, unknown>;
 }
 export declare type TemplateReviewMessages = typeof TEMPLATE_REVIEW_MESSAGES;
-export declare const TemplateReviewPanel: DefineComponent<{
-    document: ReportTemplateDocument_3;
-    previous?: ReportTemplateDocument_3;
-    datasets?: DatasetRows_2;
-    dataSchemas?: Readonly<Record<string, DatasetContract_2>>;
-    formats?: readonly OutputFormat_2[];
+declare interface TemplateReviewOptions {
+    document: ReportTemplateDocument;
+    previous?: ReportTemplateDocument;
+    datasets?: DatasetRows;
+    dataSchemas?: Readonly<Record<string, DatasetContract>>;
+    formats?: readonly OutputFormat[];
+}
+export declare const TemplateReviewPanel: DefineComponent<TemplateReviewOptions & {
     messages?: Partial<TemplateReviewMessages>;
 }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     locate: (value: Pick<ReportTemplateReviewIssue, "field" | "path" | "pageIndex" | "componentIndex">) => any;
-}, string, MachReportVuePublicProps, Readonly<{
-    document: ReportTemplateDocument_3;
-    previous?: ReportTemplateDocument_3;
-    datasets?: DatasetRows_2;
-    dataSchemas?: Readonly<Record<string, DatasetContract_2>>;
-    formats?: readonly OutputFormat_2[];
+}, string, MachReportVuePublicProps, Readonly<TemplateReviewOptions & {
     messages?: Partial<TemplateReviewMessages>;
 }> & Readonly<{
     onLocate?: ((value: Pick<ReportTemplateReviewIssue, "field" | "path" | "pageIndex" | "componentIndex">) => any) | undefined;
 }>, {}>;
+/** A serialized tree contract. Sibling and root order follow input order. */
+declare interface TreeTableOptions {
+    input: "flat" | "nested";
+    idField: string;
+    /** Flat roots have null/undefined parent values. */
+    parentField?: string;
+    /** Nested child arrays, defaults to children. Every node still needs an ID. */
+    childrenField?: string;
+    labelField: string;
+    indentMm?: number;
+    orphan?: "error" | "root";
+    /** Source preserves parent values; leaf-aggregate derives only parents from descendant leaves. */
+    parentValues?: "source" | "leaf-aggregate";
+    aggregates?: AggregateDefinition[];
+    maxRows?: number;
+    maxDepth?: number;
+    /** Bounded leaf-to-ancestor aggregate work; default one million. */
+    maxAggregationVisits?: number;
+}
+/** A serialized tree contract. Sibling and root order follow input order. */
+declare interface TreeTableOptions_2 {
+    input: "flat" | "nested";
+    idField: string;
+    /** Flat roots have null/undefined parent values. */
+    parentField?: string;
+    /** Nested child arrays, defaults to children. Every node still needs an ID. */
+    childrenField?: string;
+    labelField: string;
+    indentMm?: number;
+    orphan?: "error" | "root";
+    /** Source preserves parent values; leaf-aggregate derives only parents from descendant leaves. */
+    parentValues?: "source" | "leaf-aggregate";
+    aggregates?: AggregateDefinition_2[];
+    maxRows?: number;
+    maxDepth?: number;
+    /** Bounded leaf-to-ancestor aggregate work; default one million. */
+    maxAggregationVisits?: number;
+}
+/** A serialized tree contract. Sibling and root order follow input order. */
+declare interface TreeTableOptions_3 {
+    input: "flat" | "nested";
+    idField: string;
+    /** Flat roots have null/undefined parent values. */
+    parentField?: string;
+    /** Nested child arrays, defaults to children. Every node still needs an ID. */
+    childrenField?: string;
+    labelField: string;
+    indentMm?: number;
+    orphan?: "error" | "root";
+    /** Source preserves parent values; leaf-aggregate derives only parents from descendant leaves. */
+    parentValues?: "source" | "leaf-aggregate";
+    aggregates?: AggregateDefinition_3[];
+    maxRows?: number;
+    maxDepth?: number;
+    /** Bounded leaf-to-ancestor aggregate work; default one million. */
+    maxAggregationVisits?: number;
+}
+declare interface XlsxImageOptions {
+    /** Decoded bytes per unique embedded image; default 16 MiB. */
+    maxImageBytes?: number;
+    /** Total decoded bytes of unique images in this workbook; default 32 MiB. */
+    maxTotalImageBytes?: number;
+    /** Unique embedded media limit, default 1000; repeated placements reuse the same media. */
+    maxImages?: number;
+}
 /**
  * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
  * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
@@ -2329,7 +2974,7 @@ export declare const TemplateReviewPanel: DefineComponent<{
  *   目标是"财务能直接用的对账表"而非复刻版面）
  * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
  */
-declare interface XlsxRenderOptions extends OutputDiagnosticOptions {
+declare interface XlsxRenderOptions extends OutputDiagnosticOptions, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */
     sheetName?: (sheetIndex: number) => string;
     /** auto 默认将 wide 逻辑表合并为连续 Sheet；pages 保留逐页；continuous 要求明确的表来源。 */