@cavegiant/cave-world-r3f 1.0.0

package/dist/space/polygon-boundary.js

@@ -0,0 +1,205 @@
+import { jsx as o, jsxs as L } from "react/jsx-runtime";
+import { BvhPhysicsSensor as Y } from "@react-three/viverse";
+import { useFrame as P } from "@react-three/fiber";
+import { useMemo as g, useEffect as _, useRef as f, useState as A, useCallback as x } from "react";
+import { Vector3 as v, MeshBasicMaterial as $, AdditiveBlending as w, DoubleSide as G, ShaderMaterial as k } from "three";
+import { useCaveEventBus as X } from "../core/context/cave-world-context.js";
+import { buildPolygonBoundarySegments as U, findBoundaryContactAnchor as C, projectPlayerOntoSegmentWall as Z, boundaryContactAnchorToPosition as q } from "./utils/polygon-boundary-segments.js";
+import { buildPolygonBoundaryColliderGeometry as O } from "./utils/polygon-boundary-geometry.js";
+import { CAVE_WORLD_LOCAL_PLAYER_FLAG as z } from "./utils/cave-world-player.js";
+const J = 0.08, K = 0.55, Q = 0.2, ee = 0.15, N = 2.6, ne = 0.6, te = /* @__PURE__ */ new $({ visible: !1 }), M = /* @__PURE__ */ new v(), u = /* @__PURE__ */ new v(), S = /* @__PURE__ */ new v(), T = /* @__PURE__ */ new v();
+function re(e, i, t, s) {
+  if (!e.current?.parent) {
+    let l = null;
+    i.traverse((c) => {
+      l || c.userData?.[z] && (l = c);
+    }), e.current = l;
+  }
+  return e.current ? (e.current.getWorldPosition(s), s) : t.getWorldPosition(s);
+}
+function oe() {
+  return new k({
+    vertexShader: `
+      varying vec2 vUv;
+      void main() {
+        vUv = uv;
+        gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+      }
+    `,
+    fragmentShader: `
+      varying vec2 vUv;
+      void main() {
+        float gridScale = 18.0;
+        vec2 gridUv = vUv * gridScale;
+        vec2 grid = abs(fract(gridUv - 0.5) - 0.5) / fwidth(gridUv);
+        float line = min(grid.x, grid.y);
+        float gridLine = 1.0 - min(line, 1.0);
+        float alpha = mix(0.07, 0.2, gridLine);
+        gl_FragColor = vec4(0.52, 0.82, 0.98, alpha);
+      }
+    `,
+    transparent: !0,
+    depthWrite: !1,
+    side: G,
+    blending: w
+  });
+}
+const ie = `
+      varying vec2 vUv;
+      void main() {
+        vUv = uv;
+        gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+      }
+    `, le = `
+      uniform float uTime;
+      varying vec2 vUv;
+
+      void main() {
+        vec2 centered = vUv - 0.5;
+        float radial = length(centered) * 2.0;
+        float falloff = 1.0 - smoothstep(0.35, 1.0, radial);
+
+        float gridScale = 14.0;
+        vec2 gridUv = vUv * gridScale;
+        vec2 grid = abs(fract(gridUv - 0.5) - 0.5) / fwidth(gridUv);
+        float line = min(grid.x, grid.y);
+        float gridLine = 1.0 - min(line, 1.0);
+
+        float pulse = 0.5 + 0.5 * sin(uTime * 8.0);
+        vec3 color = mix(vec3(1.0, 0.58, 0.12), vec3(1.0, 0.16, 0.04), pulse);
+        float alpha = mix(0.25, 0.75, gridLine) * pulse * falloff;
+
+        gl_FragColor = vec4(color, alpha);
+      }
+    `, ae = { uTime: { value: 0 } };
+function se({
+  segment: e,
+  material: i,
+  visible: t
+}) {
+  return t ? /* @__PURE__ */ o(
+    "mesh",
+    {
+      position: e.position,
+      rotation: [0, e.yaw, 0],
+      renderOrder: 10,
+      material: i,
+      children: /* @__PURE__ */ o("planeGeometry", { args: [e.length, e.height] })
+    }
+  ) : null;
+}
+function ye({ boundary: e }) {
+  const i = g(
+    () => U(e.polygon.points, e.polygon.height),
+    [e.polygon.height, e.polygon.points]
+  ), t = g(
+    () => O(i, J),
+    [i]
+  );
+  return _(() => () => t.dispose(), [t]), e.collisionEnabled === !1 || i.length === 0 ? null : /* @__PURE__ */ o("mesh", { geometry: t, children: /* @__PURE__ */ o("meshStandardMaterial", { visible: !1 }) });
+}
+function Se({
+  boundary: e,
+  active: i
+}) {
+  const t = X(), s = f(null), l = f(null), c = f(!1), [b, W] = A(!1), d = f(!1), D = f({ current: null }), a = g(
+    () => U(e.polygon.points, e.polygon.height),
+    [e.polygon.height, e.polygon.points]
+  ), F = g(
+    () => new Map(a.map((n) => [n.index, n])),
+    [a]
+  ), h = g(
+    () => O(a, K, {
+      length: Q,
+      height: ee
+    }),
+    [a]
+  ), [y] = A(oe), E = f(null);
+  _(
+    () => () => {
+      y.dispose(), h.dispose();
+    },
+    [y, h]
+  );
+  const I = x(
+    (n) => {
+      n && !d.current ? (d.current = !0, t.emit("boundary:contact", { boundaryId: e.id, proximity: 1 })) : !n && d.current && (d.current = !1, t.emit("boundary:release", { boundaryId: e.id }));
+    },
+    [e.id, t]
+  ), H = x(
+    (n) => {
+      c.current = n, W(n), I(n), !n && l.current && (l.current.visible = !1, l.current.scale.set(1, 1, 1));
+    },
+    [I]
+  );
+  return _(() => () => {
+    d.current && t.emit("boundary:release", { boundaryId: e.id }), d.current = !1, c.current = !1;
+  }, [e.id, t]), P(({ clock: n }) => {
+    const m = E.current;
+    m && (m.uniforms.uTime.value = n.elapsedTime);
+  }), P(({ scene: n, camera: m, clock: j }) => {
+    const r = l.current;
+    if (!c.current || !s.current || !r) {
+      r && (r.visible = !1, r.scale.set(1, 1, 1));
+      return;
+    }
+    re(D.current, n, m, M), u.copy(M), s.current.worldToLocal(u), S.copy(u), S.y += ne;
+    const R = C(
+      e.polygon.points,
+      e.polygon.height,
+      u,
+      a
+    ) ?? C(
+      e.polygon.points,
+      e.polygon.height,
+      u,
+      a,
+      1 / 0
+    );
+    if (!R) {
+      r.visible = !1;
+      return;
+    }
+    const p = F.get(R.segmentIndex);
+    if (!p) {
+      r.visible = !1;
+      return;
+    }
+    const V = Z(p, S);
+    q(p, V, T), r.position.copy(T), r.rotation.set(0, p.yaw, 0);
+    const B = 0.92 + 0.08 * Math.sin(j.elapsedTime * 8);
+    r.scale.set(B, B, 1), r.visible = !0;
+  }), a.length === 0 || !i ? null : /* @__PURE__ */ L("group", { ref: s, children: [
+    /* @__PURE__ */ o(Y, { onIntersectedChanged: H, children: /* @__PURE__ */ o("mesh", { geometry: h, children: /* @__PURE__ */ o("primitive", { object: te, attach: "material" }) }) }),
+    a.map((n) => /* @__PURE__ */ o(
+      se,
+      {
+        segment: n,
+        material: y,
+        visible: b
+      },
+      `${e.id}-calm-${n.index}`
+    )),
+    /* @__PURE__ */ L("mesh", { ref: l, visible: !1, renderOrder: 11, children: [
+      /* @__PURE__ */ o("planeGeometry", { args: [N, N] }),
+      /* @__PURE__ */ o(
+        "shaderMaterial",
+        {
+          ref: E,
+          uniforms: ae,
+          vertexShader: ie,
+          fragmentShader: le,
+          transparent: !0,
+          depthWrite: !1,
+          side: G,
+          blending: w
+        }
+      )
+    ] })
+  ] });
+}
+export {
+  ye as PolygonBoundaryColliders,
+  Se as PolygonBoundaryFence
+};
+//# sourceMappingURL=polygon-boundary.js.map

package/dist/space/polygon-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-boundary.js","sources":["../../space/polygon-boundary.tsx"],"sourcesContent":["import { BvhPhysicsSensor } from '@react-three/viverse'\nimport { useFrame } from '@react-three/fiber'\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  AdditiveBlending,\n  DoubleSide,\n  MeshBasicMaterial,\n  ShaderMaterial,\n  Vector3 as ThreeVec3,\n  type Camera,\n  type Group,\n  type Mesh,\n  type Object3D,\n  type Scene\n} from 'three'\nimport type { PolygonBoundaryDef } from '../types'\nimport { useCaveEventBus } from '../core'\nimport {\n  boundaryContactAnchorToPosition,\n  buildPolygonBoundarySegments,\n  findBoundaryContactAnchor,\n  projectPlayerOntoSegmentWall,\n  type PolygonBoundarySegment\n} from './utils/polygon-boundary-segments'\nimport { buildPolygonBoundaryColliderGeometry } from './utils/polygon-boundary-geometry'\nimport { CAVE_WORLD_LOCAL_PLAYER_FLAG } from './utils/cave-world-player'\n\nconst COLLIDER_DEPTH = 0.08\nconst SENSOR_DEPTH = 0.55\nconst SENSOR_LENGTH_PADDING = 0.2\nconst SENSOR_HEIGHT_PADDING = 0.15\n/** Warning patch size on the fence plane (m). */\nconst WARNING_BLOB_SIZE = 2.6\n/** Character root is at feet — sample chest height for the Meta-style contact patch. */\nconst PLAYER_WARNING_HEIGHT_OFFSET = 0.6\n\nconst INVISIBLE_MATERIAL = /* @__PURE__ */ new MeshBasicMaterial({ visible: false })\nconst _playerWorld = /* @__PURE__ */ new ThreeVec3()\nconst _playerLocal = /* @__PURE__ */ new ThreeVec3()\nconst _playerSampleLocal = /* @__PURE__ */ new ThreeVec3()\nconst _blobPosition = /* @__PURE__ */ new ThreeVec3()\n\n/**\n * Per-fence cache of the local player object.\n *\n * Deliberately not module-level: two viewers on one page would otherwise share\n * (and fight over) a single cached player. Re-traverses whenever the cached\n * object has been detached from the scene graph.\n */\ninterface LocalPlayerCache {\n  current: Object3D | null\n}\n\nfunction resolvePlayerWorldPosition(\n  cache: LocalPlayerCache,\n  scene: Scene,\n  camera: Camera,\n  target: ThreeVec3\n): ThreeVec3 {\n  if (!cache.current?.parent) {\n    let found: Object3D | null = null\n    scene.traverse((object) => {\n      if (found) return\n      if (object.userData?.[CAVE_WORLD_LOCAL_PLAYER_FLAG]) found = object\n    })\n    cache.current = found\n  }\n\n  if (cache.current) {\n    cache.current.getWorldPosition(target)\n    return target\n  }\n  // No local player (e.g. orbit viewer): the camera is the best stand-in.\n  return camera.getWorldPosition(target)\n}\n\nfunction createCalmFenceMaterial() {\n  return new ShaderMaterial({\n    vertexShader: `\n      varying vec2 vUv;\n      void main() {\n        vUv = uv;\n        gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n      }\n    `,\n    fragmentShader: `\n      varying vec2 vUv;\n      void main() {\n        float gridScale = 18.0;\n        vec2 gridUv = vUv * gridScale;\n        vec2 grid = abs(fract(gridUv - 0.5) - 0.5) / fwidth(gridUv);\n        float line = min(grid.x, grid.y);\n        float gridLine = 1.0 - min(line, 1.0);\n        float alpha = mix(0.07, 0.2, gridLine);\n        gl_FragColor = vec4(0.52, 0.82, 0.98, alpha);\n      }\n    `,\n    transparent: true,\n    depthWrite: false,\n    side: DoubleSide,\n    blending: AdditiveBlending\n  })\n}\n\nconst WARNING_BLOB_VERTEX_SHADER = `\n      varying vec2 vUv;\n      void main() {\n        vUv = uv;\n        gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n      }\n    `\n\nconst WARNING_BLOB_FRAGMENT_SHADER = `\n      uniform float uTime;\n      varying vec2 vUv;\n\n      void main() {\n        vec2 centered = vUv - 0.5;\n        float radial = length(centered) * 2.0;\n        float falloff = 1.0 - smoothstep(0.35, 1.0, radial);\n\n        float gridScale = 14.0;\n        vec2 gridUv = vUv * gridScale;\n        vec2 grid = abs(fract(gridUv - 0.5) - 0.5) / fwidth(gridUv);\n        float line = min(grid.x, grid.y);\n        float gridLine = 1.0 - min(line, 1.0);\n\n        float pulse = 0.5 + 0.5 * sin(uTime * 8.0);\n        vec3 color = mix(vec3(1.0, 0.58, 0.12), vec3(1.0, 0.16, 0.04), pulse);\n        float alpha = mix(0.25, 0.75, gridLine) * pulse * falloff;\n\n        gl_FragColor = vec4(color, alpha);\n      }\n    `\n\n/** Animated uniform for the warning patch; driven per frame through a ref. */\nconst WARNING_BLOB_UNIFORMS = { uTime: { value: 0 } }\n\nfunction PolygonBoundaryCalmSegment({\n  segment,\n  material,\n  visible\n}: {\n  segment: PolygonBoundarySegment\n  material: ShaderMaterial\n  visible: boolean\n}) {\n  if (!visible) return null\n\n  return (\n    <mesh\n      position={segment.position}\n      rotation={[0, segment.yaw, 0]}\n      renderOrder={10}\n      material={material}\n    >\n      <planeGeometry args={[segment.length, segment.height]} />\n    </mesh>\n  )\n}\n\n/** Single merged collider mesh — mount inside `<BvhPhysicsBody>`. */\nexport function PolygonBoundaryColliders({ boundary }: { boundary: PolygonBoundaryDef }) {\n  const segments = useMemo(\n    () => buildPolygonBoundarySegments(boundary.polygon.points, boundary.polygon.height),\n    [boundary.polygon.height, boundary.polygon.points]\n  )\n\n  const geometry = useMemo(\n    () => buildPolygonBoundaryColliderGeometry(segments, COLLIDER_DEPTH),\n    [segments]\n  )\n\n  useEffect(() => () => geometry.dispose(), [geometry])\n\n  if (boundary.collisionEnabled === false || segments.length === 0) return null\n\n  return (\n    <mesh geometry={geometry}>\n      <meshStandardMaterial visible={false} />\n    </mesh>\n  )\n}\n\nexport function PolygonBoundaryFence({\n  boundary,\n  active\n}: {\n  boundary: PolygonBoundaryDef\n  active: boolean\n}) {\n  const eventBus = useCaveEventBus()\n  const localSpaceRef = useRef<Group>(null)\n  const warningBlobRef = useRef<Mesh>(null)\n  const inContactRef = useRef(false)\n\n  const [inContact, setInContact] = useState(false)\n  const contactEmittedRef = useRef(false)\n  const localPlayerCache = useRef<LocalPlayerCache>({ current: null })\n\n  const segments = useMemo(\n    () => buildPolygonBoundarySegments(boundary.polygon.points, boundary.polygon.height),\n    [boundary.polygon.height, boundary.polygon.points]\n  )\n  const segmentByIndex = useMemo(\n    () => new Map(segments.map((segment) => [segment.index, segment])),\n    [segments]\n  )\n\n  const sensorGeometry = useMemo(\n    () =>\n      buildPolygonBoundaryColliderGeometry(segments, SENSOR_DEPTH, {\n        length: SENSOR_LENGTH_PADDING,\n        height: SENSOR_HEIGHT_PADDING\n      }),\n    [segments]\n  )\n\n  // The calm fence material is shared by every segment mesh and never mutated,\n  // so one lazily-created instance is enough. Lazy `useState` (not `useMemo`)\n  // guarantees it is built exactly once — a material must not be swapped while\n  // the fence is on screen.\n  const [calmMaterial] = useState(createCalmFenceMaterial)\n  // The warning patch animates, so it is declared as JSX and driven through a\n  // ref: mutating a hook-owned value each frame is not allowed.\n  const warningMaterialRef = useRef<ShaderMaterial>(null)\n\n  useEffect(\n    () => () => {\n      calmMaterial.dispose()\n      sensorGeometry.dispose()\n    },\n    [calmMaterial, sensorGeometry]\n  )\n\n  const syncBoundaryEvents = useCallback(\n    (touching: boolean) => {\n      if (touching && !contactEmittedRef.current) {\n        contactEmittedRef.current = true\n        eventBus.emit('boundary:contact', { boundaryId: boundary.id, proximity: 1 })\n      } else if (!touching && contactEmittedRef.current) {\n        contactEmittedRef.current = false\n        eventBus.emit('boundary:release', { boundaryId: boundary.id })\n      }\n    },\n    [boundary.id, eventBus]\n  )\n\n  const handleSensorChange = useCallback(\n    (intersected: boolean) => {\n      inContactRef.current = intersected\n      setInContact(intersected)\n      syncBoundaryEvents(intersected)\n      if (!intersected && warningBlobRef.current) {\n        warningBlobRef.current.visible = false\n        warningBlobRef.current.scale.set(1, 1, 1)\n      }\n    },\n    [syncBoundaryEvents]\n  )\n\n  useEffect(() => {\n    return () => {\n      if (contactEmittedRef.current) {\n        eventBus.emit('boundary:release', { boundaryId: boundary.id })\n      }\n      contactEmittedRef.current = false\n      inContactRef.current = false\n    }\n  }, [boundary.id, eventBus])\n\n  useFrame(({ clock }) => {\n    const material = warningMaterialRef.current\n    if (material) material.uniforms.uTime.value = clock.elapsedTime\n  })\n\n  useFrame(({ scene, camera, clock }) => {\n    const blob = warningBlobRef.current\n    if (!inContactRef.current || !localSpaceRef.current || !blob) {\n      if (blob) {\n        blob.visible = false\n        blob.scale.set(1, 1, 1)\n      }\n      return\n    }\n\n    resolvePlayerWorldPosition(localPlayerCache.current, scene, camera, _playerWorld)\n    _playerLocal.copy(_playerWorld)\n    localSpaceRef.current.worldToLocal(_playerLocal)\n    _playerSampleLocal.copy(_playerLocal)\n    _playerSampleLocal.y += PLAYER_WARNING_HEIGHT_OFFSET\n\n    const anchor =\n      findBoundaryContactAnchor(\n        boundary.polygon.points,\n        boundary.polygon.height,\n        _playerLocal,\n        segments\n      ) ??\n      findBoundaryContactAnchor(\n        boundary.polygon.points,\n        boundary.polygon.height,\n        _playerLocal,\n        segments,\n        Infinity\n      )\n\n    if (!anchor) {\n      blob.visible = false\n      return\n    }\n\n    const segment = segmentByIndex.get(anchor.segmentIndex)\n    if (!segment) {\n      blob.visible = false\n      return\n    }\n\n    const projection = projectPlayerOntoSegmentWall(segment, _playerSampleLocal)\n    boundaryContactAnchorToPosition(segment, projection, _blobPosition)\n    blob.position.copy(_blobPosition)\n    blob.rotation.set(0, segment.yaw, 0)\n    const pulseScale = 0.92 + 0.08 * Math.sin(clock.elapsedTime * 8)\n    blob.scale.set(pulseScale, pulseScale, 1)\n    blob.visible = true\n  })\n\n  if (segments.length === 0 || !active) return null\n\n  return (\n    <group ref={localSpaceRef}>\n      <BvhPhysicsSensor onIntersectedChanged={handleSensorChange}>\n        <mesh geometry={sensorGeometry}>\n          <primitive object={INVISIBLE_MATERIAL} attach=\"material\" />\n        </mesh>\n      </BvhPhysicsSensor>\n\n      {segments.map((segment) => (\n        <PolygonBoundaryCalmSegment\n          key={`${boundary.id}-calm-${segment.index}`}\n          segment={segment}\n          material={calmMaterial}\n          visible={inContact}\n        />\n      ))}\n\n      <mesh ref={warningBlobRef} visible={false} renderOrder={11}>\n        <planeGeometry args={[WARNING_BLOB_SIZE, WARNING_BLOB_SIZE]} />\n        <shaderMaterial\n          ref={warningMaterialRef}\n          uniforms={WARNING_BLOB_UNIFORMS}\n          vertexShader={WARNING_BLOB_VERTEX_SHADER}\n          fragmentShader={WARNING_BLOB_FRAGMENT_SHADER}\n          transparent\n          depthWrite={false}\n          side={DoubleSide}\n          blending={AdditiveBlending}\n        />\n      </mesh>\n    </group>\n  )\n}\n"],"names":["COLLIDER_DEPTH","SENSOR_DEPTH","SENSOR_LENGTH_PADDING","SENSOR_HEIGHT_PADDING","WARNING_BLOB_SIZE","PLAYER_WARNING_HEIGHT_OFFSET","INVISIBLE_MATERIAL","MeshBasicMaterial","_playerWorld","ThreeVec3","_playerLocal","_playerSampleLocal","_blobPosition","resolvePlayerWorldPosition","cache","scene","camera","target","found","object","CAVE_WORLD_LOCAL_PLAYER_FLAG","createCalmFenceMaterial","ShaderMaterial","DoubleSide","AdditiveBlending","WARNING_BLOB_VERTEX_SHADER","WARNING_BLOB_FRAGMENT_SHADER","WARNING_BLOB_UNIFORMS","PolygonBoundaryCalmSegment","segment","material","visible","jsx","PolygonBoundaryColliders","boundary","segments","useMemo","buildPolygonBoundarySegments","geometry","buildPolygonBoundaryColliderGeometry","useEffect","PolygonBoundaryFence","active","eventBus","useCaveEventBus","localSpaceRef","useRef","warningBlobRef","inContactRef","inContact","setInContact","useState","contactEmittedRef","localPlayerCache","segmentByIndex","sensorGeometry","calmMaterial","warningMaterialRef","syncBoundaryEvents","useCallback","touching","handleSensorChange","intersected","useFrame","clock","blob","anchor","findBoundaryContactAnchor","projection","projectPlayerOntoSegmentWall","boundaryContactAnchorToPosition","pulseScale","jsxs","BvhPhysicsSensor"],"mappings":";;;;;;;;;AA2BA,MAAMA,IAAiB,MACjBC,IAAe,MACfC,IAAwB,KACxBC,KAAwB,MAExBC,IAAoB,KAEpBC,KAA+B,KAE/BC,KAAqC,oBAAIC,EAAkB,EAAE,SAAS,IAAO,GAC7EC,wBAAmCC,EAAA,GACnCC,wBAAmCD,EAAA,GACnCE,wBAAyCF,EAAA,GACzCG,wBAAoCH,EAAA;AAa1C,SAASI,GACPC,GACAC,GACAC,GACAC,GACW;AACX,MAAI,CAACH,EAAM,SAAS,QAAQ;AAC1B,QAAII,IAAyB;AAC7B,IAAAH,EAAM,SAAS,CAACI,MAAW;AACzB,MAAID,KACAC,EAAO,WAAWC,CAA4B,MAAGF,IAAQC;AAAA,IAC/D,CAAC,GACDL,EAAM,UAAUI;AAAA,EAClB;AAEA,SAAIJ,EAAM,WACRA,EAAM,QAAQ,iBAAiBG,CAAM,GAC9BA,KAGFD,EAAO,iBAAiBC,CAAM;AACvC;AAEA,SAASI,KAA0B;AACjC,SAAO,IAAIC,EAAe;AAAA,IACxB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOd,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAYhB,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,MAAMC;AAAA,IACN,UAAUC;AAAA,EAAA,CACX;AACH;AAEA,MAAMC,KAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAQ7BC,KAA+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAwB/BC,KAAwB,EAAE,OAAO,EAAE,OAAO,IAAE;AAElD,SAASC,GAA2B;AAAA,EAClC,SAAAC;AAAA,EACA,UAAAC;AAAA,EACA,SAAAC;AACF,GAIG;AACD,SAAKA,IAGH,gBAAAC;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,UAAUH,EAAQ;AAAA,MAClB,UAAU,CAAC,GAAGA,EAAQ,KAAK,CAAC;AAAA,MAC5B,aAAa;AAAA,MACb,UAAAC;AAAA,MAEA,UAAA,gBAAAE,EAAC,mBAAc,MAAM,CAACH,EAAQ,QAAQA,EAAQ,MAAM,EAAA,CAAG;AAAA,IAAA;AAAA,EAAA,IATtC;AAYvB;AAGO,SAASI,GAAyB,EAAE,UAAAC,KAA8C;AACvF,QAAMC,IAAWC;AAAA,IACf,MAAMC,EAA6BH,EAAS,QAAQ,QAAQA,EAAS,QAAQ,MAAM;AAAA,IACnF,CAACA,EAAS,QAAQ,QAAQA,EAAS,QAAQ,MAAM;AAAA,EAAA,GAG7CI,IAAWF;AAAA,IACf,MAAMG,EAAqCJ,GAAUnC,CAAc;AAAA,IACnE,CAACmC,CAAQ;AAAA,EAAA;AAKX,SAFAK,EAAU,MAAM,MAAMF,EAAS,WAAW,CAACA,CAAQ,CAAC,GAEhDJ,EAAS,qBAAqB,MAASC,EAAS,WAAW,IAAU,yBAGtE,QAAA,EAAK,UAAAG,GACJ,4BAAC,wBAAA,EAAqB,SAAS,IAAO,EAAA,CACxC;AAEJ;AAEO,SAASG,GAAqB;AAAA,EACnC,UAAAP;AAAA,EACA,QAAAQ;AACF,GAGG;AACD,QAAMC,IAAWC,EAAA,GACXC,IAAgBC,EAAc,IAAI,GAClCC,IAAiBD,EAAa,IAAI,GAClCE,IAAeF,EAAO,EAAK,GAE3B,CAACG,GAAWC,CAAY,IAAIC,EAAS,EAAK,GAC1CC,IAAoBN,EAAO,EAAK,GAChCO,IAAmBP,EAAyB,EAAE,SAAS,MAAM,GAE7DX,IAAWC;AAAA,IACf,MAAMC,EAA6BH,EAAS,QAAQ,QAAQA,EAAS,QAAQ,MAAM;AAAA,IACnF,CAACA,EAAS,QAAQ,QAAQA,EAAS,QAAQ,MAAM;AAAA,EAAA,GAE7CoB,IAAiBlB;AAAA,IACrB,MAAM,IAAI,IAAID,EAAS,IAAI,CAACN,MAAY,CAACA,EAAQ,OAAOA,CAAO,CAAC,CAAC;AAAA,IACjE,CAACM,CAAQ;AAAA,EAAA,GAGLoB,IAAiBnB;AAAA,IACrB,MACEG,EAAqCJ,GAAUlC,GAAc;AAAA,MAC3D,QAAQC;AAAA,MACR,QAAQC;AAAA,IAAA,CACT;AAAA,IACH,CAACgC,CAAQ;AAAA,EAAA,GAOL,CAACqB,CAAY,IAAIL,EAAS9B,EAAuB,GAGjDoC,IAAqBX,EAAuB,IAAI;AAEtD,EAAAN;AAAA,IACE,MAAM,MAAM;AACV,MAAAgB,EAAa,QAAA,GACbD,EAAe,QAAA;AAAA,IACjB;AAAA,IACA,CAACC,GAAcD,CAAc;AAAA,EAAA;AAG/B,QAAMG,IAAqBC;AAAA,IACzB,CAACC,MAAsB;AACrB,MAAIA,KAAY,CAACR,EAAkB,WACjCA,EAAkB,UAAU,IAC5BT,EAAS,KAAK,oBAAoB,EAAE,YAAYT,EAAS,IAAI,WAAW,GAAG,KAClE,CAAC0B,KAAYR,EAAkB,YACxCA,EAAkB,UAAU,IAC5BT,EAAS,KAAK,oBAAoB,EAAE,YAAYT,EAAS,IAAI;AAAA,IAEjE;AAAA,IACA,CAACA,EAAS,IAAIS,CAAQ;AAAA,EAAA,GAGlBkB,IAAqBF;AAAA,IACzB,CAACG,MAAyB;AACxB,MAAAd,EAAa,UAAUc,GACvBZ,EAAaY,CAAW,GACxBJ,EAAmBI,CAAW,GAC1B,CAACA,KAAef,EAAe,YACjCA,EAAe,QAAQ,UAAU,IACjCA,EAAe,QAAQ,MAAM,IAAI,GAAG,GAAG,CAAC;AAAA,IAE5C;AAAA,IACA,CAACW,CAAkB;AAAA,EAAA;AAqErB,SAlEAlB,EAAU,MACD,MAAM;AACX,IAAIY,EAAkB,WACpBT,EAAS,KAAK,oBAAoB,EAAE,YAAYT,EAAS,IAAI,GAE/DkB,EAAkB,UAAU,IAC5BJ,EAAa,UAAU;AAAA,EACzB,GACC,CAACd,EAAS,IAAIS,CAAQ,CAAC,GAE1BoB,EAAS,CAAC,EAAE,OAAAC,QAAY;AACtB,UAAMlC,IAAW2B,EAAmB;AACpC,IAAI3B,MAAUA,EAAS,SAAS,MAAM,QAAQkC,EAAM;AAAA,EACtD,CAAC,GAEDD,EAAS,CAAC,EAAE,OAAAhD,GAAO,QAAAC,GAAQ,OAAAgD,QAAY;AACrC,UAAMC,IAAOlB,EAAe;AAC5B,QAAI,CAACC,EAAa,WAAW,CAACH,EAAc,WAAW,CAACoB,GAAM;AAC5D,MAAIA,MACFA,EAAK,UAAU,IACfA,EAAK,MAAM,IAAI,GAAG,GAAG,CAAC;AAExB;AAAA,IACF;AAEA,IAAApD,GAA2BwC,EAAiB,SAAStC,GAAOC,GAAQR,CAAY,GAChFE,EAAa,KAAKF,CAAY,GAC9BqC,EAAc,QAAQ,aAAanC,CAAY,GAC/CC,EAAmB,KAAKD,CAAY,GACpCC,EAAmB,KAAKN;AAExB,UAAM6D,IACJC;AAAA,MACEjC,EAAS,QAAQ;AAAA,MACjBA,EAAS,QAAQ;AAAA,MACjBxB;AAAA,MACAyB;AAAA,IAAA,KAEFgC;AAAA,MACEjC,EAAS,QAAQ;AAAA,MACjBA,EAAS,QAAQ;AAAA,MACjBxB;AAAA,MACAyB;AAAA,MACA;AAAA,IAAA;AAGJ,QAAI,CAAC+B,GAAQ;AACX,MAAAD,EAAK,UAAU;AACf;AAAA,IACF;AAEA,UAAMpC,IAAUyB,EAAe,IAAIY,EAAO,YAAY;AACtD,QAAI,CAACrC,GAAS;AACZ,MAAAoC,EAAK,UAAU;AACf;AAAA,IACF;AAEA,UAAMG,IAAaC,EAA6BxC,GAASlB,CAAkB;AAC3E,IAAA2D,EAAgCzC,GAASuC,GAAYxD,CAAa,GAClEqD,EAAK,SAAS,KAAKrD,CAAa,GAChCqD,EAAK,SAAS,IAAI,GAAGpC,EAAQ,KAAK,CAAC;AACnC,UAAM0C,IAAa,OAAO,OAAO,KAAK,IAAIP,EAAM,cAAc,CAAC;AAC/D,IAAAC,EAAK,MAAM,IAAIM,GAAYA,GAAY,CAAC,GACxCN,EAAK,UAAU;AAAA,EACjB,CAAC,GAEG9B,EAAS,WAAW,KAAK,CAACO,IAAe,OAG3C,gBAAA8B,EAAC,SAAA,EAAM,KAAK3B,GACV,UAAA;AAAA,IAAA,gBAAAb,EAACyC,GAAA,EAAiB,sBAAsBZ,GACtC,UAAA,gBAAA7B,EAAC,UAAK,UAAUuB,GACd,UAAA,gBAAAvB,EAAC,aAAA,EAAU,QAAQ1B,IAAoB,QAAO,WAAA,CAAW,GAC3D,GACF;AAAA,IAEC6B,EAAS,IAAI,CAACN,MACb,gBAAAG;AAAA,MAACJ;AAAA,MAAA;AAAA,QAEC,SAAAC;AAAA,QACA,UAAU2B;AAAA,QACV,SAASP;AAAA,MAAA;AAAA,MAHJ,GAAGf,EAAS,EAAE,SAASL,EAAQ,KAAK;AAAA,IAAA,CAK5C;AAAA,sBAEA,QAAA,EAAK,KAAKkB,GAAgB,SAAS,IAAO,aAAa,IACtD,UAAA;AAAA,MAAA,gBAAAf,EAAC,iBAAA,EAAc,MAAM,CAAC5B,GAAmBA,CAAiB,GAAG;AAAA,MAC7D,gBAAA4B;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,KAAKyB;AAAA,UACL,UAAU9B;AAAA,UACV,cAAcF;AAAA,UACd,gBAAgBC;AAAA,UAChB,aAAW;AAAA,UACX,YAAY;AAAA,UACZ,MAAMH;AAAA,UACN,UAAUC;AAAA,QAAA;AAAA,MAAA;AAAA,IACZ,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}

package/dist/space/splats/spark/robust-splat-mesh.d.ts

@@ -0,0 +1,59 @@
+import type { ThreeEvent } from '@react-three/fiber';
+import { type SparkSplatMesh } from './splat-mesh.js';
+/** Automatic re-download attempts before a splat failure is treated as terminal. */
+export declare const SPLAT_LOAD_DEFAULT_MAX_RETRIES = 3;
+/**
+ * Watchdog window (ms). A splat that neither finishes decoding nor rejects
+ * within this window is treated as a stalled download and retried. Kept
+ * generous so a slow-but-progressing download on a weak network isn't killed;
+ * genuine failures reject far sooner than this.
+ */
+export declare const SPLAT_LOAD_DEFAULT_TIMEOUT_MS = 30000;
+/** Exponential backoff (ms) between automatic retries, indexed by attempt. */
+export declare const SPLAT_LOAD_RETRY_BACKOFF_MS: readonly [500, 1500, 3000];
+/** Resolve the delay before the next automatic splat re-download. */
+export declare function splatRetryDelayMs(attempt: number): number;
+export interface RobustSplatMeshProps {
+    url: string;
+    visible?: boolean;
+    quaternion?: [number, number, number, number];
+    /** Fired once the splat has decoded and uploaded successfully. */
+    onLoad?: (mesh: SparkSplatMesh) => void | Promise<void>;
+    /** Fired once after all automatic retries are exhausted. */
+    onError?: (error: unknown) => void;
+    onClick?: (event: ThreeEvent<MouseEvent>) => void;
+    onDoubleClick?: (event: ThreeEvent<MouseEvent>) => void;
+    onPointerDown?: (event: ThreeEvent<PointerEvent>) => void;
+    userData?: Record<string, unknown>;
+    /** Space id, for error/telemetry context. */
+    spaceId?: string;
+    /**
+     * Play the spread reveal once after the splat finishes loading. Intended for
+     * the primary entry scene only — preloaded neighbors leave it `false` so
+     * transitions show the scene instantly.
+     */
+    revealOnEnter?: boolean;
+    maxRetries?: number;
+    timeoutMs?: number;
+}
+/**
+ * Production-hardened wrapper around spark's `SplatMesh`.
+ *
+ * spark exposes only `onLoad`: there is no `onError`, and a failed or stalled
+ * download leaves `mesh.initialized` rejected with nothing catching it. Since
+ * readiness gates on `onLoad` (see `CaveBaseLayer`), that would hang the viewer
+ * on an infinite loading screen. This wrapper:
+ *
+ * - attaches to `mesh.initialized` to catch spark's unhandled rejection,
+ * - adds a watchdog timeout for silently-stalled downloads,
+ * - auto-retries a bounded number of times by remounting the underlying mesh
+ *   through a fresh `args` reference,
+ * - emits `space:error` for every failure (with `willRetry`) for telemetry, and
+ * - reports terminal failure through `onError` so a prompt can replace the
+ *   frozen page.
+ *
+ * A user-triggered retry (`retrySpaceLoad()` → `retryToken` bump) resets the
+ * attempt counter and forces a fresh download.
+ */
+export default function RobustSplatMesh({ url, visible, quaternion, onLoad, onError, onClick, onDoubleClick, onPointerDown, userData, spaceId, revealOnEnter, maxRetries, timeoutMs }: RobustSplatMeshProps): import("react").JSX.Element;
+//# sourceMappingURL=robust-splat-mesh.d.ts.map

package/dist/space/splats/spark/robust-splat-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robust-splat-mesh.d.ts","sourceRoot":"","sources":["../../../../space/splats/spark/robust-splat-mesh.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD,OAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAW7D,oFAAoF;AACpF,eAAO,MAAM,8BAA8B,IAAI,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAAS,CAAA;AAEnD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,4BAA6B,CAAA;AAOrE,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,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,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,EACtC,GAAG,EACH,OAAc,EACd,UAA4B,EAC5B,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,EACb,aAAa,EACb,QAAQ,EACR,OAAO,EACP,aAAqB,EACrB,UAA2C,EAC3C,SAAyC,EAC1C,EAAE,oBAAoB,+BAuJtB"}

package/dist/space/splats/spark/robust-splat-mesh.js

@@ -0,0 +1,105 @@
+import { jsx as X } from "react/jsx-runtime";
+import { useRef as a, useState as j, useEffect as P, useCallback as h, useMemo as q } from "react";
+import { useCaveEventBus as H, useCaveWorldStore as Q } from "../../../core/context/cave-world-context.js";
+import { createLogger as W } from "../../../core/logging/logger.js";
+import Y from "./splat-mesh.js";
+import { createSpreadRevealTime as x, applySpreadReveal as G, SPREAD_REVEAL_TIME_SCALE as J, SPREAD_REVEAL_DURATION_SEC as Z, clearSpreadReveal as tt } from "./splat-spread-reveal.js";
+const et = W("space:splat"), rt = 3, nt = 3e4, U = [500, 1500, 3e3], at = 5, ot = [1, 0, 0, 0];
+function ct(e) {
+  return U[e] ?? U.at(-1);
+}
+function pt({
+  url: e,
+  visible: I = !0,
+  quaternion: N = ot,
+  onLoad: R,
+  onError: A,
+  onClick: O,
+  onDoubleClick: b,
+  onPointerDown: w,
+  userData: B,
+  spaceId: u,
+  revealOnEnter: f = !1,
+  maxRetries: _ = rt,
+  timeoutMs: S = nt
+}) {
+  const L = H(), k = Q((t) => t.retryToken), M = a(null), o = `${e}\0${k}`, [d, D] = j({ key: o, attempt: 0 }), c = d.key === o ? d.attempt : 0;
+  d.key !== o && D({ key: o, attempt: 0 });
+  const v = a(R), $ = a(A);
+  P(() => {
+    v.current = R, $.current = A;
+  }, [R, A]);
+  const s = a(!1), E = a(x()), l = a(0), i = a(!1), g = h((t) => {
+    l.current = 0, E.current.value = 0, G(t, E.current), i.current = !0;
+  }, []), C = h(
+    (t) => {
+      s.current || (s.current = !0, f && g(t), v.current?.(t));
+    },
+    [f, g]
+  ), V = q(() => {
+    const t = { url: e, onLoad: C };
+    return f && (t.onFrame = ({ mesh: r, deltaTime: m }) => {
+      i.current && (l.current += m, E.current.value = l.current * J, r.updateVersion(), l.current >= Z && (i.current = !1, tt(r), r.onFrame = void 0));
+    }), [t];
+  }, [e, C, f, c, k]);
+  return P(() => {
+    s.current = !1, i.current = !1;
+    let t = !1, r;
+    const m = (n) => {
+      if (t || s.current) return;
+      s.current = !0;
+      const p = c < _;
+      if (L.emit("space:error", { error: n, willRetry: p, spaceId: u, url: e }), et.warn(
+        `Splat load failed (attempt ${c + 1}/${_ + 1})${u ? ` for space ${u}` : ""}:`,
+        n
+      ), !p) {
+        $.current?.(n);
+        return;
+      }
+      const K = ct(c);
+      r = setTimeout(() => {
+        t || D((T) => T.key === o ? { ...T, attempt: T.attempt + 1 } : T);
+      }, K);
+    }, y = setTimeout(() => {
+      m(new Error(`Splat load timed out after ${S}ms: ${e}`));
+    }, S);
+    let z = 0;
+    const F = () => {
+      if (t) return;
+      const n = M.current?.initialized;
+      if (!n || typeof n.then != "function") {
+        z++ < at && queueMicrotask(F);
+        return;
+      }
+      n.then(
+        () => clearTimeout(y),
+        (p) => {
+          clearTimeout(y), m(p);
+        }
+      );
+    };
+    return F(), () => {
+      t = !0, clearTimeout(y), r && clearTimeout(r);
+    };
+  }, [e, o, c, S, _, L, u]), /* @__PURE__ */ X(
+    Y,
+    {
+      ref: M,
+      visible: I,
+      quaternion: N,
+      args: V,
+      onClick: O,
+      onDoubleClick: b,
+      onPointerDown: w,
+      userData: B
+    }
+  );
+}
+export {
+  rt as SPLAT_LOAD_DEFAULT_MAX_RETRIES,
+  nt as SPLAT_LOAD_DEFAULT_TIMEOUT_MS,
+  U as SPLAT_LOAD_RETRY_BACKOFF_MS,
+  pt as default,
+  ct as splatRetryDelayMs
+};
+//# sourceMappingURL=robust-splat-mesh.js.map

package/dist/space/splats/spark/robust-splat-mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robust-splat-mesh.js","sources":["../../../../space/splats/spark/robust-splat-mesh.tsx"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react'\nimport type { ThreeEvent } from '@react-three/fiber'\nimport type { SplatMeshOptions } from '@sparkjsdev/spark'\nimport { createLogger, useCaveEventBus, useCaveWorldStore } from '../../../core'\nimport SplatMesh, { type SparkSplatMesh } from './splat-mesh'\nimport {\n  applySpreadReveal,\n  clearSpreadReveal,\n  createSpreadRevealTime,\n  SPREAD_REVEAL_DURATION_SEC,\n  SPREAD_REVEAL_TIME_SCALE\n} from './splat-spread-reveal'\n\nconst logger = createLogger('space:splat')\n\n/** Automatic re-download attempts before a splat failure is treated as terminal. */\nexport const SPLAT_LOAD_DEFAULT_MAX_RETRIES = 3\n\n/**\n * Watchdog window (ms). A splat that neither finishes decoding nor rejects\n * within this window is treated as a stalled download and retried. Kept\n * generous so a slow-but-progressing download on a weak network isn't killed;\n * genuine failures reject far sooner than this.\n */\nexport const SPLAT_LOAD_DEFAULT_TIMEOUT_MS = 30_000\n\n/** Exponential backoff (ms) between automatic retries, indexed by attempt. */\nexport const SPLAT_LOAD_RETRY_BACKOFF_MS = [500, 1500, 3000] as const\n\n/** Bounded microtask retries while waiting for the mesh ref to be populated. */\nconst MAX_REF_ATTACH_ATTEMPTS = 5\n\nconst INIT_QUATERNION: [number, number, number, number] = [1, 0, 0, 0]\n\n/** Resolve the delay before the next automatic splat re-download. */\nexport function splatRetryDelayMs(attempt: number): number {\n  return SPLAT_LOAD_RETRY_BACKOFF_MS[attempt] ?? SPLAT_LOAD_RETRY_BACKOFF_MS.at(-1)!\n}\n\nexport interface RobustSplatMeshProps {\n  url: string\n  visible?: boolean\n  quaternion?: [number, number, number, number]\n  /** Fired once the splat has decoded and uploaded successfully. */\n  onLoad?: (mesh: SparkSplatMesh) => void | Promise<void>\n  /** Fired once after all automatic retries are exhausted. */\n  onError?: (error: unknown) => void\n  onClick?: (event: ThreeEvent<MouseEvent>) => void\n  onDoubleClick?: (event: ThreeEvent<MouseEvent>) => void\n  onPointerDown?: (event: ThreeEvent<PointerEvent>) => void\n  userData?: Record<string, unknown>\n  /** Space id, for error/telemetry context. */\n  spaceId?: string\n  /**\n   * Play the spread reveal once after the splat finishes loading. Intended for\n   * the primary entry scene only — preloaded neighbors leave it `false` so\n   * transitions show the scene instantly.\n   */\n  revealOnEnter?: boolean\n  maxRetries?: number\n  timeoutMs?: number\n}\n\n/**\n * Production-hardened wrapper around spark's `SplatMesh`.\n *\n * spark exposes only `onLoad`: there is no `onError`, and a failed or stalled\n * download leaves `mesh.initialized` rejected with nothing catching it. Since\n * readiness gates on `onLoad` (see `CaveBaseLayer`), that would hang the viewer\n * on an infinite loading screen. This wrapper:\n *\n * - attaches to `mesh.initialized` to catch spark's unhandled rejection,\n * - adds a watchdog timeout for silently-stalled downloads,\n * - auto-retries a bounded number of times by remounting the underlying mesh\n *   through a fresh `args` reference,\n * - emits `space:error` for every failure (with `willRetry`) for telemetry, and\n * - reports terminal failure through `onError` so a prompt can replace the\n *   frozen page.\n *\n * A user-triggered retry (`retrySpaceLoad()` → `retryToken` bump) resets the\n * attempt counter and forces a fresh download.\n */\nexport default function RobustSplatMesh({\n  url,\n  visible = true,\n  quaternion = INIT_QUATERNION,\n  onLoad,\n  onError,\n  onClick,\n  onDoubleClick,\n  onPointerDown,\n  userData,\n  spaceId,\n  revealOnEnter = false,\n  maxRetries = SPLAT_LOAD_DEFAULT_MAX_RETRIES,\n  timeoutMs = SPLAT_LOAD_DEFAULT_TIMEOUT_MS\n}: RobustSplatMeshProps) {\n  const eventBus = useCaveEventBus()\n  const retryToken = useCaveWorldStore((s) => s.retryToken)\n\n  const meshRef = useRef<SparkSplatMesh | null>(null)\n\n  // Identity of the thing being loaded. Bundling the attempt counter with it in\n  // one state object lets a url/retry change reset `attempt` in the same update\n  // — deriving it during render from a ref would both trip the refs lint rule\n  // and risk building `splatArgs` from a stale attempt (downloading twice).\n  const loadKey = `${url}\\u0000${retryToken}`\n  const [load, setLoad] = useState({ key: loadKey, attempt: 0 })\n  const attempt = load.key === loadKey ? load.attempt : 0\n  if (load.key !== loadKey) {\n    setLoad({ key: loadKey, attempt: 0 })\n  }\n\n  // Keep the latest callbacks in refs so the load/watchdog effect stays keyed\n  // only on identity that should force a re-download.\n  const onLoadRef = useRef(onLoad)\n  const onErrorRef = useRef(onError)\n  useEffect(() => {\n    onLoadRef.current = onLoad\n    onErrorRef.current = onError\n  }, [onLoad, onError])\n\n  const settledRef = useRef(false)\n  const revealTimeRef = useRef(createSpreadRevealTime())\n  const revealElapsedRef = useRef(0)\n  const revealPlayingRef = useRef(false)\n\n  const startSpreadReveal = useCallback((mesh: SparkSplatMesh) => {\n    revealElapsedRef.current = 0\n    revealTimeRef.current.value = 0\n    applySpreadReveal(mesh, revealTimeRef.current)\n    revealPlayingRef.current = true\n  }, [])\n\n  const handleLoad = useCallback(\n    (mesh: SparkSplatMesh) => {\n      if (settledRef.current) return\n      settledRef.current = true\n      if (revealOnEnter) startSpreadReveal(mesh)\n      onLoadRef.current?.(mesh)\n    },\n    [revealOnEnter, startSpreadReveal]\n  )\n\n  // A new array identity remounts the underlying spark mesh, which is how a\n  // retry re-downloads the asset — hence `attempt` / `retryToken` in the deps.\n  const splatArgs = useMemo(() => {\n    const options: SplatMeshOptions = { url, onLoad: handleLoad }\n\n    if (revealOnEnter) {\n      options.onFrame = ({ mesh, deltaTime }) => {\n        if (!revealPlayingRef.current) return\n        revealElapsedRef.current += deltaTime\n        revealTimeRef.current.value = revealElapsedRef.current * SPREAD_REVEAL_TIME_SCALE\n        mesh.updateVersion()\n        if (revealElapsedRef.current >= SPREAD_REVEAL_DURATION_SEC) {\n          revealPlayingRef.current = false\n          clearSpreadReveal(mesh)\n          mesh.onFrame = undefined\n        }\n      }\n    }\n\n    return [options] as [SplatMeshOptions]\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- remount key\n  }, [url, handleLoad, revealOnEnter, attempt, retryToken])\n\n  useEffect(() => {\n    settledRef.current = false\n    revealPlayingRef.current = false\n\n    let cancelled = false\n    let retryTimer: ReturnType<typeof setTimeout> | undefined\n\n    const fail = (error: unknown) => {\n      if (cancelled || settledRef.current) return\n      settledRef.current = true\n\n      const willRetry = attempt < maxRetries\n      eventBus.emit('space:error', { error, willRetry, spaceId, url })\n      logger.warn(\n        `Splat load failed (attempt ${attempt + 1}/${maxRetries + 1})` +\n          `${spaceId ? ` for space ${spaceId}` : ''}:`,\n        error\n      )\n\n      if (!willRetry) {\n        onErrorRef.current?.(error)\n        return\n      }\n      const backoff = splatRetryDelayMs(attempt)\n      retryTimer = setTimeout(() => {\n        if (cancelled) return\n        setLoad((prev) => (prev.key === loadKey ? { ...prev, attempt: prev.attempt + 1 } : prev))\n      }, backoff)\n    }\n\n    // Watchdog for silently-stalled downloads.\n    const timer = setTimeout(() => {\n      fail(new Error(`Splat load timed out after ${timeoutMs}ms: ${url}`))\n    }, timeoutMs)\n\n    // Catch spark's (otherwise unhandled) rejection and clear the watchdog on\n    // success. The mesh ref is populated during commit, before this passive\n    // effect, so read it directly; a bounded microtask fallback covers the rare\n    // case where it isn't ready yet. Avoid requestAnimationFrame — it is paused\n    // in background tabs, which would delay detection to the watchdog.\n    let attachAttempts = 0\n    const attach = () => {\n      if (cancelled) return\n      const initialized = (meshRef.current as unknown as { initialized?: Promise<unknown> } | null)\n        ?.initialized\n\n      if (!initialized || typeof initialized.then !== 'function') {\n        if (attachAttempts++ < MAX_REF_ATTACH_ATTEMPTS) queueMicrotask(attach)\n        return\n      }\n\n      initialized.then(\n        () => clearTimeout(timer),\n        (error: unknown) => {\n          clearTimeout(timer)\n          fail(error)\n        }\n      )\n    }\n    attach()\n\n    return () => {\n      cancelled = true\n      clearTimeout(timer)\n      if (retryTimer) clearTimeout(retryTimer)\n    }\n  }, [url, loadKey, attempt, timeoutMs, maxRetries, eventBus, spaceId])\n\n  return (\n    <SplatMesh\n      ref={meshRef}\n      visible={visible}\n      quaternion={quaternion}\n      args={splatArgs}\n      onClick={onClick}\n      onDoubleClick={onDoubleClick}\n      onPointerDown={onPointerDown}\n      userData={userData}\n    />\n  )\n}\n"],"names":["logger","createLogger","SPLAT_LOAD_DEFAULT_MAX_RETRIES","SPLAT_LOAD_DEFAULT_TIMEOUT_MS","SPLAT_LOAD_RETRY_BACKOFF_MS","MAX_REF_ATTACH_ATTEMPTS","INIT_QUATERNION","splatRetryDelayMs","attempt","RobustSplatMesh","url","visible","quaternion","onLoad","onError","onClick","onDoubleClick","onPointerDown","userData","spaceId","revealOnEnter","maxRetries","timeoutMs","eventBus","useCaveEventBus","retryToken","useCaveWorldStore","s","meshRef","useRef","loadKey","load","setLoad","useState","onLoadRef","onErrorRef","useEffect","settledRef","revealTimeRef","createSpreadRevealTime","revealElapsedRef","revealPlayingRef","startSpreadReveal","useCallback","mesh","applySpreadReveal","handleLoad","splatArgs","useMemo","options","deltaTime","SPREAD_REVEAL_TIME_SCALE","SPREAD_REVEAL_DURATION_SEC","clearSpreadReveal","cancelled","retryTimer","fail","error","willRetry","backoff","prev","timer","attachAttempts","attach","initialized","jsx","SplatMesh"],"mappings":"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"}

package/dist/space/splats/spark/splat-mesh.d.ts

@@ -0,0 +1,5 @@
+import { SplatMesh as SparkSplatMesh } from '@sparkjsdev/spark';
+declare const SplatMesh: import("react").ExoticComponent<import("@react-three/fiber/dist/declarations/src/core/utils").Mutable<import("@react-three/fiber/dist/declarations/src/core/utils").Overwrite<Partial<import("@react-three/fiber/dist/declarations/src/core/utils").Overwrite<SparkSplatMesh, import("@react-three/fiber").MathProps<SparkSplatMesh> & import("@react-three/fiber").ReactProps<SparkSplatMesh> & Partial<import("@react-three/fiber").EventHandlers>>>, Omit<import("@react-three/fiber").InstanceProps<SparkSplatMesh, typeof SparkSplatMesh>, "object">>>>;
+export default SplatMesh;
+export type { SparkSplatMesh };
+//# sourceMappingURL=splat-mesh.d.ts.map

package/dist/space/splats/spark/splat-mesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splat-mesh.d.ts","sourceRoot":"","sources":["../../../../space/splats/spark/splat-mesh.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAE/D,QAAA,MAAM,SAAS,8hBAAyB,CAAA;AAExC,eAAe,SAAS,CAAA;AACxB,YAAY,EAAE,cAAc,EAAE,CAAA"}

package/dist/space/splats/spark/splat-mesh.js

@@ -0,0 +1,7 @@
+import { extend as t } from "@react-three/fiber";
+import { SplatMesh as e } from "@sparkjsdev/spark";
+const p = t(e);
+export {
+  p as default
+};
+//# sourceMappingURL=splat-mesh.js.map

package/dist/space/splats/spark/splat-mesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splat-mesh.js","sources":["../../../../space/splats/spark/splat-mesh.tsx"],"sourcesContent":["import { extend } from '@react-three/fiber'\nimport { SplatMesh as SparkSplatMesh } from '@sparkjsdev/spark'\n\nconst SplatMesh = extend(SparkSplatMesh)\n\nexport default SplatMesh\nexport type { SparkSplatMesh }\n"],"names":["SplatMesh","extend","SparkSplatMesh"],"mappings":";;AAGA,MAAMA,IAAYC,EAAOC,CAAc;"}

package/dist/space/splats/spark/splat-spread-reveal.d.ts

@@ -0,0 +1,14 @@
+import { dyno } from '@sparkjsdev/spark';
+import type { SparkSplatMesh } from './splat-mesh.js';
+type SpreadRevealTime = ReturnType<typeof dyno.dynoFloat>;
+/** Wall-clock seconds before the spread reveal modifier is removed. */
+export declare const SPREAD_REVEAL_DURATION_SEC = 6;
+/** Shader time multiplier so the visual completes within {@link SPREAD_REVEAL_DURATION_SEC}. */
+export declare const SPREAD_REVEAL_TIME_SCALE = 2;
+/** Default for `CaveExplore.revealOnEnter` / `CaveOrbitViewer.revealOnEnter`. */
+export declare const REVEAL_ON_ENTER_DEFAULT_ENABLED = true;
+export declare function createSpreadRevealTime(): SpreadRevealTime;
+export declare function applySpreadReveal(mesh: SparkSplatMesh, animateT: SpreadRevealTime): void;
+export declare function clearSpreadReveal(mesh: SparkSplatMesh): void;
+export {};
+//# sourceMappingURL=splat-spread-reveal.d.ts.map

package/dist/space/splats/spark/splat-spread-reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splat-spread-reveal.d.ts","sourceRoot":"","sources":["../../../../space/splats/spark/splat-spread-reveal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAA;AAEzD,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAE3C,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,OAAO,CAAA;AAEnD,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAiCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAGxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAG5D"}

package/dist/space/splats/spark/splat-spread-reveal.js

@@ -0,0 +1,45 @@
+import { dyno as e } from "@sparkjsdev/spark";
+const r = 6, p = 2, d = !0;
+function i() {
+  return e.dynoFloat(0);
+}
+function n(a) {
+  return e.dynoBlock({ gsplat: e.Gsplat }, { gsplat: e.Gsplat }, ({ gsplat: t }) => (t = new e.Dyno({
+    inTypes: { gsplat: e.Gsplat, t: "float" },
+    outTypes: { gsplat: e.Gsplat },
+    statements: ({ inputs: l, outputs: o }) => e.unindentLines(`
+            ${o.gsplat} = ${l.gsplat};
+            float t = ${l.t};
+            vec3 scales = ${l.gsplat}.scales;
+            vec3 localPos = ${l.gsplat}.center;
+            vec4 origRgba = ${l.gsplat}.rgba;
+            float l = length(localPos.xyz);
+
+            // Phase 1: entire scene visible immediately as a uniform point cloud.
+            vec3 pointScale = vec3(0.002);
+
+            // Phase 2: radial wave — splats snap to full scale when the wave reaches them.
+            float expandT = max(0.0, t - 2.0) - l * 0.3;
+            float expanded = step(0.0, expandT);
+
+            ${o.gsplat}.center = localPos;
+            ${o.gsplat}.scales = mix(pointScale, scales, expanded);
+            ${o.gsplat}.rgba = origRgba;
+          `)
+  }).apply({ gsplat: t, t: a }).gsplat, { gsplat: t }));
+}
+function g(a, t) {
+  a.objectModifier = n(t), a.updateGenerator();
+}
+function E(a) {
+  a.objectModifier = void 0, a.updateGenerator();
+}
+export {
+  d as REVEAL_ON_ENTER_DEFAULT_ENABLED,
+  r as SPREAD_REVEAL_DURATION_SEC,
+  p as SPREAD_REVEAL_TIME_SCALE,
+  g as applySpreadReveal,
+  E as clearSpreadReveal,
+  i as createSpreadRevealTime
+};
+//# sourceMappingURL=splat-spread-reveal.js.map

package/dist/space/splats/spark/splat-spread-reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splat-spread-reveal.js","sources":["../../../../space/splats/spark/splat-spread-reveal.ts"],"sourcesContent":["import { dyno, type GsplatModifier } from '@sparkjsdev/spark'\nimport type { SparkSplatMesh } from './splat-mesh'\n\ntype SpreadRevealTime = ReturnType<typeof dyno.dynoFloat>\n\n/** Wall-clock seconds before the spread reveal modifier is removed. */\nexport const SPREAD_REVEAL_DURATION_SEC = 6\n\n/** Shader time multiplier so the visual completes within {@link SPREAD_REVEAL_DURATION_SEC}. */\nexport const SPREAD_REVEAL_TIME_SCALE = 2\n\n/** Default for `CaveExplore.revealOnEnter` / `CaveOrbitViewer.revealOnEnter`. */\nexport const REVEAL_ON_ENTER_DEFAULT_ENABLED = true\n\nexport function createSpreadRevealTime(): SpreadRevealTime {\n  return dyno.dynoFloat(0)\n}\n\nfunction createSpreadModifier(animateT: SpreadRevealTime): GsplatModifier {\n  return dyno.dynoBlock({ gsplat: dyno.Gsplat }, { gsplat: dyno.Gsplat }, ({ gsplat }) => {\n    const d = new dyno.Dyno({\n      inTypes: { gsplat: dyno.Gsplat, t: 'float' },\n      outTypes: { gsplat: dyno.Gsplat },\n      statements: ({ inputs, outputs }) =>\n        dyno.unindentLines(`\n            ${outputs.gsplat} = ${inputs.gsplat};\n            float t = ${inputs.t};\n            vec3 scales = ${inputs.gsplat}.scales;\n            vec3 localPos = ${inputs.gsplat}.center;\n            vec4 origRgba = ${inputs.gsplat}.rgba;\n            float l = length(localPos.xyz);\n\n            // Phase 1: entire scene visible immediately as a uniform point cloud.\n            vec3 pointScale = vec3(0.002);\n\n            // Phase 2: radial wave — splats snap to full scale when the wave reaches them.\n            float expandT = max(0.0, t - 2.0) - l * 0.3;\n            float expanded = step(0.0, expandT);\n\n            ${outputs.gsplat}.center = localPos;\n            ${outputs.gsplat}.scales = mix(pointScale, scales, expanded);\n            ${outputs.gsplat}.rgba = origRgba;\n          `)\n    })\n    gsplat = d.apply({ gsplat, t: animateT }).gsplat\n    return { gsplat }\n  })\n}\n\nexport function applySpreadReveal(mesh: SparkSplatMesh, animateT: SpreadRevealTime): void {\n  mesh.objectModifier = createSpreadModifier(animateT)\n  mesh.updateGenerator()\n}\n\nexport function clearSpreadReveal(mesh: SparkSplatMesh): void {\n  mesh.objectModifier = undefined\n  mesh.updateGenerator()\n}\n"],"names":["SPREAD_REVEAL_DURATION_SEC","SPREAD_REVEAL_TIME_SCALE","REVEAL_ON_ENTER_DEFAULT_ENABLED","createSpreadRevealTime","dyno","createSpreadModifier","animateT","gsplat","inputs","outputs","applySpreadReveal","mesh","clearSpreadReveal"],"mappings":";AAMO,MAAMA,IAA6B,GAG7BC,IAA2B,GAG3BC,IAAkC;AAExC,SAASC,IAA2C;AACzD,SAAOC,EAAK,UAAU,CAAC;AACzB;AAEA,SAASC,EAAqBC,GAA4C;AACxE,SAAOF,EAAK,UAAU,EAAE,QAAQA,EAAK,OAAA,GAAU,EAAE,QAAQA,EAAK,OAAA,GAAU,CAAC,EAAE,QAAAG,SAyBzEA,IAxBU,IAAIH,EAAK,KAAK;AAAA,IACtB,SAAS,EAAE,QAAQA,EAAK,QAAQ,GAAG,QAAA;AAAA,IACnC,UAAU,EAAE,QAAQA,EAAK,OAAA;AAAA,IACzB,YAAY,CAAC,EAAE,QAAAI,GAAQ,SAAAC,EAAA,MACrBL,EAAK,cAAc;AAAA,cACbK,EAAQ,MAAM,MAAMD,EAAO,MAAM;AAAA,wBACvBA,EAAO,CAAC;AAAA,4BACJA,EAAO,MAAM;AAAA,8BACXA,EAAO,MAAM;AAAA,8BACbA,EAAO,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAU7BC,EAAQ,MAAM;AAAA,cACdA,EAAQ,MAAM;AAAA,cACdA,EAAQ,MAAM;AAAA,WACjB;AAAA,EAAA,CACN,EACU,MAAM,EAAE,QAAAF,GAAQ,GAAGD,EAAA,CAAU,EAAE,QACnC,EAAE,QAAAC,EAAA,EACV;AACH;AAEO,SAASG,EAAkBC,GAAsBL,GAAkC;AACxF,EAAAK,EAAK,iBAAiBN,EAAqBC,CAAQ,GACnDK,EAAK,gBAAA;AACP;AAEO,SAASC,EAAkBD,GAA4B;AAC5D,EAAAA,EAAK,iBAAiB,QACtBA,EAAK,gBAAA;AACP;"}

package/dist/space/utils/cave-world-player.d.ts

@@ -0,0 +1,3 @@
+/** userData flag on the local player physics root — read by boundary fence visuals. */
+export declare const CAVE_WORLD_LOCAL_PLAYER_FLAG = "caveWorldLocalPlayer";
+//# sourceMappingURL=cave-world-player.d.ts.map

package/dist/space/utils/cave-world-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-world-player.d.ts","sourceRoot":"","sources":["../../../space/utils/cave-world-player.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,4BAA4B,yBAAyB,CAAA"}

package/dist/space/utils/cave-world-player.js

@@ -0,0 +1,5 @@
+const L = "caveWorldLocalPlayer";
+export {
+  L as CAVE_WORLD_LOCAL_PLAYER_FLAG
+};
+//# sourceMappingURL=cave-world-player.js.map

package/dist/space/utils/cave-world-player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cave-world-player.js","sources":["../../../space/utils/cave-world-player.ts"],"sourcesContent":["/** userData flag on the local player physics root — read by boundary fence visuals. */\nexport const CAVE_WORLD_LOCAL_PLAYER_FLAG = 'caveWorldLocalPlayer'\n"],"names":["CAVE_WORLD_LOCAL_PLAYER_FLAG"],"mappings":"AACO,MAAMA,IAA+B;"}

package/dist/space/utils/configure-canvas.d.ts

@@ -0,0 +1,20 @@
+import type { WebGLRenderer } from 'three';
+/**
+ * Apply the splat-friendly pixel-ratio cap to an R3F renderer.
+ *
+ * Splat blending cost scales with pixel count, so an uncapped
+ * `devicePixelRatio` on a 3x phone display burns frame time for no visible
+ * gain. Call from `<Canvas onCreated>` when composing your own canvas.
+ * @see https://sparkjs.dev/docs/performance/
+ */
+export declare function configureSparkWebGLRenderer(gl: WebGLRenderer): void;
+/**
+ * Make a canvas behave like a game viewport rather than a document.
+ *
+ * - `touch-action: none` — drag/orbit gestures aren't stolen by the browser
+ *   (which would fire `pointercancel` mid-gesture);
+ * - `user-select` / `-webkit-touch-callout` — no long-press text selection or
+ *   iOS callout menu over the scene.
+ */
+export declare function configureCaveCanvasDomElement(canvas: HTMLCanvasElement): void;
+//# sourceMappingURL=configure-canvas.d.ts.map

package/dist/space/utils/configure-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-canvas.d.ts","sourceRoot":"","sources":["../../../space/utils/configure-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAM7E"}

package/dist/space/utils/configure-canvas.js

@@ -0,0 +1,12 @@
+import { getSparkCanvasDpr as t } from "./spark-performance.js";
+function r(e) {
+  e.setPixelRatio(t());
+}
+function n(e) {
+  e.style.touchAction = "none", e.style.userSelect = "none", e.style.setProperty("-webkit-user-select", "none"), e.style.setProperty("-webkit-touch-callout", "none"), e.style.setProperty("-webkit-tap-highlight-color", "transparent");
+}
+export {
+  n as configureCaveCanvasDomElement,
+  r as configureSparkWebGLRenderer
+};
+//# sourceMappingURL=configure-canvas.js.map

package/dist/space/utils/configure-canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure-canvas.js","sources":["../../../space/utils/configure-canvas.ts"],"sourcesContent":["import type { WebGLRenderer } from 'three'\nimport { getSparkCanvasDpr } from './spark-performance'\n\n/**\n * Apply the splat-friendly pixel-ratio cap to an R3F renderer.\n *\n * Splat blending cost scales with pixel count, so an uncapped\n * `devicePixelRatio` on a 3x phone display burns frame time for no visible\n * gain. Call from `<Canvas onCreated>` when composing your own canvas.\n * @see https://sparkjs.dev/docs/performance/\n */\nexport function configureSparkWebGLRenderer(gl: WebGLRenderer): void {\n  gl.setPixelRatio(getSparkCanvasDpr())\n}\n\n/**\n * Make a canvas behave like a game viewport rather than a document.\n *\n * - `touch-action: none` — drag/orbit gestures aren't stolen by the browser\n *   (which would fire `pointercancel` mid-gesture);\n * - `user-select` / `-webkit-touch-callout` — no long-press text selection or\n *   iOS callout menu over the scene.\n */\nexport function configureCaveCanvasDomElement(canvas: HTMLCanvasElement): void {\n  canvas.style.touchAction = 'none'\n  canvas.style.userSelect = 'none'\n  canvas.style.setProperty('-webkit-user-select', 'none')\n  canvas.style.setProperty('-webkit-touch-callout', 'none')\n  canvas.style.setProperty('-webkit-tap-highlight-color', 'transparent')\n}\n"],"names":["configureSparkWebGLRenderer","gl","getSparkCanvasDpr","configureCaveCanvasDomElement","canvas"],"mappings":";AAWO,SAASA,EAA4BC,GAAyB;AACnE,EAAAA,EAAG,cAAcC,GAAmB;AACtC;AAUO,SAASC,EAA8BC,GAAiC;AAC7E,EAAAA,EAAO,MAAM,cAAc,QAC3BA,EAAO,MAAM,aAAa,QAC1BA,EAAO,MAAM,YAAY,uBAAuB,MAAM,GACtDA,EAAO,MAAM,YAAY,yBAAyB,MAAM,GACxDA,EAAO,MAAM,YAAY,+BAA+B,aAAa;AACvE;"}

package/dist/space/utils/polygon-boundary-geometry.d.ts

@@ -0,0 +1,8 @@
+import { BufferGeometry } from 'three';
+import type { PolygonBoundarySegment } from './polygon-boundary-segments.js';
+/** Merge segment wall boxes into one static BufferGeometry for a single BVH body. */
+export declare function buildPolygonBoundaryColliderGeometry(segments: PolygonBoundarySegment[], depth: number, padding?: {
+    length?: number;
+    height?: number;
+}): BufferGeometry;
+//# sourceMappingURL=polygon-boundary-geometry.d.ts.map

package/dist/space/utils/polygon-boundary-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-boundary-geometry.d.ts","sourceRoot":"","sources":["../../../space/utils/polygon-boundary-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,cAAc,EAAgC,MAAM,OAAO,CAAA;AAEjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAQzE,qFAAqF;AACrF,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,sBAAsB,EAAE,EAClC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,cAAc,CAsBhB"}