@oscarpalmer/atoms 0.187.2 → 0.188.1

package/dist/function/retry.mjs

@@ -5,6 +5,7 @@ import { TIMER_WAIT, getTimer } from "../internal/function/timer.mjs";
 * An error thrown when a retry fails
 */
 var RetryError = class extends Error {
+	original;
 	constructor(message, original) {
 		super(message);
 		this.original = original;

package/dist/index.d.mts

@@ -5137,6 +5137,13 @@ declare function dedent(strings: TemplateStringsArray, ...values: unknown[]): st
  * @returns Dedented string
  */
 declare function dedent(value: string): string;
+/**
+ * Get a new UUID string _(version 4)_ for use in _HTML_
+ *
+ * @param html Use _HTML_-friendly format
+ * @returns UUID string
+ */
+declare function getUuid(html: true): string;
 /**
  * Get a new UUID string _(version 4)_
  *
@@ -6589,12 +6596,7 @@ declare function isNumerical(value: unknown): value is number | `${number}`;
 declare function isObject(value: unknown): value is object;
 //#endregion
 //#region src/logger.d.ts
-/**
- * A logger that can be used to log messages to the console
- *
- * _(Logging can be enabled or disabled by setting the `enabled` property)_
- */
-declare class Logger {
+type LoggerInstance = {
   /**
    * Log any number of values at the "debug" log level
    */
@@ -6639,14 +6641,14 @@ declare class Logger {
    * Start a timed logger with a label
    *
    * @param label Label for the logger
-   * @returns _Timed_ instance
+   * @returns _TimedLogger_ instance
    */
-  time(label: string): Timed;
-}
+  time(label: string): TimedLogger;
+};
 /**
  * A named timer that can be used to log durations to the console
  */
-declare class Timed {
+declare class TimedLogger {
   #private;
   /**
    * Is the timer active? _(i.e. has it been started and not stopped, and is logging enabled?)_
@@ -6664,7 +6666,12 @@ declare class Timed {
   get stop(): () => void;
   constructor(label: string);
 }
-declare const logger: Logger;
+/**
+ * A logger that can be used to log messages to the console
+ *
+ * _(Logging can be enabled or disabled by setting the `enabled` property)_
+ */
+declare const Logger: LoggerInstance;
 //#endregion
 //#region src/internal/math/aggregate.d.ts
 /**
@@ -8179,4 +8186,4 @@ declare class SizedSet<Value = unknown> extends Set<Value> {
   get(value: Value, update?: boolean): Value | undefined;
 }
 //#endregion
-export { AnyResult, ArrayComparison, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayValueSorter, AssertProperty, Asserter, AssignOptions, Assigner, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, type Events, ExtendedErr, ExtendedResult, Flow, FlowPromise, Frozen, FulfilledPromise, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, type Herald, Key$1 as Key, type KeyedQueue, KeyedValue, type Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NormalizeOptions, Normalizer, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, 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, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, type QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, type Shaken, Simplify, SizedMap, SizedSet, type Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type Timed, ToString, Transformer, TypedArray, UnionToIntersection, type Unsmushed, Unsubscriber, UnwrapValue, 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 };
+export { AnyResult, ArrayComparison, ArrayComparisonSorter, ArrayKeySorter, ArrayOrPlainObject, ArrayValueSorter, AssertProperty, Asserter, AssignOptions, Assigner, AsyncCancelableCallback, AttemptFlow, AttemptFlowPromise, type Beacon, type BeaconOptions, BuiltIns, CancelableCallback, CancelablePromise, type Color, Constructor, DiffOptions, DiffResult, DiffValue, EqualOptions, Err, EventPosition, type Events, ExtendedErr, ExtendedResult, Flow, FlowPromise, Frozen, FulfilledPromise, FuzzyConfiguration, FuzzyOptions, FuzzyResult, FuzzySearchOptions, GenericAsyncCallback, GenericCallback, type HSLAColor, type HSLColor, type Herald, Key$1 as Key, type KeyedQueue, KeyedValue, Logger, type Memoized, type MemoizedOptions, MergeOptions, Merger, NestedArray, NestedKeys, NestedPartial, NestedValue, NestedValues, NormalizeOptions, Normalizer, NumericalKeys, NumericalValues, type Observable, type Observer, Ok, OnceAsyncCallback, OnceCallback, 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, PlainObject, Primitive, PromiseData, PromiseHandlers, PromiseOptions, PromiseParameters, PromiseStrategy, PromiseTimeoutError, PromisesItems, PromisesOptions, PromisesResult, PromisesUnwrapped, PromisesValue, PromisesValues, type Queue, type QueueError, type QueueOptions, type Queued, type QueuedResult, type RGBAColor, type RGBColor, RejectedPromise, RequiredKeys, Result, ResultMatch, RetryError, RetryOptions, SORT_DIRECTION_ASCENDING, SORT_DIRECTION_DESCENDING, type Shaken, Simplify, SizedMap, SizedSet, type Smushed, SortDirection, Sorter, type Subscription, TemplateOptions, type TimedLogger, ToString, Transformer, TypedArray, UnionToIntersection, type Unsmushed, Unsubscriber, UnwrapValue, 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, 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 };

package/dist/index.mjs

@@ -3059,19 +3059,24 @@ function dedent(value, ...values) {
 *
 * @returns UUID string
 */
-function getUuid() {
-	const bytes = new Uint8Array(16);
-	crypto.getRandomValues(bytes);
-	bytes[6] = bytes[6] & 15 | 64;
-	bytes[8] = bytes[8] & 63 | 128;
-	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, ZERO)).join("");
-	return [
-		hex.substring(0, 8),
-		hex.substring(8, 12),
-		hex.substring(12, 16),
-		hex.substring(16, 20),
-		hex.substring(20, 32)
-	].join("-");
+function getUuid(html) {
+	const forHTML = html === true;
+	while (true) {
+		const bytes = new Uint8Array(16);
+		crypto.getRandomValues(bytes);
+		bytes[6] = bytes[6] & 15 | 64;
+		bytes[8] = bytes[8] & 63 | 128;
+		const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, ZERO)).join("");
+		const first = hex.substring(0, 8);
+		if (forHTML && NUMERICAL_PREFIX_PATTERN.test(first)) continue;
+		return [
+			first,
+			hex.substring(8, 12),
+			hex.substring(12, 16),
+			hex.substring(16, 20),
+			hex.substring(20, 32)
+		].join(forHTML ? DELIMITER_UUID_HTML : DELIMITER_UUID_DEFAULT);
+	}
 }
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
@@ -3113,6 +3118,9 @@ function truncate(value, length, suffix) {
 	const truncatedLength = length - actualSuffixLength;
 	return `${value.slice(0, truncatedLength)}${actualSuffix}`;
 }
+const DELIMITER_UUID_DEFAULT = "-";
+const DELIMITER_UUID_HTML = "_";
+const NUMERICAL_PREFIX_PATTERN = /^\d/;
 const ZERO = "0";
 //#endregion
 //#region src/string/normalize.ts
@@ -4859,85 +4867,9 @@ 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
-	*/
-	get debug() {
-		return enabled ? console.debug : noop;
-	}
-	/**
-	* Log the value and shows all its properties
-	*/
-	get dir() {
-		return enabled ? console.dir : noop;
-	}
-	/**
-	* Is logging to the console enabled? _(defaults to `true`)_
-	*/
-	get enabled() {
-		return enabled;
-	}
-	/**
-	* Enable or disable logging to the console
-	*/
-	set enabled(value) {
-		enabled = typeof value === "boolean" ? value : enabled;
-	}
-	/**
-	* Log any number of values at the "error" log level
-	*/
-	get error() {
-		return enabled ? console.error : noop;
-	}
-	/**
-	* Log any number of values at the "info" log level
-	*/
-	get info() {
-		return enabled ? console.info : noop;
-	}
-	/**
-	* Log any number of values at the "log" log level
-	*/
-	get log() {
-		return enabled ? console.log : noop;
-	}
-	/**
-	* Log data as a table, with optional properties to use as columns
-	*/
-	get table() {
-		return enabled ? console.table : noop;
-	}
-	/**
-	* Log any number of values together with a trace from where it was called
-	*/
-	get trace() {
-		return enabled ? console.trace : noop;
-	}
-	/**
-	* Log any number of values at the "warn" log level
-	*/
-	get warn() {
-		return enabled ? console.warn : noop;
-	}
-	/**
-	* Start a timed logger with a label
-	*
-	* @param label Label for the logger
-	* @returns _Timed_ instance
-	*/
-	time(label) {
-		return new Timed(label);
-	}
-};
-/**
 * A named timer that can be used to log durations to the console
 */
-var Timed = class {
+var TimedLogger = class {
 	#logger;
 	#stopper;
 	#state;
@@ -4979,7 +4911,41 @@ var Timed = class {
 		return stopper;
 	}
 };
-const logger = new Logger();
+const methods = [
+	"debug",
+	"dir",
+	"error",
+	"info",
+	"log",
+	"table",
+	"trace",
+	"warn"
+];
+/**
+* A logger that can be used to log messages to the console
+*
+* _(Logging can be enabled or disabled by setting the `enabled` property)_
+*/
+const Logger = (() => {
+	const instance = {};
+	Object.defineProperties(instance, {
+		enabled: {
+			get() {
+				return enabled;
+			},
+			set(value) {
+				enabled = typeof value === "boolean" ? value : enabled;
+			}
+		},
+		time: { value(label) {
+			return new TimedLogger(label);
+		} }
+	});
+	for (const method of methods) Object.defineProperty(instance, method, { get() {
+		return enabled ? console[method].bind(console) : noop;
+	} });
+	return Object.freeze(instance);
+})();
 let enabled = true;
 //#endregion
 //#region src/math.ts
@@ -5187,7 +5153,7 @@ function settlePromise(aborter, settler, value, signal) {
 }
 async function toResult(value) {
 	const actual = typeof value === "function" ? value() : value;
-	if (!(actual instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_RESULT));
+	if (!(actual instanceof Promise)) return Promise.reject(/* @__PURE__ */ new TypeError(PROMISE_MESSAGE_EXPECTATION_RESULT));
 	return actual.then((result) => ok(result)).catch((reason) => error(reason));
 }
 //#endregion
@@ -5235,7 +5201,7 @@ async function getTimedPromise(promise, time, signal) {
 	});
 }
 async function timed(promise, options) {
-	if (!(promise instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_TIMED));
+	if (!(promise instanceof Promise)) return Promise.reject(/* @__PURE__ */ new TypeError(PROMISE_MESSAGE_EXPECTATION_TIMED));
 	const { signal, time } = getPromiseOptions(options);
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	return time > 0 ? getTimedPromise(promise, time, signal) : promise;
@@ -5244,7 +5210,7 @@ async function timed(promise, options) {
 //#region src/promise/index.ts
 async function attemptPromise(value, options) {
 	const isFunction = typeof value === "function";
-	if (!isFunction && !(value instanceof Promise)) return Promise.reject(new TypeError(PROMISE_MESSAGE_EXPECTATION_ATTEMPT));
+	if (!isFunction && !(value instanceof Promise)) return Promise.reject(/* @__PURE__ */ new TypeError(PROMISE_MESSAGE_EXPECTATION_ATTEMPT));
 	const { signal, time } = getPromiseOptions(options);
 	if (signal?.aborted ?? false) return Promise.reject(signal.reason);
 	function abort() {
@@ -5992,4 +5958,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, 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 };
+export { CancelablePromise, Logger, 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, 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 };

package/dist/logger.d.mts

@@ -1,10 +1,5 @@
 //#region src/logger.d.ts
-/**
- * A logger that can be used to log messages to the console
- *
- * _(Logging can be enabled or disabled by setting the `enabled` property)_
- */
-declare class Logger {
+type LoggerInstance = {
   /**
    * Log any number of values at the "debug" log level
    */
@@ -49,14 +44,14 @@ declare class Logger {
    * Start a timed logger with a label
    *
    * @param label Label for the logger
-   * @returns _Timed_ instance
+   * @returns _TimedLogger_ instance
    */
-  time(label: string): Timed;
-}
+  time(label: string): TimedLogger;
+};
 /**
  * A named timer that can be used to log durations to the console
  */
-declare class Timed {
+declare class TimedLogger {
   #private;
   /**
    * Is the timer active? _(i.e. has it been started and not stopped, and is logging enabled?)_
@@ -74,6 +69,11 @@ declare class Timed {
   get stop(): () => void;
   constructor(label: string);
 }
-declare const logger: Logger;
+/**
+ * A logger that can be used to log messages to the console
+ *
+ * _(Logging can be enabled or disabled by setting the `enabled` property)_
+ */
+declare const Logger: LoggerInstance;
 //#endregion
-export { type Logger, type Timed, logger };
+export { Logger, type TimedLogger };

package/dist/logger.mjs

@@ -1,85 +1,9 @@
 import { noop } from "./internal/function/misc.mjs";
 //#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
-	*/
-	get debug() {
-		return enabled ? console.debug : noop;
-	}
-	/**
-	* Log the value and shows all its properties
-	*/
-	get dir() {
-		return enabled ? console.dir : noop;
-	}
-	/**
-	* Is logging to the console enabled? _(defaults to `true`)_
-	*/
-	get enabled() {
-		return enabled;
-	}
-	/**
-	* Enable or disable logging to the console
-	*/
-	set enabled(value) {
-		enabled = typeof value === "boolean" ? value : enabled;
-	}
-	/**
-	* Log any number of values at the "error" log level
-	*/
-	get error() {
-		return enabled ? console.error : noop;
-	}
-	/**
-	* Log any number of values at the "info" log level
-	*/
-	get info() {
-		return enabled ? console.info : noop;
-	}
-	/**
-	* Log any number of values at the "log" log level
-	*/
-	get log() {
-		return enabled ? console.log : noop;
-	}
-	/**
-	* Log data as a table, with optional properties to use as columns
-	*/
-	get table() {
-		return enabled ? console.table : noop;
-	}
-	/**
-	* Log any number of values together with a trace from where it was called
-	*/
-	get trace() {
-		return enabled ? console.trace : noop;
-	}
-	/**
-	* Log any number of values at the "warn" log level
-	*/
-	get warn() {
-		return enabled ? console.warn : noop;
-	}
-	/**
-	* Start a timed logger with a label
-	*
-	* @param label Label for the logger
-	* @returns _Timed_ instance
-	*/
-	time(label) {
-		return new Timed(label);
-	}
-};
-/**
 * A named timer that can be used to log durations to the console
 */
-var Timed = class {
+var TimedLogger = class {
 	#logger;
 	#stopper;
 	#state;
@@ -121,7 +45,41 @@ var Timed = class {
 		return stopper;
 	}
 };
-const logger = new Logger();
+const methods = [
+	"debug",
+	"dir",
+	"error",
+	"info",
+	"log",
+	"table",
+	"trace",
+	"warn"
+];
+/**
+* A logger that can be used to log messages to the console
+*
+* _(Logging can be enabled or disabled by setting the `enabled` property)_
+*/
+const Logger = (() => {
+	const instance = {};
+	Object.defineProperties(instance, {
+		enabled: {
+			get() {
+				return enabled;
+			},
+			set(value) {
+				enabled = typeof value === "boolean" ? value : enabled;
+			}
+		},
+		time: { value(label) {
+			return new TimedLogger(label);
+		} }
+	});
+	for (const method of methods) Object.defineProperty(instance, method, { get() {
+		return enabled ? console[method].bind(console) : noop;
+	} });
+	return Object.freeze(instance);
+})();
 let enabled = true;
 //#endregion
-export { logger };
+export { Logger };

package/dist/string/index.d.mts

@@ -14,6 +14,13 @@ declare function dedent(strings: TemplateStringsArray, ...values: unknown[]): st
  * @returns Dedented string
  */
 declare function dedent(value: string): string;
+/**
+ * Get a new UUID string _(version 4)_ for use in _HTML_
+ *
+ * @param html Use _HTML_-friendly format
+ * @returns UUID string
+ */
+declare function getUuid(html: true): string;
 /**
  * Get a new UUID string _(version 4)_
  *

package/dist/string/index.mjs

@@ -30,19 +30,24 @@ function dedent(value, ...values) {
 *
 * @returns UUID string
 */
-function getUuid() {
-	const bytes = new Uint8Array(16);
-	crypto.getRandomValues(bytes);
-	bytes[6] = bytes[6] & 15 | 64;
-	bytes[8] = bytes[8] & 63 | 128;
-	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, ZERO)).join("");
-	return [
-		hex.substring(0, 8),
-		hex.substring(8, 12),
-		hex.substring(12, 16),
-		hex.substring(16, 20),
-		hex.substring(20, 32)
-	].join("-");
+function getUuid(html) {
+	const forHTML = html === true;
+	while (true) {
+		const bytes = new Uint8Array(16);
+		crypto.getRandomValues(bytes);
+		bytes[6] = bytes[6] & 15 | 64;
+		bytes[8] = bytes[8] & 63 | 128;
+		const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, ZERO)).join("");
+		const first = hex.substring(0, 8);
+		if (forHTML && NUMERICAL_PREFIX_PATTERN.test(first)) continue;
+		return [
+			first,
+			hex.substring(8, 12),
+			hex.substring(12, 16),
+			hex.substring(16, 20),
+			hex.substring(20, 32)
+		].join(forHTML ? DELIMITER_UUID_HTML : DELIMITER_UUID_DEFAULT);
+	}
 }
 /**
 * Parse a JSON string into its proper value _(or `undefined` if it fails)_
@@ -84,6 +89,9 @@ function truncate(value, length, suffix) {
 	const truncatedLength = length - actualSuffixLength;
 	return `${value.slice(0, truncatedLength)}${actualSuffix}`;
 }
+const DELIMITER_UUID_DEFAULT = "-";
+const DELIMITER_UUID_HTML = "_";
+const NUMERICAL_PREFIX_PATTERN = /^\d/;
 const ZERO = "0";
 //#endregion
 export { dedent, getString, getUuid, join, parse, trim, truncate, words };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oscarpalmer/atoms",
-	"version": "0.187.2",
+	"version": "0.188.1",
 	"description": "Atomic utilities for making your JavaScript better.",
 	"keywords": [
 		"helper",
@@ -257,7 +257,7 @@
 		"watch": "npx vite build --watch"
 	},
 	"devDependencies": {
-		"@oxlint/plugins": "^1.67",
+		"@oxlint/plugins": "^1.69",
 		"@types/node": "^25.9",
 		"@vitest/coverage-istanbul": "^4.1",
 		"eslint": "^10.4",

package/src/logger.ts

@@ -2,97 +2,70 @@ import {noop} from './internal/function/misc';
 
 // #region Types
 
-/**
- * A logger that can be used to log messages to the console
- *
- * _(Logging can be enabled or disabled by setting the `enabled` property)_
- */
-class Logger {
+type LoggerInstance = {
 	/**
 	 * Log any number of values at the "debug" log level
 	 */
-	get debug(): typeof console.debug {
-		return enabled ? console.debug : noop;
-	}
+	get debug(): typeof console.debug;
 
 	/**
 	 * Log the value and shows all its properties
 	 */
-	get dir(): typeof console.dir {
-		return enabled ? console.dir : noop;
-	}
+	get dir(): typeof console.dir;
 
 	/**
 	 * Is logging to the console enabled? _(defaults to `true`)_
 	 */
-	get enabled(): boolean {
-		return enabled;
-	}
+	get enabled(): boolean;
 
 	/**
 	 * Enable or disable logging to the console
 	 */
-	set enabled(value: boolean) {
-		enabled = typeof value === 'boolean' ? value : enabled;
-	}
+	set enabled(value: boolean);
 
 	/**
 	 * Log any number of values at the "error" log level
 	 */
-	get error(): typeof console.error {
-		return enabled ? console.error : noop;
-	}
+	get error(): typeof console.error;
 
 	/**
 	 * Log any number of values at the "info" log level
 	 */
-	get info(): typeof console.info {
-		return enabled ? console.info : noop;
-	}
+	get info(): typeof console.info;
 
 	/**
 	 * Log any number of values at the "log" log level
 	 */
-	get log(): typeof console.log {
-		return enabled ? console.log : noop;
-	}
+	get log(): typeof console.log;
 
 	/**
 	 * Log data as a table, with optional properties to use as columns
 	 */
-	get table(): typeof console.table {
-		return enabled ? console.table : noop;
-	}
+	get table(): typeof console.table;
 
 	/**
 	 * Log any number of values together with a trace from where it was called
 	 */
-	get trace(): typeof console.trace {
-		return enabled ? console.trace : noop;
-	}
+	get trace(): typeof console.trace;
 
 	/**
 	 * Log any number of values at the "warn" log level
 	 */
-	get warn(): typeof console.warn {
-		return enabled ? console.warn : noop;
-	}
+	get warn(): typeof console.warn;
 
 	/**
 	 * Start a timed logger with a label
 	 *
 	 * @param label Label for the logger
-	 * @returns _Timed_ instance
+	 * @returns _TimedLogger_ instance
 	 */
-	time(label: string): Timed {
-		return new Timed(label);
-	}
-}
+	time(label: string): TimedLogger;
+};
 
 /**
  * A named timer that can be used to log durations to the console
  */
-class Timed {
+class TimedLogger {
 	#logger: typeof console.timeLog | undefined;
 	#stopper: typeof console.timeEnd | undefined;
 
@@ -158,7 +131,42 @@ type TimeState = {
 
 // #region Variables
 
-const logger = new Logger();
+const methods = ['debug', 'dir', 'error', 'info', 'log', 'table', 'trace', 'warn'] as const;
+
+/**
+ * A logger that can be used to log messages to the console
+ *
+ * _(Logging can be enabled or disabled by setting the `enabled` property)_
+ */
+const Logger = (() => {
+	const instance = {};
+
+	Object.defineProperties(instance, {
+		enabled: {
+			get() {
+				return enabled;
+			},
+			set(value: boolean) {
+				enabled = typeof value === 'boolean' ? value : enabled;
+			},
+		},
+		time: {
+			value(label: string) {
+				return new TimedLogger(label);
+			},
+		},
+	});
+
+	for (const method of methods) {
+		Object.defineProperty(instance, method, {
+			get() {
+				return enabled ? console[method].bind(console) : noop;
+			},
+		});
+	}
+
+	return Object.freeze(instance);
+})() as LoggerInstance;
 
 let enabled = true;
 
@@ -166,6 +174,6 @@ let enabled = true;
 
 // #region Exports
 
-export {logger, type Logger, type Timed};
+export {Logger, type TimedLogger};
 
 // #endregion

package/src/string/index.ts

@@ -69,29 +69,54 @@ export function dedent(value: string | TemplateStringsArray, ...values: unknown[
 	return result.trim();
 }
 
+/**
+ * Get a new UUID string _(version 4)_ for use in _HTML_
+ *
+ * @param html Use _HTML_-friendly format
+ * @returns UUID string
+ */
+export function getUuid(html: true): string;
+
 /**
  * Get a new UUID string _(version 4)_
  *
  * @returns UUID string
  */
-export function getUuid(): string {
-	const bytes = new Uint8Array(16);
+export function getUuid(): string;
 
-	crypto.getRandomValues(bytes);
+/**
+ * Get a new UUID string _(version 4)_
+ *
+ * @returns UUID string
+ */
+export function getUuid(html?: unknown): string {
+	const forHTML = html === true;
 
-	bytes[6] = (bytes[6] & 0x0f) | 0x40;
+	while (true) {
+		const bytes = new Uint8Array(16);
 
-	bytes[8] = (bytes[8] & 0x3f) | 0x80;
+		crypto.getRandomValues(bytes);
 
-	const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, ZERO)).join('');
+		bytes[6] = (bytes[6] & 0x0f) | 0x40;
 
-	return [
-		hex.substring(0, 8),
-		hex.substring(8, 12),
-		hex.substring(12, 16),
-		hex.substring(16, 20),
-		hex.substring(20, 32),
-	].join('-');
+		bytes[8] = (bytes[8] & 0x3f) | 0x80;
+
+		const hex = Array.from(bytes, byte => byte.toString(16).padStart(2, ZERO)).join('');
+
+		const first = hex.substring(0, 8);
+
+		if (forHTML && NUMERICAL_PREFIX_PATTERN.test(first)) {
+			continue;
+		}
+
+		return [
+			first,
+			hex.substring(8, 12),
+			hex.substring(12, 16),
+			hex.substring(16, 20),
+			hex.substring(20, 32),
+		].join(forHTML ? DELIMITER_UUID_HTML : DELIMITER_UUID_DEFAULT);
+	}
 }
 
 /**
@@ -155,6 +180,12 @@ export function truncate(value: string, length: number, suffix?: string): string
 
 // #region Variables
 
+const DELIMITER_UUID_DEFAULT = '-';
+
+const DELIMITER_UUID_HTML = '_';
+
+const NUMERICAL_PREFIX_PATTERN = /^\d/;
+
 const ZERO = '0';
 
 // #endregion