Normalizar indentación de texto

Cuando la misma línea o el documento completo mezcla tabuladores y espacios sin un patrón claro, la tarea falla con invalid_input en lugar de adivinar en silencio. El parámetro opcional target_unit le permite reescalar niveles basados en espacios (por ejemplo de dos a cuatro) sin cambiar el árbol lógico de profundidad.

Cómo funcionan la detección de la unidad base y la reescritura de niveles

El target_unit opcional solo se aplica a documentos con estilo de espacios: se conservan los niveles y la salida usa esa cantidad de espacios por nivel, que es cómo convierte un árbol de dos espacios en uno de cuatro en una sola llamada. La entrada con estilo de tabuladores ignora target_unit para no expandir tabuladores en silencio.

Contrato de entrada, campos de respuesta y comportamiento de error

Prefiera enviar el cuerpo multilínea en bruto en lugar de colapsar saltos de línea de antemano cuando quiera semántica real de indentación por línea; una sola línea larga solo tiene una indentación que normalizar. Envíe por POST un cuerpo JSON con un campo de cadena obligatorio text (alias input, value, string, s, content y body). El valor debe ser una cadena no vacía tras recortar el espacio en blanco global y no debe superar cien mil caracteres, para que un solo pegado no agote la memoria del Worker o del navegador. El target_unit opcional es un entero positivo de uno a treinta y dos; los no enteros y los valores fuera de rango fallan la validación. En caso de éxito la respuesta devuelve input como la cadena original, text como el resultado multilínea reescrito unido con LF, indent_style como spaces, tabs o none, indent_unit como el tamaño efectivo de la unidad de salida, detected_unit como la unidad inferida antes de cualquier override de destino, line_count como el número de líneas incluidas las en blanco, indented_lines como cuántas líneas tenían un nivel positivo, max_level como el nivel de indentación más profundo, levels como la matriz de profundidad entera por línea alineada con lines, lines como la matriz ordenada de cadenas de línea reescritas, y message como un resumen breve del estilo, la unidad, el recuento de líneas y el nivel máximo. La validación fallida —text ausente, valores que no son cadena, contenido vacío, carga excesiva, target_unit inválido, mezcla de tabulador y espacio en la misma línea, o mezcla de estilos a nivel de documento— devuelve invalid_input y nunca se cobra. El precio es un fijo de $0.002 por solicitud exitosa con unidad item. Al integrar, afirme sobre text o lines para el contenido limpio, compare opcionalmente levels e indent_unit en regresiones, y trate invalid_input como un conflicto de estilo del cliente en pegados mixtos, no como un evento de facturación.

Cuándo usar esta herramienta y en qué se diferencia de búsquedas afines

Use esta capacidad cuando la intención de búsqueda sea normalizar niveles de indentación de texto, corregir indentación inconsistente en línea, convertir un pegado irregular de dos y cuatro espacios a una sola unidad, o detectar estilo de indentación por tabulador frente a espacio antes de un commit. Tenga en cuenta los espacios finales y las columnas de alineación interiores: esta herramienta solo reescribe la racha de indentación inicial, no los espacios de alineación dentro de la línea. No es un formateador de código completo, ni un pretty printer consciente del lenguaje, ni un eliminador de líneas en blanco, ni un String.trim global que destruiría la estructura intencional. Las comprobaciones de ida y vuelta en pruebas son sencillas: envíe un bloque de tres líneas con cero, dos y cuatro espacios iniciales y espere indent_unit dos con levels cero, uno y dos; envíe bloques anidados indentados solo con tabuladores y espere indent_style tabs con niveles enteros que coincidan con el recuento de tabuladores; envíe deliberadamente una línea que empiece con tabulador y luego espacios, o una línea con tabulador junto a otra con espacios, y confirme invalid_input mencionando la mezcla de tabuladores y espacios. Prefiera str.trim_lines cuando solo necesite quitar espacios al inicio y al final de cada línea sin conservar un árbol de profundidad; prefiera data.json_format cuando la carga sea JSON que deba imprimirse con indentación fija; prefiera esta capacidad cuando ya exista texto jerárquico plano o bloques similares a código y necesite una unidad base coherente. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene barata la validación de formularios y las pruebas negativas de CI.