diff --git a/.github/workflows/test-i18n.yml b/.github/workflows/test-i18n.yml new file mode 100644 index 00000000..5786b4fa --- /dev/null +++ b/.github/workflows/test-i18n.yml @@ -0,0 +1,32 @@ +name: i18n tests + +on: + pull_request: + push: + branches: [main] + paths: + - 'shared/i18n*.js' + - 'shared/locales/**' + - 'shared/test/**' + - 'windows/**' + - 'linux/**' + - 'mac/**' + - 'android/app/src/main/res/**' + - 'website/locales/**' + +jobs: + i18n: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 20 + - run: node shared/test/i18n.js + - run: node shared/test/i18n-coverage.js + - run: node shared/test/i18n-glossary.js + - run: node shared/test/i18n-scope.js + - run: node shared/test/ui-load.js + - run: node shared/test/packaging.js + - run: node shared/test/sidebar-model.js + - run: node shared/test/traymenu.js diff --git a/docs/i18n-coverage.md b/docs/i18n-coverage.md new file mode 100644 index 00000000..62787a51 --- /dev/null +++ b/docs/i18n-coverage.md @@ -0,0 +1,15 @@ +# Cobertura de tradução (gerado por `node shared/test/i18n-coverage.js --write`) + +Literais de interface em inglês fora de `t()`, por superfície. Heurística: ver o cabeçalho do teste. + +| Superfície | Arquivos | Chamadas `t()` | Literais em inglês | % pendente | +|---|---|---|---|---| +| Páginas do desktop | 57 | 2295 | 0 | 0.0% | +| Mesh | 16 | 913 | 0 | 0.0% | +| Módulos shared/ui | 19 | 907 | 0 | 0.0% | +| Processo principal | 183 | 636 | 0 | 0.0% | +| Efeitos e módulos shared | 18 | 513 | 0 | 0.0% | +| Janelas pequenas | 32 | 53 | 0 | 0.0% | + +## Pendentes + diff --git a/docs/i18n-glossary.md b/docs/i18n-glossary.md new file mode 100644 index 00000000..99a536b5 --- /dev/null +++ b/docs/i18n-glossary.md @@ -0,0 +1,22 @@ +# Glossário pt-BR do DuoDesk + +Termos fixos da interface em português do Brasil. O teste `shared/test/i18n-glossary.js` falha se um termo +proibido aparecer em `shared/locales/pt-BR.js`, em `android/.../values-pt-rBR/strings.xml` ou em +`website/locales/pt-BR.json`. Tratamento: sempre "você". + +| Inglês | Use | Não use | +|---|---|---| +| pair, pairing, paired | parear, pareamento, pareado | emparelhar, emparelhamento | +| app (aplicativo) | aplicativo | app, apps | +| on / off (estado de um recurso) | ativado, desativado, ativar, desativar | ligado, desligado, ligar, desligar | +| phone | telefone | celular, smartphone | +| clipboard | área de transferência | clipboard | +| debugging | depuração | debug | +| hotspot | ponto de acesso | hotspot | +| wireless | sem fio | wireless | +| you, your | você, seu/sua | tu, teu/tua | + +Exceções: nomes próprios e de produtos (Wi-Fi Direct, Bluetooth, Android, GitHub), a palavra "Ligar" só como +verbo de chamada telefônica, e "desligar o computador" (energia). +Regras de estilo: frase em "sentence case" nos textos corridos; "Title Case" só onde o inglês também usa; +sem gênero preso ao nome do dispositivo (`{phone}`, `{name}`): reescrever na forma neutra. diff --git a/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md b/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md new file mode 100644 index 00000000..de6fe54b --- /dev/null +++ b/docs/superpowers/plans/2026-10-31-duodesk-i18n-implantacao.md @@ -0,0 +1,126 @@ +# DuoDesk i18n pt-BR: plano de implantação + +Data: 2026-10-31. Complementa `2026-10-31-duodesk-i18n-pt-br.md` (arquitetura). Este plano cobre o que falta +para publicar o pt-BR e como colocá-lo no ar sem regressão no inglês. + +## 1. Estado atual + +Commits locais à frente de `origin/main`: 12 (motor, dicionários, desktop, Android, site, docs, correções). +Nada foi enviado ao remoto. + +Pronto: +- Motor `shared/i18n.js`, dicionários `en`/`pt-BR` (~1.190 chaves, paridade de `{param}` testada). +- Desktop (Windows, Linux, macOS): navegação, cabeçalhos e descrições das abas, todas as páginas principais, + bandeja/barra de menus, seletor de idioma em Geral, persistência em `settings.app.lang`. +- Shells mesh: carregam o i18n e traduzem a navegação e os cabeçalhos. +- Android: ~550 strings em `values` e `values-pt-rBR`, 5 plurais. +- Site: troca EN/PT, `404.js` e `lang-boot.js` compatíveis com a CSP. +- README e docs em pt-BR. + +Pendente (desktop, em inglês): +1. `mesh/ui-*.js` (Windows 5 arquivos, Linux 4, macOS 5). +2. `shared/ui-*.js`, `pairpop.js`, `aurora-shell.js` (hub, chamadas, mensagens, mídia, arquivos do telefone, + dispositivo, espelho, câmera, suporte, janela de atualização, QR/ADB). +3. Janelas pequenas: HUD, appview, phoneview, sender, sound, monitor, appsend, audio, capture, pcview + (usar `shared/i18n-dom.js`, já criado). +4. Processo principal: notificações, diálogos, HUD, mensagens de erro/status em `windows/*.js`, `linux/*.js`, + `mac/*.js` e `shared/*.js` de Node. +5. Android: `Hub.label`, `Files.plural`, `FolderShare.shown()`, rótulos do `AndroidManifest.xml`. + +## 2. Fase A: concluir o desktop + +Método (o mesmo que funcionou na rodada anterior): +- Um lote por grupo de arquivos, sem arquivos em comum entre lotes. Cada lote envolve o texto em + `t(chave, params, inglês_exato)` e grava só as chaves novas em um fragmento JSON; ninguém edita + `shared/locales/*.js` durante o lote. +- Convenção de chave: `.`; prefixos `mesh_`, `meshm_`, `win_`, `lin_`, `mac_`, `sh_` por grupo. +- Regras: inglês idêntico ao original; `{me}`, `{name}`, `{Name}`, `{the}`, `{There}` ficam no texto + (o `UI.fill` os preenche); sem concatenação de fragmentos; plural em `_one`/`_other`; não traduzir logs, + texto comparado no código, mensagens enviadas ao outro dispositivo, nomes de marca. +- Ordem sugerida (menor risco primeiro): janelas pequenas, `shared/ui-*`, mesh, processo principal. + O processo principal é o mais arriscado: grep do texto antes de embrulhar, para não quebrar comparações. + +Mesclar fragmentos (script de mescla): +- Chave igual com inglês diferente entre plataformas vira variante `_linux`/`_mac` e o código dessa + plataforma é renomeado. +- Chave igual com pt diferente: prevalece a do Windows; revisar a lista de divergências. +- Regravar os dicionários, rodar a validação (seção 4). + +Critério de pronto da fase: nenhum literal de interface em inglês fora das exceções documentadas +(marcas, unidades, texto vindo do telefone ou do outro computador). + +## 3. Fase B: Android + +1. Instalar JDK 17+ e o Android SDK (a máquina atual não tem); `cd android && ./gradlew :app:assembleDebug`. +2. Corrigir o que o compilador acusar (principal risco: `stringResource` fora de contexto composable, + `pluralStringResource` sem opt-in). +3. Traduzir `Hub.label`, `Files.plural`, `FolderShare.shown()` e os rótulos do manifest + (`strings.xml` com `@string/...`). +4. Teste em aparelho/emulador com idioma do sistema em Português (Brasil) e em English: percorrer + Visão Geral, Conexão, Chamadas, Mensagens, Arquivos, Mouse, Ajustes, diálogos de pareamento, + notificações; procurar texto cortado e quebras de linha. + +## 4. Verificação (portões antes de qualquer merge) + +Automáticos (todos devem passar; `applog`, `kvm-moves`, `movebench` já falham em `origin/main`): +```bash +for t in shared/test/*.js; do node "$t" >/dev/null 2>&1 || echo "FAIL $t"; done +node shared/test/i18n.js # paridade, chaves usadas existem +node shared/test/packaging.js # locales e i18n entram nos instaladores +``` +Acrescentar ao repositório (hoje só existem como scripts soltos): +- Verificação de padrão em inglês: todo `t('chave', p, 'inglês')` literal deve igualar o valor em `en.js` + (pegou a regressão de `sidebar.nearby` e da navegação). +- Verificação de chaves órfãs. +- Verificação de parâmetros: toda chave com `{x}` recebe `x` no ponto de chamada (exceto os tokens do `UI.fill`). + +Manual, por plataforma (Windows, macOS, Linux X11/Wayland), com `lang` em `auto`, `en` e `pt-BR`: +- Trocar o idioma em Geral: recarrega, nav, cabeçalhos, descrições e bandeja mudam. +- Cada aba abre sem erro no console; conferir texto cortado em 1366×768, 1440×900 e 375×812 (mesh/janela estreita). +- Pareamento completo com outro computador e com o telefone: banner, códigos, estados. +- Bandeja: conectado e desconectado, "Conectar a", "Procurar novamente". +- Migração: perfil que tinha o idioma só no `localStorage` passa a ter `settings.app.lang`. +- Inglês idêntico ao de `origin/main` (comparar capturas de 3 páginas por plataforma). + +Site: `node website/dev-server.js`; EN e PT, `/404`, recarga com PT salvo (sem flash), CSP sem erro no console +(sem script inline). + +## 5. Fase C: integração e publicação + +1. Rebase/merge de `main` na branch de trabalho; resolver conflitos (as páginas `ui-*.js` mudam muito). +2. Abrir PR por área para facilitar a revisão: (a) motor + dicionários + testes; (b) desktop; (c) Android; + (d) site + docs. Cada PR passa pelos portões da seção 4. +3. Antes do `push`: confirmar com o dono do repositório (o remoto é `0xCodez/DuoDesk`; se não houver + permissão de push, enviar para um fork e abrir PR do fork). +4. Versão: subir a versão do app (changelog: "Português (Brasil)"), atualizar o `README.md` e `README.pt-BR.md` + (número da versão, links de download) e as notas da release. +5. CI/instaladores: gerar `.exe`, `.dmg`, `.deb`/AppImage, Nix e APK; instalar cada artefato em máquina limpa e + confirmar que `shared/locales/` existe no pacote e o idioma troca. +6. Site: deploy na Vercel (preview primeiro); conferir `vercel.json` (CSP com `404.js` e `lang-boot.js`). +7. Anúncio: release no GitHub com as notas em EN e PT. + +## 6. Riscos e reversão + +| Risco | Mitigação | +|---|---| +| Regressão no inglês (texto padrão diferente do dicionário) | portão de padrão em inglês na seção 4 | +| Texto comparado no código quebra ao traduzir (processo principal) | grep antes de embrulhar; testes de `shared/test` | +| Idioma só definido depois do carregamento (constantes no topo do módulo) | traduzir no uso/renderização, nunca na carga | +| Janela que não carrega `i18n.js` mostra chave | padrão em inglês no `t()` local cobre; checar no manual | +| Android não compila | Fase B antes de qualquer PR do Android | +| Instalador sem `locales/` | `packaging.js` + instalação em máquina limpa | + +Reversão: cada área vai em PR próprio e o idioma cai para inglês sozinho se o dicionário `pt-BR` falhar +(`t()` usa `en`). Para desligar o pt-BR sem reverter código: remover a opção `pt-BR` do seletor em Geral +e do `getAvailableLanguages`, e forçar `en` em `applyLanguage`. + +## 7. Ordem e estimativa + +1. Fase A, janelas pequenas e `shared/ui-*` (lotes paralelos), mescla, validação. +2. Fase A, mesh e processo principal, mescla, validação. +3. Fase B (depende de JDK/SDK). +4. Verificação manual nas 3 plataformas + site. +5. PRs e publicação (Fase C). + +As fases A e B são independentes e podem andar em paralelo. A verificação manual é o gargalo: +precisa de uma máquina de cada sistema. diff --git a/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md b/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md new file mode 100644 index 00000000..71837f6e --- /dev/null +++ b/docs/superpowers/plans/2026-10-31-duodesk-i18n-pt-br.md @@ -0,0 +1,434 @@ +# DuoDesk i18n & Tradução para Português (Brasil) Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Implementar arquitetura de internacionalização (i18n) completa e traduzir 100% do DuoDesk para Português do Brasil (pt-BR) abrangendo Desktop (Windows/macOS/Linux), Documentação, Android e Website. + +**Architecture:** Módulo core `shared/i18n.js` isomórfico (Node + Browser) zero-dependency com dicionários `shared/locales/en.js` e `shared/locales/pt-BR.js`. Integração em renderers Electron via script tags e persistência via store local. No Android, extração para `values-pt-rBR/strings.xml` com integração Jetpack Compose. Na documentação, `README.pt-BR.md` completo com seletor de idiomas. + +**Tech Stack:** JavaScript (ES6 vanilla, Node.js assert), HTML5/CSS3, Electron, Android Kotlin (Jetpack Compose, XML resources), Markdown. + +**Spec:** [duodesk-i18n-spec.md](file:///C:/Users/Mau/.gemini/antigravity/brain/2ead9a51-f63f-4695-b736-2f0c7af12ec9/duodesk-i18n-spec.md) + +## Global Constraints + +- Zero dependências npm externas adicionadas aos pacotes de runtime do Electron. +- Compatibilidade estrita com Content-Security-Policy (`script-src 'self'`). +- Carregamento síncrono das traduções evitando Cumulative Layout Shift (CLS) e flashes de conteúdo sem tradução (FOUT). +- Fallback automático para `en` quando uma chave não existir no idioma selecionado. +- Preservar integridade de código, testes existentes e compatibilidade com macOS, Windows e Linux. + +## Review Focus + +1. Interpolação de variáveis ausentes ou nulas em `t(key, params)` não deve lançar erro nem quebrar a UI, retornando a string original ou o placeholder intacto. +2. Troca de idioma em runtime em Configurações Gerais deve atualizar imediatamente os textos visíveis sem exigir reinicialização manual do app. +3. Chave inexistente deve retornar a chave original ou o `defaultText` em vez de `undefined`. +4. Detecção de idioma do sistema (`navigator.language`) deve mapear variantes como `pt`, `pt-BR`, `pt_BR` para o catálogo `pt-BR`. +5. Recursos Android não devem falhar em tempo de compilação ou execução caso o dispositivo utilize um locale não traduzido (fallback para `values/strings.xml`). + +--- + +### Task 1: Core i18n Engine & Catálogos de Idioma (Desktop & Shared) + +**Files:** +- Create: `shared/locales/en.js` +- Create: `shared/locales/pt-BR.js` +- Create: `shared/i18n.js` +- Test: `shared/test/i18n.js` + +**Interfaces:** +- Produces: + - `i18n.t(key: string, params?: object, defaultText?: string): string` + - `i18n.setLanguage(lang: string): string` + - `i18n.getLanguage(): string` + - `i18n.getAvailableLanguages(): Array<{code: string, label: string}>` + - `i18n.onLanguageChange(listener: (lang: string) => void): () => void` + +- [ ] **Step 1: Escrever teste de unidade que falha para o motor i18n** + +Criar `shared/test/i18n.js`: +```javascript +'use strict'; +const assert = require('assert'); +const i18n = require('../i18n.js'); + +// Teste 1: Chave básica em inglês padrão +i18n.setLanguage('en'); +assert.strictEqual(i18n.t('app.name'), 'DuoDesk'); + +// Teste 2: Alternância para pt-BR +i18n.setLanguage('pt-BR'); +assert.strictEqual(i18n.t('nav.overview'), 'Visão Geral'); + +// Teste 3: Interpolação de parâmetros +assert.strictEqual( + i18n.t('pair.hint_code', { code: '1234' }), + 'Digite o código 1234 no outro computador' +); + +// Teste 4: Fallback para chave inexistente +assert.strictEqual(i18n.t('non.existent.key', null, 'Texto Fallback'), 'Texto Fallback'); + +// Teste 5: Listener de mudança de idioma +let changedTo = null; +const unsubscribe = i18n.onLanguageChange((lang) => { changedTo = lang; }); +i18n.setLanguage('en'); +assert.strictEqual(changedTo, 'en'); +unsubscribe(); + +console.log('i18n: ok'); +``` + +- [ ] **Step 2: Executar teste para verificar falha inicial** + +Comando: `node shared/test/i18n.js` +Esperado: FAIL com `Cannot find module '../i18n.js'` + +- [ ] **Step 3: Implementar catálogos e motor core `shared/i18n.js`** + +Criar `shared/locales/en.js`: +```javascript +(function (root, factory) { + if (typeof module === 'object' && module.exports) module.exports = factory(); + else { + root.DuoDeskLocales = root.DuoDeskLocales || {}; + root.DuoDeskLocales['en'] = factory(); + } +})(typeof globalThis !== 'undefined' ? globalThis : this, function () { + return { + 'app.name': 'DuoDesk', + 'app.not_paired': 'Not paired', + 'app.paired_with': 'Paired with {name}', + 'nav.overview': 'Overview', + 'nav.screens': 'Screens', + 'nav.cursor': 'Mouse & Keys', + 'nav.audio': 'Audio', + 'nav.files': 'Files', + 'nav.apps': 'Apps', + 'nav.phone': 'Phone', + 'nav.settings': 'General', + 'nav.about': 'About', + 'pair.title': 'Pairing', + 'pair.code_label': 'Code', + 'pair.match': 'Codes match', + 'pair.cancel': 'Cancel', + 'pair.hint_code': 'Type the code {code} on the other computer', + 'general.language': 'Language', + 'general.lang_auto': 'Automatic (System)', + 'general.lang_en': 'English', + 'general.lang_pt_br': 'Português (Brasil)' + }; +}); +``` + +Criar `shared/locales/pt-BR.js`: +```javascript +(function (root, factory) { + if (typeof module === 'object' && module.exports) module.exports = factory(); + else { + root.DuoDeskLocales = root.DuoDeskLocales || {}; + root.DuoDeskLocales['pt-BR'] = factory(); + } +})(typeof globalThis !== 'undefined' ? globalThis : this, function () { + return { + 'app.name': 'DuoDesk', + 'app.not_paired': 'Não pareado', + 'app.paired_with': 'Pareado com {name}', + 'nav.overview': 'Visão Geral', + 'nav.screens': 'Telas', + 'nav.cursor': 'Mouse e Teclado', + 'nav.audio': 'Áudio', + 'nav.files': 'Arquivos', + 'nav.apps': 'Aplicativos', + 'nav.phone': 'Telefone', + 'nav.settings': 'Geral', + 'nav.about': 'Sobre', + 'pair.title': 'Pareamento', + 'pair.code_label': 'Código', + 'pair.match': 'Códigos coincidem', + 'pair.cancel': 'Cancelar', + 'pair.hint_code': 'Digite o código {code} no outro computador', + 'general.language': 'Idioma', + 'general.lang_auto': 'Automático (Sistema)', + 'general.lang_en': 'English', + 'general.lang_pt_br': 'Português (Brasil)' + }; +}); +``` + +Criar `shared/i18n.js`: +```javascript +(function (root, factory) { + if (typeof module === 'object' && module.exports) { + const en = require('./locales/en.js'); + const ptBR = require('./locales/pt-BR.js'); + module.exports = factory({ 'en': en, 'pt-BR': ptBR }); + } else { + root.DuoDeskI18n = factory(root.DuoDeskLocales || {}); + root.t = root.DuoDeskI18n.t; + } +})(typeof globalThis !== 'undefined' ? globalThis : this, function (locales) { + 'use strict'; + let currentLang = 'en'; + const listeners = new Set(); + + function normalizeLang(lang) { + if (!lang) return 'en'; + const lower = String(lang).toLowerCase(); + if (lower.startsWith('pt')) return 'pt-BR'; + if (lower.startsWith('en')) return 'en'; + return locales[lang] ? lang : 'en'; + } + + function t(key, params, defaultText) { + const dict = locales[currentLang] || locales['en'] || {}; + const fallbackDict = locales['en'] || {}; + let text = dict[key] !== undefined ? dict[key] : (fallbackDict[key] !== undefined ? fallbackDict[key] : (defaultText !== undefined ? defaultText : key)); + if (params && typeof params === 'object') { + text = String(text).replace(/\{(\w+)\}/g, (_, k) => (params[k] !== undefined && params[k] !== null ? params[k] : `{${k}}`)); + } + return text; + } + + function setLanguage(lang) { + currentLang = normalizeLang(lang); + listeners.forEach(fn => { try { fn(currentLang); } catch (e) { console.error(e); } }); + return currentLang; + } + + function getLanguage() { return currentLang; } + + function getAvailableLanguages() { + return [ + { code: 'en', label: 'English' }, + { code: 'pt-BR', label: 'Português (Brasil)' } + ]; + } + + function onLanguageChange(fn) { + listeners.add(fn); + return () => listeners.delete(fn); + } + + return { t, setLanguage, getLanguage, normalizeLang, getAvailableLanguages, onLanguageChange }; +}); +``` + +- [ ] **Step 4: Executar teste para verificar sucesso** + +Comando: `node shared/test/i18n.js` +Esperado: `i18n: ok` com exit code 0. + +- [ ] **Step 5: Commit** + +```bash +git add shared/locales/ shared/i18n.js shared/test/i18n.js +git commit -m "feat(i18n): add zero-dependency i18n core engine and pt-BR locale" +``` + +--- + +### Task 2: Integração Desktop & Seletor de Idioma em Configurações + +**Files:** +- Modify: `windows/app.html:52-56` +- Modify: `windows/ui-general.js` +- Modify: `shared/sidebar-model.js` +- Modify: `windows/main.js` (ou detecção via preload) +- Test: Carregar `windows/app.html` via Electron ou validação de script tags. + +**Interfaces:** +- Consumes: `DuoDeskI18n.setLanguage`, `DuoDeskI18n.t`, `DuoDeskI18n.onLanguageChange` +- Produces: Seleção persistente em `store.set('general.language', value)` e re-render dos rótulos de navegação e status. + +- [ ] **Step 1: Adicionar scripts de i18n em `windows/app.html`** + +Inserir as tags de script antes dos demais módulos de interface: +```html + + + +``` + +- [ ] **Step 2: Atualizar `shared/sidebar-model.js` para usar chaves de i18n dinâmicas** + +Garantir que a renderização dos títulos dos menus passe por `t('nav.' + pageId)`. + +- [ ] **Step 3: Adicionar campo seletor de idioma em `windows/ui-general.js`** + +Implementar card "Idioma / Language" na tela Geral: +```javascript +const langRow = renderSelect({ + label: t('general.language'), + value: store.get('general.language') || 'auto', + options: [ + { value: 'auto', label: t('general.lang_auto') }, + { value: 'pt-BR', label: 'Português (Brasil)' }, + { value: 'en', label: 'English' } + ], + onChange: (val) => { + store.set('general.language', val); + const target = val === 'auto' ? navigator.language : val; + DuoDeskI18n.setLanguage(target); + location.reload(); + } +}); +``` + +- [ ] **Step 4: Validar sintaxe e integridade dos arquivos modificados** + +Comando: `node -c windows/ui-general.js shared/sidebar-model.js` +Esperado: Exit code 0 sem erros de sintaxe. + +- [ ] **Step 5: Commit** + +```bash +git add windows/app.html windows/ui-general.js shared/sidebar-model.js +git commit -m "feat(ui): integrate i18n into desktop shell and general settings" +``` + +--- + +### Task 3: Tradução Completa dos Dicionários e Sub-sistemas Desktop + +**Files:** +- Modify: `shared/locales/en.js` +- Modify: `shared/locales/pt-BR.js` +- Modify: `windows/ui-overview.js` +- Modify: `windows/ui-cursor.js` +- Modify: `windows/ui-clipboard.js` +- Modify: `windows/ui-files.js` +- Modify: `shared/phonehub.js` + +**Interfaces:** +- Consumes: `t()` em todas as mensagens de status, cards e ações do usuário. + +- [ ] **Step 1: Expandir catálogo `shared/locales/pt-BR.js` e `en.js` com todos os termos dos módulos** + +Mapear termos de: +- Pareamento e KVM (Bordas, ativação suave, troca de comando). +- Compartilhamento de arquivos (arrastar e soltar, downloads recebidos). +- Telefone (chamadas, mensagens, câmera remota, espelhamento). +- Áudio e tela secundária. + +- [ ] **Step 2: Substituir strings hardcoded por chamadas `t()` nos componentes de tela** + +Atualizar `ui-overview.js`, `ui-cursor.js`, `ui-clipboard.js`, `ui-files.js` e `phonehub.js` usando `t(key, params, defaultEnglish)`. + +- [ ] **Step 3: Testar consistência dos catálogos** + +Adicionar em `shared/test/i18n.js` verificação de paridade de chaves: +```javascript +const enKeys = Object.keys(require('../locales/en.js')()); +const ptKeys = Object.keys(require('../locales/pt-BR.js')()); +assert.deepStrictEqual(enKeys.sort(), ptKeys.sort(), 'Chaves en e pt-BR devem ser idênticas'); +``` + +- [ ] **Step 4: Executar teste de paridade de chaves** + +Comando: `node shared/test/i18n.js` +Esperado: `i18n: ok` + +- [ ] **Step 5: Commit** + +```bash +git add shared/locales/ windows/ui-*.js shared/phonehub.js shared/test/i18n.js +git commit -m "feat(i18n): expand full pt-BR translation across desktop components" +``` + +--- + +### Task 4: Tradução da Documentação (`README.pt-BR.md` e `docs/`) + +**Files:** +- Create: `README.pt-BR.md` +- Modify: `README.md:1-20` +- Create: `docs/mesh.pt-BR.md` +- Create: `docs/screen-mesh.pt-BR.md` + +- [ ] **Step 1: Criar o `README.pt-BR.md` completo e localizado** + +Traduzir todas as seções: +- Apresentação: "Todos os seus computadores e seu telefone funcionando em uma única mesa." +- Recursos: Computadores, Telefones e tablets, Conexões, Primeiros passos. +- Instruções de compilação e execução para Windows, macOS, Linux, NixOS e Android. + +- [ ] **Step 2: Adicionar banner de alternância de idioma no topo do `README.md` original** + +Inserir no topo de `README.md`: +```markdown +

+ 🌐 Idiomas / Languages: English · Português (Brasil) +

+``` + +- [ ] **Step 3: Traduzir guias de arquitetura em `docs/*.pt-BR.md`** + +Traduzir `docs/mesh.md` e `docs/screen-mesh.md` mantendo precisão técnica e formatação. + +- [ ] **Step 4: Validar links e referências entre os arquivos Markdown** + +Verificar existência de links relativos e integridade de imagens. + +- [ ] **Step 5: Commit** + +```bash +git add README.pt-BR.md README.md docs/*.pt-BR.md +git commit -m "docs: add full Portuguese (Brazil) translation for README and docs" +``` + +--- + +### Task 5: Localização do Aplicativo Android (Kotlin / Jetpack Compose) + +**Files:** +- Modify: `android/app/src/main/res/values/strings.xml` +- Create: `android/app/src/main/res/values-pt-rBR/strings.xml` +- Modify: `android/app/src/main/java/com/twindesk/android/MainActivity.kt` + +- [ ] **Step 1: Definir recursos em `values/strings.xml` e `values-pt-rBR/strings.xml`** + +Criar `values-pt-rBR/strings.xml` com traduções completas: +```xml + + + DuoDesk + Depuração sem fio + Ativar depuração sem fio + Tela do computador + Exibir a tela do computador + DuoDesk: mouse e teclado do computador + Permite que o computador pareado no DuoDesk toque, role e digite neste celular com mouse e teclado quando a depuração sem fio não estiver disponível. + +``` + +- [ ] **Step 2: Mapear textos do Jetpack Compose para recursos traduzíveis** + +Ajustar `MainActivity.kt` para garantir que o app reflita automaticamente o idioma do sistema operacional do smartphone. + +- [ ] **Step 3: Commit** + +```bash +git add android/app/src/main/res/ android/app/src/main/java/ +git commit -m "feat(android): add pt-BR string resources and localization" +``` + +--- + +### Task 6: Localização do Website (`website/`) + +**Files:** +- Modify: `website/index.html` +- Create: `website/locales/pt-BR.json` (ou script de tradução dinâmica) +- Modify: `website/app.js` + +- [ ] **Step 1: Adicionar suporte a pt-BR no website** + +Configurar alternância de idioma no cabeçalho do site com armazenamento em `localStorage`. + +- [ ] **Step 2: Commit** + +```bash +git add website/ +git commit -m "feat(website): add Portuguese (Brazil) support to DuoDesk website" +``` diff --git a/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md b/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md new file mode 100644 index 00000000..d3e7ba7f --- /dev/null +++ b/docs/superpowers/plans/2026-11-01-duodesk-i18n-nota-9-5.md @@ -0,0 +1,139 @@ +# DuoDesk i18n pt-BR: plano para chegar a 9,5 + +Data: 2026-11-01. Parte da análise de hoje (nota 8,3) e do plano de publicação +`2026-10-31-duodesk-i18n-implantacao.md`. Este plano diz o que mudar, em que ordem, e como medir cada ganho. + +## 1. Meta e como a nota é calculada + +Média simples de quatro dimensões. Para 9,5 de média, nenhuma dimensão fica abaixo de 9,0. + +| Dimensão | Hoje | Meta | O que falta | +|---|---|---|---| +| Qualidade do português | 8,5 | 9,5 | vocabulário padronizado, revisão de frases longas | +| Cobertura | 7,8 | 9,5 | mesh, janelas pequenas, processo principal, assistente | +| Robustez técnica | 9,0 | 9,5 | portões de CI, cobertura medida, verificação em app rodando | +| Site, README, docs | 9,5 | 9,5 | manter | + +Cobertura 9,5 significa: menos de 1% de literais em inglês nas superfícies que o usuário vê, fora das exceções +documentadas (marcas, unidades, texto que vem do telefone ou do outro computador). + +## 2. Fase 1: medir (meio dia) + +Sem medição, a nota é opinião. Antes de traduzir mais, transformar os scripts soltos em portões do repositório. + +1. `shared/test/i18n-coverage.js`: varre os arquivos de interface e do processo principal e conta literais de + interface em inglês fora de `t()`. Gera `docs/i18n-coverage.md` (tabela por superfície). + Lista de exceções em `shared/test/i18n-allow.json` (marcas, unidades, campos de definição de aba). + Falha se a contagem passar do limite gravado. O limite desce a cada fase (nunca sobe). +2. `shared/test/i18n-defaults.js`: todo `t('chave', p, 'inglês')` literal tem o mesmo texto de `en.js`. +3. `shared/test/i18n-orphans.js`: nenhuma chave sem uso (exceto `nav.*`, `tab.*`, `tray.*` montadas em tempo de execução). +4. `shared/test/i18n-params.js`: cada `{x}` do dicionário recebe `x` no ponto de chamada (exceto os tokens do + `UI.fill`: `me`, `name`, `Name`, `the`, `There`, `them`). +5. `shared/test/i18n-glossary.js`: lê `docs/i18n-glossary.md` (seção 3) e falha se o `pt-BR.js` usar um termo + proibido (ex.: "emparelh", "app " fora de nomes próprios, "ligar/desligar" para estados). +6. Ligar tudo no CI (`npm test` ou o job existente) e exigir verde antes de merge. + +Saída da fase: linha de base numérica por superfície e CI que impede regressão. + +## 3. Fase 2: vocabulário e qualidade (1 dia) + +Criar `docs/i18n-glossary.md` e aplicar com busca e substituição guiada, revisando cada ocorrência: + +| Conceito | Termo padrão | Evitar | +|---|---|---| +| pair / pairing | parear, pareamento, pareado | emparelhar, emparelhamento | +| app | aplicativo (curto: app só em rótulos de espaço apertado, decidir e documentar) | app / apps misturado | +| on / off (estado) | ativado / desativado | ligado / desligado (exceto Bluetooth e Wi-Fi como interruptor físico: decidir) | +| phone | telefone | celular, smartphone | +| clipboard | área de transferência | clipboard | +| debugging | depuração | debug | +| hotspot | ponto de acesso | hotspot | + +Regras de revisão: +- Tratamento por "você" em todo texto; sem "tu". +- Sentence case nos textos corridos; Title Case só onde o inglês também usa (títulos de aba). +- Mesmo texto em inglês, mesma tradução (já garantido pelo mesclador; checar as 82 divergências antigas). +- Gênero e concordância com `{phone}`, `{name}`, `{me}`: reescrever frases que dependem do gênero do nome + (ex.: "{phone} pode ser encontrado") para forma neutra ("É possível encontrar {phone} enquanto..."). +- Revisão por falante nativo de 100% dos textos longos (mais de 60 caracteres, ~450 chaves) e de uma amostra de + 20% dos curtos. Registrar as correções no próprio PR. + +Saída da fase: qualidade 9,5; `i18n-glossary.js` verde. + +## 4. Fase 3: cobertura (3 a 5 dias, lotes paralelos) + +Método já provado: lotes sem arquivos em comum, cada um grava um fragmento JSON de chaves novas, um único +passo de mescla grava os dicionários, a validação roda no fim. Regras do lote: inglês idêntico ao original; +tokens do `UI.fill` ficam no texto; sem concatenar fragmentos; plural em `_one`/`_other`; não traduzir logs, +texto comparado no código, mensagens para o outro dispositivo, marcas. + +Ordem por ganho de nota e risco: + +1. **Mesh** (maior lacuna: ~231 literais). `windows/mesh/ui-{cursor,multi,overview,phone,share}.js`, + `linux/mesh/ui-{cursor,multi,overview,phone}.js`, `mac/mesh/ui-{cursor,display,multi,overview}.js` e o que + restar em `mesh/app.js`/`ui-start.js` (estados do pareamento, "Phase N"). Reaproveitar as chaves das páginas + não-mesh quando o inglês for igual. +2. **Janelas pequenas** (~66 literais): HUD, monitor, appview, phoneview, sender, sound, appsend, audio, + capture, pcview. HTML com `data-i18n*` e `shared/i18n-dom.js`; renderers com `t()`. +3. **Processo principal** (~53 literais): `callaudio.js`, `apps.js`, `phone-bridge.js`, `smb.js`, `sshd.js`, + `vdd.js`, `firewall.js`, `kvm.js` e os equivalentes de Linux e macOS. Antes de embrulhar, procurar o texto no + código e nos testes: se for comparado ou casado por regex, não mexer. +4. **Assistente do `aurora-shell.js`** (~41 literais de `shared/ui-*`): exemplos e respostas. Decidir se os + comandos de voz/texto aceitos também ganham versão em português (se não, documentar que o assistente + entende só inglês e traduzir apenas a interface). +5. **Android**: `Clip.kt` e `Input.kt` (textos que sobraram); revisar plurais e os 3 `Text("...")` restantes. +6. **Estados de erro do backend**: mensagens montadas nos módulos que viram `state.message`; traduzir na origem + (o idioma já está definido no processo principal). + +Meta por lote: o contador de `i18n-coverage` cai ao nível da meta (≤1%); atualizar o limite gravado no teste. + +## 5. Fase 4: verificação em app rodando (2 dias, precisa das máquinas) + +Nada disso foi feito até hoje. + +1. **Android**: instalar JDK 17+ e Android SDK; `./gradlew :app:assembleDebug`; corrigir o que o compilador + acusar; testar em emulador/aparelho em Português (Brasil) e English. +2. **Desktop**: rodar o app em Windows, macOS e Linux (X11 e Wayland) com `lang` = `auto`, `en`, `pt-BR`. + Checklist por plataforma: + - cada aba abre sem erro no console; trocar o idioma recarrega e muda nav, cabeçalhos, descrições e bandeja; + - pareamento completo (outro computador e telefone): banner, códigos, estados; + - modo Multi-device (mesh) e as janelas pequenas; + - sem texto cortado ou sobreposto em 1366×768, 1440×900 e 375×812; + - inglês idêntico ao de `origin/main` (comparar capturas de 3 páginas por plataforma). +3. **Captura automatizada**: com Playwright (já usado para Electron), um teste de fumaça que abre cada aba em + `pt-BR` e falha se achar texto da lista de "palavras inglesas" (the, and, with, click, open...) fora das + exceções. Roda no CI quando houver runner gráfico. +4. **Site**: `node website/dev-server.js`; EN e PT, `/404`, recarga com PT salvo (sem flash), CSP sem erro. + +## 6. Critérios de aceite para 9,5 + +- Os cinco testes novos passam no CI; `applog`, `kvm-moves`, `movebench` continuam fora (já falham em `origin/main`). +- `docs/i18n-coverage.md` mostra ≤1% de literais em inglês em todas as superfícies, com a lista de exceções. +- `i18n-glossary.js` verde; nenhuma ocorrência de "emparelh", "celular", "tu/teu". +- 100% dos textos longos revisados por falante nativo, com registro das correções. +- Android compila e foi percorrido em pt-BR; desktop percorrido nas 3 plataformas com o checklist acima. +- Nenhuma regressão no inglês (portão de padrão em inglês + comparação de capturas). + +## 7. Cronograma e dependências + +| Etapa | Dias | Depende de | +|---|---|---| +| Fase 1: portões | 0,5 | nada | +| Fase 2: vocabulário e revisão | 1 | Fase 1 (glossário no CI) | +| Fase 3: lotes 1 a 3 | 2 a 3 | Fase 1 (limite de cobertura) | +| Fase 3: lotes 4 a 6 | 1 a 2 | lotes 1 a 3 | +| Fase 4: verificação em app | 2 | JDK/SDK e uma máquina de cada sistema | +| Merge e publicação | conforme o plano de 31/10 | fases 1 a 4 | + +As fases 2 e 3 podem andar em paralelo. A Fase 4 é o gargalo: sem ela a nota de robustez não passa de 9,0, +porque o que foi medido até agora é código, não o app em uso. + +## 8. Riscos + +| Risco | Mitigação | +|---|---| +| Embrulhar texto que o código compara e quebrar lógica | procurar o texto no código e nos testes antes; testes de `shared/test` no fim de cada lote | +| Conflito de chaves entre plataformas | mesclador cria variantes `_linux`/`_mac`; o portão de padrão em inglês acusa divergência | +| Texto fixado na carga do módulo (idioma ainda não definido) | traduzir no uso/renderização; o teste de fumaça pega | +| Limite de cobertura virar burocracia | limite só desce; exceções em arquivo versionado e revisado no PR | +| Revisão nativa atrasar | começar a revisão da Fase 2 enquanto a Fase 3 corre; revisar só o delta nas rodadas seguintes | diff --git a/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md b/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md new file mode 100644 index 00000000..f93de974 --- /dev/null +++ b/docs/superpowers/plans/2026-11-01-release-notes-pt-br.md @@ -0,0 +1,40 @@ +# Notas da release: Português (Brasil) — rascunho + +Rascunho para a release que trouxer o pt-BR. A versão e a data ficam para quem publicar +(o `package.json` do desktop está em 2.5.0; nada foi alterado nas versões). + +## English + +**DuoDesk now speaks Brazilian Portuguese.** + +- Desktop (Windows, macOS, Linux): every page, the tray / menu bar, pairing, notifications and the small + windows follow the language. Pick it in **General › Language**: Automatic (system), Português (Brasil) or English. +- Android: the whole app is available in Portuguese (it follows the system language). +- Website and README: Portuguese versions (`README.pt-BR.md`, `docs/*.pt-BR.md`, EN / PT switch on the site). +- Fixes found along the way: the Camera, Messages, Calls, Media, Files and Support tabs could fail to load + on some pages because several scripts declared the same top-level name. + +Known limits: the assistant bar only understands English commands; messages sent to the other computer +or phone are shown in the sender's language. + +## Português (Brasil) + +**O DuoDesk agora fala português do Brasil.** + +- Desktop (Windows, macOS, Linux): todas as páginas, a bandeja / barra de menus, o pareamento, as notificações e as + janelas pequenas seguem o idioma. Escolha em **Geral › Idioma**: Automático (sistema), Português (Brasil) ou English. +- Android: o app inteiro está disponível em português (segue o idioma do sistema). +- Site e README: versões em português (`README.pt-BR.md`, `docs/*.pt-BR.md`, alternância EN / PT no site). +- Correções feitas no caminho: as abas Câmera, Mensagens, Chamadas, Mídia, Arquivos e Suporte podiam não carregar em + algumas páginas, porque vários scripts declaravam o mesmo nome no topo do arquivo. + +Limites conhecidos: a barra do assistente só entende comandos em inglês; as mensagens enviadas ao outro computador +ou ao telefone aparecem no idioma de quem envia. + +## Antes de publicar + +- [ ] Compilar e testar o Android em pt-BR e em inglês. +- [ ] Rodar o desktop nas 3 plataformas (`auto`, `en`, `pt-BR`) com o checklist do plano de 01/11. +- [ ] Definir a versão, atualizar os links de download do `README.md` e do `README.pt-BR.md`. +- [ ] Gerar os instaladores e conferir que `shared/locales/` e `shared/i18n-dom.js` estão no pacote. +- [ ] Deploy do site na Vercel (preview primeiro). diff --git a/flake.nix b/flake.nix index 2c46d4a7..f008d4bd 100644 --- a/flake.nix +++ b/flake.nix @@ -97,7 +97,7 @@ # Copy shared files cp -r shared/*.js shared/*.css shared/*.html "$share/shared/" # The pages' fonts (Geist woff2 + OFL.txt), the art kit and scenes, the per-page effects - cp -r shared/fonts shared/art shared/pagefx "$share/shared/" + cp -r shared/fonts shared/art shared/pagefx shared/locales "$share/shared/" if [ -d shared/icon ]; then cp -r shared/icon "$share/shared/" fi diff --git a/linux/app.html b/linux/app.html index d3db63ac..ad731ffe 100644 --- a/linux/app.html +++ b/linux/app.html @@ -23,7 +23,7 @@ -