Formatador de código

Propósito e Intenção do Usuário: Um formatador de código sensível à linguagem que reformata o código-fonte em várias linguagens para impor um estilo consistente, reduzir diffs e melhorar a legibilidade. Usuários-alvo são desenvolvedores, revisores de código e engenheiros de CI que trabalham em bases de código compartilhadas e precisam de formatação determinística antes de commits ou pull requests. Quando houver a necessidade de padronizar espaços, indentação, aspas ou o comprimento das linhas em todo o projeto, esta ferramenta formata a entrada de acordo.
Lógica Central e Funcionalidades: Capacidade principal é a análise sensível à linguagem e a reimpressão baseada em AST. Funcionalidades obrigatórias: entrada de linguagem (explícita ou inferida), construção robusta de AST, preservação de comentários e literais de string, e formatação configurável (indentação, comprimento da linha, vírgulas no fim, estilo de aspas, uso do ponto e vírgula). Funcionalidades opcionais/avançadas: vários presets de estilo (ex.: Google, estilo PEP8 para Python, Spring/Google para Java), configurações personalizadas de usuário, minificação para linguagens suportadas, formatação in/out-of-place e saída de diff opcional. Saídas: formatted_code e diagnósticos opcionais.
Algoritmos & Cálculos: A ferramenta analisa o código em ASTs específicos da linguagem, aplica regras de formatação e imprime novamente o código mantendo a semântica. Ela impõe terminação de linhas e espaçamento, restringe o comprimento das linhas onde possível e respeita as preferências do usuário. Se a análise falhar para a linguagem dada, pode recorrer a uma reformatação segura ou retornar diagnósticos sem alterar a semântica.
Erros & Casos Limite: entradas ausentes resultam em erros; linguagens não suportadas geram diagnósticos claros; entradas muito grandes são divididas; erros de sintaxe são tratados com alterações mínimas; dados externos não devem ser buscados. Indústria/Região & Localização: Suporta final de linha LF/CRLF e tratamento de identificadores locais quando aplicável; códigos regionais não são alterados a menos que façam parte da sintaxe da linguagem. Suposições & Exclusões: Assume que a entrada é código em uma linguagem suportada e apenas é formatado; não faz lint, compilação ou execução de código; não é editor e não há comportamento de UI.