Formatador YAML

Reindente um documento YAML sem o converter em JSON. O formatador analisa a estrutura antes de a reescrever, distinguindo mappings, listas e texto isolado. Mantém a representação documental de comentários, âncoras e valores multilinha em vez de reconstruir apenas os valores resolvidos. É útil para configurações versionadas ou excertos a partilhar com uma equipa. O ficheiro fica no navegador; o processamento não consulta repositórios remotos nem serviços de implementação.

O parser usa YAML 1.2 por predefinição e respeita as diretivas de versão suportadas. Depois de reconhecer o documento, aplica a indentação escolhida com pelo menos dois espaços. Listas e mappings são identificados sintaticamente; substituir espaços em todas as linhas poderia alterar uma string literal.

São rejeitadas chaves duplicadas no mesmo mapping, sintaxe inválida e vários documentos numa entrada. Tabulações não podem indentar a estrutura YAML, embora possam pertencer a um valor conforme a sintaxe. Um escalar como not yaml é válido: YAML não se limita a pares chave-valor.

A formatação trabalha sobre o documento YAML sem expandir aliases em objetos JSON. Âncoras e comentários podem, assim, continuar representados. Os inteiros grandes mantêm a escrita sem se tornarem números JavaScript arredondados. Espaços de apresentação, aspas e espaços nas coleções compactas podem ser normalizados; a saída não é uma cópia idêntica byte a byte.

O êxito confirma que este parser lê o documento, não que a aplicação aceite os parâmetros. Não carrega ficheiros mencionados em caminhos nem interpreta etiquetas personalizadas segundo regras de negócio. Leitores YAML antigos podem aplicar regras de tipos diferentes; confirme a versão esperada pelo seu ambiente.