@agile-team/mach-report 2.8.4 → 2.9.1

package/dist/analytics.d.ts

@@ -1,3 +1,32 @@
+export declare function addDecimal(a: DecimalValue, b: DecimalValue): DecimalValue;
+
+export declare interface AggregateAccumulator {
+    add(row: Readonly<Record<string, unknown>>): void;
+    value(): number | string | null;
+}
+
+export declare interface AggregateDefinition {
+    /** Output column; valueField defaults to this field. */
+    field: string;
+    op: AggregateOperation;
+    valueField?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
+export declare type AggregateOperation = "sum" | "count" | "avg" | "min" | "max" | "weightedAvg";
+
+export declare interface AggregateRequest {
+    op: AggregateOperation;
+    field?: string;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
+}
+
+export declare function aggregateRows(rows: readonly Record<string, unknown>[], request: AggregateRequest): number | string | null;
+
 /**
  * 列值格式化（声明式、JSON 可序列化）。
  * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
@@ -21,6 +50,8 @@ declare type ColumnFormat = {
     pattern?: string;
 };
 
+export declare function compareDecimal(a: DecimalValue, b: DecimalValue): number;
+
 declare type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
 
 declare interface ComponentStyle {
@@ -53,7 +84,14 @@ export declare interface ComputationIssue {
     message: string;
 }
 
-/** 纯数据计算与界面解耦；字段按声明顺序计算，可供后续字段引用，不修改输入数据。 */
+export declare interface ComputationValidation {
+    valid: boolean;
+    errors: string[];
+    fields: ComputedFieldDiagnostic[];
+    order: string[];
+}
+
+/** Topologically ordered column passes keep aggregate dependencies correct and avoid quadratic group scans. */
 export declare function computeDataset(input: readonly Record<string, unknown>[], options: ComputedDatasetOptions): {
     rows: Record<string, unknown>[];
     issues: ComputationIssue[];
@@ -63,30 +101,51 @@ export declare interface ComputedDatasetOptions {
     fields: readonly ComputedField[];
     formula?: FormulaAdapter;
     maxRows?: number;
-    /** Calculated cells (rows × fields), default 2 million; at most 2048 field definitions. */
     maxCells?: number;
     signal?: AbortSignal;
     onError?: "throw" | "null";
 }
 
-export declare interface ComputedField {
+export declare interface ComputedField extends ExpressionOptions {
     field: string;
     expression: ReportExpression | string;
+    /** Scope controls aggregate inputs; row expressions may reference the current row in any scope. */
+    scope?: "row" | "group" | "dataset";
+    groupBy?: readonly string[];
+    /** String adapter expressions cannot be inspected; declare dependencies explicitly. */
+    dependsOn?: readonly string[];
 }
 
+export declare interface ComputedFieldDiagnostic {
+    field: string;
+    dependencies: string[];
+    scope: "row" | "group" | "dataset";
+}
+
+/** Nulls are skipped; count with no field counts rows, all-null numeric aggregates stay null. */
+export declare function createAggregateAccumulator(request: AggregateRequest): AggregateAccumulator;
+
 /** 轻量柱/折线图展开为共用基础图元，无外部图表依赖，DOM/Canvas/PDF 使用同一计划。 */
 export declare function createChartComponents(options: ReportChartOptions): PlanComponent[];
 
 /** 通用交叉聚合；合计直接累计原始度量，平均值不会错误地平均各分组合计。 */
 export declare function createCrossTable(input: readonly Record<string, unknown>[], options: CrossTableOptions): CrossTableResult;
 
+/** Multi-dimension/multi-measure pivot; each total aggregates original rows, never averages averages. */
+export declare function createMatrixTable(input: readonly Record<string, unknown>[], options: MatrixTableOptions): CrossTableResult;
+
 export declare interface CrossTableOptions {
     rowField: string;
     columnField: string;
     valueField?: string;
-    aggregate?: "sum" | "count" | "avg" | "min" | "max";
+    aggregate?: AggregateOperation;
+    weightField?: string;
+    numeric?: "number" | "decimal";
+    digits?: number;
     totals?: boolean;
     rowHeader?: string;
+    /** Existing count defaults to row counts; opt-in SQL COUNT(field) skips nulls. */
+    countMode?: "rows" | "nonNull";
     maxRows?: number;
     maxColumns?: number;
     maxInputRows?: number;
@@ -99,14 +158,94 @@ export declare interface CrossTableResult {
     rows: Record<string, unknown>[];
 }
 
+export declare function decimalDigits(digits: number): void;
+
+/** Bounded base-ten arithmetic. Decimal strings never pass through IEEE-754 numbers. */
+export declare interface DecimalValue {
+    coefficient: bigint;
+    scale: number;
+}
+
+export declare function divideDecimal(a: DecimalValue, b: DecimalValue, digits?: number): DecimalValue;
+
+/** Cardinality pass checks expansion budgets before allocating the dense pivot output. */
+export declare function estimateMatrixTable(input: readonly Record<string, unknown>[], options: MatrixTableOptions): MatrixTableShape;
+
+declare interface ExpressionOptions {
+    numeric?: "number" | "decimal";
+    digits?: number;
+    nulls?: "propagate" | "error";
+    divisionByZero?: "null" | "error";
+}
+
+/** Formats decimal data exactly while preserving it as text in Excel. */
+export declare function formatDecimal(input: string, digits?: number, thousands?: boolean, percent?: boolean): string;
+
 export declare interface FormulaAdapter {
-    /** 显式注入受信任的公式引擎；核心不执行 eval、宏或外部工作簿引用。 */
+    /** Explicit trusted engine; core never evaluates source code/macros/external workbook references. */
     evaluate(expression: string, context: {
         row: Readonly<Record<string, unknown>>;
         rowIndex: number;
+        rows: readonly Record<string, unknown>[];
     }): unknown;
 }
 
+export declare function getComputationMetadata(fields?: readonly {
+    field: string;
+    type: string;
+    label?: string;
+}[]): {
+    fields: {
+        field: string;
+        type: string;
+        label?: string;
+    }[];
+    functions: readonly [{
+        readonly name: "add";
+        readonly minArgs: 2;
+        readonly maxArgs: 256;
+        readonly input: "numeric";
+        readonly output: "numeric";
+    }, {
+        readonly name: "subtract";
+        readonly minArgs: 2;
+        readonly maxArgs: 2;
+        readonly input: "numeric";
+        readonly output: "numeric";
+    }, {
+        readonly name: "multiply";
+        readonly minArgs: 2;
+        readonly maxArgs: 256;
+        readonly input: "numeric";
+        readonly output: "numeric";
+    }, {
+        readonly name: "divide";
+        readonly minArgs: 2;
+        readonly maxArgs: 2;
+        readonly input: "numeric";
+        readonly output: "numeric";
+    }, {
+        readonly name: "coalesce";
+        readonly minArgs: 2;
+        readonly maxArgs: 256;
+        readonly input: "scalar";
+        readonly output: "scalar";
+    }];
+    operations: readonly ["add", "subtract", "multiply", "divide", "coalesce"];
+    aggregates: readonly ["sum", "count", "avg", "min", "max", "weightedAvg"];
+    scopes: readonly ["row", "group", "dataset"];
+    numericModes: readonly ["number", "decimal"];
+    rules: {
+        readonly nulls: "propagate";
+        readonly aggregateNulls: "skip";
+        readonly emptyAggregate: null;
+        readonly countEmpty: 0;
+        readonly divisionByZero: "error";
+        readonly decimalOutput: "string";
+        readonly rounding: "half-away-from-zero";
+    };
+};
+
 declare interface GridCell {
     text?: string;
     rawText?: string;
@@ -151,9 +290,40 @@ declare interface ListColumn {
     valueType?: GridCell["valueType"];
     /** 字段语义用于 auto 对齐；明确声明编号，避免把数字编号当成度量。 */
     semanticRole?: "identifier" | "dimension" | "measure" | "date" | "text";
+    hidden?: boolean;
+    /** Condition hides cell content, preserving its physical layout in preview and exports. */
+    visibleWhen?: StyleRule["when"];
 }
 
+export declare interface MatrixTableOptions {
+    rowFields: readonly string[];
+    columnFields: readonly string[];
+    measures: readonly (AggregateDefinition & {
+        label?: string;
+    })[];
+    totals?: boolean;
+    rowHeader?: string;
+    columnWidthMm?: number;
+    rowWidthMm?: number;
+    maxRows?: number;
+    maxColumns?: number;
+    maxInputRows?: number;
+    maxCells?: number;
+}
+
+export declare interface MatrixTableShape {
+    rowCount: number;
+    columnCount: number;
+    cells: number;
+}
+
+export declare function multiplyDecimal(a: DecimalValue, b: DecimalValue): DecimalValue;
+
+export declare function parseDecimal(input: unknown): DecimalValue;
+
 declare interface PlanComponent {
+    /** Template page furniture repeats per page and reserves its vertical band. */
+    pageAnchor?: "header" | "footer";
     kind: ComponentKind;
     leftMm: number;
     topMm: number;
@@ -203,6 +373,8 @@ declare interface PlanTableFragment {
     };
 }
 
+export declare function printDecimal(value: DecimalValue, digits?: number): string;
+
 /** 可持久化的业务身份与计划坐标独立；权限及并发校验仍由业务服务器执行。 */
 declare interface ReportCellSource {
     datasetId: string;
@@ -234,6 +406,10 @@ export declare type ReportExpression = {
     field: string;
 } | {
     value: string | number | boolean | null;
+} | {
+    aggregate: AggregateOperation;
+    field?: string;
+    weightField?: string;
 } | {
     op: "add" | "subtract" | "multiply" | "divide" | "coalesce";
     args: readonly ReportExpression[];
@@ -261,6 +437,8 @@ declare interface StyleRule {
         field: string;
         op: ">" | ">=" | "<" | "<=" | "==" | "!=";
         value: number | string;
+        /** Explicit decimal comparisons retain decimal thresholds as text. */
+        numeric?: "number" | "decimal";
     };
     /** 命中时合并进单元格样式（color/bold/backgroundColor 等） */
     style: Record<string, unknown>;
@@ -273,4 +451,9 @@ declare type TableTemplateColumn = Omit<ListColumn, "widthMm"> & {
     flex?: number;
 };
 
+/** Design-time validation: no input data, adapters, evaluation or DOM required. */
+export declare function validateComputedFields(definitions: readonly ComputedField[]): ComputationValidation;
+
+export declare function validateMatrixOptions(options: MatrixTableOptions): void;
+
 export { }

package/dist/analytics.js

@@ -1,223 +1,89 @@
-const E = ["#2563eb", "#0d9488", "#d97706", "#7c3aed", "#dc2626", "#0284c7"];
-function $(e) {
+import { a as A, b as S, c as z, d as F, e as N, f as R, g as T, h as W, i as B, j as G, k as L, l as O, m as P, p as $, n as j, v as V, o as q } from "./matrix-CNPDJxED.js";
+const u = ["#2563eb", "#0d9488", "#d97706", "#7c3aed", "#dc2626", "#0284c7"];
+function w(e) {
   if (e.type !== "bar" && e.type !== "line") throw new Error("图表 type 应为 bar 或 line");
   if (!Array.isArray(e.categories) || !Array.isArray(e.series) || !e.categories.length || e.categories.length > 200 || !e.series.length || e.series.length > 12) throw new Error("图表支持 1–200 个分类、1–12 个系列；大数据应先聚合");
-  if (e.categories.some((r) => typeof r != "string")) throw new Error("图表分类应为字符串");
-  z(e);
-  for (const r of e.series) L(r, e.categories.length);
+  if (e.categories.some((t) => typeof t != "string")) throw new Error("图表分类应为字符串");
+  b(e);
+  for (const t of e.series) y(t, e.categories.length);
 }
-function z(e) {
-  for (const r of ["leftMm", "topMm", "widthMm", "heightMm"])
-    if (!Number.isFinite(e[r]) || e[r] < 0) throw new Error(`${r} 应为有限非负数`);
+function b(e) {
+  for (const t of ["leftMm", "topMm", "widthMm", "heightMm"])
+    if (!Number.isFinite(e[t]) || e[t] < 0) throw new Error(`${t} 应为有限非负数`);
   if (e.widthMm < 45 || e.heightMm < 35) throw new Error("图表至少需要 45×35mm");
   if (!Number.isFinite(e.leftMm + e.widthMm) || !Number.isFinite(e.topMm + e.heightMm)) throw new Error("图表几何范围溢出");
 }
-function L(e, r) {
-  if (!e || typeof e.name != "string" || !Array.isArray(e.values) || e.values.length !== r || e.values.some((t) => t !== null && !Number.isFinite(t))) throw new Error("图表系列应提供名称及逐分类的有限数字或 null");
+function y(e, t) {
+  if (!e || typeof e.name != "string" || !Array.isArray(e.values) || e.values.length !== t || e.values.some((r) => r !== null && !Number.isFinite(r))) throw new Error("图表系列应提供名称及逐分类的有限数字或 null");
   if (e.color !== void 0 && !/^#[\da-f]{6}$/i.test(e.color)) throw new Error("图表颜色应为 #RRGGBB");
 }
-function F(e, r, t, n, i, l = 0.8) {
-  return { kind: "line", leftMm: Math.min(e, t), topMm: Math.min(r, n), widthMm: Math.abs(t - e), heightMm: Math.abs(n - r), lineDirection: n < r ? "up" : "down", style: { lineColor: i, lineWidthPt: l } };
+function d(e, t, r, l, h, a = 0.8) {
+  return { kind: "line", leftMm: Math.min(e, r), topMm: Math.min(t, l), widthMm: Math.abs(r - e), heightMm: Math.abs(l - t), lineDirection: l < t ? "up" : "down", style: { lineColor: h, lineWidthPt: a } };
 }
-function d(e, r, t, n, i = "center") {
-  return { kind: "text", text: e, leftMm: r, topMm: t, widthMm: n, heightMm: 5, style: { fontSize: 8, color: "#475569", align: i, verticalAlign: "middle" } };
+function M(e, t, r, l, h = "center") {
+  return { kind: "text", text: e, leftMm: t, topMm: r, widthMm: l, heightMm: 5, style: { fontSize: 8, color: "#475569", align: h, verticalAlign: "middle" } };
 }
-function S(e) {
+function o(e) {
   return Number(e.toPrecision(5)).toString();
 }
-function j(e) {
-  let r = 0, t = 0;
-  for (const h of e.series) for (const a of h.values) a !== null && (r = Math.min(r, a), t = Math.max(t, a));
-  r === t && (t = r + 1);
-  const n = e.leftMm + 13, i = e.topMm + 8, l = e.widthMm - 17, c = e.heightMm - 23, f = Math.max(Math.abs(r), Math.abs(t), 1), o = r / f, u = t / f - o;
-  return { left: n, top: i, width: l, height: c, min: r, max: t, y: (h) => i + c * (1 - (h / f - o) / u) };
-}
-function x(e, r) {
-  const t = [];
-  e.title && t.push({ ...d(e.title, e.leftMm, e.topMm, e.widthMm), style: { fontSize: 10, bold: !0, align: "left" } });
-  for (let l = 0; l <= 4; l++) {
-    const c = l / 4, f = r.min * (1 - c) + r.max * c, o = r.y(f);
-    t.push(F(r.left, o, r.left + r.width, o, "#e2e8f0", 0.4), d(S(f), e.leftMm, o - 2.5, 11, "right"));
+function k(e) {
+  let t = 0, r = 0;
+  for (const s of e.series) for (const m of s.values) m !== null && (t = Math.min(t, m), r = Math.max(r, m));
+  t === r && (r = t + 1);
+  const l = e.leftMm + 13, h = e.topMm + 8, a = e.widthMm - 17, i = e.heightMm - 23, n = Math.max(Math.abs(t), Math.abs(r), 1), c = t / n, g = r / n - c;
+  return { left: l, top: h, width: a, height: i, min: t, max: r, y: (s) => h + i * (1 - (s / n - c) / g) };
+}
+function v(e, t) {
+  const r = [];
+  e.title && r.push({ ...M(e.title, e.leftMm, e.topMm, e.widthMm), style: { fontSize: 10, bold: !0, align: "left" } });
+  for (let a = 0; a <= 4; a++) {
+    const i = a / 4, n = t.min * (1 - i) + t.max * i, c = t.y(n);
+    r.push(d(t.left, c, t.left + t.width, c, "#e2e8f0", 0.4), M(o(n), e.leftMm, c - 2.5, 11, "right"));
   }
-  t.push(F(r.left, r.top, r.left, r.top + r.height, "#94a3b8"));
-  const n = Math.max(1, Math.ceil(e.categories.length / Math.max(1, Math.floor(r.width / 14))));
-  e.categories.forEach((l, c) => {
-    c % n === 0 && t.push(d(l, r.left + (c + 0.5) * r.width / e.categories.length - 7, r.top + r.height + 1, 14));
+  r.push(d(t.left, t.top, t.left, t.top + t.height, "#94a3b8"));
+  const l = Math.max(1, Math.ceil(e.categories.length / Math.max(1, Math.floor(t.width / 14))));
+  e.categories.forEach((a, i) => {
+    i % l === 0 && r.push(M(a, t.left + (i + 0.5) * t.width / e.categories.length - 7, t.top + t.height + 1, 14));
   });
-  const i = r.width / e.series.length;
-  return e.series.forEach((l, c) => {
-    t.push({ ...d(l.name, r.left + c * i, e.topMm + e.heightMm - 5, i), style: { fontSize: 8, color: l.color ?? E[c % E.length], align: "center" } });
-  }), t;
-}
-function P(e, r, t, n) {
-  const i = [], l = t.color ?? E[n % E.length], c = r.width / e.categories.length, f = c * 0.75 / e.series.length;
-  let o;
-  return t.values.forEach((u, h) => {
-    if (u === null) {
-      o = void 0;
+  const h = t.width / e.series.length;
+  return e.series.forEach((a, i) => {
+    r.push({ ...M(a.name, t.left + i * h, e.topMm + e.heightMm - 5, h), style: { fontSize: 8, color: a.color ?? u[i % u.length], align: "center" } });
+  }), r;
+}
+function x(e, t, r, l) {
+  const h = [], a = r.color ?? u[l % u.length], i = t.width / e.categories.length, n = i * 0.75 / e.series.length;
+  let c;
+  return r.values.forEach((g, s) => {
+    if (g === null) {
+      c = void 0;
       return;
     }
-    const a = r.left + (h + 0.5) * c, m = r.y(u);
-    e.type === "bar" ? i.push({ kind: "rect", leftMm: r.left + h * c + c * 0.125 + n * f, topMm: Math.min(m, r.y(0)), widthMm: f, heightMm: Math.abs(r.y(0) - m), style: { backgroundColor: l, borderTop: !1, borderRight: !1, borderBottom: !1, borderLeft: !1 } }) : (o && i.push(F(o.x, o.y, a, m, l, 1.2)), i.push({ kind: "ellipse", leftMm: a - 0.7, topMm: m - 0.7, widthMm: 1.4, heightMm: 1.4, style: { backgroundColor: l, borderColor: l } }), o = { x: a, y: m }), e.showValues && i.push({ ...d(S(u), a - c / 2, Math.max(r.top, m - 5), c), style: { fontSize: 7, color: l, align: "center" } });
-  }), i;
-}
-function U(e) {
-  $(e);
-  const r = j(e);
-  return [...x(e, r), ...e.series.flatMap((t, n) => P(e, r, t, n))];
-}
-function y() {
-  return { count: 0, sum: 0, correction: 0, min: 1 / 0, max: -1 / 0 };
-}
-function w(e, r) {
-  return Object.prototype.hasOwnProperty.call(e, r) ? e[r] : void 0;
-}
-function A(e) {
-  if (e == null) return "null";
-  if (typeof e != "string" && typeof e != "boolean" && !(typeof e == "number" && Number.isFinite(e))) throw new Error("交叉表维度应为字符串、布尔、有限数字或空值");
-  return JSON.stringify([typeof e, e]);
-}
-function N(e) {
-  return e == null ? "" : String(e);
-}
-function W(e, r, t) {
-  const n = t === "count";
-  if (!n && r == null) return;
-  if (!n && (typeof r != "number" || !Number.isFinite(r))) throw new Error("交叉表度量必须是有限数字；编号和小数文本不能隐式转为数字");
-  const i = n ? 1 : r;
-  (t === "sum" || t === "avg") && _(e, i), e.count++, e.min = Math.min(e.min, i), e.max = Math.max(e.max, i);
-}
-function _(e, r) {
-  const t = r - e.correction, n = e.sum + t;
-  if (!Number.isFinite(n)) throw new Error("交叉表聚合溢出");
-  e.correction = n - e.sum - t, e.sum = n;
-}
-function b(e, r) {
-  return e?.count ? r === "count" ? e.count : r === "avg" ? e.sum / e.count : r === "sum" ? e.sum : e[r] : r === "count" ? 0 : null;
-}
-function M(e, r) {
-  const t = e ?? r;
-  if (!Number.isInteger(t) || t < 1) throw new Error("交叉表预算应为正整数");
-  return t;
-}
-function B(e, r, t, n) {
-  const i = t ? 1 : 0;
-  if ((e + i) * (r + 1 + i) > n) throw new Error("交叉表输出单元格超出 maxCells 预算，请减少维度或服务端预聚合");
-}
-function V(e, r) {
-  const t = r.aggregate ?? "sum";
-  if (!["sum", "count", "avg", "min", "max"].includes(t)) throw new Error("未知交叉表聚合类型");
-  if (!r.rowField || !r.columnField || t !== "count" && !r.valueField) throw new Error("交叉表需要明确的行维度、列维度和度量字段");
-  if (e.length > M(r.maxInputRows, 1e5)) throw new Error("交叉表输入超出预算，请在服务端预聚合");
-  const n = M(r.maxRows, 1e3), i = M(r.maxColumns, 200), l = M(r.maxCells, 2e6), c = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), u = y();
-  for (const a of e) {
-    const m = A(w(a, r.rowField)), s = A(w(a, r.columnField));
-    if (c.has(s) || c.set(s, N(w(a, r.columnField))), f.has(m) || f.set(m, { label: N(w(a, r.rowField)), cells: /* @__PURE__ */ new Map(), total: y() }), c.size > i || f.size > n) throw new Error("交叉表维度数量超出预算");
-    B(f.size, c.size, r.totals, l);
-    const g = f.get(m);
-    g.cells.has(s) || g.cells.set(s, y()), o.has(s) || o.set(s, y());
-    const k = r.valueField ? w(a, r.valueField) : void 0;
-    for (const R of [g.cells.get(s), g.total, o.get(s), u]) W(R, k, t);
-  }
-  const h = {
-    columns: [{ header: r.rowHeader ?? r.rowField, field: "rowLabel", semanticRole: "dimension" }, ...[...c.values()].map((a, m) => ({ header: a, field: `c${m}`, semanticRole: "measure" }))],
-    rows: [...f.values()].map((a) => ({ rowLabel: a.label, ...Object.fromEntries([...c.keys()].map((m, s) => [`c${s}`, b(a.cells.get(m), t)])), ...r.totals ? { total: b(a.total, t) } : {} }))
-  };
-  return r.totals && (h.columns.push({ header: "合计", field: "total", semanticRole: "measure" }), e.length && h.rows.push({ rowLabel: "合计", ...Object.fromEntries([...c.keys()].map((a, m) => [`c${m}`, b(o.get(a), t)])), total: b(u, t) })), h;
+    const m = t.left + (s + 0.5) * i, f = t.y(g);
+    e.type === "bar" ? h.push({ kind: "rect", leftMm: t.left + s * i + i * 0.125 + l * n, topMm: Math.min(f, t.y(0)), widthMm: n, heightMm: Math.abs(t.y(0) - f), style: { backgroundColor: a, borderTop: !1, borderRight: !1, borderBottom: !1, borderLeft: !1 } }) : (c && h.push(d(c.x, c.y, m, f, a, 1.2)), h.push({ kind: "ellipse", leftMm: m - 0.7, topMm: f - 0.7, widthMm: 1.4, heightMm: 1.4, style: { backgroundColor: a, borderColor: a } }), c = { x: m, y: f }), e.showValues && h.push({ ...M(o(g), m - i / 2, Math.max(t.top, f - 5), i), style: { fontSize: 7, color: a, align: "center" } });
+  }), h;
 }
-const G = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
 function C(e) {
-  if (typeof e != "string" || !e.trim() || G.has(e)) throw new Error("计算字段应为安全的非空字段名");
-}
-function v(e) {
-  return e === null || ["string", "boolean"].includes(typeof e) || typeof e == "number" && Number.isFinite(e);
-}
-function I(e) {
-  if (e.some((r) => typeof r != "number" || !Number.isFinite(r))) throw new Error("算术参数必须是有限数字；空值和小数文本不会隐式转换");
-  return e;
-}
-function J(e, r) {
-  const t = I(r);
-  let n;
-  if (e === "add") n = t.reduce((i, l) => i + l, 0);
-  else if (e === "multiply") n = t.reduce((i, l) => i * l, 1);
-  else if (e === "subtract") n = t[0] - t[1];
-  else {
-    if (t[1] === 0) throw new Error("不能除以零");
-    n = t[0] / t[1];
-  }
-  if (!Number.isFinite(n)) throw new Error("计算结果不是有限数字");
-  return n;
-}
-function O(e, r, t = 0) {
-  if (++r.nodes > 256 || t > 16) throw new Error("计算表达式超出深度或节点预算");
-  if (!e || typeof e != "object" || Array.isArray(e)) throw new Error("计算表达式应为声明式对象");
-  if ("field" in e) {
-    C(e.field);
-    const i = e.field;
-    return (l) => Object.prototype.hasOwnProperty.call(l, i) ? l[i] : void 0;
-  }
-  if ("value" in e) {
-    if (!v(e.value)) throw new Error("常量应为有限 JSON 标量");
-    return () => e.value;
-  }
-  if (!["add", "subtract", "multiply", "divide", "coalesce"].includes(e.op) || !Array.isArray(e.args)) throw new Error("未知计算操作");
-  if (e.args.length < 2 || ["subtract", "divide"].includes(e.op) && e.args.length !== 2) throw new Error("运算参数数量不正确");
-  const n = e.args.map((i) => O(i, r, t + 1));
-  return e.op === "coalesce" ? (i, l) => T(n, i, l) : (i, l) => J(e.op, n.map((c) => c(i, l)));
-}
-function T(e, r, t) {
-  for (const n of e) {
-    const i = n(r, t);
-    if (i != null) return i;
-  }
-  return null;
-}
-function D(e) {
-  const r = /* @__PURE__ */ new Set();
-  return e.fields.map((t) => {
-    if (C(t.field), r.has(t.field)) throw new Error(`计算字段重复：${t.field}`);
-    r.add(t.field);
-    const n = t.expression;
-    let i;
-    if (typeof n == "string") {
-      if (!e.formula) throw new Error("字符串公式需要显式配置 formula adapter");
-      i = (l, c) => e.formula.evaluate(n, { row: l, rowIndex: c });
-    } else i = O(n, { nodes: 0 });
-    return { field: t.field, read: i };
-  });
-}
-function H(e, r) {
-  const t = r.maxRows ?? 1e5, n = r.maxCells ?? 2e6;
-  if (!Array.isArray(e) || !Number.isSafeInteger(t) || t < 1 || e.length > t) throw new Error("计算数据行数超出预算或输入不是数组");
-  if (!Array.isArray(r.fields) || r.fields.length > 2048) throw new Error("计算字段应为数组且最多2048项");
-  if (!Number.isSafeInteger(n) || n < 1 || e.length * r.fields.length > n) throw new Error("计算单元格超出 maxCells 预算");
-}
-function q(e, r) {
-  H(e, r);
-  const t = D(r), n = [];
-  return { rows: e.map((l, c) => {
-    if (!l || typeof l != "object" || Array.isArray(l)) throw new Error(`第 ${c + 1} 行应为对象`);
-    if (r.signal?.aborted) {
-      const o = new Error("数据计算已取消");
-      throw o.name = "AbortError", o;
-    }
-    const f = { ...l };
-    for (const o of t)
-      try {
-        const u = o.read(f, c);
-        if (u !== void 0 && !v(u)) throw new Error("计算结果应为有限 JSON 标量，异步公式请先在数据源中求值");
-        f[o.field] = u ?? null;
-      } catch (u) {
-        const h = u instanceof Error ? u.message : String(u);
-        if (r.onError !== "null") throw Object.assign(new Error(`第 ${c + 1} 行 ${o.field}：${h}`), { cause: u });
-        f[o.field] = null, n.push({ rowIndex: c, field: o.field, message: h });
-      }
-    return f;
-  }), issues: n };
+  w(e);
+  const t = k(e);
+  return [...v(e, t), ...e.series.flatMap((r, l) => x(e, t, r, l))];
 }
 export {
-  q as computeDataset,
-  U as createChartComponents,
-  V as createCrossTable
+  A as addDecimal,
+  S as aggregateRows,
+  z as compareDecimal,
+  F as computeDataset,
+  N as createAggregateAccumulator,
+  C as createChartComponents,
+  R as createCrossTable,
+  T as createMatrixTable,
+  W as decimalDigits,
+  B as divideDecimal,
+  G as estimateMatrixTable,
+  L as formatDecimal,
+  O as getComputationMetadata,
+  P as multiplyDecimal,
+  $ as parseDecimal,
+  j as printDecimal,
+  V as validateComputedFields,
+  q as validateMatrixOptions
 };

package/dist/{assets-B9qJku3V.js → assets-DDsfEi8R.js}

@@ -1,6 +1,6 @@
-import { d as v, c as k, e as S } from "./style-Dv5o_x6b.js";
-import { n as x } from "./capabilities-joSutDF8.js";
-import { w as y } from "./progress-DD964VAB.js";
+import { d as v, c as k, e as S } from "./style-CQ1PK8ZB.js";
+import { n as x } from "./capabilities-Cm9hZ3uV.js";
+import { w as y } from "./progress-7OSZbFok.js";
 const A = ["borderTop", "borderRight", "borderBottom", "borderLeft", "borderColor", "lineColor", "lineWidthPt"];
 function O(n, e) {
   const t = v(e.style), r = t.inner ? [...n.edges] : [];

package/dist/{assets-RZan7EyL.cjs → assets-ahTRUXRk.cjs}

@@ -1 +1 @@
-"use strict";const m=require("./style-CpwiOPyB.cjs"),k=require("./capabilities-xGTpnPjJ.cjs"),E=require("./progress-KvhwXZ1Q.cjs"),S=["borderTop","borderRight","borderBottom","borderLeft","borderColor","lineColor","lineWidthPt"];function y(n,e){const t=m.resolveBoxBorders(e.style),r=t.inner?[...n.edges]:[];t.top&&r.push({kind:"h",pos:0,from:0,to:e.widthMm}),t.bottom&&r.push({kind:"h",pos:e.heightMm,from:0,to:e.widthMm}),t.left&&r.push({kind:"v",pos:0,from:0,to:e.heightMm}),t.right&&r.push({kind:"v",pos:e.widthMm,from:0,to:e.heightMm});const o=m.resolveStroke(e.style);return r.map(s=>({...s,...o}))}function x(n,e,t){const r=n.get(e);(!r||t.widthPt>r.widthPt)&&n.set(e,t)}function w(n,e,t,r,o,s){const i=t<e.rows.length?e.rows[t].pos:e.rows[e.rows.length-1].pos+e.rows[e.rows.length-1].size;for(let c=r;c<o;c++){const d=e.columns[c];x(n,`h:${t}:${c}`,{kind:"h",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function b(n,e,t,r,o,s){const i=t<e.columns.length?e.columns[t].pos:e.columns[e.columns.length-1].pos+e.columns[e.columns.length-1].size;for(let c=r;c<o;c++){const d=e.rows[c];x(n,`v:${t}:${c}`,{kind:"v",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function v(n,e,t,r){const o=Math.min(e.columns.length,t.ci+(t.cell.colSpan??1)),s=Math.min(e.rows.length,t.ri+(t.cell.rowSpan??1)),i=m.mergeComponentStyles(r,t.cell.style),c=m.resolveBoxBorders(i),d=m.resolveStroke(i);c.top&&w(n,e,t.ri,t.ci,o,d),c.bottom&&w(n,e,s,t.ci,o,d),c.left&&b(n,e,t.ci,t.ri,s,d),c.right&&b(n,e,o,t.ri,s,d)}function A(n){const e=[...n.values()].sort((r,o)=>r.kind.localeCompare(o.kind)||r.pos-o.pos||r.from-o.from),t=[];for(const r of e){const o=t[t.length-1];o&&o.kind===r.kind&&o.pos===r.pos&&Math.abs(o.to-r.from)<1e-6&&o.color===r.color&&o.widthPt===r.widthPt?o.to=r.to:t.push({...r})}return t}function B(n,e){if(!n.cells.some(({cell:s})=>S.some(i=>s.style?.[i]!==void 0)))return y(n,e);const t=new Map,r=new Set,o=n.columns.length;for(const s of n.cells){v(t,n,s,e.style);const i=Math.min(n.rows.length,s.ri+(s.cell.rowSpan??1)),c=Math.min(o,s.ci+(s.cell.colSpan??1));for(let d=s.ri;d<i;d++)for(let a=s.ci;a<c;a++)r.add(d*o+a)}for(let s=0;s<n.rows.length;s++)for(let i=0;i<o;i++)r.has(s*o+i)||v(t,n,{ri:s,ci:i,cell:{}},e.style);return A(t)}class p extends Error{constructor(e,t){super(e.message),this.name="OutputAssetError",this.diagnostic=e,this.cause=t}}function f(n){if(n.aborted)throw n.reason??new DOMException("The operation was aborted.","AbortError")}function O(n){const e={maxAssets:1e3,maxImageBytes:33554432,maxTotalImageBytes:134217728,maxDurationMs:3e4,...n.assetBudget};for(const[t,r]of Object.entries(e))if(!Number.isSafeInteger(r)||r<=0||r>2147483647)throw new RangeError(`${t} must be a positive safe integer at most 2147483647.`);return e}function P(n){const e=/^data:image\/[a-z0-9.+-]+(;base64)?,(.*)$/is.exec(n);if(!e)throw new TypeError("Asset renderers must return an image data URL.");return e[1]?Math.ceil(e[2].length*3/4):new TextEncoder().encode(decodeURIComponent(e[2])).byteLength}function h(n,e,t,r,o){const s={code:t,message:r,severity:"warning",format:n.options.format??"dom",pageIndex:e.pageIndex,componentIndex:e.componentIndex,componentPath:e.componentPath,kind:e.component.kind,nid:e.component.nid};if(n.diagnostics.push(s),k.notifyOutputDiagnostic(s,{...n.options,signal:n.signal}),n.options.assetFailure!=="placeholder")throw new p(s,o)}async function D(n,e,t){const r=n.options.assetRenderers?.[e.kind];if(e.imageData||!r)return e.imageData;if(++n.rendered>n.budget.maxAssets)return h(n,t,"asset-budget-exceeded","Output exceeded the asset count budget.");let o;try{if(n.active=t,o=await E.waitForOutput(r({...t,signal:n.signal}),n.signal),f(n.signal),o.length>n.budget.maxImageBytes*4+1024)return h(n,t,"asset-budget-exceeded","Output exceeded the image payload byte budget.");const s=P(o);if(s>n.budget.maxImageBytes||n.bytes+s>n.budget.maxTotalImageBytes)return h(n,t,"asset-budget-exceeded","Output exceeded the encoded image byte budget.");n.bytes+=s}catch(s){if(n.signal.aborted||s instanceof p)throw s;return h(n,t,"asset-render-failed",`Asset renderer failed for ${e.kind}; output was not silently omitted.`,s)}return o}function T(n,e){const t=n.active;if(!t){e.abort(new Error("Asset rendering exceeded maxDurationMs."));return}const r={code:"asset-budget-exceeded",message:"Asset rendering exceeded maxDurationMs.",severity:"warning",format:n.options.format??"dom",pageIndex:t.pageIndex,componentIndex:t.componentIndex,componentPath:t.componentPath,kind:t.component.kind,nid:t.component.nid};n.diagnostics.push(r);try{k.notifyOutputDiagnostic(r,{...n.options,signal:n.signal})}catch(o){e.abort(o);return}e.abort(new p(r))}async function C(n,e,t,r,o){if(!e?.children?.length)return e;const s=[];for(const[i,c]of e.children.entries())s.push(await I(n,c,{...t,component:c,componentPath:[...r,i]},o));return s.some((i,c)=>i!==e.children[c])?{...e,children:s}:e}async function I(n,e,t,r){if(f(n.signal),r.has(e))throw new TypeError("Cyclic grid children cannot be rendered.");let o=n.cache.get(e);o||(o=D(n,e,t),n.cache.set(e,o));const s=await o;f(n.signal);let i=e.grid;if(i){const c=new Set(r).add(e),d=[];for(const[a,u]of i.cells.entries()){const g=[];for(const[l,M]of u.entries())g.push(await C(n,M,t,[...t.componentPath,a,l],c));d.push(g)}d.some((a,u)=>a.some((g,l)=>g!==i.cells[u][l]))&&(i={...i,cells:d})}return s!==e.imageData||i!==e.grid?{...e,imageData:s,grid:i}:e}async function R(n,e={}){const t=O(e);if(e.signal?.aborted)throw e.signal.reason??new DOMException("The operation was aborted.","AbortError");const r=new AbortController,o=()=>r.abort(e.signal?.reason);if(e.signal?.addEventListener("abort",o,{once:!0}),!e.assetRenderers||!Object.keys(e.assetRenderers).length)return e.signal?.removeEventListener("abort",o),{plan:n,diagnostics:[]};const s={options:e,signal:r.signal,diagnostics:[],rendered:0,bytes:0,budget:t,cache:new WeakMap},i=setTimeout(()=>T(s,r),t.maxDurationMs);try{const c=[];for(const[d,a]of n.pages.entries()){if(d<(e.start??0)||d>(e.end??n.pages.length-1)){c.push(a);continue}const u=[];for(const[g,l]of a.components.entries())u.push(await I(s,l,{component:l,pageIndex:d,componentIndex:g,componentPath:[]},new Set));c.push(u.some((g,l)=>g!==a.components[l])?{...a,components:u}:a)}return f(s.signal),{plan:c.some((d,a)=>d!==n.pages[a])?{...n,pages:c}:n,diagnostics:s.diagnostics}}finally{clearTimeout(i),e.signal?.removeEventListener("abort",o)}}exports.OutputAssetError=p;exports.resolveGridStrokes=B;exports.resolvePlanAssets=R;
+"use strict";const m=require("./style-UgIJSA1F.cjs"),k=require("./capabilities-DYzWL7KS.cjs"),E=require("./progress-BnLiS5eH.cjs"),S=["borderTop","borderRight","borderBottom","borderLeft","borderColor","lineColor","lineWidthPt"];function y(n,e){const t=m.resolveBoxBorders(e.style),r=t.inner?[...n.edges]:[];t.top&&r.push({kind:"h",pos:0,from:0,to:e.widthMm}),t.bottom&&r.push({kind:"h",pos:e.heightMm,from:0,to:e.widthMm}),t.left&&r.push({kind:"v",pos:0,from:0,to:e.heightMm}),t.right&&r.push({kind:"v",pos:e.widthMm,from:0,to:e.heightMm});const o=m.resolveStroke(e.style);return r.map(s=>({...s,...o}))}function x(n,e,t){const r=n.get(e);(!r||t.widthPt>r.widthPt)&&n.set(e,t)}function w(n,e,t,r,o,s){const i=t<e.rows.length?e.rows[t].pos:e.rows[e.rows.length-1].pos+e.rows[e.rows.length-1].size;for(let c=r;c<o;c++){const d=e.columns[c];x(n,`h:${t}:${c}`,{kind:"h",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function b(n,e,t,r,o,s){const i=t<e.columns.length?e.columns[t].pos:e.columns[e.columns.length-1].pos+e.columns[e.columns.length-1].size;for(let c=r;c<o;c++){const d=e.rows[c];x(n,`v:${t}:${c}`,{kind:"v",pos:i,from:d.pos,to:d.pos+d.size,...s})}}function v(n,e,t,r){const o=Math.min(e.columns.length,t.ci+(t.cell.colSpan??1)),s=Math.min(e.rows.length,t.ri+(t.cell.rowSpan??1)),i=m.mergeComponentStyles(r,t.cell.style),c=m.resolveBoxBorders(i),d=m.resolveStroke(i);c.top&&w(n,e,t.ri,t.ci,o,d),c.bottom&&w(n,e,s,t.ci,o,d),c.left&&b(n,e,t.ci,t.ri,s,d),c.right&&b(n,e,o,t.ri,s,d)}function A(n){const e=[...n.values()].sort((r,o)=>r.kind.localeCompare(o.kind)||r.pos-o.pos||r.from-o.from),t=[];for(const r of e){const o=t[t.length-1];o&&o.kind===r.kind&&o.pos===r.pos&&Math.abs(o.to-r.from)<1e-6&&o.color===r.color&&o.widthPt===r.widthPt?o.to=r.to:t.push({...r})}return t}function B(n,e){if(!n.cells.some(({cell:s})=>S.some(i=>s.style?.[i]!==void 0)))return y(n,e);const t=new Map,r=new Set,o=n.columns.length;for(const s of n.cells){v(t,n,s,e.style);const i=Math.min(n.rows.length,s.ri+(s.cell.rowSpan??1)),c=Math.min(o,s.ci+(s.cell.colSpan??1));for(let d=s.ri;d<i;d++)for(let a=s.ci;a<c;a++)r.add(d*o+a)}for(let s=0;s<n.rows.length;s++)for(let i=0;i<o;i++)r.has(s*o+i)||v(t,n,{ri:s,ci:i,cell:{}},e.style);return A(t)}class p extends Error{constructor(e,t){super(e.message),this.name="OutputAssetError",this.diagnostic=e,this.cause=t}}function f(n){if(n.aborted)throw n.reason??new DOMException("The operation was aborted.","AbortError")}function O(n){const e={maxAssets:1e3,maxImageBytes:33554432,maxTotalImageBytes:134217728,maxDurationMs:3e4,...n.assetBudget};for(const[t,r]of Object.entries(e))if(!Number.isSafeInteger(r)||r<=0||r>2147483647)throw new RangeError(`${t} must be a positive safe integer at most 2147483647.`);return e}function P(n){const e=/^data:image\/[a-z0-9.+-]+(;base64)?,(.*)$/is.exec(n);if(!e)throw new TypeError("Asset renderers must return an image data URL.");return e[1]?Math.ceil(e[2].length*3/4):new TextEncoder().encode(decodeURIComponent(e[2])).byteLength}function h(n,e,t,r,o){const s={code:t,message:r,severity:"warning",format:n.options.format??"dom",pageIndex:e.pageIndex,componentIndex:e.componentIndex,componentPath:e.componentPath,kind:e.component.kind,nid:e.component.nid};if(n.diagnostics.push(s),k.notifyOutputDiagnostic(s,{...n.options,signal:n.signal}),n.options.assetFailure!=="placeholder")throw new p(s,o)}async function D(n,e,t){const r=n.options.assetRenderers?.[e.kind];if(e.imageData||!r)return e.imageData;if(++n.rendered>n.budget.maxAssets)return h(n,t,"asset-budget-exceeded","Output exceeded the asset count budget.");let o;try{if(n.active=t,o=await E.waitForOutput(r({...t,signal:n.signal}),n.signal),f(n.signal),o.length>n.budget.maxImageBytes*4+1024)return h(n,t,"asset-budget-exceeded","Output exceeded the image payload byte budget.");const s=P(o);if(s>n.budget.maxImageBytes||n.bytes+s>n.budget.maxTotalImageBytes)return h(n,t,"asset-budget-exceeded","Output exceeded the encoded image byte budget.");n.bytes+=s}catch(s){if(n.signal.aborted||s instanceof p)throw s;return h(n,t,"asset-render-failed",`Asset renderer failed for ${e.kind}; output was not silently omitted.`,s)}return o}function T(n,e){const t=n.active;if(!t){e.abort(new Error("Asset rendering exceeded maxDurationMs."));return}const r={code:"asset-budget-exceeded",message:"Asset rendering exceeded maxDurationMs.",severity:"warning",format:n.options.format??"dom",pageIndex:t.pageIndex,componentIndex:t.componentIndex,componentPath:t.componentPath,kind:t.component.kind,nid:t.component.nid};n.diagnostics.push(r);try{k.notifyOutputDiagnostic(r,{...n.options,signal:n.signal})}catch(o){e.abort(o);return}e.abort(new p(r))}async function C(n,e,t,r,o){if(!e?.children?.length)return e;const s=[];for(const[i,c]of e.children.entries())s.push(await I(n,c,{...t,component:c,componentPath:[...r,i]},o));return s.some((i,c)=>i!==e.children[c])?{...e,children:s}:e}async function I(n,e,t,r){if(f(n.signal),r.has(e))throw new TypeError("Cyclic grid children cannot be rendered.");let o=n.cache.get(e);o||(o=D(n,e,t),n.cache.set(e,o));const s=await o;f(n.signal);let i=e.grid;if(i){const c=new Set(r).add(e),d=[];for(const[a,u]of i.cells.entries()){const g=[];for(const[l,M]of u.entries())g.push(await C(n,M,t,[...t.componentPath,a,l],c));d.push(g)}d.some((a,u)=>a.some((g,l)=>g!==i.cells[u][l]))&&(i={...i,cells:d})}return s!==e.imageData||i!==e.grid?{...e,imageData:s,grid:i}:e}async function R(n,e={}){const t=O(e);if(e.signal?.aborted)throw e.signal.reason??new DOMException("The operation was aborted.","AbortError");const r=new AbortController,o=()=>r.abort(e.signal?.reason);if(e.signal?.addEventListener("abort",o,{once:!0}),!e.assetRenderers||!Object.keys(e.assetRenderers).length)return e.signal?.removeEventListener("abort",o),{plan:n,diagnostics:[]};const s={options:e,signal:r.signal,diagnostics:[],rendered:0,bytes:0,budget:t,cache:new WeakMap},i=setTimeout(()=>T(s,r),t.maxDurationMs);try{const c=[];for(const[d,a]of n.pages.entries()){if(d<(e.start??0)||d>(e.end??n.pages.length-1)){c.push(a);continue}const u=[];for(const[g,l]of a.components.entries())u.push(await I(s,l,{component:l,pageIndex:d,componentIndex:g,componentPath:[]},new Set));c.push(u.some((g,l)=>g!==a.components[l])?{...a,components:u}:a)}return f(s.signal),{plan:c.some((d,a)=>d!==n.pages[a])?{...n,pages:c}:n,diagnostics:s.diagnostics}}finally{clearTimeout(i),e.signal?.removeEventListener("abort",o)}}exports.OutputAssetError=p;exports.resolveGridStrokes=B;exports.resolvePlanAssets=R;