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