Hopp til innholdet
Bekreftet

@xuda/core

Den avhengighetsfrie reaktive motoren som plattformen, kompilatoren og demo-appene alle monteres på.

@xuda/core er Xudas reaktive motor (signaler, planlegger, nøklet listediff, reaktiv renderer, ruter) som en avhengighetsfri ESM-pakke. Den leser og skriver ingen globale variabler ved import: ingen func, ingen SESSION_OBJ, ingen window, ingen document.

Den ene offentlige pakken i denne delen av dokumentasjonen

@xuda/core har "private": false i package.json. Den er den eneste av de tre pakkene i denne delen (sammen med @xuda/compiler og @xuda/vite-plugin-xu, begge private: true) som er bygget for å brukes som avhengighet utenfor dette repoet.

Den er heller ikke en annen motor enn den plattformen allerede leverer: pakkens eget build:globals-skript (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) er måten runtime/js/xuda_core.globals.js, plattformens egen leverte pakke med den reaktive rendereren, bygges på.

Den reaktive flaten

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

Under alt dette ligger én avhengighetsgraf, ett eiertre, én batch-buffer og én planlegger: en ref som leses inne i en effect() spores og kjører den på nytt, på samme måte som et signal som leses inne i en watch(). computed tar her imot en getter, eller et { get, set }-par for en skrivbar computed.

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

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

effectScope() svarer på «hvem rydder opp i dette»: en navngitt eier du kan sende rundt, nøste og stoppe i ett kall, i stedet for å samle en pose med oppryddingsfunksjoner for hånd.

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

En komponent som opprettes gjennom createApp() eier allerede en slik: <script> kjører i komponentens egen frakoblede scope, så en effekt skrevet der ryddes automatisk opp når komponenten avmonteres.

Primitiven på lavt nivå

signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) og signalComputed er motorens egne celler under ref og computed. De er eksportert og fullt støttet, ikke fjernet, fordi rendereren og den gamle broen er bygget på dem, og fordi signal.notify(), som kjører abonnentene på nytt uten verdiendring, ikke har noen ref-ekvivalent. Applikasjonskode bør bruke ref og computed i stedet; disse to navnene er dokumentert som laget under, ikke utfaset i kjøretid (en advarsel på signal() ville utløses per radscope og per panelparameter, tusenvis av ganger per skjerm, for kode som gjør akkurat det riktige på det laget).

Appens inngangspunkt

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

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

App er en kompilert .xu-modul, laget av @xuda/compiler eller byggetrinnet vite-plugin-xu. createApp bygger de sju injiserte avhengighetene rendereren trenger over thunk-tabellen som modulens setup() returnerer, oppretter rendereren og monterer komponenttreet. Det er ikke en andre renderer: den kompilerte veien og den tolkede plattformveien deler render.js.

examples/hello er den konkrete, testede versjonen av dette: createApp(App).mount('#app') over en kompilert App.xu med en teller, en betingelse og en nøklet liste.

Rendereren, med avhengighetsinjeksjon

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

create_renderer(deps) er DOM-agnostisk. Alt miljøavhengig kommer inn gjennom ett deps-objekt, og den minste ærlige verten trenger nøyaktig sju av dem: document (createElement / createTextNode / createComment), evaluate (en sporet, synkron uttrykksevaluator), cast_bool (sannhetsverdi for xu-render / xu-if), resolve_rows (en sporet radmatrise-resolver for xu-for), row_key (stabil radidentitet), write_field (xu-bind-skriving) og dispatch_event (xu-on:*-håndterere). packages/core/demo bygger akkurat dette over et vanlig reactive({...})-objekt, uten SESSION_OBJ, uten datakildelag og uten noen gammel bro under.

To stille feller i DOM-kontrakten, hvis du skriver din egen adapter

En deps.document-node uten nodeType leses som et jQuery-objekt i stedet for en ekte DOM-node, noe som kan nøste hver rad inne i den forrige uten at det kastes noen feil. En node uten remove() gjør at en fjernet rad blir et stille avvist løfte: listen slutter å oppdatere seg og ingenting logges. create_adapter i demoen vokter mot begge ved å kaste en feil når noden opprettes; send { guard: false } for å velge bort det når du forstår hvorfor vakten finnes.

Diagnostikk og whenElement

onDiagnostic, getDiagnostics, diagnosticCount og resetDiagnostics gjør motorens stille oppgivelser om til én observerbar kanal, i stedet for spredte console.error-kall, slik at en vertsadapter eller en test kan abonnere på dem i kode. whenElement kjører en callback når en node finnes: den spør én gang, og spør så på nytt i planleggerens commit-fase (akkurat når DOM-en setter seg, før maling), og en venting som fortsatt ikke er oppfylt etter tjue ferdige gjengivelser melder fra om seg selv ved navn i stedet for å gi opp i stillhet.

Ruteren

createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter og useRoute leveres fra den samme pakken. Den gjeldende ruten er @xuda/cores egen reactive, og historikken kommer fra plattformen, så bruken legger ikke til noen egen avhengighet.

Pakkeeksporter

Node 18 eller nyere er den oppgitte nedre grensen for motoren.