foxts 4.2.1 → 4.3.0

package/dist/ts-xor/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Skip evaluating `U` if `T` is `unknown`.
+ */
+type EvalIfNotUnknown<T, U> = unknown extends T ? never : U;
+/**
+ * Resolve mapped types and show the derived keys and their types when hovering in
+ * VS Code, instead of just showing the names those mapped types are defined with.
+ */
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Get the keys of T without any keys of U.
+ */
+type Without<T, U> = {
+    [P in Exclude<keyof T, keyof U>]?: never;
+};
+
+/**
+ * Restrict using either exclusively the keys of `T` or exclusively the keys of `U`.
+ *
+ * No unique keys of `T` can be used simultaneously with any unique keys of `U`.
+ *
+ * @example
+ * ```ts
+ * const myVar: XOR<{ data: object }, { error: object }>
+ * ```
+ *
+ * Supports from 2 up to 8 generic parameters.
+ *
+ * More: https://github.com/maninak/ts-xor/tree/master#description
+ *  */
+type XOR<A, B, C = unknown, D = unknown, E = unknown, F = unknown, G = unknown, H = unknown> = Prettify<(Without<B & C & D & E & F & G & H, A> & A) | (Without<A & C & D & E & F & G & H, B> & B) | EvalIfNotUnknown<C, Without<A & B & D & E & F & G & H, C> & C> | EvalIfNotUnknown<D, Without<A & B & C & E & F & G & H, D> & D> | EvalIfNotUnknown<E, Without<A & B & C & D & F & G & H, E> & E> | EvalIfNotUnknown<F, Without<A & B & C & D & E & G & H, F> & F> | EvalIfNotUnknown<G, Without<A & B & C & D & E & F & H, G> & G> | EvalIfNotUnknown<H, Without<A & B & C & D & E & F & G, H> & H>>;
+
+export type { XOR };

package/dist/ts-xor/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/wait-for/index.d.ts

@@ -0,0 +1,12 @@
+type FalsyValue = null | undefined | false | '' | 0 | void;
+type TruthyValue = object | unknown[] | symbol | Function | Exclude<number, 0> | Exclude<string, ''> | true;
+type CleanupFn = () => void;
+type OnCleanup = (cleanUpFn: CleanupFn) => void;
+type Scheduler = (callback: () => Promise<void>, onCleanup: OnCleanup) => void | CleanupFn;
+type Predicate<T extends TruthyValue> = () => T | FalsyValue | Promise<T> | Promise<FalsyValue>;
+declare function waitFor<T extends TruthyValue>(predicate: Predicate<T>, scheduler: Scheduler, abortSignal?: AbortSignal | null): Promise<T>;
+declare function waitFor<T extends TruthyValue>(predicate: Predicate<T>, checkInterval?: number, abortSignal?: AbortSignal | null): Promise<T>;
+declare function waitFor<T extends TruthyValue>(predicate: Predicate<T>, abortSignal: AbortSignal): Promise<T>;
+
+export { waitFor };
+export type { CleanupFn, OnCleanup, Predicate, Scheduler };

package/dist/wait-for/index.js

@@ -0,0 +1 @@
+"use strict";exports.waitFor=function(t,o=50,e=null){if("object"==typeof o&&"aborted"in o&&(e=o,o=50),"number"==typeof o){const t=o;o=(o,e)=>{const n=setTimeout(o,t);e(()=>clearTimeout(n))}}e??=AbortSignal.timeout(5e3);const n=new Set,r=t=>n.add(t);return new Promise((c,i)=>{const a=async()=>{try{e.throwIfAborted();const i=await t();if(i)return void c(i);const s=o(a,r);"function"==typeof s&&n.add(s)}catch(t){i(t)}};a()}).finally(()=>{n.forEach(t=>t())})};

package/dist/wait-for/index.mjs

@@ -0,0 +1 @@
+function t(o,e=50,n=null){if("object"==typeof e&&"aborted"in e&&(n=e,e=50),"number"==typeof e){const t=e;e=(o,e)=>{const n=setTimeout(o,t);e(()=>clearTimeout(n))}}n??=AbortSignal.timeout(5e3);const r=new Set,c=t=>r.add(t);return new Promise((t,i)=>{const a=async()=>{try{n.throwIfAborted();const i=await o();if(i)return void t(i);const f=e(a,c);"function"==typeof f&&r.add(f)}catch(t){i(t)}};a()}).finally(()=>{r.forEach(t=>t())})}export{t as waitFor};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foxts",
-  "version": "4.2.1",
+  "version": "4.3.0",
   "description": "Opinionated collection of common TypeScript utils by @SukkaW",
   "repository": {
     "url": "https://github.com/SukkaW/foxts"
@@ -274,6 +274,12 @@
       "require": "./dist/text-line-stream/index.js",
       "default": "./dist/text-line-stream/index.js"
     },
+    "./ts-xor": {
+      "types": "./dist/ts-xor/index.d.ts",
+      "import": "./dist/ts-xor/index.mjs",
+      "require": "./dist/ts-xor/index.js",
+      "default": "./dist/ts-xor/index.js"
+    },
     "./uint8array-utils": {
       "types": "./dist/uint8array-utils/index.d.ts",
       "import": "./dist/uint8array-utils/index.mjs",
@@ -286,11 +292,11 @@
       "require": "./dist/wait/index.js",
       "default": "./dist/wait/index.js"
     },
-    "./wait-until": {
-      "types": "./dist/wait-until/index.d.ts",
-      "import": "./dist/wait-until/index.mjs",
-      "require": "./dist/wait-until/index.js",
-      "default": "./dist/wait-until/index.js"
+    "./wait-for": {
+      "types": "./dist/wait-for/index.d.ts",
+      "import": "./dist/wait-for/index.mjs",
+      "require": "./dist/wait-for/index.js",
+      "default": "./dist/wait-for/index.js"
     }
   },
   "sideEffects": false,
@@ -336,10 +342,12 @@
     "rollup-plugin-oxc-resolve": "^0.0.4",
     "rollup-plugin-swc3": "^0.12.1",
     "sinon": "^21.0.0",
+    "typescript": "^5.9.3",
     "word-list": "3.0.0"
   },
   "scripts": {
     "lint": "eslint --format=sukka .",
+    "build-ts-xor": "SWC_NODE_IGNORE_DYNAMIC=1 node --require @swc-node/register ./src/ts-xor/_build.ts",
     "test": "SWC_NODE_IGNORE_DYNAMIC=1 SWC_NODE_INLINE_SOURCE_MAP=1 nyc mocha --require @swc-node/register --parallel --full-trace ./src/**/*.test.ts",
     "bench": "SWC_NODE_IGNORE_DYNAMIC=1 node --require @swc-node/register",
     "bench:all": "SWC_NODE_IGNORE_DYNAMIC=1 node --require @swc-node/register ./src/**/*.bench.ts",

package/dist/wait-until/index.d.ts

@@ -1,12 +0,0 @@
-type FalsyValue = null | undefined | false | '' | 0 | void;
-type TruthyValue = Record<string, unknown> | unknown[] | symbol | ((..._args: unknown[]) => unknown) | Exclude<number, 0> | Exclude<string, ''> | true;
-type CleanupFn = () => void;
-type OnCleanup = (cleanUpFn: CleanupFn) => void;
-type Scheduler = (callback: () => Promise<void>, onCleanup: OnCleanup) => void | CleanupFn;
-type Predicate<T extends TruthyValue | FalsyValue> = () => T | Promise<T>;
-declare function waitUntil<T extends TruthyValue | FalsyValue>(predicate: Predicate<T>, scheduler: Scheduler, abortSignal?: AbortSignal | null): Promise<T>;
-declare function waitUntil<T extends TruthyValue | FalsyValue>(predicate: Predicate<T>, checkInterval?: number, abortSignal?: AbortSignal | null): Promise<T>;
-declare function waitUntil<T extends TruthyValue | FalsyValue>(predicate: Predicate<T>, abortSignal: AbortSignal): Promise<T>;
-
-export { waitUntil };
-export type { CleanupFn, OnCleanup, Predicate, Scheduler };

package/dist/wait-until/index.js

@@ -1 +0,0 @@
-"use strict";exports.waitUntil=function(t,o=50,e=null){if("object"==typeof o&&"aborted"in o&&(e=o,o=50),"number"==typeof o){const t=o;o=(o,e)=>{const n=setTimeout(o,t);e(()=>clearTimeout(n))}}e??=AbortSignal.timeout(5e3);const n=new Set,r=t=>n.add(t);return new Promise((i,c)=>{const a=async()=>{try{e.throwIfAborted();const c=await t();if(c)return void i(c);const s=o(a,r);"function"==typeof s&&n.add(s)}catch(t){c(t)}};a()}).finally(()=>{n.forEach(t=>t())})};

package/dist/wait-until/index.mjs

@@ -1 +0,0 @@
-function t(o,e=50,n=null){if("object"==typeof e&&"aborted"in e&&(n=e,e=50),"number"==typeof e){const t=e;e=(o,e)=>{const n=setTimeout(o,t);e(()=>clearTimeout(n))}}n??=AbortSignal.timeout(5e3);const r=new Set,i=t=>r.add(t);return new Promise((t,c)=>{const a=async()=>{try{n.throwIfAborted();const c=await o();if(c)return void t(c);const f=e(a,i);"function"==typeof f&&r.add(f)}catch(t){c(t)}};a()}).finally(()=>{r.forEach(t=>t())})}export{t as waitUntil};