Aller au contenu
Brouillon

vite-plugin-xu

Un plugin Vite à la construction qui compile un composant monofichier .xu en un vrai module ES.

@xuda/vite-plugin-xu compile les composants monofichiers .xu en modules ES à la construction, et les recharge à chaud en développement au niveau d'un rechargement complet du composant.

Un paquet d'espace de travail aujourd'hui, pas une installation npm

@xuda/vite-plugin-xu et le paquet @xuda/compiler dont il dépend portent tous deux "private": true dans leur package.json. Contrairement à xuda-cli, create-xuda-cli et @xuda/core, aucun des deux n'est encore publié sur npm. Le seul consommateur fonctionnel dans ce dépôt, examples/hello, l'obtient comme dépendance file: : "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Configuration

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 est un projet complet fonctionnel construit de cette façon : un compteur, un montage conditionnel et une liste à clés, entièrement pilotés par de simples fonctions et de simples mutations sur un store reactive(), sans signaux, sans .value ni couche de source de données visible dans le composant lui-même.

Ce qu'est le plugin, mécaniquement

Un seul hook transform. Le load par défaut de Vite a déjà lu le fichier, donc le hook reçoit la source .xu sous forme de texte, appelle @xuda/compiler et renvoie le module émis. Il n'y a ni résolveur personnalisé ni module virtuel : .xu reste un vrai fichier avec un vrai chemin, ce qui garde honnêtes les traces de pile et le graphe HMR.

enforce: 'pre' est important : sans lui, vite:esbuild peut atteindre le fichier le premier et échouer sur <template>, ce qui se lit comme un fichier cassé plutôt que comme un mauvais ordre du pipeline. Vite ajoute aussi ?import aux imports non JS (et ?t=… pour une nouvelle requête HMR), donc le plugin le retire avant son test d'inclusion, sinon le fichier n'est silencieusement pas compilé et le navigateur signale une erreur de syntaxe dans un fichier que l'auteur n'a jamais écrit.

HMR

Le niveau implémenté est le rechargement complet du composant : à la modification, le module se ré-exécute, chaque instance montée de ce composant se démonte et se remonte depuis le nouveau module, et l'état du composant est réinitialisé. Un reactive({ count: 0 }) dans <script> revient à 0. La préservation de l'état n'est volontairement pas tentée, car après une modification de <script> il n'existe aucun moyen fiable de savoir quelle moitié de l'ancien objet réactif signifie encore la même chose.

En mode serve, le plugin ajoute un pied import.meta.hot.accept. __XUDA_HMR__ est installé par createApp dans @xuda/core la première fois qu'une app se monte, donc le plugin n'injecte jamais d'import dans le code utilisateur. Si aucune app montée ne revendique le composant mis à jour (personne ne l'affichait, ou la page n'a pas démarré), la mise à jour retombe sur un rechargement complet de la page au lieu de ne rien faire silencieusement. Un build de production ne reçoit aucun pied HMR.

Options

Voir Le langage .xu pour le dialecte à blocs que compile xuda-cli, et l'encadré qui s'y trouve pour la façon dont le dialecte de ce compilateur en diffère.