es-toolkit 1.11.0 → 1.12.0-dev.267

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # es-toolkit Changelog
 
+## Version v1.12.0
+
+Released on July 19th, 2024.
+
+- Fixed a bug where `es-toolkit/compat` was not available in modern Node.js environments.
+- Added support for [max](https://es-toolkit.slash.page/reference/compat/math/max.html) and [min](https://es-toolkit.slash.page/reference/compat/math/min.html) in our compatibility layer `es-toolkit/compat`. ([e1e6e38](https://github.com/toss/es-toolkit/commit/e1e6e38206750fb90f5b99cace9196635288e21c))
+
 ## Version v1.11.0
 
 Released on July 18th, 2024.

package/dist/array/index.mjs

@@ -1,4 +1,13 @@
 import "../chunk-DDH7K4QM.mjs";
+import {
+  zipWith
+} from "../chunk-4KYXHZ4R.mjs";
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
+import {
+  unzipWith
+} from "../chunk-IFNXROZR.mjs";
 import {
   without
 } from "../chunk-PYEYV7BY.mjs";
@@ -18,8 +27,11 @@ import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
-  zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+  takeWhile
+} from "../chunk-2IXFGSUA.mjs";
+import {
+  toFilled
+} from "../chunk-OP4OAKQJ.mjs";
 import {
   union
 } from "../chunk-R6QA7PLZ.mjs";
@@ -39,11 +51,11 @@ import {
   uniqWith
 } from "../chunk-237HGSZS.mjs";
 import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
 import {
   sampleSize
 } from "../chunk-EHSKB6DF.mjs";
@@ -65,11 +77,11 @@ import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
 import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
-  toFilled
-} from "../chunk-OP4OAKQJ.mjs";
+  intersectionBy
+} from "../chunk-O6UXZR3U.mjs";
 import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
@@ -89,14 +101,14 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
-import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
+  flatMap
+} from "../chunk-UY76KTPE.mjs";
 import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
+import {
+  flatten
+} from "../chunk-33MSBDC6.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -110,11 +122,11 @@ import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
 import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
+  difference
+} from "../chunk-JPUKH67K.mjs";
 import {
-  intersectionBy
-} from "../chunk-O6UXZR3U.mjs";
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
@@ -133,12 +145,6 @@ import {
 import {
   fill
 } from "../chunk-YFN6KOC4.mjs";
-import {
-  flatMap
-} from "../chunk-UY76KTPE.mjs";
-import {
-  flatten
-} from "../chunk-33MSBDC6.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -148,12 +154,6 @@ import {
 import {
   countBy
 } from "../chunk-CRSKT4WW.mjs";
-import {
-  difference
-} from "../chunk-JPUKH67K.mjs";
-import {
-  differenceBy
-} from "../chunk-LVWX5B43.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,