@optique/core 0.10.0-dev.323 → 0.10.0-dev.327

package/dist/constructs.cjs

@@ -1,5 +1,6 @@
 const require_message = require('./message.cjs');
 const require_dependency = require('./dependency.cjs');
+const require_mode_dispatch = require('./mode-dispatch.cjs');
 const require_usage = require('./usage.cjs');
 const require_suggestion = require('./suggestion.cjs');
 
@@ -118,7 +119,7 @@ function generateNoMatchError(context) {
 * Creates a complete() method shared by or() and longestMatch().
 * @internal
 */
-function createExclusiveComplete(parsers, options, noMatchContext, isAsync) {
+function createExclusiveComplete(parsers, options, noMatchContext, mode) {
 	const syncParsers = parsers;
 	return (state) => {
 		if (state == null) return {
@@ -130,67 +131,63 @@ function createExclusiveComplete(parsers, options, noMatchContext, isAsync) {
 			success: false,
 			error: result.error
 		};
-		if (isAsync) return (async () => {
+		return require_mode_dispatch.dispatchByMode(mode, () => syncParsers[i].complete(result.next.state), async () => {
 			const completeResult = await parsers[i].complete(result.next.state);
 			return completeResult;
-		})();
-		return syncParsers[i].complete(result.next.state);
+		});
 	};
 }
 /**
 * Creates a suggest() method shared by or() and longestMatch().
 * @internal
 */
-function createExclusiveSuggest(parsers, isAsync) {
+function createExclusiveSuggest(parsers, mode) {
 	const syncParsers = parsers;
-	if (isAsync) return (context, prefix) => {
-		return async function* () {
+	return (context, prefix) => {
+		return require_mode_dispatch.dispatchIterableByMode(mode, function* () {
 			const suggestions = [];
-			if (context.state == null) for (const parser of parsers) {
+			if (context.state == null) for (const parser of syncParsers) {
 				const parserSuggestions = parser.suggest({
 					...context,
 					state: parser.initialState
 				}, prefix);
-				if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
-				else suggestions.push(...parserSuggestions);
+				suggestions.push(...parserSuggestions);
 			}
 			else {
 				const [index, parserResult] = context.state;
 				if (parserResult.success) {
-					const parser = parsers[index];
-					const parserSuggestions = parser.suggest({
+					const parserSuggestions = syncParsers[index].suggest({
 						...context,
 						state: parserResult.next.state
 					}, prefix);
-					if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
-					else suggestions.push(...parserSuggestions);
+					suggestions.push(...parserSuggestions);
 				}
 			}
 			yield* require_suggestion.deduplicateSuggestions(suggestions);
-		}();
-	};
-	return (context, prefix) => {
-		return function* () {
+		}, async function* () {
 			const suggestions = [];
-			if (context.state == null) for (const parser of syncParsers) {
+			if (context.state == null) for (const parser of parsers) {
 				const parserSuggestions = parser.suggest({
 					...context,
 					state: parser.initialState
 				}, prefix);
-				suggestions.push(...parserSuggestions);
+				if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
+				else suggestions.push(...parserSuggestions);
 			}
 			else {
 				const [index, parserResult] = context.state;
 				if (parserResult.success) {
-					const parserSuggestions = syncParsers[index].suggest({
+					const parser = parsers[index];
+					const parserSuggestions = parser.suggest({
 						...context,
 						state: parserResult.next.state
 					}, prefix);
-					suggestions.push(...parserSuggestions);
+					if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
+					else suggestions.push(...parserSuggestions);
 				}
 			}
 			yield* require_suggestion.deduplicateSuggestions(suggestions);
-		}();
+		});
 	};
 }
 /**
@@ -227,7 +224,6 @@ function or(...args) {
 	}
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
@@ -364,12 +360,11 @@ function or(...args) {
 			terms: parsers.map((p) => p.usage)
 		}],
 		initialState: void 0,
-		complete: createExclusiveComplete(parsers, options, noMatchContext, isAsync),
+		complete: createExclusiveComplete(parsers, options, noMatchContext, combinedMode),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		suggest: createExclusiveSuggest(parsers, isAsync),
+		suggest: createExclusiveSuggest(parsers, combinedMode),
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let fragments;
@@ -419,7 +414,6 @@ function longestMatch(...args) {
 	}
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
@@ -502,12 +496,11 @@ function longestMatch(...args) {
 			terms: parsers.map((p) => p.usage)
 		}],
 		initialState: void 0,
-		complete: createExclusiveComplete(parsers, options, noMatchContext, isAsync),
+		complete: createExclusiveComplete(parsers, options, noMatchContext, combinedMode),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		suggest: createExclusiveSuggest(parsers, isAsync),
+		suggest: createExclusiveSuggest(parsers, combinedMode),
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let footer;
@@ -760,7 +753,6 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 	if (!options.allowDuplicates) checkDuplicateOptionNames(parserPairs.map(([field, parser]) => [field, parser.usage]));
 	const noMatchContext = analyzeNoMatchContext(parserKeys.map((k) => parsers[k]));
 	const combinedMode = parserKeys.some((k) => parsers[k].$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const getInitialError = (context) => ({
 		consumed: 0,
 		error: context.buffer.length > 0 ? (() => {
@@ -895,11 +887,10 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		usage: parserPairs.flatMap(([_, p]) => p.usage),
 		initialState,
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
 		complete(state) {
-			if (!isAsync) {
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => {
 				const preCompletedState = {};
 				const preCompletedKeys = /* @__PURE__ */ new Set();
 				for (const field of parserKeys) {
@@ -949,8 +940,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			}
-			return (async () => {
+			}, async () => {
 				const preCompletedState = {};
 				const preCompletedKeys = /* @__PURE__ */ new Set();
 				for (const field of parserKeys) {
@@ -1000,12 +990,13 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			})();
+			});
 		},
 		suggest(context, prefix) {
-			if (isAsync) return suggestObjectAsync(context, prefix, parserPairs);
-			const syncParserPairs = parserPairs;
-			return suggestObjectSync(context, prefix, syncParserPairs);
+			return require_mode_dispatch.dispatchIterableByMode(combinedMode, () => {
+				const syncParserPairs = parserPairs;
+				return suggestObjectSync(context, prefix, syncParserPairs);
+			}, () => suggestObjectAsync(context, prefix, parserPairs));
 		},
 		getDocFragments(state, defaultValue) {
 			const fragments = parserPairs.flatMap(([field, p]) => {
@@ -1075,7 +1066,6 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		options = maybeParsersOrOptions ?? {};
 	}
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	if (!options.allowDuplicates) checkDuplicateOptionNames(parsers.map((parser, index) => [String(index), parser.usage]));
 	const parseSync = (context) => {
@@ -1212,11 +1202,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		priority: parsers.length > 0 ? Math.max(...parsers.map((p) => p.priority)) : 0,
 		initialState: parsers.map((parser) => parser.initialState),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
 		complete(state) {
-			if (!isAsync) {
+			return require_mode_dispatch.dispatchByMode(combinedMode, () => {
 				const stateArray = state;
 				const preCompletedState = [];
 				for (let i = 0; i < syncParsers.length; i++) {
@@ -1264,8 +1253,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			}
-			return (async () => {
+			}, async () => {
 				const stateArray = state;
 				const preCompletedState = [];
 				for (let i = 0; i < parsers.length; i++) {
@@ -1313,11 +1301,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			})();
+			});
 		},
 		suggest(context, prefix) {
-			if (isAsync) return suggestTupleAsync(context, prefix, parsers);
-			return suggestTupleSync(context, prefix, syncParsers);
+			return require_mode_dispatch.dispatchIterableByMode(combinedMode, () => suggestTupleSync(context, prefix, syncParsers), () => suggestTupleAsync(context, prefix, parsers));
 		},
 		getDocFragments(state, defaultValue) {
 			const fragments = syncParsers.flatMap((p, i) => {

package/dist/constructs.js

@@ -1,5 +1,6 @@
 import { message, optionName, values } from "./message.js";
 import { DependencyRegistry, dependencyId, isDeferredParseState, isDependencySourceState, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, wrappedDependencySourceMarker } from "./dependency.js";
+import { dispatchByMode, dispatchIterableByMode } from "./mode-dispatch.js";
 import { extractArgumentMetavars, extractCommandNames, extractOptionNames } from "./usage.js";
 import { createErrorWithSuggestions, deduplicateSuggestions } from "./suggestion.js";
 
@@ -118,7 +119,7 @@ function generateNoMatchError(context) {
 * Creates a complete() method shared by or() and longestMatch().
 * @internal
 */
-function createExclusiveComplete(parsers, options, noMatchContext, isAsync) {
+function createExclusiveComplete(parsers, options, noMatchContext, mode) {
 	const syncParsers = parsers;
 	return (state) => {
 		if (state == null) return {
@@ -130,67 +131,63 @@ function createExclusiveComplete(parsers, options, noMatchContext, isAsync) {
 			success: false,
 			error: result.error
 		};
-		if (isAsync) return (async () => {
+		return dispatchByMode(mode, () => syncParsers[i].complete(result.next.state), async () => {
 			const completeResult = await parsers[i].complete(result.next.state);
 			return completeResult;
-		})();
-		return syncParsers[i].complete(result.next.state);
+		});
 	};
 }
 /**
 * Creates a suggest() method shared by or() and longestMatch().
 * @internal
 */
-function createExclusiveSuggest(parsers, isAsync) {
+function createExclusiveSuggest(parsers, mode) {
 	const syncParsers = parsers;
-	if (isAsync) return (context, prefix) => {
-		return async function* () {
+	return (context, prefix) => {
+		return dispatchIterableByMode(mode, function* () {
 			const suggestions = [];
-			if (context.state == null) for (const parser of parsers) {
+			if (context.state == null) for (const parser of syncParsers) {
 				const parserSuggestions = parser.suggest({
 					...context,
 					state: parser.initialState
 				}, prefix);
-				if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
-				else suggestions.push(...parserSuggestions);
+				suggestions.push(...parserSuggestions);
 			}
 			else {
 				const [index, parserResult] = context.state;
 				if (parserResult.success) {
-					const parser = parsers[index];
-					const parserSuggestions = parser.suggest({
+					const parserSuggestions = syncParsers[index].suggest({
 						...context,
 						state: parserResult.next.state
 					}, prefix);
-					if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
-					else suggestions.push(...parserSuggestions);
+					suggestions.push(...parserSuggestions);
 				}
 			}
 			yield* deduplicateSuggestions(suggestions);
-		}();
-	};
-	return (context, prefix) => {
-		return function* () {
+		}, async function* () {
 			const suggestions = [];
-			if (context.state == null) for (const parser of syncParsers) {
+			if (context.state == null) for (const parser of parsers) {
 				const parserSuggestions = parser.suggest({
 					...context,
 					state: parser.initialState
 				}, prefix);
-				suggestions.push(...parserSuggestions);
+				if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
+				else suggestions.push(...parserSuggestions);
 			}
 			else {
 				const [index, parserResult] = context.state;
 				if (parserResult.success) {
-					const parserSuggestions = syncParsers[index].suggest({
+					const parser = parsers[index];
+					const parserSuggestions = parser.suggest({
 						...context,
 						state: parserResult.next.state
 					}, prefix);
-					suggestions.push(...parserSuggestions);
+					if (parser.$mode === "async") for await (const s of parserSuggestions) suggestions.push(s);
+					else suggestions.push(...parserSuggestions);
 				}
 			}
 			yield* deduplicateSuggestions(suggestions);
-		}();
+		});
 	};
 }
 /**
@@ -227,7 +224,6 @@ function or(...args) {
 	}
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
@@ -364,12 +360,11 @@ function or(...args) {
 			terms: parsers.map((p) => p.usage)
 		}],
 		initialState: void 0,
-		complete: createExclusiveComplete(parsers, options, noMatchContext, isAsync),
+		complete: createExclusiveComplete(parsers, options, noMatchContext, combinedMode),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		suggest: createExclusiveSuggest(parsers, isAsync),
+		suggest: createExclusiveSuggest(parsers, combinedMode),
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let fragments;
@@ -419,7 +414,6 @@ function longestMatch(...args) {
 	}
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
@@ -502,12 +496,11 @@ function longestMatch(...args) {
 			terms: parsers.map((p) => p.usage)
 		}],
 		initialState: void 0,
-		complete: createExclusiveComplete(parsers, options, noMatchContext, isAsync),
+		complete: createExclusiveComplete(parsers, options, noMatchContext, combinedMode),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		suggest: createExclusiveSuggest(parsers, isAsync),
+		suggest: createExclusiveSuggest(parsers, combinedMode),
 		getDocFragments(state, _defaultValue) {
 			let description;
 			let footer;
@@ -760,7 +753,6 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 	if (!options.allowDuplicates) checkDuplicateOptionNames(parserPairs.map(([field, parser]) => [field, parser.usage]));
 	const noMatchContext = analyzeNoMatchContext(parserKeys.map((k) => parsers[k]));
 	const combinedMode = parserKeys.some((k) => parsers[k].$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const getInitialError = (context) => ({
 		consumed: 0,
 		error: context.buffer.length > 0 ? (() => {
@@ -895,11 +887,10 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		usage: parserPairs.flatMap(([_, p]) => p.usage),
 		initialState,
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
 		complete(state) {
-			if (!isAsync) {
+			return dispatchByMode(combinedMode, () => {
 				const preCompletedState = {};
 				const preCompletedKeys = /* @__PURE__ */ new Set();
 				for (const field of parserKeys) {
@@ -949,8 +940,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			}
-			return (async () => {
+			}, async () => {
 				const preCompletedState = {};
 				const preCompletedKeys = /* @__PURE__ */ new Set();
 				for (const field of parserKeys) {
@@ -1000,12 +990,13 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			})();
+			});
 		},
 		suggest(context, prefix) {
-			if (isAsync) return suggestObjectAsync(context, prefix, parserPairs);
-			const syncParserPairs = parserPairs;
-			return suggestObjectSync(context, prefix, syncParserPairs);
+			return dispatchIterableByMode(combinedMode, () => {
+				const syncParserPairs = parserPairs;
+				return suggestObjectSync(context, prefix, syncParserPairs);
+			}, () => suggestObjectAsync(context, prefix, parserPairs));
 		},
 		getDocFragments(state, defaultValue) {
 			const fragments = parserPairs.flatMap(([field, p]) => {
@@ -1075,7 +1066,6 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		options = maybeParsersOrOptions ?? {};
 	}
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
-	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;
 	if (!options.allowDuplicates) checkDuplicateOptionNames(parsers.map((parser, index) => [String(index), parser.usage]));
 	const parseSync = (context) => {
@@ -1212,11 +1202,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		priority: parsers.length > 0 ? Math.max(...parsers.map((p) => p.priority)) : 0,
 		initialState: parsers.map((parser) => parser.initialState),
 		parse(context) {
-			if (isAsync) return parseAsync(context);
-			return parseSync(context);
+			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
 		complete(state) {
-			if (!isAsync) {
+			return dispatchByMode(combinedMode, () => {
 				const stateArray = state;
 				const preCompletedState = [];
 				for (let i = 0; i < syncParsers.length; i++) {
@@ -1264,8 +1253,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			}
-			return (async () => {
+			}, async () => {
 				const stateArray = state;
 				const preCompletedState = [];
 				for (let i = 0; i < parsers.length; i++) {
@@ -1313,11 +1301,10 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					success: true,
 					value: result
 				};
-			})();
+			});
 		},
 		suggest(context, prefix) {
-			if (isAsync) return suggestTupleAsync(context, prefix, parsers);
-			return suggestTupleSync(context, prefix, syncParsers);
+			return dispatchIterableByMode(combinedMode, () => suggestTupleSync(context, prefix, syncParsers), () => suggestTupleAsync(context, prefix, parsers));
 		},
 		getDocFragments(state, defaultValue) {
 			const fragments = syncParsers.flatMap((p, i) => {

package/dist/dependency.cjs

@@ -531,6 +531,35 @@ function isDeferredParseState(value) {
 	return typeof value === "object" && value !== null && deferredParseMarker in value && value[deferredParseMarker] === true;
 }
 /**
+* Gets all dependency IDs from a derived parser.
+* If the parser was created with `deriveFrom` (multiple dependencies),
+* returns the array of dependency IDs. Otherwise, returns an array
+* containing the single dependency ID.
+*
+* @param parser The derived value parser to get dependency IDs from.
+* @returns An array of dependency ID symbols.
+* @internal
+* @since 0.10.0
+*/
+function getDependencyIds(parser) {
+	if (dependencyIds in parser) return parser[dependencyIds];
+	return [parser[dependencyId]];
+}
+/**
+* Gets the default values function from a derived parser, if present.
+* This function is available on parsers created with `deriveFrom` that
+* specify default values for their dependencies.
+*
+* @param parser The derived value parser to get the default values function from.
+* @returns The default values function, or undefined if not available.
+* @internal
+* @since 0.10.0
+*/
+function getDefaultValuesFunction(parser) {
+	if (defaultValues in parser) return parser[defaultValues];
+	return void 0;
+}
+/**
 * Creates a deferred parse state for a DerivedValueParser.
 *
 * @template T The type of value the parser will produce.
@@ -735,6 +764,8 @@ exports.deriveFromAsync = deriveFromAsync;
 exports.deriveFromSync = deriveFromSync;
 exports.derivedValueParserMarker = derivedValueParserMarker;
 exports.formatDependencyError = formatDependencyError;
+exports.getDefaultValuesFunction = getDefaultValuesFunction;
+exports.getDependencyIds = getDependencyIds;
 exports.isDeferredParseState = isDeferredParseState;
 exports.isDependencySource = isDependencySource;
 exports.isDependencySourceState = isDependencySourceState;

package/dist/dependency.d.cts

@@ -1,5 +1,6 @@
 import { NonEmptyString } from "./nonempty.cjs";
 import { Message } from "./message.cjs";
+import { DependencyRegistryLike } from "./registry-types.cjs";
 import { ValueParser, ValueParserResult } from "./valueparser.cjs";
 import { Mode, Suggestion } from "./parser.cjs";
 
@@ -533,6 +534,29 @@ interface DeferredParseState<T = unknown> {
  * @since 0.10.0
  */
 declare function isDeferredParseState<T>(value: unknown): value is DeferredParseState<T>;
+/**
+ * Gets all dependency IDs from a derived parser.
+ * If the parser was created with `deriveFrom` (multiple dependencies),
+ * returns the array of dependency IDs. Otherwise, returns an array
+ * containing the single dependency ID.
+ *
+ * @param parser The derived value parser to get dependency IDs from.
+ * @returns An array of dependency ID symbols.
+ * @internal
+ * @since 0.10.0
+ */
+declare function getDependencyIds<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): readonly symbol[];
+/**
+ * Gets the default values function from a derived parser, if present.
+ * This function is available on parsers created with `deriveFrom` that
+ * specify default values for their dependencies.
+ *
+ * @param parser The derived value parser to get the default values function from.
+ * @returns The default values function, or undefined if not available.
+ * @internal
+ * @since 0.10.0
+ */
+declare function getDefaultValuesFunction<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): (() => readonly unknown[]) | undefined;
 /**
  * Creates a deferred parse state for a DerivedValueParser.
  *
@@ -688,7 +712,7 @@ interface ResolvedDependency<T = unknown> {
  * to DerivedValueParser options.
  * @since 0.10.0
  */
-declare class DependencyRegistry {
+declare class DependencyRegistry implements DependencyRegistryLike {
   private readonly values;
   /**
    * Registers a resolved dependency value.
@@ -747,4 +771,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };

package/dist/dependency.d.ts

@@ -1,5 +1,6 @@
 import { NonEmptyString } from "./nonempty.js";
 import { Message } from "./message.js";
+import { DependencyRegistryLike } from "./registry-types.js";
 import { ValueParser, ValueParserResult } from "./valueparser.js";
 import { Mode, Suggestion } from "./parser.js";
 
@@ -533,6 +534,29 @@ interface DeferredParseState<T = unknown> {
  * @since 0.10.0
  */
 declare function isDeferredParseState<T>(value: unknown): value is DeferredParseState<T>;
+/**
+ * Gets all dependency IDs from a derived parser.
+ * If the parser was created with `deriveFrom` (multiple dependencies),
+ * returns the array of dependency IDs. Otherwise, returns an array
+ * containing the single dependency ID.
+ *
+ * @param parser The derived value parser to get dependency IDs from.
+ * @returns An array of dependency ID symbols.
+ * @internal
+ * @since 0.10.0
+ */
+declare function getDependencyIds<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): readonly symbol[];
+/**
+ * Gets the default values function from a derived parser, if present.
+ * This function is available on parsers created with `deriveFrom` that
+ * specify default values for their dependencies.
+ *
+ * @param parser The derived value parser to get the default values function from.
+ * @returns The default values function, or undefined if not available.
+ * @internal
+ * @since 0.10.0
+ */
+declare function getDefaultValuesFunction<M extends Mode, T, S>(parser: DerivedValueParser<M, T, S>): (() => readonly unknown[]) | undefined;
 /**
  * Creates a deferred parse state for a DerivedValueParser.
  *
@@ -688,7 +712,7 @@ interface ResolvedDependency<T = unknown> {
  * to DerivedValueParser options.
  * @since 0.10.0
  */
-declare class DependencyRegistry {
+declare class DependencyRegistry implements DependencyRegistryLike {
   private readonly values;
   /**
    * Registers a resolved dependency value.
@@ -747,4 +771,4 @@ type DependencyError = {
  */
 declare function formatDependencyError(error: DependencyError): Message;
 //#endregion
-export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };
+export { AnyDependencySource, CombineMode, CombinedDependencyMode, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, PendingDependencySourceState, ResolvedDependency, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, formatDependencyError, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, pendingDependencySourceStateMarker, suggestWithDependency, transformsDependencyValue, transformsDependencyValueMarker, wrappedDependencySourceMarker };