<!-- GERADO por scripts/gen-skill-refs.mjs a partir de app/generated/components-index.json + components/*.json — ui-nova 1.0.0. NÃO edite à mão. -->

# Inventário por categoria (para decidir REUSO antes de criar qualquer coisa)

Se a necessidade cabe em um item abaixo, use-o (ou componha com ele). Criar um componente paralelo é proibido.

## Fundamentos

| Componente | Para que serve | Variantes |
|---|---|---|
| `VBadge` | Badge é um rótulo compacto para **status**, contagens e indicadores. | outlined, default, primary, neutral, warning, danger, success, purple, count, dot, subtle |
| `VIcon` | Renderiza um ícone SVG a partir de um objeto **Iconify** (`IconifyIcon`). | — |
| `VKbd` | `VKbd` mostra um atalho de teclado (`Ctrl+K`, `⌘ K`, `Esc`). | — |
| `VTag` | `VTag` é o chip de **ação** (e de token acionável). | default, outline, soft, overlay |

## Ações

| Componente | Para que serve | Variantes |
|---|---|---|
| `VActionList` | Lista de ações/propriedades em seções rotuladas — o painel "Environment" de apps de agentes/IDE. | plain, card |
| `VButton` | A versatile action trigger for primary, secondary, and contextual actions. | primary, inverse, destructive, loading, secondary, ghost, outline, icon |
| `VSwipeRow` | Linha com ações reveladas por **swipe horizontal** (arraste o conteúdo para a esquerda; as ações ficam à direita, então arrastar para a direita é bloqueado). | — |
| `VToolbar` | Barra de ações compacta para fluxos de produtividade — agrupa ícones, divisórias, spacer e ação primária (Save) conforme o pôster VueUI Nova. | default, compact, floating, editor, segmented |
| `VToolbarButton` | Botão da VToolbar: ícone, rótulo ou os dois, com variante, estado ativo e menu opcional. | default, primary, toggle |
| `VToolbarDivider` | Separador vertical da VToolbar. | — |
| `VToolbarGroup` | Agrupa botões da VToolbar (por exemplo um segmento de alinhamento) para que o espaçamento e o foco fiquem consistentes. | — |
| `VToolbarSpacer` | Espaçador flexível da VToolbar: empurra o que vem depois para a extremidade oposta (ações primárias à esquerda, ajuda ou avatar à direita). | — |

## Formulários

| Componente | Para que serve | Variantes |
|---|---|---|
| `VCheckbox` | A checkbox component for boolean choices and multi-select interfaces. | — |
| `VFileUpload` | Upload de arquivos com dropzone, validação, progresso e lista de arquivos. | compact, button, dropzone, image |
| `VNumberInput` | A numeric input component with step controls and validation. | — |
| `VOtpInput` | A one-time password / verification code input for secure authentication flows. | — |
| `VPasswordInput` | A secure password field with visibility toggle and strength feedback. | — |
| `VRadioGroup` | Seleção única entre opções mutuamente exclusivas, com layouts vertical, horizontal e card. | — |
| `VSearchField` | Campo de busca com ícone, clear, atalho ⌘K, sugestões e loading. | standard, shortcut, command |
| `VSlider` | A slider component for selecting numeric values or ranges. | — |
| `VSwitch` | Toggle binário on/off para configurações e preferências, com thumb animado e suporte a label/descrição. | — |
| `VTagInput` | A component for entering, editing, and removing tags or chips. | — |
| `VTextarea` | Campo multilinha com auto-resize, contador de caracteres, helper e erro. | — |
| `VTextInput` | A flexible single-line text input for forms and search-like data entry. | — |

## Seleção e menus

| Componente | Para que serve | Variantes |
|---|---|---|
| `VColorPicker` | A color selection component for themes, branding, and creative tools. | inline, popover, hex, opacity, preset |
| `VDatePicker` | Date picker flexível para data única ou intervalo, com calendário acessível e presets. | default, with-icon, with-preset, range |
| `VDateRangePicker` | A start-and-end date selection component for reporting, booking, and filtering workflows. | default, compact, inline, presets, with-time |
| `VDropdownMenu` | Lista de ações e navegação compacta ("Action list and compact navigation"): acesso a ações/links a partir de um único gatilho, mantendo a interface limpa e focada. | default, primary, subtle, destructive, secondary, ghost |
| `VMenuBar` | Componente VueUI Nova para **menu bar**, seguindo tokens semânticos e Light Mode como referência principal. | default, primary, subtle |
| `VSegmentedControl` | Controle segmentado inline de escolha única entre opções relacionadas — alternativa compacta a tabs para trocar views, períodos ou ordenação. | default, pill |
| `VSelect` | Campo de seleção single-choice com label, placeholder, ícone opcional, validação e menu suspenso acessível. | — |
| `VTimeRange` | Barra compacta de intervalo de horário `12:00 → 12:30 · 30min`, usando `<input type="time">` nativo (teclado e leitores de tela inclusos). | — |

## Navegação

| Componente | Para que serve | Variantes |
|---|---|---|
| `VBottomUtilityBar` | Componente VueUI Nova para **bottom utility bar**, seguindo tokens semânticos e Light Mode como referência principal. | default, primary, subtle |
| `VBreadcrumb` | Trilha de navegação hierárquica que mostra onde o usuário está e permite voltar rapidamente aos níveis anteriores. | default, compact, icons, overflow |
| `VCommandItem` | Componente VueUI Nova para **command item**, seguindo tokens semânticos e Light Mode como referência principal. | default, primary, subtle |
| `VCommandPalette` | Superfície universal de busca de comandos: encontrar conteúdo, executar ações e navegar pelo app a partir de um único lugar. | global-search, quick-actions, file-switcher, settings-palette |
| `VNavItem` | Componente VueUI Nova para **nav item**, seguindo tokens semânticos e Light Mode como referência principal. | default, primary, subtle, soft, raised |
| `VPagination` | Controle de navegação página a página. | default, compact, ellipsis |
| `VSidebar` | Painel de navegação persistente com brand, busca global (com filtro), menus multi-nível com acordeão, grupos colapsáveis e área de usuário. | default, floating, card, icons, workspace |
| `VStepper` | Componente VueUI Nova para **stepper**, seguindo tokens semânticos e Light Mode como referência principal. | default, primary, subtle |
| `VTabs` | Contextual content navigation | pill, icon, underline |
| `VTopBar` | Chrome global do app: logo, navegação principal e ações globais no topo da aplicação. | default, primary, subtle, app |
| `VTreeNavigation` | Explorador hierárquico expansível para file systems, settings, documentação e qualquer conteúdo nested. | default, primary, subtle, settings, file, documentation, simple |

## Layout e grids

| Componente | Para que serve | Variantes |
|---|---|---|
| `VAppShell` | `VAppShell` é o **core application layout**: shell de aplicação com top bar, navegação lateral e painel utilitário. | dashboard, editor, settings, content-management |
| `VAutoLayoutGrid` | A flexible auto-flow layout grid for arranging responsive cards and content blocks. | — |
| `VAutoLayoutGridItem` | Célula da VAutoLayoutGrid. | — |
| `VCanvasGrid` | Workspace infinito com grade de encaixe, pan, zoom e minimapa para editores e construtores visuais. | dots, dense, lines, presentation |
| `VCardGrid` | `VCardGrid` organiza cards em uma grade CSS. | — |
| `VDashboardColumn` | Coluna do dashboard que empilha widgets, com cabeçalho, recolhimento, redimensionamento e zona de largada. | collapsible, fixed, fluid, sticky |
| `VDashboardRow` | Fileira do dashboard que alinha, distribui e espaça seções na horizontal, com quebra responsiva. | standard, dense, split, wrap |
| `VDashboardWidget` | Widget de uma VDashboardWidgetGrid. | — |
| `VDashboardWidgetGrid` | A flexible layout grid for dashboard widgets with drag, resize, and responsive placement. | compact, freeform, analytics, editorial |
| `VMasonryGrid` | Layout de conteúdo de altura variável ("masonry"): organiza itens de alturas diferentes em colunas responsivas, sem espaços mortos ("gapless"), com fluxo visual natural. | default, image-first, content-first, mixed-media, magazine |
| `VMasonryItem` | Tile de uma VMasonryGrid: mídia, título, categoria e metadados numa célula de altura variável. | — |
| `VResizablePanel` | A flexible, accessible, and performant resizable panel for modern layouts. | bottom, left, right, collapsible |
| `VSnapGrid` | Canvas de construção com grade de encaixe, guias de alinhamento e réguas para editores e builders. | subtle, visible, magnetic, rulers |
| `VSplitView` | Workspace multi-pane ajustavel (2-3 panes: sidebar, conteudo, inspector) com divisores arrastaveis, seguindo tokens semânticos e Light Mode como referência principal. | — |
| `VThumbnailGrid` | Grade responsiva de miniaturas para mídia, arquivos e galerias, com seleção e ações rápidas. | compact, files, gallery, selectable |
| `VWidgetCell` | Célula de dashboard para KPIs, gráficos, listas e chamadas, com cabeçalho, rodapé e estados. | chart, stat, list, action, placeholder |

## Superfícies

| Componente | Para que serve | Variantes |
|---|---|---|
| `VAccordion` | Progressive disclosure for FAQs, settings panels, and any content that benefits from a clear, compact hierarchy. | default, bordered, divided, leading-icon |
| `VAccordionItem` | Item de um VAccordion: o gatilho mostra o título e o slot default é o corpo que se expande. | — |
| `VCard` | Flexible content container | elevated, outlined, filled, interactive |
| `VInspectorPanel` | A flexible side panel for inspecting and editing content, properties, and settings. | default, minimal, tabs, floating |
| `VPanel` | O `VPanel` é um contentor flexível para agrupar conteúdo relacionado — informação, ações e media — em secções claras e autocontidas. | elevated, filled, default, bordered |
| `VSection` | A flexible container for organizing related content into a clear, structured section. | elevated, default, bordered, borderless, tinted |
| `VWindow` | Desktop-like application container (spec `DESIGN-SPEC.md`): titlebar com semáforo macOS + app icon + título + ações, sidebar Overview/Notes/Tasks/Assets/Settings, content area, resize handle e backdrop no modal. | default, minimal, borderless, modal |

## Overlays

| Componente | Para que serve | Variantes |
|---|---|---|
| `VContextMenu` | Componente VueUI Nova para **context menu**, seguindo tokens semânticos e Light Mode como referência principal. | — |
| `VDialog` | Superfície modal temporária para informação crítica, decisões e tarefas focadas. | basic, confirmation, alert, form, fullscreen |
| `VDrawer` | Painel contextual slide-in que revela detalhes e ações sem tirar o usuário da página atual. | default, primary, subtle |
| `VPopover` | Superfície flutuante contextual ancorada a um trigger — informação rápida, ações ou formulários sem sair da página. | — |
| `VSheet` | Superfície edge-attached que desliza da borda para tarefas focadas (settings, details, creation flows), sem tirar o usuário do contexto. | — |
| `VTooltip` | Dica contextual (contextual helper hint) que exibe informação breve e contextual ao dar hover, focus ou tap num elemento. | default, success, error, with-icon, brand, light |

## Feedback e status

| Componente | Para que serve | Variantes |
|---|---|---|
| `VAlert` | Mensagem **dentro do conteúdo** (formulário, card, seção): ocupa a largura do container, com ícone na cor da variante, fundo suave e borda leve. | neutral, warning, danger, success, info |
| `VBanner` | A flexible banner component for important messages, alerts, and contextual information. | neutral, warning, success, error, info |
| `VEmptyState` | A flexible empty state component for when there's nothing to show. | default, results, files, notifications, create |
| `VNotificationCenter` | A flexible notification center for in-app messages, alerts, and updates. | default, compact, feed, grouped, drawer |
| `VNotificationItem` | A flexible notification item for messages, activity, and system alerts. | default, success, avatar, system, actionable |
| `VProgress` | Indicador de progresso linear e circular que comunica claramente o status de conclusão de uma tarefa ou processo. | linear, circular |
| `VSkeleton` | A flexible loading placeholder for content that's on its way. | avatar, text, card, table-row, chart |
| `VSpinner` | A flexible loading indicator for communicating progress and waiting states. | inline, circular, dots, ring, lattice |
| `VStatusMark` | Marcador compacto de status de uma tarefa/execução (ocioso, em andamento, sucesso, erro) com `role="status"`. | — |
| `VToast` | Mensagem transitória de feedback (transient feedback message) que informa ação, evento de sistema ou atualização de status de forma breve e não intrusiva. | warning, success, error, info, loading |
| `VToastStack` | Pilha de toasts ligada à fila `useVToastQueue()`. | — |

## Dados e tabelas

| Componente | Para que serve | Variantes |
|---|---|---|
| `VDateTile` | Mini-calendário "SEP 29" para prazos em listas. | — |
| `VDescriptionList` | Lista de descrição (`<dl>`) para metadados e detalhamentos com total. | — |
| `VDiffStat` | Resumo de diff `+193 −130` com rótulo acessível e blocos de proporção opcionais. | — |
| `VFilterBar` | Conjunto de controles inline para buscar, filtrar e refinar data views: ajuda a estreitar conteúdo rapidamente com interface limpa, consistente e flexível. | basic, sticky, chips, advanced |
| `VGroupedTable` | Tabela agrupada e responsiva ao **container** (não à viewport): colunas aparecem/somem conforme a largura do painel e podem "colapsar" inline na coluna principal — o padrão "tables that split, stretch and snap". | — |
| `VKanbanBoard` | Quadro Kanban com cards ricos (tags, código, prioridade, prazo, checklist, responsável), drag-and-drop nativo e alternativa por teclado (**Alt + ←/→** muda de coluna, **Alt + ↑/↓** reordena) com anúncio em live region. | — |
| `VTable` | Exibição de dados estruturados para ver, entender e operar: suporta sorting, seleção, inline actions e progressive disclosure num design limpo, consistente e flexível. | default, minimal, bordered, striped, comparison |
| `VTimeline` | Linha do tempo vertical. | steps, feed |

## Gráficos e métricas

| Componente | Para que serve | Variantes |
|---|---|---|
| `VBarChart` | Gráfico de barras verticais leve (sem dependências) para tendências curtas — barras em cápsula com destaque na barra ativa, como no hero do Clawback. | pill, solid |
| `VBarList` | Lista de barras horizontais rotuladas para rankings e distribuições ("Why claims get denied", "How fast money moves"). | — |
| `VFlowPath` | Caminho de fluxo linear (agentes, serviços, etapas) com métricas na aresta. | — |
| `VFunnelChart` | Funil de pipeline em colunas: valor por etapa, cápsula proporcional à maior etapa e taxa de conversão entre etapas. | — |
| `VStatCard` | Cartão de KPI: rótulo, valor em destaque, variação com tendência e métricas secundárias. | elevated, outlined, tinted, plain |

## Mídia e pessoas

| Componente | Para que serve | Variantes |
|---|---|---|
| `VAvatar` | Representar pessoas, times ou entidades: ajuda a reconhecer "quem é quem", mostra presença (online/busy) e dá toque humano ao produto. | — |
| `VGroupAvatar` | Grupo de avatares empilhados, com um contador de overflow quando há mais membros do que o `max` visível. | — |
| `VImageGallery` | Visual collection and preview | — |

## IA

| Componente | Para que serve | Variantes |
|---|---|---|
| `VAgentChip` | Indicador compacto de execução de ferramenta do agente (pending, success, error) com duração e retry. | — |
| `VAudioRecorder` | Barra de nota de voz (gravar, pausar, salvar, ouvir, descartar) com waveform. | — |
| `VPromptBar` | Barra de prompt para superfícies de IA com anexo, dictation (Voice Pill) e ação send/stop. | — |
| `VThoughtLine` | Linha expansível de raciocínio do agente com timer, trace de passos e resumo ao concluir. | — |

