@almadar/ui 5.107.0 → 5.108.0

package/dist/lib/drawable/projector.d.ts

@@ -1,5 +1,5 @@
 import type { Projector } from './contract';
-import { type TileLayout } from '../../components/game/lib/isometric';
+import { type TileLayout } from '../isometric';
 /** Projection modes the 2D host supports. `side` is handled by the side host, not here. */
 export type Projection2D = TileLayout | 'free';
 export interface Projector2DOptions {

package/dist/{components/game/three/molecules/GameCanvas3D.d.ts → lib/drawable/three/Canvas3DHost.d.ts}

@@ -1,5 +1,8 @@
 /**
- * GameCanvas3D — the thin 3D draw-host (Drawable Canvas, P6 closing).
+ * 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
@@ -23,9 +26,9 @@
 import React from 'react';
 import type { EventEmit, Asset, ScenePos } from '@almadar/core';
 import * as THREE from 'three';
-import type { DrawableNode } from '../../../../lib/drawable/paintDispatch';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../lib/isometricTypes';
-import './GameCanvas3D.css';
+import type { DrawableNode } from '../paintDispatch';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../isometricTypes';
+import './Canvas3DHost.css';
 export type { IsometricTile, IsometricUnit, IsometricFeature };
 /** Camera mode for 3D view.
  *  - `follow` tracks `followTarget` (the neutral `Camera.target`) from a fixed offset.
@@ -44,7 +47,7 @@ export type MapOrientation = 'standard' | 'rotated';
 /** Overlay control */
 export type OverlayControl = 'default' | 'hidden' | 'minimap';
 /** Props for GameCanvas3D component */
-export interface GameCanvas3DProps {
+export interface Canvas3DHostProps {
     /** Additional CSS classes */
     className?: string;
     /** Children to render inside the 3D canvas (e.g., physics objects, custom meshes) */
@@ -156,7 +159,7 @@ export interface GameCanvas3DProps {
     pixelsPerUnit?: number;
 }
 /** Imperative handle for GameCanvas3D */
-export interface GameCanvas3DHandle {
+export interface Canvas3DHostHandle {
     /** Get current camera position */
     getCameraPosition: () => THREE.Vector3 | null;
     /** Set camera position */
@@ -169,7 +172,7 @@ export interface GameCanvas3DHandle {
     screenshot: () => string | null;
 }
 /**
- * GameCanvas3D — thin 3D draw-host. Walks `drawables` through `Drawable3D`.
+ * Canvas3DHost — thin 3D draw-host. Walks `drawables` through `Drawable3D`.
  */
-export declare const GameCanvas3D: React.ForwardRefExoticComponent<GameCanvas3DProps & React.RefAttributes<GameCanvas3DHandle>>;
-export default GameCanvas3D;
+export declare const Canvas3DHost: React.ForwardRefExoticComponent<Canvas3DHostProps & React.RefAttributes<Canvas3DHostHandle>>;
+export default Canvas3DHost;

package/dist/lib/drawable/{Drawable3D.d.ts → three/Drawable3D.d.ts}

@@ -10,8 +10,8 @@
  * interface.
  */
 import React from 'react';
-import type { Projector3D } from './projector3d';
-import type { DrawableNode } from './paintDispatch';
+import type { Projector3D } from '../projector3d';
+import type { DrawableNode } from '../paintDispatch';
 export interface Drawable3DProps {
     node: DrawableNode;
     projector: Projector3D;

package/dist/lib/drawable/three/GameCamera3D.d.ts

@@ -0,0 +1,16 @@
+/** Reports the live camera position on every change (imperative handle integration). */
+export declare function CameraController3D({ onCameraChange, }: {
+    onCameraChange?: (pos: {
+        x: number;
+        y: number;
+        z: number;
+    }) => void;
+}): null;
+/**
+ * Camera that smooth-tracks a world-space target (side-view player or selected unit).
+ * OrbitControls is disabled while following — the camera is authoritative.
+ */
+export declare function FollowCamera3D({ target, offset, }: {
+    target: [number, number, number];
+    offset: [number, number, number];
+}): null;

package/dist/lib/drawable/three/game3dTheme.d.ts

@@ -0,0 +1,14 @@
+/**
+ * game3dTheme — DEFAULT palette constants for the 3D draw-host (`Canvas3DHost`).
+ * No React deps — pure constants. Only the grid + background defaults remain live;
+ * every per-item color/size comes from the drawable descriptors that `.lolo` computes.
+ *
+ * @packageDocumentation
+ */
+/** Grid line colors for the drei `<Grid>`. */
+export declare const GRID_COLORS_3D: {
+    cell: string;
+    section: string;
+};
+/** Default scene background (Canvas3DHostProps.backgroundColor default). */
+export declare const DEFAULT_BACKGROUND_3D = "#1a1a2e";

package/dist/{components/game → lib/drawable}/three/hooks/useGameCanvas3DEvents.d.ts

@@ -1,5 +1,5 @@
 import type { EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../lib/isometricTypes';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../../isometricTypes';
 export interface GameCanvas3DEventConfig {
     /** Event name for tile clicks. `tileId` is optional — the neutral draw-host emits
      *  only the scene coordinate `{ x, z }` (the FSM keys off the cell, not an id). */