@almadar/ui 5.26.1 → 5.27.0

package/dist/components/core/organisms/StatCard.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import { LucideIcon } from "lucide-react";
+import type { IconInput } from "../atoms/Icon";
 import type { DisplayStateProps } from "./types";
 import type { EntityRow } from "@almadar/core";
 /**
@@ -13,8 +13,8 @@ export interface MetricDefinition {
     label: string;
     /** Static value for display (alternative to field-based computation) */
     value?: string | number;
-    /** Icon name for display */
-    icon?: string;
+    /** Icon name or component for display */
+    icon?: IconInput;
     /** Value format (e.g., 'currency', 'percent', 'number') */
     format?: "currency" | "percent" | "number" | string;
 }
@@ -38,7 +38,7 @@ export interface StatCardProps extends DisplayStateProps {
     /** Whether up is good (green) or bad (red) */
     invertTrend?: boolean;
     /** Icon to display (Lucide component or icon name string) */
-    icon?: LucideIcon | string;
+    icon?: IconInput;
     /** Icon background color */
     iconBg?: string;
     /** Icon color */

package/dist/components/core/organisms/Timeline.d.ts

@@ -13,7 +13,7 @@
 import React from "react";
 import type { EventKey } from "@almadar/core";
 import type { EntityRow } from "@almadar/core";
-import type { LucideIcon } from "lucide-react";
+import type { IconInput } from "../atoms/Icon";
 import type { UiError } from '../atoms/types';
 export type TimelineItemStatus = "complete" | "active" | "pending" | "error";
 /**
@@ -33,7 +33,7 @@ export interface TimelineItem {
     /** Status indicator */
     status?: TimelineItemStatus;
     /** Icon override */
-    icon?: LucideIcon;
+    icon?: IconInput;
     /** Additional metadata tags */
     tags?: readonly string[];
 }

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

@@ -1,11 +1,11 @@
 import React from "react";
-import type { LucideIcon } from "lucide-react";
-import type { EventEmit, EventKey } from "@almadar/core";
+import type { IconInput } from "../atoms/Icon";
+import type { AssetUrl, EventEmit, EventKey } from "@almadar/core";
 export interface NavItem {
     label: string;
     href: string;
     /** Lucide icon component or string icon name (resolved by @almadar/ui Icon) */
-    icon?: LucideIcon | string;
+    icon?: IconInput;
     badge?: string | number;
     children?: NavItem[];
 }
@@ -25,8 +25,8 @@ export interface NotificationItem {
  *  an icon button between the search bar and the notifications bell;
  *  click dispatches the configured event onto the bus. */
 export interface TopBarAction {
-    /** Lucide icon name (e.g. "shopping-cart", "user", "help-circle"). */
-    icon: string;
+    /** Lucide icon name or component. */
+    icon: IconInput;
     /** Optional aria-label / tooltip. Falls back to `icon`. */
     label?: string;
     /** Bus event fired on click. Dispatched as `UI:{event}` with empty payload.
@@ -42,7 +42,7 @@ export interface TopBarAction {
 export interface DashboardUser {
     name: string;
     email: string;
-    avatar?: string;
+    avatar?: AssetUrl;
 }
 export interface DashboardLayoutProps {
     /** App name shown in sidebar */

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

@@ -1,9 +1,9 @@
-import * as React from 'react';
+import { type IconInput } from '../../core/atoms/Icon';
 export interface ActionButtonProps {
     /** Button label text */
     label: string;
     /** Icon displayed before the label */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Cooldown progress from 0 (ready) to 1 (full cooldown) */
     cooldown?: number;
     /** Whether the button is disabled */

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

@@ -1,10 +1,10 @@
-import * as React from 'react';
 import type { EventKey } from "@almadar/core";
+import { type IconInput } from '../../core/atoms/Icon';
 export interface ControlButtonProps {
     /** Button label text */
     label?: string;
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg' | 'xl' | string;
     /** Shape variant */

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

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import { type IconInput } from '../../core/atoms/Icon';
 export interface ItemSlotProps {
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Item label */
     label?: string;
     /** Stack quantity */

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

@@ -1,8 +1,8 @@
-import * as React from 'react';
 import type { ColorToken } from '../../core/atoms/types';
+import { type IconInput } from '../../core/atoms/Icon';
 export interface ResourceCounterProps {
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Resource label */
     label: string;
     /** Current value */

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

@@ -1,11 +1,11 @@
-import * as React from 'react';
+import { type IconInput } from '../../core/atoms/Icon';
 export interface ScoreDisplayProps {
     /** Current score value */
     value: number;
     /** Label to display before score */
     label?: string;
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg' | 'xl';
     /** Additional CSS classes */

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

@@ -5,8 +5,9 @@
  * 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';
 export interface StateStyle {
-    icon: string;
+    icon: IconInput;
     bgClass: string;
 }
 export interface StateIndicatorProps {

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

@@ -1,6 +1,7 @@
+import { type IconInput } from '../../core/atoms/Icon';
 export interface StatusEffectProps {
-    /** Lucide kebab-case icon name */
-    icon: string;
+    /** Lucide icon name or component */
+    icon: IconInput;
     /** Label describing the effect */
     label?: string;
     /** Remaining duration in seconds */

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

@@ -1,9 +1,9 @@
-import * as React from 'react';
+import { type IconInput } from '../../core/atoms/Icon';
 export interface WaypointMarkerProps {
     /** Label text below the marker */
     label?: string;
     /** Custom icon to render inside the marker */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Whether this waypoint is currently active */
     active?: boolean;
     /** Whether this waypoint has been completed */

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

@@ -1,18 +1,12 @@
-/**
- * ActionButtons — configurable button-group molecule for game controls (distinct from ActionButton atom).
- * ActionButton is a single button with cooldown overlay and hotkey badge.
- * ActionButtons manages a *set* of ControlButtons, tracks press/release state,
- * and supports horizontal/vertical/diamond layouts for gamepad-style UI.
- */
-import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
+import type { IconInput } from '../../core/atoms';
 export interface ActionButtonConfig {
     /** Unique identifier */
     id: string;
     /** Display label */
     label?: string;
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Button variant */
     variant?: 'primary' | 'secondary' | 'ghost' | string;
 }

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

@@ -1,8 +1,8 @@
-import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
+import { type IconInput } from '../../core/atoms/Icon';
 export type CraftingIngredient = {
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Ingredient label */
     label: string;
     /** Number required for the recipe */
@@ -12,7 +12,7 @@ export type CraftingIngredient = {
 };
 export type CraftingOutput = {
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Output item label */
     label: string;
     /** Rarity tier */

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

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface EnemyPlateEffect {
     /** Effect icon */
-    icon: React.ReactNode;
+    icon: IconInput;
     /** Effect label */
     label?: string;
     /** Effect type */

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

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

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

@@ -1,4 +1,5 @@
 import { type StatBadgeProps } from "./StatBadge";
+import type { IconInput } from "../../core/atoms";
 export interface GameHudStat extends Omit<StatBadgeProps, "size"> {
     /** Data source entity name */
     source?: string;
@@ -16,8 +17,8 @@ export interface GameHudElement {
     label?: string;
     /** Direct value (from compiled render-ui effects) */
     value?: number | string;
-    /** Lucide kebab-case icon name */
-    icon?: string;
+    /** Lucide icon name or component */
+    icon?: IconInput;
     /** Display format */
     format?: string;
     /** Max value (for bars/hearts) */

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

@@ -1,5 +1,5 @@
-import * as React from "react";
 import type { EventPayload } from "@almadar/core";
+import { type IconInput } from "../../core/atoms/Icon";
 import { type EventBusContextType } from "../../../hooks/useEventBus";
 export interface GameOverStat {
     /** Stat label */
@@ -15,7 +15,7 @@ export interface GameOverStat {
     /** Display format */
     format?: "number" | "time" | "text";
     /** Icon */
-    icon?: React.ReactNode;
+    icon?: IconInput;
 }
 export type GameOverAction = EventPayload & {
     /** Display label */

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

@@ -1,6 +1,6 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface HealthEffect {
-    icon: React.ReactNode;
+    icon: IconInput;
     label?: string;
     variant?: 'buff' | 'debuff' | 'neutral';
 }

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

@@ -1,8 +1,8 @@
-import * as React from 'react';
 import type { EventEmit } from '@almadar/core';
+import type { IconInput } from '../../core/atoms';
 export interface InventoryGridItem {
     id: string;
-    icon?: React.ReactNode;
+    icon?: IconInput;
     label?: string;
     quantity?: number;
     rarity?: 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary';

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

@@ -24,7 +24,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
 import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
 import type { ResolvedFrame } from '../organisms/types/spriteAnimation';
 import type { UiError } from '../../core/atoms/types';
@@ -84,7 +84,7 @@ export interface IsometricCanvasProps {
     /** Show debug grid lines and coordinates */
     debug?: boolean;
     /** Background image URL tiled behind the isometric grid */
-    backgroundImage?: string;
+    backgroundImage?: AssetUrl;
     /** Toggle minimap overlay */
     showMinimap?: boolean;
     /** Enable camera pan/zoom controls */
@@ -107,14 +107,14 @@ export interface IsometricCanvasProps {
     /** Resolve animated sprite sheet frame for a unit */
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
     /** Additional sprite URLs to preload (e.g., effect sprites) */
-    effectSpriteUrls?: string[];
+    effectSpriteUrls?: AssetUrl[];
     /** Callback to draw canvas effects after units (canvas-specific: cannot be declarative) */
     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?: string;
+    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. */

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

@@ -1,4 +1,4 @@
-import type { EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
 export interface PlatformerPlatform {
     x: number;
     y: number;
@@ -32,13 +32,13 @@ export interface PlatformerCanvasProps {
     /** Background color */
     bgColor?: string;
     /** Player sprite image URL */
-    playerSprite?: string;
+    playerSprite?: AssetUrl;
     /** Map of platform type to tile sprite URL */
-    tileSprites?: Record<string, string>;
+    tileSprites?: Record<string, AssetUrl>;
     /** Background image URL */
-    backgroundImage?: string;
+    backgroundImage?: AssetUrl;
     /** Base URL prefix for asset URLs */
-    assetBaseUrl?: string;
+    assetBaseUrl?: AssetUrl;
     /** Event names for keyboard controls */
     leftEvent?: EventEmit<{
         direction: number;

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

@@ -1,9 +1,9 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface ActivePowerup {
     /** Unique powerup ID */
     id: string;
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Powerup label */
     label: string;
     /** Remaining time in seconds */

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

@@ -1,7 +1,7 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface ResourceBarResource {
     /** Icon for the resource */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Resource name */
     label: string;
     /** Current amount */

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

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import { type IconInput } from '../../core/atoms/Icon';
 /**
  * StatBadge — game stat display molecule (distinct from core Badge atom).
  * Badge shows a text label/status token. StatBadge shows a numeric value
@@ -19,7 +19,7 @@ export interface StatBadgeProps {
     /** Display format */
     format?: 'number' | 'hearts' | 'bar' | 'text' | string;
     /** Icon component or emoji */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg' | string;
     /** Visual variant */

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

@@ -1,9 +1,9 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface TurnPanelAction {
     /** Action button label */
     label: string;
     /** Icon for the button */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Event name to emit when clicked */
     event?: string;
     /** Whether the action is disabled */

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

@@ -1,9 +1,9 @@
-import * as React from 'react';
+import type { IconInput } from '../../core/atoms';
 export interface UnitCommand {
     /** Command label */
     label: string;
     /** Icon for the command button */
-    icon?: React.ReactNode;
+    icon?: IconInput;
     /** Event name to emit when clicked */
     event?: string;
     /** Whether the command is disabled */

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

@@ -18,7 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 import type { ResolvedFrame } from './types/spriteAnimation';
 /** Battle phases an encounter walks through (UI value enum — not entity data). */
@@ -75,7 +75,7 @@ export interface BattleBoardProps extends DisplayStateProps {
     calculateDamage?: (attacker: EntityRow, target: EntityRow) => number;
     onDrawEffects?: (ctx: CanvasRenderingContext2D, timestamp: number) => void;
     hasActiveEffects?: boolean;
-    effectSpriteUrls?: string[];
+    effectSpriteUrls?: AssetUrl[];
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
     /** Emits UI:{tileClickEvent} with { x, y } on tile click */
     tileClickEvent?: EventEmit<{

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

@@ -24,7 +24,7 @@
  * @packageDocumentation
  */
 import * as React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
 import type { CombatActionType, EffectAssetManifest } from './types/effects';
 import type { UiError } from '../../core/atoms/types';
 export type { CombatActionType } from './types/effects';
@@ -52,9 +52,9 @@ export interface CanvasEffectProps {
     error?: UiError | null;
     /** Sprite URL for the effect (emoji fallback mode).
      *  When set without assetManifest, renders this image instead of emoji. */
-    effectSpriteUrl?: string;
+    effectSpriteUrl?: AssetUrl;
     /** Base URL for remote assets. Prepended to relative effectSpriteUrl paths. */
-    assetBaseUrl?: string;
+    assetBaseUrl?: AssetUrl;
     /** Full effect asset manifest for the sprite particle engine.
      *  When provided, enables the canvas-based particle system. */
     assetManifest?: EffectAssetManifest;

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

@@ -18,7 +18,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
 import type { UiError } from '../../core/atoms/types';
 /** Data shape for a slot's equipped item */
@@ -30,7 +30,7 @@ export type SlotItemData = {
     /** Emoji or text icon */
     iconEmoji?: string;
     /** Image URL icon (takes precedence over iconEmoji) */
-    iconUrl?: string;
+    iconUrl?: AssetUrl;
     /** Optional state machine for tooltip display */
     stateMachine?: TraitStateMachineDefinition;
 };
@@ -59,7 +59,7 @@ export interface TraitSlotProps {
         border: string;
     }>;
     /** Optional tooltip frame image URL */
-    tooltipFrameUrl?: string;
+    tooltipFrameUrl?: AssetUrl;
     /** Additional CSS classes */
     className?: string;
     /** Loading state */

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

@@ -19,7 +19,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { ResolvedFrame } from './types/spriteAnimation';
 import type { UiError } from '../../core/atoms/types';
 /** Context exposed to render-prop slots. Hex / hero rows are `EntityRow`. */
@@ -125,7 +125,7 @@ export interface WorldMapBoardProps {
     diamondTopY?: number;
     /** Disable pan/zoom camera (default: true). Set false for fixed maps where overlay labels need stable positions. */
     enableCamera?: boolean;
-    effectSpriteUrls?: string[];
+    effectSpriteUrls?: AssetUrl[];
     resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
 }
 export declare function WorldMapBoard({ entity, isLoading, scale, unitScale, allowMoveAllHeroes, isInRange, heroSelectEvent, heroMoveEvent, battleEncounterEvent, featureEnterEvent, tileClickEvent, header, sidePanel, overlay, footer, onHeroSelect, onHeroMove, onBattleEncounter, onFeatureEnter, diamondTopY, enableCamera, effectSpriteUrls, resolveUnitFrame, className, }: WorldMapBoardProps): React.JSX.Element;

package/dist/components/game/organisms/puzzles/builder/BuilderBoard.d.ts

@@ -9,7 +9,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../../../core/organisms/types';
 /** A draggable build component (UI value DTO read off the entity). */
 export interface BuilderComponent {
@@ -18,7 +18,7 @@ export interface BuilderComponent {
     description?: string;
     iconEmoji?: string;
     /** Image URL icon (takes precedence over iconEmoji) */
-    iconUrl?: string;
+    iconUrl?: AssetUrl;
     category?: string;
 }
 /** A blueprint slot accepting a component (UI value DTO read off the entity). */

package/dist/components/game/organisms/puzzles/classifier/ClassifierBoard.d.ts

@@ -10,7 +10,7 @@
  * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../../../core/organisms/types';
 /** A sortable item (UI value DTO read off the entity). */
 export interface ClassifierItem {
@@ -19,7 +19,7 @@ export interface ClassifierItem {
     description?: string;
     correctCategory: string;
     /** Image URL icon for story-specific visual skin */
-    iconUrl?: string;
+    iconUrl?: AssetUrl;
 }
 /** A category bucket (UI value DTO read off the entity). */
 export interface ClassifierCategory {
@@ -27,7 +27,7 @@ export interface ClassifierCategory {
     label: string;
     color?: string;
     /** Image URL for story-specific category header */
-    imageUrl?: string;
+    imageUrl?: AssetUrl;
 }
 export interface ClassifierBoardProps extends DisplayStateProps {
     /** Puzzle board-state entity (single row or array). The board reads

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

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