@almadar/ui 5.28.2 → 5.28.3

package/dist/avl/index.cjs

@@ -11456,7 +11456,7 @@ var init_DamageNumber = __esm({
 function DialogueBubble({
   speaker,
   text,
-  portrait = "https://almadar-kflow-assets.web.app/shared/characters/archetypes/00_base_model.png",
+  portrait = "https://almadar-kflow-assets.web.app/shared/characters/archetypes/04_hero.png",
   position = "bottom",
   className
 }) {
@@ -14066,7 +14066,7 @@ function IsometricCanvas({
   // Rendering options
   scale = 0.4,
   debug: debug2 = false,
-  backgroundImage,
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/court.png",
   showMinimap = true,
   enableCamera = true,
   unitScale = 1,
@@ -14081,7 +14081,7 @@ function IsometricCanvas({
   // Tuning
   diamondTopY: diamondTopYProp,
   // Remote asset loading
-  assetBaseUrl,
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   assetManifest
 }) {
   const tilesProp = Array.isArray(_tilesPropRaw) ? _tilesPropRaw : [];
@@ -14840,6 +14840,10 @@ var init_boardEntity = __esm({
 });
 function BattleBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   scale = 0.45,
   unitScale = 1,
   header,
@@ -14865,11 +14869,11 @@ function BattleBoard({
   className
 }) {
   const board = boardEntity(entity) ?? {};
-  const tiles = Array.isArray(board.tiles) ? board.tiles : [];
-  const features = Array.isArray(board.features) ? board.features : [];
+  const tiles = propTiles ?? (Array.isArray(board.tiles) ? board.tiles : []);
+  const features = propFeatures ?? (Array.isArray(board.features) ? board.features : []);
   const boardWidth = num(board.boardWidth, 8);
   const boardHeight = num(board.boardHeight, 6);
-  const assetManifest = board.assetManifest;
+  const assetManifest = propAssetManifest ?? board.assetManifest;
   const backgroundImage = board.backgroundImage;
   const units = rows(board.units);
   const selectedUnitId = board.selectedUnitId ?? null;
@@ -14961,7 +14965,7 @@ function BattleBoard({
     }, 16);
     return () => clearInterval(interval);
   }, []);
-  const isoUnits = React88.useMemo(() => {
+  const derivedIsoUnits = React88.useMemo(() => {
     return units.filter((u) => unitHealth(u) > 0).map((unit) => {
       const id = str(unit.id);
       const pos = movingPositions.get(id) ?? unitPosition(unit);
@@ -14985,6 +14989,7 @@ function BattleBoard({
       };
     });
   }, [units, movingPositions]);
+  const isoUnits = propUnits ?? derivedIsoUnits;
   const maxY = Math.max(...tiles.map((t2) => t2.y), 0);
   const baseOffsetX = (maxY + 1) * (TILE_WIDTH * scale / 2);
   const tileToScreen = React88.useCallback(
@@ -21359,16 +21364,21 @@ function EmojiEffect({
     }
   );
 }
-function CanvasEffect(props) {
+function CanvasEffect({
+  effectSpriteUrl = "https://almadar-kflow-assets.web.app/shared/effects/gas/gas00.png",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/effects/",
+  ...props
+}) {
   const eventBus = useEventBus();
-  const { completeEvent, onComplete, ...rest } = props;
+  const mergedProps = { effectSpriteUrl, assetBaseUrl, ...props };
+  const { completeEvent, onComplete, ...rest } = mergedProps;
   const handleComplete = React88.useCallback(() => {
     if (completeEvent) eventBus.emit(`UI:${completeEvent}`, {});
     onComplete?.();
   }, [completeEvent, eventBus, onComplete]);
   const enhancedProps = { ...rest, onComplete: handleComplete };
-  if (props.assetManifest) {
-    return /* @__PURE__ */ jsxRuntime.jsx(CanvasEffectEngine, { ...enhancedProps, assetManifest: props.assetManifest });
+  if (rest.assetManifest) {
+    return /* @__PURE__ */ jsxRuntime.jsx(CanvasEffectEngine, { ...enhancedProps, assetManifest: rest.assetManifest });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(EmojiEffect, { ...enhancedProps });
 }
@@ -22153,6 +22163,10 @@ var init_CaseStudyOrganism = __esm({
 });
 function CastleBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   scale = 0.45,
   header,
   sidePanel,
@@ -22168,10 +22182,10 @@ function CastleBoard({
 }) {
   const eventBus = useEventBus();
   const resolved = boardEntity(entity);
-  const tiles = Array.isArray(resolved?.tiles) ? resolved.tiles : [];
-  const features = Array.isArray(resolved?.features) ? resolved.features : [];
-  const units = Array.isArray(resolved?.units) ? resolved.units : [];
-  const assetManifest = resolved?.assetManifest;
+  const tiles = propTiles ?? (Array.isArray(resolved?.tiles) ? resolved.tiles : []);
+  const features = propFeatures ?? (Array.isArray(resolved?.features) ? resolved.features : []);
+  const units = propUnits ?? (Array.isArray(resolved?.units) ? resolved.units : []);
+  const assetManifest = propAssetManifest ?? resolved?.assetManifest;
   const backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = React88.useState(null);
   const [selectedFeature, setSelectedFeature] = React88.useState(null);
@@ -22274,14 +22288,22 @@ var init_CastleBoard = __esm({
 function CastleTemplate({
   entity,
   scale = 0.45,
+  tiles,
+  units,
+  features,
+  assetManifest,
   className
 }) {
   const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
-  if (!resolved) return null;
+  if (!resolved && !tiles && !units && !features && !assetManifest) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(
     CastleBoard,
     {
       entity: resolved,
+      tiles,
+      units,
+      features,
+      assetManifest,
       scale,
       featureClickEvent: "FEATURE_CLICK",
       unitClickEvent: "UNIT_CLICK",
@@ -28914,8 +28936,8 @@ function GameCanvas2D({
   tickEvent,
   drawEvent,
   fps = 60,
-  backgroundImage,
-  assetBaseUrl = "",
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/resonators.jpeg",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   className
 }) {
   const canvasRef = React88__namespace.useRef(null);
@@ -28979,6 +29001,9 @@ function GameCanvas2D({
           const bgImg = loadImage(backgroundImageRef.current);
           if (bgImg) {
             ctx.drawImage(bgImg, 0, 0, widthRef.current, heightRef.current);
+          } else {
+            ctx.fillStyle = "#0f1420";
+            ctx.fillRect(0, 0, widthRef.current, heightRef.current);
           }
         }
         onDrawRef.current?.(ctx, frame);
@@ -30123,10 +30148,10 @@ function PlatformerCanvas({
   canvasHeight = 400,
   followCamera = true,
   bgColor,
-  playerSprite,
+  playerSprite = "https://almadar-kflow-assets.web.app/shared/platformer/characters/platformChar_idle.png",
   tileSprites,
-  backgroundImage,
-  assetBaseUrl = "",
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/court.png",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/platformer/",
   leftEvent = "MOVE_LEFT",
   rightEvent = "MOVE_RIGHT",
   jumpEvent = "JUMP",
@@ -48005,6 +48030,10 @@ function defaultIsInRange(from, to, range) {
 }
 function WorldMapBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   isLoading,
   scale = 0.4,
   unitScale = 2.5,
@@ -48033,16 +48062,16 @@ function WorldMapBoard({
   const resolved = boardEntity(entity);
   const hexes = rows(resolved?.hexes);
   const heroes = rows(resolved?.heroes);
-  const features = Array.isArray(resolved?.features) ? resolved.features : [];
+  const features = propFeatures ?? (Array.isArray(resolved?.features) ? resolved.features : []);
   const selectedHeroId = resolved?.selectedHeroId ?? null;
-  const assetManifest = resolved?.assetManifest;
+  const assetManifest = propAssetManifest ?? resolved?.assetManifest;
   const backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = React88.useState(null);
   const selectedHero = React88.useMemo(
     () => heroes.find((h) => str(h.id) === selectedHeroId) ?? null,
     [heroes, selectedHeroId]
   );
-  const tiles = React88.useMemo(
+  const derivedTiles = React88.useMemo(
     () => hexes.map((hex) => ({
       x: num(hex.x),
       y: num(hex.y),
@@ -48051,8 +48080,9 @@ function WorldMapBoard({
     })),
     [hexes]
   );
+  const tiles = propTiles ?? derivedTiles;
   const baseUnits = React88.useMemo(
-    () => heroes.map((hero) => ({
+    () => propUnits ?? heroes.map((hero) => ({
       id: str(hero.id),
       position: heroPosition(hero),
       name: str(hero.name),
@@ -48061,7 +48091,7 @@ function WorldMapBoard({
       maxHealth: 100,
       sprite: hero.sprite == null ? void 0 : str(hero.sprite)
     })),
-    [heroes]
+    [heroes, propUnits]
   );
   const MOVE_SPEED_MS_PER_TILE = 300;
   const movementAnimRef = React88.useRef(null);
@@ -48271,12 +48301,20 @@ function WorldMapTemplate({
   unitScale = 2.5,
   diamondTopY,
   allowMoveAllHeroes = false,
+  tiles,
+  units,
+  features,
+  assetManifest,
   className
 }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     WorldMapBoard,
     {
       entity,
+      tiles,
+      units,
+      features,
+      assetManifest,
       scale,
       unitScale,
       diamondTopY,

package/dist/avl/index.js

@@ -11407,7 +11407,7 @@ var init_DamageNumber = __esm({
 function DialogueBubble({
   speaker,
   text,
-  portrait = "https://almadar-kflow-assets.web.app/shared/characters/archetypes/00_base_model.png",
+  portrait = "https://almadar-kflow-assets.web.app/shared/characters/archetypes/04_hero.png",
   position = "bottom",
   className
 }) {
@@ -14017,7 +14017,7 @@ function IsometricCanvas({
   // Rendering options
   scale = 0.4,
   debug: debug2 = false,
-  backgroundImage,
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/court.png",
   showMinimap = true,
   enableCamera = true,
   unitScale = 1,
@@ -14032,7 +14032,7 @@ function IsometricCanvas({
   // Tuning
   diamondTopY: diamondTopYProp,
   // Remote asset loading
-  assetBaseUrl,
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   assetManifest
 }) {
   const tilesProp = Array.isArray(_tilesPropRaw) ? _tilesPropRaw : [];
@@ -14791,6 +14791,10 @@ var init_boardEntity = __esm({
 });
 function BattleBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   scale = 0.45,
   unitScale = 1,
   header,
@@ -14816,11 +14820,11 @@ function BattleBoard({
   className
 }) {
   const board = boardEntity(entity) ?? {};
-  const tiles = Array.isArray(board.tiles) ? board.tiles : [];
-  const features = Array.isArray(board.features) ? board.features : [];
+  const tiles = propTiles ?? (Array.isArray(board.tiles) ? board.tiles : []);
+  const features = propFeatures ?? (Array.isArray(board.features) ? board.features : []);
   const boardWidth = num(board.boardWidth, 8);
   const boardHeight = num(board.boardHeight, 6);
-  const assetManifest = board.assetManifest;
+  const assetManifest = propAssetManifest ?? board.assetManifest;
   const backgroundImage = board.backgroundImage;
   const units = rows(board.units);
   const selectedUnitId = board.selectedUnitId ?? null;
@@ -14912,7 +14916,7 @@ function BattleBoard({
     }, 16);
     return () => clearInterval(interval);
   }, []);
-  const isoUnits = useMemo(() => {
+  const derivedIsoUnits = useMemo(() => {
     return units.filter((u) => unitHealth(u) > 0).map((unit) => {
       const id = str(unit.id);
       const pos = movingPositions.get(id) ?? unitPosition(unit);
@@ -14936,6 +14940,7 @@ function BattleBoard({
       };
     });
   }, [units, movingPositions]);
+  const isoUnits = propUnits ?? derivedIsoUnits;
   const maxY = Math.max(...tiles.map((t2) => t2.y), 0);
   const baseOffsetX = (maxY + 1) * (TILE_WIDTH * scale / 2);
   const tileToScreen = useCallback(
@@ -21310,16 +21315,21 @@ function EmojiEffect({
     }
   );
 }
-function CanvasEffect(props) {
+function CanvasEffect({
+  effectSpriteUrl = "https://almadar-kflow-assets.web.app/shared/effects/gas/gas00.png",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/effects/",
+  ...props
+}) {
   const eventBus = useEventBus();
-  const { completeEvent, onComplete, ...rest } = props;
+  const mergedProps = { effectSpriteUrl, assetBaseUrl, ...props };
+  const { completeEvent, onComplete, ...rest } = mergedProps;
   const handleComplete = useCallback(() => {
     if (completeEvent) eventBus.emit(`UI:${completeEvent}`, {});
     onComplete?.();
   }, [completeEvent, eventBus, onComplete]);
   const enhancedProps = { ...rest, onComplete: handleComplete };
-  if (props.assetManifest) {
-    return /* @__PURE__ */ jsx(CanvasEffectEngine, { ...enhancedProps, assetManifest: props.assetManifest });
+  if (rest.assetManifest) {
+    return /* @__PURE__ */ jsx(CanvasEffectEngine, { ...enhancedProps, assetManifest: rest.assetManifest });
   }
   return /* @__PURE__ */ jsx(EmojiEffect, { ...enhancedProps });
 }
@@ -22104,6 +22114,10 @@ var init_CaseStudyOrganism = __esm({
 });
 function CastleBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   scale = 0.45,
   header,
   sidePanel,
@@ -22119,10 +22133,10 @@ function CastleBoard({
 }) {
   const eventBus = useEventBus();
   const resolved = boardEntity(entity);
-  const tiles = Array.isArray(resolved?.tiles) ? resolved.tiles : [];
-  const features = Array.isArray(resolved?.features) ? resolved.features : [];
-  const units = Array.isArray(resolved?.units) ? resolved.units : [];
-  const assetManifest = resolved?.assetManifest;
+  const tiles = propTiles ?? (Array.isArray(resolved?.tiles) ? resolved.tiles : []);
+  const features = propFeatures ?? (Array.isArray(resolved?.features) ? resolved.features : []);
+  const units = propUnits ?? (Array.isArray(resolved?.units) ? resolved.units : []);
+  const assetManifest = propAssetManifest ?? resolved?.assetManifest;
   const backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = useState(null);
   const [selectedFeature, setSelectedFeature] = useState(null);
@@ -22225,14 +22239,22 @@ var init_CastleBoard = __esm({
 function CastleTemplate({
   entity,
   scale = 0.45,
+  tiles,
+  units,
+  features,
+  assetManifest,
   className
 }) {
   const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
-  if (!resolved) return null;
+  if (!resolved && !tiles && !units && !features && !assetManifest) return null;
   return /* @__PURE__ */ jsx(
     CastleBoard,
     {
       entity: resolved,
+      tiles,
+      units,
+      features,
+      assetManifest,
       scale,
       featureClickEvent: "FEATURE_CLICK",
       unitClickEvent: "UNIT_CLICK",
@@ -28865,8 +28887,8 @@ function GameCanvas2D({
   tickEvent,
   drawEvent,
   fps = 60,
-  backgroundImage,
-  assetBaseUrl = "",
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/resonators.jpeg",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   className
 }) {
   const canvasRef = React88.useRef(null);
@@ -28930,6 +28952,9 @@ function GameCanvas2D({
           const bgImg = loadImage(backgroundImageRef.current);
           if (bgImg) {
             ctx.drawImage(bgImg, 0, 0, widthRef.current, heightRef.current);
+          } else {
+            ctx.fillStyle = "#0f1420";
+            ctx.fillRect(0, 0, widthRef.current, heightRef.current);
           }
         }
         onDrawRef.current?.(ctx, frame);
@@ -30074,10 +30099,10 @@ function PlatformerCanvas({
   canvasHeight = 400,
   followCamera = true,
   bgColor,
-  playerSprite,
+  playerSprite = "https://almadar-kflow-assets.web.app/shared/platformer/characters/platformChar_idle.png",
   tileSprites,
-  backgroundImage,
-  assetBaseUrl = "",
+  backgroundImage = "https://almadar-kflow-assets.web.app/shared/scenes/court.png",
+  assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/platformer/",
   leftEvent = "MOVE_LEFT",
   rightEvent = "MOVE_RIGHT",
   jumpEvent = "JUMP",
@@ -47956,6 +47981,10 @@ function defaultIsInRange(from, to, range) {
 }
 function WorldMapBoard({
   entity,
+  tiles: propTiles,
+  units: propUnits,
+  features: propFeatures,
+  assetManifest: propAssetManifest,
   isLoading,
   scale = 0.4,
   unitScale = 2.5,
@@ -47984,16 +48013,16 @@ function WorldMapBoard({
   const resolved = boardEntity(entity);
   const hexes = rows(resolved?.hexes);
   const heroes = rows(resolved?.heroes);
-  const features = Array.isArray(resolved?.features) ? resolved.features : [];
+  const features = propFeatures ?? (Array.isArray(resolved?.features) ? resolved.features : []);
   const selectedHeroId = resolved?.selectedHeroId ?? null;
-  const assetManifest = resolved?.assetManifest;
+  const assetManifest = propAssetManifest ?? resolved?.assetManifest;
   const backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = useState(null);
   const selectedHero = useMemo(
     () => heroes.find((h) => str(h.id) === selectedHeroId) ?? null,
     [heroes, selectedHeroId]
   );
-  const tiles = useMemo(
+  const derivedTiles = useMemo(
     () => hexes.map((hex) => ({
       x: num(hex.x),
       y: num(hex.y),
@@ -48002,8 +48031,9 @@ function WorldMapBoard({
     })),
     [hexes]
   );
+  const tiles = propTiles ?? derivedTiles;
   const baseUnits = useMemo(
-    () => heroes.map((hero) => ({
+    () => propUnits ?? heroes.map((hero) => ({
       id: str(hero.id),
       position: heroPosition(hero),
       name: str(hero.name),
@@ -48012,7 +48042,7 @@ function WorldMapBoard({
       maxHealth: 100,
       sprite: hero.sprite == null ? void 0 : str(hero.sprite)
     })),
-    [heroes]
+    [heroes, propUnits]
   );
   const MOVE_SPEED_MS_PER_TILE = 300;
   const movementAnimRef = useRef(null);
@@ -48222,12 +48252,20 @@ function WorldMapTemplate({
   unitScale = 2.5,
   diamondTopY,
   allowMoveAllHeroes = false,
+  tiles,
+  units,
+  features,
+  assetManifest,
   className
 }) {
   return /* @__PURE__ */ jsx(
     WorldMapBoard,
     {
       entity,
+      tiles,
+      units,
+      features,
+      assetManifest,
       scale,
       unitScale,
       diamondTopY,

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

@@ -20,6 +20,7 @@
 import React from 'react';
 import type { 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';
 /** Battle phases an encounter walks through (UI value enum — not entity data). */
 export type BattlePhase = 'observation' | 'selection' | 'movement' | 'action' | 'enemy_turn' | 'game_over';
@@ -45,9 +46,25 @@ export type BattleSlotContext = {
         y: number;
     };
 };
+/** 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>;
+};
 export interface BattleBoardProps extends DisplayStateProps {
     /** Entity (single board state) containing all board data */
     entity?: EntityRow | readonly EntityRow[];
+    /** Direct tile data — takes priority over entity-derived tiles. */
+    tiles?: IsometricTile[];
+    /** Direct unit data — takes priority over entity-derived units. */
+    units?: IsometricUnit[];
+    /** Direct feature data — takes priority over entity-derived features. */
+    features?: IsometricFeature[];
+    /** Direct asset manifest — takes priority over entity-derived manifest. */
+    assetManifest?: BattleAssetManifest;
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -104,7 +121,7 @@ export interface BattleBoardProps extends DisplayStateProps {
     }>;
     className?: string;
 }
-export declare function BattleBoard({ entity, scale, unitScale, header, sidebar, actions, overlay, gameOverOverlay, onAttack, onGameEnd, onUnitMove, calculateDamage, onDrawEffects, hasActiveEffects, effectSpriteUrls, resolveUnitFrame, tileClickEvent, unitClickEvent, endTurnEvent, cancelEvent, gameEndEvent, playAgainEvent, attackEvent, className, }: BattleBoardProps): React.JSX.Element;
+export declare function BattleBoard({ entity, tiles: propTiles, units: propUnits, features: propFeatures, assetManifest: propAssetManifest, scale, unitScale, header, sidebar, actions, overlay, gameOverOverlay, onAttack, onGameEnd, onUnitMove, calculateDamage, onDrawEffects, hasActiveEffects, effectSpriteUrls, resolveUnitFrame, tileClickEvent, unitClickEvent, endTurnEvent, cancelEvent, gameEndEvent, playAgainEvent, attackEvent, className, }: BattleBoardProps): React.JSX.Element;
 export declare namespace BattleBoard {
     var displayName: string;
 }

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

@@ -63,7 +63,7 @@ export interface CanvasEffectProps {
     /** Canvas height (default 300) */
     height?: number;
 }
-export declare function CanvasEffect(props: CanvasEffectProps): React.JSX.Element | null;
+export declare function CanvasEffect({ effectSpriteUrl, assetBaseUrl, ...props }: CanvasEffectProps): React.JSX.Element | null;
 export declare namespace CanvasEffect {
     var displayName: string;
 }

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

@@ -13,8 +13,15 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { IsometricUnit, IsometricFeature } from './types/isometric';
+import type { AssetUrl, 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). */
+type CastleAssetManifest = {
+    baseUrl?: AssetUrl;
+    terrains?: Record<string, AssetUrl>;
+    units?: Record<string, AssetUrl>;
+    features?: Record<string, AssetUrl>;
+};
 /** Context exposed to render-prop slots */
 export type CastleSlotContext = {
     /** Currently hovered tile coordinates (null when not hovering) */
@@ -42,6 +49,14 @@ export interface CastleBoardProps {
     /** Castle board-state entity (single row or array). The board reads
      *  `tiles` / `features` / `units` arrays plus an `assetManifest` off it. */
     entity?: EntityRow | readonly EntityRow[];
+    /** Direct tile data — takes priority over entity-derived tiles. */
+    tiles?: IsometricTile[];
+    /** Direct unit data — takes priority over entity-derived units. */
+    units?: IsometricUnit[];
+    /** Direct feature data — takes priority over entity-derived features. */
+    features?: IsometricFeature[];
+    /** Direct asset manifest — takes priority over entity-derived manifest. */
+    assetManifest?: CastleAssetManifest;
     /** Canvas render scale */
     scale?: number;
     /** Top bar / header */
@@ -76,7 +91,7 @@ export interface CastleBoardProps {
     }>;
     className?: string;
 }
-export declare function CastleBoard({ entity, scale, header, sidePanel, overlay, footer, onFeatureClick, onUnitClick, onTileClick, featureClickEvent, unitClickEvent, tileClickEvent, className, }: CastleBoardProps): React.JSX.Element;
+export declare function CastleBoard({ entity, tiles: propTiles, units: propUnits, features: propFeatures, assetManifest: propAssetManifest, scale, header, sidePanel, overlay, footer, onFeatureClick, onUnitClick, onTileClick, featureClickEvent, unitClickEvent, tileClickEvent, className, }: CastleBoardProps): React.JSX.Element;
 export declare namespace CastleBoard {
     var displayName: string;
 }

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

@@ -20,8 +20,16 @@
  */
 import React from 'react';
 import type { 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). */
+type WorldMapAssetManifest = {
+    baseUrl?: AssetUrl;
+    terrains?: Record<string, AssetUrl>;
+    units?: Record<string, AssetUrl>;
+    features?: Record<string, AssetUrl>;
+};
 /** Context exposed to render-prop slots. Hex / hero rows are `EntityRow`. */
 export type WorldMapSlotContext = {
     /** Currently hovered tile */
@@ -67,6 +75,14 @@ export interface WorldMapBoardProps {
     /** World-map board-state entity (single row or array). The board reads
      *  `hexes` / `heroes` / `features` arrays + `selectedHeroId` off it. */
     entity?: EntityRow | readonly EntityRow[];
+    /** Direct tile data — takes priority over entity-derived tiles. */
+    tiles?: IsometricTile[];
+    /** Direct unit data — takes priority over entity-derived units. */
+    units?: IsometricUnit[];
+    /** Direct feature data — takes priority over entity-derived features. */
+    features?: IsometricFeature[];
+    /** Direct asset manifest — takes priority over entity-derived manifest. */
+    assetManifest?: WorldMapAssetManifest;
     /** Canvas render scale */
     scale?: number;
     /** Unit draw-size multiplier */
@@ -128,7 +144,7 @@ export interface WorldMapBoardProps {
     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;
+export declare function WorldMapBoard({ entity, tiles: propTiles, units: propUnits, features: propFeatures, assetManifest: propAssetManifest, 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;
 export declare namespace WorldMapBoard {
     var displayName: string;
 }

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

@@ -10,12 +10,22 @@
  */
 import React from 'react';
 import type { TemplateProps } from '../../core/templates/types';
+import type { CastleBoardProps } from '../organisms/CastleBoard';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../organisms/types/isometric';
 export type { CastleSlotContext } from '../organisms/CastleBoard';
 export interface CastleTemplateProps extends TemplateProps {
     /** Canvas render scale */
     scale?: number;
+    /** Direct tile data — forwarded to CastleBoard; takes priority over entity. */
+    tiles?: IsometricTile[];
+    /** Direct unit data — forwarded to CastleBoard; takes priority over entity. */
+    units?: IsometricUnit[];
+    /** Direct feature data — forwarded to CastleBoard; takes priority over entity. */
+    features?: IsometricFeature[];
+    /** Direct asset manifest — forwarded to CastleBoard; takes priority over entity. */
+    assetManifest?: CastleBoardProps['assetManifest'];
 }
-export declare function CastleTemplate({ entity, scale, className, }: CastleTemplateProps): React.JSX.Element | null;
+export declare function CastleTemplate({ entity, scale, tiles, units, features, assetManifest, className, }: CastleTemplateProps): React.JSX.Element | null;
 export declare namespace CastleTemplate {
     var displayName: string;
 }