jiq 2.21.1

Interactive JSON query tool with real-time output
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

//! Help popup rendering
//!
//! This module handles rendering of the help popup modal with keyboard shortcuts.

use ratatui::{
    Frame,
    style::{Color, Modifier, Style},
    text::{Line, Span, Text},
    widgets::{Block, Borders, Paragraph},
};

use crate::app::App;
use crate::help::{HELP_ENTRIES, HELP_FOOTER};
use crate::widgets::popup;

// Help popup display constants
pub const HELP_POPUP_WIDTH: u16 = 70;
pub const HELP_POPUP_PADDING: u16 = 4; // borders (2) + footer (2)

/// Render the help popup (centered modal with keyboard shortcuts)
pub fn render_popup(app: &mut App, frame: &mut Frame) {
    // Calculate popup dimensions
    let content_height = HELP_ENTRIES.len() as u16;
    let ideal_popup_height = content_height + HELP_POPUP_PADDING;
    let ideal_popup_width = HELP_POPUP_WIDTH;

    // Clamp dimensions to fit within the frame
    let frame_area = frame.area();
    let popup_width = ideal_popup_width.min(frame_area.width);
    let popup_height = ideal_popup_height.min(frame_area.height);

    // Don't render if terminal is too small
    if frame_area.width < 20 || frame_area.height < 10 {
        return;
    }

    // Center the popup
    let popup_area = popup::centered_popup(frame_area, popup_width, popup_height);

    // Clear the background for floating effect
    popup::clear_area(frame, popup_area);

    // Create help text with proper formatting
    let mut lines: Vec<Line> = Vec::new();

    for (key, desc) in HELP_ENTRIES {
        if key.is_empty() && desc.is_empty() {
            // Empty line for spacing
            lines.push(Line::from(""));
        } else if key.is_empty() {
            // Category header (bold, cyan)
            lines.push(Line::from(vec![
                Span::raw("  "),
                Span::styled(
                    *desc,
                    Style::default()
                        .fg(Color::Cyan)
                        .add_modifier(Modifier::BOLD),
                ),
            ]));
        } else {
            // Key-description pair
            let key_span = Span::styled(
                format!("  {:<15}", key),
                Style::default()
                    .fg(Color::Yellow)
                    .add_modifier(Modifier::BOLD),
            );
            let desc_span = Span::styled(*desc, Style::default().fg(Color::White));
            lines.push(Line::from(vec![key_span, desc_span]));
        }
    }

    // Add footer
    lines.push(Line::from(""));
    lines.push(Line::from(vec![Span::styled(
        format!("           {}          ", HELP_FOOTER),
        Style::default().fg(Color::DarkGray),
    )]));

    let help_text = Text::from(lines.clone());

    // Update scroll bounds based on content and viewport
    let content_height = lines.len() as u32;
    let visible_height = popup_height.saturating_sub(2); // -2 for borders
    app.help
        .scroll
        .update_bounds(content_height, visible_height);

    // Create the popup widget with scroll
    let popup = Paragraph::new(help_text)
        .block(
            Block::default()
                .borders(Borders::ALL)
                .title(" Keyboard Shortcuts ")
                .border_style(Style::default().fg(Color::Cyan))
                .style(Style::default().bg(Color::Black)),
        )
        .scroll((app.help.scroll.offset, 0));

    frame.render_widget(popup, popup_area);
}