@xuda/core
Die abhängigkeitsfreie reaktive Engine, auf der die Plattform, der Compiler und die Demo-Apps aufsetzen.
@xuda/core ist die reaktive Engine von Xuda (Signals, Scheduler, Listen-Diff mit Schlüsseln, reaktiver Renderer, Router) als abhängigkeitsfreies ESM-Paket. Beim Import liest und schreibt es keine Globals: kein func, kein SESSION_OBJ, kein window, kein document.
Die package.json von @xuda/core trägt "private": false. Es ist das einzige der drei in diesem Abschnitt behandelten Pakete (neben @xuda/compiler und @xuda/vite-plugin-xu, beide private: true), das dafür gebaut ist, außerhalb dieses Repositorys als Abhängigkeit genutzt zu werden.
Es ist außerdem keine andere Engine als die, die die Plattform bereits ausliefert: Das eigene Skript build:globals des Pakets (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) ist der Weg, wie runtime/js/xuda_core.globals.js, das von der Plattform selbst ausgelieferte Bundle des reaktiven Renderers, gebaut wird.
Die reaktive Oberfläche
Darunter liegen ein Abhängigkeitsgraph, ein Besitzerbaum, ein Batch-Puffer und ein Scheduler für alles: Ein ref, das innerhalb eines effect() gelesen wird, wird verfolgt und führt ihn erneut aus, genauso wie ein Signal, das innerhalb eines watch() gelesen wird. computed akzeptiert hier einen Getter oder ein Paar { get, set } für ein beschreibbares computed.
effectScope() beantwortet die Frage "wer räumt das auf": ein benannter Besitzer, den du weiterreichen, verschachteln und mit einem Aufruf stoppen kannst, statt eine Tüte voll Disposer von Hand zusammenzubauen.
Eine über createApp() instanziierte Komponente besitzt bereits einen solchen: Ihr <script> läuft innerhalb des eigenen, abgetrennten Scopes der Komponente, ein dort geschriebener Effekt wird also automatisch aufgeräumt, wenn die Komponente ausgehängt wird.
Das Low-Level-Primitiv
signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) und signalComputed sind die eigenen Zellen der Engine unter ref und computed. Sie sind exportiert und voll unterstützt, nicht entfernt, weil der Renderer und die Legacy-Brücke darauf gebaut sind und weil signal.notify(), das Abonnenten ohne Wertänderung erneut ausführt, kein ref-Äquivalent hat. Anwendungscode sollte stattdessen zu ref und computed greifen; diese beiden Namen sind als die Schicht darunter dokumentiert, zur Laufzeit nicht als veraltet markiert (eine Warnung bei signal() würde pro Zeilen-Scope und pro Panel-Parameter tausende Male pro Bildschirm auslösen, für Code, der auf dieser Schicht genau das Richtige tut).
Der App-Einstiegspunkt
App ist ein kompiliertes .xu-Modul, erzeugt von @xuda/compiler oder dem Build-Schritt von vite-plugin-xu. createApp baut die sieben injizierten Abhängigkeiten, die der Renderer braucht, über der Thunk-Tabelle, die das setup() des Moduls zurückgibt, erzeugt den Renderer und hängt den Komponentenbaum ein. Es ist kein zweiter Renderer: Der kompilierte Weg und der interpretierte Plattformweg teilen sich render.js.
examples/hello ist die konkrete, getestete Version davon: createApp(App).mount('#app') über einem kompilierten App.xu mit einem Zähler, einer Bedingung und einer Liste mit Schlüsseln.
Der Renderer, per Dependency Injection
create_renderer(deps) ist DOM-agnostisch. Alles Umgebungsabhängige kommt über ein deps-Objekt, und der kleinste ehrliche Host braucht genau sieben davon: document (createElement / createTextNode / createComment), evaluate (ein verfolgter, synchroner Ausdrucksauswerter), cast_bool (Wahrheitswert für xu-render / xu-if), resolve_rows (ein verfolgter Zeilen-Array-Resolver für xu-for), row_key (stabile Zeilenidentität), write_field (xu-bind-Schreibzugriffe) und dispatch_event (xu-on:*-Handler). packages/core/demo baut genau das über einem einfachen reactive({...})-Objekt, ohne SESSION_OBJ, ohne Datasource-Schicht und ohne Legacy-Brücke irgendwo darunter.
Ein deps.document-Knoten ohne nodeType wird als jQuery-Objekt gelesen statt als echter DOM-Knoten, was jede Zeile ohne geworfenen Fehler in ihre Vorgängerin schachteln kann. Ein Knoten ohne remove() macht aus einer verworfenen Zeile ein stillschweigend abgelehntes Promise: Die Liste aktualisiert sich nicht mehr, und nichts wird protokolliert. create_adapter in der Demo sichert beides ab, indem es bei der Knotenerstellung einen Fehler wirft; übergib { guard: false }, um das abzuschalten, sobald du verstehst, warum der Schutz existiert.
Diagnose und whenElement
onDiagnostic, getDiagnostics, diagnosticCount und resetDiagnostics machen aus dem stillen Aufgeben der Engine einen einzigen beobachtbaren Kanal statt verstreuter console.error-Aufrufe, sodass ein Host-Adapter oder ein Test sie per Code abonnieren kann. whenElement führt einen Callback aus, sobald ein Knoten existiert: Es fragt einmal und fragt dann in der Commit-Phase des Schedulers erneut (genau dann, wenn sich das DOM setzt, vor dem Zeichnen), und ein Warten, das nach zwanzig abgeschlossenen Renderdurchläufen immer noch nicht erfüllt ist, meldet sich mit Namen, statt stillschweigend aufzugeben.
Der Router
createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter und useRoute kommen aus demselben Paket. Die aktuelle Route ist das eigene reactive von @xuda/core, und die History kommt von der Plattform, seine Nutzung fügt also keine eigene Abhängigkeit hinzu.
Paket-Exporte
Node 18 oder neuer ist die deklarierte Mindestversion der Engine.