vite-plugin-xu
En Vite-plugin på byggetidspunktet som kompilerer en .xu-enkeltfilkomponent til en ekte ES-modul.
@xuda/vite-plugin-xu kompilerer .xu-enkeltfilkomponenter til ES-moduler ved bygging, og
laster dem på nytt i dev på nivå med en full komponentinnlasting.
@xuda/vite-plugin-xu og @xuda/compiler-pakken den avhenger av har begge "private": true i
package.json. I motsetning til xuda-cli, create-xuda-cli og @xuda/core er ingen av dem
publisert til npm ennå. Den ene fungerende brukeren i dette repoet, examples/hello, henter den
som en file:-avhengighet: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Oppsett
examples/hello er et fullt fungerende prosjekt bygget på denne måten: en teller, en betinget
montering og en nøklet liste, drevet helt av vanlige funksjoner og vanlig mutasjon over en
reactive()-lagring, uten signaler, .value eller datakildelag synlig i selve komponenten.
Hva pluginen er, mekanisk
Én transform-hook. Vites standard load har allerede lest filen, så hooken får .xu-kilden som
tekst, kaller @xuda/compiler og returnerer modulen som sendes ut. Det finnes ingen egen resolver
og ingen virtuell modul: .xu forblir en ekte fil med en ekte sti, som holder stack traces og
HMR-grafen ærlige.
enforce: 'pre' er viktig: uten den kan vite:esbuild nå filen først og feile på <template>, noe
som ser ut som at filen er ødelagt i stedet for at rekkefølgen i pipelinen er feil. Vite legger
dessuten ?import på import av ikke-JS-filer (og ?t=… ved en ny HMR-forespørsel), så pluginen
fjerner det før include-testen, ellers blir filen stille ikke kompilert, og nettleseren melder en
syntaksfeil i en fil forfatteren aldri har skrevet.
HMR
Nivået som er implementert er full komponentinnlasting på nytt: ved en redigering kjøres modulen
på nytt, hver monterte instans av komponenten avmonteres og monteres på nytt fra den nye modulen, og
komponenttilstanden nullstilles. En reactive({ count: 0 }) i <script> går tilbake til 0. Det
forsøkes bevisst ikke å bevare tilstand, fordi det etter en redigering av <script> ikke finnes noen
pålitelig måte å vite hvilken halvdel av det gamle reaktive objektet som fortsatt betyr det samme.
I serve-modus legger pluginen på en import.meta.hot.accept-fotdel. __XUDA_HMR__ installeres av
createApp i @xuda/core første gang en app monteres, så pluginen setter aldri inn en import i
brukerkode. Hvis ingen montert app gjør krav på den oppdaterte komponenten (ingen viste den, eller
siden er ikke startet), faller oppdateringen tilbake til en full sideinnlasting i stedet for å stille
ikke gjøre noe. Et produksjonsbygg får ingen HMR-fotdel i det hele tatt.
Valg
Se Xu-språket for den blokkbaserte dialekten xuda-cli kompilerer, og
callouten der for hvordan denne kompilatorens dialekt skiller seg fra den.