es-toolkit 1.37.2 → 1.38.0-dev.1285

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # es-toolkit Changelog
 
+## Version v1.38.0
+
+Released on May 5th, 2025.
+
+- Added compatibility functions for [bindAll](https://es-toolkit.slash.page/reference/compat/util/bindAll.html), [setWith](https://es-toolkit.slash.page/reference/compat/object/setWith.html), [memoize](https://es-toolkit.slash.page/reference/function/memoize.html), [isNative](https://es-toolkit.slash.page/reference/compat/predicate/isNative.html), [invokeMap](https://es-toolkit.slash.page/reference/compat/array/invokeMap.html), [clone](https://es-toolkit.slash.page/reference/object/clone.html), [cloneWith](https://es-toolkit.slash.page/reference/compat/object/cloneWith.html), and [sortedLastIndexOf](https://es-toolkit.slash.page/reference/compat/array/sortedLastIndexOf.html).
+- Enhanced [invariant](https://es-toolkit.slash.page/reference/util/invariant.html) function to accept Error instances and added [assert](https://es-toolkit.slash.page/reference/util/assert.html) alias.
+- Fixed type definitions and empty array handling in [maxBy](https://es-toolkit.slash.page/reference/array/maxBy.html) and [minBy](https://es-toolkit.slash.page/reference/array/minBy.html).
+- Fixed typo 'Partail' to 'Partial' in [findKey](https://es-toolkit.slash.page/reference/object/findKey.html) type annotation.
+- Enhanced [max](https://es-toolkit.slash.page/reference/math/max.html) and [min](https://es-toolkit.slash.page/reference/math/min.html) functions to skip NaN, symbol, and null values, and return undefined when all values are skipped.
+- Fixed sparse array handling in compat functions to match Lodash's behavior.
+- Improved test coverage and documentation for various functions.
+- Fixed various documentation issues and typos.
+
+We sincerely thank @myungjuice, @scato3, @uniqueeest, @YEONDG, @shren207, @hyesungoh, @kms0219kms, @minjongbaek, @kristian240, @D-Sketon, @Seung-wan, @jiji-hoon96, @raon0211, and @dayongkr for their contributions. We appreciate your great efforts!
+
 ## Version v1.37.2
 
 Released on May 4th, 2025.

package/dist/_chunk/{snakeCase-BwvoPi.js → snakeCase-6cG1f4.js}

@@ -23,7 +23,6 @@ function snakeCase(str) {
     return words$1.map(word => word.toLowerCase()).join('_');
 }
 
-exports.CASE_SPLIT_PATTERN = CASE_SPLIT_PATTERN;
 exports.camelCase = camelCase;
 exports.capitalize = capitalize;
 exports.snakeCase = snakeCase;

package/dist/_chunk/{unary-DzPndU.js → unary-BVQ0iC.js}

@@ -99,21 +99,6 @@ function identity(x) {
     return x;
 }
 
-function memoize(fn, options = {}) {
-    const { cache = new Map(), getCacheKey } = options;
-    const memoizedFn = function (arg) {
-        const key = getCacheKey ? getCacheKey(arg) : arg;
-        if (cache.has(key)) {
-            return cache.get(key);
-        }
-        const result = fn.call(this, arg);
-        cache.set(key, result);
-        return result;
-    };
-    memoizedFn.cache = cache;
-    return memoizedFn;
-}
-
 function negate(func) {
     return ((...args) => !func(...args));
 }
@@ -193,7 +178,6 @@ exports.debounce = debounce;
 exports.flow = flow;
 exports.flowRight = flowRight;
 exports.identity = identity;
-exports.memoize = memoize;
 exports.negate = negate;
 exports.once = once;
 exports.partial = partial;

package/dist/_chunk/{upperFirst-C7IztG.js → upperFirst-Cx78bs.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-const snakeCase = require('./snakeCase-BwvoPi.js');
+const snakeCase = require('./snakeCase-6cG1f4.js');
 
 const deburrMap = new Map(Object.entries({
     Æ: 'Ae',

package/dist/_chunk/{zip-CIqPLd.js → zip-Cyyp17.js}

@@ -151,9 +151,12 @@ function last(arr) {
 }
 
 function maxBy(items, getValue) {
+    if (items.length === 0) {
+        return undefined;
+    }
     let maxElement = items[0];
-    let max = -Infinity;
-    for (let i = 0; i < items.length; i++) {
+    let max = getValue(maxElement);
+    for (let i = 1; i < items.length; i++) {
         const element = items[i];
         const value = getValue(element);
         if (value > max) {
@@ -165,9 +168,12 @@ function maxBy(items, getValue) {
 }
 
 function minBy(items, getValue) {
+    if (items.length === 0) {
+        return undefined;
+    }
     let minElement = items[0];
-    let min = Infinity;
-    for (let i = 0; i < items.length; i++) {
+    let min = getValue(minElement);
+    for (let i = 1; i < items.length; i++) {
         const element = items[i];
         const value = getValue(element);
         if (value < min) {

package/dist/array/at.d.mts

@@ -6,7 +6,7 @@
  * @template T
  * @param {readonly T[]} arr - The array to retrieve elements from.
  * @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
- * @returns {Array<T | undefined>} A new array containing the elements at the specified indices.
+ * @returns {T[]} A new array containing the elements at the specified indices.
  *
  * @example
  * const numbers = [10, 20, 30, 40, 50];

package/dist/array/at.d.ts

@@ -6,7 +6,7 @@
  * @template T
  * @param {readonly T[]} arr - The array to retrieve elements from.
  * @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
- * @returns {Array<T | undefined>} A new array containing the elements at the specified indices.
+ * @returns {T[]} A new array containing the elements at the specified indices.
  *
  * @example
  * const numbers = [10, 20, 30, 40, 50];

package/dist/array/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zip = require('../_chunk/zip-CIqPLd.js');
+const zip = require('../_chunk/zip-Cyyp17.js');
 
 function at(arr, indices) {
     const result = new Array(indices.length);

package/dist/array/maxBy.d.mts

@@ -26,7 +26,8 @@ declare function maxBy<T>(items: readonly [T, ...T[]], getValue: (element: T) =>
  * @template T - The type of elements in the array.
  * @param {T[]} items The array of elements to search.
  * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {T | undefined} The element with the maximum value as determined by the `getValue` function.
+ * @returns {T | undefined} The element with the maximum value as determined by the `getValue` function,
+ * or `undefined` if the array is empty.
  * @example
  * maxBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 3 }
  * maxBy([], x => x.a); // Returns: undefined

package/dist/array/maxBy.d.ts

@@ -26,7 +26,8 @@ declare function maxBy<T>(items: readonly [T, ...T[]], getValue: (element: T) =>
  * @template T - The type of elements in the array.
  * @param {T[]} items The array of elements to search.
  * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {T | undefined} The element with the maximum value as determined by the `getValue` function.
+ * @returns {T | undefined} The element with the maximum value as determined by the `getValue` function,
+ * or `undefined` if the array is empty.
  * @example
  * maxBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 3 }
  * maxBy([], x => x.a); // Returns: undefined

package/dist/array/maxBy.mjs

@@ -1,7 +1,10 @@
 function maxBy(items, getValue) {
+    if (items.length === 0) {
+        return undefined;
+    }
     let maxElement = items[0];
-    let max = -Infinity;
-    for (let i = 0; i < items.length; i++) {
+    let max = getValue(maxElement);
+    for (let i = 1; i < items.length; i++) {
         const element = items[i];
         const value = getValue(element);
         if (value > max) {

package/dist/array/minBy.d.mts

@@ -26,7 +26,8 @@ declare function minBy<T>(items: readonly [T, ...T[]], getValue: (element: T) =>
  * @template T - The type of elements in the array.
  * @param {T[]} items The array of elements to search.
  * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {T | undefined} The element with the minimum value as determined by the `getValue` function.
+ * @returns {T | undefined} The element with the minimum value as determined by the `getValue` function,
+ * or `undefined` if the array is empty.
  * @example
  * minBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 1 }
  * minBy([], x => x.a); // Returns: undefined

package/dist/array/minBy.d.ts

@@ -26,7 +26,8 @@ declare function minBy<T>(items: readonly [T, ...T[]], getValue: (element: T) =>
  * @template T - The type of elements in the array.
  * @param {T[]} items The array of elements to search.
  * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {T | undefined} The element with the minimum value as determined by the `getValue` function.
+ * @returns {T | undefined} The element with the minimum value as determined by the `getValue` function,
+ * or `undefined` if the array is empty.
  * @example
  * minBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 1 }
  * minBy([], x => x.a); // Returns: undefined

package/dist/array/minBy.mjs

@@ -1,7 +1,10 @@
 function minBy(items, getValue) {
+    if (items.length === 0) {
+        return undefined;
+    }
     let minElement = items[0];
-    let min = Infinity;
-    for (let i = 0; i < items.length; i++) {
+    let min = getValue(minElement);
+    for (let i = 1; i < items.length; i++) {
         const element = items[i];
         const value = getValue(element);
         if (value < min) {

package/dist/array/zip.d.mts

@@ -82,5 +82,25 @@ declare function zip<T, U, V>(arr1: readonly T[], arr2: readonly U[], arr3: read
  * // result will be [[1, 'a', true, null], [2, 'b', false, null], [3, 'c', undefined, null]]
  */
 declare function zip<T, U, V, W>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): Array<[T, U, V, W]>;
+/**
+ * Combines multiple arrays into a single array of tuples.
+ *
+ * This function takes multiple arrays and returns a new array where each element is a tuple
+ * containing the corresponding elements from the input arrays. If the input arrays are of
+ * different lengths, the resulting array will have the length of the longest input array,
+ * with undefined values for missing elements.
+ *
+ * @template T
+ * @param {...Array<readonly T[]>} arrs - The arrays to zip together.
+ * @returns {T[][]} A new array of tuples containing the corresponding elements from the input arrays.
+ *
+ * @example
+ * const arr1 = [1, 2, 3];
+ * const arr2 = ['a', 'b', 'c'];
+ * const arr3 = [true, false];
+ * const result = zip(arr1, arr2, arr3);
+ * // result will be [[1, 'a', true], [2, 'b', false], [3, 'c', undefined]]
+ */
+declare function zip<T>(...arrs: Array<readonly T[]>): T[][];
 
 export { zip };

package/dist/array/zip.d.ts

@@ -82,5 +82,25 @@ declare function zip<T, U, V>(arr1: readonly T[], arr2: readonly U[], arr3: read
  * // result will be [[1, 'a', true, null], [2, 'b', false, null], [3, 'c', undefined, null]]
  */
 declare function zip<T, U, V, W>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): Array<[T, U, V, W]>;
+/**
+ * Combines multiple arrays into a single array of tuples.
+ *
+ * This function takes multiple arrays and returns a new array where each element is a tuple
+ * containing the corresponding elements from the input arrays. If the input arrays are of
+ * different lengths, the resulting array will have the length of the longest input array,
+ * with undefined values for missing elements.
+ *
+ * @template T
+ * @param {...Array<readonly T[]>} arrs - The arrays to zip together.
+ * @returns {T[][]} A new array of tuples containing the corresponding elements from the input arrays.
+ *
+ * @example
+ * const arr1 = [1, 2, 3];
+ * const arr2 = ['a', 'b', 'c'];
+ * const arr3 = [true, false];
+ * const result = zip(arr1, arr2, arr3);
+ * // result will be [[1, 'a', true], [2, 'b', false], [3, 'c', undefined]]
+ */
+declare function zip<T>(...arrs: Array<readonly T[]>): T[][];
 
 export { zip };