@optique/core 1.2.0-dev.2242 → 1.2.0-dev.2246

package/dist/valueparser.cjs

@@ -112,8 +112,8 @@ function choice(choices, options = {}) {
 					error: formatNumberChoiceError(input, numberChoices, numberChoices, numberInvalidChoice)
 				};
 			},
-			format(value) {
-				return Object.is(value, -0) ? "-0" : String(value);
+			format(value$1) {
+				return Object.is(value$1, -0) ? "-0" : String(value$1);
 			},
 			suggest(prefix) {
 				return numberStrings.filter((valueStr, i) => !Number.isNaN(numberChoices[i]) && valueStr.startsWith(prefix)).map((valueStr) => ({
@@ -142,9 +142,18 @@ function choice(choices, options = {}) {
 	const stringSuggest = stringOptions.suggest;
 	if (stringSuggest !== void 0) {
 		const isValidString = stringSuggest === "nearest" || stringSuggest === "never";
-		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null;
+		const isArray = Array.isArray(stringSuggest);
+		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null && !isArray;
 		const isValidFunction = typeof stringSuggest === "function";
-		if (!isValidString && !isValidObject && !isValidFunction) throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${typeof stringSuggest}: ${String(stringSuggest)}.`);
+		if (!isValidString && !isValidObject && !isValidFunction) {
+			const actualType = isArray ? "array" : stringSuggest === null ? "null" : typeof stringSuggest;
+			throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${actualType}: ${String(stringSuggest)}.`);
+		}
+		if (isValidObject) {
+			const obj = stringSuggest;
+			if (obj.maxDistance !== void 0 && (typeof obj.maxDistance !== "number" || !Number.isInteger(obj.maxDistance) || obj.maxDistance < 0)) throw new TypeError(`Expected suggest.maxDistance to be a non-negative integer, but got ${typeof obj.maxDistance}: ${String(obj.maxDistance)}.`);
+			if (obj.maxSuggestions !== void 0 && (typeof obj.maxSuggestions !== "number" || !Number.isInteger(obj.maxSuggestions) || obj.maxSuggestions < 1)) throw new TypeError(`Expected suggest.maxSuggestions to be a positive integer, but got ${typeof obj.maxSuggestions}: ${String(obj.maxSuggestions)}.`);
+		}
 	}
 	return {
 		mode: "sync",
@@ -163,17 +172,17 @@ function choice(choices, options = {}) {
 				value: stringChoices[index]
 			};
 		},
-		format(value) {
-			return String(value);
+		format(value$1) {
+			return String(value$1);
 		},
 		suggest(prefix) {
 			const normalizedPrefix = caseInsensitive ? prefix.toLowerCase() : prefix;
-			return stringChoices.filter((value) => {
-				const normalizedValue = caseInsensitive ? value.toLowerCase() : value;
+			return stringChoices.filter((value$1) => {
+				const normalizedValue = caseInsensitive ? value$1.toLowerCase() : value$1;
 				return normalizedValue.startsWith(normalizedPrefix);
-			}).map((value) => ({
+			}).map((value$1) => ({
 				kind: "literal",
-				text: value
+				text: value$1
 			}));
 		}
 	};
@@ -189,8 +198,8 @@ function choice(choices, options = {}) {
 * @since 1.0.0
 */
 function checkBooleanOption(options, key) {
-	const value = options?.[key];
-	if (value !== void 0 && typeof value !== "boolean") throw new TypeError(`Expected ${String(key)} to be a boolean, but got ${typeof value}: ${String(value)}.`);
+	const value$1 = options?.[key];
+	if (value$1 !== void 0 && typeof value$1 !== "boolean") throw new TypeError(`Expected ${String(key)} to be a boolean, but got ${typeof value$1}: ${String(value$1)}.`);
 }
 /**
 * Validates that an option value, if present, is one of the allowed values.
@@ -206,10 +215,10 @@ function checkBooleanOption(options, key) {
 * @since 1.0.0
 */
 function checkEnumOption(options, key, allowed) {
-	const value = options?.[key];
-	if (value !== void 0 && (typeof value !== "string" || !allowed.includes(value))) {
-		const rendered = typeof value === "string" ? JSON.stringify(value) : typeof value === "symbol" ? value.toString() : String(value);
-		throw new TypeError(`Expected ${String(key)} to be one of ${allowed.map((v) => JSON.stringify(v)).join(", ")}, but got ${typeof value}: ${rendered}.`);
+	const value$1 = options?.[key];
+	if (value$1 !== void 0 && (typeof value$1 !== "string" || !allowed.includes(value$1))) {
+		const rendered = typeof value$1 === "string" ? JSON.stringify(value$1) : typeof value$1 === "symbol" ? value$1.toString() : String(value$1);
+		throw new TypeError(`Expected ${String(key)} to be one of ${allowed.map((v) => JSON.stringify(v)).join(", ")}, but got ${typeof value$1}: ${rendered}.`);
 	}
 }
 /**
@@ -269,14 +278,20 @@ function formatStringChoiceError(input, choices, invalidChoice, suggest) {
 	if (suggest === "nearest") return require_suggestion.appendValueHint(base, input, choices);
 	if (typeof suggest === "function") {
 		const hints = suggest(input, choices);
-		if (!hints || hints.length === 0) return base;
-		const suggestionMsg = require_suggestion.createSuggestionMessage(hints);
-		return suggestionMsg.length > 0 ? [
+		if (!Array.isArray(hints) || hints.length === 0) return base;
+		let suggestionMsg;
+		if (hints.length === 1) suggestionMsg = require_message.message`Did you mean ${require_message.value(hints[0])}?`;
+		else {
+			const parts = [require_message.text("Did you mean one of these?")];
+			for (const hint of hints) parts.push(require_message.text("\n  "), require_message.value(hint));
+			suggestionMsg = parts;
+		}
+		return [
 			...base,
 			require_message.lineBreak(),
 			require_message.lineBreak(),
 			...suggestionMsg
-		] : base;
+		];
 	}
 	return require_suggestion.appendValueHint(base, input, choices, suggest);
 }
@@ -342,8 +357,8 @@ function string(options = {}) {
 				value: input
 			};
 		},
-		format(value) {
-			return value;
+		format(value$1) {
+			return value$1;
 		}
 	};
 }
@@ -395,12 +410,12 @@ function keyValue(options = {}) {
 		if (custom != null) return typeof custom === "function" ? custom(error) : custom;
 		return [require_message.text("Invalid value: "), ...require_message.cloneMessage(error)];
 	}
-	function validateParts(input, key, value) {
+	function validateParts(input, key, value$1) {
 		if (!allowEmptyKey && key === "") return {
 			success: false,
 			error: emptyKeyError(input)
 		};
-		if (!allowEmptyValue && value === "") return {
+		if (!allowEmptyValue && value$1 === "") return {
 			success: false,
 			error: emptyValueError(input)
 		};
@@ -409,7 +424,7 @@ function keyValue(options = {}) {
 			success: false,
 			error: invalidKeyError(keyResult.error)
 		};
-		const valueResult = valueParser.parse(value);
+		const valueResult = valueParser.parse(value$1);
 		if (!valueResult.success) return {
 			success: false,
 			error: invalidValueError(valueResult.error)
@@ -431,14 +446,14 @@ function keyValue(options = {}) {
 		if (!allowEmptyKey && key === "") return false;
 		return partsRoundTrip(key, "");
 	}
-	function fallbackInput(key, value) {
-		return `${typeof key === "string" ? key : ""}${separator}${typeof value === "string" ? value : ""}`;
+	function fallbackInput(key, value$1) {
+		return `${typeof key === "string" ? key : ""}${separator}${typeof value$1 === "string" ? value$1 : ""}`;
 	}
-	function partsRoundTrip(key, value) {
-		const input = `${key}${separator}${value}`;
+	function partsRoundTrip(key, value$1) {
+		const input = `${key}${separator}${value$1}`;
 		const index = findSeparator(input);
 		if (index < 0) return false;
-		return input.slice(0, index) === key && input.slice(index + separator.length) === value;
+		return input.slice(0, index) === key && input.slice(index + separator.length) === value$1;
 	}
 	function validateResultParts(input, keyResult, valueResult) {
 		if (!allowEmptyKey && keyResult.value === "") return {
@@ -488,26 +503,26 @@ function keyValue(options = {}) {
 		}
 		return makeKeyValueSuccess(keyResult, valueResult);
 	}
-	function validateTuple(value) {
-		if (!allowEmptyKey && value[0] === "") return {
+	function validateTuple(value$1) {
+		if (!allowEmptyKey && value$1[0] === "") return {
 			success: false,
-			error: emptyKeyError(fallbackInput(value[0], value[1]))
+			error: emptyKeyError(fallbackInput(value$1[0], value$1[1]))
 		};
-		if (!allowEmptyValue && value[1] === "") return {
+		if (!allowEmptyValue && value$1[1] === "") return {
 			success: false,
-			error: emptyValueError(fallbackInput(value[0], value[1]))
+			error: emptyValueError(fallbackInput(value$1[0], value$1[1]))
 		};
-		const keyResult = validateValueParserValue(keyParser, value[0]);
+		const keyResult = validateValueParserValue(keyParser, value$1[0]);
 		if (!keyResult.success) return {
 			success: false,
 			error: invalidKeyError(keyResult.error)
 		};
-		const valueResult = validateValueParserValue(valueParser, value[1]);
+		const valueResult = validateValueParserValue(valueParser, value$1[1]);
 		if (!valueResult.success) return {
 			success: false,
 			error: invalidValueError(valueResult.error)
 		};
-		return validateResultParts(fallbackInput(value[0], value[1]), keyResult, valueResult);
+		return validateResultParts(fallbackInput(value$1[0], value$1[1]), keyResult, valueResult);
 	}
 	return {
 		mode: "sync",
@@ -520,23 +535,23 @@ function keyValue(options = {}) {
 				error: missingSeparatorError(input)
 			};
 			const key = input.slice(0, index);
-			const value = input.slice(index + separator.length);
-			return validateParts(input, key, value);
+			const value$1 = input.slice(index + separator.length);
+			return validateParts(input, key, value$1);
 		},
-		format(value) {
-			return `${keyParser.format(value[0])}${separator}${valueParser.format(value[1])}`;
+		format(value$1) {
+			return `${keyParser.format(value$1[0])}${separator}${valueParser.format(value$1[1])}`;
 		},
-		validate(value) {
-			if (!isKeyValueTuple(value)) return {
+		validate(value$1) {
+			if (!isKeyValueTuple(value$1)) return {
 				success: false,
 				error: require_message.message`Expected a key-value tuple.`
 			};
-			return validateTuple(value);
+			return validateTuple(value$1);
 		},
-		...hasNormalize ? { normalize(value) {
-			if (!isKeyValueTuple(value)) return value;
-			const normalized = [typeof keyParser.normalize === "function" ? keyParser.normalize(value[0]) : value[0], typeof valueParser.normalize === "function" ? valueParser.normalize(value[1]) : value[1]];
-			return validateTuple(normalized).success ? normalized : value;
+		...hasNormalize ? { normalize(value$1) {
+			if (!isKeyValueTuple(value$1)) return value$1;
+			const normalized = [typeof keyParser.normalize === "function" ? keyParser.normalize(value$1[0]) : value$1[0], typeof valueParser.normalize === "function" ? valueParser.normalize(value$1[1]) : value$1[1]];
+			return validateTuple(normalized).success ? normalized : value$1;
 		} } : {},
 		...hasSuggest ? { *suggest(prefix) {
 			const index = findSeparator(prefix);
@@ -560,9 +575,9 @@ function keyValue(options = {}) {
 				}
 				const valuePrefix = prefix.slice(index + separator.length);
 				for (const suggestion of valueParser.suggest(valuePrefix)) {
-					const value = suggestionTextValue(suggestion);
-					if (!partsRoundTrip(key, value)) continue;
-					if (suggestion.kind === "literal" && !validateParts(`${key}${separator}${value}`, key, value).success) continue;
+					const value$1 = suggestionTextValue(suggestion);
+					if (!partsRoundTrip(key, value$1)) continue;
+					if (suggestion.kind === "literal" && !validateParts(`${key}${separator}${value$1}`, key, value$1).success) continue;
 					suggestions.push(prefixKeyValueSuggestion(suggestion, `${key}${separator}`));
 				}
 			}
@@ -575,15 +590,15 @@ function checkKeyValueChildParser(role, parser) {
 	if (parser.mode !== "sync") throw new TypeError(`keyValue() only supports sync ${role} parsers, but an async one was given.`);
 	if (require_internal_dependency.isDerivedValueParser(parser)) throw new TypeError(`keyValue() does not support dependency-derived ${role} parsers (created via deriveFrom() or dependency().derive()); pass the derived parser directly to option() or argument() instead.`);
 }
-function validateValueParserValue(parser, value) {
-	if (typeof parser.validate === "function") return parser.validate(value);
+function validateValueParserValue(parser, value$1) {
+	if (typeof parser.validate === "function") return parser.validate(value$1);
 	let formatted;
 	try {
-		formatted = parser.format(value);
+		formatted = parser.format(value$1);
 	} catch {
 		return {
 			success: true,
-			value
+			value: value$1
 		};
 	}
 	if (typeof formatted !== "string") return {
@@ -592,10 +607,10 @@ function validateValueParserValue(parser, value) {
 	};
 	return parser.parse(formatted);
 }
-function formatValueParserValue(parser, value) {
+function formatValueParserValue(parser, value$1) {
 	let formatted;
 	try {
-		formatted = parser.format(value);
+		formatted = parser.format(value$1);
 	} catch {
 		return {
 			success: true,
@@ -633,8 +648,8 @@ function prefixKeyValueSuggestion(suggestion, prefix, suffix = "") {
 		description: suggestion.description
 	};
 }
-function isKeyValueTuple(value) {
-	return Array.isArray(value) && value.length === 2 && 0 in value && 1 in value;
+function isKeyValueTuple(value$1) {
+	return Array.isArray(value$1) && value$1.length === 2 && 0 in value$1 && 1 in value$1;
 }
 function makeKeyValueSuccess(keyResult, valueResult) {
 	const deferredKeys = /* @__PURE__ */ new Map();
@@ -720,22 +735,22 @@ function integer(options) {
 					success: false,
 					error: options.errors?.invalidInteger ? typeof options.errors.invalidInteger === "function" ? options.errors.invalidInteger(input) : options.errors.invalidInteger : require_message.message`Expected a valid integer, but got ${input}.`
 				};
-				const value = BigInt(input);
-				if (options.min != null && value < options.min) return {
+				const value$1 = BigInt(input);
+				if (options.min != null && value$1 < options.min) return {
 					success: false,
-					error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
+					error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value$1, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
 				};
-				else if (options.max != null && value > options.max) return {
+				else if (options.max != null && value$1 > options.max) return {
 					success: false,
-					error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
+					error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value$1, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
 				};
 				return {
 					success: true,
-					value
+					value: value$1
 				};
 			},
-			format(value) {
-				return value.toString();
+			format(value$1) {
+				return value$1.toString();
 			}
 		};
 	}
@@ -771,22 +786,22 @@ function integer(options) {
 				return makeUnsafeIntegerError(input);
 			}
 			if (n > maxSafe || n < minSafe) return makeUnsafeIntegerError(input);
-			const value = Number(input);
-			if (options?.min != null && value < options.min) return {
+			const value$1 = Number(input);
+			if (options?.min != null && value$1 < options.min) return {
 				success: false,
-				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
+				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value$1, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
 			};
-			else if (options?.max != null && value > options.max) return {
+			else if (options?.max != null && value$1 > options.max) return {
 				success: false,
-				error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
+				error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value$1, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
 			};
 			return {
 				success: true,
-				value
+				value: value$1
 			};
 		},
-		format(value) {
-			return value.toString();
+		format(value$1) {
+			return value$1.toString();
 		}
 	};
 }
@@ -815,31 +830,31 @@ function float(options = {}) {
 				success: false,
 				error: options.errors?.invalidNumber ? typeof options.errors.invalidNumber === "function" ? options.errors.invalidNumber(i) : options.errors.invalidNumber : require_message.message`Expected a valid number, but got ${i}.`
 			});
-			let value;
+			let value$1;
 			const lowerInput = input.toLowerCase();
-			if (lowerInput === "nan" && options.allowNaN) value = NaN;
-			else if ((lowerInput === "infinity" || lowerInput === "+infinity") && options.allowInfinity) value = Infinity;
-			else if (lowerInput === "-infinity" && options.allowInfinity) value = -Infinity;
+			if (lowerInput === "nan" && options.allowNaN) value$1 = NaN;
+			else if ((lowerInput === "infinity" || lowerInput === "+infinity") && options.allowInfinity) value$1 = Infinity;
+			else if (lowerInput === "-infinity" && options.allowInfinity) value$1 = -Infinity;
 			else if (floatRegex.test(input)) {
-				value = Number(input);
-				if (!Number.isFinite(value) && !options.allowInfinity) return invalidNumber(input);
-				if (Number.isNaN(value)) return invalidNumber(input);
+				value$1 = Number(input);
+				if (!Number.isFinite(value$1) && !options.allowInfinity) return invalidNumber(input);
+				if (Number.isNaN(value$1)) return invalidNumber(input);
 			} else return invalidNumber(input);
-			if (options.min != null && value < options.min) return {
+			if (options.min != null && value$1 < options.min) return {
 				success: false,
-				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
+				error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value$1, options.min) : options.errors.belowMinimum : require_message.message`Expected a value greater than or equal to ${require_message.text(options.min.toLocaleString("en"))}, but got ${input}.`
 			};
-			else if (options.max != null && value > options.max) return {
+			else if (options.max != null && value$1 > options.max) return {
 				success: false,
-				error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
+				error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value$1, options.max) : options.errors.aboveMaximum : require_message.message`Expected a value less than or equal to ${require_message.text(options.max.toLocaleString("en"))}, but got ${input}.`
 			};
 			return {
 				success: true,
-				value
+				value: value$1
 			};
 		},
-		format(value) {
-			return value.toString();
+		format(value$1) {
+			return value$1.toString();
 		}
 	};
 }
@@ -976,17 +991,17 @@ const BIGINT_FORMAT_UNITS_SI_AS_BINARY = [
 * Formats a bigint byte count using the most readable unit.  Falls back to
 * `"${value}B"`.  Tries exact integers, then 1 and 2 decimal places.
 */
-function formatBigIntBytes(value, units) {
-	if (value === 0n) return "0B";
-	const absValue = value < 0n ? -value : value;
+function formatBigIntBytes(value$1, units) {
+	if (value$1 === 0n) return "0B";
+	const absValue = value$1 < 0n ? -value$1 : value$1;
 	for (const [unit, size] of units) {
 		if (absValue < size) continue;
-		if (value % size === 0n) {
-			const v = value / size;
+		if (value$1 % size === 0n) {
+			const v = value$1 / size;
 			const absV = v < 0n ? -v : v;
 			if (absV >= 1n && absV < 1000n) return `${v}${unit}`;
 		}
-		const v100 = value * 100n;
+		const v100 = value$1 * 100n;
 		if (v100 % size === 0n) {
 			const q = v100 / size;
 			const absQ = q < 0n ? -q : q;
@@ -998,7 +1013,7 @@ function formatBigIntBytes(value, units) {
 			}
 		}
 	}
-	return `${value}B`;
+	return `${value$1}B`;
 }
 /**
 * Core computation: parses `numStr` as a decimal rational, multiplies by
@@ -1128,10 +1143,10 @@ function fileSize(options = {}) {
 					value: bytes
 				};
 			},
-			format(value) {
+			format(value$1) {
 				const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
-				if (value >= -maxSafe && value <= maxSafe) return formatWithUnits(Number(value), numberFormatUnits);
-				return formatBigIntBytes(value, bigintFormatUnits);
+				if (value$1 >= -maxSafe && value$1 <= maxSafe) return formatWithUnits(Number(value$1), numberFormatUnits);
+				return formatBigIntBytes(value$1, bigintFormatUnits);
 			}
 		};
 	}
@@ -1169,8 +1184,8 @@ function fileSize(options = {}) {
 				value: bytes
 			};
 		},
-		format(value) {
-			return formatWithUnits(value, formatUnits);
+		format(value$1) {
+			return formatWithUnits(value$1, formatUnits);
 		}
 	};
 }
@@ -2262,8 +2277,8 @@ function color(options = {}) {
 			}
 			return invalidFormatError(input);
 		},
-		format(value) {
-			const { r, g, b, a } = value;
+		format(value$1) {
+			const { r, g, b, a } = value$1;
 			if (!Number.isInteger(r) || r < 0 || r > 255 || !Number.isInteger(g) || g < 0 || g > 255 || !Number.isInteger(b) || b < 0 || b > 255 || !Number.isFinite(a) || a < 0 || a > 1) throw new RangeError(`Color components out of range: r=${r}, g=${g}, b=${b}, a=${a}.`);
 			const aStr = parseFloat(a.toFixed(4));
 			if (allowHex) {
@@ -2285,11 +2300,11 @@ function color(options = {}) {
 			for (const [name, c] of Object.entries(CSS_NAMED_COLORS)) if (c.r === r && c.g === g && c.b === b && c.a === a) return name;
 			throw new RangeError(`No CSS named color matches { r: ${r}, g: ${g}, b: ${b}, a: ${a} }.`);
 		},
-		normalize(value) {
-			if (!Number.isInteger(value.r) || value.r < 0 || value.r > 255 || !Number.isInteger(value.g) || value.g < 0 || value.g > 255 || !Number.isInteger(value.b) || value.b < 0 || value.b > 255 || !Number.isFinite(value.a) || value.a < 0 || value.a > 1) return value;
-			const a = Math.round(value.a * 255) / 255;
-			return a === value.a ? value : {
-				...value,
+		normalize(value$1) {
+			if (!Number.isInteger(value$1.r) || value$1.r < 0 || value$1.r > 255 || !Number.isInteger(value$1.g) || value$1.g < 0 || value$1.g > 255 || !Number.isInteger(value$1.b) || value$1.b < 0 || value$1.b > 255 || !Number.isFinite(value$1.a) || value$1.a < 0 || value$1.a > 1) return value$1;
+			const a = Math.round(value$1.a * 255) / 255;
+			return a === value$1.a ? value$1 : {
+				...value$1,
 				a
 			};
 		},
@@ -2394,8 +2409,8 @@ function url(options = {}) {
 				value: url$1
 			};
 		},
-		format(value) {
-			return value.href;
+		format(value$1) {
+			return value$1.href;
 		},
 		*suggest(prefix) {
 			if (allowedProtocols && prefix.length > 0 && !prefix.includes(":")) for (const protocol of allowedProtocols) {
@@ -2444,8 +2459,8 @@ function locale(options = {}) {
 				value: locale$1
 			};
 		},
-		format(value) {
-			return value.toString();
+		format(value$1) {
+			return value$1.toString();
 		},
 		*suggest(prefix) {
 			const commonLocales = [
@@ -2774,8 +2789,8 @@ function uuid(options = {}) {
 				value: input
 			};
 		},
-		format(value) {
-			return value;
+		format(value$1) {
+			return value$1;
 		}
 	};
 }
@@ -2837,26 +2852,26 @@ function port(options) {
 					success: false,
 					error: options.errors?.invalidPort ? typeof options.errors.invalidPort === "function" ? options.errors.invalidPort(input) : options.errors.invalidPort : require_message.message`Expected a valid port number, but got ${input}.`
 				};
-				const value = BigInt(input);
-				if (value < min$1) return {
+				const value$1 = BigInt(input);
+				if (value$1 < min$1) return {
 					success: false,
-					error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, min$1) : options.errors.belowMinimum : require_message.message`Expected a port number greater than or equal to ${require_message.text(min$1.toLocaleString("en"))}, but got ${input}.`
+					error: options.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value$1, min$1) : options.errors.belowMinimum : require_message.message`Expected a port number greater than or equal to ${require_message.text(min$1.toLocaleString("en"))}, but got ${input}.`
 				};
-				if (value > max$1) return {
+				if (value$1 > max$1) return {
 					success: false,
-					error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value, max$1) : options.errors.aboveMaximum : require_message.message`Expected a port number less than or equal to ${require_message.text(max$1.toLocaleString("en"))}, but got ${input}.`
+					error: options.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value$1, max$1) : options.errors.aboveMaximum : require_message.message`Expected a port number less than or equal to ${require_message.text(max$1.toLocaleString("en"))}, but got ${input}.`
 				};
-				if (options.disallowWellKnown && value >= 1n && value <= 1023n) return {
+				if (options.disallowWellKnown && value$1 >= 1n && value$1 <= 1023n) return {
 					success: false,
-					error: options.errors?.wellKnownNotAllowed ? typeof options.errors.wellKnownNotAllowed === "function" ? options.errors.wellKnownNotAllowed(value) : options.errors.wellKnownNotAllowed : require_message.message`Port ${value.toLocaleString("en")} is a well-known port (1-1023) and may require elevated privileges.`
+					error: options.errors?.wellKnownNotAllowed ? typeof options.errors.wellKnownNotAllowed === "function" ? options.errors.wellKnownNotAllowed(value$1) : options.errors.wellKnownNotAllowed : require_message.message`Port ${value$1.toLocaleString("en")} is a well-known port (1-1023) and may require elevated privileges.`
 				};
 				return {
 					success: true,
-					value
+					value: value$1
 				};
 			},
-			format(value) {
-				return value.toString();
+			format(value$1) {
+				return value$1.toString();
 			}
 		};
 	}
@@ -2877,26 +2892,26 @@ function port(options) {
 				success: false,
 				error: options?.errors?.invalidPort ? typeof options.errors.invalidPort === "function" ? options.errors.invalidPort(input) : options.errors.invalidPort : require_message.message`Expected a valid port number, but got ${input}.`
 			};
-			const value = Number.parseInt(input);
-			if (value < min) return {
+			const value$1 = Number.parseInt(input);
+			if (value$1 < min) return {
 				success: false,
-				error: options?.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value, min) : options.errors.belowMinimum : require_message.message`Expected a port number greater than or equal to ${require_message.text(min.toLocaleString("en"))}, but got ${input}.`
+				error: options?.errors?.belowMinimum ? typeof options.errors.belowMinimum === "function" ? options.errors.belowMinimum(value$1, min) : options.errors.belowMinimum : require_message.message`Expected a port number greater than or equal to ${require_message.text(min.toLocaleString("en"))}, but got ${input}.`
 			};
-			if (value > max) return {
+			if (value$1 > max) return {
 				success: false,
-				error: options?.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value, max) : options.errors.aboveMaximum : require_message.message`Expected a port number less than or equal to ${require_message.text(max.toLocaleString("en"))}, but got ${input}.`
+				error: options?.errors?.aboveMaximum ? typeof options.errors.aboveMaximum === "function" ? options.errors.aboveMaximum(value$1, max) : options.errors.aboveMaximum : require_message.message`Expected a port number less than or equal to ${require_message.text(max.toLocaleString("en"))}, but got ${input}.`
 			};
-			if (options?.disallowWellKnown && value >= 1 && value <= 1023) return {
+			if (options?.disallowWellKnown && value$1 >= 1 && value$1 <= 1023) return {
 				success: false,
-				error: options.errors?.wellKnownNotAllowed ? typeof options.errors.wellKnownNotAllowed === "function" ? options.errors.wellKnownNotAllowed(value) : options.errors.wellKnownNotAllowed : require_message.message`Port ${value.toLocaleString("en")} is a well-known port (1-1023) and may require elevated privileges.`
+				error: options.errors?.wellKnownNotAllowed ? typeof options.errors.wellKnownNotAllowed === "function" ? options.errors.wellKnownNotAllowed(value$1) : options.errors.wellKnownNotAllowed : require_message.message`Port ${value$1.toLocaleString("en")} is a well-known port (1-1023) and may require elevated privileges.`
 			};
 			return {
 				success: true,
-				value
+				value: value$1
 			};
 		},
-		format(value) {
-			return value.toString();
+		format(value$1) {
+			return value$1.toString();
 		}
 	};
 }
@@ -3030,8 +3045,8 @@ function ipv4(options) {
 				value: ipAddress
 			};
 		},
-		format(value) {
-			return value;
+		format(value$1) {
+			return value$1;
 		}
 	};
 }
@@ -3193,8 +3208,8 @@ function hostname(options) {
 				value: input
 			};
 		},
-		format(value) {
-			return value;
+		format(value$1) {
+			return value$1;
 		}
 	};
 }
@@ -3415,9 +3430,9 @@ function email(options) {
 				};
 			}
 		},
-		format(value) {
-			if (Array.isArray(value)) return value.join(", ");
-			return value;
+		format(value$1) {
+			if (Array.isArray(value$1)) return value$1.join(", ");
+			return value$1;
 		}
 	};
 }
@@ -3650,13 +3665,13 @@ function socketAddress(options) {
 		};
 		return makeInvalidFormatError(input);
 	}
-	function isSocketAddressValue(value) {
-		return typeof value === "object" && value !== null && "host" in value && typeof value.host === "string" && "port" in value && typeof value.port === "number";
+	function isSocketAddressValue(value$1) {
+		return typeof value$1 === "object" && value$1 !== null && "host" in value$1 && typeof value$1.host === "string" && "port" in value$1 && typeof value$1.port === "number";
 	}
-	function formatSocketAddressValue(value) {
-		const ipv6Host = parseAndNormalizeIpv6(value.host);
-		if (separator === ":" && ipv6Host !== null) return `[${ipv6Host}]${separator}${value.port}`;
-		return `${value.host}${separator}${value.port}`;
+	function formatSocketAddressValue(value$1) {
+		const ipv6Host = parseAndNormalizeIpv6(value$1.host);
+		if (separator === ":" && ipv6Host !== null) return `[${ipv6Host}]${separator}${value$1.port}`;
+		return `${value$1.host}${separator}${value$1.port}`;
 	}
 	const parser = {
 		mode: "sync",
@@ -3889,16 +3904,16 @@ function socketAddress(options) {
 				error: require_message.message`Expected a socket address in format ${require_message.text(formatExample)}, but got ${input}.`
 			};
 		},
-		format(value) {
-			return formatSocketAddressValue(value);
+		format(value$1) {
+			return formatSocketAddressValue(value$1);
 		},
-		normalize(value) {
-			if (!isSocketAddressValue(value)) return value;
+		normalize(value$1) {
+			if (!isSocketAddressValue(value$1)) return value$1;
 			try {
-				const result = parser.parse(formatSocketAddressValue(value));
-				return result.success ? result.value : value;
+				const result = parser.parse(formatSocketAddressValue(value$1));
+				return result.success ? result.value : value$1;
 			} catch {
-				return value;
+				return value$1;
 			}
 		}
 	};
@@ -4029,8 +4044,8 @@ function portRange(options) {
 				};
 			}
 		},
-		format(value) {
-			return `${value.start}${separator}${value.end}`;
+		format(value$1) {
+			return `${value$1.start}${separator}${value$1.end}`;
 		}
 	};
 }
@@ -4108,11 +4123,11 @@ function macAddress(options) {
 		return formatted.join(sep);
 	}
 	let macParsing = false;
-	function normalizeMacValue(value, fallback) {
-		if (macParsing) return value;
+	function normalizeMacValue(value$1, fallback) {
+		if (macParsing) return value$1;
 		macParsing = true;
 		try {
-			const result = parserObj.parse(value);
+			const result = parserObj.parse(value$1);
 			return result.success ? result.value : fallback;
 		} catch {
 			return fallback;
@@ -4203,13 +4218,13 @@ function macAddress(options) {
 				value: joinOctets(octets, finalSeparator)
 			};
 		},
-		format(value) {
-			if (typeof value !== "string") return metavar$1;
-			return normalizeMacValue(value, value);
+		format(value$1) {
+			if (typeof value$1 !== "string") return metavar$1;
+			return normalizeMacValue(value$1, value$1);
 		},
-		normalize(value) {
-			if (typeof value !== "string") return value;
-			return normalizeMacValue(value, value);
+		normalize(value$1) {
+			if (typeof value$1 !== "string") return value$1;
+			return normalizeMacValue(value$1, value$1);
 		}
 	};
 	return parserObj;
@@ -4491,10 +4506,10 @@ function domain(options) {
 				value: result
 			};
 		},
-		format(value) {
-			if (typeof value !== "string") return metavar$1;
-			if (!lowercase) return value;
-			return value.split(".").length >= minLabels ? value.toLowerCase() : value;
+		format(value$1) {
+			if (typeof value$1 !== "string") return metavar$1;
+			if (!lowercase) return value$1;
+			return value$1.split(".").length >= minLabels ? value$1.toLowerCase() : value$1;
 		}
 	};
 	if (lowercase) {
@@ -4721,9 +4736,9 @@ function ipv6(options) {
 				value: normalized
 			};
 		},
-		format(value) {
-			if (typeof value !== "string") return metavar$1;
-			return parseAndNormalizeIpv6(value) ?? value;
+		format(value$1) {
+			if (typeof value$1 !== "string") return metavar$1;
+			return parseAndNormalizeIpv6(value$1) ?? value$1;
 		}
 	};
 	let ipv6Parsing = false;
@@ -5107,9 +5122,9 @@ function ip(options) {
 				error: msg
 			};
 		},
-		format(value) {
-			if (typeof value !== "string") return metavar$1;
-			return parseAndNormalizeIpv6(value) ?? value;
+		format(value$1) {
+			if (typeof value$1 !== "string") return metavar$1;
+			return parseAndNormalizeIpv6(value$1) ?? value$1;
 		}
 	};
 	let ipParsing = false;
@@ -5601,16 +5616,16 @@ function cidr(options) {
 	};
 	let cidrParsing = false;
 	Object.defineProperty(cidrParserObj, "format", {
-		value(value) {
-			if (typeof value !== "object" || value == null || !("address" in value) || !("prefix" in value) || !("version" in value)) return metavar$1;
-			if (cidrParsing) return `${value.address}/${value.prefix}`;
+		value(value$1) {
+			if (typeof value$1 !== "object" || value$1 == null || !("address" in value$1) || !("prefix" in value$1) || !("version" in value$1)) return metavar$1;
+			if (cidrParsing) return `${value$1.address}/${value$1.prefix}`;
 			cidrParsing = true;
 			try {
-				const raw = `${value.address}/${value.prefix}`;
+				const raw = `${value$1.address}/${value$1.prefix}`;
 				const result = cidrParserObj.parse(raw);
-				return result.success && result.value.version === value.version ? `${result.value.address}/${result.value.prefix}` : raw;
+				return result.success && result.value.version === value$1.version ? `${result.value.address}/${result.value.prefix}` : raw;
 			} catch {
-				return `${value.address}/${value.prefix}`;
+				return `${value$1.address}/${value$1.prefix}`;
 			} finally {
 				cidrParsing = false;
 			}
@@ -5692,10 +5707,10 @@ function semVer(options = {}) {
 				value: result
 			};
 		},
-		format(value) {
-			let s = `${value.major}.${value.minor}.${value.patch}`;
-			if (value.preRelease != null) s += `-${value.preRelease}`;
-			if (value.metadata != null) s += `+${value.metadata}`;
+		format(value$1) {
+			let s = `${value$1.major}.${value$1.minor}.${value$1.patch}`;
+			if (value$1.preRelease != null) s += `-${value$1.preRelease}`;
+			if (value$1.metadata != null) s += `+${value$1.metadata}`;
 			return s;
 		},
 		*suggest(prefix) {
@@ -5719,8 +5734,8 @@ function semVer(options = {}) {
 				value: canonical
 			};
 		},
-		format(value) {
-			return value;
+		format(value$1) {
+			return value$1;
 		},
 		*suggest(prefix) {
 			for (const s of suggestions) if (s.startsWith(prefix)) yield {
@@ -5788,9 +5803,9 @@ function json(options) {
 		metavar: metavar$1,
 		placeholder,
 		parse(input) {
-			let value;
+			let value$1;
 			try {
-				value = JSON.parse(input);
+				value$1 = JSON.parse(input);
 			} catch (e) {
 				const err = e instanceof Error ? e : new Error(String(e));
 				const error = invalidJsonError instanceof Function ? invalidJsonError(input) : invalidJsonError ?? [require_message.text(`Not a valid JSON: ${err.message}`)];
@@ -5799,7 +5814,7 @@ function json(options) {
 					error
 				};
 			}
-			const nonFinite = findNonFiniteNumber(value);
+			const nonFinite = findNonFiniteNumber(value$1);
 			if (nonFinite !== void 0) {
 				const error = invalidJsonError instanceof Function ? invalidJsonError(input) : invalidJsonError ?? [require_message.text(`Not a valid JSON: number out of range.`)];
 				return {
@@ -5808,9 +5823,9 @@ function json(options) {
 				};
 			}
 			if (rootType != null) {
-				const actual = jsonTypeOf(value);
+				const actual = jsonTypeOf(value$1);
 				if (actual !== rootType) {
-					const error = invalidRootTypeError instanceof Function ? invalidRootTypeError(value, rootType) : invalidRootTypeError ?? [require_message.text(`Expected JSON ${rootType}, but got ${actual}.`)];
+					const error = invalidRootTypeError instanceof Function ? invalidRootTypeError(value$1, rootType) : invalidRootTypeError ?? [require_message.text(`Expected JSON ${rootType}, but got ${actual}.`)];
 					return {
 						success: false,
 						error
@@ -5819,20 +5834,20 @@ function json(options) {
 			}
 			return {
 				success: true,
-				value
+				value: value$1
 			};
 		},
-		format(value) {
-			const nonFinite = findNonFiniteNumber(value);
+		format(value$1) {
+			const nonFinite = findNonFiniteNumber(value$1);
 			if (nonFinite !== void 0) throw new TypeError(`Expected a finite JSON number, but got ${String(nonFinite)}.`);
-			return JSON.stringify(value);
+			return JSON.stringify(value$1);
 		}
 	};
 }
-function jsonTypeOf(value) {
-	if (value === null) return "null";
-	if (Array.isArray(value)) return "array";
-	return typeof value;
+function jsonTypeOf(value$1) {
+	if (value$1 === null) return "null";
+	if (Array.isArray(value$1)) return "array";
+	return typeof value$1;
 }
 /**
 * Finds the first non-finite number (`NaN`, `Infinity`, or `-Infinity`)
@@ -5849,17 +5864,17 @@ function findNonFiniteNumber(root) {
 	const stack = [root];
 	const seen = /* @__PURE__ */ new Set();
 	while (stack.length > 0) {
-		const value = stack.pop();
-		if (typeof value === "number") {
-			if (!Number.isFinite(value)) return value;
-		} else if (Array.isArray(value)) {
-			if (seen.has(value)) continue;
-			seen.add(value);
-			for (const item of value) stack.push(item);
-		} else if (value !== null && typeof value === "object") {
-			if (seen.has(value)) continue;
-			seen.add(value);
-			for (const item of Object.values(value)) stack.push(item);
+		const value$1 = stack.pop();
+		if (typeof value$1 === "number") {
+			if (!Number.isFinite(value$1)) return value$1;
+		} else if (Array.isArray(value$1)) {
+			if (seen.has(value$1)) continue;
+			seen.add(value$1);
+			for (const item of value$1) stack.push(item);
+		} else if (value$1 !== null && typeof value$1 === "object") {
+			if (seen.has(value$1)) continue;
+			seen.add(value$1);
+			for (const item of Object.values(value$1)) stack.push(item);
 		}
 	}
 	return void 0;
@@ -5992,21 +6007,21 @@ function cron(options = {}) {
 			...years ? { year: "1970" } : {}
 		},
 		parse: parseCron,
-		format(value) {
+		format(value$1) {
 			return [
-				...seconds ? [value.second ?? "0"] : [],
-				value.minute,
-				value.hour,
-				value.dayOfMonth,
-				value.month,
-				value.dayOfWeek,
-				...years ? [value.year ?? "1970"] : []
+				...seconds ? [value$1.second ?? "0"] : [],
+				value$1.minute,
+				value$1.hour,
+				value$1.dayOfMonth,
+				value$1.month,
+				value$1.dayOfWeek,
+				...years ? [value$1.year ?? "1970"] : []
 			].join(" ");
 		},
-		validate(value) {
-			if (seconds && value.second == null || years && value.year == null) return makeError(this.format(value));
-			if (!seconds && value.second != null || !years && value.year != null) return makeError(this.format(value));
-			const result = parseCron(this.format(value));
+		validate(value$1) {
+			if (seconds && value$1.second == null || years && value$1.year == null) return makeError(this.format(value$1));
+			if (!seconds && value$1.second != null || !years && value$1.year != null) return makeError(this.format(value$1));
+			const result = parseCron(this.format(value$1));
 			return result.success ? {
 				success: true,
 				value: result.value
@@ -6038,10 +6053,10 @@ function isQuartzCronField(field, spec, quartz) {
 	}
 	return false;
 }
-function parseQuartzDayOfWeekSuffixValue(value) {
-	if (/^[1-7]$/u.test(value)) return true;
-	if (!/^[A-Z]{3}$/u.test(value)) return false;
-	return CRON_DAY_NAMES.has(value);
+function parseQuartzDayOfWeekSuffixValue(value$1) {
+	if (/^[1-7]$/u.test(value$1)) return true;
+	if (!/^[A-Z]{3}$/u.test(value$1)) return false;
+	return CRON_DAY_NAMES.has(value$1);
 }
 function isValidCronFieldPart(part, spec) {
 	const stepParts = part.split("/");
@@ -6062,18 +6077,18 @@ function isValidCronFieldPart(part, spec) {
 function isPositiveCronStep(step) {
 	return /^\d+$/u.test(step) && Number.parseInt(step, 10) > 0;
 }
-function isCronValueInRange(value, spec) {
-	return parseCronValue(value, spec) !== void 0;
+function isCronValueInRange(value$1, spec) {
+	return parseCronValue(value$1, spec) !== void 0;
 }
 function parseCronRangeEnd(start, end, spec) {
 	if (spec.kind === "dayOfWeek" && start.toUpperCase() !== "SUN" && (end.toUpperCase() === "SUN" || end === "0")) return 7;
 	return parseCronValue(end, spec);
 }
-function parseCronValue(value, spec) {
-	const named = spec.names?.get(value.toUpperCase());
+function parseCronValue(value$1, spec) {
+	const named = spec.names?.get(value$1.toUpperCase());
 	if (named !== void 0) return named;
-	if (!/^\d+$/u.test(value)) return void 0;
-	const number = Number.parseInt(value, 10);
+	if (!/^\d+$/u.test(value$1)) return void 0;
+	const number = Number.parseInt(value$1, 10);
 	return number >= spec.min && number <= spec.max ? number : void 0;
 }
 /**
@@ -6104,14 +6119,14 @@ function firstOf(...rawArgs) {
 	}
 	const metavar$1 = options.metavar ?? parsers.map((parser) => parser.metavar).join("|");
 	require_nonempty.ensureNonEmptyString(metavar$1);
-	const mergedChoices = parsers.every((parser) => parser.choices != null) ? Object.freeze(parsers.flatMap((parser) => [...parser.choices]).filter((value, index, all) => all.findIndex((other) => Object.is(other, value)) === index)) : void 0;
-	function findOwner(value) {
+	const mergedChoices = parsers.every((parser) => parser.choices != null) ? Object.freeze(parsers.flatMap((parser) => [...parser.choices]).filter((value$1, index, all) => all.findIndex((other) => Object.is(other, value$1)) === index)) : void 0;
+	function findOwner(value$1) {
 		let canonicalizing;
 		for (const parser of parsers) {
 			if (typeof parser.validate === "function") {
 				let result$1;
 				try {
-					result$1 = parser.validate(value);
+					result$1 = parser.validate(value$1);
 				} catch {
 					continue;
 				}
@@ -6123,18 +6138,18 @@ function firstOf(...rawArgs) {
 			}
 			let formatted;
 			try {
-				formatted = parser.format(value);
+				formatted = parser.format(value$1);
 			} catch {
 				continue;
 			}
 			if (typeof formatted !== "string") continue;
 			const result = parser.parse(formatted);
 			if (!result.success) continue;
-			if (ownsRoundTrippedValue(parser, result.value, value)) return {
+			if (ownsRoundTrippedValue(parser, result.value, value$1)) return {
 				parser,
 				result
 			};
-			if (canonicalizing == null && value !== null && typeof value !== "object" && typeof result.value === typeof value) canonicalizing = {
+			if (canonicalizing == null && value$1 !== null && typeof value$1 !== "object" && typeof result.value === typeof value$1) canonicalizing = {
 				parser,
 				result
 			};
@@ -6161,7 +6176,7 @@ function firstOf(...rawArgs) {
 				error: noMatch == null ? firstOfNoMatchError(errors) : typeof noMatch === "function" ? noMatch(input, errors) : noMatch
 			};
 		},
-		format(value) {
+		format(value$1) {
 			let canonicalizing;
 			let fallback;
 			let firstError;
@@ -6169,7 +6184,7 @@ function firstOf(...rawArgs) {
 			for (const parser of parsers) {
 				let formatted;
 				try {
-					formatted = parser.format(value);
+					formatted = parser.format(value$1);
 				} catch (e) {
 					if (!hasError) {
 						firstError = e;
@@ -6181,14 +6196,14 @@ function firstOf(...rawArgs) {
 				if (typeof parser.validate === "function") {
 					let owned = false;
 					try {
-						owned = parser.validate(value).success;
+						owned = parser.validate(value$1).success;
 					} catch {}
 					if (owned) return formatted;
 				} else {
 					const result = parser.parse(formatted);
 					if (result.success) {
-						if (ownsRoundTrippedValue(parser, result.value, value)) return formatted;
-						if (canonicalizing == null && value !== null && typeof value !== "object" && typeof result.value === typeof value) canonicalizing = formatted;
+						if (ownsRoundTrippedValue(parser, result.value, value$1)) return formatted;
+						if (canonicalizing == null && value$1 !== null && typeof value$1 !== "object" && typeof result.value === typeof value$1) canonicalizing = formatted;
 					}
 				}
 				fallback ??= formatted;
@@ -6198,18 +6213,18 @@ function firstOf(...rawArgs) {
 			if (hasError) throw firstError;
 			throw new TypeError("No constituent parser could format the given value.");
 		},
-		validate(value) {
-			const owner = findOwner(value);
+		validate(value$1) {
+			const owner = findOwner(value$1);
 			if (owner == null) return {
 				success: false,
 				error: require_message.message`Expected a value matching ${require_message.metavar(metavar$1)}.`
 			};
 			return owner.result;
 		},
-		...hasNormalize ? { normalize(value) {
-			const owner = findOwner(value);
-			if (owner == null || typeof owner.parser.normalize !== "function") return value;
-			return owner.parser.normalize(value);
+		...hasNormalize ? { normalize(value$1) {
+			const owner = findOwner(value$1);
+			if (owner == null || typeof owner.parser.normalize !== "function") return value$1;
+			return owner.parser.normalize(value$1);
 		} } : {},
 		...hasSuggest ? { *suggest(prefix) {
 			const collected = [];
@@ -6252,19 +6267,19 @@ function firstOfNoMatchError(errors) {
 * canonicalization from data loss (e.g. a lossy `color()` `format()`
 * dropping fields that belong to a later, more faithful constituent).
 */
-function ownsRoundTrippedValue(parser, roundTripped, value) {
-	if (valuesEqual(roundTripped, value)) return true;
+function ownsRoundTrippedValue(parser, roundTripped, value$1) {
+	if (valuesEqual(roundTripped, value$1)) return true;
 	if (typeof parser.normalize === "function") {
 		let normalized;
 		try {
-			normalized = parser.normalize(value);
+			normalized = parser.normalize(value$1);
 		} catch {
 			return false;
 		}
 		if (valuesEqual(roundTripped, normalized)) return true;
 	}
-	if (typeof value === "string" && typeof roundTripped === "string") return value.toLowerCase() === roundTripped.toLowerCase();
-	if (typeof value === "number" && typeof roundTripped === "number") return value === roundTripped;
+	if (typeof value$1 === "string" && typeof roundTripped === "string") return value$1.toLowerCase() === roundTripped.toLowerCase();
+	if (typeof value$1 === "number" && typeof roundTripped === "number") return value$1 === roundTripped;
 	return false;
 }
 /**
@@ -6308,9 +6323,9 @@ function valuesEqual(a, b) {
 * Checks whether an object provides a `toString()` implementation other
 * than the generic `Object.prototype.toString`.
 */
-function hasCustomToString(value) {
+function hasCustomToString(value$1) {
 	try {
-		const toString = value.toString;
+		const toString = value$1.toString;
 		return typeof toString === "function" && toString !== Object.prototype.toString;
 	} catch {
 		return false;