@rzl-zone/utils-js 3.0.2-beta.2 → 3.1.0

package/dist/promise/index.cjs

@@ -1 +1 @@
-'use strict';var chunkCEFYHEM4_cjs=require('../chunk-CEFYHEM4.cjs');require('../chunk-PUQXRLZH.cjs'),require('../chunk-U5Y2FXMN.cjs'),require('../chunk-7YWAQOA4.cjs'),require('../chunk-CN53M4QZ.cjs');Object.defineProperty(exports,"delay",{enumerable:true,get:function(){return chunkCEFYHEM4_cjs.a}});
+"use strict";var e=require("../chunk-7U44T63D.cjs");require("../chunk-DVMHRLKP.cjs"),require("../chunk-E63WVPZE.cjs"),require("../chunk-UDA26MCU.cjs"),require("../chunk-INUFZJLX.cjs"),Object.defineProperty(exports,"delay",{enumerable:!0,get:function(){return e.delay}});

package/dist/promise/index.d.ts

@@ -1,40 +1,31 @@
 /** ------------------------------------------------------------
-* * ***Creates a delay for a specified duration.***
-* ------------------------------------------------------------
-*
-* Creates a Promise-based delay that resolves after a given number
-* of milliseconds. Optionally supports cancellation with `AbortSignal`.
-*
-* - ✅ Validates `milliSeconds` is a non-zero, non-negative integer.
-* - ✅ Validates `signal` is an `AbortSignal` instance when provided.
-* - ✅ Cleans up event listeners and timers properly.
-*
-* @param {number} [milliSeconds=1000]
-* The duration of the delay in milliseconds.
-* Default is `1000`.
-*
-* @param {AbortSignal} [signal]
-* An optional `AbortSignal` that can cancel the delay.
-*
-* @returns {Promise<void>}
-* A promise that resolves after the specified delay
-* or rejects with an `AbortError` if aborted.
-*
-* @throws {TypeError}
-* If `milliSeconds` is not a valid non-zero, non-negative integer.
-* If `signal` is not a valid `AbortSignal`.
-*
-* @throws {DOMException}
-* If the delay is aborted using the signal, rejects with `"AbortError"`.
-*
-* @example
-* // Waits for 2 seconds
-* await delay(2000);
-*
-* @example
-* // Delay with AbortSignal
-* const controller = new AbortController();
-* delay(5000, controller.signal).catch(err => console.log(err.name)); // "AbortError"
-* controller.abort();
-*/
+ * * ***Utility: `delay`.***
+ * ------------------------------------------------------------
+ * **Creates a Promise-based delay that resolves after a given number
+ * of milliseconds, optionally supports cancellation with `AbortSignal`.**
+ * - **Behavior:**
+ *    - Validates `milliSeconds` is a non-zero, non-negative integer.
+ *    - Validates `signal` is an `AbortSignal` instance when provided.
+ *    - Cleans up event listeners and timers properly.
+ * @param {number} [milliSeconds=1000]
+ *  The duration of the delay in milliseconds, default is `1000`.
+ * @param {AbortSignal} [signal]
+ *  An optional `AbortSignal` that can cancel the delay.
+ * @returns {Promise<void>}
+ *  A promise that resolves after the specified delay or
+ *  rejects with an `AbortError` if aborted.
+ * @throws {TypeError} Validates `milliSeconds` and `signal`:
+ *  - If `milliSeconds` **is not a valid** an `integer-number`, `NaN`, `negative-number`, or `≤ 0`.
+ *  - If `signal` **is not a valid** an`AbortSignal`.
+ * @throws {DOMException}
+ * If the delay is aborted using the signal, rejects with `"AbortError"`.
+ * @example
+ * // Waits for 2 seconds
+ * await delay(2000);
+ *
+ * // Delay with AbortSignal
+ * const controller = new AbortController();
+ * delay(5000, controller.signal).catch(err => console.log(err.name)); // "AbortError"
+ * controller.abort();
+ */
 declare const delay:(milliSeconds?:number,signal?:AbortSignal)=>Promise<void>;export{delay};

package/dist/promise/index.js

@@ -1 +1 @@
-export{a as delay}from'../chunk-E5NUI7PN.js';import'../chunk-ELDDNERR.js';import'../chunk-MNGGDB2G.js';import'../chunk-5SZUSNGZ.js';import'../chunk-XCFIOTCV.js';
+export{delay}from"../chunk-IREHUBF7.js";import"../chunk-WVSPXFTY.js";import"../chunk-AJ65QFV2.js";import"../chunk-QNKGP5DY.js";import"../chunk-2UIRWYE3.js";