@almadar/ui 5.60.0 → 5.62.0

package/dist/components/core/molecules/GraphCanvas.d.ts

@@ -55,6 +55,8 @@ export interface GraphCanvasProps {
     actions?: readonly GraphAction[];
     /** On node click */
     onNodeClick?: (node: GraphNode) => void;
+    /** On node double-click (e.g. to drill in) */
+    onNodeDoubleClick?: (node: GraphNode) => void;
     /** Node click event */
     nodeClickEvent?: EventEmit<{
         id: string;
@@ -65,6 +67,10 @@ export interface GraphCanvasProps {
     repulsion?: number;
     /** Force-sim target edge length (larger ⇒ more spread out) */
     linkDistance?: number;
+    /** Minimum empty gap (px) enforced between node edges so nodes never overlap. */
+    nodeSpacing?: number;
+    /** Base opacity for links when nothing is hovered (kept faint so dense graphs stay readable; incident links brighten on hover). */
+    linkOpacity?: number;
     /** Layout algorithm */
     layout?: "force" | "circular" | "grid";
     /** Entity name for schema-driven auto-fetch */

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

@@ -11,6 +11,10 @@ export { WorldMapTemplate, type WorldMapTemplateProps, type WorldMapSlotContext,
 export { PlatformerTemplate, type PlatformerTemplateProps, } from '../../game/templates/PlatformerTemplate';
 export { TowerDefenseTemplate, type TowerDefenseTemplateProps, } from '../../game/templates/TowerDefenseTemplate';
 export { RoguelikeTemplate, type RoguelikeTemplateProps, } from '../../game/templates/RoguelikeTemplate';
+export { TopDownShooterTemplate, type TopDownShooterTemplateProps, } from '../../game/templates/TopDownShooterTemplate';
+export { CityBuilderTemplate, type CityBuilderTemplateProps, } from '../../game/templates/CityBuilderTemplate';
+export { VisualNovelTemplate, type VisualNovelTemplateProps, } from '../../game/templates/VisualNovelTemplate';
+export { CardBattlerTemplate, type CardBattlerTemplateProps, } from '../../game/templates/CardBattlerTemplate';
 export { LandingPageTemplate, type LandingPageTemplateProps, type LandingPageEntity, } from '../../marketing/templates/LandingPageTemplate';
 export { PricingPageTemplate, type PricingPageTemplateProps, type PricingPageEntity, } from '../../marketing/templates/PricingPageTemplate';
 export { FeatureDetailPageTemplate, type FeatureDetailPageTemplateProps, type FeatureDetailPageEntity, type FeatureDetailSection, } from '../../marketing/templates/FeatureDetailPageTemplate';

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

@@ -0,0 +1,35 @@
+import * as React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+/** One playable card (icon + title + a few stat numbers). UI value DTO. */
+export interface CardHandCard {
+    id: string;
+    iconUrl?: AssetUrl;
+    title?: string;
+    cost?: number;
+    attack?: number;
+    defense?: number;
+    disabled?: boolean;
+}
+export interface CardHandProps {
+    /** Cards to lay out as a horizontal hand (or grid when wrapped). */
+    cards: CardHandCard[];
+    /** Currently selected card id. */
+    selectedId?: string;
+    /** Card-art size variant. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Direct callback when a (non-disabled) card is clicked. */
+    onCardClick?: (id: string) => void;
+    /** Event-bus event emitted with `{ cardId }` on click. */
+    cardClickEvent?: EventEmit<{
+        cardId: string;
+    }>;
+    /** Empty-state label when there are no cards. */
+    emptyLabel?: string;
+    className?: string;
+}
+/** Pure card-hand molecule: renders a row/grid of cards from props alone. */
+export declare function CardHand({ cards, selectedId, size, onCardClick, cardClickEvent, emptyLabel, className, }: CardHandProps): React.JSX.Element;
+export declare namespace CardHand {
+    var displayName: string;
+}
+export default CardHand;

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

@@ -12,7 +12,7 @@
  * concern analogous to Form's `formData`.
  */
 import React from 'react';
-import type { EventEmit, EventPayload } from '@almadar/core';
+import type { AssetUrl, EventEmit, EventPayload } from '@almadar/core';
 export type DialogueChoice = EventPayload & {
     text: string;
     action?: string;
@@ -53,8 +53,14 @@ export interface DialogueBoxProps {
     }>;
     /** Declarative event: emits UI:{advanceEvent} when dialogue is advanced */
     advanceEvent?: EventEmit<Record<string, never>>;
+    /** Optional full-frame scene image rendered behind the dialogue (visual-novel mode). */
+    backgroundImage?: AssetUrl;
+    /** Optional larger character portrait rendered standing over the scene (visual-novel mode). */
+    portraitUrl?: AssetUrl;
+    /** Multiplier for the large `portraitUrl` height relative to its default (default 1). */
+    portraitScale?: number;
     /** Optional className */
     className?: string;
 }
-export declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, className, }: DialogueBoxProps): React.JSX.Element;
+export declare function DialogueBox({ dialogue, typewriterSpeed, position, onComplete, onChoice, onAdvance, completeEvent, choiceEvent, advanceEvent, backgroundImage, portraitUrl, portraitScale, className, }: DialogueBoxProps): React.JSX.Element;
 export default DialogueBox;

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

@@ -9,6 +9,7 @@ export { DPad, type DPadProps, type DPadDirection } from './DPad';
 export { ActionButtons, type ActionButtonsProps, type ActionButtonConfig } from './ActionButtons';
 export { StatBadge, type StatBadgeProps } from './StatBadge';
 export { InventoryGrid, type InventoryGridProps, type InventoryGridItem } from './InventoryGrid';
+export { CardHand, type CardHandProps, type CardHandCard } from './CardHand';
 export { QuestTracker, type QuestTrackerProps, type Quest } from './QuestTracker';
 export { CraftingRecipe, type CraftingRecipeProps, type CraftingIngredient } from './CraftingRecipe';
 export { PowerupSlots, type PowerupSlotsProps, type ActivePowerup } from './PowerupSlots';

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

@@ -401,12 +401,18 @@ function ModelLoader({
     });
     return cloned;
   }, [loadedModel, castShadow, receiveShadow]);
+  const normFactor = React11.useMemo(() => {
+    if (!model) return 1;
+    const box = new THREE6__namespace.Box3().setFromObject(model);
+    const size = new THREE6__namespace.Vector3();
+    box.getSize(size);
+    const maxDim = Math.max(size.x, size.y, size.z);
+    return maxDim > 0 && Number.isFinite(maxDim) ? 1 / maxDim : 1;
+  }, [model]);
   const scaleArray = React11.useMemo(() => {
-    if (typeof scale === "number") {
-      return [scale, scale, scale];
-    }
-    return scale;
-  }, [scale]);
+    const base = typeof scale === "number" ? [scale, scale, scale] : scale;
+    return [base[0] * normFactor, base[1] * normFactor, base[2] * normFactor];
+  }, [scale, normFactor]);
   const rotationRad = React11.useMemo(() => {
     return [
       rotation[0] * Math.PI / 180,
@@ -2590,6 +2596,29 @@ var GameCanvas3D = React11.forwardRef(
     const controlsRef = React11.useRef(null);
     const [hoveredTile, setHoveredTile] = React11.useState(null);
     const [internalError, setInternalError] = React11.useState(null);
+    React11.useEffect(() => {
+      const el = containerRef.current;
+      if (!el) return;
+      let node = el;
+      let depth = 0;
+      while (node && depth < 8) {
+        const cs = window.getComputedStyle(node);
+        const rect = node.getBoundingClientRect();
+        console.log("[almadar:ui:game:3d-height]", {
+          depth,
+          tag: node.tagName,
+          id: node.id || void 0,
+          className: node.className?.slice?.(0, 60) || void 0,
+          rectHeight: rect.height,
+          computedHeight: cs.height,
+          computedMinHeight: cs.minHeight,
+          computedFlex: cs.flex,
+          computedOverflow: cs.overflow
+        });
+        node = node.parentElement;
+        depth++;
+      }
+    }, []);
     const { sheetUrls: atlasSheetUrls, resolveUnitFrame } = useUnitSpriteAtlas(units);
     const preloadUrls = React11.useMemo(() => [...preloadAssets, ...atlasSheetUrls], [preloadAssets, atlasSheetUrls]);
     const { isLoading: assetsLoading, progress, loaded, total } = useAssetLoader({
@@ -2718,24 +2747,28 @@ var GameCanvas3D = React11.forwardRef(
     const cameraConfig = React11.useMemo(() => {
       const size = Math.max(
         gridBounds.maxX - gridBounds.minX,
-        gridBounds.maxZ - gridBounds.minZ
+        gridBounds.maxZ - gridBounds.minZ,
+        4
+        // minimum framing distance so a tiny board isn't zoomed in
       );
-      const distance = size * 1.5;
+      const cx = (gridBounds.minX + gridBounds.maxX) / 2;
+      const cz = (gridBounds.minZ + gridBounds.maxZ) / 2;
+      const d = size * 1.5;
       switch (cameraMode) {
         case "isometric":
           return {
-            position: [distance, distance * 0.8, distance],
+            position: [cx + d, d * 0.8, cz + d],
             fov: 45
           };
         case "top-down":
           return {
-            position: [0, distance * 2, 0],
+            position: [cx, d * 2, cz],
             fov: 45
           };
         case "perspective":
         default:
           return {
-            position: [distance, distance, distance],
+            position: [cx + d, d, cz + d],
             fov: 45
           };
       }
@@ -2974,7 +3007,8 @@ var GameCanvas3D = React11.forwardRef(
           "div",
           {
             ref: containerRef,
-            className: cn("game-canvas-3d relative w-full h-full min-h-[85vh] overflow-hidden", className),
+            className: cn("game-canvas-3d relative w-full overflow-hidden", className),
+            style: { height: "85vh" },
             "data-orientation": orientation,
             "data-camera-mode": cameraMode,
             "data-overlay": overlay,
@@ -2989,7 +3023,7 @@ var GameCanvas3D = React11.forwardRef(
                     near: 0.1,
                     far: 1e3
                   },
-                  style: { background: backgroundColor },
+                  style: { background: backgroundColor, position: "absolute", inset: 0 },
                   onClick: (e) => {
                     if (e.target === e.currentTarget) {
                       eventHandlers.handleCanvasClick(e);
@@ -4590,36 +4624,113 @@ var Box = React11__default.default.forwardRef(
   }
 );
 Box.displayName = "Box";
-var CDN = "https://almadar-kflow-assets.web.app/shared/3d/dungeon/floor";
-var FLOOR_WALL = `${CDN}/template-floor-detail-a.glb`;
-var FLOOR_DIRT = `${CDN}/template-floor-detail.glb`;
-var FLOOR_OPEN = `${CDN}/template-floor.glb`;
-var DEFAULT_3D_BATTLE_TILES = [
-  { id: "t00", x: 0, y: 0, z: 0, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t10", x: 1, y: 0, z: 0, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t20", x: 2, y: 0, z: 0, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t30", x: 3, y: 0, z: 0, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t40", x: 4, y: 0, z: 0, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t01", x: 0, y: 1, z: 1, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t11", x: 1, y: 1, z: 1, type: "dirt", passable: true, modelUrl: FLOOR_DIRT },
-  { id: "t21", x: 2, y: 1, z: 1, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t31", x: 3, y: 1, z: 1, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t41", x: 4, y: 1, z: 1, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t02", x: 0, y: 2, z: 2, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t12", x: 1, y: 2, z: 2, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t22", x: 2, y: 2, z: 2, type: "dirt", passable: true, modelUrl: FLOOR_DIRT },
-  { id: "t32", x: 3, y: 2, z: 2, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t42", x: 4, y: 2, z: 2, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t03", x: 0, y: 3, z: 3, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t13", x: 1, y: 3, z: 3, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t23", x: 2, y: 3, z: 3, type: "grass", passable: true, modelUrl: FLOOR_OPEN },
-  { id: "t33", x: 3, y: 3, z: 3, type: "dirt", passable: true, modelUrl: FLOOR_DIRT },
-  { id: "t43", x: 4, y: 3, z: 3, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t04", x: 0, y: 4, z: 4, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t14", x: 1, y: 4, z: 4, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t24", x: 2, y: 4, z: 4, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t34", x: 3, y: 4, z: 4, type: "stone", passable: false, modelUrl: FLOOR_WALL },
-  { id: "t44", x: 4, y: 4, z: 4, type: "stone", passable: false, modelUrl: FLOOR_WALL }
+
+// 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}`;
+}
+function tileKind(type, passable) {
+  if (passable === false) return "wall";
+  if (type === "dirt" || type === "road") return "dirt";
+  return "open";
+}
+function resolveTilesWithModels(layout, manifest) {
+  return layout.map((t) => {
+    const kind = t.kind || tileKind(t.type, t.passable);
+    return {
+      id: t.id,
+      x: t.x,
+      y: t.y,
+      z: t.z,
+      type: t.type,
+      passable: t.passable,
+      modelUrl: resolveManifestUrl(manifest, manifest?.models?.[kind])
+    };
+  });
+}
+function resolvePropTiles(tiles, manifest) {
+  return tiles.map((t) => {
+    const kind = tileKind(t.type ?? "", t.passable);
+    return {
+      ...t,
+      modelUrl: t.modelUrl ?? resolveManifestUrl(manifest, manifest?.models?.[kind])
+    };
+  });
+}
+function resolveEntityTiles(entity, manifest) {
+  const row = boardEntity(entity);
+  if (!row) return [];
+  return rows(row.tiles).map((r) => {
+    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);
+    return {
+      id: r.id == null ? void 0 : str(r.id),
+      x: num(r.x),
+      y: num(r.y),
+      z: r.z == null ? void 0 : num(r.z),
+      type,
+      passable,
+      modelUrl: explicitModel ?? resolveManifestUrl(manifest, manifest?.models?.[kind])
+    };
+  });
+}
+function resolveFeaturesWithModels(features, manifest) {
+  return features.map((f) => ({
+    ...f,
+    assetUrl: f.assetUrl ?? resolveManifestUrl(manifest, manifest?.features?.[f.type])
+  }));
+}
+function resolveEntityFeatures(entity, manifest) {
+  const row = boardEntity(entity);
+  if (!row) return [];
+  return rows(row.features).map((r) => {
+    const type = str(r.type);
+    const explicit = r.assetUrl == null ? void 0 : str(r.assetUrl);
+    return {
+      id: r.id == null ? void 0 : str(r.id),
+      x: num(r.x),
+      y: num(r.y),
+      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])
+    };
+  });
+}
+var DEFAULT_3D_BATTLE_LAYOUT = [
+  { id: "t00", x: 0, y: 0, z: 0, type: "stone", passable: false, kind: "wall" },
+  { id: "t10", x: 1, y: 0, z: 0, type: "stone", passable: false, kind: "wall" },
+  { id: "t20", x: 2, y: 0, z: 0, type: "stone", passable: false, kind: "wall" },
+  { id: "t30", x: 3, y: 0, z: 0, type: "stone", passable: false, kind: "wall" },
+  { id: "t40", x: 4, y: 0, z: 0, type: "stone", passable: false, kind: "wall" },
+  { id: "t01", x: 0, y: 1, z: 1, type: "stone", passable: false, kind: "wall" },
+  { id: "t11", x: 1, y: 1, z: 1, type: "dirt", passable: true, kind: "dirt" },
+  { id: "t21", x: 2, y: 1, z: 1, type: "grass", passable: true, kind: "open" },
+  { id: "t31", x: 3, y: 1, z: 1, type: "grass", passable: true, kind: "open" },
+  { id: "t41", x: 4, y: 1, z: 1, type: "stone", passable: false, kind: "wall" },
+  { id: "t02", x: 0, y: 2, z: 2, type: "stone", passable: false, kind: "wall" },
+  { id: "t12", x: 1, y: 2, z: 2, type: "grass", passable: true, kind: "open" },
+  { id: "t22", x: 2, y: 2, z: 2, type: "dirt", passable: true, kind: "dirt" },
+  { id: "t32", x: 3, y: 2, z: 2, type: "grass", passable: true, kind: "open" },
+  { id: "t42", x: 4, y: 2, z: 2, type: "stone", passable: false, kind: "wall" },
+  { id: "t03", x: 0, y: 3, z: 3, type: "stone", passable: false, kind: "wall" },
+  { id: "t13", x: 1, y: 3, z: 3, type: "grass", passable: true, kind: "open" },
+  { id: "t23", x: 2, y: 3, z: 3, type: "grass", passable: true, kind: "open" },
+  { id: "t33", x: 3, y: 3, z: 3, type: "dirt", passable: true, kind: "dirt" },
+  { id: "t43", x: 4, y: 3, z: 3, type: "stone", passable: false, kind: "wall" },
+  { id: "t04", x: 0, y: 4, z: 4, type: "stone", passable: false, kind: "wall" },
+  { id: "t14", x: 1, y: 4, z: 4, type: "stone", passable: false, kind: "wall" },
+  { id: "t24", x: 2, y: 4, z: 4, type: "stone", passable: false, kind: "wall" },
+  { id: "t34", x: 3, y: 4, z: 4, type: "stone", passable: false, kind: "wall" },
+  { id: "t44", x: 4, y: 4, z: 4, type: "stone", passable: false, kind: "wall" }
 ];
 var DEFAULT_3D_BATTLE_FEATURES = [
   { id: "f1", x: 2, y: 2, z: 2, type: "gold_mine", color: "#f4c542" },
@@ -4627,8 +4738,9 @@ var DEFAULT_3D_BATTLE_FEATURES = [
 ];
 function GameCanvas3DBattleTemplate({
   entity,
-  tiles: propTiles = DEFAULT_3D_BATTLE_TILES,
+  tiles: propTiles,
   features: propFeatures = DEFAULT_3D_BATTLE_FEATURES,
+  assetManifest,
   cameraMode = "perspective",
   backgroundColor = "#2a1a1a",
   tileClickEvent,
@@ -4642,11 +4754,12 @@ function GameCanvas3DBattleTemplate({
   scale,
   className
 }) {
-  const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
-  const tiles = resolved ? Array.isArray(resolved.tiles) ? resolved.tiles : [] : propTiles;
-  const features = resolved ? Array.isArray(resolved.features) ? resolved.features : [] : propFeatures;
-  const currentTurn = resolved?.currentTeam;
-  const round = resolved?.turn == null ? void 0 : Number(resolved.turn);
+  const row = boardEntity(entity);
+  const hasEntityTiles = !!row && Array.isArray(row.tiles) && row.tiles.length > 0;
+  const tiles = hasEntityTiles ? resolveEntityTiles(entity, assetManifest) : propTiles ? resolvePropTiles(propTiles, assetManifest) : resolveTilesWithModels(DEFAULT_3D_BATTLE_LAYOUT, assetManifest);
+  const features = row && Array.isArray(row.features) && row.features.length > 0 ? resolveEntityFeatures(entity, assetManifest) : resolveFeaturesWithModels(propFeatures, assetManifest);
+  const currentTurn = row?.currentTeam == null ? void 0 : String(row.currentTeam);
+  const round = row?.turn == null ? void 0 : Number(row.turn);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     Box,
     {
@@ -4692,36 +4805,32 @@ function GameCanvas3DBattleTemplate({
   );
 }
 GameCanvas3DBattleTemplate.displayName = "GameCanvas3DBattleTemplate";
-var CDN2 = "https://almadar-kflow-assets.web.app/shared/3d/dungeon/floor";
-var FLOOR_WALL2 = `${CDN2}/template-floor-detail-a.glb`;
-var FLOOR_DIRT2 = `${CDN2}/template-floor-detail.glb`;
-var FLOOR_OPEN2 = `${CDN2}/template-floor.glb`;
-var DEFAULT_3D_CASTLE_TILES = [
-  { id: "t00", x: 0, y: 0, z: 0, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t10", x: 1, y: 0, z: 0, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t20", x: 2, y: 0, z: 0, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t30", x: 3, y: 0, z: 0, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t40", x: 4, y: 0, z: 0, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t01", x: 0, y: 1, z: 1, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t11", x: 1, y: 1, z: 1, type: "floor", passable: true, modelUrl: FLOOR_DIRT2 },
-  { id: "t21", x: 2, y: 1, z: 1, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t31", x: 3, y: 1, z: 1, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t41", x: 4, y: 1, z: 1, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t02", x: 0, y: 2, z: 2, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t12", x: 1, y: 2, z: 2, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t22", x: 2, y: 2, z: 2, type: "floor", passable: true, modelUrl: FLOOR_DIRT2 },
-  { id: "t32", x: 3, y: 2, z: 2, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t42", x: 4, y: 2, z: 2, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t03", x: 0, y: 3, z: 3, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t13", x: 1, y: 3, z: 3, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t23", x: 2, y: 3, z: 3, type: "floor", passable: true, modelUrl: FLOOR_OPEN2 },
-  { id: "t33", x: 3, y: 3, z: 3, type: "floor", passable: true, modelUrl: FLOOR_DIRT2 },
-  { id: "t43", x: 4, y: 3, z: 3, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t04", x: 0, y: 4, z: 4, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t14", x: 1, y: 4, z: 4, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t24", x: 2, y: 4, z: 4, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t34", x: 3, y: 4, z: 4, type: "wall", passable: false, modelUrl: FLOOR_WALL2 },
-  { id: "t44", x: 4, y: 4, z: 4, type: "wall", passable: false, modelUrl: FLOOR_WALL2 }
+var DEFAULT_3D_CASTLE_LAYOUT = [
+  { id: "t00", x: 0, y: 0, z: 0, type: "wall", passable: false, kind: "wall" },
+  { id: "t10", x: 1, y: 0, z: 0, type: "wall", passable: false, kind: "wall" },
+  { id: "t20", x: 2, y: 0, z: 0, type: "wall", passable: false, kind: "wall" },
+  { id: "t30", x: 3, y: 0, z: 0, type: "wall", passable: false, kind: "wall" },
+  { id: "t40", x: 4, y: 0, z: 0, type: "wall", passable: false, kind: "wall" },
+  { id: "t01", x: 0, y: 1, z: 1, type: "wall", passable: false, kind: "wall" },
+  { id: "t11", x: 1, y: 1, z: 1, type: "floor", passable: true, kind: "dirt" },
+  { id: "t21", x: 2, y: 1, z: 1, type: "floor", passable: true, kind: "open" },
+  { id: "t31", x: 3, y: 1, z: 1, type: "floor", passable: true, kind: "open" },
+  { id: "t41", x: 4, y: 1, z: 1, type: "wall", passable: false, kind: "wall" },
+  { id: "t02", x: 0, y: 2, z: 2, type: "wall", passable: false, kind: "wall" },
+  { id: "t12", x: 1, y: 2, z: 2, type: "floor", passable: true, kind: "open" },
+  { id: "t22", x: 2, y: 2, z: 2, type: "floor", passable: true, kind: "dirt" },
+  { id: "t32", x: 3, y: 2, z: 2, type: "floor", passable: true, kind: "open" },
+  { id: "t42", x: 4, y: 2, z: 2, type: "wall", passable: false, kind: "wall" },
+  { id: "t03", x: 0, y: 3, z: 3, type: "wall", passable: false, kind: "wall" },
+  { id: "t13", x: 1, y: 3, z: 3, type: "floor", passable: true, kind: "open" },
+  { id: "t23", x: 2, y: 3, z: 3, type: "floor", passable: true, kind: "open" },
+  { id: "t33", x: 3, y: 3, z: 3, type: "floor", passable: true, kind: "dirt" },
+  { id: "t43", x: 4, y: 3, z: 3, type: "wall", passable: false, kind: "wall" },
+  { id: "t04", x: 0, y: 4, z: 4, type: "wall", passable: false, kind: "wall" },
+  { id: "t14", x: 1, y: 4, z: 4, type: "wall", passable: false, kind: "wall" },
+  { id: "t24", x: 2, y: 4, z: 4, type: "wall", passable: false, kind: "wall" },
+  { id: "t34", x: 3, y: 4, z: 4, type: "wall", passable: false, kind: "wall" },
+  { id: "t44", x: 4, y: 4, z: 4, type: "wall", passable: false, kind: "wall" }
 ];
 var DEFAULT_3D_CASTLE_FEATURES = [
   { id: "f1", x: 2, y: 2, z: 2, type: "chest", color: "#f4c542" },
@@ -4729,8 +4838,9 @@ var DEFAULT_3D_CASTLE_FEATURES = [
 ];
 function GameCanvas3DCastleTemplate({
   entity,
-  tiles: propTiles = DEFAULT_3D_CASTLE_TILES,
+  tiles: propTiles,
   features: propFeatures = DEFAULT_3D_CASTLE_FEATURES,
+  assetManifest,
   cameraMode = "isometric",
   backgroundColor = "#1e1e2e",
   buildingClickEvent,
@@ -4745,13 +4855,14 @@ function GameCanvas3DCastleTemplate({
   scale,
   className
 }) {
-  const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
-  const tiles = resolved ? Array.isArray(resolved.tiles) ? resolved.tiles : [] : propTiles;
-  const features = resolved ? Array.isArray(resolved.features) ? resolved.features : [] : propFeatures;
-  const name = resolved?.name == null ? void 0 : String(resolved.name);
-  const level = resolved?.level == null ? void 0 : Number(resolved.level);
-  const owner = resolved?.owner == null ? void 0 : String(resolved.owner);
-  const unitCount = resolved && Array.isArray(resolved.units) ? resolved.units.length : 0;
+  const row = boardEntity(entity);
+  const hasEntityTiles = !!row && Array.isArray(row.tiles) && row.tiles.length > 0;
+  const tiles = hasEntityTiles ? resolveEntityTiles(entity, assetManifest) : propTiles ? resolvePropTiles(propTiles, assetManifest) : resolveTilesWithModels(DEFAULT_3D_CASTLE_LAYOUT, assetManifest);
+  const features = row && Array.isArray(row.features) && row.features.length > 0 ? resolveEntityFeatures(entity, assetManifest) : resolveFeaturesWithModels(propFeatures, assetManifest);
+  const name = row?.name == null ? void 0 : str(row.name);
+  const level = row?.level == null ? void 0 : num(row.level);
+  const owner = row?.owner == null ? void 0 : str(row.owner);
+  const unitCount = row && Array.isArray(row.units) ? row.units.length : 0;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     VStack,
     {
@@ -4797,36 +4908,32 @@ function GameCanvas3DCastleTemplate({
   );
 }
 GameCanvas3DCastleTemplate.displayName = "GameCanvas3DCastleTemplate";
-var CDN3 = "https://almadar-kflow-assets.web.app/shared/3d/dungeon/floor";
-var FLOOR_WALL3 = `${CDN3}/template-floor-detail-a.glb`;
-var FLOOR_DIRT3 = `${CDN3}/template-floor-detail.glb`;
-var FLOOR_OPEN3 = `${CDN3}/template-floor.glb`;
-var DEFAULT_3D_WORLDMAP_TILES = [
-  { id: "t00", x: 0, y: 0, z: 0, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t10", x: 1, y: 0, z: 0, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t20", x: 2, y: 0, z: 0, type: "water", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t30", x: 3, y: 0, z: 0, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t40", x: 4, y: 0, z: 0, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t01", x: 0, y: 1, z: 1, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t11", x: 1, y: 1, z: 1, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t21", x: 2, y: 1, z: 1, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t31", x: 3, y: 1, z: 1, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t41", x: 4, y: 1, z: 1, type: "water", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t02", x: 0, y: 2, z: 2, type: "water", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t12", x: 1, y: 2, z: 2, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t22", x: 2, y: 2, z: 2, type: "road", passable: true, modelUrl: FLOOR_DIRT3 },
-  { id: "t32", x: 3, y: 2, z: 2, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t42", x: 4, y: 2, z: 2, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t03", x: 0, y: 3, z: 3, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t13", x: 1, y: 3, z: 3, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t23", x: 2, y: 3, z: 3, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t33", x: 3, y: 3, z: 3, type: "road", passable: true, modelUrl: FLOOR_DIRT3 },
-  { id: "t43", x: 4, y: 3, z: 3, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t04", x: 0, y: 4, z: 4, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t14", x: 1, y: 4, z: 4, type: "water", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t24", x: 2, y: 4, z: 4, type: "grass", passable: true, modelUrl: FLOOR_OPEN3 },
-  { id: "t34", x: 3, y: 4, z: 4, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 },
-  { id: "t44", x: 4, y: 4, z: 4, type: "mountain", passable: false, modelUrl: FLOOR_WALL3 }
+var DEFAULT_3D_WORLDMAP_LAYOUT = [
+  { id: "t00", x: 0, y: 0, z: 0, type: "mountain", passable: false, kind: "wall" },
+  { id: "t10", x: 1, y: 0, z: 0, type: "mountain", passable: false, kind: "wall" },
+  { id: "t20", x: 2, y: 0, z: 0, type: "water", passable: false, kind: "wall" },
+  { id: "t30", x: 3, y: 0, z: 0, type: "mountain", passable: false, kind: "wall" },
+  { id: "t40", x: 4, y: 0, z: 0, type: "mountain", passable: false, kind: "wall" },
+  { id: "t01", x: 0, y: 1, z: 1, type: "mountain", passable: false, kind: "wall" },
+  { id: "t11", x: 1, y: 1, z: 1, type: "grass", passable: true, kind: "open" },
+  { id: "t21", x: 2, y: 1, z: 1, type: "grass", passable: true, kind: "open" },
+  { id: "t31", x: 3, y: 1, z: 1, type: "grass", passable: true, kind: "open" },
+  { id: "t41", x: 4, y: 1, z: 1, type: "water", passable: false, kind: "wall" },
+  { id: "t02", x: 0, y: 2, z: 2, type: "water", passable: false, kind: "wall" },
+  { id: "t12", x: 1, y: 2, z: 2, type: "grass", passable: true, kind: "open" },
+  { id: "t22", x: 2, y: 2, z: 2, type: "road", passable: true, kind: "dirt" },
+  { id: "t32", x: 3, y: 2, z: 2, type: "grass", passable: true, kind: "open" },
+  { id: "t42", x: 4, y: 2, z: 2, type: "mountain", passable: false, kind: "wall" },
+  { id: "t03", x: 0, y: 3, z: 3, type: "mountain", passable: false, kind: "wall" },
+  { id: "t13", x: 1, y: 3, z: 3, type: "grass", passable: true, kind: "open" },
+  { id: "t23", x: 2, y: 3, z: 3, type: "grass", passable: true, kind: "open" },
+  { id: "t33", x: 3, y: 3, z: 3, type: "road", passable: true, kind: "dirt" },
+  { id: "t43", x: 4, y: 3, z: 3, type: "mountain", passable: false, kind: "wall" },
+  { id: "t04", x: 0, y: 4, z: 4, type: "mountain", passable: false, kind: "wall" },
+  { id: "t14", x: 1, y: 4, z: 4, type: "water", passable: false, kind: "wall" },
+  { id: "t24", x: 2, y: 4, z: 4, type: "grass", passable: true, kind: "open" },
+  { id: "t34", x: 3, y: 4, z: 4, type: "mountain", passable: false, kind: "wall" },
+  { id: "t44", x: 4, y: 4, z: 4, type: "mountain", passable: false, kind: "wall" }
 ];
 var DEFAULT_3D_WORLDMAP_FEATURES = [
   { id: "f1", x: 2, y: 2, z: 2, type: "capital", color: "#f4c542" },
@@ -4834,8 +4941,9 @@ var DEFAULT_3D_WORLDMAP_FEATURES = [
 ];
 function GameCanvas3DWorldMapTemplate({
   entity,
-  tiles: propTiles = DEFAULT_3D_WORLDMAP_TILES,
+  tiles: propTiles,
   features: propFeatures = DEFAULT_3D_WORLDMAP_FEATURES,
+  assetManifest,
   cameraMode = "isometric",
   backgroundColor = "#1a1a2e",
   tileClickEvent,
@@ -4849,9 +4957,10 @@ function GameCanvas3DWorldMapTemplate({
   scale,
   className
 }) {
-  const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
-  const tiles = resolved ? Array.isArray(resolved.tiles) ? resolved.tiles : [] : propTiles;
-  const features = resolved ? Array.isArray(resolved.features) ? resolved.features : [] : propFeatures;
+  const row = boardEntity(entity);
+  const hasEntityTiles = !!row && Array.isArray(row.tiles) && row.tiles.length > 0;
+  const tiles = hasEntityTiles ? resolveEntityTiles(entity, assetManifest) : propTiles ? resolvePropTiles(propTiles, assetManifest) : resolveTilesWithModels(DEFAULT_3D_WORLDMAP_LAYOUT, assetManifest);
+  const features = row && Array.isArray(row.features) && row.features.length > 0 ? resolveEntityFeatures(entity, assetManifest) : resolveFeaturesWithModels(propFeatures, assetManifest);
   return (
     /* GameBoard3D reads selectedUnitId/validMoves/attackTargets from entity */
     /* @__PURE__ */ jsxRuntime.jsx(