Saltar al contenido
Borrador

vite-plugin-xu

Un plugin de Vite en tiempo de compilación que compila un componente de archivo único .xu en un módulo ES real.

@xuda/vite-plugin-xu compila componentes de archivo único .xu a módulos ES en tiempo de compilación, y los recarga en caliente en desarrollo al nivel de una recarga completa del componente.

Hoy es un paquete del workspace, no una instalación de npm

@xuda/vite-plugin-xu y el paquete @xuda/compiler del que depende llevan ambos "private": true en su package.json. A diferencia de xuda-cli, create-xuda-cli y @xuda/core, ninguno de los dos está publicado todavía en npm. El único consumidor que funciona en este repositorio, examples/hello, llega a él como una dependencia file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Configuración

js
// vite.config.js
import { defineConfig } from 'vite';
import xu from '@xuda/vite-plugin-xu';

export default defineConfig({ plugins: [xu()] });
js
// src/main.js
import { createApp } from '@xuda/core';
import App from './App.xu';

createApp(App).mount('#app');

examples/hello es un proyecto completo que funciona construido de este modo: un contador, un montaje condicional y una lista con claves, guiados enteramente por funciones simples y mutación simple sobre un almacén reactive(), sin signals, .value ni capa de datasource visibles en el propio componente.

Qué es el plugin, mecánicamente

Un solo gancho transform. El load por defecto de Vite ya leyó el archivo, así que el gancho recibe el código fuente .xu como texto, llama a @xuda/compiler y devuelve el módulo emitido. No hay resolvedor personalizado ni módulo virtual: .xu sigue siendo un archivo real con una ruta real, lo que mantiene fieles las trazas de pila y el grafo de HMR.

enforce: 'pre' importa: sin él, vite:esbuild puede llegar primero al archivo y fallar con <template>, lo que parece que el archivo está roto en lugar de que el orden de la canalización sea el equivocado. Vite también añade ?import a las importaciones que no son JS (y ?t=… en una nueva petición de HMR), así que el plugin lo elimina antes de su prueba de inclusión, o el archivo no se compila en silencio y el navegador informa de un error de sintaxis en un archivo que el autor nunca escribió.

HMR

El nivel implementado es la recarga completa del componente: al editar, el módulo se vuelve a ejecutar, cada instancia montada de ese componente se desmonta y se vuelve a montar desde el módulo nuevo, y el estado del componente se restablece. Un reactive({ count: 0 }) en <script> vuelve a 0. No se intenta a propósito conservar el estado, porque tras una edición de <script> no hay una forma fiable de saber qué mitad del antiguo objeto reactivo sigue significando lo mismo.

En modo serve el plugin añade un pie import.meta.hot.accept. __XUDA_HMR__ lo instala createApp de @xuda/core la primera vez que se monta una app, así que el plugin nunca inyecta una importación en el código del usuario. Si ninguna app montada reclama el componente actualizado (nadie lo estaba mostrando, o la página no ha arrancado), la actualización recurre a una recarga completa de la página en lugar de no hacer nada en silencio. Una compilación de producción no recibe ningún pie de HMR.

Opciones

Consulta El lenguaje .xu para ver el dialecto basado en bloques que compila xuda-cli, y el aviso que allí hay sobre cómo se diferencia de él el dialecto de este compilador.