From cb08a20b9b9b78021d04bbb5a6d42c15da1044c9 Mon Sep 17 00:00:00 2001
From: lippdev <108258235+lippdev@users.noreply.github.com>
Date: Wed, 21 Oct 2026 19:28:28 +0000
Subject: [PATCH] docs(controller): test Cursor mode from R3 in the TV script
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

O roteiro de E6-07 pedia o modo Spatial e o ajuste por site, mas nunca
mandava chegar no modo Cursor: era justamente o botão que não chegava
lá. O cenário 3 agora manda apertar o R3 e comparar os modos, e a lista
de "onde ajustar o quê" diz onde o modo vive e onde ele aparece na tela.

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
---
 docs/CONTROLLER-TEST.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/CONTROLLER-TEST.md b/docs/CONTROLLER-TEST.md
index 2028143..d7ee8f4 100644
--- a/docs/CONTROLLER-TEST.md
+++ b/docs/CONTROLLER-TEST.md
@@ -16,6 +16,7 @@ Para cada cenário: **passou / falhou**, quantos segundos demorou a primeira res
 1. **Primeiro boot.** Abre em tela cheia, onboarding na tela, o app mostra qual controle detectou e quais botões chegaram. Escolha o idioma e o buscador só com o D-pad e o A.
 2. **Tela inicial → YouTube TV.** Abra o app de TV pelo D-pad, entre num vídeo, veja se a barra se esconde sozinha sobre o conteúdo e se o B volta ao estado anterior. Anote se o foco "pula" algum card (pontuação do `spatial`).
 3. **Digitar sem teclado físico.** Pesquise "previsão do tempo" com o teclado virtual (incluindo uma palavra com acento, como "ação"), navegue pelas sugestões e abra o resultado. Marque se o cursor virtual (modo Spatial) chegou em tudo.
+   Em seguida aperte o analógico direito (R3): a barra troca o modo na ordem Spatial → Cursor → Arrows. No modo Cursor o analógico esquerdo move um ponteiro pela página, em vez de andar de foco em foco; aperte R3 de novo para sair. Compare qual dos dois é mais rápido de acertar um card pequeno no YouTube.
 4. **Três abas.** Abra três abas, alterne pelo seletor em grade e feche uma, só com o controle. Veja se as miniaturas aparecem e se o foco começa na aba ativa.
 5. **Permissão de microfone.** Abra um site que peça o microfone (ou o teste do WebRTC), percorra o prompt com o D-pad e escolha "permitir sempre". Confirme em Configurações que a permissão ficou salva para o site.
 6. **Atualização.** Em Windows/Linux: com uma versão nova publicada, deixe o download acontecer, feche o app e reabra; no `.deb`/`.rpm` use **Reiniciar e instalar** em Configurações → Sobre e confirme o pedido de senha. No macOS, o app deve avisar e abrir a página da release.
@@ -28,6 +29,7 @@ Leitor de tela é o outro lado da mesma sessão: o roteiro de Orca, Narrator e V
 - **Foco pulando ou preso:** a pontuação está em `spatial.js` (`score`), injetado em toda página; o ajuste vale para o app inteiro, então anote o site e o elemento.
 - **Cursor muito rápido ou lento:** velocidade máxima em `MAX_CURSOR_SPEED` (`src/shared/controllerInput.ts`), e o modo de entrada de cada site em Configurações → Entrada.
 - **Botão sem função:** o mapeamento está em `src/shared/controllerInput.ts` e `src/shared/shortcuts.ts`; o rótulo por família de controle em `src/shared/controllerGlyphs.ts`.
+- **Modo Cursor não aparece:** o R3 cicla o modo e grava a escolha por site; o pedido sai do shell em `cycle-input-mode` e o modo atual aparece no medidor do controle, na barra.
 - **Vibração:** `vibrationActuator` não está implementado (E6-09, Could). Se fizer falta, é o item do backlog a puxar.
 
 ## Resultado