@optique/core 0.9.0-dev.211 → 0.9.0-dev.212

package/dist/facade.js

@@ -6,7 +6,7 @@ import { bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { multiple, optional, withDefault } from "./modifiers.js";
 import { string } from "./valueparser.js";
 import { argument, command, constant, flag, option } from "./primitives.js";
-import { getDocPage, parse, suggest } from "./parser.js";
+import { getDocPage, parseAsync, parseSync, suggest, suggestAsync } from "./parser.js";
 
 //#region src/facade.ts
 /**
@@ -89,6 +89,11 @@ function createCompletionParser(mode, programName, availableShells, name = "both
 		{ description: message`Generate shell completion script.` }
 	];
 	const completionOption = option(...completionOptionArgs);
+	const argsParser = withDefault(multiple(argument(string({ metavar: "ARG" }), { description: message`Command line arguments for completion suggestions (used by shell integration; you usually don't need to provide this).` })), []);
+	const optionParser = object({
+		shell: completionOption,
+		args: argsParser
+	});
 	switch (mode) {
 		case "command": return {
 			completionCommand,
@@ -96,17 +101,11 @@ function createCompletionParser(mode, programName, availableShells, name = "both
 		};
 		case "option": return {
 			completionCommand: null,
-			completionOption: object({
-				shell: completionOption,
-				args: withDefault(multiple(argument(string({ metavar: "ARG" }), { description: message`Command line arguments for completion suggestions (used by shell integration; you usually don't need to provide this).` })), [])
-			})
+			completionOption: optionParser
 		};
 		case "both": return {
 			completionCommand,
-			completionOption: object({
-				shell: completionOption,
-				args: withDefault(multiple(argument(string({ metavar: "ARG" }), { description: message`Command line arguments for completion suggestions (used by shell integration; you usually don't need to provide this).` })), [])
-			})
+			completionOption: optionParser
 		};
 	}
 }
@@ -117,6 +116,7 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 	const parsers = [];
 	if (helpParsers.helpOption) {
 		const lenientHelpParser = {
+			$mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 200,
@@ -178,12 +178,11 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 					value: state
 				};
 			},
-			suggest(_context, prefix) {
-				if ("--help".startsWith(prefix)) return [{
+			*suggest(_context, prefix) {
+				if ("--help".startsWith(prefix)) yield {
 					kind: "literal",
 					text: "--help"
-				}];
-				return [];
+				};
 			},
 			getDocFragments(state) {
 				return helpParsers.helpOption?.getDocFragments(state) ?? { fragments: [] };
@@ -193,6 +192,7 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 	}
 	if (versionParsers.versionOption) {
 		const lenientVersionParser = {
+			$mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 200,
@@ -246,12 +246,11 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 					value: state
 				};
 			},
-			suggest(_context, prefix) {
-				if ("--version".startsWith(prefix)) return [{
+			*suggest(_context, prefix) {
+				if ("--version".startsWith(prefix)) yield {
 					kind: "literal",
 					text: "--version"
-				}];
-				return [];
+				};
 			},
 			getDocFragments(state) {
 				return versionParsers.versionOption?.getDocFragments(state) ?? { fragments: [] };
@@ -346,6 +345,20 @@ function classifyResult(result, args) {
 function handleCompletion(completionArgs, programName, parser, completionParser, stdout, stderr, onCompletion, onError, availableShells, colors, maxWidth, completionMode, completionName) {
 	const shellName = completionArgs[0] || "";
 	const args = completionArgs.slice(1);
+	const callOnError = (code) => {
+		try {
+			return onError(code);
+		} catch {
+			return onError();
+		}
+	};
+	const callOnCompletion = (code) => {
+		try {
+			return onCompletion(code);
+		} catch {
+			return onCompletion();
+		}
+	};
 	if (!shellName) {
 		stderr("Error: Missing shell name for completion.\n");
 		if (completionParser) {
@@ -355,72 +368,43 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 				maxWidth
 			}));
 		}
-		try {
-			return onError(1);
-		} catch {
-			return onError();
-		}
+		if (parser.$mode === "async") return Promise.resolve(callOnError(1));
+		return callOnError(1);
 	}
 	const shell = availableShells[shellName];
 	if (!shell) {
 		const available = [];
-		for (const shell$1 in availableShells) {
+		for (const name in availableShells) {
 			if (available.length > 0) available.push(text(", "));
-			available.push(value(shell$1));
+			available.push(value(name));
 		}
 		stderr(formatMessage(message`Error: Unsupported shell ${shellName}. Available shells: ${available}.`, {
 			colors,
 			quotes: !colors
 		}));
-		return onError(1);
+		if (parser.$mode === "async") return Promise.resolve(callOnError(1));
+		return callOnError(1);
 	}
 	if (args.length === 0) {
 		const usePlural = completionName === "plural";
 		const completionArg = completionMode === "option" ? usePlural ? "--completions" : "--completion" : usePlural ? "completions" : "completion";
 		const script = shell.generateScript(programName, [completionArg, shellName]);
 		stdout(script);
-	} else {
-		const suggestions = suggest(parser, args);
-		for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
-	}
-	try {
-		return onCompletion(0);
-	} catch {
-		return onCompletion();
+		if (parser.$mode === "async") return Promise.resolve(callOnCompletion(0));
+		return callOnCompletion(0);
 	}
+	if (parser.$mode === "async") return (async () => {
+		const suggestions$1 = await suggestAsync(parser, args);
+		for (const chunk of shell.encodeSuggestions(suggestions$1)) stdout(chunk);
+		return callOnCompletion(0);
+	})();
+	const syncParser = parser;
+	const suggestions = suggest(syncParser, args);
+	for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
+	return callOnCompletion(0);
 }
-/**
-* Runs a parser against command-line arguments with built-in help and error
-* handling.
-*
-* This function provides a complete CLI interface by automatically handling
-* help commands/options and displaying formatted error messages with usage
-* information when parsing fails. It augments the provided parser with help
-* functionality based on the configuration options.
-*
-* The function will:
-*
-* 1. Add help command/option support (unless disabled)
-* 2. Parse the provided arguments
-* 3. Display help if requested
-* 4. Show formatted error messages with usage/help info on parse failures
-* 5. Return the parsed result or invoke the appropriate callback
-*
-* @template TParser The parser type being run.
-* @template THelp Return type when help is shown (defaults to `void`).
-* @template TError Return type when an error occurs (defaults to `never`).
-* @param parser The parser to run against the command-line arguments.
-* @param programName Name of the program used in usage and help output.
-* @param args Command-line arguments to parse (typically from
-*             `process.argv.slice(2)` on Node.js or `Deno.args` on Deno).
-* @param options Configuration options for output formatting and callbacks.
-* @returns The parsed result value, or the return value of `onHelp`/`onError`
-*          callbacks.
-* @throws {RunParserError} When parsing fails and no `onError` callback is
-*          provided.
-*/
 function runParser(parser, programName, args, options = {}) {
-	let { colors, maxWidth, showDefault, aboveError = "usage", onError = () => {
+	const { colors, maxWidth, showDefault, aboveError = "usage", onError = () => {
 		throw new RunParserError("Failed to parse command line arguments.");
 	}, stderr = console.error, stdout = console.log, brief, description, footer } = options;
 	const helpMode = options.help?.mode ?? "option";
@@ -480,97 +464,155 @@ function runParser(parser, programName, args, options = {}) {
 		}
 	}
 	const augmentedParser = help === "none" && version === "none" && completion === "none" ? parser : combineWithHelpVersion(parser, helpParsers, versionParsers, completionParsers);
-	const result = parse(augmentedParser, args);
-	const classified = classifyResult(result, args);
-	switch (classified.type) {
-		case "success": return classified.value;
-		case "version":
-			stdout(versionValue);
-			try {
-				return onVersion(0);
-			} catch {
-				return onVersion();
-			}
-		case "completion": throw new RunParserError("Completion should be handled by early return");
-		case "help": {
-			let helpGeneratorParser;
-			const helpAsCommand = help === "command" || help === "both";
-			const versionAsCommand = version === "command" || version === "both";
-			const completionAsCommand = completion === "command" || completion === "both";
-			const requestedCommand = classified.commands[0];
-			if ((requestedCommand === "completion" || requestedCommand === "completions") && completionAsCommand && completionParsers.completionCommand) helpGeneratorParser = completionParsers.completionCommand;
-			else if (requestedCommand === "help" && helpAsCommand && helpParsers.helpCommand) helpGeneratorParser = helpParsers.helpCommand;
-			else if (requestedCommand === "version" && versionAsCommand && versionParsers.versionCommand) helpGeneratorParser = versionParsers.versionCommand;
-			else {
-				const commandParsers = [parser];
-				if (helpAsCommand) {
-					if (helpParsers.helpCommand) commandParsers.push(helpParsers.helpCommand);
-				}
-				if (versionAsCommand) {
-					if (versionParsers.versionCommand) commandParsers.push(versionParsers.versionCommand);
+	const handleResult = (result) => {
+		const classified = classifyResult(result, args);
+		switch (classified.type) {
+			case "success": return classified.value;
+			case "version":
+				stdout(versionValue);
+				try {
+					return onVersion(0);
+				} catch {
+					return onVersion();
 				}
-				if (completionAsCommand) {
-					if (completionParsers.completionCommand) commandParsers.push(completionParsers.completionCommand);
+			case "completion": throw new RunParserError("Completion should be handled by early return");
+			case "help": {
+				let helpGeneratorParser;
+				const helpAsCommand = help === "command" || help === "both";
+				const versionAsCommand = version === "command" || version === "both";
+				const completionAsCommand = completion === "command" || completion === "both";
+				const requestedCommand = classified.commands[0];
+				if ((requestedCommand === "completion" || requestedCommand === "completions") && completionAsCommand && completionParsers.completionCommand) helpGeneratorParser = completionParsers.completionCommand;
+				else if (requestedCommand === "help" && helpAsCommand && helpParsers.helpCommand) helpGeneratorParser = helpParsers.helpCommand;
+				else if (requestedCommand === "version" && versionAsCommand && versionParsers.versionCommand) helpGeneratorParser = versionParsers.versionCommand;
+				else {
+					const commandParsers = [parser];
+					if (helpAsCommand) {
+						if (helpParsers.helpCommand) commandParsers.push(helpParsers.helpCommand);
+					}
+					if (versionAsCommand) {
+						if (versionParsers.versionCommand) commandParsers.push(versionParsers.versionCommand);
+					}
+					if (completionAsCommand) {
+						if (completionParsers.completionCommand) commandParsers.push(completionParsers.completionCommand);
+					}
+					if (commandParsers.length === 1) helpGeneratorParser = commandParsers[0];
+					else if (commandParsers.length === 2) helpGeneratorParser = longestMatch(commandParsers[0], commandParsers[1]);
+					else helpGeneratorParser = longestMatch(...commandParsers);
 				}
-				if (commandParsers.length === 1) helpGeneratorParser = commandParsers[0];
-				else if (commandParsers.length === 2) helpGeneratorParser = longestMatch(commandParsers[0], commandParsers[1]);
-				else helpGeneratorParser = longestMatch(...commandParsers);
-			}
-			const doc = getDocPage(helpGeneratorParser, classified.commands);
-			if (doc != null) {
-				const isMetaCommandHelp = (completionName === "singular" || completionName === "both" ? requestedCommand === "completion" : false) || (completionName === "plural" || completionName === "both" ? requestedCommand === "completions" : false) || requestedCommand === "help" || requestedCommand === "version";
-				const augmentedDoc = {
-					...doc,
-					brief: !isMetaCommandHelp ? brief ?? doc.brief : doc.brief,
-					description: !isMetaCommandHelp ? description ?? doc.description : doc.description,
-					footer: !isMetaCommandHelp ? footer ?? doc.footer : doc.footer
+				const displayHelp = (doc) => {
+					if (doc != null) {
+						const isMetaCommandHelp = (completionName === "singular" || completionName === "both" ? requestedCommand === "completion" : false) || (completionName === "plural" || completionName === "both" ? requestedCommand === "completions" : false) || requestedCommand === "help" || requestedCommand === "version";
+						const augmentedDoc = {
+							...doc,
+							brief: !isMetaCommandHelp ? brief ?? doc.brief : doc.brief,
+							description: !isMetaCommandHelp ? description ?? doc.description : doc.description,
+							footer: !isMetaCommandHelp ? footer ?? doc.footer : doc.footer
+						};
+						stdout(formatDocPage(programName, augmentedDoc, {
+							colors,
+							maxWidth,
+							showDefault
+						}));
+					}
+					try {
+						return onHelp(0);
+					} catch {
+						return onHelp();
+					}
 				};
-				stdout(formatDocPage(programName, augmentedDoc, {
-					colors,
-					maxWidth,
-					showDefault
-				}));
-			}
-			try {
-				return onHelp(0);
-			} catch {
-				return onHelp();
+				const docOrPromise = getDocPage(helpGeneratorParser, classified.commands);
+				if (docOrPromise instanceof Promise) return docOrPromise.then(displayHelp);
+				return displayHelp(docOrPromise);
 			}
-		}
-		case "error": {
-			if (aboveError === "help") {
-				const doc = getDocPage(args.length < 1 ? augmentedParser : parser, args);
-				if (doc == null) aboveError = "usage";
-				else {
-					const augmentedDoc = {
-						...doc,
-						brief: brief ?? doc.brief,
-						description: description ?? doc.description,
-						footer: footer ?? doc.footer
-					};
-					stderr(formatDocPage(programName, augmentedDoc, {
+			case "error": {
+				const displayError = (doc, currentAboveError) => {
+					let effectiveAboveError = currentAboveError;
+					if (effectiveAboveError === "help") if (doc == null) effectiveAboveError = "usage";
+					else {
+						const augmentedDoc = {
+							...doc,
+							brief: brief ?? doc.brief,
+							description: description ?? doc.description,
+							footer: footer ?? doc.footer
+						};
+						stderr(formatDocPage(programName, augmentedDoc, {
+							colors,
+							maxWidth,
+							showDefault
+						}));
+					}
+					if (effectiveAboveError === "usage") stderr(`Usage: ${indentLines(formatUsage(programName, augmentedParser.usage, {
+						colors,
+						maxWidth: maxWidth == null ? void 0 : maxWidth - 7,
+						expandCommands: true
+					}), 7)}`);
+					const errorMessage = formatMessage(classified.error, {
 						colors,
-						maxWidth,
-						showDefault
-					}));
+						quotes: !colors
+					});
+					stderr(`Error: ${errorMessage}`);
+					return onError(1);
+				};
+				if (aboveError === "help") {
+					const parserForDoc = args.length < 1 ? augmentedParser : parser;
+					const docOrPromise = getDocPage(parserForDoc, args);
+					if (docOrPromise instanceof Promise) return docOrPromise.then((doc) => displayError(doc, aboveError));
+					return displayError(docOrPromise, aboveError);
 				}
+				return displayError(void 0, aboveError);
 			}
-			if (aboveError === "usage") stderr(`Usage: ${indentLines(formatUsage(programName, augmentedParser.usage, {
-				colors,
-				maxWidth: maxWidth == null ? void 0 : maxWidth - 7,
-				expandCommands: true
-			}), 7)}`);
-			const errorMessage = formatMessage(classified.error, {
-				colors,
-				quotes: !colors
-			});
-			stderr(`Error: ${errorMessage}`);
-			return onError(1);
+			default: throw new RunParserError("Unexpected parse result type");
 		}
-		default: throw new RunParserError("Unexpected parse result type");
+	};
+	if (parser.$mode === "async") return parseAsync(augmentedParser, args).then(handleResult);
+	else {
+		const result = parseSync(augmentedParser, args);
+		return handleResult(result);
 	}
 }
 /**
+* Runs a synchronous command-line parser with the given options.
+*
+* This is a type-safe version of {@link runParser} that only accepts sync
+* parsers. Use this when you know your parser is sync-only to get direct
+* return values without Promise wrappers.
+*
+* @template TParser The sync parser type being executed.
+* @template THelp The return type of the onHelp callback.
+* @template TError The return type of the onError callback.
+* @param parser The synchronous command-line parser to execute.
+* @param programName The name of the program for help messages.
+* @param args The command-line arguments to parse.
+* @param options Configuration options for customizing behavior.
+* @returns The parsed result if successful.
+* @since 0.9.0
+*/
+function runParserSync(parser, programName, args, options) {
+	return runParser(parser, programName, args, options);
+}
+/**
+* Runs any command-line parser asynchronously with the given options.
+*
+* This function accepts parsers of any mode (sync or async) and always
+* returns a Promise. Use this when working with parsers that may contain
+* async value parsers.
+*
+* @template TParser The parser type being executed.
+* @template THelp The return type of the onHelp callback.
+* @template TError The return type of the onError callback.
+* @param parser The command-line parser to execute.
+* @param programName The name of the program for help messages.
+* @param args The command-line arguments to parse.
+* @param options Configuration options for customizing behavior.
+* @returns A Promise of the parsed result if successful.
+* @since 0.9.0
+*/
+function runParserAsync(parser, programName, args, options) {
+	const result = runParser(parser, programName, args, options);
+	return Promise.resolve(result);
+}
+/**
 * @deprecated Use `runParser()` instead. This export will be removed in
 *             a future major version. The name `run` conflicts with
 *             `@optique/run`'s `run()` function, causing IDE autocomplete
@@ -597,4 +639,4 @@ function indentLines(text$1, indent) {
 }
 
 //#endregion
-export { RunError, RunParserError, run, runParser };
+export { RunError, RunParserError, run, runParser, runParserAsync, runParserSync };

package/dist/index.cjs

@@ -35,6 +35,8 @@ exports.formatMessage = require_message.formatMessage;
 exports.formatUsage = require_usage.formatUsage;
 exports.formatUsageTerm = require_usage.formatUsageTerm;
 exports.getDocPage = require_parser.getDocPage;
+exports.getDocPageAsync = require_parser.getDocPageAsync;
+exports.getDocPageSync = require_parser.getDocPageSync;
 exports.group = require_constructs.group;
 exports.integer = require_valueparser.integer;
 exports.isNonEmptyString = require_nonempty.isNonEmptyString;
@@ -55,12 +57,18 @@ exports.optionNames = require_message.optionNames;
 exports.optional = require_modifiers.optional;
 exports.or = require_constructs.or;
 exports.parse = require_parser.parse;
+exports.parseAsync = require_parser.parseAsync;
+exports.parseSync = require_parser.parseSync;
 exports.passThrough = require_primitives.passThrough;
 exports.pwsh = require_completion.pwsh;
 exports.run = require_facade.run;
 exports.runParser = require_facade.runParser;
+exports.runParserAsync = require_facade.runParserAsync;
+exports.runParserSync = require_facade.runParserSync;
 exports.string = require_valueparser.string;
 exports.suggest = require_parser.suggest;
+exports.suggestAsync = require_parser.suggestAsync;
+exports.suggestSync = require_parser.suggestSync;
 exports.text = require_message.text;
 exports.tuple = require_constructs.tuple;
 exports.url = require_valueparser.url;

package/dist/index.d.cts

@@ -5,8 +5,8 @@ import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, Doc
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.cjs";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, optional, withDefault } from "./modifiers.cjs";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, PassThroughFormat, PassThroughOptions, argument, command, constant, flag, option, passThrough } from "./primitives.cjs";
-import { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } from "./parser.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 { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
-import { RunError, RunOptions, RunParserError, run, runParser } from "./facade.cjs";
-export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, passThrough, pwsh, run, runParser, string, suggest, text, tuple, url, uuid, value, values, withDefault, zsh };
+import { RunError, RunOptions, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.cjs";
+export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };

package/dist/index.d.ts

@@ -5,8 +5,8 @@ import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, Doc
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.js";
 import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOptions, map, multiple, optional, withDefault } from "./modifiers.js";
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, PassThroughFormat, PassThroughOptions, argument, command, constant, flag, option, passThrough } from "./primitives.js";
-import { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } from "./parser.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 { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
-import { RunError, RunOptions, RunParserError, run, runParser } from "./facade.js";
-export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, passThrough, pwsh, run, runParser, string, suggest, text, tuple, url, uuid, value, values, withDefault, zsh };
+import { RunError, RunOptions, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.js";
+export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };

package/dist/index.js

@@ -7,7 +7,7 @@ import { WithDefaultError, map, multiple, optional, withDefault } from "./modifi
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 import { choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.js";
 import { argument, command, constant, flag, option, passThrough } from "./primitives.js";
-import { getDocPage, parse, suggest } from "./parser.js";
-import { RunError, RunParserError, run, runParser } from "./facade.js";
+import { getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
+import { RunError, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.js";
 
-export { DuplicateOptionError, RunError, RunParserError, WithDefaultError, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, passThrough, pwsh, run, runParser, string, suggest, text, tuple, url, uuid, value, values, withDefault, zsh };
+export { DuplicateOptionError, RunError, RunParserError, WithDefaultError, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };