umt 2.16.0 → 2.17.0

package/module/es5/Async/debounceAsync.js

@@ -0,0 +1,103 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.debounceAsync = void 0;
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * Creates a debounced async function. Subsequent calls within `wait` ms reset
+ * the timer and share a single resolution; the latest arguments win.
+ *
+ * @template A - Argument tuple type
+ * @template R - Resolved value type
+ * @param {(...args: A) => Promise<R>} function_ - Async function to debounce
+ * @param {number} wait - Debounce window in milliseconds
+ * @returns {DebouncedAsyncFunction<A, R>} Debounced wrapper with cancel support
+ * @example
+ * const search = debounceAsync(query, 300);
+ * await search("foo");
+ */
+var debounceAsync = exports.debounceAsync = function debounceAsync(function_, wait) {
+  var timer;
+  var pendingResolvers = [];
+  var pendingRejecters = [];
+  var flushPromises = function flushPromises() {
+    var resolvers = pendingResolvers;
+    var rejecters = pendingRejecters;
+    pendingResolvers = [];
+    pendingRejecters = [];
+    return {
+      resolvers: resolvers,
+      rejecters: rejecters
+    };
+  };
+  var debounced = function debounced() {
+    for (var _len = arguments.length, arguments_ = new Array(_len), _key = 0; _key < _len; _key++) {
+      arguments_[_key] = arguments[_key];
+    }
+    if (timer) {
+      clearTimeout(timer);
+    }
+    return new Promise(function (resolve, reject) {
+      pendingResolvers.push(resolve);
+      pendingRejecters.push(reject);
+      timer = setTimeout(function () {
+        timer = undefined;
+        var _flushPromises = flushPromises(),
+          resolvers = _flushPromises.resolvers,
+          rejecters = _flushPromises.rejecters;
+        function_.apply(void 0, arguments_).then(function (value) {
+          var _iterator = _createForOfIteratorHelper(resolvers),
+            _step;
+          try {
+            for (_iterator.s(); !(_step = _iterator.n()).done;) {
+              var resolver = _step.value;
+              resolver(value);
+            }
+          } catch (err) {
+            _iterator.e(err);
+          } finally {
+            _iterator.f();
+          }
+        }, function (error) {
+          var _iterator2 = _createForOfIteratorHelper(rejecters),
+            _step2;
+          try {
+            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+              var rejecter = _step2.value;
+              rejecter(error);
+            }
+          } catch (err) {
+            _iterator2.e(err);
+          } finally {
+            _iterator2.f();
+          }
+        });
+      }, wait);
+    });
+  };
+  debounced.cancel = function () {
+    if (timer) {
+      clearTimeout(timer);
+      timer = undefined;
+    }
+    var _flushPromises2 = flushPromises(),
+      rejecters = _flushPromises2.rejecters;
+    var _iterator3 = _createForOfIteratorHelper(rejecters),
+      _step3;
+    try {
+      for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+        var rejecter = _step3.value;
+        rejecter(new Error("debounceAsync cancelled"));
+      }
+    } catch (err) {
+      _iterator3.e(err);
+    } finally {
+      _iterator3.f();
+    }
+  };
+  return debounced;
+};

package/module/es5/Async/index.d.ts

@@ -1,4 +1,9 @@
+export * from "./debounceAsync";
 export * from "./defer";
 export * from "./parallel";
+export * from "./pSettled";
+export * from "./retry";
 export * from "./sleep";
+export * from "./throttleAsync";
 export * from "./timeout";
+export * from "./waitFor";

package/module/es5/Async/index.js

@@ -3,6 +3,17 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _debounceAsync = require("./debounceAsync");
+Object.keys(_debounceAsync).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _debounceAsync[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _debounceAsync[key];
+    }
+  });
+});
 var _defer = require("./defer");
 Object.keys(_defer).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -25,6 +36,28 @@ Object.keys(_parallel).forEach(function (key) {
     }
   });
 });
+var _pSettled = require("./pSettled");
+Object.keys(_pSettled).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _pSettled[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _pSettled[key];
+    }
+  });
+});
+var _retry = require("./retry");
+Object.keys(_retry).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _retry[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _retry[key];
+    }
+  });
+});
 var _sleep = require("./sleep");
 Object.keys(_sleep).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -36,6 +69,17 @@ Object.keys(_sleep).forEach(function (key) {
     }
   });
 });
+var _throttleAsync = require("./throttleAsync");
+Object.keys(_throttleAsync).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _throttleAsync[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _throttleAsync[key];
+    }
+  });
+});
 var _timeout = require("./timeout");
 Object.keys(_timeout).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -46,4 +90,15 @@ Object.keys(_timeout).forEach(function (key) {
       return _timeout[key];
     }
   });
+});
+var _waitFor = require("./waitFor");
+Object.keys(_waitFor).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _waitFor[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _waitFor[key];
+    }
+  });
 });

package/module/es5/Async/pSettled.d.ts

@@ -0,0 +1,19 @@
+export type SettledResult<T> = {
+    status: "fulfilled";
+    value: T;
+} | {
+    status: "rejected";
+    reason: unknown;
+};
+/**
+ * Awaits all promises and returns their settled results, with an optional
+ * concurrency limit applied during execution.
+ *
+ * @template T - Resolved value type
+ * @param {Iterable<Promise<T> | (() => Promise<T>)>} tasks - Promises or thunks
+ * @param {number} [limit] - Maximum concurrent in-flight tasks; unlimited when omitted
+ * @returns {Promise<SettledResult<T>[]>} Settled results in input order
+ * @example
+ * await pSettled([Promise.resolve(1), Promise.reject(new Error("x"))]);
+ */
+export declare const pSettled: <T>(tasks: Iterable<Promise<T> | (() => Promise<T>)>, limit?: number) => Promise<SettledResult<T>[]>;

package/module/es5/Async/pSettled.js

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.pSettled = void 0;
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * Awaits all promises and returns their settled results, with an optional
+ * concurrency limit applied during execution.
+ *
+ * @template T - Resolved value type
+ * @param {Iterable<Promise<T> | (() => Promise<T>)>} tasks - Promises or thunks
+ * @param {number} [limit] - Maximum concurrent in-flight tasks; unlimited when omitted
+ * @returns {Promise<SettledResult<T>[]>} Settled results in input order
+ * @example
+ * await pSettled([Promise.resolve(1), Promise.reject(new Error("x"))]);
+ */
+var pSettled = exports.pSettled = function pSettled(tasks, limit) {
+  var items = _toConsumableArray(tasks);
+  var results = Array.from({
+    length: items.length
+  });
+  if (items.length === 0) {
+    return Promise.resolve(results);
+  }
+  var effectiveLimit = limit && limit > 0 ? limit : items.length;
+  var nextIndex = 0;
+  var resolvedCount = 0;
+  return new Promise(function (resolve) {
+    var _runNext = function runNext() {
+      if (nextIndex >= items.length) {
+        return;
+      }
+      var currentIndex = nextIndex;
+      nextIndex += 1;
+      var task = items[currentIndex];
+      var promise = typeof task === "function" ? Promise.resolve().then(task) : Promise.resolve(task);
+      promise.then(function (value) {
+        results[currentIndex] = {
+          status: "fulfilled",
+          value: value
+        };
+      }, function (error) {
+        results[currentIndex] = {
+          status: "rejected",
+          reason: error
+        };
+      }).then(function () {
+        resolvedCount += 1;
+        if (resolvedCount === items.length) {
+          resolve(results);
+        } else {
+          _runNext();
+        }
+      });
+    };
+    var initialBatch = Math.min(effectiveLimit, items.length);
+    for (var index = 0; index < initialBatch; index += 1) {
+      _runNext();
+    }
+  });
+};

package/module/es5/Async/retry.d.ts

@@ -0,0 +1,22 @@
+export interface RetryOptions {
+    retries?: number;
+    delay?: number;
+    backoff?: "fixed" | "exponential" | "linear";
+    jitter?: boolean;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    onRetry?: (error: unknown, attempt: number) => void;
+    signal?: AbortSignal;
+}
+/**
+ * Retries an async function until it succeeds or the retry budget is exhausted.
+ * Supports fixed, linear, or exponential backoff, optional jitter, and
+ * AbortSignal cancellation.
+ *
+ * @template T - Return type of the function
+ * @param {() => Promise<T>} function_ - The async function to invoke
+ * @param {RetryOptions} [options] - Retry configuration
+ * @returns {Promise<T>} Result of the first successful invocation
+ * @example
+ * await retry(() => fetch("/api"), { retries: 5, backoff: "exponential", jitter: true });
+ */
+export declare const retry: <T>(function_: () => Promise<T>, options?: RetryOptions) => Promise<T>;

package/module/es5/Async/retry.js

@@ -0,0 +1,106 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.retry = void 0;
+var _sleep = require("./sleep");
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+var computeDelay = function computeDelay(baseDelay, attemptNumber, backoff, jitter) {
+  var waitMs = baseDelay;
+  if (backoff === "linear") {
+    waitMs = baseDelay * attemptNumber;
+  } else if (backoff === "exponential") {
+    waitMs = baseDelay * Math.pow(2, attemptNumber - 1);
+  }
+  if (jitter) {
+    waitMs *= Math.random();
+  }
+  return waitMs;
+};
+
+/**
+ * Retries an async function until it succeeds or the retry budget is exhausted.
+ * Supports fixed, linear, or exponential backoff, optional jitter, and
+ * AbortSignal cancellation.
+ *
+ * @template T - Return type of the function
+ * @param {() => Promise<T>} function_ - The async function to invoke
+ * @param {RetryOptions} [options] - Retry configuration
+ * @returns {Promise<T>} Result of the first successful invocation
+ * @example
+ * await retry(() => fetch("/api"), { retries: 5, backoff: "exponential", jitter: true });
+ */
+var retry = exports.retry = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(function_) {
+    var options,
+      _options$retries,
+      retries,
+      _options$delay,
+      delay,
+      _options$backoff,
+      backoff,
+      _options$jitter,
+      jitter,
+      _options$shouldRetry,
+      shouldRetry,
+      onRetry,
+      signal,
+      attemptNumber,
+      _signal$reason,
+      remaining,
+      _args = arguments,
+      _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          options = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
+          _options$retries = options.retries, retries = _options$retries === void 0 ? 3 : _options$retries, _options$delay = options.delay, delay = _options$delay === void 0 ? 1000 : _options$delay, _options$backoff = options.backoff, backoff = _options$backoff === void 0 ? "fixed" : _options$backoff, _options$jitter = options.jitter, jitter = _options$jitter === void 0 ? false : _options$jitter, _options$shouldRetry = options.shouldRetry, shouldRetry = _options$shouldRetry === void 0 ? function () {
+            return true;
+          } : _options$shouldRetry, onRetry = options.onRetry, signal = options.signal;
+          attemptNumber = 0;
+        case 1:
+          if (!true) {
+            _context.n = 7;
+            break;
+          }
+          if (!(signal !== null && signal !== void 0 && signal.aborted)) {
+            _context.n = 2;
+            break;
+          }
+          throw (_signal$reason = signal.reason) !== null && _signal$reason !== void 0 ? _signal$reason : new Error("Aborted");
+        case 2:
+          _context.p = 2;
+          _context.n = 3;
+          return function_();
+        case 3:
+          return _context.a(2, _context.v);
+        case 4:
+          _context.p = 4;
+          _t = _context.v;
+          remaining = retries - attemptNumber;
+          if (!(remaining <= 0 || !shouldRetry(_t, attemptNumber))) {
+            _context.n = 5;
+            break;
+          }
+          throw _t;
+        case 5:
+          onRetry === null || onRetry === void 0 || onRetry(_t, attemptNumber);
+          _context.n = 6;
+          return (0, _sleep.sleep)(computeDelay(delay, attemptNumber + 1, backoff, jitter));
+        case 6:
+          attemptNumber += 1;
+          _context.n = 1;
+          break;
+        case 7:
+          return _context.a(2);
+      }
+    }, _callee, null, [[2, 4]]);
+  }));
+  return function retry(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

package/module/es5/Async/throttleAsync.d.ts

@@ -0,0 +1,18 @@
+export interface ThrottledAsyncFunction<A extends unknown[], R> {
+    (...arguments_: A): Promise<R>;
+    cancel: () => void;
+}
+/**
+ * Creates a throttled async function. Coalesces concurrent calls within the
+ * `wait` window so only one underlying invocation runs; all callers in the
+ * window receive the same result.
+ *
+ * @template A - Argument tuple type
+ * @template R - Resolved value type
+ * @param {(...args: A) => Promise<R>} function_ - Async function to throttle
+ * @param {number} wait - Window length in milliseconds
+ * @returns {ThrottledAsyncFunction<A, R>} Throttled wrapper with cancel support
+ * @example
+ * const fetchUser = throttleAsync(loadUser, 1000);
+ */
+export declare const throttleAsync: <A extends unknown[], R>(function_: (...arguments_: A) => Promise<R>, wait: number) => ThrottledAsyncFunction<A, R>;

package/module/es5/Async/throttleAsync.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.throttleAsync = void 0;
+/**
+ * Creates a throttled async function. Coalesces concurrent calls within the
+ * `wait` window so only one underlying invocation runs; all callers in the
+ * window receive the same result.
+ *
+ * @template A - Argument tuple type
+ * @template R - Resolved value type
+ * @param {(...args: A) => Promise<R>} function_ - Async function to throttle
+ * @param {number} wait - Window length in milliseconds
+ * @returns {ThrottledAsyncFunction<A, R>} Throttled wrapper with cancel support
+ * @example
+ * const fetchUser = throttleAsync(loadUser, 1000);
+ */
+var throttleAsync = exports.throttleAsync = function throttleAsync(function_, wait) {
+  var inflight;
+  var lockedUntil = 0;
+  var throttled = function throttled() {
+    if (inflight) {
+      return inflight;
+    }
+    if (Date.now() < lockedUntil) {
+      return Promise.reject(new Error("throttleAsync window not elapsed"));
+    }
+    var current = function_.apply(void 0, arguments);
+    inflight = current;
+    var cleanup = function cleanup() {
+      if (inflight === current) {
+        inflight = undefined;
+        lockedUntil = Date.now() + wait;
+      }
+    };
+    current.then(cleanup, cleanup);
+    return current;
+  };
+  throttled.cancel = function () {
+    inflight = undefined;
+    lockedUntil = 0;
+  };
+  return throttled;
+};

package/module/es5/Async/waitFor.d.ts

@@ -0,0 +1,18 @@
+export interface WaitForOptions {
+    timeout?: number;
+    interval?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Repeatedly evaluates a condition until it returns a truthy value or the
+ * timeout elapses. Resolves with the final truthy value.
+ *
+ * @template T - Truthy result type
+ * @param {() => T | Promise<T>} condition - Condition predicate
+ * @param {WaitForOptions} [options] - Polling configuration
+ * @returns {Promise<NonNullable<T>>} The first truthy value
+ * @throws {Error} When the timeout elapses or the signal aborts
+ * @example
+ * await waitFor(() => document.querySelector("#root"), { interval: 100 });
+ */
+export declare const waitFor: <T>(condition: () => T | Promise<T>, options?: WaitForOptions) => Promise<NonNullable<T>>;

package/module/es5/{Error/retry.js → Async/waitFor.js}

@@ -3,86 +3,80 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.retry = void 0;
+exports.waitFor = void 0;
+var _sleep = require("./sleep");
 function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
 function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
 /**
- * Retries a given async function with configurable retry logic
- *
- * @template T - The return type of the function
- * @param function_ - The async function to retry
- * @param options - Configuration options for retry behavior
- * @param options.retries - Maximum number of retry attempts (default: 3)
- * @param options.delay - Delay between retries in milliseconds (default: 1000)
- * @param options.shouldRetry - Function to determine if an error should trigger a retry (default: always retry)
- * @returns Promise that resolves with the function result or rejects with the final error
+ * Repeatedly evaluates a condition until it returns a truthy value or the
+ * timeout elapses. Resolves with the final truthy value.
  *
+ * @template T - Truthy result type
+ * @param {() => T | Promise<T>} condition - Condition predicate
+ * @param {WaitForOptions} [options] - Polling configuration
+ * @returns {Promise<NonNullable<T>>} The first truthy value
+ * @throws {Error} When the timeout elapses or the signal aborts
  * @example
- * ```typescript
- * // Basic usage with default options
- * const result = await retry(async () => {
- *   const response = await fetch('/api/data');
- *   if (!response.ok) throw new Error('Failed to fetch');
- *   return response.json();
- * });
- *
- * // Custom retry configuration
- * const result = await retry(
- *   () => riskyOperation(),
- *   {
- *     retries: 5,
- *     delay: 2000,
- *     shouldRetry: (error) => error instanceof NetworkError
- *   }
- * );
- * ```
+ * await waitFor(() => document.querySelector("#root"), { interval: 100 });
  */
-var retry = exports.retry = function retry(function_) {
-  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  var _options$retries = options.retries,
-    retries = _options$retries === void 0 ? 3 : _options$retries,
-    _options$delay = options.delay,
-    delay = _options$delay === void 0 ? 1000 : _options$delay,
-    _options$shouldRetry = options.shouldRetry,
-    shouldRetry = _options$shouldRetry === void 0 ? function () {
-      return true;
-    } : _options$shouldRetry;
-  var _attempt = /*#__PURE__*/function () {
-    var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(remainingAttempts) {
-      var _t;
-      return _regenerator().w(function (_context) {
-        while (1) switch (_context.p = _context.n) {
-          case 0:
-            _context.p = 0;
-            _context.n = 1;
-            return function_();
-          case 1:
-            return _context.a(2, _context.v);
-          case 2:
-            _context.p = 2;
-            _t = _context.v;
-            if (!(remainingAttempts <= 0 || !shouldRetry(_t))) {
-              _context.n = 3;
-              break;
-            }
-            throw _t;
-          case 3:
+var waitFor = exports.waitFor = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(condition) {
+    var options,
+      _options$timeout,
+      timeout,
+      _options$interval,
+      interval,
+      signal,
+      startTime,
+      _signal$reason,
+      value,
+      _args = arguments;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          options = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
+          _options$timeout = options.timeout, timeout = _options$timeout === void 0 ? 5000 : _options$timeout, _options$interval = options.interval, interval = _options$interval === void 0 ? 100 : _options$interval, signal = options.signal;
+          startTime = Date.now();
+        case 1:
+          if (!true) {
+            _context.n = 7;
+            break;
+          }
+          if (!(signal !== null && signal !== void 0 && signal.aborted)) {
+            _context.n = 2;
+            break;
+          }
+          throw (_signal$reason = signal.reason) !== null && _signal$reason !== void 0 ? _signal$reason : new Error("Aborted");
+        case 2:
+          _context.n = 3;
+          return condition();
+        case 3:
+          value = _context.v;
+          if (!value) {
             _context.n = 4;
-            return new Promise(function (resolve) {
-              return setTimeout(function () {
-                return resolve(_attempt(remainingAttempts - 1));
-              }, delay);
-            });
-          case 4:
-            return _context.a(2, _context.v);
-        }
-      }, _callee, null, [[0, 2]]);
-    }));
-    return function attempt(_x) {
-      return _ref.apply(this, arguments);
-    };
-  }();
-  return _attempt(retries);
-};
+            break;
+          }
+          return _context.a(2, value);
+        case 4:
+          if (!(Date.now() - startTime >= timeout)) {
+            _context.n = 5;
+            break;
+          }
+          throw new Error("waitFor timed out after ".concat(timeout, "ms"));
+        case 5:
+          _context.n = 6;
+          return (0, _sleep.sleep)(interval);
+        case 6:
+          _context.n = 1;
+          break;
+        case 7:
+          return _context.a(2);
+      }
+    }, _callee);
+  }));
+  return function waitFor(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();