gantz_egui 0.6.1

UI traits and widgets that make up the GUI for gantz, an environment for creative systems.
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

//! A validated name-editing `TextEdit` for a head.

/// Response from [`head_name_edit`].
pub struct HeadNameEditResponse {
    /// The inner `TextEdit` response.
    pub response: egui::Response,
    /// A valid rename committed via Enter or focus loss.
    pub new_branch: Option<(gantz_ca::Head, String)>,
}

/// Show a validated name-editing `TextEdit` for the given head.
///
/// Text is red when the name is empty, already exists (excluding the head's own
/// current name), or contains the reserved nested-graph separator `:`. Returns
/// a valid `new_branch` when a rename is committed via Enter or focus loss.
///
/// `:` is reserved for the `parent:child` nesting convention and is only ever
/// produced by creating a nested graph - so renaming always targets a plain
/// (root) name. For a nested graph, that effectively saves it as a new root
/// graph copy.
pub fn head_name_edit(
    head: &gantz_ca::Head,
    name: &mut String,
    names: &[(gantz_ca::Name, gantz_ca::CommitAddr)],
    ui: &mut egui::Ui,
) -> HeadNameEditResponse {
    let name_exists = names.iter().any(|(n, _)| n.to_string() == *name);
    let is_current_name = matches!(head, gantz_ca::Head::Branch(n) if n.to_string() == *name);
    let is_empty = name.is_empty();
    let has_separator = name.contains(gantz_ca::name::SEP);
    let is_invalid = is_empty || (!is_current_name && (name_exists || has_separator));

    let text_color = if is_invalid && !is_current_name {
        egui::Color32::RED
    } else {
        ui.visuals().text_color()
    };

    let text_edit = egui::TextEdit::singleline(name)
        .desired_width(ui.available_width())
        .text_color(text_color)
        .hint_text("name");
    let mut response = ui.add(text_edit);
    if has_separator && !is_current_name {
        response = response.on_hover_text(format!(
            "'{}' is reserved for nested graphs; use a plain name",
            gantz_ca::name::SEP,
        ));
    }

    let enter_pressed = response.lost_focus() && ui.input(|i| i.key_pressed(egui::Key::Enter));
    let focus_lost = response.lost_focus() && !ui.input(|i| i.key_pressed(egui::Key::Escape));
    let cancelled = ui.input(|i| i.key_pressed(egui::Key::Escape));

    let mut new_branch = None;
    if enter_pressed || focus_lost {
        if !is_empty && !is_invalid {
            new_branch = Some((head.clone(), name.clone()));
        }
        *name = head_name(head);
    } else if cancelled {
        *name = head_name(head);
    }

    HeadNameEditResponse {
        response,
        new_branch,
    }
}

pub fn head_name(head: &gantz_ca::Head) -> String {
    match head {
        gantz_ca::Head::Branch(n) => n.to_string(),
        gantz_ca::Head::Commit(_) => String::new(),
    }
}