es-toolkit 1.24.0-dev.769 → 1.24.0-dev.772

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

@@ -8,9 +8,9 @@ const unary = require('../_chunk/unary-BZ5Ixo.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 const sumBy = require('../_chunk/sumBy-BkErWJ.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-DDLv0D.js');
-const isPlainObject$1 = require('../_chunk/isPlainObject-DgrsU7.js');
-const isWeakSet$1 = require('../_chunk/isWeakSet-Bd6nry.js');
+const toMerged = require('../_chunk/toMerged-Dgkf4k.js');
+const isPlainObject$1 = require('../_chunk/isPlainObject-D-qpfA.js');
+const isWeakSet$1 = require('../_chunk/isWeakSet-BXPmkb.js');
 const upperFirst = require('../_chunk/upperFirst-BUECmK.js');
 
 function castArray(value) {
@@ -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/dist/index.js

@@ -11,11 +11,11 @@ const noop = require('./_chunk/noop-2IwLUk.js');
 const sumBy = require('./_chunk/sumBy-BkErWJ.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
-const toMerged = require('./_chunk/toMerged-DDLv0D.js');
+const toMerged = require('./_chunk/toMerged-Dgkf4k.js');
 const object_index = require('./object/index.js');
-const isWeakSet = require('./_chunk/isWeakSet-Bd6nry.js');
+const isWeakSet = require('./_chunk/isWeakSet-BXPmkb.js');
 const predicate_index = require('./predicate/index.js');
-const isPlainObject = require('./_chunk/isPlainObject-DgrsU7.js');
+const isPlainObject = require('./_chunk/isPlainObject-D-qpfA.js');
 const upperFirst = require('./_chunk/upperFirst-BUECmK.js');
 const string_index = require('./string/index.js');
 

package/dist/object/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const toMerged = require('../_chunk/toMerged-DDLv0D.js');
+const toMerged = require('../_chunk/toMerged-Dgkf4k.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);

package/dist/predicate/index.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isWeakSet = require('../_chunk/isWeakSet-Bd6nry.js');
-const isPlainObject = require('../_chunk/isPlainObject-DgrsU7.js');
+const isWeakSet = require('../_chunk/isWeakSet-BXPmkb.js');
+const isPlainObject = require('../_chunk/isPlainObject-D-qpfA.js');
 
 function isBoolean(x) {
     return typeof x === 'boolean';

package/dist/predicate/isPlainObject.d.mts

@@ -5,11 +5,40 @@
  * @returns {value is Record<PropertyKey, any>} - True if the value is a plain object, otherwise false.
  *
  * @example
- * console.log(isPlainObject({})); // true
- * console.log(isPlainObject([])); // false
- * console.log(isPlainObject(null)); // false
- * console.log(isPlainObject(Object.create(null))); // true
- * console.log(Buffer.from('hello, world')); // false
+ * ```typescript
+ * // ✅👇 True
+ *
+ * isPlainObject({ });                       // ✅
+ * isPlainObject({ key: 'value' });          // ✅
+ * isPlainObject({ key: new Date() });       // ✅
+ * isPlainObject(new Object());              // ✅
+ * isPlainObject(Object.create(null));       // ✅
+ * isPlainObject({ nested: { key: true} });  // ✅
+ * isPlainObject(new Proxy({}, {}));         // ✅
+ * isPlainObject({ [Symbol('tag')]: 'A' });  // ✅
+ *
+ * // ✅👇 (cross-realms, node context, workers, ...)
+ * const runInNewContext = await import('node:vm').then(
+ *     (mod) => mod.runInNewContext
+ * );
+ * isPlainObject(runInNewContext('({})'));   // ✅
+ *
+ * // ❌👇 False
+ *
+ * class Test { };
+ * isPlainObject(new Test())           // ❌
+ * isPlainObject(10);                  // ❌
+ * isPlainObject(null);                // ❌
+ * isPlainObject('hello');             // ❌
+ * isPlainObject([]);                  // ❌
+ * isPlainObject(new Date());          // ❌
+ * isPlainObject(new Uint8Array([1])); // ❌
+ * isPlainObject(Buffer.from('ABC'));  // ❌
+ * isPlainObject(Promise.resolve({})); // ❌
+ * isPlainObject(Object.create({}));   // ❌
+ * isPlainObject(new (class Cls {}));  // ❌
+ * isPlainObject(globalThis);          // ❌,
+ * ```
  */
 declare function isPlainObject(value: unknown): value is Record<PropertyKey, any>;
 

package/dist/predicate/isPlainObject.d.ts

@@ -5,11 +5,40 @@
  * @returns {value is Record<PropertyKey, any>} - True if the value is a plain object, otherwise false.
  *
  * @example
- * console.log(isPlainObject({})); // true
- * console.log(isPlainObject([])); // false
- * console.log(isPlainObject(null)); // false
- * console.log(isPlainObject(Object.create(null))); // true
- * console.log(Buffer.from('hello, world')); // false
+ * ```typescript
+ * // ✅👇 True
+ *
+ * isPlainObject({ });                       // ✅
+ * isPlainObject({ key: 'value' });          // ✅
+ * isPlainObject({ key: new Date() });       // ✅
+ * isPlainObject(new Object());              // ✅
+ * isPlainObject(Object.create(null));       // ✅
+ * isPlainObject({ nested: { key: true} });  // ✅
+ * isPlainObject(new Proxy({}, {}));         // ✅
+ * isPlainObject({ [Symbol('tag')]: 'A' });  // ✅
+ *
+ * // ✅👇 (cross-realms, node context, workers, ...)
+ * const runInNewContext = await import('node:vm').then(
+ *     (mod) => mod.runInNewContext
+ * );
+ * isPlainObject(runInNewContext('({})'));   // ✅
+ *
+ * // ❌👇 False
+ *
+ * class Test { };
+ * isPlainObject(new Test())           // ❌
+ * isPlainObject(10);                  // ❌
+ * isPlainObject(null);                // ❌
+ * isPlainObject('hello');             // ❌
+ * isPlainObject([]);                  // ❌
+ * isPlainObject(new Date());          // ❌
+ * isPlainObject(new Uint8Array([1])); // ❌
+ * isPlainObject(Buffer.from('ABC'));  // ❌
+ * isPlainObject(Promise.resolve({})); // ❌
+ * isPlainObject(Object.create({}));   // ❌
+ * isPlainObject(new (class Cls {}));  // ❌
+ * isPlainObject(globalThis);          // ❌,
+ * ```
  */
 declare function isPlainObject(value: unknown): value is Record<PropertyKey, any>;
 

package/dist/predicate/isPlainObject.mjs

@@ -1,21 +1,11 @@
 function isPlainObject(value) {
-    if (typeof value !== 'object') {
+    if (!value || typeof value !== 'object') {
         return false;
     }
-    if (value == null) {
-        return false;
-    }
-    if (Object.getPrototypeOf(value) === null) {
-        return true;
-    }
-    if (value.toString() !== '[object Object]') {
-        return false;
-    }
-    let proto = value;
-    while (Object.getPrototypeOf(proto) !== null) {
-        proto = Object.getPrototypeOf(proto);
-    }
-    return Object.getPrototypeOf(value) === proto;
+    const proto = Object.getPrototypeOf(value);
+    return (proto === null ||
+        proto === Object.prototype ||
+        Object.getPrototypeOf(proto) === null);
 }
 
 export { isPlainObject };

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.769+1c780cf1",
+  "version": "1.24.0-dev.772+8ba7fbe4",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/_chunk/isPlainObject-DgrsU7.js

@@ -1,33 +0,0 @@
-'use strict';
-
-function isPrimitive(value) {
-    return value == null || (typeof value !== 'object' && typeof value !== 'function');
-}
-
-function isTypedArray(x) {
-    return ArrayBuffer.isView(x) && !(x instanceof DataView);
-}
-
-function isPlainObject(value) {
-    if (typeof value !== 'object') {
-        return false;
-    }
-    if (value == null) {
-        return false;
-    }
-    if (Object.getPrototypeOf(value) === null) {
-        return true;
-    }
-    if (value.toString() !== '[object Object]') {
-        return false;
-    }
-    let proto = value;
-    while (Object.getPrototypeOf(proto) !== null) {
-        proto = Object.getPrototypeOf(proto);
-    }
-    return Object.getPrototypeOf(value) === proto;
-}
-
-exports.isPlainObject = isPlainObject;
-exports.isPrimitive = isPrimitive;
-exports.isTypedArray = isTypedArray;