@optique/core 1.0.0-dev.1658 → 1.0.0-dev.1661

package/dist/parser.cjs

@@ -24,6 +24,26 @@ const require_constructs = require('./constructs.cjs');
 */
 const unmatchedNonCliDependencySourceStateMarker = Symbol.for("@optique/core/parser/unmatchedNonCliDependencySourceStateMarker");
 /**
+* Internal marker for parsers that want parent-state annotations injected
+* directly into rebuilt child states instead of relying on structural
+* inheritance.
+*
+* Wrappers like `bindConfig()`, `bindEnv()`, and `prompt()` opt in because
+* their fallback contracts depend on carrying annotations through wrapper
+* state objects during parse, complete, and suggest.
+*
+* @internal
+*/
+const inheritParentAnnotationsKey = Symbol.for("@optique/core/inheritParentAnnotations");
+/**
+* Internal marker for wrapper parsers that should only treat annotation-only
+* primitive wrapper states as completable when a nested source-binding wrapper
+* produced them.
+*
+* @internal
+*/
+const annotationWrapperRequiresSourceBindingKey = Symbol.for("@optique/core/annotationWrapperRequiresSourceBinding");
+/**
 * Creates a {@link ParserContext} from a {@link ParseFrame} and an
 * {@link ExecutionContext}.  The returned object provides both structured
 * access (`frame`, `exec`) and flat access (`buffer`, `state`, etc.)
@@ -336,6 +356,66 @@ function getParserSuggestRuntimeNodes(parser, state, path) {
 	}];
 }
 /**
+* Returns wrapper-aware suggest-time runtime nodes for parsers that delegate
+* to an inner parser while also exposing their own source metadata.
+*
+* The inner parser's nodes are always preserved so nested wrappers and
+* constructs can continue to seed the dependency runtime recursively. When
+* the outer parser itself owns source metadata, its `(path, parser, state)`
+* node is appended so outer precedence rules still apply.
+*
+* @internal
+*/
+function getDelegatingSuggestRuntimeNodes(innerParser, outerParser, state, path, innerState, outerPosition = "append") {
+	const innerNodes = getParserSuggestRuntimeNodes(innerParser, innerState, path);
+	if (outerParser.dependencyMetadata?.source == null) return innerNodes;
+	const outerNode = {
+		path,
+		parser: outerParser,
+		state
+	};
+	return outerPosition === "prepend" ? [outerNode, ...innerNodes] : [...innerNodes, outerNode];
+}
+/**
+* Composes source metadata for a wrapper parser while preserving any derived
+* or transform capabilities from the inner parser unchanged.
+*
+* @internal
+*/
+function composeWrappedSourceMetadata(dependencyMetadata, wrapSource) {
+	if (dependencyMetadata?.source == null) return dependencyMetadata;
+	return {
+		...dependencyMetadata,
+		source: wrapSource(dependencyMetadata.source)
+	};
+}
+/**
+* Marks a parser as inheriting parent-state annotations through wrapper-state
+* reconstruction.
+*
+* @internal
+*/
+function defineInheritedAnnotationParser(parser) {
+	Object.defineProperty(parser, inheritParentAnnotationsKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+}
+/**
+* Marks a wrapper parser as requiring a real source-binding state before
+* annotation-only primitive wrappers should trigger completion.
+*
+* @internal
+*/
+function defineSourceBindingOnlyAnnotationCompletionParser(parser) {
+	Object.defineProperty(parser, annotationWrapperRequiresSourceBindingKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+}
+/**
 * Generates command-line suggestions based on current parsing state.
 * This function processes the input arguments up to the last argument,
 * then calls the parser's suggest method with the remaining prefix.
@@ -624,19 +704,25 @@ function buildDocPage(parser, context, args) {
 //#endregion
 exports.DuplicateOptionError = require_constructs.DuplicateOptionError;
 exports.WithDefaultError = require_modifiers.WithDefaultError;
+exports.annotationWrapperRequiresSourceBindingKey = annotationWrapperRequiresSourceBindingKey;
 exports.argument = require_primitives.argument;
 exports.command = require_primitives.command;
+exports.composeWrappedSourceMetadata = composeWrappedSourceMetadata;
 exports.concat = require_constructs.concat;
 exports.conditional = require_constructs.conditional;
 exports.constant = require_primitives.constant;
 exports.createParserContext = createParserContext;
+exports.defineInheritedAnnotationParser = defineInheritedAnnotationParser;
+exports.defineSourceBindingOnlyAnnotationCompletionParser = defineSourceBindingOnlyAnnotationCompletionParser;
 exports.fail = require_primitives.fail;
 exports.flag = require_primitives.flag;
+exports.getDelegatingSuggestRuntimeNodes = getDelegatingSuggestRuntimeNodes;
 exports.getDocPage = getDocPage;
 exports.getDocPageAsync = getDocPageAsync;
 exports.getDocPageSync = getDocPageSync;
 exports.getParserSuggestRuntimeNodes = getParserSuggestRuntimeNodes;
 exports.group = require_constructs.group;
+exports.inheritParentAnnotationsKey = inheritParentAnnotationsKey;
 exports.longestMatch = require_constructs.longestMatch;
 exports.map = require_modifiers.map;
 exports.merge = require_constructs.merge;

package/dist/parser.d.cts

@@ -399,6 +399,26 @@ interface ExecutionContext {
  * @internal
  */
 declare const unmatchedNonCliDependencySourceStateMarker: unique symbol;
+/**
+ * Internal marker for parsers that want parent-state annotations injected
+ * directly into rebuilt child states instead of relying on structural
+ * inheritance.
+ *
+ * Wrappers like `bindConfig()`, `bindEnv()`, and `prompt()` opt in because
+ * their fallback contracts depend on carrying annotations through wrapper
+ * state objects during parse, complete, and suggest.
+ *
+ * @internal
+ */
+declare const inheritParentAnnotationsKey: unique symbol;
+/**
+ * Internal marker for wrapper parsers that should only treat annotation-only
+ * primitive wrapper states as completable when a nested source-binding wrapper
+ * produced them.
+ *
+ * @internal
+ */
+declare const annotationWrapperRequiresSourceBindingKey: unique symbol;
 /**
  * The context of the parser, which includes the input buffer and the state.
  *
@@ -722,6 +742,39 @@ declare function suggestSync<T>(parser: Parser<"sync", T, unknown>, args: readon
  * @internal
  */
 declare function getParserSuggestRuntimeNodes<TState>(parser: Parser<Mode, unknown, TState>, state: TState, path: readonly PropertyKey[]): readonly RuntimeNode[];
+/**
+ * Returns wrapper-aware suggest-time runtime nodes for parsers that delegate
+ * to an inner parser while also exposing their own source metadata.
+ *
+ * The inner parser's nodes are always preserved so nested wrappers and
+ * constructs can continue to seed the dependency runtime recursively. When
+ * the outer parser itself owns source metadata, its `(path, parser, state)`
+ * node is appended so outer precedence rules still apply.
+ *
+ * @internal
+ */
+declare function getDelegatingSuggestRuntimeNodes<TInnerState>(innerParser: Parser<Mode, unknown, TInnerState>, outerParser: Parser<Mode, unknown, unknown>, state: unknown, path: readonly PropertyKey[], innerState: TInnerState, outerPosition?: "append" | "prepend"): readonly RuntimeNode[];
+/**
+ * Composes source metadata for a wrapper parser while preserving any derived
+ * or transform capabilities from the inner parser unchanged.
+ *
+ * @internal
+ */
+declare function composeWrappedSourceMetadata(dependencyMetadata: ParserDependencyMetadata | undefined, wrapSource: (source: NonNullable<ParserDependencyMetadata["source"]>) => NonNullable<ParserDependencyMetadata["source"]>): ParserDependencyMetadata | undefined;
+/**
+ * Marks a parser as inheriting parent-state annotations through wrapper-state
+ * reconstruction.
+ *
+ * @internal
+ */
+declare function defineInheritedAnnotationParser(parser: object): void;
+/**
+ * Marks a wrapper parser as requiring a real source-binding state before
+ * annotation-only primitive wrappers should trigger completion.
+ *
+ * @internal
+ */
+declare function defineSourceBindingOnlyAnnotationCompletionParser(parser: object): void;
 /**
  * Generates command-line suggestions based on current parsing state.
  * This function processes the input arguments up to the last argument,
@@ -856,4 +909,4 @@ declare function getDocPage(parser: Parser<"sync", unknown, unknown>, argsOrOpti
 declare function getDocPage(parser: Parser<"async", unknown, unknown>, argsOrOptions?: readonly string[] | ParseOptions, options?: ParseOptions): Promise<DocPage | undefined>;
 declare function getDocPage<M extends Mode>(parser: Parser<M, unknown, unknown>, argsOrOptions?: readonly string[] | ParseOptions, options?: ParseOptions): ModeValue<M, DocPage | undefined>;
 //#endregion
-export { ArgumentErrorOptions, ArgumentOptions, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocState, DuplicateOptionError, ExecutionContext, ExecutionPhase, FlagErrorOptions, FlagOptions, GroupOptions, InferMode, InferValue, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, Suggestion, TupleOptions, WithDefaultError, WithDefaultOptions, argument, command, concat, conditional, constant, createParserContext, fail, flag, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };
+export { ArgumentErrorOptions, ArgumentOptions, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocState, DuplicateOptionError, ExecutionContext, ExecutionPhase, FlagErrorOptions, FlagOptions, GroupOptions, InferMode, InferValue, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, Suggestion, TupleOptions, WithDefaultError, WithDefaultOptions, annotationWrapperRequiresSourceBindingKey, argument, command, composeWrappedSourceMetadata, concat, conditional, constant, createParserContext, defineInheritedAnnotationParser, defineSourceBindingOnlyAnnotationCompletionParser, fail, flag, getDelegatingSuggestRuntimeNodes, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, inheritParentAnnotationsKey, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };

package/dist/parser.d.ts

@@ -399,6 +399,26 @@ interface ExecutionContext {
  * @internal
  */
 declare const unmatchedNonCliDependencySourceStateMarker: unique symbol;
+/**
+ * Internal marker for parsers that want parent-state annotations injected
+ * directly into rebuilt child states instead of relying on structural
+ * inheritance.
+ *
+ * Wrappers like `bindConfig()`, `bindEnv()`, and `prompt()` opt in because
+ * their fallback contracts depend on carrying annotations through wrapper
+ * state objects during parse, complete, and suggest.
+ *
+ * @internal
+ */
+declare const inheritParentAnnotationsKey: unique symbol;
+/**
+ * Internal marker for wrapper parsers that should only treat annotation-only
+ * primitive wrapper states as completable when a nested source-binding wrapper
+ * produced them.
+ *
+ * @internal
+ */
+declare const annotationWrapperRequiresSourceBindingKey: unique symbol;
 /**
  * The context of the parser, which includes the input buffer and the state.
  *
@@ -722,6 +742,39 @@ declare function suggestSync<T>(parser: Parser<"sync", T, unknown>, args: readon
  * @internal
  */
 declare function getParserSuggestRuntimeNodes<TState>(parser: Parser<Mode, unknown, TState>, state: TState, path: readonly PropertyKey[]): readonly RuntimeNode[];
+/**
+ * Returns wrapper-aware suggest-time runtime nodes for parsers that delegate
+ * to an inner parser while also exposing their own source metadata.
+ *
+ * The inner parser's nodes are always preserved so nested wrappers and
+ * constructs can continue to seed the dependency runtime recursively. When
+ * the outer parser itself owns source metadata, its `(path, parser, state)`
+ * node is appended so outer precedence rules still apply.
+ *
+ * @internal
+ */
+declare function getDelegatingSuggestRuntimeNodes<TInnerState>(innerParser: Parser<Mode, unknown, TInnerState>, outerParser: Parser<Mode, unknown, unknown>, state: unknown, path: readonly PropertyKey[], innerState: TInnerState, outerPosition?: "append" | "prepend"): readonly RuntimeNode[];
+/**
+ * Composes source metadata for a wrapper parser while preserving any derived
+ * or transform capabilities from the inner parser unchanged.
+ *
+ * @internal
+ */
+declare function composeWrappedSourceMetadata(dependencyMetadata: ParserDependencyMetadata | undefined, wrapSource: (source: NonNullable<ParserDependencyMetadata["source"]>) => NonNullable<ParserDependencyMetadata["source"]>): ParserDependencyMetadata | undefined;
+/**
+ * Marks a parser as inheriting parent-state annotations through wrapper-state
+ * reconstruction.
+ *
+ * @internal
+ */
+declare function defineInheritedAnnotationParser(parser: object): void;
+/**
+ * Marks a wrapper parser as requiring a real source-binding state before
+ * annotation-only primitive wrappers should trigger completion.
+ *
+ * @internal
+ */
+declare function defineSourceBindingOnlyAnnotationCompletionParser(parser: object): void;
 /**
  * Generates command-line suggestions based on current parsing state.
  * This function processes the input arguments up to the last argument,
@@ -856,4 +909,4 @@ declare function getDocPage(parser: Parser<"sync", unknown, unknown>, argsOrOpti
 declare function getDocPage(parser: Parser<"async", unknown, unknown>, argsOrOptions?: readonly string[] | ParseOptions, options?: ParseOptions): Promise<DocPage | undefined>;
 declare function getDocPage<M extends Mode>(parser: Parser<M, unknown, unknown>, argsOrOptions?: readonly string[] | ParseOptions, options?: ParseOptions): ModeValue<M, DocPage | undefined>;
 //#endregion
-export { ArgumentErrorOptions, ArgumentOptions, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocState, DuplicateOptionError, ExecutionContext, ExecutionPhase, FlagErrorOptions, FlagOptions, GroupOptions, InferMode, InferValue, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, Suggestion, TupleOptions, WithDefaultError, WithDefaultOptions, argument, command, concat, conditional, constant, createParserContext, fail, flag, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };
+export { ArgumentErrorOptions, ArgumentOptions, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocState, DuplicateOptionError, ExecutionContext, ExecutionPhase, FlagErrorOptions, FlagOptions, GroupOptions, InferMode, InferValue, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionOptions, OptionState, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, Suggestion, TupleOptions, WithDefaultError, WithDefaultOptions, annotationWrapperRequiresSourceBindingKey, argument, command, composeWrappedSourceMetadata, concat, conditional, constant, createParserContext, defineInheritedAnnotationParser, defineSourceBindingOnlyAnnotationCompletionParser, fail, flag, getDelegatingSuggestRuntimeNodes, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, inheritParentAnnotationsKey, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };

package/dist/parser.js

@@ -24,6 +24,26 @@ import { DuplicateOptionError, concat, conditional, group, longestMatch, merge,
 */
 const unmatchedNonCliDependencySourceStateMarker = Symbol.for("@optique/core/parser/unmatchedNonCliDependencySourceStateMarker");
 /**
+* Internal marker for parsers that want parent-state annotations injected
+* directly into rebuilt child states instead of relying on structural
+* inheritance.
+*
+* Wrappers like `bindConfig()`, `bindEnv()`, and `prompt()` opt in because
+* their fallback contracts depend on carrying annotations through wrapper
+* state objects during parse, complete, and suggest.
+*
+* @internal
+*/
+const inheritParentAnnotationsKey = Symbol.for("@optique/core/inheritParentAnnotations");
+/**
+* Internal marker for wrapper parsers that should only treat annotation-only
+* primitive wrapper states as completable when a nested source-binding wrapper
+* produced them.
+*
+* @internal
+*/
+const annotationWrapperRequiresSourceBindingKey = Symbol.for("@optique/core/annotationWrapperRequiresSourceBinding");
+/**
 * Creates a {@link ParserContext} from a {@link ParseFrame} and an
 * {@link ExecutionContext}.  The returned object provides both structured
 * access (`frame`, `exec`) and flat access (`buffer`, `state`, etc.)
@@ -336,6 +356,66 @@ function getParserSuggestRuntimeNodes(parser, state, path) {
 	}];
 }
 /**
+* Returns wrapper-aware suggest-time runtime nodes for parsers that delegate
+* to an inner parser while also exposing their own source metadata.
+*
+* The inner parser's nodes are always preserved so nested wrappers and
+* constructs can continue to seed the dependency runtime recursively. When
+* the outer parser itself owns source metadata, its `(path, parser, state)`
+* node is appended so outer precedence rules still apply.
+*
+* @internal
+*/
+function getDelegatingSuggestRuntimeNodes(innerParser, outerParser, state, path, innerState, outerPosition = "append") {
+	const innerNodes = getParserSuggestRuntimeNodes(innerParser, innerState, path);
+	if (outerParser.dependencyMetadata?.source == null) return innerNodes;
+	const outerNode = {
+		path,
+		parser: outerParser,
+		state
+	};
+	return outerPosition === "prepend" ? [outerNode, ...innerNodes] : [...innerNodes, outerNode];
+}
+/**
+* Composes source metadata for a wrapper parser while preserving any derived
+* or transform capabilities from the inner parser unchanged.
+*
+* @internal
+*/
+function composeWrappedSourceMetadata(dependencyMetadata, wrapSource) {
+	if (dependencyMetadata?.source == null) return dependencyMetadata;
+	return {
+		...dependencyMetadata,
+		source: wrapSource(dependencyMetadata.source)
+	};
+}
+/**
+* Marks a parser as inheriting parent-state annotations through wrapper-state
+* reconstruction.
+*
+* @internal
+*/
+function defineInheritedAnnotationParser(parser) {
+	Object.defineProperty(parser, inheritParentAnnotationsKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+}
+/**
+* Marks a wrapper parser as requiring a real source-binding state before
+* annotation-only primitive wrappers should trigger completion.
+*
+* @internal
+*/
+function defineSourceBindingOnlyAnnotationCompletionParser(parser) {
+	Object.defineProperty(parser, annotationWrapperRequiresSourceBindingKey, {
+		value: true,
+		configurable: true,
+		enumerable: false
+	});
+}
+/**
 * Generates command-line suggestions based on current parsing state.
 * This function processes the input arguments up to the last argument,
 * then calls the parser's suggest method with the remaining prefix.
@@ -622,4 +702,4 @@ function buildDocPage(parser, context, args) {
 }
 
 //#endregion
-export { DuplicateOptionError, WithDefaultError, argument, command, concat, conditional, constant, createParserContext, fail, flag, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };
+export { DuplicateOptionError, WithDefaultError, annotationWrapperRequiresSourceBindingKey, argument, command, composeWrappedSourceMetadata, concat, conditional, constant, createParserContext, defineInheritedAnnotationParser, defineSourceBindingOnlyAnnotationCompletionParser, fail, flag, getDelegatingSuggestRuntimeNodes, getDocPage, getDocPageAsync, getDocPageSync, getParserSuggestRuntimeNodes, group, inheritParentAnnotationsKey, longestMatch, map, merge, multiple, nonEmpty, object, option, optional, or, parse, parseAsync, parseSync, passThrough, suggest, suggestAsync, suggestSync, tuple, unmatchedNonCliDependencySourceStateMarker, withDefault };

package/dist/primitives.cjs

@@ -232,12 +232,13 @@ function fail() {
 * if the parser is a derived parser and dependency values are available.
 * @internal
 */
-function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry) {
+function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry, exec) {
 	if (!valueParser.suggest) return;
 	if (require_dependency.isDerivedValueParser(valueParser) && require_dependency.suggestWithDependency in valueParser) {
 		const derived = valueParser;
 		const suggestWithDep = derived[require_dependency.suggestWithDependency];
 		if (suggestWithDep && dependencyRegistry) {
+			const dependencyRuntime = exec?.dependencyRuntime;
 			const depIds = require_dependency.getDependencyIds(derived);
 			const defaultsFn = require_dependency.getDefaultValuesFunction(derived);
 			const defaults = defaultsFn?.();
@@ -248,7 +249,8 @@ function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry)
 				if (dependencyRegistry.has(depId)) {
 					dependencyValues.push(dependencyRegistry.get(depId));
 					hasAnyValue = true;
-				} else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
+				} else if (dependencyRuntime?.isSourceFailed(depId)) return;
+				else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
 				else {
 					yield* valueParser.suggest(prefix);
 					return;
@@ -275,7 +277,7 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 		const valuePart = prefix.slice(equalsIndex + 1);
 		if (optionNames$1.includes(optionPart)) {
 			if (valueParser && valueParser.suggest) {
-				const valueSuggestions = getSuggestionsWithDependency(valueParser, valuePart, context.dependencyRegistry);
+				const valueSuggestions = getSuggestionsWithDependency(valueParser, valuePart, context.dependencyRegistry, context.exec);
 				for (const suggestion of valueSuggestions) if (suggestion.kind === "literal") yield {
 					kind: "literal",
 					text: `${optionPart}=${suggestion.text}`,
@@ -305,7 +307,7 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 				const lastToken = context.buffer[context.buffer.length - 1];
 				if (optionNames$1.includes(lastToken)) shouldSuggestValues = true;
 			} else if (context.state === void 0 && context.buffer.length === 0 && (context.exec?.path?.length ?? 0) === 0 && !(prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/"))) shouldSuggestValues = true;
-			if (shouldSuggestValues) yield* getSuggestionsWithDependency(valueParser, prefix, context.dependencyRegistry);
+			if (shouldSuggestValues) yield* getSuggestionsWithDependency(valueParser, prefix, context.dependencyRegistry, context.exec);
 		}
 	}
 }
@@ -314,12 +316,13 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 * if the parser is a derived parser and dependency values are available.
 * @internal
 */
-async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry) {
+async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry, exec) {
 	if (!valueParser.suggest) return;
 	if (require_dependency.isDerivedValueParser(valueParser) && require_dependency.suggestWithDependency in valueParser) {
 		const derived = valueParser;
 		const suggestWithDep = derived[require_dependency.suggestWithDependency];
 		if (suggestWithDep && dependencyRegistry) {
+			const dependencyRuntime = exec?.dependencyRuntime;
 			const depIds = require_dependency.getDependencyIds(derived);
 			const defaultsFn = require_dependency.getDefaultValuesFunction(derived);
 			const defaults = defaultsFn?.();
@@ -330,7 +333,8 @@ async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependenc
 				if (dependencyRegistry.has(depId)) {
 					dependencyValues.push(dependencyRegistry.get(depId));
 					hasAnyValue = true;
-				} else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
+				} else if (dependencyRuntime?.isSourceFailed(depId)) return;
+				else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
 				else {
 					for await (const suggestion of valueParser.suggest(prefix)) yield suggestion;
 					return;
@@ -357,7 +361,7 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 		const valuePart = prefix.slice(equalsIndex + 1);
 		if (optionNames$1.includes(optionPart)) {
 			if (valueParser && valueParser.suggest) {
-				const valueSuggestions = getSuggestionsWithDependencyAsync(valueParser, valuePart, context.dependencyRegistry);
+				const valueSuggestions = getSuggestionsWithDependencyAsync(valueParser, valuePart, context.dependencyRegistry, context.exec);
 				for await (const suggestion of valueSuggestions) if (suggestion.kind === "literal") yield {
 					kind: "literal",
 					text: `${optionPart}=${suggestion.text}`,
@@ -387,7 +391,7 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 				const lastToken = context.buffer[context.buffer.length - 1];
 				if (optionNames$1.includes(lastToken)) shouldSuggestValues = true;
 			} else if (context.state === void 0 && context.buffer.length === 0 && (context.exec?.path?.length ?? 0) === 0 && !(prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/"))) shouldSuggestValues = true;
-			if (shouldSuggestValues) for await (const suggestion of getSuggestionsWithDependencyAsync(valueParser, prefix, context.dependencyRegistry)) yield suggestion;
+			if (shouldSuggestValues) for await (const suggestion of getSuggestionsWithDependencyAsync(valueParser, prefix, context.dependencyRegistry, context.exec)) yield suggestion;
 		}
 	}
 }
@@ -395,17 +399,17 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 * Internal sync helper for argument suggest functionality.
 * @internal
 */
-function* suggestArgumentSync(valueParser, hidden, prefix, dependencyRegistry) {
+function* suggestArgumentSync(valueParser, hidden, prefix, dependencyRegistry, exec) {
 	if (hidden) return;
-	if (valueParser.suggest) yield* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry);
+	if (valueParser.suggest) yield* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry, exec);
 }
 /**
 * Internal async helper for argument suggest functionality.
 * @internal
 */
-async function* suggestArgumentAsync(valueParser, hidden, prefix, dependencyRegistry) {
+async function* suggestArgumentAsync(valueParser, hidden, prefix, dependencyRegistry, exec) {
 	if (hidden) return;
-	if (valueParser.suggest) yield* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry);
+	if (valueParser.suggest) yield* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry, exec);
 }
 function option(...args) {
 	const lastArg = args.at(-1);
@@ -1029,8 +1033,8 @@ function argument(valueParser, options = {}) {
 		},
 		suggest(context, prefix) {
 			if (context.state != null) return require_mode_dispatch.dispatchIterableByMode(valueParser.$mode, function* () {}, async function* () {});
-			if (isAsync) return suggestArgumentAsync(valueParser, require_usage.isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry);
-			return suggestArgumentSync(valueParser, require_usage.isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry);
+			if (isAsync) return suggestArgumentAsync(valueParser, require_usage.isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry, context.exec);
+			return suggestArgumentSync(valueParser, require_usage.isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry, context.exec);
 		},
 		getDocFragments(_state, defaultValue) {
 			if (require_usage.isDocHidden(options.hidden)) return {

package/dist/primitives.js

@@ -232,12 +232,13 @@ function fail() {
 * if the parser is a derived parser and dependency values are available.
 * @internal
 */
-function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry) {
+function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry, exec) {
 	if (!valueParser.suggest) return;
 	if (isDerivedValueParser(valueParser) && suggestWithDependency in valueParser) {
 		const derived = valueParser;
 		const suggestWithDep = derived[suggestWithDependency];
 		if (suggestWithDep && dependencyRegistry) {
+			const dependencyRuntime = exec?.dependencyRuntime;
 			const depIds = getDependencyIds(derived);
 			const defaultsFn = getDefaultValuesFunction(derived);
 			const defaults = defaultsFn?.();
@@ -248,7 +249,8 @@ function* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry)
 				if (dependencyRegistry.has(depId)) {
 					dependencyValues.push(dependencyRegistry.get(depId));
 					hasAnyValue = true;
-				} else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
+				} else if (dependencyRuntime?.isSourceFailed(depId)) return;
+				else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
 				else {
 					yield* valueParser.suggest(prefix);
 					return;
@@ -275,7 +277,7 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 		const valuePart = prefix.slice(equalsIndex + 1);
 		if (optionNames$1.includes(optionPart)) {
 			if (valueParser && valueParser.suggest) {
-				const valueSuggestions = getSuggestionsWithDependency(valueParser, valuePart, context.dependencyRegistry);
+				const valueSuggestions = getSuggestionsWithDependency(valueParser, valuePart, context.dependencyRegistry, context.exec);
 				for (const suggestion of valueSuggestions) if (suggestion.kind === "literal") yield {
 					kind: "literal",
 					text: `${optionPart}=${suggestion.text}`,
@@ -305,7 +307,7 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 				const lastToken = context.buffer[context.buffer.length - 1];
 				if (optionNames$1.includes(lastToken)) shouldSuggestValues = true;
 			} else if (context.state === void 0 && context.buffer.length === 0 && (context.exec?.path?.length ?? 0) === 0 && !(prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/"))) shouldSuggestValues = true;
-			if (shouldSuggestValues) yield* getSuggestionsWithDependency(valueParser, prefix, context.dependencyRegistry);
+			if (shouldSuggestValues) yield* getSuggestionsWithDependency(valueParser, prefix, context.dependencyRegistry, context.exec);
 		}
 	}
 }
@@ -314,12 +316,13 @@ function* suggestOptionSync(optionNames$1, valueParser, hidden, context, prefix)
 * if the parser is a derived parser and dependency values are available.
 * @internal
 */
-async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry) {
+async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry, exec) {
 	if (!valueParser.suggest) return;
 	if (isDerivedValueParser(valueParser) && suggestWithDependency in valueParser) {
 		const derived = valueParser;
 		const suggestWithDep = derived[suggestWithDependency];
 		if (suggestWithDep && dependencyRegistry) {
+			const dependencyRuntime = exec?.dependencyRuntime;
 			const depIds = getDependencyIds(derived);
 			const defaultsFn = getDefaultValuesFunction(derived);
 			const defaults = defaultsFn?.();
@@ -330,7 +333,8 @@ async function* getSuggestionsWithDependencyAsync(valueParser, prefix, dependenc
 				if (dependencyRegistry.has(depId)) {
 					dependencyValues.push(dependencyRegistry.get(depId));
 					hasAnyValue = true;
-				} else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
+				} else if (dependencyRuntime?.isSourceFailed(depId)) return;
+				else if (defaults && i < defaults.length) dependencyValues.push(defaults[i]);
 				else {
 					for await (const suggestion of valueParser.suggest(prefix)) yield suggestion;
 					return;
@@ -357,7 +361,7 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 		const valuePart = prefix.slice(equalsIndex + 1);
 		if (optionNames$1.includes(optionPart)) {
 			if (valueParser && valueParser.suggest) {
-				const valueSuggestions = getSuggestionsWithDependencyAsync(valueParser, valuePart, context.dependencyRegistry);
+				const valueSuggestions = getSuggestionsWithDependencyAsync(valueParser, valuePart, context.dependencyRegistry, context.exec);
 				for await (const suggestion of valueSuggestions) if (suggestion.kind === "literal") yield {
 					kind: "literal",
 					text: `${optionPart}=${suggestion.text}`,
@@ -387,7 +391,7 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 				const lastToken = context.buffer[context.buffer.length - 1];
 				if (optionNames$1.includes(lastToken)) shouldSuggestValues = true;
 			} else if (context.state === void 0 && context.buffer.length === 0 && (context.exec?.path?.length ?? 0) === 0 && !(prefix.startsWith("--") || prefix.startsWith("-") || prefix.startsWith("/"))) shouldSuggestValues = true;
-			if (shouldSuggestValues) for await (const suggestion of getSuggestionsWithDependencyAsync(valueParser, prefix, context.dependencyRegistry)) yield suggestion;
+			if (shouldSuggestValues) for await (const suggestion of getSuggestionsWithDependencyAsync(valueParser, prefix, context.dependencyRegistry, context.exec)) yield suggestion;
 		}
 	}
 }
@@ -395,17 +399,17 @@ async function* suggestOptionAsync(optionNames$1, valueParser, hidden, context,
 * Internal sync helper for argument suggest functionality.
 * @internal
 */
-function* suggestArgumentSync(valueParser, hidden, prefix, dependencyRegistry) {
+function* suggestArgumentSync(valueParser, hidden, prefix, dependencyRegistry, exec) {
 	if (hidden) return;
-	if (valueParser.suggest) yield* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry);
+	if (valueParser.suggest) yield* getSuggestionsWithDependency(valueParser, prefix, dependencyRegistry, exec);
 }
 /**
 * Internal async helper for argument suggest functionality.
 * @internal
 */
-async function* suggestArgumentAsync(valueParser, hidden, prefix, dependencyRegistry) {
+async function* suggestArgumentAsync(valueParser, hidden, prefix, dependencyRegistry, exec) {
 	if (hidden) return;
-	if (valueParser.suggest) yield* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry);
+	if (valueParser.suggest) yield* getSuggestionsWithDependencyAsync(valueParser, prefix, dependencyRegistry, exec);
 }
 function option(...args) {
 	const lastArg = args.at(-1);
@@ -1029,8 +1033,8 @@ function argument(valueParser, options = {}) {
 		},
 		suggest(context, prefix) {
 			if (context.state != null) return dispatchIterableByMode(valueParser.$mode, function* () {}, async function* () {});
-			if (isAsync) return suggestArgumentAsync(valueParser, isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry);
-			return suggestArgumentSync(valueParser, isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry);
+			if (isAsync) return suggestArgumentAsync(valueParser, isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry, context.exec);
+			return suggestArgumentSync(valueParser, isSuggestionHidden(options.hidden), prefix, context.dependencyRegistry, context.exec);
 		},
 		getDocFragments(_state, defaultValue) {
 			if (isDocHidden(options.hidden)) return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1658+b57e115b",
+  "version": "1.0.0-dev.1661+6fc17d4f",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",