es-toolkit 1.32.0-dev.1018 → 1.32.0-dev.1020

package/dist/compat/index.d.mts

@@ -8,7 +8,6 @@ export { initial } from '../array/initial.mjs';
 export { isSubset } from '../array/isSubset.mjs';
 export { isSubsetWith } from '../array/isSubsetWith.mjs';
 export { keyBy } from '../array/keyBy.mjs';
-export { maxBy } from '../array/maxBy.mjs';
 export { minBy } from '../array/minBy.mjs';
 export { partition } from '../array/partition.mjs';
 export { pullAt } from '../array/pullAt.mjs';
@@ -53,6 +52,7 @@ export { isBlob } from '../predicate/isBlob.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
 export { isFile } from '../predicate/isFile.mjs';
 export { isFunction } from '../predicate/isFunction.mjs';
+export { isJSON } from '../predicate/isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from '../predicate/isJSONValue.mjs';
 export { isLength } from '../predicate/isLength.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
@@ -155,6 +155,7 @@ export { divide } from './math/divide.mjs';
 export { floor } from './math/floor.mjs';
 export { inRange } from './math/inRange.mjs';
 export { max } from './math/max.mjs';
+export { maxBy } from './math/maxBy.mjs';
 export { min } from './math/min.mjs';
 export { multiply } from './math/multiply.mjs';
 export { parseInt } from './math/parseInt.mjs';

package/dist/compat/index.d.ts

@@ -8,7 +8,6 @@ export { initial } from '../array/initial.js';
 export { isSubset } from '../array/isSubset.js';
 export { isSubsetWith } from '../array/isSubsetWith.js';
 export { keyBy } from '../array/keyBy.js';
-export { maxBy } from '../array/maxBy.js';
 export { minBy } from '../array/minBy.js';
 export { partition } from '../array/partition.js';
 export { pullAt } from '../array/pullAt.js';
@@ -53,6 +52,7 @@ export { isBlob } from '../predicate/isBlob.js';
 export { isEqual } from '../predicate/isEqual.js';
 export { isFile } from '../predicate/isFile.js';
 export { isFunction } from '../predicate/isFunction.js';
+export { isJSON } from '../predicate/isJSON.js';
 export { isJSONArray, isJSONObject, isJSONValue } from '../predicate/isJSONValue.js';
 export { isLength } from '../predicate/isLength.js';
 export { isNotNil } from '../predicate/isNotNil.js';
@@ -155,6 +155,7 @@ export { divide } from './math/divide.js';
 export { floor } from './math/floor.js';
 export { inRange } from './math/inRange.js';
 export { max } from './math/max.js';
+export { maxBy } from './math/maxBy.js';
 export { min } from './math/min.js';
 export { multiply } from './math/multiply.js';
 export { parseInt } from './math/parseInt.js';

package/dist/compat/index.js

@@ -11,7 +11,7 @@ const range$1 = require('../_chunk/range-HnEIT7.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-BQTfB8.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-Xaozpc.js');
-const isWeakSet$1 = require('../_chunk/isWeakSet-DoHqUM.js');
+const isWeakSet$1 = require('../_chunk/isWeakSet-TIM260.js');
 const promise_index = require('../promise/index.js');
 const upperFirst$1 = require('../_chunk/upperFirst-nA5L7X.js');
 const util_index = require('../util/index.js');
@@ -2092,6 +2092,13 @@ function max(items = []) {
     return maxElement;
 }
 
+function maxBy(items, iteratee$1) {
+    if (items == null) {
+        return undefined;
+    }
+    return zipWith.maxBy(Array.from(items), iteratee(iteratee$1));
+}
+
 function min(items = []) {
     let minElement = items[0];
     let min = undefined;
@@ -3323,7 +3330,6 @@ exports.initial = zipWith.initial;
 exports.isSubset = zipWith.isSubset;
 exports.isSubsetWith = zipWith.isSubsetWith;
 exports.keyBy = zipWith.keyBy;
-exports.maxBy = zipWith.maxBy;
 exports.minBy = zipWith.minBy;
 exports.partition = zipWith.partition;
 exports.pullAt = zipWith.pullAt;
@@ -3370,6 +3376,7 @@ exports.isBlob = isWeakSet$1.isBlob;
 exports.isEqual = isWeakSet$1.isEqual;
 exports.isFile = isWeakSet$1.isFile;
 exports.isFunction = isWeakSet$1.isFunction;
+exports.isJSON = isWeakSet$1.isJSON;
 exports.isJSONArray = isWeakSet$1.isJSONArray;
 exports.isJSONObject = isWeakSet$1.isJSONObject;
 exports.isJSONValue = isWeakSet$1.isJSONValue;
@@ -3505,6 +3512,7 @@ exports.mapValues = mapValues;
 exports.matches = matches;
 exports.matchesProperty = matchesProperty;
 exports.max = max;
+exports.maxBy = maxBy;
 exports.merge = merge;
 exports.mergeWith = mergeWith;
 exports.method = method;

package/dist/compat/index.mjs

@@ -8,7 +8,6 @@ export { initial } from '../array/initial.mjs';
 export { isSubset } from '../array/isSubset.mjs';
 export { isSubsetWith } from '../array/isSubsetWith.mjs';
 export { keyBy } from '../array/keyBy.mjs';
-export { maxBy } from '../array/maxBy.mjs';
 export { minBy } from '../array/minBy.mjs';
 export { partition } from '../array/partition.mjs';
 export { pullAt } from '../array/pullAt.mjs';
@@ -55,6 +54,7 @@ export { isEqual } from '../predicate/isEqual.mjs';
 export { eq } from './util/eq.mjs';
 export { isFile } from '../predicate/isFile.mjs';
 export { isFunction } from '../predicate/isFunction.mjs';
+export { isJSON } from '../predicate/isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from '../predicate/isJSONValue.mjs';
 export { isLength } from '../predicate/isLength.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
@@ -157,6 +157,7 @@ export { divide } from './math/divide.mjs';
 export { floor } from './math/floor.mjs';
 export { inRange } from './math/inRange.mjs';
 export { max } from './math/max.mjs';
+export { maxBy } from './math/maxBy.mjs';
 export { min } from './math/min.mjs';
 export { multiply } from './math/multiply.mjs';
 export { parseInt } from './math/parseInt.mjs';

package/dist/compat/math/maxBy.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Finds the element in an array that has the maximum value when applying
+ * the `iteratee` to each element.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @param {((element: T) => number) | keyof T | [keyof T, unknown] | Partial<T>} iteratee
+ * The criteria used to determine the maximum value.
+ *  - If a **function** is provided, it extracts a numeric value from each element.
+ *  - If a **string** is provided, it is treated as a key to extract values from the objects.
+ *  - If a **[key, value]** pair is provided, it matches elements with the specified key-value pair.
+ *  - If an **object** is provided, it matches elements that contain the specified properties.
+ * @returns {T | undefined} The element with the maximum value as determined by the `iteratee`.
+ * @example
+ * maxBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 3 }
+ * maxBy([], x => x.a); // Returns: undefined
+ * maxBy(
+ *   [
+ *     { name: 'john', age: 30 },
+ *     { name: 'jane', age: 28 },
+ *     { name: 'joe', age: 26 },
+ *   ],
+ *   x => x.age
+ * ); // Returns: { name: 'john', age: 30 }
+ * maxBy([{ a: 1 }, { a: 2 }], 'a'); // Returns: { a: 2 }
+ * maxBy([{ a: 1 }, { a: 2 }], ['a', 1]); // Returns: { a: 1 }
+ * maxBy([{ a: 1 }, { a: 2 }], { a: 1 }); // Returns: { a: 1 }
+ */
+declare function maxBy<T>(items: ArrayLike<T> | null | undefined, iteratee: ((element: T) => number) | keyof T | [keyof T, unknown] | Partial<T>): T | undefined;
+
+export { maxBy };

package/dist/compat/math/maxBy.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Finds the element in an array that has the maximum value when applying
+ * the `iteratee` to each element.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items The array of elements to search.
+ * @param {((element: T) => number) | keyof T | [keyof T, unknown] | Partial<T>} iteratee
+ * The criteria used to determine the maximum value.
+ *  - If a **function** is provided, it extracts a numeric value from each element.
+ *  - If a **string** is provided, it is treated as a key to extract values from the objects.
+ *  - If a **[key, value]** pair is provided, it matches elements with the specified key-value pair.
+ *  - If an **object** is provided, it matches elements that contain the specified properties.
+ * @returns {T | undefined} The element with the maximum value as determined by the `iteratee`.
+ * @example
+ * maxBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: { a: 3 }
+ * maxBy([], x => x.a); // Returns: undefined
+ * maxBy(
+ *   [
+ *     { name: 'john', age: 30 },
+ *     { name: 'jane', age: 28 },
+ *     { name: 'joe', age: 26 },
+ *   ],
+ *   x => x.age
+ * ); // Returns: { name: 'john', age: 30 }
+ * maxBy([{ a: 1 }, { a: 2 }], 'a'); // Returns: { a: 2 }
+ * maxBy([{ a: 1 }, { a: 2 }], ['a', 1]); // Returns: { a: 1 }
+ * maxBy([{ a: 1 }, { a: 2 }], { a: 1 }); // Returns: { a: 1 }
+ */
+declare function maxBy<T>(items: ArrayLike<T> | null | undefined, iteratee: ((element: T) => number) | keyof T | [keyof T, unknown] | Partial<T>): T | undefined;
+
+export { maxBy };

package/dist/compat/math/maxBy.mjs

@@ -0,0 +1,11 @@
+import { maxBy as maxBy$1 } from '../../array/maxBy.mjs';
+import { iteratee } from '../util/iteratee.mjs';
+
+function maxBy(items, iteratee$1) {
+    if (items == null) {
+        return undefined;
+    }
+    return maxBy$1(Array.from(items), iteratee(iteratee$1));
+}
+
+export { maxBy };

package/dist/index.d.mts

@@ -119,6 +119,7 @@ export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { isError } from './predicate/isError.mjs';
 export { isFile } from './predicate/isFile.mjs';
 export { isFunction } from './predicate/isFunction.mjs';
+export { isJSON } from './predicate/isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from './predicate/isJSONValue.mjs';
 export { isLength } from './predicate/isLength.mjs';
 export { isMap } from './predicate/isMap.mjs';

package/dist/index.d.ts

@@ -119,6 +119,7 @@ export { isEqualWith } from './predicate/isEqualWith.js';
 export { isError } from './predicate/isError.js';
 export { isFile } from './predicate/isFile.js';
 export { isFunction } from './predicate/isFunction.js';
+export { isJSON } from './predicate/isJSON.js';
 export { isJSONArray, isJSONObject, isJSONValue } from './predicate/isJSONValue.js';
 export { isLength } from './predicate/isLength.js';
 export { isMap } from './predicate/isMap.js';

package/dist/index.js

@@ -14,7 +14,7 @@ const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
 const toMerged = require('./_chunk/toMerged-BQTfB8.js');
 const object_index = require('./object/index.js');
-const isWeakSet = require('./_chunk/isWeakSet-DoHqUM.js');
+const isWeakSet = require('./_chunk/isWeakSet-TIM260.js');
 const predicate_index = require('./predicate/index.js');
 const isPlainObject = require('./_chunk/isPlainObject-Xaozpc.js');
 const delay = require('./_chunk/delay-_VMfFa.js');
@@ -144,6 +144,7 @@ exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;
 exports.isFile = isWeakSet.isFile;
 exports.isFunction = isWeakSet.isFunction;
+exports.isJSON = isWeakSet.isJSON;
 exports.isJSONArray = isWeakSet.isJSONArray;
 exports.isJSONObject = isWeakSet.isJSONObject;
 exports.isJSONValue = isWeakSet.isJSONValue;

package/dist/index.mjs

@@ -119,6 +119,7 @@ export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { isError } from './predicate/isError.mjs';
 export { isFile } from './predicate/isFile.mjs';
 export { isFunction } from './predicate/isFunction.mjs';
+export { isJSON } from './predicate/isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from './predicate/isJSONValue.mjs';
 export { isLength } from './predicate/isLength.mjs';
 export { isMap } from './predicate/isMap.mjs';

package/dist/predicate/index.d.mts

@@ -8,6 +8,7 @@ export { isEqualWith } from './isEqualWith.mjs';
 export { isError } from './isError.mjs';
 export { isFile } from './isFile.mjs';
 export { isFunction } from './isFunction.mjs';
+export { isJSON } from './isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from './isJSONValue.mjs';
 export { isLength } from './isLength.mjs';
 export { isMap } from './isMap.mjs';

package/dist/predicate/index.d.ts

@@ -8,6 +8,7 @@ export { isEqualWith } from './isEqualWith.js';
 export { isError } from './isError.js';
 export { isFile } from './isFile.js';
 export { isFunction } from './isFunction.js';
+export { isJSON } from './isJSON.js';
 export { isJSONArray, isJSONObject, isJSONValue } from './isJSONValue.js';
 export { isLength } from './isLength.js';
 export { isMap } from './isMap.js';

package/dist/predicate/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isWeakSet = require('../_chunk/isWeakSet-DoHqUM.js');
+const isWeakSet = require('../_chunk/isWeakSet-TIM260.js');
 const isPlainObject = require('../_chunk/isPlainObject-Xaozpc.js');
 
 function isBoolean(x) {
@@ -25,6 +25,7 @@ exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;
 exports.isFile = isWeakSet.isFile;
 exports.isFunction = isWeakSet.isFunction;
+exports.isJSON = isWeakSet.isJSON;
 exports.isJSONArray = isWeakSet.isJSONArray;
 exports.isJSONObject = isWeakSet.isJSONObject;
 exports.isJSONValue = isWeakSet.isJSONValue;

package/dist/predicate/index.mjs

@@ -8,6 +8,7 @@ export { isEqualWith } from './isEqualWith.mjs';
 export { isError } from './isError.mjs';
 export { isFile } from './isFile.mjs';
 export { isFunction } from './isFunction.mjs';
+export { isJSON } from './isJSON.mjs';
 export { isJSONArray, isJSONObject, isJSONValue } from './isJSONValue.mjs';
 export { isLength } from './isLength.mjs';
 export { isMap } from './isMap.mjs';

package/dist/predicate/isJSON.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Checks if a given value is a valid JSON string.
+ *
+ * A valid JSON string is one that can be successfully parsed using `JSON.parse()`. According to JSON
+ * specifications, valid JSON can represent:
+ * - Objects (with string keys and valid JSON values)
+ * - Arrays (containing valid JSON values)
+ * - Strings
+ * - Numbers
+ * - Booleans
+ * - null
+ *
+ * String values like `"null"`, `"true"`, `"false"`, and numeric strings (e.g., `"42"`) are considered
+ * valid JSON and will return true.
+ *
+ * This function serves as a type guard in TypeScript, narrowing the type of the argument to `string`.
+ *
+ * @param {unknown} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is a valid JSON string, else `false`.
+ *
+ * @example
+ * isJSON('{"name":"John","age":30}'); // true
+ * isJSON('[1,2,3]'); // true
+ * isJSON('true'); // true
+ * isJSON('invalid json'); // false
+ * isJSON({ name: 'John' }); // false (not a string)
+ * isJSON(null); // false (not a string)
+ */
+declare function isJSON(value: unknown): value is string;
+
+export { isJSON };

package/dist/predicate/isJSON.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Checks if a given value is a valid JSON string.
+ *
+ * A valid JSON string is one that can be successfully parsed using `JSON.parse()`. According to JSON
+ * specifications, valid JSON can represent:
+ * - Objects (with string keys and valid JSON values)
+ * - Arrays (containing valid JSON values)
+ * - Strings
+ * - Numbers
+ * - Booleans
+ * - null
+ *
+ * String values like `"null"`, `"true"`, `"false"`, and numeric strings (e.g., `"42"`) are considered
+ * valid JSON and will return true.
+ *
+ * This function serves as a type guard in TypeScript, narrowing the type of the argument to `string`.
+ *
+ * @param {unknown} value The value to check.
+ * @returns {boolean} Returns `true` if `value` is a valid JSON string, else `false`.
+ *
+ * @example
+ * isJSON('{"name":"John","age":30}'); // true
+ * isJSON('[1,2,3]'); // true
+ * isJSON('true'); // true
+ * isJSON('invalid json'); // false
+ * isJSON({ name: 'John' }); // false (not a string)
+ * isJSON(null); // false (not a string)
+ */
+declare function isJSON(value: unknown): value is string;
+
+export { isJSON };

package/dist/predicate/isJSON.mjs

@@ -0,0 +1,14 @@
+function isJSON(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+export { isJSON };

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.32.0-dev.1018+e9e57e9c",
+  "version": "1.32.0-dev.1020+a1334be2",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {