ublx 0.1.1

TUI to index once, enrich with metadata, and browse a flat snapshot in a 3-pane layout with multiple modes.
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

//! theme-selector applet: open selector, handle keys (Up/Down/Enter/Esc), apply theme and toast.

use std::path::PathBuf;

use crate::app::RunUblxParams;
use crate::config::{UblxOpts, UblxPaths, write_local_theme};
use crate::layout::setup::UblxState;
use crate::modules::settings;
use crate::themes;
use crate::ui::{UblxAction, show_operation_toast};
use crate::utils::{clamp_selection, sync_osc11_page_background};

/// Match [`crate::app::runtime::frame::theme_name_for_tick`] after closing the selector: OSC 11 uses the same theme as the TUI.
fn sync_osc11_after_selector_change(params: &RunUblxParams<'_>, theme_name: Option<&str>) {
    let _ = sync_osc11_page_background(theme_name, params.bg_opacity, params.opacity_format);
}

/// Context for the theme selector: indexed project dir (local `ublx.toml` / `.ublx.toml`) + current theme label.
#[derive(Clone, Debug)]
pub struct ThemeContext {
    /// Always write theme via [`write_local_theme`] for this indexed directory.
    pub project_dir: PathBuf,
    pub current_theme_name: Option<String>,
}

/// Build selector context. Theme is always persisted to **local** project config, never global-only.
#[must_use]
pub fn context_from_state(
    _state_ref: &UblxState,
    params_ref: &RunUblxParams<'_>,
    display_theme_name: Option<&str>,
) -> ThemeContext {
    ThemeContext {
        project_dir: params_ref.dir_to_ublx.clone(),
        current_theme_name: display_theme_name.map(String::from),
    }
}

/// Open the theme selector (set state; caller should return after so no other action runs).
pub fn open(state_mut: &mut UblxState, ctx_ref: &ThemeContext) {
    let current = ctx_ref
        .current_theme_name
        .as_deref()
        .or(state_mut.theme.override_name.as_deref());
    state_mut.theme.before_selector = current.map(String::from);
    state_mut.theme.selector_index = themes::theme_ordered_list()
        .iter()
        .position(|t| current == Some(t.name))
        .unwrap_or(0);
    state_mut.theme.selector_visible = true;
}

/// Handle one key while theme selector is visible. Caller should return after (no further action handling).
pub fn handle_key(
    state_mut: &mut UblxState,
    params_mut: &mut RunUblxParams<'_>,
    ublx_opts_mut: &mut UblxOpts,
    theme_ctx_ref: &ThemeContext,
    action: UblxAction,
) {
    let opts = themes::theme_ordered_list();
    let n = opts.len();
    match action {
        UblxAction::Quit | UblxAction::SearchClear => {
            state_mut.theme.override_name = state_mut.theme.before_selector.clone();
            state_mut.theme.selector_visible = false;
            sync_osc11_after_selector_change(
                params_mut,
                state_mut
                    .theme
                    .override_name
                    .as_deref()
                    .or(params_mut.theme.as_deref()),
            );
        }
        UblxAction::MoveDown => {
            state_mut.theme.selector_index = clamp_selection(state_mut.theme.selector_index + 1, n);
            sync_osc11_after_selector_change(
                params_mut,
                Some(opts[state_mut.theme.selector_index].name),
            );
        }
        UblxAction::MoveUp => {
            state_mut.theme.selector_index =
                clamp_selection(state_mut.theme.selector_index.saturating_sub(1), n);
            sync_osc11_after_selector_change(
                params_mut,
                Some(opts[state_mut.theme.selector_index].name),
            );
        }
        UblxAction::SearchSubmit => {
            let display_name = opts[state_mut.theme.selector_index].name;
            write_local_theme(
                &UblxPaths::new(theme_ctx_ref.project_dir.as_path()),
                display_name,
            );
            state_mut.config_written_by_us_at = Some(std::time::Instant::now());
            settings::apply_config_reload(params_mut, ublx_opts_mut, state_mut, None::<&str>);
            let theme_msg = format!("Changed theme to {display_name}");
            show_operation_toast(
                state_mut,
                params_mut,
                theme_msg,
                "theme-selector",
                log::Level::Info,
            );
            state_mut.theme.override_name = Some(display_name.to_string());
            state_mut.theme.selector_visible = false;
        }
        _ => {}
    }
}