es-toolkit 1.24.0-dev.768 → 1.24.0-dev.770

package/dist/compat/_internal/MAX_SAFE_INTEGER.mjs

@@ -0,0 +1,3 @@
+const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER;
+
+export { MAX_SAFE_INTEGER };

package/dist/compat/index.d.mts

@@ -211,4 +211,5 @@ export { toInteger } from './util/toInteger.mjs';
 export { toLength } from './util/toLength.mjs';
 export { toNumber } from './util/toNumber.mjs';
 export { toPath } from './util/toPath.mjs';
+export { toSafeInteger } from './util/toSafeInteger.mjs';
 export { toString } from './util/toString.mjs';

package/dist/compat/index.d.ts

@@ -211,4 +211,5 @@ export { toInteger } from './util/toInteger.js';
 export { toLength } from './util/toLength.js';
 export { toNumber } from './util/toNumber.js';
 export { toPath } from './util/toPath.js';
+export { toSafeInteger } from './util/toSafeInteger.js';
 export { toString } from './util/toString.js';

package/dist/compat/index.js

@@ -2078,6 +2078,15 @@ function toLength(value) {
     return clamp(length, 0, MAX_ARRAY_LENGTH);
 }
 
+const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER;
+
+function toSafeInteger(value) {
+    if (value == null) {
+        return 0;
+    }
+    return clamp(toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER);
+}
+
 exports.at = zipWith.at;
 exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
@@ -2286,6 +2295,7 @@ exports.toInteger = toInteger;
 exports.toLength = toLength;
 exports.toNumber = toNumber;
 exports.toPath = toPath;
+exports.toSafeInteger = toSafeInteger;
 exports.toString = toString;
 exports.trim = trim;
 exports.trimEnd = trimEnd;

package/dist/compat/index.mjs

@@ -211,4 +211,5 @@ export { toInteger } from './util/toInteger.mjs';
 export { toLength } from './util/toLength.mjs';
 export { toNumber } from './util/toNumber.mjs';
 export { toPath } from './util/toPath.mjs';
+export { toSafeInteger } from './util/toSafeInteger.mjs';
 export { toString } from './util/toString.mjs';

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

@@ -0,0 +1,20 @@
+/**
+ * Converts `value` to a safe integer.
+ *
+ * A safe integer can be compared and represented correctly.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the value converted to a safe integer.
+ *
+ * @example
+ * toSafeInteger(3.2); // => 3
+ * toSafeInteger(Number.MAX_VALUE); // => 9007199254740991
+ * toSafeInteger(Infinity); // => 9007199254740991
+ * toSafeInteger('3.2'); // => 3
+ * toSafeInteger(NaN); // => 0
+ * toSafeInteger(null); // => 0
+ * toSafeInteger(-Infinity); // => -9007199254740991
+ */
+declare function toSafeInteger(value?: unknown): number;
+
+export { toSafeInteger };

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

@@ -0,0 +1,20 @@
+/**
+ * Converts `value` to a safe integer.
+ *
+ * A safe integer can be compared and represented correctly.
+ *
+ * @param {unknown} value - The value to convert.
+ * @returns {number} Returns the value converted to a safe integer.
+ *
+ * @example
+ * toSafeInteger(3.2); // => 3
+ * toSafeInteger(Number.MAX_VALUE); // => 9007199254740991
+ * toSafeInteger(Infinity); // => 9007199254740991
+ * toSafeInteger('3.2'); // => 3
+ * toSafeInteger(NaN); // => 0
+ * toSafeInteger(null); // => 0
+ * toSafeInteger(-Infinity); // => -9007199254740991
+ */
+declare function toSafeInteger(value?: unknown): number;
+
+export { toSafeInteger };

package/dist/compat/util/toSafeInteger.mjs

@@ -0,0 +1,12 @@
+import { toInteger } from './toInteger.mjs';
+import { MAX_SAFE_INTEGER } from '../_internal/MAX_SAFE_INTEGER.mjs';
+import { clamp } from '../math/clamp.mjs';
+
+function toSafeInteger(value) {
+    if (value == null) {
+        return 0;
+    }
+    return clamp(toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER);
+}
+
+export { toSafeInteger };

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.24.0-dev.768+b9337bbb",
+  "version": "1.24.0-dev.770+faa0f2f5",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {