ut2 1.20.1 → 1.21.1

package/es/equalArrayLike.js

@@ -1,19 +1,5 @@
-import eq from './eq.js';
-import isArrayLike from './isArrayLike.js';
+import shallowEqual from './shallowEqual.js';
 
-function equalArrayLike(arg1, arg2, strictCheck) {
-    if (strictCheck === void 0) { strictCheck = true; }
-    if (eq(arg1, arg2, strictCheck))
-        return true;
-    if (!isArrayLike(arg1) || !isArrayLike(arg2))
-        return false;
-    if (arg1.length !== arg2.length)
-        return false;
-    for (var i = 0; i < arg1.length; i++) {
-        if (!eq(arg1[i], arg2[i], strictCheck))
-            return false;
-    }
-    return true;
-}
+var equalArrayLike = shallowEqual;
 
 export { equalArrayLike as default };

package/es/index.js

@@ -136,6 +136,7 @@ export { default as nthArg } from './nthArg.js';
 export { default as range } from './range.js';
 export { default as retry } from './retry.js';
 export { default as sleep } from './sleep.js';
+export { default as shallowEqual } from './shallowEqual.js';
 export { default as times } from './times.js';
 export { default as toFinite } from './toFinite.js';
 export { default as toInteger } from './toInteger.js';

package/es/internals/helpers.js

@@ -2,7 +2,7 @@ import isObjectLike from '../isObjectLike.js';
 import getTag from './getTag.js';
 import { argumentsTag, functionProtoToString, stringUndefined } from './native.js';
 
-var VERSION = "1.20.1";
+var VERSION = "1.21.1";
 var isBrowser = typeof window !== stringUndefined && isObjectLike(window) && typeof document !== stringUndefined && isObjectLike(document) && window.document === document;
 var supportedArgumentsType = getTag((function () { return arguments; })()) === argumentsTag;
 var FUNC_ERROR_TEXT = 'Expected a function';

package/es/memoize.js

@@ -1,10 +1,10 @@
-import equalArrayLike from './equalArrayLike.js';
+import shallowEqual from './shallowEqual.js';
 import { mathCeil } from './internals/native.js';
 
 function memoize(func, options) {
     var opts = options || {};
     var max = mathCeil(opts.max || 0);
-    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : equalArrayLike;
+    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : shallowEqual;
     var cache = [];
     function memoized() {
         var _this = this;

package/es/shallowEqual.js

@@ -0,0 +1,26 @@
+import eq from './eq.js';
+import { objectProtoHasOwnProperty } from './internals/native.js';
+
+function shallowEqual(objA, objB, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = true; }
+    if (eq(objA, objB, strictCheck)) {
+        return true;
+    }
+    if (typeof objA !== 'object' || objA === null || typeof objB !== 'object' || objB === null) {
+        return false;
+    }
+    var keysA = Object.keys(objA);
+    var keysB = Object.keys(objB);
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    for (var i = 0; i < keysA.length; i++) {
+        var key = keysA[i];
+        if (!objectProtoHasOwnProperty.call(objB, key) || !eq(objA[key], objB[key], strictCheck)) {
+            return false;
+        }
+    }
+    return true;
+}
+
+export { shallowEqual as default };

package/lib/equalArrayLike.js

@@ -1,21 +1,7 @@
 'use strict';
 
-var eq = require('./eq.js');
-var isArrayLike = require('./isArrayLike.js');
+var shallowEqual = require('./shallowEqual.js');
 
-function equalArrayLike(arg1, arg2, strictCheck) {
-    if (strictCheck === void 0) { strictCheck = true; }
-    if (eq(arg1, arg2, strictCheck))
-        return true;
-    if (!isArrayLike(arg1) || !isArrayLike(arg2))
-        return false;
-    if (arg1.length !== arg2.length)
-        return false;
-    for (var i = 0; i < arg1.length; i++) {
-        if (!eq(arg1[i], arg2[i], strictCheck))
-            return false;
-    }
-    return true;
-}
+var equalArrayLike = shallowEqual;
 
 module.exports = equalArrayLike;

package/lib/index.js

@@ -138,6 +138,7 @@ var nthArg = require('./nthArg.js');
 var range = require('./range.js');
 var retry = require('./retry.js');
 var sleep = require('./sleep.js');
+var shallowEqual = require('./shallowEqual.js');
 var times = require('./times.js');
 var toFinite = require('./toFinite.js');
 var toInteger = require('./toInteger.js');
@@ -292,6 +293,7 @@ exports.nthArg = nthArg;
 exports.range = range;
 exports.retry = retry;
 exports.sleep = sleep;
+exports.shallowEqual = shallowEqual;
 exports.times = times;
 exports.toFinite = toFinite;
 exports.toInteger = toInteger;

package/lib/internals/getTagWithBugfix.js

@@ -14,13 +14,13 @@ var mapCtorString = helpers.toSource(Map);
 var promiseCtorString = helpers.toSource(Promise);
 var setCtorString = helpers.toSource(Set);
 var weakMapCtorString = helpers.toSource(WeakMap);
-var getTagWithBugfix = getTag;
+var getTagWithBugfix$1 = getTag;
 if ((dataViewExisted && getTag(new DataView(new ArrayBuffer(1))) !== native.dataViewTag) ||
     (mapExisted && getTag(new Map()) !== native.mapTag) ||
     (promiseExisted && getTag(Promise.resolve()) !== native.promiseTag) ||
     (setExisted && getTag(new Set()) !== native.setTag) ||
     (weakMapExisted && getTag(new WeakMap()) !== native.weakMapTag)) {
-    getTagWithBugfix = function (value) {
+    getTagWithBugfix$1 = function (value) {
         var result = getTag(value);
         var Ctor = result === native.objectTag ? value.constructor : native.nativeUndefined;
         var ctorString = Ctor ? helpers.toSource(Ctor) : '';
@@ -41,6 +41,6 @@ if ((dataViewExisted && getTag(new DataView(new ArrayBuffer(1))) !== native.data
         return result;
     };
 }
-var getTagWithBugfix$1 = getTagWithBugfix;
+var getTagWithBugfix = getTagWithBugfix$1;
 
-module.exports = getTagWithBugfix$1;
+module.exports = getTagWithBugfix;

package/lib/internals/helpers.js

@@ -4,7 +4,7 @@ var isObjectLike = require('../isObjectLike.js');
 var getTag = require('./getTag.js');
 var native = require('./native.js');
 
-var VERSION = "1.20.1";
+var VERSION = "1.21.1";
 var isBrowser = typeof window !== native.stringUndefined && isObjectLike(window) && typeof document !== native.stringUndefined && isObjectLike(document) && window.document === document;
 var supportedArgumentsType = getTag((function () { return arguments; })()) === native.argumentsTag;
 var FUNC_ERROR_TEXT = 'Expected a function';

package/lib/memoize.js

@@ -1,12 +1,12 @@
 'use strict';
 
-var equalArrayLike = require('./equalArrayLike.js');
+var shallowEqual = require('./shallowEqual.js');
 var native = require('./internals/native.js');
 
 function memoize(func, options) {
     var opts = options || {};
     var max = native.mathCeil(opts.max || 0);
-    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : equalArrayLike;
+    var isEqual = typeof opts.isEqual === 'function' ? opts.isEqual : shallowEqual;
     var cache = [];
     function memoized() {
         var _this = this;

package/lib/shallowEqual.js

@@ -0,0 +1,28 @@
+'use strict';
+
+var eq = require('./eq.js');
+var native = require('./internals/native.js');
+
+function shallowEqual(objA, objB, strictCheck) {
+    if (strictCheck === void 0) { strictCheck = true; }
+    if (eq(objA, objB, strictCheck)) {
+        return true;
+    }
+    if (typeof objA !== 'object' || objA === null || typeof objB !== 'object' || objB === null) {
+        return false;
+    }
+    var keysA = Object.keys(objA);
+    var keysB = Object.keys(objB);
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    for (var i = 0; i < keysA.length; i++) {
+        var key = keysA[i];
+        if (!native.objectProtoHasOwnProperty.call(objB, key) || !eq(objA[key], objB[key], strictCheck)) {
+            return false;
+        }
+    }
+    return true;
+}
+
+module.exports = shallowEqual;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ut2",
-  "version": "1.20.1",
+  "version": "1.21.1",
   "author": "caijf",
   "license": "MIT",
   "main": "lib/index.js",
@@ -62,32 +62,32 @@
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@commitlint/cz-commitlint": "^19.8.1",
-    "@eslint/js": "^9.31.0",
-    "@rollup/plugin-commonjs": "^28.0.6",
-    "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-replace": "^6.0.2",
+    "@eslint/js": "^9.39.2",
+    "@rollup/plugin-commonjs": "^28.0.9",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-terser": "^0.4.4",
-    "@rollup/plugin-typescript": "^12.1.4",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/jest": "^30.0.0",
-    "@types/node": "^20.19.9",
+    "@types/node": "^20.19.27",
     "benchmark": "^2.1.4",
     "commitizen": "^4.3.1",
     "cross-env": "^7.0.3",
-    "dayjs": "^1.11.13",
+    "dayjs": "^1.11.19",
     "docdash": "^2.0.2",
-    "eslint": "^9.31.0",
-    "globals": "^16.3.0",
+    "eslint": "^9.39.2",
+    "globals": "^16.5.0",
     "husky": "^9.1.7",
-    "jest": "^30.0.5",
-    "jest-environment-jsdom": "^30.0.5",
-    "jsdoc": "^4.0.4",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "jsdoc": "^4.0.5",
     "lint-staged": "^15.5.2",
     "lodash": "^4.17.21",
-    "prettier": "^3.6.2",
-    "rollup": "^4.45.1",
-    "ts-jest": "^29.4.0",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.38.0",
+    "prettier": "^3.7.4",
+    "rollup": "^4.54.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.51.0",
     "underscore": "^1.13.7"
   },
   "engines": {

package/types/countBy.d.ts

@@ -13,6 +13,7 @@ interface CountBy {
  * @function
  * @alias module:Collection.countBy
  * @since 1.0.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数，用来转换键。
  * @returns {Object} 组成集合对象。

package/types/equalArrayLike.d.ts

@@ -1,37 +1,11 @@
+import shallowEqual from './shallowEqual';
 /**
  * 比较两个类数组的值是否相等。常用于参数对象比较。
  *
- * 1. 如果两个值相等，返回 `true`。
- * 2. 如果两个类数组 `length` 相等，且遍历每个值都相等，则返回 `true`。
- * 3. 否则返回 `false`。
- *
+ * @deprecated 即将废弃，请使用 `shallowEqual` 替代。
+ * @private
  * @alias module:Util.equalArrayLike
  * @since 1.18.0
- * @param {Array} arg1 类数组1。
- * @param {Array} arg2 类数组2。
- * @param {boolean} [strictCheck=true] 严格比较，如果为 `true` 表示区分 `0` 和 `-0`。默认 `true`。
- * @returns 是否相等。
- * @example
- * equalArrayLike([1, 2], [1, 2]); // true
- * equalArrayLike([1, 2], [1, 3]); // false
- * equalArrayLike([1, 2], [1, 2, 3]); // false
- *
- * // 松散比较
- * equalArrayLike(['a', 'b'], 'ab'); // true
- * equalArrayLike(['a', 'b'], { 0: 'a', 1: 'b', length: 2 }); // true
- *
- * // 两个相等值返回 true
- * equalArrayLike(NaN, NaN); // true
- * equalArrayLike(null, null); // true
- * equalArrayLike(undefined, undefined); // true
- * const obj1 = {};
- * const obj2 = obj1;
- * equalArrayLike(obj1, obj2); // true
- *
- * // 0 和 -0 严格比较返回 false
- * equalArrayLike([0, -0], [-0, 0]); // false
- * // 非严格比较返回 true
- * equalArrayLike([0, -0], [-0, 0], false); // true
  */
-declare function equalArrayLike(arg1: ArrayLike<any>, arg2: ArrayLike<any>, strictCheck?: boolean): boolean;
+declare const equalArrayLike: typeof shallowEqual;
 export default equalArrayLike;

package/types/every.d.ts

@@ -13,6 +13,7 @@ interface Every {
  * @function
  * @alias module:Collection.every
  * @since 1.7.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {function} [predicate=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {boolean} 如果全部元素都通过 `predicate` 测试，则返回 `true`，否则返回 `false`。

package/types/filter.d.ts

@@ -12,6 +12,7 @@ interface Filter {
  *
  * @alias module:Collection.filter
  * @since 1.7.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {function} [predicate=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {Array} 返回新的过滤数组。

package/types/find.d.ts

@@ -13,6 +13,7 @@ interface Find {
  * @function
  * @alias module:Collection.find
  * @since 1.7.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {function} [predicate=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {ArrayLike<any> | Object} 返回第一个通过 `predicate` 返回真值的元素，否则返回 `undefined`。

package/types/forEach.d.ts

@@ -8,6 +8,7 @@
  * @function
  * @alias module:Collection.forEach
  * @since 1.7.0
+ * @requires module:Object.allKeys
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {ArrayLike<any> | Object} 迭代集合本身。

package/types/forEachRight.d.ts

@@ -8,6 +8,7 @@
  * @function
  * @alias module:Collection.forEachRight
  * @since 1.7.0
+ * @requires module:Object.allKeys
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {ArrayLike<any> | Object} 迭代集合本身。

package/types/groupBy.d.ts

@@ -12,6 +12,7 @@ interface GroupBy {
  *
  * @alias module:Collection.groupBy
  * @since 1.0.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数，用来转换键。默认 `identity`。
  * @returns {Object} 组成聚合对象。

package/types/index.d.ts

@@ -190,6 +190,7 @@ export { default as nthArg } from './nthArg';
 export { default as range } from './range';
 export { default as retry } from './retry';
 export { default as sleep } from './sleep';
+export { default as shallowEqual } from './shallowEqual';
 export { default as times } from './times';
 export { default as toFinite } from './toFinite';
 export { default as toInteger } from './toInteger';

package/types/isNil.d.ts

@@ -19,5 +19,5 @@
  *
  * isNil(1); // false
  */
-declare function isNil(value: any): value is undefined | null;
+declare function isNil(value: any): value is undefined;
 export default isNil;

package/types/isObject.d.ts

@@ -1,4 +1,3 @@
-import { FunctionAny } from './internals/types';
 /**
  * 检查值是否为对象。(例如，数组、函数、对象、正则表达式、new Number(0) 和 new String(''))。
  *
@@ -18,5 +17,5 @@ import { FunctionAny } from './internals/types';
  * isObject(null); // false
  *
  */
-declare function isObject(value: any): value is object | FunctionAny;
+declare function isObject(value: any): value is object;
 export default isObject;

package/types/isPromiseLike.d.ts

@@ -16,5 +16,5 @@
  * isPromiseLike([]); // false
  *
  */
-declare function isPromiseLike(value: any): value is Promise<any> | PromiseLike<any>;
+declare function isPromiseLike(value: any): value is Promise<any>;
 export default isPromiseLike;

package/types/keyBy.d.ts

@@ -13,6 +13,7 @@ interface KeyBy {
  * @function
  * @alias module:Collection.keyBy
  * @since 1.0.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol} [iteratee=identity] 迭代函数，用来转换键。默认 `identity`。
  * @returns {Object} 组成聚合对象。

package/types/map.d.ts

@@ -12,6 +12,7 @@ interface Map {
  *
  * @alias module:Collection.map
  * @since 1.7.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {Array} 一个新数组。

package/types/memoize.d.ts

@@ -10,7 +10,7 @@ type EqualFn<TFunc extends (...args: any[]) => any> = (newArgs: Parameters<TFunc
  * @since 1.17.0
  * @param {Function} func 要缓存结果的函数。
  * @param {Object} [options] 配置项。
- * @param {Function} [options.isEqual] 自定义比较参数方法。默认函数 `equalArrayLike`。
+ * @param {Function} [options.isEqual] 自定义比较参数方法。默认函数 `shallowEqual`。
  * @param {number} [options.max] 最大缓存数量，`0`表示不限制。默认`0`。
  * @returns 缓存 `func` 结果的函数。
  * @example

package/types/orderBy.d.ts

@@ -16,6 +16,7 @@ interface OrderBy {
  * @function
  * @alias module:Collection.orderBy
  * @since 1.0.0
+ * @requires module:Collection.forEach
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Array/sort sort}
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。
  * @param {Function | string | number | Symbol | Array} [iteratees] 排序的迭代函数。

package/types/partition.d.ts

@@ -12,6 +12,7 @@ interface Partition {
  *
  * @alias module:Collection.partition
  * @since 1.0.0
+ * @requires module:Collection.forEach
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Truthy Truthy}
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Falsy Falsy}
  * @param {ArrayLike<any> | Object} collection 一个用来迭代的集合。

package/types/reduce.d.ts

@@ -8,6 +8,7 @@
  * @function
  * @alias module:Collection.reduce
  * @since 1.7.0
+ * @requires module:Object.allKeys
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @param {*} [initialValue] 初始值。

package/types/reduceRight.d.ts

@@ -8,6 +8,7 @@
  * @function
  * @alias module:Collection.reduceRight
  * @since 1.7.0
+ * @requires module:Object.allKeys
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {Function} [iteratee=identity] 每次迭代调用的函数。默认 `identity`。
  * @param {*} [initialValue] 初始值。

package/types/shallowEqual.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 浅比较两个值是否相等。常用于参数对象比较。
+ *
+ * 1. 如果两个值相等，返回 `true`。
+ * 2. 如果两个对象属性数量相等，且遍历每个属性值都相等，则返回 `true`。
+ * 3. 否则返回 `false`。
+ *
+ * @alias module:Util.shallowEqual
+ * @since 1.21.0
+ * @param {Array} objA 要比较的值。。
+ * @param {Array} objB 另一个要比较的值。
+ * @param {boolean} [strictCheck=true] 严格比较，如果为 `true` 表示区分 `0` 和 `-0`。默认 `true`。
+ * @returns 浅比较两个值是否相等。
+ * @example
+ * shallowEqual({ a: 1, b: 2 }, { a: 1, b: 2 }); // true
+ * shallowEqual({ a: 1, b: 2 }, { a: 1, b: 3 }); // false
+ *
+ * shallowEqual([1, 2], [1, 2]); // true
+ * shallowEqual([1, 2], [1, 3]); // false
+ * shallowEqual([1, 2], [1, 2, 3]); // false
+ *
+ * // 两个相等值返回 true
+ * shallowEqual(1, 1); // true
+ * shallowEqual('foo', 'foo'); // true
+ * shallowEqual(NaN, NaN); // true
+ * shallowEqual(null, null); // true
+ * shallowEqual(undefined, undefined); // true
+ * const obj1 = {};
+ * const obj2 = obj1;
+ * shallowEqual(obj1, obj2); // true
+ *
+ * // 默认严格比较，区分 0 和 -0
+ * shallowEqual([0, -0], [-0, 0]); // false
+ *
+ * // 非严格比较，不区分 0 和 -0
+ * shallowEqual([0, -0], [-0, 0], false); // true
+ */
+declare function shallowEqual(objA: any, objB: any, strictCheck?: boolean): boolean;
+export default shallowEqual;

package/types/some.d.ts

@@ -13,6 +13,7 @@ interface Some {
  * @function
  * @alias module:Collection.some
  * @since 1.7.0
+ * @requires module:Collection.forEach
  * @param {ArrayLike<any> | Object} collection 要迭代的集合。
  * @param {function} [predicate=identity] 每次迭代调用的函数。默认 `identity`。
  * @returns {boolean} 如果任一元素通过 `predicate` 测试，则返回 `true`，否则返回 `false`。