@agile-team/mach-report 0.4.0 → 0.5.0

package/dist/pdf.d.cts

@@ -0,0 +1,33 @@
+import { T as TextMeasurer, R as RenderPlan } from './textwrap-DWzM7pt1.js';
+
+interface PdfRenderOptions {
+    /** 嵌入字体字节（TTF，如黑体）；缺省用 Helvetica（不支持 CJK） */
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    /** 文本测量器（默认启发式；与分页/Canvas 注入同一实例可消除折行差异） */
+    measurer?: TextMeasurer;
+}
+/**
+ * PDF 文档句柄（不透明最小面）：结构化仅暴露 save()，
+ * 避免在公共类型面泄漏 pdf-lib 类型（引擎保持零运行时依赖声明）。
+ */
+type PdfDocumentHandle = {
+    save(): Promise<Uint8Array>;
+};
+interface PdfRenderResult {
+    pdfDoc: PdfDocumentHandle;
+    bytes: Uint8Array;
+    pageErrors: string[];
+    unsupportedTextCount: number;
+    /** 保真度降级清单（富文本转纯文本、图片格式不支持等），供上层提示 */
+    fidelityWarnings: string[];
+}
+declare function renderPlanToPdf(plan: RenderPlan, options?: PdfRenderOptions): Promise<PdfRenderResult>;
+
+/**
+ * 字体加载（IndexedDB 持久缓存 + 内存缓存）：
+ * 中文字体体积大（simhei ~9MB），首次 fetch 后缓存，后续导出零网络等待。
+ */
+declare function loadFontWithCache(url: string): Promise<Uint8Array | null>;
+
+export { type PdfDocumentHandle, type PdfRenderOptions, type PdfRenderResult, loadFontWithCache, renderPlanToPdf };

package/dist/pdf.d.ts

@@ -1,6 +1,33 @@
+import { T as TextMeasurer, R as RenderPlan } from './textwrap-DWzM7pt1.js';
+
+interface PdfRenderOptions {
+    /** 嵌入字体字节（TTF，如黑体）；缺省用 Helvetica（不支持 CJK） */
+    customFontBytes?: Uint8Array | ArrayBuffer;
+    customFontName?: string;
+    /** 文本测量器（默认启发式；与分页/Canvas 注入同一实例可消除折行差异） */
+    measurer?: TextMeasurer;
+}
 /**
- * PDF 直出子路径入口（@agile-team/mach-report/pdf）：
- * 矢量 PDF 生成 + 字体缓存。pdf-lib 为常规依赖，
- * 仅当导入本子路径或触发懒加载导出时才进入产物图。
+ * PDF 文档句柄（不透明最小面）：结构化仅暴露 save()，
+ * 避免在公共类型面泄漏 pdf-lib 类型（引擎保持零运行时依赖声明）。
  */
-export * from "./pdf/index";
+type PdfDocumentHandle = {
+    save(): Promise<Uint8Array>;
+};
+interface PdfRenderResult {
+    pdfDoc: PdfDocumentHandle;
+    bytes: Uint8Array;
+    pageErrors: string[];
+    unsupportedTextCount: number;
+    /** 保真度降级清单（富文本转纯文本、图片格式不支持等），供上层提示 */
+    fidelityWarnings: string[];
+}
+declare function renderPlanToPdf(plan: RenderPlan, options?: PdfRenderOptions): Promise<PdfRenderResult>;
+
+/**
+ * 字体加载（IndexedDB 持久缓存 + 内存缓存）：
+ * 中文字体体积大（simhei ~9MB），首次 fetch 后缓存，后续导出零网络等待。
+ */
+declare function loadFontWithCache(url: string): Promise<Uint8Array | null>;
+
+export { type PdfDocumentHandle, type PdfRenderOptions, type PdfRenderResult, loadFontWithCache, renderPlanToPdf };