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

# Catálogo A2UI ui-nova — `https://uinova.walderpinheiro.com.br/a2ui/catalog/v1.json`

Somente estes componentes são aceitos pelo renderer. Qualquer outro nome é rejeitado (erro devolvido ao agente).

## Accordion → `VAccordion`
Progressive disclosure for FAQs, settings panels, and any content that benefits from a clear, compact hierarchy.
- `multiple?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"bordered"\|"divided"\|"leading-icon" = "default"
- `attached?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `value?`: json
- `children?`: ChildList
- `weight?`: Weight

## AccordionItem → `VAccordionItem`
Item de um VAccordion: o gatilho mostra o título e o slot default é o corpo que se expande.
- `value?`: DynamicString
- `title?`: DynamicString
- `disabled?`: DynamicBoolean
- `child?`: Child
- `weight?`: Weight

## ActionList → `VActionList`
Lista de ações/propriedades em seções rotuladas — o painel "Environment" de apps de agentes/IDE.
- `sections?`: json
- `variant?`: "plain"\|"card" = "card"
- `size?`: "sm"\|"md" = "md"
- `dividers?`: DynamicBoolean = true
- `selectAction?`: Action
- `sectionAction?`: Action
- `weight?`: Weight

## AgentChip → `VAgentChip`
Indicador compacto de execução de ferramenta do agente (pending, success, error) com duração e retry.
- `label?`: DynamicString = "Running tool"
- `status?`: "pending"\|"success"\|"error" = "pending"
- `durationMs?`: DynamicNumber = 0
- `retryLabel?`: DynamicString
- `retryAction?`: Action
- `weight?`: Weight

## Alert → `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.
- `title?`: DynamicString
- `description?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `dismissible?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "neutral"\|"warning"\|"danger"\|"success"\|"info" = "info"
- `dismissLabel?`: DynamicString
- `dismissAction?`: Action
- `weight?`: Weight

## AutoLayoutGrid → `VAutoLayoutGrid`
A flexible auto-flow layout grid for arranging responsive cards and content blocks.
- `minItemWidth?`: DynamicNumber = 280
- `gap?`: DynamicNumber
- `rowGap?`: DynamicNumber
- `columnGap?`: DynamicNumber
- `size?`: "compact"\|"medium"\|"spacious" = "medium"
- `selectable?`: DynamicBoolean = false
- `children?`: ChildList
- `weight?`: Weight

## AutoLayoutGridItem → `VAutoLayoutGridItem`
Célula da VAutoLayoutGrid.
- `selected?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `interactive?`: DynamicBoolean = true
- `colSpan?`: DynamicNumber
- `rowSpan?`: DynamicNumber
- `child?`: Child
- `action?`: Action
- `weight?`: Weight

## Avatar → `VAvatar`
Representar pessoas, times ou entidades: ajuda a reconhecer "quem é quem", mostra presença (online/busy) e dá toque humano ao produto.
- `src?`: DynamicString
- `alt?`: DynamicString
- `initials?`: DynamicString
- `size?`: "sm"\|"md"\|"lg"\|"xl"\|"xs" = "md"
- `shape?`: "circle"\|"square" = "circle"
- `status?`: "online"\|"busy"\|"offline"
- `badge?`: "pro"\|"selected"\|"check"
- `loading?`: DynamicBoolean = false
- `decorative?`: DynamicBoolean = false
- `weight?`: Weight

## Badge → `VBadge`
Badge é um rótulo compacto para **status**, contagens e indicadores.
- `size?`: "sm"\|"md"\|"lg"\|"xs" = "md"
- `variant?`: "outlined"\|"default"\|"primary"\|"neutral"\|"warning"\|"danger"\|"success"\|"purple"\|"count"\|"dot"\|"subtle"
- `count?`: DynamicString
- `dot?`: DynamicBoolean
- `dotColor?`: ColorToken
- `icon?`: IconName
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `live?`: DynamicBoolean = false
- `text?`: DynamicString
- `weight?`: Weight

## Banner → `VBanner`
A flexible banner component for important messages, alerts, and contextual information.
- `title?`: DynamicString
- `description?`: DynamicString
- `variant?`: "neutral"\|"warning"\|"success"\|"error"\|"info" = "info"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `closable?`: DynamicBoolean = false
- `closeOnEscape?`: DynamicBoolean = true
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `dismissLabel?`: DynamicString = "Dismiss banner"
- `dismissedText?`: DynamicString = "Banner dismissed"
- `open?`: DynamicBoolean
- `child?`: Child
- `actions?`: ChildList
- `closeAction?`: Action
- `weight?`: Weight

## BarChart → `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.
- `data?`: json
- `active?`: DynamicNumber
- `height?`: DynamicNumber = 120
- `variant?`: "pill"\|"solid" = "pill"
- `tone?`: "primary"\|"neutral"\|"inverse" = "primary"
- `showValue?`: "none"\|"active"\|"all" = "active"
- `showLabels?`: DynamicBoolean = true
- `interactive?`: DynamicBoolean = false
- `max?`: DynamicNumber
- `selectAction?`: Action
- `weight?`: Weight

## BarList → `VBarList`
Lista de barras horizontais rotuladas para rankings e distribuições ("Why claims get denied", "How fast money moves").
- `items?`: json
- `max?`: DynamicNumber
- `unit?`: DynamicString
- `layout?`: "inline"\|"stacked" = "inline"
- `emphasis?`: "none"\|"all"\|"max"\|"first" = "max"
- `size?`: "sm"\|"md" = "md"
- `showValue?`: DynamicBoolean = true
- `weight?`: Weight

## Breadcrumb → `VBreadcrumb`
Trilha de navegação hierárquica que mostra onde o usuário está e permite voltar rapidamente aos níveis anteriores.
- `items?`: json
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"compact"\|"icons"\|"overflow" = "default"
- `maxItems?`: DynamicNumber = 4
- `navigateAction?`: Action
- `weight?`: Weight

## Button → `VButton`
A versatile action trigger for primary, secondary, and contextual actions.
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `shape?`: "default"\|"pill"
- `variant?`: "primary"\|"inverse"\|"destructive"\|"loading"\|"secondary"\|"ghost"\|"outline"\|"icon" = "primary"
- `intent?`: "neutral"\|"success"
- `child`: Child
- `action`: Action
- `weight?`: Weight

## Card → `VCard`
Flexible content container
- `title?`: DynamicString
- `description?`: DynamicString
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "elevated"\|"outlined"\|"filled"\|"interactive" = "elevated"
- `loading?`: DynamicBoolean = false
- `interactive?`: DynamicBoolean = false
- `selected?`: DynamicBoolean = false
- `child?`: Child
- `actions?`: ChildList
- `footer?`: ChildList
- `action?`: Action
- `weight?`: Weight

## CardGrid → `VCardGrid`
`VCardGrid` organiza cards em uma grade CSS.
- `cols?`: json
- `minCardWidth?`: DynamicNumber
- `gap?`: DynamicNumber = 6
- `children?`: ChildList
- `weight?`: Weight

## Checkbox → `VCheckbox`
A checkbox component for boolean choices and multi-select interfaces.
- `indeterminate?`: DynamicBoolean = false
- `label?`: DynamicString
- `description?`: DynamicString
- `helperText?`: DynamicString
- `errorMessage?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `required?`: DynamicBoolean = false
- `value?`: DynamicBoolean
- `weight?`: Weight

## ColorPicker → `VColorPicker`
A color selection component for themes, branding, and creative tools.
- `variant?`: "inline"\|"popover"\|"hex"\|"opacity"\|"preset" = "popover"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `disabled?`: DynamicBoolean = false
- `showAlpha?`: DynamicBoolean = false
- `presets?`: DynamicStringList
- `label?`: DynamicString
- `inlineSwatches?`: DynamicStringList
- `value?`: DynamicString
- `weight?`: Weight

## Column (primitivo do renderer)
Flex vertical. gap/align usam a escala --v-space-*.
- `children`: ChildList
- `gap?`: "0"\|"1"\|"2"\|"3"\|"4"\|"6"\|"8"\|"12"\|"16"\|"24" = "4"
- `justify?`: "start"\|"center"\|"end"\|"spaceBetween"\|"spaceAround"\|"spaceEvenly" = "start"
- `align?`: "start"\|"center"\|"end"\|"stretch" = "stretch"
- `weight?`: Weight

## DashboardColumn → `VDashboardColumn`
Coluna do dashboard que empilha widgets, com cabeçalho, recolhimento, redimensionamento e zona de largada.
- `title?`: DynamicString
- `icon?`: IconName
- `variant?`: "collapsible"\|"fixed"\|"fluid"\|"sticky" = "fixed"
- `size?`: "wide"\|"medium"\|"narrow" = "medium"
- `stickyTop?`: DynamicNumber = 0
- `menu?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `collapsed?`: DynamicBoolean
- `children?`: ChildList
- `menuAction?`: Action
- `weight?`: Weight

## DashboardRow → `VDashboardRow`
Fileira do dashboard que alinha, distribui e espaça seções na horizontal, com quebra responsiva.
- `variant?`: "standard"\|"dense"\|"split"\|"wrap" = "standard"
- `gap?`: "compact"\|"medium"\|"spacious"
- `align?`: "start"\|"end"\|"center"\|"stretch"\|"baseline"
- `justify?`: "start"\|"end"\|"center"\|"between"\|"around"\|"evenly"
- `wrap?`: DynamicBoolean = false
- `divider?`: DynamicBoolean = false
- `title?`: DynamicString
- `subtitle?`: DynamicString
- `as?`: "div"\|"section" = "div"
- `disabled?`: DynamicBoolean = false
- `children?`: ChildList
- `actions?`: ChildList
- `weight?`: Weight

## DatePicker → `VDatePicker`
Date picker flexível para data única ou intervalo, com calendário acessível e presets.
- `variant?`: "default"\|"with-icon"\|"with-preset"\|"range" = "default"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `disabled?`: DynamicBoolean = false
- `placeholder?`: DynamicString
- `label?`: DynamicString
- `format?`: DynamicString
- `showToday?`: DynamicBoolean = true
- `showLeadingIcon?`: DynamicBoolean
- `clearable?`: DynamicBoolean = true
- `min?`: DynamicString
- `max?`: DynamicString
- `value?`: DynamicString
- `weight?`: Weight

## DateRangePicker → `VDateRangePicker`
A start-and-end date selection component for reporting, booking, and filtering workflows.
- `variant?`: "default"\|"compact"\|"inline"\|"presets"\|"with-time" = "default"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `disabled?`: DynamicBoolean = false
- `placeholder?`: DynamicString
- `label?`: DynamicString
- `format?`: DynamicString
- `compactFormat?`: DynamicString
- `enableTime?`: DynamicBoolean
- `min?`: DynamicString
- `max?`: DynamicString
- `value?`: json
- `applyAction?`: Action
- `weight?`: Weight

## DateTile → `VDateTile`
Mini-calendário "SEP 29" para prazos em listas.
- `date?`: DynamicValue
- `month?`: DynamicString
- `day?`: DynamicString
- `locale?`: DynamicString
- `size?`: "sm"\|"md"\|"lg" = "md"
- `tone?`: "primary"\|"neutral"\|"warning"\|"danger" = "neutral"
- `weight?`: Weight

## DescriptionList → `VDescriptionList`
Lista de descrição (`<dl>`) para metadados e detalhamentos com total.
- `items?`: json
- `layout?`: "inline"\|"stacked"\|"grid" = "inline"
- `size?`: "sm"\|"md" = "md"
- `dividers?`: DynamicBoolean = false
- `total?`: json
- `columns?`: DynamicNumber = 2
- `weight?`: Weight

## DiffStat → `VDiffStat`
Resumo de diff `+193 −130` com rótulo acessível e blocos de proporção opcionais.
- `additions?`: DynamicNumber = 0
- `deletions?`: DynamicNumber = 0
- `size?`: "sm"\|"md"\|"lg" = "md"
- `blocks?`: DynamicBoolean = false
- `blockCount?`: DynamicNumber = 5
- `weight?`: Weight

## Divider (primitivo do renderer)
Separador hairline (role=separator) com --v-color-border-*.
- `axis?`: "horizontal"\|"vertical" = "horizontal"
- `weight?`: Weight

## Drawer → `VDrawer`
Painel contextual slide-in que revela detalhes e ações sem tirar o usuário da página atual.
- `title?`: DynamicString
- `placement?`: "top"\|"bottom"\|"left"\|"right" = "right"
- `side?`: "top"\|"bottom"\|"left"\|"right"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `width?`: "sm"\|"md"\|"lg"
- `showClose?`: DynamicBoolean = true
- `dismissible?`: DynamicBoolean = true
- `loading?`: DynamicBoolean = false
- `closeLabel?`: DynamicString = "Close drawer"
- `variant?`: "default"\|"primary"\|"subtle"
- `open?`: DynamicBoolean
- `child?`: Child
- `footer?`: ChildList
- `actions?`: ChildList
- `closeAction?`: Action
- `weight?`: Weight

## DropdownMenu → `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.
- `label?`: DynamicString
- `icon?`: IconName
- `showTriggerIcon?`: DynamicBoolean = true
- `showChevron?`: DynamicBoolean = true
- `items?`: json
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"primary"\|"subtle"\|"destructive"\|"secondary"\|"ghost" = "secondary"
- `triggerStyle?`: "default"\|"icon"\|"field"
- `menuAlign?`: "start"\|"end"
- `value?`: DynamicString
- `selectAction?`: Action
- `weight?`: Weight

## EmptyState → `VEmptyState`
A flexible empty state component for when there's nothing to show.
- `title?`: DynamicString
- `description?`: DynamicString
- `action?`: Action
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"results"\|"files"\|"notifications"\|"create" = "default"
- `compact?`: DynamicBoolean = false
- `showIllustration?`: DynamicBoolean = true
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `headingLevel?`: 2\|3\|4 = 2
- `weight?`: Weight

## FlowPath → `VFlowPath`
Caminho de fluxo linear (agentes, serviços, etapas) com métricas na aresta.
- `nodes?`: json
- `edges?`: json
- `animated?`: DynamicBoolean = true
- `weight?`: Weight

## FunnelChart → `VFunnelChart`
Funil de pipeline em colunas: valor por etapa, cápsula proporcional à maior etapa e taxa de conversão entre etapas.
- `stages?`: json
- `height?`: DynamicNumber = 120
- `showConversion?`: DynamicBoolean = true
- `tone?`: "primary"\|"inverse" = "primary"
- `weight?`: Weight

## GroupAvatar → `VGroupAvatar`
Grupo de avatares empilhados, com um contador de overflow quando há mais membros do que o `max` visível.
- `members`: json
- `max?`: DynamicNumber = 3
- `size?`: "sm"\|"md"\|"lg"\|"xl"\|"xs" = "md"
- `shape?`: "circle"\|"square" = "circle"
- `weight?`: Weight

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

## Image (primitivo do renderer)
Imagem com `alt` obrigatório (ou decorative=true).
- `url`: DynamicString
- `alt?`: DynamicString
- `decorative?`: boolean = false
- `fit?`: "contain"\|"cover"\|"fill"\|"none"\|"scale-down" = "cover"
- `radius?`: "0"\|"4"\|"8"\|"12"\|"16"\|"24"\|"full" = "8"
- `aspectRatio?`: "auto"\|"1:1"\|"4:3"\|"16:9"\|"3:2" = "auto"
- `weight?`: Weight

## ImageGallery → `VImageGallery`
Visual collection and preview URLs passam pela política de URL do host (só https por padrão).
- `images?`: json
- `layout?`: "grid"\|"masonry"\|"carousel" = "grid"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `selectable?`: DynamicBoolean = false
- `multiple?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `columns?`: DynamicNumber
- `selected?`: json
- `selectAction?`: Action
- `weight?`: Weight

## Kbd → `VKbd`
`VKbd` mostra um atalho de teclado (`Ctrl+K`, `⌘ K`, `Esc`).
- `keys?`: json
- `size?`: "sm"\|"md" = "sm"
- `weight?`: Weight

## List (primitivo do renderer)
Lista (vertical/horizontal) — principal alvo de children por template ligado a um array do data model.
- `children`: ChildList
- `direction?`: "vertical"\|"horizontal" = "vertical"
- `gap?`: "0"\|"1"\|"2"\|"3"\|"4"\|"6"\|"8" = "2"
- `dividers?`: boolean = false
- `weight?`: Weight

## MasonryGrid → `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.
- `cols?`: json
- `gap?`: DynamicNumber = 6
- `variant?`: "default"\|"image-first"\|"content-first"\|"mixed-media"\|"magazine" = "default"
- `loading?`: DynamicBoolean = false
- `empty?`: DynamicBoolean = false
- `children?`: ChildList
- `weight?`: Weight

## MasonryItem → `VMasonryItem`
Tile de uma VMasonryGrid: mídia, título, categoria e metadados numa célula de altura variável.
- `title?`: DynamicString
- `category?`: DynamicString
- `selected?`: DynamicBoolean = false
- `interactive?`: DynamicBoolean = true
- `likes?`: DynamicNumber
- `child?`: Child
- `action?`: Action
- `weight?`: Weight

## Modal → `VDialog`
Superfície modal temporária para informação crítica, decisões e tarefas focadas.
- `title?`: DynamicString
- `description?`: DynamicString
- `showClose?`: DynamicBoolean = true
- `dismissible?`: DynamicBoolean = true
- `persistent?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "basic"\|"confirmation"\|"alert"\|"form"\|"fullscreen" = "basic"
- `intent?`: "neutral"\|"success"\|"destructive" = "neutral"
- `cancelText?`: DynamicString = "Cancel"
- `confirmText?`: DynamicString = "Confirm"
- `closeLabel?`: DynamicString = "Close dialog"
- `open?`: DynamicBoolean
- `child?`: Child
- `footer?`: ChildList
- `confirmAction?`: Action
- `cancelAction?`: Action
- `weight?`: Weight

## NotificationItem → `VNotificationItem`
A flexible notification item for messages, activity, and system alerts.
- `avatar?`: DynamicString
- `avatarAlt?`: DynamicString
- `title?`: DynamicString
- `preview?`: DynamicString
- `time?`: DynamicString
- `variant?`: "default"\|"success"\|"avatar"\|"system"\|"actionable" = "default"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `dismissible?`: DynamicBoolean = false
- `actions?`: json
- `dismissLabel?`: DynamicString = "Dismiss notification"
- `unread?`: DynamicBoolean
- `action?`: Action
- `dismissAction?`: Action
- `itemAction?`: Action
- `weight?`: Weight

## NumberInput → `VNumberInput`
A numeric input component with step controls and validation.
- `label?`: DynamicString
- `helperText?`: DynamicString
- `errorMessage?`: DynamicString
- `placeholder?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `readonly?`: DynamicBoolean = false
- `required?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `min?`: DynamicNumber
- `max?`: DynamicNumber
- `step?`: DynamicNumber = 1
- `prefix?`: DynamicString
- `suffix?`: DynamicString
- `interaction?`: "default"\|"scrub" = "scrub"
- `value?`: DynamicNumber
- `weight?`: Weight

## OtpInput → `VOtpInput`
A one-time password / verification code input for secure authentication flows.
- `length?`: DynamicNumber = 6
- `masked?`: DynamicBoolean = false
- `autoSubmit?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `errorMessage?`: DynamicString
- `success?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `separatorIndex?`: DynamicNumber
- `helperText?`: DynamicString
- `resendLabel?`: DynamicString = "Resend code"
- `resendCooldown?`: DynamicNumber = 0
- `value?`: DynamicString
- `completeAction?`: Action
- `resendAction?`: Action
- `weight?`: Weight

## Pagination → `VPagination`
Controle de navegação página a página.
- `total?`: DynamicNumber = 0
- `pageCount?`: DynamicNumber
- `siblingCount?`: DynamicNumber
- `boundaryCount?`: DynamicNumber
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"compact"\|"ellipsis" = "default"
- `showPageSize?`: DynamicBoolean = false
- `showResultCount?`: DynamicBoolean = false
- `pageSizeOptions?`: json
- `prevLabel?`: DynamicString
- `nextLabel?`: DynamicString
- `pageSizeLabel?`: DynamicString
- `value?`: DynamicNumber
- `pageSize?`: DynamicNumber
- `pageAction?`: Action
- `weight?`: Weight

## Panel → `VPanel`
O `VPanel` é um contentor flexível para agrupar conteúdo relacionado — informação, ações e media — em secções claras e autocontidas.
- `title?`: DynamicString
- `description?`: DynamicString
- `icon?`: IconName
- `headingLevel?`: "2"\|"3" = "3"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "elevated"\|"filled"\|"default"\|"bordered" = "default"
- `interactive?`: DynamicBoolean = false
- `expanded?`: DynamicBoolean
- `child?`: Child
- `actions?`: ChildList
- `footer?`: ChildList
- `weight?`: Weight

## PasswordInput → `VPasswordInput`
A secure password field with visibility toggle and strength feedback.
- `label?`: DynamicString
- `helperText?`: DynamicString
- `errorMessage?`: DynamicString
- `placeholder?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `readonly?`: DynamicBoolean = false
- `required?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `showStrength?`: DynamicBoolean = false
- `requirements?`: DynamicBoolean = false
- `revealLabel?`: DynamicString
- `maskLabel?`: DynamicString
- `value?`: DynamicString
- `weight?`: Weight

## Progress → `VProgress`
Indicador de progresso linear e circular que comunica claramente o status de conclusão de uma tarefa ou processo.
- `variant?`: "linear"\|"circular" = "linear"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `value?`: DynamicNumber = 0
- `state?`: "success"\|"error"\|"determinate"\|"indeterminate" = "determinate"
- `label?`: DynamicValue
- `ariaValuetext?`: DynamicString
- `weight?`: Weight

## RadioGroup → `VRadioGroup`
Seleção única entre opções mutuamente exclusivas, com layouts vertical, horizontal e card.
- `options`: json
- `label?`: DynamicString
- `description?`: DynamicString
- `errorMessage?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `layout?`: "vertical"\|"horizontal"\|"card" = "vertical"
- `required?`: DynamicBoolean = false
- `value?`: DynamicString
- `weight?`: Weight

## Row (primitivo do renderer)
Flex horizontal. gap/align usam a escala --v-space-*.
- `children`: ChildList
- `gap?`: "0"\|"1"\|"2"\|"3"\|"4"\|"6"\|"8"\|"12"\|"16"\|"24" = "3"
- `justify?`: "start"\|"center"\|"end"\|"spaceBetween"\|"spaceAround"\|"spaceEvenly"\|"stretch" = "start"
- `align?`: "start"\|"center"\|"end"\|"stretch"\|"baseline" = "center"
- `wrap?`: boolean = false
- `weight?`: Weight

## SearchField → `VSearchField`
Campo de busca com ícone, clear, atalho ⌘K, sugestões e loading.
- `label?`: DynamicString
- `placeholder?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "standard"\|"shortcut"\|"command"
- `clearable?`: DynamicBoolean = true
- `clearLabel?`: DynamicString
- `suggestions?`: json
- `value?`: DynamicString
- `searchAction?`: Action
- `selectAction?`: Action
- `clearAction?`: Action
- `weight?`: Weight

## Section → `VSection`
A flexible container for organizing related content into a clear, structured section.
- `title?`: DynamicString
- `description?`: DynamicString
- `icon?`: IconName
- `headingLevel?`: "2"\|"3" = "2"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "elevated"\|"default"\|"bordered"\|"borderless"\|"tinted" = "default"
- `child?`: Child
- `actions?`: ChildList
- `footer?`: ChildList
- `weight?`: Weight

## SegmentedControl → `VSegmentedControl`
Controle segmentado inline de escolha única entre opções relacionadas — alternativa compacta a tabs para trocar views, períodos ou ordenação.
- `options?`: json
- `disabled?`: DynamicBoolean = false
- `fullWidth?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"pill" = "default"
- `value?`: DynamicString
- `weight?`: Weight

## Select → `VSelect`
Campo de seleção single-choice com label, placeholder, ícone opcional, validação e menu suspenso acessível.
- `options?`: json
- `label?`: DynamicString
- `placeholder?`: DynamicString = "Select option"
- `disabled?`: DynamicBoolean = false
- `errorMessage?`: DynamicString
- `size?`: "sm"\|"md"\|"lg" = "md"
- `clearable?`: DynamicBoolean
- `value?`: DynamicString
- `weight?`: Weight

## Sheet → `VSheet`
Superfície edge-attached que desliza da borda para tarefas focadas (settings, details, creation flows), sem tirar o usuário do contexto.
- `side?`: "top"\|"bottom"\|"left"\|"right" = "right"
- `size?`: "sm"\|"md"\|"lg"\|"xl" = "md"
- `fullHeight?`: DynamicBoolean = false
- `title?`: DynamicString
- `description?`: DynamicString
- `showClose?`: DynamicBoolean = true
- `closeLabel?`: DynamicString = "Close sheet"
- `dismissible?`: DynamicBoolean = true
- `loading?`: DynamicBoolean = false
- `open?`: DynamicBoolean
- `child?`: Child
- `footer?`: ChildList
- `actions?`: ChildList
- `closeAction?`: Action
- `weight?`: Weight

## Skeleton → `VSkeleton`
A flexible loading placeholder for content that's on its way.
- `variant?`: "avatar"\|"text"\|"card"\|"table-row"\|"chart" = "text"
- `size?`: "sm"\|"md"\|"lg"\|"xs" = "md"
- `lines?`: DynamicNumber = 3
- `animated?`: DynamicBoolean = true
- `disabled?`: DynamicBoolean = false
- `weight?`: Weight

## Slider → `VSlider`
A slider component for selecting numeric values or ranges.
- `min?`: DynamicNumber = 0
- `max?`: DynamicNumber = 100
- `step?`: DynamicNumber = 1
- `range?`: DynamicBoolean = false
- `marks?`: json
- `orientation?`: "vertical"\|"horizontal" = "horizontal"
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `showValue?`: DynamicBoolean = true
- `showTooltip?`: DynamicBoolean = true
- `snapToMarks?`: DynamicBoolean = false
- `value?`: json
- `weight?`: Weight

## Spinner → `VSpinner`
A flexible loading indicator for communicating progress and waiting states.
- `variant?`: "inline"\|"circular"\|"dots"\|"ring"\|"lattice" = "circular"
- `size?`: "sm"\|"md"\|"lg"\|"xl"\|"xs" = "md"
- `label?`: DynamicString = "Loading"
- `decorative?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = true
- `weight?`: Weight

## StatCard → `VStatCard`
Cartão de KPI: rótulo, valor em destaque, variação com tendência e métricas secundárias.
- `label?`: DynamicString
- `value?`: DynamicString
- `caption?`: DynamicString
- `delta?`: DynamicString
- `trend?`: "neutral"\|"up"\|"down"
- `deltaCaption?`: DynamicString
- `icon?`: IconName
- `stats?`: json
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "elevated"\|"outlined"\|"tinted"\|"plain" = "outlined"
- `loading?`: DynamicBoolean = false
- `loadingLabel?`: DynamicString
- `weight?`: Weight

## StatusMark → `VStatusMark`
Marcador compacto de status de uma tarefa/execução (ocioso, em andamento, sucesso, erro) com `role="status"`.
- `state?`: "success"\|"error"\|"idle"\|"running" = "idle"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `label?`: DynamicString
- `weight?`: Weight

## Stepper → `VStepper`
Componente VueUI Nova para **stepper**, seguindo tokens semânticos e Light Mode como referência principal.
- `steps?`: json
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"primary"\|"subtle" = "default"
- `value?`: DynamicValue
- `stepAction?`: Action
- `weight?`: Weight

## Switch → `VSwitch`
Toggle binário on/off para configurações e preferências, com thumb animado e suporte a label/descrição.
- `label?`: DynamicString
- `description?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `value?`: DynamicBoolean
- `weight?`: Weight

## Table → `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.
- `columns?`: json
- `rows?`: json
- `variant?`: "default"\|"minimal"\|"bordered"\|"striped"\|"comparison" = "default"
- `size?`: "default"\|"compact"\|"comfortable" = "default"
- `loading?`: DynamicBoolean = false
- `showPagination?`: DynamicBoolean = true
- `page?`: DynamicNumber = 1
- `pageSize?`: DynamicNumber = 10
- `total?`: DynamicNumber
- `rowAction?`: Action
- `rowMenuAction?`: Action
- `weight?`: Weight

## Tabs → `VTabs`
Contextual content navigation `items` é derivado de `tabs[].{value,label,icon}`; o slot default renderiza o `child` da aba ativa.
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "pill"\|"icon"\|"underline" = "underline"
- `dividers?`: DynamicBoolean = false
- `value?`: DynamicString
- `tabs?`: array
- `weight?`: Weight

## Tag → `VTag`
`VTag` é o chip de **ação** (e de token acionável).
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"outline"\|"soft"\|"overlay" = "default"
- `interactive?`: DynamicBoolean
- `selected?`: DynamicBoolean
- `disabled?`: DynamicBoolean = false
- `removable?`: DynamicBoolean = false
- `removeLabel?`: DynamicString
- `text?`: DynamicString
- `action?`: Action
- `removeAction?`: Action
- `weight?`: Weight

## TagInput → `VTagInput`
A component for entering, editing, and removing tags or chips.
- `suggestions?`: DynamicStringList
- `placeholder?`: DynamicString = "Add a tag…"
- `disabled?`: DynamicBoolean = false
- `readonly?`: DynamicBoolean = false
- `closable?`: DynamicBoolean = true
- `multiline?`: DynamicBoolean = false
- `maxTags?`: DynamicNumber
- `delimiters?`: json
- `allowDuplicates?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `emptyText?`: DynamicString = "No tags yet."
- `value?`: DynamicStringList
- `addAction?`: Action
- `removeAction?`: Action
- `weight?`: Weight

## Text (primitivo do renderer)
Texto tipográfico com tokens --v-font-size-*.
- `text`: DynamicString
- `variant?`: "display-1"\|"display-2"\|"h1"\|"h2"\|"h3"\|"h4"\|"h5"\|"body-large"\|"body"\|"body-small"\|"caption" = "body"
- `tone?`: "default"\|"muted"\|"primary"\|"success"\|"warning"\|"danger" = "default"
- `fontWeight?`: "regular"\|"medium"\|"semibold"\|"bold"
- `weight?`: Weight

## TextInput → `VTextInput`
A flexible single-line text input for forms and search-like data entry.
- `label?`: DynamicString
- `helperText?`: DynamicString
- `errorMessage?`: DynamicString
- `successMessage?`: DynamicString
- `placeholder?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `readonly?`: DynamicBoolean = false
- `required?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `clearable?`: DynamicBoolean = false
- `clearLabel?`: DynamicString
- `leadingIcon?`: IconName
- `prefix?`: DynamicString
- `suffix?`: DynamicString
- `type?`: "text"\|"email"\|"url"\|"search"\|"tel" = "text"
- `spellcheck?`: DynamicBoolean
- `autocapitalize?`: "none"\|"off"\|"on"\|"sentences"\|"words"\|"characters"
- `value?`: DynamicString
- `weight?`: Weight

## Textarea → `VTextarea`
Campo multilinha com auto-resize, contador de caracteres, helper e erro.
- `label?`: DynamicString
- `helperText?`: DynamicString
- `errorMessage?`: DynamicString
- `placeholder?`: DynamicString
- `disabled?`: DynamicBoolean = false
- `readonly?`: DynamicBoolean = false
- `required?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `counter?`: DynamicNumber
- `autoResize?`: DynamicBoolean = false
- `rows?`: DynamicNumber
- `spellcheck?`: DynamicBoolean
- `resize?`: "none"\|"vertical"\|"horizontal"\|"both" = "vertical"
- `value?`: DynamicString
- `weight?`: Weight

## ThoughtLine → `VThoughtLine`
Linha expansível de raciocínio do agente com timer, trace de passos e resumo ao concluir.
- `label?`: DynamicString = "Thinking"
- `steps?`: json
- `duration?`: DynamicNumber = 0
- `defaultExpanded?`: DynamicBoolean = false
- `weight?`: Weight

## ThumbnailGrid → `VThumbnailGrid`
Grade responsiva de miniaturas para mídia, arquivos e galerias, com seleção e ações rápidas.
- `items?`: json
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "compact"\|"files"\|"gallery"\|"selectable" = "gallery"
- `selection?`: "none"\|"single"\|"multiple"
- `actions?`: DynamicBoolean = false
- `emptyLabel?`: DynamicString = "Nenhum arquivo por aqui."
- `selected?`: DynamicStringList
- `action?`: Action
- `itemAction?`: Action
- `weight?`: Weight

## TimeRange → `VTimeRange`
Barra compacta de intervalo de horário `12:00 → 12:30 · 30min`, usando `<input type="time">` nativo (teclado e leitores de tela inclusos).
- `step?`: DynamicNumber = 5
- `showDuration?`: DynamicBoolean = true
- `closable?`: DynamicBoolean = true
- `disabled?`: DynamicBoolean = false
- `size?`: "sm"\|"md" = "md"
- `startLabel?`: DynamicString = "Start time"
- `endLabel?`: DynamicString = "End time"
- `start?`: DynamicString
- `end?`: DynamicString
- `closeAction?`: Action
- `weight?`: Weight

## Timeline → `VTimeline`
Linha do tempo vertical.
- `items?`: json
- `variant?`: "steps"\|"feed" = "steps"
- `size?`: "sm"\|"md" = "md"
- `weight?`: Weight

## Toast → `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.
- `message?`: DynamicString
- `variant?`: "warning"\|"success"\|"error"\|"info"\|"loading" = "info"
- `size?`: "sm"\|"md"\|"lg" = "md"
- `duration?`: DynamicNumber = 5000
- `closable?`: DynamicBoolean = true
- `showProgress?`: DynamicBoolean = true
- `loading?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `dismissLabel?`: DynamicString
- `open?`: DynamicBoolean
- `closeAction?`: Action
- `weight?`: Weight

## Tooltip → `VTooltip`
Dica contextual (contextual helper hint) que exibe informação breve e contextual ao dar hover, focus ou tap num elemento.
- `content?`: DynamicString
- `placement?`: "top"\|"bottom"\|"left"\|"right" = "top"
- `size?`: "sm"\|"md"\|"lg"\|"xl" = "md"
- `variant?`: "default"\|"success"\|"error"\|"with-icon"\|"brand"\|"light" = "default"
- `disabled?`: DynamicBoolean = false
- `showArrow?`: DynamicBoolean = true
- `hideDelay?`: DynamicNumber = 500
- `child?`: Child
- `weight?`: Weight

## TreeNavigation → `VTreeNavigation`
Explorador hierárquico expansível para file systems, settings, documentação e qualquer conteúdo nested.
- `items?`: json
- `multiple?`: DynamicBoolean = false
- `showCounts?`: DynamicBoolean = true
- `disabled?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `size?`: "sm"\|"md"\|"lg" = "md"
- `variant?`: "default"\|"primary"\|"subtle"\|"settings"\|"file"\|"documentation"\|"simple" = "file"
- `value?`: json
- `expanded?`: DynamicStringList
- `selectAction?`: Action
- `weight?`: Weight

## WidgetCell → `VWidgetCell`
Célula de dashboard para KPIs, gráficos, listas e chamadas, com cabeçalho, rodapé e estados.
- `title?`: DynamicString
- `subtitle?`: DynamicString
- `icon?`: IconName
- `variant?`: "chart"\|"stat"\|"list"\|"action"\|"placeholder" = "stat"
- `size?`: "wide"\|"medium"\|"small"\|"large" = "medium"
- `stretch?`: DynamicBoolean = false
- `value?`: DynamicString
- `delta?`: DynamicString
- `trend?`: "neutral"\|"up"\|"down"
- `deltaCaption?`: DynamicString
- `items?`: json
- `description?`: DynamicString
- `actionLabel?`: DynamicString
- `footerLabel?`: DynamicString
- `updatedLabel?`: DynamicString
- `menu?`: DynamicBoolean = false
- `closable?`: DynamicBoolean = false
- `selectable?`: DynamicBoolean = false
- `loading?`: DynamicBoolean = false
- `disabled?`: DynamicBoolean = false
- `selected?`: DynamicBoolean
- `child?`: Child
- `actions?`: ChildList
- `footer?`: ChildList
- `action?`: Action
- `addAction?`: Action
- `dismissAction?`: Action
- `menuAction?`: Action
- `footerAction?`: Action
- `weight?`: Weight

