es-toolkit 1.20.0-dev.648 → 1.20.0-dev.650

package/dist/compat/index.d.mts

@@ -182,3 +182,6 @@ export { inRange } from './math/inRange.mjs';
 export { random } from './math/random.mjs';
 export { toPath } from './util/toPath.mjs';
 export { toString } from './util/toString.mjs';
+export { toNumber } from './util/toNumber.mjs';
+export { toInteger } from './util/toInteger.mjs';
+export { toFinite } from './util/toFinite.mjs';

package/dist/compat/index.d.ts

@@ -182,3 +182,6 @@ export { inRange } from './math/inRange.js';
 export { random } from './math/random.js';
 export { toPath } from './util/toPath.js';
 export { toString } from './util/toString.js';
+export { toNumber } from './util/toNumber.js';
+export { toInteger } from './util/toInteger.js';
+export { toFinite } from './util/toFinite.js';

package/dist/compat/index.js

@@ -1589,6 +1589,31 @@ function random(...args) {
     }
 }
 
+function toNumber(value) {
+    if (isSymbol(value)) {
+        return NaN;
+    }
+    return Number(value);
+}
+
+function toFinite(value) {
+    if (!value) {
+        return value === 0 ? value : 0;
+    }
+    value = toNumber(value);
+    if (value === Infinity || value === -Infinity) {
+        const sign = value < 0 ? -1 : 1;
+        return sign * Number.MAX_VALUE;
+    }
+    return value === value ? value : 0;
+}
+
+function toInteger(value) {
+    const finite = toFinite(value);
+    const remainder = finite % 1;
+    return remainder ? finite - remainder : finite;
+}
+
 exports.at = zipWith.at;
 exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
@@ -1766,6 +1791,9 @@ exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
 exports.throttle = throttle;
+exports.toFinite = toFinite;
+exports.toInteger = toInteger;
+exports.toNumber = toNumber;
 exports.toPath = toPath;
 exports.toString = toString;
 exports.trim = trim;

package/dist/compat/index.mjs

@@ -182,3 +182,6 @@ export { inRange } from './math/inRange.mjs';
 export { random } from './math/random.mjs';
 export { toPath } from './util/toPath.mjs';
 export { toString } from './util/toString.mjs';
+export { toNumber } from './util/toNumber.mjs';
+export { toInteger } from './util/toInteger.mjs';
+export { toFinite } from './util/toFinite.mjs';

package/dist/compat/util/toFinite.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Converts `value` to a finite number.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toNumber(3.2); // => 3.2
+ * toNumber(Number.MIN_VALUE); // => 5e-324
+ * toNumber(Infinity); // => 1.7976931348623157e+308
+ * toNumber('3.2'); // => 3.2
+ * toNumber(Symbol.iterator); // => 0
+ * toNumber(NaN); // => 0
+ */
+declare function toFinite(value?: unknown): number;
+
+export { toFinite };

package/dist/compat/util/toFinite.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts `value` to a finite number.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toNumber(3.2); // => 3.2
+ * toNumber(Number.MIN_VALUE); // => 5e-324
+ * toNumber(Infinity); // => 1.7976931348623157e+308
+ * toNumber('3.2'); // => 3.2
+ * toNumber(Symbol.iterator); // => 0
+ * toNumber(NaN); // => 0
+ */
+declare function toFinite(value?: unknown): number;
+
+export { toFinite };

package/dist/compat/util/toFinite.mjs

@@ -0,0 +1,15 @@
+import { toNumber } from './toNumber.mjs';
+
+function toFinite(value) {
+    if (!value) {
+        return value === 0 ? value : 0;
+    }
+    value = toNumber(value);
+    if (value === Infinity || value === -Infinity) {
+        const sign = value < 0 ? -1 : 1;
+        return sign * Number.MAX_VALUE;
+    }
+    return value === value ? value : 0;
+}
+
+export { toFinite };

package/dist/compat/util/toInteger.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Converts `value` to an integer.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toInteger(3.2); // => 3
+ * toInteger(Number.MIN_VALUE); // => 0
+ * toInteger(Infinity); // => 1.7976931348623157e+308
+ * toInteger('3.2'); // => 3
+ * toInteger(Symbol.iterator); // => 0
+ * toInteger(NaN); // => 0
+ */
+declare function toInteger(value?: unknown): number;
+
+export { toInteger };

package/dist/compat/util/toInteger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts `value` to an integer.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toInteger(3.2); // => 3
+ * toInteger(Number.MIN_VALUE); // => 0
+ * toInteger(Infinity); // => 1.7976931348623157e+308
+ * toInteger('3.2'); // => 3
+ * toInteger(Symbol.iterator); // => 0
+ * toInteger(NaN); // => 0
+ */
+declare function toInteger(value?: unknown): number;
+
+export { toInteger };

package/dist/compat/util/toInteger.mjs

@@ -0,0 +1,9 @@
+import { toFinite } from './toFinite.mjs';
+
+function toInteger(value) {
+    const finite = toFinite(value);
+    const remainder = finite % 1;
+    return remainder ? finite - remainder : finite;
+}
+
+export { toInteger };

package/dist/compat/util/toNumber.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Converts `value` to a number.
+ *
+ * Unlike `Number()`, this function returns `NaN` for symbols.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toNumber(3.2); // => 3.2
+ * toNumber(Number.MIN_VALUE); // => 5e-324
+ * toNumber(Infinity); // => Infinity
+ * toNumber('3.2'); // => 3.2
+ * toNumber(Symbol.iterator); // => NaN
+ * toNumber(NaN); // => NaN
+ */
+declare function toNumber(value?: unknown): number;
+
+export { toNumber };

package/dist/compat/util/toNumber.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Converts `value` to a number.
+ *
+ * Unlike `Number()`, this function returns `NaN` for symbols.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the number.
+ *
+ * @example
+ * toNumber(3.2); // => 3.2
+ * toNumber(Number.MIN_VALUE); // => 5e-324
+ * toNumber(Infinity); // => Infinity
+ * toNumber('3.2'); // => 3.2
+ * toNumber(Symbol.iterator); // => NaN
+ * toNumber(NaN); // => NaN
+ */
+declare function toNumber(value?: unknown): number;
+
+export { toNumber };

package/dist/compat/util/toNumber.mjs

@@ -0,0 +1,10 @@
+import { isSymbol } from '../predicate/isSymbol.mjs';
+
+function toNumber(value) {
+    if (isSymbol(value)) {
+        return NaN;
+    }
+    return Number(value);
+}
+
+export { toNumber };

package/dist/function/curry.d.mts

@@ -48,18 +48,17 @@ declare function curry<P1, P2, R>(func: (p1: P1, p2: P2) => R): (p1: P1) => (p2:
  * Curries a function, allowing it to be called with a single argument at a time and returning a new function that takes the next argument.
  * This process continues until all arguments have been provided, at which point the original function is called with all accumulated arguments.
  *
- * @param {(p1: P1, p2: P2, p3: P3, p4: P4) => R} func - The function to curry.
- * @returns {(p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => R} A curried function.
+ * @param {(p1: P1, p2: P2, p3: P3) => R} func - The function to curry.
+ * @returns {(p1: P1) => (p2: P2) => (p3: P3) => R} A curried function.
  *
  * @example
- * function fourArgFunc(a: number, b: number, c: number, d: number) {
- *   return a + b + c + d;
+ * function threeArgFunc(a: number, b: number, c: number) {
+ *   return a + b + c;
  * }
- * const curriedFourArgFunc = curry(fourArgFunc);
- * const add1 = curriedFourArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * console.log(add3(4)); // 10
+ * const curriedThreeArgFunc = curry(threeArgFunc);
+ * const add1 = curriedThreeArgFunc(1);
+ * const add3 = add1(2);
+ * console.log(add3(3)); // 6
  */
 declare function curry<P1, P2, P3, R>(func: (p1: P1, p2: P2, p3: P3) => R): (p1: P1) => (p2: P2) => (p3: P3) => R;
 /**
@@ -75,9 +74,9 @@ declare function curry<P1, P2, P3, R>(func: (p1: P1, p2: P2, p3: P3) => R): (p1:
  * }
  * const curriedFourArgFunc = curry(fourArgFunc);
  * const add1 = curriedFourArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * console.log(add3(4)); // 10
+ * const add3 = add1(2);
+ * const add6 = add3(3);
+ * console.log(add6(4)); // 10
  */
 declare function curry<P1, P2, P3, P4, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4) => R): (p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => R;
 /**
@@ -93,10 +92,10 @@ declare function curry<P1, P2, P3, P4, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4)
  * }
  * const curriedFiveArgFunc = curry(fiveArgFunc);
  * const add1 = curriedFiveArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * const add4 = add3(4);
- * console.log(add4(5)); // 15
+ * const add3 = add1(2);
+ * const add6 = add3(3);
+ * const add10 = add6(4);
+ * console.log(add10(5)); // 15
  */
 declare function curry<P1, P2, P3, P4, P5, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4, p5: P5) => R): (p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => (p5: P5) => R;
 /**
@@ -114,13 +113,13 @@ declare function curry<P1, P2, P3, P4, P5, R>(func: (p1: P1, p2: P2, p3: P3, p4:
  * const curriedSum = curry(sum);
  *
  * // The parameter `a` should be given the value `10`.
- * const sum10 = curriedSum(10);
+ * const add10 = curriedSum(10);
  *
  * // The parameter `b` should be given the value `15`.
- * const sum25 = sum10(15);
+ * const add25 = add10(15);
  *
  * // The parameter `c` should be given the value `5`. The function 'sum' has received all its arguments and will now return a value.
- * const result = sum25(5);
+ * const result = add25(5);
  */
 declare function curry(func: (...args: any[]) => any): (...args: any[]) => any;
 

package/dist/function/curry.d.ts

@@ -48,18 +48,17 @@ declare function curry<P1, P2, R>(func: (p1: P1, p2: P2) => R): (p1: P1) => (p2:
  * Curries a function, allowing it to be called with a single argument at a time and returning a new function that takes the next argument.
  * This process continues until all arguments have been provided, at which point the original function is called with all accumulated arguments.
  *
- * @param {(p1: P1, p2: P2, p3: P3, p4: P4) => R} func - The function to curry.
- * @returns {(p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => R} A curried function.
+ * @param {(p1: P1, p2: P2, p3: P3) => R} func - The function to curry.
+ * @returns {(p1: P1) => (p2: P2) => (p3: P3) => R} A curried function.
  *
  * @example
- * function fourArgFunc(a: number, b: number, c: number, d: number) {
- *   return a + b + c + d;
+ * function threeArgFunc(a: number, b: number, c: number) {
+ *   return a + b + c;
  * }
- * const curriedFourArgFunc = curry(fourArgFunc);
- * const add1 = curriedFourArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * console.log(add3(4)); // 10
+ * const curriedThreeArgFunc = curry(threeArgFunc);
+ * const add1 = curriedThreeArgFunc(1);
+ * const add3 = add1(2);
+ * console.log(add3(3)); // 6
  */
 declare function curry<P1, P2, P3, R>(func: (p1: P1, p2: P2, p3: P3) => R): (p1: P1) => (p2: P2) => (p3: P3) => R;
 /**
@@ -75,9 +74,9 @@ declare function curry<P1, P2, P3, R>(func: (p1: P1, p2: P2, p3: P3) => R): (p1:
  * }
  * const curriedFourArgFunc = curry(fourArgFunc);
  * const add1 = curriedFourArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * console.log(add3(4)); // 10
+ * const add3 = add1(2);
+ * const add6 = add3(3);
+ * console.log(add6(4)); // 10
  */
 declare function curry<P1, P2, P3, P4, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4) => R): (p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => R;
 /**
@@ -93,10 +92,10 @@ declare function curry<P1, P2, P3, P4, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4)
  * }
  * const curriedFiveArgFunc = curry(fiveArgFunc);
  * const add1 = curriedFiveArgFunc(1);
- * const add2 = add1(2);
- * const add3 = add2(3);
- * const add4 = add3(4);
- * console.log(add4(5)); // 15
+ * const add3 = add1(2);
+ * const add6 = add3(3);
+ * const add10 = add6(4);
+ * console.log(add10(5)); // 15
  */
 declare function curry<P1, P2, P3, P4, P5, R>(func: (p1: P1, p2: P2, p3: P3, p4: P4, p5: P5) => R): (p1: P1) => (p2: P2) => (p3: P3) => (p4: P4) => (p5: P5) => R;
 /**
@@ -114,13 +113,13 @@ declare function curry<P1, P2, P3, P4, P5, R>(func: (p1: P1, p2: P2, p3: P3, p4:
  * const curriedSum = curry(sum);
  *
  * // The parameter `a` should be given the value `10`.
- * const sum10 = curriedSum(10);
+ * const add10 = curriedSum(10);
  *
  * // The parameter `b` should be given the value `15`.
- * const sum25 = sum10(15);
+ * const add25 = add10(15);
  *
  * // The parameter `c` should be given the value `5`. The function 'sum' has received all its arguments and will now return a value.
- * const result = sum25(5);
+ * const result = add25(5);
  */
 declare function curry(func: (...args: any[]) => any): (...args: any[]) => any;
 

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.20.0-dev.648+60e4ba38",
+  "version": "1.20.0-dev.650+d47ee5f4",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {