freya-components 0.4.0-rc.17

Components for Freya apps
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

use freya_core::{
    prelude::{
        Readable,
        State,
        provide_context,
        provide_context_for_scope_id,
        try_consume_context,
        use_consume,
        use_hook,
    },
    scope_id::ScopeId,
};

use crate::theming::component_themes::Theme;

/// Provides a custom [`Theme`].
/// If a [`Theme`] context already exists, it reuses it instead of creating a new one.
pub fn use_init_theme(theme_cb: impl FnOnce() -> Theme) -> State<Theme> {
    use_hook(|| {
        if let Some(existing) = try_consume_context::<State<Theme>>() {
            existing
        } else {
            let state = State::create(theme_cb());
            provide_context(state);
            state
        }
    })
}

/// Provides a custom [`Theme`] at the root scope.
/// If a [`Theme`] context already exists at the root, it reuses it instead of creating a new one.
pub fn use_init_root_theme(theme_cb: impl FnOnce() -> Theme) -> State<Theme> {
    use_hook(|| {
        if let Some(existing) = try_consume_context::<State<Theme>>() {
            existing
        } else {
            let state = State::create_in_scope(theme_cb(), ScopeId::ROOT);
            provide_context_for_scope_id(state, ScopeId::ROOT);
            state
        }
    })
}

/// Subscribe to [`Theme`] changes.
pub fn use_theme() -> State<Theme> {
    use_consume::<State<Theme>>()
}

/// Subscribe to [`Theme`] changes, default theme will be used if there is no provided [`Theme`].
///
/// Primarily used by built-in components that have no control of whether they will inherit a [`Theme`] or not.
pub fn get_theme_or_default() -> Readable<Theme> {
    try_consume_context::<State<Theme>>()
        .map(|v| v.into())
        .unwrap_or_else(|| Theme::default().into())
}

/// Indicates what type of surface to use.
#[derive(Clone, Copy, PartialEq, Debug, Default)]
pub enum SurfaceThemeIndicator {
    #[default]
    Primary,
    Opposite,
}

/// Provide a [SurfaceThemeIndicator] down to the components.
pub fn use_init_surface_theme_indicator(theme: impl FnOnce() -> SurfaceThemeIndicator) {
    use_hook(|| provide_context(theme()))
}

/// Get the inherited [SurfaceThemeIndicator].
pub fn use_surface_theme_indicator() -> SurfaceThemeIndicator {
    use_hook(|| try_consume_context().unwrap_or_default())
}