bernardo-tui 0.2.7

A keyboard-only, distraction-free TUI widget library
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

use crate::experiments::screenspace::Screenspace;
use crate::layout::widget_with_rect::WidgetWithRect;
use crate::primitives::xy::XY;
use crate::widget::widget::Widget;

pub type WidgetGetter<T> = Box<dyn Fn(&'_ T) -> &'_ dyn Widget>;
pub type WidgetGetterMut<T> = Box<dyn Fn(&'_ mut T) -> &'_ mut dyn Widget>;

/* TODO I want to get to the point where all layout is generated from macros, and then
depending on whether root is mut or not, we get mut layout or not-mut layout. */

pub type WidgetOpGetter<T> = Box<dyn Fn(&'_ T) -> Option<&'_ dyn Widget>>;
pub type WidgetOpGetterMut<T> = Box<dyn Fn(&'_ mut T) -> Option<&'_ mut dyn Widget>>;

pub struct LayoutResult<W: Widget> {
    pub wwrs: Vec<WidgetWithRect<W>>,
    pub total_size: XY,
}

impl<W: Widget> LayoutResult<W> {
    pub fn new(wwrs: Vec<WidgetWithRect<W>>, total_size: XY) -> LayoutResult<W> {
        for w in wwrs.iter() {
            debug_assert!(total_size >= w.rect().lower_right());
        }

        LayoutResult { wwrs, total_size }
    }
}

/*
Layout will SKIP a widget, if it's widget.id() == root.id(), that's due to a crazy edge case in complex widget.
*/
pub trait Layout<W: Widget> {
    fn prelayout(&self, root: &mut W);

    fn exact_size(&self, root: &W, output_size: XY) -> XY;

    fn layout(&self, root: &mut W, screenspace: Screenspace) -> LayoutResult<W>;

    fn boxed(self) -> Box<dyn Layout<W>>
    where
        Self: Sized,
        Self: 'static,
    {
        Box::new(self)
    }
}