@agile-team/mach-report 2.13.0 → 2.15.0

package/dist/designer.d.cts

@@ -43,7 +43,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. */
@@ -85,6 +85,12 @@ declare const BASE_TEMPLATE_EDITOR_MESSAGES: {
     note: string;
     invalid: string;
 };
+declare interface CanvasSelection {
+    /** Ctrl/Command/Shift toggles the selection without changing the report schema. */
+    additive?: boolean;
+    pageIndex: number;
+    componentIndex: number;
+}
 /** Serializable symbol settings. Encoders remain in the optional /codes entry. */
 declare interface CodeOptions {
     /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
@@ -315,6 +321,8 @@ declare interface ComputedField_3 extends ExpressionOptions_3 {
     /** String adapter expressions cannot be inspected; declare dependencies explicitly. */
     dependsOn?: readonly string[];
 }
+/** No global storage access: hosts explicitly choose localStorage, sessionStorage or their own adapter. */
+export declare function createTemplateDraftStorage(storage: Pick<Storage, "getItem" | "setItem" | "removeItem">): TemplateDraftStorageAdapter;
 declare interface DatasetContract {
     fields: readonly ReportFieldContract[];
     rowKey?: string;
@@ -327,6 +335,8 @@ declare type DatasetRows = Record<string, Record<string, unknown>[]>;
 declare type DatasetRows_2 = Record<string, Record<string, unknown>[]>;
 /** Optional wizard labels remain independent of the general designer configuration. */
 export declare const EXCEL_BINDING_MESSAGES: {
+    recoveredMapping: string;
+    recoveredSheetMissing: string;
     tableMode: string;
     multiRegions: string;
     multiHint: string;
@@ -490,11 +500,11 @@ export declare const ExcelBindingWizard: DefineComponent<ExcelBindingWizardOptio
     apply: () => Promise<void>;
     cancel: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
-    dirty: (value: boolean) => any;
     apply: (result: ExcelBindingWizardApply) => any;
+    dirty: (value: boolean) => any;
 }, string, MachReportVuePublicProps, Readonly<ExcelBindingWizardOptions> & Readonly<{
-    onDirty?: ((value: boolean) => any) | undefined;
     onApply?: ((result: ExcelBindingWizardApply) => any) | undefined;
+    onDirty?: ((value: boolean) => any) | undefined;
 }>, {}>;
 export declare type ExcelBindingWizardApply = AnyExcelBindingDocumentResult & {
     session: AnyExcelBindingSession;
@@ -714,6 +724,18 @@ 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;
+}
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
 declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
 /** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
@@ -1070,6 +1092,9 @@ declare interface ListGroupBy_3 {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
+    drill?: ReportDrillOptions;
+    loadParamOptions?: ReportParamOptionsLoader;
+    printOptions?: ReportPrintOptions;
     showExport?: boolean;
     showPrint?: boolean;
     showPdfWindow?: boolean;
@@ -1111,7 +1136,11 @@ declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-declare interface MachReportMessages extends Partial<ReportCalculationMessages> {
+declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages, ReportParamOptionsMessages {
+    drillActions?: string;
+    drillOpening?: string;
+    drillMissingValue?: string;
+    drillFailed?: string;
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1122,6 +1151,13 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>
     pageJumpHint?: string;
     pagination?: string;
     recordNavigation?: string;
+    dataExplanation?: string;
+    dataExplanationHint?: string;
+    dataExplanationSearch?: string;
+    dataExplanationEmpty?: string;
+    dataMissingSource?: string;
+    dataNotApplicable?: string;
+    dataNotCalculable?: string;
     recordInfo?: string;
     prevRecord?: string;
     nextRecord?: string;
@@ -1279,7 +1315,11 @@ declare interface MachReportMessages extends Partial<ReportCalculationMessages>
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-declare interface MachReportMessages_2 extends Partial<ReportCalculationMessages_2> {
+declare interface MachReportMessages_2 extends Partial<ReportCalculationMessages_2>, ReportPrintMessages_2, ReportParamOptionsMessages_2 {
+    drillActions?: string;
+    drillOpening?: string;
+    drillMissingValue?: string;
+    drillFailed?: string;
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1290,6 +1330,13 @@ declare interface MachReportMessages_2 extends Partial<ReportCalculationMessages
     pageJumpHint?: string;
     pagination?: string;
     recordNavigation?: string;
+    dataExplanation?: string;
+    dataExplanationHint?: string;
+    dataExplanationSearch?: string;
+    dataExplanationEmpty?: string;
+    dataMissingSource?: string;
+    dataNotApplicable?: string;
+    dataNotCalculable?: string;
     recordInfo?: string;
     prevRecord?: string;
     nextRecord?: string;
@@ -1519,7 +1566,7 @@ declare interface MatrixTableOptions_3 {
     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;
@@ -1531,7 +1578,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;
@@ -1579,6 +1626,13 @@ export declare const PARAM_EDITOR_MESSAGES: {
     paramMinLength: string;
     paramMaxLength: string;
     paramOptions: string;
+    paramOptionsMode: string;
+    paramOptionsStatic: string;
+    paramOptionsRemote: string;
+    paramOptionsSource: string;
+    paramDependencyUnavailable: string;
+    paramDependencies: string;
+    paramRemoteHint: string;
     paramOptionValue: string;
     paramOptionLabel: string;
     paramOptionAdd: string;
@@ -1791,6 +1845,13 @@ declare interface PlanTableFragment_3 {
     };
 }
 declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
+    toolTarget: string;
+    toolPreview: string;
+    toolPreviewHide: string;
+    toolChooseComponent: string;
+    previousColumns: string;
+    nextColumns: string;
+    columnWindow: string;
     paperAndPages: string;
     pageDirectory: string;
     pageName: string;
@@ -2169,6 +2230,8 @@ declare type ReportCellFieldOptions = ReportCellFieldBase & ({
 declare type ReportCellReadOnlyReason = "cell" | "formula" | "complex" | "structure" | "derived";
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;
@@ -2177,6 +2240,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;
@@ -2185,6 +2250,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;
@@ -2201,6 +2268,55 @@ declare interface ReportCellTableIdentity {
 declare type ReportCellValue = string | number | boolean | null;
 declare type ReportCellValueType = NonNullable<GridCell["valueType"]>;
 declare type ReportDiscardReason = "reload" | "import" | "replace" | "leave";
+declare interface ReportDocumentStyle {
+    id: string;
+    name: string;
+    style: ComponentStyle_2;
+    target?: "content" | "header";
+}
+/** 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>;
+    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;
@@ -2362,6 +2478,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;
@@ -2383,6 +2503,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;
@@ -2404,6 +2528,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;
@@ -2413,6 +2541,37 @@ declare interface ReportParamDef_3 {
     minLength?: number;
     maxLength?: number;
 }
+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 ReportParamOptionsMessages_2 {
+    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>;
@@ -2425,6 +2584,46 @@ declare interface ReportPreferencesOptions {
 }
 declare type ReportPreviewPreferences = Record<ReportPreviewTool, boolean>;
 declare type ReportPreviewTool = "search" | "thumbnails" | "zoom" | ReportExportFormat | "print" | "pdfWindow" | "editing" | "import";
+declare interface ReportPrintCalibration {
+    offsetXmm?: number;
+    offsetYmm?: number;
+}
+declare interface ReportPrintFont {
+    /** Same family name used by the template. Sources are trusted application assets. */
+    family: string;
+    source: string;
+    weight?: string;
+    style?: "normal" | "italic" | "oblique";
+}
+declare interface ReportPrintMessages {
+    printPrepareTimeout?: string;
+    printImageFailed?: string;
+    printFontFailed?: string;
+    printPrepareFailed?: string;
+    printCalibration?: string;
+    printOffsetX?: string;
+    printOffsetY?: string;
+    printCalibrationTest?: string;
+    printCalibrationHint?: string;
+}
+declare interface ReportPrintMessages_2 {
+    printPrepareTimeout?: string;
+    printImageFailed?: string;
+    printFontFailed?: string;
+    printPrepareFailed?: string;
+    printCalibration?: string;
+    printOffsetX?: string;
+    printOffsetY?: string;
+    printCalibrationTest?: string;
+    printCalibrationHint?: string;
+}
+declare interface ReportPrintOptions {
+    /** Defaults to 15 seconds for the entire font/image preparation stage. */
+    resourceTimeoutMs?: number;
+    fonts?: readonly ReportPrintFont[];
+    /** Physical translation only; no scaling or mutation of the report data/plan. */
+    calibration?: ReportPrintCalibration;
+}
 declare interface ReportTemplate {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
@@ -2533,6 +2732,19 @@ export declare const ReportTemplateEditor: DefineComponent<TemplateEditorOptions
     onSaved?: ((document: ReportTemplateDocument) => any) | undefined;
     "onExcel-bound"?: ((result: ExcelBindingWizardApply) => any) | undefined;
 }>, {}>;
+declare interface ReportTemplateFixture {
+    name: string;
+    datasets: DatasetRows;
+    params?: Record<string, string>;
+}
+/** Plain JSON, versioned by the host; inserting never links mutable library objects. */
+declare interface ReportTemplateFragment {
+    id: string;
+    name: string;
+    revision: string;
+    components: TemplateComponent_2[];
+    repeatDataset?: string;
+}
 export declare const ReportTemplateLibrary: DefineComponent<TemplateLibraryOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
     open: (document: ReportTemplateDocument_3, context?: ReportTemplateCatalogOpenContext_2 | undefined) => any;
 }, string, MachReportVuePublicProps, Readonly<TemplateLibraryOptions> & Readonly<{
@@ -2780,6 +2992,7 @@ export declare const RuleEditor: DefineComponent<RuleEditorOptions, {
 }>, {}>;
 export declare type RuleEditorMessages = typeof RULE_EDITOR_MESSAGES;
 export declare interface RuleEditorOptions {
+    recoveryKey?: string;
     list: ListComponent_2;
     datasets?: DatasetRows_2;
     datasetSchema?: DatasetContract_2;
@@ -2824,6 +3037,13 @@ declare interface StyleRule_3 {
     style: Record<string, unknown>;
 }
 export declare const TEMPLATE_EDITOR_MESSAGES: {
+    toolTarget: string;
+    toolPreview: string;
+    toolPreviewHide: string;
+    toolChooseComponent: string;
+    previousColumns: string;
+    nextColumns: string;
+    columnWindow: string;
     paperAndPages: string;
     pageDirectory: string;
     pageName: string;
@@ -3043,6 +3263,8 @@ export declare const TEMPLATE_EDITOR_MESSAGES: {
     applyJson: string;
     note: string;
     invalid: string;
+    outlineTool: string;
+    reuseTool: string;
     fitWidth: string;
     fitPage: string;
     fitSelection: string;
@@ -3098,7 +3320,108 @@ export declare const TEMPLATE_LIBRARY_MESSAGES: {
     stale: string;
     invalid: string;
 };
+export declare const TEMPLATE_PRODUCT_MESSAGES: {
+    outline: string;
+    search: string;
+    noMatches: string;
+    more: string;
+    usages: string;
+    all: string;
+    count: string;
+    page: string;
+    component: string;
+    field: string;
+    calculation: string;
+    binding: string;
+    reuse: string;
+    fragments: string;
+    styles: string;
+    insert: string;
+    update: string;
+    noFragments: string;
+    capture: string;
+    fragmentName: string;
+    role: string;
+    apply: string;
+    copy: string;
+    paste: string;
+    bindings: string;
+    dataset: string;
+    target: string;
+    preserve: string;
+    select: string;
+    revision: string;
+    instance: string;
+    newRevision: string;
+    noStyles: string;
+    nameRequired: string;
+    styleText: string;
+    styleHeading: string;
+    styleBody: string;
+    styleNumber: string;
+    styleNote: string;
+    rename: string;
+    renameHint: string;
+    continue: string;
+    cancel: string;
+    locate: string;
+};
+export declare const TEMPLATE_RECOVERY_MESSAGES: {
+    readonly available: "发现未保存草稿";
+    readonly restore: "恢复草稿";
+    readonly discard: "放弃草稿";
+    readonly stale: "草稿基线已变化，恢复后须核对最新版本再保存。";
+    readonly localOnly: "仅保存模板、JSON 与工具配置，不保存业务数据或 Excel 文件。";
+    readonly autosaved: "草稿已暂存";
+    readonly saving: "暂存中";
+    readonly storageError: "草稿暂存失败";
+    readonly conflict: "模板版本已变化";
+    readonly conflictHint: "本地修改已保留。核对差异后选择处理方式，不会自动合并或覆盖。";
+    readonly baseline: "共同基线";
+    readonly local: "本地修改";
+    readonly remote: "远端修改";
+    readonly changes: "处差异";
+    readonly path: "位置";
+    readonly before: "原值";
+    readonly after: "新值";
+    readonly empty: "没有差异";
+    readonly loadLatest: "读取最新版本";
+    readonly adopt: "采用最新版本";
+    readonly rebase: "保留本地内容，以最新版本为基线";
+    readonly confirm: "确认更新基线";
+    readonly confirmHint: "此操作保留完整本地内容，不合并远端改动；下次保存将以最新修订号校验。";
+    readonly keepCopy: "保留独立副本";
+    readonly copied: "副本已保留";
+    readonly revision: "修订";
+    readonly unknown: "未发布";
+    readonly close: "收起差异";
+    readonly review: "核对版本冲突";
+    readonly toolsNeedSource: "Excel 映射配置已恢复，请重新选择原文件后核对。";
+};
 export declare const TEMPLATE_REVIEW_MESSAGES: {
+    cancel: string;
+    cancelled: string;
+    progress: string;
+    sampleConsentMissing: string;
+    sampleNameMissing: string;
+    sampleLimit: string;
+    sampleNameDuplicate: string;
+    sampleRowsLimit: string;
+    namedFixtures: string;
+    fixtureName: string;
+    fixturePlaceholder: string;
+    deidentified: string;
+    capture: string;
+    remove: string;
+    fixtureHint: string;
+    parameters: string;
+    compare: string;
+    dimensions: string;
+    fieldsAdded: string;
+    fieldsRemoved: string;
+    baselinePreview: string;
+    draftPreview: string;
+    closeCompare: string;
     stale: string;
     scope: string;
     datasets: string;
@@ -3146,6 +3469,42 @@ export declare const TEMPLATE_REVIEW_MESSAGES: {
 declare type TemplateComponent = PlanComponent | ListComponent;
 declare type TemplateComponent_2 = PlanComponent_2 | ListComponent_2;
 declare type TemplateComponent_3 = PlanComponent_3 | ListComponent_3;
+export declare interface TemplateConflictContext {
+    id: string;
+    signal: AbortSignal;
+}
+export declare interface TemplateCopyContext extends TemplateConflictContext {
+    sourceRevision?: string;
+}
+export declare interface TemplateDraftRecord {
+    version: 1;
+    templateId: string;
+    savedAt: string;
+    baseline: ReportTemplateDocument;
+    document: ReportTemplateDocument;
+    json: string;
+    appliedJson: string;
+    tools: Record<string, TemplateToolDraft>;
+}
+export declare interface TemplateDraftStorage {
+    /** Account / project scope. Changing scope cancels previous reads and isolates recovery. */
+    scope: string;
+    adapter: TemplateDraftStorageAdapter;
+    debounceMs?: number;
+    /** UTF-16 storage budget, default 2 MiB, maximum 16 MiB. */
+    maxBytes?: number;
+}
+export declare interface TemplateDraftStorageAdapter {
+    read(key: string, context: {
+        signal: AbortSignal;
+    }): string | null | Promise<string | null>;
+    write(key: string, value: string, context: {
+        signal: AbortSignal;
+    }): void | Promise<void>;
+    remove(key: string, context: {
+        signal: AbortSignal;
+    }): void | Promise<void>;
+}
 export declare type TemplateEditorBeforeDiscard = (context: TemplateEditorBeforeDiscardContext) => boolean | Promise<boolean>;
 export declare interface TemplateEditorBeforeDiscardContext {
     reason: "reset" | "replace";
@@ -3154,6 +3513,11 @@ export declare interface TemplateEditorBeforeDiscardContext {
     replacement?: ReportTemplateDocument;
     pendingLocalChanges: true;
 }
+export declare interface TemplateEditorConflictOptions {
+    loadLatest?: (context: TemplateConflictContext) => Promise<ReportTemplateDocument>;
+    /** The host chooses the new persistent identity. The local draft remains untouched. */
+    keepCopy?: (document: ReportTemplateDocument, context: TemplateCopyContext) => Promise<void>;
+}
 export declare interface TemplateEditorController {
     readonly pendingLocalChanges: boolean;
     readonly saving?: boolean;
@@ -3164,7 +3528,15 @@ export declare interface TemplateEditorController {
 }
 /** Newly introduced labels are optional for existing complete message dictionaries. */
 export declare type TemplateEditorMessages = typeof BASE_TEMPLATE_EDITOR_MESSAGES & Partial<typeof PRODUCT_TEMPLATE_EDITOR_MESSAGES>;
-export declare interface TemplateEditorOptions {
+export declare interface TemplateEditorOptions extends TemplateEditorConflictOptions {
+    /** Opt-in declaration-only recovery. Scope should include project and account identity. */
+    draftStorage?: TemplateDraftStorage;
+    recoveryMessages?: Partial<TemplateRecoveryMessages>;
+    productMessages?: Partial<TemplateProductMessages>;
+    reviewMessages?: Partial<TemplateReviewMessages>;
+    fragments?: ReportTemplateFragment[];
+    documentStyles?: ReportDocumentStyle[];
+    reviewFixtures?: ReportTemplateFixture[];
     modelValue: ReportTemplateDocument;
     datasets?: DatasetRows;
     dataSchemas?: Record<string, DatasetContract>;
@@ -3190,6 +3562,31 @@ export declare interface TemplateLibraryOptions {
         signal: AbortSignal;
     }) => Promise<ReportTemplateDocument>;
 }
+declare interface TemplateOutlineLocation {
+    path: string;
+    pageIndex?: number;
+    componentIndex?: number;
+    field?: string;
+}
+export declare const TemplateOutlinePanel: DefineComponent<{
+    document: ReportTemplateDocument_3;
+    selection?: {
+        pageIndex: number;
+        componentIndex: number;
+    };
+    messages?: Partial<TemplateProductMessages>;
+}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    locate: (location: TemplateOutlineLocation) => any;
+}, string, MachReportVuePublicProps, Readonly<{
+    document: ReportTemplateDocument_3;
+    selection?: {
+        pageIndex: number;
+        componentIndex: number;
+    };
+    messages?: Partial<TemplateProductMessages>;
+}> & Readonly<{
+    onLocate?: ((location: TemplateOutlineLocation) => any) | undefined;
+}>, {}>;
 declare interface TemplatePage {
     widthMm: number;
     heightMm: number;
@@ -3232,6 +3629,25 @@ declare interface TemplatePage_3 {
     flow?: ReportPageFlow_3;
     meta?: Record<string, unknown>;
 }
+export declare type TemplateProductMessages = typeof TEMPLATE_PRODUCT_MESSAGES;
+export declare type TemplateRecoveryMessages = {
+    [K in keyof typeof TEMPLATE_RECOVERY_MESSAGES]: string;
+};
+export declare interface TemplateReuseOptions {
+    document: ReportTemplateDocument;
+    pageIndex: number;
+    selection?: CanvasSelection;
+    fragments?: readonly ReportTemplateFragment[];
+    styles?: readonly ReportDocumentStyle[];
+    disabled?: boolean;
+    messages?: Partial<TemplateProductMessages>;
+    accept: (change: (document: ReportTemplateDocument) => void) => boolean;
+}
+export declare const TemplateReusePanel: DefineComponent<TemplateReuseOptions, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    select: (location: CanvasSelection) => any;
+}, string, MachReportVuePublicProps, Readonly<TemplateReuseOptions> & Readonly<{
+    onSelect?: ((location: CanvasSelection) => any) | undefined;
+}>, {}>;
 export declare type TemplateReviewMessages = typeof TEMPLATE_REVIEW_MESSAGES;
 declare interface TemplateReviewOptions {
     document: ReportTemplateDocument;
@@ -3239,6 +3655,8 @@ declare interface TemplateReviewOptions {
     datasets?: DatasetRows;
     dataSchemas?: Readonly<Record<string, DatasetContract>>;
     formats?: readonly OutputFormat[];
+    /** Explicit, already de-identified examples; no business data is fetched by the editor. */
+    fixtures?: readonly ReportTemplateFixture[];
 }
 export declare const TemplateReviewPanel: DefineComponent<TemplateReviewOptions & {
     messages?: Partial<TemplateReviewMessages>;
@@ -3249,6 +3667,10 @@ export declare const TemplateReviewPanel: DefineComponent<TemplateReviewOptions
 }> & Readonly<{
     onLocate?: ((value: Pick<ReportTemplateReviewIssue, "field" | "path" | "pageIndex" | "componentIndex">) => any) | undefined;
 }>, {}>;
+export declare interface TemplateToolDraft {
+    baseline: string;
+    value: string;
+}
 /** A serialized tree contract. Sibling and root order follow input order. */
 declare interface TreeTableOptions {
     input: "flat" | "nested";
@@ -3312,21 +3734,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;
 /**
  * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
  * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
  *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
  * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
  *   目标是"财务能直接用的对账表"而非复刻版面）
- * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ * - 原生 richText 保留基础字形；未支持组件、段落专有排版与单元格嵌套组件计入 diagnostics / warnings
  */
 declare interface XlsxRenderOptions extends OutputDiagnosticOptions, XlsxImageOptions {
     /** 工作表命名（连续表默认使用标题，其余默认 "Sheet1" 起序）。 */