@almadar/ui 5.103.0 → 5.105.0

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

@@ -0,0 +1,21 @@
+/**
+ * FeatureMesh3D
+ *
+ * Default feature renderer for GameCanvas3D. GLB model when resolved (tinted
+ * via `feature.color`); otherwise a procedural tree or rock primitive using
+ * the `game3dTheme` default palette.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { Asset } from '@almadar/core';
+import type { IsometricFeature } from '../../shared/isometricTypes';
+import type { MinimalMouseEvent } from '../../shared/hooks/useGameCanvas3DEvents';
+export interface FeatureMesh3DProps {
+    feature: IsometricFeature;
+    position: [number, number, number];
+    model?: Asset;
+    onFeatureClick: (feature: IsometricFeature, event: MinimalMouseEvent | null) => void;
+}
+export declare function FeatureMesh3D({ feature, position, model, onFeatureClick, }: FeatureMesh3DProps): React.JSX.Element | null;
+export default FeatureMesh3D;

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

@@ -0,0 +1,35 @@
+/**
+ * GameCamera3D
+ *
+ * Camera-tracking helpers extracted from GameCanvas3D: an imperative-handle
+ * position reporter, a smooth-follow camera for `follow`/`chase` modes, and a
+ * lerped group wrapper for interpolated positions between LOLO tick snapshots.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+/** 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;
+/**
+ * Group that smooth-lerps toward its target position between LOLO tick snapshots
+ * (the 3D analogue of Canvas2D's `interpolateUnits`). Disabled → snaps.
+ */
+export declare function LerpedGroup3D({ target, enabled, children, }: {
+    target: [number, number, number];
+    enabled: boolean;
+    children: React.ReactNode;
+}): React.JSX.Element;

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

@@ -22,8 +22,16 @@ export interface Lighting3DProps {
     shadows?: boolean;
     /** Shadow map size */
     shadowMapSize?: number;
-    /** Shadow camera size */
+    /** Shadow camera size (orthographic half-extent) */
     shadowCameraSize?: number;
+    /** Shadow depth bias — reduces shadow acne */
+    shadowBias?: number;
+    /** Shadow normal bias — reduces acne on angled faces (undefined = three.js default 0) */
+    shadowNormalBias?: number;
+    /** Shadow camera near plane */
+    shadowCameraNear?: number;
+    /** Shadow camera far plane */
+    shadowCameraFar?: number;
     /** Show helper for directional light */
     showHelpers?: boolean;
 }
@@ -43,5 +51,5 @@ export interface Lighting3DProps {
  * </Canvas>
  * ```
  */
-export declare function Lighting3D({ ambientIntensity, ambientColor, directionalIntensity, directionalColor, directionalPosition, shadows, shadowMapSize, shadowCameraSize, showHelpers, }: Lighting3DProps): React.JSX.Element;
+export declare function Lighting3D({ ambientIntensity, ambientColor, directionalIntensity, directionalColor, directionalPosition, shadows, shadowMapSize, shadowCameraSize, shadowBias, shadowNormalBias, shadowCameraNear, shadowCameraFar, showHelpers, }: Lighting3DProps): React.JSX.Element;
 export default Lighting3D;

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

@@ -0,0 +1,31 @@
+/**
+ * SideScene3D
+ *
+ * Side-scroller scene: renders the LOLO-owned pixel-space `player`/`platforms`
+ * as 3D geometry. Physics stays in the board's tick (same contract as Canvas2D's
+ * SideView) — this only maps px → world units and draws. Platform and player
+ * fallback colors come from `game3dTheme` defaults.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { Asset } from '@almadar/core';
+import type { Platform, SidePlayer } from '../../2d/molecules/Canvas2D';
+import type { IsometricFeature } from '../../shared/isometricTypes';
+import type { GameEvent, GameCanvas3DAssetManifest } from './GameCanvas3D';
+export interface SideScene3DProps {
+    player: SidePlayer;
+    platforms: Platform[];
+    worldHeight: number;
+    ppu: number;
+    playerSprite?: Asset;
+    tileSprites?: Record<string, Asset>;
+    interpolate: boolean;
+    /** Side-view features (collectibles/props) — x/y are PIXELS like platforms. */
+    features?: IsometricFeature[];
+    /** Feedback markers — x/y are PIXELS in side view. */
+    events?: GameEvent[];
+    assetManifest?: GameCanvas3DAssetManifest;
+}
+export declare function SideScene3D({ player, platforms, worldHeight, ppu, playerSprite, tileSprites, interpolate, features, events, assetManifest, }: SideScene3DProps): React.JSX.Element;
+export default SideScene3D;

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

@@ -0,0 +1,28 @@
+/**
+ * TileMesh3D
+ *
+ * Default tile renderer for GameCanvas3D. GLB tile when a model is resolved
+ * (with a box fallback while loading/on error); otherwise a colored plate
+ * whose terrain color and highlight emissive come from `game3dTheme` defaults,
+ * overridable per-tile via `tile.color`.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { Asset } from '@almadar/core';
+import type { IsometricTile } from '../../shared/isometricTypes';
+import type { MinimalMouseEvent } from '../../shared/hooks/useGameCanvas3DEvents';
+export interface TileMesh3DProps {
+    /** `color` is an optional per-tile override of the terrain default. */
+    tile: IsometricTile;
+    position: [number, number, number];
+    model?: Asset;
+    isSelected: boolean;
+    isHovered: boolean;
+    isValidMove: boolean;
+    isAttackTarget: boolean;
+    onTileClick: (tile: IsometricTile, event: MinimalMouseEvent) => void;
+    onTileHover: (tile: IsometricTile | null, event: MinimalMouseEvent) => void;
+}
+export declare function TileMesh3D({ tile, position, model, isSelected, isHovered, isValidMove, isAttackTarget, onTileClick, onTileHover, }: TileMesh3DProps): React.JSX.Element;
+export default TileMesh3D;

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

@@ -0,0 +1,29 @@
+/**
+ * UnitMesh3D
+ *
+ * Default unit renderer for GameCanvas3D. Renders (in priority order) an
+ * animated sprite-sheet billboard, a GLB model, or a procedural
+ * base/body/head primitive stack — plus a selection ring and health bar.
+ * Faction color, selection ring, and health-bar palette come from
+ * `game3dTheme` defaults, overridable per-unit via `unit.tint`.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { Asset } from '@almadar/core';
+import type { IsometricUnit } from '../../shared/isometricTypes';
+import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
+import type { MinimalMouseEvent } from '../../shared/hooks/useGameCanvas3DEvents';
+export interface UnitMesh3DProps {
+    /** `tint` is an optional per-unit override of the faction default. */
+    unit: IsometricUnit;
+    position: [number, number, number];
+    model?: Asset;
+    isSelected: boolean;
+    unitScale: number;
+    cellSize: number;
+    resolveUnitFrame: (unitId: string) => ResolvedFrame | null;
+    onUnitClick: (unit: IsometricUnit, event: MinimalMouseEvent) => void;
+}
+export declare function UnitMesh3D({ unit, position, model, isSelected, unitScale, cellSize, resolveUnitFrame, onUnitClick, }: UnitMesh3DProps): React.JSX.Element;
+export default UnitMesh3D;

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

@@ -0,0 +1,55 @@
+/**
+ * game3dTheme
+ *
+ * Single source of truth for the 3D game renderer's DEFAULT palettes + sizing.
+ * These were previously baked (and in several cases duplicated) inside
+ * `GameCanvas3D.tsx`'s inline sub-renderers. The decomposed mesh components
+ * (`TileMesh3D`, `UnitMesh3D`, `FeatureMesh3D`, `EventMarker3D`, `SideScene3D`)
+ * read these as DEFAULTS so the renderer stays "dumb": every color/size can be
+ * overridden per-item via the descriptor data (`tile.color`, `unit.tint`, …)
+ * that `.lolo` computes. No React deps — pure constants, usable anywhere.
+ *
+ * Values are the exact literals that lived inline in GameCanvas3D before the
+ * decomposition, so a board that supplies no overrides renders identically.
+ *
+ * @packageDocumentation
+ */
+/** Tile fallback color by terrain kind (DefaultTile 555–560). */
+export declare const TERRAIN_COLORS_3D: Record<string, number>;
+/** Tile emissive tint by highlight state (DefaultTile 562–566). */
+export declare const HIGHLIGHT_EMISSIVE_3D: Record<string, number>;
+/** Unit fallback color by faction/team (DefaultUnit 624). */
+export declare const FACTION_COLORS_3D: Record<string, number>;
+/** Selection ring color (DefaultUnit 644). */
+export declare const SELECTION_RING_COLOR_3D = "#ffff00";
+/** Health-bar palette + geometry (DefaultUnit 690–716). */
+export declare const HEALTHBAR_3D: {
+    bg: number;
+    /** fill color thresholds: fraction > key → color */
+    high: number;
+    mid: number;
+    low: number;
+    width: number;
+};
+/** Resolve the health-bar fill color for a health fraction (0..1). */
+export declare function healthbarFill3D(fraction: number): number;
+/** Procedural tree colors (DefaultFeature 753–760). */
+export declare const TREE_COLORS_3D: {
+    trunk: number;
+    foliage: number;
+};
+/** Procedural rock color (DefaultFeature 765). */
+export declare const ROCK_COLOR_3D = 8421504;
+/** Floating event/feedback label color by event type (EventMarker 487–498). */
+export declare const EVENT_COLORS_3D: Record<string, number>;
+/** Side-scroller platform palette (SideScene SIDE_PLATFORM_COLORS 356–362). */
+export declare const SIDE_PLATFORM_COLORS_3D: Record<string, number>;
+/** Side-scroller player fallback capsule color (SideScene 470). */
+export declare const SIDE_PLAYER_COLOR_3D = "#4488ff";
+/** Grid line colors for the drei `<Grid>` (GameCanvas3D 1245/1248). */
+export declare const GRID_COLORS_3D: {
+    cell: string;
+    section: string;
+};
+/** Default scene background (GameCanvas3DProps.backgroundColor default, line 114). */
+export declare const DEFAULT_BACKGROUND_3D = "#1a1a2e";

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

@@ -27,6 +27,44 @@ export declare const DIAMOND_TOP_Y = 374;
  * Feature type → fallback color mapping (when sprites not loaded).
  */
 export declare const FEATURE_COLORS: Record<string, string>;
+/** Tile fallback color by terrain (Canvas2D 973–975 / 983–985). */
+export declare const TERRAIN_COLORS: Record<string, string>;
+/** Unit fallback + movement-ghost color by team (Canvas2D 1155–1156 / 1220–1221). */
+export declare const TEAM_COLORS: Record<string, string>;
+/** Unit drop-shadow color by team (Canvas2D 1188 / 1212). */
+export declare const TEAM_SHADOW_COLORS: Record<string, string>;
+/** Cell highlight fill by intent (Canvas2D 1016 / 1019–1020). */
+export declare const HIGHLIGHT_COLORS: {
+    hover: string;
+    validMove: string;
+    attack: string;
+};
+/** Selection ring stroke (Canvas2D 1168). */
+export declare const SELECTION_RING_COLOR = "rgba(0,200,255,0.8)";
+/** Tile grid stroke (Canvas2D 977 / 993). */
+export declare const GRID_STROKE_COLOR = "rgba(0,0,0,0.2)";
+/** Solid background fallback (Canvas2D 929). */
+export declare const BACKGROUND_FALLBACK_COLOR = "#1a1a2e";
+/** Minimap tile color by terrain (Canvas2D 873). */
+export declare const MINIMAP_TERRAIN_COLORS: Record<string, string>;
+/** Minimap unit color by team (Canvas2D 882). */
+export declare const MINIMAP_UNIT_COLORS: Record<string, string>;
+/** Unit DOM name-label background by team (Canvas2D 1609). */
+export declare const UNIT_LABEL_BG_COLORS: Record<string, string>;
+/** Side-scroller palette (Canvas2D SideView 229–259). */
+export declare const SIDE_PLATFORM_COLORS: Record<string, string>;
+export declare const SIDE_PLAYER_COLOR = "#3498db";
+export declare const SIDE_PLAYER_EYE_COLOR = "#ffffff";
+export declare const SIDE_SKY_GRADIENT_TOP = "#1a1a2e";
+export declare const SIDE_SKY_GRADIENT_BOTTOM = "#16213e";
+export declare const SIDE_GRID_COLOR = "rgba(255, 255, 255, 0.03)";
+export declare const SIDE_FX_COLOR = "#ffe066";
+export declare const SIDE_PLATFORM_BEVEL_COLOR = "rgba(255,255,255,0.15)";
+export declare const SIDE_PLATFORM_SHADOW_COLOR = "rgba(0,0,0,0.3)";
+export declare const SIDE_HAZARD_STRIPE_COLOR = "#e74c3c";
+export declare const SIDE_GOAL_GLOW_COLOR = "rgba(241, 196, 15, 0.5)";
+/** Default grid-path board background (Canvas2D bgColor default 634). */
+export declare const DEFAULT_BG_COLOR = "#5c94fc";
 /**
  * Tile layout mode. 'isometric' = 2:1 diamond projection (default).
  * 'hex' = pointy-top offset-row hex grid.

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

@@ -36,6 +36,8 @@ export interface IsometricTile {
     type?: string;
     /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
     terrainSprite?: Asset;
+    /** Fallback/override fill color (2D + 3D) — bypasses the terrain color map. `.lolo`-computed. */
+    color?: string;
     /** Whether units can traverse this tile (default true) */
     passable?: boolean;
     /** Movement cost for pathfinding (default 1) */
@@ -82,6 +84,8 @@ export type IsometricUnit = {
     team?: 'player' | 'enemy' | 'neutral';
     /** Faction for 3D rendering (player/enemy/neutral) */
     faction?: 'player' | 'enemy' | 'neutral';
+    /** Fallback/override tint color (2D + 3D) — bypasses the team/faction color map. `.lolo`-computed. */
+    tint?: string;
     /** Current health */
     health?: number;
     /** Maximum health */

package/dist/components/game/shared/lib/editorUtils.d.ts

@@ -23,7 +23,7 @@ export interface CollapsibleSectionProps {
     };
     className?: string;
 }
-export declare function CollapsibleSection({ title, expanded, onToggle, children, assetManifest, className }: CollapsibleSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function CollapsibleSection({ title, expanded, onToggle, children, assetManifest, className }: CollapsibleSectionProps): React.JSX.Element;
 export declare namespace CollapsibleSection {
     var displayName: string;
 }
@@ -36,7 +36,7 @@ export interface EditorSliderProps {
     onChange: (value: number) => void;
     className?: string;
 }
-export declare function EditorSlider({ label, value, min, max, step, onChange, className }: EditorSliderProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorSlider({ label, value, min, max, step, onChange, className }: EditorSliderProps): React.JSX.Element;
 export declare namespace EditorSlider {
     var displayName: string;
 }
@@ -50,7 +50,7 @@ export interface EditorSelectProps {
     onChange: (value: string) => void;
     className?: string;
 }
-export declare function EditorSelect({ label, value, options, onChange, className }: EditorSelectProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorSelect({ label, value, options, onChange, className }: EditorSelectProps): React.JSX.Element;
 export declare namespace EditorSelect {
     var displayName: string;
 }
@@ -60,7 +60,7 @@ export interface EditorCheckboxProps {
     onChange: (checked: boolean) => void;
     className?: string;
 }
-export declare function EditorCheckbox({ label, checked, onChange, className }: EditorCheckboxProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorCheckbox({ label, checked, onChange, className }: EditorCheckboxProps): React.JSX.Element;
 export declare namespace EditorCheckbox {
     var displayName: string;
 }
@@ -71,7 +71,7 @@ export interface EditorTextInputProps {
     placeholder?: string;
     className?: string;
 }
-export declare function EditorTextInput({ label, value, onChange, placeholder, className }: EditorTextInputProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorTextInput({ label, value, onChange, placeholder, className }: EditorTextInputProps): React.JSX.Element;
 export declare namespace EditorTextInput {
     var displayName: string;
 }
@@ -89,7 +89,7 @@ export interface StatusBarProps {
     featureCount?: number;
     className?: string;
 }
-export declare function StatusBar({ hoveredTile, mode, gridSize, unitCount, featureCount, className }: StatusBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusBar({ hoveredTile, mode, gridSize, unitCount, featureCount, className }: StatusBarProps): React.JSX.Element;
 export declare namespace StatusBar {
     var displayName: string;
 }
@@ -99,7 +99,7 @@ export interface TerrainPaletteProps {
     onSelect: (terrain: string) => void;
     className?: string;
 }
-export declare function TerrainPalette({ terrains, selectedTerrain, onSelect, className }: TerrainPaletteProps): import("react/jsx-runtime").JSX.Element;
+export declare function TerrainPalette({ terrains, selectedTerrain, onSelect, className }: TerrainPaletteProps): React.JSX.Element;
 export declare namespace TerrainPalette {
     var displayName: string;
 }
@@ -108,7 +108,7 @@ export interface EditorToolbarProps {
     onModeChange: (mode: EditorMode) => void;
     className?: string;
 }
-export declare function EditorToolbar({ mode, onModeChange, className }: EditorToolbarProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorToolbar({ mode, onModeChange, className }: EditorToolbarProps): React.JSX.Element;
 export declare namespace EditorToolbar {
     var displayName: string;
 }