amis-formula 1.3.12 → 1.3.15

package/README.md

@@ -1,4 +1,4 @@
-# amis-tpl
+# amis-formula
 
 负责 amis 里面的表达式、公式及模板的实现
 

package/dist/doc.js

@@ -121,7 +121,7 @@ exports.doc = [
   },
   {
     name: "MAX",
-    description: "获取最大值",
+    description: "获取最大值，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "MAX(num1, num2, ...numN)",
     params: [
       {
@@ -138,7 +138,7 @@ exports.doc = [
   },
   {
     name: "MIN",
-    description: "获取最小值",
+    description: "获取最小值，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "MIN(num1, num2, ...numN)",
     params: [
       {
@@ -155,7 +155,7 @@ exports.doc = [
   },
   {
     name: "SUM",
-    description: "求和",
+    description: "求和，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "SUM(num1, num2, ...numN)",
     params: [
       {
@@ -305,7 +305,7 @@ exports.doc = [
   },
   {
     name: "AVG",
-    description: "返回所有参数的平均值",
+    description: "返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "AVG(num1, num2, ...numN)",
     params: [
       {
@@ -322,7 +322,7 @@ exports.doc = [
   },
   {
     name: "DEVSQ",
-    description: "返回数据点与数据均值点之差（数据偏差）的平方和",
+    description: "返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "DEVSQ(num1, num2, ...numN)",
     params: [
       {
@@ -356,7 +356,7 @@ exports.doc = [
   },
   {
     name: "HARMEAN",
-    description: "数据点的调和平均值",
+    description: "数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值",
     example: "HARMEAN(num1, num2, ...numN)",
     params: [
       {
@@ -1443,7 +1443,7 @@ exports.doc = [
       type: "boolean",
       description: "结果"
     },
-    namespace: "其他"
+    namespace: "数组"
   },
   {
     name: "ARRAYMAP",
@@ -1465,6 +1465,45 @@ exports.doc = [
       type: "boolean",
       description: "结果"
     },
-    namespace: "其他"
+    namespace: "数组"
+  },
+  {
+    name: "COMPACT",
+    description: "数组过滤掉 false、null、0 和 \"\"\n\n示例：\n\nCOMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]",
+    example: "COMPACT(arr)",
+    params: [
+      {
+        type: "Array<any>",
+        name: "arr",
+        description: "数组"
+      }
+    ],
+    returns: {
+      type: "Array<any>",
+      description: "结果"
+    },
+    namespace: "数组"
+  },
+  {
+    name: "JOIN",
+    description: "数组转成字符串\n\n示例：\n\nJOIN(['a', 'b', 'c'], '~') 得到 'a~b~c'",
+    example: "JOIN(arr, string)",
+    params: [
+      {
+        type: "Array<any>",
+        name: "arr",
+        description: "数组"
+      },
+      {
+        type: "String",
+        name: "separator",
+        description: "分隔符"
+      }
+    ],
+    returns: {
+      type: "String",
+      description: "结果"
+    },
+    namespace: "数组"
   }
 ]

package/dist/doc.md

@@ -93,7 +93,7 @@
 
 返回：`number` 所有传入值中最大的那个
 
-获取最大值
+获取最大值，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### MIN
 
@@ -103,7 +103,7 @@
 
 返回：`number` 所有传入值中最小的那个
 
-获取最小值
+获取最小值，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### SUM
 
@@ -113,7 +113,7 @@
 
 返回：`number` 所有传入数值的总和
 
-求和
+求和，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### INT
 
@@ -193,7 +193,7 @@
 
 返回：`number` 所有数值的平均值
 
-返回所有参数的平均值
+返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### DEVSQ
 
@@ -203,7 +203,7 @@
 
 返回：`number` 所有数值的平均值
 
-返回数据点与数据均值点之差（数据偏差）的平方和
+返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### AVEDEV
 
@@ -223,7 +223,7 @@
 
 返回：`number` 所有数值的平均值
 
-数据点的调和平均值
+数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值
 
 ### LARGE
 
@@ -828,7 +828,7 @@ DATEMODIFY(A, -2, 'month')
 
 判断两个日期，是否第一个日期在第二个日期的后面或者相等
 
-## 其他
+## 数组
 
 ### COUNT
 
@@ -851,3 +851,32 @@ DATEMODIFY(A, -2, 'month')
 
 数组做数据转换，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
 
+### COMPACT
+
+用法：`COMPACT(arr)`
+
+ * `arr:Array<any>` 数组
+
+返回：`Array<any>` 结果
+
+数组过滤掉 false、null、0 和 ""
+
+示例：
+
+COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]
+
+### JOIN
+
+用法：`JOIN(arr, string)`
+
+ * `arr:Array<any>` 数组
+ * `separator:String` 分隔符
+
+返回：`String` 结果
+
+数组转成字符串
+
+示例：
+
+JOIN(['a', 'b', 'c'], '~') 得到 'a~b~c'
+

package/dist/evalutor.d.ts

@@ -288,7 +288,7 @@ export declare class Evaluator {
      */
     fnABS(a: number): number;
     /**
-     * 获取最大值
+     * 获取最大值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example MAX(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -298,7 +298,7 @@ export declare class Evaluator {
      */
     fnMAX(...args: Array<any>): any;
     /**
-     * 获取最小值
+     * 获取最小值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example MIN(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -308,7 +308,7 @@ export declare class Evaluator {
      */
     fnMIN(...args: Array<number>): any;
     /**
-     * 求和
+     * 求和，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example SUM(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -391,7 +391,7 @@ export declare class Evaluator {
      */
     fnSQRT(n: number): number;
     /**
-     * 返回所有参数的平均值
+     * 返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example AVG(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -401,7 +401,7 @@ export declare class Evaluator {
      */
     fnAVG(...args: Array<any>): number;
     /**
-     * 返回数据点与数据均值点之差（数据偏差）的平方和
+     * 返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example DEVSQ(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -421,7 +421,7 @@ export declare class Evaluator {
      */
     fnAVEDEV(...args: Array<any>): number | null;
     /**
-     * 数据点的调和平均值
+     * 数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example HARMEAN(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -1020,7 +1020,7 @@ export declare class Evaluator {
      * 返回数组的长度
      *
      * @param {Array<any>} arr 数组
-     * @namespace 其他
+     * @namespace 数组
      * @example COUNT(arr)
      * @returns {boolean} 结果
      */
@@ -1030,9 +1030,36 @@ export declare class Evaluator {
      *
      * @param {Array<any>} arr 数组
      * @param {Function<any>} iterator 箭头函数
-     * @namespace 其他
+     * @namespace 数组
      * @example ARRAYMAP(arr, item => item)
      * @returns {boolean} 结果
      */
     fnARRAYMAP(value: any, iterator: any): any[];
+    /**
+     * 数组过滤掉 false、null、0 和 ""
+     *
+     * 示例：
+     *
+     * COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]
+     *
+     * @param {Array<any>} arr 数组
+     * @namespace 数组
+     * @example COMPACT(arr)
+     * @returns {Array<any>} 结果
+     */
+    fnCOMPACT(arr: any[]): any[];
+    /**
+     * 数组转成字符串
+     *
+     * 示例：
+     *
+     * JOIN(['a', 'b', 'c'], '~') 得到 'a~b~c'
+     *
+     * @param {Array<any>} arr 数组
+     * @param { String} separator 分隔符
+     * @namespace 数组
+     * @example JOIN(arr, string)
+     * @returns {String} 结果
+     */
+    fnJOIN(arr: any[], separator?: string): string;
 }

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v1.3.12
+ * amis-formula v1.3.15
  * Copyright 2021-2022 fex
  */
 
@@ -2168,6 +2168,12 @@ var Evaluator = /** @class */ (function () {
                     ? sessionStorage.getItem(name)
                     : localStorage.getItem(name);
                 if (typeof raw === 'string') {
+                    // 判断字符串是否一个纯数字字符串，如果是，则对比parse后的值和原值是否相同，
+                    // 如果不同则返回原值，因为原值如果是一个很长的纯数字字符串，则 parse 后可能会丢失精度
+                    if (/^\d+$/.test(raw)) {
+                        var parsed = JSON.parse(raw);
+                        return "".concat(parsed) === raw ? parsed : raw;
+                    }
                     return parseJson(raw, raw);
                 }
                 return undefined;
@@ -2364,7 +2370,7 @@ var Evaluator = /** @class */ (function () {
         return Math.abs(a);
     };
     /**
-     * 获取最大值
+     * 获取最大值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example MAX(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -2378,10 +2384,14 @@ var Evaluator = /** @class */ (function () {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        return Math.max.apply(Math, args.map(function (item) { return _this.formatNumber(item); }));
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        return Math.max.apply(Math, arr.map(function (item) { return _this.formatNumber(item); }));
     };
     /**
-     * 获取最小值
+     * 获取最小值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example MIN(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -2395,10 +2405,14 @@ var Evaluator = /** @class */ (function () {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        return Math.min.apply(Math, args.map(function (item) { return _this.formatNumber(item); }));
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        return Math.min.apply(Math, arr.map(function (item) { return _this.formatNumber(item); }));
     };
     /**
-     * 求和
+     * 求和，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example SUM(num1, num2, ...numN)
      * @param {...number} num - 数值
@@ -2412,7 +2426,11 @@ var Evaluator = /** @class */ (function () {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        return args.reduce(function (sum, a) { return sum + _this.formatNumber(a) || 0; }, 0);
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        return arr.reduce(function (sum, a) { return sum + _this.formatNumber(a) || 0; }, 0);
     };
     /**
      * 将数值向下取整为最接近的整数
@@ -2523,7 +2541,7 @@ var Evaluator = /** @class */ (function () {
         return Math.sqrt(this.formatNumber(n));
     };
     /**
-     * 返回所有参数的平均值
+     * 返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example AVG(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -2537,10 +2555,14 @@ var Evaluator = /** @class */ (function () {
         for (var _i = 0; _i < arguments.length; _i++) {
             args[_i] = arguments[_i];
         }
-        return (this.fnSUM.apply(this, args.map(function (item) { return _this.formatNumber(item); })) / args.length);
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        return (this.fnSUM.apply(this, arr.map(function (item) { return _this.formatNumber(item); })) / arr.length);
     };
     /**
-     * 返回数据点与数据均值点之差（数据偏差）的平方和
+     * 返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example DEVSQ(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -2557,7 +2579,11 @@ var Evaluator = /** @class */ (function () {
         if (args.length === 0) {
             return null;
         }
-        var nums = args.map(function (item) { return _this.formatNumber(item); });
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        var nums = arr.map(function (item) { return _this.formatNumber(item); });
         var sum = nums.reduce(function (sum, a) { return sum + a || 0; }, 0);
         var mean = sum / nums.length;
         var result = 0;
@@ -2585,7 +2611,11 @@ var Evaluator = /** @class */ (function () {
         if (args.length === 0) {
             return null;
         }
-        var nums = args.map(function (item) { return _this.formatNumber(item); });
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        var nums = arr.map(function (item) { return _this.formatNumber(item); });
         var sum = nums.reduce(function (sum, a) { return sum + a || 0; }, 0);
         var mean = sum / nums.length;
         var result = 0;
@@ -2596,7 +2626,7 @@ var Evaluator = /** @class */ (function () {
         return result / nums.length;
     };
     /**
-     * 数据点的调和平均值
+     * 数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值
      *
      * @example HARMEAN(num1, num2, ...numN)
      * @param {...number} num - 要处理的数字
@@ -2613,7 +2643,11 @@ var Evaluator = /** @class */ (function () {
         if (args.length === 0) {
             return null;
         }
-        var nums = args.map(function (item) { return _this.formatNumber(item); });
+        var arr = args;
+        if (args.length === 1 && Array.isArray(args[0])) {
+            arr = args[0];
+        }
+        var nums = arr.map(function (item) { return _this.formatNumber(item); });
         var den = 0;
         for (var _a = 0, nums_3 = nums; _a < nums_3.length; _a++) {
             var num = nums_3[_a];
@@ -3470,7 +3504,7 @@ var Evaluator = /** @class */ (function () {
      * 返回数组的长度
      *
      * @param {Array<any>} arr 数组
-     * @namespace 其他
+     * @namespace 数组
      * @example COUNT(arr)
      * @returns {boolean} 结果
      */
@@ -3482,7 +3516,7 @@ var Evaluator = /** @class */ (function () {
      *
      * @param {Array<any>} arr 数组
      * @param {Function<any>} iterator 箭头函数
-     * @namespace 其他
+     * @namespace 数组
      * @example ARRAYMAP(arr, item => item)
      * @returns {boolean} 结果
      */
@@ -3495,6 +3529,56 @@ var Evaluator = /** @class */ (function () {
             return _this.callAnonymousFunction(iterator, [item, index]);
         });
     };
+    /**
+     * 数组过滤掉 false、null、0 和 ""
+     *
+     * 示例：
+     *
+     * COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]
+     *
+     * @param {Array<any>} arr 数组
+     * @namespace 数组
+     * @example COMPACT(arr)
+     * @returns {Array<any>} 结果
+     */
+    Evaluator.prototype.fnCOMPACT = function (arr) {
+        if (Array.isArray(arr)) {
+            var resIndex = 0;
+            var result = [];
+            for (var _i = 0, arr_1 = arr; _i < arr_1.length; _i++) {
+                var item = arr_1[_i];
+                if (item) {
+                    result[resIndex++] = item;
+                }
+            }
+            return result;
+        }
+        else {
+            return [];
+        }
+    };
+    /**
+     * 数组转成字符串
+     *
+     * 示例：
+     *
+     * JOIN(['a', 'b', 'c'], '~') 得到 'a~b~c'
+     *
+     * @param {Array<any>} arr 数组
+     * @param { String} separator 分隔符
+     * @namespace 数组
+     * @example JOIN(arr, string)
+     * @returns {String} 结果
+     */
+    Evaluator.prototype.fnJOIN = function (arr, separator) {
+        if (separator === void 0) { separator = ''; }
+        if (Array.isArray(arr)) {
+            return arr.join(separator);
+        }
+        else {
+            return '';
+        }
+    };
     Evaluator.defaultFilters = {};
     return Evaluator;
 }());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amis-formula",
-  "version": "1.3.12",
+  "version": "1.3.15",
   "description": "负责 amis 里面的表达式实现，内置公式，编辑器等",
   "main": "dist/index.js",
   "scripts": {

package/rollup.config.js

@@ -30,6 +30,7 @@ export default {
       plugins: [
         isForLib && terser()
       ],
+      strict: !isForLib,
       footer: isForLib ? `var evaluate = formula.evaluate;
       var momentFormat = formula.momentFormat;
       var parse = formula.parse;` : '',
@@ -67,7 +68,8 @@ export default {
     json(),
     resolve({
       jsnext: true,
-      main: true
+      main: true,
+      browser: true
     }),
     typescript({
       typescript: require('typescript')