@almadar/ui 4.21.0 → 4.22.1

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.) */