@cavegiant/cave-world-r3f 1.0.0

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

@@ -0,0 +1,69 @@
+import { jsx as e, jsxs as r } from "react/jsx-runtime";
+import { useCaveWorldMessages as d } from "../../core/context/cave-world-context.js";
+import { useTouchPrimaryDevice as m } from "../../space/utils/touch-primary-device.js";
+import { useActionPrompt as t } from "../stores/explore-context.js";
+import { ArrowRightIcon as _, ChevronRightIcon as p } from "./icons.js";
+function h(l, c, i) {
+  const { actionPanel: n } = i;
+  return l.every((a) => a.disabled) ? n.footerAllLoading : l.some((a) => a.shortcut) ? c ? l.length === 1 ? n.footerTapToConfirm : n.footerTapToSelect : l.length === 1 ? n.footerKeyToConfirm : n.footerKeysOrTap : n.footerTapToSelect;
+}
+function y() {
+  const l = t((a) => a.actions), c = t((a) => a.style), i = m(), n = d();
+  return c !== "panel" || l.length === 0 ? null : /* @__PURE__ */ e("div", { className: "cw-overlay-root cw-panel-layer", children: /* @__PURE__ */ r("div", { className: "cw-panel", role: "dialog", "aria-label": n.actionPanel.title, children: [
+    /* @__PURE__ */ e("div", { className: "cw-panel__rim", "aria-hidden": !0 }),
+    /* @__PURE__ */ e("div", { className: "cw-panel__frame", children: /* @__PURE__ */ r("div", { className: "cw-panel__body", children: [
+      /* @__PURE__ */ e("div", { className: "cw-panel__grain", "aria-hidden": !0 }),
+      /* @__PURE__ */ e("div", { className: "cw-panel__hairline", "aria-hidden": !0 }),
+      /* @__PURE__ */ e("span", { className: "cw-panel__mark cw-panel__mark--tl", "aria-hidden": !0 }),
+      /* @__PURE__ */ e("span", { className: "cw-panel__mark cw-panel__mark--tr", "aria-hidden": !0 }),
+      /* @__PURE__ */ e("span", { className: "cw-panel__mark cw-panel__mark--bl", "aria-hidden": !0 }),
+      /* @__PURE__ */ e("span", { className: "cw-panel__mark cw-panel__mark--br", "aria-hidden": !0 }),
+      /* @__PURE__ */ r("header", { className: "cw-panel__header", children: [
+        /* @__PURE__ */ r("div", { className: "cw-panel__eyebrow-row", children: [
+          /* @__PURE__ */ e("span", { className: "cw-panel__dot", "aria-hidden": !0 }),
+          /* @__PURE__ */ e("p", { className: "cw-panel__eyebrow", children: n.actionPanel.eyebrow })
+        ] }),
+        /* @__PURE__ */ e("h3", { className: "cw-panel__title", children: n.actionPanel.title }),
+        /* @__PURE__ */ e("div", { className: "cw-panel__divider", "aria-hidden": !0 })
+      ] }),
+      /* @__PURE__ */ e("ul", { className: "cw-panel__list", children: l.map((a, o) => {
+        const s = a.disabled === !0;
+        return /* @__PURE__ */ e(
+          "li",
+          {
+            className: "cw-panel__row",
+            style: { animationDelay: `${40 + o * 40}ms` },
+            children: /* @__PURE__ */ r(
+              "button",
+              {
+                type: "button",
+                className: "cw-panel__item",
+                disabled: s,
+                onClick: s ? void 0 : a.onAction,
+                children: [
+                  /* @__PURE__ */ e("span", { className: "cw-panel__item-bar", "aria-hidden": !0 }),
+                  a.shortcut && !i ? /* @__PURE__ */ e("span", { className: "cw-key", "aria-hidden": !0, children: a.shortcut }) : /* @__PURE__ */ e("span", { className: "cw-panel__item-icon", "aria-hidden": !0, children: /* @__PURE__ */ e(_, { size: 12 }) }),
+                  /* @__PURE__ */ r("span", { className: "cw-panel__item-text", children: [
+                    /* @__PURE__ */ e("span", { className: "cw-panel__item-label", children: a.label }),
+                    /* @__PURE__ */ e("span", { className: "cw-panel__item-hint", children: s ? n.actionPanel.itemLoading : n.actionPanel.itemEnter })
+                  ] }),
+                  /* @__PURE__ */ e("span", { className: "cw-panel__item-chevron", "aria-hidden": !0, children: /* @__PURE__ */ e(p, { size: 14 }) })
+                ]
+              }
+            )
+          },
+          a.id
+        );
+      }) }),
+      /* @__PURE__ */ r("div", { className: "cw-panel__footer", children: [
+        /* @__PURE__ */ e("span", { className: "cw-panel__footer-rule", "aria-hidden": !0 }),
+        /* @__PURE__ */ e("p", { className: "cw-panel__footer-text", children: h(l, i, n) }),
+        /* @__PURE__ */ e("span", { className: "cw-panel__footer-rule cw-panel__footer-rule--end", "aria-hidden": !0 })
+      ] })
+    ] }) })
+  ] }) });
+}
+export {
+  y as default
+};
+//# sourceMappingURL=action-panel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-panel.js","sources":["../../../explore/overlays/action-panel.tsx"],"sourcesContent":["import { useCaveWorldMessages, type CaveWorldMessages } from '../../core'\nimport { useTouchPrimaryDevice } from '../../space'\nimport type { ActionDef } from '../stores/action-prompt.store'\nimport { useActionPrompt } from '../stores/explore-context'\nimport { ArrowRightIcon, ChevronRightIcon } from './icons'\n\n/**\n * Footer copy depends on how the player can actually pick a destination: touch\n * devices have no keyboard shortcuts, and a single option needs no list.\n */\nfunction resolveFooterHint(\n  actions: ActionDef[],\n  isTouchDevice: boolean,\n  messages: CaveWorldMessages\n): string {\n  const { actionPanel } = messages\n  if (actions.every((action) => action.disabled)) return actionPanel.footerAllLoading\n  if (!actions.some((action) => action.shortcut)) return actionPanel.footerTapToSelect\n  if (isTouchDevice) {\n    return actions.length === 1 ? actionPanel.footerTapToConfirm : actionPanel.footerTapToSelect\n  }\n  return actions.length === 1 ? actionPanel.footerKeyToConfirm : actionPanel.footerKeysOrTap\n}\n\n/**\n * Screen-space list of the currently available actions — used for multi-choice\n * interactions such as picking a portal destination.\n *\n * Intentionally low-intrusion: a compact chamfered card with no full-screen\n * scrim, so the scene stays visible when the player just brushes past a\n * connector. The decorative nodes (rim, grain, hairline, corner marks) are\n * `aria-hidden` siblings rather than pseudo-elements because several of them\n * need their own stacking and blend context.\n */\nexport default function ActionPanel() {\n  const actions = useActionPrompt((s) => s.actions)\n  const style = useActionPrompt((s) => s.style)\n  const isTouchDevice = useTouchPrimaryDevice()\n  const messages = useCaveWorldMessages()\n\n  if (style !== 'panel' || actions.length === 0) return null\n\n  return (\n    <div className=\"cw-overlay-root cw-panel-layer\">\n      <div className=\"cw-panel\" role=\"dialog\" aria-label={messages.actionPanel.title}>\n        <div className=\"cw-panel__rim\" aria-hidden />\n\n        <div className=\"cw-panel__frame\">\n          <div className=\"cw-panel__body\">\n            <div className=\"cw-panel__grain\" aria-hidden />\n            <div className=\"cw-panel__hairline\" aria-hidden />\n            <span className=\"cw-panel__mark cw-panel__mark--tl\" aria-hidden />\n            <span className=\"cw-panel__mark cw-panel__mark--tr\" aria-hidden />\n            <span className=\"cw-panel__mark cw-panel__mark--bl\" aria-hidden />\n            <span className=\"cw-panel__mark cw-panel__mark--br\" aria-hidden />\n\n            <header className=\"cw-panel__header\">\n              <div className=\"cw-panel__eyebrow-row\">\n                <span className=\"cw-panel__dot\" aria-hidden />\n                <p className=\"cw-panel__eyebrow\">{messages.actionPanel.eyebrow}</p>\n              </div>\n              <h3 className=\"cw-panel__title\">{messages.actionPanel.title}</h3>\n              <div className=\"cw-panel__divider\" aria-hidden />\n            </header>\n\n            <ul className=\"cw-panel__list\">\n              {actions.map((action, index) => {\n                const disabled = action.disabled === true\n                return (\n                  <li\n                    key={action.id}\n                    className=\"cw-panel__row\"\n                    // Staggered entrance, so a multi-destination list reads as a\n                    // sequence instead of appearing all at once.\n                    style={{ animationDelay: `${40 + index * 40}ms` }}\n                  >\n                    <button\n                      type=\"button\"\n                      className=\"cw-panel__item\"\n                      disabled={disabled}\n                      onClick={disabled ? undefined : action.onAction}\n                    >\n                      <span className=\"cw-panel__item-bar\" aria-hidden />\n\n                      {action.shortcut && !isTouchDevice ? (\n                        <span className=\"cw-key\" aria-hidden>\n                          {action.shortcut}\n                        </span>\n                      ) : (\n                        <span className=\"cw-panel__item-icon\" aria-hidden>\n                          <ArrowRightIcon size={12} />\n                        </span>\n                      )}\n\n                      <span className=\"cw-panel__item-text\">\n                        <span className=\"cw-panel__item-label\">{action.label}</span>\n                        <span className=\"cw-panel__item-hint\">\n                          {disabled\n                            ? messages.actionPanel.itemLoading\n                            : messages.actionPanel.itemEnter}\n                        </span>\n                      </span>\n\n                      <span className=\"cw-panel__item-chevron\" aria-hidden>\n                        <ChevronRightIcon size={14} />\n                      </span>\n                    </button>\n                  </li>\n                )\n              })}\n            </ul>\n\n            <div className=\"cw-panel__footer\">\n              <span className=\"cw-panel__footer-rule\" aria-hidden />\n              <p className=\"cw-panel__footer-text\">\n                {resolveFooterHint(actions, isTouchDevice, messages)}\n              </p>\n              <span className=\"cw-panel__footer-rule cw-panel__footer-rule--end\" aria-hidden />\n            </div>\n          </div>\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":["resolveFooterHint","actions","isTouchDevice","messages","actionPanel","action","ActionPanel","useActionPrompt","s","style","useTouchPrimaryDevice","useCaveWorldMessages","jsx","jsxs","index","disabled","ArrowRightIcon","ChevronRightIcon"],"mappings":"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"}

package/dist/explore/overlays/connector-label-beacon.d.ts

@@ -0,0 +1,11 @@
+import { type ConnectorLabelRendererProps } from '../../core/index.js';
+/**
+ * Default always-on wayfinding label for portal connectors.
+ *
+ * Shows the destination name at mid range, collapses to an arrow badge at long
+ * range, and greys out while the target scene is still preloading (a click then
+ * would have nowhere to go). Pass `renderConnectorLabel` to replace it — the SDK
+ * keeps owning distance fade and visibility gating either way.
+ */
+export default function ConnectorLabelBeacon({ label, opacity, displayMode, isPlayerInside, transferStatus, onClick }: ConnectorLabelRendererProps): import("react").JSX.Element | null;
+//# sourceMappingURL=connector-label-beacon.d.ts.map

package/dist/explore/overlays/connector-label-beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-label-beacon.d.ts","sourceRoot":"","sources":["../../../explore/overlays/connector-label-beacon.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAInF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAC3C,KAAK,EACL,OAAO,EACP,WAAW,EACX,cAAc,EACd,cAAc,EACd,OAAO,EACR,EAAE,2BAA2B,sCAmC7B"}

package/dist/explore/overlays/connector-label-beacon.js

@@ -0,0 +1,38 @@
+import { jsx as t, jsxs as g } from "react/jsx-runtime";
+import { useCaveWorldMessages as p } from "../../core/context/cave-world-context.js";
+import u from "./connector-label-tag-shell.js";
+import { ArrowRightIcon as b } from "./icons.js";
+function h({
+  label: r,
+  opacity: a,
+  displayMode: l,
+  isPlayerInside: s,
+  transferStatus: i,
+  onClick: c
+}) {
+  const m = p();
+  if (s || a <= 0 || l === "hidden") return null;
+  const e = i === "loading", n = !!c && !e, o = l === "compact", d = [
+    "cw-label__tag",
+    o ? "cw-label__tag--compact" : "",
+    e ? "cw-label__tag--pending" : n ? "cw-label__tag--interactive" : ""
+  ].filter(Boolean).join(" ");
+  return /* @__PURE__ */ t(u, { opacity: a, children: /* @__PURE__ */ g(
+    "div",
+    {
+      className: d,
+      onClick: n ? c : void 0,
+      role: n ? "button" : void 0,
+      "aria-busy": e || void 0,
+      style: { pointerEvents: n ? "auto" : "none" },
+      children: [
+        e ? /* @__PURE__ */ t("span", { className: "cw-spinner" }) : o ? /* @__PURE__ */ t(b, {}) : null,
+        o ? null : /* @__PURE__ */ t("span", { className: "cw-label__text", children: e ? m.connector.labelPending : r.text })
+      ]
+    }
+  ) });
+}
+export {
+  h as default
+};
+//# sourceMappingURL=connector-label-beacon.js.map

package/dist/explore/overlays/connector-label-beacon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-label-beacon.js","sources":["../../../explore/overlays/connector-label-beacon.tsx"],"sourcesContent":["import { useCaveWorldMessages, type ConnectorLabelRendererProps } from '../../core'\nimport ConnectorLabelTagShell from './connector-label-tag-shell'\nimport { ArrowRightIcon } from './icons'\n\n/**\n * Default always-on wayfinding label for portal connectors.\n *\n * Shows the destination name at mid range, collapses to an arrow badge at long\n * range, and greys out while the target scene is still preloading (a click then\n * would have nowhere to go). Pass `renderConnectorLabel` to replace it — the SDK\n * keeps owning distance fade and visibility gating either way.\n */\nexport default function ConnectorLabelBeacon({\n  label,\n  opacity,\n  displayMode,\n  isPlayerInside,\n  transferStatus,\n  onClick\n}: ConnectorLabelRendererProps) {\n  const messages = useCaveWorldMessages()\n\n  if (isPlayerInside || opacity <= 0 || displayMode === 'hidden') return null\n\n  const pending = transferStatus === 'loading'\n  const interactive = !!onClick && !pending\n  const compact = displayMode === 'compact'\n\n  const className = [\n    'cw-label__tag',\n    compact ? 'cw-label__tag--compact' : '',\n    pending ? 'cw-label__tag--pending' : interactive ? 'cw-label__tag--interactive' : ''\n  ]\n    .filter(Boolean)\n    .join(' ')\n\n  return (\n    <ConnectorLabelTagShell opacity={opacity}>\n      <div\n        className={className}\n        onClick={interactive ? onClick : undefined}\n        role={interactive ? 'button' : undefined}\n        aria-busy={pending || undefined}\n        style={{ pointerEvents: interactive ? 'auto' : 'none' }}\n      >\n        {pending ? <span className=\"cw-spinner\" /> : compact ? <ArrowRightIcon /> : null}\n        {compact ? null : (\n          <span className=\"cw-label__text\">\n            {pending ? messages.connector.labelPending : label.text}\n          </span>\n        )}\n      </div>\n    </ConnectorLabelTagShell>\n  )\n}\n"],"names":["ConnectorLabelBeacon","label","opacity","displayMode","isPlayerInside","transferStatus","onClick","messages","useCaveWorldMessages","pending","interactive","compact","className","jsx","ConnectorLabelTagShell","jsxs","ArrowRightIcon"],"mappings":";;;;AAYA,SAAwBA,EAAqB;AAAA,EAC3C,OAAAC;AAAA,EACA,SAAAC;AAAA,EACA,aAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,gBAAAC;AAAA,EACA,SAAAC;AACF,GAAgC;AAC9B,QAAMC,IAAWC,EAAA;AAEjB,MAAIJ,KAAkBF,KAAW,KAAKC,MAAgB,SAAU,QAAO;AAEvE,QAAMM,IAAUJ,MAAmB,WAC7BK,IAAc,CAAC,CAACJ,KAAW,CAACG,GAC5BE,IAAUR,MAAgB,WAE1BS,IAAY;AAAA,IAChB;AAAA,IACAD,IAAU,2BAA2B;AAAA,IACrCF,IAAU,2BAA2BC,IAAc,+BAA+B;AAAA,EAAA,EAEjF,OAAO,OAAO,EACd,KAAK,GAAG;AAEX,SACE,gBAAAG,EAACC,KAAuB,SAAAZ,GACtB,UAAA,gBAAAa;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAAH;AAAA,MACA,SAASF,IAAcJ,IAAU;AAAA,MACjC,MAAMI,IAAc,WAAW;AAAA,MAC/B,aAAWD,KAAW;AAAA,MACtB,OAAO,EAAE,eAAeC,IAAc,SAAS,OAAA;AAAA,MAE9C,UAAA;AAAA,QAAAD,IAAU,gBAAAI,EAAC,UAAK,WAAU,aAAA,CAAa,IAAKF,IAAU,gBAAAE,EAACG,KAAe,IAAK;AAAA,QAC3EL,IAAU,OACT,gBAAAE,EAAC,QAAA,EAAK,WAAU,kBACb,UAAAJ,IAAUF,EAAS,UAAU,eAAeN,EAAM,KAAA,CACrD;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA,GAGN;AAEJ;"}

package/dist/explore/overlays/connector-label-tag-shell.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from 'react';
+/**
+ * Billboard + `Html` shell shared by every connector-label renderer.
+ *
+ * Reuse it in a custom `renderConnectorLabel` so your label gets the same
+ * camera-facing behavior, opacity fade, and pointer handling as the built-in
+ * one, and you only supply the visuals.
+ *
+ * Pointer events are stopped here so clicking a label never reaches the canvas
+ * underneath (which would otherwise grab pointer lock and start a look-around).
+ */
+export default function ConnectorLabelTagShell({ opacity, children }: {
+    opacity: number;
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=connector-label-tag-shell.d.ts.map

package/dist/explore/overlays/connector-label-tag-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-label-tag-shell.d.ts","sourceRoot":"","sources":["../../../explore/overlays/connector-label-tag-shell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGnD;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,EAC7C,OAAO,EACP,QAAQ,EACT,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAwBA"}

package/dist/explore/overlays/connector-label-tag-shell.js

@@ -0,0 +1,18 @@
+import { jsx as t } from "react/jsx-runtime";
+import { useCallback as e } from "react";
+import { Billboard as c, Html as i } from "@react-three/drei";
+function u({
+  opacity: l,
+  children: r
+}) {
+  const n = e((o) => {
+    o.stopPropagation();
+  }, []), a = e((o) => {
+    o.stopPropagation();
+  }, []);
+  return /* @__PURE__ */ t(c, { follow: !0, lockX: !0, lockY: !0, lockZ: !0, children: /* @__PURE__ */ t(i, { center: !0, className: "cw-overlay-root cw-label", style: { opacity: l }, zIndexRange: [50, 0], children: /* @__PURE__ */ t("div", { className: "cw-label__hit", onClick: a, onPointerDown: n, children: r }) }) });
+}
+export {
+  u as default
+};
+//# sourceMappingURL=connector-label-tag-shell.js.map

package/dist/explore/overlays/connector-label-tag-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-label-tag-shell.js","sources":["../../../explore/overlays/connector-label-tag-shell.tsx"],"sourcesContent":["import { useCallback, type ReactNode } from 'react'\nimport { Billboard, Html } from '@react-three/drei'\n\n/**\n * Billboard + `Html` shell shared by every connector-label renderer.\n *\n * Reuse it in a custom `renderConnectorLabel` so your label gets the same\n * camera-facing behavior, opacity fade, and pointer handling as the built-in\n * one, and you only supply the visuals.\n *\n * Pointer events are stopped here so clicking a label never reaches the canvas\n * underneath (which would otherwise grab pointer lock and start a look-around).\n */\nexport default function ConnectorLabelTagShell({\n  opacity,\n  children\n}: {\n  opacity: number\n  children: ReactNode\n}) {\n  const stopPointerDown = useCallback((event: React.PointerEvent) => {\n    event.stopPropagation()\n  }, [])\n\n  const stopClick = useCallback((event: React.MouseEvent) => {\n    event.stopPropagation()\n  }, [])\n\n  return (\n    <Billboard follow lockX lockY lockZ>\n      {/*\n       * `cw-label` must not set a size: drei positions this wrapper with inline\n       * styles and centers it with `translate(-50%, -50%)`, so a width/height\n       * here would stretch it to the canvas and offset the tag by half a\n       * viewport.\n       */}\n      <Html center className=\"cw-overlay-root cw-label\" style={{ opacity }} zIndexRange={[50, 0]}>\n        <div className=\"cw-label__hit\" onClick={stopClick} onPointerDown={stopPointerDown}>\n          {children}\n        </div>\n      </Html>\n    </Billboard>\n  )\n}\n"],"names":["ConnectorLabelTagShell","opacity","children","stopPointerDown","useCallback","event","stopClick","jsx","Billboard","Html"],"mappings":";;;AAaA,SAAwBA,EAAuB;AAAA,EAC7C,SAAAC;AAAA,EACA,UAAAC;AACF,GAGG;AACD,QAAMC,IAAkBC,EAAY,CAACC,MAA8B;AACjE,IAAAA,EAAM,gBAAA;AAAA,EACR,GAAG,CAAA,CAAE,GAECC,IAAYF,EAAY,CAACC,MAA4B;AACzD,IAAAA,EAAM,gBAAA;AAAA,EACR,GAAG,CAAA,CAAE;AAEL,SACE,gBAAAE,EAACC,GAAA,EAAU,QAAM,IAAC,OAAK,IAAC,OAAK,IAAC,OAAK,IAOjC,UAAA,gBAAAD,EAACE,GAAA,EAAK,QAAM,IAAC,WAAU,4BAA2B,OAAO,EAAE,SAAAR,EAAA,GAAW,aAAa,CAAC,IAAI,CAAC,GACvF,UAAA,gBAAAM,EAAC,OAAA,EAAI,WAAU,iBAAgB,SAASD,GAAW,eAAeH,GAC/D,UAAAD,EAAA,CACH,GACF,GACF;AAEJ;"}

package/dist/explore/overlays/detail-window.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Built-in detail panel for objects carrying a `Window` component.
+ *
+ * Replace it wholesale with `renderDetailWindow` when you need product-specific
+ * layout; the event and store contract stays the same
+ * (`detail:open` / `detail:close`, `activeObject`, `detailVisible`).
+ */
+export default function DetailWindow(): import("react").JSX.Element | null;
+//# sourceMappingURL=detail-window.d.ts.map

package/dist/explore/overlays/detail-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-window.d.ts","sourceRoot":"","sources":["../../../explore/overlays/detail-window.tsx"],"names":[],"mappings":"AAsCA;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,uCA2FnC"}

package/dist/explore/overlays/detail-window.js

@@ -0,0 +1,92 @@
+import { jsxs as i, jsx as t, Fragment as b } from "react/jsx-runtime";
+import { useState as v, useCallback as x } from "react";
+import { useCaveWorldStore as d, useCaveEventBus as j, useCaveWorldMessages as I } from "../../core/context/cave-world-context.js";
+import { useCaveEvent as $ } from "../../core/hooks/use-cave-event.js";
+import { CloseIcon as O } from "./icons.js";
+const _ = 12;
+function D({ block: e }) {
+  switch (e.type) {
+    case "text":
+      return /* @__PURE__ */ t("div", { className: "cw-detail__text", children: e.text });
+    case "image":
+      return e.url ? /* @__PURE__ */ t("img", { src: e.url, alt: "" }) : null;
+    case "video":
+      return e.url ? /* @__PURE__ */ t("video", { controls: !0, loop: !0, muted: !0, playsInline: !0, children: /* @__PURE__ */ t("source", { src: e.url, type: "video/mp4" }) }) : null;
+    case "portal":
+      return e.url ? /* @__PURE__ */ t("iframe", { src: e.url, title: e.url }) : null;
+    default:
+      return null;
+  }
+}
+function f(e) {
+  return !e || e < 1 ? _ : Math.min(e, _);
+}
+function S(e) {
+  const s = e?.components?.Window?.contents;
+  return Array.isArray(s) ? s : [];
+}
+function E() {
+  const e = d((l) => l.activeObject), s = d((l) => l.detailVisible), r = d((l) => l.setDetailVisible), u = j(), m = I(), [c, p] = v(0), [w, g] = v(e);
+  w !== e && (g(e), p(0));
+  const n = S(e), y = n[c] ?? null;
+  $("detail:open", () => r(!0));
+  const C = x(() => {
+    r(!1), u.emit("detail:close", {});
+  }, [r, u]);
+  if (!s || n.length === 0) return null;
+  const h = e?.name || e?.text?.content || m.detail.untitled;
+  return /* @__PURE__ */ i("div", { className: "cw-overlay-root cw-detail", role: "dialog", "aria-label": h, children: [
+    /* @__PURE__ */ i("header", { className: "cw-detail__header", children: [
+      /* @__PURE__ */ t("span", { children: h }),
+      /* @__PURE__ */ t(
+        "button",
+        {
+          type: "button",
+          className: "cw-icon-button",
+          onClick: C,
+          "aria-label": m.detail.close,
+          children: /* @__PURE__ */ t(O, { size: 16 })
+        }
+      )
+    ] }),
+    /* @__PURE__ */ t("div", { className: "cw-detail__body", children: /* @__PURE__ */ t("div", { className: "cw-detail__grid", children: y?.blocks?.map((l, a) => /* @__PURE__ */ t(
+      "div",
+      {
+        className: "cw-detail__cell",
+        style: { gridColumn: `span ${f(l.col)}` },
+        children: /* @__PURE__ */ t(D, { block: l })
+      },
+      `${l.type}-${a}`
+    )) }) }),
+    n.length > 1 ? /* @__PURE__ */ i(b, { children: [
+      /* @__PURE__ */ i("div", { className: "cw-detail__counter", children: [
+        c + 1,
+        " / ",
+        n.length
+      ] }),
+      /* @__PURE__ */ t("div", { className: "cw-detail__thumbs", children: n.map((l, a) => /* @__PURE__ */ t(
+        "button",
+        {
+          type: "button",
+          className: "cw-detail__thumb",
+          "aria-current": a === c,
+          onClick: () => p(a),
+          children: l.blocks?.map((o, N) => /* @__PURE__ */ t(
+            "span",
+            {
+              className: "cw-detail__thumb-cell",
+              style: { gridColumn: `span ${f(o.col)}` },
+              children: o.type
+            },
+            `${o.type}-${N}`
+          ))
+        },
+        l.id ?? a
+      )) })
+    ] }) : null
+  ] });
+}
+export {
+  E as default
+};
+//# sourceMappingURL=detail-window.js.map

package/dist/explore/overlays/detail-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-window.js","sources":["../../../explore/overlays/detail-window.tsx"],"sourcesContent":["import { useCallback, useState } from 'react'\nimport { useCaveEvent, useCaveEventBus, useCaveWorldMessages, useCaveWorldStore } from '../../core'\nimport type { Block, Content, CustomObject } from '../../types'\nimport { CloseIcon } from './icons'\n\n/** Blocks declare a 12-column span in the scene JSON. */\nconst GRID_COLUMNS = 12\n\nfunction BlockItem({ block }: { block: Block }) {\n  switch (block.type) {\n    case 'text':\n      return <div className=\"cw-detail__text\">{block.text}</div>\n    case 'image':\n      return block.url ? <img src={block.url} alt=\"\" /> : null\n    case 'video':\n      return block.url ? (\n        <video controls loop muted playsInline>\n          <source src={block.url} type=\"video/mp4\" />\n        </video>\n      ) : null\n    case 'portal':\n      return block.url ? <iframe src={block.url} title={block.url} /> : null\n    default:\n      return null\n  }\n}\n\nfunction clampSpan(col: number | undefined): number {\n  if (!col || col < 1) return GRID_COLUMNS\n  return Math.min(col, GRID_COLUMNS)\n}\n\n/** `Window.contents` is typed `unknown[]` in the schema; narrow it here. */\nfunction resolveContents(object: CustomObject | undefined): Content[] {\n  const contents = object?.components?.Window?.contents\n  return Array.isArray(contents) ? (contents as Content[]) : []\n}\n\n/**\n * Built-in detail panel for objects carrying a `Window` component.\n *\n * Replace it wholesale with `renderDetailWindow` when you need product-specific\n * layout; the event and store contract stays the same\n * (`detail:open` / `detail:close`, `activeObject`, `detailVisible`).\n */\nexport default function DetailWindow() {\n  const activeObject = useCaveWorldStore((s) => s.activeObject)\n  const detailVisible = useCaveWorldStore((s) => s.detailVisible)\n  const setDetailVisible = useCaveWorldStore((s) => s.setDetailVisible)\n  const eventBus = useCaveEventBus()\n  const messages = useCaveWorldMessages()\n\n  const [activeIndex, setActiveIndex] = useState(0)\n  const [pagedObject, setPagedObject] = useState(activeObject)\n\n  // Reset paging when the target object changes. Adjusted during render (the\n  // pattern React recommends over a reset effect) so the first paint of a new\n  // object already shows page 1 instead of flashing the previous page index.\n  if (pagedObject !== activeObject) {\n    setPagedObject(activeObject)\n    setActiveIndex(0)\n  }\n\n  const contents = resolveContents(activeObject)\n  const activeContent = contents[activeIndex] ?? null\n\n  useCaveEvent('detail:open', () => setDetailVisible(true))\n\n  const handleClose = useCallback(() => {\n    setDetailVisible(false)\n    eventBus.emit('detail:close', {})\n  }, [setDetailVisible, eventBus])\n\n  if (!detailVisible || contents.length === 0) return null\n\n  const title = activeObject?.name || activeObject?.text?.content || messages.detail.untitled\n\n  return (\n    <div className=\"cw-overlay-root cw-detail\" role=\"dialog\" aria-label={title}>\n      <header className=\"cw-detail__header\">\n        <span>{title}</span>\n        <button\n          type=\"button\"\n          className=\"cw-icon-button\"\n          onClick={handleClose}\n          aria-label={messages.detail.close}\n        >\n          <CloseIcon size={16} />\n        </button>\n      </header>\n\n      <div className=\"cw-detail__body\">\n        <div className=\"cw-detail__grid\">\n          {activeContent?.blocks?.map((block, index) => (\n            <div\n              key={`${block.type}-${index}`}\n              className=\"cw-detail__cell\"\n              style={{ gridColumn: `span ${clampSpan(block.col)}` }}\n            >\n              <BlockItem block={block} />\n            </div>\n          ))}\n        </div>\n      </div>\n\n      {contents.length > 1 ? (\n        <>\n          <div className=\"cw-detail__counter\">\n            {activeIndex + 1} / {contents.length}\n          </div>\n\n          <div className=\"cw-detail__thumbs\">\n            {contents.map((content, index) => (\n              <button\n                key={content.id ?? index}\n                type=\"button\"\n                className=\"cw-detail__thumb\"\n                aria-current={index === activeIndex}\n                onClick={() => setActiveIndex(index)}\n              >\n                {content.blocks?.map((block, blockIndex) => (\n                  <span\n                    key={`${block.type}-${blockIndex}`}\n                    className=\"cw-detail__thumb-cell\"\n                    style={{ gridColumn: `span ${clampSpan(block.col)}` }}\n                  >\n                    {block.type}\n                  </span>\n                ))}\n              </button>\n            ))}\n          </div>\n        </>\n      ) : null}\n    </div>\n  )\n}\n"],"names":["GRID_COLUMNS","BlockItem","block","jsx","clampSpan","col","resolveContents","object","contents","DetailWindow","activeObject","useCaveWorldStore","s","detailVisible","setDetailVisible","eventBus","useCaveEventBus","messages","useCaveWorldMessages","activeIndex","setActiveIndex","useState","pagedObject","setPagedObject","activeContent","useCaveEvent","handleClose","useCallback","title","jsxs","CloseIcon","index","Fragment","content","blockIndex"],"mappings":"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"}

package/dist/explore/overlays/explore-helper.d.ts

@@ -0,0 +1,44 @@
+import { type ReactNode } from 'react';
+/** One row in the default hint card. */
+export interface ExploreHelperHint {
+    /** Key cap or gesture name, e.g. `'W A S D'`. */
+    keys: string;
+    /** What it does. */
+    desc: string;
+}
+export interface ExploreHelperConfig {
+    /**
+     * `localStorage` key used to remember that the player dismissed the hints.
+     * Set it to something app-specific so two SDK embeds don't share state; pass
+     * `false` to show the hints on every visit.
+     */
+    storageKey?: string | false;
+    /** Replace the default hint rows. */
+    hints?: ExploreHelperHint[];
+    /** Hint rows used on touch devices. */
+    touchHints?: ExploreHelperHint[];
+}
+export interface ExploreHelperRenderProps {
+    /** Whether the current device uses on-screen touch controls. */
+    isTouchDevice: boolean;
+    /** Hints resolved for the current device. */
+    hints: ExploreHelperHint[];
+    /** Hide the helper and persist the dismissal. */
+    dismiss: () => void;
+}
+/** Fully replace the built-in onboarding card. */
+export type ExploreHelperRenderer = (props: ExploreHelperRenderProps) => ReactNode;
+export declare const DEFAULT_EXPLORE_HELPER_STORAGE_KEY = "cave-world:explore-helper-seen:v1";
+export interface ExploreHelperProps {
+    config?: ExploreHelperConfig;
+    render?: ExploreHelperRenderer;
+}
+/**
+ * First-run controls hint.
+ *
+ * Shown once per browser (keyed by `config.storageKey`) and dismissible. Pass
+ * `render` to substitute your own onboarding UI while keeping the SDK's
+ * show-once logic and device detection.
+ */
+export default function ExploreHelper({ config, render }: ExploreHelperProps): import("react").JSX.Element | null;
+//# sourceMappingURL=explore-helper.d.ts.map

package/dist/explore/overlays/explore-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-helper.d.ts","sourceRoot":"","sources":["../../../explore/overlays/explore-helper.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMvE,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,qCAAqC;IACrC,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAA;IACtB,6CAA6C;IAC7C,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,iDAAiD;IACjD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,kDAAkD;AAClD,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,SAAS,CAAA;AAElF,eAAO,MAAM,kCAAkC,sCAAsC,CAAA;AAuBrF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,kBAAkB,sCAiE3E"}

package/dist/explore/overlays/explore-helper.js

@@ -0,0 +1,57 @@
+import { jsx as r, Fragment as u, jsxs as n } from "react/jsx-runtime";
+import { useMemo as m, useEffect as y, useCallback as k } from "react";
+import { useCaveWorldMessages as f } from "../../core/context/cave-world-context.js";
+import { useTouchPrimaryDevice as w } from "../../space/utils/touch-primary-device.js";
+import { useCaveExplore as v, useCaveExploreStore as _ } from "../stores/explore-context.js";
+import { CloseIcon as E } from "./icons.js";
+const p = "cave-world:explore-helper-seen:v1";
+function S(e) {
+  if (e === !1) return !1;
+  const t = e ?? p;
+  try {
+    return localStorage.getItem(t) === "true";
+  } catch {
+    return !1;
+  }
+}
+function N(e) {
+  if (e === !1) return;
+  const t = e ?? p;
+  try {
+    localStorage.setItem(t, "true");
+  } catch {
+  }
+}
+function T({ config: e, render: t }) {
+  const a = w(), s = f(), d = v((c) => c.showHelper), o = _(), l = e?.storageKey, i = m(() => a ? e?.touchHints ?? [
+    { keys: "◎", desc: s.helper.touch.move },
+    { keys: "☰", desc: s.helper.touch.look },
+    { keys: "◉", desc: s.helper.touch.interact }
+  ] : e?.hints ?? [
+    { keys: "W A S D", desc: s.helper.keyboard.move },
+    { keys: "🖱", desc: s.helper.keyboard.look },
+    { keys: "Space", desc: s.helper.keyboard.jump },
+    { keys: "F", desc: s.helper.keyboard.interact }
+  ], [a, e?.hints, e?.touchHints, s]);
+  y(() => {
+    o.getState().setShowHelper(!S(l));
+  }, [o, l]);
+  const h = k(() => {
+    N(l), o.getState().setShowHelper(!1);
+  }, [o, l]);
+  return d ? t ? /* @__PURE__ */ r(u, { children: t({ isTouchDevice: a, hints: i, dismiss: h }) }) : /* @__PURE__ */ r("div", { className: "cw-overlay-root cw-helper", children: /* @__PURE__ */ r("div", { className: "cw-helper__card", children: /* @__PURE__ */ n("div", { className: "cw-helper__inner cw-surface", children: [
+    /* @__PURE__ */ r("div", { className: "cw-helper__hints", children: i.map((c) => /* @__PURE__ */ n("div", { className: "cw-helper__hint", children: [
+      /* @__PURE__ */ r("span", { className: "cw-key", children: c.keys }),
+      /* @__PURE__ */ r("span", { className: "cw-helper__hint-desc", children: c.desc })
+    ] }, c.keys)) }),
+    /* @__PURE__ */ r("div", { className: "cw-helper__actions", children: /* @__PURE__ */ n("button", { type: "button", className: "cw-button", onClick: h, children: [
+      /* @__PURE__ */ r(E, { size: 12 }),
+      s.helper.close
+    ] }) })
+  ] }) }) }) : null;
+}
+export {
+  p as DEFAULT_EXPLORE_HELPER_STORAGE_KEY,
+  T as default
+};
+//# sourceMappingURL=explore-helper.js.map

package/dist/explore/overlays/explore-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-helper.js","sources":["../../../explore/overlays/explore-helper.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, type ReactNode } from 'react'\nimport { useCaveWorldMessages } from '../../core'\nimport { useTouchPrimaryDevice } from '../../space'\nimport { useCaveExplore, useCaveExploreStore } from '../stores/explore-context'\nimport { CloseIcon } from './icons'\n\n/** One row in the default hint card. */\nexport interface ExploreHelperHint {\n  /** Key cap or gesture name, e.g. `'W A S D'`. */\n  keys: string\n  /** What it does. */\n  desc: string\n}\n\nexport interface ExploreHelperConfig {\n  /**\n   * `localStorage` key used to remember that the player dismissed the hints.\n   * Set it to something app-specific so two SDK embeds don't share state; pass\n   * `false` to show the hints on every visit.\n   */\n  storageKey?: string | false\n  /** Replace the default hint rows. */\n  hints?: ExploreHelperHint[]\n  /** Hint rows used on touch devices. */\n  touchHints?: ExploreHelperHint[]\n}\n\nexport interface ExploreHelperRenderProps {\n  /** Whether the current device uses on-screen touch controls. */\n  isTouchDevice: boolean\n  /** Hints resolved for the current device. */\n  hints: ExploreHelperHint[]\n  /** Hide the helper and persist the dismissal. */\n  dismiss: () => void\n}\n\n/** Fully replace the built-in onboarding card. */\nexport type ExploreHelperRenderer = (props: ExploreHelperRenderProps) => ReactNode\n\nexport const DEFAULT_EXPLORE_HELPER_STORAGE_KEY = 'cave-world:explore-helper-seen:v1'\n\nfunction readDismissed(storageKey: string | false | undefined): boolean {\n  if (storageKey === false) return false\n  const key = storageKey ?? DEFAULT_EXPLORE_HELPER_STORAGE_KEY\n  try {\n    return localStorage.getItem(key) === 'true'\n  } catch {\n    // Private browsing / disabled storage: fall back to showing the hints.\n    return false\n  }\n}\n\nfunction writeDismissed(storageKey: string | false | undefined): void {\n  if (storageKey === false) return\n  const key = storageKey ?? DEFAULT_EXPLORE_HELPER_STORAGE_KEY\n  try {\n    localStorage.setItem(key, 'true')\n  } catch {\n    // Nothing to do — the helper just reappears next session.\n  }\n}\n\nexport interface ExploreHelperProps {\n  config?: ExploreHelperConfig\n  render?: ExploreHelperRenderer\n}\n\n/**\n * First-run controls hint.\n *\n * Shown once per browser (keyed by `config.storageKey`) and dismissible. Pass\n * `render` to substitute your own onboarding UI while keeping the SDK's\n * show-once logic and device detection.\n */\nexport default function ExploreHelper({ config, render }: ExploreHelperProps) {\n  const isTouchDevice = useTouchPrimaryDevice()\n  const messages = useCaveWorldMessages()\n  const showHelper = useCaveExplore((s) => s.showHelper)\n  const store = useCaveExploreStore()\n  const storageKey = config?.storageKey\n\n  const hints = useMemo<ExploreHelperHint[]>(() => {\n    if (isTouchDevice) {\n      return (\n        config?.touchHints ?? [\n          { keys: '◎', desc: messages.helper.touch.move },\n          { keys: '☰', desc: messages.helper.touch.look },\n          { keys: '◉', desc: messages.helper.touch.interact }\n        ]\n      )\n    }\n    return (\n      config?.hints ?? [\n        { keys: 'W A S D', desc: messages.helper.keyboard.move },\n        { keys: '🖱', desc: messages.helper.keyboard.look },\n        { keys: 'Space', desc: messages.helper.keyboard.jump },\n        { keys: 'F', desc: messages.helper.keyboard.interact }\n      ]\n    )\n  }, [isTouchDevice, config?.hints, config?.touchHints, messages])\n\n  useEffect(() => {\n    store.getState().setShowHelper(!readDismissed(storageKey))\n  }, [store, storageKey])\n\n  const dismiss = useCallback(() => {\n    writeDismissed(storageKey)\n    store.getState().setShowHelper(false)\n  }, [store, storageKey])\n\n  if (!showHelper) return null\n\n  if (render) {\n    return <>{render({ isTouchDevice, hints, dismiss })}</>\n  }\n\n  return (\n    <div className=\"cw-overlay-root cw-helper\">\n      <div className=\"cw-helper__card\">\n        <div className=\"cw-helper__inner cw-surface\">\n          <div className=\"cw-helper__hints\">\n            {hints.map((hint) => (\n              <div key={hint.keys} className=\"cw-helper__hint\">\n                <span className=\"cw-key\">{hint.keys}</span>\n                <span className=\"cw-helper__hint-desc\">{hint.desc}</span>\n              </div>\n            ))}\n          </div>\n\n          <div className=\"cw-helper__actions\">\n            <button type=\"button\" className=\"cw-button\" onClick={dismiss}>\n              <CloseIcon size={12} />\n              {messages.helper.close}\n            </button>\n          </div>\n        </div>\n      </div>\n    </div>\n  )\n}\n"],"names":["DEFAULT_EXPLORE_HELPER_STORAGE_KEY","readDismissed","storageKey","key","writeDismissed","ExploreHelper","config","render","isTouchDevice","useTouchPrimaryDevice","messages","useCaveWorldMessages","showHelper","useCaveExplore","s","store","useCaveExploreStore","hints","useMemo","useEffect","dismiss","useCallback","jsx","jsxs","hint","CloseIcon"],"mappings":";;;;;;AAuCO,MAAMA,IAAqC;AAElD,SAASC,EAAcC,GAAiD;AACtE,MAAIA,MAAe,GAAO,QAAO;AACjC,QAAMC,IAAMD,KAAcF;AAC1B,MAAI;AACF,WAAO,aAAa,QAAQG,CAAG,MAAM;AAAA,EACvC,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAEA,SAASC,EAAeF,GAA8C;AACpE,MAAIA,MAAe,GAAO;AAC1B,QAAMC,IAAMD,KAAcF;AAC1B,MAAI;AACF,iBAAa,QAAQG,GAAK,MAAM;AAAA,EAClC,QAAQ;AAAA,EAER;AACF;AAcA,SAAwBE,EAAc,EAAE,QAAAC,GAAQ,QAAAC,KAA8B;AAC5E,QAAMC,IAAgBC,EAAA,GAChBC,IAAWC,EAAA,GACXC,IAAaC,EAAe,CAACC,MAAMA,EAAE,UAAU,GAC/CC,IAAQC,EAAA,GACRd,IAAaI,GAAQ,YAErBW,IAAQC,EAA6B,MACrCV,IAEAF,GAAQ,cAAc;AAAA,IACpB,EAAE,MAAM,KAAK,MAAMI,EAAS,OAAO,MAAM,KAAA;AAAA,IACzC,EAAE,MAAM,KAAK,MAAMA,EAAS,OAAO,MAAM,KAAA;AAAA,IACzC,EAAE,MAAM,KAAK,MAAMA,EAAS,OAAO,MAAM,SAAA;AAAA,EAAS,IAKtDJ,GAAQ,SAAS;AAAA,IACf,EAAE,MAAM,WAAW,MAAMI,EAAS,OAAO,SAAS,KAAA;AAAA,IAClD,EAAE,MAAM,MAAM,MAAMA,EAAS,OAAO,SAAS,KAAA;AAAA,IAC7C,EAAE,MAAM,SAAS,MAAMA,EAAS,OAAO,SAAS,KAAA;AAAA,IAChD,EAAE,MAAM,KAAK,MAAMA,EAAS,OAAO,SAAS,SAAA;AAAA,EAAS,GAGxD,CAACF,GAAeF,GAAQ,OAAOA,GAAQ,YAAYI,CAAQ,CAAC;AAE/D,EAAAS,EAAU,MAAM;AACd,IAAAJ,EAAM,WAAW,cAAc,CAACd,EAAcC,CAAU,CAAC;AAAA,EAC3D,GAAG,CAACa,GAAOb,CAAU,CAAC;AAEtB,QAAMkB,IAAUC,EAAY,MAAM;AAChC,IAAAjB,EAAeF,CAAU,GACzBa,EAAM,SAAA,EAAW,cAAc,EAAK;AAAA,EACtC,GAAG,CAACA,GAAOb,CAAU,CAAC;AAEtB,SAAKU,IAEDL,2BACQ,UAAAA,EAAO,EAAE,eAAAC,GAAe,OAAAS,GAAO,SAAAG,EAAA,CAAS,GAAE,IAIpD,gBAAAE,EAAC,OAAA,EAAI,WAAU,6BACb,UAAA,gBAAAA,EAAC,OAAA,EAAI,WAAU,mBACb,UAAA,gBAAAC,EAAC,OAAA,EAAI,WAAU,+BACb,UAAA;AAAA,IAAA,gBAAAD,EAAC,OAAA,EAAI,WAAU,oBACZ,UAAAL,EAAM,IAAI,CAACO,MACV,gBAAAD,EAAC,OAAA,EAAoB,WAAU,mBAC7B,UAAA;AAAA,MAAA,gBAAAD,EAAC,QAAA,EAAK,WAAU,UAAU,UAAAE,EAAK,MAAK;AAAA,MACpC,gBAAAF,EAAC,QAAA,EAAK,WAAU,wBAAwB,YAAK,KAAA,CAAK;AAAA,IAAA,EAAA,GAF1CE,EAAK,IAGf,CACD,GACH;AAAA,IAEA,gBAAAF,EAAC,OAAA,EAAI,WAAU,sBACb,UAAA,gBAAAC,EAAC,UAAA,EAAO,MAAK,UAAS,WAAU,aAAY,SAASH,GACnD,UAAA;AAAA,MAAA,gBAAAE,EAACG,GAAA,EAAU,MAAM,GAAA,CAAI;AAAA,MACpBf,EAAS,OAAO;AAAA,IAAA,EAAA,CACnB,EAAA,CACF;AAAA,EAAA,EAAA,CACF,GACF,GACF,IA3BsB;AA6B1B;"}

package/dist/explore/overlays/icons.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Inline icons for the built-in overlays.
+ *
+ * Deliberately hand-written rather than pulled from an icon package: an SDK
+ * should not force an icon dependency (or its bundle cost) on every consumer.
+ */
+export declare function CloseIcon({ size }: {
+    size?: number;
+}): import("react").JSX.Element;
+export declare function ArrowRightIcon({ size }: {
+    size?: number;
+}): import("react").JSX.Element;
+export declare function ChevronRightIcon({ size }: {
+    size?: number;
+}): import("react").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

package/dist/explore/overlays/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../explore/overlays/icons.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,SAAS,CAAC,EAAE,IAAS,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,+BAMzD;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAS,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,+BAY9D;AAED,wBAAgB,gBAAgB,CAAC,EAAE,IAAS,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,+BAYhE"}

package/dist/explore/overlays/icons.js

@@ -0,0 +1,34 @@
+import { jsx as o } from "react/jsx-runtime";
+function n({ size: r = 14 }) {
+  return /* @__PURE__ */ o("svg", { width: r, height: r, viewBox: "0 0 24 24", fill: "none", "aria-hidden": !0, children: /* @__PURE__ */ o("path", { d: "M6 6l12 12M18 6L6 18", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" }) });
+}
+function t({ size: r = 14 }) {
+  return /* @__PURE__ */ o("svg", { width: r, height: r, viewBox: "0 0 24 24", fill: "none", "aria-hidden": !0, children: /* @__PURE__ */ o(
+    "path",
+    {
+      d: "M5 12h12M13 7l5 5-5 5",
+      stroke: "currentColor",
+      strokeWidth: "1.75",
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }
+  ) });
+}
+function i({ size: r = 14 }) {
+  return /* @__PURE__ */ o("svg", { width: r, height: r, viewBox: "0 0 24 24", fill: "none", "aria-hidden": !0, children: /* @__PURE__ */ o(
+    "path",
+    {
+      d: "M9 6l6 6-6 6",
+      stroke: "currentColor",
+      strokeWidth: "2",
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }
+  ) });
+}
+export {
+  t as ArrowRightIcon,
+  i as ChevronRightIcon,
+  n as CloseIcon
+};
+//# sourceMappingURL=icons.js.map

package/dist/explore/overlays/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sources":["../../../explore/overlays/icons.tsx"],"sourcesContent":["/**\n * Inline icons for the built-in overlays.\n *\n * Deliberately hand-written rather than pulled from an icon package: an SDK\n * should not force an icon dependency (or its bundle cost) on every consumer.\n */\n\nexport function CloseIcon({ size = 14 }: { size?: number }) {\n  return (\n    <svg width={size} height={size} viewBox=\"0 0 24 24\" fill=\"none\" aria-hidden>\n      <path d=\"M6 6l12 12M18 6L6 18\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\" />\n    </svg>\n  )\n}\n\nexport function ArrowRightIcon({ size = 14 }: { size?: number }) {\n  return (\n    <svg width={size} height={size} viewBox=\"0 0 24 24\" fill=\"none\" aria-hidden>\n      <path\n        d=\"M5 12h12M13 7l5 5-5 5\"\n        stroke=\"currentColor\"\n        strokeWidth=\"1.75\"\n        strokeLinecap=\"round\"\n        strokeLinejoin=\"round\"\n      />\n    </svg>\n  )\n}\n\nexport function ChevronRightIcon({ size = 14 }: { size?: number }) {\n  return (\n    <svg width={size} height={size} viewBox=\"0 0 24 24\" fill=\"none\" aria-hidden>\n      <path\n        d=\"M9 6l6 6-6 6\"\n        stroke=\"currentColor\"\n        strokeWidth=\"2\"\n        strokeLinecap=\"round\"\n        strokeLinejoin=\"round\"\n      />\n    </svg>\n  )\n}\n"],"names":["CloseIcon","size","jsx","ArrowRightIcon","ChevronRightIcon"],"mappings":";AAOO,SAASA,EAAU,EAAE,MAAAC,IAAO,MAAyB;AAC1D,SACE,gBAAAC,EAAC,SAAI,OAAOD,GAAM,QAAQA,GAAM,SAAQ,aAAY,MAAK,QAAO,eAAW,IACzE,UAAA,gBAAAC,EAAC,QAAA,EAAK,GAAE,wBAAuB,QAAO,gBAAe,aAAY,KAAI,eAAc,QAAA,CAAQ,EAAA,CAC7F;AAEJ;AAEO,SAASC,EAAe,EAAE,MAAAF,IAAO,MAAyB;AAC/D,SACE,gBAAAC,EAAC,OAAA,EAAI,OAAOD,GAAM,QAAQA,GAAM,SAAQ,aAAY,MAAK,QAAO,eAAW,IACzE,UAAA,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,GAAE;AAAA,MACF,QAAO;AAAA,MACP,aAAY;AAAA,MACZ,eAAc;AAAA,MACd,gBAAe;AAAA,IAAA;AAAA,EAAA,GAEnB;AAEJ;AAEO,SAASE,EAAiB,EAAE,MAAAH,IAAO,MAAyB;AACjE,SACE,gBAAAC,EAAC,OAAA,EAAI,OAAOD,GAAM,QAAQA,GAAM,SAAQ,aAAY,MAAK,QAAO,eAAW,IACzE,UAAA,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,GAAE;AAAA,MACF,QAAO;AAAA,MACP,aAAY;AAAA,MACZ,eAAc;AAAA,MACd,gBAAe;AAAA,IAAA;AAAA,EAAA,GAEnB;AAEJ;"}

package/dist/explore/overlays/space-load-error-overlay.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from 'react';
+import { type SpaceLoadError } from '../../core/index.js';
+export interface LoadErrorRenderProps {
+    /** The terminal load failure. */
+    error: SpaceLoadError;
+    /** Retry the failed load (re-fetch config / re-download splat). */
+    retry: () => void;
+    /** Go back, when the host wired an `onLoadErrorExit` handler. */
+    exit?: () => void;
+}
+/** Fully replace the built-in load-error prompt. */
+export type LoadErrorRenderer = (props: LoadErrorRenderProps) => ReactNode;
+export interface SpaceLoadErrorOverlayProps {
+    onExit?: () => void;
+    render?: LoadErrorRenderer;
+}
+/**
+ * Prompt shown when a space fails to load after automatic retries are
+ * exhausted, so the page cannot hang on an infinite loading screen.
+ *
+ * Rendered through a portal to `document.body` at a very high z-index: the
+ * host's own loading UI is usually a `fixed` sibling *outside* the viewer
+ * subtree, and would otherwise cover this prompt — leaving the user staring at
+ * a spinner that never resolves.
+ */
+export default function SpaceLoadErrorOverlay({ onExit, render }: SpaceLoadErrorOverlayProps): import("react").ReactPortal | null;
+//# sourceMappingURL=space-load-error-overlay.d.ts.map

package/dist/explore/overlays/space-load-error-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-load-error-overlay.d.ts","sourceRoot":"","sources":["../../../explore/overlays/space-load-error-overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,EAA2C,KAAK,cAAc,EAAE,MAAM,YAAY,CAAA;AAEzF,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,KAAK,EAAE,cAAc,CAAA;IACrB,mEAAmE;IACnE,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,oDAAoD;AACpD,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,SAAS,CAAA;AAE1E,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,0BAA0B,sCA0C3F"}

package/dist/explore/overlays/space-load-error-overlay.js

@@ -0,0 +1,24 @@
+import { jsx as r, jsxs as c } from "react/jsx-runtime";
+import { useCallback as m } from "react";
+import { createPortal as p } from "react-dom";
+import { useCaveWorldStore as d, useCaveWorldMessages as f } from "../../core/context/cave-world-context.js";
+function v({ onExit: o, render: l }) {
+  const a = d((t) => t.spaceLoadError), s = d((t) => t.retrySpaceLoad), e = f(), n = m(() => s(), [s]);
+  if (!a || typeof document > "u") return null;
+  const i = a.stage === "config" ? e.loadError.configTitle : e.loadError.splatTitle, u = l ? l({ error: a, retry: n, exit: o }) : /* @__PURE__ */ r("div", { className: "cw-overlay-root cw-error-layer", role: "alertdialog", "aria-label": i, children: /* @__PURE__ */ c("div", { className: "cw-error", children: [
+    /* @__PURE__ */ r("div", { className: "cw-error__badge", "aria-hidden": !0, children: "!" }),
+    /* @__PURE__ */ c("div", { children: [
+      /* @__PURE__ */ r("p", { className: "cw-error__title", children: i }),
+      /* @__PURE__ */ r("p", { className: "cw-error__message", children: e.loadError.description })
+    ] }),
+    /* @__PURE__ */ c("div", { className: "cw-error__actions", children: [
+      /* @__PURE__ */ r("button", { type: "button", className: "cw-button cw-button--primary", onClick: n, children: e.loadError.retry }),
+      o ? /* @__PURE__ */ r("button", { type: "button", className: "cw-button", onClick: o, children: e.loadError.exit }) : null
+    ] })
+  ] }) });
+  return p(u, document.body);
+}
+export {
+  v as default
+};
+//# sourceMappingURL=space-load-error-overlay.js.map

package/dist/explore/overlays/space-load-error-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-load-error-overlay.js","sources":["../../../explore/overlays/space-load-error-overlay.tsx"],"sourcesContent":["import { useCallback, type ReactNode } from 'react'\nimport { createPortal } from 'react-dom'\nimport { useCaveWorldMessages, useCaveWorldStore, type SpaceLoadError } from '../../core'\n\nexport interface LoadErrorRenderProps {\n  /** The terminal load failure. */\n  error: SpaceLoadError\n  /** Retry the failed load (re-fetch config / re-download splat). */\n  retry: () => void\n  /** Go back, when the host wired an `onLoadErrorExit` handler. */\n  exit?: () => void\n}\n\n/** Fully replace the built-in load-error prompt. */\nexport type LoadErrorRenderer = (props: LoadErrorRenderProps) => ReactNode\n\nexport interface SpaceLoadErrorOverlayProps {\n  onExit?: () => void\n  render?: LoadErrorRenderer\n}\n\n/**\n * Prompt shown when a space fails to load after automatic retries are\n * exhausted, so the page cannot hang on an infinite loading screen.\n *\n * Rendered through a portal to `document.body` at a very high z-index: the\n * host's own loading UI is usually a `fixed` sibling *outside* the viewer\n * subtree, and would otherwise cover this prompt — leaving the user staring at\n * a spinner that never resolves.\n */\nexport default function SpaceLoadErrorOverlay({ onExit, render }: SpaceLoadErrorOverlayProps) {\n  const spaceLoadError = useCaveWorldStore((s) => s.spaceLoadError)\n  const retrySpaceLoad = useCaveWorldStore((s) => s.retrySpaceLoad)\n  const messages = useCaveWorldMessages()\n\n  const retry = useCallback(() => retrySpaceLoad(), [retrySpaceLoad])\n\n  if (!spaceLoadError) return null\n  if (typeof document === 'undefined') return null\n\n  const title =\n    spaceLoadError.stage === 'config'\n      ? messages.loadError.configTitle\n      : messages.loadError.splatTitle\n\n  const content = render ? (\n    render({ error: spaceLoadError, retry, exit: onExit })\n  ) : (\n    <div className=\"cw-overlay-root cw-error-layer\" role=\"alertdialog\" aria-label={title}>\n      <div className=\"cw-error\">\n        <div className=\"cw-error__badge\" aria-hidden>\n          !\n        </div>\n        <div>\n          <p className=\"cw-error__title\">{title}</p>\n          <p className=\"cw-error__message\">{messages.loadError.description}</p>\n        </div>\n        <div className=\"cw-error__actions\">\n          <button type=\"button\" className=\"cw-button cw-button--primary\" onClick={retry}>\n            {messages.loadError.retry}\n          </button>\n          {onExit ? (\n            <button type=\"button\" className=\"cw-button\" onClick={onExit}>\n              {messages.loadError.exit}\n            </button>\n          ) : null}\n        </div>\n      </div>\n    </div>\n  )\n\n  return createPortal(content, document.body)\n}\n"],"names":["SpaceLoadErrorOverlay","onExit","render","spaceLoadError","useCaveWorldStore","s","retrySpaceLoad","messages","useCaveWorldMessages","retry","useCallback","title","content","jsxs","jsx","createPortal"],"mappings":";;;;AA8BA,SAAwBA,EAAsB,EAAE,QAAAC,GAAQ,QAAAC,KAAsC;AAC5F,QAAMC,IAAiBC,EAAkB,CAACC,MAAMA,EAAE,cAAc,GAC1DC,IAAiBF,EAAkB,CAACC,MAAMA,EAAE,cAAc,GAC1DE,IAAWC,EAAA,GAEXC,IAAQC,EAAY,MAAMJ,KAAkB,CAACA,CAAc,CAAC;AAGlE,MADI,CAACH,KACD,OAAO,WAAa,IAAa,QAAO;AAE5C,QAAMQ,IACJR,EAAe,UAAU,WACrBI,EAAS,UAAU,cACnBA,EAAS,UAAU,YAEnBK,IAAUV,IACdA,EAAO,EAAE,OAAOC,GAAgB,OAAAM,GAAO,MAAMR,GAAQ,sBAEpD,OAAA,EAAI,WAAU,kCAAiC,MAAK,eAAc,cAAYU,GAC7E,UAAA,gBAAAE,EAAC,OAAA,EAAI,WAAU,YACb,UAAA;AAAA,IAAA,gBAAAC,EAAC,OAAA,EAAI,WAAU,mBAAkB,eAAW,IAAC,UAAA,KAE7C;AAAA,sBACC,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAA,EAAC,KAAA,EAAE,WAAU,mBAAmB,UAAAH,GAAM;AAAA,wBACrC,KAAA,EAAE,WAAU,qBAAqB,UAAAJ,EAAS,UAAU,YAAA,CAAY;AAAA,IAAA,GACnE;AAAA,IACA,gBAAAM,EAAC,OAAA,EAAI,WAAU,qBACb,UAAA;AAAA,MAAA,gBAAAC,EAAC,UAAA,EAAO,MAAK,UAAS,WAAU,gCAA+B,SAASL,GACrE,UAAAF,EAAS,UAAU,MAAA,CACtB;AAAA,MACCN,IACC,gBAAAa,EAAC,UAAA,EAAO,MAAK,UAAS,WAAU,aAAY,SAASb,GAClD,UAAAM,EAAS,UAAU,KAAA,CACtB,IACE;AAAA,IAAA,EAAA,CACN;AAAA,EAAA,EAAA,CACF,EAAA,CACF;AAGF,SAAOQ,EAAaH,GAAS,SAAS,IAAI;AAC5C;"}