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

# Componentes da ui-nova (103 implementados)

Importe sempre do pacote: `import { VNome } from 'vueui-nova-kit'`. `v-model` = prop `modelValue` + evento `update:modelValue`.

## Fundamentos

### VBadge
Badge é um rótulo compacto para **status**, contagens e indicadores.
- **props**: `size?`: "sm" \| "md" \| "lg" \| "xs" = "md"; `variant?`: "outlined" \| "default" \| "primary" \| "neutral" \| "warning" \| "danger" \| "success" \| "purple" \| "count" \| "dot" \| "subtle"; `count?`: string \| number; `dot?`: boolean; `dotColor?`: string; `icon?`: string; `interactive?`: boolean = false; `removable?`: boolean = false; `leaving?`: boolean = false; `selected?`: boolean = undefined; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string; `removeLabel?`: string; `live?`: boolean = false; `animate?`: boolean = false; `dataTestId?`: string; `removeTestId?`: string
- **eventos**: `click` (MouseEvent), `select` (MouseEvent), `update:selected` (boolean), `remove` (MouseEvent)
- **slots**: `icon`, `default`

### VIcon
Renderiza um ícone SVG a partir de um objeto **Iconify** (`IconifyIcon`).
- **props**: `icon?`: IconifyIcon; `size?`: "sm" \| "md" \| "lg" = "md"

### VKbd
`VKbd` mostra um atalho de teclado (`Ctrl+K`, `⌘ K`, `Esc`).
- **props**: `keys?`: string \| string[] = undefined; `size?`: "sm" \| "md" = "sm"; `dataTestId?`: string = undefined
- **slots**: `default`

### VTag
`VTag` é o chip de **ação** (e de token acionável).
- **props**: `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "outline" \| "soft" \| "overlay" = "default"; `interactive?`: boolean \| null = null; `selected?`: boolean; `disabled?`: boolean = false; `removable?`: boolean = false; `leaving?`: boolean = false; `ariaLabel?`: string; `removeLabel?`: string; `dataTestId?`: string; `removeTestId?`: string
- **eventos**: `click` (event: MouseEvent), `remove` (event: MouseEvent)
- **slots**: `icon`, `default`

## Ações

### VActionList
Lista de ações/propriedades em seções rotuladas — o painel "Environment" de apps de agentes/IDE.
- **props**: `sections?`: VActionListSection[]; `variant?`: "plain" \| "card" = "card"; `size?`: "sm" \| "md" = "md"; `dividers?`: boolean = true; `ariaLabel?`: string; `dataTestId?`: string
- **eventos**: `select` (item: VActionListItem, section: VActionListSection), `section-action` (sectionId: string)
- **slots**: `label`, `[`trailing-${item.value}`]`, `[`section-${section.id}`]`

### VButton
A versatile action trigger for primary, secondary, and contextual actions.
- **props**: `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `shape?`: "default" \| "pill"; `variant?`: "primary" \| "inverse" \| "destructive" \| "loading" \| "secondary" \| "ghost" \| "outline" \| "icon" = "primary"; `intent?`: "neutral" \| "success"; `type?`: "button" \| "submit" \| "reset" = "button"; `ariaLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `microInteraction?`: "default" \| "fuse" \| "hold" \| "favorite" = "default"; `undoWindow?`: number; `holdDuration?`: number; `favoriteCount?`: number
- **eventos**: `click` (event: MouseEvent), `undo`, `confirmed`
- **slots**: `icon`, `default`, `undo-label`, `icon-end`

### 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).
- **props**: `actions?`: VSwipeRowAction[] = []; `disabled?`: boolean = false; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `action` (payload: VSwipeRowAction)
- **slots**: `default`

### 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.
- **props**: `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "compact" \| "floating" \| "editor" \| "segmented" = "default"; `ariaLabel?`: string
- **slots**: `default`

### VToolbarButton (filho de VToolbar)
Botão da VToolbar: ícone, rótulo ou os dois, com variante, estado ativo e menu opcional.
- **props**: `icon?`: string; `label?`: string; `variant?`: "default" \| "primary" \| "toggle" = "default"; `active?`: boolean = false; `disabled?`: boolean = false; `menu?`: VToolbarMenuItem[]; `ariaLabel?`: string
- **eventos**: `click` (event: MouseEvent), `select` (value: string), `open-change` (open: boolean)

### VToolbarDivider (filho de VToolbar)
Separador vertical da VToolbar.

### VToolbarGroup (filho de VToolbar)
Agrupa botões da VToolbar (por exemplo um segmento de alinhamento) para que o espaçamento e o foco fiquem consistentes.
- **slots**: `default`

### VToolbarSpacer (filho de VToolbar)
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

### VCheckbox
A checkbox component for boolean choices and multi-select interfaces.
- **v-model**: sim
- **props**: `modelValue?`: boolean = false; `indeterminate?`: boolean = false; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `strikeThrough?`: boolean \| VMotionStrike; `doneOpacity?`: number = 0.62; `label?`: string; `description?`: string; `helperText?`: string; `errorMessage?`: string; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `name?`: string; `id?`: string; `value?`: string \| number \| boolean; `required?`: boolean = false; `linkHref?`: string; `linkLabel?`: string
- **eventos**: `update:modelValue` (value: boolean), `change` (value: boolean)
- **slots**: `label`

### VFileUpload
Upload de arquivos com dropzone, validação, progresso e lista de arquivos.
- **v-model**: sim
- **props**: `modelValue?`: File[] = []; `variant?`: "compact" \| "button" \| "dropzone" \| "image" = "dropzone"; `size?`: "sm" \| "md" \| "lg" = "md"; `accept?`: string; `multiple?`: boolean = true; `disabled?`: boolean = false; `maxSize?`: number; `helperText?`: string; `label?`: string; `buttonLabel?`: string; `dropzoneTitle?`: string; `dropzoneHint?`: string; `autoUpload?`: boolean = true; `simulateUpload?`: boolean = true
- **eventos**: `update:modelValue` (value: File[]), `change` (value: File[]), `upload` (item: import('./VFileUpload.types').VFileUploadFile), `error` (payload: { file: File; message: string }), `remove` (file: File)
- **slots**: `icon`, `default`

### VNumberInput
A numeric input component with step controls and validation.
- **v-model**: sim
- **props**: `modelValue?`: number \| null = null; `label?`: string; `helperText?`: string; `errorMessage?`: string; `placeholder?`: string; `disabled?`: boolean = false; `readonly?`: boolean = false; `required?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `min?`: number; `max?`: number; `step?`: number = 1; `prefix?`: string; `suffix?`: string; `name?`: string; `id?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `interaction?`: "default" \| "scrub" = "scrub"
- **eventos**: `update:modelValue` (value: number | null), `focus` (payload: FocusEvent), `blur` (payload: FocusEvent), `increment`, `decrement`

### VOtpInput
A one-time password / verification code input for secure authentication flows.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `length?`: number = 6; `masked?`: boolean = false; `autoSubmit?`: boolean = false; `disabled?`: boolean = false; `errorMessage?`: string; `success?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `separatorIndex?`: number; `helperText?`: string; `resendLabel?`: string = "Resend code"; `resendCooldown?`: number = 0; `ariaLabel?`: string = "Verification code"; `id?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `update:modelValue` (value: string), `complete` (value: string), `resend`, `focus` (payload: FocusEvent), `blur` (payload: FocusEvent)

### VPasswordInput
A secure password field with visibility toggle and strength feedback.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `label?`: string; `helperText?`: string; `errorMessage?`: string; `placeholder?`: string; `disabled?`: boolean = false; `readonly?`: boolean = false; `required?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `showStrength?`: boolean = false; `requirements?`: boolean = false; `name?`: string; `id?`: string; `autocomplete?`: string; `revealLabel?`: string; `maskLabel?`: string
- **eventos**: `update:modelValue` (value: string), `focus` (payload: FocusEvent), `blur` (payload: FocusEvent), `toggle-visibility` (visible: boolean)

### VRadioGroup
Seleção única entre opções mutuamente exclusivas, com layouts vertical, horizontal e card.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `options`: VRadioOption[] = []; `label?`: string; `description?`: string; `errorMessage?`: string; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `layout?`: "vertical" \| "horizontal" \| "card" = "vertical"; `name?`: string; `id?`: string; `required?`: boolean = false; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `update:modelValue` (value: string), `change` (value: string)

### VSearchField
Campo de busca com ícone, clear, atalho ⌘K, sugestões e loading.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `label?`: string; `placeholder?`: string; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "standard" \| "shortcut" \| "command"; `shortcut?`: boolean = false; `shortcutKeys?`: string; `clearable?`: boolean = true; `clearLabel?`: string; `suggestions?`: VSearchFieldSuggestion[] = []; `name?`: string; `id?`: string; `autocomplete?`: string; `ariaLabel?`: string; `inputTestId?`: string; `clearTestId?`: string; `shortcutTestId?`: string; `extraInputAttrs?`: Record<string, unknown>
- **eventos**: `update:modelValue` (value: string), `clear`, `search` (value: string), `select` (suggestion: import('./VSearchField.types').VSearchFieldSuggestion), `focus` (payload: FocusEvent), `blur` (payload: FocusEvent), `shortcut`
- **slots**: `icon`

### VSlider
A slider component for selecting numeric values or ranges.
- **v-model**: sim
- **props**: `modelValue?`: VSliderModelValue = 0; `min?`: number = 0; `max?`: number = 100; `step?`: number = 1; `range?`: boolean = false; `marks?`: number[] \| Record<number, string>; `orientation?`: "vertical" \| "horizontal" = "horizontal"; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `showValue?`: boolean = true; `showTooltip?`: boolean = true; `snapToMarks?`: boolean = false; `ariaLabel?`: string; `id?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `trackBackground?`: string
- **eventos**: `update:modelValue` (value: number | [number, number]), `change` (value: number | [number, number])

### VSwitch
Toggle binário on/off para configurações e preferências, com thumb animado e suporte a label/descrição.
- **v-model**: sim
- **props**: `modelValue?`: boolean = false; `label?`: string; `description?`: string; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `name?`: string; `id?`: string; `showIcon?`: boolean = false; `ariaLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `update:modelValue` (value: boolean), `change` (value: boolean)
- **slots**: `label`

### VTagInput
A component for entering, editing, and removing tags or chips.
- **v-model**: sim
- **props**: `modelValue?`: string[] = []; `suggestions?`: string[] = []; `placeholder?`: string = "Add a tag…"; `ariaLabel?`: string; `disabled?`: boolean = false; `readonly?`: boolean = false; `closable?`: boolean = true; `multiline?`: boolean = false; `maxTags?`: number; `delimiters?`: VTagInputDelimiter[] = ['enter', 'comma']; `allowDuplicates?`: boolean = false; `validateTag?`: ((tag: string) => boolean); `id?`: string; `size?`: "sm" \| "md" \| "lg" = "md"; `emptyText?`: string = "No tags yet."
- **eventos**: `update:modelValue` (value: string[]), `add` (tag: string), `remove` (tag: string), `focus` (payload: FocusEvent), `blur` (payload: FocusEvent)

### VTextarea
Campo multilinha com auto-resize, contador de caracteres, helper e erro.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `label?`: string; `helperText?`: string; `errorMessage?`: string; `placeholder?`: string; `disabled?`: boolean = false; `readonly?`: boolean = false; `required?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `counter?`: number; `autoResize?`: boolean = false; `rows?`: number = undefined; `name?`: string; `id?`: string; `spellcheck?`: boolean; `resize?`: "none" \| "vertical" \| "horizontal" \| "both" = "vertical"
- **eventos**: `update:modelValue` (value: string), `focus` (payload: FocusEvent), `blur` (payload: FocusEvent)

### VTextInput
A flexible single-line text input for forms and search-like data entry.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `label?`: string; `helperText?`: string; `errorMessage?`: string; `successMessage?`: string; `placeholder?`: string; `disabled?`: boolean = false; `readonly?`: boolean = false; `required?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `clearable?`: boolean = false; `clearLabel?`: string; `leadingIcon?`: string; `prefix?`: string; `suffix?`: string; `name?`: string; `id?`: string; `autocomplete?`: string; `type?`: "text" \| "email" \| "url" \| "search" \| "tel" = "text"; `spellcheck?`: boolean; `autocapitalize?`: "none" \| "off" \| "on" \| "sentences" \| "words" \| "characters"
- **eventos**: `update:modelValue` (value: string), `clear`, `focus` (payload: FocusEvent), `blur` (payload: FocusEvent)
- **slots**: `leading-icon`

## Seleção e menus

### VColorPicker
A color selection component for themes, branding, and creative tools.
- **v-model**: sim
- **props**: `modelValue?`: string = "#6366F1"; `variant?`: "inline" \| "popover" \| "hex" \| "opacity" \| "preset" = "popover"; `size?`: "sm" \| "md" \| "lg" = "md"; `disabled?`: boolean = false; `showAlpha?`: boolean = false; `presets?`: string[]; `recentColors?`: string[]; `label?`: string; `inlineSwatches?`: string[]; `selected?`: boolean
- **eventos**: `update:modelValue` (value: string), `change` (value: string), `open-change` (value: boolean)

### VDatePicker
Date picker flexível para data única ou intervalo, com calendário acessível e presets.
- **v-model**: sim
- **props**: `modelValue?`: Date \| null = null; `range?`: boolean = false; `rangeValue?`: { start: Date \| null; end: Date \| null; }; `variant?`: "default" \| "with-icon" \| "with-preset" \| "range" = "default"; `size?`: "sm" \| "md" \| "lg" = "md"; `disabled?`: boolean = false; `placeholder?`: string; `label?`: string; `format?`: string; `showToday?`: boolean = true; `showLeadingIcon?`: boolean; `clearable?`: boolean = true; `min?`: Date; `max?`: Date; `disabledDates?`: Date[]; `eventDates?`: Date[]; `preset?`: string; `presets?`: VDatePickerPreset[]
- **eventos**: `update:modelValue` (value: Date | null), `update:rangeValue` (value: { start: Date | null; end: Date | null }), `change` (value: Date | null), `open-change` (value: boolean)

### VDateRangePicker
A start-and-end date selection component for reporting, booking, and filtering workflows.
- **v-model**: sim
- **props**: `modelValue?`: VDateRangeValue \| null = null; `variant?`: "default" \| "compact" \| "inline" \| "presets" \| "with-time" = "default"; `size?`: "sm" \| "md" \| "lg" = "md"; `disabled?`: boolean = false; `placeholder?`: string; `label?`: string; `format?`: string; `compactFormat?`: string; `enableTime?`: boolean; `presets?`: VDateRangePickerPreset[]; `min?`: Date; `max?`: Date; `disabledDates?`: Date[]
- **eventos**: `update:modelValue` (value: import('./VDateRangePicker.types').VDateRangeValue | null), `change` (value: import('./VDateRangePicker.types').VDateRangeValue | null), `open-change` (value: boolean), `apply` (value: import('./VDateRangePicker.types').VDateRangeValue | null), `cancel`

### 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.
- **v-model**: sim
- **props**: `modelValue?`: boolean; `value?`: string; `label?`: string; `icon?`: string; `showTriggerIcon?`: boolean = true; `showChevron?`: boolean = true; `items?`: VDropdownMenuItem[]; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" \| "destructive" \| "secondary" \| "ghost" = "secondary"; `triggerStyle?`: "default" \| "icon" \| "field"; `menuAlign?`: "start" \| "end"; `ariaLabel?`: string; `teleport?`: boolean = true
- **eventos**: `update:modelValue` (value: boolean), `update:value` (value: string), `open-change` (value: boolean), `select` (value: string)
- **slots**: `trigger`, `default`

### VMenuBar
Componente VueUI Nova para **menu bar**, seguindo tokens semânticos e Light Mode como referência principal.
- **props**: `items?`: VMenuBarMenu[]; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" = "default"; `ariaLabel?`: string; `openOnHover?`: boolean = false; `hoverDelay?`: number = 150
- **eventos**: `select` (value: string), `open-change` (value: string | null)
- **slots**: `default`

### VSegmentedControl
Controle segmentado inline de escolha única entre opções relacionadas — alternativa compacta a tabs para trocar views, períodos ou ordenação.
- **v-model**: sim
- **props**: `modelValue?`: string; `options?`: VSegmentedControlOption[]; `disabled?`: boolean = false; `fullWidth?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "pill" = "default"; `ariaLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `update:modelValue` (value: string)

### VSelect
Campo de seleção single-choice com label, placeholder, ícone opcional, validação e menu suspenso acessível.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `options?`: VSelectOption[]; `label?`: string; `placeholder?`: string = "Select option"; `disabled?`: boolean = false; `errorMessage?`: string; `leadingIcon?`: string; `size?`: "sm" \| "md" \| "lg" = "md"; `clearable?`: boolean; `clearValue?`: string; `id?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `teleport?`: boolean = true
- **eventos**: `update:modelValue` (value: string), `open-change` (value: boolean), `change` (value: string), `clear`
- **slots**: `leading-icon`

### VTimeRange
Barra compacta de intervalo de horário `12:00 → 12:30 · 30min`, usando `<input type="time">` nativo (teclado e leitores de tela inclusos).
- **props**: `start?`: string = "09:00"; `end?`: string = "10:00"; `step?`: number = 5; `showDuration?`: boolean = true; `closable?`: boolean = true; `disabled?`: boolean = false; `size?`: "sm" \| "md" = "md"; `startLabel?`: string = "Start time"; `endLabel?`: string = "End time"; `dataTestId?`: string
- **eventos**: `update:start` (value: string), `update:end` (value: string), `change` (range: { start: string; end: string; minutes: number }), `close`

## Navegação

### VBottomUtilityBar
Componente VueUI Nova para **bottom utility bar**, seguindo tokens semânticos e Light Mode como referência principal.
- **props**: `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" = "default"; `fixed?`: boolean = true; `safeArea?`: boolean = true; `bordered?`: boolean = true; `ariaLabel?`: string
- **slots**: `status`, `default`, `actions`

### VBreadcrumb
Trilha de navegação hierárquica que mostra onde o usuário está e permite voltar rapidamente aos níveis anteriores.
- **props**: `items?`: VBreadcrumbItem[]; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "compact" \| "icons" \| "overflow" = "default"; `maxItems?`: number = 4; `ariaLabel?`: string
- **eventos**: `navigate` (payload: { item: { label: string; href?: string; originalIndex: number }; index: number })
- **slots**: `separator`

### VCommandItem
Componente VueUI Nova para **command item**, seguindo tokens semânticos e Light Mode como referência principal.
- **props**: `id?`: string; `label?`: string; `icon?`: string; `shortcut?`: string; `selected?`: boolean = false; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" = "default"; `ariaLabel?`: string; `dataTestId?`: string; `domId?`: string
- **eventos**: `click` (event: MouseEvent), `select` (payload: { id?: string; label?: string })
- **slots**: `icon`, `default`

### VCommandPalette
Superfície universal de busca de comandos: encontrar conteúdo, executar ações e navegar pelo app a partir de um único lugar.
- **v-model**: sim
- **props**: `modelValue?`: boolean = undefined; `open?`: boolean = undefined; `query?`: string = undefined; `placeholder?`: string = undefined; `items?`: VCommandPaletteGroup[] = undefined; `loading?`: boolean = false; `disabled?`: boolean = false; `dismissible?`: boolean = true; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "global-search" \| "quick-actions" \| "file-switcher" \| "settings-palette" = "global-search"; `shortcutLabel?`: string = "⌘K"; `emptyTitle?`: string = "No results found"; `emptyHint?`: string = "Try a different search term."; `searchLabel?`: string = "Search commands"; `ariaLabel?`: string = undefined
- **eventos**: `update:modelValue` (value: boolean), `update:open` (value: boolean), `update:query` (value: string), `open-change` (value: boolean), `select` (item: VCommandPaletteItem), `close`, `dismiss`
- **slots**: `trigger`

### VNavItem
Componente VueUI Nova para **nav item**, seguindo tokens semânticos e Light Mode como referência principal.
- **props**: `label?`: string; `value?`: string \| number; `href?`: string; `icon?`: string; `badge?`: string \| number; `badgeTone?`: "default" \| "primary"; `tag?`: string; `iconColor?`: string; `ariaControls?`: string; `active?`: boolean = false; `disabled?`: boolean = false; `loading?`: boolean = false; `collapsed?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" \| "soft" \| "raised" = "default"; `ariaLabel?`: string; `dataTestId?`: string; `expandable?`: boolean; `expanded?`: boolean
- **eventos**: `click` (event: MouseEvent), `select` (payload: { value?: string | number; href?: string }), `keydown` (event: KeyboardEvent)
- **slots**: `icon`, `default`, `trailing`

### VPagination
Controle de navegação página a página.
- **v-model**: sim
- **props**: `modelValue?`: number; `total?`: number = 0; `pageSize?`: number = 10; `pageCount?`: number; `siblingCount?`: number; `boundaryCount?`: number; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "compact" \| "ellipsis" = "default"; `showPageSize?`: boolean = false; `showResultCount?`: boolean = false; `pageSizeOptions?`: number[]; `prevLabel?`: string; `nextLabel?`: string; `pageSizeLabel?`: string; `ariaLabel?`: string
- **eventos**: `update:modelValue` (page: number), `update:page` (page: number), `update:pageSize` (size: number)

### 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.
- **v-model**: sim
- **props**: `collapsed?`: boolean; `modelValue?`: boolean; `items?`: VSidebarItem[]; `activeItem?`: string; `expandedSections?`: string[]; `accordion?`: boolean = true; `accordionGroups?`: boolean = false; `filterOnSearch?`: boolean = true; `brandName?`: string = "VueUI Nova"; `brandIcon?`: string; `searchPlaceholder?`: string = "Search…"; `showSearch?`: boolean = true; `searchShortcut?`: string = "⌘K"; `userName?`: string = "Alex Chen"; `userEmail?`: string = "alex@nova.dev"; `userAvatar?`: string = "AC"; `heading?`: string = ""; `position?`: string = ""; `locked?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `width?`: string \| number; `groupChevron?`: "start" \| "end" = "end"; `groupChevronOpen?`: "up" \| "down" = "down"; `chevron?`: "rotate" \| "updown" = "rotate"; `groupDividers?`: boolean = false; `variant?`: "default" \| "floating" \| "card" \| "icons" \| "workspace" = "default"; `showBrand?`: boolean = true; `showFooter?`: boolean = true; `showCollapseToggle?`: boolean = true; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:collapsed` (value: boolean), `update:modelValue` (value: boolean), `update:locked` (value: boolean), `update:activeItem` (value: string), `update:expandedSections` (value: string[]), `select` (value: string), `section-toggle` (value: string, expanded: boolean), `search` (query: string)
- **slots**: `header`, `before-nav`, `after-nav`, `footer`

### VStepper
Componente VueUI Nova para **stepper**, seguindo tokens semânticos e Light Mode como referência principal.
- **v-model**: sim
- **props**: `modelValue?`: string \| number; `steps?`: VStepperStep[]; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" = "default"; `ariaLabel?`: string
- **eventos**: `update:modelValue` (value: string | number), `step-click` (step: VStepperStep)

### VTabs
Contextual content navigation
- **v-model**: sim
- **props**: `modelValue?`: string; `items?`: VTabItem[]; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "pill" \| "icon" \| "underline" = "underline"; `dividers?`: boolean = false; `panels?`: boolean = true; `ariaLabel?`: string
- **eventos**: `update:modelValue` (value: string)
- **slots**: `actions`, `default`

### VTopBar
Chrome global do app: logo, navegação principal e ações globais no topo da aplicação.
- **props**: `title?`: string; `disabled?`: boolean = false; `loading?`: boolean = false; `bordered?`: boolean = true; `sticky?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" \| "app" = "default"; `items?`: VTopBarItem[] = []; `activeItem?`: string; `ariaLabel?`: string
- **eventos**: `select` (value: string), `update:activeItem` (value: string)
- **slots**: `leading`, `default`, `actions`

### VTreeNavigation
Explorador hierárquico expansível para file systems, settings, documentação e qualquer conteúdo nested.
- **props**: `active?`: string \| string[]; `expandedKeys?`: string[]; `items?`: VTreeNavigationItem[]; `multiple?`: boolean = false; `showCounts?`: boolean = true; `iconField?`: string = "icon"; `lazy?`: boolean = false; `loadChildren?`: ((node: VTreeNavigationItem) => Promise<VTreeNavigationItem[]>); `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "primary" \| "subtle" \| "settings" \| "file" \| "documentation" \| "simple" = "file"; `ariaLabel?`: string
- **eventos**: `update:active` (value: string | string[]), `update:expandedKeys` (value: string[]), `select` (value: string | string[])
- **slots**: `default`

## Layout e grids

### VAppShell
`VAppShell` é o **core application layout**: shell de aplicação com top bar, navegação lateral e painel utilitário.
- **props**: `variant?`: "dashboard" \| "editor" \| "settings" \| "content-management" = "dashboard"; `layoutMode?`: "compact" \| "desktop" \| "tablet" = "desktop"; `sidebarCollapsed?`: boolean = false; `utilityOpen?`: boolean = true; `brandName?`: string; `searchPlaceholder?`: string; `searchShortcut?`: string; `searchQuery?`: string; `activeNavItem?`: string; `navItems?`: VAppShellNavItem[]; `quickActions?`: VAppShellQuickAction[]; `shortcuts?`: VAppShellShortcut[]; `userAvatar?`: string; `showUtility?`: boolean = true; `showBuiltInTopBar?`: boolean = true
- **eventos**: `update:sidebarCollapsed` (collapsed: boolean), `update:utilityOpen` (open: boolean), `update:searchQuery` (query: string), `update:activeNavItem` (value: string), `nav` (value: string), `search` (query: string), `quick-action` (name: string), `shortcut` (keys: string)
- **slots**: `topbar`, `sidebar`, `default`, `utility`

### VAutoLayoutGrid
A flexible auto-flow layout grid for arranging responsive cards and content blocks.
- **props**: `minItemWidth?`: number = 280; `gap?`: number; `rowGap?`: number; `columnGap?`: number; `behavior?`: "auto-fit" \| "auto-fill" \| "dense" \| "equal-height" = "auto-fit"; `size?`: "compact" \| "medium" \| "spacious" = "medium"; `selectable?`: boolean = false; `ariaLabel?`: string
- **slots**: `default`, `drop-preview`

### VAutoLayoutGridItem (filho de VAutoLayoutGrid)
Célula da VAutoLayoutGrid.
- **props**: `id?`: string; `selected?`: boolean = false; `disabled?`: boolean = false; `dragging?`: boolean = false; `interactive?`: boolean = true; `colSpan?`: number; `rowSpan?`: number
- **eventos**: `click` (event: MouseEvent | KeyboardEvent), `select` (selected: boolean)
- **slots**: `default`

### VCanvasGrid
Workspace infinito com grade de encaixe, pan, zoom e minimapa para editores e construtores visuais.
- **props**: `objects?`: VSnapObject[]; `variant?`: "dots" \| "dense" \| "lines" \| "presentation" = "lines"; `size?`: "default" \| "compact" \| "wide" = "default"; `gridSize?`: number; `snap?`: boolean = true; `showControls?`: boolean = true; `showMinimap?`: boolean = true; `showToolbar?`: boolean = true; `zoom?`: number; `minZoom?`: number = 0.25; `maxZoom?`: number = 4; `pan?`: VCanvasGridPan; `selected?`: string \| null = null; `height?`: number = 360; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:objects` (objects: VCanvasGridObject[]), `update:selected` (id: string | null), `update:zoom` (zoom: number), `update:pan` (pan: VCanvasGridPan), `comment` (payload: { id: string }), `change` (payload: { object: VCanvasGridObject; kind: 'move' | 'resize' | 'nudge' | 'duplicate' | 'delete' })
- **slots**: `object`

### VCardGrid
`VCardGrid` organiza cards em uma grade CSS.
- **props**: `cols?`: VGridCols = 3; `minCardWidth?`: number; `gap?`: number = 6; `ariaLabel?`: string

### VDashboardColumn
Coluna do dashboard que empilha widgets, com cabeçalho, recolhimento, redimensionamento e zona de largada.
- **props**: `title?`: string; `icon?`: IconifyIcon; `variant?`: "collapsible" \| "fixed" \| "fluid" \| "sticky" = "fixed"; `size?`: "wide" \| "medium" \| "narrow" = "medium"; `width?`: number; `minWidth?`: number = 200; `maxWidth?`: number = 560; `resizable?`: boolean = false; `collapsed?`: boolean = false; `stickyTop?`: number = 0; `draggable?`: boolean = false; `menu?`: boolean = false; `droppable?`: boolean = false; `dropTarget?`: boolean = false; `dropLabel?`: string = "Solte o widget aqui"; `addLabel?`: string = "Adicionar widget"; `selected?`: boolean = false; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:collapsed` (collapsed: boolean), `update:width` (width: number), `drop` (event: DragEvent), `add`, `menu` (event: MouseEvent)
- **slots**: `header`, `header-actions`, `default`, `footer`

### VDashboardRow
Fileira do dashboard que alinha, distribui e espaça seções na horizontal, com quebra responsiva.
- **props**: `variant?`: "standard" \| "dense" \| "split" \| "wrap" = "standard"; `gap?`: "compact" \| "medium" \| "spacious"; `align?`: "start" \| "end" \| "center" \| "stretch" \| "baseline"; `justify?`: "start" \| "end" \| "center" \| "between" \| "around" \| "evenly"; `wrap?`: boolean = false; `divider?`: boolean = false; `title?`: string; `subtitle?`: string; `as?`: "div" \| "section" = "div"; `selectable?`: boolean = false; `selected?`: boolean = false; `dropTarget?`: boolean = false; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:selected` (selected: boolean)
- **slots**: `title`, `default`, `actions`

### VDashboardWidget (filho de VDashboardWidgetGrid)
Widget de uma VDashboardWidgetGrid.
- **props**: `id?`: string; `title?`: string; `x?`: number = 0; `y?`: number = 0; `w?`: number = 2; `h?`: number = 2; `locked?`: boolean = false; `disabled?`: boolean = false; `focused?`: boolean = false; `closable?`: boolean = true
- **eventos**: `close`, `move` (payload: { x: number; y: number }), `resize` (payload: { w: number; h: number })
- **slots**: `header-actions`, `default`

### VDashboardWidgetGrid
A flexible layout grid for dashboard widgets with drag, resize, and responsive placement.
- **props**: `cols?`: VGridCols = 12; `rowHeight?`: number = 128; `gap?`: number = 4; `variant?`: "compact" \| "freeform" \| "analytics" \| "editorial" = "freeform"; `editMode?`: boolean = false; `layout?`: VDashboardWidgetLayoutItem[]; `addLabel?`: string = "+ Add widget"; `hideToolbar?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:layout` (layout: VDashboardWidgetLayoutItem[]), `update:editMode` (editMode: boolean), `add`
- **slots**: `toolbar`, `default`

### 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.
- **props**: `cols?`: VGridCols = 3; `gap?`: number = 6; `variant?`: "default" \| "image-first" \| "content-first" \| "mixed-media" \| "magazine" = "default"; `loading?`: boolean = false; `empty?`: boolean = false; `ariaLabel?`: string
- **slots**: `default`

### VMasonryItem (filho de VMasonryGrid)
Tile de uma VMasonryGrid: mídia, título, categoria e metadados numa célula de altura variável.
- **props**: `id?`: string; `title?`: string; `category?`: string; `selected?`: boolean = false; `interactive?`: boolean = true; `likes?`: number
- **eventos**: `click` (event: MouseEvent | KeyboardEvent), `select` (selected: boolean)
- **slots**: `media`, `meta`, `default`

### VResizablePanel
A flexible, accessible, and performant resizable panel for modern layouts.
- **props**: `size?`: VResizablePanelSize = "md"; `orientation?`: "vertical" \| "horizontal" = undefined; `min?`: number = 0; `max?`: number = 1200; `collapsible?`: boolean = false; `variant?`: "bottom" \| "left" \| "right" \| "collapsible" = undefined; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:size` (size: number), `resize` (size: number), `collapse`, `expand`
- **slots**: `default`

### VSnapGrid
Canvas de construção com grade de encaixe, guias de alinhamento e réguas para editores e builders.
- **props**: `objects?`: VSnapObject[]; `variant?`: "subtle" \| "visible" \| "magnetic" \| "rulers" = "visible"; `size?`: "medium" \| "fine" \| "coarse" = "medium"; `gridSize?`: number; `snap?`: boolean = true; `snapToObjects?`: boolean = true; `showGuides?`: boolean = true; `showRulers?`: boolean = false; `hideGrid?`: boolean = false; `threshold?`: number = 6; `height?`: number = 320; `selected?`: string \| null = null; `disabled?`: boolean = false; `ariaLabel?`: string = "Canvas com grade de encaixe"
- **eventos**: `update:objects` (objects: VSnapGridObject[]), `update:selected` (id: string | null), `move` (payload: { id: string; x: number; y: number }), `resize` (payload: { id: string; w: number; h: number })
- **slots**: `object`

### 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.
- **props**: `sizes?`: VSplitViewSizeValue[]; `orientation?`: "vertical" \| "horizontal" = "vertical"; `mode?`: "collapsible" \| "fixed" \| "resizable" = "resizable"; `collapsible?`: boolean; `persistKey?`: string; `defaultSize?`: string \| number = 280; `minSize?`: string \| number = 200; `maxSize?`: string \| number = 600; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:sizes` (sizes: VSplitViewSizeValue[]), `resize` (sizes: VSplitViewSizeValue[]), `collapse` (index: number), `expand` (index: number)
- **slots**: `pane-1`, `start`, `pane-2`, `default`, `pane-3`, `end`, `[`pane-${index}`]`

### VThumbnailGrid
Grade responsiva de miniaturas para mídia, arquivos e galerias, com seleção e ações rápidas.
- **v-model**: sim
- **props**: `items?`: VThumbnailItem[]; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "compact" \| "files" \| "gallery" \| "selectable" = "gallery"; `selection?`: "none" \| "single" \| "multiple"; `modelValue?`: string[]; `actions?`: boolean = false; `emptyLabel?`: string = "Nenhum arquivo por aqui."; `ariaLabel?`: string
- **eventos**: `update:modelValue` (ids: string[]), `open` (item: VThumbnailItem), `action` (payload: { item: VThumbnailItem; action: VThumbnailAction })
- **slots**: `preview`, `empty`

### VWidgetCell
Célula de dashboard para KPIs, gráficos, listas e chamadas, com cabeçalho, rodapé e estados.
- **props**: `title?`: string; `subtitle?`: string; `icon?`: IconifyIcon; `variant?`: "chart" \| "stat" \| "list" \| "action" \| "placeholder" = "stat"; `size?`: "wide" \| "medium" \| "small" \| "large" = "medium"; `stretch?`: boolean = false; `value?`: string \| number; `delta?`: string \| number; `trend?`: "neutral" \| "up" \| "down"; `deltaCaption?`: string; `items?`: VWidgetCellListItem[]; `description?`: string; `actionLabel?`: string; `footerLabel?`: string; `footerHref?`: string; `updatedLabel?`: string; `draggable?`: boolean = false; `menu?`: boolean = false; `closable?`: boolean = false; `selectable?`: boolean = false; `selected?`: boolean = false; `loading?`: boolean = false; `disabled?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:selected` (selected: boolean), `menu` (event: MouseEvent), `close`, `action`, `add`, `footer`
- **slots**: `header`, `actions`, `default`, `footer`

## Superfícies

### VAccordion
Progressive disclosure for FAQs, settings panels, and any content that benefits from a clear, compact hierarchy.
- **v-model**: sim
- **props**: `modelValue?`: VAccordionModelValue; `multiple?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "bordered" \| "divided" \| "leading-icon" = "default"; `ariaLabel?`: string; `attached?`: boolean = false; `disabled?`: boolean = false
- **eventos**: `update:modelValue` (value: VAccordionModelValue), `open-change` (value: VAccordionModelValue)
- **slots**: `default`

### VAccordionItem (filho de VAccordion)
Item de um VAccordion: o gatilho mostra o título e o slot default é o corpo que se expande.
- **props**: `id?`: string; `value?`: VAccordionValue; `title?`: string; `ariaLabel?`: string; `disabled?`: boolean
- **slots**: `icon`, `title`, `default`

### VCard
Flexible content container
- **props**: `title?`: string; `description?`: string; `badge?`: string; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "elevated" \| "outlined" \| "filled" \| "interactive" = "elevated"; `loading?`: boolean = false; `interactive?`: boolean = false; `selected?`: boolean = false; `mediaPlacement?`: "top" \| "start" \| "end" \| "bottom" = "top"; `refineFrame?`: "queued" \| "generating" \| "refining" \| "complete"; `ariaLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `click` (event: MouseEvent | KeyboardEvent)
- **slots**: `front`, `media`, `refine-media`, `media-overlay`, `badge`, `icon`, `title`, `header-trailing`, `description`, `default`, `back`, `avatar-group`, `actions`, `footer`, `caption`

### VInspectorPanel
A flexible side panel for inspecting and editing content, properties, and settings.
- **v-model**: sim
- **props**: `open?`: boolean = undefined; `modelValue?`: boolean = undefined; `title?`: string = "Inspector"; `tabs?`: VInspectorPanelTab[]; `activeTab?`: string; `sections?`: VInspectorPanelSection[]; `expandedSections?`: string[]; `size?`: "default" \| "compact" \| "wide" = "default"; `variant?`: "default" \| "minimal" \| "tabs" \| "floating" = "default"; `showClose?`: boolean = true; `dismissible?`: boolean = true; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:open` (value: boolean), `update:modelValue` (value: boolean), `update:activeTab` (value: string), `update:expandedSections` (value: string[]), `open-change` (value: boolean), `tab-change` (value: string), `section-toggle` (value: string, expanded: boolean), `close`, `dismiss`
- **slots**: `header`, `actions`, `[vm.activeTab.value]`, `[section.value]`, `default`

### VPanel
O `VPanel` é um contentor flexível para agrupar conteúdo relacionado — informação, ações e media — em secções claras e autocontidas.
- **v-model**: sim
- **props**: `title?`: string; `description?`: string; `icon?`: string; `headingLevel?`: "2" \| "3" = "3"; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "elevated" \| "filled" \| "default" \| "bordered" = "default"; `open?`: boolean = undefined; `modelValue?`: boolean = undefined; `interactive?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:open` (value: boolean), `update:modelValue` (value: boolean), `click` (event: MouseEvent | KeyboardEvent)
- **slots**: `icon`, `title`, `description`, `header`, `actions`, `default`, `footer`

### VSection
A flexible container for organizing related content into a clear, structured section.
- **props**: `title?`: string; `description?`: string; `icon?`: string; `headingLevel?`: "2" \| "3" = "2"; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "elevated" \| "default" \| "bordered" \| "borderless" \| "tinted" = "default"; `ariaLabel?`: string
- **slots**: `icon`, `title`, `description`, `header`, `actions`, `default`, `footer`

### 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.
- **v-model**: sim
- **props**: `title?`: string; `modelValue?`: boolean = undefined; `open?`: boolean = undefined; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "minimal" \| "borderless" \| "modal" = "default"; `active?`: boolean = undefined; `disabled?`: boolean = false; `loading?`: boolean = false; `resizable?`: boolean = false; `showActions?`: boolean = true; `showTrafficLights?`: boolean = undefined; `showAppIcon?`: boolean = undefined; `showMinimize?`: boolean = undefined; `showSidebar?`: boolean = undefined; `width?`: string \| number; `height?`: string \| number; `ariaLabel?`: string
- **eventos**: `update:modelValue` (value: boolean), `close`, `minimize`, `maximize`, `resize` (direction: string)
- **slots**: `icon`, `title`, `sidebar`, `default`

## Overlays

### VContextMenu
Componente VueUI Nova para **context menu**, seguindo tokens semânticos e Light Mode como referência principal.
- **v-model**: sim
- **props**: `modelValue?`: boolean; `x?`: number; `y?`: number; `items?`: VDropdownMenuItem[]; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `ariaLabel?`: string
- **eventos**: `update:modelValue` (value: boolean), `update:x` (value: number), `update:y` (value: number), `open-change` (value: boolean), `select` (value: string)
- **slots**: `default`, `menu`

### VDialog
Superfície modal temporária para informação crítica, decisões e tarefas focadas.
- **v-model**: sim
- **props**: `modelValue?`: boolean = undefined; `open?`: boolean = undefined; `title?`: string = undefined; `description?`: string = undefined; `showClose?`: boolean = true; `dismissible?`: boolean = true; `persistent?`: boolean = false; `disabled?`: boolean = false; `loading?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "basic" \| "confirmation" \| "alert" \| "form" \| "fullscreen" = "basic"; `intent?`: "neutral" \| "success" \| "destructive" = "neutral"; `cancelText?`: string = "Cancel"; `confirmText?`: string = "Confirm"; `ariaLabel?`: string = undefined; `ariaDescribedby?`: string = undefined; `closeLabel?`: string = "Close dialog"
- **eventos**: `update:modelValue` (value: boolean), `update:open` (value: boolean), `open-change` (value: boolean), `close`, `dismiss`, `confirm` (event: MouseEvent), `cancel`
- **slots**: `header`, `icon`, `title`, `description`, `default`, `footer`, `actions`

### VDrawer
Painel contextual slide-in que revela detalhes e ações sem tirar o usuário da página atual.
- **v-model**: sim
- **props**: `modelValue?`: boolean = undefined; `open?`: boolean = undefined; `title?`: string = undefined; `placement?`: "top" \| "bottom" \| "left" \| "right" = "right"; `side?`: "top" \| "bottom" \| "left" \| "right"; `size?`: "sm" \| "md" \| "lg" = "md"; `width?`: "sm" \| "md" \| "lg"; `showClose?`: boolean = true; `dismissible?`: boolean = true; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string = undefined; `ariaDescribedby?`: string = undefined; `closeLabel?`: string = "Close drawer"; `variant?`: "default" \| "primary" \| "subtle"
- **eventos**: `update:modelValue` (value: boolean), `update:open` (value: boolean), `open-change` (value: boolean), `close`, `dismiss`
- **slots**: `tabs`, `actions`, `default`, `footer`

### VPopover
Superfície flutuante contextual ancorada a um trigger — informação rápida, ações ou formulários sem sair da página.
- **v-model**: sim
- **props**: `open?`: boolean; `modelValue?`: boolean; `disabled?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `placement?`: "top" \| "bottom" \| "left" \| "right" = "bottom"; `trigger?`: "click" \| "hover" \| "focus" = "click"; `closable?`: boolean = true; `showArrow?`: boolean = true; `title?`: string; `ariaLabel?`: string; `ariaLabelledby?`: string; `ariaDescribedby?`: string
- **eventos**: `update:open` (value: boolean), `update:modelValue` (value: boolean), `open-change` (value: boolean), `close` (reason: VPopoverCloseReason), `dismiss` (reason: Exclude<VPopoverCloseReason, 'close'>)
- **slots**: `trigger`, `header`, `default`, `footer`, `actions`

### VSheet
Superfície edge-attached que desliza da borda para tarefas focadas (settings, details, creation flows), sem tirar o usuário do contexto.
- **v-model**: sim
- **props**: `open?`: boolean = undefined; `modelValue?`: boolean = undefined; `side?`: "top" \| "bottom" \| "left" \| "right" = "right"; `size?`: "sm" \| "md" \| "lg" \| "xl" = "md"; `fullHeight?`: boolean = false; `title?`: string = undefined; `description?`: string = undefined; `showClose?`: boolean = true; `closeLabel?`: string = "Close sheet"; `dismissible?`: boolean = true; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string = undefined; `ariaDescribedby?`: string = undefined; `rootClass?`: string = undefined; `surfaceClass?`: string = undefined; `testIds?`: VSheetTestIds = undefined; `rootDataAttrs?`: Record<string, string \| undefined> = undefined
- **eventos**: `update:open` (value: boolean), `update:modelValue` (value: boolean), `open-change` (value: boolean), `close`, `dismiss`
- **slots**: `title`, `header`, `description`, `actions`, `close`, `prepend`, `default`, `footer`

### VTooltip
Dica contextual (contextual helper hint) que exibe informação breve e contextual ao dar hover, focus ou tap num elemento.
- **props**: `content?`: string; `placement?`: "top" \| "bottom" \| "left" \| "right" = "top"; `size?`: "sm" \| "md" \| "lg" \| "xl" = "md"; `variant?`: "default" \| "success" \| "error" \| "with-icon" \| "brand" \| "light" = "default"; `disabled?`: boolean = false; `showArrow?`: boolean = true; `hideDelay?`: number = 500; `ariaLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `warmGroup?`: string; `open?`: boolean = undefined
- **slots**: `default`, `icon`, `content`

## Feedback e status

### 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.
- **v-model**: sim
- **props**: `modelValue?`: boolean = undefined; `title?`: string; `description?`: string; `disabled?`: boolean = false; `loading?`: boolean = false; `dismissible?`: boolean = false; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "neutral" \| "warning" \| "danger" \| "success" \| "info" = "info"; `ariaLabel?`: string; `dismissLabel?`: string
- **eventos**: `dismiss`, `update:modelValue` (value: boolean)
- **slots**: `icon`, `title`, `description`, `default`, `action`

### VBanner
A flexible banner component for important messages, alerts, and contextual information.
- **v-model**: sim
- **props**: `modelValue?`: boolean = null as unknown as boolean; `title?`: string; `description?`: string; `variant?`: "neutral" \| "warning" \| "success" \| "error" \| "info" = "info"; `size?`: "sm" \| "md" \| "lg" = "md"; `closable?`: boolean = false; `closeOnEscape?`: boolean = true; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string; `dismissLabel?`: string = "Dismiss banner"; `dismissedText?`: string = "Banner dismissed"
- **eventos**: `update:modelValue` (value: boolean), `close`
- **slots**: `icon`, `title`, `description`, `default`, `action`

### VEmptyState
A flexible empty state component for when there's nothing to show.
- **props**: `title?`: string; `description?`: string; `action?`: VEmptyStateAction; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "results" \| "files" \| "notifications" \| "create" = "default"; `compact?`: boolean = false; `showIllustration?`: boolean = true; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string; `headingLevel?`: 2 \| 3 \| 4 = 2
- **eventos**: `action`
- **slots**: `illustration`, `icon`, `title`, `description`, `action`

### VNotificationCenter
A flexible notification center for in-app messages, alerts, and updates.
- **v-model**: sim
- **props**: `modelValue?`: boolean; `notifications?`: VNotificationCenterItem[] = []; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "default" \| "compact" \| "feed" \| "grouped" \| "drawer" = "default"; `placement?`: "bottom-end" \| "bottom-start" \| "top-end" \| "top-start" = "bottom-end"; `activeTab?`: "all" \| "unread" \| "mentions" \| "updates" = "all"; `searchQuery?`: string = ""; `disabled?`: boolean = false; `loading?`: boolean = false; `ariaLabel?`: string; `triggerLabel?`: string; `headerTitle?`: string; `markAllLabel?`: string; `viewAllLabel?`: string; `emptyLabel?`: string; `closeLabel?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `expressiveLabel?`: string
- **eventos**: `update:modelValue` (value: boolean), `mark-all-read`, `view-all`, `item-click` (id: string), `update:activeTab` (value: VNotificationCenterTab), `update:searchQuery` (value: string)

### VNotificationItem
A flexible notification item for messages, activity, and system alerts.
- **props**: `avatar?`: string; `avatarAlt?`: string; `title?`: string; `preview?`: string; `time?`: string; `unread?`: boolean = false; `variant?`: "default" \| "success" \| "avatar" \| "system" \| "actionable" = "default"; `size?`: "sm" \| "md" \| "lg" = "md"; `disabled?`: boolean = false; `loading?`: boolean = false; `dismissible?`: boolean = false; `showMenu?`: boolean = true; `actions?`: VNotificationItemAction[]; `ariaLabel?`: string; `dismissLabel?`: string = "Dismiss notification"; `menuLabel?`: string = "Notification options"
- **eventos**: `click`, `dismiss`, `menu`, `action` (key: string), `update:unread` (value: boolean)
- **slots**: `avatar`, `title`, `time`, `preview`, `actions`

### VProgress
Indicador de progresso linear e circular que comunica claramente o status de conclusão de uma tarefa ou processo.
- **props**: `variant?`: "linear" \| "circular" = "linear"; `size?`: "sm" \| "md" \| "lg" = "md"; `value?`: number = 0; `state?`: "success" \| "error" \| "determinate" \| "indeterminate" = "determinate"; `label?`: string \| boolean = true; `ariaLabel?`: string; `ariaValuetext?`: string; `dataTestId?`: string

### VSkeleton
A flexible loading placeholder for content that's on its way.
- **props**: `variant?`: "avatar" \| "text" \| "card" \| "table-row" \| "chart" = "text"; `size?`: "sm" \| "md" \| "lg" \| "xs" = "md"; `lines?`: number = 3; `animated?`: boolean = true; `paused?`: boolean = false; `disabled?`: boolean = false; `ariaLabel?`: string
- **slots**: `default`

### VSpinner
A flexible loading indicator for communicating progress and waiting states.
- **props**: `variant?`: "inline" \| "circular" \| "dots" \| "ring" \| "lattice" = "circular"; `color?`: "default" \| "primary" = "primary"; `inheritColor?`: boolean = false; `size?`: "sm" \| "md" \| "lg" \| "xl" \| "xs" = "md"; `label?`: string = "Loading"; `decorative?`: boolean = false; `ariaLabel?`: string; `disabled?`: boolean = false; `loading?`: boolean = true; `paused?`: boolean = false; `latticeSize?`: 3 \| 4 = 3; `verb?`: string; `resolved?`: "success" \| "error" = null
- **slots**: `default`

### VStatusMark
Marcador compacto de status de uma tarefa/execução (ocioso, em andamento, sucesso, erro) com `role="status"`.
- **props**: `state?`: "success" \| "error" \| "idle" \| "running" = "idle"; `size?`: "sm" \| "md" \| "lg" = "md"; `label?`: string; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")

### 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.
- **v-model**: sim
- **props**: `message?`: string; `variant?`: "warning" \| "success" \| "error" \| "info" \| "loading" = "info"; `size?`: "sm" \| "md" \| "lg" = "md"; `duration?`: number = 5000; `closable?`: boolean = true; `showProgress?`: boolean = true; `loading?`: boolean = false; `disabled?`: boolean = false; `dismissLabel?`: string; `ariaLabel?`: string; `modelValue?`: boolean = true; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive")
- **eventos**: `update:modelValue` (value: boolean), `close`
- **slots**: `icon`, `default`

### VToastStack (filho de VToast)
Pilha de toasts ligada à fila `useVToastQueue()`.

## Dados e tabelas

### VDateTile
Mini-calendário "SEP 29" para prazos em listas.
- **props**: `date?`: string \| number \| Date; `month?`: string; `day?`: string \| number; `locale?`: string; `size?`: "sm" \| "md" \| "lg" = "md"; `tone?`: "primary" \| "neutral" \| "warning" \| "danger" = "neutral"; `dataTestId?`: string

### VDescriptionList
Lista de descrição (`<dl>`) para metadados e detalhamentos com total.
- **props**: `items?`: VDescriptionItem[]; `layout?`: "inline" \| "stacked" \| "grid" = "inline"; `size?`: "sm" \| "md" = "md"; `dividers?`: boolean = false; `total?`: { label: string; value: string \| number; }; `columns?`: number = 2; `ariaLabel?`: string; `dataTestId?`: string
- **slots**: `[`value-${row.key}`]`, `value`

### VDiffStat
Resumo de diff `+193 −130` com rótulo acessível e blocos de proporção opcionais.
- **props**: `additions?`: number = 0; `deletions?`: number = 0; `size?`: "sm" \| "md" \| "lg" = "md"; `blocks?`: boolean = false; `blockCount?`: number = 5; `dataTestId?`: string

### 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.
- **props**: `search?`: string; `filters?`: Record<string, string>; `dateRange?`: string; `chips?`: VFilterChip[] = []; `selects?`: VFilterSelect[] = []; `resultsCount?`: number; `totalCount?`: number; `activeCount?`: number; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "basic" \| "sticky" \| "chips" \| "advanced" = "basic"; `sticky?`: boolean = false; `loading?`: boolean = false; `disabled?`: boolean = false; `searchShortcut?`: boolean = true; `title?`: string; `dataTestId?`: string
- **eventos**: `update:search` (string), `update:filters` (Record<string, string>), `update:dateRange` (string), `update:chips` (import('./VFilterBar.types').VFilterChip[]), `change`, `clear`, `chip-remove` (string)

### 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".
- **props**: `columns?`: VGroupedTableColumn[]; `groups?`: VGroupedTableGroup[]; `collapsed?`: string[]; `collapsible?`: boolean = true; `showHeader?`: boolean \| "auto" = "auto"; `headerMinWidth?`: number = 640; `size?`: "default" \| "compact" = "default"; `interactive?`: boolean = false; `containerWidth?`: number = undefined; `ariaLabel?`: string; `dataTestId?`: string
- **eventos**: `update:collapsed` (value: string[]), `group-toggle` (groupId: string, collapsed: boolean), `row-click` (row: VGroupedTableRow, group: VGroupedTableGroup)
- **slots**: `group-header`, `[`cell-${column.key}`]`, `[`cell-${inline.key}`]`

### 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.
- **props**: `columns?`: VKanbanColumn[]; `draggable?`: boolean = true; `addable?`: boolean = true; `addLabel?`: string = "Add task"; `size?`: "sm" \| "md" = "md"; `columnWidth?`: string; `ariaLabel?`: string; `dataTestId?`: string
- **eventos**: `update:columns` (columns: VKanbanColumn[]), `move` (move: VKanbanMove), `add` (columnId: string), `item-click` (item: VKanbanItem, column: VKanbanColumn), `column-menu` (columnId: string)
- **slots**: `card`

### 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.
- **props**: `columns?`: VTableColumn[] = []; `rows?`: VTableRow[] = []; `rowActions?`: VDropdownMenuItem[] = []; `variant?`: "default" \| "minimal" \| "bordered" \| "striped" \| "comparison" = "default"; `size?`: "default" \| "compact" \| "comfortable" = "default"; `loading?`: boolean = false; `selectable?`: boolean = true; `multiple?`: boolean = true; `selected?`: (string \| number)[]; `sort?`: VTableSortState[]; `search?`: string; `showToolbar?`: boolean = true; `showActions?`: boolean = true; `showPagination?`: boolean = true; `page?`: number = 1; `pageSize?`: number = 10; `total?`: number; `expandedRow?`: string \| number \| null; `dataTestId?`: string
- **eventos**: `update:selected` (Array<string | number>), `update:sort` (import('./VTable.types').VTableSortState[]), `update:search` (string), `update:page` (number), `update:pageSize` (number), `update:expandedRow` (string | number | null), `row-click` ({ row: import('./VTable.types').VTableRow; index: number }), `row-action` (import('./VTable.types').VTableRowActionEvent), `filter`, `add`
- **slots**: `[`header-${column.key}`]`, `[`cell-${column.key}`]`

### VTimeline
Linha do tempo vertical.
- **props**: `items?`: VTimelineItem[]; `variant?`: "steps" \| "feed" = "steps"; `size?`: "sm" \| "md" = "md"; `ariaLabel?`: string; `dataTestId?`: string
- **slots**: `marker`, `title`, `description`, `extra`

## Gráficos e métricas

### 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.
- **props**: `data?`: VBarChartDatum[]; `active?`: number = undefined; `height?`: number = 120; `variant?`: "pill" \| "solid" = "pill"; `tone?`: "primary" \| "neutral" \| "inverse" = "primary"; `showValue?`: "none" \| "active" \| "all" = "active"; `showLabels?`: boolean = true; `interactive?`: boolean = false; `max?`: number; `ariaLabel?`: string; `dataTestId?`: string
- **eventos**: `update:active` (index: number), `select` (datum: VBarChartDatum, index: number)

### VBarList
Lista de barras horizontais rotuladas para rankings e distribuições ("Why claims get denied", "How fast money moves").
- **props**: `items?`: VBarListItem[]; `max?`: number; `unit?`: string; `layout?`: "inline" \| "stacked" = "inline"; `emphasis?`: "none" \| "all" \| "max" \| "first" = "max"; `size?`: "sm" \| "md" = "md"; `showValue?`: boolean = true; `ariaLabel?`: string; `dataTestId?`: string
- **slots**: `label`, `value`

### VFlowPath
Caminho de fluxo linear (agentes, serviços, etapas) com métricas na aresta.
- **props**: `nodes?`: VFlowNode[]; `edges?`: VFlowEdge[]; `animated?`: boolean = true; `ariaLabel?`: string; `dataTestId?`: string
- **slots**: `node`, `edge`

### VFunnelChart
Funil de pipeline em colunas: valor por etapa, cápsula proporcional à maior etapa e taxa de conversão entre etapas.
- **props**: `stages?`: VFunnelStage[]; `height?`: number = 120; `showConversion?`: boolean = true; `tone?`: "primary" \| "inverse" = "primary"; `ariaLabel?`: string; `dataTestId?`: string

### VStatCard
Cartão de KPI: rótulo, valor em destaque, variação com tendência e métricas secundárias.
- **props**: `label?`: string; `value?`: string \| number; `caption?`: string; `delta?`: string \| number; `trend?`: "neutral" \| "up" \| "down"; `deltaCaption?`: string; `icon?`: IconifyIcon; `stats?`: VStatCardStat[]; `size?`: "sm" \| "md" \| "lg" = "md"; `variant?`: "elevated" \| "outlined" \| "tinted" \| "plain" = "outlined"; `loading?`: boolean = false; `loadingLabel?`: string; `dataTestId?`: string
- **slots**: `label`, `header-trailing`, `value`, `value-trailing`, `default`, `footer`

## Mídia e pessoas

### VAvatar
Representar pessoas, times ou entidades: ajuda a reconhecer "quem é quem", mostra presença (online/busy) e dá toque humano ao produto.
- **props**: `src?`: string; `alt?`: string; `initials?`: string; `size?`: "sm" \| "md" \| "lg" \| "xl" \| "xs" = "md"; `shape?`: "circle" \| "square" = "circle"; `status?`: "online" \| "busy" \| "offline"; `badge?`: "pro" \| "selected" \| "check"; `selectable?`: boolean = false; `selected?`: boolean; `loading?`: boolean = false; `decorative?`: boolean = false; `ariaLabel?`: string; `dataTestId?`: string
- **eventos**: `click` (MouseEvent), `select` (MouseEvent), `update:selected` (boolean)

### VGroupAvatar (filho de VAvatar)
Grupo de avatares empilhados, com um contador de overflow quando há mais membros do que o `max` visível.
- **props**: `members`: VAvatarMember[]; `max?`: number = 3; `size?`: "sm" \| "md" \| "lg" \| "xl" \| "xs" = "md"; `shape?`: "circle" \| "square" = "circle"; `dataTestId?`: string = "avatar-group"

### VImageGallery
Visual collection and preview
- **v-model**: sim
- **props**: `images?`: VGalleryImage[] = []; `layout?`: "grid" \| "masonry" \| "carousel" = "grid"; `size?`: "sm" \| "md" \| "lg" = "md"; `selectable?`: boolean = false; `multiple?`: boolean = false; `modelValue?`: number[]; `loading?`: boolean = false; `columns?`: number; `dataTestId?`: string
- **eventos**: `select` ({ indices: number[]; image: { src: string; alt: string } }), `update:modelValue` (number[]), `open` (number), `close`
- **slots**: `lightbox`

## IA

### VAgentChip
Indicador compacto de execução de ferramenta do agente (pending, success, error) com duração e retry.
- **props**: `label?`: string = "Running tool"; `status?`: "pending" \| "success" \| "error" = "pending"; `durationMs?`: number = 0; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `ariaLabel?`: string; `retryLabel?`: string
- **eventos**: `retry`
- **slots**: `default`

### VAudioRecorder
Barra de nota de voz (gravar, pausar, salvar, ouvir, descartar) com waveform.
- **props**: `state?`: "recording" \| "paused" \| "ready" \| "playing" = "ready"; `elapsed?`: number = 0; `duration?`: number = 0; `levels?`: number[]; `bars?`: number = 32; `size?`: "sm" \| "md" = "md"; `closable?`: boolean = true; `disabled?`: boolean = false; `ariaLabel?`: string = "Voice note"; `dataTestId?`: string
- **eventos**: `discard`, `pause`, `resume`, `save`, `play`, `stop`, `close`

### VPromptBar
Barra de prompt para superfícies de IA com anexo, dictation (Voice Pill) e ação send/stop.
- **v-model**: sim
- **props**: `modelValue?`: string = ""; `busy?`: boolean = false; `placeholder?`: string = "Ask anything…"; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `disabled?`: boolean = false; `loading?`: boolean = false; `sendLabel?`: string; `stopLabel?`: string; `attachLabel?`: string; `ariaLabel?`: string; `dictation?`: boolean = true; `dictationLabel?`: string; `dictationLang?`: string
- **eventos**: `update:modelValue` (value: string), `send`, `stop`, `dictation-start`, `dictation-stop`, `dictation-error` (message: string)
- **slots**: `attachment`

### VThoughtLine
Linha expansível de raciocínio do agente com timer, trace de passos e resumo ao concluir.
- **props**: `label?`: string = "Thinking"; `steps?`: VThoughtLineStep[] = []; `duration?`: number = 0; `motion?`: "default" \| "expressive" \| "none" = V_MOTION_DEFAULT ("expressive"); `defaultExpanded?`: boolean = false; `ariaLabel?`: string
- **eventos**: `update:expanded` (value: boolean)

## Composables e módulos

- `gestures`: `rubberBand(value: number, min: number, max: number, factor = GESTURE_DEFAULTS.rubberBandFactor): number`; `snapFromVelocity(offset: number, velocity: number, threshold = GESTURE_DEFAULTS.swipeThreshold, flick = GESTURE_DEFAULTS.flickVelocity): boolean`
- `springs`: `springStep(current: number, target: number, velocity: number, stiffness = 180, damping = 18, dt = 1 / 60): { value: number; velocity: number }`; `zetaFromBounce(bounce: number): number`; `springReadings(t: number, doneOpacity = 0.62, strikeLag = 0.12): { fillScale: number boxScale: number tickOffset: number wordOpacity: number ruleScale: number }`
- `useAudioRecorder`: `isAudioRecordingSupported()`; `useAudioRecorder(options: UseAudioRecorderOptions = {})`
- `usePointerDrag`: `usePointerDrag(elementRef: Ref<HTMLElement | null>, options: PointerDragOptions = {})`
- `useReducedMotion`: `useReducedMotion()`; `isMotionDisabled(level: 'default' | 'expressive' | 'none', reduced: boolean): boolean`
- `useSpringValue`: `useSpringValue(target: Ref<number>, options: { stiffness?: number; damping?: number; immediate?: boolean } = {})`
- `useTheme`: `useTheme(options: UseThemeOptions = {}): UseThemeReturn`
- `useWarmTooltipGroup`: `useWarmTooltipGroup()`
