@brandup/ui-helpers 2.0.3 → 2.0.4

package/README.md

@@ -154,3 +154,13 @@ try {
 - `timeout(promise, ms, abort?)` — races `promise` against `ms` ms; rejects with a `TimeoutError` on timeout, or with the signal's reason on abort. Throws synchronously if `ms ≤ 0`. The underlying `promise` is not cancelled — only the wait ends.
 - `abortable(promise, abort?)` — makes *waiting* for `promise` abortable: rejects with the signal's reason on abort. Does not stop the underlying work; without a signal the promise is awaited as-is.
 - `TimeoutError` — error class thrown by `timeout` when the time limit is exceeded.
+
+## Polyfills
+
+An opt-in, side-effect-only entry point fills in `AbortSignal` APIs that older runtimes may lack — `AbortSignal.prototype.throwIfAborted`, `AbortSignal.timeout` and `AbortSignal.any`. Import it once, as early as possible (e.g. in your entry module):
+
+```TypeScript
+import "@brandup/ui-helpers/polyfill";
+```
+
+Each implementation installs only when missing, so native behaviour is preserved where available. Types ship with the TypeScript `ESNext` lib; this module provides just the runtime. It is excluded from tree-shaking (`sideEffects`), so a bare import is never dropped by the bundler.

package/dist/cjs/polyfill.js

@@ -0,0 +1,44 @@
+'use strict';
+
+/**
+ * Runtime polyfills for `AbortSignal`, installed only when the host lacks them:
+ * `AbortSignal.prototype.throwIfAborted`, `AbortSignal.timeout` and `AbortSignal.any`.
+ *
+ * Import for its side effect — there are no exports:
+ *
+ * ```TypeScript
+ * import "@brandup/ui-helpers/polyfill";
+ * ```
+ *
+ * Types already ship with the TypeScript `ESNext` lib; this module only fills in the
+ * implementations missing in older runtimes, matching the standard behaviour.
+ */
+if (typeof AbortSignal.prototype.throwIfAborted !== "function") {
+    AbortSignal.prototype.throwIfAborted = function () {
+        if (this.aborted)
+            throw this.reason;
+    };
+}
+if (typeof AbortSignal.timeout !== "function") {
+    AbortSignal.timeout = (milliseconds) => {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(new DOMException("The operation timed out.", "TimeoutError")), milliseconds);
+        return controller.signal;
+    };
+}
+if (typeof AbortSignal.any !== "function") {
+    AbortSignal.any = (signals) => {
+        const controller = new AbortController();
+        for (const signal of signals) {
+            // If one is already aborted, the combined signal aborts immediately with its reason.
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                break;
+            }
+            // Tying each listener to the combined signal removes them all once it aborts — no leak.
+            signal.addEventListener("abort", () => controller.abort(signal.reason), { signal: controller.signal });
+        }
+        return controller.signal;
+    };
+}
+//# sourceMappingURL=polyfill.js.map

package/dist/cjs/polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.js","sources":["../../../source/polyfill.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;AAYG;AAEH,IAAI,OAAO,WAAW,CAAC,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE;AAC/D,IAAA,WAAW,CAAC,SAAS,CAAC,cAAc,GAAG,YAAA;QACtC,IAAI,IAAI,CAAC,OAAO;YACf,MAAM,IAAI,CAAC,MAAM;AACnB,IAAA,CAAC;AACF;AAEA,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU,EAAE;AAC9C,IAAA,WAAW,CAAC,OAAO,GAAG,CAAC,YAAoB,KAAiB;AAC3D,QAAA,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE;AACxC,QAAA,UAAU,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,EAAE,YAAY,CAAC;QAC9G,OAAO,UAAU,CAAC,MAAM;AACzB,IAAA,CAAC;AACF;AAEA,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE;AAC1C,IAAA,WAAW,CAAC,GAAG,GAAG,CAAC,OAAsB,KAAiB;AACzD,QAAA,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE;AAExC,QAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;;AAE7B,YAAA,IAAI,MAAM,CAAC,OAAO,EAAE;AACnB,gBAAA,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC/B;YACD;;YAGA,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACvG;QAEA,OAAO,UAAU,CAAC,MAAM;AACzB,IAAA,CAAC;AACF;;"}

package/dist/mjs/polyfill.js

@@ -0,0 +1,42 @@
+/**
+ * Runtime polyfills for `AbortSignal`, installed only when the host lacks them:
+ * `AbortSignal.prototype.throwIfAborted`, `AbortSignal.timeout` and `AbortSignal.any`.
+ *
+ * Import for its side effect — there are no exports:
+ *
+ * ```TypeScript
+ * import "@brandup/ui-helpers/polyfill";
+ * ```
+ *
+ * Types already ship with the TypeScript `ESNext` lib; this module only fills in the
+ * implementations missing in older runtimes, matching the standard behaviour.
+ */
+if (typeof AbortSignal.prototype.throwIfAborted !== "function") {
+    AbortSignal.prototype.throwIfAborted = function () {
+        if (this.aborted)
+            throw this.reason;
+    };
+}
+if (typeof AbortSignal.timeout !== "function") {
+    AbortSignal.timeout = (milliseconds) => {
+        const controller = new AbortController();
+        setTimeout(() => controller.abort(new DOMException("The operation timed out.", "TimeoutError")), milliseconds);
+        return controller.signal;
+    };
+}
+if (typeof AbortSignal.any !== "function") {
+    AbortSignal.any = (signals) => {
+        const controller = new AbortController();
+        for (const signal of signals) {
+            // If one is already aborted, the combined signal aborts immediately with its reason.
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                break;
+            }
+            // Tying each listener to the combined signal removes them all once it aborts — no leak.
+            signal.addEventListener("abort", () => controller.abort(signal.reason), { signal: controller.signal });
+        }
+        return controller.signal;
+    };
+}
+//# sourceMappingURL=polyfill.js.map

package/dist/mjs/polyfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfill.js","sources":["../../../source/polyfill.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;AAYG;AAEH,IAAI,OAAO,WAAW,CAAC,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE;AAC/D,IAAA,WAAW,CAAC,SAAS,CAAC,cAAc,GAAG,YAAA;QACtC,IAAI,IAAI,CAAC,OAAO;YACf,MAAM,IAAI,CAAC,MAAM;AACnB,IAAA,CAAC;AACF;AAEA,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,UAAU,EAAE;AAC9C,IAAA,WAAW,CAAC,OAAO,GAAG,CAAC,YAAoB,KAAiB;AAC3D,QAAA,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE;AACxC,QAAA,UAAU,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,EAAE,YAAY,CAAC;QAC9G,OAAO,UAAU,CAAC,MAAM;AACzB,IAAA,CAAC;AACF;AAEA,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE;AAC1C,IAAA,WAAW,CAAC,GAAG,GAAG,CAAC,OAAsB,KAAiB;AACzD,QAAA,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE;AAExC,QAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;;AAE7B,YAAA,IAAI,MAAM,CAAC,OAAO,EAAE;AACnB,gBAAA,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC/B;YACD;;YAGA,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;QACvG;QAEA,OAAO,UAAU,CAAC,MAAM;AACzB,IAAA,CAAC;AACF"}

package/dist/polyfill.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/package.json

@@ -22,16 +22,24 @@
     "email": "it@brandup.online"
   },
   "license": "Apache-2.0",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "main": "dist/cjs/index.js",
   "module": "dist/mjs/index.js",
   "types": "dist/types.d.ts",
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/cjs/polyfill.js",
+    "./dist/mjs/polyfill.js"
+  ],
   "exports": {
     ".": {
       "types": "./dist/types.d.ts",
       "import": "./dist/mjs/index.js",
       "require": "./dist/cjs/index.js"
+    },
+    "./polyfill": {
+      "types": "./dist/polyfill.d.ts",
+      "import": "./dist/mjs/polyfill.js",
+      "require": "./dist/cjs/polyfill.js"
     }
   },
   "files": [