@almadar/ui 5.74.0 → 5.76.0

package/dist/components/game/2d/molecules/Canvas2D.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Canvas2D
+ *
+ * The unified 2D game renderer (GR-6 consolidation). One canvas, a `projection`
+ * axis, layered render passes, opt-in clock. Absorbs IsometricCanvas (iso/hex/flat),
+ * GameCanvas2D (→ `projection:'free'`, pixel-direct draw) and PlatformerCanvas
+ * (→ `projection:'side'` + `platforms[]`).
+ *
+ * Pure renderer: every game datum arrives via props; only view state (viewport,
+ * camera, sprite cache) is local. The clock is LOLO-driven by default — `animate`
+ * opts a board into an internal RAF, but the default is OFF.
+ *
+ * Projection modes:
+ * - `isometric | hex | flat`: 2:1 diamond / pointy-top hex / orthographic square,
+ *   all via `isoToScreen` — identical to IsometricCanvas.
+ * - `free`: tile/unit/feature x,y are SCREEN PIXELS drawn directly (no diamond),
+ *   reusing the same sprite-drawing passes.
+ * - `side`: side-view pixel space with `platforms[]` (AABB) + follow-camera +
+ *   keyboard input — an isolated branch ported from PlatformerCanvas.
+ *
+ * @packageDocumentation
+ */
+import * as React from 'react';
+import type { Asset, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../../shared/isometricTypes';
+import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
+import type { UiError } from '../../../core/atoms/types';
+export interface TileCoord {
+    x: number;
+    y: number;
+}
+/** Projection axis. iso/hex/flat use `isoToScreen`; `free` is pixel-direct; `side`
+ *  is side-view pixel space with platforms (gravity lives in the LOLO model). */
+export type Projection = 'isometric' | 'hex' | 'flat' | 'free' | 'side';
+/** Camera behavior. `pan-zoom` = user drag+wheel; `follow` = track the player/
+ *  selected unit; `fixed` = no camera motion. */
+export type CameraMode = 'pan-zoom' | 'follow' | 'fixed';
+/** A side-view platform (AABB rect). `side` projection only. */
+export interface Platform {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    type?: 'ground' | 'platform' | 'hazard' | 'goal';
+}
+/** A side-view player. The model owns physics; Canvas2D only interpolates+draws. */
+export interface SidePlayer {
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    vx?: number;
+    vy?: number;
+    grounded?: boolean;
+    facingRight?: boolean;
+}
+export interface Canvas2DProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Loading state indicator */
+    isLoading?: boolean;
+    /** Error state */
+    error?: UiError | null;
+    /** Projection axis (default 'isometric'). Replaces the old `tileLayout`. */
+    projection?: Projection;
+    /** Tiles to render */
+    tiles?: IsometricTile[];
+    /** Units on the board */
+    units?: IsometricUnit[];
+    /** Features (resources, portals, buildings, etc.) */
+    features?: IsometricFeature[];
+    /** Active visual effects, drawn after units */
+    effects?: ActiveEffect[];
+    /** Side-view platforms (AABB). `projection:'side'` only. */
+    platforms?: Platform[];
+    /** Side-view player. `projection:'side'` only. */
+    player?: SidePlayer;
+    /** Background image (tiled behind iso/hex/flat/free; stretched in side). */
+    backgroundImage?: Asset;
+    /** Currently selected unit ID */
+    selectedUnitId?: string | null;
+    /** Valid move positions (pulsing green highlights) */
+    validMoves?: TileCoord[];
+    /** Attack target positions (pulsing red highlights) */
+    attackTargets?: TileCoord[];
+    /** Hovered tile position */
+    hoveredTile?: TileCoord | null;
+    /** Emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
+    /** Emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
+    /** Emits UI:{tileHoverEvent} with { x, y } on tile hover */
+    tileHoverEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
+    /** Emits UI:{tileLeaveEvent} with {} on tile leave */
+    tileLeaveEvent?: EventEmit<Record<string, never>>;
+    /** Emits UI:{keyEvent} with { key } on keydown — for side/free keyboard control */
+    keyEvent?: EventEmit<{
+        key: string;
+    }>;
+    /** Camera behavior (default 'pan-zoom'). */
+    camera?: CameraMode;
+    /** Render scale (0.4 = 40% zoom). */
+    scale?: number;
+    /** Extra scale multiplier for unit draw size. 1 = default. */
+    unitScale?: number;
+    /** Toggle minimap overlay. */
+    showMinimap?: boolean;
+    /** Opt-in internal RAF clock. DEFAULT OFF — the LOLO state machine drives the clock. */
+    animate?: {
+        fps: number;
+    };
+    /** Show debug grid lines and coordinates. */
+    debug?: boolean;
+    /** Ratio of unit draw height to scaledFloorHeight. Default 1.5. */
+    spriteHeightRatio?: number;
+    /** Max unit draw width as a ratio of scaledTileWidth. Default 0.6. */
+    spriteMaxWidthRatio?: number;
+    /** Override for the diamond-top Y offset within the tile sprite. */
+    diamondTopY?: number;
+    /** Resolve terrain sprite URL from terrain key */
+    getTerrainSprite?: (terrain: string) => string | undefined;
+    /** Resolve feature sprite URL from feature type key */
+    getFeatureSprite?: (featureType: string) => string | undefined;
+    /** Resolve unit static sprite URL */
+    getUnitSprite?: (unit: IsometricUnit) => string | undefined;
+    /** Resolve animated sprite sheet frame for a unit */
+    resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
+    /** Additional sprite URLs to preload (e.g., effect sprites) */
+    effectSpriteUrls?: string[];
+    /** Draw canvas effects after units (canvas-specific: cannot be declarative) */
+    onDrawEffects?: (ctx: CanvasRenderingContext2D, animTime: number, getImage: (url: string) => HTMLImageElement | undefined) => void;
+    /** Player sprite URL for `side`. */
+    playerSprite?: Asset;
+    /** Platform-type → tile sprite URL map for `side`. */
+    tileSprites?: Record<string, Asset>;
+    /** Background color for `side` (when no backgroundImage). */
+    bgColor?: string;
+    /** World dimensions for `side` follow-camera clamp. */
+    worldWidth?: number;
+    worldHeight?: number;
+    /** Manifest mapping entity keys to resolved Asset objects (fallback resolution). */
+    assetManifest?: {
+        terrains?: Record<string, Asset>;
+        units?: Record<string, Asset>;
+        features?: Record<string, Asset>;
+        effects?: Record<string, Asset>;
+    };
+}
+export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyEvent, camera, scale, unitScale, showMinimap, animate, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
+export declare namespace Canvas2D {
+    var displayName: string;
+}
+export default Canvas2D;

package/dist/components/game/2d/molecules/ControlGrid.d.ts

@@ -0,0 +1,42 @@
+import * as React from 'react';
+import type { EventEmit, Asset } from '@almadar/core';
+import type { IconInput } from '../../../core/atoms/index';
+export type ControlGridKind = 'dpad' | 'actions';
+export interface ControlGridButton {
+    id: string;
+    label?: string;
+    icon?: IconInput;
+    assetUrl?: Asset;
+    variant?: 'primary' | 'secondary' | 'ghost' | string;
+}
+export type DPadDirection = 'up' | 'down' | 'left' | 'right';
+export interface ControlGridProps {
+    kind: ControlGridKind;
+    /** action buttons (kind="actions") */
+    buttons?: ControlGridButton[];
+    /** Layout for kind="actions" */
+    layout?: 'horizontal' | 'vertical' | 'diamond';
+    /** Whether to include diagonal buttons (kind="dpad") */
+    includeDiagonals?: boolean;
+    /** Called when a button/direction is pressed or released */
+    onAction?: (id: string, pressed: boolean) => void;
+    /** Event-bus event emitted with `{ id, pressed }` on press/release */
+    actionEvent?: EventEmit<{
+        id: string;
+        pressed: boolean;
+    }>;
+    /** Called when a direction is pressed or released (kind="dpad" convenience overload) */
+    onDirection?: (direction: DPadDirection, pressed: boolean) => void;
+    /** Event-bus event emitted with `{ direction, pressed }` (kind="dpad") */
+    directionEvent?: EventEmit<{
+        direction: DPadDirection;
+        pressed: boolean;
+    }>;
+    size?: 'sm' | 'md' | 'lg';
+    disabled?: boolean;
+    className?: string;
+}
+export declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, size, disabled, className, }: ControlGridProps): React.JSX.Element;
+export declare namespace ControlGrid {
+    var displayName: string;
+}

package/dist/components/game/{molecules → 2d/molecules}/GameHud.d.ts

@@ -1,5 +1,6 @@
 import { type StatBadgeProps } from "./StatBadge";
-import type { IconInput } from "../../core/atoms";
+import type { Asset } from "@almadar/core";
+import type { IconInput } from "../../../core/atoms/index";
 export interface GameHudStat extends Omit<StatBadgeProps, "size"> {
     /** Data source entity name */
     source?: string;
@@ -19,6 +20,7 @@ export interface GameHudElement {
     value?: number | string;
     /** Lucide icon name or component */
     icon?: IconInput;
+    assetUrl?: Asset;
     /** Display format */
     format?: string;
     /** Max value (for bars/hearts) */

package/dist/components/game/{molecules → 2d/molecules}/GameMenu.d.ts

@@ -1,5 +1,5 @@
 import type { EventKey, EventPayload } from "@almadar/core";
-import { type EventBusContextType } from "../../../hooks/useEventBus";
+import { type EventBusContextType } from "../../../../hooks/useEventBus";
 export type MenuOption = EventPayload & {
     /** Optional ID (generated from index if not provided) */
     id?: string;

package/dist/components/game/{molecules → 2d/molecules}/InventoryGrid.d.ts

@@ -1,8 +1,9 @@
-import type { EventEmit } from '@almadar/core';
-import type { IconInput } from '../../core/atoms';
+import type { EventEmit, Asset } from '@almadar/core';
+import type { IconInput } from '../../../core/atoms/index';
 export interface InventoryGridItem {
     id: string;
     icon?: IconInput;
+    assetUrl?: Asset;
     label?: string;
     quantity?: number;
     rarity?: 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary';

package/dist/components/game/{molecules → 2d/molecules}/ResourceBar.d.ts

@@ -1,7 +1,9 @@
-import type { IconInput } from '../../core/atoms';
+import type { Asset } from '@almadar/core';
+import type { IconInput } from '../../../core/atoms/index';
 export interface ResourceBarResource {
     /** Icon for the resource */
     icon?: IconInput;
+    assetUrl?: Asset;
     /** Resource name */
     label: string;
     /** Current amount */

package/dist/components/game/{molecules → 2d/molecules}/StatBadge.d.ts

@@ -1,4 +1,4 @@
-import { type IconInput } from '../../core/atoms/Icon';
+import { type IconInput } from '../../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 /**
  * StatBadge — game stat display molecule (distinct from core Badge atom).

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

@@ -0,0 +1,107 @@
+/**
+ * Game 2D Components (flat)
+ *
+ * Atoms, molecules, board organisms, templates, puzzles, editor, and physics-sim.
+ * Dimension-agnostic DTO types/utils/hooks are re-surfaced from ../shared.
+ *
+ * @packageDocumentation
+ */
+export * from '../../shared/index';
+export { GameCard, type GameCardProps } from '../atoms/GameCard';
+export { HealthBar, type HealthBarProps } from '../atoms/HealthBar';
+export { ScoreDisplay, type ScoreDisplayProps } from '../atoms/ScoreDisplay';
+export { ControlButton, type ControlButtonProps } from '../atoms/ControlButton';
+export { Sprite, drawSprite, type SpriteProps } from '../atoms/Sprite';
+export { StateIndicator, type StateIndicatorProps, type StateStyle } from '../atoms/StateIndicator';
+export { TimerDisplay, type TimerDisplayProps } from '../atoms/TimerDisplay';
+export { ResourceCounter, type ResourceCounterProps } from '../atoms/ResourceCounter';
+export { ItemSlot, type ItemSlotProps } from '../atoms/ItemSlot';
+export { TurnIndicator, type TurnIndicatorProps } from '../atoms/TurnIndicator';
+export { ComboCounter, type ComboCounterProps } from '../atoms/ComboCounter';
+export { WaypointMarker, type WaypointMarkerProps } from '../atoms/WaypointMarker';
+export { StatusEffect, type StatusEffectProps } from '../atoms/StatusEffect';
+export { DamageNumber, type DamageNumberProps } from '../atoms/DamageNumber';
+export { DialogueBubble, type DialogueBubbleProps } from '../atoms/DialogueBubble';
+export { ChoiceButton, type ChoiceButtonProps } from '../atoms/ChoiceButton';
+export { ActionButton, type ActionButtonProps } from '../atoms/ActionButton';
+export { MiniMap, type MiniMapProps } from '../atoms/MiniMap';
+export { GameIcon, type GameIconProps } from '../atoms/GameIcon';
+export { ControlGrid, type ControlGridProps, type ControlGridButton, type ControlGridKind, type DPadDirection } from './ControlGrid';
+export { StatBadge, type StatBadgeProps } from './StatBadge';
+export { InventoryGrid, type InventoryGridProps, type InventoryGridItem } from './InventoryGrid';
+export { ResourceBar, type ResourceBarProps, type ResourceBarResource } from './ResourceBar';
+export { GameHud, type GameHudProps, type GameHudStat, type GameHudElement } from './GameHud';
+export { GameMenu, type GameMenuProps, type MenuOption } from './GameMenu';
+export { Canvas2D, type Canvas2DProps, type Projection, type CameraMode, type Platform, type SidePlayer, type TileCoord, } from './Canvas2D';
+export { useUnitSpriteAtlas } from '../../shared/hooks/useUnitSpriteAtlas';
+export { CanvasEffect, type CanvasEffectProps } from '../organisms/CanvasEffect';
+export * from '../../shared/hooks/useCanvasEffects';
+export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudioProviderProps, type GameAudioContextValue, } from '../../shared/providers/GameAudioProvider';
+export { GameAudioToggle, type GameAudioToggleProps, } from '../atoms/GameAudioToggle';
+export { useGameAudio, type AudioManifest, type SoundEntry, type GameAudioControls, type UseGameAudioOptions, } from '../../shared/hooks/useGameAudio';
+export { useCamera } from '../../shared/hooks/useCamera';
+export { BattleBoard, type BattleBoardProps, type BattlePhase, type BattleSlotContext, } from '../organisms/BattleBoard';
+export { UncontrolledBattleBoard, type UncontrolledBattleBoardProps, } from '../organisms/UncontrolledBattleBoard';
+export { useBattleState, type BattleStateEventConfig, type BattleStateCallbacks, type BattleStateResult, } from '../../shared/hooks/useBattleState';
+export { WorldMapBoard, type WorldMapBoardProps, type WorldMapSlotContext, } from '../organisms/WorldMapBoard';
+export { CastleBoard, type CastleBoardProps, type CastleSlotContext, } from '../organisms/CastleBoard';
+export { PlatformerBoard, type PlatformerBoardProps, } from '../organisms/PlatformerBoard';
+export { TowerDefenseBoard, type TowerDefenseBoardProps, } from '../organisms/TowerDefenseBoard';
+export { RoguelikeBoard, type RoguelikeBoardProps, } from '../organisms/RoguelikeBoard';
+export { TopDownShooterBoard, type TopDownShooterBoardProps, } from '../organisms/TopDownShooterBoard';
+export { CityBuilderBoard, type CityBuilderBoardProps, } from '../organisms/CityBuilderBoard';
+export { VisualNovelBoard, type VisualNovelBoardProps, type VisualNovelNode, type VisualNovelChoice, } from '../organisms/VisualNovelBoard';
+export { CardBattlerBoard, type CardBattlerBoardProps, type CardBattlerCard, } from '../organisms/CardBattlerBoard';
+export { HexStrategyBoard, type HexStrategyBoardProps, } from '../organisms/HexStrategyBoard';
+export { RacingBoard, type RacingBoardProps } from '../organisms/RacingBoard';
+export { TanksBoard, type TanksBoardProps } from '../organisms/TanksBoard';
+export { SpaceShmupBoard, type SpaceShmupBoardProps } from '../organisms/SpaceShmupBoard';
+export { SportsBoard, type SportsBoardProps } from '../organisms/SportsBoard';
+export { SokobanBoard, type SokobanBoardProps } from '../organisms/SokobanBoard';
+export { BoardgameBoard, type BoardgameBoardProps } from '../organisms/BoardgameBoard';
+export { PirateBoard, type PirateBoardProps } from '../organisms/PirateBoard';
+export { PinballBoard, type PinballBoardProps } from '../organisms/PinballBoard';
+export { FishingBoard, type FishingBoardProps } from '../organisms/FishingBoard';
+export { MatchPuzzleBoard, type MatchPuzzleBoardProps } from '../organisms/MatchPuzzleBoard';
+export { HolidayRunnerBoard, type HolidayRunnerBoardProps } from '../organisms/HolidayRunnerBoard';
+export { MinigolfBoard, type MinigolfBoardProps } from '../organisms/MinigolfBoard';
+export { SpaceStationBoard, type SpaceStationBoardProps } from '../organisms/SpaceStationBoard';
+export { TraitStateViewer, type TraitStateViewerProps, type TraitStateMachineDefinition, type TraitTransition, } from '../organisms/TraitStateViewer';
+export { TraitSlot, type TraitSlotProps, type SlotItemData, } from '../organisms/TraitSlot';
+export { CollapsibleSection, EditorSlider, EditorSelect, EditorCheckbox, EditorTextInput, StatusBar, TerrainPalette, EditorToolbar, TERRAIN_COLORS, FEATURE_TYPES, type EditorMode, type CollapsibleSectionProps, type EditorSliderProps, type EditorSelectProps, type EditorCheckboxProps, type EditorTextInputProps, type StatusBarProps, type TerrainPaletteProps, type EditorToolbarProps, } from '../../shared/lib/editorUtils';
+export { ActionTile, type ActionTileProps } from '../organisms/ActionTile';
+export { ActionPalette, type ActionPaletteProps } from '../organisms/ActionPalette';
+export { SequenceBar, type SequenceBarProps } from '../organisms/SequenceBar';
+export { SequencerBoard, type SequencerBoardProps } from '../organisms/SequencerBoard';
+export { RuleEditor, type RuleEditorProps, type RuleDefinition } from '../organisms/RuleEditor';
+export { EventLog, type EventLogProps, type EventLogEntry } from '../organisms/EventLog';
+export { ObjectRulePanel, type ObjectRulePanelProps } from '../organisms/ObjectRulePanel';
+export { EventHandlerBoard, type EventHandlerBoardProps } from '../organisms/EventHandlerBoard';
+export * from '../../shared/lib/puzzleObject';
+export { StateNode, type StateNodeProps } from '../organisms/StateNode';
+export { TransitionArrow, type TransitionArrowProps } from '../organisms/TransitionArrow';
+export { VariablePanel, type VariablePanelProps } from '../organisms/VariablePanel';
+export { StateJsonView, type StateJsonViewProps } from '../organisms/StateJsonView';
+export { StateArchitectBoard, type StateArchitectBoardProps, type StateArchitectTransition, type TestCase, } from '../organisms/StateArchitectBoard';
+export { SimulatorBoard, type SimulatorBoardProps, type SimulatorParameter } from '../organisms/SimulatorBoard';
+export { ClassifierBoard, type ClassifierBoardProps, type ClassifierItem, type ClassifierCategory } from '../organisms/ClassifierBoard';
+export { BuilderBoard, type BuilderBoardProps, type BuilderComponent, type BuilderSlot } from '../organisms/BuilderBoard';
+export { DebuggerBoard, type DebuggerBoardProps, type DebuggerLine } from '../organisms/DebuggerBoard';
+export { NegotiatorBoard, type NegotiatorBoardProps, type NegotiatorAction, type PayoffEntry } from '../organisms/NegotiatorBoard';
+export { SimulationCanvas, type SimulationCanvasProps } from '../organisms/SimulationCanvas';
+export { SimulationControls, type SimulationControlsProps } from '../organisms/SimulationControls';
+export { SimulationGraph, type SimulationGraphProps, type MeasurementPoint } from '../organisms/SimulationGraph';
+export type { PhysicsPreset, PhysicsBody, PhysicsConstraint } from '../../shared/lib/physicsTypes';
+export { projectileMotion, pendulum, springOscillator, ALL_PRESETS } from '../../shared/lib/physicsPresets';
+export { GameTemplate, type GameTemplateProps } from '../templates/GameTemplate';
+export { GameShell, type GameShellProps } from '../templates/GameShell';
+export { BattleTemplate, type BattleTemplateProps } from '../templates/BattleTemplate';
+export { CastleTemplate, type CastleTemplateProps } from '../templates/CastleTemplate';
+export { WorldMapTemplate, type WorldMapTemplateProps } from '../templates/WorldMapTemplate';
+export { PlatformerTemplate, type PlatformerTemplateProps } from '../templates/PlatformerTemplate';
+export { TowerDefenseTemplate, type TowerDefenseTemplateProps } from '../templates/TowerDefenseTemplate';
+export { RoguelikeTemplate, type RoguelikeTemplateProps } from '../templates/RoguelikeTemplate';
+export { TopDownShooterTemplate, type TopDownShooterTemplateProps } from '../templates/TopDownShooterTemplate';
+export { CityBuilderTemplate, type CityBuilderTemplateProps } from '../templates/CityBuilderTemplate';
+export { VisualNovelTemplate, type VisualNovelTemplateProps } from '../templates/VisualNovelTemplate';
+export { CardBattlerTemplate, type CardBattlerTemplateProps } from '../templates/CardBattlerTemplate';

package/dist/components/game/{organisms/puzzles/sequencer → 2d/organisms}/ActionPalette.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { SlotItemData } from '../../TraitSlot';
+import type { SlotItemData } from './TraitSlot';
 export interface ActionPaletteProps {
     /** Available actions */
     actions: SlotItemData[];

package/dist/components/game/{organisms/puzzles/sequencer → 2d/organisms}/ActionTile.d.ts

@@ -8,8 +8,8 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
-import type { SlotItemData } from '../../TraitSlot';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { SlotItemData } from './TraitSlot';
 export interface ActionTileProps extends DisplayStateProps {
     /** The action data */
     action: SlotItemData;

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

@@ -19,9 +19,9 @@
  */
 import React from 'react';
 import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
-import type { ResolvedFrame } from './types/spriteAnimation';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
 /** Battle phases an encounter walks through (UI value enum — not entity data). */
 export type BattlePhase = 'observation' | 'selection' | 'movement' | 'action' | 'enemy_turn' | 'game_over';
 /** Context exposed to render-prop slots. Carries coerced entity rows + UI helpers. */
@@ -52,6 +52,7 @@ type BattleAssetManifest = {
     units?: Record<string, Asset>;
     features?: Record<string, Asset>;
     effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
 };
 export interface BattleBoardProps extends DisplayStateProps {
     /** Entity (single board state) containing all board data */

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

@@ -1,8 +1,8 @@
 import React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { Canvas2DProps } from '../molecules/Canvas2D';
 export interface BoardgameBoardProps extends DisplayStateProps {
     /** Board squares (flat top-down grid tiles) */
     tiles?: IsometricTile[];
@@ -10,8 +10,8 @@ export interface BoardgameBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (markers, structures, etc.) on the board */
     features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
-    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
+    assetManifest?: Canvas2DProps['assetManifest'];
     /** Base URL prepended to asset paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

package/dist/components/game/{organisms/puzzles/builder → 2d/organisms}/BuilderBoard.d.ts

@@ -9,8 +9,8 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { AssetUrl, EventEmit, EntityRow, Asset } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A draggable build component (UI value DTO read off the entity). */
 export interface BuilderComponent {
     id: string;
@@ -49,8 +49,12 @@ export interface BuilderBoardProps extends DisplayStateProps {
     checkEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{playAgainEvent} with {} on play again / reset. */
     playAgainEvent?: EventEmit<Record<string, never>>;
+    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/build). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
 }
-export declare function BuilderBoard({ entity, completeEvent, placeEvent, checkEvent, playAgainEvent, className, }: BuilderBoardProps): React.JSX.Element | null;
+export declare function BuilderBoard({ entity, completeEvent, placeEvent, checkEvent, playAgainEvent, assetManifest, className, }: BuilderBoardProps): React.JSX.Element | null;
 export declare namespace BuilderBoard {
     var displayName: string;
 }

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

@@ -25,10 +25,10 @@
  */
 import * as React from 'react';
 import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { CombatActionType, EffectAssetManifest } from './types/effects';
-import type { UiError } from '../../core/atoms/types';
-export type { CombatActionType } from './types/effects';
-export type { EffectAssetManifest } from './types/effects';
+import type { CombatActionType, EffectAssetManifest } from '../../shared/effects';
+import type { UiError } from '../../../core/atoms/types';
+export type { CombatActionType } from '../../shared/effects';
+export type { EffectAssetManifest } from '../../shared/effects';
 export interface CanvasEffectProps {
     /** The type of combat action to visualise */
     actionType: CombatActionType;

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

@@ -1,6 +1,6 @@
 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-card sprite map (UI value DTO). */
 type CardBattlerAssetManifest = {
     cards?: Record<string, Asset>;

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

@@ -14,12 +14,13 @@
  */
 import React from 'react';
 import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../shared/isometricTypes';
 /** Manifest of per-kind sprite maps (UI value DTO). */
 type CastleAssetManifest = {
     terrains?: Record<string, Asset>;
     units?: Record<string, Asset>;
     features?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
 };
 /** Context exposed to render-prop slots */
 export type CastleSlotContext = {

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

@@ -1,6 +1,6 @@
 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-kind sprite maps (UI value DTO). */
 type CityBuilderAssetManifest = {
     terrains?: Record<string, Asset>;

package/dist/components/game/{organisms/puzzles/classifier → 2d/organisms}/ClassifierBoard.d.ts

@@ -15,8 +15,8 @@
  * from those; otherwise it self-manages with local state.
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { AssetUrl, EventEmit, EntityRow, Asset } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A sortable item (UI value DTO read off the entity). */
 export interface ClassifierItem {
     id: string;
@@ -55,8 +55,12 @@ export interface ClassifierBoardProps extends DisplayStateProps {
     checkEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{playAgainEvent} with {} on reset / play again. */
     playAgainEvent?: EventEmit<Record<string, never>>;
+    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/send). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
 }
-export declare function ClassifierBoard({ entity, completeEvent, assignEvent, checkEvent, playAgainEvent, className, }: ClassifierBoardProps): React.JSX.Element | null;
+export declare function ClassifierBoard({ entity, completeEvent, assignEvent, checkEvent, playAgainEvent, assetManifest, className, }: ClassifierBoardProps): React.JSX.Element | null;
 export declare namespace ClassifierBoard {
     var displayName: string;
 }

package/dist/components/game/{organisms/puzzles/debugger → 2d/organisms}/DebuggerBoard.d.ts

@@ -9,8 +9,8 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit, EntityRow, EntityWith } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { EventEmit, EntityRow, EntityWith, Asset } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A reviewable code line (UI value DTO read off the entity). */
 export interface DebuggerLine {
     id: string;
@@ -50,8 +50,12 @@ export interface DebuggerBoardProps extends DisplayStateProps {
     checkEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{playAgainEvent} with {} on play again / reset. */
     playAgainEvent?: EventEmit<Record<string, never>>;
+    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/bug/send). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
 }
-export declare function DebuggerBoard({ entity, completeEvent, toggleFlagEvent, checkEvent, playAgainEvent, className, }: DebuggerBoardProps): React.JSX.Element | null;
+export declare function DebuggerBoard({ entity, completeEvent, toggleFlagEvent, checkEvent, playAgainEvent, assetManifest, className, }: DebuggerBoardProps): React.JSX.Element | null;
 export declare namespace DebuggerBoard {
     var displayName: string;
 }

package/dist/components/game/{organisms/puzzles/event-handler → 2d/organisms}/EventHandlerBoard.d.ts

@@ -12,7 +12,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';
 import type { RuleDefinition } from './RuleEditor';
 export interface EventHandlerBoardProps extends DisplayStateProps {
     /** Puzzle board-state entity (single row or array). The board reads

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

@@ -1,9 +1,19 @@
 import React from 'react';
 import type { Asset, EventEmit } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+/** Asset manifest shape for FishingBoard. */
+type FishingAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface FishingBoardProps extends DisplayStateProps {
     /** Background image asset for the fishing scene */
     backgroundImage?: Asset;
+    /** Asset sprite manifest */
+    assetManifest?: FishingAssetManifest;
     /** Render scale */
     scale?: number;
     /** Show minimap overlay */
@@ -24,7 +34,7 @@ export interface FishingBoardProps extends DisplayStateProps {
         unitId: string;
     }>;
 }
-export declare function FishingBoard({ backgroundImage, scale, showMinimap, enableCamera, width, height, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
+export declare function FishingBoard({ backgroundImage, assetManifest, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
 export declare namespace FishingBoard {
     var displayName: string;
 }