Gå til indhold
Kladde

vite-plugin-xu

Et Vite-plugin på build-tidspunktet, der kompilerer en .xu-enkeltfilkomponent til et rigtigt ES-modul.

@xuda/vite-plugin-xu kompilerer .xu-enkeltfilkomponenter til ES-moduler på build-tidspunktet og hot-reloader dem i udvikling på niveau med en fuld komponentgenindlæsning.

En workspace-pakke i dag, ikke en npm-installation

@xuda/vite-plugin-xu og pakken @xuda/compiler, den afhænger af, har begge "private": true i deres package.json. I modsætning til xuda-cli, create-xuda-cli og @xuda/core er ingen af dem udgivet på npm endnu. Den ene fungerende bruger i dette repositorium, examples/hello, når den som en file:-afhængighed: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Opsætning

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 er et fuldt fungerende projekt bygget på denne måde: en tæller, en betinget montering og en liste med nøgler, drevet udelukkende af almindelige funktioner og almindelig mutation over et reactive()-lager, uden signaler, .value eller datakildelag synligt i selve komponenten.

Hvad pluginet er, mekanisk

Én transform-hook. Vites standard-load har allerede læst filen, så hooken modtager .xu-kilden som tekst, kalder @xuda/compiler og returnerer det udsendte modul. Der er ingen egen resolver og intet virtuelt modul: .xu forbliver en rigtig fil med en rigtig sti, hvilket holder stakspor og HMR-grafen ærlige.

enforce: 'pre' har betydning: uden den kan vite:esbuild nå filen først og fejle på <template>, hvilket ser ud, som om filen er i stykker, i stedet for at rækkefølgen i pipelinen er forkert. Vite tilføjer også ?import til ikke-JS-importer (og ?t=… ved en ny HMR-forespørgsel), så pluginet fjerner det, før det tester include, ellers bliver filen stille og roligt ikke kompileret, og browseren rapporterer en syntaksfejl i en fil, forfatteren aldrig har skrevet.

HMR

Det implementerede niveau er fuld komponentgenindlæsning: ved en ændring køres modulet igen, hver monteret instans af komponenten afmonteres og monteres igen fra det nye modul, og komponentens tilstand nulstilles. Et reactive({ count: 0 }) i <script> går tilbage til 0. Bevarelse af tilstand forsøges bevidst ikke, for efter en ændring af <script> er der ingen pålidelig måde at vide, hvilken halvdel af det gamle reaktive objekt der stadig betyder det samme.

I serve-tilstand tilføjer pluginet en import.meta.hot.accept-fod. __XUDA_HMR__ installeres af createApp i @xuda/core, første gang en app monteres, så pluginet aldrig indsætter en import i brugerkode. Hvis ingen monteret app gør krav på den opdaterede komponent (ingen viste den, eller siden er ikke startet), falder opdateringen tilbage til en fuld sidegenindlæsning i stedet for stille at gøre ingenting. Et produktionsbuild får slet ingen HMR-fod.

Indstillinger

Se .xu-sproget for den blokbaserede dialekt, xuda-cli kompilerer, og boksen der for, hvordan denne kompilers dialekt adskiller sig fra den.