@almadar/ui 5.71.0 → 5.73.0

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

@@ -1,8 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ActionButtonProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Button label text */
     label: string;
     /** Icon displayed before the label */

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

@@ -1,12 +1,12 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ChoiceButtonProps {
     /** Choice text content */
     text: string;
     /** Choice index number (displayed as prefix) */
     index?: number;
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Icon displayed before the text */
     icon?: IconInput;
     /** Whether the choice is disabled */

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

@@ -1,7 +1,7 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ComboCounterProps {
-    /** Sprite image URL displayed alongside the combo number */
-    assetUrl?: AssetUrl;
+    /** Sprite asset displayed alongside the combo number */
+    assetUrl?: Asset;
     /** Current combo count */
     combo: number;
     /** Score multiplier */

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

@@ -1,8 +1,8 @@
-import type { EventKey, AssetUrl } from "@almadar/core";
+import type { EventKey, Asset } from "@almadar/core";
 import { type IconInput } from '../../core/atoms/Icon';
 export interface ControlButtonProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Button label text */
     label?: string;
     /** Icon component or emoji */

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

@@ -1,7 +1,7 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface DamageNumberProps {
-    /** Sprite image URL — displayed as a hit-effect icon alongside the number */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — displayed as a hit-effect icon alongside the number */
+    assetUrl?: Asset;
     /** The damage/heal value to display */
     value: number;
     /** Type of number display */

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

@@ -1,11 +1,11 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface DialogueBubbleProps {
     /** Speaker name displayed at the top */
     speaker?: string;
     /** Dialogue text content */
     text: string;
-    /** URL for the speaker portrait image */
-    portrait?: AssetUrl;
+    /** Speaker portrait asset */
+    portrait?: Asset;
     /** Position of the bubble on screen */
     position?: 'top' | 'bottom';
     /** Additional CSS classes */

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

@@ -1,8 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ItemSlotProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Icon component or emoji — shown only when assetUrl is absent */
     icon?: IconInput;
     /** Item label */

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

@@ -1,9 +1,9 @@
 import type { ColorToken } from '../../core/atoms/types';
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ResourceCounterProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Icon component or emoji */
     icon?: IconInput;
     /** Resource label */

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

@@ -1,8 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ScoreDisplayProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Current score value */
     value: number;
     /** Alias for value — common schema binding name */
@@ -15,12 +15,10 @@ export interface ScoreDisplayProps {
     size?: 'sm' | 'md' | 'lg' | 'xl';
     /** Additional CSS classes */
     className?: string;
-    /** Animation on value change */
-    animated?: boolean;
     /** Number formatting locale */
     locale?: string;
 }
-export declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, animated, locale, }: ScoreDisplayProps): import("react/jsx-runtime").JSX.Element;
+export declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale, }: ScoreDisplayProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ScoreDisplay {
     var displayName: string;
 }

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

@@ -4,10 +4,11 @@
  * Renders a single frame from a spritesheet with transform support.
  */
 import React from 'react';
-import type { EventKey, AssetUrl } from "@almadar/core";
+import type { EventKey, Asset } from "@almadar/core";
+import type { AnimationName } from '../organisms/types/spriteAnimation';
 export interface SpriteProps {
-    /** Spritesheet image URL */
-    spritesheet: AssetUrl;
+    /** Spritesheet asset */
+    spritesheet: Asset;
     /** Width of each frame in pixels */
     frameWidth: number;
     /** Height of each frame in pixels */
@@ -32,6 +33,10 @@ export interface SpriteProps {
     zIndex?: number;
     /** Number of columns in spritesheet (for frame calculation) */
     columns?: number;
+    /** Animation state name — drives lolo-ui config knob for animation selection */
+    animState?: AnimationName;
+    /** Frames per second — drives lolo-ui config knob for animation speed */
+    frameRate?: number;
     /** Optional className */
     className?: string;
     /** Optional onClick handler */
@@ -39,24 +44,7 @@ export interface SpriteProps {
     /** Declarative event name emitted on click via useEventBus */
     action?: EventKey;
 }
-/**
- * Sprite component for rendering spritesheet frames
- *
- * @example
- * ```tsx
- * <Sprite
- *   spritesheet="/sprites/player.png"
- *   frameWidth={32}
- *   frameHeight={32}
- *   frame={currentFrame}
- *   x={player.x}
- *   y={player.y}
- *   flipX={player.facingLeft}
- *   scale={2}
- * />
- * ```
- */
-export declare function Sprite({ spritesheet, frameWidth, frameHeight, frame, x, y, scale, flipX, flipY, rotation, opacity, zIndex, columns, className, onClick, action, }: SpriteProps): React.JSX.Element;
+export declare function Sprite({ spritesheet, frameWidth, frameHeight, frame, x, y, scale, flipX, flipY, rotation, opacity, zIndex, columns, animState: _animState, frameRate: _frameRate, className, onClick, action, }: SpriteProps): React.JSX.Element;
 /**
  * Canvas-based sprite renderer for better performance in game loops
  */

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

@@ -1,13 +1,13 @@
 import React from 'react';
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } 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;
+    assetUrl?: Asset;
     /** The current state name */
     state: string;
     /** Optional label override (defaults to capitalized state name) */

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

@@ -1,8 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface StatusEffectProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Lucide icon name or component */
     icon: IconInput;
     /** Label describing the effect */

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

@@ -1,7 +1,7 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface TurnIndicatorProps {
-    /** Sprite image URL — takes precedence over the dot indicator when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over the dot indicator when provided */
+    assetUrl?: Asset;
     /** Current turn number */
     currentTurn: number;
     /** Maximum number of turns */

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

@@ -1,8 +1,8 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface WaypointMarkerProps {
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Label text below the marker */
     label?: string;
     /** Custom icon to render inside the marker */

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

@@ -9,7 +9,7 @@ export interface XPBarProps {
     showLabel?: boolean;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg';
-    /** Animate the fill bar */
+    /** Animate the fill bar with a CSS transition */
     animated?: boolean;
     /** Additional CSS classes */
     className?: string;

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

@@ -1,9 +1,9 @@
 import * as React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { Asset, EventEmit } from '@almadar/core';
 /** One playable card (icon + title + a few stat numbers). UI value DTO. */
 export interface CardHandCard {
     id: string;
-    iconUrl?: AssetUrl;
+    iconUrl?: Asset;
     title?: string;
     cost?: number;
     attack?: number;

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

@@ -12,7 +12,7 @@
  * concern analogous to Form's `formData`.
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EventPayload } from '@almadar/core';
+import type { Asset, EventEmit, EventPayload } from '@almadar/core';
 export type DialogueChoice = EventPayload & {
     text: string;
     action?: string;
@@ -54,9 +54,9 @@ export interface DialogueBoxProps {
     /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
     advanceEvent?: EventEmit<Record<string, never>>;
     /** Optional full-frame scene image rendered behind the dialogue (visual-novel mode). */
-    backgroundImage?: AssetUrl;
+    backgroundImage?: Asset;
     /** Optional larger character portrait rendered standing over the scene (visual-novel mode). */
-    portraitUrl?: AssetUrl;
+    portraitUrl?: Asset;
     /** Multiplier for the large `portraitUrl` height relative to its default (default 1). */
     portraitScale?: number;
     /** Optional className */

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

@@ -1,5 +1,5 @@
 import type { IconInput } from '../../core/atoms';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface EnemyPlateEffect {
     /** Effect icon */
     icon: IconInput;
@@ -9,8 +9,8 @@ export interface EnemyPlateEffect {
     variant?: 'buff' | 'debuff' | 'neutral';
 }
 export interface EnemyPlateProps {
-    /** Portrait sprite URL — takes precedence over the default avatar slot */
-    assetUrl?: AssetUrl;
+    /** Portrait sprite asset — takes precedence over the default avatar slot */
+    assetUrl?: Asset;
     /** Enemy name */
     name: string;
     /** Current health */

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

@@ -1,4 +1,4 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset, AssetUrl } from '@almadar/core';
 export interface GameCanvas2DProps {
     /** Canvas width in pixels */
     width?: number;
@@ -14,8 +14,8 @@ export interface GameCanvas2DProps {
     drawEvent?: string;
     /** Target frames per second */
     fps?: number;
-    /** Background image URL */
-    backgroundImage?: AssetUrl;
+    /** Background image asset */
+    backgroundImage?: Asset;
     /** Base URL prefix for asset URLs */
     assetBaseUrl?: AssetUrl;
     /** Additional CSS classes */

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

@@ -46,8 +46,6 @@ export interface GameCanvas3DProps {
     isLoading?: boolean;
     /** Error state */
     error?: string | null;
-    /** Entity name for schema-driven auto-fetch */
-    entity?: string;
     /** Array of tiles to render */
     tiles?: IsometricTile[];
     /** Array of units to render */

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

@@ -1,9 +1,9 @@
 import type { IconInput } from '../../core/atoms';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface HealthEffect {
     icon: IconInput;
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     label?: string;
     variant?: 'buff' | 'debuff' | 'neutral';
 }

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

@@ -24,8 +24,8 @@
  * @packageDocumentation
  */
 import * as React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
+import type { Asset, AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../organisms/types/isometric';
 import type { ResolvedFrame } from '../organisms/types/spriteAnimation';
 import type { TileLayout } from '../organisms/utils/isometric';
 import type { UiError } from '../../core/atoms/types';
@@ -52,6 +52,8 @@ export interface IsometricCanvasProps {
     units?: IsometricUnit[];
     /** Array of features (resources, portals, buildings, etc.) */
     features?: IsometricFeature[];
+    /** Active visual effects to draw after units. Sprite URLs resolved via assetManifest.effects[fx.key]. */
+    effects?: ActiveEffect[];
     /** Currently selected unit ID */
     selectedUnitId?: string | null;
     /** Valid move positions (shown as pulsing green highlights) */
@@ -119,20 +121,16 @@ export interface IsometricCanvasProps {
     onDrawEffects?: (ctx: CanvasRenderingContext2D, animTime: number, getImage: (url: string) => HTMLImageElement | undefined) => void;
     /** Whether there are active effects — keeps RAF loop alive */
     hasActiveEffects?: boolean;
-    /** Base URL for remote asset resolution. When set, manifest paths
-     *  are prefixed with this URL. Example: "https://trait-wars-assets.web.app" */
-    assetBaseUrl?: AssetUrl;
-    /** Manifest mapping entity keys to relative sprite paths.
-     *  Combined with assetBaseUrl to produce full URLs.
-     *  Used as a fallback when inline URLs and callbacks don't resolve. */
+    /** Manifest mapping entity keys to resolved Asset objects.
+     *  Used as a fallback when inline assets and callbacks don't resolve. */
     assetManifest?: {
-        terrains?: Record<string, string>;
-        units?: Record<string, string>;
-        features?: Record<string, string>;
-        effects?: Record<string, string>;
+        terrains?: Record<string, Asset>;
+        units?: Record<string, Asset>;
+        features?: Record<string, Asset>;
+        effects?: Record<string, Asset>;
     };
 }
-export declare function IsometricCanvas({ className, isLoading, error, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, selectedUnitId, validMoves, attackTargets, hoveredTile, onTileClick, onUnitClick, onTileHover, onTileLeave, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, tileLayout, scale, debug, backgroundImage, showMinimap, enableCamera, unitScale, spriteHeightRatio, spriteMaxWidthRatio, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, hasActiveEffects, diamondTopY: diamondTopYProp, assetBaseUrl, assetManifest, }: IsometricCanvasProps): React.JSX.Element;
+export declare function IsometricCanvas({ className, isLoading, error, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, selectedUnitId, validMoves, attackTargets, hoveredTile, onTileClick, onUnitClick, onTileHover, onTileLeave, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, tileLayout, scale, debug, backgroundImage, showMinimap, enableCamera, unitScale, spriteHeightRatio, spriteMaxWidthRatio, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, hasActiveEffects: _hasActiveEffects, diamondTopY: diamondTopYProp, assetManifest, }: IsometricCanvasProps): React.JSX.Element;
 export declare namespace IsometricCanvas {
     var displayName: string;
 }

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

@@ -1,4 +1,5 @@
 import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { ActiveEffect } from '../organisms/types/isometric';
 export interface PlatformerPlatform {
     x: number;
     y: number;
@@ -48,10 +49,12 @@ export interface PlatformerCanvasProps {
     }>;
     jumpEvent?: EventEmit<Record<string, never>>;
     stopEvent?: EventEmit<Record<string, never>>;
+    /** Active visual effects (key, world x/y, ttl) — drawn after the player */
+    effects?: ActiveEffect[];
     /** Additional CSS classes */
     className?: string;
 }
-export declare function PlatformerCanvas({ player, platforms, worldWidth, worldHeight, canvasWidth, canvasHeight, followCamera, bgColor, playerSprite, tileSprites, backgroundImage, assetBaseUrl, leftEvent, rightEvent, jumpEvent, stopEvent, className, }: PlatformerCanvasProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlatformerCanvas({ player, platforms, worldWidth, worldHeight, canvasWidth, canvasHeight, followCamera, bgColor, playerSprite, tileSprites, backgroundImage, assetBaseUrl, leftEvent, rightEvent, jumpEvent, stopEvent, effects, className, }: PlatformerCanvasProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace PlatformerCanvas {
     var displayName: string;
 }

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

@@ -1,10 +1,10 @@
 import type { IconInput } from '../../core/atoms';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface ActivePowerup {
     /** Unique powerup ID */
     id: string;
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Icon component or emoji */
     icon?: IconInput;
     /** Powerup label */

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

@@ -1,5 +1,5 @@
 import { type IconInput } from '../../core/atoms/Icon';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } 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
@@ -7,8 +7,10 @@ import type { AssetUrl } from '@almadar/core';
  * 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;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
+    /** Asset image (board ui/ PNG); takes precedence over the Lucide icon. */
+    iconUrl?: Asset;
     /** Stat label */
     label: string;
     /** Current value (defaults to 0 if not provided) */
@@ -30,7 +32,7 @@ export interface StatBadgeProps {
     /** Additional CSS classes */
     className?: string;
 }
-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 function StatBadge({ assetUrl, iconUrl, 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;
 }

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

@@ -1,10 +1,10 @@
 import type { IconInput } from '../../core/atoms';
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 export interface TurnPanelAction {
     /** Action button label */
     label: string;
-    /** Sprite image URL — takes precedence over icon when provided */
-    assetUrl?: AssetUrl;
+    /** Sprite asset — takes precedence over icon when provided */
+    assetUrl?: Asset;
     /** Icon for the button */
     icon?: IconInput;
     /** Event name to emit when clicked */