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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

use std::any::TypeId;
use std::rc::Rc;

use super::any_props::AnyProps;
use super::erased::{ComponentFactory, ComponentMount, Mounted};
use crate::core::component::{Component, Context};
use crate::core::element::Key;
use crate::style::Rect;

/// A nested component element (type-erased).
#[derive(Clone)]
pub(crate) struct ComponentElement {
    pub(crate) type_id: TypeId,
    pub(crate) factory: ComponentFactory,
    pub(crate) props: AnyProps,
    /// Path-independent persistence key. When set, the component's instance is
    /// looked up in a registry-global index before falling back to the usual
    /// path-based reuse, so its state survives ancestor reshaping.
    pub(crate) state_key: Option<Key>,
}

impl ComponentElement {
    pub(crate) fn new<C, F>(factory: F, props: C::Properties) -> Self
    where
        C: Component,
        F: Fn() -> C + 'static,
    {
        let type_id = TypeId::of::<C>();

        let factory: ComponentFactory = Rc::new(move |mount: ComponentMount| {
            let component = factory();

            let expected = std::any::type_name::<C::Properties>();
            let actual = mount.props.type_name();
            let component_name = std::any::type_name::<C>();

            let props: C::Properties =
                mount.props.into_typed::<C::Properties>().ok_or_else(|| {
                    crate::Error::PropsTypeMismatch {
                        component: component_name,
                        expected,
                        actual,
                    }
                })?;

            let ctx = Context::new(
                &component,
                mount.scope,
                mount.dispatcher,
                props,
                mount.env,
                Rect::default(),
            );

            Ok(Box::new(Mounted { component, ctx }))
        });

        Self {
            type_id,
            factory,
            props: AnyProps::new(props),
            state_key: None,
        }
    }
}