@vunojs/core

@vunojs/core

Runtime, configuración y contratos tipados del framework Vuno. Es agnóstico del bundler: @vunojs/vite convierte estos contratos en rutas, módulos virtuales y builds, y @vunojs/cli ofrece los comandos de aplicación.

Instalación y primer uso

Una aplicación nueva se crea con pnpm create vuno my-app, que declara las dependencias compatibles. En una aplicación existente:

pnpm add vue vue-router
pnpm add -D @vunojs/core @vunojs/cli

Dentro del monorepo de Vuno, una aplicación del workspace usa pnpm --filter my-app add -D '@vunojs/core@workspace:*'.

Configura Vuno en vuno.config.ts y ejecuta pnpm exec vuno prepare para generar los tipos de esa aplicación:

import { defineConfig } from '@vunojs/core/config'

export default defineConfig({
	app: { title: 'Mi aplicación' },
})

El código que corre en app/ puede usar los autoimports preparados por Vuno, o importar explícitamente desde @vunojs/core/client. El código de server/ usa los contratos de servidor; no importes @vunojs/core/server en una página o componente que llegue al navegador.

Entradas públicas

Elige la entrada más estrecha que corresponda. Las entradas entry/client, internal y virtual sirven a la integración del framework; una aplicación no tiene que importarlas. src/public-api.test.ts fija lo que exporta cada entrada.

Elegir la API adecuada

• Para datos o estado de una página, usa useAsyncData, useFetch, useState o useRuntimeConfig desde la entrada cliente. El runtime separa el estado por petición SSR y lo hidrata en el navegador; consulta useAsyncData.
• Para rutas y SEO, usa definePage, useHead y useSeoMeta; los tipos de rutas se generan a partir de app/pages/. Consulta enrutamiento.
• Para endpoints, usa defineApi en server/api/; para procedimientos tipados, defineQuery o defineMutation en server/rpc/. Consulta defineRpc.
• Para ampliar Vuno con autoimports, componentes, CSS o plugins, usa defineModule y el kit limitado de @vunojs/core/module. Consulta defineModule.

No edites los archivos de .vuno/ a mano: son artefactos regenerables de la aplicación. La documentación y la referencia de configuración detallan las convenciones y opciones completas.