@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.
@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
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.
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.
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
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
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.
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.