vite-plugin-xu
Ein Vite-Plugin zur Build-Zeit, das eine .xu-Single-File-Komponente zu einem echten ES-Modul kompiliert.
@xuda/vite-plugin-xu kompiliert .xu-Single-File-Komponenten zur Build-Zeit zu ES-Modulen und lädt sie in Dev auf der Ebene eines vollständigen Komponenten-Neuladens heiß nach.
@xuda/vite-plugin-xu und das Paket @xuda/compiler, von dem es abhängt, tragen beide "private": true in ihrer package.json. Anders als xuda-cli, create-xuda-cli und @xuda/core ist keines davon bisher auf npm veröffentlicht. Der eine funktionierende Konsument in diesem Repository, examples/hello, erreicht es als file:-Abhängigkeit: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
Einrichtung
examples/hello ist ein vollständiges, auf diese Weise gebautes Projekt: ein Zähler, ein bedingtes Einhängen und eine Liste mit Schlüsseln, ganz gesteuert von einfachen Funktionen und einfacher Mutation über einen reactive()-Store, ohne dass Signals, .value oder eine Datasource-Schicht in der Komponente selbst sichtbar wären.
Was das Plugin mechanisch ist
Ein transform-Hook. Das Standard-load von Vite hat die Datei bereits gelesen, der Hook erhält den .xu-Quelltext also als Text, ruft @xuda/compiler auf und gibt das ausgegebene Modul zurück. Es gibt keinen eigenen Resolver und kein virtuelles Modul: .xu bleibt eine echte Datei mit einem echten Pfad, was Stacktraces und den HMR-Graphen ehrlich hält.
enforce: 'pre' ist wichtig: Ohne es kann vite:esbuild die Datei zuerst erreichen und an <template> scheitern, was wirkt, als sei die Datei kaputt, statt dass die Pipeline-Reihenfolge falsch wäre. Vite hängt außerdem ?import an Nicht-JS-Importe an (und ?t=… bei einer erneuten HMR-Anfrage), das Plugin entfernt das also vor seinem Include-Test, sonst wird die Datei stillschweigend nicht kompiliert, und der Browser meldet einen Syntaxfehler in einer Datei, die der Autor nie geschrieben hat.
HMR
Die umgesetzte Stufe ist das vollständige Neuladen der Komponente: Bei einer Änderung wird das Modul neu ausgeführt, jede eingehängte Instanz dieser Komponente wird ausgehängt und aus dem neuen Modul neu eingehängt, und der Komponentenzustand wird zurückgesetzt. Ein reactive({ count: 0 }) in <script> geht zurück auf 0. Zustandserhalt wird bewusst nicht versucht, denn nach einer Änderung an <script> gibt es keinen verlässlichen Weg zu wissen, welche Hälfte des alten reaktiven Objekts noch dasselbe bedeutet.
Im Serve-Modus hängt das Plugin einen import.meta.hot.accept-Footer an. __XUDA_HMR__ wird von createApp in @xuda/core installiert, wenn eine App zum ersten Mal eingehängt wird, das Plugin fügt also nie einen Import in Nutzercode ein. Beansprucht keine eingehängte App die aktualisierte Komponente (niemand hat sie angezeigt, oder die Seite ist noch nicht gestartet), fällt das Update auf ein vollständiges Neuladen der Seite zurück, statt stillschweigend nichts zu tun. Ein Produktions-Build erhält überhaupt keinen HMR-Footer.
Optionen
Siehe Die .xu-Sprache für den blockbasierten Dialekt, den xuda-cli kompiliert, und den dortigen Hinweis dazu, wie sich der Dialekt dieses Compilers davon unterscheidet.