util-helpers 4.11.0 → 4.12.1

package/esm/index.js

@@ -53,6 +53,40 @@ export { default as padZero } from './padZero';
  * @since 3.1.0
  * @see 参考 {@link https://github.com/camsong/blog/issues/9|JavaScript 浮点数陷阱及解法}
  * @see 参考 {@link https://2zbuy.csb.app/|JS浮点数计算测试}
+ * @example
+ * // 从 4.12.0 版本开始，规范了有效数值参数校验。
+ * // 有效数值即数字或字符串类型，能通过 Number(value) 转为数字，且不能为 NaN 、空字符串、空格字符串。
+ * 
+ * // 以下为有效数值：
+ * // 1. 数字: 1, -1, 1e-2, 1.312, 0.1, Infinity
+ * // 2. 数字字符串: '1', '10e2', '-1', '0.1'
+ * 
+ * // 以下为无效数值：
+ * // 1. 非数字的字符串: '', ' ', '1a', '-12a', '10.2.2', '10e2.1'
+ * // 2. 其他类型值: undefined, null, true, false, [], {}, new Date(), ...
+ * 
+ * // 注意：Number('') 、 Number(' ') 、 Number(new Date) 、 Number(true)等等是可以返回数字，但都不是有效数值。
+ * // 因为它们分别是空字符串、空格字符串和非数字或字符串类型。
+ * 
+ * 
+ * // 计算说明：
+ * // 1. 全部参数都是无效数值将返回 NaN 。
+ * plus(); // NaN
+ * plus(new Date()); // NaN
+ * plus(true, null); // NaN
+ * 
+ * // 2. 参数中包含有效数值和无效数值，将忽略无效数值。
+ * plus(0.1); // 0.1
+ * plus('0.1', ' ', true, ); // 0.1
+ * plus(true, 0.1); // 0.1
+ * plus(true, 0.1, 0.2); // 0.3
+ * plus('', 0.1, ' ', new Date(), 0.2); // 0.3
+ * plus(0.1, true, 0.2, null); // 0.3
+ * 
+ * // 3. 数字和数字字符串将正常的使用安全计算
+ * plus(0.1, 0.2); // 0.3
+ * plus(0.1, 0.2, 0.3); // 0.6
+ * 
  */
 
 export { default as plus } from './plus';
@@ -79,4 +113,4 @@ export { default as strlen } from './strlen';
  * @since 3.6.1
  */
 
-export { setDisableWarning } from './utils/config';
+export { setDisableWarning, version } from './utils/config';

package/esm/minus.js

@@ -1,7 +1,6 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { digitLength } from './utils/math.util';
+import { digitLength, isEffectiveNumeric } from './utils/math.util';
 import times from './times';
-import { isNumber, isNaN, isString } from './utils/type';
 /**
  * 精确减法，支持多个数相减
  *
@@ -33,12 +32,13 @@ function minus() {
 
   if (rest.length > 0) {
     return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!isNumber(num2) || isNaN(num2)) && !isString(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!isEffectiveNumeric(num1)) {
+    return isEffectiveNumeric(num2) ? Number(num2) : NaN;
+  } else if (!isEffectiveNumeric(num2)) {
+    return Number(num1);
   }
 
   var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));

package/esm/plus.js

@@ -1,7 +1,6 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { digitLength } from './utils/math.util';
+import { digitLength, isEffectiveNumeric } from './utils/math.util';
 import times from './times';
-import { isNumber, isNaN, isString } from './utils/type';
 /**
  * 精确加法，支持多个数相加
  *
@@ -33,12 +32,13 @@ function plus() {
 
   if (rest.length > 0) {
     return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!isNumber(num2) || isNaN(num2)) && !isString(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!isEffectiveNumeric(num1)) {
+    return isEffectiveNumeric(num2) ? Number(num2) : NaN;
+  } else if (!isEffectiveNumeric(num2)) {
+    return Number(num1);
   }
 
   var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));

package/esm/round.js

@@ -1,6 +1,6 @@
 import divide from './divide';
 import times from './times';
-import { isNumber, isString, isNaN } from './utils/type';
+import { isEffectiveNumeric } from './utils/math.util';
 /**
  * 四舍五入，支持设置精度
  *
@@ -25,10 +25,9 @@ import { isNumber, isString, isNaN } from './utils/type';
 function round(num) {
   var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
 
-  // 兼容处理，如果参数为非数字或字符串时，直接返回
-  if ((!isNumber(num) || isNaN(num)) && !isString(num)) {
-    // @ts-ignore
-    return num;
+  // 兼容处理，如果参数包含无效数值时，返回第一个参数
+  if (!isEffectiveNumeric(num)) {
+    return NaN;
   }
 
   var base = Math.pow(10, precision);

package/esm/times.js

@@ -1,6 +1,5 @@
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
-import { digitLength, float2Fixed, checkBoundary } from './utils/math.util';
-import { isNumber, isNaN, isString } from './utils/type';
+import { digitLength, float2Fixed, checkBoundary, isEffectiveNumeric } from './utils/math.util';
 /**
  * 精确乘法，支持多个数相乘
  *
@@ -32,12 +31,13 @@ function times() {
 
   if (rest.length > 0) {
     return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!isNumber(num2) || isNaN(num2)) && !isString(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!isEffectiveNumeric(num1)) {
+    return isEffectiveNumeric(num2) ? Number(num2) : NaN;
+  } else if (!isEffectiveNumeric(num2)) {
+    return Number(num1);
   }
 
   var num1Changed = float2Fixed(num1);

package/esm/utils/config.js

@@ -1,3 +1,4 @@
+var version = "4.12.1";
 var config = {
   // 禁用warning提示
   disableWarning: true
@@ -14,4 +15,4 @@ function setDisableWarning(bool) {
   config.disableWarning = !!bool;
 }
 
-export { config, setDisableWarning };
+export { config, setDisableWarning, version };

package/esm/utils/math.util.js

@@ -6,6 +6,36 @@
  */
 import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from './constants';
 import devWarn from './devWarn';
+import { isNumber, isString } from './type';
+/**
+ * 值是否为有效的数值
+ * 
+ * @param {*} value 待检测的值
+ * @returns {boolean} 是否为有效的数值
+ */
+
+export function isEffectiveNumeric(value) {
+  if (isNumber(value) && !isNaN(value)) {
+    return true;
+  } // 避免空字符串 或 带空格的字符串
+
+
+  if (isString(value)) {
+    var fmtStrValue = value.trim(); // 带空格的字符串也不转换数字
+    // Number(' ') => 0
+
+    if (fmtStrValue === value) {
+      var numValue = fmtStrValue ? Number(fmtStrValue) : NaN;
+
+      if (isNumber(numValue) && !isNaN(numValue)) {
+        return true;
+      }
+    }
+  }
+
+  devWarn("".concat(value, " is not a valid number."));
+  return false;
+}
 /**
  * 是否为科学计数法数字
  *

package/lib/divide.js

@@ -9,8 +9,6 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
-var _type = require("./utils/type");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -55,12 +53,13 @@ function divide() {
 
   if (rest.length > 0) {
     return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var num1Changed = (0, _math.float2Fixed)(num1);

package/lib/index.js

@@ -273,6 +273,12 @@ Object.defineProperty(exports, "setDisableWarning", {
     return _config.setDisableWarning;
   }
 });
+Object.defineProperty(exports, "version", {
+  enumerable: true,
+  get: function get() {
+    return _config.version;
+  }
+});
 
 var _isMobile = _interopRequireDefault(require("./isMobile"));
 

package/lib/minus.js

@@ -9,8 +9,6 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
-var _type = require("./utils/type");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -55,12 +53,13 @@ function minus() {
 
   if (rest.length > 0) {
     return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var baseNum = Math.pow(10, Math.max((0, _math.digitLength)(num1), (0, _math.digitLength)(num2)));

package/lib/plus.js

@@ -9,8 +9,6 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
-var _type = require("./utils/type");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -55,12 +53,13 @@ function plus() {
 
   if (rest.length > 0) {
     return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var baseNum = Math.pow(10, Math.max((0, _math.digitLength)(num1), (0, _math.digitLength)(num2)));

package/lib/round.js

@@ -9,7 +9,7 @@ var _divide = _interopRequireDefault(require("./divide"));
 
 var _times = _interopRequireDefault(require("./times"));
 
-var _type = require("./utils/type");
+var _math = require("./utils/math.util");
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
@@ -36,10 +36,9 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 function round(num) {
   var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
 
-  // 兼容处理，如果参数为非数字或字符串时，直接返回
-  if ((!(0, _type.isNumber)(num) || (0, _type.isNaN)(num)) && !(0, _type.isString)(num)) {
-    // @ts-ignore
-    return num;
+  // 兼容处理，如果参数包含无效数值时，返回第一个参数
+  if (!(0, _math.isEffectiveNumeric)(num)) {
+    return NaN;
   }
 
   var base = Math.pow(10, precision);

package/lib/times.js

@@ -7,8 +7,6 @@ exports["default"] = void 0;
 
 var _math = require("./utils/math.util");
 
-var _type = require("./utils/type");
-
 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."); }
@@ -51,12 +49,13 @@ function times() {
 
   if (rest.length > 0) {
     return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var num1Changed = (0, _math.float2Fixed)(num1);

package/lib/utils/config.js

@@ -4,7 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.setDisableWarning = setDisableWarning;
-exports.config = void 0;
+exports.version = exports.config = void 0;
+var version = "4.12.1";
+exports.version = version;
 var config = {
   // 禁用warning提示
   disableWarning: true

package/lib/utils/math.util.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.isEffectiveNumeric = isEffectiveNumeric;
 exports.isScientificNumber = isScientificNumber;
 exports.strip = strip;
 exports.digitLength = digitLength;
@@ -15,6 +16,8 @@ var _constants = require("./constants");
 
 var _devWarn = _interopRequireDefault(require("./devWarn"));
 
+var _type = require("./type");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /**
@@ -24,12 +27,42 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * 问题示例：2.3 + 2.4 = 4.699999999999999，1.0 - 0.9 = 0.09999999999999998
  */
 
+/**
+ * 值是否为有效的数值
+ * 
+ * @param {*} value 待检测的值
+ * @returns {boolean} 是否为有效的数值
+ */
+function isEffectiveNumeric(value) {
+  if ((0, _type.isNumber)(value) && !isNaN(value)) {
+    return true;
+  } // 避免空字符串 或 带空格的字符串
+
+
+  if ((0, _type.isString)(value)) {
+    var fmtStrValue = value.trim(); // 带空格的字符串也不转换数字
+    // Number(' ') => 0
+
+    if (fmtStrValue === value) {
+      var numValue = fmtStrValue ? Number(fmtStrValue) : NaN;
+
+      if ((0, _type.isNumber)(numValue) && !isNaN(numValue)) {
+        return true;
+      }
+    }
+  }
+
+  (0, _devWarn["default"])("".concat(value, " is not a valid number."));
+  return false;
+}
 /**
  * 是否为科学计数法数字
  *
  * @param {string} num 检查值
  * @returns {boolean}
  */
+
+
 function isScientificNumber(num) {
   return /\d+\.?\d*e[\+\-]*\d+/i.test(num);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.11.0",
+  "version": "4.12.1",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -62,10 +62,13 @@
     "@babel/preset-env": "^7.9.0",
     "@commitlint/cli": "^11.0.0",
     "@commitlint/config-conventional": "^11.0.0",
+    "@rollup/plugin-babel": "^5.3.1",
     "@rollup/plugin-commonjs": "^19.0.0",
+    "@rollup/plugin-json": "^4.1.0",
     "@rollup/plugin-node-resolve": "^13.0.0",
     "@types/jest": "^26.0.23",
     "babel-jest": "^27.0.2",
+    "babel-plugin-inline-json": "^2.1.0",
     "cross-env": "^7.0.3",
     "cz-conventional-changelog": "^3.3.0",
     "docdash": "^1.2.0",

package/types/src/blobToDataURL.d.ts

@@ -0,0 +1,25 @@
+export default blobToDataURL;
+/**
+ * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串。
+ *
+ * @static
+ * @alias module:Processor.blobToDataURL
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
+ * @since 4.1.0
+ * @param {Blob} blob Blob 或 File 对象
+ * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
+ * @example
+ * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
+ * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
+ *
+ * blobToDataURL(htmlBlob).then(data=>{
+ *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * });
+ *
+ * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
+ *
+ * blobToDataURL(textBlob).then(data=>{
+ *   console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+ * });
+ */
+declare function blobToDataURL(blob: Blob): Promise<string>;

package/types/src/bytesToSize.d.ts

@@ -0,0 +1,24 @@
+export default bytesToSize;
+/**
+ * 字节转换存储单位，保留2位小数点
+ *
+ * @static
+ * @alias module:Processor.bytesToSize
+ * @since 3.8.0
+ * @param {number} bytes 字节大小
+ * @returns {string} 存储单位值
+ * @example
+ *
+ * bytesToSize(0);
+ * // => 0 B
+ *
+ * bytesToSize(1024);
+ * // => 1 KB
+ *
+ * bytesToSize(3.213243*1024*1024);
+ * // => 3.21 MB
+ *
+ * bytesToSize(1024*1024*1024);
+ * // => 1 GB
+ */
+declare function bytesToSize(bytes: number): string;

package/types/src/calculateCursorPosition.d.ts

@@ -0,0 +1,26 @@
+export default calculateCursorPosition;
+/**
+ * 计算输入框的值格式化后光标位置
+ *
+ * @static
+ * @alias module:Other.calculateCursorPosition
+ * @since 4.6.0
+ * @see 格式化手机号码 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile|formatMobile}
+ * @see 格式化银行卡号 {@link https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard|formatBankCard}
+ * @see h5示例 {@link https://2950v9.csb.app/|点击查看}
+ * @see react示例 {@link https://33ccy9.csb.app/|点击查看}
+ * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
+ * @param {string} prevCtrlValue 上一个格式化后的值
+ * @param {string} rawValue 当前输入原值
+ * @param {string} ctrlValue 当前格式化后的值
+ * @param {Object} [options] 配置项
+ * @param {string[]|string} [options.placeholderChar=' '] 占位符
+ * @param {RegExp} [options.maskReg=/\D/g] 需要遮盖的字符规则。默认去掉非数字，意味着 ctrlValue 需要去掉非数字。
+ * @param {'mobile'|'bankCard'} [options.type] 格式化类型，内置手机号码和银行卡号特殊处理
+ * @returns {number} 格式化后的光标位置
+ */
+declare function calculateCursorPosition(prevPos: number, prevCtrlValue: string, rawValue: string, ctrlValue: string, { placeholderChar, maskReg, type }?: {
+    placeholderChar?: string | string[] | undefined;
+    maskReg?: RegExp | undefined;
+    type?: "mobile" | "bankCard" | undefined;
+} | undefined): number;

package/types/src/dataURLToBlob.d.ts

@@ -0,0 +1,15 @@
+export default dataURLToBlob;
+/**
+ * 将 DataURL 转为 Blob 对象
+ *
+ * @static
+ * @alias module:Processor.dataURLToBlob
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
+ * @since 4.1.0
+ * @param {string} dataurl data: 协议的URL
+ * @returns {Blob} Blob 对象
+ * @example
+ * const dataurl = 'data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
+ * dataURLToBlob(dataurl);
+ */
+declare function dataURLToBlob(dataurl: string): Blob;

package/types/src/divide.d.ts

@@ -0,0 +1,21 @@
+export default divide;
+/**
+ * 精确除法，支持多个数相除
+ *
+ * @static
+ * @alias module:Math.divide
+ * @since 3.1.0
+ * @param {...number|string} nums 除数和被除数
+ * @returns {number} 商数
+ * @example
+ *
+ * divide(1.21, 1.1);
+ * // => 1.1
+ *
+ * divide(1000, 10, 10);
+ * // => 10
+ *
+ * divide(1000, 10, 10, 10);
+ * // => 1
+ */
+declare function divide(...nums: (number | string)[]): number;

package/types/src/formatBankCard.d.ts

@@ -0,0 +1,35 @@
+export default formatBankCard;
+/**
+ * 格式化银行卡号
+ *
+ * @static
+ * @alias module:Processor.formatBankCard
+ * @since 1.1.0
+ * @param {string} bankCardNo 要处理的字符串
+ * @param {Object} [options] 配置项
+ * @param {string} [options.char=" "] 间隔字符
+ * @param {number} [options.length=4] 间隔长度
+ * @returns {string} 格式化的银行卡号
+ * @example
+ *
+ * // 19位银行卡
+ * formatBankCard('6228480402564890018');
+ * // => 6228 4804 0256 4890 018
+ *
+ * // 16位银行卡
+ * formatBankCard('6228480402564890');
+ * // => 6228 4804 0256 4890
+ *
+ * // 脱敏银行卡
+ * formatBankCard('6228********890');
+ * // => 6228 **** **** 890
+ *
+ * // 16位银行卡，"-"间隔
+ * formatBankCard('6228480402564890', {char: '-'});
+ * // => 6228-4804-0256-4890
+ *
+ */
+declare function formatBankCard(bankCardNo?: string, { char, length }?: {
+    char?: string | undefined;
+    length?: number | undefined;
+} | undefined): string;

package/types/src/formatMobile.d.ts

@@ -0,0 +1,27 @@
+export default formatMobile;
+/**
+ * 格式化手机号码
+ *
+ * @static
+ * @alias module:Processor.formatMobile
+ * @since 4.5.0
+ * @param {string} mobileNo 手机号码
+ * @param {object} [options] 配置项
+ * @param {string} [options.char=' '] 间隔字符
+ * @returns {string} 格式化后的手机号码
+ * @example
+ * formatMobile('13345678900') // '133 4567 8900'
+ * formatMobile('13345678900', { char: '-' }) // '133-4567-8900'
+ *
+ * // 脱敏手机号码
+ * formatMobile('133****1234') // '133 **** 1234'
+ * formatMobile('133****1234', { char: '-' }) // '133-****-1234'
+ *
+ * // 手机号码位数不够
+ * formatMobile('133') // '133'
+ * formatMobile('133456') // '133 456'
+ * formatMobile('13345678') // '133 4567 8'
+ */
+declare function formatMobile(mobileNo: string, { char }?: {
+    char?: string | undefined;
+} | undefined): string;