@oscarpalmer/atoms 0.186.2 → 0.187.0

package/dist/logger.d.mts

@@ -46,16 +46,17 @@ declare class Logger {
    */
   get warn(): typeof console.warn;
   /**
-   * Start a logged timer with a label
-   * @param label Label for the timer
-   * @returns Time instance
+   * Start a timed logger with a label
+   *
+   * @param label Label for the logger
+   * @returns _Timed_ instance
    */
-  time(label: string): Time;
+  time(label: string): Timed;
 }
 /**
  * A named timer that can be used to log durations to the console
  */
-declare class Time {
+declare class Timed {
   #private;
   /**
    * Is the timer active? _(i.e. has it been started and not stopped, and is logging enabled?)_
@@ -75,4 +76,4 @@ declare class Time {
 }
 declare const logger: Logger;
 //#endregion
-export { type Logger, type Time, logger };
+export { type Logger, type Timed, logger };

package/dist/logger.mjs

@@ -67,18 +67,19 @@ var Logger = class {
 		return enabled ? console.warn : noop;
 	}
 	/**
-	* Start a logged timer with a label
-	* @param label Label for the timer
-	* @returns Time instance
+	* Start a timed logger with a label
+	*
+	* @param label Label for the logger
+	* @returns _Timed_ instance
 	*/
 	time(label) {
-		return new Time(label);
+		return new Timed(label);
 	}
 };
 /**
 * A named timer that can be used to log durations to the console
 */
-var Time = class {
+var Timed = class {
 	#logger;
 	#stopper;
 	#state;

package/dist/math.d.mts

@@ -4,125 +4,143 @@ import { max } from "./internal/math/aggregate.mjs";
 //#region src/math.d.ts
 /**
  * Get the average value from a list of items
+ *
  * @param items List of items
  * @param callback Callback to get an item's value
- * @returns Average value, or `NaN` if no average can be calculated
+ * @returns Average value, or `Number.NaN` if no average can be calculated
  */
 declare function average<Item>(items: Item[], callback: (item: Item, index: number, array: Item[]) => number): number;
 /**
  * Get the average value from a list of items
+ *
  * @param items List of items
  * @param key Key to use for value
- * @returns Average value, or `NaN` if no average can be calculated
+ * @returns Average value, or `Number.NaN` if no average can be calculated
  */
 declare function average<Item extends PlainObject>(items: Item[], key: keyof NumericalValues<Item>): number;
 /**
  * Get the average value from a list of numbers
+ *
  * @param numbers List of numbers
- * @returns Average value, or `NaN` if no average can be calculated
+ * @returns Average value, or `Number.NaN` if no average can be calculated
  */
 declare function average(numbers: number[]): number;
 /**
  * Round a number up
+ *
  * @param value Number to round up
  * @param decimals Number of decimal places to round to _(defaults to `0`)_
- * @returns Rounded number, or `NaN` if the value if unable to be rounded
+ * @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
  */
 declare function ceil(value: number, decimals?: number): number;
 /**
  * Count the number of items in an array that match a specific value
+ *
  * @param array Array to count for
  * @param callback Callback to get an item's value
  * @param value Value to match and count
- * @returns Number of items that match the condition, or `NaN` if no count can be calculated
+ * @returns Number of items that match the condition, or `Number.NaN` if no count can be calculated
  */
 declare function count<Item>(array: Item[], callback: (item: Item, index: number, array: Item[]) => unknown, value: unknown): number;
 /**
  * Count the number of items in an array that have a specific value
+ *
  * @param array Array to count for
  * @param key Key to use for value
  * @param value Value to match and count
- * @returns Number of items with the specified key value, or `NaN` if no count can be calculated
+ * @returns Number of items with the specified key value, or `Number.NaN` if no count can be calculated
  */
 declare function count<Item extends PlainObject, ItemKey extends keyof Item>(array: Item[], key: ItemKey, value: Item[ItemKey]): number;
 /**
  * Count the number of items in an array
+ *
  * @param values Array to count for
- * @returns Number of items, or `NaN` if no count can be calculated
+ * @returns Number of items, or `Number.NaN` if no count can be calculated
  */
 declare function count(values: unknown[]): number;
 /**
  * Round a number down
+ *
  * @param value Number to round down
  * @param decimals Number of decimal places to round to _(defaults to `0`)_
- * @returns Rounded number, or `NaN` if the value if unable to be rounded
+ * @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
  */
 declare function floor(value: number, decimals?: number): number;
 /**
  * Get the median value from a list of items
+ *
  * @param array List of items
  * @param callback Callback to get an item's value
- * @returns Median value, or `NaN` if no median can be calculated
+ * @returns Median value, or `Number.NaN` if no median can be calculated
  */
 declare function median<Item>(array: Item[], callback: (item: Item, index: number, array: Item[]) => number): number;
 /**
  * Get the median value from a list of items
+ *
  * @param array List of items
  * @param key Key to use for value
- * @returns Median value, or `NaN` if no median can be calculated
+ * @returns Median value, or `Number.NaN` if no median can be calculated
  */
 declare function median<Item extends PlainObject>(array: Item[], key: keyof NumericalValues<Item>): number;
 /**
  * Get the median value from a list of numbers
+ *
  * @param array List of numbers
- * @returns Median value, or `NaN` if no median can be calculated
+ * @returns Median value, or `Number.NaN` if no median can be calculated
  */
 declare function median(array: number[]): number;
 /**
  * Get the minimum value from a list of items
+ *
  * @param items List of items
  * @param callback Callback to get an item's value
- * @returns Minimum value, or `NaN` if no minimum can be found
+ * @returns Minimum value, or `Number.NaN` if no minimum can be found
  */
 declare function min<Item>(items: Item[], callback: (item: Item, index: number, array: Item[]) => number): number;
 /**
  * Get the minimum value from a list of items
+ *
  * @param items List of items
  * @param key Key to use for value
- * @returns Minimum value, or `NaN` if no minimum can be found
+ * @returns Minimum value, or `Number.NaN` if no minimum can be found
  */
 declare function min<Item extends PlainObject>(items: Item[], key: keyof NumericalValues<Item>): number;
 /**
  * Get the minimum value from a list of numbers
+ *
  * @param values List of numbers
- * @returns Minimum value, or `NaN` if no minimum can be found
+ * @returns Minimum value, or `Number.NaN` if no minimum can be found
  */
 declare function min(values: number[]): number;
 /**
  * Round a number
+ *
  * @param value Number to round
  * @param decimals Number of decimal places to round to _(defaults to `0`)_
- * @returns Rounded number, or `NaN` if the value if unable to be rounded
+ * @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
  */
 declare function round(value: number, decimals?: number): number;
 /**
  * Get the sum of a list of items
+ *
  * @param items List of items
  * @param callback Callback to get an item's value
- * @returns Sum of the values, or `NaN` if no sum can be calculated
+ * @returns Sum of the values, or `Number.NaN` if no sum can be calculated
  */
 declare function sum<Item>(items: Item[], callback: (item: Item, index: number, array: Item[]) => number): number;
 /**
  * Get the sum of a list of items
+ *
  * @param items List of items
  * @param key Key to use for value
- * @returns Sum of the values, or `NaN` if no sum can be calculated
+ * @returns Sum of the values, or `Number.NaN` if no sum can be calculated
  */
 declare function sum<Item extends PlainObject>(items: Item[], key: keyof NumericalValues<Item>): number;
 /**
  * Get the sum of a list of numbers
+ *
  * @param values List of numbers
- * @returns Sum of the numbers, or `NaN` if no sum can be calculated
+ * @returns Sum of the numbers, or `Number.NaN` if no sum can be calculated
  */
 declare function sum(values: number[]): number;
 //#endregion

package/dist/math.mjs

@@ -7,9 +7,10 @@ function average(array, key) {
 }
 /**
 * Round a number up
+*
 * @param value Number to round up
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function ceil(value, decimals) {
 	return roundNumber(Math.ceil, value, decimals);
@@ -28,9 +29,10 @@ function count(array, key, value) {
 }
 /**
 * Round a number down
+*
 * @param value Number to round down
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function floor(value, decimals) {
 	return roundNumber(Math.floor, value, decimals);
@@ -56,9 +58,10 @@ function min(array, key) {
 }
 /**
 * Round a number
+*
 * @param value Number to round
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function round(value, decimals) {
 	return roundNumber(Math.round, value, decimals);

package/dist/models.d.mts

@@ -15,7 +15,7 @@ type AsyncCancelableCallback<Callback extends GenericAsyncCallback | GenericCall
 /**
  * For matching any `void`, `Date`, primitive, or `RegExp` values
  *
- * (Thanks, type-fest!)
+ * _(Thanks, type-fest!)_
  */
 type BuiltIns = void | Date | Primitive | RegExp;
 /**
@@ -70,7 +70,7 @@ type NestedPartial<Value> = { [ItemKey in keyof Value]?: Value[ItemKey] extends
 type NestedValue<Value extends PlainObject, Path extends string> = _NestedValue<Value, Path>;
 type _NestedValue<Value, Path extends string> = Path extends `${infer ItemKey}.${infer Rest}` ? ItemKey extends keyof Value ? undefined extends Value[ItemKey] ? _NestedValue<Exclude<Value[ItemKey], undefined>, Rest> | undefined : _NestedValue<Value[ItemKey], Rest> : ItemKey extends `${number}` ? Value extends readonly any[] ? _NestedValue<Value[number], Rest> : never : never : Path extends `${number}` ? Value extends readonly any[] ? Value[number] : never : Path extends keyof Value ? Value[Path] : never;
 /**
- * The nested (keyed) values of an object _(up to 5 levels deep)_
+ * The nested _(keyed)_ values of an object _(up to 5 levels deep)_
  */
 type NestedValues<Value extends PlainObject> = { [Path in NestedKeys<Value>]: NestedValue<Value, Path> };
 /**
@@ -150,7 +150,7 @@ type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint
  * ```typescript
  * type A = {a: string};
  * type B = {b: number};
- * type C = UnionToIntersection<A | B>; // {a: string} & {b: number}
+ * type C = UnionToIntersection<A | B>; // => {a: string} & {b: number}
  * ```
  *
  * Thanks, type-fest!

package/dist/promise/delay.d.mts

@@ -3,12 +3,14 @@ import { PromiseOptions } from "./models.mjs";
 //#region src/promise/delay.d.ts
 /**
  * Create a delayed promise that resolves after a certain amount of time, or rejects if aborted
+ *
  * @param options Options for the delay
  * @returns Delayed promise
  */
 declare function delay(options?: PromiseOptions): Promise<void>;
 /**
  * Create a delayed promise that resolves after a certain amount of time
+ *
  * @param time How long to wait for _(in milliseconds; defaults to `0`)_
  * @returns Delayed promise
  */

package/dist/promise/helpers.d.mts

@@ -8,15 +8,17 @@ declare function getPromisesOptions(input: unknown): RequiredKeys<PromisesOption
 declare function getResultsFromPromises<Value>(promised: PromisesValue<Value>[]): Result<Value>[];
 declare function getStrategyOrDefault(value: unknown): PromiseStrategy;
 /**
- * Is the value a fulfilled promise result?
+ * Is the value a fulfilled _Promise_ result?
+ *
  * @param value Value to check
- * @returns `true` if the value is a fulfilled promise result, `false` otherwise
+ * @returns `true` if the value is a fulfilled _Promise_ result, `false` otherwise
  */
 declare function isFulfilled<Value>(value: unknown): value is FulfilledPromise<Value>;
 /**
- * Is the value a rejected promise result?
+ * Is the value a rejected _Promise_ result?
+ *
  * @param value Value to check
- * @returns `true` if the value is a rejected promise result, `false` otherwise
+ * @returns `true` if the value is a rejected _Promise_ result, `false` otherwise
  */
 declare function isRejected(value: unknown): value is RejectedPromise;
 //#endregion

package/dist/promise/helpers.mjs

@@ -33,17 +33,19 @@ function getStrategyOrDefault(value) {
 	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;
 }
 /**
-* Is the value a fulfilled promise result?
+* Is the value a fulfilled _Promise_ result?
+*
 * @param value Value to check
-* @returns `true` if the value is a fulfilled promise result, `false` otherwise
+* @returns `true` if the value is a fulfilled _Promise_ result, `false` otherwise
 */
 function isFulfilled(value) {
 	return isType(value, PROMISE_TYPE_FULFILLED);
 }
 /**
-* Is the value a rejected promise result?
+* Is the value a rejected _Promise_ result?
+*
 * @param value Value to check
-* @returns `true` if the value is a rejected promise result, `false` otherwise
+* @returns `true` if the value is a rejected _Promise_ result, `false` otherwise
 */
 function isRejected(value) {
 	return isType(value, PROMISE_TYPE_REJECTED);

package/dist/promise/index.d.mts

@@ -3,73 +3,82 @@ import { PromiseOptions, PromisesItems, PromisesOptions, PromisesResult, Promise
 
 //#region src/promise/index.d.ts
 /**
- * Wrap a promise with safety handlers, with optional abort capabilities and timeout
- * @param promise Promise to wrap
- * @param options Options for the promise
- * @returns Wrapped promise
+ * Wrap a _Promise_ with safety handlers, with optional abort capabilities and timeout
+ *
+ * @param promise _Promise_ to wrap
+ * @param options Options for the _Promise_
+ * @returns Wrapped _Promise_
  */
 declare function attemptPromise<Value>(promise: Promise<Value>, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
 /**
- * Wrap a promise-returning callback with safety handlers, with optional abort capabilities and timeout
+ * Wrap a _Promise_-returning callback with safety handlers, with optional abort capabilities and timeout
+ *
  * @param callback Callback to wrap
- * @param options Options for the promise
- * @returns Promise-wrapped callback
+ * @param options Options for the _Promise_
+ * @returns _Promise_-wrapped callback
  */
 declare function attemptPromise<Value>(callback: () => Promise<Value>, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
 /**
- * Wrap a callback with a promise and safety handlers, with optional abort capabilities and timeout
+ * Wrap a callback with a _Promise_ and safety handlers, with optional abort capabilities and timeout
+ *
  * @param callback Callback to wrap
- * @param options Options for the promise
- * @returns Promise-wrapped callback
+ * @param options Options for the _Promise_
+ * @returns _Promise_-wrapped callback
  */
 declare function attemptPromise<Value>(callback: () => Value, options?: PromiseOptions | AbortSignal | number): Promise<Value>;
 /**
- * Handle a list of promises, returning their results in an ordered array.
+ * Handle a list of _Promises_, returning their results in an ordered array
  *
  * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
- * @param items List of promises
- * @param options Options for handling the promises
+ *
+ * @param items List of _Promises_
+ * @param options Options for handling the _Promises_
  * @returns List of results
  */
 declare function promises<Items extends unknown[], Options extends PromisesOptions>(items: [...Items], options?: Options): Promise<Options['strategy'] extends 'first' ? PromisesUnwrapped<Items> : PromisesValues<PromisesItems<Items>>>;
 /**
- * Handle a list of promises, returning their results in an ordered array.
+ * Handle a list of _Promises_, returning their results in an ordered array
  *
  * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
- * @param items List of promises
- * @param options Options for handling the promises
+ *
+ * @param items List of _Promises_
+ * @param options Options for handling the _Promises_
  * @returns List of results
  */
 declare function promises<Value, Options extends PromisesOptions>(items: Promise<Value>[], options?: Options): Promise<Options['strategy'] extends 'first' ? Value[] : PromisesValue<Value>[]>;
 /**
- * Handle a list of promises, returning their results in an ordered array.
+ * Handle a list of _Promises_, returning their results in an ordered array
+ *
+ * If any _Promise_ in the list is rejected, the whole function will reject
  *
- * If any promise in the list is rejected, the whole function will reject
- * @param items List of promises
- * @param strategy Strategy for handling the promises; rejects on the first error encountered
+ * @param items List of _Promises_
+ * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
  * @returns List of results
  */
 declare function promises<Items extends unknown[]>(items: [...Items], strategy: 'first'): Promise<PromisesUnwrapped<Items>>;
 /**
- * Handle a list of promises, returning their results in an ordered array.
+ * Handle a list of _Promises_, returning their results in an ordered array
  *
- * If any promise in the list is rejected, the whole function will reject
- * @param items List of promises
- * @param strategy Strategy for handling the promises; rejects on the first error encountered
+ * If any _Promise_ in the list is rejected, the whole function will reject
+ *
+ * @param items List of _Promises_
+ * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
  * @returns List of results
  */
 declare function promises<Value>(items: Promise<Value>[], strategy: 'first'): Promise<Value[]>;
 /**
- * Handle a list of promises, returning their results in an ordered array of rejected and resolved results
- * @param items List of promises
- * @param signal AbortSignal for aborting the operation _(when aborted, the promise will reject with the reason of the signal)_
+ * Handle a list of _Promises_, returning their results in an ordered array of rejected and resolved results
+ *
+ * @param items List of _Promises_
+ * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
  * @returns List of results
  */
 declare function promises<Items extends unknown[]>(items: [...Items], signal?: AbortSignal): Promise<PromisesValues<PromisesItems<Items>>>;
 /**
- * Handle a list of promises, returning their results in an ordered array of rejected and resolved results
- * @param items List of promises
- * @param signal AbortSignal for aborting the operation _(when aborted, the promise will reject with the reason of the signal)_
+ * Handle a list of _Promises_, returning their results in an ordered array of rejected and resolved results
+ *
+ * @param items List of _Promises_
+ * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
  * @returns List of results
  */
 declare function promises<Value>(items: Array<Promise<Value> | (() => Promise<Value>)>, signal?: AbortSignal): Promise<PromisesValue<Value>[]>;
@@ -77,24 +86,26 @@ declare namespace promises {
   var result: typeof resultPromises;
 }
 /**
- * Handle a list of promises, returning their results in an ordered array of results _({@link Result})_.
+ * Handle a list of _Promises_, returning their results in an ordered array of results _({@link Result})_
  *
  * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
  *
- * Available as `resultPromises` and `promises.result`
- * @param items List of promises
- * @param signal AbortSignal for aborting the operation _(when aborted, the promise will reject with the reason of the signal)_
+ * _Available as `resultPromises` and `promises.result`_
+ *
+ * @param items List of _Promises_
+ * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
  * @returns List of results
  */
 declare function resultPromises<Items extends unknown[]>(items: [...Items], signal?: AbortSignal): Promise<PromisesResult<PromisesItems<Items>>>;
 /**
- * Handle a list of promises, returning their results in an ordered array of results _({@link Result})_.
+ * Handle a list of _Promises_, returning their results in an ordered array of results _({@link Result})_
  *
  * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
  *
- * Available as `resultPromises` and `promises.result`
- * @param items List of promises
- * @param signal AbortSignal for aborting the operation _(when aborted, the promise will reject with the reason of the signal)_
+ * _Available as `resultPromises` and `promises.result`_
+ *
+ * @param items List of _Promises_
+ * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
  * @returns List of results
  */
 declare function resultPromises<Value>(items: Promise<Value>[], signal?: AbortSignal): Promise<Result<Awaited<Value>>[]>;

package/dist/promise/misc.d.mts

@@ -5,22 +5,25 @@ import { isFulfilled, isRejected } from "./helpers.mjs";
 
 //#region src/promise/misc.d.ts
 /**
- * Create a cancelable promise
- * @param executor Executor function for the promise
- * @returns Cancelable promise
+ * Create a cancelable _Promise_
+ *
+ * @param executor Executor function for the _Promise_
+ * @returns Cancelable _Promise_
  */
 declare function cancelable<Value>(executor: (resolve: (value: Value) => void, reject: (reason: unknown) => void) => void): CancelablePromise<Value>;
 declare function handleResult(status: string, parameters: PromiseParameters): void;
 declare function settlePromise(aborter: () => void, settler: (value: any) => void, value: unknown, signal?: AbortSignal): void;
 /**
- * Converts a promise to a promised result
- * @param callback Promise callback
+ * Converts a _Promise_ to a promised result
+ *
+ * @param callback _Promise_ callback
  * @returns Promised result
  */
 declare function toResult<Value>(callback: () => Promise<Value>): Promise<Result<Value>>;
 /**
- * Converts a promise to a promised result
- * @param promise Promise to convert
+ * Converts a _Promise_ to a promised result
+ *
+ * @param promise _Promise_ to convert
  * @returns Promised result
  */
 declare function toResult<Value>(promise: Promise<Value>): Promise<Result<Value>>;

package/dist/promise/misc.mjs

@@ -3,9 +3,10 @@ import { CancelablePromise, PROMISE_ABORT_EVENT, PROMISE_MESSAGE_EXPECTATION_RES
 import { isFulfilled, isRejected } from "./helpers.mjs";
 //#region src/promise/misc.ts
 /**
-* Create a cancelable promise
-* @param executor Executor function for the promise
-* @returns Cancelable promise
+* Create a cancelable _Promise_
+*
+* @param executor Executor function for the _Promise_
+* @returns Cancelable _Promise_
 */
 function cancelable(executor) {
 	return new CancelablePromise(executor);

package/dist/promise/models.d.mts

@@ -3,27 +3,28 @@ import { Result } from "../result/models.mjs";
 
 //#region src/promise/models.d.ts
 /**
- * A promise that can be canceled
+ * A _Promise_ that can be canceled
  */
 declare class CancelablePromise<Value = void> extends Promise<Value> {
   #private;
   constructor(executor: (resolve: (value: Value) => void, reject: (reason: unknown) => void) => void);
   /**
-   * Cancel the promise, rejecting it with an optional reason
-   * @param reason Optional reason for canceling the promise
+   * Cancel the _Promise_, rejecting it with an optional reason
+   *
+   * @param reason Optional reason for canceling the _Promise_
    */
   cancel(reason?: unknown): void;
 }
 /**
- * A promise that was fulfilled
+ * A _Promise_ that was fulfilled
  */
 type FulfilledPromise<Value> = {
   /**
-   * Status of the promise
+   * Status of the _Promise_
    */
   status: typeof PROMISE_TYPE_FULFILLED;
   /**
-   * Value of the promise
+   * Value of the _Promise_
    */
   value: Awaited<Value>;
 };
@@ -36,15 +37,15 @@ type PromiseHandlers = {
   reject: (reason: unknown) => void;
 };
 /**
- * Options for a promise-handling function
+ * Options for a _Promise_-handling function
  */
 type PromiseOptions = {
   /**
-   * AbortSignal for aborting the promise; when aborted, the promise will reject with the reason of the signal
+   * AbortSignal for aborting the _Promise_; when aborted, the _Promise_ will reject with the reason of the signal
    */
   signal?: AbortSignal;
   /**
-   * How long to wait for (in milliseconds; defaults to `0`)
+   * How long to wait for _(in milliseconds; defaults to `0`)_
    */
   time?: number;
 };
@@ -58,12 +59,10 @@ type PromiseParameters = {
   value?: unknown;
 };
 /**
- * Promise handling strategy
+ * _Promise_ handling strategy
  *
- * - `complete`: wait for all promises to settle, then return the results
- * 	- Returns an array of fulfilled and/or rejected results
- * - `first`: rejects on the first rejected promise
- * 	- Returns an array of values
+ * - `complete`: wait for all _Promises_ to settle, then return the results, as an array of fulfilled and/or rejected results
+ * - `first`: rejects on the first rejected _Promise_, and returns an array of values
  */
 type PromiseStrategy = 'complete' | 'first';
 /**
@@ -74,15 +73,15 @@ declare class PromiseTimeoutError extends Error {
 }
 type PromisesItems<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Promise<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Promise<Value> : Promise<Items[ItemsKey]> };
 /**
- * Options for handling multiple promises
+ * Options for handling multiple _Promises_
  */
 type PromisesOptions = {
   /**
-   * AbortSignal for aborting the promises; when aborted, the promises will reject with the reason of the signal
+   * AbortSignal for aborting the _Promises_; when aborted, the _Promises_ will reject with the reason of the signal
    */
   signal?: AbortSignal;
   /**
-   * Strategy for handling the promises; defaults to `complete`
+   * Strategy for handling the _Promises_; defaults to `complete`
    */
   strategy?: PromiseStrategy;
 };
@@ -91,11 +90,11 @@ type PromisesUnwrapped<Items extends unknown[]> = { [ItemsKey in keyof Items]: I
 type PromisesValue<Value> = FulfilledPromise<Value> | RejectedPromise;
 type PromisesValues<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never : Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never };
 /**
- * A promise that was rejected
+ * A _Promise_ that was rejected
  */
 type RejectedPromise = {
   /**
-   * Status of the promise
+   * Status of the _Promise_
    */
   status: typeof PROMISE_TYPE_REJECTED;
   /**