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

package/dist/compat/index.mjs

@@ -13,37 +13,40 @@ import {
   set,
   startsWith,
   zipObjectDeep
-} from "../chunk-YNJH6GEG.mjs";
+} from "../chunk-EEHJ656S.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,33 +123,19 @@ import {
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
-import "../chunk-F47GLYUU.mjs";
-import {
-  TimeoutError
-} from "../chunk-KIOYQRMQ.mjs";
-import "../chunk-ZA2XI3OV.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
-import {
-  after
-} from "../chunk-OGZMEWPR.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
+import "../chunk-DDH7K4QM.mjs";
 import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
+  zipWith
+} from "../chunk-MJ7LNBI6.mjs";
 import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
+  unzip
+} from "../chunk-JCRY7ZYS.mjs";
 import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
+  unzipWith
+} from "../chunk-IFNXROZR.mjs";
 import {
-  AbortError
-} from "../chunk-DXB7EZUQ.mjs";
-import "../chunk-DDH7K4QM.mjs";
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
   xor
 } from "../chunk-L7FQX5MN.mjs";
@@ -163,14 +152,23 @@ import {
   zipObject
 } from "../chunk-6GWEY5EL.mjs";
 import {
-  zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+  takeWhile
+} from "../chunk-2IXFGSUA.mjs";
+import {
+  toFilled
+} from "../chunk-XHSIT5DL.mjs";
+import {
+  union
+} from "../chunk-R6QA7PLZ.mjs";
 import {
   unionBy
 } from "../chunk-NFS7RWWE.mjs";
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
+import {
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
   uniqBy
 } from "../chunk-B4COTK4K.mjs";
@@ -178,20 +176,26 @@ import {
   uniqWith
 } from "../chunk-237HGSZS.mjs";
 import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
 import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import {
+  randomInt
+} from "../chunk-GIWAOOFY.mjs";
+import {
+  random
+} from "../chunk-SYWMYQYJ.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
 import {
   tail
-} from "../chunk-TJ4Z5I7M.mjs";
+} from "../chunk-DLS7UJKJ.mjs";
 import {
   take
 } from "../chunk-ME352XO7.mjs";
@@ -202,23 +206,20 @@ import {
   takeRightWhile
 } from "../chunk-NTLX2MPV.mjs";
 import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
-import {
-  toFilled
-} from "../chunk-OP4OAKQJ.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
-  union
-} from "../chunk-R6QA7PLZ.mjs";
+  intersectionBy
+} from "../chunk-O6UXZR3U.mjs";
 import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
+  intersectionWith
+} from "../chunk-XI7KRD2C.mjs";
 import {
   keyBy
 } from "../chunk-AJKZMN2V.mjs";
 import {
   last
-} from "../chunk-KPBQ7OUY.mjs";
+} from "../chunk-DTTKJ3VC.mjs";
 import {
   maxBy
 } from "../chunk-OOKNBU4V.mjs";
@@ -229,20 +230,14 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
-import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
-import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
+  flatMap
+} from "../chunk-UY76KTPE.mjs";
 import {
-  randomInt
-} from "../chunk-GIWAOOFY.mjs";
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
-  random
-} from "../chunk-SYWMYQYJ.mjs";
+  flatten
+} from "../chunk-33MSBDC6.mjs";
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
@@ -251,19 +246,17 @@ import {
 } from "../chunk-E6E4RZLN.mjs";
 import {
   head
-} from "../chunk-HM2JT2RX.mjs";
+} from "../chunk-FZZNWXDM.mjs";
 import {
   initial
 } from "../chunk-XPSOKBRZ.mjs";
+import "../chunk-JPUKH67K.mjs";
 import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
-import {
-  intersectionBy
-} from "../chunk-O6UXZR3U.mjs";
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
 import {
-  intersectionWith
-} from "../chunk-XI7KRD2C.mjs";
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
 import {
   drop
 } from "../chunk-3EZAFZG3.mjs";
@@ -276,31 +269,41 @@ import {
 import {
   dropWhile
 } from "../chunk-LJ2C6MVP.mjs";
-import "../chunk-YFN6KOC4.mjs";
+import "../chunk-GTFDDKZ2.mjs";
+import "../chunk-ZA2XI3OV.mjs";
 import {
-  flatMap
-} from "../chunk-UY76KTPE.mjs";
+  negate
+} from "../chunk-BOOQBJN2.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import {
-  flatten
-} from "../chunk-33MSBDC6.mjs";
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
 import "../chunk-E6C5EZQA.mjs";
 import {
   compact
-} from "../chunk-DTJJIMKJ.mjs";
+} from "../chunk-PJPGJ2O6.mjs";
 import {
   countBy
-} from "../chunk-CRSKT4WW.mjs";
-import "../chunk-JPUKH67K.mjs";
+} from "../chunk-Z7HWEOQX.mjs";
+import "../chunk-F47GLYUU.mjs";
 import {
-  differenceBy
-} from "../chunk-LVWX5B43.mjs";
+  AbortError
+} from "../chunk-DXB7EZUQ.mjs";
 import {
-  differenceWith
-} from "../chunk-6NVQAHXP.mjs";
-import "../chunk-24FKGR6U.mjs";
+  TimeoutError
+} from "../chunk-KIOYQRMQ.mjs";
+import {
+  after
+} from "../chunk-OGZMEWPR.mjs";
+import {
+  debounce
+} from "../chunk-MSHSKENG.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

@@ -1,13 +1,4 @@
 import "../chunk-ZA2XI3OV.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
-import {
-  after
-} from "../chunk-OGZMEWPR.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
 import {
   negate
 } from "../chunk-BOOQBJN2.mjs";
@@ -17,7 +8,16 @@ import {
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
-import "../chunk-24FKGR6U.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
+import {
+  after
+} from "../chunk-OGZMEWPR.mjs";
+import {
+  debounce
+} from "../chunk-MSHSKENG.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';