ratzgo 0.2.0

Composable, async-first, elm-like ratatui framework
Documentation
use ratatui_core::{
    buffer::Buffer,
    layout::{Position, Rect},
};
use ratatui_crossterm::crossterm::event::KeyEvent;

use crate::component::{FilterKey, MapMessage};

pub trait Component<Message>: std::fmt::Debug {
    fn activity(&self) -> bool;

    fn area(&self) -> Rect;

    fn set_area(&mut self, area: Rect);

    #[expect(unused)]
    fn handle_key(&mut self, key: &KeyEvent) -> Option<Message> {
        None
    }

    #[expect(unused)]
    fn handle_click(&mut self, pos: Position) -> Option<Message> {
        None
    }

    #[expect(unused)]
    fn handle_paste(&mut self, content: &str) -> Option<Message> {
        None
    }

    fn adapt(&mut self, buf: &mut Buffer);

    fn render(&mut self, area: Rect, buf: &mut Buffer) {
        self.set_area(area);
        self.adapt(buf);
    }
}

pub trait ComponentExt<Message>: Component<Message> {
    fn boxed<'a>(self) -> Box<dyn Component<Message> + 'a>
    where
        Self: Sized + 'a,
    {
        Box::new(self)
    }

    fn map<'a, O, F>(self, f: F) -> MapMessage<'a, Message, O, Self>
    where
        F: Fn(Message) -> O + 'a,
        Self: Sized + 'a,
    {
        MapMessage::new(self, f)
    }

    fn filter_key<'a>(self, filter: impl Fn(&KeyEvent) -> bool + 'a) -> FilterKey<'a, Message, Self>
    where
        Self: Sized + 'a,
    {
        FilterKey::new(self, filter)
    }
}

impl<Message, T> ComponentExt<Message> for T where T: Component<Message> {}

impl<Message, T> Component<Message> for Box<T>
where
    T: Component<Message> + ?Sized,
{
    fn activity(&self) -> bool {
        self.as_ref().activity()
    }

    fn area(&self) -> Rect {
        self.as_ref().area()
    }

    fn set_area(&mut self, area: Rect) {
        self.as_mut().set_area(area);
    }

    fn handle_key(&mut self, key: &KeyEvent) -> Option<Message> {
        self.as_mut().handle_key(key)
    }

    fn handle_click(&mut self, pos: Position) -> Option<Message> {
        self.as_mut().handle_click(pos)
    }

    fn handle_paste(&mut self, content: &str) -> Option<Message> {
        self.as_mut().handle_paste(content)
    }

    fn adapt(&mut self, buf: &mut Buffer) {
        self.as_mut().adapt(buf);
    }
}