util-helpers 4.15.1 → 4.15.3

package/esm/bytesToSize.js

@@ -7,6 +7,7 @@
  * @param {number} bytes 字节大小
  * @param {Object} [options] 配置项
  * @param {string} [options.spaceMark=' '] 间隔字符
+ * @param {number} [options.precision=2] 精度
  * @returns {string} 存储单位值
  * @example
  *
@@ -23,13 +24,15 @@
 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;
+    spaceMark = _options$spaceMark === void 0 ? ' ' : _options$spaceMark,
+    _options$precision = options.precision,
+    precision = _options$precision === void 0 ? 2 : _options$precision;
   var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
   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(spaceMark).concat(sizes[i]) : numBytes + '';
+  return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(precision))).concat(spaceMark).concat(sizes[i]) : numBytes + '';
 }
 export default bytesToSize;

package/esm/filterTree.js

@@ -7,7 +7,7 @@ import { isObject } from "./utils/type";
  * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
  * 
  * @static
- * @alias module:Processor.filterTree
+ * @alias module:Tree.filterTree
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/esm/findTreeNode.js

@@ -8,7 +8,7 @@ import { isObject } from "./utils/type";
  * 查找树结构数据节点
  * 
  * @static
- * @alias module:Other.findTreeNode
+ * @alias module:Tree.findTreeNode
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/esm/findTreeNodes.js

@@ -8,7 +8,7 @@ import { isObject } from "./utils/type";
  * 查找树结构数据多个节点
  * 
  * @static
- * @alias module:Other.findTreeNodes
+ * @alias module:Tree.findTreeNodes
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/esm/findTreeSelect.js

@@ -54,7 +54,7 @@ function internalFindTreeSelect(tree, predicate, childrenField) {
  * 查找包含当前节点的所有父级节点
  * 
  * @static
- * @alias module:Other.findTreeSelect
+ * @alias module:Tree.findTreeSelect
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/esm/formatMoney.js

@@ -77,25 +77,25 @@ function formatDec(decStr, precision, decimal) {
  * @alias module:Processor.formatMoney
  * @since 1.1.0
  * @param {string | number} num 需转换金额 (最大：9007199254740991 最小： -9007199254740991)
- * @param {Object} [options] - 金额格式化配置
- * @param {string | number} [options.precision=2] - 保留位数 （最高：10位）
- * @param {string} [options.symbol] - 货币符号
- * @param {string} [options.thousand=","] - 千分位符号
- * @param {string} [options.decimal="."] - 小数位符号
+ * @param {Object} [options] 金额格式化配置
+ * @param {number} [options.precision=2] 保留位数 （最高：10位）
+ * @param {string} [options.symbol] 货币符号
+ * @param {string} [options.thousand=","] 千分位符号
+ * @param {string} [options.decimal="."] 小数位符号
  * @returns {string} 格式化的金额
  * @example
  *
  * // 整数
- * formatMoney('1000'); // 1,000.00
+ * formatMoney(1000); // 1,000.00
  *
  * // 小数（默认保留2位小数）
- * formatMoney('3000.03'); // 3,000.03
+ * formatMoney(3000.03); // 3,000.03
  *
  * // 保留4位小数
- * formatMoney('3000.0300', { precision: 4 }); // 3,000.0300
+ * formatMoney(3000.03, { precision: 4 }); // 3,000.0300
  *
  * // 保留10位小数
- * formatMoney('1500.2', { precision: 10 }); // 1,500.2000000000
+ * formatMoney(1500.2, { precision: 10 }); // 1,500.2000000000
  *
  * // 自定义单位符号
  * formatMoney(1000.00, { symbol: '$' }); // $1,000.00
@@ -106,6 +106,8 @@ function formatDec(decStr, precision, decimal) {
  * // 自定义小数位分割符(默认'.')
  * formatMoney(1000.00, { decimal: '&' }); // 1,000&00
  * 
+ * // 字符串数字
+ * formatMoney('3000.03', { precision: 4 }); // 3,000.0300
  */
 var formatMoney = function formatMoney(num) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};

package/esm/index.js

@@ -46,10 +46,6 @@ export { default as normalizeString } from './normalizeString';
 export { default as safeDate } from './safeDate';
 export { default as formatMobile } from './formatMobile';
 export { default as padZero } from './padZero';
-export { default as transformFieldNames } from './transformFieldNames';
-export { default as listToTree } from './listToTree';
-export { default as treeToList } from './treeToList';
-export { default as filterTree } from './filterTree';
 
 /**
  * 数学计算，修正浮点数计算问题
@@ -106,6 +102,17 @@ export { default as waitTime } from './waitTime';
 export { default as calculateCursorPosition } from './calculateCursorPosition';
 export { default as randomString } from './randomString';
 export { default as strlen } from './strlen';
+
+/**
+ * 树结构数据查询、过滤、转换等处理方法
+ *
+ * @module Tree
+ * @since 4.14.0
+ */
+export { default as transformFieldNames } from './transformFieldNames';
+export { default as listToTree } from './listToTree';
+export { default as treeToList } from './treeToList';
+export { default as filterTree } from './filterTree';
 export { default as findTreeNode } from './findTreeNode';
 export { default as findTreeNodes } from './findTreeNodes';
 export { default as findTreeSelect } from './findTreeSelect';

package/esm/listToTree.js

@@ -40,7 +40,7 @@ function processEmptyChildren(arr, options) {
  * 列表数据转树结构
  * 
  * @static
- * @alias module:Processor.listToTree
+ * @alias module:Tree.listToTree
  * @since 4.14.0
  * @template {Record<string,any>} [T=Record<string,any>]
  * @template {*} [R=T&Record<string,any>]

package/esm/replaceChar.js

@@ -16,20 +16,24 @@ import normalizeString from './normalizeString';
  * @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
  *
  * // 用户名

package/esm/transformFieldNames.doc.js

@@ -5,7 +5,7 @@
  * 转换字段名，返回一个转换字段后的值，不改变原值。
  * 
  * @static
- * @alias module:Processor.transformFieldNames
+ * @alias module:Tree.transformFieldNames
  * @since 4.14.0
  * @param {object[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
  * @param {object} fieldNames 字段名映射

package/esm/transformFieldNames.type.js

@@ -1,5 +1,3 @@
-// @ts-nocheck
-
 // 交换字段名
 /**
  * @template {*} D
@@ -8,10 +6,10 @@
  */
 
 // 交换字段名，支持嵌套
-// 先排除子级字段名，再交换字段名，然后加上子级字段名，再替换一次。这里的 F 有类型问题，因为排除了子级字段名，暂时没有比较好的方案处理。
+// 先排除子级字段名，再交换字段名，然后加上子级字段名，再替换一次。
 /**
  * @template {*} D
- * @template {Record<string, keyof D>} F
+ * @template {Record<string, any>} F
  * @template {string} C
  * @typedef {(C extends keyof D ? ExchangeFieldNames<Omit<D, C> & Record<C, TransformFieldNames<D, F, C>>, F> : ExchangeFieldNames<D, F>)[]} TransformFieldNames
  */

package/esm/treeToList.js

@@ -7,7 +7,7 @@ import { isObject } from "./utils/type";
  * 树结构转列表数据
  * 
  * @static
- * @alias module:Processor.treeToList
+ * @alias module:Tree.treeToList
  * @since 4.14.0
  * @template {Record<string,any>} T
  * @template {keyof T} K

package/esm/utils/config.js

@@ -15,5 +15,5 @@ function setDisableWarning(bool) {
 }
 
 // eslint-disable-next-line no-undef
-var version = "4.15.1";
+var version = "4.15.3";
 export { config, setDisableWarning, version };

package/lib/bytesToSize.js

@@ -13,6 +13,7 @@ exports["default"] = void 0;
  * @param {number} bytes 字节大小
  * @param {Object} [options] 配置项
  * @param {string} [options.spaceMark=' '] 间隔字符
+ * @param {number} [options.precision=2] 精度
  * @returns {string} 存储单位值
  * @example
  *
@@ -29,14 +30,16 @@ exports["default"] = void 0;
 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;
+    spaceMark = _options$spaceMark === void 0 ? ' ' : _options$spaceMark,
+    _options$precision = options.precision,
+    precision = _options$precision === void 0 ? 2 : _options$precision;
   var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
   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(spaceMark).concat(sizes[i]) : numBytes + '';
+  return sizes[i] ? "".concat(Number((numBytes / Math.pow(k, i)).toFixed(precision))).concat(spaceMark).concat(sizes[i]) : numBytes + '';
 }
 var _default = bytesToSize;
 exports["default"] = _default;

package/lib/filterTree.js

@@ -15,7 +15,7 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
  * 
  * @static
- * @alias module:Processor.filterTree
+ * @alias module:Tree.filterTree
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/lib/findTreeNode.js

@@ -16,7 +16,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  * 查找树结构数据节点
  * 
  * @static
- * @alias module:Other.findTreeNode
+ * @alias module:Tree.findTreeNode
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/lib/findTreeNodes.js

@@ -16,7 +16,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  * 查找树结构数据多个节点
  * 
  * @static
- * @alias module:Other.findTreeNodes
+ * @alias module:Tree.findTreeNodes
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/lib/findTreeSelect.js

@@ -59,7 +59,7 @@ function internalFindTreeSelect(tree, predicate, childrenField) {
  * 查找包含当前节点的所有父级节点
  * 
  * @static
- * @alias module:Other.findTreeSelect
+ * @alias module:Tree.findTreeSelect
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/lib/formatMoney.js

@@ -88,25 +88,25 @@ function formatDec(decStr, precision, decimal) {
  * @alias module:Processor.formatMoney
  * @since 1.1.0
  * @param {string | number} num 需转换金额 (最大：9007199254740991 最小： -9007199254740991)
- * @param {Object} [options] - 金额格式化配置
- * @param {string | number} [options.precision=2] - 保留位数 （最高：10位）
- * @param {string} [options.symbol] - 货币符号
- * @param {string} [options.thousand=","] - 千分位符号
- * @param {string} [options.decimal="."] - 小数位符号
+ * @param {Object} [options] 金额格式化配置
+ * @param {number} [options.precision=2] 保留位数 （最高：10位）
+ * @param {string} [options.symbol] 货币符号
+ * @param {string} [options.thousand=","] 千分位符号
+ * @param {string} [options.decimal="."] 小数位符号
  * @returns {string} 格式化的金额
  * @example
  *
  * // 整数
- * formatMoney('1000'); // 1,000.00
+ * formatMoney(1000); // 1,000.00
  *
  * // 小数（默认保留2位小数）
- * formatMoney('3000.03'); // 3,000.03
+ * formatMoney(3000.03); // 3,000.03
  *
  * // 保留4位小数
- * formatMoney('3000.0300', { precision: 4 }); // 3,000.0300
+ * formatMoney(3000.03, { precision: 4 }); // 3,000.0300
  *
  * // 保留10位小数
- * formatMoney('1500.2', { precision: 10 }); // 1,500.2000000000
+ * formatMoney(1500.2, { precision: 10 }); // 1,500.2000000000
  *
  * // 自定义单位符号
  * formatMoney(1000.00, { symbol: '$' }); // $1,000.00
@@ -117,6 +117,8 @@ function formatDec(decStr, precision, decimal) {
  * // 自定义小数位分割符(默认'.')
  * formatMoney(1000.00, { decimal: '&' }); // 1,000&00
  * 
+ * // 字符串数字
+ * formatMoney('3000.03', { precision: 4 }); // 3,000.0300
  */
 var formatMoney = function formatMoney(num) {
   var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};

package/lib/index.js

@@ -356,10 +356,6 @@ var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 var _safeDate = _interopRequireDefault(require("./safeDate"));
 var _formatMobile = _interopRequireDefault(require("./formatMobile"));
 var _padZero = _interopRequireDefault(require("./padZero"));
-var _transformFieldNames = _interopRequireDefault(require("./transformFieldNames"));
-var _listToTree = _interopRequireDefault(require("./listToTree"));
-var _treeToList = _interopRequireDefault(require("./treeToList"));
-var _filterTree = _interopRequireDefault(require("./filterTree"));
 var _plus = _interopRequireDefault(require("./plus"));
 var _minus = _interopRequireDefault(require("./minus"));
 var _times = _interopRequireDefault(require("./times"));
@@ -369,6 +365,10 @@ var _waitTime = _interopRequireDefault(require("./waitTime"));
 var _calculateCursorPosition = _interopRequireDefault(require("./calculateCursorPosition"));
 var _randomString = _interopRequireDefault(require("./randomString"));
 var _strlen = _interopRequireDefault(require("./strlen"));
+var _transformFieldNames = _interopRequireDefault(require("./transformFieldNames"));
+var _listToTree = _interopRequireDefault(require("./listToTree"));
+var _treeToList = _interopRequireDefault(require("./treeToList"));
+var _filterTree = _interopRequireDefault(require("./filterTree"));
 var _findTreeNode = _interopRequireDefault(require("./findTreeNode"));
 var _findTreeNodes = _interopRequireDefault(require("./findTreeNodes"));
 var _findTreeSelect = _interopRequireDefault(require("./findTreeSelect"));

package/lib/listToTree.js

@@ -48,7 +48,7 @@ function processEmptyChildren(arr, options) {
  * 列表数据转树结构
  * 
  * @static
- * @alias module:Processor.listToTree
+ * @alias module:Tree.listToTree
  * @since 4.14.0
  * @template {Record<string,any>} [T=Record<string,any>]
  * @template {*} [R=T&Record<string,any>]

package/lib/replaceChar.js

@@ -22,20 +22,24 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * @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
  *
  * // 用户名

package/lib/transformFieldNames.doc.js

@@ -11,7 +11,7 @@ exports["default"] = void 0;
  * 转换字段名，返回一个转换字段后的值，不改变原值。
  * 
  * @static
- * @alias module:Processor.transformFieldNames
+ * @alias module:Tree.transformFieldNames
  * @since 4.14.0
  * @param {object[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
  * @param {object} fieldNames 字段名映射

package/lib/treeToList.js

@@ -15,7 +15,7 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * 树结构转列表数据
  * 
  * @static
- * @alias module:Processor.treeToList
+ * @alias module:Tree.treeToList
  * @since 4.14.0
  * @template {Record<string,any>} T
  * @template {keyof T} K

package/lib/utils/config.js

@@ -24,5 +24,5 @@ function setDisableWarning(bool) {
 }
 
 // eslint-disable-next-line no-undef
-var version = "4.15.1";
+var version = "4.15.3";
 exports.version = version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.15.1",
+  "version": "4.15.3",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/bytesToSize.d.ts

@@ -8,6 +8,7 @@ export default bytesToSize;
  * @param {number} bytes 字节大小
  * @param {Object} [options] 配置项
  * @param {string} [options.spaceMark=' '] 间隔字符
+ * @param {number} [options.precision=2] 精度
  * @returns {string} 存储单位值
  * @example
  *
@@ -23,4 +24,5 @@ export default bytesToSize;
  */
 declare function bytesToSize(bytes: number, options?: {
     spaceMark?: string | undefined;
+    precision?: number | undefined;
 } | undefined): string;

package/types/filterTree.d.ts

@@ -3,7 +3,7 @@ export default filterTree;
  * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
  *
  * @static
- * @alias module:Processor.filterTree
+ * @alias module:Tree.filterTree
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/types/findTreeNode.d.ts

@@ -3,7 +3,7 @@ export default findTreeNode;
  * 查找树结构数据节点
  *
  * @static
- * @alias module:Other.findTreeNode
+ * @alias module:Tree.findTreeNode
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/types/findTreeNodes.d.ts

@@ -3,7 +3,7 @@ export default findTreeNodes;
  * 查找树结构数据多个节点
  *
  * @static
- * @alias module:Other.findTreeNodes
+ * @alias module:Tree.findTreeNodes
  * @since 4.15.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/types/findTreeSelect.d.ts

@@ -3,7 +3,7 @@ export default findTreeSelect;
  * 查找包含当前节点的所有父级节点
  *
  * @static
- * @alias module:Other.findTreeSelect
+ * @alias module:Tree.findTreeSelect
  * @since 4.14.0
  * @template {any} T
  * @template {(item: T) => boolean} F

package/types/formatMoney.d.ts

@@ -6,25 +6,25 @@ export default formatMoney;
  * @alias module:Processor.formatMoney
  * @since 1.1.0
  * @param {string | number} num 需转换金额 (最大：9007199254740991 最小： -9007199254740991)
- * @param {Object} [options] - 金额格式化配置
- * @param {string | number} [options.precision=2] - 保留位数 （最高：10位）
- * @param {string} [options.symbol] - 货币符号
- * @param {string} [options.thousand=","] - 千分位符号
- * @param {string} [options.decimal="."] - 小数位符号
+ * @param {Object} [options] 金额格式化配置
+ * @param {number} [options.precision=2] 保留位数 （最高：10位）
+ * @param {string} [options.symbol] 货币符号
+ * @param {string} [options.thousand=","] 千分位符号
+ * @param {string} [options.decimal="."] 小数位符号
  * @returns {string} 格式化的金额
  * @example
  *
  * // 整数
- * formatMoney('1000'); // 1,000.00
+ * formatMoney(1000); // 1,000.00
  *
  * // 小数（默认保留2位小数）
- * formatMoney('3000.03'); // 3,000.03
+ * formatMoney(3000.03); // 3,000.03
  *
  * // 保留4位小数
- * formatMoney('3000.0300', { precision: 4 }); // 3,000.0300
+ * formatMoney(3000.03, { precision: 4 }); // 3,000.0300
  *
  * // 保留10位小数
- * formatMoney('1500.2', { precision: 10 }); // 1,500.2000000000
+ * formatMoney(1500.2, { precision: 10 }); // 1,500.2000000000
  *
  * // 自定义单位符号
  * formatMoney(1000.00, { symbol: '$' }); // $1,000.00
@@ -35,9 +35,11 @@ export default formatMoney;
  * // 自定义小数位分割符(默认'.')
  * formatMoney(1000.00, { decimal: '&' }); // 1,000&00
  *
+ * // 字符串数字
+ * formatMoney('3000.03', { precision: 4 }); // 3,000.0300
  */
 declare function formatMoney(num: string | number, options?: {
-    precision?: string | number | undefined;
+    precision?: number | undefined;
     symbol?: string | undefined;
     thousand?: string | undefined;
     decimal?: string | undefined;

package/types/index.d.ts

@@ -33,10 +33,6 @@ export { default as normalizeString } from "./normalizeString";
 export { default as safeDate } from "./safeDate";
 export { default as formatMobile } from "./formatMobile";
 export { default as padZero } from "./padZero";
-export { default as transformFieldNames } from "./transformFieldNames";
-export { default as listToTree } from "./listToTree";
-export { default as treeToList } from "./treeToList";
-export { default as filterTree } from "./filterTree";
 export { default as plus } from "./plus";
 export { default as minus } from "./minus";
 export { default as times } from "./times";
@@ -46,6 +42,10 @@ export { default as waitTime } from "./waitTime";
 export { default as calculateCursorPosition } from "./calculateCursorPosition";
 export { default as randomString } from "./randomString";
 export { default as strlen } from "./strlen";
+export { default as transformFieldNames } from "./transformFieldNames";
+export { default as listToTree } from "./listToTree";
+export { default as treeToList } from "./treeToList";
+export { default as filterTree } from "./filterTree";
 export { default as findTreeNode } from "./findTreeNode";
 export { default as findTreeNodes } from "./findTreeNodes";
 export { default as findTreeSelect } from "./findTreeSelect";

package/types/listToTree.d.ts

@@ -3,7 +3,7 @@ export default listToTree;
  * 列表数据转树结构
  *
  * @static
- * @alias module:Processor.listToTree
+ * @alias module:Tree.listToTree
  * @since 4.14.0
  * @template {Record<string,any>} [T=Record<string,any>]
  * @template {*} [R=T&Record<string,any>]

package/types/replaceChar.d.ts

@@ -15,20 +15,24 @@ export default replaceChar;
  * @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
  *
  * // 用户名

package/types/transformFieldNames.type.d.ts

@@ -1,2 +1,2 @@
 export type ExchangeFieldNames<D extends unknown, F extends Record<string, keyof D>> = Omit<D, F[keyof F]> & { [P in keyof F]: D[F[P]]; };
-export type TransformFieldNames<D extends unknown, F extends Record<string, keyof D>, C extends string> = (C extends keyof D ? ExchangeFieldNames<Omit<D, C> & Record<C, TransformFieldNames<D, F, C>>, F> : ExchangeFieldNames<D, F>)[];
+export type TransformFieldNames<D extends unknown, F extends Record<string, any>, C extends string> = (C extends keyof D ? ExchangeFieldNames<Omit<D, C> & Record<C, TransformFieldNames<D, F, C>>, F> : ExchangeFieldNames<D, F>)[];

package/types/treeToList.d.ts

@@ -3,7 +3,7 @@ export default treeToList;
  * 树结构转列表数据
  *
  * @static
- * @alias module:Processor.treeToList
+ * @alias module:Tree.treeToList
  * @since 4.14.0
  * @template {Record<string,any>} T
  * @template {keyof T} K