@xuda/core
Riippuvuuksista vapaa reaktiivinen moottori, jonka päälle alusta, kääntäjä ja esimerkkisovellukset liitetään.
@xuda/core on Xudan reaktiivinen moottori (signaalit, ajastin, avainnettu listaerotus,
reaktiivinen renderöijä, reititin) riippuvuuksista vapaana ESM-pakettina. Se ei lue eikä kirjoita
globaaleja muuttujia tuotaessa: ei func-, SESSION_OBJ-, window- eikä document-arvoa.
@xuda/core:n package.json sisältää "private": false. Se on ainoa paketti tämän osion
kolmesta (yhdessä @xuda/compiler- ja @xuda/vite-plugin-xu-pakettien kanssa, jotka ovat
molemmat private: true), joka on rakennettu käytettäväksi riippuvuutena tämän repon ulkopuolella.
Se ei myöskään ole eri moottori kuin se, jonka alusta jo toimittaa: paketin oma
build:globals-skripti (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) rakentaa tiedoston runtime/js/xuda_core.globals.js,
alustan oman toimitetun reaktiivisen renderöijän paketin.
Reaktiivinen pinta
Kaiken alla on yksi riippuvuusgraafi, yksi omistajapuu, yksi eräpuskuri ja yksi ajastin:
effect():n sisällä luettu ref seuraa ja ajaa sen uudelleen, samoin kuin watch():n sisällä
luettu signaali. computed hyväksyy tässä getterin tai { get, set }-parin kirjoitettavaa
computedia varten.
effectScope() vastaa kysymykseen "kuka hävittää tämän": nimetty omistaja, jota voi kuljettaa,
sisäkkäistää ja pysäyttää yhdellä kutsulla, sen sijaan että kokoaisit itse kasan hävittäjiä.
createApp():n kautta instantioitu komponentti omistaa jo tällaisen: sen <script> ajetaan
komponentin omassa irrotetussa scopessa, joten siellä kirjoitettu efekti hävitetään automaattisesti,
kun komponentti puretaan.
Matalan tason primitiivi
signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) ja
signalComputed ovat moottorin omat solut ref:n ja computed:n alla. Ne on viety ja täysin
tuettuja, ei poistettuja, koska renderöijä ja vanha silta on rakennettu niiden varaan, ja koska
signal.notify(), joka ajaa tilaajat uudelleen ilman arvon muutosta, ei ole vastinetta ref:ssä.
Sovelluskoodin kannattaa käyttää ref:iä ja computed:ia; nämä kaksi nimeä on dokumentoitu
alemmaksi kerrokseksi, ei poistettaviksi suoritusaikana (varoitus signal():sta laukeaisi
jokaisella rivin scopella ja paneelin parametrilla, tuhansia kertoja näkymää kohden, koodille joka
tekee täsmälleen oikein sillä kerroksella).
Sovelluksen sisäänkäynti
App on käännetty .xu-moduuli, jonka tuottaa @xuda/compiler tai
vite-plugin-xu-koontivaihe. createApp rakentaa seitsemän injektoitua riippuvuutta, joita
renderöijä tarvitsee, moduulin setup():n palauttaman thunk-taulun päälle, luo renderöijän ja
liittää komponenttipuun. Se ei ole toinen renderöijä: käännetty polku ja tulkittu alustapolku
jakavat render.js:n.
examples/hello on tämän konkreettinen, testattu versio: createApp(App).mount('#app')
käännetyn App.xu:n päällä, jossa on laskuri, ehto ja avainnettu lista.
Renderöijä, riippuvuusinjektoitu
create_renderer(deps) on DOM-agnostinen. Kaikki ympäristöön liittyvä tulee yhden deps-olion
kautta, ja pienin rehellinen isäntä tarvitsee tarkalleen seitsemän: document (createElement /
createTextNode / createComment), evaluate (seurattu, synkroninen lausekkeen arvioija), cast_bool
(tosiarvoisuus xu-render / xu-if varten), resolve_rows (seurattu rivitaulukon ratkaisija
xu-for:lle), row_key (vakaa rivin identiteetti), write_field (xu-bind-kirjoitukset) ja
dispatch_event (xu-on:*-käsittelijät). packages/core/demo rakentaa täsmälleen tämän tavallisen
reactive({...})-olion päälle, ilman SESSION_OBJ:ia, datalähdekerrosta tai vanhaa siltaa
alla.
deps.document-solmu, jolla ei ole nodeType:a, luetaan jQuery-oliona oikean DOM-solmun
sijaan, mikä voi sisäkkäistää jokaisen rivin edeltäjänsä sisään ilman heitettyä virhettä. Solmu,
jolla ei ole remove()-metodia, muuttaa pudotetun rivin hiljaa hylätyksi promiseksi: lista lakkaa
päivittymästä eikä mitään kirjata. Demon create_adapter suojaa molemmat heittämällä virheen
solmun luontihetkellä; anna { guard: false } poistaaksesi suojan, kun ymmärrät, miksi se on olemassa.
Diagnostiikka ja whenElement
onDiagnostic, getDiagnostics, diagnosticCount ja resetDiagnostics muuttavat moottorin
hiljaiset luovutukset yhdeksi havaittavaksi kanavaksi hajanaisten console.error-kutsujen sijaan,
jolloin isäntäadapteri tai testi voi tilata ne koodista. whenElement ajaa takaisinkutsun, kun
solmu on olemassa: se kysyy kerran, kysyy sitten uudelleen ajastimen commit-vaiheessa (täsmälleen
kun DOM asettuu, ennen maalausta), ja odotus, joka on yhä täyttämättä kahdenkymmenen asettuneen
renderöinnin jälkeen, ilmoittaa itsensä nimellä sen sijaan, että luovuttaisi hiljaa.
Reititin
createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter ja
useRoute tulevat samasta paketista. Nykyinen reitti on @xuda/core:n oma reactive, ja historia
tulee alustalta, joten sen käyttö ei lisää omaa riippuvuutta.
Paketin viennit
Ilmoitettu moottorin vähimmäisversio on Node 18 tai uudempi.