@almadar/ui 5.72.0 → 5.73.0

package/dist/components/game/molecules/three/index.js

@@ -1755,7 +1755,7 @@ function TileRenderer({
             children: /* @__PURE__ */ jsx(
               ModelLoader,
               {
-                url: tile.modelUrl,
+                url: tile.modelUrl?.url,
                 position,
                 scale: cellSize * 0.9,
                 fallbackGeometry: "box",
@@ -2157,7 +2157,7 @@ function FeatureModel({
   onHover
 }) {
   const groupRef = useRef(null);
-  const { model: loadedModel, isLoading } = useGLTFModel2(feature.assetUrl);
+  const { model: loadedModel, isLoading } = useGLTFModel2(feature.assetUrl?.url);
   const model = useMemo(() => {
     if (!loadedModel) return null;
     const cloned = loadedModel.clone();
@@ -2292,12 +2292,7 @@ function frameRect(frame, row, columns, frameWidth, frameHeight) {
 
 // components/game/molecules/useUnitSpriteAtlas.ts
 function unitAtlasUrl(unit) {
-  if (unit.spriteSheet) return unit.spriteSheet;
-  const sprite = unit.sprite;
-  if (!sprite) return null;
-  const match = /^(.*-sprite-sheet)(?:-(?:se|sw))?(?:-v\d+)?\.png$/.exec(sprite);
-  if (!match) return null;
-  return `${match[1]}.json`;
+  return unit.spriteSheet?.url ?? null;
 }
 function resolveSheetUrl(atlasUrl, relativeSheetPath) {
   try {
@@ -2708,7 +2703,7 @@ var GameCanvas3D = forwardRef(
               children: /* @__PURE__ */ jsx(
                 ModelLoader,
                 {
-                  url: tile.modelUrl,
+                  url: tile.modelUrl.url,
                   scale: 0.95,
                   fallbackGeometry: "box",
                   castShadow: true,
@@ -2773,7 +2768,7 @@ var GameCanvas3D = forwardRef(
                 /* @__PURE__ */ jsx(
                   ModelLoader,
                   {
-                    url: unit.modelUrl,
+                    url: unit.modelUrl.url,
                     scale: modelScale,
                     fallbackGeometry: "box",
                     castShadow: true
@@ -2833,7 +2828,7 @@ var GameCanvas3D = forwardRef(
           return /* @__PURE__ */ jsx(
             ModelLoader,
             {
-              url: feature.assetUrl,
+              url: feature.assetUrl.url,
               position,
               scale: 0.5,
               rotation: [0, feature.rotation ?? 0, 0],
@@ -4201,7 +4196,18 @@ function GameBoard3D({
   const row = boardEntity(entity);
   const eventBus = useEventBus();
   const entityUnits = row ? rows(row.units) : [];
-  const units = entityUnits;
+  const units = entityUnits.map((r) => ({
+    id: str(r.id),
+    x: num(r.x),
+    y: num(r.y),
+    z: num(r.z),
+    faction: str(r.faction) || "neutral",
+    team: str(r.team) || str(r.faction) || "neutral",
+    unitType: r.unitType == null ? void 0 : str(r.unitType),
+    name: r.name == null ? void 0 : str(r.name),
+    health: r.health == null ? void 0 : num(r.health),
+    maxHealth: r.maxHealth == null ? void 0 : num(r.maxHealth)
+  }));
   const selectedUnitId = row ? str(row.selectedUnitId) || null : null;
   const phase = row ? str(row.phase) : "observation";
   const result = row ? str(row.result) : "none";
@@ -4593,16 +4599,31 @@ var Box = React11.forwardRef(
 );
 Box.displayName = "Box";
 
-// components/game/templates/game3dAssetManifest.ts
-function resolveManifestUrl(manifest, relative) {
-  if (relative == null) return void 0;
-  if (/^https?:\/\//.test(relative)) return relative;
-  const base = manifest?.baseUrl;
-  if (base == null) return relative;
-  const cleanBase = base.replace(/\/$/, "");
-  const cleanRel = relative.replace(/^\//, "");
-  return `${cleanBase}/${cleanRel}`;
+// components/game/organisms/utils/makeAsset.ts
+var ROLE_DEFAULTS = {
+  tile: { dimension: "2d", animations: ["static"], aspect: "1:1" },
+  decoration: { dimension: "2d", animations: ["static"], aspect: "1:1" },
+  effect: { dimension: "2d", animations: ["static"], aspect: "1:1" },
+  item: { dimension: "2d", animations: ["static"], aspect: "5:7" },
+  player: { dimension: "2d", animations: ["idle", "walk", "attack", "hit", "death"], aspect: "1:1" },
+  enemy: { dimension: "2d", animations: ["idle", "walk", "attack", "hit", "death"], aspect: "1:1" },
+  npc: { dimension: "2d", animations: ["idle", "walk", "attack", "hit", "death"], aspect: "1:1" },
+  projectile: { dimension: "2d", animations: ["static"], aspect: "1:1" },
+  vehicle: { dimension: "2d", animations: ["idle", "walk"], aspect: "1:1" },
+  ui: { dimension: "2d", animations: ["static"], aspect: "1:1" }
+};
+function makeAsset(url, role, overrides = {}) {
+  const defaults = ROLE_DEFAULTS[role] ?? { dimension: "2d", animations: ["static"], aspect: "1:1" };
+  return {
+    url,
+    role,
+    category: url.split("/").pop()?.replace(/\.[^.]+$/, "") ?? role,
+    ...defaults,
+    ...overrides
+  };
 }
+
+// components/game/templates/game3dAssetManifest.ts
 function tileKind(type, passable) {
   if (passable === false) return "wall";
   if (type === "dirt" || type === "road") return "dirt";
@@ -4618,7 +4639,7 @@ function resolveTilesWithModels(layout, manifest) {
       z: t.z,
       type: t.type,
       passable: t.passable,
-      modelUrl: resolveManifestUrl(manifest, manifest?.models?.[kind])
+      modelUrl: manifest?.models?.[kind]
     };
   });
 }
@@ -4627,7 +4648,7 @@ function resolvePropTiles(tiles, manifest) {
     const kind = tileKind(t.type ?? "", t.passable);
     return {
       ...t,
-      modelUrl: t.modelUrl ?? resolveManifestUrl(manifest, manifest?.models?.[kind])
+      modelUrl: t.modelUrl ?? manifest?.models?.[kind]
     };
   });
 }
@@ -4638,7 +4659,8 @@ function resolveEntityTiles(entity, manifest) {
     const type = str(r.type) || str(r.terrain);
     const passable = r.passable !== false;
     const kind = tileKind(type, passable);
-    const explicitModel = r.modelUrl == null ? void 0 : str(r.modelUrl);
+    const explicitModelUrl = r.modelUrl == null ? void 0 : str(r.modelUrl);
+    const explicitModel = explicitModelUrl ? makeAsset(explicitModelUrl, "decoration", { dimension: "3d" }) : void 0;
     return {
       id: r.id == null ? void 0 : str(r.id),
       x: num(r.x),
@@ -4646,14 +4668,14 @@ function resolveEntityTiles(entity, manifest) {
       z: r.z == null ? void 0 : num(r.z),
       type,
       passable,
-      modelUrl: explicitModel ?? resolveManifestUrl(manifest, manifest?.models?.[kind])
+      modelUrl: explicitModel ?? manifest?.models?.[kind]
     };
   });
 }
 function resolveFeaturesWithModels(features, manifest) {
   return features.map((f) => ({
     ...f,
-    assetUrl: f.assetUrl ?? resolveManifestUrl(manifest, manifest?.features?.[f.type])
+    assetUrl: f.assetUrl ?? manifest?.features?.[f.type]
   }));
 }
 function resolveEntityFeatures(entity, manifest) {
@@ -4661,7 +4683,8 @@ function resolveEntityFeatures(entity, manifest) {
   if (!row) return [];
   return rows(row.features).map((r) => {
     const type = str(r.type);
-    const explicit = r.assetUrl == null ? void 0 : str(r.assetUrl);
+    const explicitUrl = r.assetUrl == null ? void 0 : str(r.assetUrl);
+    const explicit = explicitUrl ? makeAsset(explicitUrl, "decoration", { dimension: "3d" }) : void 0;
     return {
       id: r.id == null ? void 0 : str(r.id),
       x: num(r.x),
@@ -4669,7 +4692,7 @@ function resolveEntityFeatures(entity, manifest) {
       z: r.z == null ? void 0 : num(r.z),
       type,
       color: r.color == null ? void 0 : str(r.color),
-      assetUrl: explicit ?? resolveManifestUrl(manifest, manifest?.features?.[type])
+      assetUrl: explicit ?? manifest?.features?.[type]
     };
   });
 }

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

@@ -1,19 +1,12 @@
-import type { AssetUrl } from '@almadar/core';
 import type { IsometricUnit } from '../organisms/types/isometric';
 import type { ResolvedFrame } from '../organisms/types/spriteAnimation';
 /**
  * Resolve the sprite-sheet atlas-JSON URL for a unit.
  *
- * An explicit `unit.spriteSheet` wins. Otherwise, when the unit's static
- * `sprite` points at a directional sheet PNG, derive its sibling atlas JSON by
- * the deterministic naming convention used in `shared/sprite-sheets/`:
- * the shared atlas drops the `-se` / `-sw` direction suffix and any `-vN`
- * variant suffix, then swaps `.png` → `.json`
- * (`amir-sprite-sheet-se.png` → `amir-sprite-sheet.json`).
- *
- * Returns null when no atlas can be resolved (the unit keeps its static draw).
+ * A unit has an atlas iff `unit.spriteSheet.url` is set (explicit metadata wins).
+ * No filename-pattern matching — a unit without a `spriteSheet` Asset keeps its static draw.
  */
-export declare function unitAtlasUrl(unit: Pick<IsometricUnit, 'spriteSheet' | 'sprite'>): AssetUrl | null;
+export declare function unitAtlasUrl(unit: Pick<IsometricUnit, 'spriteSheet'>): string | null;
 export interface UseUnitSpriteAtlasResult {
     /** Atlas-JSON URLs successfully loaded — feed these to no one; sheet PNGs are returned below. */
     sheetUrls: string[];

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,4 @@
-import type { AssetUrl } from '@almadar/core';
+import type { Asset } from '@almadar/core';
 import type { AnimationName } from './spriteAnimation';
 /**
  * Isometric Game Types
@@ -34,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) */
@@ -44,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 = {
@@ -62,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 */
@@ -115,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 {