Naar de inhoud springen
Concept

vite-plugin-xu

Een Vite-plugin voor buildtijd die een .xu-single-file-component compileert tot een echte ES-module.

@xuda/vite-plugin-xu compileert .xu-single-file-componenten tijdens de build tot ES-modules en herlaadt ze in dev met hot reload op het niveau van een volledige componentreload.

Nu een workspacepakket, geen npm-installatie

@xuda/vite-plugin-xu en het pakket @xuda/compiler waarvan hij afhangt, hebben allebei "private": true in hun package.json. In tegenstelling tot xuda-cli, create-xuda-cli en @xuda/core is geen van beide al op npm gepubliceerd. De enige werkende gebruiker in deze repository, examples/hello, gebruikt hem als file:-dependency: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Instellen

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 is een volledig werkend project dat op deze manier is gebouwd: een teller, een voorwaardelijke mount en een lijst met sleutels, volledig aangestuurd door gewone functies en gewone mutatie op een reactive()-store, zonder dat signals, .value of een datasource-laag zichtbaar zijn in de component zelf.

Wat de plugin mechanisch is

Eén transform-hook. De standaard load van Vite heeft het bestand al gelezen, dus de hook ontvangt de .xu-bron als tekst, roept @xuda/compiler aan en geeft de uitgegeven module terug. Er is geen eigen resolver en geen virtuele module: .xu blijft een echt bestand met een echt pad, wat stacktraces en de HMR-graaf eerlijk houdt.

enforce: 'pre' doet ertoe: zonder dit kan vite:esbuild het bestand eerder bereiken en falen op <template>, wat eruitziet als een kapot bestand in plaats van een verkeerde pipeline-volgorde. Vite voegt ook ?import toe aan niet-JS-imports (en ?t=… bij een HMR-herverzoek), dus de plugin haalt dat weg voor zijn include-test, anders wordt het bestand stilletjes niet gecompileerd en meldt de browser een syntaxfout in een bestand dat de auteur nooit heeft geschreven.

HMR

Het geïmplementeerde niveau is een volledige componentreload: bij een wijziging wordt de module opnieuw uitgevoerd, elke gemounte instantie van die component wordt ontmount en opnieuw gemount vanuit de nieuwe module, en de componentstate wordt gereset. Een reactive({ count: 0 }) in <script> gaat terug naar 0. State behouden wordt bewust niet geprobeerd, omdat er na een wijziging in <script> geen betrouwbare manier is om te weten welke helft van het oude reactieve object nog hetzelfde betekent.

In serve-modus voegt de plugin een import.meta.hot.accept-footer toe. __XUDA_HMR__ wordt door createApp in @xuda/core geïnstalleerd de eerste keer dat een app mount, dus de plugin injecteert nooit een import in gebruikerscode. Als geen gemounte app de bijgewerkte component claimt (niemand toonde hem, of de pagina is nog niet opgestart), valt de update terug op een volledige paginareload in plaats van stilletjes niets te doen. Een productiebuild krijgt helemaal geen HMR-footer.

Opties

Zie De .xu-taal voor het blokgebaseerde dialect dat xuda-cli compileert, en de callout daar voor hoe het dialect van deze compiler daarvan verschilt.