es-toolkit 1.18.0-dev.575 → 1.18.0-dev.577

package/dist/compat/_internal/decimalAdjust.mjs

@@ -0,0 +1,19 @@
+function decimalAdjust(type, number, precision = 0) {
+    number = Number(number);
+    if (Object.is(number, -0)) {
+        number = '-0';
+    }
+    precision = Math.min(Number.parseInt(precision, 10), 292);
+    if (precision) {
+        const [magnitude, exponent = 0] = number.toString().split('e');
+        let adjustedValue = Math[type](Number(`${magnitude}e${Number(exponent) + precision}`));
+        if (Object.is(adjustedValue, -0)) {
+            adjustedValue = '-0';
+        }
+        const [newMagnitude, newExponent = 0] = adjustedValue.toString().split('e');
+        return Number(`${newMagnitude}e${Number(newExponent) - precision}`);
+    }
+    return Math[type](Number(number));
+}
+
+export { decimalAdjust };

package/dist/compat/index.d.mts

@@ -66,7 +66,6 @@ export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
 export { random } from '../math/random.mjs';
 export { randomInt } from '../math/randomInt.mjs';
-export { round } from '../math/round.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
 export { range } from '../math/range.mjs';
@@ -163,4 +162,7 @@ export { padEnd } from './string/padEnd.mjs';
 export { repeat } from './string/repeat.mjs';
 export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
+export { ceil } from './math/ceil.mjs';
+export { floor } from './math/floor.mjs';
+export { round } from './math/round.mjs';
 export { parseInt } from './math/parseInt.mjs';

package/dist/compat/index.d.ts

@@ -66,7 +66,6 @@ export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
 export { random } from '../math/random.js';
 export { randomInt } from '../math/randomInt.js';
-export { round } from '../math/round.js';
 export { sum } from '../math/sum.js';
 export { sumBy } from '../math/sumBy.js';
 export { range } from '../math/range.js';
@@ -163,4 +162,7 @@ export { padEnd } from './string/padEnd.js';
 export { repeat } from './string/repeat.js';
 export { max } from './math/max.js';
 export { min } from './math/min.js';
+export { ceil } from './math/ceil.js';
+export { floor } from './math/floor.js';
+export { round } from './math/round.js';
 export { parseInt } from './math/parseInt.js';

package/dist/compat/index.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const zipWith = require('../_chunk/zipWith-CYaH1Y.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
 const rest$1 = require('../_chunk/rest-CXt9w3.js');
-const math_index = require('../math/index.js');
+const range = require('../_chunk/range-BXlMmn.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-Bmrr2j.js');
 const isWeakSet$1 = require('../_chunk/isWeakSet-BerD1A.js');
@@ -782,19 +782,39 @@ function rearg(func, ...indices) {
     };
 }
 
-function pick(obj, ...keys) {
-    if (isWeakSet$1.isNil(obj)) {
+function isNil(x) {
+    return x == null;
+}
+
+function pick(obj, ...keysArr) {
+    if (isNil(obj)) {
         return {};
     }
-    const typedObject = obj;
     const result = {};
-    const flattenArgs = zipWith.flattenDeep(keys.map(arg => (typeof arg === 'object' ? Array.from(arg) : arg)));
-    for (const arg of flattenArgs) {
-        if (String(arg).includes('.') && arg in typedObject) {
-            result[arg] = get(typedObject, arg);
-            continue;
+    for (let keys of keysArr) {
+        switch (typeof keys) {
+            case 'object': {
+                if (!Array.isArray(keys)) {
+                    keys = Array.from(keys);
+                }
+                break;
+            }
+            case 'string':
+            case 'symbol':
+            case 'number': {
+                keys = [keys];
+                break;
+            }
+        }
+        for (const key of keys) {
+            const value = get(obj, key);
+            if (typeof key === 'string' && Object.prototype.hasOwnProperty.call(obj, key)) {
+                result[key] = value;
+            }
+            else {
+                set(result, key, value);
+            }
         }
-        set(result, arg, get(typedObject, arg));
     }
     return result;
 }
@@ -1064,6 +1084,36 @@ function min(items = []) {
     return minElement;
 }
 
+function decimalAdjust(type, number, precision = 0) {
+    number = Number(number);
+    if (Object.is(number, -0)) {
+        number = '-0';
+    }
+    precision = Math.min(Number.parseInt(precision, 10), 292);
+    if (precision) {
+        const [magnitude, exponent = 0] = number.toString().split('e');
+        let adjustedValue = Math[type](Number(`${magnitude}e${Number(exponent) + precision}`));
+        if (Object.is(adjustedValue, -0)) {
+            adjustedValue = '-0';
+        }
+        const [newMagnitude, newExponent = 0] = adjustedValue.toString().split('e');
+        return Number(`${newMagnitude}e${Number(newExponent) - precision}`);
+    }
+    return Math[type](Number(number));
+}
+
+function ceil(number, precision = 0) {
+    return decimalAdjust('ceil', number, precision);
+}
+
+function floor(number, precision = 0) {
+    return decimalAdjust('floor', number, precision);
+}
+
+function round(number, precision = 0) {
+    return decimalAdjust('round', number, precision);
+}
+
 function parseInt(string, radix = 0, guard) {
     if (guard) {
         radix = 0;
@@ -1137,14 +1187,13 @@ exports.partial = rest$1.partial;
 exports.partialRight = rest$1.partialRight;
 exports.throttle = rest$1.throttle;
 exports.unary = rest$1.unary;
-exports.clamp = math_index.clamp;
-exports.inRange = math_index.inRange;
-exports.mean = math_index.mean;
-exports.meanBy = math_index.meanBy;
-exports.range = math_index.range;
-exports.round = math_index.round;
-exports.sum = math_index.sum;
-exports.sumBy = math_index.sumBy;
+exports.clamp = range.clamp;
+exports.inRange = range.inRange;
+exports.mean = range.mean;
+exports.meanBy = range.meanBy;
+exports.range = range.range;
+exports.sum = range.sum;
+exports.sumBy = range.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.clone = toMerged.clone;
@@ -1183,6 +1232,7 @@ exports.bind = bind;
 exports.bindKey = bindKey;
 exports.camelCase = camelCase;
 exports.castArray = castArray;
+exports.ceil = ceil;
 exports.chunk = chunk;
 exports.concat = concat;
 exports.conforms = conforms;
@@ -1196,6 +1246,7 @@ exports.findLastIndex = findLastIndex;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
 exports.flattenDepth = flattenDepth;
+exports.floor = floor;
 exports.fromPairs = fromPairs;
 exports.get = get;
 exports.has = has;
@@ -1231,6 +1282,7 @@ exports.property = property;
 exports.rearg = rearg;
 exports.repeat = repeat;
 exports.rest = rest;
+exports.round = round;
 exports.set = set;
 exports.size = size;
 exports.some = some;

package/dist/compat/index.mjs

@@ -66,7 +66,6 @@ export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
 export { random } from '../math/random.mjs';
 export { randomInt } from '../math/randomInt.mjs';
-export { round } from '../math/round.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
 export { range } from '../math/range.mjs';
@@ -163,4 +162,7 @@ export { padEnd } from './string/padEnd.mjs';
 export { repeat } from './string/repeat.mjs';
 export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
+export { ceil } from './math/ceil.mjs';
+export { floor } from './math/floor.mjs';
+export { round } from './math/round.mjs';
 export { parseInt } from './math/parseInt.mjs';

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded up to precision.
+ *
+ * @param {number | string} number The number to round up.
+ * @param {number | string} precision The precision to round up to.
+ * @returns {number} Returns the rounded up number.
+ *
+ * @example
+ * ceil(4.006); // => 5
+ * ceil(6.004, 2); // => 6.01
+ * ceil(6040, -2); // => 6100
+ */
+declare function ceil(number: number | string, precision?: number | string): number;
+
+export { ceil };

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded up to precision.
+ *
+ * @param {number | string} number The number to round up.
+ * @param {number | string} precision The precision to round up to.
+ * @returns {number} Returns the rounded up number.
+ *
+ * @example
+ * ceil(4.006); // => 5
+ * ceil(6.004, 2); // => 6.01
+ * ceil(6040, -2); // => 6100
+ */
+declare function ceil(number: number | string, precision?: number | string): number;
+
+export { ceil };

package/dist/compat/math/ceil.mjs

@@ -0,0 +1,7 @@
+import { decimalAdjust } from '../_internal/decimalAdjust.mjs';
+
+function ceil(number, precision = 0) {
+    return decimalAdjust('ceil', number, precision);
+}
+
+export { ceil };

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded down to precision.
+ *
+ * @param {number | string} number The number to round down.
+ * @param {number | string} precision The precision to round down to.
+ * @returns {number} Returns the rounded down number.
+ *
+ * @example
+ * floor(4.006); // => 4
+ * floor(0.046, 2); // => 0.04
+ * floor(4060, -2); // => 4000
+ */
+declare function floor(number: number | string, precision?: number | string): number;
+
+export { floor };

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded down to precision.
+ *
+ * @param {number | string} number The number to round down.
+ * @param {number | string} precision The precision to round down to.
+ * @returns {number} Returns the rounded down number.
+ *
+ * @example
+ * floor(4.006); // => 4
+ * floor(0.046, 2); // => 0.04
+ * floor(4060, -2); // => 4000
+ */
+declare function floor(number: number | string, precision?: number | string): number;
+
+export { floor };

package/dist/compat/math/floor.mjs

@@ -0,0 +1,7 @@
+import { decimalAdjust } from '../_internal/decimalAdjust.mjs';
+
+function floor(number, precision = 0) {
+    return decimalAdjust('floor', number, precision);
+}
+
+export { floor };

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded to precision.
+ *
+ * @param {number | string} number  The number to round.
+ * @param {number | string} precision The precision to round to.
+ * @returns {number} Returns the rounded number.
+ *
+ * @example
+ * round(4.006); // => 4
+ * round(4.006, 2); // => 4.01
+ * round(4060, -2); // => 4100
+ */
+declare function round(number: number | string, precision?: number | string): number;
+
+export { round };

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

@@ -0,0 +1,15 @@
+/**
+ * Computes number rounded to precision.
+ *
+ * @param {number | string} number  The number to round.
+ * @param {number | string} precision The precision to round to.
+ * @returns {number} Returns the rounded number.
+ *
+ * @example
+ * round(4.006); // => 4
+ * round(4.006, 2); // => 4.01
+ * round(4060, -2); // => 4100
+ */
+declare function round(number: number | string, precision?: number | string): number;
+
+export { round };

package/dist/compat/math/round.mjs

@@ -0,0 +1,7 @@
+import { decimalAdjust } from '../_internal/decimalAdjust.mjs';
+
+function round(number, precision = 0) {
+    return decimalAdjust('round', number, precision);
+}
+
+export { round };

package/dist/compat/object/pick.d.mts

@@ -5,8 +5,26 @@
  * includes only the properties corresponding to the specified keys.
  *
  * @template T - The type of object.
+ * @template K - The type of keys in object.
  * @param {T} obj - The object to pick keys from.
- * @param {keyof T | string | Array<keyof T | string> | Array<Array<keyof T | string>>} keys - An array of keys to be picked from the object. received keysgoes through a flattening process before being used.
+ * @param {K[]} keys - An array of keys to be picked from the object.
+ * @returns {Pick<T, K>} A new object with the specified keys picked.
+ *
+ * @example
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const result = pick(obj, ['a', 'c']);
+ * // result will be { a: 1, c: 3 }
+ */
+declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Creates a new object composed of the picked object properties.
+ *
+ * This function takes an object and an array of keys, and returns a new object that
+ * includes only the properties corresponding to the specified keys.
+ *
+ * @template T - The type of object.
+ * @param {T | null | undefined} obj - The object to pick keys from.
+ * @param {PropertyKey | PropertyKey[] | ProperyKey[][]}} keys - An array of keys to be picked from the object. received keysgoes through a flattening process before being used.
  * @returns {Partial<T, K>} A new object with the specified keys picked.
  *
  * @example
@@ -23,6 +41,6 @@
  * const result = pick(obj, 'a.b');
  * // result will be { 'a.b': 1 }
  */
-declare function pick<T>(obj: T, ...keys: Array<keyof T | (NonNullable<unknown> & string) | IArguments | Array<keyof T | (NonNullable<unknown> & string) | IArguments> | Array<Array<keyof T | (NonNullable<unknown> & string) | IArguments>>>): Partial<T>;
+declare function pick<T extends {}>(obj: T | null | undefined, ...keys: Array<PropertyKey | PropertyKey[] | PropertyKey[][]>): Partial<T>;
 
 export { pick };

package/dist/compat/object/pick.d.ts

@@ -5,8 +5,26 @@
  * includes only the properties corresponding to the specified keys.
  *
  * @template T - The type of object.
+ * @template K - The type of keys in object.
  * @param {T} obj - The object to pick keys from.
- * @param {keyof T | string | Array<keyof T | string> | Array<Array<keyof T | string>>} keys - An array of keys to be picked from the object. received keysgoes through a flattening process before being used.
+ * @param {K[]} keys - An array of keys to be picked from the object.
+ * @returns {Pick<T, K>} A new object with the specified keys picked.
+ *
+ * @example
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const result = pick(obj, ['a', 'c']);
+ * // result will be { a: 1, c: 3 }
+ */
+declare function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+/**
+ * Creates a new object composed of the picked object properties.
+ *
+ * This function takes an object and an array of keys, and returns a new object that
+ * includes only the properties corresponding to the specified keys.
+ *
+ * @template T - The type of object.
+ * @param {T | null | undefined} obj - The object to pick keys from.
+ * @param {PropertyKey | PropertyKey[] | ProperyKey[][]}} keys - An array of keys to be picked from the object. received keysgoes through a flattening process before being used.
  * @returns {Partial<T, K>} A new object with the specified keys picked.
  *
  * @example
@@ -23,6 +41,6 @@
  * const result = pick(obj, 'a.b');
  * // result will be { 'a.b': 1 }
  */
-declare function pick<T>(obj: T, ...keys: Array<keyof T | (NonNullable<unknown> & string) | IArguments | Array<keyof T | (NonNullable<unknown> & string) | IArguments> | Array<Array<keyof T | (NonNullable<unknown> & string) | IArguments>>>): Partial<T>;
+declare function pick<T extends {}>(obj: T | null | undefined, ...keys: Array<PropertyKey | PropertyKey[] | PropertyKey[][]>): Partial<T>;
 
 export { pick };

package/dist/compat/object/pick.mjs

@@ -1,26 +1,36 @@
-import { set } from './set.mjs';
-import { flattenDeep } from '../../array/flattenDeep.mjs';
+import { isNil } from '../predicate/isNil.mjs';
 import { get } from './get.mjs';
-import '../../function/partial.mjs';
-import '../../function/partialRight.mjs';
-import { isNil } from '../../predicate/isNil.mjs';
-import '../../string/deburr.mjs';
-import '../function/bind.mjs';
-import '../function/bindKey.mjs';
+import { set } from './set.mjs';
 
-function pick(obj, ...keys) {
+function pick(obj, ...keysArr) {
     if (isNil(obj)) {
         return {};
     }
-    const typedObject = obj;
     const result = {};
-    const flattenArgs = flattenDeep(keys.map(arg => (typeof arg === 'object' ? Array.from(arg) : arg)));
-    for (const arg of flattenArgs) {
-        if (String(arg).includes('.') && arg in typedObject) {
-            result[arg] = get(typedObject, arg);
-            continue;
+    for (let keys of keysArr) {
+        switch (typeof keys) {
+            case 'object': {
+                if (!Array.isArray(keys)) {
+                    keys = Array.from(keys);
+                }
+                break;
+            }
+            case 'string':
+            case 'symbol':
+            case 'number': {
+                keys = [keys];
+                break;
+            }
+        }
+        for (const key of keys) {
+            const value = get(obj, key);
+            if (typeof key === 'string' && Object.prototype.hasOwnProperty.call(obj, key)) {
+                result[key] = value;
+            }
+            else {
+                set(result, key, value);
+            }
         }
-        set(result, arg, get(typedObject, arg));
     }
     return result;
 }

package/dist/compat/predicate/isNil.mjs

@@ -0,0 +1,5 @@
+function isNil(x) {
+    return x == null;
+}
+
+export { isNil };

package/dist/index.js

@@ -7,8 +7,9 @@ const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
 const rest = require('./_chunk/rest-CXt9w3.js');
 const function_index = require('./function/index.js');
-const math_index = require('./math/index.js');
+const range = require('./_chunk/range-BXlMmn.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
+const math_index = require('./math/index.js');
 const toMerged = require('./_chunk/toMerged-Bmrr2j.js');
 const object_index = require('./object/index.js');
 const isWeakSet = require('./_chunk/isWeakSet-BerD1A.js');
@@ -93,16 +94,16 @@ exports.rest = rest.rest;
 exports.throttle = rest.throttle;
 exports.unary = rest.unary;
 exports.spread = function_index.spread;
-exports.clamp = math_index.clamp;
-exports.inRange = math_index.inRange;
-exports.mean = math_index.mean;
-exports.meanBy = math_index.meanBy;
-exports.range = math_index.range;
-exports.round = math_index.round;
-exports.sum = math_index.sum;
-exports.sumBy = math_index.sumBy;
+exports.clamp = range.clamp;
+exports.inRange = range.inRange;
+exports.mean = range.mean;
+exports.meanBy = range.meanBy;
+exports.range = range.range;
+exports.sum = range.sum;
+exports.sumBy = range.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
+exports.round = math_index.round;
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
 exports.flattenObject = toMerged.flattenObject;

package/dist/math/index.js

@@ -2,43 +2,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
+const range = require('../_chunk/range-BXlMmn.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
-function clamp(value, bound1, bound2) {
-    if (bound2 == null) {
-        return Math.min(value, bound1);
-    }
-    return Math.min(Math.max(value, bound1), bound2);
-}
-
-function inRange(value, minimum, maximum) {
-    if (maximum == null) {
-        maximum = minimum;
-        minimum = 0;
-    }
-    if (minimum >= maximum) {
-        throw new Error('The maximum value must be greater than the minimum value.');
-    }
-    return minimum <= value && value < maximum;
-}
-
-function sum(nums) {
-    let result = 0;
-    for (let i = 0; i < nums.length; i++) {
-        result += nums[i];
-    }
-    return result;
-}
-
-function mean(nums) {
-    return sum(nums) / nums.length;
-}
-
-function meanBy(items, getValue) {
-    const nums = items.map(x => getValue(x));
-    return mean(nums);
-}
-
 function round(value, precision = 0) {
     if (!Number.isInteger(precision)) {
         throw new Error('Precision must be an integer.');
@@ -47,37 +13,13 @@ function round(value, precision = 0) {
     return Math.round(value * multiplier) / multiplier;
 }
 
-function sumBy(items, getValue) {
-    const nums = items.map(x => getValue(x));
-    return sum(nums);
-}
-
-function range(start, end, step) {
-    if (end == null) {
-        end = start;
-        start = 0;
-    }
-    if (step == null) {
-        step = 1;
-    }
-    if (!Number.isInteger(step) || step === 0) {
-        throw new Error(`The step value must be a non-zero integer.`);
-    }
-    const length = Math.max(Math.ceil((end - start) / step), 0);
-    const result = new Array(length);
-    for (let i = 0; i < length; i++) {
-        result[i] = start + i * step;
-    }
-    return result;
-}
-
+exports.clamp = range.clamp;
+exports.inRange = range.inRange;
+exports.mean = range.mean;
+exports.meanBy = range.meanBy;
+exports.range = range.range;
+exports.sum = range.sum;
+exports.sumBy = range.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
-exports.clamp = clamp;
-exports.inRange = inRange;
-exports.mean = mean;
-exports.meanBy = meanBy;
-exports.range = range;
 exports.round = round;
-exports.sum = sum;
-exports.sumBy = sumBy;

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.18.0-dev.575+936e0980",
+  "version": "1.18.0-dev.577+34fcd212",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {