vite-plugin-xu
Ett Vite-plugin för byggtid som kompilerar en .xu-komponent i en enda fil till en riktig ES-modul.
@xuda/vite-plugin-xu kompilerar .xu-komponenter i en enda fil till ES-moduler vid bygget, och
laddar om dem under utveckling på nivån hel komponentomladdning.
@xuda/vite-plugin-xu och paketet @xuda/compiler som det beror på har båda "private": true
i sin package.json. Till skillnad från xuda-cli, create-xuda-cli och @xuda/core är inget av
dem publicerat på npm än. Den enda fungerande användaren i det här repot, examples/hello, når det
som ett file:-beroende: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Konfigurera
examples/hello är ett komplett fungerande projekt byggt på det här sättet: en räknare, en
villkorlig montering och en nyckelad lista, helt styrda av vanliga funktioner och vanlig mutation över
ett reactive()-lager, utan signaler, .value eller datakällager synliga i själva komponenten.
Vad pluginet är, mekaniskt
En enda transform-hook. Vites standard-load har redan läst filen, så hooken tar emot
.xu-källan som text, anropar @xuda/compiler och returnerar den skapade modulen. Det finns ingen
egen resolver och ingen virtuell modul: .xu förblir en riktig fil med en riktig sökväg, vilket håller
stackspår och HMR-grafen ärliga.
enforce: 'pre' spelar roll: utan det kan vite:esbuild nå filen först och fela på
<template>, vilket ser ut som att filen är trasig snarare än att pipelinens ordning är fel. Vite
lägger också till ?import på icke-JS-importer (och ?t=… vid en HMR-återbegäran), så pluginet tar
bort det före sitt include-test, annars kompileras filen tyst inte och webbläsaren rapporterar ett
syntaxfel i en fil som författaren aldrig skrivit.
HMR
Nivån som är implementerad är hel komponentomladdning: vid en ändring körs modulen om, varje monterad
instans av komponenten avmonteras och monteras om från den nya modulen, och komponentens tillstånd
nollställs. Ett reactive({ count: 0 }) i <script> går tillbaka till 0. Att bevara tillstånd
försöks avsiktligt inte, eftersom det efter en ändring i <script> inte finns något tillförlitligt sätt
att veta vilken hälft av det gamla reaktiva objektet som fortfarande betyder samma sak.
I serve-läge lägger pluginet till en import.meta.hot.accept-fotnot. __XUDA_HMR__ installeras av
createApp i @xuda/core första gången en app monteras, så pluginet injicerar aldrig en import i
användarkod. Om ingen monterad app gör anspråk på den uppdaterade komponenten (ingen visade den, eller
sidan har inte startat) faller uppdateringen tillbaka på en full omladdning av sidan i stället för att
tyst inte göra något. Ett produktionsbygge får ingen HMR-fotnot alls.
Alternativ
Se .xu-språket för den blockbaserade dialekt som xuda-cli kompilerar,
och informationsrutan där för hur den här kompilatorns dialekt skiljer sig från den.