@almadar/ui 5.71.0 → 5.73.0

package/dist/components/game/organisms/BattleBoard.d.ts

@@ -18,7 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
@@ -48,11 +48,10 @@ export type BattleSlotContext = {
 };
 /** Asset manifest shape for BattleBoard. */
 type BattleAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
-    effects?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    effects?: Record<string, Asset>;
 };
 export interface BattleBoardProps extends DisplayStateProps {
     /** Entity (single board state) containing all board data */

package/dist/components/game/organisms/CardBattlerBoard.d.ts

@@ -1,10 +1,9 @@
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
-/** Manifest of asset base-url + per-card sprite map (UI value DTO). */
+/** Manifest of per-card sprite map (UI value DTO). */
 type CardBattlerAssetManifest = {
-    baseUrl?: AssetUrl;
-    cards?: Record<string, AssetUrl>;
+    cards?: Record<string, Asset>;
 };
 /** One card as carried on the entity / passed as a prop. */
 export interface CardBattlerCard {

package/dist/components/game/organisms/CastleBoard.d.ts

@@ -13,14 +13,13 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
-/** Manifest of asset base-url + per-kind sprite maps (UI value DTO). */
+/** Manifest of per-kind sprite maps (UI value DTO). */
 type CastleAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
 };
 /** Context exposed to render-prop slots */
 export type CastleSlotContext = {

package/dist/components/game/organisms/CityBuilderBoard.d.ts

@@ -1,18 +1,17 @@
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
-/** Manifest of asset base-url + per-kind sprite maps (UI value DTO). */
+/** Manifest of per-kind sprite maps (UI value DTO). */
 type CityBuilderAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
 };
 export interface CityBuilderTile {
     x: number;
     y: number;
     terrain?: string;
-    terrainSprite?: AssetUrl;
+    terrainSprite?: Asset;
     passable?: boolean;
 }
 export interface CityBuilderBuilding {

package/dist/components/game/organisms/FishingBoard.d.ts

@@ -1,11 +1,9 @@
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { Asset, EventEmit } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 export interface FishingBoardProps extends DisplayStateProps {
-    /** Background image URL for the fishing scene */
-    backgroundImage?: AssetUrl;
-    /** Base URL prepended to asset paths */
-    assetBaseUrl?: AssetUrl;
+    /** Background image asset for the fishing scene */
+    backgroundImage?: Asset;
     /** Render scale */
     scale?: number;
     /** Show minimap overlay */
@@ -26,7 +24,7 @@ export interface FishingBoardProps extends DisplayStateProps {
         unitId: string;
     }>;
 }
-export declare function FishingBoard({ backgroundImage, assetBaseUrl, scale, showMinimap, enableCamera, width, height, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
+export declare function FishingBoard({ backgroundImage, scale, showMinimap, enableCamera, width, height, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
 export declare namespace FishingBoard {
     var displayName: string;
 }

package/dist/components/game/organisms/PlatformerBoard.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { PlatformerPlatform, PlatformerPlayer } from '../molecules/PlatformerCanvas';
 export interface PlatformerBoardProps {
     /** Entity containing all board state (result, lives, score, level, player, platforms) */
@@ -21,10 +21,10 @@ export interface PlatformerBoardProps {
     worldHeight?: number;
     canvasWidth?: number;
     canvasHeight?: number;
-    /** Player sprite URL */
-    playerSprite?: AssetUrl;
-    /** Map of platform type to tile sprite URL */
-    tileSprites?: Record<string, AssetUrl>;
+    /** Player sprite */
+    playerSprite?: Asset;
+    /** Map of platform type to tile sprite */
+    tileSprites?: Record<string, Asset>;
     /** Canvas background color */
     bgColor?: string;
     /** Event names forwarded to PlatformerCanvas */

package/dist/components/game/organisms/RoguelikeBoard.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 import type { IsometricTile } from './types/isometric';
 type PlayerPos = {
@@ -20,10 +20,9 @@ type ItemRow = {
     kind: 'health_potion' | 'sword' | 'shield';
 };
 type RoguelikeAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
 };
 export interface RoguelikeBoardProps extends DisplayStateProps {
     entity?: EntityRow | readonly EntityRow[];

package/dist/components/game/organisms/TopDownShooterBoard.d.ts

@@ -1,11 +1,10 @@
 import * as React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
-/** Asset base-url + per-kind sprite maps (organism owns asset choice; UI value DTO). */
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
+/** Per-kind sprite maps (organism owns asset choice; UI value DTO). */
 type ShooterAssetManifest = {
-    baseUrl?: AssetUrl;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
-    background?: AssetUrl;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
+    background?: Asset;
 };
 export interface ShooterPlayer {
     x: number;

package/dist/components/game/organisms/TowerDefenseBoard.d.ts

@@ -1,12 +1,11 @@
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
-/** Manifest of asset base-url + per-kind sprite maps (UI value DTO). */
+/** Manifest of per-kind sprite maps (UI value DTO). */
 type TowerDefenseAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
 };
 export interface TowerDefenseTile {
     x: number;

package/dist/components/game/organisms/VisualNovelBoard.d.ts

@@ -7,13 +7,12 @@
  * the `assetManifest` prop (organism owns asset choice — no hardcoded URLs).
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
-/** Manifest of asset base-url + per-key scene + portrait maps (UI value DTO). */
+/** Manifest of per-key scene + portrait maps (UI value DTO). */
 type VisualNovelAssetManifest = {
-    baseUrl?: AssetUrl;
-    backgrounds?: Record<string, AssetUrl>;
-    portraits?: Record<string, AssetUrl>;
+    backgrounds?: Record<string, Asset>;
+    portraits?: Record<string, Asset>;
 };
 export interface VisualNovelChoice {
     label: string;

package/dist/components/game/organisms/WorldMapBoard.d.ts

@@ -19,16 +19,15 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
+import type { Asset, AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { ResolvedFrame } from './types/spriteAnimation';
 import type { UiError } from '../../core/atoms/types';
-/** Manifest of asset base-url + per-kind sprite maps (UI value DTO). */
+/** Manifest of per-kind sprite maps (UI value DTO). */
 type WorldMapAssetManifest = {
-    baseUrl?: AssetUrl;
-    terrains?: Record<string, AssetUrl>;
-    units?: Record<string, AssetUrl>;
-    features?: Record<string, AssetUrl>;
+    terrains?: Record<string, Asset>;
+    units?: Record<string, Asset>;
+    features?: Record<string, Asset>;
 };
 /** Context exposed to render-prop slots. Hex / hero rows are `EntityRow`. */
 export type WorldMapSlotContext = {

package/dist/components/game/organisms/types/effects.d.ts

@@ -1,4 +1,3 @@
-import type { AssetUrl } from '@almadar/core';
 /**
  * Canvas Effect Types
  *
@@ -12,7 +11,7 @@ import type { AssetUrl } from '@almadar/core';
  */
 export interface CanvasParticle {
     /** Sprite URL (white-on-transparent particle) */
-    spriteUrl: AssetUrl;
+    spriteUrl: string;
     /** Current position in screen pixels */
     x: number;
     y: number;
@@ -51,7 +50,7 @@ export interface CanvasParticle {
  */
 export interface ParticleEmitterConfig {
     /** Array of sprite URLs to randomly pick from */
-    spriteUrls: AssetUrl[];
+    spriteUrls: string[];
     /** Number of particles to spawn */
     count: number;
     /** Spawn origin in screen pixels */
@@ -96,7 +95,7 @@ export interface ParticleEmitterConfig {
  */
 export interface CanvasSequence {
     /** Ordered array of frame sprite URLs */
-    frameUrls: AssetUrl[];
+    frameUrls: string[];
     /** Position in screen pixels (top-left of sprite) */
     x: number;
     y: number;
@@ -123,7 +122,7 @@ export interface CanvasSequence {
  * Configuration for spawning a frame sequence.
  */
 export interface SequenceConfig {
-    frameUrls: AssetUrl[];
+    frameUrls: string[];
     originX: number;
     originY: number;
     frameDuration: number;
@@ -142,7 +141,7 @@ export interface SequenceConfig {
  */
 export interface CanvasOverlay {
     /** Sprite URL */
-    spriteUrl: AssetUrl;
+    spriteUrl: string;
     /** Center position in screen pixels */
     x: number;
     y: number;
@@ -167,7 +166,7 @@ export interface CanvasOverlay {
  * Configuration for spawning an overlay.
  */
 export interface OverlayConfig {
-    spriteUrl: AssetUrl;
+    spriteUrl: string;
     originX: number;
     originY: number;
     alpha?: number;
@@ -217,7 +216,7 @@ export interface CombatPreset {
  */
 export interface EffectAssetManifest {
     /** Base URL for all asset paths */
-    baseUrl: AssetUrl;
+    baseUrl: string;
     /** Particle sprite groups (white-on-transparent, tinted at runtime) */
     particles?: {
         slash?: string[];

package/dist/components/game/organisms/types/isometric.d.ts

@@ -1,4 +1,5 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
+import type { AnimationName } from './spriteAnimation';
 /**
  * Isometric Game Types
  *
@@ -7,6 +8,17 @@ import type { AssetUrl } from '@almadar/core';
  *
  * @packageDocumentation
  */
+/** An active visual effect on the board. x,y are grid tile coords; ttl = remaining ticks. */
+export interface ActiveEffect {
+    /** Unique key — matched against assetManifest.effects for sprite lookup */
+    key: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate */
+    y: number;
+    /** Remaining ticks — used as a fade/scale hint (alpha = min(1, ttl/4)) */
+    ttl: number;
+}
 /** A single isometric tile on the grid */
 export interface IsometricTile {
     /** Optional unique identifier (required for 3D rendering) */
@@ -22,7 +34,7 @@ export interface IsometricTile {
     /** Tile type for visual rendering (3D) */
     type?: string;
     /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
-    terrainSprite?: AssetUrl;
+    terrainSprite?: Asset;
     /** Whether units can traverse this tile (default true) */
     passable?: boolean;
     /** Movement cost for pathfinding (default 1) */
@@ -32,7 +44,7 @@ export interface IsometricTile {
     /** Elevation offset for 3D rendering */
     elevation?: number;
     /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
-    modelUrl?: AssetUrl;
+    modelUrl?: Asset;
 }
 /** A unit positioned on the isometric grid */
 export type IsometricUnit = {
@@ -50,13 +62,13 @@ export type IsometricUnit = {
     /** Grid z coordinate (3D format) */
     z?: number;
     /** Static sprite URL (used when no sprite sheet animation) */
-    sprite?: AssetUrl;
+    sprite?: Asset;
     /** Sprite-sheet atlas JSON URL (e.g. `.../guardian-sprite-sheet.json`).
      *  When set, the canvas loads the atlas and crops/animates a single frame
      *  by animation state instead of drawing the whole sheet. */
-    spriteSheet?: AssetUrl;
+    spriteSheet?: Asset;
     /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
-    modelUrl?: AssetUrl;
+    modelUrl?: Asset;
     /** Unit archetype key for sprite resolution */
     unitType?: string;
     /** Hero identifier for sprite sheet lookup */
@@ -85,6 +97,10 @@ export type IsometricUnit = {
     };
     /** Elevation offset for 3D rendering */
     elevation?: number;
+    /** Animation name — driven by the LOLO state machine; renderer defaults to 'idle' */
+    animation?: AnimationName;
+    /** Frame index within the animation — driven by the LOLO state machine; renderer defaults to 0 */
+    frame?: number;
 };
 /** A map feature (resource, building, portal, etc.) */
 export type IsometricFeature = {
@@ -99,9 +115,9 @@ export type IsometricFeature = {
     /** Feature type key (e.g., 'goldMine', 'castle', 'portal') */
     type: string;
     /** Direct sprite URL override (bypasses getFeatureSprite resolver) */
-    sprite?: AssetUrl;
+    sprite?: Asset;
     /** 3D model URL (GLB format) for GameCanvas3D */
-    assetUrl?: AssetUrl;
+    assetUrl?: Asset;
     /** Color override for 3D rendering */
     color?: string;
     /** Elevation offset for 3D rendering */

package/dist/components/game/organisms/types/spriteAnimation.d.ts

@@ -1,4 +1,3 @@
-import type { AssetUrl } from '@almadar/core';
 /**
  * Sprite Sheet Animation Types
  *
@@ -27,7 +26,7 @@ export interface AnimationDef {
 /** A resolved frame ready to draw on canvas */
 export interface ResolvedFrame {
     /** URL of the sprite sheet image */
-    sheetUrl: AssetUrl;
+    sheetUrl: string;
     /** Source X in the sheet (pixel offset) */
     sx: number;
     /** Source Y in the sheet (pixel offset) */
@@ -68,9 +67,9 @@ export interface SpriteFrameDims {
 /** Sheet URLs for both directions */
 export interface SpriteSheetUrls {
     /** Southeast-facing sheet URL */
-    se: AssetUrl;
+    se: string;
     /** Southwest-facing sheet URL */
-    sw: AssetUrl;
+    sw: string;
 }
 /**
  * Parsed sprite-sheet atlas JSON (e.g. `guardian-sprite-sheet.json`).

package/dist/components/game/organisms/utils/makeAsset.d.ts

@@ -0,0 +1,5 @@
+import type { Asset, EntityRole } from '@almadar/core';
+/** Build an Asset from a url + the slot's role. Slot-fixed defaults by role. */
+export declare function makeAsset(url: string, role: EntityRole, overrides?: Partial<Asset>): Asset;
+/** Map a name→url record to name→Asset. */
+export declare function makeAssetMap(record: Record<string, string>, role: EntityRole, overrides?: Partial<Asset>): Record<string, Asset>;

package/dist/components/game/templates/PlatformerTemplate.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { Asset } from '@almadar/core';
 import type { TemplateProps } from '../../core/templates/types';
 import type { PlatformerBoardProps } from '../organisms/PlatformerBoard';
 export interface PlatformerTemplateProps extends TemplateProps {
@@ -10,10 +11,10 @@ export interface PlatformerTemplateProps extends TemplateProps {
     /** Canvas display size */
     canvasWidth?: number;
     canvasHeight?: number;
-    /** Player sprite URL */
-    playerSprite?: string;
-    /** Map of platform type to tile sprite URL */
-    tileSprites?: Record<string, string>;
+    /** Player sprite asset */
+    playerSprite?: Asset;
+    /** Map of platform type to tile sprite asset */
+    tileSprites?: Record<string, Asset>;
     /** Canvas background color */
     bgColor?: string;
     /** Forwarded to PlatformerBoard to emit GAME_END into the FSM */

package/dist/components/game/templates/game3dAssetManifest.d.ts

@@ -9,16 +9,14 @@
  *
  * @packageDocumentation
  */
-import type { AssetUrl, EntityRow } from '@almadar/core';
+import type { Asset, EntityRow } from '@almadar/core';
 import type { IsometricTile, IsometricFeature } from '../organisms/types/isometric';
-/** GLB model URLs for a 3D board, keyed by terrain "kind" and (optionally) feature type. */
+/** GLB model assets for a 3D board, keyed by terrain "kind" and (optionally) feature type. */
 export interface Game3DAssetManifest {
-    /** Base URL prepended to manifest-relative model paths (absolute paths pass through). */
-    baseUrl?: AssetUrl;
-    /** Floor model URLs by terrain kind ('wall' | 'dirt' | 'open'). */
-    models?: Record<string, AssetUrl>;
-    /** Feature/structure model URLs by feature type ('gold_mine', 'portal', …). */
-    features?: Record<string, AssetUrl>;
+    /** Floor model assets by terrain kind ('wall' | 'dirt' | 'open'). */
+    models?: Record<string, Asset>;
+    /** Feature/structure model assets by feature type ('gold_mine', 'portal', …). */
+    features?: Record<string, Asset>;
 }
 /** Layout-only tile (no model URL): position + terrain kind. */
 export interface Tile3DLayout {