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