Publicamos a versão em árabe numa quinta. Os textos estavam certos, o alinhamento estava certo, e a seta de voltar continuava apontando pra saída. A barra de progresso enchia pelo lado errado, o onboarding andava pra trás e os dígitos de um telefone no meio da frase apareciam reordenados como erro de digitação. A tradução não tinha defeito nenhum. A gente só tinha colocado direction: rtl na raiz e presumido que a interface viria junto.

Não vem. Direcionalidade não é propriedade do texto, é espacial. Cada ícone que significa movimento, cada deslocamento que você escreveu com left, cada gesto e cada linha do tempo foram desenhados pensando num mundo da esquerda pra direita. Vira o texto e essas decisões ficam exatamente onde estavam, erradas em silêncio.

Onde o giro não alcança

A auditoria útil não é «a página parece espelhada?», é «que elementos carregam sentido pela direção?». Tem mais do que ninguém espera na primeira passada.

ElementoO que o LTR assumeO que o RTL precisa de fatoO que costuma faltar
Seta de voltarAponta pra esquerdaAponta pra direita, e a pilha de navegação toda lê da direita pra esquerdaO ícone virou, o gesto de deslizar pra voltar não
Barra de progressoEnche da esquerda pra direitaEnche da direita pra esquerdawidth e a direção do gradiente seguem fixos
Telefone no meio da fraseA string tem uma direção sóDígitos ficam LTR, o texto em volta fica RTLEnvolver a string inteira em direction: rtl
Rótulos de formulárioFicam à esquerdaFicam à direita, mas campos de número e e-mail seguem LTRUsar text-align em vez de alinhamento lógico
Selos no cantoleft: 8pxinset-inline-start: 8pxPseudoelementos ainda presos ao left
Deslizar pra avançarDeslizar pra esquerda avançaAvançar é da direita pra esquerdaCarrossel e onboarding mantêm a ordem LTR
Gráficos e linhas do tempoO tempo vai da esquerda pra direitaO tempo vai da direita pra esquerda; rótulos do eixo são bidiSó o contêiner virou

Texto bidirecional é a linha que continua nos mordendo. Um número, uma marca em alfabeto latino ou um @handle dentro de uma frase árabe mantém a própria direção, e o algoritmo bidi do navegador acerta quase sempre — até você acrescentar pontuação, parênteses ou um direction a mais num contêiner. Aí o parêntese de fechamento cai do lado errado e alguém abre como bug de tradução. Não é. É bug de marcação, e nenhum tradutor consegue consertar pra você.

O custo, sem disfarce

Vamos ser diretos sobre o preço: isso é refazer o design system, não um patch na folha de estilo. Se seus componentes codificam posição com left, right, margin-left e padding-right, você tem centenas de decisões pequenas pra converter em propriedades lógicas. Já fizemos pela metade uma vez, e pela metade é pior que não começar: agora uns componentes espelham e outros não, e ninguém prevê quais. Ou você assume inline-start / inline-end na biblioteca inteira, ou aceita que RTL vai ser um build de segunda classe pra sempre.

Conteúdo de direção mista não se resolve com automação. Não existe linter que diga com confiança se uma string vai renderizar bem quando um usuário digitar o nome latino dele num campo árabe. Você precisa de fixtures reais: texto árabe real, hebraico real, um telefone de verdade, uma marca latina, uma data, revisados por alguém que lê o idioma. E isso puxa a conta que ninguém bota no sprint: a matriz de testes dobra. Cada tela, cada estado e cada animação agora tem duas direções, e a metade RTL é justamente a que o time domina menos. Já pegamos mais regressão RTL em dez minutos de passeio com um leitor nativo do que num mês comparando screenshots.

E tem o hábito desconfortável do setor que vale nomear: árabe e hebraico são tratados como polimento da semana de lançamento. O time constrói o produto inteiro em LTR, «adiciona RTL» logo antes de entrar num mercado, esbarra nos problemas de ícone e gesto acima e publica uma versão que tecnicamente funciona e soa sutilmente estranha pra quem era o público. Isso não é história de dívida técnica, é de priorização. Fazer tarde custa mais, sim; não fazer nunca custa o mercado. A gente prefere abrir a migração pra propriedades lógicas cedo, enquanto a biblioteca ainda é pequena e a discussão sai barato.

Mais um limite honesto: tem coisa que não devia espelhar. Botão de play, o sentido da barra de um player e o logo da marca costumam ficar parados, e um teclado de telefone tem lógica própria. Espelhar tudo no atacado é tão errado quanto não espelhar nada. Decidir caso a caso é mais lento, e é o trabalho.

Construa a direção dentro, não por cima

Ponha dir na raiz do documento e deixe as propriedades lógicas carregarem o layout, pra um único atributo virar a árvore inteira. Audite os ícones direcionais como um conjunto com nome, não como SVGs espalhados, e dê a eles uma variante espelhada. Mantenha explicitamente LTR os campos numéricos e latinos dentro de um formulário RTL. Acrescente fixtures bidi com pontuação real nos testes de snapshot e consiga um leitor nativo pra percorrer checkout e onboarding nas duas direções antes de chamar de pronto.

O teste rápido é de uma simplicidade irritante: mude um aparelho de teste pra árabe, abra o app, tente voltar, deslize o onboarding e leia um preço com um telefone embaixo. Se qualquer uma dessas três der sensação de estar nadando contra a corrente, o texto nunca foi o problema. Era o espaço em volta dele.

Fontes