@almadar/ui 5.79.0 → 5.79.1

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

@@ -1,52 +0,0 @@
-import * as React from "react";
-import { type StatBadgeProps } from "./StatBadge";
-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;
-    /** Field name in the source */
-    field?: string;
-}
-/**
- * Schema-style HUD element definition.
- * Used when elements are passed from schema render_ui effects.
- */
-export interface GameHudElement {
-    type?: string;
-    bind?: string;
-    position?: string;
-    label?: string;
-    /** Direct value (from compiled render-ui effects) */
-    value?: number | string;
-    /** Lucide icon name or component */
-    icon?: IconInput;
-    assetUrl?: Asset;
-    /** Display format */
-    format?: string;
-    /** Max value (for bars/hearts) */
-    max?: number;
-}
-export interface GameHudProps {
-    /** Position of the HUD */
-    position?: "top" | "bottom" | "corners" | string;
-    /** Stats to display - accepts readonly for compatibility with generated const arrays */
-    stats?: readonly GameHudStat[];
-    /** Alias for stats (schema compatibility) */
-    items?: readonly GameHudStat[];
-    /**
-     * Schema-style elements array (alternative to stats).
-     * Converted to stats internally for backwards compatibility.
-     */
-    elements?: readonly GameHudElement[];
-    /** Size variant */
-    size?: "sm" | "md" | "lg";
-    /** Additional CSS classes */
-    className?: string;
-    /** Whether to use a semi-transparent background */
-    transparent?: boolean;
-}
-export declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, className, transparent, }: GameHudProps): React.JSX.Element;
-export declare namespace GameHud {
-    var displayName: string;
-}

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

@@ -1,45 +0,0 @@
-import * as React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
-import { type EventBusContextType } from "../../../../hooks/useEventBus";
-export type MenuOption = EventPayload & {
-    /** Optional ID (generated from index if not provided) */
-    id?: string;
-    /** Display label */
-    label: string;
-    /** Event to emit on click */
-    event?: string;
-    /** Page to navigate to */
-    navigatesTo?: string;
-    /** Button variant */
-    variant?: "primary" | "secondary" | "ghost" | string;
-    /** Whether the option is disabled */
-    disabled?: boolean;
-    /** Sub-label or description */
-    subLabel?: string;
-    /** Action identifier (alternative to event) */
-    action?: EventKey;
-};
-export interface GameMenuProps {
-    /** Menu title */
-    title: string;
-    /** Optional subtitle or version */
-    subtitle?: string;
-    /** Menu options - accepts readonly for compatibility with generated const arrays */
-    options?: readonly MenuOption[];
-    /** Alias for options (schema compatibility) */
-    menuItems?: readonly MenuOption[];
-    /** Called when an option is selected (legacy callback, prefer event bus) */
-    onSelect?: (option: MenuOption) => void;
-    /** Event bus for emitting UI events (optional, uses hook if not provided) */
-    eventBus?: EventBusContextType;
-    /** Background image or gradient */
-    background?: string;
-    /** Logo image URL */
-    logo?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function GameMenu({ title, subtitle, options, menuItems, onSelect, eventBus: eventBusProp, background, logo, className, }: GameMenuProps): React.JSX.Element;
-export declare namespace GameMenu {
-    var displayName: string;
-}

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

@@ -1,35 +0,0 @@
-import * as React from 'react';
-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';
-}
-export interface InventoryGridProps {
-    /** Array of items to display in the grid */
-    items: InventoryGridItem[];
-    /** Number of columns in the grid */
-    columns?: number;
-    /** Total number of slots (empty slots fill remaining space) */
-    totalSlots?: number;
-    /** Currently selected item ID */
-    selectedId?: string;
-    /** Callback when an item is selected */
-    onSelect?: (id: string) => void;
-    /** Event bus event name for selection */
-    selectEvent?: EventEmit<{
-        id: string;
-    }>;
-    /** Size variant for all item slots */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function InventoryGrid({ items, columns, totalSlots, selectedId, onSelect, selectEvent, size, className, }: InventoryGridProps): React.JSX.Element;
-export declare namespace InventoryGrid {
-    var displayName: string;
-}

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

@@ -1,26 +0,0 @@
-import * as React from 'react';
-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 */
-    value?: number;
-    /** Maximum amount (displays as bar if provided) */
-    max?: number;
-}
-export interface ResourceBarProps {
-    /** Resources to display */
-    resources: ResourceBarResource[];
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function ResourceBar({ resources, size, className, }: ResourceBarProps): React.JSX.Element;
-export declare namespace ResourceBar {
-    var displayName: string;
-}

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

@@ -1,39 +0,0 @@
-import * as React from 'react';
-import { type IconInput } from '../../../core/atoms/Icon';
-import type { Asset } from '@almadar/core';
-/**
- * StatBadge — game stat display molecule (distinct from core Badge atom).
- * Badge shows a text label/status token. StatBadge shows a numeric value
- * with optional HealthBar (hearts/bar) or ScoreDisplay (animated number) and
- * a named label — purpose-built for HUD stat rows, not general status tags.
- */
-export interface StatBadgeProps {
-    /** Sprite asset — takes precedence over icon when provided */
-    assetUrl?: Asset;
-    /** Asset image (board ui/ PNG); takes precedence over the Lucide icon. */
-    iconUrl?: Asset;
-    /** Stat label */
-    label: string;
-    /** Current value (defaults to 0 if not provided) */
-    value?: number | string;
-    /** Maximum value (for bar/hearts format) */
-    max?: number;
-    /** Data source entity name (for schema config) */
-    source?: string;
-    /** Field name in the source (for schema config) */
-    field?: string;
-    /** Display format */
-    format?: 'number' | 'hearts' | 'bar' | 'text' | string;
-    /** Icon component or emoji */
-    icon?: IconInput;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg' | string;
-    /** Visual variant */
-    variant?: 'default' | 'primary' | 'success' | 'warning' | 'danger' | string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, }: StatBadgeProps): React.JSX.Element;
-export declare namespace StatBadge {
-    var displayName: string;
-}

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

@@ -1,107 +0,0 @@
-/**
- * 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/organisms/ActionPalette.d.ts

@@ -1,34 +0,0 @@
-/**
- * ActionPalette Component
- *
- * Grid of draggable ActionTile components for the Sequencer tier.
- * Kids pick from these to build their sequence.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { SlotItemData } from './TraitSlot';
-export interface ActionPaletteProps {
-    /** Available actions */
-    actions: SlotItemData[];
-    /** IDs of actions that are already used (shown as disabled) */
-    usedActionIds?: string[];
-    /** Whether each action can be used multiple times */
-    allowDuplicates?: boolean;
-    /** Category → color mapping */
-    categoryColors?: Record<string, {
-        bg: string;
-        border: string;
-    }>;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Label above the palette */
-    label?: string;
-    /** Additional CSS classes */
-    className?: string;
-}
-export declare function ActionPalette({ actions, usedActionIds, allowDuplicates, categoryColors, size, label, className, }: ActionPaletteProps): React.JSX.Element;
-export declare namespace ActionPalette {
-    var displayName: string;
-}
-export default ActionPalette;

package/dist/components/game/2d/organisms/ActionTile.d.ts

@@ -1,30 +0,0 @@
-/**
- * ActionTile Component
- *
- * A draggable action tile for the Sequencer tier (ages 5-8).
- * Kids drag these from the ActionPalette into SequenceBar slots.
- * Sets SlotItemData on dataTransfer for TraitSlot compatibility.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-import type { SlotItemData } from './TraitSlot';
-export interface ActionTileProps extends DisplayStateProps {
-    /** The action data */
-    action: SlotItemData;
-    /** Size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Whether the tile is disabled / already used */
-    disabled?: boolean;
-    /** Category → color mapping */
-    categoryColors?: Record<string, {
-        bg: string;
-        border: string;
-    }>;
-}
-export declare function ActionTile({ action, size, disabled, categoryColors, className, }: ActionTileProps): React.JSX.Element;
-export declare namespace ActionTile {
-    var displayName: string;
-}
-export default ActionTile;

package/dist/components/game/2d/organisms/BattleBoard.d.ts

@@ -1,132 +0,0 @@
-/**
- * BattleBoard
- *
- * Core rendering organism for turn-based battles.
- *
- * This is a **controlled-only** component: all game state (units, phase,
- * turn, gameResult, selectedUnitId) must be provided via the `entity` prop.
- * User interactions are communicated via event bus emissions so the parent
- * (typically an Orbital trait or the `useBattleState` hook) can manage
- * state transitions.
- *
- * For a self-managing version, use `UncontrolledBattleBoard` which
- * composes this component with the `useBattleState` hook.
- *
- * Animation-only state (movement interpolation, screen shake, hover) is
- * always managed locally.
- *
- * @packageDocumentation
- */
-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';
-/** 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. */
-export type BattleSlotContext = {
-    phase: BattlePhase;
-    turn: number;
-    selectedUnit: EntityRow | null;
-    hoveredUnit: EntityRow | null;
-    playerUnits: readonly EntityRow[];
-    enemyUnits: readonly EntityRow[];
-    gameResult: 'victory' | 'defeat' | null;
-    onEndTurn: () => void;
-    onCancel: () => void;
-    onReset: () => void;
-    attackTargets: Array<{
-        x: number;
-        y: number;
-    }>;
-    /** Resolve screen position of a tile for overlays */
-    tileToScreen: (x: number, y: number) => {
-        x: number;
-        y: number;
-    };
-};
-/** Asset manifest shape for BattleBoard. */
-type BattleAssetManifest = {
-    terrains?: Record<string, Asset>;
-    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 */
-    entity?: EntityRow | readonly EntityRow[];
-    /** Direct tile data — takes priority over entity-derived tiles. */
-    tiles?: IsometricTile[];
-    /** Direct unit data — takes priority over entity-derived units. */
-    units?: IsometricUnit[];
-    /** Direct feature data — takes priority over entity-derived features. */
-    features?: IsometricFeature[];
-    /** Direct asset manifest — takes priority over entity-derived manifest. */
-    assetManifest?: BattleAssetManifest;
-    /** Canvas render scale */
-    scale?: number;
-    /** Unit draw-size multiplier */
-    unitScale?: number;
-    /** 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;
-    /** Header area -- receives battle context */
-    header?: (ctx: BattleSlotContext) => React.ReactNode;
-    /** Sidebar content (combat log, unit roster, etc.) */
-    sidebar?: (ctx: BattleSlotContext) => React.ReactNode;
-    /** Floating action buttons */
-    actions?: (ctx: BattleSlotContext) => React.ReactNode;
-    /** Floating overlays above the canvas (damage popups, tooltips) */
-    overlay?: (ctx: BattleSlotContext) => React.ReactNode;
-    /** Game-over screen overlay */
-    gameOverOverlay?: (ctx: BattleSlotContext) => React.ReactNode;
-    /** Called when a unit attacks another */
-    onAttack?: (attacker: EntityRow, target: EntityRow, damage: number) => void;
-    /** Called when battle ends */
-    onGameEnd?: (result: 'victory' | 'defeat') => void;
-    /** Called after a unit moves */
-    onUnitMove?: (unit: EntityRow, to: {
-        x: number;
-        y: number;
-    }) => void;
-    /** Custom combat damage calculator */
-    calculateDamage?: (attacker: EntityRow, target: EntityRow) => number;
-    onDrawEffects?: (ctx: CanvasRenderingContext2D, timestamp: number) => void;
-    hasActiveEffects?: boolean;
-    effectSpriteUrls?: AssetUrl[];
-    resolveUnitFrame?: (unitId: string) => ResolvedFrame | 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:{endTurnEvent} with {} on end turn */
-    endTurnEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{cancelEvent} with {} on cancel */
-    cancelEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{gameEndEvent} with { result: 'victory' | 'defeat' } on game end */
-    gameEndEvent?: EventEmit<{
-        result: 'victory' | 'defeat';
-    }>;
-    /** Emits UI:{playAgainEvent} with {} on play again / reset */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{attackEvent} with { attackerId, targetId, damage } on attack */
-    attackEvent?: EventEmit<{
-        attackerId: string;
-        targetId: string;
-        damage: number;
-    }>;
-    className?: string;
-}
-export declare function BattleBoard({ entity, tiles: propTiles, units: propUnits, features: propFeatures, assetManifest: propAssetManifest, scale, unitScale, spriteHeightRatio, spriteMaxWidthRatio, header, sidebar, actions, overlay, gameOverOverlay, onAttack, onGameEnd, onUnitMove, calculateDamage, onDrawEffects, hasActiveEffects, effectSpriteUrls, resolveUnitFrame, tileClickEvent, unitClickEvent, endTurnEvent, cancelEvent, gameEndEvent, playAgainEvent, attackEvent, className, }: BattleBoardProps): React.JSX.Element;
-export declare namespace BattleBoard {
-    var displayName: string;
-}
-export default BattleBoard;

package/dist/components/game/2d/organisms/BoardgameBoard.d.ts

@@ -1,37 +0,0 @@
-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 '../molecules/Canvas2D';
-export interface BoardgameBoardProps extends DisplayStateProps {
-    /** Board squares (flat top-down grid tiles) */
-    tiles?: IsometricTile[];
-    /** Tokens/units on the board */
-    units?: IsometricUnit[];
-    /** Features (markers, structures, etc.) on the board */
-    features?: IsometricFeature[];
-    /** Asset sprite manifest (same shape as Canvas2D.assetManifest) */
-    assetManifest?: Canvas2DProps['assetManifest'];
-    /** Base URL prepended to asset paths */
-    assetBaseUrl?: AssetUrl;
-    /** Render scale */
-    scale?: number;
-    /** Show minimap overlay */
-    showMinimap?: boolean;
-    /** Enable camera pan/zoom controls */
-    enableCamera?: boolean;
-    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
-    tileClickEvent?: EventEmit<{
-        x: number;
-        y: number;
-    }>;
-    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
-    unitClickEvent?: EventEmit<{
-        unitId: string;
-    }>;
-}
-export declare function BoardgameBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: BoardgameBoardProps): React.ReactElement;
-export declare namespace BoardgameBoard {
-    var displayName: string;
-}
-export default BoardgameBoard;

package/dist/components/game/2d/organisms/BuilderBoard.d.ts

@@ -1,60 +0,0 @@
-/**
- * BuilderBoard
- *
- * Component-snapping game board. The player places components
- * onto slots in a blueprint. Correct placement completes the build.
- *
- * Good for: architecture, circuits, molecules, system design stories.
- *
- * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
- */
-import React from 'react';
-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;
-    label: string;
-    description?: string;
-    iconEmoji?: string;
-    /** Image URL icon (takes precedence over iconEmoji) */
-    iconUrl?: AssetUrl;
-    category?: string;
-}
-/** A blueprint slot accepting a component (UI value DTO read off the entity).
- *  Mirrors the state machine's `BuilderBoardSlotsItem`: the required component
- *  and the currently placed component both live on the entity. */
-export interface BuilderSlot {
-    id: string;
-    label?: string;
-    description?: string;
-    requiredComponentId: string;
-    placedComponentId?: string;
-}
-export interface BuilderBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `components` / `slots` arrays plus `attempts` / `result` off the row —
-     *  the state machine is the single source of truth for placements. */
-    entity?: EntityRow | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        attempts: number;
-    }>;
-    /** Emits UI:{placeEvent} with { slotId, componentId } on component placement. */
-    placeEvent?: EventEmit<{
-        slotId: string;
-        componentId: string;
-    }>;
-    /** Emits UI:{checkEvent} with {} when the player checks the build. */
-    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, assetManifest, className, }: BuilderBoardProps): React.JSX.Element | null;
-export declare namespace BuilderBoard {
-    var displayName: string;
-}