iced-core-kora 0.15.0

The essential ideas of iced (Playtron's Kora fork of iced_core)
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

//! What a window offers the shell's command surfaces, and what the shell asks back.

/// A window's commands and recent items, published as one catalog that
/// replaces the last.
///
/// On Kora the Halo lists them in its command palette and shows quick settings on
/// the window's header.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct AppCommands {
    /// Standard verbs the window answers itself (`undo`, `redo`, `cut`, `copy`,
    /// `paste`, `selall`, `markv`, `settings`, `neww`, `find`, `info`), and
    /// whether it can right now.
    pub handles: Vec<(String, bool)>,
    /// The window's own commands, in order.
    pub commands: Vec<AppCommand>,
    /// Things the window can reopen, for the shell's Open Recent.
    pub recents: Vec<AppRecent>,
}

/// One of a window's own commands.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct AppCommand {
    /// Namespaced with a dot, such as `slate.zoom-in`.
    pub id: String,
    /// Row label.
    pub name: String,
    /// Shortcut hint, display only.
    pub keys: String,
    /// Heading the command is listed under; empty for none.
    pub section: String,
    /// Symbolic icon name; empty for the shell's generic glyph.
    pub icon: String,
    /// Put forward for the shell's compact app menu.
    pub menu: bool,
    /// Toggles rather than fires; `active` says which way.
    pub stateful: bool,
    /// The window itself binds `keys`.
    pub bound: bool,
    /// A stateful command shown as a toggle on the window's Halo, not only in
    /// its palette. Ignored by shells without quick settings.
    pub quick_setting: bool,
    /// Whether it can run right now.
    pub enabled: bool,
    /// Whether a stateful command is on.
    pub active: bool,
}

/// An item the window can reopen.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct AppRecent {
    /// Meaningful only to the window; handed back when picked.
    pub id: String,
    /// The row's title.
    pub label: String,
    /// An optional second line: where it lives, what it is.
    pub sublabel: String,
    /// Milliseconds since the Unix epoch of its last activity.
    pub timestamp_ms: u64,
}

/// What the shell asked a window to do.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub enum AppCommandRequest {
    /// Run the command or standard verb with this id.
    Invoke(String),
    /// Reopen the recent item with this id.
    OpenRecent(String),
}