@agile-team/mach-report 2.10.0 → 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;
@@ -267,6 +270,31 @@ declare type DatasetRows = Record<string, Record<string, unknown>[]>;
 declare type DatasetRows_2 = 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;
@@ -392,15 +420,15 @@ export declare const ExcelBindingWizard: DefineComponent<ExcelBindingWizardOptio
     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;
@@ -485,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;
@@ -510,6 +575,8 @@ 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。 */
@@ -531,6 +598,8 @@ 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。 */
@@ -552,6 +621,8 @@ 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。 */
@@ -650,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";
@@ -659,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;
@@ -685,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. */
@@ -694,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";
@@ -703,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;
@@ -729,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. */
@@ -738,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";
@@ -747,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;
@@ -773,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. */
@@ -1003,6 +1098,172 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>
     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;
+    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;
@@ -1202,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";
@@ -1369,6 +1695,7 @@ declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
     canvasHint: string;
     zoom: string;
     sampleRows: string;
+    treeSampleHint: string;
     resizeComponent: string;
     resizeColumn: string;
     insertComponent: string;
@@ -1403,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;
@@ -1450,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 {
@@ -1487,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;
@@ -1686,6 +2099,27 @@ declare interface ReportFieldContract_2 {
     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 公式。 */
     calculations?: boolean;
@@ -1700,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;
@@ -1715,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;
@@ -1727,7 +2170,28 @@ 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;
+        value: string;
+    }>;
+    defaultValue?: string;
+    required?: boolean;
+    placeholder?: string;
+    /** 数字上下界；日期/月/年使用对应规范字符串；dateRange 对两端使用 YYYY-MM-DD 边界（含边界）。 */
+    min?: number | string;
+    max?: number | string;
+    minLength?: number;
+    maxLength?: number;
+}
+/** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
+declare interface ReportParamDef_3 {
+    /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
+    field: string;
+    /** 显示名（缺省用 field） */
+    label?: string;
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
     /** select 选项 */
     options?: Array<{
         label: string;
@@ -1736,7 +2200,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;
@@ -1766,6 +2230,40 @@ declare interface ReportTemplate_2 {
     params?: ReportParamDef_2[];
     pages: TemplatePage_2[];
 }
+declare interface ReportTemplate_3 {
+    schemaVersion?: string;
+    /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
+    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";
@@ -1786,6 +2284,16 @@ declare interface ReportTemplateDocument_2 {
     description?: string;
     template: ReportTemplate_2;
 }
+/** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
+declare interface ReportTemplateDocument_3 {
+    schemaVersion: "1.0";
+    id: string;
+    name: string;
+    /** 宿主的发布版本/乐观锁标识，不由引擎自动递增。 */
+    revision?: string;
+    description?: string;
+    template: ReportTemplate_3;
+}
 export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions, {
     pendingLocalChanges: boolean;
     saving: boolean;
@@ -1802,6 +2310,11 @@ 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" | "params";
     severity: "error" | "warning";
@@ -1812,6 +2325,7 @@ declare interface ReportTemplateReviewIssue {
     componentIndex?: number;
     field?: string;
 }
+declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];
@@ -1871,6 +2385,25 @@ export declare const RULE_EDITOR_MESSAGES: {
     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;
@@ -2058,6 +2591,7 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     canvasHint: string;
     zoom: string;
     sampleRows: string;
+    treeSampleHint: string;
     resizeComponent: string;
     resizeColumn: string;
     insertComponent: string;
@@ -2092,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,10 +2724,37 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     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;
@@ -2234,6 +2797,7 @@ export declare const TEMPLATE_REVIEW_MESSAGES: {
 };
 declare type TemplateComponent = PlanComponent | ListComponent;
 declare type TemplateComponent_2 = PlanComponent_2 | ListComponent_2;
+declare type TemplateComponent_3 = PlanComponent_3 | ListComponent_3;
 export declare type TemplateEditorBeforeDiscard = (context: TemplateEditorBeforeDiscardContext) => boolean | Promise<boolean>;
 export declare interface TemplateEditorBeforeDiscardContext {
     reason: "reset" | "replace";
@@ -2258,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">;
@@ -2269,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;
@@ -2279,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;
@@ -2290,6 +2866,23 @@ 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;
+    heightMm: number;
+    /** 宽表保持全列自然宽度，页高只控制内部纵向分段。 */
+    layout?: "page" | "wide";
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    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;
 declare interface TemplateReviewOptions {
@@ -2308,6 +2901,63 @@ export declare const TemplateReviewPanel: DefineComponent<TemplateReviewOptions
 }> & 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;