vite-plugin-xu
Plugin Vite při sestavení, který kompiluje jednosouborovou komponentu .xu do skutečného modulu ES.
@xuda/vite-plugin-xu kompiluje jednosouborové komponenty .xu do modulů ES při sestavení
a ve vývoji je znovu načítá za běhu na úrovni úplného znovunačtení komponenty.
@xuda/vite-plugin-xu i balíček @xuda/compiler, na kterém závisí, mají v package.json"private": true. Na rozdíl od xuda-cli, create-xuda-cli a @xuda/core ani jeden zatím není
publikován na npm. Jediný fungující konzument v tomto repozitáři, examples/hello, k němu
přistupuje jako k závislosti file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Nastavení
examples/hello je úplný fungující projekt postavený tímto způsobem: čítač, podmíněné připojení
a seznam s klíči, řízené výhradně obyčejnými funkcemi a obyčejnou mutací nad úložištěm reactive(),
bez signálů, .value nebo vrstvy zdroje dat viditelných v samotné komponentě.
Čím plugin mechanicky je
Jeden háček transform. Výchozí load Vite už soubor přečetl, takže háček dostane zdroj .xu
jako text, zavolá @xuda/compiler a vrátí vygenerovaný modul. Neexistuje žádný vlastní resolver
ani virtuální modul: .xu zůstává skutečným souborem se skutečnou cestou, díky čemuž zůstávají
stopy zásobníku a graf HMR věrohodné.
enforce: 'pre' je důležité: bez něj se k souboru může dostat jako první vite:esbuild a selhat
na <template>, což vypadá, jako by byl soubor rozbitý, a ne jako špatné pořadí v pipeline. Vite
také připojuje ?import k importům jiným než JS (a ?t=… při novém požadavku HMR), proto to
plugin před testem zahrnutí odstraní, jinak se soubor tiše nezkompiluje a prohlížeč ohlásí syntaktickou
chybu v souboru, který autor nikdy nenapsal.
HMR
Implementovanou úrovní je úplné znovunačtení komponenty: při úpravě se modul znovu provede, každá
připojená instance této komponenty se odpojí a znovu připojí z nového modulu a stav komponenty se
vynuluje. reactive({ count: 0 }) v <script> se vrátí na 0. Zachování stavu se záměrně
nezkouší, protože po úpravě <script> nelze spolehlivě poznat, která polovina starého reaktivního
objektu ještě znamená totéž.
V režimu serve plugin připojí patičku import.meta.hot.accept. __XUDA_HMR__ instaluje createApp
v @xuda/core při prvním připojení aplikace, takže plugin nikdy nevkládá import do kódu uživatele.
Pokud aktualizovanou komponentu nenárokuje žádná připojená aplikace (nikdo ji nezobrazoval nebo
stránka ještě nenastartovala), aktualizace přejde na úplné znovunačtení stránky místo toho, aby tiše
neudělala nic. Produkční sestavení nedostane žádnou patičku HMR.
Volby
Blokový dialekt, který kompiluje xuda-cli, a to, jak se dialekt tohoto kompilátoru liší, najdete
v Jazyk .xu a v tamním rámečku.