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.
@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
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.