@alwatr/delay 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.0.3](https://github.com/Alwatr/nanolib/compare/@alwatr/delay@1.0.2...@alwatr/delay@1.0.3) (2024-10-11)
+
+**Note:** Version bump only for package @alwatr/delay
+
+## [1.0.2](https://github.com/Alwatr/nanolib/compare/@alwatr/delay@1.0.1...@alwatr/delay@1.0.2) (2024-10-10)
+
+### Dependencies update
+
+* bump the development-dependencies group with 10 updates ([fa4aaf0](https://github.com/Alwatr/nanolib/commit/fa4aaf04c907ecae06aa14000ce35216170c15ad)) by @dependabot[bot]
+
 ## [1.0.1](https://github.com/Alwatr/nanolib/compare/@alwatr/delay@1.0.0...@alwatr/delay@1.0.1) (2024-10-08)
 
 **Note:** Version bump only for package @alwatr/delay

package/README.md

@@ -101,7 +101,7 @@ This package is distributed under the [MIT License](https://alimd.mit-license.or
 
 ## Sponsors
 
-The following companies, organizations, and individuals support Nitrobase ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.
+The following companies, organizations, and individuals support Nanolib ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.
 
 [![Exir Studio](https://avatars.githubusercontent.com/u/181194967?s=200&v=4)](https://exirstudio.com)
 

package/dist/main.cjs

@@ -1,3 +1,156 @@
-/* @alwatr/delay v1.0.1 */
-"use strict";var a=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var q=(e,t)=>{for(var i in t)a(e,i,{get:t[i],enumerable:!0})},b=(e,t,i,m)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of f(t))!k.call(e,n)&&n!==i&&a(e,n,{get:()=>t[n],enumerable:!(m=p(t,n))||m.enumerable});return e};var y=e=>b(a({},"__esModule",{value:!0}),e);var P={};q(P,{delay:()=>r});module.exports=y(P);var u=require("@alwatr/global-scope"),o=u.globalScope,v=e=>setTimeout(()=>e(Date.now()),1e3/60),l=o.requestAnimationFrame||o.webkitRequestAnimationFrame||o.mozRequestAnimationFrame||v,T=(e,t)=>setTimeout(e,t?.timeout??2e3),c=o.requestIdleCallback||o.webkitRequestIdleCallback||o.mozRequestIdleCallback||T;var d=require("@alwatr/package-tracer"),s=require("@alwatr/parse-duration");d.packageTracer.add("@alwatr/delay","1.0.1");var r={by:e=>new Promise(t=>setTimeout(t,(0,s.parseDuration)(e))),untilNextAnimationFrame:()=>new Promise(e=>l(e)),untilIdle:e=>new Promise(t=>c(t,e===void 0?void 0:{timeout:(0,s.parseDuration)(e)})),untilDomEvent:(e,t)=>new Promise(i=>e.addEventListener(t,i,{once:!0,passive:!0})),untilEvent:(e,t)=>new Promise(i=>e.addEventListener(t,i,{once:!0,passive:!0})),immediate:()=>typeof setImmediate!="function"?typeof queueMicrotask=="function"?r.nextMicrotask():r.by(0):new Promise(e=>setImmediate(e)),nextMicrotask:()=>typeof queueMicrotask!="function"?typeof setImmediate=="function"?r.immediate():r.by(0):new Promise(e=>queueMicrotask(e))};0&&(module.exports={delay});
+/* @alwatr/delay v1.0.3 */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/main.ts
+var main_exports = {};
+__export(main_exports, {
+  delay: () => delay
+});
+module.exports = __toCommonJS(main_exports);
+var import_package_tracer = require("@alwatr/package-tracer");
+var import_parse_duration = require("@alwatr/parse-duration");
+
+// src/polyfill.ts
+var import_global_scope = require("@alwatr/global-scope");
+var win = import_global_scope.globalScope;
+var requestAnimationFrameFallback = (callback) => setTimeout(() => callback(Date.now()), 1e3 / 60);
+var requestAnimationFrame = win.requestAnimationFrame || win.webkitRequestAnimationFrame || win.mozRequestAnimationFrame || requestAnimationFrameFallback;
+var requestIdleCallbackFallback = (callback, options) => setTimeout(callback, options?.timeout ?? 2e3);
+var requestIdleCallback = win.requestIdleCallback || win.webkitRequestIdleCallback || win.mozRequestIdleCallback || requestIdleCallbackFallback;
+
+// src/main.ts
+import_package_tracer.packageTracer.add("@alwatr/delay", "1.0.3");
+var delay = {
+  /**
+   * Delays execution for a specified duration (in milliseconds).
+   *
+   * @param duration - The duration to wait (in milliseconds). Use `0` to yield control to the event loop.
+   * @returns A Promise that resolves after the specified duration.
+   *
+   * @example
+   * ```typescript
+   * await delay.by('1m'); // Wait for 1 minute
+   * ```
+   */
+  by: (duration) => new Promise((resolve) => setTimeout(resolve, (0, import_parse_duration.parseDuration)(duration))),
+  /**
+   * Delays execution until the next animation frame.
+   *
+   * @returns A Promise that resolves with the current timestamp when the next animation frame is fired.
+   *
+   * @example
+   * ```typescript
+   * const timestamp = await delay.untilNextAnimationFrame();
+   * ```
+   */
+  untilNextAnimationFrame: () => new Promise((resolve) => requestAnimationFrame(resolve)),
+  /**
+   * Delays execution until the browser's idle period or the specified timeout.
+   *
+   * @param timeout - Optional timeout (in milliseconds) for the idle callback.
+   * @returns A Promise that resolves with the IdleDeadline object when the browser is idle or the timeout is reached.
+   *
+   * @example
+   * ```typescript
+   * const deadline = await delay.untilIdle();
+   * ```
+   */
+  untilIdle: (timeout) => new Promise((resolve) => requestIdleCallback(resolve, timeout === void 0 ? void 0 : {
+    timeout: (0, import_parse_duration.parseDuration)(timeout)
+  })),
+  /**
+   * Delays execution until a specific DOM event occurs on an HTMLElement.
+   *
+   * @param element - The HTMLElement to listen for the event on.
+   * @param eventName - The name of the DOM event to wait for.
+   * @template T The event map type.
+   * @returns A Promise that resolves with the event object when the specified event occurs.
+   *
+   * @example
+   * ```typescript
+   * const clickEvent = await delay.untilDomEvent(document.body, 'click');
+   * ```
+   */
+  untilDomEvent: (element, eventName) => new Promise(
+    (resolve) => element.addEventListener(eventName, resolve, { once: true, passive: true })
+  ),
+  /**
+   * Delays execution until a specific event occurs on an object with an `addEventListener` method.
+   *
+   * @param target - The target object to listen for the event on.
+   * @param eventName - The name of the event to wait for.
+   * @returns A Promise that resolves with the event object when the specified event occurs.
+   *
+   * @example
+   * ```typescript
+   * const server = http.createServer();
+   * const requestEvent = await delay.untilEvent(server, 'request');
+   * ```
+   */
+  untilEvent: (target, eventName) => new Promise(
+    (resolve) => target.addEventListener(eventName, resolve, { once: true, passive: true })
+  ),
+  /**
+   * Yields control to the event loop immediately.
+   *
+   * Uses `setImmediate` if available, falls back to `queueMicrotask`, and then to `setTimeout(0)`.
+   *
+   * @returns A Promise that resolves immediately after yielding control to the event loop.
+   *
+   * @example
+   * ```typescript
+   * await delay.immediate();
+   * ```
+   */
+  immediate: () => {
+    if (typeof setImmediate !== "function") {
+      if (typeof queueMicrotask === "function") {
+        return delay.nextMicrotask();
+      }
+      return delay.by(0);
+    }
+    return new Promise((resolve) => setImmediate(resolve));
+  },
+  /**
+   * Delays execution until the next microtask queue is empty
+   *
+   * @returns A Promise that resolves when the next microtask queue is empty.
+   *
+   * @example
+   * ```typescript
+   * await delay.nextMicrotask();
+   * ```
+   */
+  nextMicrotask: () => {
+    if (typeof queueMicrotask !== "function") {
+      if (typeof setImmediate === "function") {
+        return delay.immediate();
+      }
+      return delay.by(0);
+    }
+    return new Promise((resolve) => queueMicrotask(resolve));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  delay
+});
+/*! For license information please see main.cjs.LEGAL.txt */
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/main.ts", "../src/polyfill.ts"],
   "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\nimport {parseDuration, type Duration} from '@alwatr/parse-duration';\n\npackageTracer.add(__package_name__, __package_version__);\n\nimport {requestAnimationFrame, requestIdleCallback} from './polyfill.js';\n\n/**\n * A utility module to help manage asynchronous operations and waiting for events or timeouts.\n */\nexport const delay = {\n  /**\n   * Delays execution for a specified duration (in milliseconds).\n   *\n   * @param duration - The duration to wait (in milliseconds). Use `0` to yield control to the event loop.\n   * @returns A Promise that resolves after the specified duration.\n   *\n   * @example\n   * ```typescript\n   * await delay.by('1m'); // Wait for 1 minute\n   * ```\n   */\n  by: (duration: Duration): Promise<void> =>\n    new Promise((resolve) => setTimeout(resolve, parseDuration(duration))),\n\n  /**\n   * Delays execution until the next animation frame.\n   *\n   * @returns A Promise that resolves with the current timestamp when the next animation frame is fired.\n   *\n   * @example\n   * ```typescript\n   * const timestamp = await delay.untilNextAnimationFrame();\n   * ```\n   */\n  untilNextAnimationFrame: (): Promise<DOMHighResTimeStamp> =>\n    new Promise((resolve) => requestAnimationFrame(resolve)),\n\n  /**\n   * Delays execution until the browser's idle period or the specified timeout.\n   *\n   * @param timeout - Optional timeout (in milliseconds) for the idle callback.\n   * @returns A Promise that resolves with the IdleDeadline object when the browser is idle or the timeout is reached.\n   *\n   * @example\n   * ```typescript\n   * const deadline = await delay.untilIdle();\n   * ```\n   */\n  untilIdle: (timeout?: Duration): Promise<IdleDeadline> =>\n    new Promise((resolve) => requestIdleCallback(resolve, timeout === undefined ? undefined : {\n      timeout: parseDuration(timeout)\n    })),\n\n  /**\n   * Delays execution until a specific DOM event occurs on an HTMLElement.\n   *\n   * @param element - The HTMLElement to listen for the event on.\n   * @param eventName - The name of the DOM event to wait for.\n   * @template T The event map type.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const clickEvent = await delay.untilDomEvent(document.body, 'click');\n   * ```\n   */\n  untilDomEvent: <T extends keyof HTMLElementEventMap>(\n    element: HTMLElement,\n    eventName: T\n  ): Promise<HTMLElementEventMap[T]> =>\n    new Promise((resolve) =>\n      element.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Delays execution until a specific event occurs on an object with an `addEventListener` method.\n   *\n   * @param target - The target object to listen for the event on.\n   * @param eventName - The name of the event to wait for.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const server = http.createServer();\n   * const requestEvent = await delay.untilEvent(server, 'request');\n   * ```\n   */\n  untilEvent: (target: HasAddEventListener, eventName: string): Promise<Event> =>\n    new Promise((resolve) =>\n      target.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Yields control to the event loop immediately.\n   *\n   * Uses `setImmediate` if available, falls back to `queueMicrotask`, and then to `setTimeout(0)`.\n   *\n   * @returns A Promise that resolves immediately after yielding control to the event loop.\n   *\n   * @example\n   * ```typescript\n   * await delay.immediate();\n   * ```\n   */\n  immediate: (): Promise<void> => {\n    if (typeof setImmediate !== 'function') {\n      if (typeof queueMicrotask === 'function') {\n        return delay.nextMicrotask();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => setImmediate(resolve));\n  },\n\n  /**\n   * Delays execution until the next microtask queue is empty\n   *\n   * @returns A Promise that resolves when the next microtask queue is empty.\n   *\n   * @example\n   * ```typescript\n   * await delay.nextMicrotask();\n   * ```\n   */\n  nextMicrotask: (): Promise<void> => {\n    if (typeof queueMicrotask !== 'function') {\n      if (typeof setImmediate === 'function') {\n        return delay.immediate();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => queueMicrotask(resolve));\n  },\n} as const;\n", "import {globalScope} from '@alwatr/global-scope';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const win = globalScope as DictionaryOpt<any>;\n\n// prettier-ignore\nconst requestAnimationFrameFallback =\n  (callback: FrameRequestCallback): ReturnType<typeof setTimeout> =>\n    setTimeout(() => callback(Date.now()), 1000 / 60);\n\n// prettier-ignore\nexport const requestAnimationFrame: typeof globalScope.requestAnimationFrame =\n  win.requestAnimationFrame ||\n  win.webkitRequestAnimationFrame ||\n  win.mozRequestAnimationFrame ||\n  requestAnimationFrameFallback;\n\n// prettier-ignore\nconst requestIdleCallbackFallback =\n  (callback: () => void, options?: IdleRequestOptions): ReturnType<typeof setTimeout> =>\n    setTimeout(callback, options?.timeout ?? 2000);\n\n// prettier-ignore\nexport const requestIdleCallback: typeof globalScope.requestIdleCallback =\n  win.requestIdleCallback ||\n  win.webkitRequestIdleCallback ||\n  win.mozRequestIdleCallback ||\n  requestIdleCallbackFallback;\n"],
-  "mappings": ";yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,WAAAE,IAAA,eAAAC,EAAAH,GCAA,IAAAI,EAA0B,gCAGbC,EAAM,cAGbC,EACHC,GACC,WAAW,IAAMA,EAAS,KAAK,IAAI,CAAC,EAAG,IAAO,EAAE,EAGvCC,EACXH,EAAI,uBACJA,EAAI,6BACJA,EAAI,0BACJC,EAGIG,EACJ,CAACF,EAAsBG,IACrB,WAAWH,EAAUG,GAAS,SAAW,GAAI,EAGpCC,EACXN,EAAI,qBACJA,EAAI,2BACJA,EAAI,wBACJI,ED3BF,IAAAG,EAA4B,kCAC5BC,EAA2C,kCAE3C,gBAAc,IAAI,gBAAkB,OAAmB,EAOhD,IAAMC,EAAQ,CAYnB,GAAKC,GACH,IAAI,QAASC,GAAY,WAAWA,KAAS,iBAAcD,CAAQ,CAAC,CAAC,EAYvE,wBAAyB,IACvB,IAAI,QAASC,GAAYC,EAAsBD,CAAO,CAAC,EAazD,UAAYE,GACV,IAAI,QAASF,GAAYG,EAAoBH,EAASE,IAAY,OAAY,OAAY,CACxF,WAAS,iBAAcA,CAAO,CAChC,CAAC,CAAC,EAeJ,cAAe,CACbE,EACAC,IAEA,IAAI,QAASL,GACXI,EAAQ,iBAAiBC,EAAWL,EAAS,CAAE,KAAM,GAAM,QAAS,EAAK,CAAC,CAC5E,EAeF,WAAY,CAACM,EAA6BD,IACxC,IAAI,QAASL,GACXM,EAAO,iBAAiBD,EAAWL,EAAS,CAAE,KAAM,GAAM,QAAS,EAAK,CAAC,CAC3E,EAcF,UAAW,IACL,OAAO,cAAiB,WACtB,OAAO,gBAAmB,WACrBF,EAAM,cAAc,EAItBA,EAAM,GAAG,CAAC,EAEZ,IAAI,QAASE,GAAY,aAAaA,CAAO,CAAC,EAavD,cAAe,IACT,OAAO,gBAAmB,WACxB,OAAO,cAAiB,WACnBF,EAAM,UAAU,EAIlBA,EAAM,GAAG,CAAC,EAEZ,IAAI,QAASE,GAAY,eAAeA,CAAO,CAAC,CAE3D",
-  "names": ["main_exports", "__export", "delay", "__toCommonJS", "import_global_scope", "win", "requestAnimationFrameFallback", "callback", "requestAnimationFrame", "requestIdleCallbackFallback", "options", "requestIdleCallback", "import_package_tracer", "import_parse_duration", "delay", "duration", "resolve", "requestAnimationFrame", "timeout", "requestIdleCallback", "element", "eventName", "target"]
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA4B;AAC5B,4BAA2C;;;ACD3C,0BAA0B;AAGnB,IAAM,MAAM;AAGnB,IAAM,gCACJ,CAAC,aACC,WAAW,MAAM,SAAS,KAAK,IAAI,CAAC,GAAG,MAAO,EAAE;AAG7C,IAAM,wBACX,IAAI,yBACJ,IAAI,+BACJ,IAAI,4BACJ;AAGF,IAAM,8BACJ,CAAC,UAAsB,YACrB,WAAW,UAAU,SAAS,WAAW,GAAI;AAG1C,IAAM,sBACX,IAAI,uBACJ,IAAI,6BACJ,IAAI,0BACJ;;;ADxBF,oCAAc,IAAI,iBAAkB,OAAmB;AAOhD,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYnB,IAAI,CAAC,aACH,IAAI,QAAQ,CAAC,YAAY,WAAW,aAAS,qCAAc,QAAQ,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYvE,yBAAyB,MACvB,IAAI,QAAQ,CAAC,YAAY,sBAAsB,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAazD,WAAW,CAAC,YACV,IAAI,QAAQ,CAAC,YAAY,oBAAoB,SAAS,YAAY,SAAY,SAAY;AAAA,IACxF,aAAS,qCAAc,OAAO;AAAA,EAChC,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeJ,eAAe,CACb,SACA,cAEA,IAAI;AAAA,IAAQ,CAAC,YACX,QAAQ,iBAAiB,WAAW,SAAS,EAAE,MAAM,MAAM,SAAS,KAAK,CAAC;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeF,YAAY,CAAC,QAA6B,cACxC,IAAI;AAAA,IAAQ,CAAC,YACX,OAAO,iBAAiB,WAAW,SAAS,EAAE,MAAM,MAAM,SAAS,KAAK,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcF,WAAW,MAAqB;AAC9B,QAAI,OAAO,iBAAiB,YAAY;AACtC,UAAI,OAAO,mBAAmB,YAAY;AACxC,eAAO,MAAM,cAAc;AAAA,MAC7B;AAGA,aAAO,MAAM,GAAG,CAAC;AAAA,IACnB;AACA,WAAO,IAAI,QAAQ,CAAC,YAAY,aAAa,OAAO,CAAC;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,eAAe,MAAqB;AAClC,QAAI,OAAO,mBAAmB,YAAY;AACxC,UAAI,OAAO,iBAAiB,YAAY;AACtC,eAAO,MAAM,UAAU;AAAA,MACzB;AAGA,aAAO,MAAM,GAAG,CAAC;AAAA,IACnB;AACA,WAAO,IAAI,QAAQ,CAAC,YAAY,eAAe,OAAO,CAAC;AAAA,EACzD;AACF;",
+  "names": []
 }

package/dist/main.mjs

@@ -1,3 +1,132 @@
-/* @alwatr/delay v1.0.1 */
-import{globalScope as m}from"@alwatr/global-scope";var i=m,u=e=>setTimeout(()=>e(Date.now()),1e3/60),r=i.requestAnimationFrame||i.webkitRequestAnimationFrame||i.mozRequestAnimationFrame||u,l=(e,t)=>setTimeout(e,t?.timeout??2e3),a=i.requestIdleCallback||i.webkitRequestIdleCallback||i.mozRequestIdleCallback||l;import{packageTracer as c}from"@alwatr/package-tracer";import{parseDuration as s}from"@alwatr/parse-duration";c.add("@alwatr/delay","1.0.1");var o={by:e=>new Promise(t=>setTimeout(t,s(e))),untilNextAnimationFrame:()=>new Promise(e=>r(e)),untilIdle:e=>new Promise(t=>a(t,e===void 0?void 0:{timeout:s(e)})),untilDomEvent:(e,t)=>new Promise(n=>e.addEventListener(t,n,{once:!0,passive:!0})),untilEvent:(e,t)=>new Promise(n=>e.addEventListener(t,n,{once:!0,passive:!0})),immediate:()=>typeof setImmediate!="function"?typeof queueMicrotask=="function"?o.nextMicrotask():o.by(0):new Promise(e=>setImmediate(e)),nextMicrotask:()=>typeof queueMicrotask!="function"?typeof setImmediate=="function"?o.immediate():o.by(0):new Promise(e=>queueMicrotask(e))};export{o as delay};
+/* @alwatr/delay v1.0.3 */
+
+// src/main.ts
+import { packageTracer } from "@alwatr/package-tracer";
+import { parseDuration } from "@alwatr/parse-duration";
+
+// src/polyfill.ts
+import { globalScope } from "@alwatr/global-scope";
+var win = globalScope;
+var requestAnimationFrameFallback = (callback) => setTimeout(() => callback(Date.now()), 1e3 / 60);
+var requestAnimationFrame = win.requestAnimationFrame || win.webkitRequestAnimationFrame || win.mozRequestAnimationFrame || requestAnimationFrameFallback;
+var requestIdleCallbackFallback = (callback, options) => setTimeout(callback, options?.timeout ?? 2e3);
+var requestIdleCallback = win.requestIdleCallback || win.webkitRequestIdleCallback || win.mozRequestIdleCallback || requestIdleCallbackFallback;
+
+// src/main.ts
+packageTracer.add("@alwatr/delay", "1.0.3");
+var delay = {
+  /**
+   * Delays execution for a specified duration (in milliseconds).
+   *
+   * @param duration - The duration to wait (in milliseconds). Use `0` to yield control to the event loop.
+   * @returns A Promise that resolves after the specified duration.
+   *
+   * @example
+   * ```typescript
+   * await delay.by('1m'); // Wait for 1 minute
+   * ```
+   */
+  by: (duration) => new Promise((resolve) => setTimeout(resolve, parseDuration(duration))),
+  /**
+   * Delays execution until the next animation frame.
+   *
+   * @returns A Promise that resolves with the current timestamp when the next animation frame is fired.
+   *
+   * @example
+   * ```typescript
+   * const timestamp = await delay.untilNextAnimationFrame();
+   * ```
+   */
+  untilNextAnimationFrame: () => new Promise((resolve) => requestAnimationFrame(resolve)),
+  /**
+   * Delays execution until the browser's idle period or the specified timeout.
+   *
+   * @param timeout - Optional timeout (in milliseconds) for the idle callback.
+   * @returns A Promise that resolves with the IdleDeadline object when the browser is idle or the timeout is reached.
+   *
+   * @example
+   * ```typescript
+   * const deadline = await delay.untilIdle();
+   * ```
+   */
+  untilIdle: (timeout) => new Promise((resolve) => requestIdleCallback(resolve, timeout === void 0 ? void 0 : {
+    timeout: parseDuration(timeout)
+  })),
+  /**
+   * Delays execution until a specific DOM event occurs on an HTMLElement.
+   *
+   * @param element - The HTMLElement to listen for the event on.
+   * @param eventName - The name of the DOM event to wait for.
+   * @template T The event map type.
+   * @returns A Promise that resolves with the event object when the specified event occurs.
+   *
+   * @example
+   * ```typescript
+   * const clickEvent = await delay.untilDomEvent(document.body, 'click');
+   * ```
+   */
+  untilDomEvent: (element, eventName) => new Promise(
+    (resolve) => element.addEventListener(eventName, resolve, { once: true, passive: true })
+  ),
+  /**
+   * Delays execution until a specific event occurs on an object with an `addEventListener` method.
+   *
+   * @param target - The target object to listen for the event on.
+   * @param eventName - The name of the event to wait for.
+   * @returns A Promise that resolves with the event object when the specified event occurs.
+   *
+   * @example
+   * ```typescript
+   * const server = http.createServer();
+   * const requestEvent = await delay.untilEvent(server, 'request');
+   * ```
+   */
+  untilEvent: (target, eventName) => new Promise(
+    (resolve) => target.addEventListener(eventName, resolve, { once: true, passive: true })
+  ),
+  /**
+   * Yields control to the event loop immediately.
+   *
+   * Uses `setImmediate` if available, falls back to `queueMicrotask`, and then to `setTimeout(0)`.
+   *
+   * @returns A Promise that resolves immediately after yielding control to the event loop.
+   *
+   * @example
+   * ```typescript
+   * await delay.immediate();
+   * ```
+   */
+  immediate: () => {
+    if (typeof setImmediate !== "function") {
+      if (typeof queueMicrotask === "function") {
+        return delay.nextMicrotask();
+      }
+      return delay.by(0);
+    }
+    return new Promise((resolve) => setImmediate(resolve));
+  },
+  /**
+   * Delays execution until the next microtask queue is empty
+   *
+   * @returns A Promise that resolves when the next microtask queue is empty.
+   *
+   * @example
+   * ```typescript
+   * await delay.nextMicrotask();
+   * ```
+   */
+  nextMicrotask: () => {
+    if (typeof queueMicrotask !== "function") {
+      if (typeof setImmediate === "function") {
+        return delay.immediate();
+      }
+      return delay.by(0);
+    }
+    return new Promise((resolve) => queueMicrotask(resolve));
+  }
+};
+export {
+  delay
+};
+/*! For license information please see main.mjs.LEGAL.txt */
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/polyfill.ts", "../src/main.ts"],
-  "sourcesContent": ["import {globalScope} from '@alwatr/global-scope';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const win = globalScope as DictionaryOpt<any>;\n\n// prettier-ignore\nconst requestAnimationFrameFallback =\n  (callback: FrameRequestCallback): ReturnType<typeof setTimeout> =>\n    setTimeout(() => callback(Date.now()), 1000 / 60);\n\n// prettier-ignore\nexport const requestAnimationFrame: typeof globalScope.requestAnimationFrame =\n  win.requestAnimationFrame ||\n  win.webkitRequestAnimationFrame ||\n  win.mozRequestAnimationFrame ||\n  requestAnimationFrameFallback;\n\n// prettier-ignore\nconst requestIdleCallbackFallback =\n  (callback: () => void, options?: IdleRequestOptions): ReturnType<typeof setTimeout> =>\n    setTimeout(callback, options?.timeout ?? 2000);\n\n// prettier-ignore\nexport const requestIdleCallback: typeof globalScope.requestIdleCallback =\n  win.requestIdleCallback ||\n  win.webkitRequestIdleCallback ||\n  win.mozRequestIdleCallback ||\n  requestIdleCallbackFallback;\n", "import {packageTracer} from '@alwatr/package-tracer';\nimport {parseDuration, type Duration} from '@alwatr/parse-duration';\n\npackageTracer.add(__package_name__, __package_version__);\n\nimport {requestAnimationFrame, requestIdleCallback} from './polyfill.js';\n\n/**\n * A utility module to help manage asynchronous operations and waiting for events or timeouts.\n */\nexport const delay = {\n  /**\n   * Delays execution for a specified duration (in milliseconds).\n   *\n   * @param duration - The duration to wait (in milliseconds). Use `0` to yield control to the event loop.\n   * @returns A Promise that resolves after the specified duration.\n   *\n   * @example\n   * ```typescript\n   * await delay.by('1m'); // Wait for 1 minute\n   * ```\n   */\n  by: (duration: Duration): Promise<void> =>\n    new Promise((resolve) => setTimeout(resolve, parseDuration(duration))),\n\n  /**\n   * Delays execution until the next animation frame.\n   *\n   * @returns A Promise that resolves with the current timestamp when the next animation frame is fired.\n   *\n   * @example\n   * ```typescript\n   * const timestamp = await delay.untilNextAnimationFrame();\n   * ```\n   */\n  untilNextAnimationFrame: (): Promise<DOMHighResTimeStamp> =>\n    new Promise((resolve) => requestAnimationFrame(resolve)),\n\n  /**\n   * Delays execution until the browser's idle period or the specified timeout.\n   *\n   * @param timeout - Optional timeout (in milliseconds) for the idle callback.\n   * @returns A Promise that resolves with the IdleDeadline object when the browser is idle or the timeout is reached.\n   *\n   * @example\n   * ```typescript\n   * const deadline = await delay.untilIdle();\n   * ```\n   */\n  untilIdle: (timeout?: Duration): Promise<IdleDeadline> =>\n    new Promise((resolve) => requestIdleCallback(resolve, timeout === undefined ? undefined : {\n      timeout: parseDuration(timeout)\n    })),\n\n  /**\n   * Delays execution until a specific DOM event occurs on an HTMLElement.\n   *\n   * @param element - The HTMLElement to listen for the event on.\n   * @param eventName - The name of the DOM event to wait for.\n   * @template T The event map type.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const clickEvent = await delay.untilDomEvent(document.body, 'click');\n   * ```\n   */\n  untilDomEvent: <T extends keyof HTMLElementEventMap>(\n    element: HTMLElement,\n    eventName: T\n  ): Promise<HTMLElementEventMap[T]> =>\n    new Promise((resolve) =>\n      element.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Delays execution until a specific event occurs on an object with an `addEventListener` method.\n   *\n   * @param target - The target object to listen for the event on.\n   * @param eventName - The name of the event to wait for.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const server = http.createServer();\n   * const requestEvent = await delay.untilEvent(server, 'request');\n   * ```\n   */\n  untilEvent: (target: HasAddEventListener, eventName: string): Promise<Event> =>\n    new Promise((resolve) =>\n      target.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Yields control to the event loop immediately.\n   *\n   * Uses `setImmediate` if available, falls back to `queueMicrotask`, and then to `setTimeout(0)`.\n   *\n   * @returns A Promise that resolves immediately after yielding control to the event loop.\n   *\n   * @example\n   * ```typescript\n   * await delay.immediate();\n   * ```\n   */\n  immediate: (): Promise<void> => {\n    if (typeof setImmediate !== 'function') {\n      if (typeof queueMicrotask === 'function') {\n        return delay.nextMicrotask();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => setImmediate(resolve));\n  },\n\n  /**\n   * Delays execution until the next microtask queue is empty\n   *\n   * @returns A Promise that resolves when the next microtask queue is empty.\n   *\n   * @example\n   * ```typescript\n   * await delay.nextMicrotask();\n   * ```\n   */\n  nextMicrotask: (): Promise<void> => {\n    if (typeof queueMicrotask !== 'function') {\n      if (typeof setImmediate === 'function') {\n        return delay.immediate();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => queueMicrotask(resolve));\n  },\n} as const;\n"],
-  "mappings": ";AAAA,OAAQ,eAAAA,MAAkB,uBAGnB,IAAMC,EAAMD,EAGbE,EACHC,GACC,WAAW,IAAMA,EAAS,KAAK,IAAI,CAAC,EAAG,IAAO,EAAE,EAGvCC,EACXH,EAAI,uBACJA,EAAI,6BACJA,EAAI,0BACJC,EAGIG,EACJ,CAACF,EAAsBG,IACrB,WAAWH,EAAUG,GAAS,SAAW,GAAI,EAGpCC,EACXN,EAAI,qBACJA,EAAI,2BACJA,EAAI,wBACJI,EC3BF,OAAQ,iBAAAG,MAAoB,yBAC5B,OAAQ,iBAAAC,MAAmC,yBAE3CD,EAAc,IAAI,gBAAkB,OAAmB,EAOhD,IAAME,EAAQ,CAYnB,GAAKC,GACH,IAAI,QAASC,GAAY,WAAWA,EAASH,EAAcE,CAAQ,CAAC,CAAC,EAYvE,wBAAyB,IACvB,IAAI,QAASC,GAAYC,EAAsBD,CAAO,CAAC,EAazD,UAAYE,GACV,IAAI,QAASF,GAAYG,EAAoBH,EAASE,IAAY,OAAY,OAAY,CACxF,QAASL,EAAcK,CAAO,CAChC,CAAC,CAAC,EAeJ,cAAe,CACbE,EACAC,IAEA,IAAI,QAASL,GACXI,EAAQ,iBAAiBC,EAAWL,EAAS,CAAE,KAAM,GAAM,QAAS,EAAK,CAAC,CAC5E,EAeF,WAAY,CAACM,EAA6BD,IACxC,IAAI,QAASL,GACXM,EAAO,iBAAiBD,EAAWL,EAAS,CAAE,KAAM,GAAM,QAAS,EAAK,CAAC,CAC3E,EAcF,UAAW,IACL,OAAO,cAAiB,WACtB,OAAO,gBAAmB,WACrBF,EAAM,cAAc,EAItBA,EAAM,GAAG,CAAC,EAEZ,IAAI,QAASE,GAAY,aAAaA,CAAO,CAAC,EAavD,cAAe,IACT,OAAO,gBAAmB,WACxB,OAAO,cAAiB,WACnBF,EAAM,UAAU,EAIlBA,EAAM,GAAG,CAAC,EAEZ,IAAI,QAASE,GAAY,eAAeA,CAAO,CAAC,CAE3D",
-  "names": ["globalScope", "win", "requestAnimationFrameFallback", "callback", "requestAnimationFrame", "requestIdleCallbackFallback", "options", "requestIdleCallback", "packageTracer", "parseDuration", "delay", "duration", "resolve", "requestAnimationFrame", "timeout", "requestIdleCallback", "element", "eventName", "target"]
+  "sources": ["../src/main.ts", "../src/polyfill.ts"],
+  "sourcesContent": ["import {packageTracer} from '@alwatr/package-tracer';\nimport {parseDuration, type Duration} from '@alwatr/parse-duration';\n\npackageTracer.add(__package_name__, __package_version__);\n\nimport {requestAnimationFrame, requestIdleCallback} from './polyfill.js';\n\n/**\n * A utility module to help manage asynchronous operations and waiting for events or timeouts.\n */\nexport const delay = {\n  /**\n   * Delays execution for a specified duration (in milliseconds).\n   *\n   * @param duration - The duration to wait (in milliseconds). Use `0` to yield control to the event loop.\n   * @returns A Promise that resolves after the specified duration.\n   *\n   * @example\n   * ```typescript\n   * await delay.by('1m'); // Wait for 1 minute\n   * ```\n   */\n  by: (duration: Duration): Promise<void> =>\n    new Promise((resolve) => setTimeout(resolve, parseDuration(duration))),\n\n  /**\n   * Delays execution until the next animation frame.\n   *\n   * @returns A Promise that resolves with the current timestamp when the next animation frame is fired.\n   *\n   * @example\n   * ```typescript\n   * const timestamp = await delay.untilNextAnimationFrame();\n   * ```\n   */\n  untilNextAnimationFrame: (): Promise<DOMHighResTimeStamp> =>\n    new Promise((resolve) => requestAnimationFrame(resolve)),\n\n  /**\n   * Delays execution until the browser's idle period or the specified timeout.\n   *\n   * @param timeout - Optional timeout (in milliseconds) for the idle callback.\n   * @returns A Promise that resolves with the IdleDeadline object when the browser is idle or the timeout is reached.\n   *\n   * @example\n   * ```typescript\n   * const deadline = await delay.untilIdle();\n   * ```\n   */\n  untilIdle: (timeout?: Duration): Promise<IdleDeadline> =>\n    new Promise((resolve) => requestIdleCallback(resolve, timeout === undefined ? undefined : {\n      timeout: parseDuration(timeout)\n    })),\n\n  /**\n   * Delays execution until a specific DOM event occurs on an HTMLElement.\n   *\n   * @param element - The HTMLElement to listen for the event on.\n   * @param eventName - The name of the DOM event to wait for.\n   * @template T The event map type.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const clickEvent = await delay.untilDomEvent(document.body, 'click');\n   * ```\n   */\n  untilDomEvent: <T extends keyof HTMLElementEventMap>(\n    element: HTMLElement,\n    eventName: T\n  ): Promise<HTMLElementEventMap[T]> =>\n    new Promise((resolve) =>\n      element.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Delays execution until a specific event occurs on an object with an `addEventListener` method.\n   *\n   * @param target - The target object to listen for the event on.\n   * @param eventName - The name of the event to wait for.\n   * @returns A Promise that resolves with the event object when the specified event occurs.\n   *\n   * @example\n   * ```typescript\n   * const server = http.createServer();\n   * const requestEvent = await delay.untilEvent(server, 'request');\n   * ```\n   */\n  untilEvent: (target: HasAddEventListener, eventName: string): Promise<Event> =>\n    new Promise((resolve) =>\n      target.addEventListener(eventName, resolve, { once: true, passive: true })\n    ),\n\n  /**\n   * Yields control to the event loop immediately.\n   *\n   * Uses `setImmediate` if available, falls back to `queueMicrotask`, and then to `setTimeout(0)`.\n   *\n   * @returns A Promise that resolves immediately after yielding control to the event loop.\n   *\n   * @example\n   * ```typescript\n   * await delay.immediate();\n   * ```\n   */\n  immediate: (): Promise<void> => {\n    if (typeof setImmediate !== 'function') {\n      if (typeof queueMicrotask === 'function') {\n        return delay.nextMicrotask();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => setImmediate(resolve));\n  },\n\n  /**\n   * Delays execution until the next microtask queue is empty\n   *\n   * @returns A Promise that resolves when the next microtask queue is empty.\n   *\n   * @example\n   * ```typescript\n   * await delay.nextMicrotask();\n   * ```\n   */\n  nextMicrotask: (): Promise<void> => {\n    if (typeof queueMicrotask !== 'function') {\n      if (typeof setImmediate === 'function') {\n        return delay.immediate();\n      }\n\n      // else\n      return delay.by(0);\n    }\n    return new Promise((resolve) => queueMicrotask(resolve));\n  },\n} as const;\n", "import {globalScope} from '@alwatr/global-scope';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const win = globalScope as DictionaryOpt<any>;\n\n// prettier-ignore\nconst requestAnimationFrameFallback =\n  (callback: FrameRequestCallback): ReturnType<typeof setTimeout> =>\n    setTimeout(() => callback(Date.now()), 1000 / 60);\n\n// prettier-ignore\nexport const requestAnimationFrame: typeof globalScope.requestAnimationFrame =\n  win.requestAnimationFrame ||\n  win.webkitRequestAnimationFrame ||\n  win.mozRequestAnimationFrame ||\n  requestAnimationFrameFallback;\n\n// prettier-ignore\nconst requestIdleCallbackFallback =\n  (callback: () => void, options?: IdleRequestOptions): ReturnType<typeof setTimeout> =>\n    setTimeout(callback, options?.timeout ?? 2000);\n\n// prettier-ignore\nexport const requestIdleCallback: typeof globalScope.requestIdleCallback =\n  win.requestIdleCallback ||\n  win.webkitRequestIdleCallback ||\n  win.mozRequestIdleCallback ||\n  requestIdleCallbackFallback;\n"],
+  "mappings": ";;;AAAA,SAAQ,qBAAoB;AAC5B,SAAQ,qBAAmC;;;ACD3C,SAAQ,mBAAkB;AAGnB,IAAM,MAAM;AAGnB,IAAM,gCACJ,CAAC,aACC,WAAW,MAAM,SAAS,KAAK,IAAI,CAAC,GAAG,MAAO,EAAE;AAG7C,IAAM,wBACX,IAAI,yBACJ,IAAI,+BACJ,IAAI,4BACJ;AAGF,IAAM,8BACJ,CAAC,UAAsB,YACrB,WAAW,UAAU,SAAS,WAAW,GAAI;AAG1C,IAAM,sBACX,IAAI,uBACJ,IAAI,6BACJ,IAAI,0BACJ;;;ADxBF,cAAc,IAAI,iBAAkB,OAAmB;AAOhD,IAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYnB,IAAI,CAAC,aACH,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,cAAc,QAAQ,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYvE,yBAAyB,MACvB,IAAI,QAAQ,CAAC,YAAY,sBAAsB,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAazD,WAAW,CAAC,YACV,IAAI,QAAQ,CAAC,YAAY,oBAAoB,SAAS,YAAY,SAAY,SAAY;AAAA,IACxF,SAAS,cAAc,OAAO;AAAA,EAChC,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeJ,eAAe,CACb,SACA,cAEA,IAAI;AAAA,IAAQ,CAAC,YACX,QAAQ,iBAAiB,WAAW,SAAS,EAAE,MAAM,MAAM,SAAS,KAAK,CAAC;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeF,YAAY,CAAC,QAA6B,cACxC,IAAI;AAAA,IAAQ,CAAC,YACX,OAAO,iBAAiB,WAAW,SAAS,EAAE,MAAM,MAAM,SAAS,KAAK,CAAC;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcF,WAAW,MAAqB;AAC9B,QAAI,OAAO,iBAAiB,YAAY;AACtC,UAAI,OAAO,mBAAmB,YAAY;AACxC,eAAO,MAAM,cAAc;AAAA,MAC7B;AAGA,aAAO,MAAM,GAAG,CAAC;AAAA,IACnB;AACA,WAAO,IAAI,QAAQ,CAAC,YAAY,aAAa,OAAO,CAAC;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,eAAe,MAAqB;AAClC,QAAI,OAAO,mBAAmB,YAAY;AACxC,UAAI,OAAO,iBAAiB,YAAY;AACtC,eAAO,MAAM,UAAU;AAAA,MACzB;AAGA,aAAO,MAAM,GAAG,CAAC;AAAA,IACnB;AACA,WAAO,IAAI,QAAQ,CAAC,YAAY,eAAe,OAAO,CAAC;AAAA,EACzD;AACF;",
+  "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alwatr/delay",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Comprehensive toolkit for managing asynchronous operations.",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "keywords": [
@@ -66,17 +66,17 @@
     "clean": "rm -rfv dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@alwatr/global-scope": "^1.1.23",
-    "@alwatr/package-tracer": "^1.0.1",
-    "@alwatr/parse-duration": "^1.1.1"
+    "@alwatr/global-scope": "^1.1.25",
+    "@alwatr/package-tracer": "^1.0.3",
+    "@alwatr/parse-duration": "^1.1.3"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^1.5.0",
+    "@alwatr/nano-build": "^2.0.0",
     "@alwatr/prettier-config": "^1.0.5",
-    "@alwatr/tsconfig-base": "^1.3.0",
-    "@alwatr/type-helper": "^2.0.0",
-    "@types/node": "^22.7.4",
-    "typescript": "^5.6.2"
+    "@alwatr/tsconfig-base": "^1.3.1",
+    "@alwatr/type-helper": "^2.0.1",
+    "@types/node": "^22.7.5",
+    "typescript": "^5.6.3"
   },
-  "gitHead": "41bd9f5a9ffe1f7306b24e63684b1895428f44b0"
+  "gitHead": "e0b3b4a47c02a395046982803b2e431c6ee3b0ab"
 }