ublx 0.2.0

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
113
114
115
116
117
118
119
120
121
122
123
124
125
126

//! Map [`Palette`] → CSS custom properties (`"H S% L%"` tokens) for the web UI.
//!
//! **Scaffold is the TUI.** Token *names* follow shadcn for leptos-shadcn-ui, but **which
//! fields paint together** must match [`crate::layout::style::ThemeStyles`] (e.g. active tabs
//! use `tab_active_fg` on `tab_active_bg`, never `focused_border` on `tab_active_bg`).
//! See `docs/WEB_UI.md` § Theming.

use std::collections::BTreeMap;

use ratatui::style::Color;
use serde::Serialize;

use super::color_utils::{color_to_hsl_token, rgb_to_hsl_token};
use super::{Appearance, Palette, adjust_surface_rgb, node_pill_background};

/// Matches TUI `table_row_style` stripe strength (`UiConstants::table_stripe_lighten` = 0.06).
const TABLE_STRIPE_LIGHTEN: f32 = 0.06;

/// Live theme payload for the web UI (`GET`/`PATCH /settings/{scope}`).
#[derive(Debug, Clone, Serialize, PartialEq, Eq)]
pub struct ThemeCss {
    /// Effective palette name (merged global+local).
    pub name: String,
    /// `"dark"` or `"light"` — toggles `html.dark` on the web client.
    pub appearance: String,
    /// CSS custom properties keyed with leading `--` (e.g. `--background` → `"214 65% 11%"`).
    pub vars: BTreeMap<String, String>,
}

fn token(color: Color) -> String {
    color_to_hsl_token(color).unwrap_or_else(|| rgb_to_hsl_token(0, 0, 0))
}

fn insert(vars: &mut BTreeMap<String, String>, name: &str, color: Color) {
    vars.insert(name.to_string(), token(color));
}

/// Build CSS tokens from a [`Palette`] using the WEB_UI theming map.
#[must_use]
pub fn tokens_from_palette(palette: &Palette) -> ThemeCss {
    let mut vars = BTreeMap::new();

    let bg = palette.background;
    let fg = palette.text;
    let focus = palette.focused_border;
    let pill = node_pill_background(palette);
    let inverse_fg = match palette.appearance {
        Appearance::Dark => Color::Rgb(255, 255, 255),
        Appearance::Light => Color::Rgb(0, 0, 0),
    };

    // Core shadcn tokens
    insert(&mut vars, "--background", bg);
    insert(&mut vars, "--foreground", fg);
    insert(&mut vars, "--card", palette.popup_bg);
    insert(&mut vars, "--card-foreground", fg);
    insert(&mut vars, "--popover", palette.popup_bg);
    insert(&mut vars, "--popover-foreground", fg);
    insert(&mut vars, "--primary", focus);
    insert(&mut vars, "--primary-foreground", bg);
    insert(&mut vars, "--secondary", palette.tab_active_bg);
    insert(&mut vars, "--secondary-foreground", palette.tab_active_fg);
    insert(&mut vars, "--muted", palette.tab_inactive_bg);
    insert(&mut vars, "--muted-foreground", palette.hint);
    insert(&mut vars, "--accent", palette.popup_bg);
    insert(&mut vars, "--accent-foreground", fg);
    insert(&mut vars, "--destructive", palette.delta_removed);
    insert(&mut vars, "--destructive-foreground", inverse_fg);
    insert(&mut vars, "--border", pill);
    insert(&mut vars, "--input", pill);
    insert(&mut vars, "--ring", focus);

    // TUI-specific extras (WEB_UI token table)
    insert(&mut vars, "--brand", palette.title_brand);
    insert(&mut vars, "--hint", palette.hint);
    insert(&mut vars, "--search", palette.search_text);
    insert(&mut vars, "--notification", palette.notification_bg);
    insert(&mut vars, "--delta-added", palette.delta_added);
    insert(&mut vars, "--delta-mod", palette.delta_mod);
    insert(&mut vars, "--delta-removed", palette.delta_removed);
    insert(&mut vars, "--node", pill);
    // TUI `table_row_style`: even = popup_bg (--card); odd = lightened popup_bg
    insert(
        &mut vars,
        "--table-stripe",
        adjust_surface_rgb(palette.popup_bg, TABLE_STRIPE_LIGHTEN, palette.appearance),
    );

    ThemeCss {
        name: palette.name.to_string(),
        appearance: match palette.appearance {
            Appearance::Dark => "dark".into(),
            Appearance::Light => "light".into(),
        },
        vars,
    }
}

/// Resolve theme by name (same rules as [`super::get`]) and build CSS tokens.
#[must_use]
pub fn tokens_for_theme_name(name: Option<&str>) -> ThemeCss {
    tokens_from_palette(super::get(name))
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::themes::OBLIVION_INK;

    #[test]
    fn oblivion_ink_maps_core_roles() {
        let css = tokens_from_palette(&OBLIVION_INK);
        assert_eq!(css.name, "Oblivion Ink");
        assert_eq!(css.appearance, "dark");
        assert!(css.vars.contains_key("--background"));
        assert!(css.vars.contains_key("--foreground"));
        assert!(css.vars.contains_key("--ring"));
        assert!(css.vars.contains_key("--brand"));
        assert!(css.vars.contains_key("--search"));
        assert!(css.vars.contains_key("--delta-added"));
        // Oblivion Ink page ≈ 214 65% 11%
        let bg = css.vars.get("--background").expect("bg");
        assert!(bg.starts_with("21"), "unexpected bg token {bg}");
        assert!(bg.contains('%'), "expected HSL percents in {bg}");
    }
}