lingo extract

Gere JSONC de origem e declarações TypeScript a partir de chamadas explícitas de tradução.

lingo extract atribui uma identidade no catálogo às mensagens explícitas do React. Examina chamadas TypeScript/TSX, grava o JSONC de origem e as declarações localmente e preserva os metadados que vinculam cada entrada à sua origem. Não reescreve JSX arbitrário nem solicita traduções.

Em um componente React configurado, uma chamada compatível tem este formato:

tsx
const l = useLingo();
const label = l.text("Place order", { context: "Checkout submit button" });

Execute a extração a partir da raiz do projeto:

sh
lingo extract --src src --source-locale en

Com os caminhos padrão, confira locales/en.jsonc e lingo.d.ts. O catálogo de origem registra os valores das mensagens, o contexto e as localizações no código-fonte. O guia de início rápido do React apresenta as importações e a configuração do provedor para o componente.

Opções #

OpçãoPadrão ou efeito
--src <path>Diretório a examinar; padrão: src.
--source-locale <locale>Idioma de origem da saída; padrão: en.
--out <path>Ordem de precedência: esta opção, i18n.messagesPath configurado e, por fim, o padrão locales.
--types <path>Ordem de precedência: esta opção, i18n.typesPath configurado e, por fim, o padrão lingo.d.ts.
--checkCompara os bytes gerados com os que estão em disco, sem gravar.

Os caminhos são resolvidos a partir da raiz de projeto mais próxima. O idioma de origem não herda sourceLocale da configuração de localização; para usar outro idioma, especifique-o explicitamente. As gravações normais criam os diretórios de declarações.

O que o analisador reconhece #

O analisador reconhece text, rich, plural e select em variáveis que recebem o resultado de useLingo ou createLingo, além dos receptores convencionais l e .l. Aceita literais de string, templates sem expressões e objetos de formulário estáticos.

Mensagens dinâmicas não têm uma origem estável que possa ser extraída. Desestruturar o resultado de uma função fábrica faz com que o analisador perca a estrutura rastreada do receptor e emita um aviso. Arquivos de declaração, arquivos e diretórios com nomes iniciados por ponto e node_modules são excluídos. Quando não há arquivos TS/TSX, a extração informa isso e retorna sem resultado; o encerramento bem-sucedido do processo não comprova que mensagens foram encontradas.

Revise a identidade e o comportamento da mesclagem #

As chaves são derivadas da origem e do contexto. Uma mudança no texto ou no contexto pode criar uma nova identidade; valores substituídos em tempo de execução, não. Colisões fazem a extração falhar e exigem um contexto que elimine a ambiguidade.

A extração mescla os dados com o catálogo de origem existente: preserva os valores atuais, atualiza os metadados de contexto e origem, adiciona novas entradas e marca as mensagens ausentes como órfãs. A saída ordenada é determinística. Confira os avisos antes de considerar que uma entrada órfã foi removida intencionalmente da aplicação.

Verifique ou traduza o catálogo #

lingo extract --check compara os bytes do catálogo e das declarações sem gravar. lingo check também examina o contexto, as entradas órfãs e os destinos encontrados.

Para traduzir, adicione o caminho real de .jsonc a files[], autentique-se, faça a vinculação e use lingo push --backfill-missing --wait no primeiro envio. Nas alterações seguintes, use o envio simples. Alterar os caminhos de extração não atualiza automaticamente a configuração de arquivos.

Carregue o resultado com um carregador compatível com JSONC e a política de metadados do catálogo. O provedor espera um mapa de strings; nem um simples caminho de arquivo nem uma importação JSON comum fazem essa conversão por completo.