@almadar/ui 5.142.0 → 5.143.0

package/dist/lib/drawable/three/index.js

@@ -1,8 +1,8 @@
-import React3, { forwardRef, useRef, useState, useMemo, useEffect, useImperativeHandle, useCallback, createContext, useContext, Component, useReducer } from 'react';
+import React3, { createContext, forwardRef, useRef, useState, useMemo, useEffect, useImperativeHandle, useCallback, useContext, Component, useReducer } from 'react';
 import { EventBusContext, useTraitScopeChain } from '@almadar/ui/providers';
 import { createLogger } from '@almadar/logger';
 import { Canvas, useThree, useFrame } from '@react-three/fiber';
-import * as THREE10 from 'three';
+import * as THREE11 from 'three';
 import { Vector3, QuadraticBezierCurve3, MathUtils, Quaternion } from 'three';
 import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';
 import { Grid, OrbitControls, Billboard, Text, Stars, Sparkles, Html, RoundedBox } from '@react-three/drei';
@@ -507,7 +507,7 @@ function Lighting3D({
       "directionalLightHelper",
       {
         args: [
-          new THREE10.DirectionalLight(directionalColor, directionalIntensity),
+          new THREE11.DirectionalLight(directionalColor, directionalIntensity),
           5
         ]
       }
@@ -564,8 +564,8 @@ function FollowCamera3D({
   offset
 }) {
   const { camera } = useThree();
-  const look = useRef(new THREE10.Vector3(target[0], target[1], target[2]));
-  const goal = useRef(new THREE10.Vector3());
+  const look = useRef(new THREE11.Vector3(target[0], target[1], target[2]));
+  const goal = useRef(new THREE11.Vector3());
   useFrame((_, delta) => {
     const t = Math.min(1, delta * 5);
     goal.current.set(target[0] + offset[0], target[1] + offset[1], target[2] + offset[2]);
@@ -586,7 +586,109 @@ function create3DProjector(opts = {}) {
     toWorld: (pos) => [pos.x * cellSize + offsetX, pos.z ?? 0, pos.y * cellSize + offsetZ]
   };
 }
+var BoneStore = class {
+  constructor() {
+    __publicField(this, "bones", /* @__PURE__ */ new Map());
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+  }
+  register(name, bone) {
+    this.bones.set(name, bone);
+    this.notify();
+    return () => {
+      if (this.bones.get(name) === bone) {
+        this.bones.delete(name);
+        this.notify();
+      }
+    };
+  }
+  get(name) {
+    return this.bones.get(name);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  notify() {
+    for (const l of this.listeners) l();
+  }
+};
+var BoneRegistryContext = createContext(null);
+function isAnimatedGroup(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+var MESH_SEGMENTS_DEFAULT = 24;
+function polyhedronBounds(vertices) {
+  if (!vertices || vertices.length < 3) return null;
+  const min = [Infinity, Infinity, Infinity];
+  const max = [-Infinity, -Infinity, -Infinity];
+  for (const v of vertices) {
+    if (v.length < 3 || !v.every((c) => Number.isFinite(c))) return null;
+    for (let axis = 0; axis < 3; axis++) {
+      min[axis] = Math.min(min[axis], v[axis]);
+      max[axis] = Math.max(max[axis], v[axis]);
+    }
+  }
+  return { min, max };
+}
+function clampSegments(segments) {
+  const s = segments ?? MESH_SEGMENTS_DEFAULT;
+  return Math.min(64, Math.max(3, Math.round(s)));
+}
+function isAnimatedMesh(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+var lerp = (a, b, k) => a + (b - a) * k;
 var NUMERIC_TRACKS = [
+  "offsetX",
+  "offsetY",
+  "offsetZ",
+  "rotateX",
+  "rotateY",
+  "rotateZ",
+  "scale",
+  "opacity",
+  "emissiveIntensity"
+];
+function applyMeshAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
+  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
+  const cycle = timeMs / anim.durationMs;
+  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
+  const trackValue = (key) => {
+    const defined = frames.filter((f) => f[key] !== void 0);
+    if (defined.length === 0) return void 0;
+    let prev;
+    let next;
+    for (const f of defined) {
+      if (f.at <= t) prev = f;
+      else if (!next) next = f;
+    }
+    if (!prev) return defined[0][key];
+    if (!next) return prev[key];
+    const span = next.at - prev.at;
+    const k = span > 0 ? (t - prev.at) / span : 1;
+    const a = prev[key];
+    const b = next[key];
+    if (typeof a === "number" && typeof b === "number") return lerp(a, b, k);
+    return a;
+  };
+  const num = {};
+  for (const key of NUMERIC_TRACKS) {
+    const v = trackValue(key);
+    if (v !== void 0) num[key] = v;
+  }
+  return {
+    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
+    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
+    scale: num.scale ?? 1,
+    opacity: num.opacity,
+    emissiveIntensity: num.emissiveIntensity,
+    color: trackValue("color"),
+    emissive: trackValue("emissive")
+  };
+}
+var NUMERIC_TRACKS2 = [
   "offsetX",
   "offsetY",
   "rotate",
@@ -602,7 +704,7 @@ var NUMERIC_TRACKS = [
 function isAnimatedShape(node) {
   return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
 }
-var lerp = (a, b, k) => a + (b - a) * k;
+var lerp2 = (a, b, k) => a + (b - a) * k;
 function applyShapeAnimation(node, timeMs) {
   const anim = node.animation;
   if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return node;
@@ -625,10 +727,10 @@ function applyShapeAnimation(node, timeMs) {
     const k = span > 0 ? (t - prev.at) / span : 1;
     const a = prev[key];
     const b = next[key];
-    if (typeof a === "number" && typeof b === "number") return lerp(a, b, k);
+    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
     return a;
   };
-  for (const key of NUMERIC_TRACKS) {
+  for (const key of NUMERIC_TRACKS2) {
     const v = trackValue(key);
     if (v !== void 0) out[key] = v;
   }
@@ -649,7 +751,7 @@ function applyShapeAnimation(node, timeMs) {
       if (prevSh?.shadow && nextSh?.shadow) {
         const span = nextSh.at - prevSh.at;
         const k = span > 0 ? (t - prevSh.at) / span : 1;
-        out.shadow = { color: prevSh.shadow.color, blur: lerp(prevSh.shadow.blur, nextSh.shadow.blur, k) };
+        out.shadow = { color: prevSh.shadow.color, blur: lerp2(prevSh.shadow.blur, nextSh.shadow.blur, k) };
       } else {
         out.shadow = sh;
       }
@@ -792,12 +894,12 @@ function ModelLoader({
     if (!loadedModel) return null;
     const cloned = clone(loadedModel);
     cloned.updateMatrixWorld(true);
-    const tintColor = tint ? new THREE10.Color(tint) : null;
+    const tintColor = tint ? new THREE11.Color(tint) : null;
     cloned.traverse((child) => {
-      if (child instanceof THREE10.Mesh) {
+      if (child instanceof THREE11.Mesh) {
         child.castShadow = castShadow;
         child.receiveShadow = receiveShadow;
-        if (tintColor && child.material instanceof THREE10.MeshStandardMaterial) {
+        if (tintColor && child.material instanceof THREE11.MeshStandardMaterial) {
           const mat = child.material.clone();
           mat.color.multiply(tintColor);
           child.material = mat;
@@ -806,7 +908,7 @@ function ModelLoader({
     });
     return cloned;
   }, [loadedModel, castShadow, receiveShadow, tint]);
-  const mixer = useMemo(() => model ? new THREE10.AnimationMixer(model) : null, [model]);
+  const mixer = useMemo(() => model ? new THREE11.AnimationMixer(model) : null, [model]);
   useEffect(() => {
     if (!mixer || !animation || clips.length === 0) return;
     const wanted = animation.toLowerCase();
@@ -823,8 +925,8 @@ function ModelLoader({
   });
   const normFactor = useMemo(() => {
     if (!model) return 1;
-    const box = new THREE10.Box3().setFromObject(model);
-    const size = new THREE10.Vector3();
+    const box = new THREE11.Box3().setFromObject(model);
+    const size = new THREE11.Vector3();
     box.getSize(size);
     const maxDim = Math.max(size.x, size.y, size.z);
     if (!Number.isFinite(maxDim) || maxDim < 0.05) return 1;
@@ -914,7 +1016,7 @@ var warnUnsupported3d = (kind) => {
   warnedUnsupported.add(kind);
   mesh3dLog.warn("unsupported drawable kind on the 3D backend \u2014 skipped", { kind });
 };
-var CrossOriginTextureLoader = class extends THREE10.TextureLoader {
+var CrossOriginTextureLoader = class extends THREE11.TextureLoader {
   constructor() {
     super();
     this.crossOrigin = "anonymous";
@@ -932,7 +1034,7 @@ function useBillboardTexture(url) {
       url,
       (texture) => {
         if (!active) return;
-        texture.colorSpace = THREE10.SRGBColorSpace;
+        texture.colorSpace = THREE11.SRGBColorSpace;
         setState({ texture, error: false });
       },
       void 0,
@@ -985,7 +1087,7 @@ function SpriteBillboard({ node, world, cellSize = 1, groupOpacity = 1 }) {
   }, [texture, frame, node.height, node.width, anchor, cellSize]);
   const groundGeometry = React3.useMemo(() => {
     if (anchor !== "top-left" || !texture || !atlasReady) return null;
-    const g = new THREE10.PlaneGeometry(size.width, size.height);
+    const g = new THREE11.PlaneGeometry(size.width, size.height);
     g.rotateX(-Math.PI / 2);
     return g;
   }, [anchor, texture, atlasReady, size.width, size.height]);
@@ -993,15 +1095,15 @@ function SpriteBillboard({ node, world, cellSize = 1, groupOpacity = 1 }) {
     if (anchor === "top-left") {
       return /* @__PURE__ */ jsx("group", { position: [world[0] + size.width / 2, 0.02, world[2] + size.height / 2], children: /* @__PURE__ */ jsxs("mesh", { rotation: [-Math.PI / 2, 0, 0], children: [
         /* @__PURE__ */ jsx("planeGeometry", { args: [size.width, size.height] }),
-        /* @__PURE__ */ jsx("meshBasicMaterial", { color: textureError ? 16729156 : 8947848, transparent: true, opacity: 0.6, side: THREE10.DoubleSide })
+        /* @__PURE__ */ jsx("meshBasicMaterial", { color: textureError ? 16729156 : 8947848, transparent: true, opacity: 0.6, side: THREE11.DoubleSide })
       ] }) });
     }
     return /* @__PURE__ */ jsx("group", { position: [world[0], world[1] + size.height / 2, world[2]], children: /* @__PURE__ */ jsxs("mesh", { children: [
       /* @__PURE__ */ jsx("planeGeometry", { args: [size.width, size.height] }),
-      /* @__PURE__ */ jsx("meshBasicMaterial", { color: textureError ? 16729156 : 8947848, transparent: true, opacity: 0.6, side: THREE10.DoubleSide })
+      /* @__PURE__ */ jsx("meshBasicMaterial", { color: textureError ? 16729156 : 8947848, transparent: true, opacity: 0.6, side: THREE11.DoubleSide })
     ] }) });
   }
-  texture.magFilter = texture.minFilter = THREE10.NearestFilter;
+  texture.magFilter = texture.minFilter = THREE11.NearestFilter;
   texture.needsUpdate = true;
   if (frame) {
     texture.repeat.set(frame.w / size.imgW, frame.h / size.imgH);
@@ -1014,7 +1116,7 @@ function SpriteBillboard({ node, world, cellSize = 1, groupOpacity = 1 }) {
         map: texture,
         transparent: true,
         alphaTest: 0.1,
-        side: THREE10.DoubleSide,
+        side: THREE11.DoubleSide,
         opacity: (node.opacity ?? 1) * groupOpacity
       }
     ) }) });
@@ -1027,7 +1129,7 @@ function SpriteBillboard({ node, world, cellSize = 1, groupOpacity = 1 }) {
         map: texture,
         transparent: true,
         alphaTest: 0.1,
-        side: THREE10.DoubleSide,
+        side: THREE11.DoubleSide,
         opacity: node.opacity ?? 1
       }
     )
@@ -1096,7 +1198,7 @@ function Shape3D({ node, projector, groupOpacity = 1 }) {
     }
     case "poly": {
       if (!node.points || node.points.length === 0) return null;
-      const s = new THREE10.Shape();
+      const s = new THREE11.Shape();
       node.points.forEach((p, i) => {
         if (i === 0) s.moveTo(p.x, p.y);
         else s.lineTo(p.x, p.y);
@@ -1114,7 +1216,7 @@ function Shape3D({ node, projector, groupOpacity = 1 }) {
   }
   return /* @__PURE__ */ jsx("group", { ref: groupRef, position: [world[0], world[1] + 0.02, world[2]], children: /* @__PURE__ */ jsxs("mesh", { rotation: [-Math.PI / 2, 0, 0], children: [
     geometry,
-    /* @__PURE__ */ jsx("meshBasicMaterial", { ref: materialRef, color, transparent: true, opacity: (node.opacity ?? 1) * groupOpacity, side: THREE10.DoubleSide })
+    /* @__PURE__ */ jsx("meshBasicMaterial", { ref: materialRef, color, transparent: true, opacity: (node.opacity ?? 1) * groupOpacity, side: THREE11.DoubleSide })
   ] }) });
 }
 function Text3D({ node, projector, groupOpacity = 1 }) {
@@ -1135,64 +1237,46 @@ function Text3D({ node, projector, groupOpacity = 1 }) {
     }
   ) });
 }
-var MESH_SEGMENTS_DEFAULT = 24;
-function clampSegments(segments) {
-  const s = segments ?? MESH_SEGMENTS_DEFAULT;
-  return Math.min(64, Math.max(3, Math.round(s)));
-}
-function isAnimatedMesh(node) {
-  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
-}
-var lerp2 = (a, b, k) => a + (b - a) * k;
-var NUMERIC_TRACKS2 = [
-  "offsetX",
-  "offsetY",
-  "offsetZ",
-  "rotateX",
-  "rotateY",
-  "rotateZ",
-  "scale",
-  "opacity",
-  "emissiveIntensity"
-];
-function applyMeshAnimation(node, timeMs) {
-  const anim = node.animation;
-  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
-  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
-  const cycle = timeMs / anim.durationMs;
-  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
-  const trackValue = (key) => {
-    const defined = frames.filter((f) => f[key] !== void 0);
-    if (defined.length === 0) return void 0;
-    let prev;
-    let next;
-    for (const f of defined) {
-      if (f.at <= t) prev = f;
-      else if (!next) next = f;
+var GROUND_ROTATION = [-Math.PI / 2, 0, 0];
+function polyhedronGeometry(node, cellSize) {
+  const verts = node.vertices;
+  const faces = node.faces;
+  const bounds = polyhedronBounds(verts);
+  if (!verts || !bounds || !faces || faces.length === 0) return null;
+  const positions = new Float32Array(verts.length * 3);
+  for (let i = 0; i < verts.length; i++) {
+    positions[i * 3] = verts[i][0] * cellSize;
+    positions[i * 3 + 1] = verts[i][2] * cellSize;
+    positions[i * 3 + 2] = verts[i][1] * cellSize;
+  }
+  const index = [];
+  for (const face of faces) {
+    if (face.length < 3) continue;
+    const [a, b, c] = face;
+    if (a === b || b === c || a === c) continue;
+    if (![a, b, c].every((i) => Number.isInteger(i) && i >= 0 && i < verts.length)) continue;
+    index.push(a, c, b);
+  }
+  if (index.length === 0) return null;
+  const geometry = new THREE11.BufferGeometry();
+  geometry.setAttribute("position", new THREE11.BufferAttribute(positions, 3));
+  geometry.setIndex(index);
+  geometry.computeVertexNormals();
+  const skin = node.skin;
+  if (skin && skin.indices.length === verts.length && skin.weights.length === verts.length) {
+    const skinIndex = new Uint16Array(verts.length * 4);
+    const skinWeight = new Float32Array(verts.length * 4);
+    for (let i = 0; i < verts.length; i++) {
+      for (let k = 0; k < 4; k++) {
+        skinIndex[i * 4 + k] = skin.indices[i][k] ?? 0;
+        skinWeight[i * 4 + k] = skin.weights[i][k] ?? 0;
+      }
     }
-    if (!prev) return defined[0][key];
-    if (!next) return prev[key];
-    const span = next.at - prev.at;
-    const k = span > 0 ? (t - prev.at) / span : 1;
-    const a = prev[key];
-    const b = next[key];
-    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
-    return a;
-  };
-  const num = {};
-  for (const key of NUMERIC_TRACKS2) {
-    const v = trackValue(key);
-    if (v !== void 0) num[key] = v;
+    geometry.setAttribute("skinIndex", new THREE11.BufferAttribute(skinIndex, 4));
+    geometry.setAttribute("skinWeight", new THREE11.BufferAttribute(skinWeight, 4));
   }
-  return {
-    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
-    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
-    scale: num.scale ?? 1,
-    opacity: num.opacity,
-    emissiveIntensity: num.emissiveIntensity,
-    color: trackValue("color"),
-    emissive: trackValue("emissive")
-  };
+  const size = Math.max(bounds.max[0] - bounds.min[0], bounds.max[1] - bounds.min[1], bounds.max[2] - bounds.min[2]) * cellSize;
+  return { geometry, lift: -bounds.min[2] * cellSize, size };
 }
 function meshGeometry(node, cellSize) {
   const seg = clampSegments(node.segments);
@@ -1220,17 +1304,20 @@ function meshGeometry(node, cellSize) {
       return { element: /* @__PURE__ */ jsx("torusGeometry", { args: [r, tube, Math.max(3, Math.round(seg / 2)), seg] }), lift: r + tube, size: (r + tube) * 2 };
     }
     case "plane":
-      return { element: /* @__PURE__ */ jsx("planeGeometry", { args: [w, d] }), lift: 0, size: Math.max(w, d) };
+      return { element: /* @__PURE__ */ jsx("planeGeometry", { args: [w, d] }), lift: 0, size: Math.max(w, d), baseRotation: GROUND_ROTATION };
     case "circle":
-      return { element: /* @__PURE__ */ jsx("circleGeometry", { args: [r, seg] }), lift: 0, size: r * 2 };
+      return { element: /* @__PURE__ */ jsx("circleGeometry", { args: [r, seg] }), lift: 0, size: r * 2, baseRotation: GROUND_ROTATION };
+    case "polyhedron":
+      return polyhedronGeometry(node, cellSize);
     default:
       return null;
   }
 }
+var warnedPolyhedronOutline = false;
 var SIDE_MAP = {
-  front: THREE10.FrontSide,
-  back: THREE10.BackSide,
-  double: THREE10.DoubleSide
+  front: THREE11.FrontSide,
+  back: THREE11.BackSide,
+  double: THREE11.DoubleSide
 };
 function meshMaterial(mat, opacity, ref) {
   const m = mat ?? {};
@@ -1274,6 +1361,53 @@ function meshMaterial(mat, opacity, ref) {
       );
   }
 }
+function SkinnedPolyhedron3D({
+  node,
+  skin,
+  geometry,
+  cellSize,
+  opacity
+}) {
+  const boneStore = useContext(BoneRegistryContext);
+  const meshRef = useRef(null);
+  const [registryTick, setRegistryTick] = useState(0);
+  useEffect(() => boneStore?.subscribe(() => setRegistryTick((t) => t + 1)), [boneStore]);
+  useEffect(() => {
+    const mesh = meshRef.current;
+    if (!mesh || !boneStore) return;
+    const bones = [];
+    for (const name of skin.bones) {
+      const bone = boneStore.get(name);
+      if (!bone) return;
+      bones.push(bone);
+    }
+    if (mesh.skeleton && mesh.skeleton.bones.length === bones.length && mesh.skeleton.bones.every((b, i) => b === bones[i])) return;
+    if (skin.inverseBindMatrices.length !== bones.length) return;
+    const inverses = skin.inverseBindMatrices.map((m) => {
+      const mat = new THREE11.Matrix4().fromArray(m);
+      mat.elements[12] *= cellSize;
+      mat.elements[13] *= cellSize;
+      mat.elements[14] *= cellSize;
+      return mat;
+    });
+    mesh.bind(new THREE11.Skeleton(bones, inverses), new THREE11.Matrix4());
+  }, [registryTick, skin, boneStore, geometry, cellSize]);
+  useEffect(() => {
+    const mesh = meshRef.current;
+    return () => mesh?.skeleton?.dispose();
+  }, []);
+  return /* @__PURE__ */ jsx(
+    "skinnedMesh",
+    {
+      ref: meshRef,
+      geometry,
+      frustumCulled: false,
+      castShadow: node.castShadow ?? true,
+      receiveShadow: node.receiveShadow ?? true,
+      children: meshMaterial(node.material, opacity)
+    }
+  );
+}
 function Mesh3D({
   node,
   projector,
@@ -1286,6 +1420,10 @@ function Mesh3D({
   const validPos = isValidScenePos(node.position);
   const baseWorld = validPos ? projector.toWorld(node.position) : [0, 0, 0];
   const geo = useMemo(() => meshGeometry(node, projector.cellSize), [node, projector.cellSize]);
+  useEffect(() => {
+    const g = geo?.geometry;
+    return () => g?.dispose();
+  }, [geo]);
   useFrame(({ clock }) => {
     if (!animated || !groupRef.current) return;
     const state = applyMeshAnimation(node, clock.elapsedTime * 1e3);
@@ -1298,8 +1436,13 @@ function Mesh3D({
     );
     groupRef.current.scale.setScalar(state.scale);
     if (meshRef.current) {
+      const shapeRot = geo?.baseRotation ?? [0, 0, 0];
       const base = node.rotation ?? [0, 0, 0];
-      meshRef.current.rotation.set(base[0] + state.rotate[0], base[1] + state.rotate[1], base[2] + state.rotate[2]);
+      meshRef.current.rotation.set(
+        shapeRot[0] + base[0] + state.rotate[0],
+        shapeRot[1] + base[1] + state.rotate[1],
+        shapeRot[2] + base[2] + state.rotate[2]
+      );
     }
     const mat = materialRef.current;
     if (mat) {
@@ -1316,13 +1459,28 @@ function Mesh3D({
   if (!validPos || !geo) return null;
   const lift = (node.pivot ?? "bottom") === "bottom" ? geo.lift : 0;
   const opacity = (node.opacity ?? 1) * (node.material?.opacity ?? 1) * groupOpacity;
-  const rotation = node.rotation ?? [0, 0, 0];
+  if (node.skin && geo.geometry) {
+    return /* @__PURE__ */ jsx("group", { position: baseWorld, children: /* @__PURE__ */ jsx(SkinnedPolyhedron3D, { node, skin: node.skin, geometry: geo.geometry, cellSize: projector.cellSize, opacity }) });
+  }
+  const nodeRotation = node.rotation ?? [0, 0, 0];
+  const shapeRotation = geo.baseRotation ?? [0, 0, 0];
+  const rotation = [
+    shapeRotation[0] + nodeRotation[0],
+    shapeRotation[1] + nodeRotation[1],
+    shapeRotation[2] + nodeRotation[2]
+  ];
   const outlineScale = geo.size > 0 ? 1 + (node.outline?.width ?? 0.05) * projector.cellSize / geo.size : 1;
+  if (node.outline && geo.geometry && !warnedPolyhedronOutline) {
+    warnedPolyhedronOutline = true;
+    console.warn('[draw-mesh] outline is not yet supported on shape "polyhedron" \u2014 skipped');
+  }
+  const geometryProp = geo.geometry ? { geometry: geo.geometry } : {};
   return /* @__PURE__ */ jsxs("group", { ref: groupRef, position: baseWorld, children: [
     /* @__PURE__ */ jsxs(
       "mesh",
       {
         ref: meshRef,
+        ...geometryProp,
         position: [0, lift, 0],
         rotation,
         castShadow: node.castShadow ?? true,
@@ -1333,13 +1491,13 @@ function Mesh3D({
         ]
       }
     ),
-    node.outline && /* @__PURE__ */ jsxs("mesh", { position: [0, lift, 0], rotation, scale: outlineScale, children: [
+    node.outline && !geo.geometry && /* @__PURE__ */ jsxs("mesh", { position: [0, lift, 0], rotation, scale: outlineScale, children: [
       geo.element,
       /* @__PURE__ */ jsx(
         "meshBasicMaterial",
         {
           color: node.outline.color ?? "#101014",
-          side: THREE10.BackSide,
+          side: THREE11.BackSide,
           transparent: opacity < 1,
           opacity
         }
@@ -1366,14 +1524,53 @@ function Drawable3D({ node, projector, groupOpacity = 1 }) {
     case "draw-group": {
       if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
       if (node.clip) warnUnsupported3d("draw-group:clip");
-      const world = projector.toWorld(node.position);
-      const inner = create3DProjector({ cellSize: projector.cellSize });
-      const opacity = (node.opacity ?? 1) * groupOpacity;
-      const s = node.scale ?? 1;
-      return /* @__PURE__ */ jsx("group", { position: world, rotation: [0, -(node.rotate ?? 0), 0], scale: [s, s, s], children: node.items.map((item, i) => /* @__PURE__ */ jsx(Drawable3D, { node: item, projector: inner, groupOpacity: opacity }, i)) });
+      return /* @__PURE__ */ jsx(Group3D, { node, projector, groupOpacity });
     }
   }
 }
+function Group3D({
+  node,
+  projector,
+  groupOpacity
+}) {
+  const ref = useRef(null);
+  const animated = isAnimatedGroup(node);
+  const world = projector.toWorld(node.position);
+  const inner = create3DProjector({ cellSize: projector.cellSize });
+  const opacity = (node.opacity ?? 1) * groupOpacity;
+  const s = node.scale ?? 1;
+  const baseRotation = node.rotation ?? [0, -(node.rotate ?? 0), 0];
+  const parentStore = useContext(BoneRegistryContext);
+  const scopedStore = useMemo(() => node.skeleton ? new BoneStore() : null, [node.skeleton]);
+  const boneStore = scopedStore ?? parentStore;
+  const boneObject = useMemo(() => node.bone ? new THREE11.Bone() : null, [node.bone]);
+  useEffect(() => {
+    if (!node.bone || !boneStore || !boneObject) return;
+    return boneStore.register(node.bone, boneObject);
+  }, [node.bone, boneStore, boneObject]);
+  useFrame(({ clock }) => {
+    if (!animated || !ref.current) return;
+    const state = applyMeshAnimation(node, clock.elapsedTime * 1e3);
+    if (!state) return;
+    const cell = projector.cellSize;
+    ref.current.position.set(
+      world[0] + state.offset[0] * cell,
+      world[1] + state.offset[2] * cell,
+      world[2] + state.offset[1] * cell
+    );
+    ref.current.rotation.set(
+      baseRotation[0] + state.rotate[0],
+      baseRotation[1] + state.rotate[1],
+      baseRotation[2] + state.rotate[2]
+    );
+    ref.current.scale.setScalar(s * state.scale);
+  });
+  const children = /* @__PURE__ */ jsxs("group", { ref, position: world, rotation: baseRotation, scale: [s, s, s], children: [
+    boneObject && /* @__PURE__ */ jsx("primitive", { object: boneObject }),
+    node.items.map((item, i) => /* @__PURE__ */ jsx(Drawable3D, { node: item, projector: inner, groupOpacity: opacity }, i))
+  ] });
+  return scopedStore ? /* @__PURE__ */ jsx(BoneRegistryContext.Provider, { value: scopedStore, children }) : children;
+}
 
 // lib/drawable/three/game3dTheme.ts
 var GRID_COLORS_3D = {
@@ -1389,7 +1586,7 @@ var DEFAULT_GRID_CONFIG = {
 function RoomEnvironment3D() {
   const { gl, scene } = useThree(({ gl: gl2, scene: scene2 }) => ({ gl: gl2, scene: scene2 }));
   useEffect(() => {
-    const pmremGenerator = new THREE10.PMREMGenerator(gl);
+    const pmremGenerator = new THREE11.PMREMGenerator(gl);
     const envTexture = pmremGenerator.fromScene(new RoomEnvironment(), 0.04).texture;
     scene.environment = envTexture;
     return () => {
@@ -1505,6 +1702,7 @@ var Canvas3DHost = forwardRef(
       }),
       [gridBounds, cellSize]
     );
+    const boneStore = useMemo(() => new BoneStore(), []);
     const drawableProjector = useMemo(
       () => create3DProjector({
         cellSize: gridConfig.cellSize,
@@ -1517,7 +1715,7 @@ var Canvas3DHost = forwardRef(
       getCameraPosition: () => {
         if (controlsRef.current) {
           const pos = controlsRef.current.object.position;
-          return new THREE10.Vector3(pos.x, pos.y, pos.z);
+          return new THREE11.Vector3(pos.x, pos.y, pos.z);
         }
         return null;
       },
@@ -1562,6 +1760,8 @@ var Canvas3DHost = forwardRef(
           return { position: [cx + d, d * 0.8, cz + d], fov: fovDeg };
         case "top-down":
           return { position: [cx, d * 2, cz + d * 0.35], fov: fovDeg };
+        case "front":
+          return { position: [cx, d * 0.32, cz + d * 1.15], fov: fovDeg };
         case "follow":
           return { position: [cx, d * 0.5, cz + d], fov: fovDeg };
         case "perspective":
@@ -1628,6 +1828,7 @@ var Canvas3DHost = forwardRef(
               Canvas,
               {
                 shadows,
+                flat: lighting?.toneMapping === "none",
                 camera: {
                   position: cameraConfig.position,
                   fov: cameraConfig.fov,
@@ -1686,7 +1887,7 @@ var Canvas3DHost = forwardRef(
                       fadeStrength: 1
                     }
                   ),
-                  allDrawables.length > 0 && /* @__PURE__ */ jsx("group", { children: allDrawables.map((node, i) => /* @__PURE__ */ jsx(Drawable3D, { node, projector: drawableProjector }, i)) }),
+                  allDrawables.length > 0 && /* @__PURE__ */ jsx(BoneRegistryContext.Provider, { value: boneStore, children: /* @__PURE__ */ jsx("group", { children: allDrawables.map((node, i) => /* @__PURE__ */ jsx(Drawable3D, { node, projector: drawableProjector }, i)) }) }),
                   (tileClickEvent || unitClickEvent) && /* @__PURE__ */ jsxs(
                     "mesh",
                     {
@@ -1722,7 +1923,7 @@ var Canvas3DHost = forwardRef(
                       dampingFactor: 0.05,
                       enableZoom: true,
                       enablePan: true,
-                      touches: { ONE: THREE10.TOUCH.ROTATE, TWO: THREE10.TOUCH.DOLLY_PAN },
+                      touches: { ONE: THREE11.TOUCH.ROTATE, TWO: THREE11.TOUCH.DOLLY_PAN },
                       minDistance: 2,
                       maxDistance: 100,
                       maxPolarAngle: Math.PI / 2 - 0.1
@@ -1745,15 +1946,15 @@ function Scene3D({ background = "#1a1a2e", fog, children }) {
     if (initializedRef.current) return;
     initializedRef.current = true;
     if (background.startsWith("#") || background.startsWith("rgb")) {
-      scene.background = new THREE10.Color(background);
+      scene.background = new THREE11.Color(background);
     } else {
-      const loader = new THREE10.TextureLoader();
+      const loader = new THREE11.TextureLoader();
       loader.load(background, (texture) => {
         scene.background = texture;
       });
     }
     if (fog) {
-      scene.fog = new THREE10.Fog(fog.color, fog.near, fog.far);
+      scene.fog = new THREE11.Fog(fog.color, fog.near, fog.far);
     }
     return () => {
       scene.background = null;
@@ -1776,14 +1977,14 @@ var Camera3D = forwardRef(
   }, ref) => {
     const { camera, set, viewport } = useThree();
     const controlsRef = useRef(null);
-    const initialPosition = useRef(new THREE10.Vector3(...position));
-    const initialTarget = useRef(new THREE10.Vector3(...target));
+    const initialPosition = useRef(new THREE11.Vector3(...position));
+    const initialTarget = useRef(new THREE11.Vector3(...target));
     useEffect(() => {
       let newCamera;
       if (mode === "isometric") {
         const aspect = viewport.aspect;
         const size = 10 / zoom;
-        newCamera = new THREE10.OrthographicCamera(
+        newCamera = new THREE11.OrthographicCamera(
           -size * aspect,
           size * aspect,
           size,
@@ -1792,7 +1993,7 @@ var Camera3D = forwardRef(
           1e3
         );
       } else {
-        newCamera = new THREE10.PerspectiveCamera(fov, viewport.aspect, 0.1, 1e3);
+        newCamera = new THREE11.PerspectiveCamera(fov, viewport.aspect, 0.1, 1e3);
       }
       newCamera.position.copy(initialPosition.current);
       newCamera.lookAt(initialTarget.current.x, initialTarget.current.y, initialTarget.current.z);
@@ -1833,8 +2034,8 @@ var Camera3D = forwardRef(
         }
       },
       getViewBounds: () => {
-        const min = new THREE10.Vector3(-10, -10, -10);
-        const max = new THREE10.Vector3(10, 10, 10);
+        const min = new THREE11.Vector3(-10, -10, -10);
+        const max = new THREE11.Vector3(10, 10, 10);
         return { min, max };
       }
     }));
@@ -1876,7 +2077,7 @@ var AssetLoader = class {
     __publicField(this, "textureCache");
     __publicField(this, "loadingPromises");
     this.objLoader = new OBJLoader();
-    this.textureLoader = new THREE10.TextureLoader();
+    this.textureLoader = new THREE11.TextureLoader();
     this.modelCache = /* @__PURE__ */ new Map();
     this.textureCache = /* @__PURE__ */ new Map();
     this.loadingPromises = /* @__PURE__ */ new Map();
@@ -1950,7 +2151,7 @@ var AssetLoader = class {
       return this.loadingPromises.get(`texture:${url}`);
     }
     const loadPromise = this.textureLoader.loadAsync(url).then((texture) => {
-      texture.colorSpace = THREE10.SRGBColorSpace;
+      texture.colorSpace = THREE11.SRGBColorSpace;
       this.textureCache.set(url, texture);
       this.loadingPromises.delete(`texture:${url}`);
       return texture;
@@ -2024,7 +2225,7 @@ var AssetLoader = class {
     });
     this.modelCache.forEach((model) => {
       model.scene.traverse((child) => {
-        if (child instanceof THREE10.Mesh) {
+        if (child instanceof THREE11.Mesh) {
           child.geometry.dispose();
           if (Array.isArray(child.material)) {
             child.material.forEach((m) => m.dispose());
@@ -2074,21 +2275,21 @@ function useThree5(options = {}) {
   const [isReady, setIsReady] = useState(false);
   const [dimensions, setDimensions] = useState({ width: 0, height: 0 });
   const initialCameraPosition = useMemo(
-    () => new THREE10.Vector3(...opts.cameraPosition),
+    () => new THREE11.Vector3(...opts.cameraPosition),
     []
   );
   useEffect(() => {
     if (!containerRef.current) return;
     const container = containerRef.current;
     const { clientWidth, clientHeight } = container;
-    const scene = new THREE10.Scene();
-    scene.background = new THREE10.Color(opts.backgroundColor);
+    const scene = new THREE11.Scene();
+    scene.background = new THREE11.Color(opts.backgroundColor);
     sceneRef.current = scene;
     let camera;
     const aspect = clientWidth / clientHeight;
     if (opts.cameraMode === "isometric") {
       const size = 10;
-      camera = new THREE10.OrthographicCamera(
+      camera = new THREE11.OrthographicCamera(
         -size * aspect,
         size * aspect,
         size,
@@ -2097,11 +2298,11 @@ function useThree5(options = {}) {
         1e3
       );
     } else {
-      camera = new THREE10.PerspectiveCamera(45, aspect, 0.1, 1e3);
+      camera = new THREE11.PerspectiveCamera(45, aspect, 0.1, 1e3);
     }
     camera.position.copy(initialCameraPosition);
     cameraRef.current = camera;
-    const renderer = new THREE10.WebGLRenderer({
+    const renderer = new THREE11.WebGLRenderer({
       antialias: true,
       alpha: true,
       canvas: canvasRef.current || void 0
@@ -2109,7 +2310,7 @@ function useThree5(options = {}) {
     renderer.setSize(clientWidth, clientHeight);
     renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));
     renderer.shadowMap.enabled = opts.shadows;
-    renderer.shadowMap.type = THREE10.PCFSoftShadowMap;
+    renderer.shadowMap.type = THREE11.PCFSoftShadowMap;
     rendererRef.current = renderer;
     const controls = new OrbitControls$1(camera, renderer.domElement);
     controls.enableDamping = true;
@@ -2118,16 +2319,16 @@ function useThree5(options = {}) {
     controls.maxDistance = 100;
     controls.maxPolarAngle = Math.PI / 2 - 0.1;
     controlsRef.current = controls;
-    const ambientLight = new THREE10.AmbientLight(16777215, 0.6);
+    const ambientLight = new THREE11.AmbientLight(16777215, 0.6);
     scene.add(ambientLight);
-    const directionalLight = new THREE10.DirectionalLight(16777215, 0.8);
+    const directionalLight = new THREE11.DirectionalLight(16777215, 0.8);
     directionalLight.position.set(10, 20, 10);
     directionalLight.castShadow = opts.shadows;
     directionalLight.shadow.mapSize.width = 2048;
     directionalLight.shadow.mapSize.height = 2048;
     scene.add(directionalLight);
     if (opts.showGrid) {
-      const gridHelper = new THREE10.GridHelper(
+      const gridHelper = new THREE11.GridHelper(
         opts.gridSize,
         opts.gridSize,
         4473924,
@@ -2145,10 +2346,10 @@ function useThree5(options = {}) {
     const handleResize = () => {
       const { clientWidth: width, clientHeight: height } = container;
       setDimensions({ width, height });
-      if (camera instanceof THREE10.PerspectiveCamera) {
+      if (camera instanceof THREE11.PerspectiveCamera) {
         camera.aspect = width / height;
         camera.updateProjectionMatrix();
-      } else if (camera instanceof THREE10.OrthographicCamera) {
+      } else if (camera instanceof THREE11.OrthographicCamera) {
         const aspect2 = width / height;
         const size = 10;
         camera.left = -size * aspect2;
@@ -2179,7 +2380,7 @@ function useThree5(options = {}) {
     let newCamera;
     if (opts.cameraMode === "isometric") {
       const size = 10;
-      newCamera = new THREE10.OrthographicCamera(
+      newCamera = new THREE11.OrthographicCamera(
         -size * aspect,
         size * aspect,
         size,
@@ -2188,7 +2389,7 @@ function useThree5(options = {}) {
         1e3
       );
     } else {
-      newCamera = new THREE10.PerspectiveCamera(45, aspect, 0.1, 1e3);
+      newCamera = new THREE11.PerspectiveCamera(45, aspect, 0.1, 1e3);
     }
     newCamera.position.copy(currentPos);
     cameraRef.current = newCamera;
@@ -2518,8 +2719,8 @@ function useSceneGraph() {
 }
 function useRaycaster(options) {
   const { camera, canvas, cellSize = 1, offsetX = 0, offsetZ = 0 } = options;
-  const raycaster = useRef(new THREE10.Raycaster());
-  const mouse = useRef(new THREE10.Vector2());
+  const raycaster = useRef(new THREE11.Raycaster());
+  const mouse = useRef(new THREE11.Vector2());
   const clientToNDC = useCallback(
     (clientX, clientY) => {
       if (!canvas) {
@@ -2589,8 +2790,8 @@ function useRaycaster(options) {
       const ndc = clientToNDC(clientX, clientY);
       mouse.current.set(ndc.x, ndc.y);
       raycaster.current.setFromCamera(mouse.current, camera);
-      const plane = new THREE10.Plane(new THREE10.Vector3(0, 1, 0), 0);
-      const target = new THREE10.Vector3();
+      const plane = new THREE11.Plane(new THREE11.Vector3(0, 1, 0), 0);
+      const target = new THREE11.Vector3();
       const intersection = raycaster.current.ray.intersectPlane(plane, target);
       if (intersection) {
         const gridX = Math.round((target.x - offsetX) / cellSize);
@@ -2628,7 +2829,7 @@ function useRaycaster(options) {
         return {
           gridX: gridCoords.x,
           gridZ: gridCoords.z,
-          worldPosition: new THREE10.Vector3(
+          worldPosition: new THREE11.Vector3(
             gridCoords.x * cellSize + offsetX,
             0,
             gridCoords.z * cellSize + offsetZ
@@ -2658,7 +2859,7 @@ var DEFAULT_CONFIG = {
 };
 function gridToWorld(gridX, gridZ, config = DEFAULT_CONFIG) {
   const opts = { ...DEFAULT_CONFIG, ...config };
-  return new THREE10.Vector3(
+  return new THREE11.Vector3(
     gridX * opts.cellSize + opts.offsetX,
     opts.elevation,
     gridZ * opts.cellSize + opts.offsetZ
@@ -2672,17 +2873,17 @@ function worldToGrid(worldX, worldZ, config = DEFAULT_CONFIG) {
   };
 }
 function raycastToPlane(camera, mouseX, mouseY, planeY = 0) {
-  const raycaster = new THREE10.Raycaster();
-  const mouse = new THREE10.Vector2(mouseX, mouseY);
+  const raycaster = new THREE11.Raycaster();
+  const mouse = new THREE11.Vector2(mouseX, mouseY);
   raycaster.setFromCamera(mouse, camera);
-  const plane = new THREE10.Plane(new THREE10.Vector3(0, 1, 0), -planeY);
-  const target = new THREE10.Vector3();
+  const plane = new THREE11.Plane(new THREE11.Vector3(0, 1, 0), -planeY);
+  const target = new THREE11.Vector3();
   const intersection = raycaster.ray.intersectPlane(plane, target);
   return intersection ? target : null;
 }
 function raycastToObjects(camera, mouseX, mouseY, objects) {
-  const raycaster = new THREE10.Raycaster();
-  const mouse = new THREE10.Vector2(mouseX, mouseY);
+  const raycaster = new THREE11.Raycaster();
+  const mouse = new THREE11.Vector2(mouseX, mouseY);
   raycaster.setFromCamera(mouse, camera);
   const intersects = raycaster.intersectObjects(objects, true);
   return intersects.length > 0 ? intersects[0] : null;
@@ -2734,14 +2935,14 @@ function getCellsInRadius(centerX, centerZ, radius) {
   return cells;
 }
 function createGridHighlight(color = 16776960, opacity = 0.3) {
-  const geometry = new THREE10.PlaneGeometry(0.95, 0.95);
-  const material = new THREE10.MeshBasicMaterial({
+  const geometry = new THREE11.PlaneGeometry(0.95, 0.95);
+  const material = new THREE11.MeshBasicMaterial({
     color,
     transparent: true,
     opacity,
-    side: THREE10.DoubleSide
+    side: THREE11.DoubleSide
   });
-  const mesh = new THREE10.Mesh(geometry, material);
+  const mesh = new THREE11.Mesh(geometry, material);
   mesh.rotation.x = -Math.PI / 2;
   mesh.position.y = 0.01;
   return mesh;
@@ -2754,31 +2955,31 @@ function normalizeMouseCoordinates(clientX, clientY, element) {
   };
 }
 function isInFrustum(position, camera, padding = 0) {
-  const frustum = new THREE10.Frustum();
-  const projScreenMatrix = new THREE10.Matrix4();
+  const frustum = new THREE11.Frustum();
+  const projScreenMatrix = new THREE11.Matrix4();
   projScreenMatrix.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
   frustum.setFromProjectionMatrix(projScreenMatrix);
-  const sphere = new THREE10.Sphere(position, padding);
+  const sphere = new THREE11.Sphere(position, padding);
   return frustum.intersectsSphere(sphere);
 }
 function filterByFrustum(positions, camera, padding = 0) {
-  const frustum = new THREE10.Frustum();
-  const projScreenMatrix = new THREE10.Matrix4();
+  const frustum = new THREE11.Frustum();
+  const projScreenMatrix = new THREE11.Matrix4();
   projScreenMatrix.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
   frustum.setFromProjectionMatrix(projScreenMatrix);
   return positions.filter((position) => {
-    const sphere = new THREE10.Sphere(position, padding);
+    const sphere = new THREE11.Sphere(position, padding);
     return frustum.intersectsSphere(sphere);
   });
 }
 function getVisibleIndices(positions, camera, padding = 0) {
-  const frustum = new THREE10.Frustum();
-  const projScreenMatrix = new THREE10.Matrix4();
+  const frustum = new THREE11.Frustum();
+  const projScreenMatrix = new THREE11.Matrix4();
   const visible = /* @__PURE__ */ new Set();
   projScreenMatrix.multiplyMatrices(camera.projectionMatrix, camera.matrixWorldInverse);
   frustum.setFromProjectionMatrix(projScreenMatrix);
   positions.forEach((position, index) => {
-    const sphere = new THREE10.Sphere(position, padding);
+    const sphere = new THREE11.Sphere(position, padding);
     if (frustum.intersectsSphere(sphere)) {
       visible.add(index);
     }
@@ -2802,7 +3003,7 @@ function updateInstanceLOD(instancedMesh, positions, camera, lodDistances) {
   return lodIndices;
 }
 function cullInstancedMesh(instancedMesh, positions, visibleIndices) {
-  const dummy = new THREE10.Object3D();
+  const dummy = new THREE11.Object3D();
   let visibleCount = 0;
   positions.forEach((position, index) => {
     if (visibleIndices.has(index)) {
@@ -5585,12 +5786,12 @@ function useAvl3DConfig() {
 }
 function CameraController({ targetPosition, targetLookAt, animated }) {
   const { camera } = useThree();
-  const targetPosVec = useRef(new THREE10.Vector3(...targetPosition));
-  const targetLookVec = useRef(new THREE10.Vector3(...targetLookAt));
+  const targetPosVec = useRef(new THREE11.Vector3(...targetPosition));
+  const targetLookVec = useRef(new THREE11.Vector3(...targetLookAt));
   const isAnimating = useRef(false);
   useEffect(() => {
-    const newTarget = new THREE10.Vector3(...targetPosition);
-    const newLookAt = new THREE10.Vector3(...targetLookAt);
+    const newTarget = new THREE11.Vector3(...targetPosition);
+    const newLookAt = new THREE11.Vector3(...targetLookAt);
     if (!newTarget.equals(targetPosVec.current) || !newLookAt.equals(targetLookVec.current)) {
       targetPosVec.current.copy(newTarget);
       targetLookVec.current.copy(newLookAt);
@@ -5605,9 +5806,9 @@ function CameraController({ targetPosition, targetLookAt, animated }) {
   useFrame((_, delta) => {
     if (!isAnimating.current) return;
     const speed = 3;
-    camera.position.x = THREE10.MathUtils.damp(camera.position.x, targetPosVec.current.x, speed, delta);
-    camera.position.y = THREE10.MathUtils.damp(camera.position.y, targetPosVec.current.y, speed, delta);
-    camera.position.z = THREE10.MathUtils.damp(camera.position.z, targetPosVec.current.z, speed, delta);
+    camera.position.x = THREE11.MathUtils.damp(camera.position.x, targetPosVec.current.x, speed, delta);
+    camera.position.y = THREE11.MathUtils.damp(camera.position.y, targetPosVec.current.y, speed, delta);
+    camera.position.z = THREE11.MathUtils.damp(camera.position.z, targetPosVec.current.z, speed, delta);
     camera.lookAt(targetLookVec.current);
     const dist = camera.position.distanceTo(targetPosVec.current);
     if (dist < 0.05) {
@@ -5622,7 +5823,7 @@ function SceneFade({ animating, children }) {
   useFrame((_, delta) => {
     if (!groupRef.current) return;
     const target = animating ? 0 : 1;
-    opacityRef.current = THREE10.MathUtils.damp(opacityRef.current, target, 5, delta);
+    opacityRef.current = THREE11.MathUtils.damp(opacityRef.current, target, 5, delta);
     groupRef.current.visible = opacityRef.current > 0.05;
     const s = 0.9 + opacityRef.current * 0.1;
     groupRef.current.scale.setScalar(s);