@vielzeug/toolkit 1.1.2 → 2.0.0

package/dist/async/sleep.js

@@ -1,12 +1,12 @@
-import { assert as n } from "../function/assert.js";
-async function i(e) {
-  return n(
-    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));
+import { assert as e } from "../function/assert.js";
+//#region src/async/sleep.ts
+async function t(t) {
+	return e(typeof t == "number" && t >= 0 && Number.isFinite(t), "Timeout must be a non-negative finite number", {
+		args: { timeout: t },
+		type: TypeError
+	}), new Promise((e) => setTimeout(e, t));
 }
-export {
-  i as sleep
-};
-//# sourceMappingURL=sleep.js.map
+//#endregion
+export { t as sleep };
+
+//# sourceMappingURL=sleep.js.map

package/dist/async/sleep.js.map

@@ -1 +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;"}
+{"version":3,"file":"sleep.js","names":[],"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\n  return new Promise((resolve) => setTimeout(resolve, timeout));\n}\n"],"mappings":";;AAgBA,eAAsB,EAAM,GAAgC;AAO1D,QANA,EACE,OAAO,KAAY,YAAY,KAAW,KAAK,OAAO,SAAS,EAAQ,EACvE,gDACA;EAAE,MAAM,EAAE,YAAS;EAAE,MAAM;EAAW,CACvC,EAEM,IAAI,SAAS,MAAY,WAAW,GAAS,EAAQ,CAAC"}

package/dist/async/waitFor.cjs

@@ -1,2 +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
+async function e(e,t={}){let{interval:n=100,signal:r,timeout:i=5e3}=t,a=AbortSignal.timeout(i),o=r?AbortSignal.any([r,a]):a;return o.throwIfAborted(),new Promise((t,r)=>{let i=null,a=()=>{i!==null&&(clearTimeout(i),i=null),o.removeEventListener(`abort`,s)},s=()=>{a(),r(o.reason)},c=async()=>{try{if(o.aborted){a(),r(o.reason);return}if(await e()){a(),t();return}i=setTimeout(c,n)}catch(e){a(),r(e)}};o.addEventListener(`abort`,s,{once:!0}),c()})}exports.waitFor=e;
+//# sourceMappingURL=waitFor.cjs.map

package/dist/async/waitFor.cjs.map

@@ -1 +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"}
+{"version":3,"file":"waitFor.cjs","names":[],"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 {unknown} Rejects with the merged AbortSignal reason (timeout or abort)\n */\nexport async function waitFor(\n  condition: () => boolean | Promise<boolean>,\n  options: {\n    interval?: number;\n    signal?: AbortSignal;\n    timeout?: number;\n  } = {},\n): Promise<void> {\n  const { interval = 100, signal, timeout: timeoutMs = 5000 } = options;\n  const timeoutSignal = AbortSignal.timeout(timeoutMs);\n  const mergedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;\n\n  mergedSignal.throwIfAborted();\n\n  return new Promise<void>((resolve, reject) => {\n    let intervalId: ReturnType<typeof setTimeout> | null = null;\n\n    const cleanup = () => {\n      if (intervalId !== null) {\n        clearTimeout(intervalId);\n        intervalId = null;\n      }\n\n      mergedSignal.removeEventListener('abort', onAbort);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(mergedSignal.reason);\n    };\n\n    const check = async () => {\n      try {\n        if (mergedSignal.aborted) {\n          cleanup();\n          reject(mergedSignal.reason);\n\n          return;\n        }\n\n        const result = await condition();\n\n        if (result) {\n          cleanup();\n          resolve();\n\n          return;\n        }\n\n        intervalId = setTimeout(check, interval);\n      } catch (error) {\n        cleanup();\n        reject(error);\n      }\n    };\n\n    mergedSignal.addEventListener('abort', onAbort, { once: true });\n\n    // Start checking\n    check();\n  });\n}\n"],"mappings":"AA2BA,eAAsB,EACpB,EACA,EAII,EAAE,CACS,CACf,GAAM,CAAE,WAAW,IAAK,SAAQ,QAAS,EAAY,KAAS,EACxD,EAAgB,YAAY,QAAQ,EAAU,CAC9C,EAAe,EAAS,YAAY,IAAI,CAAC,EAAQ,EAAc,CAAC,CAAG,EAIzE,OAFA,EAAa,gBAAgB,CAEtB,IAAI,SAAe,EAAS,IAAW,CAC5C,IAAI,EAAmD,KAEjD,MAAgB,CAChB,IAAe,OACjB,aAAa,EAAW,CACxB,EAAa,MAGf,EAAa,oBAAoB,QAAS,EAAQ,EAG9C,MAAgB,CACpB,GAAS,CACT,EAAO,EAAa,OAAO,EAGvB,EAAQ,SAAY,CACxB,GAAI,CACF,GAAI,EAAa,QAAS,CACxB,GAAS,CACT,EAAO,EAAa,OAAO,CAE3B,OAKF,GAFe,MAAM,GAAW,CAEpB,CACV,GAAS,CACT,GAAS,CAET,OAGF,EAAa,WAAW,EAAO,EAAS,OACjC,EAAO,CACd,GAAS,CACT,EAAO,EAAM,GAIjB,EAAa,iBAAiB,QAAS,EAAS,CAAE,KAAM,GAAM,CAAC,CAG/D,GAAO,EACP"}

package/dist/async/waitFor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 {unknown} Rejects with the merged AbortSignal reason (timeout or abort)
+ */
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    interval?: number;
+    signal?: AbortSignal;
+    timeout?: number;
+}): Promise<void>;
+//# sourceMappingURL=waitFor.d.ts.map

package/dist/async/waitFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitFor.d.ts","sourceRoot":"","sources":["../../src/async/waitFor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/async/waitFor.js

@@ -1,37 +1,30 @@
-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();
-  });
+//#region src/async/waitFor.ts
+async function e(e, t = {}) {
+	let { interval: n = 100, signal: r, timeout: i = 5e3 } = t, a = AbortSignal.timeout(i), o = r ? AbortSignal.any([r, a]) : a;
+	return o.throwIfAborted(), new Promise((t, r) => {
+		let i = null, a = () => {
+			i !== null && (clearTimeout(i), i = null), o.removeEventListener("abort", s);
+		}, s = () => {
+			a(), r(o.reason);
+		}, c = async () => {
+			try {
+				if (o.aborted) {
+					a(), r(o.reason);
+					return;
+				}
+				if (await e()) {
+					a(), t();
+					return;
+				}
+				i = setTimeout(c, n);
+			} catch (e) {
+				a(), r(e);
+			}
+		};
+		o.addEventListener("abort", s, { once: !0 }), c();
+	});
 }
-export {
-  d as waitFor
-};
-//# sourceMappingURL=waitFor.js.map
+//#endregion
+export { e as waitFor };
+
+//# sourceMappingURL=waitFor.js.map

package/dist/async/waitFor.js.map

@@ -1 +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;"}
+{"version":3,"file":"waitFor.js","names":[],"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 {unknown} Rejects with the merged AbortSignal reason (timeout or abort)\n */\nexport async function waitFor(\n  condition: () => boolean | Promise<boolean>,\n  options: {\n    interval?: number;\n    signal?: AbortSignal;\n    timeout?: number;\n  } = {},\n): Promise<void> {\n  const { interval = 100, signal, timeout: timeoutMs = 5000 } = options;\n  const timeoutSignal = AbortSignal.timeout(timeoutMs);\n  const mergedSignal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;\n\n  mergedSignal.throwIfAborted();\n\n  return new Promise<void>((resolve, reject) => {\n    let intervalId: ReturnType<typeof setTimeout> | null = null;\n\n    const cleanup = () => {\n      if (intervalId !== null) {\n        clearTimeout(intervalId);\n        intervalId = null;\n      }\n\n      mergedSignal.removeEventListener('abort', onAbort);\n    };\n\n    const onAbort = () => {\n      cleanup();\n      reject(mergedSignal.reason);\n    };\n\n    const check = async () => {\n      try {\n        if (mergedSignal.aborted) {\n          cleanup();\n          reject(mergedSignal.reason);\n\n          return;\n        }\n\n        const result = await condition();\n\n        if (result) {\n          cleanup();\n          resolve();\n\n          return;\n        }\n\n        intervalId = setTimeout(check, interval);\n      } catch (error) {\n        cleanup();\n        reject(error);\n      }\n    };\n\n    mergedSignal.addEventListener('abort', onAbort, { once: true });\n\n    // Start checking\n    check();\n  });\n}\n"],"mappings":";AA2BA,eAAsB,EACpB,GACA,IAII,EAAE,EACS;CACf,IAAM,EAAE,cAAW,KAAK,WAAQ,SAAS,IAAY,QAAS,GACxD,IAAgB,YAAY,QAAQ,EAAU,EAC9C,IAAe,IAAS,YAAY,IAAI,CAAC,GAAQ,EAAc,CAAC,GAAG;AAIzE,QAFA,EAAa,gBAAgB,EAEtB,IAAI,SAAe,GAAS,MAAW;EAC5C,IAAI,IAAmD,MAEjD,UAAgB;AAMpB,GALI,MAAe,SACjB,aAAa,EAAW,EACxB,IAAa,OAGf,EAAa,oBAAoB,SAAS,EAAQ;KAG9C,UAAgB;AAEpB,GADA,GAAS,EACT,EAAO,EAAa,OAAO;KAGvB,IAAQ,YAAY;AACxB,OAAI;AACF,QAAI,EAAa,SAAS;AAExB,KADA,GAAS,EACT,EAAO,EAAa,OAAO;AAE3B;;AAKF,QAFe,MAAM,GAAW,EAEpB;AAEV,KADA,GAAS,EACT,GAAS;AAET;;AAGF,QAAa,WAAW,GAAO,EAAS;YACjC,GAAO;AAEd,IADA,GAAS,EACT,EAAO,EAAM;;;AAOjB,EAHA,EAAa,iBAAiB,SAAS,GAAS,EAAE,MAAM,IAAM,CAAC,EAG/D,GAAO;GACP"}

package/dist/date/expires.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function u(e,i=7){const t=typeof e=="string"?new Date(e):e,r=t.getTime();if(Number.isNaN(r))return"UNKNOWN";if(t.getFullYear()>=9999)return"NEVER";const o=Date.now(),n=r-o;return n<=0?"EXPIRED":n<=i*24*60*60*1e3?"SOON":"LATER"}exports.expires=u;
-//# sourceMappingURL=expires.cjs.map
+function e(e,t=7){let n=typeof e==`string`?new Date(e):e,r=n.getTime();if(Number.isNaN(r))return`UNKNOWN`;if(n.getFullYear()>=9999)return`NEVER`;let i=r-Date.now();return i<=0?`EXPIRED`:i<=t*24*60*60*1e3?`SOON`:`LATER`}exports.expires=e;
+//# sourceMappingURL=expires.cjs.map

package/dist/date/expires.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"expires.cjs","sources":["../../src/date/expires.ts"],"sourcesContent":["// #region Expires\nexport type Expires = 'EXPIRED' | 'SOON' | 'LATER' | 'NEVER' | 'UNKNOWN';\n// #endregion Expires\n\n/**\n * Determines the expiry status of a given date.\n *\n * @param date - The date to check, as a string or Date object.\n * @param days - Number of days before expiry to be considered \"SOON\" (default: 7).\n * @returns\n *   - 'EXPIRED' if the date is in the past,\n *   - 'SOON' if the date is within the next `days`,\n *   - 'LATER' if the date is further in the future,\n *   - 'NEVER' if the year is >= 9999,\n *   - 'UNKNOWN' if the date is invalid.\n */\nexport function expires(date: string | Date, days = 7): Expires {\n  const target = typeof date === 'string' ? new Date(date) : date;\n  const targetTime = target.getTime();\n\n  if (Number.isNaN(targetTime)) return 'UNKNOWN';\n  if (target.getFullYear() >= 9999) return 'NEVER';\n\n  const now = Date.now();\n  const diff = targetTime - now;\n\n  if (diff <= 0) return 'EXPIRED';\n  if (diff <= days * 24 * 60 * 60 * 1000) return 'SOON';\n\n  return 'LATER';\n}\n"],"names":["expires","date","days","target","targetTime","now","diff"],"mappings":"gFAgBO,SAASA,EAAQC,EAAqBC,EAAO,EAAY,CAC9D,MAAMC,EAAS,OAAOF,GAAS,SAAW,IAAI,KAAKA,CAAI,EAAIA,EACrDG,EAAaD,EAAO,QAAA,EAE1B,GAAI,OAAO,MAAMC,CAAU,EAAG,MAAO,UACrC,GAAID,EAAO,eAAiB,KAAM,MAAO,QAEzC,MAAME,EAAM,KAAK,IAAA,EACXC,EAAOF,EAAaC,EAE1B,OAAIC,GAAQ,EAAU,UAClBA,GAAQJ,EAAO,GAAK,GAAK,GAAK,IAAa,OAExC,OACT"}
+{"version":3,"file":"expires.cjs","names":[],"sources":["../../src/date/expires.ts"],"sourcesContent":["// #region Expires\nexport type Expires = 'EXPIRED' | 'SOON' | 'LATER' | 'NEVER' | 'UNKNOWN';\n// #endregion Expires\n\n/**\n * Determines the expiry status of a given date.\n *\n * @param date - The date to check, as a string or Date object.\n * @param days - Number of days before expiry to be considered \"SOON\" (default: 7).\n * @returns\n *   - 'EXPIRED' if the date is in the past,\n *   - 'SOON' if the date is within the next `days`,\n *   - 'LATER' if the date is further in the future,\n *   - 'NEVER' if the year is >= 9999,\n *   - 'UNKNOWN' if the date is invalid.\n */\nexport function expires(date: string | Date, days = 7): Expires {\n  const target = typeof date === 'string' ? new Date(date) : date;\n  const targetTime = target.getTime();\n\n  if (Number.isNaN(targetTime)) return 'UNKNOWN';\n\n  if (target.getFullYear() >= 9999) return 'NEVER';\n\n  const now = Date.now();\n  const diff = targetTime - now;\n\n  if (diff <= 0) return 'EXPIRED';\n\n  if (diff <= days * 24 * 60 * 60 * 1000) return 'SOON';\n\n  return 'LATER';\n}\n"],"mappings":"AAgBA,SAAgB,EAAQ,EAAqB,EAAO,EAAY,CAC9D,IAAM,EAAS,OAAO,GAAS,SAAW,IAAI,KAAK,EAAK,CAAG,EACrD,EAAa,EAAO,SAAS,CAEnC,GAAI,OAAO,MAAM,EAAW,CAAE,MAAO,UAErC,GAAI,EAAO,aAAa,EAAI,KAAM,MAAO,QAGzC,IAAM,EAAO,EADD,KAAK,KAAK,CAOtB,OAJI,GAAQ,EAAU,UAElB,GAAQ,EAAO,GAAK,GAAK,GAAK,IAAa,OAExC"}

package/dist/date/expires.d.ts

@@ -0,0 +1,15 @@
+export type Expires = 'EXPIRED' | 'SOON' | 'LATER' | 'NEVER' | 'UNKNOWN';
+/**
+ * Determines the expiry status of a given date.
+ *
+ * @param date - The date to check, as a string or Date object.
+ * @param days - Number of days before expiry to be considered "SOON" (default: 7).
+ * @returns
+ *   - 'EXPIRED' if the date is in the past,
+ *   - 'SOON' if the date is within the next `days`,
+ *   - 'LATER' if the date is further in the future,
+ *   - 'NEVER' if the year is >= 9999,
+ *   - 'UNKNOWN' if the date is invalid.
+ */
+export declare function expires(date: string | Date, days?: number): Expires;
+//# sourceMappingURL=expires.d.ts.map

package/dist/date/expires.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expires.d.ts","sourceRoot":"","sources":["../../src/date/expires.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAGzE;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,SAAI,GAAG,OAAO,CAgB9D"}

package/dist/date/expires.js

@@ -1,11 +1,12 @@
-function f(e, i = 7) {
-  const t = typeof e == "string" ? new Date(e) : e, r = t.getTime();
-  if (Number.isNaN(r)) return "UNKNOWN";
-  if (t.getFullYear() >= 9999) return "NEVER";
-  const o = Date.now(), n = r - o;
-  return n <= 0 ? "EXPIRED" : n <= i * 24 * 60 * 60 * 1e3 ? "SOON" : "LATER";
+//#region src/date/expires.ts
+function e(e, t = 7) {
+	let n = typeof e == "string" ? new Date(e) : e, r = n.getTime();
+	if (Number.isNaN(r)) return "UNKNOWN";
+	if (n.getFullYear() >= 9999) return "NEVER";
+	let i = r - Date.now();
+	return i <= 0 ? "EXPIRED" : i <= t * 24 * 60 * 60 * 1e3 ? "SOON" : "LATER";
 }
-export {
-  f as expires
-};
-//# sourceMappingURL=expires.js.map
+//#endregion
+export { e as expires };
+
+//# sourceMappingURL=expires.js.map

package/dist/date/expires.js.map

@@ -1 +1 @@
-{"version":3,"file":"expires.js","sources":["../../src/date/expires.ts"],"sourcesContent":["// #region Expires\nexport type Expires = 'EXPIRED' | 'SOON' | 'LATER' | 'NEVER' | 'UNKNOWN';\n// #endregion Expires\n\n/**\n * Determines the expiry status of a given date.\n *\n * @param date - The date to check, as a string or Date object.\n * @param days - Number of days before expiry to be considered \"SOON\" (default: 7).\n * @returns\n *   - 'EXPIRED' if the date is in the past,\n *   - 'SOON' if the date is within the next `days`,\n *   - 'LATER' if the date is further in the future,\n *   - 'NEVER' if the year is >= 9999,\n *   - 'UNKNOWN' if the date is invalid.\n */\nexport function expires(date: string | Date, days = 7): Expires {\n  const target = typeof date === 'string' ? new Date(date) : date;\n  const targetTime = target.getTime();\n\n  if (Number.isNaN(targetTime)) return 'UNKNOWN';\n  if (target.getFullYear() >= 9999) return 'NEVER';\n\n  const now = Date.now();\n  const diff = targetTime - now;\n\n  if (diff <= 0) return 'EXPIRED';\n  if (diff <= days * 24 * 60 * 60 * 1000) return 'SOON';\n\n  return 'LATER';\n}\n"],"names":["expires","date","days","target","targetTime","now","diff"],"mappings":"AAgBO,SAASA,EAAQC,GAAqBC,IAAO,GAAY;AAC9D,QAAMC,IAAS,OAAOF,KAAS,WAAW,IAAI,KAAKA,CAAI,IAAIA,GACrDG,IAAaD,EAAO,QAAA;AAE1B,MAAI,OAAO,MAAMC,CAAU,EAAG,QAAO;AACrC,MAAID,EAAO,iBAAiB,KAAM,QAAO;AAEzC,QAAME,IAAM,KAAK,IAAA,GACXC,IAAOF,IAAaC;AAE1B,SAAIC,KAAQ,IAAU,YAClBA,KAAQJ,IAAO,KAAK,KAAK,KAAK,MAAa,SAExC;AACT;"}
+{"version":3,"file":"expires.js","names":[],"sources":["../../src/date/expires.ts"],"sourcesContent":["// #region Expires\nexport type Expires = 'EXPIRED' | 'SOON' | 'LATER' | 'NEVER' | 'UNKNOWN';\n// #endregion Expires\n\n/**\n * Determines the expiry status of a given date.\n *\n * @param date - The date to check, as a string or Date object.\n * @param days - Number of days before expiry to be considered \"SOON\" (default: 7).\n * @returns\n *   - 'EXPIRED' if the date is in the past,\n *   - 'SOON' if the date is within the next `days`,\n *   - 'LATER' if the date is further in the future,\n *   - 'NEVER' if the year is >= 9999,\n *   - 'UNKNOWN' if the date is invalid.\n */\nexport function expires(date: string | Date, days = 7): Expires {\n  const target = typeof date === 'string' ? new Date(date) : date;\n  const targetTime = target.getTime();\n\n  if (Number.isNaN(targetTime)) return 'UNKNOWN';\n\n  if (target.getFullYear() >= 9999) return 'NEVER';\n\n  const now = Date.now();\n  const diff = targetTime - now;\n\n  if (diff <= 0) return 'EXPIRED';\n\n  if (diff <= days * 24 * 60 * 60 * 1000) return 'SOON';\n\n  return 'LATER';\n}\n"],"mappings":";AAgBA,SAAgB,EAAQ,GAAqB,IAAO,GAAY;CAC9D,IAAM,IAAS,OAAO,KAAS,WAAW,IAAI,KAAK,EAAK,GAAG,GACrD,IAAa,EAAO,SAAS;AAEnC,KAAI,OAAO,MAAM,EAAW,CAAE,QAAO;AAErC,KAAI,EAAO,aAAa,IAAI,KAAM,QAAO;CAGzC,IAAM,IAAO,IADD,KAAK,KAAK;AAOtB,QAJI,KAAQ,IAAU,YAElB,KAAQ,IAAO,KAAK,KAAK,KAAK,MAAa,SAExC"}

package/dist/date/index.d.ts

@@ -0,0 +1,4 @@
+export * from './expires';
+export * from './interval';
+export * from './timeDiff';
+//# sourceMappingURL=index.d.ts.map

package/dist/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/date/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/date/interval.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../function/assert.cjs"),i=require("../typed/isDate.cjs");function w(r,c,{interval:e="D",steps:t=1,latest:a=!1}={}){const n=new Date(r),o=new Date(c);l.assert([i.isDate(n),i.isDate(o)],"Invalid date format. Use a valid Date object or ISO string.",{args:{end:c,start:r},type:TypeError});const D=[];let u=new Date(s(n,e,0));for(;u<=o;)D.push(u),u=new Date(s(u,e,t));return a&&D.length>0&&D[D.length-1]<o&&D.push(o),D}function s(r,c,e){const t=r.getFullYear(),a=r.getMonth(),n=r.getDate();switch(c){case"D":return new Date(Date.UTC(t,a,n+e));case"W":return new Date(Date.UTC(t,a,n+7*e));case"M":return new Date(Date.UTC(t,a+e,n));case"MS":return new Date(Date.UTC(t,a+e,1));case"ME":return new Date(Date.UTC(t,a+e+1,0));case"Y":return new Date(Date.UTC(t+e,a,n));case"YS":return new Date(Date.UTC(t+e,0,1));case"YE":return new Date(Date.UTC(t+e,11,31))}}exports.interval=w;
-//# sourceMappingURL=interval.cjs.map
+const e=require(`../function/assert.cjs`),t=require(`../typed/isDate.cjs`);function n(n,i,{interval:a=`day`,latest:o=!1,steps:s=1}={}){let c=new Date(n),l=new Date(i);e.assertAll([t.isDate(c),t.isDate(l)],`Invalid date format. Use a valid Date object or ISO string.`,{args:{end:i,start:n},type:TypeError});let u=[],d=new Date(r(c,a,0));for(;d<=l;)u.push(d),d=new Date(r(d,a,s));return o&&u.length>0&&u[u.length-1]<l&&u.push(l),u}function r(e,t,n){let r=e.getFullYear(),i=e.getMonth(),a=e.getDate();switch(t){case`day`:return new Date(Date.UTC(r,i,a+n));case`month`:return new Date(Date.UTC(r,i+n,a));case`monthEnd`:return new Date(Date.UTC(r,i+n+1,0));case`monthStart`:return new Date(Date.UTC(r,i+n,1));case`week`:return new Date(Date.UTC(r,i,a+7*n));case`year`:return new Date(Date.UTC(r+n,i,a));case`yearEnd`:return new Date(Date.UTC(r+n,11,31));case`yearStart`:return new Date(Date.UTC(r+n,0,1))}}exports.interval=n;
+//# sourceMappingURL=interval.cjs.map

package/dist/date/interval.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"interval.cjs","sources":["../../src/date/interval.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'D' | 'W' | 'M' | 'MS' | 'ME' | 'Y' | 'YS' | 'YE';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  steps?: number;\n  latest?: boolean;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'D', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'D', steps = 1, latest = false }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assert([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'D':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'W':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'M':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'MS':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'ME':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'Y':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'YS':\n      return new Date(Date.UTC(year + steps, 0, 1));\n    case 'YE':\n      return new Date(Date.UTC(year + steps, 11, 31));\n  }\n}\n"],"names":["interval","start","end","steps","latest","startDate","endDate","assert","isDate","dateArray","currentDate","incrementDate","date","year","month","day"],"mappings":"2JA4BO,SAASA,EACdC,EACAC,EACA,CAAE,SAAAF,EAAW,IAAK,MAAAG,EAAQ,EAAG,OAAAC,EAAS,EAAA,EAA2B,CAAA,EACzD,CACR,MAAMC,EAAY,IAAI,KAAKJ,CAAK,EAC1BK,EAAU,IAAI,KAAKJ,CAAG,EAE5BK,EAAAA,OAAO,CAACC,EAAAA,OAAOH,CAAS,EAAGG,EAAAA,OAAOF,CAAO,CAAC,EAAG,8DAA+D,CAC1G,KAAM,CAAE,IAAAJ,EAAK,MAAAD,CAAA,EACb,KAAM,SAAA,CACP,EAED,MAAMQ,EAAoB,CAAA,EAC1B,IAAIC,EAAc,IAAI,KAAKC,EAAcN,EAAWL,EAAU,CAAC,CAAC,EAEhE,KAAOU,GAAeJ,GACpBG,EAAU,KAAKC,CAAW,EAC1BA,EAAc,IAAI,KAAKC,EAAcD,EAAaV,EAAUG,CAAK,CAAC,EAGpE,OAAIC,GAAUK,EAAU,OAAS,GAAKA,EAAUA,EAAU,OAAS,CAAC,EAAIH,GACtEG,EAAU,KAAKH,CAAO,EAGjBG,CACT,CAEA,SAASE,EAAcC,EAAYZ,EAAwBG,EAAqB,CAC9E,MAAMU,EAAOD,EAAK,YAAA,EACZE,EAAQF,EAAK,SAAA,EACbG,EAAMH,EAAK,QAAA,EAEjB,OAAQZ,EAAAA,CACN,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIa,EAAMC,EAAOC,EAAMZ,CAAK,CAAC,EACpD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAOC,EAAM,EAAIZ,CAAK,CAAC,EACxD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAQX,EAAOY,CAAG,CAAC,EACpD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIF,EAAMC,EAAQX,EAAO,CAAC,CAAC,EAClD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAMC,EAAQX,EAAQ,EAAG,CAAC,CAAC,EACtD,IAAK,IACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAOV,EAAOW,EAAOC,CAAG,CAAC,EACpD,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIF,EAAOV,EAAO,EAAG,CAAC,CAAC,EAC9C,IAAK,KACH,OAAO,IAAI,KAAK,KAAK,IAAIU,EAAOV,EAAO,GAAI,EAAE,CAAC,CAAA,CAEpD"}
+{"version":3,"file":"interval.cjs","names":[],"sources":["../../src/date/interval.ts"],"sourcesContent":["import { assertAll } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  latest?: boolean;\n  steps?: number;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'day', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'day', latest = false, steps = 1 }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assertAll([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'day':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'month':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'monthEnd':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'monthStart':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'week':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'year':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'yearEnd':\n      return new Date(Date.UTC(year + steps, 11, 31));\n    case 'yearStart':\n      return new Date(Date.UTC(year + steps, 0, 1));\n  }\n}\n"],"mappings":"2EA4BA,SAAgB,EACd,EACA,EACA,CAAE,WAAW,MAAO,SAAS,GAAO,QAAQ,GAAuB,EAAE,CAC7D,CACR,IAAM,EAAY,IAAI,KAAK,EAAM,CAC3B,EAAU,IAAI,KAAK,EAAI,CAE7B,EAAA,UAAU,CAAC,EAAA,OAAO,EAAU,CAAE,EAAA,OAAO,EAAQ,CAAC,CAAE,8DAA+D,CAC7G,KAAM,CAAE,MAAK,QAAO,CACpB,KAAM,UACP,CAAC,CAEF,IAAM,EAAoB,EAAE,CACxB,EAAc,IAAI,KAAK,EAAc,EAAW,EAAU,EAAE,CAAC,CAEjE,KAAO,GAAe,GACpB,EAAU,KAAK,EAAY,CAC3B,EAAc,IAAI,KAAK,EAAc,EAAa,EAAU,EAAM,CAAC,CAOrE,OAJI,GAAU,EAAU,OAAS,GAAK,EAAU,EAAU,OAAS,GAAK,GACtE,EAAU,KAAK,EAAQ,CAGlB,EAGT,SAAS,EAAc,EAAY,EAAwB,EAAqB,CAC9E,IAAM,EAAO,EAAK,aAAa,CACzB,EAAQ,EAAK,UAAU,CACvB,EAAM,EAAK,SAAS,CAE1B,OAAQ,EAAR,CACE,IAAK,MACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAO,EAAM,EAAM,CAAC,CACrD,IAAK,QACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAO,EAAI,CAAC,CACrD,IAAK,WACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAQ,EAAG,EAAE,CAAC,CACvD,IAAK,aACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAQ,EAAO,EAAE,CAAC,CACnD,IAAK,OACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAM,EAAO,EAAM,EAAI,EAAM,CAAC,CACzD,IAAK,OACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,EAAO,EAAI,CAAC,CACrD,IAAK,UACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,GAAI,GAAG,CAAC,CACjD,IAAK,YACH,OAAO,IAAI,KAAK,KAAK,IAAI,EAAO,EAAO,EAAG,EAAE,CAAC"}

package/dist/date/interval.d.ts

@@ -0,0 +1,25 @@
+type IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';
+type IntervalOptions = {
+    interval?: IntervalType;
+    latest?: boolean;
+    steps?: number;
+};
+/**
+ * Generates an array of dates between a start and end date, with a specified interval and step size.
+ *
+ * @example
+ * ```ts
+ * const options = { interval: 'day', steps: 1, latest: false };
+ *
+ * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022
+ * ```
+ *
+ * @param start - The start date (Date object or ISO string).
+ * @param end - The end date (Date object or ISO string).
+ * @param options - Options for an interval and steps.
+ *
+ * @returns An array of generated dates.
+ */
+export declare function interval(start: Date | string, end: Date | string, { interval, latest, steps }?: IntervalOptions): Date[];
+export {};
+//# sourceMappingURL=interval.d.ts.map

package/dist/date/interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interval.d.ts","sourceRoot":"","sources":["../../src/date/interval.ts"],"names":[],"mappings":"AAIA,KAAK,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAC5G,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,IAAI,GAAG,MAAM,EACpB,GAAG,EAAE,IAAI,GAAG,MAAM,EAClB,EAAE,QAAgB,EAAE,MAAc,EAAE,KAAS,EAAE,GAAE,eAAoB,GACpE,IAAI,EAAE,CAsBR"}

package/dist/date/interval.js

@@ -1,39 +1,33 @@
-import { assert as l } from "../function/assert.js";
-import { isDate as w } from "../typed/isDate.js";
-function U(r, c, { interval: e = "D", steps: t = 1, latest: a = !1 } = {}) {
-  const n = new Date(r), o = new Date(c);
-  l([w(n), w(o)], "Invalid date format. Use a valid Date object or ISO string.", {
-    args: { end: c, start: r },
-    type: TypeError
-  });
-  const D = [];
-  let u = new Date(i(n, e, 0));
-  for (; u <= o; )
-    D.push(u), u = new Date(i(u, e, t));
-  return a && D.length > 0 && D[D.length - 1] < o && D.push(o), D;
+import { assertAll as e } from "../function/assert.js";
+import { isDate as t } from "../typed/isDate.js";
+//#region src/date/interval.ts
+function n(n, i, { interval: a = "day", latest: o = !1, steps: s = 1 } = {}) {
+	let c = new Date(n), l = new Date(i);
+	e([t(c), t(l)], "Invalid date format. Use a valid Date object or ISO string.", {
+		args: {
+			end: i,
+			start: n
+		},
+		type: TypeError
+	});
+	let u = [], d = new Date(r(c, a, 0));
+	for (; d <= l;) u.push(d), d = new Date(r(d, a, s));
+	return o && u.length > 0 && u[u.length - 1] < l && u.push(l), u;
 }
-function i(r, c, e) {
-  const t = r.getFullYear(), a = r.getMonth(), n = r.getDate();
-  switch (c) {
-    case "D":
-      return new Date(Date.UTC(t, a, n + e));
-    case "W":
-      return new Date(Date.UTC(t, a, n + 7 * e));
-    case "M":
-      return new Date(Date.UTC(t, a + e, n));
-    case "MS":
-      return new Date(Date.UTC(t, a + e, 1));
-    case "ME":
-      return new Date(Date.UTC(t, a + e + 1, 0));
-    case "Y":
-      return new Date(Date.UTC(t + e, a, n));
-    case "YS":
-      return new Date(Date.UTC(t + e, 0, 1));
-    case "YE":
-      return new Date(Date.UTC(t + e, 11, 31));
-  }
+function r(e, t, n) {
+	let r = e.getFullYear(), i = e.getMonth(), a = e.getDate();
+	switch (t) {
+		case "day": return new Date(Date.UTC(r, i, a + n));
+		case "month": return new Date(Date.UTC(r, i + n, a));
+		case "monthEnd": return new Date(Date.UTC(r, i + n + 1, 0));
+		case "monthStart": return new Date(Date.UTC(r, i + n, 1));
+		case "week": return new Date(Date.UTC(r, i, a + 7 * n));
+		case "year": return new Date(Date.UTC(r + n, i, a));
+		case "yearEnd": return new Date(Date.UTC(r + n, 11, 31));
+		case "yearStart": return new Date(Date.UTC(r + n, 0, 1));
+	}
 }
-export {
-  U as interval
-};
-//# sourceMappingURL=interval.js.map
+//#endregion
+export { n as interval };
+
+//# sourceMappingURL=interval.js.map

package/dist/date/interval.js.map

@@ -1 +1 @@
-{"version":3,"file":"interval.js","sources":["../../src/date/interval.ts"],"sourcesContent":["import { assert } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'D' | 'W' | 'M' | 'MS' | 'ME' | 'Y' | 'YS' | 'YE';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  steps?: number;\n  latest?: boolean;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'D', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'D', steps = 1, latest = false }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assert([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'D':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'W':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'M':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'MS':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'ME':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'Y':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'YS':\n      return new Date(Date.UTC(year + steps, 0, 1));\n    case 'YE':\n      return new Date(Date.UTC(year + steps, 11, 31));\n  }\n}\n"],"names":["interval","start","end","steps","latest","startDate","endDate","assert","isDate","dateArray","currentDate","incrementDate","date","year","month","day"],"mappings":";;AA4BO,SAASA,EACdC,GACAC,GACA,EAAE,UAAAF,IAAW,KAAK,OAAAG,IAAQ,GAAG,QAAAC,IAAS,GAAA,IAA2B,CAAA,GACzD;AACR,QAAMC,IAAY,IAAI,KAAKJ,CAAK,GAC1BK,IAAU,IAAI,KAAKJ,CAAG;AAE5B,EAAAK,EAAO,CAACC,EAAOH,CAAS,GAAGG,EAAOF,CAAO,CAAC,GAAG,+DAA+D;AAAA,IAC1G,MAAM,EAAE,KAAAJ,GAAK,OAAAD,EAAA;AAAA,IACb,MAAM;AAAA,EAAA,CACP;AAED,QAAMQ,IAAoB,CAAA;AAC1B,MAAIC,IAAc,IAAI,KAAKC,EAAcN,GAAWL,GAAU,CAAC,CAAC;AAEhE,SAAOU,KAAeJ;AACpB,IAAAG,EAAU,KAAKC,CAAW,GAC1BA,IAAc,IAAI,KAAKC,EAAcD,GAAaV,GAAUG,CAAK,CAAC;AAGpE,SAAIC,KAAUK,EAAU,SAAS,KAAKA,EAAUA,EAAU,SAAS,CAAC,IAAIH,KACtEG,EAAU,KAAKH,CAAO,GAGjBG;AACT;AAEA,SAASE,EAAcC,GAAYZ,GAAwBG,GAAqB;AAC9E,QAAMU,IAAOD,EAAK,YAAA,GACZE,IAAQF,EAAK,SAAA,GACbG,IAAMH,EAAK,QAAA;AAEjB,UAAQZ,GAAAA;AAAAA,IACN,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIa,GAAMC,GAAOC,IAAMZ,CAAK,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,GAAOC,IAAM,IAAIZ,CAAK,CAAC;AAAA,IACxD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,IAAQX,GAAOY,CAAG,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIF,GAAMC,IAAQX,GAAO,CAAC,CAAC;AAAA,IAClD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,GAAMC,IAAQX,IAAQ,GAAG,CAAC,CAAC;AAAA,IACtD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,IAAOV,GAAOW,GAAOC,CAAG,CAAC;AAAA,IACpD,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIF,IAAOV,GAAO,GAAG,CAAC,CAAC;AAAA,IAC9C,KAAK;AACH,aAAO,IAAI,KAAK,KAAK,IAAIU,IAAOV,GAAO,IAAI,EAAE,CAAC;AAAA,EAAA;AAEpD;"}
+{"version":3,"file":"interval.js","names":[],"sources":["../../src/date/interval.ts"],"sourcesContent":["import { assertAll } from '../function/assert';\nimport { isDate } from '../typed/isDate';\n\n// #region IntervalTypes\ntype IntervalType = 'day' | 'week' | 'month' | 'monthStart' | 'monthEnd' | 'year' | 'yearStart' | 'yearEnd';\ntype IntervalOptions = {\n  interval?: IntervalType;\n  latest?: boolean;\n  steps?: number;\n};\n// #endregion IntervalTypes\n\n/**\n * Generates an array of dates between a start and end date, with a specified interval and step size.\n *\n * @example\n * ```ts\n * const options = { interval: 'day', steps: 1, latest: false };\n *\n * interval('2022-01-01', '2022-01-31', options); // Returns an array of dates for every day in January 2022\n * ```\n *\n * @param start - The start date (Date object or ISO string).\n * @param end - The end date (Date object or ISO string).\n * @param options - Options for an interval and steps.\n *\n * @returns An array of generated dates.\n */\nexport function interval(\n  start: Date | string,\n  end: Date | string,\n  { interval = 'day', latest = false, steps = 1 }: IntervalOptions = {},\n): Date[] {\n  const startDate = new Date(start);\n  const endDate = new Date(end);\n\n  assertAll([isDate(startDate), isDate(endDate)], 'Invalid date format. Use a valid Date object or ISO string.', {\n    args: { end, start },\n    type: TypeError,\n  });\n\n  const dateArray: Date[] = [];\n  let currentDate = new Date(incrementDate(startDate, interval, 0));\n\n  while (currentDate <= endDate) {\n    dateArray.push(currentDate);\n    currentDate = new Date(incrementDate(currentDate, interval, steps));\n  }\n\n  if (latest && dateArray.length > 0 && dateArray[dateArray.length - 1] < endDate) {\n    dateArray.push(endDate);\n  }\n\n  return dateArray;\n}\n\nfunction incrementDate(date: Date, interval: IntervalType, steps: number): Date {\n  const year = date.getFullYear();\n  const month = date.getMonth();\n  const day = date.getDate();\n\n  switch (interval) {\n    case 'day':\n      return new Date(Date.UTC(year, month, day + steps));\n    case 'month':\n      return new Date(Date.UTC(year, month + steps, day));\n    case 'monthEnd':\n      return new Date(Date.UTC(year, month + steps + 1, 0));\n    case 'monthStart':\n      return new Date(Date.UTC(year, month + steps, 1));\n    case 'week':\n      return new Date(Date.UTC(year, month, day + 7 * steps));\n    case 'year':\n      return new Date(Date.UTC(year + steps, month, day));\n    case 'yearEnd':\n      return new Date(Date.UTC(year + steps, 11, 31));\n    case 'yearStart':\n      return new Date(Date.UTC(year + steps, 0, 1));\n  }\n}\n"],"mappings":";;;AA4BA,SAAgB,EACd,GACA,GACA,EAAE,cAAW,OAAO,YAAS,IAAO,WAAQ,MAAuB,EAAE,EAC7D;CACR,IAAM,IAAY,IAAI,KAAK,EAAM,EAC3B,IAAU,IAAI,KAAK,EAAI;AAE7B,GAAU,CAAC,EAAO,EAAU,EAAE,EAAO,EAAQ,CAAC,EAAE,+DAA+D;EAC7G,MAAM;GAAE;GAAK;GAAO;EACpB,MAAM;EACP,CAAC;CAEF,IAAM,IAAoB,EAAE,EACxB,IAAc,IAAI,KAAK,EAAc,GAAW,GAAU,EAAE,CAAC;AAEjE,QAAO,KAAe,GAEpB,CADA,EAAU,KAAK,EAAY,EAC3B,IAAc,IAAI,KAAK,EAAc,GAAa,GAAU,EAAM,CAAC;AAOrE,QAJI,KAAU,EAAU,SAAS,KAAK,EAAU,EAAU,SAAS,KAAK,KACtE,EAAU,KAAK,EAAQ,EAGlB;;AAGT,SAAS,EAAc,GAAY,GAAwB,GAAqB;CAC9E,IAAM,IAAO,EAAK,aAAa,EACzB,IAAQ,EAAK,UAAU,EACvB,IAAM,EAAK,SAAS;AAE1B,SAAQ,GAAR;EACE,KAAK,MACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,GAAO,IAAM,EAAM,CAAC;EACrD,KAAK,QACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,GAAO,EAAI,CAAC;EACrD,KAAK,WACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,IAAQ,GAAG,EAAE,CAAC;EACvD,KAAK,aACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,IAAQ,GAAO,EAAE,CAAC;EACnD,KAAK,OACH,QAAO,IAAI,KAAK,KAAK,IAAI,GAAM,GAAO,IAAM,IAAI,EAAM,CAAC;EACzD,KAAK,OACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,GAAO,EAAI,CAAC;EACrD,KAAK,UACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,IAAI,GAAG,CAAC;EACjD,KAAK,YACH,QAAO,IAAI,KAAK,KAAK,IAAI,IAAO,GAAO,GAAG,EAAE,CAAC"}

package/dist/date/timeDiff.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});let c=["YEAR","MONTH","WEEK","DAY","HOUR","MINUTE","SECOND"];const f=1e3,N=60*f,m=60*N,n=24*m,D=7*n,_=30*n,S=365*n,R=[{ms:S,unit:"YEAR"},{ms:_,unit:"MONTH"},{ms:D,unit:"WEEK"},{ms:n,unit:"DAY"},{ms:m,unit:"HOUR"},{ms:N,unit:"MINUTE"},{ms:f,unit:"SECOND"}];function M(t,e=new Date,l=c){const o=typeof t=="string"?Date.parse(t):t.getTime(),a=typeof e=="string"?Date.parse(e):e.getTime();if(Number.isNaN(o)||Number.isNaN(a))return{unit:"INVALID_DATE",value:0};const i=R.filter(E=>l.includes(E.unit)),s=Math.abs(o-a),r=i[i.length-1]?.unit??"SECOND";if(s<=0)return{unit:r,value:0};const u=i.find(E=>s>=E.ms);return u?{unit:u.unit,value:Math.floor(s/u.ms)}:{unit:r,value:0}}M.defaultUnits=t=>{c=t};exports.timeDiff=M;
-//# sourceMappingURL=timeDiff.cjs.map
+var e=[`year`,`month`,`week`,`day`,`hour`,`minute`,`second`],t=1e3,n=60*t,r=60*n,i=24*r,a=7*i,o=30*i,s=[{ms:365*i,unit:`year`},{ms:o,unit:`month`},{ms:a,unit:`week`},{ms:i,unit:`day`},{ms:r,unit:`hour`},{ms:n,unit:`minute`},{ms:t,unit:`second`}];function c(t,n=new Date,r=e){let i=typeof t==`string`?Date.parse(t):t.getTime(),a=typeof n==`string`?Date.parse(n):n.getTime();if(Number.isNaN(i)||Number.isNaN(a))return;let o=s.filter(e=>r.includes(e.unit)),c=Math.abs(i-a),l=o[o.length-1]?.unit??`second`;if(c<=0)return{unit:l,value:0};let u=o.find(e=>c>=e.ms);return u?{unit:u.unit,value:Math.floor(c/u.ms)}:{unit:l,value:0}}exports.timeDiff=c;
+//# sourceMappingURL=timeDiff.cjs.map

package/dist/date/timeDiff.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"timeDiff.cjs","sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | 'MINUTE' | 'SECOND' | 'INVALID_DATE';\nexport type TimeDirection = 'FUTURE' | 'PAST';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nlet defaultUnits: TimeUnit[] = ['YEAR', 'MONTH', 'WEEK', 'DAY', 'HOUR', 'MINUTE', 'SECOND'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'YEAR' as const },\n  { ms: MS_PER_MONTH, unit: 'MONTH' as const },\n  { ms: MS_PER_WEEK, unit: 'WEEK' as const },\n  { ms: MS_PER_DAY, unit: 'DAY' as const },\n  { ms: MS_PER_HOUR, unit: 'HOUR' as const },\n  { ms: MS_PER_MINUTE, unit: 'MINUTE' as const },\n  { ms: MS_PER_SECOND, unit: 'SECOND' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'DAY' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'DAY' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'MONTH' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'YEAR' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = defaultUnits,\n): TimeResult {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return { unit: 'INVALID_DATE', value: 0 };\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'SECOND';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n\ntimeDiff.defaultUnits = (units: TimeUnit[]) => {\n  defaultUnits = units;\n};\n"],"names":["defaultUnits","MS_PER_SECOND","MS_PER_MINUTE","MS_PER_HOUR","MS_PER_DAY","MS_PER_WEEK","MS_PER_MONTH","MS_PER_YEAR","TIME_UNITS","timeDiff","a","b","allowedUnits","aDate","bDate","units","u","diff","smallestUnit","bestUnit"],"mappings":"gFAMA,IAAIA,EAA2B,CAAC,OAAQ,QAAS,OAAQ,MAAO,OAAQ,SAAU,QAAQ,EAE1F,MAAMC,EAAgB,IAChBC,EAAgB,GAAKD,EACrBE,EAAc,GAAKD,EACnBE,EAAa,GAAKD,EAClBE,EAAc,EAAID,EAClBE,EAAe,GAAKF,EACpBG,EAAc,IAAMH,EAEpBI,EAAa,CACjB,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAc,KAAM,OAAA,EAC1B,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAY,KAAM,KAAA,EACxB,CAAE,GAAID,EAAa,KAAM,MAAA,EACzB,CAAE,GAAID,EAAe,KAAM,QAAA,EAC3B,CAAE,GAAID,EAAe,KAAM,QAAA,CAC7B,EAmBO,SAASQ,EACdC,EACAC,MAAuB,KACvBC,EAA2BZ,EACf,CACZ,MAAMa,EAAQ,OAAOH,GAAM,SAAW,KAAK,MAAMA,CAAC,EAAIA,EAAE,QAAA,EAClDI,EAAQ,OAAOH,GAAM,SAAW,KAAK,MAAMA,CAAC,EAAIA,EAAE,QAAA,EAExD,GAAI,OAAO,MAAME,CAAK,GAAK,OAAO,MAAMC,CAAK,EAC3C,MAAO,CAAE,KAAM,eAAgB,MAAO,CAAA,EAGxC,MAAMC,EAAQP,EAAW,OAAQQ,GAAMJ,EAAa,SAASI,EAAE,IAAI,CAAC,EAC9DC,EAAO,KAAK,IAAIJ,EAAQC,CAAK,EAC7BI,EAAeH,EAAMA,EAAM,OAAS,CAAC,GAAG,MAAQ,SAEtD,GAAIE,GAAQ,EACV,MAAO,CAAE,KAAMC,EAAc,MAAO,CAAA,EAItC,MAAMC,EAAWJ,EAAM,KAAMC,GAAMC,GAAQD,EAAE,EAAE,EAE/C,OAAIG,EACK,CAAE,KAAMA,EAAS,KAAM,MAAO,KAAK,MAAMF,EAAOE,EAAS,EAAE,CAAA,EAG7D,CAAE,KAAMD,EAAc,MAAO,CAAA,CACtC,CAEAT,EAAS,aAAgBM,GAAsB,CAC7Cf,EAAee,CACjB"}
+{"version":3,"file":"timeDiff.cjs","names":[],"sources":["../../src/date/timeDiff.ts"],"sourcesContent":["// #region TimeDiffTypes\nexport type TimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';\nexport type TimeResult = { unit: TimeUnit; value: number };\n// #endregion TimeDiffTypes\n\nconst ALL_UNITS: TimeUnit[] = ['year', 'month', 'week', 'day', 'hour', 'minute', 'second'];\n\nconst MS_PER_SECOND = 1000;\nconst MS_PER_MINUTE = 60 * MS_PER_SECOND;\nconst MS_PER_HOUR = 60 * MS_PER_MINUTE;\nconst MS_PER_DAY = 24 * MS_PER_HOUR;\nconst MS_PER_WEEK = 7 * MS_PER_DAY;\nconst MS_PER_MONTH = 30 * MS_PER_DAY;\nconst MS_PER_YEAR = 365 * MS_PER_DAY;\n\nconst TIME_UNITS = [\n  { ms: MS_PER_YEAR, unit: 'year' as const },\n  { ms: MS_PER_MONTH, unit: 'month' as const },\n  { ms: MS_PER_WEEK, unit: 'week' as const },\n  { ms: MS_PER_DAY, unit: 'day' as const },\n  { ms: MS_PER_HOUR, unit: 'hour' as const },\n  { ms: MS_PER_MINUTE, unit: 'minute' as const },\n  { ms: MS_PER_SECOND, unit: 'second' as const },\n];\n\n/**\n * Calculates the remaining time until a target date.\n *\n * @example\n * ```ts\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'day' }\n * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'day' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'month' }\n * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'year' }\n * ```\n *\n * @param a - The target date (Date object or ISO string).\n * @param b - The target date (Date object or ISO string).\n * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.\n *\n * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').\n */\nexport function timeDiff(\n  a: Date | string,\n  b: Date | string = new Date(),\n  allowedUnits: TimeUnit[] = ALL_UNITS,\n): TimeResult | undefined {\n  const aDate = typeof a === 'string' ? Date.parse(a) : a.getTime();\n  const bDate = typeof b === 'string' ? Date.parse(b) : b.getTime();\n\n  if (Number.isNaN(aDate) || Number.isNaN(bDate)) {\n    return undefined;\n  }\n\n  const units = TIME_UNITS.filter((u) => allowedUnits.includes(u.unit));\n  const diff = Math.abs(aDate - bDate);\n  const smallestUnit = units[units.length - 1]?.unit ?? 'second';\n\n  if (diff <= 0) {\n    return { unit: smallestUnit, value: 0 };\n  }\n\n  // Find the largest unit that fits\n  const bestUnit = units.find((u) => diff >= u.ms);\n\n  if (bestUnit) {\n    return { unit: bestUnit.unit, value: Math.floor(diff / bestUnit.ms) };\n  }\n\n  return { unit: smallestUnit, value: 0 };\n}\n"],"mappings":"AAKA,IAAM,EAAwB,CAAC,OAAQ,QAAS,OAAQ,MAAO,OAAQ,SAAU,SAAS,CAEpF,EAAgB,IAChB,EAAgB,GAAK,EACrB,EAAc,GAAK,EACnB,EAAa,GAAK,EAClB,EAAc,EAAI,EAClB,EAAe,GAAK,EAGpB,EAAa,CACjB,CAAE,GAHgB,IAAM,EAGL,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAc,KAAM,QAAkB,CAC5C,CAAE,GAAI,EAAa,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAY,KAAM,MAAgB,CACxC,CAAE,GAAI,EAAa,KAAM,OAAiB,CAC1C,CAAE,GAAI,EAAe,KAAM,SAAmB,CAC9C,CAAE,GAAI,EAAe,KAAM,SAAmB,CAC/C,CAmBD,SAAgB,EACd,EACA,EAAmB,IAAI,KACvB,EAA2B,EACH,CACxB,IAAM,EAAQ,OAAO,GAAM,SAAW,KAAK,MAAM,EAAE,CAAG,EAAE,SAAS,CAC3D,EAAQ,OAAO,GAAM,SAAW,KAAK,MAAM,EAAE,CAAG,EAAE,SAAS,CAEjE,GAAI,OAAO,MAAM,EAAM,EAAI,OAAO,MAAM,EAAM,CAC5C,OAGF,IAAM,EAAQ,EAAW,OAAQ,GAAM,EAAa,SAAS,EAAE,KAAK,CAAC,CAC/D,EAAO,KAAK,IAAI,EAAQ,EAAM,CAC9B,EAAe,EAAM,EAAM,OAAS,IAAI,MAAQ,SAEtD,GAAI,GAAQ,EACV,MAAO,CAAE,KAAM,EAAc,MAAO,EAAG,CAIzC,IAAM,EAAW,EAAM,KAAM,GAAM,GAAQ,EAAE,GAAG,CAMhD,OAJI,EACK,CAAE,KAAM,EAAS,KAAM,MAAO,KAAK,MAAM,EAAO,EAAS,GAAG,CAAE,CAGhE,CAAE,KAAM,EAAc,MAAO,EAAG"}

package/dist/date/timeDiff.d.ts

@@ -0,0 +1,24 @@
+export type TimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
+export type TimeResult = {
+    unit: TimeUnit;
+    value: number;
+};
+/**
+ * Calculates the remaining time until a target date.
+ *
+ * @example
+ * ```ts
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 5)); // { value: 5, unit: 'day' }
+ * timeDiff(new Date(Date.now() - 1000 * 60 * 60 * 24 * 3), 'past'); // { value: 3, unit: 'day' }
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 31)); // { value: 1, unit: 'month' }
+ * timeDiff(new Date(Date.now() + 1000 * 60 * 60 * 24 * 365)); // { value: 1, unit: 'year' }
+ * ```
+ *
+ * @param a - The target date (Date object or ISO string).
+ * @param b - The target date (Date object or ISO string).
+ * @param allowedUnits - (optional) array of units to filter the result. If provided, only these units will be considered.
+ *
+ * @returns An object containing the remaining time and its unit ('DAY', 'HOUR', or 'MINUTE').
+ */
+export declare function timeDiff(a: Date | string, b?: Date | string, allowedUnits?: TimeUnit[]): TimeResult | undefined;
+//# sourceMappingURL=timeDiff.d.ts.map

package/dist/date/timeDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeDiff.d.ts","sourceRoot":"","sources":["../../src/date/timeDiff.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAuB3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,IAAI,GAAG,MAAM,EAChB,CAAC,GAAE,IAAI,GAAG,MAAmB,EAC7B,YAAY,GAAE,QAAQ,EAAc,GACnC,UAAU,GAAG,SAAS,CAwBxB"}