Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

36.9 KB
Raw Blame
//! Minimal markdown rendering for CLI help text.

use anstyle::{AnsiColor, Color, Color as AnsiStyleColor, Style};
use crossterm::style::Attribute;
use termimad::{CompoundStyle, MadSkin, TableBorderChars};

use worktrunk::styling::{
    DEFAULT_HELP_WIDTH, format_bash_with_gutter, format_bash_with_gutter_chopped, format_toml,
    format_with_gutter, wrap_styled_text,
};

/// Table border style matching our help text format:
/// - Horizontal lines under headers with spaces between column segments
/// - No vertical borders
static HELP_TABLE_BORDERS: TableBorderChars = TableBorderChars {
    horizontal: '─',
    vertical: ' ',
    top_left_corner: ' ',
    top_right_corner: ' ',
    bottom_right_corner: ' ',
    bottom_left_corner: ' ',
    top_junction: ' ',
    right_junction: ' ',
    bottom_junction: ' ',
    left_junction: ' ',
    cross: ' ', // Space at intersections gives separate line segments
};

/// Create a termimad skin for help text tables
fn help_table_skin() -> MadSkin {
    let mut skin = MadSkin::no_style();
    skin.table_border_chars = &HELP_TABLE_BORDERS;
    // Render backtick-enclosed text as dimmed, matching render_inline_formatting().
    // This is needed for colorize_status_symbols() to find and recolor symbols
    // like `#` that appear in table cells.
    skin.inline_code = CompoundStyle::with_attr(Attribute::Dim);
    skin
}

/// How fenced code blocks render: quoted in the house gutter (the default, for
/// help pages and the summary tab) or flush and dim with no gutter. The picker's
/// `pr` description pane renders the whole body gutter-free, so it picks `Flush`.
#[derive(Clone, Copy, PartialEq)]
enum CodeBlocks {
    Gutter,
    Flush,
}

/// Render markdown in help text to ANSI: green headers, inline formatting,
/// dimmed rules, colored status symbols, and fenced code quoted in the house
/// gutter.
///
/// If `width` is provided, prose and tables wrap to that width. Headers are
/// never wrapped.
pub(crate) fn render_markdown_in_help_with_width(help: &str, width: Option<usize>) -> String {
    render_markdown(help, width, CodeBlocks::Gutter)
}

/// Like [`render_markdown_in_help_with_width`], but renders fenced code blocks
/// flush and dim rather than quoted in the house gutter — for the picker's `pr`
/// description pane, which renders the whole body gutter-free and flush-left.
pub(crate) fn render_markdown_flush(help: &str, width: Option<usize>) -> String {
    render_markdown(help, width, CodeBlocks::Flush)
}

fn render_markdown(help: &str, width: Option<usize>, code_blocks: CodeBlocks) -> String {
    let green = Style::new().fg_color(Some(Color::Ansi(AnsiColor::Green)));

    let mut result = String::new();
    let mut in_code_block = false;
    let mut code_block_lang = String::new();
    let mut code_block_lines: Vec<&str> = Vec::new();
    let mut table_lines: Vec<&str> = Vec::new();
    // Set by a `<!-- wt list … -->` marker; consumed by the next code block.
    // Tags captured `wt list` output (pre-formatted tables) so it is chopped to
    // terminal width like real `wt list`, not word-wrapped (which shears columns).
    let mut chop_next_block = false;

    let lines: Vec<&str> = help.lines().collect();
    let mut i = 0;

    while i < lines.len() {
        let line = lines[i];
        let trimmed = line.trim_start();

        // HTML comments are expansion markers for web docs (see readme_sync.rs) and
        // don't render. A `<!-- wt list … -->` marker tags the captured `wt list`
        // output that immediately follows, so the next code block is chopped (below).
        // Only outside a fence: inside one the same text is content the block is
        // showing, and the picker's `pr`/comments panes render arbitrary forge
        // markdown, where a fenced HTML sample would otherwise lose the line.
        if !in_code_block && trimmed.starts_with("<!--") && trimmed.ends_with("-->") {
            let inner = trimmed
                .trim_start_matches("<!--")
                .trim_end_matches("-->")
                .trim();
            if inner.starts_with("wt list") {
                chop_next_block = true;
            }
            i += 1;
            continue;
        }

        // Handle code fences
        if let Some(after_fence) = trimmed.strip_prefix("```") {
            if !in_code_block {
                // Opening fence — extract language identifier
                code_block_lang = after_fence.trim().to_string();
                code_block_lines.clear();
                in_code_block = true;
            } else {
                // Closing fence — render the collected code block.
                result.push_str(&render_code_block(
                    &code_block_lines,
                    &code_block_lang,
                    chop_next_block,
                    width,
                    code_blocks,
                ));
                result.push('\n');
                in_code_block = false;
                // A marker applies only to the block right after it.
                chop_next_block = false;
            }
            i += 1;
            continue;
        }

        // Inside code blocks, collect lines for deferred rendering
        if in_code_block {
            code_block_lines.push(line);
            i += 1;
            continue;
        }

        // Detect markdown table rows
        if trimmed.starts_with('|') && trimmed.ends_with('|') {
            // Collect all consecutive table lines
            table_lines.clear();
            while i < lines.len() {
                let tl = lines[i].trim_start();
                if tl.starts_with('|') && tl.ends_with('|') {
                    table_lines.push(lines[i]);
                    i += 1;
                } else {
                    break;
                }
            }
            // Render the table, wrapping to fit terminal width if specified
            result.push_str(&render_table(&table_lines, width));
            continue;
        }

        // Horizontal rules (---, ***, ___) render as visible divider
        // No extra newlines - markdown source already has blank lines around ---
        //
        // TODO: We use `---` dividers instead of H1 headers because H1s break web docs
        // (pages already have a title from frontmatter). This decouples visual hierarchy
        // from heading semantics. Alternatives considered:
        // - Strip H1s during doc sync (demote to H2 for web)
        // - Treat `---` + H2 combo as "major section" (render H2 as UPPERCASE when preceded by ---)
        // - Use marker comments like `<!-- major -->` before H2
        // See git history for discussion.
        if trimmed == "---" || trimmed == "***" || trimmed == "___" {
            let dimmed = Style::new().dimmed();
            let rule_width = width.unwrap_or(40);
            let rule: String = "─".repeat(rule_width);
            result.push_str(&format!("{dimmed}{rule}{dimmed:#}\n"));
            i += 1;
            continue;
        }

        // Outside code blocks, render markdown headers (never wrapped)
        // Visual hierarchy: H1 > H2 > H3 > H4
        // - H1: UPPERCASE green (most prominent, rarely used)
        // - H2: Bold green (major sections like "Examples", "Columns")
        // - H3: Normal green (subsections like "CI status", "commit object")
        // - H4: Bold (nested subsections like "Commit template")
        if let Some(header_text) = trimmed.strip_prefix("#### ") {
            let bold = Style::new().bold();
            let header_text = render_header_text(header_text);
            result.push_str(&format!("{bold}{header_text}{bold:#}\n"));
        } else if let Some(header_text) = trimmed.strip_prefix("### ") {
            let header_text = render_header_text(header_text);
            result.push_str(&format!("{green}{header_text}{green:#}\n"));
        } else if let Some(header_text) = trimmed.strip_prefix("## ") {
            let bold_green = Style::new()
                .bold()
                .fg_color(Some(Color::Ansi(AnsiColor::Green)));
            let header_text = render_header_text(header_text);
            result.push_str(&format!("{bold_green}{header_text}{bold_green:#}\n"));
        } else if let Some(header_text) = trimmed.strip_prefix("# ") {
            let header_text = render_header_text(header_text).to_uppercase();
            result.push_str(&format!("{green}{header_text}{green:#}\n"));
        } else {
            // Prose text - wrap if width is specified
            let formatted = render_inline_formatting(line);
            if let Some(w) = width {
                // wrap_styled_text preserves leading indentation on continuation lines
                for wrapped_line in wrap_styled_text(&formatted, w) {
                    result.push_str(&wrapped_line);
                    result.push('\n');
                }
            } else {
                result.push_str(&formatted);
                result.push('\n');
            }
        }
        i += 1;
    }

    // An opening fence with no closing one: render what it collected rather
    // than dropping it. Help pages are authored and balanced, but the picker's
    // `pr` and comments panes render arbitrary forge markdown, where an
    // unterminated fence would otherwise take the rest of the body with it.
    if in_code_block {
        result.push_str(&render_code_block(
            &code_block_lines,
            &code_block_lang,
            chop_next_block,
            width,
            code_blocks,
        ));
        result.push('\n');
    }

    // Color status symbols to match their descriptions
    colorize_status_symbols(&result)
}

/// Render one fenced code block's collected lines.
///
/// Flush mode dims each line with no gutter and no language-specific
/// highlighting, so the description pane stays gutter-free and flush-left; the
/// gutter mode quotes it in the house bar. Shared by the closing fence and by
/// the end-of-input flush, so an unterminated block renders exactly as the
/// same lines would with a closing fence.
fn render_code_block(
    code_block_lines: &[&str],
    code_block_lang: &str,
    chop_block: bool,
    width: Option<usize>,
    code_blocks: CodeBlocks,
) -> String {
    let content = code_block_lines.join("\n");
    if code_blocks == CodeBlocks::Flush {
        // Flush code feeds the gutter-free `pr`/comments panes. Wrap each
        // line to width (word-wrap, preserving indent) and dim every
        // resulting piece, so a long line doesn't overflow the pane — and,
        // when the comments pane re-quotes this in the house gutter, every
        // wrapped piece already fits, keeping the gutter's own wrap a no-op
        // and the dim consistent rather than landing only on the first line.
        let dim = Style::new().dimmed();
        return code_block_lines
            .iter()
            .flat_map(|l| width.map_or_else(|| vec![l.to_string()], |w| wrap_styled_text(l, w)))
            .map(|piece| format!("{dim}{piece}{dim:#}"))
            .collect::<Vec<_>>()
            .join("\n");
    }
    match code_block_lang {
        "toml" => format_toml(&content),
        "console" => {
            // Strip `$ ` prompt from console blocks for copy-paste.
            // The prefix is preserved in source for web docs.
            let stripped = content
                .lines()
                .map(|l| l.strip_prefix("$ ").unwrap_or(l))
                .collect::<Vec<_>>()
                .join("\n");
            // Captured `wt list` tables (chop_block) are chopped to
            // width; hand-authored command sessions still word-wrap.
            if chop_block {
                format_bash_with_gutter_chopped(&stripped)
            } else {
                format_bash_with_gutter(&stripped)
            }
        }
        "bash" | "sh" => format_bash_with_gutter(&content),
        _ => {
            // Dim the content before adding gutter (format_with_gutter
            // doesn't style text; bash/toml formatters handle their own)
            let dim = Style::new().dimmed();
            let dimmed = code_block_lines
                .iter()
                .map(|l| format!("{dim}{l}{dim:#}"))
                .collect::<Vec<_>>()
                .join("\n");
            format_with_gutter(&dimmed, None)
        }
    }
}

/// Render a markdown table from help text using termimad
fn render_table(lines: &[&str], max_width: Option<usize>) -> String {
    render_table_with_termimad(lines, max_width)
}

/// Render a table from headers and rows using termimad.
///
/// Column widths are computed by termimad based on content.
pub(crate) fn render_data_table(headers: &[&str], rows: &[Vec<String>]) -> String {
    let header_line = format!("| {} |", headers.join(" | "));
    let separator = format!("|{}|", vec!["---"; headers.len()].join("|"));
    let row_lines: Vec<String> = rows
        .iter()
        .map(|row| format!("| {} |", row.join(" | ")))
        .collect();

    let mut lines: Vec<&str> = Vec::with_capacity(rows.len() + 2);
    lines.push(&header_line);
    lines.push(&separator);
    lines.extend(row_lines.iter().map(|s| s.as_str()));

    render_table_with_termimad(&lines, None)
}

/// Render a markdown table using termimad
///
/// Termimad handles column width calculation, cell wrapping, and alignment.
fn render_table_with_termimad(lines: &[&str], max_width: Option<usize>) -> String {
    if lines.is_empty() {
        return String::new();
    }

    // Preprocess lines to strip markdown links and unescape pipes
    // (termimad doesn't handle either)
    let processed: Vec<String> = lines
        .iter()
        .map(|line| unescape_table_pipes(&strip_markdown_links(line)))
        .collect();
    let markdown = processed.join("\n");

    let width = max_width.unwrap_or(DEFAULT_HELP_WIDTH);
    help_table_skin().text(&markdown, Some(width)).to_string()
}

/// Unescape pipe characters in markdown table cells: `\|` -> `|`
///
/// In markdown tables, `|` is the column delimiter. To include a literal pipe
/// character inside a cell, you escape it as `\|`. Termimad doesn't handle this
/// escape sequence, so we preprocess it.
fn unescape_table_pipes(line: &str) -> String {
    line.replace(r"\|", "|")
}

/// Strip markdown links, keeping only the link text: `[text](url)` -> `text`
///
/// Limitation: Links in clap help text may be broken across lines by clap's wrapping
/// before this function runs. The simple fix (setting `cmd.term_width(0)` to disable
/// clap's wrapping) doesn't work because clap provides proper indentation for option
/// description continuation lines — our `wrap_styled_text` would lose this alignment.
///
/// To support arbitrary markdown links in `--help`, we'd need to split help output at
/// `find_after_help_start()`, keep clap's wrapped Options section, get raw after_long_help
/// via `cmd.get_after_long_help()`, process it ourselves, then combine. This requires
/// restructuring since `cmd` is consumed by `try_get_matches_from_mut`.
///
/// Current workaround: Use plain URLs in src/cli/mod.rs (terminals auto-link `https://...`),
/// transform to markdown links for web docs in `post_process_for_html()`.
fn strip_markdown_links(line: &str) -> String {
    let mut result = String::new();
    let mut chars = line.chars().peekable();

    while let Some(ch) = chars.next() {
        if ch == '[' {
            // Potential markdown link
            let mut link_text = String::new();
            let mut found_close = false;
            let mut bracket_depth = 0;

            for c in chars.by_ref() {
                if c == '[' {
                    bracket_depth += 1;
                    link_text.push(c);
                } else if c == ']' {
                    if bracket_depth == 0 {
                        found_close = true;
                        break;
                    }
                    bracket_depth -= 1;
                    link_text.push(c);
                } else {
                    link_text.push(c);
                }
            }

            if found_close && chars.peek() == Some(&'(') {
                chars.next(); // consume '('
                // Skip URL until closing ')'
                for c in chars.by_ref() {
                    if c == ')' {
                        break;
                    }
                }
                // Output just the link text
                result.push_str(&link_text);
            } else {
                // Not a valid link, output literally
                result.push('[');
                result.push_str(&link_text);
                if found_close {
                    result.push(']');
                }
            }
        } else {
            result.push(ch);
        }
    }

    result
}

/// Strip inline markdown markers from header text.
///
/// Headers render with a single uniform style (color and/or weight), so inline
/// `code` can't carry its own styling — the dim style's ANSI reset would
/// terminate the header's color partway through the line. We drop the backticks
/// and let the header style cover the whole heading; links are reduced to their
/// text, matching prose rendering.
fn render_header_text(text: &str) -> String {
    strip_markdown_links(text).replace('`', "")
}

/// Render inline markdown formatting (bold, inline code, links)
fn render_inline_formatting(line: &str) -> String {
    // First strip links, preserving link text (which may contain bold/code)
    let line = strip_markdown_links(line);

    let bold = Style::new().bold();
    let code = Style::new().dimmed();

    let mut result = String::new();
    let mut chars = line.chars().peekable();

    while let Some(ch) = chars.next() {
        if ch == '`' {
            // Inline code
            let mut code_content = String::new();
            for c in chars.by_ref() {
                if c == '`' {
                    break;
                }
                code_content.push(c);
            }
            result.push_str(&format!("{code}{code_content}{code:#}"));
        } else if ch == '*' && chars.peek() == Some(&'*') {
            // Bold
            chars.next(); // consume second *
            let mut bold_content = String::new();
            while let Some(c) = chars.next() {
                if c == '*' && chars.peek() == Some(&'*') {
                    chars.next(); // consume closing **
                    break;
                }
                bold_content.push(c);
            }
            // Recursively process inline formatting within bold content
            let processed_content = render_inline_formatting(&bold_content);
            result.push_str(&format!("{bold}{processed_content}{bold:#}"));
        } else {
            result.push(ch);
        }
    }

    result
}

/// Add colors to status symbols in help text (matching wt list output colors)
fn colorize_status_symbols(text: &str) -> String {
    // Define semantic styles matching src/commands/list/model/status_symbols.rs StatusSymbols::symbols
    let error = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Red)));
    let warning = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Yellow)));
    let success = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Green)));
    let progress = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Blue)));
    let disabled = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::BrightBlack)));
    let working_tree = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Cyan)));
    let changes_requested = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Magenta)));
    let pending_review = Style::new().fg_color(Some(AnsiStyleColor::Ansi(AnsiColor::Cyan)));

    // Pattern for dimmed text (from inline `code` rendering)
    // render_inline_formatting wraps backticked text in dimmed style
    let dim = Style::new().dimmed();

    // Helper to create dimmed symbol pattern and its colored replacement
    let replace_dim = |text: String, sym: &str, style: Style| -> String {
        let dimmed = format!("{dim}{sym}{dim:#}");
        let colored = format!("{style}{sym}{style:#}");
        text.replace(&dimmed, &colored)
    };

    let mut result = text.to_string();

    // Working tree symbols: CYAN
    result = replace_dim(result, "+", working_tree);
    result = replace_dim(result, "!", working_tree);
    result = replace_dim(result, "?", working_tree);

    // Conflicts: ERROR (red)
    result = replace_dim(result, "✘", error);

    // Git operations, MergeTreeConflicts: WARNING (yellow)
    result = replace_dim(result, "↻", warning);
    result = replace_dim(result, "✗", warning);

    // Worktree state: Prunable/Locked (yellow)
    result = replace_dim(result, "⊟", warning);
    result = replace_dim(result, "⊞", warning);

    // CI legend samples: replace dimmed `#` followed by a color name
    let dimmed_hash = format!("{dim}#{dim:#}");
    result = result
        .replace(
            &format!("{dimmed_hash} green"),
            &format!("{success}#{success:#} green"),
        )
        .replace(
            &format!("{dimmed_hash} blue"),
            &format!("{progress}#{progress:#} blue"),
        )
        .replace(
            &format!("{dimmed_hash} red"),
            &format!("{error}#{error:#} red"),
        )
        .replace(
            &format!("{dimmed_hash} magenta"),
            &format!("{changes_requested}#{changes_requested:#} magenta"),
        )
        .replace(
            &format!("{dimmed_hash} cyan"),
            &format!("{pending_review}#{pending_review:#} cyan"),
        )
        .replace(
            &format!("{dimmed_hash} yellow"),
            &format!("{warning}#{warning:#} yellow"),
        )
        .replace(
            &format!("{dimmed_hash} gray"),
            &format!("{disabled}#{disabled:#} gray"),
        )
        // CI error indicator: ⚠ symbol (also rendered dimmed initially)
        .replace(
            &format!("{dim}⚠{dim:#} yellow"),
            &format!("{warning}⚠{warning:#} yellow"),
        );

    // Symbols that should remain dimmed are already dimmed from backtick rendering:
    // - Main state: _ (same commit), ⊂ (content integrated), ^, ↑, ↓, ↕
    // - Upstream divergence: |, ⇡, ⇣, ⇅
    // - Worktree state: / (branch without worktree)

    result
}

#[cfg(test)]
mod tests {
    use super::*;
    use insta::assert_snapshot;

    /// Test helper: render markdown without prose wrapping
    fn render_markdown_in_help(help: &str) -> String {
        render_markdown_in_help_with_width(help, None)
    }

    // ============================================================================
    // strip_markdown_links / unescape_table_pipes (exact transformations)
    // ============================================================================

    #[test]
    fn test_render_inline_formatting_strips_links() {
        assert_eq!(render_inline_formatting("[text](url)"), "text");
        assert_eq!(
            render_inline_formatting("See [wt hook](/hook/) for details"),
            "See wt hook for details"
        );
    }

    #[test]
    fn test_render_inline_formatting_nested_brackets() {
        assert_eq!(
            render_inline_formatting("[text [with brackets]](url)"),
            "text [with brackets]"
        );
    }

    #[test]
    fn test_render_inline_formatting_multiple_links() {
        assert_eq!(render_inline_formatting("[a](b) and [c](d)"), "a and c");
    }

    #[test]
    fn test_render_inline_formatting_malformed_links() {
        // Missing URL - preserved literally
        assert_eq!(render_inline_formatting("[text]"), "[text]");
        // Unclosed bracket - preserved literally
        assert_eq!(render_inline_formatting("[text"), "[text");
        // Not followed by ( - preserved literally
        assert_eq!(render_inline_formatting("[text] more"), "[text] more");
    }

    #[test]
    fn test_render_inline_formatting_preserves_bold_and_code() {
        assert_eq!(
            render_inline_formatting("**bold** and `code`"),
            "\u{1b}[1mbold\u{1b}[0m and \u{1b}[2mcode\u{1b}[0m"
        );
    }

    #[test]
    fn test_unescape_table_pipes() {
        assert_eq!(unescape_table_pipes(r"a \| b"), "a | b");
        assert_eq!(
            unescape_table_pipes(r"\| start \| end \|"),
            "| start | end |"
        );
        assert_eq!(unescape_table_pipes("no pipes here"), "no pipes here");
        assert_eq!(unescape_table_pipes("a | b"), "a | b");
    }

    // ============================================================================
    // render_inline_formatting (ANSI styling)
    // ============================================================================

    #[test]
    fn test_render_inline_formatting_styles() {
        // Inline code
        let code = render_inline_formatting("`code`");
        assert_snapshot!(code, @"code");

        // Bold
        let bold = render_inline_formatting("**bold**");
        assert_snapshot!(bold, @"bold");

        // Nested: code inside bold
        let bold_code = render_inline_formatting("**`wt list`:**");
        assert_snapshot!(bold_code, @"wt list:");

        // Mixed formatting
        let mixed = render_inline_formatting("text `code` more **bold** end");
        assert_snapshot!(mixed, @"text code more bold end");

        // Backticks inside link text
        let link_code = render_inline_formatting("See [`wt hook`](/hook/) for details");
        assert_snapshot!(link_code, @"See wt hook for details");

        // Unclosed backtick
        let unclosed_code = render_inline_formatting("`unclosed");
        assert_snapshot!(unclosed_code, @"unclosed");

        // Unclosed bold
        let unclosed_bold = render_inline_formatting("**unclosed");
        assert_snapshot!(unclosed_bold, @"unclosed");
    }

    // ============================================================================
    // render_markdown_in_help
    // ============================================================================

    #[test]
    fn test_render_markdown_in_help_headers() {
        // All header levels in one snapshot to show the visual hierarchy:
        // H1: UPPERCASE green, H2: bold green, H3: green, H4: bold
        let md = "# Title\n## Section\n### Subsection\n#### Nested";
        let result = render_markdown_in_help(md);
        assert_snapshot!(result, @"
        TITLE
        Section
        Subsection
        Nested
        ");
    }

    #[test]
    fn test_render_markdown_in_help_header_inline_code() {
        // Inline `code` and links in headers are reduced to plain text so the
        // header's own style covers the whole line (no literal backticks, no
        // mid-line ANSI reset). Real case: `### Command log (`commands.jsonl`)`
        // on the `wt config state logs` page.
        let md = "### `--stage`\n#### Run `wt merge`\n## See [the docs](/x/)";
        let result = render_markdown_in_help(md);
        assert_snapshot!(result, @"
        --stage
        Run wt merge
        See the docs
        ");
    }

    #[test]
    fn test_render_markdown_in_help_horizontal_rule() {
        let result = render_markdown_in_help("before\n\n---\n\n## Section");
        assert_snapshot!(result, @"
        before

        ────────────────────────────────────────

        Section
        ");
    }

    #[test]
    fn test_render_markdown_in_help_console_strips_dollar() {
        // Console blocks strip `$ ` for copy-paste; web docs keep it
        let result = render_markdown_in_help("```console\n$ wt step deploy\n$ wt list\n```");
        let stripped = ansi_str::AnsiStr::ansi_strip(&result);
        assert!(
            !stripped.contains("$ "),
            "terminal output should not contain '$ ' prompt: {stripped}"
        );
        assert!(stripped.contains("wt step deploy"));
        assert!(stripped.contains("wt list"));
    }

    #[test]
    fn test_render_markdown_in_help_code_block() {
        let result = render_markdown_in_help("```\ncode here\n```\nafter");
        assert_snapshot!(result, @"
          code here
        after
        ");
    }

    #[test]
    fn test_render_markdown_in_help_toml_code_block() {
        let result = render_markdown_in_help("```toml\n[section]\nkey = \"value\"\n```\nafter");
        assert_snapshot!(result, @r#"
          [section]
          key = "value"
        after
        "#);
    }

    #[test]
    fn test_render_markdown_in_help_html_comment() {
        let result = render_markdown_in_help("<!-- comment -->\nvisible");
        assert_snapshot!(result, @"visible");
    }

    #[test]
    fn test_html_comment_inside_a_code_block_is_content() {
        // Forge markdown can contain fenced HTML samples. A comment inside the
        // fence is content even when it matches a docs expansion marker.
        let result = render_markdown_flush("```html\n<!-- wt list -->\n<p>body</p>\n```", None);
        assert_snapshot!(result, @"
        <!-- wt list -->
        <p>body</p>
        ");
    }

    #[test]
    fn test_unterminated_fence_still_renders_its_content() {
        // A PR description or comment can open a fence and never close it. The
        // panes render that markdown verbatim from the forge, so the block is
        // flushed at end of input rather than swallowing the rest of the body.
        let result = render_markdown_flush("before\n```sh\nwt list\nwt merge", None);
        assert_snapshot!(result, @"
        before
        wt list
        wt merge
        ");
    }

    #[test]
    fn test_unterminated_fence_keeps_the_gutter_form_too() {
        // The same flush in gutter mode, so both render contexts are pinned:
        // the block keeps its language handling rather than being dropped.
        let result = render_markdown_in_help("before\n```\ncode here");
        assert_snapshot!(result, @"
        before
          code here
        ");
    }

    #[test]
    fn test_render_markdown_in_help_plain_text() {
        let result = render_markdown_in_help("Just plain text");
        assert_snapshot!(result, @"Just plain text");
    }

    #[test]
    fn test_render_markdown_in_help_table() {
        let result = render_markdown_in_help("| A | B |\n| --- | --- |\n| 1 | 2 |");
        assert_snapshot!(result, @"
         A   B  
        ─── ─── 
        1   2
        ");
    }

    // ============================================================================
    // render_data_table
    // ============================================================================

    #[test]
    fn test_render_data_table_basic() {
        let rows = vec![
            vec!["Alice".into(), "42".into()],
            vec!["Bob".into(), "7".into()],
        ];
        let result = render_data_table(&["Name", "Score"], &rows);
        assert_snapshot!(result, @"
        Name  Score 
        ───── ───── 
        Alice 42    
        Bob   7
        ");
    }

    #[test]
    fn test_render_data_table_empty_rows() {
        let result = render_data_table(&["A", "B"], &[]);
        assert_snapshot!(result, @"
         A   B  
        ─── ───
        ");
    }

    // ============================================================================
    // colorize_status_symbols
    // ============================================================================

    #[test]
    fn test_colorize_status_symbols() {
        let dim = Style::new().dimmed();

        // Working tree symbols → cyan
        let working_tree = colorize_status_symbols(&format!("{dim}+{dim:#} staged"));
        assert_snapshot!(working_tree, @"+ staged");

        // Conflicts → red
        let conflicts = colorize_status_symbols(&format!("{dim}✘{dim:#} conflicts"));
        assert_snapshot!(conflicts, @"✘ conflicts");

        // Git operations → yellow
        let git_ops = colorize_status_symbols(&format!("{dim}↻{dim:#} rebase"));
        assert_snapshot!(git_ops, @"↻ rebase");

        // CI legend samples: dimmed `#` + color name recolors the sample
        let ci_passed = colorize_status_symbols(&format!("{dim}#{dim:#} green"));
        assert_snapshot!(ci_passed, @"# green");

        let ci_failed = colorize_status_symbols(&format!("{dim}#{dim:#} red"));
        assert_snapshot!(ci_failed, @"# red");

        let ci_review = colorize_status_symbols(&format!("{dim}#{dim:#} magenta"));
        assert_snapshot!(ci_review, @"# magenta");
    }

    #[test]
    fn test_colorize_status_symbols_no_change() {
        let input = "plain text here";
        let result = colorize_status_symbols(input);
        assert_eq!(result, input);
    }

    // ============================================================================
    // render_table
    // ============================================================================

    #[test]
    fn test_render_table_escaped_pipe() {
        let lines = vec![
            "| Category | Symbol | Meaning |",
            "| --- | --- | --- |",
            r"| Remote | `\|` | In sync |",
        ];
        let result = render_table(&lines, None);
        assert_snapshot!(result, @"
        Category Symbol Meaning 
        ──────── ────── ─────── 
        Remote   |      In sync
        ");
    }

    #[test]
    fn test_render_table_column_alignment() {
        let lines = vec![
            "| Short | LongerHeader |",
            "| ----- | ------------ |",
            "| A | B |",
        ];
        let result = render_table(&lines, None);
        assert_snapshot!(result, @"
        Short LongerHeader 
        ───── ──────────── 
        A     B
        ");
    }

    #[test]
    fn test_render_table_uneven_columns() {
        let lines = vec!["| A | B | C |", "| --- | --- | --- |", "| 1 | 2 |"];
        let result = render_table(&lines, None);
        assert_snapshot!(result, @"
         A   B   C  
        ─── ─── ─── 
        1   2
        ");
    }

    #[test]
    fn test_render_table_no_separator() {
        let lines = vec!["| A | B |", "| 1 | 2 |"];
        let result = render_table(&lines, None);
        assert_snapshot!(result, @"
        A   B  
        1   2
        ");
    }

    #[test]
    fn test_render_table_ragged_narrow_does_not_panic() {
        // Regression for #3407. termimad <= 0.34.1 panicked with an out-of-bounds
        // index when a *ragged* table — a row with more cells than the header —
        // was rendered at a narrow width: its column fitter (`Table::fix_columns`
        // in termimad's src/tbl.rs) took an error path that skipped cell padding,
        // then indexed past the shorter row. PR-comment markdown is untrusted and
        // can contain such a table, and the picker renders comment bodies through
        // here, so this used to abort `wt switch`. Fixed upstream in termimad
        // 0.35.1 (Canop/termimad#77); this guards against a regression or an
        // accidental downgrade — the render must complete rather than panicking.
        let lines = vec![
            "| Key | Value |",
            "| --- | --- |",
            "| alpha | beta | gamma | delta | epsilon | zeta |",
        ];
        // The bug manifested as an out-of-bounds panic *during* rendering in the
        // narrow-width band (16/20/24). termimad wraps cells hard and drops
        // columns to fit width 20, so we don't assert on specific cell text —
        // reaching this line at all is the proof the panic is gone.
        let result = render_table(&lines, Some(20));
        assert!(
            !result.is_empty(),
            "render should complete and produce output"
        );
    }

    #[test]
    fn test_render_markdown_in_help_table_wrapping() {
        let help = r#"### Other environment variables

| Variable | Purpose |
|----------|---------|
| `WORKTRUNK_BIN` | Override binary path for shell wrappers (useful for testing dev builds) |
| WORKTRUNK_CONFIG_PATH | Override user config file location |
| `WORKTRUNK_MAX_CONCURRENT_COMMANDS` | Max parallel git commands (default: 32). Lower if hitting resource limits. |
| NO_COLOR | Disable colored output (standard) |
"#;
        let result = render_markdown_in_help_with_width(help, Some(80));
        assert_snapshot!(result, @"
        Other environment variables

                     Variable                                Purpose                    
         ───────────────────────────────── ──────────────────────────────────────────── 
         WORKTRUNK_BIN                     Override binary path for shell wrappers      
                                           (useful for testing dev builds)              
         WORKTRUNK_CONFIG_PATH             Override user config file location           
         WORKTRUNK_MAX_CONCURRENT_COMMANDS Max parallel git commands (default: 32).     
                                           Lower if hitting resource limits.            
         NO_COLOR                          Disable colored output (standard)
        ");
    }
}