es-toolkit 1.24.0 → 1.25.0-dev.786

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/function/after.d.mts

@@ -8,7 +8,7 @@
  * @template F - The type of the function to be invoked.
  * @param {number} n - The number of calls required for `func` to execute.
  * @param {F} func - The function to be invoked.
- * @returns {F} - A new function that:
+ * @returns {(...args: Parameters<F>) => ReturnType<F> | undefined} - A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` starting from the `n`-th call.
  * - Returns `undefined` if fewer than `n` calls have been made.
@@ -26,6 +26,6 @@
  * // Will log 'called'.
  * afterFn()
  */
-declare function after<F extends (...args: any[]) => any>(n: number, func: F): F;
+declare function after<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
 
 export { after };

package/dist/function/after.d.ts

@@ -8,7 +8,7 @@
  * @template F - The type of the function to be invoked.
  * @param {number} n - The number of calls required for `func` to execute.
  * @param {F} func - The function to be invoked.
- * @returns {F} - A new function that:
+ * @returns {(...args: Parameters<F>) => ReturnType<F> | undefined} - A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` starting from the `n`-th call.
  * - Returns `undefined` if fewer than `n` calls have been made.
@@ -26,6 +26,6 @@
  * // Will log 'called'.
  * afterFn()
  */
-declare function after<F extends (...args: any[]) => any>(n: number, func: F): F;
+declare function after<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
 
 export { after };

package/dist/function/after.mjs

@@ -3,12 +3,12 @@ function after(n, func) {
         throw new Error(`n must be a non-negative integer.`);
     }
     let counter = 0;
-    return ((...args) => {
+    return (...args) => {
         if (++counter >= n) {
             return func(...args);
         }
         return undefined;
-    });
+    };
 }
 
 export { after };

package/dist/function/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const unary = require('../_chunk/unary-BZ5Ixo.js');
+const unary = require('../_chunk/unary-CMvKXy.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 
 function before(n, func) {

package/dist/index.d.mts

@@ -105,6 +105,7 @@ export { isDate } from './predicate/isDate.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { isError } from './predicate/isError.mjs';
+export { isFile } from './predicate/isFile.mjs';
 export { isFunction } from './predicate/isFunction.mjs';
 export { isJSONArray } from './predicate/isJSONArray.mjs';
 export { isJSONObject } from './predicate/isJSONObject.mjs';

package/dist/index.d.ts

@@ -105,6 +105,7 @@ export { isDate } from './predicate/isDate.js';
 export { isEqual } from './predicate/isEqual.js';
 export { isEqualWith } from './predicate/isEqualWith.js';
 export { isError } from './predicate/isError.js';
+export { isFile } from './predicate/isFile.js';
 export { isFunction } from './predicate/isFunction.js';
 export { isJSONArray } from './predicate/isJSONArray.js';
 export { isJSONObject } from './predicate/isJSONObject.js';

package/dist/index.js

@@ -2,20 +2,20 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('./_chunk/zipWith-wpjySR.js');
+const zipWith = require('./_chunk/zipWith-Dkv3D1.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
-const unary = require('./_chunk/unary-BZ5Ixo.js');
+const unary = require('./_chunk/unary-CMvKXy.js');
 const function_index = require('./function/index.js');
 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-B5ZVux.js');
 const object_index = require('./object/index.js');
-const isWeakSet = require('./_chunk/isWeakSet-Bd6nry.js');
+const isWeakSet = require('./_chunk/isWeakSet-BuFfzX.js');
 const predicate_index = require('./predicate/index.js');
-const isPlainObject = require('./_chunk/isPlainObject-DgrsU7.js');
+const isPlainObject = require('./_chunk/isPlainObject-octpoD.js');
 const upperFirst = require('./_chunk/upperFirst-BUECmK.js');
 const string_index = require('./string/index.js');
 
@@ -28,6 +28,7 @@ exports.countBy = zipWith.countBy;
 exports.difference = zipWith.difference;
 exports.differenceBy = zipWith.differenceBy;
 exports.differenceWith = zipWith.differenceWith;
+exports.drop = zipWith.drop;
 exports.dropRight = zipWith.dropRight;
 exports.dropRightWhile = zipWith.dropRightWhile;
 exports.dropWhile = zipWith.dropWhile;
@@ -74,7 +75,6 @@ exports.xorWith = zipWith.xorWith;
 exports.zip = zipWith.zip;
 exports.zipObject = zipWith.zipObject;
 exports.zipWith = zipWith.zipWith;
-exports.drop = array_index.drop;
 exports.orderBy = array_index.orderBy;
 exports.sortBy = array_index.sortBy;
 exports.AbortError = promise_index.AbortError;
@@ -129,6 +129,7 @@ exports.isBlob = isWeakSet.isBlob;
 exports.isDate = isWeakSet.isDate;
 exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;
+exports.isFile = isWeakSet.isFile;
 exports.isFunction = isWeakSet.isFunction;
 exports.isJSONArray = isWeakSet.isJSONArray;
 exports.isJSONObject = isWeakSet.isJSONObject;

package/dist/index.mjs

@@ -105,6 +105,7 @@ export { isDate } from './predicate/isDate.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isEqualWith } from './predicate/isEqualWith.mjs';
 export { isError } from './predicate/isError.mjs';
+export { isFile } from './predicate/isFile.mjs';
 export { isFunction } from './predicate/isFunction.mjs';
 export { isJSONArray } from './predicate/isJSONArray.mjs';
 export { isJSONObject } from './predicate/isJSONObject.mjs';

package/dist/object/cloneDeep.mjs

@@ -1,3 +1,4 @@
+import { getSymbols } from '../compat/_internal/getSymbols.mjs';
 import { isPrimitive } from '../predicate/isPrimitive.mjs';
 import { isTypedArray } from '../predicate/isTypedArray.mjs';
 
@@ -100,13 +101,10 @@ function cloneDeepImpl(obj, stack = new Map()) {
     return obj;
 }
 function copyProperties(target, source, stack) {
-    const keys = Object.keys(source);
+    const keys = [...Object.keys(source), ...getSymbols(source)];
     for (let i = 0; i < keys.length; i++) {
         const key = keys[i];
-        const descriptor = Object.getOwnPropertyDescriptor(source, key);
-        if (descriptor?.writable || descriptor?.set) {
-            target[key] = cloneDeepImpl(source[key], stack);
-        }
+        target[key] = cloneDeepImpl(source[key], stack);
     }
 }
 

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-B5ZVux.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);

package/dist/predicate/index.d.mts

@@ -5,6 +5,7 @@ export { isDate } from './isDate.mjs';
 export { isEqual } from './isEqual.mjs';
 export { isEqualWith } from './isEqualWith.mjs';
 export { isError } from './isError.mjs';
+export { isFile } from './isFile.mjs';
 export { isFunction } from './isFunction.mjs';
 export { isJSONArray } from './isJSONArray.mjs';
 export { isJSONObject } from './isJSONObject.mjs';

package/dist/predicate/index.d.ts

@@ -5,6 +5,7 @@ export { isDate } from './isDate.js';
 export { isEqual } from './isEqual.js';
 export { isEqualWith } from './isEqualWith.js';
 export { isError } from './isError.js';
+export { isFile } from './isFile.js';
 export { isFunction } from './isFunction.js';
 export { isJSONArray } from './isJSONArray.js';
 export { isJSONObject } from './isJSONObject.js';

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-BuFfzX.js');
+const isPlainObject = require('../_chunk/isPlainObject-octpoD.js');
 
 function isBoolean(x) {
     return typeof x === 'boolean';
@@ -26,6 +26,7 @@ exports.isBlob = isWeakSet.isBlob;
 exports.isDate = isWeakSet.isDate;
 exports.isEqual = isWeakSet.isEqual;
 exports.isEqualWith = isWeakSet.isEqualWith;
+exports.isFile = isWeakSet.isFile;
 exports.isFunction = isWeakSet.isFunction;
 exports.isJSONArray = isWeakSet.isJSONArray;
 exports.isJSONObject = isWeakSet.isJSONObject;

package/dist/predicate/index.mjs

@@ -5,6 +5,7 @@ export { isDate } from './isDate.mjs';
 export { isEqual } from './isEqual.mjs';
 export { isEqualWith } from './isEqualWith.mjs';
 export { isError } from './isError.mjs';
+export { isFile } from './isFile.mjs';
 export { isFunction } from './isFunction.mjs';
 export { isJSONArray } from './isJSONArray.mjs';
 export { isJSONObject } from './isJSONObject.mjs';

package/dist/predicate/isFile.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a File.
+ *
+ * This function tests whether the provided value is an instance of `File`.
+ * It returns `true` if the value is an instance of `File`, and `false` otherwise.
+ *
+ * @param {unknown} x - The value to test if it is a File.
+ * @returns {x is File} True if the value is a File, false otherwise.
+ *
+ * @example
+ * const value1 = new File(["content"], "example.txt");
+ * const value2 = {};
+ * const value3 = new Blob(["content"], { type: "text/plain" });
+ *
+ * console.log(isFile(value1)); // true
+ * console.log(isFile(value2)); // false
+ * console.log(isFile(value3)); // false
+ */
+declare function isFile(x: unknown): x is File;
+
+export { isFile };

package/dist/predicate/isFile.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a File.
+ *
+ * This function tests whether the provided value is an instance of `File`.
+ * It returns `true` if the value is an instance of `File`, and `false` otherwise.
+ *
+ * @param {unknown} x - The value to test if it is a File.
+ * @returns {x is File} True if the value is a File, false otherwise.
+ *
+ * @example
+ * const value1 = new File(["content"], "example.txt");
+ * const value2 = {};
+ * const value3 = new Blob(["content"], { type: "text/plain" });
+ *
+ * console.log(isFile(value1)); // true
+ * console.log(isFile(value2)); // false
+ * console.log(isFile(value3)); // false
+ */
+declare function isFile(x: unknown): x is File;
+
+export { isFile };

package/dist/predicate/isFile.mjs

@@ -0,0 +1,10 @@
+import { isBlob } from './isBlob.mjs';
+
+function isFile(x) {
+    if (typeof File === 'undefined') {
+        return false;
+    }
+    return isBlob(x) && x instanceof File;
+}
+
+export { isFile };

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,15 @@
 function isPlainObject(value) {
-    if (typeof value !== 'object') {
+    if (!value || typeof value !== 'object') {
         return false;
     }
-    if (value == null) {
+    const proto = Object.getPrototypeOf(value);
+    const hasObjectPrototype = proto === null ||
+        proto === Object.prototype ||
+        Object.getPrototypeOf(proto) === null;
+    if (!hasObjectPrototype) {
         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;
+    return Object.prototype.toString.call(value) === '[object Object]';
 }
 
 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",
+  "version": "1.25.0-dev.786+56835199",
   "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;