@ikonai/sdk-ui 0.0.28 → 0.0.29

package/handler-cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Cache for event handlers to avoid creating new closures on every render.
+ * Handlers are cached by nodeId and actionId combination.
+ */
+export declare class HandlerCache {
+    private readonly cache;
+    /**
+     * Get a cached void handler (no payload) for a node/action combination.
+     * Creates and caches the handler if it doesn't exist.
+     */
+    getHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): () => void;
+    /**
+     * Get a cached handler that accepts a payload.
+     * Creates and caches the handler if it doesn't exist.
+     */
+    getHandlerWithPayload<T>(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (payload: T) => void;
+    /**
+     * Get a cached handler for boolean payloads.
+     */
+    getBooleanHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (value: boolean) => void;
+    /**
+     * Get a cached handler for string payloads.
+     */
+    getStringHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (value: string) => void;
+    /**
+     * Get a cached handler for number payloads.
+     */
+    getNumberHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (value: number) => void;
+    /**
+     * Get a cached handler for number array payloads.
+     */
+    getNumberArrayHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (value: number[]) => void;
+    /**
+     * Get a cached handler for nullable boolean payloads.
+     */
+    getNullableBooleanHandler(nodeId: string, actionId: string, dispatchAction: (actionId: string, payload?: unknown) => void): (value: boolean | null | undefined) => void;
+    /**
+     * Invalidate all cached handlers for a specific node.
+     * Call this when a node is removed from the tree.
+     */
+    invalidateNode(nodeId: string): void;
+    /**
+     * Invalidate a specific handler.
+     */
+    invalidateHandler(nodeId: string, actionId: string): void;
+    /**
+     * Clear all cached handlers.
+     */
+    clear(): void;
+    /**
+     * Get the number of cached handlers (for debugging/testing).
+     */
+    get size(): number;
+}

package/index.d.ts

@@ -1,5 +1,6 @@
 export { IkonUICore, type IkonUICoreConfig, type IkonUiStreamListener, type IkonUiUpdateListener, type UiStyleListener, type UiStylePayload } from './ikon-ui-core';
 export { UiStore, UiStreamStore, type StreamSnapshot } from './ui-store';
 export { parseUiUpdate, UiUpdateParseError } from './parse-ui-update';
+export { HandlerCache } from './handler-cache';
 export type { UiStreamSnapshotWire, UiStoreOp, UiStoreOpBatch } from './ui-store-ops';
 export type { UiUpdateType, UiNodeProps, UiNode, TextDelta, UiNodeDiff, UiSnapshotMetadata, UiOptimisticPatchMetadata, UiOptimisticReconcileMetadata, UiOptimisticPatchState, UiStoreSnapshot, UiFullSnapshot, UiDiffSnapshot, UiSnapshot, ParsedUiUpdate, } from './ui-types';