@almadar/ui 5.78.0 → 5.79.1

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

@@ -1,44 +0,0 @@
-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): import("react/jsx-runtime").JSX.Element;
-export declare namespace GameMenu {
-    var displayName: string;
-}

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

@@ -1,34 +0,0 @@
-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): import("react/jsx-runtime").JSX.Element;
-export declare namespace InventoryGrid {
-    var displayName: string;
-}

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

@@ -1,25 +0,0 @@
-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): import("react/jsx-runtime").JSX.Element;
-export declare namespace ResourceBar {
-    var displayName: string;
-}

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

@@ -1,38 +0,0 @@
-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): import("react/jsx-runtime").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;
-}

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

@@ -1,70 +0,0 @@
-/**
- * CanvasEffect Component
- *
- * Renders animated visual effects using a `<canvas>` element with
- * sprite-based particles, frame-sequence animations, and overlays.
- * This is a render-ui pattern that can be placed in any slot —
- * it renders on top of whatever occupies that slot.
- *
- * Pattern: canvas-effect
- *
- * When an EffectAssetManifest is provided (via assetManifest prop),
- * the component uses the full particle engine with tinted sprites.
- * Without a manifest, it falls back to emoji-based rendering.
- *
- * **State categories (closed-circuit compliant):**
- * - Configuration (actionType, position, duration, manifest) → received via props
- * - Animation state (particles, shake, flash, RAF loop, phase timers) → local only
- * - Completion event → emitted via `useEventBus()` for trait integration
- *
- * This is an **ephemeral fire-and-forget** animation component.  All
- * internal state is rendering-only (particle physics, screen shake decay,
- * flash alpha, emoji phase timers).  No game logic lives here.
- *
- * @packageDocumentation
- */
-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';
-export interface CanvasEffectProps {
-    /** The type of combat action to visualise */
-    actionType: CombatActionType;
-    /** Screen-space X position (center of the effect) */
-    x: number;
-    /** Screen-space Y position (center of the effect) */
-    y: number;
-    /** Duration in ms before auto-dismiss (default 2000 for canvas, 800 for emoji) */
-    duration?: number;
-    /** Optional intensity multiplier (1 = normal, 2 = double size/brightness) */
-    intensity?: number;
-    /** Callback when the effect animation completes */
-    onComplete?: () => void;
-    /** Declarative event: emits UI:{completeEvent} when the effect animation completes */
-    completeEvent?: EventEmit<Record<string, never>>;
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Sprite URL for the effect (emoji fallback mode).
-     *  When set without assetManifest, renders this image instead of emoji. */
-    effectSpriteUrl?: AssetUrl;
-    /** Base URL for remote assets. Prepended to relative effectSpriteUrl paths. */
-    assetBaseUrl?: AssetUrl;
-    /** Full effect asset manifest for the sprite particle engine.
-     *  When provided, enables the canvas-based particle system. */
-    assetManifest?: EffectAssetManifest;
-    /** Canvas width (default 400) */
-    width?: number;
-    /** Canvas height (default 300) */
-    height?: number;
-}
-export declare function CanvasEffect({ effectSpriteUrl, assetBaseUrl, ...props }: CanvasEffectProps): React.JSX.Element | null;
-export declare namespace CanvasEffect {
-    var displayName: string;
-}
-export default CanvasEffect;