es-toolkit 1.20.0-dev.652 → 1.20.0-dev.653

package/dist/compat/function/defer.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
+ *
+ * @param {F} func The function to defer.
+ * @param {Parameters<F>} args The arguments to invoke `func` with.
+ * @returns {number} Returns the timer id.
+ *
+ * @example
+ * defer((text) => {
+ *   console.log(text);
+ * }, 'deferred');
+ * // => Logs 'deferred' after the current call stack has cleared.
+ */
+declare function defer<F extends (...args: any[]) => any>(func: F, ...args: Parameters<F>): number;
+
+export { defer };

package/dist/compat/function/defer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
+ *
+ * @param {F} func The function to defer.
+ * @param {Parameters<F>} args The arguments to invoke `func` with.
+ * @returns {number} Returns the timer id.
+ *
+ * @example
+ * defer((text) => {
+ *   console.log(text);
+ * }, 'deferred');
+ * // => Logs 'deferred' after the current call stack has cleared.
+ */
+declare function defer<F extends (...args: any[]) => any>(func: F, ...args: Parameters<F>): number;
+
+export { defer };

package/dist/compat/function/defer.mjs

@@ -0,0 +1,8 @@
+function defer(func, ...args) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    return setTimeout(func, 1, ...args);
+}
+
+export { defer };

package/dist/compat/index.d.mts

@@ -112,6 +112,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { bindKey } from './function/bindKey.mjs';
+export { defer } from './function/defer.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';

package/dist/compat/index.d.ts

@@ -112,6 +112,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { ary } from './function/ary.js';
 export { bind } from './function/bind.js';
 export { bindKey } from './function/bindKey.js';
+export { defer } from './function/defer.js';
 export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';
 export { attempt } from './function/attempt.js';

package/dist/compat/index.js

@@ -785,6 +785,13 @@ function bindKey(object, key, ...partialArgs) {
 const bindKeyPlaceholder = Symbol('bindKey.placeholder');
 bindKey.placeholder = bindKeyPlaceholder;
 
+function defer(func, ...args) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    return setTimeout(func, 1, ...args);
+}
+
 function rest(func, start = func.length - 1) {
     start = Number.parseInt(start, 10);
     if (Number.isNaN(start) || start < 0) {
@@ -1727,6 +1734,7 @@ exports.conforms = conforms;
 exports.conformsTo = conformsTo;
 exports.curry = curry;
 exports.debounce = debounce;
+exports.defer = defer;
 exports.difference = difference;
 exports.drop = drop;
 exports.endsWith = endsWith;

package/dist/compat/index.mjs

@@ -113,6 +113,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { bindKey } from './function/bindKey.mjs';
+export { defer } from './function/defer.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';

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.652+8b2cfa02",
+  "version": "1.20.0-dev.653+36b14bef",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {