@almadar/ui 5.81.0 → 5.83.0

package/dist/components/core/atoms/Badge.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { type IconInput } from "./Icon";
+import type { Asset } from "@almadar/core";
 export type BadgeVariant = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral";
 export type BadgeSize = "sm" | "md" | "lg";
 export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
@@ -15,6 +16,8 @@ export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
     label?: string | number;
     /** Lucide icon component or canonical kebab-case icon name string */
     icon?: IconInput;
+    /** Asset image rendered as the badge icon; takes precedence over icon when provided. */
+    iconAsset?: Asset;
     /** When set, renders a small X button on the right of the badge that
      *  invokes this handler — turns the badge into a removable chip.
      *  Used by the TagInput molecule and other "list of removable values"

package/dist/components/core/atoms/Button.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { EventKey, EventPayload } from "@almadar/core";
+import type { Asset, EventKey, EventPayload } from "@almadar/core";
 import { type IconInput } from "./Icon";
 export type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default";
 export type ButtonSize = "sm" | "md" | "lg";
@@ -17,6 +17,8 @@ export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElemen
     icon?: IconInput;
     /** Alias for rightIcon */
     iconRight?: IconInput;
+    /** Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided. */
+    iconAsset?: Asset;
     /** Declarative event name — emits UI:{action} via eventBus on click */
     action?: EventKey;
     /** Payload to include with the action event */

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

@@ -5,7 +5,7 @@
  * Uses theme-aware CSS variables for styling.
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { Asset, EventEmit } from '@almadar/core';
 import type { IconInput } from '../atoms/index';
 export interface TabItem {
     /**
@@ -24,6 +24,8 @@ export interface TabItem {
     content?: React.ReactNode;
     /** Tab icon — pass either a Lucide component or its registry name (e.g. "file-text") */
     icon?: IconInput;
+    /** Asset image rendered as the tab icon; takes precedence over icon when provided. */
+    iconAsset?: Asset;
     /** Tab badge */
     badge?: string | number;
     /** Disable tab */

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/GameCard.d.ts

@@ -5,6 +5,8 @@ export interface GameCardProps {
     cost?: number;
     /** Card art asset */
     art?: Asset;
+    /** Asset rendered as the card border/frame via backgroundImage; falls back to CSS border styling when absent. */
+    frameAsset?: Asset;
     attack?: number;
     defense?: number;
     name?: string;
@@ -20,7 +22,7 @@ export interface GameCardProps {
     }>;
     className?: string;
 }
-export declare function GameCard({ id, cost, art, attack, defense, name, selected, disabled, size, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
+export declare function GameCard({ id, cost, art, frameAsset, attack, defense, name, selected, disabled, size, onClick, clickEvent, className, }: GameCardProps): React.JSX.Element;
 export declare namespace GameCard {
     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';

package/dist/components/game/3d/index.cjs

@@ -3196,6 +3196,7 @@ var Button = React6__default.default.forwardRef(
     rightIcon,
     icon: iconProp,
     iconRight: iconRightProp,
+    iconAsset,
     action,
     actionPayload,
     label,
@@ -3207,7 +3208,8 @@ var Button = React6__default.default.forwardRef(
     const eventBus = useEventBus();
     const leftIconValue = leftIcon || iconProp;
     const rightIconValue = rightIcon || iconRightProp;
-    const resolvedLeftIcon = resolveIconProp(leftIconValue, iconSizeStyles[size]);
+    const px = size === "sm" ? 16 : size === "lg" ? 20 : 16;
+    const resolvedLeftIcon = iconAsset?.url ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: iconAsset.url, alt: iconAsset.name ?? iconAsset.category ?? "", width: px, height: px, style: { imageRendering: "pixelated", objectFit: "contain", width: px, height: px }, className: "flex-shrink-0" }) : resolveIconProp(leftIconValue, iconSizeStyles[size]);
     const resolvedRightIcon = resolveIconProp(rightIconValue, iconSizeStyles[size]);
     const handleClick = (e) => {
       if (action) {

package/dist/components/game/3d/index.js

@@ -3172,6 +3172,7 @@ var Button = React6.forwardRef(
     rightIcon,
     icon: iconProp,
     iconRight: iconRightProp,
+    iconAsset,
     action,
     actionPayload,
     label,
@@ -3183,7 +3184,8 @@ var Button = React6.forwardRef(
     const eventBus = useEventBus();
     const leftIconValue = leftIcon || iconProp;
     const rightIconValue = rightIcon || iconRightProp;
-    const resolvedLeftIcon = resolveIconProp(leftIconValue, iconSizeStyles[size]);
+    const px = size === "sm" ? 16 : size === "lg" ? 20 : 16;
+    const resolvedLeftIcon = iconAsset?.url ? /* @__PURE__ */ jsx("img", { src: iconAsset.url, alt: iconAsset.name ?? iconAsset.category ?? "", width: px, height: px, style: { imageRendering: "pixelated", objectFit: "contain", width: px, height: px }, className: "flex-shrink-0" }) : resolveIconProp(leftIconValue, iconSizeStyles[size]);
     const resolvedRightIcon = resolveIconProp(rightIconValue, iconSizeStyles[size]);
     const handleClick = (e) => {
       if (action) {