# Crash — busca no bottom drawer (focus / digitação) Status: done Atualizado em: 2026-08-01 Issue: #129 (file-miss plan #133 · delivery #135) Priority: P0 Model: cursor-grok-4.5-medium Impeccable: B — `CampaignQuickActionsDrawer` + `CampaignGlobalSearchBody` Appetite: ~0,5–1d eng; root-cause + fix + pin focus/type; sem migration Responsável: — ## Freshness audit (2026-08-01) - Arquivos citados existem; assinaturas de `useHomeSearch` / `useHomeSearchResultsState` / drawer intactas. - Sem migration; deps soft B91/B100 done. - **Root cause confirmada (repro unit):** `TooltipProvider` no layout `(app)` envolvia só `{children}` dentro de `CampaignAppScrollChrome`. O drawer monta como **irmão** do scrollport → fora do provider. Focus → `mode:suggest` → hits `priority:'alta'` → `MunicipalityPriorityIndicator` → `CampaignHoverTooltip` → throw ``Tooltip` must be used within `TooltipProvider`` → página cai. Início não crasha porque o drawer não monta lá e a busca vive sob o provider dos children. Digitar com hits prioritários crashava pelo mesmo motivo; o pin B100 só mudava query com payload vazio (sem flag). ## Design (Impeccable) Âncoras: `PRODUCT.md` (Feel the action) · B91/B100 drawer search · tema `campaign`. Na implementação: reproduzir → fix mínimo → pin (unit + e2e mobile se estável). Sem craft visual além do necessário para o ritual de busca voltar. Brief: - **Persona:** staff no detalhe de município (mobile); toca “Buscar na campanha” no drawer. - **Job principal:** focar e digitar **sem** a página cair; ver suggest/hits. - **Anti-goals:** redesenhar o drawer (→ **B105**); silenciar o throw com try/catch cosmético. ### Wireframe (texto) ```text ┌─ /campanha/municipios/foo (mobile) ────────────┐ │ conteúdo │ ├─ drawer dock ──────────────────────────────────┤ │ ═ handle │ │ [ações…] │ │ ┌ Buscar na campanha ──── focus/type OK ─────┐ │ │ │ Sugestões / hits (sem crash) │ │ │ └────────────────────────────────────────────┘ │ └────────────────────────────────────────────────┘ ``` ## Dados → decisão → apresentação Dados: N/A neste item (hits já existem via B48/B68/B91); só estabilidade do chrome. ## Contexto Fora do Início, o drawer (**B79–B91**, **B100 ✓**) embute `CampaignGlobalSearchBody` sob `CampaignGlobalSearchProvider` em `CampaignAppScrollChrome`. Produto (2026-08-01): **ao clicar ou começar a escrever na barra de busca, a página crasha**. Diagnóstico preliminar (código em `main`): 1. Unit do drawer (`campaignQuickActionsDrawer.unit.spec.tsx`) cobre `change` → POST `mode: 'search'`, **não** `focus` → `setInputFocused(true)` → `mode: 'suggest'`. 2. `useHomeSearchResultsState` entra em `suggestMode` quando `uiFocused && !query.isActive` e monta os grupos B48 dentro do snap (`overflow-hidden`, dock `12rem`). 3. `CampaignContentScrollWithPeek` chama `useHomeSearch()` — correto só dentro do provider; árvore atual amarra provider + peek. Hipótese secundária: interação Base UI Drawer non-modal + focus/teclado / nested `Drawer` dos action buttons. 4. Runtime Vercel (server) **não** mostra o digest do crash (erro de client). **Miss de agente:** B100 / follow-up `a056616d` shipparam sem pin de focus+type no drawer. Registrar via `pnpm agent:file-miss` (`kind:defect` ou `agent-miss`) **neste delivery**, depois o fix. ## Objetivos - Reproduzir o crash (mobile real ou Playwright viewport mobile em `/campanha/municipios/[slug]`). - Eliminar a causa raiz (não engolir o erro). - Pins: unit **focus** dispara suggest sem throw; unit/e2e **type** mantém search; regressão no caminho provider/`uiFocused`. - Guardrails: sem migration; leader lockdown; Início intacto. - Tracer: focus no input do drawer → região de resultados monta; digitar “ca” → POST search; zero uncaught. ## Decisões travadas - **Issue própria P0 + file-miss, não absorver em B105.** Crash bloqueia o ritual. **Rejeitado:** “conserta no polish do drawer”. - **Fix mínimo no caminho focus→suggest→render; não redesenhar snap.** Geometria/gesto → **B105**. **Rejeitado:** reescrever busca só para o drawer. - **File-miss obrigatório** com causa + PR culpado quando conhecido. **Rejeitado:** só Issue de feature sem harvest. - **i18n:** ids existentes; sem copy nova. - **Fix (as-built):** elevar `TooltipProvider` no layout `(app)` para envolver `CampaignAppScrollChrome` inteiro (scroll + drawer). Harness unit espelha isso. ## Questões em aberto - _(nenhuma — root cause fechada no repro unit; fix as-built acima)_ ## Abordagem proposta ```mermaid flowchart LR Focus["input onFocus"] --> Ui["uiFocused"] Ui --> Suggest["POST mode:suggest"] Suggest --> Groups["HomeSearch*Group"] Groups -->|crash?| Fix["fix root"] Type["onChange"] --> Search["POST mode:search"] ``` Componentes: - **Repro:** Playwright mobile ou unit com `fireEvent.focus` + wait suggest; ler stack. - **Provável superfície:** `CampaignStaffGlobalSearch` / `HomeSearchResultsLayout` / `Drawer` + focus; eventualmente provider tree se achar caminho sem `HomeSearchProvider`. - **Pins em** `tests/unit/campaignQuickActionsDrawer.unit.spec.tsx` (+ e2e `campaignMunicipalities` se estável). - **Migration:** Sem migration. - **File-miss:** `pnpm agent:file-miss -- --title "…" --kind defect` com body apontando B100/`a056616d` e ausência de pin focus. ## Dependências - Soft: B91 ✓, B100 ✓. Nenhuma dura. **B105** pode pousar depois (gesto/handle); não bloqueia o fix. ## Não escopo - Handle no topo / scroll abre / placeholder collapsed → **B105**. - Remover título “Sugestões” → **B103** (pode coincidir visualmente no empty, mas é copy). - Strip bleed → **B101**. ## Rabbit holes - **Trocar Base UI Drawer por sheet caseiro.** Mitigação: só se a root cause for o primitivo e não houver escape hatch documentado. - **Duplicar `CampaignHomeSearch` “safe” só para drawer.** Mitigação: consertar o shared. ## Adiado com gatilho - 3º snap alto só para resultados. Revisitar se, após o fix, critique de **B105** mostrar hits cortados no dock. ## Referências - GitHub Issue #129 (B102) · file-miss #133 - `CampaignQuickActionsDrawer.tsx` · `CampaignAppScrollChrome.tsx` · `CampaignQuickActionsHost.tsx` · `HomeSearchResultsContext.tsx` · `CampaignStaffGlobalSearch.tsx` - `tests/unit/campaignQuickActionsDrawer.unit.spec.tsx` - AGENTS.md — Feel the action; client boundary