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

package/dist/run.cjs

@@ -42,12 +42,39 @@ function runImpl(parserOrProgram, options = {}) {
 		value: typeof version === "string" ? version : version.value,
 		onShow: () => node_process.default.exit(0)
 	} : void 0;
-	const completionConfig = completion ? {
-		mode: typeof completion === "string" ? completion : completion.mode ?? "both",
-		shells: typeof completion === "string" ? void 0 : completion.shells,
-		name: typeof completion === "string" ? "both" : completion.name ?? "both",
-		onShow: () => node_process.default.exit(0)
-	} : void 0;
+	const completionConfig = (() => {
+		if (!completion) return void 0;
+		if (typeof completion === "string") return {
+			mode: completion,
+			shells: void 0,
+			name: "both",
+			helpVisibility: "both",
+			onShow: () => node_process.default.exit(0)
+		};
+		const mode = completion.mode ?? "both";
+		const shells = completion.shells;
+		if (completion.name === "singular") return {
+			mode,
+			shells,
+			name: "singular",
+			helpVisibility: completion.helpVisibility ?? "singular",
+			onShow: () => node_process.default.exit(0)
+		};
+		if (completion.name === "plural") return {
+			mode,
+			shells,
+			name: "plural",
+			helpVisibility: completion.helpVisibility ?? "plural",
+			onShow: () => node_process.default.exit(0)
+		};
+		return {
+			mode,
+			shells,
+			name: "both",
+			helpVisibility: completion.helpVisibility ?? "both",
+			onShow: () => node_process.default.exit(0)
+		};
+	})();
 	return (0, __optique_core_facade.runParser)(parser, programName, args, {
 		stderr(line) {
 			node_process.default.stderr.write(`${line}\n`);

package/dist/run.d.cts

@@ -79,17 +79,16 @@ interface RunOptions {
    * - `"both"`: Both `completion` subcommand and `--completion` option are available
    * - `object`: Advanced configuration with mode and custom shells
    *   - `mode`: "command" | "option" | "both" (default: "both")
+   *   - `name`: "singular" | "plural" | "both" (default: "both")
+   *   - `helpVisibility`: "singular" | "plural" | "both" | "none"
+   *      (default: matches `name`)
    *   - `shells`: Custom shell completions (optional)
    *
    * When not provided, completion functionality is disabled.
    *
    * @since 0.6.0
    */
-  readonly completion?: "command" | "option" | "both" | {
-    readonly mode?: "command" | "option" | "both";
-    readonly name?: "singular" | "plural" | "both";
-    readonly shells?: Record<string, ShellCompletion>;
-  };
+  readonly completion?: "command" | "option" | "both" | CompletionOptions;
   /**
    * What to display above error messages:
    *
@@ -143,6 +142,39 @@ interface RunOptions {
    */
   readonly footer?: Message;
 }
+type CompletionHelpVisibility = "singular" | "plural" | "both" | "none";
+type CompletionOptionsBase = {
+  readonly mode?: "command" | "option" | "both";
+  readonly shells?: Record<string, ShellCompletion>;
+};
+type CompletionOptionsBoth = CompletionOptionsBase & {
+  readonly name?: "both";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: CompletionHelpVisibility;
+};
+type CompletionOptionsSingular = CompletionOptionsBase & {
+  readonly name: "singular";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: "singular" | "none";
+};
+type CompletionOptionsPlural = CompletionOptionsBase & {
+  readonly name: "plural";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: "plural" | "none";
+};
+type CompletionOptions = CompletionOptionsBoth | CompletionOptionsSingular | CompletionOptionsPlural;
 /**
  * Runs a command-line parser with automatic process integration.
  *

package/dist/run.d.ts

@@ -79,17 +79,16 @@ interface RunOptions {
    * - `"both"`: Both `completion` subcommand and `--completion` option are available
    * - `object`: Advanced configuration with mode and custom shells
    *   - `mode`: "command" | "option" | "both" (default: "both")
+   *   - `name`: "singular" | "plural" | "both" (default: "both")
+   *   - `helpVisibility`: "singular" | "plural" | "both" | "none"
+   *      (default: matches `name`)
    *   - `shells`: Custom shell completions (optional)
    *
    * When not provided, completion functionality is disabled.
    *
    * @since 0.6.0
    */
-  readonly completion?: "command" | "option" | "both" | {
-    readonly mode?: "command" | "option" | "both";
-    readonly name?: "singular" | "plural" | "both";
-    readonly shells?: Record<string, ShellCompletion>;
-  };
+  readonly completion?: "command" | "option" | "both" | CompletionOptions;
   /**
    * What to display above error messages:
    *
@@ -143,6 +142,39 @@ interface RunOptions {
    */
   readonly footer?: Message;
 }
+type CompletionHelpVisibility = "singular" | "plural" | "both" | "none";
+type CompletionOptionsBase = {
+  readonly mode?: "command" | "option" | "both";
+  readonly shells?: Record<string, ShellCompletion>;
+};
+type CompletionOptionsBoth = CompletionOptionsBase & {
+  readonly name?: "both";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: CompletionHelpVisibility;
+};
+type CompletionOptionsSingular = CompletionOptionsBase & {
+  readonly name: "singular";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: "singular" | "none";
+};
+type CompletionOptionsPlural = CompletionOptionsBase & {
+  readonly name: "plural";
+  /**
+   * Controls which completion aliases are shown in help and usage output.
+   *
+   * @since 0.10.0
+   */
+  readonly helpVisibility?: "plural" | "none";
+};
+type CompletionOptions = CompletionOptionsBoth | CompletionOptionsSingular | CompletionOptionsPlural;
 /**
  * Runs a command-line parser with automatic process integration.
  *

package/dist/run.js

@@ -41,12 +41,39 @@ function runImpl(parserOrProgram, options = {}) {
 		value: typeof version === "string" ? version : version.value,
 		onShow: () => process.exit(0)
 	} : void 0;
-	const completionConfig = completion ? {
-		mode: typeof completion === "string" ? completion : completion.mode ?? "both",
-		shells: typeof completion === "string" ? void 0 : completion.shells,
-		name: typeof completion === "string" ? "both" : completion.name ?? "both",
-		onShow: () => process.exit(0)
-	} : void 0;
+	const completionConfig = (() => {
+		if (!completion) return void 0;
+		if (typeof completion === "string") return {
+			mode: completion,
+			shells: void 0,
+			name: "both",
+			helpVisibility: "both",
+			onShow: () => process.exit(0)
+		};
+		const mode = completion.mode ?? "both";
+		const shells = completion.shells;
+		if (completion.name === "singular") return {
+			mode,
+			shells,
+			name: "singular",
+			helpVisibility: completion.helpVisibility ?? "singular",
+			onShow: () => process.exit(0)
+		};
+		if (completion.name === "plural") return {
+			mode,
+			shells,
+			name: "plural",
+			helpVisibility: completion.helpVisibility ?? "plural",
+			onShow: () => process.exit(0)
+		};
+		return {
+			mode,
+			shells,
+			name: "both",
+			helpVisibility: completion.helpVisibility ?? "both",
+			onShow: () => process.exit(0)
+		};
+	})();
 	return runParser(parser, programName, args, {
 		stderr(line) {
 			process.stderr.write(`${line}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/run",
-  "version": "0.10.0-dev.360+0d55f751",
+  "version": "0.10.0-dev.363+787c7d2e",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -70,7 +70,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@optique/core": "0.10.0-dev.360+0d55f751"
+    "@optique/core": "0.10.0-dev.363+787c7d2e"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",