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.

103componentes implementados
8composables e utilitários
14grupos por propósito
v1.0.0versão da lib
Terminal
npm install vueui-nova-kit

Guias

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

4

Peças atômicas reutilizadas por todo o resto: ícone, tecla de atalho, badge e tag.

Ações

4 + 4 partes

Botões, barras de ferramentas e listas de ações.

Formulários

12

Campos de texto, números, senha, código, arquivos e controles booleanos.

Seleção e menus

8

Escolher valores (select, datas, cores, segmentos) e menus suspensos.

Navegação

9 + 2 partes

Abas, trilhas, paginação, etapas, barras do app e busca de comandos.

Layout e grids

13 + 3 partes

Shell do app, painéis divididos e grades de conteúdo e dashboard.

Superfícies

6 + 1 partes

Containers no fluxo da página: card, painel, seção, inspector, janela e acordeão.

Overlays

6

Camadas sobre a página: diálogo, drawer, sheet, popover, tooltip e menu de contexto.

Feedback e status

9 + 2 partes

Alertas, toasts, notificações, progresso, carregamento e estados vazios.

Dados e tabelas

8

Tabelas, filtros, listas de descrição, linha do tempo e quadro kanban.

Gráficos e métricas

5

Barras, funil, KPIs e fluxos com métricas.

Mídia e pessoas

2 + 1 partes

Avatares, grupos de avatares e galerias de imagens.

IA

4

Componentes feitos para interfaces de agentes: prompt, voz, raciocínio e execução de ferramentas.

Composables e utilitários

8

Funções use*, springs e gestos. Não são componentes: são lógica reutilizável.