# Cobertura exaustiva — ClickAgents → Baluarte v1.5

> Fonte: `~/Desktop/Projects/clickagents-frontend` (jul/2026).
> Snapshot: branch `luiz-ui-consistency`, commit `9776b768fb985aad67fd15a39662330e749eb262`.
> Corpus SHA-256: `3cc736811b8a5ee3a01a4ad81d69b08d436dfe65b22e694cedd62e0f719985a6`.
> Evidência de máquina: `clickagents-inventory-v1.5.json` — 82 TSX, 959 classes CSS.
> Regra: todo padrão visual recebe decisão explícita; nem todo padrão vira core.

## Legenda

- **core** — componente universal e estável da família.
- **extension** — componente reutilizável ainda em validação.
- **pattern** — composição de múltiplos componentes para um fluxo.
- **domain** — capacidade específica; documentada, não promovida ao core.

## Bloco A — Ações e comandos

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Button | core | login/register/share/canvas actions | manter + estados completos |
| Icon button | core | headers, canvas, chat actions | manter + contrato iconográfico |
| Button link | core | forgot link, terms, inline actions | adicionar |
| Button group | core | modal/footer/canvas actions | adicionar |
| Split/menu button | extension | share/publish + caret/menu | adicionar |
| Contextual actions | pattern | message icons, library kebab | adicionar |
| Toolbar | core | canvas toolbar, headers | adicionar |
| Floating toolbelt | pattern | image editing controls | manter/promover documentação |

## Bloco B — Entradas e seleção

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Form field | core | login, register, share SEO | adicionar |
| Text field | core | share input, modal search | manter |
| Password field | extension | login/register password toggle | adicionar |
| Phone/country field | extension | IMaskInput + react-select | adicionar |
| Textarea | core | instructions, knowledge, SEO | separar do text field |
| Elastic textarea | extension | composer/config knowledge | adicionar |
| Search field | core | library/config/modal search | adicionar |
| Select/combobox | core | countries, models, agents | adicionar |
| Checkbox | core | filters and selection | manter |
| Radio | core | representation/state choices | manter |
| Switch | core | knowledge/share toggles | manter |
| Segmented control | core | analytics/filter toggles | promover de pattern |
| Slider/range | core | canvas adjustments, zoom, replay | adicionar |
| Date range picker | extension | UsageAnalytics RangePicker | adicionar |
| Color picker | extension | PDF/image/background tools | adicionar |
| File upload/dropzone | core | MarkSelector upload/file input | adicionar |
| Mark picker | extension | emoji/icon/image selector | adicionar |
| Filter control | pattern | library/config filters | adicionar |
| Token counter | extension | Tokenizer in instruction fields | adicionar |

## Bloco C — Navegação e estrutura

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| App header | core | headers across Main/Library/Analytics | adicionar |
| Sidebar/navigation rail | core | Sidebar.tsx | implementado · frame 260/48 + 40 grupos colapsáveis |
| Tabs | core | share tabs, sheet tabs, mark tabs | manter |
| Menu/dropdown | core | tippy menus across app | manter + code |
| Popover | core | Tippy interactive surfaces | adicionar |
| Drawer/side panel | core | config open/collapsed panel | adicionar |
| Accordion | core | task accordion, grouped sidebar | adicionar |
| Pagination/page control | extension | PDF/slides page navigation | adicionar |
| Thumbnail rail | extension | PDF/document/slides thumbs | adicionar |
| Step indicator | extension | login/register multistep flow | adicionar |
| Back navigation | core | embed/SEO subviews | adicionar |
| Split pane/resize handle | extension | `col-resize` em sidebar e config | documentar e validar |

## Bloco D — Conteúdo e dados

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Avatar | core | share users/account | manter |
| Avatar group | core | collaboration/access | adicionar |
| Account/user profile | extension | sidebar footer avatar/name/description | manter em validação |
| Agent mark | extension | emoji/icon/image agent identity | adicionar |
| Provider/model mark | extension | ConfigModelMark | adicionar |
| Badge/status label | core | filters/status/maturity | manter |
| Chip/tag | core | context, files, filters | manter |
| Card | core | config/library | manter + code |
| Activation/integration card | extension | channel create modal/cards | adicionar |
| Entity item | core | agents, chats, knowledge | manter |
| List/list item | core | menus, files, sources | manter + code |
| Data table | core | library/spreadsheet/markdown table | manter + code |
| KPI/stat card | core | UsageAnalytics totals | adicionar |
| Chart | extension | MUI LineChart/BarChart | adicionar |
| Meter/usage bar | core | analytics usage/limits | adicionar |
| Code block | core | markdown/code canvas | adicionar |
| Markdown content | extension | chat/document renderer | adicionar |
| File attachment | core | ChatMessageFiles | adicionar |
| Media card | core | library/media | manter + code |
| Image gallery | extension | ChatGallery | adicionar |
| Source/reference item | pattern | SourcesCanvas/message sources | promover/documentar |
| Empty state | core | library/config/source empty | manter + code |
| Divider | core | menus/toolbars/sections | adicionar ao catálogo |
| Bulk selection/actions | pattern | library selection count/clear | documentar |

## Bloco E — Feedback e overlays

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Alert/banner | core | Alert.tsx | manter + variantes |
| Toast/snackbar | core | alert/global feedback behavior | manter |
| Dialog/modal | core | Modal.tsx/config/share | manter + code |
| Confirmation dialog | pattern | delete modal | adicionar |
| Tooltip | core | GlobalTooltip/Tippy | manter |
| Loading spinner | core | loaders throughout | adicionar |
| Loading overlay | pattern | main/config/file loading | adicionar |
| Skeleton | core | pending/async surfaces | manter |
| Progress bar | core | agent/file/task progress | manter |
| Circular progress | core | pending canvases | adicionar |
| Status indicator | core | task/live/online dots | adicionar |
| Retry/error state | pattern | ChatBody retry-error | adicionar |

## Bloco F — Conversação e IA

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Chat message | extension | ChatMessageItem | adicionar |
| Message actions | pattern | ChatMessageIcons | adicionar |
| Thinking indicator | extension | ChatThinkingIndicator | adicionar |
| Typewriter/cursor | extension | ChatTypewriterText/ChatBody cursor | adicionar |
| Follow-up suggestions | pattern | ChatMessageFollowUps | adicionar |
| Task accordion | pattern | ChatTasksAccordion | adicionar |
| Task item | extension | ChatTaskItem/Action/StatusIcon | adicionar |
| Agent task progress | extension | AgentTaskProgress | adicionar |
| Conversational composer | pattern | MainContent input | manter + detalhar |
| Attachment tray | pattern | input files/ChatMessageFiles | adicionar |
| Voice recording state | extension | MediaRecorder flow/input glow | adicionar |
| Model selector | extension | Config model menu/mark | adicionar |
| Agent selector | extension | header agent-select | adicionar |

## Bloco G — Canvas e edição

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Canvas shell | extension | Image/PDF/Slides/Code/Document | implementado · largura ampla 46vi |
| Canvas toolbar | extension | shared canvas-toolbar classes | adicionar |
| File metadata header | extension | canvas-meta/file chip | adicionar |
| Zoom control | extension | document/PDF/sheet zoom | adicionar |
| Page navigator | extension | PDF/slides controls | adicionar |
| Crop overlay/handles | domain | ImageCanvas crop | documentar |
| Adjustment panel | extension | CanvasAdjustPanel | adicionar |
| Filter gallery | extension | CanvasFilterMenu | adicionar |
| Background picker | extension | CanvasBgMenu | adicionar |
| Format/aspect selector | extension | CanvasFormatMenu | adicionar |
| Annotation color picker | extension | PdfCanvasColorMenu | adicionar |
| Spreadsheet grid/formula bar | domain | SpreadsheetCanvas | documentar |
| Slide thumbnail | extension | SlideThumb | adicionar |
| Text edit popup | extension | TextEditPopup | adicionar |
| Video player | domain | VideoCanvas | documentar |
| Computer replay player | domain | AgentComputerCanvas | documentar |
| Pending file canvas | pattern | PendingFileCanvas | adicionar |
| Sources panel | pattern | SourcesCanvas | implementado · largura 2/3 |
| Drag/reorder | pattern | knowledge card drag preview/hover | documentar |
| Object transform controls | domain | montage rotate/delete/handles | documentar |

## Bloco H — Compartilhamento, autenticação e domínio

| Componente | Camada | Evidência ClickAgents | v1.5 |
|---|---|---|---|
| Authentication panel | pattern | Login/Register | adicionar |
| Social sign-in button | extension | Google login | adicionar |
| Share access list | pattern | ShareAccessMenu/ShareShareView | adicionar |
| Permission selector | extension | ShareGeneralMenu/AccessMenu | adicionar |
| Publish panel | pattern | SharePublish* views | adicionar |
| Embed code panel | pattern | SharePublishEmbedView | adicionar |
| SEO preview | extension | SharePublishSeoView | adicionar |
| Channel/integration tile | extension | Channels/ChannelCreateModal | adicionar |
| Library browser | pattern | Library.tsx | adicionar |
| Analytics dashboard | pattern | UsageAnalytics | adicionar |

## Resultado esperado

- **Core universal:** 48 componentes.
- **Extensões governadas:** 43 componentes.
- **Padrões compostos:** 22 padrões.
- **Domínio documentado:** 5 capacidades.
- **Total de decisões explícitas:** 118.

## Estados de entrega

- **decidido** — camada e destino explícitos; todos os 118 itens.
- **documentado** — aparece no catálogo com contexto e maturidade; todos os 118 itens.
- **implementado** — possui contrato CSS/HTML de referência na v1.5; indicado individualmente no portal.

A contagem de decisões não afirma que todos os itens são core nem que todos já possuem implementação. Extensões, padrões e domínio avançam somente com evidência.

Nenhum padrão do inventário ClickAgents fica sem camada ou destino.