@almadar/ui 4.21.0 → 4.22.0

package/dist/components/molecules/Accordion.d.ts

@@ -5,6 +5,7 @@
  * Uses Button, Icon, Typography, and Divider atoms.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export interface AccordionItem {
     /**
      * Item ID (auto-generated from header/title if not provided)
@@ -62,6 +63,9 @@ export interface AccordionProps {
      */
     className?: string;
     /** Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen } */
-    toggleEvent?: string;
+    toggleEvent?: EventEmit<{
+        itemId: string;
+        isOpen: boolean;
+    }>;
 }
 export declare const Accordion: React.FC<AccordionProps>;

package/dist/components/molecules/CalendarGrid.d.ts

@@ -6,7 +6,7 @@
  * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
  */
 import React from "react";
-import type { EventPayload } from "@almadar/core";
+import type { EventEmit, EventPayload } from "@almadar/core";
 export interface CalendarEvent {
     id: string;
     title: string;
@@ -29,14 +29,17 @@ export interface CalendarGridProps {
     onEventClick?: (event: CalendarEvent) => void;
     /** Additional CSS classes */
     className?: string;
-    /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time } */
-    longPressEvent?: string;
+    /** Event emitted on long-press of a time slot: UI:{longPressEvent} with { date, time, ...longPressPayload } */
+    longPressEvent?: EventEmit<{
+        date: string;
+        time?: string;
+    }>;
     /** Additional payload for long-press events */
     longPressPayload?: EventPayload;
     /** Event emitted on swipe left (next week): UI:{swipeLeftEvent} */
-    swipeLeftEvent?: string;
+    swipeLeftEvent?: EventEmit<Record<string, never>>;
     /** Event emitted on swipe right (prev week): UI:{swipeRightEvent} */
-    swipeRightEvent?: string;
+    swipeRightEvent?: EventEmit<Record<string, never>>;
 }
 export declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, }: CalendarGridProps): React.JSX.Element;
 export declare namespace CalendarGrid {

package/dist/components/molecules/Card.d.ts

@@ -7,7 +7,7 @@
  * @generated by Orbital Compiler
  */
 import React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
+import type { EventEmit, EventKey, EventPayload } from "@almadar/core";
 export interface CardAction {
     label: string;
     onClick?: () => void;
@@ -42,8 +42,8 @@ export interface CardProps {
     level?: number;
     /** Maximum level */
     maxLevel?: number;
-    /** Event emitted on long press: UI:{longPressEvent} */
-    longPressEvent?: string;
+    /** Event emitted on long press: UI:{longPressEvent} (payload: longPressPayload spread — variable) */
+    longPressEvent?: EventEmit<EventPayload>;
     /** Additional payload for long-press events */
     longPressPayload?: EventPayload;
 }

package/dist/components/molecules/Carousel.d.ts

@@ -6,6 +6,7 @@
  * Pure UI molecule with no entity binding.
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 export interface CarouselProps<T = Record<string, unknown>> {
     /** Array of items to display as slides */
     items: T[];
@@ -24,7 +25,9 @@ export interface CarouselProps<T = Record<string, unknown>> {
     /** Enable infinite loop */
     loop?: boolean;
     /** Declarative event name for slide change */
-    slideChangeEvent?: string;
+    slideChangeEvent?: EventEmit<{
+        index: number;
+    }>;
     /** Payload to include with the slide change event */
     slideChangePayload?: Record<string, unknown>;
     /** Additional CSS classes */

package/dist/components/molecules/EmptyState.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 import { LucideIcon } from "lucide-react";
 export interface EmptyStateProps {
     /**
@@ -20,6 +21,6 @@ export interface EmptyStateProps {
     /** Variant for color styling */
     variant?: "default" | "success" | "error" | "warning" | "info";
     /** Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked */
-    actionEvent?: string;
+    actionEvent?: EventEmit<Record<string, never>>;
 }
 export declare const EmptyState: React.FC<EmptyStateProps>;

package/dist/components/molecules/ErrorState.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export interface ErrorStateProps {
     title?: string;
     /** Error message to display */
@@ -8,6 +9,6 @@ export interface ErrorStateProps {
     onRetry?: () => void;
     className?: string;
     /** Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked */
-    retryEvent?: string;
+    retryEvent?: EventEmit<Record<string, never>>;
 }
 export declare const ErrorState: React.FC<ErrorStateProps>;

package/dist/components/molecules/MapView.d.ts

@@ -1,3 +1,4 @@
+import type { EventEmit } from '@almadar/core';
 export interface MapMarkerData {
     /** Unique marker identifier */
     id: string | number;
@@ -26,9 +27,12 @@ export interface MapViewProps {
     /** Callback when the map is clicked (programmatic use) */
     onMapClick?: (lat: number, lng: number) => void;
     /** Event name dispatched via event bus when the map is clicked. Payload: { latitude, longitude } */
-    mapClickEvent?: string;
-    /** Event name dispatched via event bus when a marker is clicked. Payload: marker data */
-    markerClickEvent?: string;
+    mapClickEvent?: EventEmit<{
+        latitude: number;
+        longitude: number;
+    }>;
+    /** Event name dispatched via event bus when a marker is clicked. Payload: full MapMarkerData spread. */
+    markerClickEvent?: EventEmit<MapMarkerData>;
     /** Whether to show a pin at the clicked location */
     showClickedPin?: boolean;
     /** Additional CSS classes */

package/dist/components/molecules/Modal.d.ts

@@ -5,6 +5,7 @@
  * Uses theme-aware CSS variables for styling.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
 export interface ModalProps {
     /** Whether the modal is open (defaults to true when rendered by slot wrapper) */
@@ -21,7 +22,7 @@ export interface ModalProps {
     closeOnEscape?: boolean;
     className?: string;
     /** Declarative close event — emits UI:{closeEvent} via eventBus when modal should close */
-    closeEvent?: string;
+    closeEvent?: EventEmit<Record<string, never>>;
     /** Enable swipe-down-to-close on mobile bottom sheet (default: true) */
     swipeDownToClose?: boolean;
 }

package/dist/components/molecules/Pagination.d.ts

@@ -5,6 +5,7 @@
  * Uses Button, Icon, Typography, and Input atoms.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export interface PaginationProps {
     /**
      * Current page (1-indexed)
@@ -59,8 +60,12 @@ export interface PaginationProps {
      */
     className?: string;
     /** Declarative page change event — emits UI:{pageChangeEvent} with { page } */
-    pageChangeEvent?: string;
+    pageChangeEvent?: EventEmit<{
+        page: number;
+    }>;
     /** Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize } */
-    pageSizeChangeEvent?: string;
+    pageSizeChangeEvent?: EventEmit<{
+        pageSize: number;
+    }>;
 }
 export declare const Pagination: React.FC<PaginationProps>;

package/dist/components/molecules/SidePanel.d.ts

@@ -5,6 +5,7 @@
  * Uses Button, Typography atoms.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export interface SidePanelProps {
     /**
      * Panel title
@@ -42,6 +43,6 @@ export interface SidePanelProps {
      */
     className?: string;
     /** Declarative close event — emits UI:{closeEvent} via eventBus when panel should close */
-    closeEvent?: string;
+    closeEvent?: EventEmit<Record<string, never>>;
 }
 export declare const SidePanel: React.FC<SidePanelProps>;

package/dist/components/molecules/Tabs.d.ts

@@ -6,6 +6,7 @@
  */
 import React from 'react';
 import type { LucideIcon } from 'lucide-react';
+import type { EventEmit } from '@almadar/core';
 export interface TabItem {
     /** Tab ID */
     id: string;
@@ -36,7 +37,9 @@ export interface TabsProps {
     /** Callback when tab changes */
     onTabChange?: (tabId: string) => void;
     /** Declarative tab change event — emits UI:{tabChangeEvent} with { tabId } */
-    tabChangeEvent?: string;
+    tabChangeEvent?: EventEmit<{
+        tabId: string;
+    }>;
     /** Tab variant */
     variant?: 'default' | 'pills' | 'underline';
     /** Tab orientation */

package/dist/components/molecules/Toast.d.ts

@@ -5,6 +5,7 @@
  * Uses theme-aware CSS variables for styling.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export type ToastVariant = "success" | "error" | "info" | "warning";
 export interface ToastProps {
     /** Toast variant */
@@ -28,8 +29,8 @@ export interface ToastProps {
     /** Additional CSS classes */
     className?: string;
     /** Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed */
-    dismissEvent?: string;
+    dismissEvent?: EventEmit<Record<string, never>>;
     /** Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked */
-    actionEvent?: string;
+    actionEvent?: EventEmit<Record<string, never>>;
 }
 export declare const Toast: React.FC<ToastProps>;

package/dist/components/molecules/WizardProgress.d.ts

@@ -7,6 +7,7 @@
  * Uses wireframe theme styling (high contrast, sharp edges).
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 /**
  * Step info needed by WizardProgress.
  * Compatible with WizardContainer's WizardStep (subset of fields).
@@ -33,7 +34,9 @@ export interface WizardProgressProps {
     /** Additional CSS classes */
     className?: string;
     /** Declarative step click event — emits UI:{stepClickEvent} with { stepIndex } */
-    stepClickEvent?: string;
+    stepClickEvent?: EventEmit<{
+        stepIndex: number;
+    }>;
 }
 /**
  * WizardProgress - Step progress indicator

package/dist/components/molecules/game/ActionButtons.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
 export interface ActionButtonConfig {
     /** Unique identifier */
     id: string;
@@ -18,7 +19,10 @@ export interface ActionButtonsProps {
     /** Called when a button is pressed/released */
     onAction?: (id: string, pressed: boolean) => void;
     /** Declarative event name emitted on action via useEventBus */
-    actionEvent?: string;
+    actionEvent?: EventEmit<{
+        id: string;
+        pressed: boolean;
+    }>;
     /** Layout variant */
     layout?: 'horizontal' | 'vertical' | 'diamond';
     /** Size variant */

package/dist/components/molecules/game/CraftingRecipe.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
 export interface CraftingIngredient {
     /** Icon component or emoji */
     icon?: React.ReactNode;
@@ -23,7 +24,9 @@ export interface CraftingRecipeProps {
     /** Callback when the craft button is clicked */
     onCraft?: () => void;
     /** Event bus event name for crafting */
-    craftEvent?: string;
+    craftEvent?: EventEmit<{
+        output: string;
+    }>;
     /** Additional CSS classes */
     className?: string;
 }

package/dist/components/molecules/game/DPad.d.ts

@@ -1,3 +1,4 @@
+import type { EventEmit } from '@almadar/core';
 export type DPadDirection = 'up' | 'down' | 'left' | 'right';
 /** Event Contract:
  *  Emits: UI:DIRECTION
@@ -6,7 +7,10 @@ export interface DPadProps {
     /** Called when a direction is pressed/released */
     onDirection?: (direction: DPadDirection, pressed: boolean) => void;
     /** Declarative event name emitted on direction press/release via useEventBus */
-    directionEvent?: string;
+    directionEvent?: EventEmit<{
+        direction: DPadDirection;
+        pressed: boolean;
+    }>;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg';
     /** Whether to include diagonal buttons */

package/dist/components/molecules/game/DialogueBox.d.ts

@@ -12,7 +12,7 @@
  * concern analogous to Form's `formData`.
  */
 import React from 'react';
-import type { EventPayload } from '@almadar/core';
+import type { EventEmit, EventPayload } from '@almadar/core';
 export type DialogueChoice = EventPayload & {
     text: string;
     action?: string;
@@ -46,11 +46,13 @@ export interface DialogueBoxProps {
     /** Called when dialogue is advanced (no choices) */
     onAdvance?: () => void;
     /** Declarative event: emits UI:{completeEvent} when text animation completes */
-    completeEvent?: string;
-    /** Declarative event: emits UI:{choiceEvent} with { choice } when a choice is selected */
-    choiceEvent?: string;
+    completeEvent?: EventEmit<Record<string, never>>;
+    /** Declarative event: emits UI:{choiceEvent} with { choice: DialogueChoice } when a choice is selected */
+    choiceEvent?: EventEmit<{
+        choice: DialogueChoice;
+    }>;
     /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
-    advanceEvent?: string;
+    advanceEvent?: EventEmit<Record<string, never>>;
     /** Optional className */
     className?: string;
 }

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

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
 export interface InventoryGridItem {
     id: string;
     icon?: React.ReactNode;
@@ -18,7 +19,9 @@ export interface InventoryGridProps {
     /** Callback when an item is selected */
     onSelect?: (id: string) => void;
     /** Event bus event name for selection */
-    selectEvent?: string;
+    selectEvent?: EventEmit<{
+        id: string;
+    }>;
     /** Size variant for all item slots */
     size?: 'sm' | 'md' | 'lg';
     /** Additional CSS classes */

package/dist/components/molecules/game/InventoryPanel.d.ts

@@ -11,7 +11,7 @@
  * Local state is hover/tooltip only — rendering-only concerns.
  */
 import React from 'react';
-import type { EventPayload } from "@almadar/core";
+import type { EventEmit, EventPayload } from "@almadar/core";
 export type InventoryItem = EventPayload & {
     id: string;
     type: string;
@@ -36,11 +36,17 @@ export interface InventoryPanelProps {
     /** Called when an item is dropped */
     onDropItem?: (item: InventoryItem) => void;
     /** Declarative event: emits UI:{selectSlotEvent} with { index } when a slot is selected */
-    selectSlotEvent?: string;
-    /** Declarative event: emits UI:{useItemEvent} with { item } when an item is used */
-    useItemEvent?: string;
-    /** Declarative event: emits UI:{dropItemEvent} with { item } when an item is dropped */
-    dropItemEvent?: string;
+    selectSlotEvent?: EventEmit<{
+        index: number;
+    }>;
+    /** Declarative event: emits UI:{useItemEvent} with { item: InventoryItem } when an item is used */
+    useItemEvent?: EventEmit<{
+        item: InventoryItem;
+    }>;
+    /** Declarative event: emits UI:{dropItemEvent} with { item: InventoryItem } when an item is dropped */
+    dropItemEvent?: EventEmit<{
+        item: InventoryItem;
+    }>;
     /** Show item tooltips on hover */
     showTooltips?: boolean;
     /** Optional className */

package/dist/components/molecules/game/IsometricCanvas.d.ts

@@ -24,6 +24,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../organisms/game/types/isometric';
 import type { ResolvedFrame } from '../../organisms/game/types/spriteAnimation';
 /** Event Contract:
@@ -67,13 +68,21 @@ export interface IsometricCanvasProps {
     onTileHover?: (x: number, y: number) => void;
     onTileLeave?: () => void;
     /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
     /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
-    unitClickEvent?: string;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
     /** Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover */
-    tileHoverEvent?: string;
+    tileHoverEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
     /** Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave */
-    tileLeaveEvent?: string;
+    tileLeaveEvent?: EventEmit<Record<string, never>>;
     /** Render scale (0.4 = 40% zoom) */
     scale?: number;
     /** Show debug grid lines and coordinates */

package/dist/components/molecules/game/PlatformerCanvas.d.ts

@@ -1,3 +1,4 @@
+import type { EventEmit } from '@almadar/core';
 export interface PlatformerPlatform {
     x: number;
     y: number;
@@ -39,10 +40,14 @@ export interface PlatformerCanvasProps {
     /** Base URL prefix for asset URLs */
     assetBaseUrl?: string;
     /** Event names for keyboard controls */
-    leftEvent?: string;
-    rightEvent?: string;
-    jumpEvent?: string;
-    stopEvent?: string;
+    leftEvent?: EventEmit<{
+        direction: number;
+    }>;
+    rightEvent?: EventEmit<{
+        direction: number;
+    }>;
+    jumpEvent?: EventEmit<Record<string, never>>;
+    stopEvent?: EventEmit<Record<string, never>>;
     /** Additional CSS classes */
     className?: string;
 }

package/dist/components/organisms/GraphCanvas.d.ts

@@ -11,7 +11,7 @@
  * - className for external styling
  */
 import React from "react";
-import type { EventPayload } from "@almadar/core";
+import type { EventEmit, EventPayload } from "@almadar/core";
 export type GraphNode = EventPayload & {
     id: string;
     label?: string;
@@ -55,7 +55,9 @@ export interface GraphCanvasProps {
     /** On node click */
     onNodeClick?: (node: GraphNode) => void;
     /** Node click event */
-    nodeClickEvent?: string;
+    nodeClickEvent?: EventEmit<{
+        id: string;
+    }>;
     /** Layout algorithm */
     layout?: "force" | "circular" | "grid";
     /** Entity name for schema-driven auto-fetch */

package/dist/components/organisms/MediaGallery.d.ts

@@ -11,6 +11,7 @@
  * - className for external styling
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 import type { EntityDisplayProps } from "./types";
 import type { EntityRow } from "@almadar/core";
 export type MediaItem = EntityRow & {
@@ -47,7 +48,9 @@ export interface MediaGalleryProps extends EntityDisplayProps<MediaItem> {
     /** Selected item IDs */
     selectedItems?: readonly string[];
     /** Event name emitted when selection changes (emitted as UI:{selectionEvent}) */
-    selectionEvent?: string;
+    selectionEvent?: EventEmit<{
+        selection: string[];
+    }>;
     /** Show upload button */
     showUpload?: boolean;
     /** Actions */

package/dist/components/organisms/PageHeader.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 import { LucideIcon } from "lucide-react";
 export interface PageBreadcrumb {
     label: string;
@@ -28,7 +29,7 @@ export interface PageHeaderProps {
     /** Show back button */
     showBack?: boolean;
     /** Event to emit when back is clicked (default: BACK) */
-    backEvent?: string;
+    backEvent?: EventEmit<Record<string, never>>;
     /** Breadcrumbs */
     breadcrumbs?: readonly PageBreadcrumb[];
     /** Status badge */

package/dist/components/organisms/Sidebar.d.ts

@@ -10,6 +10,7 @@
  * - logoClickEvent — emitted when logo/brand area clicked
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { LucideIcon } from 'lucide-react';
 export interface SidebarItem {
     /** Item ID */
@@ -55,14 +56,16 @@ export interface SidebarProps {
     /** Default collapsed state */
     defaultCollapsed?: boolean;
     /** Event emitted when collapse state changes, payload: { collapsed: boolean } */
-    collapseChangeEvent?: string;
+    collapseChangeEvent?: EventEmit<{
+        collapsed: boolean;
+    }>;
     /** Hide the collapse/expand button */
     hideCollapseButton?: boolean;
     /** Show a close button (for mobile) */
     showCloseButton?: boolean;
     /** Event emitted when close button is clicked */
-    closeEvent?: string;
+    closeEvent?: EventEmit<Record<string, never>>;
     /** Event emitted when logo/brand is clicked */
-    logoClickEvent?: string;
+    logoClickEvent?: EventEmit<Record<string, never>>;
 }
 export declare const Sidebar: React.FC<SidebarProps>;

package/dist/components/organisms/SignaturePad.d.ts

@@ -11,6 +11,7 @@
  * - className for external styling
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export interface SignaturePadProps {
     /** Label above the pad */
     label?: string;
@@ -29,9 +30,11 @@ export interface SignaturePadProps {
     /** Callback when signature changes */
     onChange?: (dataUrl: string | null) => void;
     /** Event to emit on sign */
-    signEvent?: string;
+    signEvent?: EventEmit<{
+        signature: string;
+    }>;
     /** Event to emit on clear */
-    clearEvent?: string;
+    clearEvent?: EventEmit<Record<string, never>>;
     /** Entity name for schema-driven context */
     entity?: string;
     /** Loading state */

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

@@ -18,6 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../types';
 import type { IsometricTile, IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
@@ -153,19 +154,30 @@ export interface BattleBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     effectSpriteUrls?: string[];
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
     /** Emits UI:{tileClickEvent} with { x, y } on tile click */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
     /** Emits UI:{unitClickEvent} with { unitId } on unit click */
-    unitClickEvent?: string;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
     /** Emits UI:{endTurnEvent} with {} on end turn */
-    endTurnEvent?: string;
+    endTurnEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{cancelEvent} with {} on cancel */
-    cancelEvent?: string;
-    /** Emits UI:{gameEndEvent} with { result } on game end */
-    gameEndEvent?: string;
+    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?: string;
+    playAgainEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{attackEvent} with { attackerId, targetId, damage } on attack */
-    attackEvent?: string;
+    attackEvent?: EventEmit<{
+        attackerId: string;
+        targetId: string;
+        damage: number;
+    }>;
     className?: string;
 }
 export declare function BattleBoard({ entity, scale, unitScale, 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;

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

@@ -24,6 +24,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { CombatActionType, EffectAssetManifest } from './types/effects';
 export type { CombatActionType } from './types/effects';
 export type { EffectAssetManifest } from './types/effects';
@@ -41,7 +42,7 @@ export interface CanvasEffectProps {
     /** Callback when the effect animation completes */
     onComplete?: () => void;
     /** Declarative event: emits UI:{completeEvent} when the effect animation completes */
-    completeEvent?: string;
+    completeEvent?: EventEmit<Record<string, never>>;
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */

package/dist/components/organisms/game/CastleBoard.d.ts

@@ -13,6 +13,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 /** Entity shape consumed by CastleBoard */
 export interface CastleEntity {
@@ -71,11 +72,21 @@ export interface CastleBoardProps {
     /** Called when any tile is clicked */
     onTileClick?: (x: number, y: number) => void;
     /** Event name to emit via event bus when a feature is clicked (emits UI:{featureClickEvent}) */
-    featureClickEvent?: string;
+    featureClickEvent?: EventEmit<{
+        featureId: string;
+        featureType: string;
+        x: number;
+        y: number;
+    }>;
     /** Event name to emit via event bus when a unit is clicked (emits UI:{unitClickEvent}) */
-    unitClickEvent?: string;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
     /** Event name to emit via event bus when a tile is clicked (emits UI:{tileClickEvent}) */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
     className?: string;
 }
 export declare function CastleBoard({ entity, scale, header, sidePanel, overlay, footer, onFeatureClick, onUnitClick, onTileClick, featureClickEvent, unitClickEvent, tileClickEvent, className, }: CastleBoardProps): React.JSX.Element;

package/dist/components/organisms/game/GameCanvas3D.d.ts

@@ -14,6 +14,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import * as THREE from 'three';
 import { AssetLoader } from './three/loaders/AssetLoader';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
@@ -106,21 +107,64 @@ export interface GameCanvas3DProps {
     /** URLs to preload */
     preloadAssets?: string[];
     /** Declarative event: tile click */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        tileId: string;
+        x: number;
+        z: number;
+        type?: string;
+        terrain?: string;
+        elevation?: number;
+    }>;
     /** Declarative event: unit click */
-    unitClickEvent?: string;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+        x: number;
+        z: number;
+        unitType?: string;
+        name?: string;
+        team?: string;
+        faction?: string;
+        health?: number;
+        maxHealth?: number;
+    }>;
     /** Declarative event: feature click */
-    featureClickEvent?: string;
+    featureClickEvent?: EventEmit<{
+        featureId: string;
+        x: number;
+        z: number;
+        type?: string;
+        elevation?: number;
+    }>;
     /** Declarative event: canvas click */
-    canvasClickEvent?: string;
+    canvasClickEvent?: EventEmit<{
+        clientX: number;
+        clientY: number;
+        button: number;
+    }>;
     /** Declarative event: tile hover */
-    tileHoverEvent?: string;
+    tileHoverEvent?: EventEmit<{
+        tileId: string;
+        x: number;
+        z: number;
+        type?: string;
+    }>;
     /** Declarative event: tile leave */
-    tileLeaveEvent?: string;
+    tileLeaveEvent?: EventEmit<Record<string, never>>;
     /** Declarative event: unit animation */
-    unitAnimationEvent?: string;
+    unitAnimationEvent?: EventEmit<{
+        unitId: string;
+        state: string;
+        timestamp: number;
+    }>;
     /** Declarative event: camera change */
-    cameraChangeEvent?: string;
+    cameraChangeEvent?: EventEmit<{
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        timestamp: number;
+    }>;
     /** Loading message */
     loadingMessage?: string;
     /** Whether to use instancing for tiles */

package/dist/components/organisms/game/TraitSlot.d.ts

@@ -18,6 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
 /** Data shape for a slot's equipped item */
 export interface SlotItemData {
@@ -79,9 +80,13 @@ export interface TraitSlotProps {
     /** Remove handler */
     onRemove?: () => void;
     /** Emits UI:{clickEvent} with { slotNumber } */
-    clickEvent?: string;
+    clickEvent?: EventEmit<{
+        slotNumber: number;
+    }>;
     /** Emits UI:{removeEvent} with { slotNumber } */
-    removeEvent?: string;
+    removeEvent?: EventEmit<{
+        slotNumber: number;
+    }>;
 }
 export declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, }: TraitSlotProps): React.JSX.Element;
 export declare namespace TraitSlot {

package/dist/components/organisms/game/WorldMapBoard.d.ts

@@ -19,6 +19,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
 /** A hero on the world map */
@@ -125,15 +126,31 @@ export interface WorldMapBoardProps {
         y: number;
     }, range: number) => boolean;
     /** Emits UI:{heroSelectEvent} with { heroId } */
-    heroSelectEvent?: string;
+    heroSelectEvent?: EventEmit<{
+        heroId: string;
+    }>;
     /** Emits UI:{heroMoveEvent} with { heroId, toX, toY } */
-    heroMoveEvent?: string;
+    heroMoveEvent?: EventEmit<{
+        heroId: string;
+        toX: number;
+        toY: number;
+    }>;
     /** Emits UI:{battleEncounterEvent} with { attackerId, defenderId } */
-    battleEncounterEvent?: string;
+    battleEncounterEvent?: EventEmit<{
+        attackerId: string;
+        defenderId: string;
+    }>;
     /** Emits UI:{featureEnterEvent} with { heroId, feature, hex } */
-    featureEnterEvent?: string;
+    featureEnterEvent?: EventEmit<{
+        heroId: string;
+        feature: string;
+        hex: MapHex;
+    }>;
     /** Emits UI:{tileClickEvent} with { x, y } */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
     /** Header / top bar */
     header?: (ctx: WorldMapSlotContext) => React.ReactNode;
     /** Side panel (hero detail, hero lists, etc.) */

package/dist/components/organisms/game/hooks/useBattleState.d.ts

@@ -1,12 +1,24 @@
+import type { EventEmit } from '@almadar/core';
 import type { BattleUnit, BattlePhase } from '../BattleBoard';
 export interface BattleStateEventConfig {
-    tileClickEvent?: string;
-    unitClickEvent?: string;
-    endTurnEvent?: string;
-    cancelEvent?: string;
-    gameEndEvent?: string;
-    playAgainEvent?: string;
-    attackEvent?: string;
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
+    endTurnEvent?: EventEmit<Record<string, never>>;
+    cancelEvent?: EventEmit<Record<string, never>>;
+    gameEndEvent?: EventEmit<{
+        result: 'victory' | 'defeat';
+    }>;
+    playAgainEvent?: EventEmit<Record<string, never>>;
+    attackEvent?: EventEmit<{
+        attackerId: string;
+        targetId: string;
+        damage: number;
+    }>;
 }
 export interface BattleStateCallbacks {
     /** Called when a unit attacks another */

package/dist/components/organisms/game/puzzles/builder/BuilderBoard.d.ts

@@ -9,6 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface BuilderComponent {
     id: string;
@@ -44,7 +45,10 @@ export interface BuilderPuzzleEntity {
 }
 export interface BuilderBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     entity: BuilderPuzzleEntity;
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        attempts: number;
+    }>;
 }
 export declare function BuilderBoard({ entity, completeEvent, className, }: BuilderBoardProps): React.JSX.Element;
 export declare namespace BuilderBoard {

package/dist/components/organisms/game/puzzles/classifier/ClassifierBoard.d.ts

@@ -10,6 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface ClassifierItem {
     id: string;
@@ -45,7 +46,10 @@ export interface ClassifierPuzzleEntity {
 }
 export interface ClassifierBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     entity: ClassifierPuzzleEntity;
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        attempts: number;
+    }>;
 }
 export declare function ClassifierBoard({ entity, completeEvent, className, }: ClassifierBoardProps): React.JSX.Element;
 export declare namespace ClassifierBoard {

package/dist/components/organisms/game/puzzles/debugger/DebuggerBoard.d.ts

@@ -9,6 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface DebuggerLine {
     id: string;
@@ -37,7 +38,10 @@ export interface DebuggerPuzzleEntity {
 }
 export interface DebuggerBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     entity: DebuggerPuzzleEntity;
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        attempts: number;
+    }>;
 }
 export declare function DebuggerBoard({ entity, completeEvent, className, }: DebuggerBoardProps): React.JSX.Element;
 export declare namespace DebuggerBoard {

package/dist/components/organisms/game/puzzles/event-handler/EventHandlerBoard.d.ts

@@ -11,6 +11,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type PuzzleObjectDef } from './ObjectRulePanel';
 export interface EventHandlerPuzzleEntity {
@@ -44,9 +45,11 @@ export interface EventHandlerBoardProps extends Omit<EntityDisplayProps, 'entity
     /** Playback speed in ms per event */
     stepDurationMs?: number;
     /** Emits UI:{playEvent} */
-    playEvent?: string;
+    playEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{completeEvent} with { success } */
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+    }>;
 }
 export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, className, }: EventHandlerBoardProps): React.JSX.Element;
 export declare namespace EventHandlerBoard {

package/dist/components/organisms/game/puzzles/negotiator/NegotiatorBoard.d.ts

@@ -11,6 +11,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface NegotiatorAction {
     id: string;
@@ -46,7 +47,10 @@ export interface NegotiatorPuzzleEntity {
 }
 export interface NegotiatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     entity: NegotiatorPuzzleEntity;
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        score: number;
+    }>;
 }
 export declare function NegotiatorBoard({ entity, completeEvent, className, }: NegotiatorBoardProps): React.JSX.Element;
 export declare namespace NegotiatorBoard {

package/dist/components/organisms/game/puzzles/sequencer/SequencerBoard.d.ts

@@ -18,6 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { SlotItemData } from '../../TraitSlot';
 import type { EntityDisplayProps } from '../../../types';
 export interface SequencerPuzzleEntity {
@@ -61,9 +62,14 @@ export interface SequencerBoardProps extends Omit<EntityDisplayProps, 'entity'>
     /** Playback speed in ms per step */
     stepDurationMs?: number;
     /** Emits UI:{playEvent} with { sequence: string[] } */
-    playEvent?: string;
+    playEvent?: EventEmit<{
+        sequence: string[];
+    }>;
     /** Emits UI:{completeEvent} with { success: boolean } */
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        sequence: string[];
+    }>;
 }
 export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, className, }: SequencerBoardProps): React.JSX.Element;
 export declare namespace SequencerBoard {

package/dist/components/organisms/game/puzzles/simulator/SimulatorBoard.d.ts

@@ -10,6 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 export interface SimulatorParameter {
     id: string;
@@ -46,7 +47,10 @@ export interface SimulatorPuzzleEntity {
 }
 export interface SimulatorBoardProps extends Omit<EntityDisplayProps, 'entity'> {
     entity: SimulatorPuzzleEntity;
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        attempts: number;
+    }>;
 }
 export declare function SimulatorBoard({ entity, completeEvent, className, }: SimulatorBoardProps): React.JSX.Element;
 export declare namespace SimulatorBoard {

package/dist/components/organisms/game/puzzles/state-architect/StateArchitectBoard.d.ts

@@ -8,6 +8,7 @@
  * @packageDocumentation
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 import type { EntityDisplayProps } from '../../../types';
 import { type VariableDef } from './VariablePanel';
 export interface StateArchitectTransition {
@@ -65,9 +66,12 @@ export interface StateArchitectBoardProps extends Omit<EntityDisplayProps, 'enti
     /** Playback speed */
     stepDurationMs?: number;
     /** Emits UI:{testEvent} */
-    testEvent?: string;
+    testEvent?: EventEmit<Record<string, never>>;
     /** Emits UI:{completeEvent} with { success, passedTests } */
-    completeEvent?: string;
+    completeEvent?: EventEmit<{
+        success: boolean;
+        passedTests: number;
+    }>;
 }
 export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, className, }: StateArchitectBoardProps): React.JSX.Element;
 export declare namespace StateArchitectBoard {

package/dist/components/organisms/game/three/hooks/useGameCanvas3DEvents.d.ts

@@ -1,21 +1,65 @@
+import type { EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../types/isometric';
 export interface GameCanvas3DEventConfig {
     /** Event name for tile clicks */
-    tileClickEvent?: string;
+    tileClickEvent?: EventEmit<{
+        tileId: string;
+        x: number;
+        z: number;
+        type?: string;
+        terrain?: string;
+        elevation?: number;
+    }>;
     /** Event name for unit clicks */
-    unitClickEvent?: string;
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+        x: number;
+        z: number;
+        unitType?: string;
+        name?: string;
+        team?: string;
+        faction?: string;
+        health?: number;
+        maxHealth?: number;
+    }>;
     /** Event name for feature clicks */
-    featureClickEvent?: string;
+    featureClickEvent?: EventEmit<{
+        featureId: string;
+        x: number;
+        z: number;
+        type?: string;
+        elevation?: number;
+    }>;
     /** Event name for canvas clicks */
-    canvasClickEvent?: string;
+    canvasClickEvent?: EventEmit<{
+        clientX: number;
+        clientY: number;
+        button: number;
+    }>;
     /** Event name for tile hover */
-    tileHoverEvent?: string;
+    tileHoverEvent?: EventEmit<{
+        tileId: string;
+        x: number;
+        z: number;
+        type?: string;
+    }>;
     /** Event name for tile leave */
-    tileLeaveEvent?: string;
+    tileLeaveEvent?: EventEmit<Record<string, never>>;
     /** Event name for unit animation changes */
-    unitAnimationEvent?: string;
+    unitAnimationEvent?: EventEmit<{
+        unitId: string;
+        state: string;
+        timestamp: number;
+    }>;
     /** Event name for camera changes */
-    cameraChangeEvent?: string;
+    cameraChangeEvent?: EventEmit<{
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        timestamp: number;
+    }>;
 }
 /** Minimal mouse event interface — satisfied by both React.MouseEvent and ThreeEvent<MouseEvent> */
 export interface MinimalMouseEvent {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.21.0",
+  "version": "4.22.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -118,7 +118,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^7.9.0",
+    "@almadar/core": "^7.10.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/patterns": ">=2.17.1",
     "@almadar/runtime": "^6.0.0",