@navios/commander-tui 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2026-01-13
+
+### Added
+
+- **Framework Adapter Architecture** - TUI components are now framework-agnostic with dedicated adapters
+  - New `TuiAdapterInterface` for framework-agnostic TUI rendering
+  - `@navios/commander-tui/adapters/react` - React adapter (default, uses @opentui/react)
+  - `@navios/commander-tui/adapters/solid` - Solid.js adapter (optional, uses @opentui/solid)
+- **Solid.js Support** - Full Solid.js implementation of all TUI components
+  - All components ported: Sidebar, Screen, Log, Prompt, Filter, Help, File display
+  - SolidJS-specific patterns with reactive signals and proper type narrowing
+  - Optional peer dependency on `solid-js`
+- **Adapter Token** - New `TuiAdapterToken` for injecting the active TUI adapter
+- **Screen Manager Token** - New `ScreenManagerToken` for service injection
+
+### Changed
+
+- **Component Organization** - Components moved from `src/components/` to `src/adapters/react/components/`
+- **Context Organization** - Context providers moved to `src/adapters/react/context/`
+- **Hooks Organization** - Hooks moved to `src/adapters/react/hooks/`
+- **Screen Manager** - Refactored to use adapter interface instead of direct React rendering
+- **Build Configuration** - Separate TypeScript configs for React and Solid builds
+
+### Fixed
+
+- **Type Safety** - Solid adapter uses proper SolidJS type narrowing patterns instead of `as any` casts
+
+## [1.2.0] - 2026-01-11
+
+### Added
+
+- **Isomorphic Logger** - New `IsomorphicLogger` token and factory for unified logging across TUI and server environments
+  - `IsomorphicLoggerInterface` type that works with both `ScreenLogger` (TUI) and standard `Logger` (server)
+  - `IsomorphicLoggerFactory` automatically selects the appropriate logger based on TUI availability
+- **Interfaces Export** - New `interfaces` module export for public type definitions
+
+### Changed
+
+- **Mouse Support Default** - `useMouse` option now defaults to `true` (previously `false`)
+
+### Fixed
+
+- **Stack Trace Capture** - Improved `captureTrace()` to dynamically find the correct stack frame offset, ensuring accurate trace output regardless of call depth
+
 ## [1.1.0] - 2026-01-10
 
 ### Added

package/README.md

@@ -1,9 +1,10 @@
 # @navios/commander-tui
 
-A powerful terminal user interface (TUI) library for building beautiful CLI applications with React. Built on top of [@opentui/react](https://github.com/nicepkg/opentui), it provides a high-level API for logging, prompts, progress indicators, and multi-screen management.
+A powerful terminal user interface (TUI) library for building beautiful CLI applications. Built on top of [@opentui](https://github.com/nicepkg/opentui), it provides a high-level API for logging, prompts, progress indicators, and multi-screen management with support for both React and Solid.js frameworks.
 
 ## Features
 
+- **Framework Agnostic** - Choose between React or Solid.js adapters for rendering
 - **Rich Logging** - Multiple log levels (log, debug, warn, error, success, trace, fatal) with contextual labels
 - **Interactive Prompts** - Confirm, choice, multi-choice, and text input prompts
 - **Progress Indicators** - Loading spinners and progress bars with manual or promise-based resolution
@@ -21,6 +22,12 @@ npm install @navios/commander-tui @navios/core
 yarn add @navios/commander-tui @navios/core
 ```
 
+For Solid.js support, also install:
+
+```bash
+npm install solid-js
+```
+
 ## Quick Start
 
 ```typescript
@@ -99,6 +106,33 @@ logger.fatal('Fatal error')
 logger.log('Step 1').log('Step 2').success('Done!')
 ```
 
+### IsomorphicLogger
+
+A unified logger that automatically switches between `ScreenLogger` (TUI mode) and standard `Logger` (server mode) based on the environment. This is useful when writing code that needs to work both in TUI and non-TUI contexts.
+
+```typescript
+import { IsomorphicLogger } from '@navios/commander-tui'
+import { inject, Injectable } from '@navios/core'
+
+@Injectable()
+class MyService {
+  // Will use ScreenLogger when TUI is bound, otherwise standard Logger
+  private logger = inject(IsomorphicLogger, { context: 'MyService' })
+
+  doWork() {
+    this.logger.log('Processing...')
+    this.logger.debug('Debug info')
+    this.logger.error('Something went wrong')
+  }
+}
+```
+
+The `IsomorphicLoggerFactory` checks if the `ScreenManager` has an active TUI binding:
+- **TUI bound**: Returns a `ScreenLogger` instance with full TUI features
+- **TUI not bound**: Returns a standard `Logger` instance for console output
+
+This makes it easy to write services that can be used in both CLI tools with TUI and background server processes.
+
 #### Loading Indicators
 
 ```typescript
@@ -270,6 +304,40 @@ Three built-in themes are available:
 await screenManager.bind({ theme: 'high-contrast' })
 ```
 
+## Framework Adapters
+
+The TUI library supports multiple rendering frameworks through adapters. By default, React is used, but you can switch to Solid.js for potentially better performance.
+
+### Using with @navios/commander
+
+When using with `@navios/commander`, specify the adapter in the TUI options:
+
+```typescript
+import { CommanderFactory } from '@navios/commander'
+
+const app = await CommanderFactory.create(AppModule, {
+  enableTUI: true,
+  tuiOptions: {
+    adapter: 'react', // 'react' (default) or 'solid'
+    theme: 'dark',
+  },
+})
+```
+
+### Direct Adapter Import
+
+For standalone usage, import the adapter directly:
+
+```typescript
+// React adapter (default)
+import '@navios/commander-tui/adapters/react'
+
+// Or Solid.js adapter
+import '@navios/commander-tui/adapters/solid'
+```
+
+The adapter must be imported before using any TUI services. It registers the framework-specific components with the dependency injection container.
+
 ## License
 
 MIT

package/dist/base/src/adapters/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interface.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAA"}

package/dist/base/src/adapters/interface.d.ts

@@ -0,0 +1,45 @@
+import type { CliRenderer } from '@opentui/core';
+import type { Theme } from '../types/index.ts';
+/**
+ * Root instance returned by adapter's createRoot method.
+ * Abstracts the framework-specific root implementation.
+ */
+export interface AdapterRoot {
+    /**
+     * Render an element to the root.
+     * @param element - Framework-specific element to render
+     */
+    render(element: unknown): void;
+    /**
+     * Unmount and cleanup the root.
+     */
+    unmount(): void;
+}
+/**
+ * Props passed to the adapter's internal bridge component.
+ * The manager type is kept generic to avoid circular imports.
+ */
+export interface AdapterRenderProps {
+    manager: unknown;
+    theme?: Theme;
+}
+/**
+ * Abstract interface for rendering adapters.
+ * Implementations provide framework-specific rendering capabilities.
+ */
+export interface AdapterInterface {
+    /**
+     * Create a root instance for rendering.
+     * @param renderer - CLI renderer from @opentui/core
+     * @returns Root instance with render/unmount methods, or a Promise that resolves to one
+     */
+    createRoot(renderer: CliRenderer): AdapterRoot | Promise<AdapterRoot>;
+    /**
+     * Render the adapter's internal bridge component to the root.
+     * The adapter owns its bridge component - no component is passed in.
+     * @param root - Root instance created by createRoot
+     * @param props - Props to pass to the bridge component
+     */
+    renderToRoot(root: AdapterRoot, props: AdapterRenderProps): void;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/base/src/adapters/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/adapters/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAE9B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAErE;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAA;CACjE"}

package/dist/base/src/components/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":""}

package/dist/base/src/context/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/context/index.ts"],"names":[],"mappings":""}

package/dist/base/src/factories/index.d.ts

@@ -0,0 +1,3 @@
+export * from './isomorphic-logger.factory.js';
+export * from './screen.factory.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/factories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,qBAAqB,CAAA"}

package/dist/base/src/factories/isomorphic-logger.factory.d.ts

@@ -0,0 +1,8 @@
+import { type FactoryContext } from '@navios/core';
+import type { IsomorphicLoggerInterface } from '../interfaces/isomorphic-logger.js';
+import type { LoggerOptions } from '../schemas/index.js';
+export declare class IsomorphicLoggerFactory {
+    private readonly screenManager;
+    create(ctx: FactoryContext, options: LoggerOptions): Promise<IsomorphicLoggerInterface>;
+}
+//# sourceMappingURL=isomorphic-logger.factory.d.ts.map

package/dist/base/src/factories/isomorphic-logger.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isomorphic-logger.factory.d.ts","sourceRoot":"","sources":["../../../../src/factories/isomorphic-logger.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAI3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,qBAGa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAEhD,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAQ9F"}

package/dist/base/src/factories/screen.factory.d.ts

@@ -0,0 +1,8 @@
+import type { FactoryContext } from '@navios/core';
+import { type ScreenOptions } from '../schemas/index.ts';
+import { ScreenInstance } from '../services/index.ts';
+export declare class ScreenFactory {
+    private readonly screenManager;
+    create(ctx: FactoryContext, options: ScreenOptions): ScreenInstance;
+}
+//# sourceMappingURL=screen.factory.d.ts.map

package/dist/base/src/factories/screen.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.factory.d.ts","sourceRoot":"","sources":["../../../../src/factories/screen.factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,qBAGa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IAEtD,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,cAAc;CAOpE"}

package/dist/base/src/filter/filter_engine.d.ts

@@ -0,0 +1,19 @@
+import type { FilterState, LevelCounts, MessageData } from '../types/index.ts';
+/**
+ * Filter engine for filtering log messages.
+ */
+export declare class FilterEngine {
+    /**
+     * Apply filter to messages array.
+     */
+    static filterMessages(messages: MessageData[], filter: FilterState): MessageData[];
+    /**
+     * Check if a message matches the search query.
+     */
+    private static messageMatchesSearch;
+    /**
+     * Count messages by log level.
+     */
+    static countByLevel(messages: MessageData[]): LevelCounts;
+}
+//# sourceMappingURL=filter_engine.d.ts.map

package/dist/base/src/filter/filter_engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter_engine.d.ts","sourceRoot":"","sources":["../../../../src/filter/filter_engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE9F;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE;IAqClF;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAwCnC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW;CAkB1D"}

package/dist/base/src/filter/index.d.ts

@@ -0,0 +1,2 @@
+export * from './filter_engine.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/filter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/filter/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA"}

package/dist/base/src/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":""}

package/dist/base/src/index.d.ts

@@ -0,0 +1,16 @@
+export * from './types/index.ts';
+export * from './interfaces/index.ts';
+export * from './components/index.ts';
+export * from './context/index.ts';
+export * from './utils/index.ts';
+export * from './schemas/index.ts';
+export * from './tokens/index.ts';
+export * from './factories/index.ts';
+export * from './overrides/index.ts';
+export * from './services/index.ts';
+export * from './themes/index.ts';
+export * from './hooks/index.ts';
+export * from './keyboard/index.ts';
+export * from './filter/index.ts';
+export * from './adapters/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAA;AAKhC,cAAc,uBAAuB,CAAA;AAKrC,cAAc,uBAAuB,CAAA;AAKrC,cAAc,oBAAoB,CAAA;AAKlC,cAAc,kBAAkB,CAAA;AAKhC,cAAc,oBAAoB,CAAA;AAKlC,cAAc,mBAAmB,CAAA;AAKjC,cAAc,sBAAsB,CAAA;AAKpC,cAAc,sBAAsB,CAAA;AAKpC,cAAc,qBAAqB,CAAA;AAKnC,cAAc,mBAAmB,CAAA;AAKjC,cAAc,kBAAkB,CAAA;AAKhC,cAAc,qBAAqB,CAAA;AAKnC,cAAc,mBAAmB,CAAA;AAKjC,cAAc,qBAAqB,CAAA"}

package/dist/base/src/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './isomorphic-logger.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}

package/dist/base/src/interfaces/isomorphic-logger.d.ts

@@ -0,0 +1,9 @@
+import type { LoggerInstance } from '@navios/core';
+import type { ScreenLoggerInstance } from '../services/logger.ts';
+type PublicLoggerMethods = Pick<LoggerInstance, keyof LoggerInstance>;
+type PublicScreenLoggerMethods = Pick<ScreenLoggerInstance, keyof ScreenLoggerInstance>;
+type ScreenOwnMethods = Partial<Omit<PublicScreenLoggerMethods, keyof PublicLoggerMethods>>;
+export interface IsomorphicLoggerInterface extends PublicLoggerMethods, ScreenOwnMethods {
+}
+export {};
+//# sourceMappingURL=isomorphic-logger.d.ts.map

package/dist/base/src/interfaces/isomorphic-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isomorphic-logger.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/isomorphic-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEjE,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,CAAA;AACrE,KAAK,yBAAyB,GAAG,IAAI,CAAC,oBAAoB,EAAE,MAAM,oBAAoB,CAAC,CAAA;AACvF,KAAK,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,mBAAmB,CAAC,CAAC,CAAA;AAE3F,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB,EAAE,gBAAgB;CAAG"}

package/dist/base/src/keyboard/create_bindings.d.ts

@@ -0,0 +1,26 @@
+import type { ScreenInstance, ScreenManagerInstance } from '../services/index.ts';
+import type { KeyBinding, KeyboardContext, KeyEvent } from '../types/index.ts';
+/**
+ * Interface for binding handlers that need manager/screen access.
+ */
+export interface BindingHandlers {
+    manager: ScreenManagerInstance;
+    getActiveScreen: () => ScreenInstance | null;
+    toggleHelp: () => void;
+    toggleFilter: () => void;
+    closeFilter: () => void;
+    filterAppendChar: (char: string) => void;
+    filterDeleteChar: () => void;
+    filterToggleLevel: (index: number) => void;
+    filterCycleField: () => void;
+}
+/**
+ * Create the default keybindings with access to manager and screens.
+ */
+export declare function createDefaultBindings(handlers: BindingHandlers): KeyBinding[];
+/**
+ * Handle printable character input for prompts and filter.
+ * This should be called for any key not handled by bindings.
+ */
+export declare function handlePrintableInput(key: KeyEvent, context: KeyboardContext, handlers: BindingHandlers): boolean;
+//# sourceMappingURL=create_bindings.d.ts.map

package/dist/base/src/keyboard/create_bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create_bindings.d.ts","sourceRoot":"","sources":["../../../../src/keyboard/create_bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE9E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,qBAAqB,CAAA;IAC9B,eAAe,EAAE,MAAM,cAAc,GAAG,IAAI,CAAA;IAC5C,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,gBAAgB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,UAAU,EAAE,CA+Y7E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,eAAe,GACxB,OAAO,CA0BT"}

package/dist/base/src/keyboard/index.d.ts

@@ -0,0 +1,3 @@
+export * from './keyboard_manager.ts';
+export * from './create_bindings.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/keyboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/keyboard/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA"}

package/dist/base/src/keyboard/keyboard_manager.d.ts

@@ -0,0 +1,63 @@
+import type { KeyBinding, KeyBindingCategory, KeyBindingsConfig, KeyboardContext, KeyEvent } from '../types/index.ts';
+/**
+ * Manages keyboard bindings and dispatches key events to handlers.
+ */
+export declare class KeyboardManager {
+    private bindings;
+    private disabled;
+    constructor(config?: KeyBindingsConfig);
+    /**
+     * Add bindings to the manager.
+     */
+    addBindings(bindings: KeyBinding[]): void;
+    /**
+     * Remove a binding by key name.
+     */
+    removeBinding(key: string): void;
+    /**
+     * Disable a key (prevents it from being matched).
+     */
+    disableKey(key: string): void;
+    /**
+     * Enable a previously disabled key.
+     */
+    enableKey(key: string): void;
+    /**
+     * Handle a key event, dispatching to the appropriate handler.
+     * Returns true if a handler consumed the event.
+     */
+    handleKey(key: KeyEvent, context: KeyboardContext): boolean;
+    /**
+     * Get all bindings for display in help overlay.
+     */
+    getBindingsForHelp(): KeyBinding[];
+    /**
+     * Get bindings grouped by category.
+     */
+    getBindingsByCategory(): Record<KeyBindingCategory, KeyBinding[]>;
+    /**
+     * Find a matching binding for the given key and context.
+     */
+    private findMatchingBinding;
+    /**
+     * Check if a key event matches a binding's key specification.
+     */
+    private keyMatches;
+    /**
+     * Check if context matches a binding's condition.
+     */
+    private conditionMatches;
+    /**
+     * Check if a binding is disabled.
+     */
+    private isDisabled;
+    /**
+     * Sort bindings by priority (higher first).
+     */
+    private sortBindings;
+}
+/**
+ * Format a key binding for display.
+ */
+export declare function formatKeyBinding(binding: KeyBinding): string;
+//# sourceMappingURL=keyboard_manager.d.ts.map

package/dist/base/src/keyboard/keyboard_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard_manager.d.ts","sourceRoot":"","sources":["../../../../src/keyboard/keyboard_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAE1B;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAyB;gBAE7B,MAAM,CAAC,EAAE,iBAAiB;IAatC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAKzC;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO;IAS3D;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAIlC;;OAEG;IACH,qBAAqB,IAAI,MAAM,CAAC,kBAAkB,EAAE,UAAU,EAAE,CAAC;IAkBjE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,YAAY;CAGrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAsC5D"}

package/dist/base/src/overrides/console.logger.override.d.ts

@@ -0,0 +1,3 @@
+import { type ClassTypeWithInstance, type LoggerService } from '@navios/core';
+export declare function overrideConsoleLogger(hidden?: boolean): ClassTypeWithInstance<LoggerService>;
+//# sourceMappingURL=console.logger.override.d.ts.map

package/dist/base/src/overrides/console.logger.override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.logger.override.d.ts","sourceRoot":"","sources":["../../../../src/overrides/console.logger.override.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAE1B,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAA;AAKrB,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,OAAe,GACtB,qBAAqB,CAAC,aAAa,CAAC,CAoDtC"}

package/dist/base/src/overrides/index.d.ts

@@ -0,0 +1,3 @@
+export * from './console.logger.override.ts';
+export * from './missing-adapter.override.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/overrides/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/overrides/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA"}

package/dist/base/src/overrides/missing-adapter.override.d.ts

@@ -0,0 +1,6 @@
+import type { AdapterInterface, AdapterRoot } from '../adapters/index.ts';
+export declare class MissingAdapterOverride implements AdapterInterface {
+    createRoot(): AdapterRoot;
+    renderToRoot(): void;
+}
+//# sourceMappingURL=missing-adapter.override.d.ts.map

package/dist/base/src/overrides/missing-adapter.override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-adapter.override.d.ts","sourceRoot":"","sources":["../../../../src/overrides/missing-adapter.override.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEzE,qBACa,sBAAuB,YAAW,gBAAgB;IAC7D,UAAU,IAAI,WAAW;IAMzB,YAAY,IAAI,IAAI;CAKrB"}

package/dist/base/src/schemas/index.d.ts

@@ -0,0 +1,4 @@
+export * from './screen-options.ts';
+export * from './logger-options.ts';
+export * from './prompt-options.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA"}

package/dist/base/src/schemas/logger-options.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod/v4';
+export declare const LoggerOptionsSchema: z.ZodObject<{
+    screen: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        name: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        badgeCount: z.ZodOptional<z.ZodNumber>;
+        hidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        static: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodString]>>>;
+    context: z.ZodOptional<z.ZodString>;
+    enabledLevels: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        verbose: "verbose";
+        debug: "debug";
+        log: "log";
+        warn: "warn";
+        error: "error";
+        fatal: "fatal";
+    }>>>;
+}, z.core.$strip>;
+export type LoggerOptions = z.infer<typeof LoggerOptionsSchema>;
+//# sourceMappingURL=logger-options.d.ts.map

package/dist/base/src/schemas/logger-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-options.d.ts","sourceRoot":"","sources":["../../../../src/schemas/logger-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAM1B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBAI9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/base/src/schemas/prompt-options.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod/v4';
+export declare const PromptOptionsSchema: z.ZodObject<{
+    screen: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        name: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        badgeCount: z.ZodOptional<z.ZodNumber>;
+        hidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        static: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodString]>>>;
+}, z.core.$strip>;
+export type PromptOptions = z.infer<typeof PromptOptionsSchema>;
+//# sourceMappingURL=prompt-options.d.ts.map

package/dist/base/src/schemas/prompt-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-options.d.ts","sourceRoot":"","sources":["../../../../src/schemas/prompt-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAI1B,eAAO,MAAM,mBAAmB;;;;;;;;iBAE9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/base/src/schemas/screen-options.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod/v4';
+export declare const ScreenOptionsSchema: z.ZodObject<{
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    badgeCount: z.ZodOptional<z.ZodNumber>;
+    hidden: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    static: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type ScreenOptions = z.infer<typeof ScreenOptionsSchema>;
+//# sourceMappingURL=screen-options.d.ts.map

package/dist/base/src/schemas/screen-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-options.d.ts","sourceRoot":"","sources":["../../../../src/schemas/screen-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,eAAO,MAAM,mBAAmB;;;;;;iBAW9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/base/src/services/index.d.ts

@@ -0,0 +1,5 @@
+export * from './screen_manager.ts';
+export * from './screen.ts';
+export * from './logger.ts';
+export * from './prompt.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/src/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/base/src/services/logger.d.ts

@@ -0,0 +1,52 @@
+import type { LoggerService, LogLevel } from '@navios/core';
+import type { LoggerOptions } from '../schemas/index.ts';
+import type { LoadingHandle, ProgressHandle, PromiseOptions } from '../types/index.ts';
+export declare class ScreenLoggerInstance implements LoggerService {
+    private screen;
+    private context?;
+    private enabledLevels;
+    constructor(options: LoggerOptions);
+    private isLevelEnabled;
+    verbose(msg: string | object, label?: string): this;
+    setLogLevels(levels: LogLevel[]): this;
+    trace(msg: string | object, label?: string): this;
+    debug(msg: string | object, label?: string): this;
+    log(msg: string | object, label?: string): this;
+    success(msg: string | object, label?: string): this;
+    warn(msg: string | object, label?: string): this;
+    error(msg: string | object, label?: string): this;
+    fatal(msg: string | object, label?: string): this;
+    private write;
+    file(path: string, content: string): this;
+    diff(path: string, diffContent: string, view?: 'unified' | 'split'): this;
+    fileError(path: string, content: string, errorLines: number[], startLine?: number): this;
+    /**
+     * Sonner-like promise handling
+     */
+    promise<T>(promise: Promise<T>, options: PromiseOptions<T>): Promise<T>;
+    /**
+     * Create a loading message with manual resolution
+     */
+    loading(message: string): LoadingHandle;
+    /**
+     * Create a progress bar with manual updates
+     */
+    progress(label: string, options: {
+        total: number;
+    }): ProgressHandle;
+    /**
+     * Start a collapsible log group
+     */
+    group(label: string): this;
+    /**
+     * End the current log group
+     */
+    groupEnd(): this;
+    /**
+     * Display tabular data
+     */
+    table(data: Record<string, unknown>[], options?: {
+        title?: string;
+    }): this;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/base/src/services/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/services/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAK3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAKV,aAAa,EAIb,cAAc,EAEd,cAAc,EAEf,MAAM,mBAAmB,CAAA;AAS1B,qBAGa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAQ;IACxB,OAAO,CAAC,aAAa,CAAe;gBAExB,OAAO,EAAE,aAAa;IAclC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE;IAK/B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/C,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIhD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjD,OAAO,CAAC,KAAK;IA8Bb,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgBzC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI;IAiBzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAU,GAAG,IAAI;IAsB3F;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyC7E;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAgCvC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;IAyCnE;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAa1B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAiBhB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAuB3E"}