Celina - A CLI library for Nim inspired by Ratatui.

A powerful Terminal User Interface library for Nim, inspired by Ratatui. Provides high-performance, type-safe components for building interactive terminal applications with both synchronous and asynchronous support.

Basic Usage:

import pkg/celina

proc main() =
  var app = newApp()
  app.run()

Async Usage (requires -d:asyncBackend=asyncdispatch or -d:asyncBackend=chronos):

import pkg/celina

proc main() {.async.} =
  var app = newAsyncApp()
  await app.runAsync()

Modules

Core

• app — Application lifecycle and event loop
• buffer — Screen buffer for managing terminal content
• colors — Color and style definitions
• cursor — Cursor control and state management
• errors — Error types
• events — Keyboard and mouse event handling
• fps — Frame rate monitoring
• geometry — Geometric types for positioning and sizing
• layout — Constraint-based layout system
• renderer — Differential rendering and terminal output
• resources — Resource management and RAII patterns
• terminal — Terminal control using ANSI escape sequences
• terminal_common — Shared terminal algorithms and utilities
• windows — Window management with overlapping and focus support

Async

• async_backend — Async backend configuration (asyncdispatch/chronos)
• async_app — Async application framework and event loop
• async_buffer — Async-safe buffer implementation
• async_events — Async keyboard and mouse event handling
• async_terminal — Async terminal I/O interface

Widgets

• base — Base widget traits and types
• button — Interactive button widget
• input — Text input widget with cursor and selection
• list — List widget with scrolling and selection
• progress — Progress bar widget
• table — Table widget for structured data
• tabs — Tabbed interface widget
• text — Text rendering widget with alignment and styling