@oscarpalmer/atoms 0.142.0 → 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);
@@ -2909,9 +2976,9 @@ async function timed(promise, options) {
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-async function tryPromise(value, options) {
+async function attemptPromise(value, options) {
 	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_TRY));
+	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() {
@@ -2938,9 +3005,9 @@ 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_EXPECTATION_TRY = "TryPromise expected a function or a promise";
 const MESSAGE_TIMEOUT = "Promise timed out";
 const strategies = new Set(["complete", "first"]);
 const TYPE_FULFILLED = "fulfilled";
@@ -3317,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);
 	}
@@ -3337,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 {
 	/**
@@ -3375,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)) {
@@ -3387,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, tryPromise, 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, tryPromise } 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, tryPromise, 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 };

package/dist/is.js

@@ -3,8 +3,8 @@ import { getArray } from "./array/get.js";
 import { getString } from "./internal/string.js";
 /**
 * 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;
@@ -15,6 +15,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`
@@ -64,4 +72,4 @@ function isPrimitive(value) {
 }
 var EXPRESSION_PRIMITIVE = /^(bigint|boolean|number|string|symbol)$/;
 var EXPRESSION_WHITESPACE = /^\s*$/;
-export { isArrayOrPlainObject, isConstructor, isEmpty, isKey, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };
+export { isArrayOrPlainObject, isConstructor, isEmpty, isKey, isNonNullable, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isPlainObject, isPrimitive, isTypedArray };

package/dist/math.js

@@ -1,4 +1,5 @@
-import { aggregate, getAggregated, max } from "./internal/math/aggregate.js";
+import { isNumber } from "./internal/is.js";
+import { aggregate, getAggregateCallback, getAggregated, max } from "./internal/math/aggregate.js";
 function average(array, key) {
 	const aggregated = aggregate("average", array, key);
 	return aggregated.count > 0 ? aggregated.value / aggregated.count : NaN;
@@ -6,9 +7,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];
@@ -16,6 +16,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);
 }
@@ -34,4 +50,4 @@ function round(value, decimals) {
 function sum(array, key) {
 	return getAggregated("sum", array, key);
 }
-export { average, count, max, min, round, sum };
+export { average, count, max, median, min, round, sum };

package/dist/promise.js

@@ -1,9 +1,35 @@
+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;
 	}
 };
+/**
+* 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);
@@ -156,9 +182,9 @@ async function timed(promise, options) {
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimed(promise, time, signal) : promise;
 }
-async function tryPromise(value, options) {
+async function attemptPromise(value, options) {
 	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(MESSAGE_EXPECTATION_TRY));
+	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() {
@@ -185,11 +211,11 @@ var ABORT_OPTIONS = { once: true };
 var DEFAULT_STRATEGY = "complete";
 var ERROR_NAME = "PromiseTimeoutError";
 var EVENT_NAME = "abort";
+var MESSAGE_EXPECTATION_ATTEMPT = "Attempt expected a function or a promise";
 var MESSAGE_EXPECTATION_PROMISES = "Promises expected an array of promises";
 var MESSAGE_EXPECTATION_TIMED = "Timed function expected a Promise";
-var MESSAGE_EXPECTATION_TRY = "TryPromise expected a function or a promise";
 var MESSAGE_TIMEOUT = "Promise timed out";
 var strategies = new Set(["complete", "first"]);
 var TYPE_FULFILLED = "fulfilled";
 var TYPE_REJECTED = "rejected";
-export { PromiseTimeoutError, delay, isFulfilled, isRejected, promises, timed, tryPromise };
+export { CancelablePromise, PromiseTimeoutError, attemptPromise, cancelable, delay, isFulfilled, isRejected, promises, timed };

package/dist/result.js

@@ -1,4 +1,5 @@
 import { isPlainObject } from "./internal/is.js";
+import { attemptPromise } from "./promise.js";
 function _isResult(value, okValue) {
 	if (!isPlainObject(value)) return false;
 	return value.ok === okValue && (okValue ? "value" : "error") in value;
@@ -44,17 +45,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);
 	}
@@ -62,4 +64,4 @@ async function asyncResult(callback, err) {
 function unwrap(value, defaultValue) {
 	return isOk(value) ? value.value : defaultValue;
 }
-export { error, isError, isOk, isResult, ok, result, unwrap };
+export { attempt, error, isError, isOk, isResult, ok, unwrap };