konoma 0.4.0

// `?` ヘルプ: 全キーバインドの一覧オーバーレイ (発見性の最終手段)。
// tui-design 規約「フッターは数個だけ常時表示、全部は ? の裏」に対応。
// 中央にボーダー付きポップアップを出し、下地は Clear で消す。設定キー(コピー等)を反映。

use crossterm::event::KeyCode;
use ratatui::layout::{Alignment, Rect};
use ratatui::style::{Modifier, Style, Stylize};
use ratatui::text::{Line, Span};
use ratatui::widgets::{Block, Clear, Paragraph};
use ratatui::Frame;

use crate::app::{App, Mode};
use crate::i18n::tr;
use crate::keymap::{KeyPress, LeaderId};

/// One help section = heading + a sequence of "key notation / description" rows. Each view builds and returns this.
/// Assembled with the `HelpSection::new(title).row(key, desc).row(...)` builder.
pub struct HelpSection {
    pub title: String,
    pub rows: Vec<(String, String)>,
}

impl HelpSection {
    pub fn new(title: impl Into<String>) -> Self {
        Self {
            title: title.into(),
            rows: Vec::new(),
        }
    }
    pub fn row(mut self, key: impl Into<String>, desc: impl Into<String>) -> Self {
        self.rows.push((key.into(), desc.into()));
        self
    }
}

/// Help body (lines). **View-specific sections are owned by each view** (`tree`/`preview`). Here we just gather the active
/// view's sections + the common ones (Tabs/Copy/Global) and format them into a Line sequence. Reflects configured keys and language.
pub fn help_lines(app: &App) -> Vec<Line<'static>> {
    // Git オーバーレイ(o/L/G/b/詳細)が前面なら、その git 用節を出す(mode は裏で Tree/Preview のまま
    // なので mode 分岐だと git キーが出ない=今回の不具合)。それ以外は通常モードの節。
    let git_active = app.is_git_view()
        || app.is_git_log()
        || app.is_git_graph()
        || app.is_git_branches()
        || app.is_git_detail();
    let mut sections = if git_active {
        crate::ui::git::help_sections(app)
    } else {
        match app.mode {
            Mode::Tree => crate::ui::tree::help_sections(app),
            Mode::Preview => crate::ui::preview::help_sections(app),
        }
    };
    sections.extend(common_sections(app));
    render_sections(&sections)
}

/// Turn the sections into a Line sequence. Heading = bold underline, row = "  key (16-wide) description (dim)", with blank lines between.
fn render_sections(sections: &[HelpSection]) -> Vec<Line<'static>> {
    let mut out: Vec<Line<'static>> = Vec::new();
    for sec in sections {
        if !out.is_empty() {
            out.push(Line::from(""));
        }
        out.push(Line::from(
            Span::from(sec.title.clone())
                .add_modifier(Modifier::BOLD)
                .underlined(),
        ));
        for (key, desc) in &sec.rows {
            out.push(Line::from(vec![
                Span::from(format!("  {key:<16}")).bold(),
                Span::from(desc.clone()).dim(),
            ]));
        }
    }
    out
}

/// Build the help section for one leader (`y`/`Space`) from the actual keymap (with config applied).
/// `prefix` is the trigger-key string to display (e.g. "y" / "Space"). Each view reuses this for the File/Copy sections.
pub fn leader_section(app: &App, id: LeaderId, prefix: &str) -> Option<HelpSection> {
    let menu = app.keymaps.leaders.get(&id)?;
    let title = tr(app.lang, menu.title);
    let mut sec = HelpSection::new(title.to_string());
    for it in &menu.items {
        let label = tr(app.lang, it.label);
        sec = sec.row(
            format!("{prefix} {}", leader_key_str(it.key)),
            label.to_string(),
        );
    }
    Some(sec)
}

/// Turn a leader's suffix key into a display string (handles Space/modifiers/special keys).
fn leader_key_str(kp: KeyPress) -> String {
    let base = match kp.code {
        KeyCode::Char(' ') => "Space".to_string(),
        KeyCode::Char(c) => c.to_string(),
        KeyCode::Enter => "Enter".to_string(),
        KeyCode::Tab => "Tab".to_string(),
        other => format!("{other:?}"),
    };
    if kp.ctrl {
        format!("Ctrl-{base}")
    } else {
        base
    }
}

/// Common operations that work in any mode (tabs, path copy, common keys). The copy keys reflect the config.
fn common_sections(app: &App) -> Vec<HelpSection> {
    let lang = app.lang;
    let l = |m| tr(lang, m);
    let mut out = vec![HelpSection::new(l(crate::i18n::Msg::HelpTabs))
        .row("t", l(crate::i18n::Msg::HelpNewTab))
        .row("w", l(crate::i18n::Msg::CloseTab))
        .row("[ / ]", l(crate::i18n::Msg::PrevNextTab))
        .row("1 - 9", l(crate::i18n::Msg::HelpJumpTab))];
    // パスコピーは `y` リーダー(設定反映済み)から。タイトルは "Copy path"。
    if let Some(sec) = leader_section(app, LeaderId::Copy, "y") {
        out.push(sec);
    }
    out.push(
        HelpSection::new(l(crate::i18n::Msg::HelpGlobal))
            .row("p", l(crate::i18n::Msg::CyclePathStyle))
            .row("?", l(crate::i18n::Msg::ToggleHelp))
            .row("q", l(crate::i18n::Msg::QuitOrCloseTab))
            .row("Q", l(crate::i18n::Msg::Quit)),
    );
    out
}

/// Render the full key list in a centered popup. `area` is the whole screen.
pub fn render(frame: &mut Frame, app: &App, area: Rect) {
    let lines = help_lines(app);
    // ポップアップの大きさ: 幅は最大66、画面に収める。高さは内容＋枠、画面に収める。
    let w = 66.min(area.width.saturating_sub(2)).max(20);
    let h = (lines.len() as u16 + 2)
        .min(area.height.saturating_sub(2))
        .max(3);
    let x = area.x + (area.width.saturating_sub(w)) / 2;
    let y = area.y + (area.height.saturating_sub(h)) / 2;
    let popup = Rect {
        x,
        y,
        width: w,
        height: h,
    };

    // 本文の縦スクロールを内側高さでクランプ。
    let inner_h = h.saturating_sub(2);
    let max_scroll = (lines.len() as u16).saturating_sub(inner_h);
    let scroll = app.help_scroll.min(max_scroll);

    let title = tr(app.lang, crate::i18n::Msg::HelpTitle);
    let block = Block::bordered()
        .title(title)
        .border_style(Style::new().fg(ratatui::style::Color::Cyan));
    let para = Paragraph::new(lines)
        .block(block)
        .scroll((scroll, 0))
        .alignment(Alignment::Left);

    frame.render_widget(Clear, popup); // 下地を消してから描く
    frame.render_widget(para, popup);
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::app::{App, Mode};
    use crate::config::Config;

    /// Flatten help_lines into a single string (to inspect section/row text).
    fn text(app: &App) -> String {
        help_lines(app)
            .iter()
            .map(|line| {
                line.spans
                    .iter()
                    .map(|s| s.content.as_ref())
                    .collect::<String>()
            })
            .collect::<Vec<_>>()
            .join("\n")
    }

    fn app() -> App {
        let dir = std::env::temp_dir().join("konoma_help_lines_test");
        std::fs::create_dir_all(&dir).unwrap();
        App::new(dir, Config::default()).unwrap()
    }

    #[test]
    fn help_is_mode_specific() {
        // Tree: ツリー操作と git マーカーを出し、プレビュー専用節は出さない。
        let mut a = app();
        let tree = text(&a);
        assert!(tree.contains("Tree"), "Tree 節");
        assert!(tree.contains("Git status"), "Git 節");
        assert!(!tree.contains("zoom"), "画像節は出さない");
        assert!(
            !tree.contains("horizontal scroll"),
            "テキスト専用節は出さない"
        );
        // 共通節 (タブ/コピー/共通) はどのモードでも出る。
        assert!(
            tree.contains("Tabs") && tree.contains("Copy") && tree.contains("Global"),
            "共通節"
        );

        // テキストプレビュー (画像でない Preview): テキスト節のみ。Tree/Git/画像は出さない。
        a.mode = Mode::Preview;
        let txt = text(&a);
        assert!(txt.contains("Preview: text"), "テキスト節");
        assert!(txt.contains("horizontal scroll"), "横スクロール行");
        assert!(
            !txt.contains("Git status (row markers)") && !txt.contains("zoom"),
            "Tree/画像専用節は出さない"
        );
        // スクロール行は矢印付き表記 (h/l/← → 行に揃える #3)。
        assert!(txt.contains("j / k / ↑ ↓"), "矢印付きスクロール行");
        // 共通のタブ節は残る (Preview 中もタブ操作可)。
        assert!(txt.contains("Tabs"), "Preview でも共通タブ節");
    }
}