util-helpers 4.15.3 → 4.16.1

package/lib/safeDate.js

@@ -4,21 +4,42 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = void 0;
-var _isNil = _interopRequireDefault(require("./utils/type/isNil"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct.bind(); } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
-// TODO: 函数重载，类型参照 Date
+/**
+ * @overload
+ * @return {Date}
+ */
+
+/**
+ * @overload
+ * @param {number | string | Date} value Unix时间戳、时间戳字符串 dateString 、Date 日期对象
+ * @return {Date}
+ */
+
+/**
+ * @overload
+ * @param {number} year 表示年份的整数值。0 到 99 会被映射至 1900 年至 1999 年，其他值代表实际年份。
+ * @param {number} monthIndex 表示月份的整数值，从 0（1 月）到 11（12 月）。
+ * @param {number} [date] 表示一个月中的第几天的整数值，从 1 开始。默认值为 1。
+ * @param {number} [hours] 表示一天中的小时数的整数值 (24 小时制)。默认值为 0（午夜）。
+ * @param {number} [minutes] 表示一个完整时间（如 01:10:00）中的分钟部分的整数值。默认值为 0。
+ * @param {number} [seconds] 表示一个完整时间（如 01:10:00）中的秒部分的整数值。默认值为 0。
+ * @param {number} [ms] 表示一个完整时间的毫秒部分的整数值。默认值为 0。
+ * @return {Date}
+ */
 
 /**
- * 创建一个 Date 实例日期对象，同 new Date() 。<br/>
- * 规避了苹果设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ * 创建一个 Date 实例日期对象，同 <a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date#%E5%8F%82%E6%95%B0">new Date()</a> <br/><br/>
+ * 
+ * 规避了苹果设备浏览器不支持部分格式（例如，YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。<br/>
+ * 如果参数为 undefined 正常返回 Date 。
  *
  * @static
  * @alias module:Processor.safeDate
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
  * @since 4.4.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
  * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
  * @param {...number} args 月/日/时/分/秒/毫秒
  * @returns {Date} Date 实例日期对象
@@ -30,8 +51,6 @@ function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Objec
  * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
  * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
  * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
- * 
- *
  */
 function safeDate(value) {
   var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
@@ -42,9 +61,7 @@ function safeDate(value) {
     // @ts-ignore
     return _construct(Date, [safeValue].concat(args));
   }
-
-  // @ts-ignore
-  return (0, _isNil["default"])(safeValue) ? new Date() : new Date(safeValue);
+  return typeof safeValue === 'undefined' ? new Date() : new Date(safeValue);
 }
 var _default = safeDate;
 exports["default"] = _default;

package/lib/setDataURLPrefix.js

@@ -10,9 +10,9 @@ exports["default"] = void 0;
  *
  * @static
  * @alias module:Processor.setDataURLPrefix
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
- * @see 参考 {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
  * @since 4.1.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
+ * @see {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
  * @param {string} data 数据本身
  * @param {string} [mimetype="image/png"] MIME 类型
  * @param {boolean} [base64=true] 添加 base64 标识

package/lib/transformFieldNames.js

@@ -24,7 +24,7 @@ function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input ==
  * @param {F} fieldNames 字段名映射
  * @param {C} [childrenField] 子级数据字段名
  * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
- * @returns {import('./transformFieldNames.type.js').TransformFieldNames<D, F, C>}
+ * @returns {import('./interface.type.js').TransformFieldNames<D, F, C>}
  * @example
  * 
  * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];

package/lib/utils/config.js

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

package/lib/utils/type/index.js

@@ -15,6 +15,18 @@ Object.defineProperty(exports, "isArray", {
     return _isArray["default"];
   }
 });
+Object.defineProperty(exports, "isArrayBuffer", {
+  enumerable: true,
+  get: function get() {
+    return _isArrayBuffer["default"];
+  }
+});
+Object.defineProperty(exports, "isBlob", {
+  enumerable: true,
+  get: function get() {
+    return _isBlob["default"];
+  }
+});
 Object.defineProperty(exports, "isBoolean", {
   enumerable: true,
   get: function get() {
@@ -113,6 +125,8 @@ Object.defineProperty(exports, "isWeakSet", {
 });
 var _isArguments = _interopRequireDefault(require("./isArguments"));
 var _isArray = _interopRequireDefault(require("./isArray"));
+var _isArrayBuffer = _interopRequireDefault(require("./isArrayBuffer"));
+var _isBlob = _interopRequireDefault(require("./isBlob"));
 var _isBoolean = _interopRequireDefault(require("./isBoolean"));
 var _isDate = _interopRequireDefault(require("./isDate"));
 var _isError = _interopRequireDefault(require("./isError"));

package/lib/utils/type/isArrayBuffer.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _isType = _interopRequireDefault(require("./isType"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+/**
+ * 检查值是否为ArrayBuffer对象
+ *
+ * @static
+ * @alias module:Type.isArrayBuffer
+ * @since 4.16.0
+ * @param {*} value 检查值
+ * @returns {boolean} 是否为ArrayBuffer对象
+ * @example
+ *
+ * isArrayBuffer(new ArrayBuffer(8))
+ * // => true
+ *
+ * isArrayBuffer({})
+ * // => false
+ *
+ * isArrayBuffer('2012')
+ * // => false
+ */
+function isArrayBuffer(value) {
+  return (0, _isType["default"])(value, 'ArrayBuffer');
+}
+var _default = isArrayBuffer;
+exports["default"] = _default;

package/lib/utils/type/isBlob.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _isType = _interopRequireDefault(require("./isType"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+/**
+ * 检查值是否为Blob对象<br/><br/>
+ * 
+ * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+ *
+ * @static
+ * @alias module:Type.isBlob
+ * @since 4.16.0
+ * @param {*} value 检查值
+ * @returns {boolean} 是否为Blob对象
+ * @example
+ *
+ * isBlob(new Blob(['a']))
+ * // => true
+ *
+ * isBlob({})
+ * // => false
+ *
+ * isBlob('2012')
+ * // => false
+ */
+function isBlob(value) {
+  return (0, _isType["default"])(value, 'Blob');
+}
+var _default = isBlob;
+exports["default"] = _default;

package/lib/validatePassword.js

@@ -136,10 +136,10 @@ function hasUnallowableCharacter(val, chars) {
 /**
  * 验证密码（数字、大小写字母、特殊字符、非法字符）
  *
- * @see 参考 {@link https://baike.baidu.com/item/ASCII#3|ASCII}
  * @static
  * @alias module:Validator.validatePassword
  * @since 3.7.0
+ * @see {@link https://baike.baidu.com/item/ASCII#3|ASCII}
  * @param {string} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {number} [options.level=2] 密码强度 1-包含一种字符 2-包含两种字符 3-包含三种字符。（大写字母、小写字母、数字、特殊字符）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.15.3",
+  "version": "4.16.1",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -84,7 +84,7 @@
     "prettier": "^2.3.2",
     "rollup": "^2.49.0",
     "rollup-plugin-terser": "^7.0.2",
-    "typescript": "^4.9.3"
+    "typescript": "^5.0.4"
   },
   "lint-staged": {
     "**/*.js": "npm run lint-staged:js",

package/types/ajax.d.ts

@@ -0,0 +1,121 @@
+export default ajax;
+/**
+ * XMLHttpRequest 事件对象
+ */
+export type XMLHttpRequestEvent = XMLHttpRequest['onloadstart'];
+/**
+ * ajax配置项
+ */
+export type AjaxOptions = {
+    /**
+     * 创建请求时使用的方法
+     */
+    method?: string | undefined;
+    /**
+     * 请求体被发送的数据
+     */
+    data?: Document | XMLHttpRequestBodyInit | null | undefined;
+    /**
+     * 自定义请求头
+     */
+    headers?: {
+        [x: string]: string;
+    } | undefined;
+    /**
+     * 响应类型
+     */
+    responseType?: XMLHttpRequestResponseType | undefined;
+    /**
+     * 请求超时的毫秒数
+     */
+    timeout?: number | undefined;
+    /**
+     * 跨域请求时是否需要使用凭证
+     */
+    withCredentials?: boolean | undefined;
+    /**
+     * 是否异步执行操作
+     */
+    async?: boolean | undefined;
+    /**
+     * 用户名，用于认证用途
+     */
+    user?: string | null | undefined;
+    /**
+     * 密码，用于认证用途
+     */
+    password?: string | null | undefined;
+    /**
+     * 接收到响应数据时触发
+     */
+    onLoadStart?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 请求接收到更多数据时，周期性地触发
+     */
+    onProgress?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 当 request 被停止时触发，例如当程序调用 XMLHttpRequest.abort() 时
+     */
+    onAbort?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 在预设时间内没有接收到响应时触发
+     */
+    onTimeout?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 当 request 遭遇错误时触发
+     */
+    onError?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 请求成功完成时触发
+     */
+    onLoad?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+    /**
+     * 请求结束时触发，无论请求成功 (load) 还是失败 (abort 或 error)
+     */
+    onLoadEnd?: ((this: XMLHttpRequest, ev: ProgressEvent<EventTarget>) => any) | null | undefined;
+};
+/**
+ * @typedef {XMLHttpRequest['onloadstart']} XMLHttpRequestEvent XMLHttpRequest 事件对象
+ */
+/**
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
+ * @typedef {Object} AjaxOptions ajax配置项
+ * @property {string} [method="get"] 创建请求时使用的方法
+ * @property {Document | XMLHttpRequestBodyInit | null} [data=null] 请求体被发送的数据
+ * @property {Object.<string, string>} [headers] 自定义请求头
+ * @property {XMLHttpRequestResponseType} [responseType] 响应类型
+ * @property {number} [timeout] 请求超时的毫秒数
+ * @property {boolean} [withCredentials=false] 跨域请求时是否需要使用凭证
+ * @property {boolean} [async=true] 是否异步执行操作
+ * @property {string|null} [user=null] 用户名，用于认证用途
+ * @property {string|null} [password=null] 密码，用于认证用途
+ * @property {XMLHttpRequestEvent} [onLoadStart] 接收到响应数据时触发
+ * @property {XMLHttpRequestEvent} [onProgress] 请求接收到更多数据时，周期性地触发
+ * @property {XMLHttpRequestEvent} [onAbort] 当 request 被停止时触发，例如当程序调用 XMLHttpRequest.abort() 时
+ * @property {XMLHttpRequestEvent} [onTimeout] 在预设时间内没有接收到响应时触发
+ * @property {XMLHttpRequestEvent} [onError] 当 request 遭遇错误时触发
+ * @property {XMLHttpRequestEvent} [onLoad] 请求成功完成时触发
+ * @property {XMLHttpRequestEvent} [onLoadEnd] 请求结束时触发，无论请求成功 (load) 还是失败 (abort 或 error)
+ */
+/**
+ * 请求<br/><br/>
+ *
+ * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+ *
+ * @static
+ * @alias module:Other.ajax
+ * @since 4.16.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
+ * @param {string} url 地址
+ * @param {AjaxOptions} [options] 配置项
+ * @returns {Promise<ProgressEvent<EventTarget>>}
+ * @example
+ * ajax('/somefile').then(res=>{
+ *   // do something
+ * });
+ *
+ * ajax('/api', { method: 'post' }).then(res=>{
+ *   // do something
+ * });
+ */
+declare function ajax(url: string, options?: AjaxOptions | undefined): Promise<ProgressEvent<EventTarget>>;

package/types/blobToDataURL.d.ts

@@ -1,11 +1,15 @@
 export default blobToDataURL;
 /**
- * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串。
+ * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串<br/><br/>
  *
+ * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+ *
+ * @ignore
  * @static
  * @alias module:Processor.blobToDataURL
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
  * @since 4.1.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
+ * @deprecated 请使用 `fileReader` 方法
  * @param {Blob} blob Blob 或 File 对象
  * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
  * @example

package/types/calculateCursorPosition.d.ts

@@ -5,8 +5,8 @@ export default calculateCursorPosition;
  * @static
  * @alias module:Other.calculateCursorPosition
  * @since 4.6.0
- * @see h5示例 {@link https://2950v9.csb.app/|点击查看}
- * @see react示例 {@link https://33ccy9.csb.app/|点击查看}
+ * @see {@link https://2950v9.csb.app/|h5示例}
+ * @see {@link https://33ccy9.csb.app/|react示例}
  * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
  * @param {string} prevCtrlValue 上一个格式化后的值
  * @param {string} rawValue 当前输入原值

package/types/dataURLToBlob.d.ts

@@ -4,8 +4,8 @@ export default dataURLToBlob;
  *
  * @static
  * @alias module:Processor.dataURLToBlob
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
  * @since 4.1.0
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
  * @param {string} dataurl data: 协议的URL
  * @returns {Blob} Blob 对象
  * @example

package/types/download.d.ts

@@ -0,0 +1,78 @@
+export default download;
+/**
+ * ajax 配置项
+ */
+export type AjaxOptions = import('./ajax.js').AjaxOptions;
+export type TransformRequest = (options: AjaxOptions) => AjaxOptions | Promise<AjaxOptions>;
+export type TransformResponse = (res: Blob) => Blob | Promise<Blob>;
+/**
+ * 下载配置项
+ */
+export type DownloadOptions = {
+    /**
+     * 文件名称
+     */
+    fileName?: string | undefined;
+    /**
+     * MIME 类型
+     */
+    type?: string | undefined;
+    /**
+     * 手动设置数据类型，默认会根据传入的数据判断类型，主要是为了区分 url 和 text 。<br/>如果你要下载的文本是 url ，请设置 'text' ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
+     */
+    dataType?: "text" | "url" | undefined;
+    /**
+     * 请求前触发，XHR 对象或配置调整
+     */
+    transformRequest?: TransformRequest | undefined;
+    /**
+     * 请求成功后触发，在传递给 then/catch 前，允许修改响应数据
+     */
+    transformResponse?: TransformResponse | undefined;
+};
+/**
+ * @typedef {import('./ajax.js').AjaxOptions} AjaxOptions ajax 配置项
+ */
+/**
+ * @callback TransformRequest
+ * @param {AjaxOptions} options ajax 配置项
+ * @returns {AjaxOptions | Promise<AjaxOptions>}
+ */
+/**
+ * @callback TransformResponse
+ * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
+ * @returns {Blob | Promise<Blob>}
+ */
+/**
+ * @typedef {Object} DownloadOptions 下载配置项
+ * @property {string} [options.fileName] 文件名称
+ * @property {string} [options.type] MIME 类型
+ * @property {'url'|'text'} [options.dataType] 手动设置数据类型，默认会根据传入的数据判断类型，主要是为了区分 url 和 text 。<br/>如果你要下载的文本是 url ，请设置 'text' ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
+ * @property {TransformRequest} [options.transformRequest] 请求前触发，XHR 对象或配置调整
+ * @property {TransformResponse} [options.transformResponse] 请求成功后触发，在传递给 then/catch 前，允许修改响应数据
+ */
+/**
+ * 下载<br/><br/>
+ *
+ * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端，兼容 IE10+ 和现代浏览器。</em>
+ *
+ * @static
+ * @alias module:Other.download
+ * @since 4.16.0
+ * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展|MIME}
+ * @see {@link https://9ykc9s.csb.app/|在线示例}
+ * @param {string|Blob|ArrayBuffer|Int8Array|Uint8Array|Uint8ClampedArray|Int16Array|Uint16Array|Int32Array|Uint32Array|Float32Array|Float64Array|BigInt64Array|BigUint64Array} data 字符串、blob数据或url地址
+ * @param {string|DownloadOptions} [options] 文件名称 或 配置项
+ * @returns {Promise<void>}
+ * @example
+ * // 文本
+ * download('hello world', 'text.txt');
+ *
+ * // 远程文件
+ * download('/xxx.jpg', { dataType: 'url' });
+ *
+ * // blob文件
+ * download(new Blob(['hello world']), 'text.txt');
+ *
+ */
+declare function download(data: string | Blob | ArrayBuffer | Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array, options?: string | DownloadOptions | undefined): Promise<void>;

package/types/fileReader.d.ts

@@ -0,0 +1,3 @@
+export default fileReader;
+declare function fileReader(blob: Blob, type: 'arrayBuffer'): Promise<ArrayBuffer>;
+declare function fileReader(blob: Blob, type?: "text" | "binaryString" | "dataURL" | undefined): Promise<string>;

package/types/index.d.ts

@@ -27,6 +27,7 @@ export { default as numberToChinese } from "./numberToChinese";
 export { default as bytesToSize } from "./bytesToSize";
 export { default as parseIdCard } from "./parseIdCard";
 export { default as blobToDataURL } from "./blobToDataURL";
+export { default as fileReader } from "./fileReader";
 export { default as dataURLToBlob } from "./dataURLToBlob";
 export { default as setDataURLPrefix } from "./setDataURLPrefix";
 export { default as normalizeString } from "./normalizeString";
@@ -38,10 +39,12 @@ export { default as minus } from "./minus";
 export { default as times } from "./times";
 export { default as divide } from "./divide";
 export { default as round } from "./round";
-export { default as waitTime } from "./waitTime";
+export { default as ajax } from "./ajax";
 export { default as calculateCursorPosition } from "./calculateCursorPosition";
+export { default as download } from "./download";
 export { default as randomString } from "./randomString";
 export { default as strlen } from "./strlen";
+export { default as waitTime } from "./waitTime";
 export { default as transformFieldNames } from "./transformFieldNames";
 export { default as listToTree } from "./listToTree";
 export { default as treeToList } from "./treeToList";

package/types/isBankCard.d.ts

@@ -4,8 +4,8 @@ export default isBankCard;
  *
  * @static
  * @alias module:Validator.isBankCard
- * @see 参考 {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html|常用银行账号位数参考}
  * @since 1.1.0
+ * @see {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html|常用银行账号位数参考}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.loose=false] 宽松模式，8~30位数字

package/types/isBusinessLicense.d.ts

@@ -4,8 +4,8 @@ export default isBusinessLicense;
  *
  * @static
  * @alias module:Validator.isBusinessLicense
- * @see 参考 {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html|GS15—2006 工商行政管理市场主体注册号编制规则}
  * @since 3.5.0
+ * @see {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html|GS15—2006 工商行政管理市场主体注册号编制规则}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。

package/types/isChinese.d.ts

@@ -5,9 +5,9 @@ export default isChinese;
  * @static
  * @alias module:Validator.isChinese
  * @since 1.1.0
- * @see 参考 {@link http://www.unicode.org/reports/tr38/#BlockListing|4.4 Listing of Characters Covered by the Unihan Database}
- * @see 参考 {@link https://zh.wikipedia.org/wiki/Unicode字符平面映射|Unicode字符平面映射}
- * @see 参考 {@link https://zh.wikipedia.org/wiki/Unicode區段|Unicode区段}
+ * @see {@link http://www.unicode.org/reports/tr38/#BlockListing|4.4 Listing of Characters Covered by the Unihan Database}
+ * @see {@link https://zh.wikipedia.org/wiki/Unicode字符平面映射|Unicode字符平面映射}
+ * @see {@link https://zh.wikipedia.org/wiki/Unicode區段|Unicode区段}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.loose=false] 宽松模式。如果为true，只要包含中文即为true

package/types/isHMCard.d.ts

@@ -5,7 +5,7 @@ export default isHMCard;
  * @static
  * @alias module:Validator.isHMCard
  * @since 4.0.0
- * @see 参考 {@link https://zh.wikipedia.org/wiki/港澳居民来往内地通行证|港澳居民来往内地通行证}
+ * @see {@link https://zh.wikipedia.org/wiki/港澳居民来往内地通行证|港澳居民来往内地通行证}
  * @param {*} value 要检测的值
  * @returns {boolean} 是否为港澳居民来往内地通行证
  * @example

package/types/isIdCard.d.ts

@@ -5,8 +5,8 @@ export default isIdCard;
  * @static
  * @alias module:Validator.isIdCard
  * @since 1.1.0
- * @see 参考 {@link https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码|中华人民共和国公民身份号码}
- * @see 参考 {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
+ * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码|中华人民共和国公民身份号码}
+ * @see {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.loose=false] 宽松模式，支持15位身份证号码

package/types/isPassport.d.ts

@@ -5,8 +5,8 @@ export default isPassport;
  *
  * @static
  * @alias module:Validator.isPassport
- * @see 参考 {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页|中华人民共和国护照#个人资料页}
  * @since 1.1.0
+ * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页|中华人民共和国护照#个人资料页}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为护照号
  * @example

package/types/isPassword.d.ts

@@ -4,11 +4,11 @@ export default isPassword;
  * <p><strong>注意：该校验只校验是否存在不同字符(大小写字母、数字、特殊符号)，不判断长度。</strong></p>
  * <p><i>如果需要更细致的验证，请使用 <a href="#.validatePassword">validatePassword</a></i></p>
  *
- * @see 参考 {@link https://baike.baidu.com/item/ASCII#3|ASCII}
  * @static
  * @alias module:Validator.isPassword
- * @since 1.1.0
  * @requires module:Validator.validatePassword
+ * @since 1.1.0
+ * @see {@link https://baike.baidu.com/item/ASCII#3|ASCII}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {number} [options.level=2] 密码强度 1-包含一种字符 2-包含两种字符 3-包含三种字符。（大写字母、小写字母、数字、特殊字符）

package/types/isSocialCreditCode.d.ts

@@ -4,8 +4,8 @@ export default isSocialCreditCode;
  *
  * @static
  * @alias module:Validator.isSocialCreditCode
- * @see 参考 {@link https://zh.wikisource.org/zh-hans/GB_32100-2015_法人和其他组织统一社会信用代码编码规则|GB 32100-2015 法人和其他组织统一社会信用代码编码规则}
  * @since 1.1.0
+ * @see {@link https://zh.wikisource.org/zh-hans/GB_32100-2015_法人和其他组织统一社会信用代码编码规则|GB 32100-2015 法人和其他组织统一社会信用代码编码规则}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。

package/types/isSwiftCode.d.ts

@@ -4,8 +4,8 @@ export default isSwiftCode;
  *
  * @static
  * @alias module:Validator.isSwiftCode
- * @see 参考 {@link https://zh.wikipedia.org/wiki/ISO_9362|ISO 9362}
  * @since 4.9.0
+ * @see {@link https://zh.wikipedia.org/wiki/ISO_9362|ISO 9362}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为 Swift Code
  * @example

package/types/isTWCard.d.ts

@@ -5,7 +5,7 @@ export default isTWCard;
  * @static
  * @alias module:Validator.isTWCard
  * @since 4.0.0
- * @see 参考 {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
+ * @see {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证

package/types/isUrl.d.ts

@@ -5,7 +5,7 @@ export default isUrl;
  * @static
  * @alias module:Validator.isUrl
  * @since 3.4.0
- * @see 参考 {@link https://zh.wikipedia.org/wiki/统一资源定位符|统一资源定位符}
+ * @see {@link https://zh.wikipedia.org/wiki/统一资源定位符|统一资源定位符}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为url
  * @example

package/types/isVehicle.d.ts

@@ -4,8 +4,8 @@ export default isVehicle;
  *
  * @static
  * @alias module:Validator.isVehicle
- * @see 参考 {@link https://baike.baidu.com/item/车牌号|车牌号}
  * @since 1.1.0
+ * @see {@link https://baike.baidu.com/item/车牌号|车牌号}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为车牌号
  * @example

package/types/normalizeString.d.ts

@@ -4,8 +4,8 @@ export default normalizeString;
  *
  * @static
  * @alias module:Processor.normalizeString
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @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