util-helpers 4.16.2 → 4.17.1

package/esm/isWX.js

@@ -1,24 +1,9 @@
-import normalizeString from './normalizeString';
+import normalizeString from './normalizeString.js';
 
-// 微信号 6至20位，以字母开头，字母，数字，减号（连接符），下划线
 var reg = /^[a-z]([-_a-z0-9]{5,19})+$/i;
-
-/**
- * 检测值是否为微信号
- *
- * @static
- * @alias module:Validator.isWX
- * @since 1.1.0
- * @param {*} value 要检测的值
- * @returns {boolean} 值是否为微信号
- * @example
- *
- * isWX('a12345'); // true
- * isWX('123'); // false
- *
- */
 function isWX(value) {
-  var valueStr = normalizeString(value);
-  return reg.test(valueStr);
+    var valueStr = normalizeString(value);
+    return reg.test(valueStr);
 }
-export default isWX;
+
+export { isWX as default };

package/esm/listToTree.js

@@ -1,127 +1,58 @@
-import _objectSpread from "@babel/runtime/helpers/objectSpread2";
-import { isObject } from "./utils/type";
+import { __assign } from 'tslib';
+import isObject from './utils/type/isObject.js';
 
-/**
- * 递归处理空子级
- * 
- * @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);
-    }
-    // }
-  });
+    var _a = options.childrenField, childrenField = _a === void 0 ? 'children' : _a, _b = options.emptyChildrenValue, emptyChildrenValue = _b === void 0 ? 'none' : _b;
+    arr.forEach(function (item) {
+        if (item[childrenField].length <= 0) {
+            if (emptyChildrenValue === 'null') {
+                item[childrenField] = null;
+            }
+            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' ? _objectSpread({}, 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);
+    if (options === void 0) { options = {}; }
+    var _a = options.keyField, keyField = _a === void 0 ? 'id' : _a, _b = options.parentField, parentField = _b === void 0 ? 'pid' : _b, _c = options.childrenField, childrenField = _c === void 0 ? 'children' : _c, _d = options.emptyChildrenValue, emptyChildrenValue = _d === void 0 ? 'none' : _d, _e = options.nodeAssign, nodeAssign = _e === void 0 ? 'spread' : _e;
+    var tree = [];
+    var record = {};
+    if (!Array.isArray(list)) {
+        return tree;
+    }
+    list.forEach(function (item) {
+        if (isObject(item)) {
+            var newItem = nodeAssign === 'spread' ? __assign({}, item) : item;
+            var id = newItem[keyField];
+            var pid = newItem[parentField];
+            if (record[id]) {
+                newItem[childrenField] = record[id];
+            }
+            else {
+                newItem[childrenField] = record[id] = [];
+            }
+            if (pid) {
+                if (!record[pid]) {
+                    record[pid] = [newItem];
+                }
+                else {
+                    record[pid].push(newItem);
+                }
+            }
+            else {
+                tree.push(newItem);
+            }
         }
-      } else {
-        // @ts-ignore
-        tree.push(newItem);
-      }
+    });
+    if (emptyChildrenValue !== 'array') {
+        processEmptyChildren(tree, options);
     }
-  });
-  if (emptyChildrenValue !== 'array') {
-    // @ts-ignore
-    processEmptyChildren(tree, options);
-  }
-  return tree;
+    return tree;
 }
-export default listToTree;
+
+export { listToTree as default };

package/esm/minus.js

@@ -1,42 +1,24 @@
-import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { digitLength, transformEffectiveNumber } from './utils/math.util';
-import times from './times';
+import { __read, __spreadArray } from 'tslib';
+import { transformEffectiveNumber, digitLength } from './utils/math.util.js';
+import times from './times.js';
+import _isNaN from './utils/type/isNaN.js';
 
-/**
- * 精确减法，支持多个数相减，减数默认为 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
- * 
- */
 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;
+    var nums = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        nums[_i] = arguments[_i];
+    }
+    var _a = __read(nums), num1 = _a[0], _b = _a[1], num2 = _b === void 0 ? 0 : _b, rest = _a.slice(2);
+    if (rest.length > 0) {
+        return minus.apply(void 0, __spreadArray([minus(num1, num2)], __read(rest), false));
+    }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
+    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;
 }
-export default minus;
+
+export { minus as default };

package/esm/normalizeString.js

@@ -1,32 +1,11 @@
-import isNil from './utils/type/isNil';
-import convertToString from './utils/convertToString';
+import isNil from './utils/type/isNil.js';
+import convertToString from './utils/convertToString.js';
 
-/**
- * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
- *
- * @static
- * @alias module:Processor.normalizeString
- * @since 4.3.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
- * @param {*} value 待处理的值
- * @returns {string} 规整化的值
- * @example
- * 
- * normalizeString(); // ''
- * normalizeString(undefined); // ''
- * normalizeString(void 0); // ''
- * normalizeString(null); // ''
- *
- * normalizeString(true); // 'true'
- * normalizeString(NaN); // 'NaN'
- * normalizeString(1); // '1'
- * normalizeString('a'); // 'a'
- * 
- */
 function normalizeString(value) {
-  if (isNil(value)) {
-    return '';
-  }
-  return convertToString(value);
+    if (isNil(value)) {
+        return '';
+    }
+    return convertToString(value);
 }
-export default normalizeString;
+
+export { normalizeString as default };

package/esm/numberToChinese.js

@@ -1,234 +1,115 @@
-import { checkBoundary } from './utils/math.util';
-import devWarn from './utils/devWarn';
+import { checkBoundary } from './utils/math.util.js';
+import devWarn from './utils/devWarn.js';
 
-// 简体
 var chnNumberChar = ['零', '一', '二', '三', '四', '五', '六', '七', '八', '九'];
 var chnUnitChar = ['', '十', '百', '千'];
-
-// 繁体
 var big5NumberChar = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
 var big5UnitChar = ['', '拾', '佰', '仟'];
-
-// 数字字符、计数单位
-
-/**
- * @type {string[]}
- * @private
- */
 var numberChar;
-
-/**
- * @type {string[]}
- * @private
- */
 var unitChar;
-
-/**
- * @type {string[]}
- * @private
- */
 var unitSection;
-
-/**
- * 每个小节的内部进行转化
- *
- * @private
- * @param {number} section 数字
- * @returns {string} 转化的数字
- */
 function sectionToChinese(section) {
-  var str = '';
-  var chnstr = '';
-  var zero = false; //zero为是否进行补零， 第一次进行取余由于为个位数，默认不补零
-  var unitPos = 0;
-  while (section > 0) {
-    // 对数字取余10，得到的数即为个位数
-    var v = section % 10;
-
-    //如果数字为零，则对字符串进行补零
-    if (v == 0) {
-      if (zero) {
-        //如果遇到连续多次取余都是0，那么只需补一个零即可
-        zero = false;
-        chnstr = numberChar[v] + chnstr;
-      }
-    } else {
-      //第一次取余之后，如果再次取余为零，则需要补零
-      zero = true;
-      str = numberChar[v];
-      str += unitChar[unitPos];
-      chnstr = str + chnstr;
+    var str = '';
+    var chnstr = '';
+    var zero = false;
+    var unitPos = 0;
+    while (section > 0) {
+        var v = section % 10;
+        if (v == 0) {
+            if (zero) {
+                zero = false;
+                chnstr = numberChar[v] + chnstr;
+            }
+        }
+        else {
+            zero = true;
+            str = numberChar[v];
+            str += unitChar[unitPos];
+            chnstr = str + chnstr;
+        }
+        unitPos++;
+        section = Math.floor(section / 10);
     }
-    unitPos++;
-    section = Math.floor(section / 10);
-  }
-  return chnstr;
+    return chnstr;
 }
-
-/**
- * 转换整数
- *
- * @private
- * @param {number} num 要转换的数字
- * @returns {string} 中文数字
- */
 function convertInteger(num) {
-  var numInt = Math.floor(num);
-  var unitPos = 0;
-  var strIns = '';
-  var chnStr = '';
-  var needZero = false;
-  if (numInt === 0) {
-    return numberChar[0];
-  }
-  while (numInt > 0) {
-    var section = numInt % 10000;
-    if (needZero) {
-      chnStr = numberChar[0] + chnStr;
+    var numInt = Math.floor(num);
+    var unitPos = 0;
+    var strIns = '';
+    var chnStr = '';
+    var needZero = false;
+    if (numInt === 0) {
+        return numberChar[0];
     }
-    strIns = sectionToChinese(section);
-    strIns += section !== 0 ? unitSection[unitPos] : unitSection[0];
-    chnStr = strIns + chnStr;
-    needZero = section < 1000 && section > 0;
-    numInt = Math.floor(numInt / 10000);
-    unitPos++;
-  }
-  return chnStr;
+    while (numInt > 0) {
+        var section = numInt % 10000;
+        if (needZero) {
+            chnStr = numberChar[0] + chnStr;
+        }
+        strIns = sectionToChinese(section);
+        strIns += section !== 0 ? unitSection[unitPos] : unitSection[0];
+        chnStr = strIns + chnStr;
+        needZero = section < 1000 && section > 0;
+        numInt = Math.floor(numInt / 10000);
+        unitPos++;
+    }
+    return chnStr;
 }
-
-/**
- * 转换小数
- *
- * @private
- * @param {number} num 要转换的数字
- */
 function convertDecimal(num) {
-  var strNum = num + '';
-  var index = strNum.indexOf('.');
-  var ret = '';
-  if (index > -1) {
-    var decimalStr = strNum.slice(index + 1);
-    ret = mapNumberChar(parseInt(decimalStr));
-  }
-  return ret;
+    var strNum = num + '';
+    var index = strNum.indexOf('.');
+    var ret = '';
+    if (index > -1) {
+        var decimalStr = strNum.slice(index + 1);
+        ret = mapNumberChar(parseInt(decimalStr));
+    }
+    return ret;
 }
-
-/**
- * 映射为中文数字
- *
- * @private
- * @param {number} num 要处理的数字
- * @returns {string} 返回中文数字的映射
- */
 function mapNumberChar(num) {
-  var strNum = num + '';
-  var ret = '';
-  for (var i = 0, len = strNum.length; i < len; i++) {
-    ret += numberChar[parseInt(strNum[i])];
-  }
-  return ret;
+    var strNum = num + '';
+    var ret = '';
+    for (var i = 0, len = strNum.length; i < len; i++) {
+        ret += numberChar[parseInt(strNum[i])];
+    }
+    return ret;
 }
-
-/**
- * 数字转中文数字<br/><br/>
- * 
- * 如果数字不在安全数字 -9007199254740991～9007199254740991 范围内，处理会有异常。
- *
- * @static
- * @alias module:Processor.numberToChinese
- * @since 1.2.0
- * @param {number} num 数字
- * @param {Object} [options] 配置项
- * @param {boolean} [options.big5=false] 繁体
- * @param {boolean} [options.unit=true] 计数单位
- * @param {string} [options.decimal="点"] 中文小数点，繁体字为點
- * @param {string} [options.zero="零"] 设置0。常用配置 〇
- * @param {string} [options.negative="负"] 负数前面的字
- * @param {Object} [options.unitConfig] 节点单位配置
- * @param {string} [options.unitConfig.w="万"] 设置计数单位万。常用配置 萬
- * @param {string} [options.unitConfig.y="亿"] 设置计数单位亿。常用配置 億
- * @returns {string} 中文数字
- * @example
- *
- * numberToChinese(100); // 一百
- * numberToChinese(100.3); // 一百点三
- * numberToChinese(1234567890); // 一十二亿三千四百五十六万七千八百九十
- * numberToChinese(1234567890.11); // 一十二亿三千四百五十六万七千八百九十点一一
- *
- * // 繁体
- * numberToChinese(100, {big5: true}); // 壹佰
- * numberToChinese(100.3, {big5: true}); // 壹佰點叁
- * numberToChinese(1234567890.11, {big5: true}); // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾點壹壹
- *
- * // 不带计数单位
- * numberToChinese(1990, {unit: false}); // 一九九零
- *
- * // 不带计数单位，修改0
- * numberToChinese(1990, {unit: false, zero:'〇'}); // 一九九〇
- *
- */
-function numberToChinese(num) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  var _options$big = options.big5,
-    big5 = _options$big === void 0 ? false : _options$big,
-    _options$unit = options.unit,
-    unit = _options$unit === void 0 ? true : _options$unit,
-    _options$zero = options.zero,
-    zero = _options$zero === void 0 ? '' : _options$zero,
-    _options$negative = options.negative,
-    negative = _options$negative === void 0 ? '负' : _options$negative,
-    _options$unitConfig = options.unitConfig,
-    unitConfig = _options$unitConfig === void 0 ? {} : _options$unitConfig;
-  var _options$decimal = options.decimal,
-    decimal = _options$decimal === void 0 ? '' : _options$decimal;
-
-  // 非数字 或 NaN 不处理
-  if (typeof num !== 'number' || isNaN(num)) {
-    devWarn("\u53C2\u6570\u9519\u8BEF ".concat(num, "\uFF0C\u8BF7\u4F20\u5165\u6570\u5B57"));
-    return '';
-  }
-
-  // 超过安全数字提示
-  checkBoundary(num);
-
-  // 设置数字字符和计数单位
-  if (big5) {
-    numberChar = big5NumberChar.slice();
-    unitChar = big5UnitChar.slice();
-    decimal = decimal || '點';
-  } else {
-    numberChar = chnNumberChar.slice();
-    unitChar = chnUnitChar.slice();
-    decimal = decimal || '点';
-  }
-
-  // 设置节点计数单位，万、亿、万亿
-  var unitWan = (unitConfig === null || unitConfig === void 0 ? void 0 : unitConfig.w) || '万';
-  var unitYi = (unitConfig === null || unitConfig === void 0 ? void 0 : unitConfig.y) || '亿';
-  var unitWanYi = unitWan + unitYi;
-  unitSection = ['', unitWan, unitYi, unitWanYi];
-
-  // 设置0
-  if (zero) {
-    numberChar[0] = zero;
-  }
-
-  // 前置字符，负数处理
-  var preStr = num < 0 ? negative : '';
-
-  // 整数和小数
-  var chnInteger, chnDecimal;
-  var numAbs = Math.abs(num);
-
-  // 处理整数
-  if (unit) {
-    chnInteger = convertInteger(numAbs);
-  } else {
-    chnInteger = mapNumberChar(Math.floor(numAbs));
-  }
-
-  // 处理小数
-  chnDecimal = convertDecimal(numAbs);
-  return chnDecimal ? "".concat(preStr).concat(chnInteger).concat(decimal).concat(chnDecimal) : "".concat(preStr).concat(chnInteger);
+function numberToChinese(num, options) {
+    if (options === void 0) { options = {}; }
+    var _a = options.big5, big5 = _a === void 0 ? false : _a, _b = options.unit, unit = _b === void 0 ? true : _b, _c = options.zero, zero = _c === void 0 ? '' : _c, _d = options.negative, negative = _d === void 0 ? '负' : _d, _e = options.unitConfig, unitConfig = _e === void 0 ? {} : _e;
+    var _f = options.decimal, decimal = _f === void 0 ? '' : _f;
+    if (typeof num !== 'number' || isNaN(num)) {
+        devWarn("\u53C2\u6570\u9519\u8BEF ".concat(num, "\uFF0C\u8BF7\u4F20\u5165\u6570\u5B57"));
+        return '';
+    }
+    checkBoundary(num);
+    if (big5) {
+        numberChar = big5NumberChar.slice();
+        unitChar = big5UnitChar.slice();
+        decimal = decimal || '點';
+    }
+    else {
+        numberChar = chnNumberChar.slice();
+        unitChar = chnUnitChar.slice();
+        decimal = decimal || '点';
+    }
+    var unitWan = (unitConfig === null || unitConfig === void 0 ? void 0 : unitConfig.w) || '万';
+    var unitYi = (unitConfig === null || unitConfig === void 0 ? void 0 : unitConfig.y) || '亿';
+    var unitWanYi = unitWan + unitYi;
+    unitSection = ['', unitWan, unitYi, unitWanYi];
+    if (zero) {
+        numberChar[0] = zero;
+    }
+    var preStr = num < 0 ? negative : '';
+    var chnInteger;
+    var numAbs = Math.abs(num);
+    if (unit) {
+        chnInteger = convertInteger(numAbs);
+    }
+    else {
+        chnInteger = mapNumberChar(Math.floor(numAbs));
+    }
+    var chnDecimal = convertDecimal(numAbs);
+    return chnDecimal ? "".concat(preStr).concat(chnInteger).concat(decimal).concat(chnDecimal) : "".concat(preStr).concat(chnInteger);
 }
-export default numberToChinese;
+
+export { numberToChinese as default };