@almadar/ui 5.74.0 → 5.76.0

package/dist/components/game/{templates → 2d/templates}/BattleTemplate.d.ts

@@ -9,9 +9,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { BattleBoardProps } from '../organisms/BattleBoard';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 export type { BattlePhase, BattleSlotContext, } from '../organisms/BattleBoard';
 export interface BattleTemplateProps extends TemplateProps {
     /** Canvas render scale */

package/dist/components/game/{templates → 2d/templates}/CardBattlerTemplate.d.ts

@@ -6,7 +6,7 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { CardBattlerBoardProps, CardBattlerCard } from '../organisms/CardBattlerBoard';
 export interface CardBattlerTemplateProps extends TemplateProps {
     title?: string;

package/dist/components/game/{templates → 2d/templates}/CastleTemplate.d.ts

@@ -9,9 +9,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { CastleBoardProps } from '../organisms/CastleBoard';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 export type { CastleSlotContext } from '../organisms/CastleBoard';
 export interface CastleTemplateProps extends TemplateProps {
     /** Canvas render scale */

package/dist/components/game/{templates → 2d/templates}/CityBuilderTemplate.d.ts

@@ -6,7 +6,7 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { CityBuilderBoardProps, CityBuilderTile, CityBuilderBuilding, CityBuilderBuildType } from '../organisms/CityBuilderBoard';
 export interface CityBuilderTemplateProps extends TemplateProps {
     title?: string;

package/dist/components/game/{templates → 2d/templates}/GameTemplate.d.ts

@@ -6,7 +6,7 @@
  * **Atomic Design**: Composed using Box, Typography, and Layout molecules/atoms.
  */
 import React from "react";
-import type { TemplateProps } from "../../core/templates/types";
+import type { TemplateProps } from "../../../core/templates/types";
 export interface GameControls {
     onPlay?: () => void;
     onPause?: () => void;

package/dist/components/game/{templates → 2d/templates}/PlatformerTemplate.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { Asset } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { PlatformerBoardProps } from '../organisms/PlatformerBoard';
 export interface PlatformerTemplateProps extends TemplateProps {
     /** Level geometry forwarded to PlatformerBoard */

package/dist/components/game/{templates → 2d/templates}/RoguelikeTemplate.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { RoguelikeBoardProps } from '../organisms/RoguelikeBoard';
-import type { IsometricTile } from '../organisms/types/isometric';
+import type { IsometricTile } from '../../shared/isometricTypes';
 export interface RoguelikeTemplateProps extends TemplateProps {
     scale?: number;
     unitScale?: number;

package/dist/components/game/{templates → 2d/templates}/TopDownShooterTemplate.d.ts

@@ -6,7 +6,7 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { TopDownShooterBoardProps, ShooterPlayer, ShooterEnemy, ShooterProjectile } from '../organisms/TopDownShooterBoard';
 export interface TopDownShooterTemplateProps extends TemplateProps {
     title?: string;

package/dist/components/game/{templates → 2d/templates}/TowerDefenseTemplate.d.ts

@@ -5,7 +5,7 @@
  * All game state is driven by the entity prop (passed through from the orbital trait).
  */
 import React from 'react';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { TowerDefenseTile, TowerDefensePathPoint, TowerDefenseTower } from '../organisms/TowerDefenseBoard';
 import type { EventEmit } from '@almadar/core';
 export interface TowerDefenseTemplateProps extends TemplateProps {

package/dist/components/game/{templates → 2d/templates}/VisualNovelTemplate.d.ts

@@ -6,7 +6,7 @@
  */
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { TemplateProps } from '../../core/templates/types';
+import type { TemplateProps } from '../../../core/templates/types';
 import type { VisualNovelNode } from '../organisms/VisualNovelBoard';
 export interface VisualNovelTemplateProps extends TemplateProps {
     title?: string;

package/dist/components/game/{templates → 2d/templates}/WorldMapTemplate.d.ts

@@ -10,8 +10,8 @@
  */
 import React from 'react';
 import type { WorldMapBoardProps } from '../organisms/WorldMapBoard';
-import type { TemplateProps } from '../../core/templates/types';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { TemplateProps } from '../../../core/templates/types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 export type { WorldMapSlotContext } from '../organisms/WorldMapBoard';
 export interface WorldMapTemplateProps extends TemplateProps {
     /** Canvas render scale */

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

@@ -0,0 +1,45 @@
+import React from 'react';
+import type { EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+/** Props for Canvas3D — cleaned prop surface per docs/Almadar_Std_Game.md §4.4 */
+export interface Canvas3DProps {
+    tiles?: IsometricTile[];
+    units?: IsometricUnit[];
+    features?: IsometricFeature[];
+    cameraMode?: 'isometric' | 'perspective' | 'top-down';
+    shadows?: boolean;
+    showGrid?: boolean;
+    selectedUnitId?: string | null;
+    validMoves?: Array<{
+        x: number;
+        z: number;
+    }>;
+    attackTargets?: Array<{
+        x: number;
+        z: number;
+    }>;
+    tileClickEvent?: EventEmit<{
+        tileId: string;
+        x: number;
+        z: number;
+    }>;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+        x: number;
+        z: number;
+    }>;
+    unitScale?: number;
+    className?: string;
+    isLoading?: boolean;
+    error?: string | null;
+}
+/**
+ * Canvas3D — pure 3D renderer.  Game logic lives in LOLO; this component
+ * receives pre-computed state via props and emits events via EventEmit props.
+ *
+ * Wraps GameCanvas3D under the canonical §4.4 prop surface.
+ * GameCanvas3D is preserved for the Wave 4 migration; Canvas3D is the
+ * stable public name going forward.
+ */
+export declare function Canvas3D(props: Canvas3DProps): React.JSX.Element;
+export default Canvas3D;

package/dist/components/game/{molecules → 3d/molecules}/GameCanvas3D.d.ts

@@ -16,9 +16,9 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
 import * as THREE from 'three';
-import { AssetLoader } from './three/loaders/AssetLoader';
-import { type MinimalMouseEvent } from './three/hooks/useGameCanvas3DEvents';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import { AssetLoader } from '../../shared/lib/AssetLoader';
+import { type MinimalMouseEvent } from '../../shared/hooks/useGameCanvas3DEvents';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 import './GameCanvas3D.css';
 export type { IsometricTile, IsometricUnit, IsometricFeature };
 /** Game event for canvas display */

package/dist/components/game/{molecules/three → 3d/molecules}/index.d.ts

@@ -1,35 +1,36 @@
 /**
- * Three.js Subdirectory
+ * Game 3D (three.js)
  *
- * Core Three.js components, hooks, loaders, and utilities for GameCanvas3D.
+ * Three.js components, hooks, loaders, renderers, and the GameCanvas3D family.
+ * Code-split behind the `@almadar/ui/components/molecules/game/three` subpath.
  *
  * @packageDocumentation
  */
 export { Scene3D, type Scene3DProps } from './Scene3D';
 export { Camera3D, type Camera3DProps, type Camera3DHandle, type CameraMode } from './Camera3D';
 export { Lighting3D, type Lighting3DProps } from './Lighting3D';
-export { Canvas3DLoadingState, type Canvas3DLoadingStateProps, } from './components/Canvas3DLoadingState';
-export { Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, } from './components/Canvas3DErrorBoundary';
-export { ModelLoader, type ModelLoaderProps, } from './components/ModelLoader';
-export { PhysicsObject3D, usePhysics3DController, type PhysicsObject3DProps, type Physics3DState, } from './components/PhysicsObject3D';
-export { useThree, type UseThreeOptions, type UseThreeReturn, } from './hooks/useThree';
-export { useAssetLoader, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type AssetLoadingState, } from './hooks/useAssetLoader';
-export { useSceneGraph, type UseSceneGraphReturn, type SceneGraphNode, type NodeType, } from './hooks/useSceneGraph';
-export { useRaycaster, type UseRaycasterOptions, type UseRaycasterReturn, type RaycastHit, type GridHit, } from './hooks/useRaycaster';
-export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type GameCanvas3DEventConfig, } from './hooks/useGameCanvas3DEvents';
-export { AssetLoader, assetLoader, type LoadedModel, } from './loaders/AssetLoader';
-export { TileRenderer, UnitRenderer, FeatureRenderer, FeatureRenderer3D, preloadFeatures, type TileRendererProps, type UnitRendererProps, type FeatureRendererProps, type FeatureRenderer3DProps, type UnitAnimationState, } from './renderers';
-export { GameCanvas3D, type GameCanvas3DProps } from '../GameCanvas3D';
-export { GameCanvas3DBattleTemplate, type GameCanvas3DBattleTemplateProps } from '../../templates/GameCanvas3DBattleTemplate';
-export { GameCanvas3DCastleTemplate, type GameCanvas3DCastleTemplateProps } from '../../templates/GameCanvas3DCastleTemplate';
-export { GameCanvas3DWorldMapTemplate, type GameCanvas3DWorldMapTemplateProps } from '../../templates/GameCanvas3DWorldMapTemplate';
-export { gridToWorld, worldToGrid, raycastToPlane, raycastToObjects, gridDistance, gridManhattanDistance, getNeighbors, isInBounds, getCellsInRadius, createGridHighlight, normalizeMouseCoordinates, type Grid3DConfig, type GridCoordinate, } from './utils/grid3D';
+export { Canvas3DLoadingState, type Canvas3DLoadingStateProps, } from './Canvas3DLoadingState';
+export { Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, } from './Canvas3DErrorBoundary';
+export { ModelLoader, type ModelLoaderProps, } from './ModelLoader';
+export { useThree, type UseThreeOptions, type UseThreeReturn, } from '../../shared/hooks/useThree';
+export { useAssetLoader, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type AssetLoadingState, } from '../../shared/hooks/useAssetLoader';
+export { useSceneGraph, type UseSceneGraphReturn, type SceneGraphNode, type NodeType, } from '../../shared/hooks/useSceneGraph';
+export { useRaycaster, type UseRaycasterOptions, type UseRaycasterReturn, type RaycastHit, type GridHit, } from '../../shared/hooks/useRaycaster';
+export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type GameCanvas3DEventConfig, } from '../../shared/hooks/useGameCanvas3DEvents';
+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';
+export { gridToWorld, worldToGrid, raycastToPlane, raycastToObjects, gridDistance, gridManhattanDistance, getNeighbors, isInBounds, getCellsInRadius, createGridHighlight, normalizeMouseCoordinates, type Grid3DConfig, type GridCoordinate, } from '../../shared/lib/grid3D';
 export { Avl3DViewer, type Avl3DViewerProps } from '../../../avl/organisms/Avl3DViewer';
 export { Avl3DApplicationScene, type Avl3DApplicationSceneProps } from '../../../avl/organisms/Avl3DApplicationScene';
 export { Avl3DOrbitalScene, type Avl3DOrbitalSceneProps } from '../../../avl/organisms/Avl3DOrbitalScene';
 export { Avl3DTraitScene, type Avl3DTraitSceneProps } from '../../../avl/organisms/Avl3DTraitScene';
 export { Avl3DTransitionScene, type Avl3DTransitionSceneProps } from '../../../avl/organisms/Avl3DTransitionScene';
 export { Avl3DEffects, type Avl3DEffectsProps } from '../../../avl/organisms/Avl3DEffects';
-export { Avl3DContext, useAvl3DConfig, type Avl3DModelOverrides, type Avl3DConfig } from '../../../avl/organisms/avl-3d-context';
-export { AVL_3D_COLORS, CAMERA_POSITIONS, goldenSpiralPositions, fibonacciSpherePositions, orbitRingPositions, arcCurve3D, selfLoopCurve3D, treeLayout3D, type Position3D, } from '../../../avl/organisms/avl-3d-layout';
-export { isInFrustum, filterByFrustum, getVisibleIndices, calculateLODLevel, updateInstanceLOD, cullInstancedMesh, SpatialHashGrid, type CullingOptions, type LODLevel, type LODConfig, } from './utils/culling';
+export { Avl3DContext, useAvl3DConfig, type Avl3DModelOverrides, type Avl3DConfig } from '../../../avl/providers/avl-3d-context';
+export { AVL_3D_COLORS, CAMERA_POSITIONS, goldenSpiralPositions, fibonacciSpherePositions, orbitRingPositions, arcCurve3D, selfLoopCurve3D, treeLayout3D, type Position3D, } from '../../../avl/lib/avl-3d-layout';
+export { isInFrustum, filterByFrustum, getVisibleIndices, calculateLODLevel, updateInstanceLOD, cullInstancedMesh, SpatialHashGrid, type CullingOptions, type LODLevel, type LODConfig, } from '../../shared/lib/culling';

package/dist/components/game/{organisms → 3d/organisms}/GameBoard3D.d.ts

@@ -12,7 +12,7 @@
 import React from 'react';
 import type { EventEmit, EntityRow } from '@almadar/core';
 import type { CameraMode } from '../molecules/GameCanvas3D';
-import type { IsometricTile, IsometricFeature } from './types/isometric';
+import type { IsometricTile, IsometricFeature } from '../../shared/isometricTypes';
 export interface GameBoard3DProps {
     /** Entity row carrying all gameplay state (controlled). */
     entity?: EntityRow | readonly EntityRow[];

package/dist/components/game/{templates → 3d/templates}/GameCanvas3DBattleTemplate.d.ts

@@ -18,9 +18,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../organisms/types/isometric';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from './game3dAssetManifest';
+import type { IsometricTile, IsometricFeature } from '../../shared/isometricTypes';
+import type { TemplateProps } from '../../../core/templates/types';
+import { type Game3DAssetManifest } from '../../shared/lib/game3dAssetManifest';
 export interface GameCanvas3DBattleTemplateProps extends TemplateProps {
     /** Fallback tile data when no entity is present (layout only — model URLs resolve from assetManifest) */
     tiles?: IsometricTile[];

package/dist/components/game/{templates → 3d/templates}/GameCanvas3DCastleTemplate.d.ts

@@ -19,9 +19,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../organisms/types/isometric';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from './game3dAssetManifest';
+import type { IsometricTile, IsometricFeature } from '../../shared/isometricTypes';
+import type { TemplateProps } from '../../../core/templates/types';
+import { type Game3DAssetManifest } from '../../shared/lib/game3dAssetManifest';
 export interface GameCanvas3DCastleTemplateProps extends TemplateProps {
     /** Fallback tile data when no entity is present (layout only — model URLs resolve from assetManifest) */
     tiles?: IsometricTile[];

package/dist/components/game/{templates → 3d/templates}/GameCanvas3DWorldMapTemplate.d.ts

@@ -20,9 +20,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../organisms/types/isometric';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from './game3dAssetManifest';
+import type { IsometricTile, IsometricFeature } from '../../shared/isometricTypes';
+import type { TemplateProps } from '../../../core/templates/types';
+import { type Game3DAssetManifest } from '../../shared/lib/game3dAssetManifest';
 export interface GameCanvas3DWorldMapTemplateProps extends TemplateProps {
     /** Fallback tile data when no entity is present (layout only — model URLs resolve from assetManifest) */
     tiles?: IsometricTile[];

package/dist/components/game/{organisms/utils → shared}/canvasEffects.d.ts

@@ -6,7 +6,7 @@
  *
  * Ported from trait-wars and generalized for any almadar-ui client.
  */
-import type { CanvasParticle, CanvasSequence, CanvasOverlay, CanvasEffectState, ParticleEmitterConfig, SequenceConfig, OverlayConfig } from '../types/effects';
+import type { CanvasParticle, CanvasSequence, CanvasOverlay, CanvasEffectState, ParticleEmitterConfig, SequenceConfig, OverlayConfig } from './effects';
 /**
  * Draw a sprite tinted with an RGB color onto the main canvas.
  * Uses offscreen canvas with `source-atop` compositing to recolor

package/dist/components/game/{organisms/utils → shared}/combatPresets.d.ts

@@ -6,7 +6,7 @@
  *
  * Generalized from trait-wars: uses EffectAssetManifest instead of TraitWarsAssetManifest.
  */
-import type { CombatActionType, CombatPreset, EffectAssetManifest } from '../types/effects';
+import type { CombatActionType, CombatPreset, EffectAssetManifest } from './effects';
 type PresetFactory = (originX: number, originY: number) => CombatPreset;
 /**
  * Create combat preset factories from an effect asset manifest.

package/dist/components/game/{organisms/types → shared}/game.d.ts

@@ -12,7 +12,7 @@ export interface GameUnit {
     id: string;
     name: string;
     characterType: string;
-    team: 'player' | 'enemy';
+    team: 'player' | 'enemy' | 'neutral';
     position: Position;
     health: number;
     maxHealth: number;
@@ -38,7 +38,7 @@ export interface GameState {
     units: Record<string, GameUnit>;
     currentPhase: GamePhase;
     currentTurn: number;
-    activeTeam: 'player' | 'enemy';
+    activeTeam: 'player' | 'enemy' | 'neutral';
     selectedUnitId?: string;
     validMoves: Position[];
     attackTargets: Position[];

package/dist/components/game/{molecules/three → shared}/hooks/useAssetLoader.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { AssetLoader, LoadedModel } from '../loaders/AssetLoader';
+import { AssetLoader, LoadedModel } from '../lib/AssetLoader';
 export interface UseAssetLoaderOptions {
     /** URLs to preload on mount */
     preloadUrls?: string[];

package/dist/components/game/{organisms → shared}/hooks/useBattleState.d.ts

@@ -1,5 +1,5 @@
 import type { EventEmit, EntityRow } from '@almadar/core';
-import type { BattlePhase } from '../BattleBoard';
+import type { BattlePhase } from '../../2d/organisms/BattleBoard';
 export interface BattleStateEventConfig {
     tileClickEvent?: EventEmit<{
         x: number;

package/dist/components/game/{organisms → shared}/hooks/useCamera.d.ts

@@ -1,4 +1,4 @@
-import type { CameraState } from '../types/isometric';
+import type { CameraState } from '../isometricTypes';
 interface CameraResult {
     /** Mutable camera state ref (x, y, zoom) */
     cameraRef: React.MutableRefObject<CameraState>;

package/dist/components/game/{organisms → shared/hooks}/useCanvasEffects.d.ts

@@ -1,5 +1,5 @@
 import type { AssetUrl } from '@almadar/core';
-import type { CombatActionType, EffectAssetManifest } from './types/effects';
+import type { CombatActionType, EffectAssetManifest } from '../effects';
 export interface UseCanvasEffectsOptions {
     /** Effect asset manifest (baseUrl + particles + animations) */
     manifest: EffectAssetManifest;

package/dist/components/game/{molecules/three → shared}/hooks/useGameCanvas3DEvents.d.ts

@@ -1,5 +1,5 @@
 import type { EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../../organisms/types/isometric';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../isometricTypes';
 export interface GameCanvas3DEventConfig {
     /** Event name for tile clicks */
     tileClickEvent?: EventEmit<{

package/dist/components/game/{molecules/three → shared}/hooks/useThree.d.ts

@@ -1,6 +1,6 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
-import { AssetLoader } from '../loaders/AssetLoader';
+import { AssetLoader } from '../lib/AssetLoader';
 export type CameraMode = 'isometric' | 'perspective' | 'top-down';
 export interface UseThreeOptions {
     /** Camera mode for viewing the scene */

package/dist/components/game/{molecules → shared/hooks}/useUnitSpriteAtlas.d.ts

@@ -1,5 +1,5 @@
-import type { IsometricUnit } from '../organisms/types/isometric';
-import type { ResolvedFrame } from '../organisms/types/spriteAnimation';
+import type { IsometricUnit } from '../isometricTypes';
+import type { ResolvedFrame } from '../spriteAnimationTypes';
 /**
  * Resolve the sprite-sheet atlas-JSON URL for a unit.
  *

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

@@ -0,0 +1,21 @@
+/**
+ * Game Shared (dimension-agnostic)
+ *
+ * Render DTO types, pure projection/animation utils, and the shared image cache hook.
+ *
+ * @packageDocumentation
+ */
+export type { IsometricTile, IsometricUnit, IsometricFeature, CameraState, } from './isometricTypes';
+export type { AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls, AnimationDef, } from './spriteAnimationTypes';
+export { createInitialGameState, calculateValidMoves, calculateAttackTargets, } from './game';
+export type { Position, GameUnit, UnitTrait, BoardTile, GamePhase, GameState, GameAction, } from './game';
+export * from './effects';
+export * from './boardEntity';
+export * from './makeAsset';
+export { useImageCache } from './useImageCache';
+export { isoToScreen, screenToIso, TILE_WIDTH, TILE_HEIGHT, FLOOR_HEIGHT, DIAMOND_TOP_Y, FEATURE_COLORS, } from './isometric';
+export type { TileLayout } from './isometric';
+export { inferDirection, resolveSheetDirection, getCurrentFrame, resolveFrame, createUnitAnimationState, transitionAnimation, tickAnimationState, } from './spriteAnimation';
+export { SPRITE_SHEET_LAYOUT, SHEET_COLUMNS } from './spriteSheetConstants';
+export * from './combatPresets';
+export * from './canvasEffects';

package/dist/components/game/{organisms/types/isometric.d.ts → shared/isometricTypes.d.ts}

@@ -1,5 +1,6 @@
 import type { Asset } from '@almadar/core';
-import type { AnimationName } from './spriteAnimation';
+import type { AnimationName } from './spriteAnimationTypes';
+import type { UnitTrait } from './game';
 /**
  * Isometric Game Types
  *
@@ -84,12 +85,7 @@ export type IsometricUnit = {
     /** Maximum health */
     maxHealth?: number;
     /** Trait attachments for state display */
-    traits?: {
-        name: string;
-        currentState: string;
-        states: string[];
-        cooldown: number;
-    }[];
+    traits?: UnitTrait[];
     /** Previous position for movement trail ghost */
     previousPosition?: {
         x: number;

package/dist/components/game/{organisms/editor → shared/lib}/editorUtils.d.ts

@@ -8,6 +8,7 @@
  * They use native HTML inputs wrapped in Box for lightweight editor UX.
  */
 import React from 'react';
+import type { Asset } from '@almadar/core';
 export type EditorMode = 'select' | 'paint' | 'unit' | 'feature' | 'erase';
 export declare const TERRAIN_COLORS: Record<string, string>;
 export declare const FEATURE_TYPES: readonly ["goldMine", "resonanceCrystal", "traitCache", "salvageYard", "portal", "battleMarker", "treasure", "castle"];
@@ -16,9 +17,13 @@ export interface CollapsibleSectionProps {
     expanded: boolean;
     onToggle: () => void;
     children: React.ReactNode;
+    /** Optional per-semantic-key asset overrides for icons (expand/collapse). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
     className?: string;
 }
-export declare function CollapsibleSection({ title, expanded, onToggle, children, className }: CollapsibleSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function CollapsibleSection({ title, expanded, onToggle, children, assetManifest, className }: CollapsibleSectionProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace CollapsibleSection {
     var displayName: string;
 }

package/dist/components/game/{templates → shared/lib}/game3dAssetManifest.d.ts

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 import type { Asset, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricFeature } from '../organisms/types/isometric';
+import type { IsometricTile, IsometricFeature } from '../isometricTypes';
 /** GLB model assets for a 3D board, keyed by terrain "kind" and (optionally) feature type. */
 export interface Game3DAssetManifest {
     /** Floor model assets by terrain kind ('wall' | 'dirt' | 'open'). */

package/dist/components/game/{organisms/physics-sim/presets → shared/lib}/mechanics.d.ts

@@ -1,4 +1,4 @@
-import type { PhysicsPreset } from './types';
+import type { PhysicsPreset } from './physicsTypes';
 export declare const projectileMotion: PhysicsPreset;
 export declare const pendulum: PhysicsPreset;
 export declare const springOscillator: PhysicsPreset;

package/dist/components/game/{organisms/physics-sim/presets/index.d.ts → shared/lib/physicsPresets.d.ts}

@@ -1,4 +1,4 @@
-export type { PhysicsPreset, PhysicsBody, PhysicsConstraint } from './types';
+export type { PhysicsPreset, PhysicsBody, PhysicsConstraint } from './physicsTypes';
 export { projectileMotion, pendulum, springOscillator } from './mechanics';
-import type { PhysicsPreset } from './types';
+import type { PhysicsPreset } from './physicsTypes';
 export declare const ALL_PRESETS: PhysicsPreset[];

package/dist/components/game/{organisms/puzzles/event-handler → shared/lib}/puzzleObject.d.ts

@@ -9,7 +9,7 @@
  * @packageDocumentation
  */
 import type { EntityWith } from '@almadar/core';
-import type { RuleDefinition, RuleOption } from './RuleEditor';
+import type { RuleDefinition, RuleOption } from '../../2d/organisms/RuleEditor';
 type PuzzleObjectRow = EntityWith<{
     name?: string;
     icon?: string;

package/dist/components/game/{organisms → shared/providers}/GameAudioProvider.d.ts

@@ -11,14 +11,14 @@
  * The provider also exposes `muted`/`setMuted` and `masterVolume`/
  * `setMasterVolume` via the `GameAudioContext` for toggle buttons.
  *
- * Closed-circuit props (`className`, `isLoading`, `error`, `entity`) are
+ * Closed-circuit props (`className`, `isLoading`, `error`) are
  * accepted but intentionally unused — the provider renders only its children.
  *
  * @packageDocumentation
  */
 import React from 'react';
-import { type AudioManifest, type GameAudioControls } from './hooks/useGameAudio';
-import type { UiError } from '../../core/atoms/types';
+import { type AudioManifest, type GameAudioControls } from '../hooks/useGameAudio';
+import type { UiError } from '../../../core/atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
 /**
@@ -45,7 +45,6 @@ export interface GameAudioProviderProps {
     className?: string;
     isLoading?: boolean;
     error?: UiError | null;
-    entity?: string;
 }
 export declare function GameAudioProvider({ manifest, baseUrl, children, initialMuted, }: GameAudioProviderProps): React.JSX.Element;
 export declare namespace GameAudioProvider {

package/dist/components/game/{organisms/utils → shared}/spriteAnimation.d.ts

@@ -7,7 +7,7 @@
  *
  * @packageDocumentation
  */
-import type { AnimationDef, AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls } from '../types/spriteAnimation';
+import type { AnimationDef, AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls } from './spriteAnimationTypes';
 /**
  * Infer facing direction from a movement delta on the isometric grid.
  * dx/dy are tile coordinate deltas (not screen pixels).

package/dist/components/game/{organisms/utils → shared}/spriteSheetConstants.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-import type { AnimationDef, AnimationName } from '../types/spriteAnimation';
+import type { AnimationDef, AnimationName } from './spriteAnimationTypes';
 /** Number of columns in a sprite sheet (frames per row) */
 export declare const SHEET_COLUMNS = 8;
 /**