@xuda/core
Le moteur réactif sans dépendance sur lequel la plateforme, le compilateur et les apps de démo se montent.
@xuda/core est le moteur réactif de Xuda (signaux, ordonnanceur, diff de listes à clés, moteur de rendu réactif, routeur) sous forme de paquet ESM sans dépendance. Il ne lit ni n'écrit aucune variable globale à l'import : ni func, ni SESSION_OBJ, ni window, ni document.
Le package.json de @xuda/core porte "private": false. C'est le seul paquet parmi les trois couverts dans cette section (avec @xuda/compiler et @xuda/vite-plugin-xu, tous deux private: true) conçu pour être utilisé comme dépendance en dehors de ce dépôt.
Ce n'est pas non plus un moteur distinct de celui que la plateforme livre déjà : le script build:globals du paquet (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) est la façon dont runtime/js/xuda_core.globals.js, le bundle de moteur de rendu réactif livré par la plateforme, est construit.
La surface réactive
Il y a un seul graphe de dépendances, un seul arbre de propriétaires, un seul tampon de lot et un seul ordonnanceur en dessous de tout cela : une lecture de ref dans un effect() suit et relance celui-ci, exactement comme une lecture de signal dans un watch(). Ici, computed accepte un getter, ou une paire { get, set } pour un computed modifiable.
effectScope() répond à « qui s'en débarrasse » : un propriétaire nommé que vous pouvez transmettre, imbriquer et arrêter en un seul appel, au lieu de bricoler à la main un sac de fonctions de nettoyage.
Un composant instancié via createApp() en possède déjà un : son <script> s'exécute dans la portée détachée propre au composant, donc un effet écrit là est supprimé automatiquement quand le composant se démonte.
La primitive de bas niveau
signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) et signalComputed sont les cellules propres au moteur sous ref et computed. Elles sont exportées et entièrement prises en charge, pas retirées, parce que le moteur de rendu et le pont hérité reposent dessus, et parce que signal.notify(), qui relance les abonnés sans changement de valeur, n'a pas d'équivalent dans ref. Le code d'application devrait plutôt utiliser ref et computed ; ces deux noms sont documentés comme la couche en dessous, pas dépréciés à l'exécution (un avertissement sur signal() se déclencherait par portée de ligne et par paramètre de panneau, des milliers de fois par écran, pour du code qui fait exactement ce qu'il faut à cette couche).
Le point d'entrée de l'app
App est un module .xu compilé, produit par @xuda/compiler ou par l'étape de build vite-plugin-xu. createApp construit les sept dépendances injectées dont le moteur de rendu a besoin sur la table de thunks que renvoie le setup() du module, crée le moteur de rendu et monte l'arbre de composants. Ce n'est pas un second moteur de rendu : le chemin compilé et le chemin interprété de la plateforme partagent render.js.
examples/hello en est la version concrète et testée : createApp(App).mount('#app') sur un App.xu compilé avec un compteur, une condition et une liste à clés.
Le moteur de rendu, par injection de dépendances
create_renderer(deps) est indépendant du DOM. Tout ce qui relève de l'environnement arrive par un seul objet deps, et l'hôte honnête le plus petit en a exactement besoin de sept : document (createElement / createTextNode / createComment), evaluate (un évaluateur d'expressions suivi et synchrone), cast_bool (valeur de vérité pour xu-render / xu-if), resolve_rows (un résolveur de tableaux de lignes suivi pour xu-for), row_key (identité stable des lignes), write_field (écritures de xu-bind) et dispatch_event (gestionnaires xu-on:*). packages/core/demo construit exactement cela sur un simple objet reactive({...}), sans SESSION_OBJ, sans couche de source de données et sans pont hérité en dessous.
Un nœud deps.document sans nodeType est lu comme un objet jQuery plutôt que comme un vrai nœud DOM, ce qui peut imbriquer chaque ligne dans la précédente sans aucune erreur levée. Un nœud sans remove() transforme une ligne supprimée en promesse rejetée silencieusement : la liste cesse de se mettre à jour et rien n'est consigné. create_adapter dans la démo protège contre les deux en levant une erreur à la création du nœud ; passez { guard: false } pour le désactiver une fois que vous avez compris pourquoi la protection existe.
Diagnostics et whenElement
onDiagnostic, getDiagnostics, diagnosticCount et resetDiagnostics transforment les abandons silencieux du moteur en un seul canal observable, plutôt que des appels console.error dispersés, pour qu'un adaptateur d'hôte ou un test puisse s'y abonner par code. whenElement exécute un callback une fois qu'un nœud existe : il demande une fois, puis redemande à la phase de validation de l'ordonnanceur (exactement quand le DOM se stabilise, avant l'affichage), et une attente toujours non satisfaite après vingt rendus stabilisés se signale par son nom au lieu d'abandonner silencieusement.
Le routeur
createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter et useRoute sont fournis par le même paquet. La route courante est le propre reactive de @xuda/core, et l'historique vient de la plateforme, donc l'utiliser n'ajoute aucune dépendance propre.
Exports du paquet
Node 18 ou plus récent est le plancher de moteur déclaré.