@cavegiant/cave-world-r3f 1.0.0

package/dist/explore/styles/cave-world-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-world-css.js","sources":["../../../explore/styles/cave-world-css.ts"],"sourcesContent":["/**\n * Single source of truth for the default overlay stylesheet.\n *\n * Kept as a TypeScript string rather than a .css import so the SDK stays\n * bundler-agnostic (no ?raw / css-loader requirement), and so the runtime\n * injector and the published dist/styles.css can never drift apart — the Vite\n * build writes that file from this constant.\n */\nexport const CAVE_WORLD_CSS = `/**\n * @cavegiant/cave-world-r3f default UI theme.\n *\n * Every rule is namespaced under '.cw-*' so it cannot collide with host styles,\n * and every visual value is a '--cw-*' custom property so hosts can re-theme the\n * built-in overlays without replacing them.\n *\n * The defaults are declared on ':root' rather than on '.cw-root' on purpose: a\n * declaration on the element itself would shadow anything a host sets on an\n * ancestor, which would make theming silently do nothing.\n *\n * Load it either by importing '@cavegiant/cave-world-r3f/styles.css' or by letting\n * the SDK inject it at runtime (default; see 'injectStyles' on the viewers).\n */\n\n:root {\n  --cw-font-sans:\n    ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,\n    'PingFang SC', 'Microsoft YaHei', sans-serif;\n  --cw-font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n\n  /* Palette — warm gold primary, mint secondary, over cool dark glass. */\n  --cw-color-text: #f5efe6;\n  --cw-color-text-bright: #fffaf0;\n  --cw-color-text-muted: rgb(245 239 230 / 45%);\n  --cw-color-accent: #d4b87a;\n  --cw-color-accent-soft: #e8d4a8;\n  --cw-color-accent-warm: #d2a380;\n  --cw-color-accent-mint: #78c8b0;\n  --cw-color-key-text: #f5e6c0;\n  --cw-color-shortcut: #ffd700;\n\n  --cw-color-surface: rgb(22 24 34 / 82%);\n  --cw-color-surface-solid: rgb(31 28 23 / 95%);\n  --cw-color-scrim: rgb(0 0 0 / 50%);\n  --cw-color-border: rgb(212 184 122 / 22%);\n  --cw-color-border-strong: rgb(212 184 122 / 45%);\n  --cw-color-border-hover: rgb(120 200 176 / 42%);\n  --cw-color-label-surface: rgb(141 134 102 / 75%);\n  --cw-color-label-border: rgb(210 163 128 / 80%);\n  --cw-color-bubble-surface: rgb(0 0 0 / 70%);\n  --cw-color-bubble-border: rgb(255 255 255 / 50%);\n\n  /* Panel HUD decoration. */\n  --cw-panel-fill: linear-gradient(\n    168deg,\n    rgb(32 34 44 / 30%) 0%,\n    rgb(22 24 34 / 34%) 50%,\n    rgb(14 16 24 / 38%) 100%\n  );\n  --cw-panel-rim: conic-gradient(\n    from 135deg at 50% 50%,\n    rgb(212 184 122 / 52%) 0deg,\n    rgb(120 200 180 / 26%) 90deg,\n    rgb(212 184 122 / 46%) 200deg,\n    rgb(120 200 180 / 16%) 300deg,\n    rgb(212 184 122 / 52%) 360deg\n  );\n  /* Chamfered HUD silhouette. */\n  --cw-panel-clip: polygon(\n    12px 0,\n    calc(100% - 12px) 0,\n    100% 12px,\n    100% calc(100% - 12px),\n    calc(100% - 12px) 100%,\n    12px 100%,\n    0 calc(100% - 12px),\n    0 12px\n  );\n  --cw-panel-grain: url(\"data:image/svg+xml,%3Csvg viewBox='0 0 160 160' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='2' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)' opacity='0.4'/%3E%3C/svg%3E\");\n\n  --cw-radius-sm: 4px;\n  --cw-radius-md: 8px;\n  --cw-radius-lg: 16px;\n  --cw-radius-pill: 999px;\n\n  --cw-blur: 12px;\n  --cw-blur-sm: 4px;\n  --cw-shadow-panel:\n    0 8px 28px rgb(0 0 0 / 18%), 0 0 1px rgb(212 184 122 / 30%),\n    inset 0 1px 0 rgb(255 248 230 / 14%), inset 0 -1px 0 rgb(0 0 0 / 12%);\n  --cw-shadow-dialog: 0 12px 36px rgb(0 0 0 / 45%);\n  --cw-shadow-tag: 0 2px 12px rgb(0 0 0 / 25%);\n  --cw-text-shadow: 0 1px 6px rgb(0 0 0 / 80%);\n\n  --cw-z-bubble: 4;\n  --cw-z-panel: 5;\n  --cw-z-detail: 6;\n  --cw-z-helper: 7;\n  --cw-z-error: 2147483000;\n}\n\n/* ── Primitives ──────────────────────────────────────────────────────────── */\n\n/*\n * '.cw-overlay-root' must stay layout-neutral: it is also applied to drei\n * 'Html' wrappers, which drei positions with inline styles. A width/height here\n * would stretch that wrapper to the canvas size and throw its\n * 'translate(-50%, -50%)' anchoring half a viewport off.\n */\n.cw-root,\n.cw-overlay-root {\n  font-family: var(--cw-font-sans);\n  color: var(--cw-color-text);\n}\n\n.cw-root {\n  position: relative;\n  width: 100%;\n  height: 100%;\n}\n\n.cw-surface {\n  background: var(--cw-color-surface);\n  border: 1px solid var(--cw-color-border);\n  border-radius: var(--cw-radius-md);\n  box-shadow: var(--cw-shadow-panel);\n  backdrop-filter: blur(var(--cw-blur));\n  -webkit-backdrop-filter: blur(var(--cw-blur));\n}\n\n.cw-key {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  min-width: 1.75rem;\n  height: 1.75rem;\n  padding: 0 0.375rem;\n  font-family: var(--cw-font-mono);\n  font-size: 0.6875rem;\n  font-weight: 700;\n  font-variant-numeric: tabular-nums;\n  color: var(--cw-color-key-text);\n  background: rgb(28 26 22 / 32%);\n  border: 1px solid rgb(212 184 122 / 32%);\n  border-radius: var(--cw-radius-sm);\n  box-shadow:\n    0 1px 0 rgb(0 0 0 / 30%),\n    inset 0 1px 0 rgb(255 248 230 / 12%);\n  backdrop-filter: blur(var(--cw-blur-sm));\n  -webkit-backdrop-filter: blur(var(--cw-blur-sm));\n}\n\n.cw-button {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  gap: 0.375rem;\n  min-height: 2.5rem;\n  padding: 0 1rem;\n  font: inherit;\n  font-size: 0.8125rem;\n  font-weight: 500;\n  color: rgb(255 255 255 / 80%);\n  cursor: pointer;\n  background: none;\n  border: 1px solid rgb(255 255 255 / 25%);\n  border-radius: var(--cw-radius-pill);\n  transition:\n    background-color 150ms ease,\n    border-color 150ms ease,\n    transform 100ms ease;\n}\n\n.cw-button:hover:not(:disabled) {\n  border-color: rgb(255 255 255 / 45%);\n}\n\n.cw-button:active:not(:disabled) {\n  transform: scale(0.95);\n}\n\n.cw-button:disabled {\n  cursor: not-allowed;\n  opacity: 0.55;\n}\n\n.cw-button--primary {\n  font-weight: 500;\n  color: #2a1c10;\n  background: var(--cw-color-accent-warm);\n  border-color: transparent;\n}\n\n.cw-button--primary:hover:not(:disabled) {\n  background: color-mix(in srgb, var(--cw-color-accent-warm) 88%, white);\n  border-color: transparent;\n}\n\n.cw-icon-button {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  width: 1.75rem;\n  height: 1.75rem;\n  padding: 0;\n  color: rgb(255 255 255 / 70%);\n  cursor: pointer;\n  background: none;\n  border: 0;\n  border-radius: var(--cw-radius-sm);\n}\n\n.cw-icon-button:hover {\n  color: var(--cw-color-text-bright);\n  background: rgb(255 255 255 / 8%);\n}\n\n.cw-spinner {\n  display: inline-block;\n  flex-shrink: 0;\n  width: 0.875rem;\n  height: 0.875rem;\n  border: 2px solid rgb(255 255 255 / 25%);\n  border-top-color: rgb(255 255 255 / 90%);\n  border-radius: 50%;\n  animation: cw-spin 0.8s linear infinite;\n}\n\n@keyframes cw-spin {\n  to {\n    transform: rotate(360deg);\n  }\n}\n\n@keyframes cw-fade-in {\n  from {\n    opacity: 0;\n  }\n}\n\n@keyframes cw-rise-in {\n  from {\n    opacity: 0;\n    transform: translateY(4px);\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .cw-spinner {\n    animation-duration: 2s;\n  }\n\n  .cw-panel,\n  .cw-panel__row {\n    animation: none;\n  }\n}\n\n/* ── Action bubble (3D anchored single hint) ──────────────────────────────── */\n\n.cw-bubble-layer {\n  display: flex;\n  gap: 6px;\n  white-space: nowrap;\n  pointer-events: none;\n}\n\n.cw-bubble {\n  padding: 2px 5px;\n  font-size: 12px;\n  color: #fff;\n  background: var(--cw-color-bubble-surface);\n  border: 1px solid var(--cw-color-bubble-border);\n  border-radius: 5px;\n  box-shadow: 0 4px 10px rgb(0 0 0 / 50%);\n}\n\n.cw-bubble__key {\n  margin-right: 0.3em;\n  font-weight: 600;\n  color: var(--cw-color-shortcut);\n}\n\n/* ── Action panel (screen-space destination picker) ───────────────────────── */\n\n.cw-panel-layer {\n  position: absolute;\n  inset: 0;\n  z-index: var(--cw-z-panel);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  padding: 1rem;\n  pointer-events: none;\n}\n\n@media (min-width: 640px) {\n  .cw-panel-layer {\n    padding: 2rem;\n  }\n}\n\n.cw-panel {\n  position: relative;\n  width: 100%;\n  max-width: 17rem;\n  pointer-events: auto;\n  animation: cw-fade-in 200ms ease-out backwards;\n}\n\n/* Iridescent rim, revealed by the 1px inset of the chamfered frame above it. */\n.cw-panel__rim {\n  position: absolute;\n  inset: -1px;\n  background: var(--cw-panel-rim);\n  clip-path: var(--cw-panel-clip);\n  opacity: 0.7;\n}\n\n.cw-panel__frame {\n  position: relative;\n  overflow: hidden;\n  clip-path: var(--cw-panel-clip);\n  backdrop-filter: blur(var(--cw-blur));\n  -webkit-backdrop-filter: blur(var(--cw-blur));\n}\n\n.cw-panel__body {\n  position: relative;\n  padding: 1rem 1rem 0.875rem;\n  background: var(--cw-panel-fill);\n  border: 1px solid var(--cw-color-border);\n  box-shadow: var(--cw-shadow-panel);\n}\n\n.cw-panel__grain {\n  position: absolute;\n  inset: 0;\n  background-image: var(--cw-panel-grain);\n  background-size: 160px 160px;\n  opacity: 0.03;\n  mix-blend-mode: overlay;\n  pointer-events: none;\n}\n\n.cw-panel__hairline {\n  position: absolute;\n  inset-inline: 0;\n  top: 0;\n  height: 1px;\n  background: linear-gradient(\n    90deg,\n    transparent 0%,\n    rgb(120 200 180 / 28%) 18%,\n    rgb(245 220 160 / 70%) 50%,\n    rgb(120 200 180 / 28%) 82%,\n    transparent 100%\n  );\n  pointer-events: none;\n}\n\n/* Crosshair registration marks in each corner. */\n.cw-panel__mark {\n  position: absolute;\n  width: 10px;\n  height: 10px;\n  pointer-events: none;\n}\n\n.cw-panel__mark::before,\n.cw-panel__mark::after {\n  position: absolute;\n  background: rgb(212 184 122 / 70%);\n  content: '';\n}\n\n.cw-panel__mark::before {\n  inset-inline: 0;\n  top: 50%;\n  height: 1px;\n  transform: translateY(-50%);\n}\n\n.cw-panel__mark::after {\n  inset-block: 0;\n  left: 50%;\n  width: 1px;\n  transform: translateX(-50%);\n}\n\n.cw-panel__mark--tl {\n  top: 8px;\n  left: 8px;\n}\n\n.cw-panel__mark--tr {\n  top: 8px;\n  right: 8px;\n}\n\n.cw-panel__mark--bl {\n  bottom: 8px;\n  left: 8px;\n}\n\n.cw-panel__mark--br {\n  right: 8px;\n  bottom: 8px;\n}\n\n.cw-panel__header {\n  position: relative;\n  margin-bottom: 0.75rem;\n  padding-left: 0.125rem;\n}\n\n.cw-panel__eyebrow-row {\n  display: flex;\n  gap: 0.375rem;\n  align-items: center;\n  margin-bottom: 0.25rem;\n}\n\n.cw-panel__dot {\n  width: 4px;\n  height: 4px;\n  background: var(--cw-color-accent-mint);\n  border-radius: 50%;\n  box-shadow: 0 0 5px rgb(120 200 176 / 50%);\n}\n\n.cw-panel__eyebrow {\n  margin: 0;\n  font-size: 0.5625rem;\n  font-weight: 600;\n  letter-spacing: 0.28em;\n  text-transform: uppercase;\n  color: var(--cw-color-accent-soft);\n  text-shadow: 0 1px 4px rgb(0 0 0 / 80%);\n}\n\n.cw-panel__title {\n  margin: 0;\n  font-size: 1.0625rem;\n  font-weight: 600;\n  line-height: 1.2;\n  letter-spacing: -0.01em;\n  color: var(--cw-color-text);\n  text-shadow: 0 1px 8px rgb(0 0 0 / 85%);\n}\n\n.cw-panel__divider {\n  margin-top: 0.625rem;\n  height: 1px;\n  background: linear-gradient(\n    90deg,\n    rgb(212 184 122 / 45%) 0%,\n    rgb(120 200 180 / 22%) 45%,\n    transparent 100%\n  );\n}\n\n.cw-panel__list {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  gap: 0.375rem;\n  margin: 0;\n  padding: 0;\n  list-style: none;\n}\n\n.cw-panel__row {\n  animation: cw-rise-in 200ms ease-out backwards;\n}\n\n.cw-panel__item {\n  position: relative;\n  display: flex;\n  align-items: center;\n  gap: 0.625rem;\n  width: 100%;\n  padding: 0.5rem 0.625rem;\n  overflow: hidden;\n  font: inherit;\n  color: inherit;\n  text-align: left;\n  cursor: pointer;\n  background: rgb(255 255 255 / 2%);\n  border: 1px solid rgb(212 184 122 / 16%);\n  border-radius: var(--cw-radius-sm);\n  box-shadow: inset 0 1px 0 rgb(255 248 230 / 6%);\n  transition:\n    background-color 200ms ease,\n    border-color 200ms ease;\n}\n\n.cw-panel__item:hover:not(:disabled),\n.cw-panel__item:focus-visible:not(:disabled) {\n  background: rgb(120 200 176 / 10%);\n  border-color: var(--cw-color-border-hover);\n  outline: none;\n}\n\n.cw-panel__item:disabled {\n  cursor: not-allowed;\n  background: rgb(255 255 255 / 1%);\n  border-color: rgb(212 184 122 / 10%);\n  opacity: 0.55;\n}\n\n/* Accent bar that wipes in on hover. */\n.cw-panel__item-bar {\n  position: absolute;\n  inset-block: 0.25rem;\n  left: 0;\n  width: 2px;\n  background: linear-gradient(180deg, var(--cw-color-accent-mint) 0%, var(--cw-color-accent) 100%);\n  opacity: 0;\n  transition: opacity 200ms ease;\n  pointer-events: none;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-panel__item-bar,\n.cw-panel__item:focus-visible:not(:disabled) .cw-panel__item-bar {\n  opacity: 1;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-key,\n.cw-panel__item:focus-visible:not(:disabled) .cw-key {\n  border-color: rgb(120 200 176 / 50%);\n}\n\n.cw-panel__item-icon {\n  display: inline-flex;\n  flex-shrink: 0;\n  align-items: center;\n  justify-content: center;\n  width: 1.75rem;\n  height: 1.75rem;\n  color: rgb(212 184 122 / 65%);\n  background: rgb(255 255 255 / 3%);\n  border: 1px solid rgb(212 184 122 / 22%);\n  border-radius: var(--cw-radius-sm);\n  transition:\n    color 200ms ease,\n    border-color 200ms ease;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-panel__item-icon {\n  color: var(--cw-color-accent-mint);\n  border-color: rgb(120 200 176 / 45%);\n}\n\n.cw-panel__item-text {\n  position: relative;\n  flex: 1 1 auto;\n  min-width: 0;\n}\n\n.cw-panel__item-label {\n  display: block;\n  overflow: hidden;\n  font-size: 0.8125rem;\n  font-weight: 600;\n  line-height: 1.35;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n  text-shadow: var(--cw-text-shadow);\n  transition: color 200ms ease;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-panel__item-label {\n  color: var(--cw-color-text-bright);\n}\n\n.cw-panel__item-hint {\n  display: block;\n  margin-top: 0.125rem;\n  font-size: 0.5625rem;\n  font-weight: 500;\n  letter-spacing: 0.14em;\n  text-transform: uppercase;\n  color: rgb(212 184 122 / 55%);\n  text-shadow: 0 1px 4px rgb(0 0 0 / 70%);\n  transition: color 200ms ease;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-panel__item-hint {\n  color: rgb(120 200 176 / 80%);\n}\n\n.cw-panel__item-chevron {\n  display: inline-flex;\n  flex-shrink: 0;\n  color: rgb(212 184 122 / 45%);\n  filter: drop-shadow(0 1px 3px rgb(0 0 0 / 60%));\n  transition:\n    color 200ms ease,\n    transform 200ms ease;\n}\n\n.cw-panel__item:hover:not(:disabled) .cw-panel__item-chevron {\n  color: var(--cw-color-accent-mint);\n  transform: translateX(2px);\n}\n\n.cw-panel__footer {\n  position: relative;\n  display: flex;\n  gap: 0.5rem;\n  align-items: center;\n  margin-top: 0.625rem;\n}\n\n.cw-panel__footer-rule {\n  flex: 1 1 auto;\n  height: 1px;\n  background: linear-gradient(90deg, transparent, rgb(212 184 122 / 30%));\n}\n\n.cw-panel__footer-rule--end {\n  background: linear-gradient(90deg, rgb(120 200 180 / 25%), transparent);\n}\n\n.cw-panel__footer-text {\n  margin: 0;\n  font-size: 0.5625rem;\n  font-weight: 500;\n  letter-spacing: 0.16em;\n  text-transform: uppercase;\n  color: var(--cw-color-text-muted);\n  text-shadow: 0 1px 4px rgb(0 0 0 / 75%);\n}\n\n/* ── Detail window ───────────────────────────────────────────────────────── */\n\n.cw-detail {\n  position: absolute;\n  inset: 0 30% 0 0;\n  z-index: var(--cw-z-detail);\n  display: flex;\n  flex-direction: column;\n  background: var(--cw-color-scrim);\n}\n\n.cw-detail__header {\n  display: flex;\n  gap: 0.5rem;\n  align-items: center;\n  justify-content: space-between;\n  padding: 1.25rem 1.25rem 0;\n  font-size: 1rem;\n  color: #fff;\n}\n\n.cw-detail__body {\n  flex: 1 1 auto;\n  padding: 0.75rem 1.25rem;\n  overflow: hidden;\n}\n\n.cw-detail__grid {\n  display: grid;\n  grid-template-columns: repeat(12, minmax(0, 1fr));\n  gap: 0.5rem;\n  width: 100%;\n  height: 100%;\n  padding: 0.75rem;\n  background: var(--cw-color-scrim);\n  border-radius: var(--cw-radius-md);\n}\n\n.cw-detail__cell {\n  position: relative;\n  overflow: hidden;\n  color: #fff;\n  border: 1px dashed rgb(255 255 255 / 85%);\n  border-radius: var(--cw-radius-sm);\n}\n\n.cw-detail__cell img,\n.cw-detail__cell video,\n.cw-detail__cell iframe {\n  display: block;\n  width: 100%;\n  height: 100%;\n  border: 0;\n  object-fit: cover;\n}\n\n.cw-detail__text {\n  padding: 0.25rem 0.75rem;\n  white-space: pre-wrap;\n}\n\n.cw-detail__counter {\n  align-self: center;\n  margin-bottom: 0.75rem;\n  padding: 0.375rem 1.5rem;\n  font-size: 0.75rem;\n  color: #fff;\n  background: var(--cw-color-scrim);\n  border-radius: var(--cw-radius-pill);\n}\n\n.cw-detail__thumbs {\n  display: flex;\n  gap: 0.75rem;\n  margin: 0 1.25rem;\n  padding-bottom: 0.5rem;\n  overflow-x: auto;\n}\n\n.cw-detail__thumb {\n  display: grid;\n  grid-template-columns: repeat(12, minmax(0, 1fr));\n  gap: 0.5rem;\n  flex: 0 0 auto;\n  width: 13.5rem;\n  height: 7.625rem;\n  padding: 0.75rem;\n  cursor: pointer;\n  background: rgb(0 0 0 / 30%);\n  border: 1px solid transparent;\n  border-radius: var(--cw-radius-md);\n}\n\n.cw-detail__thumb:hover,\n.cw-detail__thumb[aria-current='true'] {\n  background: var(--cw-color-scrim);\n  border-color: rgb(255 255 255 / 85%);\n}\n\n.cw-detail__thumb-cell {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  font-size: 0.75rem;\n  color: rgb(255 255 255 / 50%);\n  border: 1px dashed rgb(255 255 255 / 85%);\n  border-radius: var(--cw-radius-sm);\n}\n\n/* ── Explore helper (onboarding hints) ───────────────────────────────────── */\n\n.cw-helper {\n  position: absolute;\n  inset: 0;\n  z-index: var(--cw-z-helper);\n  background: rgb(0 0 0 / 22%);\n  backdrop-filter: blur(2px);\n  -webkit-backdrop-filter: blur(2px);\n}\n\n.cw-helper__card {\n  position: absolute;\n  right: 0;\n  bottom: 9rem;\n  left: 0;\n  display: flex;\n  justify-content: center;\n}\n\n.cw-helper__inner {\n  display: flex;\n  flex-direction: column;\n  gap: 1.25rem;\n  max-width: 80%;\n  padding: 1.25rem;\n}\n\n.cw-helper__hints {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 1.5rem;\n  justify-content: center;\n}\n\n.cw-helper__hint {\n  display: flex;\n  flex-direction: column;\n  gap: 0.25rem;\n  align-items: center;\n}\n\n.cw-helper__hint-desc {\n  font-size: 0.75rem;\n  color: rgb(245 239 230 / 62%);\n}\n\n.cw-helper__actions {\n  display: flex;\n  justify-content: flex-end;\n}\n\n/* ── Load-error overlay ──────────────────────────────────────────────────── */\n\n.cw-error-layer {\n  position: fixed;\n  inset: 0;\n  z-index: var(--cw-z-error);\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  background: rgb(0 0 0 / 70%);\n  backdrop-filter: blur(var(--cw-blur-sm));\n  -webkit-backdrop-filter: blur(var(--cw-blur-sm));\n}\n\n.cw-error {\n  display: flex;\n  flex-direction: column;\n  gap: 1rem;\n  align-items: center;\n  max-width: 20rem;\n  margin: 0 1.5rem;\n  padding: 1.75rem 1.5rem;\n  text-align: center;\n  background: var(--cw-color-surface-solid);\n  border-radius: var(--cw-radius-lg);\n  box-shadow: var(--cw-shadow-dialog);\n}\n\n.cw-error__badge {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  width: 3rem;\n  height: 3rem;\n  font-size: 1.5rem;\n  color: var(--cw-color-accent-warm);\n  border: 2px solid var(--cw-color-accent-warm);\n  border-radius: 50%;\n}\n\n.cw-error__title {\n  margin: 0;\n  font-size: 1rem;\n  font-weight: 500;\n  color: #fff;\n}\n\n.cw-error__message {\n  margin: 0.25rem 0 0;\n  font-size: 0.75rem;\n  line-height: 1.25rem;\n  color: rgb(255 255 255 / 60%);\n}\n\n.cw-error__actions {\n  display: flex;\n  flex-direction: column;\n  gap: 0.625rem;\n  width: 100%;\n}\n\n.cw-error__actions .cw-button {\n  width: 100%;\n}\n\n/* ── Connector label (3D wayfinding tag) ─────────────────────────────────── */\n\n.cw-label {\n  transition: opacity 150ms ease-out;\n  pointer-events: none;\n}\n\n.cw-label__hit {\n  pointer-events: auto;\n  touch-action: manipulation;\n}\n\n.cw-label__tag {\n  display: flex;\n  align-items: center;\n  gap: 0.375rem;\n  padding: 0.375rem 0.75rem;\n  font-size: 0.75rem;\n  color: #fff;\n  white-space: nowrap;\n  background: var(--cw-color-label-surface);\n  border: 1px solid var(--cw-color-label-border);\n  border-radius: var(--cw-radius-pill);\n  box-shadow: var(--cw-shadow-tag);\n  backdrop-filter: blur(var(--cw-blur-sm));\n  -webkit-backdrop-filter: blur(var(--cw-blur-sm));\n}\n\n.cw-label__tag--compact {\n  justify-content: center;\n  width: 2rem;\n  height: 2rem;\n  padding: 0;\n  border-radius: 50%;\n}\n\n.cw-label__tag--interactive {\n  cursor: pointer;\n}\n\n.cw-label__tag--pending {\n  cursor: not-allowed;\n  opacity: 0.55;\n  filter: saturate(0.5);\n}\n\n.cw-label__text {\n  max-width: 10rem;\n  overflow: hidden;\n  text-overflow: ellipsis;\n}\n\n/* ── Utilities ───────────────────────────────────────────────────────────── */\n\n/*\n * Integrity probe. 'verifyCaveWorldStyles()' measures an offscreen element with\n * this class to tell whether this stylesheet is actually in effect: a host reset\n * that outranks single-class selectors (see the troubleshooting note in the\n * README) silently strips padding and borders from every overlay. Keep the two\n * values in sync with 'inject.ts'.\n */\n.cw-style-probe {\n  position: absolute;\n  top: -9999px;\n  left: -9999px;\n  padding-top: 7px;\n  border-top: 3px solid transparent;\n}\n\n.cw-visually-hidden {\n  position: absolute;\n  width: 1px;\n  height: 1px;\n  margin: -1px;\n  overflow: hidden;\n  clip-path: inset(50%);\n  white-space: nowrap;\n}\n`\n"],"names":["CAVE_WORLD_CSS"],"mappings":"AAQO,MAAMA,IAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;"}

package/dist/explore/styles/inject.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Inject the SDK stylesheet into `<head>` exactly once per document.
+ *
+ * Idempotent by element id, so mounting several viewers (or remounting one)
+ * never duplicates the rules. Safe to call during SSR — it no-ops without a
+ * `document`.
+ */
+export declare function ensureCaveWorldStyles(): void;
+/**
+ * Warn once per page if the default overlay styles are not actually in effect.
+ *
+ * Two host setups produce a silently half-styled UI, and neither raises an
+ * error on its own: the stylesheet never being loaded (`injectStyles={false}`
+ * without the matching `styles.css` import), or host CSS outranking it. The
+ * latter is the nastier one — a reset flattened to beat single-class selectors
+ * (e.g. Tailwind Preflight run through `@csstools/postcss-cascade-layers`, which
+ * rewrites `*` to `*:not(#\\#):not(#\\#)`) wins over every `.cw-*` rule and
+ * strips the overlays' padding, borders and button styling.
+ *
+ * Measures one offscreen element in idle time, so it costs a single style
+ * recalculation outside the mount path.
+ */
+export declare function verifyCaveWorldStyles(): void;
+/**
+ * Ensure the default overlay styles are present and effective.
+ *
+ * @param enabled pass `false` when importing
+ * `@cavegiant/cave-world-r3f/styles.css` yourself (or shipping a full replacement),
+ * so the SDK does not inject a second copy.
+ */
+export declare function useCaveWorldStyles(enabled?: boolean): void;
+//# sourceMappingURL=inject.d.ts.map

package/dist/explore/styles/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../explore/styles/inject.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAS5C;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CA0B5C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,UAAO,GAAG,IAAI,CAKvD"}

package/dist/explore/styles/inject.js

@@ -0,0 +1,40 @@
+import { useEffect as l } from "react";
+import { createLogger as d } from "../../core/logging/logger.js";
+import { scheduleIdle as i } from "../utils/schedule-idle.js";
+import { CAVE_WORLD_CSS as a } from "./cave-world-css.js";
+const t = "cave-world-styles", c = "7px", u = "3px", n = d("styles");
+function f() {
+  if (typeof document > "u" || document.getElementById(t)) return;
+  const e = document.createElement("style");
+  e.id = t, e.textContent = a, document.head.prepend(e);
+}
+let s = !1;
+function p() {
+  if (s || typeof document > "u" || !document.body) return;
+  s = !0;
+  const e = document.createElement("div");
+  e.className = "cw-style-probe", document.body.append(e);
+  const { paddingTop: o, borderTopWidth: r } = getComputedStyle(e);
+  if (e.remove(), !(o === c && r === u)) {
+    if (!document.getElementById(t)) {
+      n.warn(
+        "Default overlay styles are missing. Either drop `injectStyles={false}` or import '@cavegiant/cave-world-r3f/styles.css'."
+      );
+      return;
+    }
+    n.warn(
+      `Default overlay styles are loaded but overridden by host CSS (.cw-style-probe resolved to padding-top ${o}, border-top-width ${r}).`,
+      "A reset that outranks single-class selectors — typically Tailwind Preflight with its cascade layers flattened into `:not(#\\#)` specificity hacks — will strip padding, borders and button styling from the overlays.",
+      "Remove the flattening, or import the stylesheet through your own CSS pipeline and pass `injectStyles={false}`."
+    );
+  }
+}
+function v(e = !0) {
+  l(() => (e && f(), i(p)), [e]);
+}
+export {
+  f as ensureCaveWorldStyles,
+  v as useCaveWorldStyles,
+  p as verifyCaveWorldStyles
+};
+//# sourceMappingURL=inject.js.map

package/dist/explore/styles/inject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.js","sources":["../../../explore/styles/inject.ts"],"sourcesContent":["import { useEffect } from 'react'\nimport { createLogger } from '../../core'\nimport { scheduleIdle } from '../utils/schedule-idle'\nimport { CAVE_WORLD_CSS } from './cave-world-css'\n\nconst STYLE_ELEMENT_ID = 'cave-world-styles'\n\n/** Expected computed values of `.cw-style-probe`; see the rule in the CSS. */\nconst PROBE_PADDING_TOP = '7px'\nconst PROBE_BORDER_TOP_WIDTH = '3px'\n\nconst logger = createLogger('styles')\n\n/**\n * Inject the SDK stylesheet into `<head>` exactly once per document.\n *\n * Idempotent by element id, so mounting several viewers (or remounting one)\n * never duplicates the rules. Safe to call during SSR — it no-ops without a\n * `document`.\n */\nexport function ensureCaveWorldStyles(): void {\n  if (typeof document === 'undefined') return\n  if (document.getElementById(STYLE_ELEMENT_ID)) return\n\n  const style = document.createElement('style')\n  style.id = STYLE_ELEMENT_ID\n  style.textContent = CAVE_WORLD_CSS\n  // Prepend so host stylesheets loaded later win on equal specificity.\n  document.head.prepend(style)\n}\n\nlet verified = false\n\n/**\n * Warn once per page if the default overlay styles are not actually in effect.\n *\n * Two host setups produce a silently half-styled UI, and neither raises an\n * error on its own: the stylesheet never being loaded (`injectStyles={false}`\n * without the matching `styles.css` import), or host CSS outranking it. The\n * latter is the nastier one — a reset flattened to beat single-class selectors\n * (e.g. Tailwind Preflight run through `@csstools/postcss-cascade-layers`, which\n * rewrites `*` to `*:not(#\\\\#):not(#\\\\#)`) wins over every `.cw-*` rule and\n * strips the overlays' padding, borders and button styling.\n *\n * Measures one offscreen element in idle time, so it costs a single style\n * recalculation outside the mount path.\n */\nexport function verifyCaveWorldStyles(): void {\n  if (verified) return\n  if (typeof document === 'undefined' || !document.body) return\n  verified = true\n\n  const probe = document.createElement('div')\n  probe.className = 'cw-style-probe'\n  document.body.append(probe)\n  const { paddingTop, borderTopWidth } = getComputedStyle(probe)\n  probe.remove()\n\n  if (paddingTop === PROBE_PADDING_TOP && borderTopWidth === PROBE_BORDER_TOP_WIDTH) return\n\n  if (!document.getElementById(STYLE_ELEMENT_ID)) {\n    logger.warn(\n      'Default overlay styles are missing. Either drop `injectStyles={false}` or import' +\n        \" '@cavegiant/cave-world-r3f/styles.css'.\"\n    )\n    return\n  }\n\n  logger.warn(\n    `Default overlay styles are loaded but overridden by host CSS (.cw-style-probe resolved to padding-top ${paddingTop}, border-top-width ${borderTopWidth}).`,\n    'A reset that outranks single-class selectors — typically Tailwind Preflight with its cascade layers flattened into `:not(#\\\\#)` specificity hacks — will strip padding, borders and button styling from the overlays.',\n    'Remove the flattening, or import the stylesheet through your own CSS pipeline and pass `injectStyles={false}`.'\n  )\n}\n\n/**\n * Ensure the default overlay styles are present and effective.\n *\n * @param enabled pass `false` when importing\n * `@cavegiant/cave-world-r3f/styles.css` yourself (or shipping a full replacement),\n * so the SDK does not inject a second copy.\n */\nexport function useCaveWorldStyles(enabled = true): void {\n  useEffect(() => {\n    if (enabled) ensureCaveWorldStyles()\n    return scheduleIdle(verifyCaveWorldStyles)\n  }, [enabled])\n}\n"],"names":["STYLE_ELEMENT_ID","PROBE_PADDING_TOP","PROBE_BORDER_TOP_WIDTH","logger","createLogger","ensureCaveWorldStyles","style","CAVE_WORLD_CSS","verified","verifyCaveWorldStyles","probe","paddingTop","borderTopWidth","useCaveWorldStyles","enabled","useEffect","scheduleIdle"],"mappings":";;;;AAKA,MAAMA,IAAmB,qBAGnBC,IAAoB,OACpBC,IAAyB,OAEzBC,IAASC,EAAa,QAAQ;AAS7B,SAASC,IAA8B;AAE5C,MADI,OAAO,WAAa,OACpB,SAAS,eAAeL,CAAgB,EAAG;AAE/C,QAAMM,IAAQ,SAAS,cAAc,OAAO;AAC5C,EAAAA,EAAM,KAAKN,GACXM,EAAM,cAAcC,GAEpB,SAAS,KAAK,QAAQD,CAAK;AAC7B;AAEA,IAAIE,IAAW;AAgBR,SAASC,IAA8B;AAE5C,MADID,KACA,OAAO,WAAa,OAAe,CAAC,SAAS,KAAM;AACvD,EAAAA,IAAW;AAEX,QAAME,IAAQ,SAAS,cAAc,KAAK;AAC1C,EAAAA,EAAM,YAAY,kBAClB,SAAS,KAAK,OAAOA,CAAK;AAC1B,QAAM,EAAE,YAAAC,GAAY,gBAAAC,MAAmB,iBAAiBF,CAAK;AAG7D,MAFAA,EAAM,OAAA,GAEF,EAAAC,MAAeV,KAAqBW,MAAmBV,IAE3D;AAAA,QAAI,CAAC,SAAS,eAAeF,CAAgB,GAAG;AAC9C,MAAAG,EAAO;AAAA,QACL;AAAA,MAAA;AAGF;AAAA,IACF;AAEA,IAAAA,EAAO;AAAA,MACL,yGAAyGQ,CAAU,sBAAsBC,CAAc;AAAA,MACvJ;AAAA,MACA;AAAA,IAAA;AAAA;AAEJ;AASO,SAASC,EAAmBC,IAAU,IAAY;AACvD,EAAAC,EAAU,OACJD,KAAST,EAAA,GACNW,EAAaP,CAAqB,IACxC,CAACK,CAAO,CAAC;AACd;"}

package/dist/explore/utils/schedule-idle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Run low-priority work in browser idle time, falling back to a macrotask
+ * where `requestIdleCallback` is unavailable (Safari < 17).
+ *
+ * Used to push the heavy parts of a neighbor-scene preload (subtree mount,
+ * splat decode/upload, OBJ collider parse) off the critical frame so they don't
+ * burst against player input the moment the primary scene becomes ready.
+ *
+ * @returns a cancel function; safe to call after the task has already run.
+ */
+export declare function scheduleIdle(task: () => void, timeoutMs?: number): () => void;
+//# sourceMappingURL=schedule-idle.d.ts.map

package/dist/explore/utils/schedule-idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-idle.d.ts","sourceRoot":"","sources":["../../../explore/utils/schedule-idle.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,SAAS,SAAO,GAAG,MAAM,IAAI,CAc3E"}

package/dist/explore/utils/schedule-idle.js

@@ -0,0 +1,16 @@
+function d(e, l = 1e3) {
+  if (typeof window > "u")
+    return e(), () => {
+    };
+  const n = window;
+  if (typeof n.requestIdleCallback == "function") {
+    const t = n.requestIdleCallback(e, { timeout: l });
+    return () => n.cancelIdleCallback?.(t);
+  }
+  const o = window.setTimeout(e, 1);
+  return () => window.clearTimeout(o);
+}
+export {
+  d as scheduleIdle
+};
+//# sourceMappingURL=schedule-idle.js.map

package/dist/explore/utils/schedule-idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-idle.js","sources":["../../../explore/utils/schedule-idle.ts"],"sourcesContent":["interface IdleCapableWindow {\n  requestIdleCallback?: (callback: () => void, options?: { timeout?: number }) => number\n  cancelIdleCallback?: (handle: number) => void\n}\n\n/**\n * Run low-priority work in browser idle time, falling back to a macrotask\n * where `requestIdleCallback` is unavailable (Safari < 17).\n *\n * Used to push the heavy parts of a neighbor-scene preload (subtree mount,\n * splat decode/upload, OBJ collider parse) off the critical frame so they don't\n * burst against player input the moment the primary scene becomes ready.\n *\n * @returns a cancel function; safe to call after the task has already run.\n */\nexport function scheduleIdle(task: () => void, timeoutMs = 1000): () => void {\n  if (typeof window === 'undefined') {\n    task()\n    return () => {}\n  }\n\n  const idleWindow = window as unknown as IdleCapableWindow\n  if (typeof idleWindow.requestIdleCallback === 'function') {\n    const handle = idleWindow.requestIdleCallback(task, { timeout: timeoutMs })\n    return () => idleWindow.cancelIdleCallback?.(handle)\n  }\n\n  const handle = window.setTimeout(task, 1)\n  return () => window.clearTimeout(handle)\n}\n"],"names":["scheduleIdle","task","timeoutMs","idleWindow","handle"],"mappings":"AAeO,SAASA,EAAaC,GAAkBC,IAAY,KAAkB;AAC3E,MAAI,OAAO,SAAW;AACpB,WAAAD,EAAA,GACO,MAAM;AAAA,IAAC;AAGhB,QAAME,IAAa;AACnB,MAAI,OAAOA,EAAW,uBAAwB,YAAY;AACxD,UAAMC,IAASD,EAAW,oBAAoBF,GAAM,EAAE,SAASC,GAAW;AAC1E,WAAO,MAAMC,EAAW,qBAAqBC,CAAM;AAAA,EACrD;AAEA,QAAMA,IAAS,OAAO,WAAWH,GAAM,CAAC;AACxC,SAAO,MAAM,OAAO,aAAaG,CAAM;AACzC;"}

package/dist/explore/viewer-shared.d.ts

@@ -0,0 +1,56 @@
+import type { ReactNode } from 'react';
+import type { CaveEventBus, ComponentRegistry, ObjectRegistry, PartialCaveWorldMessages, SpaceLoadError } from '../core/index.js';
+import type { CaveSpace } from '../types/index.js';
+import type { CaveSpaceLoader } from './loaders/cave-loader.js';
+import type { LoadErrorRenderer } from './overlays/space-load-error-overlay.js';
+/**
+ * Props shared by every viewer (`CaveExplore`, `CaveOrbitViewer`).
+ *
+ * Kept in one place so the two entry points can't drift on loading, theming,
+ * extension, or error-handling behavior.
+ */
+export interface CaveViewerBaseProps {
+    /** Scene id handed to `caveSpaceLoader`. */
+    spaceId?: string;
+    /** Custom scene-JSON loader. Defaults to the CaveGiant content API. */
+    caveSpaceLoader?: CaveSpaceLoader;
+    /** Fired when the primary scene's base layer is ready. */
+    onSpaceInitialized?: () => void;
+    /** Reuse a bus to observe SDK events from outside the React tree. */
+    eventBus?: CaveEventBus;
+    /** Pre-populated object renderers; yours override built-ins. */
+    objectRegistry?: ObjectRegistry;
+    /** Pre-populated behavior components; yours override built-ins. */
+    componentRegistry?: ComponentRegistry;
+    /** Partial copy overrides for the built-in overlays. */
+    messages?: PartialCaveWorldMessages;
+    /**
+     * Inject the default stylesheet at runtime. Set `false` if you import
+     * `@cavegiant/cave-world-r3f/styles.css` yourself or fully replace the overlays.
+     * @default true
+     */
+    injectStyles?: boolean;
+    /**
+     * Play the one-shot spread reveal when the primary scene's splat first loads.
+     * Preloaded neighbors and scene transitions never replay it.
+     * @default REVEAL_ON_ENTER_DEFAULT_ENABLED
+     */
+    revealOnEnter?: boolean;
+    /** Replace the built-in detail window. */
+    renderDetailWindow?: () => ReactNode;
+    /**
+     * Called once when a load terminally fails (config JSON or splat, after
+     * automatic retries). Use it to tear down host loading UI, which would
+     * otherwise keep covering the screen.
+     */
+    onLoadError?: (error: SpaceLoadError) => void;
+    /** Back-button handler for the load-error prompt; omitting it hides the button. */
+    onLoadErrorExit?: () => void;
+    /** Replace the built-in load-error prompt. */
+    renderLoadError?: LoadErrorRenderer;
+    /** Extra R3F content rendered inside the scene graph. */
+    children?: ReactNode;
+}
+/** Callback shape for active-scene tracking across cross-scene travel. */
+export type ActiveSpaceChangeHandler = (spaceId: string, space?: CaveSpace) => void;
+//# sourceMappingURL=viewer-shared.d.ts.map

package/dist/explore/viewer-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-shared.d.ts","sourceRoot":"","sources":["../../explore/viewer-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACf,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAA;IAE/B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,gEAAgE;IAChE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,wBAAwB,CAAA;IAEnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,SAAS,CAAA;IAEpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;IAC7C,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,8CAA8C;IAC9C,eAAe,CAAC,EAAE,iBAAiB,CAAA;IAEnC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,0EAA0E;AAC1E,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@cavegiant/cave-world-r3f` — web-based 3D virtual tour SDK.
+ *
+ * This root entry re-exports the APIs most integrations need. For narrower
+ * imports use the sub-paths:
+ *
+ * - `@cavegiant/cave-world-r3f/types`   — scene JSON types only, zero runtime
+ * - `@cavegiant/cave-world-r3f/core`    — event bus, registries, provider, hooks
+ * - `@cavegiant/cave-world-r3f/space`   — scene rendering components (R3F)
+ * - `@cavegiant/cave-world-r3f/explore` — viewers, overlays, character, multiplayer
+ */
+export type { AssetSourceFromType, AudioProps, BaseCollider, BaseLayer, BaseSceneRef, Block, BoundaryDef, BoxBoundaryDef, BoxCollider, CaveSpace, ColliderComponent, Color, ConnectorDef, ConnectorInfo, ConnectorLabelDef, ConnectorTarget, Content, CustomComponentMap, CustomLayer, CustomObject, CustomObjectType, DigitalHuman2DProps, GalleryInfoPointDetail, ImageProps, InfoPointDetail, InfoPointProps, LightProps, LightingSettings, Matrix16, ModelCollider, ModelProps, PanoramaVideoProps, PhysicsSettings, PolygonBoundaryDef, PortalProps, Quaternion, SpaceMetadata, SpawnPoint, SplatLevel, TextProps, Transform, Vector3, VideoProps, WindowComponent } from './types/index.js';
+export { CaveEventBus, CaveWorldError, CaveWorldProvider, ComponentRegistry, DEFAULT_MESSAGES, FALLBACK_LABEL_TEXT, ObjectRegistry, createLogger, formatMessage, isCaveWorldError, messagesEn, messagesZhCN, resolveMessages, setCaveWorldLogLevel, setCaveWorldLogSink, useCaveEvent, useCaveEventBus, useCaveWorld, useCaveWorldMessages, useCaveWorldStore, useCaveWorldStoreApi, useComponentRegistry, useObjectRegistry, type CaveEventHandler, type CaveEventMap, type CaveEventName, type CaveWorldErrorCode, type CaveWorldLogLevel, type CaveWorldMessages, type CaveWorldProviderProps, type CaveWorldServices, type CaveWorldState, type ComponentRegistryEntry, type ConnectorLabelMode, type ConnectorLabelRenderer, type ConnectorLabelRendererProps, type ObjectComponent, type ObjectComponentProps, type ObjectRenderer, type ObjectRendererProps, type PartialCaveWorldMessages, type ResolvedConnectorLabel, type SpaceLoadError } from './core/index.js';
+export { CaveSpace as CaveSpaceRenderer, getSparkCanvasDpr, isMobileDevice, isTouchPrimaryDevice, selectSplatLevel, useTouchPrimaryDevice, useVisibilityFrameloop, CAVE_WORLD_LOCAL_PLAYER_FLAG, type CaveSpaceProps } from './space/index.js';
+export { ActionBubble, ActionPanel, CaveExplore, CaveOrbitViewer, ConnectorLabelBeacon, ConnectorLabelTagShell, DefaultCaveSpaceLoader, DetailWindow, MIXAMO_STYLE_BONE_MAP, SpaceLoadErrorOverlay, assertCaveSpace, createHttpCaveSpaceLoader, createLocalCharacterModelConfig, ensureCaveWorldStyles, useCaveExplore, useCaveExploreStore, type ActionDef, type CaveExploreHandle, type CaveExploreProps, type CaveOrbitViewerProps, type CaveSpaceLoader, type CharacterControlsConfig, type CharacterMovementOptions, type ExploreHelperConfig, type ExploreHelperRenderer, type HttpCaveSpaceLoaderOptions, type LoadErrorRenderProps, type LoadErrorRenderer, type LocalCharacterModelConfig, type LocalCharacterModelProp, type MultiplayerProp, type OrbitCameraConfig, type OrbitControlsConfig, type PortalNavigateHandler, type VRMHumanBoneName } from './explore/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,KAAK,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,aAAa,EACb,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,OAAO,EACP,UAAU,EACV,eAAe,EAChB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,QAAQ,CAAA;AAGf,OAAO,EACL,SAAS,IAAI,iBAAiB,EAC9B,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,cAAc,EACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,+BAA+B,EAC/B,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,78 @@
+import { CaveEventBus as o } from "./core/events/event-bus.js";
+import { ObjectRegistry as t } from "./core/registry/object-registry.js";
+import { ComponentRegistry as p } from "./core/registry/component-registry.js";
+import { CaveWorldProvider as f, useCaveEventBus as m, useCaveWorld as v, useCaveWorldMessages as C, useCaveWorldStore as x, useCaveWorldStoreApi as u, useComponentRegistry as i, useObjectRegistry as d } from "./core/context/cave-world-context.js";
+import { useCaveEvent as n } from "./core/hooks/use-cave-event.js";
+import { createLogger as E, setCaveWorldLogLevel as S, setCaveWorldLogSink as g } from "./core/logging/logger.js";
+import { CaveWorldError as W, isCaveWorldError as _ } from "./core/errors.js";
+import { DEFAULT_MESSAGES as y, formatMessage as M, en as D, zhCN as O, resolveMessages as B } from "./core/i18n/messages.js";
+import { FALLBACK_LABEL_TEXT as T } from "./core/connector-label/types.js";
+import { default as P } from "./space/cave-space.js";
+import { useVisibilityFrameloop as N } from "./space/utils/use-visibility-frameloop.js";
+import { getSparkCanvasDpr as j } from "./space/utils/spark-performance.js";
+import { isMobileDevice as w, selectSplatLevel as G } from "./space/utils/select-splat-level.js";
+import { isTouchPrimaryDevice as Y, useTouchPrimaryDevice as z } from "./space/utils/touch-primary-device.js";
+import { CAVE_WORLD_LOCAL_PLAYER_FLAG as I } from "./space/utils/cave-world-player.js";
+import { default as U } from "./explore/cave-explore.js";
+import { default as q } from "./explore/cave-orbit-viewer.js";
+import { DefaultCaveSpaceLoader as Q, assertCaveSpace as $, createHttpCaveSpaceLoader as ee } from "./explore/loaders/cave-loader.js";
+import { default as oe } from "./explore/overlays/detail-window.js";
+import { default as te } from "./explore/overlays/action-panel.js";
+import { default as pe } from "./explore/overlays/action-bubble.js";
+import { default as fe } from "./explore/overlays/space-load-error-overlay.js";
+import { default as ve } from "./explore/overlays/connector-label-beacon.js";
+import { default as xe } from "./explore/overlays/connector-label-tag-shell.js";
+import { ensureCaveWorldStyles as ie } from "./explore/styles/inject.js";
+import { useCaveExplore as ce, useCaveExploreStore as ne } from "./explore/stores/explore-context.js";
+import { createLocalCharacterModelConfig as Ee } from "./explore/characters/local-character-model.js";
+import { MIXAMO_STYLE_BONE_MAP as ge } from "./explore/characters/mixamo-style-bone-map.js";
+export {
+  pe as ActionBubble,
+  te as ActionPanel,
+  I as CAVE_WORLD_LOCAL_PLAYER_FLAG,
+  o as CaveEventBus,
+  U as CaveExplore,
+  q as CaveOrbitViewer,
+  P as CaveSpaceRenderer,
+  W as CaveWorldError,
+  f as CaveWorldProvider,
+  p as ComponentRegistry,
+  ve as ConnectorLabelBeacon,
+  xe as ConnectorLabelTagShell,
+  y as DEFAULT_MESSAGES,
+  Q as DefaultCaveSpaceLoader,
+  oe as DetailWindow,
+  T as FALLBACK_LABEL_TEXT,
+  ge as MIXAMO_STYLE_BONE_MAP,
+  t as ObjectRegistry,
+  fe as SpaceLoadErrorOverlay,
+  $ as assertCaveSpace,
+  ee as createHttpCaveSpaceLoader,
+  Ee as createLocalCharacterModelConfig,
+  E as createLogger,
+  ie as ensureCaveWorldStyles,
+  M as formatMessage,
+  j as getSparkCanvasDpr,
+  _ as isCaveWorldError,
+  w as isMobileDevice,
+  Y as isTouchPrimaryDevice,
+  D as messagesEn,
+  O as messagesZhCN,
+  B as resolveMessages,
+  G as selectSplatLevel,
+  S as setCaveWorldLogLevel,
+  g as setCaveWorldLogSink,
+  n as useCaveEvent,
+  m as useCaveEventBus,
+  ce as useCaveExplore,
+  ne as useCaveExploreStore,
+  v as useCaveWorld,
+  C as useCaveWorldMessages,
+  x as useCaveWorldStore,
+  u as useCaveWorldStoreApi,
+  i as useComponentRegistry,
+  d as useObjectRegistry,
+  z as useTouchPrimaryDevice,
+  N as useVisibilityFrameloop
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/space/cave-base-layer.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode, type RefObject } from 'react';
+import { type ThreeEvent } from '@react-three/fiber';
+import { type Group, type Object3DEventMap } from 'three';
+import type { CaveSpace } from '../types/index.js';
+export interface CaveBaseLayerProps {
+    space?: CaveSpace;
+    /** Space id, threaded down for splat load-error context. */
+    spaceId?: string;
+    onProcess?: (percent: number) => void;
+    onInitialized?: () => void;
+    onClick?: (event: ThreeEvent<MouseEvent>) => void;
+    onDoubleClick?: (event: ThreeEvent<MouseEvent>) => void;
+    physics?: boolean;
+    /**
+     * When `false` this base layer is preloaded-but-not-current: connector
+     * sensors don't mount (no spurious `connector:enter` from an adjacent scene
+     * occupying the same world coordinates) and physics defaults off.
+     */
+    active?: boolean;
+    /** Connected space configs, for resolving portal label metadata. */
+    connectedSpaces?: Record<string, CaveSpace>;
+    /** Space ids whose base layer finished loading — gates portal travel UI. */
+    readySpaceIds?: Record<string, true>;
+    /** Connector the player is inside; its label hides. */
+    activeConnectorId?: string;
+    /** Mount connector label hosts. @default true */
+    connectorLabels?: boolean;
+    /**
+     * Play the spread reveal once when this base layer's splat first loads.
+     * Only the primary (entry) scene should set this; neighbors reached through
+     * a transition leave it `false` so travel feels instant.
+     */
+    revealOnEnter?: boolean;
+    children?: ReactNode;
+    ref?: RefObject<Group<Object3DEventMap>>;
+}
+/**
+ * The scene's ground truth: the 3DGS/splat or model capture, its colliders,
+ * boundaries, and connector trigger volumes.
+ */
+export default function CaveBaseLayer(props: CaveBaseLayerProps): import("react").JSX.Element | null;
+//# sourceMappingURL=cave-base-layer.d.ts.map

package/dist/space/cave-base-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-base-layer.d.ts","sourceRoot":"","sources":["../../space/cave-base-layer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AACd,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAG/D,OAAO,EAAqB,KAAK,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAG5E,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,UAAU,CAAA;AA2GtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAA;IACjD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,IAAI,CAAA;IACvD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC3C,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACpC,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,GAAG,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;CACzC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,KAAK,EAAE,kBAAkB,sCA6O9D"}

package/dist/space/cave-base-layer.js

@@ -0,0 +1,221 @@
+import { jsxs as C, jsx as t } from "react/jsx-runtime";
+import { useState as N, useMemo as x, useEffect as S, startTransition as j, useRef as m, useCallback as i, Suspense as w } from "react";
+import { useLoader as F } from "@react-three/fiber";
+import { BvhPhysicsBody as b, BvhPhysicsSensor as H } from "@react-three/viverse";
+import { MeshBasicMaterial as J } from "three";
+import { OBJLoader as V } from "three/examples/jsm/loaders/OBJLoader.js";
+import { useCaveEventBus as W, useCaveWorldStore as K } from "../core/context/cave-world-context.js";
+import X from "./connector-label-host.js";
+import { PolygonBoundaryColliders as Y, PolygonBoundaryFence as Z } from "./polygon-boundary.js";
+import ee from "./splats/spark/robust-splat-mesh.js";
+import { toQuaternionRotation as A } from "./utils/rotation-compat.js";
+import { selectSplatLevel as te } from "./utils/select-splat-level.js";
+import { createSplatCollider as re } from "./utils/splat-collider-helper.js";
+const G = [1, 0, 0, 0], oe = 1e5, ne = /* @__PURE__ */ new J({ visible: !1 });
+function se({
+  connector: o,
+  onIntersection: r
+}) {
+  const s = i(
+    (n) => r(o, n),
+    [o, r]
+  );
+  return /* @__PURE__ */ t(H, { onIntersectedChanged: s, children: /* @__PURE__ */ C(
+    "mesh",
+    {
+      position: o.transform.position,
+      rotation: o.transform.rotation,
+      scale: o.transform.scale,
+      children: [
+        /* @__PURE__ */ t("boxGeometry", {}),
+        /* @__PURE__ */ t("meshStandardMaterial", { visible: !1 })
+      ]
+    }
+  ) });
+}
+function le({
+  collider: o,
+  onLoaded: r
+}) {
+  const s = F(V, o.url), n = x(() => {
+    const l = s.clone(!0);
+    return l.traverse((a) => {
+      a.isMesh && (a.material = ne);
+    }), l.rotation.set(-Math.PI / 2, 0, 0), l;
+  }, [s]);
+  return S(() => {
+    r();
+  }, [r]), /* @__PURE__ */ t("primitive", { object: n });
+}
+function ae(o, r) {
+  const s = m(!1), n = m(0), l = m(!1), [a, L] = N(!1), p = r ? o : 0, c = i(() => {
+    l.current || s.current && n.current >= p && (l.current = !0, L(!0));
+  }, [p]), v = i(() => {
+    s.current = !0, c();
+  }, [c]), I = i(() => {
+    n.current += 1, c();
+  }, [c]);
+  return { ready: a, markSceneReady: v, markColliderReady: I };
+}
+function Ie(o) {
+  const {
+    space: r,
+    spaceId: s,
+    active: n = !0,
+    revealOnEnter: l = !1,
+    onInitialized: a,
+    ref: L,
+    connectedSpaces: p = {},
+    readySpaceIds: c = {},
+    activeConnectorId: v,
+    connectorLabels: I = !0
+  } = o, u = o.physics ?? n, [d, O] = N(null), f = W(), E = K((e) => e.setSpaceLoadError), _ = x(
+    () => r?.baseLayer?.colliders?.filter((e) => e.type === "model").length ?? 0,
+    [r?.baseLayer?.colliders]
+  ), { ready: M, markSceneReady: R, markColliderReady: D } = ae(_, u);
+  S(() => {
+    M && j(() => {
+      f.emit("space:initialized", {}), a?.();
+    });
+  }, [M, f, a]), S(() => {
+    if (d)
+      return () => {
+        d.geometry.dispose();
+      };
+  }, [d]);
+  const k = m(() => {
+  }), B = m(!1);
+  S(() => {
+    k.current = (e) => {
+      j(() => {
+        !B.current && !r?.baseLayer?.colliders?.length && (B.current = !0, O(re(e, oe))), R();
+      });
+    };
+  }, [r?.baseLayer?.colliders, R]);
+  const U = i((e) => {
+    k.current(e);
+  }, []), h = x(
+    () => te(r?.baseLayer?.scene),
+    [r?.baseLayer?.scene]
+  )?.url, z = i(
+    (e) => {
+      E({ stage: "splat", url: h, spaceId: s, error: e });
+    },
+    [E, h, s]
+  ), Q = i(
+    (e, y) => {
+      f.emit(y ? "connector:enter" : "connector:leave", { connector: e });
+    },
+    [f]
+  );
+  if (!r?.baseLayer) return null;
+  const { transform: g, scene: $, colliders: P, boundaries: q, connectors: T } = r.baseLayer;
+  return /* @__PURE__ */ C(
+    "group",
+    {
+      name: "base-layer",
+      position: g.position,
+      quaternion: g.rotation,
+      scale: g.scale,
+      ref: L,
+      children: [
+        $?.type === "splat" && h ? /* @__PURE__ */ t(
+          ee,
+          {
+            url: h,
+            visible: n,
+            quaternion: G,
+            spaceId: s,
+            revealOnEnter: l,
+            onLoad: U,
+            onError: n ? z : void 0,
+            onClick: o.onClick,
+            onDoubleClick: o.onDoubleClick
+          }
+        ) : null,
+        P?.map((e) => {
+          if (e.type !== "model" || !e.url) return null;
+          const y = /* @__PURE__ */ t(le, { collider: e, onLoaded: D });
+          return (
+            // Each collider gets its own boundary. `useLoader` suspends, and
+            // without a boundary here the suspension unwinds to the viewer's,
+            // discarding this whole subtree — including the splat mesh, which
+            // spark re-downloads from scratch on every remount. Colliders also
+            // load in parallel this way instead of one per retry.
+            //
+            // The boundary must stay *outside* `BvhPhysicsBody`: it snapshots its
+            // children into the BVH world in a mount effect, so a child that
+            // arrives later is never registered as a collider.
+            /* @__PURE__ */ t(w, { fallback: null, children: u ? /* @__PURE__ */ t(b, { children: y }) : (
+              // Hidden preloads still load collider assets (to satisfy the init
+              // gate) but skip BVH registration.
+              /* @__PURE__ */ t("group", { visible: !1, children: y })
+            ) }, e.id)
+          );
+        }),
+        u ? /* @__PURE__ */ t(b, { children: P?.map(
+          (e) => e.type === "box" ? /* @__PURE__ */ C(
+            "mesh",
+            {
+              position: e.box.position,
+              quaternion: A(e.box.rotation),
+              scale: e.box.scale,
+              children: [
+                /* @__PURE__ */ t("boxGeometry", {}),
+                /* @__PURE__ */ t("meshStandardMaterial", { visible: !1 })
+              ]
+            },
+            e.id
+          ) : null
+        ) }) : null,
+        u ? /* @__PURE__ */ t(b, { children: q?.map((e) => e.type === "box" && e.collisionEnabled !== !1 ? /* @__PURE__ */ C(
+          "mesh",
+          {
+            position: e.box.position,
+            quaternion: A(e.box.rotation),
+            scale: e.box.scale,
+            children: [
+              /* @__PURE__ */ t("boxGeometry", {}),
+              /* @__PURE__ */ t("meshStandardMaterial", { visible: !1 })
+            ]
+          },
+          e.id
+        ) : e.type === "polygon" ? /* @__PURE__ */ t(Y, { boundary: e }, e.id) : null) }) : null,
+        n ? q?.map(
+          (e) => e.type === "polygon" ? /* @__PURE__ */ t(
+            Z,
+            {
+              boundary: e,
+              active: n
+            },
+            `polygon-vis-${e.id}`
+          ) : null
+        ) : null,
+        n ? T?.map((e) => /* @__PURE__ */ t(
+          se,
+          {
+            connector: e,
+            onIntersection: Q
+          },
+          e.id
+        )) : null,
+        n && I ? T?.map((e) => /* @__PURE__ */ t(
+          X,
+          {
+            connector: e,
+            connectedSpaces: p,
+            readySpaceIds: c,
+            activeConnectorId: v
+          },
+          `label-${e.id}`
+        )) : null,
+        u && d ? /* @__PURE__ */ t(b, { children: /* @__PURE__ */ t("group", { children: /* @__PURE__ */ t("primitive", { object: d, quaternion: G }) }) }) : null,
+        o.children ?? null
+      ]
+    }
+  );
+}
+export {
+  Ie as default
+};
+//# sourceMappingURL=cave-base-layer.js.map