@useavalon/avalon 0.3.2-canary.8 → 0.4.0

package/dist/src/render/dev-css-select.js

@@ -0,0 +1,5 @@
+export function stripTrailingSlash(e){return e===`/`?`/`:e.endsWith(`/`)?e.slice(0,-1):e}export function matchPathPattern(t,n){let r=stripTrailingSlash(t),i=stripTrailingSlash(n);if(r===i)return!0;let a=i.split(`/`),o=r.split(`/`);for(let e=0;e<a.length;e++){let t=a[e];if(t===`**`)return!0;if(e>=o.length)return!1;if(t.startsWith(`:`)){if(!o[e])return!1;continue}if(t!==o[e])return!1}return o.length<=a.length}export function layoutPrefixMatches(t,n){if(n===`/`)return t===`/`;let r=stripTrailingSlash(t),i=stripTrailingSlash(n);return r===i||r.startsWith(`${i}/`)}export function selectDevCssHrefs(e,n,r){let i=n.split(`?`)[0]??n,a=e.routes.find(e=>matchPathPattern(i,e.pattern));return a?r?a.pageHrefs:a.hrefs:r?e.globalHrefs:e.fallbackHrefs}function i(e){return e.replaceAll(`&`,`&amp;`).replaceAll(`"`,`&quot;`).replaceAll(`<`,`&lt;`)}export const DEV_CSS_HMR_CLIENT_SRC=`/@id/__x00__virtual:avalon/dev-css-hmr`;export function appendDevCssLinks(e,t){if(!e.includes(`</head>`))return e;let n=t.map(e=>{let t=i(e);return`<link rel="stylesheet" href="${t}?direct" data-avalon-css="${t}">`}).join(`
+`),r=[];n&&r.push(n),e.includes(`/@vite/client`)||r.push(`<script type="module" src="/@vite/client"><\/script>`),e.includes(`virtual:avalon/dev-css-hmr`)||r.push(`<script type="module" src="/@id/__x00__virtual:avalon/dev-css-hmr"><\/script>`);let a=r.join(`
+`);return e.replace(`</head>`,`${a}${a?`
+`:``}</head>`)}export function appendDevStyleTags(e,t){if(t.length===0||!e.includes(`</head>`))return e;let n=t.map(e=>{let t=e.css.replaceAll(/<\/style/gi,String.raw`<\/style`);return`<style type="text/css" data-avalon-css="${i(e.href)}">${t}</style>`}).join(`
+`);return e.replace(`</head>`,`${n}\n</head>`)}

package/dist/src/schemas/routing/index.d.ts

@@ -15,6 +15,7 @@ export declare const routingValidators: {
         generateMetadata?: any;
         loader?: any;
         frontmatter?: Record<string, any>;
+        clientNavigation?: boolean;
     };
     readonly routeDiscoveryOptions: (data: unknown) => {
         pagesDirectory: string;
@@ -105,6 +106,7 @@ export declare const safeRoutingValidators: {
         generateMetadata?: any;
         loader?: any;
         frontmatter?: Record<string, any>;
+        clientNavigation?: boolean;
     }>;
     readonly routeDiscoveryOptions: (data: unknown) => import("../index.ts").ValidationResult<{
         pagesDirectory: string;

package/dist/src/schemas/routing.d.ts

@@ -37,6 +37,7 @@ export declare const RoutePageModuleSchema: z.ZodObject<{
     generateMetadata: z.ZodOptional<z.ZodAny>;
     loader: z.ZodOptional<z.ZodAny>;
     frontmatter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    clientNavigation: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /**
  * Route Parameters Schema - Parameters extracted from dynamic routes

package/dist/src/schemas/routing.js

@@ -1 +1 @@
-import{z as e}from"zod";export const RouteTypeSchema=e.enum([`static`,`dynamic`,`catch-all`,`index`,`group`]);export const FileSystemRouteSchema=e.object({pattern:e.any(),filePath:e.string().min(1),routeType:RouteTypeSchema,dynamicSegments:e.array(e.string()),priority:e.number().int().min(0),isPrivate:e.boolean(),routeGroup:e.string().optional()});export const RoutePageModuleSchema=e.object({default:e.any(),layoutConfig:e.any().optional(),generateMetadata:e.any().optional(),loader:e.any().optional(),frontmatter:e.record(e.string(),e.any()).optional()});export const RouteParamsSchema=e.record(e.string(),e.string());export const LoaderContextSchema=e.object({request:e.instanceof(Request),url:e.instanceof(URL),params:RouteParamsSchema,query:e.instanceof(URLSearchParams),state:e.instanceof(Map)});export const PagePropsSchema=e.object({params:RouteParamsSchema,query:e.instanceof(URLSearchParams),data:e.unknown().optional()});export const MetadataSchema=e.object({title:e.string().optional(),description:e.string().optional(),keywords:e.array(e.string()).optional(),openGraph:e.object({title:e.string().optional(),description:e.string().optional(),image:e.url().optional(),url:e.url().optional(),type:e.string().optional(),siteName:e.string().optional()}).optional(),twitter:e.object({card:e.enum([`summary`,`summary_large_image`,`app`,`player`]).optional(),title:e.string().optional(),description:e.string().optional(),image:e.url().optional(),site:e.string().optional()}).optional(),schema:e.array(e.record(e.string(),e.unknown())).optional(),canonical:e.url().optional(),robots:e.string().optional()});export const ResolvedMetadataSchema=MetadataSchema.extend({sources:e.array(e.string()).optional(),resolvedAt:e.number().optional()});export const MetadataChainSchema=e.object({global:MetadataSchema.optional(),sections:e.array(e.object({path:e.string(),metadata:MetadataSchema})),page:MetadataSchema.optional()});export const RouteDiscoveryOptionsSchema=e.object({pagesDirectory:e.string().min(1).default(`src/pages`),apiDirectory:e.string().min(1).default(`src/api`),extensions:e.array(e.string()).default([`.tsx`,`.ts`,`.jsx`,`.js`]),excludeDirectories:e.array(e.string()).default([`node_modules`,`.git`]),enableWatching:e.boolean().default(!1),developmentMode:e.boolean().default(!1),quietMode:e.boolean().default(!1)});export const FileSystemRouterConfigSchema=e.object({discovery:RouteDiscoveryOptionsSchema.optional(),enabled:e.boolean().default(!0),fallbackToManual:e.boolean().default(!0),enableCaching:e.boolean().default(!0),cacheTTL:e.number().positive().default(3e5)});export const PageFileSchema=e.object({filePath:e.string().min(1),relativePath:e.string().min(1),extension:e.string().min(1),isPrivate:e.boolean(),routeGroup:e.string().optional(),mtime:e.number().optional()});export const RouteHandlerSchema=e.object({pattern:e.any(),handler:e.any(),metadata:e.object({filePath:e.string(),routeType:RouteTypeSchema,priority:e.number(),dynamicSegments:e.array(e.string())})});export const RouteCacheEntrySchema=e.object({routes:e.array(FileSystemRouteSchema),timestamp:e.number(),fileMtimes:e.record(e.string(),e.number())});export const FileSystemApiRouteSchema=e.object({pattern:e.any(),filePath:e.string().min(1),methods:e.array(e.enum([`GET`,`POST`,`PUT`,`DELETE`,`PATCH`,`HEAD`,`OPTIONS`])),priority:e.number().int().min(0),dynamicSegments:e.array(e.string())});export const FileSystemApiModuleSchema=e.object({GET:e.any().optional(),POST:e.any().optional(),PUT:e.any().optional(),DELETE:e.any().optional(),PATCH:e.any().optional(),HEAD:e.any().optional(),OPTIONS:e.any().optional()});export function isFileSystemRoute(e){return FileSystemRouteSchema.safeParse(e).success}export function isRoutePageModule(e){return RoutePageModuleSchema.safeParse(e).success}export function isMetadata(e){return MetadataSchema.safeParse(e).success}export function isRouteParams(e){return RouteParamsSchema.safeParse(e).success}export function isFileSystemApiModule(e){return FileSystemApiModuleSchema.safeParse(e).success}export{createTypedApiHandler,createTypedMetadataGenerator,createTypedPageComponent,createTypedPageLoader,isValidPageProps,isValidRouteParams,isValidRoutePattern,validatePageComponent}from"../types/routing.js";
+import{z as e}from"zod";export const RouteTypeSchema=e.enum([`static`,`dynamic`,`catch-all`,`index`,`group`]);export const FileSystemRouteSchema=e.object({pattern:e.any(),filePath:e.string().min(1),routeType:RouteTypeSchema,dynamicSegments:e.array(e.string()),priority:e.number().int().min(0),isPrivate:e.boolean(),routeGroup:e.string().optional()});export const RoutePageModuleSchema=e.object({default:e.any(),layoutConfig:e.any().optional(),generateMetadata:e.any().optional(),loader:e.any().optional(),frontmatter:e.record(e.string(),e.any()).optional(),clientNavigation:e.boolean().optional()});export const RouteParamsSchema=e.record(e.string(),e.string());export const LoaderContextSchema=e.object({request:e.instanceof(Request),url:e.instanceof(URL),params:RouteParamsSchema,query:e.instanceof(URLSearchParams),state:e.instanceof(Map)});export const PagePropsSchema=e.object({params:RouteParamsSchema,query:e.instanceof(URLSearchParams),data:e.unknown().optional()});export const MetadataSchema=e.object({title:e.string().optional(),description:e.string().optional(),keywords:e.array(e.string()).optional(),openGraph:e.object({title:e.string().optional(),description:e.string().optional(),image:e.url().optional(),url:e.url().optional(),type:e.string().optional(),siteName:e.string().optional()}).optional(),twitter:e.object({card:e.enum([`summary`,`summary_large_image`,`app`,`player`]).optional(),title:e.string().optional(),description:e.string().optional(),image:e.url().optional(),site:e.string().optional()}).optional(),schema:e.array(e.record(e.string(),e.unknown())).optional(),canonical:e.url().optional(),robots:e.string().optional()});export const ResolvedMetadataSchema=MetadataSchema.extend({sources:e.array(e.string()).optional(),resolvedAt:e.number().optional()});export const MetadataChainSchema=e.object({global:MetadataSchema.optional(),sections:e.array(e.object({path:e.string(),metadata:MetadataSchema})),page:MetadataSchema.optional()});export const RouteDiscoveryOptionsSchema=e.object({pagesDirectory:e.string().min(1).default(`src/pages`),apiDirectory:e.string().min(1).default(`src/api`),extensions:e.array(e.string()).default([`.tsx`,`.ts`,`.jsx`,`.js`]),excludeDirectories:e.array(e.string()).default([`node_modules`,`.git`]),enableWatching:e.boolean().default(!1),developmentMode:e.boolean().default(!1),quietMode:e.boolean().default(!1)});export const FileSystemRouterConfigSchema=e.object({discovery:RouteDiscoveryOptionsSchema.optional(),enabled:e.boolean().default(!0),fallbackToManual:e.boolean().default(!0),enableCaching:e.boolean().default(!0),cacheTTL:e.number().positive().default(3e5)});export const PageFileSchema=e.object({filePath:e.string().min(1),relativePath:e.string().min(1),extension:e.string().min(1),isPrivate:e.boolean(),routeGroup:e.string().optional(),mtime:e.number().optional()});export const RouteHandlerSchema=e.object({pattern:e.any(),handler:e.any(),metadata:e.object({filePath:e.string(),routeType:RouteTypeSchema,priority:e.number(),dynamicSegments:e.array(e.string())})});export const RouteCacheEntrySchema=e.object({routes:e.array(FileSystemRouteSchema),timestamp:e.number(),fileMtimes:e.record(e.string(),e.number())});export const FileSystemApiRouteSchema=e.object({pattern:e.any(),filePath:e.string().min(1),methods:e.array(e.enum([`GET`,`POST`,`PUT`,`DELETE`,`PATCH`,`HEAD`,`OPTIONS`])),priority:e.number().int().min(0),dynamicSegments:e.array(e.string())});export const FileSystemApiModuleSchema=e.object({GET:e.any().optional(),POST:e.any().optional(),PUT:e.any().optional(),DELETE:e.any().optional(),PATCH:e.any().optional(),HEAD:e.any().optional(),OPTIONS:e.any().optional()});export function isFileSystemRoute(e){return FileSystemRouteSchema.safeParse(e).success}export function isRoutePageModule(e){return RoutePageModuleSchema.safeParse(e).success}export function isMetadata(e){return MetadataSchema.safeParse(e).success}export function isRouteParams(e){return RouteParamsSchema.safeParse(e).success}export function isFileSystemApiModule(e){return FileSystemApiModuleSchema.safeParse(e).success}export{createTypedApiHandler,createTypedMetadataGenerator,createTypedPageComponent,createTypedPageLoader,isValidPageProps,isValidRouteParams,isValidRoutePattern,validatePageComponent}from"../types/routing.js";

package/dist/src/server-islands/encryption.js

@@ -1 +1 @@
-import{createCipheriv as e,createDecipheriv as t,randomBytes as n}from"node:crypto";let r=``;try{r=(await import(`virtual:server-island-key`)).serverIslandKey??``}catch{}const i=`aes-256-gcm`;let a,o=!1;export function generateKey(){return n(32).toString(`base64`)}export function getKey(){let e=globalThis.process?.env??{},t=e.AVALON_KEY;if(t){let e=Buffer.from(t,`base64`);if(e.length!==32)throw Error(`AVALON_KEY must be a base64-encoded 256-bit (32-byte) key. Got ${e.length} bytes.`);return t}if(r&&Buffer.from(r,`base64`).length===32)return r;if((e.NODE_ENV??globalThis.process?.env?.NODE_ENV)===`production`)throw Error("AVALON_KEY is required in production for server islands. Generate one with `npx avalon key` and set it as an environment variable so all server instances share the same encryption secret.");return o||(o=!0,console.warn(`[avalon] AVALON_KEY not set — using a per-process key for server islands. This only works for single-process development. Set AVALON_KEY for production.`)),a||=generateKey(),a}function c(e){return e.replaceAll(`+`,`-`).replaceAll(`/`,`_`).replace(/=+$/,``)}function l(e){let t=e.replaceAll(`-`,`+`).replaceAll(`_`,`/`),n=t.length%4;return n===2?t+=`==`:n===3&&(t+=`=`),t}export function encrypt(t,r){let a=Buffer.from(r??getKey(),`base64`);if(a.length!==32)throw Error(`Encryption key must be 32 bytes. Got ${a.length} bytes.`);let o=n(12),s=e(i,a,o),l=Buffer.concat([s.update(t,`utf8`),s.final()]),u=s.getAuthTag();return c(Buffer.concat([o,l,u]).toString(`base64`))}export function decrypt(e,n){let r=Buffer.from(n??getKey(),`base64`);if(r.length!==32)throw Error(`Encryption key must be 32 bytes. Got ${r.length} bytes.`);let a=Buffer.from(l(e),`base64`);if(a.length<28)throw Error(`Invalid encrypted data: too short`);let o=a.subarray(0,12),s=a.subarray(a.length-16),c=a.subarray(12,a.length-16),u=t(i,r,o);return u.setAuthTag(s),Buffer.concat([u.update(c),u.final()]).toString(`utf8`)}
+import{createCipheriv as e,createDecipheriv as t,randomBytes as n}from"node:crypto";let r=``;try{r=(await import(`virtual:server-island-key`)).serverIslandKey??``}catch{}const i=`aes-256-gcm`;let a,o=!1;export function generateKey(){return n(32).toString(`base64`)}function c(){try{let e=globalThis.process?.env;if(e&&typeof e==`object`)return e}catch{}return{}}export function getKey(){let e=c(),t=e.AVALON_KEY;if(t){let e=Buffer.from(t,`base64`);if(e.length!==32)throw Error(`AVALON_KEY must be a base64-encoded 256-bit (32-byte) key. Got ${e.length} bytes.`);return t}if(r&&Buffer.from(r,`base64`).length===32)return r;if(e.NODE_ENV===`production`)throw Error("AVALON_KEY is required in production for server islands. Generate one with `npx avalon key` and set it as an environment variable so all server instances share the same encryption secret.");return o||(o=!0,console.warn(`[avalon] AVALON_KEY not set — using a per-process key for server islands. This only works for single-process development. Set AVALON_KEY for production.`)),a||=generateKey(),a}function l(e){return e.replaceAll(`+`,`-`).replaceAll(`/`,`_`).replace(/=+$/,``)}function u(e){let t=e.replaceAll(`-`,`+`).replaceAll(`_`,`/`),n=t.length%4;return n===2?t+=`==`:n===3&&(t+=`=`),t}export function encrypt(t,r){let a=Buffer.from(r??getKey(),`base64`);if(a.length!==32)throw Error(`Encryption key must be 32 bytes. Got ${a.length} bytes.`);let o=n(12),s=e(i,a,o),c=Buffer.concat([s.update(t,`utf8`),s.final()]),u=s.getAuthTag();return l(Buffer.concat([o,c,u]).toString(`base64`))}export function decrypt(e,n){let r=Buffer.from(n??getKey(),`base64`);if(r.length!==32)throw Error(`Encryption key must be 32 bytes. Got ${r.length} bytes.`);let a=Buffer.from(u(e),`base64`);if(a.length<28)throw Error(`Invalid encrypted data: too short`);let o=a.subarray(0,12),s=a.subarray(a.length-16),c=a.subarray(12,a.length-16),l=t(i,r,o);return l.setAuthTag(s),Buffer.concat([l.update(c),l.final()]).toString(`utf8`)}

package/dist/src/server-islands/endpoint.js

@@ -1,4 +1,4 @@
-import{serverIslandCSS as e,serverIslandLoaders as t}from"virtual:server-island-manifest";import{h as n}from"preact";import r from"preact-render-to-string";import{loadIntegration as i}from"../islands/integration-loader.js";import{escapeJsonForScript as a,generatePerIslandScript as o}from"../islands/per-island-script.js";import{decrypt as s}from"./encryption.js";import{lookupComponent as c}from"./manifest.js";const l=t??{};function u(){return l}function d(e,t){return new Response(e,{status:t,headers:{"Content-Type":`text/plain`}})}export function defineServerIslandHandler(e={}){let{isDev:t=process.env.NODE_ENV!==`production`,defaultCacheControl:n=`private, no-store`}=e;return async e=>{let r=y(e);if(!r)return d(`Missing component ID`,400);let i=await p(e);if(i instanceof Response)return i;let a=m(i,t);if(a instanceof Response)return a;let{props:o,islandMeta:s,srcPath:l}=a,u=c(r)??(t?l:void 0);if(!u)return d(`Component not found`,404);let f=await h(r,u,t,!!s);if(f instanceof Response)return f;let _=await g({componentModule:f,props:o,islandMeta:s,componentId:r,modulePath:u,isDev:t});if(_ instanceof Response)return _;let b=_.html;return s&&(b+=v({componentId:r,islandMeta:s,modulePath:u,props:o,ssrFailed:_.ssrFailed,hydrationRenderId:_.hydrationRenderId,isDev:t})),new Response(b,{status:200,headers:{"Content-Type":`text/html`,"Cache-Control":n}})}}async function p(e){let t;try{t=await S(e)}catch{return d(`Failed to read request body`,400)}return t||d(`Missing encrypted props`,400)}function m(e,t){try{let n;n=t&&e.startsWith(`dev.`)?Buffer.from(e.slice(4),`base64url`).toString(`utf8`):s(e);let r=JSON.parse(n),i={props:r};return r.__island&&(i.islandMeta=r.__island,delete r.__island),r.__src&&(i.srcPath=r.__src,delete r.__src),i}catch{return d(`Bad Request: decryption failed`,400)}}async function h(e,t,n,r){try{let r=u()[e],i;if(r?i=await r():(n&&console.log(`[server-islands] Loading component from:`,t),i=await import(t)),!i.default)throw TypeError(`Module "${t}" does not have a default export`);return i}catch(e){return r&&n?(console.warn(`[server-islands] Component import failed (will render client-side):`,t,e instanceof Error?e.message:e),{default:null}):d(n&&e instanceof Error?e.message:`Component import failed`,500)}}async function g(e){let{componentModule:t,props:i,islandMeta:a,componentId:o,modulePath:s,isDev:c}=e;if(!t.default)return{html:``,ssrFailed:!0};let l=a?.framework??`preact`;try{if(l===`preact`||l===`react`){let e=t.default;return{html:r(n(e,i)),ssrFailed:!1}}return await _({framework:l,component:t.default,props:i,islandMeta:a,componentId:o,modulePath:s,isDev:c})}catch(e){if(a&&c)return{html:``,ssrFailed:!0};let t=c&&e instanceof Error?`${e.message}\n${e.stack}`:``;return console.error(`[server-islands] Render error for`,s,e),d(t||`Internal Server Error`,500)}}async function _(t){let{framework:n,component:r,props:a,islandMeta:o,componentId:s,modulePath:c,isDev:l}=t,u=await(await i(n)).render({component:r,props:a,src:c,condition:o?.condition??`on:client`,ssrOnly:!1,viteServer:void 0,isDev:l}),d=u.html;u.css?d=`${d}<style>${u.css}</style>`:e[s]&&(d=`${d}<style>${e[s]}</style>`);let f=u.hydrationData?.renderId;return{html:d,ssrFailed:!1,hydrationRenderId:f}}function v(e){let{componentId:t,islandMeta:n,modulePath:r,props:i,ssrFailed:s,hydrationRenderId:c,isDev:l}=e,u=n.elementId??`si-${t}`,d=n.componentSrc??r,f;try{f=JSON.stringify(i)}catch(e){let n=e instanceof Error?e.message:String(e);throw Error(`Failed to serialize props for server island (componentId=${t}, module=${r}, elementId=${u}): ${n}`)}if(l){let e=s?`on:client`:n.condition??`on:client`,t=new URL(`../client/server-island-hydrate.ts`,import.meta.url).pathname,r=n.framework??`preact`,i=c?JSON.stringify(c):`undefined`;return`<script type="module">
+import{ensureServerIslandIntegrations as e}from"virtual:server-island-integrations";import{serverIslandCSS as t,serverIslandLoaders as n,serverIslandManifest as r}from"virtual:server-island-manifest";import{h as i}from"preact";import a from"preact-render-to-string";import{loadIntegration as o}from"../islands/integration-loader.js";import{escapeJsonForScript as s,generatePerIslandScript as c}from"../islands/per-island-script.js";import{decrypt as l}from"./encryption.js";import{lookupComponent as u}from"./manifest.js";const d=n??{};function f(){return d}function p(e,t){return new Response(e,{status:t,headers:{"Content-Type":`text/plain`}})}export function defineServerIslandHandler(t={}){let{isDev:n=process.env.NODE_ENV!==`production`,defaultCacheControl:i=`private, no-store`}=t;return async t=>{e();let a=x(t);if(!a)return p(`Missing component ID`,400);let o=await h(t);if(o instanceof Response)return o;let s=g(o,n);if(s instanceof Response)return s;let{props:c,islandMeta:l,srcPath:d}=s,f=u(a)??r?.[a]??(n?d:void 0);if(!f)return p(`Component not found`,404);let m=await _(a,f,n,!!l);if(m instanceof Response)return m;let y=await v({componentModule:m,props:c,islandMeta:l,componentId:a,modulePath:f,isDev:n});if(y instanceof Response)return y;let S=y.html;return l&&(S+=b({componentId:a,islandMeta:l,modulePath:f,props:c,ssrFailed:y.ssrFailed,hydrationRenderId:y.hydrationRenderId,isDev:n})),new Response(S,{status:200,headers:{"Content-Type":`text/html`,"Cache-Control":i}})}}async function h(e){let t;try{t=await w(e)}catch{return p(`Failed to read request body`,400)}return t||p(`Missing encrypted props`,400)}function g(e,t){try{let n;n=t&&e.startsWith(`dev.`)?Buffer.from(e.slice(4),`base64url`).toString(`utf8`):l(e);let r=JSON.parse(n),i={props:r};return r.__island&&(i.islandMeta=r.__island,delete r.__island),r.__src&&(i.srcPath=r.__src,delete r.__src),i}catch{return p(`Bad Request: decryption failed`,400)}}async function _(e,t,n,r){try{let r=f()[e],i;if(r?i=await r():(n&&console.log(`[server-islands] Loading component from:`,t),i=await import(t)),!i.default)throw TypeError(`Module "${t}" does not have a default export`);return i}catch(e){return r&&n?(console.warn(`[server-islands] Component import failed (will render client-side):`,t,e instanceof Error?e.message:e),{default:null}):p(n&&e instanceof Error?e.message:`Component import failed`,500)}}async function v(e){let{componentModule:t,props:n,islandMeta:r,componentId:o,modulePath:s,isDev:c}=e;if(!t.default)return{html:``,ssrFailed:!0};let l=r?.framework??`preact`;try{if(l===`preact`||l===`react`){let e=t.default;return{html:a(i(e,n)),ssrFailed:!1}}return await y({framework:l,component:t.default,props:n,islandMeta:r,componentId:o,modulePath:s,isDev:c})}catch(e){if(r&&c)return{html:``,ssrFailed:!0};let t=c&&e instanceof Error?`${e.message}\n${e.stack}`:``;return console.error(`[server-islands] Render error for`,s,e),p(t||`Internal Server Error`,500)}}async function y(e){let{framework:n,component:r,props:i,islandMeta:a,componentId:s,modulePath:c,isDev:l}=e,u=await(await o(n)).render({component:r,props:i,src:c,condition:a?.condition??`on:client`,ssrOnly:!1,viteServer:void 0,isDev:l}),d=u.html;u.css?d=`${d}<style>${u.css}</style>`:t[s]&&(d=`${d}<style>${t[s]}</style>`);let f=u.hydrationData?.renderId;return{html:d,ssrFailed:!1,hydrationRenderId:f}}function b(e){let{componentId:t,islandMeta:n,modulePath:r,props:i,ssrFailed:a,hydrationRenderId:o,isDev:l}=e,u=n.elementId??`si-${t}`,d=n.componentSrc??r,f;try{f=JSON.stringify(i)}catch(e){let n=e instanceof Error?e.message:String(e);throw Error(`Failed to serialize props for server island (componentId=${t}, module=${r}, elementId=${u}): ${n}`)}if(l){let e=a?`on:client`:n.condition??`on:client`,t=new URL(`../client/server-island-hydrate.ts`,import.meta.url).pathname,r=n.framework??`preact`,i=o?JSON.stringify(o):`undefined`;return`<script type="module">
 import{hydrateServerIsland}from"/@fs${t}";
-hydrateServerIsland(${JSON.stringify(u)},${JSON.stringify(d)},${a(f)},${JSON.stringify(e)},${JSON.stringify(r)},${i});
-<\/script>`}return o({islandId:u,componentSrc:d,framework:n.framework,condition:n.condition,conditionArg:n.conditionArg,propsJson:f})}function y(e){let t=e.context?.params;if(t?.componentId)return t.componentId;let n=b(e);return/\/_server-islands\/([^/?]+)/.exec(n)?.[1]}function b(e){if(e.url)return e.url.pathname;let t=e.req?.url;return t?new URL(t,`http://localhost`).pathname:`/`}function x(e){return e.req?.method??`GET`}async function S(e){let t=x(e).toUpperCase();if(t===`GET`)return(e.url?e.url.searchParams:new URLSearchParams(``)).get(`p`)||void 0;if(t===`POST`){let t=e.web?.request;if(t)return await t.text();if(e.node?.req)return await C(e.node.req);if(e._body!==void 0)return String(e._body)}}function C(e){return new Promise((t,n)=>{let r=[];e.on(`data`,e=>r.push(e)),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}
+hydrateServerIsland(${JSON.stringify(u)},${JSON.stringify(d)},${s(f)},${JSON.stringify(e)},${JSON.stringify(r)},${i});
+<\/script>`}return c({islandId:u,componentSrc:d,framework:n.framework,condition:n.condition,conditionArg:n.conditionArg,propsJson:f})}function x(e){let t=e.context?.params;if(t?.componentId)return t.componentId;let n=S(e);return/\/_server-islands\/([^/?]+)/.exec(n)?.[1]}function S(e){if(e.url)return e.url.pathname;let t=e.req?.url;return t?new URL(t,`http://localhost`).pathname:`/`}function C(e){return e.req?.method??`GET`}async function w(e){let t=C(e).toUpperCase();if(t===`GET`)return(e.url?e.url.searchParams:new URLSearchParams(``)).get(`p`)||void 0;if(t===`POST`){let t=e.web?.request;if(t)return await t.text();if(e.node?.req)return await T(e.node.req);if(e._body!==void 0)return String(e._body)}}function T(e){return new Promise((t,n)=>{let r=[];e.on(`data`,e=>r.push(e)),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}

package/dist/src/server-islands/renderer.js

@@ -1,13 +1,14 @@
-import e from"preact-render-to-string";import{encrypt as t}from"./encryption.js";const n=(globalThis.process?.env??{}).NODE_ENV!==`production`;function r(e){return n?`dev.${Buffer.from(e,`utf8`).toString(`base64url`)}`:t(e)}let i=0;function a(e,t){try{return JSON.stringify(e)}catch(e){let n=e instanceof Error?e.message:String(e);throw Error(`Failed to serialize server island props (elementId=${t.elementId}, componentSrc=${t.componentSrc??`unknown`}, combinedIsland=${t.hasIsland}). Props must be JSON-serializable (no functions, circular refs, or BigInt): ${n}`)}}export function renderServerIsland(t,n,o,l,u,d,f){let p=`si-${t}-${i++}`,m={...n};d&&(m.__src=d),l&&(m.__island={condition:l.condition??`on:client`,conditionArg:l.conditionArg,framework:f??`preact`,componentSrc:u,elementId:p});let h=r(a(m,{componentSrc:u,elementId:p,hasIsland:!!l})),g=o.fallback?e(o.fallback):``,_=o.timeout??1e4,v=s({elementId:p,endpointPath:`/_server-islands/${t}`,timeout:_,islandProp:l});return`${`<avalon-server-island id="${p}" data-p="${c(h)}">`}${g}</avalon-server-island>\n${v}`}function s(e){let{elementId:t,endpointPath:n,timeout:r,islandProp:i}=e,a=i?`el.querySelectorAll('script[type="module"]').forEach(s=>{const n=document.createElement("script");n.type="module";n.textContent=s.textContent;s.replaceWith(n);});`:``;return`<script type="module">
+import e from"preact-render-to-string";import{encrypt as t}from"./encryption.js";function n(){try{if(import.meta.env?.DEV===!0)return!0;if(import.meta.env?.PROD===!0)return!1}catch{}return!1}function r(e){return n()?`dev.${Buffer.from(e,`utf8`).toString(`base64url`)}`:t(e)}let i=0;function a(e,t){try{return JSON.stringify(e)}catch(e){let n=e instanceof Error?e.message:String(e);throw Error(`Failed to serialize server island props (elementId=${t.elementId}, componentSrc=${t.componentSrc??`unknown`}, combinedIsland=${t.hasIsland}). Props must be JSON-serializable (no functions, circular refs, or BigInt): ${n}`)}}export function renderServerIsland(t,n,o,l,u,d,f){let p=`si-${t}-${i++}`,m={...n};d&&(m.__src=d),l&&(m.__island={condition:l.condition??`on:client`,conditionArg:l.conditionArg,framework:f??`preact`,componentSrc:u,elementId:p});let h=r(a(m,{componentSrc:u,elementId:p,hasIsland:!!l})),g=o.fallback?e(o.fallback):``,_=o.timeout??1e4,v=`/_server-islands/${t}`,y=s({elementId:p,endpointPath:v,timeout:_,islandProp:l});return`${`<avalon-server-island id="${p}" data-endpoint="${c(v)}" data-timeout="${_}" data-p="${c(h)}">`}${g}</avalon-server-island>\n${y}`}function s(e){let{elementId:t,endpointPath:n,timeout:r,islandProp:i}=e,a=i?`el.querySelectorAll('script[type="module"]').forEach(s=>{const n=document.createElement("script");n.type="module";n.textContent=s.textContent;s.replaceWith(n);});`:``;return`<script type="module">
 (async()=>{
 const el=document.getElementById("${t}");
-if(!el)return;
+if(!el||el.dataset.siStarted)return;
+el.dataset.siStarted="1";
 const p=el.dataset.p;
-const url="${n}?p="+encodeURIComponent(p);
+const url=(el.dataset.endpoint||"${n}")+"?p="+encodeURIComponent(p);
 const ctrl=new AbortController();
-const t=setTimeout(()=>ctrl.abort(),${r});
+const t=setTimeout(()=>ctrl.abort(),Number(el.dataset.timeout)||${r});
 try{
-const r=await fetch(...(url.length>2048?["${n}",{method:"POST",body:p,headers:{"content-type":"text/plain"},signal:ctrl.signal}]:[url,{signal:ctrl.signal}]));
+const r=await fetch(...(url.length>2048?[el.dataset.endpoint||"${n}",{method:"POST",body:p,headers:{"content-type":"text/plain"},signal:ctrl.signal}]:[url,{signal:ctrl.signal}]));
 clearTimeout(t);
 if(!r.ok)return;
 const html=await r.text();

package/dist/src/server-islands/route.d.ts

@@ -9,8 +9,10 @@
  * - GET: encrypted props in the `p` query parameter
  * - POST: encrypted props in the request body
  *
+ * Framework SSR integrations are registered via the import in `endpoint.ts`
+ * (`virtual:server-island-integrations`).
+ *
  * @module server-islands/route
  */
-import "virtual:server-island-integrations";
 declare const handler: (event: import("h3").H3Event) => Promise<Response>;
 export default handler;

package/dist/src/server-islands/route.js

@@ -1 +1 @@
-import"virtual:server-island-integrations";import{defineServerIslandHandler as e}from"./endpoint.js";const t=e();export default t;
+import{defineServerIslandHandler as e}from"./endpoint.js";const t=e();export default t;

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

@@ -1,14 +1,11 @@
-import type { ServerIslandProp } from "../server-islands/types.ts";
-
 /**
  * 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.
+ * When using a component in a page with the `island` prop, the Vite transform
+ * intercepts it at build time and converts it to a renderIsland() call.
  *
  * Usage:
- *   import Counter from '../islands/Counter.tsx';
+ *   import Counter from '../components/Counter.tsx';
  *   <Counter island={{ condition: 'on:interaction' }} someProp={42} />
  *
  * Custom directives:
@@ -45,12 +42,21 @@ export type IslandDirective = {
 		| `on:${string}`;
 
 	/**
-	 * Stable identifier for the island instance.
-	 * Used for state persistence with PersistentIsland.
-	 * If omitted, Avalon generates one automatically from the component path.
+	 * Stable HTML `id` for this island instance.
+	 * Required when two copies of the same component appear on one page.
+	 * If omitted, Avalon generates a unique id from the component path plus an instance counter.
 	 */
 	id?: string;
 
+	/**
+	 * Keep this island's live instance across client navigations.
+	 * The value is a stable key matched against the same key on the next page.
+	 * `true` uses the component `src` as the key. Qwik islands are never persisted.
+	 *
+	 * Equivalent markup: `data-router-persist="key"` on a wrapper element.
+	 */
+	persist?: string | true;
+
 	/**
 	 * Optional argument passed to custom hydration directives.
 	 * For example, `on:delay` uses this as the delay in milliseconds.
@@ -61,4 +67,17 @@ export type IslandDirective = {
 	 * ```
 	 */
 	conditionArg?: string;
+
+	/**
+	 * Skip server rendering of this component. Avalon emits an empty
+	 * `<avalon-island>` placeholder and mounts the component in the browser.
+	 * Props are still serialized. Combines with `condition` for when to mount.
+	 *
+	 * @example
+	 * ```tsx
+	 * <Chart island={{ clientOnly: true }} userId={user.id} />
+	 * <Chart island={{ clientOnly: true, condition: 'on:idle' }} />
+	 * ```
+	 */
+	clientOnly?: boolean;
 };

package/dist/src/types/virtual-modules.d.ts

@@ -7,9 +7,11 @@
  */
 
 declare module "virtual:avalon/page-loader" {
-	export function loadPage(
-		pathname: string,
-	): { default: unknown; metadata?: Record<string, unknown> } | null;
+	export function loadPage(pathname: string): {
+		default: unknown;
+		metadata?: Record<string, unknown>;
+		clientNavigation?: boolean;
+	} | null;
 }
 
 declare module "virtual:avalon/config" {
@@ -18,6 +20,7 @@ declare module "virtual:avalon/config" {
 		pagesDir: string;
 		layoutsDir: string;
 		isDev: boolean;
+		clientRouter?: boolean;
 		[key: string]: unknown;
 	};
 	export default config;
@@ -42,6 +45,10 @@ declare module "virtual:avalon/assets" {
 	};
 }
 
+declare module "virtual:avalon/ssr-dom" {
+	// Side-effect module: installs a `document` stub before Lit SSR loads.
+}
+
 declare module "virtual:avalon/renderer" {
 	const handler: {
 		(event: unknown): Promise<Response>;
@@ -56,7 +63,20 @@ declare module "virtual:avalon/client-entry" {
 }
 
 declare module "virtual:avalon/integration-loader" {
-	export function loadIntegrationModule(framework: string): Promise<unknown>;
+	export function loadIntegrationModule(framework: string): Promise<{
+		hydrate?: (
+			el: HTMLElement,
+			component: unknown,
+			props: Record<string, unknown>,
+		) => void | Promise<void>;
+		mount?: (
+			el: HTMLElement,
+			component: unknown,
+			props: Record<string, unknown>,
+		) => void | Promise<void>;
+		unmount?: (el: HTMLElement) => void | Promise<void>;
+		preLitHydration?: () => Promise<void>;
+	}>;
 	export function preLitHydration(): Promise<void>;
 	export function loadHMRAdapter(framework: string): Promise<unknown>;
 }
@@ -76,8 +96,8 @@ declare module "virtual:server-island-key" {
 }
 
 declare module "virtual:server-island-integrations" {
-	// Side-effect module that registers framework integrations in the global registry.
-	// No exports — import for side effects only.
+	/** Registers framework SSR integrations into the global registry (idempotent). */
+	export function ensureServerIslandIntegrations(): void;
 }
 
 declare module "virtual:avalon-actions-manifest" {

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

@@ -2,6 +2,10 @@
 
 interface ImportMetaEnv {
 	readonly VITE_APP_TITLE: string;
+	readonly DEV: boolean;
+	readonly PROD: boolean;
+	readonly MODE: string;
+	readonly SSR: boolean;
 	// more env variables...
 }
 

package/dist/src/vite-plugin/config.js

@@ -1 +1 @@
-import{existsSync as e}from"node:fs";import{resolve as t}from"node:path";import n from"node:process";export const DEFAULT_MDX_CONFIG={jsxImportSource:`preact`,syntaxHighlighting:!0,remarkPlugins:[],rehypePlugins:[]};export const DEFAULT_IMAGE_CONFIG={enabled:!0,defaultFormat:`webp`,quality:80,widths:[200,400,600,800,1200],removeMetadata:!0,include:/^[^?]+\.(heif|avif|jpeg|jpg|png|tiff|webp|gif)(\?.*)?$/,exclude:`public/**/*`};export const DEFAULT_CONFIG={core:`preact`,pagesDir:`src/pages`,layoutsDir:`src/layouts`,modules:null,integrations:[],mdx:DEFAULT_MDX_CONFIG,image:DEFAULT_IMAGE_CONFIG,verbose:!1,autoDiscoverIntegrations:!0,validateIntegrations:!0,showWarnings:!0,lazyIntegrations:!0};export const DEFAULT_MODULES_CONFIG={pagesDirName:`pages`,layoutsDirName:`layouts`};function s(e){return e?typeof e==`string`?{dir:e,pagesDirName:DEFAULT_MODULES_CONFIG.pagesDirName,layoutsDirName:DEFAULT_MODULES_CONFIG.layoutsDirName}:{dir:e.dir,pagesDirName:e.pagesDirName??DEFAULT_MODULES_CONFIG.pagesDirName,layoutsDirName:e.layoutsDirName??DEFAULT_MODULES_CONFIG.layoutsDirName}:null}function c(e){return e===!1?{...DEFAULT_IMAGE_CONFIG,enabled:!1}:e===void 0||e===!0?DEFAULT_IMAGE_CONFIG:{enabled:e.enabled??DEFAULT_IMAGE_CONFIG.enabled,defaultFormat:e.defaultFormat??DEFAULT_IMAGE_CONFIG.defaultFormat,quality:e.quality??DEFAULT_IMAGE_CONFIG.quality,widths:e.widths??DEFAULT_IMAGE_CONFIG.widths,removeMetadata:e.removeMetadata??DEFAULT_IMAGE_CONFIG.removeMetadata,include:e.include??DEFAULT_IMAGE_CONFIG.include,exclude:e.exclude??DEFAULT_IMAGE_CONFIG.exclude}}export function resolveConfig(e,t){let n=e??{},i=s(n.modules),o=c(n.image),l=n.core??DEFAULT_CONFIG.core;return{core:l,pagesDir:n.pagesDir??DEFAULT_CONFIG.pagesDir,layoutsDir:n.layoutsDir??DEFAULT_CONFIG.layoutsDir,modules:i,integrations:n.integrations??DEFAULT_CONFIG.integrations,mdx:{jsxImportSource:n.mdx?.jsxImportSource??l,syntaxHighlighting:n.mdx?.syntaxHighlighting??DEFAULT_MDX_CONFIG.syntaxHighlighting,remarkPlugins:n.mdx?.remarkPlugins??DEFAULT_MDX_CONFIG.remarkPlugins,rehypePlugins:n.mdx?.rehypePlugins??DEFAULT_MDX_CONFIG.rehypePlugins},image:o,verbose:n.verbose??DEFAULT_CONFIG.verbose,autoDiscoverIntegrations:n.autoDiscoverIntegrations??DEFAULT_CONFIG.autoDiscoverIntegrations,validateIntegrations:n.validateIntegrations??DEFAULT_CONFIG.validateIntegrations,showWarnings:n.showWarnings??DEFAULT_CONFIG.showWarnings,lazyIntegrations:n.lazyIntegrations??DEFAULT_CONFIG.lazyIntegrations,isDev:t}}export function checkDirectoriesExist(r,i=n.cwd()){let a=[];!r.modules&&r.pagesDir&&a.push({path:r.pagesDir,type:`pages`}),r.layoutsDir&&a.push({path:r.layoutsDir,type:`layouts`});let o=[];for(let{path:n,type:s}of a){let a=t(i,n),c=e(a);o.push({path:n,absolutePath:a,exists:c,type:s}),!c&&r.showWarnings&&console.warn(`⚠️  Avalon: ${s} directory '${n}' does not exist (resolved to: ${a}). This directory will be skipped.`)}return o}export function logDirectoryCheckSummary(e,t){let n=e.filter(e=>!e.exists),r=e.filter(e=>e.exists);t&&(r.length>0&&console.log(`   ✅ Found directories: ${r.map(e=>e.path).join(`, `)}`),n.length>0&&console.log(`   ⚠️  Missing directories: ${n.map(e=>e.path).join(`, `)}`))}
+import{existsSync as e}from"node:fs";import{resolve as t}from"node:path";import n from"node:process";export const DEFAULT_MDX_CONFIG={jsxImportSource:`preact`,syntaxHighlighting:!0,remarkPlugins:[],rehypePlugins:[]};export const DEFAULT_IMAGE_CONFIG={enabled:!0,defaultFormat:`webp`,quality:80,widths:[200,400,600,800,1200],removeMetadata:!0,include:/^[^?]+\.(heif|avif|jpeg|jpg|png|tiff|webp|gif)(\?.*)?$/,exclude:`public/**/*`};export const DEFAULT_CONFIG={core:`preact`,pagesDir:`src/pages`,layoutsDir:`src/layouts`,modules:null,integrations:[],mdx:DEFAULT_MDX_CONFIG,image:DEFAULT_IMAGE_CONFIG,verbose:!1,autoDiscoverIntegrations:!0,validateIntegrations:!0,showWarnings:!0,lazyIntegrations:!0,clientRouter:!1};export const DEFAULT_MODULES_CONFIG={pagesDirName:`pages`,layoutsDirName:`layouts`};function s(e){return e?typeof e==`string`?{dir:e,pagesDirName:DEFAULT_MODULES_CONFIG.pagesDirName,layoutsDirName:DEFAULT_MODULES_CONFIG.layoutsDirName}:{dir:e.dir,pagesDirName:e.pagesDirName??DEFAULT_MODULES_CONFIG.pagesDirName,layoutsDirName:e.layoutsDirName??DEFAULT_MODULES_CONFIG.layoutsDirName}:null}function c(e){return e===!1?{...DEFAULT_IMAGE_CONFIG,enabled:!1}:e===void 0||e===!0?DEFAULT_IMAGE_CONFIG:{enabled:e.enabled??DEFAULT_IMAGE_CONFIG.enabled,defaultFormat:e.defaultFormat??DEFAULT_IMAGE_CONFIG.defaultFormat,quality:e.quality??DEFAULT_IMAGE_CONFIG.quality,widths:e.widths??DEFAULT_IMAGE_CONFIG.widths,removeMetadata:e.removeMetadata??DEFAULT_IMAGE_CONFIG.removeMetadata,include:e.include??DEFAULT_IMAGE_CONFIG.include,exclude:e.exclude??DEFAULT_IMAGE_CONFIG.exclude}}export function resolveConfig(e,t){let n=e??{},i=s(n.modules),o=c(n.image),l=n.core??DEFAULT_CONFIG.core;return{core:l,pagesDir:n.pagesDir??DEFAULT_CONFIG.pagesDir,layoutsDir:n.layoutsDir??DEFAULT_CONFIG.layoutsDir,modules:i,integrations:n.integrations??DEFAULT_CONFIG.integrations,mdx:{jsxImportSource:n.mdx?.jsxImportSource??l,syntaxHighlighting:n.mdx?.syntaxHighlighting??DEFAULT_MDX_CONFIG.syntaxHighlighting,remarkPlugins:n.mdx?.remarkPlugins??DEFAULT_MDX_CONFIG.remarkPlugins,rehypePlugins:n.mdx?.rehypePlugins??DEFAULT_MDX_CONFIG.rehypePlugins},image:o,verbose:n.verbose??DEFAULT_CONFIG.verbose,autoDiscoverIntegrations:n.autoDiscoverIntegrations??DEFAULT_CONFIG.autoDiscoverIntegrations,validateIntegrations:n.validateIntegrations??DEFAULT_CONFIG.validateIntegrations,showWarnings:n.showWarnings??DEFAULT_CONFIG.showWarnings,lazyIntegrations:n.lazyIntegrations??DEFAULT_CONFIG.lazyIntegrations,clientRouter:n.clientRouter??DEFAULT_CONFIG.clientRouter,isDev:t}}export function checkDirectoriesExist(r,i=n.cwd()){let a=[];!r.modules&&r.pagesDir&&a.push({path:r.pagesDir,type:`pages`}),r.layoutsDir&&a.push({path:r.layoutsDir,type:`layouts`});let o=[];for(let{path:n,type:s}of a){let a=t(i,n),c=e(a);o.push({path:n,absolutePath:a,exists:c,type:s}),!c&&r.showWarnings&&console.warn(`⚠️  Avalon: ${s} directory '${n}' does not exist (resolved to: ${a}). This directory will be skipped.`)}return o}export function logDirectoryCheckSummary(e,t){let n=e.filter(e=>!e.exists),r=e.filter(e=>e.exists);t&&(r.length>0&&console.log(`   ✅ Found directories: ${r.map(e=>e.path).join(`, `)}`),n.length>0&&console.log(`   ⚠️  Missing directories: ${n.map(e=>e.path).join(`, `)}`))}

package/dist/src/vite-plugin/dev-css-graph.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Dev CSS for Nitro SSR is collected from each page's static import graph
+ * (plus layouts and global CSS), not by globbing every `.css` file on disk.
+ * The layouts virtual module lives in Nitro's realm, so this walk is filesystem
+ * based — Vite's module graph is not available there.
+ */
+import { type DevCssRouteEntry, type DevCssRouteTable } from "../render/dev-css-select.ts";
+export { matchPathPattern, selectDevCssHrefs } from "../render/dev-css-select.ts";
+export type { DevCssRouteEntry, DevCssRouteTable };
+export interface LayoutCssEntry {
+    prefix: string;
+    filePath: string;
+    isRoot: boolean;
+    skipRoot: boolean;
+}
+export interface CssGraphAlias {
+    find: string | RegExp;
+    replacement: string;
+}
+/** Same fallbacks as `mdx-island-transform` so MDX `import X from '@shared/…'` reaches CSS. */
+export declare function defaultCssGraphAliases(cwd: string): CssGraphAlias[];
+/** Resolve a relative, root-absolute, or aliased specifier to an existing file. */
+export declare function resolveProjectImport(fromFile: string, spec: string, cwd: string, aliases?: CssGraphAlias[]): string | null;
+/**
+ * Collect `/`-rooted CSS hrefs reachable from `entryFile` via static imports
+ * and CSS `@import`. Skips `node_modules`.
+ */
+export declare function collectCssHrefsFromEntry(entryFile: string, cwd: string, aliases?: CssGraphAlias[]): string[];
+/**
+ * Build the per-route CSS table used by `virtual:avalon/layouts` in development.
+ */
+export declare function buildDevCssRouteTable(options: {
+    cwd: string;
+    routes: Array<{
+        pattern: string;
+        filePath: string;
+    }>;
+    layouts: LayoutCssEntry[];
+    globalCSS: string[];
+    aliases?: CssGraphAlias[];
+}): DevCssRouteTable;

package/dist/src/vite-plugin/dev-css-graph.js

@@ -0,0 +1 @@
+import{readFileSync as e,statSync as t}from"node:fs";import{dirname as n,extname as r,join as i,relative as a,resolve as o}from"node:path";import{stripTrailingSlash as s}from"../render/dev-css-select.js";export{matchPathPattern,selectDevCssHrefs}from"../render/dev-css-select.js";const c=[`.tsx`,`.ts`,`.jsx`,`.js`,`.mjs`,`.cjs`,`.vue`,`.svelte`,`.mdx`,`.md`,`.css`,`.scss`,`.sass`,`.less`,`.styl`,`.stylus`],l=new Set([`.css`,`.scss`,`.sass`,`.less`,`.styl`,`.stylus`]),u=c.map(e=>`index${e}`),d=/(?:from|import)\s+['"]([^'"]+)['"]/g,f=/import\s*\(\s*['"]([^'"]+)['"]\s*\)/g,p=/@import\s+(?:url\s*\(\s*)?['"]([^'"]+)['"]/g;function m(e){return l.has(r(e.split(`?`)[0]).toLowerCase())}function h(e,t){let n=a(e,t).replaceAll(`\\`,`/`);return n.startsWith(`/`)?n:`/${n}`}function g(e){let n=e.split(`?`)[0];try{if(!t(n).isFile())return null}catch{return null}return n}function _(e){for(let t of e){let e=g(t);if(e)return e}return null}export function defaultCssGraphAliases(e){return[{find:`@shared`,replacement:i(e,`app/shared`)},{find:`@modules`,replacement:i(e,`app/modules`)},{find:`@/`,replacement:`${i(e,`app`)}/`},{find:`$islands`,replacement:i(e,`src/islands`)},{find:`$components`,replacement:i(e,`src/components`)},{find:`~/`,replacement:`${i(e,`src`)}/`}]}function v(e,t,n){if(e===t)return n;let r=t.endsWith(`/`)?t:`${t}/`;if(!e.startsWith(r))return null;let i=e.slice(r.length);return n.endsWith(`/`)?`${n}${i}`:i?`${n}/${i}`:n}function y(e,t){for(let n of t){let t=n.find;if(typeof t==`string`){let r=v(e,t,n.replacement);if(r)return r;continue}if(t.test(e))return e.replace(t,n.replacement)}return null}function b(e){return g(e)||(r(e.split(`?`)[0])?null:_([...c.map(t=>e+t),...u.map(t=>i(e,t))]))}export function resolveProjectImport(e,t,r,a=[]){let s=t.split(`?`)[0].split(`#`)[0];if(!s||/^(https?:|data:|virtual:)/i.test(s)||s.startsWith(`\0`))return null;let c=y(s,[...a,...defaultCssGraphAliases(r)]);return c?b(c):s.startsWith(`.`)||s.startsWith(`/`)?b(s.startsWith(`/`)?i(r,s.slice(1)):o(n(e),s)):null}function x(e,t){return[...e.matchAll(t)].flatMap(e=>e[1]?[e[1]]:[])}function S(e,t){return t?x(e,p):[...x(e,d),...x(e,f),...x(e,p)]}function C(e){return e.includes(`/node_modules/`)||e.includes(`\\node_modules\\`)}function w(t){try{return e(t,`utf8`)}catch{return null}}export function collectCssHrefsFromEntry(e,t,n=[]){let r=[],i=new Set,a=[o(e)];for(;a.length>0;){let e=a.pop();if(!e||i.has(e)||C(e))continue;i.add(e);let o=w(e);if(o===null)continue;let s=m(e);s&&r.push(h(t,e));for(let r of S(o,s)){let o=resolveProjectImport(e,r,t,n);o&&!i.has(o)&&!C(o)&&a.push(o)}}return T(r)}function T(e){return[...new Set(e)]}function E(...e){return T(e.flat())}function D(e,t){if(t===`/`)return!0;let n=s(e),r=s(t);return n===r||n.startsWith(`${r}/`)}function O(e,t){let n=[];for(let r of t){let t=r.startsWith(`/`)?r:`/${r}`,i=g(o(e,t.slice(1)));if(i){n.push(...collectCssHrefsFromEntry(i,e));continue}n.push(t)}return T(n)}function k(e,t,n,r,i){let a=collectCssHrefsFromEntry(e.filePath,t,i),o=r.filter(t=>D(e.pattern,t.prefix)),s=o.some(e=>!e.isRoot&&e.skipRoot),c=o.filter(e=>!(e.isRoot&&s)).flatMap(e=>e.hrefs);return{pattern:e.pattern,pageHrefs:E(n,a),hrefs:E(n,c,a)}}export function buildDevCssRouteTable(e){let t=e.aliases??[],n=O(e.cwd,e.globalCSS),r=e.layouts.map(n=>({...n,hrefs:collectCssHrefsFromEntry(n.filePath,e.cwd,t)}));return{globalHrefs:n,fallbackHrefs:E(n,E(...r.filter(e=>e.isRoot).map(e=>e.hrefs))),routes:e.routes.map(i=>k(i,e.cwd,n,r,t))}}

package/dist/src/vite-plugin/dev-css-hmr.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Dev CSS HMR is owned by Avalon, not Vite's link rewriter or Nitro's
+ * document reload.
+ *
+ * Pipeline:
+ * 1. SSR injects `<link rel="stylesheet" href="…?direct">`.
+ * 2. `hotUpdate` returns [] so Vite does not css-update and Nitro does not
+ *    treat SSR-only CSS as a document reload.
+ * 3. Hard-invalidate the file (and `?direct`) in every environment, then
+ *    transform with `?direct&v=` — Vite strips `t=<13 digits>`.
+ * 4. Send `{ href, css }` on the client hot channel. The client writes `css`
+ *    into a `<style data-avalon-css>` tag (does not refetch the link).
+ */
+import type { Plugin, ViteDevServer } from "vite";
+export declare function isCssHotFile(file: string): boolean;
+export declare function fileToDevHref(root: string, file: string): string;
+export declare function isBrowserFullReloadPayload(payload: unknown): boolean;
+/**
+ * Drop only the document reload that is correlated with this CSS save.
+ * Unrelated JS / HTML / config reloads in the same 250 ms window still pass.
+ */
+export declare function isCssCorrelatedReload(payload: unknown): boolean;
+/** Drop a document reload that Nitro emits for server-only CSS modules. */
+export declare function shouldDropCssFullReload(cssSaveInFlight: boolean, payload: unknown): boolean;
+/**
+ * One in-flight CSS push per file. A save while that push is running is
+ * marked pending; when the active push settles, one follow-up runs for
+ * the latest CSS.
+ */
+export declare function scheduleCssPush(file: string, pushing: Set<string>, pending: Set<string>, run: (file: string) => Promise<void>): void;
+/** Standalone client listener. Nitro HTML never runs `transformIndexHtml`. */
+export declare function generateDevCssHmrModule(): string;
+export declare function createDevCssHmrPlugin(): Plugin;
+export declare function invalidateCssFile(server: ViteDevServer, file: string): void;
+export declare function cssHotPayload(href: string, css: string): {
+    type: "custom";
+    event: "avalon:css";
+    data: {
+        href: string;
+        css: string;
+    };
+};

package/dist/src/vite-plugin/dev-css-hmr.js

@@ -0,0 +1,2 @@
+import{relative as e}from"node:path";import{readDirectCss as t}from"../render/collect-css.js";const n=/\.(css|scss|sass|less|styl|stylus)$/;export function isCssHotFile(e){return n.test(e.split(`?`)[0]??e)}export function fileToDevHref(t,n){let r=e(t,n).replaceAll(`\\`,`/`);return r.startsWith(`/`)?r:`/${r}`}export function isBrowserFullReloadPayload(e){return!e||typeof e!=`object`?!1:e.type===`full-reload`}function o(e){let t=e.path;return typeof t==`string`?t:``}function s(e){let t=e.triggeredBy;return typeof t==`string`?t:``}export function isCssCorrelatedReload(e){if(!e||typeof e!=`object`)return!1;let t=s(e);if(t)return isCssHotFile(t);let n=o(e);return!n||n===`*`?!0:isCssHotFile(n)}export function shouldDropCssFullReload(e,t){return e&&isBrowserFullReloadPayload(t)&&isCssCorrelatedReload(t)}export function scheduleCssPush(e,t,n,r){if(t.has(e)){n.add(e);return}t.add(e),r(e).finally(()=>{t.delete(e),n.has(e)&&(n.delete(e),scheduleCssPush(e,t,n,r))})}export function generateDevCssHmrModule(){return[`if (import.meta.hot) {`,`  import.meta.hot.on('avalon:css', function (data) {`,`    if (!data || typeof data.href !== 'string') return;`,`    var href = data.href.split('?')[0];`,`    var id = href.charAt(0) === '/' ? href : '/' + href;`,`    var css = typeof data.css === 'string' ? data.css : '';`,`    var links = document.querySelectorAll('link[data-avalon-css]');`,`    for (var i = 0; i < links.length; i++) {`,`      if (links[i].dataset.avalonCss === id) {`,`        links[i].href = id + '?direct&v=' + Date.now();`,`      }`,`    }`,`    if (!css || css.indexOf('__vite__updateStyle') !== -1 || css.indexOf('import.meta.hot') !== -1) return;`,`    var style;`,`    var nodes = document.querySelectorAll('style[data-avalon-css]');`,`    for (var j = 0; j < nodes.length; j++) {`,`      if (nodes[j].dataset.avalonCss === id) { style = nodes[j]; break; }`,`    }`,`    if (!style) {`,`      style = document.createElement('style');`,`      style.setAttribute('type', 'text/css');`,`      style.dataset.avalonCss = id;`,`      document.head.appendChild(style);`,`    }`,`    style.textContent = css;`,`  });`,`}`,``].join(`
+`)}export function createDevCssHmrPlugin(){let e=!1,t,n=new Set,i=new Set,a=()=>{e=!0,t!==void 0&&clearTimeout(t),t=setTimeout(()=>{e=!1,t=void 0},250)};return{name:`avalon:dev-css-hmr`,apply:`serve`,enforce:`pre`,applyToEnvironment:()=>!0,configureServer(t){return()=>{let n=t.ws.send.bind(t.ws);t.ws.send=((...t)=>{if(!shouldDropCssFullReload(e,t[0]))return n(...t)})}},hotUpdate({file:e,server:t}){if(isCssHotFile(e))return a(),scheduleCssPush(e,n,i,e=>d(t,e)),[]}}}function c(e,t,n){let r=new Set(e.getModulesByFile?.(t)??[]);for(let t of n){let n=e.getModuleById?.(t);n&&r.add(n);let i=e.urlToModuleMap?.get(t);i&&r.add(i)}return r}function l(e,t){let n=e._pendingRequests;if(n)for(let e of t)n.delete(e)}export function invalidateCssFile(e,t){let n=e.config?.root?fileToDevHref(e.config.root,t):``,r=n?[n,`${n}?direct`]:[];for(let n of Object.values(e.environments??{})){let e=n.moduleGraph;for(let n of c(e,t,r))e.invalidateModule(n);l(n,r)}}export function cssHotPayload(e,t){return{type:`custom`,event:`avalon:css`,data:{href:e,css:t}}}function u(e,t,n){let r=cssHotPayload(t,n),i=new Set,a=e=>{!e||i.has(e)||(i.add(e),e.send(r))};a(e.ws),a(e.environments?.client?.hot)}async function d(e,n){invalidateCssFile(e,n);let r=fileToDevHref(e.config.root,n),a=await t(e,r);u(e,r,a),e.config.logger.info(`css hmr ${r} (${a.length}b)`,{timestamp:!0})}

package/dist/src/vite-plugin/dev-css-modules.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vite's default CSS-module hash includes file contents. After a save, the
+ * Nitro page still exports the previous class names while `?direct` CSS uses
+ * new hashes — the document looks unstyled. Dev hashes only the file path
+ * and local name so a value edit keeps the same selectors.
+ */
+export declare function stableDevScopedName(name: string, filename: string): string;
+export declare function shouldSetDevScopedName(modules: unknown): boolean;

package/dist/src/vite-plugin/dev-css-modules.js

@@ -0,0 +1 @@
+import{createHash as e}from"node:crypto";import{basename as t}from"node:path";export function stableDevScopedName(n,r){let i=(r.split(`?`)[0]??r).replaceAll(`\\`,`/`),a=e(`sha1`).update(`${i}\0${n}`).digest(`hex`).slice(0,5);return`_${t(i).replace(/\.module\.\w+$/,``).replace(/[^\w-]/g,`_`)}_${n.replace(/[^\w-]/g,`_`)}_${a}`}export function shouldSetDevScopedName(e){return e===!1?!1:e&&typeof e==`object`&&`generateScopedName`in e?e.generateScopedName==null:!0}

package/dist/src/vite-plugin/framework-vite-defaults.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Framework Vite defaults derived from `core` + `integrations`.
+ *
+ * Users should not copy aliases, optimizeDeps, or ssr.noExternal into their
+ * config — Avalon applies them from the frameworks they actually enabled.
+ */
+import type { SSROptions, UserConfig } from "vite";
+export interface FrameworkViteDefaultsOptions {
+    integrations: readonly string[];
+    core?: "preact" | "react";
+    command: "serve" | "build";
+    root?: string;
+    nitroPreset?: string;
+    /** Override package resolution (tests). Returns an ESM path or undefined. */
+    resolvePackage?: (specifier: string) => string | undefined;
+}
+/**
+ * Map a bare specifier to the Preact package Avalon should pin, or null
+ * when this id is not part of the compat rewrite.
+ */
+export declare function mapPreactCompatId(id: string, core?: "preact" | "react"): string | null;
+/** Absolute Preact pins belong on SSR always, and on the client production build. */
+export declare function shouldResolvePreactCompat(env: string | undefined, command: string | undefined): boolean;
+export declare function asNoExternalList(value: SSROptions["noExternal"]): Array<string | RegExp>;
+/**
+ * Vite config fragment Avalon merges in `config()`. Safe to call with a
+ * stub `resolvePackage` in tests.
+ */
+export declare function getFrameworkViteDefaults(options: FrameworkViteDefaultsOptions): UserConfig;

package/dist/src/vite-plugin/framework-vite-defaults.js

@@ -0,0 +1 @@
+import{createRequire as e}from"node:module";import{join as t}from"node:path";import{getOptimizeDepsForIntegrations as n,getSSRNoExternalForIntegrations as r}from"../build/integration-config.js";const i=`@builder.io/qwik`,a=[`preact`,`preact/hooks`,`preact/compat`,`preact/compat/server`,`preact/compat/client`],o=[{find:/^react$/,spec:`preact/compat`},{find:/^react\/jsx-runtime$/,spec:`preact/jsx-runtime`},{find:/^react\/jsx-dev-runtime$/,spec:`preact/jsx-runtime`},{find:/^react-dom$/,spec:`preact/compat`},{find:/^react-dom\/server$/,spec:`preact/compat/server`},{find:/^react-dom\/client$/,spec:`preact/compat/client`}],s={react:`preact/compat`,"react/jsx-runtime":`preact/jsx-runtime`,"react/jsx-dev-runtime":`preact/jsx-runtime`,"react-dom":`preact/compat`,"react-dom/server":`preact/compat/server`,"react-dom/client":`preact/compat/client`},c=new Set([...a,`preact/jsx-runtime`,`preact/jsx-dev-runtime`]);export function mapPreactCompatId(e,t=`preact`){return c.has(e)?e:t===`react`?null:s[e]??null}export function shouldResolvePreactCompat(e,t){return e===`ssr`||e===`nitro`?!0:t===`build`}const u=[{find:/^vue$/,replacement:`vue/dist/vue.runtime.esm-bundler.js`},{find:/^@vue\/shared$/,replacement:`@vue/shared/dist/shared.esm-bundler.js`},{find:/^@vue\/runtime-core$/,replacement:`@vue/runtime-core/dist/runtime-core.esm-bundler.js`},{find:/^@vue\/runtime-dom$/,replacement:`@vue/runtime-dom/dist/runtime-dom.esm-bundler.js`},{find:/^@vue\/reactivity$/,replacement:`@vue/reactivity/dist/reactivity.esm-bundler.js`},{find:/^@vue\/server-renderer$/,replacement:`@vue/server-renderer/dist/server-renderer.esm-bundler.js`}];function d(e){let t=e.replaceAll(`/`,String.raw`\/`);return RegExp(`^${t}$`)}export function asNoExternalList(e){return Array.isArray(e)?e:!e||e===!0?[]:[e]}function f(n,r){try{return e(t(n,`package.json`)).resolve(r).replace(/\.js$/,`.mjs`)}catch{return}}function p(e,t,n){n&&e.push({find:t,replacement:n})}function m(e,t){let n=new Set(e);return n.add(t),[...n]}function h(e,t,n){let r=[];if(t===`preact`||e.includes(`preact`))for(let e of a)p(r,d(e),n(e));if(t===`preact`)for(let{find:e,spec:t}of o)p(r,e,n(t));return e.includes(`vue`)&&r.push(...u),r}function g(e,t){let n={__DEV__:e===`serve`,__PROD__:e===`build`,global:`globalThis`,"process.env.NODE_ENV":JSON.stringify(e===`serve`?`development`:`production`)};return t.includes(`vue`)?(n.__VUE_OPTIONS_API__=!0,n.__VUE_PROD_DEVTOOLS__=e===`serve`,n):n}function _(e,t){let n=r(e.filter(e=>e!==`solid`));e.includes(`vue`)&&!n.includes(`estree-walker`)&&n.push(`estree-walker`);let i={noExternal:n};e.includes(`solid`)&&(i.resolve={conditions:[`node`]});let a=t?.startsWith(`cloudflare`)??!1;return(e.includes(`solid`)||a)&&(i.target=`webworker`),i}export function getFrameworkViteDefaults(e){let t=e.core??`preact`,r=e.root??process.cwd(),a=e.resolvePackage??(e=>f(r,e)),o=m(e.integrations,t),s=new Set(n(o));t===`react`&&(s.add(`react-dom/server`),s.add(`react/jsx-runtime`));let c=[];o.includes(`qwik`)&&(s.delete(i),s.delete(`${i}/server`),c.push(i));let l=h(e.integrations,t,a);return{define:g(e.command,e.integrations),resolve:l.length>0?{alias:l}:void 0,optimizeDeps:{include:[...s],exclude:c},ssr:_(o,e.nitroPreset)}}

package/dist/src/vite-plugin/nitro-integration.d.ts

@@ -19,8 +19,10 @@ export declare const VIRTUAL_MODULE_IDS: {
     readonly ASSETS: "virtual:avalon/assets";
     readonly RENDERER: "virtual:avalon/renderer";
     readonly CLIENT_ENTRY: "virtual:avalon/client-entry";
+    readonly DEV_CSS_HMR: "virtual:avalon/dev-css-hmr";
     readonly INTEGRATION_LOADER: "virtual:avalon/integration-loader";
     readonly ACTIONS: "virtual:avalon/actions";
+    readonly SSR_DOM: "virtual:avalon/ssr-dom";
 };
 export declare const RESOLVED_VIRTUAL_IDS: {
     readonly PAGE_ROUTES: "\0virtual:avalon/page-routes";
@@ -32,8 +34,10 @@ export declare const RESOLVED_VIRTUAL_IDS: {
     readonly ASSETS: "\0virtual:avalon/assets";
     readonly RENDERER: "\0virtual:avalon/renderer";
     readonly CLIENT_ENTRY: "\0virtual:avalon/client-entry";
+    readonly DEV_CSS_HMR: "\0virtual:avalon/dev-css-hmr";
     readonly INTEGRATION_LOADER: "\0virtual:avalon/integration-loader";
     readonly ACTIONS: "\0virtual:avalon/actions";
+    readonly SSR_DOM: "\0virtual:avalon/ssr-dom";
 };
 export interface NitroIntegrationResult {
     nitroOptions: NitroConfigOutput;