TypeScript

Traduza valores literais em módulos estáticos de idioma com exportação padrão, preservando a sintaxe TypeScript ao redor.

Um módulo de idioma em TypeScript permite manter as mensagens próximas dos tipos que as descrevem. O processador de arquivos typescript traduz valores literais em uma exportação padrão estática, substituindo o texto diretamente e preservando chaves, importações, comentários e a sintaxe de tipos ao redor. Ele lê o código-fonte sem executar o módulo.

Forneça um catálogo estático ao processador #

Use um objeto ou array definido diretamente na exportação padrão:

typescript
export default {
  checkout: {
    title: "Complete your order",
    retries: 3,
  },
  steps: ["Review", "Confirm"],
} as const;

As unidades de texto incluem checkout.title, steps[0] e steps[1]. O valor numérico permanece inalterado. as const, satisfies e parênteses ao redor de expressões compatíveis podem permanecer no código-fonte.

Mantenha os valores a traduzir como literais. O processador não busca a declaração de um identificador exportado nem avalia chamadas de funções de fábrica. Ele ignora chaves de propriedades computadas, operações de espalhamento, métodos e valores produzidos por expressões. Literais de modelo só funcionam sem expressões interpoladas. Se um módulo válido não gerar nenhuma tarefa de tradução, verifique a estrutura da exportação padrão antes de procurar uma falha na tradução.

Escolha quais valores aceitos manter #

A versão anterior do código-fonte permite identificar as alterações por caminho no catálogo. O destino existente fornece os valores aceitos para textos inalterados ou que não tenham sido resolvidos de outra forma. Os caminhos bloqueados mantêm o literal atual da origem; os caminhos preservados mantêm o valor de destino existente, quando disponível. Esses controles não executam o código para descobrir textos adicionais.

As substituições usam o mesmo delimitador de aspas do literal de origem e aplicam os escapes necessários ao conteúdo traduzido. Uma atualização de chaves mantém os valores de destino não selecionados. As entradas da origem ausentes desse resultado parcial podem ser removidas, inclusive elementos de arrays. Por isso, confira as chaves resultantes e os elementos que permaneceram nos arrays antes de carregar o módulo.

Configure a seleção de arquivos #

A CLI infere typescript para .ts, .mts e .cts, mas não para .js ou .tsx. Selecione os módulos de idioma pela configuração da CLI ou pelo GitHub.

Carregue o módulo traduzido #

Este formato é separado da extração de mensagens do React. A extração lê chamadas compatíveis no código-fonte .ts e .tsx da aplicação para criar um catálogo; este processador traduz um módulo de idioma já estruturado. Consulte Catálogos e tipos do React para entender esse ciclo.

Depois de obter o módulo, verifique seus tipos e carregue-o pelo carregador de catálogos da aplicação. Compare as chaves selecionadas com as mensagens usadas na tela e, em seguida, teste os marcadores de posição. Essas verificações revelam problemas diferentes: um módulo inválido não pode ser carregado, um valor dinâmico não selecionado permanece sem tradução e uma tradução válida ainda pode transmitir o significado errado.