@optique/core 1.4.0-dev.2638 → 1.4.0-dev.2662

package/dist/modifiers.cjs

@@ -6,6 +6,7 @@ const require_internal_parser = require('./internal/parser.cjs');
 const require_annotation_state = require('./annotation-state.cjs');
 const require_execution_context = require('./execution-context.cjs');
 const require_short_option = require('./short-option.cjs');
+const require_passthrough = require('./internal/passthrough.cjs');
 const require_phase2_seed = require('./phase2-seed.cjs');
 const require_dependency_metadata = require('./dependency-metadata.cjs');
 
@@ -479,6 +480,11 @@ function optional(parser) {
 	require_internal_parser.defineParseLanes(optionalParser, adaptOptionalStyleParseLanes(parser));
 	require_internal_parser.defineInheritedAnnotationParser(optionalParser);
 	require_internal_parser.defineSourceBindingOnlyAnnotationCompletionParser(optionalParser);
+	require_passthrough.defineReachableChildren(optionalParser, [parser], (state) => [{
+		parser,
+		state: deriveOptionalInnerParseState(state, parser)
+	}]);
+	require_passthrough.defineKnownCompletionLookup(optionalParser, (state) => require_passthrough.getKnownCompletion(parser, deriveOptionalInnerParseState(state, parser)));
 	return fluent(require_short_option.scopeParser(optionalParser, require_short_option.combinedOptionScope([parser])));
 }
 /**
@@ -730,6 +736,11 @@ function withDefault(parser, defaultValue, options) {
 	require_internal_parser.defineParseLanes(withDefaultParser, adaptOptionalStyleParseLanes(parser));
 	require_internal_parser.defineInheritedAnnotationParser(withDefaultParser);
 	require_internal_parser.defineSourceBindingOnlyAnnotationCompletionParser(withDefaultParser);
+	require_passthrough.defineReachableChildren(withDefaultParser, [parser], (state) => [{
+		parser,
+		state: deriveOptionalInnerParseState(state, parser)
+	}]);
+	require_passthrough.defineKnownCompletionLookup(withDefaultParser, (state) => require_passthrough.getKnownCompletion(parser, deriveOptionalInnerParseState(state, parser)));
 	return fluent(require_short_option.scopeParser(withDefaultParser, require_short_option.combinedOptionScope([parser])));
 }
 /**
@@ -1188,12 +1199,28 @@ function multiple(parser, options = {}) {
 		parser,
 		state
 	}] : []);
+	const selectItems = (state) => {
+		const current = state.at(-1);
+		return [...current != null && !isTerminalMultipleItemState(current) ? [{
+			parser,
+			state: current,
+			index: state.length - 1,
+			fresh: false
+		}] : [], ...state.length < max ? [{
+			parser,
+			state: parser.initialState,
+			index: state.length,
+			fresh: true
+		}] : []];
+	};
 	const canExtendMultipleItem = (state, itemIndex, exec) => state != null && !isTerminalMultipleItemState(state) && (isMatchedCommandParserState(parser, state) || parser.canSkip?.(state, require_execution_context.withChildExecPath(exec, itemIndex)) !== true);
 	const parseSync = (context) => {
-		const currentItemState = context.state.at(-1);
-		const currentItemIndex = context.state.length - 1;
-		const canExtendCurrent = canExtendMultipleItem(currentItemState, currentItemIndex, context.exec);
-		const canOpenFreshItem = context.state.length < max;
+		const items = selectItems(context.state);
+		const current = items.find((item) => !item.fresh);
+		const fresh = items.find((item) => item.fresh);
+		const currentItemState = current?.state;
+		const canExtendCurrent = current != null && canExtendMultipleItem(current.state, current.index, context.exec);
+		const canOpenFreshItem = fresh != null;
 		if (!canExtendCurrent && !canOpenFreshItem) return {
 			success: true,
 			next: context,
@@ -1201,7 +1228,7 @@ function multiple(parser, options = {}) {
 		};
 		let added = !canExtendCurrent;
 		let itemIndex = canExtendCurrent ? context.state.length - 1 : context.state.length;
-		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : require_internal_annotations.inheritAnnotations(context.state, syncParser.initialState);
+		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : require_internal_annotations.inheritAnnotations(context.state, fresh?.state ?? parser.initialState);
 		let result = parseSyncWithUnwrappedFallback(require_execution_context.withChildContext(context, itemIndex, currentItemStateWithAnnotations));
 		if (!result.success) {
 			if (result.consumed !== 0) return result;
@@ -1271,10 +1298,12 @@ function multiple(parser, options = {}) {
 		};
 	};
 	const parseAsync = async (context) => {
-		const currentItemState = context.state.at(-1);
-		const currentItemIndex = context.state.length - 1;
-		const canExtendCurrent = canExtendMultipleItem(currentItemState, currentItemIndex, context.exec);
-		const canOpenFreshItem = context.state.length < max;
+		const items = selectItems(context.state);
+		const current = items.find((item) => !item.fresh);
+		const fresh = items.find((item) => item.fresh);
+		const currentItemState = current?.state;
+		const canExtendCurrent = current != null && canExtendMultipleItem(current.state, current.index, context.exec);
+		const canOpenFreshItem = fresh != null;
 		if (!canExtendCurrent && !canOpenFreshItem) return {
 			success: true,
 			next: context,
@@ -1282,7 +1311,7 @@ function multiple(parser, options = {}) {
 		};
 		let added = !canExtendCurrent;
 		let itemIndex = canExtendCurrent ? context.state.length - 1 : context.state.length;
-		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : require_internal_annotations.inheritAnnotations(context.state, parser.initialState);
+		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : require_internal_annotations.inheritAnnotations(context.state, fresh?.state ?? parser.initialState);
 		let result = await parseAsyncWithUnwrappedFallback(require_execution_context.withChildContext(context, itemIndex, currentItemStateWithAnnotations));
 		if (!result.success) {
 			if (result.consumed !== 0) return result;
@@ -1715,6 +1744,10 @@ function multiple(parser, options = {}) {
 			enumerable: false
 		});
 	}
+	require_passthrough.defineReachableChildren(resultParser, [parser], (state) => selectItems(state).map((item) => ({
+		parser,
+		state: unwrapInjectedWrapper(item.state)
+	})));
 	return fluent(require_short_option.scopeParser(resultParser, require_short_option.repeatedOptionScope(parser)));
 }
 /**
@@ -1851,6 +1884,10 @@ function nonEmpty(parser) {
 		enumerable: false
 	});
 	require_dependency_runtime.defineForwardedEffectfulSchedulingNodes(nonEmptyParser, parser);
+	require_passthrough.defineReachableChildren(nonEmptyParser, [parser], (state) => [{
+		parser,
+		state
+	}]);
 	return fluent(require_short_option.scopeParser(nonEmptyParser, require_short_option.combinedOptionScope([parser])));
 }
 const fluentParserMarker = Symbol.for("@optique/core/fluent");

package/dist/modifiers.js

@@ -6,6 +6,7 @@ import { defineInheritedAnnotationParser, defineParseLanes, defineSourceBindingO
 import { getDelegatedAnnotationState, hasDelegatedAnnotationCarrier, isAnnotationWrappedInitialState, normalizeDelegatedAnnotationState, normalizeNestedDelegatedAnnotationState } from "./annotation-state.js";
 import { mergeChildExec, withChildContext, withChildExecPath } from "./execution-context.js";
 import { combinedOptionScope, repeatedOptionScope, scopeParser } from "./short-option.js";
+import { defineKnownCompletionLookup, defineReachableChildren, getKnownCompletion } from "./internal/passthrough.js";
 import { completeOrExtractPhase2Seed, extractPhase2Seed, extractPhase2SeedKey, phase2SeedFromValueResult } from "./phase2-seed.js";
 import { composeDependencyMetadata } from "./dependency-metadata.js";
 
@@ -479,6 +480,11 @@ function optional(parser) {
 	defineParseLanes(optionalParser, adaptOptionalStyleParseLanes(parser));
 	defineInheritedAnnotationParser(optionalParser);
 	defineSourceBindingOnlyAnnotationCompletionParser(optionalParser);
+	defineReachableChildren(optionalParser, [parser], (state) => [{
+		parser,
+		state: deriveOptionalInnerParseState(state, parser)
+	}]);
+	defineKnownCompletionLookup(optionalParser, (state) => getKnownCompletion(parser, deriveOptionalInnerParseState(state, parser)));
 	return fluent(scopeParser(optionalParser, combinedOptionScope([parser])));
 }
 /**
@@ -730,6 +736,11 @@ function withDefault(parser, defaultValue, options) {
 	defineParseLanes(withDefaultParser, adaptOptionalStyleParseLanes(parser));
 	defineInheritedAnnotationParser(withDefaultParser);
 	defineSourceBindingOnlyAnnotationCompletionParser(withDefaultParser);
+	defineReachableChildren(withDefaultParser, [parser], (state) => [{
+		parser,
+		state: deriveOptionalInnerParseState(state, parser)
+	}]);
+	defineKnownCompletionLookup(withDefaultParser, (state) => getKnownCompletion(parser, deriveOptionalInnerParseState(state, parser)));
 	return fluent(scopeParser(withDefaultParser, combinedOptionScope([parser])));
 }
 /**
@@ -1188,12 +1199,28 @@ function multiple(parser, options = {}) {
 		parser,
 		state
 	}] : []);
+	const selectItems = (state) => {
+		const current = state.at(-1);
+		return [...current != null && !isTerminalMultipleItemState(current) ? [{
+			parser,
+			state: current,
+			index: state.length - 1,
+			fresh: false
+		}] : [], ...state.length < max ? [{
+			parser,
+			state: parser.initialState,
+			index: state.length,
+			fresh: true
+		}] : []];
+	};
 	const canExtendMultipleItem = (state, itemIndex, exec) => state != null && !isTerminalMultipleItemState(state) && (isMatchedCommandParserState(parser, state) || parser.canSkip?.(state, withChildExecPath(exec, itemIndex)) !== true);
 	const parseSync = (context) => {
-		const currentItemState = context.state.at(-1);
-		const currentItemIndex = context.state.length - 1;
-		const canExtendCurrent = canExtendMultipleItem(currentItemState, currentItemIndex, context.exec);
-		const canOpenFreshItem = context.state.length < max;
+		const items = selectItems(context.state);
+		const current = items.find((item) => !item.fresh);
+		const fresh = items.find((item) => item.fresh);
+		const currentItemState = current?.state;
+		const canExtendCurrent = current != null && canExtendMultipleItem(current.state, current.index, context.exec);
+		const canOpenFreshItem = fresh != null;
 		if (!canExtendCurrent && !canOpenFreshItem) return {
 			success: true,
 			next: context,
@@ -1201,7 +1228,7 @@ function multiple(parser, options = {}) {
 		};
 		let added = !canExtendCurrent;
 		let itemIndex = canExtendCurrent ? context.state.length - 1 : context.state.length;
-		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : inheritAnnotations(context.state, syncParser.initialState);
+		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : inheritAnnotations(context.state, fresh?.state ?? parser.initialState);
 		let result = parseSyncWithUnwrappedFallback(withChildContext(context, itemIndex, currentItemStateWithAnnotations));
 		if (!result.success) {
 			if (result.consumed !== 0) return result;
@@ -1271,10 +1298,12 @@ function multiple(parser, options = {}) {
 		};
 	};
 	const parseAsync = async (context) => {
-		const currentItemState = context.state.at(-1);
-		const currentItemIndex = context.state.length - 1;
-		const canExtendCurrent = canExtendMultipleItem(currentItemState, currentItemIndex, context.exec);
-		const canOpenFreshItem = context.state.length < max;
+		const items = selectItems(context.state);
+		const current = items.find((item) => !item.fresh);
+		const fresh = items.find((item) => item.fresh);
+		const currentItemState = current?.state;
+		const canExtendCurrent = current != null && canExtendMultipleItem(current.state, current.index, context.exec);
+		const canOpenFreshItem = fresh != null;
 		if (!canExtendCurrent && !canOpenFreshItem) return {
 			success: true,
 			next: context,
@@ -1282,7 +1311,7 @@ function multiple(parser, options = {}) {
 		};
 		let added = !canExtendCurrent;
 		let itemIndex = canExtendCurrent ? context.state.length - 1 : context.state.length;
-		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : inheritAnnotations(context.state, parser.initialState);
+		const currentItemStateWithAnnotations = canExtendCurrent ? currentItemState : inheritAnnotations(context.state, fresh?.state ?? parser.initialState);
 		let result = await parseAsyncWithUnwrappedFallback(withChildContext(context, itemIndex, currentItemStateWithAnnotations));
 		if (!result.success) {
 			if (result.consumed !== 0) return result;
@@ -1715,6 +1744,10 @@ function multiple(parser, options = {}) {
 			enumerable: false
 		});
 	}
+	defineReachableChildren(resultParser, [parser], (state) => selectItems(state).map((item) => ({
+		parser,
+		state: unwrapInjectedWrapper(item.state)
+	})));
 	return fluent(scopeParser(resultParser, repeatedOptionScope(parser)));
 }
 /**
@@ -1851,6 +1884,10 @@ function nonEmpty(parser) {
 		enumerable: false
 	});
 	defineForwardedEffectfulSchedulingNodes(nonEmptyParser, parser);
+	defineReachableChildren(nonEmptyParser, [parser], (state) => [{
+		parser,
+		state
+	}]);
 	return fluent(scopeParser(nonEmptyParser, combinedOptionScope([parser])));
 }
 const fluentParserMarker = Symbol.for("@optique/core/fluent");

package/dist/primitives.cjs

@@ -9,6 +9,7 @@ const require_annotation_state = require('./annotation-state.cjs');
 const require_execution_context = require('./execution-context.cjs');
 const require_usage_internals = require('./usage-internals.cjs');
 const require_short_option = require('./short-option.cjs');
+const require_passthrough = require('./internal/passthrough.cjs');
 const require_command_alias = require('./internal/command-alias.cjs');
 const require_phase2_seed = require('./phase2-seed.cjs');
 const require_dependency_metadata = require('./dependency-metadata.cjs');
@@ -155,6 +156,7 @@ function constant(value) {
 			};
 		}
 	};
+	require_passthrough.defineKnownCompletion(result, (state) => require_annotation_state.normalizeInjectedAnnotationState(state));
 	Object.defineProperty(result, "placeholder", {
 		value,
 		configurable: true,
@@ -633,10 +635,15 @@ function option(...args) {
 			}
 			const invalidOption = context.buffer[0];
 			if (options.errors?.noMatch) {
+				if (typeof options.errors.noMatch !== "function") return {
+					success: false,
+					consumed: 0,
+					error: options.errors.noMatch
+				};
 				const candidates = /* @__PURE__ */ new Set();
 				for (const name of require_usage.extractOptionNames(context.usage)) candidates.add(name);
 				const suggestions = require_suggestion.findSimilar(invalidOption, candidates, require_suggestion.DEFAULT_FIND_SIMILAR_OPTIONS);
-				const errorMessage = typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch;
+				const errorMessage = options.errors.noMatch(invalidOption, suggestions);
 				return {
 					success: false,
 					consumed: 0,
@@ -922,10 +929,15 @@ function flag(...args) {
 			}
 			const invalidOption = context.buffer[0];
 			if (options.errors?.noMatch) {
+				if (typeof options.errors.noMatch !== "function") return {
+					success: false,
+					consumed: 0,
+					error: options.errors.noMatch
+				};
 				const candidates = /* @__PURE__ */ new Set();
 				for (const name of require_usage.extractOptionNames(context.usage)) candidates.add(name);
 				const suggestions = require_suggestion.findSimilar(invalidOption, candidates, require_suggestion.DEFAULT_FIND_SIMILAR_OPTIONS);
-				const errorMessage = typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch;
+				const errorMessage = options.errors.noMatch(invalidOption, suggestions);
 				return {
 					success: false,
 					consumed: 0,
@@ -1234,7 +1246,7 @@ function argument(valueParser, options = {}) {
 	const syncValueParser = valueParser;
 	const dependencyMetadata = require_dependency_metadata.extractDependencyMetadata(valueParser);
 	const formatInvalidValueError = (error) => options.errors?.invalidValue ? typeof options.errors.invalidValue === "function" ? options.errors.invalidValue(error) : options.errors.invalidValue : require_message.message`${require_message.metavar(valueParser.metavar)}: ${error}`;
-	const optionPattern = /^--?[a-z0-9-]+$/i;
+	const optionPattern = /^(?!--=)(--?[a-z0-9-]+)(?:=|$)/i;
 	const term = {
 		type: "argument",
 		metavar: valueParser.metavar,
@@ -1261,14 +1273,15 @@ function argument(valueParser, options = {}) {
 			};
 			let i = 0;
 			let optionsTerminated = context.optionsTerminated;
-			if (!optionsTerminated) {
-				if (context.buffer[i] === "--") {
-					optionsTerminated = true;
-					i++;
-				} else if (context.buffer[i].match(optionPattern)) return {
+			if (!optionsTerminated) if (context.buffer[i] === "--") {
+				optionsTerminated = true;
+				i++;
+			} else {
+				const optionMatch = context.buffer[i].match(optionPattern);
+				if (optionMatch != null) return {
 					success: false,
 					consumed: i,
-					error: require_message.message`Expected an argument, but got an option: ${require_message.optionName(context.buffer[i])}.`
+					error: require_message.message`Expected an argument, but got an option: ${require_message.optionName(optionMatch[1])}.`
 				};
 			}
 			if (context.buffer.length < i + 1) return {
@@ -1531,6 +1544,15 @@ function command(name, parser, options = {}) {
 	const isAsync = parser.mode === "async";
 	const syncInnerParser = parser;
 	const asyncInnerParser = parser;
+	const getChildState = (state, active) => getCommandParseChildState(state, active[0] === "matched" ? parser.initialState : active[1], parser);
+	const selectChild = (state) => {
+		const active = normalizeCommandState(state);
+		return active == null ? void 0 : {
+			parser,
+			state: getChildState(state, active),
+			continuesCommand: true
+		};
+	};
 	const commandScope = require_short_option.selectableOptionScope(() => /* @__PURE__ */ new Set());
 	const enteredScope = require_short_option.combinedOptionScope([parser], [name]);
 	const result = {
@@ -1612,7 +1634,7 @@ function command(name, parser, options = {}) {
 					consumed: context.buffer.slice(0, 1)
 				};
 			} else if (state[0] === "matched" || state[0] === "parsing") {
-				const innerState = state[0] === "matched" ? getCommandParseChildState(context.state, parser.initialState, parser) : getCommandParseChildState(context.state, state[1], parser);
+				const innerState = getChildState(context.state, state);
 				const wrapState = (parseResult) => {
 					if (parseResult.success) {
 						const mergedExec = require_execution_context.mergeChildExec(context.exec, parseResult.next.exec);
@@ -1781,6 +1803,10 @@ function command(name, parser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	require_passthrough.defineReachableChildren(result, [parser], (state) => {
+		const child = selectChild(state);
+		return child == null ? [] : [child];
+	});
 	return require_modifiers.fluent(require_short_option.scopeParser(result, commandScope.source, (context) => {
 		if (normalizeCommandState(context.state) != null) commandScope.select(context, enteredScope);
 	}));
@@ -1856,6 +1882,8 @@ function passThrough(options = {}) {
 				consumed: 0,
 				error: require_message.message`No input to pass through.`
 			};
+			const failure = require_passthrough.getPassThroughFailure(context, this?.priority ?? -10);
+			if (failure != null) return failure.failure;
 			const token = context.buffer[0];
 			if (format === "greedy") {
 				const captured = [...context.buffer];
@@ -1967,6 +1995,11 @@ function passThrough(options = {}) {
 			return `passThrough(${format})`;
 		}
 	};
+	require_passthrough.definePassThroughPriority(result, [result], (_state, token) => {
+		if (token == null || format === "greedy") return result.priority;
+		const accepts = format === "equalsOnly" ? equalsOptionPattern.test(token) : format === "nextToken" && optionPattern.test(token);
+		return accepts ? result.priority : void 0;
+	});
 	return require_modifiers.fluent(result);
 }
 

package/dist/primitives.js

@@ -9,6 +9,7 @@ import { getWrappedChildParseState, getWrappedChildState, isAnnotationWrappedIni
 import { mergeChildExec, withChildContext, withChildExecPath } from "./execution-context.js";
 import { extractLeadingCommandNames } from "./usage-internals.js";
 import { attachedValuePrefix, combinedOptionScope, fullNameOwnsToken, prefixSuggestion, scopeParser, selectableOptionScope } from "./short-option.js";
+import { defineKnownCompletion, definePassThroughPriority, defineReachableChildren, getPassThroughFailure } from "./internal/passthrough.js";
 import { hiddenCommandAliasesKey } from "./internal/command-alias.js";
 import { completeOrExtractPhase2Seed, extractPhase2SeedKey } from "./phase2-seed.js";
 import { extractDependencyMetadata } from "./dependency-metadata.js";
@@ -155,6 +156,7 @@ function constant(value) {
 			};
 		}
 	};
+	defineKnownCompletion(result, (state) => normalizeInjectedAnnotationState(state));
 	Object.defineProperty(result, "placeholder", {
 		value,
 		configurable: true,
@@ -633,10 +635,15 @@ function option(...args) {
 			}
 			const invalidOption = context.buffer[0];
 			if (options.errors?.noMatch) {
+				if (typeof options.errors.noMatch !== "function") return {
+					success: false,
+					consumed: 0,
+					error: options.errors.noMatch
+				};
 				const candidates = /* @__PURE__ */ new Set();
 				for (const name of extractOptionNames(context.usage)) candidates.add(name);
 				const suggestions = findSimilar(invalidOption, candidates, DEFAULT_FIND_SIMILAR_OPTIONS);
-				const errorMessage = typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch;
+				const errorMessage = options.errors.noMatch(invalidOption, suggestions);
 				return {
 					success: false,
 					consumed: 0,
@@ -922,10 +929,15 @@ function flag(...args) {
 			}
 			const invalidOption = context.buffer[0];
 			if (options.errors?.noMatch) {
+				if (typeof options.errors.noMatch !== "function") return {
+					success: false,
+					consumed: 0,
+					error: options.errors.noMatch
+				};
 				const candidates = /* @__PURE__ */ new Set();
 				for (const name of extractOptionNames(context.usage)) candidates.add(name);
 				const suggestions = findSimilar(invalidOption, candidates, DEFAULT_FIND_SIMILAR_OPTIONS);
-				const errorMessage = typeof options.errors.noMatch === "function" ? options.errors.noMatch(invalidOption, suggestions) : options.errors.noMatch;
+				const errorMessage = options.errors.noMatch(invalidOption, suggestions);
 				return {
 					success: false,
 					consumed: 0,
@@ -1234,7 +1246,7 @@ function argument(valueParser, options = {}) {
 	const syncValueParser = valueParser;
 	const dependencyMetadata = extractDependencyMetadata(valueParser);
 	const formatInvalidValueError = (error) => options.errors?.invalidValue ? typeof options.errors.invalidValue === "function" ? options.errors.invalidValue(error) : options.errors.invalidValue : message`${metavar(valueParser.metavar)}: ${error}`;
-	const optionPattern = /^--?[a-z0-9-]+$/i;
+	const optionPattern = /^(?!--=)(--?[a-z0-9-]+)(?:=|$)/i;
 	const term = {
 		type: "argument",
 		metavar: valueParser.metavar,
@@ -1261,14 +1273,15 @@ function argument(valueParser, options = {}) {
 			};
 			let i = 0;
 			let optionsTerminated = context.optionsTerminated;
-			if (!optionsTerminated) {
-				if (context.buffer[i] === "--") {
-					optionsTerminated = true;
-					i++;
-				} else if (context.buffer[i].match(optionPattern)) return {
+			if (!optionsTerminated) if (context.buffer[i] === "--") {
+				optionsTerminated = true;
+				i++;
+			} else {
+				const optionMatch = context.buffer[i].match(optionPattern);
+				if (optionMatch != null) return {
 					success: false,
 					consumed: i,
-					error: message`Expected an argument, but got an option: ${optionName(context.buffer[i])}.`
+					error: message`Expected an argument, but got an option: ${optionName(optionMatch[1])}.`
 				};
 			}
 			if (context.buffer.length < i + 1) return {
@@ -1531,6 +1544,15 @@ function command(name, parser, options = {}) {
 	const isAsync = parser.mode === "async";
 	const syncInnerParser = parser;
 	const asyncInnerParser = parser;
+	const getChildState = (state, active) => getCommandParseChildState(state, active[0] === "matched" ? parser.initialState : active[1], parser);
+	const selectChild = (state) => {
+		const active = normalizeCommandState(state);
+		return active == null ? void 0 : {
+			parser,
+			state: getChildState(state, active),
+			continuesCommand: true
+		};
+	};
 	const commandScope = selectableOptionScope(() => /* @__PURE__ */ new Set());
 	const enteredScope = combinedOptionScope([parser], [name]);
 	const result = {
@@ -1612,7 +1634,7 @@ function command(name, parser, options = {}) {
 					consumed: context.buffer.slice(0, 1)
 				};
 			} else if (state[0] === "matched" || state[0] === "parsing") {
-				const innerState = state[0] === "matched" ? getCommandParseChildState(context.state, parser.initialState, parser) : getCommandParseChildState(context.state, state[1], parser);
+				const innerState = getChildState(context.state, state);
 				const wrapState = (parseResult) => {
 					if (parseResult.success) {
 						const mergedExec = mergeChildExec(context.exec, parseResult.next.exec);
@@ -1781,6 +1803,10 @@ function command(name, parser, options = {}) {
 		configurable: true,
 		enumerable: false
 	});
+	defineReachableChildren(result, [parser], (state) => {
+		const child = selectChild(state);
+		return child == null ? [] : [child];
+	});
 	return fluent(scopeParser(result, commandScope.source, (context) => {
 		if (normalizeCommandState(context.state) != null) commandScope.select(context, enteredScope);
 	}));
@@ -1856,6 +1882,8 @@ function passThrough(options = {}) {
 				consumed: 0,
 				error: message`No input to pass through.`
 			};
+			const failure = getPassThroughFailure(context, this?.priority ?? -10);
+			if (failure != null) return failure.failure;
 			const token = context.buffer[0];
 			if (format === "greedy") {
 				const captured = [...context.buffer];
@@ -1967,6 +1995,11 @@ function passThrough(options = {}) {
 			return `passThrough(${format})`;
 		}
 	};
+	definePassThroughPriority(result, [result], (_state, token) => {
+		if (token == null || format === "greedy") return result.priority;
+		const accepts = format === "equalsOnly" ? equalsOptionPattern.test(token) : format === "nextToken" && optionPattern.test(token);
+		return accepts ? result.priority : void 0;
+	});
 	return fluent(result);
 }
 

package/dist/suggestion.cjs

@@ -86,8 +86,10 @@ function findSimilar(input, candidates, options = {}) {
 		const normalizedCandidate = caseSensitive ? candidate : candidate.toLowerCase();
 		if (seen.has(candidate)) continue;
 		seen.add(candidate);
+		if (normalizedInput === normalizedCandidate) return [candidate];
+		const minimumDistance = Math.abs(normalizedInput.length - normalizedCandidate.length);
+		if (minimumDistance > maxDistance || minimumDistance / input.length > maxDistanceRatio) continue;
 		const distance = levenshteinDistance(normalizedInput, normalizedCandidate);
-		if (distance === 0) return [candidate];
 		const distanceRatio = distance / input.length;
 		if (distance <= maxDistance && distanceRatio <= maxDistanceRatio) matches.push({
 			candidate,

package/dist/suggestion.js

@@ -86,8 +86,10 @@ function findSimilar(input, candidates, options = {}) {
 		const normalizedCandidate = caseSensitive ? candidate : candidate.toLowerCase();
 		if (seen.has(candidate)) continue;
 		seen.add(candidate);
+		if (normalizedInput === normalizedCandidate) return [candidate];
+		const minimumDistance = Math.abs(normalizedInput.length - normalizedCandidate.length);
+		if (minimumDistance > maxDistance || minimumDistance / input.length > maxDistanceRatio) continue;
 		const distance = levenshteinDistance(normalizedInput, normalizedCandidate);
-		if (distance === 0) return [candidate];
 		const distanceRatio = distance / input.length;
 		if (distance <= maxDistance && distanceRatio <= maxDistanceRatio) matches.push({
 			candidate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.4.0-dev.2638",
+  "version": "1.4.0-dev.2662",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -237,7 +237,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.4.0-dev.2638+75cb8142",
+    "@optique/env": "1.4.0-dev.2662+8add1ff9",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",