util-helpers 4.22.2 → 4.23.1

package/lib/loadImageWithBlob.js

@@ -2,42 +2,40 @@
 
 var native = require('./utils/native.js');
 var getFileBlob = require('./getFileBlob.js');
-var Cache = require('./utils/Cache.js');
+var AsyncMemo = require('./AsyncMemo.js');
+var ut2 = require('ut2');
 
-var cache = new Cache({ max: 1 });
-cache.on('del', function (v) {
-    if (v.r) {
-        try {
+var asyncMemo = new AsyncMemo({ max: 1, maxStrategy: 'replaced' });
+asyncMemo.cache.on('del', function (k, v) {
+    try {
+        if (v.r) {
             native.revokeObjectURL(v.data.image.src);
         }
-        catch (_a) {
-        }
+    }
+    catch (_a) {
     }
 });
 function loadImageWithBlob(img, cacheOptions, ajaxOptions) {
     if (cacheOptions === void 0) { cacheOptions = true; }
+    var cacheOptionsIsObject = typeof cacheOptions === 'object';
     var _cacheOptions = {
-        useCache: typeof cacheOptions === 'object' ? cacheOptions.useCache !== false : cacheOptions !== false,
-        autoRevokeOnDel: typeof cacheOptions === 'object' ? cacheOptions.autoRevokeOnDel !== false : !!cacheOptions
+        useCache: cacheOptionsIsObject ? cacheOptions.useCache !== false : cacheOptions !== false,
+        autoRevokeOnDel: cacheOptionsIsObject ? cacheOptions.autoRevokeOnDel !== false : !!cacheOptions,
+        cacheKey: ut2.defaultTo(cacheOptionsIsObject ? cacheOptions.cacheKey : undefined, typeof img === 'string' ? img : undefined)
     };
-    return new Promise(function (resolve, reject) {
-        if (_cacheOptions.useCache && cache.has(img)) {
-            resolve(cache.get(img).data);
-        }
-        else {
+    return asyncMemo
+        .run(function () {
+        return new Promise(function (resolve, reject) {
             getFileBlob(img, ajaxOptions)
                 .then(function (blob) {
                 var url = native.createObjectURL(blob);
                 var image = new Image();
                 image.onload = function () {
-                    var result = { blob: blob, image: image };
-                    if (_cacheOptions.useCache) {
-                        cache.set(img, {
-                            data: result,
-                            r: _cacheOptions.autoRevokeOnDel
-                        });
-                    }
-                    resolve(result);
+                    var data = { blob: blob, image: image };
+                    resolve({
+                        data: data,
+                        r: _cacheOptions.autoRevokeOnDel
+                    });
                 };
                 image.onerror = function (err) {
                     native.revokeObjectURL(url);
@@ -47,8 +45,9 @@ function loadImageWithBlob(img, cacheOptions, ajaxOptions) {
                 image.src = url;
             })
                 .catch(reject);
-        }
-    });
+        });
+    }, _cacheOptions.useCache && _cacheOptions.cacheKey ? _cacheOptions.cacheKey : undefined)
+        .then(function (res) { return res.data; });
 }
 
 module.exports = loadImageWithBlob;

package/lib/randomString.js

@@ -2,21 +2,35 @@
 
 var ut2 = require('ut2');
 
-var numberChars = '0123456789';
-var letterChars = 'abcdefghijklmnopqrstuvwxyz';
-var defaultChars = numberChars + letterChars + letterChars.toUpperCase();
-function internalRandomString(len, optionalChars, prefix) {
+var letter = 'abcdefghijklmnopqrstuvwxyz';
+var chars = {
+    number: '0123456789',
+    lower: letter,
+    upper: letter.toUpperCase()
+};
+var allChars = chars.number + chars.lower + chars.upper;
+function internalRandomString(len, pool, prefix) {
     if (prefix === void 0) { prefix = ''; }
     while (len-- > 0) {
-        var r = optionalChars[Math.floor(Math.random() * optionalChars.length)];
-        return internalRandomString(len, optionalChars, prefix + r);
+        var r = pool[ut2.randomInt(0, pool.length - 1)];
+        return internalRandomString(len, pool, prefix + r);
     }
     return prefix;
 }
-function randomString(len, optionalChars) {
+var randomString = function (len, pool) {
     if (len === void 0) { len = 0; }
-    var realChars = typeof optionalChars === 'string' && optionalChars ? optionalChars : defaultChars;
-    return internalRandomString(ut2.toNumber(len), realChars);
-}
+    var _pool;
+    if (typeof pool !== 'string') {
+        _pool = allChars;
+    }
+    else if (chars[pool]) {
+        _pool = chars[pool];
+    }
+    else {
+        _pool = pool;
+    }
+    return internalRandomString(ut2.toNumber(len), _pool);
+};
+var randomString$1 = randomString;
 
-module.exports = randomString;
+module.exports = randomString$1;

package/lib/transformObjectValue.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var ut2 = require('ut2');
+
+var transformObjectValue = function (data, fn, deep) {
+    if (deep === void 0) { deep = true; }
+    if (ut2.isPlainObject(data)) {
+        var result_1 = {};
+        ut2.forEach(data, function (value, key) {
+            var newValue = deep && (ut2.isPlainObject(value) || ut2.isArray(value)) ? transformObjectValue(value, fn) : fn(value, key);
+            result_1[key] = newValue;
+        });
+        return result_1;
+    }
+    else if (ut2.isArray(data)) {
+        var result_2 = [];
+        ut2.forEach(data, function (value, index) {
+            var newValue = deep && (ut2.isPlainObject(value) || ut2.isArray(value)) ? transformObjectValue(value, fn) : fn(value, index);
+            result_2.push(newValue);
+        });
+        return result_2;
+    }
+    return data;
+};
+var transformObjectValue$1 = transformObjectValue;
+
+module.exports = transformObjectValue$1;

package/lib/validatePassword.js

@@ -2,19 +2,10 @@
 
 var devWarn = require('./utils/devWarn.js');
 
-var regNumber = /[\d]/;
+var regNumber = /\d/;
 var regLowerCaseLetter = /[a-z]/;
 var regUpperCaseLetter = /[A-Z]/;
 var regAllNumberAndLetter = /[\d|a-z]/gi;
-function hasNumber(val) {
-    return regNumber.test(val);
-}
-function hasLowerCaseLetter(val) {
-    return regLowerCaseLetter.test(val);
-}
-function hasUpperCaseLetter(val) {
-    return regUpperCaseLetter.test(val);
-}
 function hasHex(val) {
     return val.indexOf('\\x') > -1 || val.indexOf('\\u') > -1;
 }
@@ -72,9 +63,9 @@ function validatePassword(value, options) {
         valStr = '';
     }
     var currentLevel = 0;
-    var containesNumber = hasNumber(valStr);
-    var containesLowerCaseLetter = hasLowerCaseLetter(valStr);
-    var containesUpperCaseLetter = hasUpperCaseLetter(valStr);
+    var containesNumber = regNumber.test(valStr);
+    var containesLowerCaseLetter = regLowerCaseLetter.test(valStr);
+    var containesUpperCaseLetter = regUpperCaseLetter.test(valStr);
     var containesSpecialCharacter = hasSpecialCharacter(valStr, special);
     var containesUnallowableCharacter = hasUnallowableCharacter(valStr, special);
     if (containesNumber) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.22.2",
+  "version": "4.23.1",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -51,20 +51,20 @@
   },
   "homepage": "https://doly-dev.github.io/util-helpers/index.html",
   "devDependencies": {
-    "@babel/core": "^7.24.5",
-    "@babel/preset-env": "^7.24.5",
-    "@babel/preset-typescript": "^7.24.1",
+    "@babel/core": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "@babel/preset-typescript": "^7.24.7",
     "@commitlint/cli": "^17.8.1",
     "@commitlint/config-conventional": "^17.8.1",
     "@commitlint/cz-commitlint": "^17.8.1",
-    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-commonjs": "^25.0.8",
     "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-replace": "^5.0.5",
+    "@rollup/plugin-replace": "^5.0.7",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.6",
     "@types/jest": "^29.5.12",
-    "@typescript-eslint/eslint-plugin": "^7.9.0",
-    "@typescript-eslint/parser": "^7.9.0",
+    "@typescript-eslint/eslint-plugin": "^7.13.0",
+    "@typescript-eslint/parser": "^7.13.0",
     "babel-jest": "^29.7.0",
     "babel-plugin-minify-replace": "^0.5.0",
     "commitizen": "^4.3.0",
@@ -78,8 +78,8 @@
     "jest-environment-jsdom": "^29.7.0",
     "jsdoc": "^4.0.3",
     "lint-staged": "^13.3.0",
-    "prettier": "^3.2.5",
-    "rollup": "^4.17.2",
+    "prettier": "^3.3.2",
+    "rollup": "^4.18.0",
     "typescript": "^5.4.5"
   },
   "lint-staged": {
@@ -94,7 +94,7 @@
   "dependencies": {
     "cache2": "^2.0.5",
     "emitter-pro": "^1.2.1",
-    "tslib": "^2.6.2",
+    "tslib": "^2.6.3",
     "ut2": "^1.9.1"
   },
   "publishConfig": {

package/types/AsyncMemo.d.ts

@@ -2,11 +2,25 @@ import { Cache, CacheOptions } from 'cache2';
 /**
  * 异步缓存
  *
+ * 特点：
+ * 1. 共享异步。同一个缓存键的异步，最多同时运行一个异步，异步结果共享。
+ * 2. 持久化数据。存在缓存结果，不再执行异步方法，直接返回该结果。
+ * 3. 每个实例都有独立的缓存空间。相互之间隔离，缓存灵活配置，更多配置请查阅 [`cache2`](https://www.npmjs.com/package/cache2)。
+ *
  * @class
- * @see {@link https://www.npmjs.com/package/cache2 | cache2}
+ * @see {@link https://www.npmjs.com/package/cache2 cache2}
  * @param {Object} [options] 缓存配置项，更多配置项可参考 [`cache2`](https://www.npmjs.com/package/cache2)
  * @param {number} [options.max] 最大缓存数量
  * @param {'replaced' | 'limited'} [options.maxStrategy] 缓存策略
+ * @example
+ *
+ * const asyncMemo = new AsyncMemo({ max: 20, maxStrategy: 'replaced' });
+ * asyncMemo.run(()=>download({ fssid: 'a' }), 'a');
+ * asyncMemo.run(()=>download({ fssid: 'b' }), 'b');
+ * asyncMemo.run(()=>download({ fssid: 'a' }), 'a'); // 如果有缓存结果直接返回，如果有异步执行中，不会重复触发异步，但共享异步结果。
+ *
+ * asyncMemo.run(()=>download({ fssid: 'a' }), 'a', { persisted: false }); // 不读取缓存结果，但是异步执行结果还是会缓存。
+ * asyncMemo.run(()=>download({ fssid: 'a' })); // 没有缓存键时，直接执行异步方法，不读取缓存结果，也不会缓存异步结果。
  */
 declare class AsyncMemo<DataType = any> {
     private promiseCache;
@@ -28,6 +42,6 @@ declare class AsyncMemo<DataType = any> {
     run(asyncFn: (...args: any[]) => Promise<DataType>, key?: string, options?: {
         ttl?: number;
         persisted?: boolean;
-    }): Promise<any>;
+    }): Promise<DataType>;
 }
 export default AsyncMemo;

package/types/ajax.d.ts

@@ -19,7 +19,7 @@ type AjaxOptions = {
     onLoadEnd?: XMLHttpRequestListener;
 };
 /**
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest | XMLHttpRequest}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest XMLHttpRequest}
  * @typedef {Object} AjaxOptions ajax 配置项
  * @property {string} [method="get"] 创建请求时使用的方法
  * @property {boolean} [async=true] 是否异步执行操作
@@ -47,7 +47,7 @@ type AjaxOptions = {
  * @static
  * @alias module:Other.ajax
  * @since 4.16.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest | XMLHttpRequest}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest XMLHttpRequest}
  * @param {string} url 地址
  * @param {AjaxOptions} [options] 配置项
  * @returns {Promise<object>} XHR 事件对象

package/types/blobToDataURL.d.ts

@@ -7,7 +7,7 @@
  * @static
  * @alias module:Processor.blobToDataURL
  * @since 4.1.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL | FileReader.readAsDataURL()}
+ * @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 字符串。

package/types/calculateCursorPosition.d.ts

@@ -9,8 +9,8 @@ type CalculateCursorPositionOptions = {
  * @static
  * @alias module:Other.calculateCursorPosition
  * @since 4.6.0
- * @see {@link https://2950v9.csb.app/ | h5示例}
- * @see {@link https://33ccy9.csb.app/ | react示例}
+ * @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/compressImage.d.ts

@@ -38,7 +38,7 @@ interface CompressImage {
  * @function
  * @alias module:Other.compressImage
  * @since 4.20.0
- * @see {@link https://sytpwg.csb.app/ | 在线示例}
+ * @see {@link https://sytpwg.csb.app/ 在线示例}
  * @param {string | Blob} img 图片地址或 blob 对象
  * @param {Object} [options] 配置项
  * @param {number} [options.width] 自定义图片宽度，默认图片自身宽度

package/types/dataURLToBlob.d.ts

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

package/types/download.d.ts

@@ -38,9 +38,9 @@ type DownloadOptions = {
  * @static
  * @alias module:Other.download
  * @since 4.16.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers | Access-Control-Expose-Headers}
- * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展 | MIME}
- * @see {@link https://9ykc9s.csb.app/ | 在线示例}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Access-Control-Expose-Headers Access-Control-Expose-Headers}
+ * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展 MIME}
+ * @see {@link https://9ykc9s.csb.app/ 在线示例}
  * @param {string|Blob|ArrayBuffer|TypedArray} data 字符串、blob数据或url地址
  * @param {string|DownloadOptions} [options] 文件名称 或 配置项
  * @returns {Promise<void>}

package/types/fileReader.d.ts

@@ -16,7 +16,7 @@ interface FileReader {
  *
  * @function
  * @alias module:Processor.fileReader
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader | FileReader}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader FileReader}
  * @since 4.16.0
  * @param {Blob} blob Blob 或 File 对象
  * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] 读取类型

package/types/gcd.d.ts

@@ -12,7 +12,7 @@
  * @static
  * @alias module:Math.gcd
  * @since 4.20.0
- * @see {@link https://baike.baidu.com/item/最大公约数 | 最大公约数}
+ * @see {@link https://baike.baidu.com/item/最大公约数 最大公约数}
  * @param {...(number|string)} nums 两个或多个整数。
  * @returns {number} 最大公约数。
  * @example

package/types/getImageInfo.d.ts

@@ -1,4 +1,14 @@
 import loadImageWithBlob from './loadImageWithBlob';
+type Result = {
+    width: number;
+    height: number;
+    contrast: string;
+    measure: string;
+    size: string;
+    bytes: number;
+    image: HTMLImageElement;
+    blob: Blob;
+};
 /**
  * @typedef {Object} ImageInfo 图片信息
  * @property {number} width 宽度
@@ -37,14 +47,5 @@ import loadImageWithBlob from './loadImageWithBlob';
  * });
  *
  */
-declare function getImageInfo(img: string | Blob, cacheOptions?: boolean | Parameters<typeof loadImageWithBlob>[1], ajaxOptions?: Parameters<typeof loadImageWithBlob>[2]): Promise<{
-    width: number;
-    height: number;
-    contrast: string;
-    measure: string;
-    size: string;
-    bytes: number;
-    image: HTMLImageElement;
-    blob: Blob;
-}>;
+declare function getImageInfo(img: string | Blob, cacheOptions?: boolean | Parameters<typeof loadImageWithBlob>[1], ajaxOptions?: Parameters<typeof loadImageWithBlob>[2]): Promise<Result>;
 export default getImageInfo;

package/types/index.d.ts

@@ -47,13 +47,14 @@ 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 transformObjectValue } from './transformObjectValue';
 /**
  * 数学计算，修正浮点数计算问题
  *
  * @module Math
  * @since 3.1.0
- * @see {@link https://github.com/camsong/blog/issues/9 | JavaScript 浮点数陷阱及解法}
- * @see {@link https://2zbuy.csb.app/ | JS浮点数计算测试}
+ * @see {@link https://github.com/camsong/blog/issues/9 JavaScript 浮点数陷阱及解法}
+ * @see {@link https://2zbuy.csb.app/ JS浮点数计算测试}
  * @example
  * // 从 4.12.0 版本开始，规范了有效数值。（注意：4.12.3 对有效数值重新定义）
  * // 有效数值即能通过 Number(value) 转为数字，且不能为 NaN 。

package/types/isBankCard.d.ts

@@ -8,7 +8,7 @@ type Options = {
  * @static
  * @alias module:Validator.isBankCard
  * @since 1.1.0
- * @see {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html | 常用银行账号位数参考}
+ * @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

@@ -9,7 +9,7 @@ type Options = {
  * @static
  * @alias module:Validator.isBusinessLicense
  * @since 3.5.0
- * @see {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html | GS15—2006 工商行政管理市场主体注册号编制规则}
+ * @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

@@ -8,9 +8,9 @@ type Options = {
  * @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

@@ -4,7 +4,7 @@
  * @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

@@ -10,8 +10,8 @@ type Options = {
  * @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,7 +5,7 @@
  * @static
  * @alias module:Validator.isPassport
  * @since 1.1.0
- * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页 | 中华人民共和国护照#个人资料页}
+ * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页 中华人民共和国护照#个人资料页}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为护照号
  * @example

package/types/isPassword.d.ts

@@ -8,7 +8,7 @@ import validatePassword from './validatePassword';
  * @alias module:Validator.isPassword
  * @requires module:Validator.validatePassword
  * @since 1.1.0
- * @see {@link https://baike.baidu.com/item/ASCII#3 | ASCII}
+ * @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

@@ -9,7 +9,7 @@ type Options = {
  * @static
  * @alias module:Validator.isSocialCreditCode
  * @since 1.1.0
- * @see {@link https://zh.wikisource.org/zh-hans/GB_32100-2015_法人和其他组织统一社会信用代码编码规则 | GB 32100-2015 法人和其他组织统一社会信用代码编码规则}
+ * @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,7 +4,7 @@
  * @static
  * @alias module:Validator.isSwiftCode
  * @since 4.9.0
- * @see {@link https://zh.wikipedia.org/wiki/ISO_9362 | ISO 9362}
+ * @see {@link https://zh.wikipedia.org/wiki/ISO_9362 ISO 9362}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为 Swift Code
  * @example

package/types/isTWCard.d.ts

@@ -7,7 +7,7 @@ type Options = {
  * @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

@@ -4,7 +4,7 @@
  * @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,7 +4,7 @@
  * @static
  * @alias module:Validator.isVehicle
  * @since 1.1.0
- * @see {@link https://baike.baidu.com/item/车牌号 | 车牌号}
+ * @see {@link https://baike.baidu.com/item/车牌号 车牌号}
  * @param {*} value 要检测的值
  * @returns {boolean} 值是否为车牌号
  * @example

package/types/lcm.d.ts

@@ -14,7 +14,7 @@
  * @static
  * @alias module:Math.lcm
  * @since 4.20.0
- * @see {@link https://baike.baidu.com/item/最小公倍数 | 最小公倍数}
+ * @see {@link https://baike.baidu.com/item/最小公倍数 最小公倍数}
  * @param {...(number|string)} nums 两个或多个整数。
  * @returns {number} 最小公倍数。
  * @example

package/types/loadImage.d.ts

@@ -2,6 +2,7 @@
  * @typedef {Object} CacheOptions 缓存配置
  * @property {boolean} [useCache=true] 是否使用缓存
  * @property {boolean} [autoRevokeOnDel=true] 删除时自动释放缓存
+ * @property {string} [cacheKey] 缓存键
  */
 /**
  * 加载图片。
@@ -31,6 +32,7 @@
  */
 declare function loadImage(img: string | Blob, cacheOptions?: boolean | {
     useCache?: boolean;
+    cacheKey?: string;
     autoRevokeOnDel?: boolean;
 }): Promise<HTMLImageElement>;
 export default loadImage;

package/types/loadImageWithBlob.d.ts

@@ -1,4 +1,8 @@
 import getFileBlob from './getFileBlob';
+type Result = {
+    image: HTMLImageElement;
+    blob: Blob;
+};
 /**
  * @typedef {Object} ImageWithBlob HTML图片元素和 blob 对象
  * @property {HTMLImageElement} image HTML图片元素
@@ -33,9 +37,7 @@ import getFileBlob from './getFileBlob';
  */
 declare function loadImageWithBlob(img: string | Blob, cacheOptions?: boolean | {
     useCache?: boolean;
+    cacheKey?: string;
     autoRevokeOnDel?: boolean;
-}, ajaxOptions?: Parameters<typeof getFileBlob>[1]): Promise<{
-    image: HTMLImageElement;
-    blob: Blob;
-}>;
+}, ajaxOptions?: Parameters<typeof getFileBlob>[1]): Promise<Result>;
 export default loadImageWithBlob;

package/types/normalizeString.d.ts

@@ -5,7 +5,7 @@
  * @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}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances String}
  * @deprecated 即将废弃，请使用 `import { toString } 'ut2'`
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值

package/types/numberToChinese.d.ts

@@ -17,7 +17,7 @@ type Options = {
  * @static
  * @alias module:Processor.numberToChinese
  * @since 1.2.0
- * @see {@link https://openstd.samr.gov.cn/bzgk/gb/newGbInfo?hcno=F5DAC3377DA99C8D78AE66735B6359C7 | 出版物上数字用法}
+ * @see {@link https://openstd.samr.gov.cn/bzgk/gb/newGbInfo?hcno=F5DAC3377DA99C8D78AE66735B6359C7 出版物上数字用法}
  * @param {number} num 数字
  * @param {Object} [options] 配置项
  * @param {boolean} [options.big5=false] 繁体

package/types/parseIdCard.d.ts

@@ -36,7 +36,7 @@ type IdCardInfo = {
  * @static
  * @alias module:Processor.parseIdCard
  * @since 4.0.0
- * @see {@link https://baike.baidu.com/item/居民身份证号码 | 居民身份证号码}
+ * @see {@link https://baike.baidu.com/item/居民身份证号码 居民身份证号码}
  * @param {string} id 身份证号码，支持15位
  * @returns {IdCardInfo | null} 省份、生日、性别，省/市/区/年/月/日/性别编码。如果解析失败将返回 null 。
  * @example