Μετάβαση στο περιεχόμενο
Πρόχειρο

vite-plugin-xu

Ένα πρόσθετο Vite χρόνου build που μεταγλωττίζει ένα στοιχείο ενός αρχείου .xu σε πραγματικό module ES.

Το @xuda/vite-plugin-xu μεταγλωττίζει στοιχεία ενός αρχείου .xu σε modules ES κατά το build, και τα φορτώνει εκ νέου εν θερμώ στην ανάπτυξη σε επίπεδο πλήρους επαναφόρτωσης στοιχείου.

Πακέτο workspace σήμερα, όχι εγκατάσταση npm

Το @xuda/vite-plugin-xu και το πακέτο @xuda/compiler από το οποίο εξαρτάται φέρουν και τα δύο "private": true στο package.json τους. Σε αντίθεση με τα xuda-cli, create-xuda-cli και @xuda/core, κανένα δεν έχει δημοσιευτεί ακόμη στο npm. Ο μοναδικός λειτουργικός καταναλωτής σε αυτό το αποθετήριο, το examples/hello, το προσεγγίζει ως εξάρτηση file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Ρύθμιση

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 είναι ένα πλήρες λειτουργικό έργο χτισμένο με αυτόν τον τρόπο: ένας μετρητής, μια υπό συνθήκη προσάρτηση και μια λίστα με κλειδιά, που καθοδηγούνται εξ ολοκλήρου από απλές συναρτήσεις και απλή μετάλλαξη πάνω σε ένα store reactive(), χωρίς signals, .value ή επίπεδο πηγής δεδομένων ορατό στο ίδιο το στοιχείο.

Τι είναι μηχανικά το πρόσθετο

Ένα hook transform. Το προεπιλεγμένο load του Vite έχει ήδη διαβάσει το αρχείο, οπότε το hook λαμβάνει τον πηγαίο κώδικα .xu ως κείμενο, καλεί το @xuda/compiler και επιστρέφει το module που εκπέμπεται. Δεν υπάρχει προσαρμοσμένος resolver ούτε εικονικό module: το .xu μένει πραγματικό αρχείο με πραγματική διαδρομή, κάτι που κρατά ειλικρινή τα stack traces και το γράφημα HMR.

Το enforce: 'pre' έχει σημασία: χωρίς αυτό, το vite:esbuild μπορεί να φτάσει πρώτο στο αρχείο και να αποτύχει στο <template>, κάτι που διαβάζεται σαν να είναι χαλασμένο το αρχείο και όχι λάθος η σειρά του pipeline. Το Vite προσθέτει επίσης ?import στις εισαγωγές που δεν είναι JS (και ?t=… σε νέο αίτημα HMR), οπότε το πρόσθετο το αφαιρεί πριν από τον έλεγχο include, αλλιώς το αρχείο δεν μεταγλωττίζεται σιωπηλά και ο browser αναφέρει συντακτικό σφάλμα σε ένα αρχείο που ο συγγραφέας δεν έγραψε ποτέ.

HMR

Το επίπεδο που υλοποιείται είναι η πλήρης επαναφόρτωση στοιχείου: κατά την επεξεργασία, το module εκτελείται ξανά, κάθε προσαρτημένη παρουσία αυτού του στοιχείου αποπροσαρτάται και προσαρτάται ξανά από το νέο module, και η κατάσταση του στοιχείου μηδενίζεται. Ένα reactive({ count: 0 }) στο <script> επιστρέφει στο 0. Η διατήρηση κατάστασης δεν επιχειρείται σκόπιμα, επειδή μετά από επεξεργασία του <script> δεν υπάρχει αξιόπιστος τρόπος να ξέρουμε ποιο μισό του παλιού αντικειμένου reactive σημαίνει ακόμη το ίδιο πράγμα.

Στη λειτουργία serve το πρόσθετο προσθέτει ένα footer import.meta.hot.accept. Το __XUDA_HMR__ εγκαθίσταται από το createApp στο @xuda/core την πρώτη φορά που προσαρτάται μια εφαρμογή, οπότε το πρόσθετο δεν εισάγει ποτέ import στον κώδικα του χρήστη. Αν καμία προσαρτημένη εφαρμογή δεν διεκδικεί το ενημερωμένο στοιχείο (κανείς δεν το εμφάνιζε, ή η σελίδα δεν έχει ξεκινήσει), η ενημέρωση καταλήγει σε πλήρη επαναφόρτωση σελίδας αντί να μην κάνει σιωπηλά τίποτα. Ένα build παραγωγής δεν παίρνει καθόλου footer HMR.

Επιλογές

Δείτε το Η γλώσσα .xu για τη διάλεκτο με blocks που μεταγλωττίζει το xuda-cli, και το callout εκεί για το πώς η διάλεκτος αυτού του compiler διαφέρει από εκείνη.