@almadar/ui 5.26.2 → 5.28.0

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[];

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

@@ -1,3 +1,4 @@
+import type { AssetUrl } from '@almadar/core';
 /**
  * Isometric Game Types
  *
@@ -21,7 +22,7 @@ export interface IsometricTile {
     /** Tile type for visual rendering (3D) */
     type?: string;
     /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
-    terrainSprite?: string;
+    terrainSprite?: AssetUrl;
     /** Whether units can traverse this tile (default true) */
     passable?: boolean;
     /** Movement cost for pathfinding (default 1) */
@@ -47,7 +48,7 @@ export type IsometricUnit = {
     /** Grid z coordinate (3D format) */
     z?: number;
     /** Static sprite URL (used when no sprite sheet animation) */
-    sprite?: string;
+    sprite?: AssetUrl;
     /** Unit archetype key for sprite resolution */
     unitType?: string;
     /** Hero identifier for sprite sheet lookup */
@@ -90,9 +91,9 @@ export type IsometricFeature = {
     /** Feature type key (e.g., 'goldMine', 'castle', 'portal') */
     type: string;
     /** Direct sprite URL override (bypasses getFeatureSprite resolver) */
-    sprite?: string;
+    sprite?: AssetUrl;
     /** 3D model URL (GLB format) for GameCanvas3D */
-    assetUrl?: string;
+    assetUrl?: AssetUrl;
     /** Color override for 3D rendering */
     color?: string;
     /** Elevation offset for 3D rendering */

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

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

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

@@ -1,3 +1,4 @@
+import type { AssetUrl } from '@almadar/core';
 import type { CombatActionType, EffectAssetManifest } from './types/effects';
 export interface UseCanvasEffectsOptions {
     /** Effect asset manifest (baseUrl + particles + animations) */
@@ -5,7 +6,7 @@ export interface UseCanvasEffectsOptions {
 }
 export interface UseCanvasEffectsResult {
     /** All effect sprite URLs for preloading via useImageCache */
-    effectSpriteUrls: string[];
+    effectSpriteUrls: AssetUrl[];
     /** Spawn a combat effect at the given screen position */
     spawnEffect: (type: CombatActionType, screenX: number, screenY: number) => void;
     /** Draw all active effects — call inside draw() after units, before ctx.restore() */