@agile-team/mach-report 2.0.0 → 2.1.0

package/dist/vue/async.d.ts

@@ -1,320 +1,769 @@
-import { MachReportPluginOptions } from './plugin';
-/**
- * 异步插件入口（@agile-team/mach-report/vue/async）：
- *
- * 首屏敏感页面用异步全局组件代替静态 import——组件与其引擎依赖
- * 拆为独立 chunk，路由级按需加载：
- *
- * ```ts
- * import AsyncMachReportPlugin, { preloadMachReport } from "@agile-team/mach-report/vue/async";
- * app.use(AsyncMachReportPlugin, { baseUrl: "/sub/mach-report" });
- * void preloadMachReport(); // 可选：路由 hover 时预取
- * // 模板：<MachReportPreview report-id="X" />
- * ```
- */
-/** 全局异步组件（懒加载 ReportPreview 及其引擎分片；与主插件同源共享） */
-export declare const MachReportPreview: {
-    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
-        reportId: {
-            type: import('vue').PropType<string | string[] | null>;
-            default: null;
-        };
-        params: {
-            type: import('vue').PropType<Record<string, string>>;
-            default: () => {};
-        };
-        height: {
-            type: StringConstructor;
-            default: string;
-        };
-        autoLoad: {
-            type: BooleanConstructor;
-            default: boolean;
-        };
-        showExport: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        showPrint: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        showPdfWindow: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        gapPx: {
-            type: NumberConstructor;
-            default: undefined;
-        };
-        messages: {
-            type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
-            default: undefined;
-        };
-        preset: {
-            type: StringConstructor;
-            default: undefined;
-        };
-        debug: {
-            type: BooleanConstructor;
-            default: boolean;
-        };
-        paramDefs: {
-            type: import('vue').PropType<import('..').ReportParamDef[] | undefined>;
-            default: undefined;
-        };
-        showParams: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        fetcher: {
-            type: import('vue').PropType<import('./adapters').PlanFetcher | null>;
-            default: null;
-        };
-    }>> & Readonly<{
-        onError?: ((message: string, detail?: {
-            code: string;
-            cause?: unknown;
-        } | undefined) => any) | undefined;
-        onLoaded?: ((pageCount: number) => any) | undefined;
-        onWarning?: ((message: string) => any) | undefined;
-    }>, {
-        reload: () => Promise<void>;
-        print: () => Promise<void>;
-        exportAs: (format: string) => void;
-        openPdfWindow: () => void;
-        gotoPage: (n: number) => void;
-        setParams: (values: Record<string, string>, opts?: {
-            reload?: boolean;
-        }) => void;
-    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-        error: (message: string, detail?: {
-            code: string;
-            cause?: unknown;
-        } | undefined) => any;
-        loaded: (pageCount: number) => any;
-        warning: (message: string) => any;
-    }, import('vue').PublicProps, {
-        height: string;
-        gapPx: number;
-        params: Record<string, string>;
-        debug: boolean;
-        showExport: boolean;
-        showPrint: boolean;
-        showPdfWindow: boolean;
-        showParams: boolean;
-        messages: Partial<import('./config').MachReportMessages>;
-        reportId: string | string[] | null;
-        autoLoad: boolean;
-        preset: string;
-        paramDefs: import('..').ReportParamDef[] | undefined;
-        fetcher: import('./adapters').PlanFetcher | null;
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
-        viewportRef: HTMLDivElement;
-        containerRef: HTMLDivElement;
-        thumbsRef: HTMLElement;
-    }, HTMLDivElement, import('vue').ComponentProvideOptions, {
-        P: {};
-        B: {};
-        D: {};
-        C: {};
-        M: {};
-        Defaults: {};
-    }, Readonly<import('vue').ExtractPropTypes<{
-        reportId: {
-            type: import('vue').PropType<string | string[] | null>;
-            default: null;
-        };
-        params: {
-            type: import('vue').PropType<Record<string, string>>;
-            default: () => {};
-        };
-        height: {
-            type: StringConstructor;
-            default: string;
-        };
-        autoLoad: {
-            type: BooleanConstructor;
-            default: boolean;
-        };
-        showExport: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        showPrint: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        showPdfWindow: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        gapPx: {
-            type: NumberConstructor;
-            default: undefined;
-        };
-        messages: {
-            type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
-            default: undefined;
-        };
-        preset: {
-            type: StringConstructor;
-            default: undefined;
-        };
-        debug: {
-            type: BooleanConstructor;
-            default: boolean;
-        };
-        paramDefs: {
-            type: import('vue').PropType<import('..').ReportParamDef[] | undefined>;
-            default: undefined;
-        };
-        showParams: {
-            type: BooleanConstructor;
-            default: undefined;
-        };
-        fetcher: {
-            type: import('vue').PropType<import('./adapters').PlanFetcher | null>;
-            default: null;
-        };
-    }>> & Readonly<{
-        onError?: ((message: string, detail?: {
-            code: string;
-            cause?: unknown;
-        } | undefined) => any) | undefined;
-        onLoaded?: ((pageCount: number) => any) | undefined;
-        onWarning?: ((message: string) => any) | undefined;
-    }>, {
-        reload: () => Promise<void>;
-        print: () => Promise<void>;
-        exportAs: (format: string) => void;
-        openPdfWindow: () => void;
-        gotoPage: (n: number) => void;
-        setParams: (values: Record<string, string>, opts?: {
-            reload?: boolean;
-        }) => void;
-    }, {}, {}, {}, {
-        height: string;
-        gapPx: number;
-        params: Record<string, string>;
-        debug: boolean;
-        showExport: boolean;
-        showPrint: boolean;
-        showPdfWindow: boolean;
-        showParams: boolean;
-        messages: Partial<import('./config').MachReportMessages>;
-        reportId: string | string[] | null;
-        autoLoad: boolean;
-        preset: string;
-        paramDefs: import('..').ReportParamDef[] | undefined;
-        fetcher: import('./adapters').PlanFetcher | null;
-    }>;
-    __isFragment?: never;
-    __isTeleport?: never;
-    __isSuspense?: never;
-} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
-    reportId: {
-        type: import('vue').PropType<string | string[] | null>;
-        default: null;
-    };
-    params: {
-        type: import('vue').PropType<Record<string, string>>;
-        default: () => {};
-    };
-    height: {
-        type: StringConstructor;
-        default: string;
-    };
-    autoLoad: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    showExport: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
-    showPrint: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
-    showPdfWindow: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
-    gapPx: {
-        type: NumberConstructor;
-        default: undefined;
-    };
-    messages: {
-        type: import('vue').PropType<Partial<import('./config').MachReportMessages>>;
-        default: undefined;
-    };
-    preset: {
-        type: StringConstructor;
-        default: undefined;
-    };
-    debug: {
-        type: BooleanConstructor;
-        default: boolean;
-    };
-    paramDefs: {
-        type: import('vue').PropType<import('..').ReportParamDef[] | undefined>;
-        default: undefined;
-    };
-    showParams: {
-        type: BooleanConstructor;
-        default: undefined;
-    };
-    fetcher: {
-        type: import('vue').PropType<import('./adapters').PlanFetcher | null>;
-        default: null;
-    };
-}>> & Readonly<{
-    onError?: ((message: string, detail?: {
-        code: string;
-        cause?: unknown;
-    } | undefined) => any) | undefined;
-    onLoaded?: ((pageCount: number) => any) | undefined;
-    onWarning?: ((message: string) => any) | undefined;
-}>, {
-    reload: () => Promise<void>;
-    print: () => Promise<void>;
-    exportAs: (format: string) => void;
-    openPdfWindow: () => void;
-    gotoPage: (n: number) => void;
-    setParams: (values: Record<string, string>, opts?: {
-        reload?: boolean;
-    }) => void;
-}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    error: (message: string, detail?: {
-        code: string;
-        cause?: unknown;
-    } | undefined) => any;
-    loaded: (pageCount: number) => any;
-    warning: (message: string) => any;
-}, string, {
-    height: string;
-    gapPx: number;
-    params: Record<string, string>;
-    debug: boolean;
-    showExport: boolean;
-    showPrint: boolean;
-    showPdfWindow: boolean;
-    showParams: boolean;
-    messages: Partial<import('./config').MachReportMessages>;
-    reportId: string | string[] | null;
-    autoLoad: boolean;
-    preset: string;
-    paramDefs: import('..').ReportParamDef[] | undefined;
-    fetcher: import('./adapters').PlanFetcher | null;
-}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
-    $slots: {
-        default?(_: {}): any;
-    };
-});
-/** 预取组件分片（路由 hover / 空闲时调用，正式渲染零等待） */
-export declare function preloadMachReport(): Promise<unknown>;
-export declare const machReportAsyncPlugin: {
-    install(app: import('vue').App, options?: MachReportPluginOptions): void;
-};
-export default machReportAsyncPlugin;
+import { AllowedComponentProps } from 'vue';
+import { App } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentOptionsBase } from 'vue';
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { ComputedRef } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { VNodeProps } from 'vue';
+
+/**
+ * 列值格式化（声明式、JSON 可序列化）。
+ * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
+ * 三后端（DOM/Canvas/PDF）零改动。
+ *
+ * 语义约定（v0.9 固化）：
+ * - number.digits 显式给出 → 精确保留（12.5 + digits:2 → "12.50"）
+ * - number.thousands 默认 false（千分位显式开启）
+ * - date 字符串按"本地时区的日历日"解析（YYYY-MM-DD / YYYY/MM/DD 直取年月日，
+ *   不经 Date 字符串构造——后者按 UTC 零点，负时区环境会少一天）
+ */
+
+declare type ColumnFormat =
+| { kind: "number"; thousands?: boolean; digits?: number }
+| { kind: "percent"; digits?: number }
+| { kind: "date"; pattern?: string };
+
+declare type ComponentKind =
+| "text"
+| "image"
+| "barcode"
+| "qrcode"
+| "chart"
+| "line"
+| "rect"
+| "ellipse";
+
+declare interface ComponentStyle {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+
+declare type DatasetRows = Record<string, Record<string, unknown>[]>;
+
+declare interface GridCell {
+    text?: string;
+    rawText?: string;
+    children?: PlanComponent[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle;
+}
+
+declare interface ListColumn {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle;
+    /** 值格式化（声明式）：千分位/小数位、百分比、日期 pattern */
+    format?: ColumnFormat;
+    /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
+    rules?: StyleRule[];
+}
+
+declare interface ListComponent {
+    kind: "list";
+    id?: string;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    dataset: string;
+    columns: ListColumn[];
+    fontSizePt?: number;
+    headerBold?: boolean;
+    rowHeightMm?: number;
+    paddingMm?: number;
+    headerEveryPage?: boolean;
+    headerBackgroundColor?: string;
+    border?: boolean;
+    /** 分组小计（组头/组尾小计/组头防孤行） */
+    groupBy?: ListGroupBy;
+    /** 末尾总合计行（依赖 groupBy.subtotal 或显式 fields） */
+    grandTotal?: ListGrandTotal;
+}
+
+declare type ListGrandTotal =
+| boolean
+| {
+    label?: string;
+    style?: ComponentStyle;
+    /** 合计列（缺省沿用 groupBy.subtotal） */
+    fields?: string[];
+};
+
+/** 分组小计配置（声明式，见 ListComponent.groupBy） */
+declare interface ListGroupBy {
+    /** 分组字段（值变化即切组） */
+    field: string;
+    /** 组头文案模板，{value} 占位（默认 "{value}"） */
+    headerTemplate?: string;
+    headerStyle?: ComponentStyle;
+    /** 需要小计的列字段（组尾输出合计行；数值列求和，其余输出首值/留空） */
+    subtotal?: string[];
+    subtotalStyle?: ComponentStyle;
+    subtotalLabel?: string;
+    /** 组头防孤行（默认 true：页尾放不下"组头+首行"时整体换页） */
+    keepWithNext?: boolean;
+}
+
+declare const machReportAsyncPlugin: {
+    install(app: App, options?: MachReportPluginOptions): void;
+};
+export default machReportAsyncPlugin;
+export { machReportAsyncPlugin }
+
+declare interface MachReportConfig {
+    defaults: MachReportDefaults;
+    presets: Record<string, MachReportPreset>;
+    /** 默认启用的 preset 名 */
+    defaultPreset?: string;
+}
+
+/** defaults 层可配置项（全部可选，均有内置缺省） */
+declare interface MachReportDefaults {
+    showExport?: boolean;
+    showPrint?: boolean;
+    showPdfWindow?: boolean;
+    /** 参数面板显隐（有参数定义且未显式关闭时显示；缺省 true） */
+    showParams?: boolean;
+    /** 页间距 px */
+    gapPx?: number;
+    /** PDF 导出中文字体 URL */
+    pdfFontUrl?: string;
+    theme?: Partial<MachReportTheme>;
+    messages?: Partial<MachReportMessages>;
+    /** 校验告警等内部日志通道（默认 console；静默传 { warn: () => {}, info: () => {} }） */
+    logger?: MachReportLogger;
+}
+
+/**
+ * 结构化错误（code 分类，宿主可按码决定 UX：重试 / 提示 / 降级）。
+ * error 事件契约保持 `(message: string)` 不变，新增第二参数 detail（可选）。
+ */
+declare type MachReportErrorCode = "param" | "fetch" | "validate" | "render" | "pdf" | "print" | "export" | "config";
+
+/** 日志通道（默认 console；可注入 noop 静默或上报 collector） */
+declare type MachReportLogger = Pick<Console, "warn" | "info">;
+
+/**
+ * 配置中心（对齐 mach-table 的 defineMachTableConfig 体验）：
+ * - 应用级：app.use(machReportPlugin, { config: defineMachReportConfig({...}) })
+ * - 路由级叠加：provideMachReportConfig(overlay)（响应式，就近覆盖）
+ * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
+ */
+/** 工具栏与状态文案（默认简体中文；出海场景覆写） */
+declare interface MachReportMessages {
+    title: string;
+    prevPage: string;
+    nextPage: string;
+    /** 页码显示模板，{cur}/{total} 占位 */
+    pageInfo: string;
+    fitWidth: string;
+    exportHtml: string;
+    exportPdf: string;
+    exportExcel: string;
+    exportImage: string;
+    exportWord: string;
+    /** 导出进行中提示，{format} 占位 */
+    exporting: string;
+    print: string;
+    pdfWindow: string;
+    loading: string;
+    empty: string;
+    /** @deprecated 未被组件消费，将在下个大版本移除（保留仅为类型兼容） */
+    errorPrefix: string;
+    retry: string;
+    /** 可选新增文案，保留旧完整文案对象兼容。 */
+    pdfFontUnavailable?: string;
+    /** 搜索框占位文案 */
+    searchPlaceholder: string;
+    /** 搜索命中计数，{cur}/{total} 占位 */
+    matchInfo: string;
+    /** 上/下一个命中 */
+    prevMatch: string;
+    nextMatch: string;
+    /** 缩略图侧栏开关 */
+    thumbnails: string;
+    /** 参数面板 */
+    paramsTitle: string;
+    query: string;
+    reset: string;
+    /** 必填缺失提示（{label} 占位） */
+    paramRequired: string;
+}
+
+declare interface MachReportPluginOptions {
+    /** 报表数据源；也可直接传给 ReportPreview 的 fetcher prop */
+    fetcher?: PlanFetcher;
+    /** 常规业务接入：注册模板与取数，包内完成分页与参数面板；显式 fetcher 优先。 */
+    reports?: ReportRegistry;
+    /** 应用级配置中心（defaults/presets/文案/主题），见 defineMachReportConfig */
+    config?: MachReportConfig;
+    /** PDF 导出字体 URL（默认 /simhei.ttf；'' 跳过字体） */
+    pdfFontUrl?: string;
+    /** 自定义 PDF 导出器（缺省用懒加载引擎 /pdf 子路径的默认实现） */
+    pdfExporter?: PdfExporter;
+    /** 注册全局组件 <MachReportPreview>（默认 true；懒加载分片不影响首屏） */
+    globalComponent?: boolean;
+}
+
+declare type MachReportPreset = MachReportDefaults;
+
+/**
+ * 全局组件（懒加载分片：首次渲染才拉取组件与引擎依赖，
+ * 与局部 import 等价——首屏敏感页面零额外成本）
+ */
+export declare const MachReportPreview: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<ExtractPropTypes<    {
+    reportId: {
+    type: PropType<string | string[] | null>;
+    default: null;
+    };
+    params: {
+    type: PropType<Record<string, string>>;
+    default: () => {};
+    };
+    height: {
+    type: StringConstructor;
+    default: string;
+    };
+    autoLoad: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    showExport: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    showPrint: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    showPdfWindow: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    gapPx: {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    messages: {
+    type: PropType<Partial<MachReportMessages>>;
+    default: undefined;
+    };
+    preset: {
+    type: StringConstructor;
+    default: undefined;
+    };
+    debug: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    paramDefs: {
+    type: PropType<ReportParamDef[] | undefined>;
+    default: undefined;
+    };
+    showParams: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    fetcher: {
+    type: PropType<PlanFetcher | null>;
+    default: null;
+    };
+    }>> & Readonly<{
+    onError?: ((message: string, detail?: {
+    code: string;
+    cause?: unknown;
+    } | undefined) => any) | undefined;
+    onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
+    }>, {
+    reload: () => Promise<void>;
+    print: () => Promise<void>;
+    exportAs: (format: string) => Promise<void>;
+    openPdfWindow: () => void;
+    gotoPage: (n: number) => void;
+    setParams: (values: Record<string, string>, opts?: {
+    reload?: boolean;
+    }) => Promise<void>;
+    checkPdfFont: () => Promise<PdfFontCheckResult>;
+    state: ComputedRef<MachReportState>;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+    error: (message: string, detail?: {
+    code: string;
+    cause?: unknown;
+    } | undefined) => any;
+    loaded: (pageCount: number) => any;
+    warning: (message: string) => any;
+    }, PublicProps, {
+    height: string;
+    gapPx: number;
+    params: Record<string, string>;
+    debug: boolean;
+    showExport: boolean;
+    showPrint: boolean;
+    showPdfWindow: boolean;
+    showParams: boolean;
+    messages: Partial<MachReportMessages>;
+    reportId: string | string[] | null;
+    autoLoad: boolean;
+    preset: string;
+    paramDefs: ReportParamDef[] | undefined;
+    fetcher: PlanFetcher | null;
+    }, true, {}, {}, { [K in keyof GlobalComponents]: GlobalComponents[K] }, { [K in keyof GlobalDirectives]: GlobalDirectives[K] }, string, {
+    viewportRef: HTMLDivElement;
+    containerRef: HTMLDivElement;
+    thumbsRef: HTMLElement;
+    }, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<ExtractPropTypes<    {
+    reportId: {
+    type: PropType<string | string[] | null>;
+    default: null;
+    };
+    params: {
+    type: PropType<Record<string, string>>;
+    default: () => {};
+    };
+    height: {
+    type: StringConstructor;
+    default: string;
+    };
+    autoLoad: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    showExport: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    showPrint: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    showPdfWindow: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    gapPx: {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    messages: {
+    type: PropType<Partial<MachReportMessages>>;
+    default: undefined;
+    };
+    preset: {
+    type: StringConstructor;
+    default: undefined;
+    };
+    debug: {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    paramDefs: {
+    type: PropType<ReportParamDef[] | undefined>;
+    default: undefined;
+    };
+    showParams: {
+    type: BooleanConstructor;
+    default: undefined;
+    };
+    fetcher: {
+    type: PropType<PlanFetcher | null>;
+    default: null;
+    };
+    }>> & Readonly<{
+    onError?: ((message: string, detail?: {
+    code: string;
+    cause?: unknown;
+    } | undefined) => any) | undefined;
+    onLoaded?: ((pageCount: number) => any) | undefined;
+    onWarning?: ((message: string) => any) | undefined;
+    }>, {
+    reload: () => Promise<void>;
+    print: () => Promise<void>;
+    exportAs: (format: string) => Promise<void>;
+    openPdfWindow: () => void;
+    gotoPage: (n: number) => void;
+    setParams: (values: Record<string, string>, opts?: {
+    reload?: boolean;
+    }) => Promise<void>;
+    checkPdfFont: () => Promise<PdfFontCheckResult>;
+    state: ComputedRef<MachReportState>;
+    }, {}, {}, {}, {
+    height: string;
+    gapPx: number;
+    params: Record<string, string>;
+    debug: boolean;
+    showExport: boolean;
+    showPrint: boolean;
+    showPdfWindow: boolean;
+    showParams: boolean;
+    messages: Partial<MachReportMessages>;
+    reportId: string | string[] | null;
+    autoLoad: boolean;
+    preset: string;
+    paramDefs: ReportParamDef[] | undefined;
+    fetcher: PlanFetcher | null;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<ExtractPropTypes<    {
+reportId: {
+type: PropType<string | string[] | null>;
+default: null;
+};
+params: {
+type: PropType<Record<string, string>>;
+default: () => {};
+};
+height: {
+type: StringConstructor;
+default: string;
+};
+autoLoad: {
+type: BooleanConstructor;
+default: boolean;
+};
+showExport: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPrint: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPdfWindow: {
+type: BooleanConstructor;
+default: undefined;
+};
+gapPx: {
+type: NumberConstructor;
+default: undefined;
+};
+messages: {
+type: PropType<Partial<MachReportMessages>>;
+default: undefined;
+};
+preset: {
+type: StringConstructor;
+default: undefined;
+};
+debug: {
+type: BooleanConstructor;
+default: boolean;
+};
+paramDefs: {
+type: PropType<ReportParamDef[] | undefined>;
+default: undefined;
+};
+showParams: {
+type: BooleanConstructor;
+default: undefined;
+};
+fetcher: {
+type: PropType<PlanFetcher | null>;
+default: null;
+};
+}>> & Readonly<{
+onError?: ((message: string, detail?: {
+code: string;
+cause?: unknown;
+} | undefined) => any) | undefined;
+onLoaded?: ((pageCount: number) => any) | undefined;
+onWarning?: ((message: string) => any) | undefined;
+}>, {
+reload: () => Promise<void>;
+print: () => Promise<void>;
+exportAs: (format: string) => Promise<void>;
+openPdfWindow: () => void;
+gotoPage: (n: number) => void;
+setParams: (values: Record<string, string>, opts?: {
+reload?: boolean;
+}) => Promise<void>;
+checkPdfFont: () => Promise<PdfFontCheckResult>;
+state: ComputedRef<MachReportState>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+error: (message: string, detail?: {
+code: string;
+cause?: unknown;
+} | undefined) => any;
+loaded: (pageCount: number) => any;
+warning: (message: string) => any;
+}, string, {
+height: string;
+gapPx: number;
+params: Record<string, string>;
+debug: boolean;
+showExport: boolean;
+showPrint: boolean;
+showPdfWindow: boolean;
+showParams: boolean;
+messages: Partial<MachReportMessages>;
+reportId: string | string[] | null;
+autoLoad: boolean;
+preset: string;
+paramDefs: ReportParamDef[] | undefined;
+fetcher: PlanFetcher | null;
+}, {}, string, {}, { [K in keyof GlobalComponents]: GlobalComponents[K] }, { [K in keyof GlobalDirectives]: GlobalDirectives[K] }, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+});
+
+/** 只读快照，由组件的同一套状态驱动；无需通过事件另建状态。 */
+declare interface MachReportState {
+    readonly loading: boolean;
+    readonly hasPlan: boolean;
+    readonly pageCount: number;
+    readonly currentPage: number;
+    /** 当前导出显示名称，空闲时为 null。 */
+    readonly exporting: string | null;
+    readonly printing: boolean;
+    readonly canExport: boolean;
+    readonly canPrint: boolean;
+    readonly error: Readonly<MachReportStateError> | null;
+    readonly pdfFont: Readonly<PdfFontCheckResult>;
+}
+
+declare interface MachReportStateError {
+    message: string;
+    code: MachReportErrorCode;
+    cause?: unknown;
+}
+
+/** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */
+declare interface MachReportTheme {
+    shellBg: string;
+    shellFg: string;
+    toolbarBg: string;
+    toolbarBorder: string;
+    toolbarFg: string;
+    btnFg: string;
+    btnBorder: string;
+    btnHoverBg: string;
+    btnHoverFg: string;
+    btnActiveBg: string;
+}
+
+declare interface PaginateOptions {
+    /** 每行额外占高（mm），压测专用钩子 */
+    mmPerRow?: number;
+    /** 文本测量器（默认启发式；浏览器端可注入 canvas 测量校准） */
+    measurer?: TextMeasurer;
+}
+
+/** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
+declare interface PdfExporter {
+    (plan: RenderPlan, onWarning?: (message: string) => void): Promise<Uint8Array>;
+    /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
+    checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+}
+
+declare interface PdfFontCheckResult {
+    status: PdfFontStatus;
+    fontUrl: string;
+    message?: string;
+    cause?: unknown;
+}
+
+/** available 仅表示字体资源可达；实际导出仍会校验文字能否编码。 */
+declare type PdfFontStatus = "unchecked" | "checking" | "available" | "disabled" | "unverified" | "error";
+
+declare interface PlanComponent {
+    kind: ComponentKind;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph[];
+    imageData?: string;
+    grid?: PlanGrid;
+    style?: ComponentStyle;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+
+declare interface PlanFetcher {
+    (input: ReportFetchInput): Promise<RenderPlan>;
+    getParamDefs?: ReportFetcher["getParamDefs"];
+}
+
+declare interface PlanGrid {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+}
+
+declare interface PlanPage {
+    pageWidthMm: number;
+    pageHeightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: PlanComponent[];
+}
+
+/** 预取组件分片（路由 hover / 空闲时调用，正式渲染零等待） */
+export declare function preloadMachReport(): Promise<unknown>;
+
+declare interface RenderPlan {
+    schemaVersion: string;
+    pages: PlanPage[];
+}
+
+declare interface ReportDefinition {
+    template: ReportTemplate;
+    /** 静态数据；load 存在时优先使用 load 的结果。 */
+    datasets?: DatasetRows;
+    load?: (context: ReportLoadContext) => DatasetRows | Promise<DatasetRows>;
+    /** 覆盖模板参数定义，未提供时自动使用 template.params。 */
+    params?: ReportParamDef[];
+    pagination?: PaginateOptions;
+}
+
+/** 保持 Promise<RenderPlan> 契约；元数据为可选，旧业务 fetcher 无需改造。 */
+declare interface ReportFetcher {
+    (input: ReportFetchInput): Promise<RenderPlan>;
+    getParamDefs?: (reportIds: string[]) => ReportParamDef[];
+}
+
+declare interface ReportFetchInput {
+    reportIds: string[];
+    params: Record<string, string>;
+    signal?: AbortSignal;
+    /** 本次分页与计划告警；未提供时使用数据源配置的告警通道。 */
+    onWarning?: (message: string) => void;
+}
+
+/** 取数与排版共同使用的请求上下文；取消只影响本次调用。 */
+declare interface ReportLoadContext {
+    reportId: string;
+    params: Record<string, string>;
+    signal?: AbortSignal;
+}
+
+/** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
+declare interface ReportParamDef {
+    /** 参数名（传入 params，与数据集 SQL #{field} 绑定对应） */
+    field: string;
+    /** 显示名（缺省用 field） */
+    label?: string;
+    type?: "text" | "number" | "date" | "select";
+    /** select 选项 */
+    options?: Array<{ label: string; value: string }>;
+    defaultValue?: string;
+    required?: boolean;
+    placeholder?: string;
+}
+
+declare type ReportRegistry = Record<string, ReportDefinition>;
+
+declare interface ReportTemplate {
+    schemaVersion?: string;
+    /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
+    params?: ReportParamDef[];
+    pages: TemplatePage[];
+}
+
+declare interface RichParagraph {
+    segments: RichSegment[];
+    align?: ComponentStyle["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
+
+declare interface RichSegment {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle;
+}
+
+/** 条件格式规则求值（声明式，见 ListColumn.rules） */
+declare interface StyleRule {
+    when: {
+        field: string;
+        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
+        value: number | string;
+    };
+    /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
+    style: Record<string, unknown>;
+}
+
+declare type TemplateComponent = PlanComponent | ListComponent;
+
+declare interface TemplatePage {
+    widthMm: number;
+    heightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: TemplateComponent[];
+}
+
+/**
+ * 文本测量与折行（分页/Canvas/PDF 共用的唯一折行真相源）。
+ *
+ * 测量模型可注入（TextMeasurer）：
+ * - 默认 createHeuristicMeasurer()：CJK/拉丁宽度启发式（零依赖、Node 可用）
+ * - 浏览器端可注入 createCanvasMeasurer()（真字体 metrics，消除三端折行差异）
+ */
+
+declare interface TextMeasureOptions {
+    fontSizePt: number;
+    bold?: boolean;
+    letterSpacingPt?: number;
+}
+
+/** 宽度测量接口：返回文本在给定字号下的宽度（mm）。实现必须无副作用、可缓存。 */
+declare interface TextMeasurer {
+    measureMm(text: string, options: TextMeasureOptions): number;
+}
+
+export { }