@ikonai/sdk-ui 0.0.1

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@ikonai/sdk-ui",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "types": "./index.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "@ikonai/sdk": "*"
+  }
+}

package/parse-ui-update.d.ts

@@ -0,0 +1,7 @@
+import { UIUpdate } from '../../platform-generated/src/index.ts';
+import { ParsedUiUpdate } from './ui-types';
+export declare class UiUpdateParseError extends Error {
+    readonly causeError?: unknown | undefined;
+    constructor(message: string, causeError?: unknown | undefined);
+}
+export declare function parseUiUpdate(update: UIUpdate): ParsedUiUpdate;

package/ui-store.d.ts

@@ -0,0 +1,34 @@
+import { ParsedUiUpdate, UiStoreSnapshot } from './ui-types';
+type StreamListener = (streamId: string) => void;
+type StoreListener = () => void;
+export interface StreamSnapshot extends UiStoreSnapshot {
+    readonly streamId: string;
+    readonly category?: string;
+}
+export declare class UiStreamStore {
+    private readonly containers;
+    private readonly listeners;
+    private readonly payloads;
+    private snapshot;
+    private rootContainerId?;
+    apply(update: ParsedUiUpdate): boolean;
+    clear(): void;
+    getSnapshot(): UiStoreSnapshot;
+    subscribe(listener: StoreListener): () => void;
+    private commitSnapshot;
+    private notify;
+}
+export declare class UiStore {
+    private readonly streams;
+    private readonly listeners;
+    apply(streamId: string, update: ParsedUiUpdate): boolean;
+    clear(streamId: string): void;
+    remove(streamId: string): void;
+    setCategory(streamId: string, category?: string): void;
+    getSnapshot(streamId: string): StreamSnapshot | undefined;
+    getSnapshots(): StreamSnapshot[];
+    subscribe(listener: StreamListener): () => void;
+    private getOrCreateStreamEntry;
+    private notify;
+}
+export {};

package/ui-types.d.ts

@@ -0,0 +1,78 @@
+import { UIPayload } from '../../platform-generated/src/index.ts';
+export type UiUpdateType = 'full' | 'diff';
+export type UiElementProps = Record<string, unknown>;
+export interface UiElementNode {
+    readonly id: string;
+    readonly type: string;
+    readonly props: UiElementProps;
+    readonly children: readonly UiElementNode[];
+    readonly styleIds: readonly string[];
+}
+export interface TextDelta {
+    readonly nodeId: string;
+    readonly propertyName: string;
+    readonly start: number;
+    readonly end?: number;
+    readonly insertedText: string;
+}
+export interface UiElementDiffNode {
+    readonly id: string;
+    readonly type: string;
+    readonly added: readonly UiElementNode[];
+    readonly removed: readonly string[];
+    readonly updated: readonly UiElementDiffNode[];
+    readonly changedProps: ReadonlyMap<string, unknown>;
+    readonly textUpdates: readonly TextDelta[];
+    readonly replaceProps?: UiElementProps;
+}
+export interface UiSnapshotMetadata {
+    readonly containerId: string;
+    readonly optimisticActionId?: string | null;
+    readonly isOptimistic?: boolean;
+    readonly isUpdate?: boolean;
+    readonly optimisticPatch?: UiOptimisticPatchMetadata;
+    readonly optimisticReconcile?: UiOptimisticReconcileMetadata;
+}
+export interface UiOptimisticPatchMetadata {
+    readonly id: string;
+    readonly actionId: string;
+    readonly ordinal: number;
+    readonly baseVersion: number;
+    readonly supersedes?: readonly string[];
+}
+export interface UiOptimisticReconcileMetadata {
+    readonly baseVersion: number;
+    readonly drop?: readonly string[];
+}
+export interface UiOptimisticPatchState {
+    readonly id: string;
+    readonly actionId: string;
+    readonly ordinal: number;
+    readonly baseVersion: number;
+}
+export interface UiStoreSnapshot {
+    readonly rootContainerId?: string;
+    readonly containers: ReadonlyMap<string, UiElementNode>;
+    readonly payloads: ReadonlyMap<string, UIPayload>;
+    readonly optimisticPatches: ReadonlyMap<string, readonly UiOptimisticPatchState[]>;
+    readonly version?: number;
+}
+interface UiSnapshotBase {
+    readonly type: UiUpdateType;
+    readonly version: number;
+    readonly metadata: UiSnapshotMetadata;
+}
+export interface UiFullSnapshot extends UiSnapshotBase {
+    readonly type: 'full';
+    readonly root: UiElementNode;
+}
+export interface UiDiffSnapshot extends UiSnapshotBase {
+    readonly type: 'diff';
+    readonly diff: UiElementDiffNode;
+}
+export type UiSnapshot = UiFullSnapshot | UiDiffSnapshot;
+export interface ParsedUiUpdate {
+    readonly snapshot: UiSnapshot;
+    readonly payloads: ReadonlyMap<string, UIPayload>;
+}
+export {};