@oscarpalmer/atoms 0.184.1 → 0.185.0

package/dist/index.mjs

@@ -525,16 +525,16 @@ function partition(array, ...parameters) {
 	return [matched, notMatched];
 }
 //#endregion
-//#region src/array/position.ts
+//#region src/array/match.ts
 function endsWithArray(haystack, needle, key) {
 	return endings.has(getPosition(haystack, needle, key)[1]);
 }
-function getArrayPosition(haystack, needle, key) {
+function getArrayComparison(haystack, needle, key) {
 	return getPosition(haystack, needle, key)[1];
 }
 function getName(start, haystack, needle) {
-	if (start === 0) return haystack === needle ? POSITION_SAME : POSITION_START;
-	return start + needle === haystack ? POSITION_END : POSITION_INSIDE;
+	if (start === 0) return haystack === needle ? COMPARISON_SAME : COMPARISON_START;
+	return start + needle === haystack ? COMPARISON_END : COMPARISON_INSIDE;
 }
 function getPosition(haystack, needle, key) {
 	if (!Array.isArray(haystack) || !Array.isArray(needle)) return invalid;
@@ -569,17 +569,17 @@ function indexOfArray(haystack, needle, key) {
 function startsWithArray(haystack, needle, key) {
 	return starts.has(getPosition(haystack, needle, key)[1]);
 }
-const POSITION_END = "end";
-const POSITION_INSIDE = "inside";
-const POSITION_INVALID = "invalid";
-const POSITION_OUTSIDE = "outside";
-const POSITION_SAME = "same";
-const POSITION_START = "start";
-const endings = new Set([POSITION_END, POSITION_SAME]);
-const invalid = [-1, POSITION_INVALID];
-const outside = [-1, POSITION_OUTSIDE];
-const outsides = new Set([POSITION_INVALID, POSITION_OUTSIDE]);
-const starts = new Set([POSITION_START, POSITION_SAME]);
+const COMPARISON_END = "end";
+const COMPARISON_INSIDE = "inside";
+const COMPARISON_INVALID = "invalid";
+const COMPARISON_OUTSIDE = "outside";
+const COMPARISON_SAME = "same";
+const COMPARISON_START = "start";
+const endings = new Set([COMPARISON_END, COMPARISON_SAME]);
+const invalid = [-1, COMPARISON_INVALID];
+const outside = [-1, COMPARISON_OUTSIDE];
+const outsides = new Set([COMPARISON_INVALID, COMPARISON_OUTSIDE]);
+const starts = new Set([COMPARISON_START, COMPARISON_SAME]);
 //#endregion
 //#region src/array/push.ts
 /**
@@ -620,10 +620,10 @@ function select(array, ...parameters) {
 //#region src/array/single.ts
 function single(array, ...parameters) {
 	const { matched } = findValues("all", array, parameters);
-	if (matched.length > 1) throw new Error(MESSAGE$1);
+	if (matched.length > 1) throw new Error(SINGLE_MESSAGE);
 	return matched[0];
 }
-const MESSAGE$1 = "Multiple items were found";
+const SINGLE_MESSAGE = "Multiple items were found";
 //#endregion
 //#region src/array/slice.ts
 function drop(array, first, second) {
@@ -1170,9 +1170,9 @@ function isSortedArray(array, sorters) {
 	if (length < 2) return true;
 	const sortersLength = sorters.length;
 	let offset = 0;
-	if (length >= ARRAY_THRESHOLD$1) {
-		offset = Math.round(length / ARRAY_PEEK_PERCENTAGE$1);
-		offset = offset > ARRAY_THRESHOLD$1 ? ARRAY_THRESHOLD$1 : offset;
+	if (length >= SORT_THRESHOLD) {
+		offset = Math.round(length / SORT_PEEK_PERCENTAGE);
+		offset = offset > SORT_THRESHOLD ? SORT_THRESHOLD : offset;
 		for (let index = 0; index < offset; index += 1) {
 			const [firstItem, firstOffset] = [array[index], array[index + 1]];
 			const [secondItem, secondOffset] = [array[length - index - 2], array[length - index - 1]];
@@ -1196,11 +1196,11 @@ function sortArray(array, sorters) {
 	const { length } = sorters;
 	return array.length > 1 ? array.sort((first, second) => getComparisonValue(first, second, sorters, length)) : array;
 }
-sort.index = getSortedIndex;
+sort.getIndex = getSortedIndex;
 sort.initialize = initializeSorter;
 sort.is = isSorted;
-const ARRAY_PEEK_PERCENTAGE$1 = 10;
-const ARRAY_THRESHOLD$1 = 100;
+const SORT_PEEK_PERCENTAGE = 10;
+const SORT_THRESHOLD = 100;
 const SORT_DIRECTION_ASCENDING = "ascending";
 const SORT_DIRECTION_DESCENDING = "descending";
 const modifiers = {
@@ -1299,12 +1299,132 @@ function toRecordArrays(array, first, second) {
 	return groupValues(array, first, second, true);
 }
 //#endregion
+//#region src/internal/result.ts
+function _isResult(value, okValue) {
+	if (isNonPlainObject(value)) return false;
+	return value.ok === okValue && (okValue ? PROPERTY_VALUE : PROPERTY_ERROR) in value;
+}
+function isError(value, extended) {
+	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
+}
+/**
+* Is the result ok?
+* @param result Result to check
+* @returns `true` if the result is ok, `false` otherwise
+*/
+function isOk(value) {
+	return _isResult(value, true);
+}
+/**
+* Is the value a result?
+* @param value Value to check
+* @returns `true` if the value is a result, `false` otherwise
+*/
+function isResult(value) {
+	return _isResult(value, true) || _isResult(value, false);
+}
+const PROPERTY_ERROR = "error";
+const PROPERTY_VALUE = "value";
+//#endregion
+//#region src/result/misc.ts
+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";
+//#endregion
+//#region src/internal/value/misc.ts
+function findKey(needle, haystack) {
+	const keys = Object.keys(haystack);
+	const index = keys.map((key) => key.toLowerCase()).indexOf(needle.toLowerCase());
+	return index > -1 ? keys[index] : needle;
+}
+function getNestedValue(data, path, ignoreCase) {
+	if (typeof data !== "object" || data === null) return error(NESTED_MESSAGE_INPUT);
+	if (typeof path !== "string" || path.trim().length === 0) return error(NESTED_MESSAGE_PATH);
+	const shouldIgnoreCase = ignoreCase === true;
+	const paths = getPaths(path, shouldIgnoreCase);
+	if (typeof paths === "string") return handleValue(data, paths, null, true, shouldIgnoreCase);
+	const { length } = paths;
+	let current = data;
+	for (let index = 0; index < length; index += 1) {
+		const part = paths[index];
+		const handled = handleValue(current, part, null, true, shouldIgnoreCase);
+		if (!handled.ok) return handled;
+		current = handled.value;
+	}
+	return ok(current);
+}
+function getPaths(path, lowercase) {
+	const normalized = lowercase ? path.toLowerCase() : path;
+	if (!EXPRESSION_NESTED.test(normalized)) return normalized;
+	return normalized.replace(EXPRESSION_BRACKET, ".$1").replace(EXPRESSION_DOTS, "").split(".");
+}
+function handleValue(data, path, value, get, ignoreCase) {
+	if (typeof data === "object" && data !== null) {
+		if (ignoreKey(path)) return error(NESTED_MESSAGE_UNSAFE);
+		const key = ignoreCase ? findKey(path, data) : path;
+		if (get) return key in data ? ok(data[key]) : error(NESTED_MESSAGE_MISSING);
+		data[key] = typeof value === "function" ? value(data[key]) : value;
+	}
+	if (get) return error(NESTED_MESSAGE_MISSING);
+}
+const EXPRESSION_BRACKET = /\[(\w+)\]/g;
+const EXPRESSION_DOTS = /^\.|\.$/g;
+const EXPRESSION_NESTED = /\.|\[\w+\]/;
+const NESTED_MESSAGE_INPUT = "Expected data to be an object";
+const NESTED_MESSAGE_MISSING = "Expected property to exist in object";
+const NESTED_MESSAGE_PATH = "Expected path to be a string";
+const NESTED_MESSAGE_UNSAFE = "Access to this property is not allowed";
+//#endregion
+//#region src/internal/value/has.ts
+function hasValue(data, path, ignoreCase) {
+	return getNestedValue(data, path, ignoreCase === true).ok;
+}
+hasValue.get = hasValueResult;
+function hasValueResult(data, path, ignoreCase) {
+	return getNestedValue(data, path, ignoreCase === true);
+}
+//#endregion
 //#region src/function/assert.ts
 /**
 * Asserts that a condition is true, throwing an error if it is not
 * @param condition Condition to assert
 * @param message Error message
-* @param error Error constructor
+* @param error Error constructor _(defaults to `Error`)_
 */
 function assert(condition, message, error) {
 	if (!condition()) throw new (error ?? Error)(message);
@@ -1313,13 +1433,14 @@ assert.condition = assertCondition;
 assert.defined = assertDefined;
 assert.instanceOf = assertInstanceOf;
 assert.is = assertIs;
+assert.property = assertProperty;
 /**
 * Creates an asserter that asserts a condition is true, throwing an error if it is not
 *
 * Available as `assertCondition` and `assert.condition`
 * @param condition Condition to assert
 * @param message Error message
-* @param error Error constructor
+* @param error Error constructor _(defaults to `Error`)_
 * @returns Asserter
 */
 function assertCondition(condition, message, error) {
@@ -1328,14 +1449,15 @@ function assertCondition(condition, message, error) {
 	};
 }
 /**
-* Asserts that a value is defined throwing an error if it is not
+* Asserts that a value is defined, throwing an error if it is not
 *
 * Available as `assertDefined` and `assert.defined`
 * @param value Value to assert
 * @param message Error message
+* @param error Error constructor _(defaults to `Error`)_
 */
-function assertDefined(value, message) {
-	assert(() => value != null, message ?? MESSAGE_VALUE_DEFINED);
+function assertDefined(value, message, error) {
+	assert(() => value != null, message ?? MESSAGE_VALUE_DEFINED, error);
 }
 /**
 * Creates an asserter that asserts a value is an instance of a constructor, throwing an error if it is not
@@ -1343,7 +1465,7 @@ function assertDefined(value, message) {
 * Available as `assertInstanceOf` and `assert.instanceOf`
 * @param constructor Constructor to check against
 * @param message Error message
-* @param error Error constructor
+* @param error Error constructor _(defaults to `Error`)_
 * @returns Asserter
 */
 function assertInstanceOf(constructor, message, error) {
@@ -1357,7 +1479,7 @@ function assertInstanceOf(constructor, message, error) {
 * Available as `assertIs` and `assert.is`
 * @param condition Type guard function to check the value
 * @param message Error message
-* @param error Error constructor
+* @param error Error constructor _(defaults to `Error`)_
 * @returns Asserter
 */
 function assertIs(condition, message, error) {
@@ -1365,6 +1487,24 @@ function assertIs(condition, message, error) {
 		assert(() => condition(value), message, error);
 	};
 }
+/**
+* Creates an asserter that asserts a property of a value exists and satisfies a condition, throwing an error if it does not
+*
+* Available as `assertProperty` and `assert.property`
+* @param path Path to the property to check, e.g., `foo.bar.baz` for a nested property
+* @param condition Condition to assert for the property
+* @param message Error message
+* @param error Error constructor _(defaults to `Error`)_
+* @returns Asserter
+*/
+function assertProperty(path, condition, message, error) {
+	return (value) => {
+		assert(() => {
+			const result = hasValueResult(value, path, false);
+			return result.ok && condition(result.value);
+		}, message, error);
+	};
+}
 const MESSAGE_VALUE_DEFINED = "Expected value to be defined";
 //#endregion
 //#region src/internal/function/misc.ts
@@ -1427,6 +1567,9 @@ function getNumber(value) {
 	if (isBinary || EXPRESSION_OCTAL.test(trimmed)) return Number.parseInt(trimmed.slice(2), isBinary ? 2 : OCTAL_VALUE);
 	return Number(trimmed);
 }
+function getNumberOrDefault(value, defaultValue, minimum) {
+	return typeof value === "number" && !Number.isNaN(value) && value >= (minimum ?? 0) ? Math.floor(value) : defaultValue;
+}
 const EXPRESSION_BINARY = /^0b[01]+$/i;
 const EXPRESSION_OCTAL = /^0o[0-7]+$/i;
 const EXPRESSION_ZEROISH = /^\s*0+\s*$/;
@@ -1497,6 +1640,9 @@ var SizedMap = class extends Map {
 };
 //#endregion
 //#region src/function/memoize.ts
+/**
+* A memoized function, caching and retrieving results based on the its parameters _(or a custom cache key)_
+*/
 var Memoized = class {
 	#state;
 	/**
@@ -1739,7 +1885,7 @@ throttle.async = asyncThrottle;
 * @returns Once callback
 */
 function asyncOnce(callback) {
-	assert(() => typeof callback === "function", MESSAGE_EXPECTATION$1);
+	assert(() => typeof callback === "function", ONCE_MESSAGE_EXPECTATION);
 	const state = {
 		called: false,
 		cleared: false,
@@ -1749,7 +1895,7 @@ function asyncOnce(callback) {
 		value: void 0
 	};
 	const fn = (...parameters) => {
-		if (state.cleared) return Promise.reject(new Error(MESSAGE_CLEARED));
+		if (state.cleared) return Promise.reject(new Error(ONCE_MESSAGE_CLEARED));
 		if (state.finished) return state.error ? Promise.reject(state.value) : Promise.resolve(state.value);
 		if (state.called) return new Promise((resolve, reject) => {
 			state.items.push({
@@ -1764,9 +1910,9 @@ function asyncOnce(callback) {
 				resolve
 			});
 			callback(...parameters).then((value) => {
-				handleResult$2(state, value, false);
+				handleOnceResult(state, value, false);
 			}).catch((error) => {
-				handleResult$2(state, error, true);
+				handleOnceResult(state, error, true);
 			});
 		});
 	};
@@ -1783,7 +1929,7 @@ function asyncOnce(callback) {
 	};
 	return fn;
 }
-function handleResult$2(state, value, error) {
+function handleOnceResult(state, value, error) {
 	state.error = error;
 	state.finished = true;
 	state.value = value;
@@ -1801,14 +1947,14 @@ function handleResult$2(state, value, error) {
 * @returns Once callback
 */
 function once(callback) {
-	assert(() => typeof callback === "function", MESSAGE_EXPECTATION$1);
+	assert(() => typeof callback === "function", ONCE_MESSAGE_EXPECTATION);
 	const state = {
 		called: false,
 		cleared: false,
 		value: void 0
 	};
 	const fn = (...parameters) => {
-		if (state.cleared) throw new Error(MESSAGE_CLEARED);
+		if (state.cleared) throw new Error(ONCE_MESSAGE_CLEARED);
 		if (state.called) return state.value;
 		state.called = true;
 		state.value = callback(...parameters);
@@ -1826,15 +1972,18 @@ function once(callback) {
 	return fn;
 }
 once.async = asyncOnce;
-const MESSAGE_CLEARED = "Once has been cleared";
-const MESSAGE_EXPECTATION$1 = "Once expected a function";
+const ONCE_MESSAGE_CLEARED = "Once has been cleared";
+const ONCE_MESSAGE_EXPECTATION = "Once expected a function";
 //#endregion
 //#region src/function/retry.ts
+/**
+* An error thrown when a retry fails
+*/
 var RetryError = class extends Error {
 	constructor(message, original) {
 		super(message);
 		this.original = original;
-		this.name = ERROR_NAME$1;
+		this.name = RETRY_ERROR_NAME;
 	}
 };
 /**
@@ -1846,13 +1995,13 @@ var RetryError = class extends Error {
 * @returns Callback result
 */
 async function asyncRetry(callback, options) {
-	if (typeof callback !== "function") throw new TypeError(MESSAGE_EXPECTATION);
+	if (typeof callback !== "function") throw new TypeError(RETRY_MESSAGE_EXPECTATION);
 	async function handle() {
 		try {
 			const result = await callback();
 			resolver(result);
 		} catch (error) {
-			if (attempts >= times || !when(error)) rejector(new RetryError(MESSAGE_FAILED, error));
+			if (attempts >= times || !when(error)) rejector(new RetryError(RETRY_MESSAGE_FAILED, error));
 			else {
 				attempts += 1;
 				timer();
@@ -1888,7 +2037,7 @@ function getRetryOptions(input) {
 * @returns Callback result
 */
 function retry(callback, options) {
-	if (typeof callback !== "function") throw new TypeError(MESSAGE_EXPECTATION);
+	if (typeof callback !== "function") throw new TypeError(RETRY_MESSAGE_EXPECTATION);
 	const { times, when } = getRetryOptions(options);
 	let last;
 	for (let index = 0; index <= times; index += 1) try {
@@ -1899,42 +2048,15 @@ function retry(callback, options) {
 			break;
 		}
 	}
-	throw new RetryError(MESSAGE_FAILED, last);
+	throw new RetryError(RETRY_MESSAGE_FAILED, last);
 }
 retry.async = asyncRetry;
 function shouldRetry() {
 	return true;
 }
-const ERROR_NAME$1 = "RetryError";
-const MESSAGE_EXPECTATION = "Retry expected a function";
-const MESSAGE_FAILED = "Retry failed";
-//#endregion
-//#region src/internal/result.ts
-function _isResult(value, okValue) {
-	if (isNonPlainObject(value)) return false;
-	return value.ok === okValue && (okValue ? PROPERTY_VALUE : PROPERTY_ERROR) in value;
-}
-function isError(value, extended) {
-	return _isResult(value, false) && (extended === true ? value.original instanceof Error : true);
-}
-/**
-* Is the result ok?
-* @param result Result to check
-* @returns `true` if the result is ok, `false` otherwise
-*/
-function isOk(value) {
-	return _isResult(value, true);
-}
-/**
-* Is the value a result?
-* @param value Value to check
-* @returns `true` if the value is a result, `false` otherwise
-*/
-function isResult(value) {
-	return _isResult(value, true) || _isResult(value, false);
-}
-const PROPERTY_ERROR = "error";
-const PROPERTY_VALUE = "value";
+const RETRY_ERROR_NAME = "RetryError";
+const RETRY_MESSAGE_EXPECTATION = "Retry expected a function";
+const RETRY_MESSAGE_FAILED = "Retry failed";
 //#endregion
 //#region src/function/work.ts
 function asyncFlow(...fns) {
@@ -2023,9 +2145,9 @@ function equalArray(first, second, options) {
 	const { length } = first;
 	if (length !== second.length) return false;
 	let offset = 0;
-	if (length >= ARRAY_THRESHOLD) {
-		offset = Math.round(length / ARRAY_PEEK_PERCENTAGE);
-		offset = offset > ARRAY_THRESHOLD ? ARRAY_THRESHOLD : offset;
+	if (length >= EQUAL_ARRAY_THRESHOLD) {
+		offset = Math.round(length / EQUAL_ARRAY_PEEK_PERCENTAGE);
+		offset = offset > EQUAL_ARRAY_THRESHOLD ? EQUAL_ARRAY_THRESHOLD : offset;
 		for (let index = 0; index < offset; index += 1) if (!(equalValue(first[index], second[index], options) && equalValue(first[length - index - 1], second[length - index - 1], options))) return false;
 	}
 	const end = length - offset;
@@ -2160,104 +2282,17 @@ function initializeEqualizer(options) {
 function registerEqualizer(constructor, handler) {
 	equal.handlers.register(constructor, handler);
 }
-const ARRAY_PEEK_PERCENTAGE = 10;
-const ARRAY_THRESHOLD = 100;
+const EQUAL_ARRAY_PEEK_PERCENTAGE = 10;
+const EQUAL_ARRAY_THRESHOLD = 100;
 const ERROR_PROPERTIES = ["name", "message"];
 const EXPRESSION_PROPERTIES = ["source", "flags"];
 const MINIMUM_LENGTH_FOR_SET = 16;
 //#endregion
-//#region src/result/misc.ts
-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";
-//#endregion
-//#region src/internal/value/misc.ts
-function findKey(needle, haystack) {
-	const keys = Object.keys(haystack);
-	const index = keys.map((key) => key.toLowerCase()).indexOf(needle.toLowerCase());
-	return index > -1 ? keys[index] : needle;
-}
-function getNestedValue(data, path, ignoreCase) {
-	if (typeof data !== "object" || data === null || typeof path !== "string" || path.trim().length === 0) return error(void 0);
-	const shouldIgnoreCase = ignoreCase === true;
-	const paths = getPaths(path, shouldIgnoreCase);
-	if (typeof paths === "string") return handleValue(data, paths, null, true, shouldIgnoreCase);
-	const { length } = paths;
-	let current = data;
-	for (let index = 0; index < length; index += 1) {
-		const part = paths[index];
-		const handled = handleValue(current, part, null, true, shouldIgnoreCase);
-		if (!handled.ok) return handled;
-		current = handled.value;
-	}
-	return ok(current);
-}
-function getPaths(path, lowercase) {
-	const normalized = lowercase ? path.toLowerCase() : path;
-	if (!EXPRESSION_NESTED.test(normalized)) return normalized;
-	return normalized.replace(EXPRESSION_BRACKET, ".$1").replace(EXPRESSION_DOTS, "").split(".");
-}
-function handleValue(data, path, value, get, ignoreCase) {
-	if (typeof data === "object" && data !== null && !ignoreKey(path)) {
-		const key = ignoreCase ? findKey(path, data) : path;
-		if (get) return key in data ? ok(data[key]) : error(void 0);
-		data[key] = typeof value === "function" ? value(data[key]) : value;
-	}
-	if (get) return error(void 0);
-}
-const EXPRESSION_BRACKET = /\[(\w+)\]/g;
-const EXPRESSION_DOTS = /^\.|\.$/g;
-const EXPRESSION_NESTED = /\.|\[\w+\]/;
-//#endregion
 //#region src/internal/value/get.ts
 function getValue(data, path, ignoreCase) {
 	return getNestedValue(data, path, ignoreCase === true).value;
 }
 //#endregion
-//#region src/internal/value/has.ts
-function hasValue(data, path, ignoreCase) {
-	return getNestedValue(data, path, ignoreCase === true).ok;
-}
-hasValue.get = hasValueResult;
-function hasValueResult(data, path, ignoreCase) {
-	return getNestedValue(data, path, ignoreCase === true);
-}
-//#endregion
 //#region src/internal/value/set.ts
 function setValue(data, path, value, ignoreCase) {
 	if (typeof data !== "object" || data === null || typeof path !== "string" || path.trim().length === 0) return data;
@@ -2710,7 +2745,7 @@ function getFuzzyOptions(input, state) {
 	options.tolerance = getTolerance(options.tolerance, state);
 	return options;
 }
-function getState$1(items, input) {
+function getFuzzyState(items, input) {
 	const handler = getHandler(input);
 	const options = getFuzzyOptions(input);
 	return {
@@ -2727,7 +2762,7 @@ function getTolerance(input, state) {
 }
 function fuzzy(items, configuration) {
 	if (!Array.isArray(items)) throw new TypeError(MESSAGE_ARRAY);
-	return new Fuzzy(getState$1(items, configuration));
+	return new Fuzzy(getFuzzyState(items, configuration));
 }
 fuzzy.match = fuzzyMatch;
 /**
@@ -3537,7 +3572,6 @@ function initializeMerger(options) {
 function merge(values, options) {
 	return handleMerge(values, getMergeOptions(options));
 }
-merge.assign = assign;
 merge.initialize = initializeMerger;
 function mergeObjects(values, options, prefix) {
 	const { length } = values;
@@ -3601,6 +3635,9 @@ function transformValue(value, transformer) {
 }
 //#endregion
 //#region src/beacon.ts
+/**
+* A beacon is a lighthouse, holding an observable value that can be subscribed to and emitted from
+*/
 var Beacon = class {
 	#options;
 	#state;
@@ -3671,6 +3708,9 @@ var Beacon = class {
 		if (finish === true) finishBeacon(this.#state, true);
 	}
 };
+/**
+* An observable holds a value and allows observers to subscribe to changes in that value
+*/
 var Observable = class {
 	#state;
 	constructor(instance, observers) {
@@ -3695,6 +3735,9 @@ var Observable = class {
 		return instance;
 	}
 };
+/**
+* A subscription represents an active subscription to an observable, holding its state and allowing it to be destroyed or unsubscribed from
+*/
 var Subscription = class {
 	#state;
 	constructor(state) {
@@ -3954,7 +3997,7 @@ function getClampedValue(value, minimum, maximum) {
 * @returns Foreground color
 */
 function getForegroundColor(value) {
-	const { blue, green, red } = getState(value).rgb;
+	const { blue, green, red } = getColorState(value).rgb;
 	const values = [
 		blue / 255,
 		green / 255,
@@ -3974,7 +4017,7 @@ function getForegroundColor(value) {
 * @returns Hex color
 */
 function getHexaColor(value) {
-	const { alpha, hex } = getState(value);
+	const { alpha, hex } = getColorState(value);
 	return `${hex}${alpha.hex}`;
 }
 /**
@@ -3983,7 +4026,7 @@ function getHexaColor(value) {
 * @returns Hex color
 */
 function getHexColor(value) {
-	return getState(value).hex;
+	return getColorState(value).hex;
 }
 function getHexValue(value) {
 	return getClampedValue(value, 0, 255);
@@ -3997,7 +4040,7 @@ function getDegrees(value) {
 * @returns HSLA color
 */
 function getHslaColor(value) {
-	const { alpha, hsl } = getState(value);
+	const { alpha, hsl } = getColorState(value);
 	return {
 		...hsl,
 		alpha: alpha.value
@@ -4009,7 +4052,7 @@ function getHslaColor(value) {
 * @returns HSL color
 */
 function getHslColor(value) {
-	return getState(value).hsl;
+	return getColorState(value).hsl;
 }
 function getPercentage(value) {
 	return getClampedValue(value, 0, 100);
@@ -4020,7 +4063,7 @@ function getPercentage(value) {
 * @returns RGBA color
 */
 function getRgbaColor(value) {
-	const { alpha, rgb } = getState(value);
+	const { alpha, rgb } = getColorState(value);
 	return {
 		...rgb,
 		alpha: alpha.value
@@ -4032,7 +4075,7 @@ function getRgbaColor(value) {
 * @returns RGB color
 */
 function getRgbColor(value) {
-	return getState(value).rgb;
+	return getColorState(value).rgb;
 }
 //#endregion
 //#region src/color/space/rgb.ts
@@ -4238,7 +4281,7 @@ function hslToRgba(hsl) {
 }
 //#endregion
 //#region src/color/misc/state.ts
-function getState(value) {
+function getColorState(value) {
 	if (typeof value === "string") {
 		const normalized = getNormalizedHex(value, true);
 		const hex = normalized.slice(0, 6);
@@ -4315,6 +4358,9 @@ function setRGBColor(state, value, alpha) {
 }
 //#endregion
 //#region src/color/instance.ts
+/**
+* A color that is represented in multiple color formats
+*/
 var Color = class {
 	#state;
 	/**
@@ -4408,7 +4454,7 @@ var Color = class {
 		setRGBColor(this.#state, value, true);
 	}
 	constructor(value) {
-		this.#state = getState(value);
+		this.#state = getColorState(value);
 		Object.defineProperty(this, "$color", { value: true });
 	}
 	toHexString(alpha) {
@@ -4436,6 +4482,11 @@ function getColor(value) {
 }
 //#endregion
 //#region src/logger.ts
+/**
+* A logger that can be used to log messages to the console
+*
+* _(Logging can be enabled or disabled by setting the `enabled` property)_
+*/
 var Logger = class {
 	/**
 	* Log any number of values at the "debug" log level
@@ -4506,10 +4557,16 @@ var Logger = class {
 		return new Time(label);
 	}
 };
+/**
+* A named timer that can be used to log durations to the console
+*/
 var Time = class {
 	#logger;
 	#stopper;
 	#state;
+	/**
+	* Is the timer active? _(i.e. has it been started and not stopped, and is logging enabled?)_
+	*/
 	get active() {
 		return this.#state.started && !this.#state.stopped && enabled;
 	}
@@ -4622,6 +4679,9 @@ function sum(array, key) {
 }
 //#endregion
 //#region src/promise/models.ts
+/**
+* A promise that can be canceled
+*/
 var CancelablePromise = class extends Promise {
 	#rejector;
 	constructor(executor) {
@@ -4640,6 +4700,9 @@ var CancelablePromise = class extends Promise {
 		this.#rejector(reason);
 	}
 };
+/**
+* An error thrown when a promise times out
+*/
 var PromiseTimeoutError = class extends Error {
 	constructor() {
 		super(PROMISE_MESSAGE_TIMEOUT);
@@ -4659,11 +4722,8 @@ const PROMISE_TYPE_FULFILLED = "fulfilled";
 const PROMISE_TYPE_REJECTED = "rejected";
 //#endregion
 //#region src/promise/helpers.ts
-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 (typeof input === "number") return { time: getNumberOrDefault(input, 0) };
 	if (input instanceof AbortSignal) return {
 		signal: input,
 		time: 0
@@ -4671,7 +4731,7 @@ function getPromiseOptions(input) {
 	const options = typeof input === "object" && input !== null ? input : {};
 	return {
 		signal: options.signal instanceof AbortSignal ? options.signal : void 0,
-		time: getNumberOrDefault$1(options.time)
+		time: getNumberOrDefault(options.time, 0)
 	};
 }
 function getPromisesOptions(input) {
@@ -4942,6 +5002,9 @@ const TYPES = new Set([
 ]);
 //#endregion
 //#region src/queue.ts
+/**
+* A queue that can be used to manage (a)synchronous tasks with a specific key
+*/
 var KeyedQueue = class {
 	#callback;
 	#options;
@@ -5091,6 +5154,9 @@ var KeyedQueue = class {
 		for (const queue of queues) queue[type]();
 	}
 };
+/**
+* A queue that can be used to manage (a)synchronous tasks
+*/
 var Queue = class {
 	#callback;
 	#handled = [];
@@ -5258,16 +5324,19 @@ var Queue = class {
 			if (this.#paused) {
 				const paused = item;
 				this.#handled.push(() => {
-					handleResult$1(paused, error, result, this.#items.length === 0);
+					handleQueuedResult(paused, error, result, this.#items.length === 0);
 				});
 				break;
 			}
-			handleResult$1(item, error, result, this.#items.length === 0);
+			handleQueuedResult(item, error, result, this.#items.length === 0);
 			item = this.#items.shift();
 		}
 		this.#runners -= 1;
 	}
 };
+/**
+* An error thrown by the Queue when an operation fails
+*/
 var QueueError = class extends Error {
 	constructor(message) {
 		super(message);
@@ -5277,18 +5346,15 @@ var QueueError = class extends Error {
 function getBooleanOrDefault(value, defaultValue) {
 	return typeof value === "boolean" ? value : defaultValue;
 }
-function getNumberOrDefault(value, defaultValue) {
-	return typeof value === "number" && value > 0 ? Math.floor(value) : defaultValue;
-}
 function getOptions(input) {
 	const options = typeof input === "object" && input != null ? input : {};
 	return {
 		autostart: getBooleanOrDefault(options.autostart, true),
-		concurrency: getNumberOrDefault(options.concurrency, 1),
+		concurrency: getNumberOrDefault(options.concurrency, 1, 1),
 		maximum: getNumberOrDefault(options.maximum, 0)
 	};
 }
-function handleResult$1(item, error, result, finished) {
+function handleQueuedResult(item, error, result, finished) {
 	item.signal?.removeEventListener(EVENT_NAME, item.abort);
 	if (item.signal?.aborted ?? false) item.reject();
 	else if (error) item.reject(result);
@@ -5378,6 +5444,25 @@ const BOOLEAN_MODIFIER = .5;
 const HEX_CHARACTERS = "0123456789ABCDEF";
 const HEX_MAXIMUM = 15;
 //#endregion
+//#region src/result/index.ts
+async function asyncAttempt(value, err) {
+	try {
+		let result = typeof value === "function" ? value() : await value;
+		if (result instanceof Promise) result = await result;
+		return ok(result);
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+function attempt(callback, err) {
+	try {
+		return ok(callback());
+	} catch (thrown) {
+		return getError(err ?? thrown, err == null ? void 0 : thrown);
+	}
+}
+attempt.async = asyncAttempt;
+//#endregion
 //#region src/result/match.ts
 async function asyncMatchResult(result, first, error) {
 	let value;
@@ -5445,33 +5530,11 @@ function attemptPipe(initial, first, ...seconds) {
 }
 attemptPipe.async = attemptAsyncPipe;
 //#endregion
-//#region src/result/index.ts
-async function asyncAttempt(value, err) {
-	try {
-		let result = typeof value === "function" ? value() : await value;
-		if (result instanceof Promise) result = await result;
-		return ok(result);
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-function attempt(callback, err) {
-	try {
-		return ok(callback());
-	} catch (thrown) {
-		return getError(err ?? thrown, err == null ? void 0 : thrown);
-	}
-}
-attempt.async = asyncAttempt;
-attempt.flow = attemptFlow;
-attempt.match = matchResult;
-attempt.pipe = attemptPipe;
-attempt.promise = attemptPromise;
-//#endregion
 //#region src/sized/set.ts
 /**
-* - A Set with a maximum size
-* - Behavior is similar to a _LRU_-cache, where the oldest values are removed
+* A Set with a maximum size
+*
+* Behavior is similar to a _LRU_-cache, where the oldest values are removed
 */
 var SizedSet = class extends Set {
 	/**
@@ -5522,4 +5585,4 @@ var SizedSet = class extends Set {
 	}
 };
 //#endregion
-export { CancelablePromise, 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, PromiseTimeoutError, RetryError, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, SizedMap, SizedSet, assert, assertCondition, assertDefined, assertInstanceOf, assertIs, 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, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayPosition, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, isTypedArray, join, kalas, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, logger, 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, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, 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, 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, PromiseTimeoutError, 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, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFulfilled, isHexColor, isHslColor, isHslLike, isHslaColor, isInstanceOf, isKey, isNonArrayOrPlainObject, isNonConstructor, isNonEmpty, isNonInstanceOf, isNonKey, isNonNullable, isNonNullableOrEmpty, isNonNullableOrWhitespace, isNonNumber, isNonNumerical, isNonObject, isNonPlainObject, isNonPrimitive, isNonTypedArray, isNullable, isNullableOrEmpty, isNullableOrWhitespace, isNumber, isNumerical, isObject, isOk, isPlainObject, isPrimitive, isRejected, isResult, isRgbColor, isRgbLike, isRgbaColor, isSorted, isTypedArray, join, kalas, kebabCase, keyedQueue, last, lastIndexOf, lastOrDefault, logger, 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, round, select, setValue, settlePromise, shake, shuffle, single, slice, smush, snakeCase, sort, splice, startsWith, startsWithArray, 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 };