vite-plugin-ascua

Compila las plantillas de Ascua dentro de Vite, y entrega a Vite el CSS que el compilador extrae de los <style>.

stil add -D vite-plugin-ascua      # o npm install -D vite-plugin-ascua

// vite.config.ts
import ascua from "vite-plugin-ascua";

export default {
  plugins: [ascua()],
};

Por defecto compila con el módulo WebAssembly de ascua-compilador, que viene como dependencia: un artefacto para todas las plataformas, sin postinstall. Con ascua({ bin: "./target/release/ascuac" }) se usa un ejecutable nativo, que es algo más rápido.

El plugin hace dos cosas y ninguna más: pasar cada archivo con plantillas por el compilador, y registrar el CSS resultante como un módulo más para que Vite lo inyecte en desarrollo y lo extraiga a un .css en el build. No toca la reactividad, no empaqueta y no resuelve módulos.

Sitios estáticos

export default { plugins: [ascua({ site: true })] };

Cada archivo de src/routes/ pasa a ser una página: vite la sirve en desarrollo y vite build escribe un HTML por ruta en dist/, con sus estilos dentro y, solo si tiene islas, el script que las hidrata y los módulos de las islas que usa —una isla por archivo en src/islands/, y cada página descarga solo las suyas—. Rutas con parámetros ([id].ts con paths()), datos con load() —que la página recibe en la prop data, o notFound() de vite-plugin-ascua/site para dar un 404—, un layout común (_layout.ts), title, description y head por ruta, 404.ts y rutas que son archivos (sitemap.xml.ts). Las islas van en src/islands/; las carpetas se cambian con site: { routes, islands } y el esqueleto HTML con site: { shell }.

Con ascua({ site: { mode: "server" } }), el build deja el cliente en dist/client/ y además dist/server/index.mjs, un servidor Node con todo dentro que renderiza en cada petición: node dist/server/index.mjs lo arranca, y el módulo exporta serve(puerto) y handle(url), que devuelve { status, type, body } para montarlo en otro servidor. Guía en ascua.gitweave.run/docs/sitios.

Licencia

MIT OR Apache-2.0