@vielzeug/toolkit 1.0.14 → 1.1.3

package/dist/async/queue.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../function/assert.cjs");function g(o={}){const{concurrency:u=1}=o;a.assert(u>=1,"Concurrency must be at least 1",{args:{concurrency:u},type:RangeError});let n=0,r=null,l=null;const e=[],s=()=>{if(n<u&&e.length>0){const t=e.shift();n++,t.fn().then(t.resolve).catch(t.reject).finally(()=>{n--,s(),n===0&&e.length===0&&l&&(l(),r=null,l=null)})}};return{add:t=>new Promise((i,c)=>{e.push({fn:t,reject:c,resolve:i}),s()}),clear:()=>{e.length=0},onIdle:()=>n===0&&e.length===0?Promise.resolve():(r||(r=new Promise(t=>{l=t})),r),get pending(){return n},get size(){return e.length}}}exports.queue=g;
+//# sourceMappingURL=queue.cjs.map

package/dist/async/queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.cjs","sources":["../../src/async/queue.ts"],"sourcesContent":["import { assert } from '../function/assert';\n\n/**\n * Creates a promise queue that processes promises sequentially with optional concurrency limit.\n *\n * @example\n * ```ts\n * const requestQueue = queue({ concurrency: 2 });\n *\n * requestQueue.add(() => fetch('/api/1'));\n * requestQueue.add(() => fetch('/api/2'));\n * requestQueue.add(() => fetch('/api/3'));\n *\n * await requestQueue.onIdle(); // Wait for all tasks to complete\n * ```\n *\n * @param options - Queue configuration\n * @param options.concurrency - Maximum number of concurrent promises (default: 1)\n * @returns Queue instance with add, onIdle, and clear methods\n */\nexport function queue(options: { concurrency?: number } = {}) {\n  const { concurrency = 1 } = options;\n\n  assert(concurrency >= 1, 'Concurrency must be at least 1', {\n    args: { concurrency },\n    type: RangeError,\n  });\n\n  let activeCount = 0;\n  let idlePromise: Promise<void> | null = null;\n  let idleResolve: (() => void) | null = null;\n\n  const queue: Array<{\n    fn: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (error: unknown) => void;\n  }> = [];\n\n  const next = (): void => {\n    if (activeCount < concurrency && queue.length > 0) {\n      const task = queue.shift()!;\n      activeCount++;\n\n      task\n        .fn()\n        .then(task.resolve)\n        .catch(task.reject)\n        .finally(() => {\n          activeCount--;\n          next();\n\n          if (activeCount === 0 && queue.length === 0 && idleResolve) {\n            idleResolve();\n            idlePromise = null;\n            idleResolve = null;\n          }\n        });\n    }\n  };\n\n  return {\n    /**\n     * Adds a promise-returning function to the queue\n     */\n    add: <T>(fn: () => Promise<T>): Promise<T> => {\n      return new Promise<T>((resolve, reject) => {\n        queue.push({\n          fn: fn as () => Promise<unknown>,\n          reject,\n          resolve: resolve as (value: unknown) => void,\n        });\n        next();\n      });\n    },\n\n    /**\n     * Clears all pending tasks from the queue\n     */\n    clear: (): void => {\n      queue.length = 0;\n    },\n\n    /**\n     * Returns a promise that resolves when the queue becomes idle\n     */\n    onIdle: (): Promise<void> => {\n      if (activeCount === 0 && queue.length === 0) {\n        return Promise.resolve();\n      }\n\n      if (!idlePromise) {\n        idlePromise = new Promise<void>((resolve) => {\n          idleResolve = resolve;\n        });\n      }\n\n      return idlePromise;\n    },\n\n    /**\n     * Returns the number of currently active promises\n     */\n    get pending(): number {\n      return activeCount;\n    },\n\n    /**\n     * Returns the current size of the queue\n     */\n    get size(): number {\n      return queue.length;\n    },\n  };\n}\n"],"names":["queue","options","concurrency","assert","activeCount","idlePromise","idleResolve","next","task","fn","resolve","reject"],"mappings":"0HAoBO,SAASA,EAAMC,EAAoC,GAAI,CAC5D,KAAM,CAAE,YAAAC,EAAc,CAAA,EAAMD,EAE5BE,SAAOD,GAAe,EAAG,iCAAkC,CACzD,KAAM,CAAE,YAAAA,CAAA,EACR,KAAM,UAAA,CACP,EAED,IAAIE,EAAc,EACdC,EAAoC,KACpCC,EAAmC,KAEvC,MAAMN,EAID,CAAA,EAECO,EAAO,IAAY,CACvB,GAAIH,EAAcF,GAAeF,EAAM,OAAS,EAAG,CACjD,MAAMQ,EAAOR,EAAM,MAAA,EACnBI,IAEAI,EACG,GAAA,EACA,KAAKA,EAAK,OAAO,EACjB,MAAMA,EAAK,MAAM,EACjB,QAAQ,IAAM,CACbJ,IACAG,EAAA,EAEIH,IAAgB,GAAKJ,EAAM,SAAW,GAAKM,IAC7CA,EAAA,EACAD,EAAc,KACdC,EAAc,KAElB,CAAC,CACL,CACF,EAEA,MAAO,CAIL,IAASG,GACA,IAAI,QAAW,CAACC,EAASC,IAAW,CACzCX,EAAM,KAAK,CACT,GAAAS,EACA,OAAAE,EACA,QAAAD,CAAA,CACD,EACDH,EAAA,CACF,CAAC,EAMH,MAAO,IAAY,CACjBP,EAAM,OAAS,CACjB,EAKA,OAAQ,IACFI,IAAgB,GAAKJ,EAAM,SAAW,EACjC,QAAQ,QAAA,GAGZK,IACHA,EAAc,IAAI,QAAeK,GAAY,CAC3CJ,EAAcI,CAChB,CAAC,GAGIL,GAMT,IAAI,SAAkB,CACpB,OAAOD,CACT,EAKA,IAAI,MAAe,CACjB,OAAOJ,EAAM,MACf,CAAA,CAEJ"}

package/dist/async/queue.js

@@ -0,0 +1,57 @@
+import { assert as a } from "../function/assert.js";
+function f(u = {}) {
+  const { concurrency: o = 1 } = u;
+  a(o >= 1, "Concurrency must be at least 1", {
+    args: { concurrency: o },
+    type: RangeError
+  });
+  let t = 0, r = null, l = null;
+  const e = [], s = () => {
+    if (t < o && e.length > 0) {
+      const n = e.shift();
+      t++, n.fn().then(n.resolve).catch(n.reject).finally(() => {
+        t--, s(), t === 0 && e.length === 0 && l && (l(), r = null, l = null);
+      });
+    }
+  };
+  return {
+    /**
+     * Adds a promise-returning function to the queue
+     */
+    add: (n) => new Promise((i, c) => {
+      e.push({
+        fn: n,
+        reject: c,
+        resolve: i
+      }), s();
+    }),
+    /**
+     * Clears all pending tasks from the queue
+     */
+    clear: () => {
+      e.length = 0;
+    },
+    /**
+     * Returns a promise that resolves when the queue becomes idle
+     */
+    onIdle: () => t === 0 && e.length === 0 ? Promise.resolve() : (r || (r = new Promise((n) => {
+      l = n;
+    })), r),
+    /**
+     * Returns the number of currently active promises
+     */
+    get pending() {
+      return t;
+    },
+    /**
+     * Returns the current size of the queue
+     */
+    get size() {
+      return e.length;
+    }
+  };
+}
+export {
+  f as queue
+};
+//# sourceMappingURL=queue.js.map

package/dist/async/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sources":["../../src/async/queue.ts"],"sourcesContent":["import { assert } from '../function/assert';\n\n/**\n * Creates a promise queue that processes promises sequentially with optional concurrency limit.\n *\n * @example\n * ```ts\n * const requestQueue = queue({ concurrency: 2 });\n *\n * requestQueue.add(() => fetch('/api/1'));\n * requestQueue.add(() => fetch('/api/2'));\n * requestQueue.add(() => fetch('/api/3'));\n *\n * await requestQueue.onIdle(); // Wait for all tasks to complete\n * ```\n *\n * @param options - Queue configuration\n * @param options.concurrency - Maximum number of concurrent promises (default: 1)\n * @returns Queue instance with add, onIdle, and clear methods\n */\nexport function queue(options: { concurrency?: number } = {}) {\n  const { concurrency = 1 } = options;\n\n  assert(concurrency >= 1, 'Concurrency must be at least 1', {\n    args: { concurrency },\n    type: RangeError,\n  });\n\n  let activeCount = 0;\n  let idlePromise: Promise<void> | null = null;\n  let idleResolve: (() => void) | null = null;\n\n  const queue: Array<{\n    fn: () => Promise<unknown>;\n    resolve: (value: unknown) => void;\n    reject: (error: unknown) => void;\n  }> = [];\n\n  const next = (): void => {\n    if (activeCount < concurrency && queue.length > 0) {\n      const task = queue.shift()!;\n      activeCount++;\n\n      task\n        .fn()\n        .then(task.resolve)\n        .catch(task.reject)\n        .finally(() => {\n          activeCount--;\n          next();\n\n          if (activeCount === 0 && queue.length === 0 && idleResolve) {\n            idleResolve();\n            idlePromise = null;\n            idleResolve = null;\n          }\n        });\n    }\n  };\n\n  return {\n    /**\n     * Adds a promise-returning function to the queue\n     */\n    add: <T>(fn: () => Promise<T>): Promise<T> => {\n      return new Promise<T>((resolve, reject) => {\n        queue.push({\n          fn: fn as () => Promise<unknown>,\n          reject,\n          resolve: resolve as (value: unknown) => void,\n        });\n        next();\n      });\n    },\n\n    /**\n     * Clears all pending tasks from the queue\n     */\n    clear: (): void => {\n      queue.length = 0;\n    },\n\n    /**\n     * Returns a promise that resolves when the queue becomes idle\n     */\n    onIdle: (): Promise<void> => {\n      if (activeCount === 0 && queue.length === 0) {\n        return Promise.resolve();\n      }\n\n      if (!idlePromise) {\n        idlePromise = new Promise<void>((resolve) => {\n          idleResolve = resolve;\n        });\n      }\n\n      return idlePromise;\n    },\n\n    /**\n     * Returns the number of currently active promises\n     */\n    get pending(): number {\n      return activeCount;\n    },\n\n    /**\n     * Returns the current size of the queue\n     */\n    get size(): number {\n      return queue.length;\n    },\n  };\n}\n"],"names":["queue","options","concurrency","assert","activeCount","idlePromise","idleResolve","next","task","fn","resolve","reject"],"mappings":";AAoBO,SAASA,EAAMC,IAAoC,IAAI;AAC5D,QAAM,EAAE,aAAAC,IAAc,EAAA,IAAMD;AAE5B,EAAAE,EAAOD,KAAe,GAAG,kCAAkC;AAAA,IACzD,MAAM,EAAE,aAAAA,EAAA;AAAA,IACR,MAAM;AAAA,EAAA,CACP;AAED,MAAIE,IAAc,GACdC,IAAoC,MACpCC,IAAmC;AAEvC,QAAMN,IAID,CAAA,GAECO,IAAO,MAAY;AACvB,QAAIH,IAAcF,KAAeF,EAAM,SAAS,GAAG;AACjD,YAAMQ,IAAOR,EAAM,MAAA;AACnB,MAAAI,KAEAI,EACG,GAAA,EACA,KAAKA,EAAK,OAAO,EACjB,MAAMA,EAAK,MAAM,EACjB,QAAQ,MAAM;AACb,QAAAJ,KACAG,EAAA,GAEIH,MAAgB,KAAKJ,EAAM,WAAW,KAAKM,MAC7CA,EAAA,GACAD,IAAc,MACdC,IAAc;AAAA,MAElB,CAAC;AAAA,IACL;AAAA,EACF;AAEA,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL,KAAK,CAAIG,MACA,IAAI,QAAW,CAACC,GAASC,MAAW;AACzCX,MAAAA,EAAM,KAAK;AAAA,QACT,IAAAS;AAAA,QACA,QAAAE;AAAA,QACA,SAAAD;AAAA,MAAA,CACD,GACDH,EAAA;AAAA,IACF,CAAC;AAAA;AAAA;AAAA;AAAA,IAMH,OAAO,MAAY;AACjBP,MAAAA,EAAM,SAAS;AAAA,IACjB;AAAA;AAAA;AAAA;AAAA,IAKA,QAAQ,MACFI,MAAgB,KAAKJ,EAAM,WAAW,IACjC,QAAQ,QAAA,KAGZK,MACHA,IAAc,IAAI,QAAc,CAACK,MAAY;AAC3C,MAAAJ,IAAcI;AAAA,IAChB,CAAC,IAGIL;AAAA;AAAA;AAAA;AAAA,IAMT,IAAI,UAAkB;AACpB,aAAOD;AAAA,IACT;AAAA;AAAA;AAAA;AAAA,IAKA,IAAI,OAAe;AACjB,aAAOJ,EAAM;AAAA,IACf;AAAA,EAAA;AAEJ;"}

package/dist/async/race.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function o(e,r){const t=Array.isArray(e)?e:[e],a=new Promise(n=>setTimeout(n,r)),i=await Promise.race(t);return await a,i}exports.race=o;
+//# sourceMappingURL=race.cjs.map

package/dist/async/race.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.cjs","sources":["../../src/async/race.ts"],"sourcesContent":["/**\n * Race multiple promises but with a guaranteed minimum delay.\n * Useful for showing loading states for at least a minimum duration.\n *\n * @example\n * ```ts\n * // Show loading spinner for at least 500ms\n * const result = await race(\n *   fetchData(),\n *   500\n * );\n *\n * // With multiple promises\n * const result = await race(\n *   [fetch('/api/1'), fetch('/api/2')],\n *   1000\n * );\n * ```\n *\n * @param promises - Single promise or array of promises to race\n * @param minDelay - Minimum delay in milliseconds before resolving\n * @returns Promise that resolves with the first result after the minimum delay\n */\nexport async function race<T>(promises: Promise<T> | Promise<T>[], minDelay: number): Promise<T> {\n  const promiseArray = Array.isArray(promises) ? promises : [promises];\n  const minDelayPromise = new Promise<void>((resolve) => setTimeout(resolve, minDelay));\n\n  const result = await Promise.race(promiseArray);\n  await minDelayPromise;\n\n  return result;\n}\n"],"names":["race","promises","minDelay","promiseArray","minDelayPromise","resolve","result"],"mappings":"gFAuBA,eAAsBA,EAAQC,EAAqCC,EAA8B,CAC/F,MAAMC,EAAe,MAAM,QAAQF,CAAQ,EAAIA,EAAW,CAACA,CAAQ,EAC7DG,EAAkB,IAAI,QAAeC,GAAY,WAAWA,EAASH,CAAQ,CAAC,EAE9EI,EAAS,MAAM,QAAQ,KAAKH,CAAY,EAC9C,aAAMC,EAECE,CACT"}

package/dist/async/race.js

@@ -0,0 +1,8 @@
+async function o(r, a) {
+  const e = Array.isArray(r) ? r : [r], t = new Promise((i) => setTimeout(i, a)), n = await Promise.race(e);
+  return await t, n;
+}
+export {
+  o as race
+};
+//# sourceMappingURL=race.js.map

package/dist/async/race.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.js","sources":["../../src/async/race.ts"],"sourcesContent":["/**\n * Race multiple promises but with a guaranteed minimum delay.\n * Useful for showing loading states for at least a minimum duration.\n *\n * @example\n * ```ts\n * // Show loading spinner for at least 500ms\n * const result = await race(\n *   fetchData(),\n *   500\n * );\n *\n * // With multiple promises\n * const result = await race(\n *   [fetch('/api/1'), fetch('/api/2')],\n *   1000\n * );\n * ```\n *\n * @param promises - Single promise or array of promises to race\n * @param minDelay - Minimum delay in milliseconds before resolving\n * @returns Promise that resolves with the first result after the minimum delay\n */\nexport async function race<T>(promises: Promise<T> | Promise<T>[], minDelay: number): Promise<T> {\n  const promiseArray = Array.isArray(promises) ? promises : [promises];\n  const minDelayPromise = new Promise<void>((resolve) => setTimeout(resolve, minDelay));\n\n  const result = await Promise.race(promiseArray);\n  await minDelayPromise;\n\n  return result;\n}\n"],"names":["race","promises","minDelay","promiseArray","minDelayPromise","resolve","result"],"mappings":"AAuBA,eAAsBA,EAAQC,GAAqCC,GAA8B;AAC/F,QAAMC,IAAe,MAAM,QAAQF,CAAQ,IAAIA,IAAW,CAACA,CAAQ,GAC7DG,IAAkB,IAAI,QAAc,CAACC,MAAY,WAAWA,GAASH,CAAQ,CAAC,GAE9EI,IAAS,MAAM,QAAQ,KAAKH,CAAY;AAC9C,eAAMC,GAECE;AACT;"}

package/dist/async/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","sources":["../../src/async/retry.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport { sleep } from './sleep';\n\n/**\n * Retries an asynchronous function a specified number of times with delay and optional exponential backoff.\n *\n * @example\n * ```ts\n * retry(() => fetchData(), { times: 3, delay: 1000, backoff: 2, signal: abortSignal })\n *   .then(result => console.log(result))\n *   .catch(error => console.error(error));\n * ```\n *\n * @param fn - The asynchronous function to retry.\n * @param options - (optional) Options for retrying the function.\n * @param [options.times=3] - The number of retry attempts.\n * @param [options.delay=250] - The delay in milliseconds between retries.\n * @param [options.backoff=1] - Exponential backoff factor (default: 1 → no backoff).\n * @param [options.signal] - `AbortSignal` to allow canceling retries.\n *\n * @returns The result of the asynchronous function.\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  {\n    times = 3,\n    delay = 250,\n    backoff = 1,\n    signal,\n  }: {\n    times?: number;\n    delay?: number;\n    backoff?: number | ((attempt: number, delay: number) => number);\n    signal?: AbortSignal;\n  } = {},\n): Promise<T> {\n  let currentDelay = delay;\n\n  for (let attempt = 1; attempt <= times; attempt++) {\n    if (signal?.aborted) {\n      Logit.warn(`retry() -> Aborted after ${attempt - 1} attempts`);\n      throw new Error('Retry aborted');\n    }\n\n    try {\n      return await fn();\n    } catch (err) {\n      if (attempt === times) throw err;\n\n      Logit.warn(`retry() -> ${err}, attempt ${attempt}/${times}, retrying in ${currentDelay}ms`);\n      if (currentDelay > 0) await sleep(currentDelay);\n\n      currentDelay = typeof backoff === 'function' ? backoff(attempt, currentDelay) : currentDelay * backoff;\n    }\n  }\n\n  throw new Error('Retry failed unexpectedly');\n}\n"],"names":["retry","fn","times","delay","backoff","signal","currentDelay","attempt","Logit","err","sleep"],"mappings":"oJAsBA,eAAsBA,EACpBC,EACA,CACE,MAAAC,EAAQ,EACR,MAAAC,EAAQ,IACR,QAAAC,EAAU,EACV,OAAAC,CACF,EAKI,GACQ,CACZ,IAAIC,EAAeH,EAEnB,QAASI,EAAU,EAAGA,GAAWL,EAAOK,IAAW,CACjD,GAAIF,GAAQ,QACVG,MAAAA,EAAAA,MAAM,KAAK,4BAA4BD,EAAU,CAAC,WAAW,EACvD,IAAI,MAAM,eAAe,EAGjC,GAAI,CACF,OAAO,MAAMN,EAAA,CACf,OAASQ,EAAK,CACZ,GAAIF,IAAYL,EAAO,MAAMO,EAE7BD,EAAAA,MAAM,KAAK,cAAcC,CAAG,aAAaF,CAAO,IAAIL,CAAK,iBAAiBI,CAAY,IAAI,EACtFA,EAAe,GAAG,MAAMI,EAAAA,MAAMJ,CAAY,EAE9CA,EAAe,OAAOF,GAAY,WAAaA,EAAQG,EAASD,CAAY,EAAIA,EAAeF,CACjG,CACF,CAEA,MAAM,IAAI,MAAM,2BAA2B,CAC7C"}

package/dist/{function → async}/retry.js

@@ -1,17 +1,17 @@
 import { Logit as n } from "../logit/dist/logit.js";
 import { sleep as w } from "./sleep.js";
-async function m(y, {
+async function m(i, {
   times: e = 3,
-  delay: i = 250,
+  delay: y = 250,
   backoff: o = 1,
   signal: p
 } = {}) {
-  let r = i;
+  let r = y;
   for (let t = 1; t <= e; t++) {
     if (p?.aborted)
       throw n.warn(`retry() -> Aborted after ${t - 1} attempts`), new Error("Retry aborted");
     try {
-      return await y();
+      return await i();
     } catch (a) {
       if (t === e) throw a;
       n.warn(`retry() -> ${a}, attempt ${t}/${e}, retrying in ${r}ms`), r > 0 && await w(r), r = typeof o == "function" ? o(t, r) : r * o;

package/dist/async/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sources":["../../src/async/retry.ts"],"sourcesContent":["import { Logit } from '@vielzeug/logit';\nimport { sleep } from './sleep';\n\n/**\n * Retries an asynchronous function a specified number of times with delay and optional exponential backoff.\n *\n * @example\n * ```ts\n * retry(() => fetchData(), { times: 3, delay: 1000, backoff: 2, signal: abortSignal })\n *   .then(result => console.log(result))\n *   .catch(error => console.error(error));\n * ```\n *\n * @param fn - The asynchronous function to retry.\n * @param options - (optional) Options for retrying the function.\n * @param [options.times=3] - The number of retry attempts.\n * @param [options.delay=250] - The delay in milliseconds between retries.\n * @param [options.backoff=1] - Exponential backoff factor (default: 1 → no backoff).\n * @param [options.signal] - `AbortSignal` to allow canceling retries.\n *\n * @returns The result of the asynchronous function.\n */\nexport async function retry<T>(\n  fn: () => Promise<T>,\n  {\n    times = 3,\n    delay = 250,\n    backoff = 1,\n    signal,\n  }: {\n    times?: number;\n    delay?: number;\n    backoff?: number | ((attempt: number, delay: number) => number);\n    signal?: AbortSignal;\n  } = {},\n): Promise<T> {\n  let currentDelay = delay;\n\n  for (let attempt = 1; attempt <= times; attempt++) {\n    if (signal?.aborted) {\n      Logit.warn(`retry() -> Aborted after ${attempt - 1} attempts`);\n      throw new Error('Retry aborted');\n    }\n\n    try {\n      return await fn();\n    } catch (err) {\n      if (attempt === times) throw err;\n\n      Logit.warn(`retry() -> ${err}, attempt ${attempt}/${times}, retrying in ${currentDelay}ms`);\n      if (currentDelay > 0) await sleep(currentDelay);\n\n      currentDelay = typeof backoff === 'function' ? backoff(attempt, currentDelay) : currentDelay * backoff;\n    }\n  }\n\n  throw new Error('Retry failed unexpectedly');\n}\n"],"names":["retry","fn","times","delay","backoff","signal","currentDelay","attempt","Logit","err","sleep"],"mappings":";;AAsBA,eAAsBA,EACpBC,GACA;AAAA,EACE,OAAAC,IAAQ;AAAA,EACR,OAAAC,IAAQ;AAAA,EACR,SAAAC,IAAU;AAAA,EACV,QAAAC;AACF,IAKI,IACQ;AACZ,MAAIC,IAAeH;AAEnB,WAASI,IAAU,GAAGA,KAAWL,GAAOK,KAAW;AACjD,QAAIF,GAAQ;AACVG,YAAAA,EAAM,KAAK,4BAA4BD,IAAU,CAAC,WAAW,GACvD,IAAI,MAAM,eAAe;AAGjC,QAAI;AACF,aAAO,MAAMN,EAAA;AAAA,IACf,SAASQ,GAAK;AACZ,UAAIF,MAAYL,EAAO,OAAMO;AAE7BD,MAAAA,EAAM,KAAK,cAAcC,CAAG,aAAaF,CAAO,IAAIL,CAAK,iBAAiBI,CAAY,IAAI,GACtFA,IAAe,KAAG,MAAMI,EAAMJ,CAAY,GAE9CA,IAAe,OAAOF,KAAY,aAAaA,EAAQG,GAASD,CAAY,IAAIA,IAAeF;AAAA,IACjG;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,2BAA2B;AAC7C;"}

package/dist/async/sleep.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../function/assert.cjs");async function s(e){return n.assert(typeof e=="number"&&e>=0&&Number.isFinite(e),"Timeout must be a non-negative finite number",{args:{timeout:e},type:TypeError}),new Promise(r=>setTimeout(r,e))}exports.sleep=s;
+//# sourceMappingURL=sleep.cjs.map

package/dist/async/sleep.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.cjs","sources":["../../src/async/sleep.ts"],"sourcesContent":["import { assert } from '../function/assert';\n\n/**\n * Creates a Promise that resolves after a specified amount of time.\n *\n * @example\n * ```ts\n * sleep(1000).then(() => console.log('Hello, world!')); // logs 'Hello, world!' after 1 second\n * ```\n *\n * @param timeout - The number of milliseconds to wait before resolving the Promise.\n *\n * @returns A Promise that resolves after the specified time.\n *\n * @throws {TypeError} If timeout is not a non-negative number.\n */\nexport async function sleep(timeout: number): Promise<void> {\n  assert(\n    typeof timeout === 'number' && timeout >= 0 && Number.isFinite(timeout),\n    'Timeout must be a non-negative finite number',\n    { args: { timeout }, type: TypeError },\n  );\n  return new Promise((resolve) => setTimeout(resolve, timeout));\n}\n"],"names":["sleep","timeout","assert","resolve"],"mappings":"0HAgBA,eAAsBA,EAAMC,EAAgC,CAC1DC,OAAAA,EAAAA,OACE,OAAOD,GAAY,UAAYA,GAAW,GAAK,OAAO,SAASA,CAAO,EACtE,+CACA,CAAE,KAAM,CAAE,QAAAA,CAAA,EAAW,KAAM,SAAA,CAAU,EAEhC,IAAI,QAASE,GAAY,WAAWA,EAASF,CAAO,CAAC,CAC9D"}

package/dist/{function → async}/sleep.js

@@ -1,4 +1,4 @@
-import { assert as n } from "./assert.js";
+import { assert as n } from "../function/assert.js";
 async function i(e) {
   return n(
     typeof e == "number" && e >= 0 && Number.isFinite(e),

package/dist/async/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sources":["../../src/async/sleep.ts"],"sourcesContent":["import { assert } from '../function/assert';\n\n/**\n * Creates a Promise that resolves after a specified amount of time.\n *\n * @example\n * ```ts\n * sleep(1000).then(() => console.log('Hello, world!')); // logs 'Hello, world!' after 1 second\n * ```\n *\n * @param timeout - The number of milliseconds to wait before resolving the Promise.\n *\n * @returns A Promise that resolves after the specified time.\n *\n * @throws {TypeError} If timeout is not a non-negative number.\n */\nexport async function sleep(timeout: number): Promise<void> {\n  assert(\n    typeof timeout === 'number' && timeout >= 0 && Number.isFinite(timeout),\n    'Timeout must be a non-negative finite number',\n    { args: { timeout }, type: TypeError },\n  );\n  return new Promise((resolve) => setTimeout(resolve, timeout));\n}\n"],"names":["sleep","timeout","assert","resolve"],"mappings":";AAgBA,eAAsBA,EAAMC,GAAgC;AAC1D,SAAAC;AAAA,IACE,OAAOD,KAAY,YAAYA,KAAW,KAAK,OAAO,SAASA,CAAO;AAAA,IACtE;AAAA,IACA,EAAE,MAAM,EAAE,SAAAA,EAAA,GAAW,MAAM,UAAA;AAAA,EAAU,GAEhC,IAAI,QAAQ,CAACE,MAAY,WAAWA,GAASF,CAAO,CAAC;AAC9D;"}

package/dist/async/waitFor.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});async function d(u,c={}){const{timeout:n=5e3,interval:l=100,signal:t}=c;if(t?.aborted)throw new DOMException("Aborted","AbortError");return new Promise((b,e)=>{const w=Date.now();let o=null;const r=()=>{o!==null&&(clearTimeout(o),o=null),t?.removeEventListener("abort",i)},i=()=>{r(),e(new DOMException("Aborted","AbortError"))},a=async()=>{try{if(t?.aborted){r(),e(new DOMException("Aborted","AbortError"));return}if(await u()){r(),b();return}if(Date.now()-w>=n){r(),e(new Error(`waitFor timed out after ${n}ms`));return}o=setTimeout(a,l)}catch(s){r(),e(s)}};t&&t.addEventListener("abort",i,{once:!0}),a()})}exports.waitFor=d;
+//# sourceMappingURL=waitFor.cjs.map

package/dist/async/waitFor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.cjs","sources":["../../src/async/waitFor.ts"],"sourcesContent":["/**\n * Waits for a condition to become true by polling.\n * Useful for waiting for DOM elements, API states, or other conditions.\n *\n * @example\n * ```ts\n * // Wait for an element to appear\n * await waitFor(() => document.querySelector('#myElement') !== null);\n *\n * // Wait for API to be ready\n * await waitFor(\n *   async () => {\n *     const res = await fetch('/api/health');\n *     return res.ok;\n *   },\n *   { timeout: 30000, interval: 1000 }\n * );\n * ```\n *\n * @param condition - Function that returns true when condition is met\n * @param options - Configuration options\n * @param options.timeout - Maximum time to wait in ms (default: 5000)\n * @param options.interval - Polling interval in ms (default: 100)\n * @param options.signal - AbortSignal to cancel waiting\n * @returns Promise that resolves when condition becomes true\n * @throws {Error} If timeout is reached\n * @throws {DOMException} If aborted via signal\n */\nexport async function waitFor(\n  condition: () => boolean | Promise<boolean>,\n  options: {\n    timeout?: number;\n    interval?: number;\n    signal?: AbortSignal;\n  } = {},\n): Promise<void> {\n  const { timeout: timeoutMs = 5000, interval = 100, signal } = options;\n\n  if (signal?.aborted) {\n    throw new DOMException('Aborted', 'AbortError');\n  }\n\n  return new Promise<void>((resolve, reject) => {\n    const startTime = Date.now();\n    let timeoutId: ReturnType<typeof setTimeout> | null = null;\n    let intervalId: ReturnType<typeof setTimeout> | null = null;\n\n    const cleanup = () => {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n      if (intervalId !== null) {\n        clearTimeout(intervalId);\n        intervalId = null;\n      }\n      signal?.removeEventListener('abort', onAbort);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const check = async () => {\n      try {\n        // Check if aborted\n        if (signal?.aborted) {\n          cleanup();\n          reject(new DOMException('Aborted', 'AbortError'));\n          return;\n        }\n\n        // Check condition\n        const result = await condition();\n\n        if (result) {\n          cleanup();\n          resolve();\n          return;\n        }\n\n        // Check timeout\n        if (Date.now() - startTime >= timeoutMs) {\n          cleanup();\n          reject(new Error(`waitFor timed out after ${timeoutMs}ms`));\n          return;\n        }\n\n        // Schedule next check\n        intervalId = setTimeout(check, interval);\n      } catch (error) {\n        // If the condition throws, clean up and reject\n        cleanup();\n        reject(error);\n      }\n    };\n\n    // Set up abort listener\n    if (signal) {\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    // Start checking\n    check();\n  });\n}\n"],"names":["waitFor","condition","options","timeoutMs","interval","signal","resolve","reject","startTime","intervalId","cleanup","onAbort","check","error"],"mappings":"gFA4BA,eAAsBA,EACpBC,EACAC,EAII,GACW,CACf,KAAM,CAAE,QAASC,EAAY,IAAM,SAAAC,EAAW,IAAK,OAAAC,GAAWH,EAE9D,GAAIG,GAAQ,QACV,MAAM,IAAI,aAAa,UAAW,YAAY,EAGhD,OAAO,IAAI,QAAc,CAACC,EAASC,IAAW,CAC5C,MAAMC,EAAY,KAAK,IAAA,EAEvB,IAAIC,EAAmD,KAEvD,MAAMC,EAAU,IAAM,CAKhBD,IAAe,OACjB,aAAaA,CAAU,EACvBA,EAAa,MAEfJ,GAAQ,oBAAoB,QAASM,CAAO,CAC9C,EAEMA,EAAU,IAAM,CACpBD,EAAA,EACAH,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,CAClD,EAEMK,EAAQ,SAAY,CACxB,GAAI,CAEF,GAAIP,GAAQ,QAAS,CACnBK,EAAA,EACAH,EAAO,IAAI,aAAa,UAAW,YAAY,CAAC,EAChD,MACF,CAKA,GAFe,MAAMN,EAAA,EAET,CACVS,EAAA,EACAJ,EAAA,EACA,MACF,CAGA,GAAI,KAAK,MAAQE,GAAaL,EAAW,CACvCO,EAAA,EACAH,EAAO,IAAI,MAAM,2BAA2BJ,CAAS,IAAI,CAAC,EAC1D,MACF,CAGAM,EAAa,WAAWG,EAAOR,CAAQ,CACzC,OAASS,EAAO,CAEdH,EAAA,EACAH,EAAOM,CAAK,CACd,CACF,EAGIR,GACFA,EAAO,iBAAiB,QAASM,EAAS,CAAE,KAAM,GAAM,EAI1DC,EAAA,CACF,CAAC,CACH"}

package/dist/async/waitFor.js

@@ -0,0 +1,37 @@
+async function d(u, c = {}) {
+  const { timeout: n = 5e3, interval: l = 100, signal: t } = c;
+  if (t?.aborted)
+    throw new DOMException("Aborted", "AbortError");
+  return new Promise((b, e) => {
+    const w = Date.now();
+    let o = null;
+    const r = () => {
+      o !== null && (clearTimeout(o), o = null), t?.removeEventListener("abort", i);
+    }, i = () => {
+      r(), e(new DOMException("Aborted", "AbortError"));
+    }, a = async () => {
+      try {
+        if (t?.aborted) {
+          r(), e(new DOMException("Aborted", "AbortError"));
+          return;
+        }
+        if (await u()) {
+          r(), b();
+          return;
+        }
+        if (Date.now() - w >= n) {
+          r(), e(new Error(`waitFor timed out after ${n}ms`));
+          return;
+        }
+        o = setTimeout(a, l);
+      } catch (s) {
+        r(), e(s);
+      }
+    };
+    t && t.addEventListener("abort", i, { once: !0 }), a();
+  });
+}
+export {
+  d as waitFor
+};
+//# sourceMappingURL=waitFor.js.map

package/dist/async/waitFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.js","sources":["../../src/async/waitFor.ts"],"sourcesContent":["/**\n * Waits for a condition to become true by polling.\n * Useful for waiting for DOM elements, API states, or other conditions.\n *\n * @example\n * ```ts\n * // Wait for an element to appear\n * await waitFor(() => document.querySelector('#myElement') !== null);\n *\n * // Wait for API to be ready\n * await waitFor(\n *   async () => {\n *     const res = await fetch('/api/health');\n *     return res.ok;\n *   },\n *   { timeout: 30000, interval: 1000 }\n * );\n * ```\n *\n * @param condition - Function that returns true when condition is met\n * @param options - Configuration options\n * @param options.timeout - Maximum time to wait in ms (default: 5000)\n * @param options.interval - Polling interval in ms (default: 100)\n * @param options.signal - AbortSignal to cancel waiting\n * @returns Promise that resolves when condition becomes true\n * @throws {Error} If timeout is reached\n * @throws {DOMException} If aborted via signal\n */\nexport async function waitFor(\n  condition: () => boolean | Promise<boolean>,\n  options: {\n    timeout?: number;\n    interval?: number;\n    signal?: AbortSignal;\n  } = {},\n): Promise<void> {\n  const { timeout: timeoutMs = 5000, interval = 100, signal } = options;\n\n  if (signal?.aborted) {\n    throw new DOMException('Aborted', 'AbortError');\n  }\n\n  return new Promise<void>((resolve, reject) => {\n    const startTime = Date.now();\n    let timeoutId: ReturnType<typeof setTimeout> | null = null;\n    let intervalId: ReturnType<typeof setTimeout> | null = null;\n\n    const cleanup = () => {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n      if (intervalId !== null) {\n        clearTimeout(intervalId);\n        intervalId = null;\n      }\n      signal?.removeEventListener('abort', onAbort);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(new DOMException('Aborted', 'AbortError'));\n    };\n\n    const check = async () => {\n      try {\n        // Check if aborted\n        if (signal?.aborted) {\n          cleanup();\n          reject(new DOMException('Aborted', 'AbortError'));\n          return;\n        }\n\n        // Check condition\n        const result = await condition();\n\n        if (result) {\n          cleanup();\n          resolve();\n          return;\n        }\n\n        // Check timeout\n        if (Date.now() - startTime >= timeoutMs) {\n          cleanup();\n          reject(new Error(`waitFor timed out after ${timeoutMs}ms`));\n          return;\n        }\n\n        // Schedule next check\n        intervalId = setTimeout(check, interval);\n      } catch (error) {\n        // If the condition throws, clean up and reject\n        cleanup();\n        reject(error);\n      }\n    };\n\n    // Set up abort listener\n    if (signal) {\n      signal.addEventListener('abort', onAbort, { once: true });\n    }\n\n    // Start checking\n    check();\n  });\n}\n"],"names":["waitFor","condition","options","timeoutMs","interval","signal","resolve","reject","startTime","intervalId","cleanup","onAbort","check","error"],"mappings":"AA4BA,eAAsBA,EACpBC,GACAC,IAII,IACW;AACf,QAAM,EAAE,SAASC,IAAY,KAAM,UAAAC,IAAW,KAAK,QAAAC,MAAWH;AAE9D,MAAIG,GAAQ;AACV,UAAM,IAAI,aAAa,WAAW,YAAY;AAGhD,SAAO,IAAI,QAAc,CAACC,GAASC,MAAW;AAC5C,UAAMC,IAAY,KAAK,IAAA;AAEvB,QAAIC,IAAmD;AAEvD,UAAMC,IAAU,MAAM;AAKpB,MAAID,MAAe,SACjB,aAAaA,CAAU,GACvBA,IAAa,OAEfJ,GAAQ,oBAAoB,SAASM,CAAO;AAAA,IAC9C,GAEMA,IAAU,MAAM;AACpB,MAAAD,EAAA,GACAH,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAAA,IAClD,GAEMK,IAAQ,YAAY;AACxB,UAAI;AAEF,YAAIP,GAAQ,SAAS;AACnB,UAAAK,EAAA,GACAH,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;AAChD;AAAA,QACF;AAKA,YAFe,MAAMN,EAAA,GAET;AACV,UAAAS,EAAA,GACAJ,EAAA;AACA;AAAA,QACF;AAGA,YAAI,KAAK,QAAQE,KAAaL,GAAW;AACvC,UAAAO,EAAA,GACAH,EAAO,IAAI,MAAM,2BAA2BJ,CAAS,IAAI,CAAC;AAC1D;AAAA,QACF;AAGA,QAAAM,IAAa,WAAWG,GAAOR,CAAQ;AAAA,MACzC,SAASS,GAAO;AAEd,QAAAH,EAAA,GACAH,EAAOM,CAAK;AAAA,MACd;AAAA,IACF;AAGA,IAAIR,KACFA,EAAO,iBAAiB,SAASM,GAAS,EAAE,MAAM,IAAM,GAI1DC,EAAA;AAAA,EACF,CAAC;AACH;"}

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("./array/aggregate.cjs"),m=require("./array/alternate.cjs"),p=require("./array/chunk.cjs"),_=require("./array/compact.cjs"),d=require("./array/contains.cjs"),S=require("./array/every.cjs"),E=require("./array/filter.cjs"),f=require("./array/find.cjs"),I=require("./array/findIndex.cjs"),g=require("./array/findLast.cjs"),O=require("./array/flatten.cjs"),y=require("./array/group.cjs"),M=require("./array/list.cjs"),b=require("./array/map.cjs"),v=require("./array/pick.cjs"),G=require("./array/reduce.cjs"),h=require("./array/remoteList.cjs"),N=require("./array/search.cjs"),k=require("./array/select.cjs"),P=require("./array/shift.cjs"),x=require("./array/some.cjs"),C=require("./array/sort.cjs"),T=require("./array/arrange.cjs"),A=require("./array/substitute.cjs"),D=require("./array/uniq.cjs"),B=require("./date/expires.cjs"),L=require("./date/interval.cjs"),w=require("./date/timeDiff.cjs"),U=require("./function/assert.cjs"),F=require("./function/assertParams.cjs"),J=require("./function/attempt.cjs"),W=require("./function/compare.cjs"),j=require("./function/compareBy.cjs"),Y=require("./function/compose.cjs"),Z=require("./function/curry.cjs"),H=require("./function/debounce.cjs"),Q=require("./function/delay.cjs"),V=require("./function/fp.cjs"),z=require("./function/memo.cjs"),K=require("./function/once.cjs"),X=require("./function/parallel.cjs"),$=require("./function/pipe.cjs"),ee=require("./function/predict.cjs"),re=require("./function/proxy.cjs"),ie=require("./function/prune.cjs"),se=require("./function/retry.cjs"),te=require("./function/sleep.cjs"),ne=require("./function/throttle.cjs"),oe=require("./function/worker.cjs"),ce=require("./math/abs.cjs"),ue=require("./math/add.cjs"),ae=require("./math/allocate.cjs"),qe=require("./math/average.cjs"),le=require("./math/boil.cjs"),Re=require("./math/clamp.cjs"),me=require("./math/distribute.cjs"),pe=require("./math/divide.cjs"),_e=require("./math/max.cjs"),de=require("./math/median.cjs"),Se=require("./math/min.cjs"),Ee=require("./math/multiply.cjs"),fe=require("./math/range.cjs"),Ie=require("./math/rate.cjs"),ge=require("./math/round.cjs"),Oe=require("./math/subtract.cjs"),ye=require("./math/sum.cjs"),Me=require("./money/currency.cjs"),be=require("./money/exchange.cjs"),ve=require("./object/clone.cjs"),Ge=require("./object/diff.cjs"),he=require("./object/entries.cjs"),Ne=require("./object/keys.cjs"),ke=require("./object/merge.cjs"),Pe=require("./object/parseJSON.cjs"),xe=require("./object/path.cjs"),Ce=require("./object/seek.cjs"),Te=require("./object/values.cjs"),Ae=require("./random/draw.cjs"),De=require("./random/random.cjs"),Be=require("./random/shuffle.cjs"),Le=require("./random/uuid.cjs"),we=require("./string/camelCase.cjs"),Ue=require("./string/kebabCase.cjs"),Fe=require("./string/pascalCase.cjs"),Je=require("./string/similarity.cjs"),We=require("./string/snakeCase.cjs"),je=require("./string/truncate.cjs"),Ye=require("./typed/ge.cjs"),Ze=require("./typed/gt.cjs"),He=require("./typed/is.cjs"),e=require("./typed/isArray.cjs"),Qe=require("./typed/isBoolean.cjs"),r=require("./typed/isDate.cjs"),Ve=require("./typed/isDefined.cjs"),i=require("./typed/isEmpty.cjs"),s=require("./typed/isEqual.cjs"),ze=require("./typed/isEven.cjs"),t=require("./typed/isFunction.cjs"),Ke=require("./typed/isNegative.cjs"),n=require("./typed/isNil.cjs"),o=require("./typed/isNumber.cjs"),c=require("./typed/isObject.cjs"),Xe=require("./typed/isOdd.cjs"),$e=require("./typed/isPositive.cjs"),u=require("./typed/isPrimitive.cjs"),a=require("./typed/isPromise.cjs"),er=require("./typed/isRegex.cjs"),q=require("./typed/isString.cjs"),l=require("./typed/isWithin.cjs"),rr=require("./typed/isZero.cjs"),ir=require("./typed/le.cjs"),sr=require("./typed/lt.cjs"),tr=require("./typed/typeOf.cjs");exports.aggregate=R.aggregate;exports.alternate=m.alternate;exports.chunk=p.chunk;exports.compact=_.compact;exports.contains=d.contains;exports.every=S.every;exports.filter=E.filter;exports.find=f.find;exports.findIndex=I.findIndex;exports.findLast=g.findLast;exports.flatten=O.flatten;exports.group=y.group;exports.list=M.list;exports.map=b.map;exports.pick=v.pick;exports.reduce=G.reduce;exports.remoteList=h.remoteList;exports.search=N.search;exports.select=k.select;exports.shift=P.shift;exports.some=x.some;exports.sort=C.sort;exports.arrange=T.arrange;exports.substitute=A.substitute;exports.uniq=D.uniq;exports.expires=B.expires;exports.interval=L.interval;exports.timeDiff=w.timeDiff;exports.assert=U.assert;exports.assertParams=F.assertParams;exports.attempt=J.attempt;exports.compare=W.compare;exports.compareBy=j.compareBy;exports.compose=Y.compose;exports.curry=Z.curry;exports.debounce=H.debounce;exports.delay=Q.delay;exports.fp=V.fp;exports.memo=z.memo;exports.once=K.once;exports.parallel=X.parallel;exports.pipe=$.pipe;exports.predict=ee.predict;exports.proxy=re.proxy;exports.prune=ie.prune;exports.retry=se.retry;exports.sleep=te.sleep;exports.throttle=ne.throttle;exports.worker=oe.worker;exports.abs=ce.abs;exports.add=ue.add;exports.allocate=ae.allocate;exports.average=qe.average;exports.boil=le.boil;exports.clamp=Re.clamp;exports.distribute=me.distribute;exports.divide=pe.divide;exports.max=_e.max;exports.median=de.median;exports.min=Se.min;exports.multiply=Ee.multiply;exports.range=fe.range;exports.rate=Ie.rate;exports.round=ge.round;exports.subtract=Oe.subtract;exports.sum=ye.sum;exports.currency=Me.currency;exports.exchange=be.exchange;exports.clone=ve.clone;exports.diff=Ge.diff;exports.entries=he.entries;exports.keys=Ne.keys;exports.merge=ke.merge;exports.parseJSON=Pe.parseJSON;exports.path=xe.path;exports.seek=Ce.seek;exports.values=Te.values;exports.draw=Ae.draw;exports.random=De.random;exports.shuffle=Be.shuffle;exports.uuid=Le.uuid;exports.camelCase=we.camelCase;exports.kebabCase=Ue.kebabCase;exports.pascalCase=Fe.pascalCase;exports.similarity=Je.similarity;exports.snakeCase=We.snakeCase;exports.truncate=je.truncate;exports.ge=Ye.ge;exports.gt=Ze.gt;exports.is=He.is;exports.IS_ARRAY_ERROR_MSG=e.IS_ARRAY_ERROR_MSG;exports.isArray=e.isArray;exports.isBoolean=Qe.isBoolean;exports.IS_DATE_ERROR_MSG=r.IS_DATE_ERROR_MSG;exports.isDate=r.isDate;exports.isDefined=Ve.isDefined;exports.IS_EMPTY_ERROR_MSG=i.IS_EMPTY_ERROR_MSG;exports.isEmpty=i.isEmpty;exports.IS_EQUAL_ERROR_MSG=s.IS_EQUAL_ERROR_MSG;exports.isEqual=s.isEqual;exports.isEven=ze.isEven;exports.IS_FUNCTION_ERROR_MSG=t.IS_FUNCTION_ERROR_MSG;exports.isFunction=t.isFunction;exports.isNegative=Ke.isNegative;exports.IS_NIL_ERROR_MSG=n.IS_NIL_ERROR_MSG;exports.isNil=n.isNil;exports.IS_NUMBER_ERROR_MSG=o.IS_NUMBER_ERROR_MSG;exports.isNumber=o.isNumber;exports.IS_OBJECT_ERROR_MSG=c.IS_OBJECT_ERROR_MSG;exports.isObject=c.isObject;exports.isOdd=Xe.isOdd;exports.isPositive=$e.isPositive;exports.IS_PRIMITIVE_ERROR_MSG=u.IS_PRIMITIVE_ERROR_MSG;exports.isPrimitive=u.isPrimitive;exports.IS_PROMISE_ERROR_MSG=a.IS_PROMISE_ERROR_MSG;exports.isPromise=a.isPromise;exports.isRegex=er.isRegex;exports.IS_STRING_ERROR_MSG=q.IS_STRING_ERROR_MSG;exports.isString=q.isString;exports.IS_WITHIN_ERROR_MSG=l.IS_WITHIN_ERROR_MSG;exports.isWithin=l.isWithin;exports.isZero=rr.isZero;exports.le=ir.le;exports.lt=sr.lt;exports.typeOf=tr.typeOf;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const R=require("./array/aggregate.cjs"),m=require("./array/alternate.cjs"),p=require("./array/arrange.cjs"),_=require("./array/chunk.cjs"),d=require("./array/compact.cjs"),S=require("./array/contains.cjs"),f=require("./array/every.cjs"),E=require("./array/filter.cjs"),I=require("./array/find.cjs"),g=require("./array/findIndex.cjs"),O=require("./array/findLast.cjs"),y=require("./array/flatten.cjs"),M=require("./array/group.cjs"),b=require("./array/list.cjs"),v=require("./array/map.cjs"),h=require("./array/pick.cjs"),G=require("./array/reduce.cjs"),N=require("./array/remoteList.cjs"),k=require("./array/search.cjs"),P=require("./array/select.cjs"),x=require("./array/shift.cjs"),C=require("./array/some.cjs"),T=require("./array/sort.cjs"),A=require("./array/substitute.cjs"),D=require("./array/uniq.cjs"),B=require("./async/attempt.cjs"),L=require("./async/defer.cjs"),w=require("./async/delay.cjs"),F=require("./async/parallel.cjs"),U=require("./async/pool.cjs"),J=require("./async/predict.cjs"),W=require("./async/queue.cjs"),j=require("./async/race.cjs"),Y=require("./async/retry.cjs"),Z=require("./async/sleep.cjs"),H=require("./async/waitFor.cjs"),Q=require("./date/expires.cjs"),V=require("./date/interval.cjs"),z=require("./date/timeDiff.cjs"),K=require("./function/assert.cjs"),X=require("./function/assertParams.cjs"),$=require("./function/compare.cjs"),ee=require("./function/compareBy.cjs"),re=require("./function/compose.cjs"),ie=require("./function/curry.cjs"),se=require("./function/debounce.cjs"),te=require("./function/fp.cjs"),ne=require("./function/memo.cjs"),oe=require("./function/once.cjs"),ce=require("./function/pipe.cjs"),ue=require("./function/proxy.cjs"),ae=require("./function/prune.cjs"),qe=require("./function/throttle.cjs"),le=require("./function/worker.cjs"),Re=require("./math/abs.cjs"),me=require("./math/add.cjs"),pe=require("./math/allocate.cjs"),_e=require("./math/average.cjs"),de=require("./math/boil.cjs"),Se=require("./math/clamp.cjs"),fe=require("./math/distribute.cjs"),Ee=require("./math/divide.cjs"),Ie=require("./math/max.cjs"),ge=require("./math/median.cjs"),Oe=require("./math/min.cjs"),ye=require("./math/multiply.cjs"),Me=require("./math/range.cjs"),be=require("./math/rate.cjs"),ve=require("./math/round.cjs"),he=require("./math/subtract.cjs"),Ge=require("./math/sum.cjs"),Ne=require("./money/currency.cjs"),ke=require("./money/exchange.cjs"),Pe=require("./object/cache.cjs"),xe=require("./object/clone.cjs"),Ce=require("./object/diff.cjs"),Te=require("./object/entries.cjs"),Ae=require("./object/keys.cjs"),De=require("./object/merge.cjs"),Be=require("./object/parseJSON.cjs"),Le=require("./object/path.cjs"),we=require("./object/seek.cjs"),Fe=require("./object/values.cjs"),Ue=require("./random/draw.cjs"),Je=require("./random/random.cjs"),We=require("./random/shuffle.cjs"),je=require("./random/uuid.cjs"),Ye=require("./string/camelCase.cjs"),Ze=require("./string/kebabCase.cjs"),He=require("./string/pascalCase.cjs"),Qe=require("./string/similarity.cjs"),Ve=require("./string/snakeCase.cjs"),ze=require("./string/truncate.cjs"),Ke=require("./typed/ge.cjs"),Xe=require("./typed/gt.cjs"),$e=require("./typed/is.cjs"),e=require("./typed/isArray.cjs"),er=require("./typed/isBoolean.cjs"),r=require("./typed/isDate.cjs"),rr=require("./typed/isDefined.cjs"),i=require("./typed/isEmpty.cjs"),s=require("./typed/isEqual.cjs"),ir=require("./typed/isEven.cjs"),t=require("./typed/isFunction.cjs"),sr=require("./typed/isNegative.cjs"),n=require("./typed/isNil.cjs"),o=require("./typed/isNumber.cjs"),c=require("./typed/isObject.cjs"),tr=require("./typed/isOdd.cjs"),nr=require("./typed/isPositive.cjs"),u=require("./typed/isPrimitive.cjs"),a=require("./typed/isPromise.cjs"),or=require("./typed/isRegex.cjs"),q=require("./typed/isString.cjs"),l=require("./typed/isWithin.cjs"),cr=require("./typed/isZero.cjs"),ur=require("./typed/le.cjs"),ar=require("./typed/lt.cjs"),qr=require("./typed/typeOf.cjs");exports.aggregate=R.aggregate;exports.alternate=m.alternate;exports.arrange=p.arrange;exports.chunk=_.chunk;exports.compact=d.compact;exports.contains=S.contains;exports.every=f.every;exports.filter=E.filter;exports.find=I.find;exports.findIndex=g.findIndex;exports.findLast=O.findLast;exports.flatten=y.flatten;exports.group=M.group;exports.list=b.list;exports.map=v.map;exports.pick=h.pick;exports.reduce=G.reduce;exports.remoteList=N.remoteList;exports.search=k.search;exports.select=P.select;exports.shift=x.shift;exports.some=C.some;exports.sort=T.sort;exports.substitute=A.substitute;exports.uniq=D.uniq;exports.attempt=B.attempt;exports.defer=L.defer;exports.delay=w.delay;exports.parallel=F.parallel;exports.pool=U.pool;exports.predict=J.predict;exports.queue=W.queue;exports.race=j.race;exports.retry=Y.retry;exports.sleep=Z.sleep;exports.waitFor=H.waitFor;exports.expires=Q.expires;exports.interval=V.interval;exports.timeDiff=z.timeDiff;exports.assert=K.assert;exports.assertParams=X.assertParams;exports.compare=$.compare;exports.compareBy=ee.compareBy;exports.compose=re.compose;exports.curry=ie.curry;exports.debounce=se.debounce;exports.fp=te.fp;exports.memo=ne.memo;exports.once=oe.once;exports.pipe=ce.pipe;exports.proxy=ue.proxy;exports.prune=ae.prune;exports.throttle=qe.throttle;exports.worker=le.worker;exports.abs=Re.abs;exports.add=me.add;exports.allocate=pe.allocate;exports.average=_e.average;exports.boil=de.boil;exports.clamp=Se.clamp;exports.distribute=fe.distribute;exports.divide=Ee.divide;exports.max=Ie.max;exports.median=ge.median;exports.min=Oe.min;exports.multiply=ye.multiply;exports.range=Me.range;exports.rate=be.rate;exports.round=ve.round;exports.subtract=he.subtract;exports.sum=Ge.sum;exports.currency=Ne.currency;exports.exchange=ke.exchange;exports.cache=Pe.cache;exports.clone=xe.clone;exports.diff=Ce.diff;exports.entries=Te.entries;exports.keys=Ae.keys;exports.merge=De.merge;exports.parseJSON=Be.parseJSON;exports.path=Le.path;exports.seek=we.seek;exports.values=Fe.values;exports.draw=Ue.draw;exports.random=Je.random;exports.shuffle=We.shuffle;exports.uuid=je.uuid;exports.camelCase=Ye.camelCase;exports.kebabCase=Ze.kebabCase;exports.pascalCase=He.pascalCase;exports.similarity=Qe.similarity;exports.snakeCase=Ve.snakeCase;exports.truncate=ze.truncate;exports.ge=Ke.ge;exports.gt=Xe.gt;exports.is=$e.is;exports.IS_ARRAY_ERROR_MSG=e.IS_ARRAY_ERROR_MSG;exports.isArray=e.isArray;exports.isBoolean=er.isBoolean;exports.IS_DATE_ERROR_MSG=r.IS_DATE_ERROR_MSG;exports.isDate=r.isDate;exports.isDefined=rr.isDefined;exports.IS_EMPTY_ERROR_MSG=i.IS_EMPTY_ERROR_MSG;exports.isEmpty=i.isEmpty;exports.IS_EQUAL_ERROR_MSG=s.IS_EQUAL_ERROR_MSG;exports.isEqual=s.isEqual;exports.isEven=ir.isEven;exports.IS_FUNCTION_ERROR_MSG=t.IS_FUNCTION_ERROR_MSG;exports.isFunction=t.isFunction;exports.isNegative=sr.isNegative;exports.IS_NIL_ERROR_MSG=n.IS_NIL_ERROR_MSG;exports.isNil=n.isNil;exports.IS_NUMBER_ERROR_MSG=o.IS_NUMBER_ERROR_MSG;exports.isNumber=o.isNumber;exports.IS_OBJECT_ERROR_MSG=c.IS_OBJECT_ERROR_MSG;exports.isObject=c.isObject;exports.isOdd=tr.isOdd;exports.isPositive=nr.isPositive;exports.IS_PRIMITIVE_ERROR_MSG=u.IS_PRIMITIVE_ERROR_MSG;exports.isPrimitive=u.isPrimitive;exports.IS_PROMISE_ERROR_MSG=a.IS_PROMISE_ERROR_MSG;exports.isPromise=a.isPromise;exports.isRegex=or.isRegex;exports.IS_STRING_ERROR_MSG=q.IS_STRING_ERROR_MSG;exports.isString=q.isString;exports.IS_WITHIN_ERROR_MSG=l.IS_WITHIN_ERROR_MSG;exports.isWithin=l.isWithin;exports.isZero=cr.isZero;exports.le=ur.le;exports.lt=ar.lt;exports.typeOf=qr.typeOf;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -260,6 +260,35 @@ export declare function average<T>(array: T[], callback?: (item: T) => number |
  */
 export declare function boil<T>(array: readonly T[], callback: (a: T, b: T) => T): T | undefined;
 
+/**
+ * Creates a generic key-value cache with automatic garbage collection and observer support.
+ *
+ * @example
+ * ```ts
+ * const myCache = cache<string>();
+ * myCache.set(['user', 1], 'John Doe');
+ * const value = myCache.get(['user', 1]); // 'John Doe'
+ * myCache.scheduleGc(['user', 1], 5000); // Auto-delete after 5s
+ * ```
+ *
+ * @template T - The type of values stored in the cache.
+ *
+ * @returns A cache instance with get, set, delete, clear, and GC methods.
+ */
+export declare function cache<T>(): {
+    clear: () => void;
+    delete: (key: readonly unknown[]) => boolean;
+    get: (key: readonly unknown[]) => T | undefined;
+    getMeta: (key: readonly unknown[]) => Record<string, unknown> | undefined;
+    getMetaByHash: (keyHash: string) => Record<string, unknown> | undefined;
+    hash: (key: readonly unknown[]) => string;
+    listMetaHashes: () => string[];
+    scheduleGc: (key: readonly unknown[], delayMs: number) => void;
+    set: (key: readonly unknown[], value: T) => void;
+    setMeta: (key: readonly unknown[], meta: Record<string, unknown>) => void;
+    size: () => number;
+};
+
 /** biome-ignore-all lint/suspicious/noExplicitAny: - */
 export declare type Callback<T = any, R = any> = (value: T, index: number, array: T[]) => R;
 
@@ -519,6 +548,29 @@ declare type DeepMerge<T, U> = T extends Obj ? U extends Obj ? {
     [K in keyof T | keyof U]: K extends keyof T ? K extends keyof U ? DeepMerge<T[K], U[K]> : T[K] : K extends keyof U ? U[K] : never;
 } : U : U;
 
+/**
+ * Creates a deferred promise with resolve and reject methods exposed.
+ * Useful for creating promises that are resolved/rejected externally.
+ *
+ * @example
+ * ```ts
+ * const deferred = defer<string>();
+ *
+ * setTimeout(() => {
+ *   deferred.resolve('Done!');
+ * }, 1000);
+ *
+ * const result = await deferred.promise; // 'Done!'
+ * ```
+ *
+ * @returns Object with promise and resolve/reject methods
+ */
+export declare function defer<T = void>(): {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: unknown) => void;
+};
+
 /**
  * Delays the execution of a function by a specified amount of time.
  *
@@ -1898,6 +1950,27 @@ export declare function pipe<T extends FnDynamic[]>(...fns: T): PipeReturn<T>;
 
 declare type PipeReturn<T extends FnDynamic[]> = (...args: FirstParameters<T>) => LastReturnType<T> extends Promise<any> ? Promise<Awaited<LastReturnType<T>>> : LastReturnType<T>;
 
+/**
+ * Creates a promise pool that limits the number of concurrent promises.
+ * Useful for rate limiting API calls or controlling resource usage.
+ *
+ * @example
+ * ```ts
+ * const requestPool = pool(3);
+ *
+ * const results = await Promise.all([
+ *   requestPool(() => fetch('/api/1')),
+ *   requestPool(() => fetch('/api/2')),
+ *   requestPool(() => fetch('/api/3')),
+ *   requestPool(() => fetch('/api/4')), // Will wait for one of the above to finish
+ * ]);
+ * ```
+ *
+ * @param limit - Maximum number of concurrent promises
+ * @returns Function that accepts a promise-returning function and executes it when a slot is available
+ */
+export declare function pool(limit: number): <T>(fn: () => Promise<T>) => Promise<T>;
+
 export declare type Predicate<T> = (value: T, index: number, array: readonly T[]) => boolean;
 
 /**
@@ -1976,6 +2049,74 @@ declare type ProxyOptions<T> = {
  */
 export declare function prune<T>(value: T): T | undefined;
 
+/**
+ * Creates a promise queue that processes promises sequentially with optional concurrency limit.
+ *
+ * @example
+ * ```ts
+ * const requestQueue = queue({ concurrency: 2 });
+ *
+ * requestQueue.add(() => fetch('/api/1'));
+ * requestQueue.add(() => fetch('/api/2'));
+ * requestQueue.add(() => fetch('/api/3'));
+ *
+ * await requestQueue.onIdle(); // Wait for all tasks to complete
+ * ```
+ *
+ * @param options - Queue configuration
+ * @param options.concurrency - Maximum number of concurrent promises (default: 1)
+ * @returns Queue instance with add, onIdle, and clear methods
+ */
+export declare function queue(options?: {
+    concurrency?: number;
+}): {
+    /**
+     * Adds a promise-returning function to the queue
+     */
+    add: <T>(fn: () => Promise<T>) => Promise<T>;
+    /**
+     * Clears all pending tasks from the queue
+     */
+    clear: () => void;
+    /**
+     * Returns a promise that resolves when the queue becomes idle
+     */
+    onIdle: () => Promise<void>;
+    /**
+     * Returns the number of currently active promises
+     */
+    readonly pending: number;
+    /**
+     * Returns the current size of the queue
+     */
+    readonly size: number;
+};
+
+/**
+ * Race multiple promises but with a guaranteed minimum delay.
+ * Useful for showing loading states for at least a minimum duration.
+ *
+ * @example
+ * ```ts
+ * // Show loading spinner for at least 500ms
+ * const result = await race(
+ *   fetchData(),
+ *   500
+ * );
+ *
+ * // With multiple promises
+ * const result = await race(
+ *   [fetch('/api/1'), fetch('/api/2')],
+ *   1000
+ * );
+ * ```
+ *
+ * @param promises - Single promise or array of promises to race
+ * @param minDelay - Minimum delay in milliseconds before resolving
+ * @returns Promise that resolves with the first result after the minimum delay
+ */
+export declare function race<T>(promises: Promise<T> | Promise<T>[], minDelay: number): Promise<T>;
+
 /**
  * Generates a random integer between two values, inclusive.
  *
@@ -2621,6 +2762,40 @@ export declare function uuid(): string;
  */
 export declare function values<T extends Obj, K extends keyof T>(item: T): T[K][];
 
+/**
+ * Waits for a condition to become true by polling.
+ * Useful for waiting for DOM elements, API states, or other conditions.
+ *
+ * @example
+ * ```ts
+ * // Wait for an element to appear
+ * await waitFor(() => document.querySelector('#myElement') !== null);
+ *
+ * // Wait for API to be ready
+ * await waitFor(
+ *   async () => {
+ *     const res = await fetch('/api/health');
+ *     return res.ok;
+ *   },
+ *   { timeout: 30000, interval: 1000 }
+ * );
+ * ```
+ *
+ * @param condition - Function that returns true when condition is met
+ * @param options - Configuration options
+ * @param options.timeout - Maximum time to wait in ms (default: 5000)
+ * @param options.interval - Polling interval in ms (default: 100)
+ * @param options.signal - AbortSignal to cancel waiting
+ * @returns Promise that resolves when condition becomes true
+ * @throws {Error} If timeout is reached
+ * @throws {DOMException} If aborted via signal
+ */
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+    signal?: AbortSignal;
+}): Promise<void>;
+
 /**
  * Creates a function that runs the provided callback in a web worker with specified dependencies.
  *