Vai al contenuto
Bozza

vite-plugin-xu

Un plugin Vite in fase di build che compila un componente a file singolo .xu in un vero modulo ES.

@xuda/vite-plugin-xu compila i componenti a file singolo .xu in moduli ES in fase di build, e li ricarica a caldo in dev a livello di ricaricamento completo del componente.

Oggi è un pacchetto del workspace, non un'installazione npm

@xuda/vite-plugin-xu e il pacchetto @xuda/compiler da cui dipende hanno entrambi "private": true nel loro package.json. A differenza di xuda-cli, create-xuda-cli e @xuda/core, nessuno dei due è ancora pubblicato su npm. L'unico consumatore funzionante in questo repository, examples/hello, lo raggiunge come dipendenza file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Configurazione

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 è un progetto completo e funzionante costruito in questo modo: un contatore, un montaggio condizionale e un elenco con chiavi, guidati interamente da semplici funzioni e semplici mutazioni su uno store reactive(), senza che nel componente stesso sia visibile alcun signal, .value o livello datasource.

Che cos'è il plugin, a livello meccanico

Un solo hook transform. Il load predefinito di Vite ha già letto il file, quindi l'hook riceve il sorgente .xu come testo, chiama @xuda/compiler e restituisce il modulo emesso. Non c'è alcun resolver personalizzato né modulo virtuale: .xu resta un vero file con un vero percorso, il che mantiene onesti gli stack trace e il grafo HMR.

enforce: 'pre' è importante: senza di esso, vite:esbuild può raggiungere il file per primo e fallire su <template>, il che sembra un file rotto invece di un ordine sbagliato della pipeline. Vite aggiunge inoltre ?import agli import non JS (e ?t=… in una nuova richiesta HMR), quindi il plugin lo rimuove prima del proprio test di inclusione, altrimenti il file silenziosamente non viene compilato e il browser segnala un errore di sintassi in un file che l'autore non ha mai scritto.

HMR

Il livello implementato è il ricaricamento completo del componente: alla modifica, il modulo viene rieseguito, ogni istanza montata di quel componente viene smontata e rimontata dal nuovo modulo, e lo stato del componente viene azzerato. Un reactive({ count: 0 }) in <script> torna a 0. La conservazione dello stato non viene tentata di proposito, perché dopo una modifica a <script> non c'è un modo affidabile per sapere quale metà del vecchio oggetto reattivo abbia ancora lo stesso significato.

In modalità serve il plugin aggiunge un footer import.meta.hot.accept. __XUDA_HMR__ viene installato da createApp in @xuda/core la prima volta che un'app viene montata, quindi il plugin non inietta mai un import nel codice dell'utente. Se nessuna app montata rivendica il componente aggiornato (nessuno lo stava mostrando, o la pagina non si è avviata), l'aggiornamento ripiega su un ricaricamento completo della pagina invece di non fare silenziosamente nulla. Una build di produzione non ha alcun footer HMR.

Opzioni

Vedi Il linguaggio .xu per il dialetto a blocchi che xuda-cli compila, e il riquadro lì per come il dialetto di questo compilatore ne differisce.