Skip to main content

hyprstream_tui/
shell_ui.rs

1//! Rendering for the TUI shell (standalone hyprstream-tui binary).
2//!
3//! Layout:
4//! ```text
5//! ┌─ status bar (1 row) ─────────────────────────────┐
6//! │  pane content (Min rows) — VT cells or background │
7//! │  [model/settings modal overlay]                   │
8//! └─ window strip / taskbar (1 row) ─────────────────┘
9//! ```
10
11#![cfg(not(target_os = "wasi"))]
12
13use ratatui::layout::{Constraint, Layout, Rect};
14use ratatui::style::{Color, Style};
15use ratatui::text::{Line, Span};
16use ratatui::widgets::{Block, Borders, Clear, Paragraph, Tabs};
17use ratatui::Frame;
18
19use crate::background::PREVIEW_W;
20use crate::shell_app::{CloneScreen, PaneWindow, ShellApp, ShellMode, MENU_ITEMS};
21use crate::theme;
22
23// ============================================================================
24// Top-level draw
25// ============================================================================
26
27pub fn draw(frame: &mut Frame, app: &ShellApp) {
28    let area = frame.area();
29    let chunks = Layout::vertical([
30        Constraint::Length(1), // status bar
31        Constraint::Min(1),    // pane content / background
32        Constraint::Length(1), // window strip
33    ])
34    .split(area);
35
36    draw_status_bar(frame, chunks[0], app);
37    draw_content(frame, chunks[1], app);
38    draw_window_strip(frame, chunks[2], app);
39
40    match app.mode {
41        ShellMode::ModelList => draw_model_modal(frame, area, app),
42        ShellMode::Settings => draw_settings_modal(frame, area, app),
43        ShellMode::StartMenu { selected } => draw_start_menu(frame, area, selected),
44        ShellMode::CloneFlow(_) => draw_clone_modal(frame, area, app),
45        ShellMode::GitOpInProgress { .. } => draw_git_op_modal(frame, area, app),
46        ShellMode::Normal => {}
47    }
48}
49
50// ============================================================================
51// Status bar
52// ============================================================================
53
54fn draw_status_bar(frame: &mut Frame, area: Rect, app: &ShellApp) {
55    let clock = current_time_str();
56    let clock_width = clock.len() as u16 + 1;
57
58    let mut left_spans = vec![
59        Span::raw(" \u{1f319} "),
60        Span::styled("HYPRSTREAM", theme::title_style()),
61    ];
62    if let Some(status) = &app.load_status {
63        left_spans.push(Span::raw("  "));
64        left_spans.push(Span::styled(status.clone(), theme::help_text()));
65    }
66
67    let left_w = area.width.saturating_sub(clock_width);
68    let left_area = Rect {
69        width: left_w,
70        ..area
71    };
72    let right_area = Rect {
73        x: area.x + left_w,
74        width: clock_width,
75        ..area
76    };
77
78    frame.render_widget(
79        Paragraph::new(Line::from(left_spans)).style(Style::default().bg(theme::BG_PANEL)),
80        left_area,
81    );
82    frame.render_widget(
83        Paragraph::new(Line::from(vec![
84            Span::styled(clock, theme::help_text()),
85            Span::raw(" "),
86        ]))
87        .style(Style::default().bg(theme::BG_PANEL)),
88        right_area,
89    );
90}
91
92fn current_time_str() -> String {
93    use std::time::{SystemTime, UNIX_EPOCH};
94    let secs = SystemTime::now()
95        .duration_since(UNIX_EPOCH)
96        .unwrap_or_default()
97        .as_secs();
98    let h = (secs / 3600) % 24;
99    let m = (secs / 60) % 60;
100    let s = secs % 60;
101    format!("{h:02}:{m:02}:{s:02}")
102}
103
104// ============================================================================
105// Pane content — VT or animated background
106// ============================================================================
107
108fn draw_content(frame: &mut Frame, area: Rect, app: &ShellApp) {
109    match app.windows.get(app.active) {
110        Some(win) => draw_pane(frame, area, win),
111        None => app.bg.render(frame, area),
112    }
113}
114
115fn draw_pane(frame: &mut Frame, area: Rect, win: &PaneWindow) {
116    hyprstream_compositor::render::draw_vt_cells(frame, area, &win.pane.vt);
117}
118
119// ============================================================================
120// Window strip
121// ============================================================================
122
123fn draw_window_strip(frame: &mut Frame, area: Rect, app: &ShellApp) {
124    if app.windows.is_empty() {
125        frame.render_widget(
126            Paragraph::new(" [no windows]")
127                .style(Style::default().fg(theme::DIM).bg(theme::BG_PANEL)),
128            area,
129        );
130        return;
131    }
132
133    let titles: Vec<Line> = app
134        .windows
135        .iter()
136        .enumerate()
137        .map(|(i, win)| {
138            let label = format!(" {} ", win.title);
139            if i == app.active {
140                Line::from(Span::styled(label, theme::tab_active()))
141            } else {
142                Line::from(Span::styled(label, theme::tab_inactive()))
143            }
144        })
145        .collect();
146
147    let tabs = Tabs::new(titles)
148        .select(app.active)
149        .highlight_style(theme::tab_active())
150        .divider(Span::styled("│", Style::default().fg(theme::DIM)))
151        .style(Style::default().bg(theme::BG_PANEL));
152
153    frame.render_widget(tabs, area);
154}
155
156// ============================================================================
157// Model list modal
158// ============================================================================
159
160fn draw_model_modal(frame: &mut Frame, full_area: Rect, app: &ShellApp) {
161    let modal = centered_rect(60, 70, full_area);
162    frame.render_widget(Clear, modal);
163
164    let block = Block::default()
165        .title(Span::styled(" Models ", theme::title_style()))
166        .borders(Borders::ALL)
167        .border_style(theme::border_style())
168        .style(Style::default().bg(theme::BG_PANEL));
169
170    let inner = block.inner(modal);
171    frame.render_widget(block, modal);
172
173    let hint_area = Rect {
174        y: inner.y + inner.height.saturating_sub(1),
175        height: 1,
176        ..inner
177    };
178    let list_area = Rect {
179        height: inner.height.saturating_sub(2),
180        ..inner
181    };
182
183    let mut hint_spans = vec![
184        Span::styled("c", theme::help_key()),
185        Span::styled(" clone  ", theme::help_text()),
186        Span::styled("p", theme::help_key()),
187        Span::styled(" pull  ", theme::help_text()),
188        Span::styled("P", theme::help_key()),
189        Span::styled(" push  ", theme::help_text()),
190        Span::styled("l", theme::help_key()),
191        Span::styled(" load  ", theme::help_text()),
192        Span::styled("u", theme::help_key()),
193        Span::styled(" unload  ", theme::help_text()),
194    ];
195    if cfg!(any(target_os = "linux", target_os = "openbsd")) {
196        hint_spans.push(Span::styled("T", theme::help_key()));
197        hint_spans.push(Span::styled(" term  ", theme::help_text()));
198    }
199    hint_spans.extend([
200        Span::styled("Esc", theme::help_key()),
201        Span::styled(" close", theme::help_text()),
202    ]);
203    let hint = Paragraph::new(Line::from(hint_spans)).style(Style::default().bg(theme::BG_PANEL));
204    frame.render_widget(hint, hint_area);
205
206    app.model_list.render(frame, list_area);
207}
208
209// ============================================================================
210// Clone flow modal
211// ============================================================================
212
213fn draw_clone_modal(frame: &mut Frame, full_area: Rect, app: &ShellApp) {
214    let modal = centered_rect(55, 30, full_area);
215    frame.render_widget(Clear, modal);
216
217    let title = match &app.mode {
218        ShellMode::CloneFlow(CloneScreen::EnterUrl(_)) => " Clone — URL ",
219        ShellMode::CloneFlow(CloneScreen::EnterName(..)) => " Clone — Name ",
220        ShellMode::CloneFlow(CloneScreen::Cloning { .. }) => " Cloning… ",
221        ShellMode::CloneFlow(CloneScreen::Done(_)) => " Clone Complete ",
222        ShellMode::CloneFlow(CloneScreen::Failed(_)) => " Clone Failed ",
223        _ => " Clone ",
224    };
225
226    let block = Block::default()
227        .title(Span::styled(title, theme::title_style()))
228        .borders(Borders::ALL)
229        .border_style(theme::border_style())
230        .style(Style::default().bg(theme::BG_PANEL));
231
232    let inner = block.inner(modal);
233    frame.render_widget(block, modal);
234
235    match &app.mode {
236        ShellMode::CloneFlow(CloneScreen::EnterUrl(input)) => {
237            input.render(frame, inner);
238        }
239        ShellMode::CloneFlow(CloneScreen::EnterName(input, _url)) => {
240            input.render(frame, inner);
241        }
242        ShellMode::CloneFlow(CloneScreen::Cloning {
243            name,
244            progress_msg,
245            progress_pct,
246            ..
247        }) => {
248            let bar_width = inner.width.saturating_sub(8) as usize;
249            let filled = (bar_width as u16 * (*progress_pct as u16) / 100) as usize;
250            let empty = bar_width.saturating_sub(filled);
251            let bar = format!(
252                "[{}{}] {:>3}%",
253                "#".repeat(filled),
254                " ".repeat(empty),
255                progress_pct
256            );
257
258            let text = vec![
259                Line::from(Span::styled(name.as_str(), theme::help_text())),
260                Line::from(""),
261                Line::from(Span::styled(bar, Style::default().fg(Color::Green))),
262                Line::from(Span::styled(progress_msg.as_str(), theme::help_text())),
263            ];
264            frame.render_widget(Paragraph::new(text), inner);
265        }
266        ShellMode::CloneFlow(CloneScreen::Done(msg)) => {
267            let text = vec![
268                Line::from(Span::styled(
269                    msg.as_str(),
270                    Style::default().fg(Color::Green),
271                )),
272                Line::from(""),
273                Line::from(vec![
274                    Span::styled("Enter", theme::help_key()),
275                    Span::styled(" to continue", theme::help_text()),
276                ]),
277            ];
278            frame.render_widget(Paragraph::new(text), inner);
279        }
280        ShellMode::CloneFlow(CloneScreen::Failed(msg)) => {
281            let text = vec![
282                Line::from(Span::styled(msg.as_str(), Style::default().fg(Color::Red))),
283                Line::from(""),
284                Line::from(vec![
285                    Span::styled("Enter", theme::help_key()),
286                    Span::styled(" to continue", theme::help_text()),
287                ]),
288            ];
289            frame.render_widget(Paragraph::new(text), inner);
290        }
291        _ => {}
292    }
293}
294
295// ============================================================================
296// Git operation progress modal
297// ============================================================================
298
299fn draw_git_op_modal(frame: &mut Frame, full_area: Rect, app: &ShellApp) {
300    let modal = centered_rect(50, 25, full_area);
301    frame.render_widget(Clear, modal);
302
303    let (title, model_ref, progress_msg) = match &app.mode {
304        ShellMode::GitOpInProgress {
305            op_name,
306            model_ref,
307            progress_msg,
308        } => (op_name.as_str(), model_ref.as_str(), progress_msg.as_str()),
309        _ => return,
310    };
311
312    let display_title = if title.is_empty() { "Git" } else { title };
313    let block = Block::default()
314        .title(Span::styled(
315            format!(" {display_title} "),
316            theme::title_style(),
317        ))
318        .borders(Borders::ALL)
319        .border_style(theme::border_style())
320        .style(Style::default().bg(theme::BG_PANEL));
321
322    let inner = block.inner(modal);
323    frame.render_widget(block, modal);
324
325    let is_terminal = progress_msg.starts_with("Done:") || progress_msg.starts_with("Error:");
326    let msg_style = if progress_msg.starts_with("Error:") {
327        Style::default().fg(Color::Red)
328    } else if progress_msg.starts_with("Done:") {
329        Style::default().fg(Color::Green)
330    } else {
331        theme::help_text()
332    };
333
334    let mut lines = vec![
335        Line::from(Span::styled(model_ref, theme::help_text())),
336        Line::from(""),
337        Line::from(Span::styled(progress_msg, msg_style)),
338    ];
339    if is_terminal {
340        lines.push(Line::from(""));
341        lines.push(Line::from(vec![
342            Span::styled("Enter", theme::help_key()),
343            Span::styled(" to continue", theme::help_text()),
344        ]));
345    }
346    frame.render_widget(Paragraph::new(lines), inner);
347}
348
349// ============================================================================
350// Settings modal
351// ============================================================================
352
353fn draw_settings_modal(frame: &mut Frame, full_area: Rect, app: &ShellApp) {
354    let modal = centered_rect(50, 65, full_area);
355    frame.render_widget(Clear, modal);
356
357    let block = Block::default()
358        .title(Span::styled(" Settings ", theme::title_style()))
359        .borders(Borders::ALL)
360        .border_style(theme::border_style())
361        .style(Style::default().bg(theme::BG_PANEL));
362
363    let inner = block.inner(modal);
364    frame.render_widget(block, modal);
365
366    // Split vertically: list on top, preview in middle, hint at bottom.
367    // List needs 1 (label) + 3 (items) + 1 (gap) = 5 rows minimum.
368    let list_height = 5u16.min(inner.height.saturating_sub(1) / 2);
369    let chunks = Layout::vertical([
370        Constraint::Length(list_height),
371        Constraint::Min(3),
372        Constraint::Length(1),
373    ])
374    .split(inner);
375
376    app.settings_list.render(frame, chunks[0]);
377
378    // Preview box.
379    let preview_block = Block::default()
380        .title(Span::styled(" Preview ", theme::help_text()))
381        .borders(Borders::ALL)
382        .border_style(Style::default().fg(theme::DIM))
383        .style(Style::default().bg(Color::Black));
384
385    let preview_outer = chunks[1];
386    let preview_inner = preview_block.inner(preview_outer);
387    frame.render_widget(preview_block, preview_outer);
388
389    // Clamp the preview render area to PREVIEW_W so matrix columns line up.
390    let pw = preview_inner.width.min(PREVIEW_W);
391    let preview_render = Rect {
392        width: pw,
393        ..preview_inner
394    };
395    app.preview_bg.render(frame, preview_render);
396
397    // Hint bar.
398    let hint_spans = vec![
399        Span::styled("\u{2191}\u{2193}", theme::help_key()),
400        Span::raw(" "),
401        Span::styled("Navigate", theme::help_text()),
402        Span::raw("  "),
403        Span::styled("Enter", theme::help_key()),
404        Span::raw(" "),
405        Span::styled("Select", theme::help_text()),
406        Span::raw("  "),
407        Span::styled("Esc", theme::help_key()),
408        Span::raw(" "),
409        Span::styled("Cancel", theme::help_text()),
410    ];
411    frame.render_widget(
412        Paragraph::new(Line::from(hint_spans)).style(Style::default().bg(theme::BG_PANEL)),
413        chunks[2],
414    );
415}
416
417// ============================================================================
418// Start-menu popup
419// ============================================================================
420
421fn draw_start_menu(frame: &mut Frame, area: Rect, selected: usize) {
422    let popup_w: u16 = 22;
423    let popup_h: u16 = MENU_ITEMS.len() as u16 + 2;
424    let popup_y = area.height.saturating_sub(popup_h + 1);
425    let popup = Rect {
426        x: 0,
427        y: popup_y,
428        width: popup_w.min(area.width),
429        height: popup_h.min(area.height),
430    };
431
432    frame.render_widget(Clear, popup);
433
434    let block = Block::default()
435        .borders(Borders::ALL)
436        .border_style(theme::border_style())
437        .style(Style::default().bg(theme::BG_PANEL));
438
439    let inner = block.inner(popup);
440    frame.render_widget(block, popup);
441
442    let inner_w = inner.width as usize;
443    for (i, (label, hint)) in MENU_ITEMS.iter().enumerate() {
444        let row = Rect {
445            y: inner.y + i as u16,
446            height: 1,
447            ..inner
448        };
449        let style = if i == selected {
450            theme::tab_active()
451        } else {
452            theme::help_text()
453        };
454        let text = format!(
455            " {:<lw$}{:>rw$}",
456            label,
457            hint,
458            lw = inner_w.saturating_sub(hint.len() + 2),
459            rw = hint.len() + 1
460        );
461        frame.render_widget(
462            Paragraph::new(Line::from(Span::styled(text, style)))
463                .style(Style::default().bg(theme::BG_PANEL)),
464            row,
465        );
466    }
467}
468
469// ============================================================================
470// Utility
471// ============================================================================
472
473fn centered_rect(pct_x: u16, pct_y: u16, area: Rect) -> Rect {
474    let margin_y = (100 - pct_y) / 2;
475    let margin_x = (100 - pct_x) / 2;
476    let vert = Layout::vertical([
477        Constraint::Percentage(margin_y),
478        Constraint::Percentage(pct_y),
479        Constraint::Percentage(margin_y),
480    ])
481    .split(area);
482    Layout::horizontal([
483        Constraint::Percentage(margin_x),
484        Constraint::Percentage(pct_x),
485        Constraint::Percentage(margin_x),
486    ])
487    .split(vert[1])[1]
488}