es-toolkit 1.29.0-dev.946 → 1.29.0-dev.948

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

@@ -0,0 +1,31 @@
+/**
+ * Creates a function that only executes starting from the `n`-th call.
+ * The provided function will be invoked starting from the `n`-th call.
+ *
+ * This is particularly useful for scenarios involving events or asynchronous operations
+ * where an action should occur only after a certain number of invocations.
+ *
+ * @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 {(...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.
+ * @throws {TypeError} - If `func` is not a function.
+ * @example
+ *
+ * const afterFn = after(3, () => {
+ *  console.log("called")
+ * });
+ *
+ * // Will not log anything.
+ * afterFn()
+ * // Will not log anything.
+ * afterFn()
+ * // Will log 'called'.
+ * afterFn()
+ */
+declare function after<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
+
+export { after };

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

@@ -0,0 +1,31 @@
+/**
+ * Creates a function that only executes starting from the `n`-th call.
+ * The provided function will be invoked starting from the `n`-th call.
+ *
+ * This is particularly useful for scenarios involving events or asynchronous operations
+ * where an action should occur only after a certain number of invocations.
+ *
+ * @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 {(...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.
+ * @throws {TypeError} - If `func` is not a function.
+ * @example
+ *
+ * const afterFn = after(3, () => {
+ *  console.log("called")
+ * });
+ *
+ * // Will not log anything.
+ * afterFn()
+ * // Will not log anything.
+ * afterFn()
+ * // Will log 'called'.
+ * afterFn()
+ */
+declare function after<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
+
+export { after };

package/dist/compat/function/after.mjs

@@ -0,0 +1,15 @@
+import { toInteger } from '../util/toInteger.mjs';
+
+function after(n, func) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    n = toInteger(n);
+    return function (...args) {
+        if (--n < 1) {
+            return func.apply(this, args);
+        }
+    };
+}
+
+export { after };

package/dist/compat/index.d.mts

@@ -28,7 +28,6 @@ export { zipObject } from '../array/zipObject.mjs';
 export { zipWith } from '../array/zipWith.mjs';
 export { AbortError } from '../error/AbortError.mjs';
 export { TimeoutError } from '../error/TimeoutError.mjs';
-export { after } from '../function/after.mjs';
 export { identity } from '../function/identity.mjs';
 export { MemoizeCache, memoize } from '../function/memoize.mjs';
 export { negate } from '../function/negate.mjs';
@@ -118,6 +117,7 @@ export { unzip } from './array/unzip.mjs';
 export { without } from './array/without.mjs';
 export { zip } from './array/zip.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
+export { after } from './function/after.mjs';
 export { ary } from './function/ary.mjs';
 export { attempt } from './function/attempt.mjs';
 export { before } from './function/before.mjs';

package/dist/compat/index.d.ts

@@ -28,7 +28,6 @@ export { zipObject } from '../array/zipObject.js';
 export { zipWith } from '../array/zipWith.js';
 export { AbortError } from '../error/AbortError.js';
 export { TimeoutError } from '../error/TimeoutError.js';
-export { after } from '../function/after.js';
 export { identity } from '../function/identity.js';
 export { MemoizeCache, memoize } from '../function/memoize.js';
 export { negate } from '../function/negate.js';
@@ -118,6 +117,7 @@ export { unzip } from './array/unzip.js';
 export { without } from './array/without.js';
 export { zip } from './array/zip.js';
 export { zipObjectDeep } from './array/zipObjectDeep.js';
+export { after } from './function/after.js';
 export { ary } from './function/ary.js';
 export { attempt } from './function/attempt.js';
 export { before } from './function/before.js';

package/dist/compat/index.js

@@ -1390,6 +1390,18 @@ function zipObjectDeep(keys, values) {
     return result;
 }
 
+function after(n, func) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    n = toInteger(n);
+    return function (...args) {
+        if (--n < 1) {
+            return func.apply(this, args);
+        }
+    };
+}
+
 function ary(func, n = func.length, guard) {
     if (guard) {
         n = func.length;
@@ -2945,7 +2957,6 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = unary.after;
 exports.identity = unary.identity;
 exports.memoize = unary.memoize;
 exports.negate = unary.negate;
@@ -2987,6 +2998,7 @@ exports.constantCase = upperFirst$1.constantCase;
 exports.pascalCase = upperFirst$1.pascalCase;
 exports.invariant = util_index.invariant;
 exports.add = add;
+exports.after = after;
 exports.ary = ary;
 exports.assignIn = assignIn;
 exports.attempt = attempt;

package/dist/compat/index.mjs

@@ -28,7 +28,6 @@ export { zipObject } from '../array/zipObject.mjs';
 export { zipWith } from '../array/zipWith.mjs';
 export { AbortError } from '../error/AbortError.mjs';
 export { TimeoutError } from '../error/TimeoutError.mjs';
-export { after } from '../function/after.mjs';
 export { identity } from '../function/identity.mjs';
 export { memoize } from '../function/memoize.mjs';
 export { negate } from '../function/negate.mjs';
@@ -120,6 +119,7 @@ export { unzip } from './array/unzip.mjs';
 export { without } from './array/without.mjs';
 export { zip } from './array/zip.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
+export { after } from './function/after.mjs';
 export { ary } from './function/ary.mjs';
 export { attempt } from './function/attempt.mjs';
 export { before } from './function/before.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.29.0-dev.946+8db96e45",
+  "version": "1.29.0-dev.948+f7b12269",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {