@almadar/ui 5.142.0 → 5.144.0

package/dist/providers/index.cjs

@@ -911,6 +911,10 @@ var init_Icon = __esm({
 function isTilesheet(a) {
   return typeof a.tileWidth === "number";
 }
+function isSpriteSheetAtlas(a) {
+  const s = a;
+  return typeof s.frameWidth === "number" && typeof s.frameHeight === "number" && typeof s.animations === "object";
+}
 function getAtlas(url, onReady) {
   if (atlasCache.has(url)) return atlasCache.get(url) ?? void 0;
   atlasCache.set(url, void 0);
@@ -950,6 +954,7 @@ function subRectFor(atlas, sprite) {
       sh: atlas.tileHeight
     };
   }
+  if (isSpriteSheetAtlas(atlas)) return null;
   const st = atlas.subTextures[sprite];
   if (!st) return null;
   return { sx: st.x, sy: st.y, sw: st.width, sh: st.height };
@@ -1259,7 +1264,7 @@ var init_Button = __esm({
             "data-testid": dataTestId ?? (action ? `action-${action}` : void 0),
             children: [
               isLoading ? /* @__PURE__ */ jsxRuntime.jsx(LucideIcons2.Loader2, { className: "h-icon-default w-icon-default animate-spin" }) : resolvedLeftIcon && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-shrink-0", children: resolvedLeftIcon }),
-              children || label,
+              (Array.isArray(children) ? children.length > 0 : Boolean(children)) ? children : label,
               resolvedRightIcon && !isLoading && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "flex-shrink-0", children: resolvedRightIcon })
             ]
           }
@@ -7300,6 +7305,34 @@ var init_isometric = __esm({
     };
   }
 });
+function isAnimationName(name) {
+  return core.ANIMATION_NAMES.includes(name);
+}
+function frameRect(frame, row, columns, frameWidth, frameHeight) {
+  return {
+    sx: frame % columns * frameWidth,
+    sy: row * frameHeight,
+    sw: frameWidth,
+    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 };
+}
+var init_spriteAnimation = __esm({
+  "lib/spriteAnimation.ts"() {
+  }
+});
 
 // lib/gameShared.ts
 var init_gameShared = __esm({
@@ -9160,6 +9193,9 @@ function paintFallbackSquare(painter, node, dctx, reason) {
   painter.strokeRect(rect.x, rect.y, rect.w, rect.h, "#5e564b", Math.max(1, tw / 32));
   painter.restore();
 }
+function isAnimatedSprite(node) {
+  return node.animation !== void 0 && typeof node.asset?.atlas === "string";
+}
 function DrawSprite(_props) {
   return null;
 }
@@ -9168,6 +9204,7 @@ var init_DrawSprite = __esm({
   "components/game/atoms/DrawSprite.tsx"() {
     "use client";
     init_atlasSlice();
+    init_spriteAnimation();
     init_imageCache();
     init_contract();
     spriteLog = logger.createLogger("almadar:ui:draw-sprite");
@@ -9181,6 +9218,23 @@ var init_DrawSprite = __esm({
         return;
       }
       let src = typeof node.frame === "object" ? node.frame : void 0;
+      if (!src && node.animation !== void 0 && typeof node.asset.atlas === "string") {
+        const atlas = getAtlas(node.asset.atlas, dctx.invalidate);
+        if (!atlas) {
+          if (atlasFailed(node.asset.atlas)) paintFallbackSquare(painter, node, dctx, "atlas-failed");
+          return;
+        }
+        if (isSpriteSheetAtlas(atlas)) {
+          const def = isAnimationName(node.animation) ? atlas.animations[node.animation] : void 0;
+          if (!def) {
+            paintFallbackSquare(painter, node, dctx, "sprite-missing");
+            return;
+          }
+          const { frame } = getCurrentFrameFromDef(node.loop === void 0 ? def : { ...def, loop: node.loop }, dctx.time);
+          const r = frameRect(frame, def.row, atlas.columns, atlas.frameWidth, atlas.frameHeight);
+          src = { x: r.sx, y: r.sy, w: r.sw, h: r.sh };
+        }
+      }
       if (!src && isAtlasAsset(node.asset)) {
         const atlas = getAtlas(node.asset.atlas, dctx.invalidate);
         if (!atlas) {
@@ -9472,6 +9526,83 @@ var init_DrawText = __esm({
     };
   }
 });
+function isAnimatedGroup(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+function DrawGroup(props) {
+  const register = React87.useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-group" });
+  return null;
+}
+var init_DrawGroup = __esm({
+  "components/game/atoms/DrawGroup.tsx"() {
+    "use client";
+    init_registry();
+  }
+});
+function applyMeshAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
+  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
+  const cycle = timeMs / anim.durationMs;
+  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
+  const trackValue = (key) => {
+    const defined = frames.filter((f3) => f3[key] !== void 0);
+    if (defined.length === 0) return void 0;
+    let prev;
+    let next;
+    for (const f3 of defined) {
+      if (f3.at <= t) prev = f3;
+      else if (!next) next = f3;
+    }
+    if (!prev) return defined[0][key];
+    if (!next) return prev[key];
+    const span = next.at - prev.at;
+    const k = span > 0 ? (t - prev.at) / span : 1;
+    const a = prev[key];
+    const b = next[key];
+    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
+    return a;
+  };
+  const num = {};
+  for (const key of NUMERIC_TRACKS2) {
+    const v = trackValue(key);
+    if (v !== void 0) num[key] = v;
+  }
+  return {
+    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
+    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
+    scale: num.scale ?? 1,
+    opacity: num.opacity,
+    emissiveIntensity: num.emissiveIntensity,
+    color: trackValue("color"),
+    emissive: trackValue("emissive")
+  };
+}
+function DrawMesh(props) {
+  const register = React87.useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-mesh" });
+  return null;
+}
+var lerp2, NUMERIC_TRACKS2;
+var init_DrawMesh = __esm({
+  "components/game/atoms/DrawMesh.tsx"() {
+    "use client";
+    init_registry();
+    lerp2 = (a, b, k) => a + (b - a) * k;
+    NUMERIC_TRACKS2 = [
+      "offsetX",
+      "offsetY",
+      "offsetZ",
+      "rotateX",
+      "rotateY",
+      "rotateZ",
+      "scale",
+      "opacity",
+      "emissiveIntensity"
+    ];
+  }
+});
 
 // components/game/molecules/DrawSpriteLayer.tsx
 function DrawSpriteLayer(_props) {
@@ -9538,18 +9669,22 @@ function paintDrawable(painter, node, dctx) {
       if (!isValidScenePos(node.position)) break;
       if (!Array.isArray(node.items)) break;
       const p = dctx.projector.project(node.position);
+      const anim = dctx.time > 0 && isAnimatedGroup(node) ? applyMeshAnimation(node, dctx.time) : null;
+      const tw = dctx.projector.tileWidth;
       painter.save();
-      painter.translate(p.x, p.y);
-      if (node.scale !== void 0) painter.scale(node.scale, node.scale);
-      if (node.rotate !== void 0) painter.rotate(node.rotate);
-      if (node.opacity !== void 0 && node.opacity !== 1) painter.setAlpha(node.opacity);
+      painter.translate(p.x + (anim ? anim.offset[0] * tw : 0), p.y + (anim ? anim.offset[1] * tw : 0));
+      const scale = (node.scale ?? 1) * (anim?.scale ?? 1);
+      if (scale !== 1) painter.scale(scale, scale);
+      const rotate = (node.rotate ?? 0) + (node.rotation?.[2] ?? 0) + (anim?.rotate[2] ?? 0);
+      if (rotate !== 0) painter.rotate(rotate);
+      const opacity = (node.opacity ?? 1) * (anim?.opacity ?? 1);
+      if (opacity !== 1) painter.setAlpha(opacity);
       if (node.clip) {
-        const tw = dctx.projector.tileWidth;
         painter.scale(tw, tw);
         painter.clipPath(node.clip);
         painter.scale(1 / tw, 1 / tw);
       }
-      const childCtx = node.scale !== void 0 && node.scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * node.scale } : dctx;
+      const childCtx = scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * scale } : dctx;
       for (const item of node.items) paintDrawable(painter, item, childCtx);
       painter.restore();
       break;
@@ -9575,6 +9710,8 @@ var init_paintDispatch = __esm({
     init_DrawSprite();
     init_DrawShape();
     init_DrawText();
+    init_DrawGroup();
+    init_DrawMesh();
     init_DrawSpriteLayer();
     init_DrawShapeLayer();
     init_DrawTextLayer();
@@ -9821,8 +9958,11 @@ function Canvas2D({
   const miniMapHeight = gridExtent.height || 10;
   const drawableIsAnimated = (node) => {
     if (node.type === "draw-shape") return isAnimatedShape(node);
-    if (node.type === "draw-group") return Array.isArray(node.items) && node.items.some(drawableIsAnimated);
+    if (node.type === "draw-sprite") return isAnimatedSprite(node);
+    if (node.type === "draw-group")
+      return isAnimatedGroup(node) || Array.isArray(node.items) && node.items.some(drawableIsAnimated);
     if (node.type === "draw-shape-layer") return Array.isArray(node.items) && node.items.some(isAnimatedShape);
+    if (node.type === "draw-sprite-layer") return Array.isArray(node.items) && node.items.some(isAnimatedSprite);
     return false;
   };
   const animRafRef = React87.useRef(0);
@@ -10163,6 +10303,8 @@ var init_Canvas2D = __esm({
     init_projector();
     init_paintDispatch();
     init_DrawShape();
+    init_DrawSprite();
+    init_DrawGroup();
     init_registry();
     init_hitTest();
     init_isometric();
@@ -10235,6 +10377,7 @@ function Canvas({
       cameraMode: to3DCameraMode(camera?.mode),
       ...zoom !== void 0 ? { scale: zoom } : {},
       ...camera?.fov !== void 0 ? { fov: camera.fov } : {},
+      ...camera?.azimuth !== void 0 ? { azimuth: camera.azimuth } : {},
       ...camera?.target !== void 0 ? { followTarget: camera.target } : {},
       unitScale,
       backgroundColor,
@@ -22981,6 +23124,14 @@ var init_DashboardLayout = __esm({
     NavLinkBottom.displayName = "NavLinkBottom";
   }
 });
+function downloadItemUrl(url, label) {
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = url.startsWith("data:") ? label : url.split("/").pop() ?? "download";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+}
 function computeMenuStyle(position, triggerRect) {
   const isTop = position.startsWith("top");
   const isRight = position.endsWith("right") || position.endsWith("end");
@@ -23033,6 +23184,7 @@ function SubMenu({
             onClick: () => {
               if (item.disabled) return;
               if (item.event) eventBus.emit(`UI:${item.event}`, { itemId, label: item.label });
+              if (item.url) downloadItemUrl(item.url, item.label);
               item.onClick?.();
             },
             "aria-disabled": item.disabled || void 0,
@@ -23186,6 +23338,7 @@ var init_Menu = __esm({
           setActiveSubMenu(itemId);
         } else {
           if (item.event) eventBus.emit(`UI:${item.event}`, { itemId, label: item.label });
+          if (item.url) downloadItemUrl(item.url, item.label);
           item.onClick?.();
           setIsOpen(false);
         }
@@ -23221,12 +23374,19 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React87__namespace.default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React87__namespace.default.cloneElement(
-        triggerChild,
+      const triggerElement = React87__namespace.default.isValidElement(trigger) ? React87__namespace.default.cloneElement(trigger, {
+        ref: triggerRef,
+        onClick: handleToggle
+      }) : /* @__PURE__ */ jsxRuntime.jsx(
+        Box,
         {
-          ref: triggerRef,
-          onClick: handleToggle
+          as: "span",
+          ref: (el) => {
+            triggerRef.current = el;
+          },
+          onClick: handleToggle,
+          className: "inline-flex",
+          children: typeof trigger === "string" || typeof trigger === "number" ? /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", as: "span", children: trigger }) : trigger
         }
       );
       const renderMenuItems = (menuItems) => menuItems.map((item, index) => {
@@ -39068,28 +39228,6 @@ var init_DetailPanel = __esm({
     DetailPanel.displayName = "DetailPanel";
   }
 });
-function DrawGroup(props) {
-  const register = React87.useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-group" });
-  return null;
-}
-var init_DrawGroup = __esm({
-  "components/game/atoms/DrawGroup.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
-function DrawMesh(props) {
-  const register = React87.useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-mesh" });
-  return null;
-}
-var init_DrawMesh = __esm({
-  "components/game/atoms/DrawMesh.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
 function extractTitle(children) {
   if (!React87__namespace.default.isValidElement(children)) return void 0;
   const props = children.props;

package/dist/providers/index.js

@@ -3,7 +3,7 @@ import React87__default, { createContext, useContext, useMemo, useRef, useEffect
 import { EventBusContext, useTraitScopeChain, useEntitySchemaOptional, useEntityBindingSnapshot, useTraitScope, TraitScopeProvider, useCurrentPagePath, useGameAudioContextOptional } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import { createContextFromBindings, interpolateValue } from '@almadar/runtime';
-import { ANONYMOUS_USER, isRenderBindingMarker, isInlineTrait } from '@almadar/core';
+import { ANONYMOUS_USER, isRenderBindingMarker, isInlineTrait, ANIMATION_NAMES } from '@almadar/core';
 export { ANONYMOUS_USER } from '@almadar/core';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
@@ -837,6 +837,10 @@ var init_Icon = __esm({
 function isTilesheet(a) {
   return typeof a.tileWidth === "number";
 }
+function isSpriteSheetAtlas(a) {
+  const s = a;
+  return typeof s.frameWidth === "number" && typeof s.frameHeight === "number" && typeof s.animations === "object";
+}
 function getAtlas(url, onReady) {
   if (atlasCache.has(url)) return atlasCache.get(url) ?? void 0;
   atlasCache.set(url, void 0);
@@ -876,6 +880,7 @@ function subRectFor(atlas, sprite) {
       sh: atlas.tileHeight
     };
   }
+  if (isSpriteSheetAtlas(atlas)) return null;
   const st = atlas.subTextures[sprite];
   if (!st) return null;
   return { sx: st.x, sy: st.y, sw: st.width, sh: st.height };
@@ -1185,7 +1190,7 @@ var init_Button = __esm({
             "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,
+              (Array.isArray(children) ? children.length > 0 : Boolean(children)) ? children : label,
               resolvedRightIcon && !isLoading && /* @__PURE__ */ jsx("span", { className: "flex-shrink-0", children: resolvedRightIcon })
             ]
           }
@@ -7226,6 +7231,34 @@ var init_isometric = __esm({
     };
   }
 });
+function isAnimationName(name) {
+  return ANIMATION_NAMES.includes(name);
+}
+function frameRect(frame, row, columns, frameWidth, frameHeight) {
+  return {
+    sx: frame % columns * frameWidth,
+    sy: row * frameHeight,
+    sw: frameWidth,
+    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 };
+}
+var init_spriteAnimation = __esm({
+  "lib/spriteAnimation.ts"() {
+  }
+});
 
 // lib/gameShared.ts
 var init_gameShared = __esm({
@@ -9086,6 +9119,9 @@ function paintFallbackSquare(painter, node, dctx, reason) {
   painter.strokeRect(rect.x, rect.y, rect.w, rect.h, "#5e564b", Math.max(1, tw / 32));
   painter.restore();
 }
+function isAnimatedSprite(node) {
+  return node.animation !== void 0 && typeof node.asset?.atlas === "string";
+}
 function DrawSprite(_props) {
   return null;
 }
@@ -9094,6 +9130,7 @@ var init_DrawSprite = __esm({
   "components/game/atoms/DrawSprite.tsx"() {
     "use client";
     init_atlasSlice();
+    init_spriteAnimation();
     init_imageCache();
     init_contract();
     spriteLog = createLogger("almadar:ui:draw-sprite");
@@ -9107,6 +9144,23 @@ var init_DrawSprite = __esm({
         return;
       }
       let src = typeof node.frame === "object" ? node.frame : void 0;
+      if (!src && node.animation !== void 0 && typeof node.asset.atlas === "string") {
+        const atlas = getAtlas(node.asset.atlas, dctx.invalidate);
+        if (!atlas) {
+          if (atlasFailed(node.asset.atlas)) paintFallbackSquare(painter, node, dctx, "atlas-failed");
+          return;
+        }
+        if (isSpriteSheetAtlas(atlas)) {
+          const def = isAnimationName(node.animation) ? atlas.animations[node.animation] : void 0;
+          if (!def) {
+            paintFallbackSquare(painter, node, dctx, "sprite-missing");
+            return;
+          }
+          const { frame } = getCurrentFrameFromDef(node.loop === void 0 ? def : { ...def, loop: node.loop }, dctx.time);
+          const r = frameRect(frame, def.row, atlas.columns, atlas.frameWidth, atlas.frameHeight);
+          src = { x: r.sx, y: r.sy, w: r.sw, h: r.sh };
+        }
+      }
       if (!src && isAtlasAsset(node.asset)) {
         const atlas = getAtlas(node.asset.atlas, dctx.invalidate);
         if (!atlas) {
@@ -9398,6 +9452,83 @@ var init_DrawText = __esm({
     };
   }
 });
+function isAnimatedGroup(node) {
+  return Boolean(node.animation && node.animation.durationMs > 0 && node.animation.keyframes.length > 0);
+}
+function DrawGroup(props) {
+  const register = useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-group" });
+  return null;
+}
+var init_DrawGroup = __esm({
+  "components/game/atoms/DrawGroup.tsx"() {
+    "use client";
+    init_registry();
+  }
+});
+function applyMeshAnimation(node, timeMs) {
+  const anim = node.animation;
+  if (!anim || !(anim.durationMs > 0) || anim.keyframes.length === 0) return null;
+  const frames = [...anim.keyframes].sort((a, b) => a.at - b.at);
+  const cycle = timeMs / anim.durationMs;
+  const t = anim.loop === false ? Math.min(cycle, 1) : cycle - Math.floor(cycle);
+  const trackValue = (key) => {
+    const defined = frames.filter((f3) => f3[key] !== void 0);
+    if (defined.length === 0) return void 0;
+    let prev;
+    let next;
+    for (const f3 of defined) {
+      if (f3.at <= t) prev = f3;
+      else if (!next) next = f3;
+    }
+    if (!prev) return defined[0][key];
+    if (!next) return prev[key];
+    const span = next.at - prev.at;
+    const k = span > 0 ? (t - prev.at) / span : 1;
+    const a = prev[key];
+    const b = next[key];
+    if (typeof a === "number" && typeof b === "number") return lerp2(a, b, k);
+    return a;
+  };
+  const num = {};
+  for (const key of NUMERIC_TRACKS2) {
+    const v = trackValue(key);
+    if (v !== void 0) num[key] = v;
+  }
+  return {
+    offset: [num.offsetX ?? 0, num.offsetY ?? 0, num.offsetZ ?? 0],
+    rotate: [num.rotateX ?? 0, num.rotateY ?? 0, num.rotateZ ?? 0],
+    scale: num.scale ?? 1,
+    opacity: num.opacity,
+    emissiveIntensity: num.emissiveIntensity,
+    color: trackValue("color"),
+    emissive: trackValue("emissive")
+  };
+}
+function DrawMesh(props) {
+  const register = useContext(DrawableRegistryContext);
+  if (register) register({ ...props, type: "draw-mesh" });
+  return null;
+}
+var lerp2, NUMERIC_TRACKS2;
+var init_DrawMesh = __esm({
+  "components/game/atoms/DrawMesh.tsx"() {
+    "use client";
+    init_registry();
+    lerp2 = (a, b, k) => a + (b - a) * k;
+    NUMERIC_TRACKS2 = [
+      "offsetX",
+      "offsetY",
+      "offsetZ",
+      "rotateX",
+      "rotateY",
+      "rotateZ",
+      "scale",
+      "opacity",
+      "emissiveIntensity"
+    ];
+  }
+});
 
 // components/game/molecules/DrawSpriteLayer.tsx
 function DrawSpriteLayer(_props) {
@@ -9464,18 +9595,22 @@ function paintDrawable(painter, node, dctx) {
       if (!isValidScenePos(node.position)) break;
       if (!Array.isArray(node.items)) break;
       const p = dctx.projector.project(node.position);
+      const anim = dctx.time > 0 && isAnimatedGroup(node) ? applyMeshAnimation(node, dctx.time) : null;
+      const tw = dctx.projector.tileWidth;
       painter.save();
-      painter.translate(p.x, p.y);
-      if (node.scale !== void 0) painter.scale(node.scale, node.scale);
-      if (node.rotate !== void 0) painter.rotate(node.rotate);
-      if (node.opacity !== void 0 && node.opacity !== 1) painter.setAlpha(node.opacity);
+      painter.translate(p.x + (anim ? anim.offset[0] * tw : 0), p.y + (anim ? anim.offset[1] * tw : 0));
+      const scale = (node.scale ?? 1) * (anim?.scale ?? 1);
+      if (scale !== 1) painter.scale(scale, scale);
+      const rotate = (node.rotate ?? 0) + (node.rotation?.[2] ?? 0) + (anim?.rotate[2] ?? 0);
+      if (rotate !== 0) painter.rotate(rotate);
+      const opacity = (node.opacity ?? 1) * (anim?.opacity ?? 1);
+      if (opacity !== 1) painter.setAlpha(opacity);
       if (node.clip) {
-        const tw = dctx.projector.tileWidth;
         painter.scale(tw, tw);
         painter.clipPath(node.clip);
         painter.scale(1 / tw, 1 / tw);
       }
-      const childCtx = node.scale !== void 0 && node.scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * node.scale } : dctx;
+      const childCtx = scale !== 1 ? { ...dctx, groupScale: (dctx.groupScale ?? 1) * scale } : dctx;
       for (const item of node.items) paintDrawable(painter, item, childCtx);
       painter.restore();
       break;
@@ -9501,6 +9636,8 @@ var init_paintDispatch = __esm({
     init_DrawSprite();
     init_DrawShape();
     init_DrawText();
+    init_DrawGroup();
+    init_DrawMesh();
     init_DrawSpriteLayer();
     init_DrawShapeLayer();
     init_DrawTextLayer();
@@ -9747,8 +9884,11 @@ function Canvas2D({
   const miniMapHeight = gridExtent.height || 10;
   const drawableIsAnimated = (node) => {
     if (node.type === "draw-shape") return isAnimatedShape(node);
-    if (node.type === "draw-group") return Array.isArray(node.items) && node.items.some(drawableIsAnimated);
+    if (node.type === "draw-sprite") return isAnimatedSprite(node);
+    if (node.type === "draw-group")
+      return isAnimatedGroup(node) || Array.isArray(node.items) && node.items.some(drawableIsAnimated);
     if (node.type === "draw-shape-layer") return Array.isArray(node.items) && node.items.some(isAnimatedShape);
+    if (node.type === "draw-sprite-layer") return Array.isArray(node.items) && node.items.some(isAnimatedSprite);
     return false;
   };
   const animRafRef = useRef(0);
@@ -10089,6 +10229,8 @@ var init_Canvas2D = __esm({
     init_projector();
     init_paintDispatch();
     init_DrawShape();
+    init_DrawSprite();
+    init_DrawGroup();
     init_registry();
     init_hitTest();
     init_isometric();
@@ -10161,6 +10303,7 @@ function Canvas({
       cameraMode: to3DCameraMode(camera?.mode),
       ...zoom !== void 0 ? { scale: zoom } : {},
       ...camera?.fov !== void 0 ? { fov: camera.fov } : {},
+      ...camera?.azimuth !== void 0 ? { azimuth: camera.azimuth } : {},
       ...camera?.target !== void 0 ? { followTarget: camera.target } : {},
       unitScale,
       backgroundColor,
@@ -22907,6 +23050,14 @@ var init_DashboardLayout = __esm({
     NavLinkBottom.displayName = "NavLinkBottom";
   }
 });
+function downloadItemUrl(url, label) {
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = url.startsWith("data:") ? label : url.split("/").pop() ?? "download";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+}
 function computeMenuStyle(position, triggerRect) {
   const isTop = position.startsWith("top");
   const isRight = position.endsWith("right") || position.endsWith("end");
@@ -22959,6 +23110,7 @@ function SubMenu({
             onClick: () => {
               if (item.disabled) return;
               if (item.event) eventBus.emit(`UI:${item.event}`, { itemId, label: item.label });
+              if (item.url) downloadItemUrl(item.url, item.label);
               item.onClick?.();
             },
             "aria-disabled": item.disabled || void 0,
@@ -23112,6 +23264,7 @@ var init_Menu = __esm({
           setActiveSubMenu(itemId);
         } else {
           if (item.event) eventBus.emit(`UI:${item.event}`, { itemId, label: item.label });
+          if (item.url) downloadItemUrl(item.url, item.label);
           item.onClick?.();
           setIsOpen(false);
         }
@@ -23147,12 +23300,19 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React87__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React87__default.cloneElement(
-        triggerChild,
+      const triggerElement = React87__default.isValidElement(trigger) ? React87__default.cloneElement(trigger, {
+        ref: triggerRef,
+        onClick: handleToggle
+      }) : /* @__PURE__ */ jsx(
+        Box,
         {
-          ref: triggerRef,
-          onClick: handleToggle
+          as: "span",
+          ref: (el) => {
+            triggerRef.current = el;
+          },
+          onClick: handleToggle,
+          className: "inline-flex",
+          children: typeof trigger === "string" || typeof trigger === "number" ? /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger }) : trigger
         }
       );
       const renderMenuItems = (menuItems) => menuItems.map((item, index) => {
@@ -38994,28 +39154,6 @@ var init_DetailPanel = __esm({
     DetailPanel.displayName = "DetailPanel";
   }
 });
-function DrawGroup(props) {
-  const register = useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-group" });
-  return null;
-}
-var init_DrawGroup = __esm({
-  "components/game/atoms/DrawGroup.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
-function DrawMesh(props) {
-  const register = useContext(DrawableRegistryContext);
-  if (register) register({ ...props, type: "draw-mesh" });
-  return null;
-}
-var init_DrawMesh = __esm({
-  "components/game/atoms/DrawMesh.tsx"() {
-    "use client";
-    init_registry();
-  }
-});
 function extractTitle(children) {
   if (!React87__default.isValidElement(children)) return void 0;
   const props = children.props;