@xylabs/promise 5.0.83 → 5.0.86

package/README.md

@@ -15,6 +15,8 @@
 
 Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
+
+
 ## Reference
 
 **@xylabs/promise**
@@ -23,33 +25,41 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
 ## Classes
 
-- [PromiseEx](#classes/PromiseEx)
+| Class | Description |
+| ------ | ------ |
+| [PromiseEx](#classes/PromiseEx) | An extended Promise that carries an optional attached value and supports cancellation. The value can be inspected via the `then` or `value` methods to conditionally cancel. |
 
 ## Interfaces
 
-- [PromiseType](#interfaces/PromiseType)
+| Interface | Description |
+| ------ | ------ |
+| [PromiseType](#interfaces/PromiseType) | An interface representing any thenable (promise-like) object. |
 
 ## Type Aliases
 
-- [PromiseExSubFunc](#type-aliases/PromiseExSubFunc)
-- [PromiseExFunc](#type-aliases/PromiseExFunc)
-- [PromiseExValueFunc](#type-aliases/PromiseExValueFunc)
-- [Promisable](#type-aliases/Promisable)
-- [PromisableArray](#type-aliases/PromisableArray)
-- [OptionalPromisable](#type-aliases/OptionalPromisable)
-- [OptionalPromisableArray](#type-aliases/OptionalPromisableArray)
-- [NullablePromisable](#type-aliases/NullablePromisable)
-- [NullablePromisableArray](#type-aliases/NullablePromisableArray)
-- [AsyncMutex](#type-aliases/AsyncMutex)
-- [AnyNonPromise](#type-aliases/AnyNonPromise)
+| Type Alias | Description |
+| ------ | ------ |
+| [PromiseExSubFunc](#type-aliases/PromiseExSubFunc) | A resolve/reject callback used within PromiseEx. |
+| [PromiseExFunc](#type-aliases/PromiseExFunc) | The executor function passed to the PromiseEx constructor. |
+| [PromiseExValueFunc](#type-aliases/PromiseExValueFunc) | A callback that inspects the attached value and returns whether to cancel the promise. |
+| [Promisable](#type-aliases/Promisable) | A value that may be a Promise, PromiseEx, or a plain synchronous value. |
+| [PromisableArray](#type-aliases/PromisableArray) | A Promisable that resolves to an array. |
+| [OptionalPromisable](#type-aliases/OptionalPromisable) | A Promisable that may resolve to undefined. |
+| [OptionalPromisableArray](#type-aliases/OptionalPromisableArray) | A Promisable array where elements may be undefined. |
+| [NullablePromisable](#type-aliases/NullablePromisable) | A Promisable that may resolve to null. |
+| [NullablePromisableArray](#type-aliases/NullablePromisableArray) | A Promisable array where elements may be null. |
+| [AsyncMutex](#type-aliases/AsyncMutex) | - |
+| [AnyNonPromise](#type-aliases/AnyNonPromise) | Any non-promise typed value, excluding thenables. |
 
 ## Functions
 
-- [fulfilled](#functions/fulfilled)
-- [fulfilledValues](#functions/fulfilledValues)
-- [rejected](#functions/rejected)
-- [toPromise](#functions/toPromise)
-- [isPromise](#functions/isPromise)
+| Function | Description |
+| ------ | ------ |
+| [fulfilled](#functions/fulfilled) | For use with Promise.allSettled to filter only successful results |
+| [fulfilledValues](#functions/fulfilledValues) | For use with Promise.allSettled to reduce to only successful result values |
+| [rejected](#functions/rejected) | For use with Promise.allSettled to filter only rejected results |
+| [toPromise](#functions/toPromise) | Wraps a value in a Promise if it is not already one. |
+| [isPromise](#functions/isPromise) | Type guard that checks whether a value is a Promise instance. |
 
 ### classes
 
@@ -59,37 +69,34 @@ Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
 ***
 
+An extended Promise that carries an optional attached value and supports cancellation.
+The value can be inspected via the `then` or `value` methods to conditionally cancel.
+
 ## Extends
 
 - `Promise`\<`T`\>
 
 ## Type Parameters
 
-### T
-
-`T`
-
-### V
-
-`V` = `void`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `void` |
 
 ## Constructors
 
 ### Constructor
 
 ```ts
-new PromiseEx<T, V>(func, value?): PromiseEx<T, V>;
+new PromiseEx<T, V>(func: PromiseExFunc<T>, value?: V): PromiseEx<T, V>;
 ```
 
 ### Parameters
 
-#### func
-
-[`PromiseExFunc`](#../type-aliases/PromiseExFunc)\<`T`\>
-
-#### value?
-
-`V`
+| Parameter | Type |
+| ------ | ------ |
+| `func` | [`PromiseExFunc`](#../type-aliases/PromiseExFunc)\<`T`\> |
+| `value?` | `V` |
 
 ### Returns
 
@@ -103,11 +110,9 @@ Promise<T>.constructor
 
 ## Properties
 
-### cancelled?
-
-```ts
-optional cancelled: boolean;
-```
+| Property | Type | Description |
+| ------ | ------ | ------ |
+| <a id="cancelled"></a> `cancelled?` | `boolean` | Whether the promise has been cancelled via a value callback. |
 
 ## Methods
 
@@ -115,40 +120,29 @@ optional cancelled: boolean;
 
 ```ts
 then<TResult1, TResult2>(
-   onfulfilled?, 
-   onrejected?, 
-onvalue?): Promise<TResult1 | TResult2>;
+   onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1> | null, 
+   onrejected?: 
+  | (reason: unknown) => TResult2 | PromiseLike<TResult2>
+  | null, 
+onvalue?: (value?: V) => boolean): Promise<TResult1 | TResult2>;
 ```
 
 Attaches callbacks for the resolution and/or rejection of the Promise.
 
 ### Type Parameters
 
-#### TResult1
-
-`TResult1` = `T`
-
-#### TResult2
-
-`TResult2` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TResult1` | `T` |
+| `TResult2` | `never` |
 
 ### Parameters
 
-#### onfulfilled?
-
-The callback to execute when the Promise is resolved.
-
-(`value`) => `TResult1` \| `PromiseLike`\<`TResult1`\> | `null`
-
-#### onrejected?
-
-The callback to execute when the Promise is rejected.
-
-(`reason`) => `TResult2` \| `PromiseLike`\<`TResult2`\> | `null`
-
-#### onvalue?
-
-(`value?`) => `boolean`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `onfulfilled?` | (`value`: `T`) => `TResult1` \| `PromiseLike`\<`TResult1`\> \| `null` | The callback to execute when the Promise is resolved. |
+| `onrejected?` | \| (`reason`: `unknown`) => `TResult2` \| `PromiseLike`\<`TResult2`\> \| `null` | The callback to execute when the Promise is rejected. |
+| `onvalue?` | (`value?`: `V`) => `boolean` | - |
 
 ### Returns
 
@@ -167,19 +161,23 @@ Promise.then
 ### value()
 
 ```ts
-value(onvalue?): PromiseEx<T, V>;
+value(onvalue?: (value?: V) => boolean): PromiseEx<T, V>;
 ```
 
-### Parameters
+Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.
 
-#### onvalue?
+### Parameters
 
-(`value?`) => `boolean`
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `onvalue?` | (`value?`: `V`) => `boolean` | A callback that receives the attached value and returns whether to cancel. |
 
 ### Returns
 
 `PromiseEx`\<`T`, `V`\>
 
+This instance for chaining.
+
 ### functions
 
   ### <a id="fulfilled"></a>fulfilled
@@ -189,22 +187,22 @@ value(onvalue?): PromiseEx<T, V>;
 ***
 
 ```ts
-function fulfilled<T>(val): val is PromiseFulfilledResult<T>;
+function fulfilled<T>(val: PromiseSettledResult<T>): val is PromiseFulfilledResult<T>;
 ```
 
 For use with Promise.allSettled to filter only successful results
 
 ## Type Parameters
 
-### T
-
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### val
-
-`PromiseSettledResult`\<`T`\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `val` | `PromiseSettledResult`\<`T`\> | - |
 
 ## Returns
 
@@ -217,26 +215,23 @@ For use with Promise.allSettled to filter only successful results
 ***
 
 ```ts
-function fulfilledValues<T>(previousValue, currentValue): T[];
+function fulfilledValues<T>(previousValue: T[], currentValue: PromiseSettledResult<T>): T[];
 ```
 
 For use with Promise.allSettled to reduce to only successful result values
 
 ## Type Parameters
 
-### T
-
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### previousValue
-
-`T`[]
-
-### currentValue
-
-`PromiseSettledResult`\<`T`\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `previousValue` | `T`[] | - |
+| `currentValue` | `PromiseSettledResult`\<`T`\> | - |
 
 ## Returns
 
@@ -269,14 +264,16 @@ const results = settled.reduce<string[]>(fulfilledValues, [])
 ## Call Signature
 
 ```ts
-function isPromise(value): value is Promise<unknown>;
+function isPromise(value: unknown): value is Promise<unknown>;
 ```
 
-### Parameters
+Type guard that checks whether a value is a Promise instance.
 
-### value
+### Parameters
 
-`unknown`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `unknown` |
 
 ### Returns
 
@@ -285,20 +282,22 @@ function isPromise(value): value is Promise<unknown>;
 ## Call Signature
 
 ```ts
-function isPromise<T>(value): value is Extract<T, Promise<unknown>>;
+function isPromise<T>(value: T): value is Extract<T, Promise<unknown>>;
 ```
 
-### Type Parameters
+Type guard that checks whether a value is a Promise instance.
 
-### T
+### Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ### Parameters
 
-### value
-
-`T`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `T` |
 
 ### Returns
 
@@ -311,22 +310,22 @@ function isPromise<T>(value): value is Extract<T, Promise<unknown>>;
 ***
 
 ```ts
-function rejected<T>(val): val is PromiseRejectedResult;
+function rejected<T>(val: PromiseSettledResult<T>): val is PromiseRejectedResult;
 ```
 
 For use with Promise.allSettled to filter only rejected results
 
 ## Type Parameters
 
-### T
-
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### val
-
-`PromiseSettledResult`\<`T`\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `val` | `PromiseSettledResult`\<`T`\> | - |
 
 ## Returns
 
@@ -339,25 +338,29 @@ For use with Promise.allSettled to filter only rejected results
 ***
 
 ```ts
-function toPromise<T>(value): Promise<T>;
+function toPromise<T>(value: Promisable<T>): Promise<T>;
 ```
 
-## Type Parameters
+Wraps a value in a Promise if it is not already one.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### value
-
-[`Promisable`](#../type-aliases/Promisable)\<`T`\>
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `value` | [`Promisable`](#../type-aliases/Promisable)\<`T`\> | A value that may or may not be a Promise. |
 
 ## Returns
 
 `Promise`\<`T`\>
 
+A Promise resolving to the value.
+
 ### interfaces
 
   ### <a id="PromiseType"></a>PromiseType
@@ -366,17 +369,13 @@ function toPromise<T>(value): Promise<T>;
 
 ***
 
-## Properties
-
-### then()
-
-```ts
-then: () => unknown;
-```
+An interface representing any thenable (promise-like) object.
 
-### Returns
+## Properties
 
-`unknown`
+| Property | Type |
+| ------ | ------ |
+| <a id="then"></a> `then` | () => `unknown` |
 
 ### type-aliases
 
@@ -390,6 +389,8 @@ then: () => unknown;
 type AnyNonPromise = Exclude<TypedValue, PromiseType>;
 ```
 
+Any non-promise typed value, excluding thenables.
+
   ### <a id="AsyncMutex"></a>AsyncMutex
 
 [**@xylabs/promise**](#../README)
@@ -402,9 +403,9 @@ type AsyncMutex<T> = Promise<T>;
 
 ## Type Parameters
 
-### T
-
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Description
 
@@ -420,15 +421,14 @@ Used to document promises that are being used as Mutexes
 type NullablePromisable<T, V> = Promisable<T | null, V>;
 ```
 
-## Type Parameters
-
-### T
-
-`T`
+A Promisable that may resolve to null.
 
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="NullablePromisableArray"></a>NullablePromisableArray
 
@@ -440,15 +440,14 @@ type NullablePromisable<T, V> = Promisable<T | null, V>;
 type NullablePromisableArray<T, V> = PromisableArray<T | null, V>;
 ```
 
-## Type Parameters
-
-### T
-
-`T`
+A Promisable array where elements may be null.
 
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="OptionalPromisable"></a>OptionalPromisable
 
@@ -460,15 +459,14 @@ type NullablePromisableArray<T, V> = PromisableArray<T | null, V>;
 type OptionalPromisable<T, V> = Promisable<T | undefined, V>;
 ```
 
-## Type Parameters
-
-### T
+A Promisable that may resolve to undefined.
 
-`T`
-
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="OptionalPromisableArray"></a>OptionalPromisableArray
 
@@ -480,15 +478,14 @@ type OptionalPromisable<T, V> = Promisable<T | undefined, V>;
 type OptionalPromisableArray<T, V> = PromisableArray<T | undefined, V>;
 ```
 
-## Type Parameters
-
-### T
-
-`T`
+A Promisable array where elements may be undefined.
 
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="Promisable"></a>Promisable
 
@@ -500,15 +497,14 @@ type OptionalPromisableArray<T, V> = PromisableArray<T | undefined, V>;
 type Promisable<T, V> = PromiseEx<T, V> | Promise<T> | T;
 ```
 
-## Type Parameters
-
-### T
+A value that may be a Promise, PromiseEx, or a plain synchronous value.
 
-`T`
-
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="PromisableArray"></a>PromisableArray
 
@@ -520,15 +516,14 @@ type Promisable<T, V> = PromiseEx<T, V> | Promise<T> | T;
 type PromisableArray<T, V> = Promisable<T[], V>;
 ```
 
-## Type Parameters
+A Promisable that resolves to an array.
 
-### T
-
-`T`
-
-### V
+## Type Parameters
 
-`V` = `never`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `V` | `never` |
 
   ### <a id="PromiseExFunc"></a>PromiseExFunc
 
@@ -537,24 +532,23 @@ type PromisableArray<T, V> = Promisable<T[], V>;
 ***
 
 ```ts
-type PromiseExFunc<T> = (resolve?, reject?) => void;
+type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void;
 ```
 
-## Type Parameters
+The executor function passed to the PromiseEx constructor.
 
-### T
+## Type Parameters
 
-`T`
+| Type Parameter |
+| ------ |
+| `T` |
 
 ## Parameters
 
-### resolve?
-
-[`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\>
-
-### reject?
-
-[`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\>
+| Parameter | Type |
+| ------ | ------ |
+| `resolve?` | [`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\> |
+| `reject?` | [`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\> |
 
 ## Returns
 
@@ -567,24 +561,23 @@ type PromiseExFunc<T> = (resolve?, reject?) => void;
 ***
 
 ```ts
-type PromiseExSubFunc<T, TResult> = (value) => TResult;
+type PromiseExSubFunc<T, TResult> = (value: T) => TResult;
 ```
 
-## Type Parameters
-
-### T
-
-`T`
+A resolve/reject callback used within PromiseEx.
 
-### TResult
+## Type Parameters
 
-`TResult` = `T`
+| Type Parameter | Default type |
+| ------ | ------ |
+| `T` | - |
+| `TResult` | `T` |
 
 ## Parameters
 
-### value
-
-`T`
+| Parameter | Type |
+| ------ | ------ |
+| `value` | `T` |
 
 ## Returns
 
@@ -597,20 +590,22 @@ type PromiseExSubFunc<T, TResult> = (value) => TResult;
 ***
 
 ```ts
-type PromiseExValueFunc<V> = (value?) => boolean;
+type PromiseExValueFunc<V> = (value?: V) => boolean;
 ```
 
-## Type Parameters
+A callback that inspects the attached value and returns whether to cancel the promise.
 
-### V
+## Type Parameters
 
-`V`
+| Type Parameter |
+| ------ |
+| `V` |
 
 ## Parameters
 
-### value?
-
-`V`
+| Parameter | Type |
+| ------ | ------ |
+| `value?` | `V` |
 
 ## Returns
 

package/dist/neutral/PromiseEx.d.ts

@@ -1,11 +1,24 @@
+/** A resolve/reject callback used within PromiseEx. */
 export type PromiseExSubFunc<T, TResult = T> = (value: T) => TResult;
+/** The executor function passed to the PromiseEx constructor. */
 export type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void;
+/** A callback that inspects the attached value and returns whether to cancel the promise. */
 export type PromiseExValueFunc<V> = (value?: V) => boolean;
+/**
+ * An extended Promise that carries an optional attached value and supports cancellation.
+ * The value can be inspected via the `then` or `value` methods to conditionally cancel.
+ */
 export declare class PromiseEx<T, V = void> extends Promise<T> {
+    /** Whether the promise has been cancelled via a value callback. */
     cancelled?: boolean;
     private _value?;
     constructor(func: PromiseExFunc<T>, value?: V);
     then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined, onvalue?: (value?: V) => boolean): Promise<TResult1 | TResult2>;
+    /**
+     * Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.
+     * @param onvalue - A callback that receives the attached value and returns whether to cancel.
+     * @returns This instance for chaining.
+     */
     value(onvalue?: (value?: V) => boolean): this;
 }
 //# sourceMappingURL=PromiseEx.d.ts.map

package/dist/neutral/PromiseEx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PromiseEx.d.ts","sourceRoot":"","sources":["../../src/PromiseEx.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAA;AACpE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;AAChH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;AAE1D,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,MAAM,CAAC,CAAG;gBAEN,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IAMpC,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACjF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACvF,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,GAC/B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAO/B,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO;CAMvC"}
+{"version":3,"file":"PromiseEx.d.ts","sourceRoot":"","sources":["../../src/PromiseEx.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAA;AAEpE,iEAAiE;AACjE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;AAEhH,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;AAE1D;;;GAGG;AACH,qBAAa,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACpD,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,MAAM,CAAC,CAAG;gBAEN,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IAMpC,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAC1C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACjF,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EACvF,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,GAC/B,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAO/B;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO;CAMvC"}

package/dist/neutral/index.d.ts

@@ -28,14 +28,27 @@ declare const fulfilled: <T>(val: PromiseSettledResult<T>) => val is PromiseFulf
  */
 declare const fulfilledValues: <T>(previousValue: T[], currentValue: PromiseSettledResult<T>) => T[];
 
+/** A resolve/reject callback used within PromiseEx. */
 type PromiseExSubFunc<T, TResult = T> = (value: T) => TResult;
+/** The executor function passed to the PromiseEx constructor. */
 type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void;
+/** A callback that inspects the attached value and returns whether to cancel the promise. */
 type PromiseExValueFunc<V> = (value?: V) => boolean;
+/**
+ * An extended Promise that carries an optional attached value and supports cancellation.
+ * The value can be inspected via the `then` or `value` methods to conditionally cancel.
+ */
 declare class PromiseEx<T, V = void> extends Promise<T> {
+    /** Whether the promise has been cancelled via a value callback. */
     cancelled?: boolean;
     private _value?;
     constructor(func: PromiseExFunc<T>, value?: V);
     then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined, onvalue?: (value?: V) => boolean): Promise<TResult1 | TResult2>;
+    /**
+     * Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.
+     * @param onvalue - A callback that receives the attached value and returns whether to cancel.
+     * @returns This instance for chaining.
+     */
     value(onvalue?: (value?: V) => boolean): this;
 }
 
@@ -46,19 +59,32 @@ declare class PromiseEx<T, V = void> extends Promise<T> {
  */
 declare const rejected: <T>(val: PromiseSettledResult<T>) => val is PromiseRejectedResult;
 
+/** A value that may be a Promise, PromiseEx, or a plain synchronous value. */
 type Promisable<T, V = never> = PromiseEx<T, V> | Promise<T> | T;
+/** A Promisable that resolves to an array. */
 type PromisableArray<T, V = never> = Promisable<T[], V>;
+/** A Promisable that may resolve to undefined. */
 type OptionalPromisable<T, V = never> = Promisable<T | undefined, V>;
+/** A Promisable array where elements may be undefined. */
 type OptionalPromisableArray<T, V = never> = PromisableArray<T | undefined, V>;
+/** A Promisable that may resolve to null. */
 type NullablePromisable<T, V = never> = Promisable<T | null, V>;
+/** A Promisable array where elements may be null. */
 type NullablePromisableArray<T, V = never> = PromisableArray<T | null, V>;
 /** @description Used to document promises that are being used as Mutexes */
 type AsyncMutex<T> = Promise<T>;
+/** An interface representing any thenable (promise-like) object. */
 interface PromiseType {
     then: () => unknown;
 }
+/** Any non-promise typed value, excluding thenables. */
 type AnyNonPromise = Exclude<TypedValue, PromiseType>;
 
+/**
+ * Wraps a value in a Promise if it is not already one.
+ * @param value - A value that may or may not be a Promise.
+ * @returns A Promise resolving to the value.
+ */
 declare function toPromise<T>(value: Promisable<T>): Promise<T>;
 
 export { PromiseEx, fulfilled, fulfilledValues, rejected, toPromise };

package/dist/neutral/index.mjs

@@ -11,6 +11,7 @@ var fulfilledValues = (previousValue, currentValue) => {
 
 // src/PromiseEx.ts
 var PromiseEx = class extends Promise {
+  /** Whether the promise has been cancelled via a value callback. */
   cancelled;
   _value;
   constructor(func, value) {
@@ -24,6 +25,11 @@ var PromiseEx = class extends Promise {
     }
     return super.then(onfulfilled, onrejected);
   }
+  /**
+   * Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.
+   * @param onvalue - A callback that receives the attached value and returns whether to cancel.
+   * @returns This instance for chaining.
+   */
   value(onvalue) {
     if (onvalue?.(this._value)) {
       this.cancelled = true;

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fulfilled.ts","../../src/fulfilledValues.ts","../../src/PromiseEx.ts","../../src/rejected.ts","../../src/toPromise.ts","../../src/index.ts"],"sourcesContent":["/**\n * For use with Promise.allSettled to filter only successful results\n * @param val\n * @returns\n */\nexport const fulfilled = <T>(val: PromiseSettledResult<T>): val is PromiseFulfilledResult<T> => {\n  return val.status === 'fulfilled'\n}\n","/**\n * For use with Promise.allSettled to reduce to only successful result values\n * @example <caption>Casting the initialValue provided to reduce</caption>\n * const resolved = Promise.resolve('resolved')\n * const rejected = Promise.reject('rejected')\n * const settled = await Promise.allSettled([resolved, rejected])\n * const results = settled.reduce(fulfilledValues, [] as string[])\n * // results === [ 'resolved' ]\n * @example <caption>Providing type parameter to reduce and initialValue type can be inferred</caption>\n * const resolved = Promise.resolve('resolved')\n * const rejected = Promise.reject('rejected')\n * const settled = await Promise.allSettled([resolved, rejected])\n * const results = settled.reduce<string[]>(fulfilledValues, [])\n * // results === [ 'resolved' ]\n * @param previousValue\n * @param currentValue\n * @returns\n */\nexport const fulfilledValues = <T>(previousValue: T[], currentValue: PromiseSettledResult<T>): T[] => {\n  if (currentValue.status === 'fulfilled') previousValue.push(currentValue.value)\n  return previousValue\n}\n","export type PromiseExSubFunc<T, TResult = T> = (value: T) => TResult\nexport type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void\nexport type PromiseExValueFunc<V> = (value?: V) => boolean\n\nexport class PromiseEx<T, V = void> extends Promise<T> {\n  cancelled?: boolean\n  private _value?: V\n\n  constructor(func: PromiseExFunc<T>, value?: V) {\n    super(func)\n    this._value = value\n  }\n\n  // eslint-disable-next-line unicorn/no-thenable\n  override then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n    onvalue?: (value?: V) => boolean,\n  ): Promise<TResult1 | TResult2> {\n    if (onvalue?.(this._value)) {\n      this.cancelled = true\n    }\n    return super.then(onfulfilled, onrejected)\n  }\n\n  value(onvalue?: (value?: V) => boolean) {\n    if (onvalue?.(this._value)) {\n      this.cancelled = true\n    }\n    return this\n  }\n}\n","/**\n * For use with Promise.allSettled to filter only rejected results\n * @param val\n * @returns\n */\nexport const rejected = <T>(val: PromiseSettledResult<T>): val is PromiseRejectedResult => {\n  return val.status === 'rejected'\n}\n","import type { Promisable } from './types.ts'\n\nexport function toPromise<T>(value: Promisable<T>): Promise<T> {\n  return value instanceof Promise ? value : Promise.resolve(value)\n}\n","export { fulfilled } from './fulfilled.ts'\nexport { fulfilledValues } from './fulfilledValues.ts'\nexport * from './PromiseEx.ts'\nexport { rejected } from './rejected.ts'\nexport * from './toPromise.ts'\nexport * from './types.ts'\nexport { isPromise } from '@xylabs/typeof'\n"],"mappings":";AAKO,IAAM,YAAY,CAAI,QAAmE;AAC9F,SAAO,IAAI,WAAW;AACxB;;;ACWO,IAAM,kBAAkB,CAAI,eAAoB,iBAA+C;AACpG,MAAI,aAAa,WAAW,YAAa,eAAc,KAAK,aAAa,KAAK;AAC9E,SAAO;AACT;;;ACjBO,IAAM,YAAN,cAAqC,QAAW;AAAA,EACrD;AAAA,EACQ;AAAA,EAER,YAAY,MAAwB,OAAW;AAC7C,UAAM,IAAI;AACV,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGS,KACP,aACA,YACA,SAC8B;AAC9B,QAAI,UAAU,KAAK,MAAM,GAAG;AAC1B,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,MAAM,KAAK,aAAa,UAAU;AAAA,EAC3C;AAAA,EAEA,MAAM,SAAkC;AACtC,QAAI,UAAU,KAAK,MAAM,GAAG;AAC1B,WAAK,YAAY;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AACF;;;AC1BO,IAAM,WAAW,CAAI,QAA+D;AACzF,SAAO,IAAI,WAAW;AACxB;;;ACLO,SAAS,UAAa,OAAkC;AAC7D,SAAO,iBAAiB,UAAU,QAAQ,QAAQ,QAAQ,KAAK;AACjE;;;ACEA,SAAS,iBAAiB;","names":[]}
+{"version":3,"sources":["../../src/fulfilled.ts","../../src/fulfilledValues.ts","../../src/PromiseEx.ts","../../src/rejected.ts","../../src/toPromise.ts","../../src/index.ts"],"sourcesContent":["/**\n * For use with Promise.allSettled to filter only successful results\n * @param val\n * @returns\n */\nexport const fulfilled = <T>(val: PromiseSettledResult<T>): val is PromiseFulfilledResult<T> => {\n  return val.status === 'fulfilled'\n}\n","/**\n * For use with Promise.allSettled to reduce to only successful result values\n * @example <caption>Casting the initialValue provided to reduce</caption>\n * const resolved = Promise.resolve('resolved')\n * const rejected = Promise.reject('rejected')\n * const settled = await Promise.allSettled([resolved, rejected])\n * const results = settled.reduce(fulfilledValues, [] as string[])\n * // results === [ 'resolved' ]\n * @example <caption>Providing type parameter to reduce and initialValue type can be inferred</caption>\n * const resolved = Promise.resolve('resolved')\n * const rejected = Promise.reject('rejected')\n * const settled = await Promise.allSettled([resolved, rejected])\n * const results = settled.reduce<string[]>(fulfilledValues, [])\n * // results === [ 'resolved' ]\n * @param previousValue\n * @param currentValue\n * @returns\n */\nexport const fulfilledValues = <T>(previousValue: T[], currentValue: PromiseSettledResult<T>): T[] => {\n  if (currentValue.status === 'fulfilled') previousValue.push(currentValue.value)\n  return previousValue\n}\n","/** A resolve/reject callback used within PromiseEx. */\nexport type PromiseExSubFunc<T, TResult = T> = (value: T) => TResult\n\n/** The executor function passed to the PromiseEx constructor. */\nexport type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void\n\n/** A callback that inspects the attached value and returns whether to cancel the promise. */\nexport type PromiseExValueFunc<V> = (value?: V) => boolean\n\n/**\n * An extended Promise that carries an optional attached value and supports cancellation.\n * The value can be inspected via the `then` or `value` methods to conditionally cancel.\n */\nexport class PromiseEx<T, V = void> extends Promise<T> {\n  /** Whether the promise has been cancelled via a value callback. */\n  cancelled?: boolean\n  private _value?: V\n\n  constructor(func: PromiseExFunc<T>, value?: V) {\n    super(func)\n    this._value = value\n  }\n\n  // eslint-disable-next-line unicorn/no-thenable\n  override then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n    onvalue?: (value?: V) => boolean,\n  ): Promise<TResult1 | TResult2> {\n    if (onvalue?.(this._value)) {\n      this.cancelled = true\n    }\n    return super.then(onfulfilled, onrejected)\n  }\n\n  /**\n   * Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.\n   * @param onvalue - A callback that receives the attached value and returns whether to cancel.\n   * @returns This instance for chaining.\n   */\n  value(onvalue?: (value?: V) => boolean) {\n    if (onvalue?.(this._value)) {\n      this.cancelled = true\n    }\n    return this\n  }\n}\n","/**\n * For use with Promise.allSettled to filter only rejected results\n * @param val\n * @returns\n */\nexport const rejected = <T>(val: PromiseSettledResult<T>): val is PromiseRejectedResult => {\n  return val.status === 'rejected'\n}\n","import type { Promisable } from './types.ts'\n\n/**\n * Wraps a value in a Promise if it is not already one.\n * @param value - A value that may or may not be a Promise.\n * @returns A Promise resolving to the value.\n */\nexport function toPromise<T>(value: Promisable<T>): Promise<T> {\n  return value instanceof Promise ? value : Promise.resolve(value)\n}\n","export { fulfilled } from './fulfilled.ts'\nexport { fulfilledValues } from './fulfilledValues.ts'\nexport * from './PromiseEx.ts'\nexport { rejected } from './rejected.ts'\nexport * from './toPromise.ts'\nexport * from './types.ts'\nexport { isPromise } from '@xylabs/typeof'\n"],"mappings":";AAKO,IAAM,YAAY,CAAI,QAAmE;AAC9F,SAAO,IAAI,WAAW;AACxB;;;ACWO,IAAM,kBAAkB,CAAI,eAAoB,iBAA+C;AACpG,MAAI,aAAa,WAAW,YAAa,eAAc,KAAK,aAAa,KAAK;AAC9E,SAAO;AACT;;;ACRO,IAAM,YAAN,cAAqC,QAAW;AAAA;AAAA,EAErD;AAAA,EACQ;AAAA,EAER,YAAY,MAAwB,OAAW;AAC7C,UAAM,IAAI;AACV,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGS,KACP,aACA,YACA,SAC8B;AAC9B,QAAI,UAAU,KAAK,MAAM,GAAG;AAC1B,WAAK,YAAY;AAAA,IACnB;AACA,WAAO,MAAM,KAAK,aAAa,UAAU;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAkC;AACtC,QAAI,UAAU,KAAK,MAAM,GAAG;AAC1B,WAAK,YAAY;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AACF;;;ACzCO,IAAM,WAAW,CAAI,QAA+D;AACzF,SAAO,IAAI,WAAW;AACxB;;;ACAO,SAAS,UAAa,OAAkC;AAC7D,SAAO,iBAAiB,UAAU,QAAQ,QAAQ,QAAQ,KAAK;AACjE;;;ACHA,SAAS,iBAAiB;","names":[]}

package/dist/neutral/toPromise.d.ts

@@ -1,3 +1,8 @@
 import type { Promisable } from './types.ts';
+/**
+ * Wraps a value in a Promise if it is not already one.
+ * @param value - A value that may or may not be a Promise.
+ * @returns A Promise resolving to the value.
+ */
 export declare function toPromise<T>(value: Promisable<T>): Promise<T>;
 //# sourceMappingURL=toPromise.d.ts.map

package/dist/neutral/toPromise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toPromise.d.ts","sourceRoot":"","sources":["../../src/toPromise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7D"}
+{"version":3,"file":"toPromise.d.ts","sourceRoot":"","sources":["../../src/toPromise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE7D"}

package/dist/neutral/types.d.ts

@@ -1,15 +1,23 @@
 import type { TypedValue } from '@xylabs/typeof';
 import type { PromiseEx } from './PromiseEx.ts';
+/** A value that may be a Promise, PromiseEx, or a plain synchronous value. */
 export type Promisable<T, V = never> = PromiseEx<T, V> | Promise<T> | T;
+/** A Promisable that resolves to an array. */
 export type PromisableArray<T, V = never> = Promisable<T[], V>;
+/** A Promisable that may resolve to undefined. */
 export type OptionalPromisable<T, V = never> = Promisable<T | undefined, V>;
+/** A Promisable array where elements may be undefined. */
 export type OptionalPromisableArray<T, V = never> = PromisableArray<T | undefined, V>;
+/** A Promisable that may resolve to null. */
 export type NullablePromisable<T, V = never> = Promisable<T | null, V>;
+/** A Promisable array where elements may be null. */
 export type NullablePromisableArray<T, V = never> = PromisableArray<T | null, V>;
 /** @description Used to document promises that are being used as Mutexes */
 export type AsyncMutex<T> = Promise<T>;
+/** An interface representing any thenable (promise-like) object. */
 export interface PromiseType {
     then: () => unknown;
 }
+/** Any non-promise typed value, excluding thenables. */
 export type AnyNonPromise = Exclude<TypedValue, PromiseType>;
 //# sourceMappingURL=types.d.ts.map

package/dist/neutral/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACvE,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AAC9D,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAA;AAC3E,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,eAAe,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAA;AACrF,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;AACtE,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,eAAe,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;AAEhF,4EAA4E;AAC5E,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;AAEtC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,8EAA8E;AAC9E,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAEvE,8CAA8C;AAC9C,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;AAE9D,kDAAkD;AAClD,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAA;AAE3E,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,eAAe,CAAC,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC,CAAA;AAErF,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,UAAU,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;AAEtE,qDAAqD;AACrD,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,eAAe,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;AAEhF,4EAA4E;AAC5E,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;AAEtC,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAA;CACpB;AAED,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/promise",
-  "version": "5.0.83",
+  "version": "5.0.86",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "keywords": [
     "promise",
@@ -42,12 +42,12 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@xylabs/typeof": "~5.0.83"
+    "@xylabs/typeof": "~5.0.86"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "~7.4.11",
-    "@xylabs/tsconfig": "~7.4.11",
-    "@xylabs/vitest-extended": "~5.0.83",
+    "@xylabs/ts-scripts-yarn3": "~7.4.16",
+    "@xylabs/tsconfig": "~7.4.16",
+    "@xylabs/vitest-extended": "~5.0.86",
     "typescript": "~5.9.3",
     "vitest": "~4.0.18"
   },