@useavalon/avalon 0.3.2-canary.14 → 0.3.2-canary.15

package/dist/src/post-build/cloudflare-worker-patch.js

@@ -1 +1 @@
-import{existsSync as e,readdirSync as t,readFileSync as n,statSync as r,writeFileSync as i}from"node:fs";import{join as a}from"node:path";import{ssrDomShimModuleSource as o}from"../vite-plugin/ssr-dom-shim-module.js";const s=/createRequire\(\s*import\.meta\.url\s*\)/g,c=`_dom_stub.mjs`;function l(n,r=[]){if(!e(n))return r;for(let e of t(n,{withFileTypes:!0})){let t=a(n,e.name);if(e.isDirectory()){l(t,r);continue}e.isFile()&&/\.(?:m?js)$/.test(e.name)&&r.push(t)}return r}export function patchCloudflareCreateRequire(e){let t=0;for(let r of l(e)){let e=n(r,`utf-8`);if(!s.test(e))continue;s.lastIndex=0;let a=e.replaceAll(s,`createRequire(import.meta.url || "file:///")`);a!==e&&(i(r,a),t+=1)}return t}export function patchCloudflareWranglerJson(t,o){let s=a(t,`wrangler.json`);if(!e(s)||!r(s).isFile())return!1;let c=JSON.parse(n(s,`utf-8`));c.compatibility_date=o.compatibilityDate;let l=new Set(c.compatibility_flags??[]);for(let e of o.compatibilityFlags)l.add(e);return c.compatibility_flags=[...l],i(s,`${JSON.stringify(c,null,2)}\n`),!0}function u(t,a){if(!e(t)||!r(t).isFile())return!1;let o=n(t,`utf-8`),s=`import "${a}";\n`;return o.startsWith(s)||o.includes(`import "${a}"`)?!1:(i(t,`${s}${o}`),!0)}export function injectCloudflareDomStub(n){i(a(n,c),`${o().trim()}\n`);let r=!1;r=u(a(n,`index.js`),`./${c}`)||r,r=u(a(n,`_ssr`,`ssr.mjs`),`../${c}`)||r;let s=a(n,`_libs`,`@lit-labs`);if(e(s))for(let e of t(s))e.startsWith(`ssr`)&&(r=u(a(s,e),`../../${c}`)||r);return r}export function patchCloudflareRoutesForStaticHtml(t){let n=a(t,`dist`,`_routes.json`);if(!e(n))return!1;let r=new Set([`/api/*`,`/_server-islands/*`,`/_actions/*`,`/demo/data-fetching`,`/demo/data-fetching/`]);e(a(t,`dist`,`_worker.js`,`_routes`,`api`))&&r.add(`/api/*`);let o={version:1,include:[...r],exclude:[`/`,`/assets/*`,`/islands/*`,`/pagefind/*`,`/*.html`,`/*.svg`,`/*.ico`,`/*.txt`,`/*.xml`,`/*.css`,`/*.js`]};return i(n,`${JSON.stringify(o,null,2)}\n`),!0}export function patchCloudflareWorkerOutput(t,n={compatibilityDate:`2026-09-04`,compatibilityFlags:[`nodejs_compat`,`enable_nodejs_fs_module`]}){let i=a(t,`dist`,`_worker.js`);if(!e(i))return!1;let o=r(i).isDirectory()?i:null;if(!o)return!1;let s=patchCloudflareCreateRequire(o),c=patchCloudflareWranglerJson(o,n),l=injectCloudflareDomStub(o),u=patchCloudflareRoutesForStaticHtml(t);return s>0&&console.log(`[cloudflare] Patched createRequire(import.meta.url) in ${s} worker file(s)`),c&&console.log(`[cloudflare] Synced wrangler.json compatibility_date=${n.compatibilityDate}`),l&&console.log(`[cloudflare] Injected _dom_stub.mjs before Lit / SSR imports`),u&&console.log(`[cloudflare] Limited _routes.json include to dynamic SSR paths`),s>0||c||l||u}
+import{existsSync as e,readdirSync as t,readFileSync as n,statSync as r,writeFileSync as i}from"node:fs";import{join as a}from"node:path";import{ssrDomStubFileSource as o}from"../vite-plugin/ssr-dom-shim-module.js";const s=/createRequire\(\s*import\.meta\.url\s*\)/g,c=`_dom_stub.mjs`;function l(n,r=[]){if(!e(n))return r;for(let e of t(n,{withFileTypes:!0})){let t=a(n,e.name);if(e.isDirectory()){l(t,r);continue}e.isFile()&&/\.(?:m?js)$/.test(e.name)&&r.push(t)}return r}export function patchCloudflareCreateRequire(e){let t=0;for(let r of l(e)){let e=n(r,`utf-8`);if(!s.test(e))continue;s.lastIndex=0;let a=e.replaceAll(s,`createRequire(import.meta.url || "file:///")`);a!==e&&(i(r,a),t+=1)}return t}export function patchCloudflareWranglerJson(t,o){let s=a(t,`wrangler.json`);if(!e(s)||!r(s).isFile())return!1;let c=JSON.parse(n(s,`utf-8`));c.compatibility_date=o.compatibilityDate;let l=new Set(c.compatibility_flags??[]);for(let e of o.compatibilityFlags)l.add(e);return c.compatibility_flags=[...l],i(s,`${JSON.stringify(c,null,2)}\n`),!0}function u(t,a){if(!e(t)||!r(t).isFile())return!1;let o=n(t,`utf-8`),s=`import "${a}";\n`;return o.startsWith(s)||o.includes(`import "${a}"`)?!1:(i(t,`${s}${o}`),!0)}export function injectCloudflareDomStub(n){i(a(n,c),`${o().trim()}\n`);let r=!1;r=u(a(n,`index.js`),`./${c}`)||r,r=u(a(n,`_ssr`,`ssr.mjs`),`../${c}`)||r;let s=a(n,`_libs`,`@lit-labs`);if(e(s))for(let e of t(s))e.startsWith(`ssr`)&&(r=u(a(s,e),`../../${c}`)||r);return r}export function patchCloudflareRoutesForStaticHtml(t){let n=a(t,`dist`,`_routes.json`);if(!e(n))return!1;let r=new Set([`/api/*`,`/_server-islands/*`,`/_actions/*`]);e(a(t,`dist`,`_worker.js`,`_routes`,`api`))&&r.add(`/api/*`);let o={version:1,include:[...r],exclude:[`/`,`/assets/*`,`/islands/*`,`/pagefind/*`,`/*.html`,`/*.svg`,`/*.ico`,`/*.txt`,`/*.xml`,`/*.css`,`/*.js`]};return i(n,`${JSON.stringify(o,null,2)}\n`),!0}export function patchCloudflareWorkerOutput(t,n={compatibilityDate:`2026-09-04`,compatibilityFlags:[`nodejs_compat`,`enable_nodejs_fs_module`]}){let i=a(t,`dist`,`_worker.js`);if(!e(i))return!1;let o=r(i).isDirectory()?i:null;if(!o)return!1;let s=patchCloudflareCreateRequire(o),c=patchCloudflareWranglerJson(o,n),l=injectCloudflareDomStub(o),u=patchCloudflareRoutesForStaticHtml(t);return s>0&&console.log(`[cloudflare] Patched createRequire(import.meta.url) in ${s} worker file(s)`),c&&console.log(`[cloudflare] Synced wrangler.json compatibility_date=${n.compatibilityDate}`),l&&console.log(`[cloudflare] Injected _dom_stub.mjs before Lit / SSR imports`),u&&console.log(`[cloudflare] Limited _routes.json include to dynamic SSR paths`),s>0||c||l||u}

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,4 +1,4 @@
-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=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">
 (async()=>{
 const el=document.getElementById("${t}");
 if(!el)return;

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/virtual-modules.d.ts

@@ -80,8 +80,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/nitro-integration.js

@@ -6,7 +6,7 @@ import{existsSync as e,readdirSync as t,readFileSync as n,rmSync as r}from"node:
 `)}function fe(e,t){try{let n;if(e.startsWith(`dev.`)){let t=e.slice(4);n=Buffer.from(t,`base64url`).toString(`utf8`)}else n=t(e);let r=JSON.parse(n),i,a;return r.__island&&(i=r.__island,delete r.__island),r.__src&&(a=r.__src,delete r.__src),{ok:!0,props:r,srcPath:a,islandMeta:i}}catch{return{ok:!1}}}function pe(e,t,n,r){let i=e.split(`/`)[2]?.split(`?`)[0]||``,a=t.elementId??`si-${i}`,o=t.componentSrc??n,s=JSON.stringify(r),c=t.condition??`on:client`,l=t.framework??`preact`;return`<script type="module">
 import{hydrateServerIsland}from"/@fs${P(`src/client/server-island-hydrate.ts`)}";
 hydrateServerIsland(${JSON.stringify(a)},${JSON.stringify(o)},${s},${JSON.stringify(c)},${JSON.stringify(l)});
-<\/script>`}function P(t){let n=s(o(a(import.meta.url).resolve(`@useavalon/avalon`)),t);if(t.endsWith(`.ts`)&&!e(n)){let t=n.replace(/\.ts$/,`.js`);if(e(t))return t}return n}function me(t,n){let r=s(o(a(s(process.cwd(),`package.json`)).resolve(`@useavalon/${t}`)),n);if(n.endsWith(`.ts`)&&!e(r)){let t=r.replace(/\.ts$/,`.js`);if(e(t))return t}return r}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`,LAYOUTS:`virtual:avalon/layouts`,ASSETS:`virtual:avalon/assets`,RENDERER:`virtual:avalon/renderer`,CLIENT_ENTRY:`virtual:avalon/client-entry`,DEV_CSS_HMR:`virtual:avalon/dev-css-hmr`,INTEGRATION_LOADER:`virtual:avalon/integration-loader`,ACTIONS:`virtual:avalon/actions`,SSR_DOM:O};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}`,LAYOUTS:`\0${VIRTUAL_MODULE_IDS.LAYOUTS}`,ASSETS:`\0${VIRTUAL_MODULE_IDS.ASSETS}`,RENDERER:`\0${VIRTUAL_MODULE_IDS.RENDERER}`,CLIENT_ENTRY:`\0${VIRTUAL_MODULE_IDS.CLIENT_ENTRY}`,DEV_CSS_HMR:`\0${VIRTUAL_MODULE_IDS.DEV_CSS_HMR}`,INTEGRATION_LOADER:`\0${VIRTUAL_MODULE_IDS.INTEGRATION_LOADER}`,ACTIONS:`\0${VIRTUAL_MODULE_IDS.ACTIONS}`,SSR_DOM:`\0${VIRTUAL_MODULE_IDS.SSR_DOM}`};function he(e){return e===`react`?[]:[/^react/,/^react-dom/]}function ge(e){return e===`react`?[`import { createElement as h } from 'react';`,`import { renderToString as preactRenderToString } from 'react-dom/server';`]:[`import { h } from 'preact';`,`import preactRenderToString from 'preact-render-to-string';`]}function _e(e){return e===`react`?[`import { setShellRenderToString, setShellElementFactory } from '@useavalon/avalon/render/shell-engine';`,`import { renderToString as __reactRenderToString } from 'react-dom/server';`,`import { createElement as __reactCreateElement, Fragment as __reactFragment } from 'react';`,`setShellRenderToString((vnode) => __reactRenderToString(vnode));`,`setShellElementFactory(__reactCreateElement, __reactFragment);`]:[]}function ve(e){return e===`react`?`@useavalon/react/client`:`@useavalon/preact/client`}function ye(e){let t=P(`src/core/integrations/registry.ts`),n=[`solid`,`vue`,`svelte`,`lit`].filter(t=>e.includes(t));return`${[...n.includes(`lit`)?[`import "${O}";`]:[],`import { registry } from "${t}";`,...n.map(e=>`import { ${e}Integration } from "@useavalon/${e}";`),...n.map(e=>`if (${e}Integration) registry.register(${e}Integration);`)].join(`
+<\/script>`}function P(t){let n=s(o(a(import.meta.url).resolve(`@useavalon/avalon`)),t);if(t.endsWith(`.ts`)&&!e(n)){let t=n.replace(/\.ts$/,`.js`);if(e(t))return t}return n}function me(t,n){let r=s(o(a(s(process.cwd(),`package.json`)).resolve(`@useavalon/${t}`)),n);if(n.endsWith(`.ts`)&&!e(r)){let t=r.replace(/\.ts$/,`.js`);if(e(t))return t}return r}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`,LAYOUTS:`virtual:avalon/layouts`,ASSETS:`virtual:avalon/assets`,RENDERER:`virtual:avalon/renderer`,CLIENT_ENTRY:`virtual:avalon/client-entry`,DEV_CSS_HMR:`virtual:avalon/dev-css-hmr`,INTEGRATION_LOADER:`virtual:avalon/integration-loader`,ACTIONS:`virtual:avalon/actions`,SSR_DOM:O};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}`,LAYOUTS:`\0${VIRTUAL_MODULE_IDS.LAYOUTS}`,ASSETS:`\0${VIRTUAL_MODULE_IDS.ASSETS}`,RENDERER:`\0${VIRTUAL_MODULE_IDS.RENDERER}`,CLIENT_ENTRY:`\0${VIRTUAL_MODULE_IDS.CLIENT_ENTRY}`,DEV_CSS_HMR:`\0${VIRTUAL_MODULE_IDS.DEV_CSS_HMR}`,INTEGRATION_LOADER:`\0${VIRTUAL_MODULE_IDS.INTEGRATION_LOADER}`,ACTIONS:`\0${VIRTUAL_MODULE_IDS.ACTIONS}`,SSR_DOM:`\0${VIRTUAL_MODULE_IDS.SSR_DOM}`};function he(e){return e===`react`?[]:[/^react/,/^react-dom/]}function ge(e){return e===`react`?[`import { createElement as h } from 'react';`,`import { renderToString as preactRenderToString } from 'react-dom/server';`]:[`import { h } from 'preact';`,`import preactRenderToString from 'preact-render-to-string';`]}function _e(e){return e===`react`?[`import { setShellRenderToString, setShellElementFactory } from '@useavalon/avalon/render/shell-engine';`,`import { renderToString as __reactRenderToString } from 'react-dom/server';`,`import { createElement as __reactCreateElement, Fragment as __reactFragment } from 'react';`,`setShellRenderToString((vnode) => __reactRenderToString(vnode));`,`setShellElementFactory(__reactCreateElement, __reactFragment);`]:[]}function ve(e){return e===`react`?`@useavalon/react/client`:`@useavalon/preact/client`}function ye(e){let t=P(`src/core/integrations/registry.ts`),n=[`solid`,`vue`,`svelte`,`lit`].filter(t=>e.includes(t));return`${[...n.includes(`lit`)?[`import "${O}";`]:[],`import { registry } from "${t}";`,...n.map(e=>`import { ${e}Integration } from "@useavalon/${e}";`),`let registered = false;`,`export function ensureServerIslandIntegrations() {`,`  if (registered) return;`,`  registered = true;`,...n.map(e=>`  if (${e}Integration) registry.register(${e}Integration);`),`}`].join(`
 `)}\n`}function be(e,t,n,r,i,a){let o={preset:e.preset,serverDir:t.serverDir??e.serverDir??`./server`,routeRules:e.routeRules,runtimeConfig:e.runtimeConfig,compatibilityDate:e.compatibilityDate,scanDirs:[`.`],noExternals:[`estree-walker`,/^@useavalon\//,/^estree-util/,/^preact/,...he(r.core),/^vue/,/^@vue\//],handlers:[{route:`/_server-islands/**`,handler:i},{route:`/_actions/**`,handler:a}],virtual:{"virtual:server-island-manifest":()=>ie(n),"virtual:avalon-actions-manifest":()=>ue(n),"virtual:server-island-key":()=>{let e=process.env.AVALON_KEY??``;return`export const serverIslandKey = ${JSON.stringify(e)};\n`},"virtual:server-island-integrations":()=>ye(r.integrations),[O]:()=>k()},traceDeps:[...new Set([`undici`,...e.traceDeps??[]])]};return we(o,e,t),o}function xe(e,t,n){if(n.renderer===!1){e.renderer=!1;return}t.renderer&&(e.renderer=t.renderer)}function Se(){return process.argv.includes(`build`)||process.env.NODE_ENV===`production`}function Ce(e,t){t.experimentalTasks&&Se()&&(e.experimental={...e.experimental,tasks:!0},t.tasks&&Object.keys(t.tasks).length>0&&(e.tasks=t.tasks),t.scheduledTasks&&Object.keys(t.scheduledTasks).length>0&&(e.scheduledTasks=t.scheduledTasks))}function we(e,t,n){xe(e,t,n),t.publicRuntimeConfig&&(e.publicRuntimeConfig=t.publicRuntimeConfig),t.publicAssets&&(e.publicAssets=t.publicAssets),t.compressPublicAssets&&(e.compressPublicAssets=t.compressPublicAssets),t.serverEntry&&(e.serverEntry=t.serverEntry),Ce(e,t),t.prerender&&(e.prerender={routes:[],crawlLinks:!1})}export function createNitroIntegration(e,t={}){let n=v(t,e),r=c(be(n,t,process.cwd(),e,P(`src/server-islands/route.ts`),P(`src/actions/route.ts`))),i=createNitroCoordinationPlugin({avalonConfig:e,nitroConfig:t,verbose:e.verbose}),a=createVirtualModulesPlugin({avalonConfig:e,nitroConfig:t,verbose:e.verbose}),o=b(e,t),s=y(e,{verbose:e.verbose,generatePreloadHints:!0}),l=S(x(t.preset??`node_server`,e.isDev)),u=d(t.cron,e.verbose);return{nitroOptions:n,plugins:[te(),...Array.isArray(r)?r:[r],i,a,o,s,l,u]}}export function createNitroCoordinationPlugin(e){let{avalonConfig:t,verbose:n}=e;return{name:`avalon:nitro-coordination`,enforce:`pre`,config(e,{command:t}){if(t===`serve`)return{server:{watch:{ignored:[`**/.output/**`,`**/dist/**`,`**/.netlify/**`,`**/.vercel/**`,`**/.cloudflare/**`,`**/.wrangler/**`,`**/.firebase/**`,`**/.amplify-hosting/**`]},fs:{deny:[`.output`,`dist`,`.netlify`,`.vercel`,`.cloudflare`,`.wrangler`,`.firebase`,`.amplify-hosting`]}}}},configResolved(e){globalThis.__avalonHydrationMode=e.command===`serve`?`entry-client`:`per-island`;try{u(e.root||process.cwd())}catch{}},configureServer(e){globalThis.__viteDevServer=e;let i=e.config.root||process.cwd(),a=e=>{if(e.includes(`/actions/`))try{u(i)}catch{}};e.watcher.on(`add`,a),e.watcher.on(`unlink`,a);let o=e.config.root||process.cwd(),c=e.config.build?.outDir?s(o,e.config.build.outDir):s(o,`dist`);try{r(c,{recursive:!0,force:!0})}catch{}try{r(s(o,`.output`),{recursive:!0,force:!0})}catch{}let d=!1,f=new Promise(t=>{let n=()=>{(e.environments?.nitro)?.devServer?.entry||d?(d=!0,t()):setTimeout(n,50)};setTimeout(n,100),setTimeout(()=>{d=!0,t()},15e3)});e.middlewares.use(async(e,t,n)=>{if(d)return n();let r=e.url||`/`;if(r.startsWith(`/@`)||r.startsWith(`/__`)||/\/[^/]+\.[a-z0-9]+(\?|$)/i.test(r))return n();await f,n()});let p=null;async function m(){return p||=await g({baseDir:`${e.config.root||process.cwd()}/src`,devMode:!1}),p}function h(){p=null}ke(e,t,n,h),m().catch(e=>{console.warn(`[middleware] Failed to discover middleware:`,e)});let _=e.environments?.ssr,v=!!_&&l(_);v&&De(e,t.integrations,n).catch(e=>{console.error(`[prewarm] Core modules pre-warm failed:`,e)}),e.middlewares.use(async(n,r,i)=>{let a=n.url||`/`;if(!a.startsWith(`/_server-islands/`)||!v)return i();try{let{decrypt:i}=await e.ssrLoadModule(P(`src/server-islands/encryption.ts`)),{h:o,renderToString:s}=await U(e,t.core),c=new URL(a,`http://${n.headers.host||`localhost`}`).searchParams.get(`p`)||``;if(!c&&n.method===`POST`&&(c=await A(n,`Timed out reading server island request body`)),!c){r.statusCode=400,r.setHeader(`Content-Type`,`text/plain`),r.end(`Missing encrypted props`);return}let l=fe(c,i);if(!l.ok){r.statusCode=400,r.setHeader(`Content-Type`,`text/plain`),r.end(`Bad Request: decryption failed`);return}let{props:u,srcPath:d,islandMeta:f}=l;if(!d){r.statusCode=404,r.setHeader(`Content-Type`,`text/plain`),r.end(`Component not found (no __src in payload)`);return}let p=(await e.ssrLoadModule(d)).default;if(typeof p!=`function`){r.statusCode=500,r.setHeader(`Content-Type`,`text/plain`),r.end(`Module "${d}" does not export a default component function`);return}let m=s(o(p,u));f&&(m+=pe(a,f,d,u)),r.statusCode=200,r.setHeader(`Content-Type`,`text/html`),r.setHeader(`Cache-Control`,`private, no-store`),r.end(m)}catch(e){console.error(`[server-islands] Dev handler error:`,e),r.statusCode=500,r.setHeader(`Content-Type`,`text/plain`),r.end(`Server island render failed: ${e instanceof Error?e.message:String(e)}`)}}),e.middlewares.use(async(t,n,r)=>{let i=t.url||`/`;if(!i.startsWith(`/_actions/`)||!v)return r();try{let r=N(e.config.root||process.cwd()),[a,o,s]=await Promise.all([e.ssrLoadModule(P(`src/actions/endpoint.ts`)),e.ssrLoadModule(P(`src/actions/registry.ts`)),r?e.ssrLoadModule(r):Promise.resolve({server:{}})]),c=o.flattenActions(s.server),l=a.defineActionHandler({registry:c,isDev:!0}),u=new URL(i,`http://${t.headers.host||`localhost`}`),d=(t.method||`GET`).toUpperCase(),f;d===`POST`&&(f=await A(t,`Timed out reading action request body`));let p=await l({url:u,web:{request:new Request(u,{method:d,headers:t.headers,body:f})},context:{}});n.statusCode=p.status,p.headers.forEach((e,t)=>{n.setHeader(t,e)}),n.end(await p.text())}catch(e){console.error(`[actions] Dev handler error:`,e),n.statusCode=500,n.setHeader(`Content-Type`,`application/json`),n.end(JSON.stringify({error:{code:`INTERNAL_SERVER_ERROR`,message:e instanceof Error?e.message:String(e)}}))}}),e.middlewares.use(async(r,i,a)=>{if(!v)return a();let o=r.url||`/`;if(o.endsWith(`.html`)&&(o=o.slice(0,-5)||`/`),o===`/index`&&(o=`/`),o.startsWith(`/@`)||o.startsWith(`/__`)||o.startsWith(`/node_modules/`)||o.startsWith(`/src/client/`)||o.startsWith(`/packages/`)||o.includes(`.`)&&!o.endsWith(`/`)||o.startsWith(`/api/`))return a();try{if(await Te(e,o,r,i,m,n)||await qe(e,o,t,i))return;let a=await Je(e,o,t);if(a){i.statusCode=200,i.setHeader(`Content-Type`,`text/html`),i.end(a);return}await Ee(e,o,i,t)}catch(e){console.error(`[SSR Error]`,e),i.statusCode=500,i.setHeader(`Content-Type`,`text/html`),i.end(T(e))}})},buildStart(){}}}async function Te(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 _({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 Ee(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(ee(t))}}async function De(e,t,n){let r=performance.now(),i=[{path:P(`src/render/ssr.ts`),assignTo:`ssr`},{path:P(`src/core/layout/enhanced-layout-resolver.ts`),assignTo:`layout`},{path:P(`src/middleware/index.ts`),assignTo:null},...t.map(e=>({path:me(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`&&(V=r),n===`layout`&&(H=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,i=null;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:e===VIRTUAL_MODULE_IDS.LAYOUTS?RESOLVED_VIRTUAL_IDS.LAYOUTS:e===VIRTUAL_MODULE_IDS.ASSETS?RESOLVED_VIRTUAL_IDS.ASSETS:e===VIRTUAL_MODULE_IDS.RENDERER?RESOLVED_VIRTUAL_IDS.RENDERER:e===VIRTUAL_MODULE_IDS.CLIENT_ENTRY?RESOLVED_VIRTUAL_IDS.CLIENT_ENTRY:e===VIRTUAL_MODULE_IDS.DEV_CSS_HMR?RESOLVED_VIRTUAL_IDS.DEV_CSS_HMR:e===VIRTUAL_MODULE_IDS.INTEGRATION_LOADER?RESOLVED_VIRTUAL_IDS.INTEGRATION_LOADER:e===VIRTUAL_MODULE_IDS.ACTIONS?RESOLVED_VIRTUAL_IDS.ACTIONS:e===VIRTUAL_MODULE_IDS.SSR_DOM?RESOLVED_VIRTUAL_IDS.SSR_DOM:null},async load(e){return e===RESOLVED_VIRTUAL_IDS.PAGE_ROUTES?await Ae(t,r):e===RESOLVED_VIRTUAL_IDS.PAGE_LOADER?await je(t,r):e===RESOLVED_VIRTUAL_IDS.ISLAND_MANIFEST?Me():e===RESOLVED_VIRTUAL_IDS.RUNTIME_CONFIG?Ne(t,n):e===RESOLVED_VIRTUAL_IDS.CONFIG?generateConfigModule(t,n):e===RESOLVED_VIRTUAL_IDS.LAYOUTS?(i||=await Pe(t,n),i):e===RESOLVED_VIRTUAL_IDS.ASSETS?Fe(n):e===RESOLVED_VIRTUAL_IDS.RENDERER?Ie(t):e===RESOLVED_VIRTUAL_IDS.CLIENT_ENTRY?await ze(t,n):e===RESOLVED_VIRTUAL_IDS.DEV_CSS_HMR?ne():e===RESOLVED_VIRTUAL_IDS.INTEGRATION_LOADER?generateIntegrationLoaderModule(t):e===RESOLVED_VIRTUAL_IDS.ACTIONS?de():e===RESOLVED_VIRTUAL_IDS.SSR_DOM?k():null},handleHotUpdate({file:e,server:t}){let{isPage:n,isComponent:r,isLayout:a,isCss:o}=z(e);o&&(i=null),n&&(I(t,RESOLVED_VIRTUAL_IDS.PAGE_ROUTES),I(t,RESOLVED_VIRTUAL_IDS.PAGE_LOADER),L(t)),(n||r||a)&&(i=null,I(t,RESOLVED_VIRTUAL_IDS.LAYOUTS),a&&F(t,RESOLVED_VIRTUAL_IDS.CLIENT_ENTRY),setTimeout(()=>{t.ws.send({type:`full-reload`,path:`*`})},500)),Oe(e)&&F(t,RESOLVED_VIRTUAL_IDS.CONFIG)}}}function F(e,t){let n=e.moduleGraph.getModuleById(t);n&&e.moduleGraph.invalidateModule(n)}function I(e,t){F(e,t);let n=e.environments;if(n)for(let e of Object.values(n)){let n=e.moduleGraph;if(n)try{let e=n.getModuleById(t);e&&n.invalidateModule(e)}catch{}}}async function L(e){let t=e.environments?.nitro;if(t)try{t.devServer?.sendMessage?.({type:`full-reload`}),await t.devServer?.reloadRoutes?.()}catch{}}function R(e){I(e,RESOLVED_VIRTUAL_IDS.PAGE_ROUTES),I(e,RESOLVED_VIRTUAL_IDS.PAGE_LOADER),L(e),setTimeout(()=>{e.ws.send({type:`full-reload`,path:`*`})},500)}function z(e){let t=e.endsWith(`.css`);return{isPage:e.includes(`/pages/`)&&!t,isComponent:e.includes(`/components/`)&&/\.[tj]sx?$/.test(e),isLayout:(e.includes(`/layouts/`)||e.includes(`_layout`))&&/\.[tj]sx?$/.test(e),isCss:t}}function Oe(e){return e.includes(`vite.config`)||e.includes(`avalon.config`)||e.includes(`nitro.config`)}function ke(e,t,n,r){e.watcher.on(`change`,e=>{e.includes(`_middleware`)&&(h(),r?.()),(e.includes(`/render/`)||e.includes(`/layout/`)||e.includes(`/islands/`))&&(V=null,H=null),(e.includes(`/layouts/`)||e.includes(`_layout`))&&globalThis.__avalonLayoutResolver?.clearCache?.()}),e.watcher.on(`add`,t=>{t.includes(`_middleware`)&&(h(),r?.()),isPageFile(t)&&R(e)}),e.watcher.on(`unlink`,t=>{t.includes(`_middleware`)&&(h(),r?.()),isPageFile(t)&&R(e)})}export function isPageFile(e){return z(e).isPage}async function Ae(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 je(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(`,

package/dist/src/vite-plugin/server-islands-plugin.js

@@ -1,3 +1,3 @@
-import{dirname as e,relative as t,resolve as n}from"node:path";import{generateKey as r,getKey as i}from"../server-islands/encryption.js";import{addToManifest as a,clearManifest as o,generateComponentId as s,getManifest as c}from"../server-islands/manifest.js";const l=`virtual:server-island-manifest`,u=`\0`+l,d=`virtual:server-island-key`,f=`\0`+d,p=/<([A-Z][a-zA-Z0-9_$]*)\s[\s\S]*?\bserver\s*[={/>]/;function m(e){let t=[],n=/^[ \t]*import\s+([A-Z]\w*)\s+from\s+(['"][^'"]+['"])/gm,r=null;for(r=n.exec(e);r!==null;r=n.exec(e))t.push({localName:r[1],importPath:r[2].slice(1,-1)});return t}function h(e,t){return new RegExp(String.raw`<${t}\s[\s\S]*?\bserver\s*[={/>]`).test(e)}export function resolveToRelativePath(r,i,a){return r.startsWith(`/src/`)||r.startsWith(`/app/`)?r:r.startsWith(`@/`)?`/app/${r.slice(2)}`:r.startsWith(`@shared/`)?`/app/shared/${r.slice(8)}`:r.startsWith(`@modules/`)?`/app/modules/${r.slice(9)}`:r.startsWith(`~/`)?`/src/${r.slice(2)}`:r.startsWith(`$components/`)?`/src/components/${r.slice(12)}`:r.startsWith(`$islands/`)?`/src/islands/${r.slice(9)}`:r.startsWith(`.`)?`/`+t(a,n(e(i),r)).replaceAll(`\\`,`/`):r}export function serverIslandsPlugin(e={}){let t,n,g=!!process.env.AVALON_KEY;return{name:`avalon:server-islands`,enforce:`pre`,config(){process.env.AVALON_KEY||(process.env.AVALON_KEY=r())},configResolved(e){t=e.root},buildStart(){o(),n=i(),e.verbose&&console.log(`[avalon:server-islands] Encryption key source: ${g?`AVALON_KEY env var`:`generated per-build`}`)},resolveId(e){return e===l?u:e===d?f:e===`virtual:server-island-integrations`?`\0virtual:server-island-integrations`:null},load(e){if(e===`\0virtual:server-island-integrations`)return`export {};`;if(e===u){let e=c(),t=Object.entries(e),n=`export const serverIslandManifest = ${JSON.stringify(e)};\n\n`;n+=`export const serverIslandLoaders = {
+import{dirname as e,relative as t,resolve as n}from"node:path";import{generateKey as r,getKey as i}from"../server-islands/encryption.js";import{addToManifest as a,clearManifest as o,generateComponentId as s,getManifest as c}from"../server-islands/manifest.js";const l=`virtual:server-island-manifest`,u=`\0`+l,d=`virtual:server-island-key`,f=`\0`+d,p=/<([A-Z][a-zA-Z0-9_$]*)\s[\s\S]*?\bserver\s*[={/>]/;function m(e){let t=[],n=/^[ \t]*import\s+([A-Z]\w*)\s+from\s+(['"][^'"]+['"])/gm,r=null;for(r=n.exec(e);r!==null;r=n.exec(e))t.push({localName:r[1],importPath:r[2].slice(1,-1)});return t}function h(e,t){return new RegExp(String.raw`<${t}\s[\s\S]*?\bserver\s*[={/>]`).test(e)}export function resolveToRelativePath(r,i,a){return r.startsWith(`/src/`)||r.startsWith(`/app/`)?r:r.startsWith(`@/`)?`/app/${r.slice(2)}`:r.startsWith(`@shared/`)?`/app/shared/${r.slice(8)}`:r.startsWith(`@modules/`)?`/app/modules/${r.slice(9)}`:r.startsWith(`~/`)?`/src/${r.slice(2)}`:r.startsWith(`$components/`)?`/src/components/${r.slice(12)}`:r.startsWith(`$islands/`)?`/src/islands/${r.slice(9)}`:r.startsWith(`.`)?`/`+t(a,n(e(i),r)).replaceAll(`\\`,`/`):r}export function serverIslandsPlugin(e={}){let t,n,g=!!process.env.AVALON_KEY;return{name:`avalon:server-islands`,enforce:`pre`,config(){process.env.AVALON_KEY||(process.env.AVALON_KEY=r())},configResolved(e){t=e.root},buildStart(){o(),n=i(),e.verbose&&console.log(`[avalon:server-islands] Encryption key source: ${g?`AVALON_KEY env var`:`generated per-build`}`)},resolveId(e){return e===l?u:e===d?f:null},load(e){if(e===u){let e=c(),t=Object.entries(e),n=`export const serverIslandManifest = ${JSON.stringify(e)};\n\n`;n+=`export const serverIslandLoaders = {
 `;for(let[e,r]of t)n+=`  ${JSON.stringify(e)}: () => import(${JSON.stringify(r)}),\n`;return n+=`};
 `,n}return e===f?`export const serverIslandKey = ${JSON.stringify(n)};`:null},transform(n,r){if(!/\.(tsx|jsx)$/.test(r)||r.includes(`node_modules`)||!p.test(n))return null;let i=m(n);if(i.length===0)return null;for(let o of i)if(h(n,o.localName)){let n=resolveToRelativePath(o.importPath,r,t),i=s(n);a(i,n),e.verbose&&console.log(`[avalon:server-islands] Registered: ${o.localName} → ${i} (${n})`)}return null},generateBundle(){let t=c(),n=Object.keys(t).length;n>0&&e.verbose&&console.log(`[avalon:server-islands] Manifest contains ${n} server island(s)`)}}}

package/dist/src/vite-plugin/ssr-dom-shim-module.d.ts

@@ -2,8 +2,26 @@
  * Separate module so ESM evaluates this stub before `@useavalon/lit`
  * (and `lit-html`, which reads `document` at module eval). Imports in the
  * same file are hoisted together; a dedicated first import is the only
- * ordering guarantee. Avoid importing `linkedom` here — Bun's layout is
- * not visible to Rolldown from a virtual module.
+ * ordering guarantee.
+ *
+ * Prefer `@lit-labs/ssr-dom-shim` for HTMLElement / customElements so Lit SSR
+ * can emit declarative shadow DOM. A no-op `customElements.define` left Lit
+ * islands as empty tags until client hydration.
+ *
+ * Cloudflare's on-disk `_dom_stub.mjs` cannot use bare package imports (the
+ * Pages worker has no node_modules). Use {@link ssrDomStubFileSource} there.
  */
 export declare const SSR_DOM_VIRTUAL_ID = "virtual:avalon/ssr-dom";
+/**
+ * Nitro virtual module + prerender Node wrapper: real ssr-dom-shim classes.
+ * Rolldown / Node resolve `@lit-labs/ssr-dom-shim` from the project graph.
+ * CSSStyleSheet must exist before CustomElementRegistry.define runs Lit
+ * finalizeStyles (constructable stylesheets).
+ */
 export declare function ssrDomShimModuleSource(): string;
+/**
+ * Self-contained stub for Cloudflare `_dom_stub.mjs` (no bare imports).
+ * Keeps a working customElements Map so dynamic Lit SSR in the Worker does not
+ * fall back to empty tags when the real shim package is unavailable.
+ */
+export declare function ssrDomStubFileSource(): string;

package/dist/src/vite-plugin/ssr-dom-shim-module.js

@@ -1,24 +1,13 @@
-export const SSR_DOM_VIRTUAL_ID=`virtual:avalon/ssr-dom`;export function ssrDomShimModuleSource(){return`
-if (typeof globalThis.HTMLElement === "undefined") {
-	globalThis.HTMLElement = class HTMLElement {};
-}
-if (typeof globalThis.Element === "undefined") {
-	globalThis.Element = class Element {};
-}
-if (typeof globalThis.EventTarget === "undefined") {
-	globalThis.EventTarget = class EventTarget {};
-}
-if (typeof globalThis.Event === "undefined") {
-	globalThis.Event = class Event { constructor(type) { this.type = type; } };
-}
-if (typeof globalThis.CustomEvent === "undefined") {
-	globalThis.CustomEvent = class CustomEvent extends Event {
-		constructor(type, init) { super(type); this.detail = init?.detail; }
+export const SSR_DOM_VIRTUAL_ID=`virtual:avalon/ssr-dom`;function e(){return`
+if (typeof globalThis.CSSStyleSheet === "undefined") {
+	globalThis.CSSStyleSheet = class CSSStyleSheet {
+		constructor() { this.cssRules = []; }
+		replaceSync() {}
+		replace() { return Promise.resolve(this); }
+		insertRule() { return 0; }
+		deleteRule() {}
 	};
 }
-if (typeof globalThis.customElements === "undefined") {
-	globalThis.customElements = { define() {}, get() { return undefined; }, whenDefined() { return Promise.resolve(); } };
-}
 if (typeof globalThis.document === "undefined") {
 	const createEl = () => ({
 		nodeType: 1,
@@ -47,4 +36,86 @@ if (typeof globalThis.document === "undefined") {
 if (typeof globalThis.Node === "undefined") {
 	globalThis.Node = class Node {};
 }
+`}export function ssrDomShimModuleSource(){return`
+${e()}
+import {
+	CustomElementRegistry,
+	CustomEvent as ShimCustomEvent,
+	Element as ShimElement,
+	Event as ShimEvent,
+	EventTarget as ShimEventTarget,
+	HTMLElement as ShimHTMLElement,
+} from "@lit-labs/ssr-dom-shim";
+
+globalThis.HTMLElement = ShimHTMLElement;
+globalThis.Element = ShimElement;
+globalThis.EventTarget = ShimEventTarget;
+globalThis.Event = ShimEvent;
+globalThis.CustomEvent = ShimCustomEvent;
+globalThis.customElements = new CustomElementRegistry();
+`}export function ssrDomStubFileSource(){return`
+if (typeof globalThis.HTMLElement === "undefined") {
+	globalThis.HTMLElement = class HTMLElement {};
+}
+if (typeof globalThis.Element === "undefined") {
+	globalThis.Element = class Element {};
+}
+if (typeof globalThis.EventTarget === "undefined") {
+	globalThis.EventTarget = class EventTarget {
+		addEventListener() {}
+		removeEventListener() {}
+		dispatchEvent() { return true; }
+	};
+}
+if (typeof globalThis.Event === "undefined") {
+	globalThis.Event = class Event { constructor(type) { this.type = type; } };
+}
+if (typeof globalThis.CustomEvent === "undefined") {
+	globalThis.CustomEvent = class CustomEvent extends Event {
+		constructor(type, init) { super(type); this.detail = init?.detail; }
+	};
+}
+if (typeof globalThis.customElements === "undefined") {
+	const registry = new Map();
+	globalThis.customElements = {
+		define(name, ctor) { registry.set(name, ctor); },
+		get(name) { return registry.get(name); },
+		whenDefined(name) {
+			const ctor = registry.get(name);
+			return ctor ? Promise.resolve(ctor) : Promise.resolve();
+		},
+		getName(ctor) {
+			for (const [name, registered] of registry) {
+				if (registered === ctor) return name;
+			}
+			return null;
+		},
+	};
+} else if (typeof globalThis.customElements.get === "function") {
+	const probeName = "avalon-ce-probe";
+	try {
+		const Probe = class extends globalThis.HTMLElement {};
+		globalThis.customElements.define(probeName, Probe);
+		if (globalThis.customElements.get(probeName) !== Probe) {
+			const registry = new Map();
+			globalThis.customElements = {
+				define(name, ctor) { registry.set(name, ctor); },
+				get(name) { return registry.get(name); },
+				whenDefined(name) {
+					const ctor = registry.get(name);
+					return ctor ? Promise.resolve(ctor) : Promise.resolve();
+				},
+				getName(ctor) {
+					for (const [name, registered] of registry) {
+						if (registered === ctor) return name;
+					}
+					return null;
+				},
+			};
+		}
+	} catch {
+		/* leave existing registry */
+	}
+}
+${e()}
 `}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@useavalon/avalon",
-	"version": "0.3.2-canary.14",
+	"version": "0.3.2-canary.15",
 	"description": "Multi-framework islands architecture for the modern web",
 	"license": "MIT",
 	"type": "module",
@@ -164,7 +164,7 @@
 	},
 	"dependencies": {
 		"@mdx-js/rollup": "^3.0.0",
-		"@useavalon/core": "^0.3.2-canary.14",
+		"@useavalon/core": "^0.3.2-canary.15",
 		"h3": "^2.0.1-rc.16",
 		"marked": "^17.0.4",
 		"oxc-parser": "^0.120.0",