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

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, parseAsync, parseSync, suggest, suggestAsync } from "./parser.js";
+import { getDocPage, parse, suggest } from "./parser.js";
 
 //#region src/facade.ts
 /**
@@ -89,11 +89,6 @@ 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,
@@ -101,11 +96,17 @@ function createCompletionParser(mode, programName, availableShells, name = "both
 		};
 		case "option": return {
 			completionCommand: null,
-			completionOption: optionParser
+			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).` })), [])
+			})
 		};
 		case "both": return {
 			completionCommand,
-			completionOption: optionParser
+			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).` })), [])
+			})
 		};
 	}
 }
@@ -116,7 +117,6 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 	const parsers = [];
 	if (helpParsers.helpOption) {
 		const lenientHelpParser = {
-			$mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 200,
@@ -178,11 +178,12 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 					value: state
 				};
 			},
-			*suggest(_context, prefix) {
-				if ("--help".startsWith(prefix)) yield {
+			suggest(_context, prefix) {
+				if ("--help".startsWith(prefix)) return [{
 					kind: "literal",
 					text: "--help"
-				};
+				}];
+				return [];
 			},
 			getDocFragments(state) {
 				return helpParsers.helpOption?.getDocFragments(state) ?? { fragments: [] };
@@ -192,7 +193,6 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 	}
 	if (versionParsers.versionOption) {
 		const lenientVersionParser = {
-			$mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 200,
@@ -246,11 +246,12 @@ function combineWithHelpVersion(originalParser, helpParsers, versionParsers, com
 					value: state
 				};
 			},
-			*suggest(_context, prefix) {
-				if ("--version".startsWith(prefix)) yield {
+			suggest(_context, prefix) {
+				if ("--version".startsWith(prefix)) return [{
 					kind: "literal",
 					text: "--version"
-				};
+				}];
+				return [];
 			},
 			getDocFragments(state) {
 				return versionParsers.versionOption?.getDocFragments(state) ?? { fragments: [] };
@@ -345,20 +346,6 @@ 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) {
@@ -368,43 +355,72 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 				maxWidth
 			}));
 		}
-		if (parser.$mode === "async") return Promise.resolve(callOnError(1));
-		return callOnError(1);
+		try {
+			return onError(1);
+		} catch {
+			return onError();
+		}
 	}
 	const shell = availableShells[shellName];
 	if (!shell) {
 		const available = [];
-		for (const name in availableShells) {
+		for (const shell$1 in availableShells) {
 			if (available.length > 0) available.push(text(", "));
-			available.push(value(name));
+			available.push(value(shell$1));
 		}
 		stderr(formatMessage(message`Error: Unsupported shell ${shellName}. Available shells: ${available}.`, {
 			colors,
 			quotes: !colors
 		}));
-		if (parser.$mode === "async") return Promise.resolve(callOnError(1));
-		return callOnError(1);
+		return onError(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);
-		if (parser.$mode === "async") return Promise.resolve(callOnCompletion(0));
-		return callOnCompletion(0);
+	} 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 (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 = {}) {
-	const { colors, maxWidth, showDefault, aboveError = "usage", onError = () => {
+	let { 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";
@@ -464,155 +480,97 @@ function runParser(parser, programName, args, options = {}) {
 		}
 	}
 	const augmentedParser = help === "none" && version === "none" && completion === "none" ? parser : combineWithHelpVersion(parser, helpParsers, versionParsers, completionParsers);
-	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();
+	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);
 				}
-			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 (versionAsCommand) {
+					if (versionParsers.versionCommand) commandParsers.push(versionParsers.versionCommand);
 				}
-				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();
-					}
+				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);
+			}
+			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 docOrPromise = getDocPage(helpGeneratorParser, classified.commands);
-				if (docOrPromise instanceof Promise) return docOrPromise.then(displayHelp);
-				return displayHelp(docOrPromise);
+				stdout(formatDocPage(programName, augmentedDoc, {
+					colors,
+					maxWidth,
+					showDefault
+				}));
 			}
-			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, {
+			try {
+				return onHelp(0);
+			} catch {
+				return onHelp();
+			}
+		}
+		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, {
 						colors,
-						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);
+						maxWidth,
+						showDefault
+					}));
 				}
-				return displayError(void 0, aboveError);
 			}
-			default: throw new RunParserError("Unexpected parse result type");
+			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);
 		}
-	};
-	if (parser.$mode === "async") return parseAsync(augmentedParser, args).then(handleResult);
-	else {
-		const result = parseSync(augmentedParser, args);
-		return handleResult(result);
+		default: throw new RunParserError("Unexpected parse result type");
 	}
 }
 /**
-* 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
@@ -639,4 +597,4 @@ function indentLines(text$1, indent) {
 }
 
 //#endregion
-export { RunError, RunParserError, run, runParser, runParserAsync, runParserSync };
+export { RunError, RunParserError, run, runParser };

package/dist/index.cjs

@@ -35,8 +35,6 @@ 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;
@@ -57,18 +55,12 @@ 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 { 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 { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } 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, 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 };
+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 };

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 { 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 { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } 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, 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 };
+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 };

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, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
-import { RunError, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.js";
+import { getDocPage, parse, suggest } from "./parser.js";
+import { RunError, RunParserError, run, runParser } 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, 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 };
+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 };