@almadar/ui 5.21.11 → 5.22.2

package/dist/avl/index.js

@@ -7130,7 +7130,7 @@ var init_SvgGrid = __esm({
       x,
       y,
       cols = 4,
-      rows = 3,
+      rows: rows2 = 3,
       spacing = 20,
       nodeRadius = 3,
       color = "var(--color-primary)",
@@ -7139,7 +7139,7 @@ var init_SvgGrid = __esm({
       highlights = []
     }) => {
       const highlightSet = new Set(highlights);
-      return /* @__PURE__ */ jsx("g", { className, opacity, children: Array.from({ length: rows }).map(
+      return /* @__PURE__ */ jsx("g", { className, opacity, children: Array.from({ length: rows2 }).map(
         (_, row) => Array.from({ length: cols }).map((_2, col) => {
           const index = row * cols + col;
           const isHighlighted = highlightSet.has(index);
@@ -7799,7 +7799,7 @@ var init_Input = __esm({
         onClear,
         value,
         options,
-        rows = 3,
+        rows: rows2 = 3,
         onChange,
         ...props
       }, ref) => {
@@ -7849,7 +7849,7 @@ var init_Input = __esm({
               ref,
               value,
               onChange,
-              rows,
+              rows: rows2,
               className: baseClassName,
               ...props
             }
@@ -9844,66 +9844,6 @@ var init_RangeSlider = __esm({
     RangeSlider.displayName = "RangeSlider";
   }
 });
-function easeOut(t) {
-  return t * (2 - t);
-}
-var AnimatedCounter;
-var init_AnimatedCounter = __esm({
-  "components/marketing/atoms/AnimatedCounter.tsx"() {
-    "use client";
-    init_cn();
-    init_Typography();
-    AnimatedCounter = ({
-      value: rawValue,
-      duration = 600,
-      prefix,
-      suffix,
-      className
-    }) => {
-      const numericRaw = typeof rawValue === "number" ? rawValue : Number.parseFloat(String(rawValue ?? ""));
-      const value = !Number.isNaN(numericRaw) ? numericRaw : 0;
-      const [displayValue, setDisplayValue] = useState(value);
-      const previousValueRef = useRef(value);
-      const animationFrameRef = useRef(null);
-      useEffect(() => {
-        const from = previousValueRef.current;
-        const to = value;
-        previousValueRef.current = value;
-        if (from === to) {
-          setDisplayValue(to);
-          return;
-        }
-        const startTime = performance.now();
-        const diff = to - from;
-        function animate(currentTime) {
-          const elapsed = currentTime - startTime;
-          const progress = Math.min(elapsed / duration, 1);
-          const easedProgress = easeOut(progress);
-          setDisplayValue(from + diff * easedProgress);
-          if (progress < 1) {
-            animationFrameRef.current = requestAnimationFrame(animate);
-          } else {
-            setDisplayValue(to);
-          }
-        }
-        animationFrameRef.current = requestAnimationFrame(animate);
-        return () => {
-          if (animationFrameRef.current !== null) {
-            cancelAnimationFrame(animationFrameRef.current);
-          }
-        };
-      }, [value, duration]);
-      const decimalPlaces = Number.isInteger(value) ? 0 : String(value).split(".")[1]?.length ?? 0;
-      const formattedValue = displayValue.toFixed(decimalPlaces);
-      return /* @__PURE__ */ jsxs(Typography, { variant: "h3", className: cn("tabular-nums", className), children: [
-        prefix,
-        formattedValue,
-        suffix
-      ] });
-    };
-    AnimatedCounter.displayName = "AnimatedCounter";
-  }
-});
 function useInfiniteScroll(onLoadMore, options = {}) {
   const { rootMargin = "200px", hasMore = true, isLoading = false } = options;
   const observerRef = useRef(null);
@@ -12387,15 +12327,15 @@ function HeaderSkeleton({ className }) {
     ] })
   ] });
 }
-function TableSkeleton({ rows = 5, columns = 4, className }) {
+function TableSkeleton({ rows: rows2 = 5, columns = 4, className }) {
   return /* @__PURE__ */ jsxs(VStack, { gap: "none", className: cn("border border-border rounded-lg overflow-hidden", className), children: [
     /* @__PURE__ */ jsx(HStack, { className: "px-4 py-3 bg-muted/30 border-b border-border", children: Array.from({ length: columns }).map((_, i) => /* @__PURE__ */ jsx(SkeletonBlock, { className: "h-4 flex-1 mx-2" }, i)) }),
-    Array.from({ length: rows }).map((_, rowIdx) => /* @__PURE__ */ jsx(
+    Array.from({ length: rows2 }).map((_, rowIdx) => /* @__PURE__ */ jsx(
       HStack,
       {
         className: cn(
           "px-4 py-3",
-          rowIdx < rows - 1 && "border-b border-border"
+          rowIdx < rows2 - 1 && "border-b border-border"
         ),
         children: Array.from({ length: columns }).map((_2, colIdx) => /* @__PURE__ */ jsx(SkeletonLine, { className: "flex-1 mx-2" }, colIdx))
       },
@@ -12443,18 +12383,18 @@ function CardSkeleton({ className }) {
     }
   );
 }
-function TextSkeleton({ rows = 3, className }) {
-  return /* @__PURE__ */ jsx(VStack, { gap: "sm", className, children: Array.from({ length: rows }).map((_, i) => /* @__PURE__ */ jsx(
+function TextSkeleton({ rows: rows2 = 3, className }) {
+  return /* @__PURE__ */ jsx(VStack, { gap: "sm", className, children: Array.from({ length: rows2 }).map((_, i) => /* @__PURE__ */ jsx(
     SkeletonLine,
     {
-      className: i === rows - 1 ? "w-2/3" : "w-full"
+      className: i === rows2 - 1 ? "w-2/3" : "w-full"
     },
     i
   )) });
 }
 function Skeleton({
   variant = "text",
-  rows,
+  rows: rows2,
   columns,
   fields,
   className
@@ -12464,15 +12404,15 @@ function Skeleton({
     case "header":
       return /* @__PURE__ */ jsx(HeaderSkeleton, { className });
     case "table":
-      return /* @__PURE__ */ jsx(TableSkeleton, { rows, columns, className });
+      return /* @__PURE__ */ jsx(TableSkeleton, { rows: rows2, columns, className });
     case "form":
       return /* @__PURE__ */ jsx(FormSkeleton, { fields, className });
     case "card":
       return /* @__PURE__ */ jsx(CardSkeleton, { className });
     case "text":
-      return /* @__PURE__ */ jsx(TextSkeleton, { rows, className });
+      return /* @__PURE__ */ jsx(TextSkeleton, { rows: rows2, className });
     default:
-      return /* @__PURE__ */ jsx(TextSkeleton, { rows, className });
+      return /* @__PURE__ */ jsx(TextSkeleton, { rows: rows2, className });
   }
 }
 var pulseClass;
@@ -13626,7 +13566,7 @@ var init_Menu = __esm({
       className
     }) => {
       const eventBus = useEventBus();
-      const { t } = useTranslate();
+      const { t, direction } = useTranslate();
       const [isOpen, setIsOpen] = useState(false);
       const [activeSubMenu, setActiveSubMenu] = useState(null);
       const [triggerRect, setTriggerRect] = useState(null);
@@ -13680,6 +13620,18 @@ var init_Menu = __esm({
         "bottom-start": "top-full left-0 mt-2",
         "bottom-end": "top-full right-0 mt-2"
       };
+      const rtlMirror = {
+        "top-left": "top-right",
+        "top-right": "top-left",
+        "bottom-left": "bottom-right",
+        "bottom-right": "bottom-left",
+        "top-start": "top-end",
+        "top-end": "top-start",
+        "bottom-start": "bottom-end",
+        "bottom-end": "bottom-start"
+      };
+      const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
+      const subMenuSideClass = direction === "rtl" ? "right-full mr-2" : "left-full ml-2";
       const triggerChild = React97__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
       const triggerElement = React97__default.cloneElement(
         triggerChild,
@@ -13707,7 +13659,7 @@ var init_Menu = __esm({
             onMouseEnter: () => hasSubMenu && setActiveSubMenu(itemId),
             "data-testid": item.event ? `action-${item.event}` : void 0,
             className: cn(
-              "w-full flex items-center justify-between gap-3 px-4 py-2 text-left",
+              "w-full flex items-center justify-between gap-3 px-4 py-2 text-start",
               "text-sm transition-colors",
               "hover:bg-muted",
               "focus:outline-none focus:bg-muted",
@@ -13726,7 +13678,7 @@ var init_Menu = __esm({
                 }
               ),
               item.badge !== void 0 && /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", children: item.badge }),
-              hasSubMenu && /* @__PURE__ */ jsx(Icon, { name: "chevron-right", size: "sm", className: "flex-shrink-0" })
+              hasSubMenu && /* @__PURE__ */ jsx(Icon, { name: direction === "rtl" ? "chevron-left" : "chevron-right", size: "sm", className: "flex-shrink-0" })
             ] })
           },
           itemId
@@ -13746,7 +13698,8 @@ var init_Menu = __esm({
               Box,
               {
                 className: cn(
-                  "absolute left-full top-0 ml-2 z-50",
+                  "absolute top-0 z-50",
+                  subMenuSideClass,
                   menuContainerStyles
                 ),
                 children: renderMenuItems(item.subMenu)
@@ -13764,12 +13717,12 @@ var init_Menu = __esm({
             className: cn(
               "absolute z-50",
               menuContainerStyles,
-              positionClasses3[position],
+              positionClasses3[effectivePosition],
               className
             ),
             style: {
-              left: position.includes("left") ? 0 : "auto",
-              right: position.includes("right") ? 0 : "auto"
+              left: effectivePosition.includes("left") ? 0 : "auto",
+              right: effectivePosition.includes("right") ? 0 : "auto"
             },
             role: "menu",
             children: renderMenuItems(items)
@@ -14087,7 +14040,7 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect79, useRef: useRef71, useCallback: useCallback122, useState: useState113 } = React97__default;
+      const { useEffect: useEffect79, useRef: useRef71, useCallback: useCallback123, useState: useState113 } = React97__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus3 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
@@ -14133,7 +14086,7 @@ var init_MapView = __esm({
       }) {
         const eventBus = useEventBus3();
         const [clickedPosition, setClickedPosition] = useState113(null);
-        const handleMapClick = useCallback122((lat, lng) => {
+        const handleMapClick = useCallback123((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -14142,7 +14095,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback122((marker) => {
+        const handleMarkerClick = useCallback123((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -14363,7 +14316,7 @@ function InputPattern({
 function TextareaPattern({
   value = "",
   placeholder,
-  rows = 4,
+  rows: rows2 = 4,
   disabled = false,
   fieldError,
   onChange,
@@ -14383,7 +14336,7 @@ function TextareaPattern({
     {
       value: localValue,
       placeholder,
-      rows,
+      rows: rows2,
       disabled,
       error: fieldError,
       onChange: handleChange,
@@ -14868,6 +14821,91 @@ var init_ActionPalette = __esm({
     ActionPalette.displayName = "ActionPalette";
   }
 });
+function parseValue(value) {
+  if (value === "" || value == null) return { num: 0, prefix: "", suffix: "", decimals: 0 };
+  const match = String(value).match(/^([^0-9]*)([0-9]+(?:\.[0-9]+)?)(.*)$/);
+  if (!match) {
+    return { num: 0, prefix: "", suffix: String(value), decimals: 0 };
+  }
+  const numStr = match[2];
+  const decimalIdx = numStr.indexOf(".");
+  const decimals = decimalIdx >= 0 ? numStr.length - decimalIdx - 1 : 0;
+  return {
+    prefix: match[1],
+    num: parseFloat(numStr),
+    suffix: match[3],
+    decimals
+  };
+}
+var AnimatedCounter;
+var init_AnimatedCounter = __esm({
+  "components/core/molecules/AnimatedCounter.tsx"() {
+    "use client";
+    init_cn();
+    init_Box();
+    init_Typography();
+    AnimatedCounter = ({
+      value,
+      label,
+      duration = 1500,
+      className
+    }) => {
+      const ref = useRef(null);
+      const [displayValue, setDisplayValue] = useState("0");
+      const [hasAnimated, setHasAnimated] = useState(false);
+      const animate = useCallback(() => {
+        const { num: num2, prefix, suffix, decimals } = parseValue(value);
+        if (num2 === 0) {
+          setDisplayValue(String(value));
+          return;
+        }
+        const startTime = performance.now();
+        const tick = (now2) => {
+          const elapsed = now2 - startTime;
+          const progress = Math.min(elapsed / duration, 1);
+          const eased = 1 - Math.pow(1 - progress, 3);
+          const current = eased * num2;
+          setDisplayValue(`${prefix}${current.toFixed(decimals)}${suffix}`);
+          if (progress < 1) {
+            requestAnimationFrame(tick);
+          } else {
+            setDisplayValue(String(value));
+          }
+        };
+        requestAnimationFrame(tick);
+      }, [value, duration]);
+      useEffect(() => {
+        if (hasAnimated) return;
+        const el = ref.current;
+        if (!el) return;
+        const observer2 = new IntersectionObserver(
+          (entries) => {
+            if (entries[0].isIntersecting) {
+              setHasAnimated(true);
+              animate();
+              observer2.disconnect();
+            }
+          },
+          { threshold: 0.3 }
+        );
+        observer2.observe(el);
+        return () => observer2.disconnect();
+      }, [hasAnimated, animate]);
+      return /* @__PURE__ */ jsxs(Box, { ref, className: cn("flex flex-col items-center gap-1 p-4", className), children: [
+        /* @__PURE__ */ jsx(
+          Typography,
+          {
+            variant: "h2",
+            className: "text-primary font-bold tabular-nums",
+            children: hasAnimated ? displayValue : "0"
+          }
+        ),
+        /* @__PURE__ */ jsx(Typography, { variant: "body2", color: "muted", className: "text-center", children: label })
+      ] });
+    };
+    AnimatedCounter.displayName = "AnimatedCounter";
+  }
+});
 var AuthLayout;
 var init_AuthLayout = __esm({
   "components/core/templates/AuthLayout.tsx"() {
@@ -16253,6 +16291,39 @@ var init_IsometricCanvas2 = __esm({
     init_IsometricCanvas();
   }
 });
+
+// components/game/organisms/boardEntity.ts
+function boardEntity(entity) {
+  if (!entity) return void 0;
+  return Array.isArray(entity) ? entity[0] : entity;
+}
+function str(v) {
+  return v == null ? "" : String(v);
+}
+function num(v, fallback = 0) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : fallback;
+}
+function rows(v) {
+  return Array.isArray(v) ? v : [];
+}
+function vec2(v) {
+  const o = v ?? {};
+  return { x: num(o.x), y: num(o.y) };
+}
+function unitPosition(u) {
+  return vec2(u.position);
+}
+function unitTeam(u) {
+  return str(u.team);
+}
+function unitHealth(u) {
+  return num(u.health);
+}
+var init_boardEntity = __esm({
+  "components/game/organisms/boardEntity.ts"() {
+  }
+});
 function BattleBoard({
   entity,
   scale = 0.45,
@@ -16279,43 +16350,49 @@ function BattleBoard({
   attackEvent,
   className
 }) {
-  const tiles = entity.tiles;
-  const features = entity.features ?? [];
-  const boardWidth = entity.boardWidth ?? 8;
-  const boardHeight = entity.boardHeight ?? 6;
-  const assetManifest = entity.assetManifest;
-  const backgroundImage = entity.backgroundImage;
-  const units = entity.units;
-  const selectedUnitId = entity.selectedUnitId;
-  const currentPhase = entity.phase;
-  const currentTurn = entity.turn;
-  const gameResult = entity.gameResult;
+  const board = boardEntity(entity) ?? {};
+  const tiles = Array.isArray(board.tiles) ? board.tiles : [];
+  const features = Array.isArray(board.features) ? board.features : [];
+  const boardWidth = num(board.boardWidth, 8);
+  const boardHeight = num(board.boardHeight, 6);
+  const assetManifest = board.assetManifest;
+  const backgroundImage = board.backgroundImage;
+  const units = rows(board.units);
+  const selectedUnitId = board.selectedUnitId ?? null;
+  const currentPhase = str(board.phase) || "observation";
+  const currentTurn = num(board.turn, 1);
+  const gameResult = board.gameResult ?? null;
   const eventBus = useEventBus();
   const { t } = useTranslate();
   const [hoveredTile, setHoveredTile] = useState(null);
   const [isShaking, setIsShaking] = useState(false);
   const selectedUnit = useMemo(
-    () => units.find((u) => u.id === selectedUnitId) ?? null,
+    () => units.find((u) => str(u.id) === selectedUnitId) ?? null,
     [units, selectedUnitId]
   );
   const hoveredUnit = useMemo(() => {
     if (!hoveredTile) return null;
-    return units.find(
-      (u) => u.position.x === hoveredTile.x && u.position.y === hoveredTile.y && u.health > 0
-    ) ?? null;
+    return units.find((u) => {
+      const p2 = unitPosition(u);
+      return p2.x === hoveredTile.x && p2.y === hoveredTile.y && unitHealth(u) > 0;
+    }) ?? null;
   }, [hoveredTile, units]);
-  const playerUnits = useMemo(() => units.filter((u) => u.team === "player" && u.health > 0), [units]);
-  const enemyUnits = useMemo(() => units.filter((u) => u.team === "enemy" && u.health > 0), [units]);
+  const playerUnits = useMemo(() => units.filter((u) => unitTeam(u) === "player" && unitHealth(u) > 0), [units]);
+  const enemyUnits = useMemo(() => units.filter((u) => unitTeam(u) === "enemy" && unitHealth(u) > 0), [units]);
   const validMoves = useMemo(() => {
     if (!selectedUnit || currentPhase !== "movement") return [];
     const moves = [];
-    const range = selectedUnit.movement;
+    const range = num(selectedUnit.movement);
+    const origin = unitPosition(selectedUnit);
     for (let dy = -range; dy <= range; dy++) {
       for (let dx = -range; dx <= range; dx++) {
-        const nx = selectedUnit.position.x + dx;
-        const ny = selectedUnit.position.y + dy;
+        const nx = origin.x + dx;
+        const ny = origin.y + dy;
         const dist = Math.abs(dx) + Math.abs(dy);
-        if (dist > 0 && dist <= range && nx >= 0 && nx < boardWidth && ny >= 0 && ny < boardHeight && !units.some((u) => u.position.x === nx && u.position.y === ny && u.health > 0)) {
+        if (dist > 0 && dist <= range && nx >= 0 && nx < boardWidth && ny >= 0 && ny < boardHeight && !units.some((u) => {
+          const p2 = unitPosition(u);
+          return p2.x === nx && p2.y === ny && unitHealth(u) > 0;
+        })) {
           moves.push({ x: nx, y: ny });
         }
       }
@@ -16324,11 +16401,14 @@ function BattleBoard({
   }, [selectedUnit, currentPhase, units, boardWidth, boardHeight]);
   const attackTargets = useMemo(() => {
     if (!selectedUnit || currentPhase !== "action") return [];
-    return units.filter((u) => u.team !== selectedUnit.team && u.health > 0).filter((u) => {
-      const dx = Math.abs(u.position.x - selectedUnit.position.x);
-      const dy = Math.abs(u.position.y - selectedUnit.position.y);
+    const sp = unitPosition(selectedUnit);
+    const sTeam = unitTeam(selectedUnit);
+    return units.filter((u) => unitTeam(u) !== sTeam && unitHealth(u) > 0).filter((u) => {
+      const p2 = unitPosition(u);
+      const dx = Math.abs(p2.x - sp.x);
+      const dy = Math.abs(p2.y - sp.y);
       return dx <= 1 && dy <= 1 && dx + dy > 0;
-    }).map((u) => u.position);
+    }).map((u) => unitPosition(u));
   }, [selectedUnit, currentPhase, units]);
   const MOVE_SPEED_MS_PER_TILE = 300;
   const movementAnimRef = useRef(null);
@@ -16368,23 +16448,25 @@ function BattleBoard({
     return () => clearInterval(interval);
   }, []);
   const isoUnits = useMemo(() => {
-    return units.filter((u) => u.health > 0).map((unit) => {
-      const pos = movingPositions.get(unit.id) ?? unit.position;
+    return units.filter((u) => unitHealth(u) > 0).map((unit) => {
+      const id = str(unit.id);
+      const pos = movingPositions.get(id) ?? unitPosition(unit);
+      const unitTraits = Array.isArray(unit.traits) ? unit.traits : void 0;
       return {
-        id: unit.id,
+        id,
         position: pos,
-        name: unit.name,
-        team: unit.team,
-        health: unit.health,
-        maxHealth: unit.maxHealth,
-        unitType: unit.unitType,
-        heroId: unit.heroId,
-        sprite: unit.sprite,
-        traits: unit.traits?.map((t2) => ({
-          name: t2.name,
-          currentState: t2.currentState,
-          states: t2.states,
-          cooldown: t2.cooldown ?? 0
+        name: str(unit.name),
+        team: unitTeam(unit),
+        health: unitHealth(unit),
+        maxHealth: num(unit.maxHealth),
+        unitType: unit.unitType == null ? void 0 : str(unit.unitType),
+        heroId: unit.heroId == null ? void 0 : str(unit.heroId),
+        sprite: unit.sprite == null ? void 0 : str(unit.sprite),
+        traits: unitTraits?.map((tr) => ({
+          name: tr.name,
+          currentState: tr.currentState,
+          states: tr.states,
+          cooldown: tr.cooldown ?? 0
         }))
       };
     });
@@ -16396,8 +16478,8 @@ function BattleBoard({
     [scale, baseOffsetX]
   );
   const checkGameEnd = useCallback(() => {
-    const pa = units.filter((u) => u.team === "player" && u.health > 0);
-    const ea = units.filter((u) => u.team === "enemy" && u.health > 0);
+    const pa = units.filter((u) => unitTeam(u) === "player" && unitHealth(u) > 0);
+    const ea = units.filter((u) => unitTeam(u) === "enemy" && unitHealth(u) > 0);
     if (pa.length === 0) {
       onGameEnd?.("defeat");
       if (gameEndEvent) {
@@ -16411,21 +16493,22 @@ function BattleBoard({
     }
   }, [units, onGameEnd, gameEndEvent, eventBus]);
   const handleUnitClick = useCallback((unitId) => {
-    const unit = units.find((u) => u.id === unitId);
+    const unit = units.find((u) => str(u.id) === unitId);
     if (!unit) return;
     if (unitClickEvent) {
       eventBus.emit(`UI:${unitClickEvent}`, { unitId });
     }
     if (currentPhase === "action" && selectedUnit) {
-      if (unit.team === "enemy" && attackTargets.some((t2) => t2.x === unit.position.x && t2.y === unit.position.y)) {
-        const damage = calculateDamage ? calculateDamage(selectedUnit, unit) : Math.max(1, selectedUnit.attack - unit.defense);
+      const up = unitPosition(unit);
+      if (unitTeam(unit) === "enemy" && attackTargets.some((t2) => t2.x === up.x && t2.y === up.y)) {
+        const damage = calculateDamage ? calculateDamage(selectedUnit, unit) : Math.max(1, num(selectedUnit.attack) - num(unit.defense));
         setIsShaking(true);
         setTimeout(() => setIsShaking(false), 300);
         onAttack?.(selectedUnit, unit, damage);
         if (attackEvent) {
           eventBus.emit(`UI:${attackEvent}`, {
-            attackerId: selectedUnit.id,
-            targetId: unit.id,
+            attackerId: str(selectedUnit.id),
+            targetId: str(unit.id),
             damage
           });
         }
@@ -16440,9 +16523,9 @@ function BattleBoard({
     if (currentPhase === "movement" && selectedUnit) {
       if (movementAnimRef.current) return;
       if (validMoves.some((m) => m.x === x && m.y === y)) {
-        const from = { ...selectedUnit.position };
+        const from = { ...unitPosition(selectedUnit) };
         const to = { x, y };
-        startMoveAnimation(selectedUnit.id, from, to, () => {
+        startMoveAnimation(str(selectedUnit.id), from, to, () => {
           onUnitMove?.(selectedUnit, to);
         });
       }
@@ -16600,6 +16683,7 @@ var init_BattleBoard = __esm({
     init_Typography();
     init_Stack();
     init_IsometricCanvas2();
+    init_boardEntity();
     init_isometric();
     BattleBoard.displayName = "BattleBoard";
   }
@@ -16993,24 +17077,24 @@ var init_CodeBlock = __esm({
             return;
           }
           lineEls.forEach((el) => {
-            const num = parseInt(el.getAttribute("data-line") ?? "-1", 10);
-            if (hiddenLines.has(num)) {
+            const num2 = parseInt(el.getAttribute("data-line") ?? "-1", 10);
+            if (hiddenLines.has(num2)) {
               el.style.display = "none";
               return;
             }
             el.style.display = "";
             el.style.position = "relative";
             el.style.paddingLeft = "1.2em";
-            const region = foldStartMap.get(num);
+            const region = foldStartMap.get(num2);
             if (!region) return;
-            const isCollapsed = collapsed.has(num);
+            const isCollapsed = collapsed.has(num2);
             const toggle = document.createElement("span");
             toggle.className = "fold-toggle";
             toggle.textContent = isCollapsed ? "\u25B6" : "\u25BC";
             toggle.style.cssText = "position:absolute;left:0;top:0;width:1.2em;text-align:center;cursor:pointer;color:#858585;font-size:10px;user-select:none;line-height:inherit;height:100%";
             toggle.addEventListener("click", (e) => {
               e.stopPropagation();
-              toggleFoldRef.current(num);
+              toggleFoldRef.current(num2);
             });
             el.insertBefore(toggle, el.firstChild);
             if (isCollapsed) {
@@ -19263,10 +19347,13 @@ var init_BookChapterView = __esm({
     init_cn();
     BookChapterView = ({
       chapter,
+      orbitalSchema,
       direction,
       className
     }) => {
       const { t: _t } = useTranslate();
+      const title = String(chapter.title ?? "");
+      const content = String(chapter.content ?? "");
       return /* @__PURE__ */ jsxs(
         VStack,
         {
@@ -19274,16 +19361,16 @@ var init_BookChapterView = __esm({
           className: cn("px-6 py-8 max-w-4xl mx-auto w-full", className),
           style: { direction },
           children: [
-            /* @__PURE__ */ jsx(Typography, { variant: "h1", className: "text-3xl font-bold", children: chapter.title }),
+            /* @__PURE__ */ jsx(Typography, { variant: "h1", className: "text-3xl font-bold", children: title }),
             /* @__PURE__ */ jsx(Divider, {}),
-            !!chapter.orbitalSchema && /* @__PURE__ */ jsx(ScaledDiagram, { children: /* @__PURE__ */ jsx(
+            !!orbitalSchema && /* @__PURE__ */ jsx(ScaledDiagram, { children: /* @__PURE__ */ jsx(
               JazariStateMachine,
               {
-                schema: chapter.orbitalSchema,
+                schema: orbitalSchema,
                 direction
               }
             ) }),
-            /* @__PURE__ */ jsx(ContentRenderer, { content: chapter.content, direction })
+            /* @__PURE__ */ jsx(ContentRenderer, { content, direction })
           ]
         }
       );
@@ -19381,7 +19468,7 @@ var init_BookNavBar = __esm({
     BookNavBar = ({
       currentPage,
       totalPages,
-      chapterTitle,
+      chapterTitle: chapterTitle2,
       direction,
       className
     }) => {
@@ -19422,12 +19509,12 @@ var init_BookNavBar = __esm({
               )
             ] }),
             /* @__PURE__ */ jsxs(Box, { className: "flex-1 mx-4 max-w-md", children: [
-              chapterTitle && /* @__PURE__ */ jsx(
+              chapterTitle2 && /* @__PURE__ */ jsx(
                 Typography,
                 {
                   variant: "caption",
                   className: "text-center block truncate text-muted-foreground",
-                  children: chapterTitle
+                  children: chapterTitle2
                 }
               ),
               /* @__PURE__ */ jsx(ProgressBar, { value: progress, size: "sm", variant: "primary" })
@@ -19494,31 +19581,35 @@ var init_BookTableOfContents = __esm({
           style: { direction },
           children: [
             /* @__PURE__ */ jsx(Typography, { variant: "h1", className: "text-3xl font-bold text-center mb-4", children: t("book.tableOfContents") }),
-            parts.map((part, partIdx) => /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-              /* @__PURE__ */ jsxs(HStack, { gap: "sm", align: "center", children: [
-                /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", children: t("book.partNumber", { number: String(partIdx + 1) }) }),
-                /* @__PURE__ */ jsx(Typography, { variant: "h3", className: "font-semibold", children: part.title })
-              ] }),
-              /* @__PURE__ */ jsx(VStack, { gap: "xs", className: direction === "rtl" ? "pr-6" : "pl-6", children: part.chapters.map((chapter) => {
-                const isCurrent = chapter.id === currentChapterId;
-                return /* @__PURE__ */ jsx(
-                  Button,
-                  {
-                    variant: "ghost",
-                    size: "sm",
-                    action: "BOOK_NAVIGATE",
-                    actionPayload: { chapterId: chapter.id },
-                    className: cn(
-                      "justify-start text-left w-full",
-                      direction === "rtl" && "text-right",
-                      isCurrent && "bg-blue-50 dark:bg-blue-950 text-blue-600 dark:text-blue-400"
-                    ),
-                    children: /* @__PURE__ */ jsx(Box, { className: "truncate", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: chapter.title }) })
-                  },
-                  chapter.id
-                );
-              }) })
-            ] }, partIdx))
+            parts.map((part, partIdx) => {
+              const chapters = Array.isArray(part.chapters) ? part.chapters : [];
+              return /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
+                /* @__PURE__ */ jsxs(HStack, { gap: "sm", align: "center", children: [
+                  /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", children: t("book.partNumber", { number: String(partIdx + 1) }) }),
+                  /* @__PURE__ */ jsx(Typography, { variant: "h3", className: "font-semibold", children: String(part.title ?? "") })
+                ] }),
+                /* @__PURE__ */ jsx(VStack, { gap: "xs", className: direction === "rtl" ? "pr-6" : "pl-6", children: chapters.map((chapter) => {
+                  const id = chapter.id == null ? "" : String(chapter.id);
+                  const isCurrent = id === currentChapterId;
+                  return /* @__PURE__ */ jsx(
+                    Button,
+                    {
+                      variant: "ghost",
+                      size: "sm",
+                      action: "BOOK_NAVIGATE",
+                      actionPayload: { chapterId: id },
+                      className: cn(
+                        "justify-start text-left w-full",
+                        direction === "rtl" && "text-right",
+                        isCurrent && "bg-blue-50 dark:bg-blue-950 text-blue-600 dark:text-blue-400"
+                      ),
+                      children: /* @__PURE__ */ jsx(Box, { className: "truncate", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: String(chapter.title ?? "") }) })
+                    },
+                    id
+                  );
+                }) })
+              ] }, partIdx);
+            })
           ]
         }
       );
@@ -19640,27 +19731,41 @@ function resolveFieldMap(fieldMap) {
 function get(obj, key) {
   return obj[key];
 }
+function asStr(v) {
+  return v == null ? "" : String(v);
+}
 function mapBookData(raw, fields = IDENTITY_BOOK_FIELDS) {
   const rawParts = get(raw, fields.parts) ?? [];
-  return {
-    title: get(raw, fields.title) ?? "",
-    subtitle: get(raw, fields.subtitle),
-    author: get(raw, fields.author),
-    coverImageUrl: get(raw, fields.coverImageUrl),
-    direction: get(raw, fields.direction) ?? void 0,
-    parts: rawParts.map((part) => {
-      const rawChapters = get(part, fields.chapters) ?? [];
-      return {
-        title: get(part, fields.partTitle) ?? "",
-        chapters: rawChapters.map((ch) => ({
-          id: get(ch, fields.chapterId) ?? "",
-          title: get(ch, fields.chapterTitle) ?? "",
-          content: get(ch, fields.chapterContent) ?? "",
-          orbitalSchema: get(ch, fields.chapterOrbitalSchema)
-        }))
-      };
-    })
+  const direction = get(raw, fields.direction) ?? "ltr";
+  const cover = {
+    title: asStr(get(raw, fields.title)),
+    subtitle: asStr(get(raw, fields.subtitle)),
+    author: asStr(get(raw, fields.author)),
+    coverImageUrl: asStr(get(raw, fields.coverImageUrl)),
+    direction
   };
+  const schemaByChapterId = {};
+  const chapters = [];
+  const parts = rawParts.map((part) => {
+    const rawChapters = get(part, fields.chapters) ?? [];
+    const chapterRows = rawChapters.map((ch) => {
+      const id = asStr(get(ch, fields.chapterId));
+      const schema = get(ch, fields.chapterOrbitalSchema);
+      if (schema) schemaByChapterId[id] = schema;
+      const row = {
+        id,
+        title: asStr(get(ch, fields.chapterTitle)),
+        content: asStr(get(ch, fields.chapterContent))
+      };
+      chapters.push(row);
+      return row;
+    });
+    return {
+      title: asStr(get(part, fields.partTitle)),
+      chapters: chapterRows
+    };
+  });
+  return { cover, direction, parts, chapters, schemaByChapterId };
 }
 var IDENTITY_BOOK_FIELDS, AR_BOOK_FIELDS, FIELD_MAP_REGISTRY;
 var init_types2 = __esm({
@@ -19698,10 +19803,7 @@ var init_types2 = __esm({
     };
   }
 });
-function flattenChapters(book) {
-  return book.parts.flatMap((part) => part.chapters);
-}
-var PRINT_STYLES, BookViewer;
+var chapterId, chapterTitle, PRINT_STYLES, BookViewer;
 var init_BookViewer = __esm({
   "components/marketing/organisms/book/BookViewer.tsx"() {
     init_Box();
@@ -19714,6 +19816,8 @@ var init_BookViewer = __esm({
     init_BookNavBar();
     init_EmptyState();
     init_types2();
+    chapterId = (ch) => ch?.id == null ? void 0 : String(ch.id);
+    chapterTitle = (ch) => ch?.title == null ? void 0 : String(ch.title);
     PRINT_STYLES = `
 @media print {
   .book-viewer-page {
@@ -19742,14 +19846,14 @@ var init_BookViewer = __esm({
         return mapBookData(raw, resolvedFieldMap);
       }, [entity, resolvedFieldMap]);
       const direction = book?.direction ?? "ltr";
-      const chapters = useMemo(() => book ? flattenChapters(book) : [], [book]);
+      const chapters = useMemo(() => book ? book.chapters : [], [book]);
       const totalPages = 2 + chapters.length;
       const navigateTo = useCallback(
         (page) => {
           const clamped = Math.max(0, Math.min(page, totalPages - 1));
           setCurrentPage(clamped);
-          const chapterId = clamped >= 2 ? chapters[clamped - 2]?.id : void 0;
-          eventBus.emit("UI:BOOK_PAGE_CHANGE", { pageIndex: clamped, chapterId });
+          const id = clamped >= 2 ? chapterId(chapters[clamped - 2]) : void 0;
+          eventBus.emit("UI:BOOK_PAGE_CHANGE", { pageIndex: clamped, chapterId: id });
         },
         [totalPages, chapters, eventBus]
       );
@@ -19761,8 +19865,8 @@ var init_BookViewer = __esm({
           eventBus.on("UI:BOOK_PAGE_NEXT", () => navigateTo(currentPage + 1)),
           eventBus.on("UI:BOOK_PRINT", () => window.print()),
           eventBus.on("UI:BOOK_NAVIGATE", (event) => {
-            const chapterId = event.payload?.chapterId;
-            const idx = chapters.findIndex((ch) => ch.id === chapterId);
+            const targetId = event.payload?.chapterId;
+            const idx = chapters.findIndex((ch) => chapterId(ch) === targetId);
             if (idx >= 0) navigateTo(idx + 2);
           })
         ];
@@ -19779,9 +19883,11 @@ var init_BookViewer = __esm({
           style.remove();
         };
       }, []);
-      const currentChapterId = currentPage >= 2 ? chapters[currentPage - 2]?.id : void 0;
-      const currentChapterTitle = currentPage >= 2 ? chapters[currentPage - 2]?.title : void 0;
+      const currentChapterId = currentPage >= 2 ? chapterId(chapters[currentPage - 2]) : void 0;
+      const currentChapterTitle = currentPage >= 2 ? chapterTitle(chapters[currentPage - 2]) : void 0;
       if (!book) return /* @__PURE__ */ jsx(EmptyState, { message: t("book.noData") });
+      const cover = book.cover;
+      const coverTitle = String(cover.title ?? "");
       return /* @__PURE__ */ jsxs(VStack, { className: cn("relative h-full overflow-hidden bg-background", className), children: [
         /* @__PURE__ */ jsxs(
           Box,
@@ -19793,10 +19899,10 @@ var init_BookViewer = __esm({
                 /* @__PURE__ */ jsx(
                   BookCoverPage,
                   {
-                    title: book.title,
-                    subtitle: book.subtitle,
-                    author: book.author,
-                    coverImageUrl: book.coverImageUrl,
+                    title: coverTitle,
+                    subtitle: String(cover.subtitle ?? "") || void 0,
+                    author: String(cover.author ?? "") || void 0,
+                    coverImageUrl: String(cover.coverImageUrl ?? "") || void 0,
                     direction
                   }
                 ),
@@ -19807,23 +19913,27 @@ var init_BookViewer = __esm({
                     direction
                   }
                 ),
-                chapters.map((chapter) => /* @__PURE__ */ jsx(
-                  BookChapterView,
-                  {
-                    chapter,
-                    direction
-                  },
-                  chapter.id
-                ))
+                chapters.map((chapter) => {
+                  const id = chapterId(chapter);
+                  return /* @__PURE__ */ jsx(
+                    BookChapterView,
+                    {
+                      chapter,
+                      orbitalSchema: id ? book.schemaByChapterId[id] : void 0,
+                      direction
+                    },
+                    id
+                  );
+                })
               ] }),
               /* @__PURE__ */ jsxs(Box, { className: "print:hidden", children: [
                 currentPage === 0 && /* @__PURE__ */ jsx(
                   BookCoverPage,
                   {
-                    title: book.title,
-                    subtitle: book.subtitle,
-                    author: book.author,
-                    coverImageUrl: book.coverImageUrl,
+                    title: coverTitle,
+                    subtitle: String(cover.subtitle ?? "") || void 0,
+                    author: String(cover.author ?? "") || void 0,
+                    coverImageUrl: String(cover.coverImageUrl ?? "") || void 0,
                     direction
                   }
                 ),
@@ -19839,6 +19949,7 @@ var init_BookViewer = __esm({
                   BookChapterView,
                   {
                     chapter: chapters[currentPage - 2],
+                    orbitalSchema: currentChapterId ? book.schemaByChapterId[currentChapterId] : void 0,
                     direction
                   }
                 )
@@ -19851,7 +19962,7 @@ var init_BookViewer = __esm({
           {
             currentPage,
             totalPages,
-            chapterTitle: currentPage === 0 ? book.title : currentPage === 1 ? t("book.tableOfContents") : currentChapterTitle,
+            chapterTitle: currentPage === 0 ? coverTitle : currentPage === 1 ? t("book.tableOfContents") : currentChapterTitle,
             direction
           }
         )
@@ -19949,7 +20060,7 @@ var init_Grid = __esm({
     };
     Grid = ({
       cols = 1,
-      rows,
+      rows: rows2,
       gap = "md",
       rowGap,
       colGap,
@@ -19961,7 +20072,7 @@ var init_Grid = __esm({
       children,
       as: Component = "div"
     }) => {
-      const mergedStyle = rows ? { gridTemplateRows: `repeat(${rows}, minmax(0, 1fr))`, ...style } : style;
+      const mergedStyle = rows2 ? { gridTemplateRows: `repeat(${rows2}, minmax(0, 1fr))`, ...style } : style;
       return React97__default.createElement(
         Component,
         {
@@ -20677,14 +20788,14 @@ function BuilderBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
   const [placements, setPlacements] = useState({});
   const [headerError, setHeaderError] = useState(false);
   const [submitted, setSubmitted] = useState(false);
   const [attempts, setAttempts] = useState(0);
   const [showHint, setShowHint] = useState(false);
-  const components = resolved?.components ?? [];
-  const slots = resolved?.slots ?? [];
+  const components = Array.isArray(resolved?.components) ? resolved.components : [];
+  const slots = Array.isArray(resolved?.slots) ? resolved.slots : [];
   const usedComponentIds = new Set(Object.values(placements));
   const availableComponents = components.filter((c) => !usedComponentIds.has(c.id));
   const [selectedComponent, setSelectedComponent] = useState(null);
@@ -20718,7 +20829,7 @@ function BuilderBoard({
   }, [slots, placements, attempts, completeEvent, emit]);
   const handleReset = () => {
     setSubmitted(false);
-    if (attempts >= 2 && resolved?.hint) {
+    if (attempts >= 2 && str(resolved?.hint)) {
       setShowHint(true);
     }
   };
@@ -20731,20 +20842,24 @@ function BuilderBoard({
   };
   const getComponentById = (id) => components.find((c) => c.id === id);
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
   return /* @__PURE__ */ jsx(
     Box,
     {
       className,
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: "p-4", children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.description })
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", children: str(resolved.description) })
         ] }) }),
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "bold", className: "uppercase tracking-wider text-muted-foreground", children: t("builder.components") }),
@@ -20804,9 +20919,9 @@ function BuilderBoard({
         ] }) }),
         submitted && /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", children: [
           /* @__PURE__ */ jsx(Icon, { icon: allCorrect ? CheckCircle : XCircle, size: "lg", className: allCorrect ? "text-success" : "text-error" }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? resolved.successMessage ?? t("builder.success") : resolved.failMessage ?? t("builder.incorrect") })
+          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? str(resolved.successMessage) || t("builder.success") : str(resolved.failMessage) || t("builder.incorrect") })
         ] }) }),
-        showHint && resolved.hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.hint }) }),
+        showHint && hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: hint }) }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", justify: "center", children: [
           !submitted ? /* @__PURE__ */ jsxs(Button, { variant: "primary", onClick: handleSubmit, disabled: !allPlaced, children: [
             /* @__PURE__ */ jsx(Icon, { icon: Wrench, size: "sm" }),
@@ -20825,6 +20940,7 @@ var init_BuilderBoard = __esm({
   "components/game/organisms/puzzles/builder/BuilderBoard.tsx"() {
     init_atoms2();
     init_useEventBus();
+    init_boardEntity();
     BuilderBoard.displayName = "BuilderBoard";
   }
 });
@@ -21162,21 +21278,24 @@ function CalendarGrid({
       eventBus.emit(`UI:${longPressEvent}`, { date: day.toISOString(), time, ...longPressPayload });
     }, 500);
   }, [longPressEvent, longPressPayload, eventBus]);
-  const renderEvent = (event) => /* @__PURE__ */ jsx(
-    Box,
-    {
-      rounded: "md",
-      padding: "xs",
-      border: true,
-      className: cn(
-        "cursor-pointer hover:shadow-sm transition-shadow text-xs truncate",
-        event.color ? event.color : "bg-blue-500/15 border-blue-500/30 text-blue-600"
-      ),
-      onClick: (e) => handleEventClick(event, e),
-      children: /* @__PURE__ */ jsx(Typography, { variant: "small", className: "truncate font-medium", children: event.title })
-    },
-    event.id
-  );
+  const renderEvent = (event) => {
+    const color = event.color;
+    return /* @__PURE__ */ jsx(
+      Box,
+      {
+        rounded: "md",
+        padding: "xs",
+        border: true,
+        className: cn(
+          "cursor-pointer hover:shadow-sm transition-shadow text-xs truncate",
+          color ? color : "bg-blue-500/15 border-blue-500/30 text-blue-600"
+        ),
+        onClick: (e) => handleEventClick(event, e),
+        children: /* @__PURE__ */ jsx(Typography, { variant: "small", className: "truncate font-medium", children: event.title })
+      },
+      event.id
+    );
+  };
   return /* @__PURE__ */ jsxs(
     Box,
     {
@@ -22840,7 +22959,6 @@ var init_CardGrid = __esm({
       alignItems = "stretch",
       className,
       children,
-      // EntityDisplayProps
       entity,
       isLoading = false,
       error = null,
@@ -23312,14 +23430,14 @@ var init_CaseStudyOrganism = __esm({
         /* @__PURE__ */ jsx(SimpleGrid, { cols: cols > 0 ? cols : 1, gap: "lg", children: items.map((study) => /* @__PURE__ */ jsx(
           CaseStudyCard,
           {
-            title: study.title,
-            description: study.description,
-            category: study.category,
-            categoryColor: study.categoryColor,
-            href: study.href,
-            linkLabel: study.linkLabel
+            title: String(study.title ?? ""),
+            description: String(study.description ?? ""),
+            category: String(study.category ?? ""),
+            categoryColor: study.categoryColor != null ? String(study.categoryColor) : void 0,
+            href: String(study.href ?? ""),
+            linkLabel: study.linkLabel != null ? String(study.linkLabel) : void 0
           },
-          study.id
+          String(study.id ?? "")
         )) })
       ] });
     };
@@ -23342,10 +23460,10 @@ function CastleBoard({
   className
 }) {
   const eventBus = useEventBus();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
-  const tiles = resolved?.tiles ?? [];
-  const features = resolved?.features ?? [];
-  const units = resolved?.units ?? [];
+  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 backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = useState(null);
@@ -23373,7 +23491,7 @@ function CastleBoard({
       onFeatureClick?.(feature);
       if (featureClickEvent) {
         eventBus.emit(`UI:${featureClickEvent}`, {
-          featureId: feature.id,
+          featureId: feature.id ?? "",
           featureType: feature.type,
           x: feature.x,
           y: feature.y
@@ -23441,6 +23559,7 @@ var init_CastleBoard = __esm({
     init_cn();
     init_useEventBus();
     init_IsometricCanvas2();
+    init_boardEntity();
     init_isometric();
     CastleBoard.displayName = "CastleBoard";
   }
@@ -24251,14 +24370,14 @@ function ClassifierBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
   const [assignments, setAssignments] = useState({});
   const [headerError, setHeaderError] = useState(false);
   const [submitted, setSubmitted] = useState(false);
   const [attempts, setAttempts] = useState(0);
   const [showHint, setShowHint] = useState(false);
-  const items = resolved?.items ?? [];
-  const categories = resolved?.categories ?? [];
+  const items = Array.isArray(resolved?.items) ? resolved.items : [];
+  const categories = Array.isArray(resolved?.categories) ? resolved.categories : [];
   const unassignedItems = items.filter((item) => !assignments[item.id]);
   const allAssigned = Object.keys(assignments).length === items.length;
   const results = submitted ? items.map((item) => ({
@@ -24290,7 +24409,7 @@ function ClassifierBoard({
   }, [items, assignments, attempts, completeEvent, emit]);
   const handleReset = () => {
     setSubmitted(false);
-    if (attempts >= 2 && resolved?.hint) {
+    if (attempts >= 2 && str(resolved?.hint)) {
       setShowHint(true);
     }
   };
@@ -24301,20 +24420,25 @@ function ClassifierBoard({
     setShowHint(false);
   };
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
+  const failMessage = str(resolved.failMessage);
   return /* @__PURE__ */ jsx(
     Box,
     {
       className,
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: "p-4", children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.description })
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", children: str(resolved.description) })
         ] }) }),
         unassignedItems.length > 0 && /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "bold", className: "uppercase tracking-wider text-muted-foreground", children: t("classifier.itemsToSort") }),
@@ -24366,10 +24490,10 @@ function ClassifierBoard({
         }) }),
         submitted && /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", children: [
           /* @__PURE__ */ jsx(Icon, { icon: allCorrect ? CheckCircle : XCircle, size: "lg", className: allCorrect ? "text-success" : "text-error" }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? resolved.successMessage ?? t("classifier.allCorrect") : `${correctCount}/${items.length} ${t("classifier.correct")}` }),
-          !allCorrect && resolved.failMessage && /* @__PURE__ */ jsx(Typography, { variant: "body", className: "text-muted-foreground", children: resolved.failMessage })
+          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? str(resolved.successMessage) || t("classifier.allCorrect") : `${correctCount}/${items.length} ${t("classifier.correct")}` }),
+          !allCorrect && failMessage && /* @__PURE__ */ jsx(Typography, { variant: "body", className: "text-muted-foreground", children: failMessage })
         ] }) }),
-        showHint && resolved.hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.hint }) }),
+        showHint && hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: hint }) }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", justify: "center", children: [
           !submitted ? /* @__PURE__ */ jsxs(Button, { variant: "primary", onClick: handleSubmit, disabled: !allAssigned, children: [
             /* @__PURE__ */ jsx(Icon, { icon: Send, size: "sm" }),
@@ -24388,6 +24512,7 @@ var init_ClassifierBoard = __esm({
   "components/game/organisms/puzzles/classifier/ClassifierBoard.tsx"() {
     init_atoms2();
     init_useEventBus();
+    init_boardEntity();
     ClassifierBoard.displayName = "ClassifierBoard";
   }
 });
@@ -30758,7 +30883,7 @@ function InventoryPanel({
   const slotArray = Array.from({ length: safeSlots }, (_, index) => {
     return safeItems[index] ?? null;
   });
-  const rows = Math.ceil(safeSlots / safeColumns);
+  const rows2 = Math.ceil(safeSlots / safeColumns);
   const handleSlotClick = useCallback((index) => {
     if (selectSlotEvent) eventBus.emit(`UI:${selectSlotEvent}`, { index });
     onSelectSlot?.(index);
@@ -30827,7 +30952,7 @@ function InventoryPanel({
         className: "grid gap-1 bg-[var(--color-card)] p-2 rounded-container border border-border",
         style: {
           gridTemplateColumns: `repeat(${safeColumns}, ${slotSize}px)`,
-          gridTemplateRows: `repeat(${rows}, ${slotSize}px)`
+          gridTemplateRows: `repeat(${rows2}, ${slotSize}px)`
         },
         children: slotArray.map((item, index) => /* @__PURE__ */ jsx(
           "button",
@@ -34791,11 +34916,11 @@ function LatticeSVG({
 }) {
   const paths = [];
   const cols = 5;
-  const rows = Math.ceil(h / (w / cols));
+  const rows2 = Math.ceil(h / (w / cols));
   const cellW = w / cols;
   const cellH = cellW;
   const bulge = cellW * 0.3;
-  for (let row = 0; row < rows; row++) {
+  for (let row = 0; row < rows2; row++) {
     for (let col = 0; col < cols; col++) {
       const cx = col * cellW + cellW / 2;
       const cy = row * cellH + cellH / 2;
@@ -35207,7 +35332,7 @@ var init_MatrixQuestion = __esm({
     };
     MatrixQuestion = ({
       title,
-      rows,
+      rows: rows2,
       columns = DEFAULT_MATRIX_COLUMNS,
       values,
       onChange,
@@ -35217,7 +35342,7 @@ var init_MatrixQuestion = __esm({
       className
     }) => {
       const styles = sizeStyles13[size];
-      const safeRows = rows ?? [];
+      const safeRows = rows2 ?? [];
       const safeValues = values ?? {};
       const eventBus = useEventBus();
       const handleChange = useCallback(
@@ -35845,7 +35970,8 @@ var init_PositionedCanvas = __esm({
           dragRef.current = null;
           setDraggingId(null);
           if (!wasDrag) {
-            const next = selectedId === item.id ? null : item.id;
+            const itemId = item.id;
+            const next = selectedId === itemId ? null : itemId;
             onSelect?.(next);
             if (selectEvent) {
               eventBus.emit(`UI:${selectEvent}`, { id: next });
@@ -35880,15 +36006,22 @@ var init_PositionedCanvas = __esm({
             style: { width, height },
             onClick: handleContainerClick,
             children: items.map((item) => {
+              const itemId = item.id;
+              const label = item.label;
+              const x = item.x;
+              const y = item.y;
+              const capacity = item.capacity;
+              const partySize = item.partySize;
+              const serverName = item.serverName;
               const status = item.status ?? "empty";
               const shape = item.shape ?? "round";
-              const isSelected = selectedId === item.id;
-              const isDragging = draggingId === item.id;
+              const isSelected = selectedId === itemId;
+              const isDragging = draggingId === itemId;
               const statusBadge = STATUS_BADGE[status];
               return /* @__PURE__ */ jsxs(
                 Box,
                 {
-                  "data-testid": `item-node-${item.id}`,
+                  "data-testid": `item-node-${itemId}`,
                   "data-status": status,
                   className: cn(
                     "absolute flex flex-col items-center justify-center gap-1 border-2 select-none",
@@ -35899,7 +36032,7 @@ var init_PositionedCanvas = __esm({
                     isSelected && "outline outline-2 outline-offset-2 outline-primary shadow-md",
                     isDragging && "shadow-lg z-10"
                   ),
-                  style: { left: item.x, top: item.y, touchAction: "none" },
+                  style: { left: x, top: y, touchAction: "none" },
                   onPointerDown: (e) => handlePointerDown(e, item),
                   onPointerMove: handlePointerMove,
                   onPointerUp: (e) => handlePointerUp(e, item),
@@ -35907,10 +36040,10 @@ var init_PositionedCanvas = __esm({
                   children: [
                     /* @__PURE__ */ jsxs(Box, { className: "flex items-center gap-1", children: [
                       getStatusIcon(status),
-                      /* @__PURE__ */ jsx(Typography, { variant: "body2", weight: "semibold", children: item.label })
+                      /* @__PURE__ */ jsx(Typography, { variant: "body2", weight: "semibold", children: label })
                     ] }),
-                    /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", children: item.partySize !== void 0 && status === "seated" ? `${item.partySize}/${item.capacity}` : `Cap ${item.capacity}` }),
-                    status === "seated" && item.serverName && /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", className: "truncate max-w-[80%]", children: item.serverName }),
+                    /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", children: partySize !== void 0 && status === "seated" ? `${partySize}/${capacity}` : `Cap ${capacity}` }),
+                    status === "seated" && serverName && /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", className: "truncate max-w-[80%]", children: serverName }),
                     isSelected && /* @__PURE__ */ jsx(
                       Badge,
                       {
@@ -35922,7 +36055,7 @@ var init_PositionedCanvas = __esm({
                     )
                   ]
                 },
-                item.id
+                itemId
               );
             })
           }
@@ -36694,9 +36827,10 @@ var init_RichBlockEditor = __esm({
 });
 function collectInitiallyCollapsed(nodes, acc) {
   for (const n of nodes) {
+    const replies = n.replies;
     if (n.collapsed) acc.add(n.id);
-    if (n.replies && n.replies.length > 0) {
-      collectInitiallyCollapsed(n.replies, acc);
+    if (replies && replies.length > 0) {
+      collectInitiallyCollapsed(replies, acc);
     }
   }
 }
@@ -36726,44 +36860,52 @@ var init_ReplyTree = __esm({
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const hasReplies = !!node.replies && node.replies.length > 0;
-      const isCollapsed = collapsedSet.has(node.id);
+      const nodeId = node.id;
+      const authorName = node.authorName;
+      const authorAvatarUrl = node.authorAvatarUrl;
+      const content = node.content;
+      const postedAt = node.postedAt;
+      const voteCount = node.voteCount;
+      const userVote = node.userVote;
+      const replies = node.replies;
+      const hasReplies = !!replies && replies.length > 0;
+      const isCollapsed = collapsedSet.has(nodeId);
       const atMaxDepth = depth >= maxDepth;
       const [replyOpen, setReplyOpen] = useState(false);
       const [draft, setDraft] = useState("");
       const handleVote = useCallback(
         (next) => {
-          onVote?.(node.id, next);
-          if (voteEvent) eventBus.emit(`UI:${voteEvent}`, { nodeId: node.id, vote: next });
+          onVote?.(nodeId, next);
+          if (voteEvent) eventBus.emit(`UI:${voteEvent}`, { nodeId, vote: next });
         },
-        [node.id, onVote, voteEvent, eventBus]
+        [nodeId, onVote, voteEvent, eventBus]
       );
       const handleReply = useCallback(() => {
-        onReply?.(node.id);
+        onReply?.(nodeId);
         setReplyOpen((open) => !open);
-      }, [node.id, onReply]);
+      }, [nodeId, onReply]);
       const handleSubmitReply = useCallback(() => {
-        const content = draft.trim();
-        if (!content) return;
-        if (replyEvent) eventBus.emit(`UI:${replyEvent}`, { parentNodeId: node.id, content });
+        const text = draft.trim();
+        if (!text) return;
+        if (replyEvent) eventBus.emit(`UI:${replyEvent}`, { parentNodeId: nodeId, content: text });
         setDraft("");
         setReplyOpen(false);
-      }, [node.id, draft, replyEvent, eventBus]);
+      }, [nodeId, draft, replyEvent, eventBus]);
       const handleCancelReply = useCallback(() => {
         setDraft("");
         setReplyOpen(false);
       }, []);
       const handleFlag = useCallback(() => {
-        onFlag?.(node.id);
-        if (flagEvent) eventBus.emit(`UI:${flagEvent}`, { nodeId: node.id });
-      }, [node.id, onFlag, flagEvent, eventBus]);
+        onFlag?.(nodeId);
+        if (flagEvent) eventBus.emit(`UI:${flagEvent}`, { nodeId });
+      }, [nodeId, onFlag, flagEvent, eventBus]);
       const handleContinue = useCallback(() => {
-        onContinueThread?.(node.id);
-        if (continueThreadEvent) eventBus.emit(`UI:${continueThreadEvent}`, { nodeId: node.id });
-      }, [node.id, onContinueThread, continueThreadEvent, eventBus]);
+        onContinueThread?.(nodeId);
+        if (continueThreadEvent) eventBus.emit(`UI:${continueThreadEvent}`, { nodeId });
+      }, [nodeId, onContinueThread, continueThreadEvent, eventBus]);
       const handleToggle = useCallback(() => {
-        toggleCollapse(node.id);
-      }, [node.id, toggleCollapse]);
+        toggleCollapse(nodeId);
+      }, [nodeId, toggleCollapse]);
       return /* @__PURE__ */ jsxs(Box, { className: "flex flex-row gap-2 items-stretch min-w-0", children: [
         /* @__PURE__ */ jsxs(Box, { className: "flex flex-col items-center flex-shrink-0 w-6", children: [
           hasReplies ? /* @__PURE__ */ jsx(
@@ -36795,25 +36937,25 @@ var init_ReplyTree = __esm({
             /* @__PURE__ */ jsx(
               Avatar,
               {
-                src: node.authorAvatarUrl,
-                name: node.authorName,
+                src: authorAvatarUrl,
+                name: authorName,
                 size: "sm"
               }
             ),
-            /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "semibold", children: node.authorName }),
-            /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", children: node.postedAt })
+            /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "semibold", children: authorName }),
+            /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", children: postedAt })
           ] }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", className: "whitespace-pre-wrap break-words", children: node.content }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", className: "whitespace-pre-wrap break-words", children: content }),
           showActions && /* @__PURE__ */ jsxs(Box, { className: "flex flex-row gap-2 items-center", children: [
             /* @__PURE__ */ jsx(
               VoteStack,
               {
-                count: node.voteCount ?? 0,
-                userVote: node.userVote ?? null,
+                count: voteCount ?? 0,
+                userVote: userVote ?? null,
                 onVote: handleVote,
                 size: "sm",
                 variant: "horizontal",
-                label: t("replyTree.voteOnReplyBy", { author: node.authorName })
+                label: t("replyTree.voteOnReplyBy", { author: authorName })
               }
             ),
             /* @__PURE__ */ jsx(
@@ -36823,7 +36965,7 @@ var init_ReplyTree = __esm({
                 size: "sm",
                 leftIcon: "message-square",
                 onClick: handleReply,
-                "aria-label": t("replyTree.replyTo", { author: node.authorName }),
+                "aria-label": t("replyTree.replyTo", { author: authorName }),
                 children: t("replyTree.reply")
               }
             ),
@@ -36834,7 +36976,7 @@ var init_ReplyTree = __esm({
                 size: "sm",
                 leftIcon: "flag",
                 onClick: handleFlag,
-                "aria-label": t("replyTree.flagReplyBy", { author: node.authorName }),
+                "aria-label": t("replyTree.flagReplyBy", { author: authorName }),
                 children: t("replyTree.flag")
               }
             )
@@ -36846,9 +36988,9 @@ var init_ReplyTree = __esm({
                 inputType: "textarea",
                 rows: 2,
                 value: draft,
-                placeholder: t("replyTree.replyToPlaceholder", { author: node.authorName }),
+                placeholder: t("replyTree.replyToPlaceholder", { author: authorName }),
                 onChange: (e) => setDraft(e.target.value),
-                "aria-label": t("replyTree.replyTo", { author: node.authorName })
+                "aria-label": t("replyTree.replyTo", { author: authorName })
               }
             ),
             /* @__PURE__ */ jsxs(Box, { className: "flex flex-row gap-2 items-center", children: [
@@ -36879,7 +37021,7 @@ var init_ReplyTree = __esm({
               ),
               children: t("replyTree.continueThread")
             }
-          ) : /* @__PURE__ */ jsx(Box, { className: "flex flex-col gap-2 mt-1", children: node.replies.map((child) => /* @__PURE__ */ jsx(
+          ) : /* @__PURE__ */ jsx(Box, { className: "flex flex-col gap-2 mt-1", children: replies.map((child) => /* @__PURE__ */ jsx(
             ReplyTreeNode,
             {
               node: child,
@@ -38790,8 +38932,8 @@ var init_WizardContainer = __esm({
           return void 0;
         if (typeof controlledStep === "number") return controlledStep;
         if (typeof controlledStep === "string") return parseInt(controlledStep, 10);
-        const num = Number(controlledStep);
-        return isNaN(num) ? void 0 : num;
+        const num2 = Number(controlledStep);
+        return isNaN(num2) ? void 0 : num2;
       })();
       const currentStep = normalizedControlledStep !== void 0 ? normalizedControlledStep : internalStep;
       const totalSteps = steps.length;
@@ -40496,7 +40638,7 @@ function DebuggerBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
   const [flaggedLines, setFlaggedLines] = useState(/* @__PURE__ */ new Set());
   const [headerError, setHeaderError] = useState(false);
   const [submitted, setSubmitted] = useState(false);
@@ -40514,7 +40656,7 @@ function DebuggerBoard({
       return next;
     });
   };
-  const lines = resolved?.lines ?? [];
+  const lines = Array.isArray(resolved?.lines) ? resolved.lines : [];
   const bugLines = lines.filter((l) => l.isBug);
   const correctFlags = lines.filter((l) => l.isBug && flaggedLines.has(l.id));
   const falseFlags = lines.filter((l) => !l.isBug && flaggedLines.has(l.id));
@@ -40529,7 +40671,7 @@ function DebuggerBoard({
   }, [correctFlags.length, bugLines.length, falseFlags.length, attempts, completeEvent, emit]);
   const handleReset = () => {
     setSubmitted(false);
-    if (attempts >= 2 && resolved?.hint) {
+    if (attempts >= 2 && str(resolved?.hint)) {
       setShowHint(true);
     }
   };
@@ -40540,24 +40682,28 @@ function DebuggerBoard({
     setShowHint(false);
   };
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
   return /* @__PURE__ */ jsx(
     Box,
     {
       className,
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: "p-4", children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", children: [
             /* @__PURE__ */ jsx(Icon, { icon: Bug, size: "sm" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: resolved.title })
+            /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: str(resolved.title) })
           ] }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.description }),
-          /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-muted-foreground", children: t("debugger.findBugs", { count: String(resolved.bugCount) }) })
+          /* @__PURE__ */ jsx(Typography, { variant: "body", children: str(resolved.description) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-muted-foreground", children: t("debugger.findBugs", { count: String(num(resolved.bugCount)) }) })
         ] }) }),
         /* @__PURE__ */ jsx(Card, { className: "p-0 overflow-hidden", children: /* @__PURE__ */ jsx(VStack, { gap: "none", children: lines.map((line, i) => {
           const isFlagged = flaggedLines.has(line.id);
@@ -40589,7 +40735,7 @@ function DebuggerBoard({
           );
         }) }) }),
         submitted && /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? resolved.successMessage ?? t("debugger.allFound") : `${correctFlags.length}/${bugLines.length} ${t("debugger.bugsFound")}` }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: allCorrect ? str(resolved.successMessage) || t("debugger.allFound") : `${correctFlags.length}/${bugLines.length} ${t("debugger.bugsFound")}` }),
           bugLines.map((line) => /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "start", children: [
             /* @__PURE__ */ jsx(
               Icon,
@@ -40605,7 +40751,7 @@ function DebuggerBoard({
             ] })
           ] }, line.id))
         ] }) }),
-        showHint && resolved.hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.hint }) }),
+        showHint && hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: hint }) }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", justify: "center", children: [
           !submitted ? /* @__PURE__ */ jsxs(Button, { variant: "primary", onClick: handleSubmit, disabled: flaggedLines.size === 0, children: [
             /* @__PURE__ */ jsx(Icon, { icon: Send, size: "sm" }),
@@ -40624,6 +40770,7 @@ var init_DebuggerBoard = __esm({
   "components/game/organisms/puzzles/debugger/DebuggerBoard.tsx"() {
     init_atoms2();
     init_useEventBus();
+    init_boardEntity();
     DebuggerBoard.displayName = "DebuggerBoard";
   }
 });
@@ -40661,7 +40808,7 @@ function getBadgeVariant(fieldName, value) {
   return "default";
 }
 function formatFieldLabel(fieldName) {
-  return fieldName.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase());
+  return fieldName.replace(/([A-Z])/g, " $1").replace(/^./, (str2) => str2.toUpperCase());
 }
 function formatFieldValue(value, fieldName) {
   if (typeof value === "number") {
@@ -40680,26 +40827,26 @@ function formatFieldValue(value, fieldName) {
 }
 function renderRichFieldValue(value, fieldName, fieldType) {
   if (value === void 0 || value === null) return "\u2014";
-  const str = String(value);
+  const str2 = String(value);
   switch (fieldType) {
     case "image":
     case "url": {
-      if (str.match(/\.(png|jpe?g|gif|svg|webp|avif)(\?|$)/i) || str.startsWith("data:image/")) {
+      if (str2.match(/\.(png|jpe?g|gif|svg|webp|avif)(\?|$)/i) || str2.startsWith("data:image/")) {
         return /* @__PURE__ */ jsx(Box, { className: "mt-1 max-w-full", children: /* @__PURE__ */ jsx(
           "img",
           {
-            src: str,
+            src: str2,
             alt: formatFieldLabel(fieldName),
             className: "max-w-full max-h-64 rounded-md object-contain",
             loading: "lazy"
           }
         ) });
       }
-      return str;
+      return str2;
     }
     case "markdown":
     case "richtext":
-      return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(Typography, { variant: "body", className: "break-words", children: str }), children: /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(Typography, { variant: "body", className: "break-words", children: str2 }), children: /* @__PURE__ */ jsx(
         Box,
         {
           className: "prose prose-sm max-w-none",
@@ -40717,11 +40864,11 @@ function renderRichFieldValue(value, fieldName, fieldType) {
             "--tw-prose-th-borders": "var(--color-border)",
             "--tw-prose-td-borders": "var(--color-border)"
           },
-          children: /* @__PURE__ */ jsx(ReactMarkdown2, { children: str })
+          children: /* @__PURE__ */ jsx(ReactMarkdown2, { children: str2 })
         }
       ) });
     case "code":
-      return /* @__PURE__ */ jsx(Box, { className: "mt-1 rounded-md bg-muted p-3 overflow-x-auto", children: /* @__PURE__ */ jsx("pre", { className: "text-sm font-mono whitespace-pre-wrap break-words m-0", children: /* @__PURE__ */ jsx("code", { children: str }) }) });
+      return /* @__PURE__ */ jsx(Box, { className: "mt-1 rounded-md bg-muted p-3 overflow-x-auto", children: /* @__PURE__ */ jsx("pre", { className: "text-sm font-mono whitespace-pre-wrap break-words m-0", children: /* @__PURE__ */ jsx("code", { children: str2 }) }) });
     case "html":
       return /* @__PURE__ */ jsx(
         Box,
@@ -40741,12 +40888,12 @@ function renderRichFieldValue(value, fieldName, fieldType) {
             "--tw-prose-th-borders": "var(--color-border)",
             "--tw-prose-td-borders": "var(--color-border)"
           },
-          children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: str })
+          children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: str2 })
         }
       );
     case "date":
     case "datetime": {
-      const d = new Date(str);
+      const d = new Date(str2);
       if (!isNaN(d.getTime())) {
         return d.toLocaleDateString(void 0, {
           year: "numeric",
@@ -40755,7 +40902,7 @@ function renderRichFieldValue(value, fieldName, fieldType) {
           ...fieldType === "datetime" ? { hour: "2-digit", minute: "2-digit" } : {}
         });
       }
-      return str;
+      return str2;
     }
     default:
       return formatFieldValue(value, fieldName);
@@ -41433,6 +41580,40 @@ var init_RuleEditor = __esm({
     RuleEditor.displayName = "RuleEditor";
   }
 });
+
+// components/game/organisms/puzzles/event-handler/puzzleObject.ts
+function objId(o) {
+  return o.id == null ? "" : String(o.id);
+}
+function objName(o) {
+  return o.name == null ? "" : String(o.name);
+}
+function objIcon(o) {
+  return o.icon == null ? "" : String(o.icon);
+}
+function objStates(o) {
+  return Array.isArray(o.states) ? o.states : [];
+}
+function objCurrentState(o) {
+  return o.currentState == null ? "" : String(o.currentState);
+}
+function objAvailableEvents(o) {
+  return Array.isArray(o.availableEvents) ? o.availableEvents : [];
+}
+function objAvailableActions(o) {
+  return Array.isArray(o.availableActions) ? o.availableActions : [];
+}
+function objRules(o) {
+  return Array.isArray(o.rules) ? o.rules : [];
+}
+function objMaxRules(o) {
+  const n = Number(o.maxRules);
+  return Number.isFinite(n) && n > 0 ? n : 3;
+}
+var init_puzzleObject = __esm({
+  "components/game/organisms/puzzles/event-handler/puzzleObject.ts"() {
+  }
+});
 function ObjectRulePanel({
   object,
   onRulesChange,
@@ -41440,55 +41621,63 @@ function ObjectRulePanel({
   className
 }) {
   const { t } = useTranslate();
-  const maxRules = object.maxRules || 3;
-  const canAdd = object.rules.length < maxRules;
+  const id = objId(object);
+  const name = objName(object);
+  const icon = objIcon(object);
+  const states = objStates(object);
+  const currentState = objCurrentState(object);
+  const availableEvents = objAvailableEvents(object);
+  const availableActions = objAvailableActions(object);
+  const rules = objRules(object);
+  const maxRules = objMaxRules(object);
+  const canAdd = rules.length < maxRules;
   const handleRuleChange = useCallback((index, updatedRule) => {
-    const newRules = [...object.rules];
+    const newRules = [...rules];
     newRules[index] = updatedRule;
-    onRulesChange(object.id, newRules);
-  }, [object.id, object.rules, onRulesChange]);
+    onRulesChange(id, newRules);
+  }, [id, rules, onRulesChange]);
   const handleRuleRemove = useCallback((index) => {
-    const newRules = object.rules.filter((_, i) => i !== index);
-    onRulesChange(object.id, newRules);
-  }, [object.id, object.rules, onRulesChange]);
+    const newRules = rules.filter((_, i) => i !== index);
+    onRulesChange(id, newRules);
+  }, [id, rules, onRulesChange]);
   const handleAddRule = useCallback(() => {
     if (!canAdd || disabled) return;
-    const firstEvent = object.availableEvents[0]?.value || "";
-    const firstAction = object.availableActions[0]?.value || "";
+    const firstEvent = availableEvents[0]?.value || "";
+    const firstAction = availableActions[0]?.value || "";
     const newRule = {
       id: `rule-${nextRuleId++}`,
       whenEvent: firstEvent,
       thenAction: firstAction
     };
-    onRulesChange(object.id, [...object.rules, newRule]);
-  }, [canAdd, disabled, object, onRulesChange]);
+    onRulesChange(id, [...rules, newRule]);
+  }, [canAdd, disabled, id, rules, availableEvents, availableActions, onRulesChange]);
   const machine = {
-    name: object.name,
-    states: object.states,
-    currentState: object.currentState,
-    transitions: object.rules.map((r2) => ({
-      from: object.currentState,
-      to: object.states.find((s) => s !== object.currentState) || object.currentState,
+    name,
+    states,
+    currentState,
+    transitions: rules.map((r2) => ({
+      from: currentState,
+      to: states.find((s) => s !== currentState) || currentState,
       event: r2.whenEvent
     }))
   };
   return /* @__PURE__ */ jsxs(VStack, { className: cn("p-4 rounded-lg bg-card border border-border", className), gap: "sm", children: [
     /* @__PURE__ */ jsxs(HStack, { className: "items-center", gap: "sm", children: [
-      /* @__PURE__ */ jsx(Typography, { variant: "h5", children: object.icon }),
+      /* @__PURE__ */ jsx(Typography, { variant: "h5", children: icon }),
       /* @__PURE__ */ jsxs(VStack, { gap: "none", children: [
-        /* @__PURE__ */ jsx(Typography, { variant: "body1", className: "text-foreground font-bold", children: object.name }),
-        /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-muted-foreground", children: t("eventHandler.state") + ": " + object.currentState })
+        /* @__PURE__ */ jsx(Typography, { variant: "body1", className: "text-foreground font-bold", children: name }),
+        /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-muted-foreground", children: t("eventHandler.state") + ": " + currentState })
       ] })
     ] }),
     /* @__PURE__ */ jsx(TraitStateViewer, { trait: machine, variant: "compact", size: "sm" }),
     /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
-      /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground font-medium", children: t("eventHandler.rules", { count: object.rules.length, max: maxRules }) + ":" }),
-      object.rules.map((rule, i) => /* @__PURE__ */ jsx(
+      /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground font-medium", children: t("eventHandler.rules", { count: rules.length, max: maxRules }) + ":" }),
+      rules.map((rule, i) => /* @__PURE__ */ jsx(
         RuleEditor,
         {
           rule,
-          availableEvents: object.availableEvents,
-          availableActions: object.availableActions,
+          availableEvents,
+          availableActions,
           onChange: (r2) => handleRuleChange(i, r2),
           onRemove: () => handleRuleRemove(i),
           disabled
@@ -41506,6 +41695,7 @@ var init_ObjectRulePanel = __esm({
     init_cn();
     init_TraitStateViewer();
     init_RuleEditor();
+    init_puzzleObject();
     nextRuleId = 1;
     ObjectRulePanel.displayName = "ObjectRulePanel";
   }
@@ -41572,11 +41762,11 @@ function EventHandlerBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
-  const entityObjects = resolved?.objects ?? [];
-  const [objects, setObjects] = useState(entityObjects);
+  const resolved = boardEntity(entity);
+  const entityObjects = rows(resolved?.objects);
+  const [objects, setObjects] = useState(() => [...entityObjects]);
   const [selectedObjectId, setSelectedObjectId] = useState(
-    entityObjects[0]?.id || null
+    entityObjects[0] ? objId(entityObjects[0]) : null
   );
   const [headerError, setHeaderError] = useState(false);
   const [playState, setPlayState] = useState("editing");
@@ -41587,10 +41777,10 @@ function EventHandlerBoard({
   useEffect(() => () => {
     if (timerRef.current) clearTimeout(timerRef.current);
   }, []);
-  const selectedObject = objects.find((o) => o.id === selectedObjectId) || null;
+  const selectedObject = objects.find((o) => objId(o) === selectedObjectId) || null;
   const handleRulesChange = useCallback((objectId, rules) => {
     setObjects((prev) => prev.map(
-      (o) => o.id === objectId ? { ...o, rules } : o
+      (o) => objId(o) === objectId ? { ...o, rules } : o
     ));
   }, []);
   const addLogEntry = useCallback((icon, message, status = "done") => {
@@ -41604,11 +41794,12 @@ function EventHandlerBoard({
     setEventLog([]);
     const allRules = [];
     objects.forEach((obj) => {
-      obj.rules.forEach((rule) => {
+      objRules(obj).forEach((rule) => {
         allRules.push({ object: obj, rule });
       });
     });
-    const triggers = resolved?.triggerEvents || [];
+    const triggers = Array.isArray(resolved?.triggerEvents) ? resolved.triggerEvents : [];
+    const goalEvent = str(resolved?.goalEvent);
     const eventQueue = [...triggers];
     const firedEvents = /* @__PURE__ */ new Set();
     let stepIdx = 0;
@@ -41637,14 +41828,14 @@ function EventHandlerBoard({
         addLogEntry("\u26A1", t("eventHandler.noListeners", { event: currentEvent }), "done");
       } else {
         matching.forEach(({ object, rule }) => {
-          addLogEntry(object.icon, t("eventHandler.heardEvent", { object: object.name, event: currentEvent, action: rule.thenAction }), "done");
+          addLogEntry(objIcon(object), t("eventHandler.heardEvent", { object: objName(object), event: currentEvent, action: rule.thenAction }), "done");
           eventQueue.push(rule.thenAction);
-          if (rule.thenAction === resolved?.goalEvent) {
+          if (rule.thenAction === goalEvent) {
             goalReached = true;
           }
         });
       }
-      if (currentEvent === resolved?.goalEvent) {
+      if (currentEvent === goalEvent) {
         goalReached = true;
       }
       stepIdx++;
@@ -41662,65 +41853,75 @@ function EventHandlerBoard({
   }, []);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
-    setObjects(resolved?.objects ?? []);
+    const resetObjects = rows(resolved?.objects);
+    setObjects([...resetObjects]);
     setPlayState("editing");
     setEventLog([]);
-    setSelectedObjectId((resolved?.objects ?? [])[0]?.id || null);
+    setSelectedObjectId(resetObjects[0] ? objId(resetObjects[0]) : null);
     setAttempts(0);
   }, [resolved?.objects]);
   if (!resolved) return null;
   const objectViewers = objects.map((obj) => {
+    const states = objStates(obj);
+    const currentState = objCurrentState(obj);
     const machine = {
-      name: obj.name,
-      states: obj.states,
-      currentState: obj.currentState,
-      transitions: obj.rules.map((r2) => ({
-        from: obj.currentState,
-        to: obj.states.find((s) => s !== obj.currentState) || obj.currentState,
+      name: objName(obj),
+      states,
+      currentState,
+      transitions: objRules(obj).map((r2) => ({
+        from: currentState,
+        to: states.find((s) => s !== currentState) || currentState,
         event: r2.whenEvent
       }))
     };
     return { obj, machine };
   });
-  const showHint = attempts >= 3 && resolved.hint;
+  const hint = str(resolved.hint);
+  const showHint = attempts >= 3 && hint;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
   const encourageKey = ENCOURAGEMENT_KEYS[Math.min(attempts - 1, ENCOURAGEMENT_KEYS.length - 1)] ?? ENCOURAGEMENT_KEYS[0];
   return /* @__PURE__ */ jsxs(
     VStack,
     {
       className: cn("p-4 gap-6", className),
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: resolved.description }),
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: str(resolved.description) }),
           /* @__PURE__ */ jsxs(HStack, { className: "items-center p-2 rounded bg-primary/10 border border-primary/30", gap: "xs", children: [
             /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-primary font-bold", children: t("game.goal") + ":" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground", children: resolved.goalCondition })
+            /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground", children: str(resolved.goalCondition) })
           ] })
         ] }),
         /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground font-medium", children: t("eventHandler.clickObject") + ":" }),
-          /* @__PURE__ */ jsx(HStack, { className: "flex-wrap", gap: "sm", children: objectViewers.map(({ obj, machine }) => /* @__PURE__ */ jsx(
-            Box,
-            {
-              className: cn(
-                "p-3 rounded-container border-2 cursor-pointer transition-all hover:scale-105",
-                selectedObjectId === obj.id ? "border-primary bg-primary/10" : "border-border bg-card hover:border-muted-foreground"
-              ),
-              onClick: () => setSelectedObjectId(obj.id),
-              children: /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "items-center min-w-[120px]", children: [
-                /* @__PURE__ */ jsx(Typography, { variant: "h5", children: obj.icon }),
-                /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground font-medium", children: obj.name }),
-                /* @__PURE__ */ jsx(TraitStateViewer, { trait: machine, variant: "compact", size: "sm" })
-              ] })
-            },
-            obj.id
-          )) })
+          /* @__PURE__ */ jsx(HStack, { className: "flex-wrap", gap: "sm", children: objectViewers.map(({ obj, machine }) => {
+            const oid = objId(obj);
+            return /* @__PURE__ */ jsx(
+              Box,
+              {
+                className: cn(
+                  "p-3 rounded-container border-2 cursor-pointer transition-all hover:scale-105",
+                  selectedObjectId === oid ? "border-primary bg-primary/10" : "border-border bg-card hover:border-muted-foreground"
+                ),
+                onClick: () => setSelectedObjectId(oid),
+                children: /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "items-center min-w-[120px]", children: [
+                  /* @__PURE__ */ jsx(Typography, { variant: "h5", children: objIcon(obj) }),
+                  /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground font-medium", children: objName(obj) }),
+                  /* @__PURE__ */ jsx(TraitStateViewer, { trait: machine, variant: "compact", size: "sm" })
+                ] })
+              },
+              oid
+            );
+          }) })
         ] }),
         selectedObject && /* @__PURE__ */ jsx(
           ObjectRulePanel,
@@ -41731,12 +41932,12 @@ function EventHandlerBoard({
           }
         ),
         eventLog.length > 0 && /* @__PURE__ */ jsx(EventLog, { entries: eventLog }),
-        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: resolved.successMessage || t("eventHandler.chainComplete") }) }),
+        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: str(resolved.successMessage) || t("eventHandler.chainComplete") }) }),
         playState === "fail" && /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-warning/10 border border-warning/30 text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "body1", className: "text-foreground font-medium", children: t(encourageKey) }) }),
           showHint && /* @__PURE__ */ jsx(Box, { className: "p-3 rounded-container bg-accent/10 border border-accent/30", children: /* @__PURE__ */ jsxs(HStack, { className: "items-start", gap: "xs", children: [
             /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-accent font-bold shrink-0", children: "\u{1F4A1} " + t("game.hint") + ":" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: resolved.hint })
+            /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: hint })
           ] }) })
         ] }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", children: [
@@ -41764,6 +41965,8 @@ var init_EventHandlerBoard = __esm({
     init_TraitStateViewer();
     init_ObjectRulePanel();
     init_EventLog();
+    init_puzzleObject();
+    init_boardEntity();
     ENCOURAGEMENT_KEYS = [
       "puzzle.tryAgain1",
       "puzzle.tryAgain2",
@@ -41852,7 +42055,10 @@ var init_FeatureGridOrganism = __esm({
       );
       useCallback(
         (feature) => {
-          eventBus.emit("UI:FEATURE_CLICK", { id: feature.id, href: feature.href ?? "" });
+          eventBus.emit("UI:FEATURE_CLICK", {
+            id: String(feature.id ?? ""),
+            href: String(feature.href ?? "")
+          });
         },
         [eventBus]
       );
@@ -41862,14 +42068,17 @@ var init_FeatureGridOrganism = __esm({
       if (error) {
         return /* @__PURE__ */ jsx(ErrorState, { message: error.message, className });
       }
-      const featureCards = items.map((feature) => ({
-        icon: feature.icon,
-        title: feature.title,
-        description: feature.description,
-        href: feature.href,
-        linkLabel: feature.linkLabel,
-        variant: feature.href ? "interactive" : "bordered"
-      }));
+      const featureCards = items.map((feature) => {
+        const href = feature.href != null ? String(feature.href) : void 0;
+        return {
+          icon: feature.icon != null ? String(feature.icon) : void 0,
+          title: String(feature.title ?? ""),
+          description: String(feature.description ?? ""),
+          href,
+          linkLabel: feature.linkLabel != null ? String(feature.linkLabel) : void 0,
+          variant: href ? "interactive" : "bordered"
+        };
+      });
       return /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: cn("w-full", className), children: [
         (heading || subtitle) && /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", className: "w-full", children: [
           heading && /* @__PURE__ */ jsx(Typography, { variant: "h2", align: "center", children: heading }),
@@ -43187,22 +43396,24 @@ var init_HeroOrganism = __esm({
         () => Array.isArray(entity) ? entity[0] : entity && typeof entity === "object" ? entity : void 0,
         [entity]
       );
+      const primaryAction = resolved?.primaryAction;
+      const secondaryAction = resolved?.secondaryAction;
       const handlePrimaryClick = useCallback(() => {
-        if (resolved?.primaryAction) {
+        if (primaryAction) {
           eventBus.emit("UI:CTA_PRIMARY", {
-            label: resolved.primaryAction.label,
-            href: resolved.primaryAction.href
+            label: String(primaryAction.label ?? ""),
+            href: String(primaryAction.href ?? "")
           });
         }
-      }, [eventBus, resolved]);
+      }, [eventBus, primaryAction]);
       const handleSecondaryClick = useCallback(() => {
-        if (resolved?.secondaryAction) {
+        if (secondaryAction) {
           eventBus.emit("UI:CTA_SECONDARY", {
-            label: resolved.secondaryAction.label,
-            href: resolved.secondaryAction.href
+            label: String(secondaryAction.label ?? ""),
+            href: String(secondaryAction.href ?? "")
           });
         }
-      }, [eventBus, resolved]);
+      }, [eventBus, secondaryAction]);
       if (isLoading) {
         return /* @__PURE__ */ jsx(LoadingState, { message: t("common.loading"), className });
       }
@@ -43212,17 +43423,19 @@ var init_HeroOrganism = __esm({
       if (!resolved) {
         return null;
       }
+      const imageRaw = resolved.image;
+      const image = imageRaw ? { src: String(imageRaw.src ?? ""), alt: String(imageRaw.alt ?? "") } : void 0;
       return /* @__PURE__ */ jsxs(
         HeroSection,
         {
-          tag: resolved.tag,
-          title: resolved.title,
-          titleAccent: resolved.titleAccent,
-          subtitle: resolved.subtitle,
-          primaryAction: resolved.primaryAction ? { label: resolved.primaryAction.label, href: resolved.primaryAction.href } : void 0,
-          secondaryAction: resolved.secondaryAction ? { label: resolved.secondaryAction.label, href: resolved.secondaryAction.href } : void 0,
-          installCommand: resolved.installCommand,
-          image: resolved.image,
+          tag: resolved.tag != null ? String(resolved.tag) : void 0,
+          title: String(resolved.title ?? ""),
+          titleAccent: resolved.titleAccent != null ? String(resolved.titleAccent) : void 0,
+          subtitle: String(resolved.subtitle ?? ""),
+          primaryAction: primaryAction ? { label: String(primaryAction.label ?? ""), href: String(primaryAction.href ?? "") } : void 0,
+          secondaryAction: secondaryAction ? { label: String(secondaryAction.label ?? ""), href: String(secondaryAction.href ?? "") } : void 0,
+          installCommand: resolved.installCommand != null ? String(resolved.installCommand) : void 0,
+          image,
           imagePosition: resolved.imagePosition,
           background: resolved.background,
           className: cn(className),
@@ -43231,8 +43444,8 @@ var init_HeroOrganism = __esm({
             /* @__PURE__ */ jsx(
               _HeroClickInterceptor,
               {
-                hasPrimary: !!resolved.primaryAction,
-                hasSecondary: !!resolved.secondaryAction,
+                hasPrimary: !!primaryAction,
+                hasSecondary: !!secondaryAction,
                 onPrimaryClick: handlePrimaryClick,
                 onSecondaryClick: handleSecondaryClick
               }
@@ -43461,7 +43674,7 @@ function formatValue3(value, fieldName) {
   return String(value);
 }
 function formatFieldLabel2(fieldName) {
-  return fieldName.replace(/([A-Z])/g, " $1").replace(/^./, (str) => str.toUpperCase()).replace(/Id$/, "").trim();
+  return fieldName.replace(/([A-Z])/g, " $1").replace(/^./, (str2) => str2.toUpperCase()).replace(/Id$/, "").trim();
 }
 var STATUS_STYLES2, StatusBadge, ProgressIndicator, List3;
 var init_List = __esm({
@@ -44308,20 +44521,22 @@ function NegotiatorBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
   const [history, setHistory] = useState([]);
   const [headerError, setHeaderError] = useState(false);
   const [showHint, setShowHint] = useState(false);
+  const totalRounds = num(resolved?.totalRounds);
+  const targetScore = num(resolved?.targetScore);
   const currentRound = history.length;
-  const isComplete = currentRound >= (resolved?.totalRounds ?? 0);
+  const isComplete = currentRound >= totalRounds;
   const playerTotal = history.reduce((s, r2) => s + r2.playerPayoff, 0);
   const opponentTotal = history.reduce((s, r2) => s + r2.opponentPayoff, 0);
-  const won = isComplete && playerTotal >= (resolved?.targetScore ?? 0);
-  const actions = resolved?.actions ?? [];
-  const payoffMatrix = resolved?.payoffMatrix ?? [];
+  const won = isComplete && playerTotal >= targetScore;
+  const actions = Array.isArray(resolved?.actions) ? resolved.actions : [];
+  const payoffMatrix = Array.isArray(resolved?.payoffMatrix) ? resolved.payoffMatrix : [];
   const handleAction = useCallback((actionId) => {
     if (isComplete) return;
-    const opponentAction = getOpponentAction(resolved?.opponentStrategy ?? "random", actions, history);
+    const opponentAction = getOpponentAction(str(resolved?.opponentStrategy) || "random", actions, history);
     const payoff = payoffMatrix.find(
       (p2) => p2.playerAction === actionId && p2.opponentAction === opponentAction
     );
@@ -44334,42 +44549,46 @@ function NegotiatorBoard({
     };
     const newHistory = [...history, result];
     setHistory(newHistory);
-    if (newHistory.length >= (resolved?.totalRounds ?? 0)) {
+    if (newHistory.length >= totalRounds) {
       const total = newHistory.reduce((s, r2) => s + r2.playerPayoff, 0);
-      if (total >= (resolved?.targetScore ?? 0)) {
+      if (total >= targetScore) {
         emit(`UI:${completeEvent}`, { success: true, score: total });
       }
-      if (newHistory.length >= 3 && resolved?.hint) {
+      if (newHistory.length >= 3 && str(resolved?.hint)) {
         setShowHint(true);
       }
     }
-  }, [isComplete, resolved, actions, payoffMatrix, history, currentRound, completeEvent, emit]);
+  }, [isComplete, resolved, totalRounds, targetScore, actions, payoffMatrix, history, currentRound, completeEvent, emit]);
   const handleReset = () => {
     setHistory([]);
     setShowHint(false);
   };
   const getActionLabel = (id) => actions.find((a) => a.id === id)?.label ?? id;
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
   return /* @__PURE__ */ jsx(
     Box,
     {
       className,
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: "p-4", children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.description }),
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", children: str(resolved.description) }),
           /* @__PURE__ */ jsxs(HStack, { gap: "md", children: [
-            /* @__PURE__ */ jsx(Badge, { size: "sm", children: t("negotiator.round", { current: String(currentRound), total: String(resolved.totalRounds) }) }),
+            /* @__PURE__ */ jsx(Badge, { size: "sm", children: t("negotiator.round", { current: String(currentRound), total: String(totalRounds) }) }),
             /* @__PURE__ */ jsxs(Badge, { size: "sm", children: [
               t("negotiator.target"),
               ": ",
-              resolved.targetScore
+              targetScore
             ] })
           ] })
         ] }) }),
@@ -44418,16 +44637,16 @@ function NegotiatorBoard({
         ] }) }),
         isComplete && /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", children: [
           /* @__PURE__ */ jsx(Icon, { icon: CheckCircle, size: "lg", className: won ? "text-success" : "text-error" }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: won ? resolved.successMessage ?? t("negotiator.success") : resolved.failMessage ?? t("negotiator.failed") }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", weight: "bold", children: won ? str(resolved.successMessage) || t("negotiator.success") : str(resolved.failMessage) || t("negotiator.failed") }),
           /* @__PURE__ */ jsxs(Typography, { variant: "caption", className: "text-muted-foreground", children: [
             t("negotiator.finalScore"),
             ": ",
             playerTotal,
             "/",
-            resolved.targetScore
+            targetScore
           ] })
         ] }) }),
-        showHint && resolved.hint && !won && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.hint }) }),
+        showHint && hint && !won && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: hint }) }),
         isComplete && !won && /* @__PURE__ */ jsx(HStack, { justify: "center", children: /* @__PURE__ */ jsx(Button, { variant: "primary", onClick: handleReset, children: t("negotiator.playAgain") }) })
       ] })
     }
@@ -44437,6 +44656,7 @@ var init_NegotiatorBoard = __esm({
   "components/game/organisms/puzzles/negotiator/NegotiatorBoard.tsx"() {
     init_atoms2();
     init_useEventBus();
+    init_boardEntity();
     NegotiatorBoard.displayName = "NegotiatorBoard";
   }
 });
@@ -44472,13 +44692,13 @@ var init_PricingOrganism = __esm({
         return /* @__PURE__ */ jsx(ErrorState, { message: error.message, className });
       }
       const plans = items.map((plan) => ({
-        name: plan.name,
-        price: plan.price,
-        description: plan.description,
-        features: plan.features,
-        action: { label: plan.actionLabel, href: plan.actionHref },
-        highlighted: plan.highlighted,
-        badge: plan.badge
+        name: String(plan.name ?? ""),
+        price: String(plan.price ?? ""),
+        description: plan.description != null ? String(plan.description) : void 0,
+        features: (plan.features ?? []).map((f3) => String(f3)),
+        action: { label: String(plan.actionLabel ?? ""), href: String(plan.actionHref ?? "") },
+        highlighted: Boolean(plan.highlighted),
+        badge: plan.badge != null ? String(plan.badge) : void 0
       }));
       return /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: cn("w-full", className), children: [
         (heading || subtitle) && /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", className: "w-full", children: [
@@ -46568,16 +46788,20 @@ function SequencerBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
+  const maxSlots = num(resolved?.maxSlots);
+  const solutions = Array.isArray(resolved?.solutions) ? resolved.solutions : [];
+  const availableActions = Array.isArray(resolved?.availableActions) ? resolved.availableActions : [];
+  const allowDuplicates = resolved?.allowDuplicates !== false;
   const [headerError, setHeaderError] = useState(false);
   const [slots, setSlots] = useState(
-    () => Array.from({ length: resolved?.maxSlots ?? 0 }, () => void 0)
+    () => Array.from({ length: maxSlots }, () => void 0)
   );
   const [playState, setPlayState] = useState("idle");
   const [currentStep, setCurrentStep] = useState(-1);
   const [attempts, setAttempts] = useState(0);
   const [slotFeedback, setSlotFeedback] = useState(
-    () => Array.from({ length: resolved?.maxSlots ?? 0 }, () => null)
+    () => Array.from({ length: maxSlots }, () => null)
   );
   const timerRef = useRef(null);
   useEffect(() => () => {
@@ -46611,17 +46835,17 @@ function SequencerBoard({
   }, [emit]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
-    setSlots(Array.from({ length: resolved?.maxSlots ?? 0 }, () => void 0));
+    setSlots(Array.from({ length: maxSlots }, () => void 0));
     setPlayState("idle");
     setCurrentStep(-1);
     setAttempts(0);
-    setSlotFeedback(Array.from({ length: resolved?.maxSlots ?? 0 }, () => null));
-  }, [resolved?.maxSlots]);
+    setSlotFeedback(Array.from({ length: maxSlots }, () => null));
+  }, [maxSlots]);
   const filledSlots = slots.filter((s) => !!s);
   const canPlay = filledSlots.length > 0 && playState === "idle";
   const handlePlay = useCallback(() => {
     if (!canPlay) return;
-    setSlotFeedback(Array.from({ length: resolved?.maxSlots ?? 0 }, () => null));
+    setSlotFeedback(Array.from({ length: maxSlots }, () => null));
     emit("UI:PLAY_SOUND", { key: "confirm" });
     const sequence = slots.map((s) => s?.id || "");
     if (playEvent) {
@@ -46632,10 +46856,10 @@ function SequencerBoard({
     let step = 0;
     const advance = () => {
       step++;
-      if (step >= (resolved?.maxSlots ?? 0)) {
+      if (step >= maxSlots) {
         const playerSeq = slots.map((s) => s?.id);
         const playerIds = slots.filter(Boolean).map((s) => s?.id || "");
-        const success = (resolved?.solutions ?? []).some(
+        const success = solutions.some(
           (sol) => sol.length === playerIds.length && sol.every((id, i) => id === playerIds[i])
         );
         if (success) {
@@ -46647,7 +46871,7 @@ function SequencerBoard({
           }
         } else {
           setAttempts((prev) => prev + 1);
-          const feedback = computeSlotFeedback(playerSeq, resolved?.solutions ?? []);
+          const feedback = computeSlotFeedback(playerSeq, solutions);
           setSlotFeedback(feedback);
           setPlayState("idle");
           setCurrentStep(-1);
@@ -46665,10 +46889,10 @@ function SequencerBoard({
       }
     };
     timerRef.current = setTimeout(advance, stepDurationMs);
-  }, [canPlay, slots, resolved?.maxSlots, resolved?.solutions, stepDurationMs, playEvent, completeEvent, emit]);
+  }, [canPlay, slots, maxSlots, solutions, stepDurationMs, playEvent, completeEvent, emit]);
   const machine = {
-    name: resolved?.title ?? "",
-    description: resolved?.description ?? "",
+    name: str(resolved?.title),
+    description: str(resolved?.description),
     states: slots.map((s, i) => stepLabel(s, i)),
     currentState: currentStep >= 0 ? stepLabel(slots[currentStep], currentStep) : "__idle__",
     transitions: slots.slice(0, -1).map((s, i) => ({
@@ -46677,37 +46901,41 @@ function SequencerBoard({
       event: "NEXT"
     }))
   };
-  const usedIds = resolved?.allowDuplicates === false ? slots.filter(Boolean).map((s) => s?.id || "") : [];
-  const showHint = attempts >= 3 && !!resolved?.hint;
+  const usedIds = !allowDuplicates ? slots.filter(Boolean).map((s) => s?.id || "") : [];
+  const hint = str(resolved?.hint);
+  const showHint = attempts >= 3 && !!hint;
   const hasFeedback = slotFeedback.some((f3) => f3 !== null);
   const correctCount = slotFeedback.filter((f3) => f3 === "correct").length;
   const encourageKey = ENCOURAGEMENT_KEYS2[Math.min(attempts - 1, ENCOURAGEMENT_KEYS2.length - 1)] ?? ENCOURAGEMENT_KEYS2[0];
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
   return /* @__PURE__ */ jsxs(
     VStack,
     {
       className: cn("p-4 gap-6", className),
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: resolved.description })
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: str(resolved.description) })
         ] }),
         showHint && /* @__PURE__ */ jsx(Box, { className: "p-3 rounded-container bg-accent/10 border border-accent/30", children: /* @__PURE__ */ jsxs(HStack, { className: "items-start", gap: "xs", children: [
           /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-accent font-bold shrink-0", children: "\u{1F4A1} " + t("game.hint") + ":" }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: resolved.hint })
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: hint })
         ] }) }),
         filledSlots.length > 0 && /* @__PURE__ */ jsx(TraitStateViewer, { trait: machine, variant: "linear", size: "md" }),
         /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
           /* @__PURE__ */ jsxs(HStack, { className: "items-center justify-between", children: [
             /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground font-medium", children: t("sequencer.yourSequence") + ":" }),
             hasFeedback && playState === "idle" && /* @__PURE__ */ jsxs(Typography, { variant: "caption", className: "text-muted-foreground", children: [
-              `${correctCount}/${resolved.maxSlots} `,
+              `${correctCount}/${maxSlots} `,
               "\u2705"
             ] })
           ] }),
@@ -46715,7 +46943,7 @@ function SequencerBoard({
             SequenceBar,
             {
               slots,
-              maxSlots: resolved.maxSlots,
+              maxSlots,
               onSlotDrop: handleSlotDrop,
               onSlotRemove: handleSlotRemove,
               playing: playState === "playing",
@@ -46729,15 +46957,15 @@ function SequencerBoard({
         playState !== "playing" && /* @__PURE__ */ jsx(
           ActionPalette,
           {
-            actions: resolved.availableActions,
+            actions: availableActions,
             usedActionIds: usedIds,
-            allowDuplicates: resolved.allowDuplicates !== false,
+            allowDuplicates,
             categoryColors,
             label: t("sequencer.dragActions")
           }
         ),
         hasFeedback && playState === "idle" && attempts > 0 && /* @__PURE__ */ jsx(Box, { className: "p-3 rounded-container bg-warning/10 border border-warning/30 text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: t(encourageKey) }) }),
-        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: resolved.successMessage || t("sequencer.levelComplete") }) }),
+        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: str(resolved.successMessage) || t("sequencer.levelComplete") }) }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(
             Button,
@@ -46761,6 +46989,7 @@ var init_SequencerBoard = __esm({
     init_cn();
     init_useEventBus();
     init_TraitStateViewer();
+    init_boardEntity();
     init_SequenceBar();
     init_ActionPalette();
     ENCOURAGEMENT_KEYS2 = [
@@ -46810,18 +47039,21 @@ var init_ShowcaseOrganism = __esm({
           heading && /* @__PURE__ */ jsx(Typography, { variant: "h2", align: "center", children: heading }),
           subtitle && /* @__PURE__ */ jsx(Typography, { variant: "body1", color: "muted", align: "center", className: "max-w-2xl", children: subtitle })
         ] }),
-        /* @__PURE__ */ jsx(SimpleGrid, { cols: columns, gap: "lg", children: items.map((item) => /* @__PURE__ */ jsx(
-          ShowcaseCard,
-          {
-            title: item.title,
-            description: item.description,
-            image: item.image,
-            href: item.href,
-            badge: item.badge,
-            accentColor: item.accentColor
-          },
-          item.id
-        )) })
+        /* @__PURE__ */ jsx(SimpleGrid, { cols: columns, gap: "lg", children: items.map((item) => {
+          const imageRaw = item.image;
+          return /* @__PURE__ */ jsx(
+            ShowcaseCard,
+            {
+              title: String(item.title ?? ""),
+              description: item.description != null ? String(item.description) : void 0,
+              image: { src: String(imageRaw?.src ?? ""), alt: String(imageRaw?.alt ?? "") },
+              href: item.href != null ? String(item.href) : void 0,
+              badge: item.badge != null ? String(item.badge) : void 0,
+              accentColor: item.accentColor != null ? String(item.accentColor) : void 0
+            },
+            String(item.id ?? "")
+          );
+        }) })
       ] });
     };
     ShowcaseOrganism.displayName = "ShowcaseOrganism";
@@ -47189,8 +47421,8 @@ function SimulatorBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
-  const parameters = resolved?.parameters ?? [];
+  const resolved = boardEntity(entity);
+  const parameters = Array.isArray(resolved?.parameters) ? resolved.parameters : [];
   const [values, setValues] = useState(() => {
     const init = {};
     for (const p2 of parameters) {
@@ -47204,15 +47436,15 @@ function SimulatorBoard({
   const [showHint, setShowHint] = useState(false);
   const computeOutput = useCallback((params) => {
     try {
-      const fn = new Function("params", `return (${resolved?.computeExpression})`);
+      const fn = new Function("params", `return (${str(resolved?.computeExpression)})`);
       return fn(params);
     } catch {
       return 0;
     }
   }, [resolved?.computeExpression]);
   const output = useMemo(() => computeOutput(values) ?? 0, [computeOutput, values]);
-  const targetValue = resolved?.targetValue ?? 0;
-  const targetTolerance = resolved?.targetTolerance ?? 0;
+  const targetValue = num(resolved?.targetValue);
+  const targetTolerance = num(resolved?.targetTolerance);
   const isCorrect = Math.abs(output - targetValue) <= targetTolerance;
   const handleParameterChange = (id, value) => {
     if (submitted) return;
@@ -47227,7 +47459,7 @@ function SimulatorBoard({
   };
   const handleReset = () => {
     setSubmitted(false);
-    if (attempts >= 2 && resolved?.hint) {
+    if (attempts >= 2 && str(resolved?.hint)) {
       setShowHint(true);
     }
   };
@@ -47242,20 +47474,26 @@ function SimulatorBoard({
     setShowHint(false);
   };
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
+  const outputLabel = str(resolved.outputLabel);
+  const outputUnit = str(resolved.outputUnit);
   return /* @__PURE__ */ jsx(
     Box,
     {
       className,
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: "p-4", children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.description })
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", weight: "bold", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body", children: str(resolved.description) })
         ] }) }),
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "md", children: [
           /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "bold", className: "uppercase tracking-wider text-muted-foreground", children: t("simulator.parameters") }),
@@ -47296,28 +47534,28 @@ function SimulatorBoard({
           ] }, param.id))
         ] }) }),
         /* @__PURE__ */ jsx(Card, { className: "p-4", children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "bold", className: "uppercase tracking-wider text-muted-foreground", children: resolved.outputLabel }),
+          /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "bold", className: "uppercase tracking-wider text-muted-foreground", children: outputLabel }),
           /* @__PURE__ */ jsxs(Typography, { variant: "h3", weight: "bold", children: [
             output.toFixed(2),
             " ",
-            resolved.outputUnit
+            outputUnit
           ] }),
           submitted && /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", children: [
             /* @__PURE__ */ jsx(Icon, { icon: isCorrect ? CheckCircle : XCircle, size: "sm", className: isCorrect ? "text-success" : "text-error" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "body", className: isCorrect ? "text-success" : "text-error", children: isCorrect ? resolved.successMessage ?? t("simulator.correct") : resolved.failMessage ?? t("simulator.incorrect") })
+            /* @__PURE__ */ jsx(Typography, { variant: "body", className: isCorrect ? "text-success" : "text-error", children: isCorrect ? str(resolved.successMessage) || t("simulator.correct") : str(resolved.failMessage) || t("simulator.incorrect") })
           ] }),
           /* @__PURE__ */ jsxs(Typography, { variant: "caption", className: "text-muted-foreground", children: [
             t("simulator.target"),
             ": ",
             targetValue,
             " ",
-            resolved.outputUnit,
+            outputUnit,
             " (\xB1",
             targetTolerance,
             ")"
           ] })
         ] }) }),
-        showHint && resolved.hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: resolved.hint }) }),
+        showHint && hint && /* @__PURE__ */ jsx(Card, { className: "p-4 border-l-4 border-l-warning", children: /* @__PURE__ */ jsx(Typography, { variant: "body", children: hint }) }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", justify: "center", children: [
           !submitted ? /* @__PURE__ */ jsxs(Button, { variant: "primary", onClick: handleSubmit, children: [
             /* @__PURE__ */ jsx(Icon, { icon: Play, size: "sm" }),
@@ -47336,6 +47574,7 @@ var init_SimulatorBoard = __esm({
   "components/game/organisms/puzzles/simulator/SimulatorBoard.tsx"() {
     init_atoms2();
     init_useEventBus();
+    init_boardEntity();
     SimulatorBoard.displayName = "SimulatorBoard";
   }
 });
@@ -47761,22 +48000,25 @@ function VariablePanel({
   return /* @__PURE__ */ jsxs(VStack, { className: cn("p-3 rounded-lg bg-card border border-border", className), gap: "sm", children: [
     /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground font-medium", children: t("stateArchitect.variables", { name: entityName }) }),
     variables.map((v) => {
-      const max = v.max ?? 100;
-      const min = v.min ?? 0;
-      const pct = Math.round((v.value - min) / (max - min) * 100);
+      const name = v.name == null ? "" : String(v.name);
+      const value = numField(v.value);
+      const max = numField(v.max, 100);
+      const min = numField(v.min, 0);
+      const unit = v.unit == null ? "" : String(v.unit);
+      const pct = Math.round((value - min) / (max - min) * 100);
       const isHigh = pct > 80;
       const isLow = pct < 20;
       return /* @__PURE__ */ jsxs(VStack, { gap: "none", children: [
         /* @__PURE__ */ jsxs(HStack, { className: "items-center justify-between", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground font-medium", children: v.name }),
+          /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground font-medium", children: name }),
           /* @__PURE__ */ jsxs(Typography, { variant: "caption", className: cn(
             isHigh ? "text-error" : isLow ? "text-warning" : "text-foreground"
           ), children: [
-            v.value,
-            v.unit || "",
+            value,
+            unit,
             " / ",
             max,
-            v.unit || ""
+            unit
           ] })
         ] }),
         /* @__PURE__ */ jsx(
@@ -47787,14 +48029,19 @@ function VariablePanel({
             size: "sm"
           }
         )
-      ] }, v.name);
+      ] }, name);
     })
   ] });
 }
+var numField;
 var init_VariablePanel = __esm({
   "components/game/organisms/puzzles/state-architect/VariablePanel.tsx"() {
     init_atoms2();
     init_cn();
+    numField = (v, fallback = 0) => {
+      const n = Number(v);
+      return Number.isFinite(n) ? n : fallback;
+    };
     VariablePanel.displayName = "VariablePanel";
   }
 });
@@ -47821,14 +48068,21 @@ function StateArchitectBoard({
 }) {
   const { emit } = useEventBus();
   const { t } = useTranslate();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
-  const [transitions, setTransitions] = useState(resolved?.transitions ?? []);
+  const resolved = boardEntity(entity);
+  const entityStates = Array.isArray(resolved?.states) ? resolved.states : [];
+  const initialState = str(resolved?.initialState);
+  const entityName = str(resolved?.entityName);
+  const availableEvents = Array.isArray(resolved?.availableEvents) ? resolved.availableEvents : [];
+  const testCases = Array.isArray(resolved?.testCases) ? resolved.testCases : [];
+  const entityTransitions = Array.isArray(resolved?.transitions) ? resolved.transitions : [];
+  const entityVariables = rows(resolved?.variables);
+  const [transitions, setTransitions] = useState(entityTransitions);
   const [headerError, setHeaderError] = useState(false);
   const [playState, setPlayState] = useState("editing");
-  const [currentState, setCurrentState] = useState(resolved?.initialState ?? "");
+  const [currentState, setCurrentState] = useState(initialState);
   const [selectedState, setSelectedState] = useState(null);
   const [testResults, setTestResults] = useState([]);
-  const [variables, setVariables] = useState(resolved?.variables ?? []);
+  const [variables, setVariables] = useState(() => [...entityVariables]);
   const [attempts, setAttempts] = useState(0);
   const timerRef = useRef(null);
   const [addingFrom, setAddingFrom] = useState(null);
@@ -47837,12 +48091,12 @@ function StateArchitectBoard({
   }, []);
   const GRAPH_W = 500;
   const GRAPH_H = 400;
-  const positions = useMemo(() => layoutStates(resolved?.states ?? [], GRAPH_W, GRAPH_H), [resolved?.states]);
+  const positions = useMemo(() => layoutStates(entityStates, GRAPH_W, GRAPH_H), [entityStates]);
   const handleStateClick = useCallback((state) => {
     if (playState !== "editing") return;
     if (addingFrom) {
       if (addingFrom !== state) {
-        const event = resolved?.availableEvents[0] || "EVENT";
+        const event = availableEvents[0] || "EVENT";
         const newTrans = {
           id: `t-${nextTransId++}`,
           from: addingFrom,
@@ -47855,7 +48109,7 @@ function StateArchitectBoard({
     } else {
       setSelectedState(state);
     }
-  }, [playState, addingFrom, resolved?.availableEvents]);
+  }, [playState, addingFrom, availableEvents]);
   const handleStartAddTransition = useCallback(() => {
     if (!selectedState) return;
     setAddingFrom(selectedState);
@@ -47864,9 +48118,9 @@ function StateArchitectBoard({
     setTransitions((prev) => prev.filter((t2) => t2.id !== transId));
   }, []);
   const machine = useMemo(() => ({
-    name: resolved?.entityName ?? "",
-    description: resolved?.description ?? "",
-    states: resolved?.states ?? [],
+    name: entityName,
+    description: str(resolved?.description),
+    states: entityStates,
     currentState,
     transitions: transitions.map((t2) => ({
       from: t2.from,
@@ -47874,7 +48128,7 @@ function StateArchitectBoard({
       event: t2.event,
       guardHint: t2.guardHint
     }))
-  }), [resolved, currentState, transitions]);
+  }), [entityName, resolved, entityStates, currentState, transitions]);
   const handleTest = useCallback(() => {
     if (playState !== "editing") return;
     if (testEvent) emit(`UI:${testEvent}`, {});
@@ -47883,7 +48137,7 @@ function StateArchitectBoard({
     const results = [];
     let testIdx = 0;
     const runNextTest = () => {
-      if (testIdx >= (resolved?.testCases.length ?? 0)) {
+      if (testIdx >= testCases.length) {
         const allPassed = results.every((r2) => r2.passed);
         setPlayState(allPassed ? "success" : "fail");
         setTestResults(results);
@@ -47898,9 +48152,9 @@ function StateArchitectBoard({
         }
         return;
       }
-      const testCase = resolved?.testCases[testIdx];
+      const testCase = testCases[testIdx];
       if (!testCase) return;
-      let state = resolved.initialState;
+      let state = initialState;
       for (const event of testCase.events) {
         const trans = transitions.find((t2) => t2.from === state && t2.event === event);
         if (trans) {
@@ -47918,53 +48172,57 @@ function StateArchitectBoard({
       timerRef.current = setTimeout(runNextTest, stepDurationMs);
     };
     timerRef.current = setTimeout(runNextTest, stepDurationMs);
-  }, [playState, transitions, resolved, stepDurationMs, testEvent, completeEvent, emit]);
+  }, [playState, transitions, testCases, initialState, stepDurationMs, testEvent, completeEvent, emit]);
   const handleTryAgain = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
     setPlayState("editing");
-    setCurrentState(resolved?.initialState ?? "");
+    setCurrentState(initialState);
     setTestResults([]);
-  }, [resolved?.initialState]);
+  }, [initialState]);
   const handleReset = useCallback(() => {
     if (timerRef.current) clearTimeout(timerRef.current);
-    setTransitions(resolved?.transitions ?? []);
+    setTransitions(entityTransitions);
     setPlayState("editing");
-    setCurrentState(resolved?.initialState ?? "");
+    setCurrentState(initialState);
     setTestResults([]);
-    setVariables(resolved?.variables ?? []);
+    setVariables([...entityVariables]);
     setSelectedState(null);
     setAddingFrom(null);
     setAttempts(0);
-  }, [resolved]);
+  }, [entityTransitions, initialState, entityVariables]);
   const codeData = useMemo(() => ({
-    name: resolved?.entityName ?? "",
-    states: resolved?.states ?? [],
-    initialState: resolved?.initialState ?? "",
+    name: entityName,
+    states: entityStates,
+    initialState,
     transitions: transitions.map((t2) => ({
       from: t2.from,
       to: t2.to,
       event: t2.event,
       ...t2.guardHint ? { guard: t2.guardHint } : {}
     }))
-  }), [resolved, transitions]);
+  }), [entityName, entityStates, initialState, transitions]);
   if (!resolved) return null;
+  const theme = resolved.theme ?? void 0;
+  const themeBackground = theme?.background;
+  const headerImage = str(resolved.headerImage);
+  const hint = str(resolved.hint);
   return /* @__PURE__ */ jsxs(
     VStack,
     {
       className: cn("p-4 gap-6", className),
       style: {
-        backgroundImage: resolved.theme?.background ? `url(${resolved.theme.background})` : void 0,
+        backgroundImage: themeBackground ? `url(${themeBackground})` : void 0,
         backgroundSize: "cover",
         backgroundPosition: "center"
       },
       children: [
-        resolved.headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: resolved.headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : resolved.headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
+        headerImage && !headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 overflow-hidden rounded-container", children: /* @__PURE__ */ jsx("img", { src: headerImage, alt: "", onError: () => setHeaderError(true), className: "w-full h-full object-cover" }) }) : headerImage && headerError ? /* @__PURE__ */ jsx(Box, { className: "w-full h-32 rounded-container bg-gradient-to-br from-muted to-accent opacity-60" }) : null,
         /* @__PURE__ */ jsxs(VStack, { gap: "xs", children: [
-          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: resolved.title }),
-          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: resolved.description }),
+          /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-foreground", children: str(resolved.title) }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-muted-foreground", children: str(resolved.description) }),
           /* @__PURE__ */ jsxs(HStack, { className: "items-center p-2 rounded bg-warning/10 border border-warning/30", gap: "xs", children: [
             /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-warning font-bold", children: t("game.hint") + ":" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground", children: resolved.hint })
+            /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "text-foreground", children: hint })
           ] })
         ] }),
         /* @__PURE__ */ jsxs(HStack, { className: "flex-wrap items-start", gap: "lg", children: [
@@ -48012,14 +48270,14 @@ function StateArchitectBoard({
                       ]
                     }
                   ),
-                  resolved.states.map((state) => /* @__PURE__ */ jsx(
+                  entityStates.map((state) => /* @__PURE__ */ jsx(
                     StateNode2,
                     {
                       name: state,
                       position: positions[state],
                       isCurrent: state === currentState,
                       isSelected: state === selectedState,
-                      isInitial: state === resolved.initialState,
+                      isInitial: state === initialState,
                       onClick: () => handleStateClick(state)
                     },
                     state
@@ -48066,7 +48324,7 @@ function StateArchitectBoard({
             /* @__PURE__ */ jsx(
               VariablePanel,
               {
-                entityName: resolved.entityName,
+                entityName,
                 variables
               }
             ),
@@ -48081,12 +48339,12 @@ function StateArchitectBoard({
             resolved.showCodeView !== false && /* @__PURE__ */ jsx(CodeView, { data: codeData, label: "View Code" })
           ] })
         ] }),
-        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: resolved.successMessage || t("stateArchitect.allPassed") }) }),
+        playState === "success" && /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-success/20 border border-success text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "h5", className: "text-success", children: str(resolved.successMessage) || t("stateArchitect.allPassed") }) }),
         playState === "fail" && /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
           /* @__PURE__ */ jsx(Box, { className: "p-4 rounded-container bg-warning/10 border border-warning/30 text-center", children: /* @__PURE__ */ jsx(Typography, { variant: "body1", className: "text-foreground font-medium", children: t(ENCOURAGEMENT_KEYS3[Math.min(attempts - 1, ENCOURAGEMENT_KEYS3.length - 1)] ?? ENCOURAGEMENT_KEYS3[0]) }) }),
-          attempts >= 3 && resolved.hint && /* @__PURE__ */ jsx(Box, { className: "p-3 rounded-container bg-accent/10 border border-accent/30", children: /* @__PURE__ */ jsxs(HStack, { className: "items-start", gap: "xs", children: [
+          attempts >= 3 && hint && /* @__PURE__ */ jsx(Box, { className: "p-3 rounded-container bg-accent/10 border border-accent/30", children: /* @__PURE__ */ jsxs(HStack, { className: "items-start", gap: "xs", children: [
             /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-accent font-bold shrink-0", children: "\u{1F4A1} " + t("game.hint") + ":" }),
-            /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: resolved.hint })
+            /* @__PURE__ */ jsx(Typography, { variant: "body2", className: "text-foreground", children: hint })
           ] }) })
         ] }),
         /* @__PURE__ */ jsxs(HStack, { gap: "sm", children: [
@@ -48116,6 +48374,7 @@ var init_StateArchitectBoard = __esm({
     init_TransitionArrow();
     init_VariablePanel();
     init_CodeView();
+    init_boardEntity();
     ENCOURAGEMENT_KEYS3 = [
       "puzzle.tryAgain1",
       "puzzle.tryAgain2",
@@ -48152,8 +48411,8 @@ var init_StatsOrganism = __esm({
         return /* @__PURE__ */ jsx(ErrorState, { message: error.message, className });
       }
       const stats = items.map((item) => ({
-        value: item.value,
-        label: item.label
+        value: String(item.value ?? ""),
+        label: String(item.label ?? "")
       }));
       return /* @__PURE__ */ jsx(
         StatsGrid,
@@ -48199,10 +48458,10 @@ var init_StepFlowOrganism = __esm({
         return /* @__PURE__ */ jsx(ErrorState, { message: error.message, className });
       }
       const steps = items.map((item) => ({
-        number: item.number,
-        title: item.title,
-        description: item.description,
-        icon: item.icon
+        number: item.number != null ? Number(item.number) : void 0,
+        title: String(item.title ?? ""),
+        description: String(item.description ?? ""),
+        icon: item.icon != null ? String(item.icon) : void 0
       }));
       return /* @__PURE__ */ jsxs(VStack, { gap: "lg", className: cn("w-full", className), children: [
         (heading || subtitle) && /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", className: "w-full", children: [
@@ -48375,13 +48634,13 @@ var init_TeamOrganism = __esm({
         /* @__PURE__ */ jsx(SimpleGrid, { cols: cols > 0 ? cols : 1, gap: "lg", children: items.map((member) => /* @__PURE__ */ jsx(
           TeamCard,
           {
-            name: member.name,
-            nameAr: member.nameAr,
-            role: member.role,
-            bio: member.bio,
-            avatar: member.avatar
+            name: String(member.name ?? ""),
+            nameAr: member.nameAr != null ? String(member.nameAr) : void 0,
+            role: String(member.role ?? ""),
+            bio: String(member.bio ?? ""),
+            avatar: member.avatar != null ? String(member.avatar) : void 0
           },
-          member.id
+          String(member.id ?? "")
         )) })
       ] });
     };
@@ -48618,8 +48877,8 @@ function useBattleState(initialUnits, eventConfig = {}, callbacks = {}) {
   const [turn, setTurn] = useState(1);
   const [gameResult, setGameResult] = useState(null);
   const checkGameEnd = useCallback((currentUnits) => {
-    const pa = currentUnits.filter((u) => u.team === "player" && u.health > 0);
-    const ea = currentUnits.filter((u) => u.team === "enemy" && u.health > 0);
+    const pa = currentUnits.filter((u) => unitTeam(u) === "player" && unitHealth(u) > 0);
+    const ea = currentUnits.filter((u) => unitTeam(u) === "enemy" && unitHealth(u) > 0);
     if (pa.length === 0) {
       setGameResult("defeat");
       setPhase("game_over");
@@ -48637,34 +48896,36 @@ function useBattleState(initialUnits, eventConfig = {}, callbacks = {}) {
     }
   }, [onGameEnd, gameEndEvent, eventBus]);
   const handleUnitClick = useCallback((unitId) => {
-    const unit = units.find((u) => u.id === unitId);
+    const unit = units.find((u) => str(u.id) === unitId);
     if (!unit) return;
     if (unitClickEvent) {
       eventBus.emit(`UI:${unitClickEvent}`, { unitId });
     }
     if (phase === "observation" || phase === "selection") {
-      if (unit.team === "player") {
+      if (unitTeam(unit) === "player") {
         setSelectedUnitId(unitId);
         setPhase("movement");
       }
     } else if (phase === "action") {
-      const selectedUnit = units.find((u) => u.id === selectedUnitId);
+      const selectedUnit = units.find((u) => str(u.id) === selectedUnitId);
       if (!selectedUnit) return;
-      if (unit.team === "enemy") {
-        const dx = Math.abs(unit.position.x - selectedUnit.position.x);
-        const dy = Math.abs(unit.position.y - selectedUnit.position.y);
+      if (unitTeam(unit) === "enemy") {
+        const up = unitPosition(unit);
+        const sp = unitPosition(selectedUnit);
+        const dx = Math.abs(up.x - sp.x);
+        const dy = Math.abs(up.y - sp.y);
         if (dx <= 1 && dy <= 1 && dx + dy > 0) {
-          const damage = calculateDamage ? calculateDamage(selectedUnit, unit) : Math.max(1, selectedUnit.attack - unit.defense);
-          const newHealth = Math.max(0, unit.health - damage);
+          const damage = calculateDamage ? calculateDamage(selectedUnit, unit) : Math.max(1, num(selectedUnit.attack) - num(unit.defense));
+          const newHealth = Math.max(0, unitHealth(unit) - damage);
           const updatedUnits = units.map(
-            (u) => u.id === unit.id ? { ...u, health: newHealth } : u
+            (u) => str(u.id) === str(unit.id) ? { ...u, health: newHealth } : u
           );
           setUnits(updatedUnits);
           onAttack?.(selectedUnit, unit, damage);
           if (attackEvent) {
             eventBus.emit(`UI:${attackEvent}`, {
-              attackerId: selectedUnit.id,
-              targetId: unit.id,
+              attackerId: str(selectedUnit.id),
+              targetId: str(unit.id),
               damage
             });
           }
@@ -48681,16 +48942,20 @@ function useBattleState(initialUnits, eventConfig = {}, callbacks = {}) {
       eventBus.emit(`UI:${tileClickEvent}`, { x, y });
     }
     if (phase === "movement" && selectedUnitId) {
-      const selectedUnit = units.find((u) => u.id === selectedUnitId);
+      const selectedUnit = units.find((u) => str(u.id) === selectedUnitId);
       if (!selectedUnit) return;
-      const dx = Math.abs(x - selectedUnit.position.x);
-      const dy = Math.abs(y - selectedUnit.position.y);
+      const sp = unitPosition(selectedUnit);
+      const dx = Math.abs(x - sp.x);
+      const dy = Math.abs(y - sp.y);
       const dist = dx + dy;
-      if (dist > 0 && dist <= selectedUnit.movement) {
-        if (!units.some((u) => u.position.x === x && u.position.y === y && u.health > 0)) {
+      if (dist > 0 && dist <= num(selectedUnit.movement)) {
+        if (!units.some((u) => {
+          const p2 = unitPosition(u);
+          return p2.x === x && p2.y === y && unitHealth(u) > 0;
+        })) {
           setUnits(
             (prev) => prev.map(
-              (u) => u.id === selectedUnitId ? { ...u, position: { x, y } } : u
+              (u) => str(u.id) === selectedUnitId ? { ...u, position: { x, y } } : u
             )
           );
           setPhase("action");
@@ -48733,12 +48998,13 @@ var init_useBattleState = __esm({
   "components/game/organisms/hooks/useBattleState.ts"() {
     "use client";
     init_useEventBus();
+    init_boardEntity();
   }
 });
 function UncontrolledBattleBoard({ entity, ...rest }) {
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
+  const resolved = boardEntity(entity);
   const battleState = useBattleState(
-    resolved?.initialUnits ?? [],
+    rows(resolved?.initialUnits),
     {
       tileClickEvent: rest.tileClickEvent,
       unitClickEvent: rest.unitClickEvent,
@@ -48774,10 +49040,23 @@ function UncontrolledBattleBoard({ entity, ...rest }) {
 var init_UncontrolledBattleBoard = __esm({
   "components/game/organisms/UncontrolledBattleBoard.tsx"() {
     init_BattleBoard();
+    init_boardEntity();
     init_useBattleState();
     UncontrolledBattleBoard.displayName = "UncontrolledBattleBoard";
   }
 });
+function heroPosition(h) {
+  return vec2(h.position);
+}
+function heroOwner(h) {
+  return str(h.owner);
+}
+function heroMovement(h) {
+  return num(h.movement);
+}
+function hexPassable(h) {
+  return h.passable !== false;
+}
 function defaultIsInRange(from, to, range) {
   return Math.abs(from.x - to.x) + Math.abs(from.y - to.y) <= range;
 }
@@ -48808,36 +49087,36 @@ function WorldMapBoard({
   className
 }) {
   const eventBus = useEventBus();
-  const resolved = Array.isArray(entity) ? entity[0] : entity;
-  const hexes = resolved?.hexes ?? [];
-  const heroes = resolved?.heroes ?? [];
-  const features = resolved?.features ?? [];
-  const selectedHeroId = resolved?.selectedHeroId;
+  const resolved = boardEntity(entity);
+  const hexes = rows(resolved?.hexes);
+  const heroes = rows(resolved?.heroes);
+  const features = Array.isArray(resolved?.features) ? resolved.features : [];
+  const selectedHeroId = resolved?.selectedHeroId ?? null;
   const assetManifest = resolved?.assetManifest;
   const backgroundImage = resolved?.backgroundImage;
   const [hoveredTile, setHoveredTile] = useState(null);
   const selectedHero = useMemo(
-    () => heroes.find((h) => h.id === selectedHeroId) ?? null,
+    () => heroes.find((h) => str(h.id) === selectedHeroId) ?? null,
     [heroes, selectedHeroId]
   );
   const tiles = useMemo(
     () => hexes.map((hex) => ({
-      x: hex.x,
-      y: hex.y,
-      terrain: hex.terrain,
-      terrainSprite: hex.terrainSprite
+      x: num(hex.x),
+      y: num(hex.y),
+      terrain: str(hex.terrain),
+      terrainSprite: hex.terrainSprite == null ? void 0 : str(hex.terrainSprite)
     })),
     [hexes]
   );
   const baseUnits = useMemo(
     () => heroes.map((hero) => ({
-      id: hero.id,
-      position: hero.position,
-      name: hero.name,
-      team: hero.owner === "enemy" ? "enemy" : "player",
+      id: str(hero.id),
+      position: heroPosition(hero),
+      name: str(hero.name),
+      team: heroOwner(hero) === "enemy" ? "enemy" : "player",
       health: 100,
       maxHealth: 100,
-      sprite: hero.sprite
+      sprite: hero.sprite == null ? void 0 : str(hero.sprite)
     })),
     [heroes]
   );
@@ -48878,73 +49157,94 @@ function WorldMapBoard({
   const isoUnits = useMemo(() => {
     if (movingPositions.size === 0) return baseUnits;
     return baseUnits.map((u) => {
-      const pos = movingPositions.get(u.id);
+      const pos = u.id == null ? void 0 : movingPositions.get(u.id);
       return pos ? { ...u, position: pos } : u;
     });
   }, [baseUnits, movingPositions]);
   const validMoves = useMemo(() => {
-    if (!selectedHero || selectedHero.movement <= 0) return [];
+    if (!selectedHero || heroMovement(selectedHero) <= 0) return [];
+    const sp = heroPosition(selectedHero);
+    const sOwner = heroOwner(selectedHero);
+    const range = heroMovement(selectedHero);
     const moves = [];
     hexes.forEach((hex) => {
-      if (hex.passable === false) return;
-      if (hex.x === selectedHero.position.x && hex.y === selectedHero.position.y) return;
-      if (!isInRange(selectedHero.position, { x: hex.x, y: hex.y }, selectedHero.movement)) return;
-      if (heroes.some((h) => h.position.x === hex.x && h.position.y === hex.y && h.owner === selectedHero.owner)) return;
-      moves.push({ x: hex.x, y: hex.y });
+      const hx = num(hex.x);
+      const hy = num(hex.y);
+      if (!hexPassable(hex)) return;
+      if (hx === sp.x && hy === sp.y) return;
+      if (!isInRange(sp, { x: hx, y: hy }, range)) return;
+      if (heroes.some((h) => {
+        const hp = heroPosition(h);
+        return hp.x === hx && hp.y === hy && heroOwner(h) === sOwner;
+      })) return;
+      moves.push({ x: hx, y: hy });
     });
     return moves;
   }, [selectedHero, hexes, heroes, isInRange]);
   const attackTargets = useMemo(() => {
-    if (!selectedHero || selectedHero.movement <= 0) return [];
-    return heroes.filter((h) => h.owner !== selectedHero.owner).filter((h) => isInRange(selectedHero.position, h.position, selectedHero.movement)).map((h) => h.position);
+    if (!selectedHero || heroMovement(selectedHero) <= 0) return [];
+    const sp = heroPosition(selectedHero);
+    const sOwner = heroOwner(selectedHero);
+    const range = heroMovement(selectedHero);
+    return heroes.filter((h) => heroOwner(h) !== sOwner).filter((h) => isInRange(sp, heroPosition(h), range)).map((h) => heroPosition(h));
   }, [selectedHero, heroes, isInRange]);
-  const maxY = Math.max(...hexes.map((h) => h.y), 0);
+  const maxY = Math.max(...hexes.map((h) => num(h.y)), 0);
   const baseOffsetX = (maxY + 1) * (TILE_WIDTH * scale / 2);
   const tileToScreen = useCallback(
     (tx, ty) => isoToScreen(tx, ty, scale, baseOffsetX),
     [scale, baseOffsetX]
   );
   const hoveredHex = useMemo(
-    () => hoveredTile ? hexes.find((h) => h.x === hoveredTile.x && h.y === hoveredTile.y) ?? null : null,
+    () => hoveredTile ? hexes.find((h) => num(h.x) === hoveredTile.x && num(h.y) === hoveredTile.y) ?? null : null,
     [hoveredTile, hexes]
   );
   const hoveredHero = useMemo(
-    () => hoveredTile ? heroes.find((h) => h.position.x === hoveredTile.x && h.position.y === hoveredTile.y) ?? null : null,
+    () => hoveredTile ? heroes.find((h) => {
+      const hp = heroPosition(h);
+      return hp.x === hoveredTile.x && hp.y === hoveredTile.y;
+    }) ?? null : null,
     [hoveredTile, heroes]
   );
   const handleTileClick = useCallback((x, y) => {
     if (movementAnimRef.current) return;
-    const hex = hexes.find((h) => h.x === x && h.y === y);
+    const hex = hexes.find((h) => num(h.x) === x && num(h.y) === y);
     if (!hex) return;
     if (tileClickEvent) {
       eventBus.emit(`UI:${tileClickEvent}`, { x, y });
     }
     if (selectedHero && validMoves.some((m) => m.x === x && m.y === y)) {
-      startMoveAnimation(selectedHero.id, { ...selectedHero.position }, { x, y }, () => {
-        onHeroMove?.(selectedHero.id, x, y);
+      const heroId = str(selectedHero.id);
+      startMoveAnimation(heroId, { ...heroPosition(selectedHero) }, { x, y }, () => {
+        onHeroMove?.(heroId, x, y);
         if (heroMoveEvent) {
-          eventBus.emit(`UI:${heroMoveEvent}`, { heroId: selectedHero.id, toX: x, toY: y });
+          eventBus.emit(`UI:${heroMoveEvent}`, { heroId, toX: x, toY: y });
         }
-        if (hex.feature && hex.feature !== "none") {
-          onFeatureEnter?.(selectedHero.id, hex);
+        const feature = str(hex.feature);
+        if (feature && feature !== "none") {
+          onFeatureEnter?.(heroId, hex);
           if (featureEnterEvent) {
-            eventBus.emit(`UI:${featureEnterEvent}`, { heroId: selectedHero.id, feature: hex.feature, hex });
+            eventBus.emit(`UI:${featureEnterEvent}`, { heroId, feature, hex });
           }
         }
       });
       return;
     }
-    const enemy = heroes.find((h) => h.position.x === x && h.position.y === y && h.owner === "enemy");
+    const enemy = heroes.find((h) => {
+      const hp = heroPosition(h);
+      return hp.x === x && hp.y === y && heroOwner(h) === "enemy";
+    });
     if (selectedHero && enemy && attackTargets.some((t) => t.x === x && t.y === y)) {
-      onBattleEncounter?.(selectedHero.id, enemy.id);
+      const attackerId = str(selectedHero.id);
+      const defenderId = str(enemy.id);
+      onBattleEncounter?.(attackerId, defenderId);
       if (battleEncounterEvent) {
-        eventBus.emit(`UI:${battleEncounterEvent}`, { attackerId: selectedHero.id, defenderId: enemy.id });
+        eventBus.emit(`UI:${battleEncounterEvent}`, { attackerId, defenderId });
       }
     }
   }, [hexes, heroes, selectedHero, validMoves, attackTargets, startMoveAnimation, onHeroMove, onFeatureEnter, onBattleEncounter, eventBus, tileClickEvent, heroMoveEvent, featureEnterEvent, battleEncounterEvent]);
   const handleUnitClick = useCallback((unitId) => {
-    const hero = heroes.find((h) => h.id === unitId);
-    if (hero && (hero.owner === "player" || allowMoveAllHeroes)) {
+    const hero = heroes.find((h) => str(h.id) === unitId);
+    if (hero && (heroOwner(hero) === "player" || allowMoveAllHeroes)) {
       onHeroSelect?.(unitId);
       if (heroSelectEvent) {
         eventBus.emit(`UI:${heroSelectEvent}`, { heroId: unitId });
@@ -49017,6 +49317,7 @@ var init_WorldMapBoard = __esm({
     init_Stack();
     init_LoadingState();
     init_IsometricCanvas2();
+    init_boardEntity();
     init_isometric();
     WorldMapBoard.displayName = "WorldMapBoard";
   }
@@ -52580,10 +52881,10 @@ function parseApplicationLevel(schema) {
   }
   const count = schema.orbitals.length;
   const cols = Math.ceil(Math.sqrt(count));
-  const rows = Math.ceil(count / cols);
+  const rows2 = Math.ceil(count / cols);
   const spacing = 200;
   const gridW = cols * spacing;
-  const gridH = rows * spacing;
+  const gridH = rows2 * spacing;
   const originX = (600 - gridW) / 2 + spacing / 2;
   const originY = (400 - gridH) / 2 + spacing / 2;
   schema.orbitals.forEach((orbital, i) => {
@@ -55725,11 +56026,11 @@ function buildMockData(schema) {
       result[entityName] = entity.instances;
       continue;
     }
-    const rows = Array.from(
+    const rows2 = Array.from(
       { length: 10 },
       (_, i) => generateEntityRow(entity, i + 1)
     );
-    result[entityName] = rows;
+    result[entityName] = rows2;
   }
   for (const orbital of schema.orbitals) {
     for (const traitRef of orbital.traits ?? []) {
@@ -59228,18 +59529,18 @@ function layoutOrbitals(count, containerW, containerH) {
   if (count === 0) return [];
   if (count === 1) return [{ cx: containerW / 2, cy: containerH / 2 }];
   const cols = Math.min(count, Math.ceil(Math.sqrt(count)));
-  const rows = Math.ceil(count / cols);
+  const rows2 = Math.ceil(count / cols);
   const edgePad = 24;
   const fitMinCx = UNIT_DISPLAY_W / 2 + edgePad;
   const fitMinCy = UNIT_DISPLAY_H / 2 + edgePad;
   const fitMaxCx = Math.max(fitMinCx, containerW - UNIT_DISPLAY_W / 2 - edgePad);
   const fitMaxCy = Math.max(fitMinCy, containerH - UNIT_DISPLAY_H / 2 - edgePad);
   const fitStepX = cols > 1 ? (fitMaxCx - fitMinCx) / (cols - 1) : 0;
-  const fitStepY = rows > 1 ? (fitMaxCy - fitMinCy) / (rows - 1) : 0;
+  const fitStepY = rows2 > 1 ? (fitMaxCy - fitMinCy) / (rows2 - 1) : 0;
   const stepX = Math.min(fitStepX, UNIT_DISPLAY_W * 3.5);
   const stepY = Math.min(fitStepY, UNIT_DISPLAY_H * 3.5);
   const gridW = (cols - 1) * stepX;
-  const gridH = (rows - 1) * stepY;
+  const gridH = (rows2 - 1) * stepY;
   const originX = (containerW - gridW) / 2;
   const originY = (containerH - gridH) / 2;
   return Array.from({ length: count }, (_, i) => ({