Impl: FAB — overlay abre sem foco na busca; fechar não cobre o campo

Status: aprovado Atualizado em: 2026-08-02 Issue: #317 Intenção: docs/plans/fab-overlay-sem-autofocus-e-fechar.md Appetite restante: herdado (~0,5 dia eng)

Leitura da intenção

Outcome: Ao abrir o FAB, o overlay inicia em estado idle — ações visíveis, busca sem foco. Desktop: X não sobrepõe a busca. Mobile: handle de swipe, sem X.
O que NÃO negociar: Ritual B132 (foco deliberado na busca ainda recolhe ações); catálogo/lockdown/limpeza de query inalterados; sem migration/Consent/RBAC.
O que reavaliar: A hipótese de autoFocus explícito no input estava errada — o foco vem do trap de foco padrão do Dialog (Radix onOpenAutoFocus) e do Drawer (base-ui initialFocus default).

Abordagem recomendada

flowchart LR
  FAB[FAB click] --> Open[Overlay opens]
  Open --> NoFocus[Block open autofocus]
  NoFocus --> Idle[Idle: actions visible]
  Idle -->|user taps search| Retract[B132 retract]
  Open --> Desktop[md+: pr on search + default X]
  Open --> Mobile[mobile: showSwipeHandle, no X]

Opções consideradas:

Opção	Descrição	Veredito
A	`onOpenAutoFocus` / `initialFocus={false}` no overlay + `md:pr-10` na busca + `showSwipeHandle` no drawer	Recomendada — mínima, escopada ao dono
B	Header dedicado com X em flow no dialog	Rejeitada — mais chrome, fora do appetite
C	`showCloseButton={false}` + close custom em todo dialog kit	Rejeitada — polui kit global

Recomendação: A — três props no CampaignQuickActionsOverlay, sem alterar dialog.tsx/Drawer.tsx globalmente.

Componentes / mudanças

CampaignQuickActionsOverlay (src/components/campaign/shell/CampaignQuickActionsOverlay.tsx):
- Dialog: onOpenAutoFocus → preventDefault + foco no DialogTitle (titleRef, padrão B42)
- Dialog: md:pr-10 em OverlaySearchChrome (reserva faixa para X right-3 size-8)
- Drawer: showSwipeHandle no Drawer; initialFocus={titleRef} em DrawerContent
Migration: sem migration
Access / Consent: N/A
UI: Impeccable B — polimento do chrome existente

Dados → forma

N/A

Fases verificáveis

UI — props de foco + padding + handle; testes unitários no spec existente
Gates — pnpm gate:fast; push via pnpm push

Rabbit holes / Não escopo (engenharia)

Alterar DialogContent default global
Desligar recolhimento B132 ao focar
Redesenhar grade ou catálogo

Defer (gatilho): extrair HomeChromeRetractionShell compartilhado com CampaignHomeLayout quando um 3º chrome retrátil for tocado de novo (já é o 3º — quick-actions-chrome; extrair em issue futura, fora do appetite B146).

Riscos e mitigação

Risco	Mitigação
`initialFocus={false}` quebra a11y teclado	Foco no título sr-only (B42), não na busca nem em void
`pr-10` insuficiente em telas estreitas	`md:` só no breakpoint dialog; mobile usa drawer

Aceite de engenharia

Aceite de produto da intenção ainda coberto
Invariantes AGENTS/engineering-standards
Testes unitários previstos em campaignQuickActionsDrawer.unit.spec.tsx

3.8 KiB Raw Permalink Blame History