@agile-team/mach-report 2.8.4 → 2.9.0

package/dist/designer.d.ts

@@ -1,5 +1,35 @@
 import { ComponentOptionsMixin } from 'vue';
 import { DefineComponent } from 'vue';
+declare interface AggregateDefinition {
+    /** Output column; valueField defaults to this field. */
+    field: string;
+    op: AggregateOperation;
+    valueField?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+declare interface AggregateDefinition_2 {
+    /** Output column; valueField defaults to this field. */
+    field: string;
+    op: AggregateOperation_2;
+    valueField?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+declare interface AggregateDefinition_3 {
+    /** Output column; valueField defaults to this field. */
+    field: string;
+    op: AggregateOperation_3;
+    valueField?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+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 interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -74,6 +104,50 @@ declare type ColumnFormat = {
     kind: "date";
     pattern?: string;
 };
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+declare type ColumnFormat_2 = {
+    kind: "number";
+    thousands?: boolean;
+    digits?: number;
+} | {
+    kind: "percent";
+    digits?: number;
+} | {
+    kind: "date";
+    pattern?: string;
+};
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+declare type ColumnFormat_3 = {
+    kind: "number";
+    thousands?: boolean;
+    digits?: number;
+} | {
+    kind: "percent";
+    digits?: number;
+} | {
+    kind: "date";
+    pattern?: string;
+};
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -83,6 +157,8 @@ declare interface ComponentImageContext {
 }
 declare type ComponentImageRenderer = (context: ComponentImageContext) => 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";
 declare interface ComponentStyle {
     fontSizePx?: number;
     fontSize?: number;
@@ -106,7 +182,245 @@ declare interface ComponentStyle {
     opacity?: number;
     rotateDeg?: number;
 }
+declare interface ComponentStyle_2 {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+declare interface ComponentStyle_3 {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+declare interface ComputedField extends ExpressionOptions {
+    field: string;
+    expression: ReportExpression | string;
+    /** Scope controls aggregate inputs; row expressions may reference the current row in any scope. */
+    scope?: "row" | "group" | "dataset";
+    groupBy?: readonly string[];
+    /** String adapter expressions cannot be inspected; declare dependencies explicitly. */
+    dependsOn?: readonly string[];
+}
+declare interface ComputedField_2 extends ExpressionOptions_2 {
+    field: string;
+    expression: ReportExpression_2 | string;
+    /** Scope controls aggregate inputs; row expressions may reference the current row in any scope. */
+    scope?: "row" | "group" | "dataset";
+    groupBy?: readonly string[];
+    /** String adapter expressions cannot be inspected; declare dependencies explicitly. */
+    dependsOn?: readonly string[];
+}
+declare interface ComputedField_3 extends ExpressionOptions_3 {
+    field: string;
+    expression: ReportExpression_3 | string;
+    /** Scope controls aggregate inputs; row expressions may reference the current row in any scope. */
+    scope?: "row" | "group" | "dataset";
+    groupBy?: readonly string[];
+    /** String adapter expressions cannot be inspected; declare dependencies explicitly. */
+    dependsOn?: readonly string[];
+}
+declare interface DatasetContract {
+    fields: readonly ReportFieldContract[];
+    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: {
+    title: string;
+    intro: string;
+    upload: string;
+    replace: string;
+    loading: string;
+    cancel: string;
+    source: string;
+    sourceHint: string;
+    sourceOnly: string;
+    sheet: string;
+    dataset: string;
+    chooseDataset: string;
+    rowKey: string;
+    chooseRowKey: string;
+    titleRegion: string;
+    headerRegion: string;
+    detailRegion: string;
+    footerRegion: string;
+    optional: string;
+    selectRegion: string;
+    clear: string;
+    mapping: string;
+    coverage: string;
+    physical: string;
+    business: string;
+    chooseField: string;
+    selected: string;
+    previousRows: string;
+    nextRows: string;
+    previousColumns: string;
+    nextColumns: string;
+    rowStart: string;
+    columnStart: string;
+    apply: string;
+    check: string;
+    identity: string;
+    templateId: string;
+    templateName: string;
+    issues: string;
+    ready: string;
+    noSource: string;
+    noContract: string;
+    fieldType: string;
+    precision: string;
+    sample: string;
+    unnamed: string;
+    applied: string;
+    readonly: string;
+    invalidFile: string;
+    emptySelection: string;
+    footerHint: string;
+    inspectWarning: string;
+    session: string;
+    decimals: string;
+    selectionLabel: string;
+    regionLegend: string;
+    summary: string;
+    stepSource: string;
+    stepRegions: string;
+    stepFields: string;
+    stepValidate: string;
+    errors: string;
+    sourceError: string;
+    dimensions: string;
+    mappedTo: string;
+    sampleOnly: string;
+    schemaOnly: string;
+};
+declare interface ExcelBindingDataset {
+    id: string;
+    label?: string;
+    fields: readonly ExcelBindingField[];
+    rowKey?: string;
+    /** Optional representative API rows, used only for contract validation, never as live results. */
+    samples?: readonly Record<string, unknown>[];
+}
+declare interface ExcelBindingDocumentResult {
+    document: ReportTemplateDocument_2;
+    recipe: ExcelBindingRecipe;
+    warnings: string[];
+}
+declare interface ExcelBindingField extends ReportFieldContract_2 {
+    /** Display precision is explicit business metadata; decimal text is never coerced to number. */
+    digits?: number;
+    sample?: string | number | boolean | null;
+}
+export declare type ExcelBindingMessages = typeof EXCEL_BINDING_MESSAGES;
+/** Explicit coordinates and mappings, independently persistable alongside the source asset. */
+declare interface ExcelBindingRecipe {
+    version: "1.0";
+    sheet: string;
+    dataset: string;
+    regions: {
+        title?: string;
+        header: string;
+        detail: string;
+        footer?: string;
+    };
+    /** One mapping for every physical Excel column. Empty strings remain invalid until confirmed. */
+    fields: string[];
+    rowKey: string;
+}
+declare interface ExcelBindingSession {
+    version: "1.0";
+    /** Design source only. The compiled document never retains the sample detail rows. */
+    source: ExcelImportResult;
+    recipe: ExcelBindingRecipe;
+    identity: {
+        id: string;
+        name: string;
+    };
+}
+export declare const ExcelBindingWizard: DefineComponent<ExcelBindingWizardOptions, {
+    importFile: (file: File) => Promise<void>;
+    apply: () => void;
+    cancel: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    apply: (result: ExcelBindingWizardApply) => any;
+}, string, MachReportVuePublicProps, Readonly<ExcelBindingWizardOptions> & Readonly<{
+    onApply?: ((result: ExcelBindingWizardApply) => any) | undefined;
+}>, {}>;
+export declare interface ExcelBindingWizardApply extends ExcelBindingDocumentResult {
+    session: ExcelBindingSession;
+}
+export declare interface ExcelBindingWizardOptions {
+    datasets: readonly ExcelBindingDataset[];
+    /** Source + exact coordinates + mappings. No File, functions, network credentials, or live result rows. */
+    session?: ExcelBindingSession;
+    identity?: {
+        id: string;
+        name: string;
+    };
+    /** Editor replacement keeps the current persistent ID; standalone creation remains editable. */
+    lockId?: boolean;
+    readonly?: boolean;
+    importOptions?: Pick<ExcelImportOptions_2, "layout" | "landscape" | "limits">;
+    messages?: Partial<ExcelBindingMessages>;
+}
+declare interface ExcelImportedSheet {
+    name: string;
+    /** Original, one-based workbook position. */
+    index: number;
+    range: string;
+    rowCount: number;
+    columnCount: number;
+    /** Zero-based index into template.pages. */
+    pageStart: number;
+    pageCount: number;
+}
 /** Limits apply to the selected rectangular ranges, including their empty cells. */
 declare interface ExcelImportLimits {
     /** Compressed input, default 20 MiB. */
@@ -122,6 +436,21 @@ declare interface ExcelImportLimits {
     /** Workbook sheets, default 32. */
     maxSheets?: number;
 }
+/** Limits apply to the selected rectangular ranges, including their empty cells. */
+declare interface ExcelImportLimits_2 {
+    /** Compressed input, default 20 MiB. */
+    maxFileBytes?: number;
+    /** Declared ZIP uncompressed total, default 64 MiB. */
+    maxUncompressedBytes?: number;
+    /** Total selected cells across sheets, default 250,000; hard ceiling 1,000,000. */
+    maxCells?: number;
+    /** Rows per selected sheet, default 100,000; hard ceiling 1,048,576. */
+    maxRows?: number;
+    /** Columns per selected sheet, default 2,048; hard ceiling 16,384. */
+    maxColumns?: number;
+    /** Workbook sheets, default 32. */
+    maxSheets?: number;
+}
 declare interface ExcelImportOptions extends OutputTaskOptions {
     /** Sheet names or one-based workbook positions. Default: all visible sheets. */
     sheets?: Array<string | number>;
@@ -136,6 +465,43 @@ declare interface ExcelImportOptions extends OutputTaskOptions {
     /** Optional resource limits; hard ceilings prevent unbounded allocations. */
     limits?: ExcelImportLimits;
 }
+declare interface ExcelImportOptions_2 extends OutputTaskOptions_2 {
+    /** Sheet names or one-based workbook positions. Default: all visible sheets. */
+    sheets?: Array<string | number>;
+    /** A1 range for every sheet, or ranges keyed by exact sheet name. */
+    range?: string | Record<string, string>;
+    /** Wide preserves natural column widths. A3/A4 scale the complete width to paper. */
+    layout?: "wide" | "a3" | "a4";
+    /** Only applies to A3/A4; default landscape. */
+    landscape?: boolean;
+    /** Vertical preview segment limit, default 80, maximum 200. Merges remain intact. */
+    maxRowsPerPage?: number;
+    /** Optional resource limits; hard ceilings prevent unbounded allocations. */
+    limits?: ExcelImportLimits_2;
+}
+declare interface ExcelImportResult {
+    template: ReportTemplate_2;
+    warnings: string[];
+    sheets: ExcelImportedSheet[];
+}
+declare interface ExpressionOptions {
+    numeric?: "number" | "decimal";
+    digits?: number;
+    nulls?: "propagate" | "error";
+    divisionByZero?: "null" | "error";
+}
+declare interface ExpressionOptions_2 {
+    numeric?: "number" | "decimal";
+    digits?: number;
+    nulls?: "propagate" | "error";
+    divisionByZero?: "null" | "error";
+}
+declare interface ExpressionOptions_3 {
+    numeric?: "number" | "decimal";
+    digits?: number;
+    nulls?: "propagate" | "error";
+    divisionByZero?: "null" | "error";
+}
 declare interface GridCell {
     text?: string;
     rawText?: string;
@@ -155,9 +521,51 @@ declare interface GridCell {
     rowSpan?: number;
     style?: ComponentStyle;
 }
+declare interface GridCell_2 {
+    text?: string;
+    rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
+    /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
+    valueType?: "text" | "number" | "boolean";
+    /** 单元格级编辑控制；预览仍需显式开启 editing。 */
+    editable?: boolean;
+    source?: ReportCellSource_2;
+    /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
+    formula?: string;
+    children?: PlanComponent_2[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle_2;
+}
+declare interface GridCell_3 {
+    text?: string;
+    rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
+    /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
+    valueType?: "text" | "number" | "boolean";
+    /** 单元格级编辑控制；预览仍需显式开启 editing。 */
+    editable?: boolean;
+    source?: ReportCellSource_3;
+    /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
+    formula?: string;
+    children?: PlanComponent_3[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle_3;
+}
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
+/** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
+declare type ListAlignment_2 = NonNullable<ComponentStyle_2["align"]> | "auto";
+/** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
+declare type ListAlignment_3 = NonNullable<ComponentStyle_3["align"]> | "auto";
 declare interface ListColumn {
     header: string;
     field: string;
@@ -179,6 +587,59 @@ declare interface ListColumn {
     valueType?: GridCell["valueType"];
     /** 字段语义用于 auto 对齐；明确声明编号，避免把数字编号当成度量。 */
     semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
+    hidden?: boolean;
+    /** Condition hides cell content, preserving its physical layout in preview and exports. */
+    visibleWhen?: StyleRule["when"];
+}
+declare interface ListColumn_2 {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle_2;
+    /** 内容对齐，优先于 style.align；数值字符串不会自动判为数字。 */
+    align?: ListAlignment_2;
+    /** 独立的表头对齐，不改变内容对齐。 */
+    headerAlign?: ComponentStyle_2["align"];
+    /** 独立的表头样式，优先于列表级表头样式。 */
+    headerStyle?: ComponentStyle_2;
+    /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
+    format?: ColumnFormat_2;
+    /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
+    rules?: StyleRule_2[];
+    /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
+    editable?: boolean;
+    /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
+    valueType?: GridCell_2["valueType"];
+    /** 字段语义用于 auto 对齐；明确声明编号，避免把数字编号当成度量。 */
+    semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
+    hidden?: boolean;
+    /** Condition hides cell content, preserving its physical layout in preview and exports. */
+    visibleWhen?: StyleRule_2["when"];
+}
+declare interface ListColumn_3 {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle_3;
+    /** 内容对齐，优先于 style.align；数值字符串不会自动判为数字。 */
+    align?: ListAlignment_3;
+    /** 独立的表头对齐，不改变内容对齐。 */
+    headerAlign?: ComponentStyle_3["align"];
+    /** 独立的表头样式，优先于列表级表头样式。 */
+    headerStyle?: ComponentStyle_3;
+    /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
+    format?: ColumnFormat_3;
+    /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
+    rules?: StyleRule_3[];
+    /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
+    editable?: boolean;
+    /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
+    valueType?: GridCell_3["valueType"];
+    /** 字段语义用于 auto 对齐；明确声明编号，避免把数字编号当成度量。 */
+    semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
+    hidden?: boolean;
+    /** Condition hides cell content, preserving its physical layout in preview and exports. */
+    visibleWhen?: StyleRule_3["when"];
 }
 declare interface ListComponent {
     kind: "list";
@@ -212,14 +673,162 @@ declare interface ListComponent {
     border?: boolean;
     /** 分组小计（组头/组尾小计/组头防孤行） */
     groupBy?: ListGroupBy;
+    /** Ordered outer-to-inner grouping; groupBy remains the single-level shorthand. */
+    groups?: ListGroupBy[];
+    computed?: ComputedField[];
+    /** Dynamic pivot of the current source dataset, with read-only derived identities. */
+    matrix?: MatrixTableOptions;
+    /** 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. */
+    detail?: ListDetail;
     /** 末尾总合计行（依赖 groupBy.subtotal 或显式 fields） */
     grandTotal?: ListGrandTotal;
 }
+declare interface ListComponent_2 {
+    kind: "list";
+    id?: string;
+    /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
+    layout?: "page" | "wide";
+    /** 逻辑表名称，供 Excel Sheet 命名；不额外生成标题组件。 */
+    title?: string;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    dataset: string;
+    /** 数据集中稳定业务主键的字段名；省略时编辑仅有计划内坐标。 */
+    rowKey?: string;
+    revisionField?: string;
+    sourceTokenField?: string;
+    columns: ListColumn_2[];
+    fontSizePt?: number;
+    headerBold?: boolean;
+    rowHeightMm?: number;
+    paddingMm?: number;
+    headerEveryPage?: boolean;
+    headerBackgroundColor?: string;
+    /** 内容默认对齐，列配置可覆盖；低层模板缺省仍为 left。 */
+    align?: ListAlignment_2;
+    /** 表头默认对齐，列配置可覆盖。 */
+    headerAlign?: ComponentStyle_2["align"];
+    headerStyle?: ComponentStyle_2;
+    /** 可选多行合并表头；列宽按列表物理列对齐，供 Excel 业务模板复用。 */
+    headerGrid?: PlanGrid_2;
+    border?: boolean;
+    /** 分组小计（组头/组尾小计/组头防孤行） */
+    groupBy?: ListGroupBy_2;
+    /** Ordered outer-to-inner grouping; groupBy remains the single-level shorthand. */
+    groups?: ListGroupBy_2[];
+    computed?: ComputedField_2[];
+    /** Dynamic pivot of the current source dataset, with read-only derived identities. */
+    matrix?: MatrixTableOptions_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. */
+    detail?: ListDetail_2;
+    /** 末尾总合计行（依赖 groupBy.subtotal 或显式 fields） */
+    grandTotal?: ListGrandTotal_2;
+}
+declare interface ListComponent_3 {
+    kind: "list";
+    id?: string;
+    /** 宽表标记用于连续 Excel；不改变低层列表的列宽和分页算法。 */
+    layout?: "page" | "wide";
+    /** 逻辑表名称，供 Excel Sheet 命名；不额外生成标题组件。 */
+    title?: string;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    dataset: string;
+    /** 数据集中稳定业务主键的字段名；省略时编辑仅有计划内坐标。 */
+    rowKey?: string;
+    revisionField?: string;
+    sourceTokenField?: string;
+    columns: ListColumn_3[];
+    fontSizePt?: number;
+    headerBold?: boolean;
+    rowHeightMm?: number;
+    paddingMm?: number;
+    headerEveryPage?: boolean;
+    headerBackgroundColor?: string;
+    /** 内容默认对齐，列配置可覆盖；低层模板缺省仍为 left。 */
+    align?: ListAlignment_3;
+    /** 表头默认对齐，列配置可覆盖。 */
+    headerAlign?: ComponentStyle_3["align"];
+    headerStyle?: ComponentStyle_3;
+    /** 可选多行合并表头；列宽按列表物理列对齐，供 Excel 业务模板复用。 */
+    headerGrid?: PlanGrid_3;
+    border?: boolean;
+    /** 分组小计（组头/组尾小计/组头防孤行） */
+    groupBy?: ListGroupBy_3;
+    /** Ordered outer-to-inner grouping; groupBy remains the single-level shorthand. */
+    groups?: ListGroupBy_3[];
+    computed?: ComputedField_3[];
+    /** Dynamic pivot of the current source dataset, with read-only derived identities. */
+    matrix?: MatrixTableOptions_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. */
+    detail?: ListDetail_3;
+    /** 末尾总合计行（依赖 groupBy.subtotal 或显式 fields） */
+    grandTotal?: ListGrandTotal_3;
+}
+declare interface ListDetail {
+    dataset: string;
+    parentKey: string;
+    foreignKey: string;
+    rowKey?: string;
+    columns: ListColumn[];
+    rowHeightMm?: number;
+    header?: boolean;
+    label?: string;
+    /** Unmatched children fail by default; opt-in ignore is explicit. */
+    unmatched?: "error" | "ignore";
+}
+declare interface ListDetail_2 {
+    dataset: string;
+    parentKey: string;
+    foreignKey: string;
+    rowKey?: string;
+    columns: ListColumn_2[];
+    rowHeightMm?: number;
+    header?: boolean;
+    label?: string;
+    /** Unmatched children fail by default; opt-in ignore is explicit. */
+    unmatched?: "error" | "ignore";
+}
+declare interface ListDetail_3 {
+    dataset: string;
+    parentKey: string;
+    foreignKey: string;
+    rowKey?: string;
+    columns: ListColumn_3[];
+    rowHeightMm?: number;
+    header?: boolean;
+    label?: string;
+    /** Unmatched children fail by default; opt-in ignore is explicit. */
+    unmatched?: "error" | "ignore";
+}
 declare type ListGrandTotal = boolean | {
     label?: string;
     style?: ComponentStyle;
     /** 合计列（缺省沿用 groupBy.subtotal） */
     fields?: string[];
+    aggregates?: AggregateDefinition[];
+};
+declare type ListGrandTotal_2 = boolean | {
+    label?: string;
+    style?: ComponentStyle_2;
+    /** 合计列（缺省沿用 groupBy.subtotal） */
+    fields?: string[];
+    aggregates?: AggregateDefinition_2[];
+};
+declare type ListGrandTotal_3 = boolean | {
+    label?: string;
+    style?: ComponentStyle_3;
+    /** 合计列（缺省沿用 groupBy.subtotal） */
+    fields?: string[];
+    aggregates?: AggregateDefinition_3[];
 };
 /** 分组小计配置（声明式，见 ListComponent.groupBy） */
 declare interface ListGroupBy {
@@ -234,6 +843,43 @@ declare interface ListGroupBy {
     subtotalLabel?: string;
     /** 组头防孤行（默认 true：页尾放不下"组头+首行"时整体换页） */
     keepWithNext?: boolean;
+    aggregates?: AggregateDefinition[];
+    /** Repeat this group heading after page breaks within the group. */
+    repeatHeader?: boolean;
+}
+/** 分组小计配置（声明式，见 ListComponent.groupBy） */
+declare interface ListGroupBy_2 {
+    /** 分组字段（值变化即切组） */
+    field: string;
+    /** 组头文案模板，{value} 占位（默认 "{value}"） */
+    headerTemplate?: string;
+    headerStyle?: ComponentStyle_2;
+    /** 需要小计的列字段（组尾输出合计行；数值列求和，其余输出首值/留空） */
+    subtotal?: string[];
+    subtotalStyle?: ComponentStyle_2;
+    subtotalLabel?: string;
+    /** 组头防孤行（默认 true：页尾放不下"组头+首行"时整体换页） */
+    keepWithNext?: boolean;
+    aggregates?: AggregateDefinition_2[];
+    /** Repeat this group heading after page breaks within the group. */
+    repeatHeader?: boolean;
+}
+/** 分组小计配置（声明式，见 ListComponent.groupBy） */
+declare interface ListGroupBy_3 {
+    /** 分组字段（值变化即切组） */
+    field: string;
+    /** 组头文案模板，{value} 占位（默认 "{value}"） */
+    headerTemplate?: string;
+    headerStyle?: ComponentStyle_3;
+    /** 需要小计的列字段（组尾输出合计行；数值列求和，其余输出首值/留空） */
+    subtotal?: string[];
+    subtotalStyle?: ComponentStyle_3;
+    subtotalLabel?: string;
+    /** 组头防孤行（默认 true：页尾放不下"组头+首行"时整体换页） */
+    keepWithNext?: boolean;
+    aggregates?: AggregateDefinition_3[];
+    /** Repeat this group heading after page breaks within the group. */
+    repeatHeader?: boolean;
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
@@ -465,6 +1111,51 @@ declare interface MachReportToolbarOptions {
     /** 未传时显示全部已有出口；空数组表示不提供导出工具。 */
     exportFormats?: ReportExportFormat[];
 }
+declare interface MatrixTableOptions {
+    rowFields: readonly string[];
+    columnFields: readonly string[];
+    measures: readonly (AggregateDefinition & {
+        label?: string;
+    })[];
+    totals?: boolean;
+    rowHeader?: string;
+    columnWidthMm?: number;
+    rowWidthMm?: number;
+    maxRows?: number;
+    maxColumns?: number;
+    maxInputRows?: number;
+    maxCells?: number;
+}
+declare interface MatrixTableOptions_2 {
+    rowFields: readonly string[];
+    columnFields: readonly string[];
+    measures: readonly (AggregateDefinition_2 & {
+        label?: string;
+    })[];
+    totals?: boolean;
+    rowHeader?: string;
+    columnWidthMm?: number;
+    rowWidthMm?: number;
+    maxRows?: number;
+    maxColumns?: number;
+    maxInputRows?: number;
+    maxCells?: number;
+}
+declare interface MatrixTableOptions_3 {
+    rowFields: readonly string[];
+    columnFields: readonly string[];
+    measures: readonly (AggregateDefinition_3 & {
+        label?: string;
+    })[];
+    totals?: boolean;
+    rowHeader?: string;
+    columnWidthMm?: number;
+    rowWidthMm?: number;
+    maxRows?: number;
+    maxColumns?: number;
+    maxInputRows?: number;
+    maxCells?: number;
+}
 declare interface OutputDiagnostic {
     code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
     severity: "warning";
@@ -484,13 +1175,69 @@ 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;
     onProgress?: (completed: number, total: number) => void;
 }
-declare interface PlanComponent {
-    kind: ComponentKind;
+/** Stage counts are exact completed units; encoding libraries may remain indeterminate. */
+declare interface OutputTaskOptions_2 {
+    signal?: AbortSignal;
+    onProgress?: (completed: number, total: number) => void;
+}
+declare interface PlanComponent {
+    /** Template page furniture repeats per page and reserves its vertical band. */
+    pageAnchor?: "header" | "footer";
+    kind: ComponentKind;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph[];
+    imageData?: string;
+    /** 明确指定线段方向；省略保持历史水平线行为。 */
+    lineDirection?: "down" | "up";
+    grid?: PlanGrid;
+    table?: PlanTableFragment;
+    style?: ComponentStyle;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+declare interface PlanComponent_2 {
+    /** Template page furniture repeats per page and reserves its vertical band. */
+    pageAnchor?: "header" | "footer";
+    kind: ComponentKind_2;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph_2[];
+    imageData?: string;
+    /** 明确指定线段方向；省略保持历史水平线行为。 */
+    lineDirection?: "down" | "up";
+    grid?: PlanGrid_2;
+    table?: PlanTableFragment_2;
+    style?: ComponentStyle_2;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+declare interface PlanComponent_3 {
+    /** Template page furniture repeats per page and reserves its vertical band. */
+    pageAnchor?: "header" | "footer";
+    kind: ComponentKind_3;
     leftMm: number;
     topMm: number;
     widthMm: number;
@@ -500,13 +1247,13 @@ declare interface PlanComponent {
     text?: string;
     rawText?: string;
     lines?: string[];
-    richParagraphs?: RichParagraph[];
+    richParagraphs?: RichParagraph_3[];
     imageData?: string;
     /** 明确指定线段方向；省略保持历史水平线行为。 */
     lineDirection?: "down" | "up";
-    grid?: PlanGrid;
-    table?: PlanTableFragment;
-    style?: ComponentStyle;
+    grid?: PlanGrid_3;
+    table?: PlanTableFragment_3;
+    style?: ComponentStyle_3;
     meta?: Record<string, unknown>;
     /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
     fallbackText?: string;
@@ -520,6 +1267,24 @@ declare interface PlanGrid {
     /** 单元格四边内距；旧静态网格默认 0.5mm，分页列表使用其真实测量内距。 */
     paddingMm?: number;
 }
+declare interface PlanGrid_2 {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell_2 | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+    /** 单元格四边内距；旧静态网格默认 0.5mm，分页列表使用其真实测量内距。 */
+    paddingMm?: number;
+}
+declare interface PlanGrid_3 {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell_3 | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+    /** 单元格四边内距；旧静态网格默认 0.5mm，分页列表使用其真实测量内距。 */
+    paddingMm?: number;
+}
 /** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
 declare interface PlanTableFragment {
     /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
@@ -536,7 +1301,97 @@ declare interface PlanTableFragment {
         rowKey?: string | number;
     };
 }
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment_2 {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+    /** 只有宿主声明稳定 rowKey 时生成，不能用显示顺序替代业务主键。 */
+    source?: Omit<ReportCellSource_2, "field" | "rowKey"> & {
+        rowKey?: string | number;
+    };
+}
+/** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
+declare interface PlanTableFragment_3 {
+    /** 在整个计划中唯一的逻辑表身份；同一表的分页片段共享身份。 */
+    id: string;
+    /** 表头固定 -1；其余行（包括组头/小计/总计）从 0 连续递增。 */
+    rowIndex: number;
+    role: "header" | "body" | "group-header" | "subtotal" | "grand-total";
+    /** 按物理列顺序保存字段身份；不以表头显示文本判断列结构。 */
+    columnKeys: string[];
+    layout?: "page" | "wide";
+    title?: string;
+    /** 只有宿主声明稳定 rowKey 时生成，不能用显示顺序替代业务主键。 */
+    source?: Omit<ReportCellSource_3, "field" | "rowKey"> & {
+        rowKey?: string | number;
+    };
+}
 declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
+    repeatPage: string;
+    repeatNone: string;
+    repeatHeader: string;
+    repeatFooter: string;
+    textFormat: string;
+    fontSize: string;
+    fontBold: string;
+    textColor: string;
+    backgroundColor: string;
+    canvasGridLimited: string;
+    design: string;
+    preview: string;
+    componentSection: string;
+    toolsSection: string;
+    component: string;
+    components: string;
+    canvasHint: string;
+    zoom: string;
+    sampleRows: string;
+    resizeComponent: string;
+    resizeColumn: string;
+    insertComponent: string;
+    insertText: string;
+    insertList: string;
+    insertImage: string;
+    insertRect: string;
+    removeComponent: string;
+    duplicateComponent: string;
+    forward: string;
+    backward: string;
+    positionGroup: string;
+    componentContent: string;
+    componentText: string;
+    imageSource: string;
+    imageUpload: string;
+    imageBudget: string;
+    leftPosition: string;
+    topPosition: string;
+    componentWidth: string;
+    componentHeight: string;
+    noComponent: string;
+    listDataset: string;
+    columnOrder: string;
+    moveColumnLeft: string;
+    moveColumnRight: string;
+    columnVisible: string;
+    headerStructure: string;
+    addHeaderRow: string;
+    mergeHeader: string;
+    splitHeader: string;
+    headerRow: string;
+    headerFirst: string;
+    headerLast: string;
+    excelTool: string;
+    rulesTool: string;
+    reviewTool: string;
+    toolsDescription: string;
+    rulesNeedList: string;
     undo: string;
     redo: string;
     columnsSearch: string;
@@ -684,6 +1539,22 @@ declare interface ReportCellSource {
     revision?: string | number;
     sourceToken?: string;
 }
+/** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
+declare interface ReportCellSource_2 {
+    datasetId: string;
+    rowKey: string | number;
+    field: string;
+    revision?: string | number;
+    sourceToken?: string;
+}
+/** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
+declare interface ReportCellSource_3 {
+    datasetId: string;
+    rowKey: string | number;
+    field: string;
+    revision?: string | number;
+    sourceToken?: string;
+}
 declare interface ReportCellTableIdentity {
     id: string;
     /** 逻辑表行索引；跨分页的同一行保持不变。 */
@@ -735,6 +1606,84 @@ declare interface ReportEditResult {
 }
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+declare type ReportExpression = {
+    field: string;
+} | {
+    value: string | number | boolean | null;
+} | {
+    aggregate: AggregateOperation;
+    field?: string;
+    weightField?: string;
+} | {
+    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    args: readonly ReportExpression[];
+};
+declare type ReportExpression_2 = {
+    field: string;
+} | {
+    value: string | number | boolean | null;
+} | {
+    aggregate: AggregateOperation_2;
+    field?: string;
+    weightField?: string;
+} | {
+    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    args: readonly ReportExpression_2[];
+};
+declare type ReportExpression_3 = {
+    field: string;
+} | {
+    value: string | number | boolean | null;
+} | {
+    aggregate: AggregateOperation_3;
+    field?: string;
+    weightField?: string;
+} | {
+    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    args: readonly ReportExpression_3[];
+};
+declare interface ReportFieldContract {
+    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 ReportFieldContract_2 {
+    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 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 ReportInteractionOptions {
     /** 只读选区计算，默认关闭；不写回业务值或执行导入的 Excel 公式。 */
     calculations?: boolean;
@@ -770,6 +1719,48 @@ declare interface ReportParamDef {
     minLength?: number;
     maxLength?: number;
 }
+/** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
+declare interface ReportParamDef_2 {
+    /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
+    field: string;
+    /** 显示名（缺省用 field） */
+    label?: string;
+    type?: "text" | "number" | "date" | "select";
+    /** select 选项 */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    defaultValue?: string;
+    required?: boolean;
+    placeholder?: string;
+    /** 数字上下界；date 参数使用 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" | "select";
+    /** select 选项 */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    defaultValue?: string;
+    required?: boolean;
+    placeholder?: string;
+    /** 数字上下界；date 参数使用 YYYY-MM-DD 字符串（含边界）。 */
+    min?: number | string;
+    max?: number | string;
+    minLength?: number;
+    maxLength?: number;
+}
 declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -788,6 +1779,18 @@ declare interface ReportTemplate {
     params?: ReportParamDef[];
     pages: TemplatePage[];
 }
+declare interface ReportTemplate_2 {
+    schemaVersion?: string;
+    /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
+    params?: ReportParamDef_2[];
+    pages: TemplatePage_2[];
+}
+declare interface ReportTemplate_3 {
+    schemaVersion?: string;
+    /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
+    params?: ReportParamDef_3[];
+    pages: TemplatePage_3[];
+}
 /** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
 declare interface ReportTemplateDocument {
     schemaVersion: "1.0";
@@ -798,6 +1801,26 @@ declare interface ReportTemplateDocument {
     description?: string;
     template: ReportTemplate;
 }
+/** 可存入数据库/文件的纯 JSON 模板；数据、接口与鉴权仍由宿主提供。 */
+declare interface ReportTemplateDocument_2 {
+    schemaVersion: "1.0";
+    id: string;
+    name: string;
+    /** 宿主的发布版本/乐观锁标识，不由引擎自动递增。 */
+    revision?: string;
+    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;
@@ -808,10 +1831,22 @@ export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     "update:modelValue": (document: ReportTemplateDocument) => any;
     saved: (document: ReportTemplateDocument) => any;
+    "excel-bound": (result: ExcelBindingWizardApply) => any;
 }, string, MachReportVuePublicProps, Readonly<TemplateEditorOptions> & Readonly<{
     "onUpdate:modelValue"?: ((document: ReportTemplateDocument) => any) | undefined;
     onSaved?: ((document: ReportTemplateDocument) => any) | undefined;
+    "onExcel-bound"?: ((result: ExcelBindingWizardApply) => any) | undefined;
 }>, {}>;
+declare interface ReportTemplateReviewIssue {
+    code: "template" | "compatibility" | "dataset" | "field" | "sample" | "layout" | "output";
+    severity: "error" | "warning";
+    path: string;
+    message: string;
+    fixture?: string;
+    pageIndex?: number;
+    componentIndex?: number;
+    field?: string;
+}
 declare interface RichParagraph {
     segments: RichSegment[];
     align?: ComponentStyle["align"];
@@ -820,23 +1855,266 @@ declare interface RichParagraph {
     spaceAfterMm?: number;
     indentMm?: number;
 }
+declare interface RichParagraph_2 {
+    segments: RichSegment_2[];
+    align?: ComponentStyle_2["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
+declare interface RichParagraph_3 {
+    segments: RichSegment_3[];
+    align?: ComponentStyle_3["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
 declare interface RichSegment {
     kind?: "text" | "field";
     text?: string;
     field?: string;
     style?: ComponentStyle;
 }
+declare interface RichSegment_2 {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle_2;
+}
+declare interface RichSegment_3 {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle_3;
+}
+/** Optional rule-editor copy; hosts can override without changing core/report messages. */
+export declare const RULE_EDITOR_MESSAGES: {
+    detail: string;
+    matrix: string;
+    measureLabel: string;
+    childDataset: string;
+    parentKey: string;
+    foreignKey: string;
+    rowKey: string;
+    noRowKey: string;
+    childColumns: string;
+    title: string;
+    unmatched: string;
+    ignore: string;
+    childHeader: string;
+    rowFields: string;
+    columnFields: string;
+    totals: string;
+    widthSettings: string;
+    dimensionWidth: string;
+    measureWidth: string;
+    detailHint: string;
+    matrixHint: string;
+    computations: string;
+    groups: string;
+    conditions: string;
+    target: string;
+    newField: string;
+    select: string;
+    row: string;
+    group: string;
+    dataset: string;
+    scope: string;
+    numeric: string;
+    number: string;
+    decimal: string;
+    digits: string;
+    groupFields: string;
+    field: string;
+    constant: string;
+    operation: string;
+    aggregate: string;
+    text: string;
+    boolean: string;
+    null: string;
+    true: string;
+    false: string;
+    add: string;
+    subtract: string;
+    multiply: string;
+    divide: string;
+    coalesce: string;
+    sum: string;
+    count: string;
+    avg: string;
+    min: string;
+    max: string;
+    weightedAvg: string;
+    subtotalLabel: string;
+    weight: string;
+    argument: string;
+    addArgument: string;
+    remove: string;
+    apply: string;
+    check: string;
+    addGroup: string;
+    noGroups: string;
+    header: string;
+    footer: string;
+    repeat: string;
+    orphan: string;
+    outer: string;
+    inner: string;
+    addAggregate: string;
+    measure: string;
+    output: string;
+    condition: string;
+    comparison: string;
+    threshold: string;
+    effect: string;
+    style: string;
+    cell: string;
+    rowVisibility: string;
+    color: string;
+    background: string;
+    bold: string;
+    column: string;
+    newCondition: string;
+    removeCondition: string;
+    advanced: string;
+    nulls: string;
+    propagate: string;
+    error: string;
+    division: string;
+    dependencies: string;
+    noData: string;
+    sample: string;
+    preview: string;
+    existing: string;
+    ready: string;
+    allRows: string;
+    noFields: string;
+    resultType: string;
+    settings: string;
+    moveUp: string;
+    moveDown: string;
+    missingTarget: string;
+    noSelection: string;
+    countHint: string;
+    decimalHint: string;
+    readonly: string;
+    formatMode: string;
+    rule: string;
+    sampleError: string;
+    new: string;
+    enabled: string;
+};
+export declare const RuleEditor: DefineComponent<RuleEditorOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    change: (value: ListComponent_3) => any;
+}, string, MachReportVuePublicProps, Readonly<RuleEditorOptions> & Readonly<{
+    onChange?: ((value: ListComponent_3) => 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>;
+    readonly?: boolean;
+    messages?: Partial<RuleEditorMessages>;
+}
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule {
     when: {
         field: string;
         op: ">" | ">=" | "<" | "<=" | "==" | "!=";
         value: number | string;
+        /** Explicit decimal comparisons retain decimal thresholds as text. */
+        numeric?: "number" | "decimal";
+    };
+    /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
+    style: Record<string, unknown>;
+}
+/** 条件格式规则求值（声明式，见 ListColumn.rules） */
+declare interface StyleRule_2 {
+    when: {
+        field: string;
+        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
+        value: number | string;
+        /** Explicit decimal comparisons retain decimal thresholds as text. */
+        numeric?: "number" | "decimal";
+    };
+    /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
+    style: Record<string, unknown>;
+}
+/** 条件格式规则求值（声明式，见 ListColumn.rules） */
+declare interface StyleRule_3 {
+    when: {
+        field: string;
+        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
+        value: number | string;
+        /** Explicit decimal comparisons retain decimal thresholds as text. */
+        numeric?: "number" | "decimal";
     };
     /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
     style: Record<string, unknown>;
 }
 export declare const TEMPLATE_EDITOR_MESSAGES: {
+    repeatPage: string;
+    repeatNone: string;
+    repeatHeader: string;
+    repeatFooter: string;
+    textFormat: string;
+    fontSize: string;
+    fontBold: string;
+    textColor: string;
+    backgroundColor: string;
+    canvasGridLimited: string;
+    design: string;
+    preview: string;
+    componentSection: string;
+    toolsSection: string;
+    component: string;
+    components: string;
+    canvasHint: string;
+    zoom: string;
+    sampleRows: string;
+    resizeComponent: string;
+    resizeColumn: string;
+    insertComponent: string;
+    insertText: string;
+    insertList: string;
+    insertImage: string;
+    insertRect: string;
+    removeComponent: string;
+    duplicateComponent: string;
+    forward: string;
+    backward: string;
+    positionGroup: string;
+    componentContent: string;
+    componentText: string;
+    imageSource: string;
+    imageUpload: string;
+    imageBudget: string;
+    leftPosition: string;
+    topPosition: string;
+    componentWidth: string;
+    componentHeight: string;
+    noComponent: string;
+    listDataset: string;
+    columnOrder: string;
+    moveColumnLeft: string;
+    moveColumnRight: string;
+    columnVisible: string;
+    headerStructure: string;
+    addHeaderRow: string;
+    mergeHeader: string;
+    splitHeader: string;
+    headerRow: string;
+    headerFirst: string;
+    headerLast: string;
+    excelTool: string;
+    rulesTool: string;
+    reviewTool: string;
+    toolsDescription: string;
+    rulesNeedList: string;
     undo: string;
     redo: string;
     columnsSearch: string;
@@ -911,7 +2189,50 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     note: string;
     invalid: string;
 };
+export declare const TEMPLATE_REVIEW_MESSAGES: {
+    title: string;
+    run: string;
+    running: string;
+    samples: string;
+    none: string;
+    first20: string;
+    first100: string;
+    all: string;
+    changes: string;
+    issues: string;
+    results: string;
+    noChanges: string;
+    noIssues: string;
+    empty: string;
+    baseline: string;
+    errors: string;
+    warnings: string;
+    locate: string;
+    before: string;
+    after: string;
+    breaking: string;
+    acknowledge: string;
+    truncated: string;
+    pages: string;
+    rows: string;
+    checked: string;
+    categories: {
+        metadata: string;
+        structure: string;
+        binding: string;
+        calculation: string;
+        format: string;
+    };
+    kinds: {
+        added: string;
+        removed: string;
+        modified: string;
+        moved: string;
+    };
+};
 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";
@@ -933,6 +2254,10 @@ export declare type TemplateEditorMessages = typeof BASE_TEMPLATE_EDITOR_MESSAGE
 export declare interface TemplateEditorOptions {
     modelValue: ReportTemplateDocument;
     datasets?: DatasetRows;
+    dataSchemas?: Record<string, DatasetContract>;
+    bindingDatasets?: ExcelBindingDataset[];
+    /** Optional independently persisted Excel source and binding recipe. */
+    bindingSession?: ExcelBindingSession;
     readonly?: boolean;
     messages?: Partial<TemplateEditorMessages>;
     preview?: Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "theme" | "assets" | "pdfFontUrl" | "toolbar">;
@@ -954,6 +2279,48 @@ declare interface TemplatePage {
     marginRightMm?: number;
     components: TemplateComponent[];
 }
+declare interface TemplatePage_2 {
+    widthMm: number;
+    heightMm: number;
+    /** 宽表保持全列自然宽度，页高只控制内部纵向分段。 */
+    layout?: "page" | "wide";
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: TemplateComponent_2[];
+}
+declare interface TemplatePage_3 {
+    widthMm: number;
+    heightMm: number;
+    /** 宽表保持全列自然宽度，页高只控制内部纵向分段。 */
+    layout?: "page" | "wide";
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: TemplateComponent_3[];
+}
+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[];
+    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[];
+    messages?: Partial<TemplateReviewMessages>;
+}> & Readonly<{
+    onLocate?: ((value: Pick<ReportTemplateReviewIssue, "field" | "path" | "pageIndex" | "componentIndex">) => any) | undefined;
+}>, {}>;
 /**
  * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
  * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、