Preskočiť na obsah
Návrh

vite-plugin-xu

Plugin Vite pri zostavení, ktorý skompiluje jednosúborový komponent .xu do skutočného modulu ES.

@xuda/vite-plugin-xu kompiluje jednosúborové komponenty .xu do modulov ES pri zostavení a vo vývoji ich prenačítava na úrovni úplného opätovného načítania komponentu.

Dnes balík pracovného priestoru, nie inštalácia z npm

@xuda/vite-plugin-xu aj balík @xuda/compiler, na ktorom závisí, majú v package.json"private": true. Na rozdiel od xuda-cli, create-xuda-cli a @xuda/core nie je ani jeden z nich zatiaľ publikovaný na npm. Jediný fungujúci spotrebiteľ v tomto repozitári, examples/hello, ho získava ako závislosť file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Nastavenie

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úci projekt postavený týmto spôsobom: počítadlo, podmienené pripojenie a zoznam s kľúčmi, riadené výlučne obyčajnými funkciami a obyčajnou mutáciou nad úložiskom reactive(), bez signálov, .value či vrstvy zdroja dát viditeľnej v samotnom komponente.

Čím plugin mechanicky je

Jeden hook transform. Predvolené load vo Vite už súbor prečítalo, takže hook dostane zdroj .xu ako text, zavolá @xuda/compiler a vráti vygenerovaný modul. Nie je tu vlastný resolver ani virtuálny modul: .xu zostáva skutočným súborom so skutočnou cestou, vďaka čomu sú stack trace aj graf HMR verné.

enforce: 'pre' je dôležité: bez neho sa k súboru môže dostať vite:esbuild ako prvý a zlyhať na <template>, čo vyzerá, akoby bol súbor pokazený, a nie akoby bolo poradie v reťazci nesprávne. Vite tiež pridáva ?import k importom, ktoré nie sú JS (a ?t=… pri opakovanej požiadavke HMR), takže plugin to pred testom zahrnutia odstráni, inak sa súbor ticho neskompiluje a prehliadač ohlási syntaktickú chybu v súbore, ktorý autor nikdy nenapísal.

HMR

Implementovaná úroveň je úplné opätovné načítanie komponentu: pri úprave sa modul znova vykoná, každá pripojená inštancia komponentu sa odpojí a znova pripojí z nového modulu a stav komponentu sa vynuluje. reactive({ count: 0 }) v <script> sa vráti na 0. Zachovanie stavu sa zámerne nepokúša, pretože po úprave <script> nie je spoľahlivý spôsob, ako zistiť, ktorá polovica starého reaktívneho objektu ešte znamená to isté.

V režime serve plugin pripojí pätičku import.meta.hot.accept. __XUDA_HMR__ nainštaluje createApp v @xuda/core pri prvom pripojení aplikácie, takže plugin nikdy nevkladá import do kódu používateľa. Ak žiadna pripojená aplikácia aktualizovaný komponent nepreberie (nikto ho nezobrazoval alebo stránka ešte nenabootovala), aktualizácia sa vráti k úplnému opätovnému načítaniu stránky, namiesto aby ticho nespravila nič. Produkčné zostavenie nedostane pätičku HMR vôbec.

Možnosti

Blokový dialekt, ktorý kompiluje xuda-cli, nájdete v Jazyk .xu a tam aj v poznámke, ako sa dialekt tohto kompilátora od neho líši.