Formateador de código

Propósito e intención del usuario: Un formateador de código sensible al lenguaje que reformatea el código fuente en varios lenguajes para imponer un estilo consistente, reducir diffs y mejorar la legibilidad. Usuarios objetivo: desarrolladores, revisores de código e ingenieros CI que trabajan en bases de código compartidas y necesitan formateo determinista antes de commits o pull requests. Cuando se requiere estandarizar espaciado, sangría, comillas o longitud de línea a nivel de proyecto, esta herramienta formatea la entrada en consecuencia.
Lógica central y características: la capacidad principal es el análisis sensible al lenguaje y la reimpresión basada en AST. Funciones requeridas: entrada de lenguaje (explícita o inferida), construcción robusta de AST, preservación de comentarios y literales de cadena, y formateo configurable (indentación, longitud de línea, comas finales, estilo de comillas, uso de punto y coma). Funciones opcionales/avanzadas: múltiples presets de estilo (p. ej., Google, estilo PEP8 para Python, Spring/Google para Java), configuraciones personalizadas de usuario, minificación para lenguajes compatibles, formateo in/out-of-place y salida de diff opcional. Salidas: formatted_code y diagnósticos opcionales.
Algoritmos y cálculos: El tool analiza el código en ASTs específicos del lenguaje, aplica reglas de formateo y imprime de nuevo el código manteniendo la semántica. Impone terminaciones de línea y espaciado, limita la longitud de líneas cuando es possible y respeta las preferencias de usuario. Si el parseo falla para el lenguaje dado, puede volver a una reformatación segura o devolver diagnósticos sin cambiar la semántica.
Errores y casos límite: entradas faltantes generan errores; lenguajes no soportados emiten diagnósticos claros; entradas muy grandes se dividen; errores de sintaxis se manejan con cambios mínimos; no se deben recuperar datos externos. Industria/Región y Localización: Soporta terminaciones LF/CRLF y manejo de identificadores de locale cuando corresponda; no se modifican códigos regionales a menos que formen parte de la sintaxis del lenguaje. Supuestos y exclusiones: se asume que la entrada es código en un lenguaje soportado y solo se formatea; no realiza linting, compilación o ejecución de código; no es un editor y no hay comportamiento de UI.