@almadar/ui 5.96.0 → 5.98.0

package/dist/components/game/3d/molecules/ModelLoader.d.ts

@@ -32,6 +32,8 @@ export interface ModelLoaderProps {
      * unknown or absent name leaves the model static (bind pose).
      */
     animation?: string;
+    /** Multiply the model's material colors by this CSS color (per-instance; e.g. team tint). */
+    tint?: string;
     /** Enable shadows */
     castShadow?: boolean;
     /** Receive shadows */
@@ -46,5 +48,5 @@ export interface ModelLoaderProps {
 /**
  * ModelLoader component for rendering GLB models in React Three Fiber
  */
-export declare function ModelLoader({ url, position, scale, rotation, isSelected, isHovered, onClick, onHover, fallbackGeometry, castShadow, receiveShadow, resourceBasePath, animation, }: ModelLoaderProps): React.JSX.Element;
+export declare function ModelLoader({ url, position, scale, rotation, isSelected, isHovered, onClick, onHover, fallbackGeometry, castShadow, receiveShadow, resourceBasePath, animation, tint, }: ModelLoaderProps): React.JSX.Element;
 export default ModelLoader;

package/dist/components/game/shared/isometricTypes.d.ts

@@ -46,6 +46,8 @@ export interface IsometricTile {
     elevation?: number;
     /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
     modelUrl?: Asset;
+    /** Y-axis rotation in degrees (3D) — orients directional pieces (track corners, road bends) */
+    rotation?: number;
 }
 /** A unit positioned on the isometric grid */
 export type IsometricUnit = {

package/dist/components/index.cjs

@@ -20098,7 +20098,7 @@ var init_ConnectionBlock = __esm({
   }
 });
 function ControlButton({
-  assetUrl = DEFAULT_ASSET_URL3,
+  assetUrl,
   label,
   icon,
   size = "md",
@@ -20176,7 +20176,7 @@ function ControlButton({
     }
   );
 }
-var sizeMap5, shapeMap, variantMap, DEFAULT_ASSET_URL3;
+var sizeMap5, shapeMap, variantMap;
 var init_ControlButton = __esm({
   "components/game/2d/atoms/ControlButton.tsx"() {
     "use client";
@@ -20203,11 +20203,6 @@ var init_ControlButton = __esm({
       secondary: "bg-secondary text-secondary-foreground border-border hover:bg-secondary-hover",
       ghost: "bg-transparent text-foreground border-border hover:bg-muted"
     };
-    DEFAULT_ASSET_URL3 = {
-      url: "https://almadar-kflow-assets.web.app/shared/effects/particles/circle_01.png",
-      role: "ui",
-      category: "control"
-    };
     ControlButton.displayName = "ControlButton";
   }
 });
@@ -20277,15 +20272,17 @@ function ControlGrid({
       },
       d
     );
+    const usesSemantic = !!directionEvents;
+    const cell = (d) => !usesSemantic || directionEvents?.[d] ? dir(d) : /* @__PURE__ */ jsxRuntime.jsx(exports.Box, {}, d);
     return /* @__PURE__ */ jsxRuntime.jsxs(exports.Box, { className: cn("inline-grid grid-cols-3", ds.gap, ds.container, className), children: [
       /* @__PURE__ */ jsxRuntime.jsx(exports.Box, {}),
-      dir("up"),
+      cell("up"),
       /* @__PURE__ */ jsxRuntime.jsx(exports.Box, {}),
-      dir("left"),
+      cell("left"),
       /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: "flex items-center justify-center", children: /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: "w-6 h-6 rounded-interactive bg-muted border-2 border-muted-foreground" }) }),
-      dir("right"),
+      cell("right"),
       /* @__PURE__ */ jsxRuntime.jsx(exports.Box, {}),
-      dir("down"),
+      cell("down"),
       /* @__PURE__ */ jsxRuntime.jsx(exports.Box, {})
     ] });
   }
@@ -20632,7 +20629,7 @@ var init_CounterTemplate = __esm({
   }
 });
 function DamageNumber({
-  assetUrl = DEFAULT_ASSET_URL4,
+  assetUrl = DEFAULT_ASSET_URL3,
   value = 42,
   type = "damage",
   size = "md",
@@ -20660,7 +20657,7 @@ function DamageNumber({
     )
   ] });
 }
-var sizeMap6, typeStyles, floatKeyframes, DEFAULT_ASSET_URL4;
+var sizeMap6, typeStyles, floatKeyframes, DEFAULT_ASSET_URL3;
 var init_DamageNumber = __esm({
   "components/game/2d/atoms/DamageNumber.tsx"() {
     init_cn();
@@ -20684,7 +20681,7 @@ var init_DamageNumber = __esm({
   100% { opacity: 0; transform: translateY(-32px) scale(0.8); }
 }
 `;
-    DEFAULT_ASSET_URL4 = {
+    DEFAULT_ASSET_URL3 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/spark_01.png",
       role: "effect",
       category: "effect"
@@ -27322,7 +27319,7 @@ function isKnownState(s) {
   return s in DEFAULT_STATE_STYLES;
 }
 function StateIndicator({
-  assetUrl = DEFAULT_ASSET_URL5,
+  assetUrl = DEFAULT_ASSET_URL4,
   state = "idle",
   label,
   size = "md",
@@ -27352,14 +27349,14 @@ function StateIndicator({
     }
   );
 }
-var DEFAULT_ASSET_URL5, DEFAULT_STATE_STYLES, DEFAULT_STYLE, STATIC_STATES, SIZE_CLASSES;
+var DEFAULT_ASSET_URL4, DEFAULT_STATE_STYLES, DEFAULT_STYLE, STATIC_STATES, SIZE_CLASSES;
 var init_StateIndicator = __esm({
   "components/game/2d/atoms/StateIndicator.tsx"() {
     init_Box();
     init_Icon();
     init_cn();
     init_GameIcon();
-    DEFAULT_ASSET_URL5 = {
+    DEFAULT_ASSET_URL4 = {
       url: "https://almadar-kflow-assets.web.app/shared/isometric-dungeon/Isometric/chestClosed_E.png",
       role: "ui",
       category: "state"
@@ -27445,7 +27442,7 @@ var init_TimerDisplay = __esm({
   }
 });
 function ResourceCounter({
-  assetUrl = DEFAULT_ASSET_URL6,
+  assetUrl = DEFAULT_ASSET_URL5,
   icon,
   label = "Gold",
   value = 250,
@@ -27478,7 +27475,7 @@ function ResourceCounter({
     }
   );
 }
-var colorTokenClasses2, DEFAULT_ASSET_URL6, sizeMap10;
+var colorTokenClasses2, DEFAULT_ASSET_URL5, sizeMap10;
 var init_ResourceCounter = __esm({
   "components/game/2d/atoms/ResourceCounter.tsx"() {
     init_cn();
@@ -27494,7 +27491,7 @@ var init_ResourceCounter = __esm({
       error: "text-error",
       muted: "text-muted-foreground"
     };
-    DEFAULT_ASSET_URL6 = {
+    DEFAULT_ASSET_URL5 = {
       url: "https://almadar-kflow-assets.web.app/shared/world-map/gold_mine.png",
       role: "ui",
       category: "coin"
@@ -27508,7 +27505,7 @@ var init_ResourceCounter = __esm({
   }
 });
 function ItemSlot({
-  assetUrl = DEFAULT_ASSET_URL7,
+  assetUrl = DEFAULT_ASSET_URL6,
   icon = "sword",
   label = "Iron Sword",
   quantity,
@@ -27563,7 +27560,7 @@ function ItemSlot({
     }
   );
 }
-var sizeMap11, rarityBorderMap, rarityGlowMap, DEFAULT_ASSET_URL7, assetSizeMap;
+var sizeMap11, rarityBorderMap, rarityGlowMap, DEFAULT_ASSET_URL6, assetSizeMap;
 var init_ItemSlot = __esm({
   "components/game/2d/atoms/ItemSlot.tsx"() {
     "use client";
@@ -27593,7 +27590,7 @@ var init_ItemSlot = __esm({
       epic: "shadow-lg",
       legendary: "shadow-lg"
     };
-    DEFAULT_ASSET_URL7 = {
+    DEFAULT_ASSET_URL6 = {
       url: "https://almadar-kflow-assets.web.app/shared/isometric-dungeon/Isometric/chestClosed_E.png",
       role: "item",
       category: "item"
@@ -27607,7 +27604,7 @@ var init_ItemSlot = __esm({
   }
 });
 function TurnIndicator({
-  assetUrl = DEFAULT_ASSET_URL8,
+  assetUrl = DEFAULT_ASSET_URL7,
   currentTurn = 1,
   maxTurns,
   activeTeam,
@@ -27647,7 +27644,7 @@ function TurnIndicator({
     }
   );
 }
-var sizeMap12, DEFAULT_ASSET_URL8;
+var sizeMap12, DEFAULT_ASSET_URL7;
 var init_TurnIndicator = __esm({
   "components/game/2d/atoms/TurnIndicator.tsx"() {
     init_cn();
@@ -27659,7 +27656,7 @@ var init_TurnIndicator = __esm({
       md: { wrapper: "text-sm gap-2 px-3 py-1", dot: "w-2 h-2" },
       lg: { wrapper: "text-base gap-2.5 px-4 py-1.5", dot: "w-2.5 h-2.5" }
     };
-    DEFAULT_ASSET_URL8 = {
+    DEFAULT_ASSET_URL7 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/symbol_01.png",
       role: "ui",
       category: "turn"
@@ -27668,7 +27665,7 @@ var init_TurnIndicator = __esm({
   }
 });
 function WaypointMarker({
-  assetUrl = DEFAULT_ASSET_URL9,
+  assetUrl = DEFAULT_ASSET_URL8,
   label,
   icon,
   active = true,
@@ -27728,7 +27725,7 @@ function WaypointMarker({
     )
   ] });
 }
-var DEFAULT_ASSET_URL9, sizeMap13, checkIcon;
+var DEFAULT_ASSET_URL8, sizeMap13, checkIcon;
 var init_WaypointMarker = __esm({
   "components/game/2d/atoms/WaypointMarker.tsx"() {
     init_cn();
@@ -27736,7 +27733,7 @@ var init_WaypointMarker = __esm({
     init_Box();
     init_Typography();
     init_GameIcon();
-    DEFAULT_ASSET_URL9 = {
+    DEFAULT_ASSET_URL8 = {
       url: "https://almadar-kflow-assets.web.app/shared/world-map/battle_marker.png",
       role: "ui",
       category: "waypoint"
@@ -27757,7 +27754,7 @@ function formatDuration(seconds) {
   return `${Math.round(seconds)}s`;
 }
 function StatusEffect({
-  assetUrl = DEFAULT_ASSET_URL10,
+  assetUrl = DEFAULT_ASSET_URL9,
   icon,
   label = "Shield",
   duration = 30,
@@ -27808,7 +27805,7 @@ function StatusEffect({
     label && /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { as: "span", className: "text-xs text-muted-foreground mt-0.5 text-center whitespace-nowrap", children: label })
   ] });
 }
-var DEFAULT_ASSET_URL10, sizeMap14, variantStyles8;
+var DEFAULT_ASSET_URL9, sizeMap14, variantStyles8;
 var init_StatusEffect = __esm({
   "components/game/2d/atoms/StatusEffect.tsx"() {
     init_cn();
@@ -27816,7 +27813,7 @@ var init_StatusEffect = __esm({
     init_Box();
     init_Typography();
     init_GameIcon();
-    DEFAULT_ASSET_URL10 = {
+    DEFAULT_ASSET_URL9 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/flame_01.png",
       role: "ui",
       category: "effect"

package/dist/components/index.js

@@ -20052,7 +20052,7 @@ var init_ConnectionBlock = __esm({
   }
 });
 function ControlButton({
-  assetUrl = DEFAULT_ASSET_URL3,
+  assetUrl,
   label,
   icon,
   size = "md",
@@ -20130,7 +20130,7 @@ function ControlButton({
     }
   );
 }
-var sizeMap5, shapeMap, variantMap, DEFAULT_ASSET_URL3;
+var sizeMap5, shapeMap, variantMap;
 var init_ControlButton = __esm({
   "components/game/2d/atoms/ControlButton.tsx"() {
     "use client";
@@ -20157,11 +20157,6 @@ var init_ControlButton = __esm({
       secondary: "bg-secondary text-secondary-foreground border-border hover:bg-secondary-hover",
       ghost: "bg-transparent text-foreground border-border hover:bg-muted"
     };
-    DEFAULT_ASSET_URL3 = {
-      url: "https://almadar-kflow-assets.web.app/shared/effects/particles/circle_01.png",
-      role: "ui",
-      category: "control"
-    };
     ControlButton.displayName = "ControlButton";
   }
 });
@@ -20231,15 +20226,17 @@ function ControlGrid({
       },
       d
     );
+    const usesSemantic = !!directionEvents;
+    const cell = (d) => !usesSemantic || directionEvents?.[d] ? dir(d) : /* @__PURE__ */ jsx(Box, {}, d);
     return /* @__PURE__ */ jsxs(Box, { className: cn("inline-grid grid-cols-3", ds.gap, ds.container, className), children: [
       /* @__PURE__ */ jsx(Box, {}),
-      dir("up"),
+      cell("up"),
       /* @__PURE__ */ jsx(Box, {}),
-      dir("left"),
+      cell("left"),
       /* @__PURE__ */ jsx(Box, { className: "flex items-center justify-center", children: /* @__PURE__ */ jsx(Box, { className: "w-6 h-6 rounded-interactive bg-muted border-2 border-muted-foreground" }) }),
-      dir("right"),
+      cell("right"),
       /* @__PURE__ */ jsx(Box, {}),
-      dir("down"),
+      cell("down"),
       /* @__PURE__ */ jsx(Box, {})
     ] });
   }
@@ -20586,7 +20583,7 @@ var init_CounterTemplate = __esm({
   }
 });
 function DamageNumber({
-  assetUrl = DEFAULT_ASSET_URL4,
+  assetUrl = DEFAULT_ASSET_URL3,
   value = 42,
   type = "damage",
   size = "md",
@@ -20614,7 +20611,7 @@ function DamageNumber({
     )
   ] });
 }
-var sizeMap6, typeStyles, floatKeyframes, DEFAULT_ASSET_URL4;
+var sizeMap6, typeStyles, floatKeyframes, DEFAULT_ASSET_URL3;
 var init_DamageNumber = __esm({
   "components/game/2d/atoms/DamageNumber.tsx"() {
     init_cn();
@@ -20638,7 +20635,7 @@ var init_DamageNumber = __esm({
   100% { opacity: 0; transform: translateY(-32px) scale(0.8); }
 }
 `;
-    DEFAULT_ASSET_URL4 = {
+    DEFAULT_ASSET_URL3 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/spark_01.png",
       role: "effect",
       category: "effect"
@@ -27276,7 +27273,7 @@ function isKnownState(s) {
   return s in DEFAULT_STATE_STYLES;
 }
 function StateIndicator({
-  assetUrl = DEFAULT_ASSET_URL5,
+  assetUrl = DEFAULT_ASSET_URL4,
   state = "idle",
   label,
   size = "md",
@@ -27306,14 +27303,14 @@ function StateIndicator({
     }
   );
 }
-var DEFAULT_ASSET_URL5, DEFAULT_STATE_STYLES, DEFAULT_STYLE, STATIC_STATES, SIZE_CLASSES;
+var DEFAULT_ASSET_URL4, DEFAULT_STATE_STYLES, DEFAULT_STYLE, STATIC_STATES, SIZE_CLASSES;
 var init_StateIndicator = __esm({
   "components/game/2d/atoms/StateIndicator.tsx"() {
     init_Box();
     init_Icon();
     init_cn();
     init_GameIcon();
-    DEFAULT_ASSET_URL5 = {
+    DEFAULT_ASSET_URL4 = {
       url: "https://almadar-kflow-assets.web.app/shared/isometric-dungeon/Isometric/chestClosed_E.png",
       role: "ui",
       category: "state"
@@ -27399,7 +27396,7 @@ var init_TimerDisplay = __esm({
   }
 });
 function ResourceCounter({
-  assetUrl = DEFAULT_ASSET_URL6,
+  assetUrl = DEFAULT_ASSET_URL5,
   icon,
   label = "Gold",
   value = 250,
@@ -27432,7 +27429,7 @@ function ResourceCounter({
     }
   );
 }
-var colorTokenClasses2, DEFAULT_ASSET_URL6, sizeMap10;
+var colorTokenClasses2, DEFAULT_ASSET_URL5, sizeMap10;
 var init_ResourceCounter = __esm({
   "components/game/2d/atoms/ResourceCounter.tsx"() {
     init_cn();
@@ -27448,7 +27445,7 @@ var init_ResourceCounter = __esm({
       error: "text-error",
       muted: "text-muted-foreground"
     };
-    DEFAULT_ASSET_URL6 = {
+    DEFAULT_ASSET_URL5 = {
       url: "https://almadar-kflow-assets.web.app/shared/world-map/gold_mine.png",
       role: "ui",
       category: "coin"
@@ -27462,7 +27459,7 @@ var init_ResourceCounter = __esm({
   }
 });
 function ItemSlot({
-  assetUrl = DEFAULT_ASSET_URL7,
+  assetUrl = DEFAULT_ASSET_URL6,
   icon = "sword",
   label = "Iron Sword",
   quantity,
@@ -27517,7 +27514,7 @@ function ItemSlot({
     }
   );
 }
-var sizeMap11, rarityBorderMap, rarityGlowMap, DEFAULT_ASSET_URL7, assetSizeMap;
+var sizeMap11, rarityBorderMap, rarityGlowMap, DEFAULT_ASSET_URL6, assetSizeMap;
 var init_ItemSlot = __esm({
   "components/game/2d/atoms/ItemSlot.tsx"() {
     "use client";
@@ -27547,7 +27544,7 @@ var init_ItemSlot = __esm({
       epic: "shadow-lg",
       legendary: "shadow-lg"
     };
-    DEFAULT_ASSET_URL7 = {
+    DEFAULT_ASSET_URL6 = {
       url: "https://almadar-kflow-assets.web.app/shared/isometric-dungeon/Isometric/chestClosed_E.png",
       role: "item",
       category: "item"
@@ -27561,7 +27558,7 @@ var init_ItemSlot = __esm({
   }
 });
 function TurnIndicator({
-  assetUrl = DEFAULT_ASSET_URL8,
+  assetUrl = DEFAULT_ASSET_URL7,
   currentTurn = 1,
   maxTurns,
   activeTeam,
@@ -27601,7 +27598,7 @@ function TurnIndicator({
     }
   );
 }
-var sizeMap12, DEFAULT_ASSET_URL8;
+var sizeMap12, DEFAULT_ASSET_URL7;
 var init_TurnIndicator = __esm({
   "components/game/2d/atoms/TurnIndicator.tsx"() {
     init_cn();
@@ -27613,7 +27610,7 @@ var init_TurnIndicator = __esm({
       md: { wrapper: "text-sm gap-2 px-3 py-1", dot: "w-2 h-2" },
       lg: { wrapper: "text-base gap-2.5 px-4 py-1.5", dot: "w-2.5 h-2.5" }
     };
-    DEFAULT_ASSET_URL8 = {
+    DEFAULT_ASSET_URL7 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/symbol_01.png",
       role: "ui",
       category: "turn"
@@ -27622,7 +27619,7 @@ var init_TurnIndicator = __esm({
   }
 });
 function WaypointMarker({
-  assetUrl = DEFAULT_ASSET_URL9,
+  assetUrl = DEFAULT_ASSET_URL8,
   label,
   icon,
   active = true,
@@ -27682,7 +27679,7 @@ function WaypointMarker({
     )
   ] });
 }
-var DEFAULT_ASSET_URL9, sizeMap13, checkIcon;
+var DEFAULT_ASSET_URL8, sizeMap13, checkIcon;
 var init_WaypointMarker = __esm({
   "components/game/2d/atoms/WaypointMarker.tsx"() {
     init_cn();
@@ -27690,7 +27687,7 @@ var init_WaypointMarker = __esm({
     init_Box();
     init_Typography();
     init_GameIcon();
-    DEFAULT_ASSET_URL9 = {
+    DEFAULT_ASSET_URL8 = {
       url: "https://almadar-kflow-assets.web.app/shared/world-map/battle_marker.png",
       role: "ui",
       category: "waypoint"
@@ -27711,7 +27708,7 @@ function formatDuration(seconds) {
   return `${Math.round(seconds)}s`;
 }
 function StatusEffect({
-  assetUrl = DEFAULT_ASSET_URL10,
+  assetUrl = DEFAULT_ASSET_URL9,
   icon,
   label = "Shield",
   duration = 30,
@@ -27762,7 +27759,7 @@ function StatusEffect({
     label && /* @__PURE__ */ jsx(Typography, { as: "span", className: "text-xs text-muted-foreground mt-0.5 text-center whitespace-nowrap", children: label })
   ] });
 }
-var DEFAULT_ASSET_URL10, sizeMap14, variantStyles8;
+var DEFAULT_ASSET_URL9, sizeMap14, variantStyles8;
 var init_StatusEffect = __esm({
   "components/game/2d/atoms/StatusEffect.tsx"() {
     init_cn();
@@ -27770,7 +27767,7 @@ var init_StatusEffect = __esm({
     init_Box();
     init_Typography();
     init_GameIcon();
-    DEFAULT_ASSET_URL10 = {
+    DEFAULT_ASSET_URL9 = {
       url: "https://almadar-kflow-assets.web.app/shared/effects/particles/flame_01.png",
       role: "ui",
       category: "effect"

package/dist/lib/index.cjs

@@ -503,11 +503,14 @@ function recordTransition(trace) {
   }
   if (entry.event === "INIT") {
     const hasFetch = entry.effects.some((e) => e.type === "fetch");
+    const hasEntitySeed = entry.effects.some(
+      (e) => e.type === "set" && typeof e.args[0] === "string" && e.args[0].startsWith("@entity.")
+    );
     const checkId = `init-fetch-${entry.traitName}`;
-    if (hasFetch) {
+    if (hasFetch || hasEntitySeed) {
       registerCheck(
         checkId,
-        `INIT transition for "${entry.traitName}" has fetch effect`,
+        `INIT transition for "${entry.traitName}" has fetch or entity-seed effect`,
         "pass"
       );
     } else {

package/dist/lib/index.js

@@ -501,11 +501,14 @@ function recordTransition(trace) {
   }
   if (entry.event === "INIT") {
     const hasFetch = entry.effects.some((e) => e.type === "fetch");
+    const hasEntitySeed = entry.effects.some(
+      (e) => e.type === "set" && typeof e.args[0] === "string" && e.args[0].startsWith("@entity.")
+    );
     const checkId = `init-fetch-${entry.traitName}`;
-    if (hasFetch) {
+    if (hasFetch || hasEntitySeed) {
       registerCheck(
         checkId,
-        `INIT transition for "${entry.traitName}" has fetch effect`,
+        `INIT transition for "${entry.traitName}" has fetch or entity-seed effect`,
         "pass"
       );
     } else {