guise-ui 0.2.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

//! `Signal` — an observable state cell backed by a gpui entity.

use gpui::{App, AppContext, Entity};

/// A clonable handle to a piece of reactive state. React's `useState` value:
/// reading is cheap, writing notifies every observer (see [`super::watch`]).
///
/// All clones share one backing entity, so passing a `Signal` around — or
/// providing it as context — gives every holder the same live value.
pub struct Signal<T> {
    entity: Entity<T>,
}

impl<T: 'static> Signal<T> {
    /// Create a new signal holding `value`.
    pub fn new(cx: &mut App, value: T) -> Self {
        Signal {
            entity: cx.new(|_cx| value),
        }
    }

    /// The backing entity — pass to `cx.observe(...)` or [`super::watch`].
    pub fn entity(&self) -> &Entity<T> {
        &self.entity
    }

    /// Borrow the current value.
    pub fn read<'a>(&self, cx: &'a App) -> &'a T {
        self.entity.read(cx)
    }

    /// Clone out the current value.
    pub fn get(&self, cx: &App) -> T
    where
        T: Clone,
    {
        self.entity.read(cx).clone()
    }

    /// Replace the value and notify observers.
    pub fn set(&self, cx: &mut App, value: T) {
        self.entity.update(cx, |slot, cx| {
            *slot = value;
            cx.notify();
        });
    }

    /// Mutate the value in place and notify observers.
    pub fn update(&self, cx: &mut App, f: impl FnOnce(&mut T)) {
        self.entity.update(cx, |slot, cx| {
            f(slot);
            cx.notify();
        });
    }
}

impl<T> Clone for Signal<T> {
    fn clone(&self) -> Self {
        Signal {
            entity: self.entity.clone(),
        }
    }
}