es-toolkit 1.25.2-dev.807 → 1.25.2-dev.809

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

@@ -7,9 +7,10 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
  * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @param {unknown | unknown[]} orders - An array of order directions ('asc' for ascending or 'desc' for descending).
+ * @param {unknown} [guard] Enables use as an iteratee for methods like `_.reduce`.
  * @returns {T[]} - The sorted array.
  *
  * @example
@@ -29,6 +30,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T = any>(collection: ArrayLike<T> | object | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[], guard?: unknown): T[];
 
 export { type Criterion, orderBy };

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

@@ -7,9 +7,10 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
  * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @param {unknown | unknown[]} orders - An array of order directions ('asc' for ascending or 'desc' for descending).
+ * @param {unknown} [guard] Enables use as an iteratee for methods like `_.reduce`.
  * @returns {T[]} - The sorted array.
  *
  * @example
@@ -29,6 +30,6 @@ type Criterion<T> = ((item: T) => unknown) | PropertyKey | PropertyKey[] | null
  * //   { user: 'fred', age: 40 },
  * // ]
  */
-declare function orderBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[]): T[];
+declare function orderBy<T = any>(collection: ArrayLike<T> | object | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>, orders?: unknown | unknown[], guard?: unknown): T[];
 
 export { type Criterion, orderBy };

package/dist/compat/array/orderBy.mjs

@@ -2,16 +2,20 @@ import { compareValues } from '../_internal/compareValues.mjs';
 import { isKey } from '../_internal/isKey.mjs';
 import { toPath } from '../util/toPath.mjs';
 
-function orderBy(collection, criteria, orders) {
-    if (collection == null || typeof collection === 'number') {
+function orderBy(collection, criteria, orders, guard) {
+    if (collection == null) {
         return [];
     }
-    if (typeof collection === 'object' && !Array.isArray(collection)) {
+    orders = guard ? undefined : orders;
+    if (!Array.isArray(collection)) {
         collection = Object.values(collection);
     }
     if (!Array.isArray(criteria)) {
         criteria = criteria == null ? [null] : [criteria];
     }
+    if (criteria.length === 0) {
+        criteria = [null];
+    }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }

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

@@ -8,8 +8,8 @@ import { Criterion } from './orderBy.mjs';
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
- * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {Array<Array<Criterion<T> | Criterion<T>>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @returns {T[]} - The ascending sorted array.
  *
  * @example
@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.mjs';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T = any>(collection: ArrayLike<T> | object | null | undefined, ...criteria: Array<Criterion<T> | Array<Criterion<T>>>): T[];
 
 export { sortBy };

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

@@ -8,8 +8,8 @@ import { Criterion } from './orderBy.js';
  * If values for a key are equal, it moves to the next key to determine the order.
  *
  * @template T - The type of elements in the array.
- * @param { T[] | object | null | undefined} collection - The array of objects to be sorted.
- * @param {Criterion<T> | Array<Criterion<T>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
+ * @param {ArrayLike<T> | object | null | undefined} collection - The array of objects to be sorted.
+ * @param {Array<Array<Criterion<T> | Criterion<T>>>} criteria - An array of criteria (property names or property paths or custom key functions) to sort by.
  * @returns {T[]} - The ascending sorted array.
  *
  * @example
@@ -29,6 +29,6 @@ import { Criterion } from './orderBy.js';
  * //   { user: 'fred', age: 48 },
  * // ]
  */
-declare function sortBy<T>(collection: readonly T[] | object | number | null | undefined, criteria?: Criterion<T> | Array<Criterion<T>>): T[];
+declare function sortBy<T = any>(collection: ArrayLike<T> | object | null | undefined, ...criteria: Array<Criterion<T> | Array<Criterion<T>>>): T[];
 
 export { sortBy };

package/dist/compat/array/sortBy.mjs

@@ -1,7 +1,16 @@
 import { orderBy } from './orderBy.mjs';
+import { flatten } from '../../array/flatten.mjs';
+import { isIterateeCall } from '../_internal/isIterateeCall.mjs';
 
-function sortBy(collection, criteria) {
-    return orderBy(collection, criteria, ['asc']);
+function sortBy(collection, ...criteria) {
+    const length = criteria.length;
+    if (length > 1 && isIterateeCall(collection, criteria[0], criteria[1])) {
+        criteria = [];
+    }
+    else if (length > 2 && isIterateeCall(criteria[0], criteria[1], criteria[2])) {
+        criteria = [criteria[0]];
+    }
+    return orderBy(collection, flatten(criteria), ['asc']);
 }
 
 export { sortBy };

package/dist/compat/index.d.mts

@@ -45,6 +45,8 @@ export { partialRight } from '../function/partialRight.mjs';
 export { unary } from '../function/unary.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
+export { median } from '../math/median.mjs';
+export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { range } from '../math/range.mjs';
 export { rangeRight } from '../math/rangeRight.mjs';

package/dist/compat/index.d.ts

@@ -45,6 +45,8 @@ export { partialRight } from '../function/partialRight.js';
 export { unary } from '../function/unary.js';
 export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
+export { median } from '../math/median.js';
+export { medianBy } from '../math/medianBy.js';
 export { randomInt } from '../math/randomInt.js';
 export { range } from '../math/range.js';
 export { rangeRight } from '../math/rangeRight.js';

package/dist/compat/index.js

@@ -6,7 +6,7 @@ const zipWith = require('../_chunk/zipWith-Dkv3D1.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
 const unary = require('../_chunk/unary-CMvKXy.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const sumBy = require('../_chunk/sumBy-BkErWJ.js');
+const sumBy = require('../_chunk/sumBy-RVppiV.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-wNz52b.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
@@ -886,16 +886,20 @@ function isKey(value, object) {
         (object != null));
 }
 
-function orderBy(collection, criteria, orders) {
-    if (collection == null || typeof collection === 'number') {
+function orderBy(collection, criteria, orders, guard) {
+    if (collection == null) {
         return [];
     }
-    if (typeof collection === 'object' && !Array.isArray(collection)) {
+    orders = guard ? undefined : orders;
+    if (!Array.isArray(collection)) {
         collection = Object.values(collection);
     }
     if (!Array.isArray(criteria)) {
         criteria = criteria == null ? [null] : [criteria];
     }
+    if (criteria.length === 0) {
+        criteria = [null];
+    }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }
@@ -1051,8 +1055,15 @@ function some(source, predicate, guard) {
     }
 }
 
-function sortBy(collection, criteria) {
-    return orderBy(collection, criteria, ['asc']);
+function sortBy(collection, ...criteria) {
+    const length = criteria.length;
+    if (length > 1 && isIterateeCall(collection, criteria[0], criteria[1])) {
+        criteria = [];
+    }
+    else if (length > 2 && isIterateeCall(criteria[0], criteria[1], criteria[2])) {
+        criteria = [criteria[0]];
+    }
+    return orderBy(collection, zipWith.flatten(criteria), ['asc']);
 }
 
 function tail(arr) {
@@ -2287,6 +2298,8 @@ exports.unary = unary.unary;
 exports.noop = noop.noop;
 exports.mean = sumBy.mean;
 exports.meanBy = sumBy.meanBy;
+exports.median = sumBy.median;
+exports.medianBy = sumBy.medianBy;
 exports.range = sumBy.range;
 exports.rangeRight = sumBy.rangeRight;
 exports.sum = sumBy.sum;

package/dist/compat/index.mjs

@@ -45,6 +45,8 @@ export { partialRight } from '../function/partialRight.mjs';
 export { unary } from '../function/unary.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
+export { median } from '../math/median.mjs';
+export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { range } from '../math/range.mjs';
 export { rangeRight } from '../math/rangeRight.mjs';

package/dist/index.d.mts

@@ -78,6 +78,8 @@ export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';
 export { meanBy } from './math/meanBy.mjs';
+export { median } from './math/median.mjs';
+export { medianBy } from './math/medianBy.mjs';
 export { random } from './math/random.mjs';
 export { randomInt } from './math/randomInt.mjs';
 export { range } from './math/range.mjs';

package/dist/index.d.ts

@@ -78,6 +78,8 @@ export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';
 export { mean } from './math/mean.js';
 export { meanBy } from './math/meanBy.js';
+export { median } from './math/median.js';
+export { medianBy } from './math/medianBy.js';
 export { random } from './math/random.js';
 export { randomInt } from './math/randomInt.js';
 export { range } from './math/range.js';

package/dist/index.js

@@ -8,7 +8,7 @@ const promise_index = require('./_chunk/index-BGZDR9.js');
 const unary = require('./_chunk/unary-CMvKXy.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
-const sumBy = require('./_chunk/sumBy-BkErWJ.js');
+const sumBy = require('./_chunk/sumBy-RVppiV.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
 const toMerged = require('./_chunk/toMerged-wNz52b.js');
@@ -104,6 +104,8 @@ exports.clamp = sumBy.clamp;
 exports.inRange = sumBy.inRange;
 exports.mean = sumBy.mean;
 exports.meanBy = sumBy.meanBy;
+exports.median = sumBy.median;
+exports.medianBy = sumBy.medianBy;
 exports.range = sumBy.range;
 exports.rangeRight = sumBy.rangeRight;
 exports.sum = sumBy.sum;

package/dist/index.mjs

@@ -78,6 +78,8 @@ export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';
 export { meanBy } from './math/meanBy.mjs';
+export { median } from './math/median.mjs';
+export { medianBy } from './math/medianBy.mjs';
 export { random } from './math/random.mjs';
 export { randomInt } from './math/randomInt.mjs';
 export { range } from './math/range.mjs';

package/dist/math/index.d.mts

@@ -2,6 +2,8 @@ export { clamp } from './clamp.mjs';
 export { inRange } from './inRange.mjs';
 export { mean } from './mean.mjs';
 export { meanBy } from './meanBy.mjs';
+export { median } from './median.mjs';
+export { medianBy } from './medianBy.mjs';
 export { random } from './random.mjs';
 export { randomInt } from './randomInt.mjs';
 export { range } from './range.mjs';

package/dist/math/index.d.ts

@@ -2,6 +2,8 @@ export { clamp } from './clamp.js';
 export { inRange } from './inRange.js';
 export { mean } from './mean.js';
 export { meanBy } from './meanBy.js';
+export { median } from './median.js';
+export { medianBy } from './medianBy.js';
 export { random } from './random.js';
 export { randomInt } from './randomInt.js';
 export { range } from './range.js';

package/dist/math/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const sumBy = require('../_chunk/sumBy-BkErWJ.js');
+const sumBy = require('../_chunk/sumBy-RVppiV.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
 function round(value, precision = 0) {
@@ -17,6 +17,8 @@ exports.clamp = sumBy.clamp;
 exports.inRange = sumBy.inRange;
 exports.mean = sumBy.mean;
 exports.meanBy = sumBy.meanBy;
+exports.median = sumBy.median;
+exports.medianBy = sumBy.medianBy;
 exports.range = sumBy.range;
 exports.rangeRight = sumBy.rangeRight;
 exports.sum = sumBy.sum;

package/dist/math/index.mjs

@@ -2,6 +2,8 @@ export { clamp } from './clamp.mjs';
 export { inRange } from './inRange.mjs';
 export { mean } from './mean.mjs';
 export { meanBy } from './meanBy.mjs';
+export { median } from './median.mjs';
+export { medianBy } from './medianBy.mjs';
 export { random } from './random.mjs';
 export { randomInt } from './randomInt.mjs';
 export { range } from './range.mjs';

package/dist/math/median.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Calculates the median of an array of numbers.
+ *
+ * The median is the middle value of a sorted array.
+ * If the array has an odd number of elements, the median is the middle value.
+ * If the array has an even number of elements, it returns the average of the two middle values.
+ *
+ * If the array is empty, this function returns `NaN`.
+ *
+ * @param {number[]} nums - An array of numbers to calculate the median.
+ * @returns {number} The median of all the numbers in the array.
+ *
+ * @example
+ * const arrayWithOddNumberOfElements = [1, 2, 3, 4, 5];
+ * const result = median(arrayWithOddNumberOfElements);
+ * // result will be 3
+ *
+ * @example
+ * const arrayWithEvenNumberOfElements = [1, 2, 3, 4];
+ * const result = median(arrayWithEvenNumberOfElements);
+ * // result will be 2.5
+ */
+declare function median(nums: readonly number[]): number;
+
+export { median };

package/dist/math/median.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Calculates the median of an array of numbers.
+ *
+ * The median is the middle value of a sorted array.
+ * If the array has an odd number of elements, the median is the middle value.
+ * If the array has an even number of elements, it returns the average of the two middle values.
+ *
+ * If the array is empty, this function returns `NaN`.
+ *
+ * @param {number[]} nums - An array of numbers to calculate the median.
+ * @returns {number} The median of all the numbers in the array.
+ *
+ * @example
+ * const arrayWithOddNumberOfElements = [1, 2, 3, 4, 5];
+ * const result = median(arrayWithOddNumberOfElements);
+ * // result will be 3
+ *
+ * @example
+ * const arrayWithEvenNumberOfElements = [1, 2, 3, 4];
+ * const result = median(arrayWithEvenNumberOfElements);
+ * // result will be 2.5
+ */
+declare function median(nums: readonly number[]): number;
+
+export { median };

package/dist/math/median.mjs

@@ -0,0 +1,15 @@
+function median(nums) {
+    if (nums.length === 0) {
+        return NaN;
+    }
+    const sorted = nums.slice().sort((a, b) => a - b);
+    const middleIndex = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        return (sorted[middleIndex - 1] + sorted[middleIndex]) / 2;
+    }
+    else {
+        return sorted[middleIndex];
+    }
+}
+
+export { median };

package/dist/math/medianBy.d.mts

@@ -0,0 +1,23 @@
+/**
+ * Calculates the median of an array of elements when applying
+ * the `getValue` function to each element.
+ *
+ * The median is the middle value of a sorted array.
+ * If the array has an odd number of elements, the median is the middle value.
+ * If the array has an even number of elements, it returns the average of the two middle values.
+ *
+ * If the array is empty, this function returns `NaN`.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items An array to calculate the median.
+ * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
+ * @returns {number} The median of all the numbers as determined by the `getValue` function.
+ *
+ * @example
+ * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3
+ * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }], x => x.a); // Returns: 2.5
+ * medianBy([], x => x.a); // Returns: NaN
+ */
+declare function medianBy<T>(items: readonly T[], getValue: (element: T) => number): number;
+
+export { medianBy };

package/dist/math/medianBy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Calculates the median of an array of elements when applying
+ * the `getValue` function to each element.
+ *
+ * The median is the middle value of a sorted array.
+ * If the array has an odd number of elements, the median is the middle value.
+ * If the array has an even number of elements, it returns the average of the two middle values.
+ *
+ * If the array is empty, this function returns `NaN`.
+ *
+ * @template T - The type of elements in the array.
+ * @param {T[]} items An array to calculate the median.
+ * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
+ * @returns {number} The median of all the numbers as determined by the `getValue` function.
+ *
+ * @example
+ * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3
+ * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }], x => x.a); // Returns: 2.5
+ * medianBy([], x => x.a); // Returns: NaN
+ */
+declare function medianBy<T>(items: readonly T[], getValue: (element: T) => number): number;
+
+export { medianBy };

package/dist/math/medianBy.mjs

@@ -0,0 +1,8 @@
+import { median } from './median.mjs';
+
+function medianBy(items, getValue) {
+    const nums = items.map(x => getValue(x));
+    return median(nums);
+}
+
+export { medianBy };

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.25.2-dev.807+4b74386c",
+  "version": "1.25.2-dev.809+e71f7064",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {