@useavalon/avalon 0.1.66 → 0.1.67

package/dist/src/build/bundle-audit.d.ts

@@ -11,6 +11,7 @@
  * @module build/bundle-audit
  */
 import type { Plugin } from "vite";
+import { z } from "zod";
 /** Represents a single chunk in the build output. */
 export interface ChunkInfo {
     fileName: string;
@@ -42,6 +43,14 @@ export interface DuplicatedModule {
     /** File names of chunks containing this module. */
     chunks: string[];
 }
+/** Per-framework size thresholds for island chunks (in bytes). */
+export interface PerFrameworkThresholds {
+    solid: number;
+    preact: number;
+    react: number;
+    vue: number;
+    svelte: number;
+}
 /** Options for the bundle audit Vite plugin. */
 export interface BundleAuditOptions {
     /** Maximum allowed size (in bytes) for any single island chunk. Default: 20480 (20 KiB). */
@@ -52,11 +61,69 @@ export interface BundleAuditOptions {
     logReport?: boolean;
     /** Whether to emit warnings for oversized chunks. Default: true. */
     warnOnOversized?: boolean;
+    /** Per-framework size thresholds for island chunks. When provided, islands are also checked against their framework-specific limit. */
+    perFrameworkThresholds?: Partial<PerFrameworkThresholds>;
+    /** Path to the benchmark baseline JSON file. When set, enables benchmark comparison mode. */
+    benchmarkBaseline?: string;
+    /** Maximum allowed regression in bytes before flagging. Default: 500. */
+    regressionThreshold?: number;
+}
+/** Zod schema for the benchmark baseline file used to track island bundle sizes over time. */
+export declare const BenchmarkBaselineSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    timestamp: z.ZodString;
+    islands: z.ZodRecord<z.ZodString, z.ZodObject<{
+        size: z.ZodNumber;
+        framework: z.ZodString;
+    }, z.core.$strip>>;
+    references: z.ZodObject<{
+        astroSolidCounter: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Benchmark baseline data parsed from the baseline JSON file. */
+export type BenchmarkBaseline = z.infer<typeof BenchmarkBaselineSchema>;
+/** Result of comparing a single island's current size against the benchmark baseline. */
+export interface BenchmarkResult {
+    island: string;
+    currentSize: number;
+    baselineSize: number | null;
+    deltaBytes: number;
+    deltaPercent: number;
+    framework: string;
+    astroReferenceSize?: number;
 }
+/**
+ * Compare current island sizes against a stored benchmark baseline.
+ *
+ * This is a pure function — the caller is responsible for loading and parsing
+ * the baseline JSON file. For each island in `currentIslands`, the function
+ * looks up the baseline entry by island name and computes the delta.
+ *
+ * @param currentIslands - Array of current island build results with name, size, and framework
+ * @param baseline - Parsed benchmark baseline data
+ * @param regressionThreshold - Maximum allowed regression in bytes before flagging (default: 500)
+ * @returns Results per island and whether any regression was detected
+ */
+export declare function compareBenchmarkBaseline(currentIslands: Array<{
+    island: string;
+    size: number;
+    framework: string;
+}>, baseline: BenchmarkBaseline, regressionThreshold?: number): {
+    results: BenchmarkResult[];
+    hasRegression: boolean;
+};
 /** Default per-chunk size threshold: 20 KiB */
 export declare const DEFAULT_CHUNK_THRESHOLD: number;
 /** Default total JS size threshold: 20 KiB (from requirements) */
 export declare const DEFAULT_TOTAL_THRESHOLD: number;
+/** Default per-framework island chunk thresholds. Solid: 6 KiB, others: 10 KiB. */
+export declare const DEFAULT_PER_FRAMEWORK_THRESHOLDS: PerFrameworkThresholds;
+/**
+ * Detect the framework from an island chunk file name.
+ * Looks for `.solid.`, `.preact.`, `.react.`, `.vue.`, `.svelte.` in the file name.
+ * Returns the framework name or `null` if none is detected.
+ */
+export declare function detectFrameworkFromFileName(fileName: string): string | null;
 /** Shape of a bundle asset — loose enough to handle both Rollup and Rolldown. */
 export type BundleAsset = Record<string, unknown> & {
     type: string;
@@ -87,6 +154,7 @@ export declare function findDevOnlyModules(chunks: ChunkInfo[]): Array<{
 export declare function generateAuditReport(chunks: ChunkInfo[], options?: {
     chunkSizeThreshold?: number;
     totalSizeThreshold?: number;
+    perFrameworkThresholds?: Partial<PerFrameworkThresholds>;
 }): BundleAuditReport;
 /**
  * Format a byte count as a human-readable KiB string.

package/dist/src/build/bundle-audit.js

@@ -1,2 +1,2 @@
-export const DEFAULT_CHUNK_THRESHOLD=20*1024;export const DEFAULT_TOTAL_THRESHOLD=20*1024;const n=[/\/dev\.js$/,/\/dev\.mjs$/,/__DEV__/,/hot-reload/,/hmr-coordinator/,/hmr-error-overlay/,/solid-refresh/];export function extractChunks(e){let t=[];for(let[n,r]of Object.entries(e)){if(r.type!==`chunk`)continue;let e=r.fileName??n,i=r.code??``,a=r.moduleIds??Object.keys(r.modules??{});t.push({fileName:e,size:Buffer.byteLength(i,`utf-8`),moduleIds:a,isIsland:e.startsWith(`islands/`)||e.includes(`/islands/`),isEntry:r.isEntry??!1})}return t.sort((e,t)=>t.size-e.size)}export function findDuplicatedModules(e){let t=new Map;for(let n of e)for(let e of n.moduleIds){if(e.startsWith(`\0`))continue;let r=t.get(e)??[];r.push(n.fileName),t.set(e,r)}let n=[];for(let[e,r]of t)r.length>1&&n.push({moduleId:e,chunks:r});return n.sort((e,t)=>t.chunks.length-e.chunks.length)}export function findDevOnlyModules(e){let t=[];for(let r of e)for(let e of r.moduleIds)for(let i of n)i.test(e)&&t.push({chunkFileName:r.fileName,moduleId:e,pattern:i.source});return t}export function generateAuditReport(t,n={}){let r=n.chunkSizeThreshold??DEFAULT_CHUNK_THRESHOLD;return{chunks:t,totalJsBytes:t.reduce((e,t)=>e+t.size,0),islandJsBytes:t.filter(e=>e.isIsland).reduce((e,t)=>e+t.size,0),oversizedChunks:t.filter(e=>e.isIsland&&e.size>r),duplicatedModules:findDuplicatedModules(t)}}export function formatKiB(e){return`${(e/1024).toFixed(2)} KiB`}function c(e){return e.isIsland?` [island]`:e.isEntry?` [entry]`:`        `}function l(e,t){return e.length<=t?e:`...${e.slice(-(t-3))}`}export function formatAuditReport(e){let t=[`┌─────────────────────────────────────────────────────┐`,`│  Bundle Audit Report                                │`,`├─────────────────────────────────────────────────────┤`,`│  Total JS:    ${formatKiB(e.totalJsBytes).padStart(12)}                       │`,`│  Island JS:   ${formatKiB(e.islandJsBytes).padStart(12)}                       │`,`│  Chunks:      ${String(e.chunks.length).padStart(12)}                       │`,`├─────────────────────────────────────────────────────┤`,`│  Chunks by size:                                    │`];for(let n of e.chunks){let e=c(n),r=l(n.fileName,32);t.push(`│  ${e} ${r.padEnd(32)} ${formatKiB(n.size).padStart(10)} │`)}if(e.oversizedChunks.length>0){t.push(`├─────────────────────────────────────────────────────┤`),t.push(`│  Oversized island chunks:                           │`);for(let n of e.oversizedChunks)t.push(`│    ${n.fileName.padEnd(38)} ${formatKiB(n.size).padStart(10)} │`)}if(e.duplicatedModules.length>0){t.push(`├─────────────────────────────────────────────────────┤`),t.push(`│  Duplicated modules: ${e.duplicatedModules.length}                            │`);for(let n of e.duplicatedModules.slice(0,5)){let e=l(n.moduleId,40);t.push(`│    ${e.padEnd(40)} x${n.chunks.length}        │`)}e.duplicatedModules.length>5&&t.push(`│    ... and ${e.duplicatedModules.length-5} more                              │`)}return t.push(`└─────────────────────────────────────────────────────┘`),t.join(`
-`)}export function auditBuildConfig(e){let t=[],n=[],r=e.build?.minify??`esbuild`,i=r!==!1;i?n.push(`Minification enabled: ${r}`):t.push(`build.minify is disabled — production builds should be minified`);let a=e.build?.target??`modules`,o=a!==`es5`&&a!==`es3`;o?n.push(`Modern build target: ${JSON.stringify(a)}`):t.push(`build.target is "${a}" — consider "es2020" or higher for smaller output`);let s=e.define??{},c=`process.env.NODE_ENV`in s||`__DEV__`in s||`__PROD__`in s;c?n.push(`process.env.NODE_ENV / __DEV__ / __PROD__ defined for dead code elimination`):t.push(`No process.env.NODE_ENV define — dev-only code may leak into production`);let l=e.build?.rollupOptions?.treeshake!=null;return l?n.push(`Custom treeshake.moduleSideEffects configured`):t.push(`No custom treeshake config — solid-js may not be fully tree-shaken`),{hasMinify:i,minifyValue:r,hasModernTarget:o,targetValue:a,hasNodeEnvDefine:c,hasTreeshakeConfig:l,issues:t,optimizations:n}}export function bundleAuditPlugin(t={}){let{chunkSizeThreshold:n=DEFAULT_CHUNK_THRESHOLD,totalSizeThreshold:i=20480,logReport:c=!0,warnOnOversized:l=!0}=t,d=!1;return{name:`avalon:bundle-audit`,enforce:`post`,config(e,{command:t}){d=t===`build`},configResolved(e){if(d&&c){let t=e.build,n=t?.rollupOptions,r=auditBuildConfig({build:{minify:t?.minify,target:t?.target,rollupOptions:{treeshake:n?.treeshake}},define:e.define});if(r.issues.length>0)for(let e of r.issues)console.warn(`⚠️  [bundle-audit] ${e}`)}},generateBundle(e,t){if(!d)return;let u=extractChunks(t),f=generateAuditReport(u,{chunkSizeThreshold:n,totalSizeThreshold:i});if(c&&console.log(formatAuditReport(f)),l&&f.oversizedChunks.length>0)for(let e of f.oversizedChunks)this.warn(`Island chunk "${e.fileName}" is ${formatKiB(e.size)} (threshold: ${formatKiB(n)})`);l&&f.totalJsBytes>i&&this.warn(`Total JS size ${formatKiB(f.totalJsBytes)} exceeds threshold of ${formatKiB(i)}`);let p=findDevOnlyModules(u);if(p.length>0)for(let e of p)this.warn(`Dev-only module "${e.moduleId}" found in chunk "${e.chunkFileName}"`)}}}
+import{readFileSync as e}from"node:fs";import{z as t}from"zod";export const BenchmarkBaselineSchema=t.object({version:t.number(),timestamp:t.string(),islands:t.record(t.string(),t.object({size:t.number(),framework:t.string()})),references:t.object({astroSolidCounter:t.number()})});export function compareBenchmarkBaseline(e,t,n=500){let r=t.references.astroSolidCounter,i=e.map(e=>{let n=t.islands[e.island];if(n){let t=e.size-n.size,i=t/n.size*100;return{island:e.island,currentSize:e.size,baselineSize:n.size,deltaBytes:t,deltaPercent:i,framework:e.framework,astroReferenceSize:r}}return{island:e.island,currentSize:e.size,baselineSize:null,deltaBytes:0,deltaPercent:0,framework:e.framework,astroReferenceSize:r}});return{results:i,hasRegression:i.some(e=>e.deltaBytes>n)}}export const DEFAULT_CHUNK_THRESHOLD=20*1024;export const DEFAULT_TOTAL_THRESHOLD=20*1024;export const DEFAULT_PER_FRAMEWORK_THRESHOLDS={solid:6*1024,preact:10*1024,react:10*1024,vue:10*1024,svelte:10*1024};const s=[`.solid.`,`.preact.`,`.react.`,`.vue.`,`.svelte.`];export function detectFrameworkFromFileName(e){for(let t of s)if(e.includes(t))return t.slice(1,-1);return null}const l=[/\/dev\.js$/,/\/dev\.mjs$/,/__DEV__/,/hot-reload/,/hmr-coordinator/,/hmr-error-overlay/,/solid-refresh/];export function extractChunks(e){let t=[];for(let[n,r]of Object.entries(e)){if(r.type!==`chunk`)continue;let e=r.fileName??n,i=r.code??``,a=r.moduleIds??Object.keys(r.modules??{});t.push({fileName:e,size:Buffer.byteLength(i,`utf-8`),moduleIds:a,isIsland:e.startsWith(`islands/`)||e.includes(`/islands/`),isEntry:r.isEntry??!1})}return t.sort((e,t)=>t.size-e.size)}export function findDuplicatedModules(e){let t=new Map;for(let n of e)for(let e of n.moduleIds){if(e.startsWith(`\0`))continue;let r=t.get(e)??[];r.push(n.fileName),t.set(e,r)}let n=[];for(let[e,r]of t)r.length>1&&n.push({moduleId:e,chunks:r});return n.sort((e,t)=>t.chunks.length-e.chunks.length)}export function findDevOnlyModules(e){let t=[];for(let n of e)for(let e of n.moduleIds)for(let r of l)r.test(e)&&t.push({chunkFileName:n.fileName,moduleId:e,pattern:r.source});return t}export function generateAuditReport(e,t={}){let n=t.chunkSizeThreshold??DEFAULT_CHUNK_THRESHOLD,r=e.reduce((e,t)=>e+t.size,0),a=e.filter(e=>e.isIsland).reduce((e,t)=>e+t.size,0),s=new Set(e.filter(e=>e.isIsland&&e.size>n).map(e=>e.fileName)),l=new Set;if(t.perFrameworkThresholds){let n={...DEFAULT_PER_FRAMEWORK_THRESHOLDS,...t.perFrameworkThresholds};for(let t of e){if(!t.isIsland)continue;let e=detectFrameworkFromFileName(t.fileName);if(e&&e in n){let r=n[e];t.size>r&&l.add(t.fileName)}}}let u=new Set([...s,...l]);return{chunks:e,totalJsBytes:r,islandJsBytes:a,oversizedChunks:e.filter(e=>u.has(e.fileName)),duplicatedModules:findDuplicatedModules(e)}}export function formatKiB(e){return`${(e/1024).toFixed(2)} KiB`}function f(e){return e.isIsland?` [island]`:e.isEntry?` [entry]`:`        `}function p(e,t){return e.length<=t?e:`...${e.slice(-(t-3))}`}export function formatAuditReport(e){let t=[`┌─────────────────────────────────────────────────────┐`,`│  Bundle Audit Report                                │`,`├─────────────────────────────────────────────────────┤`,`│  Total JS:    ${formatKiB(e.totalJsBytes).padStart(12)}                       │`,`│  Island JS:   ${formatKiB(e.islandJsBytes).padStart(12)}                       │`,`│  Chunks:      ${String(e.chunks.length).padStart(12)}                       │`,`├─────────────────────────────────────────────────────┤`,`│  Chunks by size:                                    │`];for(let n of e.chunks){let e=f(n),r=p(n.fileName,32);t.push(`│  ${e} ${r.padEnd(32)} ${formatKiB(n.size).padStart(10)} │`)}if(e.oversizedChunks.length>0){t.push(`├─────────────────────────────────────────────────────┤`),t.push(`│  Oversized island chunks:                           │`);for(let n of e.oversizedChunks)t.push(`│    ${n.fileName.padEnd(38)} ${formatKiB(n.size).padStart(10)} │`)}if(e.duplicatedModules.length>0){t.push(`├─────────────────────────────────────────────────────┤`),t.push(`│  Duplicated modules: ${e.duplicatedModules.length}                            │`);for(let n of e.duplicatedModules.slice(0,5)){let e=p(n.moduleId,40);t.push(`│    ${e.padEnd(40)} x${n.chunks.length}        │`)}e.duplicatedModules.length>5&&t.push(`│    ... and ${e.duplicatedModules.length-5} more                              │`)}return t.push(`└─────────────────────────────────────────────────────┘`),t.join(`
+`)}export function auditBuildConfig(e){let t=[],n=[],r=e.build?.minify??`esbuild`,i=r!==!1;i?n.push(`Minification enabled: ${r}`):t.push(`build.minify is disabled — production builds should be minified`);let a=e.build?.target??`modules`,o=a!==`es5`&&a!==`es3`;o?n.push(`Modern build target: ${JSON.stringify(a)}`):t.push(`build.target is "${a}" — consider "es2020" or higher for smaller output`);let s=e.define??{},c=`process.env.NODE_ENV`in s||`__DEV__`in s||`__PROD__`in s;c?n.push(`process.env.NODE_ENV / __DEV__ / __PROD__ defined for dead code elimination`):t.push(`No process.env.NODE_ENV define — dev-only code may leak into production`);let l=e.build?.rollupOptions?.treeshake!=null;return l?n.push(`Custom treeshake.moduleSideEffects configured`):t.push(`No custom treeshake config — solid-js may not be fully tree-shaken`),{hasMinify:i,minifyValue:r,hasModernTarget:o,targetValue:a,hasNodeEnvDefine:c,hasTreeshakeConfig:l,issues:t,optimizations:n}}export function bundleAuditPlugin(t={}){let{chunkSizeThreshold:a=DEFAULT_CHUNK_THRESHOLD,totalSizeThreshold:o=20480,logReport:s=!0,warnOnOversized:l=!0,perFrameworkThresholds:d,benchmarkBaseline:f,regressionThreshold:p}=t,h=!1;return{name:`avalon:bundle-audit`,enforce:`post`,config(e,{command:t}){h=t===`build`},configResolved(e){if(h&&s){let t=e.build,n=t?.rollupOptions,r=auditBuildConfig({build:{minify:t?.minify,target:t?.target,rollupOptions:{treeshake:n?.treeshake}},define:e.define});if(r.issues.length>0)for(let e of r.issues)console.warn(`⚠️  [bundle-audit] ${e}`)}},generateBundle(t,i){if(!h)return;let m=extractChunks(i),g=generateAuditReport(m,{chunkSizeThreshold:a,totalSizeThreshold:o,perFrameworkThresholds:d});if(s&&console.log(formatAuditReport(g)),l&&g.oversizedChunks.length>0)for(let e of g.oversizedChunks)this.warn(`Island chunk "${e.fileName}" is ${formatKiB(e.size)} (threshold: ${formatKiB(a)})`);l&&g.totalJsBytes>o&&this.warn(`Total JS size ${formatKiB(g.totalJsBytes)} exceeds threshold of ${formatKiB(o)}`);let _=findDevOnlyModules(m);if(_.length>0)for(let e of _)this.warn(`Dev-only module "${e.moduleId}" found in chunk "${e.chunkFileName}"`);if(f)try{let t=e(f,`utf-8`),i=BenchmarkBaselineSchema.parse(JSON.parse(t)),{results:a,hasRegression:o}=compareBenchmarkBaseline(g.chunks.filter(e=>e.isIsland).map(e=>({island:e.fileName,size:e.size,framework:detectFrameworkFromFileName(e.fileName)??`unknown`})),i,p);for(let e of a){let t=e.baselineSize==null?`N/A`:formatKiB(e.baselineSize),n=e.baselineSize==null?`new`:`${e.deltaBytes>0?`+`:``}${e.deltaBytes}B (${e.deltaPercent.toFixed(1)}%)`;console.log(`📊 [benchmark] ${e.island}: ${formatKiB(e.currentSize)} (baseline: ${t}, delta: ${n})`)}o&&this.error(`Bundle size regression detected — one or more islands exceed the baseline by more than the allowed threshold`)}catch(e){if(e.code===`ENOENT`)this.warn(`Benchmark baseline file not found: ${f}`);else throw e}}}}

package/dist/src/build/island-client-bundler.d.ts

@@ -11,8 +11,9 @@
  */
 import type { Plugin } from "vite";
 import type { AvalonNitroConfig } from "../nitro/config.ts";
+import type { TreeshakeConfig } from "../post-build/isolated-island-builder.ts";
 import type { ResolvedAvalonConfig } from "../vite-plugin/types.ts";
 /**
  * Creates a Vite plugin that emits island components as separate client chunks.
  */
-export declare function islandClientBundlerPlugin(config: ResolvedAvalonConfig, _nitroConfig?: AvalonNitroConfig): Plugin;
+export declare function islandClientBundlerPlugin(config: ResolvedAvalonConfig, _nitroConfig?: AvalonNitroConfig, treeshakeOverrides?: Partial<TreeshakeConfig>): Plugin;

package/dist/src/build/island-client-bundler.js

@@ -1,4 +1,4 @@
-import{existsSync as e,readdirSync as t,readFileSync as n,statSync as r}from"node:fs";import{dirname as i,relative as a,resolve as o}from"node:path";export function islandClientBundlerPlugin(e,t){let n=process.cwd(),r=new Map,i=!1,a=c(e,n);for(let e of a)d(e,n,r);let o=`\0avalon-island-entry:`,s=!1,l=[],u={},f=`dist`;return{name:`avalon:island-client-bundler`,enforce:`pre`,configResolved(e){s=e.command===`serve`,i=e.command===`build`,l=e.resolve?.alias??[],u=e.define??{},f=e.build?.outDir??`dist`},resolveId(e){return e.startsWith(o)?e:null},load(e){if(!e.startsWith(o))return null;let t=e.slice(21),n=JSON.stringify(t);if(t.includes(`.qwik.`))return i?[`export * from ${n};`,`export { _hW } from "@builder.io/qwik";`].join(`
+import{existsSync as e,readdirSync as t,readFileSync as n,statSync as r}from"node:fs";import{dirname as i,relative as a,resolve as o}from"node:path";export function islandClientBundlerPlugin(e,t,n){let r=process.cwd(),i=new Map,a=!1,o=c(e,r);for(let e of o)d(e,r,i);let s=`\0avalon-island-entry:`,l=!1,u=[],f={},p=`dist`;return{name:`avalon:island-client-bundler`,enforce:`pre`,configResolved(e){l=e.command===`serve`,a=e.command===`build`,u=e.resolve?.alias??[],f=e.define??{},p=e.build?.outDir??`dist`},resolveId(e){return e.startsWith(s)?e:null},load(e){if(!e.startsWith(s))return null;let t=e.slice(21),n=JSON.stringify(t);if(t.includes(`.qwik.`))return a?[`export * from ${n};`,`export { _hW } from "@builder.io/qwik";`].join(`
 `):[`export * from ${n};`,`export { _hW } from "@builder.io/qwik";`,`import __C from ${n};`,`export default __C;`,`if(typeof globalThis<"u")globalThis.__avalonIsland=__C;`].join(`
-`);let r=t.includes(`.lit.`),a=t.includes(`.solid.`),s=t.includes(`.preact.`),c=t.includes(`.react.`),l=t.includes(`.vue.`),u=t.includes(`.svelte.`),d=[];if(r&&i&&d.push(`import "@useavalon/lit/client";`),d.push(`import __C from ${n};`,`var Component = __C;`,`export { Component as default, Component };`,`if(typeof globalThis<"u")globalThis.__avalonIsland=Component;`),i){let e={solid:`@useavalon/solid/client`,preact:`@useavalon/preact/client`,react:`@useavalon/react/client`,vue:`@useavalon/vue/client`,svelte:`@useavalon/svelte/client`,lit:`@useavalon/lit/client`},t=a?`solid`:s?`preact`:c?`react`:l?`vue`:u?`svelte`:r?`lit`:null;t&&e[t]?d.push(`export { hydrate as __hydrateIsland } from ${JSON.stringify(e[t])};`):d.push(`export { loadIntegrationModule } from "virtual:avalon/integration-loader";`)}return d.join(`
-`)},async buildStart(){if(s)return;let t=this.environment;if(!(t&&t.name!==`client`)&&r.size>0){for(let[,e]of r)this.emitFile({type:`chunk`,id:o+e.filePath,fileName:`islands/${e.bundleKey}.js`,preserveSignature:`exports-only`});e.verbose&&console.log(`🏝️  Emitting ${r.size} island client bundles`)}},async closeBundle(){if(s||!i||r.size===0||globalThis.__avalonIslandsRebuilt)return;globalThis.__avalonIslandsRebuilt=!0;let{buildIsolatedIslands:e}=await import(`../post-build/isolated-island-builder.js`),t=new Map;for(let[e,n]of r){let r=n.filePath.includes(`.solid.`)?`solid`:n.filePath.includes(`.preact.`)?`preact`:n.filePath.includes(`.react.`)?`react`:n.filePath.includes(`.vue.`)||n.filePath.endsWith(`.vue`)?`vue`:n.filePath.includes(`.svelte.`)||n.filePath.endsWith(`.svelte`)?`svelte`:n.filePath.includes(`.lit.`)?`lit`:n.filePath.includes(`.qwik.`)?`qwik`:`preact`;t.set(e,{...n,framework:r})}await e(n,f,t,l,u)}}}function c(n,r){let i=[];if(n.pagesDir){let t=o(r,n.pagesDir);e(t)&&i.push(t)}if(n.layoutsDir){let t=o(r,n.layoutsDir);e(t)&&i.push(t)}if(n.modules){let a=o(r,n.modules.dir);if(e(a))try{for(let n of t(a,{withFileTypes:!0}))if(n.isDirectory())for(let t of[`pages`,`layouts`,`components`]){let r=o(a,n.name,t);e(r)&&i.push(r)}}catch{}}return i}const l=[`.qwik.`];function u(e){return l.some(t=>e.includes(t))}function d(e,r,i){let a;try{a=t(e,{withFileTypes:!0})}catch{return}for(let t of a){let a=o(e,t.name);if(t.isDirectory()){d(a,r,i);continue}if(/\.(tsx?|jsx?|mdx?)$/.test(t.name))try{let e=n(a,`utf-8`),t=e.includes(`island=`)||e.includes(`island `),o=/import\s+\w+\s+from\s+['"][^'"]*\.qwik\.[^'"]*['"]/m.test(e);if(!t&&!o)continue;f(e,a,r,i)}catch{}}}function f(e,t,n,r){let i=/<([A-Z]\w*)\s+[^>]*\bisland\b/g,o=new Set,s=null;for(s=i.exec(e);s!==null;s=i.exec(e))o.add(s[1]);let c=/import\s+(\w+)\s+from\s+['"]([^'"]+)['"]/g,l=new Set,d=[];for(s=c.exec(e);s!==null;s=c.exec(e))d.push([s[1],s[2]]),u(s[2])&&RegExp(`<${s[1]}[\\s/>]`).test(e)&&l.add(s[1]);if(!(o.size===0&&l.size===0))for(let[e,i]of d){if(!o.has(e)&&!l.has(e))continue;let s=p(i,t,n);if(!s)continue;let c=a(n,s).replaceAll(`\\`,`/`).replace(/\.(tsx?|jsx?)$/,``);r.has(s)||r.set(s,{filePath:s,bundleKey:c})}}function p(t,n,a){let s;if(t.startsWith(`@shared/`))s=o(a,`app/shared`,t.slice(8));else if(t.startsWith(`@modules/`))s=o(a,`app/modules`,t.slice(9));else if(t.startsWith(`@/`))s=o(a,`app`,t.slice(2));else if(t.startsWith(`.`))s=o(i(n),t);else return null;if(e(s)&&r(s).isFile())return s;for(let t of[`.tsx`,`.ts`,`.jsx`,`.js`,`.vue`,`.svelte`])if(e(s+t))return s+t;return null}
+`);let r=t.includes(`.lit.`),i=t.includes(`.solid.`),o=t.includes(`.preact.`),c=t.includes(`.react.`),l=t.includes(`.vue.`),u=t.includes(`.svelte.`),d=[];if(r&&a&&d.push(`import "@useavalon/lit/client";`),d.push(`import __C from ${n};`,`var Component = __C;`,`export { Component as default, Component };`,`if(typeof globalThis<"u")globalThis.__avalonIsland=Component;`),a){let e={solid:`@useavalon/solid/client`,preact:`@useavalon/preact/client`,react:`@useavalon/react/client`,vue:`@useavalon/vue/client`,svelte:`@useavalon/svelte/client`,lit:`@useavalon/lit/client`},t=i?`solid`:o?`preact`:c?`react`:l?`vue`:u?`svelte`:r?`lit`:null;t&&e[t]?d.push(`export { hydrate as __hydrateIsland } from ${JSON.stringify(e[t])};`):d.push(`export { loadIntegrationModule } from "virtual:avalon/integration-loader";`)}return d.join(`
+`)},async buildStart(){if(l)return;let t=this.environment;if(!(t&&t.name!==`client`)&&i.size>0){for(let[,e]of i)this.emitFile({type:`chunk`,id:s+e.filePath,fileName:`islands/${e.bundleKey}.js`,preserveSignature:`exports-only`});e.verbose&&console.log(`🏝️  Emitting ${i.size} island client bundles`)}},async closeBundle(){if(l||!a||i.size===0||globalThis.__avalonIslandsRebuilt)return;globalThis.__avalonIslandsRebuilt=!0;let{buildIsolatedIslands:e}=await import(`../post-build/isolated-island-builder.js`),t=new Map;for(let[e,n]of i){let r=n.filePath.includes(`.solid.`)?`solid`:n.filePath.includes(`.preact.`)?`preact`:n.filePath.includes(`.react.`)?`react`:n.filePath.includes(`.vue.`)||n.filePath.endsWith(`.vue`)?`vue`:n.filePath.includes(`.svelte.`)||n.filePath.endsWith(`.svelte`)?`svelte`:n.filePath.includes(`.lit.`)?`lit`:n.filePath.includes(`.qwik.`)?`qwik`:`preact`;t.set(e,{...n,framework:r})}await e(r,p,t,u,f,n?{treeshake:n}:void 0)}}}function c(n,r){let i=[];if(n.pagesDir){let t=o(r,n.pagesDir);e(t)&&i.push(t)}if(n.layoutsDir){let t=o(r,n.layoutsDir);e(t)&&i.push(t)}if(n.modules){let a=o(r,n.modules.dir);if(e(a))try{for(let n of t(a,{withFileTypes:!0}))if(n.isDirectory())for(let t of[`pages`,`layouts`,`components`]){let r=o(a,n.name,t);e(r)&&i.push(r)}}catch{}}return i}const l=[`.qwik.`];function u(e){return l.some(t=>e.includes(t))}function d(e,r,i){let a;try{a=t(e,{withFileTypes:!0})}catch{return}for(let t of a){let a=o(e,t.name);if(t.isDirectory()){d(a,r,i);continue}if(/\.(tsx?|jsx?|mdx?)$/.test(t.name))try{let e=n(a,`utf-8`),t=e.includes(`island=`)||e.includes(`island `),o=/import\s+\w+\s+from\s+['"][^'"]*\.qwik\.[^'"]*['"]/m.test(e);if(!t&&!o)continue;f(e,a,r,i)}catch{}}}function f(e,t,n,r){let i=/<([A-Z]\w*)\s+[^>]*\bisland\b/g,o=new Set,s=null;for(s=i.exec(e);s!==null;s=i.exec(e))o.add(s[1]);let c=/import\s+(\w+)\s+from\s+['"]([^'"]+)['"]/g,l=new Set,d=[];for(s=c.exec(e);s!==null;s=c.exec(e))d.push([s[1],s[2]]),u(s[2])&&RegExp(`<${s[1]}[\\s/>]`).test(e)&&l.add(s[1]);if(!(o.size===0&&l.size===0))for(let[e,i]of d){if(!o.has(e)&&!l.has(e))continue;let s=p(i,t,n);if(!s)continue;let c=a(n,s).replaceAll(`\\`,`/`).replace(/\.(tsx?|jsx?)$/,``);r.has(s)||r.set(s,{filePath:s,bundleKey:c})}}function p(t,n,a){let s;if(t.startsWith(`@shared/`))s=o(a,`app/shared`,t.slice(8));else if(t.startsWith(`@modules/`))s=o(a,`app/modules`,t.slice(9));else if(t.startsWith(`@/`))s=o(a,`app`,t.slice(2));else if(t.startsWith(`.`))s=o(i(n),t);else return null;if(e(s)&&r(s).isFile())return s;for(let t of[`.tsx`,`.ts`,`.jsx`,`.js`,`.vue`,`.svelte`])if(e(s+t))return s+t;return null}

package/dist/src/post-build/isolated-island-builder.d.ts

@@ -1,29 +1,67 @@
 /**
  * Isolated Island Builder
  *
- * Builds each island as a separate Vite build with fresh framework plugins.
+ * Builds each island as a separate tsdown build with fresh framework unplugins.
  * This produces self-contained island files with the framework runtime inlined
  * and tree-shaken — matching Astro's approach.
  *
  * Each build:
- * 1. Loads framework plugins fresh (vite-plugin-solid, @vitejs/plugin-vue, etc.)
+ * 1. Loads framework unplugins fresh (unplugin-solid, unplugin-vue, etc.)
  * 2. Compiles from source (.tsx/.vue/.svelte)
- * 3. Outputs a single file with codeSplitting: false
+ * 3. Outputs a single file with format: "esm"
  * 4. Tree-shakes aggressively — only used runtime functions remain
  *
  * Runs as a post-build step after the main Vite build.
  */
-interface IslandBuildResult {
+export interface IslandBuildResult {
     island: string;
     success: boolean;
     size?: number;
     error?: string;
+    elapsedMs?: number;
 }
 interface IslandSource {
     filePath: string;
     bundleKey: string;
     framework: string;
 }
+/** Tree-shaking configuration for isolated island builds */
+export interface TreeshakeConfig {
+    annotations: boolean;
+    moduleSideEffects: boolean;
+    propertyReadSideEffects: false | "always";
+    unknownGlobalSideEffects: boolean;
+    manualPureFunctions: string[];
+}
+/** Default tree-shaking config with aggressive settings and Solid runtime pure functions */
+export declare const DEFAULT_TREESHAKE_CONFIG: TreeshakeConfig;
+/**
+ * Deep-merge treeshake overrides into defaults.
+ * Scalar fields from overrides replace defaults.
+ * `manualPureFunctions` is concatenated (not replaced).
+ */
+export declare function mergeTreeshakeConfig(defaults: TreeshakeConfig, overrides: Partial<TreeshakeConfig>): TreeshakeConfig;
+/** Options for the isolated island builder */
+export interface IsolatedIslandBuilderOptions {
+    treeshake?: Partial<TreeshakeConfig>;
+}
+export declare function loadFrameworkUnplugin(framework: string): Promise<any | null>;
+/**
+ * Generate the wrapper code for an island.
+ *
+ * For hydration frameworks (solid, preact, react, vue, svelte) the output is exactly 5 lines:
+ *   1. Default import of the component
+ *   2. `var Component = __C;`
+ *   3. Named re-export of `Component` and `default`
+ *   4. `globalThis.__avalonIsland` assignment
+ *   5. `__hydrateIsland` re-export from the framework adapter
+ *
+ * Qwik uses a different export shape (re-export all + `_hW`).
+ * Lit islands are skipped by the isolated builder and never reach this function.
+ */
+export declare function generateWrapperCode(filePath: string, framework: string): string;
+/** Generate the integration loader module for a specific framework */
+export declare function generateIntegrationLoaderForFramework(framework: string): string;
 /**
  * Build all islands in isolation.
  *
@@ -32,6 +70,7 @@ interface IslandSource {
  * @param islands - Map of discovered islands (filePath → bundleKey)
  * @param resolveAliases - Resolve aliases from the main Vite config
  * @param defineValues - Define replacements from the main Vite config
+ * @param options - Optional builder configuration (treeshake overrides, etc.)
  */
-export declare function buildIsolatedIslands(cwd: string, distDir: string, islands: Map<string, IslandSource>, resolveAliases: any[], defineValues: Record<string, unknown>): Promise<IslandBuildResult[]>;
+export declare function buildIsolatedIslands(cwd: string, distDir: string, islands: Map<string, IslandSource>, resolveAliases: any[], defineValues: Record<string, unknown>, options?: IsolatedIslandBuilderOptions): Promise<IslandBuildResult[]>;
 export {};

package/dist/src/post-build/isolated-island-builder.js

@@ -1,4 +1,3 @@
-import{existsSync as e,statSync as t}from"node:fs";import{resolve as n}from"node:path";function r(e,t){let n=JSON.stringify(e);if(t===`qwik`)return[`export * from ${n};`,`export { _hW } from "@builder.io/qwik";`].join(`
-`);let r=[];t===`lit`&&r.push(`import "@useavalon/lit/client";`),r.push(`import __C from ${n};`,`var Component = __C;`,`export { Component as default, Component };`,`if(typeof globalThis<"u")globalThis.__avalonIsland=Component;`);let i={solid:`@useavalon/solid/client`,preact:`@useavalon/preact/client`,react:`@useavalon/react/client`,vue:`@useavalon/vue/client`,svelte:`@useavalon/svelte/client`,lit:`@useavalon/lit/client`};return i[t]&&r.push(`export { hydrate as __hydrateIsland } from ${JSON.stringify(i[t])};`),r.join(`
-`)}async function i(e,t){let n=[],{resolve:r}=await import(`node:path`),{existsSync:i}=await import(`node:fs`),{pathToFileURL:a}=await import(`node:url`),o={solid:{pkg:`vite-plugin-solid`,esmEntry:`dist/esm/index.mjs`},vue:{pkg:`@vitejs/plugin-vue`,esmEntry:`dist/index.mjs`},svelte:{pkg:`@sveltejs/vite-plugin-svelte`,esmEntry:`src/index.js`}}[e];if(!o)return n;try{let s=null,c=t;for(let e=0;e<8;e++){let e=r(c,`node_modules`,o.pkg,o.esmEntry);if(i(e)){s=e;break}for(let e of[`solid`,`vue`,`svelte`,`preact`,`react`,`lit`]){let t=r(c,`packages`,`integrations`,e,`node_modules`,o.pkg,o.esmEntry);if(i(t)){s=t;break}}if(s)break;c=r(c,`..`)}if(!s)throw Error(`Cannot find package '${o.pkg}'`);let l=await import(a(s).href);switch(e){case`solid`:{let e=l.default??l;n.push(e({ssr:!1,hot:!1}));break}case`vue`:{let e=l.default??l;n.push(e());break}case`svelte`:{let e=l.svelte??l.default;n.push(e({compilerOptions:{hydratable:!0}}));break}}}catch(t){console.warn(`  ⚠ Could not load ${e} plugin: ${t instanceof Error?t.message:t}`)}return n}function a(e){let t={solid:`@useavalon/solid/client`,preact:`@useavalon/preact/client`,react:`@useavalon/react/client`,vue:`@useavalon/vue/client`,svelte:`@useavalon/svelte/client`,lit:`@useavalon/lit/client`}[e];return t?[`import { hydrate } from ${JSON.stringify(t)};`,`export async function loadIntegrationModule() { return { hydrate }; }`].join(`
-`):`export async function loadIntegrationModule() { return {}; }`}async function o(e){let{createRequire:t}=await import(`node:module`),n=t(`${e}/package.json`),r=e=>{try{return n.resolve(e).replace(/\.js$/,`.mjs`)}catch{return null}},i={preact:r(`preact`),"preact/hooks":r(`preact/hooks`),"preact/compat":r(`preact/compat`),"preact/compat/client":r(`preact/compat/client`),"preact/compat/server":r(`preact/compat/server`),"preact/jsx-runtime":r(`preact/jsx-runtime`),react:r(`preact/compat`),"react/jsx-runtime":r(`preact/jsx-runtime`),"react/jsx-dev-runtime":r(`preact/jsx-runtime`),"react-dom":r(`preact/compat`),"react-dom/client":r(`preact/compat/client`),"react-dom/server":r(`preact/compat/server`)};return{name:`avalon:isolated-preact-compat`,enforce:`pre`,resolveId(e){return i[e]||null}}}export async function buildIsolatedIslands(s,c,l,u,d){if(l.size===0)return[];let{build:f}=await import(`vite`);console.log(`🏝️  Building ${l.size} islands in isolation...`);let p=performance.now(),m=[];for(let[,p]of l){let{filePath:l,bundleKey:h,framework:g}=p,_=`islands/${h}.js`;if(g===`qwik`||g===`lit`){m.push({island:_,success:!0});continue}let v=r(l,g),y=`\0isolated-island-entry`,b=`\0virtual:avalon/integration-loader`;try{let r=await i(g,s);await f({configFile:!1,root:s,logLevel:`silent`,plugins:[{name:`avalon:isolated-island-virtual`,resolveId(e){return e===y?e:e===`virtual:avalon/integration-loader`||e===b?b:null},load(e){return e===y?v:e===b?a(g):null}},await o(s),...r],build:{write:!0,outDir:n(s,c),emptyOutDir:!1,minify:`oxc`,target:`es2020`,rollupOptions:{input:y,output:{format:`es`,entryFileNames:_},preserveEntrySignatures:`exports-only`}},resolve:{alias:u},define:{...d,__DEV__:`false`,__PROD__:`true`,"process.env.NODE_ENV":`"production"`}});let l=n(s,c,_),p=e(l)?t(l).size:0;m.push({island:_,success:!0,size:p}),console.log(`  ✅ ${h} (${g}): ${(p/1024).toFixed(1)} KiB`)}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`  ❌ ${h} (${g}): ${t}`),m.push({island:_,success:!1,error:t})}}let h=((performance.now()-p)/1e3).toFixed(1),g=m.filter(e=>e.success).length,_=m.filter(e=>!e.success).length;return console.log(`🏝️  Done in ${h}s: ${g} built${_?`, ${_} failed`:``}`),m}
+import{existsSync as e,statSync as t}from"node:fs";import{resolve as n}from"node:path";import{build as r}from"tsdown";export const DEFAULT_TREESHAKE_CONFIG={annotations:!0,moduleSideEffects:!1,propertyReadSideEffects:!1,unknownGlobalSideEffects:!1,manualPureFunctions:[`createSignal`,`createEffect`,`createMemo`,`createComponent`,`template`,`insert`,`delegateEvents`,`setAttribute`,`effect`,`memo`,`spread`,`mergeProps`,`splitProps`,`className`,`classList`,`style`,`addEventListener`]};export function mergeTreeshakeConfig(e,t){return{annotations:t.annotations??e.annotations,moduleSideEffects:t.moduleSideEffects??e.moduleSideEffects,propertyReadSideEffects:t.propertyReadSideEffects??e.propertyReadSideEffects,unknownGlobalSideEffects:t.unknownGlobalSideEffects??e.unknownGlobalSideEffects,manualPureFunctions:[...e.manualPureFunctions,...t.manualPureFunctions??[]]}}const o=new Set([`solid`,`vue`,`svelte`]);export async function loadFrameworkUnplugin(e){switch(e){case`solid`:try{return(await import(`unplugin-solid`)).default.rolldown({ssr:!1})}catch(e){let t=e instanceof Error?e.message:String(e);return console.warn(`⚠ Could not load solid unplugin: ${t}`),null}case`vue`:try{return(await import(`unplugin-vue`)).default.rolldown()}catch(e){let t=e instanceof Error?e.message:String(e);return console.warn(`⚠ Could not load vue unplugin: ${t}`),null}case`svelte`:try{return(await import(`rollup-plugin-svelte`)).default()}catch(e){let t=e instanceof Error?e.message:String(e);return console.warn(`⚠ Could not load svelte plugin: ${t}`),null}default:return null}}const s={solid:`@useavalon/solid/client`,preact:`@useavalon/preact/client`,react:`@useavalon/react/client`,vue:`@useavalon/vue/client`,svelte:`@useavalon/svelte/client`};export function generateWrapperCode(e,t){let n=JSON.stringify(e);if(t===`qwik`)return[`export * from ${n};`,`export { _hW } from "@builder.io/qwik";`].join(`
+`);let r=s[t],i=[`import __C from ${n};`,`var Component = __C;`,`export { Component as default, Component };`,`if(typeof globalThis<"u")globalThis.__avalonIsland=Component;`];return r&&i.push(`export { hydrate as __hydrateIsland } from ${JSON.stringify(r)};`),i.join(`
+`)}export function generateIntegrationLoaderForFramework(e){let t=s[e];return t?`export { hydrate } from ${JSON.stringify(t)};`:`export {};`}export async function buildIsolatedIslands(s,l,u,d,f,p){if(u.size===0)return[];console.log(`🏝️  Building ${u.size} islands in isolation...`);let m=performance.now(),h=p?.treeshake?mergeTreeshakeConfig(DEFAULT_TREESHAKE_CONFIG,p.treeshake):DEFAULT_TREESHAKE_CONFIG,g=[];for(let[,i]of u){let{filePath:a,bundleKey:u,framework:d}=i,f=`islands/${u}.js`;if(d===`qwik`||d===`lit`){g.push({island:f,success:!0});continue}let p=generateWrapperCode(a,d),m=`\0isolated-island-entry`,_=`\0virtual:avalon/integration-loader`;try{let i=await loadFrameworkUnplugin(d);if(o.has(d)&&i==null){console.warn(`  ⚠ Skipping ${u}: ${d} unplugin is not installed`),g.push({island:f,success:!0});continue}let a={name:`avalon:isolated-island-virtual`,resolveId(e){return e===m?e:e===`virtual:avalon/integration-loader`||e===_?_:null},load(e){return e===m?p:e===_?generateIntegrationLoaderForFramework(d):null}},c={name:`avalon:css-stub`,resolveId(e){return e.endsWith(`.css`)||e.endsWith(`.scss`)||e.endsWith(`.less`)?{id:`\0css-stub`,external:!1}:null},load(e){return e===`\0css-stub`?`export default '';`:null}},v=performance.now();await r({entry:{[u]:m},outDir:n(s,l,`islands`),format:`esm`,target:`es2020`,minify:!0,clean:!1,dts:!1,treeshake:!0,report:!1,define:{__DEV__:`false`,__PROD__:`true`,"process.env.NODE_ENV":`"production"`},inputOptions:e=>{e.treeshake=h;let t=d===`preact`?{jsx:`react-jsx`,jsxImportSource:`preact`}:d===`react`?{jsx:`react-jsx`}:{};return Object.keys(t).length>0&&(e.transform={...e.transform,...t}),e},plugins:[c,a,i].filter(Boolean)});let y=performance.now()-v,b=n(s,l,f),x=e(b)?t(b).size:0;g.push({island:f,success:!0,size:x,elapsedMs:y}),console.log(`  ✅ ${u} (${d}): ${(x/1024).toFixed(1)} KiB`),y>2e3&&console.warn(`  ⚠ ${u} (${d}): build took ${y.toFixed(0)}ms (>2s)`)}catch(e){let t=e instanceof Error?e.message:String(e);console.error(`  ❌ ${u} (${d}): ${t}`),g.push({island:f,success:!1,error:t})}}let _=((performance.now()-m)/1e3).toFixed(1),v=g.filter(e=>e.success).length,y=g.filter(e=>!e.success).length;return console.log(`🏝️  Done in ${_}s: ${v} built${y?`, ${y} failed`:``}`),g}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@useavalon/avalon",
-	"version": "0.1.66",
+	"version": "0.1.67",
 	"description": "Multi-framework islands architecture for the modern web",
 	"license": "MIT",
 	"type": "module",
@@ -127,7 +127,10 @@
 		"vite": "^8.0.0",
 		"nitro": "^3.0.260311-beta",
 		"vite-imagetools": "^7.0.0",
-		"rehype-highlight": "^7.0.0"
+		"rehype-highlight": "^7.0.0",
+		"unplugin-solid": "^1.0.0",
+		"unplugin-vue": "^7.0.0",
+		"rollup-plugin-svelte": "^7.0.0"
 	},
 	"peerDependenciesMeta": {
 		"nitro": {
@@ -141,11 +144,21 @@
 		},
 		"rehype-highlight": {
 			"optional": true
+		},
+		"unplugin-solid": {
+			"optional": true
+		},
+		"unplugin-vue": {
+			"optional": true
+		},
+		"rollup-plugin-svelte": {
+			"optional": true
 		}
 	},
 	"dependencies": {
 		"@useavalon/core": "^0.1.7",
 		"@mdx-js/rollup": "^3.0.0",
+		"tsdown": "^0.21.7",
 		"h3": "^2.0.1-rc.16",
 		"marked": "^17.0.4",
 		"oxc-transform": "^0.117.0",