@almadar/ui 1.0.20 → 1.0.21

package/dist/components/index.d.ts

@@ -28,6 +28,12 @@ interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElem
     icon?: LucideIcon;
     /** Right icon as Lucide icon component (convenience prop) */
     iconRight?: LucideIcon;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
+    /** Payload to include with the action event */
+    actionPayload?: Record<string, unknown>;
+    /** Button label text (alternative to children for schema-driven rendering) */
+    label?: string;
 }
 declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
 
@@ -166,6 +172,10 @@ interface AvatarProps {
      * Click handler
      */
     onClick?: () => void;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
+    /** Payload to include with the action event */
+    actionPayload?: Record<string, unknown>;
 }
 declare const Avatar: React__default.FC<AvatarProps>;
 
@@ -214,6 +224,12 @@ interface BoxProps extends React__default.HTMLAttributes<HTMLDivElement> {
     position?: "relative" | "absolute" | "fixed" | "sticky";
     /** HTML element to render as */
     as?: React__default.ElementType;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
+    /** Payload to include with the action event */
+    actionPayload?: Record<string, unknown>;
+    /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave */
+    hoverEvent?: string;
 }
 /**
  * Box - Versatile container component with design tokens
@@ -486,6 +502,10 @@ interface StackProps {
     role?: string;
     /** Tab index for focus management */
     tabIndex?: number;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
+    /** Payload to include with the action event */
+    actionPayload?: Record<string, unknown>;
 }
 /**
  * Stack - Flexible layout component for arranging children
@@ -548,6 +568,10 @@ interface TextHighlightProps {
      * Highlighted text content
      */
     children: React__default.ReactNode;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
+    /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } */
+    hoverEvent?: string;
 }
 /**
  * TextHighlight component for rendering highlighted text annotations
@@ -678,6 +702,8 @@ interface OverlayProps {
     onClick?: (e: React__default.MouseEvent) => void;
     className?: string;
     blur?: boolean;
+    /** Declarative event name — emits UI:{action} via eventBus on click */
+    action?: string;
 }
 declare const Overlay: React__default.FC<OverlayProps>;
 
@@ -853,6 +879,10 @@ interface ControlButtonProps {
     onPress?: () => void;
     /** Called when button is released */
     onRelease?: () => void;
+    /** Declarative event name emitted on press via useEventBus */
+    pressEvent?: string;
+    /** Declarative event name emitted on release via useEventBus */
+    releaseEvent?: string;
     /** Whether the button is currently pressed */
     pressed?: boolean;
     /** Whether the button is disabled */
@@ -860,7 +890,7 @@ interface ControlButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-declare function ControlButton({ label, icon, size, shape, variant, onPress, onRelease, pressed, disabled, className, }: ControlButtonProps): react_jsx_runtime.JSX.Element;
+declare function ControlButton({ label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): react_jsx_runtime.JSX.Element;
 declare namespace ControlButton {
     var displayName: string;
 }
@@ -901,6 +931,8 @@ interface SpriteProps {
     className?: string;
     /** Optional onClick handler */
     onClick?: () => void;
+    /** Declarative event name emitted on click via useEventBus */
+    action?: string;
 }
 /**
  * Sprite component for rendering spritesheet frames
@@ -919,7 +951,7 @@ interface SpriteProps {
  * />
  * ```
  */
-declare function Sprite({ spritesheet, frameWidth, frameHeight, frame, x, y, scale, flipX, flipY, rotation, opacity, zIndex, columns, className, onClick, }: SpriteProps): JSX.Element;
+declare function Sprite({ spritesheet, frameWidth, frameHeight, frame, x, y, scale, flipX, flipY, rotation, opacity, zIndex, columns, className, onClick, action, }: SpriteProps): JSX.Element;
 /**
  * Canvas-based sprite renderer for better performance in game loops
  */
@@ -961,6 +993,8 @@ interface EmptyStateProps {
     destructive?: boolean;
     /** 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;
 }
 declare const EmptyState: React__default.FC<EmptyStateProps>;
 
@@ -979,6 +1013,8 @@ interface ErrorStateProps {
     description?: string;
     onRetry?: () => void;
     className?: string;
+    /** Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked */
+    retryEvent?: string;
 }
 declare const ErrorState: React__default.FC<ErrorStateProps>;
 
@@ -1045,6 +1081,8 @@ interface AccordionProps {
      * Additional CSS classes
      */
     className?: string;
+    /** Declarative toggle event — emits UI:{toggleEvent} with { itemId, isOpen } */
+    toggleEvent?: string;
 }
 declare const Accordion: React__default.FC<AccordionProps>;
 
@@ -1068,6 +1106,8 @@ interface AlertProps {
     onClose?: () => void;
     actions?: React__default.ReactNode;
     className?: string;
+    /** Declarative dismiss event — emits UI:{dismissEvent} via eventBus when alert is dismissed */
+    dismissEvent?: string;
 }
 declare const Alert: React__default.FC<AlertProps>;
 
@@ -1103,6 +1143,8 @@ interface BreadcrumbItem {
      * Is current page
      */
     isCurrent?: boolean;
+    /** Event name to emit when clicked (for trait state machine integration) */
+    event?: string;
 }
 interface BreadcrumbProps {
     /**
@@ -1249,7 +1291,9 @@ declare const FilterGroup: React__default.FC<FilterGroupProps>;
 
 interface CardAction {
     label: string;
-    onClick: () => void;
+    onClick?: () => void;
+    /** Event name to emit when clicked (for trait state machine integration) */
+    event?: string;
     variant?: "default" | "primary" | "danger";
     icon?: string;
     disabled?: boolean;
@@ -1269,11 +1313,13 @@ interface CardProps {
     onClick?: () => void;
     /** Additional CSS classes */
     className?: string;
+    /** Declarative event name — emits UI:{action} via eventBus on card click */
+    action?: string;
 }
 /**
  * Card component for displaying content in a contained box
  */
-declare function Card({ title, subtitle, image, actions, children, onClick, className, }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ title, subtitle, image, actions, children, onClick, className, action, }: CardProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Container Component
@@ -1371,7 +1417,9 @@ interface FloatingAction {
     /**
      * Action click handler
      */
-    onClick: () => void;
+    onClick?: () => void;
+    /** Event name to emit when clicked (for trait state machine integration) */
+    event?: string;
     /**
      * Action variant
      */
@@ -1554,6 +1602,8 @@ interface ModalProps {
     closeOnOverlayClick?: boolean;
     closeOnEscape?: boolean;
     className?: string;
+    /** Declarative close event — emits UI:{closeEvent} via eventBus when modal should close */
+    closeEvent?: string;
 }
 declare const Modal: React__default.FC<ModalProps>;
 
@@ -1617,6 +1667,10 @@ interface PaginationProps {
      * Additional CSS classes
      */
     className?: string;
+    /** Declarative page change event — emits UI:{pageChangeEvent} with { page } */
+    pageChangeEvent?: string;
+    /** Declarative page size change event — emits UI:{pageSizeChangeEvent} with { pageSize } */
+    pageSizeChangeEvent?: string;
 }
 declare const Pagination: React__default.FC<PaginationProps>;
 
@@ -1813,6 +1867,8 @@ interface SidePanelProps {
      * Additional CSS classes
      */
     className?: string;
+    /** Declarative close event — emits UI:{closeEvent} via eventBus when panel should close */
+    closeEvent?: string;
 }
 declare const SidePanel: React__default.FC<SidePanelProps>;
 
@@ -1917,6 +1973,10 @@ interface ToastProps {
     badge?: string | number;
     /** Additional CSS classes */
     className?: string;
+    /** Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed */
+    dismissEvent?: string;
+    /** Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked */
+    actionEvent?: string;
 }
 declare const Toast: React__default.FC<ToastProps>;
 
@@ -1988,6 +2048,8 @@ interface DrawerProps {
     closeOnEscape?: boolean;
     /** Additional class name */
     className?: string;
+    /** Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close */
+    closeEvent?: string;
 }
 declare const Drawer: React__default.FC<DrawerProps>;
 
@@ -2025,6 +2087,8 @@ interface WizardProgressProps {
     compact?: boolean;
     /** Additional CSS classes */
     className?: string;
+    /** Declarative step click event — emits UI:{stepClickEvent} with { stepIndex } */
+    stepClickEvent?: string;
 }
 /**
  * WizardProgress - Step progress indicator
@@ -3944,6 +4008,14 @@ interface IsometricCanvasProps {
     onTileHover?: (x: number, y: number) => void;
     /** Tile leave handler */
     onTileLeave?: () => void;
+    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: string;
+    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: string;
+    /** Declarative event: emits UI:{tileHoverEvent} with { x, y } on tile hover */
+    tileHoverEvent?: string;
+    /** Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave */
+    tileLeaveEvent?: string;
     /** Render scale (0.4 = 40% zoom) */
     scale?: number;
     /** Show debug grid lines and coordinates */
@@ -3983,7 +4055,7 @@ interface IsometricCanvasProps {
         effects?: Record<string, string>;
     };
 }
-declare function IsometricCanvas({ className, isLoading, error, entity, tiles: tilesProp, units, features, selectedUnitId, validMoves, attackTargets, hoveredTile, onTileClick, onUnitClick, onTileHover, onTileLeave, scale, debug, backgroundImage, showMinimap, enableCamera, unitScale, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, hasActiveEffects, assetBaseUrl, assetManifest, }: IsometricCanvasProps): JSX.Element;
+declare function IsometricCanvas({ className, isLoading, error, entity, tiles: tilesProp, units, features, selectedUnitId, validMoves, attackTargets, hoveredTile, onTileClick, onUnitClick, onTileHover, onTileLeave, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, scale, debug, backgroundImage, showMinimap, enableCamera, unitScale, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, hasActiveEffects, assetBaseUrl, assetManifest, }: IsometricCanvasProps): JSX.Element;
 declare namespace IsometricCanvas {
     var displayName: string;
 }
@@ -4061,6 +4133,8 @@ interface CanvasEffectProps {
     intensity?: number;
     /** Callback when the effect animation completes */
     onComplete?: () => void;
+    /** Declarative event: emits UI:{completeEvent} when the effect animation completes */
+    completeEvent?: string;
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */
@@ -4524,11 +4598,17 @@ interface InventoryPanelProps {
     /** Currently selected slot index */
     selectedSlot?: number;
     /** Called when a slot is selected */
-    onSelectSlot: (index: number) => void;
+    onSelectSlot?: (index: number) => void;
     /** Called when an item is used (double-click or Enter) */
     onUseItem?: (item: InventoryItem) => void;
     /** 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;
     /** Show item tooltips on hover */
     showTooltips?: boolean;
     /** Optional className */
@@ -4552,7 +4632,7 @@ interface InventoryPanelProps {
  * />
  * ```
  */
-declare function InventoryPanel({ items, slots, columns, selectedSlot, onSelectSlot, onUseItem, onDropItem, showTooltips, className, slotSize, }: InventoryPanelProps): JSX.Element;
+declare function InventoryPanel({ items, slots, columns, selectedSlot, onSelectSlot, onUseItem, onDropItem, selectSlotEvent, useItemEvent, dropItemEvent, showTooltips, className, slotSize, }: InventoryPanelProps): JSX.Element;
 
 /**
  * DialogueBox Component
@@ -4586,6 +4666,12 @@ interface DialogueBoxProps {
     onChoice?: (choice: DialogueChoice) => void;
     /** 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;
+    /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
+    advanceEvent?: string;
     /** Optional className */
     className?: string;
 }
@@ -4610,7 +4696,7 @@ interface DialogueBoxProps {
  * />
  * ```
  */
-declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, className, }: DialogueBoxProps): JSX.Element;
+declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, className, }: DialogueBoxProps): JSX.Element;
 
 /**
  * UISlotRenderer Component