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

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');
@@ -2298,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.808+402f604b",
+  "version": "1.25.2-dev.809+e71f7064",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {