---
name: ui-nova-vue
description: Usar a biblioteca vueui-nova-kit (componentes V*) em apps Vue 3 ou Nuxt. Use ao instalar a lib, importar componentes, montar telas, formulários, tabelas ou layouts em projetos que dependem de vueui-nova-kit, ou quando o usuário mencionar ui-nova, Nova kit ou componentes VButton/VCard/VSelect.
---

# ui-nova em apps Vue/Nuxt

> `references/components.md` é **gerado** por
> `scripts/gen-skill-refs.mjs`: não edite à mão.

## Regras inegociáveis

1. **Reuso obrigatório.** Antes de escrever qualquer componente, procure em
   `references/components.md`. Se existe um `V*` que resolve (sozinho ou composto), use-o. Para
   decidir entre parecidos, use a skill `ui-nova-escolher-componente`.
2. **Sem estilos soltos.** Nada de hex/rgb/px mágicos: só tokens `--v-*` (skill `ui-nova-tema-tokens`).
3. **Props e eventos reais.** Use só as props, eventos e slots listados na referência. Se algo não
   está lá, não existe.
4. **A11y vem pronta, mas tem entradas.** Preencha `label`/`ariaLabel` quando a referência pedir
   (skill `ui-nova-a11y`).

## Instalação

```bash
pnpm add vueui-nova-kit      # peer: vue ^3.3
```

```ts
// main.ts (Vue + Vite)
import { createApp } from 'vue'
import 'vueui-nova-kit/style.css'          // uma única vez
import App from './App.vue'
createApp(App).mount('#app')
```

Importe por componente (melhor para tree-shaking):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VSelect } from 'vueui-nova-kit'
const plano = ref('pro')
</script>

<template>
  <VSelect v-model="plano" label="Plano" :options="[{ value: 'pro', label: 'Pro' }]" />
  <VButton variant="primary">Assinar</VButton>
</template>
```

Exports do pacote: `vueui-nova-kit` (componentes, composables, motion, tokens vivos),
`vueui-nova-kit/tokens` (tokens em JS), `vueui-nova-kit/tokens.css` (só as variáveis) e
`vueui-nova-kit/style.css`.

## Nuxt 4

Use um plugin que registra os `V*` globalmente (é o padrão da doc oficial, `app/plugins/nova.ts`) e
importe o CSS em `nuxt.config.ts` (`css: ['vueui-nova-kit/style.css']`).

**SSR:** alguns componentes (ex.: `VSegmentedControl` via `useSpringValue`) chamam
`requestAnimationFrame` no setup. Em SSR, registre um plugin `enforce: 'pre'` que cria um stub
inerte de `requestAnimationFrame`/`cancelAnimationFrame` no servidor. A doc usa
`app/plugins/0.raf-shim.server.ts`.

## Tema

`<html data-theme="light|dark|system">`, ou `.v-theme-dark` numa subárvore. Em runtime use
`useTheme()` (`setTheme`, `toggleTheme`, `resolvedTheme`). Detalhes estão em `ui-nova-tema-tokens`.

## Fluxo de trabalho

1. Liste as necessidades da tela (entrada, exibição, feedback, layout).
2. Para cada uma, ache o `V*` em `references/components.md` (busque por categoria/descrição).
3. Confira props obrigatórias, `v-model` (quase todo input usa `modelValue`) e eventos.
4. Componha. Nunca envolva um `V*` só para mudar estilo; use variantes e props.
5. Rode `vue-tsc`: os tipos da lib pegam prop errada.

## Arquivos

- `references/components.md`: **gerado**. Todos os componentes com descrição, props (tipo, default,
  valores), eventos e slots.
