@almadar/ui 5.75.0 → 5.76.1

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/2d/{ActionTile.d.ts → organisms/ActionTile.d.ts}

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

package/dist/components/game/2d/{BattleBoard.d.ts → 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 '../shared/isometricTypes';
-import type { ResolvedFrame } from '../shared/spriteAnimationTypes';
+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/2d/{BoardgameBoard.d.ts → 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 '../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 BoardgameBoardProps extends DisplayStateProps {
     /** Board squares (flat top-down grid tiles) */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{BuilderBoard.d.ts → 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/2d/{CanvasEffect.d.ts → 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 '../shared/effects';
-import type { UiError } from '../../core/atoms/types';
-export type { CombatActionType } from '../shared/effects';
-export type { EffectAssetManifest } from '../shared/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/2d/{CardBattlerBoard.d.ts → 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/2d/{CastleBoard.d.ts → 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 '../shared/isometricTypes';
+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/2d/{CityBuilderBoard.d.ts → 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/2d/{ClassifierBoard.d.ts → 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/2d/{DebuggerBoard.d.ts → 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/2d/{EventHandlerBoard.d.ts → 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/2d/{FishingBoard.d.ts → 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, tileClickEvent, unitClickEvent, 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;
 }

package/dist/components/game/2d/{HexStrategyBoard.d.ts → organisms/HexStrategyBoard.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 HexStrategyBoard. */
+type HexStrategyAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface HexStrategyBoardProps extends DisplayStateProps {
     /** Hex grid tiles */
     tiles?: IsometricTile[];
@@ -10,8 +17,8 @@ export interface HexStrategyBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (resources, structures, etc.) on the board */
     features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
-    assetManifest?: Canvas2DProps['assetManifest'];
+    /** Asset sprite manifest */
+    assetManifest?: HexStrategyAssetManifest;
     /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

package/dist/components/game/2d/{HolidayRunnerBoard.d.ts → organisms/HolidayRunnerBoard.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 HolidayRunnerBoardProps extends DisplayStateProps {
     /** Ground/sky terrain tiles for the side-scroll strip */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{MatchPuzzleBoard.d.ts → organisms/MatchPuzzleBoard.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 MatchPuzzleBoardProps extends DisplayStateProps {
     /** Grid tiles for the match puzzle board */
     tiles?: IsometricTile[];

package/dist/components/game/2d/{MinigolfBoard.d.ts → organisms/MinigolfBoard.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 MinigolfBoardProps extends DisplayStateProps {
     /** Isometric grid tiles */
     tiles?: IsometricTile[];

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

@@ -11,8 +11,8 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { EventEmit, EntityRow, Asset } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A selectable round action (UI value DTO read off the entity). */
 export interface NegotiatorAction {
     id: string;
@@ -45,8 +45,12 @@ export interface NegotiatorBoardProps extends DisplayStateProps {
     finishEvent?: 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/arrow). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
 }
-export declare function NegotiatorBoard({ entity, completeEvent, playRoundEvent, finishEvent, playAgainEvent, className, }: NegotiatorBoardProps): React.JSX.Element | null;
+export declare function NegotiatorBoard({ entity, completeEvent, playRoundEvent, finishEvent, playAgainEvent, assetManifest, className, }: NegotiatorBoardProps): React.JSX.Element | null;
 export declare namespace NegotiatorBoard {
     var displayName: string;
 }

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

@@ -1,6 +1,14 @@
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+/** Asset manifest shape for PinballBoard. */
+type PinballAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface PinballBoardProps extends DisplayStateProps {
     /** Playfield tiles */
     tiles?: readonly EntityRow[];
@@ -9,7 +17,7 @@ export interface PinballBoardProps extends DisplayStateProps {
     /** Features (bumpers, paddles, etc.) on the board */
     features?: readonly EntityRow[];
     /** Asset sprite manifest */
-    assetManifest?: string;
+    assetManifest?: PinballAssetManifest;
     /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */
@@ -28,7 +36,7 @@ export interface PinballBoardProps extends DisplayStateProps {
         unitId: string;
     }>;
 }
-export declare function PinballBoard({ tiles: _tiles, units: _units, features: _features, assetManifest: _assetManifest, assetBaseUrl: _assetBaseUrl, scale: _scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: PinballBoardProps): React.ReactElement;
+export declare function PinballBoard({ tiles: _tiles, units: _units, features: _features, assetManifest, assetBaseUrl: _assetBaseUrl, scale: _scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: PinballBoardProps): React.ReactElement;
 export declare namespace PinballBoard {
     var displayName: string;
 }

package/dist/components/game/2d/{PirateBoard.d.ts → organisms/PirateBoard.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 PirateBoard. */
+type PirateAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface PirateBoardProps extends DisplayStateProps {
     /** Sea/island grid tiles */
     tiles?: IsometricTile[];
@@ -10,8 +17,8 @@ export interface PirateBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (ports, treasures, etc.) on the board */
     features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
-    assetManifest?: Canvas2DProps['assetManifest'];
+    /** Asset sprite manifest */
+    assetManifest?: PirateAssetManifest;
     /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

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

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { Platform, SidePlayer } from './Canvas2D';
+import type { Platform, SidePlayer } from '../molecules/Canvas2D';
 export interface PlatformerBoardProps {
     /** Entity containing all board state (result, lives, score, level, player, platforms) */
     entity?: EntityRow | readonly EntityRow[];

package/dist/components/game/2d/{RacingBoard.d.ts → organisms/RacingBoard.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 RacingBoard. */
+type RacingAssetManifest = {
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
+    ui?: Record<string, Asset>;
+};
 export interface RacingBoardProps extends DisplayStateProps {
     /** Road + grass terrain tiles forming the race circuit */
     tiles?: IsometricTile[];
@@ -10,8 +17,8 @@ export interface RacingBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Track features (pit lane markers, start/finish line, etc.) */
     features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
-    assetManifest?: Canvas2DProps['assetManifest'];
+    /** Asset sprite manifest */
+    assetManifest?: RacingAssetManifest;
     /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

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

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricTile } from '../shared/isometricTypes';
+import type { DisplayStateProps } from '../../../core/organisms/types';
+import type { IsometricTile } from '../../shared/isometricTypes';
 type PlayerPos = {
     x: number;
     y: number;

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

@@ -19,7 +19,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';
 export interface SequencerBoardProps extends DisplayStateProps {
     /** Puzzle board-state entity (single row or array). The board reads
      *  `availableActions` / `maxSlots` / `solutions` etc. off the row.

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

@@ -7,9 +7,10 @@
  * and the interpolation bridge smooths them to 60fps.
  */
 import React from 'react';
-import type { PhysicsPreset, PhysicsBody } from './types';
+import type { PhysicsPreset, PhysicsBody } from '../../shared/lib/physicsTypes';
+export type PhysicsPresetId = 'mechanics-projectile' | 'mechanics-pendulum' | 'mechanics-spring';
 export interface SimulationCanvasProps {
-    preset: string | PhysicsPreset;
+    preset: PhysicsPresetId | PhysicsPreset;
     width?: number;
     height?: number;
     running: boolean;

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

@@ -4,6 +4,7 @@
  * Play/pause/step/reset controls with speed and parameter sliders.
  */
 import React from 'react';
+import type { Asset } from '@almadar/core';
 export interface SimulationParameter {
     value: number;
     min: number;
@@ -21,9 +22,13 @@ export interface SimulationControlsProps {
     onReset: () => void;
     onSpeedChange: (speed: number) => void;
     onParameterChange: (name: string, value: number) => void;
+    /** Optional per-semantic-key asset overrides for icons (play/pause/step/reset). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
     className?: string;
 }
-export declare function SimulationControls({ running, speed, parameters, onPlay, onPause, onStep, onReset, onSpeedChange, onParameterChange, className, }: SimulationControlsProps): React.JSX.Element;
+export declare function SimulationControls({ running, speed, parameters, onPlay, onPause, onStep, onReset, onSpeedChange, onParameterChange, assetManifest, className, }: SimulationControlsProps): React.JSX.Element;
 export declare namespace SimulationControls {
     var displayName: string;
 }

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

@@ -12,8 +12,8 @@
  * interactions are emitted as events; the machine recomputes and re-renders.
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../core/organisms/types';
+import type { EventEmit, EntityRow, Asset } from '@almadar/core';
+import type { DisplayStateProps } from '../../../core/organisms/types';
 /** A tunable simulation parameter slider descriptor (UI value DTO read off the entity). */
 export interface SimulatorParameter {
     id: string;
@@ -47,8 +47,12 @@ export interface SimulatorBoardProps 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/play/reset). */
+    assetManifest?: {
+        ui?: Record<string, Asset>;
+    };
 }
-export declare function SimulatorBoard({ entity, completeEvent, setAEvent, setBEvent, checkEvent, playAgainEvent, className, }: SimulatorBoardProps): React.JSX.Element | null;
+export declare function SimulatorBoard({ entity, completeEvent, setAEvent, setBEvent, checkEvent, playAgainEvent, assetManifest, className, }: SimulatorBoardProps): React.JSX.Element | null;
 export declare namespace SimulatorBoard {
     var displayName: string;
 }