rootle 0.8.1

//! Frame-level verification with ratatui's TestBackend (see
//! .agents/skills/rootle-tui-debug): renders the app to a Buffer and
//! asserts on visible text — including that closing a popup leaves
//! no lingering cells.

use ratatui::Terminal;
use ratatui::backend::TestBackend;
use ratatui::crossterm::event::{KeyCode, KeyEvent, KeyEventKind, KeyEventState, KeyModifiers};
use rootle::app::App;

fn key(code: KeyCode) -> KeyEvent {
    KeyEvent {
        code,
        modifiers: KeyModifiers::NONE,
        kind: KeyEventKind::Press,
        state: KeyEventState::NONE,
    }
}

fn test_app() -> App {
    app_with_orgs(&[])
}

/// Offline app whose orgs pane is seeded (the offline provider ships
/// no defaults — tests state them explicitly).
fn app_with_orgs(orgs: &[&str]) -> App {
    let (tx, _rx) = rootle::event::channel();
    App::with(
        rootle::state::State {
            recent_orgs: orgs.iter().map(|o| o.to_string()).collect(),
            ..Default::default()
        },
        tx,
    )
}

/// Fake recursive tree for ratatui/ratatui (mirrors the old mock buckets).
fn ratatui_tree() -> Vec<rootle::provider::TreeNode> {
    fn node(path: &str, is_dir: bool) -> rootle::provider::TreeNode {
        rootle::provider::TreeNode {
            path: path.into(),
            is_dir,
            sha: "abc1234def5678".into(),
            size: if is_dir { None } else { Some(42) },
        }
    }
    vec![
        node("src", true),
        node("docs", true),
        node("examples", true),
        node("Cargo.toml", false),
        node("README.md", false),
        node("LICENSE", false),
        node("src/widgets", true),
        node("src/layout", true),
        node("src/lib.rs", false),
        node("src/terminal.rs", false),
        node("src/malformed.bin", false),
        node("src/widgets/mod.rs", false),
        node("src/widgets/block.rs", false),
        node("src/widgets/paragraph.rs", false),
    ]
}

/// Popup closed, ratatui org repos + repo tree loaded (offline —
/// injected, no workers). Lands focused on the repos pane.
fn browsing_app() -> App {
    let mut app = app_with_orgs(&["ratatui", "tokio-rs", "helix-editor"]);
    app.handle_key(key(KeyCode::Esc));
    // No seeded orgs with the offline provider — select explicitly so
    // the repos/tree injections below pass the selection gates.
    app.handle_action(rootle::action::Action::OrgSelected("ratatui".into()));
    app.handle_action(rootle::action::Action::OrgReposLoaded {
        org: "ratatui".into(),
        repos: vec![
            "ratatui".into(),
            "ratatui-website".into(),
            "templates".into(),
            "comfy-table".into(),
        ],
    });
    app.handle_action(rootle::action::Action::TreeLoaded {
        owner: "ratatui".into(),
        name: "ratatui".into(),
        entries: ratatui_tree(),
        truncated: false,
        branch: "main".into(),
    });
    // Tree arrival auto-enters the root pane; step back to the repos
    // pane — this helper models "browsing at repos level".
    app.handle_key(key(KeyCode::Char('h')));
    app
}
#[test]
fn filter_commit_triggers_blob_load_of_selected_file() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // drill into repo root
    // Live-filter to Cargo.toml, commit with Enter.
    app.handle_key(key(KeyCode::Char('/')));
    for c in "cargo.toml".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("loading"),
        "file meta/loading preview should show while blob is pending"
    );
    app.handle_key(key(KeyCode::Enter)); // commit filter
    // Blob fetch was requested; inject the response.
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: "abc1234def5678".into(),
        name: "Cargo.toml".into(),
        bytes: b"[package]\nname = \"ratatui\"\n".to_vec(),
    });
    let rows = render(&mut app, 100, 30);
    assert!(
        rows.join("\n").contains("[package]"),
        "highlighted blob should render after filter commit"
    );
}
fn render(app: &mut App, width: u16, height: u16) -> Vec<String> {
    let backend = TestBackend::new(width, height);
    let mut terminal = Terminal::new(backend).unwrap();
    terminal
        .draw(|f| {
            let area = f.area();
            app.render(f, area);
        })
        .unwrap();
    let buf = terminal.backend().buffer();
    (0..buf.area.height)
        .map(|y| {
            (0..buf.area.width)
                .map(|x| buf[(x, y)].symbol().to_string())
                .collect::<String>()
        })
        .collect()
}

#[test]
fn renders_three_panes_modeline_and_popup() {
    // Seeded orgs behind the popup; the popup itself opened via ␣ s
    // (auto-open happens only on a fresh state).
    let mut app = app_with_orgs(&["ratatui", "tokio-rs", "helix-editor"]);
    app.handle_action(rootle::action::Action::LeaderSearch);
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");

    // Launch: search popup is open over the browser.
    assert!(screen.contains("search offline"), "popup title missing");
    assert!(screen.contains("INSERT"), "should land in INSERT mode");
    assert!(screen.contains("tab focus"), "popup hint row missing");

    // Browser visible behind the popup: orgs column + repos column.
    assert!(screen.contains("orgs"), "orgs pane missing");
    assert!(screen.contains("ratatui/"), "repos pane missing");

    // Print the frame for eyeballing (cargo test -- --nocapture).
    println!("{screen}");
}

#[test]
fn popup_close_leaves_no_lingering_cells() {
    let mut app = test_app();
    let _ = render(&mut app, 100, 30); // popup open

    // Esc twice: INSERT → NORMAL → close popup.
    app.handle_key(key(KeyCode::Esc));
    app.handle_key(key(KeyCode::Esc));
    let after = render(&mut app, 100, 30);
    let screen = after.join("\n");

    assert!(
        !screen.contains("search github"),
        "popup residue after close"
    );
    assert!(screen.contains("BROWSE"), "should return to BROWSE");

    // The area where the popup was must show panes again, not blanks.
    let middle = &after[15];
    assert!(
        middle.contains('│') || middle.contains('╮') || middle.contains('╯'),
        "middle row lost pane borders after popup close"
    );
}

#[test]
fn resize_keeps_modeline_on_last_row() {
    let mut app = browsing_app(); // popup closed + org repos loaded
    for (w, h) in [(80, 24), (120, 40), (40, 10)] {
        let rows = render(&mut app, w, h);
        let last = rows.last().unwrap();
        assert!(
            last.contains("BROWSE"),
            "modeline missing on last row at {w}x{h}"
        );
    }
}

#[test]
fn searching_mode_filters_incrementally() {
    let mut app = browsing_app(); // popup closed + org repos loaded → repos pane
    app.handle_key(key(KeyCode::Char('/')));
    app.handle_key(key(KeyCode::Char('w'))); // "website"
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("SEARCH"));
    assert!(screen.contains("/w"), "filter not shown in pane title");
    assert!(screen.contains("ratatui-website"));
    assert!(
        !screen.contains("comfy-table"),
        "non-matching entry should be filtered out"
    );
}

#[test]
fn h_moves_focus_to_parent_and_browsing_it_cascades() {
    let mut app = browsing_app(); // popup closed + org repos loaded

    // Drill into a repo: focus is now on the repo's root dir column.
    app.handle_key(key(KeyCode::Char('l')));
    let rows = render(&mut app, 100, 30);
    assert!(
        rows.join("\n").contains("Cargo.toml"),
        "should see repo root"
    );

    // h: focus moves left into the repos column; j selects
    // ratatui-website. Repo trees arrive from the API — the child
    // column appears only when the tree lands.
    app.handle_key(key(KeyCode::Char('h')));
    app.handle_key(key(KeyCode::Char('j')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        !screen.contains("Cargo.toml"),
        "no child column before the tree arrives"
    );
    app.handle_action(rootle::action::Action::TreeLoaded {
        owner: "ratatui".into(),
        name: "ratatui-website".into(),
        entries: ratatui_tree(),
        truncated: false,
        branch: "main".into(),
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("Cargo.toml"),
        "child column should appear with the tree"
    );
    // h twice: root pane (auto-entered on tree load) → repos → orgs.
    // j picks tokio-rs. Org repos now arrive from the API — inject the
    // response (offline app never spawns workers).
    app.handle_key(key(KeyCode::Char('h')));
    app.handle_key(key(KeyCode::Char('h')));
    app.handle_key(key(KeyCode::Char('j')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(rows[0].ends_with('┐'), "orgs should fold to full width");
    assert!(
        !screen.contains("axum/"),
        "folded view hides the repos column"
    );

    // l on an org triggers LoadOrgRepos; the response installs the
    // repos level — no stale ratatui entries.
    app.handle_action(rootle::action::Action::OrgReposLoaded {
        org: "tokio-rs".into(),
        repos: vec![
            "tokio".into(),
            "axum".into(),
            "hyper".into(),
            "tracing".into(),
            "bytes".into(),
        ],
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("axum/"), "org switch should load repos");
    assert!(!screen.contains("comfy-table"), "stale child column leaked");
}

#[test]
fn drilling_into_dir_uses_correct_relative_path() {
    let mut app = browsing_app(); // popup closed + org repos loaded → repos pane
    app.handle_key(key(KeyCode::Char('l'))); // into ratatui root
    // Dirs sort alphabetically: docs/, examples/, src/ — j twice to src.
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Char('l'))); // into src/
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    // The src/ bucket: widgets/, layout/, lib.rs in the center pane.
    assert!(screen.contains("widgets/"), "src/ children missing");
    assert!(screen.contains("lib.rs"), "src/ children missing");
    // Hovering a file shows its blob meta (sha + size) until milestone 5.
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Char('j'))); // hover lib.rs
    let rows = render(&mut app, 100, 30);
    assert!(
        rows.join("\n").contains("blob abc1234"),
        "lib.rs blob meta missing after drilling into src/"
    );
}

/// plans/0016 M1a: `␣ b` opens the revision switcher (loading row
/// until refs land), the crumb live-previews the cursor's ref, Enter
/// commits and refetches, Esc reverts to the committed ref.
#[test]
fn refs_switcher_preview_commit_revert() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('b')));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("revisions"), "switcher missing:\n{screen}");
    assert!(
        screen.contains("loading revisions"),
        "loading row:\n{screen}"
    );

    app.handle_app_event(rootle::event::AppEvent::RefsLoaded {
        repo: "ratatui/ratatui".into(),
        refs: rootle::provider::RepoRefs {
            branches: vec![
                rootle::provider::RefInfo {
                    name: "main".into(),
                    sha: "a1b2c3d4".into(),
                    is_default: true,
                },
                rootle::provider::RefInfo {
                    name: "release/2.7".into(),
                    sha: "e4f5a6b7".into(),
                    is_default: false,
                },
            ],
            tags: vec![rootle::provider::RefInfo {
                name: "v0.7.1".into(),
                sha: "d4e5f6a7".into(),
                is_default: false,
            }],
        },
    });
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("(•) main"), "default radio:\n{screen}");
    assert!(
        screen.contains("release/2.7  e4f5a6b"),
        "branch row:\n{screen}"
    );
    assert!(screen.contains("tags"), "tags section:\n{screen}");

    // Live preview: j moves to release/2.7, the crumb follows.
    app.handle_key(key(KeyCode::Char('j')));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(
        screen.contains("@ release/2.7"),
        "crumb did not follow the cursor:\n{screen}"
    );

    // Enter commits: popup closes, the crumb keeps the ref.
    app.handle_key(key(KeyCode::Enter));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(!screen.contains("revisions —"), "popup should be closed");
    assert!(
        screen.contains("ratatui @ release/2.7"),
        "committed crumb:\n{screen}"
    );

    // Reopen and Esc: reverts to the committed ref.
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('b')));
    app.handle_app_event(rootle::event::AppEvent::RefsLoaded {
        repo: "ratatui/ratatui".into(),
        refs: rootle::provider::RepoRefs {
            branches: vec![rootle::provider::RefInfo {
                name: "main".into(),
                sha: "a1b2c3d4".into(),
                is_default: true,
            }],
            tags: vec![],
        },
    });
    app.handle_key(key(KeyCode::Char('k'))); // preview main
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(
        screen.contains("@ release/2.7"),
        "Esc must revert:\n{screen}"
    );
}

/// plans/0016 M1b/M1c: blame lens from real ranges, Enter opens the
/// history lens at the blamed commit, Enter again opens the file at
/// that commit, Esc unwinds to the present.
/// 0017 M3: a newer release lands the `↑` chip and a one-line status.
#[test]
fn update_notice_chips_in_the_modeline() {
    let mut app = browsing_app();
    app.handle_app_event(rootle::event::AppEvent::UpdateAvailable {
        tag: "v9.9.9".into(),
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("↑ v9.9.9"),
        "modeline chip missing:\n{screen}"
    );
    assert!(
        screen.contains("rootle v9.9.9 is out"),
        "status line missing:\n{screen}"
    );
}

#[test]
fn preview_submode_zoom_blame_history() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // into ratatui root
    for _ in 0..3 {
        app.handle_key(key(KeyCode::Char('j'))); // onto Cargo.toml
    }
    let sha = "abc1234def5678";
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: sha.into(),
        name: "Cargo.toml".into(),
        bytes: b"[package]\nname = \"ratatui\"\nversion = \"0.29\"\nauthors = []\n".to_vec(),
    });
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("[package]"), "preview shows the blob");

    // ␣ p: zoom — the columns vanish, the pane owns the keys.
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('p')));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(
        screen.contains("PREVIEW"),
        "preview chip missing:\n{screen}"
    );
    assert!(!screen.contains("docs/"), "columns must hide when zoomed");

    // b: blame fetches; marks render when ranges land.
    app.handle_key(key(KeyCode::Char('b')));
    app.handle_app_event(rootle::event::AppEvent::BlameLoaded {
        path: "Cargo.toml".into(),
        ranges: vec![
            rootle::provider::BlameRange {
                start_line: 1,
                end_line: 2,
                sha: "a1b2c3d4e5".into(),
                author: "tarek".into(),
                date: "2026-08-25".into(),
            },
            rootle::provider::BlameRange {
                start_line: 3,
                end_line: 4,
                sha: "c7d8e9f0a1".into(),
                author: "mira".into(),
                date: "2026-07-30".into(),
            },
        ],
    });
    let rows = render(&mut app, 140, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("a1b2c3d tarek"), "blame margin:\n{screen}");
    assert!(screen.contains("c7d8e9f mira"), "second run:\n{screen}");
    // The margin divider aligns across run starts and continuations.
    let divider_col = |row: &String| {
        row.chars()
            .enumerate()
            .filter(|(_, c)| *c == '│')
            .nth(1)
            .map(|(i, _)| i)
    };
    let run = rows.iter().find(|r| r.contains("a1b2c3d tarek")).unwrap();
    let cont = rows.iter().find(|r| r.contains('·')).unwrap();
    assert_eq!(
        divider_col(run),
        divider_col(cont),
        "blame divider misaligned:\n{screen}"
    );

    // Enter on a blame line: history lens at that commit (composition).
    app.handle_key(key(KeyCode::Enter));
    app.handle_app_event(rootle::event::AppEvent::LogLoaded {
        path: "Cargo.toml".into(),
        entries: vec![
            rootle::provider::LogEntry {
                sha: "c7d8e9f0a1b2".into(),
                subject: "refactor(Cargo.toml): extract".into(),
                author: "mira".into(),
                date: "2026-07-30".into(),
            },
            rootle::provider::LogEntry {
                sha: "a1b2c3d4e5f6".into(),
                subject: "feat: initial Cargo.toml".into(),
                author: "tarek".into(),
                date: "2026-06-11".into(),
            },
        ],
        truncated: false,
    });
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("HISTORY"), "history chip:\n{screen}");
    assert!(
        screen.contains("history — Cargo.toml"),
        "lens title:\n{screen}"
    );
    // The cursor line (1) blames to the initial commit — the lens
    // sits on its row.
    assert!(
        screen.contains("▌ a1b2c3d feat: initial Cargo.toml"),
        "lens must sit on the blamed commit:\n{screen}"
    );

    // Enter opens the file at the commit; Esc restores the present.
    app.handle_key(key(KeyCode::Enter));
    app.handle_app_event(rootle::event::AppEvent::BlobAtLoaded {
        path: "Cargo.toml".into(),
        ref_: "c7d8e9f0a1b2".into(),
        sha: "f00dbabe".into(),
        bytes: b"[package]\nname = \"ratatui-old\"\n".to_vec(),
    });
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("ratatui-old"), "commit content:\n{screen}");
    assert!(
        screen.contains("Cargo.toml @ c7d8e9f"),
        "commit marker:\n{screen}"
    );
    assert!(screen.contains("PREVIEW"), "back in the zoomed pane");
    // The regression from the demo: at-commit content highlights by
    // the real path — the "@ sha" marker has no known extension.
    // (Language evidence lives in e2e/test_revisions.py, where the
    // fixture file is real rust; syntect's fancy set has no TOML, so
    // this frame's footer honestly reads "text".)
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(
        screen.contains("name = \"ratatui\""),
        "Esc restores the present"
    );
    assert!(
        !screen.contains("Cargo.toml @"),
        "the marker must not stick after restore:\n{screen}"
    );
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(screen.contains("BROWSE"), "mode unwinds");
    assert!(screen.contains("docs/"), "columns restored");
}

#[test]
fn file_preview_shows_highlighted_blob_and_scrolls() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // into ratatui root
    // jj j to reach Cargo.toml (dirs docs/, examples/, src/ first)
    for _ in 0..3 {
        app.handle_key(key(KeyCode::Char('j')));
    }
    // Selection is on Cargo.toml → meta preview; inject the blob.
    let sha = "abc1234def5678";
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: sha.into(),
        name: "Cargo.toml".into(),
        bytes: b"[package]\nname = \"ratatui\"\nversion = \"0.29.0\"\n\n\n\n\n\n\n\n".to_vec(),
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("[package]"),
        "highlighted blob content missing from preview"
    );

    // J scrolls the preview down; K back up.
    app.handle_key(key(KeyCode::Char('J')));
    let rows_after = render(&mut app, 100, 30);
    assert_ne!(
        rows.join("\n"),
        rows_after.join("\n"),
        "J should scroll the preview"
    );
}

#[test]
fn preview_colors_dirs_and_files_differently() {
    use ratatui::style::{Color, Modifier};

    let mut app = browsing_app(); // popup closed + org repos loaded → repos pane, preview
    // shows ratatui's root listing
    let backend = TestBackend::new(100, 30);
    let mut terminal = Terminal::new(backend).unwrap();
    terminal
        .draw(|f| {
            let area = f.area();
            app.render(f, area);
        })
        .unwrap();
    let buf = terminal.backend().buffer();

    let blue = Color::from_u32(0x89b4fa);
    let text = Color::from_u32(0xcdd6f4);

    // Scan the right column (x ≥ 60) for a dir child and a file child,
    // matching exact cell sequences (the border glyph sits at x=60).
    let find = |pat: &str| -> Option<(u16, u16)> {
        let chars: Vec<char> = pat.chars().collect();
        for y in 0..buf.area.height {
            for x in 61..buf.area.width - chars.len() as u16 {
                if chars
                    .iter()
                    .enumerate()
                    .all(|(i, c)| buf[(x + i as u16, y)].symbol() == c.to_string())
                {
                    return Some((x, y));
                }
            }
        }
        None
    };

    let (x, y) = find("src/").expect("dir child src/ not found in preview");
    let cell = &buf[(x, y)];
    assert_eq!(cell.fg, blue, "directories in preview must be blue");
    assert!(
        cell.modifier.contains(Modifier::BOLD),
        "directories must be bold"
    );

    let (x, y) = find("Cargo.toml").expect("file child not found in preview");
    assert_eq!(buf[(x, y)].fg, text, "files in preview must use text color");
}

#[test]
fn org_level_folds_to_single_pane() {
    let mut app = browsing_app(); // popup closed + org repos loaded

    // h until focus reaches the orgs column (top level).
    app.handle_key(key(KeyCode::Char('h')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");

    // Single folded pane: orgs visible, no repo column border beside it.
    assert!(screen.contains("orgs"));
    assert!(screen.contains("tokio-rs/"));
    // A folded single pane spans nearly full width: orgs title starts at
    // the left edge and its right border sits at the far right.
    let top = &rows[0];
    assert!(top.starts_with('┌'), "folded pane should start at x=0");
    assert!(
        top.ends_with('┐'),
        "folded pane should reach the right edge"
    );
}

#[test]
fn popup_results_support_local_slash_filter() {
    let mut app = test_app();
    // Submit a query (offline: no worker spawned) and inject the
    // response — what the worker thread would send over the channel.
    app.handle_key(key(KeyCode::Enter));
    app.handle_action(rootle::action::Action::SearchResults {
        items: vec![
            rootle::provider::SearchItem::Org("tokio-rs".into()),
            rootle::provider::SearchItem::Repo("tokio-rs/tokio".into()),
            rootle::provider::SearchItem::Repo("ratatui/ratatui".into()),
            rootle::provider::SearchItem::Repo("sharkdp/bat".into()),
        ],
    });
    assert!(
        app.cursor_style().is_none(),
        "results focus: no text cursor"
    );

    // `/` in results → SEARCH chip, incremental local filter.
    app.handle_key(key(KeyCode::Char('/')));
    app.handle_key(key(KeyCode::Char('t')));
    app.handle_key(key(KeyCode::Char('o')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("SEARCH"),
        "filtering should show SEARCH chip"
    );
    assert!(screen.contains("tokio-rs/tokio"));
    assert!(
        !screen.contains("sharkdp/bat"),
        "non-matching result should be filtered out"
    );

    // Esc cancels the in-progress filter (restores full list).
    app.handle_key(key(KeyCode::Esc));
    let rows = render(&mut app, 100, 30);
    assert!(rows.join("\n").contains("sharkdp/bat"));
}

#[test]
fn leader_f_opens_find_view_and_enter_shows_mock_results() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('f')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");

    // Full-screen view: field row on top, results box below.
    assert!(screen.contains("find file"), "view title missing");
    assert!(screen.contains("query"), "query field missing");
    assert!(screen.contains("scope"), "scope field missing");
    assert!(screen.contains("extension"), "extension field missing");
    assert!(
        screen.contains("repo:ratatui/ratatui"),
        "scope label missing"
    );
    assert!(screen.contains("INSERT"), "query should land in INSERT");
    // The view replaces the browser: no miller columns underneath.
    assert!(!screen.contains("orgs"), "browser should be replaced");
    println!("{screen}");

    // Type a query, Enter runs the (mock) search and focuses results.
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("src/query/parser.rs"), "hit path missing");
    assert!(
        screen.contains("tests/query_roundtrip.rs"),
        "second hit missing"
    );
    assert!(
        screen.contains("pub fn parse(input: &str)"),
        "preview line missing"
    );
    assert!(screen.contains("BROWSE"), "results focus = BROWSE chip");
    println!("{screen}");
}

#[test]
fn leader_g_opens_grep_view_with_scope_radio_popup() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    let rows = render(&mut app, 100, 30);
    assert!(rows.join("\n").contains("grep"), "grep title missing");

    // Tab to the scope field, Enter opens the radio popup.
    app.handle_key(key(KeyCode::Tab));
    app.handle_key(key(KeyCode::Enter));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("(•) current repo"),
        "radio selected missing"
    );
    assert!(screen.contains("( ) current org"), "org option missing");
    assert!(screen.contains("( ) all of github"), "radio option missing");
    println!("{screen}");

    // j j → repo → org → all of github (radio follows the cursor),
    // Enter commits by closing; modeline context follows.
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Enter));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("global"), "scope should switch to global");
    assert!(screen.contains("grep · global"), "modeline context missing");
}

#[test]
fn closing_search_view_restores_browser_without_lingering_cells() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    let _ = render(&mut app, 100, 30); // view open

    // Esc from the query input: INSERT → NORMAL, then Esc closes.
    app.handle_key(key(KeyCode::Esc));
    app.handle_key(key(KeyCode::Esc));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(!screen.contains("grep ·"), "view residue after close");
    assert!(screen.contains("orgs"), "browser should be back");
    assert!(screen.contains("BROWSE"), "should return to BROWSE");

    // Middle of the screen must show pane content again, not blanks.
    let middle = &rows[15];
    assert!(
        middle.trim().len() > 10,
        "lingering blank cells after close: {middle:?}"
    );
}

#[test]
fn search_view_results_support_slash_filter() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter)); // submit → results focused

    app.handle_key(key(KeyCode::Char('/')));
    for c in "terminal".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("SEARCH"),
        "filtering should show SEARCH chip"
    );
    assert!(screen.contains("src/terminal.rs"));
    assert!(
        !screen.contains("src/widgets/list.rs"),
        "non-matching hit should be filtered out"
    );

    // Enter on the remaining hit expands its file; a second Enter
    // opens the editor on it (mock bytes).
    app.handle_key(key(KeyCode::Esc)); // Esc cancels filter → full list
    app.handle_key(key(KeyCode::Enter)); // expand the selected hit
    app.handle_key(key(KeyCode::Enter)); // open it in the editor
    assert!(
        app.take_editor_job().is_some(),
        "Enter on a hit should prepare an editor job"
    );
}

#[test]
fn search_view_previews_are_syntax_highlighted() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('f')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));

    let backend = TestBackend::new(100, 30);
    let mut terminal = Terminal::new(backend).unwrap();
    terminal
        .draw(|f| {
            let area = f.area();
            app.render(f, area);
        })
        .unwrap();
    let buf = terminal.backend().buffer();

    // Find the preview row with a Rust keyword and assert it carries
    // syntect RGB colors (plain text would render in the theme's
    // default text color, never Rgb).
    let row = (0..buf.area.height)
        .find(|&y| {
            (0..buf.area.width)
                .map(|x| buf[(x, y)].symbol())
                .collect::<String>()
                .contains("pub fn parse")
        })
        .expect("preview row should be visible");
    assert!(
        (0..buf.area.width).any(|x| matches!(buf[(x, row)].fg, ratatui::style::Color::Rgb(..))),
        "preview line should be syntax-highlighted"
    );
}

#[test]
fn keybinds_popup_walks_modes_and_closes_without_residue() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('?')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("keybindings"), "popup title missing");
    // Every mode's chip sits in the sidebar; BROWSE is active.
    assert!(screen.contains("BROWSE"), "browse chip missing");
    assert!(screen.contains("LEADER"), "leader chip missing");
    assert!(screen.contains("VISUAL"), "visual chip missing");
    println!("{screen}");

    // Tab walks the modes; the leader table renders its bindings.
    for _ in 0..5 {
        app.handle_key(key(KeyCode::Tab));
    }
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("clear marks"), "leader bindings missing");

    app.handle_key(key(KeyCode::Esc));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(!screen.contains("keybindings"), "popup residue after close");
    assert!(screen.contains("orgs"), "browser should be back");
}

#[test]
fn command_line_filters_and_runs_settings() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(':')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("settings"), "command option missing");
    assert!(screen.contains("clone"), "clone option missing");
    assert!(screen.contains("INSERT"), "command line is a text input");
    println!("{screen}");

    for c in "set".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("settings"));
    assert!(
        !screen.contains("clone the selected"),
        "filtered-out command should disappear"
    );

    app.handle_key(key(KeyCode::Enter)); // → settings popup
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("settings"), "settings popup missing");
    assert!(screen.contains("editor"), "editor section missing");
    assert!(screen.contains("theme"), "theme section missing");
    assert!(screen.contains("cache"), "cache section missing");
    println!("{screen}");
}

#[test]
fn settings_popup_switches_tabs() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(':')));
    for c in "settings".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));

    app.handle_key(key(KeyCode::Tab)); // editor → theme
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("catppuccin-mocha"), "theme value missing");

    app.handle_key(key(KeyCode::Esc)); // close
    let rows = render(&mut app, 100, 30);
    assert!(!rows.join("\n").contains("settings"), "residue after close");
}

#[test]
fn visual_mode_marks_repos_with_checkboxes() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('v')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("VISUAL"), "visual chip missing");
    assert!(screen.contains("○"), "checkboxes missing");

    // Focus is on the repos pane (helper lands there); mark two repos.
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('j')));
    app.handle_key(key(KeyCode::Char(' ')));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("●"), "checked row missing");
    println!("{screen}");

    app.handle_key(key(KeyCode::Char('v'))); // exit visual
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("BROWSE"), "should return to BROWSE");
    assert!(!screen.contains("○"), "checkboxes should disappear");
}

#[test]
fn clone_wizard_walks_three_screens() {
    let mut app = browsing_app();
    // Mark one repo in VISUAL, exit, then :clone.
    app.handle_key(key(KeyCode::Char('v')));
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('v')));

    app.handle_key(key(KeyCode::Char(':')));
    for c in "clone".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("clone — 1/3 repos"), "screen 1 missing");
    assert!(screen.contains("● ratatui"), "marked repo missing");
    assert!(screen.contains("Next →"), "next button missing");
    println!("{screen}");

    app.handle_key(key(KeyCode::Tab)); // list → buttons
    app.handle_key(key(KeyCode::Enter)); // next → destination
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("clone — 2/3 destination"),
        "screen 2 missing"
    );
    assert!(screen.contains("dest:"), "dest path missing");
    println!("{screen}");

    app.handle_key(key(KeyCode::Tab));
    app.handle_key(key(KeyCode::Enter)); // next → summary
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("clone — 3/3 summary"), "screen 3 missing");
    assert!(screen.contains("git clone"), "clone command missing");
    println!("{screen}");

    // Esc closes the entire wizard from any screen.
    app.handle_key(key(KeyCode::Esc));
    let rows = render(&mut app, 100, 30);
    assert!(!rows.join("\n").contains("clone —"), "wizard residue");
}

/// v1.4 (plans/0014 #1): org expansion carries listing metadata into
/// the wizard — recently pushed first, undated by name after, archived
/// rows carry a dim note.
#[test]
fn clone_wizard_sorts_by_pushed_and_marks_archived() {
    let mut app = browsing_app();
    app.handle_app_event(rootle::event::AppEvent::CloneExpanded {
        repos: vec![
            rootle::provider::RepoInfo::bare("ratatui/bare"),
            rootle::provider::RepoInfo {
                name: "ratatui/old".into(),
                pushed_at: Some("2026-01-05T09:00:00Z".into()),
                ..Default::default()
            },
            rootle::provider::RepoInfo {
                name: "ratatui/fresh".into(),
                pushed_at: Some("2026-08-20T10:11:12Z".into()),
                ..Default::default()
            },
            rootle::provider::RepoInfo {
                name: "ratatui/mothballed".into(),
                archived: true,
                pushed_at: Some("2025-06-01T00:00:00Z".into()),
                ..Default::default()
            },
        ],
        errors: vec![],
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("clone — 1/3 repos"), "wizard did not open");
    let pos = |needle: &str| screen.find(needle).unwrap_or(usize::MAX);
    assert!(
        pos("ratatui/fresh") < pos("ratatui/old")
            && pos("ratatui/old") < pos("ratatui/mothballed")
            && pos("ratatui/mothballed") < pos("ratatui/bare"),
        "expected pushed-desc, undated last:\n{screen}"
    );
    assert!(
        screen.contains("archived · 2025-06-01"),
        "archived note missing:\n{screen}"
    );
    println!("{screen}");
}

#[test]
fn leader_yank_toasts_hit_url_in_search_view() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter)); // submit → results focused

    // Leader works over the search view; ␣ y toasts the hit's URL.
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('y')));
    let rows = render(&mut app, 120, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("nothing to yank"),
        "yank toast missing:\n{screen}"
    );
}

#[test]
fn leader_chip_and_hints_show_over_search_view() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('f'))); // open the file-find view
    for c in "term".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter)); // submit → results focus
    let screen = render(&mut app, 120, 30).join("\n");
    assert!(screen.contains("find file"), "search view missing");

    // ␣ raises the leader layer over the view — the modeline must
    // flip to the LEADER chip with the leader hints (wide enough that
    // none drop off the tail).
    app.handle_key(key(KeyCode::Char(' ')));
    let screen = render(&mut app, 140, 30).join("\n");
    assert!(
        screen.contains("LEADER"),
        "leader chip missing over the search view:\n{screen}"
    );
    assert!(screen.contains("yank"), "leader hints missing:\n{screen}");
    // plans/0016 M1: revision keys are in the row.
    assert!(screen.contains("branches"), "refs hint missing:\n{screen}");
    assert!(
        screen.contains("preview"),
        "preview-submode hint missing:\n{screen}"
    );

    // Esc drops the layer; the view stays open with its own chip.
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 120, 30).join("\n");
    assert!(
        screen.contains("find file"),
        "view should survive leader Esc"
    );
    assert!(!screen.contains("LEADER"), "leader chip should drop");
}

#[test]
fn streamed_batches_merge_and_metadata_final_keeps_the_set() {
    let mut app = browsing_app();
    // Open the grep view and submit (offline: the mock path is bypassed
    // by injecting the streamed actions directly).
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    app.handle_action(rootle::action::Action::GlobalSearchSubmitted {
        kind: rootle::components::global_search::SearchKind::Grep,
        query: "hit".into(),
        scope: "global".into(),
        extension: String::new(),
    });

    // Two streamed batches: a new file, then a second file, then a
    // batch hitting the SAME file as the first — folded, not duped.
    let mk = |path: &str, line: u32, count: u32| {
        rootle::components::global_search::SearchHit::plain(
            "ratatui/ratatui",
            path,
            line,
            vec![(line, "let hit = 1;".to_string())],
            count,
            String::new(),
        )
    };
    app.handle_action(rootle::action::Action::GlobalSearchDelta {
        hits: vec![mk("src/a.rs", 3, 1), mk("src/b.rs", 10, 1)],
    });
    app.handle_action(rootle::action::Action::GlobalSearchDelta {
        hits: vec![mk("src/a.rs", 42, 1)],
    });
    // Metadata-only final (provider streamed): the set stands, clipped
    // applies.
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![],
        clipped: true,
        index: Some("2026-08-20T14:00:00Z".into()),
        client_filtered: 0,
        unfiltered: vec![],
    });

    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(screen.contains("src/a.rs"), "first batch hit kept");
    assert!(screen.contains("src/b.rs"), "second batch hit kept");
    // a.rs appears once — merged with its second batch, not appended.
    assert_eq!(
        screen.matches("src/a.rs").count(),
        1,
        "same-file batch merges into one block"
    );
    assert!(screen.contains("42"), "merged region line visible");
    assert!(screen.contains("clipped"), "metadata final applies clipped");
    assert!(
        screen.contains("index 2026-08-20T14:00"),
        "v1.3 index badge in title: {screen}"
    );
    assert!(!screen.contains("streaming"), "final clears pending");
}

/// Boxed result blocks: the filename rides the top rule, the badge
/// closes it, rails wrap the guttered match lines; the selected box's
/// rails carry the accent color.
#[test]
fn grep_results_render_as_decorated_boxes() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    app.handle_action(rootle::action::Action::GlobalSearchSubmitted {
        kind: rootle::components::global_search::SearchKind::Grep,
        query: "render".into(),
        scope: "global".into(),
        extension: String::new(),
    });
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![
            rootle::components::global_search::SearchHit::plain(
                "ratatui/ratatui",
                "src/render.rs",
                3,
                vec![(3, "fn render() {".to_string())],
                2,
                String::new(),
            ),
            // Path-only hit: a two-line capsule, no content rails.
            rootle::components::global_search::SearchHit::plain(
                "ratatui/ratatui",
                "src/draw.rs",
                7,
                vec![],
                0,
                String::new(),
            ),
        ],
        clipped: false,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("┌─ ratatui/ratatui/src/render.rs"),
        "box title missing:\n{screen}"
    );
    assert!(
        screen.contains("2 matches ─┐"),
        "badge not in the top rule:\n{screen}"
    );
    assert!(
        screen.contains("│   3 │ fn render() {"),
        "railed gutter content missing:\n{screen}"
    );
    let capsule = rows
        .iter()
        .position(|r| r.contains("src/draw.rs"))
        .expect("path-only hit");
    assert!(rows[capsule].contains("┌─"), "capsule top:\n{screen}");
    assert!(
        rows[capsule + 1].contains("└"),
        "capsule bottom directly under the title:\n{}",
        rows[capsule + 1]
    );
    println!("{screen}");
}

/// plans/0012 M1 honesty chips: client-subtracted hits and
/// inexpressible tokens are named in the results title.
#[test]
fn grammar_chips_say_what_was_filtered() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    app.handle_action(rootle::action::Action::GlobalSearchSubmitted {
        kind: rootle::components::global_search::SearchKind::Grep,
        query: "render -legacy language:cobol".into(),
        scope: "global".into(),
        extension: String::new(),
    });
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![rootle::components::global_search::SearchHit::plain(
            "ratatui/ratatui",
            "src/render.rs",
            3,
            vec![(3, "fn render() {".to_string())],
            1,
            String::new(),
        )],
        clipped: false,
        index: None,
        client_filtered: 2,
        unfiltered: vec!["language:cobol".into()],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("filtered 2"),
        "filtered chip missing: {screen}"
    );
    assert!(
        screen.contains("unfiltered: language:cobol"),
        "unfiltered chip missing: {screen}"
    );
    println!("{screen}");
}

/// plans/0012 M3: facet chips appear while a search streams and
/// re-count as batches land.
#[test]
fn facet_chips_appear_and_update_as_batches_stream() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    app.handle_action(rootle::action::Action::GlobalSearchSubmitted {
        kind: rootle::components::global_search::SearchKind::Grep,
        query: "zzqqx-no-mock-match".into(),
        scope: "global".into(),
        extension: String::new(),
    });
    let mk = |repo: &str, path: &str| {
        rootle::components::global_search::SearchHit::plain(
            repo,
            path,
            3,
            vec![(3, "let zzqqx = 1;".to_string())],
            1,
            String::new(),
        )
    };

    // First streamed batch lands — the chip row appears with
    // per-batch counts while the set is still growing.
    app.handle_action(rootle::action::Action::GlobalSearchDelta {
        hits: vec![
            mk("local/alpha", "src/one.rs"),
            mk("local/beta", "docs/x.md"),
        ],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains(" results — 2 "),
        "two hits so far: {screen}"
    );
    for chip in ["local/alpha·1", "local/beta·1", "markdown·1", "rust·1"] {
        assert!(screen.contains(chip), "chip {chip} missing: {screen}");
    }

    // Second batch: another alpha rust hit — its counts climb, the
    // chip order re-sorts (alpha first).
    app.handle_action(rootle::action::Action::GlobalSearchDelta {
        hits: vec![mk("local/alpha", "src/two.rs")],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains(" results — 3 "), "the set grows: {screen}");
    assert!(screen.contains("local/alpha·2"), "count climbs: {screen}");
    let alpha = screen.find("local/alpha·2").expect("chip");
    let beta = screen.find("local/beta·1").expect("chip");
    assert!(alpha < beta, "most-hits-first within the repo group");
}

/// plans/0012 M3: Enter on a chip commits the facet (list narrows),
/// Enter again restores, and closing the view leaves no chip residue.
#[test]
fn facet_selection_narrows_clears_and_leaves_no_residue() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    app.handle_action(rootle::action::Action::GlobalSearchSubmitted {
        kind: rootle::components::global_search::SearchKind::Grep,
        query: "hit".into(),
        scope: "global".into(),
        extension: String::new(),
    });
    let mk = |repo: &str, path: &str| {
        rootle::components::global_search::SearchHit::plain(
            repo,
            path,
            3,
            vec![(3, "let hit = 1;".to_string())],
            1,
            String::new(),
        )
    };
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![
            mk("local/alpha", "src/one.rs"),
            mk("local/beta", "docs/x.md"),
        ],
        clipped: false,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    // Tab to the chip row from results: results → query → scope →
    // extension → facets.
    for _ in 0..4 {
        app.handle_key(key(KeyCode::Tab));
    }
    // Cursor 0 = local/alpha (most hits first). Enter commits it.
    app.handle_key(key(KeyCode::Enter));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("src/one.rs"), "faceted hit stays: {screen}");
    assert!(
        !screen.contains("docs/x.md"),
        "other repo's hit is filtered out"
    );

    // Enter on the active chip restores the full accumulated set.
    app.handle_key(key(KeyCode::Enter));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("docs/x.md"), "full set restored: {screen}");

    // Closing the view puts the browser back with no chip residue.
    app.handle_key(key(KeyCode::Esc)); // Esc from the chip row closes
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("ratatui"), "browser restored");
    assert!(
        !screen.contains("local/alpha·"),
        "no chip residue after leaving the view: {screen}"
    );
}

#[test]
fn launch_popup_only_when_state_has_no_repos() {
    // Fresh state → popup opens automatically.
    let mut fresh = test_app();
    let screen = render(&mut fresh, 100, 30).join("\n");
    // Offline double names itself; the title is forge-driven now.
    assert!(
        screen.contains("search offline"),
        "fresh launch should open the search popup"
    );

    // Returning user (repos OR orgs in state) → straight into the browser.
    let state = rootle::state::State {
        recent_repos: vec!["ratatui/ratatui".into()],
        ..Default::default()
    };
    let (tx, _rx) = rootle::event::channel();
    let mut app = App::with(state, tx);
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        !screen.contains("search github"),
        "launch with recents should skip the popup"
    );
    assert!(screen.contains("BROWSE"));

    let (tx, _rx) = rootle::event::channel();
    let mut orgs_only = App::with(
        rootle::state::State {
            recent_orgs: vec!["ratatui".into()],
            ..Default::default()
        },
        tx,
    );
    let screen = render(&mut orgs_only, 100, 30).join("\n");
    assert!(
        !screen.contains("search github"),
        "orgs-only history should also skip the popup"
    );
}

#[test]
fn scrollable_popups_show_a_border_scrollbar() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('?')));
    // Short terminal: the active mode's bindings overflow the popup.
    let rows = render(&mut app, 100, 14);
    let screen = rows.join("\n");
    assert!(screen.contains('┃'), "scrollbar thumb missing:\n{screen}");

    // Scrolling moves the thumb.
    for _ in 0..4 {
        app.handle_key(key(KeyCode::Char('j')));
    }
    let rows = render(&mut app, 100, 14);
    assert!(
        rows.join("\n").contains('┃'),
        "thumb should persist mid-scroll"
    );
}

#[test]
fn panes_get_scrollbars_when_they_overflow() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // drill into the repo root (6 entries)
    // Terminal too short for the root listing → scrollbar appears.
    let rows = render(&mut app, 60, 7);
    assert!(
        rows.join("\n").contains('┃'),
        "overflowing panes should show a scrollbar"
    );
}

#[test]
fn preview_line_cursor_walks_and_readout_updates() {
    // plans/0006 §5: J/K move a line cursor in the preview; the border
    // readout tracks it — the value ␣ y anchors the yank URL to.
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // drill into repo root
    // Dirs sort first (docs/, examples/, src/) — three j's to Cargo.toml.
    for _ in 0..3 {
        app.handle_key(key(KeyCode::Char('j')));
    }
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: "abc1234def5678".into(),
        name: "Cargo.toml".into(),
        bytes: (1..=9)
            .map(|i| format!("line{i}"))
            .collect::<Vec<_>>()
            .join("\n")
            .into_bytes(),
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("1/9"),
        "readout should show cursor 1 of 9:\n{screen}"
    );
    app.handle_key(key(KeyCode::Char('J')));
    app.handle_key(key(KeyCode::Char('J')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("3/9"), "two J moves → cursor 3:\n{screen}");
    for _ in 0..20 {
        app.handle_key(key(KeyCode::Char('J')));
    }
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("9/9"),
        "cursor clamps at last line:\n{screen}"
    );
}

#[test]
fn stale_hit_shows_chip_until_located() {
    // v1.1: a search/code item with located=false renders a `stale`
    // chip instead of line numbers; HitContextLoaded clears it.
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    let mut stale = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "src/place.rs",
        1,
        vec![],
        0,
        String::new(),
    );
    stale.sha = "deadbee".into();
    stale.stale = true;
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![stale],
        clipped: false,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("stale"),
        "stale chip should render:\n{screen}"
    );
    // Context lands (located client-side): chip clears, line shows.
    app.handle_action(rootle::action::Action::HitContextLoaded {
        repo: "owner/repo".into(),
        path: "src/place.rs".into(),
        sha: "deadbee".into(),
        line: 7,
        preview: vec![(7, ratatui::text::Line::from("needle here"))],
        match_count: 1,
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        !screen.contains("stale"),
        "chip clears after locate:\n{screen}"
    );
    assert!(screen.contains("needle here"), "preview renders:\n{screen}");
}

/// Drill from the repos pane into the repo root and select Cargo.toml
/// (root lists dirs first: docs, examples, src, then files).
fn app_on_cargo_toml() -> App {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l')));
    for _ in 0..3 {
        app.handle_key(key(KeyCode::Char('j')));
    }
    app
}

/// Drill into src/ and select lib.rs (src lists layout/, widgets/,
/// then files).
fn app_on_lib_rs() -> App {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // repo root
    for _ in 0..2 {
        app.handle_key(key(KeyCode::Char('j'))); // src
    }
    app.handle_key(key(KeyCode::Char('l'))); // into src
    for _ in 0..2 {
        app.handle_key(key(KeyCode::Char('j'))); // lib.rs
    }
    app
}

#[test]
fn preview_shows_gutter_footer_and_scrollbar() {
    let mut app = app_on_lib_rs();
    let content = (1..=60)
        .map(|i| format!("fn f{i}() {{}}\n"))
        .collect::<String>();
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: "abc1234def5678".into(),
        name: "lib.rs".into(),
        bytes: content.into_bytes(),
    });
    let rows = render(&mut app, 100, 30);
    let screen = rows.join("\n");
    assert!(
        screen.contains("rust · 60 lines"),
        "footer missing:\n{screen}"
    );
    assert!(screen.contains("┃"), "scrollbar thumb missing:\n{screen}");
    assert!(screen.contains("1/60"), "readout missing:\n{screen}");
    assert!(
        screen.contains("10 │ fn f10() {}"),
        "gutter with divider missing:\n{screen}"
    );
}

#[test]
fn find_in_file_flow_highlights_steps_wraps_and_clears() {
    let mut app = app_on_cargo_toml();
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: "abc1234def5678".into(),
        name: "Cargo.toml".into(),
        bytes: b"alpha\nbeta ratatui\ngamma\nratatui delta\n".to_vec(),
    });
    // ␣ / opens FIND over the preview.
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('/')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("FIND"), "find chip missing:\n{screen}");
    assert!(
        screen.contains("Cargo.toml /"),
        "title query prompt missing:\n{screen}"
    );

    for c in "ratatui".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("/ratatui"), "query in title:\n{screen}");
    assert!(screen.contains("1/2 · 2/4"), "match readout:\n{screen}");

    app.handle_key(key(KeyCode::Enter)); // commit
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("BROWSE"),
        "commit returns to browse:\n{screen}"
    );
    assert!(
        screen.contains("1/2 · 2/4"),
        "chips survive commit:\n{screen}"
    );

    app.handle_key(key(KeyCode::Char('n')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("2/2 · 4/4"), "n steps forward:\n{screen}");
    app.handle_key(key(KeyCode::Char('n'))); // wraps to the first match
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("1/2 · 2/4"), "n wraps:\n{screen}");
    app.handle_key(key(KeyCode::Char('N'))); // and back
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("2/2 · 4/4"), "N steps back:\n{screen}");

    app.handle_key(key(KeyCode::Esc)); // :nohlsearch
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(!screen.contains("2/2 ·"), "esc clears the chips:\n{screen}");
    assert!(
        screen.contains("4/4"),
        "cursor stays on the match line:\n{screen}"
    );
}

#[test]
fn find_cancel_restores_the_cursor_line() {
    let mut app = app_on_cargo_toml();
    app.handle_action(rootle::action::Action::BlobLoaded {
        sha: "abc1234def5678".into(),
        name: "Cargo.toml".into(),
        bytes: b"alpha\nbeta ratatui\ngamma\nratatui delta\n".to_vec(),
    });
    app.handle_key(key(KeyCode::Char('J'))); // cursor to line 2
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("2/4"), "pre-find cursor:\n{screen}");

    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('/')));
    for c in "delta".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("1/1 · 4/4"), "live jump:\n{screen}");

    app.handle_key(key(KeyCode::Esc)); // cancel the session
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("BROWSE"),
        "cancel returns to browse:\n{screen}"
    );
    assert!(screen.contains("2/4"), "cursor restored:\n{screen}");
}

#[test]
fn unfocused_parent_pane_is_dimmed() {
    use ratatui::style::Modifier;
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char('l'))); // focus repo root; repos pane unfocused
    let backend = TestBackend::new(100, 30);
    let mut terminal = Terminal::new(backend).unwrap();
    terminal
        .draw(|f| {
            let area = f.area();
            app.render(f, area);
        })
        .unwrap();
    let buf = terminal.backend().buffer();
    // An unselected repo entry in the unfocused parent pane.
    let row = (0..buf.area.height)
        .find(|&y| {
            (0..buf.area.width)
                .map(|x| buf[(x, y)].symbol())
                .collect::<String>()
                .contains("templates/")
        })
        .expect("repo entry row should render");
    let cell = (0..buf.area.width)
        .map(|x| buf[(x, row)].clone())
        .find(|c| c.symbol() == "t")
        .expect("entry cell");
    assert!(
        cell.modifier.contains(Modifier::DIM),
        "unfocused dir entry should be dimmed, got {:?}",
        cell.modifier
    );
}

#[test]
fn unlocatable_hit_flips_from_stale_to_its_own_chip() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    let mut hit = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "src/place.rs",
        1,
        vec![],
        0,
        String::new(),
    );
    hit.sha = "deadbee".into();
    hit.stale = true;
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![hit],
        clipped: false,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(screen.contains("stale"), "stale chip renders:\n{screen}");

    // The blob arrived but the match text isn't in it (plans/0008 §4):
    // the hit stops pretending it's just stale.
    app.handle_action(rootle::action::Action::HitContextMissing {
        sha: "deadbee".into(),
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("unlocatable"),
        "unlocatable chip renders:\n{screen}"
    );
    assert!(!screen.contains("stale"), "stale chip clears:\n{screen}");
}

#[test]
fn clipped_result_set_says_so_in_the_title() {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    let hit = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "src/place.rs",
        1,
        vec![],
        0,
        String::new(),
    );
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![hit],
        clipped: true,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("clipped"),
        "clipped note should render in the results title:\n{screen}"
    );
}

/// Open the grep view over an injected single hit (offline, no workers).
fn grep_view_on_hit(hit: rootle::components::global_search::SearchHit) -> App {
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    app.handle_action(rootle::action::Action::GlobalSearchResults {
        hits: vec![hit],
        clipped: false,
        index: None,
        client_filtered: 0,
        unfiltered: vec![],
    });
    app
}

#[test]
fn hit_expand_shows_full_file_at_anchor_and_esc_restores_results() {
    let mut hit = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "src/main.rs",
        6,
        vec![(6, "let view = render();".to_string())],
        1,
        String::new(),
    );
    hit.sha = "blob123".into();
    let mut app = grep_view_on_hit(hit);

    // Enter expands: the pane opens as a loading placeholder while
    // the blob is on its way.
    app.handle_key(key(KeyCode::Enter));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("owner/repo/src/main.rs:6"),
        "file pane title names repo/path:line:\n{screen}"
    );
    assert!(screen.contains("loading"), "fetch in flight:\n{screen}");

    // The blob lands (UI-thread styled): the WHOLE file renders with
    // the cursor on the anchor line.
    let lines: Vec<_> = (1..=40)
        .map(|i| ratatui::text::Line::from(format!("src line {i} of the file")))
        .collect();
    app.handle_action(rootle::action::Action::HitFileLoaded {
        repo: "owner/repo".into(),
        path: "src/main.rs".into(),
        sha: "blob123".into(),
        lang: "rust".into(),
        lines,
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("src line 18 of the file"),
        "content past the folded preview's reach renders:\n{screen}"
    );
    assert!(
        screen.contains('┃'),
        "the 40-line file overflows the pane — scrollbar proves it:\n{screen}"
    );
    assert!(
        screen.contains("6/40"),
        "readout puts the cursor on the anchor:\n{screen}"
    );
    assert!(
        screen.contains("rust · 40 lines"),
        "footer carries the language:\n{screen}"
    );

    // j walks the file cursor; the readout follows.
    app.handle_key(key(KeyCode::Char('j')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("7/40"),
        "j moves the line cursor:\n{screen}"
    );

    // Esc folds back: the results list returns, selection intact, and
    // no file content lingers anywhere on the screen.
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("src/main.rs"),
        "results list back with the hit selected:\n{screen}"
    );
    assert!(
        screen.contains("let view = render();"),
        "the hit's folded preview renders again:\n{screen}"
    );
    assert!(
        !screen.contains("of the file"),
        "no lingering file-pane cells:\n{screen}"
    );
    assert!(!screen.contains("6/40"), "readout gone with the pane");
}

#[test]
fn file_pane_find_in_file_reuses_preview_session() {
    let mut hit = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "src/main.rs",
        2,
        vec![(2, "let view = render();".to_string())],
        1,
        String::new(),
    );
    hit.sha = "blob123".into();
    let mut app = grep_view_on_hit(hit);
    app.handle_key(key(KeyCode::Enter));
    let lines: Vec<_> = (1..=6)
        .map(|i| {
            ratatui::text::Line::from(if i % 2 == 0 {
                format!("call render() {i}")
            } else {
                format!("plain line {i}")
            })
        })
        .collect();
    app.handle_action(rootle::action::Action::HitFileLoaded {
        repo: "owner/repo".into(),
        path: "src/main.rs".into(),
        sha: "blob123".into(),
        lang: "rust".into(),
        lines,
    });

    // `/` opens FIND over the file — the modeline chip flips and the
    // query rides the pane title, exactly like the browser's `␣ /`.
    app.handle_key(key(KeyCode::Char('/')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("FIND"),
        "FIND chip over the pane:\n{screen}"
    );
    for c in "render".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("src/main.rs:2 /render"),
        "find query rides the pane title:\n{screen}"
    );
    assert!(
        screen.contains("1/3 · 2/6"),
        "match-of-matches readout:\n{screen}"
    );
    // Enter commits the chips; Esc folds the pane back to the results.
    app.handle_key(key(KeyCode::Enter));
    app.handle_key(key(KeyCode::Esc));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("results"),
        "Esc returns to the results list:\n{screen}"
    );
    assert!(
        !screen.contains("/render"),
        "the pane and its find session are gone:\n{screen}"
    );
}

#[test]
fn path_only_hit_expands_to_top_of_file() {
    // match_count 0, no anchor line (file-find shape): the file still
    // opens — cursor at the top, no `:0` in the title.
    let mut hit = rootle::components::global_search::SearchHit::plain(
        "owner/repo",
        "docs/readme.md",
        0,
        vec![],
        0,
        String::new(),
    );
    hit.sha = "blob456".into();
    let mut app = grep_view_on_hit(hit);
    app.handle_key(key(KeyCode::Enter));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("owner/repo/docs/readme.md "),
        "title omits the :0 anchor:\n{screen}"
    );
    app.handle_action(rootle::action::Action::HitFileLoaded {
        repo: "owner/repo".into(),
        path: "docs/readme.md".into(),
        sha: "blob456".into(),
        lang: "markdown".into(),
        lines: (1..=4)
            .map(|i| ratatui::text::Line::from(format!("doc line {i}")))
            .collect(),
    });
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("1/4"),
        "unknown anchor falls back to the top:\n{screen}"
    );
    // Collapse still works from the path-only pane.
    app.handle_key(key(KeyCode::Char('h')));
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(!screen.contains("doc line"), "h folds the pane back");
}

#[test]
fn mock_hit_expands_from_its_body_without_a_fetch() {
    // Offline submit → the mock producer's hits carry bodies; Enter
    // renders the file straight away (no loading state, no worker).
    let mut app = browsing_app();
    app.handle_key(key(KeyCode::Char(' ')));
    app.handle_key(key(KeyCode::Char('g')));
    for c in "query".chars() {
        app.handle_key(key(KeyCode::Char(c)));
    }
    app.handle_key(key(KeyCode::Enter));
    app.handle_key(key(KeyCode::Enter)); // expand the selected mock hit
    let screen = render(&mut app, 100, 30).join("\n");
    assert!(
        screen.contains("mock content for src/widgets/list.rs"),
        "body renders without a fetch:\n{screen}"
    );
    assert!(
        !screen.contains("loading"),
        "body hits never show the placeholder:\n{screen}"
    );
}