par-term-settings-ui 0.19.0

Settings UI for par-term terminal emulator
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

//! Profile management section (inline profile list/editor).

use crate::profile_modal_ui::ProfileModalAction;
use crate::profile_modal_ui::shortcut;
use crate::section::{keyword_section, keyword_section_with_state};
use crate::settings_ui::SettingsUI;
use std::collections::HashSet;

/// Show the profile management section (inline profile list and editor).
pub(crate) fn show_management_section(
    ui: &mut egui::Ui,
    settings: &mut SettingsUI,
    collapsed: &mut HashSet<String>,
) {
    keyword_section_with_state(
        ui,
        "Profile Management",
        "profiles_management",
        &[
            "duplicate",
            "default profile",
            "par-mux",
            "mux",
            "tmux",
            "ssh",
            "shell",
            "tags",
            "login shell",
            "bash",
            "zsh",
            "fish",
            "powershell",
            "inheritance",
            "auto switch",
            "profile shader",
            "shader override",
            "hostname",
            "ssh host",
            "ssh user",
            "ssh port",
            "identity file",
            "tmux session",
            "auto-connect",
            "mux session",
            "session name",
            "set default",
        ],
        true,
        collapsed,
        |ui, collapsed| {
            // Render the profile list/edit UI inline
            settings.profile_modal_ui.global_tmux_enabled = settings.config.tmux.tmux_enabled;
            let bound = settings
                .profile_modal_ui
                .editing_profile()
                .and_then(|id| shortcut::bound_chord(&settings.config.keybindings, id));
            settings.profile_modal_ui.set_config_shortcut(bound);
            let action = settings.profile_modal_ui.show_inline(ui, collapsed);

            // Recorded chords are conflict-checked here, where the config is.
            if let Some((chord, action_id)) = settings.profile_modal_ui.take_chord_to_check() {
                let conflict = settings.check_recorded_chord_conflict(&chord, &action_id);
                settings.profile_modal_ui.set_shortcut_conflict(conflict);
            }
            settings.apply_pending_profile_binding();

            // Handle returned actions
            match action {
                // Only the empty-list confirmation returns Save now; it
                // runs the Settings window's Save, which persists config and
                // profiles together (UX.md SS5).
                ProfileModalAction::Save => {
                    settings.global_save_requested = true;
                }
                ProfileModalAction::Cancel | ProfileModalAction::None => {}
            }
        },
    );
}

impl SettingsUI {
    /// Done on the profile editor (or a Save that finishes the open form)
    /// stages a shortcut change; write it into the working config, replacing
    /// the profile's existing `open_profile:<id>` binding.
    pub(crate) fn apply_pending_profile_binding(&mut self) {
        if let Some(change) = self.profile_modal_ui.take_pending_binding() {
            shortcut::apply_binding(&mut self.config.keybindings, &change);
            self.has_changes = true;
        }
    }
}

/// Show the display options section (profile drawer toggle button).
pub(crate) fn show_display_options_section(
    ui: &mut egui::Ui,
    settings: &mut SettingsUI,
    collapsed: &mut HashSet<String>,
) {
    keyword_section(
        ui,
        "Display Options",
        "profiles_display",
        &["profile indicator"],
        true,
        collapsed,
        |ui| {
            // UX.md SC7: the profile drawer button has one control, on
            // Windows & Tabs › Tab Bar. This section points there instead of
            // repeating it.
            ui.horizontal(|ui| {
                let state = if settings.config.tabs.show_profile_drawer_button {
                    "shown"
                } else {
                    "hidden"
                };
                ui.label(format!("Profile drawer button: {state}."));
                if ui
                    .link("Change in Windows & Tabs › Tab Bar")
                    .on_hover_text("The show/hide control lives on the Tab Bar page")
                    .clicked()
                {
                    settings.open_section("window_tab_bar");
                }
            });
            ui.add_space(4.0);
            ui.label(
                egui::RichText::new(
                    "The profile drawer gives quick access to your profiles without opening \
                     Settings.",
                )
                .small()
                .color(egui::Color32::GRAY),
            );
        },
    );
}