es-toolkit 1.23.0-dev.718 → 1.23.0-dev.719

package/dist/compat/array/take.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Returns a new array containing the first `count` elements from the input array `arr`.
+ * If `count` is greater than the length of `arr`, the entire array is returned.
+ *
+ * @template T - Type of elements in the input array.
+ *
+ * @param {T[]} arr - The array to take elements from.
+ * @param {number} count - The number of elements to take.
+ * @returns {T[]} A new array containing the first `count` elements from `arr`.
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * take([1, 2, 3, 4, 5], 3);
+ *
+ * @example
+ * // Returns ['a', 'b']
+ * take(['a', 'b', 'c'], 2);
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * take([1, 2, 3], 5);
+ */
+declare function take<T>(arr: readonly T[], count: number): T[];
+
+export { take };

package/dist/compat/array/take.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Returns a new array containing the first `count` elements from the input array `arr`.
+ * If `count` is greater than the length of `arr`, the entire array is returned.
+ *
+ * @template T - Type of elements in the input array.
+ *
+ * @param {T[]} arr - The array to take elements from.
+ * @param {number} count - The number of elements to take.
+ * @returns {T[]} A new array containing the first `count` elements from `arr`.
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * take([1, 2, 3, 4, 5], 3);
+ *
+ * @example
+ * // Returns ['a', 'b']
+ * take(['a', 'b', 'c'], 2);
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * take([1, 2, 3], 5);
+ */
+declare function take<T>(arr: readonly T[], count: number): T[];
+
+export { take };

package/dist/compat/array/take.mjs

@@ -0,0 +1,10 @@
+import { take as take$1 } from '../../array/take.mjs';
+
+function take(arr, count) {
+    if (count < 1) {
+        return [];
+    }
+    return take$1(arr, count);
+}
+
+export { take };

package/dist/compat/index.d.mts

@@ -25,7 +25,6 @@ export { sample } from '../array/sample.mjs';
 export { sampleSize } from '../array/sampleSize.mjs';
 export { shuffle } from '../array/shuffle.mjs';
 export { tail } from '../array/tail.mjs';
-export { take } from '../array/take.mjs';
 export { takeRight } from '../array/takeRight.mjs';
 export { takeRightWhile } from '../array/takeRightWhile.mjs';
 export { takeWhile } from '../array/takeWhile.mjs';
@@ -72,7 +71,6 @@ export { toMerged } from '../object/toMerged.mjs';
 export { isArrayBuffer } from '../predicate/isArrayBuffer.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
-export { isEqualWith } from '../predicate/isEqualWith.mjs';
 export { isMap } from '../predicate/isMap.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
@@ -117,6 +115,7 @@ export { orderBy } from './array/orderBy.mjs';
 export { sortBy } from './array/sortBy.mjs';
 export { size } from './array/size.mjs';
 export { some } from './array/some.mjs';
+export { take } from './array/take.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { filter } from './array/filter.mjs';
 export { ary } from './function/ary.mjs';
@@ -173,6 +172,7 @@ export { isNumber } from './predicate/isNumber.mjs';
 export { isNaN } from './predicate/isNaN.mjs';
 export { isArrayLikeObject } from './predicate/isArrayLikeObject.mjs';
 export { isNil } from './predicate/isNil.mjs';
+export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { camelCase } from './string/camelCase.mjs';
 export { kebabCase } from './string/kebabCase.mjs';
 export { snakeCase } from './string/snakeCase.mjs';

package/dist/compat/index.d.ts

@@ -25,7 +25,6 @@ export { sample } from '../array/sample.js';
 export { sampleSize } from '../array/sampleSize.js';
 export { shuffle } from '../array/shuffle.js';
 export { tail } from '../array/tail.js';
-export { take } from '../array/take.js';
 export { takeRight } from '../array/takeRight.js';
 export { takeRightWhile } from '../array/takeRightWhile.js';
 export { takeWhile } from '../array/takeWhile.js';
@@ -72,7 +71,6 @@ export { toMerged } from '../object/toMerged.js';
 export { isArrayBuffer } from '../predicate/isArrayBuffer.js';
 export { isDate } from '../predicate/isDate.js';
 export { isEqual } from '../predicate/isEqual.js';
-export { isEqualWith } from '../predicate/isEqualWith.js';
 export { isMap } from '../predicate/isMap.js';
 export { isNotNil } from '../predicate/isNotNil.js';
 export { isNull } from '../predicate/isNull.js';
@@ -117,6 +115,7 @@ export { orderBy } from './array/orderBy.js';
 export { sortBy } from './array/sortBy.js';
 export { size } from './array/size.js';
 export { some } from './array/some.js';
+export { take } from './array/take.js';
 export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { filter } from './array/filter.js';
 export { ary } from './function/ary.js';
@@ -173,6 +172,7 @@ export { isNumber } from './predicate/isNumber.js';
 export { isNaN } from './predicate/isNaN.js';
 export { isArrayLikeObject } from './predicate/isArrayLikeObject.js';
 export { isNil } from './predicate/isNil.js';
+export { isEqualWith } from './predicate/isEqualWith.js';
 export { camelCase } from './string/camelCase.js';
 export { kebabCase } from './string/kebabCase.js';
 export { snakeCase } from './string/snakeCase.js';

package/dist/compat/index.js

@@ -831,6 +831,13 @@ function some(arr, predicate, guard) {
     }
 }
 
+function take(arr, count) {
+    if (count < 1) {
+        return [];
+    }
+    return zipWith.take(arr, count);
+}
+
 function set(obj, path, value) {
     const resolvedPath = Array.isArray(path) ? path : typeof path === 'string' ? toPath(path) : [path];
     let current = obj;
@@ -1517,6 +1524,24 @@ function isArrayLikeObject(value) {
     return isObjectLike.isObjectLike(value) && isArrayLike(value);
 }
 
+function isEqualWith(a, b, areValuesEqual = noop.noop) {
+    if (typeof areValuesEqual !== 'function') {
+        areValuesEqual = noop.noop;
+    }
+    return isWeakSet$1.isEqualWith(a, b, (...args) => {
+        const result = areValuesEqual(...args);
+        if (result !== undefined) {
+            return !!result;
+        }
+        if (a instanceof Map && b instanceof Map) {
+            return isEqualWith(Array.from(a), Array.from(b), flowRight$1.after(2, areValuesEqual));
+        }
+        if (a instanceof Set && b instanceof Set) {
+            return isEqualWith(Array.from(a), Array.from(b), flowRight$1.after(2, areValuesEqual));
+        }
+    });
+}
+
 function toString(value) {
     if (value == null) {
         return '';
@@ -1857,7 +1882,6 @@ exports.sample = zipWith.sample;
 exports.sampleSize = zipWith.sampleSize;
 exports.shuffle = zipWith.shuffle;
 exports.tail = zipWith.tail;
-exports.take = zipWith.take;
 exports.takeRight = zipWith.takeRight;
 exports.takeRightWhile = zipWith.takeRightWhile;
 exports.takeWhile = zipWith.takeWhile;
@@ -1909,7 +1933,6 @@ exports.isPrimitive = isPlainObject$1.isPrimitive;
 exports.isArrayBuffer = isWeakSet$1.isArrayBuffer;
 exports.isDate = isWeakSet$1.isDate;
 exports.isEqual = isWeakSet$1.isEqual;
-exports.isEqualWith = isWeakSet$1.isEqualWith;
 exports.isFunction = isWeakSet$1.isFunction;
 exports.isJSONArray = isWeakSet$1.isJSONArray;
 exports.isJSONObject = isWeakSet$1.isJSONObject;
@@ -1974,6 +1997,7 @@ exports.isArray = isArray;
 exports.isArrayLike = isArrayLike;
 exports.isArrayLikeObject = isArrayLikeObject;
 exports.isBoolean = isBoolean;
+exports.isEqualWith = isEqualWith;
 exports.isError = isError;
 exports.isFinite = isFinite;
 exports.isInteger = isInteger;
@@ -2022,6 +2046,7 @@ exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
+exports.take = take;
 exports.throttle = throttle;
 exports.toFinite = toFinite;
 exports.toInteger = toInteger;

package/dist/compat/index.mjs

@@ -25,7 +25,6 @@ export { sample } from '../array/sample.mjs';
 export { sampleSize } from '../array/sampleSize.mjs';
 export { shuffle } from '../array/shuffle.mjs';
 export { tail } from '../array/tail.mjs';
-export { take } from '../array/take.mjs';
 export { takeRight } from '../array/takeRight.mjs';
 export { takeRightWhile } from '../array/takeRightWhile.mjs';
 export { takeWhile } from '../array/takeWhile.mjs';
@@ -74,7 +73,6 @@ export { isObjectLike } from './predicate/isObjectLike.mjs';
 export { isArrayBuffer } from '../predicate/isArrayBuffer.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
-export { isEqualWith } from '../predicate/isEqualWith.mjs';
 export { isMap } from '../predicate/isMap.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
@@ -118,6 +116,7 @@ export { orderBy } from './array/orderBy.mjs';
 export { sortBy } from './array/sortBy.mjs';
 export { size } from './array/size.mjs';
 export { some } from './array/some.mjs';
+export { take } from './array/take.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { filter } from './array/filter.mjs';
 export { ary } from './function/ary.mjs';
@@ -173,6 +172,7 @@ export { isNumber } from './predicate/isNumber.mjs';
 export { isNaN } from './predicate/isNaN.mjs';
 export { isArrayLikeObject } from './predicate/isArrayLikeObject.mjs';
 export { isNil } from './predicate/isNil.mjs';
+export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { camelCase } from './string/camelCase.mjs';
 export { kebabCase } from './string/kebabCase.mjs';
 export { snakeCase } from './string/snakeCase.mjs';

package/dist/compat/predicate/isEqualWith.d.mts

@@ -0,0 +1,38 @@
+/**
+ * Compares two values for equality using a custom comparison function.
+ *
+ * The custom function allows for fine-tuned control over the comparison process. If it returns a boolean, that result determines the equality. If it returns undefined, the function falls back to the default equality comparison.
+ *
+ * This function also uses the custom equality function to compare values inside objects,
+ * arrays, maps, sets, and other complex structures, ensuring a deep comparison.
+ *
+ * This approach provides flexibility in handling complex comparisons while maintaining efficient default behavior for simpler cases.
+ *
+ * The custom comparison function can take up to six parameters:
+ * - `x`: The value from the first object `a`.
+ * - `y`: The value from the second object `b`.
+ * - `property`: The property key used to get `x` and `y`.
+ * - `xParent`: The parent of the first value `x`.
+ * - `yParent`: The parent of the second value `y`.
+ * - `stack`: An internal stack (Map) to handle circular references.
+ *
+ * @param {unknown} a - The first value to compare.
+ * @param {unknown} b - The second value to compare.
+ * @param {(x: any, y: any, property?: PropertyKey, xParent?: any, yParent?: any, stack?: Map<any, any>) => boolean | void} [areValuesEqual=noop] - A function to customize the comparison.
+ *   If it returns a boolean, that result will be used. If it returns undefined,
+ *   the default equality comparison will be used.
+ * @returns {boolean} `true` if the values are equal according to the customizer, otherwise `false`.
+ *
+ * @example
+ * const customizer = (a, b) => {
+ *   if (typeof a === 'string' && typeof b === 'string') {
+ *     return a.toLowerCase() === b.toLowerCase();
+ *   }
+ * };
+ * isEqualWith('Hello', 'hello', customizer); // true
+ * isEqualWith({ a: 'Hello' }, { a: 'hello' }, customizer); // true
+ * isEqualWith([1, 2, 3], [1, 2, 3], customizer); // true
+ */
+declare function isEqualWith(a: any, b: any, areValuesEqual?: (a: any, b: any, property?: PropertyKey, aParent?: any, bParent?: any, stack?: Map<any, any>) => boolean | void): boolean;
+
+export { isEqualWith };

package/dist/compat/predicate/isEqualWith.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Compares two values for equality using a custom comparison function.
+ *
+ * The custom function allows for fine-tuned control over the comparison process. If it returns a boolean, that result determines the equality. If it returns undefined, the function falls back to the default equality comparison.
+ *
+ * This function also uses the custom equality function to compare values inside objects,
+ * arrays, maps, sets, and other complex structures, ensuring a deep comparison.
+ *
+ * This approach provides flexibility in handling complex comparisons while maintaining efficient default behavior for simpler cases.
+ *
+ * The custom comparison function can take up to six parameters:
+ * - `x`: The value from the first object `a`.
+ * - `y`: The value from the second object `b`.
+ * - `property`: The property key used to get `x` and `y`.
+ * - `xParent`: The parent of the first value `x`.
+ * - `yParent`: The parent of the second value `y`.
+ * - `stack`: An internal stack (Map) to handle circular references.
+ *
+ * @param {unknown} a - The first value to compare.
+ * @param {unknown} b - The second value to compare.
+ * @param {(x: any, y: any, property?: PropertyKey, xParent?: any, yParent?: any, stack?: Map<any, any>) => boolean | void} [areValuesEqual=noop] - A function to customize the comparison.
+ *   If it returns a boolean, that result will be used. If it returns undefined,
+ *   the default equality comparison will be used.
+ * @returns {boolean} `true` if the values are equal according to the customizer, otherwise `false`.
+ *
+ * @example
+ * const customizer = (a, b) => {
+ *   if (typeof a === 'string' && typeof b === 'string') {
+ *     return a.toLowerCase() === b.toLowerCase();
+ *   }
+ * };
+ * isEqualWith('Hello', 'hello', customizer); // true
+ * isEqualWith({ a: 'Hello' }, { a: 'hello' }, customizer); // true
+ * isEqualWith([1, 2, 3], [1, 2, 3], customizer); // true
+ */
+declare function isEqualWith(a: any, b: any, areValuesEqual?: (a: any, b: any, property?: PropertyKey, aParent?: any, bParent?: any, stack?: Map<any, any>) => boolean | void): boolean;
+
+export { isEqualWith };

package/dist/compat/predicate/isEqualWith.mjs

@@ -0,0 +1,23 @@
+import { after } from '../../function/after.mjs';
+import { noop } from '../../function/noop.mjs';
+import { isEqualWith as isEqualWith$1 } from '../../predicate/isEqualWith.mjs';
+
+function isEqualWith(a, b, areValuesEqual = noop) {
+    if (typeof areValuesEqual !== 'function') {
+        areValuesEqual = noop;
+    }
+    return isEqualWith$1(a, b, (...args) => {
+        const result = areValuesEqual(...args);
+        if (result !== undefined) {
+            return !!result;
+        }
+        if (a instanceof Map && b instanceof Map) {
+            return isEqualWith(Array.from(a), Array.from(b), after(2, areValuesEqual));
+        }
+        if (a instanceof Set && b instanceof Set) {
+            return isEqualWith(Array.from(a), Array.from(b), after(2, areValuesEqual));
+        }
+    });
+}
+
+export { isEqualWith };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.23.0-dev.718+8a34bc47",
+  "version": "1.23.0-dev.719+35aa0bfe",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {