octopeek 0.3.0

//! PR detail panel — renders all sections for a single pull request.
//!
//! Layout:
//! ┌─────────── sticky header (unchanged) ──────────┐
//! ├─── sidebar (28 cols) ───┬── right pane ────────┤
//! │ SECTIONS                │                      │
//! │ ▶ Description           │  content for the     │
//! │   Checks                │  currently selected  │
//! │   Reviews               │  section             │
//! │   Files                 │                      │
//! │   Comments              │                      │
//! ├─────────────────────────┤                      │
//! │ FILES CHANGED           │                      │
//! │   src/a.rs              │                      │
//! └─────────────────────────┴──────────────────────┘
//!
//! ## Thread hierarchy contract
//!
//! `comments_lines` renders review threads with a vertical `│` gutter so the
//! reader can see at a glance that all comments belong to one conversation.
//! The first comment in a thread is the opener; subsequent comments are prefixed
//! with `↳ ` in `palette.dim` to signal "this is a reply".

mod checks;
mod comments;
mod commits;
mod files;
mod header;
mod reviews;
mod sections;
mod thread_card;
mod thread_index;

pub(crate) use thread_index::{ThreadIndex, build_for as build_thread_index};

#[cfg(test)]
pub(crate) mod tests;

use ratatui::{
    Frame,
    layout::{Constraint, Rect},
    style::{Modifier, Style},
    text::{Line, Span},
    widgets::{Block, Borders, Padding, Paragraph, Wrap},
};

use crate::app::App;
use crate::github::detail::PrDetail;
use crate::ui::util::render_detail_header;

pub use header::build_header;
pub use sections::{build_section, cheap_section_row_count};

// ── Section enum ──────────────────────────────────────────────────────────────

/// The six switchable sections in the PR detail sidebar.
///
/// `ALL` gives a stable iteration order; `label()` returns the display string
/// shown in the sidebar.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default)]
pub enum DetailSection {
    /// The PR description (rendered Markdown body).
    #[default]
    Description,
    /// CI check-run results.
    Checks,
    /// Review approvals / change-requests.
    Reviews,
    /// Files changed listing.
    Files,
    /// Review threads and issue comments.
    Comments,
    /// Commit history (newest-first list).
    Commits,
}

impl DetailSection {
    /// All sections in display order.
    pub const ALL: [DetailSection; 6] = [
        DetailSection::Description,
        DetailSection::Checks,
        DetailSection::Reviews,
        DetailSection::Files,
        DetailSection::Comments,
        DetailSection::Commits,
    ];

    /// Human-readable label used in the sidebar list and help text.
    pub fn label(self) -> &'static str {
        match self {
            DetailSection::Description => "Description",
            DetailSection::Checks => "Checks",
            DetailSection::Reviews => "Reviews",
            DetailSection::Files => "Files",
            DetailSection::Comments => "Comments",
            DetailSection::Commits => "Commits",
        }
    }

    /// Returns `true` when this section has displayable content in `detail`.
    pub fn has_content(self, detail: &PrDetail) -> bool {
        match self {
            DetailSection::Description => true, // always shown (even if body is empty)
            DetailSection::Checks => !detail.check_runs.is_empty(),
            DetailSection::Reviews => !detail.reviews.is_empty(),
            DetailSection::Files => !detail.files.is_empty(),
            DetailSection::Comments => {
                !detail.review_threads.is_empty() || !detail.issue_comments.is_empty()
            }
            DetailSection::Commits => !detail.commits.is_empty(),
        }
    }
}

// ── draw (public entry point) ─────────────────────────────────────────────────

/// Render the PR detail panel into `area`.
///
/// Handles three states:
/// - Fetching (no detail yet): centered spinner text.
/// - Error (fetch failed): error panel with retry hint.
/// - Loaded: full sidebar + right-pane layout beneath a sticky header.
#[allow(clippy::too_many_lines)]
pub fn draw(f: &mut Frame, app: &App, area: Rect) {
    let p = &app.palette;

    // ── A. Loading ─────────────────────────────────────────────────────────────
    if app.detail_fetching && app.pr_detail.is_none() {
        let widget = Paragraph::new(Line::from(Span::styled(
            "Fetching pull request\u{2026}",
            Style::default().fg(p.dim),
        )))
        .block(Block::default().style(Style::default().bg(p.background)))
        .alignment(ratatui::layout::Alignment::Center);
        f.render_widget(widget, area);
        return;
    }

    // ── B. Error (no cached detail) ────────────────────────────────────────────
    if let Some(err) = &app.detail_error
        && app.pr_detail.is_none()
    {
        let lines = vec![
            Line::from(Span::styled(format!("\u{2716} {err}"), Style::default().fg(p.danger))),
            Line::from(""),
            Line::from(Span::styled(
                "Press Esc to go back, r to retry",
                Style::default().fg(p.dim),
            )),
        ];
        let widget = Paragraph::new(lines)
            .block(Block::default().style(Style::default().bg(p.background)))
            .alignment(ratatui::layout::Alignment::Center);
        f.render_widget(widget, area);
        return;
    }

    // ── C. Full detail ─────────────────────────────────────────────────────────
    let Some(detail) = &app.pr_detail else {
        return;
    };

    // ── C1. Sticky header (unchanged) ─────────────────────────────────────────
    let header_lines = build_header(detail, p);
    #[allow(clippy::cast_possible_truncation)]
    let header_rows = (header_lines.len() + 2) as u16; // +2 = top pad + bottom rule
    let header_rows = header_rows.min(area.height);
    let vsplits =
        ratatui::layout::Layout::vertical([Constraint::Length(header_rows), Constraint::Min(1)])
            .split(area);
    let header_area = vsplits[0];
    let body_area = vsplits[1];

    render_detail_header(f, header_lines, header_area, p);

    // ── C2. Sidebar + right pane ───────────────────────────────────────────────
    let (sidebar_area, right_area) = if app.sidebar_hidden {
        let dummy = ratatui::layout::Rect { width: 0, ..body_area };
        (dummy, body_area)
    } else {
        let hsplits = ratatui::layout::Layout::horizontal([
            Constraint::Length(app.sidebar_width),
            Constraint::Min(20),
        ])
        .split(body_area);
        (hsplits[0], hsplits[1])
    };

    // Sidebar sub-split: sections list (top) + files list (bottom).
    // Height = 1 "SECTIONS" header + 6 section labels.
    let sidebar_sections_height: u16 = 8;
    let vsidebar = ratatui::layout::Layout::vertical([
        Constraint::Length(sidebar_sections_height.min(sidebar_area.height)),
        Constraint::Min(0),
    ])
    .split(sidebar_area);
    let sections_area = vsidebar[0];
    let files_area = vsidebar[1];

    app.pr_detail_sidebar_rects.set((sections_area, files_area));

    // ── C3. Render sections list ───────────────────────────────────────────────
    let selected_section = app.pr_detail_selected_section;
    let commit_diff_cache_counts = app.commit_diff_cache_counts();

    if !app.sidebar_hidden {
        let indicator = if app.config.show_ascii_glyphs { "> " } else { "\u{25b6} " }; // ▶
        let placeholder = "  ";

        let mut section_lines: Vec<Line<'static>> = Vec::new();
        section_lines.push(Line::from(Span::styled(
            "SECTIONS".to_owned(),
            Style::default().fg(p.accent).add_modifier(Modifier::BOLD),
        )));
        for sec in DetailSection::ALL {
            let is_selected = sec == selected_section;
            let prefix = if is_selected { indicator } else { placeholder };
            let commits_warming = sec == DetailSection::Commits
                && commit_diff_cache_counts.is_some_and(|(ready, total, _)| ready < total);
            let style = if is_selected {
                Style::default().fg(p.accent).add_modifier(Modifier::BOLD)
            } else if commits_warming {
                Style::default().fg(p.warning)
            } else if sec.has_content(detail) {
                Style::default().fg(p.foreground)
            } else {
                Style::default().fg(p.dim)
            };
            let mut spans = vec![Span::styled(format!("{prefix}{}", sec.label()), style)];
            if commits_warming && let Some((ready, total, in_flight)) = commit_diff_cache_counts {
                let marker = if app.config.show_ascii_glyphs {
                    if in_flight > 0 { "~" } else { "!" }
                } else if in_flight > 0 {
                    "\u{21bb}" // ↻
                } else {
                    "!"
                };
                spans.push(Span::styled(
                    format!(" {ready}/{total}{marker}"),
                    Style::default().fg(p.warning),
                ));
            }
            section_lines.push(Line::from(spans));
        }

        let sections_block = Block::default()
            .borders(Borders::RIGHT)
            .border_style(Style::default().fg(p.border_focused))
            .style(Style::default().bg(p.background))
            .padding(Padding::new(1, 0, 0, 0));
        let sections_inner = sections_block.inner(sections_area);
        f.render_widget(Paragraph::new(section_lines).block(sections_block), sections_area);

        // ── C4. Render files list ──────────────────────────────────────────────
        let mut file_list_lines: Vec<Line<'static>> = Vec::new();
        let files_header = format!("FILES CHANGED ({})", detail.changed_files_count);
        file_list_lines.push(Line::from(Span::styled(
            files_header,
            Style::default().fg(p.accent).add_modifier(Modifier::BOLD),
        )));

        let sidebar_inner_width = usize::from(sections_inner.width).saturating_sub(1);
        let files_cursor = app.pr_detail_files_cursor;
        let selected_is_files = selected_section == DetailSection::Files;

        file_list_lines.extend(files::sidebar_file_lines(
            detail,
            files_cursor,
            selected_is_files,
            sidebar_inner_width,
            app.thread_index.as_ref(),
            p,
        ));

        let files_block = Block::default()
            .borders(Borders::RIGHT)
            .border_style(Style::default().fg(p.border_focused))
            .style(Style::default().bg(p.background))
            .padding(Padding::new(1, 0, 0, 0));
        let files_scroll = app.pr_detail_sidebar_scroll;
        f.render_widget(
            Paragraph::new(file_list_lines).block(files_block).scroll((files_scroll, 0)),
            files_area,
        );
    }

    // ── C5. Render right pane ──────────────────────────────────────────────────

    // Compute the commit-scope context once here so the renderer and the
    // indicator strip below can both reference it without double-borrowing.
    let scoped_commit: Option<&crate::github::detail::PrCommit> =
        app.selected_commit.and_then(|idx| detail.commits.get(idx));
    let scoped_patches: Option<&std::collections::HashMap<String, Option<String>>> = scoped_commit
        .and_then(|c| {
            app.detail_cache.get_commit_patches(&detail.repo, &c.sha).map(|cached| &cached.data)
        });

    // ── C5a. Indicator strip (one row, only in scoped mode) ───────────────────
    // Emitted at the very top of the right pane so the user always knows they
    // are looking at a per-commit delta rather than the cumulative HEAD diff.
    let indicator_height: u16 = u16::from(scoped_commit.is_some());

    // We need to carve out the indicator row from the right area before
    // building the scrollable content area.
    let (indicator_area, content_right_area) = if indicator_height > 0 && right_area.height > 1 {
        let vsplit = ratatui::layout::Layout::vertical([
            Constraint::Length(indicator_height),
            Constraint::Min(0),
        ])
        .split(right_area);
        (Some(vsplit[0]), vsplit[1])
    } else {
        (None, right_area)
    };

    if let (Some(strip_area), Some(commit)) = (indicator_area, scoped_commit) {
        let short_sha = &commit.short_sha;
        // Truncate the headline so the strip stays on one line even in
        // narrow terminals. 40 chars is generous for an 80-col terminal.
        let max_headline = usize::from(strip_area.width).saturating_sub(40);
        let headline = crate::ui::util::truncate(&commit.headline, max_headline.max(10));
        let glyph = if app.config.show_ascii_glyphs { "@" } else { "\u{25c8}" }; // ◈
        let strip_text = format!(
            " {glyph} Scoped to {short_sha} \u{2014} \"{headline}\"  \u{00b7}  H returns to HEAD "
        );
        let strip_line =
            Line::from(Span::styled(strip_text, Style::default().fg(p.warning).bg(p.help_bg)));
        f.render_widget(
            Paragraph::new(strip_line).style(Style::default().bg(p.help_bg)),
            strip_area,
        );
    }

    // When a commit is selected, scope the Comments section to threads that
    // originated on that commit's SHA. `scoped_commit` was already resolved
    // above for the indicator strip.
    let comments_scope_sha: Option<&str> = scoped_commit.map(|c| c.sha.as_str());

    let commit_scope_pending = selected_section == DetailSection::Files
        && scoped_commit.is_some()
        && scoped_patches.is_none();
    let (mut content_lines, alt_bg_ranges) = if commit_scope_pending {
        (
            vec![Line::from(Span::styled(
                "Fetching commit diff...".to_owned(),
                Style::default().fg(p.dim),
            ))],
            Vec::new(),
        )
    } else {
        build_section(
            selected_section,
            detail,
            app.pr_detail_files_cursor,
            app.pr_detail_files_show_diff,
            app.detail_comments_expanded,
            app.detail_show_outdated,
            app.thread_index.as_ref(),
            &app.pr_detail_expanded_threads,
            &app.pr_detail_diff_cursor,
            scoped_patches,
            app.commits_cursor,
            comments_scope_sha,
            p,
            app.config.show_ascii_glyphs,
        )
    };
    if selected_section == DetailSection::Commits
        && let Some((ready, total, in_flight)) = commit_diff_cache_counts
        && ready < total
    {
        let status = if in_flight > 0 {
            format!("Commit diffs warming: {ready}/{total} ready")
        } else {
            format!("Commit diffs not fully cached: {ready}/{total} ready")
        };
        let insert_at = content_lines.len().min(2);
        content_lines
            .insert(insert_at, Line::from(Span::styled(status, Style::default().fg(p.warning))));
        content_lines.insert(insert_at + 1, Line::from(""));
    }

    let left_padding = if app.sidebar_hidden { 3 } else { 2 };
    let block = Block::default()
        .style(Style::default().bg(p.background).fg(p.foreground))
        .padding(Padding::new(left_padding, 2, 0, 0));
    let inner = block.inner(content_right_area);

    app.pr_detail_viewport.set(inner);
    app.pr_detail_right_viewport.set(inner);

    let scroll = app.right_pane_scroll();

    let tinted_lines = header::apply_alt_bg(
        &content_lines,
        &alt_bg_ranges,
        p.help_bg,
        inner.width,
        !app.copy_mode.active,
    );

    if app.sidebar_hidden && inner.height > 0 {
        let hint_area =
            ratatui::layout::Rect { x: content_right_area.x, y: inner.y, width: 1, height: 1 };
        f.render_widget(
            Paragraph::new(Line::from(Span::styled(
                "\u{203a}", // ›
                Style::default().fg(p.dim),
            ))),
            hint_area,
        );
    }

    // Copy mode and normal mode share the same Paragraph shape. The only
    // difference is that copy mode runs `apply_overlay` over the tinted
    // lines to draw the selection highlight.
    let lines_to_render = if app.copy_mode.active {
        crate::ui::copy_mode::apply_overlay(&tinted_lines, &app.copy_mode, p)
    } else {
        tinted_lines
    };

    // Wrap is appropriate for prose sections (Description, Checks, Reviews,
    // Comments) so long paragraphs stay readable. It is **wrong** for the
    // Files section's unified diff, because ratatui's word-wrapper drops
    // each wrapped continuation to column 0 — stomping on the line-number
    // gutter and producing the `createFollowParityChecker)` misalignment
    // the user reported. Code diffs scroll horizontally at GitHub / VS
    // Code / every other diff viewer for the same reason: wrapping breaks
    // column-based reading. For Files we omit `.wrap(...)` so long lines
    // are clipped at the right edge and the gutter alignment is preserved;
    // horizontal scrolling is a follow-up.
    // The Commits section is a fixed-column list — wrapping would break the
    // column alignment just as it does for Files diffs.
    let should_wrap =
        selected_section != DetailSection::Files && selected_section != DetailSection::Commits;
    let mut widget = Paragraph::new(lines_to_render)
        .block(block)
        .style(Style::default().bg(p.background).fg(p.foreground))
        .scroll((scroll, 0));
    if should_wrap {
        widget = widget.wrap(Wrap { trim: false });
    }

    f.render_widget(widget, content_right_area);
}