Skip to content

fix(tui): fit views to the terminal and navigate Configure by row - #73

Merged
BGLuis merged 1 commit into
mainfrom
fix/tui-responsive-config-nav
Nov 7, 2026
Merged

BGLuis merged 1 commit into
mainfrom
fix/tui-responsive-config-nav

Conversation

@BGLuis

@BGLuis BGLuis commented Nov 7, 2026

Copy link
Copy Markdown
Owner

Description

A TUI desenhava tudo com 100 colunas fixas e ignorava o tamanho do terminal. Em janelas menores o terminal quebrava as linhas e as bordas das caixas desmontavam. Este PR faz as telas se ajustarem ao terminal e reorganiza a navegação da tela Configurar.

O que quebrava

  • m.width era lido no WindowSizeMsg, mas nunca usado: separadores e caixas tinham 100 colunas fixas.
  • O topo das caixas não tinha a mesma largura das linhas de dentro (Configurar variava com o nome do jogo; Abrir Jogo e Arquivos ficavam 2 colunas menores).
  • truncate e %-Ns contavam runes, não colunas. Texto japonês ocupa 2 colunas por letra e estourava a tela de Revisão.
  • Em terminal baixo, o terminal descartava as primeiras linhas e o cabeçalho sumia.
  • Marcador › › duplicado em Abrir Jogo e nomes das etapas do cabeçalho fixos em português.

Tamanho da tela (pkg/ui/tui/layout.go)

  • Largura vinda do terminal (limite de 100). Linhas longas são cortadas com … em vez de quebradas, e a largura é medida em colunas visíveis com charmbracelet/x/ansi.
  • Abaixo de 92 colunas a Estimativa vai para baixo do formulário. O cabeçalho vira ● Configurar 2/4 quando não cabe, e os atalhos do rodapé quebram nos separadores ·.
  • O corpo é cortado para caber na altura, mantendo cabeçalho e rodapé visíveis.
  • Caminhos mostram o final (…/マップ001.json); campos de digitação mostram o fim do texto, onde está o cursor.

Navegação em Configurar

  • ↑↓ / Tab / Shift+Tab movem um foco visível (›) entre as linhas; ←→ mudam só o valor da linha em foco (‹ valor ›). Idiomas e serviços agora giram nos dois sentidos.
  • Em campo de texto, letras são digitadas e setas/atalhos não alteram outras opções (antes ←→ trocava o serviço durante a digitação e o campo podia sumir).
  • Opções bool do Wolf RPG viram caixa de marcar (espaço ou ←→) em vez de digitar true/false.
  • Cada serviço mostra sua própria dica (reaproveita ui_hint_*; nova tui_hint_memory). Antes "Grátis e sem chave" aparecia para todos.
  • A ajuda de um campo só aparece com ele em foco; proxies só aparecem com o Google.
  • Os atalhos s, d, x e espaço continuam funcionando.

Mudança de comportamento: Tab antes pulava direto para os campos de texto; agora vai para a próxima linha.

Dependência: github.com/charmbracelet/x/ansi já estava no go.mod como indireta (vem do lipgloss) e passou a direta.

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  • I have tested my changes locally

  • gofmt -l, go vet ./... e go test ./... passam.

  • Testes novos em pkg/ui/tui/app_test.go:

    • TestConfigureNavigatesByFocusedRow: ←→ mudam só a linha em foco, voltam nas pontas, e digitar num campo não aciona s/d/x nem troca o serviço.
    • TestConfigureBoolFieldTogglesInsteadOfTyping: espaço desliga o padrão true de uma opção do Wolf.
    • TestViewsFitTerminalWidth: nenhuma linha de nenhuma tela passa da largura (60, 80 e 120 colunas) com nome de jogo, caminho e segmento em japonês, e as bordas da caixa de Configurar ficam alinhadas.
    • TestViewKeepsHeaderWhenTerminalIsShort: em 70x20 a tela não passa de 20 linhas e cabeçalho e rodapé continuam visíveis.
  • Testes ajustados à nova navegação: TestConfigureShowsExtractorOptionsAndAcceptsInput, TestConfigureChangesReestimateAndReachTheJob (agora também confere que digitar não dispara estimativa a cada tecla) e TestLanguageCyclePreservesOrder.

  • A saída de View() foi inspecionada em 50, 70, 100 e 110 colunas. Não foi testado numa sessão real de terminal.

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation (nenhuma necessária: docs/PYTHON_PARITY.md cita os atalhos s/d, que continuam valendo)
  • My changes generate no new warnings

Fora do escopo: o fundo da TUI (StyleApp) some depois de um trecho colorido na mesma linha, e os rótulos/ajudas das opções do extrator (pkg/job/schema.go) só existem em português.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DKhrqPXPWEC98hdu6bNzpj

Views were drawn at a fixed 100 columns, so narrower terminals wrapped
lines and broke box borders. Widths were also measured in runes, which
misaligned boxes and overflowed lines with Japanese text, and tall views
pushed the header off screen.

- Size every view from the window width (capped at 100), cut lines with
  an ellipsis instead of wrapping, measure display columns via x/ansi,
  stack the estimate below the form under 92 columns, and clip the body
  so the header and footer stay visible.
- Configure: up/down/tab move a visible focus between rows and
  left/right change only the focused value (languages and services cycle
  both ways); text fields no longer let arrows or shortcuts change other
  settings; Wolf RPG bool options toggle as checkboxes; each service
  shows its own hint; proxies only appear for Google.
- Fix the duplicated "› ›" marker and the hard-coded Portuguese step
  names in the header.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DKhrqPXPWEC98hdu6bNzpj
@BGLuis
BGLuis merged commit dfbd9a2 into main Nov 7, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant