@almadar/ui 5.74.0 → 5.75.0

package/dist/components/core/atoms/index.d.ts

@@ -46,5 +46,5 @@ export { PatternTile, getTileDimensions, type PatternTileProps, type PatternVari
 export { AnimatedReveal, type AnimatedRevealProps, type RevealTrigger, type RevealAnimation } from "../../marketing/atoms/AnimatedReveal";
 export { AnimatedGraphic, type AnimatedGraphicProps, type GraphicAnimation } from "../../marketing/atoms/AnimatedGraphic";
 export { TraitFrame, type TraitFrameProps } from "./TraitFrame";
-export * from "../../game/atoms";
+export * from "../../game/2d";
 export { type UiError, type LinkAction, type ImageSource, type Point, type Rect, } from "./types";

package/dist/components/core/molecules/RepeatableFormSection.d.ts

@@ -14,11 +14,12 @@ import React from "react";
 import type { JsonValue } from "@almadar/core";
 export type RepeatableItem = {
     id: string;
-    /** State in which this item was added (for audit trails) */
-    addedInState: string | null;
-    /** Timestamp when item was added */
-    addedAt: string | null;
-    [key: string]: JsonValue;
+    /** State in which this item was added (for audit trails). Optional — only
+     *  consumers using `trackAddedInState`/`showAuditInfo` populate it. */
+    addedInState?: string | null;
+    /** Timestamp when item was added. Optional — see `addedInState`. */
+    addedAt?: string | null;
+    [key: string]: JsonValue | undefined;
 };
 export interface RepeatableFormSectionProps {
     /** Section type identifier */

package/dist/components/core/molecules/index.d.ts

@@ -51,7 +51,7 @@ export { DateRangeSelector, type DateRangeSelectorProps, type DateRangeSelectorO
 export { ChartLegend, type ChartLegendProps, type ChartLegendItem } from './ChartLegend';
 export { LineChart, type LineChartProps, type ChartDataPoint } from './LineChart';
 export { ProgressDots, type ProgressDotsProps, type DotState, type DotSize } from './ProgressDots';
-export * from '../../game/molecules';
+export * from '../../game/2d';
 export { GraphView, type GraphViewProps, type GraphViewNode, type GraphViewEdge } from './GraphView';
 export { MapView, type MapViewProps, type MapMarkerData, type MapRouteData, type MapRouteWaypoint } from './MapView';
 export { NumberStepper, type NumberStepperProps, type NumberStepperSize } from './NumberStepper';

package/dist/components/core/organisms/index.d.ts

@@ -9,7 +9,7 @@ export { MasterDetail, type MasterDetailProps } from "./MasterDetail";
 export { StateMachineView, DomStateMachineVisualizer, OrbitalStateMachineView, type StateMachineViewProps, type TransitionBundle, } from "./StateMachineView";
 export * from "./book";
 export * from "./layout";
-export * from "../../game/organisms";
+export * from "../../game/2d";
 export { UISlotRenderer, UISlotComponent, SlotContentRenderer, type UISlotRendererProps, } from "./UISlotRenderer";
 export { ModalSlot, type ModalSlotProps } from "./ModalSlot";
 export { DrawerSlot, type DrawerSlotProps } from "./DrawerSlot";

package/dist/components/core/templates/index.d.ts

@@ -2,19 +2,19 @@ export type { TemplateProps } from './types';
 export { DashboardLayout, type DashboardLayoutProps, type NavItem } from './DashboardLayout';
 export { AuthLayout, type AuthLayoutProps } from '../../marketing/templates/AuthLayout';
 export { CounterTemplate, type CounterTemplateProps, type CounterSize, type CounterVariant } from './CounterTemplate';
-export { GameTemplate, type GameTemplateProps } from '../../game/templates/GameTemplate';
+export { GameTemplate, type GameTemplateProps } from '../../game/2d/GameTemplate';
 export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';
-export { GameShell, type GameShellProps } from '../../game/templates/GameShell';
-export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/templates/BattleTemplate';
-export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/templates/CastleTemplate';
-export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/templates/WorldMapTemplate';
-export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/templates/PlatformerTemplate';
-export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/templates/TowerDefenseTemplate';
-export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/templates/RoguelikeTemplate';
-export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/templates/TopDownShooterTemplate';
-export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/templates/CityBuilderTemplate';
-export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/templates/VisualNovelTemplate';
-export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/templates/CardBattlerTemplate';
+export { GameShell, type GameShellProps } from '../../game/2d/GameShell';
+export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/2d/BattleTemplate';
+export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/2d/CastleTemplate';
+export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/2d/WorldMapTemplate';
+export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/2d/PlatformerTemplate';
+export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/2d/TowerDefenseTemplate';
+export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/2d/RoguelikeTemplate';
+export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/2d/TopDownShooterTemplate';
+export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/2d/CityBuilderTemplate';
+export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/2d/VisualNovelTemplate';
+export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/2d/CardBattlerTemplate';
 export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, } from '../../marketing/templates/LandingPageTemplate';
 export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, } from '../../marketing/templates/PricingPageTemplate';
 export { FeatureDetailPageTemplate, type FeatureDetailPageTemplateProps, type FeatureDetailPageEntity, type FeatureDetailSection, } from '../../marketing/templates/FeatureDetailPageTemplate';

package/dist/components/game/{organisms/puzzles/sequencer → 2d}/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}/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}/BattleBoard.d.ts

@@ -20,8 +20,8 @@
 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 { 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. */

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

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

package/dist/components/game/{organisms → 2d}/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 { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
 import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
+import type { Canvas2DProps } from './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}/BuilderBoard.d.ts

@@ -10,7 +10,7 @@
  */
 import React from 'react';
 import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { DisplayStateProps } from '../../core/organisms/types';
 /** A draggable build component (UI value DTO read off the entity). */
 export interface BuilderComponent {
     id: string;

package/dist/components/game/2d/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/{organisms → 2d}/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 { CombatActionType, EffectAssetManifest } from '../shared/effects';
 import type { UiError } from '../../core/atoms/types';
-export type { CombatActionType } from './types/effects';
-export type { EffectAssetManifest } from './types/effects';
+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/{templates → 2d}/CardBattlerTemplate.d.ts

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

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

@@ -14,7 +14,7 @@
  */
 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>;

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

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

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

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

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

@@ -16,7 +16,7 @@
  */
 import React from 'react';
 import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { DisplayStateProps } from '../../core/organisms/types';
 /** A sortable item (UI value DTO read off the entity). */
 export interface ClassifierItem {
     id: string;

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

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
+import type { IconInput } from '../../core/atoms';
+export type ControlGridKind = 'dpad' | 'actions';
+export interface ControlGridButton {
+    id: string;
+    label?: string;
+    icon?: IconInput;
+    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/{organisms/puzzles/debugger → 2d}/DebuggerBoard.d.ts

@@ -10,7 +10,7 @@
  */
 import React from 'react';
 import type { EventEmit, EntityRow, EntityWith } from '@almadar/core';
-import type { DisplayStateProps } from '../../../../core/organisms/types';
+import type { DisplayStateProps } from '../../core/organisms/types';
 /** A reviewable code line (UI value DTO read off the entity). */
 export interface DebuggerLine {
     id: string;

package/dist/components/game/{organisms/puzzles/event-handler → 2d}/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}/FishingBoard.d.ts

@@ -24,7 +24,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, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
 export declare namespace FishingBoard {
     var displayName: string;
 }

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

@@ -17,7 +17,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type AudioManifest, type GameAudioControls } from './hooks/useGameAudio';
+import { type AudioManifest, type GameAudioControls } from './useGameAudio';
 import type { UiError } from '../../core/atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;

package/dist/components/game/2d/GameCard.d.ts

@@ -0,0 +1,26 @@
+import * as React from 'react';
+import type { Asset, EventEmit } from '@almadar/core';
+export interface GameCardProps {
+    id: string;
+    cost?: number;
+    /** Card art asset */
+    art?: Asset;
+    attack?: number;
+    defense?: number;
+    name?: string;
+    selected?: boolean;
+    disabled?: boolean;
+    /** Size variant — controls card dimensions and art pixel size */
+    size?: 'sm' | 'md' | 'lg';
+    /** Direct click callback */
+    onClick?: (id: string) => void;
+    /** Event-bus event emitted with `{ cardId }` on click */
+    clickEvent?: EventEmit<{
+        cardId: string;
+    }>;
+    className?: string;
+}
+export declare function GameCard({ id, cost, art, attack, defense, name, selected, disabled, size, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
+export declare namespace GameCard {
+    var displayName: string;
+}

package/dist/components/game/2d/HealthBar.d.ts

@@ -0,0 +1,26 @@
+export interface HealthBarProps {
+    /** Current value */
+    current: number;
+    /** Maximum value */
+    max: number;
+    /** Display format.
+     * - `hearts` / `bar` / `numeric` — health display
+     * - `progress` — XP / generic progress bar with optional level badge and value label */
+    format?: 'hearts' | 'bar' | 'numeric' | 'progress';
+    /** Current level — shown as "Lv.N" badge when format="progress" */
+    level?: number;
+    /** Show value label below bar when format="progress" */
+    showLabel?: boolean;
+    /** Label suffix shown next to the value (e.g. "XP") when showLabel=true */
+    labelSuffix?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes */
+    className?: string;
+    /** Animation on change */
+    animated?: boolean;
+}
+export declare function HealthBar({ current, max, format, level, showLabel, labelSuffix, size, className, animated, }: HealthBarProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace HealthBar {
+    var displayName: string;
+}

package/dist/components/game/{organisms → 2d}/HexStrategyBoard.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 { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
 import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
+import type { Canvas2DProps } from './Canvas2D';
 export interface HexStrategyBoardProps extends DisplayStateProps {
     /** Hex grid tiles */
     tiles?: IsometricTile[];
@@ -10,8 +10,8 @@ export interface HexStrategyBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (resources, 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 manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

package/dist/components/game/{organisms → 2d}/HolidayRunnerBoard.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 { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
 import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
+import type { Canvas2DProps } from './Canvas2D';
 export interface HolidayRunnerBoardProps extends DisplayStateProps {
     /** Ground/sky terrain tiles for the side-scroll strip */
     tiles?: IsometricTile[];
@@ -10,8 +10,8 @@ export interface HolidayRunnerBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Features (gifts, obstacles, 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 manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */

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

@@ -25,9 +25,9 @@
  */
 import * as React from 'react';
 import type { Asset, AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../organisms/types/isometric';
-import type { ResolvedFrame } from '../organisms/types/spriteAnimation';
-import type { TileLayout } from '../organisms/utils/isometric';
+import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../shared/isometricTypes';
+import type { ResolvedFrame } from '../shared/spriteAnimationTypes';
+import type { TileLayout } from '../shared/isometric';
 import type { UiError } from '../../core/atoms/types';
 /** Event Contract:
  *  Emits: UI:TILE_CLICK

package/dist/components/game/{organisms → 2d}/MatchPuzzleBoard.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 { IsometricTile, IsometricUnit, IsometricFeature } from '../shared/isometricTypes';
 import type { DisplayStateProps } from '../../core/organisms/types';
-import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
+import type { Canvas2DProps } from './Canvas2D';
 export interface MatchPuzzleBoardProps extends DisplayStateProps {
     /** Grid tiles for the match puzzle board */
     tiles?: IsometricTile[];
@@ -10,8 +10,8 @@ export interface MatchPuzzleBoardProps extends DisplayStateProps {
     units?: IsometricUnit[];
     /** Gem/feature items 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 manifest sprite paths */
     assetBaseUrl?: AssetUrl;
     /** Render scale */