@useavalon/avalon 0.1.46 → 0.1.47

package/dist/src/prerender/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Avalon Prerender Module
+ *
+ * Post-build prerendering for static site generation (SSG).
+ *
+ * Nitro v3's Vite builder does not yet support the built-in prerender
+ * pipeline. This module provides an equivalent: after the Vite/Nitro build
+ * completes, it boots the built server locally, fetches each configured
+ * route, and writes the resulting HTML to the public output directory.
+ *
+ * Prerendered pages are served as static files from the CDN — zero
+ * function invocations. Islands on prerendered pages still hydrate
+ * normally on the client.
+ *
+ * @example
+ * ```ts
+ * // In post-build.mjs or build.mjs:
+ * import { prerenderRoutes } from '@useavalon/avalon/prerender';
+ *
+ * await prerenderRoutes({
+ *   serverEntryPath: '.output/server/index.mjs',
+ *   outputDir: '.output/public',
+ *   routes: ['/'],
+ *   crawlLinks: true,
+ *   ignore: ['/demo/data-fetching'],
+ * });
+ * ```
+ */
+export interface PrerenderConfig {
+    /** Path to the built Nitro server entry (e.g. '.output/server/index.mjs') */
+    serverEntryPath: string;
+    /** Directory to write prerendered HTML files */
+    outputDir: string;
+    /** Explicit routes to prerender */
+    routes?: string[];
+    /** Crawl <a> links in prerendered pages to discover more routes */
+    crawlLinks?: boolean;
+    /** Routes to ignore (strings, RegExps, or filter functions) */
+    ignore?: Array<string | RegExp | ((path: string) => undefined | null | boolean)>;
+    /** Number of concurrent prerender requests @default 4 */
+    concurrency?: number;
+    /** Fail the build if a prerender route errors @default false */
+    failOnError?: boolean;
+    /** Write /about as /about/index.html @default true */
+    autoSubfolderIndex?: boolean;
+    /** Number of retry attempts per route @default 3 */
+    retry?: number;
+    /** Delay between retries in ms @default 500 */
+    retryDelay?: number;
+    /** Port to run the prerender server on @default 13172 */
+    port?: number;
+}
+export { prerenderRoutes } from './prerender.ts';

package/dist/src/prerender/index.js

@@ -0,0 +1 @@
+export{prerenderRoutes}from"./prerender.js";

package/dist/src/prerender/prerender.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prerender implementation.
+ *
+ * Spawns the built Nitro server as a child process, fetches routes via HTTP,
+ * extracts links, and writes static HTML files to the output directory.
+ *
+ * This approach avoids dependency issues (e.g. undici, platform-specific
+ * modules) that occur when importing the server bundle directly.
+ */
+import type { PrerenderConfig } from './index.ts';
+/**
+ * Prerender routes by spawning the built server and fetching each route via HTTP.
+ */
+export declare function prerenderRoutes(config: PrerenderConfig): Promise<{
+    prerenderedRoutes: string[];
+    errors: Array<{
+        route: string;
+        error: string;
+    }>;
+}>;

package/dist/src/prerender/prerender.js

@@ -0,0 +1 @@
+import{resolve as e,join as t,dirname as n}from"node:path";import{existsSync as r,mkdirSync as i,writeFileSync as a}from"node:fs";import{spawn as o}from"node:child_process";function s(e){let t=[],n=/<a\s[^>]*href=["']([^"'#?]+)/gi,r;for(;(r=n.exec(e))!==null;){let e=r[1];if(e.startsWith(`/`)&&!e.startsWith(`//`)){if(e.startsWith(`/assets/`)||e.startsWith(`/islands/`)||e.startsWith(`/chunks/`)||e.startsWith(`/_`)||e.match(/\.\w{2,5}$/))continue;t.push(e)}}return[...new Set(t)]}function c(e,t){for(let n of t)if(typeof n==`string`){if(e===n||n.endsWith(`/**`)&&e.startsWith(n.slice(0,-2)))return!0}else if(n instanceof RegExp){if(n.test(e))return!0}else if(typeof n==`function`&&n(e))return!0;return!1}async function l(e,t=15e3){let n=Date.now();for(;Date.now()-n<t;){try{let t=await fetch(`${e}/`);if(t.ok||t.status<500)return}catch{}await new Promise(e=>setTimeout(e,200))}throw Error(`[prerender] Server did not become ready within ${t}ms`)}export async function prerenderRoutes(u){let{serverEntryPath:d,outputDir:f,routes:p=[`/`],crawlLinks:m=!1,ignore:h=[],concurrency:g=4,failOnError:_=!1,autoSubfolderIndex:v=!0,retry:y=3,retryDelay:b=500,port:x=13172}=u,S=e(d);if(!r(S))throw Error(`[prerender] Server entry not found: ${S}`);let C=e(f),w=`http://localhost:${x}`;console.log(`[prerender] Spawning server from ${d} on port ${x}...`);let T=null;try{T=o(`node`,[S],{env:{...process.env,PORT:String(x),NITRO_PORT:String(x),HOST:`127.0.0.1`,NITRO_HOST:`127.0.0.1`,NODE_ENV:`production`},stdio:[`ignore`,`pipe`,`pipe`]}),T.stdout?.on(`data`,e=>{let t=e.toString().trim();t&&console.log(`[prerender:server] ${t}`)}),T.stderr?.on(`data`,e=>{let t=e.toString().trim();t&&console.error(`[prerender:server:err] ${t}`)}),await l(w),console.log(`[prerender] Server ready at ${w}`)}catch(e){throw T?.kill(`SIGKILL`),Error(`[prerender] Failed to start server: ${e.message}`)}let E=[],D=[],O=new Set,k=[...p];console.log(`[prerender] Starting with ${k.length} route(s), crawlLinks=${m}`);async function A(e){for(let t=1;t<=y;t++)try{let t=await fetch(`${w}${e}`);return{html:await t.text(),status:t.status}}catch(n){let r=n instanceof Error?n.message:String(n);if(t<y)console.warn(`[prerender] Retry ${t}/${y} for ${e}: ${r}`),await new Promise(e=>setTimeout(e,b));else return console.error(`[prerender] All ${y} attempts failed for ${e}: ${r}`),null}return null}try{for(;k.length>0;){let e=k.splice(0,g);await Promise.all(e.map(async e=>{let r=e.endsWith(`/`)&&e!==`/`?e.slice(0,-1):e;if(O.has(r))return;if(O.add(r),c(r,h)){console.log(`[prerender] ⏭  ${r} (ignored)`);return}let o=await A(r);if(!o){let e=`Failed to fetch ${r} after ${y} attempts`;if(console.error(`[prerender] ❌ ${e}`),D.push({route:r,error:e}),_)throw Error(e);return}if(o.status>=400){let e=`${r} returned ${o.status}`;if(console.error(`[prerender] ❌ ${e}`),D.push({route:r,error:e}),_)throw Error(e);return}let l=v?t(r,`index.html`):r+`.html`,u=t(C,l);if(i(n(u),{recursive:!0}),a(u,o.html),E.push(r),console.log(`[prerender] ✅ ${r} → ${l}`),m){let e=s(o.html);for(let t of e){let e=t.endsWith(`/`)&&t!==`/`?t.slice(0,-1):t;!O.has(e)&&!c(e,h)&&k.push(e)}}}))}}finally{T&&(console.log(`[prerender] Shutting down server...`),T.kill(`SIGKILL`))}return console.log(`[prerender] Done: ${E.length} page(s) prerendered`+(D.length>0?`, ${D.length} error(s)`:``)),{prerenderedRoutes:E,errors:D}}

package/dist/src/types/image.d.ts

@@ -1,106 +1,106 @@
-/**
- * Type declarations for image imports with vite-imagetools
- *
- * These types enable TypeScript support for optimized image imports.
- * Include this in your tsconfig.json `types` array:
- *
- * ```json
- * {
- *   "compilerOptions": {
- *     "types": ["@useavalon/avalon/types"]
- *   }
- * }
- * ```
- */
-
-declare module "*.jpg" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.jpeg" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.png" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.webp" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.avif" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.gif" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.tiff" {
-  const src: string;
-  export default src;
-}
-
-declare module "*.svg" {
-  const src: string;
-  export default src;
-}
-
-// vite-imagetools srcset output
-interface ImageToolsSrcset {
-  src: string;
-  srcset: string;
-  width: number;
-  height: number;
-}
-
-declare module "*&as=srcset" {
-  const srcset: ImageToolsSrcset;
-  export default srcset;
-}
-
-declare module "*?as=srcset" {
-  const srcset: ImageToolsSrcset;
-  export default srcset;
-}
-
-// vite-imagetools picture output (multiple formats)
-interface ImageToolsPicture {
-  sources: Record<string, ImageToolsSrcset>;
-  img: ImageToolsSrcset;
-}
-
-declare module "*&as=picture" {
-  const picture: ImageToolsPicture;
-  export default picture;
-}
-
-declare module "*?as=picture" {
-  const picture: ImageToolsPicture;
-  export default picture;
-}
-
-// vite-imagetools metadata output
-interface ImageToolsMetadata {
-  src: string;
-  width: number;
-  height: number;
-  format: string;
-}
-
-declare module "*&as=metadata" {
-  const metadata: ImageToolsMetadata;
-  export default metadata;
-}
-
-declare module "*?as=metadata" {
-  const metadata: ImageToolsMetadata;
-  export default metadata;
-}
+/**
+ * Type declarations for image imports with vite-imagetools
+ *
+ * These types enable TypeScript support for optimized image imports.
+ * Include this in your tsconfig.json `types` array:
+ *
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "types": ["@useavalon/avalon/types"]
+ *   }
+ * }
+ * ```
+ */
+
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.jpeg" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.avif" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.gif" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.tiff" {
+  const src: string;
+  export default src;
+}
+
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+// vite-imagetools srcset output
+interface ImageToolsSrcset {
+  src: string;
+  srcset: string;
+  width: number;
+  height: number;
+}
+
+declare module "*&as=srcset" {
+  const srcset: ImageToolsSrcset;
+  export default srcset;
+}
+
+declare module "*?as=srcset" {
+  const srcset: ImageToolsSrcset;
+  export default srcset;
+}
+
+// vite-imagetools picture output (multiple formats)
+interface ImageToolsPicture {
+  sources: Record<string, ImageToolsSrcset>;
+  img: ImageToolsSrcset;
+}
+
+declare module "*&as=picture" {
+  const picture: ImageToolsPicture;
+  export default picture;
+}
+
+declare module "*?as=picture" {
+  const picture: ImageToolsPicture;
+  export default picture;
+}
+
+// vite-imagetools metadata output
+interface ImageToolsMetadata {
+  src: string;
+  width: number;
+  height: number;
+  format: string;
+}
+
+declare module "*&as=metadata" {
+  const metadata: ImageToolsMetadata;
+  export default metadata;
+}
+
+declare module "*?as=metadata" {
+  const metadata: ImageToolsMetadata;
+  export default metadata;
+}

package/dist/src/types/index.d.ts

@@ -1,22 +1,22 @@
-/**
- * Avalon type definitions.
- * 
- * Include this in your tsconfig.json `types` array to get island prop support:
- * 
- * ```json
- * {
- *   "compilerOptions": {
- *     "types": ["@useavalon/avalon/types"]
- *   }
- * }
- * ```
- */
-
-// Re-export island prop types
-export * from './island-prop.d.ts';
-
-// Import JSX augmentations (side-effect import for type augmentation)
-import './island-jsx.d.ts';
-
-// Import image type declarations
-import './image.d.ts';
+/**
+ * Avalon type definitions.
+ * 
+ * Include this in your tsconfig.json `types` array to get island prop support:
+ * 
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "types": ["@useavalon/avalon/types"]
+ *   }
+ * }
+ * ```
+ */
+
+// Re-export island prop types
+export * from './island-prop.d.ts';
+
+// Import JSX augmentations (side-effect import for type augmentation)
+import './island-jsx.d.ts';
+
+// Import image type declarations
+import './image.d.ts';

package/dist/src/types/island-jsx.d.ts

@@ -1,33 +1,33 @@
-/**
- * JSX augmentation for the `island` prop.
- *
- * Automatically included via tsconfig.json `compilerOptions.types`.
- */
-
-import type { IslandDirective } from './island-prop.d.ts';
-
-declare module 'preact' {
-  namespace JSX {
-    interface IntrinsicAttributes {
-      island?: IslandDirective;
-    }
-  }
-}
-
-// Augment the global JSX namespace so the `island` prop is accepted on
-// non-Preact components (Svelte, Solid) when used in a Preact JSX context.
-declare global {
-  namespace JSX {
-    interface IntrinsicAttributes {
-      island?: IslandDirective;
-    }
-  }
-}
-
-// Augment Vue's ComponentCustomProps so Volar accepts `island` on all Vue SFCs.
-declare module '@vue/runtime-core' {
-  interface ComponentCustomProps {
-    island?: IslandDirective;
-  }
-}
-
+/**
+ * JSX augmentation for the `island` prop.
+ *
+ * Automatically included via tsconfig.json `compilerOptions.types`.
+ */
+
+import type { IslandDirective } from './island-prop.d.ts';
+
+declare module 'preact' {
+  namespace JSX {
+    interface IntrinsicAttributes {
+      island?: IslandDirective;
+    }
+  }
+}
+
+// Augment the global JSX namespace so the `island` prop is accepted on
+// non-Preact components (Svelte, Solid) when used in a Preact JSX context.
+declare global {
+  namespace JSX {
+    interface IntrinsicAttributes {
+      island?: IslandDirective;
+    }
+  }
+}
+
+// Augment Vue's ComponentCustomProps so Volar accepts `island` on all Vue SFCs.
+declare module '@vue/runtime-core' {
+  interface ComponentCustomProps {
+    island?: IslandDirective;
+  }
+}
+

package/dist/src/types/island-prop.d.ts

@@ -1,20 +1,20 @@
-/**
- * Type augmentation for the `island` prop on island components.
- *
- * When importing a component from the islands directory and using it in a page,
- * you can pass an `island` prop to control hydration behavior. The Vite transform
- * plugin intercepts this at build time and converts it to a renderIsland() call.
- *
- * Usage:
- *   import Counter from '../islands/Counter.tsx';
- *   <Counter island={{ condition: 'on:interaction' }} someProp={42} />
- */
-
-export interface IslandDirective {
-  /** Hydration condition */
-  condition?: 'on:visible' | 'on:interaction' | 'on:idle' | 'on:client' | `media:${string}`;
-  /** Force SSR-only rendering without client hydration */
-  ssrOnly?: boolean;
-  /** Whether to render server-side (default: true) */
-  ssr?: boolean;
-}
+/**
+ * Type augmentation for the `island` prop on island components.
+ *
+ * When importing a component from the islands directory and using it in a page,
+ * you can pass an `island` prop to control hydration behavior. The Vite transform
+ * plugin intercepts this at build time and converts it to a renderIsland() call.
+ *
+ * Usage:
+ *   import Counter from '../islands/Counter.tsx';
+ *   <Counter island={{ condition: 'on:interaction' }} someProp={42} />
+ */
+
+export interface IslandDirective {
+  /** Hydration condition */
+  condition?: 'on:visible' | 'on:interaction' | 'on:idle' | 'on:client' | `media:${string}`;
+  /** Force SSR-only rendering without client hydration */
+  ssrOnly?: boolean;
+  /** Whether to render server-side (default: true) */
+  ssr?: boolean;
+}

package/dist/src/types/mdx.d.ts

@@ -1,6 +1,6 @@
-import type { ComponentType } from 'preact';
-
-declare module '*.mdx' {
-	const MDXComponent: ComponentType<Record<string, unknown>>;
-	export default MDXComponent;
-}
+import type { ComponentType } from 'preact';
+
+declare module '*.mdx' {
+	const MDXComponent: ComponentType<Record<string, unknown>>;
+	export default MDXComponent;
+}

package/dist/src/types/urlpattern.d.ts

@@ -1,49 +1,49 @@
-/**
- * Global URLPattern type declaration.
- * URLPattern is available at runtime in Node 22+, Bun, and Deno,
- * but TypeScript's lib.dom.d.ts may not include it in all configurations.
- */
-declare class URLPattern {
-	constructor(init?: URLPatternInit | string, baseURL?: string);
-	readonly protocol: string;
-	readonly username: string;
-	readonly password: string;
-	readonly hostname: string;
-	readonly port: string;
-	readonly pathname: string;
-	readonly search: string;
-	readonly hash: string;
-	test(input?: URLPatternInput, baseURL?: string): boolean;
-	exec(input?: URLPatternInput, baseURL?: string): URLPatternResult | null;
-}
-
-interface URLPatternInit {
-	baseURL?: string;
-	username?: string;
-	password?: string;
-	hostname?: string;
-	port?: string;
-	pathname?: string;
-	search?: string;
-	hash?: string;
-	protocol?: string;
-}
-
-type URLPatternInput = URLPatternInit | string;
-
-interface URLPatternComponentResult {
-	input: string;
-	groups: Record<string, string | undefined>;
-}
-
-interface URLPatternResult {
-	inputs: [URLPatternInput, string?];
-	protocol: URLPatternComponentResult;
-	username: URLPatternComponentResult;
-	password: URLPatternComponentResult;
-	hostname: URLPatternComponentResult;
-	port: URLPatternComponentResult;
-	pathname: URLPatternComponentResult;
-	search: URLPatternComponentResult;
-	hash: URLPatternComponentResult;
-}
+/**
+ * Global URLPattern type declaration.
+ * URLPattern is available at runtime in Node 22+, Bun, and Deno,
+ * but TypeScript's lib.dom.d.ts may not include it in all configurations.
+ */
+declare class URLPattern {
+	constructor(init?: URLPatternInit | string, baseURL?: string);
+	readonly protocol: string;
+	readonly username: string;
+	readonly password: string;
+	readonly hostname: string;
+	readonly port: string;
+	readonly pathname: string;
+	readonly search: string;
+	readonly hash: string;
+	test(input?: URLPatternInput, baseURL?: string): boolean;
+	exec(input?: URLPatternInput, baseURL?: string): URLPatternResult | null;
+}
+
+interface URLPatternInit {
+	baseURL?: string;
+	username?: string;
+	password?: string;
+	hostname?: string;
+	port?: string;
+	pathname?: string;
+	search?: string;
+	hash?: string;
+	protocol?: string;
+}
+
+type URLPatternInput = URLPatternInit | string;
+
+interface URLPatternComponentResult {
+	input: string;
+	groups: Record<string, string | undefined>;
+}
+
+interface URLPatternResult {
+	inputs: [URLPatternInput, string?];
+	protocol: URLPatternComponentResult;
+	username: URLPatternComponentResult;
+	password: URLPatternComponentResult;
+	hostname: URLPatternComponentResult;
+	port: URLPatternComponentResult;
+	pathname: URLPatternComponentResult;
+	search: URLPatternComponentResult;
+	hash: URLPatternComponentResult;
+}

package/dist/src/types/vite-env.d.ts

@@ -1,11 +1,11 @@
-/// <reference types="vite/client" />
-
-interface ImportMetaEnv {
-	readonly VITE_APP_TITLE: string;
-	// more env variables...
-}
-
-interface ImportMeta {
-	readonly env: ImportMetaEnv;
-	readonly hot?: import('vite/types/hot').ViteHotContext;
-}
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+	readonly VITE_APP_TITLE: string;
+	// more env variables...
+}
+
+interface ImportMeta {
+	readonly env: ImportMetaEnv;
+	readonly hot?: import('vite/types/hot').ViteHotContext;
+}

package/dist/src/vite-plugin/nitro-integration.js

@@ -1,4 +1,4 @@
-import{nitro as e}from"nitro/vite";import{stat as t}from"node:fs/promises";import{existsSync as n}from"node:fs";import{createRequire as r}from"node:module";import{dirname as i,join as a}from"node:path";import{createNitroConfig as o}from"../nitro/config.js";import{createNitroBuildPlugin as s,createIslandManifestPlugin as c,createSourceMapPlugin as l,createSourceMapConfig as u}from"../nitro/index.js";import{discoverScopedMiddleware as d,executeScopedMiddleware as f,clearMiddlewareCache as p}from"../middleware/index.js";import{generateErrorPage as m,generateFallback404 as h}from"../render/error-pages.js";import{collectCssFromModuleGraph as g,injectSsrCss as _}from"../render/collect-css.js";import{getUniversalCSSForHead as v}from"../islands/universal-css-collector.js";import{getUniversalHeadForInjection as y}from"../islands/universal-head-collector.js";function b(e){let t=a(i(r(import.meta.url).resolve(`@useavalon/avalon`)),e);if(e.endsWith(`.ts`)&&!n(t)){let e=t.replace(/\.ts$/,`.js`);if(n(e))return e}return t}function x(e,t){let o=a(i(r(a(process.cwd(),`package.json`)).resolve(`@useavalon/${e}`)),t);if(t.endsWith(`.ts`)&&!n(o)){let e=o.replace(/\.ts$/,`.js`);if(n(e))return e}return o}export const VIRTUAL_MODULE_IDS={PAGE_ROUTES:`virtual:avalon/page-routes`,PAGE_LOADER:`virtual:avalon/page-loader`,ISLAND_MANIFEST:`virtual:avalon/island-manifest`,RUNTIME_CONFIG:`virtual:avalon/runtime-config`,CONFIG:`virtual:avalon/config`};export const RESOLVED_VIRTUAL_IDS={PAGE_ROUTES:`\0`+VIRTUAL_MODULE_IDS.PAGE_ROUTES,PAGE_LOADER:`\0`+VIRTUAL_MODULE_IDS.PAGE_LOADER,ISLAND_MANIFEST:`\0`+VIRTUAL_MODULE_IDS.ISLAND_MANIFEST,RUNTIME_CONFIG:`\0`+VIRTUAL_MODULE_IDS.RUNTIME_CONFIG,CONFIG:`\0`+VIRTUAL_MODULE_IDS.CONFIG};export function createNitroIntegration(t,n={}){let r=o(n,t),i={preset:r.preset,serverDir:n.serverDir??r.serverDir??`./server`,routeRules:r.routeRules,runtimeConfig:r.runtimeConfig,compatibilityDate:r.compatibilityDate,scanDirs:[`.`],noExternals:[`estree-walker`,/^@useavalon\//,/^estree-util/]};n.renderer===!1?i.renderer=!1:r.renderer&&(i.renderer=r.renderer),r.publicRuntimeConfig&&(i.publicRuntimeConfig=r.publicRuntimeConfig),r.publicAssets&&(i.publicAssets=r.publicAssets),r.compressPublicAssets&&(i.compressPublicAssets=r.compressPublicAssets),r.serverEntry&&(i.serverEntry=r.serverEntry);let a=e(i),d=createNitroCoordinationPlugin({avalonConfig:t,nitroConfig:n,verbose:t.verbose}),f=createVirtualModulesPlugin({avalonConfig:t,nitroConfig:n,verbose:t.verbose}),p=s(t,n),m=c(t,{verbose:t.verbose,generatePreloadHints:!0}),h=l(u(n.preset??`node_server`,t.isDev));return{nitroOptions:r,plugins:[...Array.isArray(a)?a:[a],d,f,p,m,h]}}export function createNitroCoordinationPlugin(e){let{avalonConfig:t,verbose:n}=e;return{name:`avalon:nitro-coordination`,enforce:`pre`,configResolved(e){globalThis.__avalonConfig=t},configureServer(e){globalThis.__viteDevServer=e;let r=null;async function i(){return r||=await d({baseDir:`${e.config.root||process.cwd()}/src`,devMode:!1}),r}function a(){r=null}A(e,t,n,a),i().catch(e=>{console.warn(`[middleware] Failed to discover middleware:`,e)}),O(e,t.integrations,n).catch(e=>{console.error(`[prewarm] Core modules pre-warm failed:`,e)}),e.middlewares.use(async(r,a,o)=>{let s=r.url||`/`;if(s.endsWith(`.html`)&&(s=s.slice(0,-5)||`/`),s===`/index`&&(s=`/`),s.startsWith(`/@`)||s.startsWith(`/__`)||s.startsWith(`/node_modules/`)||s.startsWith(`/src/client/`)||s.startsWith(`/packages/`)||s.includes(`.`)&&!s.endsWith(`/`)||s.startsWith(`/api/`))return o();try{if(await E(e,s,r,a,i,n)||await R(e,s,t,a))return;let o=await z(e,s,t);if(o){a.statusCode=200,a.setHeader(`Content-Type`,`text/html`),a.end(o);return}await D(e,s,a,t)}catch(e){console.error(`[SSR Error]`,e),a.statusCode=500,a.setHeader(`Content-Type`,`text/html`),a.end(m(e))}})},buildStart(){}}}async function E(e,t,n,r,i,a){let o=performance.now(),s=await i();if(s.length===0)return!1;let c={};for(let[e,t]of Object.entries(n.headers))typeof t==`string`?c[e]=t:Array.isArray(t)&&(c[e]=t.join(`, `));let l=`http://${n.headers.host||`localhost`}${t}`,u=await f({url:l,method:n.method||`GET`,path:t,node:{req:n,res:r},req:new Request(l,{method:n.method||`GET`,headers:c}),context:{}},s,{devMode:!1}),d=performance.now()-o;return d>100&&console.warn(`⚠️ Slow middleware: ${d.toFixed(0)}ms for ${t}`),u?(r.statusCode=u.status,u.headers.forEach((e,t)=>{r.setHeader(t,e)}),r.end(await u.text()),!0):!1}async function D(e,t,n,r){try{let{discoverErrorPages:i,getErrorPageModule:a,generateDefaultErrorPage:o}=await import(`../nitro/error-handler.js`),s=a(404,await i({isDev:r.isDev,pagesDir:r.pagesDir,loadPageModule:async t=>await e.ssrLoadModule(t)}));if(s?.default&&typeof s.default==`function`){let{renderToHtml:e}=await import(`../render/ssr.js`),r=s.default,i=await e({component:()=>r({statusCode:404,message:`Page not found: ${t}`,url:t})},{});n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(i);return}let c=o(404,`Page not found: ${t}`,r.isDev);n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(c)}catch{n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(h(t))}}async function O(e,t,n){let r=performance.now(),i=[{path:b(`src/render/ssr.ts`),assignTo:`ssr`},{path:b(`src/core/layout/enhanced-layout-resolver.ts`),assignTo:`layout`},{path:b(`src/middleware/index.ts`),assignTo:null},...t.map(e=>({path:x(e,`server/renderer.ts`),assignTo:null}))],a=(await Promise.allSettled(i.map(async({path:t,assignTo:n})=>{let r=await e.ssrLoadModule(t);n===`ssr`&&(I=r),n===`layout`&&(L=r)}))).filter(e=>e.status===`fulfilled`).length,o=performance.now()-r;n&&a>0&&console.log(`🔥 SSR ready in ${o.toFixed(0)}ms (${a}/${i.length} core modules)`)}export function createVirtualModulesPlugin(e){let{avalonConfig:t,nitroConfig:n,verbose:r}=e;return{name:`avalon:nitro-virtual-modules`,enforce:`pre`,resolveId(e){return e===VIRTUAL_MODULE_IDS.PAGE_ROUTES?RESOLVED_VIRTUAL_IDS.PAGE_ROUTES:e===VIRTUAL_MODULE_IDS.PAGE_LOADER?RESOLVED_VIRTUAL_IDS.PAGE_LOADER:e===VIRTUAL_MODULE_IDS.ISLAND_MANIFEST?RESOLVED_VIRTUAL_IDS.ISLAND_MANIFEST:e===VIRTUAL_MODULE_IDS.RUNTIME_CONFIG?RESOLVED_VIRTUAL_IDS.RUNTIME_CONFIG:e===VIRTUAL_MODULE_IDS.CONFIG?RESOLVED_VIRTUAL_IDS.CONFIG:null},async load(e){return e===RESOLVED_VIRTUAL_IDS.PAGE_ROUTES?await j(t,r):e===RESOLVED_VIRTUAL_IDS.PAGE_LOADER?await M(t,r):e===RESOLVED_VIRTUAL_IDS.ISLAND_MANIFEST?N():e===RESOLVED_VIRTUAL_IDS.RUNTIME_CONFIG?P(t,n):e===RESOLVED_VIRTUAL_IDS.CONFIG?generateConfigModule(t,n):null},handleHotUpdate({file:e,server:n}){if(e.includes(t.pagesDir)){let e=n.moduleGraph.getModuleById(RESOLVED_VIRTUAL_IDS.PAGE_ROUTES);e&&n.moduleGraph.invalidateModule(e)}if(e.includes(`vite.config`)||e.includes(`avalon.config`)||e.includes(`nitro.config`)){let e=n.moduleGraph.getModuleById(RESOLVED_VIRTUAL_IDS.CONFIG);e&&n.moduleGraph.invalidateModule(e)}}}}function A(e,t,n,r){e.watcher.on(`change`,e=>{e.includes(`_middleware`)&&(p(),r?.()),(e.includes(`/render/`)||e.includes(`/layout/`)||e.includes(`/islands/`))&&(I=null,L=null),(e.includes(`/layouts/`)||e.includes(`_layout`))&&globalThis.__avalonLayoutResolver?.clearCache?.()}),e.watcher.on(`add`,e=>{e.includes(`_middleware`)&&(p(),r?.())}),e.watcher.on(`unlink`,e=>{e.includes(`_middleware`)&&(p(),r?.())})}async function j(e,t){try{let{getAllPageDirs:t}=await import(`./module-discovery.js`),{discoverPageRoutesFromMultipleDirs:n}=await import(`../nitro/route-discovery.js`),r=await n(await t(e.pagesDir,e.modules,process.cwd()),{developmentMode:e.isDev});return`export const pageRoutes = ${JSON.stringify(r,null,2)};\nexport default pageRoutes;\n`}catch{return`export const pageRoutes = [];
+import{nitro as e}from"nitro/vite";import{stat as t}from"node:fs/promises";import{existsSync as n}from"node:fs";import{createRequire as r}from"node:module";import{dirname as i,join as a}from"node:path";import{createNitroConfig as o}from"../nitro/config.js";import{createNitroBuildPlugin as s,createIslandManifestPlugin as c,createSourceMapPlugin as l,createSourceMapConfig as u}from"../nitro/index.js";import{discoverScopedMiddleware as d,executeScopedMiddleware as f,clearMiddlewareCache as p}from"../middleware/index.js";import{generateErrorPage as m,generateFallback404 as h}from"../render/error-pages.js";import{collectCssFromModuleGraph as g,injectSsrCss as _}from"../render/collect-css.js";import{getUniversalCSSForHead as v}from"../islands/universal-css-collector.js";import{getUniversalHeadForInjection as y}from"../islands/universal-head-collector.js";function b(e){let t=a(i(r(import.meta.url).resolve(`@useavalon/avalon`)),e);if(e.endsWith(`.ts`)&&!n(t)){let e=t.replace(/\.ts$/,`.js`);if(n(e))return e}return t}function x(e,t){let o=a(i(r(a(process.cwd(),`package.json`)).resolve(`@useavalon/${e}`)),t);if(t.endsWith(`.ts`)&&!n(o)){let e=o.replace(/\.ts$/,`.js`);if(n(e))return e}return o}export const VIRTUAL_MODULE_IDS={PAGE_ROUTES:`virtual:avalon/page-routes`,PAGE_LOADER:`virtual:avalon/page-loader`,ISLAND_MANIFEST:`virtual:avalon/island-manifest`,RUNTIME_CONFIG:`virtual:avalon/runtime-config`,CONFIG:`virtual:avalon/config`};export const RESOLVED_VIRTUAL_IDS={PAGE_ROUTES:`\0`+VIRTUAL_MODULE_IDS.PAGE_ROUTES,PAGE_LOADER:`\0`+VIRTUAL_MODULE_IDS.PAGE_LOADER,ISLAND_MANIFEST:`\0`+VIRTUAL_MODULE_IDS.ISLAND_MANIFEST,RUNTIME_CONFIG:`\0`+VIRTUAL_MODULE_IDS.RUNTIME_CONFIG,CONFIG:`\0`+VIRTUAL_MODULE_IDS.CONFIG};export function createNitroIntegration(t,n={}){let r=o(n,t),i={preset:r.preset,serverDir:n.serverDir??r.serverDir??`./server`,routeRules:r.routeRules,runtimeConfig:r.runtimeConfig,compatibilityDate:r.compatibilityDate,scanDirs:[`.`],noExternals:[`estree-walker`,/^@useavalon\//,/^estree-util/]};n.renderer===!1?i.renderer=!1:r.renderer&&(i.renderer=r.renderer),r.publicRuntimeConfig&&(i.publicRuntimeConfig=r.publicRuntimeConfig),r.publicAssets&&(i.publicAssets=r.publicAssets),r.compressPublicAssets&&(i.compressPublicAssets=r.compressPublicAssets),r.serverEntry&&(i.serverEntry=r.serverEntry);let a=r.traceDeps??[];i.traceDeps=[...new Set([`undici`,...a])],r.prerender&&(i.prerender={routes:[],crawlLinks:!1});let d=e(i),f=createNitroCoordinationPlugin({avalonConfig:t,nitroConfig:n,verbose:t.verbose}),p=createVirtualModulesPlugin({avalonConfig:t,nitroConfig:n,verbose:t.verbose}),m=s(t,n),h=c(t,{verbose:t.verbose,generatePreloadHints:!0}),g=l(u(n.preset??`node_server`,t.isDev));return{nitroOptions:r,plugins:[...Array.isArray(d)?d:[d],f,p,m,h,g]}}export function createNitroCoordinationPlugin(e){let{avalonConfig:t,verbose:n}=e;return{name:`avalon:nitro-coordination`,enforce:`pre`,configResolved(e){globalThis.__avalonConfig=t},configureServer(e){globalThis.__viteDevServer=e;let r=null;async function i(){return r||=await d({baseDir:`${e.config.root||process.cwd()}/src`,devMode:!1}),r}function a(){r=null}A(e,t,n,a),i().catch(e=>{console.warn(`[middleware] Failed to discover middleware:`,e)}),O(e,t.integrations,n).catch(e=>{console.error(`[prewarm] Core modules pre-warm failed:`,e)}),e.middlewares.use(async(r,a,o)=>{let s=r.url||`/`;if(s.endsWith(`.html`)&&(s=s.slice(0,-5)||`/`),s===`/index`&&(s=`/`),s.startsWith(`/@`)||s.startsWith(`/__`)||s.startsWith(`/node_modules/`)||s.startsWith(`/src/client/`)||s.startsWith(`/packages/`)||s.includes(`.`)&&!s.endsWith(`/`)||s.startsWith(`/api/`))return o();try{if(await E(e,s,r,a,i,n)||await R(e,s,t,a))return;let o=await z(e,s,t);if(o){a.statusCode=200,a.setHeader(`Content-Type`,`text/html`),a.end(o);return}await D(e,s,a,t)}catch(e){console.error(`[SSR Error]`,e),a.statusCode=500,a.setHeader(`Content-Type`,`text/html`),a.end(m(e))}})},buildStart(){}}}async function E(e,t,n,r,i,a){let o=performance.now(),s=await i();if(s.length===0)return!1;let c={};for(let[e,t]of Object.entries(n.headers))typeof t==`string`?c[e]=t:Array.isArray(t)&&(c[e]=t.join(`, `));let l=`http://${n.headers.host||`localhost`}${t}`,u=await f({url:l,method:n.method||`GET`,path:t,node:{req:n,res:r},req:new Request(l,{method:n.method||`GET`,headers:c}),context:{}},s,{devMode:!1}),d=performance.now()-o;return d>100&&console.warn(`⚠️ Slow middleware: ${d.toFixed(0)}ms for ${t}`),u?(r.statusCode=u.status,u.headers.forEach((e,t)=>{r.setHeader(t,e)}),r.end(await u.text()),!0):!1}async function D(e,t,n,r){try{let{discoverErrorPages:i,getErrorPageModule:a,generateDefaultErrorPage:o}=await import(`../nitro/error-handler.js`),s=a(404,await i({isDev:r.isDev,pagesDir:r.pagesDir,loadPageModule:async t=>await e.ssrLoadModule(t)}));if(s?.default&&typeof s.default==`function`){let{renderToHtml:e}=await import(`../render/ssr.js`),r=s.default,i=await e({component:()=>r({statusCode:404,message:`Page not found: ${t}`,url:t})},{});n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(i);return}let c=o(404,`Page not found: ${t}`,r.isDev);n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(c)}catch{n.statusCode=404,n.setHeader(`Content-Type`,`text/html`),n.end(h(t))}}async function O(e,t,n){let r=performance.now(),i=[{path:b(`src/render/ssr.ts`),assignTo:`ssr`},{path:b(`src/core/layout/enhanced-layout-resolver.ts`),assignTo:`layout`},{path:b(`src/middleware/index.ts`),assignTo:null},...t.map(e=>({path:x(e,`server/renderer.ts`),assignTo:null}))],a=(await Promise.allSettled(i.map(async({path:t,assignTo:n})=>{let r=await e.ssrLoadModule(t);n===`ssr`&&(I=r),n===`layout`&&(L=r)}))).filter(e=>e.status===`fulfilled`).length,o=performance.now()-r;n&&a>0&&console.log(`🔥 SSR ready in ${o.toFixed(0)}ms (${a}/${i.length} core modules)`)}export function createVirtualModulesPlugin(e){let{avalonConfig:t,nitroConfig:n,verbose:r}=e;return{name:`avalon:nitro-virtual-modules`,enforce:`pre`,resolveId(e){return e===VIRTUAL_MODULE_IDS.PAGE_ROUTES?RESOLVED_VIRTUAL_IDS.PAGE_ROUTES:e===VIRTUAL_MODULE_IDS.PAGE_LOADER?RESOLVED_VIRTUAL_IDS.PAGE_LOADER:e===VIRTUAL_MODULE_IDS.ISLAND_MANIFEST?RESOLVED_VIRTUAL_IDS.ISLAND_MANIFEST:e===VIRTUAL_MODULE_IDS.RUNTIME_CONFIG?RESOLVED_VIRTUAL_IDS.RUNTIME_CONFIG:e===VIRTUAL_MODULE_IDS.CONFIG?RESOLVED_VIRTUAL_IDS.CONFIG:null},async load(e){return e===RESOLVED_VIRTUAL_IDS.PAGE_ROUTES?await j(t,r):e===RESOLVED_VIRTUAL_IDS.PAGE_LOADER?await M(t,r):e===RESOLVED_VIRTUAL_IDS.ISLAND_MANIFEST?N():e===RESOLVED_VIRTUAL_IDS.RUNTIME_CONFIG?P(t,n):e===RESOLVED_VIRTUAL_IDS.CONFIG?generateConfigModule(t,n):null},handleHotUpdate({file:e,server:n}){if(e.includes(t.pagesDir)){let e=n.moduleGraph.getModuleById(RESOLVED_VIRTUAL_IDS.PAGE_ROUTES);e&&n.moduleGraph.invalidateModule(e)}if(e.includes(`vite.config`)||e.includes(`avalon.config`)||e.includes(`nitro.config`)){let e=n.moduleGraph.getModuleById(RESOLVED_VIRTUAL_IDS.CONFIG);e&&n.moduleGraph.invalidateModule(e)}}}}function A(e,t,n,r){e.watcher.on(`change`,e=>{e.includes(`_middleware`)&&(p(),r?.()),(e.includes(`/render/`)||e.includes(`/layout/`)||e.includes(`/islands/`))&&(I=null,L=null),(e.includes(`/layouts/`)||e.includes(`_layout`))&&globalThis.__avalonLayoutResolver?.clearCache?.()}),e.watcher.on(`add`,e=>{e.includes(`_middleware`)&&(p(),r?.())}),e.watcher.on(`unlink`,e=>{e.includes(`_middleware`)&&(p(),r?.())})}async function j(e,t){try{let{getAllPageDirs:t}=await import(`./module-discovery.js`),{discoverPageRoutesFromMultipleDirs:n}=await import(`../nitro/route-discovery.js`),r=await n(await t(e.pagesDir,e.modules,process.cwd()),{developmentMode:e.isDev});return`export const pageRoutes = ${JSON.stringify(r,null,2)};\nexport default pageRoutes;\n`}catch{return`export const pageRoutes = [];
 export default pageRoutes;
 `}}async function M(e,t){try{let{getAllPageDirs:t}=await import(`./module-discovery.js`),{discoverPageRoutesFromMultipleDirs:n}=await import(`../nitro/route-discovery.js`),{relative:r}=await import(`node:path`),i=process.cwd(),a=await n(await t(e.pagesDir,e.modules,i),{developmentMode:e.isDev}),o=[],s=[];for(let e=0;e<a.length;e++){let t=a[e],n=`page_${e}`,c=r(i,t.filePath).replaceAll(`\\`,`/`),l=c.startsWith(`/`)?c:`/`+c;o.push(`import * as ${n} from '${l}';`),s.push(`  { pattern: ${JSON.stringify(t.pattern)}, params: ${JSON.stringify(t.params)}, module: ${n} }`)}return[...o,``,`const routes = [`,s.join(`,
 `),`];`,``,`/**`,` * Match a pathname against discovered routes and return the page module.`,` * Uses the same pattern matching as Avalon's route discovery.`,` */`,`export function loadPage(pathname) {`,`  const cleanPath = pathname.split('?')[0];`,`  for (const route of routes) {`,`    if (matchRoute(cleanPath, route.pattern, route.params)) {`,`      return route.module;`,`    }`,`  }`,`  return null;`,`}`,``,`function matchRoute(pathname, pattern, paramNames) {`,`  // Exact match`,`  if (pattern === pathname) return true;`,`  // Normalize trailing slashes`,`  const normPath = pathname === '/' ? '/' : pathname.replace(/\\/$/, '');`,`  const normPattern = pattern === '/' ? '/' : pattern.replace(/\\/$/, '');`,`  if (normPath === normPattern) return true;`,`  // Dynamic segments: /users/:id matches /users/123`,`  if (paramNames.length > 0) {`,`    const patternParts = normPattern.split('/');`,`    const pathParts = normPath.split('/');`,`    if (patternParts.length !== pathParts.length) return false;`,`    return patternParts.every((part, i) => part.startsWith(':') || part === pathParts[i]);`,`  }`,`  return false;`,`}`,``,`export default { loadPage, routes };`,``].join(`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@useavalon/avalon",
-	"version": "0.1.46",
+	"version": "0.1.47",
 	"description": "Multi-framework islands architecture for the modern web",
 	"license": "MIT",
 	"type": "module",
@@ -85,7 +85,11 @@
 			"default": "./dist/src/nitro/config.js"
 		},
 		"./types/island-jsx": "./dist/src/types/island-jsx.d.ts",
-		"./types": "./dist/src/types/index.d.ts"
+		"./types": "./dist/src/types/index.d.ts",
+		"./prerender": {
+			"types": "./dist/src/prerender/index.d.ts",
+			"default": "./dist/src/prerender/index.js"
+		}
 	},
 	"typesVersions": {
 		"*": {