@navios/commander-tui 1.3.0 → 1.4.0

package/lib/index.d.mts

@@ -1,10 +1,727 @@
-import { $ as FileLogBaseProps, A as ScreenDefinition, B as HelpTheme, C as InputPromptData, Ct as TableMessageData, D as BindOptions, E as PromptData, F as ErrorHighlightTheme, G as SemanticColors, H as PartialTheme, I as FileTheme, J as StatusIndicator, K as SeparatorTheme, L as FilterTheme, M as ScreenProps, N as ScreenStatus, O as FocusArea, P as DeepPartial, Q as ThemePreset, R as GroupTheme, S as InputOptions, St as PromiseOptions, T as MultiChoicePromptData, U as ProgressTheme, V as LogLevelTheme, W as PromptTheme, X as TableTheme, Y as StatusIndicatorsTheme, Z as Theme, _ as ChoiceOption, _t as LogMessageVariant, a as FilterState, at as LogLevelColorMap, b as ConfirmOptions, bt as ProgressHandle, c as hasActiveFilter, ct as VariantColorMap, d as KeyBindingCondition, dt as FileErrorMessageData, et as FileLogDiffProps, f as KeyBindingsConfig, ft as FileMessageData, g as BasePromptData, gt as LogMessageData, h as KeyboardContext, ht as LoadingMessageData, i as ALL_LOG_LEVELS, it as FileLogProps, j as ScreenManagerProps, k as LoggerContextValue, l as KeyBinding, lt as BaseMessage, m as KeyHandler, mt as LoadingHandle, n as AdapterRenderProps, nt as FileLogMode, o as LevelCounts, ot as LogLevelColors, p as KeyEvent, pt as GroupMessageData, q as SidebarTheme, r as AdapterRoot, rt as FileLogPartialProps, s as createDefaultFilterState, st as LogMessageProps, t as AdapterInterface, tt as FileLogFullProps, u as KeyBindingCategory, ut as DiffMessageData, v as ChoiceOptions, vt as MessageData, w as MultiChoiceOptions, x as ConfirmPromptData, xt as ProgressMessageData, y as ChoicePromptData, yt as MessageType, z as HeaderTheme } from "./interface-CTHQ08aY.mjs";
-import { RGBA } from "@opentui/core";
 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 * as zod_v40 from "zod/v4";
 import { z } from "zod/v4";
 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';
+interface BaseMessage {
+  id: string;
+  type: MessageType;
+  timestamp: Date;
+}
+/**
+ * Semantic variants for log messages that don't map directly to LogLevel.
+ * These affect styling but the underlying LogLevel is used for filtering.
+ */
+type LogMessageVariant = 'success' | 'trace';
+interface LogMessageData extends BaseMessage {
+  type: 'log';
+  level: LogLevel;
+  /** Content is always a string - objects are formatted before storage */
+  content: string;
+  label?: string;
+  trace?: string;
+  /** Optional semantic variant for styling (e.g., 'success' shows green even though level is 'log') */
+  variant?: LogMessageVariant;
+}
+interface FileMessageData extends BaseMessage {
+  type: 'file';
+  filePath: string;
+  content: string;
+}
+interface DiffMessageData extends BaseMessage {
+  type: 'diff';
+  filePath: string;
+  diff: string;
+  view?: 'unified' | 'split';
+}
+interface FileErrorMessageData extends BaseMessage {
+  type: 'fileError';
+  filePath: string;
+  content: string;
+  errorLines: number[];
+  startLine: number;
+}
+interface LoadingMessageData extends BaseMessage {
+  type: 'loading';
+  content: string;
+  status: 'loading' | 'success' | 'fail';
+  resolvedContent?: string;
+}
+interface ProgressMessageData extends BaseMessage {
+  type: 'progress';
+  label: string;
+  current: number;
+  total: number;
+  status: 'active' | 'complete' | 'failed';
+  resolvedContent?: string;
+}
+interface GroupMessageData extends BaseMessage {
+  type: 'group';
+  label: string;
+  collapsed: boolean;
+  isEnd: boolean;
+}
+interface TableMessageData extends BaseMessage {
+  type: 'table';
+  headers: string[];
+  rows: string[][];
+  title?: string;
+}
+type MessageData = LogMessageData | FileMessageData | DiffMessageData | FileErrorMessageData | LoadingMessageData | ProgressMessageData | GroupMessageData | TableMessageData;
+interface PromiseOptions<T> {
+  loading: string;
+  success: string | ((data: T) => string);
+  error: string | ((error: Error) => string);
+}
+interface LoadingHandle {
+  success: (message: string) => void;
+  fail: (message: string) => void;
+}
+interface ProgressHandle {
+  update: (current: number, label?: string) => void;
+  complete: (message?: string) => void;
+  fail: (message?: string) => void;
+}
+//#endregion
+//#region src/types/log.types.d.ts
+interface LogLevelColors {
+  border: string;
+  background: string;
+  text?: string;
+}
+type LogLevelColorMap = Record<LogLevel, LogLevelColors>;
+/**
+ * Color map for semantic variants (success, trace) that override level colors.
+ */
+type VariantColorMap = Record<LogMessageVariant, LogLevelColors>;
+interface LogMessageProps {
+  /** Log level determines the color scheme */
+  level: LogLevel;
+  /** Optional semantic variant for styling (e.g., 'success' shows green even though level is 'log') */
+  variant?: LogMessageVariant;
+  /** Message content - can be string or React nodes */
+  children: ReactNode;
+  /** Optional timestamp to display */
+  timestamp?: Date | string;
+  /** Optional label/prefix (e.g., "API", "Database") */
+  label?: string;
+  /** Optional stack trace to display (for trace level) */
+  trace?: string;
+  /** Optional custom border color (overrides level color) */
+  borderColor?: string | RGBA;
+  /** Optional custom background color (overrides level color) */
+  backgroundColor?: string | RGBA;
+  /** Border width style - 'thin' uses left border only, 'thick' uses left+top+bottom */
+  borderStyle?: 'thin' | 'thick';
+  /** Padding inside the message box */
+  padding?: number;
+  /** Margin around the message */
+  margin?: number;
+}
+//#endregion
+//#region src/types/file.types.d.ts
+type FileLogMode = 'full' | 'diff' | 'partial';
+interface FileLogBaseProps {
+  /** File path or name to display in header */
+  filePath: string;
+  /** Override auto-detected filetype for syntax highlighting */
+  filetype?: string;
+  /** Show line numbers */
+  showLineNumbers?: boolean;
+  /** Show header with file path */
+  showHeader?: boolean;
+  /** Custom header background color */
+  headerBackgroundColor?: string | RGBA;
+}
+interface FileLogFullProps extends FileLogBaseProps {
+  mode: 'full';
+  /** The complete file content */
+  content: string;
+}
+interface FileLogDiffProps extends FileLogBaseProps {
+  mode: 'diff';
+  /** Unified diff string */
+  diff: string;
+  /** Diff view mode */
+  view?: 'unified' | 'split';
+}
+interface FileLogPartialProps extends FileLogBaseProps {
+  mode: 'partial';
+  /** File content (full or partial) */
+  content: string;
+  /** Starting line number of the content (1-indexed) */
+  startLine: number;
+  /** Lines to highlight as errors */
+  errorLines?: number[];
+  /** Error highlighting colors */
+  errorLineBackground?: string | RGBA;
+  errorLineBorderColor?: string | RGBA;
+}
+type FileLogProps = FileLogFullProps | FileLogDiffProps | FileLogPartialProps;
+//#endregion
+//#region src/types/theme.types.d.ts
+/**
+ * Color scheme for a single log level.
+ */
+interface LogLevelTheme {
+  border: string;
+  background: string;
+  text?: string;
+}
+/**
+ * Sidebar color scheme.
+ */
+interface SidebarTheme {
+  background?: string;
+  selectedBackground: string;
+  hoverBackground: string;
+  text: string;
+  textDim: string;
+  border: string;
+  badge: string;
+  focusBorder: string;
+}
+/**
+ * Screen header color scheme.
+ */
+interface HeaderTheme {
+  background?: string;
+  text: string;
+  border: string;
+}
+/**
+ * Status indicator with icon and color.
+ */
+interface StatusIndicator {
+  icon: string;
+  color: string;
+}
+/**
+ * Status indicators for all screen states.
+ */
+interface StatusIndicatorsTheme {
+  waiting: StatusIndicator;
+  pending: StatusIndicator;
+  success: StatusIndicator;
+  fail: StatusIndicator;
+  static: StatusIndicator;
+}
+/**
+ * Separator colors for sidebar sections.
+ */
+interface SeparatorTheme {
+  line: string;
+  text: string;
+}
+/**
+ * Progress bar and loading indicator colors.
+ */
+interface ProgressTheme {
+  border: string;
+  background: string;
+  barFilled: string;
+  barEmpty: string;
+  text: string;
+  textDim: string;
+  complete: string;
+  completeBackground: string;
+  failed: string;
+  failedBackground: string;
+}
+/**
+ * Collapsible group colors.
+ */
+interface GroupTheme {
+  border: string;
+  background: string;
+  headerText: string;
+  icon: string;
+}
+/**
+ * Table display colors.
+ */
+interface TableTheme {
+  border: string;
+  background: string;
+  headerText: string;
+  cellText: string;
+  title: string;
+  separator: string;
+}
+/**
+ * File display colors.
+ */
+interface FileTheme {
+  border: string;
+  background: string;
+  headerText: string;
+  headerBackground: string;
+}
+/**
+ * Interactive prompt colors.
+ */
+interface PromptTheme {
+  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;
+}
+/**
+ * Error highlighting colors for file displays.
+ */
+interface ErrorHighlightTheme {
+  background: string;
+  border: string;
+  gutterBackground: string;
+}
+/**
+ * Filter bar colors.
+ */
+interface FilterTheme {
+  background: string;
+  border: string;
+  text: string;
+  textDim: string;
+  inputBackground: string;
+  inputText: string;
+  inputPlaceholder: string;
+  cursor: string;
+  activeLevel: string;
+  inactiveLevel: string;
+}
+/**
+ * Help overlay colors.
+ */
+interface HelpTheme {
+  background: string;
+  border: string;
+  title: string;
+  category: string;
+  key: string;
+  description: string;
+  hint: string;
+}
+/**
+ * General semantic colors.
+ */
+interface SemanticColors {
+  primary: string;
+  secondary: string;
+  success: string;
+  warning: string;
+  error: string;
+  muted: string;
+  background?: string;
+  foreground: string;
+}
+/**
+ * Complete theme definition.
+ */
+interface Theme {
+  /** Theme identifier */
+  name: string;
+  /** Log level color schemes */
+  logLevels: Record<LogLevel, LogLevelTheme>;
+  /** Sidebar colors */
+  sidebar: SidebarTheme;
+  /** Screen header colors */
+  header: HeaderTheme;
+  /** Status indicator colors and icons */
+  statusIndicators: StatusIndicatorsTheme;
+  /** Separator colors */
+  separator: SeparatorTheme;
+  /** Progress bar colors */
+  progress: ProgressTheme;
+  /** Collapsible group colors */
+  group: GroupTheme;
+  /** Table display colors */
+  table: TableTheme;
+  /** File display colors */
+  file: FileTheme;
+  /** Prompt colors */
+  prompt: PromptTheme;
+  /** Error highlighting colors */
+  errorHighlight: ErrorHighlightTheme;
+  /** Filter bar colors */
+  filter: FilterTheme;
+  /** Help overlay colors */
+  help: HelpTheme;
+  /** General semantic colors */
+  colors: SemanticColors;
+}
+/**
+ * Theme preset names.
+ */
+type ThemePreset = 'dark' | 'light' | 'high-contrast';
+/**
+ * Deep partial type for theme overrides.
+ */
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P] };
+/**
+ * Partial theme for creating custom themes.
+ */
+type PartialTheme = DeepPartial<Theme>;
+//#endregion
+//#region src/types/screen.types.d.ts
+interface ScreenProps {
+  /** Screen title/name displayed in header */
+  name: string;
+  /** Child log messages/file logs */
+  children: ReactNode;
+  /** Enable auto-scroll to bottom on new content */
+  stickyScroll?: boolean;
+  /** Show scroll position indicator */
+  showScrollIndicator?: boolean;
+  /** Screen header background color */
+  headerBackgroundColor?: string | RGBA;
+  /** Screen header text color */
+  headerTextColor?: string | RGBA;
+  /** Whether this screen is currently focused */
+  focused?: boolean;
+  /** Callback when screen is scrolled */
+  onScroll?: (scrollTop: number, scrollHeight: number) => void;
+}
+interface ScreenDefinition {
+  /** Unique screen identifier */
+  id: string;
+  /** Display name for sidebar */
+  name: string;
+  /** Optional icon/badge character */
+  icon?: string;
+  /** Unread/notification count */
+  badgeCount?: number;
+}
+interface ScreenManagerProps {
+  /** Screen definitions for the sidebar */
+  screens: ScreenDefinition[];
+  /** Currently active screen ID */
+  activeScreenId: string;
+  /** Callback when screen selection changes */
+  onScreenChange?: (screenId: string) => void;
+  /** Screen content - should be conditionally rendered based on activeScreenId */
+  children: ReactNode;
+  /** Force show/hide sidebar (overrides auto behavior) */
+  sidebarVisible?: boolean;
+  /** Callback when sidebar visibility changes */
+  onSidebarVisibilityChange?: (visible: boolean) => void;
+  /** Sidebar width (columns) */
+  sidebarWidth?: number;
+  /** Sidebar position */
+  sidebarPosition?: 'left' | 'right';
+  /** Key to toggle sidebar visibility */
+  toggleSidebarKey?: string;
+  /** Sidebar header title */
+  sidebarTitle?: string;
+}
+type FocusArea = 'sidebar' | 'content';
+interface LoggerContextValue {
+  /** Shared SyntaxStyle instance for code highlighting */
+  syntaxStyle?: SyntaxStyle;
+  /** Shared TreeSitterClient for parsing */
+  treeSitterClient?: TreeSitterClient;
+  /** Default colors for log levels (derived from theme for backwards compatibility) */
+  levelColors: LogLevelColorMap;
+  /** Current theme */
+  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;
+  sidebarPosition?: 'left' | 'right';
+  sidebarTitle?: string;
+  /** Auto close after all screens complete successfully (delay in ms, default 5000) */
+  autoClose?: boolean | number;
+  /** Theme to use for the TUI (theme object or preset name) */
+  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
+interface ChoiceOption {
+  label: string;
+  value: string;
+  /** If true, this option allows text input */
+  input?: boolean;
+}
+interface BasePromptData {
+  id: string;
+  timestamp: Date;
+  resolved: boolean;
+  /** Auto-resolve timeout in ms */
+  timeout?: number;
+  /** Timestamp when timeout started */
+  timeoutStarted?: number;
+}
+interface ChoicePromptData extends BasePromptData {
+  type: 'choice';
+  question: string;
+  choices: ChoiceOption[];
+  defaultChoice: string;
+  selectedIndex: number;
+  inputMode: boolean;
+  inputValue: string;
+  resolvedValue?: string;
+}
+interface ConfirmPromptData extends BasePromptData {
+  type: 'confirm';
+  question: string;
+  confirmText: string;
+  cancelText: string;
+  defaultValue: boolean;
+  selectedValue: boolean;
+  resolvedValue?: boolean;
+}
+interface InputPromptData extends BasePromptData {
+  type: 'input';
+  question: string;
+  placeholder: string;
+  defaultValue: string;
+  value: string;
+  resolvedValue?: string;
+}
+interface MultiChoicePromptData extends BasePromptData {
+  type: 'multiChoice';
+  question: string;
+  choices: ChoiceOption[];
+  selectedIndices: Set<number>;
+  focusedIndex: number;
+  minSelect: number;
+  maxSelect: number;
+  resolvedValues?: string[];
+}
+type PromptData = ChoicePromptData | ConfirmPromptData | InputPromptData | MultiChoicePromptData;
+interface ChoiceOptions {
+  question: string;
+  choices: ChoiceOption[];
+  defaultChoice?: string;
+  /** Auto-resolve with default after timeout (ms) */
+  timeout?: number;
+}
+interface ConfirmOptions {
+  question: string;
+  confirmText?: string;
+  cancelText?: string;
+  defaultValue?: boolean;
+  /** Auto-resolve with default after timeout (ms) */
+  timeout?: number;
+}
+interface InputOptions {
+  question: string;
+  placeholder?: string;
+  defaultValue?: string;
+  /** Auto-resolve with default after timeout (ms) */
+  timeout?: number;
+}
+interface MultiChoiceOptions {
+  question: string;
+  choices: ChoiceOption[];
+  defaultChoices?: string[];
+  minSelect?: number;
+  maxSelect?: number;
+  /** Auto-resolve with default after timeout (ms) */
+  timeout?: number;
+}
+//#endregion
+//#region src/types/keyboard.types.d.ts
+/**
+ * Key event from the terminal.
+ */
+interface KeyEvent {
+  name: string;
+  sequence?: string;
+  ctrl?: boolean;
+  meta?: boolean;
+  shift?: boolean;
+}
+/**
+ * Context available to keyboard handlers.
+ */
+interface KeyboardContext {
+  /** Has multiple screens (sidebar visible) */
+  hasSidebar: boolean;
+  /** Currently focused area */
+  focusArea: FocusArea;
+  /** Whether a prompt is active */
+  hasPrompt: boolean;
+  /** Whether prompt is in text input mode */
+  inInputMode: boolean;
+  /** Whether filter bar is visible */
+  isFilterActive: boolean;
+  /** Whether help overlay is visible */
+  isHelpVisible: boolean;
+}
+/**
+ * Handler function for a key binding.
+ * Return true to prevent further processing, false/void to continue.
+ */
+type KeyHandler = (key: KeyEvent, context: KeyboardContext) => boolean | void;
+/**
+ * Category for organizing bindings in help overlay.
+ */
+type KeyBindingCategory = 'general' | 'navigation' | 'screen' | 'prompt' | 'filter';
+/**
+ * Condition for when a binding is active.
+ */
+interface KeyBindingCondition {
+  hasPrompt?: boolean;
+  inInputMode?: boolean;
+  focusArea?: FocusArea;
+  isFilterActive?: boolean;
+  isHelpVisible?: boolean;
+  hasSidebar?: boolean;
+}
+/**
+ * A single key binding definition.
+ */
+interface KeyBinding {
+  /** Key name(s) that trigger this binding */
+  key: string | string[];
+  /** Require Ctrl modifier */
+  ctrl?: boolean;
+  /** Require Meta/Cmd modifier */
+  meta?: boolean;
+  /** Require Shift modifier (for capital letters) */
+  shift?: boolean;
+  /** Handler function */
+  handler: KeyHandler;
+  /** Description for help overlay */
+  description: string;
+  /** Category for grouping in help */
+  category: KeyBindingCategory;
+  /** Condition when this binding is active */
+  when?: KeyBindingCondition;
+  /** Priority (higher = checked first, default 0) */
+  priority?: number;
+}
+/**
+ * Configuration for the keyboard manager.
+ */
+interface KeyBindingsConfig {
+  /** Custom bindings (added to defaults) */
+  bindings?: KeyBinding[];
+  /** Override specific default bindings by key */
+  overrides?: Record<string, Partial<KeyBinding>>;
+  /** Disable specific keys */
+  disabled?: string[];
+}
+//#endregion
+//#region src/types/filter.types.d.ts
+/**
+ * Filter state for log filtering.
+ */
+interface FilterState {
+  /** Which log levels are enabled (shown) */
+  enabledLevels: Set<LogLevel>;
+  /** Text search query */
+  searchQuery: string;
+  /** Whether the filter bar is visible */
+  isVisible: boolean;
+  /** Which filter field is focused */
+  focusedField: 'search' | 'levels';
+}
+/**
+ * All log levels in order.
+ */
+declare const ALL_LOG_LEVELS: LogLevel[];
+/**
+ * Create a default filter state.
+ */
+declare function createDefaultFilterState(): FilterState;
+/**
+ * Check if any filtering is active.
+ */
+declare function hasActiveFilter(filter: FilterState): boolean;
+/**
+ * Level counts for display.
+ */
+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;
@@ -248,21 +965,6 @@ declare const PROMPT_COLORS: {
 };
 //#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.
  *
@@ -292,6 +994,11 @@ declare function resolveFiletype(filePath: string): string | undefined;
 declare function getFileName(filePath: string): string;
 //#endregion
 //#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)
  */
@@ -307,8 +1014,26 @@ declare function formatObject(obj: unknown, depth?: number, currentDepth?: numbe
  */
 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?;
@@ -317,7 +1042,6 @@ declare class ScreenInstance {
   private hidden;
   private messages;
   private manager;
-  private changeListeners;
   private printFn;
   private hasPrinted;
   private version;
@@ -345,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;
   /**
@@ -353,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;
   /**
@@ -456,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
    */
@@ -467,20 +1196,23 @@ declare class ScreenInstance {
 }
 //#endregion
 //#region src/services/screen_manager.d.ts
-declare class ScreenManagerInstance implements OnServiceDestroy {
+declare class ScreenManagerInstance extends EventEmitter<ScreenManagerEventMap> implements OnServiceDestroy {
   private screens;
   private screenOrder;
   private activeScreenId;
   private renderer;
   private root;
   private adapter;
-  private isBound;
-  private changeListeners;
+  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
    */
@@ -494,24 +1226,73 @@ declare class ScreenManagerInstance implements OnServiceDestroy {
    * 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
@@ -585,11 +1366,6 @@ declare class ScreenManagerInstance implements OnServiceDestroy {
    * Toggle focus between sidebar and content
    */
   toggleFocus(): void;
-  /**
-   * Register a change listener for re-renders
-   */
-  onChange(listener: () => void): () => void;
-  private notifyChange;
   private render;
 }
 //#endregion
@@ -623,6 +1399,33 @@ declare class PromptInstance {
   multiChoice(options: MultiChoiceOptions): Promise<string[]>;
 }
 //#endregion
+//#region src/services/readline_prompt.d.ts
+/**
+ * Readline-based prompt service for stdout mode.
+ * Provides basic interactive prompts when TUI adapter is not available.
+ */
+declare class ReadlinePromptService {
+  private rl;
+  private promptQueue;
+  private isProcessing;
+  private ensureInterface;
+  /**
+   * Handle a prompt interactively via readline.
+   * Prompts are queued and processed sequentially.
+   */
+  handlePrompt(prompt: PromptData): Promise<string | boolean | string[]>;
+  private processQueue;
+  private processPrompt;
+  private handleChoice;
+  private handleConfirm;
+  private handleInput;
+  private handleMultiChoice;
+  /**
+   * Cleanup readline interface
+   */
+  destroy(): void;
+}
+//#endregion
 //#region src/tokens/screen.d.ts
 declare const Screen: InjectionToken<ScreenInstance, zod_v40.ZodObject<{
   name: zod_v40.ZodString;
@@ -643,9 +1446,9 @@ declare const ScreenLogger: InjectionToken<ScreenLoggerInstance, zod_v40.ZodObje
   }, zod_v4_core0.$strip>, zod_v40.ZodString]>>>;
   context: zod_v40.ZodOptional<zod_v40.ZodString>;
   enabledLevels: zod_v40.ZodDefault<zod_v40.ZodArray<zod_v40.ZodEnum<{
-    log: "log";
     verbose: "verbose";
     debug: "debug";
+    log: "log";
     warn: "warn";
     error: "error";
     fatal: "fatal";
@@ -665,9 +1468,9 @@ declare const IsomorphicLogger: InjectionToken<IsomorphicLoggerInterface, zod_v4
   }, zod_v4_core0.$strip>, zod_v40.ZodString]>>>;
   context: zod_v40.ZodOptional<zod_v40.ZodString>;
   enabledLevels: zod_v40.ZodDefault<zod_v40.ZodArray<zod_v40.ZodEnum<{
-    log: "log";
     verbose: "verbose";
     debug: "debug";
+    log: "log";
     warn: "warn";
     error: "error";
     fatal: "fatal";
@@ -685,6 +1488,57 @@ declare const Prompt: InjectionToken<PromptInstance, zod_v40.ZodObject<{
   }, 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.
@@ -716,7 +1570,17 @@ declare class ScreenFactory {
 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;
 }
@@ -870,5 +1734,5 @@ declare class FilterEngine {
   static countByLevel(messages: MessageData[]): LevelCounts;
 }
 //#endregion
-export { ALL_LOG_LEVELS, Adapter, AdapterInterface, AdapterRenderProps, AdapterRoot, BaseMessage, BasePromptData, BindOptions, BindingHandlers, COMMON_FILETYPES, 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, MessageData, MessageType, MissingAdapterOverride, MultiChoiceOptions, MultiChoicePromptData, PROGRESS_COLORS, PROMPT_COLORS, PartialTheme, ProgressHandle, ProgressMessageData, ProgressTheme, PromiseOptions, Prompt, PromptData, PromptInstance, PromptOptions, PromptOptionsSchema, PromptTheme, SEPARATOR_COLORS, SIDEBAR_COLORS, STATUS_INDICATORS, Screen, ScreenDefinition, ScreenFactory, ScreenInstance, ScreenLogger, ScreenLoggerInstance, ScreenManager, ScreenManagerInstance, ScreenManagerProps, ScreenOptions, ScreenOptionsSchema, ScreenProps, ScreenStatus, SemanticColors, SeparatorTheme, SidebarTheme, StatusIndicator, StatusIndicatorsTheme, TABLE_COLORS, TableMessageData, 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 };
+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