vite-plugin-xu
Een Vite-plugin voor buildtijd die een .xu-single-file-component compileert tot een echte ES-module.
@xuda/vite-plugin-xu compileert .xu-single-file-componenten tijdens de build tot
ES-modules en herlaadt ze in dev met hot reload op het niveau van een volledige componentreload.
@xuda/vite-plugin-xu en het pakket @xuda/compiler waarvan hij afhangt, hebben allebei
"private": true in hun package.json. In tegenstelling tot xuda-cli, create-xuda-cli en
@xuda/core is geen van beide al op npm gepubliceerd. De enige werkende gebruiker in deze
repository, examples/hello, gebruikt hem als file:-dependency:
"@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Instellen
examples/hello is een volledig werkend project dat op deze manier is gebouwd: een teller, een
voorwaardelijke mount en een lijst met sleutels, volledig aangestuurd door gewone functies en
gewone mutatie op een reactive()-store, zonder dat signals, .value of een datasource-laag
zichtbaar zijn in de component zelf.
Wat de plugin mechanisch is
Eén transform-hook. De standaard load van Vite heeft het bestand al gelezen, dus de hook
ontvangt de .xu-bron als tekst, roept @xuda/compiler aan en geeft de uitgegeven module terug.
Er is geen eigen resolver en geen virtuele module: .xu blijft een echt bestand met een echt pad,
wat stacktraces en de HMR-graaf eerlijk houdt.
enforce: 'pre' doet ertoe: zonder dit kan vite:esbuild het bestand eerder bereiken en falen op
<template>, wat eruitziet als een kapot bestand in plaats van een verkeerde pipeline-volgorde.
Vite voegt ook ?import toe aan niet-JS-imports (en ?t=… bij een HMR-herverzoek), dus de plugin
haalt dat weg voor zijn include-test, anders wordt het bestand stilletjes niet gecompileerd en
meldt de browser een syntaxfout in een bestand dat de auteur nooit heeft geschreven.
HMR
Het geïmplementeerde niveau is een volledige componentreload: bij een wijziging wordt de module
opnieuw uitgevoerd, elke gemounte instantie van die component wordt ontmount en opnieuw gemount
vanuit de nieuwe module, en de componentstate wordt gereset. Een reactive({ count: 0 }) in
<script> gaat terug naar 0. State behouden wordt bewust niet geprobeerd, omdat er na een
wijziging in <script> geen betrouwbare manier is om te weten welke helft van het oude reactieve
object nog hetzelfde betekent.
In serve-modus voegt de plugin een import.meta.hot.accept-footer toe. __XUDA_HMR__ wordt door
createApp in @xuda/core geïnstalleerd de eerste keer dat een app mount, dus de plugin injecteert
nooit een import in gebruikerscode. Als geen gemounte app de bijgewerkte component claimt (niemand
toonde hem, of de pagina is nog niet opgestart), valt de update terug op een volledige paginareload
in plaats van stilletjes niets te doen. Een productiebuild krijgt helemaal geen HMR-footer.
Opties
Zie De .xu-taal voor het blokgebaseerde dialect dat xuda-cli
compileert, en de callout daar voor hoe het dialect van deze compiler daarvan verschilt.