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

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

@@ -1,7 +1,12 @@
-import { definePlugin, resolveCommand } from "@clerc/core";
+import { DOUBLE_DASH, definePlugin, resolveCommand } from "@clerc/core";
 import tabtab, { getShellFromEnv } from "@pnpm/tabtab";
-import { formatFlagName, toArray } from "@clerc/utils";
 
+//#region ../utils/src/index.ts
+const toArray = (a) => Array.isArray(a) ? a : [a];
+const kebabCase = (s) => s.replace(/([A-Z])/g, (_, c) => `-${c.toLowerCase()}`);
+const formatFlagName = (n) => n.length <= 1 ? `-${n}` : `--${kebabCase(n)}`;
+
+//#endregion
 //#region src/complete.ts
 function splitCommand(cmd) {
 	const args = [];
@@ -33,7 +38,7 @@ function splitCommand(cmd) {
 }
 async function getCompletion(cli, env) {
 	const inputArgv = splitCommand(env.partial.slice(0, env.partial.length - env.lastPartial.length)).slice(1);
-	if (inputArgv.includes("--")) return [];
+	if (inputArgv.includes(DOUBLE_DASH)) return [];
 	const [command, commandName] = resolveCommand(cli._commands, inputArgv);
 	if (env.lastPartial.startsWith("-")) {
 		const flags = command ? {
@@ -63,12 +68,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 +89,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 +105,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 +127,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.10",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc plugin completions",
@@ -45,17 +45,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@pnpm/tabtab": "^0.5.4",
-    "@clerc/utils": "1.0.0-beta.1"
+    "@pnpm/tabtab": "^0.5.4"
   },
   "devDependencies": {
-    "@clerc/core": "1.0.0-beta.1"
+    "@clerc/core": "1.0.0-beta.10",
+    "@clerc/utils": "1.0.0-beta.10"
   },
   "peerDependencies": {
     "@clerc/core": "*"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "watch": "tsdown --watch"
   }
 }