Hopp til innholdet
Utkast

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.

En arbeidsområdepakke i dag, ikke en npm-installasjon

@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

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