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

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

@@ -110,7 +110,7 @@ declare function every<T extends Record<string, unknown>>(object: T | null | und
  *
  * @template T
  * @param {T | null | undefined} object - The object to check through.
- * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
  * @example
@@ -119,7 +119,7 @@ declare function every<T extends Record<string, unknown>>(object: T | null | und
  * const result = every(obj, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): boolean;
 /**
  * Checks if every item in an object has a specific property, where the property name is provided as a string.
  *

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

@@ -110,7 +110,7 @@ declare function every<T extends Record<string, unknown>>(object: T | null | und
  *
  * @template T
  * @param {T | null | undefined} object - The object to check through.
- * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {boolean} - `true` if every item has the specified property value, or `false` if at least one item does not match.
  *
  * @example
@@ -119,7 +119,7 @@ declare function every<T extends Record<string, unknown>>(object: T | null | und
  * const result = every(obj, ['name', 'Alice']);
  * console.log(result); // false
  */
-declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): boolean;
+declare function every<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): boolean;
 /**
  * Checks if every item in an object has a specific property, where the property name is provided as a string.
  *

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

@@ -90,7 +90,7 @@ declare function filter<T extends Record<string, unknown>>(object: T | null | un
  *
  * @template T
  * @param {T | null | undefined} object - The object to iterate over.
- * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
  * @example
@@ -98,7 +98,7 @@ declare function filter<T extends Record<string, unknown>>(object: T | null | un
  * filter(obj, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): T[];
 /**
  * Filters the object, returning elements that contain the given property name.
  *

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

@@ -90,7 +90,7 @@ declare function filter<T extends Record<string, unknown>>(object: T | null | un
  *
  * @template T
  * @param {T | null | undefined} object - The object to iterate over.
- * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
  * @example
@@ -98,7 +98,7 @@ declare function filter<T extends Record<string, unknown>>(object: T | null | un
  * filter(obj, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): T[];
 /**
  * Filters the object, returning elements that contain the given property name.
  *

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

@@ -93,7 +93,7 @@ declare function find<T extends Record<string, unknown>>(object: T | null | unde
  *
  * @template T
  * @param {T | null | undefined} object - The object to search through.
- * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
  * @example
@@ -102,7 +102,7 @@ declare function find<T extends Record<string, unknown>>(object: T | null | unde
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): T | undefined;
 /**
  * Finds the first item in an object that has a specific property, where the property name is provided as a string.
  *

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

@@ -93,7 +93,7 @@ declare function find<T extends Record<string, unknown>>(object: T | null | unde
  *
  * @template T
  * @param {T | null | undefined} object - The object to search through.
- * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @param {[keyof T[keyof T], unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
  * @example
@@ -102,7 +102,7 @@ declare function find<T extends Record<string, unknown>>(object: T | null | unde
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): T | undefined;
 /**
  * Finds the first item in an object that has a specific property, where the property name is provided as a string.
  *

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.810+4a8ea44e",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {