@agile-team/mach-report 2.0.0 → 2.2.0

package/dist/vue/index.d.cts

@@ -1,14 +1,1374 @@
-export { default as ReportPreview } from './ReportPreview';
-export { default as ReportToolbar } from './ReportToolbar';
-export { default as ReportParamPanel } from './ReportParamPanel';
-export * from './adapters';
-export * from './local-adapter';
-export * from './injection-keys';
-export * from './plugin';
-export * from './config';
-export * from './pdf-exporter';
-export * from './errors';
-export * from './controller';
-export * from './composables/usePageWindow';
-export * from './composables/useZoom';
-export * from './composables/usePrintExport';
+export * from "@agile-team/mach-report";
+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 { CSSProperties } from 'vue';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
+import { InjectionKey } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { Ref } from 'vue';
+import { VNodeProps } from 'vue';
+
+declare const __VLS_component: DefineComponent<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;
+};
+/** 以下显隐/间距不传时走配置中心（preset > defaults > 内置缺省） */
+showExport: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPrint: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPdfWindow: {
+type: BooleanConstructor;
+default: undefined;
+};
+/** 页间距（px）；不传走配置中心 */
+gapPx: {
+type: NumberConstructor;
+default: undefined;
+};
+/** 工具栏/状态文案覆写（不传走配置中心 messages） */
+messages: {
+type: PropType<Partial<MachReportMessages>>;
+default: undefined;
+};
+/** 启用的 preset 名（不传用配置中心 defaultPreset） */
+preset: {
+type: StringConstructor;
+default: undefined;
+};
+/** 调试面板（也可用 URL ?mrp-debug=1 开启） */
+debug: {
+type: BooleanConstructor;
+default: boolean;
+};
+/** 参数定义（优先级：prop > 模板 params；有定义且未关闭时显示查询面板） */
+paramDefs: {
+type: PropType<ReportParamDef[] | undefined>;
+default: undefined;
+};
+/** 参数面板显隐（不传走配置中心，缺省 true；有参数定义才渲染） */
+showParams: {
+type: BooleanConstructor;
+default: undefined;
+};
+fetcher: {
+type: PropType<PlanFetcher | null>;
+default: null;
+};
+}>, {
+reload: typeof reload;
+print: typeof print_2;
+exportAs: typeof exportAs;
+openPdfWindow: typeof openPdfWindow;
+gotoPage: typeof gotoPage;
+setParams: typeof setParams;
+checkPdfFont: typeof checkPdfFont;
+state: ComputedRef<MachReportState>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+error: (message: string, detail?: {
+code: string;
+cause?: unknown;
+} | undefined) => any;
+loaded: (pageCount: number) => any;
+warning: (message: string) => any;
+}, string, PublicProps, 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;
+};
+/** 以下显隐/间距不传时走配置中心（preset > defaults > 内置缺省） */
+showExport: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPrint: {
+type: BooleanConstructor;
+default: undefined;
+};
+showPdfWindow: {
+type: BooleanConstructor;
+default: undefined;
+};
+/** 页间距（px）；不传走配置中心 */
+gapPx: {
+type: NumberConstructor;
+default: undefined;
+};
+/** 工具栏/状态文案覆写（不传走配置中心 messages） */
+messages: {
+type: PropType<Partial<MachReportMessages>>;
+default: undefined;
+};
+/** 启用的 preset 名（不传用配置中心 defaultPreset） */
+preset: {
+type: StringConstructor;
+default: undefined;
+};
+/** 调试面板（也可用 URL ?mrp-debug=1 开启） */
+debug: {
+type: BooleanConstructor;
+default: boolean;
+};
+/** 参数定义（优先级：prop > 模板 params；有定义且未关闭时显示查询面板） */
+paramDefs: {
+type: PropType<ReportParamDef[] | undefined>;
+default: undefined;
+};
+/** 参数面板显隐（不传走配置中心，缺省 true；有参数定义才渲染） */
+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;
+}>, {
+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, ComponentProvideOptions, true, {
+viewportRef: HTMLDivElement;
+containerRef: HTMLDivElement;
+thumbsRef: HTMLElement;
+}, HTMLDivElement>;
+
+declare type __VLS_Props = {
+    pageCount: number;
+    currentPage: number;
+    zoomMode: "fit" | "raw";
+    zoom: number;
+    showExport: boolean;
+    showPrint: boolean;
+    showPdfWindow: boolean;
+    messages: MachReportMessages;
+    search: {
+        visible: boolean;
+        query: string;
+        matchIndex: number;
+        matchCount: number;
+        searching?: boolean;
+    };
+    thumbsVisible: boolean;
+};
+
+declare type __VLS_Props_2 = {
+    defs: ReportParamDef[];
+    modelValue: Record<string, string>;
+    messages: MachReportMessages;
+    /** 触发过查询后才开始必填提示（避免首屏一片红） */
+    attempted: boolean;
+};
+
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        viewportRef: HTMLDivElement;
+        containerRef: HTMLDivElement;
+        thumbsRef: HTMLElement;
+    };
+    rootEl: HTMLDivElement;
+};
+
+declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+
+declare type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
+export declare function buildPrintDocument(p: RenderPlan): PrintHtmlResult;
+
+/**
+ * Word 导出（Word 兼容 HTML，.doc MIME）：
+ * 复用打印文档构建（同一样式与 named pages 分页规则），套 Word 命名空间头。
+ * Word 2003+ 可直接打开编辑——覆盖"导出可编辑单据"场景，零后端。
+ */
+export declare function buildWordHtml(p: RenderPlan): {
+    html: string;
+    filename: string;
+};
+
+/** 检查失败只影响 PDF 诊断，不阻塞预览或其它输出。 */
+declare function checkPdfFont(): Promise<PdfFontCheckResult>;
+
+/**
+ * 列值格式化（声明式、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 ConfigRef = ComputedRef<MachReportConfig | null>;
+
+/**
+ * 默认 PDF 导出器：
+ * - 懒加载 @agile-team/mach-report/pdf（含 pdf-lib，只在首次导出时进 bundle）
+ * - 字体走 IndexedDB 持久缓存（loadFontWithCache，二次导出零网络）
+ */
+export declare function createDefaultPdfExporter(options?: DefaultPdfExporterOptions): PdfExporter;
+
+/**
+ * 零依赖请求适配器：用全局 fetch 实现 HostRequest 签名，
+ * 供自定义 PlanFetcher 按需调用，不预设任何报表接口路径或响应包装。
+ * 内置超时（AbortController）与网络/HTTP 错误语义。
+ */
+export declare function createFetchRequest(options?: FetchRequestOptions): HostRequest;
+
+/**
+ * 本地渲染适配器：模板 + 数据 → core 分页引擎 → RenderPlan。
+ * 用于本地预览、离线场景和单测。
+ */
+export declare function createLocalFetcher(entries: Record<string, LocalTemplateEntry> | ReportRegistry): PlanFetcher;
+
+declare type DatasetRows = Record<string, Record<string, unknown>[]>;
+
+export declare const DEFAULT_MESSAGES: MachReportMessages;
+
+export declare const DEFAULT_THEME: MachReportTheme;
+
+export declare interface DefaultPdfExporterOptions {
+    /** 中文字体 URL（浏览器 fetch）；空串跳过字体加载（西文报表） */
+    fontUrl: string;
+}
+
+/** 类型化配置声明，归一化为完整配置，便于直接传给插件或路由层。 */
+export declare function defineMachReportConfig(config?: MachReportConfigInput): MachReportConfig;
+
+/** 类型化 preset 声明 */
+export declare function defineMachReportPreset(preset: MachReportPreset): MachReportPreset;
+
+declare function exportAs(format: string): Promise<void>;
+
+export declare interface FetchRequestOptions {
+    /** 网关前缀（默认空 = 同源） */
+    baseUrl?: string;
+    /** 附加请求头（如鉴权 token） */
+    headers?: Record<string, string>;
+    credentials?: RequestCredentials;
+    /** 完整请求（含 JSON 响应体）的超时毫秒（默认 30000；超时抛 PlanLoadError） */
+    timeoutMs?: number;
+}
+
+declare function gotoPage(n: number): void;
+
+declare interface GridCell {
+    text?: string;
+    rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
+    children?: PlanComponent[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle;
+}
+
+/** 通用请求函数签名（可适配 Axios 风格客户端） */
+export declare type HostRequest = (config: {
+    url: string;
+    method: string;
+    params?: Record<string, string>;
+    /** 取消单次请求；可与内置超时一起使用 */
+    signal?: AbortSignal;
+}) => Promise<unknown>;
+
+export declare function joinReportIds(reportId: ReportIdInput): string;
+
+/** auto：真实数字/显式数值格式居右，日期与布尔居中，其他内容居左。 */
+declare type ListAlignment = NonNullable<ComponentStyle["align"]> | "auto";
+
+declare interface ListColumn {
+    header: string;
+    field: string;
+    widthMm: number;
+    style?: ComponentStyle;
+    /** 内容对齐，优先于 style.align；数值字符串不会自动判为数字。 */
+    align?: ListAlignment;
+    /** 独立的表头对齐，不改变内容对齐。 */
+    headerAlign?: ComponentStyle["align"];
+    /** 独立的表头样式，优先于列表级表头样式。 */
+    headerStyle?: 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;
+    /** 内容默认对齐，列配置可覆盖；低层模板缺省仍为 left。 */
+    align?: ListAlignment;
+    /** 表头默认对齐，列配置可覆盖。 */
+    headerAlign?: ComponentStyle["align"];
+    headerStyle?: ComponentStyle;
+    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;
+}
+
+export declare interface LocalTemplateEntry {
+    template: ReportTemplate;
+    datasets?: Record<string, Record<string, unknown>[]>;
+}
+
+export declare const MACH_REPORT_CONFIG_KEY: InjectionKey<ComputedRef<MachReportConfig | null>>;
+
+export declare const MACH_REPORT_CONTROLLER_KEY: InjectionKey<MachReportController>;
+
+/**
+ * 注入 key 全部为字符串（而非裸 Symbol）：跨模块联邦边界时宿主与远程
+ * 各自打包会生成不同的 Symbol 实例导致 inject 失效；字符串恒等。
+ * 保留 InjectionKey 类型以获得类型提示。
+ */
+export declare const MACH_REPORT_FETCHER_KEY: InjectionKey<PlanFetcher>;
+
+export declare const MACH_REPORT_PDF_EXPORTER_KEY: InjectionKey<PdfExporter>;
+
+export declare interface MachReportConfig {
+    defaults: MachReportDefaults;
+    presets: Record<string, MachReportPreset>;
+    /** 默认启用的 preset 名 */
+    defaultPreset?: string;
+}
+
+/** 应用配置输入：只声明需要的 defaults 或 presets，省略层由包内补齐。 */
+export declare type MachReportConfigInput = Partial<MachReportConfig>;
+
+/**
+ * ReportPreview 的编程式控制器（与组件 ref 方法同面）：
+ * reload / print / exportAs / openPdfWindow / gotoPage / setParams。
+ */
+export declare interface MachReportController {
+    /** 新组件提供；可选以兼容旧自定义控制器。 */
+    readonly state?: MachReportState;
+    checkPdfFont?(): Promise<PdfFontCheckResult>;
+    reload(): Promise<void>;
+    print(): Promise<void>;
+    /** 支持 html/pdf/xlsx/png/word（excel/image/doc 为兼容别名）；未知格式报 export 错误。 */
+    exportAs(format: string): Promise<void> | void;
+    openPdfWindow(): void;
+    gotoPage(page: number): void;
+    /** 编程式设置参数并查询（合并进面板值；opts.reload=false 仅设值不重载） */
+    setParams(values: Record<string, string>, opts?: {
+        reload?: boolean;
+    }): Promise<void> | void;
+}
+
+/** defaults 层可配置项（全部可选，均有内置缺省） */
+export 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;
+    preview?: MachReportPreviewOptions;
+    /** Excel 出口配置，按字段继承；不配置使用导出器默认值。 */
+    xlsx?: XlsxRenderOptions;
+}
+
+export declare class MachReportError extends Error {
+    readonly code: MachReportErrorCode;
+    readonly cause?: unknown;
+    constructor(code: MachReportErrorCode, message: string, cause?: unknown);
+}
+
+/**
+ * 结构化错误（code 分类，宿主可按码决定 UX：重试 / 提示 / 降级）。
+ * error 事件契约保持 `(message: string)` 不变，新增第二参数 detail（可选）。
+ */
+export declare type MachReportErrorCode = "param" | "fetch" | "validate" | "render" | "pdf" | "print" | "export" | "config";
+
+/** error 事件第二参数的形状（向后兼容：仅监听 message 的旧用法不受影响） */
+export declare interface MachReportErrorDetail {
+    code: MachReportErrorCode;
+    cause?: unknown;
+}
+
+/** 父组件使用的稳定句柄；ref 回调直接绑定到预览组件。 */
+export declare interface MachReportHandle extends MachReportController {
+    ref(instance: unknown): void;
+    readonly ready: ComputedRef<boolean>;
+    readonly state: MachReportState;
+    checkPdfFont(): Promise<PdfFontCheckResult>;
+    exportAs(format: string): Promise<void>;
+    setParams(values: Record<string, string>, opts?: {
+        reload?: boolean;
+    }): Promise<void>;
+}
+
+/** 日志通道（默认 console；可注入 noop 静默或上报 collector） */
+export declare type MachReportLogger = Pick<Console, "warn" | "info">;
+
+/**
+ * 配置中心（对齐 mach-table 的 defineMachTableConfig 体验）：
+ * - 应用级：app.use(machReportPlugin, { config: defineMachReportConfig({...}) })
+ * - 路由级叠加：provideMachReportConfig(overlay)（响应式，就近覆盖）
+ * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
+ */
+/** 工具栏与状态文案（默认简体中文；出海场景覆写） */
+export 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;
+    /** 可选搜索进度文案，旧完整 messages 对象无需新增字段。 */
+    searching?: string;
+}
+
+/**
+ * Vue 插件：注册组件、配置和可选的数据源，不绑定任何后端接口。
+ *
+ * ```ts
+ * app.use(machReportPlugin, { fetcher })
+ * app.use(machReportPlugin, { config: defineMachReportConfig({...}) })
+ * ```
+ *
+ * 之后业务模板直接写 `<MachReportPreview report-id="X" />`。
+ */
+export declare const machReportPlugin: {
+    install(app: App, options?: MachReportPluginOptions): void;
+};
+
+export 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;
+}
+
+export 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;
+    };
+});
+
+/** 预览按需调优；默认已经启用正文/缩略图虚拟化及可取消的分片搜索。 */
+export declare interface MachReportPreviewOptions {
+    /** 视口前后额外保留的正文页数，默认 1，归一化到 0~10 的整数。 */
+    overscanPages?: number;
+    /** 搜索输入防抖毫秒，默认 200，归一化到 0~2000。 */
+    searchDebounceMs?: number;
+}
+
+/** 只读快照，由组件的同一套状态驱动；无需通过事件另建状态。 */
+export 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>;
+}
+
+export declare interface MachReportStateError {
+    message: string;
+    code: MachReportErrorCode;
+    cause?: unknown;
+}
+
+/** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */
+export declare interface MachReportTheme {
+    shellBg: string;
+    shellFg: string;
+    toolbarBg: string;
+    toolbarBorder: string;
+    toolbarFg: string;
+    btnFg: string;
+    btnBorder: string;
+    btnHoverBg: string;
+    btnHoverFg: string;
+    btnActiveBg: string;
+}
+
+export declare function normalizeReportIds(reportId: ReportIdInput): string[];
+
+declare function openPdfWindow(): void;
+
+declare interface PageWindow {
+    start: number;
+    end: number;
+    padTopPx: number;
+    padBottomPx: number;
+}
+
+declare interface PaginateOptions {
+    /** 每行额外占高（mm），压测专用钩子 */
+    mmPerRow?: number;
+    /** 文本测量器（默认启发式；浏览器端可注入 canvas 测量校准） */
+    measurer?: TextMeasurer;
+}
+
+/** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
+export declare interface PdfExporter {
+    (plan: RenderPlan, onWarning?: (message: string) => void): Promise<Uint8Array>;
+    /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
+    checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+}
+
+export declare interface PdfFontCheckResult {
+    status: PdfFontStatus;
+    fontUrl: string;
+    message?: string;
+    cause?: unknown;
+}
+
+/** available 仅表示字体资源可达；实际导出仍会校验文字能否编码。 */
+export 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;
+}
+
+export declare interface PlanFetcher {
+    (input: ReportFetchInput): Promise<RenderPlan>;
+    getParamDefs?: ReportFetcher["getParamDefs"];
+}
+
+declare interface PlanGrid {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+}
+
+export declare class PlanLoadError extends Error {
+    constructor(message: string);
+}
+
+declare interface PlanPage {
+    pageWidthMm: number;
+    pageHeightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: PlanComponent[];
+}
+
+declare function print_2(): Promise<void>;
+
+declare interface PrintHtmlResult {
+    head: string;
+    pageChunks: string[];
+}
+
+/**
+ * 批量打印（多单连打）：把多份计划合并为一个打印文档——
+ * named pages 保证混合纸张正确分页，浏览器只弹一次打印对话框。
+ */
+export declare function printPlans(plans: RenderPlan[], options?: {
+    onProgress?: (done: number, total: number) => void;
+    onError?: (message: string) => void;
+}): Promise<void>;
+
+/**
+ * 路由/布局级响应式叠加：就近提供配置层（如某路由关闭导出按钮）。
+ * 本层 defaults 优先于上层 defaults/preset，本层 preset 再覆盖本层 defaults。
+ * 同名 preset 与 messages/theme 均按字段继承；组件 props 仍拥有最高优先级。
+ */
+export declare function provideMachReportConfig(overlay: MachReportConfigInput | MachReportDefaults): void;
+
+declare function reload(): Promise<void>;
+
+declare interface RenderPlan {
+    schemaVersion: string;
+    pages: PlanPage[];
+}
+
+declare interface ReportDefinition {
+    /** 静态模板或宿主提供的异步模板加载器；动态模板默认每次重新读取，不缓存版本。 */
+    template: ReportTemplate | ReportTemplateLoader;
+    /** 静态数据；load 存在时优先使用 load 的结果。 */
+    datasets?: DatasetRows;
+    load?: (context: ReportLoadContext) => DatasetRows | Promise<DatasetRows>;
+    /** 覆盖模板参数定义；动态模板应在此声明查询面板元数据，避免查询前先请求模板。 */
+    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;
+}
+
+export declare type ReportIdInput = string | string[] | null | undefined;
+
+/** 取数与排版共同使用的请求上下文；取消只影响本次调用。 */
+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;
+}
+
+export declare const ReportParamPanel: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+reset: () => any;
+query: () => any;
+"update:modelValue": (value: Record<string, string>) => any;
+}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{
+onReset?: (() => any) | undefined;
+onQuery?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+
+export declare const ReportPreview: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+
+declare type ReportRegistry = Record<string, ReportDefinition>;
+
+declare interface ReportTemplate {
+    schemaVersion?: string;
+    /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
+    params?: ReportParamDef[];
+    pages: TemplatePage[];
+}
+
+declare type ReportTemplateLoader = (context: ReportLoadContext) => ReportTemplate | Promise<ReportTemplate>;
+
+export declare const ReportToolbar: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+print: () => any;
+export: (format: "html" | "png" | "pdf" | "xlsx" | "word") => any;
+zoom: (mode: number | "fit") => any;
+goto: (page: number) => any;
+"pdf-window": () => any;
+"search-input": (query: string) => any;
+"search-nav": (dir: 1 | -1) => any;
+"search-toggle": () => any;
+"thumbs-toggle": () => any;
+}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
+onPrint?: (() => any) | undefined;
+onExport?: ((format: "html" | "png" | "pdf" | "xlsx" | "word") => any) | undefined;
+onZoom?: ((mode: number | "fit") => any) | undefined;
+onGoto?: ((page: number) => any) | undefined;
+"onPdf-window"?: (() => any) | undefined;
+"onSearch-input"?: ((query: string) => any) | undefined;
+"onSearch-nav"?: ((dir: 1 | -1) => any) | undefined;
+"onSearch-toggle"?: (() => any) | undefined;
+"onThumbs-toggle"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+searchInputRef: HTMLInputElement;
+}, HTMLDivElement>;
+
+export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
+
+export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showParams" | "gapPx">> & {
+    pdfFontUrl: string;
+    theme: MachReportTheme;
+    messages: MachReportMessages;
+    logger: MachReportLogger;
+    preview: Required<MachReportPreviewOptions>;
+    xlsx: XlsxRenderOptions;
+};
+
+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;
+}
+
+/** 控制器注入：后代组件 useReportPreview() 免模板 ref 编程式访问（与 expose 同面） */
+/** 编程式设参查询：合并进面板值（面板本地字典经 v-model 同步），可选立即重载 */
+declare function setParams(values: Record<string, string>, opts?: {
+    reload?: boolean;
+}): Promise<void>;
+
+export declare const SILENT_LOGGER: MachReportLogger;
+
+/** 条件格式规则求值（声明式，见 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;
+}
+
+/** theme 对象 → CSS 自定义属性 style 对象（注入组件外壳） */
+export declare function themeToCssVars(theme: Partial<MachReportTheme>): CSSProperties;
+
+export declare function toErrorDetail(error: unknown): MachReportErrorDetail;
+
+/**
+ * 父组件统一入口，无需手写组件实例类型或可选链：
+ * `const report = useMachReport()` → `<MachReportPreview :ref="report.ref" />`。
+ * 异步组件挂载前/卸载后调用会报告 config 错误；ready 可控制按钮状态。
+ */
+export declare function useMachReport(): MachReportHandle;
+
+/** 组件内部读取当前生效配置层（未提供时返回 null → 走内置缺省） */
+export declare function useMachReportConfig(): ConfigRef;
+
+/** 页级虚拟化；页几何按计划引用缓存，滚动仅更新坐标，不遍历整个计划。 */
+export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<number>, options?: {
+    pxPerMm?: number;
+    gapPx?: number | Ref<number>;
+    overscan?: number | Ref<number>;
+}): {
+    contentSize: ComputedRef<    {
+    w: number;
+    h: number;
+    }>;
+    windowRange: ComputedRef<PageWindow>;
+    visiblePages: ComputedRef<    {
+    page: PlanPage;
+    index: number;
+    }[]>;
+    makeScrollHandler: (currentPage: Ref<number>, pageCount: Ref<number>) => (vp: HTMLElement) => void;
+    refreshViewport: (vp: HTMLElement | null) => void;
+    pageOffsetPx: (index: number) => number;
+    destroy: () => void;
+};
+
+export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
+    /** 按导出开始时的配置快照处理，避免输出过程中跟随路由配置变化。 */
+    getXlsxOptions?: () => XlsxRenderOptions;
+    getPdfExporter: () => PdfExporter;
+    onError: (message: string, code?: string) => void;
+    onWarning?: (message: string) => void;
+    onBusy?: (format: string | null) => void;
+    onPrinting?: (printing: boolean) => void;
+}): {
+    print: () => Promise<void>;
+    exportAs: (format: string) => Promise<void>;
+    exportImages: () => Promise<void>;
+    exportWord: () => void;
+    openPdfWindow: () => void;
+    releasePrintFrame: () => void;
+    dispose: () => void;
+};
+
+/**
+ * 在 ReportPreview 的任意后代组件中获取控制器（免模板 ref）：
+ *
+ * ```vue
+ * <script setup>
+ * import { useReportPreview } from "@agile-team/mach-report/vue";
+ * const preview = useReportPreview();
+ * </script>
+ * <template><button @click="preview?.print()">打印本单</button></template>
+ *
+ * 不在预览组件内调用时返回 null（不抛错，便于条件渲染场景）。
+ */
+export declare function useReportPreview(): MachReportController | null;
+
+/**
+ * 缩放状态（transform: scale 方案）：
+ * - fit 模式：按视口宽自适应（clamp 0.3~1）
+ * - raw 模式：固定百分比
+ * transform 而非 CSS zoom：标准属性、跨浏览器、零重排。
+ */
+export declare function useZoom(getFitInputs: () => {
+    viewport: HTMLElement | null;
+    pageWidthPx: number;
+} | null): {
+    zoom: Ref<number, number>;
+    zoomMode: Ref<"raw" | "fit", "raw" | "fit">;
+    applyFitZoom: () => void;
+    setZoom: (mode: "fit" | number) => void;
+};
+
+/**
+ * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
+ * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
+ *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
+ * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
+ *   目标是"财务能直接用的对账表"而非复刻版面）
+ * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ */
+declare interface XlsxRenderOptions {
+    /** 工作表命名（默认 "Sheet1" 起序） */
+    sheetName?: (pageIndex: number) => string;
+    /** 默认 text 保留显示文本；raw 使用列表自动保留的原始数值、布尔、文本与空值。 */
+    valueMode?: "text" | "raw";
+    /** 默认 auto 按计划识别 A3/A4/A5；自定义尺寸回退 A4 并返回告警。 */
+    paperSize?: "auto" | "a3" | "a4" | "a5";
+}
+
+export { }