util-helpers 4.22.2 → 4.23.1

package/types/randomString.d.ts

@@ -1,11 +1,15 @@
+interface RandomString {
+    (len: number, poll: 'number' | 'lower' | 'upper'): string;
+    (len: number, poll?: string): string;
+}
 /**
  * 生成随机字符串
  *
- * @static
+ * @function
  * @alias module:Other.randomString
  * @since 4.8.0
  * @param {number} [len=0] 长度
- * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符，默认为数字和大小写字母
+ * @param {'number' | 'lower' | 'upper' | string} [pool='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 字符池，默认为数字和大小写字母，支持number/lower/upper
  * @returns {string} 随机字符串
  * @example
  *
@@ -17,5 +21,5 @@
  * randomString(8, 'abcefg'); // bcgcfabg
  *
  */
-declare function randomString(len?: number, optionalChars?: string): string;
+declare const randomString: RandomString;
 export default randomString;

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/transformObjectValue.d.ts

@@ -0,0 +1,67 @@
+type PropertyName = string | symbol;
+interface TransformObjectValue {
+    <V>(arr: V[], fn: (value: V, index: number) => any, deep: false): any[];
+    <V>(arr: V[], fn: (value: any, index: number) => any, deep?: boolean): any[];
+    <T extends object>(obj: T, fn: (value: T[keyof T], key: keyof T) => any, deep: false): Record<PropertyName, any>;
+    <T extends object>(obj: T, fn: (value: T[keyof T] extends object ? any : T[keyof T], key: T[keyof T] extends object ? any : keyof T) => any, deep?: boolean): Record<PropertyName, any>;
+    <T>(obj: T, fn: (...args: any[]) => any): T;
+}
+/**
+ * 创建一个转换值的新对象或数组。
+ *
+ * 例如 antd Form 中的设置表单值时，如果值为空字符串可能需要转为 `undefined` ，才不影响表单的初始值。
+ *
+ * @static
+ * @alias module:Processor.transformObjectValue
+ * @since 4.23.0
+ * @param {Array | Object} data 要转换值的普通对象或数组
+ * @param {Function} fn 遍历普通对象或数组键值方法
+ * @param {boolean} [deep=true] 深度遍历，检测值为普通对象或数组时递归处理。默认 true 。
+ * @returns {Array | Object} 如果是普通对象或数组，返回一个新的对象或数组，否则返回自身
+ * @example
+ *
+ * const data1 = { foo: 'bar', baz: 42 }
+ * // 数字转为字符串
+ * transformObjectValue(data1, value => {
+ *   if(typeof value === 'number'){
+ *     return String(value)
+ *   }
+ *   return value;
+ * });
+ * // { foo: 'bar', baz: '42' }
+ *
+ * const data2 = [1,2,3,4];
+ * // 数字转为字符串
+ * transformObjectValue(data2, value=>{
+ *   if(typeof value === 'number'){
+ *     return String(value)
+ *   }
+ * });
+ * // ['1', '2', '3', '4']
+ *
+ * // 嵌套普通对象或数组
+ * const data3 = { foo: 'bar', baz: 42, c: [1,2,3,4], d: '' }
+ * // 数字转为字符串，空字符串转为undefined
+ * transformObjectValue(data3, value=>{
+ *   if(typeof value === 'number'){
+ *     return String(value);
+ *   }
+ *   retrun value === '' ? undefined : value
+ * });
+ * // { foo: 'bar', baz: '42', ['1', '2', '3', '4'], d: undefined }
+ *
+ * // 数组的值不处理，对象值为数字转为字符串，空字符串转为undefined
+ * transformObjectValue(data3, (value, key)=>{
+ *   if(typeof key === 'number'){
+ *     return value;
+ *   }
+ *   if(typeof value === 'number'){
+ *     return String(value);
+ *   }
+ *   retrun value === '' ? undefined : value
+ * });
+ * // { foo: 'bar', baz: '42', [1, 2, 3, 4], d: undefined }
+ *
+ */
+declare const transformObjectValue: TransformObjectValue;
+export default transformObjectValue;

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;