npm - @optique/core - Versions diffs - 0.10.0-dev.360 → 0.10.0-dev.363 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/facade.cjs CHANGED Viewed

@@ -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);

package/dist/facade.d.cts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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);

package/dist/index.d.cts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/package.json CHANGED Viewed

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