@agile-team/mach-report 2.15.0 → 2.16.0

package/dist/{textwrap-DE1kgcJB.js → textwrap-BEIg2w8y.js}

@@ -1,4 +1,4 @@
-import { D as M } from "./defaults-DXhiM1ZD.js";
+import { D as M } from "./style-67OqfNed.js";
 const d = /[\u3000-\u9fff\uff00-\uffef]/, s = new Uint8Array(128);
 {
   for (const t of "iljtf.,:;'`|!()[]") s[t.charCodeAt(0)] = 1;

package/dist/textwrap-BI-yJ6Wt.cjs

@@ -0,0 +1,4 @@
+"use strict";const w=require("./style-C22Pbv3T.cjs"),M=/[\u3000-\u9fff\uff00-\uffef]/,s=new Uint8Array(128);{for(const t of"iljtf.,:;'`|!()[]")s[t.charCodeAt(0)]=1;for(const t of"mwMW@")s[t.charCodeAt(0)]=2;for(let t=48;t<=57;t++)s[t]=3;for(let t=65;t<=90;t++)s[t]=4;s[32]=5}const g=[.54,.26,.95,.59,.67,.3];function d(t){const e=t.charCodeAt(0);return e<128?g[s[e]]:M.test(t)?1:/[A-Z]/.test(t)?.67:.54}const o={measureMm(t,e){const{fontSizePt:i,bold:c=!1,letterSpacingPt:u=0}=e,r=25.4/72;let n=0;for(const h of t)n+=d(h);return c&&(n*=1.04),(n*i+u*Math.max(0,Array.from(t).length-1))*r}};function p(){return o}function A(t,e){return o.measureMm(t,e)}function x(t){let e;return{measureMm(i,c){if(e===void 0&&(e=t()),!e)return o.measureMm(i,c);const u=c.fontSizePt*96/72;e.font=`${c.italic?"italic ":""}${c.bold?"bold ":""}${u}px ${c.fontFamily??w.DEFAULT_FONT_FAMILY}`,"letterSpacing"in e&&(e.letterSpacing="0px");const r=(c.letterSpacingPt??0)*Math.max(0,Array.from(i).length-1);return e.measureText(i).width*25.4/96+r*25.4/72}}}function T(t,e,i){const c=[];let u="";const r=()=>{u&&(c.push({text:u,widthMm:i.measureMm(u,e),cjk:!1}),u="")};for(const n of t){if(n===`
+`){r(),c.push({text:`
+`,widthMm:0,cjk:!1,br:!0});continue}if(n===" "){r(),c.push({text:n,widthMm:i.measureMm(n,e),cjk:!1,space:!0});continue}if(M.test(n)){r(),c.push({text:n,widthMm:i.measureMm(n,e),cjk:!0});continue}u+=n}return r(),c}function S(t,e,i,c=o){if(!t)return[""];t=t.replace(/\r\n?/g,`
+`);const u=[];let r="",n=0;const h=(i.letterSpacingPt??0)*25.4/72,a=()=>{u.push(r),r="",n=0};for(const f of T(t,i,c)){if(f.br){a();continue}const m=r.length>0?h:0;if(n+m+f.widthMm<=e){r+=f.text,n+=m+f.widthMm;continue}if(f.space){a();continue}if(f.cjk){r.length>0&&a(),r=f.text,n=f.widthMm;continue}if(r.length>0&&a(),f.widthMm<=e){r=f.text,n=f.widthMm;continue}for(const l of f.text)c.measureMm(r+l,i)>e&&r.length>0&&a(),r+=l,n=c.measureMm(r,i)}return a(),u}exports.charWidthEm=d;exports.createCanvasMeasurer=x;exports.createHeuristicMeasurer=p;exports.heuristicMeasurer=o;exports.measureTextMm=A;exports.wrapText=S;

package/dist/vue/async.d.cts

@@ -36,6 +36,14 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMedia
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
 /** Serializable symbol settings. Encoders remain in the optional /codes entry. */
 declare interface CodeOptions {
     /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
@@ -363,6 +371,8 @@ declare interface FormulaAdapter {
     }): unknown;
 }
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -386,6 +396,8 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_2[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -409,6 +421,8 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_3[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -705,6 +719,8 @@ declare interface MachReportConfig {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
+    /** Small encodes stay local; optional Worker isolation uses the same prepared plan for large output. */
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
@@ -1118,6 +1134,8 @@ declare interface PdfExporter {
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
     checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+    /** Optional resource preparation for isolated encoding; custom exporters without it keep their own pipeline. */
+    prepare?: (signal?: AbortSignal) => Promise<ReportPdfFontOptions>;
 }
 declare interface PdfFontCheckResult {
     status: PdfFontStatus;
@@ -1606,8 +1624,36 @@ declare interface ReportEmptyState {
     title?: string;
     description?: string;
 }
+declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
 declare type ReportExpression = {
     field: string;
 } | {
@@ -1787,6 +1833,17 @@ declare interface ReportParamOptionsMessages {
     paramOptionsDependencies?: string;
     paramOptionsClear?: string;
 }
+/** Licensed local font bytes; never downloaded implicitly by the runtime. */
+declare interface ReportPdfFontOptions {
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    customFontFaces?: {
+        regular: Uint8Array | ArrayBuffer;
+        bold?: Uint8Array | ArrayBuffer;
+        italic?: Uint8Array | ArrayBuffer;
+        boldItalic?: Uint8Array | ArrayBuffer;
+    };
+}
 declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -1878,6 +1935,15 @@ declare interface ReportQueryResult {
     diagnostics?: ReportDiagnostic[];
 }
 declare type ReportRegistry = Record<string, ReportDefinition>;
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
 declare interface ReportSaveInput extends ReportLoadContext {
     requestId: string;
     expectedRevision?: string;

package/dist/vue/async.d.ts

@@ -36,6 +36,14 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMedia
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
 /** Serializable symbol settings. Encoders remain in the optional /codes entry. */
 declare interface CodeOptions {
     /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
@@ -363,6 +371,8 @@ declare interface FormulaAdapter {
     }): unknown;
 }
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -386,6 +396,8 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_2[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -409,6 +421,8 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_3[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -705,6 +719,8 @@ declare interface MachReportConfig {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 declare interface MachReportDefaults {
+    /** Small encodes stay local; optional Worker isolation uses the same prepared plan for large output. */
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
@@ -1118,6 +1134,8 @@ declare interface PdfExporter {
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
     checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+    /** Optional resource preparation for isolated encoding; custom exporters without it keep their own pipeline. */
+    prepare?: (signal?: AbortSignal) => Promise<ReportPdfFontOptions>;
 }
 declare interface PdfFontCheckResult {
     status: PdfFontStatus;
@@ -1606,8 +1624,36 @@ declare interface ReportEmptyState {
     title?: string;
     description?: string;
 }
+declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
 declare type ReportExpression = {
     field: string;
 } | {
@@ -1787,6 +1833,17 @@ declare interface ReportParamOptionsMessages {
     paramOptionsDependencies?: string;
     paramOptionsClear?: string;
 }
+/** Licensed local font bytes; never downloaded implicitly by the runtime. */
+declare interface ReportPdfFontOptions {
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    customFontFaces?: {
+        regular: Uint8Array | ArrayBuffer;
+        bold?: Uint8Array | ArrayBuffer;
+        italic?: Uint8Array | ArrayBuffer;
+        boldItalic?: Uint8Array | ArrayBuffer;
+    };
+}
 declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -1878,6 +1935,15 @@ declare interface ReportQueryResult {
     diagnostics?: ReportDiagnostic[];
 }
 declare type ReportRegistry = Record<string, ReportDefinition>;
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
 declare interface ReportSaveInput extends ReportLoadContext {
     requestId: string;
     expectedRevision?: string;

package/dist/vue/index.d.cts

@@ -74,6 +74,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -244,6 +248,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -325,6 +333,7 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     showPdfWindow: boolean;
     showSettings: boolean;
     showParams: boolean;
+    exportExecution: ReportExportExecutionOptions;
     drill: ReportDrillOptions;
     loadParamOptions: ReportParamOptionsLoader;
     printOptions: ReportPrintOptions;
@@ -496,6 +505,14 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMedia
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
 /** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
 export declare function buildPrintDocument(p: RenderPlan, options?: ReportPrintOptions): PrintHtmlResult;
 export declare function buildWordHtml(p: RenderPlan): {
@@ -907,6 +924,8 @@ declare interface FormulaAdapter {
     }): unknown;
 }
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -930,6 +949,8 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_2[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -953,6 +974,8 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_3[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -1422,6 +1445,8 @@ export declare interface MachReportController {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 export declare interface MachReportDefaults {
+    /** Small encodes stay local; optional Worker isolation uses the same prepared plan for large output. */
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
@@ -1909,6 +1934,8 @@ export declare interface PdfExporter {
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
     checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+    /** Optional resource preparation for isolated encoding; custom exporters without it keep their own pipeline. */
+    prepare?: (signal?: AbortSignal) => Promise<ReportPdfFontOptions>;
 }
 export declare interface PdfFontCheckResult {
     status: PdfFontStatus;
@@ -2110,6 +2137,16 @@ declare interface PlanTableFragment_3 {
 }
 /** Bounded concurrency, one stage timeout, and cancellation even for a hanging decoder. */
 export declare function preparePrintResources(doc: Document, options?: ReportPrintOptions, signal?: AbortSignal, base?: string): Promise<void>;
+declare interface PreviewEncoding {
+    pdf(plan: RenderPlan, exporter: PdfExporter, warning: (message: string) => void, task?: PreviewEncodingTask): Promise<Uint8Array>;
+    xlsx(plan: RenderPlan, options: XlsxRenderOptions, task: PreviewEncodingTask): Promise<{
+        buffer: Uint8Array;
+        warnings: string[];
+    }>;
+}
+declare type PreviewEncodingTask = OutputTaskOptions_2 & {
+    onDiagnostic?: (entry: OutputDiagnostic) => void;
+};
 export declare function printCalibration(options?: ReportPrintOptions): {
     x: number;
     y: number;
@@ -2462,8 +2499,36 @@ export declare interface ReportEmptyState {
     title?: string;
     description?: string;
 }
+export declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+export declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 export declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+export declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
 declare type ReportExpression = {
     field: string;
 } | {
@@ -2708,11 +2773,22 @@ export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     "onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
 }>, {
     disabled: boolean;
-    loadOptions: ReportParamOptionsLoader;
     issues: readonly ReportParamIssue[];
+    loadOptions: ReportParamOptionsLoader;
     showActions: boolean;
     showTitle: boolean;
 }>;
+/** Licensed local font bytes; never downloaded implicitly by the runtime. */
+declare interface ReportPdfFontOptions {
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    customFontFaces?: {
+        regular: Uint8Array | ArrayBuffer;
+        bold?: Uint8Array | ArrayBuffer;
+        italic?: Uint8Array | ArrayBuffer;
+        boldItalic?: Uint8Array | ArrayBuffer;
+    };
+}
 export declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -2811,6 +2887,15 @@ declare interface ReportQueryResult {
     diagnostics?: ReportDiagnostic[];
 }
 declare type ReportRegistry = Record<string, ReportDefinition>;
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
 declare interface ReportSaveInput extends ReportLoadContext {
     requestId: string;
     expectedRevision?: string;
@@ -2928,6 +3013,7 @@ declare type ReportValueState_2 = "missing-source" | "not-applicable" | "not-cal
 export declare function resolveCalculationMessages(messages: Partial<ReportCalculationMessages>): ReportCalculationMessages;
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
 export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showSettings" | "showParams" | "gapPx">> & {
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     pdfFontUrl: string;
@@ -3187,6 +3273,8 @@ export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     /** Flush the active editor and await source-backed calculation/persistence before capturing the output plan. */
     beforeOutput?: () => boolean | Promise<boolean>;
     getPdfExporter: () => PdfExporter;
+    /** Optional prepared-plan encoders; legacy callers keep their injected exporter unchanged. */
+    encoding?: PreviewEncoding;
     onError: (message: string, code?: string) => void;
     onWarning?: (message: string) => void;
     onBusy?: (format: string | null) => void;

package/dist/vue/index.d.ts

@@ -74,6 +74,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -244,6 +248,10 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
         type: PropType<ReportOutputOptions>;
         default: undefined;
     };
+    exportExecution: {
+        type: PropType<ReportExportExecutionOptions>;
+        default: undefined;
+    };
     assets: {
         type: PropType<AssetRenderOptions>;
         default: undefined;
@@ -325,6 +333,7 @@ declare const __VLS_component: DefineComponent<ExtractPropTypes<{
     showPdfWindow: boolean;
     showSettings: boolean;
     showParams: boolean;
+    exportExecution: ReportExportExecutionOptions;
     drill: ReportDrillOptions;
     loadParamOptions: ReportParamOptionsLoader;
     printOptions: ReportPrintOptions;
@@ -496,6 +505,14 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMedia
     assetFailure?: "throw" | "placeholder";
     signal?: AbortSignal;
 }
+declare interface BrowserReportWorker {
+    postMessage(value: unknown, transfer?: Transferable[]): void;
+    terminate(): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    addEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "error" | "messageerror", listener: (event: Event) => void): void;
+}
 /** 供 HTML/Word 导出的完整文档；打印路径逐页渲染，避免预先生成所有页。 */
 export declare function buildPrintDocument(p: RenderPlan, options?: ReportPrintOptions): PrintHtmlResult;
 export declare function buildWordHtml(p: RenderPlan): {
@@ -907,6 +924,8 @@ declare interface FormulaAdapter {
     }): unknown;
 }
 declare interface GridCell {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -930,6 +949,8 @@ declare interface GridCell {
     style?: ComponentStyle;
 }
 declare interface GridCell_2 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_2[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -953,6 +974,8 @@ declare interface GridCell_2 {
     style?: ComponentStyle_2;
 }
 declare interface GridCell_3 {
+    /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
+    richParagraphs?: RichParagraph_3[];
     text?: string;
     rawText?: string;
     /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
@@ -1422,6 +1445,8 @@ export declare interface MachReportController {
 }
 /** defaults 层可配置项（全部可选，均有内置缺省） */
 export declare interface MachReportDefaults {
+    /** Small encodes stay local; optional Worker isolation uses the same prepared plan for large output. */
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     printOptions?: ReportPrintOptions;
@@ -1909,6 +1934,8 @@ export declare interface PdfExporter {
     }): Promise<Uint8Array>;
     /** 可选轻量字体检查；旧版自定义导出函数无需实现。取消时拒绝 AbortError。 */
     checkFont?: (signal?: AbortSignal) => Promise<PdfFontCheckResult>;
+    /** Optional resource preparation for isolated encoding; custom exporters without it keep their own pipeline. */
+    prepare?: (signal?: AbortSignal) => Promise<ReportPdfFontOptions>;
 }
 export declare interface PdfFontCheckResult {
     status: PdfFontStatus;
@@ -2110,6 +2137,16 @@ declare interface PlanTableFragment_3 {
 }
 /** Bounded concurrency, one stage timeout, and cancellation even for a hanging decoder. */
 export declare function preparePrintResources(doc: Document, options?: ReportPrintOptions, signal?: AbortSignal, base?: string): Promise<void>;
+declare interface PreviewEncoding {
+    pdf(plan: RenderPlan, exporter: PdfExporter, warning: (message: string) => void, task?: PreviewEncodingTask): Promise<Uint8Array>;
+    xlsx(plan: RenderPlan, options: XlsxRenderOptions, task: PreviewEncodingTask): Promise<{
+        buffer: Uint8Array;
+        warnings: string[];
+    }>;
+}
+declare type PreviewEncodingTask = OutputTaskOptions_2 & {
+    onDiagnostic?: (entry: OutputDiagnostic) => void;
+};
 export declare function printCalibration(options?: ReportPrintOptions): {
     x: number;
     y: number;
@@ -2462,8 +2499,36 @@ export declare interface ReportEmptyState {
     title?: string;
     description?: string;
 }
+export declare interface ReportExportDecision {
+    mode: "local" | "worker";
+    reason: ReportExportDecisionReason;
+    /** Lower bounds: traversal stops as soon as isolation is warranted. No font or image hashing. */
+    estimate: {
+        pages: number;
+        cells: number;
+        bytes: number;
+    };
+    hardCancellation: boolean;
+}
+declare type ReportExportDecisionReason = "small-task" | "threshold" | "scan-limit" | "explicit-local" | "explicit-worker" | "worker-unavailable" | "worker-start-failed" | "nonserializable-options";
+export declare interface ReportExportExecutionOptions {
+    mode?: "auto" | "worker" | "local";
+    /** A fresh bundler-managed module Worker for every call; never a shared worker. */
+    workerFactory?: () => BrowserReportWorker;
+    thresholds?: ReportExportThresholds;
+    /** Auto only. Startup unavailability may use local; encoding failures never retry. */
+    fallback?: "local" | "error";
+    timeoutMs?: number;
+    budget?: ReportRuntimeBudget;
+    onDecision?: (decision: ReportExportDecision) => void;
+}
 /** 输出能力仍由宿主授权；工具偏好只决定当前预览实例的可见与启用状态。 */
 export declare type ReportExportFormat = "html" | "pdf" | "xlsx" | "png" | "word";
+export declare interface ReportExportThresholds {
+    cells?: number;
+    pages?: number;
+    bytes?: number;
+}
 declare type ReportExpression = {
     field: string;
 } | {
@@ -2708,11 +2773,22 @@ export declare const ReportParamPanel: DefineComponent<__VLS_Props_3, {
     "onUpdate:modelValue"?: ((value: Record<string, string>) => any) | undefined;
 }>, {
     disabled: boolean;
-    loadOptions: ReportParamOptionsLoader;
     issues: readonly ReportParamIssue[];
+    loadOptions: ReportParamOptionsLoader;
     showActions: boolean;
     showTitle: boolean;
 }>;
+/** Licensed local font bytes; never downloaded implicitly by the runtime. */
+declare interface ReportPdfFontOptions {
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    customFontFaces?: {
+        regular: Uint8Array | ArrayBuffer;
+        bold?: Uint8Array | ArrayBuffer;
+        italic?: Uint8Array | ArrayBuffer;
+        boldItalic?: Uint8Array | ArrayBuffer;
+    };
+}
 export declare interface ReportPreferencesAdapter {
     load(key: string): Partial<ReportPreviewPreferences> | null | Promise<Partial<ReportPreviewPreferences> | null>;
     save(key: string, value: Readonly<Partial<ReportPreviewPreferences>>): void | Promise<void>;
@@ -2811,6 +2887,15 @@ declare interface ReportQueryResult {
     diagnostics?: ReportDiagnostic[];
 }
 declare type ReportRegistry = Record<string, ReportDefinition>;
+declare interface ReportRuntimeBudget {
+    maxRows?: number;
+    maxPages?: number;
+    maxCells?: number;
+    maxOutputBytes?: number;
+    /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
+    maxPreparedBytes?: number;
+    maxDurationMs?: number;
+}
 declare interface ReportSaveInput extends ReportLoadContext {
     requestId: string;
     expectedRevision?: string;
@@ -2928,6 +3013,7 @@ declare type ReportValueState_2 = "missing-source" | "not-applicable" | "not-cal
 export declare function resolveCalculationMessages(messages: Partial<ReportCalculationMessages>): ReportCalculationMessages;
 export declare function resolveConfig(config: MachReportConfig | null | undefined, presetName?: string): ResolvedConfig;
 export declare type ResolvedConfig = Required<Pick<MachReportDefaults, "showExport" | "showPrint" | "showPdfWindow" | "showSettings" | "showParams" | "gapPx">> & {
+    exportExecution?: ReportExportExecutionOptions;
     drill?: ReportDrillOptions;
     loadParamOptions?: ReportParamOptionsLoader;
     pdfFontUrl: string;
@@ -3187,6 +3273,8 @@ export declare function usePrintExport(plan: Ref<RenderPlan | null>, hooks: {
     /** Flush the active editor and await source-backed calculation/persistence before capturing the output plan. */
     beforeOutput?: () => boolean | Promise<boolean>;
     getPdfExporter: () => PdfExporter;
+    /** Optional prepared-plan encoders; legacy callers keep their injected exporter unchanged. */
+    encoding?: PreviewEncoding;
     onError: (message: string, code?: string) => void;
     onWarning?: (message: string) => void;
     onBusy?: (format: string | null) => void;

package/dist/vue-async.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-DHO7X8z2.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-DbLvvOUT.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){r.machReportPlugin.install(e,o)}};exports.MachReportPreview=r.MachReportPreview;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=i;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const r=require("./plugin-Dr39GBRG.cjs");function i(){return Promise.resolve().then(()=>require("./ReportPreview-Bk9nLfO9.cjs")).then(e=>e.ReportPreview$1)}const t={install(e,o={}){r.machReportPlugin.install(e,o)}};exports.MachReportPreview=r.MachReportPreview;exports.default=t;exports.machReportAsyncPlugin=t;exports.preloadMachReport=i;