@almadar/ui 5.75.0 → 5.76.0

package/dist/components/game/2d/{SokobanBoard.d.ts → organisms/SokobanBoard.d.ts}

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { Canvas2DProps } from './Canvas2D';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { Canvas2DProps } from '../molecules/Canvas2D';
 export interface SokobanBoardProps extends DisplayStateProps {
     /** Grid tiles (floor, wall, target) */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{SpaceShmupBoard.d.ts → organisms/SpaceShmupBoard.d.ts}

@@ -1,8 +1,15 @@
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { Canvas2DProps } from './Canvas2D';
+import type { Asset, AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+/** Asset manifest shape for SpaceShmupBoard. */
+type SpaceShmupAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface SpaceShmupBoardProps extends DisplayStateProps {
     /** Space terrain tiles filling the grid */
     tiles?: IsometricTile[];
@@ -10,8 +17,8 @@ export interface SpaceShmupBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (asteroids, power-ups, etc.) on the board */
     features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
-    assetManifest?: Canvas2DProps['assetManifest'];
+    /** Asset sprite manifest */
+    assetManifest?: SpaceShmupAssetManifest;
     /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

package/dist/components/game/2d/{SpaceStationBoard.d.ts → organisms/SpaceStationBoard.d.ts}

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { Canvas2DProps } from './Canvas2D';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { Canvas2DProps } from '../molecules/Canvas2D';
 export interface SpaceStationBoardProps extends DisplayStateProps {
     /** Isometric grid tiles */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{SportsBoard.d.ts → organisms/SportsBoard.d.ts}

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { Canvas2DProps } from './Canvas2D';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { Canvas2DProps } from '../molecules/Canvas2D';
 export interface SportsBoardProps extends DisplayStateProps {
     /** Court/field terrain tiles */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{StateArchitectBoard.d.ts → organisms/StateArchitectBoard.d.ts}

@@ -9,7 +9,7 @@
  */
 import React from 'react';
 import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A kid-built transition in the visual graph editor (UI value DTO). */
 export interface StateArchitectTransition {
     id: string;

package/dist/components/game/2d/{StateNode.d.ts → organisms/StateNode.d.ts}

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type Point } from '../../core/atoms';
+import { type Point } from '../../../core/atoms/index';
 export interface StateNodeProps {
     /** State name */
     name: string;

package/dist/components/game/2d/{TanksBoard.d.ts → organisms/TanksBoard.d.ts}

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { Canvas2DProps } from './Canvas2D';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { Canvas2DProps } from '../molecules/Canvas2D';
 export interface TanksBoardProps extends DisplayStateProps {
     /** Ground/sand terrain tiles */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{TowerDefenseBoard.d.ts → organisms/TowerDefenseBoard.d.ts}

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** Manifest of per-kind sprite maps (UI value DTO). */
 type TowerDefenseAssetManifest = {
     terrains?: Record<string, Asset>;

package/dist/components/game/2d/{TraitSlot.d.ts → organisms/TraitSlot.d.ts}

@@ -20,7 +20,7 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
-import type { UiError } from '../../core/atoms/types';
+import type { UiError } from '../../../core/atoms/types';
 /** Data shape for a slot's equipped item */
 export type SlotItemData = {
     id: string;

package/dist/components/game/2d/{TraitStateViewer.d.ts → organisms/TraitStateViewer.d.ts}

@@ -10,8 +10,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type StateStyle } from './StateIndicator';
-import type { UiError } from '../../core/atoms/types';
+import { type StateStyle } from '../atoms/StateIndicator';
+import type { UiError } from '../../../core/atoms/types';
 export type TraitTransition = {
     from: string;
     to: string;

package/dist/components/game/2d/{TransitionArrow.d.ts → organisms/TransitionArrow.d.ts}

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { Point } from '../../core/atoms/types';
+import type { Point } from '../../../core/atoms/types';
 export interface TransitionArrowProps {
     /** Start position (center of from-node) */
     from: Point;

package/dist/components/game/2d/{UncontrolledBattleBoard.d.ts → organisms/UncontrolledBattleBoard.d.ts}

@@ -16,7 +16,7 @@
 import * as React from 'react';
 import type { EntityRow, EventEmit } from '@almadar/core';
 import { type BattleBoardProps } from './BattleBoard';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 export interface UncontrolledBattleBoardProps extends Omit<BattleBoardProps, 'entity'> {
     entity?: EntityRow | readonly EntityRow[];
     /** Direct tile data — takes priority over entity-derived tiles. */

package/dist/components/game/2d/{VisualNovelBoard.d.ts → organisms/VisualNovelBoard.d.ts}

@@ -1,14 +1,6 @@
-/**
- * VisualNovelBoard
- *
- * Dialogue-scene game board: walks a dialogue graph node-by-node, rendering each
- * node's scene background + character portrait + speaker text + branching choices.
- * Composes the extended `DialogueBox` molecule; resolves every asset key against
- * the `assetManifest` prop (organism owns asset choice — no hardcoded URLs).
- */
 import React from 'react';
 import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** Manifest of per-key scene + portrait maps (UI value DTO). */
 type VisualNovelAssetManifest = {
     backgrounds?: Record<string, Asset>;

package/dist/components/game/2d/{WorldMapBoard.d.ts → organisms/WorldMapBoard.d.ts}

@@ -20,14 +20,15 @@
  */
 import React from 'react';
 import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-import type { ResolvedFrame } from '../shared/spriteAnimationTypes';
-import type { UiError } from '../../core/atoms/types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
+import type { UiError } from '../../../core/atoms/types';
 /** Manifest of per-kind sprite maps (UI value DTO). */
 type WorldMapAssetManifest = {
     terrains?: Record<string, Asset>;
     units?: Record<string, Asset>;
     features?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
 };
 /** Context exposed to render-prop slots. Hex / hero rows are `EntityRow`. */
 export type WorldMapSlotContext = {

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

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

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

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

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

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

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

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

package/dist/components/game/2d/{GameTemplate.d.ts → 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/2d/{PlatformerTemplate.d.ts → templates/PlatformerTemplate.d.ts}

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

package/dist/components/game/2d/{RoguelikeTemplate.d.ts → 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 { RoguelikeBoardProps } from './RoguelikeBoard';
-import type { IsometricTile } from '../shared/isometricTypes';
+import type { TemplateProps } from '../../../core/templates/types';
+import type { RoguelikeBoardProps } from '../organisms/RoguelikeBoard';
+import type { IsometricTile } from '../../shared/isometricTypes';
 export interface RoguelikeTemplateProps extends TemplateProps {
     scale?: number;
     unitScale?: number;

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

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

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

@@ -5,8 +5,8 @@
  * 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 { TowerDefenseTile, TowerDefensePathPoint, TowerDefenseTower } from './TowerDefenseBoard';
+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 {
     title?: string;

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

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

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

@@ -9,10 +9,10 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { WorldMapBoardProps } from './WorldMapBoard';
-import type { TemplateProps } from '../../core/templates/types';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
-export type { WorldMapSlotContext } from './WorldMapBoard';
+import type { WorldMapBoardProps } from '../organisms/WorldMapBoard';
+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 */
     scale?: number;

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

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
+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[];

package/dist/components/game/3d/{GameCanvas3D.d.ts → 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 './AssetLoader';
-import { type MinimalMouseEvent } from './useGameCanvas3DEvents';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
+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/3d/{index.d.ts → molecules/index.d.ts}

@@ -12,30 +12,25 @@ export { Lighting3D, type Lighting3DProps } from './Lighting3D';
 export { Canvas3DLoadingState, type Canvas3DLoadingStateProps, } from './Canvas3DLoadingState';
 export { Canvas3DErrorBoundary, type Canvas3DErrorBoundaryProps, type Canvas3DErrorBoundaryState, } from './Canvas3DErrorBoundary';
 export { ModelLoader, type ModelLoaderProps, } from './ModelLoader';
-export { PhysicsObject3D, usePhysics3DController, type PhysicsObject3DProps, type Physics3DState, } from './PhysicsObject3D';
-export { useThree, type UseThreeOptions, type UseThreeReturn, } from './useThree';
-export { useAssetLoader, type UseAssetLoaderOptions, type UseAssetLoaderReturn, type AssetLoadingState, } from './useAssetLoader';
-export { useSceneGraph, type UseSceneGraphReturn, type SceneGraphNode, type NodeType, } from './useSceneGraph';
-export { useRaycaster, type UseRaycasterOptions, type UseRaycasterReturn, type RaycastHit, type GridHit, } from './useRaycaster';
-export { useGameCanvas3DEvents, type UseGameCanvas3DEventsOptions, type UseGameCanvas3DEventsReturn, type GameCanvas3DEventConfig, } from './useGameCanvas3DEvents';
-export { AssetLoader, assetLoader, type LoadedModel, } from './AssetLoader';
-export { TileRenderer, type TileRendererProps, } from './TileRenderer';
-export { UnitRenderer, type UnitRendererProps, } from './UnitRenderer';
-export { FeatureRenderer, type FeatureRendererProps, } from './FeatureRenderer';
-export { FeatureRenderer3D, preloadFeatures, type FeatureRenderer3DProps, } from './FeatureRenderer3D';
-export type { UnitAnimationState } from '../shared/spriteAnimationTypes';
+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 './GameCanvas3DBattleTemplate';
-export { GameCanvas3DCastleTemplate, type GameCanvas3DCastleTemplateProps } from './GameCanvas3DCastleTemplate';
-export { GameCanvas3DWorldMapTemplate, type GameCanvas3DWorldMapTemplateProps } from './GameCanvas3DWorldMapTemplate';
-export { gridToWorld, worldToGrid, raycastToPlane, raycastToObjects, gridDistance, gridManhattanDistance, getNeighbors, isInBounds, getCellsInRadius, createGridHighlight, normalizeMouseCoordinates, type Grid3DConfig, type GridCoordinate, } from './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 './culling';
+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/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/3d/{GameBoard3D.d.ts → organisms/GameBoard3D.d.ts}

@@ -11,8 +11,8 @@
  */
 import React from 'react';
 import type { EventEmit, EntityRow } from '@almadar/core';
-import type { CameraMode } from './GameCanvas3D';
-import type { IsometricTile, IsometricFeature } from '../shared/isometricTypes';
+import type { CameraMode } from '../molecules/GameCanvas3D';
+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/3d/{GameCanvas3DBattleTemplate.d.ts → templates/GameCanvas3DBattleTemplate.d.ts}

@@ -18,9 +18,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../shared/isometricTypes';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from '../2d/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/3d/{GameCanvas3DCastleTemplate.d.ts → templates/GameCanvas3DCastleTemplate.d.ts}

@@ -19,9 +19,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../shared/isometricTypes';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from '../2d/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/3d/{GameCanvas3DWorldMapTemplate.d.ts → templates/GameCanvas3DWorldMapTemplate.d.ts}

@@ -20,9 +20,9 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { IsometricTile, IsometricFeature } from '../shared/isometricTypes';
-import type { TemplateProps } from '../../core/templates/types';
-import { type Game3DAssetManifest } from '../2d/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/{3d → shared/hooks}/useAssetLoader.d.ts

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

package/dist/components/game/{2d → 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/{2d → shared/hooks}/useCamera.d.ts

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

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

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

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

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

package/dist/components/game/{3d → 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 './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/{2d → shared/hooks}/useUnitSpriteAtlas.d.ts

@@ -1,5 +1,5 @@
-import type { IsometricUnit } from '../shared/isometricTypes';
-import type { ResolvedFrame } from '../shared/spriteAnimationTypes';
+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

@@ -17,7 +17,5 @@ export { isoToScreen, screenToIso, TILE_WIDTH, TILE_HEIGHT, FLOOR_HEIGHT, DIAMON
 export type { TileLayout } from './isometric';
 export { inferDirection, resolveSheetDirection, getCurrentFrame, resolveFrame, createUnitAnimationState, transitionAnimation, tickAnimationState, } from './spriteAnimation';
 export { SPRITE_SHEET_LAYOUT, SHEET_COLUMNS } from './spriteSheetConstants';
-export { combatAnimations, combatClasses, combatEffects, applyTemporaryEffect, calculateDamage, generateCombatMessage, } from './combatEffects';
-export type { CombatEffect, DamageResult, CombatEventType, CombatEventData, } from './combatEffects';
 export * from './combatPresets';
 export * from './canvasEffects';

package/dist/components/game/{2d → 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/{2d → shared/lib}/game3dAssetManifest.d.ts

@@ -10,7 +10,7 @@
  * @packageDocumentation
  */
 import type { Asset, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricFeature } from '../shared/isometricTypes';
+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/{2d → 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/{2d → 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[];