es-toolkit 1.11.0-dev.261 → 1.11.0-dev.264

package/dist/array/index.mjs

@@ -1,7 +1,4 @@
 import "../chunk-DDH7K4QM.mjs";
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
 import {
   xor
 } from "../chunk-L7FQX5MN.mjs";
@@ -20,18 +17,12 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
-import {
-  union
-} from "../chunk-R6QA7PLZ.mjs";
 import {
   unionBy
 } from "../chunk-NFS7RWWE.mjs";
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
-import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
 import {
   uniqBy
 } from "../chunk-B4COTK4K.mjs";
@@ -45,10 +36,8 @@ import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import "../chunk-GIWAOOFY.mjs";
-import "../chunk-SYWMYQYJ.mjs";
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
@@ -71,8 +60,11 @@ import {
   toFilled
 } from "../chunk-OP4OAKQJ.mjs";
 import {
-  intersectionWith
-} from "../chunk-XI7KRD2C.mjs";
+  union
+} from "../chunk-R6QA7PLZ.mjs";
+import {
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
   keyBy
 } from "../chunk-AJKZMN2V.mjs";
@@ -95,8 +87,10 @@ import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import "../chunk-GIWAOOFY.mjs";
+import "../chunk-SYWMYQYJ.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -116,8 +110,8 @@ import {
   intersectionBy
 } from "../chunk-O6UXZR3U.mjs";
 import {
-  differenceWith
-} from "../chunk-6NVQAHXP.mjs";
+  intersectionWith
+} from "../chunk-XI7KRD2C.mjs";
 import {
   drop
 } from "../chunk-3EZAFZG3.mjs";
@@ -136,6 +130,9 @@ import {
 import {
   flatMap
 } from "../chunk-UY76KTPE.mjs";
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
@@ -154,6 +151,9 @@ import {
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
+import {
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
 import "../chunk-424M7IR7.mjs";
 export {
   chunk,

package/dist/compat/index.d.mts

@@ -465,4 +465,36 @@ declare const startsWith: (str: string, target: string, position?: number) => bo
  */
 declare const endsWith: (str: string, target: string, position?: number) => boolean;
 
-export { chunk, endsWith, get, set, startsWith, zipObjectDeep };
+/**
+ * Finds the element in an array that has the maximum value.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @returns {T} The element with the maximum value.
+ * @example
+ * // Returns 9
+ * max([3, 1, 4, 1, 5, 9])
+ *
+ * @example
+ * // Returns 8
+ * max([0, -3, 2, 8, 7])
+ */
+declare function max<T>(items?: readonly T[]): T;
+
+/**
+ * Finds the element in an array that has the minimum value.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @returns {T} The element with the minimum value.
+ * @example
+ * // Returns 1
+ * min([3, 1, 4, 1, 5, 9])
+ *
+ * @example
+ * // Returns -3
+ * min([0, -3, 2, 8, 7])
+ */
+declare function min<T>(items?: readonly T[]): T;
+
+export { chunk, endsWith, get, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.d.ts

@@ -465,4 +465,36 @@ declare const startsWith: (str: string, target: string, position?: number) => bo
  */
 declare const endsWith: (str: string, target: string, position?: number) => boolean;
 
-export { chunk, endsWith, get, set, startsWith, zipObjectDeep };
+/**
+ * Finds the element in an array that has the maximum value.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @returns {T} The element with the maximum value.
+ * @example
+ * // Returns 9
+ * max([3, 1, 4, 1, 5, 9])
+ *
+ * @example
+ * // Returns 8
+ * max([0, -3, 2, 8, 7])
+ */
+declare function max<T>(items?: readonly T[]): T;
+
+/**
+ * Finds the element in an array that has the minimum value.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @returns {T} The element with the minimum value.
+ * @example
+ * // Returns 1
+ * min([3, 1, 4, 1, 5, 9])
+ *
+ * @example
+ * // Returns -3
+ * min([0, -3, 2, 8, 7])
+ */
+declare function min<T>(items?: readonly T[]): T;
+
+export { chunk, endsWith, get, max, min, set, startsWith, zipObjectDeep };

package/dist/compat/index.js

@@ -96,9 +96,11 @@ __export(compat_exports, {
   keyBy: () => keyBy,
   last: () => last,
   lowerCase: () => lowerCase,
+  max: () => max,
   maxBy: () => maxBy,
   mean: () => mean,
   meanBy: () => meanBy,
+  min: () => min,
   minBy: () => minBy,
   negate: () => negate,
   noop: () => noop,
@@ -338,11 +340,11 @@ function keyBy(arr, getKeyFromItem) {
 // src/array/maxBy.ts
 function maxBy(items, getValue) {
   let maxElement = items[0];
-  let max = -Infinity;
+  let max2 = -Infinity;
   for (const element of items) {
     const value = getValue(element);
-    if (value > max) {
-      max = value;
+    if (value > max2) {
+      max2 = value;
       maxElement = element;
     }
   }
@@ -352,11 +354,11 @@ function maxBy(items, getValue) {
 // src/array/minBy.ts
 function minBy(items, getValue) {
   let minElement = items[0];
-  let min = Infinity;
+  let min2 = Infinity;
   for (const element of items) {
     const value = getValue(element);
-    if (value < min) {
-      min = value;
+    if (value < min2) {
+      min2 = value;
       minElement = element;
     }
   }
@@ -1204,6 +1206,32 @@ var startsWith = (str, target, position = 0) => {
 var endsWith = (str, target, position = str.length) => {
   return str.endsWith(target, position);
 };
+
+// src/compat/math/max.ts
+function max(items = []) {
+  let maxElement = items[0];
+  let max2 = void 0;
+  for (const element of items) {
+    if (max2 == null || element > max2) {
+      max2 = element;
+      maxElement = element;
+    }
+  }
+  return maxElement;
+}
+
+// src/compat/math/min.ts
+function min(items = []) {
+  let minElement = items[0];
+  let min2 = void 0;
+  for (const element of items) {
+    if (min2 == null || element < min2) {
+      min2 = element;
+      minElement = element;
+    }
+  }
+  return minElement;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AbortError,
@@ -1248,9 +1276,11 @@ var endsWith = (str, target, position = str.length) => {
   keyBy,
   last,
   lowerCase,
+  max,
   maxBy,
   mean,
   meanBy,
+  min,
   minBy,
   negate,
   noop,