@oscarpalmer/atoms 0.199.0 → 0.201.0

package/dist/index.d.mts

@@ -604,7 +604,7 @@ export declare namespace groupBy {
  *    // }
  * ```
  */
-export declare function groupArraysBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+export declare function groupArraysBy<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, Array<ReturnType<ValueCallback>>>;
 /**
  * Create a record from an array of items using a specific key and value, grouping values into arrays
  *
@@ -650,7 +650,7 @@ export declare function groupArraysBy<Item extends PlainObject, KeyCallback exte
  *    // }
  * ```
  */
-export declare function groupArraysBy<Item extends PlainObject, ItemKey extends keyof Item, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, value: ValueCallback): Simplify<Record<KeyedValue<Item, ItemKey>, ReturnType<ValueCallback>[]>>;
+export declare function groupArraysBy<Item extends PlainObject, ItemKey extends keyof Item, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, value: ValueCallback): Simplify<Record<KeyedValue<Item, ItemKey>, Array<ReturnType<ValueCallback>>>>;
 /**
  * Create a record from an array of items using a specific key and value, grouping values into arrays
  *
@@ -745,7 +745,7 @@ export declare function chunk<Item>(array: Item[], size?: number): Item[][];
  * compact([0, 1, '', 'hello', false, true, null, undefined]); // => [1, 'hello', true]
  * ```
  */
-export declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | '' | false | null | undefined>[];
+export declare function compact<Item>(array: Item[], strict: true): Array<Exclude<Item, 0 | '' | false | null | undefined>>;
 /**
  * Compact an array _(removing all `null` and `undefined` values)_
  *
@@ -757,7 +757,7 @@ export declare function compact<Item>(array: Item[], strict: true): Exclude<Item
  * compact([0, 1, '', 'hello', false, true, null, undefined]); // => [0, 1, '', 'hello', false, true]
  * ```
  */
-export declare function compact<Item>(array: Item[]): Exclude<Item, null | undefined>[];
+export declare function compact<Item>(array: Item[]): Array<Exclude<Item, null | undefined>>;
 //#endregion
 //#region src/internal/array/get.d.ts
 /**
@@ -1516,7 +1516,7 @@ export declare function findLast<Item>(array: Item[], value: Item): Item | undef
  * flatten([1, [2, [3, 4], 5], 6]); // => [1, 2, 3, 4, 5, 6]
  * ```
  */
-export declare function flatten<Item>(array: Item[]): NestedArray<Item>[];
+export declare function flatten<Item>(array: Item[]): Array<NestedArray<Item>>;
 //#endregion
 //#region src/array/from.d.ts
 /**
@@ -1582,7 +1582,7 @@ export declare function times(length: number): number[];
  * times(5, index => index * 2); // => [0, 2, 4, 6, 8]
  * ```
  */
-export declare function times<Callback extends (index: number) => unknown>(length: number, callback: Callback): ReturnType<Callback>[];
+export declare function times<Callback extends (index: number) => unknown>(length: number, callback: Callback): Array<ReturnType<Callback>>;
 /**
  * Get an array with a specified length, filled with a specified value
  *
@@ -1778,110 +1778,112 @@ export declare function push<Item>(array: Item[], pushed: Item[]): number;
 export declare function reverse<Item>(array: Item[]): Item[];
 //#endregion
 //#region src/array/select.d.ts
+type MapKeyOrCallback<Item> = ((item: Item, index: number, array: Item[]) => unknown) | (Item extends PlainObject ? keyof Item : never);
+type Mapped<Item, Map extends MapKeyOrCallback<Item>> = Map extends ((item: Item, index: number, array: Item[]) => unknown) ? ReturnType<Map> : Map extends keyof Item ? Item[Map] : never;
+type ObjectKeysOf<Item> = { [Key in keyof Item]: Item[Key] extends PlainObject ? Key : never; }[keyof Item];
 /**
- * Get a filtered and mapped array of items
+ * Get a mapped and filtered array of items
  *
  * @param array Array to search in
- * @param filterCallback Callback to get an item's value for matching
+ * @param map Callback or key to map the items
+ * @param filterCallback Callback to get a mapped value's value for matching
  * @param filterValue Value to match against
- * @param mapCallback Callback to map the matched items
- * @returns Filtered and mapped array of items
+ * @returns Mapped and filtered array of items
  *
  * @example
  * ```typescript
- * select(
+ * reverseSelect(
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   item => item.id,
- *   2,
  *   item => item.name,
+ *   value => value.length,
+ *   3,
  * ); // => ['Bob']
  * ```
  */
-export declare function select<Item, FilterCallback extends (item: Item, index: number, array: Item[]) => unknown, MapCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>, mapCallback: MapCallback): Array<ReturnType<MapCallback>>;
+export declare function reverseSelect<Item, Map extends MapKeyOrCallback<Item>, FilterCallback extends (item: Mapped<Item, Map>, index: number, array: Item[]) => unknown>(array: Item[], map: Map, filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>): Array<Mapped<Item, Map>>;
 /**
- * Get a filtered and mapped array of items
+ * Get a mapped and filtered array of items
  *
  * @param array Array to search in
- * @param filterCallback Callback to get an item's value for matching
+ * @param map Callback to map the items
+ * @param filterKey Key to get a mapped value's value for matching
  * @param filterValue Value to match against
- * @param mapKey Key to get an item's value for mapping
- * @returns Filtered and mapped array of items
+ * @returns Mapped and filtered array of items
  *
  * @example
  * ```typescript
- * select(
+ * reverseSelect(
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   item => item.id,
- *   2,
- *   'name',
- * ); // => ['Bob']
+ *   item => ({label: item.name}),
+ *   'label',
+ *   'Bob',
+ * ); // => [{label: 'Bob'}]
  * ```
  */
-export declare function select<Item extends PlainObject, FilterCallback extends (item: Item, index: number, array: Item[]) => unknown, MapKey extends keyof Item>(array: Item[], filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>, mapKey: MapKey): Array<Item[MapKey]>;
+export declare function reverseSelect<Item, MapCallback extends (item: Item, index: number, array: Item[]) => PlainObject, ItemKey extends keyof ReturnType<MapCallback>>(array: Item[], map: MapCallback, filterKey: ItemKey, filterValue: ReturnType<MapCallback>[ItemKey]): Array<ReturnType<MapCallback>>;
 /**
- * Get a filtered and mapped array of items
+ * Get a mapped and filtered array of items
  *
  * @param array Array to search in
- * @param filterKey Key to get an item's value for matching
+ * @param map Key to map the items
+ * @param filterKey Key to get a mapped value's value for matching
  * @param filterValue Value to match against
- * @param mapCallback Callback to map the matched items
- * @returns Filtered and mapped array of items
+ * @returns Mapped and filtered array of items
  *
  * @example
  * ```typescript
- * select(
- *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   'id',
- *   2,
- *   item => item.name,
- * ); // => ['Bob']
+ * reverseSelect(
+ *   [{meta: {tag: 'a'}}, {meta: {tag: 'b'}}],
+ *   'meta',
+ *   'tag',
+ *   'b',
+ * ); // => [{tag: 'b'}]
  * ```
  */
-export declare function select<Item extends PlainObject, ItemKey extends keyof Item, MapCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], filterKey: ItemKey, filterValue: Item[ItemKey], mapCallback: MapCallback): Array<ReturnType<MapCallback>>;
+export declare function reverseSelect<Item, MapKey extends ObjectKeysOf<Item>, ItemKey extends keyof Item[MapKey]>(array: Item[], map: MapKey, filterKey: ItemKey, filterValue: Item[MapKey][ItemKey]): Array<Item[MapKey]>;
 /**
- * Get a filtered and mapped array of items
+ * Get a mapped and filtered array of items
  *
  * @param array Array to search in
- * @param filterKey Key to get an item's value for matching
- * @param filterValue Value to match against
- * @param mapKey Key to get an item's value for mapping
- * @returns Filtered and mapped array of items
+ * @param map Callback or key to map the items
+ * @param filter Filter callback to match mapped values
+ * @returns Mapped and filtered array of items
  *
  * @example
  * ```typescript
- * select(
+ * reverseSelect(
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   'id',
- *   2,
- *   'name',
+ *   item => item.name,
+ *   value => value.startsWith('B'),
  * ); // => ['Bob']
  * ```
  */
-export declare function select<Item extends PlainObject, ItemKey extends keyof Item, MapKey extends keyof Item>(array: Item[], filterKey: ItemKey, filterValue: Item[ItemKey], mapKey: MapKey): Array<Item[MapKey]>;
+export declare function reverseSelect<Item, Map extends MapKeyOrCallback<Item>>(array: Item[], map: Map, filter: (item: Mapped<Item, Map>, index: number, array: Item[]) => boolean): Array<Mapped<Item, Map>>;
 /**
- * Get a filtered and mapped array of items
+ * Get a mapped and filtered array of items
  *
  * @param array Array to search in
- * @param filterCallback Filter callback to match items
- * @param mapCallback Callback to map the matched items
- * @returns Filtered and mapped array of items
+ * @param map Callback or key to map the items
+ * @param value Mapped value to match against
+ * @returns Mapped and filtered array of items
  *
  * @example
  * ```typescript
- * select(
- *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   item => item.id === 2,
- *   item => item.name,
- * ); // => ['Bob']
+ * reverseSelect(
+ *   [1, 2, 3, 2, 1],
+ *   value => value ** 2,
+ *   4,
+ * ); // => [4, 4]
  * ```
  */
-export declare function select<Item, FilterCallback extends (item: Item, index: number, array: Item[]) => unknown, MapCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>, mapCallback: MapCallback): Array<ReturnType<MapCallback>>;
+export declare function reverseSelect<Item, Map extends MapKeyOrCallback<Item>>(array: Item[], map: Map, value: Mapped<Item, Map>): Array<Mapped<Item, Map>>;
 /**
  * Get a filtered and mapped array of items
  *
  * @param array Array to search in
- * @param filterCallback Filter callback to match items
- * @param mapKey Key to get an item's value for mapping
+ * @param filterCallback Callback to get an item's value for matching
+ * @param filterValue Value to match against
+ * @param map Callback or key to map the matched items
  * @returns Filtered and mapped array of items
  *
  * @example
@@ -1890,35 +1892,37 @@ export declare function select<Item, FilterCallback extends (item: Item, index:
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
  *   item => item.id,
  *   2,
- *   'name'
+ *   item => item.name,
  * ); // => ['Bob']
  * ```
  */
-export declare function select<Item extends PlainObject, FilterCallback extends (item: Item, index: number, array: Item[]) => unknown, MapKey extends keyof Item>(array: Item[], filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>, mapKey: MapKey): Array<Item[MapKey]>;
+export declare function select<Item, FilterCallback extends (item: Item, index: number, array: Item[]) => unknown, Map extends MapKeyOrCallback<Item>>(array: Item[], filterCallback: FilterCallback, filterValue: ReturnType<FilterCallback>, map: Map): Array<Mapped<Item, Map>>;
 /**
  * Get a filtered and mapped array of items
  *
  * @param array Array to search in
- * @param filter Filter callback to match items
- * @param map Callback to map the matched items
+ * @param filterKey Key to get an item's value for matching
+ * @param filterValue Value to match against
+ * @param map Callback or key to map the matched items
  * @returns Filtered and mapped array of items
  *
  * @example
  * ```typescript
  * select(
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
- *   item => item.id === 2,
- *   item => item.name,
+ *   'id',
+ *   2,
+ *   'name',
  * ); // => ['Bob']
  * ```
  */
-export declare function select<Item, MapCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], filter: (item: Item, index: number, array: Item[]) => boolean, map: MapCallback): Array<ReturnType<MapCallback>>;
+export declare function select<Item extends PlainObject, ItemKey extends keyof Item, Map extends MapKeyOrCallback<Item>>(array: Item[], filterKey: ItemKey, filterValue: Item[ItemKey], map: Map): Array<Mapped<Item, Map>>;
 /**
  * Get a filtered and mapped array of items
  *
  * @param array Array to search in
  * @param filter Filter callback to match items
- * @param map Key to get an item's value for mapping
+ * @param map Callback or key to map the matched items
  * @returns Filtered and mapped array of items
  *
  * @example
@@ -1926,17 +1930,17 @@ export declare function select<Item, MapCallback extends (item: Item, index: num
  * select(
  *   [{id: 1, name: 'Alice'}, {id: 2, name: 'Bob'}, {id: 3, name: 'Charlie'}],
  *   item => item.id === 2,
- *   'name'
+ *   item => item.name,
  * ); // => ['Bob']
  * ```
  */
-export declare function select<Item extends PlainObject, MapKey extends keyof Item>(array: Item[], filter: (item: Item, index: number, array: Item[]) => boolean, map: MapKey): Array<Item[MapKey]>;
+export declare function select<Item, Map extends MapKeyOrCallback<Item>>(array: Item[], filter: (item: Item, index: number, array: Item[]) => boolean, map: Map): Array<Mapped<Item, Map>>;
 /**
  * Get a filtered and mapped array of items
  *
  * @param array Array to search in
  * @param item Item to match against
- * @param map Callback to map the matched items
+ * @param map Callback or key to map the matched items
  * @returns Filtered and mapped array of items
  *
  * @example
@@ -1948,7 +1952,10 @@ export declare function select<Item extends PlainObject, MapKey extends keyof It
  * ); // => [9]
  * ```
  */
-export declare function select<Item, MapCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], item: Item, map: MapCallback): Array<ReturnType<MapCallback>>;
+export declare function select<Item, Map extends MapKeyOrCallback<Item>>(array: Item[], item: Item, map: Map): Array<Mapped<Item, Map>>;
+export declare namespace select {
+  var reverse: typeof reverseSelect;
+}
 //#endregion
 //#region src/array/single.d.ts
 /**
@@ -3017,6 +3024,8 @@ export declare function initializeSorter<Item>(descending?: boolean): Sorter<Ite
 /**
  * Is the array sorted according to the sorters _(and the optional default direction)_?
  *
+ * _Available as `isSorted` and `sort.is`_
+ *
  * @param array Array to check
  * @param sorters Sorters to determine sorting
  * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
@@ -3026,6 +3035,8 @@ export declare function isSorted<Item>(array: Item[], sorters: Array<ArraySorter
 /**
  * Is the array sorted according to the sorter _(and the optional default direction)_?
  *
+ * _Available as `isSorted` and `sort.is`_
+ *
  * @param array Array to check
  * @param sorter Sorter to determine sorting
  * @param descending Sorted in descending order? _(defaults to `false`; overridden by individual sorters)_
@@ -3430,7 +3441,7 @@ export declare namespace toMap {
  * ); // => Map { 10 => [1, 3], 20 => [2] }
  * ```
  */
-export declare function toMapArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+export declare function toMapArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Map<ReturnType<KeyCallback>, Array<ReturnType<ValueCallback>>>;
 /**
  * Create a _Map_ from an array of items using a callback and value, grouping values into arrays
  *
@@ -3470,7 +3481,7 @@ export declare function toMapArrays<Item extends PlainObject, KeyCallback extend
  * ); // => Map { 10 => [1, 3], 20 => [2] }
  * ```
  */
-export declare function toMapArrays<Item extends PlainObject, ItemKey extends keyof Item, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, value: ValueCallback): Map<Item[ItemKey], ReturnType<ValueCallback>[]>;
+export declare function toMapArrays<Item extends PlainObject, ItemKey extends keyof Item, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, value: ValueCallback): Map<Item[ItemKey], Array<ReturnType<ValueCallback>>>;
 /**
  * Create a _Map_ from an array of items using a key and value, grouping values into arrays
  *
@@ -3681,7 +3692,7 @@ export declare namespace toRecord {
  * ); // => { 10: [1, 3], 20: [2] }
  * ```
  */
-export declare function toRecordArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, ReturnType<ValueCallback>[]>;
+export declare function toRecordArrays<Item, KeyCallback extends (item: Item, index: number, array: Item[]) => Key$1, ValueCallback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: KeyCallback, value: ValueCallback): Record<ReturnType<KeyCallback>, Array<ReturnType<ValueCallback>>>;
 /**
  * Create a record from an array of items using a callback and value, grouping values into arrays
  *
@@ -3721,7 +3732,7 @@ export declare function toRecordArrays<Item extends PlainObject, Callback extend
  * ); // => { 10: [1, 3], 20: [2] }
  * ```
  */
-export declare function toRecordArrays<Item extends PlainObject, ItemKey extends keyof Item, Callback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, callback: Callback): Simplify<Record<KeyedValue<Item, ItemKey>, ReturnType<Callback>[]>>;
+export declare function toRecordArrays<Item extends PlainObject, ItemKey extends keyof Item, Callback extends (item: Item, index: number, array: Item[]) => unknown>(array: Item[], key: ItemKey, callback: Callback): Simplify<Record<KeyedValue<Item, ItemKey>, Array<ReturnType<Callback>>>>;
 /**
  * Create a record from an array of items using a key and value, grouping values into arrays
  *
@@ -5008,7 +5019,7 @@ export type FulfilledPromise<Value> = {
 };
 export type PromiseData = {
   last: number;
-  result: unknown[];
+  result: ArrayOrPlainObject;
 };
 export type PromiseHandlers = {
   resolve: (value: unknown[]) => void;
@@ -5033,6 +5044,7 @@ export type PromiseParameters = {
   data: PromiseData;
   handlers: PromiseHandlers;
   index: number;
+  key: Key$1;
   value?: unknown;
 };
 /**
@@ -5048,7 +5060,7 @@ export type PromiseStrategy = 'complete' | 'first';
 export declare class PromiseTimeoutError extends Error {
   constructor();
 }
-export 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]>; };
+export type PromisesItems<Items extends ArrayOrPlainObject> = { [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_
  */
@@ -5062,10 +5074,10 @@ export type PromisesOptions = {
    */
   strategy?: PromiseStrategy;
 };
-export type PromisesResult<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
-export type PromisesUnwrapped<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never; };
+export type PromisesResult<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
+export type PromisesUnwrapped<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends GenericCallback ? ReturnType<Items[ItemsKey]> extends Promise<infer Value> ? Awaited<Value> : never : Items[ItemsKey] extends Promise<infer Value> ? Awaited<Value> : never; };
 export type PromisesValue<Value> = FulfilledPromise<Value> | RejectedPromise;
-export 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; };
+export type PromisesValues<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never; };
 /**
  * A _Promise_ that was rejected
  */
@@ -5098,7 +5110,7 @@ export declare function delay(time?: number): Promise<void>;
 //#endregion
 //#region src/promise/index.d.ts
 /**
- * Wrap a _Promise_ with safety handlers, with optional abort capabilities and timeout
+ * Wrap a _Promise_ with safety handlers
  *
  * @param promise _Promise_ to wrap
  * @param options Options for the _Promise_
@@ -5106,7 +5118,7 @@ export declare function delay(time?: number): Promise<void>;
  */
 export 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
  *
  * @param callback Callback to wrap
  * @param options Options for the _Promise_
@@ -5114,7 +5126,7 @@ export declare function attemptPromise<Value>(promise: Promise<Value>, options?:
  */
 export 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
  *
  * @param callback Callback to wrap
  * @param options Options for the _Promise_
@@ -5124,7 +5136,7 @@ export declare function attemptPromise<Value>(callback: () => Value, options?: P
 /**
  * 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
+ * _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_
@@ -5132,78 +5144,76 @@ export declare function attemptPromise<Value>(callback: () => Value, options?: P
  */
 export 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 keyed _Promises_, returning their results in a similarly keyed object
  *
- * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
+ * _Depending on the strategy, the function will either reject on the first error encountered or return an object of rejected and resolved results_
  *
- * @param items List of _Promises_
+ * @param items Keyed _Promises_
  * @param options Options for handling the _Promises_
- * @returns List of results
+ * @returns Keyed object of results
  */
-export declare function promises<Value, Options extends PromisesOptions>(items: Promise<Value>[], options?: Options): Promise<Options['strategy'] extends 'first' ? Value[] : PromisesValue<Value>[]>;
+export declare function promises<Items extends PlainObject, 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
  *
- * If any _Promise_ in the list is rejected, the whole function will reject
+ * _If the strategy is `first`, the function will reject on the first error encountered; otherwise, it returns an array of rejected and resolved results_
  *
  * @param items List of _Promises_
- * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
+ * @param strategy Strategy for handling the _Promises_
  * @returns List of results
  */
-export declare function promises<Items extends unknown[]>(items: [...Items], strategy: 'first'): Promise<PromisesUnwrapped<Items>>;
+export declare function promises<Items extends unknown[], Strategy extends PromiseStrategy>(items: [...Items], strategy: Strategy): Promise<Strategy extends 'first' ? PromisesUnwrapped<Items> : PromisesValues<PromisesItems<Items>>>;
 /**
- * Handle a list of _Promises_, returning their results in an ordered array
+ * Handle keyed _Promises_, returning their results in a similarly keyed object
  *
- * If any _Promise_ in the list is rejected, the whole function will reject
+ * _If the strategy is `first`, the function will reject on the first error encountered; otherwise, it returns an object of rejected and resolved results_
  *
- * @param items List of _Promises_
- * @param strategy Strategy for handling the _Promises_; rejects on the first error encountered
- * @returns List of results
+ * @param items Keyed _Promises_
+ * @param strategy Strategy for handling the _Promises_
+ * @returns Keyed object of results
  */
-export declare function promises<Value>(items: Promise<Value>[], strategy: 'first'): Promise<Value[]>;
+export declare function promises<Items extends PlainObject, Strategy extends PromiseStrategy>(items: Items, strategy: Strategy): Promise<Strategy extends 'first' ? PromisesUnwrapped<Items> : PromisesValues<PromisesItems<Items>>>;
 /**
- * Handle a list of _Promises_, returning their results in an ordered array of rejected and resolved results
+ * Handle a list of _Promises_, returning their results in an ordered array
  *
  * @param items List of _Promises_
- * @param signal AbortSignal for aborting the operation _(when aborted, the _Promise_ will reject with the reason of the signal)_
+ * @param signal _AbortSignal_ for aborting all _Promises_
  * @returns List of results
  */
 export 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
+ * Handle keyed _Promises_, returning their results in a similarly keyed object
  *
- * @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
+ * @param items Keyed _Promises_
+ * @param signal _AbortSignal_ for aborting all _Promises_
+ * @returns Keyed object of results
  */
-export declare function promises<Value>(items: Array<Promise<Value> | (() => Promise<Value>)>, signal?: AbortSignal): Promise<PromisesValue<Value>[]>;
+export declare function promises<Items extends PlainObject>(items: Items, signal?: AbortSignal): Promise<PromisesValues<PromisesItems<Items>>>;
 export declare namespace promises {
   var result: typeof resultPromises;
 }
 /**
  * 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
+ * _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)_
+ * @param signal AbortSignal for aborting all _Promises_
  * @returns List of results
  */
 export 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})_
- *
- * Depending on the strategy, the function will either reject on the first error encountered or return an array of rejected and resolved results
+ * Handle keyed _Promises_, returning their results in a similarly keyed object of results _({@link Result})_
  *
  * _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
+ * @param items Keyed _Promises_
+ * @param signal AbortSignal for aborting all _Promises_
+ * @returns Keyed object of results
  */
-export declare function resultPromises<Value>(items: Promise<Value>[], signal?: AbortSignal): Promise<Result<Awaited<Value>>[]>;
+export declare function resultPromises<Items extends PlainObject>(items: Items, signal?: AbortSignal): Promise<PromisesResult<PromisesItems<Items>>>;
 //#endregion
 //#region src/internal/result/misc.d.ts
 /**
@@ -5947,6 +5957,8 @@ export declare namespace fuzzy {
 /**
  * Does the needle match the haystack in a fuzzy way?
  *
+ * _Available as `fuzzyMatch` and `fuzzy.match`_
+ *
  * @param haystack Haystack to search through
  * @param needle Needle to search for
  * @returns `true` if the needle matches the haystack in a fuzzy way, otherwise `false`
@@ -6486,6 +6498,8 @@ export declare namespace freeze {
 /**
  * Is the value frozen?
  *
+ * _Available as `isFrozen` and `freeze.is`_
+ *
  * @param value Value to check
  * @returns `true` if the value is frozen, otherwise `false`
  */
@@ -6615,7 +6629,7 @@ export type Merger = {
    * @param values Values to merge
    * @returns Merged value
    */
-  <Values extends ArrayOrPlainObject[]>(values: NestedPartial<Values[number]>[]): UnionToIntersection<Values[number]>;
+  <Values extends ArrayOrPlainObject[]>(values: Array<NestedPartial<Values[number]>>): UnionToIntersection<Values[number]>;
 };
 /**
  * Assign values from one or more objects to the first one
@@ -8499,6 +8513,8 @@ export declare function isQueueInstance<Instance>(name: string, value: unknown):
 /**
  * Create a keyed queue for an asynchronous callback function, where each key has its own queue
  *
+ * _Available as `keyedQueue` and `queue.keyed`_
+ *
  * @param callback Callback function for queued items
  * @param options Queue options
  */
@@ -8506,6 +8522,8 @@ export declare function keyedQueue<Callback extends (key: string, ...parameters:
 /**
  * Create a keyed queue for an asynchronous callback function, where each key has its own queue
  *
+ * _Available as `keyedQueue` and `queue.keyed`_
+ *
  * @param callback Callback function for queued items
  * @param options Queue options
  */