amis-formula 3.4.2 → 3.4.3

package/esm/doc.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 
@@ -443,6 +443,28 @@ var doc = [
         },
         namespace: "数学函数"
     },
+    {
+        name: "POW",
+        description: "返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。",
+        example: "POW(base, exponent)",
+        params: [
+            {
+                type: "number",
+                name: "base",
+                description: "基数"
+            },
+            {
+                type: "number",
+                name: "exponent",
+                description: "指数"
+            }
+        ],
+        returns: {
+            type: "number",
+            description: "基数的指数次幂"
+        },
+        namespace: "数学函数"
+    },
     {
         name: "LEFT",
         description: "返回传入文本左侧的指定长度字符串。",

package/esm/doc.md

@@ -268,6 +268,17 @@
 
 取数据最后一个。
 
+### POW
+
+用法：`POW(base, exponent)`
+
+ * `base:number` 基数
+ * `exponent:number` 指数
+
+返回：`number` 基数的指数次幂
+
+返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+
 ## 文本函数
 
 ### LEFT

package/esm/error.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/evalutor.d.ts

@@ -137,6 +137,19 @@ export declare class Evaluator {
         value: any;
         raw: string;
     }): any;
+    /**
+     * 名字空间下获取变量，可能存在变量名中带-的特殊情况，目前无法直接获取 ${ns:xxx-xxx}
+     * 想借助 ${ns:&['xxx-xxx']} 用法来支持特殊字符。
+     *
+     * 而 cookie, localstorage, sessionstorage 都不支持获取全量数据，如 ${ns: &}
+     * 所以当存在上述用法时，将 & 作为一个占位
+     *
+     * 比如 cookie 中有一个 key 为 xxx-xxx 的值，那么可以通过 &['xxx-xxx'] 来获取。
+     * 而无法通过 ${cookie:xxx-xxx} 来获取。 因为这样会被认为是减操作
+     * @param ast
+     * @returns
+     */
+    convertHostGetterToVariable(ast: any): any;
     nsVariable(ast: {
         namespace: string;
         body: any;
@@ -451,6 +464,17 @@ export declare class Evaluator {
      * @returns {any} 最后一个值
      */
     fnLAST(arr: Array<any>): any;
+    /**
+     * 返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+     *
+     * @example POW(base, exponent)
+     * @param {number} base 基数
+     * @param {number} exponent 指数
+     * @namespace 数学函数
+     *
+     * @returns {number} 基数的指数次幂
+     */
+    fnPOW(base: number, exponent: number): number;
     normalizeText(raw: any): string;
     /**
      * 返回传入文本左侧的指定长度字符串。

package/esm/evalutor.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 
@@ -15,6 +15,7 @@ import uniqBy from 'lodash/uniqBy';
 import isEqual from 'lodash/isEqual';
 import isPlainObject from 'lodash/isPlainObject';
 import get from 'lodash/get';
+import isNumber from 'lodash/isNumber';
 import { FormulaEvalError } from './error.js';
 
 /**
@@ -292,19 +293,66 @@ var Evaluator = /** @class */ (function () {
         // todo 以后可以在这支持大数字。
         return ast.value;
     };
+    /**
+     * 名字空间下获取变量，可能存在变量名中带-的特殊情况，目前无法直接获取 ${ns:xxx-xxx}
+     * 想借助 ${ns:&['xxx-xxx']} 用法来支持特殊字符。
+     *
+     * 而 cookie, localstorage, sessionstorage 都不支持获取全量数据，如 ${ns: &}
+     * 所以当存在上述用法时，将 & 作为一个占位
+     *
+     * 比如 cookie 中有一个 key 为 xxx-xxx 的值，那么可以通过 &['xxx-xxx'] 来获取。
+     * 而无法通过 ${cookie:xxx-xxx} 来获取。 因为这样会被认为是减操作
+     * @param ast
+     * @returns
+     */
+    Evaluator.prototype.convertHostGetterToVariable = function (ast) {
+        var _a, _b;
+        if (ast.type !== 'getter') {
+            return ast;
+        }
+        var gettter = ast;
+        var keys = [];
+        while (((_a = gettter.host) === null || _a === void 0 ? void 0 : _a.type) === 'getter') {
+            keys.push('host');
+            gettter = gettter.host;
+        }
+        if (((_b = gettter.host) === null || _b === void 0 ? void 0 : _b.type) === 'variable' && gettter.host.name === '&') {
+            var ret = {
+                host: ast
+            };
+            var host = keys.reduce(function (host, key) {
+                host[key] = __assign({}, host[key]);
+                return host[key];
+            }, ret);
+            host.host = {
+                start: host.host.start,
+                end: host.host.end,
+                type: 'variable',
+                name: this.evalute(host.host.key)
+            };
+            return ret.host;
+        }
+        return ast;
+    };
     Evaluator.prototype.nsVariable = function (ast) {
+        var _this = this;
+        var body = ast.body;
         if (ast.namespace === 'window') {
             this.contextStack.push(function (name) {
                 return name === '&' ? window : window[name];
             });
         }
         else if (ast.namespace === 'cookie') {
+            // 可能会利用 &['xxx-xxx'] 来取需要特殊变量
+            body = this.convertHostGetterToVariable(body);
             this.contextStack.push(function (name) {
                 return getCookie(name);
             });
         }
         else if (ast.namespace === 'ls' || ast.namespace === 'ss') {
             var ns_1 = ast.namespace;
+            // 可能会利用 &['xxx-xxx'] 来取需要特殊变量
+            body = this.convertHostGetterToVariable(body);
             this.contextStack.push(function (name) {
                 var raw = ns_1 === 'ss'
                     ? sessionStorage.getItem(name)
@@ -324,8 +372,10 @@ var Evaluator = /** @class */ (function () {
         else {
             throw new Error('Unsupported namespace: ' + ast.namespace);
         }
-        var result = this.evalute(ast.body);
-        this.contextStack.pop();
+        var result = this.evalute(body);
+        (result === null || result === void 0 ? void 0 : result.then)
+            ? result.then(function () { return _this.contextStack.pop(); })
+            : this.contextStack.pop();
         return result;
     };
     Evaluator.prototype.variable = function (ast) {
@@ -918,6 +968,22 @@ var Evaluator = /** @class */ (function () {
     Evaluator.prototype.fnLAST = function (arr) {
         return arr.length ? arr[arr.length - 1] : null;
     };
+    /**
+     * 返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+     *
+     * @example POW(base, exponent)
+     * @param {number} base 基数
+     * @param {number} exponent 指数
+     * @namespace 数学函数
+     *
+     * @returns {number} 基数的指数次幂
+     */
+    Evaluator.prototype.fnPOW = function (base, exponent) {
+        if (!isNumber(base) || !isNumber(exponent)) {
+            return base;
+        }
+        return Math.pow(base, exponent);
+    };
     // 文本函数
     Evaluator.prototype.normalizeText = function (raw) {
         if (raw instanceof Date) {
@@ -1147,6 +1213,7 @@ var Evaluator = /** @class */ (function () {
     Evaluator.prototype.fnBEFORELAST = function (text, delimiter) {
         if (delimiter === void 0) { delimiter = '.'; }
         text = this.normalizeText(text);
+        delimiter = this.normalizeText(delimiter);
         return text.split(delimiter).slice(0, -1).join(delimiter) || text + '';
     };
     /**
@@ -1226,6 +1293,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnSTARTSWITH = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1243,6 +1311,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnENDSWITH = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1260,6 +1329,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnCONTAINS = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1279,7 +1349,12 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnREPLACE = function (text, search, replace) {
         text = this.normalizeText(text);
+        search = this.normalizeText(search);
+        replace = this.normalizeText(replace);
         var result = text;
+        if (typeof replace === 'undefined' || !search) {
+            return result;
+        }
         while (true) {
             var idx = result.indexOf(search);
             if (!~idx) {
@@ -1305,10 +1380,11 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnSEARCH = function (text, search, start) {
         if (start === void 0) { start = 0; }
+        search = this.normalizeText(search);
         text = this.normalizeText(text);
         start = this.formatNumber(start);
         var idx = text.indexOf(search, start);
-        if (~idx) {
+        if (~idx && search) {
             return idx;
         }
         return -1;
@@ -1326,6 +1402,8 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnMID = function (text, from, len) {
         text = this.normalizeText(text);
+        from = this.formatNumber(from);
+        len = this.formatNumber(len);
         return text.substring(from, from + len);
     };
     /**

package/esm/evalutorForAsync.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/filter.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/function.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/index.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/lexer.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/esm/parser.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/doc.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 
@@ -447,6 +447,28 @@ var doc = [
         },
         namespace: "数学函数"
     },
+    {
+        name: "POW",
+        description: "返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。",
+        example: "POW(base, exponent)",
+        params: [
+            {
+                type: "number",
+                name: "base",
+                description: "基数"
+            },
+            {
+                type: "number",
+                name: "exponent",
+                description: "指数"
+            }
+        ],
+        returns: {
+            type: "number",
+            description: "基数的指数次幂"
+        },
+        namespace: "数学函数"
+    },
     {
         name: "LEFT",
         description: "返回传入文本左侧的指定长度字符串。",

package/lib/doc.md

@@ -268,6 +268,17 @@
 
 取数据最后一个。
 
+### POW
+
+用法：`POW(base, exponent)`
+
+ * `base:number` 基数
+ * `exponent:number` 指数
+
+返回：`number` 基数的指数次幂
+
+返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+
 ## 文本函数
 
 ### LEFT

package/lib/error.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/evalutor.d.ts

@@ -137,6 +137,19 @@ export declare class Evaluator {
         value: any;
         raw: string;
     }): any;
+    /**
+     * 名字空间下获取变量，可能存在变量名中带-的特殊情况，目前无法直接获取 ${ns:xxx-xxx}
+     * 想借助 ${ns:&['xxx-xxx']} 用法来支持特殊字符。
+     *
+     * 而 cookie, localstorage, sessionstorage 都不支持获取全量数据，如 ${ns: &}
+     * 所以当存在上述用法时，将 & 作为一个占位
+     *
+     * 比如 cookie 中有一个 key 为 xxx-xxx 的值，那么可以通过 &['xxx-xxx'] 来获取。
+     * 而无法通过 ${cookie:xxx-xxx} 来获取。 因为这样会被认为是减操作
+     * @param ast
+     * @returns
+     */
+    convertHostGetterToVariable(ast: any): any;
     nsVariable(ast: {
         namespace: string;
         body: any;
@@ -451,6 +464,17 @@ export declare class Evaluator {
      * @returns {any} 最后一个值
      */
     fnLAST(arr: Array<any>): any;
+    /**
+     * 返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+     *
+     * @example POW(base, exponent)
+     * @param {number} base 基数
+     * @param {number} exponent 指数
+     * @namespace 数学函数
+     *
+     * @returns {number} 基数的指数次幂
+     */
+    fnPOW(base: number, exponent: number): number;
     normalizeText(raw: any): string;
     /**
      * 返回传入文本左侧的指定长度字符串。

package/lib/evalutor.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 
@@ -19,6 +19,7 @@ var uniqBy = require('lodash/uniqBy');
 var isEqual = require('lodash/isEqual');
 var isPlainObject = require('lodash/isPlainObject');
 var get = require('lodash/get');
+var isNumber = require('lodash/isNumber');
 var error = require('./error.js');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
@@ -34,6 +35,7 @@ var uniqBy__default = /*#__PURE__*/_interopDefaultLegacy(uniqBy);
 var isEqual__default = /*#__PURE__*/_interopDefaultLegacy(isEqual);
 var isPlainObject__default = /*#__PURE__*/_interopDefaultLegacy(isPlainObject);
 var get__default = /*#__PURE__*/_interopDefaultLegacy(get);
+var isNumber__default = /*#__PURE__*/_interopDefaultLegacy(isNumber);
 
 /**
  * @file 公式内置函数
@@ -310,19 +312,66 @@ var Evaluator = /** @class */ (function () {
         // todo 以后可以在这支持大数字。
         return ast.value;
     };
+    /**
+     * 名字空间下获取变量，可能存在变量名中带-的特殊情况，目前无法直接获取 ${ns:xxx-xxx}
+     * 想借助 ${ns:&['xxx-xxx']} 用法来支持特殊字符。
+     *
+     * 而 cookie, localstorage, sessionstorage 都不支持获取全量数据，如 ${ns: &}
+     * 所以当存在上述用法时，将 & 作为一个占位
+     *
+     * 比如 cookie 中有一个 key 为 xxx-xxx 的值，那么可以通过 &['xxx-xxx'] 来获取。
+     * 而无法通过 ${cookie:xxx-xxx} 来获取。 因为这样会被认为是减操作
+     * @param ast
+     * @returns
+     */
+    Evaluator.prototype.convertHostGetterToVariable = function (ast) {
+        var _a, _b;
+        if (ast.type !== 'getter') {
+            return ast;
+        }
+        var gettter = ast;
+        var keys = [];
+        while (((_a = gettter.host) === null || _a === void 0 ? void 0 : _a.type) === 'getter') {
+            keys.push('host');
+            gettter = gettter.host;
+        }
+        if (((_b = gettter.host) === null || _b === void 0 ? void 0 : _b.type) === 'variable' && gettter.host.name === '&') {
+            var ret = {
+                host: ast
+            };
+            var host = keys.reduce(function (host, key) {
+                host[key] = tslib.__assign({}, host[key]);
+                return host[key];
+            }, ret);
+            host.host = {
+                start: host.host.start,
+                end: host.host.end,
+                type: 'variable',
+                name: this.evalute(host.host.key)
+            };
+            return ret.host;
+        }
+        return ast;
+    };
     Evaluator.prototype.nsVariable = function (ast) {
+        var _this = this;
+        var body = ast.body;
         if (ast.namespace === 'window') {
             this.contextStack.push(function (name) {
                 return name === '&' ? window : window[name];
             });
         }
         else if (ast.namespace === 'cookie') {
+            // 可能会利用 &['xxx-xxx'] 来取需要特殊变量
+            body = this.convertHostGetterToVariable(body);
             this.contextStack.push(function (name) {
                 return getCookie(name);
             });
         }
         else if (ast.namespace === 'ls' || ast.namespace === 'ss') {
             var ns_1 = ast.namespace;
+            // 可能会利用 &['xxx-xxx'] 来取需要特殊变量
+            body = this.convertHostGetterToVariable(body);
             this.contextStack.push(function (name) {
                 var raw = ns_1 === 'ss'
                     ? sessionStorage.getItem(name)
@@ -342,8 +391,10 @@ var Evaluator = /** @class */ (function () {
         else {
             throw new Error('Unsupported namespace: ' + ast.namespace);
         }
-        var result = this.evalute(ast.body);
-        this.contextStack.pop();
+        var result = this.evalute(body);
+        (result === null || result === void 0 ? void 0 : result.then)
+            ? result.then(function () { return _this.contextStack.pop(); })
+            : this.contextStack.pop();
         return result;
     };
     Evaluator.prototype.variable = function (ast) {
@@ -936,6 +987,22 @@ var Evaluator = /** @class */ (function () {
     Evaluator.prototype.fnLAST = function (arr) {
         return arr.length ? arr[arr.length - 1] : null;
     };
+    /**
+     * 返回基数的指数次幂，参数base为基数，exponent为指数，如果参数值不合法则返回基数本身，计算结果不合法，则返回NaN。
+     *
+     * @example POW(base, exponent)
+     * @param {number} base 基数
+     * @param {number} exponent 指数
+     * @namespace 数学函数
+     *
+     * @returns {number} 基数的指数次幂
+     */
+    Evaluator.prototype.fnPOW = function (base, exponent) {
+        if (!isNumber__default["default"](base) || !isNumber__default["default"](exponent)) {
+            return base;
+        }
+        return Math.pow(base, exponent);
+    };
     // 文本函数
     Evaluator.prototype.normalizeText = function (raw) {
         if (raw instanceof Date) {
@@ -1165,6 +1232,7 @@ var Evaluator = /** @class */ (function () {
     Evaluator.prototype.fnBEFORELAST = function (text, delimiter) {
         if (delimiter === void 0) { delimiter = '.'; }
         text = this.normalizeText(text);
+        delimiter = this.normalizeText(delimiter);
         return text.split(delimiter).slice(0, -1).join(delimiter) || text + '';
     };
     /**
@@ -1244,6 +1312,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnSTARTSWITH = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1261,6 +1330,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnENDSWITH = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1278,6 +1348,7 @@ var Evaluator = /** @class */ (function () {
      * @returns {string} 判断结果
      */
     Evaluator.prototype.fnCONTAINS = function (text, search) {
+        search = this.normalizeText(search);
         if (!search) {
             return false;
         }
@@ -1297,7 +1368,12 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnREPLACE = function (text, search, replace) {
         text = this.normalizeText(text);
+        search = this.normalizeText(search);
+        replace = this.normalizeText(replace);
         var result = text;
+        if (typeof replace === 'undefined' || !search) {
+            return result;
+        }
         while (true) {
             var idx = result.indexOf(search);
             if (!~idx) {
@@ -1323,10 +1399,11 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnSEARCH = function (text, search, start) {
         if (start === void 0) { start = 0; }
+        search = this.normalizeText(search);
         text = this.normalizeText(text);
         start = this.formatNumber(start);
         var idx = text.indexOf(search, start);
-        if (~idx) {
+        if (~idx && search) {
             return idx;
         }
         return -1;
@@ -1344,6 +1421,8 @@ var Evaluator = /** @class */ (function () {
      */
     Evaluator.prototype.fnMID = function (text, from, len) {
         text = this.normalizeText(text);
+        from = this.formatNumber(from);
+        len = this.formatNumber(len);
         return text.substring(from, from + len);
     };
     /**

package/lib/evalutorForAsync.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/filter.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/function.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/lexer.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/lib/parser.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.4.2
+ * amis-formula v3.4.3
  * Copyright 2021-2023 fex
  */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amis-formula",
-  "version": "3.4.2",
+  "version": "3.4.3",
   "description": "负责 amis 里面的表达式实现，内置公式，编辑器等",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -118,5 +118,5 @@
       "printBasicPrototype": false
     }
   },
-  "gitHead": "5d42aff860763acd557a228bc0d774c71d4e041c"
+  "gitHead": "a0973fc96e9308311a2002e76cfaf9ee39ad7118"
 }