tui-lipan 0.1.0

Opinionated, component-based TUI framework for Rust - declarative components, reconciliation, layout engine, focus, overlays, and rich widgets on top of ratatui.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

use std::rc::Rc;
use std::sync::Arc;

use crate::callback::Callback;
use crate::core::element::Key;
use crate::core::node::WidgetNode;
use crate::style::{Rect, RichText, Style, StyleSlot};
use crate::widgets::internal::StackProps;
use crate::widgets::{TabVariant, TabsEvent};

#[derive(Clone, Debug)]
pub struct StackLayoutCache {
    pub bounds: Rect,
    pub layout_hash: u64,
    pub child_rects: Rc<Vec<Rect>>,
}

/// Node for VStack and HStack.
#[derive(Clone)]
pub struct StackNode {
    pub props: StackProps,
    pub tab_titles: Vec<RichText>,
    pub active_tab: usize,
    pub on_tab_change: Option<Callback<TabsEvent>>,
    pub active_tab_style: StyleSlot,
    pub inactive_tab_style: Style,
    pub tab_variant: TabVariant,
    pub title_prefix: Option<Arc<str>>,
    pub layout_cache: Option<StackLayoutCache>,
    /// Key of the last child that held real focus within this stack.
    /// Persists across frames; drives sticky accordion expansion automatically.
    pub last_focused_key: Option<Key>,
}

impl WidgetNode for StackNode {
    fn has_on_click(&self) -> bool {
        self.on_tab_change.is_some()
    }

    fn hit_test_refinement(&self, _x: i16, y: i16, rect: Rect) -> Option<bool> {
        if self.on_tab_change.is_some() {
            // Tabs are always on the top row (y == rect.y)
            if y != rect.y {
                return Some(false);
            }
        }
        None
    }
}