lint

Author: AmirSa12

demo.cac.ts

@@ -1,26 +1,22 @@
-import cac from "cac";
-import tab from "./src/cac";
+import cac from 'cac';
+import tab from './src/cac';
 
-const cli = cac("vite");
+const cli = cac('vite');
 
 cli
-  .option("-c, --config <file>", `Use specified config file`)
-  .option("-m, --mode <mode>", `Set env mode`)
-  .option("-l, --logLevel <level>", `info | warn | error | silent`);
+  .option('-c, --config <file>', `Use specified config file`)
+  .option('-m, --mode <mode>', `Set env mode`)
+  .option('-l, --logLevel <level>', `info | warn | error | silent`);
 
 cli
-  .command("dev", "Start dev server")
-  .option("--host [host]", `Specify hostname`)
-  .option("--port <port>", `Specify port`)
+  .command('dev', 'Start dev server')
+  .option('--host [host]', `Specify hostname`)
+  .option('--port <port>', `Specify port`)
   .action((options) => {});
 
-cli
-  .command("dev build", "Build project")
-  .action((options) => {});
+cli.command('dev build', 'Build project').action((options) => {});
 
-cli
-  .command("lint [...files]", "Lint project")
-  .action((files, options) => {});
+cli.command('lint [...files]', 'Lint project').action((files, options) => {});
 
 const completion = await tab(cli);
 

demo.citty.ts

@@ -31,8 +31,7 @@ const devCommand = defineCommand({
     host: { type: 'string', description: 'Specify hostname' },
     port: { type: 'string', description: 'Specify port' },
   },
-  run(ctx) {
-  },
+  run(ctx) {},
 });
 
 devCommand.subCommands = {
@@ -53,8 +52,7 @@ const lintCommand = defineCommand({
   args: {
     files: { type: 'positional', description: 'Files to lint' },
   },
-  run(ctx) {
-  },
+  run(ctx) {},
 });
 
 main.subCommands = {
@@ -65,7 +63,6 @@ main.subCommands = {
 const completion = await tab(main);
 
 for (const command of completion.commands.values()) {
-
   if (command.name === 'lint') {
     command.handler = () => {
       return [

index.ts

@@ -1,3 +1,3 @@
-export * from './src/index';
-export * from './src/citty';
-export * from './src/cac';
+export * from './src/index';
+export * from './src/citty';
+export * from './src/cac';

src/cac.ts

@@ -1,20 +1,20 @@
-import * as zsh from "./zsh";
-import * as bash from "./bash";
-import * as fish from "./fish";
-import * as powershell from "./powershell";
-import type { CAC } from "cac";
-import { Completion } from "./";
+import * as zsh from './zsh';
+import * as bash from './bash';
+import * as fish from './fish';
+import * as powershell from './powershell';
+import type { CAC } from 'cac';
+import { Completion } from './';
 
 const execPath = process.execPath;
 const processArgs = process.argv.slice(1);
 const quotedExecPath = quoteIfNeeded(execPath);
 const quotedProcessArgs = processArgs.map(quoteIfNeeded);
 const quotedProcessExecArgs = process.execArgv.map(quoteIfNeeded);
 
-const x = `${quotedExecPath} ${quotedProcessExecArgs.join(" ")} ${quotedProcessArgs[0]}`;
+const x = `${quotedExecPath} ${quotedProcessExecArgs.join(' ')} ${quotedProcessArgs[0]}`;
 
 function quoteIfNeeded(path: string): string {
-  return path.includes(" ") ? `'${path}'` : path;
+  return path.includes(' ') ? `'${path}'` : path;
 }
 
 // export default function tab(instance: CAC): void {
@@ -300,8 +300,9 @@ export default function tab(instance: CAC): Completion {
     if (cmd.name === 'complete') continue; // Skip completion command
 
     // Get positional args info from command usage
-    const args = (cmd.rawName.match(/\[.*?\]|\<.*?\>/g) || [])
-      .map(arg => arg.startsWith('['));  // true if optional (wrapped in [])
+    const args = (cmd.rawName.match(/\[.*?\]|\<.*?\>/g) || []).map((arg) =>
+      arg.startsWith('[')
+    ); // true if optional (wrapped in [])
 
     // Add command to completion
     const commandName = completion.addCommand(
@@ -322,30 +323,30 @@ export default function tab(instance: CAC): Completion {
     }
   }
 
-  instance.command("complete [shell]").action(async (shell, extra) => {
+  instance.command('complete [shell]').action(async (shell, extra) => {
     switch (shell) {
-      case "zsh": {
+      case 'zsh': {
         const script = zsh.generate(instance.name, x);
         console.log(script);
         break;
       }
-      case "bash": {
+      case 'bash': {
         const script = bash.generate(instance.name, x);
         console.log(script);
         break;
       }
-      case "fish": {
+      case 'fish': {
         const script = fish.generate(instance.name, x);
         console.log(script);
         break;
       }
-      case "powershell": {
+      case 'powershell': {
         const script = powershell.generate(instance.name, x);
         console.log(script);
         break;
       }
       default: {
-        const args: string[] = extra["--"];
+        const args: string[] = extra['--'];
         instance.showHelpOnExit = false;
 
         // Parse current command context
@@ -363,4 +364,4 @@ export default function tab(instance: CAC): Completion {
   });
 
   return completion;
-}
+}

src/index.ts

@@ -80,15 +80,15 @@ type Option = {
 type Command = {
   name: string;
   description: string;
-  args: boolean[]
+  args: boolean[];
   handler: Handler;
   options: Map<string, Option>;
   parent?: Command;
 };
 
 export class Completion {
   commands = new Map<string, Command>();
-  completions: Item[] = []
+  completions: Item[] = [];
   directive = ShellCompDirective.ShellCompDirectiveDefault;
 
   // vite <entry> <another> [...files]
@@ -129,37 +129,37 @@ export class Completion {
 
   // TODO: this should be aware of boolean args and stuff
   private stripOptions(args: string[]): string[] {
-    const parts: string[] = []
+    const parts: string[] = [];
     let option = false;
     for (const k of args) {
       if (k.startsWith('-')) {
         option = true;
-        continue
+        continue;
       }
       if (option) {
         option = false;
-        continue
+        continue;
       }
-      parts.push(k)
+      parts.push(k);
     }
-    return parts
+    return parts;
   }
 
   private matchCommand(args: string[]): [Command, string[]] {
     args = this.stripOptions(args);
     let parts: string[] = [];
     let remaining: string[] = [];
-    let matched: Command = this.commands.get('')! 
+    let matched: Command = this.commands.get('')!;
     for (let i = 0; i < args.length; i++) {
       const k = args[i];
       parts.push(k);
-      const potential = this.commands.get(parts.join(' '))
-      
+      const potential = this.commands.get(parts.join(' '));
+
       if (potential) {
         matched = potential;
       } else {
         remaining = args.slice(i, args.length);
-        break
+        break;
       }
     }
     return [matched, remaining];
@@ -188,31 +188,27 @@ export class Completion {
     if (this.shouldCompleteFlags(lastPrevArg, toComplete, endsWithSpace)) {
       await this.handleFlagCompletion(
         matchedCommand,
-        previousArgs, 
+        previousArgs,
         toComplete,
         endsWithSpace,
-        lastPrevArg,
+        lastPrevArg
       );
-    }
-    else {
+    } else {
       // 2. Handle command/subcommand completion
       if (this.shouldCompleteCommands(toComplete, endsWithSpace)) {
-        await this.handleCommandCompletion(
-          previousArgs,
-          toComplete,
-        );
+        await this.handleCommandCompletion(previousArgs, toComplete);
       }
       // 3. Handle positional arguments
       if (matchedCommand && matchedCommand.args.length > 0) {
         await this.handlePositionalCompletion(
           matchedCommand,
           previousArgs,
           toComplete,
-          endsWithSpace,
+          endsWithSpace
         );
       }
     }
-    this.complete(toComplete)
+    this.complete(toComplete);
   }
 
   private complete(toComplete: string) {
@@ -226,24 +222,33 @@ export class Completion {
         return true;
       })
       .filter((comp) => comp.value.startsWith(toComplete))
-      .forEach((comp) => console.log(`${comp.value}\t${comp.description ?? ''}`));
+      .forEach((comp) =>
+        console.log(`${comp.value}\t${comp.description ?? ''}`)
+      );
     console.log(`:${this.directive}`);
   }
 
-  private shouldCompleteFlags(lastPrevArg: string | undefined, toComplete: string, endsWithSpace: boolean): boolean {
-    return (lastPrevArg?.startsWith('--')) || toComplete.startsWith('--');
+  private shouldCompleteFlags(
+    lastPrevArg: string | undefined,
+    toComplete: string,
+    endsWithSpace: boolean
+  ): boolean {
+    return lastPrevArg?.startsWith('--') || toComplete.startsWith('--');
   }
 
-  private shouldCompleteCommands(toComplete: string, endsWithSpace: boolean): boolean {
+  private shouldCompleteCommands(
+    toComplete: string,
+    endsWithSpace: boolean
+  ): boolean {
     return !toComplete.startsWith('-');
   }
 
   private async handleFlagCompletion(
     command: Command,
-    previousArgs: string[], 
+    previousArgs: string[],
     toComplete: string,
     endsWithSpace: boolean,
-    lastPrevArg: string | undefined,
+    lastPrevArg: string | undefined
   ) {
     // Handle flag value completion
     let flagName: string | undefined;
@@ -262,12 +267,16 @@ export class Completion {
     if (flagName) {
       const option = command.options.get(flagName);
       if (option) {
-        const suggestions = await option.handler(previousArgs, valueToComplete, endsWithSpace);
+        const suggestions = await option.handler(
+          previousArgs,
+          valueToComplete,
+          endsWithSpace
+        );
         if (toComplete.includes('=')) {
           // Reconstruct the full flag=value format
-          this.completions = suggestions.map(suggestion => ({
+          this.completions = suggestions.map((suggestion) => ({
             value: `${flagName}=${suggestion.value}`,
-            description: suggestion.description
+            description: suggestion.description,
           }));
         } else {
           this.completions.push(...suggestions);
@@ -282,7 +291,7 @@ export class Completion {
         if (name.startsWith(toComplete)) {
           this.completions.push({
             value: name,
-            description: option.description
+            description: option.description,
           });
         }
       }
@@ -291,27 +300,27 @@ export class Completion {
 
   private async handleCommandCompletion(
     previousArgs: string[],
-    toComplete: string,
+    toComplete: string
   ) {
     const commandParts = [...previousArgs];
 
     for (const k of this.commands.keys()) {
       if (k === '') continue;
       const parts = k.split(' ');
       let match = true;
-      
+
       let i = 0;
       while (i < commandParts.length) {
         if (parts[i] !== commandParts[i]) {
           match = false;
-          break
+          break;
         }
         i++;
       }
       if (match && parts[i]?.startsWith(toComplete)) {
         this.completions.push({
           value: parts[i],
-          description: this.commands.get(k)!.description
+          description: this.commands.get(k)!.description,
         });
       }
     }
@@ -321,9 +330,13 @@ export class Completion {
     command: Command,
     previousArgs: string[],
     toComplete: string,
-    endsWithSpace: boolean,
+    endsWithSpace: boolean
   ) {
-    const suggestions = await command.handler(previousArgs, toComplete, endsWithSpace);
+    const suggestions = await command.handler(
+      previousArgs,
+      toComplete,
+      endsWithSpace
+    );
     this.completions.push(...suggestions);
   }
 }