@oscarpalmer/atoms 0.148.0 → 0.150.0

package/dist/atoms.full.js

@@ -3009,60 +3009,22 @@ var CancelablePromise = class extends Promise {
 };
 var PromiseTimeoutError = class extends Error {
 	constructor() {
-		super(MESSAGE_TIMEOUT);
-		this.name = ERROR_NAME$1;
+		super(PROMISE_MESSAGE_TIMEOUT);
+		this.name = PROMISE_ERROR_NAME;
 	}
 };
-async function attemptPromise(value, options) {
-	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_ATTEMPT));
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	function abort() {
-		rejector(signal.reason);
-	}
-	async function handler(resolve, reject) {
-		try {
-			let result = isFunction ? value() : await value;
-			if (result instanceof Promise) result = await result;
-			settlePromise(abort, resolve, result, signal);
-		} catch (error) {
-			settlePromise(abort, reject, error, signal);
-		}
-	}
-	let rejector;
-	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
-	const promise = new Promise((resolve, reject) => {
-		rejector = reject;
-		handler(resolve, reject);
-	});
-	return time > 0 ? getTimed(promise, time, signal) : promise;
-}
-/**
-* Create a cancelable promise
-* @param executor Executor function for the promise
-* @returns Cancelable promise
-*/
-function cancelable(executor) {
-	return new CancelablePromise(executor);
-}
-function delay(options) {
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	function abort() {
-		clearTimeout(timeout);
-		rejector(signal.reason);
-	}
-	signal?.addEventListener("abort", abort, ABORT_OPTIONS);
-	let rejector;
-	let timeout;
-	return new Promise((resolve, reject) => {
-		rejector = reject;
-		timeout = setTimeout(() => {
-			settlePromise(abort, resolve, void 0, signal);
-		}, time);
-	});
-}
+const PROMISE_ABORT_OPTIONS = { once: true };
+const PROMISE_ERROR_NAME = "PromiseTimeoutError";
+const PROMISE_EVENT_NAME = "abort";
+const PROMISE_MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
+const PROMISE_MESSAGE_EXPECTATION_PROMISES = "Promises expected an array of 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";
+const PROMISE_STRATEGY_ALL = new Set(["complete", "first"]);
+const PROMISE_STRATEGY_DEFAULT = "complete";
+const PROMISE_TYPE_FULFILLED = "fulfilled";
+const PROMISE_TYPE_REJECTED = "rejected";
 function getNumberOrDefault$1(value) {
 	return typeof value === "number" && value > 0 ? value : 0;
 }
@@ -3082,7 +3044,7 @@ function getPromisesOptions(input) {
 	if (typeof input === "string") return { strategy: getStrategyOrDefault(input) };
 	if (input instanceof AbortSignal) return {
 		signal: input,
-		strategy: DEFAULT_STRATEGY
+		strategy: PROMISE_STRATEGY_DEFAULT
 	};
 	const options = typeof input === "object" && input !== null ? input : {};
 	return {
@@ -3091,35 +3053,81 @@ function getPromisesOptions(input) {
 	};
 }
 function getStrategyOrDefault(value) {
-	return strategies.has(value) ? value : DEFAULT_STRATEGY;
+	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;
 }
-async function getTimed(promise, time, signal) {
-	function abort() {
-		clearTimeout(timeout);
-		rejector(signal.reason);
-	}
-	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
-	let rejector;
-	let timeout;
-	return Promise.race([promise, new Promise((_, reject) => {
-		rejector = reject;
-		timeout = setTimeout(() => {
-			settlePromise(abort, reject, new PromiseTimeoutError(), signal);
-		}, time);
-	})]).then((value) => {
-		clearTimeout(timeout);
-		signal?.removeEventListener(EVENT_NAME$1, abort);
-		return value;
-	});
+/**
+* Is the value a fulfilled promise result?
+* @param value Value to check
+* @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?
+* @param value Value to check
+* @returns `true` if the value is a rejected promise result, `false` otherwise
+*/
+function isRejected(value) {
+	return isType(value, PROMISE_TYPE_REJECTED);
+}
+function isType(value, type) {
+	return typeof value === "object" && value !== null && value.status === type;
+}
+function error(value, original) {
+	return getError(value, original);
+}
+function getError(value, original) {
+	const errorResult = {
+		error: value,
+		ok: false
+	};
+	if (original instanceof Error) errorResult.original = original;
+	return errorResult;
+}
+/**
+* Creates an ok result
+* @param value Value
+* @returns Ok result
+*/
+function ok(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+/**
+* Converts a result to a promise
+*
+* Resolves if ok, rejects for error
+* @param result Result to convert
+* @returns Promised result
+*/
+async function toPromise(result) {
+	const actual = typeof result === "function" ? result() : result;
+	if (!isResult(actual)) return Promise.reject(new Error(MESSAGE_PROMISE_RESULT));
+	return isOk(actual) ? Promise.resolve(actual.value) : Promise.reject(actual.error);
+}
+function unwrap(value, defaultValue) {
+	return isOk(value) ? value.value : defaultValue;
+}
+const MESSAGE_PROMISE_RESULT = "toPromise expected to receive a Result";
+/**
+* Create a cancelable promise
+* @param executor Executor function for the promise
+* @returns Cancelable promise
+*/
+function cancelable(executor) {
+	return new CancelablePromise(executor);
 }
 function handleResult(status, parameters) {
 	const { abort, complete, data, handlers, index, signal, value } = parameters;
 	if (signal?.aborted ?? false) return;
-	if (!complete && status === TYPE_REJECTED) {
+	if (!complete && status === PROMISE_TYPE_REJECTED) {
 		settlePromise(abort, handlers.reject, value, signal);
 		return;
 	}
-	data.result[index] = !complete ? value : status === TYPE_FULFILLED ? {
+	data.result[index] = !complete ? value : status === PROMISE_TYPE_FULFILLED ? {
 		status,
 		value
 	} : {
@@ -3128,37 +3136,105 @@ function handleResult(status, parameters) {
 	};
 	if (index === data.last) settlePromise(abort, handlers.resolve, data.result, signal);
 }
-/**
-* Is the value a fulfilled promise result?
-* @param value Value to check
-* @returns `true` if the value is a fulfilled promise result, `false` otherwise
-*/
-function isFulfilled(value) {
-	return isType(value, TYPE_FULFILLED);
+function settlePromise(aborter, settler, value, signal) {
+	signal?.removeEventListener(PROMISE_EVENT_NAME, aborter);
+	settler(value);
 }
-/**
-* Is the value a rejected promise result?
-* @param value Value to check
-* @returns `true` if the value is a rejected promise result, `false` otherwise
-*/
-function isRejected(value) {
-	return isType(value, TYPE_REJECTED);
+async function toResult(value) {
+	const actual = typeof value === "function" ? value() : value;
+	if (!(actual instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_RESULT));
+	return actual.then((result) => ok(result)).catch((reason) => error(reason));
 }
-function isType(value, type) {
-	return typeof value === "object" && value !== null && value.status === type;
+async function getTimedPromise(promise, time, signal) {
+	function abort() {
+		cancelAnimationFrame(frame);
+		rejector(signal.reason);
+	}
+	function run(now) {
+		start ??= now;
+		if (time === 0 || now - start >= time - 5) settlePromise(abort, rejector, new PromiseTimeoutError(), signal);
+		else frame = requestAnimationFrame(run);
+	}
+	signal?.addEventListener(PROMISE_EVENT_NAME, abort, PROMISE_ABORT_OPTIONS);
+	let frame;
+	let rejector;
+	let start;
+	return Promise.race([promise, new Promise((_, reject) => {
+		rejector = reject;
+		frame = requestAnimationFrame(run);
+	})]).then((value) => {
+		cancelAnimationFrame(frame);
+		signal?.removeEventListener(PROMISE_EVENT_NAME, abort);
+		return value;
+	});
+}
+async function timed(promise, options) {
+	if (!(promise instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_TIMED));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	return time > 0 ? getTimedPromise(promise, time, signal) : promise;
+}
+function delay(options) {
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		cancelAnimationFrame(frame);
+		rejector(signal.reason);
+	}
+	function run(now) {
+		start ??= now;
+		if (now - start >= time - 5) settlePromise(abort, resolver, void 0, signal);
+		else frame = requestAnimationFrame(run);
+	}
+	signal?.addEventListener("abort", abort, PROMISE_ABORT_OPTIONS);
+	let frame;
+	let rejector;
+	let resolver;
+	let start;
+	return new Promise((resolve, reject) => {
+		rejector = reject;
+		resolver = resolve;
+		if (time === 0) settlePromise(abort, resolve, void 0, signal);
+		else frame = requestAnimationFrame(run);
+	});
+}
+async function attemptPromise(value, options) {
+	const isFunction = typeof value === "function";
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_ATTEMPT));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		rejector(signal.reason);
+	}
+	async function handler(resolve, reject) {
+		try {
+			let result = isFunction ? value() : await value;
+			if (result instanceof Promise) result = await result;
+			settlePromise(abort, resolve, result, signal);
+		} catch (error) {
+			settlePromise(abort, reject, error, signal);
+		}
+	}
+	let rejector;
+	signal?.addEventListener(PROMISE_EVENT_NAME, abort, PROMISE_ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
+		rejector = reject;
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimedPromise(promise, time, signal) : promise;
 }
 async function promises(items, options) {
 	const { signal, strategy } = getPromisesOptions(options);
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	if (!Array.isArray(items)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_PROMISES));
+	if (!Array.isArray(items)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_PROMISES));
 	const actual = items.filter((item) => item instanceof Promise);
 	const { length } = actual;
 	if (length === 0) return actual;
-	const complete = strategy === DEFAULT_STRATEGY;
+	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
 	function abort() {
 		handlers.reject(signal.reason);
 	}
-	signal?.addEventListener("abort", abort, ABORT_OPTIONS);
+	signal?.addEventListener("abort", abort, PROMISE_ABORT_OPTIONS);
 	const data = {
 		last: length - 1,
 		result: []
@@ -3169,7 +3245,7 @@ async function promises(items, options) {
 			reject,
 			resolve
 		};
-		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(TYPE_FULFILLED, {
+		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(PROMISE_TYPE_FULFILLED, {
 			abort,
 			complete,
 			data,
@@ -3177,7 +3253,7 @@ async function promises(items, options) {
 			index,
 			signal,
 			value
-		})).catch((reason) => handleResult(TYPE_REJECTED, {
+		})).catch((reason) => handleResult(PROMISE_TYPE_REJECTED, {
 			abort,
 			complete,
 			data,
@@ -3188,27 +3264,6 @@ async function promises(items, options) {
 		}));
 	});
 }
-function settlePromise(aborter, settler, value, signal) {
-	signal?.removeEventListener(EVENT_NAME$1, aborter);
-	settler(value);
-}
-async function timed(promise, options) {
-	if (!(promise instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_TIMED));
-	const { signal, time } = getPromiseOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
-	return time > 0 ? getTimed(promise, time, signal) : promise;
-}
-const ABORT_OPTIONS = { once: true };
-const DEFAULT_STRATEGY = "complete";
-const ERROR_NAME$1 = "PromiseTimeoutError";
-const EVENT_NAME$1 = "abort";
-const MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
-const MESSAGE_EXPECTATION_PROMISES = "Promises expected an array of promises";
-const MESSAGE_EXPECTATION_TIMED = "Timed function expected a Promise";
-const MESSAGE_TIMEOUT = "Promise timed out";
-const strategies = new Set(["complete", "first"]);
-const TYPE_FULFILLED = "fulfilled";
-const TYPE_REJECTED = "rejected";
 /**
 * Convert a query string to a plain _(nested)_ object
 * @param query Query string to convert
@@ -3536,6 +3591,29 @@ const ALPHABET = "abcdefghijklmnopqrstuvwxyz";
 const BOOLEAN_MODIFIER = .5;
 const HEX_CHARACTERS = "0123456789ABCDEF";
 const HEX_MAXIMUM = 15;
+async function asyncMatchResult(result, first, error) {
+	let value;
+	if (typeof result === "function") value = await result();
+	else if (result instanceof Promise) value = await result;
+	else value = result;
+	if (!isResult(value)) throw new Error(MESSAGE_RESULT);
+	const hasObj = typeof first === "object" && first !== null;
+	const okHandler = hasObj ? first.ok : first;
+	const errorHandler = hasObj ? first.error : error;
+	if (isOk(value)) return okHandler(value.value);
+	return errorHandler(value.error, value.original);
+}
+function matchResult(result, first, error) {
+	const value = typeof result === "function" ? result() : result;
+	if (!isResult(value)) throw new Error(MESSAGE_RESULT);
+	const hasObj = typeof first === "object" && first !== null;
+	const okHandler = hasObj ? first.ok : first;
+	const errorHandler = hasObj ? first.error : error;
+	if (isOk(value)) return okHandler(value.value);
+	return errorHandler(value.error, value.original);
+}
+matchResult.async = asyncMatchResult;
+const MESSAGE_RESULT = "`result.match` expected a Result or a function that returns a Result";
 function attemptAsyncFlow(...fns) {
 	let Flow;
 	return (...args) => attempt.async(() => {
@@ -3592,33 +3670,9 @@ function attempt(callback, err) {
 }
 attempt.async = asyncAttempt;
 attempt.flow = attemptFlow;
+attempt.match = matchResult;
 attempt.pipe = attemptPipe;
 attempt.promise = attemptPromise;
-function error(value, original) {
-	return getError(value, original);
-}
-function getError(value, original) {
-	const errorResult = {
-		error: value,
-		ok: false
-	};
-	if (original instanceof Error) errorResult.original = original;
-	return errorResult;
-}
-/**
-* Creates an ok result
-* @param value Value
-* @returns Ok result
-*/
-function ok(value) {
-	return {
-		ok: true,
-		value
-	};
-}
-function unwrap(value, defaultValue) {
-	return isOk(value) ? value.value : defaultValue;
-}
 /**
 * - A Set with a maximum size
 * - Behavior is similar to a _LRU_-cache, where the oldest values are removed
@@ -3671,4 +3725,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, toResult, fromQuery, toPromise as fromResult, toPromise, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/index.js

@@ -60,10 +60,16 @@ import { unsmush } from "./value/unsmush.js";
 import { isEmpty, isInstanceOf, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
 import { logger } from "./logger.js";
 import { average, ceil, count, floor, median, min, round, sum } from "./math.js";
-import { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, isFulfilled, isRejected, promises, timed } from "./promise.js";
+import { CancelablePromise, PromiseTimeoutError } from "./promise/models.js";
+import { isFulfilled, isRejected } from "./promise/helpers.js";
+import { error, ok, toPromise, unwrap } from "./result/misc.js";
+import { cancelable, toResult } from "./promise/misc.js";
+import { timed } from "./promise/timed.js";
+import { delay } from "./promise/delay.js";
+import { attemptPromise, promises } from "./promise/index.js";
 import { fromQuery, toQuery } from "./query.js";
 import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
-import { attempt, error, ok, unwrap } from "./result/index.js";
+import { attempt } from "./result/index.js";
 import { SizedSet } from "./sized/set.js";
-export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, fromQuery, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toQuery, toRecord, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, ceil, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, floor, flow, toResult as fromPromise, fromQuery, toPromise as fromResult, getArray, getColor, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getString, getUuid, getValue, groupBy, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, includes, indexOf, insert, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, median, memoize, merge, min, noop, ok, omit, parse, partition, pascalCase, pick, pipe, promises, push, queue, range, rgbToHex, rgbToHsl, rgbToHsla, round, select, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, times, titleCase, toMap, toPromise, toQuery, toRecord, toResult, toSet, toggle, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, update, upperCase, words };

package/dist/promise/delay.js

@@ -0,0 +1,28 @@
+import { PROMISE_ABORT_OPTIONS } from "./models.js";
+import { getPromiseOptions } from "./helpers.js";
+import { settlePromise } from "./misc.js";
+function delay(options) {
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		cancelAnimationFrame(frame);
+		rejector(signal.reason);
+	}
+	function run(now) {
+		start ??= now;
+		if (now - start >= time - 5) settlePromise(abort, resolver, void 0, signal);
+		else frame = requestAnimationFrame(run);
+	}
+	signal?.addEventListener("abort", abort, PROMISE_ABORT_OPTIONS);
+	let frame;
+	let rejector;
+	let resolver;
+	let start;
+	return new Promise((resolve, reject) => {
+		rejector = reject;
+		resolver = resolve;
+		if (time === 0) settlePromise(abort, resolve, void 0, signal);
+		else frame = requestAnimationFrame(run);
+	});
+}
+export { delay };

package/dist/promise/helpers.js

@@ -0,0 +1,51 @@
+import { PROMISE_STRATEGY_ALL, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED } from "./models.js";
+function getNumberOrDefault(value) {
+	return typeof value === "number" && value > 0 ? value : 0;
+}
+function getPromiseOptions(input) {
+	if (typeof input === "number") return { time: getNumberOrDefault(input) };
+	if (input instanceof AbortSignal) return {
+		signal: input,
+		time: 0
+	};
+	const options = typeof input === "object" && input !== null ? input : {};
+	return {
+		signal: options.signal instanceof AbortSignal ? options.signal : void 0,
+		time: getNumberOrDefault(options.time)
+	};
+}
+function getPromisesOptions(input) {
+	if (typeof input === "string") return { strategy: getStrategyOrDefault(input) };
+	if (input instanceof AbortSignal) return {
+		signal: input,
+		strategy: PROMISE_STRATEGY_DEFAULT
+	};
+	const options = typeof input === "object" && input !== null ? input : {};
+	return {
+		signal: options.signal instanceof AbortSignal ? options.signal : void 0,
+		strategy: getStrategyOrDefault(options.strategy)
+	};
+}
+function getStrategyOrDefault(value) {
+	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;
+}
+/**
+* Is the value a fulfilled promise result?
+* @param value Value to check
+* @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?
+* @param value Value to check
+* @returns `true` if the value is a rejected promise result, `false` otherwise
+*/
+function isRejected(value) {
+	return isType(value, PROMISE_TYPE_REJECTED);
+}
+function isType(value, type) {
+	return typeof value === "object" && value !== null && value.status === type;
+}
+export { getPromiseOptions, getPromisesOptions, getStrategyOrDefault, isFulfilled, isRejected };

package/dist/promise/index.js

@@ -0,0 +1,73 @@
+import { CancelablePromise, PROMISE_ABORT_OPTIONS, PROMISE_EVENT_NAME, PROMISE_MESSAGE_EXPECTATION_ATTEMPT, PROMISE_MESSAGE_EXPECTATION_PROMISES, PROMISE_STRATEGY_DEFAULT, PROMISE_TYPE_FULFILLED, PROMISE_TYPE_REJECTED, PromiseTimeoutError } from "./models.js";
+import { getPromiseOptions, getPromisesOptions, isFulfilled, isRejected } from "./helpers.js";
+import { toPromise } from "../result/misc.js";
+import { cancelable, handleResult, settlePromise, toResult } from "./misc.js";
+import { getTimedPromise, timed } from "./timed.js";
+import { delay } from "./delay.js";
+async function attemptPromise(value, options) {
+	const isFunction = typeof value === "function";
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_ATTEMPT));
+	const { signal, time } = getPromiseOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	function abort() {
+		rejector(signal.reason);
+	}
+	async function handler(resolve, reject) {
+		try {
+			let result = isFunction ? value() : await value;
+			if (result instanceof Promise) result = await result;
+			settlePromise(abort, resolve, result, signal);
+		} catch (error) {
+			settlePromise(abort, reject, error, signal);
+		}
+	}
+	let rejector;
+	signal?.addEventListener(PROMISE_EVENT_NAME, abort, PROMISE_ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
+		rejector = reject;
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimedPromise(promise, time, signal) : promise;
+}
+async function promises(items, options) {
+	const { signal, strategy } = getPromisesOptions(options);
+	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
+	if (!Array.isArray(items)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_PROMISES));
+	const actual = items.filter((item) => item instanceof Promise);
+	const { length } = actual;
+	if (length === 0) return actual;
+	const complete = strategy === PROMISE_STRATEGY_DEFAULT;
+	function abort() {
+		handlers.reject(signal.reason);
+	}
+	signal?.addEventListener("abort", abort, PROMISE_ABORT_OPTIONS);
+	const data = {
+		last: length - 1,
+		result: []
+	};
+	let handlers;
+	return new Promise((resolve, reject) => {
+		handlers = {
+			reject,
+			resolve
+		};
+		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(PROMISE_TYPE_FULFILLED, {
+			abort,
+			complete,
+			data,
+			handlers,
+			index,
+			signal,
+			value
+		})).catch((reason) => handleResult(PROMISE_TYPE_REJECTED, {
+			abort,
+			complete,
+			data,
+			handlers,
+			index,
+			signal,
+			value: reason
+		}));
+	});
+}
+export { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, toPromise as fromResult, isFulfilled, isRejected, promises, timed, toResult };

package/dist/promise/misc.js

@@ -0,0 +1,36 @@
+import { CancelablePromise, PROMISE_EVENT_NAME, PROMISE_MESSAGE_EXPECTATION_RESULT } from "./models.js";
+import { error, ok } from "../result/misc.js";
+/**
+* Create a cancelable promise
+* @param executor Executor function for the promise
+* @returns Cancelable promise
+*/
+function cancelable(executor) {
+	return new CancelablePromise(executor);
+}
+function handleResult(status, parameters) {
+	const { abort, complete, data, handlers, index, signal, value } = parameters;
+	if (signal?.aborted ?? false) return;
+	if (!complete && status === "rejected") {
+		settlePromise(abort, handlers.reject, value, signal);
+		return;
+	}
+	data.result[index] = !complete ? value : status === "fulfilled" ? {
+		status,
+		value
+	} : {
+		status,
+		reason: value
+	};
+	if (index === data.last) settlePromise(abort, handlers.resolve, data.result, signal);
+}
+function settlePromise(aborter, settler, value, signal) {
+	signal?.removeEventListener(PROMISE_EVENT_NAME, aborter);
+	settler(value);
+}
+async function toResult(value) {
+	const actual = typeof value === "function" ? value() : value;
+	if (!(actual instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_RESULT));
+	return actual.then((result) => ok(result)).catch((reason) => error(reason));
+}
+export { cancelable, handleResult, settlePromise, toResult };