Chassis de lista (vale para todas as listas, gate A): - scrollport: max-md:has-[.campaign-list-omnibox-form]:pt-0 — o containing block do sticky passa a começar no topo; a barra cola no header (sem vão de 16px, nada passa por cima no scroll) - barra densa: campo min-h-8 py-0 + X size-8 → ~40px no total; anel de foco escopado a md (mobile sem anel de cor; caret é o indicador) - trailing cluster desktop-only por padrão (edgeToEdge removido) - pt-4 md:pt-0 nas 6 listas com linha de ações antes do form (incl. organizacoes) Card mobile (B193 densificado): - nome 18px leading-tight com território a ~2px - chips como blocos label-acima (Classe/Tendência/Nível, gate B) via ChipBlock - avatares numa linha por grupo com overlap proporcional (flex-1 cells, sem cap/wrap/…, overflow-hidden nas bordas) — prop wrap → overlapRow - MissingAdvisorBadge com wrap para não clipar na célula do grupo - densidade vertical gap-2.5/py-3; toques min-h-11 preservados e2e B196 (6 testes) + regressão B184/B183/B193 verde.
11 KiB
Impl: Municípios mobile: omnibox colado ao header e card mais denso (pós-B193/B184)
Status: aprovado Atualizado em: 2026-08-10 Issue: #607 Intenção: docs/plans/municipios-mobile-polimento-omnibox-cards.md Appetite restante: herdado (~0,5–1 dia eng) — sem estouro: mudanças de superfície em 2 shared + 1 card + 1 avatar + 5 pages + e2e
Leitura da intenção
- Outcome: em
/campanha/municipiosmobile (< md), a barra de filtro cola no header (sem vão, nada passa por cima no scroll), o campo fica ~40px no total, foco sem anel de cor, nome 18px com território colado, chips Classe/Tendência/Nível com label acima, avatares numa linha por grupo com sobreposição dinâmica — padrão do chassis vale para TODAS as listas (gate A); chip de classe ganha label "Classe" (gate B). - O que NÃO negociar: desktop (
md+) intacto; sheets/edit-where-you-see intactos; labels/dados dos chips intactos; nenhum limite de avatares com "…"; área de toque dos controles do card não encolhe. - O que reavaliar: a hipótese da intenção ("encurtar o vão no contexto da barra — não o padding global do scrollport") é correta e foi confirmada: o sticky não pode subir acima do containing block (o shell), que começa 16px abaixo do scrollport por causa do
p-4doCampaignContentScroll. Qualquer fix no form isolado falha (clamp do containing block).
Abordagem recomendada
flowchart LR
A[CampaignContentScroll<br/>max-md:has-[marcador]:pt-0] --> B[form sticky ancora em y=0<br/>colado ao header]
B --> C[omnibox denso: min-h-8 py-1<br/>X size-8 · ring só md]
C --> D[card: nome 18px tight · chips label-acima<br/>avatares overlap row]
D --> E[e2e B196 + gates]
Opções consideradas: A | B | C
Recomendação: A — resolver o vão via :has() no scrollport (o scrollport "sabe" quando hospeda a barra sticky; o form carrega um marcador de classe estável). É a única correção que move o containing block do sticky para y=0 sem tocar o padding global nem as 11 páginas de lista.
Rejeitadas:
- B —
-mt-4no form: o sticky não sobe acima do containing block; com a borda do shell a 16px, o clamp continua em 16 (e o natural position vira 0 ≠ posição colada no scroll → barra "pula"). Medido na exploração:formY=72= header 56 + 16. - C —
pt-0global no scrollport / removerp-4: rabbit hole nomeado na intenção; destrói a folga do topo de todas as telas (dashboard, wizard…). O:has()escopa opt-0só para páginas com o form de lista.
Componentes / mudanças
campaignListOmniboxFormClassName(src/components/campaign/shared/CampaignListOmnibox.tsx): adiciona o marcadorcampaign-list-omnibox-formao bloco de classes existente (contrato do:has()). Barra:py-2→py-1no mobile (md:py-0preservado). Nada mais muda aqui — sticky/-mx-4/border-b ficam.- Campo do omnibox (mesmo arquivo):
min-h-11→min-h-8,py-1.5→py-1no mobile (md:min-h-11 md:py-1.5restauram o desktop); botão "Limpar" Xsize-11→size-8(span internosize-7→size-6, íconesize-4→size-3.5;md:hiddenjá é mobile-only); anel de focofocus-within:border-ring focus-within:ring-3 focus-within:ring-ring/50→ escopado amd:(mobile sem anel/contorno de cor — caret é o indicador; contrato B184 borderless preservado).text-smdo input INTOCADO (contrato B183: 16px touch).- Total da barra mobile: 32 (min-h-8) + 8 (py-1×2) + 1 (border-b) = 41px ≈ 40 ✓. Área de toque do X = 32px — aceitável porque o alvo real é o campo (o X vive dentro dele).
CampaignContentScroll(src/components/campaign/shell/CampaignQuickActionsHost.tsx):p-4→ adicionamax-md:has-[.campaign-list-omnibox-form]:pt-0(desktopmd:p-6intocado). Efeito: só páginas com o form de lista perdem o padding-top no mobile; o shell (containing block do sticky) passa a começar em y=0 → barra cola no header e cards nunca passam por cima. Fallback se o arbitrary variant do Tailwind v4 não compilar: regra CSS pura emstyles.csssob@media (width < 48rem)com o mesmo seletor.- Compensação das 6 listas com linha de ações antes do form (
atividades,liderancas,apoiadores,demandas,dobradinhas,organizacoes— verificadas na exploração):pt-4 md:pt-0nodiv.flex.justify-endque precede o form (respiro no topo que opt-0removeu; desktop inalterado).municipios,territorios,atualizacoes,pessoas,assessorestêm o form como primeiro filho visível — sem compensação. MunicipalityMobileCard(src/components/campaign/municipality/MunicipalityMobileCard.tsx):- Nome:
<h3>ganhatext-lg leading-tight(18px/22.5px vs 24px/32px atuais doh3global emstyles.css:371);gap-0.5existente → território a ~2–4px do texto (linha-box enxuta é o que fecha o vão medido de ~13px). Badge "Cidade" e link stretch intactos. - Chips: bloco
flex flex-col gap-0.5por chip comChipLabelacima do valor (gate B), substituindo oinline-flex items-centeratual; linha de chipsitems-start gap-x-3 gap-y-2(1–2 linhas aceitas pelo gate); valores comwhitespace-nowrap(nenhum chip quebra no meio).chipTriggerClassNamevira o estilo de bloco (sem pílula de hover:hover:bg-transparent;min-h-11mantido para a área de toque; label+valor são o alvo do tap). A label "Classe" é renderizada no CALL SITE do card (<ChipBlock label="Classe">), não dentro deTerritorialClassCardReadout— o readout continua compartilhado com a tabela desktop intocado. Caso cidade: Tendência/Nível/Classe como blocos com os mesmos valores ("Não registrada", dash).MissingAdvisorBadgeganha wrap (whitespace-normal h-auto) para o pill não clipar na célula de ~110px do grupo (desktop segue uma linha). - Densidade: article
gap-3→gap-2.5ep-4→px-4 py-3(vertical denso; horizontal mantém o edge-to-edge B184; toquesmin-h-11dos controles intactos).
- Nome:
MunicipalityRelationAvatarStack(src/components/campaign/shared/MunicipalityRelationAvatarStack.tsx): o modowrap(B193) vira overlap row dinâmica — célulasflex-1com avatar fixo centralizado: poucos avatares → sem sobreposição (célula > 28px), muitos → sobreposição proporcional à contagem, sem wrap, sem cap, sem "…", todos visíveis (a linha ocupa exatamente a largura do grupo; casos patológicos de dezenas de avatares degradam para pilha — sr-only continua com todos os nomes). Renomear a propwrap→overlapRow(honestidade da semântica; 2 call sites no card + 1 emMunicipalityAdvisorAvatarStack). Adicionardata-view="relation-avatars"na linha (hook de teste, precedentedata-view="mobile-cards"). Desktop (-space-x-2, cap 3, tooltip) intocado.MunicipalityAdvisorAvatarStack(mesmo arquivo): passawrap→overlapRowno modo denso (call site do card não-coordenador).- Migration: sem migration (nenhuma mudança de schema/collection/global).
- Access / Consent: nenhum (zero paths de escrita tocados).
- UI: Impeccable B — encaixe na tela existente; shape (classes acima) → craft (browser, 390px) → critique (contrastes/vão/overlap) → polish.
Dados → forma
N/A — nenhuma métrica nova; é densidade e alinhamento de superfície existente (intenção: "Vou apresentar dados? Não").
Fases verificáveis
- Tracer — chassis da barra (maioria do appetite): marcador de classe +
:has()no scrollport + densidade do campo/X/anel + compensação das 5 páginas. Verificar:pnpm exec tsc --noEmit+ e2e B184/B183 existentes + novos e2e B196 (barra colada, altura ≤44, sem anel no foco). - UI — card denso: nome/território, chips label-acima, overlap row de avatares, densidade vertical. Verificar: e2e B193 existentes + novos e2e B196 (nome 18px, território colado, label acima do badge, avatares numa linha com overlap e sem overlap quando poucos).
- Gates:
pnpm gate:fastcompleto (tsc, lint, format, knip, cycles, unit+int, e2e do conjunto afetado) epnpm build.
Rabbit holes / Não escopo (engenharia)
- Não tocar
p-4/pb-*do scrollport fora do:has()— opt-0é escopado e é O fix do containing block. - Não mudar
text-smdo input (contrato B183), nem o desktop do omnibox (md:*restaura tudo). - Não criar sistema de avatares novo — só o modo denso do componente existente.
- Alinhamento dos avatares no grupo (adiado): com poucos avatares a pilha fica centralizada no grupo (label à esquerda) — ancorar à esquerda mudaria o perfil de overflow para o grupo vizinho com 4+ avatares; revisitável se o product pedir (gatilho: review Impeccable do /simplify).
- Não polir o rodapé de atualização nem outras arestas do card (item separado na intenção).
- Não mexer em sheets, tooltips de desktop, busca/sugestões do omnibox.
Riscos e mitigação
- Tailwind v4 não compilar
max-md:has-[.campaign-list-omnibox-form]:pt-0: verificar no build da Fase 1; fallback = regra CSS pura emstyles.css(@media (width < 48rem)+.campaign-content-scroll:has(.campaign-list-omnibox-form)). - e2e B193 regressar:
card.getByText('Nível', { exact: true }).click()— a label continua DENTRO do trigger (bloco label-acima), então o clique continua abrindo o sheet;[data-view="mobile-cards"]e classes de borda intactas. - Janela estreita-desktop (container < 48rem) vê o card densificado: aceito — é o MESMO componente mobile (B193 já o estiliza com variantes
md:no article); o desktop de verdade (tabela) não é tocado. - Listas com linha de ações antes do form perdem o respiro no topo com o
pt-0: mitigado pelopt-4 md:pt-0nas 5 páginas; e2e de regressão no/campanha/atividades(barra colada após scroll). has-casar páginas além das listas: o marcador só existe emcampaignListOmniboxFormClassName, usado exclusivamente pelos 11*Filters(verificado por grep); wizard usa forms semrole="search"/marcador.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (vão zero, barra ~40px, sem anel, nome 18px+território colado, chips label-acima, avatares 1 linha sem cap/wrap/"…"; desktop intacto)
- Invariantes AGENTS/engineering-standards (sem schema, sem access, sem Consent; nomes de props em inglês; copy pt-BR preservada)
- Testes previstos: e2e B196 (barra colada + altura + anel + nome/território + labels + overlap de avatares) + regressão B184/B183/B193 existentes; sem unit/int novos (mudança puramente de superfície)
Self-score decision-quality: 5/5 (decisões caras com rejeitadas; cabe no appetite; rabbit holes nomeados; reusa chassis existente — zero módulos novos; intenção preservada)