util-helpers 4.13.1 → 4.14.0

package/esm/validatePassword.js

@@ -3,6 +3,7 @@ var regNumber = /[\d]/;
 var regLowerCaseLetter = /[a-z]/;
 var regUpperCaseLetter = /[A-Z]/;
 var regAllNumberAndLetter = /[\d|a-z]/gi;
+
 /**
  * 是否包含数字
  *
@@ -10,10 +11,10 @@ var regAllNumberAndLetter = /[\d|a-z]/gi;
  * @param {string} val 检查的值
  * @returns {boolean} 是否包含数字
  */
-
 function hasNumber(val) {
   return regNumber.test(val);
 }
+
 /**
  * 是否包含小写字母
  *
@@ -21,11 +22,10 @@ function hasNumber(val) {
  * @param {string} val 检测的值
  * @returns {boolean} 是否包含小写字母
  */
-
-
 function hasLowerCaseLetter(val) {
   return regLowerCaseLetter.test(val);
 }
+
 /**
  * 是否包含大写字母
  *
@@ -33,11 +33,10 @@ function hasLowerCaseLetter(val) {
  * @param {string} val 检测的值
  * @returns {boolean} 是否包含大写字母
  */
-
-
 function hasUpperCaseLetter(val) {
   return regUpperCaseLetter.test(val);
 }
+
 /**
  * 是否为十六进制
  *
@@ -45,11 +44,10 @@ function hasUpperCaseLetter(val) {
  * @param {string} val 检测的值
  * @returns {boolean} 是否为十六进制
  */
-
-
 function hasHex(val) {
   return val.indexOf('\\x') > -1 || val.indexOf("\\u") > -1;
 }
+
 /**
  * 是否包含特殊字符
  *
@@ -58,35 +56,28 @@ function hasHex(val) {
  * @param {string} chars 特殊字符
  * @returns {boolean} 是否包含特殊字符
  */
-
-
 function hasSpecialCharacter(val, chars) {
   if (!chars || !val) {
     return false;
   }
-
   var specialChars = val.replace(regAllNumberAndLetter, '');
-
   if (!specialChars) {
     return false;
   }
-
   var regChars = hasHex(chars) ? new RegExp("[".concat(chars, "]")) : null;
-
   if (regChars) {
     return regChars.test(specialChars);
   }
-
   var ret = false;
   specialChars.split('').some(function (charItem) {
     if (chars.indexOf(charItem) > -1) {
       ret = true;
     }
-
     return ret;
   });
   return ret;
 }
+
 /**
  * 是否包含非法字符
  *
@@ -95,37 +86,30 @@ function hasSpecialCharacter(val, chars) {
  * @param {string} chars 特殊字符
  * @returns {boolean} 是否包含非法字符
  */
-
-
 function hasUnallowableCharacter(val, chars) {
   if (!val) {
     return false;
   }
-
   var specialChars = val.replace(regAllNumberAndLetter, '');
-
   if (!specialChars) {
     return false;
   } else if (!chars) {
     return true;
   }
-
   var regChars = hasHex(chars) ? new RegExp("[^".concat(chars, "]")) : null;
-
   if (regChars) {
     return regChars.test(specialChars);
   }
-
   var ret = false;
   specialChars.split('').some(function (charItem) {
     if (chars.indexOf(charItem) === -1) {
       ret = true;
     }
-
     return ret;
   });
   return ret;
 }
+
 /**
  * @typedef {Object} PasswordContaines - 验证密码的包含内容
  * @property {boolean} number - 包含数字
@@ -214,40 +198,36 @@ function hasUnallowableCharacter(val, chars) {
  *   }
  * }
  */
-
-
 function validatePassword(value) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   var _options$level = options.level,
-      level = _options$level === void 0 ? 2 : _options$level,
-      _options$ignoreCase = options.ignoreCase,
-      ignoreCase = _options$ignoreCase === void 0 ? false : _options$ignoreCase,
-      _options$special = options.special,
-      special = _options$special === void 0 ? '\\x21-\\x2F\\x3A-\\x40\\x5B-\\x60\\x7B-\\x7E' : _options$special;
+    level = _options$level === void 0 ? 2 : _options$level,
+    _options$ignoreCase = options.ignoreCase,
+    ignoreCase = _options$ignoreCase === void 0 ? false : _options$ignoreCase,
+    _options$special = options.special,
+    special = _options$special === void 0 ? '\\x21-\\x2F\\x3A-\\x40\\x5B-\\x60\\x7B-\\x7E' : _options$special;
   var valStr = value;
-
   if (typeof value !== 'string') {
     devWarn("[validatePassword] value must be a string.");
     valStr = '';
   }
-
-  var currentLevel = 0; // 包含数字
-
-  var containesNumber = hasNumber(valStr); // 包含小写字母
-
-  var containesLowerCaseLetter = hasLowerCaseLetter(valStr); // 包含大写字母
-
-  var containesUpperCaseLetter = hasUpperCaseLetter(valStr); // 包含特殊字符
-
-  var containesSpecialCharacter = hasSpecialCharacter(valStr, special); // 包含非法字符，即含有非数字字母特殊字符以外的其他字符
-
+  var currentLevel = 0;
+
+  // 包含数字
+  var containesNumber = hasNumber(valStr);
+  // 包含小写字母
+  var containesLowerCaseLetter = hasLowerCaseLetter(valStr);
+  // 包含大写字母
+  var containesUpperCaseLetter = hasUpperCaseLetter(valStr);
+  // 包含特殊字符
+  var containesSpecialCharacter = hasSpecialCharacter(valStr, special);
+  // 包含非法字符，即含有非数字字母特殊字符以外的其他字符
   var containesUnallowableCharacter = hasUnallowableCharacter(valStr, special);
-
   if (containesNumber) {
     currentLevel += 1;
-  } // 不区分大小写
-
+  }
 
+  // 不区分大小写
   if (ignoreCase) {
     if (containesLowerCaseLetter || containesUpperCaseLetter) {
       currentLevel += 1;
@@ -257,17 +237,15 @@ function validatePassword(value) {
     if (containesLowerCaseLetter) {
       currentLevel += 1;
     }
-
     if (containesUpperCaseLetter) {
       currentLevel += 1;
     }
   }
-
   if (containesSpecialCharacter) {
     currentLevel += 1;
-  } // 验证结果
-
+  }
 
+  // 验证结果
   var validated = currentLevel >= level && !containesUnallowableCharacter;
   return {
     validated: validated,
@@ -281,5 +259,4 @@ function validatePassword(value) {
     }
   };
 }
-
 export default validatePassword;

package/esm/waitTime.js

@@ -24,5 +24,4 @@ function waitTime() {
     setTimeout(resolve, time);
   });
 }
-
 export default waitTime;

package/lib/blobToDataURL.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 //  file、blob文件如何预览图片？
 //  方法1：将file或者blob类型文件转成base64数据，再作为src赋值给img标签
 //  方法2：使用 window.URL.createObjectURL(blob) 为blob、file 创建一个指向该参数对象的URL
@@ -35,17 +34,15 @@ exports["default"] = void 0;
 function blobToDataURL(blob) {
   return new Promise(function (resolve, reject) {
     var reader = new FileReader();
-    reader.readAsDataURL(blob); // @ts-ignore
-
+    reader.readAsDataURL(blob);
+    // @ts-ignore
     reader.onload = function () {
       return resolve(reader.result);
     };
-
     reader.onerror = function (error) {
       return reject(error);
     };
   });
 }
-
 var _default = blobToDataURL;
 exports["default"] = _default;

package/lib/bytesToSize.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 /**
  * 字节转换存储单位，保留2位小数点
  *
@@ -12,6 +11,8 @@ exports["default"] = void 0;
  * @alias module:Processor.bytesToSize
  * @since 3.8.0
  * @param {number} bytes 字节大小
+ * @param {Object} [options] 配置项
+ * @param {string} [options.spaceMark=' '] 间隔字符
  * @returns {string} 存储单位值
  * @example
  *
@@ -20,16 +21,22 @@ exports["default"] = void 0;
  * bytesToSize(3.213243*1024*1024); // 3.21 MB
  * bytesToSize(1024*1024*1024); // 1 GB
  * 
+ * // 自定义间隔符号
+ * bytesToSize(0, { spaceMark: '' }); // 0B
+ * bytesToSize(1024, { spaceMark: '' }); // 1KB
+ * 
  */
 function bytesToSize(bytes) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _options$spaceMark = options.spaceMark,
+    spaceMark = _options$spaceMark === void 0 ? ' ' : _options$spaceMark;
   var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
-  if (numBytes === 0 || isNaN(numBytes)) return '0 B';
-  var k = 1024; // 存储单位
-
+  if (numBytes === 0 || isNaN(numBytes)) return "0".concat(spaceMark, "B");
+  var k = 1024;
+  // 存储单位
   var sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
   var i = Math.floor(Math.log(numBytes) / Math.log(k));
-  return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(2)), " ").concat(sizes[i]) : numBytes + '';
+  return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(2))).concat(spaceMark).concat(sizes[i]) : numBytes + '';
 }
-
 var _default = bytesToSize;
 exports["default"] = _default;

package/lib/calculateCursorPosition.js

@@ -4,11 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 var _normalizeString = _interopRequireDefault(require("./normalizeString"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 // 参考了: https://github.com/ant-design/ant-design-mobile/blob/v2/components/input-item/index.tsx#L240
 
 /**
@@ -34,23 +31,21 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue) {
   var options = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
   var _options$placeholderC = options.placeholderChar,
-      placeholderChar = _options$placeholderC === void 0 ? ' ' : _options$placeholderC,
-      _options$maskReg = options.maskReg,
-      maskReg = _options$maskReg === void 0 ? /\D/g : _options$maskReg,
-      type = options.type;
+    placeholderChar = _options$placeholderC === void 0 ? ' ' : _options$placeholderC,
+    _options$maskReg = options.maskReg,
+    maskReg = _options$maskReg === void 0 ? /\D/g : _options$maskReg,
+    type = options.type;
   var realCtrlValue = (0, _normalizeString["default"])(prevCtrlValue);
   var realRawValue = (0, _normalizeString["default"])(rawValue);
   var placeholderChars = Array.isArray(placeholderChar) ? placeholderChar : [placeholderChar];
   var editLength = realRawValue.length - realCtrlValue.length;
   var isAddition = editLength > 0;
   var pos = prevPos;
-
   if (isAddition) {
     var additionStr = realRawValue.substring(pos - editLength, pos);
     var ctrlCharCount = additionStr.replace(maskReg, '').length;
     pos -= editLength - ctrlCharCount;
     var placeholderCharCount = 0;
-
     while (ctrlCharCount > 0) {
       if (placeholderChars.indexOf(ctrlValue.charAt(pos - ctrlCharCount + placeholderCharCount)) !== -1) {
         placeholderCharCount++;
@@ -58,16 +53,12 @@ function calculateCursorPosition(prevPos, prevCtrlValue, rawValue, ctrlValue) {
         ctrlCharCount--;
       }
     }
-
     pos += placeholderCharCount;
   }
-
   if (type === 'mobile' && (pos === 4 || pos === 9) || type === 'bankCard' && pos > 0 && pos % 5 === 0) {
     pos -= 1;
   }
-
   return pos;
 }
-
 var _default = calculateCursorPosition;
 exports["default"] = _default;

package/lib/dataURLToBlob.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 /**
  * 将 DataURL 转为 Blob 对象
  *
@@ -19,21 +18,18 @@ exports["default"] = void 0;
  * dataURLToBlob(dataurl); // Blob {size: 32, type: 'text/html'}
  */
 function dataURLToBlob(dataurl) {
-  var arr = dataurl.split(','); // @ts-ignore
-
+  var arr = dataurl.split(',');
+  // @ts-ignore
   var mime = arr[0].match(/:(.*?);/)[1];
   var bstr = atob(arr[1]);
   var n = bstr.length;
   var u8arr = new Uint8Array(n);
-
   while (n--) {
     u8arr[n] = bstr.charCodeAt(n);
   }
-
   return new Blob([u8arr], {
     type: mime
   });
 }
-
 var _default = dataURLToBlob;
 exports["default"] = _default;

package/lib/divide.js

@@ -4,25 +4,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 var _math = require("./utils/math.util");
-
 var _times = _interopRequireDefault(require("./times"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
 /**
  * 精确除法，支持多个数相除，除数默认为 1 。
  *
@@ -47,31 +37,27 @@ 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);
-
+    _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 = (0, _math.transformEffectiveNumber)(num1);
-  num2 = (0, _math.transformEffectiveNumber)(num2); // 兼容处理，如果参数包含无效数值时，返回 NaN
-  // @ts-ignore
+  num2 = (0, _math.transformEffectiveNumber)(num2);
 
+  // 兼容处理，如果参数包含无效数值时，返回 NaN
+  // @ts-ignore
   if (isNaN(num1) || isNaN(num2)) {
     return Number.NaN;
   }
-
   var num1Changed = (0, _math.float2Fixed)(num1);
   var num2Changed = (0, _math.float2Fixed)(num2);
   (0, _math.checkBoundary)(num1Changed);
-  (0, _math.checkBoundary)(num2Changed); // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
-
+  (0, _math.checkBoundary)(num2Changed);
+  // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
   return (0, _times["default"])(num1Changed / num2Changed, (0, _math.strip)(Math.pow(10, (0, _math.digitLength)(num2) - (0, _math.digitLength)(num1))));
 }
-
 var _default = divide;
 exports["default"] = _default;

package/lib/findTreeNode.js

@@ -0,0 +1,76 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+/**
+ * 查找树结构数据节点
+ * 
+ * @static
+ * @alias module:Other.findTreeNode
+ * @since 4.14.0
+ * @template {any} T
+ * @template {(item: T) => boolean} F
+ * @param {T[]} tree 树结构数据
+ * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy 将返回该节点
+ * @param {string} [childrenField='children'] 子级字段名
+ * @returns {T|undefined}
+ * @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" }] }];
+ * 
+ * findTreeNode(menus, item=>item.id === '2');
+ * // {"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"}]}]}
+ * 
+ * findTreeNode(menus, item=>item.id === '7');
+ * // {"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}
+ * 
+ * findTreeNode(menus, item=>item.id === 'not found');
+ * // undefined
+ */
+function findTreeNode(tree, predicate) {
+  var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
+  var stack = [];
+
+  /** @type {T|undefined} */
+  var node;
+  var _iterator = _createForOfIteratorHelper(tree),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var item = _step.value;
+      stack.push(item);
+      while (stack.length) {
+        /** @type {T} */
+        // @ts-ignore
+        var temp = stack.pop();
+        if (predicate(temp)) {
+          node = temp;
+          break;
+        }
+
+        /** @type {T[]} */
+        // @ts-ignore
+        var children = temp[childrenField] || [];
+        stack.push.apply(stack, _toConsumableArray(children));
+      }
+      if (node) {
+        break;
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return node;
+}
+var _default = findTreeNode;
+exports["default"] = _default;

package/lib/findTreeSelect.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _type = require("./utils/type");
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it["return"] != null) it["return"](); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+/**
+ * 内部实现
+ * 
+ * @private
+ * @template {any} T
+ * @template {(item: T) => boolean} F
+ * @param {T[]} tree 树结构数据
+ * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy 将返回包含该节点的所有父级节点
+ * @param {string} [childrenField='children'] 子级字段名
+ * @param {T[]} [path=[]] 当前遍历路径
+ * @returns {T[]}
+ */
+function internalFindTreeSelect(tree, predicate) {
+  var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
+  var path = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : [];
+  if (!tree) {
+    return [];
+  }
+  var _iterator = _createForOfIteratorHelper(tree),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var item = _step.value;
+      path.push(item);
+      if (predicate(item)) {
+        return path;
+      }
+
+      // @ts-ignore
+      if ((0, _type.isObject)(item) && Array.isArray(item[childrenField]) && item[childrenField].length > 0) {
+        // @ts-ignore
+        var findChildren = internalFindTreeSelect(item[childrenField], predicate, childrenField, path);
+        if (findChildren.length > 0) {
+          return findChildren;
+        }
+      }
+      path.pop();
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return [];
+}
+
+/**
+ * 查找包含当前节点的所有父级节点
+ * 
+ * @static
+ * @alias module:Other.findTreeSelect
+ * @since 4.14.0
+ * @template {any} T
+ * @template {(item: T) => boolean} F
+ * @param {T[]} tree 树结构数据
+ * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy 将返回包含该节点的所有父级节点
+ * @param {string} [childrenField='children'] 子级字段名
+ * @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" }] }];
+ * 
+ * findTreeSelect(menus, item => item.id === '2');
+ * // [{"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"}]}]}]
+ * 
+ * findTreeSelect(menus, item => item.id === '7');
+ * // [{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]
+ * 
+ * findTreeSelect(menus, item => item.id === 'not found');
+ * // []
+ */
+function findTreeSelect(tree, predicate) {
+  var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
+  return internalFindTreeSelect(tree, predicate, childrenField);
+}
+var _default = findTreeSelect;
+exports["default"] = _default;

package/lib/formatBankCard.js

@@ -4,11 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-
 var _normalizeString = _interopRequireDefault(require("./normalizeString"));
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-
 /**
  * 格式化银行卡号
  *
@@ -17,7 +14,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * @since 1.1.0
  * @param {string} bankCardNo 要处理的字符串
  * @param {Object} [options] 配置项
- * @param {string} [options.char=" "] 间隔字符
+ * @param {string} [options.spaceMark=' '] 间隔字符
  * @param {number} [options.length=4] 间隔长度
  * @returns {string} 格式化的银行卡号
  * @example
@@ -32,24 +29,24 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * formatBankCard('6228********890'); // 6228 **** **** 890
  *
  * // 16位银行卡，"-"间隔
- * formatBankCard('6228480402564890', {char: '-'}); // 6228-4804-0256-4890
+ * formatBankCard('6228480402564890', {spaceMark: '-'}); // 6228-4804-0256-4890
  *
  */
 function formatBankCard() {
   var bankCardNo = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-
+  // @ts-ignore
+  // TODO 下个版本废弃 char
   var _options$char = options["char"],
-      _char = _options$char === void 0 ? ' ' : _options$char,
-      _options$length = options.length,
-      length = _options$length === void 0 ? 4 : _options$length;
-
+    _char = _options$char === void 0 ? ' ' : _options$char,
+    _options$length = options.length,
+    length = _options$length === void 0 ? 4 : _options$length;
+  var realSpaceMark = 'spaceMark' in options ? options.spaceMark : _char;
   var reg = new RegExp("(.{".concat(length, "})"), 'g');
-  var regChar = new RegExp("".concat(_char), 'g');
+  var regChar = new RegExp("".concat(realSpaceMark), 'g');
   var realValue = (0, _normalizeString["default"])(bankCardNo).replace(regChar, '');
-  var str = realValue.replace(reg, "$1".concat(_char));
+  var str = realValue.replace(reg, "$1".concat(realSpaceMark));
   return realValue.length % length === 0 ? str.substring(0, str.length - 1) : str;
 }
-
 var _default = formatBankCard;
 exports["default"] = _default;