@agile-team/mach-report 0.6.0 → 0.8.0

package/dist/vue/async.d.cts

@@ -1,19 +1,199 @@
-import { Plugin } from 'vue';
+import { MachReportPluginOptions } from './plugin';
 /**
- * 异步插件入口（@agile-team/mach-report-vue/async）：
+ * 异步插件入口（@agile-team/mach-report/vue/async）：
  *
  * 首屏敏感页面用异步全局组件代替静态 import——组件与其引擎依赖
  * 拆为独立 chunk，路由级按需加载：
  *
  * ```ts
- * import AsyncMachReportPlugin, { preloadMachReport } from "@agile-team/mach-report-vue/async";
+ * import AsyncMachReportPlugin, { preloadMachReport } from "@agile-team/mach-report/vue/async";
  * app.use(AsyncMachReportPlugin, { baseUrl: "/sub/mach-report" });
  * void preloadMachReport(); // 可选：路由 hover 时预取
  * // 模板：<MachReportPreview temp-id="X" />
  * ```
  */
-/** 全局异步组件（懒加载 ReportPreview 及其引擎分片） */
-export declare const MachReportPreview: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+/** 全局异步组件（懒加载 ReportPreview 及其引擎分片；与主插件同源共享） */
+export declare const MachReportPreview: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        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;
+        };
+        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;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        error: (message: string, detail?: {
+            code: string;
+            cause?: unknown;
+        } | undefined) => any;
+        loaded: (pageCount: number) => any;
+    }, import('vue').PublicProps, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        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<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        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;
+        };
+        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;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        fetcher: import('./adapters').PlanFetcher | null;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
     tempId: {
         type: import('vue').PropType<string | string[] | null>;
         default: null;
@@ -58,10 +238,20 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
         type: StringConstructor;
         default: undefined;
     };
+    debug: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     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;
 }>, {
     reload: () => Promise<void>;
     print: () => Promise<void>;
@@ -69,61 +259,12 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
     openPdfWindow: () => void;
     gotoPage: (n: number) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    error: (message: string) => any;
+    error: (message: string, detail?: {
+        code: string;
+        cause?: unknown;
+    } | undefined) => any;
     loaded: (pageCount: number) => any;
-}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
-    tempId: {
-        type: import('vue').PropType<string | string[] | null>;
-        default: null;
-    };
-    furnitureTempId: {
-        type: StringConstructor;
-        default: string;
-    };
-    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;
-    };
-    fetcher: {
-        type: import('vue').PropType<import('./adapters').PlanFetcher | null>;
-        default: null;
-    };
-}>> & Readonly<{
-    onError?: ((message: string) => any) | undefined;
-    onLoaded?: ((pageCount: number) => any) | undefined;
-}>, {
+}, string, {
     height: string;
     gapPx: number;
     params: Record<string, string>;
@@ -135,12 +276,16 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
     messages: Partial<import('./config').MachReportMessages>;
     autoLoad: boolean;
     preset: string;
+    debug: boolean;
     fetcher: import('./adapters').PlanFetcher | null;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
-    viewportRef: HTMLDivElement;
-    containerRef: HTMLDivElement;
-}, HTMLDivElement>;
+}, {}, 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: Plugin;
+export declare const machReportAsyncPlugin: {
+    install(app: import('vue').App, options?: MachReportPluginOptions): void;
+};
 export default machReportAsyncPlugin;

package/dist/vue/async.d.ts

@@ -1,19 +1,199 @@
-import { Plugin } from 'vue';
+import { MachReportPluginOptions } from './plugin';
 /**
- * 异步插件入口（@agile-team/mach-report-vue/async）：
+ * 异步插件入口（@agile-team/mach-report/vue/async）：
  *
  * 首屏敏感页面用异步全局组件代替静态 import——组件与其引擎依赖
  * 拆为独立 chunk，路由级按需加载：
  *
  * ```ts
- * import AsyncMachReportPlugin, { preloadMachReport } from "@agile-team/mach-report-vue/async";
+ * import AsyncMachReportPlugin, { preloadMachReport } from "@agile-team/mach-report/vue/async";
  * app.use(AsyncMachReportPlugin, { baseUrl: "/sub/mach-report" });
  * void preloadMachReport(); // 可选：路由 hover 时预取
  * // 模板：<MachReportPreview temp-id="X" />
  * ```
  */
-/** 全局异步组件（懒加载 ReportPreview 及其引擎分片） */
-export declare const MachReportPreview: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+/** 全局异步组件（懒加载 ReportPreview 及其引擎分片；与主插件同源共享） */
+export declare const MachReportPreview: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        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;
+        };
+        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;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        error: (message: string, detail?: {
+            code: string;
+            cause?: unknown;
+        } | undefined) => any;
+        loaded: (pageCount: number) => any;
+    }, import('vue').PublicProps, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        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<{
+        tempId: {
+            type: import('vue').PropType<string | string[] | null>;
+            default: null;
+        };
+        furnitureTempId: {
+            type: StringConstructor;
+            default: string;
+        };
+        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;
+        };
+        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;
+    }>, {
+        reload: () => Promise<void>;
+        print: () => Promise<void>;
+        exportAs: (format: string) => void;
+        openPdfWindow: () => void;
+        gotoPage: (n: number) => void;
+    }, {}, {}, {}, {
+        height: string;
+        gapPx: number;
+        params: Record<string, string>;
+        furnitureTempId: string;
+        tempId: string | string[] | null;
+        showExport: boolean;
+        showPrint: boolean;
+        showPdfWindow: boolean;
+        messages: Partial<import('./config').MachReportMessages>;
+        autoLoad: boolean;
+        preset: string;
+        debug: boolean;
+        fetcher: import('./adapters').PlanFetcher | null;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
     tempId: {
         type: import('vue').PropType<string | string[] | null>;
         default: null;
@@ -58,10 +238,20 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
         type: StringConstructor;
         default: undefined;
     };
+    debug: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     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;
 }>, {
     reload: () => Promise<void>;
     print: () => Promise<void>;
@@ -69,61 +259,12 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
     openPdfWindow: () => void;
     gotoPage: (n: number) => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    error: (message: string) => any;
+    error: (message: string, detail?: {
+        code: string;
+        cause?: unknown;
+    } | undefined) => any;
     loaded: (pageCount: number) => any;
-}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
-    tempId: {
-        type: import('vue').PropType<string | string[] | null>;
-        default: null;
-    };
-    furnitureTempId: {
-        type: StringConstructor;
-        default: string;
-    };
-    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;
-    };
-    fetcher: {
-        type: import('vue').PropType<import('./adapters').PlanFetcher | null>;
-        default: null;
-    };
-}>> & Readonly<{
-    onError?: ((message: string) => any) | undefined;
-    onLoaded?: ((pageCount: number) => any) | undefined;
-}>, {
+}, string, {
     height: string;
     gapPx: number;
     params: Record<string, string>;
@@ -135,12 +276,16 @@ export declare const MachReportPreview: import('vue').DefineComponent<import('vu
     messages: Partial<import('./config').MachReportMessages>;
     autoLoad: boolean;
     preset: string;
+    debug: boolean;
     fetcher: import('./adapters').PlanFetcher | null;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
-    viewportRef: HTMLDivElement;
-    containerRef: HTMLDivElement;
-}, HTMLDivElement>;
+}, {}, 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: Plugin;
+export declare const machReportAsyncPlugin: {
+    install(app: import('vue').App, options?: MachReportPluginOptions): void;
+};
 export default machReportAsyncPlugin;

package/dist/vue/composables/useHighlight.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 预览内文本高亮（搜索命中标记）：
+ * - highlightTextNodes：TreeWalker 找文本节点，命中片段包 <mark class="mrp-hit">
+ * - clearHighlights：拆包还原（避免重复高亮叠加）
+ * 纯 DOM 操作，虚拟化窗口外的页不处理（随窗口重建自然清理）。
+ */
+export declare function clearHighlights(root: HTMLElement): void;
+export declare function highlightTextNodes(root: HTMLElement, query: string): number;

package/dist/vue/composables/usePrintExport.d.ts

@@ -7,6 +7,13 @@ interface PrintHtmlResult {
 }
 /** 构建打印文档：head（含按尺寸分组的 @page 规则）+ 每页一段 HTML（供流式写入） */
 export declare function buildPrintDocument(p: RenderPlan): PrintHtmlResult;
+/**
+ * 批量打印（多单连打）：把多份计划合并为一个打印文档——
+ * named pages 保证混合纸张正确分页，浏览器只弹一次打印对话框。
+ */
+export declare function printPlans(plans: RenderPlan[], options?: {
+    onProgress?: (done: number, total: number) => void;
+}): Promise<void>;
 export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     getPdfExporter: () => PdfExporter;
     onError: (message: string) => void;

package/dist/vue/config.d.ts

@@ -21,6 +21,15 @@ export interface MachReportMessages {
     empty: string;
     errorPrefix: string;
     retry: string;
+    /** 搜索框占位文案 */
+    searchPlaceholder: string;
+    /** 搜索命中计数，{cur}/{total} 占位 */
+    matchInfo: string;
+    /** 上/下一个命中 */
+    prevMatch: string;
+    nextMatch: string;
+    /** 缩略图侧栏开关 */
+    thumbnails: string;
 }
 export declare const DEFAULT_MESSAGES: MachReportMessages;
 /** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */

package/dist/vue/controller.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ReportPreview 的编程式控制器（与组件 ref 方法同面）：
+ * reload / print / exportAs / openPdfWindow / gotoPage。
+ */
+export interface MachReportController {
+    reload(): Promise<void>;
+    print(): Promise<void>;
+    exportAs(format: "html" | "pdf" | string): void;
+    openPdfWindow(): void;
+    gotoPage(page: number): 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;