util-helpers 4.15.2 → 4.15.3

package/dist/util-helpers.js

@@ -537,7 +537,7 @@
   }
 
   // eslint-disable-next-line no-undef
-  var version = "4.15.2";
+  var version = "4.15.3";
 
   /**
    * 打印警告信息
@@ -2025,20 +2025,24 @@
    * @returns {string} 处理后的字符
    * @example
    *
-   * // 手机号
+   * // 手机号 前3后4
    * replaceChar('13000000000'); // 130****0000
    *
-   * // 身份证
-   * replaceChar('130701199310302288'); // 130***********2288
+   * // 身份证 前6后4
+   * replaceChar('130701199310302288', { start: 6, end: -4 }); // 130701********2288
    *
-   * // 邮箱
+   * // 邮箱 @前两位
    * const email = '12345@qq.com'
+   * const emailAtIndex = email.indexOf('@');
+   * replaceChar(email, { start: emailAtIndex - 2, end: emailAtIndex }); // 123**@qq.com
+   * // 邮箱 前2和@后面内容，固定替换字符4位
    * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4}); // 12****@qq.com
    *
-   * // 银行卡号
+   * // 银行卡号 只展示后4位，固定替换字符4位
    * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4}); // ****0018
-   *
-   * // 带格式的银行卡号，忽略空字符串
+   * // 银行卡号 前6后4
+   * replaceChar('6228480402564890018', { start: 6, end: -4 }); // 622848*********0018
+   * // 银行卡号 前4后3 忽略格式的空格
    * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '}); // 6228 **** **** **** 018
    *
    * // 用户名
@@ -2698,343 +2702,144 @@
   }
 
   /**
-   * 转换字段名，返回一个转换字段后的值，不改变原值。
-   * 
+   * 精确乘法，支持多个数相乘，乘数默认为 1 。
+   *
    * @static
-   * @alias module:Processor.transformFieldNames
-   * @since 4.14.0
-   * @template {*} D
-   * @template {Record<string, keyof D>} F
-   * @template {string} C
-   * @param {D[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
-   * @param {F} fieldNames 字段名映射
-   * @param {C} [childrenField] 子级数据字段名
-   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {import('./transformFieldNames.type.js').TransformFieldNames<D, F, C>}
+   * @alias module:Math.times
+   * @since 3.1.0
+   * @param {...number|string} nums 相乘的数
+   * @returns {number} 乘积
    * @example
+   *
+   * times(3, 0.6); // 1.8
+   * times(3, 0.6, 2); // 3.6
+   * times(3, 0.6, 2, 10); // 36
    * 
-   * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];
-   * const newOptions = transformFieldNames(options, {label: 'name', value: 'code'});
-   * // [{value: '1', label: 'one'},{value:'2', label:'two'}]
-   * 
-   * // 嵌套数据，指定子级字段名 children
-   * const options2 = [{code: '1', name: 'one'},{code:'2', name:'two', children: [{code:'2-1', name:'two-one', children: [{code: '2-1-1', name:'two-one-one'}]}]}];
-   * const newOptions2 = transformFieldNames(options2, {label: 'name', value: 'code'}, 'children');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one', children: [{value: '2-1-1', label:'two-one-one'}]}]}]
-   * 
-   * const options3 = [{code: '1', name: 'one'},{code:'2', name:'two', childs: [{code:'2-1', name:'two-one'}]}];
-   * const newOptions3 = transformFieldNames(options3, {label: 'name', value: 'code'}, 'childs');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', childs: [{value: '2-1', label:'two-one'}]}]
-   * 
-   * // 嵌套数据，并替换子集字段名
-   * const newOptions4 = transformFieldNames(options3, {label: 'name', value: 'code', children: 'childs'}, 'childs');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one'}]}]
    */
-  function transformFieldNames(data, fieldNames, childrenField) {
-    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
-    if (!Array.isArray(data)) {
-      return data;
+  function times() {
+    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+      nums[_key] = arguments[_key];
     }
-    if (data.length <= 0) {
-      // @ts-ignore
-      return [];
+    var num1 = nums[0],
+      _nums$ = nums[1],
+      num2 = _nums$ === void 0 ? 1 : _nums$,
+      rest = nums.slice(2);
+    if (rest.length > 0) {
+      return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
     }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
 
-    /**
-     * 递归处理字段名
-     * 
-     * @param {Array.<object>} arr 列表数据
-     * @returns {*}
-     */
-    function recusion(arr) {
-      return arr.map(function (item) {
-        if (!isObject(item)) {
-          return item;
-        }
-        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-        /** @type {Array.<string>} */
-        var delKeys = [];
-
-        // 树形数据子节点
-        // @ts-ignore
-        if (childrenField && Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
-          // @ts-ignore
-          newItem[childrenField] = recusion(newItem[childrenField].slice());
-        }
-
-        // 替换字段名
-        Object.keys(fieldNames).forEach(function (newKey) {
-          var oldKey = fieldNames[newKey];
-          if (oldKey in newItem) {
-            // @ts-ignore
-            newItem[newKey] = newItem[oldKey];
-            // @ts-ignore
-            delKeys.push(oldKey);
-          }
-        });
+    // 兼容处理，如果参数包含无效数值时，返回 NaN
+    // @ts-ignore
+    if (isNaN(num1) || isNaN(num2)) {
+      return Number.NaN;
+    }
+    var num1Changed = float2Fixed(num1);
+    var num2Changed = float2Fixed(num2);
+    var baseNum = digitLength(num1) + digitLength(num2);
+    var leftValue = num1Changed * num2Changed;
+    checkBoundary(leftValue);
+    return leftValue / Math.pow(10, baseNum);
+  }
 
-        // 删除旧字段
-        if (delKeys.length > 0) {
-          delKeys.forEach(function (delKey) {
-            // @ts-ignore
-            delete newItem[delKey];
-          });
-        }
-        return newItem;
-      });
+  /**
+   * 精确加法，支持多个数相加，加数默认为 0 。
+   *
+   * @static
+   * @alias module:Math.plus
+   * @since 3.1.0
+   * @param {...number|string} nums 相加的数
+   * @returns {number} 总和
+   * @example
+   *
+   * plus(0.1, 0.2); // 0.3
+   * plus(0.1, 0.2, 0.3); // 0.6
+   * plus(0.1, 0.2, 0.3, 0.4); // 1
+   * 
+   */
+  function plus() {
+    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+      nums[_key] = arguments[_key];
     }
+    var num1 = nums[0],
+      _nums$ = nums[1],
+      num2 = _nums$ === void 0 ? 0 : _nums$,
+      rest = nums.slice(2);
+    if (rest.length > 0) {
+      return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
+    }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
 
+    // 兼容处理，如果参数包含无效数值时，返回 NaN
     // @ts-ignore
-    return recusion(data.slice());
+    if (isNaN(num1) || isNaN(num2)) {
+      return Number.NaN;
+    }
+    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
+    return (times(num1, baseNum) + times(num2, baseNum)) / baseNum;
   }
 
   /**
-   * 递归处理空子级
+   * 精确减法，支持多个数相减，减数默认为 0 。
+   *
+   * @static
+   * @alias module:Math.minus
+   * @since 3.1.0
+   * @param {...number|string} nums 相减的数
+   * @returns {number} 差
+   * @example
+   *
+   * minus(1, 0.9); // 0.1
+   * minus(1, 0.9, 0.02); // 0.08
+   * minus(1, 0.9, 0.02, 0.08); // 0
    * 
-   * @private
-   * @template {Record<string,any>} [T=Record<string,any>]
-   * @param {T[]} arr 列表数据
-   * @param {object} [options] 配置项
-   * @param {string} [options.childrenField='children'] 子级字段名称
-   * @param {'none'|'null'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
    */
-  function processEmptyChildren(arr, options) {
-    var _ref = options || {},
-      _ref$childrenField = _ref.childrenField,
-      childrenField = _ref$childrenField === void 0 ? 'children' : _ref$childrenField,
-      _ref$emptyChildrenVal = _ref.emptyChildrenValue,
-      emptyChildrenValue = _ref$emptyChildrenVal === void 0 ? 'none' : _ref$emptyChildrenVal;
-    arr.forEach(function (item) {
-      // if (isObject(item) && Array.isArray(item[childrenField])) {
-      if (item[childrenField].length <= 0) {
-        if (emptyChildrenValue === 'null') {
-          // @ts-ignore
-          item[childrenField] = null;
-          // } else if (emptyChildrenValue === 'none') { // emptyChildrenValue='array' 不会执行该内部方法 
-        } else {
-          delete item[childrenField];
-        }
-      } else {
-        processEmptyChildren(item[childrenField], options);
-      }
-      // }
-    });
+  function minus() {
+    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+      nums[_key] = arguments[_key];
+    }
+    var num1 = nums[0],
+      _nums$ = nums[1],
+      num2 = _nums$ === void 0 ? 0 : _nums$,
+      rest = nums.slice(2);
+    if (rest.length > 0) {
+      return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
+    }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
+
+    // 兼容处理，如果参数包含无效数值时，返回 NaN
+    // @ts-ignore
+    if (isNaN(num1) || isNaN(num2)) {
+      return Number.NaN;
+    }
+    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
+    return (times(num1, baseNum) - times(num2, baseNum)) / baseNum;
   }
 
   /**
-   * 列表数据转树结构
-   * 
+   * 精确除法，支持多个数相除，除数默认为 1 。
+   *
    * @static
-   * @alias module:Processor.listToTree
-   * @since 4.14.0
-   * @template {Record<string,any>} [T=Record<string,any>]
-   * @template {*} [R=T&Record<string,any>]
-   * @param {T[]} list 列表数据
-   * @param {object} [options] 配置项
-   * @param {string} [options.keyField='id'] 当前数据的键值字段名称
-   * @param {string} [options.parentField='pid'] 当前数据的父级字段名称
-   * @param {string} [options.childrenField='children'] 子级字段名称
-   * @param {'none'|'null'|'array'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
-   * @param {'spread'|'self'} [options.nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {R[]} 树结构
+   * @alias module:Math.divide
+   * @since 3.1.0
+   * @param {...number|string} nums 被除数和除数
+   * @returns {number} 商数
    * @example
+   *
+   * divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
+   * divide(1.21, 1.1); // 1.1
+   * divide(1000, 10, 10); // 10
+   * divide(1000, 10, 10, 10); // 1
    * 
-   * const menus = [
-   *   { id: '1', name: '首页', code: 'trade', pid: null },
-   *   { id: '2', name: '交易管理', code: 'trade', pid: null },
-   *   { id: '3', name: '交易查询', code: 'trade-1', pid: '2' },
-   *   { id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' },
-   *   { id: '5', name: '权限管理', code: 'authorization', pid: null },
-   *   { id: '6', name: '角色管理', code: 'authorization-1', pid: '5' },
-   *   { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }
-   * ];
-   * listToTree(menus); 
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","children":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
-   * 
-   * // 自定义子级字段名
-   * listToTree(basicMenus, { childrenField: 'childs' });
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"childs":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","childs":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"childs":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
+   * divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
+   * divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3
    * 
    */
-  function listToTree(list, options) {
-    var _ref2 = options || {},
-      _ref2$keyField = _ref2.keyField,
-      keyField = _ref2$keyField === void 0 ? 'id' : _ref2$keyField,
-      _ref2$parentField = _ref2.parentField,
-      parentField = _ref2$parentField === void 0 ? 'pid' : _ref2$parentField,
-      _ref2$childrenField = _ref2.childrenField,
-      childrenField = _ref2$childrenField === void 0 ? 'children' : _ref2$childrenField,
-      _ref2$emptyChildrenVa = _ref2.emptyChildrenValue,
-      emptyChildrenValue = _ref2$emptyChildrenVa === void 0 ? 'none' : _ref2$emptyChildrenVa,
-      _ref2$nodeAssign = _ref2.nodeAssign,
-      nodeAssign = _ref2$nodeAssign === void 0 ? 'spread' : _ref2$nodeAssign;
-
-    /** @type {R[]} */
-    var tree = [];
-
-    /** @type {Object.<string, T[]>} */
-    var record = {};
-    if (!Array.isArray(list)) {
-      return tree;
-    }
-    list.forEach(function (item) {
-      if (isObject(item)) {
-        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-
-        /** @type {string} */
-        var id = newItem[keyField];
-
-        /** @type {string} */
-        var pid = newItem[parentField];
-        if (record[id]) {
-          // @ts-ignore
-          newItem[childrenField] = record[id];
-        } else {
-          // @ts-ignore
-          newItem[childrenField] = record[id] = [];
-        }
-        if (pid) {
-          if (!record[pid]) {
-            record[pid] = [newItem];
-          } else {
-            record[pid].push(newItem);
-          }
-        } else {
-          // @ts-ignore
-          tree.push(newItem);
-        }
-      }
-    });
-    if (emptyChildrenValue !== 'array') {
-      // @ts-ignore
-      processEmptyChildren(tree, options);
-    }
-    return tree;
-  }
-
-  /**
-   * 树结构转列表数据
-   * 
-   * @static
-   * @alias module:Processor.treeToList
-   * @since 4.14.0
-   * @template {Record<string,any>} T
-   * @template {keyof T} K
-   * @template {Omit<T, K>} R
-   * @param {T[]} tree 列表数据
-   * @param {K} childrenField 子级字段名称
-   * @returns {R[]} 列表数据
-   * @example
-   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
-   * 
-   * treeToList(menus, 'children'));
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null},{"id":"3","name":"交易查询","code":"trade-1","pid":"2"},{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"},{"id":"5","name":"权限管理","code":"authorization","pid":null},{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]
-   */
-  function treeToList(tree, childrenField) {
-    /** @type {R[]} */
-    var list = [];
-    if (!Array.isArray(tree)) {
-      return list;
-    }
-
-    /**
-     * 递归遍历
-     * @param {T[]} arr 列表数据
-     */
-    function recusion(arr) {
-      arr.forEach(function (item) {
-        if (isObject(item)) {
-          var newItem = _objectSpread2({}, item);
-          // @ts-ignore
-          list.push(newItem);
-          if (newItem[childrenField]) {
-            if (Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
-              recusion(newItem[childrenField]);
-            }
-            delete newItem[childrenField];
-          }
-        } else {
-          // @ts-ignore
-          list.push(item);
-        }
-      });
-    }
-    recusion(tree);
-    return list;
-  }
-
-  /**
-   * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
-   * 
-   * @static
-   * @alias module:Processor.filterTree
-   * @since 4.15.0
-   * @template {any} T
-   * @template {(item: T) => boolean} F
-   * @param {T[]} tree 树结构数据
-   * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，结果将包含该节点
-   * @param {string} [childrenField='children'] 子级字段名
-   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {T[]}
-   * @example
-   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
-   * 
-   * filterTree(menus, item=>item.name.indexOf('管理') > -1);
-   * // [{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
-   * 
-   * // 如果某节点被过滤掉，它的子节点也一并抛弃
-   * filterTree(menus, item=>item.id === '7');
-   * // []
-   * 
-   * filterTree(menus, item=>item.id === 'not found');
-   * // []
-   */
-  function filterTree(tree, predicate) {
-    var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
-    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
-    /** @type {T[]} */
-    var result = [];
-    if (!Array.isArray(tree)) {
-      return result;
-    }
-    tree.forEach(function (item) {
-      var newItem = item;
-      if (isObject(item)) {
-        // @ts-ignore
-        newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-      }
-      if (predicate(newItem)) {
-        if (isObject(newItem)) {
-          /** @type {T[]|undefined} */
-          // @ts-ignore
-          var childs = newItem[childrenField];
-          if (Array.isArray(childs) && childs.length > 0) {
-            // @ts-ignore
-            newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
-          }
-        }
-        result.push(newItem);
-      }
-    });
-    return result;
-  }
-
-  /**
-   * 精确乘法，支持多个数相乘，乘数默认为 1 。
-   *
-   * @static
-   * @alias module:Math.times
-   * @since 3.1.0
-   * @param {...number|string} nums 相乘的数
-   * @returns {number} 乘积
-   * @example
-   *
-   * times(3, 0.6); // 1.8
-   * times(3, 0.6, 2); // 3.6
-   * times(3, 0.6, 2, 10); // 36
-   * 
-   */
-  function times() {
+  function divide() {
     for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
       nums[_key] = arguments[_key];
     }
@@ -3043,7 +2848,7 @@
       num2 = _nums$ === void 0 ? 1 : _nums$,
       rest = nums.slice(2);
     if (rest.length > 0) {
-      return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
+      return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
     }
     num1 = transformEffectiveNumber(num1);
     num2 = transformEffectiveNumber(num2);
@@ -3055,190 +2860,67 @@
     }
     var num1Changed = float2Fixed(num1);
     var num2Changed = float2Fixed(num2);
-    var baseNum = digitLength(num1) + digitLength(num2);
-    var leftValue = num1Changed * num2Changed;
-    checkBoundary(leftValue);
-    return leftValue / Math.pow(10, baseNum);
+    checkBoundary(num1Changed);
+    checkBoundary(num2Changed);
+    // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
+    return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
   }
 
   /**
-   * 精确加法，支持多个数相加，加数默认为 0 。
+   * 四舍五入，支持设置精度
    *
    * @static
-   * @alias module:Math.plus
+   * @alias module:Math.round
    * @since 3.1.0
-   * @param {...number|string} nums 相加的数
-   * @returns {number} 总和
+   * @param {number|string} num 要四舍五入的数字
+   * @param {number} [precision=0] 四舍五入的精度
+   * @returns {number} 四舍五入的数字
    * @example
    *
-   * plus(0.1, 0.2); // 0.3
-   * plus(0.1, 0.2, 0.3); // 0.6
-   * plus(0.1, 0.2, 0.3, 0.4); // 1
+   * round(4.006); // 4
+   * round(4.006, 2); // 4.01
+   * round(4060, -2); // 4100
    * 
    */
-  function plus() {
-    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-      nums[_key] = arguments[_key];
-    }
-    var num1 = nums[0],
-      _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 0 : _nums$,
-      rest = nums.slice(2);
-    if (rest.length > 0) {
-      return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
-    }
-    num1 = transformEffectiveNumber(num1);
-    num2 = transformEffectiveNumber(num2);
+  function round(num) {
+    var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+    num = transformEffectiveNumber(num);
 
     // 兼容处理，如果参数包含无效数值时，返回 NaN
     // @ts-ignore
-    if (isNaN(num1) || isNaN(num2)) {
+    if (isNaN(num)) {
       return Number.NaN;
     }
-    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
-    return (times(num1, baseNum) + times(num2, baseNum)) / baseNum;
+    var base = Math.pow(10, precision);
+    return divide(Math.round(times(num, base)), base);
   }
 
   /**
-   * 精确减法，支持多个数相减，减数默认为 0 。
+   * 等待时间返回 Promise 。常用于异步方法中延时。
    *
    * @static
-   * @alias module:Math.minus
-   * @since 3.1.0
-   * @param {...number|string} nums 相减的数
-   * @returns {number} 差
+   * @alias module:Other.waitTime
+   * @since 4.2.0
+   * @param {number} [time=1000] 延时时间，单位毫秒
+   * @returns {Promise<void>}
    * @example
+   * 
+   * const test = async ()=>{
+   *   await waitTime();
+   *   // do something
+   * }
    *
-   * minus(1, 0.9); // 0.1
-   * minus(1, 0.9, 0.02); // 0.08
-   * minus(1, 0.9, 0.02, 0.08); // 0
+   * waitTime(500).then(()=>{
+   *   // do something
+   * });
    * 
    */
-  function minus() {
-    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-      nums[_key] = arguments[_key];
-    }
-    var num1 = nums[0],
-      _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 0 : _nums$,
-      rest = nums.slice(2);
-    if (rest.length > 0) {
-      return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
-    }
-    num1 = transformEffectiveNumber(num1);
-    num2 = transformEffectiveNumber(num2);
-
-    // 兼容处理，如果参数包含无效数值时，返回 NaN
-    // @ts-ignore
-    if (isNaN(num1) || isNaN(num2)) {
-      return Number.NaN;
-    }
-    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
-    return (times(num1, baseNum) - times(num2, baseNum)) / baseNum;
-  }
-
-  /**
-   * 精确除法，支持多个数相除，除数默认为 1 。
-   *
-   * @static
-   * @alias module:Math.divide
-   * @since 3.1.0
-   * @param {...number|string} nums 被除数和除数
-   * @returns {number} 商数
-   * @example
-   *
-   * divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
-   * divide(1.21, 1.1); // 1.1
-   * divide(1000, 10, 10); // 10
-   * divide(1000, 10, 10, 10); // 1
-   * 
-   * divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
-   * divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
-   * divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3
-   * 
-   */
-  function divide() {
-    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-      nums[_key] = arguments[_key];
-    }
-    var num1 = nums[0],
-      _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 1 : _nums$,
-      rest = nums.slice(2);
-    if (rest.length > 0) {
-      return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
-    }
-    num1 = transformEffectiveNumber(num1);
-    num2 = transformEffectiveNumber(num2);
-
-    // 兼容处理，如果参数包含无效数值时，返回 NaN
-    // @ts-ignore
-    if (isNaN(num1) || isNaN(num2)) {
-      return Number.NaN;
-    }
-    var num1Changed = float2Fixed(num1);
-    var num2Changed = float2Fixed(num2);
-    checkBoundary(num1Changed);
-    checkBoundary(num2Changed);
-    // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
-    return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
-  }
-
-  /**
-   * 四舍五入，支持设置精度
-   *
-   * @static
-   * @alias module:Math.round
-   * @since 3.1.0
-   * @param {number|string} num 要四舍五入的数字
-   * @param {number} [precision=0] 四舍五入的精度
-   * @returns {number} 四舍五入的数字
-   * @example
-   *
-   * round(4.006); // 4
-   * round(4.006, 2); // 4.01
-   * round(4060, -2); // 4100
-   * 
-   */
-  function round(num) {
-    var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-    num = transformEffectiveNumber(num);
-
-    // 兼容处理，如果参数包含无效数值时，返回 NaN
-    // @ts-ignore
-    if (isNaN(num)) {
-      return Number.NaN;
-    }
-    var base = Math.pow(10, precision);
-    return divide(Math.round(times(num, base)), base);
-  }
-
-  /**
-   * 等待时间返回 Promise 。常用于异步方法中延时。
-   *
-   * @static
-   * @alias module:Other.waitTime
-   * @since 4.2.0
-   * @param {number} [time=1000] 延时时间，单位毫秒
-   * @returns {Promise<void>}
-   * @example
-   * 
-   * const test = async ()=>{
-   *   await waitTime();
-   *   // do something
-   * }
-   *
-   * waitTime(500).then(()=>{
-   *   // do something
-   * });
-   * 
-   */
-  function waitTime() {
-    var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
-    return new Promise(function (resolve) {
-      setTimeout(resolve, time);
-    });
-  }
+  function waitTime() {
+    var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
+    return new Promise(function (resolve) {
+      setTimeout(resolve, time);
+    });
+  }
 
   // ref: https://github.com/ant-design/ant-design-mobile/blob/v2/components/input-item/index.tsx#L240
 
@@ -3371,11 +3053,333 @@
     return len;
   }
 
+  /**
+   * 转换字段名，返回一个转换字段后的值，不改变原值。
+   * 
+   * @static
+   * @alias module:Processor.transformFieldNames
+   * @since 4.14.0
+   * @template {*} D
+   * @template {Record<string, keyof D>} F
+   * @template {string} C
+   * @param {D[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
+   * @param {F} fieldNames 字段名映射
+   * @param {C} [childrenField] 子级数据字段名
+   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {import('./transformFieldNames.type.js').TransformFieldNames<D, F, C>}
+   * @example
+   * 
+   * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];
+   * const newOptions = transformFieldNames(options, {label: 'name', value: 'code'});
+   * // [{value: '1', label: 'one'},{value:'2', label:'two'}]
+   * 
+   * // 嵌套数据，指定子级字段名 children
+   * const options2 = [{code: '1', name: 'one'},{code:'2', name:'two', children: [{code:'2-1', name:'two-one', children: [{code: '2-1-1', name:'two-one-one'}]}]}];
+   * const newOptions2 = transformFieldNames(options2, {label: 'name', value: 'code'}, 'children');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one', children: [{value: '2-1-1', label:'two-one-one'}]}]}]
+   * 
+   * const options3 = [{code: '1', name: 'one'},{code:'2', name:'two', childs: [{code:'2-1', name:'two-one'}]}];
+   * const newOptions3 = transformFieldNames(options3, {label: 'name', value: 'code'}, 'childs');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', childs: [{value: '2-1', label:'two-one'}]}]
+   * 
+   * // 嵌套数据，并替换子集字段名
+   * const newOptions4 = transformFieldNames(options3, {label: 'name', value: 'code', children: 'childs'}, 'childs');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one'}]}]
+   */
+  function transformFieldNames(data, fieldNames, childrenField) {
+    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
+    if (!Array.isArray(data)) {
+      return data;
+    }
+    if (data.length <= 0) {
+      // @ts-ignore
+      return [];
+    }
+
+    /**
+     * 递归处理字段名
+     * 
+     * @param {Array.<object>} arr 列表数据
+     * @returns {*}
+     */
+    function recusion(arr) {
+      return arr.map(function (item) {
+        if (!isObject(item)) {
+          return item;
+        }
+        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+        /** @type {Array.<string>} */
+        var delKeys = [];
+
+        // 树形数据子节点
+        // @ts-ignore
+        if (childrenField && Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
+          // @ts-ignore
+          newItem[childrenField] = recusion(newItem[childrenField].slice());
+        }
+
+        // 替换字段名
+        Object.keys(fieldNames).forEach(function (newKey) {
+          var oldKey = fieldNames[newKey];
+          if (oldKey in newItem) {
+            // @ts-ignore
+            newItem[newKey] = newItem[oldKey];
+            // @ts-ignore
+            delKeys.push(oldKey);
+          }
+        });
+
+        // 删除旧字段
+        if (delKeys.length > 0) {
+          delKeys.forEach(function (delKey) {
+            // @ts-ignore
+            delete newItem[delKey];
+          });
+        }
+        return newItem;
+      });
+    }
+
+    // @ts-ignore
+    return recusion(data.slice());
+  }
+
+  /**
+   * 递归处理空子级
+   * 
+   * @private
+   * @template {Record<string,any>} [T=Record<string,any>]
+   * @param {T[]} arr 列表数据
+   * @param {object} [options] 配置项
+   * @param {string} [options.childrenField='children'] 子级字段名称
+   * @param {'none'|'null'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
+   */
+  function processEmptyChildren(arr, options) {
+    var _ref = options || {},
+      _ref$childrenField = _ref.childrenField,
+      childrenField = _ref$childrenField === void 0 ? 'children' : _ref$childrenField,
+      _ref$emptyChildrenVal = _ref.emptyChildrenValue,
+      emptyChildrenValue = _ref$emptyChildrenVal === void 0 ? 'none' : _ref$emptyChildrenVal;
+    arr.forEach(function (item) {
+      // if (isObject(item) && Array.isArray(item[childrenField])) {
+      if (item[childrenField].length <= 0) {
+        if (emptyChildrenValue === 'null') {
+          // @ts-ignore
+          item[childrenField] = null;
+          // } else if (emptyChildrenValue === 'none') { // emptyChildrenValue='array' 不会执行该内部方法 
+        } else {
+          delete item[childrenField];
+        }
+      } else {
+        processEmptyChildren(item[childrenField], options);
+      }
+      // }
+    });
+  }
+
+  /**
+   * 列表数据转树结构
+   * 
+   * @static
+   * @alias module:Tree.listToTree
+   * @since 4.14.0
+   * @template {Record<string,any>} [T=Record<string,any>]
+   * @template {*} [R=T&Record<string,any>]
+   * @param {T[]} list 列表数据
+   * @param {object} [options] 配置项
+   * @param {string} [options.keyField='id'] 当前数据的键值字段名称
+   * @param {string} [options.parentField='pid'] 当前数据的父级字段名称
+   * @param {string} [options.childrenField='children'] 子级字段名称
+   * @param {'none'|'null'|'array'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
+   * @param {'spread'|'self'} [options.nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {R[]} 树结构
+   * @example
+   * 
+   * const menus = [
+   *   { id: '1', name: '首页', code: 'trade', pid: null },
+   *   { id: '2', name: '交易管理', code: 'trade', pid: null },
+   *   { id: '3', name: '交易查询', code: 'trade-1', pid: '2' },
+   *   { id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' },
+   *   { id: '5', name: '权限管理', code: 'authorization', pid: null },
+   *   { id: '6', name: '角色管理', code: 'authorization-1', pid: '5' },
+   *   { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }
+   * ];
+   * listToTree(menus); 
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","children":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   * // 自定义子级字段名
+   * listToTree(basicMenus, { childrenField: 'childs' });
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"childs":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","childs":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"childs":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   */
+  function listToTree(list, options) {
+    var _ref2 = options || {},
+      _ref2$keyField = _ref2.keyField,
+      keyField = _ref2$keyField === void 0 ? 'id' : _ref2$keyField,
+      _ref2$parentField = _ref2.parentField,
+      parentField = _ref2$parentField === void 0 ? 'pid' : _ref2$parentField,
+      _ref2$childrenField = _ref2.childrenField,
+      childrenField = _ref2$childrenField === void 0 ? 'children' : _ref2$childrenField,
+      _ref2$emptyChildrenVa = _ref2.emptyChildrenValue,
+      emptyChildrenValue = _ref2$emptyChildrenVa === void 0 ? 'none' : _ref2$emptyChildrenVa,
+      _ref2$nodeAssign = _ref2.nodeAssign,
+      nodeAssign = _ref2$nodeAssign === void 0 ? 'spread' : _ref2$nodeAssign;
+
+    /** @type {R[]} */
+    var tree = [];
+
+    /** @type {Object.<string, T[]>} */
+    var record = {};
+    if (!Array.isArray(list)) {
+      return tree;
+    }
+    list.forEach(function (item) {
+      if (isObject(item)) {
+        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+
+        /** @type {string} */
+        var id = newItem[keyField];
+
+        /** @type {string} */
+        var pid = newItem[parentField];
+        if (record[id]) {
+          // @ts-ignore
+          newItem[childrenField] = record[id];
+        } else {
+          // @ts-ignore
+          newItem[childrenField] = record[id] = [];
+        }
+        if (pid) {
+          if (!record[pid]) {
+            record[pid] = [newItem];
+          } else {
+            record[pid].push(newItem);
+          }
+        } else {
+          // @ts-ignore
+          tree.push(newItem);
+        }
+      }
+    });
+    if (emptyChildrenValue !== 'array') {
+      // @ts-ignore
+      processEmptyChildren(tree, options);
+    }
+    return tree;
+  }
+
+  /**
+   * 树结构转列表数据
+   * 
+   * @static
+   * @alias module:Tree.treeToList
+   * @since 4.14.0
+   * @template {Record<string,any>} T
+   * @template {keyof T} K
+   * @template {Omit<T, K>} R
+   * @param {T[]} tree 列表数据
+   * @param {K} childrenField 子级字段名称
+   * @returns {R[]} 列表数据
+   * @example
+   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
+   * 
+   * treeToList(menus, 'children'));
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null},{"id":"3","name":"交易查询","code":"trade-1","pid":"2"},{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"},{"id":"5","name":"权限管理","code":"authorization","pid":null},{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]
+   */
+  function treeToList(tree, childrenField) {
+    /** @type {R[]} */
+    var list = [];
+    if (!Array.isArray(tree)) {
+      return list;
+    }
+
+    /**
+     * 递归遍历
+     * @param {T[]} arr 列表数据
+     */
+    function recusion(arr) {
+      arr.forEach(function (item) {
+        if (isObject(item)) {
+          var newItem = _objectSpread2({}, item);
+          // @ts-ignore
+          list.push(newItem);
+          if (newItem[childrenField]) {
+            if (Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
+              recusion(newItem[childrenField]);
+            }
+            delete newItem[childrenField];
+          }
+        } else {
+          // @ts-ignore
+          list.push(item);
+        }
+      });
+    }
+    recusion(tree);
+    return list;
+  }
+
+  /**
+   * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
+   * 
+   * @static
+   * @alias module:Tree.filterTree
+   * @since 4.15.0
+   * @template {any} T
+   * @template {(item: T) => boolean} F
+   * @param {T[]} tree 树结构数据
+   * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，结果将包含该节点
+   * @param {string} [childrenField='children'] 子级字段名
+   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {T[]}
+   * @example
+   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
+   * 
+   * filterTree(menus, item=>item.name.indexOf('管理') > -1);
+   * // [{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   * // 如果某节点被过滤掉，它的子节点也一并抛弃
+   * filterTree(menus, item=>item.id === '7');
+   * // []
+   * 
+   * filterTree(menus, item=>item.id === 'not found');
+   * // []
+   */
+  function filterTree(tree, predicate) {
+    var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
+    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
+    /** @type {T[]} */
+    var result = [];
+    if (!Array.isArray(tree)) {
+      return result;
+    }
+    tree.forEach(function (item) {
+      var newItem = item;
+      if (isObject(item)) {
+        // @ts-ignore
+        newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+      }
+      if (predicate(newItem)) {
+        if (isObject(newItem)) {
+          /** @type {T[]|undefined} */
+          // @ts-ignore
+          var childs = newItem[childrenField];
+          if (Array.isArray(childs) && childs.length > 0) {
+            // @ts-ignore
+            newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
+          }
+        }
+        result.push(newItem);
+      }
+    });
+    return result;
+  }
+
   /**
    * 查找树结构数据节点
    * 
    * @static
-   * @alias module:Other.findTreeNode
+   * @alias module:Tree.findTreeNode
    * @since 4.14.0
    * @template {any} T
    * @template {(item: T) => boolean} F
@@ -3443,7 +3447,7 @@
    * 查找树结构数据多个节点
    * 
    * @static
-   * @alias module:Other.findTreeNodes
+   * @alias module:Tree.findTreeNodes
    * @since 4.15.0
    * @template {any} T
    * @template {(item: T) => boolean} F
@@ -3557,7 +3561,7 @@
    * 查找包含当前节点的所有父级节点
    * 
    * @static
-   * @alias module:Other.findTreeSelect
+   * @alias module:Tree.findTreeSelect
    * @since 4.14.0
    * @template {any} T
    * @template {(item: T) => boolean} F