Přeskočit na obsah
Koncept

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.

Dnes balíček pracovního prostoru, ne instalace z npm

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

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