@agile-team/mach-report 2.9.1 → 2.11.0

package/dist/pdf.d.cts

@@ -17,6 +17,8 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions {
     signal?: AbortSignal;
 }
 
+export declare function clearFontCache(): Promise<void>;
+
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -53,6 +55,9 @@ declare interface ComponentStyle {
     rotateDeg?: number;
 }
 
+/** Global optional cache tuning; fixed-font integrations use bounded defaults without configuration. */
+export declare function configureFontCache(options: FontCacheOptions): void;
+
 /** Exact font-byte width adapter. Import from /pdf to keep fontkit outside the core bundle. */
 export declare function createFontBytesMeasurer(options: FontBytesMeasureOptions): TextMeasurer_2;
 
@@ -66,11 +71,29 @@ export declare interface FontBytesMeasureOptions {
     fallback?: TextMeasurer_2;
 }
 
+export declare interface FontCacheOptions {
+    maxFonts?: number;
+    maxBytes?: number;
+    maxFontBytes?: number;
+}
+
+export declare interface FontCacheStats {
+    fonts: number;
+    bytes: number;
+    maxFonts: number;
+    maxBytes: number;
+    maxFontBytes: number;
+}
+
 export declare interface FontLoadOptions {
     /** 校验字体格式与可解析结构，失败抛出带 cause 的诊断；默认保留旧 API 的 null 降级。 */
     strict?: boolean;
+    /** Cancels this subscriber without aborting another subscriber sharing the same URL. */
+    signal?: AbortSignal;
 }
 
+export declare function getFontCacheStats(): FontCacheStats;
+
 declare interface GridCell {
     text?: string;
     rawText?: string;
@@ -78,11 +101,15 @@ declare interface GridCell {
     value?: string | number | boolean | null;
     /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
     numberFormat?: string;
+    /** Physical left inset for hierarchical labels; raw value stays unchanged. */
+    indentMm?: number;
     /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
     source?: ReportCellSource;
+    /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
+    derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
     formula?: string;
     children?: PlanComponent[];
@@ -93,7 +120,7 @@ declare interface GridCell {
 
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
 
-/** 删除已知无效的字体缓存；供字体解析失败后修正同 URL 并重试。 */
+/** Invalidating or clearing also fences late downloads from repopulating the cache. */
 export declare function invalidateFontCache(url: string): Promise<void>;
 
 /**
@@ -200,6 +227,7 @@ declare interface PlanGrid {
 }
 
 declare interface PlanPage {
+    meta?: Record<string, unknown>;
     /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
     layout?: "page" | "wide";
     pageWidthMm: number;
@@ -230,6 +258,8 @@ declare interface PlanTableFragment {
 
 declare interface RenderPlan {
     schemaVersion: string;
+    /** 编辑需要模板重算上下文；跨 Worker/JSON 保留要求，但不声明本地会话可用。 */
+    requiresRecalculation?: boolean;
     pages: PlanPage[];
 }
 

package/dist/pdf.d.ts

@@ -17,6 +17,8 @@ declare interface AssetRenderOptions extends OutputDiagnosticOptions {
     signal?: AbortSignal;
 }
 
+export declare function clearFontCache(): Promise<void>;
+
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -53,6 +55,9 @@ declare interface ComponentStyle {
     rotateDeg?: number;
 }
 
+/** Global optional cache tuning; fixed-font integrations use bounded defaults without configuration. */
+export declare function configureFontCache(options: FontCacheOptions): void;
+
 /** Exact font-byte width adapter. Import from /pdf to keep fontkit outside the core bundle. */
 export declare function createFontBytesMeasurer(options: FontBytesMeasureOptions): TextMeasurer_2;
 
@@ -66,11 +71,29 @@ export declare interface FontBytesMeasureOptions {
     fallback?: TextMeasurer_2;
 }
 
+export declare interface FontCacheOptions {
+    maxFonts?: number;
+    maxBytes?: number;
+    maxFontBytes?: number;
+}
+
+export declare interface FontCacheStats {
+    fonts: number;
+    bytes: number;
+    maxFonts: number;
+    maxBytes: number;
+    maxFontBytes: number;
+}
+
 export declare interface FontLoadOptions {
     /** 校验字体格式与可解析结构，失败抛出带 cause 的诊断；默认保留旧 API 的 null 降级。 */
     strict?: boolean;
+    /** Cancels this subscriber without aborting another subscriber sharing the same URL. */
+    signal?: AbortSignal;
 }
 
+export declare function getFontCacheStats(): FontCacheStats;
+
 declare interface GridCell {
     text?: string;
     rawText?: string;
@@ -78,11 +101,15 @@ declare interface GridCell {
     value?: string | number | boolean | null;
     /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
     numberFormat?: string;
+    /** Physical left inset for hierarchical labels; raw value stays unchanged. */
+    indentMm?: number;
     /** 编辑输入类型；省略时只按原始值推断，数字字符串不会被转换为数值。 */
     valueType?: "text" | "number" | "boolean";
     /** 单元格级编辑控制；预览仍需显式开启 editing。 */
     editable?: boolean;
     source?: ReportCellSource;
+    /** SDK 派生结果不映射业务来源，始终只读（包括覆盖同名源字段的计算）。 */
+    derived?: boolean;
     /** Excel 公式保留元数据；当前引擎不计算公式，公式格始终只读。 */
     formula?: string;
     children?: PlanComponent[];
@@ -93,7 +120,7 @@ declare interface GridCell {
 
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
 
-/** 删除已知无效的字体缓存；供字体解析失败后修正同 URL 并重试。 */
+/** Invalidating or clearing also fences late downloads from repopulating the cache. */
 export declare function invalidateFontCache(url: string): Promise<void>;
 
 /**
@@ -200,6 +227,7 @@ declare interface PlanGrid {
 }
 
 declare interface PlanPage {
+    meta?: Record<string, unknown>;
     /** wide 表示完整自然列宽；页面仅为预览的垂直窗口分段。 */
     layout?: "page" | "wide";
     pageWidthMm: number;
@@ -230,6 +258,8 @@ declare interface PlanTableFragment {
 
 declare interface RenderPlan {
     schemaVersion: string;
+    /** 编辑需要模板重算上下文；跨 Worker/JSON 保留要求，但不声明本地会话可用。 */
+    requiresRecalculation?: boolean;
     pages: PlanPage[];
 }