@oscarpalmer/atoms 0.141.2 → 0.143.0

package/dist/atoms.full.js

@@ -273,24 +273,27 @@ function aggregate(type, array, key) {
 		value: NaN
 	};
 	const aggregator = aggregators[type];
-	const isCallback = typeof key === "function";
+	const callback = getAggregateCallback(key);
 	let counted = 0;
 	let aggregated = NaN;
 	let notNumber = true;
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
-		const value = isCallback ? key(item, index, array) : item[key] ?? item;
-		if (typeof value === "number" && !Number.isNaN(value)) {
-			aggregated = aggregator(aggregated, value, notNumber);
-			counted += 1;
-			notNumber = false;
-		}
+		const value = callback == null ? item : callback(item, index, array);
+		if (!isNumber(value)) continue;
+		aggregated = aggregator(aggregated, value, notNumber);
+		counted += 1;
+		notNumber = false;
 	}
 	return {
 		count: counted,
 		value: aggregated
 	};
 }
+function getAggregateCallback(key) {
+	if (key == null) return;
+	return typeof key === "function" ? key : (item) => item[key];
+}
 function max(array, key) {
 	return getAggregated("max", array, key);
 }
@@ -665,7 +668,7 @@ function clamp(value, minimum, maximum, loop) {
 /**
 * Get the number value from an unknown value _(based on Lodash)_
 * @param value Original value
-* @returns The value as a number, or `NaN` if the value is unable to be parsed
+* @returns Original value as a number, or `NaN` if the value is unable to be parsed
 */
 function getNumber(value) {
 	if (typeof value === "number") return value;
@@ -699,7 +702,7 @@ const MAXIMUM_DEFAULT = 1048576;
 /**
 * A Map with a maximum size
 *
-* Behaviour is similar to a _LRU_-cache, where the least recently used entries are removed
+* Behavior is similar to a _LRU_-cache, where the least recently used entries are removed
 */
 var SizedMap = class extends Map {
 	/**
@@ -795,7 +798,7 @@ var Memoized = class {
 	/**
 	* Get a result from the cache
 	* @param key Key to get
-	* @returns The cached result or `undefined` if it does not exist
+	* @returns Cached result or `undefined` if it does not exist
 	*/
 	get(key) {
 		return this.#state.cache?.get(key);
@@ -1637,22 +1640,37 @@ function mergeValues(values, options, validate, prefix) {
 	const actual = validate ? values.filter(isArrayOrPlainObject) : values;
 	return actual.length > 1 ? mergeObjects(actual, options, prefix) : actual[0] ?? {};
 }
-/**
-* Create a new object with only the specified keys
-* @param value Original object
-* @param keys Keys to use
-* @returns Partial object with only the specified keys
-*/
-function partial(value, keys) {
-	if (typeof value !== "object" || value === null || Object.keys(value).length === 0 || !Array.isArray(keys) || keys.length === 0) return {};
+function partial(value, providedKeys, omit) {
+	if (typeof value !== "object" || value === null) return {};
+	const keys = omit ? Object.keys(value) : Array.isArray(providedKeys) ? providedKeys : [];
 	const { length } = keys;
+	if (length === 0) return omit ? value : {};
 	const partials = {};
 	for (let index = 0; index < length; index += 1) {
 		const key = keys[index];
-		if (key in value) partials[key] = value[key];
+		if (!(key in value)) continue;
+		if (omit ? !providedKeys.includes(key) : true) partials[key] = value[key];
 	}
 	return partials;
 }
+/**
+* Create a new object without the specified keys
+* @param value Original object
+* @param keys Keys to omit
+* @returns Partial object without the specified keys
+*/
+function omit(value, keys) {
+	return partial(value, keys, true);
+}
+/**
+* Create a new object with only the specified keys
+* @param value Original object
+* @param keys Keys to use
+* @returns Partial object with only the specified keys
+*/
+function pick(value, keys) {
+	return partial(value, keys, false);
+}
 function flattenObject(value, depth, smushed, prefix) {
 	if (depth >= MAX_DEPTH) return {};
 	if (smushed.has(value)) return smushed.get(value);
@@ -1983,7 +2001,7 @@ function isBytey(value) {
 }
 /**
 * Is the value a Color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is a Color, otherwise `false`
 */
 function isColor(value) {
@@ -2005,7 +2023,7 @@ function isDegree(value) {
 }
 /**
 * Is the value a hex color?
-* @param value The value to check
+* @param value Value to check
 * @param alpha Allow alpha channel? _(defaults to `true`)_
 * @returns `true` if the value is a hex color, otherwise `false`
 */
@@ -2017,7 +2035,7 @@ function isHexColor(value, alpha) {
 }
 /**
 * Is the value an HSLA color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an HSLA color, otherwise `false`
 */
 function isHslaColor(value) {
@@ -2025,7 +2043,7 @@ function isHslaColor(value) {
 }
 /**
 * Is the value an HSL color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an HSL color, otherwise `false`
 */
 function isHslColor(value) {
@@ -2036,7 +2054,7 @@ function isHslLike(value) {
 }
 /**
 * Is the value an RGBA color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an RGBA color, otherwise `false`
 */
 function isRgbaColor(value) {
@@ -2044,7 +2062,7 @@ function isRgbaColor(value) {
 }
 /**
 * Is the value an RGB color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an RGB color, otherwise `false`
 */
 function isRgbColor(value) {
@@ -2544,8 +2562,8 @@ function getColor(value) {
 }
 /**
 * Is the value empty, or only containing `null` or `undefined` values?
-* @param value Object to check
-* @returns `true` if the object is considered empty, otherwise `false`
+* @param value Value to check
+* @returns `true` if the value is considered empty, otherwise `false`
 */
 function isEmpty(value) {
 	if (value == null) return true;
@@ -2556,6 +2574,14 @@ function isEmpty(value) {
 	return true;
 }
 /**
+* Is the value not `undefined` or `null`?
+* @param value Value to check
+* @returns `true` if the value is not `undefined` or `null`, otherwise `false`
+*/
+function isNonNullable(value) {
+	return value != null;
+}
+/**
 * Is the value `undefined` or `null`?
 * @param value Value to check
 * @returns `true` if the value is `undefined` or `null`, otherwise `false`
@@ -2723,9 +2749,8 @@ function average(array, key) {
 function count(array, key, value) {
 	if (!Array.isArray(array)) return NaN;
 	const { length } = array;
-	if (key == null) return length;
-	if (typeof key !== "string" && typeof key !== "function") return NaN;
-	const callback = typeof key === "function" ? key : (item) => item[key];
+	const callback = getAggregateCallback(key);
+	if (callback == null) return length;
 	let counted = 0;
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
@@ -2733,6 +2758,22 @@ function count(array, key, value) {
 	}
 	return counted;
 }
+function median(array, key) {
+	let length = Array.isArray(array) ? array.length : 0;
+	if (!Array.isArray(array) || length === 0) return NaN;
+	if (length === 1) return isNumber(array[0]) ? array[0] : NaN;
+	let values = array;
+	const callback = getAggregateCallback(key);
+	if (callback != null) values = array.map((item, index) => callback(item, index, array));
+	const numbers = values.filter(isNumber).sort((first, second) => first - second);
+	length = numbers.length;
+	if (length % 2 === 0) {
+		const first = length / 2 - 1;
+		const second = length / 2;
+		return (numbers[first] + numbers[second]) / 2;
+	}
+	return numbers[Math.floor(length / 2)];
+}
 function min(array, key) {
 	return getAggregated("min", array, key);
 }
@@ -2751,12 +2792,38 @@ function round(value, decimals) {
 function sum(array, key) {
 	return getAggregated("sum", array, key);
 }
+var CancelablePromise = class extends Promise {
+	#rejector;
+	constructor(executor) {
+		let rejector;
+		super((resolve, reject) => {
+			rejector = reject;
+			executor(resolve, reject);
+		});
+		this.#rejector = rejector;
+	}
+	/**
+	* Cancel the promise, rejecting it with an optional reason
+	* @param reason Optional reason for canceling the promise
+	*/
+	cancel(reason) {
+		this.#rejector(reason);
+	}
+};
 var PromiseTimeoutError = class extends Error {
 	constructor() {
 		super(MESSAGE_TIMEOUT);
 		this.name = ERROR_NAME$1;
 	}
 };
+/**
+* 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);
@@ -2764,25 +2831,25 @@ function delay(options) {
 		clearTimeout(timeout);
 		rejector(signal.reason);
 	}
-	signal?.addEventListener("abort", abort, abortOptions$1);
+	signal?.addEventListener("abort", abort, ABORT_OPTIONS);
 	let rejector;
 	let timeout;
 	return new Promise((resolve, reject) => {
 		rejector = reject;
 		timeout = setTimeout(() => {
-			signal?.removeEventListener("abort", abort);
-			resolve();
+			settlePromise(abort, resolve, void 0, signal);
 		}, time);
 	});
 }
-function getBooleanOrDefault$1(value, defaultValue) {
-	return typeof value === "boolean" ? value : defaultValue;
-}
 function getNumberOrDefault$1(value) {
 	return typeof value === "number" && value > 0 ? value : 0;
 }
 function getPromiseOptions(input) {
 	if (typeof input === "number") return { time: getNumberOrDefault$1(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,
@@ -2790,32 +2857,54 @@ function getPromiseOptions(input) {
 	};
 }
 function getPromisesOptions(input) {
-	if (typeof input === "boolean") return { eager: input };
+	if (typeof input === "string") return { strategy: getStrategyOrDefault(input) };
 	if (input instanceof AbortSignal) return {
-		eager: false,
-		signal: input
+		signal: input,
+		strategy: DEFAULT_STRATEGY
 	};
 	const options = typeof input === "object" && input !== null ? input : {};
 	return {
-		eager: getBooleanOrDefault$1(options.eager, false),
-		signal: options.signal instanceof AbortSignal ? options.signal : void 0
+		signal: options.signal instanceof AbortSignal ? options.signal : void 0,
+		strategy: getStrategyOrDefault(options.strategy)
 	};
 }
+function getStrategyOrDefault(value) {
+	return strategies.has(value) ? value : DEFAULT_STRATEGY;
+}
+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;
+	});
+}
 function handleResult(status, parameters) {
-	const { data, eager, handlers, index, signal, value } = parameters;
+	const { abort, complete, data, handlers, index, signal, value } = parameters;
 	if (signal?.aborted ?? false) return;
-	if (eager && status === TYPE_REJECTED) {
-		handlers.reject(value);
+	if (!complete && status === TYPE_REJECTED) {
+		settlePromise(abort, handlers.reject, value, signal);
 		return;
 	}
-	data.result[index] = eager ? value : status === TYPE_FULFILLED ? {
+	data.result[index] = !complete ? value : status === TYPE_FULFILLED ? {
 		status,
 		value
 	} : {
 		status,
 		reason: value
 	};
-	if (index === data.last) handlers.resolve(data.result);
+	if (index === data.last) settlePromise(abort, handlers.resolve, data.result, signal);
 }
 /**
 * Is the value a fulfilled promise result?
@@ -2837,15 +2926,17 @@ function isType(value, type) {
 	return typeof value === "object" && value !== null && value.status === type;
 }
 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));
 	const actual = items.filter((item) => item instanceof Promise);
 	const { length } = actual;
-	const { eager, signal } = getPromisesOptions(options);
-	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	if (length === 0) return actual;
+	const complete = strategy === DEFAULT_STRATEGY;
 	function abort() {
 		handlers.reject(signal.reason);
 	}
-	signal?.addEventListener("abort", abort, abortOptions$1);
+	signal?.addEventListener("abort", abort, ABORT_OPTIONS);
 	const data = {
 		last: length - 1,
 		result: []
@@ -2857,15 +2948,17 @@ async function promises(items, options) {
 			resolve
 		};
 		for (let index = 0; index < length; index += 1) actual[index].then((value) => handleResult(TYPE_FULFILLED, {
+			abort,
+			complete,
 			data,
-			eager,
 			handlers,
 			index,
 			signal,
 			value
 		})).catch((reason) => handleResult(TYPE_REJECTED, {
+			abort,
+			complete,
 			data,
-			eager,
 			handlers,
 			index,
 			signal,
@@ -2873,31 +2966,50 @@ async function promises(items, options) {
 		}));
 	});
 }
-function timed(promise, options) {
-	if (!(promise instanceof Promise)) throw new TypeError(MESSAGE_EXPECTATION);
+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;
+}
+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);
-	if (time <= 0) return promise;
 	function abort() {
-		clearTimeout(timeout);
 		rejector(signal.reason);
 	}
-	signal?.addEventListener(EVENT_NAME$1, abort, abortOptions$1);
+	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;
-	let timeout;
-	return Promise.race([promise, new Promise((_, reject) => {
+	signal?.addEventListener(EVENT_NAME$1, abort, ABORT_OPTIONS);
+	const promise = new Promise((resolve, reject) => {
 		rejector = reject;
-		timeout = setTimeout(() => {
-			signal?.removeEventListener(EVENT_NAME$1, abort);
-			reject(new PromiseTimeoutError());
-		}, time);
-	})]);
+		handler(resolve, reject);
+	});
+	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-const abortOptions$1 = { once: true };
+const ABORT_OPTIONS = { once: true };
+const DEFAULT_STRATEGY = "complete";
 const ERROR_NAME$1 = "PromiseTimeoutError";
 const EVENT_NAME$1 = "abort";
-const MESSAGE_EXPECTATION = "Timed function expected a Promise";
+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";
 /**
@@ -3272,17 +3384,18 @@ function ok(value) {
 		value
 	};
 }
-function result(callback, err) {
+function attempt(callback, err) {
 	try {
 		return ok(callback());
 	} catch (thrown) {
 		return getError(err ?? thrown, err == null ? void 0 : thrown);
 	}
 }
-result.async = asyncResult;
-async function asyncResult(callback, err) {
+attempt.async = asyncAttempt;
+attempt.promise = attemptPromise;
+async function asyncAttempt(value, err) {
 	try {
-		return ok(await callback());
+		return ok(await (typeof value === "function" ? value() : value));
 	} catch (thrown) {
 		return getError(err ?? thrown, err == null ? void 0 : thrown);
 	}
@@ -3292,7 +3405,7 @@ function unwrap(value, defaultValue) {
 }
 /**
 * - A Set with a maximum size
-* - Behaviour is similar to a _LRU_-cache, where the oldest values are removed
+* - Behavior is similar to a _LRU_-cache, where the oldest values are removed
 */
 var SizedSet = class extends Set {
 	/**
@@ -3330,7 +3443,7 @@ var SizedSet = class extends Set {
 	* Get a value from the SizedSet, if it exists _(and move it to the end)_
 	* @param value Value to get from the SizedSet
 	* @param update Update the value's position in the SizedSet? _(defaults to `false`)_
-	* @returns The value if it exists, otherwise `undefined`
+	* @returns Found value if it exists, otherwise `undefined`
 	*/
 	get(value, update) {
 		if (this.has(value)) {
@@ -3342,4 +3455,4 @@ var SizedSet = class extends Set {
 		}
 	}
 };
-export { frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, average, beacon, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, 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, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, memoize, merge, min, noop, ok, parse, partial, pascalCase, promises, push, queue, result, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, 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, 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, pascalCase, pick, promises, push, queue, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };

package/dist/color/misc/is.js

@@ -11,7 +11,7 @@ function isBytey(value) {
 }
 /**
 * Is the value a Color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is a Color, otherwise `false`
 */
 function isColor(value) {
@@ -33,7 +33,7 @@ function isDegree(value) {
 }
 /**
 * Is the value a hex color?
-* @param value The value to check
+* @param value Value to check
 * @param alpha Allow alpha channel? _(defaults to `true`)_
 * @returns `true` if the value is a hex color, otherwise `false`
 */
@@ -45,7 +45,7 @@ function isHexColor(value, alpha) {
 }
 /**
 * Is the value an HSLA color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an HSLA color, otherwise `false`
 */
 function isHslaColor(value) {
@@ -53,7 +53,7 @@ function isHslaColor(value) {
 }
 /**
 * Is the value an HSL color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an HSL color, otherwise `false`
 */
 function isHslColor(value) {
@@ -64,7 +64,7 @@ function isHslLike(value) {
 }
 /**
 * Is the value an RGBA color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an RGBA color, otherwise `false`
 */
 function isRgbaColor(value) {
@@ -72,7 +72,7 @@ function isRgbaColor(value) {
 }
 /**
 * Is the value an RGB color?
-* @param value The value to check
+* @param value Value to check
 * @returns `true` if the value is an RGB color, otherwise `false`
 */
 function isRgbColor(value) {

package/dist/function/memoize.js

@@ -54,7 +54,7 @@ var Memoized = class {
 	/**
 	* Get a result from the cache
 	* @param key Key to get
-	* @returns The cached result or `undefined` if it does not exist
+	* @returns Cached result or `undefined` if it does not exist
 	*/
 	get(key) {
 		return this.#state.cache?.get(key);

package/dist/index.js

@@ -45,16 +45,17 @@ import { template } from "./string/template.js";
 import { clone } from "./value/clone.js";
 import { diff } from "./value/diff.js";
 import { merge } from "./value/merge.js";
-import { partial } from "./value/partial.js";
+import { omit } from "./value/omit.js";
+import { pick } from "./value/pick.js";
 import { smush } from "./value/smush.js";
 import { unsmush } from "./value/unsmush.js";
-import { isEmpty, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
+import { isEmpty, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumerical, isObject, isPrimitive } from "./is.js";
 import { logger } from "./logger.js";
-import { average, count, min, round, sum } from "./math.js";
-import { PromiseTimeoutError, delay, isFulfilled, isRejected, promises, timed } from "./promise.js";
+import { average, count, median, min, round, sum } from "./math.js";
+import { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, isFulfilled, isRejected, promises, timed } from "./promise.js";
 import { fromQuery, toQuery } from "./query.js";
 import { QueueError, queue } from "./queue.js";
 import { getRandomBoolean, getRandomCharacters, getRandomColor, getRandomHex, getRandomItem, getRandomItems } from "./random.js";
-import { error, isError, isOk, isResult, ok, result, unwrap } from "./result.js";
+import { attempt, error, isError, isOk, isResult, ok, unwrap } from "./result.js";
 import { SizedSet } from "./sized/set.js";
-export { frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, average, beacon, between, camelCase, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, 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, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isTypedArray, join, kebabCase, logger, lowerCase, max, memoize, merge, min, noop, ok, parse, partial, pascalCase, promises, push, queue, result, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };
+export { CancelablePromise, frame_rate_default as FRAME_RATE_MS, PromiseTimeoutError, QueueError, SizedMap, SizedSet, attempt, attemptPromise, average, beacon, between, camelCase, cancelable, capitalize, chunk, clamp, clone, compact, compare, count, debounce, delay, diff, endsWith, equal, error, exists, filter, find, flatten, 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, 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, pascalCase, pick, promises, push, queue, rgbToHex, rgbToHsl, rgbToHsla, round, setValue, shuffle, smush, snakeCase, sort, splice, startsWith, sum, template, throttle, timed, titleCase, toMap, toQuery, toRecord, toSet, trim, truncate, tryDecode, tryEncode, unique, unsmush, unwrap, upperCase, words };

package/dist/internal/math/aggregate.js

@@ -1,3 +1,4 @@
+import { isNumber } from "../is.js";
 function aggregate(type, array, key) {
 	const length = Array.isArray(array) ? array.length : 0;
 	if (length === 0) return {
@@ -5,24 +6,27 @@ function aggregate(type, array, key) {
 		value: NaN
 	};
 	const aggregator = aggregators[type];
-	const isCallback = typeof key === "function";
+	const callback = getAggregateCallback(key);
 	let counted = 0;
 	let aggregated = NaN;
 	let notNumber = true;
 	for (let index = 0; index < length; index += 1) {
 		const item = array[index];
-		const value = isCallback ? key(item, index, array) : item[key] ?? item;
-		if (typeof value === "number" && !Number.isNaN(value)) {
-			aggregated = aggregator(aggregated, value, notNumber);
-			counted += 1;
-			notNumber = false;
-		}
+		const value = callback == null ? item : callback(item, index, array);
+		if (!isNumber(value)) continue;
+		aggregated = aggregator(aggregated, value, notNumber);
+		counted += 1;
+		notNumber = false;
 	}
 	return {
 		count: counted,
 		value: aggregated
 	};
 }
+function getAggregateCallback(key) {
+	if (key == null) return;
+	return typeof key === "function" ? key : (item) => item[key];
+}
 function max(array, key) {
 	return getAggregated("max", array, key);
 }
@@ -39,4 +43,4 @@ var aggregators = {
 	min: (current, value, notNumber) => notNumber || value < current ? value : current,
 	sum: calculateSum
 };
-export { aggregate, getAggregated, max };
+export { aggregate, getAggregateCallback, getAggregated, max };

package/dist/internal/number.js

@@ -35,7 +35,7 @@ function clamp(value, minimum, maximum, loop) {
 /**
 * Get the number value from an unknown value _(based on Lodash)_
 * @param value Original value
-* @returns The value as a number, or `NaN` if the value is unable to be parsed
+* @returns Original value as a number, or `NaN` if the value is unable to be parsed
 */
 function getNumber(value) {
 	if (typeof value === "number") return value;

package/dist/internal/value/partial.js

@@ -0,0 +1,14 @@
+function partial(value, providedKeys, omit) {
+	if (typeof value !== "object" || value === null) return {};
+	const keys = omit ? Object.keys(value) : Array.isArray(providedKeys) ? providedKeys : [];
+	const { length } = keys;
+	if (length === 0) return omit ? value : {};
+	const partials = {};
+	for (let index = 0; index < length; index += 1) {
+		const key = keys[index];
+		if (!(key in value)) continue;
+		if (omit ? !providedKeys.includes(key) : true) partials[key] = value[key];
+	}
+	return partials;
+}
+export { partial };