@xuda/core
Η αντιδραστική μηχανή χωρίς εξαρτήσεις πάνω στην οποία προσαρτώνται η πλατφόρμα, ο compiler και οι εφαρμογές επίδειξης.
Το @xuda/core είναι η αντιδραστική μηχανή του Xuda (signals, scheduler, διαφορά λίστας με κλειδιά, αντιδραστικός renderer,
router) ως πακέτο ESM χωρίς εξαρτήσεις. Δεν διαβάζει ούτε γράφει καθολικές μεταβλητές κατά την εισαγωγή: κανένα func, κανένα
SESSION_OBJ, κανένα window, κανένα document.
Το package.json του @xuda/core φέρει "private": false. Είναι το μόνο πακέτο από τα τρία που
καλύπτονται σε αυτή την ενότητα (μαζί με τα @xuda/compiler και @xuda/vite-plugin-xu, και τα δύο private: true)
που έχει φτιαχτεί για να χρησιμοποιείται ως εξάρτηση εκτός αυτού του αποθετηρίου.
Δεν είναι επίσης ξεχωριστή μηχανή από αυτήν που ήδη διανέμει η πλατφόρμα: το δικό του
script build:globals (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) είναι ο τρόπος με τον οποίο χτίζεται το runtime/js/xuda_core.globals.js, το δικό της
bundle αντιδραστικού renderer που διανέμει η πλατφόρμα.
Η αντιδραστική επιφάνεια
Υπάρχει ένα γράφημα εξαρτήσεων, ένα δέντρο ιδιοκτητών, ένας buffer batch και ένας scheduler κάτω από
όλα: μια ανάγνωση ref μέσα σε ένα effect() παρακολουθείται και το εκτελεί ξανά, όπως ακριβώς μια ανάγνωση signal μέσα σε ένα
watch(). Το computed εδώ δέχεται έναν getter, ή ένα ζεύγος { get, set } για εγγράψιμο computed.
Το effectScope() απαντά στο "ποιος το αποδεσμεύει": ένας ονομασμένος ιδιοκτήτης που μπορείτε να περάσετε παντού, να φωλιάσετε και να σταματήσετε με μία
κλήση, αντί να φτιάχνετε με το χέρι μια σακούλα από disposers.
Ένα στοιχείο που δημιουργείται μέσω createApp() κατέχει ήδη ένα τέτοιο: το <script> του εκτελείται
μέσα στο δικό του αποσπασμένο scope του στοιχείου, οπότε ένα effect που γράφεται εκεί αποδεσμεύεται αυτόματα όταν
το στοιχείο αποπροσαρτάται.
Το πρωτογενές χαμηλού επιπέδου
Το signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) και το
signalComputed είναι τα δικά της κελιά της μηχανής κάτω από τα ref και computed. Εξάγονται και
υποστηρίζονται πλήρως, δεν έχουν αφαιρεθεί, επειδή ο renderer και η γέφυρα legacy είναι χτισμένοι πάνω τους, και
επειδή το signal.notify(), που εκτελεί ξανά συνδρομητές χωρίς αλλαγή τιμής, δεν έχει ισοδύναμο στο ref.
Ο κώδικας εφαρμογής πρέπει να καταφεύγει στα ref και computed· αυτά τα δύο ονόματα τεκμηριώνονται ως
το επίπεδο από κάτω, δεν έχουν καταργηθεί στην εκτέλεση (μια προειδοποίηση στο signal() θα εκπεμπόταν ανά scope γραμμής και ανά
παράμετρο panel, χιλιάδες φορές ανά οθόνη, για κώδικα που κάνει ακριβώς το σωστό σε αυτό το επίπεδο).
Το σημείο εισόδου της εφαρμογής
Το App είναι ένα μεταγλωττισμένο module .xu, που παράγεται από το @xuda/compiler ή από το
βήμα build vite-plugin-xu. Το createApp χτίζει τις επτά εγχεόμενες εξαρτήσεις που χρειάζεται ο renderer πάνω στον
πίνακα thunks που επιστρέφει το setup() του module, δημιουργεί τον renderer και προσαρτά το δέντρο στοιχείων. Δεν
είναι δεύτερος renderer: ο μεταγλωττισμένος δρόμος και ο διερμηνευόμενος δρόμος της πλατφόρμας μοιράζονται το render.js.
Το examples/hello είναι η συγκεκριμένη, δοκιμασμένη εκδοχή αυτού: createApp(App).mount('#app') πάνω σε ένα
μεταγλωττισμένο App.xu με έναν μετρητή, μια συνθήκη και μια λίστα με κλειδιά.
Ο renderer, με έγχυση εξαρτήσεων
Το create_renderer(deps) είναι ανεξάρτητο από το DOM. Ό,τι αφορά το περιβάλλον φτάνει μέσω ενός αντικειμένου deps,
και ο μικρότερος τίμιος host χρειάζεται ακριβώς επτά από αυτά: document (createElement /
createTextNode / createComment), evaluate (ένας παρακολουθούμενος, σύγχρονος αξιολογητής εκφράσεων), cast_bool
(αληθότητα για τα xu-render / xu-if), resolve_rows (ένας παρακολουθούμενος επιλυτής πινάκων γραμμών για το xu-for),
row_key (σταθερή ταυτότητα γραμμής), write_field (εγγραφές xu-bind) και dispatch_event (handlers
xu-on:*). Το packages/core/demo χτίζει ακριβώς αυτό πάνω σε ένα απλό αντικείμενο reactive({...}), χωρίς
SESSION_OBJ, χωρίς επίπεδο πηγής δεδομένων και χωρίς γέφυρα legacy πουθενά από κάτω.
Ένας κόμβος deps.document χωρίς nodeType διαβάζεται ως αντικείμενο jQuery αντί για πραγματικό κόμβο DOM,
κάτι που μπορεί να φωλιάσει κάθε γραμμή μέσα στην προηγούμενή της χωρίς να ριχτεί σφάλμα. Ένας κόμβος χωρίς remove()
μετατρέπει μια γραμμή που αφαιρέθηκε σε σιωπηλά απορριφθείσα promise: η λίστα σταματά να ενημερώνεται και τίποτα δεν καταγράφεται.
Το create_adapter στο demo προστατεύει και τις δύο περιπτώσεις ρίχνοντας σφάλμα κατά τη δημιουργία κόμβου· περάστε { guard: false }
για να το απενεργοποιήσετε αφού καταλάβετε γιατί υπάρχει η προστασία.
Διαγνωστικά και whenElement
Τα onDiagnostic, getDiagnostics, diagnosticCount και resetDiagnostics μετατρέπουν τις σιωπηλές παραιτήσεις της μηχανής
σε ένα παρατηρήσιμο κανάλι, αντί για διάσπαρτες κλήσεις console.error, ώστε ένας adapter host
ή ένα τεστ να μπορεί να εγγραφεί σε αυτές μέσω κώδικα. Το whenElement εκτελεί ένα callback μόλις υπάρξει ένας κόμβος: ρωτά
μία φορά, μετά ρωτά ξανά στη φάση commit του scheduler (ακριβώς όταν σταθεροποιείται το DOM, πριν τη ζωγραφική), και
μια αναμονή που παραμένει ανικανοποίητη μετά από είκοσι σταθεροποιημένες αποδόσεις αναφέρεται με το όνομά της αντί να παραιτηθεί
σιωπηλά.
Ο router
Τα createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter και
useRoute διανέμονται από το ίδιο πακέτο. Η τρέχουσα διαδρομή είναι το δικό του reactive του @xuda/core, και
το ιστορικό προέρχεται από την πλατφόρμα, οπότε η χρήση του δεν προσθέτει δική του εξάρτηση.
Εξαγωγές πακέτου
Το Node 18 ή νεότερο είναι το δηλωμένο ελάχιστο όριο μηχανής.