use ratatui::{
layout::{Alignment, Constraint, Direction, Layout, Rect},
style::{Color, Modifier, Style},
text::{Line, Span},
widgets::{Clear, Paragraph},
Frame,
};
use crate::keybindings::{format_key_for_display, BindingContext, KeybindingsConfig};
use crate::ui::theme;
pub fn render_help(f: &mut Frame, keybindings: &KeybindingsConfig) {
let area = centered_rect(50, 60, f.area());
let context = BindingContext::Default;
let get_key = |action: &str, default: &str| -> String {
keybindings
.get_first_keybinding(action, context)
.map(|k| format_key_for_display(&k))
.unwrap_or_else(|| default.to_string())
};
let next_panel = get_key("navigation.next_panel", "Tab");
let prev_panel = get_key("navigation.prev_panel", "⇧Tab");
let next_item = get_key("navigation.next_item", "↓");
let prev_item = get_key("navigation.prev_item", "↑");
let search = get_key("search.start", "/");
let palette = get_key("connection.palette.toggle", "^O");
let new_conn = get_key("connection.form.open", "^N");
let tab_next = get_key("connection.tab.next", "^→");
let tab_prev = get_key("connection.tab.prev", "^←");
let resize_left = get_key("pane.resize.left", "^H");
let resize_right = get_key("pane.resize.right", "^L");
let help = get_key("help.toggle", "?");
let quit = get_key("quit.show", "Q");
let help_sections: Vec<(&str, Vec<(&str, String)>)> = vec![
(
"Navigation",
vec![
("Switch panels", format!("{} {}", next_panel, prev_panel)),
("Move up/down", format!("{} {}", prev_item, next_item)),
("Search keys", search),
],
),
(
"Connections",
vec![
("Connection palette", palette),
("New connection", new_conn),
("Switch tabs", format!("{} {}", tab_prev, tab_next)),
],
),
(
"Panes",
vec![
("Resize panes", format!("{} {}", resize_left, resize_right)),
("Mouse resize", "drag border".to_string()),
],
),
("General", vec![("Toggle help", help), ("Quit", quit)]),
];
let inner = Rect {
x: area.x + 2,
y: area.y + 2,
width: area.width.saturating_sub(4),
height: area.height.saturating_sub(3),
};
let block = theme::glass_block("Help");
f.render_widget(Clear, area);
f.render_widget(block, area);
let title = Paragraph::new(Span::styled(
"Keyboard Shortcuts",
Style::default()
.fg(theme::NEON_CYAN())
.add_modifier(Modifier::BOLD),
))
.alignment(Alignment::Center);
let title_area = Rect {
x: inner.x,
y: inner.y,
width: inner.width,
height: 1,
};
f.render_widget(title, title_area);
let mut y_offset = 2u16;
for (section_name, bindings) in help_sections {
let section_y = inner.y + y_offset;
if section_y >= inner.y + inner.height {
break;
}
let section_header = Paragraph::new(Span::styled(
section_name,
Style::default()
.fg(theme::NEON_AMBER())
.add_modifier(Modifier::BOLD),
));
f.render_widget(
section_header,
Rect {
x: inner.x + 2,
y: section_y,
width: inner.width.saturating_sub(4),
height: 1,
},
);
y_offset += 1;
for (desc, key) in bindings {
let binding_y = inner.y + y_offset;
if binding_y >= inner.y + inner.height.saturating_sub(1) {
break;
}
let line_width = inner.width.saturating_sub(10) as usize;
let desc_len = desc.chars().count();
let key_len = key.chars().count();
let fill_len = line_width.saturating_sub(desc_len + key_len);
let fill = if fill_len > 2 {
format!(" {} ", ".".repeat(fill_len - 2))
} else {
" ".repeat(fill_len)
};
let line = Line::from(vec![
Span::styled(desc, Style::default().fg(theme::TEXT_DIM())),
Span::styled(fill, Style::default().fg(Color::Rgb(55, 60, 70))),
Span::styled(&key, Style::default().fg(theme::NEON_CYAN())),
]);
let line_widget = Paragraph::new(line);
f.render_widget(
line_widget,
Rect {
x: inner.x + 4,
y: binding_y,
width: inner.width.saturating_sub(6),
height: 1,
},
);
y_offset += 1;
}
y_offset += 1; }
let footer_y = inner.y + inner.height.saturating_sub(1);
let footer = Paragraph::new(Span::styled(
"Press any key to close",
Style::default()
.fg(theme::TEXT_DIM())
.add_modifier(Modifier::ITALIC),
))
.alignment(Alignment::Center);
f.render_widget(
footer,
Rect {
x: inner.x,
y: footer_y,
width: inner.width,
height: 1,
},
);
}
fn centered_rect(percent_x: u16, percent_y: u16, r: Rect) -> Rect {
let popup_layout = Layout::default()
.direction(Direction::Vertical)
.constraints([
Constraint::Percentage((100 - percent_y) / 2),
Constraint::Percentage(percent_y),
Constraint::Percentage((100 - percent_y) / 2),
])
.split(r);
Layout::default()
.direction(Direction::Horizontal)
.constraints([
Constraint::Percentage((100 - percent_x) / 2),
Constraint::Percentage(percent_x),
Constraint::Percentage((100 - percent_x) / 2),
])
.split(popup_layout[1])[1]
}