@xuda/core
Platformun, derleyicinin ve demo uygulamalarının üzerine bağlandığı, bağımlılığı olmayan reaktif motor.
@xuda/core, Xuda reaktif motorudur (sinyaller, zamanlayıcı, anahtarlı liste farkı, reaktif
oluşturucu, yönlendirici); bağımlılığı olmayan bir ESM paketi olarak sunulur. İçe aktarıldığında hiçbir
genel değişken okumaz ya da yazmaz: func yok, SESSION_OBJ yok, window yok, document yok.
@xuda/core'un package.json dosyası "private": false taşır. Bu bölümde ele alınan üç paket
(@xuda/compiler ve @xuda/vite-plugin-xu ile birlikte, ikisi de private: true) arasında bu
depo dışında bağımlılık olarak kullanılmak üzere oluşturulmuş tek pakettir.
Ayrıca platformun zaten gönderdiği motordan ayrı bir motor değildir: paketin kendi build:globals
betiği (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js), platformun kendi gönderdiği reaktif oluşturucu paketi olan
runtime/js/xuda_core.globals.js dosyasının nasıl oluşturulduğudur.
Reaktif yüzey
Hepsinin altında tek bir bağımlılık grafiği, tek bir sahip ağacı, tek bir toplu işlem arabelleği ve
tek bir zamanlayıcı vardır: bir effect() içinde okunan bir ref, bir watch() içinde okunan bir
sinyalle aynı şekilde onu izler ve yeniden çalıştırır. Buradaki computed, bir getter ya da yazılabilir
bir computed için bir { get, set } çifti kabul eder.
effectScope(), "bunu kim yok eder" sorusunu yanıtlar: bir dizi yok edici elle toplamak yerine, elden
ele verebileceğiniz, iç içe geçirebileceğiniz ve tek çağrıyla durdurabileceğiniz adlandırılmış bir
sahip.
createApp() ile örneklenen bir bileşen bunlardan birine zaten sahiptir: <script> bileşenin kendi
ayrılmış kapsamı içinde çalışır; bu yüzden orada yazılan bir efekt, bileşen bağlantısı kesildiğinde
otomatik olarak yok edilir.
Düşük düzeyli ilkel
signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) ve signalComputed,
ref ile computed altındaki motorun kendi hücreleridir. Dışa aktarılırlar ve tamamen desteklenirler,
kaldırılmadılar; çünkü oluşturucu ve eski köprü bunların üzerine kuruludur ve değer değişikliği olmadan
abonelerin yeniden çalıştırılması olan signal.notify()'nin bir ref karşılığı yoktur. Uygulama kodu
bunun yerine ref ve computed kullanmalıdır; bu iki ad bir alt katman olarak belgelenir, çalışma
zamanında kullanımdan kaldırılmış değildir (signal() üzerinde bir uyarı, o katmanda tam olarak doğru
şeyi yapan kod için satır kapsamı başına ve panel parametresi başına, ekran başına binlerce kez
tetiklenirdi).
Uygulama giriş noktası
App, @xuda/compiler veya vite-plugin-xu derleme adımı tarafından
üretilen derlenmiş bir .xu modülüdür. createApp, oluşturucunun ihtiyaç duyduğu yedi enjekte
bağımlılığı, modülün setup() fonksiyonunun döndürdüğü thunk tablosu üzerinde kurar, oluşturucuyu
yaratır ve bileşen ağacını bağlar. İkinci bir oluşturucu değildir: derlenmiş yol ile yorumlanan
platform yolu render.js dosyasını paylaşır.
examples/hello, bunun somut, test edilmiş sürümüdür: bir sayaç, bir koşul ve anahtarlı bir liste
içeren derlenmiş bir App.xu üzerinde createApp(App).mount('#app').
Bağımlılık enjekte edilen oluşturucu
create_renderer(deps) DOM'dan bağımsızdır. Ortama ait her şey tek bir deps nesnesiyle gelir ve en
küçük dürüst ana makinenin tam olarak yedisine ihtiyacı vardır: document (createElement /
createTextNode / createComment), evaluate (izlenen, eşzamanlı bir ifade değerlendirici),
cast_bool (xu-render / xu-if için doğruluk), resolve_rows (xu-for için izlenen bir satır
dizisi çözümleyici), row_key (kararlı satır kimliği), write_field (xu-bind yazmaları) ve
dispatch_event (xu-on:* işleyicileri). packages/core/demo, bunu düz bir reactive({...}) nesnesi
üzerinde tam olarak böyle kurar; altında hiçbir yerde SESSION_OBJ, veri kaynağı katmanı ya da eski
köprü yoktur.
nodeType değeri olmayan bir deps.document düğümü gerçek bir DOM düğümü yerine jQuery nesnesi olarak
okunur; bu, hiçbir hata atılmadan her satırı öncekinin içine yerleştirebilir. remove() olmayan bir
düğüm, bırakılan bir satırı sessizce reddedilen bir promise'e çevirir: liste güncellenmeyi bırakır ve
hiçbir şey günlüğe yazılmaz. Demodaki create_adapter, düğüm oluşturma sırasında hata atarak ikisini de
korur; korumanın neden var olduğunu anladıktan sonra vazgeçmek için { guard: false } verin.
Tanılama ve whenElement
onDiagnostic, getDiagnostics, diagnosticCount ve resetDiagnostics, motorun sessiz vazgeçişlerini
dağınık console.error çağrıları yerine tek bir gözlemlenebilir kanala dönüştürür; böylece bir ana
makine bağdaştırıcısı ya da bir test bunlara kodla abone olabilir. whenElement, bir düğüm var
olduğunda bir geri çağırma çalıştırır: bir kez sorar, sonra zamanlayıcının commit aşamasında (DOM'un
tam olarak yerleştiği, boyamadan önceki an) yeniden sorar ve yirmi yerleşik oluşturmadan sonra hâlâ
karşılanmayan bir bekleme, sessizce vazgeçmek yerine kendini adıyla bildirir.
Yönlendirici
createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter ve
useRoute aynı paketten gelir. Geçerli rota @xuda/core'un kendi reactive nesnesidir ve geçmiş
platformdan gelir; bu yüzden kullanmak kendine ait bir bağımlılık eklemez.
Paket dışa aktarımları
Node 18 veya daha yenisi, bildirilen motor alt sınırıdır.