@ikonai/sdk-ui 1.0.67 → 1.0.68

package/ikon-ui-core.d.ts

@@ -1,7 +1,7 @@
 import { IkonClient } from '../../sdk/src/index.ts';
 import { UiStore } from './ui-store';
 import { ParsedUiUpdate } from './ui-types';
-import { LastSnapshotCacheConfig } from './last-snapshot-cache';
+import { LiveSnapshotConfig } from './live-snapshot';
 /**
  * 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
@@ -17,12 +17,17 @@ export interface IkonUiCoreConfig {
         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.
+     * Live snapshot: 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?: {
+    liveSnapshot?: {
         enabled: boolean;
-    } & LastSnapshotCacheConfig;
+    } & LiveSnapshotConfig;
+    /**
+     * Boot snapshot: seed the build-time `boot-snapshot.json` (when the build was bundled with
+     * `--snapshot`) before the WebSocket connects. Default: true. Set false to skip it.
+     */
+    bootSnapshot?: boolean;
 }
 export type IkonUiUpdateListener = (streamId: string, update: ParsedUiUpdate) => void;
 export type IkonUiStreamListener = (streamId: string) => void;
@@ -46,8 +51,8 @@ export declare class IkonUiCore {
     private readonly uiStyleDeleteListeners;
     private readonly uiStreamClearedListeners;
     private readonly useUiWorker;
-    private cache;
-    private unsubscribeCacheCapture?;
+    private liveSnapshot;
+    private unsubscribeLiveSnapshotCapture?;
     constructor(config?: IkonUiCoreConfig);
     dispose(): void;
     private clearAllState;
@@ -58,10 +63,10 @@ export declare class IkonUiCore {
     subscribeToUiStyleDeletes(listener: UiStyleDeleteListener): () => void;
     getUiStyles(): readonly UiStylePayload[];
     private initialize;
-    private seedFromCache;
+    private seedFromLiveSnapshot;
     private seedFromBootSnapshot;
     private loadBootSnapshotAsync;
-    private subscribeCacheCapture;
+    private subscribeLiveSnapshotCapture;
     private startUiWorker;
     private rehydrateStoresForMainThread;
     private forwardMessageToWorker;

package/index.d.ts

@@ -1,6 +1,6 @@
 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 { LiveSnapshotCache, type LiveSnapshotConfig, type LiveSnapshotState } from './live-snapshot';
 export { parseUiUpdate, UiUpdateParseError } from './parse-ui-update';
 export { HandlerCache } from './handler-cache';
 export type { UiStreamSnapshotWire, UiStoreOp, UiStoreOpBatch } from './ui-store-ops';