alf_tui 0.5.0

A smolderingly-nimble Rust TUI to rediscover your custom shell.
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

//! UI rendering logic for the TUI.
//!
//! Implements the full layout matching the design:
//! - Header bar with filter badges and shell indicator
//! - Search bar with cursor support
//! - Main body: left list panel + right detail panels (description + script)
//! - Footer bar with help text

pub mod body;
mod components;
mod footer;
mod header;
mod help;
mod search;

use ratatui::layout::{Constraint, Direction, Layout};
use ratatui::style::{Modifier, Style, Stylize};
use ratatui::widgets::Block;
use ratatui::Frame;

use crate::tui::app::App;
use crate::tui::state::{EntryFilter, InputMode};
use crate::tui::themes::Theme;

/// Get the border style for the current filter
pub(super) fn get_border_style(
   filter: &EntryFilter,
   theme: &Theme,
) -> Style {
   match filter {
      EntryFilter::Aliases => Style::default().fg(theme.alias_color).add_modifier(Modifier::BOLD),
      EntryFilter::Functions => Style::default().fg(theme.function_color).add_modifier(Modifier::BOLD),
      _ => Style::default().white().add_modifier(Modifier::BOLD),
   }
}

// Re-export the draw functions for use by other modules
pub use body::draw_main_body;
pub use footer::draw_footer;
pub use header::draw_header;
pub use help::draw_help_modal;
pub use search::draw_search_bar;

/// Draw the complete TUI interface
pub fn draw(
   frame: &mut Frame,
   app: &mut App,
) {
   // Get theme for this render pass
   let theme = app.theme().clone();

   // Apply global background color to entire TUI
   let background = Block::default().style(Style::default().bg(theme.background));
   frame.render_widget(background, frame.area());

   // Top-level vertical layout
   let outer_chunks = Layout::default()
      .direction(Direction::Vertical)
      .constraints([
         Constraint::Length(1), // Header bar
         Constraint::Length(3), // Search bar
         Constraint::Min(0),    // Main content body
         Constraint::Length(1), // Footer bar
      ])
      .split(frame.area());

   draw_header(frame, app, &theme, outer_chunks[0]);
   draw_search_bar(frame, app, outer_chunks[1]);
   draw_main_body(frame, app, &theme, outer_chunks[2]);
   draw_footer(frame, app, &theme, outer_chunks[3]);

   // Draw help modal overlay if active (must be last to overlay everything)
   if app.show_help() {
      draw_help_modal(frame, app, &theme);
   }

   // Place cursor in search bar when in search mode (and help is not showing)
   if app.input_mode() == InputMode::Search && !app.show_help() {
      // Cursor position: inside the search block (1 char border + 1 char padding + cursor_position)
      frame.set_cursor_position((outer_chunks[1].x + 2 + app.cursor_position() as u16, outer_chunks[1].y + 1));
   }
}