context7_cli/

output.rs

/// Terminal output formatting.
///
/// This is the **only** module allowed to call `println!` or `eprintln!`.
/// All coloured formatting via the `colored` crate is centralised here.
/// All user-facing strings are resolved via [`crate::i18n::t`].
use colored::Colorize;

use crate::api::{DocumentationSnippet, LibrarySearchResult, RespostaDocumentacao};
use crate::i18n::{idioma_atual, t, Idioma, Mensagem};
use crate::storage::ChaveArmazenada;

// ─── BIBLIOTECA ───────────────────────────────────────────────────────────────

/// Prints the list of libraries returned by the search endpoint.
///
/// Displays index, title bold with trust score inline, library ID (dimmed),
/// and optional description (italic).
pub fn exibir_bibliotecas_formatado(resultados: &[LibrarySearchResult]) {
    if resultados.is_empty() {
        println!("{}", t(Mensagem::NenhumaBibliotecaEncontrada).yellow());
        return;
    }

    println!("{}", t(Mensagem::BibliotecasEncontradas).green().bold());
    println!("{}", "─".repeat(60).dimmed());

    for (i, lib) in resultados.iter().enumerate() {
        let numero = format!("{}.", i + 1);

        // Title bold with trust score inline
        let titulo = if let Some(score) = lib.trust_score {
            format!(
                "{} {} ({} {:.1}/10)",
                numero.cyan(),
                lib.title.bold(),
                t(Mensagem::ConfiancaScore),
                score
            )
        } else {
            format!("{} {}", numero.cyan(), lib.title.bold())
        };
        println!("{}", titulo);

        // ID secondary (dimmed)
        println!("   {}", lib.id.dimmed());

        if let Some(desc) = &lib.description {
            println!("   {}", desc.italic());
        }

        println!();
    }
}

/// Prints a user-friendly hint when the requested library was not found.
///
/// Called from dispatchers in `cli.rs` before propagating the error,
/// so the user sees the hint on stderr before the error message.
pub fn exibir_dica_biblioteca_nao_encontrada() {
    eprintln!("{}", t(Mensagem::BibliotecaNaoEncontradaApi).yellow());
}

// ─── DOCUMENTAÇÃO ─────────────────────────────────────────────────────────────

/// Prints structured documentation from the docs endpoint.
///
/// Iterates over `snippets`. Shows a "no documentation found" message if empty.
pub fn exibir_documentacao_formatada(doc: &RespostaDocumentacao) {
    let snippets = match &doc.snippets {
        Some(s) if !s.is_empty() => s,
        _ => {
            println!("{}", t(Mensagem::NenhumaDocumentacaoEncontrada).yellow());
            return;
        }
    };

    println!("{}", t(Mensagem::TituloDocumentacao).green().bold());
    println!("{}", "─".repeat(60).dimmed());

    for snippet in snippets {
        exibir_snippet(snippet);
    }
}

/// Prints a single documentation snippet with formatted fields.
///
/// Display order: page_title → code_title → code_description → code_list blocks → code_id (source)
fn exibir_snippet(snippet: &DocumentationSnippet) {
    if let Some(titulo_pagina) = &snippet.page_title {
        println!("{}", format!("## {}", titulo_pagina).green().bold());
    }

    if let Some(titulo_codigo) = &snippet.code_title {
        println!("{}", format!("▸ {}", titulo_codigo).cyan());
    }

    if let Some(descricao) = &snippet.code_description {
        println!("  {}", descricao.dimmed().italic());
    }

    if let Some(blocos) = &snippet.code_list {
        for bloco in blocos {
            println!("```{}", bloco.language);
            println!("{}", bloco.code);
            println!("```");
        }
    }

    if let Some(source) = &snippet.code_id {
        println!("{}", source.blue().bold().dimmed());
    }

    println!();
}

// ─── CHAVES ───────────────────────────────────────────────────────────────────

/// Prints all stored keys with 1-based indices and masked values.
pub fn exibir_chaves_mascaradas(chaves: &[ChaveArmazenada], mascarar: impl Fn(&str) -> String) {
    println!(
        "{}",
        format!("{} {}", chaves.len(), t(Mensagem::ContadorChaves))
            .green()
            .bold()
    );
    println!("{}", "─".repeat(60).dimmed());

    let rotulo_adicionada = match idioma_atual() {
        Idioma::English => "added:",
        Idioma::Portugues => "adicionada:",
    };

    for (i, chave) in chaves.iter().enumerate() {
        println!(
            "  {}  {}  {}",
            format!("[{}]", i + 1).cyan(),
            mascarar(&chave.value).bold(),
            format!("({} {})", rotulo_adicionada, chave.added_at).dimmed()
        );
    }
}

/// Prints the "no keys stored" hint message.
pub fn exibir_nenhuma_chave() {
    println!("{}", t(Mensagem::NenhumaChaveArmazenada).yellow());
    println!("{}", t(Mensagem::UsarKeysAdd).cyan());
}

/// Prints the "no keys to remove" message.
pub fn exibir_nenhuma_chave_para_remover() {
    println!("{}", t(Mensagem::NenhumaChaveParaRemover).yellow());
}

/// Prints an invalid index error.
pub fn exibir_indice_invalido(_indice: usize, total: usize) {
    println!(
        "{}",
        format!("{} {}.", t(Mensagem::IndiceInvalido), total).red()
    );
}

/// Prints the success message for `keys add`.
pub fn exibir_chave_adicionada(caminho: &std::path::Path) {
    println!(
        "{} {}",
        t(Mensagem::ChaveAdicionada),
        caminho.display().to_string().green()
    );
}

/// Prints the success message for `keys remove`.
pub fn exibir_chave_removida(chave_mascarada: &str) {
    println!(
        "{} {}",
        chave_mascarada.bold(),
        t(Mensagem::ChaveRemovidaSucesso)
    );
}

/// Prints the cancellation message for `keys clear`.
pub fn exibir_operacao_cancelada() {
    println!("{}", t(Mensagem::OperacaoCancelada).yellow());
}

/// Prints the success message for `keys clear`.
pub fn exibir_chaves_removidas() {
    println!("{}", t(Mensagem::TodasChavesRemovidas).green());
}

/// Prints an "XDG not supported" error for `keys path`.
pub fn exibir_xdg_nao_suportado() {
    println!("{}", t(Mensagem::SistemaXdgNaoSuportado).red());
}

/// Prints the success message for `keys import`.
pub fn exibir_importacao_concluida(importadas: usize, total: usize) {
    println!(
        "{}",
        format!(
            "{}/{} {}",
            importadas,
            total,
            t(Mensagem::ChavesImportadasSucesso)
        )
        .green()
    );
}