@almadar/ui 5.70.0 → 5.72.0

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

@@ -2293,13 +2293,6 @@ function preloadFeatures(urls) {
 }
 
 // components/game/organisms/utils/spriteAnimation.ts
-function inferDirection(dx, dy) {
-  if (dx === 0 && dy === 0) return "se";
-  if (dx >= 0 && dy >= 0) return "se";
-  if (dx <= 0 && dy >= 0) return "sw";
-  if (dx >= 0 && dy <= 0) return "ne";
-  return "nw";
-}
 function resolveSheetDirection(facing) {
   switch (facing) {
     case "se":
@@ -2320,22 +2313,8 @@ function frameRect(frame, row, columns, frameWidth, frameHeight) {
     sh: frameHeight
   };
 }
-function getCurrentFrameFromDef(def, elapsed) {
-  const frameDuration = 1e3 / def.frameRate;
-  const totalDuration = def.frames * frameDuration;
-  if (def.loop) {
-    const frame2 = Math.floor(elapsed % totalDuration / frameDuration);
-    return { frame: frame2, finished: false };
-  }
-  if (elapsed >= totalDuration) {
-    return { frame: def.frames - 1, finished: true };
-  }
-  const frame = Math.floor(elapsed / frameDuration);
-  return { frame, finished: false };
-}
 
 // components/game/molecules/useUnitSpriteAtlas.ts
-var WALK_HOLD_MS = 600;
 function unitAtlasUrl(unit) {
   if (unit.spriteSheet) return unit.spriteSheet;
   const sprite = unit.sprite;
@@ -2357,9 +2336,6 @@ function useUnitSpriteAtlas(units) {
   const loadingRef = React11.useRef(/* @__PURE__ */ new Set());
   const [pendingCount, setPendingCount] = React11.useState(0);
   const [, forceTick] = React11.useState(0);
-  const animStatesRef = React11.useRef(/* @__PURE__ */ new Map());
-  const lastTickRef = React11.useRef(0);
-  const rafRef = React11.useRef(0);
   const atlasUrls = React11.useMemo(() => {
     const set = /* @__PURE__ */ new Set();
     for (const unit of units) {
@@ -2405,54 +2381,6 @@ function useUnitSpriteAtlas(units) {
     }
     return [...urls];
   }, [units, pendingCount]);
-  React11.useEffect(() => {
-    const hasAtlasUnits = units.some((u) => unitAtlasUrl(u) !== null);
-    if (!hasAtlasUnits) return;
-    let running = true;
-    const tick = (ts) => {
-      if (!running) return;
-      const last = lastTickRef.current || ts;
-      const delta = ts - last;
-      lastTickRef.current = ts;
-      const states = animStatesRef.current;
-      const currentIds = /* @__PURE__ */ new Set();
-      for (const unit of units) {
-        if (unitAtlasUrl(unit) === null) continue;
-        currentIds.add(unit.id);
-        let state = states.get(unit.id);
-        if (!state) {
-          state = { animation: "idle", direction: "se", elapsed: 0, walkHold: 0, prev: null };
-          states.set(unit.id, state);
-        }
-        const posX = unit.position?.x ?? unit.x ?? 0;
-        const posY = unit.position?.y ?? unit.y ?? 0;
-        if (state.prev) {
-          const dx = posX - state.prev.x;
-          const dy = posY - state.prev.y;
-          if (dx !== 0 || dy !== 0) {
-            state.animation = "walk";
-            state.direction = inferDirection(dx, dy);
-            state.walkHold = WALK_HOLD_MS;
-          } else if (state.animation === "walk") {
-            state.walkHold -= delta;
-            if (state.walkHold <= 0) state.animation = "idle";
-          }
-        }
-        state.prev = { x: posX, y: posY };
-        state.elapsed += delta;
-      }
-      for (const id of states.keys()) {
-        if (!currentIds.has(id)) states.delete(id);
-      }
-      rafRef.current = requestAnimationFrame(tick);
-    };
-    rafRef.current = requestAnimationFrame(tick);
-    return () => {
-      running = false;
-      cancelAnimationFrame(rafRef.current);
-      lastTickRef.current = 0;
-    };
-  }, [units]);
   const resolveUnitFrame = React11.useCallback((unitId) => {
     const unit = units.find((u) => u.id === unitId);
     if (!unit) return null;
@@ -2460,18 +2388,14 @@ function useUnitSpriteAtlas(units) {
     if (!atlasUrl) return null;
     const atlas = atlasCacheRef.current.get(atlasUrl);
     if (!atlas) return null;
-    const state = animStatesRef.current.get(unitId);
-    const animation = state?.animation ?? "idle";
-    const direction = state?.direction ?? "se";
-    const elapsed = state?.elapsed ?? 0;
+    const animation = unit.animation ?? "idle";
+    const frame = unit.frame ?? 0;
     const def = atlas.animations[animation] ?? atlas.animations.idle;
     if (!def) return null;
-    const { sheetDir, flipX } = resolveSheetDirection(direction);
+    const { sheetDir, flipX } = resolveSheetDirection("se");
     const rel = atlas.sheets[sheetDir] ?? atlas.sheets.se ?? atlas.sheets.sw;
     if (!rel) return null;
     const sheetUrl = resolveSheetUrl(atlasUrl, rel);
-    const isIdle = animation === "idle";
-    const frame = isIdle ? 0 : getCurrentFrameFromDef(def, elapsed).frame;
     const rect = frameRect(frame, def.row, atlas.columns, atlas.frameWidth, atlas.frameHeight);
     return {
       sheetUrl,
@@ -2480,7 +2404,7 @@ function useUnitSpriteAtlas(units) {
       sw: rect.sw,
       sh: rect.sh,
       flipX,
-      applyBreathing: isIdle
+      applyBreathing: animation === "idle"
     };
   }, [units]);
   return { sheetUrls, resolveUnitFrame, pendingCount };
@@ -2576,7 +2500,6 @@ var GameCanvas3D = React11.forwardRef(
     className,
     isLoading: externalLoading,
     error: externalError,
-    entity,
     preloadAssets = [],
     tileClickEvent,
     unitClickEvent,
@@ -3989,6 +3912,9 @@ var iconSizeStyles = {
   md: "h-icon-default w-icon-default",
   lg: "h-icon-default w-icon-default"
 };
+function isIconLike(v) {
+  return typeof v.render === "function";
+}
 function resolveIconProp(value, sizeClass) {
   if (!value) return null;
   if (typeof value === "string") {
@@ -4001,7 +3927,7 @@ function resolveIconProp(value, sizeClass) {
   if (React11__default.default.isValidElement(value)) {
     return value;
   }
-  if (typeof value === "object" && value !== null && "render" in value) {
+  if (typeof value === "object" && value !== null && isIconLike(value)) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
@@ -4023,6 +3949,7 @@ var Button = React11__default.default.forwardRef(
     label,
     children,
     onClick,
+    "data-testid": dataTestId,
     ...props
   }, ref) => {
     const eventBus = useEventBus();
@@ -4055,7 +3982,7 @@ var Button = React11__default.default.forwardRef(
         ),
         onClick: handleClick,
         ...props,
-        "data-testid": props["data-testid"] ?? (action ? `action-${action}` : void 0),
+        "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
         children: [
           isLoading ? /* @__PURE__ */ jsxRuntime.jsx(LucideIcons.Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
           children || label,
@@ -4152,9 +4079,8 @@ var Typography = ({
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
-  const Comp = Component2;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    Comp,
+  return React11__default.default.createElement(
+    Component2,
     {
       id,
       className: cn(
@@ -4167,9 +4093,9 @@ var Typography = ({
         overflow && overflowStyles[overflow],
         className
       ),
-      style,
-      children: children ?? content
-    }
+      style
+    },
+    children ?? content
   );
 };
 Typography.displayName = "Typography";
@@ -4226,9 +4152,8 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  const Comp = Component2;
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    Comp,
+  return React11__default.default.createElement(
+    Component2,
     {
       className: cn(
         "flex",
@@ -4244,9 +4169,9 @@ var Stack = ({
       onClick: action || onClick ? handleClick : void 0,
       onKeyDown,
       role,
-      tabIndex,
-      children
-    }
+      tabIndex
+    },
+    children
   );
 };
 var VStack = (props) => /* @__PURE__ */ jsxRuntime.jsx(Stack, { direction: "vertical", ...props });
@@ -5163,9 +5088,17 @@ function getEntity(orbital) {
   if (typeof entity === "string") {
     return { name: entity, fields: [], persistence: "runtime" };
   }
+  if ("extends" in entity) {
+    const ec = entity;
+    return {
+      name: ec.name ?? orbital.name,
+      fields: ec.fields ?? [],
+      persistence: ec.persistence ?? "runtime"
+    };
+  }
   const e = entity;
   return {
-    name: e.name ?? orbital.name,
+    name: e.name,
     fields: e.fields ?? [],
     persistence: e.persistence ?? "runtime"
   };
@@ -5174,6 +5107,7 @@ function getTraits(orbital) {
   if (!orbital.traits) return [];
   return orbital.traits.map((t) => {
     if (typeof t === "string") return { name: t };
+    if ("ref" in t && !("stateMachine" in t)) return { name: t.name ?? t.ref };
     return t;
   });
 }
@@ -5181,6 +5115,7 @@ function getPages(orbital) {
   if (!orbital.pages) return [];
   return orbital.pages.map((p) => {
     if (typeof p === "string") return { name: p, path: `/${p.toLowerCase()}` };
+    if ("ref" in p && !("path" in p)) return { name: p.ref, path: `/${p.ref.toLowerCase()}` };
     return p;
   });
 }
@@ -5199,12 +5134,12 @@ function getEvents(sm) {
 function getEmits(trait) {
   const emits = trait.emits;
   if (!emits) return [];
-  return emits.map((e) => typeof e === "string" ? e : e.event ?? e.name ?? "");
+  return emits.map((e) => e.event ?? "");
 }
 function getListens(trait) {
   const listens = trait.listens;
   if (!listens) return [];
-  return listens.map((l) => typeof l === "string" ? l : l.event ?? "");
+  return listens.map((l) => l.event ?? "");
 }
 function parseEffectType(effect) {
   if (Array.isArray(effect)) {
@@ -5375,14 +5310,14 @@ function parseTraitLevel(schema, orbitalName, traitName) {
   if (!sm) return null;
   const states = getStates(sm).map((s) => ({
     name: s.name ?? "",
-    isInitial: s.isInitial ?? false,
-    isTerminal: s.isTerminal ?? false
+    isInitial: s.isInitial ?? null,
+    isTerminal: s.isTerminal ?? null
   }));
   const transitions = getTransitions(sm).map((t, i) => ({
     from: t.from ?? "",
     to: t.to ?? "",
     event: t.event ?? "",
-    guard: t.guard,
+    guard: t.guard ?? null,
     effects: (t.effects ?? []).map(parseEffectType),
     index: i
   }));
@@ -5401,13 +5336,14 @@ function parseTransitionLevel(schema, orbitalName, traitName, transitionIndex) {
   if (!traitData) return null;
   const transition = traitData.transitions[transitionIndex];
   if (!transition) return null;
-  const guard = transition.guard ? exprToTree(transition.guard) : null;
+  const guardVal = transition.guard;
+  const guard = guardVal != null ? exprToTree(guardVal) : null;
   const effects = transition.effects.map(
     (e) => exprToTree([e.type, ...e.args])
   );
   const slotTargets = transition.effects.filter((e) => e.type === "render-ui").map((e) => ({
     name: String(e.args[0] ?? "main"),
-    pattern: typeof e.args[1] === "object" && e.args[1] !== null ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
+    pattern: typeof e.args[1] === "object" && e.args[1] !== null && !Array.isArray(e.args[1]) ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
   }));
   return {
     from: transition.from,
@@ -6870,8 +6806,8 @@ var Avl3DTraitScene = ({
         Avl3DStateNode,
         {
           name: state.name,
-          isInitial: state.isInitial,
-          isTerminal: state.isTerminal,
+          isInitial: state.isInitial ?? void 0,
+          isTerminal: state.isTerminal ?? void 0,
           position: pos,
           incomingCount: transitionCounts.incoming.get(state.name) ?? 0,
           outgoingCount: transitionCounts.outgoing.get(state.name) ?? 0

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

@@ -2269,13 +2269,6 @@ function preloadFeatures(urls) {
 }
 
 // components/game/organisms/utils/spriteAnimation.ts
-function inferDirection(dx, dy) {
-  if (dx === 0 && dy === 0) return "se";
-  if (dx >= 0 && dy >= 0) return "se";
-  if (dx <= 0 && dy >= 0) return "sw";
-  if (dx >= 0 && dy <= 0) return "ne";
-  return "nw";
-}
 function resolveSheetDirection(facing) {
   switch (facing) {
     case "se":
@@ -2296,22 +2289,8 @@ function frameRect(frame, row, columns, frameWidth, frameHeight) {
     sh: frameHeight
   };
 }
-function getCurrentFrameFromDef(def, elapsed) {
-  const frameDuration = 1e3 / def.frameRate;
-  const totalDuration = def.frames * frameDuration;
-  if (def.loop) {
-    const frame2 = Math.floor(elapsed % totalDuration / frameDuration);
-    return { frame: frame2, finished: false };
-  }
-  if (elapsed >= totalDuration) {
-    return { frame: def.frames - 1, finished: true };
-  }
-  const frame = Math.floor(elapsed / frameDuration);
-  return { frame, finished: false };
-}
 
 // components/game/molecules/useUnitSpriteAtlas.ts
-var WALK_HOLD_MS = 600;
 function unitAtlasUrl(unit) {
   if (unit.spriteSheet) return unit.spriteSheet;
   const sprite = unit.sprite;
@@ -2333,9 +2312,6 @@ function useUnitSpriteAtlas(units) {
   const loadingRef = useRef(/* @__PURE__ */ new Set());
   const [pendingCount, setPendingCount] = useState(0);
   const [, forceTick] = useState(0);
-  const animStatesRef = useRef(/* @__PURE__ */ new Map());
-  const lastTickRef = useRef(0);
-  const rafRef = useRef(0);
   const atlasUrls = useMemo(() => {
     const set = /* @__PURE__ */ new Set();
     for (const unit of units) {
@@ -2381,54 +2357,6 @@ function useUnitSpriteAtlas(units) {
     }
     return [...urls];
   }, [units, pendingCount]);
-  useEffect(() => {
-    const hasAtlasUnits = units.some((u) => unitAtlasUrl(u) !== null);
-    if (!hasAtlasUnits) return;
-    let running = true;
-    const tick = (ts) => {
-      if (!running) return;
-      const last = lastTickRef.current || ts;
-      const delta = ts - last;
-      lastTickRef.current = ts;
-      const states = animStatesRef.current;
-      const currentIds = /* @__PURE__ */ new Set();
-      for (const unit of units) {
-        if (unitAtlasUrl(unit) === null) continue;
-        currentIds.add(unit.id);
-        let state = states.get(unit.id);
-        if (!state) {
-          state = { animation: "idle", direction: "se", elapsed: 0, walkHold: 0, prev: null };
-          states.set(unit.id, state);
-        }
-        const posX = unit.position?.x ?? unit.x ?? 0;
-        const posY = unit.position?.y ?? unit.y ?? 0;
-        if (state.prev) {
-          const dx = posX - state.prev.x;
-          const dy = posY - state.prev.y;
-          if (dx !== 0 || dy !== 0) {
-            state.animation = "walk";
-            state.direction = inferDirection(dx, dy);
-            state.walkHold = WALK_HOLD_MS;
-          } else if (state.animation === "walk") {
-            state.walkHold -= delta;
-            if (state.walkHold <= 0) state.animation = "idle";
-          }
-        }
-        state.prev = { x: posX, y: posY };
-        state.elapsed += delta;
-      }
-      for (const id of states.keys()) {
-        if (!currentIds.has(id)) states.delete(id);
-      }
-      rafRef.current = requestAnimationFrame(tick);
-    };
-    rafRef.current = requestAnimationFrame(tick);
-    return () => {
-      running = false;
-      cancelAnimationFrame(rafRef.current);
-      lastTickRef.current = 0;
-    };
-  }, [units]);
   const resolveUnitFrame = useCallback((unitId) => {
     const unit = units.find((u) => u.id === unitId);
     if (!unit) return null;
@@ -2436,18 +2364,14 @@ function useUnitSpriteAtlas(units) {
     if (!atlasUrl) return null;
     const atlas = atlasCacheRef.current.get(atlasUrl);
     if (!atlas) return null;
-    const state = animStatesRef.current.get(unitId);
-    const animation = state?.animation ?? "idle";
-    const direction = state?.direction ?? "se";
-    const elapsed = state?.elapsed ?? 0;
+    const animation = unit.animation ?? "idle";
+    const frame = unit.frame ?? 0;
     const def = atlas.animations[animation] ?? atlas.animations.idle;
     if (!def) return null;
-    const { sheetDir, flipX } = resolveSheetDirection(direction);
+    const { sheetDir, flipX } = resolveSheetDirection("se");
     const rel = atlas.sheets[sheetDir] ?? atlas.sheets.se ?? atlas.sheets.sw;
     if (!rel) return null;
     const sheetUrl = resolveSheetUrl(atlasUrl, rel);
-    const isIdle = animation === "idle";
-    const frame = isIdle ? 0 : getCurrentFrameFromDef(def, elapsed).frame;
     const rect = frameRect(frame, def.row, atlas.columns, atlas.frameWidth, atlas.frameHeight);
     return {
       sheetUrl,
@@ -2456,7 +2380,7 @@ function useUnitSpriteAtlas(units) {
       sw: rect.sw,
       sh: rect.sh,
       flipX,
-      applyBreathing: isIdle
+      applyBreathing: animation === "idle"
     };
   }, [units]);
   return { sheetUrls, resolveUnitFrame, pendingCount };
@@ -2552,7 +2476,6 @@ var GameCanvas3D = forwardRef(
     className,
     isLoading: externalLoading,
     error: externalError,
-    entity,
     preloadAssets = [],
     tileClickEvent,
     unitClickEvent,
@@ -3965,6 +3888,9 @@ var iconSizeStyles = {
   md: "h-icon-default w-icon-default",
   lg: "h-icon-default w-icon-default"
 };
+function isIconLike(v) {
+  return typeof v.render === "function";
+}
 function resolveIconProp(value, sizeClass) {
   if (!value) return null;
   if (typeof value === "string") {
@@ -3977,7 +3903,7 @@ function resolveIconProp(value, sizeClass) {
   if (React11.isValidElement(value)) {
     return value;
   }
-  if (typeof value === "object" && value !== null && "render" in value) {
+  if (typeof value === "object" && value !== null && isIconLike(value)) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
@@ -3999,6 +3925,7 @@ var Button = React11.forwardRef(
     label,
     children,
     onClick,
+    "data-testid": dataTestId,
     ...props
   }, ref) => {
     const eventBus = useEventBus();
@@ -4031,7 +3958,7 @@ var Button = React11.forwardRef(
         ),
         onClick: handleClick,
         ...props,
-        "data-testid": props["data-testid"] ?? (action ? `action-${action}` : void 0),
+        "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
         children: [
           isLoading ? /* @__PURE__ */ jsx(Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
           children || label,
@@ -4128,9 +4055,8 @@ var Typography = ({
 }) => {
   const variant = variantProp ?? (level ? `h${level}` : "body1");
   const Component2 = as || defaultElements[variant];
-  const Comp = Component2;
-  return /* @__PURE__ */ jsx(
-    Comp,
+  return React11.createElement(
+    Component2,
     {
       id,
       className: cn(
@@ -4143,9 +4069,9 @@ var Typography = ({
         overflow && overflowStyles[overflow],
         className
       ),
-      style,
-      children: children ?? content
-    }
+      style
+    },
+    children ?? content
   );
 };
 Typography.displayName = "Typography";
@@ -4202,9 +4128,8 @@ var Stack = ({
   };
   const isHorizontal = direction === "horizontal";
   const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-  const Comp = Component2;
-  return /* @__PURE__ */ jsx(
-    Comp,
+  return React11.createElement(
+    Component2,
     {
       className: cn(
         "flex",
@@ -4220,9 +4145,9 @@ var Stack = ({
       onClick: action || onClick ? handleClick : void 0,
       onKeyDown,
       role,
-      tabIndex,
-      children
-    }
+      tabIndex
+    },
+    children
   );
 };
 var VStack = (props) => /* @__PURE__ */ jsx(Stack, { direction: "vertical", ...props });
@@ -5139,9 +5064,17 @@ function getEntity(orbital) {
   if (typeof entity === "string") {
     return { name: entity, fields: [], persistence: "runtime" };
   }
+  if ("extends" in entity) {
+    const ec = entity;
+    return {
+      name: ec.name ?? orbital.name,
+      fields: ec.fields ?? [],
+      persistence: ec.persistence ?? "runtime"
+    };
+  }
   const e = entity;
   return {
-    name: e.name ?? orbital.name,
+    name: e.name,
     fields: e.fields ?? [],
     persistence: e.persistence ?? "runtime"
   };
@@ -5150,6 +5083,7 @@ function getTraits(orbital) {
   if (!orbital.traits) return [];
   return orbital.traits.map((t) => {
     if (typeof t === "string") return { name: t };
+    if ("ref" in t && !("stateMachine" in t)) return { name: t.name ?? t.ref };
     return t;
   });
 }
@@ -5157,6 +5091,7 @@ function getPages(orbital) {
   if (!orbital.pages) return [];
   return orbital.pages.map((p) => {
     if (typeof p === "string") return { name: p, path: `/${p.toLowerCase()}` };
+    if ("ref" in p && !("path" in p)) return { name: p.ref, path: `/${p.ref.toLowerCase()}` };
     return p;
   });
 }
@@ -5175,12 +5110,12 @@ function getEvents(sm) {
 function getEmits(trait) {
   const emits = trait.emits;
   if (!emits) return [];
-  return emits.map((e) => typeof e === "string" ? e : e.event ?? e.name ?? "");
+  return emits.map((e) => e.event ?? "");
 }
 function getListens(trait) {
   const listens = trait.listens;
   if (!listens) return [];
-  return listens.map((l) => typeof l === "string" ? l : l.event ?? "");
+  return listens.map((l) => l.event ?? "");
 }
 function parseEffectType(effect) {
   if (Array.isArray(effect)) {
@@ -5351,14 +5286,14 @@ function parseTraitLevel(schema, orbitalName, traitName) {
   if (!sm) return null;
   const states = getStates(sm).map((s) => ({
     name: s.name ?? "",
-    isInitial: s.isInitial ?? false,
-    isTerminal: s.isTerminal ?? false
+    isInitial: s.isInitial ?? null,
+    isTerminal: s.isTerminal ?? null
   }));
   const transitions = getTransitions(sm).map((t, i) => ({
     from: t.from ?? "",
     to: t.to ?? "",
     event: t.event ?? "",
-    guard: t.guard,
+    guard: t.guard ?? null,
     effects: (t.effects ?? []).map(parseEffectType),
     index: i
   }));
@@ -5377,13 +5312,14 @@ function parseTransitionLevel(schema, orbitalName, traitName, transitionIndex) {
   if (!traitData) return null;
   const transition = traitData.transitions[transitionIndex];
   if (!transition) return null;
-  const guard = transition.guard ? exprToTree(transition.guard) : null;
+  const guardVal = transition.guard;
+  const guard = guardVal != null ? exprToTree(guardVal) : null;
   const effects = transition.effects.map(
     (e) => exprToTree([e.type, ...e.args])
   );
   const slotTargets = transition.effects.filter((e) => e.type === "render-ui").map((e) => ({
     name: String(e.args[0] ?? "main"),
-    pattern: typeof e.args[1] === "object" && e.args[1] !== null ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
+    pattern: typeof e.args[1] === "object" && e.args[1] !== null && !Array.isArray(e.args[1]) ? e.args[1].type ?? "unknown" : String(e.args[1] ?? "unknown")
   }));
   return {
     from: transition.from,
@@ -6846,8 +6782,8 @@ var Avl3DTraitScene = ({
         Avl3DStateNode,
         {
           name: state.name,
-          isInitial: state.isInitial,
-          isTerminal: state.isTerminal,
+          isInitial: state.isInitial ?? void 0,
+          isTerminal: state.isTerminal ?? void 0,
           position: pos,
           incomingCount: transitionCounts.incoming.get(state.name) ?? 0,
           outgoingCount: transitionCounts.outgoing.get(state.name) ?? 0

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

@@ -23,8 +23,9 @@ export interface UseUnitSpriteAtlasResult {
     pendingCount: number;
 }
 /**
- * Load per-unit sprite atlases and drive single-frame animation.
+ * Load per-unit sprite atlases and expose a pure frame resolver.
+ * Frame is computed from each unit's own `animation` + `frame` props — no internal clock.
  *
- * @param units - Units to animate. Only units with a `spriteSheet` URL participate.
+ * @param units - Units whose atlases should be loaded.
  */
 export declare function useUnitSpriteAtlas(units: IsometricUnit[]): UseUnitSpriteAtlasResult;

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

@@ -1,13 +1,13 @@
 import React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { AssetUrl, EventEmit, EntityRow } from '@almadar/core';
 import type { DisplayStateProps } from '../../core/organisms/types';
 export interface PinballBoardProps extends DisplayStateProps {
     /** Playfield tiles */
-    tiles?: unknown[];
+    tiles?: readonly EntityRow[];
     /** Ball units on the board */
-    units?: unknown[];
+    units?: readonly EntityRow[];
     /** Features (bumpers, paddles, etc.) on the board */
-    features?: unknown[];
+    features?: readonly EntityRow[];
     /** Asset sprite manifest */
     assetManifest?: string;
     /** Base URL prepended to manifest sprite paths */