@almadar/ui 5.95.0 → 5.97.0

package/dist/components/game/3d/molecules/GameCanvas3D.d.ts

@@ -14,7 +14,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { EventEmit, Asset } from '@almadar/core';
+import type { Platform, SidePlayer } from '../../2d/molecules/Canvas2D';
 import * as THREE from 'three';
 import { AssetLoader } from '../../shared/lib/AssetLoader';
 import { type MinimalMouseEvent } from '../../shared/hooks/useGameCanvas3DEvents';
@@ -30,8 +31,15 @@ export interface GameEvent {
     y?: number;
     message?: string;
 }
-/** Camera mode for 3D view */
-export type CameraMode = 'isometric' | 'perspective' | 'top-down';
+/** Camera mode for 3D view. `follow` tracks the side-view player (or the selected unit). */
+export type CameraMode = 'isometric' | 'perspective' | 'top-down' | 'follow';
+/** Per-role model manifest — the 3D analogue of Canvas2D's assetManifest (values are GLB Assets). */
+export interface GameCanvas3DAssetManifest {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+}
 /** Map orientation */
 export type MapOrientation = 'standard' | 'rotated';
 /** Overlay control */
@@ -184,6 +192,29 @@ export interface GameCanvas3DProps {
     unitScale?: number;
     /** Board zoom/group scale. Applied to the scene group. Default 0.45. */
     scale?: number;
+    /** Maps a keydown `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "LEFT", Space: "JUMP" }`.
+     *  The input layer emits `UI:<event>` so the FSM stays device-agnostic — keyboard and d-pad converge. */
+    keyMap?: Record<string, string>;
+    /** Maps a keyup `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "STOP" }`. */
+    keyUpMap?: Record<string, string>;
+    /** Side-view player (pixel coords, LOLO-owned physics) — presence switches to side-scroller rendering. */
+    player?: SidePlayer;
+    /** Side-view level geometry (pixel AABBs, same contract as Canvas2D). */
+    platforms?: Platform[];
+    /** Side-view world size in pixels. */
+    worldWidth?: number;
+    /** Side-view world size in pixels. */
+    worldHeight?: number;
+    /** Pixel→world-unit divisor for side view (default 32 = one 2D tile per 3D cell). */
+    pixelsPerUnit?: number;
+    /** Player model — named for 2D parity; in 3D the Asset's url is a GLB. */
+    playerSprite?: Asset;
+    /** Platform-type → model map — named for 2D parity; values are GLB Assets. */
+    tileSprites?: Record<string, Asset>;
+    /** Per-role model manifest; resolves tiles/units/features without explicit modelUrl/assetUrl. */
+    assetManifest?: GameCanvas3DAssetManifest;
+    /** Opt-in: smooth-lerp unit positions between LOLO tick snapshots. DEFAULT OFF. */
+    interpolateUnits?: boolean;
 }
 /** Imperative handle for GameCanvas3D */
 export interface GameCanvas3DHandle {

package/dist/components/game/3d/molecules/ModelLoader.d.ts

@@ -26,6 +26,14 @@ export interface ModelLoaderProps {
     onHover?: (hovered: boolean) => void;
     /** Fallback geometry type */
     fallbackGeometry?: 'box' | 'sphere' | 'cylinder' | 'none';
+    /**
+     * Named GLB animation clip to play (e.g. "idle", "walk") — the LOLO state machine
+     * drives this from the unit's `animation` field. Matched case-insensitively; an
+     * unknown or absent name leaves the model static (bind pose).
+     */
+    animation?: string;
+    /** Multiply the model's material colors by this CSS color (per-instance; e.g. team tint). */
+    tint?: string;
     /** Enable shadows */
     castShadow?: boolean;
     /** Receive shadows */
@@ -40,5 +48,5 @@ export interface ModelLoaderProps {
 /**
  * ModelLoader component for rendering GLB models in React Three Fiber
  */
-export declare function ModelLoader({ url, position, scale, rotation, isSelected, isHovered, onClick, onHover, fallbackGeometry, castShadow, receiveShadow, resourceBasePath, }: ModelLoaderProps): React.JSX.Element;
+export declare function ModelLoader({ url, position, scale, rotation, isSelected, isHovered, onClick, onHover, fallbackGeometry, castShadow, receiveShadow, resourceBasePath, animation, tint, }: ModelLoaderProps): React.JSX.Element;
 export default ModelLoader;

package/dist/components/game/3d/molecules/index.d.ts

@@ -20,7 +20,6 @@ export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameC
 export { AssetLoader, assetLoader, type LoadedModel, } from '../../shared/lib/AssetLoader';
 export type { UnitAnimationState } from '../../shared/spriteAnimationTypes';
 export { GameCanvas3D, type GameCanvas3DProps } from './GameCanvas3D';
-export { Canvas3D, type Canvas3DProps } from './Canvas3D';
 export { GameCanvas3DBattleTemplate, type GameCanvas3DBattleTemplateProps } from '../templates/GameCanvas3DBattleTemplate';
 export { GameCanvas3DCastleTemplate, type GameCanvas3DCastleTemplateProps } from '../templates/GameCanvas3DCastleTemplate';
 export { GameCanvas3DWorldMapTemplate, type GameCanvas3DWorldMapTemplateProps } from '../templates/GameCanvas3DWorldMapTemplate';

package/dist/components/game/shared/isometricTypes.d.ts

@@ -46,6 +46,8 @@ export interface IsometricTile {
     elevation?: number;
     /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
     modelUrl?: Asset;
+    /** Y-axis rotation in degrees (3D) — orients directional pieces (track corners, road bends) */
+    rotation?: number;
 }
 /** A unit positioned on the isometric grid */
 export type IsometricUnit = {