@almadar/ui 5.141.0 → 5.142.0

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

@@ -5,8 +5,10 @@ var providers = require('@almadar/ui/providers');
 var logger = require('@almadar/logger');
 var fiber = require('@react-three/fiber');
 var THREE10 = require('three');
+var RoomEnvironment_js = require('three/examples/jsm/environments/RoomEnvironment.js');
 var drei = require('@react-three/drei');
 var jsxRuntime = require('react/jsx-runtime');
+var postprocessing = require('@react-three/postprocessing');
 var GLTFLoader = require('three/examples/jsm/loaders/GLTFLoader');
 var SkeletonUtils = require('three/examples/jsm/utils/SkeletonUtils');
 var clsx = require('clsx');
@@ -14,7 +16,6 @@ var tailwindMerge = require('tailwind-merge');
 var OrbitControls_js = require('three/examples/jsm/controls/OrbitControls.js');
 var GLTFLoader_js = require('three/examples/jsm/loaders/GLTFLoader.js');
 var OBJLoader_js = require('three/examples/jsm/loaders/OBJLoader.js');
-var postprocessing = require('@react-three/postprocessing');
 var hooks = require('@almadar/ui/hooks');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -474,6 +475,10 @@ function Lighting3D({
   directionalIntensity = 0.8,
   directionalColor = "#ffffff",
   directionalPosition = [10, 20, 10],
+  hemisphereIntensity = 0.3,
+  hemisphereColor = "#87ceeb",
+  hemisphereGroundColor = "#362d1d",
+  points,
   shadows = true,
   shadowMapSize = 2048,
   shadowCameraSize = 20,
@@ -506,11 +511,22 @@ function Lighting3D({
     /* @__PURE__ */ jsxRuntime.jsx(
       "hemisphereLight",
       {
-        intensity: 0.3,
-        color: "#87ceeb",
-        groundColor: "#362d1d"
+        intensity: hemisphereIntensity,
+        color: hemisphereColor,
+        groundColor: hemisphereGroundColor
       }
     ),
+    points?.map((p, i) => /* @__PURE__ */ jsxRuntime.jsx(
+      "pointLight",
+      {
+        position: p.position,
+        intensity: p.intensity,
+        color: p.color,
+        distance: p.distance,
+        decay: p.decay
+      },
+      i
+    )),
     showHelpers && /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: /* @__PURE__ */ jsxRuntime.jsx(
       "directionalLightHelper",
       {
@@ -522,6 +538,36 @@ function Lighting3D({
     ) })
   ] });
 }
+function Effects3D({ post }) {
+  if (!post || !post.bloom && !post.vignette) return null;
+  const passes = [];
+  if (post.bloom) {
+    passes.push(
+      /* @__PURE__ */ jsxRuntime.jsx(
+        postprocessing.Bloom,
+        {
+          intensity: post.bloom.intensity ?? 1,
+          luminanceThreshold: post.bloom.threshold ?? 0.9,
+          luminanceSmoothing: post.bloom.smoothing ?? 0.3
+        },
+        "bloom"
+      )
+    );
+  }
+  if (post.vignette) {
+    passes.push(
+      /* @__PURE__ */ jsxRuntime.jsx(
+        postprocessing.Vignette,
+        {
+          offset: post.vignette.offset ?? 0.3,
+          darkness: post.vignette.darkness ?? 0.6
+        },
+        "vignette"
+      )
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(postprocessing.EffectComposer, { children: passes });
+}
 function CameraController3D({
   onCameraChange
 }) {
@@ -564,6 +610,77 @@ function create3DProjector(opts = {}) {
     toWorld: (pos) => [pos.x * cellSize + offsetX, pos.z ?? 0, pos.y * cellSize + offsetZ]
   };
 }
+var NUMERIC_TRACKS = [
+  "offsetX",
+  "offsetY",
+  "rotate",
+  "opacity",
+  "radiusX",
+  "radiusY",
+  "width",
+  "height",
+  "strokeWidth",
+  "strokeDashOffset",
+  "blur"
+];
+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;
+function applyShapeAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return node;
+  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 out = { ...node };
+  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;
+  };
+  for (const key of NUMERIC_TRACKS) {
+    const v = trackValue(key);
+    if (v !== void 0) out[key] = v;
+  }
+  const fill = trackValue("fill");
+  if (fill !== void 0) out.fill = fill;
+  const stroke = trackValue("stroke");
+  if (stroke !== void 0) out.stroke = stroke;
+  const shadowFrames = frames.filter((f) => f.shadow !== void 0);
+  if (shadowFrames.length > 0) {
+    const sh = trackValue("shadow");
+    if (sh !== void 0) {
+      let prevSh;
+      let nextSh;
+      for (const f of shadowFrames) {
+        if (f.at <= t) prevSh = f;
+        else if (!nextSh) nextSh = f;
+      }
+      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) };
+      } else {
+        out.shadow = sh;
+      }
+    }
+  }
+  return out;
+}
 
 // lib/atlasSlice.ts
 var atlasCache = /* @__PURE__ */ new Map();
@@ -965,8 +1082,27 @@ function Sprite3D({ node, projector, groupOpacity = 1 }) {
   return /* @__PURE__ */ jsxRuntime.jsx(SpriteBillboard, { node, world: projector.toWorld(node.position), cellSize: projector.cellSize, groupOpacity });
 }
 function Shape3D({ node, projector, groupOpacity = 1 }) {
-  if (!isValidScenePos(node.position)) return null;
-  const world = projector.toWorld(node.position);
+  const groupRef = React3__default.default.useRef(null);
+  const materialRef = React3__default.default.useRef(null);
+  const animated = isAnimatedShape(node);
+  const validPos = isValidScenePos(node.position);
+  const world = validPos ? projector.toWorld(node.position) : [0, 0, 0];
+  fiber.useFrame(({ clock }) => {
+    if (!animated || !groupRef.current) return;
+    const view = applyShapeAnimation(node, clock.elapsedTime * 1e3);
+    groupRef.current.position.set(
+      world[0] + (view.offsetX ?? 0) * projector.cellSize,
+      world[1] + 0.02,
+      world[2] + (view.offsetY ?? 0) * projector.cellSize
+    );
+    groupRef.current.rotation.y = -(view.rotate ?? 0);
+    const mat = materialRef.current;
+    if (mat) {
+      mat.opacity = (view.opacity ?? node.opacity ?? 1) * groupOpacity;
+      if (view.fill) mat.color.set(view.fill);
+    }
+  });
+  if (!validPos) return null;
   const color = node.fill ?? node.stroke ?? "#ffffff";
   let geometry;
   switch (node.shape) {
@@ -1000,12 +1136,12 @@ function Shape3D({ node, projector, groupOpacity = 1 }) {
     default:
       return null;
   }
-  return /* @__PURE__ */ jsxRuntime.jsxs("mesh", { rotation: [-Math.PI / 2, 0, 0], position: [world[0], world[1] + 0.02, world[2]], children: [
+  return /* @__PURE__ */ jsxRuntime.jsx("group", { ref: groupRef, position: [world[0], world[1] + 0.02, world[2]], children: /* @__PURE__ */ jsxRuntime.jsxs("mesh", { rotation: [-Math.PI / 2, 0, 0], children: [
     geometry,
-    /* @__PURE__ */ jsxRuntime.jsx("meshBasicMaterial", { color, transparent: true, opacity: (node.opacity ?? 1) * groupOpacity, side: THREE10__namespace.DoubleSide })
-  ] });
+    /* @__PURE__ */ jsxRuntime.jsx("meshBasicMaterial", { ref: materialRef, color, transparent: true, opacity: (node.opacity ?? 1) * groupOpacity, side: THREE10__namespace.DoubleSide })
+  ] }) });
 }
-function Text3D({ node, projector }) {
+function Text3D({ node, projector, groupOpacity = 1 }) {
   if (!isValidScenePos(node.position)) return null;
   const world = projector.toWorld(node.position);
   return /* @__PURE__ */ jsxRuntime.jsx(drei.Billboard, { position: [world[0], world[1] + 1.2, world[2]], children: /* @__PURE__ */ jsxRuntime.jsx(
@@ -1017,6 +1153,8 @@ function Text3D({ node, projector }) {
       anchorY: "middle",
       outlineWidth: 0.02,
       outlineColor: "#000000",
+      fillOpacity: groupOpacity,
+      outlineOpacity: groupOpacity,
       children: node.text
     }
   ) });
@@ -1029,8 +1167,8 @@ function clampSegments(segments) {
 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 = [
+var lerp2 = (a, b, k) => a + (b - a) * k;
+var NUMERIC_TRACKS2 = [
   "offsetX",
   "offsetY",
   "offsetZ",
@@ -1062,11 +1200,11 @@ function applyMeshAnimation(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;
   };
   const num = {};
-  for (const key of NUMERIC_TRACKS) {
+  for (const key of NUMERIC_TRACKS2) {
     const v = trackValue(key);
     if (v !== void 0) num[key] = v;
   }
@@ -1240,7 +1378,7 @@ function Drawable3D({ node, projector, groupOpacity = 1 }) {
     case "draw-shape":
       return /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node, projector, groupOpacity });
     case "draw-text":
-      return /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node, projector });
+      return /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node, projector, groupOpacity });
     case "draw-mesh":
       return /* @__PURE__ */ jsxRuntime.jsx(Mesh3D, { node, projector, groupOpacity });
     case "draw-sprite-layer":
@@ -1248,7 +1386,7 @@ function Drawable3D({ node, projector, groupOpacity = 1 }) {
     case "draw-shape-layer":
       return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node: item, projector, groupOpacity }, i)) });
     case "draw-text-layer":
-      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node: item, projector }, i)) });
+      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node: item, projector, groupOpacity }, i)) });
     case "draw-group": {
       if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
       if (node.clip) warnUnsupported3d("draw-group:clip");
@@ -1272,6 +1410,20 @@ function cn(...inputs) {
 }
 var DEFAULT_GRID_CONFIG = {
   cellSize: 1};
+function RoomEnvironment3D() {
+  const { gl, scene } = fiber.useThree(({ gl: gl2, scene: scene2 }) => ({ gl: gl2, scene: scene2 }));
+  React3.useEffect(() => {
+    const pmremGenerator = new THREE10__namespace.PMREMGenerator(gl);
+    const envTexture = pmremGenerator.fromScene(new RoomEnvironment_js.RoomEnvironment(), 0.04).texture;
+    scene.environment = envTexture;
+    return () => {
+      scene.environment = null;
+      envTexture.dispose();
+      pmremGenerator.dispose();
+    };
+  }, [gl, scene]);
+  return null;
+}
 var Canvas3DHost = React3.forwardRef(
   ({
     cameraMode = "isometric",
@@ -1297,6 +1449,8 @@ var Canvas3DHost = React3.forwardRef(
     keyUpMap,
     pixelsPerUnit,
     fov,
+    lighting,
+    post,
     children,
     drawables
   }, ref) => {
@@ -1305,6 +1459,7 @@ var Canvas3DHost = React3.forwardRef(
     const [internalError, setInternalError] = React3.useState(null);
     const eventBus = useEventBus();
     const keysRef = React3.useRef(/* @__PURE__ */ new Set());
+    const allDrawables = React3.useMemo(() => drawables ?? [], [drawables]);
     React3.useEffect(() => {
       if (!keyMap && !keyUpMap) return;
       const down = (e) => {
@@ -1338,7 +1493,7 @@ var Canvas3DHost = React3.forwardRef(
       unitAnimationEvent,
       cameraChangeEvent
     });
-    const drawnItems = React3.useMemo(() => collectDrawnItems(drawables ?? []), [drawables]);
+    const drawnItems = React3.useMemo(() => collectDrawnItems(allDrawables), [allDrawables]);
     const scenePositions = React3.useMemo(() => drawnItems.map((i) => i.pos), [drawnItems]);
     const hitIndex = React3.useMemo(() => buildHitIndex(drawnItems), [drawnItems]);
     const gridBounds = React3.useMemo(() => {
@@ -1520,9 +1675,19 @@ var Canvas3DHost = React3.forwardRef(
                       shadowNormalBias: 0.04,
                       shadowCameraSize: 5,
                       shadowCameraNear: 0.5,
-                      shadowCameraFar: 500
+                      shadowCameraFar: 500,
+                      ambientIntensity: lighting?.ambient?.intensity,
+                      ambientColor: lighting?.ambient?.color,
+                      directionalIntensity: lighting?.directional?.intensity,
+                      directionalColor: lighting?.directional?.color,
+                      directionalPosition: lighting?.directional?.position,
+                      hemisphereIntensity: lighting?.hemisphere?.intensity,
+                      hemisphereColor: lighting?.hemisphere?.color,
+                      hemisphereGroundColor: lighting?.hemisphere?.groundColor,
+                      points: lighting?.points
                     }
                   ),
+                  lighting?.environment === "room" && /* @__PURE__ */ jsxRuntime.jsx(RoomEnvironment3D, {}),
                   showGrid && /* @__PURE__ */ jsxRuntime.jsx(
                     drei.Grid,
                     {
@@ -1545,7 +1710,7 @@ var Canvas3DHost = React3.forwardRef(
                       fadeStrength: 1
                     }
                   ),
-                  drawables && drawables.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("group", { children: drawables.map((node, i) => /* @__PURE__ */ jsxRuntime.jsx(Drawable3D, { node, projector: drawableProjector }, i)) }),
+                  allDrawables.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("group", { children: allDrawables.map((node, i) => /* @__PURE__ */ jsxRuntime.jsx(Drawable3D, { node, projector: drawableProjector }, i)) }),
                   (tileClickEvent || unitClickEvent) && /* @__PURE__ */ jsxRuntime.jsxs(
                     "mesh",
                     {
@@ -1570,7 +1735,7 @@ var Canvas3DHost = React3.forwardRef(
                       ]
                     }
                   ),
-                  children,
+                  post && (post.bloom || post.vignette) ? /* @__PURE__ */ jsxRuntime.jsx(Effects3D, { post }) : null,
                   /* @__PURE__ */ jsxRuntime.jsx(
                     drei.OrbitControls,
                     {
@@ -1920,7 +2085,7 @@ var DEFAULT_OPTIONS = {
   gridSize: 20,
   assetLoader: new AssetLoader()
 };
-function useThree4(options = {}) {
+function useThree5(options = {}) {
   const opts = { ...DEFAULT_OPTIONS, ...options };
   const containerRef = React3.useRef(null);
   const canvasRef = React3.useRef(null);
@@ -5781,5 +5946,5 @@ exports.useAvl3DConfig = useAvl3DConfig;
 exports.useGameCanvas3DEvents = useGameCanvas3DEvents;
 exports.useRaycaster = useRaycaster;
 exports.useSceneGraph = useSceneGraph;
-exports.useThree = useThree4;
+exports.useThree = useThree5;
 exports.worldToGrid = worldToGrid;

package/dist/lib/drawable/three/index.d.cts

@@ -1,179 +1,12 @@
+import { C as CanvasPointLightConfig, I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-wOkfbwAh.cjs';
+export { d as Canvas3DHost, e as Canvas3DHostHandle, f as Canvas3DHostProps, d as GameCanvas3D, U as UnitAnimationState } from '../../../avl-schema-parser-wOkfbwAh.cjs';
 import * as React$1 from 'react';
 import React__default, { Component, ReactNode, ErrorInfo } from 'react';
-import { ScenePos, EventEmit, JsonObject, OrbitalSchema } from '@almadar/core';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
-import { D as DrawableNode } from '../../../paintDispatch-BQn5Lyx1.cjs';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
-import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-B8Onmfsu.cjs';
-export { U as UnitAnimationState } from '../../../avl-schema-parser-B8Onmfsu.cjs';
-
-/**
- * Canvas3DHost — the thin 3D draw-host: the `canvas` host's 3D painter backend
- * (the R3F "vessel" behind the neutral drawables), the exact 3D analogue of the
- * 2D `Painter2D` seam. Reached only via the lazy `@almadar/ui/.../game/three`
- * subpath so three.js never enters a 2D bundle.
- *
- * The 3D twin of Canvas2D: the board authors a `drawables` list (the neutral
- * `draw-*` children) and this host maps each descriptor through `Drawable3D` to a
- * three.js mesh (a raw descriptor NEVER reaches `<group>{children}` — R3F throws).
- * It owns NO game data — tiles, units, features, selection, health bars and labels
- * are all `draw-*` children composed in `.lolo`, not props here. Only view state
- * (camera, error boundary) is local.
- *
- * Camera: `isometric`/`perspective`/`top-down` frame the scene bounds (derived from
- * the drawn descriptors); `follow`/`chase` track the neutral core `Camera.target`
- * (forwarded as `followTarget`), falling back to the scene centre.
- *
- * Interaction: keyboard maps to semantic events (device-agnostic input). Pointer
- * click/hover on neutral drawables needs a per-entity id + a scene-space raycast
- * the descriptors don't yet carry — that hit-test is a tracked fork
- * (docs/Almadar_Std_Game_V2_PLAN.md); the click/hover event props are accepted but
- * not yet emitted from a raycast.
- *
- * @packageDocumentation
- */
-
-/** Camera mode for 3D view.
- *  - `follow` tracks `followTarget` (the neutral `Camera.target`) from a fixed offset.
- *  - `chase` sits behind + above the target. */
-type CameraMode$2 = 'isometric' | 'perspective' | 'top-down' | 'follow' | 'chase';
-/** Map orientation */
-type MapOrientation = 'standard' | 'rotated';
-/** Overlay control */
-type OverlayControl = 'default' | 'hidden' | 'minimap';
-/** Props for GameCanvas3D component */
-interface Canvas3DHostProps {
-    /** Additional CSS classes */
-    className?: string;
-    /** Children to render inside the 3D canvas (e.g., physics objects, custom meshes) */
-    children?: React__default.ReactNode;
-    /** Neutral drawable descriptors — the same `children` vocabulary as Canvas2D. The
-     *  host maps each through `Drawable3D` to a mesh. */
-    drawables?: DrawableNode[];
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: string | null;
-    /** Fog of war data (accepted for API parity; presentation-only). */
-    fogOfWar?: boolean[][];
-    /** Map orientation (data attribute). */
-    orientation?: MapOrientation;
-    /** Camera mode */
-    cameraMode?: CameraMode$2;
-    /** Follow-camera target in scene space (the neutral core `Camera.target`). */
-    followTarget?: ScenePos;
-    /** Show grid */
-    showGrid?: boolean;
-    /** Show coordinates overlay (accepted for API parity). */
-    showCoordinates?: boolean;
-    /** Show tile information (accepted for API parity). */
-    showTileInfo?: boolean;
-    /** Overlay control mode (data attribute). */
-    overlay?: OverlayControl;
-    /** Enable shadows */
-    shadows?: boolean;
-    /** Background color */
-    backgroundColor?: string;
-    /** Declarative event: tile click. Emitted from a ground-plane raycast → scene cell
-     *  `{ x, z }` (the FSM validates the cell). `tileId` is optional — the neutral host
-     *  has no per-tile id, and the board FSMs key off the coordinate. */
-    tileClickEvent?: EventEmit<{
-        x: number;
-        z: number;
-        tileId?: string;
-        type?: string;
-        terrain?: string;
-        elevation?: number;
-    }>;
-    /** Declarative event: unit click. Emitted `{ unitId, x, z }` when the raycast lands on a
-     *  cell whose descriptor carries an `id` (a tagged unit sprite). */
-    unitClickEvent?: EventEmit<{
-        unitId: string;
-        x: number;
-        z: number;
-        unitType?: string;
-        name?: string;
-        team?: string;
-        faction?: string;
-        health?: number;
-        maxHealth?: number;
-    }>;
-    /** Declarative event: feature click. Accepted; not yet emitted (see `tileClickEvent`). */
-    featureClickEvent?: EventEmit<{
-        featureId: string;
-        x: number;
-        z: number;
-        type?: string;
-        elevation?: number;
-    }>;
-    /** Declarative event: canvas (background) click. */
-    canvasClickEvent?: EventEmit<{
-        clientX: number;
-        clientY: number;
-        button: number;
-    }>;
-    /** Declarative event: tile hover. Accepted; not yet emitted (see `tileClickEvent`). */
-    tileHoverEvent?: EventEmit<{
-        tileId: string;
-        x: number;
-        z: number;
-        type?: string;
-    }>;
-    /** Declarative event: tile leave. */
-    tileLeaveEvent?: EventEmit<Record<string, never>>;
-    /** Declarative event: unit animation. */
-    unitAnimationEvent?: EventEmit<{
-        unitId: string;
-        state: string;
-        timestamp: number;
-    }>;
-    /** Declarative event: camera change. */
-    cameraChangeEvent?: EventEmit<{
-        position: {
-            x: number;
-            y: number;
-            z: number;
-        };
-        timestamp: number;
-    }>;
-    /** Loading message */
-    loadingMessage?: string;
-    /** Unit draw-size multiplier (accepted for API parity; sizing is drawable-authored). */
-    unitScale?: number;
-    /** Board zoom (accepted for API parity; 3D zoom is camera-driven, not group-scaled). */
-    scale?: number;
-    /** Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input). */
-    keyMap?: Record<string, string>;
-    /** Maps a keyup `e.code` → the board's SEMANTIC event. */
-    keyUpMap?: Record<string, string>;
-    /** Side-view world size in pixels (accepted for API parity). */
-    worldWidth?: number;
-    /** Side-view world size in pixels (accepted for API parity). */
-    worldHeight?: number;
-    /** Pixel→world-unit divisor for pixel-authored (side-view) scenes: world size =
-     *  scene size ÷ `pixelsPerUnit`. Omitted → 1 world unit per scene unit (grid boards). */
-    pixelsPerUnit?: number;
-    /** Perspective field of view in degrees — the neutral `Camera.fov`. Default 45. */
-    fov?: number;
-}
-/** Imperative handle for GameCanvas3D */
-interface Canvas3DHostHandle {
-    /** Get current camera position */
-    getCameraPosition: () => THREE.Vector3 | null;
-    /** Set camera position */
-    setCameraPosition: (x: number, y: number, z: number) => void;
-    /** Look at a specific point */
-    lookAt: (x: number, y: number, z: number) => void;
-    /** Reset camera to default position */
-    resetCamera: () => void;
-    /** Take a screenshot */
-    screenshot: () => string | null;
-}
-/**
- * Canvas3DHost — thin 3D draw-host. Walks `drawables` through `Drawable3D`.
- */
-declare const Canvas3DHost: React__default.ForwardRefExoticComponent<Canvas3DHostProps & React__default.RefAttributes<Canvas3DHostHandle>>;
+import { JsonObject, EventEmit, OrbitalSchema } from '@almadar/core';
+import '../../../paintDispatch-BQn5Lyx1.cjs';
 
 /**
  * Scene3D
@@ -291,6 +124,14 @@ interface Lighting3DProps {
     directionalColor?: string;
     /** Directional light position */
     directionalPosition?: [number, number, number];
+    /** Hemisphere (sky/ground) light intensity */
+    hemisphereIntensity?: number;
+    /** Hemisphere sky color */
+    hemisphereColor?: string;
+    /** Hemisphere ground color */
+    hemisphereGroundColor?: string;
+    /** Additional point lights, authored as data */
+    points?: CanvasPointLightConfig[];
     /** Enable shadows */
     shadows?: boolean;
     /** Shadow map size */
@@ -324,7 +165,7 @@ interface Lighting3DProps {
  * </Canvas>
  * ```
  */
-declare function Lighting3D({ ambientIntensity, ambientColor, directionalIntensity, directionalColor, directionalPosition, shadows, shadowMapSize, shadowCameraSize, shadowBias, shadowNormalBias, shadowCameraNear, shadowCameraFar, showHelpers, }: Lighting3DProps): React__default.JSX.Element;
+declare function Lighting3D({ ambientIntensity, ambientColor, directionalIntensity, directionalColor, directionalPosition, hemisphereIntensity, hemisphereColor, hemisphereGroundColor, points, shadows, shadowMapSize, shadowCameraSize, shadowBias, shadowNormalBias, shadowCameraNear, shadowCameraFar, showHelpers, }: Lighting3DProps): React__default.JSX.Element;
 
 /**
  * Canvas3DLoadingState
@@ -1485,4 +1326,4 @@ declare const CAMERA_POSITIONS: {
     };
 };
 
-export { AVL_3D_COLORS, AssetLoader, type AssetLoadingState, Avl3DApplicationScene, type Avl3DApplicationSceneProps, type Avl3DConfig, Avl3DContext, Avl3DEffects, type Avl3DEffectsProps, type Avl3DModelOverrides, Avl3DOrbitalScene, type Avl3DOrbitalSceneProps, Avl3DTraitScene, type Avl3DTraitSceneProps, Avl3DTransitionScene, type Avl3DTransitionSceneProps, Avl3DViewer, type Avl3DViewerProps, CAMERA_POSITIONS, Camera3D, type Camera3DHandle, type Camera3DProps, type CameraMode$1 as CameraMode, Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, Canvas3DHost, type Canvas3DHostHandle, type Canvas3DHostProps, Canvas3DLoadingState, type Canvas3DLoadingStateProps, type CullingOptions, Canvas3DHost as GameCanvas3D, type GameCanvas3DEventConfig, type Grid3DConfig, type GridCoordinate, type GridHit, type LODConfig, type LODLevel, Lighting3D, type Lighting3DProps, type LoadedModel, ModelLoader, type ModelLoaderProps, type NodeType, type Position3D, type RaycastHit, Scene3D, type Scene3DProps, type SceneGraphNode, SpatialHashGrid, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type UseRaycasterOptions, type UseRaycasterReturn, type UseSceneGraphReturn, type UseThreeOptions, type UseThreeReturn, arcCurve3D, assetLoader, calculateLODLevel, createGridHighlight, cullInstancedMesh, fibonacciSpherePositions, filterByFrustum, getCellsInRadius, getNeighbors, getVisibleIndices, goldenSpiralPositions, gridDistance, gridManhattanDistance, gridToWorld, isInBounds, isInFrustum, normalizeMouseCoordinates, orbitRingPositions, raycastToObjects, raycastToPlane, selfLoopCurve3D, treeLayout3D, updateInstanceLOD, useAssetLoader, useAvl3DConfig, useGameCanvas3DEvents, useRaycaster, useSceneGraph, useThree, worldToGrid };
+export { AVL_3D_COLORS, AssetLoader, type AssetLoadingState, Avl3DApplicationScene, type Avl3DApplicationSceneProps, type Avl3DConfig, Avl3DContext, Avl3DEffects, type Avl3DEffectsProps, type Avl3DModelOverrides, Avl3DOrbitalScene, type Avl3DOrbitalSceneProps, Avl3DTraitScene, type Avl3DTraitSceneProps, Avl3DTransitionScene, type Avl3DTransitionSceneProps, Avl3DViewer, type Avl3DViewerProps, CAMERA_POSITIONS, Camera3D, type Camera3DHandle, type Camera3DProps, type CameraMode$1 as CameraMode, Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, Canvas3DLoadingState, type Canvas3DLoadingStateProps, type CullingOptions, type GameCanvas3DEventConfig, type Grid3DConfig, type GridCoordinate, type GridHit, type LODConfig, type LODLevel, Lighting3D, type Lighting3DProps, type LoadedModel, ModelLoader, type ModelLoaderProps, type NodeType, type Position3D, type RaycastHit, Scene3D, type Scene3DProps, type SceneGraphNode, SpatialHashGrid, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type UseRaycasterOptions, type UseRaycasterReturn, type UseSceneGraphReturn, type UseThreeOptions, type UseThreeReturn, arcCurve3D, assetLoader, calculateLODLevel, createGridHighlight, cullInstancedMesh, fibonacciSpherePositions, filterByFrustum, getCellsInRadius, getNeighbors, getVisibleIndices, goldenSpiralPositions, gridDistance, gridManhattanDistance, gridToWorld, isInBounds, isInFrustum, normalizeMouseCoordinates, orbitRingPositions, raycastToObjects, raycastToPlane, selfLoopCurve3D, treeLayout3D, updateInstanceLOD, useAssetLoader, useAvl3DConfig, useGameCanvas3DEvents, useRaycaster, useSceneGraph, useThree, worldToGrid };