Recuar linhas com espaços

Entrada vazia ou só com espaços é rejeitada com um erro invalid_input claro para que a automação nunca trate um colar em branco como indentação bem-sucedida. O caminho é lógica de strings pura e determinística—sem rede, sem sementes aleatórias, sem dependência de relógio—de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON sempre que você a invoca.

O que significa indentar por linha com espaços e quando usar

A maioria dos editores indenta uma seleção inserindo espaços ou tabulações no início de cada linha selecionada; esta capacidade faz o mesmo trabalho como uma transformação focada e pronta para API. Entrada inteira vazia ou só com espaços é erro duro: não há documento indentado significativo a devolver, e os clientes devem tratar isso como invalid_input e não como sucesso de zero linhas.

Como chamar a API e o que a resposta contém

O valor spaces deve ser um inteiro finito de zero a duzentos inclusive. Prefira enviar o corpo multilinha bruto em vez de unir linhas de antemão quando quiser semântica verdadeira por linha. Envie um corpo JSON com o campo string obrigatório text (aliases input, value, string, s, content e body) e o campo inteiro obrigatório spaces (aliases n, indent, count, amount e pad). O texto deve ser não vazio após aparar espaços gerais e não deve exceder cem mil caracteres para que uma única requisição não esgote a memória do Worker ou do navegador com colagens enormes. Em caso de sucesso a resposta devolve input como a string original enviada, spaces como o inteiro normalizado aplicado, text como o resultado totalmente indentado unido com LF, line_count como o número de linhas após a divisão (incluindo vazias), lines como um array ordenado das strings de linha indentadas, chars_before e chars_after como os comprimentos das strings original e indentada, chars_added como quantos caracteres os prefixos introduziram no total (tipicamente line_count vezes spaces, ajustado se a normalização de quebras encurtou o original), e message como um resumo breve em inglês que informa contagem de linhas, spaces e caracteres adicionados. Validação falha—text ausente, valor que não é string, carga excessiva, conteúdo vazio após o trim geral ou spaces inválido—devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item. Ao integrar, asserte sobre text ou lines para o conteúdo indentado, compare opcionalmente chars_added em checagens de regressão e trate invalid_input como bug do cliente em envios de formulário em branco e não como evento de faturamento.

Dicas práticas, limites e buscas relacionadas

Checagens de ida e volta para testes são fáceis: envie duas linhas curtas com spaces igual a quatro e espere que cada linha comece com quatro espaços; envie uma linha em branco entre conteúdos e confirme que essa linha vazia também carrega o mesmo prefixo; envie deliberadamente string vazia ou só espaços para confirmar invalid_input e a mensagem que pede uma string não vazia; envie spaces negativo ou um float para confirmar invalid_input no campo de contagem. Se precisar remover espaços iniciais e finais por linha em vez de adicionar espaços, use a ferramenta irmã de trim por linha; se precisar preencher uma única string até uma largura total com um caractere de preenchimento à esquerda ou à direita, use o pad de string; se precisar de JSON com indentação estrutural, use um formatador JSON. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém barata a validação de formulários e testes negativos de CI. Respeite os limites de caracteres e de spaces documentados acima ao enviar dumps grandes pela API.