es-toolkit 1.13.1-dev.320 → 1.13.1-dev.321

package/dist/compat/index.mjs

@@ -13,37 +13,40 @@ import {
   set,
   startsWith,
   zipObjectDeep
-} from "../chunk-YNJH6GEG.mjs";
+} from "../chunk-IGM5IABU.mjs";
 import "../chunk-NKLIE2OI.mjs";
 import "../chunk-4OIZM4HS.mjs";
 import {
   withTimeout
-} from "../chunk-IIDZ3KAJ.mjs";
-import "../chunk-CVVZHOJX.mjs";
+} from "../chunk-ZPNX2QDE.mjs";
+import "../chunk-EZYYB34V.mjs";
 import {
   delay
-} from "../chunk-O64NE2P4.mjs";
+} from "../chunk-4DFAGGIM.mjs";
 import "../chunk-XT74R35S.mjs";
+import {
+  kebabCase
+} from "../chunk-ET33L3MQ.mjs";
 import {
   lowerCase
-} from "../chunk-5IKVJGHO.mjs";
+} from "../chunk-RTFTLCF3.mjs";
 import {
   snakeCase
-} from "../chunk-F3WCQQET.mjs";
+} from "../chunk-IWXZI3QT.mjs";
 import {
   startCase
-} from "../chunk-QXTNZR7B.mjs";
+} from "../chunk-3SBT6WDU.mjs";
 import {
   camelCase
-} from "../chunk-Y5V7UAZZ.mjs";
+} from "../chunk-4ZES5T6V.mjs";
+import "../chunk-OG2RLT5U.mjs";
 import {
   capitalize
 } from "../chunk-U56ZOM7L.mjs";
+import "../chunk-YXD3AQAK.mjs";
 import {
-  kebabCase
-} from "../chunk-EYYZQFOP.mjs";
-import "../chunk-WVQ7YVRK.mjs";
-import "../chunk-STL6TD3L.mjs";
+  isUndefined
+} from "../chunk-VH2PV426.mjs";
 import {
   isFunction
 } from "../chunk-74CREQXW.mjs";
@@ -56,10 +59,10 @@ import {
 import {
   isNull
 } from "../chunk-AIRSKN47.mjs";
-import "../chunk-SXFMQQ6F.mjs";
 import {
-  isUndefined
-} from "../chunk-VH2PV426.mjs";
+  isPrimitive
+} from "../chunk-R6GLTTAB.mjs";
+import "../chunk-SXFMQQ6F.mjs";
 import {
   isArrayLike
 } from "../chunk-LPZZIY5Z.mjs";
@@ -75,7 +78,7 @@ import {
 } from "../chunk-OLX53VEF.mjs";
 import {
   omit
-} from "../chunk-WFZXCGEG.mjs";
+} from "../chunk-YOPFSFTD.mjs";
 import {
   omitBy
 } from "../chunk-BCTYOXT7.mjs";
@@ -90,7 +93,7 @@ import {
 } from "../chunk-VRUTBJYS.mjs";
 import {
   cloneDeep
-} from "../chunk-5CPXZFCB.mjs";
+} from "../chunk-K5WL54BY.mjs";
 import {
   flattenObject
 } from "../chunk-XGQWTHW6.mjs";
@@ -120,10 +123,6 @@ import {
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
-import "../chunk-F47GLYUU.mjs";
-import {
-  TimeoutError
-} from "../chunk-KIOYQRMQ.mjs";
 import "../chunk-ZA2XI3OV.mjs";
 import {
   throttle
@@ -133,7 +132,7 @@ import {
 } from "../chunk-OGZMEWPR.mjs";
 import {
   debounce
-} from "../chunk-3IP4JVLL.mjs";
+} from "../chunk-MSHSKENG.mjs";
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
@@ -143,40 +142,13 @@ import {
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
-import {
-  AbortError
-} from "../chunk-DXB7EZUQ.mjs";
 import "../chunk-DDH7K4QM.mjs";
-import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
-import {
-  xorBy
-} from "../chunk-Q47NGNXT.mjs";
-import {
-  xorWith
-} from "../chunk-QRSJBBFY.mjs";
-import {
-  zip
-} from "../chunk-OLORW442.mjs";
 import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
-import {
-  unionBy
-} from "../chunk-NFS7RWWE.mjs";
-import {
-  unionWith
-} from "../chunk-2ZCITDMK.mjs";
-import {
-  uniqBy
-} from "../chunk-B4COTK4K.mjs";
-import {
-  uniqWith
-} from "../chunk-237HGSZS.mjs";
 import {
   unzip
 } from "../chunk-UYZKMBDO.mjs";
@@ -187,17 +159,17 @@ import {
   without
 } from "../chunk-PYEYV7BY.mjs";
 import {
-  shuffle
-} from "../chunk-G7UQ5PUR.mjs";
+  xor
+} from "../chunk-L7FQX5MN.mjs";
 import {
-  tail
-} from "../chunk-TJ4Z5I7M.mjs";
+  xorBy
+} from "../chunk-Q47NGNXT.mjs";
 import {
-  take
-} from "../chunk-ME352XO7.mjs";
+  xorWith
+} from "../chunk-QRSJBBFY.mjs";
 import {
-  takeRight
-} from "../chunk-N3QYJX4T.mjs";
+  zip
+} from "../chunk-OLORW442.mjs";
 import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
@@ -211,20 +183,20 @@ import {
   union
 } from "../chunk-R6QA7PLZ.mjs";
 import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
 import {
-  keyBy
-} from "../chunk-AJKZMN2V.mjs";
+  unionWith
+} from "../chunk-2ZCITDMK.mjs";
 import {
-  last
-} from "../chunk-KPBQ7OUY.mjs";
+  uniqWith
+} from "../chunk-237HGSZS.mjs";
 import {
-  maxBy
-} from "../chunk-OOKNBU4V.mjs";
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
-  minBy
-} from "../chunk-IJD7FE2Z.mjs";
+  uniqBy
+} from "../chunk-B4COTK4K.mjs";
 import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
@@ -244,14 +216,17 @@ import {
   random
 } from "../chunk-SYWMYQYJ.mjs";
 import {
-  forEachRight
-} from "../chunk-IEA53J7P.mjs";
+  shuffle
+} from "../chunk-G7UQ5PUR.mjs";
 import {
-  groupBy
-} from "../chunk-E6E4RZLN.mjs";
+  tail
+} from "../chunk-TJ4Z5I7M.mjs";
 import {
-  head
-} from "../chunk-HM2JT2RX.mjs";
+  take
+} from "../chunk-ME352XO7.mjs";
+import {
+  takeRight
+} from "../chunk-N3QYJX4T.mjs";
 import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
@@ -265,17 +240,17 @@ import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
 import {
-  drop
-} from "../chunk-3EZAFZG3.mjs";
+  keyBy
+} from "../chunk-AJKZMN2V.mjs";
 import {
-  dropRight
-} from "../chunk-OXZCMC5I.mjs";
+  last
+} from "../chunk-KPBQ7OUY.mjs";
 import {
-  dropRightWhile
-} from "../chunk-M7SBBYV2.mjs";
+  maxBy
+} from "../chunk-OOKNBU4V.mjs";
 import {
-  dropWhile
-} from "../chunk-LJ2C6MVP.mjs";
+  minBy
+} from "../chunk-IJD7FE2Z.mjs";
 import "../chunk-YFN6KOC4.mjs";
 import {
   flatMap
@@ -286,13 +261,18 @@ import {
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import "../chunk-E6C5EZQA.mjs";
 import {
-  compact
-} from "../chunk-DTJJIMKJ.mjs";
+  forEachRight
+} from "../chunk-IEA53J7P.mjs";
+import {
+  groupBy
+} from "../chunk-E6E4RZLN.mjs";
+import {
+  head
+} from "../chunk-HM2JT2RX.mjs";
 import {
   countBy
-} from "../chunk-CRSKT4WW.mjs";
+} from "../chunk-Z7HWEOQX.mjs";
 import "../chunk-JPUKH67K.mjs";
 import {
   differenceBy
@@ -300,7 +280,30 @@ import {
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
-import "../chunk-24FKGR6U.mjs";
+import {
+  drop
+} from "../chunk-3EZAFZG3.mjs";
+import {
+  dropRight
+} from "../chunk-OXZCMC5I.mjs";
+import {
+  dropRightWhile
+} from "../chunk-M7SBBYV2.mjs";
+import {
+  dropWhile
+} from "../chunk-LJ2C6MVP.mjs";
+import "../chunk-F47GLYUU.mjs";
+import {
+  AbortError
+} from "../chunk-DXB7EZUQ.mjs";
+import {
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
+import "../chunk-E6C5EZQA.mjs";
+import {
+  compact
+} from "../chunk-DTJJIMKJ.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   AbortError,
   TimeoutError,
@@ -349,6 +352,7 @@ export {
   isNotNil,
   isNull,
   isPlainObject,
+  isPrimitive,
   isTypedArray,
   isUndefined,
   kebabCase,

package/dist/error/AbortError.mjs

@@ -1,7 +1,7 @@
 import {
   AbortError
 } from "../chunk-DXB7EZUQ.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   AbortError
 };

package/dist/error/TimeoutError.mjs

@@ -1,7 +1,7 @@
 import {
   TimeoutError
 } from "../chunk-KIOYQRMQ.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   TimeoutError
 };

package/dist/error/index.mjs

@@ -1,11 +1,11 @@
 import "../chunk-F47GLYUU.mjs";
-import {
-  TimeoutError
-} from "../chunk-KIOYQRMQ.mjs";
 import {
   AbortError
 } from "../chunk-DXB7EZUQ.mjs";
-import "../chunk-24FKGR6U.mjs";
+import {
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   AbortError,
   TimeoutError

package/dist/function/after.mjs

@@ -1,7 +1,7 @@
 import {
   after
 } from "../chunk-OGZMEWPR.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   after
 };

package/dist/function/debounce.js

@@ -29,7 +29,7 @@ function debounce(func, debounceMs, { signal } = {}) {
     if (timeoutId !== null) {
       clearTimeout(timeoutId);
     }
-    if (signal == null ? void 0 : signal.aborted) {
+    if (signal?.aborted) {
       return;
     }
     timeoutId = setTimeout(() => {
@@ -46,7 +46,7 @@ function debounce(func, debounceMs, { signal } = {}) {
       timeoutId = null;
     }
   };
-  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  signal?.addEventListener("abort", onAbort, { once: true });
   return debounced;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/function/debounce.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/function/debounce.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAuCO,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;","names":[]}
+{"version":3,"sources":["../../src/function/debounce.ts"],"sourcesContent":["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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAuCO,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,QAAQ,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,UAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AAEzD,SAAO;AACT;","names":[]}

package/dist/function/debounce.mjs

@@ -1,7 +1,7 @@
 import {
   debounce
-} from "../chunk-3IP4JVLL.mjs";
-import "../chunk-24FKGR6U.mjs";
+} from "../chunk-MSHSKENG.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   debounce
 };

package/dist/function/index.js

@@ -50,7 +50,7 @@ function debounce(func, debounceMs, { signal } = {}) {
     if (timeoutId !== null) {
       clearTimeout(timeoutId);
     }
-    if (signal == null ? void 0 : signal.aborted) {
+    if (signal?.aborted) {
       return;
     }
     timeoutId = setTimeout(() => {
@@ -67,7 +67,7 @@ function debounce(func, debounceMs, { signal } = {}) {
       timeoutId = null;
     }
   };
-  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  signal?.addEventListener("abort", onAbort, { once: true });
   return debounced;
 }
 

package/dist/function/index.js.map

@@ -1 +1 @@
-{"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":[]}
+{"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,QAAQ,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,UAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AAEzD,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

@@ -7,7 +7,7 @@ import {
 } from "../chunk-OGZMEWPR.mjs";
 import {
   debounce
-} from "../chunk-3IP4JVLL.mjs";
+} from "../chunk-MSHSKENG.mjs";
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
@@ -17,7 +17,7 @@ import {
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   after,
   debounce,

package/dist/function/negate.mjs

@@ -1,7 +1,7 @@
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   negate
 };

package/dist/function/noop.mjs

@@ -1,7 +1,7 @@
 import {
   noop
 } from "../chunk-LKXCOLNY.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   noop
 };

package/dist/function/once.mjs

@@ -1,7 +1,7 @@
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   once
 };

package/dist/function/throttle.mjs

@@ -1,7 +1,7 @@
 import {
   throttle
 } from "../chunk-QOJGMVVR.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   throttle
 };

package/dist/index.d.mts

@@ -85,6 +85,7 @@ export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isFunction } from './predicate/isFunction.mjs';
 export { isArrayLike } from './predicate/isArrayLike.mjs';
 export { isTypedArray } from './predicate/isTypedArray.mjs';
+export { isPrimitive } from './predicate/isPrimitive.mjs';
 export { delay } from './promise/delay.mjs';
 export { withTimeout } from './promise/withTimeout.mjs';
 export { camelCase } from './string/camelCase.mjs';

package/dist/index.d.ts

@@ -85,6 +85,7 @@ export { isPlainObject } from './predicate/isPlainObject.js';
 export { isFunction } from './predicate/isFunction.js';
 export { isArrayLike } from './predicate/isArrayLike.js';
 export { isTypedArray } from './predicate/isTypedArray.js';
+export { isPrimitive } from './predicate/isPrimitive.js';
 export { delay } from './promise/delay.js';
 export { withTimeout } from './promise/withTimeout.js';
 export { camelCase } from './string/camelCase.js';