@agile-team/mach-report 1.2.2 → 2.1.0

package/dist/vue/ReportToolbar.d.ts

@@ -1,42 +0,0 @@
-import { MachReportMessages } from './config';
-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;
-    };
-    thumbsVisible: boolean;
-};
-declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    export: (format: "html" | "png" | "pdf" | "xlsx" | "word") => any;
-    zoom: (mode: number | "fit") => any;
-    print: () => 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, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onExport?: ((format: "html" | "png" | "pdf" | "xlsx" | "word") => any) | undefined;
-    onZoom?: ((mode: number | "fit") => any) | undefined;
-    onPrint?: (() => 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, import('vue').ComponentProvideOptions, false, {
-    searchInputRef: HTMLInputElement;
-}, HTMLDivElement>;
-export default _default;

package/dist/vue/adapters.d.ts

@@ -1,40 +0,0 @@
-import { RenderPlan } from '@agile-team/mach-report';
-export type TempIdInput = string | string[] | null | undefined;
-export interface PlanFetcher {
-    (input: {
-        tempIds: string[];
-        furnitureTempId?: string;
-        params: Record<string, string>;
-    }): Promise<RenderPlan>;
-}
-export declare function normalizeTempIds(tempId: TempIdInput): string[];
-export declare function joinTempIds(tempId: TempIdInput): string;
-export declare class PlanLoadError extends Error {
-    constructor(message: string);
-}
-/** 宿主请求函数签名（axios 风格；createJh4jGridPlanFetcher 消费） */
-export type HostRequest = (config: {
-    url: string;
-    method: string;
-    params?: Record<string, string>;
-}) => Promise<unknown>;
-export interface FetchRequestOptions {
-    /** 网关前缀（默认空 = 同源） */
-    baseUrl?: string;
-    /** 附加请求头（如鉴权 token） */
-    headers?: Record<string, string>;
-    credentials?: RequestCredentials;
-    /** 超时毫秒（默认 30000；超时抛 PlanLoadError） */
-    timeoutMs?: number;
-}
-/**
- * 零依赖请求适配器：用全局 fetch 实现 HostRequest 签名，
- * 让宿主无需引入 axios 或手写胶水代码即可接上 jh4j 数据面。
- * 内置超时（AbortController）与网络/HTTP 错误语义。
- */
-export declare function createFetchRequest(options?: FetchRequestOptions): HostRequest;
-export declare function createJh4jGridPlanFetcher(options: {
-    request: HostRequest;
-    /** 网关前缀，默认空（同域） */
-    baseUrl?: string;
-}): PlanFetcher;

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

@@ -1,8 +0,0 @@
-/**
- * 预览内文本高亮（搜索命中标记）：
- * - 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/usePageWindow.d.ts

@@ -1,25 +0,0 @@
-import { Ref } from 'vue';
-import { PlanPage, RenderPlan } from '@agile-team/mach-report';
-/**
- * 页级视口虚拟化（DOM 后端）。
- *
- * 坐标口径（与 transform: scale 缩放配合）：
- * - 页高/间距/占位均在"自然坐标系"（未缩放 px）维护
- * - 视口滚动量与视口高换算回自然系（除以 zoom）后再进 computePageWindow
- */
-export declare function usePageWindow(plan: Ref<RenderPlan | null>, zoom: Ref<number>, options?: {
-    pxPerMm?: number;
-    gapPx?: number | Ref<number>;
-}): {
-    contentSize: import('vue').ComputedRef<{
-        w: number;
-        h: number;
-    }>;
-    windowRange: import('vue').ComputedRef<import('@agile-team/mach-report').PageWindow>;
-    visiblePages: import('vue').ComputedRef<{
-        page: PlanPage;
-        index: number;
-    }[]>;
-    makeScrollHandler: (currentPage: Ref<number>, pageCount: Ref<number>) => (vp: HTMLElement) => void;
-    refreshViewport(vp: HTMLElement | null): void;
-};

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

@@ -1,40 +0,0 @@
-import { Ref } from 'vue';
-import { RenderPlan } from '@agile-team/mach-report';
-import { PdfExporter } from '../pdf-exporter';
-interface PrintHtmlResult {
-    head: string;
-    pageChunks: string[];
-}
-/** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
-export declare function buildPrintDocument(p: RenderPlan): PrintHtmlResult;
-/**
- * 批量打印（多单连打）：把多份计划合并为一个打印文档——
- * named pages 保证混合纸张正确分页，浏览器只弹一次打印对话框。
- */
-export declare function printPlans(plans: RenderPlan[], options?: {
-    onProgress?: (done: number, total: number) => void;
-    onError?: (message: string) => void;
-}): Promise<void>;
-/**
- * Word 导出（Word 兼容 HTML，.doc MIME）：
- * 复用打印文档构建（同一样式与 named pages 分页规则），套 Word 命名空间头。
- * Word 2003+ 可直接打开编辑——覆盖"导出可编辑单据"场景，零后端。
- */
-export declare function buildWordHtml(p: RenderPlan): {
-    html: string;
-    filename: string;
-};
-export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
-    getPdfExporter: () => PdfExporter;
-    onError: (message: string, code?: string) => void;
-    onWarning?: (message: string) => void;
-    onBusy?: (format: string | null) => void;
-}): {
-    print: () => Promise<void>;
-    exportAs: (format: string) => void;
-    exportImages: () => Promise<void>;
-    exportWord: () => void;
-    openPdfWindow: () => void;
-    releasePrintFrame: () => void;
-};
-export {};

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

@@ -1,73 +0,0 @@
-import { Ref } from 'vue';
-import { RenderPlan } from '@agile-team/mach-report';
-/**
- * 预览交互 composables 集合（本文件包含四件）：
- *
- * - useReportSearch：搜索（防抖索引 → 跳页导航 → 命中页高亮）
- * - useDebugPanel：调试面板（?mrp-debug=1；planKB 按 plan 引用缓存）
- * - useThumbs：缩略图侧栏（IntersectionObserver 懒渲染小画布）
- * - useLoadTiming：加载耗时计时（performance 不可用时降级为 0）
- */
-export interface ReportSearchState {
-    visible: Ref<boolean>;
-    query: Ref<string>;
-    matchIndex: Ref<number>;
-    matchCount: Ref<number>;
-    toggle(): void;
-    onInput(query: string): void;
-    onNav(dir: 1 | -1): void;
-    /** 页面元素高亮（查询为空时为 no-op） */
-    apply(pageEl: HTMLElement): void;
-    clear(pageEl: HTMLElement): void;
-    /** 换单据/清空时的整体复位 */
-    reset(): void;
-}
-export interface ReportSearchOptions {
-    plan: Ref<RenderPlan | null>;
-    gotoPage(page: number): void;
-    debounceMs?: number;
-    highlight: (pageEl: HTMLElement, query: string) => number;
-    clearHighlights: (pageEl: HTMLElement) => void;
-}
-export declare function useReportSearch(options: ReportSearchOptions): ReportSearchState;
-/**
- * 调试面板状态：?mrp-debug=1 或 debug prop。
- * planKB 按 plan 引用缓存（滚动/缩放不触发全量 JSON 序列化）。
- */
-export declare function useDebugPanel(debug: Ref<boolean>, stats: {
-    plan: Ref<RenderPlan | null>;
-    pageCount: Ref<number>;
-    windowRange: Ref<{
-        start: number;
-        end: number;
-    }>;
-    zoom: Ref<number>;
-    loadMs: Ref<number>;
-}): {
-    enabled: import('vue').ComputedRef<boolean>;
-    debugStats: import('vue').ComputedRef<{
-        pages: number;
-        window: string;
-        zoom: string;
-        loadMs: string;
-        planKB: number;
-    } | null>;
-};
-/**
- * 缩略图侧栏：懒渲染小画布（IntersectionObserver + 低 dpr）。
- * 无 2D 环境（SSR/测试）保留占位框，不抛错。
- */
-export declare function useThumbs(plan: Ref<RenderPlan | null>, opts: {
-    thumbsRoot: Ref<HTMLElement | null>;
-    visible: Ref<boolean>;
-    renderThumbCanvas: (pageIndex: number) => HTMLCanvasElement | null;
-}): {
-    schedule: () => void;
-    destroy: () => void;
-};
-/** 加载耗时计时（performance 不可用时为 0） */
-export declare function useLoadTiming(): {
-    loadMs: Ref<number>;
-    start(): number;
-    end(t0: number): void;
-};

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

@@ -1,15 +0,0 @@
-/**
- * 缩放状态（transform: scale 方案）：
- * - fit 模式：按视口宽自适应（clamp 0.3~1）
- * - raw 模式：固定百分比
- * transform 而非 CSS zoom：标准属性、跨浏览器、零重排。
- */
-export declare function useZoom(getFitInputs: () => {
-    viewport: HTMLElement | null;
-    pageWidthPx: number;
-} | null): {
-    zoom: import('vue').Ref<number, number>;
-    zoomMode: import('vue').Ref<"fit" | "raw", "fit" | "raw">;
-    applyFitZoom: () => void;
-    setZoom: (mode: "fit" | number) => void;
-};

package/dist/vue/config.d.ts

@@ -1,108 +0,0 @@
-import { ComputedRef, CSSProperties } from 'vue';
-/**
- * 配置中心（对齐 mach-table 的 defineMachTableConfig 体验）：
- * - 应用级：app.use(machReportPlugin, { config: defineMachReportConfig({...}) })
- * - 路由级叠加：provideMachReportConfig(overlay)（响应式，就近覆盖）
- * - 优先级：组件 props > 路由级叠加 > preset > defaults（props 永远最高）
- */
-/** 工具栏与状态文案（默认简体中文；出海场景覆写） */
-export 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;
-    /** 搜索框占位文案 */
-    searchPlaceholder: string;
-    /** 搜索命中计数，{cur}/{total} 占位 */
-    matchInfo: string;
-    /** 上/下一个命中 */
-    prevMatch: string;
-    nextMatch: string;
-    /** 缩略图侧栏开关 */
-    thumbnails: string;
-    /** 参数面板 */
-    paramsTitle: string;
-    query: string;
-    reset: string;
-    /** 必填缺失提示（{label} 占位） */
-    paramRequired: string;
-}
-export declare const DEFAULT_MESSAGES: MachReportMessages;
-/** 主题变量（组件外壳注入的 --mrp-* CSS 自定义属性） */
-export interface MachReportTheme {
-    shellBg: string;
-    shellFg: string;
-    toolbarBg: string;
-    toolbarBorder: string;
-    toolbarFg: string;
-    btnFg: string;
-    btnBorder: string;
-    btnHoverBg: string;
-    btnHoverFg: string;
-    btnActiveBg: string;
-}
-export declare const DEFAULT_THEME: MachReportTheme;
-/** 日志通道（默认 console；可注入 noop 静默或上报 collector） */
-export type MachReportLogger = Pick<Console, "warn" | "info">;
-/** defaults 层可配置项（全部可选，均有内置缺省） */
-export 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;
-}
-export type MachReportPreset = MachReportDefaults;
-export interface MachReportConfig {
-    defaults: MachReportDefaults;
-    presets: Record<string, MachReportPreset>;
-    /** 默认启用的 preset 名 */
-    defaultPreset?: string;
-}
-/** 类型化配置声明（纯类型助手，便于独立 config 文件） */
-export declare function defineMachReportConfig(config: MachReportConfig): MachReportConfig;
-/** 类型化 preset 声明 */
-export declare function defineMachReportPreset(preset: MachReportPreset): MachReportPreset;
-export type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showParams" | "gapPx">> & {
-    pdfFontUrl: string;
-    theme: MachReportTheme;
-    messages: MachReportMessages;
-    logger: MachReportLogger;
-};
-declare const SILENT_LOGGER: MachReportLogger;
-export { SILENT_LOGGER };
-export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
-/** theme 对象 → CSS 自定义属性 style 对象（注入组件外壳） */
-export declare function themeToCssVars(theme: Partial<MachReportTheme>): CSSProperties;
-type ConfigRef = ComputedRef<MachReportConfig | null>;
-/**
- * 路由/布局级响应式叠加：就近提供配置层（如某路由关闭导出按钮）。
- * 与应用级 config 合并（本层 defaults/presets 优先）。
- */
-export declare function provideMachReportConfig(overlay: MachReportConfig | MachReportDefaults): void;
-/** 组件内部读取当前生效配置层（未提供时返回 null → 走内置缺省） */
-export declare function useMachReportConfig(): ConfigRef;

package/dist/vue/controller.d.ts

@@ -1,29 +0,0 @@
-/**
- * ReportPreview 的编程式控制器（与组件 ref 方法同面）：
- * reload / print / exportAs / openPdfWindow / gotoPage / setParams。
- */
-export interface MachReportController {
-    reload(): Promise<void>;
-    print(): Promise<void>;
-    /** 支持 html/pdf/xlsx/png/word（excel/image/doc 为兼容别名）；未知格式报 export 错误。 */
-    exportAs(format: string): void;
-    openPdfWindow(): void;
-    gotoPage(page: number): void;
-    /** 编程式设置参数并查询（合并进面板值；opts.reload=false 仅设值不重载） */
-    setParams(values: Record<string, string>, opts?: {
-        reload?: boolean;
-    }): 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;

package/dist/vue/errors.d.ts

@@ -1,16 +0,0 @@
-/**
- * 结构化错误（code 分类，宿主可按码决定 UX：重试 / 提示 / 降级）。
- * error 事件契约保持 `(message: string)` 不变，新增第二参数 detail（可选）。
- */
-export type MachReportErrorCode = "param" | "fetch" | "validate" | "render" | "pdf" | "print" | "export" | "config";
-export declare class MachReportError extends Error {
-    readonly code: MachReportErrorCode;
-    readonly cause?: unknown;
-    constructor(code: MachReportErrorCode, message: string, cause?: unknown);
-}
-/** error 事件第二参数的形状（向后兼容：仅监听 message 的旧用法不受影响） */
-export interface MachReportErrorDetail {
-    code: MachReportErrorCode;
-    cause?: unknown;
-}
-export declare function toErrorDetail(error: unknown): MachReportErrorDetail;

package/dist/vue/injection-keys.d.ts

@@ -1,14 +0,0 @@
-import { ComputedRef, InjectionKey } from 'vue';
-import { PlanFetcher } from './adapters';
-import { PdfExporter } from './pdf-exporter';
-import { MachReportConfig } from './config';
-import { MachReportController } from './controller';
-/**
- * 注入 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 const MACH_REPORT_CONFIG_KEY: InjectionKey<ComputedRef<MachReportConfig | null>>;
-export declare const MACH_REPORT_CONTROLLER_KEY: InjectionKey<MachReportController>;

package/dist/vue/local-adapter.d.ts

@@ -1,12 +0,0 @@
-import { ReportTemplate } from '@agile-team/mach-report';
-import { PlanFetcher } from './adapters';
-export interface LocalTemplateEntry {
-    tempId: string;
-    template: ReportTemplate;
-    datasets?: Record<string, Record<string, unknown>[]>;
-}
-/**
- * 本地渲染适配器：模板 + 数据 → core 分页引擎 → RenderPlan。
- * 用于离线预览、单测与 jh4j 后端不可用场景（单真相源验证）。
- */
-export declare function createLocalFetcher(entries: Record<string, LocalTemplateEntry>): PlanFetcher;

package/dist/vue/pdf-exporter.d.ts

@@ -1,13 +0,0 @@
-import { RenderPlan } from '@agile-team/mach-report';
-/** PDF 导出器：RenderPlan → PDF 字节；第二参数可上报非致命保真告警。 */
-export type PdfExporter = (plan: RenderPlan, onWarning?: (message: string) => void) => Promise<Uint8Array>;
-export interface DefaultPdfExporterOptions {
-    /** 中文字体 URL（浏览器 fetch）；空串跳过字体加载（西文报表） */
-    fontUrl: string;
-}
-/**
- * 默认 PDF 导出器：
- * - 懒加载 @agile-team/mach-report/pdf（含 pdf-lib，只在首次导出时进 bundle）
- * - 字体走 IndexedDB 持久缓存（loadFontWithCache，二次导出零网络）
- */
-export declare function createDefaultPdfExporter(options?: DefaultPdfExporterOptions): PdfExporter;