@useavalon/avalon 0.1.44 → 0.1.47

package/dist/src/nitro/config.d.ts

@@ -140,6 +140,43 @@ export interface AvalonNitroConfig {
         brotli?: boolean;
         zstd?: boolean;
     };
+    /**
+     * Prerender configuration for static site generation (SSG).
+     *
+     * Nitro will fetch each listed route at build time using the SSR handler
+     * and write the resulting HTML to the public output directory. These pages
+     * are then served as static files from the CDN — zero function invocations.
+     *
+     * Islands on prerendered pages still hydrate normally on the client.
+     *
+     * @example
+     * ```ts
+     * prerender: {
+     *   routes: ['/', '/docs', '/blog'],
+     *   crawlLinks: true,
+     * }
+     * ```
+     */
+    prerender?: {
+        /** Explicit routes to prerender at build time */
+        routes?: string[];
+        /** Crawl `<a>` links in prerendered pages to discover more routes */
+        crawlLinks?: boolean;
+        /** Number of concurrent prerender requests */
+        concurrency?: number;
+        /** Delay in ms between prerender requests */
+        interval?: number;
+        /** Fail the build if a prerender route errors */
+        failOnError?: boolean;
+        /** Routes to ignore (strings, RegExps, or filter functions) */
+        ignore?: Array<string | RegExp | ((path: string) => undefined | null | boolean)>;
+        /** Number of retry attempts per route @default 3 */
+        retry?: number;
+        /** Delay between retries in ms @default 500 */
+        retryDelay?: number;
+        /** Write `/about` as `/about/index.html` @default true */
+        autoSubfolderIndex?: boolean;
+    };
 }
 /**
  * Nitro configuration output structure
@@ -191,6 +228,8 @@ export interface NitroConfigOutput {
     }>;
     /** Static assets configuration */
     staticAssets?: StaticAssetsConfig;
+    /** Prerender configuration for SSG */
+    prerender?: AvalonNitroConfig['prerender'];
 }
 /**
  * Avalon-specific runtime configuration stored in Nitro's runtimeConfig

package/dist/src/nitro/config.js

@@ -1 +1 @@
-export const DEFAULT_STATIC_ASSETS_CONFIG={publicDir:`public`,buildDir:`dist`,compression:!0,cacheControl:`public, max-age=31536000, immutable`,mutableCacheControl:`public, max-age=0, must-revalidate`,headers:{}};export const VALID_V3_PRESETS=[`node_server`,`node_middleware`,`vercel`,`cloudflare_module`,`cloudflare_pages`,`deno_deploy`,`deno_server`,`netlify`,`netlify_functions`,`netlify_edge`,`aws_lambda`,`azure_swa`,`firebase_functions`,`render_com`,`static`,`browser`];export function resolvePresetName(e){if(VALID_V3_PRESETS.includes(e))return e;throw Error(`Unknown Nitro preset: "${e}". Valid presets: ${VALID_V3_PRESETS.join(`, `)}`)}export const DEFAULT_NITRO_CONFIG={preset:`node_server`,serverDir:`server`,streaming:!0};export function createNitroConfig(t,i){let a=t.pagesDir??i.pagesDir,o=i.layoutsDir,s={streaming:t.streaming??DEFAULT_NITRO_CONFIG.streaming,pagesDir:a,layoutsDir:o};if(t.runtimeConfig&&`nitro`in t.runtimeConfig)throw Error(`The "nitro" key in runtimeConfig is reserved by Nitro v3 and cannot be used.`);let c={avalon:s,...t.runtimeConfig},l={...DEFAULT_STATIC_ASSETS_CONFIG,...t.staticAssets},u=mergeRouteRules(createDefaultStaticAssetRouteRules(l),t.routeRules??{}),d=[{dir:l.publicDir??DEFAULT_STATIC_ASSETS_CONFIG.publicDir,baseURL:`/`,maxAge:0}],f=t.renderer===!1?!1:t.renderer?{...t.renderer}:void 0;return{preset:resolvePresetName(process.env.NITRO_PRESET??t.preset??DEFAULT_NITRO_CONFIG.preset),serverDir:t.serverDir??DEFAULT_NITRO_CONFIG.serverDir,routeRules:u,runtimeConfig:c,publicRuntimeConfig:t.publicRuntimeConfig,renderer:f,compatibilityDate:t.compatibilityDate,traceDeps:t.traceDeps,rolldownConfig:t.rolldownConfig,serverEntry:t.serverEntry,compressPublicAssets:t.compressPublicAssets,publicAssets:d,staticAssets:l}}export function createDefaultStaticAssetRouteRules(t){let n=t.cacheControl??DEFAULT_STATIC_ASSETS_CONFIG.cacheControl,r=t.mutableCacheControl??DEFAULT_STATIC_ASSETS_CONFIG.mutableCacheControl;return{"/assets/**":{headers:{"Cache-Control":n,...t.headers}},"/islands/**":{headers:{"Cache-Control":n,...t.headers}},"/chunks/**":{headers:{"Cache-Control":n,...t.headers}},"/_nuxt/**":{headers:{"Cache-Control":n,...t.headers}},"/**/*.woff":{headers:{"Cache-Control":n,...t.headers}},"/**/*.woff2":{headers:{"Cache-Control":n,...t.headers}},"/**/*.html":{headers:{"Cache-Control":r,...t.headers}},"/favicon.ico":{headers:{"Cache-Control":`public, max-age=86400`,...t.headers}},"/**/*.css":{headers:{"Cache-Control":r,...t.headers}}}}export function isValidPreset(e){return VALID_V3_PRESETS.includes(e)}export function mergeRouteRules(e,t){let n={...e};for(let[e,r]of Object.entries(t))n[e]?n[e]={...n[e],...r,headers:{...n[e].headers,...r.headers}}:n[e]=r;return n}
+export const DEFAULT_STATIC_ASSETS_CONFIG={publicDir:`public`,buildDir:`dist`,compression:!0,cacheControl:`public, max-age=31536000, immutable`,mutableCacheControl:`public, max-age=0, must-revalidate`,headers:{}};export const VALID_V3_PRESETS=[`node_server`,`node_middleware`,`vercel`,`cloudflare_module`,`cloudflare_pages`,`deno_deploy`,`deno_server`,`netlify`,`netlify_functions`,`netlify_edge`,`aws_lambda`,`azure_swa`,`firebase_functions`,`render_com`,`static`,`browser`];export function resolvePresetName(e){if(VALID_V3_PRESETS.includes(e))return e;throw Error(`Unknown Nitro preset: "${e}". Valid presets: ${VALID_V3_PRESETS.join(`, `)}`)}export const DEFAULT_NITRO_CONFIG={preset:`node_server`,serverDir:`server`,streaming:!0};export function createNitroConfig(t,i){let a=t.pagesDir??i.pagesDir,o=i.layoutsDir,s={streaming:t.streaming??DEFAULT_NITRO_CONFIG.streaming,pagesDir:a,layoutsDir:o};if(t.runtimeConfig&&`nitro`in t.runtimeConfig)throw Error(`The "nitro" key in runtimeConfig is reserved by Nitro v3 and cannot be used.`);let c={avalon:s,...t.runtimeConfig},l={...DEFAULT_STATIC_ASSETS_CONFIG,...t.staticAssets},u=mergeRouteRules(createDefaultStaticAssetRouteRules(l),t.routeRules??{}),d=[{dir:l.publicDir??DEFAULT_STATIC_ASSETS_CONFIG.publicDir,baseURL:`/`,maxAge:0}],f=t.renderer===!1?!1:t.renderer?{...t.renderer}:void 0;return{preset:resolvePresetName(process.env.NITRO_PRESET??t.preset??DEFAULT_NITRO_CONFIG.preset),serverDir:t.serverDir??DEFAULT_NITRO_CONFIG.serverDir,routeRules:u,runtimeConfig:c,publicRuntimeConfig:t.publicRuntimeConfig,renderer:f,compatibilityDate:t.compatibilityDate,traceDeps:t.traceDeps,rolldownConfig:t.rolldownConfig,serverEntry:t.serverEntry,compressPublicAssets:t.compressPublicAssets,publicAssets:d,staticAssets:l,prerender:t.prerender}}export function createDefaultStaticAssetRouteRules(t){let n=t.cacheControl??DEFAULT_STATIC_ASSETS_CONFIG.cacheControl,r=t.mutableCacheControl??DEFAULT_STATIC_ASSETS_CONFIG.mutableCacheControl;return{"/assets/**":{headers:{"Cache-Control":n,...t.headers}},"/islands/**":{headers:{"Cache-Control":n,...t.headers}},"/chunks/**":{headers:{"Cache-Control":n,...t.headers}},"/_nuxt/**":{headers:{"Cache-Control":n,...t.headers}},"/**/*.woff":{headers:{"Cache-Control":n,...t.headers}},"/**/*.woff2":{headers:{"Cache-Control":n,...t.headers}},"/**/*.html":{headers:{"Cache-Control":r,...t.headers}},"/favicon.ico":{headers:{"Cache-Control":`public, max-age=86400`,...t.headers}},"/**/*.css":{headers:{"Cache-Control":r,...t.headers}}}}export function isValidPreset(e){return VALID_V3_PRESETS.includes(e)}export function mergeRouteRules(e,t){let n={...e};for(let[e,r]of Object.entries(t))n[e]?n[e]={...n[e],...r,headers:{...n[e].headers,...r.headers}}:n[e]=r;return n}

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

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

package/dist/src/prerender/index.js

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

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

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

package/dist/src/prerender/prerender.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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