@almadar/ui 5.47.0 → 5.49.0

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

@@ -8,6 +8,9 @@ export { GameShell, type GameShellProps } from '../../game/templates/GameShell';
 export { BattleTemplate, type BattleTemplateProps, type BattlePhase, type BattleSlotContext, } from '../../game/templates/BattleTemplate';
 export { CastleTemplate, type CastleTemplateProps, type CastleSlotContext, } from '../../game/templates/CastleTemplate';
 export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext, } from '../../game/templates/WorldMapTemplate';
+export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/templates/PlatformerTemplate';
+export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/templates/TowerDefenseTemplate';
+export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/templates/RoguelikeTemplate';
 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/atoms/ActionButton.d.ts

@@ -1,5 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface ActionButtonProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Button label text */
     label: string;
     /** Icon displayed before the label */
@@ -19,7 +22,7 @@ export interface ActionButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ActionButton({ label, icon, cooldown, disabled, hotkey, size, variant, onClick, className, }: ActionButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActionButton({ assetUrl, label, icon, cooldown, disabled, hotkey, size, variant, onClick, className, }: ActionButtonProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ActionButton {
     var displayName: string;
 }

package/dist/components/game/atoms/ComboCounter.d.ts

@@ -1,4 +1,7 @@
+import type { AssetUrl } from '@almadar/core';
 export interface ComboCounterProps {
+    /** Sprite image URL displayed alongside the combo number */
+    assetUrl?: AssetUrl;
     /** Current combo count */
     combo: number;
     /** Score multiplier */
@@ -10,7 +13,7 @@ export interface ComboCounterProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ComboCounter({ combo, multiplier, streak, size, className, }: ComboCounterProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ComboCounter({ assetUrl, combo, multiplier, streak, size, className, }: ComboCounterProps): import("react/jsx-runtime").JSX.Element | null;
 export declare namespace ComboCounter {
     var displayName: string;
 }

package/dist/components/game/atoms/ControlButton.d.ts

@@ -1,6 +1,8 @@
-import type { EventKey } from "@almadar/core";
+import type { EventKey, AssetUrl } from "@almadar/core";
 import { type IconInput } from '../../core/atoms/Icon';
 export interface ControlButtonProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Button label text */
     label?: string;
     /** Icon component or emoji */
@@ -26,7 +28,7 @@ export interface ControlButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ControlButton({ label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ControlButton({ assetUrl, label, icon, size, shape, variant, onPress, onRelease, pressEvent, releaseEvent, pressed, disabled, className, }: ControlButtonProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ControlButton {
     var displayName: string;
 }

package/dist/components/game/atoms/DamageNumber.d.ts

@@ -1,4 +1,7 @@
+import type { AssetUrl } from '@almadar/core';
 export interface DamageNumberProps {
+    /** Sprite image URL — displayed as a hit-effect icon alongside the number */
+    assetUrl?: AssetUrl;
     /** The damage/heal value to display */
     value: number;
     /** Type of number display */
@@ -8,7 +11,7 @@ export interface DamageNumberProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function DamageNumber({ value, type, size, className, }: DamageNumberProps): import("react/jsx-runtime").JSX.Element;
+export declare function DamageNumber({ assetUrl, value, type, size, className, }: DamageNumberProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace DamageNumber {
     var displayName: string;
 }

package/dist/components/game/atoms/ResourceCounter.d.ts

@@ -1,6 +1,9 @@
 import type { ColorToken } from '../../core/atoms/types';
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface ResourceCounterProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Icon component or emoji */
     icon?: IconInput;
     /** Resource label */
@@ -16,7 +19,7 @@ export interface ResourceCounterProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ResourceCounter({ icon, label, value, max, color, size, className, }: ResourceCounterProps): import("react/jsx-runtime").JSX.Element;
+export declare function ResourceCounter({ assetUrl, icon, label, value, max, color, size, className, }: ResourceCounterProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ResourceCounter {
     var displayName: string;
 }

package/dist/components/game/atoms/ScoreDisplay.d.ts

@@ -1,5 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface ScoreDisplayProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Current score value */
     value: number;
     /** Label to display before score */
@@ -15,7 +18,7 @@ export interface ScoreDisplayProps {
     /** Number formatting locale */
     locale?: string;
 }
-export declare function ScoreDisplay({ value, label, icon, size, className, animated, locale, ...rest }: ScoreDisplayProps & Record<string, unknown>): import("react/jsx-runtime").JSX.Element;
+export declare function ScoreDisplay({ assetUrl, value, label, icon, size, className, animated, locale, ...rest }: ScoreDisplayProps & Record<string, unknown>): import("react/jsx-runtime").JSX.Element;
 export declare namespace ScoreDisplay {
     var displayName: string;
 }

package/dist/components/game/atoms/StateIndicator.d.ts

@@ -1,16 +1,13 @@
-/**
- * StateIndicator — animated game-entity state pill (distinct from core Badge atom).
- * Badge is a static text label. StateIndicator maps a state string (idle/active/
- * moving/…) to icon + bg colour + optional pulse via a style registry that callers
- * can extend. Use it in game HUDs where the entity state machine drives the display.
- */
 import React from 'react';
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface StateStyle {
     icon: IconInput;
     bgClass: string;
 }
 export interface StateIndicatorProps {
+    /** Sprite image URL — takes precedence over the state icon when provided */
+    assetUrl?: AssetUrl;
     /** The current state name */
     state: string;
     /** Optional label override (defaults to capitalized state name) */
@@ -24,7 +21,7 @@ export interface StateIndicatorProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function StateIndicator({ state, label, size, animated, stateStyles, className, }: StateIndicatorProps): React.JSX.Element;
+export declare function StateIndicator({ assetUrl, state, label, size, animated, stateStyles, className, }: StateIndicatorProps): React.JSX.Element;
 export declare namespace StateIndicator {
     var displayName: string;
 }

package/dist/components/game/atoms/StatusEffect.d.ts

@@ -1,5 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface StatusEffectProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Lucide icon name or component */
     icon: IconInput;
     /** Label describing the effect */
@@ -15,7 +18,7 @@ export interface StatusEffectProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function StatusEffect({ icon, label, duration, stacks, variant, size, className, }: StatusEffectProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusEffect({ assetUrl, icon, label, duration, stacks, variant, size, className, }: StatusEffectProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace StatusEffect {
     var displayName: string;
 }

package/dist/components/game/atoms/TurnIndicator.d.ts

@@ -1,4 +1,7 @@
+import type { AssetUrl } from '@almadar/core';
 export interface TurnIndicatorProps {
+    /** Sprite image URL — takes precedence over the dot indicator when provided */
+    assetUrl?: AssetUrl;
     /** Current turn number */
     currentTurn: number;
     /** Maximum number of turns */
@@ -12,7 +15,7 @@ export interface TurnIndicatorProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function TurnIndicator({ currentTurn, maxTurns, activeTeam, phase, size, className, }: TurnIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function TurnIndicator({ assetUrl, currentTurn, maxTurns, activeTeam, phase, size, className, }: TurnIndicatorProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace TurnIndicator {
     var displayName: string;
 }

package/dist/components/game/atoms/WaypointMarker.d.ts

@@ -1,5 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface WaypointMarkerProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Label text below the marker */
     label?: string;
     /** Custom icon to render inside the marker */
@@ -13,7 +16,7 @@ export interface WaypointMarkerProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function WaypointMarker({ label, icon, active, completed, size, className, }: WaypointMarkerProps): import("react/jsx-runtime").JSX.Element;
+export declare function WaypointMarker({ assetUrl, label, icon, active, completed, size, className, }: WaypointMarkerProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace WaypointMarker {
     var displayName: string;
 }

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

@@ -1,4 +1,5 @@
 import type { IconInput } from '../../core/atoms';
+import type { AssetUrl } from '@almadar/core';
 export interface EnemyPlateEffect {
     /** Effect icon */
     icon: IconInput;
@@ -8,6 +9,8 @@ export interface EnemyPlateEffect {
     variant?: 'buff' | 'debuff' | 'neutral';
 }
 export interface EnemyPlateProps {
+    /** Portrait sprite URL — takes precedence over the default avatar slot */
+    assetUrl?: AssetUrl;
     /** Enemy name */
     name: string;
     /** Current health */
@@ -21,7 +24,7 @@ export interface EnemyPlateProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function EnemyPlate({ name, health, maxHealth, level, effects, className, }: EnemyPlateProps): import("react/jsx-runtime").JSX.Element;
+export declare function EnemyPlate({ assetUrl, name, health, maxHealth, level, effects, className, }: EnemyPlateProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace EnemyPlate {
     var displayName: string;
 }

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

@@ -1,4 +1,5 @@
 import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 /**
  * StatBadge — game stat display molecule (distinct from core Badge atom).
  * Badge shows a text label/status token. StatBadge shows a numeric value
@@ -6,6 +7,8 @@ import { type IconInput } from '../../core/atoms/Icon';
  * a named label — purpose-built for HUD stat rows, not general status tags.
  */
 export interface StatBadgeProps {
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Stat label */
     label: string;
     /** Current value (defaults to 0 if not provided) */
@@ -27,7 +30,7 @@ export interface StatBadgeProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function StatBadge({ label, value, max, format, icon, size, variant, className, source: _source, field: _field, }: StatBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatBadge({ assetUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, }: StatBadgeProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace StatBadge {
     var displayName: string;
 }