O que é a pseudotradução e porque devo utilizá-la?

A pseudotradução substitui as cadeias de origem por versões modificadas que simulam propriedades de traduções reais —texto mais longo, outros conjuntos de caracteres e direção de leitura invertida— sem traduzir realmente. Deteta cedo erros de disposição, cadeias codificadas diretamente, problemas de codificação e falhas RTL, antes de pagar traduções reais.

Danifica os meus marcadores e variáveis ICU?

Não. i18n-pseudo analisa a sintaxe de mensagens ICU e transforma apenas segmentos de texto traduzível. Marcadores como {name}, variáveis de interpolação e expressões de plural ({count, plural, one {# item} other {# items}'}) são preservados exatamente como estão.

Com que predefinição devo começar?

Comece pela predefinição normal —acentos e parênteses retos— para encontrar cadeias codificadas diretamente. Depois utilize a de disposição para detetar truncamento e transbordo. Utilize charset se aceitar idiomas CJK e rtl se aceitar árabe ou hebraico.

Como integro a pseudotradução em CI?

Gere ficheiros pseudotraduzidos com 'i18n-pseudo en.json --preset layout -o locales/pseudo/' e depois execute os testes de regressão visual —Playwright, Chromatic ou Percy— com a pseudorregião. Qualquer disposição que quebre com texto expandido surgirá como diferença visual.

Ferramenta de pseudotradução

Name: i18n Agent
Price: 0.01 EUR
Author: i18n Agent

Teste a interface de i18n antes do lançamento. Gere traduções simuladas que submetem a disposição, a codificação e a apresentação bidirecional a testes exigentes, sem esperar pelas traduções reais.

O problema

A sua interface parece perfeita em inglês. Depois chega o alemão: cadeias 40% maiores quebram todos os botões e cortam os cabeçalhos das tabelas. O árabe inverte toda a disposição e os ícones apontam para o lado errado. O japonês precisa de outras alturas de linha e os cartões cuidadosamente espaçados desmoronam-se. Descobre tudo isto depois de pagar as traduções.

O custo médio de corrigir erros de disposição de i18n após a tradução é 5 a 10 vezes superior ao de os detetar durante o desenvolvimento. A pseudotradução encontra-os gratuitamente, antes de gastar um euro em traduções reais.

A solução

i18n-pseudo gera traduções simuladas que submetem a interface a testes exigentes sem esperar por tradutores. Aplica 7 estratégias de transformação —acentos, caracteres CJK, expansão de texto, marcadores RTL e outras— preservando os marcadores ICU, a sintaxe de plural e as variáveis de interpolação.

Instalação

i18n-pseudo está disponível como pacote npm e fórmula Homebrew ou pode ser compilado a partir do código-fonte com Cargo.

Terminal

npm install -g @i18n-agent/i18n-pseudo

O pacote npm inclui um binário de CLI global. Não exige dependências durante a execução.

7 estratégias de transformação

Cada estratégia visa uma classe específica de erro de i18n. Utilize-as individualmente com sinalizadores ou combine-as através de predefinições.

Strategy	Flag	Input	Output
Accents	`--accents`	Hello	Ĥéľľó
CJK	`--cjk`	Hello	你好世界你好
Special Chars	`--special`	Hello	Hello
Expansion	`--expansion N`	Save	Save~~~~
Brackets	`--brackets`	Hello	[Hello]
RTL	`--rtl`	Hello	‮Hello‬
Unicode Stress	`--unicode-stress`	Hello	H́ȩl̈l̀õ

Os acentos são a estratégia mais popular para detetar cadeias codificadas diretamente. Se uma cadeia aparecer sem diacríticos na interface, nunca passou pela função de tradução.

Predefinições

As predefinições agrupam estratégias para cenários de teste habituais. Utilize --preset para aplicar várias estratégias de uma só vez.

Preset	Strategies	Use Case
`default`	accents + brackets	Quick visual check that all strings are externalized
`layout`	expansion (1.4x) + brackets	Catch truncation and overflow before real translations
`charset`	CJK + special + brackets	Test font rendering and character encoding
`rtl`	RTL markers + brackets	Verify bidirectional layout without switching locale
`full`	All strategies combined	Maximum stress test — everything at once

Exemplos de utilização

Execute i18n-pseudo no ficheiro regional de origem. Lê JSON, YAML, PO e outros formatos de i18n, aplica as estratégias selecionadas e grava o resultado transformado.

Terminal

# Default (accents + brackets)
i18n-pseudo en.json -o output/

# Layout testing (text expansion + brackets)
i18n-pseudo en.json --preset layout -o output/

# Specific strategies
i18n-pseudo en.json --accents --expansion 1.5 -o output/

# Kitchen sink
i18n-pseudo en.json --preset full -o output/

Antes e depois

Eis o efeito da predefinição normal —acentos e parênteses retos— num ficheiro de tradução habitual. Repare que a sintaxe de plural ICU e os marcadores de interpolação são preservados com exatidão.

Before & After

// Input (en.json):
{
  "greeting": "Hello, {name}!",
  "save": "Save",
  "items": "{count, plural, one {# item} other {# items}}"
}

// Output (default preset — accents + brackets):
{
  "greeting": "[Ĥéľľó, {name}!]",
  "save": "[Šáṽé]",
  "items": "[{count, plural, one {# íťéɱ} other {# íťéɱš}}]"
}

Os marcadores como {name} e {count} e as expressões de plural ICU nunca são alterados. Apenas os segmentos de texto traduzível são transformados, pelo que a aplicação apresenta corretamente os ficheiros pseudotraduzidos.

Integração com CI

Adicione a pseudotradução ao pipeline de CI para detetar automaticamente regressões de i18n. Gere ficheiros pseudotraduzidos e execute os testes de regressão visual sobre eles.

CI Pipeline

# Generate pseudo-translations and run visual regression
i18n-pseudo locales/en.json --preset layout -o locales/pseudo/
NEXT_PUBLIC_LOCALE=pseudo npx playwright test --project=visual

Combine a predefinição de disposição com testes de regressão visual no Playwright ou Chromatic. Qualquer componente que transborde ou fique cortado com texto expandido 1,4 vezes falhará na comparação visual.