@almadar/ui 5.79.2 → 5.80.0

package/dist/components/index.cjs

@@ -40,8 +40,8 @@ var core$1 = require('@almadar/core');
 var core = require('@dnd-kit/core');
 var sortable = require('@dnd-kit/sortable');
 var utilities = require('@dnd-kit/utilities');
-var patterns = require('@almadar/patterns');
 var react = require('@xyflow/react');
+var patterns = require('@almadar/patterns');
 var reactQuery = require('@tanstack/react-query');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -7982,8 +7982,10 @@ function ActionButton({
   size = "md",
   variant = "primary",
   onClick,
+  action,
   className
 }) {
+  const eventBus = useEventBus();
   const sizes = sizeMap[size];
   const onCooldown = cooldown > 0;
   const isDisabled = disabled || onCooldown;
@@ -7993,7 +7995,10 @@ function ActionButton({
     {
       type: "button",
       disabled: isDisabled,
-      onClick,
+      onClick: (e) => {
+        if (action) eventBus.emit(`UI:${action}`, {});
+        onClick?.();
+      },
       className: cn(
         "relative inline-flex items-center gap-1.5 rounded-interactive border font-medium overflow-hidden transition-colors duration-150",
         sizes.button,
@@ -8050,6 +8055,7 @@ var init_ActionButton = __esm({
   "components/game/2d/atoms/ActionButton.tsx"() {
     init_cn();
     init_Icon();
+    init_useEventBus();
     sizeMap = {
       sm: { button: "h-button-sm px-3 text-xs", hotkey: "text-[9px] px-1", icon: "text-xs" },
       md: { button: "h-button-md px-4 text-sm", hotkey: "text-xs px-1.5", icon: "text-sm" },
@@ -8103,7 +8109,7 @@ function ActionTile({
       draggable: !disabled,
       onDragStart: handleDragStart,
       children: [
-        action.iconUrl ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: action.iconUrl, alt: "", className: "w-8 h-8 object-contain" }) : /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "body1", className: cn(config.icon, "leading-none"), children: action.iconEmoji || "\u2726" }),
+        action.iconUrl ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: action.iconUrl.url, alt: "", className: "w-8 h-8 object-contain" }) : /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "body1", className: cn(config.icon, "leading-none"), children: action.iconEmoji || "\u2726" }),
         /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "caption", className: cn(config.text, "text-foreground font-medium whitespace-nowrap"), children: action.name })
       ]
     }
@@ -8707,9 +8713,26 @@ function MiniMap({
   mapWidth = 100,
   mapHeight = 100,
   viewportRect = DEFAULT_VIEWPORT,
-  className
+  className,
+  tileAssets,
+  unitAssets
 }) {
   const canvasRef = React79__namespace.useRef(null);
+  const imgCacheRef = React79__namespace.useRef(/* @__PURE__ */ new Map());
+  function loadImg(url) {
+    const cached = imgCacheRef.current.get(url);
+    if (cached) return cached.complete ? cached : null;
+    const img = new Image();
+    img.src = url;
+    img.onload = () => {
+      const canvas = canvasRef.current;
+      if (!canvas) return;
+      const ctx = canvas.getContext("2d");
+      if (ctx) ctx.clearRect(0, 0, 0, 0);
+    };
+    imgCacheRef.current.set(url, img);
+    return null;
+  }
   React79__namespace.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
@@ -8721,20 +8744,31 @@ function MiniMap({
     ctx.fillStyle = "#111";
     ctx.fillRect(0, 0, width, height);
     for (const tile of tiles) {
-      ctx.fillStyle = tile.color;
-      ctx.fillRect(
-        Math.floor(tile.x * scaleX2),
-        Math.floor(tile.y * scaleY2),
-        Math.max(1, Math.ceil(scaleX2)),
-        Math.max(1, Math.ceil(scaleY2))
-      );
+      const tileAsset = tileAssets?.[tile.color] ?? tileAssets?.["default"];
+      const tileImg = tileAsset ? loadImg(tileAsset.url) : null;
+      const tx = Math.floor(tile.x * scaleX2);
+      const ty = Math.floor(tile.y * scaleY2);
+      const tw = Math.max(1, Math.ceil(scaleX2));
+      const th = Math.max(1, Math.ceil(scaleY2));
+      if (tileImg) {
+        ctx.drawImage(tileImg, tx, ty, tw, th);
+      } else {
+        ctx.fillStyle = tile.color;
+        ctx.fillRect(tx, ty, tw, th);
+      }
     }
     for (const unit of units) {
       if (unit.isPlayer) continue;
-      ctx.fillStyle = unit.color;
+      const unitAsset = unitAssets?.[unit.color] ?? unitAssets?.["default"];
+      const unitImg = unitAsset ? loadImg(unitAsset.url) : null;
       const ux = Math.floor(unit.x * scaleX2) - 1;
       const uy = Math.floor(unit.y * scaleY2) - 1;
-      ctx.fillRect(ux, uy, 3, 3);
+      if (unitImg) {
+        ctx.drawImage(unitImg, ux, uy, 5, 5);
+      } else {
+        ctx.fillStyle = unit.color;
+        ctx.fillRect(ux, uy, 3, 3);
+      }
     }
     if (viewportRect) {
       ctx.strokeStyle = "#ffffff";
@@ -8746,7 +8780,7 @@ function MiniMap({
         Math.floor(viewportRect.h * scaleY2)
       );
     }
-  }, [tiles, units, width, height, mapWidth, mapHeight, viewportRect]);
+  }, [tiles, units, width, height, mapWidth, mapHeight, viewportRect, tileAssets, unitAssets]);
   const scaleX = width / mapWidth;
   const scaleY = height / mapHeight;
   const playerUnit = units.find((u) => u.isPlayer);
@@ -8823,7 +8857,9 @@ function HealthBar({
   labelSuffix,
   size = "md",
   className,
-  animated = true
+  animated = true,
+  frameAsset,
+  fillAsset
 }) {
   const sizes = sizeMap2[size];
   const percentage = max > 0 ? Math.max(0, Math.min(100, current / max * 100)) : 0;
@@ -8842,20 +8878,25 @@ function HealthBar({
       "div",
       {
         className: cn(
-          "relative overflow-hidden rounded-full bg-muted",
+          "relative overflow-hidden rounded-full",
+          !frameAsset && "bg-muted",
           sizes.bar,
           "w-24",
           className
         ),
+        style: frameAsset ? { backgroundImage: `url(${frameAsset.url})`, backgroundSize: "100% 100%" } : void 0,
         children: /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
             className: cn(
               "absolute inset-y-0 left-0 rounded-full",
-              percentage > 66 ? "bg-success" : percentage > 33 ? "bg-warning" : "bg-error",
+              !fillAsset && (percentage > 66 ? "bg-success" : percentage > 33 ? "bg-warning" : "bg-error"),
               animated && "transition-all duration-300"
             ),
-            style: { width: `${percentage}%` }
+            style: {
+              width: `${percentage}%`,
+              ...fillAsset ? { backgroundImage: `url(${fillAsset.url})`, backgroundSize: "auto 100%" } : {}
+            }
           }
         )
       }
@@ -8882,18 +8923,23 @@ function HealthBar({
           "div",
           {
             className: cn(
-              "relative w-full overflow-hidden rounded-full bg-muted border border-muted",
+              "relative w-full overflow-hidden rounded-full",
+              !frameAsset && "bg-muted border border-muted",
               sizes.bar
             ),
+            style: frameAsset ? { backgroundImage: `url(${frameAsset.url})`, backgroundSize: "100% 100%" } : void 0,
             children: /* @__PURE__ */ jsxRuntime.jsx(
               "div",
               {
                 className: cn(
                   "absolute inset-y-0 left-0 rounded-full",
-                  "bg-gradient-to-r from-accent to-info",
+                  !fillAsset && "bg-gradient-to-r from-accent to-info",
                   animated && "transition-all duration-500 ease-out"
                 ),
-                style: { width: `${percentage}%` }
+                style: {
+                  width: `${percentage}%`,
+                  ...fillAsset ? { backgroundImage: `url(${fillAsset.url})`, backgroundSize: "auto 100%" } : {}
+                }
               }
             )
           }
@@ -12675,9 +12721,9 @@ var init_BiologyCanvas = __esm({
   }
 });
 
-// node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
+// node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
+  "node_modules/katex/dist/katex.min.css"() {
   }
 });
 exports.Tabs = void 0;
@@ -21484,14 +21530,19 @@ function ChoiceButton({
   disabled = false,
   selected = false,
   onClick,
+  action,
   className
 }) {
+  const eventBus = useEventBus();
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "button",
     {
       type: "button",
       disabled,
-      onClick,
+      onClick: (e) => {
+        if (action) eventBus.emit(`UI:${action}`, {});
+        onClick?.();
+      },
       className: cn(
         "w-full text-left px-4 py-2.5 rounded-interactive border transition-all duration-150",
         "flex items-center gap-2",
@@ -21539,6 +21590,7 @@ var init_ChoiceButton = __esm({
   "components/game/2d/atoms/ChoiceButton.tsx"() {
     init_cn();
     init_Icon();
+    init_useEventBus();
     ChoiceButton.displayName = "ChoiceButton";
   }
 });
@@ -22584,6 +22636,7 @@ function ControlGrid({
   actionEvent,
   onDirection,
   directionEvent,
+  directionAssets,
   size = "md",
   disabled,
   className
@@ -22623,7 +22676,8 @@ function ControlGrid({
     const dir = (d) => /* @__PURE__ */ jsxRuntime.jsx(
       ControlButton,
       {
-        icon: arrowIcons[d],
+        icon: directionAssets?.[d] ? void 0 : arrowIcons[d],
+        assetUrl: directionAssets?.[d],
         size: sizeKey[size],
         variant: "secondary",
         pressed: active.has(d),
@@ -22764,6 +22818,8 @@ function CounterMinimal({
   size = "md",
   onDecrement,
   onIncrement,
+  decrementEvent,
+  incrementEvent,
   className
 }) {
   const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
@@ -22774,6 +22830,7 @@ function CounterMinimal({
       {
         variant: "secondary",
         size: sizeStyles8[size].button,
+        action: decrementEvent,
         onClick: onDecrement,
         disabled: resolved.decrementDisabled,
         icon: "minus",
@@ -22796,6 +22853,7 @@ function CounterMinimal({
       {
         variant: "secondary",
         size: sizeStyles8[size].button,
+        action: incrementEvent,
         onClick: onIncrement,
         disabled: resolved.incrementDisabled,
         icon: "plus",
@@ -22812,6 +22870,9 @@ function CounterStandard({
   onDecrement,
   onIncrement,
   onReset,
+  decrementEvent,
+  incrementEvent,
+  resetEvent,
   className
 }) {
   const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
@@ -22842,6 +22903,7 @@ function CounterStandard({
         {
           variant: "secondary",
           size: sizeStyles8[size].button,
+          action: decrementEvent,
           onClick: onDecrement,
           disabled: resolved.decrementDisabled,
           icon: "minus"
@@ -22852,6 +22914,7 @@ function CounterStandard({
         {
           variant: "primary",
           size: sizeStyles8[size].button,
+          action: incrementEvent,
           onClick: onIncrement,
           disabled: resolved.incrementDisabled,
           icon: "plus"
@@ -22863,6 +22926,7 @@ function CounterStandard({
       {
         variant: "ghost",
         size: "sm",
+        action: resetEvent,
         onClick: onReset,
         icon: "rotate-ccw",
         children: "Reset"
@@ -22878,6 +22942,9 @@ function CounterFull({
   onDecrement,
   onIncrement,
   onReset,
+  decrementEvent,
+  incrementEvent,
+  resetEvent,
   className
 }) {
   const resolved = entity && typeof entity === "object" && !Array.isArray(entity) ? entity : void 0;
@@ -22911,6 +22978,7 @@ function CounterFull({
         {
           variant: "secondary",
           size: sizeStyles8[size].button,
+          action: decrementEvent,
           onClick: onDecrement,
           disabled: resolved.decrementDisabled,
           icon: "minus",
@@ -22922,6 +22990,7 @@ function CounterFull({
         {
           variant: "primary",
           size: sizeStyles8[size].button,
+          action: incrementEvent,
           onClick: onIncrement,
           disabled: resolved.incrementDisabled,
           icon: "plus",
@@ -22934,6 +23003,7 @@ function CounterFull({
       {
         variant: "ghost",
         size: "sm",
+        action: resetEvent,
         onClick: onReset,
         icon: "rotate-ccw",
         children: "Reset to 0"
@@ -29630,14 +29700,15 @@ function TimerDisplay({
   format = "mm:ss",
   size = "md",
   className,
-  lowThreshold
+  lowThreshold,
+  iconAsset
 }) {
   const isLow = lowThreshold != null && seconds <= lowThreshold && seconds > 0;
-  return /* @__PURE__ */ jsxRuntime.jsx(
+  return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
       className: cn(
-        "inline-flex items-center justify-center rounded-container",
+        "inline-flex items-center gap-1 justify-center rounded-container",
         "bg-card/80 border border-muted font-mono font-bold tabular-nums",
         sizeMap9[size],
         running && "border-success/50",
@@ -29645,7 +29716,10 @@ function TimerDisplay({
         !isLow && "text-foreground",
         className
       ),
-      children: formatTime(seconds, format)
+      children: [
+        iconAsset && /* @__PURE__ */ jsxRuntime.jsx("img", { src: iconAsset.url, alt: "", className: "w-4 h-4 object-contain flex-shrink-0" }),
+        formatTime(seconds, format)
+      ]
     }
   );
 }
@@ -29741,15 +29815,20 @@ function ItemSlot({
   size = "md",
   selected,
   onClick,
+  action,
   className
 }) {
-  const isClickable = onClick != null;
+  const eventBus = useEventBus();
+  const isClickable = onClick != null || action != null;
   const px = assetSizeMap[size];
   return /* @__PURE__ */ jsxRuntime.jsx(
     "button",
     {
       type: "button",
-      onClick,
+      onClick: () => {
+        if (action) eventBus.emit(`UI:${action}`, {});
+        onClick?.();
+      },
       disabled: !isClickable,
       title: label,
       className: cn(
@@ -29797,6 +29876,7 @@ var init_ItemSlot = __esm({
     "use client";
     init_cn();
     init_Icon();
+    init_useEventBus();
     sizeMap11 = {
       sm: "w-10 h-10 text-lg",
       md: "w-14 h-14 text-2xl",
@@ -30223,7 +30303,7 @@ function InventoryGrid({
     (id) => {
       onSelect?.(id);
       if (selectEvent) {
-        eventBus.emit(selectEvent, { id });
+        eventBus.emit(`UI:${selectEvent}`, { id });
       }
     },
     [onSelect, selectEvent, eventBus]
@@ -30428,27 +30508,21 @@ function GameMenu({
   options,
   menuItems,
   onSelect,
-  eventBus: eventBusProp,
   background,
-  logo = "",
+  logo,
   className
 }) {
   const resolvedOptions = options ?? menuItems ?? DEFAULT_MENU_OPTIONS;
-  let eventBusFromHook = null;
-  try {
-    eventBusFromHook = useEventBus();
-  } catch {
-  }
-  const eventBus = eventBusProp || eventBusFromHook;
+  const eventBus = useEventBus();
   const handleOptionClick = React79__namespace.useCallback(
     (option) => {
-      if (option.event && eventBus) {
+      if (option.event) {
         eventBus.emit(`UI:${option.event}`, { option });
       }
       if (onSelect) {
         onSelect(option);
       }
-      if (option.navigatesTo && eventBus) {
+      if (option.navigatesTo) {
         eventBus.emit("UI:NAVIGATE", { url: option.navigatesTo, option });
       }
     },
@@ -30469,7 +30543,7 @@ function GameMenu({
           logo && /* @__PURE__ */ jsxRuntime.jsx(
             "img",
             {
-              src: logo,
+              src: logo.url,
               alt: title,
               className: "h-24 w-auto mx-auto mb-6 drop-shadow-2xl"
             }
@@ -30929,7 +31003,9 @@ var init_GameAudioProvider = __esm({
 });
 function GameAudioToggle({
   size = "sm",
-  className
+  className,
+  onAsset,
+  offAsset
 }) {
   const ctx = useGameAudioContextOptional();
   const [localMuted, setLocalMuted] = React79.useState(false);
@@ -30938,6 +31014,7 @@ function GameAudioToggle({
   const handleToggle = React79.useCallback(() => {
     setMuted(!muted);
   }, [muted, setMuted]);
+  const activeAsset = muted ? offAsset : onAsset;
   return /* @__PURE__ */ jsxRuntime.jsx(
     exports.Button,
     {
@@ -30946,7 +31023,7 @@ function GameAudioToggle({
       onClick: handleToggle,
       className: cn("text-lg leading-none px-2", className),
       "aria-pressed": muted,
-      children: muted ? "\u{1F507}" : "\u{1F50A}"
+      children: activeAsset ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: activeAsset.url, alt: muted ? "Muted" : "Sound on", className: "w-5 h-5 object-contain" }) : muted ? "\u{1F507}" : "\u{1F50A}"
     }
   );
 }
@@ -31535,6 +31612,7 @@ function PlatformerBoard({
   canvasHeight: _canvasHeight = 400,
   playerSprite,
   tileSprites,
+  ui: _ui,
   bgColor: _bgColor,
   keyEvent = "KEY",
   playAgainEvent = "PLAY_AGAIN",
@@ -32959,6 +33037,7 @@ function TanksBoard({
   features,
   assetManifest,
   assetBaseUrl,
+  ui: _ui,
   scale = 0.45,
   showMinimap = true,
   enableCamera = true,
@@ -33666,7 +33745,7 @@ function TraitSlot({
   size = "md",
   showTooltip = true,
   categoryColors,
-  tooltipFrameUrl = "",
+  tooltipFrameUrl,
   className,
   feedback,
   onItemDrop,
@@ -33796,7 +33875,7 @@ function TraitSlot({
               as: "img",
               className: "object-contain",
               style: { width: config.icon, height: config.icon },
-              ...{ src: equippedItem.iconUrl, alt: equippedItem.name }
+              ...{ src: equippedItem.iconUrl.url, alt: equippedItem.name }
             }
           ) : /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "body1", className: "text-center leading-none", style: { fontSize: config.icon }, children: equippedItem.iconEmoji || "\u2726" }),
           (onRemove || removeEvent) && /* @__PURE__ */ jsxRuntime.jsx(
@@ -33825,7 +33904,7 @@ function TraitSlot({
               ...getTooltipStyle(),
               minWidth: 200,
               ...tooltipFrameUrl ? {
-                borderImage: `url(${tooltipFrameUrl}) 60 fill / 15px / 0 stretch`,
+                borderImage: `url(${tooltipFrameUrl.url}) 60 fill / 15px / 0 stretch`,
                 border: "none"
               } : {}
             },
@@ -34122,6 +34201,42 @@ function computeSlotFeedback(playerSeq, solutions) {
     (id, i) => id !== void 0 && id === bestSolution[i] ? "correct" : "wrong"
   );
 }
+function isFieldRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v) && !(v instanceof Date);
+}
+function assetFromField(v) {
+  if (!isFieldRecord(v)) return void 0;
+  const url = typeof v.url === "string" ? v.url : void 0;
+  const role = typeof v.role === "string" ? v.role : void 0;
+  const category = typeof v.category === "string" ? v.category : "";
+  if (!url || !role) return void 0;
+  return {
+    url,
+    role,
+    category,
+    name: typeof v.name === "string" ? v.name : void 0,
+    thumbnailUrl: typeof v.thumbnailUrl === "string" ? v.thumbnailUrl : void 0,
+    style: typeof v.style === "string" ? v.style : void 0,
+    variant: typeof v.variant === "string" ? v.variant : void 0,
+    dimension: typeof v.dimension === "string" ? v.dimension : void 0,
+    aspect: typeof v.aspect === "string" ? v.aspect : void 0
+  };
+}
+function slotItemFromField(fv) {
+  if (!isFieldRecord(fv)) return void 0;
+  const id = typeof fv.id === "string" ? fv.id : void 0;
+  const name = typeof fv.name === "string" ? fv.name : void 0;
+  const category = typeof fv.category === "string" ? fv.category : void 0;
+  if (!id || !name || !category) return void 0;
+  return {
+    id,
+    name,
+    category,
+    description: typeof fv.description === "string" ? fv.description : void 0,
+    iconEmoji: typeof fv.iconEmoji === "string" ? fv.iconEmoji : void 0,
+    iconUrl: assetFromField(fv.iconUrl)
+  };
+}
 function SequencerBoard({
   entity,
   categoryColors,
@@ -34132,6 +34247,7 @@ function SequencerBoard({
   removeEvent,
   checkEvent,
   playAgainEvent,
+  stepEvent,
   className
 }) {
   const { emit } = useEventBus();
@@ -34139,7 +34255,11 @@ function SequencerBoard({
   const resolved = boardEntity(entity);
   const maxSlots = num(resolved?.maxSlots) || 3;
   const solutions = Array.isArray(resolved?.solutions) ? resolved.solutions : [];
-  const availableActions = Array.isArray(resolved?.availableActions) ? resolved.availableActions : [];
+  const availableActions = (Array.isArray(resolved?.availableActions) ? resolved.availableActions : []).reduce((acc, fv) => {
+    const item = slotItemFromField(fv);
+    if (item) acc.push(item);
+    return acc;
+  }, []);
   const allowDuplicates = resolved?.allowDuplicates !== false;
   const entitySlots = Array.isArray(resolved?.slots) ? resolved.slots : [];
   const entityResult = str(resolved?.result);
@@ -34197,7 +34317,7 @@ function SequencerBoard({
     let step = 0;
     const advance = () => {
       step++;
-      emit("UI:STEP", { step });
+      if (stepEvent) emit(`UI:${stepEvent}`, { step });
       if (step >= maxSlots) {
         if (checkEvent) emit(`UI:${checkEvent}`, { sequence: playerIds });
         const playerSeq = slots.map((s) => s?.id);
@@ -36096,24 +36216,55 @@ function SimulationControls({
   onReset,
   onSpeedChange,
   onParameterChange,
+  playEvent,
+  pauseEvent,
+  stepEvent,
+  resetEvent,
+  speedChangeEvent,
+  parameterChangeEvent,
   assetManifest,
   className
 }) {
+  const eventBus = useEventBus();
   const ui = assetManifest?.ui;
+  const handlePlay = () => {
+    if (playEvent) eventBus.emit(`UI:${playEvent}`, {});
+    onPlay?.();
+  };
+  const handlePause = () => {
+    if (pauseEvent) eventBus.emit(`UI:${pauseEvent}`, {});
+    onPause?.();
+  };
+  const handleStep = () => {
+    if (stepEvent) eventBus.emit(`UI:${stepEvent}`, {});
+    onStep?.();
+  };
+  const handleReset = () => {
+    if (resetEvent) eventBus.emit(`UI:${resetEvent}`, {});
+    onReset?.();
+  };
+  const handleSpeedChange = (s) => {
+    if (speedChangeEvent) eventBus.emit(`UI:${speedChangeEvent}`, { speed: s });
+    onSpeedChange?.(s);
+  };
+  const handleParameterChange = (name, value) => {
+    if (parameterChangeEvent) eventBus.emit(`UI:${parameterChangeEvent}`, { name, value });
+    onParameterChange?.(name, value);
+  };
   return /* @__PURE__ */ jsxRuntime.jsxs(exports.VStack, { gap: "md", className, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(exports.HStack, { gap: "sm", align: "center", children: [
-      running ? /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "secondary", onClick: onPause, children: [
+      running ? /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "secondary", onClick: handlePause, children: [
         /* @__PURE__ */ jsxRuntime.jsx(GameIcon, { icon: LucideIcons2.Pause, assetUrl: ui?.["pause"], size: "sm" }),
         "Pause"
-      ] }) : /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "primary", onClick: onPlay, children: [
+      ] }) : /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "primary", onClick: handlePlay, children: [
         /* @__PURE__ */ jsxRuntime.jsx(GameIcon, { icon: LucideIcons2.Play, assetUrl: ui?.["play"], size: "sm" }),
         "Play"
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "ghost", onClick: onStep, disabled: running, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "ghost", onClick: handleStep, disabled: running, children: [
         /* @__PURE__ */ jsxRuntime.jsx(GameIcon, { icon: LucideIcons2.SkipForward, assetUrl: ui?.["step"], size: "sm" }),
         "Step"
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "ghost", onClick: onReset, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(exports.Button, { size: "sm", variant: "ghost", onClick: handleReset, children: [
         /* @__PURE__ */ jsxRuntime.jsx(GameIcon, { icon: LucideIcons2.RotateCcw, assetUrl: ui?.["reset"], size: "sm" }),
         "Reset"
       ] })
@@ -36132,7 +36283,7 @@ function SimulationControls({
           max: 5,
           step: 0.1,
           value: speed,
-          onChange: (e) => onSpeedChange(parseFloat(e.target.value)),
+          onChange: (e) => handleSpeedChange(parseFloat(e.target.value)),
           className: "w-full"
         }
       )
@@ -36151,7 +36302,7 @@ function SimulationControls({
           max: param.max,
           step: param.step,
           value: param.value,
-          onChange: (e) => onParameterChange(name, parseFloat(e.target.value)),
+          onChange: (e) => handleParameterChange(name, parseFloat(e.target.value)),
           className: "w-full"
         }
       )
@@ -36160,6 +36311,7 @@ function SimulationControls({
 }
 var init_SimulationControls = __esm({
   "components/game/2d/organisms/SimulationControls.tsx"() {
+    init_useEventBus();
     init_atoms();
     init_GameIcon();
     SimulationControls.displayName = "SimulationControls";
@@ -36228,35 +36380,7 @@ var init_SimulationGraph = __esm({
     SimulationGraph.displayName = "SimulationGraph";
   }
 });
-function getSlotContentRenderer() {
-  if (_scr) return _scr;
-  const mod = (init_UISlotRenderer(), __toCommonJS(UISlotRenderer_exports));
-  _scr = mod.SlotContentRenderer;
-  return _scr;
-}
-function resolveDescriptor(value, idPrefix) {
-  if (value === null || value === void 0) return value;
-  if (React79__namespace.default.isValidElement(value)) return value;
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-  if (Array.isArray(value)) {
-    return value.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(React79__namespace.default.Fragment, { children: resolveDescriptor(item, `${idPrefix}-${i}`) }, i));
-  }
-  if (typeof value === "object") {
-    const rec = value;
-    if (typeof rec.type === "string" && patterns.getComponentForPattern(rec.type) !== null) {
-      const type = rec.type;
-      const _id = typeof rec._id === "string" ? rec._id : void 0;
-      const nestedProps = rec.props !== void 0 && typeof rec.props === "object" && !Array.isArray(rec.props) && rec.props !== null ? rec.props : void 0;
-      const { type: _t, props: _p, _id: _d, ...flatRest } = rec;
-      const resolvedProps = nestedProps !== void 0 ? nestedProps : flatRest;
-      const content = { id: _id ?? idPrefix, pattern: type, props: resolvedProps, priority: 0 };
-      const SCR = getSlotContentRenderer();
-      return /* @__PURE__ */ jsxRuntime.jsx(SCR, { content, onDismiss: () => void 0 });
-    }
-  }
-  return null;
-}
-var _scr; exports.GameTemplate = void 0;
+exports.GameTemplate = void 0;
 var init_GameTemplate = __esm({
   "components/game/2d/templates/GameTemplate.tsx"() {
     init_cn();
@@ -36264,7 +36388,6 @@ var init_GameTemplate = __esm({
     init_Stack();
     init_Typography();
     init_Button();
-    _scr = null;
     exports.GameTemplate = ({
       entity,
       title = "Game",
@@ -36273,7 +36396,8 @@ var init_GameTemplate = __esm({
       debugPanel,
       showDebugPanel = false,
       controls,
-      className
+      className,
+      backgroundAsset
     }) => {
       return /* @__PURE__ */ jsxRuntime.jsxs(
         exports.Box,
@@ -36330,15 +36454,16 @@ var init_GameTemplate = __esm({
                 {
                   position: "relative",
                   fullWidth: true,
-                  className: "flex-1 bg-muted",
+                  className: backgroundAsset ? "flex-1" : "flex-1 bg-muted",
+                  style: backgroundAsset ? { backgroundImage: `url(${backgroundAsset.url})`, backgroundSize: "cover", backgroundPosition: "center" } : void 0,
                   children: [
-                    resolveDescriptor(children, "gt-children"),
+                    children,
                     hud && /* @__PURE__ */ jsxRuntime.jsx(
                       exports.Box,
                       {
                         position: "absolute",
                         className: "top-0 left-0 right-0 pointer-events-none",
-                        children: /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { padding: "md", className: "pointer-events-auto w-fit", children: resolveDescriptor(hud, "gt-hud") })
+                        children: /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { padding: "md", className: "pointer-events-auto w-fit", children: hud })
                       }
                     )
                   ]
@@ -36363,7 +36488,7 @@ var init_GameTemplate = __esm({
                       children: /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "h6", children: "Debug Panel" })
                     }
                   ),
-                  /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { padding: "md", children: resolveDescriptor(debugPanel, "gt-debug") })
+                  /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { padding: "md", children: debugPanel })
                 ]
               }
             )
@@ -36374,59 +36499,21 @@ var init_GameTemplate = __esm({
     exports.GameTemplate.displayName = "GameTemplate";
   }
 });
-function asDescriptor(v) {
-  if (Array.isArray(v) || React79__namespace.default.isValidElement(v)) return null;
-  const o = v;
-  if (typeof o.type !== "string") return null;
-  const props = o.props !== void 0 && typeof o.props === "object" && !Array.isArray(o.props) && o.props !== null ? o.props : void 0;
-  const _id = typeof o._id === "string" ? o._id : void 0;
-  const sourceTrait = typeof o.sourceTrait === "string" ? o.sourceTrait : void 0;
-  return { type: o.type, props, _id, sourceTrait };
-}
-function getSlotContentRenderer2() {
-  if (_scr2) return _scr2;
-  const mod = (init_UISlotRenderer(), __toCommonJS(UISlotRenderer_exports));
-  _scr2 = mod.SlotContentRenderer;
-  return _scr2;
-}
-function resolveDescriptor2(value, idPrefix) {
-  if (value === null || value === void 0) return value;
-  if (React79__namespace.default.isValidElement(value)) return value;
-  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
-  if (Array.isArray(value)) {
-    return value.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(React79__namespace.default.Fragment, { children: resolveDescriptor2(item, `${idPrefix}-${i}`) }, i));
-  }
-  if (typeof value === "object" && value !== null) {
-    const desc = asDescriptor(value);
-    if (desc !== null && patterns.getComponentForPattern(desc.type) !== null) {
-      const resolvedProps = desc.props ?? {};
-      const content = {
-        id: desc._id ?? idPrefix,
-        pattern: desc.type,
-        props: resolvedProps,
-        priority: 0,
-        ...desc.sourceTrait !== void 0 && { sourceTrait: desc.sourceTrait }
-      };
-      const SCR = getSlotContentRenderer2();
-      return /* @__PURE__ */ jsxRuntime.jsx(SCR, { content, onDismiss: () => void 0 }, content.id);
-    }
-  }
-  return null;
-}
-var _scr2; exports.GameShell = void 0;
+exports.GameShell = void 0;
 var init_GameShell = __esm({
   "components/game/2d/templates/GameShell.tsx"() {
     init_cn();
     init_Box();
     init_Stack();
     init_Typography();
-    _scr2 = null;
     exports.GameShell = ({
       appName = "Game",
       hud,
       className,
       showTopBar = true,
-      children
+      children,
+      backgroundAsset,
+      hudBackgroundAsset
     }) => {
       return /* @__PURE__ */ jsxRuntime.jsxs(
         exports.Box,
@@ -36441,7 +36528,7 @@ var init_GameShell = __esm({
             width: "100vw",
             height: "100vh",
             overflow: "hidden",
-            background: "var(--color-background, #0a0a0f)",
+            background: backgroundAsset ? `url(${backgroundAsset.url}) center/cover no-repeat` : "var(--color-background, #0a0a0f)",
             color: "var(--color-text, #e0e0e0)"
           },
           children: [
@@ -36451,7 +36538,7 @@ var init_GameShell = __esm({
                 className: "game-shell__header",
                 style: {
                   flexShrink: 0,
-                  background: "var(--color-surface, #12121f)",
+                  background: hudBackgroundAsset ? `url(${hudBackgroundAsset.url}) center/cover no-repeat` : "var(--color-surface, #12121f)",
                   borderBottom: "1px solid var(--color-border, #2a2a3a)"
                 },
                 children: [
@@ -36474,7 +36561,7 @@ var init_GameShell = __esm({
                       )
                     }
                   ),
-                  hud && /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: "game-shell__hud", style: { width: "100%" }, children: resolveDescriptor2(hud, "gs-hud") })
+                  hud && /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: "game-shell__hud", style: { width: "100%" }, children: hud })
                 ]
               }
             ),
@@ -36487,7 +36574,7 @@ var init_GameShell = __esm({
                   overflow: "hidden",
                   position: "relative"
                 },
-                children: resolveDescriptor2(children, "gs-children")
+                children
               }
             )
           ]
@@ -45161,6 +45248,7 @@ var init_WizardContainer = __esm({
     init_Stack();
     init_Icon();
     init_cn();
+    init_useEventBus();
     exports.WizardContainer = ({
       steps,
       currentStep: controlledStep,
@@ -45169,9 +45257,13 @@ var init_WizardContainer = __esm({
       showProgress = true,
       allowBack = true,
       compact = false,
-      className
+      className,
+      nextEvent,
+      backEvent,
+      completeEvent
     }) => {
       const { t } = hooks.useTranslate();
+      const eventBus = useEventBus();
       const [internalStep, setInternalStep] = React79.useState(0);
       const normalizedControlledStep = (() => {
         if (controlledStep === void 0 || controlledStep === null)
@@ -45201,13 +45293,16 @@ var init_WizardContainer = __esm({
           return;
         }
         if (isLastStep) {
+          if (completeEvent) eventBus.emit(`UI:${completeEvent}`, { step: currentStep });
           onComplete?.();
         } else {
+          if (nextEvent) eventBus.emit(`UI:${nextEvent}`, { step: currentStep + 1 });
           goToStep(currentStep + 1);
         }
       };
       const handleBack = () => {
         if (!isFirstStep && allowBack) {
+          if (backEvent) eventBus.emit(`UI:${backEvent}`, { step: currentStep - 1 });
           goToStep(currentStep - 1);
         }
       };
@@ -47892,14 +47987,18 @@ var init_DrawerSlot = __esm({
       title: overrideTitle,
       position = "right",
       size = "md",
-      className
+      className,
+      sourceTrait
     }) => {
       const eventBus = useEventBus();
+      const schemaCtx = providers.useEntitySchemaOptional();
       const isOpen = Boolean(children);
       const title = overrideTitle || extractTitle(children);
       const handleClose = () => {
-        eventBus.emit("UI:CLOSE");
-        eventBus.emit("UI:CANCEL");
+        const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+        const prefix = orbital !== void 0 && sourceTrait !== void 0 ? `UI:${orbital}.${sourceTrait}.` : "UI:";
+        eventBus.emit(`${prefix}CLOSE`);
+        eventBus.emit(`${prefix}CANCEL`);
       };
       if (!isOpen) return null;
       return /* @__PURE__ */ jsxRuntime.jsx(
@@ -49870,14 +49969,18 @@ var init_ModalSlot = __esm({
       children,
       title: overrideTitle,
       size = "md",
-      className
+      className,
+      sourceTrait
     }) => {
       const eventBus = useEventBus();
+      const schemaCtx = providers.useEntitySchemaOptional();
       const isOpen = Boolean(children);
       const title = overrideTitle || extractTitle2(children);
       const handleClose = () => {
-        eventBus.emit("UI:CLOSE");
-        eventBus.emit("UI:CANCEL");
+        const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+        const prefix = orbital !== void 0 && sourceTrait !== void 0 ? `UI:${orbital}.${sourceTrait}.` : "UI:";
+        eventBus.emit(`${prefix}CLOSE`);
+        eventBus.emit(`${prefix}CANCEL`);
       };
       if (!isOpen) return null;
       return /* @__PURE__ */ jsxRuntime.jsx(
@@ -53442,17 +53545,21 @@ var init_ToastSlot = __esm({
       variant: overrideVariant,
       title: overrideTitle,
       duration = 5e3,
-      className
+      className,
+      sourceTrait
     }) => {
       const eventBus = useEventBus();
+      const schemaCtx = providers.useEntitySchemaOptional();
       const isVisible = Boolean(children);
       const extracted = extractToastProps(children);
       const variant = overrideVariant || extracted.variant || "info";
       const title = overrideTitle || extracted.title;
       const message = extracted.message || (typeof children === "string" ? children : "");
       const handleDismiss = () => {
-        eventBus.emit("UI:DISMISS");
-        eventBus.emit("UI:CLOSE");
+        const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+        const prefix = orbital !== void 0 && sourceTrait !== void 0 ? `UI:${orbital}.${sourceTrait}.` : "UI:";
+        eventBus.emit(`${prefix}DISMISS`);
+        eventBus.emit(`${prefix}CLOSE`);
       };
       if (!isVisible) return null;
       const isCustomContent = React79__namespace.default.isValidElement(children) && !message;
@@ -54179,7 +54286,7 @@ function getSlotFallback(slot, config) {
   const variant = SLOT_SKELETON_MAP[slot] ?? "text";
   return /* @__PURE__ */ jsxRuntime.jsx(Skeleton, { variant });
 }
-function getComponentForPattern3(patternType) {
+function getComponentForPattern(patternType) {
   const mapping = patterns.getComponentForPattern(patternType);
   if (!mapping) {
     return null;
@@ -54388,6 +54495,7 @@ function UISlotComponent({
   const { t } = hooks.useTranslate();
   const suspenseConfig = React79.useContext(SuspenseConfigContext);
   const contained = React79.useContext(SlotContainedContext);
+  const schemaCtx = providers.useEntitySchemaOptional();
   const content = slots[slot];
   if (children !== void 0) {
     if (pattern === "clear") {
@@ -54433,8 +54541,11 @@ function UISlotComponent({
   }
   const handleDismiss = () => {
     if (slot === "modal" || slot === "drawer") {
-      eventBus.emit("UI:CLOSE");
-      eventBus.emit("UI:CANCEL");
+      const trait = content?.sourceTrait;
+      const orbital = trait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(trait) : void 0;
+      const prefix = orbital !== void 0 && trait !== void 0 ? `UI:${orbital}.${trait}.` : "UI:";
+      eventBus.emit(`${prefix}CLOSE`);
+      eventBus.emit(`${prefix}CANCEL`);
     }
     clear(slot);
   };
@@ -54488,6 +54599,7 @@ function CompiledPortal({ slot, className, pattern, sourceTrait, children }) {
   const slotsBus = context.useUISlots();
   const eventBus = useEventBus();
   const { t } = hooks.useTranslate();
+  const compiledPortalSchemaCtx = providers.useEntitySchemaOptional();
   React79.useEffect(() => {
     setPortalRoot(getOrCreatePortalRoot());
   }, []);
@@ -54496,8 +54608,10 @@ function CompiledPortal({ slot, className, pattern, sourceTrait, children }) {
   });
   const handleDismiss = () => {
     if (slot === "modal" || slot === "drawer") {
-      eventBus.emit("UI:CLOSE");
-      eventBus.emit("UI:CANCEL");
+      const orbital = sourceTrait !== void 0 && compiledPortalSchemaCtx !== null ? compiledPortalSchemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+      const prefix = orbital !== void 0 && sourceTrait !== void 0 ? `UI:${orbital}.${sourceTrait}.` : "UI:";
+      eventBus.emit(`${prefix}CLOSE`);
+      eventBus.emit(`${prefix}CANCEL`);
     }
     slotsBus.clear(slot);
   };
@@ -54809,7 +54923,7 @@ function SlotContentRenderer({
     }
   }
   const orbitalName = schemaCtx && content.sourceTrait !== void 0 ? schemaCtx.orbitalsByTrait.get(content.sourceTrait) : void 0;
-  const PatternComponent = getComponentForPattern3(content.pattern);
+  const PatternComponent = getComponentForPattern(content.pattern);
   if (PatternComponent) {
     const childrenConfig = content.props.children;
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
@@ -55056,6 +55170,7 @@ var init_UISlotRenderer = __esm({
       "custom",
       "dashboard-layout",
       "game-shell",
+      "game-template",
       "scaled-diagram",
       "master-detail",
       "form-field",
@@ -55095,7 +55210,7 @@ function TraitFrame({
   if (!content) {
     return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: fallback });
   }
-  const SlotContentRenderer2 = getSlotContentRenderer3();
+  const SlotContentRenderer2 = getSlotContentRenderer();
   const rendered = /* @__PURE__ */ jsxRuntime.jsx(
     SlotContentRenderer2,
     {
@@ -55109,7 +55224,7 @@ function TraitFrame({
   }
   return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: traitName, children: rendered });
 }
-function getSlotContentRenderer3() {
+function getSlotContentRenderer() {
   if (_slotContentRenderer) return _slotContentRenderer;
   const mod = (init_UISlotRenderer(), __toCommonJS(UISlotRenderer_exports));
   _slotContentRenderer = mod.SlotContentRenderer;