a-calc 3.0.0-beta.20260130.1 → 3.0.0-beta.20260130.2

package/calc.d.ts

@@ -206,6 +206,63 @@ export const calc_space: CalcSpace;
  * ```
  */
 export const calc_sum: CalcSum;
+
+/**
+ * 计算数组中每个元素的表达式值并求平均值
+ * @param expr 一个字符串算术式，可包含格式化指令
+ * @param options_arr 数据源的集合
+ * @returns 返回平均值结果
+ *
+ * @example:
+ * ```typescript
+ * calc_avg("score", [{score: 80}, {score: 90}, {score: 100}]) // '90'
+ * calc_avg("score | =2", [{score: 80}, {score: 90}]) // '85.00'
+ * ```
+ */
+export const calc_avg: CalcSum;
+
+/**
+ * 计算数组中每个元素的表达式值并返回最大值
+ * @param expr 一个字符串算术式，可包含格式化指令
+ * @param options_arr 数据源的集合
+ * @returns 返回最大值结果
+ *
+ * @example:
+ * ```typescript
+ * calc_max("price", [{price: 10}, {price: 30}, {price: 20}]) // '30'
+ * calc_max("price * qty | =2", [{price: 10, qty: 2}, {price: 5, qty: 3}]) // '20.00'
+ * ```
+ */
+export const calc_max: CalcSum;
+
+/**
+ * 计算数组中每个元素的表达式值并返回最小值
+ * @param expr 一个字符串算术式，可包含格式化指令
+ * @param options_arr 数据源的集合
+ * @returns 返回最小值结果
+ *
+ * @example:
+ * ```typescript
+ * calc_min("price", [{price: 10}, {price: 30}, {price: 20}]) // '10'
+ * calc_min("stock | =0", [{stock: 50}, {stock: 10}, {stock: 30}]) // '10'
+ * ```
+ */
+export const calc_min: CalcSum;
+
+/**
+ * 统计数组中表达式结果为真值（非零）的数量
+ * @param expr 一个字符串算术式，可包含格式化指令
+ * @param options_arr 数据源的集合
+ * @returns 返回满足条件的数量
+ *
+ * @example:
+ * ```typescript
+ * calc_count("stock > 0", [{stock: 10}, {stock: 0}, {stock: 5}]) // '2'
+ * calc_count("active", [{active: 1}, {active: 0}, {active: 1}]) // '2'
+ * ```
+ */
+export const calc_count: CalcSum;
+
 /**
  * 专用格式化函数，用于对数字进行格式化处理
  * 相比 calc，它跳过表达式解析，性能更好