The aria-live region that unmounts with the overlay becomes B32+ F4, and the catalog bundle debt in B33+ stops being conditional now that B41 and B42 both shipped on that route without paying it.
22 KiB
Polimento mobile da lista de municípios (drawers + card compacto)
Status: entregue em código (2026-07-27) — ver "As-built" no fim
Atualizado em: 2026-07-27
Item do roadmap: docs/roadmap.md (Trilha B, item B42)
Impeccable: B — encaixe nos cards md:hidden + controles Tendência/Assessores; sem rota nova
Appetite: ~1 dia eng; Drawer nos dois controles (padrão B26) + densificar card + tap-to-open
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (Edit where you see, Feel the action, Clarity under pressure) / DESIGN.md · regras campanha-edit-where-you-see / campanha-action-feedback · precedente B26 ✓ (MunicipalityListSignalControl: Popover desktop / Drawer mobile).
Na implementação: craft compacto → critique → polish.
Brief compacto:
- Persona / contexto: Assessor em campo no celular, varrendo a fila; o card está alto demais e os popovers de Tendência/Assessores competem com o teclado (o Sinal já abre em Drawer).
- Job principal: editar tendência/assessores no mesmo gesto confortável do sinal; varrer mais municípios por viewport; abrir o detalhe com um toque no card.
- Estratégia de cor: Restrained — sem novo chrome; Drawer do kit (
src/components/ui/Drawer). - Edit where you see: sim — mantém edição in-card; só muda o container mobile.
- Anti-goals: Popover genérico "sempre Drawer"; spreadsheet; segundo botão "Abrir" depois do card inteiro ser clicável; perder stopPropagation nos controles editáveis.
Dados → decisão → apresentação
- Vou apresentar dados? Sim, só reapresentação do que o card já mostra (classe E10, cobertura E8).
- Decisões desbloqueadas: Assessor/CG — "este município merece abrir agora?" com menos scroll; edição de tendência/assessores sem luta com teclado.
- Forma escolhida: badge de classe sem prosa; cobertura em layout
compact(número + déficit curto, como desktop). Rejeitado: tirar Classe/Cobertura do card (ainda informam a fila); chart/KPI novo.
Contexto
Cards mobile em MunicipalityList.tsx (data-view="mobile-cards", md:hidden):
- Classe usa
TerritorialClassReadoutlayout="card"— mostra o "por quê" em texto (text-xs); na tabela o mesmo texto ésr-only+ tooltip B23. - Cobertura da meta usa
MunicipalityListGoalCoverageCellsemlayout="compact"— soletra déficit + cenário; desktop passacompact. - Botão outline "Abrir município" no rodapé do card.
- Tendência (
MunicipalityListTrendControl) e Assessores (MunicipalityListAdvisorsControl) abrem Popover em qualquer viewport. - Último sinal (
MunicipalityListSignalControl) já distinguevariant: 'popover' | 'sheet'— mobile usa Drawer (B26 ✓).
Pedido de produto (2026-07-26), agrupado neste item (mesma superfície mobile):
- Tendência → Drawer no mobile, Popover no desktop.
- Assessores → idem.
- Card menor: sem descrição da classe; cobertura só no formato número (compact); sem botão "Abrir município"; toque no card abre o município.
Objetivos
MunicipalityListTrendControleMunicipalityListAdvisorsControl: Popover emmd+, Drawer (bottom sheet) abaixo demd, espelhando o contrato visual/a11y do sinal (título + nome do município no header do Drawer).- Auto-save / endpoints JSON de B24/B27 inalterados — só o container muda.
- Card mobile: Classe como na tabela (badge +
sr-onlywhy); Cobertura comlayout="compact"; remover oButton"Abrir município"; o<article>(ou região equivalente) navega para/campanha/municipios/[slug]no toque/clique fora dos controles interativos. - Controles internos (tendência, votos, sinal, assessores,
TerritoryLink) não disparam a navegação (stopPropagation/pointer-events/ link overlay com buracos — escolher o padrão mais simples no craft). - Guardrails: sem migration/action/Consent; desktop table fora (exceto se o controle compartilhado ganhar o branch de viewport); access inalterado.
Decisões travadas
- Um item só para drawers + card (lote 2026-07-26). Mesma viewport, mesmos arquivos, appetite cabe em ~1 d. Rejeitado: três fill-ins separados (custo de coordenação > ganho); absorver em R6 (atrasa quick win de campo).
- Mesmo breakpoint do sinal / cards (
md= 768) via padrão já usado (md:hiddencards,useIsMobilese o controle precisar montar um único tree). Rejeitado: breakpoint diferente por controle. - Card inteiro como hit target de navegação, não botão extra. Rejeitado: manter o botão "Abrir" + card clicável (dois affordances); só remover o botão sem tornar o card clicável (regressão de descoberta).
- Classe no card = paridade com tabela (
layout="table"ou flaghideWhy). O research §6.4 ("nunca só o label") continua viasr-only+ eventual tooltip/tap no badge se B23 já cobre — no card mobile,sr-onlybasta no v1 (paridade pedida). Rejeitado: tirar a Classe do card. - i18n/naming: reusar
variant: 'popover' | 'sheet'do sinal ou extrair helperuseCampaignOverlayMode()no 3º call site — depth: se Trend+Advisors+Signal forem o 3º, extrair; senão copiar o branch uma vez.
Questões em aberto
- Extrair shell Popover|Drawer compartilhado agora? Opções: A) branch local nos dois controles (copiar B26) | B) extrair
CampaignResponsiveOverlayjá. Recomendação: A na primeira PR; se o diff duplicar >~40 linhas iguais, extrair no/simplifydo mesmo item (3º call site = sinal + estes dois). (assumido.)
Abordagem proposta
flowchart TB
subgraph desktop [md+]
T1[Trend Popover]
A1[Advisors Popover]
end
subgraph mobile [lt md]
T2[Trend Drawer]
A2[Advisors Drawer]
Card[Card compacto<br/>tap → detalhe]
end
Signal[SignalControl sheet] -.padrão.-> T2
Signal -.padrão.-> A2
Componentes:
MunicipalityListTrendControl.tsx: espelhar estrutura deMunicipalityListSignalControl(conteúdo do form numa função; Popover vs Drawer).MunicipalityListAdvisorsControl.tsx: idem (chips + Command dentro do Drawer; cuidado com foco/teclado virtual).MunicipalityList.tsx(cards):TerritorialClassReadoutsem why visível;GoalCoverageCell layout="compact"; removerButton/Link"Abrir município"; navegação no card com exclusão dos controles.- Testes: unit/e2e leves — no mobile viewport, trigger de tendência abre dialog/sheet (role); tap no título navega; tap no controle não navega.
- Migration: nenhuma.
Depth check: reusa Drawer shadcn + padrão B26; não cria design system de overlay novo até o simplify provar duplicação.
Dependências
- Duras: nenhuma. Consome B24 ✓ / B27 ✓ / B26 ✓.
- Soft: B41 (scroll desktop) — paralelo; não bloqueia.
Não escopo
- Scroll horizontal / sticky da tabela desktop → B41.
- Mudar auto-save, endpoints, ou schema de tendência/assessores.
- Paridade Drawer em outras listas (lideranças) — Adiado.
- Seletor de colunas / filtros salvos.
Rabbit holes
- Card clicável + botões internos = navegação acidental. Mitigação: testes e2e do gesto;
stopPropagationnos triggers; critique em device real. - Command dentro de Drawer (foco trap / teclado). Mitigação: espelhar padrões Radix já usados no Sheet do sidebar; testar Android Chrome.
- Extrair overlay genérico cedo demais. Mitigação: decisão A acima + simplify.
Adiado com gatilho
Tooltip/tap da Classe no card mobile— fechado no critique da própria sessão (ver As-built): osr-onlysozinho deixava o veredito inalcançável no toque, o que contrariaDESIGN.md.Drawer para votos estimados no card— entrou nesta entrega por decisão do usuário; foi o 3º call site que justificou extrair a casca.- Slot
footer+formIdna casca, para o Sinal (B26) migrar. Gatilho: um 2º controle precisar de submit explícito num Drawer, ou o Sinal divergir visualmente dos outros três. - Montar o Drawer só no primeiro
open(everOpened, nãoopen). Gatilho: a lista mobile aparecer num profile de render, ou o caminhopagination: false(435 linhas × 4 overlays) passar a ser rota quente. Números medidos no As-built. prefers-reduced-motionnoDrawer. ODialog/Sheetdo kit também não respeita; a animação de entrada é do base-ui e vem do kit, então a correção é do componenteui/, não deste item. Gatilho: qualquer trabalho de acessibilidade de movimento no kit.DrawerVirtualKeyboardProvider. Sem ele, o teclado do Android pode cobrir os inputs de votos dentro da folha; hoje mitigado por não focar campo na abertura. Gatilho: relato de campo em Android.- A ficha do município mantém Popover em qualquer viewport.
MunicipalityGoalAccountCardpassa semprevariant="popover", então no celular aquela edição rápida ainda briga com o teclado — o problema que este item resolveu uma rota ao lado. Não é esquecimento: a ficha é uma árvore (não o parmd:hidden/hidden md:blockdas listas), então escolher o container ali exigeuseIsMobile, que este plano rejeitou por trocar o container depois da hidratação. Gatilho: queixa de campo sobre editar votos na ficha pelo celular — e aí a decisão a tomar éuseIsMobilena ficha, não copiar o branch. DrawerBodyno kit.Drawer.tsxexporta header/footer/title/description mas nenhum corpo, então há dois containers de scroll escritos à mão (a casca e o Sinal) que já divergem emgap-3/pt-3. AdicionarDrawerBodyresolve, mas põe uma peça não-upstream no kit (shadcn addnão a recoloca). Gatilho: o 3º corpo à mão.- Stub de
ResizeObserver/scrollIntoViewcompartilhado. Duas cópias (este spec ecampaignCompositionCleanup.unit.spec.ts), abaixo da barra de 3 do repo;vitest.unit.config.mtsnão declarasetupFiles, então não existe casa para mover hoje. Gatilho: o 3º spec jsdom que precise deles →setupFiles: ['./tests/helpers/jsdomStubs.ts'], não uma terceira cópia.
As-built (2026-07-27)
Escopo ampliado por decisão do usuário na sessão: Votos estimados entrou no mesmo tratamento (estava em "Adiado com gatilho" acima). Isso levou o item de 2 para 3 controles com a mesma casca — que é o critério de extração do repo —, então a questão em aberto foi resolvida ao contrário da recomendação: src/components/campaign/shared/CampaignCellEditOverlay.tsx nasceu já nesta entrega, não no /simplify. Appetite ~1d → ~1,25d.
CampaignCellEditOverlaycarrega só o container:variant(popover|sheet),open/onOpenChange,title/description,trigger/triggerLabel,tooltipContent(B23, só no popover — não há hover no toque) epreventPopoverAutoFocus. Cada controle continua dono do seu auto-save (debounce, abort, flush no fechamento): fechar o Drawer grava exatamente como dispensar o Popover, porque ohandleOpenChangede cada um passa direto paraonOpenChange.- O Sinal (B26) não migrou — mas o motivo registrado antes estava errado. O
/simplifyderrubou a alegação de que "a casca não expressa isso sem virar genérica": o<form>não precisa envolver oDrawerHeader(um título não é campo) e um submit fora do form é HTML padrão viaform="<id>". O que falta é um slotfooter(mais umformIddo chamador) — adiado com gatilho abaixo, não impossível. O Sinal segue sendo o precedente visual e agora consome a classe de trigger da casca (campaignCellEditTriggerClassName) e os três atributos ARIA que lhe faltavam (aria-expanded/aria-haspopup/aria-busy). useIsMobiledescartado: os cards (md:hidden) e a tabela (hidden md:block) são árvores irmãs, então o call site já sabe em que viewport está. Uma media query aqui trocaria o container depois da hidratação.- Navegação do card = link esticado, zero JS:
<Link>dentro do<h3>comafter:absolute after:inset-0sobre o<article className="relative">. Quem érelativeé o controle, não a célula — a primeira versão posicionou os seis<div>do<dl>, o que levantou também os rótulos e o padding de cada célula acima do overlay e transformou metade do card em toque que não editava nem navegava (P0 do critique). Hoje orelativemora na classe compartilhada do trigger; nada mais dentro do card pode ser posicionado.MunicipalityListcontinua Server Component e o foco/teclado seguem nativos. O botão "Abrir município" saiu. - Dois props
layoutmorreram com a paridade pedida:TerritorialClassReadout(badge +sr-onlydo porquê, como na tabela — E10 nunca entrega veredito nu) eMunicipalityListGoalCoverageCell(semprecompact). Com um único comportamento cada, o prop e o branch órfão foram deletados. autoFocusScenariosuprimido nosheet: no desktop o Popover é transitório e digitar é o ponto; no toque, focar uminputna abertura subiria o teclado virtual antes de o número ser lido.municipalityNameé obrigatório exatamente onde há Drawer: os props de Votos estimados são uma união discriminada —sheetexige o nome (uma folha sempre nomeia seu assunto, e isso é erro de compilação, não nota de revisão),popovero deixa opcional, porque o 3º call site (MunicipalityGoalAccountCard, na ficha do município) já está sob o título do próprio município. A primeira versão proibia o nome nopopover(?: never), o que criou uma assimetria na mesma linha da tabela: Tendência e Assessores anunciavam "… em Feira de Santana — …" e Votos estimados não. Resolvido para o lado de incluir depois de verificar que a célula do nome é um<td>comum, não um<th scope="row">— não existe associação de cabeçalho de linha para o leitor de tela suprir o contexto quando o foco entra num trigger. Custo medido do nome nos dois variants: 0,22 KiB gzip na página de 25 linhas (2,9 KiB no caminhopagination: falsede 435).
Testes: tests/unit/campaignCellEditOverlay.unit.spec.ts (jsdom, 6 casos = 3 controles × 2 variants: sheet abre role="dialog" com título + nome do município e botão "Fechar"; popover mantém popover-content e não repete o nome) — precisou dos stubs de ResizeObserver e Element.prototype.scrollIntoView que o cmdk do combobox de assessores exige. E2e novo test.describe com viewport: { width: 390, height: 844 } em campaignMunicipalities.e2e.spec.ts: abrir Tendência no card não navega, e o toque fora dos controles abre /campanha/municipios/<slug>.
Gate: tsc, lint --max-warnings=0, format:check, knip (só o erro pré-existente de payload.config.ts, P3), check:cycles, 592 unit / 420 int, build (/campanha/municipios 13,4 kB / 320 kB First Load JS) e Aikido sem achados. O e2e mobile passou; as falhas rotativas da suíte cheia foram reproduzidas piores na árvore limpa (4 falhas contra 3, o mesmo teste de demanda falhando na mesma linha) sob contenção de outra sessão Playwright no mesmo host — mesmo padrão de ambiente já registrado no B27 ✓/B32 ✓, não regressão.
Critique + /simplify (mesma sessão, depois do gate)
O critique rodou sobre o código, não sobre a tela: a coleta de evidência visual em viewport 390×844 falhou por falta de automação de browser nesta sessão, então nada aqui foi confirmado em device real — os alvos de toque são checados por classe (min-h-11), não medidos. Mesmo assim achou um P0 de correção no gesto central, e os revisores paralelos (qualidade, performance, reuso) convergiram no resto. O que entrou:
- P0 — zonas mortas do link esticado. Descrito no bullet de navegação acima. O e2e passou a tocar num rótulo
dtdentro da grade de métricas (não mais no canto do card), que é exatamente a área que o bug engolia. - O Drawer abre com foco no título, nunca num campo.
initialFocus={titleRef}numDrawerTitlecomtabIndex={-1}: o default do base-ui (primeiro tabbable) subia o teclado virtual sobre a folha antes de ela ser lida — e opreventContentAutoFocusque devia mitigar isso era inerte no branchsheet, um prop que mentia. Renomeado parapreventPopoverAutoFocus(é só do Popover) e o comportamento do Drawer virou incondicional. Pinado no unit spec, porque é o ponto mais frágil da entrega. - Rótulo acessível carrega o valor. Um
aria-labelsubstitui o conteúdo do trigger: as quatro células de edição anunciavam o verbo e engoliam justamente o valor que todo mundo lê no pill/no avatar/no número. Agora seguem a forma que o Sinal (B26) já usava — "Editar tendência política em Feira de Santana — Favorável". Isso resolveu o achado de payload do revisor de performance ao contrário do que ele propôs: ele mediumunicipalityNamecomo payload RSC morto no desktop (27,9 KiB crus / 2,9 KiB gzip em 435 linhas) e sugeriu proibi-lo nopopovernos três controles; com o nome dentro do rótulo ele deixou de ser morto, e a célula do nome ser um<td>semscope="row"é o que diz que ninguém mais fornece esse contexto (ver o bullet domunicipalityNameacima). - Falha silenciosa depois do fechamento. Fechar é o que commita o rascunho e também o que desmonta o
Alerte a regiãoaria-liveque carregariam o erro: uma gravação que falhava na saída revertia o badge sem avisar ninguém. Os três controles de auto-save por debounce (+ o de lideranças) ganharamtoast.errorapenas quando já estão fechados; abertos, oAlertinline continua sendo o canal mais próximo. - Alvos de toque dentro do Drawer. Os três inputs compactos de votos passam a 44px abaixo de
mde continuam 36px nomd+(única call site do variantcompact); o chip de remover assessor e cada linha doCommandganhammin-h-11só nosheet. - A explicação voltou a ser alcançável no toque. A Classe no card ganhou
CampaignHoverTooltip(o canal tap-to-open que a tabela já tem viacellTooltip) —DESIGN.mdexige que a classe nunca chegue como veredito nu, e no card ela só tinhasr-only; a Cobertura ganhou a frase completa emsr-only, porquetitlenão é anunciado nem alcançado por toque. Isso fecha o "Adiado com gatilho: tooltip/tap da Classe no card mobile". - Reuso — o 4º call site migrou.
LeadershipListSupportStatusControl(B32) era o branch Popover da casca redigitado à mão, classe de trigger byte-a-byte inclusive: migrado comvariant="popover", ~25 linhas a menos e nenhum prop novo.MunicipalityListSignalControlpassou a importarCampaignCellEditOverlayVariantem vez de re-escrever a união. A string de trigger, que estava em três arquivos, viroucampaignCellEditTriggerClassName(precedente:campaignHoverExplanationClassName). - API da casca: o
<button>do trigger era escrito duas vezes (só oonClickdiferia) → uma vez;sheetBodyClassNameera o único prop de classe que substituía em vez de compor, o que obrigava o chamador de assessores a re-espalharpx-4por seção → agora compõe (px-0 pt-2no chamador) e osectionPaddingClassNamecondicional morreu;titleera obrigatório e morto no Popover → virou oaria-labeldorole="dialog", que o Radix não nomeia; o docblock estava colado notypedo variant (hover do IDE mostrava a doc errada) e os props agora estão agrupados em blocos// Popover only/// Sheet only.
Medido e não feito (o revisor de performance mediu; a decisão é não pagar agora): cada Drawer fechado ainda executa o corpo de DrawerContent, e o cn() do popup roda tailwind-merge sobre 4.068 caracteres — 6,2 µs contra 0,8 µs do Popover que ele substituiu, ou +0,40 ms em 25 linhas e +7 ms no caminho pagination: false de 435. Não é adição, é troca (o número de overlays por página não mudou), e a correção é montar o Drawer no primeiro open ({everOpened && …}, não {open && …}, senão o data-starting-style perde a animação de entrada). Registrado como débito com gatilho. Bundle: zero delta nas duas rotas — a lista já importava ui/Drawer pelo Sinal, e a ficha do município (que ganhou uma aresta nova via MunicipalityGoalAccountCard) já o tinha no grafo porque InstallPwaToast, no layout de (app), o importa. Vale saber: se o InstallPwaToast sair do layout, a rota de detalhe passa a pagar a subárvore do Drawer só por essa aresta.
Cuidado operacional aprendido aqui: git stash é compartilhado entre worktrees do mesmo repositório. Fazer stash para medir uma baseline enquanto outra sessão trabalha em paralelo faz o pop trazer o WIP alheio (e o índice do drop deslizar) — aconteceu nesta sessão e foi revertido com git stash store <hash>. Para baseline com sessões concorrentes, prefira patch local (git diff > /tmp/… + git checkout --) a git stash.
Referências
docs/roadmap.md(Trilha B · B42)src/components/campaign/municipality/MunicipalityList.tsxsrc/components/campaign/shared/CampaignCellEditOverlay.tsx(cascapopover|sheet+campaignCellEditTriggerClassName)MunicipalityListTrendControl.tsx,MunicipalityListAdvisorsControl.tsx,MunicipalityListExpectedVotesControl.tsx,MunicipalityListSignalControl.tsxMunicipalityListGoalCoverageCell.tsx,TerritorialClassReadout.tsxsrc/components/campaign/leadership/LeadershipListSupportStatusControl.tsx(4º call site da casca)docs/plans/registrar-sinal-lista-municipios.md(B26)docs/plans/autosave-tendencia-lista-municipios.md(B24)docs/plans/combobox-assessores-lista-municipios.md(B27)PRODUCT.md/DESIGN.md