Virtual DOM.
Cada dato ya sabe
qué nodo le toca.
React manda 45 kB al navegador para averiguar en cada render qué cambió. Ascua lo
resuelve antes, al compilar: la plantilla se convierte en las operaciones de DOM que
le corresponden, y lo que viaja son 4,01 kB de runtime sin
dependencias. El compilador es un .wasm de 109 KB —uno, no una decena
de binarios por plataforma— y no descarga nada en el postinstall.
Esta página es HTML estático. Los tres demos de abajo son islas de Ascua compiladas con ese mismo .wasm, y pesan 3,5 kB entre las tres.
01 · el diff que sobra
Reconstruir el árbol para ver qué cambió
Con Virtual DOM, cambiar un número reconstruye una representación del árbol y la compara con la anterior. El trabajo depende del tamaño del árbol, no del cambio.
Ascua ata el dato a su nodo una vez, al compilar. Cambiarlo ejecuta la escritura que le toca. Nada que deducir, porque nada se olvidó.
Pulsa y mira el registro: cada click es un setText sobre el mismo nodo,
que nunca se sustituye.
02 · el núcleo
signal, effect, memo
Un signal guarda un valor. Un effect ejecuta código y anota
qué signals leyó; si alguno cambia, vuelve a correr. Un memo guarda su
resultado y se calla si no cambió.
const count = signal(0);
const doble = memo(() => count() * 2);
effect(() => console.log("doble =", doble()));
count.set(21); // imprime "doble = 42"
count.set(21); // silencio: el memo no cambió
Nadie declara dependencias. Se descubren al leer.
Escribir en un signal no ejecuta nada: marca. Los efectos se encolan y corren cuando la marca terminó de propagarse, así que un grafo en diamante no deja ver valores a medias y una rama que no cambió no recalcula.
03 · plantillas
Una closure es reactiva; lo demás, no
La plantilla es HTML: class y onclick, no
className ni onClick. Se copia y se pega desde cualquier
sitio.
escribes
view`
<button
onclick=${() => count.update(c => c + 1)}
>
Clicks: ${() => count()}
</button>`
sale
// arriba, una vez: lo que no cambia
const _$t0 = _$tpl(
["button", 0, ["Clicks: ", ""]], …);
const [_n0, _n1] = _$clone(_$t0);
_$on(_n0, "click",
() => count.update(c => c + 1));
_$bindtxt(_n1, () => count());
Lo fijo se clona de una vez. El efecto tiene _n1 capturado: ya sabe a qué nodo escribir.
${count()} pone el valor y se olvida. ${() => count()}
crea un efecto. La diferencia es sintáctica: se ve en la plantilla,
sin mirar tipos.
04 · composición
Componentes y control de flujo
Minúscula es HTML, mayúscula es componente. Un componente recibe props y devuelve un
nodo: <Ficha titulo=${t}/> compila a Ficha({ titulo: t }),
que puedes escribir a mano. Sin clase base ni ciclo de vida.
view`
<main>
<Show when=${() => sesion() !== null}>
<Ficha titulo=${() => sesion()!.nombre}>
<ul>
<For each=${() => tareas()}
key=${(t) => t.id}
render=${(t) => view`<li>${t.titulo}</li>`}/>
</ul>
</Ficha>
<Else><Acceso onentrar=${entrar}/></Else>
</Show>
</main>`
Los hijos son una receta que recibe el padre, no nodos ya hechos.
Cada rama de <Show> se construye dentro de su propia función, así
que la que no se ve todavía no existe. Al cambiar la condición se libera el scope
entero de la anterior: efectos, memos, listeners y onCleanup.
Entra, marca una tarea, añade otra y sal. El contador de abajo lo lleva: una construcción por clave, y todas liberadas al salir. Marcar no rehace la fila, escribe en un atributo y en un texto.
El campo usa prop:value. El atributo value de un
<input> solo fija el valor inicial y deja de mandar en cuanto
alguien teclea; la propiedad manda siempre. De eso depende poder vaciar un formulario
desde el código.
05 · listas
La única reconciliación que queda
En texto y atributos no hay nada que comparar. En una lista sí: hace falta saber qué le pasó a cada elemento. Se comparan claves, no árboles, y solo cuando la lista cambia.
El color se fija al construir cada item. Rota o invierte: los colores viajan con sus items porque son los mismos nodos, movidos. Eso es lo que conserva el foco, el scroll y lo que hubiera a medio escribir.
06 · estilos
El CSS se queda en el compilador
Un <style> dentro de una plantilla no deja nada en tiempo de
ejecución: ni etiqueta inyectada, ni insertRule. Al compilar se deriva un
identificador del contenido y se reescribe cada selector.
en la plantilla
<style>
.caja { border: 1px solid; }
p:hover { opacity: .5; }
</style>
en el .css del build
.caja[data-ascua-98909ba2] {
border: 1px solid;
}
p[data-ascua-98909ba2]:hover {
opacity: .5;
}
El atributo va antes de la pseudo-clase, no al final.
El scope es por plantilla. El CSS de un componente no se filtra a los componentes que use dentro, que es justo lo que se espera de un scope, y por eso cada uno lleva sus estilos consigo.
07 · webassembly
Un artefacto, no veinte
109 KB para todo
El mismo .wasm en Node, Bun, Deno y el navegador. SWC publica una decena de binarios por plataforma; esbuild, veinte.
Sin postinstall
Nada que descargar al instalar, que es el agujero que stil existe para cerrar. Un artefacto que auditar, no diez.
Corre en tu pestaña
El playground es el compilador entero, sin servidor detrás. Escribe y mira lo que sale.
Y no baja al cliente
En el navegador el DOM vive en JavaScript: cruzar la frontera cuesta más que la operación. Por eso el runtime son 4,01 kB de JS.
08 · frente a los de siempre
Dónde queda Ascua
| Ascua | React | Svelte | Solid | |
|---|---|---|---|---|
| Actualiza el DOM | directo | diff | directo | directo |
| Virtual DOM | no | sí | no | no |
| Runtime, gzip | 4,01 kB | ~45 kB | ~10 kB | ~7 kB |
| Compilador | wasm | — | js | js |
| Binarios por plataforma | 0 | — | 0 | 0 |
| CSS scoped | al compilar | no | al compilar | no |
| Control de flujo | <Show> <For> | js | bloques | <Show> <For> |
| Router, gzip | 1,03 kB | ~10 kB | aparte | ~4 kB |
| Deps del runtime | 0 | varias | 0 | 0 |
| Tiempo × vanilla ↗ | 1,10 | 1,85 | 1,13 | 1,07 |
La columna que de verdad importa no está en la tabla: si puedes leer el mecanismo entero en una tarde y arreglarlo sin esperar a nadie. El runtime del navegador son 1.100 líneas, comentarios incluidos; el compilador, 1.900 sin contar sus tests.
09 · empezar
Un comando para un sitio, dos para el runtime
stil dlx create-ascua my-site
o npm create ascua@latest, bun create ascua, deno run -A npm:create-ascua.
Deja un sitio con una página por archivo de src/routes/ e islas para lo
interactivo. Con --template server, además formularios con acciones y
middleware, en un servidor que corre en Node, Bun, Deno o Cloudflare Workers.
¿Vienes de Fresh? El modelo es el mismo.
stil add ascua
stil add -D vite-plugin-ascua
El runtime a mano, para una aplicación de una página. También con npm install.
// vite.config.ts
import ascua from "vite-plugin-ascua";
export default { plugins: [ascua()] };
El compilador viene dentro del plugin. No hay binario que instalar.
A partir de ahí es Vite. Salen un .js y un .css que se
publican en cualquier hosting estático — este sitio, sin ir más lejos.
En el editor, colores y errores de tipos dentro de las plantillas: extensión para VS Code (76 kB), o el plugin de TypeScript para Zed y el resto.