@ikonai/sdk-ui 1.0.65 → 1.0.67

package/ikon-ui-core.d.ts

@@ -1,6 +1,14 @@
 import { IkonClient } from '../../sdk/src/index.ts';
 import { UiStore } from './ui-store';
 import { ParsedUiUpdate } from './ui-types';
+import { LastSnapshotCacheConfig } from './last-snapshot-cache';
+/**
+ * Starts fetching the build-time boot snapshot as early as possible, independent of the
+ * auth/connect flow. The snapshot is a static CDN asset that needs nothing from the backend, so
+ * kicking the request off on mount lets it overlap the anonymous-auth round-trip instead of being
+ * serialized after it. `IkonUiCore` consumes the in-flight request when it seeds. Idempotent.
+ */
+export declare function prefetchBootSnapshot(): void;
 export interface IkonUiCoreConfig {
     client?: IkonClient | null;
     threading?: {
@@ -8,6 +16,13 @@ export interface IkonUiCoreConfig {
         flushIntervalMs?: number;
         maxLatencyMs?: number;
     };
+    /**
+     * When enabled, the last rendered UI is persisted to `localStorage` and re-seeded on the next
+     * load so the cached tree paints before the WebSocket connects. Opt-in.
+     */
+    cache?: {
+        enabled: boolean;
+    } & LastSnapshotCacheConfig;
 }
 export type IkonUiUpdateListener = (streamId: string, update: ParsedUiUpdate) => void;
 export type IkonUiStreamListener = (streamId: string) => void;
@@ -31,15 +46,22 @@ export declare class IkonUiCore {
     private readonly uiStyleDeleteListeners;
     private readonly uiStreamClearedListeners;
     private readonly useUiWorker;
+    private cache;
+    private unsubscribeCacheCapture?;
     constructor(config?: IkonUiCoreConfig);
     dispose(): void;
     private clearAllState;
+    private enterSnapshotMode;
     subscribeToUiUpdates(listener: IkonUiUpdateListener): () => void;
     subscribeToUiStreamCleared(listener: IkonUiStreamListener): () => void;
     subscribeToUiStyles(listener: UiStyleListener): () => void;
     subscribeToUiStyleDeletes(listener: UiStyleDeleteListener): () => void;
     getUiStyles(): readonly UiStylePayload[];
     private initialize;
+    private seedFromCache;
+    private seedFromBootSnapshot;
+    private loadBootSnapshotAsync;
+    private subscribeCacheCapture;
     private startUiWorker;
     private rehydrateStoresForMainThread;
     private forwardMessageToWorker;

package/index.d.ts

@@ -1,5 +1,6 @@
-export { IkonUiCore, type IkonUiCoreConfig, type IkonUiStreamListener, type IkonUiUpdateListener, type UiStyleListener, type UiStyleDeleteListener, type UiStylePayload } from './ikon-ui-core';
+export { IkonUiCore, prefetchBootSnapshot, type IkonUiCoreConfig, type IkonUiStreamListener, type IkonUiUpdateListener, type UiStyleListener, type UiStyleDeleteListener, type UiStylePayload } from './ikon-ui-core';
 export { UiStore, UiStreamStore, type StreamSnapshot } from './ui-store';
+export { LastSnapshotCache, type LastSnapshotCacheConfig, type CachedUiState } from './last-snapshot-cache';
 export { parseUiUpdate, UiUpdateParseError } from './parse-ui-update';
 export { HandlerCache } from './handler-cache';
 export type { UiStreamSnapshotWire, UiStoreOp, UiStoreOpBatch } from './ui-store-ops';