Codewhale Ratatui

Add the library to your Cargo.toml. Use your existing backend, or enable Crossterm for a new app.

[dependencies]
codewhale-ratatui = { git = "https://github.com/codewhale-hq/codewhale-ratatui", rev = "4d5b05ba0709eb850e7415929b51c4db083d1241" }
ratatui = { version = "0.30.2", default-features = false, features = ["std", "crossterm_0_29"] }
crossterm = "0.29"

Detect the theme once when your app starts, then pass it to your draw function. Theme::detect().tui() selects the native terminal palette.

let theme = codewhale_ratatui::Theme::detect().tui();

pub fn draw_composer(
    area: ratatui::layout::Rect,
    buffer: &mut ratatui::buffer::Buffer,
    theme: &codewhale_ratatui::Theme,
    draft: &codewhale_ratatui::TextInputState,
) -> Option<ratatui::layout::Position> {
    use codewhale_ratatui::{NativeComposer, Paint};
    let area = area.intersection(buffer.area);
    if area.is_empty() {
        return None;
    }
    let composer = NativeComposer::new(draft.text())
        .focused(true)
        .cursor(draft.cursor())
        .can_submit(!draft.is_empty())
        .placeholder("Type a line, then press Enter");
    let height = composer.desired_height(area.width, area.height);
    let slot = ratatui::layout::Rect::new(area.x, area.bottom() - height, area.width, height);
    composer.paint(slot, buffer, theme);
    composer.cursor_position(slot)
}

Keep the state

Your app stores drafts, selection, work and a persistent whale Stage.

Render the view

Components paint the facts you supply into your Ratatui frame.

Handle the action

Route input outcomes to your app. Supply elapsed time when motion needs a redraw.