@pablozaiden/terminatui 0.2.0 → 0.3.0-beta-1

package/AGENTS.md

@@ -1,4 +1,16 @@
-Default to using Bun instead of Node.js.
+## General guidelines
+
+- Never use `git` operations. That's up to the user.
+- Always prefer simplicity, usability and top level type safety over cleverness.
+- Don't create index.ts files that re-export things from other files. Always import directly from the file you need.
+- Prefer classes over standalone functions when it makes sense.
+- Before doing something, check the patterns used in the rest of the codebase.
+- Never use `import("...")` dynamic imports. Always use static imports (unless absolutely necessary).
+
+## Bun specifics
+This is a Bun-only project. Never check if something might not be supported in another environment. You can assume Bun is always available.
+
+Always use Bun features and APIs where possible.
 
 - Use `bun <file>` instead of `node <file>` or `ts-node <file>`
 - Use `bun test` instead of `jest` or `vitest`
@@ -28,4 +40,4 @@ test("hello world", () => {
 });
 ```
 
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.
+For more information, read the Bun API docs in `node_modules/bun-types/docs/**.mdx`.

package/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/README.md

@@ -12,7 +12,7 @@ A type-safe, class-based framework for building CLI and TUI applications in Type
 - **Nested subcommands** - Hierarchical command structures with path resolution
 - **Lifecycle hooks** - `beforeExecute()` and `afterExecute()` hooks on commands
 - **Service container** - `AppContext` provides dependency injection for services
-- **Integrated logging** - Logger with TUI-aware output handling
+- **Integrated logging** - Logger with TUI-aware output handling (live log modal with global copy shortcut)
 - **Cancellation support** - AbortSignal-based cancellation for long-running commands
 - **Config validation** - `buildConfig()` hook for transforming and validating options
 
@@ -27,7 +27,12 @@ bun add @pablozaiden/terminatui
 ### 1. Define a Command
 
 ```typescript
-import { Command, type AppContext, type OptionSchema, type CommandResult } from "@pablozaiden/terminatui";
+import {
+  Command,
+  type OptionSchema,
+  type CommandResult,
+  type CommandExecutionContext,
+} from "@pablozaiden/terminatui";
 
 const greetOptions = {
   name: {
@@ -48,7 +53,10 @@ class GreetCommand extends Command<typeof greetOptions> {
   readonly description = "Greet someone";
   readonly options = greetOptions;
 
-  override execute(ctx: AppContext, config: { name: string; loud: boolean }): CommandResult {
+  override execute(
+    config: { name: string; loud: boolean },
+    _execCtx: CommandExecutionContext
+  ): CommandResult {
     const message = `Hello, ${config.name}!`;
     console.log(config.loud ? message.toUpperCase() : message);
     return { success: true, message };
@@ -77,7 +85,11 @@ class MyApp extends Application {
 
 ```typescript
 // index.ts
+// Recommended: let Terminatui read `Bun.argv.slice(2)`
 await new MyApp().run();
+
+// For tests or programmatic invocation:
+// await new MyApp().runFromArgs(["greet", "--name", "World"]);
 ```
 
 ```bash
@@ -121,9 +133,8 @@ abstract class Command<TOptions extends OptionSchema = OptionSchema, TConfig = u
   
   // Required: Main execution method
   abstract execute(
-    ctx: AppContext, 
     config: TConfig,
-    execCtx?: CommandExecutionContext
+    execCtx: CommandExecutionContext
   ): Promise<CommandResult | void> | CommandResult | void;
   
   // Optional: Transform/validate options before execute
@@ -170,10 +181,15 @@ The `Application` class manages command registration and execution:
 ```typescript
 class Application {
   constructor(config: ApplicationConfig);
-  
-  run(args?: string[]): Promise<void>;
+
+  // Recommended entrypoint (reads `Bun.argv.slice(2)`)
+  run(): Promise<void>;
+
+  // Useful for tests or programmatic invocation
+  runFromArgs(argv: string[]): Promise<void>;
+
   getContext(): AppContext;
-  
+
   // Lifecycle hooks (override in subclass)
   onBeforeRun?(command: Command, options: Record<string, unknown>): void;
   onAfterRun?(command: Command, result: unknown): void;
@@ -196,6 +212,8 @@ Access application-wide services and configuration:
 
 ```typescript
 import { AppContext } from "@pablozaiden/terminatui";
+import type { CommandExecutionContext } from "@pablozaiden/terminatui";
+import { AbortError } from "@pablozaiden/terminatui";
 
 // Get the current context (set during Application.run())
 const ctx = AppContext.current;
@@ -234,7 +252,7 @@ interface OptionDef {
   tuiHidden?: boolean;       // Hide from TUI form
 }
 
-type OptionSchema = Record<string, OptionDef>;
+type OptionSchema = Record<string, OptionDef>; // See library types
 ```
 
 ## Config Validation with buildConfig
@@ -242,7 +260,7 @@ type OptionSchema = Record<string, OptionDef>;
 Use `buildConfig()` to transform and validate options before execution:
 
 ```typescript
-import { Command, ConfigValidationError, type AppContext, type OptionValues } from "@pablozaiden/terminatui";
+import { Command, ConfigValidationError, type OptionValues } from "@pablozaiden/terminatui";
 
 interface MyConfig {
   resolvedPath: string;
@@ -254,7 +272,7 @@ class MyCommand extends Command<typeof myOptions, MyConfig> {
   readonly description = "Do something";
   readonly options = myOptions;
 
-  override buildConfig(ctx: AppContext, opts: OptionValues<typeof myOptions>): MyConfig {
+  override buildConfig(opts: OptionValues<typeof myOptions>): MyConfig {
     const pathRaw = opts["path"] as string | undefined;
     if (!pathRaw) {
       throw new ConfigValidationError("Missing required option: path", "path");
@@ -271,9 +289,16 @@ class MyCommand extends Command<typeof myOptions, MyConfig> {
     };
   }
 
-  override async execute(ctx: AppContext, config: MyConfig): Promise<CommandResult> {
+  override async execute(
+    config: MyConfig,
+    execCtx: CommandExecutionContext
+  ): Promise<CommandResult> {
     // config is now typed as MyConfig
-    ctx.logger.info(`Processing ${config.count} items from ${config.resolvedPath}`);
+    if (execCtx.signal.aborted) {
+      throw new AbortError("Command was cancelled");
+    }
+
+    AppContext.current.logger.info(`Processing ${config.count} items from ${config.resolvedPath}`);
     return { success: true };
   }
 }
@@ -288,19 +313,18 @@ class LongRunningCommand extends Command<typeof options> {
   // ...
 
   override async execute(
-    ctx: AppContext, 
     config: Config,
-    execCtx?: CommandExecutionContext
+    execCtx: CommandExecutionContext
   ): Promise<CommandResult> {
     for (const item of items) {
       // Check for cancellation
-      if (execCtx?.signal.aborted) {
+      if (execCtx.signal.aborted) {
         throw new AbortError("Command was cancelled");
       }
-      
-      await processItem(item, execCtx?.signal);
+
+      await processItem(item, execCtx.signal);
     }
-    
+
     return { success: true };
   }
 }
@@ -350,6 +374,9 @@ Extend `TuiApplication` instead of `Application` to get automatic TUI support:
 import { TuiApplication, Command } from "@pablozaiden/terminatui";
 
 class MyApp extends TuiApplication {
+  // Each app decides what "default" means.
+  protected override defaultRenderer = "opentui" as const;
+
   constructor() {
     super({
       name: "myapp",
@@ -362,11 +389,13 @@ class MyApp extends TuiApplication {
 }
 ```
 
-When run with no arguments, the app launches an interactive TUI instead of showing help:
+Execution mode is controlled only by the selected mode (`--mode`) or the app’s configured default mode.
 
 ```bash
-myapp              # Launches TUI
-myapp run --verbose # Runs in CLI mode
+myapp                           # Uses app default mode
+myapp --mode opentui            # Forces TUI (OpenTUI)
+myapp --mode ink                # Forces TUI (Ink)
+myapp --mode cli run --verbose  # Forces CLI
 ```
 
 ### TUI Metadata
@@ -412,14 +441,15 @@ class RunCommand extends Command<typeof runOptions, RunConfig> {
   override readonly immediateExecution = false;     // Run immediately on selection
 
   // Return structured results for display
-  override async execute(ctx: AppContext, config: RunConfig): Promise<CommandResult> {
-    const result = await runTask(config);
-    return { 
-      success: true, 
-      data: result,
-      message: "Task completed"
-    };
-  }
+   override async execute(config: RunConfig, _execCtx: CommandExecutionContext): Promise<CommandResult> {
+     const result = await runTask(config);
+     return {
+       success: true,
+       data: result,
+       message: "Task completed",
+     };
+   }
+
 
   // Custom result rendering (React/TSX)
   override renderResult(result: CommandResult): ReactNode {
@@ -452,7 +482,7 @@ The built-in TUI provides:
 - **Command Selector** - Navigate and select commands with arrow keys
 - **Config Form** - Auto-generated forms from option schemas with field groups
 - **Field Editor** - Edit field values (text, number, boolean, enum)
-- **CLI Modal** - View equivalent CLI command (press `C`)
+- **CLI Args Button** - View equivalent CLI command from the config form
 - **Results Panel** - Display command results with custom rendering
 - **Logs Panel** - View application logs in real-time
 - **Clipboard Support** - Centralized copy with Ctrl+Y
@@ -464,9 +494,8 @@ The built-in TUI provides:
 | Key | Action |
 |-----|--------|
 | ↑/↓ | Navigate fields/commands |
-| Enter | Edit field / Execute command |
+| Enter | Edit field / Execute command / Press button |
 | Tab | Cycle focus between panels |
-| C | Show CLI command modal |
 | L | Toggle logs panel |
 | Ctrl+Y | Copy current content to clipboard |
 | Esc | Back / Cancel running command |
@@ -486,7 +515,7 @@ import {
   useKeyboardHandler,    // Register keyboard handlers with priority
   useClipboard,          // Clipboard operations with OSC 52
   useLogStream,          // Stream logs from logger
-  useSpinner,            // Animated spinner
+  // (renderer-specific) Spinner UI lives in adapters
   useCommandExecutor,    // Execute commands with cancellation
   
   // Context
@@ -494,7 +523,6 @@ import {
   KeyboardPriority,      // Global < Focused < Modal
   
   // Components
-  Theme,                 // TUI color theme
   JsonHighlight,         // Syntax-highlighted JSON display
 } from "@pablozaiden/terminatui";
 ```
@@ -504,19 +532,12 @@ import {
 Terminatui includes utilities for formatted CLI output:
 
 ```typescript
-import { colors, table, bulletList, keyValueList } from "@pablozaiden/terminatui";
+import { colors } from "@pablozaiden/terminatui";
 
 // Colors
 console.log(colors.red("Error!"));
 console.log(colors.success("Done!"));  // ✓ Done!
 console.log(colors.bold(colors.blue("Title")));
-
-// Tables
-console.log(table(data, ["name", "value", "status"]));
-
-// Lists
-console.log(bulletList(["Item 1", "Item 2", "Item 3"]));
-console.log(keyValueList({ name: "Test", count: 42 }));
 ```
 
 ## License

package/bun.lock

@@ -6,6 +6,9 @@
       "name": "@pablozaiden/terminatui",
       "dependencies": {
         "@opentui/react": "0.1.68",
+        "ink": "^6.6.0",
+        "ink-select-input": "^6.2.0",
+        "ink-text-input": "^6.0.0",
         "tslog": "^4.9.3",
       },
       "devDependencies": {
@@ -19,6 +22,8 @@
     },
   },
   "packages": {
+    "@alcalzone/ansi-tokenize": ["@alcalzone/ansi-tokenize@0.2.3", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-jsElTJ0sQ4wHRz+C45tfect76BwbTbgkgKByOzpCN9xG61N5V6u/glvg1CsNJhq2xJIFpKHSwG3D2wPPuEYOrQ=="],
+
     "@dimforge/rapier2d-simd-compat": ["@dimforge/rapier2d-simd-compat@0.17.3", "", {}, "sha512-bijvwWz6NHsNj5e5i1vtd3dU2pDhthSaTUZSh14DUGGKJfw8eMnlWZsxwHBxB/a3AXVNDjL9abuHw1k9FGR+jg=="],
 
     "@jimp/core": ["@jimp/core@1.6.0", "", { "dependencies": { "@jimp/file-ops": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0", "await-to-js": "^3.0.0", "exif-parser": "^0.1.12", "file-type": "^16.0.0", "mime": "3" } }, "sha512-EQQlKU3s9QfdJqiSrZWNTxBs3rKXgO2W+GxNXDtwchF3a4IqxDheFX1ti+Env9hdJXDiYLp2jTRjlxhPthsk8w=="],
@@ -105,8 +110,16 @@
 
     "abort-controller": ["abort-controller@3.0.0", "", { "dependencies": { "event-target-shim": "^5.0.0" } }, "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg=="],
 
+    "ansi-escapes": ["ansi-escapes@7.2.0", "", { "dependencies": { "environment": "^1.0.0" } }, "sha512-g6LhBsl+GBPRWGWsBtutpzBYuIIdBkLEvad5C/va/74Db018+5TZiyA26cZJAr3Rft5lprVqOIPxf5Vid6tqAw=="],
+
+    "ansi-regex": ["ansi-regex@6.2.2", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],
+
+    "ansi-styles": ["ansi-styles@6.2.3", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],
+
     "any-base": ["any-base@1.1.0", "", {}, "sha512-uMgjozySS8adZZYePpaWs8cxB9/kdzmpX6SgJZ+wbz1K5eYk5QMYDVJaZKhxyIHUdnnJkfR7SVgStgH7LkGUyg=="],
 
+    "auto-bind": ["auto-bind@5.0.1", "", {}, "sha512-ooviqdwwgfIfNmDwo94wlshcdzfO64XV0Cg6oDsDYBJfITDz1EngD2z7DkbvCWn+XIMsIqW27sEVF6qcpJrRcg=="],
+
     "await-to-js": ["await-to-js@3.0.0", "", {}, "sha512-zJAaP9zxTcvTHRlejau3ZOY4V7SRpiByf3/dxx2uyKxxor19tpmpV2QRsTKikckwhaPmr2dVpxxMr7jOCYVp5g=="],
 
     "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
@@ -129,32 +142,74 @@
 
     "bun-webgpu-win32-x64": ["bun-webgpu-win32-x64@0.1.4", "", { "os": "win32", "cpu": "x64" }, "sha512-Z5yAK28xrcm8Wb5k7TZ8FJKpOI/r+aVCRdlHYAqI2SDJFN3nD4mJs900X6kNVmG/xFzb5yOuKVYWGg+6ZXWbyA=="],
 
+    "chalk": ["chalk@5.6.2", "", {}, "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA=="],
+
+    "cli-boxes": ["cli-boxes@3.0.0", "", {}, "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g=="],
+
+    "cli-cursor": ["cli-cursor@4.0.0", "", { "dependencies": { "restore-cursor": "^4.0.0" } }, "sha512-VGtlMu3x/4DOtIUwEkRezxUZ2lBacNJCHash0N0WeZDBS+7Ux1dm3XWAgWYxLJFMMdOeXMHXorshEFhbMSGelg=="],
+
+    "cli-truncate": ["cli-truncate@5.1.1", "", { "dependencies": { "slice-ansi": "^7.1.0", "string-width": "^8.0.0" } }, "sha512-SroPvNHxUnk+vIW/dOSfNqdy1sPEFkrTk6TUtqLCnBlo3N7TNYYkzzN7uSD6+jVjrdO4+p8nH7JzH6cIvUem6A=="],
+
+    "code-excerpt": ["code-excerpt@4.0.0", "", { "dependencies": { "convert-to-spaces": "^2.0.1" } }, "sha512-xxodCmBen3iy2i0WtAK8FlFNrRzjUqjRsMfho58xT/wvZU1YTM3fCnRjcy1gJPMepaRlgm/0e6w8SpWHpn3/cA=="],
+
+    "convert-to-spaces": ["convert-to-spaces@2.0.1", "", {}, "sha512-rcQ1bsQO9799wq24uE5AM2tAILy4gXGIK/njFWcVQkGNZ96edlpY+A7bjwvzjYvLDyzmG1MmMLZhpcsb+klNMQ=="],
+
     "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="],
 
     "diff": ["diff@8.0.2", "", {}, "sha512-sSuxWU5j5SR9QQji/o2qMvqRNYRDOcBTgsJ/DeCf4iSN4gW+gNMXM7wFIP+fdXZxoNiAnHUTGjCr+TSWXdRDKg=="],
 
+    "emoji-regex": ["emoji-regex@10.6.0", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],
+
+    "environment": ["environment@1.1.0", "", {}, "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q=="],
+
+    "es-toolkit": ["es-toolkit@1.43.0", "", {}, "sha512-SKCT8AsWvYzBBuUqMk4NPwFlSdqLpJwmy6AP322ERn8W2YLIB6JBXnwMI2Qsh2gfphT3q7EKAxKb23cvFHFwKA=="],
+
+    "escape-string-regexp": ["escape-string-regexp@2.0.0", "", {}, "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w=="],
+
     "event-target-shim": ["event-target-shim@5.0.1", "", {}, "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ=="],
 
     "events": ["events@3.3.0", "", {}, "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q=="],
 
     "exif-parser": ["exif-parser@0.1.12", "", {}, "sha512-c2bQfLNbMzLPmzQuOr8fy0csy84WmwnER81W88DzTp9CYNPJ6yzOj2EZAh9pywYpqHnshVLHQJ8WzldAyfY+Iw=="],
 
+    "figures": ["figures@6.1.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0" } }, "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg=="],
+
     "file-type": ["file-type@16.5.4", "", { "dependencies": { "readable-web-to-node-stream": "^3.0.0", "strtok3": "^6.2.4", "token-types": "^4.1.1" } }, "sha512-/yFHK0aGjFEgDJjEKP0pWCplsPFPhwyfwevf/pVxiN0tmE4L9LmwWxWukdJSHdoCli4VgQLehjJtwQBnqmsKcw=="],
 
+    "get-east-asian-width": ["get-east-asian-width@1.4.0", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],
+
     "gifwrap": ["gifwrap@0.10.1", "", { "dependencies": { "image-q": "^4.0.0", "omggif": "^1.0.10" } }, "sha512-2760b1vpJHNmLzZ/ubTtNnEx5WApN/PYWJvXvgS+tL1egTTthayFYIQQNi136FLEDcN/IyEY2EcGpIITD6eYUw=="],
 
     "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
 
     "image-q": ["image-q@4.0.0", "", { "dependencies": { "@types/node": "16.9.1" } }, "sha512-PfJGVgIfKQJuq3s0tTDOKtztksibuUEbJQIYT3by6wctQo+Rdlh7ef4evJ5NCdxY4CfMbvFkocEwbl4BF8RlJw=="],
 
+    "indent-string": ["indent-string@5.0.0", "", {}, "sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg=="],
+
+    "ink": ["ink@6.6.0", "", { "dependencies": { "@alcalzone/ansi-tokenize": "^0.2.1", "ansi-escapes": "^7.2.0", "ansi-styles": "^6.2.1", "auto-bind": "^5.0.1", "chalk": "^5.6.0", "cli-boxes": "^3.0.0", "cli-cursor": "^4.0.0", "cli-truncate": "^5.1.1", "code-excerpt": "^4.0.0", "es-toolkit": "^1.39.10", "indent-string": "^5.0.0", "is-in-ci": "^2.0.0", "patch-console": "^2.0.0", "react-reconciler": "^0.33.0", "signal-exit": "^3.0.7", "slice-ansi": "^7.1.0", "stack-utils": "^2.0.6", "string-width": "^8.1.0", "type-fest": "^4.27.0", "widest-line": "^5.0.0", "wrap-ansi": "^9.0.0", "ws": "^8.18.0", "yoga-layout": "~3.2.1" }, "peerDependencies": { "@types/react": ">=19.0.0", "react": ">=19.0.0", "react-devtools-core": "^6.1.2" }, "optionalPeers": ["@types/react", "react-devtools-core"] }, "sha512-QDt6FgJxgmSxAelcOvOHUvFxbIUjVpCH5bx+Slvc5m7IEcpGt3dYwbz/L+oRnqEGeRvwy1tineKK4ect3nW1vQ=="],
+
+    "ink-select-input": ["ink-select-input@6.2.0", "", { "dependencies": { "figures": "^6.1.0", "to-rotated": "^1.0.0" }, "peerDependencies": { "ink": ">=5.0.0", "react": ">=18.0.0" } }, "sha512-304fZXxkpYxJ9si5lxRCaX01GNlmPBgOZumXXRnPYbHW/iI31cgQynqk2tRypGLOF1cMIwPUzL2LSm6q4I5rQQ=="],
+
+    "ink-text-input": ["ink-text-input@6.0.0", "", { "dependencies": { "chalk": "^5.3.0", "type-fest": "^4.18.2" }, "peerDependencies": { "ink": ">=5", "react": ">=18" } }, "sha512-Fw64n7Yha5deb1rHY137zHTAbSTNelUKuB5Kkk2HACXEtwIHBCf9OH2tP/LQ9fRYTl1F0dZgbW0zPnZk6FA9Lw=="],
+
+    "is-fullwidth-code-point": ["is-fullwidth-code-point@5.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.1" } }, "sha512-5XHYaSyiqADb4RnZ1Bdad6cPp8Toise4TzEjcOYDHZkTCbKgiUl7WTUCpNWHuxmDt91wnsZBc9xinNzopv3JMQ=="],
+
+    "is-in-ci": ["is-in-ci@2.0.0", "", { "bin": { "is-in-ci": "cli.js" } }, "sha512-cFeerHriAnhrQSbpAxL37W1wcJKUUX07HyLWZCW1URJT/ra3GyUTzBgUnh24TMVfNTV2Hij2HLxkPHFZfOZy5w=="],
+
+    "is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
+
     "jimp": ["jimp@1.6.0", "", { "dependencies": { "@jimp/core": "1.6.0", "@jimp/diff": "1.6.0", "@jimp/js-bmp": "1.6.0", "@jimp/js-gif": "1.6.0", "@jimp/js-jpeg": "1.6.0", "@jimp/js-png": "1.6.0", "@jimp/js-tiff": "1.6.0", "@jimp/plugin-blit": "1.6.0", "@jimp/plugin-blur": "1.6.0", "@jimp/plugin-circle": "1.6.0", "@jimp/plugin-color": "1.6.0", "@jimp/plugin-contain": "1.6.0", "@jimp/plugin-cover": "1.6.0", "@jimp/plugin-crop": "1.6.0", "@jimp/plugin-displace": "1.6.0", "@jimp/plugin-dither": "1.6.0", "@jimp/plugin-fisheye": "1.6.0", "@jimp/plugin-flip": "1.6.0", "@jimp/plugin-hash": "1.6.0", "@jimp/plugin-mask": "1.6.0", "@jimp/plugin-print": "1.6.0", "@jimp/plugin-quantize": "1.6.0", "@jimp/plugin-resize": "1.6.0", "@jimp/plugin-rotate": "1.6.0", "@jimp/plugin-threshold": "1.6.0", "@jimp/types": "1.6.0", "@jimp/utils": "1.6.0" } }, "sha512-YcwCHw1kiqEeI5xRpDlPPBGL2EOpBKLwO4yIBJcXWHPj5PnA5urGq0jbyhM5KoNpypQ6VboSoxc9D8HyfvngSg=="],
 
     "jpeg-js": ["jpeg-js@0.4.4", "", {}, "sha512-WZzeDOEtTOBK4Mdsar0IqEU5sMr3vSV2RqkAIzUEV2BHnUfKGyswWFPFwK5EeDo93K3FohSHbLAjj0s1Wzd+dg=="],
 
     "mime": ["mime@3.0.0", "", { "bin": { "mime": "cli.js" } }, "sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A=="],
 
+    "mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
+
     "omggif": ["omggif@1.0.10", "", {}, "sha512-LMJTtvgc/nugXj0Vcrrs68Mn2D1r0zf630VNtqtpI1FEO7e+O9FP4gqs9AcnBaSEeoHIPm28u6qgPR0oyEpGSw=="],
 
+    "onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
+
     "pako": ["pako@1.0.11", "", {}, "sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw=="],
 
     "parse-bmfont-ascii": ["parse-bmfont-ascii@1.0.6", "", {}, "sha512-U4RrVsUFCleIOBsIGYOMKjn9PavsGOXxbvYGtMOEfnId0SVNsgehXh1DxUdVPLoxd5mvcEtvmKs2Mmf0Mpa1ZA=="],
@@ -163,6 +218,8 @@
 
     "parse-bmfont-xml": ["parse-bmfont-xml@1.1.6", "", { "dependencies": { "xml-parse-from-string": "^1.0.0", "xml2js": "^0.5.0" } }, "sha512-0cEliVMZEhrFDwMh4SxIyVJpqYoOWDJ9P895tFuS+XuNzI5UBmBk5U5O4KuJdTnZpSBI4LFA2+ZiJaiwfSwlMA=="],
 
+    "patch-console": ["patch-console@2.0.0", "", {}, "sha512-0YNdUceMdaQwoKce1gatDScmMo5pu/tfABfnzEqeG0gtTmd7mh/WcwgUjtAeOU7N8nFFlbQBnFK2gXW5fGvmMA=="],
+
     "peek-readable": ["peek-readable@4.1.0", "", {}, "sha512-ZI3LnwUv5nOGbQzD9c2iDG6toheuXSZP5esSHBjopsXH4dg19soufvpUGA3uohi5anFtGb2lhAVdHzH6R/Evvg=="],
 
     "pixelmatch": ["pixelmatch@5.3.0", "", { "dependencies": { "pngjs": "^6.0.0" }, "bin": { "pixelmatch": "bin/pixelmatch" } }, "sha512-o8mkY4E/+LNUf6LzX96ht6k6CEDi65k9G2rjMtBe9Oo+VPKSvl+0GKHuH/AlG+GA5LPG/i5hrekkxUc3s2HU+Q=="],
@@ -183,6 +240,8 @@
 
     "readable-web-to-node-stream": ["readable-web-to-node-stream@3.0.4", "", { "dependencies": { "readable-stream": "^4.7.0" } }, "sha512-9nX56alTf5bwXQ3ZDipHJhusu9NTQJ/CVPtb/XHAJCXihZeitfJvIRS4GqQ/mfIoOE3IelHMrpayVrosdHBuLw=="],
 
+    "restore-cursor": ["restore-cursor@4.0.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg=="],
+
     "safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="],
 
     "sax": ["sax@1.4.4", "", {}, "sha512-1n3r/tGXO6b6VXMdFT54SHzT9ytu9yr7TaELowdYpMqY/Ao7EnlQGmAQ1+RatX7Tkkdm6hONI2owqNx2aZj5Sw=="],
@@ -191,22 +250,36 @@
 
     "shell-quote": ["shell-quote@1.8.3", "", {}, "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw=="],
 
+    "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
+
     "simple-xml-to-json": ["simple-xml-to-json@1.2.3", "", {}, "sha512-kWJDCr9EWtZ+/EYYM5MareWj2cRnZGF93YDNpH4jQiHB+hBIZnfPFSQiVMzZOdk+zXWqTZ/9fTeQNu2DqeiudA=="],
 
+    "slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
+
+    "stack-utils": ["stack-utils@2.0.6", "", { "dependencies": { "escape-string-regexp": "^2.0.0" } }, "sha512-XlkWvfIm6RmsWtNJx+uqtKLS8eqFbxUg0ZzLXqY0caEy9l7hruX8IpiDnjsLavoBgqCCR71TqWO8MaXYheJ3RQ=="],
+
     "stage-js": ["stage-js@1.0.0-alpha.17", "", {}, "sha512-AzlMO+t51v6cFvKZ+Oe9DJnL1OXEH5s9bEy6di5aOrUpcP7PCzI/wIeXF0u3zg0L89gwnceoKxrLId0ZpYnNXw=="],
 
+    "string-width": ["string-width@8.1.0", "", { "dependencies": { "get-east-asian-width": "^1.3.0", "strip-ansi": "^7.1.0" } }, "sha512-Kxl3KJGb/gxkaUMOjRsQ8IrXiGW75O4E3RPjFIINOVH8AMl2SQ/yWdTzWwF3FevIX9LcMAjJW+GRwAlAbTSXdg=="],
+
     "string_decoder": ["string_decoder@1.3.0", "", { "dependencies": { "safe-buffer": "~5.2.0" } }, "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA=="],
 
+    "strip-ansi": ["strip-ansi@7.1.2", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],
+
     "strtok3": ["strtok3@6.3.0", "", { "dependencies": { "@tokenizer/token": "^0.3.0", "peek-readable": "^4.1.0" } }, "sha512-fZtbhtvI9I48xDSywd/somNqgUHl2L2cstmXCCif0itOf96jeW18MBSyrLuNicYQVkvpOxkZtkzujiTJ9LW5Jw=="],
 
     "three": ["three@0.177.0", "", {}, "sha512-EiXv5/qWAaGI+Vz2A+JfavwYCMdGjxVsrn3oBwllUoqYeaBO75J63ZfyaQKoiLrqNHoTlUc6PFgMXnS0kI45zg=="],
 
     "tinycolor2": ["tinycolor2@1.6.0", "", {}, "sha512-XPaBkWQJdsf3pLKJV9p4qN/S+fm2Oj8AIPo1BTUhg5oxkvm9+SVEGFdhyOz7tTdUTfvxMiAs4sp6/eZO2Ew+pw=="],
 
+    "to-rotated": ["to-rotated@1.0.0", "", {}, "sha512-KsEID8AfgUy+pxVRLsWp0VzCa69wxzUDZnzGbyIST/bcgcrMvTYoFBX/QORH4YApoD89EDuUovx4BTdpOn319Q=="],
+
     "token-types": ["token-types@4.2.1", "", { "dependencies": { "@tokenizer/token": "^0.3.0", "ieee754": "^1.2.1" } }, "sha512-6udB24Q737UD/SDsKAHI9FCRP7Bqc9D/MQUV02ORQg5iskjtLJlZJNdN4kKtcdtwCeWIwIHDGaUsTsCCAa8sFQ=="],
 
     "tslog": ["tslog@4.10.2", "", {}, "sha512-XuELoRpMR+sq8fuWwX7P0bcj+PRNiicOKDEb3fGNURhxWVyykCi9BNq7c4uVz7h7P0sj8qgBsr5SWS6yBClq3g=="],
 
+    "type-fest": ["type-fest@4.41.0", "", {}, "sha512-TeTSQ6H5YHvpqVwBRcnLDCBnDOHWYu7IvGbHT6N8AOymcr9PJGjc1GTtiWZTYg0NCgYwvnYWEkVChQAr9bjfwA=="],
+
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
@@ -215,6 +288,10 @@
 
     "web-tree-sitter": ["web-tree-sitter@0.25.10", "", { "peerDependencies": { "@types/emscripten": "^1.40.0" }, "optionalPeers": ["@types/emscripten"] }, "sha512-Y09sF44/13XvgVKgO2cNDw5rGk6s26MgoZPXLESvMXeefBf7i6/73eFurre0IsTW6E14Y0ArIzhUMmjoc7xyzA=="],
 
+    "widest-line": ["widest-line@5.0.0", "", { "dependencies": { "string-width": "^7.0.0" } }, "sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA=="],
+
+    "wrap-ansi": ["wrap-ansi@9.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],
+
     "ws": ["ws@8.19.0", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": ">=5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="],
 
     "xml-parse-from-string": ["xml-parse-from-string@1.0.1", "", {}, "sha512-ErcKwJTF54uRzzNMXq2X5sMIy88zJvfN2DmdoQvy7PAFJ+tPRU6ydWuOKNMyfmOjdyBQTFREi60s0Y0SyI0G0g=="],
@@ -229,8 +306,16 @@
 
     "image-q/@types/node": ["@types/node@16.9.1", "", {}, "sha512-QpLcX9ZSsq3YYUUnD3nFDY8H7wctAhQj/TFKL8Ya8v5fMm3CFXxo8zStsLAl780ltoYoo1WvKUVGBQK+1ifr7g=="],
 
+    "ink/react-reconciler": ["react-reconciler@0.33.0", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.0" } }, "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA=="],
+
     "pixelmatch/pngjs": ["pngjs@6.0.0", "", {}, "sha512-TRzzuFRRmEoSW/p1KVAmiOgPco2Irlah+bGFCeNfJXxxYGwSw7YwAOAcd7X28K/m5bjBWKsC29KyoMfHbypayg=="],
 
     "react-devtools-core/ws": ["ws@7.5.10", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": "^5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ=="],
+
+    "widest-line/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+
+    "wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],
+
+    "ink/react-reconciler/scheduler": ["scheduler@0.27.0", "", {}, "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q=="],
   }
 }

package/examples/tui-app/commands/config/app/get.ts

@@ -1,10 +1,6 @@
-import { 
-    Command, 
-    type AppContext, 
-    type OptionSchema, 
-    type OptionValues,
-    type CommandResult 
-} from "../../../../../src/index.ts";
+import { Command, type CommandResult } from "../../../../../src/core/command";
+import { AppContext } from "../../../../../src/core/context";
+import type { OptionSchema, OptionValues } from "../../../../../src/types/command";
 
 const options = {
     key: {
@@ -31,7 +27,7 @@ export class AppGetCommand extends Command<typeof options> {
         { command: "config app get --key logLevel", description: "Get log level" },
     ];
 
-    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+    override async execute(opts: OptionValues<typeof options>): Promise<CommandResult> {
         // Simulated app config store
         const appConfig: Record<string, string | number | boolean> = {
             port: 3000,
@@ -44,14 +40,14 @@ export class AppGetCommand extends Command<typeof options> {
         const value = appConfig[opts.key];
         
         if (value === undefined) {
-            ctx.logger.warn(`Key "${opts.key}" not found in application configuration`);
+            AppContext.current.logger.warn(`Key "${opts.key}" not found in application configuration`);
             return {
                 success: false,
                 message: `Key "${opts.key}" not found`,
             };
         }
 
-        ctx.logger.info(`Retrieved app.${opts.key} = ${value}`);
+        AppContext.current.logger.info(`Retrieved app.${opts.key} = ${value}`);
         return {
             success: true,
             data: { key: opts.key, value },

package/examples/tui-app/commands/config/app/index.ts

@@ -1,8 +1,4 @@
-import { 
-    Command, 
-    type AppContext,
-    type CommandResult 
-} from "../../../../../src/index.ts";
+import { Command, type CommandResult } from "../../../../../src/core/command.ts";
 import { AppGetCommand } from "./get.ts";
 import { AppSetCommand } from "./set.ts";
 
@@ -17,7 +13,7 @@ export class AppConfigCommand extends Command {
         new AppSetCommand(),
     ];
 
-    override execute(_ctx: AppContext): CommandResult {
+    override execute(): CommandResult {
         console.log("Use 'config app <command>' for application configuration.");
         console.log("Available: get, set");
         return { success: true };

package/examples/tui-app/commands/config/app/set.ts

@@ -1,10 +1,6 @@
-import { 
-    Command, 
-    type AppContext, 
-    type OptionSchema, 
-    type OptionValues,
-    type CommandResult 
-} from "../../../../../src/index.ts";
+import { Command, type CommandExecutionContext, type CommandResult } from "../../../../../src/core/command";
+import { AppContext } from "../../../../../src/core/context";
+import type { OptionSchema, OptionValues } from "../../../../../src/types/command";
 
 const options = {
     key: {
@@ -49,14 +45,14 @@ export class AppSetCommand extends Command<typeof options> {
         { command: "config app set --key debug --value false --type boolean", description: "Disable debug" },
     ];
 
-    override async execute(ctx: AppContext, opts: OptionValues<typeof options>): Promise<CommandResult> {
+    override async execute(opts: OptionValues<typeof options>, execCtx: CommandExecutionContext): Promise<CommandResult> {
         let parsedValue: string | number | boolean = opts.value;
         
         // Parse value based on type
         if (opts.type === "number") {
             parsedValue = Number(opts.value);
             if (isNaN(parsedValue)) {
-                ctx.logger.error(`Invalid number value: "${opts.value}"`);
+                AppContext.current.logger.error(`Invalid number value: "${opts.value}"`);
                 return {
                     success: false,
                     message: `Invalid number: "${opts.value}"`,
@@ -66,12 +62,26 @@ export class AppSetCommand extends Command<typeof options> {
             parsedValue = opts.value.toLowerCase() === "true";
         }
 
-        ctx.logger.info(`Setting app.${opts.key} = ${JSON.stringify(parsedValue)}`);
+        AppContext.current.logger.info(`Setting app.${opts.key} = ${JSON.stringify(parsedValue)}`);
         
-        // Simulate setting the value
-        await new Promise(resolve => setTimeout(resolve, 300));
+
+        // Simulate setting the value on the 5th iteration
+        await new Promise(resolve => {
+            let count = 0;
+            let interval = setInterval(() => {
+                count++;
+                AppContext.current.logger.info(`Applying configuration... (${count}/5)`);
+                if (count >= 5 || execCtx.signal.aborted) {
+                    if (count < 5) {
+                        AppContext.current.logger.warn("Configuration update aborted");
+                    }
+                    clearInterval(interval);
+                    resolve(undefined);
+                }
+            }, 1000);
+        });
         
-        ctx.logger.info(`Successfully updated application configuration`);
+        AppContext.current.logger.info(`Successfully updated application configuration`);
         return {
             success: true,
             data: { key: opts.key, value: parsedValue, type: opts.type },

package/examples/tui-app/commands/config/index.ts

@@ -1,10 +1,6 @@
-import { 
-    Command, 
-    type AppContext,
-    type CommandResult 
-} from "../../../../src/index.ts";
 import { UserConfigCommand } from "./user/index.ts";
 import { AppConfigCommand } from "./app/index.ts";
+import { Command, type CommandResult } from "../../../../src/core/command.ts";
 
 export class ConfigCommand extends Command {
     readonly name = "config";
@@ -24,7 +20,7 @@ export class ConfigCommand extends Command {
         { command: "config app set --key debug --value true --type boolean", description: "Enable debug mode" },
     ];
 
-    override execute(_ctx: AppContext): CommandResult {
+    override execute(): CommandResult {
         console.log("Use 'config <category> <command>' to manage settings.");
         console.log("Categories: user, app");
         return { success: true };