@navios/commander-tui 1.2.0 → 1.4.0

package/lib/index.d.mts

@@ -1,10 +1,10 @@
-import { RGBA, SyntaxStyle, TreeSitterClient } from "@opentui/core";
-import * as react11 from "react";
+import { ClassTypeWithInstance, FactoryContext, InjectionToken, LogLevel, LoggerInstance, LoggerService, OnServiceDestroy } from "@navios/core";
+import { EventEmitter } from "node:events";
+import { CliRenderer, RGBA, SyntaxStyle, TreeSitterClient } from "@opentui/core";
 import { ReactNode } from "react";
-import { ClassTypeWithInstance, FactoryContext, InjectionToken, LogLevel, LoggerInstance, LoggerService } from "@navios/core";
-import * as zod_v416 from "zod/v4";
+import * as zod_v40 from "zod/v4";
 import { z } from "zod/v4";
-import * as zod_v4_core1 from "zod/v4/core";
+import * as zod_v4_core0 from "zod/v4/core";
 
 //#region src/types/message.types.d.ts
 type MessageType = 'log' | 'file' | 'diff' | 'fileError' | 'loading' | 'progress' | 'group' | 'table';
@@ -442,6 +442,20 @@ interface LoggerContextValue {
   theme: Theme;
 }
 type ScreenStatus = 'waiting' | 'pending' | 'success' | 'fail' | 'static';
+/**
+ * Render mode determines how the TUI operates.
+ * This is set during bind() and affects prompts, screen printing, and exit behavior.
+ */
+declare enum RenderMode {
+  /** bind() never called - screens print on completion, prompts return defaults */
+  UNBOUND = "unbound",
+  /** bind() called with useOpenTUI: false - stdout mode with readline prompts */
+  STDOUT_INTERACTIVE = "stdout",
+  /** bind() called with useOpenTUI: true but adapter unavailable - fallback to stdout with warning */
+  STDOUT_FALLBACK = "fallback",
+  /** Full TUI rendering active with adapter */
+  TUI_ACTIVE = "tui",
+}
 interface BindOptions {
   exitOnCtrlC?: boolean;
   sidebarWidth?: number;
@@ -453,6 +467,19 @@ interface BindOptions {
   theme?: Theme | ThemePreset;
   /** Enable mouse support (default: true) */
   useMouse?: boolean;
+  /**
+   * Use OpenTUI for terminal rendering.
+   * When true: Full TUI with sidebar, scrolling, interactive prompts.
+   * When false: Stdout mode - static screens print immediately, others on completion.
+   * Default: true for Node.js, false for Bun (OpenTUI not supported).
+   */
+  useOpenTUI?: boolean;
+}
+interface SetupOptions {
+  /** Theme to use for the TUI (theme object or preset name) */
+  theme?: Theme | ThemePreset;
+  /** Global log levels filter - only these levels will be displayed across all loggers */
+  logLevels?: LogLevel[];
 }
 //#endregion
 //#region src/types/prompt.types.d.ts
@@ -655,6 +682,46 @@ declare function hasActiveFilter(filter: FilterState): boolean;
  */
 type LevelCounts = Record<LogLevel, number>;
 //#endregion
+//#region src/types/events.types.d.ts
+interface ScreenManagerEventMap {
+  'screen:added': [screenId: string];
+  'screen:removed': [screenId: string];
+  'screen:reordered': [];
+  'activeScreen:changed': [screenId: string | null];
+  'focus:changed': [area: FocusArea];
+  'sidebar:indexChanged': [index: number];
+  'mode:changed': [mode: RenderMode];
+}
+type ScreenManagerEventType = keyof ScreenManagerEventMap;
+/**
+ * All manager events that adapters typically subscribe to for re-renders.
+ */
+declare const MANAGER_EVENTS: ScreenManagerEventType[];
+interface ScreenEventMap {
+  'message:added': [messageId: string];
+  'message:updated': [messageId: string];
+  'messages:cleared': [];
+  'status:changed': [status: ScreenStatus];
+  'visibility:changed': [hidden: boolean];
+  'badge:changed': [count: number];
+  'prompt:activated': [];
+  'prompt:updated': [];
+  'prompt:resolved': [];
+}
+type ScreenEventType = keyof ScreenEventMap;
+/**
+ * All screen events that adapters typically subscribe to for re-renders.
+ */
+declare const SCREEN_EVENTS: ScreenEventType[];
+/**
+ * Sidebar-specific events that require re-render.
+ */
+declare const SIDEBAR_EVENTS: ScreenManagerEventType[];
+/**
+ * Content area events that affect active screen changes.
+ */
+declare const CONTENT_MANAGER_EVENTS: ScreenManagerEventType[];
+//#endregion
 //#region src/schemas/screen-options.d.ts
 declare const ScreenOptionsSchema: z.ZodObject<{
   name: z.ZodString;
@@ -754,91 +821,219 @@ type PublicScreenLoggerMethods = Pick<ScreenLoggerInstance, keyof ScreenLoggerIn
 type ScreenOwnMethods = Partial<Omit<PublicScreenLoggerMethods, keyof PublicLoggerMethods>>;
 interface IsomorphicLoggerInterface extends PublicLoggerMethods, ScreenOwnMethods {}
 //#endregion
-//#region src/components/log/log_message.d.ts
+//#region src/utils/colors/log-colors.d.ts
 /**
- * LogMessage - A chat-like styled log message with level-based coloring.
- *
- * Features:
- * - Left border with prominent color based on log level
- * - Subtle tinted background matching the log level
- * - Optional timestamp and label display
- * - Supports both simple text and complex React children
- * - Optional variant for semantic styling (e.g., 'success', 'trace')
- *
- * @example
- * <LogMessage level="error">
- *   Connection failed: timeout after 30s
- * </LogMessage>
- *
- * @example
- * <LogMessage level="log" timestamp={new Date()} label="API">
- *   Request completed successfully
- * </LogMessage>
- *
- * @example
- * <LogMessage level="log" variant="success">
- *   Operation completed successfully
- * </LogMessage>
- */
-declare function LogMessage({
-  level,
-  variant,
-  children,
-  timestamp,
-  label,
-  trace,
-  borderColor: customBorderColor,
-  backgroundColor: customBackgroundColor,
-  borderStyle,
-  padding,
-  margin
-}: LogMessageProps): react11.ReactNode;
+ * Default color scheme for all log levels.
+ * Each level has a prominent border color and a subtle background tint.
+ */
+declare const DEFAULT_LOG_LEVEL_COLORS: LogLevelColorMap;
+/**
+ * Colors for semantic variants (override level colors when variant is set).
+ */
+declare const VARIANT_COLORS: Record<LogMessageVariant, LogLevelColors>;
+/**
+ * Error highlighting colors.
+ */
+declare const ERROR_HIGHLIGHT_COLORS: {
+  background: string;
+  border: string;
+  gutterBackground: string;
+};
 //#endregion
-//#region src/components/file/file_log.d.ts
+//#region src/utils/colors/sidebar-colors.d.ts
 /**
- * FileLog - Displays file content, diffs, or partial files with error highlighting.
- *
- * Three modes:
- * 1. "full" - Display complete file with syntax highlighting
- * 2. "diff" - Display unified diff using <diff> component
- * 3. "partial" - Display file excerpt with optional error line highlighting
+ * Sidebar colors.
+ */
+declare const SIDEBAR_COLORS: {
+  background: undefined;
+  selectedBackground: string;
+  hoverBackground: string;
+  text: string;
+  textDim: string;
+  border: string;
+  badge: string;
+  focusBorder: string;
+};
+/**
+ * Screen header colors.
+ */
+declare const HEADER_COLORS: {
+  background: undefined;
+  text: string;
+  border: string;
+};
+/**
+ * Screen status indicator colors and icons.
+ */
+declare const STATUS_INDICATORS: {
+  readonly waiting: {
+    readonly icon: "○";
+    readonly color: "#6B7280";
+  };
+  readonly pending: {
+    readonly icon: "◐";
+    readonly color: "#F59E0B";
+  };
+  readonly success: {
+    readonly icon: "✓";
+    readonly color: "#22C55E";
+  };
+  readonly fail: {
+    readonly icon: "✗";
+    readonly color: "#EF4444";
+  };
+};
+/**
+ * Separator colors for sidebar sections.
+ */
+declare const SEPARATOR_COLORS: {
+  line: string;
+  text: string;
+};
+//#endregion
+//#region src/utils/colors/progress-colors.d.ts
+/**
+ * Progress bar colors.
+ */
+declare const PROGRESS_COLORS: {
+  border: string;
+  background: string;
+  barFilled: string;
+  barEmpty: string;
+  text: string;
+  textDim: string;
+  complete: string;
+  completeBackground: string;
+  failed: string;
+  failedBackground: string;
+};
+/**
+ * Group colors for collapsible log groups.
+ */
+declare const GROUP_COLORS: {
+  border: string;
+  background: string;
+  headerText: string;
+  icon: string;
+};
+//#endregion
+//#region src/utils/colors/table-colors.d.ts
+/**
+ * Table colors (uses info/blue scheme).
+ */
+declare const TABLE_COLORS: {
+  border: string;
+  background: string;
+  headerText: string;
+  cellText: string;
+  title: string;
+  separator: string;
+};
+//#endregion
+//#region src/utils/colors/file-colors.d.ts
+/**
+ * File display colors (uses info/blue scheme).
+ */
+declare const FILE_COLORS: {
+  border: string;
+  background: string;
+  headerText: string;
+  headerBackground: string;
+};
+//#endregion
+//#region src/utils/colors/prompt-colors.d.ts
+/**
+ * Prompt colors for interactive prompts.
+ */
+declare const PROMPT_COLORS: {
+  question: string;
+  optionText: string;
+  optionTextDim: string;
+  optionSelected: string;
+  optionSelectedBackground: string;
+  confirmButton: string;
+  cancelButton: string;
+  buttonBackground: string;
+  buttonSelectedBackground: string;
+  inputBorder: string;
+  inputBackground: string;
+  inputText: string;
+  inputPlaceholder: string;
+  inputCursor: string;
+  border: string;
+  focusBorder: string;
+};
+//#endregion
+//#region src/utils/colors/helpers.d.ts
+/**
+ * Gets colors for a specific log level.
  *
- * @example Full file
- * <FileLog
- *   mode="full"
- *   filePath="src/index.ts"
- *   content={fileContent}
- * />
+ * @param level - The log level
+ * @param customColors - Optional custom color map
+ */
+declare function getLogLevelColors(level: LogLevel, customColors?: Partial<LogLevelColorMap>): LogLevelColors;
+//#endregion
+//#region src/utils/filetype.d.ts
+/**
+ * Common file extension to filetype mapping for syntax highlighting.
+ */
+declare const COMMON_FILETYPES: Record<string, string>;
+/**
+ * Resolves filetype from file path for syntax highlighting.
  *
- * @example Diff
- * <FileLog
- *   mode="diff"
- *   filePath="src/api.ts"
- *   diff={unifiedDiff}
- *   view="unified"
- * />
+ * @param filePath - Full file path or just filename
+ * @returns Filetype string for tree-sitter, or undefined
+ */
+declare function resolveFiletype(filePath: string): string | undefined;
+/**
+ * Gets the filename from a full path.
  *
- * @example Partial with error
- * <FileLog
- *   mode="partial"
- *   filePath="src/utils.ts"
- *   content={excerpt}
- *   startLine={42}
- *   errorLines={[45, 46]}
- * />
- */
-declare function FileLog(props: FileLogProps): react11.ReactNode;
+ * @param filePath - Full file path
+ * @returns Just the filename
+ */
+declare function getFileName(filePath: string): string;
 //#endregion
-//#region src/components/prompt/prompt_renderer.d.ts
-interface PromptRendererProps {
-  prompt: PromptData;
-}
-declare function PromptRenderer({
-  prompt
-}: PromptRendererProps): react11.ReactNode;
+//#region src/utils/stdout-printer.d.ts
+/**
+ * Print a single message to stdout with optional screen name prefix.
+ * Used for immediate output in stdout mode (when OpenTUI is not active).
+ */
+declare function printSingleMessage(message: MessageData, screenName?: string, isError?: boolean): void;
+/**
+ * Print all messages to stdout (or stderr if isError)
+ */
+declare function printMessagesToStdout(messages: MessageData[], screenName: string, isError?: boolean): void;
+//#endregion
+//#region src/utils/format.d.ts
+/**
+ * Format an object for display with configurable depth
+ */
+declare function formatObject(obj: unknown, depth?: number, currentDepth?: number): string;
+/**
+ * Capture a stack trace, filtering out internal frames
+ */
+declare function captureTrace(offset?: number): string;
+//#endregion
+//#region src/utils/runtime.d.ts
+/**
+ * Detect if running in Bun environment (OpenTUI is not supported in Bun)
+ */
+declare function isBunRuntime(): boolean;
+/**
+ * Dynamic import that bypasses bundler static analysis.
+ * Uses Function constructor to prevent bundlers from resolving the import at build time.
+ */
+declare function dynamicImport<T = unknown>(modulePath: string): Promise<T>;
+//#endregion
+//#region src/utils/prompt.d.ts
+/**
+ * Get the default value for a prompt based on its type.
+ * Used for resolving prompts when no interaction is possible.
+ */
+declare function getPromptDefaultValue(prompt: PromptData): string | boolean | string[];
 //#endregion
 //#region src/services/screen.d.ts
-declare class ScreenInstance {
+declare class ScreenInstance extends EventEmitter<ScreenEventMap> {
   private id;
   private name;
   private icon?;
@@ -847,7 +1042,6 @@ declare class ScreenInstance {
   private hidden;
   private messages;
   private manager;
-  private changeListeners;
   private printFn;
   private hasPrinted;
   private version;
@@ -859,7 +1053,7 @@ declare class ScreenInstance {
   /**
    * Internal: Set the manager reference
    */
-  _setManager(manager: ScreenManager): void;
+  _setManager(manager: ScreenManagerInstance): void;
   /**
    * Internal: Set the print function for stdout output
    */
@@ -875,7 +1069,12 @@ declare class ScreenInstance {
   hide(): this;
   getStatus(): ScreenStatus;
   /**
-   * Set screen status. When success/fail and TUI is not bound, prints to stdout/stderr
+   * Check if a log level is enabled globally via the ScreenManager.
+   * Returns true if no manager is set or if the level is allowed.
+   */
+  isLogLevelEnabled(level: LogLevel): boolean;
+  /**
+   * Set screen status. When success/fail and not in TUI mode, prints to stdout/stderr
    */
   setStatus(status: ScreenStatus): this;
   /**
@@ -883,7 +1082,8 @@ declare class ScreenInstance {
    */
   isComplete(): boolean;
   /**
-   * Check if this screen has been printed to console
+   * Check if this screen has been printed to console.
+   * Static screens in non-TUI modes are considered printed as they print incrementally.
    */
   hasPrintedToConsole(): boolean;
   /**
@@ -986,10 +1186,9 @@ declare class ScreenInstance {
    */
   private activateNextPrompt;
   /**
-   * Register a change listener for re-renders
+   * Print a single message immediately to stdout (for static screens in stdout mode)
    */
-  onChange(listener: () => void): () => void;
-  private notifyChange;
+  private printSingleMessageToConsole;
   /**
    * Print all messages to stdout/stderr with ANSI colors
    */
@@ -997,19 +1196,23 @@ declare class ScreenInstance {
 }
 //#endregion
 //#region src/services/screen_manager.d.ts
-declare class ScreenManager {
+declare class ScreenManagerInstance extends EventEmitter<ScreenManagerEventMap> implements OnServiceDestroy {
   private screens;
   private screenOrder;
   private activeScreenId;
   private renderer;
   private root;
-  private isBound;
-  private changeListeners;
+  private adapter;
+  private container;
+  private mode;
+  private readlinePromptService;
   private bindOptions;
   private autoCloseTimer;
   private theme;
+  private globalLogLevels;
   focusArea: FocusArea;
   selectedIndex: number;
+  constructor();
   /**
    * Create a new screen and return it
    */
@@ -1023,23 +1226,73 @@ declare class ScreenManager {
    * Non-blocking bind - starts TUI rendering in background
    */
   bind(options?: BindOptions): Promise<void>;
+  /**
+   * Get the current render mode
+   */
+  getRenderMode(): RenderMode;
+  /**
+   * Check if TUI is interactive (any mode except UNBOUND).
+   * In interactive modes, prompts can be handled via readline or TUI.
+   */
+  isInteractive(): boolean;
+  /**
+   * Check if TUI rendering is active (TUI_ACTIVE mode).
+   * When true, screens are rendered in the TUI and not printed to stdout.
+   */
+  hasTuiRenderer(): boolean;
+  /**
+   * Handle a prompt via readline (for stdout modes)
+   */
+  handleReadlinePrompt(prompt: PromptData): Promise<string | boolean | string[]>;
   /**
    * Get the configured theme
    */
   getTheme(): Theme | undefined;
+  /**
+   * Setup global configuration for the screen manager.
+   * Can be called before or after bind() to configure theme and log levels.
+   */
+  setup(options: SetupOptions): void;
+  /**
+   * Check if a log level is enabled globally.
+   * Returns true if no global filter is set, or if the level is in the allowed set.
+   */
+  isLogLevelEnabled(level: LogLevel): boolean;
+  /**
+   * Get the current global log levels filter.
+   * Returns null if no filter is set (all levels allowed).
+   */
+  getGlobalLogLevels(): LogLevel[] | null;
+  onServiceDestroy(): void;
   /**
    * Stop TUI rendering and cleanup
-   * Flushes all completed screens to stdout/stderr
+   * Flushes screens to stdout/stderr based on mode
    */
   unbind(): void;
   /**
-   * Print all completed screens that haven't been printed yet
+   * Flush screens on exit based on the mode we're exiting from
+   */
+  private flushScreensOnExit;
+  /**
+   * Flush any remaining non-hidden screens that haven't been printed.
+   * Called on destroy even in UNBOUND mode to handle forgotten completions.
    */
-  private flushCompletedScreens;
+  private flushRemainingScreens;
   /**
    * Check if TUI is currently bound
+   * @deprecated Use isInteractive() instead
    */
   isTuiBound(): boolean;
+  /**
+   * Check if TUI rendering is active (has renderer or self-rendering adapter).
+   * @deprecated Use hasTuiRenderer() instead
+   */
+  isTuiRendererActive(): boolean;
+  /**
+   * Check if OpenTUI rendering is active (has renderer).
+   * @deprecated Use hasTuiRenderer() instead
+   */
+  isOpenTUIActive(): boolean;
   /**
    * Called by Screen when a prompt becomes active
    * Focuses the screen and switches to content area
@@ -1113,11 +1366,6 @@ declare class ScreenManager {
    * Toggle focus between sidebar and content
    */
   toggleFocus(): void;
-  /**
-   * Register a change listener for re-renders
-   */
-  onChange(listener: () => void): () => void;
-  private notifyChange;
   private render;
 }
 //#endregion
@@ -1151,401 +1399,53 @@ declare class PromptInstance {
   multiChoice(options: MultiChoiceOptions): Promise<string[]>;
 }
 //#endregion
-//#region src/components/screen/screen_bridge.d.ts
-interface ScreenBridgeProps {
-  screen: ScreenInstance;
-  focused: boolean;
-  /** Pre-filtered messages (if filtering is active) */
-  filteredMessages?: MessageData[];
-  /** Whether any filter is currently active */
-  isFiltering?: boolean;
-  /** Total message count (before filtering) */
-  totalMessages?: number;
-}
-declare function ScreenBridge({
-  screen,
-  focused,
-  filteredMessages,
-  isFiltering,
-  totalMessages
-}: ScreenBridgeProps): react11.ReactNode;
-//#endregion
-//#region src/components/screen/message_renderer.d.ts
-interface MessageRendererProps {
-  message: MessageData;
-}
-declare function MessageRenderer({
-  message
-}: MessageRendererProps): react11.ReactNode;
-//#endregion
-//#region src/components/screen/loading_message.d.ts
-interface LoadingMessageProps {
-  message: LoadingMessageData;
-}
-declare function LoadingMessage({
-  message
-}: LoadingMessageProps): react11.ReactNode;
-//#endregion
-//#region src/components/screen/progress_message.d.ts
-interface ProgressMessageProps {
-  message: ProgressMessageData;
-}
-declare function ProgressMessage({
-  message
-}: ProgressMessageProps): react11.ReactNode;
-//#endregion
-//#region src/components/screen/group_renderer.d.ts
-interface GroupRendererProps {
-  label: string;
-  messages: MessageData[];
-}
-declare function GroupRenderer({
-  label,
-  messages
-}: GroupRendererProps): react11.ReactNode;
-interface GroupMessageRendererProps {
-  message: GroupMessageData;
-}
+//#region src/services/readline_prompt.d.ts
 /**
- * Fallback renderer for group markers (when not processed at higher level)
+ * Readline-based prompt service for stdout mode.
+ * Provides basic interactive prompts when TUI adapter is not available.
  */
-declare function GroupMessageRenderer({
-  message
-}: GroupMessageRendererProps): react11.ReactNode;
-//#endregion
-//#region src/components/screen/table_message.d.ts
-interface TableMessageProps {
-  message: TableMessageData;
-}
-declare function TableMessage({
-  message
-}: TableMessageProps): react11.ReactNode;
-//#endregion
-//#region src/components/sidebar/sidebar.d.ts
-interface SidebarProps {
-  screens: ScreenInstance[];
-  selectedIndex: number;
-  activeScreenId: string;
-  focused: boolean;
-  width: number;
-  title: string;
-}
-declare function Sidebar({
-  screens,
-  selectedIndex,
-  activeScreenId,
-  focused,
-  width,
-  title
-}: SidebarProps): react11.ReactNode;
-//#endregion
-//#region src/components/sidebar/sidebar_item.d.ts
-interface SidebarItemProps {
-  screen: ScreenInstance;
-  isSelected: boolean;
-  isActive: boolean;
-  focused: boolean;
-}
-declare function SidebarItem({
-  screen,
-  isSelected,
-  isActive,
-  focused
-}: SidebarItemProps): react11.ReactNode;
-//#endregion
-//#region src/components/sidebar/sidebar_separator.d.ts
-declare function SidebarSeparator(): react11.ReactNode;
-//#endregion
-//#region src/components/screen_manager_bridge.d.ts
-interface ScreenManagerBridgeProps {
-  manager: ScreenManager;
-  theme?: Theme;
-}
-declare function ScreenManagerBridge({
-  manager,
-  theme
-}: ScreenManagerBridgeProps): react11.ReactNode;
-//#endregion
-//#region src/context/logger_context.d.ts
-interface LoggerProviderProps {
-  children: ReactNode;
-  /** Custom syntax style for code highlighting */
-  syntaxStyle?: SyntaxStyle;
-  /** Tree-sitter client for parsing */
-  treeSitterClient?: TreeSitterClient;
+declare class ReadlinePromptService {
+  private rl;
+  private promptQueue;
+  private isProcessing;
+  private ensureInterface;
   /**
-   * Theme configuration.
-   * Can be a preset name ("dark", "light", "high-contrast") or a Theme object.
-   * @default "dark"
+   * Handle a prompt interactively via readline.
+   * Prompts are queued and processed sequentially.
    */
-  theme?: Theme | ThemePreset;
+  handlePrompt(prompt: PromptData): Promise<string | boolean | string[]>;
+  private processQueue;
+  private processPrompt;
+  private handleChoice;
+  private handleConfirm;
+  private handleInput;
+  private handleMultiChoice;
   /**
-   * @deprecated Use `theme` instead. Custom log level colors.
-   * If both `theme` and `levelColors` are provided, `levelColors` takes precedence.
+   * Cleanup readline interface
    */
-  levelColors?: Partial<LogLevelColorMap>;
+  destroy(): void;
 }
-/**
- * LoggerProvider - Provides shared context for logger components.
- *
- * This context provides:
- * - Shared SyntaxStyle instance for consistent code highlighting
- * - Optional TreeSitterClient for advanced parsing
- * - Theme configuration for consistent styling
- * - Log level color configuration (for backwards compatibility)
- *
- * @example
- * // Using a preset theme
- * <LoggerProvider theme="dark">
- *   <ScreenManager screens={screens} activeScreenId={activeId}>
- *     <Screen name="Logs">
- *       <LogMessage level="info">Hello</LogMessage>
- *     </Screen>
- *   </ScreenManager>
- * </LoggerProvider>
- *
- * @example
- * // Using a custom theme
- * <LoggerProvider theme={myCustomTheme}>
- *   ...
- * </LoggerProvider>
- */
-declare function LoggerProvider({
-  children,
-  syntaxStyle: customSyntaxStyle,
-  treeSitterClient,
-  theme: themeProp,
-  levelColors: customLevelColors
-}: LoggerProviderProps): ReactNode;
-/**
- * Hook to access logger context.
- * Returns default values if used outside LoggerProvider.
- */
-declare function useLoggerContext(): LoggerContextValue;
-//#endregion
-//#region src/utils/colors/log-colors.d.ts
-/**
- * Default color scheme for all log levels.
- * Each level has a prominent border color and a subtle background tint.
- */
-declare const DEFAULT_LOG_LEVEL_COLORS: LogLevelColorMap;
-/**
- * Colors for semantic variants (override level colors when variant is set).
- */
-declare const VARIANT_COLORS: Record<LogMessageVariant, LogLevelColors>;
-/**
- * Error highlighting colors.
- */
-declare const ERROR_HIGHLIGHT_COLORS: {
-  background: string;
-  border: string;
-  gutterBackground: string;
-};
-//#endregion
-//#region src/utils/colors/sidebar-colors.d.ts
-/**
- * Sidebar colors.
- */
-declare const SIDEBAR_COLORS: {
-  background: undefined;
-  selectedBackground: string;
-  hoverBackground: string;
-  text: string;
-  textDim: string;
-  border: string;
-  badge: string;
-  focusBorder: string;
-};
-/**
- * Screen header colors.
- */
-declare const HEADER_COLORS: {
-  background: undefined;
-  text: string;
-  border: string;
-};
-/**
- * Screen status indicator colors and icons.
- */
-declare const STATUS_INDICATORS: {
-  readonly waiting: {
-    readonly icon: "○";
-    readonly color: "#6B7280";
-  };
-  readonly pending: {
-    readonly icon: "◐";
-    readonly color: "#F59E0B";
-  };
-  readonly success: {
-    readonly icon: "✓";
-    readonly color: "#22C55E";
-  };
-  readonly fail: {
-    readonly icon: "✗";
-    readonly color: "#EF4444";
-  };
-};
-/**
- * Separator colors for sidebar sections.
- */
-declare const SEPARATOR_COLORS: {
-  line: string;
-  text: string;
-};
-//#endregion
-//#region src/utils/colors/progress-colors.d.ts
-/**
- * Progress bar colors.
- */
-declare const PROGRESS_COLORS: {
-  border: string;
-  background: string;
-  barFilled: string;
-  barEmpty: string;
-  text: string;
-  textDim: string;
-  complete: string;
-  completeBackground: string;
-  failed: string;
-  failedBackground: string;
-};
-/**
- * Group colors for collapsible log groups.
- */
-declare const GROUP_COLORS: {
-  border: string;
-  background: string;
-  headerText: string;
-  icon: string;
-};
-//#endregion
-//#region src/utils/colors/table-colors.d.ts
-/**
- * Table colors (uses info/blue scheme).
- */
-declare const TABLE_COLORS: {
-  border: string;
-  background: string;
-  headerText: string;
-  cellText: string;
-  title: string;
-  separator: string;
-};
-//#endregion
-//#region src/utils/colors/file-colors.d.ts
-/**
- * File display colors (uses info/blue scheme).
- */
-declare const FILE_COLORS: {
-  border: string;
-  background: string;
-  headerText: string;
-  headerBackground: string;
-};
-//#endregion
-//#region src/utils/colors/prompt-colors.d.ts
-/**
- * Prompt colors for interactive prompts.
- */
-declare const PROMPT_COLORS: {
-  question: string;
-  optionText: string;
-  optionTextDim: string;
-  optionSelected: string;
-  optionSelectedBackground: string;
-  confirmButton: string;
-  cancelButton: string;
-  buttonBackground: string;
-  buttonSelectedBackground: string;
-  inputBorder: string;
-  inputBackground: string;
-  inputText: string;
-  inputPlaceholder: string;
-  inputCursor: string;
-  border: string;
-  focusBorder: string;
-};
-//#endregion
-//#region src/utils/colors/helpers.d.ts
-/**
- * Creates a tinted (subtle) version of a color by setting alpha.
- *
- * @param color - The base color (hex string or RGBA)
- * @param alpha - Target alpha value (0-1), default 0.08 for subtle tinting
- * @returns New RGBA with adjusted alpha
- */
-declare function createTintedColor(color: string | RGBA, alpha?: number): RGBA;
-/**
- * Creates a more prominent version of a color for borders.
- *
- * @param color - The base color
- * @param alpha - Target alpha, default 1.0 for solid borders
- */
-declare function createBorderColor(color: string | RGBA, alpha?: number): RGBA;
-/**
- * Gets colors for a specific log level.
- *
- * @param level - The log level
- * @param customColors - Optional custom color map
- */
-declare function getLogLevelColors(level: LogLevel, customColors?: Partial<LogLevelColorMap>): LogLevelColors;
-//#endregion
-//#region src/utils/filetype.d.ts
-/**
- * Common file extension to filetype mapping for syntax highlighting.
- */
-declare const COMMON_FILETYPES: Record<string, string>;
-/**
- * Resolves filetype from file path for syntax highlighting.
- *
- * @param filePath - Full file path or just filename
- * @returns Filetype string for tree-sitter, or undefined
- */
-declare function resolveFiletype(filePath: string): string | undefined;
-/**
- * Gets the filename from a full path.
- *
- * @param filePath - Full file path
- * @returns Just the filename
- */
-declare function getFileName(filePath: string): string;
-//#endregion
-//#region src/utils/stdout-printer.d.ts
-/**
- * Print all messages to stdout (or stderr if isError)
- */
-declare function printMessagesToStdout(messages: MessageData[], screenName: string, isError?: boolean): void;
-//#endregion
-//#region src/utils/format.d.ts
-/**
- * Format an object for display with configurable depth
- */
-declare function formatObject(obj: unknown, depth?: number, currentDepth?: number): string;
-/**
- * Capture a stack trace, filtering out internal frames
- */
-declare function captureTrace(offset?: number): string;
 //#endregion
 //#region src/tokens/screen.d.ts
-declare const Screen: InjectionToken<ScreenInstance, zod_v416.ZodObject<{
-  name: zod_v416.ZodString;
-  icon: zod_v416.ZodOptional<zod_v416.ZodString>;
-  badgeCount: zod_v416.ZodOptional<zod_v416.ZodNumber>;
-  hidden: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-  static: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-}, zod_v4_core1.$strip>, true>;
+declare const Screen: InjectionToken<ScreenInstance, zod_v40.ZodObject<{
+  name: zod_v40.ZodString;
+  icon: zod_v40.ZodOptional<zod_v40.ZodString>;
+  badgeCount: zod_v40.ZodOptional<zod_v40.ZodNumber>;
+  hidden: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+  static: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+}, zod_v4_core0.$strip>, true>;
 //#endregion
 //#region src/tokens/logger.d.ts
-declare const ScreenLogger: InjectionToken<ScreenLoggerInstance, zod_v416.ZodObject<{
-  screen: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodUnion<[zod_v416.ZodObject<{
-    name: zod_v416.ZodString;
-    icon: zod_v416.ZodOptional<zod_v416.ZodString>;
-    badgeCount: zod_v416.ZodOptional<zod_v416.ZodNumber>;
-    hidden: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-    static: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-  }, zod_v4_core1.$strip>, zod_v416.ZodString]>>>;
-  context: zod_v416.ZodOptional<zod_v416.ZodString>;
-  enabledLevels: zod_v416.ZodDefault<zod_v416.ZodArray<zod_v416.ZodEnum<{
+declare const ScreenLogger: InjectionToken<ScreenLoggerInstance, zod_v40.ZodObject<{
+  screen: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodUnion<[zod_v40.ZodObject<{
+    name: zod_v40.ZodString;
+    icon: zod_v40.ZodOptional<zod_v40.ZodString>;
+    badgeCount: zod_v40.ZodOptional<zod_v40.ZodNumber>;
+    hidden: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+    static: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+  }, zod_v4_core0.$strip>, zod_v40.ZodString]>>>;
+  context: zod_v40.ZodOptional<zod_v40.ZodString>;
+  enabledLevels: zod_v40.ZodDefault<zod_v40.ZodArray<zod_v40.ZodEnum<{
     verbose: "verbose";
     debug: "debug";
     log: "log";
@@ -1553,21 +1453,21 @@ declare const ScreenLogger: InjectionToken<ScreenLoggerInstance, zod_v416.ZodObj
     error: "error";
     fatal: "fatal";
   }>>>;
-}, zod_v4_core1.$strip>, true>;
+}, zod_v4_core0.$strip>, true>;
 /**
  * Isomorphic logger token for shared logger between TUI and Server.
  * This token is used to inject the logger instance into the application.
  */
-declare const IsomorphicLogger: InjectionToken<IsomorphicLoggerInterface, zod_v416.ZodObject<{
-  screen: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodUnion<[zod_v416.ZodObject<{
-    name: zod_v416.ZodString;
-    icon: zod_v416.ZodOptional<zod_v416.ZodString>;
-    badgeCount: zod_v416.ZodOptional<zod_v416.ZodNumber>;
-    hidden: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-    static: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-  }, zod_v4_core1.$strip>, zod_v416.ZodString]>>>;
-  context: zod_v416.ZodOptional<zod_v416.ZodString>;
-  enabledLevels: zod_v416.ZodDefault<zod_v416.ZodArray<zod_v416.ZodEnum<{
+declare const IsomorphicLogger: InjectionToken<IsomorphicLoggerInterface, zod_v40.ZodObject<{
+  screen: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodUnion<[zod_v40.ZodObject<{
+    name: zod_v40.ZodString;
+    icon: zod_v40.ZodOptional<zod_v40.ZodString>;
+    badgeCount: zod_v40.ZodOptional<zod_v40.ZodNumber>;
+    hidden: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+    static: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+  }, zod_v4_core0.$strip>, zod_v40.ZodString]>>>;
+  context: zod_v40.ZodOptional<zod_v40.ZodString>;
+  enabledLevels: zod_v40.ZodDefault<zod_v40.ZodArray<zod_v40.ZodEnum<{
     verbose: "verbose";
     debug: "debug";
     log: "log";
@@ -1575,18 +1475,84 @@ declare const IsomorphicLogger: InjectionToken<IsomorphicLoggerInterface, zod_v4
     error: "error";
     fatal: "fatal";
   }>>>;
-}, zod_v4_core1.$strip>, true>;
+}, zod_v4_core0.$strip>, true>;
 //#endregion
 //#region src/tokens/prompt.d.ts
-declare const Prompt: InjectionToken<PromptInstance, zod_v416.ZodObject<{
-  screen: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodUnion<[zod_v416.ZodObject<{
-    name: zod_v416.ZodString;
-    icon: zod_v416.ZodOptional<zod_v416.ZodString>;
-    badgeCount: zod_v416.ZodOptional<zod_v416.ZodNumber>;
-    hidden: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-    static: zod_v416.ZodDefault<zod_v416.ZodOptional<zod_v416.ZodBoolean>>;
-  }, zod_v4_core1.$strip>, zod_v416.ZodString]>>>;
-}, zod_v4_core1.$strip>, true>;
+declare const Prompt: InjectionToken<PromptInstance, zod_v40.ZodObject<{
+  screen: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodUnion<[zod_v40.ZodObject<{
+    name: zod_v40.ZodString;
+    icon: zod_v40.ZodOptional<zod_v40.ZodString>;
+    badgeCount: zod_v40.ZodOptional<zod_v40.ZodNumber>;
+    hidden: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+    static: zod_v40.ZodDefault<zod_v40.ZodOptional<zod_v40.ZodBoolean>>;
+  }, zod_v4_core0.$strip>, zod_v40.ZodString]>>>;
+}, zod_v4_core0.$strip>, true>;
+//#endregion
+//#region src/adapters/interface.d.ts
+/**
+ * Root instance returned by adapter's createRoot method.
+ * Abstracts the framework-specific root implementation.
+ */
+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.
+ */
+interface AdapterRenderProps {
+  manager: unknown;
+  theme?: Theme;
+}
+/**
+ * Abstract interface for rendering adapters.
+ * Implementations provide framework-specific rendering capabilities.
+ */
+interface AdapterInterface {
+  /**
+   * Whether this adapter handles its own rendering without requiring
+   * the ScreenManager to create an OpenTUI CliRenderer.
+   * When true, createRoot() will be called without a renderer argument.
+   * @default false
+   */
+  readonly handlesOwnRenderer?: boolean;
+  /**
+   * Create a root instance for rendering.
+   * @param renderer - CLI renderer from @opentui/core (undefined if handlesOwnRenderer is true)
+   * @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;
+}
+//#endregion
+//#region src/tokens/adapter.d.ts
+/**
+ * Injection token for the TUI rendering adapter.
+ * Import the specific adapter (e.g., '@navios/commander-tui/adapters/react')
+ * to register an implementation.
+ */
+declare const Adapter: InjectionToken<AdapterInterface, undefined, false>;
+//#endregion
+//#region src/tokens/screen-manager.d.ts
+/**
+ * Injection token for the ScreenManager singleton.
+ * Used for dependency injection without requiring direct import of the class.
+ */
+declare const ScreenManager: InjectionToken<ScreenManagerInstance, undefined, false>;
 //#endregion
 //#region src/factories/isomorphic-logger.factory.d.ts
 declare class IsomorphicLoggerFactory {
@@ -1603,6 +1569,22 @@ declare class ScreenFactory {
 //#region src/overrides/console.logger.override.d.ts
 declare function overrideConsoleLogger(hidden?: boolean): ClassTypeWithInstance<LoggerService>;
 //#endregion
+//#region src/overrides/missing-adapter.override.d.ts
+/**
+ * Fallback adapter that is used when no TUI adapter is registered.
+ * The `isMissingAdapter` marker allows ScreenManager to detect this
+ * and gracefully fall back to stdout mode instead of throwing.
+ */
+declare class MissingAdapterOverride implements AdapterInterface {
+  /**
+   * Marker property to identify this as the missing adapter fallback.
+   * Used by ScreenManager.bind() to detect and handle graceful fallback.
+   */
+  readonly isMissingAdapter = true;
+  createRoot(): AdapterRoot;
+  renderToRoot(): void;
+}
+//#endregion
 //#region src/themes/dark.d.ts
 /**
  * Default dark theme.
@@ -1645,13 +1627,6 @@ declare function createThemeFrom(base: Theme | ThemePreset, overrides: PartialTh
  */
 declare function resolveTheme(theme: Theme | ThemePreset): Theme;
 //#endregion
-//#region src/hooks/use_theme.d.ts
-/**
- * Hook to access the current theme.
- * Returns the theme from LoggerContext.
- */
-declare function useTheme(): Theme;
-//#endregion
 //#region src/keyboard/keyboard_manager.d.ts
 /**
  * Manages keyboard bindings and dispatches key events to handlers.
@@ -1720,7 +1695,7 @@ declare function formatKeyBinding(binding: KeyBinding): string;
  * Interface for binding handlers that need manager/screen access.
  */
 interface BindingHandlers {
-  manager: ScreenManager;
+  manager: ScreenManagerInstance;
   getActiveScreen: () => ScreenInstance | null;
   toggleHelp: () => void;
   toggleFilter: () => void;
@@ -1759,5 +1734,5 @@ declare class FilterEngine {
   static countByLevel(messages: MessageData[]): LevelCounts;
 }
 //#endregion
-export { ALL_LOG_LEVELS, BaseMessage, BasePromptData, BindOptions, BindingHandlers, COMMON_FILETYPES, ChoiceOption, ChoiceOptions, ChoicePromptData, ConfirmOptions, ConfirmPromptData, DEFAULT_LOG_LEVEL_COLORS, DeepPartial, DiffMessageData, ERROR_HIGHLIGHT_COLORS, ErrorHighlightTheme, FILE_COLORS, FileErrorMessageData, FileLog, FileLogBaseProps, FileLogDiffProps, FileLogFullProps, FileLogMode, FileLogPartialProps, FileLogProps, FileMessageData, FileTheme, FilterEngine, FilterState, FilterTheme, FocusArea, GROUP_COLORS, GroupMessageData, GroupMessageRenderer, GroupMessageRendererProps, GroupRenderer, GroupRendererProps, GroupTheme, HEADER_COLORS, HeaderTheme, HelpTheme, InputOptions, InputPromptData, IsomorphicLogger, IsomorphicLoggerFactory, IsomorphicLoggerInterface, KeyBinding, KeyBindingCategory, KeyBindingCondition, KeyBindingsConfig, KeyEvent, KeyHandler, KeyboardContext, KeyboardManager, LevelCounts, LoadingHandle, LoadingMessage, LoadingMessageData, LoadingMessageProps, LogLevelColorMap, LogLevelColors, LogLevelTheme, LogMessage, LogMessageData, LogMessageProps, LogMessageVariant, LoggerContextValue, LoggerOptions, LoggerOptionsSchema, LoggerProvider, LoggerProviderProps, MessageData, MessageRenderer, MessageRendererProps, MessageType, MultiChoiceOptions, MultiChoicePromptData, PROGRESS_COLORS, PROMPT_COLORS, PartialTheme, ProgressHandle, ProgressMessage, ProgressMessageData, ProgressMessageProps, ProgressTheme, PromiseOptions, Prompt, PromptData, PromptInstance, PromptOptions, PromptOptionsSchema, PromptRenderer, type PromptRendererProps, PromptTheme, SEPARATOR_COLORS, SIDEBAR_COLORS, STATUS_INDICATORS, Screen, ScreenBridge, ScreenBridgeProps, ScreenDefinition, ScreenFactory, ScreenInstance, ScreenLogger, ScreenLoggerInstance, ScreenManager, ScreenManagerBridge, ScreenManagerBridgeProps, ScreenManagerProps, ScreenOptions, ScreenOptionsSchema, ScreenProps, ScreenStatus, SemanticColors, SeparatorTheme, Sidebar, SidebarItem, SidebarItemProps, SidebarProps, SidebarSeparator, SidebarTheme, StatusIndicator, StatusIndicatorsTheme, TABLE_COLORS, TableMessage, TableMessageData, TableMessageProps, TableTheme, Theme, ThemePreset, VARIANT_COLORS, VariantColorMap, captureTrace, createBorderColor, createDefaultBindings, createDefaultFilterState, createTheme, createThemeFrom, createTintedColor, darkTheme, formatKeyBinding, formatObject, getFileName, getLogLevelColors, getThemePreset, handlePrintableInput, hasActiveFilter, highContrastTheme, lightTheme, mergeThemes, overrideConsoleLogger, printMessagesToStdout, resolveFiletype, resolveTheme, useLoggerContext, useTheme };
+export { ALL_LOG_LEVELS, Adapter, AdapterInterface, AdapterRenderProps, AdapterRoot, BaseMessage, BasePromptData, BindOptions, BindingHandlers, COMMON_FILETYPES, CONTENT_MANAGER_EVENTS, ChoiceOption, ChoiceOptions, ChoicePromptData, ConfirmOptions, ConfirmPromptData, DEFAULT_LOG_LEVEL_COLORS, DeepPartial, DiffMessageData, ERROR_HIGHLIGHT_COLORS, ErrorHighlightTheme, FILE_COLORS, FileErrorMessageData, FileLogBaseProps, FileLogDiffProps, FileLogFullProps, FileLogMode, FileLogPartialProps, FileLogProps, FileMessageData, FileTheme, FilterEngine, FilterState, FilterTheme, FocusArea, GROUP_COLORS, GroupMessageData, GroupTheme, HEADER_COLORS, HeaderTheme, HelpTheme, InputOptions, InputPromptData, IsomorphicLogger, IsomorphicLoggerFactory, IsomorphicLoggerInterface, KeyBinding, KeyBindingCategory, KeyBindingCondition, KeyBindingsConfig, KeyEvent, KeyHandler, KeyboardContext, KeyboardManager, LevelCounts, LoadingHandle, LoadingMessageData, LogLevelColorMap, LogLevelColors, LogLevelTheme, LogMessageData, LogMessageProps, LogMessageVariant, LoggerContextValue, LoggerOptions, LoggerOptionsSchema, MANAGER_EVENTS, MessageData, MessageType, MissingAdapterOverride, MultiChoiceOptions, MultiChoicePromptData, PROGRESS_COLORS, PROMPT_COLORS, PartialTheme, ProgressHandle, ProgressMessageData, ProgressTheme, PromiseOptions, Prompt, PromptData, PromptInstance, PromptOptions, PromptOptionsSchema, PromptTheme, ReadlinePromptService, RenderMode, SCREEN_EVENTS, SEPARATOR_COLORS, SIDEBAR_COLORS, SIDEBAR_EVENTS, STATUS_INDICATORS, Screen, ScreenDefinition, ScreenEventMap, ScreenEventType, ScreenFactory, ScreenInstance, ScreenLogger, ScreenLoggerInstance, ScreenManager, ScreenManagerEventMap, ScreenManagerEventType, ScreenManagerInstance, ScreenManagerProps, ScreenOptions, ScreenOptionsSchema, ScreenProps, ScreenStatus, SemanticColors, SeparatorTheme, SetupOptions, SidebarTheme, StatusIndicator, StatusIndicatorsTheme, TABLE_COLORS, TableMessageData, TableTheme, Theme, ThemePreset, VARIANT_COLORS, VariantColorMap, captureTrace, createDefaultBindings, createDefaultFilterState, createTheme, createThemeFrom, darkTheme, dynamicImport, formatKeyBinding, formatObject, getFileName, getLogLevelColors, getPromptDefaultValue, getThemePreset, handlePrintableInput, hasActiveFilter, highContrastTheme, isBunRuntime, lightTheme, mergeThemes, overrideConsoleLogger, printMessagesToStdout, printSingleMessage, resolveFiletype, resolveTheme };
 //# sourceMappingURL=index.d.mts.map