@xylabs/promise 5.0.95 → 5.0.97

package/README.md

@@ -1,69 +1,52 @@
 # @xylabs/promise
 
-[![logo][]](https://xylabs.com)
+[![npm][npm-badge]][npm-link]
+[![license][license-badge]][license-link]
 
-[![main-build][]][main-build-link]
-[![npm-badge][]][npm-link]
-[![npm-downloads-badge][]][npm-link]
-[![jsdelivr-badge][]][jsdelivr-link]
-[![npm-license-badge][]](LICENSE)
-[![codacy-badge][]][codacy-link]
-[![codeclimate-badge][]][codeclimate-link]
-[![snyk-badge][]][snyk-link]
-[![socket-badge][]][socket-link]
+> Base functionality used throughout XY Labs TypeScript/JavaScript libraries
 
+## Install
 
-Base functionality used throughout XY Labs TypeScript/JavaScript libraries
+Using npm:
 
+```sh
+npm install {{name}}
+```
 
+Using yarn:
 
-## Reference
+```sh
+yarn add {{name}}
+```
 
-**@xylabs/promise**
+Using pnpm:
 
-***
+```sh
+pnpm add {{name}}
+```
 
-## Classes
+Using bun:
 
-| 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. |
+```sh
+bun add {{name}}
+```
 
-## Interfaces
 
-| Interface | Description |
-| ------ | ------ |
-| [PromiseType](#interfaces/PromiseType) | An interface representing any thenable (promise-like) object. |
+## License
 
-## Type Aliases
+See the [LICENSE](LICENSE) file for license rights and limitations (LGPL-3.0-only).
 
-| 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. |
+## Reference
 
-## Functions
+### packages
 
-| 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. |
+  ### promise
 
-### classes
+    ### .temp-typedoc
 
-  ### <a id="PromiseEx"></a>PromiseEx
+      ### classes
+
+        ### <a id="PromiseEx"></a>PromiseEx
 
 [**@xylabs/promise**](#../README)
 
@@ -78,25 +61,31 @@ The value can be inspected via the `then` or `value` methods to conditionally ca
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `void` |
+### T
+
+`T`
+
+### V
+
+`V` = `void`
 
 ## Constructors
 
 ### Constructor
 
 ```ts
-new PromiseEx<T, V>(func: PromiseExFunc<T>, value?: V): PromiseEx<T, V>;
+new PromiseEx<T, V>(func, value?): PromiseEx<T, V>;
 ```
 
 ### Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `func` | [`PromiseExFunc`](#../type-aliases/PromiseExFunc)\<`T`\> |
-| `value?` | `V` |
+#### func
+
+[`PromiseExFunc`](#../type-aliases/PromiseExFunc)\<`T`\>
+
+#### value?
+
+`V`
 
 ### Returns
 
@@ -110,9 +99,13 @@ Promise<T>.constructor
 
 ## Properties
 
-| Property | Type | Description |
-| ------ | ------ | ------ |
-| <a id="cancelled"></a> `cancelled?` | `boolean` | Whether the promise has been cancelled via a value callback. |
+### cancelled?
+
+```ts
+optional cancelled?: boolean;
+```
+
+Whether the promise has been cancelled via a value callback.
 
 ## Methods
 
@@ -120,29 +113,40 @@ Promise<T>.constructor
 
 ```ts
 then<TResult1, TResult2>(
-   onfulfilled?: (value: T) => TResult1 | PromiseLike<TResult1> | null, 
-   onrejected?: 
-  | (reason: unknown) => TResult2 | PromiseLike<TResult2>
-  | null, 
-onvalue?: (value?: V) => boolean): Promise<TResult1 | TResult2>;
+   onfulfilled?, 
+   onrejected?, 
+onvalue?): Promise<TResult1 | TResult2>;
 ```
 
 Attaches callbacks for the resolution and/or rejection of the Promise.
 
 ### Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `TResult1` | `T` |
-| `TResult2` | `never` |
+#### TResult1
+
+`TResult1` = `T`
+
+#### TResult2
+
+`TResult2` = `never`
 
 ### Parameters
 
-| 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` | - |
+#### onfulfilled?
+
+((`value`) => `TResult1` \| `PromiseLike`\<`TResult1`\>) \| `null`
+
+The callback to execute when the Promise is resolved.
+
+#### onrejected?
+
+((`reason`) => `TResult2` \| `PromiseLike`\<`TResult2`\>) \| `null`
+
+The callback to execute when the Promise is rejected.
+
+#### onvalue?
+
+(`value?`) => `boolean`
 
 ### Returns
 
@@ -161,16 +165,18 @@ Promise.then
 ### value()
 
 ```ts
-value(onvalue?: (value?: V) => boolean): PromiseEx<T, V>;
+value(onvalue?): PromiseEx<T, V>;
 ```
 
 Inspects the attached value via the callback; if it returns true, marks the promise as cancelled.
 
 ### Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `onvalue?` | (`value?`: `V`) => `boolean` | A callback that receives the attached value and returns whether to cancel. |
+#### onvalue?
+
+(`value?`) => `boolean`
+
+A callback that receives the attached value and returns whether to cancel.
 
 ### Returns
 
@@ -178,60 +184,63 @@ Inspects the attached value via the callback; if it returns true, marks the prom
 
 This instance for chaining.
 
-### functions
+      ### functions
 
-  ### <a id="fulfilled"></a>fulfilled
+        ### <a id="fulfilled"></a>fulfilled
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-function fulfilled<T>(val: PromiseSettledResult<T>): val is PromiseFulfilledResult<T>;
+function fulfilled<T>(val): val is PromiseFulfilledResult<T>;
 ```
 
 For use with Promise.allSettled to filter only successful results
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `val` | `PromiseSettledResult`\<`T`\> | - |
+### val
+
+`PromiseSettledResult`\<`T`\>
 
 ## Returns
 
 `val is PromiseFulfilledResult<T>`
 
-  ### <a id="fulfilledValues"></a>fulfilledValues
+        ### <a id="fulfilledValues"></a>fulfilledValues
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-function fulfilledValues<T>(previousValue: T[], currentValue: PromiseSettledResult<T>): T[];
+function fulfilledValues<T>(previousValue, currentValue): T[];
 ```
 
 For use with Promise.allSettled to reduce to only successful result values
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `previousValue` | `T`[] | - |
-| `currentValue` | `PromiseSettledResult`\<`T`\> | - |
+### previousValue
+
+`T`[]
+
+### currentValue
+
+`PromiseSettledResult`\<`T`\>
 
 ## Returns
 
@@ -255,105 +264,59 @@ const results = settled.reduce<string[]>(fulfilledValues, [])
 // results === [ 'resolved' ]
 ```
 
-  ### <a id="isPromise"></a>isPromise
-
-[**@xylabs/promise**](#../README)
-
-***
-
-## Call Signature
-
-```ts
-function isPromise(value: unknown): value is Promise<unknown>;
-```
-
-Type guard that checks whether a value is a Promise instance.
-
-### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `unknown` |
-
-### Returns
-
-`value is Promise<unknown>`
-
-## Call Signature
-
-```ts
-function isPromise<T>(value: T): value is Extract<T, Promise<unknown>>;
-```
-
-Type guard that checks whether a value is a Promise instance.
-
-### Type Parameters
-
-| Type Parameter |
-| ------ |
-| `T` |
-
-### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `T` |
-
-### Returns
-
-`value is Extract<T, Promise<unknown>>`
-
-  ### <a id="rejected"></a>rejected
+        ### <a id="rejected"></a>rejected
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-function rejected<T>(val: PromiseSettledResult<T>): val is PromiseRejectedResult;
+function rejected<T>(val): val is PromiseRejectedResult;
 ```
 
 For use with Promise.allSettled to filter only rejected results
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `val` | `PromiseSettledResult`\<`T`\> | - |
+### val
+
+`PromiseSettledResult`\<`T`\>
 
 ## Returns
 
 `val is PromiseRejectedResult`
 
-  ### <a id="toPromise"></a>toPromise
+        ### <a id="toPromise"></a>toPromise
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-function toPromise<T>(value: Promisable<T>): Promise<T>;
+function toPromise<T>(value): Promise<T>;
 ```
 
 Wraps a value in a Promise if it is not already one.
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Parameters
 
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `value` | [`Promisable`](#../type-aliases/Promisable)\<`T`\> | A value that may or may not be a Promise. |
+### value
+
+[`Promisable`](#../type-aliases/Promisable)\<`T`\>
+
+A value that may or may not be a Promise.
 
 ## Returns
 
@@ -361,9 +324,9 @@ Wraps a value in a Promise if it is not already one.
 
 A Promise resolving to the value.
 
-### interfaces
+      ### interfaces
 
-  ### <a id="PromiseType"></a>PromiseType
+        ### <a id="PromiseType"></a>PromiseType
 
 [**@xylabs/promise**](#../README)
 
@@ -373,13 +336,19 @@ An interface representing any thenable (promise-like) object.
 
 ## Properties
 
-| Property | Type |
-| ------ | ------ |
-| <a id="then"></a> `then` | () => `unknown` |
+### then
+
+```ts
+then: () => unknown;
+```
+
+### Returns
+
+`unknown`
 
-### type-aliases
+      ### type-aliases
 
-  ### <a id="AnyNonPromise"></a>AnyNonPromise
+        ### <a id="AnyNonPromise"></a>AnyNonPromise
 
 [**@xylabs/promise**](#../README)
 
@@ -391,7 +360,7 @@ type AnyNonPromise = Exclude<TypedValue, PromiseType>;
 
 Any non-promise typed value, excluding thenables.
 
-  ### <a id="AsyncMutex"></a>AsyncMutex
+        ### <a id="AsyncMutex"></a>AsyncMutex
 
 [**@xylabs/promise**](#../README)
 
@@ -403,15 +372,15 @@ type AsyncMutex<T> = Promise<T>;
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Description
 
 Used to document promises that are being used as Mutexes
 
-  ### <a id="NullablePromisable"></a>NullablePromisable
+        ### <a id="NullablePromisable"></a>NullablePromisable
 
 [**@xylabs/promise**](#../README)
 
@@ -425,12 +394,15 @@ A Promisable that may resolve to null.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
+
+`T`
+
+### V
+
+`V` = `never`
 
-  ### <a id="NullablePromisableArray"></a>NullablePromisableArray
+        ### <a id="NullablePromisableArray"></a>NullablePromisableArray
 
 [**@xylabs/promise**](#../README)
 
@@ -444,12 +416,15 @@ A Promisable array where elements may be null.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
 
-  ### <a id="OptionalPromisable"></a>OptionalPromisable
+`T`
+
+### V
+
+`V` = `never`
+
+        ### <a id="OptionalPromisable"></a>OptionalPromisable
 
 [**@xylabs/promise**](#../README)
 
@@ -463,12 +438,15 @@ A Promisable that may resolve to undefined.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
+
+`T`
 
-  ### <a id="OptionalPromisableArray"></a>OptionalPromisableArray
+### V
+
+`V` = `never`
+
+        ### <a id="OptionalPromisableArray"></a>OptionalPromisableArray
 
 [**@xylabs/promise**](#../README)
 
@@ -482,12 +460,15 @@ A Promisable array where elements may be undefined.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
+
+`T`
 
-  ### <a id="Promisable"></a>Promisable
+### V
+
+`V` = `never`
+
+        ### <a id="Promisable"></a>Promisable
 
 [**@xylabs/promise**](#../README)
 
@@ -501,12 +482,15 @@ A value that may be a Promise, PromiseEx, or a plain synchronous value.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
+
+`T`
+
+### V
 
-  ### <a id="PromisableArray"></a>PromisableArray
+`V` = `never`
+
+        ### <a id="PromisableArray"></a>PromisableArray
 
 [**@xylabs/promise**](#../README)
 
@@ -520,133 +504,108 @@ A Promisable that resolves to an array.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `V` | `never` |
+### T
+
+`T`
+
+### V
+
+`V` = `never`
 
-  ### <a id="PromiseExFunc"></a>PromiseExFunc
+        ### <a id="PromiseExFunc"></a>PromiseExFunc
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-type PromiseExFunc<T> = (resolve?: PromiseExSubFunc<T, void>, reject?: PromiseExSubFunc<T, void>) => void;
+type PromiseExFunc<T> = (resolve?, reject?) => void;
 ```
 
 The executor function passed to the PromiseEx constructor.
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `T` |
+### T
+
+`T`
 
 ## Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `resolve?` | [`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\> |
-| `reject?` | [`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\> |
+### resolve?
+
+[`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\>
+
+### reject?
+
+[`PromiseExSubFunc`](#PromiseExSubFunc)\<`T`, `void`\>
 
 ## Returns
 
 `void`
 
-  ### <a id="PromiseExSubFunc"></a>PromiseExSubFunc
+        ### <a id="PromiseExSubFunc"></a>PromiseExSubFunc
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-type PromiseExSubFunc<T, TResult> = (value: T) => TResult;
+type PromiseExSubFunc<T, TResult> = (value) => TResult;
 ```
 
 A resolve/reject callback used within PromiseEx.
 
 ## Type Parameters
 
-| Type Parameter | Default type |
-| ------ | ------ |
-| `T` | - |
-| `TResult` | `T` |
+### T
+
+`T`
+
+### TResult
+
+`TResult` = `T`
 
 ## Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value` | `T` |
+### value
+
+`T`
 
 ## Returns
 
 `TResult`
 
-  ### <a id="PromiseExValueFunc"></a>PromiseExValueFunc
+        ### <a id="PromiseExValueFunc"></a>PromiseExValueFunc
 
 [**@xylabs/promise**](#../README)
 
 ***
 
 ```ts
-type PromiseExValueFunc<V> = (value?: V) => boolean;
+type PromiseExValueFunc<V> = (value?) => boolean;
 ```
 
 A callback that inspects the attached value and returns whether to cancel the promise.
 
 ## Type Parameters
 
-| Type Parameter |
-| ------ |
-| `V` |
+### V
+
+`V`
 
 ## Parameters
 
-| Parameter | Type |
-| ------ | ------ |
-| `value?` | `V` |
+### value?
+
+`V`
 
 ## Returns
 
 `boolean`
 
 
-Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
-
-## Maintainers
-
--   [Arie Trouw](https://github.com/arietrouw) ([arietrouw.com](https://arietrouw.com))
--   [Matt Jones](https://github.com/jonesmac)
--   [Joel Carter](https://github.com/JoelBCarter)
--   [Jordan Trouw](https://github.com/jordantrouw)
-
-## License
-
-> See the [LICENSE](LICENSE) file for license details
-
-## Credits
-
-[Made with 🔥 and ❄️ by XYLabs](https://xylabs.com)
-
-[logo]: https://cdn.xy.company/img/brand/XYPersistentCompany_Logo_Icon_Colored.svg
-
-[main-build]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml/badge.svg
-[main-build-link]: https://github.com/xylabs/sdk-js/actions/workflows/build.yml
 [npm-badge]: https://img.shields.io/npm/v/@xylabs/promise.svg
 [npm-link]: https://www.npmjs.com/package/@xylabs/promise
-[codacy-badge]: https://app.codacy.com/project/badge/Grade/c8e15e14f37741c18cfb47ac7245c698
-[codacy-link]: https://www.codacy.com/gh/xylabs/sdk-js/dashboard?utm_source=github.com&utm_medium=referral&utm_content=xylabs/sdk-js&utm_campaign=Badge_Grade
-[codeclimate-badge]: https://api.codeclimate.com/v1/badges/c5eb068f806f0b047ea7/maintainability
-[codeclimate-link]: https://codeclimate.com/github/xylabs/sdk-js/maintainability
-[snyk-badge]: https://snyk.io/test/github/xylabs/sdk-js/badge.svg?targetFile=package.json
-[snyk-link]: https://snyk.io/test/github/xylabs/sdk-js?targetFile=package.json
-
-[npm-downloads-badge]: https://img.shields.io/npm/dw/@xylabs/promise
-[npm-license-badge]: https://img.shields.io/npm/l/@xylabs/promise
-
-[jsdelivr-badge]: https://data.jsdelivr.com/v1/package/npm/@xylabs/promise/badge
-[jsdelivr-link]: https://www.jsdelivr.com/package/npm/@xylabs/promise
-
-[socket-badge]: https://socket.dev/api/badge/npm/package/@xylabs/promise
-[socket-link]: https://socket.dev/npm/package/@xylabs/promise
+[license-badge]: https://img.shields.io/npm/l/@xylabs/promise.svg
+[license-link]: https://github.com/xylabs/sdk-js/blob/main/LICENSE

package/dist/neutral/index.d.ts

@@ -1,5 +1,4 @@
 import { TypedValue } from '@xylabs/typeof';
-export { isPromise } from '@xylabs/typeof';
 
 /**
  * For use with Promise.allSettled to filter only successful results

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/dist/neutral/index.mjs

@@ -47,14 +47,10 @@ var rejected = (val) => {
 function toPromise(value) {
   return value instanceof Promise ? value : Promise.resolve(value);
 }
-
-// src/index.ts
-import { isPromise } from "@xylabs/typeof";
 export {
   PromiseEx,
   fulfilled,
   fulfilledValues,
-  isPromise,
   rejected,
   toPromise
 };

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","/** 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":[]}
+{"version":3,"sources":["../../src/fulfilled.ts","../../src/fulfilledValues.ts","../../src/PromiseEx.ts","../../src/rejected.ts","../../src/toPromise.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"],"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;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/promise",
-  "version": "5.0.95",
+  "version": "5.0.97",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "keywords": [
     "promise",
@@ -29,12 +29,10 @@
   "exports": {
     ".": {
       "types": "./dist/neutral/index.d.ts",
-      "import": "./dist/neutral/index.mjs",
       "default": "./dist/neutral/index.mjs"
     },
     "./package.json": "./package.json"
   },
-  "types": "./dist/neutral/index.d.ts",
   "files": [
     "dist",
     "!**/*.bench.*",
@@ -43,19 +41,18 @@
     "README.md"
   ],
   "dependencies": {
-    "@xylabs/typeof": "~5.0.95"
+    "@xylabs/typeof": "~5.0.97"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
-    "@xylabs/ts-scripts-common": "~7.8.4",
-    "@xylabs/ts-scripts-pnpm": "~7.8.4",
-    "@xylabs/tsconfig": "~7.8.4",
+    "@types/node": "^25.6.0",
+    "@xylabs/toolchain": "~7.10.4",
+    "@xylabs/tsconfig": "~7.10.4",
     "esbuild": "^0.28.0",
     "typescript": "^5",
-    "vite": "^8.0.5",
-    "vitest": "^4.1.2",
-    "@xylabs/vitest-extended": "~5.0.95",
-    "@xylabs/vitest-matchers": "~5.0.95"
+    "vite": "^8.0.8",
+    "vitest": "^4.1.4",
+    "@xylabs/vitest-extended": "~5.0.97",
+    "@xylabs/vitest-matchers": "~5.0.97"
   },
   "engines": {
     "node": ">=18"