@xuda/core
El motor reactivo sin dependencias sobre el que se montan la plataforma, el compilador y las apps de demostración.
@xuda/core es el motor reactivo de Xuda (signals, planificador, diferencias de listas con clave, renderizador reactivo, router) como un paquete ESM sin dependencias. No lee ni escribe ningún global al importarse: ni func, ni SESSION_OBJ, ni window, ni document.
El package.json de @xuda/core lleva "private": false. Es el único de los tres paquetes que se tratan en esta sección (junto con @xuda/compiler y @xuda/vite-plugin-xu, ambos private: true) pensado para que se dependa de él fuera de este repositorio.
Tampoco es un motor distinto del que la plataforma ya distribuye: el propio script build:globals del paquete (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js) es la forma en que se construye runtime/js/xuda_core.globals.js, el propio paquete de renderizador reactivo que distribuye la plataforma.
La superficie reactiva
Debajo de todo ello hay un solo grafo de dependencias, un solo árbol de propietarios, un solo búfer de lotes y un solo planificador: un ref leído dentro de un effect() hace seguimiento y lo vuelve a ejecutar, igual que un signal leído dentro de un watch(). computed aquí acepta un getter, o un par { get, set } para un computed escribible.
effectScope() responde a "quién elimina esto": un propietario con nombre que puedes pasar de mano en mano, anidar y detener con una sola llamada, en lugar de montar a mano un saco de funciones de limpieza.
Un componente instanciado mediante createApp() ya posee uno de estos: su <script> se ejecuta dentro del propio ámbito independiente del componente, así que un efecto escrito allí se elimina automáticamente cuando el componente se desmonta.
La primitiva de bajo nivel
signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) y signalComputed son las celdas propias del motor que hay debajo de ref y computed. Se exportan y están totalmente admitidos, no se han eliminado, porque el renderizador y el puente heredado se construyen sobre ellos, y porque signal.notify(), que vuelve a ejecutar a los suscriptores sin que cambie el valor, no tiene equivalente en ref. El código de aplicación debería recurrir a ref y computed en su lugar; estos dos nombres están documentados como la capa inferior, no como obsoletos en tiempo de ejecución (una advertencia en signal() se dispararía por cada ámbito de fila y por cada parámetro de panel, miles de veces por pantalla, para un código que hace exactamente lo correcto en esa capa).
El punto de entrada de la app
App es un módulo .xu compilado, producido por @xuda/compiler o por el paso de compilación de vite-plugin-xu. createApp construye las siete dependencias inyectadas que necesita el renderizador sobre la tabla de thunks que devuelve el setup() del módulo, crea el renderizador y monta el árbol de componentes. No es un segundo renderizador: el camino compilado y el camino interpretado de la plataforma comparten render.js.
examples/hello es la versión concreta y probada de esto: createApp(App).mount('#app') sobre un App.xu compilado con un contador, una condición y una lista con claves.
El renderizador, con inyección de dependencias
create_renderer(deps) es independiente del DOM. Todo lo del entorno llega mediante un único objeto deps, y el anfitrión honesto más pequeño necesita exactamente siete: document (createElement / createTextNode / createComment), evaluate (un evaluador de expresiones síncrono con seguimiento), cast_bool (veracidad para xu-render / xu-if), resolve_rows (un resolvedor de arrays de filas con seguimiento para xu-for), row_key (identidad estable de fila), write_field (escrituras de xu-bind) y dispatch_event (manejadores xu-on:*). packages/core/demo construye exactamente esto sobre un objeto reactive({...}) simple, sin SESSION_OBJ, sin capa de datasource y sin puente heredado por debajo.
Un nodo de deps.document sin nodeType se lee como un objeto jQuery en lugar de como un nodo real del DOM, lo que puede anidar cada fila dentro de la anterior sin que se lance ningún error. Un nodo sin remove() convierte una fila descartada en una promesa rechazada en silencio: la lista deja de actualizarse y no se registra nada. create_adapter en la demo protege ambos casos lanzando un error en el momento de crear el nodo; pasa { guard: false } para desactivarlo cuando entiendas por qué existe la protección.
Diagnósticos y whenElement
onDiagnostic, getDiagnostics, diagnosticCount y resetDiagnostics convierten los abandonos silenciosos del motor en un único canal observable, en lugar de llamadas dispersas a console.error, de modo que un adaptador anfitrión o una prueba pueda suscribirse a ellos por código. whenElement ejecuta un callback cuando existe un nodo: pregunta una vez y después vuelve a preguntar en la fase de confirmación del planificador (exactamente cuando el DOM se estabiliza, antes de pintar), y una espera que sigue sin cumplirse tras veinte renderizados estabilizados se informa por su nombre en lugar de rendirse en silencio.
El router
createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter y useRoute se distribuyen en el mismo paquete. La ruta actual es el propio reactive de @xuda/core, y el historial viene de la plataforma, así que usarlo no añade ninguna dependencia propia.
Exportaciones del paquete
Node 18 o superior es el mínimo de motor declarado.