@pablozaiden/terminatui 0.6.0 → 0.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pablozaiden/terminatui",
-  "version": "0.6.0",
+  "version": "0.6.3",
   "description": "Terminal UI and Command Line Application Framework",
   "repository": {
     "url": "https://github.com/PabloZaiden/terminatui",

package/src/builtins/help.ts

@@ -21,6 +21,7 @@ export class HelpCommand extends Command<OptionSchema> {
   private allCommands: AnyCommand[] = [];
   private appName: string;
   private appVersion: string;
+  private commandPath: string[] = [];
 
   constructor(config: {
     parentCommand?: AnyCommand;
@@ -35,6 +36,14 @@ export class HelpCommand extends Command<OptionSchema> {
     this.appVersion = config.appVersion;
   }
 
+  /**
+   * Set the command path for this help command.
+   * Called by the Application before executing help.
+   */
+  setCommandPath(path: string[]): void {
+    this.commandPath = path;
+  }
+
   /**
    * Help command is CLI-only (auto-injected for CLI use, not shown in TUI).
    */
@@ -45,11 +54,15 @@ export class HelpCommand extends Command<OptionSchema> {
   override async execute(): Promise<CommandResult> {
     let helpText: string;
 
+    // Get the parent command path (exclude "help" from the end if present)
+    const parentPath = this.commandPath.filter(p => p !== KNOWN_COMMANDS.help);
+
     if (this.parentCommand) {
       // Show help for the parent command
       helpText = generateCommandHelp(this.parentCommand, {
         appName: this.appName,
         version: this.appVersion,
+        commandPath: parentPath,
         globalOptionsSchema: GLOBAL_OPTIONS_SCHEMA,
       });
     } else {

package/src/core/application.ts

@@ -1,7 +1,6 @@
 import { AppContext, type AppConfig } from "./context.ts";
 import { Command, type AnyCommand, ConfigValidationError, type CommandExecutionContext } from "./command.ts";
 import { CommandRegistry } from "./registry.ts";
-import { ExecutionMode } from "../types/execution.ts";
 import { LogLevel, type LoggerConfig } from "./logger.ts";
 import {
   extractCommandChain,
@@ -341,8 +340,10 @@ export class Application {
       return;
     }
 
-    // Determine execution mode
-    const mode = this.detectExecutionMode(command, flagArgs);
+    // If this is a help command being executed directly, set its command path
+    if ('setCommandPath' in command && typeof command.setCommandPath === 'function') {
+      (command as { setCommandPath: (path: string[]) => void }).setCommandPath(commandPath);
+    }
 
     // Parse options
     const schema = command.options ?? {};
@@ -364,13 +365,13 @@ export class Application {
     let options;
     try {
       options = parseOptionValues(schema, parsedValues);
-     } catch (err) {
-       // Enum validation error from parseOptionValues
-       AppContext.current.logger.error(`Error: ${(err as Error).message}\n`);
-       await this.printHelpForCommand(command, commandPath);
-       process.exitCode = 1;
-       return;
-     }
+    } catch (err) {
+      // Enum validation error from parseOptionValues
+      AppContext.current.logger.error(`Error: ${(err as Error).message}\n`);
+      await this.printHelpForCommand(command, commandPath);
+      process.exitCode = 1;
+      return;
+    }
 
 
     // Validate options (required, min/max, etc.)
@@ -409,17 +410,14 @@ export class Application {
       const ctx: CommandExecutionContext = { signal: new AbortController().signal };
       const commandResult = await command.execute(config, ctx);
 
-      // In CLI mode, handle result output
-      if (mode === ExecutionMode.Cli) {
-        if (commandResult.success) {
-          // Output data as JSON to stdout if present
-          if (commandResult.data !== undefined) {
-            console.log(JSON.stringify(commandResult.data, null, 2));
-          }
-        } else {
-          // Set exit code for failures
-          process.exitCode = 1;
+      if (commandResult.success) {
+        // Output data as JSON to stdout if present
+        if (commandResult.data !== undefined) {
+          console.log(JSON.stringify(commandResult.data, null, 2));
         }
+      } else {
+        // Set exit code for failures
+        process.exitCode = 1;
       }
     } catch (e) {
       error = e as Error;
@@ -456,6 +454,11 @@ export class Application {
       throw new Error(`Help command not injected for '${resolvedCommandPath.join(" ")}'`);
     }
 
+    // Set the command path on the help command so it can generate correct usage
+    if ('setCommandPath' in helpCommand && typeof helpCommand.setCommandPath === 'function') {
+      (helpCommand as { setCommandPath: (path: string[]) => void }).setCommandPath(resolvedCommandPath);
+    }
+
     await this.executeCommand(helpCommand, [], [...resolvedCommandPath, KNOWN_COMMANDS.help]);
   }
 
@@ -479,19 +482,6 @@ export class Application {
     return !hasCustomExecute;
   }
 
-  /**
-   * Detect the execution mode based on command and args.
-   */
-  private detectExecutionMode(command: AnyCommand, args: string[]): ExecutionMode {
-    // If no args and command supports TUI, use TUI mode
-    if (args.length === 0 && command.supportsTui()) {
-      return ExecutionMode.Tui;
-    }
-
-    // Otherwise use CLI mode
-    return ExecutionMode.Cli;
-  }
-
   /**
    * Parse global options from argv.
    * Returns the parsed global options and remaining args.
@@ -514,7 +504,7 @@ export class Application {
     const rawGlobalOptions = parseOptionValues(GLOBAL_OPTIONS_SCHEMA, result.values) as GlobalOptions;
 
     const globalOptions: GlobalOptions = { ...rawGlobalOptions };
-    
+
     const remainingArgs: string[] = [];
     for (const token of result.tokens ?? []) {
       if (token.kind === "positional") {

package/src/core/help.ts

@@ -112,7 +112,7 @@ export function formatExamples(command: AnyCommand): string {
  * @returns Formatted help text
  */
 export function generateCommandHelp(command: AnyCommand, options: HelpOptions = {}): string {
-  const { appName = "cli", version } = options;
+  const { appName = "cli", version, commandPath = [] } = options;
   const sections: string[] = [];
 
   // Header with version
@@ -164,8 +164,14 @@ export function generateCommandHelp(command: AnyCommand, options: HelpOptions =
 
   // Help hint
   if (command.hasSubCommands()) {
+    // Build the full command path for the hint
+    const fullPath = [appName, ...commandPath];
+    // Add command name if not already in path
+    if (commandPath.length === 0 || commandPath[commandPath.length - 1] !== command.name) {
+      fullPath.push(command.name);
+    }
     sections.push(
-      `\n${colors.dim(`Run '${appName} ${command.name} <command> help' for more information on a command.`)}`
+      `\n${colors.dim(`Run '${fullPath.join(" ")} <command> help' for more information on a command.`)}`
     );
   }
 

package/src/types/execution.ts

@@ -1,11 +0,0 @@
-/**
- * Execution mode determines how a command runs.
- * - Cli: Command-line mode with arguments, executes and exits
- * - Tui: Terminal UI mode with interactive rendering
- */
-export enum ExecutionMode {
-  /** Command-line mode: parse args, execute, exit */
-  Cli = "cli",
-  /** Terminal UI mode: interactive render loop */
-  Tui = "tui",
-}