@xuda/core
A függőségmentes reaktív motor, amelyre a platform, a fordító és a demóalkalmazások épülnek.
Az @xuda/core a Xuda reaktív motorja (jelek, ütemező, kulcsolt listakülönbség, reaktív megjelenítő,
útválasztó) függőségmentes ESM-csomagként. Importáláskor nem olvas és nem ír globális változót: nincs
func, nincs SESSION_OBJ, nincs window, nincs document.
Az @xuda/core package.json fájlja "private": false értéket hordoz. Ez az egyetlen csomag a három
közül, amelyet ez a szakasz tárgyal (az @xuda/compiler és az @xuda/vite-plugin-xu mellett, mindkettő
private: true), amelyet arra építettek, hogy ezen a tárolón kívül is függjenek tőle.
Ez nem is külön motor attól, amelyet a platform már szállít: a csomag saját build:globals szkriptje
(esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) építi a runtime/js/xuda_core.globals.js fájlt, a platform saját
szállított reaktív megjelenítő csomagját.
A reaktív felület
Alatta egyetlen függőségi gráf, egyetlen tulajdonosfa, egyetlen kötegpuffer és egyetlen ütemező van: egy
effect() belsejében olvasott ref követődik és újrafuttatja azt, ugyanúgy, ahogy egy watch()
belsejében olvasott jel. A computed itt getter függvényt fogad, vagy egy { get, set } párt írható
számított értékhez.
Az effectScope() arra felel, hogy „ki szünteti meg ezt": névvel ellátott tulajdonos, amelyet
továbbadhat, egymásba ágyazhat és egyetlen hívással leállíthat, ahelyett hogy kézzel gyűjtene
megszüntetőfüggvényeket.
Egy createApp() útján példányosított komponens már birtokol ilyet: a <script> része a komponens saját,
különálló hatókörén belül fut, így az ott írt effekt automatikusan megszűnik, amikor a komponens
lecsatolódik.
Az alacsony szintű primitív
A signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) és a signalComputed a
motor saját cellái a ref és a computed alatt. Exportáltak és teljes mértékben támogatottak, nem
eltávolítottak, mert a megjelenítő és az örökölt híd ezekre épül, és mert a signal.notify(), amely
értékváltozás nélkül futtatja újra az előfizetőket, nem rendelkezik ref megfelelővel. Az
alkalmazáskód a ref és a computed függvényhez nyúljon inkább; ezt a két nevet az alatta lévő
rétegként dokumentáljuk, futásidőben nem elavultként (a signal() elleni figyelmeztetés soronként és
panelparaméterenként, képernyőnként több ezerszer sülne el olyan kódnál, amely az adott rétegen
pontosan jól csinál mindent).
Az alkalmazás belépési pontja
Az App egy lefordított .xu modul, amelyet az @xuda/compiler vagy a
vite-plugin-xu build lépés állít elő. A createApp felépíti a hét befecskendezett függőséget, amelyre
a megjelenítőnek szüksége van, a modul setup() függvénye által visszaadott thunk-táblán, létrehozza a
megjelenítőt, és csatolja a komponensfát. Nem második megjelenítő: a lefordított út és az értelmezett
platformút ugyanazt a render.js fájlt használja.
Az examples/hello ennek a konkrét, tesztelt változata: createApp(App).mount('#app') egy lefordított
App.xu fölött, számlálóval, feltétellel és kulcsolt listával.
A megjelenítő, függőség-befecskendezéssel
A create_renderer(deps) DOM-agnosztikus. Minden környezeti elem egyetlen deps objektumon érkezik, és
a legkisebb őszinte gazdának pontosan hétre van szüksége: document (createElement / createTextNode /
createComment), evaluate (követett, szinkron kifejezésértékelő), cast_bool (igazságérték az
xu-render / xu-if számára), resolve_rows (követett sortömb-feloldó az xu-for számára), row_key
(stabil sorazonosság), write_field (xu-bind írások) és dispatch_event (xu-on:* kezelők). A
packages/core/demo pontosan ezt építi egy egyszerű reactive({...}) objektumon, SESSION_OBJ,
adatforrás-réteg és örökölt híd nélkül.
Egy nodeType nélküli deps.document csomópontot jQuery-objektumként olvas, nem valódi DOM-csomópontként,
ami minden sort az elődjébe ágyazhat, hiba jelzése nélkül. Egy remove() nélküli csomópont a
kihagyott sort csendben elutasított ígérettel váltja fel: a lista nem frissül tovább, és semmi sem
naplózódik. A demó create_adapter függvénye mindkettőt védi azzal, hogy a csomópont létrehozásakor
hibát dob; adja át a { guard: false } értéket a kikapcsoláshoz, ha már érti, miért létezik a védelem.
Diagnosztika és whenElement
Az onDiagnostic, getDiagnostics, diagnosticCount és resetDiagnostics a motor néma feladásait egyetlen
megfigyelhető csatornává alakítja szétszórt console.error hívások helyett, így egy gazdaadapter vagy egy
teszt kóddal feliratkozhat rájuk. A whenElement visszahívást futtat, amint egy csomópont létezik:
egyszer rákérdez, majd újra kérdez az ütemező commit fázisában (pontosan akkor, amikor a DOM megállapodik,
festés előtt), és a húsz megállapodott megjelenítés után is kielégítetlen várakozás névvel jelenti
magát, ahelyett hogy csendben feladná.
Az útválasztó
A createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter és
useRoute ugyanebből a csomagból érkezik. Az aktuális útvonal az @xuda/core saját reactive
objektuma, az előzményeket pedig a platform adja, így a használata nem ad hozzá saját függőséget.
Csomagexportok
A deklarált minimális motorverzió a Node 18 vagy újabb.