@optique/core 1.0.0-dev.1574 → 1.0.0-dev.1583

package/dist/constructs.js

@@ -265,7 +265,7 @@ function generateNoMatchError(context) {
 */
 function createExclusiveComplete(parsers, options, noMatchContext, mode) {
 	const syncParsers = parsers;
-	return (state) => {
+	return (state, exec) => {
 		if (state == null) return {
 			success: false,
 			error: getNoMatchError(options, noMatchContext)
@@ -275,8 +275,8 @@ function createExclusiveComplete(parsers, options, noMatchContext, mode) {
 			success: false,
 			error: result.error
 		};
-		return dispatchByMode(mode, () => syncParsers[i].complete(result.next.state), async () => {
-			const completeResult = await parsers[i].complete(result.next.state);
+		return dispatchByMode(mode, () => syncParsers[i].complete(result.next.state, exec), async () => {
+			const completeResult = await parsers[i].complete(result.next.state, exec);
 			return completeResult;
 		});
 	};
@@ -691,7 +691,7 @@ function longestMatch(...args) {
 function* suggestObjectSync(context, prefix, parserPairs) {
 	const registry = context.dependencyRegistry ? context.dependencyRegistry.clone() : new DependencyRegistry();
 	if (context.state && typeof context.state === "object") collectDependencies(context.state, registry);
-	completeDependencySourceDefaults(context, parserPairs, registry);
+	completeDependencySourceDefaults(context, parserPairs, registry, context.exec);
 	const contextWithRegistry = {
 		...context,
 		dependencyRegistry: registry
@@ -725,7 +725,7 @@ function* suggestObjectSync(context, prefix, parserPairs) {
 async function* suggestObjectAsync(context, prefix, parserPairs) {
 	const registry = context.dependencyRegistry ? context.dependencyRegistry.clone() : new DependencyRegistry();
 	if (context.state && typeof context.state === "object") collectDependencies(context.state, registry);
-	await completeDependencySourceDefaultsAsync(context, parserPairs, registry);
+	await completeDependencySourceDefaultsAsync(context, parserPairs, registry, context.exec);
 	const contextWithRegistry = {
 		...context,
 		dependencyRegistry: registry
@@ -798,9 +798,9 @@ function* pendingDependencyDefaults(context, parserPairs) {
 * @see https://github.com/dahlia/optique/issues/186
 * @internal
 */
-function completeDependencySourceDefaults(context, parserPairs, registry) {
+function completeDependencySourceDefaults(context, parserPairs, registry, exec) {
 	for (const { parser, state } of pendingDependencyDefaults(context, parserPairs)) {
-		const completed = parser.complete(state);
+		const completed = parser.complete(state, exec);
 		const depState = wrapAsDependencySourceState(completed, parser);
 		if (depState) registerCompletedDependency(depState, registry);
 	}
@@ -833,9 +833,9 @@ function wrapAsDependencySourceState(completed, parser) {
 * @see https://github.com/dahlia/optique/issues/186
 * @internal
 */
-async function completeDependencySourceDefaultsAsync(context, parserPairs, registry) {
+async function completeDependencySourceDefaultsAsync(context, parserPairs, registry, exec) {
 	for (const { parser, state } of pendingDependencyDefaults(context, parserPairs)) {
-		const completed = await parser.complete(state);
+		const completed = await parser.complete(state, exec);
 		const depState = wrapAsDependencySourceState(completed, parser);
 		if (depState) registerCompletedDependency(depState, registry);
 	}
@@ -860,18 +860,18 @@ function collectChildFieldParsers(parsers) {
 * The original state is NOT modified; only the registry is populated.
 * @internal
 */
-function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry) {
+function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry, exec) {
 	for (const [field, fieldParser] of fieldParserPairs) {
 		const fieldState = state[field];
 		let completed;
-		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) completed = fieldParser.complete(fieldState);
-		else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) completed = fieldParser.complete([fieldParser.initialState]);
+		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) completed = fieldParser.complete(fieldState, exec);
+		else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) completed = fieldParser.complete([fieldParser.initialState], exec);
 		else if (fieldState === void 0 && isWrappedDependencySource(fieldParser)) {
 			const pendingState = fieldParser[wrappedDependencySourceMarker];
-			completed = fieldParser.complete([pendingState]);
+			completed = fieldParser.complete([pendingState], exec);
 		} else if (fieldState != null && !Array.isArray(fieldState) && !isDependencySourceState(fieldState) && (isWrappedDependencySource(fieldParser) || isPendingDependencySourceState(fieldParser.initialState))) {
 			const annotatedFieldState = getAnnotatedFieldState(state, field, fieldParser);
-			completed = fieldParser.complete(annotatedFieldState);
+			completed = fieldParser.complete(annotatedFieldState, exec);
 		} else continue;
 		const depState = wrapAsDependencySourceState(completed, fieldParser);
 		if (depState) registerCompletedDependency(depState, registry);
@@ -881,18 +881,18 @@ function preCompleteAndRegisterDependencies(state, fieldParserPairs, registry) {
 * Async version of {@link preCompleteAndRegisterDependencies}.
 * @internal
 */
-async function preCompleteAndRegisterDependenciesAsync(state, fieldParserPairs, registry) {
+async function preCompleteAndRegisterDependenciesAsync(state, fieldParserPairs, registry, exec) {
 	for (const [field, fieldParser] of fieldParserPairs) {
 		const fieldState = state[field];
 		let completed;
-		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) completed = await fieldParser.complete(fieldState);
-		else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) completed = await fieldParser.complete([fieldParser.initialState]);
+		if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) completed = await fieldParser.complete(fieldState, exec);
+		else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) completed = await fieldParser.complete([fieldParser.initialState], exec);
 		else if (fieldState === void 0 && isWrappedDependencySource(fieldParser)) {
 			const pendingState = fieldParser[wrappedDependencySourceMarker];
-			completed = await fieldParser.complete([pendingState]);
+			completed = await fieldParser.complete([pendingState], exec);
 		} else if (fieldState != null && !Array.isArray(fieldState) && !isDependencySourceState(fieldState) && (isWrappedDependencySource(fieldParser) || isPendingDependencySourceState(fieldParser.initialState))) {
 			const annotatedFieldState = getAnnotatedFieldState(state, field, fieldParser);
-			completed = await fieldParser.complete(annotatedFieldState);
+			completed = await fieldParser.complete(annotatedFieldState, exec);
 		} else continue;
 		const depState = wrapAsDependencySourceState(completed, fieldParser);
 		if (depState) registerCompletedDependency(depState, registry);
@@ -1147,7 +1147,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 			const getFieldState = createFieldStateGetter(context.state);
 			for (const [field, parser] of parserPairs) {
 				const fieldState = getFieldState(field, parser);
-				const completeResult = parser.complete(fieldState);
+				const completeResult = parser.complete(fieldState, context.exec);
 				if (!completeResult.success) {
 					allCanComplete = false;
 					break;
@@ -1206,7 +1206,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 			const getFieldState = createFieldStateGetter(context.state);
 			for (const [field, parser] of parserPairs) {
 				const fieldState = getFieldState(field, parser);
-				const completeResult = await parser.complete(fieldState);
+				const completeResult = await parser.complete(fieldState, context.exec);
 				if (!completeResult.success) {
 					allCanComplete = false;
 					break;
@@ -1238,7 +1238,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		parse(context) {
 			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		complete(state) {
+		complete(state, exec) {
 			return dispatchByMode(combinedMode, () => {
 				const preCompletedState = {};
 				const preCompletedKeys = /* @__PURE__ */ new Set();
@@ -1248,23 +1248,23 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const fieldState = state[fieldKey];
 					const fieldParser = parsers[field];
 					if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) {
-						const completed = fieldParser.complete(fieldState);
+						const completed = fieldParser.complete(fieldState, exec);
 						preCompletedState[fieldKey] = completed;
 						preCompletedKeys.add(fieldKey);
 					} else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) {
-						const completed = fieldParser.complete([fieldParser.initialState]);
+						const completed = fieldParser.complete([fieldParser.initialState], exec);
 						preCompletedState[fieldKey] = completed;
 						preCompletedKeys.add(fieldKey);
 					} else if (fieldState === void 0 && isWrappedDependencySource(fieldParser)) {
 						const pendingState = fieldParser[wrappedDependencySourceMarker];
-						const completed = fieldParser.complete([pendingState]);
+						const completed = fieldParser.complete([pendingState], exec);
 						if (isDependencySourceState(completed)) {
 							preCompletedState[fieldKey] = completed;
 							preCompletedKeys.add(fieldKey);
 						} else preCompletedState[fieldKey] = fieldState;
 					} else if (fieldState != null && !Array.isArray(fieldState) && !isDependencySourceState(fieldState) && (isWrappedDependencySource(fieldParser) || isPendingDependencySourceState(fieldParser.initialState))) {
 						const annotatedFieldState = getFieldState(field, fieldParser);
-						const completed = fieldParser.complete(annotatedFieldState);
+						const completed = fieldParser.complete(annotatedFieldState, exec);
 						const depState = wrapAsDependencySourceState(completed, fieldParser);
 						if (depState) {
 							preCompletedState[fieldKey] = depState;
@@ -1295,7 +1295,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 						continue;
 					}
 					const completionState = fieldResolvedState === void 0 ? getCompletionFieldState(field, fieldParser) : fieldResolvedState;
-					const valueResult = fieldParser.complete(completionState);
+					const valueResult = fieldParser.complete(completionState, exec);
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
 						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(fieldKey, valueResult.deferredKeys);
@@ -1324,23 +1324,23 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const fieldState = state[fieldKey];
 					const fieldParser = parsers[field];
 					if (Array.isArray(fieldState) && fieldState.length === 1 && isPendingDependencySourceState(fieldState[0])) {
-						const completed = await fieldParser.complete(fieldState);
+						const completed = await fieldParser.complete(fieldState, exec);
 						preCompletedState[fieldKey] = completed;
 						preCompletedKeys.add(fieldKey);
 					} else if (fieldState === void 0 && isPendingDependencySourceState(fieldParser.initialState)) {
-						const completed = await fieldParser.complete([fieldParser.initialState]);
+						const completed = await fieldParser.complete([fieldParser.initialState], exec);
 						preCompletedState[fieldKey] = completed;
 						preCompletedKeys.add(fieldKey);
 					} else if (fieldState === void 0 && isWrappedDependencySource(fieldParser)) {
 						const pendingState = fieldParser[wrappedDependencySourceMarker];
-						const completed = await fieldParser.complete([pendingState]);
+						const completed = await fieldParser.complete([pendingState], exec);
 						if (isDependencySourceState(completed)) {
 							preCompletedState[fieldKey] = completed;
 							preCompletedKeys.add(fieldKey);
 						} else preCompletedState[fieldKey] = fieldState;
 					} else if (fieldState != null && !Array.isArray(fieldState) && !isDependencySourceState(fieldState) && (isWrappedDependencySource(fieldParser) || isPendingDependencySourceState(fieldParser.initialState))) {
 						const annotatedFieldState = getFieldState(field, fieldParser);
-						const completed = await fieldParser.complete(annotatedFieldState);
+						const completed = await fieldParser.complete(annotatedFieldState, exec);
 						const depState = wrapAsDependencySourceState(completed, fieldParser);
 						if (depState) {
 							preCompletedState[fieldKey] = depState;
@@ -1371,7 +1371,7 @@ function object(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 						continue;
 					}
 					const completionState = fieldResolvedState === void 0 ? getCompletionFieldState(field, fieldParser) : fieldResolvedState;
-					const valueResult = await fieldParser.complete(completionState);
+					const valueResult = await fieldParser.complete(completionState, exec);
 					if (valueResult.success) {
 						result[fieldKey] = valueResult.value;
 						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(fieldKey, valueResult.deferredKeys);
@@ -1632,7 +1632,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 		parse(context) {
 			return dispatchByMode(combinedMode, () => parseSync(context), () => parseAsync(context));
 		},
-		complete(state) {
+		complete(state, exec) {
 			return dispatchByMode(combinedMode, () => {
 				const stateArray = state;
 				const preCompletedState = [];
@@ -1640,14 +1640,14 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const elementState = stateArray[i];
 					const elementParser = syncParsers[i];
 					if (Array.isArray(elementState) && elementState.length === 1 && isPendingDependencySourceState(elementState[0])) {
-						const completed = elementParser.complete(elementState);
+						const completed = elementParser.complete(elementState, exec);
 						preCompletedState[i] = completed;
 					} else if (elementState === void 0 && isPendingDependencySourceState(elementParser.initialState)) {
-						const completed = elementParser.complete([elementParser.initialState]);
+						const completed = elementParser.complete([elementParser.initialState], exec);
 						preCompletedState[i] = completed;
 					} else if (elementState === void 0 && isWrappedDependencySource(elementParser)) {
 						const pendingState = elementParser[wrappedDependencySourceMarker];
-						const completed = elementParser.complete([pendingState]);
+						const completed = elementParser.complete([pendingState], exec);
 						preCompletedState[i] = completed;
 					} else preCompletedState[i] = elementState;
 				}
@@ -1676,7 +1676,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 						};
 						continue;
 					}
-					const valueResult = elementParser.complete(elementResolvedState);
+					const valueResult = elementParser.complete(elementResolvedState, exec);
 					if (valueResult.success) {
 						result[i] = valueResult.value;
 						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(i, valueResult.deferredKeys);
@@ -1703,14 +1703,14 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 					const elementState = stateArray[i];
 					const elementParser = parsers[i];
 					if (Array.isArray(elementState) && elementState.length === 1 && isPendingDependencySourceState(elementState[0])) {
-						const completed = await elementParser.complete(elementState);
+						const completed = await elementParser.complete(elementState, exec);
 						preCompletedState[i] = completed;
 					} else if (elementState === void 0 && isPendingDependencySourceState(elementParser.initialState)) {
-						const completed = await elementParser.complete([elementParser.initialState]);
+						const completed = await elementParser.complete([elementParser.initialState], exec);
 						preCompletedState[i] = completed;
 					} else if (elementState === void 0 && isWrappedDependencySource(elementParser)) {
 						const pendingState = elementParser[wrappedDependencySourceMarker];
-						const completed = await elementParser.complete([pendingState]);
+						const completed = await elementParser.complete([pendingState], exec);
 						preCompletedState[i] = completed;
 					} else preCompletedState[i] = elementState;
 				}
@@ -1739,7 +1739,7 @@ function tuple(labelOrParsers, maybeParsersOrOptions, maybeOptions) {
 						};
 						continue;
 					}
-					const valueResult = await elementParser.complete(elementResolvedState);
+					const valueResult = await elementParser.complete(elementResolvedState, exec);
 					if (valueResult.success) {
 						result[i] = valueResult.value;
 						if (valueResult.deferred) if (valueResult.deferredKeys) deferredKeys.set(i, valueResult.deferredKeys);
@@ -1980,7 +1980,7 @@ function merge(...args) {
 			if (isAsync) return parseAsync(context);
 			return parseSync(context);
 		},
-		complete(state) {
+		complete(state, exec) {
 			const extractCompleteState = (parser, resolvedState, index) => {
 				if (parser.initialState === void 0) {
 					const key = `__parser_${index}`;
@@ -2001,7 +2001,7 @@ function merge(...args) {
 			if (!isAsync) {
 				const childFieldPairs = collectChildFieldParsers(syncParsers);
 				const registry = new DependencyRegistry();
-				preCompleteAndRegisterDependencies(state, childFieldPairs, registry);
+				preCompleteAndRegisterDependencies(state, childFieldPairs, registry, exec);
 				const resolvedState = resolveDeferredParseStates(state, registry);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -2009,7 +2009,7 @@ function merge(...args) {
 				for (let i = 0; i < syncParsers.length; i++) {
 					const parser = syncParsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = parser.complete(parserState);
+					const result = parser.complete(parserState, exec);
 					if (!result.success) return result;
 					for (const field in result.value) {
 						object$1[field] = result.value[field];
@@ -2031,7 +2031,7 @@ function merge(...args) {
 			return (async () => {
 				const childFieldPairs = collectChildFieldParsers(parsers);
 				const registry = new DependencyRegistry();
-				await preCompleteAndRegisterDependenciesAsync(state, childFieldPairs, registry);
+				await preCompleteAndRegisterDependenciesAsync(state, childFieldPairs, registry, exec);
 				const resolvedState = await resolveDeferredParseStatesAsync(state, registry);
 				const object$1 = {};
 				const deferredKeys = /* @__PURE__ */ new Map();
@@ -2039,7 +2039,7 @@ function merge(...args) {
 				for (let i = 0; i < parsers.length; i++) {
 					const parser = parsers[i];
 					const parserState = extractCompleteState(parser, resolvedState, i);
-					const result = await parser.complete(parserState);
+					const result = await parser.complete(parserState, exec);
 					if (!result.success) return result;
 					for (const field in result.value) {
 						object$1[field] = result.value[field];
@@ -2080,9 +2080,9 @@ function merge(...args) {
 				const registry$1 = context.dependencyRegistry ? context.dependencyRegistry.clone() : new DependencyRegistry();
 				const childFieldPairs$1 = collectChildFieldParsers(parsers);
 				if (context.state && typeof context.state === "object") {
-					await preCompleteAndRegisterDependenciesAsync(context.state, childFieldPairs$1, registry$1);
+					await preCompleteAndRegisterDependenciesAsync(context.state, childFieldPairs$1, registry$1, context.exec);
 					collectDependencies(context.state, registry$1);
-				} else await completeDependencySourceDefaultsAsync(context, childFieldPairs$1, registry$1);
+				} else await completeDependencySourceDefaultsAsync(context, childFieldPairs$1, registry$1, context.exec);
 				const contextWithRegistry$1 = {
 					...context,
 					dependencyRegistry: registry$1
@@ -2103,9 +2103,9 @@ function merge(...args) {
 			const registry = context.dependencyRegistry ? context.dependencyRegistry.clone() : new DependencyRegistry();
 			const childFieldPairs = collectChildFieldParsers(syncParsers);
 			if (context.state && typeof context.state === "object") {
-				preCompleteAndRegisterDependencies(context.state, childFieldPairs, registry);
+				preCompleteAndRegisterDependencies(context.state, childFieldPairs, registry, context.exec);
 				collectDependencies(context.state, registry);
-			} else completeDependencySourceDefaults(context, childFieldPairs, registry);
+			} else completeDependencySourceDefaults(context, childFieldPairs, registry, context.exec);
 			const contextWithRegistry = {
 				...context,
 				dependencyRegistry: registry
@@ -2430,7 +2430,7 @@ function concat(...parsers) {
 			consumed: allConsumed
 		};
 	};
-	const completeSync = (state) => {
+	const completeSync = (state, exec) => {
 		const stateArray = state;
 		const combinedState = {};
 		for (let i = 0; i < stateArray.length; i++) combinedState[i] = stateArray[i];
@@ -2441,7 +2441,7 @@ function concat(...parsers) {
 		for (let i = 0; i < syncParsers.length; i++) {
 			const parser = syncParsers[i];
 			const parserState = resolvedCombinedState[i];
-			const result = parser.complete(parserState);
+			const result = parser.complete(parserState, exec);
 			if (!result.success) return result;
 			const baseIndex = results.length;
 			if (Array.isArray(result.value)) {
@@ -2469,7 +2469,7 @@ function concat(...parsers) {
 			} : {}
 		};
 	};
-	const completeAsync = async (state) => {
+	const completeAsync = async (state, exec) => {
 		const stateArray = state;
 		const combinedState = {};
 		for (let i = 0; i < stateArray.length; i++) combinedState[i] = stateArray[i];
@@ -2480,7 +2480,7 @@ function concat(...parsers) {
 		for (let i = 0; i < parsers.length; i++) {
 			const parser = parsers[i];
 			const parserState = resolvedCombinedState[i];
-			const result = await parser.complete(parserState);
+			const result = await parser.complete(parserState, exec);
 			if (!result.success) return result;
 			const baseIndex = results.length;
 			if (Array.isArray(result.value)) {
@@ -2521,9 +2521,9 @@ function concat(...parsers) {
 			if (isAsync) return parseAsync(context);
 			return parseSync(context);
 		},
-		complete(state) {
-			if (isAsync) return completeAsync(state);
-			return completeSync(state);
+		complete(state, exec) {
+			if (isAsync) return completeAsync(state, exec);
+			return completeSync(state, exec);
 		},
 		suggest(context, prefix) {
 			if (isAsync) return async function* () {
@@ -2599,7 +2599,7 @@ function group(label, parser, options = {}) {
 		...fieldParsersKey in parser ? { [fieldParsersKey]: parser[fieldParsersKey] } : {},
 		...typeof parser.shouldDeferCompletion === "function" ? { shouldDeferCompletion: parser.shouldDeferCompletion.bind(parser) } : {},
 		parse: (context) => parser.parse(context),
-		complete: (state) => parser.complete(state),
+		complete: (state, exec) => parser.complete(state, exec),
 		suggest: (context, prefix) => {
 			if (options.hidden === true) return dispatchIterableByMode(parser.$mode, function* () {}, async function* () {});
 			return parser.suggest(context, prefix);
@@ -2763,7 +2763,7 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			state: state.discriminatorState
 		});
 		if (discriminatorResult.success && discriminatorResult.consumed.length > 0) {
-			const completionResult = syncDiscriminator.complete(discriminatorResult.next.state);
+			const completionResult = syncDiscriminator.complete(discriminatorResult.next.state, context.exec);
 			if (completionResult.success) {
 				const value = completionResult.value;
 				const branchParser = syncBranches[value];
@@ -2862,7 +2862,7 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			state: state.discriminatorState
 		});
 		if (discriminatorResult.success && discriminatorResult.consumed.length > 0) {
-			const completionResult = await discriminator.complete(discriminatorResult.next.state);
+			const completionResult = await discriminator.complete(discriminatorResult.next.state, context.exec);
 			if (completionResult.success) {
 				const value = completionResult.value;
 				const branchParser = branches[value];
@@ -2934,14 +2934,14 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			error: getNoMatchError$1()
 		};
 	};
-	const completeSync = (state) => {
+	const completeSync = (state, exec) => {
 		const syncDiscriminator = discriminator;
 		const syncDefaultBranch = defaultBranch;
 		const syncBranches = branches;
 		if (state.selectedBranch === void 0) {
 			if (syncDefaultBranch !== void 0) {
 				const branchState = state.branchState ?? syncDefaultBranch.initialState;
-				const defaultResult = syncDefaultBranch.complete(branchState);
+				const defaultResult = syncDefaultBranch.complete(branchState, exec);
 				if (!defaultResult.success) return defaultResult;
 				return {
 					success: true,
@@ -2958,14 +2958,14 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			};
 		}
 		const branchParser = state.selectedBranch.kind === "default" ? syncDefaultBranch : syncBranches[state.selectedBranch.key];
-		const discriminatorCompleteResult = syncDiscriminator.complete(state.discriminatorState);
+		const discriminatorCompleteResult = syncDiscriminator.complete(state.discriminatorState, exec);
 		const combinedState = {
 			_discriminator: state.discriminatorState,
 			_branch: state.branchState
 		};
 		const resolvedCombinedState = resolveDeferredParseStates(combinedState);
 		const resolvedBranchState = resolvedCombinedState._branch;
-		const branchResult = branchParser.complete(resolvedBranchState);
+		const branchResult = branchParser.complete(resolvedBranchState, exec);
 		if (!branchResult.success) {
 			if (state.discriminatorValue !== void 0 && options?.errors?.branchError) return {
 				success: false,
@@ -2987,11 +2987,11 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			} : {}
 		};
 	};
-	const completeAsync = async (state) => {
+	const completeAsync = async (state, exec) => {
 		if (state.selectedBranch === void 0) {
 			if (defaultBranch !== void 0) {
 				const branchState = state.branchState ?? defaultBranch.initialState;
-				const defaultResult = await defaultBranch.complete(branchState);
+				const defaultResult = await defaultBranch.complete(branchState, exec);
 				if (!defaultResult.success) return defaultResult;
 				return {
 					success: true,
@@ -3008,14 +3008,14 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			};
 		}
 		const branchParser = state.selectedBranch.kind === "default" ? defaultBranch : branches[state.selectedBranch.key];
-		const discriminatorCompleteResult = await discriminator.complete(state.discriminatorState);
+		const discriminatorCompleteResult = await discriminator.complete(state.discriminatorState, exec);
 		const combinedState = {
 			_discriminator: state.discriminatorState,
 			_branch: state.branchState
 		};
 		const resolvedCombinedState = await resolveDeferredParseStatesAsync(combinedState);
 		const resolvedBranchState = resolvedCombinedState._branch;
-		const branchResult = await branchParser.complete(resolvedBranchState);
+		const branchResult = await branchParser.complete(resolvedBranchState, exec);
 		if (!branchResult.success) {
 			if (state.discriminatorValue !== void 0 && options?.errors?.branchError) return {
 				success: false,
@@ -3091,9 +3091,9 @@ function conditional(discriminator, branches, defaultBranch, options) {
 			if (isAsync) return parseAsync(context);
 			return parseSync(context);
 		},
-		complete(state) {
-			if (isAsync) return completeAsync(state);
-			return completeSync(state);
+		complete(state, exec) {
+			if (isAsync) return completeAsync(state, exec);
+			return completeSync(state, exec);
 		},
 		suggest(context, prefix) {
 			if (isAsync) return suggestAsync(context, prefix);

package/dist/index.cjs

@@ -33,6 +33,7 @@ exports.conditional = require_constructs.conditional;
 exports.constant = require_primitives.constant;
 exports.createDeferredParseState = require_dependency.createDeferredParseState;
 exports.createDependencySourceState = require_dependency.createDependencySourceState;
+exports.createParserContext = require_parser.createParserContext;
 exports.createPendingDependencySourceState = require_dependency.createPendingDependencySourceState;
 exports.deduplicateDocEntries = require_doc.deduplicateDocEntries;
 exports.deduplicateDocFragments = require_doc.deduplicateDocFragments;

package/dist/index.d.cts

@@ -8,8 +8,8 @@ import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, Grou
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.cjs";
 import { 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 } from "./dependency.cjs";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.cjs";
-import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, ModeValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.cjs";
+import { CombineModes, DocState, ExecutionContext, ExecutionPhase, InferMode, InferValue, Mode, ModeIterable, ModeValue, ParseFrame, Parser, ParserContext, ParserResult, Result, Suggestion, createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.cjs";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { ParserValuePlaceholder, SourceContext } from "./context.cjs";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.cjs";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createParserContext, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };

package/dist/index.d.ts

@@ -8,8 +8,8 @@ import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, Grou
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, nonEmpty, optional, withDefault } from "./modifiers.js";
 import { 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 } from "./dependency.js";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, OptionState, PassThroughFormat, PassThroughOptions, argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
-import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, ModeValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
+import { CombineModes, DocState, ExecutionContext, ExecutionPhase, InferMode, InferValue, Mode, ModeIterable, ModeValue, ParseFrame, Parser, ParserContext, ParserResult, Result, Suggestion, createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { ParserValuePlaceholder, SourceContext } from "./context.js";
 import { CommandSubConfig, ContextOptionsParam, ExtractRequiredOptions, OptionSubConfig, RunOptions, RunParserError, RunWithOptions, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
-export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { type Annotations, AnyDependencySource, ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CidrOptions, CidrValue, CombineMode, CombineModes, CombinedDependencyMode, CommandErrorOptions, CommandOptions, CommandSubConfig, ConditionalErrorOptions, ConditionalOptions, ContextOptionsParam, DeferredMap, DeferredParseState, DependencyError, DependencyMode, DependencyRegistry, DependencySource, DependencySourceState, DependencyValue, DependencyValues, DeriveAsyncOptions, DeriveFromAsyncOptions, DeriveFromOptions, DeriveFromSyncOptions, DeriveOptions, DeriveSyncOptions, DerivedValueParser, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DomainOptions, DuplicateOptionError, EmailOptions, ExecutionContext, ExecutionPhase, ExtractRequiredOptions, FlagErrorOptions, FlagOptions, FloatOptions, GroupOptions, HiddenVisibility, HostnameOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, IpOptions, Ipv4Options, Ipv6Options, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MacAddressOptions, MergeOptions, type Message, type MessageFormatOptions, type MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OptionState, OptionSubConfig, OrErrorOptions, OrOptions, ParseFrame, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowChoicesOptions, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createParserContext, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };

package/dist/index.js

@@ -9,7 +9,7 @@ import { WithDefaultError, map, multiple, nonEmpty, optional, withDefault } from
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 import { checkBooleanOption, checkEnumOption, choice, cidr, domain, email, float, hostname, integer, ip, ipv4, ipv6, isValueParser, locale, macAddress, port, portRange, socketAddress, string, url, uuid } from "./valueparser.js";
 import { argument, command, constant, fail, flag, option, passThrough } from "./primitives.js";
-import { getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
+import { createParserContext, getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
 import { RunParserError, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync } from "./facade.js";
 
-export { DependencyRegistry, DuplicateOptionError, RunParserError, WithDefaultError, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };
+export { DependencyRegistry, DuplicateOptionError, RunParserError, WithDefaultError, annotationKey, argument, bash, checkBooleanOption, checkEnumOption, choice, cidr, cloneDocEntry, cloneUsage, cloneUsageTerm, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createParserContext, createPendingDependencySourceState, deduplicateDocEntries, deduplicateDocFragments, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractLiteralValues, extractOptionNames, fail, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isDocEntryHidden, isDocHidden, isNonEmptyString, isPendingDependencySourceState, isSuggestionHidden, isUsageHidden, isValueParser, isWrappedDependencySource, lineBreak, link, locale, longestMatch, macAddress, map, merge, mergeHidden, message, metavar, multiple, nonEmpty, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, parseWithDependency, passThrough, pendingDependencySourceStateMarker, port, portRange, pwsh, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync, socketAddress, string, suggest, suggestAsync, suggestSync, suggestWithDependency, text, transformsDependencyValue, transformsDependencyValueMarker, tuple, url, uuid, value, valueSet, values, withDefault, wrappedDependencySourceMarker, zsh };