Sari la conținut
Ciornă

vite-plugin-xu

Un plugin Vite la momentul build-ului, care compilează o componentă single-file .xu într-un modul ES real.

@xuda/vite-plugin-xu compilează componentele single-file .xu în module ES la momentul build-ului și le reîncarcă la cald în dev, la nivelul unei reîncărcări complete a componentei.

Astăzi este un pachet de workspace, nu o instalare npm

@xuda/vite-plugin-xu și pachetul @xuda/compiler de care depinde poartă amândouă "private": true în package.json. Spre deosebire de xuda-cli, create-xuda-cli și @xuda/core, niciunul nu este publicat încă pe npm. Singurul consumator funcțional din acest repository, examples/hello, îl folosește ca dependență file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Configurare

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 este un proiect complet funcțional construit astfel: un contor, o montare condițională și o listă cu chei, conduse în întregime de funcții simple și mutare simplă peste un store reactive(), fără semnale, .value sau strat de surse de date vizibil în componenta însăși.

Ce este plugin-ul, mecanic

Un singur hook transform. load-ul implicit al Vite a citit deja fișierul, așa că hook-ul primește sursa .xu ca text, apelează @xuda/compiler și returnează modulul emis. Nu există un resolver personalizat și nici un modul virtual: .xu rămâne un fișier real cu o cale reală, ceea ce păstrează corecte stack trace-urile și graful HMR.

enforce: 'pre' contează: fără el, vite:esbuild poate ajunge primul la fișier și eșuează la <template>, ceea ce pare un fișier stricat, nu o ordine greșită a pipeline-ului. Vite adaugă și ?import la importurile care nu sunt JS (și ?t=… la o recerere HMR), așa că plugin-ul elimină asta înainte de testul de includere, altfel fișierul nu este compilat în tăcere, iar browserul raportează o eroare de sintaxă într-un fișier pe care autorul nu l-a scris niciodată.

HMR

Nivelul implementat este reîncărcarea completă a componentei: la o editare, modulul se reexecută, fiecare instanță montată a acelei componente se demontează și se remontează din noul modul, iar starea componentei se resetează. Un reactive({ count: 0 }) din <script> revine la 0. Păstrarea stării nu este încercată în mod deliberat, pentru că după o editare a lui <script> nu există o cale sigură de a ști care jumătate din vechiul obiect reactiv înseamnă încă același lucru.

În modul serve, plugin-ul adaugă un footer import.meta.hot.accept. __XUDA_HMR__ este instalat de createApp din @xuda/core prima dată când o aplicație se montează, deci plugin-ul nu injectează niciodată un import în codul utilizatorului. Dacă nicio aplicație montată nu revendică componenta actualizată (nimeni nu o afișa sau pagina nu a pornit încă), actualizarea revine la o reîncărcare completă a paginii, în loc să nu facă nimic în tăcere. Un build de producție nu primește deloc footer HMR.

Opțiuni

Vezi Limbajul .xu pentru dialectul pe blocuri pe care îl compilează xuda-cli și nota de acolo despre cum diferă dialectul acestui compilator de el.