@getforma/core 0.3.0 → 0.6.1

package/dist/index.d.cts

@@ -16,6 +16,11 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
 /**
  * Create a lazy, cached computed value.
  *
+ * Note: Unlike SolidJS's createComputed (which is an eager synchronous
+ * side effect), this is a lazy cached derivation — equivalent to
+ * SolidJS's createMemo. Both createComputed and createMemo in FormaJS
+ * are identical.
+ *
  * ```ts
  * const [count, setCount] = createSignal(0);
  * const doubled = createComputed(() => count() * 2);
@@ -39,6 +44,11 @@ declare function createComputed<T>(fn: () => T): () => T;
  * Create a memoized computed value.
  * Identical to `createComputed` — provided for React/SolidJS familiarity.
  *
+ * Note: Unlike SolidJS's createComputed (which is an eager synchronous
+ * side effect), both createComputed and createMemo in FormaJS are lazy
+ * cached derivations — equivalent to SolidJS's createMemo. They are
+ * identical.
+ *
  * The computation runs lazily and caches the result. It only recomputes
  * when a signal it reads during computation changes.
  *
@@ -380,6 +390,7 @@ declare function cleanup(el: Element): void;
  * )
  * ```
  */
+declare function h(tag: (props: Record<string, unknown>) => unknown, props?: Record<string, unknown> | null, ...children: unknown[]): Node;
 declare function h(tag: typeof Fragment, props?: null, ...children: unknown[]): DocumentFragment;
 declare function h(tag: string, props?: Record<string, unknown> | null, ...children: unknown[]): HTMLElement;
 /**
@@ -473,12 +484,6 @@ interface CreateListOptions {
      */
     updateOnItemChange?: 'none' | 'rerender';
 }
-/**
- * Find the longest increasing subsequence.
- * Returns indices into the input array.
- * O(n log n) time, O(n) space.
- */
-declare function longestIncreasingSubsequence(arr: number[]): number[];
 /**
  * Reconcile a DOM parent's children to match a new array of items.
  * Uses keyed reconciliation with LIS for minimum DOM operations.
@@ -712,8 +717,20 @@ declare function hydrateIsland(component: () => unknown, target: Element): Eleme
  * loads props (inline or script_tag), and hydrates each island inside
  * an independent createRoot scope with try/catch error isolation.
  */
-/** Function that creates a component's DOM tree (same for CSR and hydration). */
-type IslandHydrateFn = (props: Record<string, unknown> | null) => unknown;
+/**
+ * Function that hydrates an island.
+ *
+ * @param el     The root element of the island (`[data-forma-island]`).
+ *               Useful for layout measurement, focus management, CSS class
+ *               toggling, third-party library init, or reading extra `data-*`
+ *               attributes from the server-rendered shell.
+ * @param props  Parsed props from `data-forma-props` (inline or script block),
+ *               or `null` if no props were provided.
+ * @returns      A component tree (from `h()` calls) for descriptor-based
+ *               hydration, or `undefined` for imperative islands that set up
+ *               their own effects.
+ */
+type IslandHydrateFn = (el: HTMLElement, props: Record<string, unknown> | null) => unknown;
 /**
  * Discover and activate all SSR-rendered islands on the page.
  *
@@ -723,6 +740,21 @@ type IslandHydrateFn = (props: Record<string, unknown> | null) => unknown;
  * @param registry  Map of component names to hydration functions.
  */
 declare function activateIslands(registry: Record<string, IslandHydrateFn>): void;
+/**
+ * Dispose a single island, tearing down its reactive root and all effects.
+ *
+ * Safe to call multiple times (idempotent). Sets `data-forma-status` to
+ * `"disposed"` so the island can be distinguished from active/error states.
+ */
+declare function deactivateIsland(el: HTMLElement): void;
+/**
+ * Dispose ALL active islands under a root element (or the whole document).
+ *
+ * Use this when swapping module content — e.g., replacing the contents of
+ * a `<forma-stage>` Shadow DOM during AI generation. Prevents leaked effects
+ * and event listeners from accumulating across swaps.
+ */
+declare function deactivateAllIslands(root?: Element | Document): void;
 
 /**
  * Forma Component - Define
@@ -924,6 +956,8 @@ interface PersistOptions<T> {
     serialize?: (v: T) => string;
     /** Custom deserializer. Defaults to JSON.parse. */
     deserialize?: (s: string) => T;
+    /** Optional validator — return true if the deserialized value is valid. Rejects corrupt/tampered data. */
+    validate?: (v: unknown) => v is T;
 }
 /**
  * Persist a signal's value to storage.
@@ -940,14 +974,14 @@ interface PersistOptions<T> {
  */
 declare function persist<T>(source: [get: () => T, set: (v: T) => void], key: string, options?: PersistOptions<T>): void;
 
-interface EventBus<T extends Record<string, any>> {
+interface EventBus<T extends Record<string, unknown>> {
     on<K extends keyof T>(event: K, handler: (payload: T[K]) => void): () => void;
     once<K extends keyof T>(event: K, handler: (payload: T[K]) => void): () => void;
     emit<K extends keyof T>(event: K, payload: T[K]): void;
     off<K extends keyof T>(event: K, handler: (payload: T[K]) => void): void;
     clear(): void;
 }
-declare function createBus<T extends Record<string, any> = Record<string, any>>(): EventBus<T>;
+declare function createBus<T extends Record<string, unknown> = Record<string, unknown>>(): EventBus<T>;
 
 declare function delegate<K extends keyof HTMLElementEventMap>(container: HTMLElement | Document, selector: string, event: K, handler: (e: HTMLElementEventMap[K], matchedEl: HTMLElement) => void, options?: AddEventListenerOptions): () => void;
 
@@ -967,7 +1001,22 @@ declare function toggleClass(el: HTMLElement, className: string, force?: boolean
 declare function setStyle(el: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
 declare function setAttr(el: HTMLElement, attrs: Record<string, string | boolean | null>): void;
 declare function setText(el: HTMLElement, text: string): void;
+/**
+ * Set raw HTML on an element. **No sanitization is performed.**
+ *
+ * Prefer `setText()` for user-controlled content. Only use this when you
+ * trust the HTML source (e.g., server-rendered markup you control).
+ *
+ * @deprecated Use `setHTMLUnsafe` instead — renamed to signal risk.
+ */
 declare function setHTML(el: HTMLElement, html: string): void;
+/**
+ * Set raw HTML on an element. **No sanitization is performed.**
+ *
+ * Prefer `setText()` for user-controlled content. Only use this when you
+ * trust the HTML source (e.g., server-rendered markup you control).
+ */
+declare function setHTMLUnsafe(el: HTMLElement, html: string): void;
 
 declare function closest<T extends HTMLElement = HTMLElement>(el: HTMLElement, selector: string): T | null;
 declare function children<T extends HTMLElement = HTMLElement>(el: HTMLElement, selector?: string): T[];
@@ -980,22 +1029,26 @@ declare function onResize(el: HTMLElement, handler: (entry: ResizeObserverEntry)
 declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObserverEntry) => void, options?: IntersectionObserverInit): () => void;
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-/**
- * Forma Storage - Local
- *
- * Typed localStorage wrapper with graceful error handling.
- * Zero dependencies — native browser APIs only.
- */
-interface TypedStorage$1<T> {
+interface TypedStorage<T> {
     get(): T | null;
     set(value: T): void;
     remove(): void;
     key: string;
 }
-interface StorageOptions$1<T> {
+interface StorageOptions<T> {
     serialize?: (v: T) => string;
     deserialize?: (s: string) => T;
+    /** Optional validator — return true if the deserialized value is valid. */
+    validate?: (v: unknown) => v is T;
 }
+
+/**
+ * Forma Storage - Local
+ *
+ * Typed localStorage wrapper with graceful error handling.
+ * Zero dependencies — native browser APIs only.
+ */
+
 /**
  * Create a typed localStorage wrapper for the given key.
  *
@@ -1006,7 +1059,7 @@ interface StorageOptions$1<T> {
  * store.remove();
  * ```
  */
-declare function createLocalStorage<T>(key: string, options?: StorageOptions$1<T>): TypedStorage$1<T>;
+declare function createLocalStorage<T>(key: string, options?: StorageOptions<T>): TypedStorage<T>;
 
 /**
  * Forma Storage - Session
@@ -1014,16 +1067,7 @@ declare function createLocalStorage<T>(key: string, options?: StorageOptions$1<T
  * Typed sessionStorage wrapper with graceful error handling.
  * Zero dependencies — native browser APIs only.
  */
-interface TypedStorage<T> {
-    get(): T | null;
-    set(value: T): void;
-    remove(): void;
-    key: string;
-}
-interface StorageOptions<T> {
-    serialize?: (v: T) => string;
-    deserialize?: (s: string) => T;
-}
+
 /**
  * Create a typed sessionStorage wrapper for the given key.
  *
@@ -1106,9 +1150,11 @@ declare function fetchJSON<T>(url: string, options?: RequestInit): Promise<T>;
  * Reactive SSE wrapper with signal integration.
  * Zero dependencies — native browser APIs only.
  */
-interface SSEOptions {
+interface SSEOptions<T = unknown> {
     withCredentials?: boolean;
     headers?: Record<string, string>;
+    /** Custom parser for incoming messages. Defaults to JSON.parse with raw data fallback. */
+    parse?: (data: string) => T;
 }
 interface SSEConnection<T = unknown> {
     data: () => T | null;
@@ -1128,7 +1174,7 @@ interface SSEConnection<T = unknown> {
  * });
  * ```
  */
-declare function createSSE<T = unknown>(url: string, options?: SSEOptions): SSEConnection<T>;
+declare function createSSE<T = unknown>(url: string, options?: SSEOptions<T>): SSEConnection<T>;
 
 /**
  * Forma HTTP - WebSocket
@@ -1137,11 +1183,13 @@ declare function createSSE<T = unknown>(url: string, options?: SSEOptions): SSEC
  * Zero dependencies — native browser APIs only.
  */
 type WSStatus = 'connecting' | 'open' | 'closed' | 'error';
-interface WSOptions {
+interface WSOptions<TReceive = unknown> {
     protocols?: string | string[];
     reconnect?: boolean;
     reconnectInterval?: number;
     maxReconnects?: number;
+    /** Custom parser for incoming messages. Defaults to JSON.parse with raw data fallback. */
+    parse?: (data: string) => TReceive;
 }
 interface WSConnection<TSend = unknown, TReceive = unknown> {
     data: () => TReceive | null;
@@ -1162,7 +1210,7 @@ interface WSConnection<TSend = unknown, TReceive = unknown> {
  * });
  * ```
  */
-declare function createWebSocket<TSend = unknown, TReceive = unknown>(url: string, options?: WSOptions): WSConnection<TSend, TReceive>;
+declare function createWebSocket<TSend = unknown, TReceive = unknown>(url: string, options?: WSOptions<TReceive>): WSConnection<TSend, TReceive>;
 
 /**
  * FormaJS Server - Action
@@ -1327,7 +1375,7 @@ declare function withRevalidation<T>(data: T, revalidate: Record<string, unknown
  * @param endpoint - The RPC endpoint path (e.g. "/rpc/createTodo_a1b2c3")
  * @returns An async function that sends args to the server and returns the result
  */
-declare function $$serverFunction<T extends (...args: any[]) => Promise<any>>(endpoint: string): T;
+declare function $$serverFunction<T extends (...args: unknown[]) => Promise<unknown>>(endpoint: string): T;
 
 /**
  * FormaJS Server - RPC Handler
@@ -1391,4 +1439,4 @@ declare function renderLocal(slotsJson: string): Promise<string>;
 /** Fragment render (single island) via WASM. */
 declare function renderIsland(slotsJson: string, islandId: number): Promise<string>;
 
-export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, longestIncreasingSubsequence, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };
+export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };

package/dist/index.d.ts

@@ -16,6 +16,11 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
 /**
  * Create a lazy, cached computed value.
  *
+ * Note: Unlike SolidJS's createComputed (which is an eager synchronous
+ * side effect), this is a lazy cached derivation — equivalent to
+ * SolidJS's createMemo. Both createComputed and createMemo in FormaJS
+ * are identical.
+ *
  * ```ts
  * const [count, setCount] = createSignal(0);
  * const doubled = createComputed(() => count() * 2);
@@ -39,6 +44,11 @@ declare function createComputed<T>(fn: () => T): () => T;
  * Create a memoized computed value.
  * Identical to `createComputed` — provided for React/SolidJS familiarity.
  *
+ * Note: Unlike SolidJS's createComputed (which is an eager synchronous
+ * side effect), both createComputed and createMemo in FormaJS are lazy
+ * cached derivations — equivalent to SolidJS's createMemo. They are
+ * identical.
+ *
  * The computation runs lazily and caches the result. It only recomputes
  * when a signal it reads during computation changes.
  *
@@ -380,6 +390,7 @@ declare function cleanup(el: Element): void;
  * )
  * ```
  */
+declare function h(tag: (props: Record<string, unknown>) => unknown, props?: Record<string, unknown> | null, ...children: unknown[]): Node;
 declare function h(tag: typeof Fragment, props?: null, ...children: unknown[]): DocumentFragment;
 declare function h(tag: string, props?: Record<string, unknown> | null, ...children: unknown[]): HTMLElement;
 /**
@@ -473,12 +484,6 @@ interface CreateListOptions {
      */
     updateOnItemChange?: 'none' | 'rerender';
 }
-/**
- * Find the longest increasing subsequence.
- * Returns indices into the input array.
- * O(n log n) time, O(n) space.
- */
-declare function longestIncreasingSubsequence(arr: number[]): number[];
 /**
  * Reconcile a DOM parent's children to match a new array of items.
  * Uses keyed reconciliation with LIS for minimum DOM operations.
@@ -712,8 +717,20 @@ declare function hydrateIsland(component: () => unknown, target: Element): Eleme
  * loads props (inline or script_tag), and hydrates each island inside
  * an independent createRoot scope with try/catch error isolation.
  */
-/** Function that creates a component's DOM tree (same for CSR and hydration). */
-type IslandHydrateFn = (props: Record<string, unknown> | null) => unknown;
+/**
+ * Function that hydrates an island.
+ *
+ * @param el     The root element of the island (`[data-forma-island]`).
+ *               Useful for layout measurement, focus management, CSS class
+ *               toggling, third-party library init, or reading extra `data-*`
+ *               attributes from the server-rendered shell.
+ * @param props  Parsed props from `data-forma-props` (inline or script block),
+ *               or `null` if no props were provided.
+ * @returns      A component tree (from `h()` calls) for descriptor-based
+ *               hydration, or `undefined` for imperative islands that set up
+ *               their own effects.
+ */
+type IslandHydrateFn = (el: HTMLElement, props: Record<string, unknown> | null) => unknown;
 /**
  * Discover and activate all SSR-rendered islands on the page.
  *
@@ -723,6 +740,21 @@ type IslandHydrateFn = (props: Record<string, unknown> | null) => unknown;
  * @param registry  Map of component names to hydration functions.
  */
 declare function activateIslands(registry: Record<string, IslandHydrateFn>): void;
+/**
+ * Dispose a single island, tearing down its reactive root and all effects.
+ *
+ * Safe to call multiple times (idempotent). Sets `data-forma-status` to
+ * `"disposed"` so the island can be distinguished from active/error states.
+ */
+declare function deactivateIsland(el: HTMLElement): void;
+/**
+ * Dispose ALL active islands under a root element (or the whole document).
+ *
+ * Use this when swapping module content — e.g., replacing the contents of
+ * a `<forma-stage>` Shadow DOM during AI generation. Prevents leaked effects
+ * and event listeners from accumulating across swaps.
+ */
+declare function deactivateAllIslands(root?: Element | Document): void;
 
 /**
  * Forma Component - Define
@@ -924,6 +956,8 @@ interface PersistOptions<T> {
     serialize?: (v: T) => string;
     /** Custom deserializer. Defaults to JSON.parse. */
     deserialize?: (s: string) => T;
+    /** Optional validator — return true if the deserialized value is valid. Rejects corrupt/tampered data. */
+    validate?: (v: unknown) => v is T;
 }
 /**
  * Persist a signal's value to storage.
@@ -940,14 +974,14 @@ interface PersistOptions<T> {
  */
 declare function persist<T>(source: [get: () => T, set: (v: T) => void], key: string, options?: PersistOptions<T>): void;
 
-interface EventBus<T extends Record<string, any>> {
+interface EventBus<T extends Record<string, unknown>> {
     on<K extends keyof T>(event: K, handler: (payload: T[K]) => void): () => void;
     once<K extends keyof T>(event: K, handler: (payload: T[K]) => void): () => void;
     emit<K extends keyof T>(event: K, payload: T[K]): void;
     off<K extends keyof T>(event: K, handler: (payload: T[K]) => void): void;
     clear(): void;
 }
-declare function createBus<T extends Record<string, any> = Record<string, any>>(): EventBus<T>;
+declare function createBus<T extends Record<string, unknown> = Record<string, unknown>>(): EventBus<T>;
 
 declare function delegate<K extends keyof HTMLElementEventMap>(container: HTMLElement | Document, selector: string, event: K, handler: (e: HTMLElementEventMap[K], matchedEl: HTMLElement) => void, options?: AddEventListenerOptions): () => void;
 
@@ -967,7 +1001,22 @@ declare function toggleClass(el: HTMLElement, className: string, force?: boolean
 declare function setStyle(el: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
 declare function setAttr(el: HTMLElement, attrs: Record<string, string | boolean | null>): void;
 declare function setText(el: HTMLElement, text: string): void;
+/**
+ * Set raw HTML on an element. **No sanitization is performed.**
+ *
+ * Prefer `setText()` for user-controlled content. Only use this when you
+ * trust the HTML source (e.g., server-rendered markup you control).
+ *
+ * @deprecated Use `setHTMLUnsafe` instead — renamed to signal risk.
+ */
 declare function setHTML(el: HTMLElement, html: string): void;
+/**
+ * Set raw HTML on an element. **No sanitization is performed.**
+ *
+ * Prefer `setText()` for user-controlled content. Only use this when you
+ * trust the HTML source (e.g., server-rendered markup you control).
+ */
+declare function setHTMLUnsafe(el: HTMLElement, html: string): void;
 
 declare function closest<T extends HTMLElement = HTMLElement>(el: HTMLElement, selector: string): T | null;
 declare function children<T extends HTMLElement = HTMLElement>(el: HTMLElement, selector?: string): T[];
@@ -980,22 +1029,26 @@ declare function onResize(el: HTMLElement, handler: (entry: ResizeObserverEntry)
 declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObserverEntry) => void, options?: IntersectionObserverInit): () => void;
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-/**
- * Forma Storage - Local
- *
- * Typed localStorage wrapper with graceful error handling.
- * Zero dependencies — native browser APIs only.
- */
-interface TypedStorage$1<T> {
+interface TypedStorage<T> {
     get(): T | null;
     set(value: T): void;
     remove(): void;
     key: string;
 }
-interface StorageOptions$1<T> {
+interface StorageOptions<T> {
     serialize?: (v: T) => string;
     deserialize?: (s: string) => T;
+    /** Optional validator — return true if the deserialized value is valid. */
+    validate?: (v: unknown) => v is T;
 }
+
+/**
+ * Forma Storage - Local
+ *
+ * Typed localStorage wrapper with graceful error handling.
+ * Zero dependencies — native browser APIs only.
+ */
+
 /**
  * Create a typed localStorage wrapper for the given key.
  *
@@ -1006,7 +1059,7 @@ interface StorageOptions$1<T> {
  * store.remove();
  * ```
  */
-declare function createLocalStorage<T>(key: string, options?: StorageOptions$1<T>): TypedStorage$1<T>;
+declare function createLocalStorage<T>(key: string, options?: StorageOptions<T>): TypedStorage<T>;
 
 /**
  * Forma Storage - Session
@@ -1014,16 +1067,7 @@ declare function createLocalStorage<T>(key: string, options?: StorageOptions$1<T
  * Typed sessionStorage wrapper with graceful error handling.
  * Zero dependencies — native browser APIs only.
  */
-interface TypedStorage<T> {
-    get(): T | null;
-    set(value: T): void;
-    remove(): void;
-    key: string;
-}
-interface StorageOptions<T> {
-    serialize?: (v: T) => string;
-    deserialize?: (s: string) => T;
-}
+
 /**
  * Create a typed sessionStorage wrapper for the given key.
  *
@@ -1106,9 +1150,11 @@ declare function fetchJSON<T>(url: string, options?: RequestInit): Promise<T>;
  * Reactive SSE wrapper with signal integration.
  * Zero dependencies — native browser APIs only.
  */
-interface SSEOptions {
+interface SSEOptions<T = unknown> {
     withCredentials?: boolean;
     headers?: Record<string, string>;
+    /** Custom parser for incoming messages. Defaults to JSON.parse with raw data fallback. */
+    parse?: (data: string) => T;
 }
 interface SSEConnection<T = unknown> {
     data: () => T | null;
@@ -1128,7 +1174,7 @@ interface SSEConnection<T = unknown> {
  * });
  * ```
  */
-declare function createSSE<T = unknown>(url: string, options?: SSEOptions): SSEConnection<T>;
+declare function createSSE<T = unknown>(url: string, options?: SSEOptions<T>): SSEConnection<T>;
 
 /**
  * Forma HTTP - WebSocket
@@ -1137,11 +1183,13 @@ declare function createSSE<T = unknown>(url: string, options?: SSEOptions): SSEC
  * Zero dependencies — native browser APIs only.
  */
 type WSStatus = 'connecting' | 'open' | 'closed' | 'error';
-interface WSOptions {
+interface WSOptions<TReceive = unknown> {
     protocols?: string | string[];
     reconnect?: boolean;
     reconnectInterval?: number;
     maxReconnects?: number;
+    /** Custom parser for incoming messages. Defaults to JSON.parse with raw data fallback. */
+    parse?: (data: string) => TReceive;
 }
 interface WSConnection<TSend = unknown, TReceive = unknown> {
     data: () => TReceive | null;
@@ -1162,7 +1210,7 @@ interface WSConnection<TSend = unknown, TReceive = unknown> {
  * });
  * ```
  */
-declare function createWebSocket<TSend = unknown, TReceive = unknown>(url: string, options?: WSOptions): WSConnection<TSend, TReceive>;
+declare function createWebSocket<TSend = unknown, TReceive = unknown>(url: string, options?: WSOptions<TReceive>): WSConnection<TSend, TReceive>;
 
 /**
  * FormaJS Server - Action
@@ -1327,7 +1375,7 @@ declare function withRevalidation<T>(data: T, revalidate: Record<string, unknown
  * @param endpoint - The RPC endpoint path (e.g. "/rpc/createTodo_a1b2c3")
  * @returns An async function that sends args to the server and returns the result
  */
-declare function $$serverFunction<T extends (...args: any[]) => Promise<any>>(endpoint: string): T;
+declare function $$serverFunction<T extends (...args: unknown[]) => Promise<unknown>>(endpoint: string): T;
 
 /**
  * FormaJS Server - RPC Handler
@@ -1391,4 +1439,4 @@ declare function renderLocal(slotsJson: string): Promise<string>;
 /** Fragment render (single island) via WASM. */
 declare function renderIsland(slotsJson: string, islandId: number): Promise<string>;
 
-export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, longestIncreasingSubsequence, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };
+export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };