@clerc/plugin-completions 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/index.d.ts

@@ -1,9 +1,24 @@
 import { Plugin } from "@clerc/core";
 
 //#region src/index.d.ts
+declare module "@clerc/core" {
+  interface CommandCustomOptions {
+    /**
+    * Completions options for the command.
+    */
+    completions?: {
+      /**
+      * Whether to show the command in completions output.
+      *
+      * @default true
+      */
+      show?: boolean;
+    };
+  }
+}
 interface CompletionsPluginOptions {
   /**
-  * Whether to register the `install-completions` and `uninstall-completions` commands.
+  * Whether to register the `completions install` and `completions uninstall` commands.
   * @default true
   */
   managementCommands?: boolean;

package/dist/index.js

@@ -63,12 +63,15 @@ async function getCompletion(cli, env) {
 		const remainingArgs = inputArgv.slice(matchedParts.length);
 		prefix = `${[command.name, ...remainingArgs].join(" ")} `;
 	} else prefix = inputArgv.length > 0 ? `${inputArgv.join(" ")} ` : "";
-	for (const c of cli._commands.values()) if (c.name.startsWith(prefix)) {
-		const nextWord = c.name.slice(prefix.length).split(" ")[0];
-		if (nextWord) candidates.push({
-			name: nextWord,
-			description: c.description
-		});
+	for (const command$1 of cli._commands.values()) {
+		if (command$1.completions?.show === false) continue;
+		if (command$1.name.startsWith(prefix)) {
+			const nextWord = command$1.name.slice(prefix.length).split(" ")[0];
+			if (nextWord) candidates.push({
+				name: nextWord,
+				description: command$1.description
+			});
+		}
 	}
 	const uniqueCandidates = /* @__PURE__ */ new Map();
 	for (const c of candidates) uniqueCandidates.set(c.name, c);
@@ -81,6 +84,7 @@ const completionsPlugin = (options = {}) => definePlugin({ setup: (cli) => {
 	const { managementCommands = true } = options;
 	if (managementCommands) {
 		cli.command("completions install", "Install shell completions", {
+			help: { group: "completions" },
 			flags: { shell: {
 				description: "Shell type",
 				type: String
@@ -96,11 +100,12 @@ const completionsPlugin = (options = {}) => definePlugin({ setup: (cli) => {
 				shell
 			});
 		});
-		cli.command("completions uninstall", "Uninstall shell completions").on("completions uninstall", async () => {
+		cli.command("completions uninstall", "Uninstall shell completions", { help: { group: "completions" } }).on("completions uninstall", async () => {
 			await tabtab.uninstall({ name: cli._name });
 		});
 	}
 	cli.command("completions", "Generate completions script", {
+		help: { group: "completions" },
 		flags: { shell: {
 			description: "Shell type",
 			type: String
@@ -117,7 +122,7 @@ const completionsPlugin = (options = {}) => definePlugin({ setup: (cli) => {
 		});
 		console.log(script);
 	});
-	cli.command("completion-server", "Handle completions").on("completion-server", async () => {
+	cli.command("completion-server", "Handle completions", { help: { show: false } }).on("completion-server", async () => {
 		const env = tabtab.parseEnv(process.env);
 		if (!env.complete) return;
 		const shell = getShellFromEnv(process.env);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/plugin-completions",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc plugin completions",
@@ -46,10 +46,10 @@
   },
   "dependencies": {
     "@pnpm/tabtab": "^0.5.4",
-    "@clerc/utils": "1.0.0-beta.1"
+    "@clerc/utils": "1.0.0-beta.3"
   },
   "devDependencies": {
-    "@clerc/core": "1.0.0-beta.1"
+    "@clerc/core": "1.0.0-beta.3"
   },
   "peerDependencies": {
     "@clerc/core": "*"