Lingo clean

Remova entradas obsoletas dos catálogos JSONC após confirmar que as mensagens de origem não são mais usadas.

Quando uma mensagem é removida do código-fonte, a extração marca a entrada correspondente no catálogo como órfã. lingo clean remove essas entradas de origem e as chaves de destino que não estão mais no conjunto ativo de mensagens de origem. O comando edita entradas, não arquivos de idioma inteiros, e não traduz valores ausentes.

Confirme a remoção antes de prosseguir #

Execute a extração e examine os avisos e as entradas órfãs. Uma chamada dinâmica ou com desestruturação pode deixar de ser reconhecida mesmo que a aplicação ainda a utilize. Nesse caso, corrija o problema de extração em vez de excluir uma mensagem necessária.

Antes da limpeza, salve as diferenças entre as versões para poder recuperar as alterações. O comando reescreve imediatamente o catálogo JSONC de origem e todos os catálogos JSONC de destino encontrados; não há modo de simulação, opção de confirmação nem filtro por idioma de destino.

sh
lingo clean --source-locale en

--source-locale usa en por padrão. --out tem precedência sobre o valor configurado em i18n.messagesPath e, depois, sobre locales, com caminhos relativos à raiz do projeto. O <locale>.jsonc de origem deve existir e não pode estar vazio; caso contrário, o comando falha e orienta a executar a extração primeiro.

Conclua a manutenção dos catálogos #

Confira as contagens de remoções informadas para a origem e para cada destino e, em seguida, examine as diferenças entre as versões. O comando clean não gera novamente as declarações TypeScript. Execute extract e check com os mesmos caminhos e o mesmo idioma de origem e, depois, execute as verificações da aplicação.

Use purge para excluir intencionalmente arquivos de destino ou a referência de base. Use clean para remover entradas órfãs dos catálogos.