guise-ui 0.4.1

A Mantine-inspired component library for gpui, Zed's GPU-accelerated UI framework.
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! `Container` — a max-width centered column, matching Mantine's container
//! size scale.
//!
//! Not to be confused with [`crate::flex::Container`], the Flutter-style
//! pixel box (which is why `flex` is not glob-exported).
//!
//! ```ignore
//! use guise::prelude::*;
//!
//! Container::new()
//!     .size(Size::Sm)
//!     .padding(Size::Md)
//!     .child(Title::new("Article").order(2))
//!     .child(Text::new("Readable line lengths on any window width."))
//! ```

use gpui::prelude::*;
use gpui::{div, px, AnyElement, App, IntoElement, Window};

use crate::theme::{theme, Size};

/// Max content width (px) for each [`Size`] — Mantine's container scale.
fn max_width(size: Size) -> f32 {
    match size {
        Size::Xs => 540.0,
        Size::Sm => 720.0,
        Size::Md => 960.0,
        Size::Lg => 1140.0,
        Size::Xl => 1320.0,
    }
}

/// A centered column with a capped width. The Mantine `Container`.
#[derive(IntoElement)]
pub struct Container {
    size: Size,
    padding: Size,
    children: Vec<AnyElement>,
}

impl Container {
    pub fn new() -> Self {
        Container {
            size: Size::Md,
            padding: Size::Md,
            children: Vec::new(),
        }
    }

    /// Max content width: `Xs..Xl` map to 540 / 720 / 960 / 1140 / 1320 px.
    pub fn size(mut self, size: Size) -> Self {
        self.size = size;
        self
    }

    /// Horizontal padding inside the capped column (theme spacing scale).
    pub fn padding(mut self, padding: Size) -> Self {
        self.padding = padding;
        self
    }
}

impl Default for Container {
    fn default() -> Self {
        Container::new()
    }
}

impl ParentElement for Container {
    fn extend(&mut self, elements: impl IntoIterator<Item = AnyElement>) {
        self.children.extend(elements);
    }
}

impl RenderOnce for Container {
    fn render(self, _window: &mut Window, cx: &mut App) -> impl IntoElement {
        let pad = theme(cx).spacing(self.padding);
        div().w_full().flex().flex_col().items_center().child(
            div()
                .w_full()
                .max_w(px(max_width(self.size)))
                .px(px(pad))
                .flex()
                .flex_col()
                .children(self.children),
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn widths_match_mantine_scale() {
        assert_eq!(max_width(Size::Xs), 540.0);
        assert_eq!(max_width(Size::Sm), 720.0);
        assert_eq!(max_width(Size::Md), 960.0);
        assert_eq!(max_width(Size::Lg), 1140.0);
        assert_eq!(max_width(Size::Xl), 1320.0);
    }
}