@cavegiant/cave-world-r3f 1.0.0

package/dist/explore/hooks/use-primary-space-loader.d.ts

@@ -0,0 +1,24 @@
+import type { CaveSpace } from '../../types/index.js';
+import type { CaveSpaceLoader } from '../loaders/cave-loader.js';
+export interface PrimarySpaceLoaderOptions {
+    spaceId: string | undefined;
+    loader: CaveSpaceLoader;
+    /** Runs on success, before the config is published to the world store. */
+    onLoaded?: (spaceId: string, space: CaveSpace) => void;
+    /** Runs when the space id changes or a retry starts, before the fetch. */
+    onReset?: () => void;
+}
+export interface PrimarySpaceLoaderResult {
+    /** The loaded scene config, or `undefined` while loading / after a failure. */
+    space: CaveSpace | undefined;
+}
+/**
+ * Fetch the primary scene JSON and publish it to the world store.
+ *
+ * Re-runs when `spaceId` changes or the user triggers a retry
+ * (`retrySpaceLoad()` bumps `retryToken`). In-flight results are discarded on
+ * unmount / id change, so a slow response for a previous scene can never
+ * overwrite the current one.
+ */
+export declare function usePrimarySpaceLoader({ spaceId, loader, onLoaded, onReset }: PrimarySpaceLoaderOptions): PrimarySpaceLoaderResult;
+//# sourceMappingURL=use-primary-space-loader.d.ts.map

package/dist/explore/hooks/use-primary-space-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-primary-space-loader.d.ts","sourceRoot":"","sources":["../../../explore/hooks/use-primary-space-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;IACtD,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,MAAM,EACN,QAAQ,EACR,OAAO,EACR,EAAE,yBAAyB,GAAG,wBAAwB,CAgDtD"}

package/dist/explore/hooks/use-primary-space-loader.js

@@ -0,0 +1,29 @@
+import { useState as v, useRef as S, useEffect as g } from "react";
+import { useCaveWorldStoreApi as y, useCaveEventBus as C, useCaveWorldStore as k } from "../../core/context/cave-world-context.js";
+import { createLogger as E } from "../../core/logging/logger.js";
+const L = E("explore:load");
+function w({
+  spaceId: e,
+  loader: s,
+  onLoaded: n,
+  onReset: a
+}) {
+  const r = y(), i = C(), p = k((o) => o.retryToken), c = `${e ?? ""}\0${p}`, [u, d] = v(), m = u?.key === c ? u.space : void 0, f = S(n), l = S(a);
+  return g(() => {
+    f.current = n, l.current = a;
+  }, [n, a]), g(() => {
+    if (l.current?.(), !e) return;
+    let o = !1;
+    return r.getState().setSpaceLoadError(void 0), s(e).then((t) => {
+      o || (d({ key: c, space: t }), f.current?.(e, t), r.getState().setSpaceConfig(t));
+    }).catch((t) => {
+      o || (L.error(`Failed to load space ${e}:`, t), r.getState().setSpaceConfig(void 0), i.emit("space:error", { error: t, spaceId: e, willRetry: !1 }), r.getState().setSpaceLoadError({ stage: "config", spaceId: e, error: t }));
+    }), () => {
+      o = !0;
+    };
+  }, [e, s, c, r, i]), { space: m };
+}
+export {
+  w as usePrimarySpaceLoader
+};
+//# sourceMappingURL=use-primary-space-loader.js.map

package/dist/explore/hooks/use-primary-space-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-primary-space-loader.js","sources":["../../../explore/hooks/use-primary-space-loader.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { createLogger, useCaveEventBus, useCaveWorldStore, useCaveWorldStoreApi } from '../../core'\nimport type { CaveSpace } from '../../types'\nimport type { CaveSpaceLoader } from '../loaders/cave-loader'\n\nconst logger = createLogger('explore:load')\n\nexport interface PrimarySpaceLoaderOptions {\n  spaceId: string | undefined\n  loader: CaveSpaceLoader\n  /** Runs on success, before the config is published to the world store. */\n  onLoaded?: (spaceId: string, space: CaveSpace) => void\n  /** Runs when the space id changes or a retry starts, before the fetch. */\n  onReset?: () => void\n}\n\nexport interface PrimarySpaceLoaderResult {\n  /** The loaded scene config, or `undefined` while loading / after a failure. */\n  space: CaveSpace | undefined\n}\n\n/**\n * Fetch the primary scene JSON and publish it to the world store.\n *\n * Re-runs when `spaceId` changes or the user triggers a retry\n * (`retrySpaceLoad()` bumps `retryToken`). In-flight results are discarded on\n * unmount / id change, so a slow response for a previous scene can never\n * overwrite the current one.\n */\nexport function usePrimarySpaceLoader({\n  spaceId,\n  loader,\n  onLoaded,\n  onReset\n}: PrimarySpaceLoaderOptions): PrimarySpaceLoaderResult {\n  const worldStore = useCaveWorldStoreApi()\n  const eventBus = useCaveEventBus()\n  const retryToken = useCaveWorldStore((s) => s.retryToken)\n\n  // Tag the result with the request it belongs to. Reading it back through that\n  // tag means a new space id (or retry) reports \"not loaded\" immediately, with\n  // no reset effect and therefore no frame where the old scene is still shown.\n  const loadKey = `${spaceId ?? ''}\\u0000${retryToken}`\n  const [loaded, setLoaded] = useState<{ key: string; space: CaveSpace }>()\n  const space = loaded?.key === loadKey ? loaded.space : undefined\n\n  const onLoadedRef = useRef(onLoaded)\n  const onResetRef = useRef(onReset)\n  useEffect(() => {\n    onLoadedRef.current = onLoaded\n    onResetRef.current = onReset\n  }, [onLoaded, onReset])\n\n  useEffect(() => {\n    onResetRef.current?.()\n    if (!spaceId) return\n\n    let cancelled = false\n    worldStore.getState().setSpaceLoadError(undefined)\n\n    loader(spaceId)\n      .then((result) => {\n        if (cancelled) return\n        setLoaded({ key: loadKey, space: result })\n        onLoadedRef.current?.(spaceId, result)\n        worldStore.getState().setSpaceConfig(result)\n      })\n      .catch((error: unknown) => {\n        if (cancelled) return\n        logger.error(`Failed to load space ${spaceId}:`, error)\n        worldStore.getState().setSpaceConfig(undefined)\n        eventBus.emit('space:error', { error, spaceId, willRetry: false })\n        worldStore.getState().setSpaceLoadError({ stage: 'config', spaceId, error })\n      })\n\n    return () => {\n      cancelled = true\n    }\n    // `loadKey` folds in `retryToken`: a user-triggered retry re-runs the fetch.\n  }, [spaceId, loader, loadKey, worldStore, eventBus])\n\n  return { space }\n}\n"],"names":["logger","createLogger","usePrimarySpaceLoader","spaceId","loader","onLoaded","onReset","worldStore","useCaveWorldStoreApi","eventBus","useCaveEventBus","retryToken","useCaveWorldStore","s","loadKey","loaded","setLoaded","useState","space","onLoadedRef","useRef","onResetRef","useEffect","cancelled","result","error"],"mappings":";;;AAKA,MAAMA,IAASC,EAAa,cAAc;AAwBnC,SAASC,EAAsB;AAAA,EACpC,SAAAC;AAAA,EACA,QAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC;AACF,GAAwD;AACtD,QAAMC,IAAaC,EAAA,GACbC,IAAWC,EAAA,GACXC,IAAaC,EAAkB,CAACC,MAAMA,EAAE,UAAU,GAKlDC,IAAU,GAAGX,KAAW,EAAE,KAASQ,CAAU,IAC7C,CAACI,GAAQC,CAAS,IAAIC,EAAA,GACtBC,IAAQH,GAAQ,QAAQD,IAAUC,EAAO,QAAQ,QAEjDI,IAAcC,EAAOf,CAAQ,GAC7BgB,IAAaD,EAAOd,CAAO;AACjC,SAAAgB,EAAU,MAAM;AACd,IAAAH,EAAY,UAAUd,GACtBgB,EAAW,UAAUf;AAAA,EACvB,GAAG,CAACD,GAAUC,CAAO,CAAC,GAEtBgB,EAAU,MAAM;AAEd,QADAD,EAAW,UAAA,GACP,CAAClB,EAAS;AAEd,QAAIoB,IAAY;AAChB,WAAAhB,EAAW,SAAA,EAAW,kBAAkB,MAAS,GAEjDH,EAAOD,CAAO,EACX,KAAK,CAACqB,MAAW;AAChB,MAAID,MACJP,EAAU,EAAE,KAAKF,GAAS,OAAOU,GAAQ,GACzCL,EAAY,UAAUhB,GAASqB,CAAM,GACrCjB,EAAW,SAAA,EAAW,eAAeiB,CAAM;AAAA,IAC7C,CAAC,EACA,MAAM,CAACC,MAAmB;AACzB,MAAIF,MACJvB,EAAO,MAAM,wBAAwBG,CAAO,KAAKsB,CAAK,GACtDlB,EAAW,SAAA,EAAW,eAAe,MAAS,GAC9CE,EAAS,KAAK,eAAe,EAAE,OAAAgB,GAAO,SAAAtB,GAAS,WAAW,IAAO,GACjEI,EAAW,SAAA,EAAW,kBAAkB,EAAE,OAAO,UAAU,SAAAJ,GAAS,OAAAsB,GAAO;AAAA,IAC7E,CAAC,GAEI,MAAM;AACX,MAAAF,IAAY;AAAA,IACd;AAAA,EAEF,GAAG,CAACpB,GAASC,GAAQU,GAASP,GAAYE,CAAQ,CAAC,GAE5C,EAAE,OAAAS,EAAA;AACX;"}

package/dist/explore/index.d.ts

@@ -0,0 +1,37 @@
+export { default as CaveExplore, type CaveExploreProps, type CaveExploreHandle, type MultiplayerProp } from './cave-explore.js';
+export { default as CaveOrbitViewer, type CaveOrbitViewerProps, type OrbitCameraConfig, type OrbitControlsConfig, type OrbitViewerReadyApi } from './cave-orbit-viewer.js';
+export type { CaveViewerBaseProps, ActiveSpaceChangeHandler } from './viewer-shared.js';
+export { DefaultCaveSpaceLoader, createHttpCaveSpaceLoader, assertCaveSpace, DEFAULT_CAVE_SPACE_API_BASE_URL, DEFAULT_CAVE_SPACE_TIMEOUT_MS, type CaveSpaceLoader, type HttpCaveSpaceLoaderOptions } from './loaders/cave-loader.js';
+export { default as DetailWindow } from './overlays/detail-window.js';
+export { default as ActionPanel } from './overlays/action-panel.js';
+export { default as ActionBubble } from './overlays/action-bubble.js';
+export { default as SpaceLoadErrorOverlay, type LoadErrorRenderer, type LoadErrorRenderProps, type SpaceLoadErrorOverlayProps } from './overlays/space-load-error-overlay.js';
+export { default as ExploreHelper, DEFAULT_EXPLORE_HELPER_STORAGE_KEY, type ExploreHelperConfig, type ExploreHelperHint, type ExploreHelperProps, type ExploreHelperRenderer, type ExploreHelperRenderProps } from './overlays/explore-helper.js';
+export { default as ConnectorLabelBeacon } from './overlays/connector-label-beacon.js';
+export { default as ConnectorLabelTagShell } from './overlays/connector-label-tag-shell.js';
+export { ensureCaveWorldStyles, useCaveWorldStyles } from './styles/inject.js';
+export { CAVE_WORLD_CSS } from './styles/cave-world-css.js';
+export { CaveExploreProvider, useCaveExplore, useCaveExploreStore, useActionPrompt, useActionPromptStore, type CaveExploreProviderProps, type CaveExploreStores } from './stores/explore-context.js';
+export { createCaveExploreStore, isConnectorInActiveSpace, type CaveExploreState, type CaveExploreStoreApi, type RoomInfo, type ViewMode } from './stores/cave-explore.store.js';
+export { createActionPromptStore, type ActionDef, type ActionPromptState, type ActionPromptStoreApi, type ActionPromptStyle } from './stores/action-prompt.store.js';
+export { default as ExploreSimpleCharacter, type ExploreSimpleCharacterProps, type ExploreSimpleCharacterRoot, type MultiplayerRuntimeConfig } from './simple-character.js';
+export { applyCharacterPose } from './characters/character-pose.js';
+export { createLocalCharacterModelConfig, resolveLocalCharacterPhysics, resolveLocalCharacterScale, resolveSimpleCharacterModel, resolveUseViverseAvatar, DEFAULT_LOCAL_CHARACTER_SCALE, LOCAL_CHARACTER_SIZE_SCALE, VIVERSE_DEFAULT_CAPSULE_HEIGHT, VIVERSE_DEFAULT_CAPSULE_RADIUS, type LocalCharacterModelConfig, type LocalCharacterModelProp, type VRMHumanBoneName } from './characters/local-character-model.js';
+export { MIXAMO_STYLE_BONE_MAP } from './characters/mixamo-style-bone-map.js';
+export type { CharacterActionBindingClass, CharacterActionBindingOptions, CharacterControlsConfig, CharacterMovementOptions } from './characters/character-controls.js';
+export { default as RemoteCharacterController, type RemoteCharacterControllerProps, type RemoteCharacterData } from './characters/remote-character-controller.js';
+export { default as RemoteCharacter, type RemoteCharacterProps } from './characters/remote-character.js';
+export { BUILTIN_AVATARS, DEFAULT_AVATAR, DEFAULT_AVATAR_ID, SUPPORTED_ANIMATION_NAMES, getAvailableAvatarIds, getAvatarConfig, type AnimationName, type AvatarAssetRef, type AvatarConfig } from './characters/character-configs.js';
+export { DEFAULT_WEBSOCKET_URL, WebSocketService, WebSocketStatusEnum, MessageActionEnum, type PlayerData, type WebSocketStatus, type WebSocketMessage, type WebSocketConfig } from './services/websocket.service.js';
+export { useCharacterSync, type CharacterSyncConfig, type CharacterSyncResult } from './hooks/use-character-sync.js';
+export { useExploreActions, type PortalNavigateHandler } from './hooks/use-explore-actions.js';
+export { useActionShortcuts } from './hooks/use-action-shortcuts.js';
+export { useActiveSpaceNotify } from './hooks/use-active-space-notify.js';
+export { useConnectorPreloader, preloadSpaceAssets } from './hooks/use-connector-preloader.js';
+export { useConnectorTransitions, SEAMLESS_GHOST_ENTER_WINDOW_MS } from './hooks/use-connector-transitions.js';
+export { useLoadErrorNotify } from './hooks/use-load-error-notify.js';
+export { usePrimarySpaceLoader, type PrimarySpaceLoaderOptions, type PrimarySpaceLoaderResult } from './hooks/use-primary-space-loader.js';
+export { computePortalSpawnPose, computeSeamlessGroupMatrix, computeSpawnPose, findConnectorById, getConnectorTargetIds, matrixFromM16, transformToMatrix4, PORTAL_SPAWN_FORWARD_OFFSET_M, type SpawnPose } from './math/space-transforms.js';
+export { scheduleIdle } from './utils/schedule-idle.js';
+export { default as ConnectedSpacesRenderer, type ConnectedSpacesRendererProps } from './connected-spaces-renderer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/explore/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../explore/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAGpF,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,+BAA+B,EAC/B,6BAA6B,EAC7B,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAChC,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EACL,OAAO,IAAI,qBAAqB,EAChC,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAChC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,kCAAkC,EAClC,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACnF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAA;AAGxF,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAGxD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,uBAAuB,EACvB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EACL,OAAO,IAAI,sBAAsB,EACjC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EACL,+BAA+B,EAC/B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,6BAA6B,EAC7B,0BAA0B,EAC1B,8BAA8B,EAC9B,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EACL,OAAO,IAAI,yBAAyB,EACpC,KAAK,8BAA8B,EACnC,KAAK,mBAAmB,EACzB,MAAM,0CAA0C,CAAA;AACjD,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAC3F,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,6BAA6B,EAC7B,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGpD,OAAO,EACL,OAAO,IAAI,uBAAuB,EAClC,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAA"}

package/dist/explore/index.js

@@ -0,0 +1,107 @@
+import { default as o } from "./cave-explore.js";
+import { default as a } from "./cave-orbit-viewer.js";
+import { DEFAULT_CAVE_SPACE_API_BASE_URL as A, DEFAULT_CAVE_SPACE_TIMEOUT_MS as s, DefaultCaveSpaceLoader as l, assertCaveSpace as E, createHttpCaveSpaceLoader as c } from "./loaders/cave-loader.js";
+import { default as f } from "./overlays/detail-window.js";
+import { default as C } from "./overlays/action-panel.js";
+import { default as x } from "./overlays/action-bubble.js";
+import { default as u } from "./overlays/space-load-error-overlay.js";
+import { DEFAULT_EXPLORE_HELPER_STORAGE_KEY as d, default as i } from "./overlays/explore-helper.js";
+import { default as v } from "./overlays/connector-label-beacon.js";
+import { default as R } from "./overlays/connector-label-tag-shell.js";
+import { ensureCaveWorldStyles as O, useCaveWorldStyles as U } from "./styles/inject.js";
+import { CAVE_WORLD_CSS as M } from "./styles/cave-world-css.js";
+import { CaveExploreProvider as F, useActionPrompt as V, useActionPromptStore as W, useCaveExplore as y, useCaveExploreStore as N } from "./stores/explore-context.js";
+import { createCaveExploreStore as g, isConnectorInActiveSpace as H } from "./stores/cave-explore.store.js";
+import { createActionPromptStore as w } from "./stores/action-prompt.store.js";
+import { default as k } from "./simple-character.js";
+import { applyCharacterPose as X } from "./characters/character-pose.js";
+import { DEFAULT_LOCAL_CHARACTER_SCALE as Z, LOCAL_CHARACTER_SIZE_SCALE as j, VIVERSE_DEFAULT_CAPSULE_HEIGHT as q, VIVERSE_DEFAULT_CAPSULE_RADIUS as z, createLocalCharacterModelConfig as J, resolveLocalCharacterPhysics as Q, resolveLocalCharacterScale as $, resolveSimpleCharacterModel as ee, resolveUseViverseAvatar as re } from "./characters/local-character-model.js";
+import { MIXAMO_STYLE_BONE_MAP as te } from "./characters/mixamo-style-bone-map.js";
+import { default as pe } from "./characters/remote-character-controller.js";
+import { default as se } from "./characters/remote-character.js";
+import { BUILTIN_AVATARS as Ee, DEFAULT_AVATAR as ce, DEFAULT_AVATAR_ID as Se, SUPPORTED_ANIMATION_NAMES as fe, getAvailableAvatarIds as me, getAvatarConfig as Ce } from "./characters/character-configs.js";
+import { DEFAULT_WEBSOCKET_URL as xe, MessageActionEnum as ne, WebSocketService as ue, WebSocketStatusEnum as Le } from "./services/websocket.service.js";
+import { useCharacterSync as ie } from "./hooks/use-character-sync.js";
+import { useExploreActions as ve } from "./hooks/use-explore-actions.js";
+import { useActionShortcuts as Re } from "./hooks/use-action-shortcuts.js";
+import { useActiveSpaceNotify as Oe } from "./hooks/use-active-space-notify.js";
+import { preloadSpaceAssets as De, useConnectorPreloader as Me } from "./hooks/use-connector-preloader.js";
+import { SEAMLESS_GHOST_ENTER_WINDOW_MS as Fe, useConnectorTransitions as Ve } from "./hooks/use-connector-transitions.js";
+import { useLoadErrorNotify as ye } from "./hooks/use-load-error-notify.js";
+import { usePrimarySpaceLoader as be } from "./hooks/use-primary-space-loader.js";
+import { PORTAL_SPAWN_FORWARD_OFFSET_M as He, computePortalSpawnPose as Be, computeSeamlessGroupMatrix as we, computeSpawnPose as Ge, findConnectorById as ke, getConnectorTargetIds as Ke, matrixFromM16 as Xe, transformToMatrix4 as Ye } from "./math/space-transforms.js";
+import { scheduleIdle as je } from "./utils/schedule-idle.js";
+import { default as ze } from "./connected-spaces-renderer.js";
+export {
+  x as ActionBubble,
+  C as ActionPanel,
+  Ee as BUILTIN_AVATARS,
+  M as CAVE_WORLD_CSS,
+  o as CaveExplore,
+  F as CaveExploreProvider,
+  a as CaveOrbitViewer,
+  ze as ConnectedSpacesRenderer,
+  v as ConnectorLabelBeacon,
+  R as ConnectorLabelTagShell,
+  ce as DEFAULT_AVATAR,
+  Se as DEFAULT_AVATAR_ID,
+  A as DEFAULT_CAVE_SPACE_API_BASE_URL,
+  s as DEFAULT_CAVE_SPACE_TIMEOUT_MS,
+  d as DEFAULT_EXPLORE_HELPER_STORAGE_KEY,
+  Z as DEFAULT_LOCAL_CHARACTER_SCALE,
+  xe as DEFAULT_WEBSOCKET_URL,
+  l as DefaultCaveSpaceLoader,
+  f as DetailWindow,
+  i as ExploreHelper,
+  k as ExploreSimpleCharacter,
+  j as LOCAL_CHARACTER_SIZE_SCALE,
+  te as MIXAMO_STYLE_BONE_MAP,
+  ne as MessageActionEnum,
+  He as PORTAL_SPAWN_FORWARD_OFFSET_M,
+  se as RemoteCharacter,
+  pe as RemoteCharacterController,
+  Fe as SEAMLESS_GHOST_ENTER_WINDOW_MS,
+  fe as SUPPORTED_ANIMATION_NAMES,
+  u as SpaceLoadErrorOverlay,
+  q as VIVERSE_DEFAULT_CAPSULE_HEIGHT,
+  z as VIVERSE_DEFAULT_CAPSULE_RADIUS,
+  ue as WebSocketService,
+  Le as WebSocketStatusEnum,
+  X as applyCharacterPose,
+  E as assertCaveSpace,
+  Be as computePortalSpawnPose,
+  we as computeSeamlessGroupMatrix,
+  Ge as computeSpawnPose,
+  w as createActionPromptStore,
+  g as createCaveExploreStore,
+  c as createHttpCaveSpaceLoader,
+  J as createLocalCharacterModelConfig,
+  O as ensureCaveWorldStyles,
+  ke as findConnectorById,
+  me as getAvailableAvatarIds,
+  Ce as getAvatarConfig,
+  Ke as getConnectorTargetIds,
+  H as isConnectorInActiveSpace,
+  Xe as matrixFromM16,
+  De as preloadSpaceAssets,
+  Q as resolveLocalCharacterPhysics,
+  $ as resolveLocalCharacterScale,
+  ee as resolveSimpleCharacterModel,
+  re as resolveUseViverseAvatar,
+  je as scheduleIdle,
+  Ye as transformToMatrix4,
+  V as useActionPrompt,
+  W as useActionPromptStore,
+  Re as useActionShortcuts,
+  Oe as useActiveSpaceNotify,
+  y as useCaveExplore,
+  N as useCaveExploreStore,
+  U as useCaveWorldStyles,
+  ie as useCharacterSync,
+  Me as useConnectorPreloader,
+  Ve as useConnectorTransitions,
+  ve as useExploreActions,
+  ye as useLoadErrorNotify,
+  be as usePrimarySpaceLoader
+};
+//# sourceMappingURL=index.js.map

package/dist/explore/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/explore/loaders/cave-loader.d.ts

@@ -0,0 +1,58 @@
+import type { CaveSpace } from '../../types/index.js';
+/** Resolves a space id to its scene JSON. Supply your own to use a private API. */
+export type CaveSpaceLoader = (spaceId: string) => Promise<CaveSpace>;
+/** Default CaveGiant content endpoint used by {@link DefaultCaveSpaceLoader}. */
+export declare const DEFAULT_CAVE_SPACE_API_BASE_URL = "https://api-meta.cavegiant.com/v1/cave-meta";
+/** Default per-request timeout for the built-in HTTP loader. */
+export declare const DEFAULT_CAVE_SPACE_TIMEOUT_MS = 20000;
+export interface HttpCaveSpaceLoaderOptions {
+    /** API origin + prefix. Ignored when `buildUrl` is supplied. */
+    baseUrl?: string;
+    /** Full control over the request URL, e.g. for a non-CaveGiant backend. */
+    buildUrl?: (spaceId: string) => string;
+    /** Extra headers, e.g. `Authorization`. */
+    headers?: HeadersInit;
+    /** Abort and reject after this many ms. Pass `0` to disable. */
+    timeoutMs?: number;
+    /** Injectable `fetch` (proxying, retries, tests). Defaults to global `fetch`. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * Build a space loader that fetches scene JSON over HTTP.
+ *
+ * Adds what a bare `fetch` does not: a request timeout (a hung request would
+ * otherwise leave the viewer on its loading screen forever), non-2xx and
+ * malformed-payload detection, and {@link CaveWorldError} codes so hosts can
+ * branch on the failure kind.
+ *
+ * @example
+ * ```ts
+ * const loader = createHttpCaveSpaceLoader({
+ *   buildUrl: (id) => `/api/spaces/${id}`,
+ *   headers: { Authorization: `Bearer ${token}` }
+ * })
+ * <CaveExplore spaceId={id} caveSpaceLoader={loader} />
+ * ```
+ */
+export declare function createHttpCaveSpaceLoader(options?: HttpCaveSpaceLoaderOptions): CaveSpaceLoader;
+/**
+ * Narrow an unknown payload to {@link CaveSpace}, throwing a
+ * `CaveWorldError('INVALID_SPACE')` when required fields are missing.
+ *
+ * This is a shape check, not full schema validation: it catches the failures
+ * that would otherwise surface as an opaque `undefined` crash deep inside the
+ * renderer (HTML error pages, envelope-wrapped responses, empty bodies).
+ */
+export declare function assertCaveSpace(payload: unknown, context?: {
+    spaceId?: string;
+    url?: string;
+}): CaveSpace;
+/**
+ * Default loader against the public CaveGiant content API.
+ *
+ * Convenient for demos and CaveGiant-hosted apps. Third-party hosts should
+ * pass `createHttpCaveSpaceLoader({ buildUrl })` (or any async function) via
+ * `caveSpaceLoader` instead of relying on this endpoint.
+ */
+export declare const DefaultCaveSpaceLoader: CaveSpaceLoader;
+//# sourceMappingURL=cave-loader.d.ts.map

package/dist/explore/loaders/cave-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-loader.d.ts","sourceRoot":"","sources":["../../../explore/loaders/cave-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;AAErE,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,gDAAgD,CAAA;AAE5F,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAEnD,MAAM,WAAW,0BAA0B;IACzC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,0BAA+B,GACvC,eAAe,CA0DjB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,SAAS,CAUX;AAwBD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAA6C,CAAA"}

package/dist/explore/loaders/cave-loader.js

@@ -0,0 +1,79 @@
+import { CaveWorldError as s } from "../../core/errors.js";
+const E = "https://api-meta.cavegiant.com/v1/cave-meta", y = 2e4;
+function b(t = {}) {
+  const {
+    baseUrl: o = E,
+    buildUrl: e = (u) => `${o.replace(/\/$/, "")}/cave-worlds/${encodeURIComponent(u)}/space/content`,
+    headers: A,
+    timeoutMs: i = y,
+    fetch: p
+  } = t;
+  return async function(r) {
+    const n = e(r), C = p ?? globalThis.fetch, c = i > 0 ? new AbortController() : void 0, f = c && i > 0 ? setTimeout(() => c.abort(), i) : void 0;
+    let a;
+    try {
+      a = await C(n, { headers: A, signal: c?.signal });
+    } catch (l) {
+      throw c?.signal.aborted ? new s(
+        "SPACE_FETCH_TIMEOUT",
+        `Timed out after ${i}ms loading space ${r}.`,
+        { cause: l, spaceId: r, url: n }
+      ) : new s("SPACE_FETCH_FAILED", `Failed to load space ${r}.`, {
+        cause: l,
+        spaceId: r,
+        url: n
+      });
+    } finally {
+      f !== void 0 && clearTimeout(f);
+    }
+    if (!a.ok)
+      throw new s(
+        "SPACE_FETCH_FAILED",
+        `Failed to load space ${r}: HTTP ${a.status}.`,
+        { spaceId: r, url: n, status: a.status }
+      );
+    let m;
+    try {
+      m = await a.json();
+    } catch (l) {
+      throw new s("INVALID_SPACE", `Space ${r} did not return valid JSON.`, {
+        cause: l,
+        spaceId: r,
+        url: n
+      });
+    }
+    return d(m, { spaceId: r, url: n });
+  };
+}
+function d(t, o = {}) {
+  const e = v(t);
+  if (e)
+    throw new s(
+      "INVALID_SPACE",
+      `Invalid CaveSpace payload${o.spaceId ? ` for ${o.spaceId}` : ""}: ${e}.`,
+      o
+    );
+  return t;
+}
+function v(t) {
+  if (t == null || typeof t != "object")
+    return `expected an object, received ${t === null ? "null" : typeof t}`;
+  const o = t, e = o.baseLayer;
+  if (e == null || typeof e != "object")
+    return "missing `baseLayer`";
+  if (e.transform == null || !Array.isArray(e.transform.position))
+    return "missing `baseLayer.transform.position`";
+  if (e.scene == null || typeof e.scene.url != "string")
+    return "missing `baseLayer.scene.url`";
+  if (o.customLayers != null && !Array.isArray(o.customLayers))
+    return "`customLayers` must be an array when present";
+}
+const S = b();
+export {
+  E as DEFAULT_CAVE_SPACE_API_BASE_URL,
+  y as DEFAULT_CAVE_SPACE_TIMEOUT_MS,
+  S as DefaultCaveSpaceLoader,
+  d as assertCaveSpace,
+  b as createHttpCaveSpaceLoader
+};
+//# sourceMappingURL=cave-loader.js.map

package/dist/explore/loaders/cave-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-loader.js","sources":["../../../explore/loaders/cave-loader.ts"],"sourcesContent":["import { CaveWorldError } from '../../core'\nimport type { CaveSpace } from '../../types'\n\n/** Resolves a space id to its scene JSON. Supply your own to use a private API. */\nexport type CaveSpaceLoader = (spaceId: string) => Promise<CaveSpace>\n\n/** Default CaveGiant content endpoint used by {@link DefaultCaveSpaceLoader}. */\nexport const DEFAULT_CAVE_SPACE_API_BASE_URL = 'https://api-meta.cavegiant.com/v1/cave-meta'\n\n/** Default per-request timeout for the built-in HTTP loader. */\nexport const DEFAULT_CAVE_SPACE_TIMEOUT_MS = 20_000\n\nexport interface HttpCaveSpaceLoaderOptions {\n  /** API origin + prefix. Ignored when `buildUrl` is supplied. */\n  baseUrl?: string\n  /** Full control over the request URL, e.g. for a non-CaveGiant backend. */\n  buildUrl?: (spaceId: string) => string\n  /** Extra headers, e.g. `Authorization`. */\n  headers?: HeadersInit\n  /** Abort and reject after this many ms. Pass `0` to disable. */\n  timeoutMs?: number\n  /** Injectable `fetch` (proxying, retries, tests). Defaults to global `fetch`. */\n  fetch?: typeof globalThis.fetch\n}\n\n/**\n * Build a space loader that fetches scene JSON over HTTP.\n *\n * Adds what a bare `fetch` does not: a request timeout (a hung request would\n * otherwise leave the viewer on its loading screen forever), non-2xx and\n * malformed-payload detection, and {@link CaveWorldError} codes so hosts can\n * branch on the failure kind.\n *\n * @example\n * ```ts\n * const loader = createHttpCaveSpaceLoader({\n *   buildUrl: (id) => `/api/spaces/${id}`,\n *   headers: { Authorization: `Bearer ${token}` }\n * })\n * <CaveExplore spaceId={id} caveSpaceLoader={loader} />\n * ```\n */\nexport function createHttpCaveSpaceLoader(\n  options: HttpCaveSpaceLoaderOptions = {}\n): CaveSpaceLoader {\n  const {\n    baseUrl = DEFAULT_CAVE_SPACE_API_BASE_URL,\n    buildUrl = (spaceId: string) =>\n      `${baseUrl.replace(/\\/$/, '')}/cave-worlds/${encodeURIComponent(spaceId)}/space/content`,\n    headers,\n    timeoutMs = DEFAULT_CAVE_SPACE_TIMEOUT_MS,\n    fetch: fetchImpl\n  } = options\n\n  return async function loadCaveSpace(spaceId: string): Promise<CaveSpace> {\n    const url = buildUrl(spaceId)\n    const doFetch = fetchImpl ?? globalThis.fetch\n    const controller = timeoutMs > 0 ? new AbortController() : undefined\n    const timer =\n      controller && timeoutMs > 0 ? setTimeout(() => controller.abort(), timeoutMs) : undefined\n\n    let response: Response\n    try {\n      response = await doFetch(url, { headers, signal: controller?.signal })\n    } catch (error) {\n      if (controller?.signal.aborted) {\n        throw new CaveWorldError(\n          'SPACE_FETCH_TIMEOUT',\n          `Timed out after ${timeoutMs}ms loading space ${spaceId}.`,\n          { cause: error, spaceId, url }\n        )\n      }\n      throw new CaveWorldError('SPACE_FETCH_FAILED', `Failed to load space ${spaceId}.`, {\n        cause: error,\n        spaceId,\n        url\n      })\n    } finally {\n      if (timer !== undefined) clearTimeout(timer)\n    }\n\n    if (!response.ok) {\n      throw new CaveWorldError(\n        'SPACE_FETCH_FAILED',\n        `Failed to load space ${spaceId}: HTTP ${response.status}.`,\n        { spaceId, url, status: response.status }\n      )\n    }\n\n    let payload: unknown\n    try {\n      payload = await response.json()\n    } catch (error) {\n      throw new CaveWorldError('INVALID_SPACE', `Space ${spaceId} did not return valid JSON.`, {\n        cause: error,\n        spaceId,\n        url\n      })\n    }\n\n    return assertCaveSpace(payload, { spaceId, url })\n  }\n}\n\n/**\n * Narrow an unknown payload to {@link CaveSpace}, throwing a\n * `CaveWorldError('INVALID_SPACE')` when required fields are missing.\n *\n * This is a shape check, not full schema validation: it catches the failures\n * that would otherwise surface as an opaque `undefined` crash deep inside the\n * renderer (HTML error pages, envelope-wrapped responses, empty bodies).\n */\nexport function assertCaveSpace(\n  payload: unknown,\n  context: { spaceId?: string; url?: string } = {}\n): CaveSpace {\n  const problem = findSpaceProblem(payload)\n  if (problem) {\n    throw new CaveWorldError(\n      'INVALID_SPACE',\n      `Invalid CaveSpace payload${context.spaceId ? ` for ${context.spaceId}` : ''}: ${problem}.`,\n      context\n    )\n  }\n  return payload as CaveSpace\n}\n\nfunction findSpaceProblem(payload: unknown): string | undefined {\n  if (payload == null || typeof payload !== 'object') {\n    return `expected an object, received ${payload === null ? 'null' : typeof payload}`\n  }\n\n  const space = payload as Partial<CaveSpace>\n  const baseLayer = space.baseLayer\n  if (baseLayer == null || typeof baseLayer !== 'object') {\n    return 'missing `baseLayer`'\n  }\n  if (baseLayer.transform == null || !Array.isArray(baseLayer.transform.position)) {\n    return 'missing `baseLayer.transform.position`'\n  }\n  if (baseLayer.scene == null || typeof baseLayer.scene.url !== 'string') {\n    return 'missing `baseLayer.scene.url`'\n  }\n  if (space.customLayers != null && !Array.isArray(space.customLayers)) {\n    return '`customLayers` must be an array when present'\n  }\n  return undefined\n}\n\n/**\n * Default loader against the public CaveGiant content API.\n *\n * Convenient for demos and CaveGiant-hosted apps. Third-party hosts should\n * pass `createHttpCaveSpaceLoader({ buildUrl })` (or any async function) via\n * `caveSpaceLoader` instead of relying on this endpoint.\n */\nexport const DefaultCaveSpaceLoader: CaveSpaceLoader = createHttpCaveSpaceLoader()\n"],"names":["DEFAULT_CAVE_SPACE_API_BASE_URL","DEFAULT_CAVE_SPACE_TIMEOUT_MS","createHttpCaveSpaceLoader","options","baseUrl","buildUrl","spaceId","headers","timeoutMs","fetchImpl","url","doFetch","controller","timer","response","error","CaveWorldError","payload","assertCaveSpace","context","problem","findSpaceProblem","space","baseLayer","DefaultCaveSpaceLoader"],"mappings":";AAOO,MAAMA,IAAkC,+CAGlCC,IAAgC;AAgCtC,SAASC,EACdC,IAAsC,IACrB;AACjB,QAAM;AAAA,IACJ,SAAAC,IAAUJ;AAAA,IACV,UAAAK,IAAW,CAACC,MACV,GAAGF,EAAQ,QAAQ,OAAO,EAAE,CAAC,gBAAgB,mBAAmBE,CAAO,CAAC;AAAA,IAC1E,SAAAC;AAAA,IACA,WAAAC,IAAYP;AAAA,IACZ,OAAOQ;AAAA,EAAA,IACLN;AAEJ,SAAO,eAA6BG,GAAqC;AACvE,UAAMI,IAAML,EAASC,CAAO,GACtBK,IAAUF,KAAa,WAAW,OAClCG,IAAaJ,IAAY,IAAI,IAAI,oBAAoB,QACrDK,IACJD,KAAcJ,IAAY,IAAI,WAAW,MAAMI,EAAW,MAAA,GAASJ,CAAS,IAAI;AAElF,QAAIM;AACJ,QAAI;AACF,MAAAA,IAAW,MAAMH,EAAQD,GAAK,EAAE,SAAAH,GAAS,QAAQK,GAAY,QAAQ;AAAA,IACvE,SAASG,GAAO;AACd,YAAIH,GAAY,OAAO,UACf,IAAII;AAAA,QACR;AAAA,QACA,mBAAmBR,CAAS,oBAAoBF,CAAO;AAAA,QACvD,EAAE,OAAOS,GAAO,SAAAT,GAAS,KAAAI,EAAA;AAAA,MAAI,IAG3B,IAAIM,EAAe,sBAAsB,wBAAwBV,CAAO,KAAK;AAAA,QACjF,OAAOS;AAAA,QACP,SAAAT;AAAA,QACA,KAAAI;AAAA,MAAA,CACD;AAAA,IACH,UAAA;AACE,MAAIG,MAAU,UAAW,aAAaA,CAAK;AAAA,IAC7C;AAEA,QAAI,CAACC,EAAS;AACZ,YAAM,IAAIE;AAAA,QACR;AAAA,QACA,wBAAwBV,CAAO,UAAUQ,EAAS,MAAM;AAAA,QACxD,EAAE,SAAAR,GAAS,KAAAI,GAAK,QAAQI,EAAS,OAAA;AAAA,MAAO;AAI5C,QAAIG;AACJ,QAAI;AACF,MAAAA,IAAU,MAAMH,EAAS,KAAA;AAAA,IAC3B,SAASC,GAAO;AACd,YAAM,IAAIC,EAAe,iBAAiB,SAASV,CAAO,+BAA+B;AAAA,QACvF,OAAOS;AAAA,QACP,SAAAT;AAAA,QACA,KAAAI;AAAA,MAAA,CACD;AAAA,IACH;AAEA,WAAOQ,EAAgBD,GAAS,EAAE,SAAAX,GAAS,KAAAI,GAAK;AAAA,EAClD;AACF;AAUO,SAASQ,EACdD,GACAE,IAA8C,IACnC;AACX,QAAMC,IAAUC,EAAiBJ,CAAO;AACxC,MAAIG;AACF,UAAM,IAAIJ;AAAA,MACR;AAAA,MACA,4BAA4BG,EAAQ,UAAU,QAAQA,EAAQ,OAAO,KAAK,EAAE,KAAKC,CAAO;AAAA,MACxFD;AAAA,IAAA;AAGJ,SAAOF;AACT;AAEA,SAASI,EAAiBJ,GAAsC;AAC9D,MAAIA,KAAW,QAAQ,OAAOA,KAAY;AACxC,WAAO,gCAAgCA,MAAY,OAAO,SAAS,OAAOA,CAAO;AAGnF,QAAMK,IAAQL,GACRM,IAAYD,EAAM;AACxB,MAAIC,KAAa,QAAQ,OAAOA,KAAc;AAC5C,WAAO;AAET,MAAIA,EAAU,aAAa,QAAQ,CAAC,MAAM,QAAQA,EAAU,UAAU,QAAQ;AAC5E,WAAO;AAET,MAAIA,EAAU,SAAS,QAAQ,OAAOA,EAAU,MAAM,OAAQ;AAC5D,WAAO;AAET,MAAID,EAAM,gBAAgB,QAAQ,CAAC,MAAM,QAAQA,EAAM,YAAY;AACjE,WAAO;AAGX;AASO,MAAME,IAA0CtB,EAAA;"}

package/dist/explore/math/space-transforms.d.ts

@@ -0,0 +1,49 @@
+import { Matrix4, Quaternion, Vector3 } from 'three';
+import type { CaveSpace, ConnectorDef, Matrix16, SpawnPoint, Transform } from '../../types/index.js';
+/** How far past a portal connector's +Z face the arriving character lands. */
+export declare const PORTAL_SPAWN_FORWARD_OFFSET_M = 0.5;
+export interface SpawnPose {
+    position: Vector3;
+    quaternion: Quaternion;
+}
+/** Compose a `Matrix4` from a scene-JSON `Transform` (position + quaternion + scale). */
+export declare function transformToMatrix4(transform: Transform): Matrix4;
+/**
+ * World-space group matrix for a seamless-connected space.
+ *
+ * The raw alignment matrix `M_raw` from the scene JSON maps a point in the
+ * SOURCE model's local coordinates (before `baseLayer.transform` is applied) to
+ * the same physical point in the TARGET model's local coordinates:
+ *
+ *     p_target_local = M_raw × p_source_local
+ *
+ * Combined with the source/target base-layer transforms (`T_source`,
+ * `T_target`) and the source's own group matrix (`G_source`):
+ *
+ *     G_target = G_source × T_source × inverse(M_raw) × inverse(T_target)
+ */
+export declare function computeSeamlessGroupMatrix(sourceGroupMatrix: Matrix4, sourceBaseLayerTransform: Transform, rawAlignment: Matrix16, targetBaseLayerTransform: Transform): Matrix4;
+/**
+ * Spawn pose for a character arriving at a portal-target connector.
+ *
+ * The connector defines a box (position, Euler rotation, scale) in the target
+ * space's base-layer-local coordinates. The character lands on the centre of
+ * that box's +Z face plus {@link PORTAL_SPAWN_FORWARD_OFFSET_M} — i.e. one step
+ * *outside* the box, so the arrival does not immediately re-trigger the sensor —
+ * facing the same +Z direction.
+ *
+ * The result is world-space, accounting for both the target's group matrix
+ * (`G_target`) and its base-layer transform (`T_target`).
+ */
+export declare function computePortalSpawnPose(connector: ConnectorDef, targetBaseLayerTransform: Transform, targetGroupMatrix: Matrix4 | undefined): SpawnPose;
+/**
+ * Spawn pose for a character entering a scene via `baseLayer.spawnPoint`
+ * (base-layer-local position + yaw around Y), expressed in world space.
+ */
+export declare function computeSpawnPose(spawn: SpawnPoint, targetBaseLayerTransform: Transform, targetGroupMatrix: Matrix4 | undefined): SpawnPose;
+/** Every distinct `caveWorldId` referenced by a space's connectors. */
+export declare function getConnectorTargetIds(space: CaveSpace | undefined): string[];
+export declare function findConnectorById(space: CaveSpace | undefined, connectorId: string): ConnectorDef | undefined;
+/** Read a stored `Matrix16` back into a `Matrix4`, or `undefined` when unset. */
+export declare function matrixFromM16(m16: Matrix16 | undefined): Matrix4 | undefined;
+//# sourceMappingURL=space-transforms.d.ts.map

package/dist/explore/math/space-transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-transforms.d.ts","sourceRoot":"","sources":["../../../explore/math/space-transforms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE3F,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,MAAM,CAAA;AAIhD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAMhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,OAAO,EAC1B,wBAAwB,EAAE,SAAS,EACnC,YAAY,EAAE,QAAQ,EACtB,wBAAwB,EAAE,SAAS,GAClC,OAAO,CAUT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,YAAY,EACvB,wBAAwB,EAAE,SAAS,EACnC,iBAAiB,EAAE,OAAO,GAAG,SAAS,GACrC,SAAS,CAWX;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,wBAAwB,EAAE,SAAS,EACnC,iBAAiB,EAAE,OAAO,GAAG,SAAS,GACrC,SAAS,CAQX;AAsBD,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,EAAE,CAQ5E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,GAClB,YAAY,GAAG,SAAS,CAE1B;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAE5E"}

package/dist/explore/math/space-transforms.js

@@ -0,0 +1,54 @@
+import { Quaternion as u, Euler as f, Vector3 as r, Matrix4 as s } from "three";
+const d = 0.5, I = /* @__PURE__ */ new s();
+function p(n) {
+  return new s().compose(
+    new r(...n.position),
+    new u(...n.rotation),
+    new r(...n.scale)
+  );
+}
+function T(n, t, o, e) {
+  const i = p(t), c = new s().fromArray(o).invert(), a = p(e).invert();
+  return new s().copy(n).multiply(i).multiply(c).multiply(a);
+}
+function x(n, t, o) {
+  const [e, i, c] = n.transform.rotation, a = new u().setFromEuler(new f(e, i, c)), m = n.transform.scale[2] / 2 + d, y = new r(0, 0, m).applyQuaternion(a).add(new r(...n.transform.position));
+  return w(y, a, t, o);
+}
+function A(n, t, o) {
+  const e = new u().setFromEuler(new f(0, n.yaw, 0));
+  return w(
+    new r(...n.position),
+    e,
+    t,
+    o
+  );
+}
+function w(n, t, o, e) {
+  const i = p(o), c = new s().multiplyMatrices(e ?? I, i), a = n.clone().applyMatrix4(c), l = new u();
+  return c.decompose(new r(), l, new r()), { position: a, quaternion: l.multiply(t) };
+}
+function P(n) {
+  const t = /* @__PURE__ */ new Set();
+  for (const o of n?.baseLayer?.connectors ?? [])
+    for (const e of o.connectorInfo.to)
+      t.add(e.caveWorldId);
+  return Array.from(t);
+}
+function S(n, t) {
+  return n?.baseLayer?.connectors?.find((o) => o.id === t);
+}
+function v(n) {
+  return n ? new s().fromArray(n) : void 0;
+}
+export {
+  d as PORTAL_SPAWN_FORWARD_OFFSET_M,
+  x as computePortalSpawnPose,
+  T as computeSeamlessGroupMatrix,
+  A as computeSpawnPose,
+  S as findConnectorById,
+  P as getConnectorTargetIds,
+  v as matrixFromM16,
+  p as transformToMatrix4
+};
+//# sourceMappingURL=space-transforms.js.map

package/dist/explore/math/space-transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-transforms.js","sources":["../../../explore/math/space-transforms.ts"],"sourcesContent":["import { Euler, Matrix4, Quaternion, Vector3 } from 'three'\nimport type { CaveSpace, ConnectorDef, Matrix16, SpawnPoint, Transform } from '../../types'\n\n/** How far past a portal connector's +Z face the arriving character lands. */\nexport const PORTAL_SPAWN_FORWARD_OFFSET_M = 0.5\n\nconst IDENTITY_MATRIX4 = /* @__PURE__ */ new Matrix4()\n\nexport interface SpawnPose {\n  position: Vector3\n  quaternion: Quaternion\n}\n\n/** Compose a `Matrix4` from a scene-JSON `Transform` (position + quaternion + scale). */\nexport function transformToMatrix4(transform: Transform): Matrix4 {\n  return new Matrix4().compose(\n    new Vector3(...transform.position),\n    new Quaternion(...transform.rotation),\n    new Vector3(...transform.scale)\n  )\n}\n\n/**\n * World-space group matrix for a seamless-connected space.\n *\n * The raw alignment matrix `M_raw` from the scene JSON maps a point in the\n * SOURCE model's local coordinates (before `baseLayer.transform` is applied) to\n * the same physical point in the TARGET model's local coordinates:\n *\n *     p_target_local = M_raw × p_source_local\n *\n * Combined with the source/target base-layer transforms (`T_source`,\n * `T_target`) and the source's own group matrix (`G_source`):\n *\n *     G_target = G_source × T_source × inverse(M_raw) × inverse(T_target)\n */\nexport function computeSeamlessGroupMatrix(\n  sourceGroupMatrix: Matrix4,\n  sourceBaseLayerTransform: Transform,\n  rawAlignment: Matrix16,\n  targetBaseLayerTransform: Transform\n): Matrix4 {\n  const tSource = transformToMatrix4(sourceBaseLayerTransform)\n  const mRawInv = new Matrix4().fromArray(rawAlignment).invert()\n  const tTargetInv = transformToMatrix4(targetBaseLayerTransform).invert()\n\n  return new Matrix4()\n    .copy(sourceGroupMatrix)\n    .multiply(tSource)\n    .multiply(mRawInv)\n    .multiply(tTargetInv)\n}\n\n/**\n * Spawn pose for a character arriving at a portal-target connector.\n *\n * The connector defines a box (position, Euler rotation, scale) in the target\n * space's base-layer-local coordinates. The character lands on the centre of\n * that box's +Z face plus {@link PORTAL_SPAWN_FORWARD_OFFSET_M} — i.e. one step\n * *outside* the box, so the arrival does not immediately re-trigger the sensor —\n * facing the same +Z direction.\n *\n * The result is world-space, accounting for both the target's group matrix\n * (`G_target`) and its base-layer transform (`T_target`).\n */\nexport function computePortalSpawnPose(\n  connector: ConnectorDef,\n  targetBaseLayerTransform: Transform,\n  targetGroupMatrix: Matrix4 | undefined\n): SpawnPose {\n  const [rx, ry, rz] = connector.transform.rotation\n  const connectorQuat = new Quaternion().setFromEuler(new Euler(rx, ry, rz))\n\n  const halfDepth = connector.transform.scale[2] / 2\n  const offsetDistance = halfDepth + PORTAL_SPAWN_FORWARD_OFFSET_M\n  const baseLayerLocalPos = new Vector3(0, 0, offsetDistance)\n    .applyQuaternion(connectorQuat)\n    .add(new Vector3(...connector.transform.position))\n\n  return toWorldPose(baseLayerLocalPos, connectorQuat, targetBaseLayerTransform, targetGroupMatrix)\n}\n\n/**\n * Spawn pose for a character entering a scene via `baseLayer.spawnPoint`\n * (base-layer-local position + yaw around Y), expressed in world space.\n */\nexport function computeSpawnPose(\n  spawn: SpawnPoint,\n  targetBaseLayerTransform: Transform,\n  targetGroupMatrix: Matrix4 | undefined\n): SpawnPose {\n  const localQuat = new Quaternion().setFromEuler(new Euler(0, spawn.yaw, 0))\n  return toWorldPose(\n    new Vector3(...spawn.position),\n    localQuat,\n    targetBaseLayerTransform,\n    targetGroupMatrix\n  )\n}\n\n/** Lift a base-layer-local pose into world space through `G_target × T_target`. */\nfunction toWorldPose(\n  localPosition: Vector3,\n  localQuaternion: Quaternion,\n  targetBaseLayerTransform: Transform,\n  targetGroupMatrix: Matrix4 | undefined\n): SpawnPose {\n  const tTarget = transformToMatrix4(targetBaseLayerTransform)\n  const worldMat = new Matrix4().multiplyMatrices(targetGroupMatrix ?? IDENTITY_MATRIX4, tTarget)\n\n  const position = localPosition.clone().applyMatrix4(worldMat)\n\n  // Decompose rather than reading the rotation directly so any scale baked into\n  // G_target / T_target does not leak into the orientation.\n  const parentQuat = new Quaternion()\n  worldMat.decompose(new Vector3(), parentQuat, new Vector3())\n\n  return { position, quaternion: parentQuat.multiply(localQuaternion) }\n}\n\n/** Every distinct `caveWorldId` referenced by a space's connectors. */\nexport function getConnectorTargetIds(space: CaveSpace | undefined): string[] {\n  const ids = new Set<string>()\n  for (const connector of space?.baseLayer?.connectors ?? []) {\n    for (const target of connector.connectorInfo.to) {\n      ids.add(target.caveWorldId)\n    }\n  }\n  return Array.from(ids)\n}\n\nexport function findConnectorById(\n  space: CaveSpace | undefined,\n  connectorId: string\n): ConnectorDef | undefined {\n  return space?.baseLayer?.connectors?.find((connector) => connector.id === connectorId)\n}\n\n/** Read a stored `Matrix16` back into a `Matrix4`, or `undefined` when unset. */\nexport function matrixFromM16(m16: Matrix16 | undefined): Matrix4 | undefined {\n  return m16 ? new Matrix4().fromArray(m16) : undefined\n}\n"],"names":["PORTAL_SPAWN_FORWARD_OFFSET_M","IDENTITY_MATRIX4","Matrix4","transformToMatrix4","transform","Vector3","Quaternion","computeSeamlessGroupMatrix","sourceGroupMatrix","sourceBaseLayerTransform","rawAlignment","targetBaseLayerTransform","tSource","mRawInv","tTargetInv","computePortalSpawnPose","connector","targetGroupMatrix","rx","ry","rz","connectorQuat","Euler","offsetDistance","baseLayerLocalPos","toWorldPose","computeSpawnPose","spawn","localQuat","localPosition","localQuaternion","tTarget","worldMat","position","parentQuat","getConnectorTargetIds","space","ids","target","findConnectorById","connectorId","matrixFromM16","m16"],"mappings":";AAIO,MAAMA,IAAgC,KAEvCC,wBAAuCC,EAAA;AAQtC,SAASC,EAAmBC,GAA+B;AAChE,SAAO,IAAIF,IAAU;AAAA,IACnB,IAAIG,EAAQ,GAAGD,EAAU,QAAQ;AAAA,IACjC,IAAIE,EAAW,GAAGF,EAAU,QAAQ;AAAA,IACpC,IAAIC,EAAQ,GAAGD,EAAU,KAAK;AAAA,EAAA;AAElC;AAgBO,SAASG,EACdC,GACAC,GACAC,GACAC,GACS;AACT,QAAMC,IAAUT,EAAmBM,CAAwB,GACrDI,IAAU,IAAIX,EAAA,EAAU,UAAUQ,CAAY,EAAE,OAAA,GAChDI,IAAaX,EAAmBQ,CAAwB,EAAE,OAAA;AAEhE,SAAO,IAAIT,EAAA,EACR,KAAKM,CAAiB,EACtB,SAASI,CAAO,EAChB,SAASC,CAAO,EAChB,SAASC,CAAU;AACxB;AAcO,SAASC,EACdC,GACAL,GACAM,GACW;AACX,QAAM,CAACC,GAAIC,GAAIC,CAAE,IAAIJ,EAAU,UAAU,UACnCK,IAAgB,IAAIf,EAAA,EAAa,aAAa,IAAIgB,EAAMJ,GAAIC,GAAIC,CAAE,CAAC,GAGnEG,IADYP,EAAU,UAAU,MAAM,CAAC,IAAI,IACdhB,GAC7BwB,IAAoB,IAAInB,EAAQ,GAAG,GAAGkB,CAAc,EACvD,gBAAgBF,CAAa,EAC7B,IAAI,IAAIhB,EAAQ,GAAGW,EAAU,UAAU,QAAQ,CAAC;AAEnD,SAAOS,EAAYD,GAAmBH,GAAeV,GAA0BM,CAAiB;AAClG;AAMO,SAASS,EACdC,GACAhB,GACAM,GACW;AACX,QAAMW,IAAY,IAAItB,EAAA,EAAa,aAAa,IAAIgB,EAAM,GAAGK,EAAM,KAAK,CAAC,CAAC;AAC1E,SAAOF;AAAA,IACL,IAAIpB,EAAQ,GAAGsB,EAAM,QAAQ;AAAA,IAC7BC;AAAA,IACAjB;AAAA,IACAM;AAAA,EAAA;AAEJ;AAGA,SAASQ,EACPI,GACAC,GACAnB,GACAM,GACW;AACX,QAAMc,IAAU5B,EAAmBQ,CAAwB,GACrDqB,IAAW,IAAI9B,EAAA,EAAU,iBAAiBe,KAAqBhB,GAAkB8B,CAAO,GAExFE,IAAWJ,EAAc,MAAA,EAAQ,aAAaG,CAAQ,GAItDE,IAAa,IAAI5B,EAAA;AACvB,SAAA0B,EAAS,UAAU,IAAI3B,EAAA,GAAW6B,GAAY,IAAI7B,GAAS,GAEpD,EAAE,UAAA4B,GAAU,YAAYC,EAAW,SAASJ,CAAe,EAAA;AACpE;AAGO,SAASK,EAAsBC,GAAwC;AAC5E,QAAMC,wBAAU,IAAA;AAChB,aAAWrB,KAAaoB,GAAO,WAAW,cAAc,CAAA;AACtD,eAAWE,KAAUtB,EAAU,cAAc;AAC3C,MAAAqB,EAAI,IAAIC,EAAO,WAAW;AAG9B,SAAO,MAAM,KAAKD,CAAG;AACvB;AAEO,SAASE,EACdH,GACAI,GAC0B;AAC1B,SAAOJ,GAAO,WAAW,YAAY,KAAK,CAACpB,MAAcA,EAAU,OAAOwB,CAAW;AACvF;AAGO,SAASC,EAAcC,GAAgD;AAC5E,SAAOA,IAAM,IAAIxC,EAAA,EAAU,UAAUwC,CAAG,IAAI;AAC9C;"}

package/dist/explore/overlays/action-bubble.d.ts

@@ -0,0 +1,8 @@
+/**
+ * In-scene hint anchored at a world position, e.g. "F  View details".
+ *
+ * Renders inside the R3F canvas (drei `Html`), so it must be mounted in the 3D
+ * tree — unlike the screen-space `ActionPanel`.
+ */
+export default function ActionBubble(): import("react").JSX.Element | null;
+//# sourceMappingURL=action-bubble.d.ts.map

package/dist/explore/overlays/action-bubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bubble.d.ts","sourceRoot":"","sources":["../../../explore/overlays/action-bubble.tsx"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,uCAqBnC"}

package/dist/explore/overlays/action-bubble.js

@@ -0,0 +1,18 @@
+import { jsx as l, jsxs as c } from "react/jsx-runtime";
+import { Html as o } from "@react-three/drei";
+import { useActionPrompt as t } from "../stores/explore-context.js";
+function u() {
+  const r = t((e) => e.actions), s = t((e) => e.anchor);
+  return t((e) => e.style) !== "bubble" || !s || r.length === 0 ? null : (
+    // Only `cw-overlay-root` here: drei positions this wrapper with inline
+    // styles, so any class that sets a size on it would break the anchoring.
+    /* @__PURE__ */ l(o, { position: s, center: !0, className: "cw-overlay-root", children: /* @__PURE__ */ l("div", { className: "cw-bubble-layer", children: r.map((e) => /* @__PURE__ */ c("div", { className: "cw-bubble", children: [
+      e.shortcut ? /* @__PURE__ */ l("span", { className: "cw-bubble__key", children: e.shortcut }) : null,
+      e.label
+    ] }, e.id)) }) })
+  );
+}
+export {
+  u as default
+};
+//# sourceMappingURL=action-bubble.js.map

package/dist/explore/overlays/action-bubble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-bubble.js","sources":["../../../explore/overlays/action-bubble.tsx"],"sourcesContent":["import { Html } from '@react-three/drei'\nimport { useActionPrompt } from '../stores/explore-context'\n\n/**\n * In-scene hint anchored at a world position, e.g. \"F  View details\".\n *\n * Renders inside the R3F canvas (drei `Html`), so it must be mounted in the 3D\n * tree — unlike the screen-space `ActionPanel`.\n */\nexport default function ActionBubble() {\n  const actions = useActionPrompt((s) => s.actions)\n  const anchor = useActionPrompt((s) => s.anchor)\n  const style = useActionPrompt((s) => s.style)\n\n  if (style !== 'bubble' || !anchor || actions.length === 0) return null\n\n  return (\n    // Only `cw-overlay-root` here: drei positions this wrapper with inline\n    // styles, so any class that sets a size on it would break the anchoring.\n    <Html position={anchor} center className=\"cw-overlay-root\">\n      <div className=\"cw-bubble-layer\">\n        {actions.map((action) => (\n          <div key={action.id} className=\"cw-bubble\">\n            {action.shortcut ? <span className=\"cw-bubble__key\">{action.shortcut}</span> : null}\n            {action.label}\n          </div>\n        ))}\n      </div>\n    </Html>\n  )\n}\n"],"names":["ActionBubble","actions","useActionPrompt","s","anchor","Html","jsx","action","jsxs"],"mappings":";;;AASA,SAAwBA,IAAe;AACrC,QAAMC,IAAUC,EAAgB,CAACC,MAAMA,EAAE,OAAO,GAC1CC,IAASF,EAAgB,CAACC,MAAMA,EAAE,MAAM;AAG9C,SAFcD,EAAgB,CAACC,MAAMA,EAAE,KAAK,MAE9B,YAAY,CAACC,KAAUH,EAAQ,WAAW,IAAU;AAAA;AAAA;AAAA,sBAK/DI,GAAA,EAAK,UAAUD,GAAQ,QAAM,IAAC,WAAU,mBACvC,UAAA,gBAAAE,EAAC,SAAI,WAAU,mBACZ,YAAQ,IAAI,CAACC,MACZ,gBAAAC,EAAC,OAAA,EAAoB,WAAU,aAC5B,UAAA;AAAA,MAAAD,EAAO,WAAW,gBAAAD,EAAC,QAAA,EAAK,WAAU,kBAAkB,UAAAC,EAAO,UAAS,IAAU;AAAA,MAC9EA,EAAO;AAAA,IAAA,EAAA,GAFAA,EAAO,EAGjB,CACD,EAAA,CACH,EAAA,CACF;AAAA;AAEJ;"}

package/dist/explore/overlays/action-panel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Screen-space list of the currently available actions — used for multi-choice
+ * interactions such as picking a portal destination.
+ *
+ * Intentionally low-intrusion: a compact chamfered card with no full-screen
+ * scrim, so the scene stays visible when the player just brushes past a
+ * connector. The decorative nodes (rim, grain, hairline, corner marks) are
+ * `aria-hidden` siblings rather than pseudo-elements because several of them
+ * need their own stacking and blend context.
+ */
+export default function ActionPanel(): import("react").JSX.Element | null;
+//# sourceMappingURL=action-panel.d.ts.map

package/dist/explore/overlays/action-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-panel.d.ts","sourceRoot":"","sources":["../../../explore/overlays/action-panel.tsx"],"names":[],"mappings":"AAwBA;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,uCA0FlC"}