guise-ui 1.5.0

A component library for gpui, Zed's GPU-accelerated UI framework: a themed palette, sizing tokens, 130+ composable components, a reactive state layer, and an in-app Safari-style inspector.
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
103
104
105
106
107
108

//! `Container` — a max-width centered column on the `xs..xl` 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::devtools::Probed;
use crate::theme::{theme, Size};

/// Max content width (px) for each [`Size`].
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.
#[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),
            )
            .probe("Container")
    }
}

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

    #[test]
    fn widths_follow_the_size_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);
    }
}