Hoppa till innehållet
Utkast

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.

Ett arbetsytepaket i dag, ingen npm-installation

@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

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