@agile-team/mach-report 2.14.0 → 2.15.0

package/dist/vue/async.d.ts

@@ -29,7 +29,7 @@ declare interface AssetRenderBudget {
     /** Wall-clock budget, including adapters that ignore AbortSignal. Default 30 seconds. */
     maxDurationMs?: number;
 }
-declare interface AssetRenderOptions extends OutputDiagnosticOptions {
+declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
@@ -432,6 +432,30 @@ declare interface GridCell_3 {
     style?: ComponentStyle_3;
 }
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions_2 {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
@@ -681,6 +705,8 @@ declare interface MachReportConfig {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
+    drill?: ReportDrillOptions;
+    loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
     showExport?: boolean;
     showPrint?: boolean;
@@ -728,7 +754,11 @@ declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages {
+declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages, ReportParamOptionsMessages {
+    drillActions?: string;
+    drillOpening?: string;
+    drillMissingValue?: string;
+    drillFailed?: string;
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1013,7 +1043,7 @@ declare interface MatrixTableOptions_2 {
     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";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "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";
     format: OutputFormat;
     pageIndex: number;
@@ -1025,7 +1055,7 @@ declare interface OutputDiagnostic {
     message: string;
 }
 declare interface OutputDiagnostic_2 {
-    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";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "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";
     format: OutputFormat_2;
     pageIndex: number;
@@ -1399,6 +1429,8 @@ declare interface ReportCellSelection {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -1407,6 +1439,8 @@ declare interface ReportCellSource {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource_2 {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -1415,6 +1449,8 @@ declare interface ReportCellSource_2 {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource_3 {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -1444,6 +1480,8 @@ declare interface ReportDataTarget {
     rowKey?: string | number;
     /** Use table identity when the same dataset appears in several tables. */
     tableId?: string;
+    /** Assigned by the source/runtime when several reports share dataset names. */
+    reportScope?: string;
 }
 declare interface ReportDataTarget_2 {
     datasetId: string;
@@ -1451,8 +1489,12 @@ declare interface ReportDataTarget_2 {
     rowKey?: string | number;
     /** Use table identity when the same dataset appears in several tables. */
     tableId?: string;
+    /** Assigned by the source/runtime when several reports share dataset names. */
+    reportScope?: string;
 }
 declare interface ReportDefinition {
+    /** Explicitly shared editable data identity. Omit to isolate each report occurrence. */
+    sourceScope?: string;
     /** 静态模板或宿主提供的异步模板加载器；动态模板默认每次重新读取，不缓存版本。 */
     template: ReportTemplate | ReportTemplateLoader;
     /** 静态数据；load 存在时优先使用 load 的结果。 */
@@ -1477,6 +1519,49 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 declare type ReportDiscardReason = "reload" | "import" | "replace" | "leave";
+/** Serializable action metadata. URLs, scripts and automatic navigation are deliberately absent. */
+declare interface ReportDrillAction {
+    id: string;
+    label: string;
+    target: {
+        field: string;
+        datasetId?: string;
+        reportScope?: string;
+        roles?: readonly string[];
+    };
+    params?: Readonly<Record<string, ReportDrillBinding>>;
+}
+declare type ReportDrillBinding = {
+    value: string | number | boolean;
+} | {
+    from: "value" | "rowKey";
+} | {
+    from: "query" | "field";
+    field: string;
+};
+/** Trusted host-owned allowlist. Matching serialized metadata alone never executes an action. */
+declare interface ReportDrillOptions {
+    actions: readonly ReportDrillAction[];
+    open(request: ReportDrillRequest & {
+        signal: AbortSignal;
+        view: Readonly<{
+            zoom: number;
+            scrollTop: number;
+            scrollLeft: number;
+        }>;
+    }): void | Promise<void>;
+}
+declare interface ReportDrillRequest {
+    actionId: string;
+    params: Readonly<Record<string, string>>;
+    returnState: Readonly<ReportDrillReturnState>;
+}
+declare interface ReportDrillReturnState {
+    params: Readonly<Record<string, string>>;
+    address: Readonly<ReportCellAddress_2>;
+    reportScope?: string;
+    source?: Readonly<Pick<ReportCellSource_2, "sourceScope" | "datasetId" | "rowKey" | "field">>;
+}
 declare interface ReportEditBatch {
     /** Idempotency identity; the server should bind it to the exact payload. */
     requestId: string;
@@ -1634,6 +1719,10 @@ declare interface ReportParamDef {
         label: string;
         value: string;
     }>;
+    /** 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. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -1655,6 +1744,10 @@ declare interface ReportParamDef_2 {
         label: string;
         value: string;
     }>;
+    /** 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. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -1670,7 +1763,30 @@ declare interface ReportParamIssue {
     field: string;
     message: string;
 }
-declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "minimum" | "maximum" | "minLength" | "maxLength";
+declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength";
+declare interface ReportParamOption {
+    readonly label: string;
+    readonly value: string;
+}
+declare interface ReportParamOptionsInput {
+    readonly source: string;
+    readonly field: string;
+    readonly query: string;
+    /** Only declared dependencies, captured at request start. Never the mutable form. */
+    readonly params: Readonly<Record<string, string>>;
+    readonly signal: AbortSignal;
+    readonly limit: number;
+}
+/** Resolve a trusted source key through the host's existing API/authentication. */
+declare type ReportParamOptionsLoader = (input: ReportParamOptionsInput) => Promise<readonly ReportParamOption[]>;
+declare interface ReportParamOptionsMessages {
+    paramOptionsLoading?: string;
+    paramOptionsEmpty?: string;
+    paramOptionsFailed?: string;
+    paramOptionsMissingLoader?: string;
+    paramOptionsDependencies?: string;
+    paramOptionsClear?: string;
+}
 declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -2011,21 +2127,14 @@ declare type ValueFormat = ColumnFormat;
 declare type ValueFormat_2 = ColumnFormat_2;
 /** The same declarative formatting used by list columns, before any output backend. */
 declare type ValueFormat_3 = ColumnFormat_3;
-declare interface XlsxImageOptions {
-    /** Decoded bytes per unique embedded image; default 16 MiB. */
-    maxImageBytes?: number;
-    /** Total decoded bytes of unique images in this workbook; default 32 MiB. */
-    maxTotalImageBytes?: number;
-    /** Unique embedded media limit, default 1000; repeated placements reuse the same media. */
-    maxImages?: number;
-}
+declare type XlsxImageOptions = ImageMediaOptions_2;
 /**
  * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
  * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
  *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
  * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
  *   目标是"财务能直接用的对账表"而非复刻版面）
- * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
 declare interface XlsxRenderOptions extends OutputDiagnosticOptions_2, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */

package/dist/vue/index.d.cts

@@ -9,6 +9,14 @@ import { InjectionKey } from 'vue';
 import { PropType } from 'vue';
 import { Ref } from 'vue';
 declare const __VLS_component: DefineComponent<ExtractPropTypes<{
+    drill: {
+        type: PropType<ReportDrillOptions>;
+        default: undefined;
+    };
+    loadParamOptions: {
+        type: PropType<ReportParamOptionsLoader>;
+        default: undefined;
+    };
     reportId: {
         type: PropType<string | string[] | null>;
         default: null;
@@ -171,6 +179,14 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     "template-import": (result: ExcelImportResult) => any;
     "preferences-change": (preferences: Readonly<ReportPreviewPreferences>) => any;
 }, string, MachReportVuePublicProps, Readonly<ExtractPropTypes<{
+    drill: {
+        type: PropType<ReportDrillOptions>;
+        default: undefined;
+    };
+    loadParamOptions: {
+        type: PropType<ReportParamOptionsLoader>;
+        default: undefined;
+    };
     reportId: {
         type: PropType<string | string[] | null>;
         default: null;
@@ -309,6 +325,8 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     showPdfWindow: boolean;
     showSettings: boolean;
     showParams: boolean;
+    drill: ReportDrillOptions;
+    loadParamOptions: ReportParamOptionsLoader;
     printOptions: ReportPrintOptions;
     toolbar: MachReportToolbarOptions;
     interaction: ReportInteractionOptions;
@@ -400,6 +418,7 @@ declare type __VLS_Props_3 = {
     showActions?: boolean;
     showTitle?: boolean;
     disabled?: boolean;
+    loadOptions?: ReportParamOptionsLoader;
 };
 declare function __VLS_template(): {
     slots: {
@@ -470,7 +489,7 @@ declare interface AssetRenderBudget {
     /** Wall-clock budget, including adapters that ignore AbortSignal. Default 30 seconds. */
     maxDurationMs?: number;
 }
-declare interface AssetRenderOptions extends OutputDiagnosticOptions {
+declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
@@ -900,7 +919,7 @@ declare interface GridCell {
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
-    source?: ReportCellSource;
+    source?: ReportCellSource_2;
     /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
     derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
@@ -923,7 +942,7 @@ declare interface GridCell_2 {
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
-    source?: ReportCellSource_2;
+    source?: ReportCellSource;
     /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
     derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
@@ -965,6 +984,30 @@ export declare type HostRequest = (config: {
     signal?: AbortSignal;
 }) => Promise<unknown>;
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+declare interface ImageMediaOptions_2 {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
 export declare function joinReportIds(reportId: ReportIdInput): string;
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle_2["align"]> | "auto";
@@ -1379,6 +1422,8 @@ export declare interface MachReportController {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 export declare interface MachReportDefaults {
+    drill?: ReportDrillOptions;
+    loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
     showExport?: boolean;
     showPrint?: boolean;
@@ -1462,7 +1507,11 @@ export declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-export declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages {
+export declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages, ReportParamOptionsMessages {
+    drillActions?: string;
+    drillOpening?: string;
+    drillMissingValue?: string;
+    drillFailed?: string;
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1778,7 +1827,7 @@ export declare function normalizeReportIds(reportId: ReportIdInput): string[];
 /** Workers preserve stable error codes, not JavaScript class identity. Only known codes cross the UI boundary. */
 export declare function normalizeReportLoadError(error: unknown): MachReportError;
 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";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "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";
     format: OutputFormat;
     pageIndex: number;
@@ -1790,7 +1839,7 @@ declare interface OutputDiagnostic {
     message: string;
 }
 declare interface OutputDiagnostic_2 {
-    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";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "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";
     format: OutputFormat_2;
     pageIndex: number;
@@ -1852,6 +1901,7 @@ declare interface PaginateOptions {
     /** Trusted formula adapter is passed at execution time; it is never serialized in templates. */
     formula?: FormulaAdapter;
 }
+export declare const PARAM_OPTIONS_MESSAGES: Required<ReportParamOptionsMessages>;
 /** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
 export declare interface PdfExporter {
     (plan: RenderPlan, onWarning?: (message: string) => void, task?: OutputTaskOptions_2 & {
@@ -2022,7 +2072,7 @@ declare interface PlanTableFragment {
     layout?: "page" | "wide";
     title?: string;
     /** 只有宿主声明稳定 rowKey 时生成，不能用显示顺序替代业务主键。 */
-    source?: Omit<ReportCellSource, "field" | "rowKey"> & {
+    source?: Omit<ReportCellSource_2, "field" | "rowKey"> & {
         rowKey?: string | number;
     };
 }
@@ -2038,7 +2088,7 @@ declare interface PlanTableFragment_2 {
     layout?: "page" | "wide";
     title?: string;
     /** 只有宿主声明稳定 rowKey 时生成，不能用显示顺序替代业务主键。 */
-    source?: Omit<ReportCellSource_2, "field" | "rowKey"> & {
+    source?: Omit<ReportCellSource, "field" | "rowKey"> & {
         rowKey?: string | number;
     };
 }
@@ -2179,14 +2229,14 @@ declare interface ReportCellContext {
     valueType: ReportCellValueType;
     table?: ReportCellTableIdentity;
     /** Stable business identity. Physical row indices must never be used as database keys. */
-    source?: Readonly<ReportCellSource_2>;
+    source?: Readonly<ReportCellSource>;
     editable: boolean;
     readOnlyReason?: ReportCellReadOnlyReason;
 }
 declare interface ReportCellEdit {
     address: ReportCellAddress;
     table?: ReportCellTableIdentity;
-    source?: Readonly<ReportCellSource_2>;
+    source?: Readonly<ReportCellSource>;
     previousValue: ReportCellValue;
     previousText: string;
     value: ReportCellValue;
@@ -2195,7 +2245,7 @@ declare interface ReportCellEdit {
 declare interface ReportCellEdit_2 {
     address: ReportCellAddress_2;
     table?: ReportCellTableIdentity_2;
-    source?: Readonly<ReportCellSource>;
+    source?: Readonly<ReportCellSource_2>;
     previousValue: ReportCellValue_2;
     previousText: string;
     value: ReportCellValue_2;
@@ -2235,6 +2285,8 @@ export declare interface ReportCellSelection {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -2243,6 +2295,8 @@ declare interface ReportCellSource {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource_2 {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -2251,6 +2305,8 @@ declare interface ReportCellSource_2 {
 }
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource_3 {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -2280,6 +2336,8 @@ declare interface ReportDataTarget {
     rowKey?: string | number;
     /** Use table identity when the same dataset appears in several tables. */
     tableId?: string;
+    /** Assigned by the source/runtime when several reports share dataset names. */
+    reportScope?: string;
 }
 declare interface ReportDataTarget_2 {
     datasetId: string;
@@ -2287,8 +2345,12 @@ declare interface ReportDataTarget_2 {
     rowKey?: string | number;
     /** Use table identity when the same dataset appears in several tables. */
     tableId?: string;
+    /** Assigned by the source/runtime when several reports share dataset names. */
+    reportScope?: string;
 }
 declare interface ReportDefinition {
+    /** Explicitly shared editable data identity. Omit to isolate each report occurrence. */
+    sourceScope?: string;
     /** 静态模板或宿主提供的异步模板加载器；动态模板默认每次重新读取，不缓存版本。 */
     template: ReportTemplate_2 | ReportTemplateLoader;
     /** 静态数据；load 存在时优先使用 load 的结果。 */
@@ -2313,13 +2375,56 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 export declare type ReportDiscardReason = "reload" | "import" | "replace" | "leave";
+/** Serializable action metadata. URLs, scripts and automatic navigation are deliberately absent. */
+declare interface ReportDrillAction {
+    id: string;
+    label: string;
+    target: {
+        field: string;
+        datasetId?: string;
+        reportScope?: string;
+        roles?: readonly string[];
+    };
+    params?: Readonly<Record<string, ReportDrillBinding>>;
+}
+declare type ReportDrillBinding = {
+    value: string | number | boolean;
+} | {
+    from: "value" | "rowKey";
+} | {
+    from: "query" | "field";
+    field: string;
+};
+/** Trusted host-owned allowlist. Matching serialized metadata alone never executes an action. */
+export declare interface ReportDrillOptions {
+    actions: readonly ReportDrillAction[];
+    open(request: ReportDrillRequest & {
+        signal: AbortSignal;
+        view: Readonly<{
+            zoom: number;
+            scrollTop: number;
+            scrollLeft: number;
+        }>;
+    }): void | Promise<void>;
+}
+declare interface ReportDrillRequest {
+    actionId: string;
+    params: Readonly<Record<string, string>>;
+    returnState: Readonly<ReportDrillReturnState>;
+}
+declare interface ReportDrillReturnState {
+    params: Readonly<Record<string, string>>;
+    address: Readonly<ReportCellAddress>;
+    reportScope?: string;
+    source?: Readonly<Pick<ReportCellSource, "sourceScope" | "datasetId" | "rowKey" | "field">>;
+}
 declare interface ReportEditBatch {
     /** Idempotency identity; the server should bind it to the exact payload. */
     requestId: string;
     edits: ReportCellEdit[];
 }
 declare interface ReportEditConflict {
-    source?: Readonly<ReportCellSource_2>;
+    source?: Readonly<ReportCellSource>;
     address?: ReportCellAddress;
     message: string;
     currentValue?: ReportCellValue;
@@ -2498,6 +2603,10 @@ declare interface ReportParamDef {
         label: string;
         value: string;
     }>;
+    /** 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. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -2519,6 +2628,10 @@ declare interface ReportParamDef_2 {
         label: string;
         value: string;
     }>;
+    /** 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. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -2540,6 +2653,10 @@ declare interface ReportParamDef_3 {
         label: string;
         value: string;
     }>;
+    /** 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. */
+    dependsOn?: string[];
     defaultValue?: string;
     required?: boolean;
     placeholder?: string;
@@ -2555,7 +2672,30 @@ declare interface ReportParamIssue {
     field: string;
     message: string;
 }
-declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "minimum" | "maximum" | "minLength" | "maxLength";
+declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength";
+export declare interface ReportParamOption {
+    readonly label: string;
+    readonly value: string;
+}
+export declare interface ReportParamOptionsInput {
+    readonly source: string;
+    readonly field: string;
+    readonly query: string;
+    /** Only declared dependencies, captured at request start. Never the mutable form. */
+    readonly params: Readonly<Record<string, string>>;
+    readonly signal: AbortSignal;
+    readonly limit: number;
+}
+/** Resolve a trusted source key through the host's existing API/authentication. */
+export declare type ReportParamOptionsLoader = (input: ReportParamOptionsInput) => Promise<readonly ReportParamOption[]>;
+export declare interface ReportParamOptionsMessages {
+    paramOptionsLoading?: string;
+    paramOptionsEmpty?: string;
+    paramOptionsFailed?: string;
+    paramOptionsMissingLoader?: string;
+    paramOptionsDependencies?: string;
+    paramOptionsClear?: string;
+}
 export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     focusInvalid: typeof focusInvalid;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
@@ -2568,6 +2708,7 @@ export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     "onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
 }>, {
     disabled: boolean;
+    loadOptions: ReportParamOptionsLoader;
     issues: readonly ReportParamIssue[];
     showActions: boolean;
     showTitle: boolean;
@@ -2787,6 +2928,8 @@ declare type ReportValueState_2 = "missing-source" | "not-applicable" | "not-cal
 export declare function resolveCalculationMessages(messages: Partial<ReportCalculationMessages>): ReportCalculationMessages;
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
 export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showSettings" | "showParams" | "gapPx">> & {
+    drill?: ReportDrillOptions;
+    loadParamOptions?: ReportParamOptionsLoader;
     pdfFontUrl: string;
     theme: MachReportTheme;
     messages: MachReportMessages;
@@ -3095,21 +3238,14 @@ declare type ValueFormat = ColumnFormat;
 declare type ValueFormat_2 = ColumnFormat_2;
 /** The same declarative formatting used by list columns, before any output backend. */
 declare type ValueFormat_3 = ColumnFormat_3;
-declare interface XlsxImageOptions {
-    /** Decoded bytes per unique embedded image; default 16 MiB. */
-    maxImageBytes?: number;
-    /** Total decoded bytes of unique images in this workbook; default 32 MiB. */
-    maxTotalImageBytes?: number;
-    /** Unique embedded media limit, default 1000; repeated placements reuse the same media. */
-    maxImages?: number;
-}
+declare type XlsxImageOptions = ImageMediaOptions_2;
 /**
  * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
  * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
  *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
  * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
  *   目标是"财务能直接用的对账表"而非复刻版面）
- * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
 declare interface XlsxRenderOptions extends OutputDiagnosticOptions_2, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */