es-toolkit 1.13.1-dev.313 → 1.13.1-dev.315

package/dist/compat/index.mjs

@@ -12,9 +12,12 @@ import {
   set,
   startsWith,
   zipObjectDeep
-} from "../chunk-PYFT73RZ.mjs";
+} from "../chunk-HKO7DEJK.mjs";
 import "../chunk-NKLIE2OI.mjs";
 import "../chunk-XT74R35S.mjs";
+import {
+  startCase
+} from "../chunk-QXTNZR7B.mjs";
 import {
   camelCase
 } from "../chunk-Y5V7UAZZ.mjs";
@@ -30,9 +33,6 @@ import {
 import {
   snakeCase
 } from "../chunk-F3WCQQET.mjs";
-import {
-  startCase
-} from "../chunk-QXTNZR7B.mjs";
 import "../chunk-WVQ7YVRK.mjs";
 import "../chunk-4OIZM4HS.mjs";
 import {
@@ -58,16 +58,19 @@ import {
 import {
   isArrayLike
 } from "../chunk-LPZZIY5Z.mjs";
+import {
+  isLength
+} from "../chunk-27QMXBLJ.mjs";
 import {
   isEqual
 } from "../chunk-JYSV56US.mjs";
 import {
   isFunction
 } from "../chunk-74CREQXW.mjs";
-import {
-  isLength
-} from "../chunk-27QMXBLJ.mjs";
 import "../chunk-54TK5BIS.mjs";
+import {
+  omit
+} from "../chunk-WFZXCGEG.mjs";
 import {
   omitBy
 } from "../chunk-BCTYOXT7.mjs";
@@ -87,10 +90,10 @@ import "../chunk-MIGAC7F4.mjs";
 import {
   invert
 } from "../chunk-OLX53VEF.mjs";
-import {
-  omit
-} from "../chunk-WFZXCGEG.mjs";
 import "../chunk-FUS75PJ7.mjs";
+import {
+  range
+} from "../chunk-DPH2KE6O.mjs";
 import {
   round
 } from "../chunk-5PMKOZ2F.mjs";
@@ -112,10 +115,13 @@ import {
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
-import {
-  range
-} from "../chunk-DPH2KE6O.mjs";
 import "../chunk-DDH7K4QM.mjs";
+import {
+  zipWith
+} from "../chunk-4KYXHZ4R.mjs";
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
 import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
@@ -138,8 +144,8 @@ import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
-  zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+  takeWhile
+} from "../chunk-2IXFGSUA.mjs";
 import {
   toFilled
 } from "../chunk-OP4OAKQJ.mjs";
@@ -162,8 +168,8 @@ import {
   uniqWith
 } from "../chunk-237HGSZS.mjs";
 import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
@@ -192,8 +198,8 @@ import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
 import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
   intersectionBy
 } from "../chunk-O6UXZR3U.mjs";
@@ -216,11 +222,14 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
+  flatMap
+} from "../chunk-UY76KTPE.mjs";
 import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
+import {
+  flatten
+} from "../chunk-33MSBDC6.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -233,9 +242,7 @@ import {
 import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
-import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
+import "../chunk-JPUKH67K.mjs";
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
@@ -255,12 +262,19 @@ import {
   dropWhile
 } from "../chunk-LJ2C6MVP.mjs";
 import "../chunk-YFN6KOC4.mjs";
+import "../chunk-ZA2XI3OV.mjs";
 import {
-  flatMap
-} from "../chunk-UY76KTPE.mjs";
+  negate
+} from "../chunk-BOOQBJN2.mjs";
 import {
-  flatten
-} from "../chunk-33MSBDC6.mjs";
+  noop
+} from "../chunk-LKXCOLNY.mjs";
+import {
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
 import "../chunk-E6C5EZQA.mjs";
 import {
   compact
@@ -268,7 +282,6 @@ import {
 import {
   countBy
 } from "../chunk-CRSKT4WW.mjs";
-import "../chunk-JPUKH67K.mjs";
 import "../chunk-F47GLYUU.mjs";
 import {
   AbortError
@@ -276,19 +289,9 @@ import {
 import {
   TimeoutError
 } from "../chunk-KIOYQRMQ.mjs";
-import "../chunk-236H5JZJ.mjs";
 import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
+  after
+} from "../chunk-OGZMEWPR.mjs";
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
@@ -296,6 +299,7 @@ import "../chunk-24FKGR6U.mjs";
 export {
   AbortError,
   TimeoutError,
+  after,
   camelCase,
   capitalize,
   chunk,

package/dist/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 {F} - 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 {Error} - Throws an error if `n` is negative.
+ * @example
+ *
+ * const afterFn = after(3, () => {
+ *  console.log("called")
+ * });
+ *
+ * // Will not log anything.
+ * afterFn()
+ * // Will not log anything.
+ * afterFn()
+ * // Will log 'called'.
+ * afterFn()
+ */
+declare const after: <F extends (...args: any[]) => any>(n: number, func: F) => F;
+
+export { after };

package/dist/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 {F} - 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 {Error} - Throws an error if `n` is negative.
+ * @example
+ *
+ * const afterFn = after(3, () => {
+ *  console.log("called")
+ * });
+ *
+ * // Will not log anything.
+ * afterFn()
+ * // Will not log anything.
+ * afterFn()
+ * // Will log 'called'.
+ * afterFn()
+ */
+declare const after: <F extends (...args: any[]) => any>(n: number, func: F) => F;
+
+export { after };

package/dist/function/after.js

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/function/after.ts
+var after_exports = {};
+__export(after_exports, {
+  after: () => after
+});
+module.exports = __toCommonJS(after_exports);
+var after = (n, func) => {
+  if (!Number.isInteger(n) || n < 0) {
+    throw new Error(`n must be a non-negative integer.`);
+  }
+  let counter = 0;
+  return (...args) => {
+    if (++counter >= n) {
+      return func(...args);
+    }
+    return void 0;
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  after
+});
+//# sourceMappingURL=after.js.map

package/dist/function/after.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/function/after.ts"],"sourcesContent":["/**\n * Creates a function that only executes starting from the `n`-th call.\n * The provided function will be invoked starting from the `n`-th call.\n *\n * This is particularly useful for scenarios involving events or asynchronous operations\n * where an action should occur only after a certain number of invocations.\n *\n * @template F - The type of the function to be invoked.\n * @param {number} n - The number of calls required for `func` to execute.\n * @param {F} func - The function to be invoked.\n * @returns {F} - A new function that:\n * - Tracks the number of calls.\n * - Invokes `func` starting from the `n`-th call.\n * - Returns `undefined` if fewer than `n` calls have been made.\n * @throws {Error} - Throws an error if `n` is negative.\n * @example\n *\n * const afterFn = after(3, () => {\n *  console.log(\"called\")\n * });\n *\n * // Will not log anything.\n * afterFn()\n * // Will not log anything.\n * afterFn()\n * // Will log 'called'.\n * afterFn()\n */\n\nexport const after = <F extends (...args: any[]) => any>(n: number, func: F): F => {\n  if (!Number.isInteger(n) || n < 0) {\n    throw new Error(`n must be a non-negative integer.`);\n  }\n\n  let counter = 0;\n  return ((...args: Parameters<F>) => {\n    if (++counter >= n) {\n      return func(...args);\n    }\n    return undefined;\n  }) as F;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA6BO,IAAM,QAAQ,CAAoC,GAAW,SAAe;AACjF,MAAI,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG;AACjC,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAEA,MAAI,UAAU;AACd,SAAQ,IAAI,SAAwB;AAClC,QAAI,EAAE,WAAW,GAAG;AAClB,aAAO,KAAK,GAAG,IAAI;AAAA,IACrB;AACA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/function/after.mjs

@@ -0,0 +1,8 @@
+import {
+  after
+} from "../chunk-OGZMEWPR.mjs";
+import "../chunk-24FKGR6U.mjs";
+export {
+  after
+};
+//# sourceMappingURL=after.mjs.map

package/dist/function/after.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/function/index.d.mts

@@ -1,3 +1,4 @@
+export { after } from './after.mjs';
 export { debounce } from './debounce.mjs';
 export { noop } from './noop.mjs';
 export { once } from './once.mjs';

package/dist/function/index.d.ts

@@ -1,3 +1,4 @@
+export { after } from './after.js';
 export { debounce } from './debounce.js';
 export { noop } from './noop.js';
 export { once } from './once.js';

package/dist/function/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/function/index.ts
 var function_exports = {};
 __export(function_exports, {
+  after: () => after,
   debounce: () => debounce,
   negate: () => negate,
   noop: () => noop,
@@ -28,6 +29,20 @@ __export(function_exports, {
 });
 module.exports = __toCommonJS(function_exports);
 
+// src/function/after.ts
+var after = (n, func) => {
+  if (!Number.isInteger(n) || n < 0) {
+    throw new Error(`n must be a non-negative integer.`);
+  }
+  let counter = 0;
+  return (...args) => {
+    if (++counter >= n) {
+      return func(...args);
+    }
+    return void 0;
+  };
+};
+
 // src/function/debounce.ts
 function debounce(func, debounceMs, { signal } = {}) {
   let timeoutId = null;
@@ -94,6 +109,7 @@ function negate(func) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  after,
   debounce,
   negate,
   noop,

package/dist/function/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/function/index.ts","../../src/function/debounce.ts","../../src/function/noop.ts","../../src/function/once.ts","../../src/function/throttle.ts","../../src/function/negate.ts"],"sourcesContent":["export { debounce } from './debounce.ts';\nexport { noop } from './noop.ts';\nexport { once } from './once.ts';\nexport { throttle } from './throttle.ts';\nexport { negate } from './negate.ts';\n","interface DebounceOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds\n * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`\n * method to cancel any pending execution.\n *\n * @template F - The type of function.\n * @param {F} func - The function to debounce.\n * @param {number} debounceMs - The number of milliseconds to delay.\n * @param {DebounceOptions} options - The options object.\n * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.\n * @returns {F & { cancel: () => void }} A new debounced function with a `cancel` method.\n *\n * @example\n * const debouncedFunction = debounce(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' after 1 second if not called again in that time\n * debouncedFunction();\n *\n * // Will not log anything as the previous call is canceled\n * debouncedFunction.cancel();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const signal = controller.signal;\n * const debouncedWithSignal = debounce(() => {\n *  console.log('Function executed');\n * }, 1000, { signal });\n *\n * debouncedWithSignal();\n *\n * // Will cancel the debounced function call\n * controller.abort();\n */\nexport function debounce<F extends (...args: any[]) => void>(\n  func: F,\n  debounceMs: number,\n  { signal }: DebounceOptions = {}\n): F & { cancel: () => void } {\n  let timeoutId: number | null = null;\n\n  const debounced = function (...args: Parameters<F>) {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (signal?.aborted) {\n      return;\n    }\n\n    timeoutId = setTimeout(() => {\n      func(...args);\n      timeoutId = null;\n    }, debounceMs) as any;\n  } as F & { cancel: () => void };\n\n  const onAbort = function () {\n    debounced.cancel();\n  };\n\n  debounced.cancel = function () {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  signal?.addEventListener('abort', onAbort, { once: true });\n\n  return debounced;\n}\n","/**\n * A no-operation function that does nothing.\n * This can be used as a placeholder or default function.\n *\n * @example\n * noop(); // Does nothing\n *\n * @returns {void} This function does not return anything.\n */\nexport function noop(): void {}\n","/**\n * Creates a function that is restricted to invoking the provided function `func` once.\n * Repeated calls to the function will return the value from the first invocation.\n *\n * @template F - The type of function.\n * @param {F} func - The function to restrict.\n * @returns {F} A new function that invokes `func` once and caches the result.\n *\n * @example\n * const initialize = once(() => {\n *   console.log('Initialized!');\n *   return true;\n * });\n *\n * initialize(); // Logs: 'Initialized!' and returns true\n * initialize(); // Returns true without logging\n */\nexport function once<F extends () => any>(func: F): F {\n  let called = false;\n  let cache: ReturnType<F> | undefined;\n\n  return function () {\n    if (called) {\n      return cache;\n    }\n\n    const result = func();\n\n    called = true;\n    cache = result;\n\n    return result;\n  } as F;\n}\n","/**\n * Creates a throttled function that only invokes the provided function at most once\n * per every `throttleMs` milliseconds. Subsequent calls to the throttled function\n * within the wait time will not trigger the execution of the original function.\n *\n * @template F - The type of function.\n * @param {F} func - The function to throttle.\n * @param {number} throttleMs - The number of milliseconds to throttle executions to.\n * @returns {F} A new throttled function that accepts the same parameters as the original function.\n *\n * @example\n * const throttledFunction = throttle(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' immediately\n * throttledFunction();\n *\n * // Will not log anything as it is within the throttle time\n * throttledFunction();\n *\n * // After 1 second\n * setTimeout(() => {\n *   throttledFunction(); // Will log 'Function executed'\n * }, 1000);\n */\nexport function throttle<F extends (...args: any[]) => void>(func: F, throttleMs: number): F {\n  let lastCallTime: number | null;\n\n  const throttledFunction = function (...args: Parameters<F>) {\n    const now = Date.now();\n\n    if (lastCallTime == null || now - lastCallTime >= throttleMs) {\n      lastCallTime = now;\n      func(...args);\n    }\n  } as F;\n\n  return throttledFunction;\n}\n","/**\n * Creates a function that negates the result of the predicate function.\n *\n * @template F - The type of the function to negate.\n * @param {F} func - The function to negate.\n * @returns {F} The new negated function, which negates the boolean result of `func`.\n */\nexport function negate<F extends (...args: unknown[]) => boolean>(func: F): F {\n    return ((...args: any[]) => !func(...args)) as F;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuCO,SAAS,SACd,MACA,YACA,EAAE,OAAO,IAAqB,CAAC,GACH;AAC5B,MAAI,YAA2B;AAE/B,QAAM,YAAY,YAAa,MAAqB;AAClD,QAAI,cAAc,MAAM;AACtB,mBAAa,SAAS;AAAA,IACxB;AAEA,QAAI,iCAAQ,SAAS;AACnB;AAAA,IACF;AAEA,gBAAY,WAAW,MAAM;AAC3B,WAAK,GAAG,IAAI;AACZ,kBAAY;AAAA,IACd,GAAG,UAAU;AAAA,EACf;AAEA,QAAM,UAAU,WAAY;AAC1B,cAAU,OAAO;AAAA,EACnB;AAEA,YAAU,SAAS,WAAY;AAC7B,QAAI,cAAc,MAAM;AACtB,mBAAa,SAAS;AACtB,kBAAY;AAAA,IACd;AAAA,EACF;AAEA,mCAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK;AAExD,SAAO;AACT;;;AClEO,SAAS,OAAa;AAAC;;;ACQvB,SAAS,KAA0B,MAAY;AACpD,MAAI,SAAS;AACb,MAAI;AAEJ,SAAO,WAAY;AACjB,QAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAEA,UAAM,SAAS,KAAK;AAEpB,aAAS;AACT,YAAQ;AAER,WAAO;AAAA,EACT;AACF;;;ACPO,SAAS,SAA6C,MAAS,YAAuB;AAC3F,MAAI;AAEJ,QAAM,oBAAoB,YAAa,MAAqB;AAC1D,UAAM,MAAM,KAAK,IAAI;AAErB,QAAI,gBAAgB,QAAQ,MAAM,gBAAgB,YAAY;AAC5D,qBAAe;AACf,WAAK,GAAG,IAAI;AAAA,IACd;AAAA,EACF;AAEA,SAAO;AACT;;;AChCO,SAAS,OAAkD,MAAY;AAC1E,SAAQ,IAAI,SAAgB,CAAC,KAAK,GAAG,IAAI;AAC7C;","names":[]}
+{"version":3,"sources":["../../src/function/index.ts","../../src/function/after.ts","../../src/function/debounce.ts","../../src/function/noop.ts","../../src/function/once.ts","../../src/function/throttle.ts","../../src/function/negate.ts"],"sourcesContent":["export { after } from './after.ts';\nexport { debounce } from './debounce.ts';\nexport { noop } from './noop.ts';\nexport { once } from './once.ts';\nexport { throttle } from './throttle.ts';\nexport { negate } from './negate.ts';\n","/**\n * Creates a function that only executes starting from the `n`-th call.\n * The provided function will be invoked starting from the `n`-th call.\n *\n * This is particularly useful for scenarios involving events or asynchronous operations\n * where an action should occur only after a certain number of invocations.\n *\n * @template F - The type of the function to be invoked.\n * @param {number} n - The number of calls required for `func` to execute.\n * @param {F} func - The function to be invoked.\n * @returns {F} - A new function that:\n * - Tracks the number of calls.\n * - Invokes `func` starting from the `n`-th call.\n * - Returns `undefined` if fewer than `n` calls have been made.\n * @throws {Error} - Throws an error if `n` is negative.\n * @example\n *\n * const afterFn = after(3, () => {\n *  console.log(\"called\")\n * });\n *\n * // Will not log anything.\n * afterFn()\n * // Will not log anything.\n * afterFn()\n * // Will log 'called'.\n * afterFn()\n */\n\nexport const after = <F extends (...args: any[]) => any>(n: number, func: F): F => {\n  if (!Number.isInteger(n) || n < 0) {\n    throw new Error(`n must be a non-negative integer.`);\n  }\n\n  let counter = 0;\n  return ((...args: Parameters<F>) => {\n    if (++counter >= n) {\n      return func(...args);\n    }\n    return undefined;\n  }) as F;\n};\n","interface DebounceOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds\n * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`\n * method to cancel any pending execution.\n *\n * @template F - The type of function.\n * @param {F} func - The function to debounce.\n * @param {number} debounceMs - The number of milliseconds to delay.\n * @param {DebounceOptions} options - The options object.\n * @param {AbortSignal} options.signal - An optional AbortSignal to cancel the debounced function.\n * @returns {F & { cancel: () => void }} A new debounced function with a `cancel` method.\n *\n * @example\n * const debouncedFunction = debounce(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' after 1 second if not called again in that time\n * debouncedFunction();\n *\n * // Will not log anything as the previous call is canceled\n * debouncedFunction.cancel();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const signal = controller.signal;\n * const debouncedWithSignal = debounce(() => {\n *  console.log('Function executed');\n * }, 1000, { signal });\n *\n * debouncedWithSignal();\n *\n * // Will cancel the debounced function call\n * controller.abort();\n */\nexport function debounce<F extends (...args: any[]) => void>(\n  func: F,\n  debounceMs: number,\n  { signal }: DebounceOptions = {}\n): F & { cancel: () => void } {\n  let timeoutId: number | null = null;\n\n  const debounced = function (...args: Parameters<F>) {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (signal?.aborted) {\n      return;\n    }\n\n    timeoutId = setTimeout(() => {\n      func(...args);\n      timeoutId = null;\n    }, debounceMs) as any;\n  } as F & { cancel: () => void };\n\n  const onAbort = function () {\n    debounced.cancel();\n  };\n\n  debounced.cancel = function () {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  signal?.addEventListener('abort', onAbort, { once: true });\n\n  return debounced;\n}\n","/**\n * A no-operation function that does nothing.\n * This can be used as a placeholder or default function.\n *\n * @example\n * noop(); // Does nothing\n *\n * @returns {void} This function does not return anything.\n */\nexport function noop(): void {}\n","/**\n * Creates a function that is restricted to invoking the provided function `func` once.\n * Repeated calls to the function will return the value from the first invocation.\n *\n * @template F - The type of function.\n * @param {F} func - The function to restrict.\n * @returns {F} A new function that invokes `func` once and caches the result.\n *\n * @example\n * const initialize = once(() => {\n *   console.log('Initialized!');\n *   return true;\n * });\n *\n * initialize(); // Logs: 'Initialized!' and returns true\n * initialize(); // Returns true without logging\n */\nexport function once<F extends () => any>(func: F): F {\n  let called = false;\n  let cache: ReturnType<F> | undefined;\n\n  return function () {\n    if (called) {\n      return cache;\n    }\n\n    const result = func();\n\n    called = true;\n    cache = result;\n\n    return result;\n  } as F;\n}\n","/**\n * Creates a throttled function that only invokes the provided function at most once\n * per every `throttleMs` milliseconds. Subsequent calls to the throttled function\n * within the wait time will not trigger the execution of the original function.\n *\n * @template F - The type of function.\n * @param {F} func - The function to throttle.\n * @param {number} throttleMs - The number of milliseconds to throttle executions to.\n * @returns {F} A new throttled function that accepts the same parameters as the original function.\n *\n * @example\n * const throttledFunction = throttle(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' immediately\n * throttledFunction();\n *\n * // Will not log anything as it is within the throttle time\n * throttledFunction();\n *\n * // After 1 second\n * setTimeout(() => {\n *   throttledFunction(); // Will log 'Function executed'\n * }, 1000);\n */\nexport function throttle<F extends (...args: any[]) => void>(func: F, throttleMs: number): F {\n  let lastCallTime: number | null;\n\n  const throttledFunction = function (...args: Parameters<F>) {\n    const now = Date.now();\n\n    if (lastCallTime == null || now - lastCallTime >= throttleMs) {\n      lastCallTime = now;\n      func(...args);\n    }\n  } as F;\n\n  return throttledFunction;\n}\n","/**\n * Creates a function that negates the result of the predicate function.\n *\n * @template F - The type of the function to negate.\n * @param {F} func - The function to negate.\n * @returns {F} The new negated function, which negates the boolean result of `func`.\n */\nexport function negate<F extends (...args: unknown[]) => boolean>(func: F): F {\n    return ((...args: any[]) => !func(...args)) as F;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC6BO,IAAM,QAAQ,CAAoC,GAAW,SAAe;AACjF,MAAI,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG;AACjC,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AAEA,MAAI,UAAU;AACd,SAAQ,IAAI,SAAwB;AAClC,QAAI,EAAE,WAAW,GAAG;AAClB,aAAO,KAAK,GAAG,IAAI;AAAA,IACrB;AACA,WAAO;AAAA,EACT;AACF;;;ACFO,SAAS,SACd,MACA,YACA,EAAE,OAAO,IAAqB,CAAC,GACH;AAC5B,MAAI,YAA2B;AAE/B,QAAM,YAAY,YAAa,MAAqB;AAClD,QAAI,cAAc,MAAM;AACtB,mBAAa,SAAS;AAAA,IACxB;AAEA,QAAI,iCAAQ,SAAS;AACnB;AAAA,IACF;AAEA,gBAAY,WAAW,MAAM;AAC3B,WAAK,GAAG,IAAI;AACZ,kBAAY;AAAA,IACd,GAAG,UAAU;AAAA,EACf;AAEA,QAAM,UAAU,WAAY;AAC1B,cAAU,OAAO;AAAA,EACnB;AAEA,YAAU,SAAS,WAAY;AAC7B,QAAI,cAAc,MAAM;AACtB,mBAAa,SAAS;AACtB,kBAAY;AAAA,IACd;AAAA,EACF;AAEA,mCAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK;AAExD,SAAO;AACT;;;AClEO,SAAS,OAAa;AAAC;;;ACQvB,SAAS,KAA0B,MAAY;AACpD,MAAI,SAAS;AACb,MAAI;AAEJ,SAAO,WAAY;AACjB,QAAI,QAAQ;AACV,aAAO;AAAA,IACT;AAEA,UAAM,SAAS,KAAK;AAEpB,aAAS;AACT,YAAQ;AAER,WAAO;AAAA,EACT;AACF;;;ACPO,SAAS,SAA6C,MAAS,YAAuB;AAC3F,MAAI;AAEJ,QAAM,oBAAoB,YAAa,MAAqB;AAC1D,UAAM,MAAM,KAAK,IAAI;AAErB,QAAI,gBAAgB,QAAQ,MAAM,gBAAgB,YAAY;AAC5D,qBAAe;AACf,WAAK,GAAG,IAAI;AAAA,IACd;AAAA,EACF;AAEA,SAAO;AACT;;;AChCO,SAAS,OAAkD,MAAY;AAC1E,SAAQ,IAAI,SAAgB,CAAC,KAAK,GAAG,IAAI;AAC7C;","names":[]}

package/dist/function/index.mjs

@@ -1,4 +1,4 @@
-import "../chunk-236H5JZJ.mjs";
+import "../chunk-ZA2XI3OV.mjs";
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
@@ -11,11 +11,15 @@ import {
 import {
   throttle
 } from "../chunk-QOJGMVVR.mjs";
+import {
+  after
+} from "../chunk-OGZMEWPR.mjs";
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
 import "../chunk-24FKGR6U.mjs";
 export {
+  after,
   debounce,
   negate,
   noop,

package/dist/index.d.mts

@@ -51,6 +51,7 @@ export { last } from './array/last.mjs';
 export { initial } from './array/initial.mjs';
 export { AbortError } from './error/AbortError.mjs';
 export { TimeoutError } from './error/TimeoutError.mjs';
+export { after } from './function/after.mjs';
 export { debounce } from './function/debounce.mjs';
 export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export { last } from './array/last.js';
 export { initial } from './array/initial.js';
 export { AbortError } from './error/AbortError.js';
 export { TimeoutError } from './error/TimeoutError.js';
+export { after } from './function/after.js';
 export { debounce } from './function/debounce.js';
 export { noop } from './function/noop.js';
 export { once } from './function/once.js';

package/dist/index.js

@@ -56,6 +56,7 @@ var src_exports = {};
 __export(src_exports, {
   AbortError: () => AbortError,
   TimeoutError: () => TimeoutError,
+  after: () => after,
   camelCase: () => camelCase,
   capitalize: () => capitalize,
   chunk: () => chunk,
@@ -691,6 +692,20 @@ var TimeoutError = class extends Error {
   }
 };
 
+// src/function/after.ts
+var after = (n, func) => {
+  if (!Number.isInteger(n) || n < 0) {
+    throw new Error(`n must be a non-negative integer.`);
+  }
+  let counter = 0;
+  return (...args) => {
+    if (++counter >= n) {
+      return func(...args);
+    }
+    return void 0;
+  };
+};
+
 // src/function/debounce.ts
 function debounce(func, debounceMs, { signal } = {}) {
   let timeoutId = null;
@@ -1132,6 +1147,7 @@ function startCase(str) {
 0 && (module.exports = {
   AbortError,
   TimeoutError,
+  after,
   camelCase,
   capitalize,
   chunk,