@optique/core 0.10.0-dev.360 → 0.10.0-dev.367

package/dist/constructs.cjs

@@ -6,6 +6,57 @@ const require_suggestion = require('./suggestion.cjs');
 
 //#region src/constructs.ts
 /**
+* Collects option names and command names that are valid at the current
+* parse position by walking the usage tree.  Only "leading" candidates
+* (those reachable before a required positional argument) are collected.
+*/
+function collectLeadingCandidates(terms, optionNames, commandNames) {
+	if (!terms || !Array.isArray(terms)) return true;
+	for (const term of terms) {
+		if (term.type === "option") {
+			for (const name of term.names) optionNames.add(name);
+			return false;
+		}
+		if (term.type === "command") {
+			commandNames.add(term.name);
+			return false;
+		}
+		if (term.type === "argument") return false;
+		if (term.type === "optional") {
+			collectLeadingCandidates(term.terms, optionNames, commandNames);
+			continue;
+		}
+		if (term.type === "multiple") {
+			collectLeadingCandidates(term.terms, optionNames, commandNames);
+			if (term.min === 0) continue;
+			return false;
+		}
+		if (term.type === "exclusive") {
+			let allAlternativesSkippable = true;
+			for (const exclusiveUsage of term.terms) {
+				const alternativeSkippable = collectLeadingCandidates(exclusiveUsage, optionNames, commandNames);
+				allAlternativesSkippable = allAlternativesSkippable && alternativeSkippable;
+			}
+			if (allAlternativesSkippable) continue;
+			return false;
+		}
+	}
+	return true;
+}
+function createUnexpectedInputErrorWithScopedSuggestions(baseError, invalidInput, parsers, customFormatter) {
+	const options = /* @__PURE__ */ new Set();
+	const commands = /* @__PURE__ */ new Set();
+	for (const parser of parsers) collectLeadingCandidates(parser.usage, options, commands);
+	const candidates = new Set([...options, ...commands]);
+	const suggestions = require_suggestion.findSimilar(invalidInput, candidates, require_suggestion.DEFAULT_FIND_SIMILAR_OPTIONS);
+	const suggestionMsg = customFormatter ? customFormatter(suggestions) : require_suggestion.createSuggestionMessage(suggestions);
+	return suggestionMsg.length > 0 ? [
+		...baseError,
+		require_message.text("\n\n"),
+		...suggestionMsg
+	] : baseError;
+}
+/**
 * Checks if the given token is an option name that requires a value
 * (i.e., has a metavar) within the given usage terms.
 * @param usage The usage terms to search through.
@@ -200,16 +251,6 @@ function getNoMatchError(options, noMatchContext) {
 	return customNoMatch ? typeof customNoMatch === "function" ? customNoMatch(noMatchContext) : customNoMatch : generateNoMatchError(noMatchContext);
 }
 /**
-* Creates default error for parse() method when buffer is not empty.
-* Shared by or() and longestMatch().
-* @internal
-*/
-function createUnexpectedInputError(token, usage, options) {
-	const defaultMsg = require_message.message`Unexpected option or subcommand: ${require_message.optionName(token)}.`;
-	if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
-	return require_suggestion.createErrorWithSuggestions(defaultMsg, token, usage, "both", options?.errors?.suggestions);
-}
-/**
 * @since 0.5.0
 */
 function or(...args) {
@@ -227,7 +268,12 @@ function or(...args) {
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
-		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : createUnexpectedInputError(context.buffer[0], context.usage, options)
+		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : (() => {
+			const token = context.buffer[0];
+			const defaultMsg = require_message.message`Unexpected option or subcommand: ${require_message.optionName(token)}.`;
+			if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
+			return createUnexpectedInputErrorWithScopedSuggestions(defaultMsg, token, parsers, options?.errors?.suggestions);
+		})()
 	});
 	const parseSync = (context) => {
 		let error = getInitialError(context);
@@ -423,7 +469,12 @@ function longestMatch(...args) {
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
-		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : createUnexpectedInputError(context.buffer[0], context.usage, options)
+		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : (() => {
+			const token = context.buffer[0];
+			const defaultMsg = require_message.message`Unexpected option or subcommand: ${require_message.optionName(token)}.`;
+			if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
+			return createUnexpectedInputErrorWithScopedSuggestions(defaultMsg, token, parsers, options?.errors?.suggestions);
+		})()
 	});
 	const parseSync = (context) => {
 		let bestMatch = null;

package/dist/constructs.js

@@ -1,11 +1,62 @@
-import { message, optionName, values } from "./message.js";
+import { message, optionName, text, values } from "./message.js";
 import { DependencyRegistry, dependencyId, isDeferredParseState, isDependencySourceState, isPendingDependencySourceState, isWrappedDependencySource, parseWithDependency, wrappedDependencySourceMarker } from "./dependency.js";
 import { dispatchByMode, dispatchIterableByMode } from "./mode-dispatch.js";
 import { extractArgumentMetavars, extractCommandNames, extractOptionNames } from "./usage.js";
-import { createErrorWithSuggestions, deduplicateSuggestions } from "./suggestion.js";
+import { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, createSuggestionMessage, deduplicateSuggestions, findSimilar } from "./suggestion.js";
 
 //#region src/constructs.ts
 /**
+* Collects option names and command names that are valid at the current
+* parse position by walking the usage tree.  Only "leading" candidates
+* (those reachable before a required positional argument) are collected.
+*/
+function collectLeadingCandidates(terms, optionNames, commandNames) {
+	if (!terms || !Array.isArray(terms)) return true;
+	for (const term of terms) {
+		if (term.type === "option") {
+			for (const name of term.names) optionNames.add(name);
+			return false;
+		}
+		if (term.type === "command") {
+			commandNames.add(term.name);
+			return false;
+		}
+		if (term.type === "argument") return false;
+		if (term.type === "optional") {
+			collectLeadingCandidates(term.terms, optionNames, commandNames);
+			continue;
+		}
+		if (term.type === "multiple") {
+			collectLeadingCandidates(term.terms, optionNames, commandNames);
+			if (term.min === 0) continue;
+			return false;
+		}
+		if (term.type === "exclusive") {
+			let allAlternativesSkippable = true;
+			for (const exclusiveUsage of term.terms) {
+				const alternativeSkippable = collectLeadingCandidates(exclusiveUsage, optionNames, commandNames);
+				allAlternativesSkippable = allAlternativesSkippable && alternativeSkippable;
+			}
+			if (allAlternativesSkippable) continue;
+			return false;
+		}
+	}
+	return true;
+}
+function createUnexpectedInputErrorWithScopedSuggestions(baseError, invalidInput, parsers, customFormatter) {
+	const options = /* @__PURE__ */ new Set();
+	const commands = /* @__PURE__ */ new Set();
+	for (const parser of parsers) collectLeadingCandidates(parser.usage, options, commands);
+	const candidates = new Set([...options, ...commands]);
+	const suggestions = findSimilar(invalidInput, candidates, DEFAULT_FIND_SIMILAR_OPTIONS);
+	const suggestionMsg = customFormatter ? customFormatter(suggestions) : createSuggestionMessage(suggestions);
+	return suggestionMsg.length > 0 ? [
+		...baseError,
+		text("\n\n"),
+		...suggestionMsg
+	] : baseError;
+}
+/**
 * Checks if the given token is an option name that requires a value
 * (i.e., has a metavar) within the given usage terms.
 * @param usage The usage terms to search through.
@@ -200,16 +251,6 @@ function getNoMatchError(options, noMatchContext) {
 	return customNoMatch ? typeof customNoMatch === "function" ? customNoMatch(noMatchContext) : customNoMatch : generateNoMatchError(noMatchContext);
 }
 /**
-* Creates default error for parse() method when buffer is not empty.
-* Shared by or() and longestMatch().
-* @internal
-*/
-function createUnexpectedInputError(token, usage, options) {
-	const defaultMsg = message`Unexpected option or subcommand: ${optionName(token)}.`;
-	if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
-	return createErrorWithSuggestions(defaultMsg, token, usage, "both", options?.errors?.suggestions);
-}
-/**
 * @since 0.5.0
 */
 function or(...args) {
@@ -227,7 +268,12 @@ function or(...args) {
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
-		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : createUnexpectedInputError(context.buffer[0], context.usage, options)
+		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : (() => {
+			const token = context.buffer[0];
+			const defaultMsg = message`Unexpected option or subcommand: ${optionName(token)}.`;
+			if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
+			return createUnexpectedInputErrorWithScopedSuggestions(defaultMsg, token, parsers, options?.errors?.suggestions);
+		})()
 	});
 	const parseSync = (context) => {
 		let error = getInitialError(context);
@@ -423,7 +469,12 @@ function longestMatch(...args) {
 	const syncParsers = parsers;
 	const getInitialError = (context) => ({
 		consumed: 0,
-		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : createUnexpectedInputError(context.buffer[0], context.usage, options)
+		error: context.buffer.length < 1 ? getNoMatchError(options, noMatchContext) : (() => {
+			const token = context.buffer[0];
+			const defaultMsg = message`Unexpected option or subcommand: ${optionName(token)}.`;
+			if (options?.errors?.unexpectedInput != null) return typeof options.errors.unexpectedInput === "function" ? options.errors.unexpectedInput(token) : options.errors.unexpectedInput;
+			return createUnexpectedInputErrorWithScopedSuggestions(defaultMsg, token, parsers, options?.errors?.suggestions);
+		})()
 	});
 	const parseSync = (context) => {
 		let bestMatch = null;

package/dist/facade.cjs

@@ -55,7 +55,7 @@ function createVersionParser(mode) {
 /**
 * Creates completion parsers based on the specified mode.
 */
-function createCompletionParser(mode, programName, availableShells, name = "both") {
+function createCompletionParser(mode, programName, availableShells, name = "both", helpVisibility = name) {
 	const shellList = [];
 	for (const shell in availableShells) {
 		if (shellList.length > 0) shellList.push(require_message.text(", "));
@@ -78,18 +78,27 @@ function createCompletionParser(mode, programName, availableShells, name = "both
 `
 	};
 	const completionCommands = [];
-	if (name === "singular" || name === "both") completionCommands.push(require_primitives.command("completion", completionInner, completionCommandConfig));
-	if (name === "plural" || name === "both") completionCommands.push(require_primitives.command("completions", completionInner, completionCommandConfig));
+	const showSingular = helpVisibility === "singular" || helpVisibility === "both";
+	const showPlural = helpVisibility === "plural" || helpVisibility === "both";
+	if (name === "singular" || name === "both") completionCommands.push(require_primitives.command("completion", completionInner, {
+		...completionCommandConfig,
+		hidden: !showSingular
+	}));
+	if (name === "plural" || name === "both") completionCommands.push(require_primitives.command("completions", completionInner, {
+		...completionCommandConfig,
+		hidden: !showPlural
+	}));
 	const completionCommand = require_constructs.longestMatch(...completionCommands);
-	const completionOptionNames = [];
-	if (name === "singular" || name === "both") completionOptionNames.push("--completion");
-	if (name === "plural" || name === "both") completionOptionNames.push("--completions");
-	const completionOptionArgs = [
-		...completionOptionNames,
-		require_valueparser.string({ metavar: "SHELL" }),
-		{ description: require_message.message`Generate shell completion script.` }
-	];
-	const completionOption = require_primitives.option(...completionOptionArgs);
+	const completionOptions = [];
+	if (name === "singular" || name === "both") completionOptions.push(require_primitives.option("--completion", require_valueparser.string({ metavar: "SHELL" }), {
+		description: require_message.message`Generate shell completion script.`,
+		hidden: !showSingular
+	}));
+	if (name === "plural" || name === "both") completionOptions.push(require_primitives.option("--completions", require_valueparser.string({ metavar: "SHELL" }), {
+		description: require_message.message`Generate shell completion script.`,
+		hidden: !showPlural
+	}));
+	const completionOption = completionOptions.length === 1 ? completionOptions[0] : require_constructs.longestMatch(completionOptions[0], completionOptions[1]);
 	const argsParser = require_modifiers.withDefault(require_modifiers.multiple(require_primitives.argument(require_valueparser.string({ metavar: "ARG" }), { description: require_message.message`Command line arguments for completion suggestions (used by shell integration; you usually don't need to provide this).` })), []);
 	const optionParser = require_constructs.object({
 		shell: completionOption,
@@ -441,6 +450,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 	const onVersion = options.version?.onShow ?? (() => ({}));
 	const completionMode = options.completion?.mode ?? "both";
 	const completionName = options.completion?.name ?? "both";
+	const completionHelpVisibility = options.completion?.helpVisibility ?? completionName;
 	const onCompletion = options.completion?.onShow ?? (() => ({}));
 	const defaultShells = {
 		bash: require_completion.bash,
@@ -467,7 +477,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 	const completionParsers = completion === "none" ? {
 		completionCommand: null,
 		completionOption: null
-	} : createCompletionParser(completion, programName, availableShells, completionName);
+	} : createCompletionParser(completion, programName, availableShells, completionName, completionHelpVisibility);
 	if (options.completion) {
 		const hasHelpOption = args.includes("--help");
 		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && ((completionName === "singular" || completionName === "both" ? args[0] === "completion" : false) || (completionName === "plural" || completionName === "both" ? args[0] === "completions" : false)) && !hasHelpOption) return handleCompletion(args.slice(1), programName, parser, completionParsers.completionCommand, stdout, stderr, onCompletion, onError, availableShells, colors, maxWidth, completionMode, completionName);
@@ -482,9 +492,9 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 			} else {
 				const singularMatchExact = completionName === "singular" || completionName === "both" ? arg === "--completion" : false;
 				const pluralMatchExact = completionName === "plural" || completionName === "both" ? arg === "--completions" : false;
-				if ((singularMatchExact || pluralMatchExact) && i + 1 < args.length) {
-					const shell = args[i + 1];
-					const completionArgs = args.slice(i + 2);
+				if (singularMatchExact || pluralMatchExact) {
+					const shell = i + 1 < args.length ? args[i + 1] : "";
+					const completionArgs = i + 1 < args.length ? args.slice(i + 2) : [];
 					return handleCompletion([shell, ...completionArgs], programName, parser, completionParsers.completionCommand, stdout, stderr, onCompletion, onError, availableShells, colors, maxWidth, completionMode, completionName);
 				}
 			}

package/dist/facade.d.cts

@@ -7,6 +7,81 @@ import { Program } from "./program.cjs";
 
 //#region src/facade.d.ts
 
+/**
+ * Naming style for shell completion command and option aliases.
+ *
+ * @since 0.10.0
+ */
+type CompletionName = "singular" | "plural" | "both";
+/**
+ * Visibility policy for completion entries in help and usage output.
+ *
+ * @since 0.10.0
+ */
+type CompletionHelpVisibility = CompletionName | "none";
+type CompletionConfigBase<THelp> = {
+  /**
+   * Determines how completion is made available:
+   *
+   * - `"command"`: Only the `completion` subcommand is available
+   * - `"option"`: Only the `--completion` option is available
+   * - `"both"`: Both `completion` subcommand and `--completion` option are available
+   *
+   * @default `"both"`
+   */
+  readonly mode?: "command" | "option" | "both";
+  /**
+   * Available shell completions. By default, includes `bash`, `fish`, `nu`,
+   * `pwsh`, and `zsh`. You can provide additional custom shell completions or
+   * override the defaults.
+   *
+   * @default `{ bash, fish, nu, pwsh, zsh }`
+   */
+  readonly shells?: Record<string, ShellCompletion>;
+  /**
+   * Callback function invoked when completion is requested. The function can
+   * optionally receive an exit code parameter.
+   *
+   * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+   * on Deno to this option.
+   *
+   * @default Returns `void` when completion is shown.
+   */
+  readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+};
+type CompletionConfigBoth<THelp> = CompletionConfigBase<THelp> & {
+  /**
+   * Determines whether to use singular or plural naming for completion command/option.
+   *
+   * - `"singular"`: Use `completion` / `--completion`
+   * - `"plural"`: Use `completions` / `--completions`
+   * - `"both"`: Use both singular and plural forms
+   *
+   * @default `"both"`
+   */
+  readonly name?: "both";
+  /**
+   * Controls which completion entries appear in help and usage output.
+   *
+   * - `"both"`: Show both singular and plural entries
+   * - `"singular"`: Show only singular entries
+   * - `"plural"`: Show only plural entries
+   * - `"none"`: Hide completion entries from help and usage
+   *
+   * @default Matches `name`
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: CompletionHelpVisibility;
+};
+type CompletionConfigSingular<THelp> = CompletionConfigBase<THelp> & {
+  readonly name: "singular";
+  readonly helpVisibility?: "singular" | "none";
+};
+type CompletionConfigPlural<THelp> = CompletionConfigBase<THelp> & {
+  readonly name: "plural";
+  readonly helpVisibility?: "plural" | "none";
+};
+type CompletionConfig<THelp> = CompletionConfigBoth<THelp> | CompletionConfigSingular<THelp> | CompletionConfigPlural<THelp>;
 /**
  * Configuration options for the {@link run} function.
  *
@@ -95,46 +170,7 @@ interface RunOptions<THelp, TError> {
    * Completion configuration. When provided, enables shell completion functionality.
    * @since 0.6.0
    */
-  readonly completion?: {
-    /**
-     * Determines how completion is made available:
-     *
-     * - `"command"`: Only the `completion` subcommand is available
-     * - `"option"`: Only the `--completion` option is available
-     * - `"both"`: Both `completion` subcommand and `--completion` option are available
-     *
-     * @default `"both"`
-     */
-    readonly mode?: "command" | "option" | "both";
-    /**
-     * Determines whether to use singular or plural naming for completion command/option.
-     *
-     * - `"singular"`: Use `completion` / `--completion`
-     * - `"plural"`: Use `completions` / `--completions`
-     * - `"both"`: Use both singular and plural forms
-     *
-     * @default `"both"`
-     */
-    readonly name?: "singular" | "plural" | "both";
-    /**
-     * Available shell completions. By default, includes `bash`, `fish`, `nu`,
-     * `pwsh`, and `zsh`. You can provide additional custom shell completions or
-     * override the defaults.
-     *
-     * @default `{ bash, fish, nu, pwsh, zsh }`
-     */
-    readonly shells?: Record<string, ShellCompletion>;
-    /**
-     * Callback function invoked when completion is requested. The function can
-     * optionally receive an exit code parameter.
-     *
-     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
-     * on Deno to this option.
-     *
-     * @default Returns `void` when completion is shown.
-     */
-    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
-  };
+  readonly completion?: CompletionConfig<THelp>;
   /**
    * What to display above error messages:
    * - `"usage"`: Show usage information
@@ -412,4 +448,4 @@ declare function runWithSync<TParser extends Parser<"sync", unknown, unknown>, T
  */
 declare function runWithAsync<TParser extends Parser<Mode, unknown, unknown>, TContexts extends readonly SourceContext<unknown>[], THelp = void, TError = never>(parser: TParser, programName: string, contexts: TContexts, options: RunWithOptions<THelp, TError> & ExtractRequiredOptions<TContexts, InferValue<TParser>>): Promise<InferValue<TParser>>;
 //#endregion
-export { ExtractRequiredOptions, type ParserValuePlaceholder, RunOptions, RunParserError, RunWithOptions, type SourceContext, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync };
+export { CompletionHelpVisibility, CompletionName, ExtractRequiredOptions, type ParserValuePlaceholder, RunOptions, RunParserError, RunWithOptions, type SourceContext, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync };

package/dist/facade.d.ts

@@ -7,6 +7,81 @@ import { Program } from "./program.js";
 
 //#region src/facade.d.ts
 
+/**
+ * Naming style for shell completion command and option aliases.
+ *
+ * @since 0.10.0
+ */
+type CompletionName = "singular" | "plural" | "both";
+/**
+ * Visibility policy for completion entries in help and usage output.
+ *
+ * @since 0.10.0
+ */
+type CompletionHelpVisibility = CompletionName | "none";
+type CompletionConfigBase<THelp> = {
+  /**
+   * Determines how completion is made available:
+   *
+   * - `"command"`: Only the `completion` subcommand is available
+   * - `"option"`: Only the `--completion` option is available
+   * - `"both"`: Both `completion` subcommand and `--completion` option are available
+   *
+   * @default `"both"`
+   */
+  readonly mode?: "command" | "option" | "both";
+  /**
+   * Available shell completions. By default, includes `bash`, `fish`, `nu`,
+   * `pwsh`, and `zsh`. You can provide additional custom shell completions or
+   * override the defaults.
+   *
+   * @default `{ bash, fish, nu, pwsh, zsh }`
+   */
+  readonly shells?: Record<string, ShellCompletion>;
+  /**
+   * Callback function invoked when completion is requested. The function can
+   * optionally receive an exit code parameter.
+   *
+   * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
+   * on Deno to this option.
+   *
+   * @default Returns `void` when completion is shown.
+   */
+  readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
+};
+type CompletionConfigBoth<THelp> = CompletionConfigBase<THelp> & {
+  /**
+   * Determines whether to use singular or plural naming for completion command/option.
+   *
+   * - `"singular"`: Use `completion` / `--completion`
+   * - `"plural"`: Use `completions` / `--completions`
+   * - `"both"`: Use both singular and plural forms
+   *
+   * @default `"both"`
+   */
+  readonly name?: "both";
+  /**
+   * Controls which completion entries appear in help and usage output.
+   *
+   * - `"both"`: Show both singular and plural entries
+   * - `"singular"`: Show only singular entries
+   * - `"plural"`: Show only plural entries
+   * - `"none"`: Hide completion entries from help and usage
+   *
+   * @default Matches `name`
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: CompletionHelpVisibility;
+};
+type CompletionConfigSingular<THelp> = CompletionConfigBase<THelp> & {
+  readonly name: "singular";
+  readonly helpVisibility?: "singular" | "none";
+};
+type CompletionConfigPlural<THelp> = CompletionConfigBase<THelp> & {
+  readonly name: "plural";
+  readonly helpVisibility?: "plural" | "none";
+};
+type CompletionConfig<THelp> = CompletionConfigBoth<THelp> | CompletionConfigSingular<THelp> | CompletionConfigPlural<THelp>;
 /**
  * Configuration options for the {@link run} function.
  *
@@ -95,46 +170,7 @@ interface RunOptions<THelp, TError> {
    * Completion configuration. When provided, enables shell completion functionality.
    * @since 0.6.0
    */
-  readonly completion?: {
-    /**
-     * Determines how completion is made available:
-     *
-     * - `"command"`: Only the `completion` subcommand is available
-     * - `"option"`: Only the `--completion` option is available
-     * - `"both"`: Both `completion` subcommand and `--completion` option are available
-     *
-     * @default `"both"`
-     */
-    readonly mode?: "command" | "option" | "both";
-    /**
-     * Determines whether to use singular or plural naming for completion command/option.
-     *
-     * - `"singular"`: Use `completion` / `--completion`
-     * - `"plural"`: Use `completions` / `--completions`
-     * - `"both"`: Use both singular and plural forms
-     *
-     * @default `"both"`
-     */
-    readonly name?: "singular" | "plural" | "both";
-    /**
-     * Available shell completions. By default, includes `bash`, `fish`, `nu`,
-     * `pwsh`, and `zsh`. You can provide additional custom shell completions or
-     * override the defaults.
-     *
-     * @default `{ bash, fish, nu, pwsh, zsh }`
-     */
-    readonly shells?: Record<string, ShellCompletion>;
-    /**
-     * Callback function invoked when completion is requested. The function can
-     * optionally receive an exit code parameter.
-     *
-     * You usually want to pass `process.exit` on Node.js or Bun and `Deno.exit`
-     * on Deno to this option.
-     *
-     * @default Returns `void` when completion is shown.
-     */
-    readonly onShow?: (() => THelp) | ((exitCode: number) => THelp);
-  };
+  readonly completion?: CompletionConfig<THelp>;
   /**
    * What to display above error messages:
    * - `"usage"`: Show usage information
@@ -412,4 +448,4 @@ declare function runWithSync<TParser extends Parser<"sync", unknown, unknown>, T
  */
 declare function runWithAsync<TParser extends Parser<Mode, unknown, unknown>, TContexts extends readonly SourceContext<unknown>[], THelp = void, TError = never>(parser: TParser, programName: string, contexts: TContexts, options: RunWithOptions<THelp, TError> & ExtractRequiredOptions<TContexts, InferValue<TParser>>): Promise<InferValue<TParser>>;
 //#endregion
-export { ExtractRequiredOptions, type ParserValuePlaceholder, RunOptions, RunParserError, RunWithOptions, type SourceContext, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync };
+export { CompletionHelpVisibility, CompletionName, ExtractRequiredOptions, type ParserValuePlaceholder, RunOptions, RunParserError, RunWithOptions, type SourceContext, SubstituteParserValue, runParser, runParserAsync, runParserSync, runWith, runWithAsync, runWithSync };

package/dist/facade.js

@@ -55,7 +55,7 @@ function createVersionParser(mode) {
 /**
 * Creates completion parsers based on the specified mode.
 */
-function createCompletionParser(mode, programName, availableShells, name = "both") {
+function createCompletionParser(mode, programName, availableShells, name = "both", helpVisibility = name) {
 	const shellList = [];
 	for (const shell in availableShells) {
 		if (shellList.length > 0) shellList.push(text(", "));
@@ -78,18 +78,27 @@ function createCompletionParser(mode, programName, availableShells, name = "both
 `
 	};
 	const completionCommands = [];
-	if (name === "singular" || name === "both") completionCommands.push(command("completion", completionInner, completionCommandConfig));
-	if (name === "plural" || name === "both") completionCommands.push(command("completions", completionInner, completionCommandConfig));
+	const showSingular = helpVisibility === "singular" || helpVisibility === "both";
+	const showPlural = helpVisibility === "plural" || helpVisibility === "both";
+	if (name === "singular" || name === "both") completionCommands.push(command("completion", completionInner, {
+		...completionCommandConfig,
+		hidden: !showSingular
+	}));
+	if (name === "plural" || name === "both") completionCommands.push(command("completions", completionInner, {
+		...completionCommandConfig,
+		hidden: !showPlural
+	}));
 	const completionCommand = longestMatch(...completionCommands);
-	const completionOptionNames = [];
-	if (name === "singular" || name === "both") completionOptionNames.push("--completion");
-	if (name === "plural" || name === "both") completionOptionNames.push("--completions");
-	const completionOptionArgs = [
-		...completionOptionNames,
-		string({ metavar: "SHELL" }),
-		{ description: message`Generate shell completion script.` }
-	];
-	const completionOption = option(...completionOptionArgs);
+	const completionOptions = [];
+	if (name === "singular" || name === "both") completionOptions.push(option("--completion", string({ metavar: "SHELL" }), {
+		description: message`Generate shell completion script.`,
+		hidden: !showSingular
+	}));
+	if (name === "plural" || name === "both") completionOptions.push(option("--completions", string({ metavar: "SHELL" }), {
+		description: message`Generate shell completion script.`,
+		hidden: !showPlural
+	}));
+	const completionOption = completionOptions.length === 1 ? completionOptions[0] : longestMatch(completionOptions[0], completionOptions[1]);
 	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,
@@ -441,6 +450,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 	const onVersion = options.version?.onShow ?? (() => ({}));
 	const completionMode = options.completion?.mode ?? "both";
 	const completionName = options.completion?.name ?? "both";
+	const completionHelpVisibility = options.completion?.helpVisibility ?? completionName;
 	const onCompletion = options.completion?.onShow ?? (() => ({}));
 	const defaultShells = {
 		bash,
@@ -467,7 +477,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 	const completionParsers = completion === "none" ? {
 		completionCommand: null,
 		completionOption: null
-	} : createCompletionParser(completion, programName, availableShells, completionName);
+	} : createCompletionParser(completion, programName, availableShells, completionName, completionHelpVisibility);
 	if (options.completion) {
 		const hasHelpOption = args.includes("--help");
 		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && ((completionName === "singular" || completionName === "both" ? args[0] === "completion" : false) || (completionName === "plural" || completionName === "both" ? args[0] === "completions" : false)) && !hasHelpOption) return handleCompletion(args.slice(1), programName, parser, completionParsers.completionCommand, stdout, stderr, onCompletion, onError, availableShells, colors, maxWidth, completionMode, completionName);
@@ -482,9 +492,9 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 			} else {
 				const singularMatchExact = completionName === "singular" || completionName === "both" ? arg === "--completion" : false;
 				const pluralMatchExact = completionName === "plural" || completionName === "both" ? arg === "--completions" : false;
-				if ((singularMatchExact || pluralMatchExact) && i + 1 < args.length) {
-					const shell = args[i + 1];
-					const completionArgs = args.slice(i + 2);
+				if (singularMatchExact || pluralMatchExact) {
+					const shell = i + 1 < args.length ? args[i + 1] : "";
+					const completionArgs = i + 1 < args.length ? args.slice(i + 2) : [];
 					return handleCompletion([shell, ...completionArgs], programName, parser, completionParsers.completionCommand, stdout, stderr, onCompletion, onError, availableShells, colors, maxWidth, completionMode, completionName);
 				}
 			}

package/dist/index.d.cts

@@ -11,5 +11,5 @@ import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOpti
 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 { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { ParserValuePlaceholder, SourceContext } from "./context.cjs";
-import { ExtractRequiredOptions, 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, ConditionalErrorOptions, ConditionalOptions, 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, 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, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, choice, cidr, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isPendingDependencySourceState, isValueParser, isWrappedDependencySource, link, locale, longestMatch, macAddress, map, merge, 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 };
+import { CompletionHelpVisibility, CompletionName, ExtractRequiredOptions, 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, CompletionHelpVisibility, CompletionName, ConditionalErrorOptions, ConditionalOptions, 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, 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, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, choice, cidr, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isPendingDependencySourceState, isValueParser, isWrappedDependencySource, link, locale, longestMatch, macAddress, map, merge, 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

@@ -11,5 +11,5 @@ import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOpti
 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 { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { ParserValuePlaceholder, SourceContext } from "./context.js";
-import { ExtractRequiredOptions, 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, ConditionalErrorOptions, ConditionalOptions, 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, 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, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, choice, cidr, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isPendingDependencySourceState, isValueParser, isWrappedDependencySource, link, locale, longestMatch, macAddress, map, merge, 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 };
+import { CompletionHelpVisibility, CompletionName, ExtractRequiredOptions, 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, CompletionHelpVisibility, CompletionName, ConditionalErrorOptions, ConditionalOptions, 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, 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, OrErrorOptions, OrOptions, type ParseOptions, Parser, ParserContext, ParserResult, ParserValuePlaceholder, PassThroughFormat, PassThroughOptions, PendingDependencySourceState, PortOptionsBigInt, PortOptionsNumber, PortRangeOptionsBigInt, PortRangeOptionsNumber, PortRangeValueBigInt, PortRangeValueNumber, ResolvedDependency, Result, RunOptions, RunParserError, RunWithOptions, ShellCompletion, ShowDefaultOptions, SocketAddressOptions, SocketAddressValue, SourceContext, StringOptions, SubstituteParserValue, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, type ValueSetOptions, WithDefaultError, WithDefaultOptions, annotationKey, argument, bash, choice, cidr, command, commandLine, concat, conditional, constant, createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, defaultValues, deferredParseMarker, dependency, dependencyId, dependencyIds, dependencySourceMarker, dependencySourceStateMarker, deriveFrom, deriveFromAsync, deriveFromSync, derivedValueParserMarker, domain, email, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDependencyError, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getAnnotations, getDefaultValuesFunction, getDependencyIds, getDocPage, getDocPageAsync, getDocPageSync, group, hostname, integer, ip, ipv4, ipv6, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isNonEmptyString, isPendingDependencySourceState, isValueParser, isWrappedDependencySource, link, locale, longestMatch, macAddress, map, merge, 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/suggestion.cjs

@@ -232,5 +232,6 @@ function deduplicateSuggestions(suggestions) {
 //#endregion
 exports.DEFAULT_FIND_SIMILAR_OPTIONS = DEFAULT_FIND_SIMILAR_OPTIONS;
 exports.createErrorWithSuggestions = createErrorWithSuggestions;
+exports.createSuggestionMessage = createSuggestionMessage;
 exports.deduplicateSuggestions = deduplicateSuggestions;
 exports.findSimilar = findSimilar;

package/dist/suggestion.js

@@ -230,4 +230,4 @@ function deduplicateSuggestions(suggestions) {
 }
 
 //#endregion
-export { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, deduplicateSuggestions, findSimilar };
+export { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, createSuggestionMessage, deduplicateSuggestions, findSimilar };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.10.0-dev.360+0d55f751",
+  "version": "0.10.0-dev.367+dd14db26",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",