@agile-team/mach-report 2.13.0 → 2.14.0

package/dist/designer.d.ts

@@ -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;
@@ -1070,6 +1080,7 @@ declare interface ListGroupBy_3 {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
+    printOptions?: ReportPrintOptions;
     showExport?: boolean;
     showPrint?: boolean;
     showPdfWindow?: boolean;
@@ -1111,7 +1122,7 @@ declare type MachReportLogger = Pick<Console, "warn" | "info">;
  * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
  */
 /** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-declare interface MachReportMessages extends Partial<ReportCalculationMessages> {
+declare interface MachReportMessages extends Partial<ReportCalculationMessages>, ReportPrintMessages {
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1122,6 +1133,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 +1297,7 @@ 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 {
     exportMenu?: string;
     exportMenuDescription?: string;
     clearSearch?: string;
@@ -1290,6 +1308,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;
@@ -2201,6 +2226,12 @@ 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";
+}
 declare interface ReportEditBatch {
     /** Idempotency identity; the server should bind it to the exact payload. */
     requestId: string;
@@ -2425,6 +2456,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 +2604,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 +2864,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;
@@ -3043,6 +3128,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 +3185,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 +3334,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 +3378,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 +3393,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 +3427,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 +3494,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 +3520,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 +3532,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";