@oscarpalmer/atoms 0.199.0 → 0.201.0

package/dist/index.mjs

@@ -68,12 +68,16 @@ function findValues(type, array, parameters, mapper) {
 		result.matched = [...new Set(array)];
 		return result;
 	}
-	const mapCallback = getArrayCallback(mapper);
+	const mapCallback = getArrayCallback(mapper?.callback);
+	const mapReverse = mapper?.reverse ?? false;
+	const mapAfter = mapCallback == null ? void 0 : mapReverse ? void 0 : mapCallback;
+	const mapBefore = mapCallback == null ? void 0 : mapReverse ? mapCallback : void 0;
 	if (callbacks?.bool != null || type === "all" && key == null) {
 		const callback = callbacks?.bool ?? ((item) => Object.is(item, value));
 		for (let index = 0; index < length; index += 1) {
 			const item = array[index];
-			if (callback(item, index, array)) result.matched.push(mapCallback?.(item, index, array) ?? item);
+			const transformed = mapBefore?.(item, index, array) ?? item;
+			if (callback(transformed, index, array)) result.matched.push(mapAfter?.(item, index, array) ?? transformed);
 			else result.notMatched.push(item);
 		}
 		return result;
@@ -81,10 +85,18 @@ function findValues(type, array, parameters, mapper) {
 	const keys = /* @__PURE__ */ new Set();
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
-		const keyed = callbacks?.keyed?.(item, index, array) ?? item;
+		let keyed;
+		let transformed;
+		if (mapBefore == null) {
+			keyed = callbacks?.keyed?.(item, index, array) ?? item;
+			transformed = item;
+		} else {
+			transformed = mapBefore(item, index, array);
+			keyed = callbacks?.keyed?.(transformed, index, array) ?? transformed;
+		}
 		if (type === "all" && Object.is(keyed, value) || type === "unique" && !keys.has(keyed)) {
 			keys.add(keyed);
-			result.matched.push(mapCallback?.(item, index, array) ?? item);
+			result.matched.push(mapAfter?.(item, index, array) ?? transformed);
 		} else result.notMatched.push(item);
 	}
 	return result;
@@ -661,9 +673,23 @@ function reverse(array) {
 }
 //#endregion
 //#region src/array/select.ts
+function reverseSelect(array, ...parameters) {
+	return findValues("all", array, parameters, {
+		callback: parameters.shift(),
+		reverse: true
+	}).matched;
+}
 function select(array, ...parameters) {
-	return findValues("all", array, parameters, parameters.pop()).matched;
+	return selectValues(array, parameters);
 }
+function selectValues(array, parameters) {
+	return findValues("all", array, parameters, {
+		callback: parameters.pop(),
+		reverse: false
+	}).matched;
+}
+select.reverse = reverseSelect;
+Object.defineProperty(select, "reverse", { value: reverseSelect });
 //#endregion
 //#region src/array/single.ts
 function single(array, ...parameters) {
@@ -2597,6 +2623,8 @@ const ABORT_OPTIONS = { once: true };
 //#region src/promise/constants.ts
 const PROMISE_ERROR_NAME = "PromiseTimeoutError";
 const PROMISE_MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
+const PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY = "promises expected at least one promise-function or promise in the array or object";
+const PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE = "promises expected an array or object holding promise-functions or promises";
 const PROMISE_MESSAGE_EXPECTATION_RESULT = "toResult expected a Promise";
 const PROMISE_MESSAGE_EXPECTATION_TIMED = "Timed function expected a Promise";
 const PROMISE_MESSAGE_TIMEOUT = "Promise timed out";
@@ -2665,7 +2693,15 @@ function createPromisesOptions(input) {
 	};
 }
 function getResultsFromPromises(promised) {
-	return promised.map((result) => isFulfilled(result) ? ok(result.value) : error(result.reason));
+	const isArray = Array.isArray(promised);
+	const entries = isArray ? promised.map((value, index) => [index, value]) : Object.entries(promised);
+	const { length } = entries;
+	const results = isArray ? [] : {};
+	for (let index = 0; index < length; index += 1) {
+		const [key, value] = entries[index];
+		results[key] = isFulfilled(value) ? ok(value.value) : error(value.reason);
+	}
+	return results;
 }
 function getStrategyOrDefault(value) {
 	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;
@@ -2719,13 +2755,13 @@ function cancelable(executor) {
 	return new CancelablePromise(executor);
 }
 function handleResult(status, parameters) {
-	const { aborter, complete, data, handlers, index, value } = parameters;
+	const { aborter, complete, data, handlers, index, key, value } = parameters;
 	if (aborter?.signal.aborted ?? false) return;
 	if (!complete && status === "rejected") {
 		settlePromise(handlers.reject, value, aborter);
 		return;
 	}
-	data.result[index] = !complete ? value : status === "fulfilled" ? {
+	data.result[key] = !complete ? value : status === "fulfilled" ? {
 		status,
 		value
 	} : {
@@ -2816,17 +2852,18 @@ async function attemptPromise(value, options) {
 async function promises(items, options) {
 	const { signal, strategy } = createPromisesOptions(options);
 	if (signal?.aborted ?? false) return Promise.reject(signal?.reason);
-	if (!Array.isArray(items)) return Promise.resolve([]);
-	const actual = items.map((item) => typeof item === "function" ? item() : item).filter((item) => item instanceof Promise);
+	if (!isArrayOrPlainObject(items)) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE);
+	const isArray = Array.isArray(items);
+	const actual = (isArray ? items.map((item, index) => [index, item]) : Object.entries(items)).map(([key, value]) => [key, typeof value === "function" ? value() : value]).filter(([, value]) => value instanceof Promise);
 	const { length } = actual;
-	if (length === 0) return Promise.resolve([]);
+	if (length === 0) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY);
 	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
 	const aborter = createAborter(signal, () => {
 		handlers.reject(signal?.reason);
 	});
 	const data = {
 		last: length - 1,
-		result: []
+		result: isArray ? [] : {}
 	};
 	let handlers;
 	return new Promise((resolve, reject) => {
@@ -2834,21 +2871,24 @@ async function promises(items, options) {
 			reject,
 			resolve
 		};
-		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(PROMISE_TYPE_FULFILLED, {
-			aborter,
-			complete,
-			data,
-			handlers,
-			index,
-			value
-		})).catch((reason) => handleResult(PROMISE_TYPE_REJECTED, {
-			aborter,
-			complete,
-			data,
-			handlers,
-			index,
-			value: reason
-		}));
+		for (let index = 0; index < length; index += 1) {
+			const [key, promise] = actual[index];
+			const parameters = {
+				aborter,
+				complete,
+				data,
+				handlers,
+				index,
+				key
+			};
+			promise.then((value) => {
+				parameters.value = value;
+				handleResult(PROMISE_TYPE_FULFILLED, parameters);
+			}).catch((reason) => {
+				parameters.value = reason;
+				handleResult(PROMISE_TYPE_REJECTED, parameters);
+			});
+		}
 	});
 }
 async function resultPromises(items, signal) {
@@ -3050,6 +3090,8 @@ function fuzzy(items, configuration) {
 }
 /**
 * 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
@@ -3792,6 +3834,8 @@ function freezeValue(value, references, flat) {
 }
 /**
 * Is the value frozen?
+* 
+* _Available as `isFrozen` and `freeze.is`_
 *
 * @param value Value to check
 * @returns `true` if the value is frozen, otherwise `false`
@@ -3968,7 +4012,8 @@ function createMergeOptions(options) {
 }
 function getReplaceableObjects(value) {
 	const items = (Array.isArray(value) ? value : [value]).filter((item) => typeof item === "string" || item instanceof RegExp);
-	if (items.length > 0) return (name) => items.some((item) => typeof item === "string" ? item === name : item.test(name));
+	if (items.length === 0) return;
+	return (name) => items.some((item) => typeof item === "string" ? item === name : item.test(name));
 }
 /**
 * Create an assigner with predefined options
@@ -6469,4 +6514,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeCloner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isSubscriptions, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, subscriptions, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, Logger, PromiseTimeoutError, QueueError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, assertProperty, assign, asyncAttempt, asyncDebounce, asyncFlow, asyncMatchResult, asyncOnce, asyncPipe, asyncThrottle, attempt, attemptAsyncFlow, attemptAsyncPipe, attemptFlow, attemptPipe, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getHwbColor, getHwbaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToHwb, hexToHwba, hexToRgb, hexToRgba, hslToHex, hslToHwb, hslToHwba, hslToRgb, hslToRgba, hwbToHex, hwbToHsl, hwbToHsla, hwbToRgb, hwbToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeCloner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isBeacon, isBeaconSubscription, isColor, isConstructor, isEmpty, isError, isFrozen, isFulfilled, isHerald, isHeraldEvents, isHeraldSubscription, isHexColor, isHslColor, isHslaColor, isHwbColor, isHwbaColor, isInstanceOf, isKey, isKeyedQueue, isLogger, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isObservable, isOk, isPlainObject, isPrimitive, isQueue, isQueueInstance, isRejected, isResult, isRgbColor, isRgbaColor, isSorted, isSubscription, isSubscriptions, isTimedLogger, isTypedArray, join, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, lowerCase, matchResult, max, median, memoize, merge, min, move, moveIndices, moveToIndex, noop, normalize, ok, omit, once, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, registerCloner, registerComparator, registerEqualizer, resultPromises, retry, reverse, reverseSelect, rgbToHex, rgbToHsl, rgbToHsla, rgbToHwb, rgbToHwba, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, subscriptions, sum, swap, take, template, throttle, timed, times, titleCase, toMap, toMapArrays, toQuery, toRecord, toRecordArrays, toResult, toSet, toggle, transform, trim, truncate, tryDecode, tryEncode, union, unique, unsmush, unwrap, update, upperCase, words };

package/dist/internal/array/compact.d.mts

@@ -11,7 +11,7 @@
  * compact([0, 1, '', 'hello', false, true, null, undefined]); // => [1, 'hello', true]
  * ```
  */
-declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | '' | false | null | undefined>[];
+declare function compact<Item>(array: Item[], strict: true): Array<Exclude<Item, 0 | '' | false | null | undefined>>;
 /**
  * Compact an array _(removing all `null` and `undefined` values)_
  *
@@ -23,6 +23,6 @@ declare function compact<Item>(array: Item[], strict: true): Exclude<Item, 0 | '
  * compact([0, 1, '', 'hello', false, true, null, undefined]); // => [0, 1, '', 'hello', false, true]
  * ```
  */
-declare function compact<Item>(array: Item[]): Exclude<Item, null | undefined>[];
+declare function compact<Item>(array: Item[]): Array<Exclude<Item, null | undefined>>;
 //#endregion
 export { compact };

package/dist/internal/array/find.d.mts

@@ -1,4 +1,8 @@
 //#region src/internal/array/find.d.ts
+type FindMapper = {
+  callback: unknown;
+  reverse: boolean;
+};
 type FindValueType = 'index' | 'item';
 type FindValuesResult = {
   matched: unknown[];
@@ -14,7 +18,7 @@ declare function createFindParameters(original: unknown[]): Parameters;
 declare function findValue(type: Exclude<FindValueType, 'item'>, array: unknown[], parameters: unknown[], reversed: boolean): number;
 declare function findValue(type: Exclude<FindValueType, 'index'>, array: unknown[], parameters: unknown[], reversed: boolean): unknown;
 declare function findAbsoluteValueOrDefault(array: unknown[], parameters: unknown[], defaultValue: unknown, useDefaultValue: boolean, reversed: boolean): unknown;
-declare function findValues(type: FindValuesType, array: unknown[], parameters: unknown[], mapper?: unknown): FindValuesResult;
+declare function findValues(type: FindValuesType, array: unknown[], parameters: unknown[], mapper?: FindMapper): FindValuesResult;
 declare const FIND_VALUE_INDEX = "index";
 declare const FIND_VALUE_ITEM = "item";
 declare const FIND_VALUES_ALL: FindValuesType;

package/dist/internal/array/find.mjs

@@ -52,12 +52,16 @@ function findValues(type, array, parameters, mapper) {
 		result.matched = [...new Set(array)];
 		return result;
 	}
-	const mapCallback = getArrayCallback(mapper);
+	const mapCallback = getArrayCallback(mapper?.callback);
+	const mapReverse = mapper?.reverse ?? false;
+	const mapAfter = mapCallback == null ? void 0 : mapReverse ? void 0 : mapCallback;
+	const mapBefore = mapCallback == null ? void 0 : mapReverse ? mapCallback : void 0;
 	if (callbacks?.bool != null || type === "all" && key == null) {
 		const callback = callbacks?.bool ?? ((item) => Object.is(item, value));
 		for (let index = 0; index < length; index += 1) {
 			const item = array[index];
-			if (callback(item, index, array)) result.matched.push(mapCallback?.(item, index, array) ?? item);
+			const transformed = mapBefore?.(item, index, array) ?? item;
+			if (callback(transformed, index, array)) result.matched.push(mapAfter?.(item, index, array) ?? transformed);
 			else result.notMatched.push(item);
 		}
 		return result;
@@ -65,10 +69,18 @@ function findValues(type, array, parameters, mapper) {
 	const keys = /* @__PURE__ */ new Set();
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
-		const keyed = callbacks?.keyed?.(item, index, array) ?? item;
+		let keyed;
+		let transformed;
+		if (mapBefore == null) {
+			keyed = callbacks?.keyed?.(item, index, array) ?? item;
+			transformed = item;
+		} else {
+			transformed = mapBefore(item, index, array);
+			keyed = callbacks?.keyed?.(transformed, index, array) ?? transformed;
+		}
 		if (type === "all" && Object.is(keyed, value) || type === "unique" && !keys.has(keyed)) {
 			keys.add(keyed);
-			result.matched.push(mapCallback?.(item, index, array) ?? item);
+			result.matched.push(mapAfter?.(item, index, array) ?? transformed);
 		} else result.notMatched.push(item);
 	}
 	return result;

package/dist/promise/constants.d.mts

@@ -6,6 +6,8 @@ declare const PROMISE_ABORT_OPTIONS: {
 };
 declare const PROMISE_ERROR_NAME = "PromiseTimeoutError";
 declare const PROMISE_MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
+declare const PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY = "promises expected at least one promise-function or promise in the array or object";
+declare const PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE = "promises expected an array or object holding promise-functions or promises";
 declare const PROMISE_MESSAGE_EXPECTATION_RESULT = "toResult expected a Promise";
 declare const PROMISE_MESSAGE_EXPECTATION_TIMED = "Timed function expected a Promise";
 declare const PROMISE_MESSAGE_TIMEOUT = "Promise timed out";
@@ -14,4 +16,4 @@ declare const PROMISE_STRATEGY_DEFAULT: PromiseStrategy;
 declare const PROMISE_TYPE_FULFILLED = "fulfilled";
 declare const PROMISE_TYPE_REJECTED = "rejected";
 //#endregion
-export { PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED };
+export { PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY, PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED };

package/dist/promise/constants.mjs

@@ -3,6 +3,8 @@ const PROMISE_ABORT_EVENT = "abort";
 const PROMISE_ABORT_OPTIONS = { once: true };
 const PROMISE_ERROR_NAME = "PromiseTimeoutError";
 const PROMISE_MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
+const PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY = "promises expected at least one promise-function or promise in the array or object";
+const PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE = "promises expected an array or object holding promise-functions or promises";
 const PROMISE_MESSAGE_EXPECTATION_RESULT = "toResult expected a Promise";
 const PROMISE_MESSAGE_EXPECTATION_TIMED = "Timed function expected a Promise";
 const PROMISE_MESSAGE_TIMEOUT = "Promise timed out";
@@ -11,4 +13,4 @@ const PROMISE_STRATEGY_DEFAULT = "complete";
 const PROMISE_TYPE_FULFILLED = "fulfilled";
 const PROMISE_TYPE_REJECTED = "rejected";
 //#endregion
-export { PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED };
+export { PROMISE_ABORT_EVENT, PROMISE_ABORT_OPTIONS, PROMISE_ERROR_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY, PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE, PROMISE_MESSAGE_EXPECTATION_RESULT, PROMISE_MESSAGE_EXPECTATION_TIMED, PROMISE_MESSAGE_TIMEOUT, PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED };

package/dist/promise/helpers.d.mts

@@ -1,10 +1,9 @@
 import { RequiredKeys } from "../models.mjs";
-import { Result } from "../internal/result/models.mjs";
 import { FulfilledPromise, PromiseOptions, PromiseStrategy, PromisesOptions, PromisesValue, RejectedPromise } from "./models.mjs";
 //#region src/promise/helpers.d.ts
 declare function createPromiseOptions(input: unknown): RequiredKeys<PromiseOptions, 'time'>;
 declare function createPromisesOptions(input: unknown): RequiredKeys<PromisesOptions, 'strategy'>;
-declare function getResultsFromPromises<Value>(promised: PromisesValue<Value>[]): Result<Value>[];
+declare function getResultsFromPromises(promised: Array<PromisesValue<unknown>> | Record<string, PromisesValue<unknown>>): unknown;
 declare function getStrategyOrDefault(value: unknown): PromiseStrategy;
 /**
  * Is the value a fulfilled _Promise_ result?

package/dist/promise/helpers.mjs

@@ -27,7 +27,15 @@ function createPromisesOptions(input) {
 	};
 }
 function getResultsFromPromises(promised) {
-	return promised.map((result) => isFulfilled(result) ? ok(result.value) : error(result.reason));
+	const isArray = Array.isArray(promised);
+	const entries = isArray ? promised.map((value, index) => [index, value]) : Object.entries(promised);
+	const { length } = entries;
+	const results = isArray ? [] : {};
+	for (let index = 0; index < length; index += 1) {
+		const [key, value] = entries[index];
+		results[key] = isFulfilled(value) ? ok(value.value) : error(value.reason);
+	}
+	return results;
 }
 function getStrategyOrDefault(value) {
 	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;

package/dist/promise/index.d.mts

@@ -1,8 +1,8 @@
-import { Result } from "../internal/result/models.mjs";
-import { PromiseOptions, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues } from "./models.mjs";
+import { PlainObject } from "../models.mjs";
+import { PromiseOptions, PromiseStrategy, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValues } from "./models.mjs";
 //#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_
@@ -10,7 +10,7 @@ import { PromiseOptions, PromisesItems, PromisesOptions, PromisesResult, 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
  *
  * @param callback Callback to wrap
  * @param options Options for the _Promise_
@@ -18,7 +18,7 @@ declare function attemptPromise<Value>(promise: Promise<Value>, options?: Promis
  */
 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_
@@ -28,7 +28,7 @@ declare function attemptPromise<Value>(callback: () => Value, options?: PromiseO
 /**
  * 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_
@@ -36,77 +36,75 @@ declare function attemptPromise<Value>(callback: () => Value, options?: PromiseO
  */
 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
  */
-declare function promises<Value, Options extends PromisesOptions>(items: Promise<Value>[], options?: Options): Promise<Options['strategy'] extends 'first' ? Value[] : PromisesValue<Value>[]>;
+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
  */
-declare function promises<Items extends unknown[]>(items: [...Items], strategy: 'first'): Promise<PromisesUnwrapped<Items>>;
+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
  */
-declare function promises<Value>(items: Promise<Value>[], strategy: 'first'): Promise<Value[]>;
+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
  */
 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
  */
-declare function promises<Value>(items: Array<Promise<Value> | (() => Promise<Value>)>, signal?: AbortSignal): Promise<PromisesValue<Value>[]>;
+declare function promises<Items extends PlainObject>(items: Items, signal?: AbortSignal): Promise<PromisesValues<PromisesItems<Items>>>;
 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
  */
 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
  */
-declare function resultPromises<Value>(items: Promise<Value>[], signal?: AbortSignal): Promise<Result<Awaited<Value>>[]>;
+declare function resultPromises<Items extends PlainObject>(items: Items, signal?: AbortSignal): Promise<PromisesResult<PromisesItems<Items>>>;
 //#endregion
 export { attemptPromise, promises, resultPromises };

package/dist/promise/index.mjs

@@ -1,5 +1,6 @@
+import { isArrayOrPlainObject } from "../internal/is.mjs";
 import { createAborter } from "../internal/abort.mjs";
-import { PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
+import { PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY, PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
 import { createPromiseOptions, createPromisesOptions, getResultsFromPromises } from "./helpers.mjs";
 import { handleResult, settlePromise } from "./misc.mjs";
 import { getTimedPromise } from "./timed.mjs";
@@ -31,17 +32,18 @@ async function attemptPromise(value, options) {
 async function promises(items, options) {
 	const { signal, strategy } = createPromisesOptions(options);
 	if (signal?.aborted ?? false) return Promise.reject(signal?.reason);
-	if (!Array.isArray(items)) return Promise.resolve([]);
-	const actual = items.map((item) => typeof item === "function" ? item() : item).filter((item) => item instanceof Promise);
+	if (!isArrayOrPlainObject(items)) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_TYPE);
+	const isArray = Array.isArray(items);
+	const actual = (isArray ? items.map((item, index) => [index, item]) : Object.entries(items)).map(([key, value]) => [key, typeof value === "function" ? value() : value]).filter(([, value]) => value instanceof Promise);
 	const { length } = actual;
-	if (length === 0) return Promise.resolve([]);
+	if (length === 0) return Promise.reject(PROMISE_MESSAGE_EXPECTATION_ITEMS_EMPTY);
 	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
 	const aborter = createAborter(signal, () => {
 		handlers.reject(signal?.reason);
 	});
 	const data = {
 		last: length - 1,
-		result: []
+		result: isArray ? [] : {}
 	};
 	let handlers;
 	return new Promise((resolve, reject) => {
@@ -49,21 +51,24 @@ async function promises(items, options) {
 			reject,
 			resolve
 		};
-		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(PROMISE_TYPE_FULFILLED, {
-			aborter,
-			complete,
-			data,
-			handlers,
-			index,
-			value
-		})).catch((reason) => handleResult(PROMISE_TYPE_REJECTED, {
-			aborter,
-			complete,
-			data,
-			handlers,
-			index,
-			value: reason
-		}));
+		for (let index = 0; index < length; index += 1) {
+			const [key, promise] = actual[index];
+			const parameters = {
+				aborter,
+				complete,
+				data,
+				handlers,
+				index,
+				key
+			};
+			promise.then((value) => {
+				parameters.value = value;
+				handleResult(PROMISE_TYPE_FULFILLED, parameters);
+			}).catch((reason) => {
+				parameters.value = reason;
+				handleResult(PROMISE_TYPE_REJECTED, parameters);
+			});
+		}
 	});
 }
 async function resultPromises(items, signal) {

package/dist/promise/misc.mjs

@@ -14,13 +14,13 @@ function cancelable(executor) {
 	return new CancelablePromise(executor);
 }
 function handleResult(status, parameters) {
-	const { aborter, complete, data, handlers, index, value } = parameters;
+	const { aborter, complete, data, handlers, index, key, value } = parameters;
 	if (aborter?.signal.aborted ?? false) return;
 	if (!complete && status === "rejected") {
 		settlePromise(handlers.reject, value, aborter);
 		return;
 	}
-	data.result[index] = !complete ? value : status === "fulfilled" ? {
+	data.result[key] = !complete ? value : status === "fulfilled" ? {
 		status,
 		value
 	} : {

package/dist/promise/models.d.mts

@@ -1,4 +1,4 @@
-import { GenericCallback } from "../models.mjs";
+import { ArrayOrPlainObject, GenericCallback, Key } from "../models.mjs";
 import { Result } from "../internal/result/models.mjs";
 import { Aborter } from "../internal/abort.mjs";
 import { PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./constants.mjs";
@@ -31,7 +31,7 @@ type FulfilledPromise<Value> = {
 };
 type PromiseData = {
   last: number;
-  result: unknown[];
+  result: ArrayOrPlainObject;
 };
 type PromiseHandlers = {
   resolve: (value: unknown[]) => void;
@@ -56,6 +56,7 @@ type PromiseParameters = {
   data: PromiseData;
   handlers: PromiseHandlers;
   index: number;
+  key: Key;
   value?: unknown;
 };
 /**
@@ -71,7 +72,7 @@ type PromiseStrategy = 'complete' | 'first';
 declare class PromiseTimeoutError extends Error {
   constructor();
 }
-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]>; };
+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_
  */
@@ -85,10 +86,10 @@ type PromisesOptions = {
    */
   strategy?: PromiseStrategy;
 };
-type PromisesResult<Items extends unknown[]> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
-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; };
+type PromisesResult<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? Result<Awaited<Value>> : never; };
+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; };
 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; };
+type PromisesValues<Items extends ArrayOrPlainObject> = { [ItemsKey in keyof Items]: Items[ItemsKey] extends Promise<infer Value> ? PromisesValue<Awaited<Value>> : never; };
 /**
  * A _Promise_ that was rejected
  */