@useavalon/avalon 0.1.47 → 0.1.48

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

@@ -1,36 +0,0 @@
-/** @jsxImportSource preact */
-import type { ComponentChildren } from 'preact';
-import { type IslandPersistence } from '../core/islands/island-persistence.ts';
-interface PersistentIslandProps {
-    /** Unique ID used as the storage key for this island's state */
-    persistentId: string;
-    /** The island component(s) to wrap with persistence context */
-    children: ComponentChildren;
-    /** Custom persistence instance (defaults to sessionStorage-backed) */
-    persistence?: IslandPersistence;
-}
-/**
- * PersistentIsland — provides automatic state persistence context to child islands.
- *
- * Wrap any island with this component and use `usePersistentIslandContext()` inside
- * the island to get `saveState`, `loadState`, and `clearState` functions.
- *
- * Usage in a page:
- * ```tsx
- * <PersistentIsland persistentId="my-counter" island={{ condition: 'on:client' }}>
- *   <MyCounter />
- * </PersistentIsland>
- * ```
- *
- * Usage inside the island:
- * ```tsx
- * import { usePersistentIslandContext } from '@useavalon/avalon';
- *
- * function MyCounter() {
- *   const { saveState, loadState, clearState } = usePersistentIslandContext();
- *   // ...
- * }
- * ```
- */
-export declare function PersistentIsland({ persistentId, children, persistence, }: Readonly<PersistentIslandProps>): import("preact").JSX.Element;
-export default PersistentIsland;

package/dist/src/components/PersistentIsland.js

@@ -1 +0,0 @@
-import{PersistentIslandProvider as e}from"../core/islands/persistent-island-context.js";import{defaultIslandPersistence as t}from"../core/islands/island-persistence.js";import{jsx as n}from"preact/jsx-runtime";export function PersistentIsland({persistentId:r,children:i,persistence:a=t}){return n(e,{persistentId:r,persistence:a,children:n(`div`,{"data-persistent-id":r,children:i})})}export default PersistentIsland;

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

@@ -1,42 +0,0 @@
-/**
- * StreamingErrorBoundary - Error boundary component for streaming contexts
- *
- * This component provides error isolation for Suspense boundaries in streaming SSR.
- * It ensures that errors in one component don't break the entire page.
- */
-import { Component, type ComponentChildren } from 'preact';
-export interface StreamingErrorBoundaryProps {
-    children: ComponentChildren;
-    fallback?: (error: Error, retry: () => void) => ComponentChildren;
-    onError?: (error: Error, errorInfo: any) => void;
-    componentId?: string;
-    isolateError?: boolean;
-}
-export interface StreamingErrorBoundaryState {
-    hasError: boolean;
-    error: Error | null;
-    errorInfo: any;
-}
-/**
- * Error boundary component for streaming contexts
- *
- * Wraps Suspense boundaries to provide error isolation and recovery.
- * Prevents errors in one component from breaking the entire page.
- */
-export declare class StreamingErrorBoundary extends Component<StreamingErrorBoundaryProps, StreamingErrorBoundaryState> {
-    constructor(props: StreamingErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): Partial<StreamingErrorBoundaryState>;
-    componentDidCatch(error: Error, errorInfo: any): void;
-    private handleRetry;
-    private renderFallback;
-    render(): ComponentChildren;
-}
-/**
- * Higher-order component to wrap components with streaming error boundaries
- */
-export declare function withStreamingErrorBoundary<P extends object>(WrappedComponent: (props: P) => ComponentChildren, options?: {
-    fallback?: (error: Error, retry: () => void) => ComponentChildren;
-    componentId?: string;
-    isolateError?: boolean;
-    onError?: (error: Error, errorInfo: any) => void;
-}): (props: P) => import("preact").JSX.Element;

package/dist/src/components/StreamingErrorBoundary.js

@@ -1 +0,0 @@
-import{Component as e}from"preact";import{jsx as t,jsxs as n}from"preact/jsx-runtime";export class StreamingErrorBoundary 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){if(this.setState({errorInfo:t}),console.error(`[StreamingErrorBoundary] Caught error:`,{componentId:this.props.componentId,error:e.message,stack:e.stack,componentStack:t.componentStack}),this.props.onError&&this.props.onError(e,t),!this.props.isolateError)throw e}handleRetry=()=>{this.setState({hasError:!1,error:null,errorInfo:null})};renderFallback(){let{error:e}=this.state,{fallback:r,componentId:i}=this.props;if(r&&e)return r(e,this.handleRetry);let a=typeof process<`u`&&process.env?.NODE_ENV!==`production`;return n(`div`,{class:`streaming-error-boundary`,"data-error-boundary":`true`,"data-component-id":i,style:{background:`#fff3cd`,border:`2px solid #ffc107`,borderRadius:`8px`,padding:`20px`,margin:`20px 0`,fontFamily:`system-ui, -apple-system, sans-serif`},children:[n(`div`,{class:`error-boundary-header`,style:{display:`flex`,alignItems:`center`,gap:`10px`,marginBottom:`10px`},children:[t(`span`,{style:{fontSize:`24px`},children:`⚠️`}),t(`h3`,{style:{margin:0,color:`#856404`},children:`Component Error`})]}),t(`p`,{style:{margin:`10px 0`,color:`#856404`},children:`An error occurred while rendering this component. The rest of the page should work normally.`}),t(`button`,{onClick:this.handleRetry,style:{background:`#ffc107`,border:`none`,borderRadius:`4px`,padding:`8px 16px`,cursor:`pointer`,fontWeight:`bold`,color:`#856404`,marginTop:`10px`},children:`Retry`}),a&&e&&n(`details`,{style:{marginTop:`15px`},children:[t(`summary`,{style:{cursor:`pointer`,color:`#856404`,fontWeight:`bold`},children:`Error Details (Development Mode)`}),n(`div`,{style:{marginTop:`10px`},children:[i&&n(`p`,{children:[t(`strong`,{children:`Component ID:`}),` `,i]}),n(`p`,{children:[t(`strong`,{children:`Error:`}),` `,e.message]}),e.stack&&t(`pre`,{style:{background:`#f5f5f5`,padding:`10px`,borderRadius:`4px`,overflowX:`auto`,fontSize:`12px`,marginTop:`10px`},children:e.stack}),this.state.errorInfo?.componentStack&&n(`div`,{children:[t(`p`,{children:t(`strong`,{children:`Component Stack:`})}),t(`pre`,{style:{background:`#f5f5f5`,padding:`10px`,borderRadius:`4px`,overflowX:`auto`,fontSize:`12px`,marginTop:`10px`},children:this.state.errorInfo.componentStack})]})]})]})]})}render(){return this.state.hasError?this.renderFallback():this.props.children}}export function withStreamingErrorBoundary(e,n){return function(i){return t(StreamingErrorBoundary,{componentId:n?.componentId,fallback:n?.fallback,isolateError:n?.isolateError??!0,onError:n?.onError,children:t(e,{...i})})}}

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

@@ -1,83 +0,0 @@
-import { ComponentChildren, ComponentType } from 'preact';
-import type { StreamingLayoutProps } from '../types/layout.ts';
-/**
- * Streaming Layout Component Props
- */
-export interface StreamingLayoutComponentProps extends StreamingLayoutProps {
-    /**
-     * Component to render when ready
-     */
-    component: ComponentType<any>;
-    /**
-     * Props to pass to the component
-     */
-    componentProps?: any;
-    /**
-     * Function to check if component is ready
-     */
-    isReady?: () => Promise<boolean>;
-    /**
-     * Timeout for loading (ms)
-     */
-    timeout?: number;
-    /**
-     * Error boundary fallback
-     */
-    onError?: (error: Error) => ComponentChildren;
-    /**
-     * Loading state callback
-     */
-    onLoadingChange?: (isLoading: boolean) => void;
-}
-/**
- * Streaming Layout Component with Suspense-like behavior
- */
-export declare function StreamingLayout(props: StreamingLayoutComponentProps): ComponentChildren;
-/**
- * Suspense-like boundary for streaming components
- */
-export interface StreamingSuspenseProps {
-    /**
-     * Fallback to show while loading
-     */
-    fallback?: ComponentChildren;
-    /**
-     * Children components
-     */
-    children: ComponentChildren;
-    /**
-     * Priority for this suspense boundary
-     */
-    priority?: 'high' | 'medium' | 'low';
-    /**
-     * Timeout for all children (ms)
-     */
-    timeout?: number;
-    /**
-     * Error boundary for failed components
-     */
-    onError?: (error: Error) => ComponentChildren;
-}
-/**
- * Streaming Suspense Boundary Component
- */
-export declare function StreamingSuspense(props: StreamingSuspenseProps): ComponentChildren;
-/**
- * Higher-order component to add streaming capabilities
- */
-export declare function withStreaming<P extends object>(WrappedComponent: ComponentType<P>, streamingOptions?: {
-    fallback?: ComponentChildren;
-    priority?: 'high' | 'medium' | 'low';
-    isReady?: () => Promise<boolean>;
-    timeout?: number;
-}): (props: P) => import("preact").JSX.Element;
-/**
- * Hook for streaming component state
- */
-export declare function useStreamingState(isReady?: () => Promise<boolean>, timeout?: number): {
-    retry: () => void;
-    isReady: boolean;
-    isLoading: boolean;
-    error: Error | null;
-    hasTimedOut: boolean;
-};

package/dist/src/components/StreamingLayout.js

@@ -1,29 +0,0 @@
-import{Component as e}from"preact";import{useState as t,useEffect as n,useRef as r}from"preact/hooks";import{jsxs as i,jsx as a}from"preact/jsx-runtime";export function StreamingLayout(e){let{component:o,componentProps:c={},children:l,fallback:u,priority:d=`medium`,isReady:f,timeout:p=5e3,onError:m,onLoadingChange:h}=e;if(typeof window>`u`)return l;let[g,_]=t({isReady:!1,isLoading:!0,error:null,hasTimedOut:!1}),v=r(),y=r(!0);return n(()=>()=>{y.current=!1},[]),n(()=>{if(!f){_(e=>({...e,isReady:!0,isLoading:!1})),h?.(!1);return}let e=!1;return(async()=>{try{p>0&&(v.current=setTimeout(()=>{!e&&y.current&&(_(e=>({...e,hasTimedOut:!0,isLoading:!1})),h?.(!1))},p));let t=await f();if(e||!y.current)return;v.current&&clearTimeout(v.current),_(e=>({...e,isReady:t,isLoading:!1,hasTimedOut:!1})),h?.(!1)}catch(t){if(e||!y.current)return;v.current&&clearTimeout(v.current),_(e=>({...e,error:t,isLoading:!1})),h?.(!1)}})(),()=>{e=!0,v.current&&clearTimeout(v.current)}},[f,p,h]),g.error?m?m(g.error):i(`div`,{class:`streaming-error`,"data-priority":d,children:[i(`p`,{children:[`Failed to load component: `,g.error.message]}),a(`button`,{onClick:()=>{_({isReady:!1,isLoading:!0,error:null,hasTimedOut:!1}),h?.(!0)},children:`Retry`})]}):g.hasTimedOut?a(`div`,{class:`streaming-timeout`,"data-priority":d,children:u||i(`div`,{class:`timeout-message`,children:[a(`p`,{children:`Component loading timed out`}),a(`button`,{onClick:()=>{_({isReady:!1,isLoading:!0,error:null,hasTimedOut:!1}),h?.(!0)},children:`Retry`})]})}):g.isLoading||!g.isReady?a(`div`,{class:`streaming-loading`,"data-priority":d,children:u||a(s,{priority:d})}):a(`div`,{class:`streaming-ready`,"data-priority":d,children:a(o,{...c,children:l})})}function s({priority:e}){return i(`div`,{class:`streaming-skeleton ${`skeleton-${e}`}`,children:[i(`div`,{class:`skeleton-content`,children:[a(`div`,{class:`skeleton-line skeleton-line-1`}),a(`div`,{class:`skeleton-line skeleton-line-2`}),a(`div`,{class:`skeleton-line skeleton-line-3`})]}),a(`style`,{children:`
-				.streaming-skeleton {
-					padding: 1rem;
-					border-radius: 0.5rem;
-					background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
-					background-size: 200% 100%;
-					animation: skeleton-loading 1.5s infinite;
-				}
-				.skeleton-content {
-					display: flex;
-					flex-direction: column;
-					gap: 0.5rem;
-				}
-				.skeleton-line {
-					height: 1rem;
-					background: rgba(255, 255, 255, 0.8);
-					border-radius: 0.25rem;
-				}
-				.skeleton-line-1 { width: 100%; }
-				.skeleton-line-2 { width: 75%; }
-				.skeleton-line-3 { width: 50%; }
-				.skeleton-high { border-left: 4px solid #ef4444; }
-				.skeleton-medium { border-left: 4px solid #f59e0b; }
-				.skeleton-low { border-left: 4px solid #10b981; }
-				@keyframes skeleton-loading {
-					0% { background-position: 200% 0; }
-					100% { background-position: -200% 0; }
-				}
-			`})]})}export function StreamingSuspense(e){let{fallback:o,children:c,priority:u=`medium`,timeout:d=5e3,onError:f}=e,[p,m]=t(!0),[h,g]=t(null),[_,v]=t(!1),y=r(),b=r(!0);n(()=>()=>{b.current=!1},[]),n(()=>(d>0&&(y.current=setTimeout(()=>{b.current&&p&&(v(!0),m(!1))},d)),()=>{y.current&&clearTimeout(y.current)}),[d,p]);let x=e=>{g(e),m(!1),y.current&&clearTimeout(y.current)};return h?f?f(h):i(`div`,{class:`streaming-suspense-error`,"data-priority":u,children:[i(`p`,{children:[`Suspense boundary error: `,h.message]}),a(`button`,{onClick:()=>{g(null),m(!0),v(!1)},children:`Retry`})]}):_?a(`div`,{class:`streaming-suspense-timeout`,"data-priority":u,children:o||i(`div`,{class:`suspense-timeout-message`,children:[a(`p`,{children:`Suspense boundary timed out`}),a(`button`,{onClick:()=>{v(!1),m(!0)},children:`Retry`})]})}):p?a(`div`,{class:`streaming-suspense-loading`,"data-priority":u,children:o||a(s,{priority:u})}):a(`div`,{class:`streaming-suspense-ready`,"data-priority":u,children:a(l,{onError:x,children:c})})}class l extends e{constructor(e){super(e),this.state={hasError:!1}}static getDerivedStateFromError(e){return{hasError:!0,error:e}}componentDidCatch(e,t){console.error(`StreamingErrorBoundary caught an error:`,e,t),this.props.onError?.(e)}render(){return this.state.hasError?i(`div`,{class:`streaming-error-boundary`,children:[a(`p`,{children:`Something went wrong in streaming component.`}),a(`button`,{onClick:()=>this.setState({hasError:!1,error:void 0}),children:`Retry`})]}):this.props.children}}export function withStreaming(e,t={}){return function(n){return a(StreamingLayout,{component:e,componentProps:n,priority:`medium`,...t,children:null})}}export function useStreamingState(e,r=5e3){let[i,a]=t({isReady:!1,isLoading:!0,error:null,hasTimedOut:!1});n(()=>{if(!e){a(e=>({...e,isReady:!0,isLoading:!1}));return}let t=!1,n;return(async()=>{try{r>0&&(n=setTimeout(()=>{t||a(e=>({...e,hasTimedOut:!0,isLoading:!1}))},r));let i=await e();if(t)return;n&&clearTimeout(n),a(e=>({...e,isReady:i,isLoading:!1,hasTimedOut:!1}))}catch(e){if(t)return;n&&clearTimeout(n),a(t=>({...t,error:e,isLoading:!1}))}})(),()=>{t=!0,n&&clearTimeout(n)}},[e,r]);let o=()=>{a({isReady:!1,isLoading:!0,error:null,hasTimedOut:!1})};return{...i,retry:o}}

package/dist/src/core/islands/island-persistence.d.ts

@@ -1,74 +0,0 @@
-import type { IslandState } from '../../schemas/layout.ts';
-import type { IIslandPersistence } from '../../types/layout.ts';
-/**
- * IslandPersistence class for state management across navigation
- *
- * Handles saving, loading, and clearing island state using browser storage
- * with support for both sessionStorage and localStorage persistence strategies.
- */
-export declare class IslandPersistence implements IIslandPersistence {
-    private storageType;
-    private keyPrefix;
-    private storage;
-    constructor(options?: {
-        storageType?: 'session' | 'local';
-        keyPrefix?: string;
-    });
-    /**
-     * Save island state to browser storage
-     */
-    saveState(id: string, state: IslandState): void;
-    /**
-     * Load island state from browser storage
-     */
-    loadState(id: string): IslandState | null;
-    /**
-     * Clear island state from browser storage
-     */
-    clearState(id: string): void;
-    /**
-     * Check if state exists for an island
-     */
-    hasState(id: string): boolean;
-    /**
-     * Get all stored island IDs
-     */
-    getStoredIds(): string[];
-    /**
-     * Clear all stored states
-     */
-    clearAllStates(): void;
-    /**
-     * Get the storage key for an island ID
-     */
-    private getStorageKey;
-    /**
-     * Get current storage configuration
-     */
-    getConfig(): {
-        storageType: string;
-        keyPrefix: string;
-        available: boolean;
-    };
-    /**
-     * Get storage usage statistics
-     */
-    getStorageStats(): {
-        totalKeys: number;
-        islandKeys: number;
-        estimatedSize: number;
-    };
-    /**
-     * JSON.stringify replacer function to handle special types
-     */
-    private replacer;
-    /**
-     * JSON.parse reviver function to restore special types
-     */
-    private reviver;
-}
-/**
- * Default island persistence instance
- * Uses sessionStorage by default for better privacy and performance
- */
-export declare const defaultIslandPersistence: IslandPersistence;

package/dist/src/core/islands/island-persistence.js

@@ -1 +0,0 @@
-import{IslandStateSerializer as e}from"./island-state-serializer.js";export class IslandPersistence{storageType;keyPrefix;storage=null;constructor(e={}){this.storageType=e.storageType||`session`,this.keyPrefix=e.keyPrefix||`island-state`,typeof window<`u`&&(this.storage=this.storageType===`session`?sessionStorage:localStorage)}saveState(t,n){if(!this.storage){console.warn(`Island persistence: Storage not available (server-side or unsupported browser)`);return}try{let r=this.getStorageKey(t),i=e.serialize({state:n,timestamp:Date.now(),version:`1.0`});this.storage.setItem(r,i),console.log(`Island state saved for ${t}`)}catch(e){console.error(`Failed to save island state for ${t}:`,e)}}loadState(t){if(!this.storage)return console.warn(`Island persistence: Storage not available (server-side or unsupported browser)`),null;try{let n=this.getStorageKey(t),r=this.storage.getItem(n);if(!r)return null;let i=e.deserialize(r);return!i.state||!i.timestamp||!i.version?(console.warn(`Invalid island state format for ${t}, clearing...`),this.clearState(t),null):(console.log(`Island state loaded for ${t}`),i.state)}catch(e){return console.error(`Failed to load island state for ${t}:`,e),this.clearState(t),null}}clearState(e){if(this.storage)try{let t=this.getStorageKey(e);this.storage.removeItem(t),console.log(`Island state cleared for ${e}`)}catch(t){console.error(`Failed to clear island state for ${e}:`,t)}}hasState(e){if(!this.storage)return!1;try{let t=this.getStorageKey(e);return this.storage.getItem(t)!==null}catch(t){return console.error(`Failed to check island state for ${e}:`,t),!1}}getStoredIds(){if(!this.storage)return[];try{let e=[],t=this.keyPrefix.length+1;for(let n=0;n<this.storage.length;n++){let r=this.storage.key(n);r&&r.startsWith(this.keyPrefix+`:`)&&e.push(r.substring(t))}return e}catch(e){return console.error(`Failed to get stored island IDs:`,e),[]}}clearAllStates(){if(this.storage)try{let e=[];for(let t=0;t<this.storage.length;t++){let n=this.storage.key(t);n&&n.startsWith(this.keyPrefix+`:`)&&e.push(n)}e.forEach(e=>this.storage.removeItem(e)),console.log(`Cleared ${e.length} island states`)}catch(e){console.error(`Failed to clear all island states:`,e)}}getStorageKey(e){return`${this.keyPrefix}:${e}`}getConfig(){return{storageType:this.storageType,keyPrefix:this.keyPrefix,available:this.storage!==null}}getStorageStats(){if(!this.storage)return{totalKeys:0,islandKeys:0,estimatedSize:0};try{let e=0,t=0;for(let n=0;n<this.storage.length;n++){let r=this.storage.key(n);if(r&&r.startsWith(this.keyPrefix+`:`)){e++;let n=this.storage.getItem(r);n&&(t+=r.length+n.length)}}return{totalKeys:this.storage.length,islandKeys:e,estimatedSize:t}}catch(e){return console.error(`Failed to get storage stats:`,e),{totalKeys:0,islandKeys:0,estimatedSize:0}}}replacer(e,t){return t instanceof Date?{__type:`Date`,__value:t.toISOString()}:t instanceof RegExp?{__type:`RegExp`,__value:{source:t.source,flags:t.flags}}:t instanceof Map?{__type:`Map`,__value:Array.from(t.entries())}:t instanceof Set?{__type:`Set`,__value:Array.from(t.values())}:typeof t==`function`?(console.warn(`Function found in island state at key "${e}", converting to null`),null):t===void 0?null:t}reviver(e,t){if(t&&typeof t==`object`){let e=t;if(e.__type&&e.__value!==void 0)switch(e.__type){case`Date`:return new Date(e.__value);case`RegExp`:{let t=e.__value;return new RegExp(t.source,t.flags)}case`Map`:return new Map(e.__value);case`Set`:return new Set(e.__value);default:return console.warn(`Unknown special type "${e.__type}" in serialized state`),e.__value}}return t}}export const defaultIslandPersistence=new IslandPersistence({storageType:`session`,keyPrefix:`island-state`});

package/dist/src/core/islands/island-state-serializer.d.ts

@@ -1,53 +0,0 @@
-import type { IslandState } from '../../schemas/layout.ts';
-/**
- * Island State Serializer
- *
- * Handles serialization and deserialization of island state for browser storage.
- * Supports complex data types including Dates, RegExp, and circular references.
- */
-export declare class IslandStateSerializer {
-    /**
-     * Serialize island state to JSON string
-     */
-    static serialize(state: IslandState): string;
-    /**
-     * Deserialize JSON string to island state
-     */
-    static deserialize(serializedState: string): IslandState;
-    /**
-     * Transform state for serialization, handling special types
-     */
-    private static transformForSerialization;
-    /**
-     * JSON.parse reviver function to restore special types
-     */
-    private static reviver;
-    /**
-     * Validate that state can be safely serialized
-     */
-    static validate(state: IslandState): {
-        valid: boolean;
-        errors: string[];
-    };
-    /**
-     * Get size information for serialized state
-     */
-    static getSize(state: IslandState): {
-        bytes: number;
-        kilobytes: number;
-        megabytes: number;
-        readable: string;
-    };
-    /**
-     * Deep clone state object (useful for preventing mutations)
-     */
-    static clone(state: IslandState): IslandState;
-    /**
-     * Compare two states for equality
-     */
-    static equals(state1: IslandState, state2: IslandState): boolean;
-    /**
-     * Sanitize state by removing non-serializable values
-     */
-    static sanitize(state: IslandState): IslandState;
-}

package/dist/src/core/islands/island-state-serializer.js

@@ -1 +0,0 @@
-export class IslandStateSerializer{static serialize(t){try{let n=IslandStateSerializer.transformForSerialization(t);return JSON.stringify(n)}catch(e){throw console.error(`Failed to serialize island state:`,e),Error(`State serialization failed: ${e instanceof Error?e.message:String(e)}`)}}static deserialize(t){try{return JSON.parse(t,IslandStateSerializer.reviver)}catch(e){throw console.error(`Failed to deserialize island state:`,e),Error(`State deserialization failed: ${e instanceof Error?e.message:String(e)}`)}}static transformForSerialization(t){if(t===null)return t;if(t===void 0)return null;if(t instanceof Date)return{__type:`Date`,__value:t.toISOString()};if(t instanceof RegExp)return{__type:`RegExp`,__value:{source:t.source,flags:t.flags}};if(t instanceof Map)return{__type:`Map`,__value:Array.from(t.entries()).map(([t,n])=>[IslandStateSerializer.transformForSerialization(t),IslandStateSerializer.transformForSerialization(n)])};if(t instanceof Set)return{__type:`Set`,__value:Array.from(t.values()).map(t=>IslandStateSerializer.transformForSerialization(t))};if(typeof t==`function`)return console.warn(`Function found in island state, converting to null`),null;if(Array.isArray(t))return t.map(t=>IslandStateSerializer.transformForSerialization(t));if(typeof t==`object`){let n={},r=t;for(let t in r)Object.hasOwn(r,t)&&(n[t]=IslandStateSerializer.transformForSerialization(r[t]));return n}return t}static reviver(e,t){if(t&&typeof t==`object`){let e=t;if(e.__type&&e.__value!==void 0)switch(e.__type){case`Date`:return new Date(e.__value);case`RegExp`:{let t=e.__value;return new RegExp(t.source,t.flags)}case`Map`:return new Map(e.__value);case`Set`:return new Set(e.__value);case`undefined`:return null;default:return console.warn(`Unknown special type "${typeof e.__type==`string`?e.__type:`non-string`}" in serialized state`),e.__value}}return t}static validate(e){let t=[];try{let n=this.serialize(e),r=new Blob([n]).size,i=5*1024*1024;r>i&&t.push(`Serialized state size (${Math.round(r/1024)}KB) exceeds recommended limit (${Math.round(i/1024)}KB)`),this.deserialize(n)}catch(e){t.push(e instanceof Error?e.message:String(e))}return{valid:t.length===0,errors:t}}static getSize(e){try{let t=this.serialize(e),n=new Blob([t]).size,r=n/1024,i=r/1024,a;return a=i>=1?`${i.toFixed(2)} MB`:r>=1?`${r.toFixed(2)} KB`:`${n} bytes`,{bytes:n,kilobytes:r,megabytes:i,readable:a}}catch(e){return console.error(`Failed to calculate state size:`,e),{bytes:0,kilobytes:0,megabytes:0,readable:`0 bytes`}}}static clone(e){try{let t=this.serialize(e);return this.deserialize(t)}catch(t){return console.error(`Failed to clone island state:`,t),{...e}}}static equals(e,t){try{return this.serialize(e)===this.serialize(t)}catch(e){return console.error(`Failed to compare island states:`,e),!1}}static sanitize(e){try{let t=this.serialize(e);return this.deserialize(t)}catch(e){return console.error(`Failed to sanitize island state:`,e),{}}}}

package/dist/src/core/islands/persistent-island-context.d.ts

@@ -1,36 +0,0 @@
-import type { ComponentChildren } from 'preact';
-import type { IslandState } from '../../schemas/layout.ts';
-import { defaultIslandPersistence } from './island-persistence.ts';
-/**
- * Explicit interface for persistent island context
- * (Zod z.any() inference for function types is unreliable)
- */
-export interface PersistentIslandContextType {
-    saveState: (state: IslandState) => void;
-    loadState: () => IslandState | null;
-    clearState: () => void;
-}
-/**
- * Context for persistent island state operations
- *
- * Provides save, load, and clear operations for island state management
- * across navigation and browser sessions.
- */
-export declare const PersistentIslandContextProvider: import("preact").Context<PersistentIslandContextType>;
-/**
- * Create a persistent island context for a specific island ID
- */
-export declare function createPersistentIslandContext(persistentId: string, persistence?: import("./island-persistence.ts").IslandPersistence): PersistentIslandContextType;
-/**
- * Hook to use persistent island context
- * Must be used within a PersistentIsland component
- */
-export declare function usePersistentIslandContext(): PersistentIslandContextType;
-/**
- * Provider component for persistent island context
- */
-export declare function PersistentIslandProvider({ persistentId, children, persistence, }: Readonly<{
-    persistentId: string;
-    children: ComponentChildren;
-    persistence?: typeof defaultIslandPersistence;
-}>): import("preact").JSX.Element;

package/dist/src/core/islands/persistent-island-context.js

@@ -1 +0,0 @@
-import{createContext as e}from"preact";import{useContext as t}from"preact/hooks";import{defaultIslandPersistence as n}from"./island-persistence.js";import{jsx as r}from"preact/jsx-runtime";export const PersistentIslandContextProvider=e(null);export function createPersistentIslandContext(e,t=n){return{saveState:n=>{t.saveState(e,n)},loadState:()=>t.loadState(e),clearState:()=>{t.clearState(e)}}}export function usePersistentIslandContext(){let e=t(PersistentIslandContextProvider);if(!e)throw Error(`usePersistentIslandContext must be used within a PersistentIsland component`);return e}export function PersistentIslandProvider({persistentId:e,children:t,persistence:i=n}){let a=createPersistentIslandContext(e,i);return r(PersistentIslandContextProvider.Provider,{value:a,children:t})}

package/dist/src/core/islands/use-persistent-state.d.ts

@@ -1,17 +0,0 @@
-/**
- * Hook for persistent island state — like useState but survives navigations.
- *
- * State is serialized to sessionStorage (supports Date, Map, Set, RegExp).
- * On the server or when storage is unavailable, falls back to in-memory state.
- *
- * ```tsx
- * const [count, setCount, clearCount] = usePersistentState('my-counter', 0);
- * ```
- *
- * @param id - Unique storage key for this piece of state
- * @param initialValue - Default value when no persisted state exists
- * @param options - Optional: `storage` ('session' | 'local'), defaults to 'session'
- */
-export declare function usePersistentState<T>(id: string, initialValue: T, options?: {
-    storage?: 'session' | 'local';
-}): [T, (value: T | ((prev: T) => T)) => void, () => void];

package/dist/src/core/islands/use-persistent-state.js

@@ -1 +0,0 @@
-import{useState as e,useEffect as t,useCallback as n}from"preact/hooks";import{IslandStateSerializer as r}from"./island-state-serializer.js";export function usePersistentState(i,a,o){let s=o?.storage??`session`,c=`avalon-island:${i}`,[l,u]=e(()=>{if(typeof window>`u`)return a;try{let e=(s===`local`?localStorage:sessionStorage).getItem(c);return e===null?a:r.deserialize(e).v??a}catch{return a}});return t(()=>{if(!(typeof window>`u`))try{(s===`local`?localStorage:sessionStorage).setItem(c,r.serialize({v:l}))}catch{}},[l,c,s]),[l,n(e=>{u(t=>typeof e==`function`?e(t):e)},[]),n(()=>{if(u(a),!(typeof window>`u`))try{(s===`local`?localStorage:sessionStorage).removeItem(c)}catch{}},[a,c,s])]}