@almadar/ui 5.82.0 → 5.84.0

package/dist/components/core/templates/index.d.ts

@@ -5,16 +5,6 @@ export { CounterTemplate, type CounterTemplateProps, type CounterSize, type Coun
 export { GameTemplate, type GameTemplateProps } from '../../game/2d/templates/GameTemplate';
 export { GenericAppTemplate, type GenericAppTemplateProps } from './GenericAppTemplate';
 export { GameShell, type GameShellProps } from '../../game/2d/templates/GameShell';
-export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/2d/templates/BattleTemplate';
-export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/2d/templates/CastleTemplate';
-export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/2d/templates/WorldMapTemplate';
-export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/2d/templates/PlatformerTemplate';
-export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/2d/templates/TowerDefenseTemplate';
-export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/2d/templates/RoguelikeTemplate';
-export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/2d/templates/TopDownShooterTemplate';
-export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/2d/templates/CityBuilderTemplate';
-export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/2d/templates/VisualNovelTemplate';
-export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/2d/templates/CardBattlerTemplate';
 export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, } from '../../marketing/templates/LandingPageTemplate';
 export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, } from '../../marketing/templates/PricingPageTemplate';
 export { FeatureDetailPageTemplate, type FeatureDetailPageTemplateProps, type FeatureDetailPageEntity, type FeatureDetailSection, } from '../../marketing/templates/FeatureDetailPageTemplate';

package/dist/components/game/2d/atoms/ChoiceButton.d.ts

@@ -17,10 +17,12 @@ export interface ChoiceButtonProps {
     onClick?: () => void;
     /** Declarative event name — emits UI:{action} via eventBus on click */
     action?: EventKey;
+    /** Semantic payload emitted with the action (e.g. `{ nextId, choiceIndex }` for a branching choice). */
+    payload?: Record<string, string | number | boolean>;
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, action, payload, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ChoiceButton {
     var displayName: string;
 }

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

@@ -101,10 +101,11 @@ export interface Canvas2DProps {
     }>;
     /** Emits UI:{tileLeaveEvent} with {} on tile leave */
     tileLeaveEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{keyEvent} with { key } on keydown — for side/free keyboard control */
-    keyEvent?: EventEmit<{
-        key: string;
-    }>;
+    /** Maps a keydown `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "LEFT", KeyA: "LEFT", Space: "JUMP" }`.
+     *  The input layer emits `UI:<event>` so the FSM stays device-agnostic — keyboard and d-pad converge on the same events. */
+    keyMap?: Record<string, string>;
+    /** Maps a keyup `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "STOP" }`. Omit a key to ignore its release (e.g. jump). */
+    keyUpMap?: Record<string, string>;
     /** Camera behavior (default 'pan-zoom'). */
     camera?: CameraMode;
     /** Render scale (0.4 = 40% zoom). */
@@ -154,7 +155,7 @@ export interface Canvas2DProps {
         effects?: Record<string, Asset>;
     };
 }
-export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyEvent, camera, scale, unitScale, showMinimap, animate, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
+export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, camera, scale, unitScale, showMinimap, animate, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
 export declare namespace Canvas2D {
     var displayName: string;
 }

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

@@ -32,13 +32,18 @@ export interface ControlGridProps {
         direction: DPadDirection;
         pressed: boolean;
     }>;
+    /** Per-direction PRESS → the board's SEMANTIC event (kind="dpad"), e.g. `{ left: "LEFT", right: "RIGHT", up: "JUMP" }`.
+     *  Lets the d-pad emit the SAME intent events as the keyboard so the FSM stays device-agnostic. */
+    directionEvents?: Partial<Record<DPadDirection, string>>;
+    /** Per-direction RELEASE → semantic event, e.g. `{ left: "STOP", right: "STOP" }`. Omit a direction to ignore its release. */
+    directionReleaseEvents?: Partial<Record<DPadDirection, string>>;
     /** Per-direction sprite assets for kind="dpad" buttons (e.g. Kenny arrow PNGs). Falls back to arrow emoji. */
     directionAssets?: Partial<Record<DPadDirection, Asset>>;
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;
     className?: string;
 }
-export declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionAssets, size, disabled, className, }: ControlGridProps): React.JSX.Element;
+export declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, className, }: ControlGridProps): React.JSX.Element;
 export declare namespace ControlGrid {
     var displayName: string;
 }

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

@@ -40,32 +40,8 @@ export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudi
 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';
@@ -95,13 +71,3 @@ export type { PhysicsPreset, PhysicsBody, PhysicsConstraint } from '../../shared
 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';