@oscarpalmer/atoms 0.186.2 → 0.187.0

package/dist/index.mjs

@@ -193,15 +193,17 @@ function lastIndexOf(array, ...parameters) {
 //#endregion
 //#region src/internal/is.ts
 /**
-* Is the value an array or a record?
+* Is the value an array or a plain object?
+*
 * @param value Value to check
-* @returns `true` if the value is an array or a record, otherwise `false`
+* @returns `true` if the value is an array or a plain object, otherwise `false`
 */
 function isArrayOrPlainObject(value) {
 	return Array.isArray(value) || isPlainObject(value);
 }
 /**
 * Is the value a constructor function?
+*
 * @param value Value to check
 * @returns `true` if the value is a constructor function, otherwise `false`
 */
@@ -210,6 +212,7 @@ function isConstructor(value) {
 }
 /**
 * Is the value an instance of the constructor?
+*
 * @param constructor Class constructor
 * @param value Value to check
 * @returns `true` if the value is an instance of the constructor, otherwise `false`
@@ -218,15 +221,17 @@ function isInstanceOf(constructor, value) {
 	return isConstructor(constructor) && value instanceof constructor;
 }
 /**
-* Is the value a key?
+* Is the value a _Key_?
+*
 * @param value Value to check
-* @returns `true` if the value is a `Key` _(`number` or `string`)_, otherwise `false`
+* @returns `true` if the value is a _Key_ _(`number` or `string`)_, otherwise `false`
 */
 function isKey(value) {
 	return typeof value === "number" || typeof value === "string";
 }
 /**
 * Is the value not an array or a plain object?
+*
 * @param value Value to check
 * @returns `true` if the value is not an array or a plain object, otherwise `false`
 */
@@ -235,6 +240,7 @@ function isNonArrayOrPlainObject(value) {
 }
 /**
 * Is the value not a constructor function?
+*
 * @param value Value to check
 * @returns `true` if the value is not a constructor function, otherwise `false`
 */
@@ -243,6 +249,7 @@ function isNonConstructor(value) {
 }
 /**
 * Is the value not an instance of the constructor?
+*
 * @param constructor Class constructor
 * @param value Value to check
 * @returns `true` if the value is not an instance of the constructor, otherwise `false`
@@ -251,15 +258,17 @@ function isNonInstanceOf(constructor, value) {
 	return !isInstanceOf(constructor, value);
 }
 /**
-* Is the value not a key?
+* Is the value not a _Key_?
+*
 * @param value Value to check
-* @returns `true` if the value is not a `Key` _(`number` or `string`)_, otherwise `false`
+* @returns `true` if the value is not a _Key_ _(`number` or `string`)_, otherwise `false`
 */
 function isNonKey(value) {
 	return !isKey(value);
 }
 /**
 * Is the value not a number?
+*
 * @param value Value to check
 * @returns `true` if the value is not a `number`, otherwise `false`
 */
@@ -268,6 +277,7 @@ function isNonNumber(value) {
 }
 /**
 * Is the value not a plain object?
+*
 * @param value Value to check
 * @returns `true` if the value is not a plain object, otherwise `false`
 */
@@ -276,6 +286,7 @@ function isNonPlainObject(value) {
 }
 /**
 * Is the value not a primitive value?
+*
 * @param value Value to check
 * @returns `true` if the value is not a primitive value, otherwise `false`
 */
@@ -284,6 +295,7 @@ function isNonPrimitive(value) {
 }
 /**
 * Is the value not a typed array?
+*
 * @param value Value to check
 * @returns `true` if the value is not a typed array, otherwise `false`
 */
@@ -292,6 +304,7 @@ function isNonTypedArray(value) {
 }
 /**
 * Is the value a number?
+*
 * @param value Value to check
 * @returns `true` if the value is a `number`, otherwise `false`
 */
@@ -300,6 +313,7 @@ function isNumber(value) {
 }
 /**
 * Is the value a plain object?
+*
 * @param value Value to check
 * @returns `true` if the value is a plain object, otherwise `false`
 */
@@ -310,9 +324,10 @@ function isPlainObject(value) {
 	return prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null;
 }
 /**
-* - Is the value a primitive value?
+* Is the value a primitive value?
+*
 * @param value Value to check
-* @returns `true` if the value matches, otherwise `false`
+* @returns `true` if the value is a primitive value, otherwise `false`
 */
 function isPrimitive(value) {
 	if (value == null) return true;
@@ -321,6 +336,7 @@ function isPrimitive(value) {
 }
 /**
 * Is the value a template strings array?
+*
 * @param value Value to check
 * @returns `true` if the value is a `TemplateStringsArray`, otherwise `false`
 */
@@ -329,6 +345,7 @@ function isTemplateStringsArray(value) {
 }
 /**
 * Is the value a typed array?
+*
 * @param value Value to check
 * @returns `true` if the value is a typed array, otherwise `false`
 */
@@ -350,7 +367,7 @@ function isTypedArray(value) {
 }
 //#endregion
 //#region src/internal/random.ts
-function _getRandomFloat(inclusive, minimum, maximum) {
+function getRandomFloatingNumberValue(inclusive, minimum, maximum) {
 	let maxFloat = isNumber(maximum) && maximum <= Number.MAX_SAFE_INTEGER ? maximum : Number.MAX_SAFE_INTEGER;
 	let minFloat = isNumber(minimum) && minimum >= Number.MIN_SAFE_INTEGER ? minimum : Number.MIN_SAFE_INTEGER;
 	if (minFloat === maxFloat) return minFloat;
@@ -359,26 +376,29 @@ function _getRandomFloat(inclusive, minimum, maximum) {
 }
 /**
 * Get a random floating-point number
+*
 * @param minimum Minimum value
 * @param maximum Maximum value
 * @returns Random floating-point number
 */
-function getRandomFloat(minimum, maximum) {
-	return _getRandomFloat(false, minimum, maximum);
+function getRandomFloatingNumber(minimum, maximum) {
+	return getRandomFloatingNumberValue(false, minimum, maximum);
 }
 /**
 * Get a random integer
+*
 * @param minimum Minimum value
 * @param maximum Maximum value
 * @returns Random integer
 */
 function getRandomInteger(minimum, maximum) {
-	return Math.floor(_getRandomFloat(true, minimum, maximum));
+	return Math.floor(getRandomFloatingNumberValue(true, minimum, maximum));
 }
 //#endregion
 //#region src/internal/array/shuffle.ts
 /**
 * Shuffle items in array
+*
 * @param array Original array
 * @returns Shuffled array
 */
@@ -386,7 +406,7 @@ function shuffle(array) {
 	if (!Array.isArray(array)) return [];
 	const shuffled = array.slice();
 	if (shuffled.length < 2) return shuffled;
-	let index = Number(shuffled.length);
+	let index = shuffled.length;
 	while (--index >= 0) {
 		const random = getRandomInteger(0, index);
 		[shuffled[index], shuffled[random]] = [shuffled[random], shuffled[index]];
@@ -482,15 +502,17 @@ function times(length, value) {
 //#region src/array/get.ts
 function getArray(value, indiced) {
 	if (Array.isArray(value)) return value;
-	if (value instanceof Map || value instanceof Set) return [...value.values()];
+	if (value instanceof Map) return [...value.entries()];
+	if (value instanceof Set) return [...value.values()];
 	if (isNonPlainObject(value)) return [value];
-	if (indiced !== true) return Object.values(value);
+	if (indiced !== true) return Object.entries(value);
 	const keys = Object.keys(value);
 	const { length } = keys;
 	const array = [];
 	for (let index = 0; index < length; index += 1) {
 		const key = keys[index];
-		if (!Number.isNaN(Number(key))) array.push(value[key]);
+		const asNumber = Number.parseInt(key, 10);
+		if (!Number.isNaN(asNumber)) array[asNumber] = value[key];
 	}
 	return array;
 }
@@ -501,7 +523,7 @@ function insertChunkedValues(type, array, items, start, deleteCount) {
 	const actualStart = Math.min(Math.max(0, start), array.length);
 	const chunked = chunk(items);
 	const lastIndex = chunked.length - 1;
-	let index = Number(chunked.length);
+	let index = chunked.length;
 	let returned;
 	while (index > 0) {
 		index -= 1;
@@ -816,7 +838,7 @@ move.toIndex = moveToIndex;
 *
 * If the from index is out of bounds, the array will be returned unchanged
 *
-* Available as `moveIndices` and `move.indices`
+* _Available as `moveIndices` and `move.indices`_
 *
 * @param array Array to move within
 * @param from Index to move from
@@ -909,8 +931,20 @@ const aggregators = {
 //#region src/internal/string.ts
 /**
 * Get the string value from any value
+*
 * @param value Original value
 * @returns String representation of the value
+*
+* @example
+* ```typescript
+* getString(null)       // => ''
+* getString('foo')      // => 'foo'
+* getString(123)        // => '123'
+* getString(true)       // => 'true'
+* getString([1, 2, 3])  // => '1,2,3'
+* getString({a: 1})     // => '{"a":1}'
+* getString(() => 123)  // => '123'
+* ```
 */
 function getString(value) {
 	if (typeof value === "string") return value;
@@ -923,10 +957,20 @@ function getString(value) {
 function ignoreKey(key) {
 	return EXPRESSION_IGNORED.test(key);
 }
+function interpolate(strings, values) {
+	const { length } = strings;
+	let interpolated = "";
+	for (let index = 0; index < length; index += 1) {
+		const value = values[index];
+		interpolated += `${strings[index]}${Array.isArray(value) ? join(value.map(getString)) : getString(value)}`;
+	}
+	return interpolated;
+}
 /**
 * Join an array of values into a string _(while ignoring empty values)_
 *
 * _(`null`, `undefined`, and any values that become whitespace-only strings are considered empty)_
+*
 * @param array Array of values
 * @param delimiter Delimiter to use between values
 * @returns Joined string
@@ -957,6 +1001,7 @@ function tryEncode(value) {
 }
 /**
 * Split a string into words _(and other readable parts)_
+*
 * @param value Original string
 * @returns Array of words found in the string
 */
@@ -1025,6 +1070,7 @@ function isConstructable(value) {
 const COMPARE_NAME = "compare";
 /**
 * Compare two values _(for sorting purposes)_
+*
 * @param first First value
 * @param second Second value
 * @returns `0` if equal; `-1` first comes before second; `1` first comes after second
@@ -1077,7 +1123,8 @@ function compareValue(first, second, compareStrings) {
 /**
 * Deregister a custom comparison handler for a class
 *
-* Available as `deregisterComparator` and `compare.deregister`
+* _Available as `deregisterComparator` and `compare.deregister`_
+*
 * @param constructor Class constructor
 */
 function deregisterComparator(constructor) {
@@ -1090,7 +1137,8 @@ function getComparisonParts(value) {
 /**
 * Register a custom comparison handler for a class
 *
-* Available as `registerComparator` and `compare.register`
+* _Available as `registerComparator` and `compare.register`_
+*
 * @param constructor Class constructor
 * @param handler Method name or comparison function _(defaults to `compare`)_
 */
@@ -1110,7 +1158,7 @@ function getComparisonSorter(callback, modifier) {
 		modifier,
 		compare: { simple: callback },
 		get: false,
-		identifier: String(callback)
+		identifier: callback.toString()
 	};
 }
 function getComparisonValue(first, second, sorters, length) {
@@ -1179,11 +1227,12 @@ function getSorters(value, modifier) {
 	return sorters.filter((value, index, array) => array.findIndex((next) => next.identifier === value.identifier) === index);
 }
 function getValueSorter(value, modifier) {
+	const isFunction = typeof value === "function";
 	return {
 		modifier,
 		get: true,
-		identifier: String(value),
-		value: typeof value === "function" ? value : (item) => item[value]
+		identifier: isFunction ? value.toString() : value,
+		value: isFunction ? value : (item) => item[value]
 	};
 }
 function initializeSorter(first, second) {
@@ -1271,7 +1320,7 @@ function swapArrays(array, from, to, key) {
 *
 * If either index is out of bounds, the array will be returned unchanged
 *
-* Available as `swapIndices` and `swap.indices`
+* _Available as `swapIndices` and `swap.indices`_
 *
 * @param array Array of items to swap
 * @param first First index _(can be negative to count from the end)_
@@ -1333,28 +1382,24 @@ function toRecordArrays(array, first, second) {
 }
 //#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);
+	return isResultValue(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);
+	return isResultValue(value, true);
 }
 /**
-* Is the value a result?
+* Is the value a _Result_?
+*
 * @param value Value to check
-* @returns `true` if the value is a result, `false` otherwise
+* @returns `true` if the value is a _Result_, `false` otherwise
 */
 function isResult(value) {
-	return _isResult(value, true) || _isResult(value, false);
+	return isResultValue(value, true) || isResultValue(value, false);
+}
+function isResultValue(value, okValue) {
+	if (isNonPlainObject(value)) return false;
+	return value.ok === okValue && (okValue ? PROPERTY_VALUE : PROPERTY_ERROR) in value;
 }
 const PROPERTY_ERROR = "error";
 const PROPERTY_VALUE = "value";
@@ -1373,6 +1418,7 @@ function getError(value, original) {
 }
 /**
 * Creates an ok result
+*
 * @param value Value
 * @returns Ok result
 */
@@ -1383,10 +1429,11 @@ function ok(value) {
 	};
 }
 /**
-* Converts a result to a promise
+* Converts a _Result_ to a _Promise_
 *
 * Resolves if ok, rejects for error
-* @param result Result to convert
+*
+* @param result _Result_ to convert
 * @returns Promised result
 */
 async function toPromise(result) {
@@ -1455,6 +1502,7 @@ function hasValueResult(data, path, ignoreCase) {
 //#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 _(defaults to `Error`)_
@@ -1468,13 +1516,14 @@ 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
+* Creates an _Asserter_ that asserts a condition is true, throwing an error if it is not
+*
+* _Available as `assertCondition` and `assert.condition`_
 *
-* Available as `assertCondition` and `assert.condition`
 * @param condition Condition to assert
 * @param message Error message
 * @param error Error constructor _(defaults to `Error`)_
-* @returns Asserter
+* @returns _Asserter_
 */
 function assertCondition(condition, message, error) {
 	return (value) => {
@@ -1484,7 +1533,8 @@ function assertCondition(condition, message, error) {
 /**
 * Asserts that a value is defined, throwing an error if it is not
 *
-* Available as `assertDefined` and `assert.defined`
+* _Available as `assertDefined` and `assert.defined`_
+*
 * @param value Value to assert
 * @param message Error message
 * @param error Error constructor _(defaults to `Error`)_
@@ -1493,13 +1543,14 @@ 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
+* Creates an _Asserter_ that asserts a value is an instance of a constructor, throwing an error if it is not
+*
+* _Available as `assertInstanceOf` and `assert.instanceOf`_
 *
-* Available as `assertInstanceOf` and `assert.instanceOf`
 * @param constructor Constructor to check against
 * @param message Error message
 * @param error Error constructor _(defaults to `Error`)_
-* @returns Asserter
+* @returns _Asserter_
 */
 function assertInstanceOf(constructor, message, error) {
 	return (value) => {
@@ -1507,13 +1558,14 @@ function assertInstanceOf(constructor, message, error) {
 	};
 }
 /**
-* Creates an asserter that asserts a value is of a specific type, throwing an error if it is not
+* Creates an _Asserter_ that asserts a value is of a specific type, throwing an error if it is not
+*
+* _Available as `assertIs` and `assert.is`_
 *
-* Available as `assertIs` and `assert.is`
 * @param condition Type guard function to check the value
 * @param message Error message
 * @param error Error constructor _(defaults to `Error`)_
-* @returns Asserter
+* @returns _Asserter_
 */
 function assertIs(condition, message, error) {
 	return (value) => {
@@ -1521,14 +1573,15 @@ function assertIs(condition, message, error) {
 	};
 }
 /**
-* Creates an asserter that asserts a property of a value exists and satisfies a condition, throwing an error if it does not
+* 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`_
 *
-* 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
+* @returns _Asserter_
 */
 function assertProperty(path, condition, message, error) {
 	return (value) => {
@@ -1549,6 +1602,7 @@ function noop() {}
 //#region src/internal/number.ts
 /**
 * Is the number between a minimum and maximum value?
+*
 * @param value Value to check
 * @param minimum Minimum value
 * @param maximum Maximum value
@@ -1565,11 +1619,18 @@ function between(value, minimum, maximum) {
 }
 /**
 * Clamp a number between a minimum and maximum value
+*
 * @param value Value to clamp
 * @param minimum Minimum value
 * @param maximum Maximum value
 * @param loop If `true`, the value will loop around when smaller than the minimum or larger than the maximum _(defaults to `false`)_
 * @returns Clamped value
+*
+* @example
+* ```typescript
+* clamp(10, 0, 5);       // => 5
+* clamp(10, 0, 5, true); // => 0
+* ```
 */
 function clamp(value, minimum, maximum, loop) {
 	if (![
@@ -1581,9 +1642,12 @@ function clamp(value, minimum, maximum, loop) {
 	return value > maximum ? loop === true ? minimum : maximum : value;
 }
 /**
-* Get the number value from an unknown value _(based on Lodash)_
+* Get the number value from an unknown value
+*
+* _(Based on Lodash)_
+*
 * @param value Original value
-* @returns Original value as a number, or `NaN` if the value is unable to be parsed
+* @returns Original value as a number, or `Number.NaN` if the value is unable to be parsed
 */
 function getNumber(value) {
 	if (typeof value === "number") return value;
@@ -1620,17 +1684,17 @@ const MAXIMUM_DEFAULT = 1048576;
 //#endregion
 //#region src/sized/map.ts
 /**
-* A Map with a maximum size
+* A _Map_ with a maximum size
 *
-* Behavior 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 {
 	/**
-	* The maximum size of the Map
+	* The maximum size of the _Map_
 	*/
 	#maximumSize;
 	/**
-	* Is the Map full?
+	* Is the _Map_ full?
 	*/
 	get full() {
 		return super.size >= this.#maximumSize;
@@ -1674,18 +1738,22 @@ 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)_
+* A _Memoized_ function instance, caching and retrieving results based on the its parameters _(or a custom cache key)_
 */
 var Memoized = class {
 	#state;
 	/**
 	* Maximum cache size
+	*
+	* @returns Maximum cache size _(or `Number.NaN` if the instance has been destroyed)_
 	*/
 	get maximum() {
 		return this.#state.cache?.maximum ?? NaN;
 	}
 	/**
 	* Current cache size
+	*
+	* @returns Current cache size _(or `Number.NaN` if the instance has been destroyed)_
 	*/
 	get size() {
 		return this.#state.cache?.size ?? NaN;
@@ -1712,6 +1780,7 @@ var Memoized = class {
 	}
 	/**
 	* Delete a result from the cache
+	*
 	* @param key Key to delete
 	* @returns `true` if the key existed and was removed, otherwise `false`
 	*/
@@ -1719,7 +1788,9 @@ var Memoized = class {
 		return this.#state.cache?.delete(key) ?? false;
 	}
 	/**
-	* Destroy the instance _(clearing its cache and removing its callback)_
+	* Destroy the instance
+	*
+	* _(When a Memoized instance is destroyed, its cache and callback are removed, and calls to `run` will throw an error)_
 	*/
 	destroy() {
 		this.#state.cache?.clear();
@@ -1728,6 +1799,7 @@ var Memoized = class {
 	}
 	/**
 	* Get a result from the cache
+	*
 	* @param key Key to get
 	* @returns Cached result or `undefined` if it does not exist
 	*/
@@ -1736,6 +1808,7 @@ var Memoized = class {
 	}
 	/**
 	* Does the result exist?
+	*
 	* @param key Key to check
 	* @returns `true` if the result exists, otherwise `false`
 	*/
@@ -1744,11 +1817,12 @@ var Memoized = class {
 	}
 	/**
 	* Run the callback with the provided parameters
+	*
 	* @param parameters Parameters to pass to the callback
 	* @returns Cached or computed _(then cached)_ result
 	*/
 	run(...parameters) {
-		if (this.#state.cache == null || this.#state.getter == null) throw new Error("The Memoized instance has been destroyed");
+		if (this.#state.cache == null || this.#state.getter == null) throw new Error(MEMOIZED_ERROR_DESTROYED);
 		return this.#state.getter(...parameters);
 	}
 };
@@ -1761,14 +1835,18 @@ function getMemoizationOptions(input) {
 }
 /**
 * Memoize a function, caching and retrieving results based on the first parameter
+*
 * @param callback Callback to memoize
 * @param options Memoization options
-* @returns Memoized instance
+* @returns _Memoized_ instance
 */
 function memoize(callback, options) {
+	if (typeof callback !== "function") throw new TypeError(MEMOIZED_ERROR_CALLBACK);
 	return new Memoized(callback, getMemoizationOptions(options));
 }
 const DEFAULT_CACHE_SIZE = 1024;
+const MEMOIZED_ERROR_CALLBACK = "Memoized requires a callback function";
+const MEMOIZED_ERROR_DESTROYED = "The Memoized instance has been destroyed";
 const SEPARATOR = "_";
 //#endregion
 //#region src/internal/function/timer.ts
@@ -1859,11 +1937,11 @@ const startTimer = typeof requestAnimationFrame === "function" ? requestAnimatio
 /**
 * Debounce a function, ensuring it is only called after `time` milliseconds have passed
 *
-* When called, successful _(finished)_ results will resolve and errors will reject.
+* - When called, successful _(finished)_ results will resolve and errors will reject
+* - On subsequent calls, existing calls will be canceled _(rejected)_, the timer reset, and will wait another `time` milliseconds before the new call is made _(and so on...)_
 *
-* On subsequent calls, existing calls will be canceled _(rejected)_, the timer reset, and will wait another `time` milliseconds before the new call is made _(and so on...)_
+* _Available as `asyncDebounce` and `debounce.async`_
 *
-* Available as `asyncDebounce` and `debounce.async`
 * @param callback Callback to debounce
 * @param time Time in milliseconds to wait before calling the callback _(defaults to `0`; e.g., as soon as possible)_
 * @returns Debounced callback handler with a `cancel` method
@@ -1874,11 +1952,11 @@ function asyncDebounce(callback, time) {
 /**
 * Throttle a function, ensuring it is only called once every `time` milliseconds
 *
-* When called, successful _(finished)_ results will resolve and errors will reject.
+* - When called, successful _(finished)_ results will resolve and errors will reject
+* - On subsequent calls, existing calls will be canceled _(rejected)_ and will wait until the next valid time to call the callback again _(and so on...)_
 *
-* On subsequent calls, existing calls will be canceled _(rejected)_ and will wait until the next valid time to call the callback again _(and so on...)_
+* _Available as `asyncThrottle` and `throttle.async`_
 *
-* Available as `asyncThrottle` and `throttle.async`
 * @param callback Callback to throttle
 * @param time Time in milliseconds to wait before calling the callback again _(defaults to `0`; e.g., as soon as possible)_
 * @returns Throttled callback handler with a `cancel` method
@@ -1890,6 +1968,7 @@ function asyncThrottle(callback, time) {
 * Debounce a function, ensuring it is only called after `time` milliseconds have passed
 *
 * On subsequent calls, the timer is reset and will wait another `time` milliseconds _(and so on...)_
+*
 * @param callback Callback to debounce
 * @param time Time in milliseconds to wait before calling the callback _(defaults to `0`; e.g., as soon as possible)_
 * @returns Debounced callback handler with a `cancel` method
@@ -1900,6 +1979,7 @@ function debounce(callback, time) {
 debounce.async = asyncDebounce;
 /**
 * Throttle a function, ensuring it is only called once every `time` milliseconds
+*
 * @param callback Callback to throttle
 * @param time Time in milliseconds to wait before calling the callback again _(defaults to `0`; e.g., as soon as possible)_
 * @returns Throttled callback handler with a `cancel` method
@@ -1913,9 +1993,10 @@ throttle.async = asyncThrottle;
 /**
 * Create an asynchronous function that can only be called once, rejecting or resolving the same result on subsequent calls
 *
-* Available as `asyncOnce` and `once.async`
+* _Available as `asyncOnce` and `once.async`_
+*
 * @param callback Callback to use once
-* @returns Once callback
+* @returns _Once_ callback
 */
 function asyncOnce(callback) {
 	assert(() => typeof callback === "function", ONCE_MESSAGE_EXPECTATION);
@@ -1976,8 +2057,9 @@ function handleOnceResult(state, value, error) {
 }
 /**
 * Create a function that can only be called once, returning the same value on subsequent calls
+*
 * @param callback Callback to use once
-* @returns Once callback
+* @returns _Once_ callback
 */
 function once(callback) {
 	assert(() => typeof callback === "function", ONCE_MESSAGE_EXPECTATION);
@@ -2023,7 +2105,8 @@ var RetryError = class extends Error {
 /**
 * Retry a callback a specified number of times, with a delay between attempts
 *
-* Available as `asyncRetry` and `retry.async`
+* _Available as `asyncRetry` and `retry.async`_
+*
 * @param callback Callback to retry
 * @param options Retry options
 * @returns Callback result
@@ -2066,6 +2149,7 @@ function getRetryOptions(input) {
 }
 /**
 * Retry a callback a specified number of times
+*
 * @param callback Callback to retry
 * @param options Retry options
 * @returns Callback result
@@ -2152,11 +2236,112 @@ const MESSAGE_PIPE_PROMISE = "Synchronous Pipe received a promise. Use `pipe.asy
 const assertFlowFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_FLOW_ARRAY, TypeError);
 const assertPipeFunctions = assert.condition((value) => Array.isArray(value) && value.every((item) => typeof item === "function"), MESSAGE_PIPE_ARRAY, TypeError);
 //#endregion
+//#region src/herald.ts
+var Events = class {
+	#herald;
+	constructor(herald) {
+		this.#herald = herald;
+	}
+	/**
+	* Subscribe to an event with a callback
+	*
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	subscribe(event, callback) {
+		return this.#herald.subscribe(event, callback);
+	}
+	/**
+	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
+	*
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	unsubscribe(event, callback) {
+		return this.#herald.unsubscribe(event, callback);
+	}
+};
+/**
+* A _Herald_ is an announcer for named events, allowing emission, subscription, and unsubscription of events
+*/
+var Herald = class {
+	#names;
+	#subscribers = /* @__PURE__ */ new Map();
+	constructor(names) {
+		this.#names = new Set(names);
+		Object.defineProperty(this, "events", { value: new Events(this) });
+	}
+	/**
+	* Remove all event subscribers
+	*/
+	clear() {
+		this.#subscribers.clear();
+	}
+	/**
+	* Emit an event with parameters
+	*
+	* @param event Event name
+	* @param parameters Event parameters
+	*/
+	emit(event, ...parameters) {
+		const subscribers = this.#subscribers.get(event);
+		if (subscribers == null) return;
+		for (const callback of subscribers) callback(...parameters);
+	}
+	/**
+	* Subscribe to an event with a callback
+	*
+	* @param event Event name
+	* @param callback Callback function
+	* @returns Unsubscriber function
+	*/
+	subscribe(event, callback) {
+		if (!this.#names.has(event) || typeof callback !== "function") return noop;
+		let subscribers = this.#subscribers.get(event);
+		if (subscribers == null) {
+			subscribers = /* @__PURE__ */ new Set();
+			this.#subscribers.set(event, subscribers);
+		}
+		subscribers.add(callback);
+		return () => {
+			subscribers?.delete(callback);
+		};
+	}
+	/**
+	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
+	*
+	* @param event Event name
+	* @param callback Callback function
+	*/
+	unsubscribe(event, callback) {
+		if (!this.#names.has(event) || (callback != null ? typeof callback !== "function" : false)) return;
+		const subscribers = this.#subscribers.get(event);
+		if (subscribers == null) return;
+		if (callback == null) subscribers.clear();
+		else subscribers.delete(callback);
+		if (callback == null || subscribers.size === 0) this.#subscribers.delete(event);
+	}
+};
+/**
+* Create a _Herald_ for announcing named events
+*
+* @param names Event names
+* @returns _Herald_ instance
+*/
+function herald(names) {
+	if (!Array.isArray(names) || names.length === 0 || !names.every((name) => typeof name === "string")) throw new Error(MESSAGE);
+	return new Herald(names);
+}
+const MESSAGE = "Herald requires an array of event names.";
+//#endregion
 //#region src/internal/value/equal.ts
 /**
 * Deregister a equality comparison handler for a specific class
 *
-* Available as `deregisterEqualizer` and `equal.deregister`
+* _Available as `deregisterEqualizer` and `equal.deregister`_
+*
 * @param constructor Class constructor
 */
 function deregisterEqualizer(constructor) {
@@ -2254,7 +2439,7 @@ function equalValue(first, second, options) {
 		case typeof first !== typeof second: return false;
 		case typeof first === "string" && options.ignoreCase === true: return Object.is(first.toLocaleLowerCase(), second.toLocaleLowerCase());
 		case first instanceof ArrayBuffer && second instanceof ArrayBuffer: return equalArrayBuffer(first, second, options);
-		case first instanceof Date && second instanceof Date: return Object.is(Number(first), Number(second));
+		case first instanceof Date && second instanceof Date: return Object.is(first.getTime(), second.getTime());
 		case first instanceof DataView && second instanceof DataView: return equalDataView(first, second, options);
 		case first instanceof Error && second instanceof Error: return equalProperties(first, second, ERROR_PROPERTIES, options);
 		case first instanceof Map && second instanceof Map: return equalMap(first, second, options);
@@ -2295,7 +2480,8 @@ function getEqualOptions(input) {
 /**
 * Create an equalizer with predefined options
 *
-* Available as `initializeEqualizer` and `equal.initialize`
+* _Available as `initializeEqualizer` and `equal.initialize`_
+*
 * @param options Comparison options
 * @returns Equalizer function
 */
@@ -2309,7 +2495,8 @@ function initializeEqualizer(options) {
 /**
 * Register a equality comparison function for a specific class
 *
-* Available as `registerEqualizer` and `equal.register`
+* _Available as `registerEqualizer` and `equal.register`_
+*
 * @param constructor Class constructor
 * @param handler Comparison function
 */
@@ -2358,100 +2545,10 @@ function setValue(data, path, value, ignoreCase) {
 }
 const EXPRESSION_INDEX = /^\d+$/;
 //#endregion
-//#region src/kalas.ts
-var Events = class {
-	#kalas;
-	constructor(kalas) {
-		this.#kalas = kalas;
-	}
-	/**
-	* Subscribe to an event with a callback
-	* @param event Event name
-	* @param callback Callback function
-	* @returns Unsubscriber function
-	*/
-	subscribe(event, callback) {
-		return this.#kalas.subscribe(event, callback);
-	}
-	/**
-	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
-	* @param event Event name
-	* @param callback Callback function
-	* @returns Unsubscriber function
-	*/
-	unsubscribe(event, callback) {
-		return this.#kalas.unsubscribe(event, callback);
-	}
-};
-var Kalas = class {
-	#names;
-	#subscribers = /* @__PURE__ */ new Map();
-	constructor(names) {
-		this.#names = new Set(names);
-		Object.defineProperty(this, "events", { value: new Events(this) });
-	}
-	/**
-	* Remove all event subscribers
-	*/
-	clear() {
-		this.#subscribers.clear();
-	}
-	/**
-	* Emit an event with parameters
-	* @param event Event name
-	* @param parameters Event parameters
-	*/
-	emit(event, ...parameters) {
-		const subscribers = this.#subscribers.get(event);
-		if (subscribers == null) return;
-		for (const callback of subscribers) callback(...parameters);
-	}
-	/**
-	* Subscribe to an event with a callback
-	* @param event Event name
-	* @param callback Callback function
-	* @returns Unsubscriber function
-	*/
-	subscribe(event, callback) {
-		if (!this.#names.has(event) || typeof callback !== "function") return noop;
-		let subscribers = this.#subscribers.get(event);
-		if (subscribers == null) {
-			subscribers = /* @__PURE__ */ new Set();
-			this.#subscribers.set(event, subscribers);
-		}
-		subscribers.add(callback);
-		return () => {
-			subscribers?.delete(callback);
-		};
-	}
-	/**
-	* Unsubscribe from an event with a callback _(or all callbacks, if no callback is provided)_
-	* @param event Event name
-	* @param callback Callback function
-	*/
-	unsubscribe(event, callback) {
-		if (!this.#names.has(event) || (callback != null ? typeof callback !== "function" : false)) return;
-		const subscribers = this.#subscribers.get(event);
-		if (subscribers == null) return;
-		if (callback == null) subscribers.clear();
-		else subscribers.delete(callback);
-		if (callback == null || subscribers.size === 0) this.#subscribers.delete(event);
-	}
-};
-/**
-* Create a Kalas _(party)_ for named events
-* @param names Event names
-* @returns Kalas instance
-*/
-function kalas(names) {
-	if (!Array.isArray(names) || names.length === 0 || !names.every((name) => typeof name === "string")) throw new Error(MESSAGE);
-	return new Kalas(names);
-}
-const MESSAGE = "Kalas requires an array of event names.";
-//#endregion
 //#region src/string/case.ts
 /**
 * Convert a string to camel case _(thisIsCamelCase)_
+*
 * @param value String to convert
 * @returns Camel-cased string
 */
@@ -2460,6 +2557,7 @@ function camelCase(value) {
 }
 /**
 * Capitalize the first letter of a string _(and lowercase the rest)_
+*
 * @param value String to capitalize
 * @returns Capitalized string
 */
@@ -2470,6 +2568,7 @@ function capitalize(value) {
 }
 /**
 * Convert a string to kebab case _(this-is-kebab-case)_
+*
 * @param value String to convert
 * @returns Kebab-cased string
 */
@@ -2478,6 +2577,7 @@ function kebabCase(value) {
 }
 /**
 * Convert a string to lower case
+*
 * @param value String to convert
 * @returns Lower-cased string
 */
@@ -2488,6 +2588,7 @@ function lowerCase(value) {
 }
 /**
 * Convert a string to pascal case _(ThisIsPascalCase)_
+*
 * @param value String to convert
 * @returns Pascal-cased string
 */
@@ -2496,6 +2597,7 @@ function pascalCase(value) {
 }
 /**
 * Convert a string to snake case _(this_is_snake_case)_
+*
 * @param value String to convert
 * @returns Snake-cased string
 */
@@ -2504,6 +2606,7 @@ function snakeCase(value) {
 }
 /**
 * Convert a string to title case _(Capitalizing Every Word)_
+*
 * @param value String to convert
 * @returns Title-cased string
 */
@@ -2545,6 +2648,7 @@ function toCaseCallback(value) {
 }
 /**
 * Convert a string to upper case
+*
 * @param value String to convert
 * @returns Upper-cased string
 */
@@ -2579,6 +2683,7 @@ let memoizedUpperCase;
 //#region src/is.ts
 /**
 * Is the value empty, or only containing `null` or `undefined` values?
+*
 * @param value Value to check
 * @returns `true` if the value is considered empty, otherwise `false`
 */
@@ -2587,11 +2692,15 @@ function isEmpty(value) {
 	if (typeof value === "string") return value.length === 0;
 	const values = getArray(value);
 	const { length } = values;
-	for (let index = 0; index < length; index += 1) if (values[index] != null) return false;
+	for (let index = 0; index < length; index += 1) {
+		const item = values[index];
+		if (Array.isArray(item) ? item[1] != null : item != null) return false;
+	}
 	return true;
 }
 /**
 * Is the value not empty, or holding non-empty values?
+*
 * @param value Value to check
 * @returns `true` if the value is not considered empty, otherwise `false`
 */
@@ -2600,6 +2709,7 @@ function isNonEmpty(value) {
 }
 /**
 * Is the value not `undefined` or `null`?
+*
 * @param value Value to check
 * @returns `true` if the value is not `undefined` or `null`, otherwise `false`
 */
@@ -2608,6 +2718,7 @@ function isNonNullable(value) {
 }
 /**
 * Is the value not `undefined`, `null`, or stringified as an empty _(no whitespace)_ string?
+*
 * @param value Value to check
 * @returns `true` if the value is not `undefined`, `null`, or matches an empty string, otherwise `false`
 */
@@ -2616,6 +2727,7 @@ function isNonNullableOrEmpty(value) {
 }
 /**
 * Is the value not `undefined`, `null`, or stringified as a whitespace-only string?
+*
 * @param value Value to check
 * @returns `true` if the value is not `undefined`, `null`, or matches a whitespace-only string, otherwise `false`
 */
@@ -2624,6 +2736,7 @@ function isNonNullableOrWhitespace(value) {
 }
 /**
 * Is the value not a number or a number-like string?
+*
 * @param value Value to check
 * @returns `true` if the value is not a number or a number-like string, otherwise `false`
 */
@@ -2632,6 +2745,7 @@ function isNonNumerical(value) {
 }
 /**
 * Is the value not an object _(or function)_?
+*
 * @param value Value to check
 * @returns `true` if the value is not an object, otherwise `false`
 */
@@ -2640,6 +2754,7 @@ function isNonObject(value) {
 }
 /**
 * Is the value `undefined` or `null`?
+*
 * @param value Value to check
 * @returns `true` if the value is `undefined` or `null`, otherwise `false`
 */
@@ -2648,6 +2763,7 @@ function isNullable(value) {
 }
 /**
 * Is the value `undefined`, `null`, or stringified as an empty _(no whitespace)_ string?
+*
 * @param value Value to check
 * @returns `true` if the value is nullable or matches an empty string, otherwise `false`
 */
@@ -2656,6 +2772,7 @@ function isNullableOrEmpty(value) {
 }
 /**
 * Is the value `undefined`, `null`, or stringified as a whitespace-only string?
+*
 * @param value Value to check
 * @returns `true` if the value is nullable or matches a whitespace-only string, otherwise `false`
 */
@@ -2664,6 +2781,7 @@ function isNullableOrWhitespace(value) {
 }
 /**
 * Is the value a number or a number-like string?
+*
 * @param value Value to check
 * @returns `true` if the value is a number or a number-like string, otherwise `false`
 */
@@ -2672,6 +2790,7 @@ function isNumerical(value) {
 }
 /**
 * Is the value an object _(or function)_?
+*
 * @param value Value to check
 * @returns `true` if the value matches, otherwise `false`
 */
@@ -2683,6 +2802,7 @@ const EXPRESSION_WHITESPACE = /^\s*$/;
 //#region src/string/match.ts
 /**
 * Check if a string ends with a specified substring
+*
 * @param haystack String to look in
 * @param needle String to look for
 * @param ignoreCase Ignore case when matching? _(defaults to `false`)_
@@ -2693,6 +2813,7 @@ function endsWith(haystack, needle, ignoreCase) {
 }
 /**
 * Check if a string includes a specified substring
+*
 * @param haystack String to look in
 * @param needle String to look for
 * @param ignoreCase Ignore case when matching? _(defaults to `false`)_
@@ -2711,6 +2832,7 @@ function matchCallback(haystack, needle, ignoreCase) {
 }
 /**
 * Check if a string starts with a specified substring
+*
 * @param haystack String to look in
 * @param needle String to look for
 * @param ignoreCase Ignore case when matching? _(defaults to `false`)_
@@ -2732,12 +2854,16 @@ var Fuzzy = class {
 	#state;
 	/**
 	* Get items currently being searched through
+	*
+	* @returns Original items
 	*/
 	get items() {
 		return this.#state.items.slice();
 	}
 	/**
 	* Set new items to search through
+	*
+	* @param items New items to search through
 	*/
 	set items(items) {
 		if (Array.isArray(items)) {
@@ -2747,6 +2873,8 @@ var Fuzzy = class {
 	}
 	/**
 	* Get strings currently being searched through _(the stringified version of `items`)_
+	*
+	* @returns Stringified items
 	*/
 	get strings() {
 		return this.#state.strings.slice();
@@ -2801,6 +2929,7 @@ function fuzzy(items, configuration) {
 fuzzy.match = fuzzyMatch;
 /**
 * Does the needle match the haystack in a fuzzy way?
+*
 * @param haystack Haystack to search through
 * @param needle Needle to search for
 * @returns `true` if the needle matches the haystack in a fuzzy way, `false` otherwise
@@ -2926,7 +3055,8 @@ function dedent(value, ...values) {
 	return result.trim();
 }
 /**
-* Get a new UUID-string _(version 4)_
+* Get a new UUID string _(version 4)_
+*
 * @returns UUID string
 */
 function getUuid() {
@@ -2943,14 +3073,9 @@ function getUuid() {
 		hex.substring(20, 32)
 	].join("-");
 }
-function interpolate(strings, values) {
-	const { length } = strings;
-	let interpolated = "";
-	for (let index = 0; index < length; index += 1) interpolated += `${strings[index]}${getString(values[index])}`;
-	return interpolated;
-}
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
+*
 * @param value JSON string to parse
 * @param reviver Reviver function to transform the parsed values
 * @returns Parsed value or `undefined` if parsing fails
@@ -2964,6 +3089,7 @@ function parse(value, reviver) {
 }
 /**
 * Trim a string _(removing whitespace from both ends)_
+*
 * @param value String to trim
 * @returns Trimmed string
 */
@@ -2971,7 +3097,8 @@ function trim(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 /**
-* Truncate a string to a specified length, when possible
+* Truncate a string to a specified length
+*
 * @param value String to truncate
 * @param length Maximum length of the string after truncation
 * @param suffix Suffix to append to the truncated string
@@ -2991,6 +3118,7 @@ const ZERO = "0";
 //#region src/string/normalize.ts
 /**
 * Deburr a string, removing diacritical marks
+*
 * @param value String to deburr
 * @returns Deburred string
 */
@@ -3016,7 +3144,8 @@ function getNormalizeOptions(input) {
 /**
 * Initialize a string normalizer
 *
-* Available as `initializeNormalizer` and `normalize.initialize`
+* _Available as `initializeNormalizer` and `normalize.initialize`_
+*
 * @param options Normalization options
 * @returns Normalizer function
 */
@@ -3027,7 +3156,8 @@ function initializeNormalizer(options) {
 /**
 * Normalize a string
 *
-* By default, the string will be trimmed, deburred, and then lowercased
+* _By default, the string will be trimmed, deburred, and then lowercased_
+*
 * @param value String to normalize
 * @param options Normalization options
 * @returns Normalized string
@@ -3089,6 +3219,11 @@ const WHITESPACE_REPLACEMENT = " ";
 let deburrMemoizer;
 //#endregion
 //#region src/string/template.ts
+function getRenderer(strings, values) {
+	return (variables, options) => {
+		return template(interpolate(strings, values), variables, options);
+	};
+}
 function getTemplateOptions(input) {
 	const options = isPlainObject(input) ? input : {};
 	return {
@@ -3098,7 +3233,7 @@ function getTemplateOptions(input) {
 }
 function handleTemplate(value, pattern, ignoreCase, variables) {
 	if (typeof value !== "string") return "";
-	if (typeof variables !== "object" || variables === null) return value;
+	if (typeof variables !== "object" || variables === null || Object.keys(variables).length === 0) return value;
 	const values = {};
 	return value.replace(pattern, (_, key) => {
 		if (values[key] == null) {
@@ -3109,36 +3244,31 @@ function handleTemplate(value, pattern, ignoreCase, variables) {
 	});
 }
 /**
-* Create a templater with predefined options
+* Create a _Templater_ with predefined options
+*
+* _Available as `initializeTemplater` and `template.initialize`_
 *
-* Available as `initializeTemplater` and `template.initialize`
 * @param options Templating options
-* @returns Templater function
+* @returns _Templater_ function
 */
 function initializeTemplater(options) {
 	const { ignoreCase, pattern } = getTemplateOptions(options);
-	return (value, variables) => {
-		return handleTemplate(value, pattern, ignoreCase, variables);
-	};
+	return ((value, ...parameters) => {
+		return isTemplateStringsArray(value) ? (variables) => handleTemplate(interpolate(value, parameters), pattern, ignoreCase, variables) : handleTemplate(value, pattern, ignoreCase, parameters[0]);
+	});
 }
-/**
-* Render a string from a template with variables
-* @param value Template string
-* @param variables Variables to use
-* @param options Templating options
-* @returns Templated string
-*/
-function template(value, variables, options) {
-	const { ignoreCase, pattern } = getTemplateOptions(options);
-	return handleTemplate(value, pattern, ignoreCase, variables);
+function template(value, ...parameters) {
+	if (isTemplateStringsArray(value)) return getRenderer(value, parameters);
+	const { ignoreCase, pattern } = getTemplateOptions(parameters[1]);
+	return handleTemplate(value, pattern, ignoreCase, parameters[0]);
 }
 template.initialize = initializeTemplater;
 const EXPRESSION_VARIABLE = /{{([\s\S]+?)}}/g;
 //#endregion
 //#region src/value/clone.ts
 const CLONE_NAME = "clone";
-function clone(value) {
-	return cloneValue(value, 0, /* @__PURE__ */ new WeakMap());
+function clone(value, flat) {
+	return flat === true ? copy(value) : cloneValue(value, 0, /* @__PURE__ */ new WeakMap(), false);
 }
 clone.handlers = getSelfHandlers(clone, {
 	callback: tryStructuredClone,
@@ -3160,11 +3290,11 @@ function cloneDataView(value, depth, references) {
 	references.set(value, cloned);
 	return cloned;
 }
-function cloneMap(map, depth, references) {
+function cloneMap(map, depth, references, flat) {
 	if (depth >= MAX_CLONE_DEPTH) return map;
 	const cloned = /* @__PURE__ */ new Map();
 	const entries = map.entries();
-	for (const entry of entries) cloned.set(cloneValue(entry[0], depth + 1, references), cloneValue(entry[1], depth + 1, references));
+	for (const entry of entries) cloned.set(flat ? entry[0] : cloneValue(entry[0], depth + 1, references, false), flat ? entry[1] : cloneValue(entry[1], depth + 1, references, false));
 	references.set(map, cloned);
 	return cloned;
 }
@@ -3174,14 +3304,14 @@ function cloneNode(node, depth, references) {
 	references.set(node, cloned);
 	return cloned;
 }
-function clonePlainObject(value, depth, references) {
-	if (depth >= MAX_CLONE_DEPTH) return Array.isArray(value) ? value.slice() : { ...value };
+function cloneObject(value, depth, references, flat) {
+	if (flat || depth >= MAX_CLONE_DEPTH) return Array.isArray(value) ? value.slice() : { ...value };
 	const cloned = Array.isArray(value) ? [] : {};
 	const keys = [...Object.keys(value), ...Object.getOwnPropertySymbols(value)];
 	const { length } = keys;
 	for (let index = 0; index < length; index += 1) {
 		const key = keys[index];
-		cloned[key] = cloneValue(value[key], depth + 1, references);
+		cloned[key] = cloneValue(value[key], depth + 1, references, false);
 	}
 	references.set(value, cloned);
 	return cloned;
@@ -3193,12 +3323,12 @@ function cloneRegularExpression(value, depth, references) {
 	references.set(value, cloned);
 	return cloned;
 }
-function cloneSet(set, depth, references) {
+function cloneSet(set, depth, references, flat) {
 	if (depth >= MAX_CLONE_DEPTH) return set;
 	const cloned = /* @__PURE__ */ new Set();
 	const values = [...set.values()];
 	const { length } = values;
-	for (let index = 0; index < length; index += 1) cloned.add(cloneValue(values[index], depth + 1, references));
+	for (let index = 0; index < length; index += 1) cloned.add(flat ? values[index] : cloneValue(values[index], depth + 1, references, false));
 	references.set(set, cloned);
 	return cloned;
 }
@@ -3208,32 +3338,45 @@ function cloneTypedArray(value, depth, references) {
 	references.set(value, cloned);
 	return cloned;
 }
-function cloneValue(value, depth, references) {
+function cloneValue(value, depth, references, flat) {
 	switch (true) {
-		case value == null: return value;
-		case typeof value === "bigint": return BigInt(value);
-		case typeof value === "boolean": return Boolean(value);
+		case value == null:
+		case typeof value === "bigint":
+		case typeof value === "boolean":
+		case typeof value === "number":
+		case typeof value === "string": return value;
 		case typeof value === "function": return;
-		case typeof value === "number": return Number(value);
-		case typeof value === "string": return String(value);
 		case typeof value === "symbol": return Symbol(value.description);
 		case references.has(value): return references.get(value);
 		case value instanceof ArrayBuffer: return cloneArrayBuffer(value, depth, references);
 		case value instanceof DataView: return cloneDataView(value, depth, references);
 		case value instanceof Date: return new Date(value.getTime());
 		case value instanceof RegExp: return cloneRegularExpression(value, depth, references);
-		case value instanceof Map: return cloneMap(value, depth, references);
+		case value instanceof Map: return cloneMap(value, depth, references, flat);
 		case typeof Node !== "undefined" && value instanceof Node: return cloneNode(value, depth, references);
-		case value instanceof Set: return cloneSet(value, depth, references);
-		case isArrayOrPlainObject(value): return clonePlainObject(value, depth, references);
+		case value instanceof Set: return cloneSet(value, depth, references, flat);
+		case isArrayOrPlainObject(value): return cloneObject(value, depth, references, flat);
 		case isTypedArray(value): return cloneTypedArray(value, depth, references);
 		default: return clone.handlers.handle(value, depth, references);
 	}
 }
 /**
+* Copy any kind of value
+*
+* - Clones the value shallowly, without cloning nested values
+* - To copy a value deeply, use `clone` instead
+*
+* @param value Value to copy
+* @returns Copied value
+*/
+function copy(value) {
+	return cloneValue(value, 0, /* @__PURE__ */ new WeakMap(), true);
+}
+/**
 * Deregister a clone handler for a specific class
 *
-* Available as `deregisterCloner` and `template.deregister`
+* _Available as `deregisterCloner` and `template.deregister`_
+*
 * @param constructor Class constructor
 */
 function deregisterCloner(constructor) {
@@ -3242,9 +3385,10 @@ function deregisterCloner(constructor) {
 /**
 * Register a clone handler for a specific class
 *
-* Available as `registerCloner` and `template.register`
+* _Available as `registerCloner` and `template.register`_
+*
 * @param constructor Class constructor
-* @param handler Method name or clone function _(defaults to `clone`)_
+* @param handler Method name or clone function _(defaults to method name `clone`)_
 */
 function registerCloner(constructor, handler) {
 	clone.handlers.register(constructor, handler);
@@ -3270,8 +3414,9 @@ function inMap(map, value, key) {
 	for (const [key, item] of map) if (equal(item, value)) return key;
 }
 /**
-* Does the value exist in a set?
-* @param set Set to check in
+* Does the value exist in a _Set_?
+*
+* @param set _Set_ to check in
 * @param value Value to check for
 * @returns `true` if the value exists, otherwise `false`
 */
@@ -3285,6 +3430,7 @@ function inSet(set, value) {
 //#region src/value/diff.ts
 /**
 * Find the differences between two values
+*
 * @param first First value
 * @param second Second value
 * @param options Comparison options
@@ -3385,40 +3531,81 @@ const DIFF_NONE = "none";
 const DIFF_PARTIAL = "partial";
 //#endregion
 //#region src/value/freeze.ts
-function freeze(value) {
-	return freezeValue(value, /* @__PURE__ */ new WeakSet());
+function fakeDelete() {
+	return false;
 }
-function freezeArray(array, references) {
+function flatFreeze(value) {
+	return freezeValue(value, /* @__PURE__ */ new WeakSet(), true);
+}
+function freeze(value, flat) {
+	return freezeValue(value, /* @__PURE__ */ new WeakSet(), flat === true);
+}
+freeze.flat = flatFreeze;
+freeze.is = isFrozen;
+function freezeArray(array, references, flat) {
+	if (flat) return Object.freeze(array);
 	references.add(array);
 	const { length } = array;
 	for (let index = 0; index < length; index += 1) {
 		const value = array[index];
-		if (!references.has(value)) array[index] = freezeValue(array[index], references);
+		if (!references.has(value)) array[index] = freezeValue(array[index], references, false);
 	}
 	return Object.freeze(array);
 }
-function freezeFunction(fn, references) {
-	references.add(fn);
-	return Object.freeze(fn);
+function freezeMap(map, references, flat) {
+	frozenValues.add(map);
+	map.clear = noop;
+	map.delete = fakeDelete;
+	map.set = () => map;
+	if (flat) return map;
+	references.add(map);
+	const entries = map.entries();
+	for (const [key, value] of entries) if (!references.has(value)) map.set(key, freezeValue(value, references, false));
+	return map;
 }
-function freezeObject(object, references) {
+function freezeObject(object, references, flat) {
+	if (flat) return Object.freeze(object);
 	references.add(object);
 	const keys = Object.keys(object);
 	const { length } = keys;
 	for (let index = 0; index < length; index += 1) {
 		const key = keys[index];
-		if (!references.has(object[key])) object[key] = freezeValue(object[key], references);
+		if (!references.has(object[key])) object[key] = freezeValue(object[key], references, false);
 	}
 	return Object.freeze(object);
 }
-function freezeValue(value, references) {
+function freezeSet(set, references, flat) {
+	frozenValues.add(set);
+	set.clear = noop;
+	set.delete = fakeDelete;
+	set.add = () => set;
+	if (flat) return set;
+	references.add(set);
+	const values = set.values();
+	for (const value of values) if (!references.has(value)) set.add(freezeValue(value, references, false));
+	return set;
+}
+function freezeValue(value, references, flat) {
 	switch (true) {
-		case typeof value === "function": return freezeFunction(value, references);
-		case Array.isArray(value): return freezeArray(value, references);
-		case isPlainObject(value): return freezeObject(value, references);
+		case isFrozen(value): return value;
+		case value instanceof Map: return freezeMap(value, references, flat);
+		case value instanceof Set: return freezeSet(value, references, flat);
+		case Array.isArray(value): return freezeArray(value, references, flat);
+		case isPlainObject(value): return freezeObject(value, references, flat);
 		default: return value;
 	}
 }
+/**
+* Is the value frozen?
+*
+* @param value Value to check
+* @returns `true` if the value is frozen, otherwise `false`
+*/
+function isFrozen(value) {
+	if (value instanceof Map || value instanceof Set) return frozenValues.has(value);
+	return typeof value === "object" && value !== null && Object.isFrozen(value);
+}
+const frozenValues = /* @__PURE__ */ new WeakSet();
 //#endregion
 //#region src/internal/value/partial.ts
 function partial(value, providedKeys, omit) {
@@ -3438,6 +3625,7 @@ function partial(value, providedKeys, omit) {
 //#region src/value/omit.ts
 /**
 * Create a new object without the specified keys
+*
 * @param value Original object
 * @param keys Keys to omit
 * @returns Partial object without the specified keys
@@ -3449,6 +3637,7 @@ function omit(value, keys) {
 //#region src/value/pick.ts
 /**
 * 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
@@ -3460,6 +3649,7 @@ function pick(value, keys) {
 //#region src/value/shake.ts
 /**
 * Shake an object, removing all keys with `undefined` values
+*
 * @param value Object to shake
 * @returns Shaken object
 */
@@ -3503,6 +3693,7 @@ function flattenObject(value, depth, smushed, prefix) {
 }
 /**
 * Smush an object into a flat object that uses dot notation keys
+*
 * @param value Object to smush
 * @returns Smushed object with dot notation keys
 */
@@ -3527,6 +3718,7 @@ function getKeys(value) {
 }
 /**
 * Unsmush a smushed object _(turning dot notation keys into nested keys)_
+*
 * @param value Object to unsmush
 * @returns Unsmushed object with nested keys
 */
@@ -3581,7 +3773,7 @@ function getReplaceableObjects(value) {
 /**
 * Create an assigner with predefined options
 *
-* Available as `initializeAssigner` and `assign.initialize`
+* _Available as `initializeAssigner` and `assign.initialize`_
 *
 * @param options Assigning options
 * @returns Assigner function
@@ -3594,7 +3786,7 @@ function initializeAssigner(options) {
 /**
 * Create a merger with predefined options
 *
-* Available as `initializeMerger` and `merge.initialize`
+* _Available as `initializeMerger` and `merge.initialize`_
 *
 * @param options Merging options
 * @returns Merger function
@@ -3724,6 +3916,7 @@ var Beacon = class {
 	}
 	/**
 	* Emit a new value
+	*
 	* @param value Value to set and emit
 	* @param finish Finish the beacon after emitting? _(defaults to `false`)_
 	*/
@@ -3732,6 +3925,7 @@ var Beacon = class {
 	}
 	/**
 	* Emit an error
+	*
 	* @param value Error to emit
 	* @param finish Finish the beacon after emitting? _(defaults to `false`)_
 	*/
@@ -3816,6 +4010,7 @@ var Subscription = class {
 };
 /**
 * Create a new beacon
+*
 * @param value Initial value
 * @param options Beacon options
 * @returns Beacon instance
@@ -3949,9 +4144,10 @@ function isBytey(value) {
 	return typeof value === "number" && between(value, 0, 255);
 }
 /**
-* Is the value a Color?
+* Is the value a _Color_?
+*
 * @param value Value to check
-* @returns `true` if the value is a Color, otherwise `false`
+* @returns `true` if the value is a _Color_, otherwise `false`
 */
 function isColor(value) {
 	return typeof value === "object" && value !== null && "$color" in value && value.$color === true;
@@ -3972,9 +4168,19 @@ function isDegree(value) {
 }
 /**
 * Is the value a hex color?
+*
 * @param value Value to check
-* @param alpha Allow alpha channel? _(defaults to `true`)_
+* @param alpha Allow alpha channel _(opacity)_? _(defaults to `true`)_
 * @returns `true` if the value is a hex color, otherwise `false`
+*
+* @example
+* ```typescript
+* isHexColor('ff0000');  // => true
+* isHexColor('#ff0000'); // => true
+*
+* isHexColor('#ff000050');        // => true
+* isHexColor('#ff000050', false); // => false
+* ```
 */
 function isHexColor(value, alpha) {
 	if (typeof value !== "string") return false;
@@ -3983,17 +4189,19 @@ function isHexColor(value, alpha) {
 	return true;
 }
 /**
-* Is the value an HSLA color?
+* Is the value an _HSLA_ color?
+*
 * @param value Value to check
-* @returns `true` if the value is an HSLA color, otherwise `false`
+* @returns `true` if the value is an _HSLA_ color, otherwise `false`
 */
 function isHslaColor(value) {
 	return isColorValue(value, KEYS_HSLA);
 }
 /**
-* Is the value an HSL color?
+* Is the value an _HSL_ color?
+*
 * @param value Value to check
-* @returns `true` if the value is an HSL color, otherwise `false`
+* @returns `true` if the value is an _HSL_ color, otherwise `false`
 */
 function isHslColor(value) {
 	return isColorValue(value, KEYS_HSLA) || isColorValue(value, KEYS_HSL);
@@ -4002,17 +4210,19 @@ function isHslLike(value) {
 	return hasKeys(value, KEYS_HSL);
 }
 /**
-* Is the value an RGBA color?
+* Is the value an _RGBA_ color?
+*
 * @param value Value to check
-* @returns `true` if the value is an RGBA color, otherwise `false`
+* @returns `true` if the value is an _RGBA_ color, otherwise `false`
 */
 function isRgbaColor(value) {
 	return isColorValue(value, KEYS_RGBA);
 }
 /**
-* Is the value an RGB color?
+* Is the value an _RGB_ color?
+*
 * @param value Value to check
-* @returns `true` if the value is an RGB color, otherwise `false`
+* @returns `true` if the value is an _RGB_ color, otherwise `false`
 */
 function isRgbColor(value) {
 	return isColorValue(value, KEYS_RGBA) || isColorValue(value, KEYS_RGB);
@@ -4039,6 +4249,10 @@ function getClampedValue(value, minimum, maximum) {
 }
 /**
 * Get a foreground color _(usually text)_ based on a background color's luminance
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a white foreground color will be returned
+*
 * @param value Original value
 * @returns Foreground color
 */
@@ -4058,9 +4272,13 @@ function getForegroundColor(value) {
 	return new Color(.2126 * values[2] + .7152 * values[1] + .0722 * values[0] > .625 ? HEX_BLACK : HEX_WHITE);
 }
 /**
-* Get the hex color _(with alpha channel)_ from any kind of value
+* Get the hex color _(with alpha channel, i.e., opacity)_ from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black hex color with an alpha channel of `0` will be returned
+*
 * @param value Original value
-* @returns Hex color
+* @returns Hex color string
 */
 function getHexaColor(value) {
 	const { alpha, hex } = getColorState(value);
@@ -4068,8 +4286,12 @@ function getHexaColor(value) {
 }
 /**
 * Get the hex color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black hex color will be returned
+*
 * @param value Original value
-* @returns Hex color
+* @returns Hex color string
 */
 function getHexColor(value) {
 	return getColorState(value).hex;
@@ -4081,9 +4303,13 @@ function getDegrees(value) {
 	return getClampedValue(value, 0, 360);
 }
 /**
-* Get the HSLA color from any kind of value
+* Get the _HSLA_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _HSLA_ color with an alpha channel _(opacity)_ of `0` will be returned
+*
 * @param value Original value
-* @returns HSLA color
+* @returns _HSLA_ color
 */
 function getHslaColor(value) {
 	const { alpha, hsl } = getColorState(value);
@@ -4093,9 +4319,13 @@ function getHslaColor(value) {
 	};
 }
 /**
-* Get the HSL color from any kind of value
+* Get the _HSL_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _HSL_ color will be returned
+*
 * @param value Original value
-* @returns HSL color
+* @returns _HSL_ color
 */
 function getHslColor(value) {
 	return getColorState(value).hsl;
@@ -4104,9 +4334,13 @@ function getPercentage(value) {
 	return getClampedValue(value, 0, 100);
 }
 /**
-* Get the RGBA color from any kind of value
+* Get the _RGBA_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _RGBA_ color with an alpha channel _(opacity)_ of `0` will be returned
+*
 * @param value Original value
-* @returns RGBA color
+* @returns _RGBA_ color
 */
 function getRgbaColor(value) {
 	const { alpha, rgb } = getColorState(value);
@@ -4116,9 +4350,13 @@ function getRgbaColor(value) {
 	};
 }
 /**
-* Get the RGB color from any kind of value
+* Get the _RGB_ color from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value cannot be parsed, a black _RGB_ color will be returned
+*
 * @param value Original value
-* @returns RGB color
+* @returns _RGB_ color
 */
 function getRgbColor(value) {
 	return getColorState(value).rgb;
@@ -4179,20 +4417,26 @@ function getRgbValue(value) {
 	};
 }
 /**
-* Convert an RGB(A) color to a hex color _(with optional alpha channel)_
-* @param rgb RGB(A) color
-* @param alpha Include alpha channel? _(defaults to `false`)_
-* @returns Hex color
+* Convert an _RGB(A)_ color to a hex color _(with optional alpha channel, i.e., opacity)_
+*
+* _If the value is unable to be converted, a black hex color will be returned_
+*
+* @param rgb _RGB(A)_ color
+* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+* @returns Hex color string
 */
 function rgbToHex(rgb, alpha) {
 	return convertRgbToHex(isRgbLike(rgb) ? getRgbValue(rgb) : { ...DEFAULT_RGB }, alpha ?? false);
 }
 /**
-* Convert an RGB(A) color to an HSL color
+* Convert an _RGB(A)_ color to an _HSL_ color
+*
+* _If the value is unable to be converted, a black HSL color will be returned_
 *
-* Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26
-* @param rgb RGB(A) color
-* @returns HSL color
+* _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
+*
+* @param rgb _RGB(A)_ color
+* @returns _HSL_ color
 */
 function rgbToHsl(rgb) {
 	const { hue, lightness, saturation } = convertRgbToHsla(rgb);
@@ -4203,11 +4447,14 @@ function rgbToHsl(rgb) {
 	};
 }
 /**
-* Convert an RGB(A) color to an HSLA color
+* Convert an _RGB(A)_ color to an _HSLA_ color
+*
+* _If the value is unable to be converted, a black _HSLA_ color with an alpha channel (opacity) of `0` will be returned_
 *
-* Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26
-* @param rgb RGB(A) color
-* @returns HSLA color
+* _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L26_
+*
+* @param rgb _RGB(A)_ color
+* @returns _HSLA_ color
 */
 function rgbToHsla(rgb) {
 	return convertRgbToHsla(rgb);
@@ -4229,9 +4476,12 @@ function convertHexToRgba(value) {
 }
 /**
 * Get the normalized hex color from a value
+*
+* _If the value is unable to be parsed or normalized, a hex color of `000000` will be returned, with the alpha channel _(opacity)_ value `0` included, if specified_
+*
 * @param value Value to normalize
-* @param alpha Include alpha channel? _(defaults to `false`)_
-* @returns Normalized hex color, or `000000` if the value is unable to be normalized
+* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+* @returns Normalized hex color
 */
 function getNormalizedHex(value, alpha) {
 	const includeAlpha = alpha ?? false;
@@ -4252,9 +4502,12 @@ function hexToHsla(value) {
 	return convertRgbToHsla(convertHexToRgba(value));
 }
 /**
-* Convert a hex color to an RGB color
+* Convert a hex color to an _RGB_ color
+*
+* _If the value is unable to be converted, a black RGB color will be returned_
+*
 * @param value Original value
-* @returns RGB color
+* @returns _RGB_ color
 */
 function hexToRgb(value) {
 	const { blue, green, red } = convertHexToRgba(value);
@@ -4265,9 +4518,12 @@ function hexToRgb(value) {
 	};
 }
 /**
-* Convert a hex color to an RGBA color
+* Convert a hex color to an _RGBA_ color
+*
+* _If the value is unable to be converted, a black RGBA color with an alpha channel (opacity) of `0` will be returned_
+*
 * @param value Original value
-* @returns RGBA color
+* @returns _RGBA_ color
 */
 function hexToRgba(value) {
 	return convertHexToRgba(value);
@@ -4301,9 +4557,12 @@ function hslToHex(hsl, alpha) {
 	return convertRgbToHex(convertHslToRgba(hsl), alpha ?? false);
 }
 /**
-* Convert an HSL(A) color to an RGB color
+* Convert an _HSL(A)_ color to an _RGB_ color
+*
+* _If the value is unable to be converted, a black RGB color will be returned_
+*
+* _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
 *
-* Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61
 * @param hsl HSL(A) color
 * @returns RGB color
 */
@@ -4316,9 +4575,12 @@ function hslToRgb(hsl) {
 	};
 }
 /**
-* Convert an HSL(A) color to an RGBA color
+* Convert an _HSL(A)_ color to an _RGBA_ color
+*
+* _If the value is unable to be converted, a black RGBA color with an alpha channel (opactiy) of `0` will be returned_
+*
+* _Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61_
 *
-* Thanks, https://github.com/color-js/color.js/blob/main/src/spaces/hsl.js#L61
 * @param hsl HSL(A) color
 * @returns RGBA color
 */
@@ -4362,7 +4624,7 @@ function getColorState(value) {
 		}
 	}
 	state.alpha ??= getAlpha(1);
-	state.hex ??= String(HEX_BLACK);
+	state.hex ??= HEX_BLACK;
 	state.hsl ??= { ...DEFAULT_HSL };
 	state.rgb ??= { ...DEFAULT_RGB };
 	return state;
@@ -4410,55 +4672,86 @@ function setRGBColor(state, value, alpha) {
 var Color = class {
 	#state;
 	/**
-	* Get the alpha channel
+	* Get the alpha channel _(opacity)_ of the color
+	*
+	* @returns Current alpha channel value between `0` and `1`
 	*/
 	get alpha() {
 		return this.#state.alpha.value;
 	}
 	/**
-	* Set the alpha channel
+	* Set the alpha channel _(opacity)_ of the color, as:
+	*
+	* - A number between `0` and `1`, where `0` is fully transparent and `1` is fully opaque
+	* - A number between `0` and `100`, where `0` is fully transparent and `100` is fully opaque
+	*
+	* @param value New alpha channel value
 	*/
 	set alpha(value) {
 		if (typeof value === "number" && !Number.isNaN(value)) this.#state.alpha = getAlpha(value);
 	}
 	/**
-	* Get the color as a hex color
+	* Get the color as a hex color string
+	*
+	* _Hex color string is returned with no `#`-prefix or alpha channel (opacity)_
+	*
+	* @returns Current color as a hex color string
 	*/
 	get hex() {
 		return this.#state.hex;
 	}
 	/**
-	* Set colors from a hex color
+	* Set the color from a hex color string
+	*
+	* - `#`-prefix is optional
+	* - Alpha channel _(opacity)_ will be ignored
+	*
+	* @param value New hex color string
 	*/
 	set hex(value) {
 		setHexColor(this.#state, value, false);
 	}
 	/**
-	* Get the color as a hex color with an alpha channel
+	* Get the color as a hex color with an alpha channel _(opacity)_
+	*
+	* _Hex color string is returned with alpha channel (opacity), but without `#`-prefix_
+	*
+	* @returns Current color as a hex color string
 	*/
 	get hexa() {
 		return `${this.#state.hex}${this.#state.alpha.hex}`;
 	}
 	/**
-	* Set colors and alpha from a hex color with an alpha channel
+	* Set the color from a hex color string with an alpha channel _(opacity)_
+	*
+	* - `#`-prefix is optional
+	* - Alpha channel _(opacity)_ will be respected
+	*
+	* @param value New hex color string
 	*/
 	set hexa(value) {
 		setHexColor(this.#state, value, true);
 	}
 	/**
-	* Get the color as an HSL color
+	* Get the color as an _HSL_ color
+	*
+	* @returns Current color as an _HSL_ color
 	*/
 	get hsl() {
 		return this.#state.hsl;
 	}
 	/**
-	* Set colors from an HSL color
+	* Set colors from an _HSL_ color
+	*
+	* @param value New _HSL_ color
 	*/
 	set hsl(value) {
 		setHSLColor(this.#state, value, false);
 	}
 	/**
-	* Get the color as an HSLA color
+	* Get the color as an _HSLA_ color
+	*
+	* @returns Current color as an _HSLA_ color
 	*/
 	get hsla() {
 		return {
@@ -4467,25 +4760,33 @@ var Color = class {
 		};
 	}
 	/**
-	* Set colors and alpha from an HSLA color
+	* Set colors and alpha from an _HSLA_ color
+	*
+	* @param value New _HSLA_ color
 	*/
 	set hsla(value) {
 		setHSLColor(this.#state, value, true);
 	}
 	/**
-	* Get the color as an RGB color
+	* Get the color as an _RGB_ color
+	*
+	* @returns Current color as an _RGB_ color
 	*/
 	get rgb() {
 		return this.#state.rgb;
 	}
 	/**
-	* Set colors from an RGB color
+	* Set colors from an _RGB_ color
+	*
+	* @param value New _RGB_ color
 	*/
 	set rgb(value) {
 		setRGBColor(this.#state, value, false);
 	}
 	/**
-	* Get the color as an RGBA color
+	* Get the color as an _RGBA_ color
+	*
+	* @returns Current color as an _RGBA_ color
 	*/
 	get rgba() {
 		return {
@@ -4494,7 +4795,9 @@ var Color = class {
 		};
 	}
 	/**
-	* Set colors and alpha from an RGBA color
+	* Set colors and alpha from an _RGBA_ color
+	*
+	* @param value New _RGBA_ color
 	*/
 	set rgba(value) {
 		setRGBColor(this.#state, value, true);
@@ -4503,15 +4806,38 @@ var Color = class {
 		this.#state = getColorState(value);
 		Object.defineProperty(this, "$color", { value: true });
 	}
+	/**
+	* Get the color as a hex string
+	*
+	* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+	* @returns Hex color string
+	*/
 	toHexString(alpha) {
 		return `#${alpha === true ? this.hexa : this.hex}`;
 	}
+	/**
+	* Get the color as an _HSL(A)_ string
+	*
+	* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+	* @returns _HSL(A)_ color string
+	*/
 	toHslString(alpha) {
 		return formatColor("hsl", this, alpha === true);
 	}
+	/**
+	* Get the color as an _RGB(A)_ string
+	*
+	* @param alpha Include alpha channel _(opacity)_? _(defaults to `false`)_
+	* @returns _RGB(A)_ color string
+	*/
 	toRgbString(alpha) {
 		return formatColor("rgb", this, alpha === true);
 	}
+	/**
+	* Get the color as a hex color string
+	*
+	* @returns Hex color string
+	*/
 	toString() {
 		return this.toHexString();
 	}
@@ -4519,9 +4845,13 @@ var Color = class {
 //#endregion
 //#region src/color/index.ts
 /**
-* Get a Color from any kind of value
+* Get a _Color_ from any kind of value
+*
+* - Values that can be parsed are: hex(a) color strings, _HSL(A)_ color objects, and _RGB(A)_ color objects
+* - If the value is unable to be parsed, a black _Color_ will be returned
+*
 * @param value Original value
-* @returns Color instance
+* @returns _Color_ instance
 */
 function getColor(value) {
 	return isColor(value) ? value : new Color(value);
@@ -4595,18 +4925,19 @@ var Logger = class {
 		return enabled ? console.warn : noop;
 	}
 	/**
-	* Start a logged timer with a label
-	* @param label Label for the timer
-	* @returns Time instance
+	* Start a timed logger with a label
+	*
+	* @param label Label for the logger
+	* @returns _Timed_ instance
 	*/
 	time(label) {
-		return new Time(label);
+		return new Timed(label);
 	}
 };
 /**
 * A named timer that can be used to log durations to the console
 */
-var Time = class {
+var Timed = class {
 	#logger;
 	#stopper;
 	#state;
@@ -4658,9 +4989,10 @@ function average(array, key) {
 }
 /**
 * Round a number up
+*
 * @param value Number to round up
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function ceil(value, decimals) {
 	return roundNumber(Math.ceil, value, decimals);
@@ -4679,9 +5011,10 @@ function count(array, key, value) {
 }
 /**
 * Round a number down
+*
 * @param value Number to round down
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function floor(value, decimals) {
 	return roundNumber(Math.floor, value, decimals);
@@ -4707,9 +5040,10 @@ function min(array, key) {
 }
 /**
 * Round a number
+*
 * @param value Number to round
 * @param decimals Number of decimal places to round to _(defaults to `0`)_
-* @returns Rounded number, or `NaN` if the value if unable to be rounded
+* @returns Rounded number, or `Number.NaN` if the value if unable to be rounded
 */
 function round(value, decimals) {
 	return roundNumber(Math.round, value, decimals);
@@ -4726,7 +5060,7 @@ function sum(array, key) {
 //#endregion
 //#region src/promise/models.ts
 /**
-* A promise that can be canceled
+* A _Promise_ that can be canceled
 */
 var CancelablePromise = class extends Promise {
 	#rejector;
@@ -4739,8 +5073,9 @@ var CancelablePromise = class extends Promise {
 		this.#rejector = rejector;
 	}
 	/**
-	* Cancel the promise, rejecting it with an optional reason
-	* @param reason Optional reason for canceling the promise
+	* Cancel the _Promise_, rejecting it with an optional reason
+	*
+	* @param reason Optional reason for canceling the _Promise_
 	*/
 	cancel(reason) {
 		this.#rejector(reason);
@@ -4799,17 +5134,19 @@ function getStrategyOrDefault(value) {
 	return PROMISE_STRATEGY_ALL.has(value) ? value : PROMISE_STRATEGY_DEFAULT;
 }
 /**
-* Is the value a fulfilled promise result?
+* Is the value a fulfilled _Promise_ result?
+*
 * @param value Value to check
-* @returns `true` if the value is a fulfilled promise result, `false` otherwise
+* @returns `true` if the value is a fulfilled _Promise_ result, `false` otherwise
 */
 function isFulfilled(value) {
 	return isType(value, PROMISE_TYPE_FULFILLED);
 }
 /**
-* Is the value a rejected promise result?
+* Is the value a rejected _Promise_ result?
+*
 * @param value Value to check
-* @returns `true` if the value is a rejected promise result, `false` otherwise
+* @returns `true` if the value is a rejected _Promise_ result, `false` otherwise
 */
 function isRejected(value) {
 	return isType(value, PROMISE_TYPE_REJECTED);
@@ -4820,9 +5157,10 @@ function isType(value, type) {
 //#endregion
 //#region src/promise/misc.ts
 /**
-* Create a cancelable promise
-* @param executor Executor function for the promise
-* @returns Cancelable promise
+* Create a cancelable _Promise_
+*
+* @param executor Executor function for the _Promise_
+* @returns Cancelable _Promise_
 */
 function cancelable(executor) {
 	return new CancelablePromise(executor);
@@ -4978,6 +5316,7 @@ async function resultPromises(items, signal) {
 //#region src/query.ts
 /**
 * Convert a query string to a plain _(nested)_ object
+*
 * @param query Query string to convert
 * @returns Plain object representation of the query string
 */
@@ -5029,6 +5368,7 @@ function setQueryValue(parameters, key, value) {
 }
 /**
 * Convert a plain _(nested)_ object to a query string
+*
 * @param parameters Plain object to convert
 * @returns Query string representation of the object
 */
@@ -5056,7 +5396,7 @@ var KeyedQueue = class {
 	#options;
 	#queues = /* @__PURE__ */ new Map();
 	/**
-	* Is any queue active?
+	* Get keys of all active queues
 	*/
 	get active() {
 		return this.#getStatus(STATUS_ACTIVE);
@@ -5074,13 +5414,13 @@ var KeyedQueue = class {
 		return this.#options.concurrency;
 	}
 	/**
-	* Are all queues empty?
+	* Get keys of all empty queues
 	*/
 	get empty() {
 		return this.#getStatus(STATUS_EMPTY);
 	}
 	/**
-	* Are all queues full?
+	* Get keys of all full queues
 	*/
 	get full() {
 		return this.#getStatus(STATUS_FULL);
@@ -5124,6 +5464,7 @@ var KeyedQueue = class {
 	}
 	/**
 	* Queue an item for a specific key
+	*
 	* @param key Key to queue the item for
 	* @param parameters Parameters to use when item runs
 	* @param signal Optional signal to abort the item
@@ -5134,6 +5475,7 @@ var KeyedQueue = class {
 	}
 	/**
 	* Clear all items for a specific key _(or all items for all keys, if no key is provided)_
+	*
 	* @param key Optional key to clear the queue for
 	*/
 	clear(key) {
@@ -5141,6 +5483,7 @@ var KeyedQueue = class {
 	}
 	/**
 	* Get the queue for a specific key
+	*
 	* @param key Key to get the queue for
 	* @returns Queue for the key, or `undefined` if it doesn't exist
 	*/
@@ -5149,6 +5492,7 @@ var KeyedQueue = class {
 	}
 	/**
 	* Pause the queue for a specific key _(or all queues, if no key is provided)_
+	*
 	* @param key Optional key to pause the queue for
 	*/
 	pause(key) {
@@ -5171,6 +5515,7 @@ var KeyedQueue = class {
 	}
 	/**
 	* Resume the queue for a specific key _(or all queues, if no key is provided)_
+	*
 	* @param key Optional key to resume the queue for
 	*/
 	resume(key) {
@@ -5268,6 +5613,7 @@ var Queue = class {
 	}
 	/**
 	* Add an item to the queue
+	*
 	* @param parameters Parameters to use when item runs
 	* @param signal Optional signal to abort the item
 	* @returns Queued item
@@ -5324,6 +5670,7 @@ var Queue = class {
 	}
 	/**
 	* Remove and reject a specific item in the queue
+	*
 	* @param id ID of queued item
 	*/
 	remove(id) {
@@ -5437,6 +5784,7 @@ const STATUS_PAUSED = "paused";
 //#region src/random.ts
 /**
 * Get a random boolean
+*
 * @returns Random boolean
 */
 function getRandomBoolean() {
@@ -5444,6 +5792,7 @@ function getRandomBoolean() {
 }
 /**
 * Get a random string of characters with a specified length
+*
 * @param length Length of random string
 * @param selection String of characters to select from _(defaults to lowercase English alphabet)_
 * @returns Random string of characters
@@ -5457,6 +5806,7 @@ function getRandomCharacters(length, selection) {
 }
 /**
 * Get a random hexadecimal color
+*
 * @param prefix Prefix the color with `#`? _(defaults to `false`)_
 * @returns Random hexadecimal color string in the format `(#)RRGGBB`
 */
@@ -5465,6 +5815,7 @@ function getRandomColor(prefix) {
 }
 /**
 * Get a random hexadecimal character
+*
 * @returns Random hexadecimal character from `0-9` and `A-F`
 */
 function getRandomHex() {
@@ -5472,6 +5823,7 @@ function getRandomHex() {
 }
 /**
 * Get a random item from an array
+*
 * @param array Array to get a random item from
 * @returns Random item from the array, or `undefined` if unable to retrieve one
 */
@@ -5578,17 +5930,17 @@ attemptPipe.async = attemptAsyncPipe;
 //#endregion
 //#region src/sized/set.ts
 /**
-* A Set with a maximum size
+* A _Set_ with a maximum size
 *
-* Behavior 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 {
 	/**
-	* The maximum size of the Set
+	* The maximum size of the _Set_
 	*/
 	#maximumSize;
 	/**
-	* Is the Set full?
+	* Is the _Set_ full?
 	*/
 	get full() {
 		return this.size >= this.#maximumSize;
@@ -5615,9 +5967,10 @@ var SizedSet = class extends Set {
 		return super.add(value);
 	}
 	/**
-	* 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`)_
+	* Get a value from the _SizedSet_, if it exists _(and optionally 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 Found value if it exists, otherwise `undefined`
 	*/
 	get(value, update) {
@@ -5631,4 +5984,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, 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 };
+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, copy, count, debounce, deburr, dedent, delay, deregisterCloner, deregisterComparator, deregisterEqualizer, diff, difference, drop, endsWith, endsWithArray, equal, error, exclude, exists, filter, find, findLast, first, firstOrDefault, flatFreeze, flatten, floor, flow, freeze, fromQuery, toPromise as fromResult, toPromise, fuzzy, fuzzyMatch, getArray, getArrayComparison, getColor, getError, getForegroundColor, getHexColor, getHexaColor, getHslColor, getHslaColor, getNormalizedHex, getNumber, getRandomBoolean, getRandomCharacters, getRandomColor, getRandomFloatingNumber as getRandomFloat, getRandomHex, getRandomInteger, getRandomItem, getRandomItems, getRgbColor, getRgbaColor, getSortedIndex, getString, getTimedPromise, getUuid, getValue, groupArraysBy, groupBy, handleResult, hasValue, hasValueResult, herald, hexToHsl, hexToHsla, hexToRgb, hexToRgba, hslToHex, hslToRgb, hslToRgba, ignoreKey, inMap, inSet, includes, includesArray, indexOf, indexOfArray, initializeAssigner, initializeEqualizer, initializeMerger, initializeNormalizer, initializeSorter, initializeTemplater, initializeTransformer, insert, interpolate, intersection, isArrayOrPlainObject, isColor, isConstructor, isEmpty, isError, isFrozen, 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, 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 };