@useavalon/avalon 0.1.46 → 0.1.48

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

@@ -1,70 +1,70 @@
-/**
- * Type declarations for Vite virtual modules
- *
- * These modules are resolved by Vite at runtime in the browser.
- * They don't exist as actual files but are provided by Vite's plugin system.
- */
-
-declare module '/@useavalon/preact/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/react/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/vue/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/svelte/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/solid/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/lit/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-declare module '/@useavalon/qwik/client' {
-	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
-	export function getHydrationScript(): string;
-}
-
-// HMR adapter virtual modules
-declare module '/@useavalon/react/client/hmr' {
-	export { reactAdapter } from '@useavalon/react/client/hmr';
-}
-
-declare module '/@useavalon/preact/client/hmr' {
-	export { preactAdapter } from '@useavalon/preact/client/hmr';
-}
-
-declare module '/@useavalon/vue/client/hmr' {
-	export { vueAdapter } from '@useavalon/vue/client/hmr';
-}
-
-declare module '/@useavalon/svelte/client/hmr' {
-	export { svelteAdapter } from '@useavalon/svelte/client/hmr';
-}
-
-declare module '/@useavalon/solid/client/hmr' {
-	export { solidAdapter } from '@useavalon/solid/client/hmr';
-}
-
-declare module '/@useavalon/lit/client/hmr' {
-	export { litAdapter } from '@useavalon/lit/client/hmr';
-}
-
-declare module '/@useavalon/qwik/client/hmr' {
-	export { qwikAdapter } from '@useavalon/qwik/client/hmr';
-}
+/**
+ * Type declarations for Vite virtual modules
+ *
+ * These modules are resolved by Vite at runtime in the browser.
+ * They don't exist as actual files but are provided by Vite's plugin system.
+ */
+
+declare module '/@useavalon/preact/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/react/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/vue/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/svelte/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/solid/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/lit/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+declare module '/@useavalon/qwik/client' {
+	export function hydrate(container: Element, component: unknown, props?: Record<string, unknown>): void;
+	export function getHydrationScript(): string;
+}
+
+// HMR adapter virtual modules
+declare module '/@useavalon/react/client/hmr' {
+	export { reactAdapter } from '@useavalon/react/client/hmr';
+}
+
+declare module '/@useavalon/preact/client/hmr' {
+	export { preactAdapter } from '@useavalon/preact/client/hmr';
+}
+
+declare module '/@useavalon/vue/client/hmr' {
+	export { vueAdapter } from '@useavalon/vue/client/hmr';
+}
+
+declare module '/@useavalon/svelte/client/hmr' {
+	export { svelteAdapter } from '@useavalon/svelte/client/hmr';
+}
+
+declare module '/@useavalon/solid/client/hmr' {
+	export { solidAdapter } from '@useavalon/solid/client/hmr';
+}
+
+declare module '/@useavalon/lit/client/hmr' {
+	export { litAdapter } from '@useavalon/lit/client/hmr';
+}
+
+declare module '/@useavalon/qwik/client/hmr' {
+	export { qwikAdapter } from '@useavalon/qwik/client/hmr';
+}

package/dist/src/components/IslandErrorBoundary.d.ts

@@ -1,20 +1,51 @@
-import { Component, ComponentChildren, ComponentType } from 'preact';
-import type { LayoutErrorInfo } from '../types/layout.ts';
+/** @jsxImportSource preact */
+import { Component, type ComponentChildren, type ComponentType } from 'preact';
+import type { LayoutErrorInfo } from '../schemas/layout.ts';
+/**
+ * Props for {@link IslandErrorBoundary}.
+ *
+ * @example
+ * ```tsx
+ * <IslandErrorBoundary
+ *   islandId="counter"
+ *   isolateError
+ *   onError={(err, info) => console.error(info.errorBoundary, err)}
+ *   fallback={(err, id) => <p>Island "{id}" failed: {err.message}</p>}
+ * >
+ *   <Counter />
+ * </IslandErrorBoundary>
+ * ```
+ */
 export interface IslandErrorBoundaryProps {
+    /** The content to render inside the error boundary. */
     children: ComponentChildren;
+    /** Unique identifier for the island — used in error reports and DOM attributes. */
     islandId: string;
+    /** Called when the island throws. Receives the error and structured error info. */
     onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
+    /** Custom fallback UI. When omitted a default error card is shown. */
     fallback?: (error: Error, islandId: string) => ComponentChildren;
+    /** When `true` (default for HOC), the error is caught and isolated. When `false`, it re-throws to parent boundaries. */
     isolateError?: boolean;
 }
-export interface IslandErrorBoundaryState {
+interface IslandErrorBoundaryState {
     hasError: boolean;
     error: Error | null;
     errorInfo: LayoutErrorInfo | null;
 }
 /**
- * Specialized error boundary for island components
- * Provides error isolation to prevent island errors from affecting the main layout
+ * Error boundary that wraps individual islands to prevent one broken island
+ * from taking down the entire page.
+ *
+ * Renders a default error card with "Reload" / "Remove" actions, or your
+ * custom `fallback` if provided. In development mode, a stack trace is shown.
+ *
+ * @example
+ * ```tsx
+ * <IslandErrorBoundary islandId="cart" isolateError>
+ *   <CartIsland />
+ * </IslandErrorBoundary>
+ * ```
  */
 export declare class IslandErrorBoundary extends Component<IslandErrorBoundaryProps, IslandErrorBoundaryState> {
     constructor(props: IslandErrorBoundaryProps);
@@ -22,16 +53,24 @@ export declare class IslandErrorBoundary extends Component<IslandErrorBoundaryPr
     componentDidCatch(error: Error, errorInfo: {
         componentStack?: string;
     }): void;
-    private handleRemoveIsland;
-    private handleReloadIsland;
-    private renderFallback;
+    private readonly handleRemoveIsland;
+    private readonly handleReloadIsland;
     render(): ComponentChildren;
 }
 /**
- * Higher-order component to wrap islands with error boundaries
+ * HOC that wraps a component with {@link IslandErrorBoundary}.
+ *
+ * @example
+ * ```tsx
+ * const SafeCounter = withIslandErrorBoundary(Counter, 'counter', {
+ *   isolateError: true,
+ *   fallback: (err) => <p>Oops: {err.message}</p>,
+ * });
+ * ```
  */
 export declare function withIslandErrorBoundary<P extends object>(WrappedComponent: ComponentType<P>, islandId: string, options?: {
     fallback?: (error: Error, islandId: string) => ComponentChildren;
     isolateError?: boolean;
     onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
 }): (props: P) => import("preact").JSX.Element;
+export {};

package/dist/src/components/IslandErrorBoundary.js

@@ -1 +1 @@
-import{Component as e}from"preact";import{jsx as t,jsxs as n}from"preact/jsx-runtime";export class IslandErrorBoundary extends e{constructor(e){super(e),this.state={hasError:!1,error:null,errorInfo:null}}static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e,t){let n={layoutPath:`island:${this.props.islandId}`,errorType:`island`,timestamp:Date.now(),componentStack:t.componentStack,errorBoundary:`IslandErrorBoundary`};if(this.setState({errorInfo:n}),this.props.onError&&this.props.onError(e,n),typeof process<`u`&&process.env?.NODE_ENV===`development`&&console.error(`Island Error [${this.props.islandId}]:`,e),!this.props.isolateError)throw e}handleRemoveIsland=()=>{let e=document.querySelector(`[data-island-id="${this.props.islandId}"]`);e&&e.remove()};handleReloadIsland=()=>{this.setState({hasError:!1,error:null,errorInfo:null})};renderFallback(){let{error:e}=this.state,{fallback:r,islandId:i}=this.props;if(r&&e)return r(e,i);let a=typeof process<`u`&&process.env?.NODE_ENV===`development`;return t(`div`,{class:`island-error-boundary`,"data-island-error":i,children:n(`div`,{class:`island-error-container`,children:[n(`div`,{class:`island-error-header`,children:[t(`span`,{class:`island-error-icon`,children:`⚠️`}),t(`span`,{class:`island-error-title`,children:`Island Error`})]}),n(`p`,{class:`island-error-message`,children:[`An error occurred in island "`,i,`". The rest of the page should work normally.`]}),n(`div`,{class:`island-error-actions`,children:[t(`button`,{onClick:this.handleReloadIsland,class:`island-reload-button`,children:`Reload Island`}),t(`button`,{onClick:this.handleRemoveIsland,class:`island-remove-button`,children:`Remove Island`})]}),a&&e&&n(`details`,{class:`island-error-details`,children:[t(`summary`,{children:`Error Details (Development)`}),n(`div`,{class:`island-error-info`,children:[n(`p`,{children:[t(`strong`,{children:`Island ID:`}),` `,i]}),n(`p`,{children:[t(`strong`,{children:`Error:`}),` `,e.message]})]}),t(`pre`,{class:`island-error-stack`,children:e.stack})]})]})})}render(){return this.state.hasError?this.renderFallback():this.props.children}}export function withIslandErrorBoundary(e,n,i){return function(a){return t(IslandErrorBoundary,{islandId:n,fallback:i?.fallback,isolateError:i?.isolateError??!0,onError:i?.onError,children:t(e,{...a})})}}
+import{Component as e}from"preact";import{jsx as t,jsxs as n}from"preact/jsx-runtime";export class IslandErrorBoundary extends e{constructor(e){super(e),this.state={hasError:!1,error:null,errorInfo:null}}static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e,t){let n={layoutPath:`island:${this.props.islandId}`,errorType:`island`,timestamp:Date.now(),componentStack:t.componentStack,errorBoundary:`IslandErrorBoundary`};if(this.setState({errorInfo:n}),this.props.onError?.(e,n),!this.props.isolateError)throw e}handleRemoveIsland=()=>{document.querySelector(`[data-island-id="${this.props.islandId}"]`)?.remove()};handleReloadIsland=()=>{this.setState({hasError:!1,error:null,errorInfo:null})};render(){if(!this.state.hasError)return this.props.children;let{error:e}=this.state,{fallback:r,islandId:i}=this.props;if(r&&e)return r(e,i);let a=typeof process<`u`&&process.env?.NODE_ENV===`development`;return t(`div`,{className:`island-error-boundary`,"data-island-error":i,children:n(`div`,{className:`island-error-container`,children:[n(`div`,{className:`island-error-header`,children:[t(`span`,{className:`island-error-icon`,children:`⚠️`}),t(`span`,{className:`island-error-title`,children:`Island Error`})]}),n(`p`,{className:`island-error-message`,children:[`An error occurred in island "`,i,`".`]}),n(`div`,{className:`island-error-actions`,children:[t(`button`,{onClick:this.handleReloadIsland,className:`island-reload-button`,children:`Reload Island`}),t(`button`,{onClick:this.handleRemoveIsland,className:`island-remove-button`,children:`Remove Island`})]}),a&&e&&n(`details`,{className:`island-error-details`,children:[t(`summary`,{children:`Error Details (Development)`}),n(`p`,{children:[t(`strong`,{children:`Island ID:`}),` `,i]}),n(`p`,{children:[t(`strong`,{children:`Error:`}),` `,e.message]}),t(`pre`,{className:`island-error-stack`,children:e.stack})]})]})})}}export function withIslandErrorBoundary(e,n,i){return function(a){return t(IslandErrorBoundary,{islandId:n,fallback:i?.fallback,isolateError:i?.isolateError??!0,onError:i?.onError,children:t(e,{...a})})}}

package/dist/src/components/LayoutErrorBoundary.d.ts

@@ -1,25 +1,90 @@
-import { Component, ComponentChildren } from 'preact';
-import type { LayoutErrorInfo, ErrorRecoveryStrategy } from '../types/layout.ts';
+/** @jsxImportSource preact */
+import { Component, type ComponentChildren } from 'preact';
+import type { LayoutErrorInfo, LayoutData } from '../schemas/layout.ts';
+/**
+ * Props for {@link LayoutErrorBoundary}.
+ *
+ * @example Basic usage
+ * ```tsx
+ * <LayoutErrorBoundary onError={(err) => logToSentry(err)}>
+ *   <DashboardLayout />
+ * </LayoutErrorBoundary>
+ * ```
+ *
+ * @example Custom fallback with retry
+ * ```tsx
+ * <LayoutErrorBoundary
+ *   fallback={(err, retry) => (
+ *     <div>
+ *       <p>Layout crashed: {err.message}</p>
+ *       <button onClick={retry}>Retry</button>
+ *     </div>
+ *   )}
+ * >
+ *   <DashboardLayout />
+ * </LayoutErrorBoundary>
+ * ```
+ *
+ * @example Data loading with async retry and cached fallback
+ * ```tsx
+ * <LayoutErrorBoundary
+ *   retryLoader={() => fetch('/api/blog').then(r => r.json())}
+ *   fallbackData={{ posts: [] }}
+ * >
+ *   <BlogLayout />
+ * </LayoutErrorBoundary>
+ * ```
+ */
 export interface LayoutErrorBoundaryProps {
+    /** The layout tree to protect. */
     children: ComponentChildren;
+    /** Custom fallback UI. Receives the error and a retry callback. */
     fallback?: (error: Error, retry: () => void) => ComponentChildren;
+    /** Called when the layout throws. */
     onError?: (error: Error, errorInfo: LayoutErrorInfo) => void;
-    recoveryStrategy?: ErrorRecoveryStrategy;
-    layoutPath?: string;
+    /** Categorises the error for structured logging. Defaults to `'component'`. */
     errorType?: 'component' | 'loader' | 'rendering' | 'island';
+    /** Async function to re-attempt data loading. Enables the async retry button (up to 3 attempts). */
+    retryLoader?: () => Promise<LayoutData>;
+    /** Static data to offer as a "Use Cached Data" option when the loader fails. */
+    fallbackData?: LayoutData;
 }
-export interface LayoutErrorBoundaryState {
+interface LayoutErrorBoundaryState {
     hasError: boolean;
     error: Error | null;
     errorInfo: LayoutErrorInfo | null;
     retryCount: number;
+    isRetrying: boolean;
+    fallbackData: LayoutData | null;
 }
+/**
+ * Error boundary for Avalon layouts.
+ *
+ * Catches render and data-loading errors in the wrapped layout tree.
+ * Shows a default error card with up to 3 retries, or your custom
+ * `fallback`. When `retryLoader` is provided, retry is async. When
+ * `fallbackData` is provided, a "Use Cached Data" button appears.
+ *
+ * @example
+ * ```tsx
+ * <LayoutErrorBoundary
+ *   retryLoader={() => fetchDashboardData()}
+ *   fallbackData={{ widgets: [] }}
+ *   onError={(err) => logToSentry(err)}
+ * >
+ *   <DashboardLayout />
+ * </LayoutErrorBoundary>
+ * ```
+ */
 export declare class LayoutErrorBoundary extends Component<LayoutErrorBoundaryProps, LayoutErrorBoundaryState> {
-    private maxRetries;
+    private readonly maxRetries;
     constructor(props: LayoutErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): Partial<LayoutErrorBoundaryState>;
-    componentDidCatch(error: Error, errorInfo: any): void;
-    private handleRetry;
-    private renderFallback;
+    componentDidCatch(error: Error, errorInfo: {
+        componentStack?: string;
+    }): void;
+    private readonly handleRetry;
+    private readonly handleUseFallback;
     render(): ComponentChildren;
 }
+export {};

package/dist/src/components/LayoutErrorBoundary.js

@@ -1 +1 @@
-import{Component as e}from"preact";import{jsxs as t,jsx as n}from"preact/jsx-runtime";export class LayoutErrorBoundary extends e{maxRetries=3;constructor(e){super(e),this.state={hasError:!1,error:null,errorInfo:null,retryCount:0}}static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e,t){let n={layoutPath:this.props.layoutPath||`unknown`,errorType:this.props.errorType||`component`,timestamp:Date.now(),componentStack:t.componentStack,errorBoundary:this.constructor.name};this.setState({errorInfo:n}),this.props.onError&&this.props.onError(e,n),typeof process<`u`&&process.env?.NODE_ENV===`development`&&(console.error(`Layout Error Boundary caught an error:`,e),console.error(`Error Info:`,n),console.error(`Component Stack:`,t.componentStack))}handleRetry=()=>{this.state.retryCount<this.maxRetries&&this.setState({hasError:!1,error:null,errorInfo:null,retryCount:this.state.retryCount+1})};renderFallback(){let{error:e}=this.state,{fallback:r}=this.props;return r&&e?r(e,this.handleRetry):n(`div`,{class:`layout-error-boundary`,children:t(`div`,{class:`error-container`,children:[n(`h2`,{children:`Something went wrong`}),n(`p`,{children:`An error occurred while rendering this layout.`}),this.state.retryCount<this.maxRetries&&t(`button`,{onClick:this.handleRetry,class:`retry-button`,children:[`Try Again (`,this.maxRetries-this.state.retryCount,` attempts left)`]}),typeof process<`u`&&process.env?.NODE_ENV===`development`&&t(`details`,{class:`error-details`,children:[n(`summary`,{children:`Error Details (Development)`}),n(`pre`,{children:e?.stack}),this.state.errorInfo&&t(`div`,{children:[t(`p`,{children:[n(`strong`,{children:`Layout Path:`}),` `,this.state.errorInfo.layoutPath]}),t(`p`,{children:[n(`strong`,{children:`Error Type:`}),` `,this.state.errorInfo.errorType]}),t(`p`,{children:[n(`strong`,{children:`Timestamp:`}),` `,new Date(this.state.errorInfo.timestamp).toISOString()]})]})]})]})})}render(){return this.state.hasError?this.renderFallback():this.props.children}}
+import{Component as e}from"preact";import{jsx as t,jsxs as n}from"preact/jsx-runtime";export class LayoutErrorBoundary extends e{maxRetries=3;constructor(e){super(e),this.state={hasError:!1,error:null,errorInfo:null,retryCount:0,isRetrying:!1,fallbackData:e.fallbackData??null}}static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e,t){let n={errorType:this.props.errorType??`component`,timestamp:Date.now(),componentStack:t.componentStack,errorBoundary:`LayoutErrorBoundary`,layoutPath:void 0};this.setState({errorInfo:n}),this.props.onError?.(e,n)}handleRetry=async()=>{if(!(this.state.retryCount>=this.maxRetries))if(this.props.retryLoader){this.setState({isRetrying:!0});try{let e=await this.props.retryLoader();this.setState(t=>({hasError:!1,error:null,errorInfo:null,retryCount:t.retryCount+1,isRetrying:!1,fallbackData:e}))}catch(e){this.setState(t=>({retryCount:t.retryCount+1,isRetrying:!1,error:e instanceof Error?e:Error(String(e))}))}}else this.setState(e=>({hasError:!1,error:null,errorInfo:null,retryCount:e.retryCount+1}))};handleUseFallback=()=>{this.state.fallbackData&&this.setState({hasError:!1,error:null,errorInfo:null})};render(){if(!this.state.hasError)return this.props.children;let{error:e,retryCount:r,isRetrying:i,fallbackData:a}=this.state;if(this.props.fallback&&e)return this.props.fallback(e,this.handleRetry);let o=r<this.maxRetries,s=typeof process<`u`&&process.env?.NODE_ENV===`development`;return t(`div`,{className:`layout-error-boundary`,children:n(`div`,{className:`error-container`,children:[t(`h2`,{children:`Something went wrong`}),t(`p`,{children:`An error occurred while rendering this layout.`}),n(`div`,{className:`error-actions`,children:[o&&t(`button`,{onClick:this.handleRetry,disabled:i,className:`retry-button`,children:i?`Retrying...`:`Try Again (${this.maxRetries-r} left)`}),a!==null&&t(`button`,{onClick:this.handleUseFallback,className:`fallback-button`,children:`Use Cached Data`})]}),s&&e&&n(`details`,{className:`error-details`,children:[t(`summary`,{children:`Error Details (Development)`}),n(`p`,{children:[t(`strong`,{children:`Error:`}),` `,e.message]}),this.state.errorInfo&&n(`p`,{children:[t(`strong`,{children:`Error Type:`}),` `,this.state.errorInfo.errorType]}),t(`pre`,{className:`error-stack`,children:e.stack})]})]})})}}

package/dist/src/islands/builtin-directives.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in custom hydration directives.
+ *
+ * These extend the core set (on:client, on:visible, on:interaction, on:idle, media:*)
+ * with additional strategies that users can opt into.
+ *
+ * Import and call `registerBuiltinDirectives()` in your server entry
+ * to make them available.
+ *
+ * @module islands/builtin-directives
+ */
+/**
+ * Register all built-in custom directives.
+ */
+export declare function registerBuiltinDirectives(): void;

package/dist/src/islands/builtin-directives.js

@@ -0,0 +1 @@
+import{registerHydrationDirective as e}from"./hydration-directives.js";export function registerBuiltinDirectives(){e(`on:delay`,{name:`on:delay`,script:(e,t,n)=>{setTimeout(t,Number.parseInt(n||`1000`,10))}}),e(`on:event`,{name:`on:event`,script:(e,t,n)=>{if(!n){t();return}let r=()=>{document.removeEventListener(n,r),t()};document.addEventListener(n,r,{once:!0})}}),e(`on:scroll`,{name:`on:scroll`,script:(e,t,n)=>{let r=Number.parseInt(n||`100`,10),i=()=>{globalThis.scrollY>=r&&(globalThis.removeEventListener(`scroll`,i),t())};globalThis.addEventListener(`scroll`,i,{passive:!0}),globalThis.scrollY>=r&&(globalThis.removeEventListener(`scroll`,i),t())}}),e(`on:match`,{name:`on:match`,script:(e,t,n)=>{if(!n){t();return}let r=globalThis.matchMedia(n);if(r.matches){t();return}let i=e=>{e.matches&&(r.removeEventListener(`change`,i),t())};r.addEventListener(`change`,i)}})}

package/dist/src/islands/hydration-directives.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Custom Hydration Directives
+ *
+ * Allows users to define custom hydration strategies for islands.
+ * A directive controls _when_ an island hydrates on the client.
+ *
+ * Built-in directives (on:client, on:visible, on:interaction, on:idle, media:*)
+ * are handled natively in main.js. This module enables user-defined directives
+ * that extend the system with arbitrary trigger logic.
+ *
+ * @example
+ * @example
+ * ```ts
+ * // Register a directive that hydrates after a delay
+ * registerHydrationDirective('on:delay', {
+ *   name: 'on:delay',
+ *   // Runs on the client — receives the island element and a hydrate callback
+ *   script: (el, hydrate, arg) => {
+ *     const ms = parseInt(arg || '1000', 10);
+ *     setTimeout(hydrate, ms);
+ *   },
+ * });
+ *
+ * // Use in a page via the island prop
+ * <Counter island={{ condition: 'on:delay', conditionArg: '2000' }} />
+ * ```
+ * @module islands/hydration-directives
+ */
+/**
+ * A client-side hydration directive function.
+ *
+ * Called once per island element when the page initializes.
+ * The function must call `hydrate()` exactly once when the island
+ * should become interactive.
+ *
+ * @param el - The `<avalon-island>` DOM element
+ * @param hydrate - Callback that triggers hydration. Call it once.
+ * @param arg - Optional argument string from `conditionArg` prop
+ */
+export type HydrationDirectiveFn = (el: HTMLElement, hydrate: () => void, arg?: string) => void | (() => void);
+/**
+ * Definition of a custom hydration directive.
+ */
+export interface HydrationDirectiveDefinition {
+    /** Directive name — must match the `condition` prop value (e.g. "on:delay") */
+    name: string;
+    /**
+     * Client-side script that controls when hydration fires.
+     *
+     * Can be either:
+     * - A function (will be serialized to the client)
+     * - A string of JavaScript (inlined directly)
+     */
+    script: HydrationDirectiveFn | string;
+}
+/**
+ * Register a custom hydration directive.
+ *
+ * @param name - Directive name (e.g. "on:delay", "on:event")
+ * @param definition - The directive definition
+ */
+export declare function registerHydrationDirective(name: string, definition: HydrationDirectiveDefinition): void;
+/**
+ * Unregister a custom hydration directive.
+ */
+export declare function unregisterHydrationDirective(name: string): boolean;
+/**
+ * Check whether a condition string maps to a registered custom directive.
+ */
+export declare function isCustomDirective(condition: string): boolean;
+/**
+ * Get a registered directive definition by name.
+ */
+export declare function getDirective(name: string): HydrationDirectiveDefinition | undefined;
+/**
+ * Get all registered custom directive names.
+ */
+export declare function getRegisteredDirectives(): string[];
+/**
+ * Serialize a directive's script to an inline-safe string.
+ * Used by the SSR renderer to embed the directive logic in the HTML
+ * so the client can execute it without an extra network request.
+ */
+export declare function serializeDirectiveScript(name: string): string | null;
+/**
+ * Clear all registered directives. Useful for testing.
+ * @internal
+ */
+export declare function clearDirectives(): void;

package/dist/src/islands/hydration-directives.js

@@ -0,0 +1 @@
+const e=new Map;export function registerHydrationDirective(t,n){e.has(t)&&console.warn(`[avalon] Hydration directive "${t}" is already registered. Overwriting.`),e.set(t,n)}export function unregisterHydrationDirective(t){return e.delete(t)}export function isCustomDirective(t){return e.has(t)}export function getDirective(t){return e.get(t)}export function getRegisteredDirectives(){return[...e.keys()]}export function serializeDirectiveScript(t){let n=e.get(t);return n?typeof n.script==`string`?n.script:n.script.toString():null}export function clearDirectives(){e.clear()}

package/dist/src/islands/island.d.ts

@@ -6,7 +6,7 @@ declare global {
     var __viteDevServer: ViteDevServer | undefined;
 }
 /** Supported hydration conditions for island components */
-export type HydrationCondition = 'on:visible' | 'on:interaction' | 'on:idle' | 'on:client' | `media:${string}`;
+export type HydrationCondition = 'on:visible' | 'on:interaction' | 'on:idle' | 'on:client' | `media:${string}` | `on:${string}`;
 /** Supported framework identifiers (without "unknown") */
 export type FrameworkId = Exclude<Framework, 'unknown'>;
 export interface IslandProps {
@@ -14,6 +14,8 @@ export interface IslandProps {
     src: string;
     /** Hydration condition */
     condition?: HydrationCondition;
+    /** Optional argument passed to custom hydration directives */
+    conditionArg?: string;
     /** Props to pass to the island component */
     props?: Record<string, unknown>;
     /** Children to render inside the island (for SSR) */
@@ -37,7 +39,7 @@ export interface IslandProps {
  * Uses custom elements instead of div wrappers for cleaner, more semantic markup.
  * Supports intelligent rendering strategy detection to skip hydration for SSR-only components.
  */
-export default function Island({ src, condition, props, children, ssr, framework, ssrOnly, renderOptions, hydrationData, }: IslandProps): JSX.Element;
+export default function Island({ src, condition, conditionArg, props, children, ssr, framework, ssrOnly, renderOptions, hydrationData, }: IslandProps): JSX.Element;
 /**
  * Universal renderIsland function – auto-detects framework and handles SSR + hydration.
  *
@@ -54,4 +56,4 @@ export default function Island({ src, condition, props, children, ssr, framework
  * Error isolation: If SSR fails, returns an error placeholder instead of throwing,
  * allowing the page to continue rendering other islands.
  */
-export declare function renderIsland({ src, condition, props, children, ssr, framework, ssrOnly, renderOptions, component: preloadedComponent, }: IslandProps): Promise<JSX.Element>;
+export declare function renderIsland({ src, condition, conditionArg, props, children, ssr, framework, ssrOnly, renderOptions, component: preloadedComponent, }: IslandProps): Promise<JSX.Element>;

package/dist/src/islands/island.js

@@ -1 +1 @@
-import{h as e}from"preact";import{detectFramework as t}from"./framework-detection.js";import{analyzeComponentFile as n,renderComponentSSROnly as r}from"./component-analysis.js";import{loadIntegration as i,detectFrameworkFromPath as a}from"./integration-loader.js";import{addUniversalCSS as o}from"./universal-css-collector.js";import{addUniversalHead as s}from"./universal-head-collector.js";import{getIslandBundlePath as c}from"../build/island-manifest.js";import{isDev as l,devLog as u,devWarn as d,devError as f,logRenderTiming as p}from"../utils/dev-logger.js";function m(e){return`island-${e.replaceAll(/[^a-zA-Z0-9]/g,`-`)}`}function h(e){let t={};e.renderId&&(t[`data-solid-render-id`]=e.renderId);let n=e.metadata;return n?.tagName&&(t[`data-tag-name`]=n.tagName),t}function g(e,t,n,r){return{"data-condition":t,"data-src":c(e),"data-props":JSON.stringify(n),"data-render-strategy":`hydrate`,...h(r)}}function _(e){return e.startsWith(`<script`)?`script`:e.startsWith(`<style`)?`style`:e.startsWith(`<meta`)?`meta`:e.startsWith(`<link`)?`link`:e.includes(`window._$HY`)||e.includes(`_$HY=`)?`script`:`other`}function v(e){let t=e.match(/<style[^>]*>([\s\S]*?)<\/style>/i);return t?t[1].trim():null}function y(e,t,n,r){if(e.css&&o(e.css,t,n,e.scopeId),e.head){let i=e.head.trim(),a=_(i);if(a===`style`){let a=v(i);a&&(u(`${r} Extracting CSS from head <style> tag`),o(a,t,n,e.scopeId));return}s(e.head,t,n,a)}}function b(t){let{islandId:n,detectedFramework:r,shouldSkipHydration:i,src:a,condition:o,props:s,hydrationData:c,children:l}=t,d={id:n,"data-framework":r},f=i?{"data-render-strategy":`ssr-only`}:g(a,o,s,c);r===`lit`&&u(`🔍 [Island Component] ${a} - Lit hydration data:`,{hydrationDataKeys:Object.keys(c),metadata:c.metadata});let p={...d,...f};return typeof l==`string`?e(`avalon-island`,{...p,dangerouslySetInnerHTML:{__html:l}}):e(`avalon-island`,p,l)}function x(t,n,r,i,a,o,s){return r?e(`avalon-island`,{id:t,"data-render-strategy":`ssr-only`,"data-framework":n}):e(`avalon-island`,{id:t,"data-condition":a,"data-src":c(i),"data-props":JSON.stringify(o),"data-render-strategy":`hydrate`,"data-framework":n,...h(s)})}export default function S({src:e,condition:t=`on:client`,props:n={},children:r,ssr:i=t!==`on:client`,framework:o,ssrOnly:s=!1,renderOptions:c={},hydrationData:l={}}){let f=m(e),p=s||!!c.forceSSROnly,h=o||a(e),g=r!=null&&r!==``;return u(`🔍 [Island Component] ${e}`,{ssr:i,ssrOnly:s,hasChildren:g,framework:o,condition:t}),i&&g?b({islandId:f,detectedFramework:h,shouldSkipHydration:p,src:e,condition:t,props:n,hydrationData:l,children:r}):(i&&!g&&p&&d(`${e}: SSR-only component has no rendered content. This may indicate a rendering error.`),x(f,h,p,e,t,n,l))}function C(t,n){let r=n instanceof Error?n.message:String(n);return f(`🚨 Island SSR failed for ${t}:`,n),n instanceof Error&&n.stack&&f(`Stack trace:`,n.stack),e(`avalon-island`,{id:m(t),"data-src":c(t),"data-ssr-error":r,"data-render-strategy":`client-only`})}async function w({src:e,condition:t,props:n,children:r,ssr:a,framework:o,ssrOnly:s,renderOptions:c,component:u}){let d=`🏝️ [${e}]`;if(!a||r)return S({src:e,condition:t,props:n,children:r,ssr:a,framework:o,ssrOnly:s,renderOptions:c});let p;try{p=await i(o)}catch(r){return f(`${d} Failed to load ${o} integration:`,r),S({src:e,condition:t,props:n,ssr:!1,framework:o,ssrOnly:s,renderOptions:c})}try{let r=await p.render({component:u??null,props:n,src:e,condition:t,ssrOnly:s,viteServer:globalThis.__viteDevServer,isDev:l()});return y(r,e,o,d),S({src:e,condition:t,props:n,children:r.html,ssr:!0,framework:o,ssrOnly:s,renderOptions:c,hydrationData:s?void 0:r.hydrationData})}catch(r){return f(`${d} Fast path SSR failed:`,r),S({src:e,condition:t,props:n,ssr:!1,framework:o,ssrOnly:s,renderOptions:c})}}async function T(e,t,r,i){if(t||r.detectScripts===!1)return t;try{let t=await n(e,r);if(t.decision.warnings?.length)for(let e of t.decision.warnings)d(`${i} Analysis warning: ${e}`);return!t.decision.shouldHydrate}catch(e){return d(`${i} Component analysis failed:`,e),t}}async function E(e){return e.endsWith(`.vue`)?`vue`:e.endsWith(`.svelte`)?`svelte`:e.endsWith(`.tsx`)||e.endsWith(`.jsx`)||e.endsWith(`.ts`)||e.endsWith(`.js`)?t(e):`unknown`}async function D(e,t,n,r,i,a,o){let s=await E(e),c=s,u=await(await O(s,a)).render({component:o??null,props:n,src:e,condition:t,ssrOnly:r,viteServer:globalThis.__viteDevServer,isDev:l()});return y(u,e,s,a),S({src:e,condition:t,props:n,children:u.html,ssr:!0,framework:c,ssrOnly:r,renderOptions:i,hydrationData:r?void 0:u.hydrationData})}async function O(e,t){try{u(`${t} Loading integration for framework: ${e}`);let n=await i(e);return u(`${t} ✅ Integration loaded successfully`),n}catch(n){throw f(`${t} Failed to load ${e} integration:`,n),Error(`Failed to load integration for framework '${e}'. Make sure @useavalon/${e} is installed.\nInstall it with: deno add @useavalon/${e}`,{cause:n})}}export async function renderIsland({src:e,condition:t=`on:client`,props:n={},children:r,ssr:i=t!==`on:client`,framework:a,ssrOnly:o=!1,renderOptions:s={},component:c}){let u=l()?performance.now():0,d=`🏝️ [${e}]`;try{return o&&!i&&(i=!0),a?await w({src:e,condition:t,props:n,children:r,ssr:i,framework:a,ssrOnly:o,renderOptions:s,component:c}):await k({src:e,condition:t,props:n,children:r,ssr:i,ssrOnly:o,renderOptions:s,logPrefix:d,component:c})}catch(t){return C(e,t)}finally{l()&&p(e,performance.now()-u)}}async function k(e){let{src:t,condition:n,props:r,children:i,ssr:a,ssrOnly:o,renderOptions:s,logPrefix:c,component:l}=e;if(u(`🔍 [renderIsland] ${t} - Starting render (slow path)`,{ssr:a,ssrOnly:o,hasChildren:!!i,condition:n}),await T(t,o,s,c))return A(t,n,r,i,a,s,c);if(!a||i)return S({src:t,condition:n,props:r,children:i,ssr:a,renderOptions:s});try{return await D(t,n,r,o,s,c,l)}catch(e){let i=await E(t);return f(`${c} Framework rendering failed:`,e),S({src:t,condition:n,props:r,ssr:!1,framework:i,renderOptions:s})}}function A(e,t,n,i,a,o,s){return a&&!i?r({src:e,condition:t,props:n,renderOptions:o}).catch(r=>(f(`${s} SSR failed for SSR-only component:`,r),S({src:e,condition:t,props:n,ssr:!1,ssrOnly:!0,renderOptions:o}))):S({src:e,condition:t,props:n,children:i,ssr:a,ssrOnly:!0,renderOptions:o})}
+import{h as e}from"preact";import{detectFramework as t}from"./framework-detection.js";import{analyzeComponentFile as n,renderComponentSSROnly as r}from"./component-analysis.js";import{loadIntegration as i,detectFrameworkFromPath as a}from"./integration-loader.js";import{addUniversalCSS as o}from"./universal-css-collector.js";import{addUniversalHead as s}from"./universal-head-collector.js";import{getIslandBundlePath as c}from"../build/island-manifest.js";import{isDev as l,devLog as u,devWarn as d,devError as f,logRenderTiming as p}from"../utils/dev-logger.js";import{isCustomDirective as m,serializeDirectiveScript as h}from"./hydration-directives.js";function g(e){return`island-${e.replaceAll(/[^a-zA-Z0-9]/g,`-`)}`}function _(e){let t={};e.renderId&&(t[`data-solid-render-id`]=e.renderId);let n=e.metadata;return n?.tagName&&(t[`data-tag-name`]=n.tagName),t}function v(e,t,n,r,i){let a={"data-condition":t,"data-src":c(e),"data-props":JSON.stringify(n),"data-render-strategy":`hydrate`,..._(r)};if(m(t)){a[`data-custom-directive`]=t;let e=h(t);e&&(a[`data-directive-script`]=e)}return i&&(a[`data-condition-arg`]=i),a}function y(e){return e.startsWith(`<script`)?`script`:e.startsWith(`<style`)?`style`:e.startsWith(`<meta`)?`meta`:e.startsWith(`<link`)?`link`:e.includes(`window._$HY`)||e.includes(`_$HY=`)?`script`:`other`}function b(e){let t=e.match(/<style[^>]*>([\s\S]*?)<\/style>/i);return t?t[1].trim():null}function x(e,t,n,r){if(e.css&&o(e.css,t,n,e.scopeId),e.head){let i=e.head.trim(),a=y(i);if(a===`style`){let a=b(i);a&&(u(`${r} Extracting CSS from head <style> tag`),o(a,t,n,e.scopeId));return}s(e.head,t,n,a)}}function S(t){let{islandId:n,detectedFramework:r,shouldSkipHydration:i,src:a,condition:o,conditionArg:s,props:c,hydrationData:l,children:d}=t,f={id:n,"data-framework":r},p=i?{"data-render-strategy":`ssr-only`}:v(a,o,c,l,s);r===`lit`&&u(`🔍 [Island Component] ${a} - Lit hydration data:`,{hydrationDataKeys:Object.keys(l),metadata:l.metadata});let m={...f,...p};return typeof d==`string`?e(`avalon-island`,{...m,dangerouslySetInnerHTML:{__html:d}}):e(`avalon-island`,m,d)}function C(t){let{islandId:n,detectedFramework:r,shouldSkipHydration:i,src:a,condition:o,props:s,hydrationData:l,conditionArg:u}=t;if(i)return e(`avalon-island`,{id:n,"data-render-strategy":`ssr-only`,"data-framework":r});let d={id:n,"data-condition":o,"data-src":c(a),"data-props":JSON.stringify(s),"data-render-strategy":`hydrate`,"data-framework":r,..._(l)};if(m(o)){d[`data-custom-directive`]=o;let e=h(o);e&&(d[`data-directive-script`]=e)}return u&&(d[`data-condition-arg`]=u),e(`avalon-island`,d)}export default function w({src:e,condition:t=`on:client`,conditionArg:n,props:r={},children:i,ssr:o=t!==`on:client`,framework:s,ssrOnly:c=!1,renderOptions:l={},hydrationData:f={}}){let p=g(e),m=c||!!l.forceSSROnly,h=s||a(e),_=i!=null&&i!==``;return u(`🔍 [Island Component] ${e}`,{ssr:o,ssrOnly:c,hasChildren:_,framework:s,condition:t}),o&&_?S({islandId:p,detectedFramework:h,shouldSkipHydration:m,src:e,condition:t,conditionArg:n,props:r,hydrationData:f,children:i}):(o&&!_&&m&&d(`${e}: SSR-only component has no rendered content. This may indicate a rendering error.`),C({islandId:p,detectedFramework:h,shouldSkipHydration:m,src:e,condition:t,props:r,hydrationData:f,conditionArg:n}))}function T(t,n){let r=n instanceof Error?n.message:String(n);return f(`🚨 Island SSR failed for ${t}:`,n),n instanceof Error&&n.stack&&f(`Stack trace:`,n.stack),e(`avalon-island`,{id:g(t),"data-src":c(t),"data-ssr-error":r,"data-render-strategy":`client-only`})}async function E({src:e,condition:t,conditionArg:n,props:r,children:a,ssr:o,framework:s,ssrOnly:c,renderOptions:u,component:d}){let p=`🏝️ [${e}]`;if(!o||a)return w({src:e,condition:t,conditionArg:n,props:r,children:a,ssr:o,framework:s,ssrOnly:c,renderOptions:u});let m;try{m=await i(s)}catch(i){return f(`${p} Failed to load ${s} integration:`,i),w({src:e,condition:t,conditionArg:n,props:r,ssr:!1,framework:s,ssrOnly:c,renderOptions:u})}try{let i=await m.render({component:d??null,props:r,src:e,condition:t,ssrOnly:c,viteServer:globalThis.__viteDevServer,isDev:l()});return x(i,e,s,p),w({src:e,condition:t,conditionArg:n,props:r,children:i.html,ssr:!0,framework:s,ssrOnly:c,renderOptions:u,hydrationData:c?void 0:i.hydrationData})}catch(i){return f(`${p} Fast path SSR failed:`,i),w({src:e,condition:t,conditionArg:n,props:r,ssr:!1,framework:s,ssrOnly:c,renderOptions:u})}}async function D(e,t,r,i){if(t||r.detectScripts===!1)return t;try{let t=await n(e,r);if(t.decision.warnings?.length)for(let e of t.decision.warnings)d(`${i} Analysis warning: ${e}`);return!t.decision.shouldHydrate}catch(e){return d(`${i} Component analysis failed:`,e),t}}async function O(e){return e.endsWith(`.vue`)?`vue`:e.endsWith(`.svelte`)?`svelte`:e.endsWith(`.tsx`)||e.endsWith(`.jsx`)||e.endsWith(`.ts`)||e.endsWith(`.js`)?t(e):`unknown`}async function k(e,t,n,r,i,a,o){let s=await O(e),c=s,u=await(await A(s,a)).render({component:o??null,props:n,src:e,condition:t,ssrOnly:r,viteServer:globalThis.__viteDevServer,isDev:l()});return x(u,e,s,a),w({src:e,condition:t,props:n,children:u.html,ssr:!0,framework:c,ssrOnly:r,renderOptions:i,hydrationData:r?void 0:u.hydrationData})}async function A(e,t){try{u(`${t} Loading integration for framework: ${e}`);let n=await i(e);return u(`${t} ✅ Integration loaded successfully`),n}catch(n){throw f(`${t} Failed to load ${e} integration:`,n),Error(`Failed to load integration for framework '${e}'. Make sure @useavalon/${e} is installed.\nInstall it with: deno add @useavalon/${e}`,{cause:n})}}export async function renderIsland({src:e,condition:t=`on:client`,conditionArg:n,props:r={},children:i,ssr:a=t!==`on:client`,framework:o,ssrOnly:s=!1,renderOptions:c={},component:u}){let d=l()?performance.now():0,f=`🏝️ [${e}]`;try{return s&&!a&&(a=!0),o?await E({src:e,condition:t,conditionArg:n,props:r,children:i,ssr:a,framework:o,ssrOnly:s,renderOptions:c,component:u}):await j({src:e,condition:t,conditionArg:n,props:r,children:i,ssr:a,ssrOnly:s,renderOptions:c,logPrefix:f,component:u})}catch(t){return T(e,t)}finally{l()&&p(e,performance.now()-d)}}async function j(e){let{src:t,condition:n,conditionArg:r,props:i,children:a,ssr:o,ssrOnly:s,renderOptions:c,logPrefix:l,component:d}=e;if(u(`🔍 [renderIsland] ${t} - Starting render (slow path)`,{ssr:o,ssrOnly:s,hasChildren:!!a,condition:n}),await D(t,s,c,l))return M(t,n,i,a,o,c,l);if(!o||a)return w({src:t,condition:n,conditionArg:r,props:i,children:a,ssr:o,renderOptions:c});try{return await k(t,n,i,s,c,l,d)}catch(e){let a=await O(t);return f(`${l} Framework rendering failed:`,e),w({src:t,condition:n,conditionArg:r,props:i,ssr:!1,framework:a,renderOptions:c})}}function M(e,t,n,i,a,o,s){return a&&!i?r({src:e,condition:t,props:n,renderOptions:o}).catch(r=>(f(`${s} SSR failed for SSR-only component:`,r),w({src:e,condition:t,props:n,ssr:!1,ssrOnly:!0,renderOptions:o}))):w({src:e,condition:t,props:n,children:i,ssr:a,ssrOnly:!0,renderOptions:o})}

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

@@ -12,8 +12,10 @@ export type Framework = "solid" | "vue" | "svelte" | "preact" | "react" | "lit"
 export interface IslandProps {
     /** Path to the island component (e.g., "/islands/Counter.tsx") */
     src: string;
-    /** Hydration condition */
-    condition?: "on:visible" | "on:interaction" | "on:idle" | "on:client" | `media:${string}`;
+    /** Hydration condition (built-in or custom directive name) */
+    condition?: "on:visible" | "on:interaction" | "on:idle" | "on:client" | `media:${string}` | `on:${string}`;
+    /** Optional argument passed to custom hydration directives */
+    conditionArg?: string;
     /** Props to pass to the island component */
     props?: Record<string, unknown>;
     /** Children to render inside the island (for SSR) */

package/dist/src/layout-system.d.ts

@@ -14,25 +14,12 @@ export { LayoutComposer } from './core/layout/layout-composer.ts';
 export type { LayoutConfig } from './schemas/layout.ts';
 export { EnhancedLayoutResolver, createEnhancedLayoutResolver, EnhancedLayoutResolverUtils, } from './core/layout/enhanced-layout-resolver.ts';
 export type { EnhancedLayoutResolverOptions } from './core/layout/enhanced-layout-resolver.ts';
-export { IslandPersistence, defaultIslandPersistence } from './core/islands/island-persistence.ts';
-export { IslandStateSerializer } from './core/islands/island-state-serializer.ts';
-export { createPersistentIslandContext, usePersistentIslandContext, PersistentIslandProvider, } from './core/islands/persistent-island-context.tsx';
-export { PersistentIsland } from './components/PersistentIsland.tsx';
-export type { IslandState, PersistentIslandProps, PersistentIslandContext } from './schemas/layout.ts';
-export { LayoutErrorBoundary } from './components/LayoutErrorBoundary.tsx';
-export { LayoutDataErrorBoundary } from './components/LayoutDataErrorBoundary.tsx';
-export { IslandErrorBoundary, withIslandErrorBoundary } from './components/IslandErrorBoundary.tsx';
-export { StreamingErrorBoundary, withStreamingErrorBoundary } from './components/StreamingErrorBoundary.tsx';
-export type { LayoutErrorInfo, LayoutErrorBoundaryProps, ErrorRecoveryStrategy } from './schemas/layout.ts';
-export { StreamingLayout, StreamingSuspense, withStreaming, useStreamingState } from './components/StreamingLayout.tsx';
-export type { StreamingLayoutProps, StreamingComponent } from './schemas/layout.ts';
 export { LayoutCacheManager } from './core/layout/layout-cache-manager.ts';
 export type { CacheEntry, CacheStats, CacheConfig, } from './core/layout/layout-cache-manager.ts';
 export type { LayoutContext, LayoutData, LayoutHandler, LayoutProps, LayoutLoader, ResolvedLayout, LayoutCache, EnhancedLayoutContext, LayoutMatcherFunction, LayoutErrorHandler, LayoutRetryFunction, LayoutFallbackRenderer, IslandStateSaver, IslandStateLoader, IslandStateClearer, StreamingReadyCheck, } from './schemas/layout.ts';
 export type { ILayoutDiscovery, ILayoutMatcher, ILayoutComposer, IIslandPersistence, ILayoutErrorRecovery, ILayoutStreaming, IEnhancedLayoutResolver, ILayoutComponent, IPersistentIslandComponent, ILayoutErrorBoundaryComponent, IStreamingLayoutComponent, LayoutModule, PageModule, LayoutResolutionContext, LayoutPerformanceMetrics, LayoutDebugInfo, LayoutEventType, LayoutEventData, LayoutEventHandler, ILayoutEventEmitter, } from './types/layout.ts';
 export { LayoutContextSchema, LayoutDataSchema, LayoutRouteSchema, LayoutHandlerSchema, LayoutPropsSchema, LayoutDiscoveryOptionsSchema, RouteInfoSchema, LayoutRuleSchema, LayoutConfigSchema, IslandStateSchema, PersistentIslandPropsSchema, PersistentIslandContextSchema, LayoutErrorInfoSchema, LayoutErrorBoundaryPropsSchema, ErrorRecoveryStrategySchema, StreamingLayoutPropsSchema, StreamingComponentSchema, ResolvedLayoutSchema, LayoutCacheSchema, EnhancedLayoutContextSchema, } from './schemas/layout.ts';
 export { EnhancedLayoutResolver as LayoutSystem } from './core/layout/enhanced-layout-resolver.ts';
-export { defaultIslandPersistence as defaultPersistence } from './core/islands/island-persistence.ts';
 export { createEnhancedLayoutResolver as createLayoutSystem } from './core/layout/enhanced-layout-resolver.ts';
 /**
  * Layout System Version Information

package/dist/src/layout-system.js

@@ -1 +1 @@
-export{LayoutDiscovery}from"./core/layout/layout-discovery.js";export{LayoutDataLoader,LayoutDataLoadingError,loadSingleLayoutData,mergeLayoutData,getParentLayoutData,defaultLayoutDataLoader}from"./core/layout/layout-data-loader.js";export{LayoutMatcher as LayoutMatcherClass,BuiltInLayoutRules}from"./core/layout/layout-matcher.js";export{LayoutComposer}from"./core/layout/layout-composer.js";export{EnhancedLayoutResolver,createEnhancedLayoutResolver,EnhancedLayoutResolverUtils}from"./core/layout/enhanced-layout-resolver.js";export{IslandPersistence,defaultIslandPersistence}from"./core/islands/island-persistence.js";export{IslandStateSerializer}from"./core/islands/island-state-serializer.js";export{createPersistentIslandContext,usePersistentIslandContext,PersistentIslandProvider}from"./core/islands/persistent-island-context.js";export{PersistentIsland}from"./components/PersistentIsland.js";export{LayoutErrorBoundary}from"./components/LayoutErrorBoundary.js";export{LayoutDataErrorBoundary}from"./components/LayoutDataErrorBoundary.js";export{IslandErrorBoundary,withIslandErrorBoundary}from"./components/IslandErrorBoundary.js";export{StreamingErrorBoundary,withStreamingErrorBoundary}from"./components/StreamingErrorBoundary.js";export{StreamingLayout,StreamingSuspense,withStreaming,useStreamingState}from"./components/StreamingLayout.js";export{LayoutCacheManager}from"./core/layout/layout-cache-manager.js";export{LayoutContextSchema,LayoutDataSchema,LayoutRouteSchema,LayoutHandlerSchema,LayoutPropsSchema,LayoutDiscoveryOptionsSchema,RouteInfoSchema,LayoutRuleSchema,LayoutConfigSchema,IslandStateSchema,PersistentIslandPropsSchema,PersistentIslandContextSchema,LayoutErrorInfoSchema,LayoutErrorBoundaryPropsSchema,ErrorRecoveryStrategySchema,StreamingLayoutPropsSchema,StreamingComponentSchema,ResolvedLayoutSchema,LayoutCacheSchema,EnhancedLayoutContextSchema}from"./schemas/layout.js";export{EnhancedLayoutResolver as LayoutSystem}from"./core/layout/enhanced-layout-resolver.js";export{defaultIslandPersistence as defaultPersistence}from"./core/islands/island-persistence.js";export{createEnhancedLayoutResolver as createLayoutSystem}from"./core/layout/enhanced-layout-resolver.js";export const LAYOUT_SYSTEM_VERSION=`1.0.0`;export const LAYOUT_SYSTEM_FEATURES={DISCOVERY:!0,DATA_LOADING:!0,CONDITIONAL_RENDERING:!0,COMPOSITION_CONTROL:!0,PERSISTENT_ISLANDS:!0,ERROR_BOUNDARIES:!0,STREAMING:!0,CACHING:!0,PERFORMANCE_MONITORING:!0,DEBUG_UTILITIES:!0};export const LAYOUT_SYSTEM_DEFAULTS={DISCOVERY:{baseDirectory:`src/pages`,filePattern:`_layout.tsx`,excludeDirectories:[`node_modules`,`.git`,`dist`],enableWatching:!1,developmentMode:!1},CACHING:{enabled:!0,ttl:3e5,maxSize:100,cleanupInterval:6e4},STREAMING:{enabled:!0,priority:`medium`,timeout:5e3},ERROR_BOUNDARIES:{enabled:!0,maxRetries:3,fallbackStrategy:`component`},PERFORMANCE:{monitoring:!0,thresholds:{discoveryTime:100,dataLoadingTime:500,renderingTime:200,totalTime:1e3}}};
+export{LayoutDiscovery}from"./core/layout/layout-discovery.js";export{LayoutDataLoader,LayoutDataLoadingError,loadSingleLayoutData,mergeLayoutData,getParentLayoutData,defaultLayoutDataLoader}from"./core/layout/layout-data-loader.js";export{LayoutMatcher as LayoutMatcherClass,BuiltInLayoutRules}from"./core/layout/layout-matcher.js";export{LayoutComposer}from"./core/layout/layout-composer.js";export{EnhancedLayoutResolver,createEnhancedLayoutResolver,EnhancedLayoutResolverUtils}from"./core/layout/enhanced-layout-resolver.js";export{LayoutCacheManager}from"./core/layout/layout-cache-manager.js";export{LayoutContextSchema,LayoutDataSchema,LayoutRouteSchema,LayoutHandlerSchema,LayoutPropsSchema,LayoutDiscoveryOptionsSchema,RouteInfoSchema,LayoutRuleSchema,LayoutConfigSchema,IslandStateSchema,PersistentIslandPropsSchema,PersistentIslandContextSchema,LayoutErrorInfoSchema,LayoutErrorBoundaryPropsSchema,ErrorRecoveryStrategySchema,StreamingLayoutPropsSchema,StreamingComponentSchema,ResolvedLayoutSchema,LayoutCacheSchema,EnhancedLayoutContextSchema}from"./schemas/layout.js";export{EnhancedLayoutResolver as LayoutSystem}from"./core/layout/enhanced-layout-resolver.js";export{createEnhancedLayoutResolver as createLayoutSystem}from"./core/layout/enhanced-layout-resolver.js";export const LAYOUT_SYSTEM_VERSION=`1.0.0`;export const LAYOUT_SYSTEM_FEATURES={DISCOVERY:!0,DATA_LOADING:!0,CONDITIONAL_RENDERING:!0,COMPOSITION_CONTROL:!0,PERSISTENT_ISLANDS:!0,ERROR_BOUNDARIES:!0,STREAMING:!0,CACHING:!0,PERFORMANCE_MONITORING:!0,DEBUG_UTILITIES:!0};export const LAYOUT_SYSTEM_DEFAULTS={DISCOVERY:{baseDirectory:`src/pages`,filePattern:`_layout.tsx`,excludeDirectories:[`node_modules`,`.git`,`dist`],enableWatching:!1,developmentMode:!1},CACHING:{enabled:!0,ttl:3e5,maxSize:100,cleanupInterval:6e4},STREAMING:{enabled:!0,priority:`medium`,timeout:5e3},ERROR_BOUNDARIES:{enabled:!0,maxRetries:3,fallbackStrategy:`component`},PERFORMANCE:{monitoring:!0,thresholds:{discoveryTime:100,dataLoadingTime:500,renderingTime:200,totalTime:1e3}}};