debtmap 0.17.0

Code complexity and technical debt analyzer
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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

//! Layout utilities and help overlay.

use super::app::ResultsApp;
use crate::tui::theme::Theme;
use ratatui::{
    layout::Rect,
    style::{Modifier, Style},
    text::{Line, Span},
    widgets::{Block, Borders, Clear, Paragraph},
    Frame,
};

/// Render help overlay
pub fn render_help_overlay(frame: &mut Frame, app: &ResultsApp) {
    let theme = Theme::default();

    // First render the list view underneath
    super::list_view::render(frame, app);

    // Calculate centered area for help overlay
    let area = frame.area();
    let help_area = centered_rect(60, 80, area);

    // Clear the area first
    frame.render_widget(Clear, help_area);

    // Create help content
    let help_text = vec![
        Line::from(vec![Span::styled(
            "KEYBOARD SHORTCUTS",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::BOLD),
        )]),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Navigation",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  ↑/k         Move up"),
        Line::from("  ↓/j         Move down"),
        Line::from("  g           Go to top"),
        Line::from("  G           Go to bottom"),
        Line::from("  PgUp/PgDn   Page up/down"),
        Line::from("  Enter/l/→   View details"),
        Line::from("  Esc         Back/Cancel"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Search & Filter",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  /           Search"),
        Line::from("  s           Sort menu"),
        Line::from("  f           Filter menu"),
        Line::from("  u           Group/Ungroup locations"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Actions",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  c           Copy path (list) / current page (detail)"),
        Line::from("  C           Copy selected item as LLM markdown"),
        Line::from("  e/o         Open in editor"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Detail View",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  Esc/q/h/⌫   Back to list"),
        Line::from("  ←/BackTab   Previous page"),
        Line::from("  →/Tab/l     Next page"),
        Line::from("  1-8         Jump to page"),
        Line::from("  ↑↓/jk       Next/prev item"),
        Line::from("  c           Copy current detail page"),
        Line::from("  C           Copy full item as LLM markdown"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Content Scrolling (Detail View)",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  Ctrl+D/U    Scroll half page down/up"),
        Line::from("  Ctrl+F/B    Scroll full page down/up"),
        Line::from("  PgDn/PgUp   Scroll full page"),
        Line::from("  g/G         Jump to top/bottom"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "General",
            Style::default()
                .fg(theme.accent())
                .add_modifier(Modifier::UNDERLINED),
        )]),
        Line::from("  ?           This help"),
        Line::from("  q           Quit"),
        Line::from("  Ctrl+C      Force quit"),
        Line::from(""),
        Line::from(vec![Span::styled(
            "Press any key to close",
            Style::default().fg(theme.muted),
        )]),
    ];

    let help = Paragraph::new(help_text).block(
        Block::default()
            .borders(Borders::ALL)
            .title("Help")
            .border_style(Style::default().fg(theme.accent())),
    );

    frame.render_widget(help, help_area);
}

/// Create a centered rectangle
fn centered_rect(percent_x: u16, percent_y: u16, r: Rect) -> Rect {
    let popup_layout = ratatui::layout::Layout::default()
        .direction(ratatui::layout::Direction::Vertical)
        .constraints([
            ratatui::layout::Constraint::Percentage((100 - percent_y) / 2),
            ratatui::layout::Constraint::Percentage(percent_y),
            ratatui::layout::Constraint::Percentage((100 - percent_y) / 2),
        ])
        .split(r);

    ratatui::layout::Layout::default()
        .direction(ratatui::layout::Direction::Horizontal)
        .constraints([
            ratatui::layout::Constraint::Percentage((100 - percent_x) / 2),
            ratatui::layout::Constraint::Percentage(percent_x),
            ratatui::layout::Constraint::Percentage((100 - percent_x) / 2),
        ])
        .split(popup_layout[1])[1]
}