@agile-team/mach-report 2.17.0 → 2.18.0

package/dist/vue/index.d.cts

@@ -8,7 +8,16 @@ import { ExtractPropTypes } from 'vue';
 import { InjectionKey } from 'vue';
 import { PropType } from 'vue';
 import { Ref } from 'vue';
+import { ShallowRef } from 'vue';
 declare const __VLS_component: DefineComponent<ExtractPropTypes<{
+    prefill: {
+        type: PropType<ReportPrefillReviewOptions | false>;
+        default: undefined;
+    };
+    dataComparison: {
+        type: PropType<ReportDataComparisonReviewOptions | false>;
+        default: undefined;
+    };
     drill: {
         type: PropType<ReportDrillOptions>;
         default: undefined;
@@ -159,7 +168,7 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         ?: boolean;
     }): Promise<void> | void;
     importExcel?(input: ArrayBuffer | Uint8Array | Blob, options?: ExcelImportOptions): Promise<ExcelImportResult | null>;
-    getPlan?(): RenderPlan | null;
+    getPlan?(): RenderPlan_2 | null;
     getChanges?(): ReportCellEdit_2[];
     getDifferences?(): ReportCellEdit_2[];
     undo?(): Promise<boolean>;
@@ -183,6 +192,14 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     "template-import": (result: ExcelImportResult) => any;
     "preferences-change": (preferences: Readonly<ReportPreviewPreferences>) => any;
 }, string, MachReportVuePublicProps, Readonly<ExtractPropTypes<{
+    prefill: {
+        type: PropType<ReportPrefillReviewOptions | false>;
+        default: undefined;
+    };
+    dataComparison: {
+        type: PropType<ReportDataComparisonReviewOptions | false>;
+        default: undefined;
+    };
     drill: {
         type: PropType<ReportDrillOptions>;
         default: undefined;
@@ -320,13 +337,14 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     "onTemplate-import"?: ((result: ExcelImportResult) => any) | undefined;
     "onPreferences-change"?: ((preferences: Readonly<ReportPreviewPreferences>) => any) | undefined;
 }>, {
+    output: ReportOutputOptions;
     editable: boolean | ReportEditingOptions;
     params: Record<string, string>;
-    output: ReportOutputOptions;
     height: string;
     gapPx: number;
     assets: AssetRenderOptions;
     reportId: string | string[] | null;
+    prefill: false | ReportPrefillReviewOptions;
     debug: boolean;
     showExport: boolean;
     showPrint: boolean;
@@ -343,6 +361,7 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     guardChanges: boolean;
     beforeDiscard: ReportBeforeDiscard;
     messages: Partial<MachReportMessages>;
+    dataComparison: false | ReportDataComparisonReviewOptions;
     excelImport: boolean | ExcelImportOptions;
     preset: string;
     emptyState: boolean | ReportEmptyState;
@@ -429,6 +448,26 @@ declare type __VLS_Props_3 = {
     disabled?: boolean;
     loadOptions?: ReportParamOptionsLoader;
 };
+declare type __VLS_Props_4 = {
+    issues: readonly ReportValidationIssue[];
+    messages?: Partial<{
+        title: string;
+        error: string;
+        warning: string;
+        locate: string;
+        dataset: string;
+        row: string;
+        more: string;
+    }>;
+};
+declare type __VLS_Props_5 = {
+    state: ReportPrefillState;
+    messages: ReportDataReviewMessages;
+};
+declare type __VLS_Props_6 = {
+    state: ReportDataComparisonState;
+    messages: ReportDataReviewMessages;
+};
 declare function __VLS_template(): {
     slots: {
         settings?(_: {}): any;
@@ -439,6 +478,7 @@ declare function __VLS_template_2(): {
     attrs: Partial<{}>;
     slots: {
         navigation?(_: {}): any;
+        'data-tools'?(_: {}): any;
     };
     refs: {
         searchToggleRef: HTMLButtonElement;
@@ -461,7 +501,7 @@ declare type __VLS_WithTemplateSlots_2<T, S> = T & {
 declare interface AggregateDefinition {
     /** Output column; valueField defaults to this field. */
     field: string;
-    op: AggregateOperation;
+    op: AggregateOperation_2;
     valueField?: string;
     weightField?: string;
     numeric?: "number" | "decimal";
@@ -470,7 +510,7 @@ declare interface AggregateDefinition {
 declare interface AggregateDefinition_2 {
     /** Output column; valueField defaults to this field. */
     field: string;
-    op: AggregateOperation_2;
+    op: AggregateOperation;
     valueField?: string;
     weightField?: string;
     numeric?: "number" | "decimal";
@@ -488,6 +528,27 @@ 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 interface AggregateRequest {
+    op: AggregateOperation;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+declare interface AggregateRequest_2 {
+    op: AggregateOperation_2;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+declare interface AggregateRequest_3 {
+    op: AggregateOperation_3;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -535,8 +596,8 @@ declare interface BrowserReportWorker {
     removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
 }
 /** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
-export declare function buildPrintDocument(p: RenderPlan, options?: ReportPrintOptions): PrintHtmlResult;
-export declare function buildWordHtml(p: RenderPlan): {
+export declare function buildPrintDocument(p: RenderPlan_2, options?: ReportPrintOptions): PrintHtmlResult;
+export declare function buildWordHtml(p: RenderPlan_2): {
     html: string;
     filename: string;
 };
@@ -639,6 +700,54 @@ declare type ColumnFormat_3 = {
     kind: "date";
     pattern?: string;
 };
+declare type ColumnVisual = {
+    /** Defaults to the column field; never changes the cell's raw value or business identity. */
+    field?: string;
+    /** Numeric text requires explicit opt-in; formatting an identifier does not turn it into a measure. */
+    numeric?: "number" | "decimal";
+    min?: number;
+    max?: number;
+} & ({
+    kind: "colorScale";
+    lowColor?: string;
+    highColor?: string;
+} | {
+    kind: "dataBar";
+    color?: string;
+    negativeColor?: string;
+});
+declare type ColumnVisual_2 = {
+    /** Defaults to the column field; never changes the cell's raw value or business identity. */
+    field?: string;
+    /** Numeric text requires explicit opt-in; formatting an identifier does not turn it into a measure. */
+    numeric?: "number" | "decimal";
+    min?: number;
+    max?: number;
+} & ({
+    kind: "colorScale";
+    lowColor?: string;
+    highColor?: string;
+} | {
+    kind: "dataBar";
+    color?: string;
+    negativeColor?: string;
+});
+declare type ColumnVisual_3 = {
+    /** Defaults to the column field; never changes the cell's raw value or business identity. */
+    field?: string;
+    /** Numeric text requires explicit opt-in; formatting an identifier does not turn it into a measure. */
+    numeric?: "number" | "decimal";
+    min?: number;
+    max?: number;
+} & ({
+    kind: "colorScale";
+    lowColor?: string;
+    highColor?: string;
+} | {
+    kind: "dataBar";
+    color?: string;
+    negativeColor?: string;
+});
 declare interface ComponentAssetRegistry {
     rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
     hasExtension(id: string, version: string, kind: string): boolean;
@@ -805,7 +914,7 @@ export declare function createFetchRequest(options?: FetchRequestOptions): HostR
  */
 export declare function createLocalFetcher(entries: Record<string, LocalTemplateEntry> | ReportRegistry): PlanFetcher;
 /** Independent physical test page. Its ruler is measured in millimetres, never CSS pixels. */
-export declare function createPrintCalibrationPlan(widthMm: number, heightMm: number): RenderPlan_2;
+export declare function createPrintCalibrationPlan(widthMm: number, heightMm: number): RenderPlan;
 /** Explicit persistence bridge. Merely registering ReportProvider never enables editing or saving. */
 export declare function createProviderEditing(provider: ReportProvider, options: ProviderEditingOptions): ReportEditingOptions;
 /** Optional browser convenience adapter. Access errors are handled by the preview. */
@@ -823,6 +932,7 @@ declare interface DatasetValidationOptions {
     maxIssues?: number;
 }
 export declare const DEFAULT_CALCULATION_MESSAGES: ReportCalculationMessages;
+export declare const DEFAULT_DATA_REVIEW_MESSAGES: ReportDataReviewMessages;
 export declare const DEFAULT_MESSAGES: MachReportMessages;
 export declare const DEFAULT_PRINT_MESSAGES: Required<ReportPrintMessages>;
 export declare const DEFAULT_THEME: MachReportTheme;
@@ -960,7 +1070,21 @@ declare interface FormulaAdapter {
         rows: readonly Record<string, unknown>[];
     }): unknown;
 }
+declare interface FormulaAdapter_2 {
+    /** Explicit trusted engine; core never evaluates source code/macros/external workbook references. */
+    evaluate(expression: string, context: {
+        row: Readonly<Record<string, unknown>>;
+        rowIndex: number;
+        rows: readonly Record<string, unknown>[];
+    }): unknown;
+}
 declare interface GridCell {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph[];
     text?: string;
@@ -986,6 +1110,12 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph_2[];
     text?: string;
@@ -1011,6 +1141,12 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph_3[];
     text?: string;
@@ -1091,6 +1227,8 @@ declare interface ListColumn {
     format?: ColumnFormat_2;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule[];
+    /** Optional resolved color scale or value-preserving data bar. */
+    visual?: ColumnVisual;
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
     editable?: boolean;
     /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
@@ -1116,6 +1254,8 @@ declare interface ListColumn_2 {
     format?: ColumnFormat;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule_2[];
+    /** Optional resolved color scale or value-preserving data bar. */
+    visual?: ColumnVisual_2;
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
     editable?: boolean;
     /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
@@ -1141,6 +1281,8 @@ declare interface ListColumn_3 {
     format?: ColumnFormat_3;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule_3[];
+    /** Optional resolved color scale or value-preserving data bar. */
+    visual?: ColumnVisual_3;
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
     editable?: boolean;
     /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
@@ -1469,7 +1611,7 @@ export declare interface MachReportController {
     /** Explicit import does not require the toolbar excelImport option. No host APIs are called. */
     importExcel?(input: ArrayBuffer | Uint8Array | Blob, options?: ExcelImportOptions): Promise<ExcelImportResult | null>;
     /** Copies prevent consumers from mutating the preview's current snapshot. */
-    getPlan?(): RenderPlan | null;
+    getPlan?(): RenderPlan_2 | null;
     getChanges?(): ReportCellEdit_2[];
     getDifferences?(): ReportCellEdit_2[];
     undo?(): Promise<boolean>;
@@ -1517,6 +1659,10 @@ export declare interface MachReportDefaults {
     xlsx?: XlsxRenderOptions;
     /** 默认关闭；true 为本地草稿，对象可提供权限、校验和保存回调。 */
     editable?: boolean | ReportEditingOptions;
+    /** Optional reference-data loader; review and atomic editing are maintained inside the package. */
+    prefill?: ReportPrefillReviewOptions | false;
+    /** Compare a reference with the same query result rendered in the report. */
+    dataComparison?: ReportDataComparisonReviewOptions | false;
     /** 默认关闭；启用后提供导入按钮。ExcelJS 仅在导入时加载。 */
     excelImport?: boolean | ExcelImportOptions;
 }
@@ -1549,7 +1695,7 @@ export declare interface MachReportHandle extends MachReportController {
         reload?: boolean;
     }): Promise<void>;
     importExcel(input: ArrayBuffer | Uint8Array | Blob, options?: ExcelImportOptions): Promise<ExcelImportResult | null>;
-    getPlan(): RenderPlan | null;
+    getPlan(): RenderPlan_2 | null;
     getChanges(): ReportCellEdit_2[];
     getDifferences(): ReportCellEdit_2[];
     undo(): Promise<boolean>;
@@ -1570,7 +1716,14 @@ export declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-export declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages, ReportParamOptionsMessages {
+export declare interface MachReportMessages extends Partial<ReportCalculationMessages>, Partial<ReportDataReviewMessages>, ReportPrintMessages, ReportParamOptionsMessages {
+    reviewTools?: string;
+    validationTitle?: string;
+    validationError?: string;
+    validationWarning?: string;
+    validationDataset?: string;
+    validationRow?: string;
+    validationMore?: string;
     drillActions?: string;
     drillOpening?: string;
     drillMissingValue?: string;
@@ -2030,17 +2183,19 @@ declare interface PaginateOptions {
     maxPages?: number;
     /** Actual grid cells, including repeated furniture and nested children; checked before each page is appended. */
     maxCells?: number;
+    /** Shared bound-chart primitive budget, checked before expansion; default 50000, range 1..1000000. */
+    maxChartComponents?: number;
     signal?: AbortSignal;
     /** Streaming total-page anchors can skip the bounded counting pass when known. */
     knownTotalPages?: number;
     onWarning?: (warning: string) => void;
     /** Trusted formula adapter is passed at execution time; it is never serialized in templates. */
-    formula?: FormulaAdapter;
+    formula?: FormulaAdapter_2;
 }
 export declare const PARAM_OPTIONS_MESSAGES: Required<ReportParamOptionsMessages>;
 /** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
 export declare interface PdfExporter {
-    (plan: RenderPlan, onWarning?: (message: string) => void, task?: OutputTaskOptions_2 & {
+    (plan: RenderPlan_2, onWarning?: (message: string) => void, task?: OutputTaskOptions_2 & {
         onDiagnostic?: (entry: OutputDiagnostic) => void;
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
@@ -2057,6 +2212,8 @@ export declare interface PdfFontCheckResult {
 /** available 仅表示字体资源可达；实际导出仍会校验文字能否编码。 */
 export declare type PdfFontStatus = "unchecked" | "checking" | "available" | "disabled" | "unverified" | "error";
 declare interface PlanComponent {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -2085,6 +2242,8 @@ declare interface PlanComponent {
     fallbackText?: string;
 }
 declare interface PlanComponent_2 {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding_2;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions_2;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -2113,6 +2272,8 @@ declare interface PlanComponent_2 {
     fallbackText?: string;
 }
 declare interface PlanComponent_3 {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding_3;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions_3;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -2141,7 +2302,7 @@ declare interface PlanComponent_3 {
     fallbackText?: string;
 }
 export declare interface PlanFetcher {
-    (input: ReportFetchInput): Promise<RenderPlan>;
+    (input: ReportFetchInput): Promise<RenderPlan_2>;
     getParamDefs?: ReportFetcher["getParamDefs"];
 }
 declare interface PlanGrid {
@@ -2184,7 +2345,7 @@ declare interface PlanPage {
     marginBottomMm?: number;
     marginLeftMm?: number;
     marginRightMm?: number;
-    components: PlanComponent[];
+    components: PlanComponent_2[];
 }
 declare interface PlanPage_2 {
     meta?: Record<string, unknown>;
@@ -2196,7 +2357,7 @@ declare interface PlanPage_2 {
     marginBottomMm?: number;
     marginLeftMm?: number;
     marginRightMm?: number;
-    components: PlanComponent_2[];
+    components: PlanComponent[];
 }
 /** 列表的逻辑行来源；用于连续 Excel 重组，避免按文本猜测重复表头。 */
 declare interface PlanTableFragment {
@@ -2249,8 +2410,8 @@ declare interface PlanTableFragment_3 {
 /** Bounded concurrency, one stage timeout, and cancellation even for a hanging decoder. */
 export declare function preparePrintResources(doc: Document, options?: ReportPrintOptions, signal?: AbortSignal, base?: string): Promise<void>;
 declare interface PreviewEncoding {
-    pdf(plan: RenderPlan, exporter: PdfExporter, warning: (message: string) => void, task?: PreviewEncodingTask): Promise<Uint8Array>;
-    xlsx(plan: RenderPlan, options: XlsxRenderOptions, task: PreviewEncodingTask): Promise<{
+    pdf(plan: RenderPlan_2, exporter: PdfExporter, warning: (message: string) => void, task?: PreviewEncodingTask): Promise<Uint8Array>;
+    xlsx(plan: RenderPlan_2, options: XlsxRenderOptions, task: PreviewEncodingTask): Promise<{
         buffer: Uint8Array;
         warnings: string[];
     }>;
@@ -2270,7 +2431,7 @@ declare interface PrintHtmlResult {
  * 批量打印（多单连打）：把多份计划合并为一个打印文档——
  * named pages 保证混合纸张正确分页，浏览器只弹一次打印对话框。
  */
-export declare function printPlans(plans: RenderPlan[], options?: {
+export declare function printPlans(plans: RenderPlan_2[], options?: {
     onProgress?: (done: number, total: number) => void;
     onError?: (message: string) => void;
     signal?: AbortSignal;
@@ -2351,6 +2512,10 @@ export declare interface ReportCalculationMessages {
     calculationErrorOverflow: string;
     calculationErrorPrecision: string;
 }
+declare interface ReportCandidateValidationOptions extends Pick<ReportDatasetValidationOptions, "rules" | "maxChecks" | "maxIssues"> {
+    /** Warnings are visible and allowed by default; block explicitly when required by business policy. */
+    warningPolicy?: "allow" | "block";
+}
 /** 预览中的物理坐标；合并单元格使用左上角坐标。 */
 declare interface ReportCellAddress {
     pageIndex: number;
@@ -2478,6 +2643,265 @@ declare interface ReportCellTableIdentity_2 {
 declare type ReportCellValue = string | number | boolean | null;
 declare type ReportCellValue_2 = string | number | boolean | null;
 declare type ReportCellValueType = NonNullable<GridCell_2["valueType"]>;
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure[];
+    type: ReportChartOptions["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding_2 {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure_2[];
+    type: ReportChartOptions_2["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding_3 {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure_3[];
+    type: ReportChartOptions_3["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+declare interface ReportChartMeasure extends AggregateRequest {
+    label?: string;
+    color?: string;
+}
+declare interface ReportChartMeasure_2 extends AggregateRequest_2 {
+    label?: string;
+    color?: string;
+}
+declare interface ReportChartMeasure_3 extends AggregateRequest_3 {
+    label?: string;
+    color?: string;
+}
+declare interface ReportChartOptions {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+declare interface ReportChartOptions_2 {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries_2[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+declare interface ReportChartOptions_3 {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries_3[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+declare interface ReportChartSeries {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+declare interface ReportChartSeries_2 {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+declare interface ReportChartSeries_3 {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+declare interface ReportComparison {
+    field: string;
+    op: ">" | ">=" | "<" | "<=" | "==" | "!=" | "between" | "contains" | "isNull" | "isNotNull";
+    /** Legacy scalar thresholds remain supported. Use right for field-to-field comparisons. */
+    value?: ReportPredicateScalar;
+    right?: ReportPredicateOperand;
+    values?: readonly [
+        ReportPredicateScalar,
+        ReportPredicateScalar
+    ];
+    numeric?: "number" | "decimal";
+    valueType?: "number" | "decimal" | "text" | "date" | "boolean";
+}
+declare interface ReportComparison_2 {
+    field: string;
+    op: ">" | ">=" | "<" | "<=" | "==" | "!=" | "between" | "contains" | "isNull" | "isNotNull";
+    /** Legacy scalar thresholds remain supported. Use right for field-to-field comparisons. */
+    value?: ReportPredicateScalar_2;
+    right?: ReportPredicateOperand_2;
+    values?: readonly [
+        ReportPredicateScalar_2,
+        ReportPredicateScalar_2
+    ];
+    numeric?: "number" | "decimal";
+    valueType?: "number" | "decimal" | "text" | "date" | "boolean";
+}
+declare interface ReportComparison_3 {
+    field: string;
+    op: ">" | ">=" | "<" | "<=" | "==" | "!=" | "between" | "contains" | "isNull" | "isNotNull";
+    /** Legacy scalar thresholds remain supported. Use right for field-to-field comparisons. */
+    value?: ReportPredicateScalar_3;
+    right?: ReportPredicateOperand_3;
+    values?: readonly [
+        ReportPredicateScalar_3,
+        ReportPredicateScalar_3
+    ];
+    numeric?: "number" | "decimal";
+    valueType?: "number" | "decimal" | "text" | "date" | "boolean";
+}
+declare interface ReportDataComparison {
+    sourceScope?: string;
+    datasetId: string;
+    differences: readonly ReportDataDifference[];
+    counts: {
+        added: number;
+        removed: number;
+        changed: number;
+        unchanged: number;
+        cells: number;
+    };
+}
+declare interface ReportDataComparisonField {
+    field: string;
+    label?: string;
+    /** Numeric comparison is explicit; identifiers containing digits stay text. */
+    type?: "value" | "decimal";
+    /** Absolute decimal tolerance, inclusive. No binary floating-point subtraction. */
+    tolerance?: string;
+    /** Fractional ratio digits. changeRatio is (after - before) / before, not a percent. */
+    ratioDigits?: number;
+    zeroDenominator?: "omit" | "zero-if-equal";
+    missing?: "distinct" | "empty-equivalent" | "zero";
+}
+export declare const ReportDataComparisonPanel: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, MachReportVuePublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {}>;
+export declare interface ReportDataComparisonReviewOptions extends ReportDataReviewSource {
+    fields: readonly ReportDataComparisonField[];
+    maxDifferences?: number;
+}
+export declare interface ReportDataComparisonState extends ReportDataReviewState<ReportDataComparison> {
+    locate(item: ReportDataDifference): boolean;
+}
+declare interface ReportDataDifference {
+    rowKey: string | number;
+    kind: "added" | "removed" | "changed";
+    field: string;
+    label: string;
+    before: ReportCellValue | undefined;
+    after: ReportCellValue | undefined;
+    /** Exact base-ten difference. Undefined when either input is missing/non-numeric. */
+    delta?: string;
+    changeRatio?: string;
+    ratioUnavailable?: "zero-denominator" | "missing";
+}
+declare interface ReportDataLimits {
+    maxRows?: number;
+    maxFields?: number;
+    maxCells?: number;
+}
+/** A business record, never a physical report row index. */
+declare interface ReportDataRecord {
+    rowKey: string | number;
+    values: Readonly<Record<string, ReportCellValue>>;
+}
+export declare interface ReportDataReviewMessages {
+    prefillTitle: string;
+    prefillHint: string;
+    prefillCurrent: string;
+    prefillReference: string;
+    prefillLoad: string;
+    prefillApply: string;
+    prefillMatched: string;
+    prefillChanged: string;
+    prefillSkipped: string;
+    prefillConflict: string;
+    prefillUnchanged: string;
+    prefillReadonly: string;
+    prefillOccupied: string;
+    prefillMissingSource: string;
+    prefillMissingTarget: string;
+    prefillAmbiguous: string;
+    prefillInvalid: string;
+    comparisonTitle: string;
+    comparisonHint: string;
+    comparisonLoad: string;
+    comparisonAdded: string;
+    comparisonRemoved: string;
+    comparisonChanged: string;
+    comparisonUnchanged: string;
+    reviewCancel: string;
+    reviewClose: string;
+    reviewBefore: string;
+    reviewAfter: string;
+    reviewField: string;
+    reviewKey: string;
+    reviewDelta: string;
+    reviewRatio: string;
+    reviewLocate: string;
+    reviewEmpty: string;
+    reviewPrevious: string;
+    reviewNext: string;
+    reviewPage: string;
+}
+declare interface ReportDataReviewSource extends ReportDataLimits {
+    sourceScope?: string;
+    datasetId: string;
+    label?: string;
+    /** The host chooses history/instances; this package never guesses an endpoint or period. */
+    load(operation: {
+        signal: AbortSignal;
+    }): readonly ReportDataRecord[] | Promise<readonly ReportDataRecord[]>;
+    /** Cancel loaders that do not finish; default 15 seconds, bounded at 120 seconds. */
+    timeoutMs?: number;
+}
+declare interface ReportDataReviewState<Result> {
+    busy: Ref<boolean>;
+    result: ShallowRef<Result | null>;
+    error: Ref<string | null>;
+    run(): Promise<void>;
+    cancel(): void;
+    clear(): void;
+}
+declare interface ReportDatasetValidationOptions {
+    rules: readonly ReportValidationRule[];
+    rowKey?: string;
+    computed?: readonly ComputedField[];
+    /** Explicit trusted engine, shared with pagination; never read from a serialized template. */
+    formula?: FormulaAdapter;
+    /** Uses the same bounded tree preparation and descendant-leaf summaries as pagination. */
+    tree?: TreeTableOptions;
+    maxChecks?: number;
+    maxIssues?: number;
+    signal?: AbortSignal;
+}
 declare interface ReportDataTarget {
     datasetId: string;
     field: string;
@@ -2585,6 +3009,10 @@ export declare interface ReportEditingOptions {
     canEdit?(context: ReportCellContext): boolean;
     /** Return an error message or throw to reject the edit. */
     validate?(edit: Readonly<ReportCellEdit>, operation: ReportEditOperation): void | string | Promise<void | string>;
+    /** Same declarative rules can be run in Node via validateReportDataset. Requires a source-backed session. */
+    validation?: ReportCandidateValidationOptions;
+    /** Optional host batch validation sees the fully recalculated candidate plan. */
+    validateBatch?(batch: Readonly<ReportEditBatch>, candidate: RenderPlan, operation: ReportEditOperation): void | readonly ReportValidationIssue[] | Promise<void | readonly ReportValidationIssue[]>;
     /** Called before applying the change. A rejection leaves the current report untouched. */
     save?(edit: Readonly<ReportCellEdit>, operation: ReportEditOperation): void | ReportEditResult | Promise<void | ReportEditResult>;
     /** Must commit all edits in one server transaction. Required for multi-cell persisted edits. */
@@ -2645,11 +3073,13 @@ declare type ReportExpression = {
 } | {
     value: string | number | boolean | null;
 } | {
-    aggregate: AggregateOperation;
+    aggregate: AggregateOperation_2;
     field?: string;
     weightField?: string;
 } | {
-    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    op: ReportExpressionOperation;
+    /** Required for if; args are [then, else], and only the selected branch is evaluated. */
+    condition?: ReportPredicate;
     args: readonly ReportExpression[];
 };
 declare type ReportExpression_2 = {
@@ -2657,11 +3087,13 @@ declare type ReportExpression_2 = {
 } | {
     value: string | number | boolean | null;
 } | {
-    aggregate: AggregateOperation_2;
+    aggregate: AggregateOperation;
     field?: string;
     weightField?: string;
 } | {
-    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    op: ReportExpressionOperation_2;
+    /** Required for if; args are [then, else], and only the selected branch is evaluated. */
+    condition?: ReportPredicate_2;
     args: readonly ReportExpression_2[];
 };
 declare type ReportExpression_3 = {
@@ -2673,12 +3105,17 @@ declare type ReportExpression_3 = {
     field?: string;
     weightField?: string;
 } | {
-    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    op: ReportExpressionOperation_3;
+    /** Required for if; args are [then, else], and only the selected branch is evaluated. */
+    condition?: ReportPredicate_3;
     args: readonly ReportExpression_3[];
 };
+declare type ReportExpressionOperation = "add" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "round" | "abs" | "concat" | "trim" | "upper" | "lower" | "dateYear" | "dateMonth" | "dateDay";
+declare type ReportExpressionOperation_2 = "add" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "round" | "abs" | "concat" | "trim" | "upper" | "lower" | "dateYear" | "dateMonth" | "dateDay";
+declare type ReportExpressionOperation_3 = "add" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "round" | "abs" | "concat" | "trim" | "upper" | "lower" | "dateYear" | "dateMonth" | "dateDay";
 /** 保持 Promise<RenderPlan> 契约；元数据为可选，旧业务 fetcher 无需改造。 */
 declare interface ReportFetcher {
-    (input: ReportFetchInput): Promise<RenderPlan>;
+    (input: ReportFetchInput): Promise<RenderPlan_2>;
     getParamDefs?: (reportIds: string[]) => ReportParamDef[];
 }
 declare interface ReportFetchInput extends ReportTaskMonitoring {
@@ -2789,12 +3226,9 @@ declare interface ReportParamDef {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select" | "multiSelect" | "cascader" | "numberRange";
     /** select 选项 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    options?: ReportParamTreeOption[];
     /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
     optionsSource?: string;
     /** Select dependencies must be declared parameters; changing a parent clears descendants. */
@@ -2807,6 +3241,9 @@ declare interface ReportParamDef {
     max?: number | string;
     minLength?: number;
     maxLength?: number;
+    /** multiSelect item count (maximum 100). Cascader paths are bounded to 16 levels. */
+    minItems?: number;
+    maxItems?: number;
 }
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef_2 {
@@ -2814,12 +3251,9 @@ declare interface ReportParamDef_2 {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select" | "multiSelect" | "cascader" | "numberRange";
     /** select 选项 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    options?: ReportParamTreeOption_2[];
     /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
     optionsSource?: string;
     /** Select dependencies must be declared parameters; changing a parent clears descendants. */
@@ -2832,6 +3266,9 @@ declare interface ReportParamDef_2 {
     max?: number | string;
     minLength?: number;
     maxLength?: number;
+    /** multiSelect item count (maximum 100). Cascader paths are bounded to 16 levels. */
+    minItems?: number;
+    maxItems?: number;
 }
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
 declare interface ReportParamDef_3 {
@@ -2839,12 +3276,9 @@ declare interface ReportParamDef_3 {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select" | "multiSelect" | "cascader" | "numberRange";
     /** select 选项 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    options?: ReportParamTreeOption_3[];
     /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
     optionsSource?: string;
     /** Select dependencies must be declared parameters; changing a parent clears descendants. */
@@ -2857,6 +3291,9 @@ declare interface ReportParamDef_3 {
     max?: number | string;
     minLength?: number;
     maxLength?: number;
+    /** multiSelect item count (maximum 100). Cascader paths are bounded to 16 levels. */
+    minItems?: number;
+    maxItems?: number;
 }
 declare interface ReportParamIssue {
     code: ReportParamIssueCode;
@@ -2864,10 +3301,11 @@ declare interface ReportParamIssue {
     field: string;
     message: string;
 }
-declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength";
+declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength" | "minItems" | "maxItems";
 export declare interface ReportParamOption {
     readonly label: string;
     readonly value: string;
+    readonly children?: readonly ReportParamOption[];
 }
 export declare interface ReportParamOptionsInput {
     readonly source: string;
@@ -2887,6 +3325,8 @@ export declare interface ReportParamOptionsMessages {
     paramOptionsMissingLoader?: string;
     paramOptionsDependencies?: string;
     paramOptionsClear?: string;
+    paramNumberRangeStart?: string;
+    paramNumberRangeEnd?: string;
 }
 export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     focusInvalid: typeof focusInvalid;
@@ -2905,6 +3345,24 @@ export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     showActions: boolean;
     showTitle: boolean;
 }>;
+/** Cascader values are unique within each sibling list. */
+declare interface ReportParamTreeOption {
+    label: string;
+    value: string;
+    children?: ReportParamTreeOption[];
+}
+/** Cascader values are unique within each sibling list. */
+declare interface ReportParamTreeOption_2 {
+    label: string;
+    value: string;
+    children?: ReportParamTreeOption_2[];
+}
+/** Cascader values are unique within each sibling list. */
+declare interface ReportParamTreeOption_3 {
+    label: string;
+    value: string;
+    children?: ReportParamTreeOption_3[];
+}
 /** Licensed local font bytes; never downloaded implicitly by the runtime. */
 declare interface ReportPdfFontOptions {
     customFontBytes?: Uint8Array | ArrayBuffer;
@@ -2916,6 +3374,45 @@ declare interface ReportPdfFontOptions {
         boldItalic?: Uint8Array | ArrayBuffer;
     };
 }
+declare type ReportPredicate = ReportComparison | {
+    all: readonly ReportPredicate[];
+} | {
+    any: readonly ReportPredicate[];
+} | {
+    not: ReportPredicate;
+};
+declare type ReportPredicate_2 = ReportComparison_2 | {
+    all: readonly ReportPredicate_2[];
+} | {
+    any: readonly ReportPredicate_2[];
+} | {
+    not: ReportPredicate_2;
+};
+declare type ReportPredicate_3 = ReportComparison_3 | {
+    all: readonly ReportPredicate_3[];
+} | {
+    any: readonly ReportPredicate_3[];
+} | {
+    not: ReportPredicate_3;
+};
+declare type ReportPredicateOperand = {
+    field: string;
+} | {
+    value: ReportPredicateScalar;
+};
+declare type ReportPredicateOperand_2 = {
+    field: string;
+} | {
+    value: ReportPredicateScalar_2;
+};
+declare type ReportPredicateOperand_3 = {
+    field: string;
+} | {
+    value: ReportPredicateScalar_3;
+};
+declare type ReportPredicateScalar = string | number | boolean | null;
+declare type ReportPredicateScalar_2 = string | number | boolean | null;
+declare type ReportPredicateScalar_3 = string | number | boolean | null;
 export declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -2926,6 +3423,41 @@ export declare interface ReportPreferencesOptions {
     key: string;
     adapter: ReportPreferencesAdapter;
 }
+declare interface ReportPrefillField {
+    field: string;
+    sourceField?: string;
+    label?: string;
+}
+declare interface ReportPrefillItem {
+    source: Readonly<ReportCellSource>;
+    label: string;
+    status: ReportPrefillStatus;
+    reason?: ReportPrefillReason;
+    before?: ReportCellValue;
+    after?: ReportCellValue;
+}
+export declare const ReportPrefillPanel: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, MachReportVuePublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {}>;
+declare interface ReportPrefillPreview {
+    sourceScope?: string;
+    datasetId: string;
+    items: readonly ReportPrefillItem[];
+    counts: Readonly<Record<ReportPrefillStatus, number>>;
+    /** Optimistic source tokens and previous values are retained for an atomic edit. */
+    edits: readonly ReportCellEdit[];
+}
+declare type ReportPrefillReason = "unchanged" | "readonly" | "occupied" | "missing-source" | "missing-target" | "ambiguous" | "invalid";
+export declare interface ReportPrefillReviewOptions extends ReportDataReviewSource {
+    fields: readonly ReportPrefillField[];
+    mode?: "empty" | "replace";
+    maxChanges?: number;
+}
+export declare interface ReportPrefillState extends ReportDataReviewState<ReportPrefillPreview> {
+    applying: Ref<boolean>;
+    blockedReason: ComputedRef<string | undefined>;
+    canApply: ComputedRef<boolean>;
+    apply(): Promise<boolean>;
+}
+declare type ReportPrefillStatus = "matched" | "changed" | "skipped" | "conflict";
 export declare const ReportPreview: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export declare interface ReportPreviewDataTarget extends ReportDataTarget_2 {
     /** Added by the query adapter; isolates identical dataset/row/field identities across reports. */
@@ -3018,6 +3550,8 @@ declare interface ReportRuntimeBudget {
     maxRows?: number;
     maxPages?: number;
     maxCells?: number;
+    /** Aggregate bound-chart primitives per prepare, before expansion; default 50000, hard maximum 1000000. */
+    maxChartComponents?: number;
     maxOutputBytes?: number;
     /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
     maxPreparedBytes?: number;
@@ -3132,6 +3666,34 @@ declare interface ReportTemplateRepeat_3 {
 }
 declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 export declare const ReportToolbar: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
+declare interface ReportValidationIssue {
+    ruleId: string;
+    rowKey?: string | number;
+    rowIndex?: number;
+    field?: string;
+    dataset?: string;
+    sourceScope?: string;
+    severity: "error" | "warning";
+    message: string;
+}
+export declare const ReportValidationPanel: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    locate: (issue: ReportValidationIssue) => any;
+}, string, MachReportVuePublicProps, Readonly<__VLS_Props_4> & Readonly<{
+    onLocate?: ((issue: ReportValidationIssue) => any) | undefined;
+}>, {}>;
+declare interface ReportValidationRule {
+    id: string;
+    /** Optional target; omitted applies to each candidate dataset. */
+    dataset?: string;
+    assert: ReportPredicate;
+    when?: ReportPredicate;
+    field?: string;
+    severity?: "error" | "warning";
+    message: string;
+    scope?: "row" | "dataset";
+    /** Dataset-scope assertions read this explicit summary row, never an arbitrary detail row. */
+    aggregates?: readonly AggregateDefinition[];
+}
 /** Optional business explanations never replace raw data or schema validation. */
 declare type ReportValueState = "missing-source" | "not-applicable" | "not-calculable";
 /** Optional business explanations never replace raw data or schema validation. */
@@ -3139,10 +3701,14 @@ declare type ReportValueState_2 = "missing-source" | "not-applicable" | "not-cal
 /** 新消息保持可选，旧的完整文案对象也能获得新增能力的默认文案。 */
 export declare function resolveCalculationMessages(messages: Partial<ReportCalculationMessages>): ReportCalculationMessages;
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
+/** Optional message additions preserve complete message objects supplied by older consumers. */
+export declare function resolveDataReviewMessages(messages: Partial<ReportDataReviewMessages>): ReportDataReviewMessages;
 export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showSettings" | "showParams" | "gapPx">> & {
     exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
+    prefill?: ReportPrefillReviewOptions | false;
+    dataComparison?: ReportDataComparisonReviewOptions | false;
     pdfFontUrl: string;
     theme: MachReportTheme;
     messages: MachReportMessages;
@@ -3206,37 +3772,19 @@ export declare const SILENT_LOGGER: MachReportLogger;
 export declare function snapshotPrintOptions(options?: ReportPrintOptions): ReportPrintOptions;
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule {
-    when: {
-        field: string;
-        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
-        value: number | string;
-        /** Explicit decimal comparisons retain decimal thresholds as text. */
-        numeric?: "number" | "decimal";
-    };
+    when: ReportPredicate;
     /** 命中时合并进单元格样式（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";
-    };
+    when: ReportPredicate_2;
     /** 命中时合并进单元格样式（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";
-    };
+    when: ReportPredicate_3;
     /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
     style: Record<string, unknown>;
 }
@@ -3372,7 +3920,7 @@ export declare function useMachReport(): MachReportHandle;
 /** 组件内部读取当前生效配置层（未提供时返回 null → 走内置缺省） */
 export declare function useMachReportConfig(): ConfigRef;
 /** 页级虚拟化；页几何按计划引用缓存，滚动仅更新坐标，不遍历整个计划。 */
-export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<number>, options?: {
+export declare function usePageWindow(plan: Ref<RenderPlan_2 | null>, zoom: Ref<number>, options?: {
     pxPerMm?: number;
     gapPx?: number | Ref<number>;
     overscan?: number | Ref<number>;
@@ -3383,7 +3931,7 @@ export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<nu
     }>;
     windowRange: ComputedRef<PageWindow>;
     visiblePages: ComputedRef<{
-        page: PlanPage;
+        page: PlanPage_2;
         index: number;
     }[]>;
     makeScrollHandler: (currentPage: Ref<number>, pageCount: Ref<number>) => (vp: HTMLElement) => void;
@@ -3392,7 +3940,7 @@ export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<nu
     pageOffsetPx: (index: number) => number;
     destroy: () => void;
 };
-export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
+export declare function usePrintExport(plan: Ref<RenderPlan_2 | null>, hooks: {
     /** 按导出开始时的配置快照处理，避免输出过程中跟随路由配置变化。 */
     getXlsxOptions?: () => XlsxRenderOptions;
     getPrintOptions?: () => ReportPrintOptions;
@@ -3404,6 +3952,8 @@ export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     encoding?: PreviewEncoding;
     onError: (message: string, code?: string) => void;
     onWarning?: (message: string) => void;
+    /** Informational output semantics, separate from fidelity failures. */
+    onNote?: (message: string) => void;
     onBusy?: (format: string | null) => void;
     onPrinting?: (printing: boolean) => void;
     onTask?: (task: Readonly<ReportPreviewTask>) => void;
@@ -3469,6 +4019,8 @@ declare interface XlsxRenderOptions extends AssetRenderOptions_2, XlsxImageOptio
     sheetMode?: "auto" | "pages" | "continuous";
     /** 宽表或连续表默认 raw，其余默认 text；显式配置可覆盖默认值。 */
     valueMode?: "text" | "raw";
+    /** Static data-bar drawing budget; fail explicitly rather than omitting bars. Default 10,000. */
+    maxDataBars?: number;
     /** 连续表默认不限制打印纸型；显式 A3/A4/A5 仅设置打印适配，不改变 Excel 列宽。 */
     paperSize?: "auto" | "a3" | "a4" | "a5";
 }