util-helpers 4.23.0 → 4.23.2

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

@@ -53,8 +53,8 @@ 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

package/types/safeDate.d.ts

@@ -13,7 +13,7 @@ interface SafeDate {
  * @function
  * @alias module:Processor.safeDate
  * @since 4.4.0
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date | Date}
+ * @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 实例日期对象

package/types/setDataURLPrefix.d.ts

@@ -6,8 +6,8 @@
  * @static
  * @alias module:Processor.setDataURLPrefix
  * @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}
+ * @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/types/validatePassword.d.ts

@@ -23,7 +23,7 @@ type Options = {
  * @static
  * @alias module:Validator.validatePassword
  * @since 3.7.0
- * @see {@link https://baike.baidu.com/item/ASCII#3 | ASCII}
+ * @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/esm/utils/Cache.js

@@ -1,47 +0,0 @@
-import { __extends, __assign } from 'tslib';
-import Emitter from 'emitter-pro';
-import { forEach } from 'ut2';
-
-var Cache = (function (_super) {
-    __extends(Cache, _super);
-    function Cache(options) {
-        var _this = _super.call(this) || this;
-        _this.data = [];
-        _this.options = __assign({ max: 10 }, options);
-        return _this;
-    }
-    Cache.prototype.has = function (k) {
-        return !!this.data.find(function (item) { return item.k === k; });
-    };
-    Cache.prototype.get = function (k) {
-        var _a;
-        return (_a = this.data.find(function (item) { return item.k === k; })) === null || _a === void 0 ? void 0 : _a.v;
-    };
-    Cache.prototype.checkLimit = function () {
-        var _this = this;
-        if (this.options.max !== 0) {
-            var limit = this.data.length - this.options.max;
-            if (limit >= 0) {
-                var delArr = this.data.splice(0, limit + 1);
-                forEach(delArr, function (item) {
-                    _this.emit('del', item.v, item.k);
-                });
-            }
-        }
-    };
-    Cache.prototype.set = function (k, v) {
-        var newData = { k: k, v: v };
-        if (this.has(k)) {
-            var index = this.data.findIndex(function (item) { return item.k === k; });
-            this.data.splice(index, 1, newData);
-        }
-        else {
-            this.checkLimit();
-            this.data.push(newData);
-        }
-    };
-    return Cache;
-}(Emitter));
-var Cache$1 = Cache;
-
-export { Cache$1 as default };

package/lib/utils/Cache.js

@@ -1,49 +0,0 @@
-'use strict';
-
-var tslib = require('tslib');
-var Emitter = require('emitter-pro');
-var ut2 = require('ut2');
-
-var Cache = (function (_super) {
-    tslib.__extends(Cache, _super);
-    function Cache(options) {
-        var _this = _super.call(this) || this;
-        _this.data = [];
-        _this.options = tslib.__assign({ max: 10 }, options);
-        return _this;
-    }
-    Cache.prototype.has = function (k) {
-        return !!this.data.find(function (item) { return item.k === k; });
-    };
-    Cache.prototype.get = function (k) {
-        var _a;
-        return (_a = this.data.find(function (item) { return item.k === k; })) === null || _a === void 0 ? void 0 : _a.v;
-    };
-    Cache.prototype.checkLimit = function () {
-        var _this = this;
-        if (this.options.max !== 0) {
-            var limit = this.data.length - this.options.max;
-            if (limit >= 0) {
-                var delArr = this.data.splice(0, limit + 1);
-                ut2.forEach(delArr, function (item) {
-                    _this.emit('del', item.v, item.k);
-                });
-            }
-        }
-    };
-    Cache.prototype.set = function (k, v) {
-        var newData = { k: k, v: v };
-        if (this.has(k)) {
-            var index = this.data.findIndex(function (item) { return item.k === k; });
-            this.data.splice(index, 1, newData);
-        }
-        else {
-            this.checkLimit();
-            this.data.push(newData);
-        }
-    };
-    return Cache;
-}(Emitter));
-var Cache$1 = Cache;
-
-module.exports = Cache$1;