Ugrás a tartalomhoz
Ellenőrizve

@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 egyetlen nyilvános csomag a dokumentáció ezen részében

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

js
import { ref, reactive, computed, effect, watch, effectScope } from '@xuda/core';

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.

js
const state = reactive({ count: 0 });
state.count++;             // no .get(), no .set()

const n = ref(0);
n.value++;

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.

js
const scope = effectScope();
scope.run(() => {
  effect(() => { /* ... */ });
  watch(source, callback);
  onScopeDispose(() => io.disconnect());
});
scope.stop();

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

js
import { createApp } from '@xuda/core';
import App from './App.xu';

createApp(App).mount('#app');

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

js
import { create_renderer } from '@xuda/core';
import { reactive } from '@xuda/core/reactivity';

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.

Két néma DOM-szerződési csapda, ha saját adaptert ír

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.