@navios/commander-tui 1.0.0

package/lib/index.d.cts

@@ -0,0 +1,1720 @@
+import { ClassTypeWithInstance, FactoryContext, InjectionToken, LogLevel, LoggerService } from "@navios/core";
+import { RGBA, SyntaxStyle, TreeSitterClient } from "@opentui/core";
+import * as react0 from "react";
+import { ReactNode } from "react";
+import * as zod_v418 from "zod/v4";
+import { z } from "zod/v4";
+import * as zod_v4_core1 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;
+}
+/**
+ * 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';
+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: false) */
+  useMouse?: boolean;
+}
+//#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/components/log/log_message.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): react0.ReactNode;
+//#endregion
+//#region src/components/file/file_log.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
+ *
+ * @example Full file
+ * <FileLog
+ *   mode="full"
+ *   filePath="src/index.ts"
+ *   content={fileContent}
+ * />
+ *
+ * @example Diff
+ * <FileLog
+ *   mode="diff"
+ *   filePath="src/api.ts"
+ *   diff={unifiedDiff}
+ *   view="unified"
+ * />
+ *
+ * @example Partial with error
+ * <FileLog
+ *   mode="partial"
+ *   filePath="src/utils.ts"
+ *   content={excerpt}
+ *   startLine={42}
+ *   errorLines={[45, 46]}
+ * />
+ */
+declare function FileLog(props: FileLogProps): react0.ReactNode;
+//#endregion
+//#region src/components/prompt/prompt_renderer.d.ts
+interface PromptRendererProps {
+  prompt: PromptData;
+}
+declare function PromptRenderer({
+  prompt
+}: PromptRendererProps): react0.ReactNode;
+//#endregion
+//#region src/schemas/screen-options.d.ts
+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>>;
+}, z.core.$strip>;
+type ScreenOptions = z.infer<typeof ScreenOptionsSchema>;
+//#endregion
+//#region src/schemas/logger-options.d.ts
+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>>;
+  }, 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>;
+type LoggerOptions = z.infer<typeof LoggerOptionsSchema>;
+//#endregion
+//#region src/schemas/prompt-options.d.ts
+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>>;
+  }, z.core.$strip>, z.ZodString]>>>;
+}, z.core.$strip>;
+type PromptOptions = z.infer<typeof PromptOptionsSchema>;
+//#endregion
+//#region src/services/screen.d.ts
+declare class ScreenInstance {
+  private id;
+  private name;
+  private icon?;
+  private badgeCount;
+  private status;
+  private hidden;
+  private messages;
+  private manager;
+  private changeListeners;
+  private printFn;
+  private hasPrinted;
+  private version;
+  private promptQueue;
+  private activePrompt;
+  constructor(id: string, options: ScreenOptions);
+  incrementVersion(): void;
+  getVersion(): number;
+  /**
+   * Internal: Set the manager reference
+   */
+  _setManager(manager: ScreenManager): void;
+  /**
+   * Internal: Set the print function for stdout output
+   */
+  _setPrintFn(fn: (messages: MessageData[], name: string, isError: boolean) => void): void;
+  getId(): string;
+  getName(): string;
+  getIcon(): string | undefined;
+  getBadgeCount(): number;
+  setBadgeCount(count: number): this;
+  isHidden(): boolean;
+  setHidden(hidden: boolean): this;
+  show(): this;
+  hide(): this;
+  getStatus(): ScreenStatus;
+  /**
+   * Set screen status. When success/fail and TUI is not bound, prints to stdout/stderr
+   */
+  setStatus(status: ScreenStatus): this;
+  /**
+   * Check if this screen is complete (success or fail)
+   */
+  isComplete(): boolean;
+  /**
+   * Check if this screen has been printed to console
+   */
+  hasPrintedToConsole(): boolean;
+  /**
+   * Force print to console (called when TUI unbinds)
+   */
+  _flushToConsole(force?: boolean): void;
+  /**
+   * Get all messages for rendering
+   */
+  getMessages(): MessageData[];
+  /**
+   * Add a message to the screen (internal use by Logger)
+   */
+  addMessage(message: MessageData): void;
+  /**
+   * Update a loading message (internal use by Logger)
+   */
+  updateMessage(id: string, updates: Partial<LoadingMessageData>): void;
+  /**
+   * Update a progress message (internal use by Logger)
+   */
+  updateProgressMessage(id: string, updates: Partial<ProgressMessageData>): void;
+  /**
+   * Clear all messages
+   */
+  clear(): this;
+  /**
+   * Add a prompt to the queue (internal use by Prompt class)
+   * Returns a promise that resolves when the user responds
+   */
+  _addPrompt(prompt: PromptData): Promise<string | boolean | string[]>;
+  /**
+   * Resolve a prompt with its default value
+   */
+  private resolvePromptWithDefault;
+  /**
+   * Get the currently active prompt (for rendering)
+   */
+  getActivePrompt(): PromptData | null;
+  /**
+   * Check if this screen has an active prompt
+   */
+  hasActivePrompt(): boolean;
+  /**
+   * Update prompt selection (for keyboard navigation)
+   */
+  updatePromptSelection(index: number): void;
+  /**
+   * Navigate prompt selection up
+   */
+  promptNavigateUp(): void;
+  /**
+   * Navigate prompt selection down
+   */
+  promptNavigateDown(): void;
+  /**
+   * Toggle left/right for confirm prompts
+   */
+  promptNavigateLeft(): void;
+  promptNavigateRight(): void;
+  /**
+   * Toggle selection for multiChoice prompts
+   */
+  promptToggleSelection(): void;
+  /**
+   * Enter input mode for choice prompts (if current selection allows input)
+   * or for input prompts (always)
+   */
+  promptEnterInputMode(): boolean;
+  /**
+   * Exit input mode for choice prompts
+   */
+  promptExitInputMode(): void;
+  /**
+   * Check if prompt is in input mode
+   */
+  isPromptInInputMode(): boolean;
+  /**
+   * Update input value for choice prompts
+   */
+  promptUpdateInput(value: string): void;
+  /**
+   * Append character to input
+   */
+  promptAppendInput(char: string): void;
+  /**
+   * Delete last character from input
+   */
+  promptDeleteLastChar(): void;
+  /**
+   * Check if multiChoice prompt can be submitted (meets minSelect requirement)
+   */
+  canSubmitPrompt(): boolean;
+  /**
+   * Submit the current prompt selection
+   */
+  promptSubmit(): void;
+  /**
+   * Activate the next prompt in the queue
+   */
+  private activateNextPrompt;
+  /**
+   * Register a change listener for re-renders
+   */
+  onChange(listener: () => void): () => void;
+  private notifyChange;
+  /**
+   * Print all messages to stdout/stderr with ANSI colors
+   */
+  private printToConsole;
+}
+//#endregion
+//#region src/services/screen_manager.d.ts
+declare class ScreenManager {
+  private screens;
+  private screenOrder;
+  private activeScreenId;
+  private renderer;
+  private root;
+  private isBound;
+  private changeListeners;
+  private bindOptions;
+  private autoCloseTimer;
+  private theme;
+  focusArea: FocusArea;
+  selectedIndex: number;
+  /**
+   * Create a new screen and return it
+   */
+  createScreen(options: ScreenOptions): ScreenInstance;
+  getScreenByName(name: string): ScreenInstance | undefined;
+  /**
+   * Remove a screen dynamically
+   */
+  removeScreen(screen: ScreenInstance): void;
+  /**
+   * Non-blocking bind - starts TUI rendering in background
+   */
+  bind(options?: BindOptions): Promise<void>;
+  /**
+   * Get the configured theme
+   */
+  getTheme(): Theme | undefined;
+  /**
+   * Stop TUI rendering and cleanup
+   * Flushes all completed screens to stdout/stderr
+   */
+  unbind(): void;
+  /**
+   * Print all completed screens that haven't been printed yet
+   */
+  private flushCompletedScreens;
+  /**
+   * Check if TUI is currently bound
+   */
+  isTuiBound(): boolean;
+  /**
+   * Called by Screen when a prompt becomes active
+   * Focuses the screen and switches to content area
+   */
+  onScreenPromptActivated(screen: ScreenInstance): void;
+  /**
+   * Check if any screen has an active prompt
+   */
+  hasActivePrompt(): boolean;
+  /**
+   * Get the screen with an active prompt (if any)
+   */
+  getScreenWithActivePrompt(): ScreenInstance | null;
+  /**
+   * Called by Screen when visibility changes
+   * Handles switching active screen if needed
+   */
+  onScreenVisibilityChanged(screen: ScreenInstance): void;
+  /**
+   * Called by Screen when status becomes success/fail
+   * Moves completed screens to end of sidebar list
+   */
+  onScreenCompleted(screen: ScreenInstance): void;
+  /**
+   * Check if all screens are successful and start auto-close timer if enabled
+   */
+  private checkAutoClose;
+  /**
+   * Get visible screens in display order (excludes hidden screens)
+   */
+  getScreens(): ScreenInstance[];
+  /**
+   * Get all screens in display order (includes hidden screens)
+   */
+  getAllScreens(): ScreenInstance[];
+  /**
+   * Get the active screen
+   */
+  getActiveScreen(): ScreenInstance | null;
+  /**
+   * Set the active screen
+   */
+  setActiveScreen(screen: ScreenInstance): void;
+  /**
+   * Get bind options
+   */
+  getBindOptions(): BindOptions;
+  /**
+   * Set focus area (sidebar or content)
+   */
+  setFocusArea(area: FocusArea): void;
+  /**
+   * Set selected index in sidebar
+   */
+  setSelectedIndex(index: number): void;
+  /**
+   * Navigate sidebar up
+   */
+  navigateUp(): void;
+  /**
+   * Navigate sidebar down
+   */
+  navigateDown(): void;
+  /**
+   * Select the currently highlighted screen
+   */
+  selectCurrent(): void;
+  /**
+   * Toggle focus between sidebar and content
+   */
+  toggleFocus(): void;
+  /**
+   * Register a change listener for re-renders
+   */
+  onChange(listener: () => void): () => void;
+  private notifyChange;
+  private render;
+}
+//#endregion
+//#region src/services/logger.d.ts
+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;
+}
+//#endregion
+//#region src/services/prompt.d.ts
+/**
+ * Prompt class for interactive user input.
+ * Similar to Logger, but for prompts that require user interaction.
+ */
+declare class PromptInstance {
+  private screen;
+  constructor(options: PromptOptions);
+  /**
+   * Display a choice prompt and wait for user selection.
+   * Returns the selected value (or input text if an input option was selected).
+   */
+  choice(options: ChoiceOptions): Promise<string>;
+  /**
+   * Display a confirmation prompt and wait for user response.
+   * Returns true for confirm, false for cancel.
+   */
+  confirm(options: ConfirmOptions): Promise<boolean>;
+  /**
+   * Display a text input prompt and wait for user input.
+   * Returns the entered text.
+   */
+  input(options: InputOptions): Promise<string>;
+  /**
+   * Display a multi-select choice prompt.
+   * Returns an array of selected values.
+   */
+  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): react0.ReactNode;
+//#endregion
+//#region src/components/screen/message_renderer.d.ts
+interface MessageRendererProps {
+  message: MessageData;
+}
+declare function MessageRenderer({
+  message
+}: MessageRendererProps): react0.ReactNode;
+//#endregion
+//#region src/components/screen/loading_message.d.ts
+interface LoadingMessageProps {
+  message: LoadingMessageData;
+}
+declare function LoadingMessage({
+  message
+}: LoadingMessageProps): react0.ReactNode;
+//#endregion
+//#region src/components/screen/progress_message.d.ts
+interface ProgressMessageProps {
+  message: ProgressMessageData;
+}
+declare function ProgressMessage({
+  message
+}: ProgressMessageProps): react0.ReactNode;
+//#endregion
+//#region src/components/screen/group_renderer.d.ts
+interface GroupRendererProps {
+  label: string;
+  messages: MessageData[];
+}
+declare function GroupRenderer({
+  label,
+  messages
+}: GroupRendererProps): react0.ReactNode;
+interface GroupMessageRendererProps {
+  message: GroupMessageData;
+}
+/**
+ * Fallback renderer for group markers (when not processed at higher level)
+ */
+declare function GroupMessageRenderer({
+  message
+}: GroupMessageRendererProps): react0.ReactNode;
+//#endregion
+//#region src/components/screen/table_message.d.ts
+interface TableMessageProps {
+  message: TableMessageData;
+}
+declare function TableMessage({
+  message
+}: TableMessageProps): react0.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): react0.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): react0.ReactNode;
+//#endregion
+//#region src/components/sidebar/sidebar_separator.d.ts
+declare function SidebarSeparator(): react0.ReactNode;
+//#endregion
+//#region src/components/screen_manager_bridge.d.ts
+interface ScreenManagerBridgeProps {
+  manager: ScreenManager;
+  theme?: Theme;
+}
+declare function ScreenManagerBridge({
+  manager,
+  theme
+}: ScreenManagerBridgeProps): react0.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;
+  /**
+   * Theme configuration.
+   * Can be a preset name ("dark", "light", "high-contrast") or a Theme object.
+   * @default "dark"
+   */
+  theme?: Theme | ThemePreset;
+  /**
+   * @deprecated Use `theme` instead. Custom log level colors.
+   * If both `theme` and `levelColors` are provided, `levelColors` takes precedence.
+   */
+  levelColors?: Partial<LogLevelColorMap>;
+}
+/**
+ * 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(): string;
+//#endregion
+//#region src/tokens/screen.d.ts
+declare const Screen: InjectionToken<ScreenInstance, zod_v418.ZodObject<{
+  name: zod_v418.ZodString;
+  icon: zod_v418.ZodOptional<zod_v418.ZodString>;
+  badgeCount: zod_v418.ZodOptional<zod_v418.ZodNumber>;
+  hidden: zod_v418.ZodDefault<zod_v418.ZodOptional<zod_v418.ZodBoolean>>;
+}, zod_v4_core1.$strip>, true>;
+//#endregion
+//#region src/tokens/logger.d.ts
+declare const ScreenLogger: InjectionToken<ScreenLoggerInstance, zod_v418.ZodObject<{
+  screen: zod_v418.ZodDefault<zod_v418.ZodOptional<zod_v418.ZodUnion<[zod_v418.ZodObject<{
+    name: zod_v418.ZodString;
+    icon: zod_v418.ZodOptional<zod_v418.ZodString>;
+    badgeCount: zod_v418.ZodOptional<zod_v418.ZodNumber>;
+    hidden: zod_v418.ZodDefault<zod_v418.ZodOptional<zod_v418.ZodBoolean>>;
+  }, zod_v4_core1.$strip>, zod_v418.ZodString]>>>;
+  context: zod_v418.ZodOptional<zod_v418.ZodString>;
+  enabledLevels: zod_v418.ZodDefault<zod_v418.ZodArray<zod_v418.ZodEnum<{
+    verbose: "verbose";
+    debug: "debug";
+    log: "log";
+    warn: "warn";
+    error: "error";
+    fatal: "fatal";
+  }>>>;
+}, zod_v4_core1.$strip>, true>;
+//#endregion
+//#region src/tokens/prompt.d.ts
+declare const Prompt: InjectionToken<PromptInstance, zod_v418.ZodObject<{
+  screen: zod_v418.ZodDefault<zod_v418.ZodOptional<zod_v418.ZodUnion<[zod_v418.ZodObject<{
+    name: zod_v418.ZodString;
+    icon: zod_v418.ZodOptional<zod_v418.ZodString>;
+    badgeCount: zod_v418.ZodOptional<zod_v418.ZodNumber>;
+    hidden: zod_v418.ZodDefault<zod_v418.ZodOptional<zod_v418.ZodBoolean>>;
+  }, zod_v4_core1.$strip>, zod_v418.ZodString]>>>;
+}, zod_v4_core1.$strip>, true>;
+//#endregion
+//#region src/factories/screen.factory.d.ts
+declare class ScreenFactory {
+  private readonly screenManager;
+  create(ctx: FactoryContext, options: ScreenOptions): ScreenInstance;
+}
+//#endregion
+//#region src/overrides/console.logger.override.d.ts
+declare function overrideConsoleLogger(hidden?: boolean): ClassTypeWithInstance<LoggerService>;
+//#endregion
+//#region src/themes/dark.d.ts
+/**
+ * Default dark theme.
+ * Migrated from the scattered color files in utils/colors/.
+ */
+declare const darkTheme: Theme;
+//#endregion
+//#region src/themes/light.d.ts
+/**
+ * Light theme for terminals with light backgrounds.
+ */
+declare const lightTheme: Theme;
+//#endregion
+//#region src/themes/high-contrast.d.ts
+/**
+ * High contrast theme for accessibility.
+ * Uses pure black/white with saturated colors for maximum visibility.
+ */
+declare const highContrastTheme: Theme;
+//#endregion
+//#region src/themes/utils.d.ts
+/**
+ * Get a theme by preset name.
+ */
+declare function getThemePreset(preset: ThemePreset): Theme;
+/**
+ * Merge a base theme with partial overrides.
+ */
+declare function mergeThemes(base: Theme, overrides: PartialTheme): Theme;
+/**
+ * Create a custom theme by extending the dark theme with overrides.
+ */
+declare function createTheme(overrides: PartialTheme): Theme;
+/**
+ * Create a custom theme by extending a specific base theme.
+ */
+declare function createThemeFrom(base: Theme | ThemePreset, overrides: PartialTheme): Theme;
+/**
+ * Resolve a theme value which can be a Theme object or a preset name.
+ */
+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.
+ */
+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.
+ */
+declare function formatKeyBinding(binding: KeyBinding): string;
+//#endregion
+//#region src/keyboard/create_bindings.d.ts
+/**
+ * Interface for binding handlers that need manager/screen access.
+ */
+interface BindingHandlers {
+  manager: ScreenManager;
+  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.
+ */
+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.
+ */
+declare function handlePrintableInput(key: KeyEvent, context: KeyboardContext, handlers: BindingHandlers): boolean;
+//#endregion
+//#region src/filter/filter_engine.d.ts
+/**
+ * Filter engine for filtering log messages.
+ */
+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;
+}
+//#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, 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, 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 };
+//# sourceMappingURL=index.d.cts.map