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

A pseudotradução substitui as strings 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. Detecta cedo erros de layout, strings codificadas diretamente, problemas de codificação e falhas RTL, antes de pagar traduções reais.

Danifica 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 padrão —acentos e colchetes— para encontrar strings codificadas diretamente. Depois utilize a predefinição de layout para detectar truncamento e conteúdo excedente. Utilize charset se aceitar idiomas CJK e rtl se aceitar árabe ou hebraico.

Como integro a pseudotradução em CI?

Gere arquivos 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 pseudolocalidade. Qualquer layout 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 o layout, a codificação e a apresentação bidirecional a testes exigentes, sem esperar pelas traduções reais.

O problema

Sua interface parece perfeita em inglês. Depois chega o alemão: strings 40% maiores quebram todos os botões e cortam os cabeçalhos das tabelas. O árabe inverte todo o layout e os ícones apontam para o lado errado. O japonês precisa de outras alturas de linha e os cartões cuidadosamente espaçados se desmoronam. Você descobre tudo isso depois de pagar pelas traduções.

O custo médio de corrigir erros de layout de i18n após a tradução é 5 a 10 vezes superior ao de os detectar durante o desenvolvimento. A pseudotradução os encontra gratuitamente, antes de gastar um real 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 detectar strings codificadas diretamente. Se uma string 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 arquivo de localidade 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 padrão —acentos e colchetes— em um arquivo de tradução habitual. Observe 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, por isso a aplicação apresenta corretamente os arquivos pseudotraduzidos.

Integração com CI

Adicione a pseudotradução ao pipeline de CI para detectar automaticamente regressões de i18n. Gere arquivos 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 layout 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.