@agile-team/mach-report 2.13.0 → 2.15.0

package/dist/pdf.d.cts

@@ -9,7 +9,7 @@ declare interface AssetRenderBudget {
     maxDurationMs?: number;
 }
 
-declare interface AssetRenderOptions extends OutputDiagnosticOptions {
+declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
@@ -164,6 +164,19 @@ declare interface GridCell {
 
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+export declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 /** Invalidating or clearing also fences late downloads from repopulating the cache. */
 export declare function invalidateFontCache(url: string): Promise<void>;
 
@@ -175,7 +188,7 @@ export declare function invalidateFontCache(url: string): Promise<void>;
 export declare function loadFontWithCache(url: string, options?: FontLoadOptions): Promise<Uint8Array | null>;
 
 declare interface OutputDiagnostic {
-    code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
     severity: "warning";
     format: OutputFormat;
     pageIndex: number;
@@ -210,7 +223,7 @@ export declare type PdfDocumentHandle = {
     save(): Promise<Uint8Array>;
 };
 
-export declare interface PdfRenderOptions extends AssetRenderOptions, OutputTaskOptions {
+export declare interface PdfRenderOptions extends AssetRenderOptions, OutputTaskOptions, ImageMediaOptions {
     /** 嵌入字体字节（TTF，如黑体）；缺省用 Helvetica（不支持 CJK） */
     customFontBytes?: Uint8Array | ArrayBuffer;
     customFontName?: string;
@@ -315,6 +328,8 @@ export declare function renderPlanToPdf(plan: RenderPlan, options?: PdfRenderOpt
 
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;

package/dist/pdf.d.ts

@@ -9,7 +9,7 @@ declare interface AssetRenderBudget {
     maxDurationMs?: number;
 }
 
-declare interface AssetRenderOptions extends OutputDiagnosticOptions {
+declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
@@ -164,6 +164,19 @@ declare interface GridCell {
 
 declare type ImageComponentKind = "image" | "chart" | "barcode" | "qrcode";
 
+/** Bounded binary image inspection shared by PDF, Excel and template import. No decoder is loaded. */
+export declare interface ImageMediaOptions {
+    maxImageBytes?: number;
+    maxTotalImageBytes?: number;
+    maxImages?: number;
+    /** Decoded pixels per unique image, default 16 million. */
+    maxImagePixels?: number;
+    /** Total decoded pixels for unique media, default 64 million. */
+    maxTotalImagePixels?: number;
+    /** Maximum source dimension, default 16384 pixels. */
+    maxImageDimension?: number;
+}
+
 /** Invalidating or clearing also fences late downloads from repopulating the cache. */
 export declare function invalidateFontCache(url: string): Promise<void>;
 
@@ -175,7 +188,7 @@ export declare function invalidateFontCache(url: string): Promise<void>;
 export declare function loadFontWithCache(url: string, options?: FontLoadOptions): Promise<Uint8Array | null>;
 
 declare interface OutputDiagnostic {
-    code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
+    code: "invalid-image-data" | "image-budget-exceeded" | "component-render-failed" | "unsupported-text" | "output-degraded" | "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
     severity: "warning";
     format: OutputFormat;
     pageIndex: number;
@@ -210,7 +223,7 @@ export declare type PdfDocumentHandle = {
     save(): Promise<Uint8Array>;
 };
 
-export declare interface PdfRenderOptions extends AssetRenderOptions, OutputTaskOptions {
+export declare interface PdfRenderOptions extends AssetRenderOptions, OutputTaskOptions, ImageMediaOptions {
     /** 嵌入字体字节（TTF，如黑体）；缺省用 Helvetica（不支持 CJK） */
     customFontBytes?: Uint8Array | ArrayBuffer;
     customFontName?: string;
@@ -315,6 +328,8 @@ export declare function renderPlanToPdf(plan: RenderPlan, options?: PdfRenderOpt
 
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
+    /** Source identity across report occurrences; sharing must be explicitly declared. */
+    sourceScope?: string;
     datasetId: string;
     rowKey: string | number;
     field: string;