@almadar/ui 5.103.0 → 5.105.0

package/dist/components/game/3d/index.js

@@ -1,5 +1,5 @@
-import * as React8 from 'react';
-import React8__default, { forwardRef, useRef, useEffect, useImperativeHandle, useState, useMemo, useCallback, createContext, useContext, Component, useSyncExternalStore, useReducer } from 'react';
+import * as React10 from 'react';
+import React10__default, { forwardRef, useRef, useEffect, useImperativeHandle, useState, useMemo, useCallback, createContext, useContext, Component, useSyncExternalStore, useReducer } from 'react';
 import { useThree, useFrame, Canvas, useLoader } from '@react-three/fiber';
 import * as THREE6 from 'three';
 import { Vector3, QuadraticBezierCurve3, MathUtils, Quaternion } from 'three';
@@ -149,6 +149,10 @@ function Lighting3D({
   shadows = true,
   shadowMapSize = 2048,
   shadowCameraSize = 20,
+  shadowBias = -1e-3,
+  shadowNormalBias,
+  shadowCameraNear = 0.1,
+  shadowCameraFar = 100,
   showHelpers = false
 }) {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -165,9 +169,10 @@ function Lighting3D({
         "shadow-camera-right": shadowCameraSize,
         "shadow-camera-top": shadowCameraSize,
         "shadow-camera-bottom": -shadowCameraSize,
-        "shadow-camera-near": 0.1,
-        "shadow-camera-far": 100,
-        "shadow-bias": -1e-3
+        "shadow-camera-near": shadowCameraNear,
+        "shadow-camera-far": shadowCameraFar,
+        "shadow-bias": shadowBias,
+        "shadow-normalBias": shadowNormalBias
       }
     ),
     /* @__PURE__ */ jsx(
@@ -1561,6 +1566,171 @@ function useGameCanvas3DEvents(options) {
   };
 }
 
+// components/game/shared/game3dTheme.ts
+var TERRAIN_COLORS_3D = {
+  base: 8421504,
+  water: 4491468,
+  grass: 4500036,
+  sand: 14535816,
+  rock: 8947848,
+  snow: 15658734
+};
+var HIGHLIGHT_EMISSIVE_3D = {
+  selected: 4473924,
+  attackTarget: 4456448,
+  validMove: 17408,
+  hovered: 2236962,
+  none: 0
+};
+var FACTION_COLORS_3D = {
+  player: 4491519,
+  enemy: 16729156,
+  default: 16777028
+};
+var SELECTION_RING_COLOR_3D = "#ffff00";
+var HEALTHBAR_3D = {
+  bg: 3355443,
+  /** fill color thresholds: fraction > key → color */
+  high: 4500036,
+  // fraction > 0.5
+  mid: 11184708,
+  // fraction > 0.25
+  low: 16729156,
+  // else
+  width: 0.5
+};
+function healthbarFill3D(fraction) {
+  if (fraction > 0.5) return HEALTHBAR_3D.high;
+  if (fraction > 0.25) return HEALTHBAR_3D.mid;
+  return HEALTHBAR_3D.low;
+}
+var TREE_COLORS_3D = {
+  trunk: 9127187,
+  foliage: 2263842
+};
+var ROCK_COLOR_3D = 8421504;
+var EVENT_COLORS_3D = {
+  hit: 16733508,
+  damage: 16733508,
+  attack: 16746564,
+  heal: 4513126,
+  pickup: 16763955,
+  score: 16763955,
+  death: 11154227,
+  win: 6750088,
+  lose: 16737894,
+  default: 16777215
+};
+var SIDE_PLATFORM_COLORS_3D = {
+  ground: 5999678,
+  platform: 9132587,
+  hazard: 13386820,
+  goal: 4491468,
+  default: 8947848
+};
+var SIDE_PLAYER_COLOR_3D = "#4488ff";
+var GRID_COLORS_3D = {
+  cell: "#444444",
+  section: "#666666"
+};
+var DEFAULT_BACKGROUND_3D = "#1a1a2e";
+function TileMesh3D({
+  tile,
+  position,
+  model,
+  isSelected,
+  isHovered,
+  isValidMove,
+  isAttackTarget,
+  onTileClick,
+  onTileHover
+}) {
+  const color = tile.color ?? TERRAIN_COLORS_3D[tile.type ?? ""] ?? TERRAIN_COLORS_3D.base;
+  let emissive = HIGHLIGHT_EMISSIVE_3D.none;
+  if (isSelected) emissive = HIGHLIGHT_EMISSIVE_3D.selected;
+  else if (isAttackTarget) emissive = HIGHLIGHT_EMISSIVE_3D.attackTarget;
+  else if (isValidMove) emissive = HIGHLIGHT_EMISSIVE_3D.validMove;
+  else if (isHovered) emissive = HIGHLIGHT_EMISSIVE_3D.hovered;
+  if (model?.url) {
+    return /* @__PURE__ */ jsx(
+      "group",
+      {
+        position,
+        onClick: (e) => onTileClick(tile, e),
+        onPointerEnter: (e) => onTileHover(tile, e),
+        onPointerLeave: (e) => onTileHover(null, e),
+        userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
+        children: /* @__PURE__ */ jsx(
+          ModelLoader,
+          {
+            url: model.url,
+            scale: 0.95,
+            rotation: [0, tile.rotation ?? 0, 0],
+            fallbackGeometry: "box",
+            castShadow: true,
+            receiveShadow: true
+          }
+        )
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxs(
+    "mesh",
+    {
+      position,
+      onClick: (e) => onTileClick(tile, e),
+      onPointerEnter: (e) => onTileHover(tile, e),
+      onPointerLeave: (e) => onTileHover(null, e),
+      userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
+      children: [
+        /* @__PURE__ */ jsx("boxGeometry", { args: [0.95, 0.2, 0.95] }),
+        /* @__PURE__ */ jsx("meshStandardMaterial", { color, emissive })
+      ]
+    }
+  );
+}
+function SpriteBillboard3D({
+  sheetUrl,
+  resolveFrame,
+  height = 1.2
+}) {
+  const texture = useLoader(THREE6.TextureLoader, sheetUrl);
+  const meshRef = useRef(null);
+  const matRef = useRef(null);
+  const [aspect, setAspect] = useState(1);
+  useFrame(() => {
+    const frame = resolveFrame();
+    if (!frame || !texture.image) return;
+    const imgW = texture.image.width;
+    const imgH = texture.image.height;
+    if (!imgW || !imgH) return;
+    texture.repeat.set((frame.flipX ? -1 : 1) * (frame.sw / imgW), frame.sh / imgH);
+    texture.offset.set(
+      frame.flipX ? (frame.sx + frame.sw) / imgW : frame.sx / imgW,
+      1 - (frame.sy + frame.sh) / imgH
+    );
+    texture.magFilter = THREE6.NearestFilter;
+    texture.minFilter = THREE6.NearestFilter;
+    texture.needsUpdate = true;
+    const nextAspect = frame.sw / frame.sh;
+    if (Math.abs(nextAspect - aspect) > 1e-3) setAspect(nextAspect);
+    if (matRef.current) matRef.current.needsUpdate = true;
+  });
+  return /* @__PURE__ */ jsxs("mesh", { ref: meshRef, position: [0, height / 2, 0], children: [
+    /* @__PURE__ */ jsx("planeGeometry", { args: [height * aspect, height] }),
+    /* @__PURE__ */ jsx(
+      "meshBasicMaterial",
+      {
+        ref: matRef,
+        map: texture,
+        transparent: true,
+        alphaTest: 0.1,
+        side: THREE6.DoubleSide
+      }
+    )
+  ] });
+}
+
 // components/game/shared/spriteAnimation.ts
 function resolveSheetDirection(facing) {
   switch (facing) {
@@ -1673,274 +1843,11 @@ function useUnitSpriteAtlas(units) {
   }, [units]);
   return { sheetUrls, resolveUnitFrame, pendingCount };
 }
-function cn(...inputs) {
-  return twMerge(clsx(inputs));
-}
-var DEFAULT_GRID_CONFIG = {
-  cellSize: 1,
-  offsetX: 0,
-  offsetZ: 0
-};
-function CameraController({
-  onCameraChange
-}) {
-  const { camera } = useThree();
-  useEffect(() => {
-    if (onCameraChange) {
-      onCameraChange({
-        x: camera.position.x,
-        y: camera.position.y,
-        z: camera.position.z
-      });
-    }
-  }, [camera.position, onCameraChange]);
-  return null;
-}
-function UnitSpriteBillboard({
-  sheetUrl,
-  resolveFrame,
-  height = 1.2
-}) {
-  const texture = useLoader(THREE6.TextureLoader, sheetUrl);
-  const meshRef = useRef(null);
-  const matRef = useRef(null);
-  const [aspect, setAspect] = useState(1);
-  useFrame(() => {
-    const frame = resolveFrame();
-    if (!frame || !texture.image) return;
-    const imgW = texture.image.width;
-    const imgH = texture.image.height;
-    if (!imgW || !imgH) return;
-    texture.repeat.set((frame.flipX ? -1 : 1) * (frame.sw / imgW), frame.sh / imgH);
-    texture.offset.set(
-      frame.flipX ? (frame.sx + frame.sw) / imgW : frame.sx / imgW,
-      1 - (frame.sy + frame.sh) / imgH
-    );
-    texture.magFilter = THREE6.NearestFilter;
-    texture.minFilter = THREE6.NearestFilter;
-    texture.needsUpdate = true;
-    const nextAspect = frame.sw / frame.sh;
-    if (Math.abs(nextAspect - aspect) > 1e-3) setAspect(nextAspect);
-    if (matRef.current) matRef.current.needsUpdate = true;
-  });
-  return /* @__PURE__ */ jsxs("mesh", { ref: meshRef, position: [0, height / 2, 0], children: [
-    /* @__PURE__ */ jsx("planeGeometry", { args: [height * aspect, height] }),
-    /* @__PURE__ */ jsx(
-      "meshBasicMaterial",
-      {
-        ref: matRef,
-        map: texture,
-        transparent: true,
-        alphaTest: 0.1,
-        side: THREE6.DoubleSide
-      }
-    )
-  ] });
-}
-function FollowCamera({
-  target,
-  offset
-}) {
-  const { camera } = useThree();
-  const look = useRef(new THREE6.Vector3(target[0], target[1], target[2]));
-  const goal = useRef(new THREE6.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]);
-    camera.position.lerp(goal.current, t);
-    look.current.lerp(goal.current.set(target[0], target[1], target[2]), t);
-    camera.lookAt(look.current);
-  });
-  return null;
-}
-function LerpedGroup({
-  target,
-  enabled,
-  children
-}) {
-  const ref = useRef(null);
-  const goal = useRef(new THREE6.Vector3());
-  useFrame((_, delta) => {
-    const g = ref.current;
-    if (!g) return;
-    goal.current.set(target[0], target[1], target[2]);
-    if (enabled) g.position.lerp(goal.current, Math.min(1, delta * 10));
-    else g.position.copy(goal.current);
-  });
-  return /* @__PURE__ */ jsx("group", { ref, position: target, children });
-}
-var SIDE_PLATFORM_COLORS = {
-  ground: "#5b8c3e",
-  platform: "#8b5a2b",
-  hazard: "#cc4444",
-  goal: "#4488cc"
-};
-function SideScene({
-  player,
-  platforms,
-  worldHeight,
-  ppu,
-  playerSprite,
-  tileSprites,
-  interpolate,
-  features = [],
-  events = [],
-  assetManifest
-}) {
-  const pw = player.width ?? 32;
-  const ph = player.height ?? 48;
-  const playerPos = [
-    (player.x + pw / 2) / ppu,
-    (worldHeight - player.y - ph) / ppu,
-    0
-  ];
-  const playerH = Math.max(ph / ppu, 0.5);
-  return /* @__PURE__ */ jsxs("group", { children: [
-    platforms.map((p, i) => {
-      const platformType = p.type ?? "platform";
-      const model = tileSprites?.[platformType]?.url;
-      const topY = (worldHeight - p.y) / ppu;
-      if (model) {
-        const cells = Math.max(1, Math.round(p.width / ppu));
-        const x0 = p.x / ppu;
-        return /* @__PURE__ */ jsx("group", { children: Array.from({ length: cells }, (_, c) => /* @__PURE__ */ jsx("group", { position: [x0 + c + 0.5, topY - 0.475, 0], children: /* @__PURE__ */ jsx(ModelLoader, { url: model, scale: 0.95, fallbackGeometry: "box", castShadow: true, receiveShadow: true }) }, c)) }, `plat-${i}`);
-      }
-      return /* @__PURE__ */ jsxs(
-        "mesh",
-        {
-          position: [(p.x + p.width / 2) / ppu, topY - p.height / 2 / ppu, 0],
-          children: [
-            /* @__PURE__ */ jsx("boxGeometry", { args: [p.width / ppu, p.height / ppu, 1] }),
-            /* @__PURE__ */ jsx("meshStandardMaterial", { color: SIDE_PLATFORM_COLORS[platformType] ?? "#888888" })
-          ]
-        },
-        `plat-${i}`
-      );
-    }),
-    features.map((feature, i) => {
-      const model = feature.assetUrl ?? assetManifest?.features?.[feature.type];
-      const fx = feature.x / ppu;
-      const fy = (worldHeight - feature.y) / ppu;
-      if (!model?.url) return null;
-      return /* @__PURE__ */ jsx("group", { position: [fx, fy, 0], children: /* @__PURE__ */ jsx(ModelLoader, { url: model.url, scale: 0.6, tint: feature.color, fallbackGeometry: "sphere", castShadow: true }) }, feature.id ?? `sfeat-${i}`);
-    }),
-    events.map((ev, i) => /* @__PURE__ */ jsx(
-      EventMarker,
-      {
-        event: ev,
-        position: [ev.x / ppu, (worldHeight - (ev.y ?? 0)) / ppu + 0.8, 0.2]
-      },
-      ev.id ?? `sev-${i}`
-    )),
-    /* @__PURE__ */ jsx(LerpedGroup, { target: playerPos, enabled: interpolate, children: playerSprite?.url ? /* @__PURE__ */ jsx("group", { position: [0, playerH / 2, 0], children: /* @__PURE__ */ jsx(
-      ModelLoader,
-      {
-        url: playerSprite.url,
-        scale: playerH,
-        rotation: [0, player.facingRight ? 90 : -90, 0],
-        animation: player.animation ?? "idle",
-        fallbackGeometry: "box",
-        castShadow: true
-      }
-    ) }) : /* @__PURE__ */ jsxs("mesh", { position: [0, playerH / 2, 0], children: [
-      /* @__PURE__ */ jsx("capsuleGeometry", { args: [playerH * 0.25, playerH * 0.5, 4, 8] }),
-      /* @__PURE__ */ jsx("meshStandardMaterial", { color: "#4488ff" })
-    ] }) })
-  ] });
-}
 var UNIT_BASE_MODEL_SCALE = 0.5;
 var UNIT_BASE_BILLBOARD_HEIGHT = 1.2;
 var UNIT_BASE_PRIMITIVE_RADIUS = 0.3;
-var TILE_TOP_OFFSET = 0.1;
-var EVENT_COLORS = {
-  hit: "#ff5544",
-  damage: "#ff5544",
-  attack: "#ff8844",
-  heal: "#44dd66",
-  pickup: "#ffcc33",
-  score: "#ffcc33",
-  death: "#aa3333",
-  win: "#66ff88",
-  lose: "#ff6666"
-};
-function EventMarker({
-  event,
-  position
-}) {
-  return /* @__PURE__ */ jsx(Billboard, { position, children: /* @__PURE__ */ jsx(
-    Text,
-    {
-      fontSize: 0.32,
-      color: EVENT_COLORS[event.type] ?? "#ffffff",
-      outlineWidth: 0.02,
-      outlineColor: "#000000",
-      anchorX: "center",
-      anchorY: "middle",
-      children: event.message ?? event.type
-    }
-  ) });
-}
-function DefaultTile({
-  tile,
-  position,
-  model,
-  isSelected,
-  isHovered,
-  isValidMove,
-  isAttackTarget,
-  onTileClick,
-  onTileHover
-}) {
-  let color = 8421504;
-  if (tile.type === "water") color = 4491468;
-  else if (tile.type === "grass") color = 4500036;
-  else if (tile.type === "sand") color = 14535816;
-  else if (tile.type === "rock") color = 8947848;
-  else if (tile.type === "snow") color = 15658734;
-  let emissive = 0;
-  if (isSelected) emissive = 4473924;
-  else if (isAttackTarget) emissive = 4456448;
-  else if (isValidMove) emissive = 17408;
-  else if (isHovered) emissive = 2236962;
-  if (model?.url) {
-    return /* @__PURE__ */ jsx(
-      "group",
-      {
-        position,
-        onClick: (e) => onTileClick(tile, e),
-        onPointerEnter: (e) => onTileHover(tile, e),
-        onPointerLeave: (e) => onTileHover(null, e),
-        userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
-        children: /* @__PURE__ */ jsx(
-          ModelLoader,
-          {
-            url: model.url,
-            scale: 0.95,
-            rotation: [0, tile.rotation ?? 0, 0],
-            fallbackGeometry: "box",
-            castShadow: true,
-            receiveShadow: true
-          }
-        )
-      }
-    );
-  }
-  return /* @__PURE__ */ jsxs(
-    "mesh",
-    {
-      position,
-      onClick: (e) => onTileClick(tile, e),
-      onPointerEnter: (e) => onTileHover(tile, e),
-      onPointerLeave: (e) => onTileHover(null, e),
-      userData: { type: "tile", tileId: tile.id, gridX: tile.x, gridZ: tile.z ?? tile.y },
-      children: [
-        /* @__PURE__ */ jsx("boxGeometry", { args: [0.95, 0.2, 0.95] }),
-        /* @__PURE__ */ jsx("meshStandardMaterial", { color, emissive })
-      ]
-    }
-  );
-}
-function DefaultUnit({
+var HEALTHBAR_HEIGHT = 0.05;
+function UnitMesh3D({
   unit,
   position,
   model,
@@ -1950,7 +1857,7 @@ function DefaultUnit({
   resolveUnitFrame,
   onUnitClick
 }) {
-  const color = unit.faction === "player" ? 4491519 : unit.faction === "enemy" ? 16729156 : 16777028;
+  const color = unit.tint ?? FACTION_COLORS_3D[unit.faction ?? ""] ?? FACTION_COLORS_3D.default;
   const hasAtlas = unitAtlasUrl(unit) !== null;
   const initialFrame = hasAtlas ? resolveUnitFrame(unit.id) : null;
   const modelScale = UNIT_BASE_MODEL_SCALE * unitScale * cellSize;
@@ -1965,12 +1872,12 @@ function DefaultUnit({
       children: [
         isSelected && /* @__PURE__ */ jsxs("mesh", { position: [0, 0.05, 0], rotation: [-Math.PI / 2, 0, 0], children: [
           /* @__PURE__ */ jsx("ringGeometry", { args: [0.4, 0.5, 32] }),
-          /* @__PURE__ */ jsx("meshBasicMaterial", { color: "#ffff00", transparent: true, opacity: 0.8 })
+          /* @__PURE__ */ jsx("meshBasicMaterial", { color: SELECTION_RING_COLOR_3D, transparent: true, opacity: 0.8 })
         ] }),
         hasAtlas && initialFrame ? (
           /* Animated sprite-sheet billboard — single cropped frame, by state */
           /* @__PURE__ */ jsx(Billboard, { children: /* @__PURE__ */ jsx(
-            UnitSpriteBillboard,
+            SpriteBillboard3D,
             {
               sheetUrl: initialFrame.sheetUrl,
               resolveFrame: () => resolveUnitFrame(unit.id),
@@ -2006,26 +1913,21 @@ function DefaultUnit({
           ] })
         ] }),
         unit.health !== void 0 && unit.maxHealth !== void 0 && /* @__PURE__ */ jsxs("group", { position: [0, billboardHeight, 0], children: [
-          /* @__PURE__ */ jsxs("mesh", { position: [-0.25, 0, 0], children: [
-            /* @__PURE__ */ jsx("planeGeometry", { args: [0.5, 0.05] }),
-            /* @__PURE__ */ jsx("meshBasicMaterial", { color: 3355443 })
+          /* @__PURE__ */ jsxs("mesh", { position: [-0.5 / 2, 0, 0], children: [
+            /* @__PURE__ */ jsx("planeGeometry", { args: [HEALTHBAR_3D.width, HEALTHBAR_HEIGHT] }),
+            /* @__PURE__ */ jsx("meshBasicMaterial", { color: HEALTHBAR_3D.bg })
           ] }),
           /* @__PURE__ */ jsxs(
             "mesh",
             {
               position: [
-                -0.25 + 0.5 * (unit.health / unit.maxHealth) / 2,
+                -0.5 / 2 + HEALTHBAR_3D.width * (unit.health / unit.maxHealth) / 2,
                 0,
                 0.01
               ],
               children: [
-                /* @__PURE__ */ jsx("planeGeometry", { args: [0.5 * (unit.health / unit.maxHealth), 0.05] }),
-                /* @__PURE__ */ jsx(
-                  "meshBasicMaterial",
-                  {
-                    color: unit.health / unit.maxHealth > 0.5 ? 4500036 : unit.health / unit.maxHealth > 0.25 ? 11184708 : 16729156
-                  }
-                )
+                /* @__PURE__ */ jsx("planeGeometry", { args: [HEALTHBAR_3D.width * (unit.health / unit.maxHealth), HEALTHBAR_HEIGHT] }),
+                /* @__PURE__ */ jsx("meshBasicMaterial", { color: healthbarFill3D(unit.health / unit.maxHealth) })
               ]
             }
           )
@@ -2034,7 +1936,7 @@ function DefaultUnit({
     }
   );
 }
-function DefaultFeature({
+function FeatureMesh3D({
   feature,
   position,
   model,
@@ -2064,11 +1966,11 @@ function DefaultFeature({
         children: [
           /* @__PURE__ */ jsxs("mesh", { position: [0, 0.4, 0], children: [
             /* @__PURE__ */ jsx("cylinderGeometry", { args: [0.1, 0.15, 0.8, 6] }),
-            /* @__PURE__ */ jsx("meshStandardMaterial", { color: 9127187 })
+            /* @__PURE__ */ jsx("meshStandardMaterial", { color: TREE_COLORS_3D.trunk })
           ] }),
           /* @__PURE__ */ jsxs("mesh", { position: [0, 0.9, 0], children: [
             /* @__PURE__ */ jsx("coneGeometry", { args: [0.5, 0.8, 8] }),
-            /* @__PURE__ */ jsx("meshStandardMaterial", { color: 2263842 })
+            /* @__PURE__ */ jsx("meshStandardMaterial", { color: TREE_COLORS_3D.foliage })
           ] })
         ]
       }
@@ -2083,13 +1985,156 @@ function DefaultFeature({
         userData: { type: "feature", featureId: feature.id },
         children: [
           /* @__PURE__ */ jsx("dodecahedronGeometry", { args: [0.3, 0] }),
-          /* @__PURE__ */ jsx("meshStandardMaterial", { color: 8421504 })
+          /* @__PURE__ */ jsx("meshStandardMaterial", { color: ROCK_COLOR_3D })
         ]
       }
     );
   }
   return null;
 }
+function CameraController3D({
+  onCameraChange
+}) {
+  const { camera } = useThree();
+  useEffect(() => {
+    if (onCameraChange) {
+      onCameraChange({
+        x: camera.position.x,
+        y: camera.position.y,
+        z: camera.position.z
+      });
+    }
+  }, [camera.position, onCameraChange]);
+  return null;
+}
+function FollowCamera3D({
+  target,
+  offset
+}) {
+  const { camera } = useThree();
+  const look = useRef(new THREE6.Vector3(target[0], target[1], target[2]));
+  const goal = useRef(new THREE6.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]);
+    camera.position.lerp(goal.current, t);
+    look.current.lerp(goal.current.set(target[0], target[1], target[2]), t);
+    camera.lookAt(look.current);
+  });
+  return null;
+}
+function LerpedGroup3D({
+  target,
+  enabled,
+  children
+}) {
+  const ref = useRef(null);
+  const goal = useRef(new THREE6.Vector3());
+  useFrame((_, delta) => {
+    const g = ref.current;
+    if (!g) return;
+    goal.current.set(target[0], target[1], target[2]);
+    if (enabled) g.position.lerp(goal.current, Math.min(1, delta * 10));
+    else g.position.copy(goal.current);
+  });
+  return /* @__PURE__ */ jsx("group", { ref, position: target, children });
+}
+function EventMarker3D({ event, position }) {
+  return /* @__PURE__ */ jsx(Billboard, { position, children: /* @__PURE__ */ jsx(
+    Text,
+    {
+      fontSize: 0.32,
+      color: EVENT_COLORS_3D[event.type] ?? EVENT_COLORS_3D.default,
+      outlineWidth: 0.02,
+      outlineColor: "#000000",
+      anchorX: "center",
+      anchorY: "middle",
+      children: event.message ?? event.type
+    }
+  ) });
+}
+function SideScene3D({
+  player,
+  platforms,
+  worldHeight,
+  ppu,
+  playerSprite,
+  tileSprites,
+  interpolate,
+  features = [],
+  events = [],
+  assetManifest
+}) {
+  const pw = player.width ?? 32;
+  const ph = player.height ?? 48;
+  const playerPos = [
+    (player.x + pw / 2) / ppu,
+    (worldHeight - player.y - ph) / ppu,
+    0
+  ];
+  const playerH = Math.max(ph / ppu, 0.5);
+  return /* @__PURE__ */ jsxs("group", { children: [
+    platforms.map((p, i) => {
+      const platformType = p.type ?? "platform";
+      const model = tileSprites?.[platformType]?.url;
+      const topY = (worldHeight - p.y) / ppu;
+      if (model) {
+        const cells = Math.max(1, Math.round(p.width / ppu));
+        const x0 = p.x / ppu;
+        return /* @__PURE__ */ jsx("group", { children: Array.from({ length: cells }, (_, c) => /* @__PURE__ */ jsx("group", { position: [x0 + c + 0.5, topY - 0.475, 0], children: /* @__PURE__ */ jsx(ModelLoader, { url: model, scale: 0.95, fallbackGeometry: "box", castShadow: true, receiveShadow: true }) }, c)) }, `plat-${i}`);
+      }
+      return /* @__PURE__ */ jsxs(
+        "mesh",
+        {
+          position: [(p.x + p.width / 2) / ppu, topY - p.height / 2 / ppu, 0],
+          children: [
+            /* @__PURE__ */ jsx("boxGeometry", { args: [p.width / ppu, p.height / ppu, 1] }),
+            /* @__PURE__ */ jsx("meshStandardMaterial", { color: SIDE_PLATFORM_COLORS_3D[platformType] ?? SIDE_PLATFORM_COLORS_3D.default })
+          ]
+        },
+        `plat-${i}`
+      );
+    }),
+    features.map((feature, i) => {
+      const model = feature.assetUrl ?? assetManifest?.features?.[feature.type];
+      const fx = feature.x / ppu;
+      const fy = (worldHeight - feature.y) / ppu;
+      if (!model?.url) return null;
+      return /* @__PURE__ */ jsx("group", { position: [fx, fy, 0], children: /* @__PURE__ */ jsx(ModelLoader, { url: model.url, scale: 0.6, tint: feature.color, fallbackGeometry: "sphere", castShadow: true }) }, feature.id ?? `sfeat-${i}`);
+    }),
+    events.map((ev, i) => /* @__PURE__ */ jsx(
+      EventMarker3D,
+      {
+        event: ev,
+        position: [ev.x / ppu, (worldHeight - (ev.y ?? 0)) / ppu + 0.8, 0.2]
+      },
+      ev.id ?? `sev-${i}`
+    )),
+    /* @__PURE__ */ jsx(LerpedGroup3D, { target: playerPos, enabled: interpolate, children: playerSprite?.url ? /* @__PURE__ */ jsx("group", { position: [0, playerH / 2, 0], children: /* @__PURE__ */ jsx(
+      ModelLoader,
+      {
+        url: playerSprite.url,
+        scale: playerH,
+        rotation: [0, player.facingRight ? 90 : -90, 0],
+        animation: player.animation ?? "idle",
+        fallbackGeometry: "box",
+        castShadow: true
+      }
+    ) }) : /* @__PURE__ */ jsxs("mesh", { position: [0, playerH / 2, 0], children: [
+      /* @__PURE__ */ jsx("capsuleGeometry", { args: [playerH * 0.25, playerH * 0.5, 4, 8] }),
+      /* @__PURE__ */ jsx("meshStandardMaterial", { color: SIDE_PLAYER_COLOR_3D })
+    ] }) })
+  ] });
+}
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+var DEFAULT_GRID_CONFIG = {
+  cellSize: 1,
+  offsetX: 0,
+  offsetZ: 0
+};
+var TILE_TOP_OFFSET = 0.1;
 var GameCanvas3D = forwardRef(
   ({
     tiles = [],
@@ -2103,7 +2148,7 @@ var GameCanvas3D = forwardRef(
     showTileInfo = false,
     overlay = "default",
     shadows = true,
-    backgroundColor = "#1a1a2e",
+    backgroundColor = DEFAULT_BACKGROUND_3D,
     onTileClick,
     onUnitClick,
     onFeatureClick,
@@ -2437,27 +2482,25 @@ var GameCanvas3D = forwardRef(
                     }
                   },
                   children: [
-                    /* @__PURE__ */ jsx(CameraController, { onCameraChange: eventHandlers.handleCameraChange }),
+                    /* @__PURE__ */ jsx(CameraController3D, { onCameraChange: eventHandlers.handleCameraChange }),
                     (cameraMode === "follow" || cameraMode === "chase") && /* @__PURE__ */ jsx(
-                      FollowCamera,
+                      FollowCamera3D,
                       {
                         target: followTarget,
                         offset: followOffset
                       }
                     ),
-                    /* @__PURE__ */ jsx("ambientLight", { intensity: 0.6 }),
                     /* @__PURE__ */ jsx(
-                      "directionalLight",
+                      Lighting3D,
                       {
-                        position: [10, 20, 10],
-                        intensity: 0.8,
-                        castShadow: shadows,
-                        "shadow-mapSize": [2048, 2048],
-                        "shadow-bias": -4e-4,
-                        "shadow-normalBias": 0.04
+                        shadows,
+                        shadowBias: -4e-4,
+                        shadowNormalBias: 0.04,
+                        shadowCameraSize: 5,
+                        shadowCameraNear: 0.5,
+                        shadowCameraFar: 500
                       }
                     ),
-                    /* @__PURE__ */ jsx("hemisphereLight", { intensity: 0.3, color: "#87ceeb", groundColor: "#362d1d" }),
                     showGrid && /* @__PURE__ */ jsx(
                       Grid,
                       {
@@ -2472,10 +2515,10 @@ var GameCanvas3D = forwardRef(
                         ],
                         cellSize: 1,
                         cellThickness: 1,
-                        cellColor: "#444444",
+                        cellColor: GRID_COLORS_3D.cell,
                         sectionSize: 5,
                         sectionThickness: 1.5,
-                        sectionColor: "#666666",
+                        sectionColor: GRID_COLORS_3D.section,
                         fadeDistance: 50,
                         fadeStrength: 1
                       }
@@ -2483,7 +2526,7 @@ var GameCanvas3D = forwardRef(
                     player ? (
                       /* Side-scroller mode — LOLO-owned pixel space mapped to world units */
                       /* @__PURE__ */ jsx(
-                        SideScene,
+                        SideScene3D,
                         {
                           player,
                           platforms,
@@ -2509,7 +2552,7 @@ var GameCanvas3D = forwardRef(
                           return /* @__PURE__ */ jsx(CustomTileRenderer, { tile, position }, key);
                         }
                         return /* @__PURE__ */ jsx(
-                          DefaultTile,
+                          TileMesh3D,
                           {
                             tile,
                             position,
@@ -2535,7 +2578,7 @@ var GameCanvas3D = forwardRef(
                           return /* @__PURE__ */ jsx(CustomFeatureRenderer, { feature, position }, key);
                         }
                         return /* @__PURE__ */ jsx(
-                          DefaultFeature,
+                          FeatureMesh3D,
                           {
                             feature,
                             position,
@@ -2551,8 +2594,8 @@ var GameCanvas3D = forwardRef(
                           unit.z ?? unit.y ?? unit.position?.y ?? 0,
                           (unit.elevation ?? 0) + TILE_TOP_OFFSET
                         );
-                        return /* @__PURE__ */ jsx(LerpedGroup, { target: position, enabled: interpolateUnits, children: CustomUnitRenderer ? /* @__PURE__ */ jsx(CustomUnitRenderer, { unit, position: [0, 0, 0] }) : /* @__PURE__ */ jsx(
-                          DefaultUnit,
+                        return /* @__PURE__ */ jsx(LerpedGroup3D, { target: position, enabled: interpolateUnits, children: CustomUnitRenderer ? /* @__PURE__ */ jsx(CustomUnitRenderer, { unit, position: [0, 0, 0] }) : /* @__PURE__ */ jsx(
+                          UnitMesh3D,
                           {
                             unit,
                             position: [0, 0, 0],
@@ -2568,7 +2611,7 @@ var GameCanvas3D = forwardRef(
                       events.map((ev, i) => {
                         const position = gridToWorld2(ev.x, ev.z ?? ev.y ?? 0, 0);
                         return /* @__PURE__ */ jsx(
-                          EventMarker,
+                          EventMarker3D,
                           {
                             event: ev,
                             position: [position[0], position[1] + 1.4, position[2]]
@@ -2687,7 +2730,7 @@ function loadLib(key, importer) {
   return p;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React8__default.lazy(async () => {
+  const Lazy = React10__default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -2697,7 +2740,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsx(
-    React8__default.Suspense,
+    React10__default.Suspense,
     {
       fallback: /* @__PURE__ */ jsx(
         "span",
@@ -3366,7 +3409,7 @@ var Icon = ({
   const directIcon = typeof icon === "string" ? void 0 : icon;
   const effectiveName = typeof icon === "string" ? icon : name;
   const family = useIconFamily();
-  const RenderedComponent = React8__default.useMemo(() => {
+  const RenderedComponent = React10__default.useMemo(() => {
     if (directIcon) return null;
     return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
   }, [directIcon, effectiveName, family]);
@@ -3493,13 +3536,13 @@ function AtlasImage({
   style,
   "aria-hidden": ariaHidden
 }) {
-  const [, bump] = React8.useReducer((x) => x + 1, 0);
-  const canvasRef = React8.useRef(null);
+  const [, bump] = React10.useReducer((x) => x + 1, 0);
+  const canvasRef = React10.useRef(null);
   const sliced = isAtlasAsset(asset);
   const atlas = sliced ? getAtlas(asset.atlas, bump) : void 0;
   const img = sliced && asset?.url ? getSheetImage(asset.url, bump) : null;
   const rect = sliced && atlas ? subRectFor(atlas, asset.sprite) : null;
-  React8.useEffect(() => {
+  React10.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas || !img || !rect) return;
     canvas.width = rect.sw;
@@ -3623,7 +3666,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React8__default.isValidElement(value)) {
+  if (React10__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && isIconLike(value)) {
@@ -3632,7 +3675,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React8__default.forwardRef(
+var Button = React10__default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -3780,7 +3823,7 @@ var Typography = ({
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
-  return React8__default.createElement(
+  return React10__default.createElement(
     Component2,
     {
       id,
@@ -3853,7 +3896,7 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  return React8__default.createElement(
+  return React10__default.createElement(
     Component2,
     {
       className: cn(
@@ -4228,7 +4271,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React8__default.forwardRef(
+var Box = React10__default.forwardRef(
   ({
     padding,
     paddingX,
@@ -4293,7 +4336,7 @@ var Box = React8__default.forwardRef(
       onPointerDown?.(e);
     }, [hoverEvent, tapReveal, triggerProps, onPointerDown]);
     const isClickable = action || onClick;
-    return React8__default.createElement(
+    return React10__default.createElement(
       Component2,
       {
         ref,
@@ -6971,7 +7014,7 @@ var Avl3DContext = createContext(DEFAULT_CONFIG2);
 function useAvl3DConfig() {
   return useContext(Avl3DContext);
 }
-function CameraController2({ targetPosition, targetLookAt, animated }) {
+function CameraController({ targetPosition, targetLookAt, animated }) {
   const { camera } = useThree();
   const targetPosVec = useRef(new THREE6.Vector3(...targetPosition));
   const targetLookVec = useRef(new THREE6.Vector3(...targetLookAt));
@@ -7081,7 +7124,7 @@ var Avl3DViewer = ({
   const handleTraitClick = useCallback((name) => {
     dispatch({ type: "ZOOM_INTO_TRAIT", trait: name, targetPosition: { x: 0, y: 0 } });
   }, []);
-  const [highlightedTrait, setHighlightedTrait] = React8__default.useState(null);
+  const [highlightedTrait, setHighlightedTrait] = React10__default.useState(null);
   const handleTransitionClick = useCallback((index) => {
     dispatch({ type: "ZOOM_INTO_TRANSITION", transitionIndex: index, targetPosition: { x: 0, y: 0 } });
   }, []);
@@ -7168,7 +7211,7 @@ var Avl3DViewer = ({
             gap: "xs",
             align: "center",
             className: "absolute top-2 left-2 z-10 bg-surface/80 backdrop-blur rounded-md px-3 py-1.5",
-            children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React8__default.Fragment, { children: [
+            children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React10__default.Fragment, { children: [
               i > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", className: "mx-1", children: "/" }),
               i < breadcrumbs.length - 1 ? /* @__PURE__ */ jsx(
                 Box,
@@ -7243,7 +7286,7 @@ var Avl3DViewer = ({
                     }
                   ),
                   /* @__PURE__ */ jsx(
-                    CameraController2,
+                    CameraController,
                     {
                       targetPosition: cameraConfig.position,
                       targetLookAt: cameraConfig.target,