Skip to main content

tea_cli/tui/
theme.rs

1use ratatui::style::{Color, Modifier, Style};
2
3use super::terminal::{ColorCapability, TerminalCapabilities};
4
5/// Small semantic terminal palette independent of durable state.
6#[derive(Debug, Clone, Copy, PartialEq, Eq)]
7pub struct Theme {
8    /// Monotonic identifier included in render-cache keys.
9    pub generation: u64,
10    /// Normal transcript text.
11    pub normal: Style,
12    /// User-authored text.
13    pub user: Style,
14    /// Assistant-authored text.
15    pub assistant: Style,
16    /// Markdown heading text.
17    pub markdown_heading: Style,
18    /// Markdown quote text.
19    pub markdown_quote: Style,
20    /// Markdown fenced or indented code.
21    pub markdown_code: Style,
22    /// Markdown inline code.
23    pub markdown_inline_code: Style,
24    /// Markdown link labels and visible fallback targets.
25    pub markdown_link: Style,
26    /// Markdown ordered and unordered list markers.
27    pub markdown_list_marker: Style,
28    /// Reasoning text.
29    pub thinking: Style,
30    /// Tool activity.
31    pub tool: Style,
32    /// Successful lifecycle or result output.
33    pub success: Style,
34    /// Warning lifecycle or notice output.
35    pub warning: Style,
36    /// Failed lifecycle or result output.
37    pub error: Style,
38    /// Low-salience informational output.
39    pub information: Style,
40    /// Approval warning.
41    pub approval: Style,
42    /// Error/notification text.
43    pub notification: Style,
44    /// Editor input.
45    pub editor: Style,
46    /// Full-width low-contrast editor surface.
47    pub composer: Style,
48    /// Footer statistics.
49    pub footer: Style,
50    reduced_motion: bool,
51    color_capability: ColorCapability,
52}
53
54impl Theme {
55    /// Builds a palette that avoids unsupported terminal output sequences.
56    #[must_use]
57    pub(crate) fn for_capabilities(capabilities: TerminalCapabilities) -> Self {
58        let reduced_motion = capabilities.reduced_motion();
59        match capabilities.color() {
60            ColorCapability::None => Self {
61                generation: 1 + u64::from(reduced_motion),
62                normal: Style::default(),
63                user: Style::default(),
64                assistant: Style::default(),
65                markdown_heading: Style::default().add_modifier(Modifier::BOLD),
66                markdown_quote: Style::default().add_modifier(Modifier::ITALIC),
67                markdown_code: Style::default().add_modifier(Modifier::DIM),
68                markdown_inline_code: Style::default().add_modifier(Modifier::REVERSED),
69                markdown_link: Style::default().add_modifier(Modifier::UNDERLINED),
70                markdown_list_marker: Style::default().add_modifier(Modifier::BOLD),
71                thinking: Style::default().add_modifier(Modifier::DIM),
72                tool: Style::default().add_modifier(Modifier::BOLD),
73                success: Style::default().add_modifier(Modifier::BOLD),
74                warning: Style::default().add_modifier(Modifier::BOLD),
75                error: Style::default().add_modifier(Modifier::BOLD),
76                information: Style::default(),
77                approval: Style::default().add_modifier(Modifier::BOLD | Modifier::REVERSED),
78                notification: Style::default().add_modifier(Modifier::BOLD),
79                editor: Style::default(),
80                composer: Style::default().add_modifier(Modifier::REVERSED),
81                footer: Style::default().add_modifier(Modifier::DIM),
82                reduced_motion,
83                color_capability: ColorCapability::None,
84            },
85            ColorCapability::Ansi16 => Self::with_palette(
86                3 + u64::from(reduced_motion),
87                Color::DarkGray,
88                reduced_motion,
89                ColorCapability::Ansi16,
90            ),
91            ColorCapability::Ansi256 => Self::with_palette(
92                5 + u64::from(reduced_motion),
93                Color::Indexed(236),
94                reduced_motion,
95                ColorCapability::Ansi256,
96            ),
97            ColorCapability::TrueColor => Self::with_palette(
98                7 + u64::from(reduced_motion),
99                Color::Rgb(36, 40, 45),
100                reduced_motion,
101                ColorCapability::TrueColor,
102            ),
103        }
104    }
105
106    fn with_palette(
107        generation: u64,
108        composer_background: Color,
109        reduced_motion: bool,
110        color_capability: ColorCapability,
111    ) -> Self {
112        Self {
113            generation,
114            normal: Style::default().fg(Color::Reset),
115            user: Style::default().fg(Color::Cyan),
116            assistant: Style::default().fg(Color::White),
117            markdown_heading: Style::default()
118                .fg(Color::White)
119                .add_modifier(Modifier::BOLD),
120            markdown_quote: Style::default()
121                .fg(Color::Green)
122                .add_modifier(Modifier::ITALIC),
123            markdown_code: Style::default().fg(Color::Gray),
124            markdown_inline_code: Style::default().fg(Color::LightCyan),
125            markdown_link: Style::default()
126                .fg(Color::LightBlue)
127                .add_modifier(Modifier::UNDERLINED),
128            markdown_list_marker: Style::default().fg(Color::LightBlue),
129            thinking: Style::default().fg(Color::DarkGray),
130            tool: Style::default().fg(Color::Yellow),
131            success: Style::default().fg(Color::Green),
132            warning: Style::default().fg(Color::Yellow),
133            error: Style::default().fg(Color::LightRed),
134            information: Style::default().fg(Color::Reset),
135            approval: Style::default()
136                .fg(Color::Black)
137                .bg(Color::Yellow)
138                .add_modifier(Modifier::BOLD),
139            notification: Style::default().fg(Color::LightRed),
140            editor: Style::default().fg(Color::LightCyan),
141            composer: Style::default().fg(Color::White).bg(composer_background),
142            footer: Style::default().fg(Color::DarkGray),
143            reduced_motion,
144            color_capability,
145        }
146    }
147
148    pub(crate) const fn color_capability(&self) -> ColorCapability {
149        self.color_capability
150    }
151
152    /// Returns the status marker for the current elapsed-second tick.
153    #[must_use]
154    pub(crate) const fn status_marker(&self, elapsed_seconds: u64) -> &'static str {
155        if self.reduced_motion {
156            "*"
157        } else {
158            match elapsed_seconds % 4 {
159                0 => "*",
160                1 | 3 => "+",
161                _ => "x",
162            }
163        }
164    }
165}
166
167impl Default for Theme {
168    fn default() -> Self {
169        Self::for_capabilities(TerminalCapabilities::from_environment(
170            Some("xterm-truecolor"),
171            Some("truecolor"),
172            false,
173            false,
174        ))
175    }
176}
177
178#[cfg(test)]
179mod tests {
180    use ratatui::style::Modifier;
181
182    use super::{TerminalCapabilities, Theme};
183
184    #[test]
185    fn no_color_theme_keeps_the_composer_visible_and_motion_still() {
186        let theme = Theme::for_capabilities(TerminalCapabilities::from_environment(
187            Some("dumb"),
188            None,
189            false,
190            false,
191        ));
192
193        assert!(theme.composer.add_modifier.contains(Modifier::REVERSED));
194        assert_eq!(theme.status_marker(0), "*");
195        assert_eq!(theme.status_marker(2), "*");
196    }
197}