@cavegiant/cave-world-r3f 1.0.0

package/dist/explore/characters/mixamo-style-bone-map.js

@@ -0,0 +1,28 @@
+const e = {
+  Hips: "hips",
+  Spine: "spine",
+  Spine01: "chest",
+  Spine02: "upperChest",
+  neck: "neck",
+  Head: "head",
+  LeftShoulder: "leftShoulder",
+  LeftArm: "leftUpperArm",
+  LeftForeArm: "leftLowerArm",
+  LeftHand: "leftHand",
+  RightShoulder: "rightShoulder",
+  RightArm: "rightUpperArm",
+  RightForeArm: "rightLowerArm",
+  RightHand: "rightHand",
+  LeftUpLeg: "leftUpperLeg",
+  LeftLeg: "leftLowerLeg",
+  LeftFoot: "leftFoot",
+  LeftToeBase: "leftToes",
+  RightUpLeg: "rightUpperLeg",
+  RightLeg: "rightLowerLeg",
+  RightFoot: "rightFoot",
+  RightToeBase: "rightToes"
+};
+export {
+  e as MIXAMO_STYLE_BONE_MAP
+};
+//# sourceMappingURL=mixamo-style-bone-map.js.map

package/dist/explore/characters/mixamo-style-bone-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixamo-style-bone-map.js","sources":["../../../explore/characters/mixamo-style-bone-map.ts"],"sourcesContent":["import type { VRMHumanBoneName } from '@react-three/viverse'\n\n/**\n * Mixamo-style joint names without the `mixamorig` prefix, mapped to VRM 1.0 humanoid\n * names for `@react-three/viverse` retargeting.\n *\n * Typical extras on rigs (leave unmapped): `head_end`, `headfront`, finger bones if absent.\n */\nexport const MIXAMO_STYLE_BONE_MAP: Record<string, VRMHumanBoneName> = {\n  Hips: 'hips',\n  Spine: 'spine',\n  Spine01: 'chest',\n  Spine02: 'upperChest',\n  neck: 'neck',\n  Head: 'head',\n  LeftShoulder: 'leftShoulder',\n  LeftArm: 'leftUpperArm',\n  LeftForeArm: 'leftLowerArm',\n  LeftHand: 'leftHand',\n  RightShoulder: 'rightShoulder',\n  RightArm: 'rightUpperArm',\n  RightForeArm: 'rightLowerArm',\n  RightHand: 'rightHand',\n  LeftUpLeg: 'leftUpperLeg',\n  LeftLeg: 'leftLowerLeg',\n  LeftFoot: 'leftFoot',\n  LeftToeBase: 'leftToes',\n  RightUpLeg: 'rightUpperLeg',\n  RightLeg: 'rightLowerLeg',\n  RightFoot: 'rightFoot',\n  RightToeBase: 'rightToes'\n}\n"],"names":["MIXAMO_STYLE_BONE_MAP"],"mappings":"AAQO,MAAMA,IAA0D;AAAA,EACrE,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,cAAc;AAAA,EACd,SAAS;AAAA,EACT,aAAa;AAAA,EACb,UAAU;AAAA,EACV,eAAe;AAAA,EACf,UAAU;AAAA,EACV,cAAc;AAAA,EACd,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AAAA,EACX,cAAc;AAChB;"}

package/dist/explore/characters/remote-character-controller.d.ts

@@ -0,0 +1,38 @@
+import { type RefObject } from 'react';
+import type { Group, Object3DEventMap } from 'three';
+import type { Quaternion as QuaternionType, Vector3 as Vector3Type } from '../../types/index.js';
+import { type AnimationName, type AvatarConfig } from './character-configs.js';
+export interface RemoteCharacterData {
+    id?: string;
+    playerId?: string;
+    position?: Vector3Type;
+    rotation?: QuaternionType;
+    animation?: AnimationName;
+    avatarId?: string;
+    lastUpdate?: number;
+}
+export interface RemoteCharacterControllerProps {
+    /** Realtime endpoint. Required — there is no silent CaveGiant default. */
+    websocketUrl: string;
+    /** Room key — normally the space id. */
+    appId: string;
+    /** Local character root, read each tick to publish position/rotation. */
+    localCharacterRef?: RefObject<Group<Object3DEventMap> | null>;
+    localAvatarId?: string;
+    /**
+     * Avatar catalog for remote players. Defaults to an empty catalog (no CDN
+     * fallback). Pass {@link BUILTIN_AVATARS} for the CaveGiant demo assets.
+     */
+    avatars?: Record<string, AvatarConfig>;
+    maxRemoteCharacters?: number;
+    enableNetworkSync?: boolean;
+    onConnectionStatusChange?: (status: string) => void;
+}
+/**
+ * Publishes the local player's transform/animation and renders everyone else.
+ *
+ * Remote state is held in a ref and mirrored into React state only when the
+ * roster changes, so 10 Hz position updates don't re-render the tree.
+ */
+export default function RemoteCharacterController({ websocketUrl, appId, localCharacterRef, localAvatarId, avatars, maxRemoteCharacters, enableNetworkSync, onConnectionStatusChange }: RemoteCharacterControllerProps): import("react").JSX.Element;
+//# sourceMappingURL=remote-character-controller.d.ts.map

package/dist/explore/characters/remote-character-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-character-controller.d.ts","sourceRoot":"","sources":["../../../explore/characters/remote-character-controller.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACnG,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AAGvF,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAA;AAK5B,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAQD,MAAM,WAAW,8BAA8B;IAC7C,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;IACpB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,CAAA;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,EAChD,YAAY,EACZ,KAAK,EACL,iBAAiB,EACjB,aAAiC,EACjC,OAAY,EACZ,mBAAmD,EACnD,iBAAwB,EACxB,wBAAwB,EACzB,EAAE,8BAA8B,+BAmLhC"}

package/dist/explore/characters/remote-character-controller.js

@@ -0,0 +1,135 @@
+import { jsx as h, Fragment as x } from "react/jsx-runtime";
+import { useRef as M, useState as P, useCallback as c, useEffect as R, useMemo as k, Suspense as w } from "react";
+import { createLogger as F } from "../../core/logging/logger.js";
+import { useCharacterSync as $ } from "../hooks/use-character-sync.js";
+import { useCaveExploreStore as V } from "../stores/explore-context.js";
+import { DEFAULT_AVATAR_ID as T, getAvatarConfig as q } from "./character-configs.js";
+import G from "./remote-character.js";
+const d = F("multiplayer:characters"), H = 50, O = 100;
+function ee({
+  websocketUrl: p,
+  appId: f,
+  localCharacterRef: l,
+  localAvatarId: y = T,
+  avatars: g = {},
+  maxRemoteCharacters: S = H,
+  enableNetworkSync: A = !0,
+  onConnectionStatusChange: J
+}) {
+  const n = V(), u = M(/* @__PURE__ */ new Map()), [C, _] = P([]), [v, b] = P(!1), m = M(!1), o = c(() => {
+    _(Array.from(u.current.values()));
+  }, []), E = c(
+    (e) => {
+      n.getState().setRoomInfo((r) => r && { ...r, players: e });
+    },
+    [n]
+  ), L = c(
+    (e) => {
+      const r = e.playerId || e.id;
+      r && (u.current.set(r, { ...e, id: r }), o());
+    },
+    [o]
+  ), N = c(
+    (e) => {
+      const r = e.playerId || e.id;
+      r && (u.current.set(r, { ...e, id: r }), o(), d.debug("Player joined:", r), n.getState().setRoomInfo((t) => !t || t.players.some((s) => s.playerId === r) ? t : {
+        ...t,
+        players: [...t.players, { playerId: r, playerName: r, isMe: !1 }]
+      }));
+    },
+    [o, n]
+  ), U = c(
+    (e) => {
+      u.current.delete(e), o(), d.debug("Player left:", e), n.getState().setRoomInfo((r) => !r || !r.players.some((t) => t.playerId === e) ? r : { ...r, players: r.players.filter((t) => t.playerId !== e) });
+    },
+    [o, n]
+  ), I = c(
+    (e, r) => {
+      const t = /* @__PURE__ */ new Map();
+      for (const s of e) {
+        const i = s.playerId || s.id;
+        i && i !== r && t.set(i, { ...s, id: i });
+      }
+      u.current = t, o(), E(
+        e.map((s) => {
+          const i = s.playerId || s.id || "";
+          return { playerId: i, playerName: i, isMe: i === r };
+        })
+      );
+    },
+    [o, E]
+  ), j = c(
+    (e) => {
+      d.debug("Joined room", e.roomId, "as", e.playerId, { isRejoin: e.isRejoin }), b(!0), m.current = !0, n.getState().setRoomInfo(() => ({
+        roomId: e.roomId,
+        roomName: X(e.roomId),
+        players: e.players.map((r) => {
+          const t = r.playerId || r.id || "";
+          return { playerId: t, playerName: t, isMe: t === e.playerId };
+        })
+      })), I(e.players, e.playerId);
+    },
+    [n, I]
+  ), a = $({
+    websocketUrl: p,
+    appId: f,
+    localAvatarId: y,
+    onPlayerUpdate: L,
+    onPlayerJoin: N,
+    onPlayerLeave: U,
+    onRoomSync: I,
+    onJoinSuccess: j,
+    onConnectionStatusChange: J
+  });
+  R(() => {
+    !a.isConnected || m.current || (m.current = !0, a.joinGame(y));
+  }, [a, y]), R(() => {
+    if (!A || !v || !a.localUserId) return;
+    const e = setInterval(() => {
+      const r = l?.current;
+      !r || !a.isConnected || a.updateState({
+        position: r.position.toArray(),
+        rotation: r.children[0]?.quaternion.toArray(),
+        animation: r.userData.currentAnimation
+      });
+    }, O);
+    return () => clearInterval(e);
+  }, [A, v, l, a]), R(() => {
+    const e = n;
+    return () => {
+      u.current.clear(), m.current = !1, e.getState().setRoomInfo(() => {
+      });
+    };
+  }, [n]);
+  const D = k(() => C.slice(0, S).flatMap((e) => {
+    if (!e.id) return [];
+    const r = q(e.avatarId || T, g);
+    return r ? [
+      // Per-player boundary: an avatar's mesh and its six clips each suspend
+      // separately. A shared boundary would unmount the local character (and
+      // reset its position) every time someone joins.
+      /* @__PURE__ */ h(w, { fallback: null, children: /* @__PURE__ */ h(
+        G,
+        {
+          userId: e.id,
+          characterConfig: r,
+          position: e.position,
+          rotation: e.rotation,
+          currentAnimation: e.animation ?? "idle"
+        }
+      ) }, e.id)
+    ] : (d.warn(`No avatar config for id "${e.avatarId}"; skipping player ${e.id}.`), []);
+  }), [C, S, g]);
+  return /* @__PURE__ */ h(x, { children: D });
+}
+function X(p) {
+  if (!p) return "#0000";
+  let f = 0;
+  for (let l = 0; l < p.length; l++)
+    f = f * 31 + p.charCodeAt(l) >>> 0;
+  return `#${f % 9e3 + 1e3}`;
+}
+export {
+  ee as default
+};
+//# sourceMappingURL=remote-character-controller.js.map

package/dist/explore/characters/remote-character-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-character-controller.js","sources":["../../../explore/characters/remote-character-controller.tsx"],"sourcesContent":["import { Suspense, useCallback, useEffect, useMemo, useRef, useState, type RefObject } from 'react'\nimport type { Group, Object3DEventMap } from 'three'\nimport { createLogger } from '../../core'\nimport type { Quaternion as QuaternionType, Vector3 as Vector3Type } from '../../types'\nimport { useCharacterSync } from '../hooks/use-character-sync'\nimport { useCaveExploreStore } from '../stores/explore-context'\nimport {\n  DEFAULT_AVATAR_ID,\n  getAvatarConfig,\n  type AnimationName,\n  type AvatarConfig\n} from './character-configs'\nimport RemoteCharacter from './remote-character'\n\nconst logger = createLogger('multiplayer:characters')\n\nexport interface RemoteCharacterData {\n  id?: string\n  playerId?: string\n  position?: Vector3Type\n  rotation?: QuaternionType\n  animation?: AnimationName\n  avatarId?: string\n  lastUpdate?: number\n}\n\n/** Cap on simultaneously rendered remote players — each one is a skinned mesh. */\nconst DEFAULT_MAX_REMOTE_CHARACTERS = 50\n\n/** How often the local player's transform is published, in ms. */\nconst STATE_UPDATE_INTERVAL_MS = 100\n\nexport interface RemoteCharacterControllerProps {\n  /** Realtime endpoint. Required — there is no silent CaveGiant default. */\n  websocketUrl: string\n  /** Room key — normally the space id. */\n  appId: string\n  /** Local character root, read each tick to publish position/rotation. */\n  localCharacterRef?: RefObject<Group<Object3DEventMap> | null>\n  localAvatarId?: string\n  /**\n   * Avatar catalog for remote players. Defaults to an empty catalog (no CDN\n   * fallback). Pass {@link BUILTIN_AVATARS} for the CaveGiant demo assets.\n   */\n  avatars?: Record<string, AvatarConfig>\n  maxRemoteCharacters?: number\n  enableNetworkSync?: boolean\n  onConnectionStatusChange?: (status: string) => void\n}\n\n/**\n * Publishes the local player's transform/animation and renders everyone else.\n *\n * Remote state is held in a ref and mirrored into React state only when the\n * roster changes, so 10 Hz position updates don't re-render the tree.\n */\nexport default function RemoteCharacterController({\n  websocketUrl,\n  appId,\n  localCharacterRef,\n  localAvatarId = DEFAULT_AVATAR_ID,\n  avatars = {},\n  maxRemoteCharacters = DEFAULT_MAX_REMOTE_CHARACTERS,\n  enableNetworkSync = true,\n  onConnectionStatusChange\n}: RemoteCharacterControllerProps) {\n  const exploreStore = useCaveExploreStore()\n  const remoteCharactersRef = useRef<Map<string, RemoteCharacterData>>(new Map())\n  const [remoteCharacters, setRemoteCharacters] = useState<RemoteCharacterData[]>([])\n  const [isJoined, setIsJoined] = useState(false)\n  const hasJoinedRef = useRef(false)\n\n  const publishRoster = useCallback(() => {\n    setRemoteCharacters(Array.from(remoteCharactersRef.current.values()))\n  }, [])\n\n  const setRoomPlayers = useCallback(\n    (players: Array<{ playerId: string; playerName: string; isMe: boolean }>) => {\n      exploreStore.getState().setRoomInfo((room) => (room ? { ...room, players } : room))\n    },\n    [exploreStore]\n  )\n\n  const handlePlayerUpdate = useCallback(\n    (data: RemoteCharacterData) => {\n      const id = data.playerId || data.id\n      if (!id) return\n      remoteCharactersRef.current.set(id, { ...data, id })\n      publishRoster()\n    },\n    [publishRoster]\n  )\n\n  const handlePlayerJoin = useCallback(\n    (data: RemoteCharacterData) => {\n      const id = data.playerId || data.id\n      if (!id) return\n      remoteCharactersRef.current.set(id, { ...data, id })\n      publishRoster()\n      logger.debug('Player joined:', id)\n\n      exploreStore.getState().setRoomInfo((room) => {\n        if (!room || room.players.some((player) => player.playerId === id)) return room\n        return {\n          ...room,\n          players: [...room.players, { playerId: id, playerName: id, isMe: false }]\n        }\n      })\n    },\n    [publishRoster, exploreStore]\n  )\n\n  const handlePlayerLeave = useCallback(\n    (playerId: string) => {\n      remoteCharactersRef.current.delete(playerId)\n      publishRoster()\n      logger.debug('Player left:', playerId)\n\n      exploreStore.getState().setRoomInfo((room) => {\n        if (!room || !room.players.some((player) => player.playerId === playerId)) return room\n        return { ...room, players: room.players.filter((p) => p.playerId !== playerId) }\n      })\n    },\n    [publishRoster, exploreStore]\n  )\n\n  const handleRoomSync = useCallback(\n    (players: RemoteCharacterData[], localPlayerId?: string) => {\n      const next = new Map<string, RemoteCharacterData>()\n      for (const player of players) {\n        const id = player.playerId || player.id\n        if (id && id !== localPlayerId) next.set(id, { ...player, id })\n      }\n      remoteCharactersRef.current = next\n      publishRoster()\n\n      setRoomPlayers(\n        players.map((player) => {\n          const id = player.playerId || player.id || ''\n          return { playerId: id, playerName: id, isMe: id === localPlayerId }\n        })\n      )\n    },\n    [publishRoster, setRoomPlayers]\n  )\n\n  const handleJoinSuccess = useCallback(\n    (data: {\n      roomId: string\n      playerId: string\n      players: RemoteCharacterData[]\n      isRejoin: boolean\n    }) => {\n      logger.debug('Joined room', data.roomId, 'as', data.playerId, { isRejoin: data.isRejoin })\n      setIsJoined(true)\n      hasJoinedRef.current = true\n\n      exploreStore.getState().setRoomInfo(() => ({\n        roomId: data.roomId,\n        roomName: formatRoomName(data.roomId),\n        players: data.players.map((player) => {\n          const id = player.playerId || player.id || ''\n          return { playerId: id, playerName: id, isMe: id === data.playerId }\n        })\n      }))\n\n      handleRoomSync(data.players, data.playerId)\n    },\n    [exploreStore, handleRoomSync]\n  )\n\n  const websocket = useCharacterSync({\n    websocketUrl,\n    appId,\n    localAvatarId,\n    onPlayerUpdate: handlePlayerUpdate,\n    onPlayerJoin: handlePlayerJoin,\n    onPlayerLeave: handlePlayerLeave,\n    onRoomSync: handleRoomSync,\n    onJoinSuccess: handleJoinSuccess,\n    onConnectionStatusChange\n  })\n\n  // Join once per connection.\n  useEffect(() => {\n    if (!websocket.isConnected || hasJoinedRef.current) return\n    hasJoinedRef.current = true\n    websocket.joinGame(localAvatarId)\n  }, [websocket, localAvatarId])\n\n  // Publish local transform on a fixed interval (not per frame — that would\n  // flood the socket at display refresh rate).\n  useEffect(() => {\n    if (!enableNetworkSync || !isJoined || !websocket.localUserId) return\n\n    const interval = setInterval(() => {\n      const character = localCharacterRef?.current\n      if (!character || !websocket.isConnected) return\n      websocket.updateState({\n        position: character.position.toArray() as Vector3Type,\n        rotation: character.children[0]?.quaternion.toArray() as QuaternionType,\n        animation: character.userData.currentAnimation as AnimationName\n      })\n    }, STATE_UPDATE_INTERVAL_MS)\n\n    return () => clearInterval(interval)\n  }, [enableNetworkSync, isJoined, localCharacterRef, websocket])\n\n  useEffect(() => {\n    const store = exploreStore\n    return () => {\n      remoteCharactersRef.current.clear()\n      hasJoinedRef.current = false\n      store.getState().setRoomInfo(() => undefined)\n    }\n  }, [exploreStore])\n\n  const rendered = useMemo(() => {\n    return remoteCharacters.slice(0, maxRemoteCharacters).flatMap((data) => {\n      if (!data.id) return []\n      const avatarConfig = getAvatarConfig(data.avatarId || DEFAULT_AVATAR_ID, avatars)\n      if (!avatarConfig) {\n        logger.warn(`No avatar config for id \"${data.avatarId}\"; skipping player ${data.id}.`)\n        return []\n      }\n\n      return [\n        // Per-player boundary: an avatar's mesh and its six clips each suspend\n        // separately. A shared boundary would unmount the local character (and\n        // reset its position) every time someone joins.\n        <Suspense key={data.id} fallback={null}>\n          <RemoteCharacter\n            userId={data.id}\n            characterConfig={avatarConfig}\n            position={data.position}\n            rotation={data.rotation}\n            currentAnimation={data.animation ?? 'idle'}\n          />\n        </Suspense>\n      ]\n    })\n  }, [remoteCharacters, maxRemoteCharacters, avatars])\n\n  return <>{rendered}</>\n}\n\n/**\n * Short, stable display name derived from a room id (`\"#4271\"`).\n *\n * Hashing keeps it deterministic so every client in a room shows the same label\n * without an extra round trip.\n */\nfunction formatRoomName(roomId: string): string {\n  if (!roomId) return '#0000'\n  let hash = 0\n  for (let i = 0; i < roomId.length; i++) {\n    hash = (hash * 31 + roomId.charCodeAt(i)) >>> 0\n  }\n  return `#${(hash % 9000) + 1000}`\n}\n"],"names":["logger","createLogger","DEFAULT_MAX_REMOTE_CHARACTERS","STATE_UPDATE_INTERVAL_MS","RemoteCharacterController","websocketUrl","appId","localCharacterRef","localAvatarId","DEFAULT_AVATAR_ID","avatars","maxRemoteCharacters","enableNetworkSync","onConnectionStatusChange","exploreStore","useCaveExploreStore","remoteCharactersRef","useRef","remoteCharacters","setRemoteCharacters","useState","isJoined","setIsJoined","hasJoinedRef","publishRoster","useCallback","setRoomPlayers","players","room","handlePlayerUpdate","data","id","handlePlayerJoin","player","handlePlayerLeave","playerId","p","handleRoomSync","localPlayerId","next","handleJoinSuccess","formatRoomName","websocket","useCharacterSync","useEffect","interval","character","store","rendered","useMemo","avatarConfig","getAvatarConfig","jsx","Suspense","RemoteCharacter","roomId","hash","i"],"mappings":"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"}

package/dist/explore/characters/remote-character.d.ts

@@ -0,0 +1,19 @@
+import type { Quaternion as QuaternionType, Vector3 as Vector3Type } from '../../types/index.js';
+import { type AnimationName, type AvatarConfig } from './character-configs.js';
+export interface RemoteCharacterProps {
+    userId: string;
+    characterConfig: AvatarConfig;
+    /** Latest network position; interpolated toward each frame. */
+    position?: Vector3Type;
+    /** Latest network rotation; interpolated toward each frame. */
+    rotation?: QuaternionType;
+    currentAnimation?: AnimationName;
+}
+/**
+ * Another player's avatar, driven purely by network state.
+ *
+ * Position and rotation are interpolated on the render loop rather than snapped,
+ * because updates arrive far slower than the frame rate.
+ */
+export default function RemoteCharacter({ characterConfig, position, rotation, currentAnimation }: RemoteCharacterProps): import("react").JSX.Element;
+//# sourceMappingURL=remote-character.d.ts.map

package/dist/explore/characters/remote-character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-character.d.ts","sourceRoot":"","sources":["../../../explore/characters/remote-character.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAA;AAwB5B,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,YAAY,CAAA;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,gBAAgB,CAAC,EAAE,aAAa,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EACtC,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,gBAAgB,EACjB,EAAE,oBAAoB,+BAwGtB"}

package/dist/explore/characters/remote-character.js

@@ -0,0 +1,63 @@
+import { jsx as P } from "react/jsx-runtime";
+import { useGLTF as u, useAnimations as k } from "@react-three/drei";
+import { useFrame as b } from "@react-three/fiber";
+import { useRef as m, useMemo as x, useEffect as D, useCallback as y } from "react";
+import { Vector3 as h, Quaternion as v, LoopOnce as H, LoopRepeat as Q } from "three";
+import { clone as g } from "three/examples/jsm/utils/SkeletonUtils.js";
+import { SUPPORTED_ANIMATION_NAMES as q } from "./character-configs.js";
+const G = 0.1, V = 0.1, L = 0.2, W = /* @__PURE__ */ new Set(["jumpDown", "jumpUp", "jumpForward"]), z = 0.8;
+function a(o, i, r) {
+  const c = o?.[0];
+  if (!c) return;
+  const s = c.clone();
+  s.name = i, r.push(s);
+}
+function nn({
+  characterConfig: o,
+  position: i,
+  rotation: r,
+  currentAnimation: c
+}) {
+  const s = m(null), A = m(null), O = m({}), R = m(null), j = m(new h()), w = m(new v()), d = u(o.model.url), p = x(() => d.scene ? g(d.scene) : null, [d.scene]), T = u(o.animations.idle.url), _ = u(o.animations.walk.url), E = u(o.animations.run.url), I = u(o.animations.jumpDown.url), N = u(o.animations.jumpUp.url), S = u(o.animations.jumpForward.url), C = x(() => {
+    const n = [];
+    return a(T.animations, "idle", n), a(_.animations, "walk", n), a(E.animations, "run", n), a(I.animations, "jumpDown", n), a(N.animations, "jumpUp", n), a(S.animations, "jumpForward", n), n;
+  }, [
+    T.animations,
+    _.animations,
+    E.animations,
+    I.animations,
+    N.animations,
+    S.animations
+  ]), l = k(C, s);
+  D(() => {
+    if (!l || !p) return;
+    A.current = l.mixer;
+    const n = {};
+    for (const t of q) {
+      const e = l.clips.find((U) => U.name === t), M = s.current;
+      if (!e || !M) continue;
+      const f = l.mixer.clipAction(e, M);
+      W.has(t) ? (f.loop = H, f.clampWhenFinished = !0) : f.loop = Q, n[t] = f;
+    }
+    return O.current = n, () => {
+      for (const t of Object.values(n)) t.stop();
+      R.current = null;
+    };
+  }, [l, p]);
+  const F = y((n) => {
+    const t = O.current[n];
+    if (!A.current || !t) return;
+    const e = R.current;
+    e !== t && (e?.fadeOut(L), t.reset().fadeIn(L).play(), R.current = t);
+  }, []);
+  return D(() => {
+    i && j.current.set(i[0], i[1], i[2]), r && w.current.set(r[0], r[1], r[2], r[3]), c && F(c);
+  }, [i, r, c, F]), b((n, t) => {
+    const e = s.current;
+    e && (e.position.lerp(j.current, G), e.quaternion.slerp(w.current, V), A.current?.update(t));
+  }), /* @__PURE__ */ P("group", { ref: s, children: p ? /* @__PURE__ */ P("primitive", { scale: z, "rotation-y": Math.PI, object: p }) : null });
+}
+export {
+  nn as default
+};
+//# sourceMappingURL=remote-character.js.map

package/dist/explore/characters/remote-character.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-character.js","sources":["../../../explore/characters/remote-character.tsx"],"sourcesContent":["import { useAnimations, useGLTF } from '@react-three/drei'\nimport { useFrame } from '@react-three/fiber'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport type { AnimationClip, Group } from 'three'\nimport {\n  LoopOnce,\n  LoopRepeat,\n  Quaternion,\n  Vector3,\n  type AnimationAction,\n  type AnimationMixer\n} from 'three'\nimport { clone } from 'three/examples/jsm/utils/SkeletonUtils.js'\nimport type { Quaternion as QuaternionType, Vector3 as Vector3Type } from '../../types'\nimport {\n  SUPPORTED_ANIMATION_NAMES,\n  type AnimationName,\n  type AvatarConfig\n} from './character-configs'\n\n/** Remote transforms arrive at ~10 Hz; these smooth them to display rate. */\nconst POSITION_LERP_FACTOR = 0.1\nconst ROTATION_LERP_FACTOR = 0.1\nconst ANIMATION_CROSSFADE_SEC = 0.2\n\nconst ONE_SHOT_ANIMATIONS = new Set<AnimationName>(['jumpDown', 'jumpUp', 'jumpForward'])\n\nconst REMOTE_CHARACTER_SCALE = 0.8\n\n/** Clips ship one per file; clone + rename so one mixer can address them all. */\nfunction pushClonedNamedClip(\n  clips: AnimationClip[] | undefined,\n  name: string,\n  out: AnimationClip[]\n): void {\n  const first = clips?.[0]\n  if (!first) return\n  const clip = first.clone()\n  clip.name = name\n  out.push(clip)\n}\n\nexport interface RemoteCharacterProps {\n  userId: string\n  characterConfig: AvatarConfig\n  /** Latest network position; interpolated toward each frame. */\n  position?: Vector3Type\n  /** Latest network rotation; interpolated toward each frame. */\n  rotation?: QuaternionType\n  currentAnimation?: AnimationName\n}\n\n/**\n * Another player's avatar, driven purely by network state.\n *\n * Position and rotation are interpolated on the render loop rather than snapped,\n * because updates arrive far slower than the frame rate.\n */\nexport default function RemoteCharacter({\n  characterConfig,\n  position,\n  rotation,\n  currentAnimation\n}: RemoteCharacterProps) {\n  const groupRef = useRef<Group>(null)\n  const mixerRef = useRef<AnimationMixer | null>(null)\n  const actionsRef = useRef<Record<string, AnimationAction>>({})\n  const currentActionRef = useRef<AnimationAction | null>(null)\n\n  const targetPositionRef = useRef(new Vector3())\n  const targetQuaternionRef = useRef(new Quaternion())\n\n  const gltf = useGLTF(characterConfig.model.url)\n  const gltfScene = useMemo(() => (gltf.scene ? clone(gltf.scene) : null), [gltf.scene])\n\n  const idleAnim = useGLTF(characterConfig.animations.idle.url)\n  const walkAnim = useGLTF(characterConfig.animations.walk.url)\n  const runAnim = useGLTF(characterConfig.animations.run.url)\n  const jumpDownAnim = useGLTF(characterConfig.animations.jumpDown.url)\n  const jumpUpAnim = useGLTF(characterConfig.animations.jumpUp.url)\n  const jumpForwardAnim = useGLTF(characterConfig.animations.jumpForward.url)\n\n  const allAnimations = useMemo(() => {\n    const animations: AnimationClip[] = []\n    pushClonedNamedClip(idleAnim.animations, 'idle', animations)\n    pushClonedNamedClip(walkAnim.animations, 'walk', animations)\n    pushClonedNamedClip(runAnim.animations, 'run', animations)\n    pushClonedNamedClip(jumpDownAnim.animations, 'jumpDown', animations)\n    pushClonedNamedClip(jumpUpAnim.animations, 'jumpUp', animations)\n    pushClonedNamedClip(jumpForwardAnim.animations, 'jumpForward', animations)\n    return animations\n  }, [\n    idleAnim.animations,\n    walkAnim.animations,\n    runAnim.animations,\n    jumpDownAnim.animations,\n    jumpUpAnim.animations,\n    jumpForwardAnim.animations\n  ])\n\n  const animations = useAnimations(allAnimations, groupRef)\n\n  useEffect(() => {\n    if (!animations || !gltfScene) return\n\n    mixerRef.current = animations.mixer\n    const actions: Record<string, AnimationAction> = {}\n\n    for (const name of SUPPORTED_ANIMATION_NAMES) {\n      const clip = animations.clips.find((candidate) => candidate.name === name)\n      const root = groupRef.current\n      if (!clip || !root) continue\n\n      const action = animations.mixer.clipAction(clip, root)\n      if (ONE_SHOT_ANIMATIONS.has(name)) {\n        action.loop = LoopOnce\n        action.clampWhenFinished = true\n      } else {\n        action.loop = LoopRepeat\n      }\n      actions[name] = action\n    }\n\n    actionsRef.current = actions\n\n    return () => {\n      for (const action of Object.values(actions)) action.stop()\n      currentActionRef.current = null\n    }\n  }, [animations, gltfScene])\n\n  const playAnimation = useCallback((animationName: AnimationName) => {\n    const nextAction = actionsRef.current[animationName]\n    if (!mixerRef.current || !nextAction) return\n\n    const currentAction = currentActionRef.current\n    if (currentAction === nextAction) return\n\n    currentAction?.fadeOut(ANIMATION_CROSSFADE_SEC)\n    nextAction.reset().fadeIn(ANIMATION_CROSSFADE_SEC).play()\n    currentActionRef.current = nextAction\n  }, [])\n\n  useEffect(() => {\n    if (position) targetPositionRef.current.set(position[0], position[1], position[2])\n    if (rotation) {\n      targetQuaternionRef.current.set(rotation[0], rotation[1], rotation[2], rotation[3])\n    }\n    if (currentAnimation) playAnimation(currentAnimation)\n  }, [position, rotation, currentAnimation, playAnimation])\n\n  useFrame((_, delta) => {\n    const group = groupRef.current\n    if (!group) return\n\n    group.position.lerp(targetPositionRef.current, POSITION_LERP_FACTOR)\n    group.quaternion.slerp(targetQuaternionRef.current, ROTATION_LERP_FACTOR)\n    mixerRef.current?.update(delta)\n  })\n\n  return (\n    <group ref={groupRef}>\n      {gltfScene ? (\n        <primitive scale={REMOTE_CHARACTER_SCALE} rotation-y={Math.PI} object={gltfScene} />\n      ) : null}\n    </group>\n  )\n}\n"],"names":["POSITION_LERP_FACTOR","ROTATION_LERP_FACTOR","ANIMATION_CROSSFADE_SEC","ONE_SHOT_ANIMATIONS","REMOTE_CHARACTER_SCALE","pushClonedNamedClip","clips","name","out","first","clip","RemoteCharacter","characterConfig","position","rotation","currentAnimation","groupRef","useRef","mixerRef","actionsRef","currentActionRef","targetPositionRef","Vector3","targetQuaternionRef","Quaternion","gltf","useGLTF","gltfScene","useMemo","clone","idleAnim","walkAnim","runAnim","jumpDownAnim","jumpUpAnim","jumpForwardAnim","allAnimations","animations","useAnimations","useEffect","actions","SUPPORTED_ANIMATION_NAMES","candidate","root","action","LoopOnce","LoopRepeat","playAnimation","useCallback","animationName","nextAction","currentAction","useFrame","_","delta","group","jsx"],"mappings":"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"}

package/dist/explore/connected-spaces-renderer.d.ts

@@ -0,0 +1,16 @@
+export interface ConnectedSpacesRendererProps {
+    primarySpaceId: string | undefined;
+    revealOnEnter: boolean;
+    connectorLabels: boolean;
+    onPrimaryInitialized: () => void;
+}
+/**
+ * Render every loaded space — the primary plus its preloaded neighbors — with
+ * visibility, physics, and connector sensors gated on the active space id, and
+ * group matrices driven by the computed seamless transforms.
+ *
+ * Neighbors stay mounted (hidden) so their splat meshes remain in GPU memory,
+ * which is what makes a seamless transition instant.
+ */
+export default function ConnectedSpacesRenderer({ primarySpaceId, revealOnEnter, connectorLabels, onPrimaryInitialized }: ConnectedSpacesRendererProps): import("react").JSX.Element;
+//# sourceMappingURL=connected-spaces-renderer.d.ts.map

package/dist/explore/connected-spaces-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-spaces-renderer.d.ts","sourceRoot":"","sources":["../../explore/connected-spaces-renderer.tsx"],"names":[],"mappings":"AAwHA,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,OAAO,CAAA;IACxB,oBAAoB,EAAE,MAAM,IAAI,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAC9C,cAAc,EACd,aAAa,EACb,eAAe,EACf,oBAAoB,EACrB,EAAE,4BAA4B,+BA6B9B"}

package/dist/explore/connected-spaces-renderer.js

@@ -0,0 +1,103 @@
+import { jsx as s, Fragment as I } from "react/jsx-runtime";
+import { useMemo as l, memo as v, useCallback as b, Suspense as x } from "react";
+import { Matrix4 as E } from "three";
+import { useCaveEventBus as h } from "../core/context/cave-world-context.js";
+import y from "../space/cave-space.js";
+import { useCaveExplore as f, useCaveExploreStore as g } from "./stores/explore-context.js";
+const j = /* @__PURE__ */ Object.freeze({}), k = v(function({
+  id: t,
+  space: p,
+  active: n,
+  isPrimary: c,
+  revealOnEnter: a,
+  connectorLabels: d,
+  onPrimaryInitialized: o,
+  connectedSpaces: m,
+  readySpaceIds: u,
+  activeConnectorId: e
+}) {
+  const r = g(), S = h(), C = b(() => {
+    r.getState().markSpaceReady(t), S.emit("space:transfer:ready", { spaceId: t }), c && o();
+  }, [t, r, S, c, o]);
+  return /* @__PURE__ */ s(x, { fallback: null, children: /* @__PURE__ */ s(
+    y,
+    {
+      space: p,
+      spaceId: t,
+      physics: n,
+      active: n,
+      connectedSpaces: m,
+      readySpaceIds: u,
+      activeConnectorId: e,
+      connectorLabels: d,
+      revealOnEnter: a && c,
+      onInitialized: C
+    }
+  ) });
+}), M = v(function({
+  id: t,
+  space: p,
+  m16: n,
+  isActive: c,
+  isPrimary: a,
+  revealOnEnter: d,
+  connectorLabels: o,
+  onPrimaryInitialized: m,
+  connectedSpaces: u,
+  readySpaceIds: e,
+  activeConnectorId: r
+}) {
+  const S = l(() => n ? new E().fromArray(n) : void 0, [n]);
+  return /* @__PURE__ */ s(
+    "group",
+    {
+      visible: c,
+      name: a ? "cave-space-primary" : `cave-space-connected-${t}`,
+      ...S ? { matrix: S, matrixAutoUpdate: !1 } : {},
+      children: /* @__PURE__ */ s(
+        k,
+        {
+          id: t,
+          space: p,
+          active: c,
+          isPrimary: a,
+          revealOnEnter: d,
+          connectorLabels: o,
+          onPrimaryInitialized: m,
+          connectedSpaces: u,
+          readySpaceIds: c ? e : j,
+          activeConnectorId: c ? r : void 0
+        }
+      )
+    }
+  );
+});
+function B({
+  primarySpaceId: i,
+  revealOnEnter: t,
+  connectorLabels: p,
+  onPrimaryInitialized: n
+}) {
+  const c = f((e) => e.activeSpaceId), a = f((e) => e.connectedSpaces), d = f((e) => e.readySpaceIds), o = f((e) => e.spaceTransforms), m = f((e) => e.activeConnector?.id), u = l(() => Object.entries(a), [a]);
+  return /* @__PURE__ */ s(I, { children: u.map(([e, r]) => /* @__PURE__ */ s(
+    M,
+    {
+      id: e,
+      space: r,
+      m16: o[e],
+      isActive: c === e,
+      isPrimary: e === i,
+      revealOnEnter: t,
+      connectorLabels: p,
+      onPrimaryInitialized: n,
+      connectedSpaces: a,
+      readySpaceIds: d,
+      activeConnectorId: m
+    },
+    e
+  )) });
+}
+export {
+  B as default
+};
+//# sourceMappingURL=connected-spaces-renderer.js.map

package/dist/explore/connected-spaces-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-spaces-renderer.js","sources":["../../explore/connected-spaces-renderer.tsx"],"sourcesContent":["import { memo, Suspense, useCallback, useMemo } from 'react'\nimport { Matrix4 } from 'three'\nimport { useCaveEventBus } from '../core'\nimport { CaveSpace } from '../space'\nimport type { CaveSpace as CaveSpaceConfig, Matrix16 } from '../types'\nimport { useCaveExplore, useCaveExploreStore } from './stores/explore-context'\n\nconst EMPTY_READY_SPACE_IDS = /* @__PURE__ */ Object.freeze({}) as Record<string, true>\n\ninterface SpaceSubtreeProps {\n  id: string\n  space: CaveSpaceConfig\n  active: boolean\n  isPrimary: boolean\n  revealOnEnter: boolean\n  connectorLabels: boolean\n  onPrimaryInitialized: () => void\n  connectedSpaces: Record<string, CaveSpaceConfig>\n  readySpaceIds: Record<string, true>\n  activeConnectorId?: string\n}\n\n/**\n * One space's content.\n *\n * Memoised so a re-render caused by *another* space's matrix or active flag\n * doesn't cascade into this subtree's expensive parts (splat mesh, per-object\n * Suspense boundaries). Its own Suspense boundary keeps a still-streaming\n * sibling from blanking the whole canvas.\n */\nconst SpaceSubtree = memo(function SpaceSubtree({\n  id,\n  space,\n  active,\n  isPrimary,\n  revealOnEnter,\n  connectorLabels,\n  onPrimaryInitialized,\n  connectedSpaces,\n  readySpaceIds,\n  activeConnectorId\n}: SpaceSubtreeProps) {\n  const store = useCaveExploreStore()\n  const eventBus = useCaveEventBus()\n\n  const handleInitialized = useCallback(() => {\n    store.getState().markSpaceReady(id)\n    eventBus.emit('space:transfer:ready', { spaceId: id })\n    if (isPrimary) onPrimaryInitialized()\n  }, [id, store, eventBus, isPrimary, onPrimaryInitialized])\n\n  return (\n    <Suspense fallback={null}>\n      <CaveSpace\n        space={space}\n        spaceId={id}\n        physics={active}\n        active={active}\n        connectedSpaces={connectedSpaces}\n        readySpaceIds={readySpaceIds}\n        activeConnectorId={activeConnectorId}\n        connectorLabels={connectorLabels}\n        revealOnEnter={revealOnEnter && isPrimary}\n        onInitialized={handleInitialized}\n      />\n    </Suspense>\n  )\n})\n\ninterface ConnectedSpaceGroupProps extends Omit<SpaceSubtreeProps, 'active'> {\n  m16: Matrix16 | undefined\n  isActive: boolean\n}\n\n/**\n * A space's world-space group plus its subtree.\n *\n * The `Matrix4` is derived from this space's own `Matrix16`, so a neighbor load\n * that changes one space's transform doesn't re-allocate every other space's\n * matrix — unchanged spaces keep a stable `matrix` prop reference.\n */\nconst ConnectedSpaceGroup = memo(function ConnectedSpaceGroup({\n  id,\n  space,\n  m16,\n  isActive,\n  isPrimary,\n  revealOnEnter,\n  connectorLabels,\n  onPrimaryInitialized,\n  connectedSpaces,\n  readySpaceIds,\n  activeConnectorId\n}: ConnectedSpaceGroupProps) {\n  const matrix = useMemo(() => (m16 ? new Matrix4().fromArray(m16) : undefined), [m16])\n\n  return (\n    <group\n      visible={isActive}\n      name={isPrimary ? 'cave-space-primary' : `cave-space-connected-${id}`}\n      {...(matrix ? { matrix, matrixAutoUpdate: false } : {})}\n    >\n      <SpaceSubtree\n        id={id}\n        space={space}\n        active={isActive}\n        isPrimary={isPrimary}\n        revealOnEnter={revealOnEnter}\n        connectorLabels={connectorLabels}\n        onPrimaryInitialized={onPrimaryInitialized}\n        connectedSpaces={connectedSpaces}\n        // Inactive spaces don't render connector UI, so hand them frozen empty\n        // inputs and keep their memo from invalidating on unrelated updates.\n        readySpaceIds={isActive ? readySpaceIds : EMPTY_READY_SPACE_IDS}\n        activeConnectorId={isActive ? activeConnectorId : undefined}\n      />\n    </group>\n  )\n})\n\nexport interface ConnectedSpacesRendererProps {\n  primarySpaceId: string | undefined\n  revealOnEnter: boolean\n  connectorLabels: boolean\n  onPrimaryInitialized: () => void\n}\n\n/**\n * Render every loaded space — the primary plus its preloaded neighbors — with\n * visibility, physics, and connector sensors gated on the active space id, and\n * group matrices driven by the computed seamless transforms.\n *\n * Neighbors stay mounted (hidden) so their splat meshes remain in GPU memory,\n * which is what makes a seamless transition instant.\n */\nexport default function ConnectedSpacesRenderer({\n  primarySpaceId,\n  revealOnEnter,\n  connectorLabels,\n  onPrimaryInitialized\n}: ConnectedSpacesRendererProps) {\n  const activeSpaceId = useCaveExplore((s) => s.activeSpaceId)\n  const connectedSpaces = useCaveExplore((s) => s.connectedSpaces)\n  const readySpaceIds = useCaveExplore((s) => s.readySpaceIds)\n  const spaceTransforms = useCaveExplore((s) => s.spaceTransforms)\n  const activeConnectorId = useCaveExplore((s) => s.activeConnector?.id)\n\n  const entries = useMemo(() => Object.entries(connectedSpaces), [connectedSpaces])\n\n  return (\n    <>\n      {entries.map(([id, space]) => (\n        <ConnectedSpaceGroup\n          key={id}\n          id={id}\n          space={space}\n          m16={spaceTransforms[id]}\n          isActive={activeSpaceId === id}\n          isPrimary={id === primarySpaceId}\n          revealOnEnter={revealOnEnter}\n          connectorLabels={connectorLabels}\n          onPrimaryInitialized={onPrimaryInitialized}\n          connectedSpaces={connectedSpaces}\n          readySpaceIds={readySpaceIds}\n          activeConnectorId={activeConnectorId}\n        />\n      ))}\n    </>\n  )\n}\n"],"names":["EMPTY_READY_SPACE_IDS","SpaceSubtree","memo","id","space","active","isPrimary","revealOnEnter","connectorLabels","onPrimaryInitialized","connectedSpaces","readySpaceIds","activeConnectorId","store","useCaveExploreStore","eventBus","useCaveEventBus","handleInitialized","useCallback","jsx","Suspense","CaveSpace","ConnectedSpaceGroup","m16","isActive","matrix","useMemo","Matrix4","ConnectedSpacesRenderer","primarySpaceId","activeSpaceId","useCaveExplore","s","spaceTransforms","entries"],"mappings":"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"}

package/dist/explore/hooks/use-action-shortcuts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Register a single global keydown listener that resolves the pressed key
+ * against the current action prompt.
+ *
+ * Deliberately reads through `store.getState()` instead of subscribing to
+ * `actions`. Subscribing would re-render the component hosting this hook —
+ * the parent of `<ExploreSimpleCharacter>` — on every prompt show/hide, and
+ * that cascade hits a bug in `@react-three/viverse`'s
+ * `useSimpleCharacterActionBindings`: its dep-less effect recreates the
+ * keyboard bindings on every render (the `instanceof` guard can never pass),
+ * and a fresh `KeyboardActionBinding` starts with an empty `pressedKeys` set.
+ * The visible symptom is the character stopping mid-walk whenever a connector
+ * prompt appears.
+ */
+export declare function useActionShortcuts(): void;
+//# sourceMappingURL=use-action-shortcuts.d.ts.map

package/dist/explore/hooks/use-action-shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-action-shortcuts.d.ts","sourceRoot":"","sources":["../../../explore/hooks/use-action-shortcuts.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CA0BzC"}

package/dist/explore/hooks/use-action-shortcuts.js

@@ -0,0 +1,23 @@
+import { useEffect as c } from "react";
+import { useActionPromptStore as i } from "../stores/explore-context.js";
+function f() {
+  const o = i();
+  c(() => {
+    const r = (t) => {
+      if (t.target instanceof HTMLInputElement || t.target instanceof HTMLTextAreaElement || t.repeat || t.metaKey || t.ctrlKey || t.altKey) return;
+      const { actions: n } = o.getState();
+      if (n.length === 0) return;
+      const s = t.key.toLowerCase();
+      for (const e of n)
+        if (!(e.disabled || !e.shortcut) && s === e.shortcut.toLowerCase()) {
+          t.preventDefault(), e.onAction();
+          return;
+        }
+    };
+    return document.addEventListener("keydown", r), () => document.removeEventListener("keydown", r);
+  }, [o]);
+}
+export {
+  f as useActionShortcuts
+};
+//# sourceMappingURL=use-action-shortcuts.js.map

package/dist/explore/hooks/use-action-shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-action-shortcuts.js","sources":["../../../explore/hooks/use-action-shortcuts.ts"],"sourcesContent":["import { useEffect } from 'react'\nimport { useActionPromptStore } from '../stores/explore-context'\n\n/**\n * Register a single global keydown listener that resolves the pressed key\n * against the current action prompt.\n *\n * Deliberately reads through `store.getState()` instead of subscribing to\n * `actions`. Subscribing would re-render the component hosting this hook —\n * the parent of `<ExploreSimpleCharacter>` — on every prompt show/hide, and\n * that cascade hits a bug in `@react-three/viverse`'s\n * `useSimpleCharacterActionBindings`: its dep-less effect recreates the\n * keyboard bindings on every render (the `instanceof` guard can never pass),\n * and a fresh `KeyboardActionBinding` starts with an empty `pressedKeys` set.\n * The visible symptom is the character stopping mid-walk whenever a connector\n * prompt appears.\n */\nexport function useActionShortcuts(): void {\n  const store = useActionPromptStore()\n\n  useEffect(() => {\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.target instanceof HTMLInputElement) return\n      if (event.target instanceof HTMLTextAreaElement) return\n      if (event.repeat || event.metaKey || event.ctrlKey || event.altKey) return\n\n      const { actions } = store.getState()\n      if (actions.length === 0) return\n\n      const pressed = event.key.toLowerCase()\n      for (const action of actions) {\n        if (action.disabled || !action.shortcut) continue\n        if (pressed === action.shortcut.toLowerCase()) {\n          event.preventDefault()\n          action.onAction()\n          return\n        }\n      }\n    }\n\n    document.addEventListener('keydown', handleKeyDown)\n    return () => document.removeEventListener('keydown', handleKeyDown)\n  }, [store])\n}\n"],"names":["useActionShortcuts","store","useActionPromptStore","useEffect","handleKeyDown","event","actions","pressed","action"],"mappings":";;AAiBO,SAASA,IAA2B;AACzC,QAAMC,IAAQC,EAAA;AAEd,EAAAC,EAAU,MAAM;AACd,UAAMC,IAAgB,CAACC,MAAyB;AAG9C,UAFIA,EAAM,kBAAkB,oBACxBA,EAAM,kBAAkB,uBACxBA,EAAM,UAAUA,EAAM,WAAWA,EAAM,WAAWA,EAAM,OAAQ;AAEpE,YAAM,EAAE,SAAAC,EAAA,IAAYL,EAAM,SAAA;AAC1B,UAAIK,EAAQ,WAAW,EAAG;AAE1B,YAAMC,IAAUF,EAAM,IAAI,YAAA;AAC1B,iBAAWG,KAAUF;AACnB,YAAI,EAAAE,EAAO,YAAY,CAACA,EAAO,aAC3BD,MAAYC,EAAO,SAAS,YAAA,GAAe;AAC7C,UAAAH,EAAM,eAAA,GACNG,EAAO,SAAA;AACP;AAAA,QACF;AAAA,IAEJ;AAEA,oBAAS,iBAAiB,WAAWJ,CAAa,GAC3C,MAAM,SAAS,oBAAoB,WAAWA,CAAa;AAAA,EACpE,GAAG,CAACH,CAAK,CAAC;AACZ;"}

package/dist/explore/hooks/use-active-space-notify.d.ts

@@ -0,0 +1,11 @@
+import type { CaveSpace } from '../../types/index.js';
+/**
+ * Notify the host of the scene the player is currently in — once for the
+ * initial scene and again after every seamless / portal transition.
+ *
+ * Uses an imperative store subscription rather than a selector so a scene change
+ * doesn't re-render the (heavy) viewer subtree just to fire a callback, and
+ * reads the latest callback from a ref.
+ */
+export declare function useActiveSpaceNotify(onActiveSpaceChange?: (spaceId: string, space?: CaveSpace) => void): void;
+//# sourceMappingURL=use-active-space-notify.d.ts.map

package/dist/explore/hooks/use-active-space-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-space-notify.d.ts","sourceRoot":"","sources":["../../../explore/hooks/use-active-space-notify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,GACjE,IAAI,CAmBN"}

package/dist/explore/hooks/use-active-space-notify.js

@@ -0,0 +1,17 @@
+import { useRef as f, useEffect as s } from "react";
+import { useCaveExploreStore as u } from "../stores/explore-context.js";
+function i(r) {
+  const t = u(), c = f(r);
+  s(() => {
+    c.current = r;
+  }, [r]), s(() => {
+    const o = (e) => {
+      e && c.current?.(e, t.getState().connectedSpaces[e]);
+    };
+    return o(t.getState().activeSpaceId), t.subscribe((e) => e.activeSpaceId, o);
+  }, [t]);
+}
+export {
+  i as useActiveSpaceNotify
+};
+//# sourceMappingURL=use-active-space-notify.js.map

package/dist/explore/hooks/use-active-space-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-active-space-notify.js","sources":["../../../explore/hooks/use-active-space-notify.ts"],"sourcesContent":["import { useEffect, useRef } from 'react'\nimport type { CaveSpace } from '../../types'\nimport { useCaveExploreStore } from '../stores/explore-context'\n\n/**\n * Notify the host of the scene the player is currently in — once for the\n * initial scene and again after every seamless / portal transition.\n *\n * Uses an imperative store subscription rather than a selector so a scene change\n * doesn't re-render the (heavy) viewer subtree just to fire a callback, and\n * reads the latest callback from a ref.\n */\nexport function useActiveSpaceNotify(\n  onActiveSpaceChange?: (spaceId: string, space?: CaveSpace) => void\n): void {\n  const store = useCaveExploreStore()\n  const callbackRef = useRef(onActiveSpaceChange)\n\n  useEffect(() => {\n    callbackRef.current = onActiveSpaceChange\n  }, [onActiveSpaceChange])\n\n  useEffect(() => {\n    const notify = (id: string | undefined) => {\n      if (!id) return\n      // Pass the active scene's loaded config so hosts can read metadata\n      // (e.g. `metadata.name`) straight from the JSON — no external name maps.\n      callbackRef.current?.(id, store.getState().connectedSpaces[id])\n    }\n\n    notify(store.getState().activeSpaceId)\n    return store.subscribe((state) => state.activeSpaceId, notify)\n  }, [store])\n}\n"],"names":["useActiveSpaceNotify","onActiveSpaceChange","store","useCaveExploreStore","callbackRef","useRef","useEffect","notify","id","state"],"mappings":";;AAYO,SAASA,EACdC,GACM;AACN,QAAMC,IAAQC,EAAA,GACRC,IAAcC,EAAOJ,CAAmB;AAE9C,EAAAK,EAAU,MAAM;AACd,IAAAF,EAAY,UAAUH;AAAA,EACxB,GAAG,CAACA,CAAmB,CAAC,GAExBK,EAAU,MAAM;AACd,UAAMC,IAAS,CAACC,MAA2B;AACzC,MAAKA,KAGLJ,EAAY,UAAUI,GAAIN,EAAM,WAAW,gBAAgBM,CAAE,CAAC;AAAA,IAChE;AAEA,WAAAD,EAAOL,EAAM,SAAA,EAAW,aAAa,GAC9BA,EAAM,UAAU,CAACO,MAAUA,EAAM,eAAeF,CAAM;AAAA,EAC/D,GAAG,CAACL,CAAK,CAAC;AACZ;"}