@agile-team/mach-report 2.16.0 → 2.18.0

package/dist/server.d.ts

@@ -22,6 +22,22 @@ declare type AggregateOperation = "sum" | "count" | "avg" | "min" | "max" | "wei
 
 declare type AggregateOperation_2 = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
 
+declare interface AggregateRequest {
+    op: AggregateOperation;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
+declare interface AggregateRequest_2 {
+    op: AggregateOperation_2;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
 declare interface AssetRenderBudget {
     /** Maximum newly rendered assets, default 1000. Existing imageData is kept unchanged. */
     maxAssets?: number;
@@ -35,6 +51,8 @@ declare interface AssetRenderBudget {
 
 declare interface AssetRenderOptions extends OutputDiagnosticOptions, ImageMediaOptions {
     assetRenderers?: Partial<Record<ImageComponentKind, ComponentImageRenderer>>;
+    /** Explicit id/version registry; unbound components continue using assetRenderers by kind. */
+    assetRegistry?: ComponentAssetRegistry;
     assetBudget?: AssetRenderBudget;
     /** Default throw prevents an incomplete export; placeholder retains the component and emits diagnostics. */
     assetFailure?: "throw" | "placeholder";
@@ -117,6 +135,45 @@ declare type ColumnFormat_2 = {
     pattern?: string;
 };
 
+declare type ColumnVisual = {
+    /** Defaults to the column field; never changes the cell's raw value or business identity. */
+    field?: string;
+    /** Numeric text requires explicit opt-in; formatting an identifier does not turn it into a measure. */
+    numeric?: "number" | "decimal";
+    min?: number;
+    max?: number;
+} & ({
+    kind: "colorScale";
+    lowColor?: string;
+    highColor?: string;
+} | {
+    kind: "dataBar";
+    color?: string;
+    negativeColor?: string;
+});
+
+declare type ColumnVisual_2 = {
+    /** Defaults to the column field; never changes the cell's raw value or business identity. */
+    field?: string;
+    /** Numeric text requires explicit opt-in; formatting an identifier does not turn it into a measure. */
+    numeric?: "number" | "decimal";
+    min?: number;
+    max?: number;
+} & ({
+    kind: "colorScale";
+    lowColor?: string;
+    highColor?: string;
+} | {
+    kind: "dataBar";
+    color?: string;
+    negativeColor?: string;
+});
+
+declare interface ComponentAssetRegistry {
+    rendererFor(component: Readonly<PlanComponent>): ComponentImageRenderer | undefined;
+    hasExtension(id: string, version: string, kind: string): boolean;
+}
+
 /** A literal own field of the current label record; expressions and paths are not evaluated. */
 declare interface ComponentBinding {
     field: string;
@@ -219,6 +276,9 @@ declare interface ComputedField_2 extends ExpressionOptions_2 {
 
 export declare function createManagerTemplateCatalog(manager: ReportTemplateManager, metadata?: (document: ReportTemplateDocument) => Pick<LocalTemplateCatalogItem, "category" | "tags">): ReportTemplateCatalogProvider;
 
+/** Bounded, single-process reference store. Scope is host-authorized identity, never a client permission. */
+export declare function createMemoryReportDocumentStore(options?: ReportDocumentBudget): ReportDocumentStore;
+
 /** Session-local intents; durable hosts should supply their own authorized stable IDs. */
 export declare function createMemoryReportInstanceIds(maximum?: number): {
     forCase(templateId: string, caseId: string): string;
@@ -270,6 +330,13 @@ export declare function createReportInstanceManager(store: ReportInstanceStore,
 /** Durable at-least-once dispatch; export/artifact handlers must be idempotent by scope+taskId. */
 export declare function createReportJobService(options: ReportJobServiceOptions): ReportJobService;
 
+/** OpenAPI 3.1 for the minimal Java/Node wire contract. Host registers routes and authorizes IDs before describe(). */
+export declare function createReportOpenApi(descriptions: readonly ReportDescription[], options?: {
+    title?: string;
+    version?: string;
+    basePath?: string;
+}): Record<string, unknown>;
+
 /** 无 Vue、无 HTTP 框架的可选服务端外观；PDF/Excel 仅在对应 export 调用时加载。 */
 export declare function createReportRuntime(options: ReportRuntimeOptions): ReportRuntime;
 
@@ -342,6 +409,12 @@ declare interface FormulaAdapter {
 }
 
 declare interface GridCell {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph[];
     text?: string;
@@ -368,6 +441,12 @@ declare interface GridCell {
 }
 
 declare interface GridCell_2 {
+    /** Resolved visual only. Original value, text, editability and source are unchanged. */
+    dataBar?: {
+        start: number;
+        end: number;
+        color: string;
+    };
     /** Styled cell content; text remains a plain-text fallback. Imported rich cells are read-only. */
     richParagraphs?: RichParagraph_2[];
     text?: string;
@@ -472,6 +551,8 @@ declare interface ListColumn {
     format?: ColumnFormat;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule[];
+    /** Optional resolved color scale or value-preserving data bar. */
+    visual?: ColumnVisual;
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
     editable?: boolean;
     /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
@@ -498,6 +579,8 @@ declare interface ListColumn_2 {
     format?: ColumnFormat_2;
     /** 条件格式规则（声明式，命中合并进单元格样式；如负数红字） */
     rules?: StyleRule_2[];
+    /** Optional resolved color scale or value-preserving data bar. */
+    visual?: ColumnVisual_2;
     /** 内容列编辑控制；仍需由预览显式开启 editing，不影响表头/小计只读规则。 */
     editable?: boolean;
     /** 空值列或特殊数据类型可显式声明编辑输入类型。 */
@@ -709,6 +792,46 @@ declare interface LocalTemplateCatalogItem {
     tags?: string[];
 }
 
+declare interface MatrixAxisOptions {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+
+declare interface MatrixAxisOptions_2 {
+    /** Display names in the same outer-to-inner order as the dimension fields. */
+    labels?: readonly string[];
+    /** Per-level sibling order; omitted levels retain first-seen order. */
+    sort?: readonly MatrixDimensionOrder_2[];
+    /** One-based prefix depths. Leaf depths are not subtotals. */
+    subtotals?: readonly number[];
+}
+
+declare type MatrixDimensionOrder = "source" | "asc" | "desc";
+
+declare type MatrixDimensionOrder_2 = "source" | "asc" | "desc";
+
+declare interface MatrixHierarchyOptions {
+    row?: MatrixAxisOptions;
+    column?: MatrixAxisOptions;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+
+declare interface MatrixHierarchyOptions_2 {
+    row?: MatrixAxisOptions_2;
+    column?: MatrixAxisOptions_2;
+    /** Only null/missing values use this label; empty strings and zero stay distinct. */
+    emptyLabel?: string;
+    subtotalLabel?: string;
+    totalLabel?: string;
+}
+
 declare interface MatrixTableOptions {
     rowFields: readonly string[];
     columnFields: readonly string[];
@@ -723,6 +846,10 @@ declare interface MatrixTableOptions {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 
 declare interface MatrixTableOptions_2 {
@@ -739,6 +866,10 @@ declare interface MatrixTableOptions_2 {
     maxColumns?: number;
     maxInputRows?: number;
     maxCells?: number;
+    /** Opt-in hierarchical dimensions, physical merged headers and prefix subtotals. */
+    hierarchy?: MatrixHierarchyOptions_2;
+    /** Hierarchical aggregate work, checked before measure reads; default 10 million updates. */
+    maxAggregateUpdates?: number;
 }
 
 export declare interface MemoryReportInstanceStoreOptions {
@@ -758,6 +889,11 @@ declare interface OutputDiagnostic {
     componentPath?: readonly number[];
     kind: string;
     nid?: string;
+    /** Declarative extension identity only; no property values or business binding data enter diagnostics. */
+    extension?: {
+        id: string;
+        version: string;
+    };
     message: string;
 }
 
@@ -785,6 +921,8 @@ declare interface PaginateOptions {
     maxPages?: number;
     /** Actual grid cells, including repeated furniture and nested children; checked before each page is appended. */
     maxCells?: number;
+    /** Shared bound-chart primitive budget, checked before expansion; default 50000, range 1..1000000. */
+    maxChartComponents?: number;
     signal?: AbortSignal;
     /** Streaming total-page anchors can skip the bounded counting pass when known. */
     knownTotalPages?: number;
@@ -797,6 +935,8 @@ declare interface PaginateOptions {
 export declare function parseReportTemplatePackage(input: unknown, options?: ReportTemplatePackageOptions): ReportTemplatePackage;
 
 declare interface PlanComponent {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -826,6 +966,8 @@ declare interface PlanComponent {
 }
 
 declare interface PlanComponent_2 {
+    /** Template-only aggregate binding, expanded into shared primitives during layout. */
+    chartBinding?: ReportChartBinding_2;
     /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
     code?: CodeOptions_2;
     /** Template-only binding; resolved and removed before constructing the output plan. */
@@ -940,6 +1082,21 @@ export declare interface PreparedReport {
 
 declare type PublicationAssets = Omit<AssetRenderOptions, "signal">;
 
+/** Progressive consumption ends at the currently committed boundary; caller may resume with nextPage. */
+export declare function readReportDocumentPages(store: ReportDocumentStore, input: {
+    scope: string;
+    id: string;
+    version: string;
+    fromPage?: number;
+    limit?: number;
+    maxBytes?: number;
+    signal?: AbortSignal;
+}): Promise<{
+    manifest: ReportDocumentManifest;
+    pages: PlanPage[];
+    nextPage: number;
+}>;
+
 declare interface RenderPlan {
     schemaVersion: string;
     /** 编辑需要模板重算上下文；跨 Worker/JSON 保留要求，但不声明本地会话可用。 */
@@ -947,6 +1104,8 @@ declare interface RenderPlan {
     pages: PlanPage[];
 }
 
+export declare const REPORT_HTTP_CONTRACT_VERSION = "1.0";
+
 export declare interface ReportBatchCase {
     id: string;
     params: Record<string, string>;
@@ -1034,6 +1193,100 @@ declare interface ReportCellTableIdentity {
 
 declare type ReportCellValue = string | number | boolean | null;
 
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure[];
+    type: ReportChartOptions["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+
+/** Serializable binding; data and authorization continue to come from the existing report source. */
+declare interface ReportChartBinding_2 {
+    dataset: string;
+    categoryField: string;
+    measures: readonly ReportChartMeasure_2[];
+    type: ReportChartOptions_2["type"];
+    sort?: "asc" | "desc";
+    title?: string;
+    showValues?: boolean;
+    maxRows?: number;
+    maxCategories?: number;
+}
+
+declare interface ReportChartMeasure extends AggregateRequest {
+    label?: string;
+    color?: string;
+}
+
+declare interface ReportChartMeasure_2 extends AggregateRequest_2 {
+    label?: string;
+    color?: string;
+}
+
+declare interface ReportChartOptions {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+
+declare interface ReportChartOptions_2 {
+    type: "bar" | "line" | "stackedBar" | "percentBar";
+    categories: readonly string[];
+    series: readonly ReportChartSeries_2[];
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    title?: string;
+    showValues?: boolean;
+}
+
+declare interface ReportChartSeries {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+
+declare interface ReportChartSeries_2 {
+    name: string;
+    values: readonly (number | null)[];
+    color?: string;
+}
+
+declare interface ReportComparison {
+    field: string;
+    op: ">" | ">=" | "<" | "<=" | "==" | "!=" | "between" | "contains" | "isNull" | "isNotNull";
+    /** Legacy scalar thresholds remain supported. Use right for field-to-field comparisons. */
+    value?: ReportPredicateScalar;
+    right?: ReportPredicateOperand;
+    values?: readonly [ReportPredicateScalar, ReportPredicateScalar];
+    numeric?: "number" | "decimal";
+    valueType?: "number" | "decimal" | "text" | "date" | "boolean";
+}
+
+declare interface ReportComparison_2 {
+    field: string;
+    op: ">" | ">=" | "<" | "<=" | "==" | "!=" | "between" | "contains" | "isNull" | "isNotNull";
+    /** Legacy scalar thresholds remain supported. Use right for field-to-field comparisons. */
+    value?: ReportPredicateScalar_2;
+    right?: ReportPredicateOperand_2;
+    values?: readonly [ReportPredicateScalar_2, ReportPredicateScalar_2];
+    numeric?: "number" | "decimal";
+    valueType?: "number" | "decimal" | "text" | "date" | "boolean";
+}
+
 declare interface ReportDataTarget {
     datasetId: string;
     field: string;
@@ -1085,6 +1338,46 @@ declare interface ReportDiagnostic {
     target?: ReportDataTarget;
 }
 
+export declare interface ReportDocumentBudget {
+    maxDocuments?: number;
+    maxBytes?: number;
+    maxPages?: number;
+    maxPageBytes?: number;
+    maxManifestBytes?: number;
+}
+
+export declare class ReportDocumentError extends Error {
+    readonly code: "input" | "capacity" | "conflict" | "missing" | "closed";
+    constructor(code: "input" | "capacity" | "conflict" | "missing" | "closed", message: string);
+}
+
+export declare interface ReportDocumentManifest {
+    scope: string;
+    id: string;
+    version: string;
+    /** CAS token increases after each append and completion. */
+    revision: number;
+    state: "building" | "complete" | "failed";
+    failure?: {
+        code: "cancelled" | "generation";
+        message: string;
+    };
+    pageCount: number;
+    bytes: number;
+    plan: Omit<RenderPlan, "pages">;
+    metadata?: Omit<PreparedReport, "plan">;
+}
+
+export declare interface ReportDocumentStore {
+    create(input: Pick<ReportDocumentManifest, "scope" | "id" | "version" | "plan">, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    append(scope: string, id: string, version: string, expectedRevision: number, page: PlanPage, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    complete(scope: string, id: string, version: string, expectedRevision: number, metadata?: Omit<PreparedReport, "plan">, signal?: AbortSignal): Promise<ReportDocumentManifest>;
+    fail(scope: string, id: string, version: string, expectedRevision: number, failure: NonNullable<ReportDocumentManifest["failure"]>): Promise<ReportDocumentManifest>;
+    read(scope: string, id: string, signal?: AbortSignal): Promise<ReportDocumentManifest | undefined>;
+    readPage(scope: string, id: string, version: string, index: number, signal?: AbortSignal): Promise<PlanPage | undefined>;
+    remove(scope: string, id: string, version: string, signal?: AbortSignal): Promise<boolean>;
+}
+
 declare type ReportExpression = {
     field: string;
 } | {
@@ -1094,7 +1387,9 @@ declare type ReportExpression = {
     field?: string;
     weightField?: string;
 } | {
-    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    op: ReportExpressionOperation;
+    /** Required for if; args are [then, else], and only the selected branch is evaluated. */
+    condition?: ReportPredicate;
     args: readonly ReportExpression[];
 };
 
@@ -1107,11 +1402,25 @@ declare type ReportExpression_2 = {
     field?: string;
     weightField?: string;
 } | {
-    op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
+    op: ReportExpressionOperation_2;
+    /** Required for if; args are [then, else], and only the selected branch is evaluated. */
+    condition?: ReportPredicate_2;
     args: readonly ReportExpression_2[];
 };
 
-declare interface ReportFieldContract {
+declare type ReportExpressionOperation = "add" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "round" | "abs" | "concat" | "trim" | "upper" | "lower" | "dateYear" | "dateMonth" | "dateDay";
+
+declare type ReportExpressionOperation_2 = "add" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "round" | "abs" | "concat" | "trim" | "upper" | "lower" | "dateYear" | "dateMonth" | "dateDay";
+
+declare type ReportFieldAggregation = "sum" | "avg" | "min" | "max" | "count" | "none";
+
+declare interface ReportFieldCalculation {
+    /** Business-owned explanation, never executable JavaScript or an inferred business formula. */
+    description: string;
+    dependsOn: readonly string[];
+}
+
+declare interface ReportFieldContract extends ReportFieldSemantics {
     field: string;
     label?: string;
     type: "text" | "number" | "boolean" | "date" | "decimal";
@@ -1126,6 +1435,17 @@ declare interface ReportFieldContract {
     unit?: string;
 }
 
+declare interface ReportFieldSemantics {
+    description?: string;
+    /** Explicit meaning of null/missing; does not convert blanks into zero. */
+    missingMeaning?: string;
+    /** Recommended aggregation; none marks non-additive measures such as ratios. No aggregation runs implicitly. */
+    aggregation?: ReportFieldAggregation;
+    /** Shared presentation only; raw values and calculation precision remain unchanged. */
+    format?: ColumnFormat;
+    calculation?: ReportFieldCalculation;
+}
+
 declare interface ReportFlowBand {
     /** Exact stable component IDs. Static components use nid, lists use id. */
     componentIds: string[];
@@ -1152,6 +1472,22 @@ export declare interface ReportGenerationInput {
     signal?: AbortSignal;
 }
 
+/** Stable transport mapping; unexpected errors never expose exception details or stacks. */
+export declare function reportHttpError(error: unknown, correlationId: string): {
+    status: number;
+    body: ReportHttpErrorBody;
+};
+
+export declare interface ReportHttpErrorBody {
+    error: {
+        code: string;
+        message: string;
+        correlationId: string;
+        path?: string;
+        issues?: Record<string, string>[];
+    };
+}
+
 export declare interface ReportInstanceArtifact {
     key: string;
     format: "pdf" | "xlsx";
@@ -1344,6 +1680,8 @@ declare interface ReportLoadContext {
     signal?: AbortSignal;
 }
 
+declare type ReportNumberRange = readonly [number, number];
+
 export declare interface ReportPackageFixture {
     name: string;
     /** Explicit host confirmation; the SDK does not infer that business values are anonymous. */
@@ -1397,12 +1735,9 @@ declare interface ReportParamDef {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select" | "multiSelect" | "cascader" | "numberRange";
     /** select 选项 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    options?: ReportParamTreeOption[];
     /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
     optionsSource?: string;
     /** Select dependencies must be declared parameters; changing a parent clears descendants. */
@@ -1415,6 +1750,9 @@ declare interface ReportParamDef {
     max?: number | string;
     minLength?: number;
     maxLength?: number;
+    /** multiSelect item count (maximum 100). Cascader paths are bounded to 16 levels. */
+    minItems?: number;
+    maxItems?: number;
 }
 
 /** 报表参数定义（声明式，模板自描述参数面：渲染组件据此生成查询面板） */
@@ -1423,12 +1761,9 @@ declare interface ReportParamDef_2 {
     field: string;
     /** 显示名（缺省用 field） */
     label?: string;
-    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select";
+    type?: "text" | "number" | "date" | "month" | "year" | "dateRange" | "select" | "multiSelect" | "cascader" | "numberRange";
     /** select 选项 */
-    options?: Array<{
-        label: string;
-        value: string;
-    }>;
+    options?: ReportParamTreeOption_2[];
     /** Opaque host-resolved source key. No URL, credentials or executable code is stored. */
     optionsSource?: string;
     /** Select dependencies must be declared parameters; changing a parent clears descendants. */
@@ -1441,6 +1776,9 @@ declare interface ReportParamDef_2 {
     max?: number | string;
     minLength?: number;
     maxLength?: number;
+    /** multiSelect item count (maximum 100). Cascader paths are bounded to 16 levels. */
+    minItems?: number;
+    maxItems?: number;
 }
 
 declare interface ReportParamIssue {
@@ -1450,14 +1788,30 @@ declare interface ReportParamIssue {
     message: string;
 }
 
-declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength";
+declare type ReportParamIssueCode = "definition" | "required" | "type" | "option" | "dependency" | "minimum" | "maximum" | "minLength" | "maxLength" | "minItems" | "maxItems";
+
+/** Cascader values are unique within each sibling list. */
+declare interface ReportParamTreeOption {
+    label: string;
+    value: string;
+    children?: ReportParamTreeOption[];
+}
+
+/** Cascader values are unique within each sibling list. */
+declare interface ReportParamTreeOption_2 {
+    label: string;
+    value: string;
+    children?: ReportParamTreeOption_2[];
+}
+
+declare type ReportParamTypedValue = string | number | string[] | ReportNumberRange;
 
 declare interface ReportParamValidation {
     ok: boolean;
     /** 保留历史取数契约的字符串形式；未知参数保留，不能代替接口权限白名单。 */
     values: Record<string, string>;
     /** JSON Schema 对应的规范值：number 参数转换为有限数字。 */
-    typedValues: Record<string, string | number>;
+    typedValues: Record<string, ReportParamTypedValue>;
     issues: ReportParamIssue[];
 }
 
@@ -1473,6 +1827,38 @@ export declare interface ReportPdfFontOptions {
     };
 }
 
+declare type ReportPredicate = ReportComparison | {
+    all: readonly ReportPredicate[];
+} | {
+    any: readonly ReportPredicate[];
+} | {
+    not: ReportPredicate;
+};
+
+declare type ReportPredicate_2 = ReportComparison_2 | {
+    all: readonly ReportPredicate_2[];
+} | {
+    any: readonly ReportPredicate_2[];
+} | {
+    not: ReportPredicate_2;
+};
+
+declare type ReportPredicateOperand = {
+    field: string;
+} | {
+    value: ReportPredicateScalar;
+};
+
+declare type ReportPredicateOperand_2 = {
+    field: string;
+} | {
+    value: ReportPredicateScalar_2;
+};
+
+declare type ReportPredicateScalar = string | number | boolean | null;
+
+declare type ReportPredicateScalar_2 = string | number | boolean | null;
+
 /** 查询是唯一基础能力；权限、HTTP、数据库和事务都留在宿主适配器内。 */
 declare interface ReportProvider {
     query(context: ReportLoadContext): ReportQueryResult | Promise<ReportQueryResult>;
@@ -1540,6 +1926,8 @@ export declare interface ReportRuntimeBudget {
     maxRows?: number;
     maxPages?: number;
     maxCells?: number;
+    /** Aggregate bound-chart primitives per prepare, before expansion; default 50000, hard maximum 1000000. */
+    maxChartComponents?: number;
     maxOutputBytes?: number;
     /** Bound the plain JSON snapshot accepted by exportPrepared (default 64 MB). */
     maxPreparedBytes?: number;
@@ -1568,6 +1956,7 @@ export declare interface ReportRuntimeExportInput extends ReportRuntimeInput {
         sheetMode?: "auto" | "pages" | "continuous";
         valueMode?: "text" | "raw";
         paperSize?: "auto" | "a3" | "a4" | "a5";
+        maxDataBars?: number;
         sheetName?: (sheetIndex: number) => string;
     };
 }
@@ -2048,26 +2437,14 @@ export declare function snapshotReportInstance(value: ReportInstanceSnapshot, ma
 
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule {
-    when: {
-        field: string;
-        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
-        value: number | string;
-        /** Explicit decimal comparisons retain decimal thresholds as text. */
-        numeric?: "number" | "decimal";
-    };
+    when: ReportPredicate;
     /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
     style: Record<string, unknown>;
 }
 
 /** 条件格式规则求值（声明式，见 ListColumn.rules） */
 declare interface StyleRule_2 {
-    when: {
-        field: string;
-        op: ">" | ">=" | "<" | "<=" | "==" | "!=";
-        value: number | string;
-        /** Explicit decimal comparisons retain decimal thresholds as text. */
-        numeric?: "number" | "decimal";
-    };
+    when: ReportPredicate_2;
     /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
     style: Record<string, unknown>;
 }
@@ -2186,4 +2563,15 @@ declare type ValueFormat = ColumnFormat;
 /** The same declarative formatting used by list columns, before any output backend. */
 declare type ValueFormat_2 = ColumnFormat_2;
 
+/** Accepts paginateTemplatePages/AsyncIterable without retaining all pages; partial documents stay inspectable on failure. */
+export declare function writeReportDocument(store: ReportDocumentStore, input: {
+    scope: string;
+    id: string;
+    version: string;
+    plan: Omit<RenderPlan, "pages">;
+    pages: Iterable<PlanPage> | AsyncIterable<PlanPage>;
+    metadata?: Omit<PreparedReport, "plan">;
+    signal?: AbortSignal;
+}): Promise<ReportDocumentManifest>;
+
 export { }