mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-20 18:24:45 +00:00
- CampaignHomeActionStrip: grid-cols-3 no mobile; variante grid para overlay - CampaignQuickActionsOverlay: grade no lugar da strip; altura por conteúdo; pt-4 na busca focada; limpa query ao fechar - CampaignQuickActionsHost: clear() em fechamento e mudança de rota - Testes unit atualizados; impl plan em docs/plans/ Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# Impl: Ações rápidas — grade 3×2 (Início + FAB) e polimento do overlay
|
||
|
||
Status: aprovado
|
||
Atualizado em: 2026-08-02
|
||
Issue: #280
|
||
Intenção: docs/plans/acoes-rapidas-grade-3x2-fab-overlay.md
|
||
Appetite restante: ~0,5d (layout + overlay polish)
|
||
|
||
## Leitura da intenção
|
||
|
||
- **Outcome:** Início mobile e overlay FAB usam grade 3×2; overlay sem strip scroll; drawer encaixa no conteúdo; busca com respiro no topo quando focada; query limpa ao fechar/navegar.
|
||
- **O que NÃO negociar:** catálogo/lockdown; Início md+ strip; sem migration; sem snap/peek.
|
||
- **O que reavaliar:** variante `strip` no overlay → nova variante `grid` (grade em todas as larguras do overlay); bleed `-mx-4` obsoleto com grade.
|
||
|
||
## Abordagem recomendada
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
Strip["CampaignHomeActionStrip"]
|
||
Strip -->|responsive| H["grid 3-col lt-md / strip md+"]
|
||
Strip -->|grid| O["grid 3-col sempre"]
|
||
Strip -->|strip| S["flex scroll"]
|
||
Host["CampaignQuickActionsHost"] -->|close/pathname| Clear["useHomeSearch.clear"]
|
||
```
|
||
|
||
**Opções consideradas:** A) reutilizar `responsive` no overlay (quebra desktop — vira strip) | B) variante `grid` dedicada | C) prop `columns={3}`
|
||
**Recomendação:** **B** — `grid` para overlay; `responsive` passa de 2→3 colunas no mobile.
|
||
**Rejeitadas:** A (aceite exige grade no dialog desktop); C (over-parameterize).
|
||
|
||
### Componentes / mudanças
|
||
|
||
- **`CampaignHomeActionStrip`:** `variant` ganha `'grid'`; `responsive` usa `grid-cols-3`; `grid` = `grid grid-cols-3 gap-3` sem overflow/pan.
|
||
- **`CampaignHomeActionButton`:** sem mudança (já `w-full` em responsive/grid).
|
||
- **`CampaignQuickActionsOverlay`:** `variant="grid"`; remove bleed wrapper; drawer sem `flex-1` stretch — altura auto com `max-h` só como teto; `pt-4` na busca quando `uiFocused`.
|
||
- **`CampaignQuickActionsHost`:** `clear()` em `onOpenChange(false)` e no `useEffect` de `pathname`.
|
||
- **Tests:** strip spec 2→3 cols; overlay strip→grid; bleed test removido/atualizado; clear on close/pathname.
|
||
- **Migration:** sem migration.
|
||
|
||
### Dados → forma
|
||
|
||
N/A — chrome de launcher.
|
||
|
||
## Fases verificáveis
|
||
|
||
1. **Strip variants** — `grid-cols-3` + variante `grid`.
|
||
2. **Overlay polish** — grid, altura conteúdo, respiro busca, clear query.
|
||
3. **Gates** — `pnpm gate:fast`; `pnpm push`.
|
||
|
||
## Rabbit holes / Não escopo (engenharia)
|
||
|
||
- Refatorar `Drawer.tsx` globalmente.
|
||
- Extrair tile genérico.
|
||
- Mudar tamanho dos círculos de ação.
|
||
|
||
## Riscos e mitigação
|
||
|
||
- **3 colunas em 390px:** gap-3 + w-full já usados em B122; labels line-clamp-2.
|
||
- **Clear no Início:** provider separado no home — clear no host só afeta overlay provider.
|
||
- **Dialog desktop altura:** manter `max-h` como teto para resultados longos.
|
||
|
||
## Aceite de engenharia
|
||
|
||
- [x] Aceite de produto da intenção ainda coberto
|
||
- [x] Invariantes AGENTS/engineering-standards
|
||
- [x] Testes unit previstos (strip, overlay, clear)
|
||
|
||
Self-score decision-quality: 5/5
|