@vunojs/vite

@vunojs/vite

Integración de Vuno con Vite. Convierte un VunoContext resuelto por @vunojs/core en configuración del bundler, módulos virtuales y archivos preparados para la aplicación.

¿Tengo que instalarlo?

Normalmente no. Llega mediante @vunojs/cli; una aplicación ejecuta vuno dev, vuno build, vuno preview o vuno prepare y no crea el plugin manualmente. Si desarrollas una integración de tooling propia dentro del workspace, declara @vunojs/vite y @vunojs/core como dependencias directas y usa sus entradas públicas, no src/modules/*.

Qué prepara y cuándo

• En prepare, descubre páginas, layouts, componentes, composables, API, RPC y middleware; escribe tipos y autoimports bajo app/.vuno/.
• En dev, sirve módulos virtuales y entradas Vue, observa archivos y aplica HMR. Si typescript.typeCheck está activo, conecta el checker de vue-tsc y su overlay al cliente.
• En build, construye cliente y servidor, calcula decisiones de renderizado, prerenderiza las rutas configuradas y escribe manifiestos de render y recursos.
• En preview, sirve el resultado construido; un HMR correcto no demuestra que el build o SSR funcionen, así que verifica ambos flujos por separado.

API pública

vuno(context, target) crea el plugin y createViteConfig(context, target) crea la configuración Vite completa; target distingue el build client del server. Ambas esperan un VunoContext resuelto, no el objeto crudo de vuno.config.ts. Es todo lo que exporta la entrada principal, junto al tipo VunoBuildTarget. La preparación de tipos, el prerenderizado y el análisis de renderizado que usa la CLI viven en @vunojs/vite/internal, el contrato entre paquetes de Vuno: no es API pública y puede cambiar en cualquier versión.

Los contratos de configuración pertenecen a @vunojs/core; este paquete los ejecuta, no los redefine. No edites los módulos virtuales ni los archivos de app/.vuno/: modifica la página, módulo o configuración que los produce y vuelve a ejecutar vuno prepare si necesitas refrescar los tipos del editor.

Consulta la documentación, la configuración y defineModule. Para una aplicación nueva, empieza por pnpm create vuno my-app en lugar de montar Vite a mano: createViteConfig también fija lo que un vite.config propio olvidaría (los alias ~, #shared y #vuno/styled-system, Panda CSS y la exclusión de @vunojs/core/client de optimizeDeps, que evita duplicar su estado).