@cavegiant/cave-world-r3f 1.0.0

package/dist/explore/services/websocket.service.d.ts

@@ -0,0 +1,180 @@
+import type { Vector3 as Vector3Type, Quaternion as QuaternionType } from '../../types/index.js';
+import type { AnimationName } from '../characters/character-configs.js';
+/**
+ * CaveGiant public demo multiplayer endpoint.
+ *
+ * Exported for demos and CaveGiant-hosted apps. Production integrators must
+ * pass their own `multiplayer.url` — the SDK does not connect here unless you
+ * opt in explicitly.
+ */
+export declare const DEFAULT_WEBSOCKET_URL = "wss://api-live-mbspace.cavegiant.com/gameplay";
+/** Connection lifecycle for {@link WebSocketService}. */
+export declare const WebSocketStatusEnum: {
+    readonly CONNECTING: "connecting";
+    readonly CONNECTED: "connected";
+    readonly DISCONNECTED: "disconnected";
+    readonly RECONNECTING: "reconnecting";
+    readonly ERROR: "error";
+};
+export type WebSocketStatus = (typeof WebSocketStatusEnum)[keyof typeof WebSocketStatusEnum];
+/** Wire protocol actions — see `doc/multiplayer-protocol.md`. */
+export declare const MessageActionEnum: {
+    readonly JOIN_GAME: "JOIN_GAME";
+    readonly UPDATE_STATE: "UPDATE_STATE";
+    readonly SYNC_STATE: "SYNC_STATE";
+    readonly PING: "PING";
+    readonly JOIN_SUCCESS: "JOIN_SUCCESS";
+    readonly PLAYER_JOINED: "PLAYER_JOINED";
+    readonly PLAYER_LEFT: "PLAYER_LEFT";
+    readonly STATE_UPDATE: "STATE_UPDATE";
+    readonly STATE_SYNC: "STATE_SYNC";
+    readonly PONG: "PONG";
+    readonly ERROR: "ERROR";
+};
+export type MessageAction = (typeof MessageActionEnum)[keyof typeof MessageActionEnum];
+export interface BaseMessage {
+    action: MessageAction;
+    data: unknown;
+}
+export interface PlayerData {
+    id: string;
+    position?: Vector3Type;
+    rotation?: QuaternionType;
+    animation?: AnimationName;
+    avatarId?: string;
+    lastUpdate?: number;
+}
+export interface JoinGameMessage extends BaseMessage {
+    action: typeof MessageActionEnum.JOIN_GAME;
+    data: {
+        appId: string;
+        avatarId: string;
+    };
+}
+export interface UpdateStateMessage extends BaseMessage {
+    action: typeof MessageActionEnum.UPDATE_STATE;
+    data: {
+        position?: Vector3Type;
+        rotation?: QuaternionType;
+        animation?: AnimationName;
+        avatarId?: string;
+    };
+}
+export interface SyncStateMessage extends BaseMessage {
+    action: typeof MessageActionEnum.SYNC_STATE;
+    data: unknown;
+}
+export interface PingMessage extends BaseMessage {
+    action: typeof MessageActionEnum.PING;
+    data: unknown;
+}
+export interface JoinSuccessMessage extends BaseMessage {
+    action: typeof MessageActionEnum.JOIN_SUCCESS;
+    data: {
+        roomId: string;
+        playerId: string;
+        players: PlayerData[];
+        isRejoin: boolean;
+    };
+}
+export interface PlayerJoinedMessage extends BaseMessage {
+    action: typeof MessageActionEnum.PLAYER_JOINED;
+    data: PlayerData & {
+        playerId: string;
+    };
+}
+export interface PlayerLeftMessage extends BaseMessage {
+    action: typeof MessageActionEnum.PLAYER_LEFT;
+    data: {
+        playerId: string;
+    };
+}
+export interface StateUpdateMessage extends BaseMessage {
+    action: typeof MessageActionEnum.STATE_UPDATE;
+    data: PlayerData & {
+        playerId: string;
+    };
+}
+export interface StateSyncMessage extends BaseMessage {
+    action: typeof MessageActionEnum.STATE_SYNC;
+    data: {
+        players: PlayerData[];
+    };
+}
+export interface PongMessage extends BaseMessage {
+    action: typeof MessageActionEnum.PONG;
+    data: {
+        timestamp: number;
+    };
+}
+export interface ErrorMessage extends BaseMessage {
+    action: typeof MessageActionEnum.ERROR;
+    data: {
+        error_code: string;
+        error_msg: string;
+    };
+}
+export type WebSocketMessage = JoinGameMessage | UpdateStateMessage | SyncStateMessage | PingMessage | JoinSuccessMessage | PlayerJoinedMessage | PlayerLeftMessage | StateUpdateMessage | StateSyncMessage | PongMessage | ErrorMessage;
+export type MessageListener = (message: WebSocketMessage) => void;
+export type StatusListener = (status: WebSocketStatus) => void;
+export type ErrorListener = (error: Event) => void;
+export interface WebSocketConfig {
+    /** Required realtime endpoint (`wss://…`). */
+    url: string;
+    reconnectInterval?: number;
+    maxReconnectAttempts?: number;
+    pingInterval?: number;
+    timeout?: number;
+}
+/**
+ * Thin WebSocket client for the multiplayer protocol.
+ *
+ * Construct with an explicit `url`. Use {@link DEFAULT_WEBSOCKET_URL} only when
+ * you intentionally want the CaveGiant demo backend.
+ */
+export declare class WebSocketService {
+    private ws;
+    private config;
+    private status;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private pingTimer;
+    private messageListeners;
+    private statusListeners;
+    private errorListeners;
+    constructor(config: WebSocketConfig);
+    /** Open the socket (or resolve immediately if already connected). */
+    connect(): Promise<void>;
+    /** Close the socket and cancel reconnect / ping timers. */
+    disconnect(): void;
+    /** Send a protocol message. Returns false when the socket is not connected. */
+    send(message: WebSocketMessage): boolean;
+    /** Join (or rejoin) a room identified by `appId`. */
+    joinGame(appId: string, avatarId: string): boolean;
+    /** Publish the local player's transform / animation. */
+    updateState(data: {
+        position?: Vector3Type;
+        rotation?: QuaternionType;
+        animation?: AnimationName;
+        avatarId?: string;
+    }): boolean;
+    /** Request a full room state snapshot from the server. */
+    syncState(): boolean;
+    /** Application-level heartbeat. */
+    ping(): boolean;
+    addMessageListener(listener: MessageListener): () => void;
+    addStatusListener(listener: StatusListener): () => void;
+    addErrorListener(listener: ErrorListener): () => void;
+    getStatus(): WebSocketStatus;
+    isConnected(): boolean;
+    private handleMessage;
+    private setStatus;
+    private notifyErrorListeners;
+    private scheduleReconnect;
+    private stopReconnect;
+    private startPing;
+    private stopPing;
+    /** Disconnect and drop all listeners. */
+    destroy(): void;
+}
+//# sourceMappingURL=websocket.service.d.ts.map

package/dist/explore/services/websocket.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.service.d.ts","sourceRoot":"","sources":["../../../explore/services/websocket.service.ts"],"names":[],"mappings":"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"}

package/dist/explore/services/websocket.service.js

@@ -0,0 +1,187 @@
+import { createLogger as c } from "../../core/logging/logger.js";
+const i = c("multiplayer:socket"), u = "wss://api-live-mbspace.cavegiant.com/gameplay", r = {
+  CONNECTING: "connecting",
+  CONNECTED: "connected",
+  DISCONNECTED: "disconnected",
+  RECONNECTING: "reconnecting",
+  ERROR: "error"
+}, o = {
+  JOIN_GAME: "JOIN_GAME",
+  UPDATE_STATE: "UPDATE_STATE",
+  SYNC_STATE: "SYNC_STATE",
+  PING: "PING",
+  JOIN_SUCCESS: "JOIN_SUCCESS",
+  PLAYER_JOINED: "PLAYER_JOINED",
+  PLAYER_LEFT: "PLAYER_LEFT",
+  STATE_UPDATE: "STATE_UPDATE",
+  STATE_SYNC: "STATE_SYNC",
+  PONG: "PONG",
+  ERROR: "ERROR"
+}, a = {
+  reconnectInterval: 3e3,
+  maxReconnectAttempts: 5,
+  pingInterval: 3e4,
+  timeout: 1e4
+};
+class T {
+  ws = null;
+  config;
+  status = r.DISCONNECTED;
+  reconnectAttempts = 0;
+  reconnectTimer = null;
+  pingTimer = null;
+  messageListeners = /* @__PURE__ */ new Set();
+  statusListeners = /* @__PURE__ */ new Set();
+  errorListeners = /* @__PURE__ */ new Set();
+  constructor(t) {
+    if (!t.url)
+      throw new Error("WebSocketService requires config.url");
+    this.config = { ...a, ...t };
+  }
+  /** Open the socket (or resolve immediately if already connected). */
+  connect() {
+    return new Promise((t, e) => {
+      if (this.status === r.CONNECTED) {
+        t();
+        return;
+      }
+      this.setStatus(r.CONNECTING);
+      try {
+        this.ws = new WebSocket(this.config.url);
+        const s = setTimeout(() => {
+          this.ws?.readyState === WebSocket.CONNECTING && (this.ws.close(), e(new Error("Connection timeout")));
+        }, this.config.timeout);
+        this.ws.onopen = () => {
+          clearTimeout(s), this.setStatus(r.CONNECTED), this.reconnectAttempts = 0, this.startPing(), t();
+        }, this.ws.onclose = (n) => {
+          clearTimeout(s), this.setStatus(r.DISCONNECTED), this.stopPing(), !n.wasClean && this.reconnectAttempts < this.config.maxReconnectAttempts && this.scheduleReconnect();
+        }, this.ws.onerror = (n) => {
+          clearTimeout(s), this.setStatus(r.ERROR), this.notifyErrorListeners(n), e(n);
+        }, this.ws.onmessage = (n) => {
+          this.handleMessage(n);
+        };
+      } catch (s) {
+        this.setStatus(r.ERROR), e(s);
+      }
+    });
+  }
+  /** Close the socket and cancel reconnect / ping timers. */
+  disconnect() {
+    this.stopReconnect(), this.stopPing(), this.ws && (this.ws.close(1e3, "Client disconnect"), this.ws = null), this.setStatus(r.DISCONNECTED);
+  }
+  /** Send a protocol message. Returns false when the socket is not connected. */
+  send(t) {
+    if (this.status !== r.CONNECTED || !this.ws)
+      return i.warn("WebSocket not connected, cannot send message"), !1;
+    try {
+      return this.ws.send(JSON.stringify(t)), !0;
+    } catch (e) {
+      return i.error("Failed to send message:", e), !1;
+    }
+  }
+  /** Join (or rejoin) a room identified by `appId`. */
+  joinGame(t, e) {
+    return this.send({
+      action: o.JOIN_GAME,
+      data: { appId: t, avatarId: e }
+    });
+  }
+  /** Publish the local player's transform / animation. */
+  updateState(t) {
+    return this.send({
+      action: o.UPDATE_STATE,
+      data: t
+    });
+  }
+  /** Request a full room state snapshot from the server. */
+  syncState() {
+    return this.send({
+      action: o.SYNC_STATE,
+      data: {}
+    });
+  }
+  /** Application-level heartbeat. */
+  ping() {
+    return this.send({
+      action: o.PING,
+      data: {}
+    });
+  }
+  addMessageListener(t) {
+    return this.messageListeners.add(t), () => this.messageListeners.delete(t);
+  }
+  addStatusListener(t) {
+    return this.statusListeners.add(t), () => this.statusListeners.delete(t);
+  }
+  addErrorListener(t) {
+    return this.errorListeners.add(t), () => this.errorListeners.delete(t);
+  }
+  getStatus() {
+    return this.status;
+  }
+  isConnected() {
+    return this.status === r.CONNECTED;
+  }
+  handleMessage(t) {
+    try {
+      const e = JSON.parse(t.data);
+      if (e.action === o.PONG)
+        return;
+      this.messageListeners.forEach((s) => {
+        try {
+          s(e);
+        } catch (n) {
+          i.error("Error in message listener:", n);
+        }
+      });
+    } catch (e) {
+      i.error("Failed to parse WebSocket message:", e);
+    }
+  }
+  setStatus(t) {
+    this.status !== t && (this.status = t, this.statusListeners.forEach((e) => {
+      try {
+        e(t);
+      } catch (s) {
+        i.error("Error in status listener:", s);
+      }
+    }));
+  }
+  notifyErrorListeners(t) {
+    this.errorListeners.forEach((e) => {
+      try {
+        e(t);
+      } catch (s) {
+        i.error("Error in error listener:", s);
+      }
+    });
+  }
+  scheduleReconnect() {
+    this.reconnectTimer || (this.setStatus(r.RECONNECTING), this.reconnectAttempts++, this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null, this.connect().catch(() => {
+      });
+    }, this.config.reconnectInterval));
+  }
+  stopReconnect() {
+    this.reconnectTimer && (clearTimeout(this.reconnectTimer), this.reconnectTimer = null);
+  }
+  startPing() {
+    this.stopPing(), this.pingTimer = setInterval(() => {
+      this.isConnected() && this.ping();
+    }, this.config.pingInterval);
+  }
+  stopPing() {
+    this.pingTimer && (clearInterval(this.pingTimer), this.pingTimer = null);
+  }
+  /** Disconnect and drop all listeners. */
+  destroy() {
+    this.disconnect(), this.messageListeners.clear(), this.statusListeners.clear(), this.errorListeners.clear();
+  }
+}
+export {
+  u as DEFAULT_WEBSOCKET_URL,
+  o as MessageActionEnum,
+  T as WebSocketService,
+  r as WebSocketStatusEnum
+};
+//# sourceMappingURL=websocket.service.js.map

package/dist/explore/services/websocket.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.service.js","sources":["../../../explore/services/websocket.service.ts"],"sourcesContent":["import { createLogger } from '../../core'\nimport type { Vector3 as Vector3Type, Quaternion as QuaternionType } from '../../types'\nimport type { AnimationName } from '../characters/character-configs'\n\nconst logger = createLogger('multiplayer:socket')\n\n/**\n * CaveGiant public demo multiplayer endpoint.\n *\n * Exported for demos and CaveGiant-hosted apps. Production integrators must\n * pass their own `multiplayer.url` — the SDK does not connect here unless you\n * opt in explicitly.\n */\nexport const DEFAULT_WEBSOCKET_URL = 'wss://api-live-mbspace.cavegiant.com/gameplay'\n\n/** Connection lifecycle for {@link WebSocketService}. */\nexport const WebSocketStatusEnum = {\n  CONNECTING: 'connecting',\n  CONNECTED: 'connected',\n  DISCONNECTED: 'disconnected',\n  RECONNECTING: 'reconnecting',\n  ERROR: 'error'\n} as const\nexport type WebSocketStatus = (typeof WebSocketStatusEnum)[keyof typeof WebSocketStatusEnum]\n\n/** Wire protocol actions — see `doc/multiplayer-protocol.md`. */\nexport const MessageActionEnum = {\n  JOIN_GAME: 'JOIN_GAME',\n  UPDATE_STATE: 'UPDATE_STATE',\n  SYNC_STATE: 'SYNC_STATE',\n  PING: 'PING',\n  JOIN_SUCCESS: 'JOIN_SUCCESS',\n  PLAYER_JOINED: 'PLAYER_JOINED',\n  PLAYER_LEFT: 'PLAYER_LEFT',\n  STATE_UPDATE: 'STATE_UPDATE',\n  STATE_SYNC: 'STATE_SYNC',\n  PONG: 'PONG',\n  ERROR: 'ERROR'\n} as const\nexport type MessageAction = (typeof MessageActionEnum)[keyof typeof MessageActionEnum]\n\nexport interface BaseMessage {\n  action: MessageAction\n  data: unknown\n}\n\nexport interface PlayerData {\n  id: string\n  position?: Vector3Type\n  rotation?: QuaternionType\n  animation?: AnimationName\n  avatarId?: string\n  lastUpdate?: number\n}\n\nexport interface JoinGameMessage extends BaseMessage {\n  action: typeof MessageActionEnum.JOIN_GAME\n  data: {\n    appId: string\n    avatarId: string\n  }\n}\n\nexport interface UpdateStateMessage extends BaseMessage {\n  action: typeof MessageActionEnum.UPDATE_STATE\n  data: {\n    position?: Vector3Type\n    rotation?: QuaternionType\n    animation?: AnimationName\n    avatarId?: string\n  }\n}\n\nexport interface SyncStateMessage extends BaseMessage {\n  action: typeof MessageActionEnum.SYNC_STATE\n  data: unknown\n}\n\nexport interface PingMessage extends BaseMessage {\n  action: typeof MessageActionEnum.PING\n  data: unknown\n}\n\nexport interface JoinSuccessMessage extends BaseMessage {\n  action: typeof MessageActionEnum.JOIN_SUCCESS\n  data: {\n    roomId: string\n    playerId: string\n    players: PlayerData[]\n    isRejoin: boolean\n  }\n}\n\nexport interface PlayerJoinedMessage extends BaseMessage {\n  action: typeof MessageActionEnum.PLAYER_JOINED\n  data: PlayerData & { playerId: string }\n}\n\nexport interface PlayerLeftMessage extends BaseMessage {\n  action: typeof MessageActionEnum.PLAYER_LEFT\n  data: {\n    playerId: string\n  }\n}\n\nexport interface StateUpdateMessage extends BaseMessage {\n  action: typeof MessageActionEnum.STATE_UPDATE\n  data: PlayerData & { playerId: string }\n}\n\nexport interface StateSyncMessage extends BaseMessage {\n  action: typeof MessageActionEnum.STATE_SYNC\n  data: {\n    players: PlayerData[]\n  }\n}\n\nexport interface PongMessage extends BaseMessage {\n  action: typeof MessageActionEnum.PONG\n  data: {\n    timestamp: number\n  }\n}\n\nexport interface ErrorMessage extends BaseMessage {\n  action: typeof MessageActionEnum.ERROR\n  data: {\n    error_code: string\n    error_msg: string\n  }\n}\n\nexport type WebSocketMessage =\n  | JoinGameMessage\n  | UpdateStateMessage\n  | SyncStateMessage\n  | PingMessage\n  | JoinSuccessMessage\n  | PlayerJoinedMessage\n  | PlayerLeftMessage\n  | StateUpdateMessage\n  | StateSyncMessage\n  | PongMessage\n  | ErrorMessage\n\nexport type MessageListener = (message: WebSocketMessage) => void\nexport type StatusListener = (status: WebSocketStatus) => void\nexport type ErrorListener = (error: Event) => void\n\nexport interface WebSocketConfig {\n  /** Required realtime endpoint (`wss://…`). */\n  url: string\n  reconnectInterval?: number\n  maxReconnectAttempts?: number\n  pingInterval?: number\n  timeout?: number\n}\n\nconst DEFAULT_OPTIONS = {\n  reconnectInterval: 3000,\n  maxReconnectAttempts: 5,\n  pingInterval: 30000,\n  timeout: 10000\n} as const\n\n/**\n * Thin WebSocket client for the multiplayer protocol.\n *\n * Construct with an explicit `url`. Use {@link DEFAULT_WEBSOCKET_URL} only when\n * you intentionally want the CaveGiant demo backend.\n */\nexport class WebSocketService {\n  private ws: WebSocket | null = null\n  private config: Required<WebSocketConfig>\n  private status: WebSocketStatus = WebSocketStatusEnum.DISCONNECTED\n  private reconnectAttempts = 0\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null\n  private pingTimer: ReturnType<typeof setInterval> | null = null\n  private messageListeners: Set<MessageListener> = new Set()\n  private statusListeners: Set<StatusListener> = new Set()\n  private errorListeners: Set<ErrorListener> = new Set()\n\n  constructor(config: WebSocketConfig) {\n    if (!config.url) {\n      throw new Error('WebSocketService requires config.url')\n    }\n    this.config = { ...DEFAULT_OPTIONS, ...config }\n  }\n\n  /** Open the socket (or resolve immediately if already connected). */\n  public connect(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (this.status === WebSocketStatusEnum.CONNECTED) {\n        resolve()\n        return\n      }\n\n      this.setStatus(WebSocketStatusEnum.CONNECTING)\n\n      try {\n        this.ws = new WebSocket(this.config.url)\n\n        const timeout = setTimeout(() => {\n          if (this.ws?.readyState === WebSocket.CONNECTING) {\n            this.ws.close()\n            reject(new Error('Connection timeout'))\n          }\n        }, this.config.timeout)\n\n        this.ws.onopen = () => {\n          clearTimeout(timeout)\n          this.setStatus(WebSocketStatusEnum.CONNECTED)\n          this.reconnectAttempts = 0\n          this.startPing()\n          resolve()\n        }\n\n        this.ws.onclose = (event) => {\n          clearTimeout(timeout)\n          this.setStatus(WebSocketStatusEnum.DISCONNECTED)\n          this.stopPing()\n\n          if (!event.wasClean && this.reconnectAttempts < this.config.maxReconnectAttempts) {\n            this.scheduleReconnect()\n          }\n        }\n\n        this.ws.onerror = (error) => {\n          clearTimeout(timeout)\n          this.setStatus(WebSocketStatusEnum.ERROR)\n          this.notifyErrorListeners(error)\n          reject(error)\n        }\n\n        this.ws.onmessage = (event) => {\n          this.handleMessage(event)\n        }\n      } catch (error) {\n        this.setStatus(WebSocketStatusEnum.ERROR)\n        reject(error)\n      }\n    })\n  }\n\n  /** Close the socket and cancel reconnect / ping timers. */\n  public disconnect(): void {\n    this.stopReconnect()\n    this.stopPing()\n\n    if (this.ws) {\n      this.ws.close(1000, 'Client disconnect')\n      this.ws = null\n    }\n\n    this.setStatus(WebSocketStatusEnum.DISCONNECTED)\n  }\n\n  /** Send a protocol message. Returns false when the socket is not connected. */\n  public send(message: WebSocketMessage): boolean {\n    if (this.status !== WebSocketStatusEnum.CONNECTED || !this.ws) {\n      logger.warn('WebSocket not connected, cannot send message')\n      return false\n    }\n\n    try {\n      this.ws.send(JSON.stringify(message))\n      return true\n    } catch (error) {\n      logger.error('Failed to send message:', error)\n      return false\n    }\n  }\n\n  /** Join (or rejoin) a room identified by `appId`. */\n  public joinGame(appId: string, avatarId: string): boolean {\n    return this.send({\n      action: MessageActionEnum.JOIN_GAME,\n      data: { appId, avatarId }\n    })\n  }\n\n  /** Publish the local player's transform / animation. */\n  public updateState(data: {\n    position?: Vector3Type\n    rotation?: QuaternionType\n    animation?: AnimationName\n    avatarId?: string\n  }): boolean {\n    return this.send({\n      action: MessageActionEnum.UPDATE_STATE,\n      data\n    })\n  }\n\n  /** Request a full room state snapshot from the server. */\n  public syncState(): boolean {\n    return this.send({\n      action: MessageActionEnum.SYNC_STATE,\n      data: {}\n    })\n  }\n\n  /** Application-level heartbeat. */\n  public ping(): boolean {\n    return this.send({\n      action: MessageActionEnum.PING,\n      data: {}\n    })\n  }\n\n  public addMessageListener(listener: MessageListener): () => void {\n    this.messageListeners.add(listener)\n    return () => this.messageListeners.delete(listener)\n  }\n\n  public addStatusListener(listener: StatusListener): () => void {\n    this.statusListeners.add(listener)\n    return () => this.statusListeners.delete(listener)\n  }\n\n  public addErrorListener(listener: ErrorListener): () => void {\n    this.errorListeners.add(listener)\n    return () => this.errorListeners.delete(listener)\n  }\n\n  public getStatus(): WebSocketStatus {\n    return this.status\n  }\n\n  public isConnected(): boolean {\n    return this.status === WebSocketStatusEnum.CONNECTED\n  }\n\n  private handleMessage(event: MessageEvent): void {\n    try {\n      const message: WebSocketMessage = JSON.parse(event.data)\n\n      if (message.action === MessageActionEnum.PONG) {\n        return\n      }\n\n      this.messageListeners.forEach((listener) => {\n        try {\n          listener(message)\n        } catch (error) {\n          logger.error('Error in message listener:', error)\n        }\n      })\n    } catch (error) {\n      logger.error('Failed to parse WebSocket message:', error)\n    }\n  }\n\n  private setStatus(status: WebSocketStatus): void {\n    if (this.status !== status) {\n      this.status = status\n      this.statusListeners.forEach((listener) => {\n        try {\n          listener(status)\n        } catch (error) {\n          logger.error('Error in status listener:', error)\n        }\n      })\n    }\n  }\n\n  private notifyErrorListeners(error: Event): void {\n    this.errorListeners.forEach((listener) => {\n      try {\n        listener(error)\n      } catch (err) {\n        logger.error('Error in error listener:', err)\n      }\n    })\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectTimer) return\n\n    this.setStatus(WebSocketStatusEnum.RECONNECTING)\n    this.reconnectAttempts++\n\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null\n      this.connect().catch(() => {\n        // Keep trying until maxReconnectAttempts is exhausted via onclose.\n      })\n    }, this.config.reconnectInterval)\n  }\n\n  private stopReconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer)\n      this.reconnectTimer = null\n    }\n  }\n\n  private startPing(): void {\n    this.stopPing()\n\n    this.pingTimer = setInterval(() => {\n      if (this.isConnected()) {\n        this.ping()\n      }\n    }, this.config.pingInterval)\n  }\n\n  private stopPing(): void {\n    if (this.pingTimer) {\n      clearInterval(this.pingTimer)\n      this.pingTimer = null\n    }\n  }\n\n  /** Disconnect and drop all listeners. */\n  public destroy(): void {\n    this.disconnect()\n    this.messageListeners.clear()\n    this.statusListeners.clear()\n    this.errorListeners.clear()\n  }\n}\n"],"names":["logger","createLogger","DEFAULT_WEBSOCKET_URL","WebSocketStatusEnum","MessageActionEnum","DEFAULT_OPTIONS","WebSocketService","config","resolve","reject","timeout","event","error","message","appId","avatarId","data","listener","status","err"],"mappings":"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"}

package/dist/explore/simple-character.d.ts

@@ -0,0 +1,46 @@
+import type { CharacterCameraBehavior } from '@react-three/viverse';
+import type { AnimationAction, Group, Object3DEventMap } from 'three';
+import type { AvatarConfig } from './characters/character-configs.js';
+import type { CharacterControlsConfig } from './characters/character-controls.js';
+import { type LocalCharacterModelProp } from './characters/local-character-model.js';
+/**
+ * Root ref from viverse's `SimpleCharacter`, augmented at runtime with:
+ * - `actions` — animation table, patched to record the playing clip so
+ *   multiplayer can publish it;
+ * - `viverseCameraBehavior` — the `CharacterCameraBehavior` that owns
+ *   `rotationYaw` / `rotationPitch`. viverse discards the behavior ref returned
+ *   by its internal `useCharacterCameraBehavior`, so we run our own and expose
+ *   it here; it is the only way to programmatically re-orient the player
+ *   (spawn point, portal teleport). See `characters/character-pose.ts`.
+ */
+export type ExploreSimpleCharacterRoot = Group<Object3DEventMap> & {
+    actions?: Record<string, AnimationAction | undefined>;
+    viverseCameraBehavior?: CharacterCameraBehavior;
+};
+/** Resolved multiplayer options (see `CaveExploreProps.multiplayer`). */
+export interface MultiplayerRuntimeConfig {
+    /** Realtime endpoint. Required when multiplayer is enabled. */
+    url: string;
+    avatarId?: string;
+    avatars?: Record<string, AvatarConfig>;
+    maxRemoteCharacters?: number;
+}
+export interface ExploreSimpleCharacterProps {
+    /** Scene readiness gate — gravity stays at 0 until colliders exist. */
+    spaceInited: boolean;
+    /** Room key for multiplayer; normally the primary space id. */
+    spaceId: string | undefined;
+    /** Omit or pass `undefined` to disable multiplayer. */
+    multiplayer?: MultiplayerRuntimeConfig;
+    localCharacterModel?: LocalCharacterModelProp;
+    characterControls?: CharacterControlsConfig;
+}
+/**
+ * Memoised so re-renders of the exploration root (active-scene churn,
+ * action-prompt updates) don't propagate into `<SimpleCharacter>`. Re-rendering
+ * it is expensive and, worse, triggers the viverse action-binding bug described
+ * in `hooks/use-action-shortcuts.ts` that drops held movement keys.
+ */
+declare const _default: import("react").NamedExoticComponent<ExploreSimpleCharacterProps & import("react").RefAttributes<ExploreSimpleCharacterRoot>>;
+export default _default;
+//# sourceMappingURL=simple-character.d.ts.map

package/dist/explore/simple-character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-character.d.ts","sourceRoot":"","sources":["../../explore/simple-character.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AASnE,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAC9E,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,oCAAoC,CAAA;AAgB3C;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAAC,gBAAgB,CAAC,GAAG;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAA;IACrD,qBAAqB,CAAC,EAAE,uBAAuB,CAAA;CAChD,CAAA;AAgDD,yEAAyE;AACzE,MAAM,WAAW,wBAAwB;IACvC,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAA;IACpB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,uDAAuD;IACvD,WAAW,CAAC,EAAE,wBAAwB,CAAA;IACtC,mBAAmB,CAAC,EAAE,uBAAuB,CAAA;IAC7C,iBAAiB,CAAC,EAAE,uBAAuB,CAAA;CAC5C;AAkID;;;;;GAKG;;AACH,wBAA2C"}

package/dist/explore/simple-character.js

@@ -0,0 +1,119 @@
+import { jsxs as R, Fragment as S, jsx as l } from "react/jsx-runtime";
+import { memo as _, forwardRef as O, useRef as I, useImperativeHandle as T, useEffect as A, useMemo as a } from "react";
+import { Vanilla as v, PointerLockRotateZoomActionBindings as x, KeyboardLocomotionActionBindings as N, FirstPersonCharacterCameraBehavior as b, useCharacterCameraBehavior as w, SimpleCharacter as y } from "@react-three/viverse";
+import { useTouchPrimaryDevice as P } from "../space/utils/touch-primary-device.js";
+import { CAVE_WORLD_LOCAL_PLAYER_FLAG as B } from "../space/utils/cave-world-player.js";
+import { resolveLocalCharacterScale as k, resolveLocalCharacterPhysics as F, resolveSimpleCharacterModel as j, resolveUseViverseAvatar as U } from "./characters/local-character-model.js";
+import M from "./characters/remote-character-controller.js";
+import { useCaveExplore as V } from "./stores/explore-context.js";
+const G = -20, g = [
+  "idle",
+  "walk",
+  "run",
+  "jumpDown",
+  "jumpUp",
+  "jumpForward"
+];
+function K(p) {
+  const t = p.current?.actions;
+  if (!t) return () => {
+  };
+  const s = /* @__PURE__ */ new Map();
+  for (const o of g) {
+    const e = t[o];
+    if (!e?.play) continue;
+    const n = e.play;
+    s.set(o, n), e.play = () => {
+      const m = p.current;
+      return m && (m.userData.currentAnimation = o), n.bind(e)();
+    };
+  }
+  return () => {
+    for (const o of g) {
+      const e = s.get(o), n = t[o];
+      e && n && (n.play = e);
+    }
+  };
+}
+const J = [
+  v.ScreenJoystickLocomotionActionBindings,
+  v.ScreenButtonJumpActionBindings,
+  v.PointerCaptureRotateZoomActionBindings
+], Y = [
+  x,
+  N
+], Z = O(
+  function({ spaceInited: t, spaceId: s, multiplayer: o, localCharacterModel: e, characterControls: n }, m) {
+    const c = P(), u = V((r) => r.viewMode), i = I(null);
+    T(m, () => i.current, []), A(() => K(i), []);
+    const h = a(() => c ? n?.mobileActionBindings ?? J : n?.desktopActionBindings ?? Y, [
+      n?.mobileActionBindings,
+      n?.desktopActionBindings,
+      c
+    ]), C = a(
+      () => u === "first-person" ? b : { zoom: { minDistance: c ? 1 : 0.8, maxDistance: c ? 2.5 : 2 } },
+      [u, c]
+    );
+    A(() => {
+      const r = i.current;
+      if (r)
+        return r.userData[B] = !0, () => {
+          delete r.userData[B];
+        };
+    }, [t]);
+    const d = w(i, C);
+    A(() => {
+      const r = i.current;
+      r && Object.defineProperty(r, "viverseCameraBehavior", {
+        get: () => d.current,
+        configurable: !0
+      });
+    }, [d]);
+    const f = a(
+      () => k(e),
+      [e]
+    ), D = a(
+      () => F(f, {
+        gravity: t ? G : 0
+      }),
+      [f, t]
+    ), E = a(
+      () => j(e, u),
+      [e, u]
+    ), L = a(
+      () => U(e),
+      [e]
+    );
+    return /* @__PURE__ */ R(S, { children: [
+      /* @__PURE__ */ l(
+        y,
+        {
+          ref: i,
+          physics: D,
+          scale: f,
+          model: E,
+          useViverseAvatar: L,
+          actionBindings: h,
+          actionBindingOptions: n?.actionBindingOptions,
+          movement: n?.movement,
+          cameraBehavior: !1
+        }
+      ),
+      s && o ? /* @__PURE__ */ l(
+        M,
+        {
+          appId: s,
+          websocketUrl: o.url,
+          localCharacterRef: i,
+          localAvatarId: o.avatarId,
+          avatars: o.avatars,
+          maxRemoteCharacters: o.maxRemoteCharacters
+        }
+      ) : null
+    ] });
+  }
+), oe = _(Z);
+export {
+  oe as default
+};
+//# sourceMappingURL=simple-character.js.map

package/dist/explore/simple-character.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-character.js","sources":["../../explore/simple-character.tsx"],"sourcesContent":["import { forwardRef, memo, useEffect, useImperativeHandle, useMemo, useRef } from 'react'\nimport type { CharacterCameraBehavior } from '@react-three/viverse'\nimport {\n  FirstPersonCharacterCameraBehavior,\n  KeyboardLocomotionActionBindings,\n  PointerLockRotateZoomActionBindings,\n  SimpleCharacter,\n  useCharacterCameraBehavior,\n  Vanilla\n} from '@react-three/viverse'\nimport type { AnimationAction, Group, Object3DEventMap } from 'three'\nimport { CAVE_WORLD_LOCAL_PLAYER_FLAG, useTouchPrimaryDevice } from '../space'\nimport type { AvatarConfig } from './characters/character-configs'\nimport type { CharacterControlsConfig } from './characters/character-controls'\nimport {\n  resolveLocalCharacterPhysics,\n  resolveLocalCharacterScale,\n  resolveSimpleCharacterModel,\n  resolveUseViverseAvatar,\n  type LocalCharacterModelProp\n} from './characters/local-character-model'\nimport RemoteCharacterController from './characters/remote-character-controller'\nimport { useCaveExplore } from './stores/explore-context'\n\n/** Gravity applied once the scene's colliders exist (m/s²). */\nconst DEFAULT_GRAVITY = -20\n\nconst TRACKED_ANIMATION_NAMES = [\n  'idle',\n  'walk',\n  'run',\n  'jumpDown',\n  'jumpUp',\n  'jumpForward'\n] as const\n\n/**\n * Root ref from viverse's `SimpleCharacter`, augmented at runtime with:\n * - `actions` — animation table, patched to record the playing clip so\n *   multiplayer can publish it;\n * - `viverseCameraBehavior` — the `CharacterCameraBehavior` that owns\n *   `rotationYaw` / `rotationPitch`. viverse discards the behavior ref returned\n *   by its internal `useCharacterCameraBehavior`, so we run our own and expose\n *   it here; it is the only way to programmatically re-orient the player\n *   (spawn point, portal teleport). See `characters/character-pose.ts`.\n */\nexport type ExploreSimpleCharacterRoot = Group<Object3DEventMap> & {\n  actions?: Record<string, AnimationAction | undefined>\n  viverseCameraBehavior?: CharacterCameraBehavior\n}\n\n/**\n * Record the currently playing clip name on `userData.currentAnimation`.\n *\n * viverse exposes no \"current animation\" accessor, so we wrap each action's\n * `play()`. Returns a restore function.\n */\nfunction patchAnimationTracking(\n  characterRef: React.RefObject<ExploreSimpleCharacterRoot | null>\n): () => void {\n  const actions = characterRef.current?.actions\n  if (!actions) return () => {}\n\n  const originals = new Map<string, AnimationAction['play']>()\n\n  for (const name of TRACKED_ANIMATION_NAMES) {\n    const action = actions[name]\n    if (!action?.play) continue\n    const original = action.play\n    originals.set(name, original)\n    action.play = () => {\n      const root = characterRef.current\n      if (root) root.userData.currentAnimation = name\n      return original.bind(action)()\n    }\n  }\n\n  return () => {\n    for (const name of TRACKED_ANIMATION_NAMES) {\n      const original = originals.get(name)\n      const action = actions[name]\n      if (original && action) action.play = original\n    }\n  }\n}\n\nconst DEFAULT_MOBILE_ACTION_BINDINGS = [\n  Vanilla.ScreenJoystickLocomotionActionBindings,\n  Vanilla.ScreenButtonJumpActionBindings,\n  Vanilla.PointerCaptureRotateZoomActionBindings\n]\n\nconst DEFAULT_DESKTOP_ACTION_BINDINGS = [\n  PointerLockRotateZoomActionBindings,\n  KeyboardLocomotionActionBindings\n]\n\n/** Resolved multiplayer options (see `CaveExploreProps.multiplayer`). */\nexport interface MultiplayerRuntimeConfig {\n  /** Realtime endpoint. Required when multiplayer is enabled. */\n  url: string\n  avatarId?: string\n  avatars?: Record<string, AvatarConfig>\n  maxRemoteCharacters?: number\n}\n\nexport interface ExploreSimpleCharacterProps {\n  /** Scene readiness gate — gravity stays at 0 until colliders exist. */\n  spaceInited: boolean\n  /** Room key for multiplayer; normally the primary space id. */\n  spaceId: string | undefined\n  /** Omit or pass `undefined` to disable multiplayer. */\n  multiplayer?: MultiplayerRuntimeConfig\n  localCharacterModel?: LocalCharacterModelProp\n  characterControls?: CharacterControlsConfig\n}\n\nconst ExploreSimpleCharacter = forwardRef<ExploreSimpleCharacterRoot, ExploreSimpleCharacterProps>(\n  function ExploreSimpleCharacter(\n    { spaceInited, spaceId, multiplayer, localCharacterModel, characterControls },\n    ref\n  ) {\n    const isMobile = useTouchPrimaryDevice()\n    const viewMode = useCaveExplore((s) => s.viewMode)\n    const characterRef = useRef<ExploreSimpleCharacterRoot>(null)\n\n    useImperativeHandle(ref, () => characterRef.current as ExploreSimpleCharacterRoot, [])\n\n    useEffect(() => patchAnimationTracking(characterRef), [])\n\n    const characterActionBindings = useMemo(() => {\n      if (isMobile) {\n        return characterControls?.mobileActionBindings ?? DEFAULT_MOBILE_ACTION_BINDINGS\n      }\n      return characterControls?.desktopActionBindings ?? DEFAULT_DESKTOP_ACTION_BINDINGS\n    }, [\n      characterControls?.mobileActionBindings,\n      characterControls?.desktopActionBindings,\n      isMobile\n    ])\n\n    const characterCameraBehavior = useMemo(\n      () =>\n        viewMode === 'first-person'\n          ? FirstPersonCharacterCameraBehavior\n          : { zoom: { minDistance: isMobile ? 1 : 0.8, maxDistance: isMobile ? 2.5 : 2 } },\n      [viewMode, isMobile]\n    )\n\n    // Tag the physics root so in-scene helpers (boundary visuals, host proximity\n    // trackers) can find the local player without a prop drill.\n    useEffect(() => {\n      const root = characterRef.current\n      if (!root) return\n      root.userData[CAVE_WORLD_LOCAL_PLAYER_FLAG] = true\n      return () => {\n        delete root.userData[CAVE_WORLD_LOCAL_PLAYER_FLAG]\n      }\n    }, [spaceInited])\n\n    // Drive the character camera ourselves so we can hold a reference to the\n    // `CharacterCameraBehavior` instance (which owns `rotationYaw`/`rotationPitch`).\n    //\n    // Why this is necessary: viverse's `<SimpleCharacter>` internally calls\n    // `useCharacterCameraBehavior(internalRef, cameraBehavior)` and throws away the\n    // returned ref. Every frame the behavior writes\n    //   camera.rotation.set(rotationPitch, rotationYaw, 0, 'YXZ')\n    // and `updateSimpleCharacterVelocity` / `updateSimpleCharacterRotation` then\n    // derive input direction and model yaw from `state.camera` — the character\n    // Group's own quaternion is never read in viverse's orientation pipeline.\n    // `rotationYaw` starts at 0 and is only mutated by pointer deltas, so without\n    // writing it directly there is no way to set the initial facing or re-orient\n    // the player on teleport.\n    //\n    // `cameraBehavior={false}` below short-circuits viverse's internal copy (its\n    // `update()` returns immediately when options === false) so only ours runs.\n    const cameraBehaviorRef = useCharacterCameraBehavior(characterRef, characterCameraBehavior)\n\n    // Expose the behavior through a getter so the ref always reads the latest\n    // instance — `useCharacterCameraBehavior` creates a new one whenever its\n    // effect re-runs, and we want to track that without re-running this effect.\n    useEffect(() => {\n      const root = characterRef.current\n      if (!root) return\n      Object.defineProperty(root, 'viverseCameraBehavior', {\n        get: () => cameraBehaviorRef.current,\n        configurable: true\n      })\n    }, [cameraBehaviorRef])\n\n    const characterScale = useMemo(\n      () => resolveLocalCharacterScale(localCharacterModel),\n      [localCharacterModel]\n    )\n\n    // Keep the options object identity stable across renders: `SimpleCharacter`\n    // and `useSimpleCharacterActionBindings` use dep-less effects that re-run on\n    // every render, and a fresh object there costs real work.\n    const physicsOptions = useMemo(\n      () =>\n        resolveLocalCharacterPhysics(characterScale, {\n          gravity: spaceInited ? DEFAULT_GRAVITY : 0\n        }),\n      [characterScale, spaceInited]\n    )\n\n    const characterModelOptions = useMemo(\n      () => resolveSimpleCharacterModel(localCharacterModel, viewMode),\n      [localCharacterModel, viewMode]\n    )\n\n    const useViverseAvatar = useMemo(\n      () => resolveUseViverseAvatar(localCharacterModel),\n      [localCharacterModel]\n    )\n\n    return (\n      <>\n        <SimpleCharacter\n          ref={characterRef}\n          physics={physicsOptions}\n          scale={characterScale}\n          model={characterModelOptions}\n          useViverseAvatar={useViverseAvatar}\n          actionBindings={characterActionBindings}\n          actionBindingOptions={characterControls?.actionBindingOptions}\n          movement={characterControls?.movement}\n          cameraBehavior={false}\n        />\n\n        {spaceId && multiplayer ? (\n          <RemoteCharacterController\n            appId={spaceId}\n            websocketUrl={multiplayer.url}\n            localCharacterRef={characterRef}\n            localAvatarId={multiplayer.avatarId}\n            avatars={multiplayer.avatars}\n            maxRemoteCharacters={multiplayer.maxRemoteCharacters}\n          />\n        ) : null}\n      </>\n    )\n  }\n)\n\n/**\n * Memoised so re-renders of the exploration root (active-scene churn,\n * action-prompt updates) don't propagate into `<SimpleCharacter>`. Re-rendering\n * it is expensive and, worse, triggers the viverse action-binding bug described\n * in `hooks/use-action-shortcuts.ts` that drops held movement keys.\n */\nexport default memo(ExploreSimpleCharacter)\n"],"names":["DEFAULT_GRAVITY","TRACKED_ANIMATION_NAMES","patchAnimationTracking","characterRef","actions","originals","name","action","original","root","DEFAULT_MOBILE_ACTION_BINDINGS","Vanilla","DEFAULT_DESKTOP_ACTION_BINDINGS","PointerLockRotateZoomActionBindings","KeyboardLocomotionActionBindings","ExploreSimpleCharacter","forwardRef","spaceInited","spaceId","multiplayer","localCharacterModel","characterControls","ref","isMobile","useTouchPrimaryDevice","viewMode","useCaveExplore","s","useRef","useImperativeHandle","useEffect","characterActionBindings","useMemo","characterCameraBehavior","FirstPersonCharacterCameraBehavior","CAVE_WORLD_LOCAL_PLAYER_FLAG","cameraBehaviorRef","useCharacterCameraBehavior","characterScale","resolveLocalCharacterScale","physicsOptions","resolveLocalCharacterPhysics","characterModelOptions","resolveSimpleCharacterModel","useViverseAvatar","resolveUseViverseAvatar","jsxs","Fragment","jsx","SimpleCharacter","RemoteCharacterController","ExploreSimpleCharacter$1","memo"],"mappings":"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"}

package/dist/explore/stores/action-prompt.store.d.ts

@@ -0,0 +1,27 @@
+import { type StoreApi } from 'zustand';
+import type { Vector3 } from '../../types/index.js';
+/** One selectable action offered to the player (detail, portal entry, …). */
+export interface ActionDef {
+    /** Stable identity, used as the React key. */
+    id: string;
+    label: string;
+    /** Single key that triggers `onAction`, e.g. `'F'` or `'1'`. */
+    shortcut?: string;
+    /** Shown but not selectable (e.g. destination still preloading). */
+    disabled?: boolean;
+    onAction: () => void;
+}
+/** `bubble` anchors in 3D next to the object; `panel` is a screen-space list. */
+export type ActionPromptStyle = 'bubble' | 'panel';
+export interface ActionPromptState {
+    actions: ActionDef[];
+    /** World position for `bubble` style; `null` selects the screen panel. */
+    anchor: Vector3 | null;
+    style: ActionPromptStyle;
+    showActions: (actions: ActionDef[], anchor: Vector3 | null, style?: ActionPromptStyle) => void;
+    clearActions: () => void;
+}
+export type ActionPromptStoreApi = StoreApi<ActionPromptState>;
+/** Create an action-prompt store. One per `CaveExploreProvider`. */
+export declare function createActionPromptStore(): ActionPromptStoreApi;
+//# sourceMappingURL=action-prompt.store.d.ts.map

package/dist/explore/stores/action-prompt.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-prompt.store.d.ts","sourceRoot":"","sources":["../../../explore/stores/action-prompt.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAA;AAElD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,0EAA0E;IAC1E,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,iBAAiB,CAAA;IAExB,WAAW,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAA;IAC9F,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAA;AAE9D,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,oBAAoB,CAW9D"}

package/dist/explore/stores/action-prompt.store.js

@@ -0,0 +1,14 @@
+import { createStore as r } from "zustand";
+function l() {
+  return r((n) => ({
+    actions: [],
+    anchor: null,
+    style: "bubble",
+    showActions: (o, t, e = t ? "bubble" : "panel") => n({ actions: o, anchor: t, style: e }),
+    clearActions: () => n((o) => o.actions.length === 0 ? o : { actions: [], anchor: null })
+  }));
+}
+export {
+  l as createActionPromptStore
+};
+//# sourceMappingURL=action-prompt.store.js.map