@optique/core 1.0.0-dev.1470 → 1.0.0-dev.1492

package/dist/doc.cjs

@@ -248,7 +248,7 @@ function formatDocPage(programName, page, options = {}) {
 		const splitEntryMin = termIndent + 2 + Math.max(2, 2 * minDescWidth - 1);
 		const fixedEntryMin = termIndent + 2 + termWidth + minDescWidth;
 		const entryMin = needsDescColumn ? Math.min(splitEntryMin, fixedEntryMin) : hasEntries ? termIndent + 1 : 1;
-		const usageMin = page.usage != null ? 8 + programName.length : 1;
+		const usageMin = page.usage != null ? 7 + Math.max(programName.length, Math.min(maxVisibleAtomicWidth(page.usage), programName.length + 7)) : 1;
 		let sectionMin = 1;
 		if (page.examples != null) sectionMin = Math.max(sectionMin, 9);
 		if (page.author != null) sectionMin = Math.max(sectionMin, 7);
@@ -451,6 +451,54 @@ function formatDocPage(programName, page, options = {}) {
 function indentLines(text$1, indent) {
 	return text$1.split("\n").join("\n" + " ".repeat(indent));
 }
+/**
+* Returns the width of the widest non-breakable segment among visible
+* (non-usage-hidden) terms in a usage tree.  Hidden terms are excluded
+* because they are filtered out before rendering, so they do not
+* contribute to the rendered width.
+*/
+function maxVisibleAtomicWidth(usage) {
+	let max = 0;
+	for (const term of usage) switch (term.type) {
+		case "argument":
+			if (!require_usage.isUsageHidden(term.hidden)) max = Math.max(max, term.metavar.length);
+			break;
+		case "option":
+			if (!require_usage.isUsageHidden(term.hidden) && term.names.length > 0) {
+				for (const name of term.names) max = Math.max(max, name.length);
+				if (term.metavar != null) max = Math.max(max, term.metavar.length);
+			}
+			break;
+		case "command":
+			if (!require_usage.isUsageHidden(term.hidden)) max = Math.max(max, term.name.length);
+			break;
+		case "passthrough":
+			if (!require_usage.isUsageHidden(term.hidden)) max = Math.max(max, 5);
+			break;
+		case "optional":
+			max = Math.max(max, maxVisibleAtomicWidth(term.terms));
+			break;
+		case "multiple": {
+			const innerMax = maxVisibleAtomicWidth(term.terms);
+			if (innerMax > 0) max = Math.max(max, 3, innerMax);
+			break;
+		}
+		case "exclusive":
+			for (const branch of term.terms) {
+				const first = branch[0];
+				if (first?.type === "command" && require_usage.isUsageHidden(first.hidden)) continue;
+				max = Math.max(max, maxVisibleAtomicWidth(branch));
+			}
+			break;
+		case "literal":
+			if (term.value !== "") max = Math.max(max, term.value.length);
+			break;
+		case "ellipsis":
+			max = Math.max(max, 3);
+			break;
+	}
+	return max;
+}
 const ansiEscapeCodeRegex = /\x1B\[[0-9;]*[a-zA-Z]/g;
 function ansiAwareRightPad(text$1, length, char = " ") {
 	const strippedText = text$1.replace(ansiEscapeCodeRegex, "");

package/dist/doc.js

@@ -1,6 +1,6 @@
 import { cloneMessage, formatMessage, text } from "./message.js";
 import { validateProgramName } from "./validate.js";
-import { cloneUsageTerm, formatUsage, formatUsageTerm, isDocHidden } from "./usage.js";
+import { cloneUsageTerm, formatUsage, formatUsageTerm, isDocHidden, isUsageHidden } from "./usage.js";
 
 //#region src/doc.ts
 /**
@@ -248,7 +248,7 @@ function formatDocPage(programName, page, options = {}) {
 		const splitEntryMin = termIndent + 2 + Math.max(2, 2 * minDescWidth - 1);
 		const fixedEntryMin = termIndent + 2 + termWidth + minDescWidth;
 		const entryMin = needsDescColumn ? Math.min(splitEntryMin, fixedEntryMin) : hasEntries ? termIndent + 1 : 1;
-		const usageMin = page.usage != null ? 8 + programName.length : 1;
+		const usageMin = page.usage != null ? 7 + Math.max(programName.length, Math.min(maxVisibleAtomicWidth(page.usage), programName.length + 7)) : 1;
 		let sectionMin = 1;
 		if (page.examples != null) sectionMin = Math.max(sectionMin, 9);
 		if (page.author != null) sectionMin = Math.max(sectionMin, 7);
@@ -451,6 +451,54 @@ function formatDocPage(programName, page, options = {}) {
 function indentLines(text$1, indent) {
 	return text$1.split("\n").join("\n" + " ".repeat(indent));
 }
+/**
+* Returns the width of the widest non-breakable segment among visible
+* (non-usage-hidden) terms in a usage tree.  Hidden terms are excluded
+* because they are filtered out before rendering, so they do not
+* contribute to the rendered width.
+*/
+function maxVisibleAtomicWidth(usage) {
+	let max = 0;
+	for (const term of usage) switch (term.type) {
+		case "argument":
+			if (!isUsageHidden(term.hidden)) max = Math.max(max, term.metavar.length);
+			break;
+		case "option":
+			if (!isUsageHidden(term.hidden) && term.names.length > 0) {
+				for (const name of term.names) max = Math.max(max, name.length);
+				if (term.metavar != null) max = Math.max(max, term.metavar.length);
+			}
+			break;
+		case "command":
+			if (!isUsageHidden(term.hidden)) max = Math.max(max, term.name.length);
+			break;
+		case "passthrough":
+			if (!isUsageHidden(term.hidden)) max = Math.max(max, 5);
+			break;
+		case "optional":
+			max = Math.max(max, maxVisibleAtomicWidth(term.terms));
+			break;
+		case "multiple": {
+			const innerMax = maxVisibleAtomicWidth(term.terms);
+			if (innerMax > 0) max = Math.max(max, 3, innerMax);
+			break;
+		}
+		case "exclusive":
+			for (const branch of term.terms) {
+				const first = branch[0];
+				if (first?.type === "command" && isUsageHidden(first.hidden)) continue;
+				max = Math.max(max, maxVisibleAtomicWidth(branch));
+			}
+			break;
+		case "literal":
+			if (term.value !== "") max = Math.max(max, term.value.length);
+			break;
+		case "ellipsis":
+			max = Math.max(max, 3);
+			break;
+	}
+	return max;
+}
 const ansiEscapeCodeRegex = /\x1B\[[0-9;]*[a-zA-Z]/g;
 function ansiAwareRightPad(text$1, length, char = " ") {
 	const strippedText = text$1.replace(ansiEscapeCodeRegex, "");

package/dist/usage.cjs

@@ -164,13 +164,24 @@ function formatUsage(programName, usage, options = {}) {
 				if (usage.length > 1) command = [...usage.slice(0, -1), ...command];
 				lines.push(formatUsage(programName, command, options));
 			}
-			return lines.join("\n");
+			if (lines.length > 0) return lines.join("\n");
 		}
 	}
-	let output = options.colors ? `\x1b[1m${programName}\x1b[0m ` : `${programName} `;
-	let lineWidth = programName.length + 1;
+	let output = options.colors ? `\x1b[1m${programName}\x1b[0m` : programName;
+	let lineWidth = programName.length;
+	let first = true;
 	for (const { text, width } of formatUsageTerms(usage, options)) {
-		if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+		if (first) {
+			first = false;
+			if (options.maxWidth != null && lineWidth + 1 + width > options.maxWidth) {
+				output += "\n";
+				lineWidth = 0;
+			} else {
+				output += " ";
+				lineWidth += 1;
+			}
+		} else if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+			if (output.endsWith(" ")) output = output.slice(0, -1);
 			output += "\n";
 			lineWidth = 0;
 			if (text === " ") continue;
@@ -408,6 +419,7 @@ function formatUsageTerm(term, options = {}) {
 	let output = "";
 	for (const { text, width } of formatUsageTermInternal(visibleTerms[0], options)) {
 		if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+			if (output.endsWith(" ")) output = output.slice(0, -1);
 			output += "\n";
 			lineWidth = 0;
 			if (text === " ") continue;

package/dist/usage.js

@@ -164,13 +164,24 @@ function formatUsage(programName, usage, options = {}) {
 				if (usage.length > 1) command = [...usage.slice(0, -1), ...command];
 				lines.push(formatUsage(programName, command, options));
 			}
-			return lines.join("\n");
+			if (lines.length > 0) return lines.join("\n");
 		}
 	}
-	let output = options.colors ? `\x1b[1m${programName}\x1b[0m ` : `${programName} `;
-	let lineWidth = programName.length + 1;
+	let output = options.colors ? `\x1b[1m${programName}\x1b[0m` : programName;
+	let lineWidth = programName.length;
+	let first = true;
 	for (const { text, width } of formatUsageTerms(usage, options)) {
-		if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+		if (first) {
+			first = false;
+			if (options.maxWidth != null && lineWidth + 1 + width > options.maxWidth) {
+				output += "\n";
+				lineWidth = 0;
+			} else {
+				output += " ";
+				lineWidth += 1;
+			}
+		} else if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+			if (output.endsWith(" ")) output = output.slice(0, -1);
 			output += "\n";
 			lineWidth = 0;
 			if (text === " ") continue;
@@ -408,6 +419,7 @@ function formatUsageTerm(term, options = {}) {
 	let output = "";
 	for (const { text, width } of formatUsageTermInternal(visibleTerms[0], options)) {
 		if (options.maxWidth != null && lineWidth + width > options.maxWidth) {
+			if (output.endsWith(" ")) output = output.slice(0, -1);
 			output += "\n";
 			lineWidth = 0;
 			if (text === " ") continue;

package/dist/valueparser.cjs

@@ -1726,73 +1726,182 @@ function socketAddress(options) {
 		metavar,
 		parse(input) {
 			const trimmed = input.trim();
-			const separatorIndex = trimmed.lastIndexOf(separator);
-			let hostPart;
-			let portPart;
-			if (separatorIndex === -1) {
-				hostPart = trimmed;
-				portPart = void 0;
-			} else {
-				hostPart = trimmed.substring(0, separatorIndex);
-				portPart = trimmed.substring(separatorIndex + separator.length);
-			}
-			const hostResult = parseHost(hostPart);
-			if (!hostResult.success) {
-				const errorMsg = options?.errors?.invalidFormat;
-				if (errorMsg) {
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg;
+			const canOmitPort = defaultPort !== void 0 && !requirePort;
+			let firstHostError;
+			let validHostNumericPortInvalid = false;
+			let trailingSepHost;
+			let trailingSepHostError;
+			let anySeparatorFound = false;
+			let searchFrom = trimmed.length;
+			while (searchFrom > 0) {
+				const separatorIndex = trimmed.lastIndexOf(separator, searchFrom - 1);
+				if (separatorIndex === -1) break;
+				anySeparatorFound = true;
+				const hostPart = trimmed.substring(0, separatorIndex);
+				const portPart = trimmed.substring(separatorIndex + separator.length);
+				if (portPart === "") {
+					if (trailingSepHost === void 0 && trailingSepHostError === void 0) {
+						const hostResult = parseHost(hostPart);
+						if (hostResult.success) trailingSepHost = hostResult.value;
+						else trailingSepHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					}
+				} else {
+					const portResult = portParser.parse(portPart);
+					if (portResult.success) {
+						const hostResult = parseHost(hostPart);
+						if (hostResult.success) return {
+							success: true,
+							value: {
+								host: hostResult.value,
+								port: portResult.value
+							}
+						};
+						if (firstHostError === void 0 || (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) && !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) firstHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					} else if (!validHostNumericPortInvalid && hostPart !== "" && /^[0-9]+$/.test(portPart)) if (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) {
+						const hostResult = parseHost(hostPart);
+						if (!hostResult.success) {
+							if (firstHostError === void 0 || !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) firstHostError = {
+								hostPart,
+								error: hostResult.error
+							};
+						} else validHostNumericPortInvalid = true;
+					} else validHostNumericPortInvalid = true;
+					else if ((firstHostError === void 0 || !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) && (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart))) {
+						const hostResult = parseHost(hostPart);
+						if (!hostResult.success) firstHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					}
+				}
+				searchFrom = separatorIndex;
+			}
+			if (validHostNumericPortInvalid) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				if (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) return {
+				return {
 					success: false,
-					error: hostResult.error
+					error: require_message.message`Expected a socket address in format host${separator}port, but got ${input}.`
+				};
+			}
+			if (firstHostError !== void 0) {
+				if (looksLikeIpv4(firstHostError.hostPart) || looksLikeAltIpv4Literal(firstHostError.hostPart)) {
+					const errorMsg$1 = options?.errors?.invalidFormat;
+					if (errorMsg$1) {
+						const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
+						return {
+							success: false,
+							error: msg
+						};
+					}
+					return {
+						success: false,
+						error: firstHostError.error
+					};
+				}
+			}
+			let hostOnlyResult;
+			if (!requirePort || trailingSepHost !== void 0 || trailingSepHostError !== void 0) {
+				hostOnlyResult = parseHost(trimmed);
+				if (canOmitPort && hostOnlyResult.success) return {
+					success: true,
+					value: {
+						host: hostOnlyResult.value,
+						port: defaultPort
+					}
+				};
+			}
+			if (trailingSepHost !== void 0 && hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				if (canOmitPort) return {
+					success: true,
+					value: {
+						host: trailingSepHost,
+						port: defaultPort
+					}
 				};
+				const errorMsg$1 = options?.errors?.missingPort;
+				const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? require_message.message`Port number is required but was not specified.`;
 				return {
 					success: false,
-					error: require_message.message`Expected a socket address in format host${separator}port, but got ${input}.`
+					error: msg
 				};
 			}
-			const validatedHost = hostResult.value;
-			let validatedPort;
-			if (portPart === void 0 || portPart === "") {
-				if (requirePort) {
-					const errorMsg = options?.errors?.missingPort;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? require_message.message`Port number is required but was not specified.`;
+			if (trailingSepHostError !== void 0 && hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				if (defaultPort !== void 0) validatedPort = defaultPort;
-				else {
-					const errorMsg = options?.errors?.missingPort;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? require_message.message`Port number is required but was not specified.`;
+				if (looksLikeIpv4(trailingSepHostError.hostPart) || looksLikeAltIpv4Literal(trailingSepHostError.hostPart)) return {
+					success: false,
+					error: trailingSepHostError.error
+				};
+				return {
+					success: false,
+					error: require_message.message`Expected a socket address in format host${separator}port, but got ${input}.`
+				};
+			}
+			if (!canOmitPort && !requirePort && hostOnlyResult !== void 0 && hostOnlyResult.success) {
+				const errorMsg$1 = options?.errors?.missingPort;
+				const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? require_message.message`Port number is required but was not specified.`;
+				return {
+					success: false,
+					error: msg
+				};
+			}
+			if (!canOmitPort && !anySeparatorFound) {
+				hostOnlyResult = hostOnlyResult ?? parseHost(trimmed);
+				if (hostOnlyResult.success) {
+					const errorMsg$1 = options?.errors?.missingPort;
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? require_message.message`Port number is required but was not specified.`;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-			} else {
-				const portResult = portParser.parse(portPart);
-				if (!portResult.success) {
-					const errorMsg = options?.errors?.invalidFormat;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? require_message.message`Expected a socket address in format host${separator}port, but got ${input}.`;
+			}
+			if (firstHostError !== void 0) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				validatedPort = portResult.value;
+			}
+			const errorMsg = options?.errors?.invalidFormat;
+			if (errorMsg) {
+				const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg;
+				return {
+					success: false,
+					error: msg
+				};
+			}
+			if (hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				if (looksLikeIpv4(trimmed) || looksLikeAltIpv4Literal(trimmed)) return {
+					success: false,
+					error: hostOnlyResult.error
+				};
 			}
 			return {
-				success: true,
-				value: {
-					host: validatedHost,
-					port: validatedPort
-				}
+				success: false,
+				error: require_message.message`Expected a socket address in format host${separator}port, but got ${input}.`
 			};
 		},
 		format(value) {

package/dist/valueparser.js

@@ -1726,73 +1726,182 @@ function socketAddress(options) {
 		metavar,
 		parse(input) {
 			const trimmed = input.trim();
-			const separatorIndex = trimmed.lastIndexOf(separator);
-			let hostPart;
-			let portPart;
-			if (separatorIndex === -1) {
-				hostPart = trimmed;
-				portPart = void 0;
-			} else {
-				hostPart = trimmed.substring(0, separatorIndex);
-				portPart = trimmed.substring(separatorIndex + separator.length);
-			}
-			const hostResult = parseHost(hostPart);
-			if (!hostResult.success) {
-				const errorMsg = options?.errors?.invalidFormat;
-				if (errorMsg) {
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg;
+			const canOmitPort = defaultPort !== void 0 && !requirePort;
+			let firstHostError;
+			let validHostNumericPortInvalid = false;
+			let trailingSepHost;
+			let trailingSepHostError;
+			let anySeparatorFound = false;
+			let searchFrom = trimmed.length;
+			while (searchFrom > 0) {
+				const separatorIndex = trimmed.lastIndexOf(separator, searchFrom - 1);
+				if (separatorIndex === -1) break;
+				anySeparatorFound = true;
+				const hostPart = trimmed.substring(0, separatorIndex);
+				const portPart = trimmed.substring(separatorIndex + separator.length);
+				if (portPart === "") {
+					if (trailingSepHost === void 0 && trailingSepHostError === void 0) {
+						const hostResult = parseHost(hostPart);
+						if (hostResult.success) trailingSepHost = hostResult.value;
+						else trailingSepHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					}
+				} else {
+					const portResult = portParser.parse(portPart);
+					if (portResult.success) {
+						const hostResult = parseHost(hostPart);
+						if (hostResult.success) return {
+							success: true,
+							value: {
+								host: hostResult.value,
+								port: portResult.value
+							}
+						};
+						if (firstHostError === void 0 || (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) && !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) firstHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					} else if (!validHostNumericPortInvalid && hostPart !== "" && /^[0-9]+$/.test(portPart)) if (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) {
+						const hostResult = parseHost(hostPart);
+						if (!hostResult.success) {
+							if (firstHostError === void 0 || !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) firstHostError = {
+								hostPart,
+								error: hostResult.error
+							};
+						} else validHostNumericPortInvalid = true;
+					} else validHostNumericPortInvalid = true;
+					else if ((firstHostError === void 0 || !looksLikeIpv4(firstHostError.hostPart) && !looksLikeAltIpv4Literal(firstHostError.hostPart)) && (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart))) {
+						const hostResult = parseHost(hostPart);
+						if (!hostResult.success) firstHostError = {
+							hostPart,
+							error: hostResult.error
+						};
+					}
+				}
+				searchFrom = separatorIndex;
+			}
+			if (validHostNumericPortInvalid) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				if (looksLikeIpv4(hostPart) || looksLikeAltIpv4Literal(hostPart)) return {
+				return {
 					success: false,
-					error: hostResult.error
+					error: message`Expected a socket address in format host${separator}port, but got ${input}.`
+				};
+			}
+			if (firstHostError !== void 0) {
+				if (looksLikeIpv4(firstHostError.hostPart) || looksLikeAltIpv4Literal(firstHostError.hostPart)) {
+					const errorMsg$1 = options?.errors?.invalidFormat;
+					if (errorMsg$1) {
+						const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
+						return {
+							success: false,
+							error: msg
+						};
+					}
+					return {
+						success: false,
+						error: firstHostError.error
+					};
+				}
+			}
+			let hostOnlyResult;
+			if (!requirePort || trailingSepHost !== void 0 || trailingSepHostError !== void 0) {
+				hostOnlyResult = parseHost(trimmed);
+				if (canOmitPort && hostOnlyResult.success) return {
+					success: true,
+					value: {
+						host: hostOnlyResult.value,
+						port: defaultPort
+					}
+				};
+			}
+			if (trailingSepHost !== void 0 && hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				if (canOmitPort) return {
+					success: true,
+					value: {
+						host: trailingSepHost,
+						port: defaultPort
+					}
 				};
+				const errorMsg$1 = options?.errors?.missingPort;
+				const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? message`Port number is required but was not specified.`;
 				return {
 					success: false,
-					error: message`Expected a socket address in format host${separator}port, but got ${input}.`
+					error: msg
 				};
 			}
-			const validatedHost = hostResult.value;
-			let validatedPort;
-			if (portPart === void 0 || portPart === "") {
-				if (requirePort) {
-					const errorMsg = options?.errors?.missingPort;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? message`Port number is required but was not specified.`;
+			if (trailingSepHostError !== void 0 && hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				if (defaultPort !== void 0) validatedPort = defaultPort;
-				else {
-					const errorMsg = options?.errors?.missingPort;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? message`Port number is required but was not specified.`;
+				if (looksLikeIpv4(trailingSepHostError.hostPart) || looksLikeAltIpv4Literal(trailingSepHostError.hostPart)) return {
+					success: false,
+					error: trailingSepHostError.error
+				};
+				return {
+					success: false,
+					error: message`Expected a socket address in format host${separator}port, but got ${input}.`
+				};
+			}
+			if (!canOmitPort && !requirePort && hostOnlyResult !== void 0 && hostOnlyResult.success) {
+				const errorMsg$1 = options?.errors?.missingPort;
+				const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? message`Port number is required but was not specified.`;
+				return {
+					success: false,
+					error: msg
+				};
+			}
+			if (!canOmitPort && !anySeparatorFound) {
+				hostOnlyResult = hostOnlyResult ?? parseHost(trimmed);
+				if (hostOnlyResult.success) {
+					const errorMsg$1 = options?.errors?.missingPort;
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1 ?? message`Port number is required but was not specified.`;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-			} else {
-				const portResult = portParser.parse(portPart);
-				if (!portResult.success) {
-					const errorMsg = options?.errors?.invalidFormat;
-					const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg ?? message`Expected a socket address in format host${separator}port, but got ${input}.`;
+			}
+			if (firstHostError !== void 0) {
+				const errorMsg$1 = options?.errors?.invalidFormat;
+				if (errorMsg$1) {
+					const msg = typeof errorMsg$1 === "function" ? errorMsg$1(input) : errorMsg$1;
 					return {
 						success: false,
 						error: msg
 					};
 				}
-				validatedPort = portResult.value;
+			}
+			const errorMsg = options?.errors?.invalidFormat;
+			if (errorMsg) {
+				const msg = typeof errorMsg === "function" ? errorMsg(input) : errorMsg;
+				return {
+					success: false,
+					error: msg
+				};
+			}
+			if (hostOnlyResult !== void 0 && !hostOnlyResult.success) {
+				if (looksLikeIpv4(trimmed) || looksLikeAltIpv4Literal(trimmed)) return {
+					success: false,
+					error: hostOnlyResult.error
+				};
 			}
 			return {
-				success: true,
-				value: {
-					host: validatedHost,
-					port: validatedPort
-				}
+				success: false,
+				error: message`Expected a socket address in format host${separator}port, but got ${input}.`
 			};
 		},
 		format(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1470+e7499369",
+  "version": "1.0.0-dev.1492+3035da3f",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",