Guia · Começando
Introdução
O vueui-nova-kit é uma biblioteca de componentes Vue 3 com motion de verdade, temas light/dark por tokens CSS e atenção a acessibilidade. Esta documentação é gerada a partir do código-fonte da lib: descrições, props, eventos, slots e exemplos vêm dos arquivos *.types.ts e *.stories.ts.
npm install vueui-nova-kitGuias
Como ler uma página de componente
- Playground — controles gerados a partir das props tipadas; o snippet de código acompanha os controles e pode ser copiado.
- Exemplos — as stories do Storybook da lib, renderizadas ao vivo, com o código de cada uma.
- Props, Events e Slots — tabelas extraídas dos arquivos
*.types.ts. - Componentes sem stories ou sem tipos têm uma página mínima, sem props inventadas.
Componentes por propósito
Os 103 componentes estão agrupados pelo que fazem na interface, não pela pasta em que vivem na lib. Subcomponentes, como VToolbarButton, aparecem junto do componente pai. Os composables e utilitários ficam num grupo à parte, e os componentes de agentes ganharam uma seção de IA própria.
Fundamentos
4Peças atômicas reutilizadas por todo o resto: ícone, tecla de atalho, badge e tag.
Ações
4 + 4 partesBotões, barras de ferramentas e listas de ações.
Formulários
12Campos de texto, números, senha, código, arquivos e controles booleanos.
Seleção e menus
8Escolher valores (select, datas, cores, segmentos) e menus suspensos.
Navegação
9 + 2 partesAbas, trilhas, paginação, etapas, barras do app e busca de comandos.
Layout e grids
13 + 3 partesShell do app, painéis divididos e grades de conteúdo e dashboard.
Superfícies
6 + 1 partesContainers no fluxo da página: card, painel, seção, inspector, janela e acordeão.
Overlays
6Camadas sobre a página: diálogo, drawer, sheet, popover, tooltip e menu de contexto.
Feedback e status
9 + 2 partesAlertas, toasts, notificações, progresso, carregamento e estados vazios.
- VAlert
- VBanner
- VToast
- VNotificationCenter
- VProgress
- VSpinner
- VSkeleton
- VStatusMark
- + 1 na barra lateral
Dados e tabelas
8Tabelas, filtros, listas de descrição, linha do tempo e quadro kanban.
Gráficos e métricas
5Barras, funil, KPIs e fluxos com métricas.
Mídia e pessoas
2 + 1 partesAvatares, grupos de avatares e galerias de imagens.
IA
4Componentes feitos para interfaces de agentes: prompt, voz, raciocínio e execução de ferramentas.
Composables e utilitários
8Funções use*, springs e gestos. Não são componentes: são lógica reutilizável.