diff --git a/.agents/lessons.md b/.agents/lessons.md index 04f4e14..8856222 100644 --- a/.agents/lessons.md +++ b/.agents/lessons.md @@ -25,3 +25,4 @@ alwaysApply: true - Blume ``/islands **hard-cap** live-render at React/Vue/Svelte (+Astro static) — pilot-confirmed in Blume 1.0.4 (`FRAMEWORK_BY_EXT` maps jsx/tsx→react, no solid/preact; generated `astro.config.mjs` only wires react/vue/svelte; no integration hook). Installing `@astrojs/solid-js`/`preact` is inert; `.tsx` always routes to the React renderer (Preact hooks crash, Solid renders broken via React). Non-React recipes are permanently code-only; Vue preview needs `@astrojs/vue` + the `vue.vue` SFC compile fix. (Astro officially also supports Preact/SolidJS/Alpine/Lit; Angular/Qwik community — Blume exposes a strict subset.) [components](https://useblume.dev/docs/content/components), [astro frameworks](https://docs.astro.build/en/guides/framework-components/#official-front-end-framework-integrations). - Recipes are `?raw`-imported, so `blume build` never typechecks them — gate with `bun run typecheck:recipes` in `apps/docs` (per-framework `tsconfig.recipes-*.json` + `tsconfig.solid.json`/`tsconfig.preact.json` via `vue-tsc`/`svelte-check`/`tsc`; wired into CI as root `typecheck`). (Supersedes the old solid/preact-no-`export default` + `vue.vue` SFC-compile bullet — both fixed; gate is live and green.) - Recipe files keep their framework-native extension (`vue.vue`, `svelte-runes.svelte`, `angular.ts`) — renaming a Vue SFC to `vue.ts` makes oxlint parse `