mnml-rs 0.2.14

//! Help overlay renderer. Paints the rows produced by
//! `app::help::build_help` — section headers, then rows of
//! `<keys-column>  <title>`. Scrollable when the list exceeds the
//! overlay's body height.
//!
//! Mirrors the visual language of the Settings overlay: centered,
//! bordered, blue title chip.

use ratatui::Frame;
use ratatui::layout::Rect;
use ratatui::style::{Modifier, Style};
use ratatui::text::{Line, Span};
use ratatui::widgets::{Clear, Paragraph};

use crate::app::App;
use crate::app::help::{HelpRow, build_help};
use crate::ui::theme;

fn overlay_rect(parent: Rect) -> Rect {
    let w = ((parent.width as f32) * 0.7) as u16;
    let w = w.clamp(70, 140).min(parent.width.saturating_sub(4));
    let h = ((parent.height as f32) * 0.8) as u16;
    let h = h.clamp(20, 60).min(parent.height.saturating_sub(4));
    Rect {
        x: parent.x + (parent.width.saturating_sub(w)) / 2,
        y: parent.y + (parent.height.saturating_sub(h)) / 2,
        width: w,
        height: h,
    }
}

pub fn draw(frame: &mut Frame, app: &mut App, parent: Rect) {
    if app.help_overlay.is_none() {
        return;
    }
    let area = overlay_rect(parent);
    let t = theme::cur();

    frame.render_widget(Clear, area);

    let block = crate::ui::design_tokens::modal_panel("Help");
    let inner = block.inner(area);
    frame.render_widget(block, area);

    let rows = build_help(&app.keymap);
    let scroll = app.help_overlay.as_ref().map(|s| s.scroll).unwrap_or(0);
    let collapsed: std::collections::HashSet<String> = app
        .help_overlay
        .as_ref()
        .map(|s| s.collapsed.clone())
        .unwrap_or_default();
    // #polish 2026-07-06 — filter state.
    let query = app
        .help_overlay
        .as_ref()
        .map(|s| s.query.clone())
        .unwrap_or_default();
    let filter_focused = app
        .help_overlay
        .as_ref()
        .map(|s| s.filter_focused)
        .unwrap_or(false);
    let query_lc = query.to_ascii_lowercase();
    app.rects.help_section_headers.clear();

    // Compute key-column width — wide enough for the widest chord
    // string in the visible window, capped so the title column stays
    // readable on narrow terminals.
    let key_col_w: usize = rows
        .iter()
        .filter_map(|r| match r {
            HelpRow::Binding { keys, .. } => Some(keys.len()),
            _ => None,
        })
        .max()
        .unwrap_or(8)
        .clamp(8, 20);

    // #polish 2026-07-06 — pre-count bindings per section so
    // collapsed headers can show `(N)` instead of just the name.
    // First pass builds the map; second pass renders using it.
    let mut section_counts: std::collections::HashMap<String, usize> =
        std::collections::HashMap::new();
    {
        let mut cur: Option<String> = None;
        for row in &rows {
            match row {
                HelpRow::Section(name) => {
                    cur = Some(name.to_string());
                    section_counts.entry(name.to_string()).or_insert(0);
                }
                HelpRow::Binding { .. } => {
                    if let Some(n) = cur.as_ref() {
                        *section_counts.entry(n.clone()).or_insert(0) += 1;
                    }
                }
            }
        }
    }
    // Two-pass build so we can drop binding rows for collapsed
    // sections AND track which section each line corresponds to
    // (for click hit-testing).
    let mut lines: Vec<Line<'static>> = Vec::with_capacity(rows.len());
    // Section name for each *visible* line — `None` for binding
    // rows (only header rows are clickable).
    let mut header_names: Vec<Option<String>> = Vec::with_capacity(rows.len());
    let mut current_section: Option<String> = None;
    let mut section_collapsed = false;
    // #polish 2026-07-06 — with a live query, collect matching
    // binding rows per section first so we can skip sections
    // that have no matches (a bare header row alone is noise).
    let mut kept_per_section: std::collections::HashMap<String, Vec<&HelpRow>> =
        std::collections::HashMap::new();
    if !query_lc.is_empty() {
        let mut cur: Option<&str> = None;
        for row in &rows {
            match row {
                HelpRow::Section(name) => cur = Some(*name),
                HelpRow::Binding { keys, title } => {
                    let hay = format!("{keys} {title}").to_ascii_lowercase();
                    if hay.contains(&query_lc)
                        && let Some(sec) = cur
                    {
                        kept_per_section
                            .entry(sec.to_string())
                            .or_default()
                            .push(row);
                    }
                }
            }
        }
    }
    for row in &rows {
        match row {
            HelpRow::Section(name) => {
                current_section = Some(name.to_string());
                section_collapsed = collapsed.contains(*name);
                // Filter mode: skip sections with no matches; ignore
                // the collapsed flag so users see all hits at once.
                if !query_lc.is_empty() {
                    if !kept_per_section.contains_key(*name) {
                        continue;
                    }
                    section_collapsed = false;
                }
                let chev = if section_collapsed { "▸" } else { "▾" };
                let count = if query_lc.is_empty() {
                    section_counts.get(*name).copied().unwrap_or(0)
                } else {
                    kept_per_section.get(*name).map(|v| v.len()).unwrap_or(0)
                };
                let text = format!("{chev} ── {name} ── ({count})");
                lines.push(Line::from(Span::styled(
                    text,
                    Style::default()
                        .fg(t.comment)
                        .add_modifier(Modifier::BOLD | Modifier::DIM),
                )));
                header_names.push(Some(name.to_string()));
            }
            HelpRow::Binding { keys, title, .. } => {
                if section_collapsed {
                    continue;
                }
                // In filter mode: only render rows that survived the
                // per-section keep list. Everything above ensures the
                // section header itself is present.
                if !query_lc.is_empty() {
                    let hay = format!("{keys} {title}").to_ascii_lowercase();
                    if !hay.contains(&query_lc) {
                        continue;
                    }
                }
                let kc = if keys.is_empty() { "·" } else { keys.as_str() };
                let pad = key_col_w.saturating_sub(kc.chars().count());
                lines.push(Line::from(vec![
                    Span::styled(format!("  {}", kc), Style::default().fg(t.cyan)),
                    Span::raw(" ".repeat(pad + 2)),
                    Span::styled((*title).to_string(), Style::default().fg(t.fg)),
                ]));
                header_names.push(None);
            }
        }
    }
    // Filter-mode empty state.
    if !query_lc.is_empty() && kept_per_section.is_empty() {
        lines.push(Line::from(Span::styled(
            format!("  no bindings match \"{query}\""),
            Style::default().fg(t.comment).add_modifier(Modifier::DIM),
        )));
        header_names.push(None);
    }
    let _ = current_section;

    // #polish 2026-07-06 — filter input row at the top. Always
    // renders (empty state hints at `/` to focus). Cursor is
    // NOT painted here (we don't have caret plumbing for the
    // overlay); users see the query text and know they can type.
    let filter_prompt = if filter_focused {
        format!(" /{query}")
    } else if query.is_empty() {
        " / filter…".to_string()
    } else {
        format!(" filter: {query}   (/ to edit)")
    };
    let filter_style = if filter_focused {
        Style::default().fg(t.yellow).add_modifier(Modifier::BOLD)
    } else {
        Style::default().fg(t.comment).add_modifier(Modifier::DIM)
    };
    let filter_rect = Rect {
        x: inner.x,
        y: inner.y,
        width: inner.width,
        height: 1,
    };
    frame.render_widget(
        Paragraph::new(Span::styled(filter_prompt, filter_style)),
        filter_rect,
    );
    // Scroll-window: reserve 1 row for the filter + 1 for the hint bar.
    let body_h = (inner.height as usize).saturating_sub(2);
    let max_scroll = lines.len().saturating_sub(body_h);
    let scroll = scroll.min(max_scroll);
    let window: Vec<Line<'static>> = lines.iter().skip(scroll).take(body_h).cloned().collect();
    // #1098 (2026-08-20) — reserve rightmost cell for a scrollbar
    // when content overflows, so users can see there's more without
    // scrolling to hit the end. Body width shrinks by 1 in that case.
    let needs_scrollbar = lines.len() > body_h;
    let body_width = if needs_scrollbar {
        inner.width.saturating_sub(1)
    } else {
        inner.width
    };
    let body_rect = Rect {
        x: inner.x,
        y: inner.y + 1,
        width: body_width,
        height: body_h as u16,
    };
    frame.render_widget(Paragraph::new(window), body_rect);
    if needs_scrollbar {
        let sb_area = Rect {
            x: inner.x + inner.width.saturating_sub(1),
            y: inner.y + 1,
            width: 1,
            height: body_h as u16,
        };
        crate::ui::scrollbar::paint_simple_scrollbar(
            frame,
            sb_area,
            &t,
            lines.len(),
            body_h,
            scroll,
        );
    }

    // Register click rects for visible section headers.
    for (visible_idx, header_name) in header_names.iter().skip(scroll).take(body_h).enumerate() {
        if let Some(name) = header_name {
            let row_rect = Rect {
                x: inner.x,
                y: inner.y + 1 + visible_idx as u16,
                width: inner.width,
                height: 1,
            };
            app.rects
                .help_section_headers
                .push((row_rect, name.clone()));
        }
    }

    let hint = if filter_focused {
        "typing… · Enter/Esc leave input · Backspace edit"
    } else {
        "/ filter · j/k scroll · PageUp/Down faster · c/e collapse/expand · Esc close"
    };
    let hint_rect = Rect {
        x: inner.x,
        y: inner.y + inner.height.saturating_sub(1),
        width: inner.width,
        height: 1,
    };
    frame.render_widget(
        Paragraph::new(Span::styled(
            hint,
            Style::default().fg(t.comment).add_modifier(Modifier::DIM),
        )),
        hint_rect,
    );
}