eave-api 0.1.6

Plugin API for the eave status bar
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
109
110
111
112
113
114
115
116
117
118
119

use std::time::Duration;

use crate::Task;

/// What [`Widget::update`](crate::Widget::update) asks for: async work, plus requests to the host.
pub struct Effect<M> {
    task: Task<M>,
    popover: Option<PopoverRequest>,
    nudge: Option<NudgeRequest>,
}

#[doc(hidden)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum PopoverRequest {
    Open,
    Close,
}

/// Which way something just went, so the host can give the widget's island a nudge that way.
///
/// It says what happened, not how to move: the host picks the motion. A value going up or down
/// (a volume, a brightness) bumps the island's top or bottom edge out at the widget's item; moving
/// to the next or previous thing (a workspace, a track) pushes the whole island left or right,
/// and it springs back into place.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Nudge {
    Up,
    Down,
    Left,
    Right,
}

/// A nudge as the host gets it: which way, and how long what it follows takes on screen, if the
/// widget knows.
#[doc(hidden)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct NudgeRequest {
    pub nudge: Nudge,
    pub lasting: Option<Duration>,
}

impl From<Nudge> for NudgeRequest {
    fn from(nudge: Nudge) -> Self {
        Self {
            nudge,
            lasting: None,
        }
    }
}

impl<M> Effect<M> {
    pub fn none() -> Self {
        Self {
            task: Task::none(),
            popover: None,
            nudge: None,
        }
    }

    pub fn task(task: Task<M>) -> Self {
        Self {
            task,
            popover: None,
            nudge: None,
        }
    }

    /// Runs `task` too, alongside the one it has.
    pub fn and_task(mut self, task: Task<M>) -> Self
    where
        M: Send + 'static,
    {
        self.task = Task::batch([self.task, task]);
        self
    }

    /// Opens this widget's popover, under its item. Ignored if the widget has no popover.
    /// Before the item was ever clicked, it opens on the bar the notifications show on.
    pub fn open_popover(mut self) -> Self {
        self.popover = Some(PopoverRequest::Open);
        self
    }

    pub fn close_popover(mut self) -> Self {
        self.popover = Some(PopoverRequest::Close);
        self
    }

    /// Nudges this widget's island. Ignored while the island is held or has a popover.
    pub fn nudge(mut self, nudge: Nudge) -> Self {
        self.nudge = Some(NudgeRequest {
            nudge,
            lasting: None,
        });
        self
    }

    /// Nudges this widget's island in step with something else on screen that takes `lasting`,
    /// like the compositor's own workspace animation: the host plays the same motion, slowed down
    /// or sped up to settle over about that long.
    pub fn nudge_lasting(mut self, nudge: Nudge, lasting: Duration) -> Self {
        self.nudge = Some(NudgeRequest {
            nudge,
            lasting: Some(lasting),
        });
        self
    }

    #[doc(hidden)]
    pub fn into_parts(self) -> (Task<M>, Option<PopoverRequest>, Option<NudgeRequest>) {
        (self.task, self.popover, self.nudge)
    }
}

impl<M> From<Task<M>> for Effect<M> {
    fn from(task: Task<M>) -> Self {
        Self::task(task)
    }
}