@almadar/ui 5.49.0 → 5.50.0

package/dist/providers/index.js

@@ -1,16 +1,16 @@
-import * as React83 from 'react';
-import React83__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId, useSyncExternalStore, forwardRef, useImperativeHandle, Component } from 'react';
+import * as React82 from 'react';
+import React82__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId, useSyncExternalStore, forwardRef, useImperativeHandle, Component } from 'react';
+import { EventBusContext, useTraitScope, TraitScopeProvider } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { EventBusContext, useTraitScope, TraitScopeProvider } from '@almadar/ui/providers';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, Code, FileText, WrapText, Check, Copy, RotateCcw, Play, Terminal, XCircle, AlertTriangle, Trash2, Link2, ZoomOut, ZoomIn, Download, Menu as Menu$1, Package, Calendar, MoreHorizontal, Image as Image$1, Upload, ArrowLeft, HelpCircle, PauseCircle, Search, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, Minus, Eraser, TrendingUp, TrendingDown, AlertCircle, Circle, Clock, CheckCircle2, Bug, Send, ChevronUp, ChevronDown, Wrench, Tag, User, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { createPortal } from 'react-dom';
 import { useTranslate } from '@almadar/ui/hooks';
+import { useUISlots, ThemeProvider, useTheme } from '@almadar/ui/context';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
-import { useUISlots } from '@almadar/ui/context';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
@@ -41,12 +41,12 @@ import { DndContext, pointerWithin, rectIntersection, closestCorners, useSensors
 import { useSortable, arrayMove, sortableKeyboardCoordinates, SortableContext, rectSortingStrategy, verticalListSortingStrategy } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
 import { useNodeId, ReactFlowProvider, Handle, Position } from '@xyflow/react';
-import * as THREE from 'three';
+import * as THREE3 from 'three';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
 import { GLTFLoader as GLTFLoader$1 } from 'three/examples/jsm/loaders/GLTFLoader';
-import { Canvas, useThree } from '@react-three/fiber';
-import { Grid as Grid$1, OrbitControls } from '@react-three/drei';
+import { Canvas, useLoader, useFrame, useThree } from '@react-three/fiber';
+import { Billboard, Grid as Grid$1, OrbitControls } from '@react-three/drei';
 import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
 
 var __defProp = Object.defineProperty;
@@ -71,312 +71,6 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-function getSystemMode() {
-  if (typeof window === "undefined") return "light";
-  return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
-}
-function resolveMode(mode) {
-  if (mode === "system") {
-    return getSystemMode();
-  }
-  return mode;
-}
-function useTheme() {
-  const context = useContext(ThemeContext);
-  if (context === void 0) {
-    return {
-      theme: "wireframe",
-      mode: "light",
-      resolvedMode: "light",
-      setTheme: () => {
-      },
-      setMode: () => {
-      },
-      toggleMode: () => {
-      },
-      availableThemes: BUILT_IN_THEMES,
-      appliedTheme: "wireframe-light"
-    };
-  }
-  return context;
-}
-var log, BUILT_IN_THEMES, ThemeContext, THEME_STORAGE_KEY, MODE_STORAGE_KEY, ThemeProvider;
-var init_ThemeContext = __esm({
-  "context/ThemeContext.tsx"() {
-    "use client";
-    log = createLogger("almadar:ui:theme");
-    BUILT_IN_THEMES = [
-      {
-        name: "wireframe",
-        displayName: "Wireframe",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "minimalist",
-        displayName: "Minimalist",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "almadar",
-        displayName: "Almadar",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "trait-wars",
-        displayName: "Trait Wars",
-        hasLightMode: false,
-        hasDarkMode: true
-      },
-      // Extended themes
-      {
-        name: "ocean",
-        displayName: "Ocean",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "forest",
-        displayName: "Forest",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "sunset",
-        displayName: "Sunset",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "lavender",
-        displayName: "Lavender",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "rose",
-        displayName: "Rose",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "slate",
-        displayName: "Slate",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "ember",
-        displayName: "Ember",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "midnight",
-        displayName: "Midnight",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "sand",
-        displayName: "Sand",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "neon",
-        displayName: "Neon",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "arctic",
-        displayName: "Arctic",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "copper",
-        displayName: "Copper",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      // Layer 1 skin axes — truly-unique themes (compact tech / editorial / brutalist dense / display-heavy / touch-first)
-      {
-        name: "prism",
-        displayName: "Prism",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "gazette",
-        displayName: "Gazette",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "terminal",
-        displayName: "Terminal",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "atelier",
-        displayName: "Atelier",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "kiosk",
-        displayName: "Kiosk",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "linear-clean",
-        displayName: "Linear Clean",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "notion-editorial",
-        displayName: "Notion Editorial",
-        hasLightMode: true,
-        hasDarkMode: true
-      },
-      {
-        name: "bloomberg-dense",
-        displayName: "Bloomberg Dense",
-        hasLightMode: true,
-        hasDarkMode: true
-      }
-    ];
-    ThemeContext = createContext(void 0);
-    THEME_STORAGE_KEY = "theme";
-    MODE_STORAGE_KEY = "theme-mode";
-    ThemeProvider = ({
-      children,
-      themes = [],
-      defaultTheme = "wireframe",
-      defaultMode = "system",
-      targetRef
-    }) => {
-      const availableThemes = useMemo(() => {
-        const themeMap = /* @__PURE__ */ new Map();
-        BUILT_IN_THEMES.forEach((t) => themeMap.set(t.name, t));
-        themes.forEach((t) => themeMap.set(t.name, t));
-        return Array.from(themeMap.values());
-      }, [themes]);
-      const isScoped = !!targetRef;
-      const [theme, setThemeState] = useState(() => {
-        if (isScoped || typeof window === "undefined") return defaultTheme;
-        const stored = localStorage.getItem(THEME_STORAGE_KEY);
-        const validThemes = [
-          ...BUILT_IN_THEMES.map((t) => t.name),
-          ...themes.map((t) => t.name)
-        ];
-        if (stored && validThemes.includes(stored)) {
-          return stored;
-        }
-        return defaultTheme;
-      });
-      const [mode, setModeState] = useState(() => {
-        if (isScoped || typeof window === "undefined") return defaultMode;
-        const stored = localStorage.getItem(MODE_STORAGE_KEY);
-        if (stored === "light" || stored === "dark" || stored === "system") {
-          return stored;
-        }
-        return defaultMode;
-      });
-      const [resolvedMode, setResolvedMode] = useState(
-        () => resolveMode(mode)
-      );
-      const appliedTheme = useMemo(
-        () => `${theme}-${resolvedMode}`,
-        [theme, resolvedMode]
-      );
-      useEffect(() => {
-        const updateResolved = () => {
-          setResolvedMode(resolveMode(mode));
-        };
-        updateResolved();
-        if (mode === "system") {
-          const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
-          const handleChange = () => updateResolved();
-          mediaQuery.addEventListener("change", handleChange);
-          return () => mediaQuery.removeEventListener("change", handleChange);
-        }
-        return void 0;
-      }, [mode]);
-      useEffect(() => {
-        if (isScoped) {
-          if (targetRef?.current) {
-            targetRef.current.setAttribute("data-theme", appliedTheme);
-            targetRef.current.classList.remove("light", "dark");
-            targetRef.current.classList.add(resolvedMode);
-          }
-          return;
-        }
-        const root = document.documentElement;
-        root.setAttribute("data-theme", appliedTheme);
-        root.classList.remove("light", "dark");
-        root.classList.add(resolvedMode);
-      }, [appliedTheme, resolvedMode, targetRef, isScoped]);
-      const setTheme = useCallback(
-        (newTheme) => {
-          const validTheme = availableThemes.find((t) => t.name === newTheme);
-          if (validTheme) {
-            setThemeState(newTheme);
-            if (!isScoped && typeof window !== "undefined") {
-              localStorage.setItem(THEME_STORAGE_KEY, newTheme);
-            }
-          } else {
-            log.warn("Theme not found", {
-              theme: newTheme,
-              available: availableThemes.map((t) => t.name)
-            });
-          }
-        },
-        [availableThemes]
-      );
-      const setMode = useCallback((newMode) => {
-        setModeState(newMode);
-        if (!isScoped && typeof window !== "undefined") {
-          localStorage.setItem(MODE_STORAGE_KEY, newMode);
-        }
-      }, []);
-      const toggleMode = useCallback(() => {
-        const newMode = resolvedMode === "dark" ? "light" : "dark";
-        setMode(newMode);
-      }, [resolvedMode, setMode]);
-      const contextValue = useMemo(
-        () => ({
-          theme,
-          mode,
-          resolvedMode,
-          setTheme,
-          setMode,
-          toggleMode,
-          availableThemes,
-          appliedTheme
-        }),
-        [
-          theme,
-          mode,
-          resolvedMode,
-          setTheme,
-          setMode,
-          toggleMode,
-          availableThemes,
-          appliedTheme
-        ]
-      );
-      return /* @__PURE__ */ jsx(ThemeContext.Provider, { value: contextValue, children });
-    };
-  }
-});
 
 // hooks/useEventBus.ts
 var useEventBus_exports = {};
@@ -461,11 +155,11 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log2, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
-    log2 = createLogger("almadar:eventbus");
+    log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
     scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
@@ -479,13 +173,13 @@ var init_useEventBus = __esm({
           source
         };
         const handlers = fallbackListeners.get(type);
-        log2.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
+        log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
         if (handlers) {
           handlers.forEach((handler) => {
             try {
               handler(event);
             } catch (error) {
-              log2.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
+              log.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
             }
           });
         }
@@ -493,7 +187,7 @@ var init_useEventBus = __esm({
           try {
             handler(event);
           } catch (error) {
-            log2.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
+            log.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
           }
         });
       },
@@ -660,7 +354,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    Box = React83__default.forwardRef(
+    Box = React82__default.forwardRef(
       ({
         padding,
         paddingX,
@@ -710,7 +404,7 @@ var init_Box = __esm({
           onMouseLeave?.(e);
         }, [hoverEvent, eventBus, onMouseLeave]);
         const isClickable = action || onClick;
-        return React83__default.createElement(
+        return React82__default.createElement(
           Component2,
           {
             ref,
@@ -805,7 +499,7 @@ function loadLib(key, importer) {
   return p2;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React83__default.lazy(async () => {
+  const Lazy = React82__default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -815,7 +509,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsx(
-    React83__default.Suspense,
+    React82__default.Suspense,
     {
       fallback: /* @__PURE__ */ jsx(
         "span",
@@ -1541,7 +1235,7 @@ var init_Icon = __esm({
       const directIcon = typeof icon === "string" ? void 0 : icon;
       const effectiveName = typeof icon === "string" ? icon : name;
       const family = useIconFamily();
-      const RenderedComponent = React83__default.useMemo(() => {
+      const RenderedComponent = React82__default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -1600,7 +1294,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React83__default.isValidElement(value)) {
+  if (React82__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -1676,7 +1370,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    Button = React83__default.forwardRef(
+    Button = React82__default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -1741,7 +1435,7 @@ var Dialog;
 var init_Dialog = __esm({
   "components/core/atoms/Dialog.tsx"() {
     init_cn();
-    Dialog = React83__default.forwardRef(
+    Dialog = React82__default.forwardRef(
       ({
         role = "dialog",
         "aria-modal": ariaModal = true,
@@ -2355,7 +2049,7 @@ var init_Badge = __esm({
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React83__default.forwardRef(
+    Badge = React82__default.forwardRef(
       ({ className, variant = "default", size = "sm", amount, label, icon, children, onRemove, removeLabel, ...props }, ref) => {
         const iconSizes3 = {
           sm: "h-icon-default w-icon-default",
@@ -2691,7 +2385,7 @@ var init_SvgFlow = __esm({
       width = 100,
       height = 100
     }) => {
-      const markerId = React83__default.useMemo(() => {
+      const markerId = React82__default.useMemo(() => {
         flowIdCounter += 1;
         return `almadar-flow-arrow-${flowIdCounter}`;
       }, []);
@@ -3284,7 +2978,7 @@ var init_SvgRing = __esm({
       width = 100,
       height = 100
     }) => {
-      const gradientId = React83__default.useMemo(() => {
+      const gradientId = React82__default.useMemo(() => {
         ringIdCounter += 1;
         return `almadar-ring-glow-${ringIdCounter}`;
       }, []);
@@ -3465,7 +3159,7 @@ var init_Input = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Input = React83__default.forwardRef(
+    Input = React82__default.forwardRef(
       ({
         className,
         inputType,
@@ -3625,7 +3319,7 @@ var Label;
 var init_Label = __esm({
   "components/core/atoms/Label.tsx"() {
     init_cn();
-    Label = React83__default.forwardRef(
+    Label = React82__default.forwardRef(
       ({ className, required, children, ...props }, ref) => {
         return /* @__PURE__ */ jsxs(
           "label",
@@ -3652,7 +3346,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React83__default.forwardRef(
+    Textarea = React82__default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -3891,7 +3585,7 @@ var init_Select = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Select = React83__default.forwardRef(
+    Select = React82__default.forwardRef(
       (props, _ref) => {
         const { multiple, searchable, clearable } = props;
         if (multiple || searchable || clearable) {
@@ -3908,7 +3602,7 @@ var init_Checkbox = __esm({
   "components/core/atoms/Checkbox.tsx"() {
     init_cn();
     init_useEventBus();
-    Checkbox = React83__default.forwardRef(
+    Checkbox = React82__default.forwardRef(
       ({ className, label, id, onChange, ...props }, ref) => {
         const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
         const eventBus = useEventBus();
@@ -3962,7 +3656,7 @@ var init_Spinner = __esm({
       md: "h-6 w-6",
       lg: "h-8 w-8"
     };
-    Spinner = React83__default.forwardRef(
+    Spinner = React82__default.forwardRef(
       ({ className, size = "md", overlay, ...props }, ref) => {
         if (overlay) {
           return /* @__PURE__ */ jsx(
@@ -4052,7 +3746,7 @@ var init_Card = __esm({
       chip: "shadow-none rounded-pill border-[length:var(--border-width)] border-border",
       "tile-image-first": "p-0 overflow-hidden"
     };
-    Card = React83__default.forwardRef(
+    Card = React82__default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -4100,9 +3794,9 @@ var init_Card = __esm({
       }
     );
     Card.displayName = "Card";
-    CardHeader = React83__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React82__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React83__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardTitle = React82__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "h3",
       {
         ref,
@@ -4115,11 +3809,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React83__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React82__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React83__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardFooter = React82__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "div",
       {
         ref,
@@ -4174,7 +3868,7 @@ var init_FilterPill = __esm({
       md: "w-3.5 h-3.5",
       lg: "w-4 h-4"
     };
-    FilterPill = React83__default.forwardRef(
+    FilterPill = React82__default.forwardRef(
       ({
         className,
         variant = "default",
@@ -4303,8 +3997,8 @@ var init_Avatar = __esm({
       actionPayload
     }) => {
       const eventBus = useEventBus();
-      const [imgFailed, setImgFailed] = React83__default.useState(false);
-      React83__default.useEffect(() => {
+      const [imgFailed, setImgFailed] = React82__default.useState(false);
+      React82__default.useEffect(() => {
         setImgFailed(false);
       }, [src]);
       const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -4689,7 +4383,7 @@ var init_Radio = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    Radio = React83__default.forwardRef(
+    Radio = React82__default.forwardRef(
       ({
         label,
         helperText,
@@ -4706,12 +4400,12 @@ var init_Radio = __esm({
         onChange,
         ...props
       }, ref) => {
-        const reactId = React83__default.useId();
+        const reactId = React82__default.useId();
         const baseId = id || `radio-${reactId}`;
         const hasError = !!error;
         const eventBus = useEventBus();
-        const [selected, setSelected] = React83__default.useState(value);
-        React83__default.useEffect(() => {
+        const [selected, setSelected] = React82__default.useState(value);
+        React82__default.useEffect(() => {
           if (value !== void 0) setSelected(value);
         }, [value]);
         const pick = (next, e) => {
@@ -4893,7 +4587,7 @@ var init_Switch = __esm({
   "components/core/atoms/Switch.tsx"() {
     "use client";
     init_cn();
-    Switch = React83.forwardRef(
+    Switch = React82.forwardRef(
       ({
         checked,
         defaultChecked = false,
@@ -4904,10 +4598,10 @@ var init_Switch = __esm({
         name,
         className
       }, ref) => {
-        const [isChecked, setIsChecked] = React83.useState(
+        const [isChecked, setIsChecked] = React82.useState(
           checked !== void 0 ? checked : defaultChecked
         );
-        React83.useEffect(() => {
+        React82.useEffect(() => {
           if (checked !== void 0) {
             setIsChecked(checked);
           }
@@ -5168,7 +4862,6 @@ var init_ThemeToggle = __esm({
     "use client";
     init_Icon();
     init_cn();
-    init_ThemeContext();
     sizeClasses5 = {
       sm: "p-1.5",
       md: "p-2",
@@ -5263,7 +4956,7 @@ var Aside;
 var init_Aside = __esm({
   "components/core/atoms/Aside.tsx"() {
     init_cn();
-    Aside = React83__default.forwardRef(
+    Aside = React82__default.forwardRef(
       ({ className, children, ...rest }, ref) => /* @__PURE__ */ jsx("aside", { ref, className: cn(className), ...rest, children })
     );
     Aside.displayName = "Aside";
@@ -5341,8 +5034,8 @@ var init_LawReferenceTooltip = __esm({
       className
     }) => {
       const { t } = useTranslate();
-      const [isVisible, setIsVisible] = React83__default.useState(false);
-      const timeoutRef = React83__default.useRef(null);
+      const [isVisible, setIsVisible] = React82__default.useState(false);
+      const timeoutRef = React82__default.useRef(null);
       const handleMouseEnter = () => {
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         timeoutRef.current = setTimeout(() => setIsVisible(true), 200);
@@ -5351,7 +5044,7 @@ var init_LawReferenceTooltip = __esm({
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         setIsVisible(false);
       };
-      React83__default.useEffect(() => {
+      React82__default.useEffect(() => {
         return () => {
           if (timeoutRef.current) clearTimeout(timeoutRef.current);
         };
@@ -5561,7 +5254,7 @@ var init_StatusDot = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    StatusDot = React83__default.forwardRef(
+    StatusDot = React82__default.forwardRef(
       ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
         return /* @__PURE__ */ jsx(
           "span",
@@ -5615,7 +5308,7 @@ var init_TrendIndicator = __esm({
       down: "trending-down",
       flat: "arrow-right"
     };
-    TrendIndicator = React83__default.forwardRef(
+    TrendIndicator = React82__default.forwardRef(
       ({
         className,
         value,
@@ -5682,7 +5375,7 @@ var init_RangeSlider = __esm({
       md: "w-4 h-4",
       lg: "w-5 h-5"
     };
-    RangeSlider = React83__default.forwardRef(
+    RangeSlider = React82__default.forwardRef(
       ({
         className,
         min = 0,
@@ -6190,7 +5883,7 @@ var init_ContentSection = __esm({
       md: "py-16",
       lg: "py-24"
     };
-    ContentSection = React83__default.forwardRef(
+    ContentSection = React82__default.forwardRef(
       ({ children, background = "default", padding = "lg", id, className }, ref) => {
         return /* @__PURE__ */ jsx(
           Box,
@@ -6724,7 +6417,7 @@ var init_AnimatedReveal = __esm({
       "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
       "none": {}
     };
-    AnimatedReveal = React83__default.forwardRef(
+    AnimatedReveal = React82__default.forwardRef(
       ({
         trigger = "scroll",
         animation = "fade-up",
@@ -6884,7 +6577,7 @@ var init_AnimatedGraphic = __esm({
   "components/marketing/atoms/AnimatedGraphic.tsx"() {
     "use client";
     init_cn();
-    AnimatedGraphic = React83__default.forwardRef(
+    AnimatedGraphic = React82__default.forwardRef(
       ({
         src,
         svgContent,
@@ -6907,7 +6600,7 @@ var init_AnimatedGraphic = __esm({
         const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
         const resolvedSvg = svgContent ?? fetchedSvg;
         const prevAnimateRef = useRef(animate);
-        const setRef = React83__default.useCallback(
+        const setRef = React82__default.useCallback(
           (node) => {
             containerRef.current = node;
             if (typeof ref === "function") ref(node);
@@ -7133,9 +6826,9 @@ function ScoreDisplay({
   ...rest
 }) {
   const resolvedValue = typeof value === "number" && !Number.isNaN(value) ? value : typeof rest.score === "number" && !Number.isNaN(rest.score) ? rest.score : 0;
-  const [displayValue, setDisplayValue] = React83.useState(resolvedValue);
-  const [isAnimating, setIsAnimating] = React83.useState(false);
-  React83.useEffect(() => {
+  const [displayValue, setDisplayValue] = React82.useState(resolvedValue);
+  const [isAnimating, setIsAnimating] = React82.useState(false);
+  React82.useEffect(() => {
     if (!animated || displayValue === resolvedValue) {
       setDisplayValue(resolvedValue);
       return;
@@ -7218,9 +6911,9 @@ function ControlButton({
   className
 }) {
   const eventBus = useEventBus();
-  const [isPressed, setIsPressed] = React83.useState(false);
+  const [isPressed, setIsPressed] = React82.useState(false);
   const actualPressed = pressed ?? isPressed;
-  const handlePointerDown = React83.useCallback(
+  const handlePointerDown = React82.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -7230,7 +6923,7 @@ function ControlButton({
     },
     [disabled, pressEvent, eventBus, onPress]
   );
-  const handlePointerUp = React83.useCallback(
+  const handlePointerUp = React82.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -7240,7 +6933,7 @@ function ControlButton({
     },
     [disabled, releaseEvent, eventBus, onRelease]
   );
-  const handlePointerLeave = React83.useCallback(
+  const handlePointerLeave = React82.useCallback(
     (e) => {
       if (isPressed) {
         setIsPressed(false);
@@ -7318,6 +7011,52 @@ var init_ControlButton = __esm({
     ControlButton.displayName = "ControlButton";
   }
 });
+
+// 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":
+      return { sheetDir: "se", flipX: false };
+    case "sw":
+      return { sheetDir: "sw", flipX: false };
+    case "ne":
+      return { sheetDir: "sw", flipX: true };
+    case "nw":
+      return { sheetDir: "se", flipX: true };
+  }
+}
+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({
+  "components/game/organisms/utils/spriteAnimation.ts"() {
+  }
+});
 function Sprite({
   spritesheet = "https://almadar-kflow-assets.web.app/shared/isometric-blocks/Spritesheet/allTiles_sheet.png",
   frameWidth = 64,
@@ -7338,12 +7077,8 @@ function Sprite({
 }) {
   const eventBus = useEventBus();
   const sourcePosition = useMemo(() => {
-    const frameX = frame % columns;
-    const frameY = Math.floor(frame / columns);
-    return {
-      x: frameX * frameWidth,
-      y: frameY * frameHeight
-    };
+    const { sx, sy } = frameRect(frame, Math.floor(frame / columns), columns, frameWidth, frameHeight);
+    return { x: sx, y: sy };
   }, [frame, columns, frameWidth, frameHeight]);
   const transform = useMemo(() => {
     const transforms = [
@@ -7391,6 +7126,7 @@ var init_Sprite = __esm({
   "components/game/atoms/Sprite.tsx"() {
     "use client";
     init_useEventBus();
+    init_spriteAnimation();
   }
 });
 function StateIndicator({
@@ -7818,8 +7554,8 @@ function XPBar({
 }) {
   const sizes = sizeMap9[size];
   const percentage = max > 0 ? Math.max(0, Math.min(100, current / max * 100)) : 0;
-  const [fillWidth, setFillWidth] = React83.useState(animated ? 0 : percentage);
-  React83.useEffect(() => {
+  const [fillWidth, setFillWidth] = React82.useState(animated ? 0 : percentage);
+  React82.useEffect(() => {
     if (!animated) {
       setFillWidth(percentage);
       return;
@@ -8307,9 +8043,9 @@ function MiniMap({
   viewportRect = DEFAULT_VIEWPORT,
   className
 }) {
-  const canvasRef = React83.useRef(null);
-  const frameRef = React83.useRef(0);
-  React83.useEffect(() => {
+  const canvasRef = React82.useRef(null);
+  const frameRef = React82.useRef(0);
+  React82.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -8498,7 +8234,7 @@ var init_ErrorBoundary = __esm({
         }
       );
     };
-    ErrorBoundary = class extends React83__default.Component {
+    ErrorBoundary = class extends React82__default.Component {
       constructor(props) {
         super(props);
         __publicField(this, "reset", () => {
@@ -8651,7 +8387,7 @@ function executeClientEffects(effects, config) {
     try {
       executeEffect(effect, config);
     } catch (error) {
-      log4.error("Error executing effect", () => ({
+      log3.error("Error executing effect", () => ({
         effect: JSON.stringify(effect),
         error: error instanceof Error ? error : String(error)
       }));
@@ -8683,7 +8419,7 @@ function executeEffect(effect, config) {
       break;
     }
     default:
-      log4.warn("Unknown effect type", { effectType: String(effectType) });
+      log3.warn("Unknown effect type", { effectType: String(effectType) });
   }
 }
 function executeRenderUI(slot, patternConfig, config) {
@@ -8698,10 +8434,10 @@ function executeNotify(message, options, config) {
 function executeEmit(event, payload, config) {
   config.eventBus.emit(event, payload);
 }
-var log4;
+var log3;
 var init_client_effect_executor = __esm({
   "renderer/client-effect-executor.ts"() {
-    log4 = createLogger("almadar:ui:effects:client");
+    log3 = createLogger("almadar:ui:effects:client");
   }
 });
 
@@ -8862,12 +8598,12 @@ function useOfflineExecutor(options) {
     clearQueue
   };
 }
-var log5, effectIdCounter, OfflineExecutor;
+var log4, effectIdCounter, OfflineExecutor;
 var init_offline_executor = __esm({
   "renderer/offline-executor.ts"() {
     "use client";
     init_client_effect_executor();
-    log5 = createLogger("almadar:ui:effects:offline");
+    log4 = createLogger("almadar:ui:effects:offline");
     effectIdCounter = 0;
     OfflineExecutor = class {
       constructor(config) {
@@ -8921,7 +8657,7 @@ var init_offline_executor = __esm({
             this.state.syncQueue = JSON.parse(stored);
           }
         } catch (error) {
-          log5.warn("Failed to load sync queue", { error: error instanceof Error ? error : String(error) });
+          log4.warn("Failed to load sync queue", { error: error instanceof Error ? error : String(error) });
         }
       }
       /**
@@ -8932,7 +8668,7 @@ var init_offline_executor = __esm({
         try {
           this.storage.setItem("orbital-offline-queue", JSON.stringify(this.state.syncQueue));
         } catch (error) {
-          log5.warn("Failed to save sync queue", { error: error instanceof Error ? error : String(error) });
+          log4.warn("Failed to save sync queue", { error: error instanceof Error ? error : String(error) });
         }
       }
       /**
@@ -9002,7 +8738,7 @@ var init_offline_executor = __esm({
                 this.queueForSync(type, { args, event, payload });
                 break;
               default:
-                log5.warn("Unknown effect type", { type });
+                log4.warn("Unknown effect type", { type });
             }
           }
         }
@@ -9889,8 +9625,8 @@ function ActionButtons({
   disabled
 }) {
   const eventBus = useEventBus();
-  const [activeButtons, setActiveButtons] = React83.useState(/* @__PURE__ */ new Set());
-  const handlePress = React83.useCallback(
+  const [activeButtons, setActiveButtons] = React82.useState(/* @__PURE__ */ new Set());
+  const handlePress = React82.useCallback(
     (id) => {
       setActiveButtons((prev) => new Set(prev).add(id));
       if (actionEvent) eventBus.emit(`UI:${actionEvent}`, { id, pressed: true });
@@ -9898,7 +9634,7 @@ function ActionButtons({
     },
     [actionEvent, eventBus, onAction]
   );
-  const handleRelease = React83.useCallback(
+  const handleRelease = React82.useCallback(
     (id) => {
       setActiveButtons((prev) => {
         const next = new Set(prev);
@@ -10810,7 +10546,7 @@ function recordTransition(trace) {
     ...trace,
     id: `t-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`
   };
-  log6.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
+  log5.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
   getState().transitions.push(entry);
   if (getState().transitions.length > MAX_TRANSITIONS) {
     getState().transitions.shift();
@@ -10879,7 +10615,7 @@ function getTraitSnapshots() {
     try {
       snapshots.push(getter());
     } catch (err) {
-      log6.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
+      log5.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
     }
   }
   return snapshots;
@@ -10942,12 +10678,12 @@ function waitForTransition(event, timeoutMs = 1e4) {
 }
 function bindEventBus(eventBus) {
   if (typeof window === "undefined") return;
-  log6.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
+  log5.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
       const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
-      log6.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
+      log5.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -10996,10 +10732,10 @@ function updateAssetStatus(url, status) {
     window.__orbitalVerification.assetStatus[url] = status;
   }
 }
-var log6, MAX_TRANSITIONS;
+var log5, MAX_TRANSITIONS;
 var init_verificationRegistry = __esm({
   "lib/verificationRegistry.ts"() {
-    log6 = createLogger("almadar:bridge");
+    log5 = createLogger("almadar:bridge");
     MAX_TRANSITIONS = 500;
     exposeOnWindow();
   }
@@ -11126,6 +10862,163 @@ var init_useCamera = __esm({
     "use client";
   }
 });
+function unitAtlasUrl(unit) {
+  if (unit.spriteSheet) return unit.spriteSheet;
+  const sprite = unit.sprite;
+  if (!sprite) return null;
+  const match = /^(.*-sprite-sheet)(?:-(?:se|sw))?(?:-v\d+)?\.png$/.exec(sprite);
+  if (!match) return null;
+  return `${match[1]}.json`;
+}
+function resolveSheetUrl(atlasUrl, relativeSheetPath) {
+  try {
+    return new URL(relativeSheetPath, atlasUrl).toString();
+  } catch {
+    const base = atlasUrl.slice(0, atlasUrl.lastIndexOf("/") + 1);
+    return `${base}${relativeSheetPath.replace(/^\.\//, "")}`;
+  }
+}
+function useUnitSpriteAtlas(units) {
+  const atlasCacheRef = useRef(/* @__PURE__ */ new Map());
+  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) {
+      const url = unitAtlasUrl(unit);
+      if (url) set.add(url);
+    }
+    return [...set];
+  }, [units]);
+  useEffect(() => {
+    const cache = atlasCacheRef.current;
+    const loading = loadingRef.current;
+    const toLoad = atlasUrls.filter((url) => !cache.has(url) && !loading.has(url));
+    if (toLoad.length === 0) return;
+    let cancelled = false;
+    setPendingCount((prev) => prev + toLoad.length);
+    for (const url of toLoad) {
+      loading.add(url);
+      fetch(url).then((res) => res.ok ? res.json() : Promise.reject(new Error(String(res.status)))).then((atlas) => {
+        if (cancelled) return;
+        cache.set(url, atlas);
+      }).catch(() => {
+      }).finally(() => {
+        if (cancelled) return;
+        loading.delete(url);
+        setPendingCount((prev) => Math.max(0, prev - 1));
+        forceTick((n) => n + 1);
+      });
+    }
+    return () => {
+      cancelled = true;
+    };
+  }, [atlasUrls]);
+  const sheetUrls = useMemo(() => {
+    const urls = /* @__PURE__ */ new Set();
+    for (const unit of units) {
+      const atlasUrl = unitAtlasUrl(unit);
+      if (!atlasUrl) continue;
+      const atlas = atlasCacheRef.current.get(atlasUrl);
+      if (!atlas) continue;
+      for (const rel of Object.values(atlas.sheets)) {
+        if (rel) urls.add(resolveSheetUrl(atlasUrl, rel));
+      }
+    }
+    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;
+    const atlasUrl = unitAtlasUrl(unit);
+    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 def = atlas.animations[animation] ?? atlas.animations.idle;
+    if (!def) return null;
+    const { sheetDir, flipX } = resolveSheetDirection(direction);
+    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,
+      sx: rect.sx,
+      sy: rect.sy,
+      sw: rect.sw,
+      sh: rect.sh,
+      flipX,
+      applyBreathing: isIdle
+    };
+  }, [units]);
+  return { sheetUrls, resolveUnitFrame, pendingCount };
+}
+var WALK_HOLD_MS;
+var init_useUnitSpriteAtlas = __esm({
+  "components/game/molecules/useUnitSpriteAtlas.ts"() {
+    "use client";
+    init_spriteAnimation();
+    WALK_HOLD_MS = 600;
+  }
+});
 
 // components/game/organisms/utils/isometric.ts
 function isoToScreen(tileX, tileY, scale, baseOffsetX) {
@@ -11240,6 +11133,10 @@ function IsometricCanvas({
     () => unitsProp.map((u) => u.position ? u : { ...u, position: { x: u.x ?? 0, y: u.y ?? 0 } }),
     [unitsProp]
   );
+  const { sheetUrls: atlasSheetUrls, resolveUnitFrame: resolveUnitFrameInternal, pendingCount: atlasPending } = useUnitSpriteAtlas(units);
+  const resolveFrameForUnit = useCallback((unitId) => {
+    return resolveUnitFrame?.(unitId) ?? resolveUnitFrameInternal(unitId);
+  }, [resolveUnitFrame, resolveUnitFrameInternal]);
   const features = useMemo(
     () => featuresProp.map((f3) => {
       if (f3.type) return f3;
@@ -11323,9 +11220,10 @@ function IsometricCanvas({
       }
     }
     if (effectSpriteUrls) urls.push(...effectSpriteUrls);
+    if (atlasSheetUrls.length) urls.push(...atlasSheetUrls);
     if (backgroundImage) urls.push(backgroundImage);
     return [...new Set(urls.filter(Boolean))];
-  }, [sortedTiles, features, units, getTerrainSprite, getFeatureSprite, getUnitSprite, effectSpriteUrls, backgroundImage, assetManifest, resolveManifestUrl]);
+  }, [sortedTiles, features, units, getTerrainSprite, getFeatureSprite, getUnitSprite, effectSpriteUrls, atlasSheetUrls, backgroundImage, assetManifest, resolveManifestUrl]);
   const { getImage, pendingCount } = useImageCache(spriteUrls);
   useEffect(() => {
     if (typeof window === "undefined") return;
@@ -11612,7 +11510,7 @@ function IsometricCanvas({
         ctx.lineWidth = 3;
         ctx.stroke();
       }
-      const frame = resolveUnitFrame?.(unit.id) ?? null;
+      const frame = resolveFrameForUnit(unit.id);
       const frameImg = frame ? getImage(frame.sheetUrl) : null;
       if (frame && frameImg) {
         const frameAr = frame.sw / frame.sh;
@@ -11722,7 +11620,7 @@ function IsometricCanvas({
     resolveTerrainSpriteUrl,
     resolveFeatureSpriteUrl,
     resolveUnitSpriteUrl,
-    resolveUnitFrame,
+    resolveFrameForUnit,
     getImage,
     gridWidth,
     gridHeight,
@@ -11754,7 +11652,7 @@ function IsometricCanvas({
     };
   }, [selectedUnitId, units, scale, baseOffsetX, scaledTileWidth, scaledDiamondTopY, scaledFloorHeight, viewportSize, targetCameraRef]);
   useEffect(() => {
-    const hasAnimations = units.length > 0 || validMoves.length > 0 || attackTargets.length > 0 || selectedUnitId != null || targetCameraRef.current != null || hasActiveEffects2 || pendingCount > 0;
+    const hasAnimations = units.length > 0 || validMoves.length > 0 || attackTargets.length > 0 || selectedUnitId != null || targetCameraRef.current != null || hasActiveEffects2 || pendingCount > 0 || atlasPending > 0;
     draw(animTimeRef.current);
     if (!hasAnimations) return;
     let running = true;
@@ -11770,7 +11668,7 @@ function IsometricCanvas({
       running = false;
       cancelAnimationFrame(rafIdRef.current);
     };
-  }, [draw, units.length, validMoves.length, attackTargets.length, selectedUnitId, hasActiveEffects2, pendingCount, lerpToTarget, targetCameraRef]);
+  }, [draw, units.length, validMoves.length, attackTargets.length, selectedUnitId, hasActiveEffects2, pendingCount, atlasPending, lerpToTarget, targetCameraRef]);
   const handleMouseMoveWithCamera = useCallback((e) => {
     if (enableCamera) {
       const wasPanning = handleMouseMove(e, () => draw(animTimeRef.current));
@@ -11915,6 +11813,7 @@ var init_IsometricCanvas = __esm({
     init_ErrorState();
     init_useImageCache();
     init_useCamera();
+    init_useUnitSpriteAtlas();
     init_verificationRegistry();
     init_isometric();
     IsometricCanvas.displayName = "IsometricCanvas";
@@ -13130,7 +13029,7 @@ var init_avl_elk_layout = __esm({
     elk = new ELK();
   }
 });
-var log7, SWIM_GUTTER, CENTER_W, BehaviorView;
+var log6, SWIM_GUTTER, CENTER_W, BehaviorView;
 var init_BehaviorView = __esm({
   "components/avl/molecules/BehaviorView.tsx"() {
     "use client";
@@ -13139,7 +13038,7 @@ var init_BehaviorView = __esm({
     init_AvlSwimLane();
     init_types();
     init_avl_elk_layout();
-    log7 = createLogger("almadar:ui:avl:behavior-view");
+    log6 = createLogger("almadar:ui:avl:behavior-view");
     SWIM_GUTTER = 120;
     CENTER_W = 360;
     BehaviorView = ({ data }) => {
@@ -13150,7 +13049,7 @@ var init_BehaviorView = __esm({
       const dataKey = useMemo(() => JSON.stringify(traitData), [traitData]);
       useEffect(() => {
         if (!traitData) return;
-        computeTraitLayout(traitData).then(setLayout).catch((err) => log7.error("compute-trait-layout-failed", { error: err instanceof Error ? err : String(err) }));
+        computeTraitLayout(traitData).then(setLayout).catch((err) => log6.error("compute-trait-layout-failed", { error: err instanceof Error ? err : String(err) }));
       }, [dataKey]);
       if (!traitData) {
         return /* @__PURE__ */ jsx("div", { className: "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] p-4 text-center text-[var(--color-muted-foreground)] text-sm", children: t("avl.noTraitData") });
@@ -13561,7 +13460,7 @@ function generateDiff(oldVal, newVal) {
   }
   return diff;
 }
-var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, log8, CODE_LANGUAGES, CODE_LANGUAGE_SET, DIFF_STYLES, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
+var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, log7, CODE_LANGUAGES, CODE_LANGUAGE_SET, DIFF_STYLES, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
 var init_CodeBlock = __esm({
   "components/core/molecules/markdown/CodeBlock.tsx"() {
     init_cn();
@@ -13644,7 +13543,7 @@ var init_CodeBlock = __esm({
       "lolo-op-async": { color: ORB_COLORS.dark.async }
     };
     loloStyle = { ...dark, ...loloStyleOverrides };
-    log8 = createLogger("almadar:ui:markdown-code");
+    log7 = createLogger("almadar:ui:markdown-code");
     CODE_LANGUAGES = [
       "text",
       "json",
@@ -13683,7 +13582,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    CodeBlock = React83__default.memo(
+    CodeBlock = React82__default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -13908,7 +13807,7 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: true });
             setTimeout(() => setCopied(false), 2e3);
           } catch (err) {
-            log8.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
+            log7.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: false });
           }
         };
@@ -14270,7 +14169,7 @@ var init_MarkdownContent = __esm({
     init_Box();
     init_CodeBlock();
     init_cn();
-    MarkdownContent = React83__default.memo(
+    MarkdownContent = React82__default.memo(
       ({ content, direction = "ltr", className }) => {
         const { t: _t } = useTranslate();
         const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -15587,7 +15486,7 @@ var init_StateMachineView = __esm({
                 style: { top: title ? 30 : 0 },
                 children: [
                   entity && /* @__PURE__ */ jsx(EntityBox, { entity, config }),
-                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React83__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
+                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React82__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
                     StateNode,
                     {
                       state,
@@ -17789,14 +17688,14 @@ function useSafeEventBus2() {
     } };
   }
 }
-var log9, lookStyles4, ButtonGroup;
+var log8, lookStyles4, ButtonGroup;
 var init_ButtonGroup = __esm({
   "components/core/molecules/ButtonGroup.tsx"() {
     "use client";
     init_cn();
     init_atoms2();
     init_useEventBus();
-    log9 = createLogger("almadar:ui:button-group");
+    log8 = createLogger("almadar:ui:button-group");
     lookStyles4 = {
       "right-aligned-buttons": "",
       "floating-bar": "fixed bottom-section left-1/2 -translate-x-1/2 shadow-elevation-toast bg-card p-card-sm rounded-container",
@@ -17877,7 +17776,7 @@ var init_ButtonGroup = __esm({
           {
             variant: "ghost",
             onClick: () => {
-              log9.debug("Filter clicked", { field: filter.field });
+              log8.debug("Filter clicked", { field: filter.field });
             },
             children: filter.label
           },
@@ -22128,7 +22027,7 @@ function CraftingRecipe({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCraft = React83.useCallback(() => {
+  const handleCraft = React82.useCallback(() => {
     onCraft?.();
     if (craftEvent) {
       eventBus.emit(craftEvent, { output: output.label });
@@ -22145,7 +22044,7 @@ function CraftingRecipe({
       children: [
         /* @__PURE__ */ jsx(HStack, { gap: "xs", className: "flex-wrap items-center", children: inputs.map((ingredient, index) => {
           const hasSufficient = ingredient.available >= ingredient.required;
-          return /* @__PURE__ */ jsxs(React83.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React82.Fragment, { children: [
             /* @__PURE__ */ jsx(Box, { className: "relative", children: /* @__PURE__ */ jsx(
               ItemSlot,
               {
@@ -22217,8 +22116,8 @@ function DPad({
 }) {
   const eventBus = useEventBus();
   const sizes = sizeMap15[size];
-  const [activeDirections, setActiveDirections] = React83.useState(/* @__PURE__ */ new Set());
-  const handlePress = React83.useCallback(
+  const [activeDirections, setActiveDirections] = React82.useState(/* @__PURE__ */ new Set());
+  const handlePress = React82.useCallback(
     (direction) => {
       setActiveDirections((prev) => new Set(prev).add(direction));
       if (directionEvent) eventBus.emit(`UI:${directionEvent}`, { direction, pressed: true });
@@ -22226,7 +22125,7 @@ function DPad({
     },
     [directionEvent, eventBus, onDirection]
   );
-  const handleRelease = React83.useCallback(
+  const handleRelease = React82.useCallback(
     (direction) => {
       setActiveDirections((prev) => {
         const next = new Set(prev);
@@ -23033,8 +22932,8 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React83__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React83__default.cloneElement(
+      const triggerChild = React82__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
+      const triggerElement = React82__default.cloneElement(
         triggerChild,
         {
           ref: triggerRef,
@@ -23168,14 +23067,14 @@ function useDataDnd(args) {
   const isZone = Boolean(dragGroup || accepts || sortable);
   const enabled = isZone || Boolean(dndRoot);
   const eventBus = useEventBus();
-  const parentRoot = React83__default.useContext(RootCtx);
+  const parentRoot = React82__default.useContext(RootCtx);
   const isRoot = enabled && parentRoot === null;
-  const zoneId = React83__default.useId();
+  const zoneId = React82__default.useId();
   const ownGroup = dragGroup ?? accepts ?? zoneId;
-  const [optimisticOrders, setOptimisticOrders] = React83__default.useState(() => /* @__PURE__ */ new Map());
-  const optimisticOrdersRef = React83__default.useRef(optimisticOrders);
+  const [optimisticOrders, setOptimisticOrders] = React82__default.useState(() => /* @__PURE__ */ new Map());
+  const optimisticOrdersRef = React82__default.useRef(optimisticOrders);
   optimisticOrdersRef.current = optimisticOrders;
-  const clearOptimisticOrder = React83__default.useCallback((group) => {
+  const clearOptimisticOrder = React82__default.useCallback((group) => {
     setOptimisticOrders((prev) => {
       if (!prev.has(group)) return prev;
       const next = new Map(prev);
@@ -23200,7 +23099,7 @@ function useDataDnd(args) {
     const raw = it[dndItemIdField];
     return String(raw ?? `__idx_${idx}`);
   }).join("|");
-  const itemIds = React83__default.useMemo(
+  const itemIds = React82__default.useMemo(
     () => orderedItems.map((it, idx) => {
       const raw = it[dndItemIdField];
       return raw ?? `__idx_${idx}`;
@@ -23208,7 +23107,7 @@ function useDataDnd(args) {
     [itemIdsSignature]
   );
   const itemsContentSig = items.map((it, idx) => String(it[dndItemIdField] ?? `__${idx}`)).join("|");
-  React83__default.useEffect(() => {
+  React82__default.useEffect(() => {
     const root = isRoot ? null : parentRoot;
     if (root) {
       root.clearOptimisticOrder(ownGroup);
@@ -23216,20 +23115,20 @@ function useDataDnd(args) {
       clearOptimisticOrder(ownGroup);
     }
   }, [itemsContentSig, ownGroup]);
-  const zonesRef = React83__default.useRef(/* @__PURE__ */ new Map());
-  const registerZone = React83__default.useCallback((zoneId2, meta2) => {
+  const zonesRef = React82__default.useRef(/* @__PURE__ */ new Map());
+  const registerZone = React82__default.useCallback((zoneId2, meta2) => {
     zonesRef.current.set(zoneId2, meta2);
   }, []);
-  const unregisterZone = React83__default.useCallback((zoneId2) => {
+  const unregisterZone = React82__default.useCallback((zoneId2) => {
     zonesRef.current.delete(zoneId2);
   }, []);
-  const [activeDrag, setActiveDrag] = React83__default.useState(null);
-  const [overZoneGroup, setOverZoneGroup] = React83__default.useState(null);
-  const meta = React83__default.useMemo(
+  const [activeDrag, setActiveDrag] = React82__default.useState(null);
+  const [overZoneGroup, setOverZoneGroup] = React82__default.useState(null);
+  const meta = React82__default.useMemo(
     () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
     [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
-  React83__default.useEffect(() => {
+  React82__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
     if (!target) {
       zonesRef.current.set(zoneId, meta);
@@ -23248,7 +23147,7 @@ function useDataDnd(args) {
   }, [parentRoot, isRoot, zoneId, meta]);
   const sensors = useAlmadarDndSensors(true);
   const collisionDetection = almadarDndCollisionDetection;
-  const findZoneByItem = React83__default.useCallback(
+  const findZoneByItem = React82__default.useCallback(
     (id) => {
       for (const z of zonesRef.current.values()) {
         if (z.itemIds.includes(id)) return z;
@@ -23257,7 +23156,7 @@ function useDataDnd(args) {
     },
     []
   );
-  React83__default.useCallback(
+  React82__default.useCallback(
     (group) => {
       for (const z of zonesRef.current.values()) {
         if (z.group === group) return z;
@@ -23266,7 +23165,7 @@ function useDataDnd(args) {
     },
     []
   );
-  const handleDragEnd = React83__default.useCallback(
+  const handleDragEnd = React82__default.useCallback(
     (event) => {
       const { active, over } = event;
       const activeIdStr = String(active.id);
@@ -23357,8 +23256,8 @@ function useDataDnd(args) {
     },
     [eventBus]
   );
-  const sortableData = React83__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
-  const SortableItem = React83__default.useCallback(
+  const sortableData = React82__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
+  const SortableItem = React82__default.useCallback(
     ({ id, children }) => {
       const {
         attributes,
@@ -23398,7 +23297,7 @@ function useDataDnd(args) {
       id: droppableId,
       data: sortableData
     });
-    const ctx = React83__default.useContext(RootCtx);
+    const ctx = React82__default.useContext(RootCtx);
     const activeDrag2 = ctx?.activeDrag ?? null;
     const overZoneGroup2 = ctx?.overZoneGroup ?? null;
     const isThisZoneOver = overZoneGroup2 === ownGroup;
@@ -23413,7 +23312,7 @@ function useDataDnd(args) {
       showForeignPlaceholder,
       ctxAvailable: ctx != null
     });
-    React83__default.useEffect(() => {
+    React82__default.useEffect(() => {
       dndLog.info("dropzone:isOver:change", { droppableId, group: ownGroup, isOver, isThisZoneOver, showForeignPlaceholder, activeDragSourceGroup: activeDrag2?.sourceGroup ?? null });
     }, [droppableId, isOver, isThisZoneOver, showForeignPlaceholder]);
     return /* @__PURE__ */ jsx(
@@ -23427,11 +23326,11 @@ function useDataDnd(args) {
       }
     );
   };
-  const rootContextValue = React83__default.useMemo(
+  const rootContextValue = React82__default.useMemo(
     () => ({ registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder }),
     [registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder]
   );
-  const handleDragStart = React83__default.useCallback((event) => {
+  const handleDragStart = React82__default.useCallback((event) => {
     const sourceZone = findZoneByItem(event.active.id);
     const rect = event.active.rect.current.initial;
     const height = rect?.height && rect.height > 0 ? rect.height : 64;
@@ -23450,7 +23349,7 @@ function useDataDnd(args) {
       isRoot
     });
   }, [findZoneByItem, isRoot, zoneId]);
-  const handleDragOver = React83__default.useCallback((event) => {
+  const handleDragOver = React82__default.useCallback((event) => {
     const { active, over } = event;
     const overData = over?.data?.current;
     const overGroup = overData?.dndGroup ?? null;
@@ -23520,7 +23419,7 @@ function useDataDnd(args) {
       return next;
     });
   }, []);
-  const handleDragCancel = React83__default.useCallback((event) => {
+  const handleDragCancel = React82__default.useCallback((event) => {
     setActiveDrag(null);
     setOverZoneGroup(null);
     dndLog.warn("dragCancel", {
@@ -23528,12 +23427,12 @@ function useDataDnd(args) {
       reason: "dnd-kit cancelled the drag (escape key, pointer interrupted, or external)"
     });
   }, []);
-  const handleDragEndWithCleanup = React83__default.useCallback((event) => {
+  const handleDragEndWithCleanup = React82__default.useCallback((event) => {
     handleDragEnd(event);
     setActiveDrag(null);
     setOverZoneGroup(null);
   }, [handleDragEnd]);
-  const wrapContainer = React83__default.useCallback(
+  const wrapContainer = React82__default.useCallback(
     (children) => {
       if (!enabled) return children;
       const strategy = layout === "grid" ? rectSortingStrategy : verticalListSortingStrategy;
@@ -23587,7 +23486,7 @@ var init_useDataDnd = __esm({
     init_useAlmadarDndCollision();
     init_Box();
     dndLog = createLogger("almadar:ui:dnd");
-    RootCtx = React83__default.createContext(null);
+    RootCtx = React82__default.createContext(null);
   }
 });
 function renderIconInput(icon, props) {
@@ -24113,7 +24012,7 @@ function DataList({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React83__default.useState(pageSize || Infinity);
+  const [visibleCount, setVisibleCount] = React82__default.useState(pageSize || Infinity);
   const fieldDefs = fields ?? columns ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -24132,7 +24031,7 @@ function DataList({
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
   const hasRenderProp = typeof children === "function";
-  React83__default.useEffect(() => {
+  React82__default.useEffect(() => {
     const renderItemTypeOf = typeof schemaRenderItem;
     const childrenTypeOf = typeof children;
     if (data.length > 0 && !hasRenderProp) {
@@ -24237,7 +24136,7 @@ function DataList({
     const items2 = data.map((item) => item);
     const groups2 = groupBy ? groupData(items2, groupBy) : [{ label: "", items: items2 }];
     const contentField = titleField?.name ?? fieldDefs[0]?.name ?? "";
-    return /* @__PURE__ */ jsx(VStack, { gap: "sm", className: cn("py-2", className), children: groups2.map((group, gi) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+    return /* @__PURE__ */ jsx(VStack, { gap: "sm", className: cn("py-2", className), children: groups2.map((group, gi) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
       group.label && /* @__PURE__ */ jsx(Divider, { label: group.label, className: "my-2" }),
       group.items.map((itemData, index) => {
         const id = itemData.id || `${gi}-${index}`;
@@ -24378,7 +24277,7 @@ function DataList({
           className
         ),
         children: [
-          groups.map((group, gi) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+          groups.map((group, gi) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
             group.label && /* @__PURE__ */ jsx(Divider, { label: group.label, className: gi > 0 ? "mt-4" : "mt-0" }),
             group.items.map(
               (itemData, index) => renderItem(itemData, index, gi === groups.length - 1 && index === group.items.length - 1)
@@ -25294,7 +25193,7 @@ var init_Grid = __esm({
       as: Component2 = "div"
     }) => {
       const mergedStyle = rows2 ? { gridTemplateRows: `repeat(${rows2}, minmax(0, 1fr))`, ...style } : style;
-      return React83__default.createElement(
+      return React82__default.createElement(
         Component2,
         {
           className: cn(
@@ -25482,8 +25381,8 @@ var init_Popover = __esm({
         onMouseEnter: handleOpen,
         onMouseLeave: handleClose
       };
-      const childElement = React83__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const triggerElement = React83__default.cloneElement(
+      const childElement = React82__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const triggerElement = React82__default.cloneElement(
         childElement,
         {
           ref: triggerRef,
@@ -25539,9 +25438,9 @@ function debug(...args) {
   const [first, ...rest] = args;
   const message = typeof first === "string" ? first : "<debug>";
   if (rest.length === 0 && typeof first === "string") {
-    log10.debug(message);
+    log9.debug(message);
   } else {
-    log10.debug(message, { args: rest.length > 0 ? formatArgs(rest) : formatArgs([first]) });
+    log9.debug(message, { args: rest.length > 0 ? formatArgs(rest) : formatArgs([first]) });
   }
 }
 function debugGroup(label) {
@@ -25569,11 +25468,11 @@ function toLogMetaValue(v) {
   }
   return String(v);
 }
-var NAMESPACE, log10;
+var NAMESPACE, log9;
 var init_debug = __esm({
   "lib/debug.ts"() {
     NAMESPACE = "almadar:ui:debug";
-    log10 = createLogger(NAMESPACE);
+    log9 = createLogger(NAMESPACE);
     createLogger("almadar:ui:debug:input");
     createLogger("almadar:ui:debug:collision");
     createLogger("almadar:ui:debug:physics");
@@ -26073,8 +25972,8 @@ var init_Tooltip = __esm({
           if (hideTimeoutRef.current) clearTimeout(hideTimeoutRef.current);
         };
       }, []);
-      const triggerElement = React83__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const trigger = React83__default.cloneElement(triggerElement, {
+      const triggerElement = React82__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const trigger = React82__default.cloneElement(triggerElement, {
         ref: triggerRef,
         onMouseEnter: handleMouseEnter,
         onMouseLeave: handleMouseLeave,
@@ -26160,7 +26059,7 @@ var init_WizardProgress = __esm({
           children: /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2", children: normalizedSteps.map((step, index) => {
             const isActive = index === currentStep;
             const isCompleted = index < currentStep;
-            return /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
               /* @__PURE__ */ jsx(
                 "button",
                 {
@@ -27224,7 +27123,7 @@ function InventoryGrid({
   const eventBus = useEventBus();
   const slotCount = totalSlots ?? items.length;
   const emptySlotCount = Math.max(0, slotCount - items.length);
-  const handleSelect = React83.useCallback(
+  const handleSelect = React82.useCallback(
     (id) => {
       onSelect?.(id);
       if (selectEvent) {
@@ -27458,31 +27357,31 @@ function GameCanvas2D({
   assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   className
 }) {
-  const canvasRef = React83.useRef(null);
-  const rafRef = React83.useRef(0);
-  const frameRef = React83.useRef(0);
-  const lastTimeRef = React83.useRef(0);
-  const imageCache = React83.useRef(/* @__PURE__ */ new Map());
+  const canvasRef = React82.useRef(null);
+  const rafRef = React82.useRef(0);
+  const frameRef = React82.useRef(0);
+  const lastTimeRef = React82.useRef(0);
+  const imageCache = React82.useRef(/* @__PURE__ */ new Map());
   const emit = useEmitEvent();
-  const onDrawRef = React83.useRef(onDraw);
+  const onDrawRef = React82.useRef(onDraw);
   onDrawRef.current = onDraw;
-  const onTickRef = React83.useRef(onTick);
+  const onTickRef = React82.useRef(onTick);
   onTickRef.current = onTick;
-  const tickEventRef = React83.useRef(tickEvent);
+  const tickEventRef = React82.useRef(tickEvent);
   tickEventRef.current = tickEvent;
-  const drawEventRef = React83.useRef(drawEvent);
+  const drawEventRef = React82.useRef(drawEvent);
   drawEventRef.current = drawEvent;
-  const emitRef = React83.useRef(emit);
+  const emitRef = React82.useRef(emit);
   emitRef.current = emit;
-  const assetBaseUrlRef = React83.useRef(assetBaseUrl);
+  const assetBaseUrlRef = React82.useRef(assetBaseUrl);
   assetBaseUrlRef.current = assetBaseUrl;
-  const backgroundImageRef = React83.useRef(backgroundImage);
+  const backgroundImageRef = React82.useRef(backgroundImage);
   backgroundImageRef.current = backgroundImage;
-  const widthRef = React83.useRef(width);
+  const widthRef = React82.useRef(width);
   widthRef.current = width;
-  const heightRef = React83.useRef(height);
+  const heightRef = React82.useRef(height);
   heightRef.current = height;
-  const loadImage = React83.useCallback((url) => {
+  const loadImage = React82.useCallback((url) => {
     const fullUrl = url.startsWith("http") ? url : `${assetBaseUrlRef.current}${url}`;
     const cached = imageCache.current.get(fullUrl);
     if (cached?.complete && cached.naturalWidth > 0) return cached;
@@ -27494,7 +27393,7 @@ function GameCanvas2D({
     }
     return null;
   }, []);
-  React83.useEffect(() => {
+  React82.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -27806,7 +27705,7 @@ function TurnPanel({
   className
 }) {
   const eventBus = useEventBus();
-  const handleAction = React83.useCallback(
+  const handleAction = React82.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { turn: currentTurn, phase, activeTeam });
@@ -27975,7 +27874,7 @@ function UnitCommandBar({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCommand = React83.useCallback(
+  const handleCommand = React82.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { unitId: selectedUnitId });
@@ -28489,7 +28388,7 @@ function GameMenu({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleOptionClick = React83.useCallback(
+  const handleOptionClick = React82.useCallback(
     (option) => {
       if (option.event && eventBus) {
         eventBus.emit(`UI:${option.event}`, { option });
@@ -28608,7 +28507,7 @@ function GameOverScreen({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleActionClick = React83.useCallback(
+  const handleActionClick = React82.useCallback(
     (action) => {
       if (action.event && eventBus) {
         eventBus.emit(`UI:${action.event}`, { action });
@@ -29497,12 +29396,12 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect79, useRef: useRef74, useCallback: useCallback118, useState: useState109 } = React83__default;
+      const { useEffect: useEffect79, useRef: useRef75, useCallback: useCallback118, useState: useState109 } = React82__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus3 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef74({ centerLat, centerLng, zoom });
+        const prevRef = useRef75({ centerLat, centerLng, zoom });
         useEffect79(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
@@ -30403,8 +30302,8 @@ function TableView({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React83__default.useState(pageSize > 0 ? pageSize : Infinity);
-  const [localSelected, setLocalSelected] = React83__default.useState(/* @__PURE__ */ new Set());
+  const [visibleCount, setVisibleCount] = React82__default.useState(pageSize > 0 ? pageSize : Infinity);
+  const [localSelected, setLocalSelected] = React82__default.useState(/* @__PURE__ */ new Set());
   const colDefs = columns ?? fields ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -30599,12 +30498,12 @@ function TableView({
         ]
       }
     );
-    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React83__default.Fragment, { children: rowInner }, id);
+    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React82__default.Fragment, { children: rowInner }, id);
   };
   const items = data.map((row) => row);
   const groups = groupBy ? groupData2(items, groupBy) : [{ label: "", items }];
   let runningIndex = 0;
-  const body = /* @__PURE__ */ jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+  const body = /* @__PURE__ */ jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
     group.label && /* @__PURE__ */ jsx(Divider, { label: group.label, className: gi > 0 ? "mt-3" : "mt-0" }),
     group.items.map((row) => renderRow(row, runningIndex++))
   ] }, gi)) });
@@ -31961,7 +31860,7 @@ var init_StepFlow = __esm({
       className
     }) => {
       if (orientation === "vertical") {
-        return /* @__PURE__ */ jsx(VStack, { gap: "none", className: cn("w-full", className), children: steps.map((step, index) => /* @__PURE__ */ jsx(React83__default.Fragment, { children: /* @__PURE__ */ jsxs(HStack, { gap: "md", align: "start", className: "w-full", children: [
+        return /* @__PURE__ */ jsx(VStack, { gap: "none", className: cn("w-full", className), children: steps.map((step, index) => /* @__PURE__ */ jsx(React82__default.Fragment, { children: /* @__PURE__ */ jsxs(HStack, { gap: "md", align: "start", className: "w-full", children: [
           /* @__PURE__ */ jsxs(VStack, { gap: "none", align: "center", children: [
             /* @__PURE__ */ jsx(StepCircle, { step, index }),
             showConnectors && index < steps.length - 1 && /* @__PURE__ */ jsx(Box, { className: "w-px h-8 bg-border" })
@@ -31972,7 +31871,7 @@ var init_StepFlow = __esm({
           ] })
         ] }) }, index)) });
       }
-      return /* @__PURE__ */ jsx(Box, { className: cn("w-full flex flex-col md:flex-row items-start gap-0", className), children: steps.map((step, index) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+      return /* @__PURE__ */ jsx(Box, { className: cn("w-full flex flex-col md:flex-row items-start gap-0", className), children: steps.map((step, index) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
         /* @__PURE__ */ jsxs(VStack, { gap: "sm", align: "center", className: "flex-1 w-full md:w-auto", children: [
           /* @__PURE__ */ jsx(StepCircle, { step, index }),
           /* @__PURE__ */ jsx(Typography, { variant: "h4", className: "text-center", children: step.title }),
@@ -32957,7 +32856,7 @@ var init_LikertScale = __esm({
       md: "text-base",
       lg: "text-lg"
     };
-    LikertScale = React83__default.forwardRef(
+    LikertScale = React82__default.forwardRef(
       ({
         question,
         options = DEFAULT_LIKERT_OPTIONS,
@@ -32969,7 +32868,7 @@ var init_LikertScale = __esm({
         variant = "radios",
         className
       }, ref) => {
-        const groupId = React83__default.useId();
+        const groupId = React82__default.useId();
         const eventBus = useEventBus();
         const handleSelect = useCallback(
           (next) => {
@@ -35251,7 +35150,7 @@ var init_DocBreadcrumb = __esm({
           "aria-label": t("aria.breadcrumb"),
           children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", wrap: true, children: items.map((item, idx) => {
             const isLast = idx === items.length - 1;
-            return /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsx(
                 Icon,
                 {
@@ -36120,7 +36019,7 @@ var init_MiniStateMachine = __esm({
           const x = 2 + i * (NODE_W + GAP + ARROW_W + GAP);
           const tc = transitionCounts[s.name] ?? 0;
           const role = getStateRole(s.name, s.isInitial, s.isTerminal, tc, maxTC);
-          return /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
             /* @__PURE__ */ jsx(
               AvlState,
               {
@@ -36324,7 +36223,7 @@ var init_PageHeader = __esm({
         info: "bg-info/10 text-info"
       };
       return /* @__PURE__ */ jsxs(Box, { className: cn("mb-6", className), children: [
-        breadcrumbs && breadcrumbs.length > 0 && /* @__PURE__ */ jsx(Box, { as: "nav", className: "mb-4", children: /* @__PURE__ */ jsx(Box, { as: "ol", className: "flex items-center gap-2 text-sm", children: breadcrumbs.map((crumb, idx) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+        breadcrumbs && breadcrumbs.length > 0 && /* @__PURE__ */ jsx(Box, { as: "nav", className: "mb-4", children: /* @__PURE__ */ jsx(Box, { as: "ol", className: "flex items-center gap-2 text-sm", children: breadcrumbs.map((crumb, idx) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: "/" }),
           crumb.href ? /* @__PURE__ */ jsx(
             "a",
@@ -37053,7 +36952,7 @@ var init_WizardContainer = __esm({
               const isCompleted = index < currentStep;
               const stepKey = step.id ?? step.tabId ?? `step-${index}`;
               const stepTitle = step.title ?? step.name ?? `Step ${index + 1}`;
-              return /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+              return /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
                 /* @__PURE__ */ jsx(
                   Button,
                   {
@@ -39388,7 +39287,7 @@ var init_DetailPanel = __esm({
   }
 });
 function extractTitle(children) {
-  if (!React83__default.isValidElement(children)) return void 0;
+  if (!React82__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -39443,7 +39342,7 @@ function LinearView({
     /* @__PURE__ */ jsx(HStack, { className: "flex-wrap items-center", gap: "xs", children: trait.states.map((state, i) => {
       const isDone = i < currentIdx;
       const isCurrent = i === currentIdx;
-      return /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+      return /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
         i > 0 && /* @__PURE__ */ jsx(
           Typography,
           {
@@ -40393,12 +40292,12 @@ var init_Form = __esm({
       const isSchemaEntity = isOrbitalEntitySchema(entity);
       const resolvedEntity = isSchemaEntity ? entity : void 0;
       const entityName = typeof entity === "string" ? entity : resolvedEntity?.name;
-      const normalizedInitialData = React83__default.useMemo(() => {
+      const normalizedInitialData = React82__default.useMemo(() => {
         const entityRowAsInitial = isPlainEntityRow(entity) ? entity : void 0;
         const callerInitial = initialData !== null && typeof initialData === "object" && !Array.isArray(initialData) ? initialData : {};
         return entityRowAsInitial !== void 0 ? { ...entityRowAsInitial, ...callerInitial } : callerInitial;
       }, [entity, initialData]);
-      const entityDerivedFields = React83__default.useMemo(() => {
+      const entityDerivedFields = React82__default.useMemo(() => {
         if (fields && fields.length > 0) return void 0;
         if (!resolvedEntity) return void 0;
         return resolvedEntity.fields.map(
@@ -40418,16 +40317,16 @@ var init_Form = __esm({
       const conditionalFields = typeof conditionalFieldsRaw === "boolean" ? {} : conditionalFieldsRaw;
       const hiddenCalculations = typeof hiddenCalculationsRaw === "boolean" ? [] : hiddenCalculationsRaw;
       const violationTriggers = typeof violationTriggersRaw === "boolean" ? [] : violationTriggersRaw;
-      const [formData, setFormData] = React83__default.useState(
+      const [formData, setFormData] = React82__default.useState(
         normalizedInitialData
       );
-      const [collapsedSections, setCollapsedSections] = React83__default.useState(
+      const [collapsedSections, setCollapsedSections] = React82__default.useState(
         /* @__PURE__ */ new Set()
       );
-      const [submitError, setSubmitError] = React83__default.useState(null);
-      const formRef = React83__default.useRef(null);
+      const [submitError, setSubmitError] = React82__default.useState(null);
+      const formRef = React82__default.useRef(null);
       const formMode = props.mode;
-      const mountedRef = React83__default.useRef(false);
+      const mountedRef = React82__default.useRef(false);
       if (!mountedRef.current) {
         mountedRef.current = true;
         debug("forms", "mount", {
@@ -40440,7 +40339,7 @@ var init_Form = __esm({
         });
       }
       const shouldShowCancel = showCancel ?? (fields && fields.length > 0);
-      const evalContext = React83__default.useMemo(
+      const evalContext = React82__default.useMemo(
         () => ({
           formValues: formData,
           globalVariables: externalContext?.globalVariables ?? {},
@@ -40449,7 +40348,7 @@ var init_Form = __esm({
         }),
         [formData, externalContext]
       );
-      React83__default.useEffect(() => {
+      React82__default.useEffect(() => {
         debug("forms", "initialData-sync", {
           mode: formMode,
           normalizedInitialData,
@@ -40460,7 +40359,7 @@ var init_Form = __esm({
           setFormData(normalizedInitialData);
         }
       }, [normalizedInitialData]);
-      const processCalculations = React83__default.useCallback(
+      const processCalculations = React82__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!hiddenCalculations.length) return;
           const context = {
@@ -40485,7 +40384,7 @@ var init_Form = __esm({
         },
         [hiddenCalculations, externalContext, eventBus]
       );
-      const checkViolations = React83__default.useCallback(
+      const checkViolations = React82__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!violationTriggers.length) return;
           const context = {
@@ -40523,7 +40422,7 @@ var init_Form = __esm({
         processCalculations(name, newFormData);
         checkViolations(name, newFormData);
       };
-      const isFieldVisible = React83__default.useCallback(
+      const isFieldVisible = React82__default.useCallback(
         (fieldName) => {
           const condition = conditionalFields[fieldName];
           if (!condition) return true;
@@ -40531,7 +40430,7 @@ var init_Form = __esm({
         },
         [conditionalFields, evalContext]
       );
-      const isSectionVisible = React83__default.useCallback(
+      const isSectionVisible = React82__default.useCallback(
         (section) => {
           if (!section.condition) return true;
           return Boolean(evaluateFormExpression(section.condition, evalContext));
@@ -40607,7 +40506,7 @@ var init_Form = __esm({
           eventBus.emit(`UI:${onCancel}`);
         }
       };
-      const renderField = React83__default.useCallback(
+      const renderField = React82__default.useCallback(
         (field) => {
           const fieldName = field.name || field.field;
           if (!fieldName) return null;
@@ -40628,7 +40527,7 @@ var init_Form = __esm({
         [formData, isFieldVisible, relationsData, relationsLoading, isLoading]
       );
       const effectiveFields = entityDerivedFields ?? fields;
-      const normalizedFields = React83__default.useMemo(() => {
+      const normalizedFields = React82__default.useMemo(() => {
         if (!effectiveFields || effectiveFields.length === 0) return [];
         return effectiveFields.map((field) => {
           if (typeof field === "string") {
@@ -40651,7 +40550,7 @@ var init_Form = __esm({
           return field;
         });
       }, [effectiveFields, resolvedEntity]);
-      const schemaFields = React83__default.useMemo(() => {
+      const schemaFields = React82__default.useMemo(() => {
         if (normalizedFields.length === 0) return null;
         if (isDebugEnabled()) {
           debugGroup(`Form: ${entityName || "unknown"}`);
@@ -40661,7 +40560,7 @@ var init_Form = __esm({
         }
         return normalizedFields.map(renderField).filter(Boolean);
       }, [normalizedFields, renderField, entityName, conditionalFields]);
-      const sectionElements = React83__default.useMemo(() => {
+      const sectionElements = React82__default.useMemo(() => {
         if (!sections || sections.length === 0) return null;
         return sections.map((section) => {
           if (!isSectionVisible(section)) {
@@ -41270,7 +41169,7 @@ var init_AssetLoader = __esm({
         __publicField(this, "textureCache");
         __publicField(this, "loadingPromises");
         this.objLoader = new OBJLoader();
-        this.textureLoader = new THREE.TextureLoader();
+        this.textureLoader = new THREE3.TextureLoader();
         this.modelCache = /* @__PURE__ */ new Map();
         this.textureCache = /* @__PURE__ */ new Map();
         this.loadingPromises = /* @__PURE__ */ new Map();
@@ -41344,7 +41243,7 @@ var init_AssetLoader = __esm({
           return this.loadingPromises.get(`texture:${url}`);
         }
         const loadPromise = this.textureLoader.loadAsync(url).then((texture) => {
-          texture.colorSpace = THREE.SRGBColorSpace;
+          texture.colorSpace = THREE3.SRGBColorSpace;
           this.textureCache.set(url, texture);
           this.loadingPromises.delete(`texture:${url}`);
           return texture;
@@ -41418,7 +41317,7 @@ var init_AssetLoader = __esm({
         });
         this.modelCache.forEach((model) => {
           model.scene.traverse((child) => {
-            if (child instanceof THREE.Mesh) {
+            if (child instanceof THREE3.Mesh) {
               child.geometry.dispose();
               if (Array.isArray(child.material)) {
                 child.material.forEach((m) => m.dispose());
@@ -41831,11 +41730,11 @@ var init_Canvas3DErrorBoundary = __esm({
   "components/game/molecules/three/components/Canvas3DErrorBoundary.css"() {
   }
 });
-var log11, Canvas3DErrorBoundary;
+var log10, Canvas3DErrorBoundary;
 var init_Canvas3DErrorBoundary2 = __esm({
   "components/game/molecules/three/components/Canvas3DErrorBoundary.tsx"() {
     init_Canvas3DErrorBoundary();
-    log11 = createLogger("almadar:ui:game:canvas3d:error-boundary");
+    log10 = createLogger("almadar:ui:game:canvas3d:error-boundary");
     Canvas3DErrorBoundary = class extends Component {
       constructor(props) {
         super(props);
@@ -41863,8 +41762,8 @@ var init_Canvas3DErrorBoundary2 = __esm({
       componentDidCatch(error, errorInfo) {
         this.setState({ errorInfo });
         this.props.onError?.(error, errorInfo);
-        log11.error("Error caught", { error });
-        log11.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
+        log10.error("Error caught", { error });
+        log10.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
       }
       render() {
         if (this.state.hasError) {
@@ -41927,7 +41826,7 @@ function useGLTFModel(url, resourceBasePath) {
       setState({ model: null, isLoading: false, error: null });
       return;
     }
-    log12.debug("Loading", { url });
+    log11.debug("Loading", { url });
     setState((prev) => ({ ...prev, isLoading: true, error: null }));
     const assetRoot = resourceBasePath || detectAssetRoot2(url);
     const loader = new GLTFLoader$1();
@@ -41935,7 +41834,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        log12.debug("Loaded", { url });
+        log11.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -41944,7 +41843,7 @@ function useGLTFModel(url, resourceBasePath) {
       },
       void 0,
       (err) => {
-        log12.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
+        log11.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
         setState({
           model: null,
           isLoading: false,
@@ -41974,7 +41873,7 @@ function ModelLoader({
     if (!loadedModel) return null;
     const cloned = loadedModel.clone();
     cloned.traverse((child) => {
-      if (child instanceof THREE.Mesh) {
+      if (child instanceof THREE3.Mesh) {
         child.castShadow = castShadow;
         child.receiveShadow = receiveShadow;
       }
@@ -42060,11 +41959,11 @@ function ModelLoader({
     }
   );
 }
-var log12;
+var log11;
 var init_ModelLoader = __esm({
   "components/game/molecules/three/components/ModelLoader.tsx"() {
     "use client";
-    log12 = createLogger("almadar:ui:game:model-loader");
+    log11 = createLogger("almadar:ui:game:model-loader");
   }
 });
 
@@ -42088,6 +41987,47 @@ function CameraController({
   }, [camera.position, onCameraChange]);
   return null;
 }
+function UnitSpriteBillboard({
+  sheetUrl,
+  resolveFrame,
+  height = 1.2
+}) {
+  const texture = useLoader(THREE3.TextureLoader, sheetUrl);
+  const meshRef = useRef(null);
+  const matRef = useRef(null);
+  const [aspect, setAspect] = useState(1);
+  useFrame(() => {
+    const frame = resolveFrame();
+    if (!frame || !texture.image) return;
+    const imgW = texture.image.width;
+    const imgH = texture.image.height;
+    if (!imgW || !imgH) return;
+    texture.repeat.set((frame.flipX ? -1 : 1) * (frame.sw / imgW), frame.sh / imgH);
+    texture.offset.set(
+      frame.flipX ? (frame.sx + frame.sw) / imgW : frame.sx / imgW,
+      1 - (frame.sy + frame.sh) / imgH
+    );
+    texture.magFilter = THREE3.NearestFilter;
+    texture.minFilter = THREE3.NearestFilter;
+    texture.needsUpdate = true;
+    const nextAspect = frame.sw / frame.sh;
+    if (Math.abs(nextAspect - aspect) > 1e-3) setAspect(nextAspect);
+    if (matRef.current) matRef.current.needsUpdate = true;
+  });
+  return /* @__PURE__ */ jsxs("mesh", { ref: meshRef, position: [0, height / 2, 0], children: [
+    /* @__PURE__ */ jsx("planeGeometry", { args: [height * aspect, height] }),
+    /* @__PURE__ */ jsx(
+      "meshBasicMaterial",
+      {
+        ref: matRef,
+        map: texture,
+        transparent: true,
+        alphaTest: 0.1,
+        side: THREE3.DoubleSide
+      }
+    )
+  ] });
+}
 var DEFAULT_GRID_CONFIG, GameCanvas3D;
 var init_GameCanvas3D2 = __esm({
   "components/game/molecules/GameCanvas3D.tsx"() {
@@ -42098,6 +42038,7 @@ var init_GameCanvas3D2 = __esm({
     init_Canvas3DLoadingState2();
     init_Canvas3DErrorBoundary2();
     init_ModelLoader();
+    init_useUnitSpriteAtlas();
     init_cn();
     init_GameCanvas3D();
     DEFAULT_GRID_CONFIG = {
@@ -42154,8 +42095,10 @@ var init_GameCanvas3D2 = __esm({
         const controlsRef = useRef(null);
         const [hoveredTile, setHoveredTile] = useState(null);
         const [internalError, setInternalError] = useState(null);
+        const { sheetUrls: atlasSheetUrls, resolveUnitFrame } = useUnitSpriteAtlas(units);
+        const preloadUrls = useMemo(() => [...preloadAssets, ...atlasSheetUrls], [preloadAssets, atlasSheetUrls]);
         const { isLoading: assetsLoading, progress, loaded, total } = useAssetLoader({
-          preloadUrls: preloadAssets,
+          preloadUrls,
           loader: customAssetLoader
         });
         const eventHandlers = useGameCanvas3DEvents({
@@ -42214,7 +42157,7 @@ var init_GameCanvas3D2 = __esm({
           getCameraPosition: () => {
             if (controlsRef.current) {
               const pos = controlsRef.current.object.position;
-              return new THREE.Vector3(pos.x, pos.y, pos.z);
+              return new THREE3.Vector3(pos.x, pos.y, pos.z);
             }
             return null;
           },
@@ -42366,6 +42309,8 @@ var init_GameCanvas3D2 = __esm({
           ({ unit, position }) => {
             const isSelected = selectedUnitId === unit.id;
             const color = unit.faction === "player" ? 4491519 : unit.faction === "enemy" ? 16729156 : 16777028;
+            const hasAtlas = unitAtlasUrl(unit) !== null;
+            const initialFrame = hasAtlas ? resolveUnitFrame(unit.id) : null;
             return /* @__PURE__ */ jsxs(
               "group",
               {
@@ -42377,7 +42322,16 @@ var init_GameCanvas3D2 = __esm({
                     /* @__PURE__ */ jsx("ringGeometry", { args: [0.4, 0.5, 32] }),
                     /* @__PURE__ */ jsx("meshBasicMaterial", { color: "#ffff00", transparent: true, opacity: 0.8 })
                   ] }),
-                  unit.modelUrl ? (
+                  hasAtlas && initialFrame ? (
+                    /* Animated sprite-sheet billboard — single cropped frame, by state */
+                    /* @__PURE__ */ jsx(Billboard, { children: /* @__PURE__ */ jsx(
+                      UnitSpriteBillboard,
+                      {
+                        sheetUrl: initialFrame.sheetUrl,
+                        resolveFrame: () => resolveUnitFrame(unit.id)
+                      }
+                    ) })
+                  ) : unit.modelUrl ? (
                     /* GLB unit model (box fallback while loading / on error) */
                     /* @__PURE__ */ jsx(
                       ModelLoader,
@@ -42431,7 +42385,7 @@ var init_GameCanvas3D2 = __esm({
               }
             );
           },
-          [selectedUnitId, handleUnitClick]
+          [selectedUnitId, handleUnitClick, resolveUnitFrame]
         );
         const DefaultFeatureRenderer = useCallback(
           ({
@@ -43498,7 +43452,7 @@ var init_List = __esm({
         if (entity && typeof entity === "object" && "id" in entity) return [entity];
         return [];
       }, [entity]);
-      const getItemActions = React83__default.useCallback(
+      const getItemActions = React82__default.useCallback(
         (item) => {
           if (!itemActions) return [];
           if (typeof itemActions === "function") {
@@ -43974,7 +43928,7 @@ var init_MediaGallery = __esm({
         [selectable, selectedItems, selectionEvent, eventBus]
       );
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React83__default.useMemo(() => {
+      const items = React82__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => ({
@@ -44135,7 +44089,7 @@ var init_MediaGallery = __esm({
   }
 });
 function extractTitle2(children) {
-  if (!React83__default.isValidElement(children)) return void 0;
+  if (!React82__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -45140,7 +45094,7 @@ var init_debugRegistry = __esm({
   }
 });
 function useDebugData() {
-  const [data, setData] = React83.useState(() => ({
+  const [data, setData] = React82.useState(() => ({
     traits: [],
     ticks: [],
     guards: [],
@@ -45154,7 +45108,7 @@ function useDebugData() {
     },
     lastUpdate: Date.now()
   }));
-  React83.useEffect(() => {
+  React82.useEffect(() => {
     const updateData = () => {
       setData({
         traits: getAllTraits(),
@@ -45263,12 +45217,12 @@ function layoutGraph(states, transitions, initialState, width, height) {
   return positions;
 }
 function WalkMinimap() {
-  const [walkStep, setWalkStep] = React83.useState(null);
-  const [traits2, setTraits] = React83.useState([]);
-  const [coveredEdges, setCoveredEdges] = React83.useState([]);
-  const [completedTraits, setCompletedTraits] = React83.useState(/* @__PURE__ */ new Set());
-  const prevTraitRef = React83.useRef(null);
-  React83.useEffect(() => {
+  const [walkStep, setWalkStep] = React82.useState(null);
+  const [traits2, setTraits] = React82.useState([]);
+  const [coveredEdges, setCoveredEdges] = React82.useState([]);
+  const [completedTraits, setCompletedTraits] = React82.useState(/* @__PURE__ */ new Set());
+  const prevTraitRef = React82.useRef(null);
+  React82.useEffect(() => {
     const interval = setInterval(() => {
       const w = window;
       const step = w.__orbitalWalkStep;
@@ -45704,15 +45658,15 @@ var init_EntitiesTab = __esm({
 });
 function EventFlowTab({ events: events2 }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React83.useState("all");
-  const containerRef = React83.useRef(null);
-  const [autoScroll, setAutoScroll] = React83.useState(true);
-  React83.useEffect(() => {
+  const [filter, setFilter] = React82.useState("all");
+  const containerRef = React82.useRef(null);
+  const [autoScroll, setAutoScroll] = React82.useState(true);
+  React82.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
   }, [events2.length, autoScroll]);
-  const filteredEvents = React83.useMemo(() => {
+  const filteredEvents = React82.useMemo(() => {
     if (filter === "all") return events2;
     return events2.filter((e) => e.type === filter);
   }, [events2, filter]);
@@ -45828,7 +45782,7 @@ var init_EventFlowTab = __esm({
 });
 function GuardsPanel({ guards }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React83.useState("all");
+  const [filter, setFilter] = React82.useState("all");
   if (guards.length === 0) {
     return /* @__PURE__ */ jsx(
       EmptyState,
@@ -45841,7 +45795,7 @@ function GuardsPanel({ guards }) {
   }
   const passedCount = guards.filter((g) => g.result).length;
   const failedCount = guards.length - passedCount;
-  const filteredGuards = React83.useMemo(() => {
+  const filteredGuards = React82.useMemo(() => {
     if (filter === "all") return guards;
     if (filter === "passed") return guards.filter((g) => g.result);
     return guards.filter((g) => !g.result);
@@ -46004,10 +45958,10 @@ function EffectBadge({ effect }) {
 }
 function TransitionTimeline({ transitions }) {
   const { t } = useTranslate();
-  const containerRef = React83.useRef(null);
-  const [autoScroll, setAutoScroll] = React83.useState(true);
-  const [expandedId, setExpandedId] = React83.useState(null);
-  React83.useEffect(() => {
+  const containerRef = React82.useRef(null);
+  const [autoScroll, setAutoScroll] = React82.useState(true);
+  const [expandedId, setExpandedId] = React82.useState(null);
+  React82.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
@@ -46287,9 +46241,9 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [log14, setLog] = React83.useState([]);
-  const prevStatesRef = React83.useRef(/* @__PURE__ */ new Map());
-  React83.useEffect(() => {
+  const [log13, setLog] = React82.useState([]);
+  const prevStatesRef = React82.useRef(/* @__PURE__ */ new Map());
+  React82.useEffect(() => {
     for (const trait of traits2) {
       const prev = prevStatesRef.current.get(trait.id);
       if (prev && prev !== trait.currentState) {
@@ -46351,9 +46305,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.otherEvents") }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log14.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log13.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.recentTransitions") }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log14.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log13.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -46458,10 +46412,10 @@ function VerifyModePanel({
   localCount
 }) {
   const { t } = useTranslate();
-  const [expanded, setExpanded] = React83.useState(true);
-  const scrollRef = React83.useRef(null);
-  const prevCountRef = React83.useRef(0);
-  React83.useEffect(() => {
+  const [expanded, setExpanded] = React82.useState(true);
+  const scrollRef = React82.useRef(null);
+  const prevCountRef = React82.useRef(0);
+  React82.useEffect(() => {
     if (expanded && transitions.length > prevCountRef.current && scrollRef.current) {
       scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
     }
@@ -46518,10 +46472,10 @@ function RuntimeDebugger({
   schema
 }) {
   const { t } = useTranslate();
-  const [isCollapsed, setIsCollapsed] = React83.useState(mode === "verify" ? true : defaultCollapsed);
-  const [isVisible, setIsVisible] = React83.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
+  const [isCollapsed, setIsCollapsed] = React82.useState(mode === "verify" ? true : defaultCollapsed);
+  const [isVisible, setIsVisible] = React82.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
   const debugData = useDebugData();
-  React83.useEffect(() => {
+  React82.useEffect(() => {
     if (mode === "inline") return;
     return onDebugToggle((enabled) => {
       setIsVisible(enabled);
@@ -46530,7 +46484,7 @@ function RuntimeDebugger({
       }
     });
   }, [mode]);
-  React83.useEffect(() => {
+  React82.useEffect(() => {
     if (mode === "inline") return;
     const handleKeyDown = (e) => {
       if (e.key === "`" && isVisible) {
@@ -47090,7 +47044,7 @@ function SequenceBar({
     onSlotRemove(index);
   }, [onSlotRemove, playing]);
   const paddedSlots = Array.from({ length: maxSlots }, (_, i) => slots[i]);
-  return /* @__PURE__ */ jsx(HStack, { className: cn("items-center", className), gap: "sm", children: paddedSlots.map((slot, i) => /* @__PURE__ */ jsxs(React83__default.Fragment, { children: [
+  return /* @__PURE__ */ jsx(HStack, { className: cn("items-center", className), gap: "sm", children: paddedSlots.map((slot, i) => /* @__PURE__ */ jsxs(React82__default.Fragment, { children: [
     i > 0 && /* @__PURE__ */ jsx(
       Typography,
       {
@@ -47979,7 +47933,7 @@ var init_StatCard = __esm({
       const labelToUse = propLabel ?? propTitle;
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const handleActionClick = React83__default.useCallback(() => {
+      const handleActionClick = React82__default.useCallback(() => {
         if (action?.event) {
           eventBus.emit(`UI:${action.event}`, {});
         }
@@ -47990,7 +47944,7 @@ var init_StatCard = __esm({
       const data = Array.isArray(entity) ? entity : entity ? [entity] : [];
       const isLoading = externalLoading ?? false;
       const error = externalError;
-      const computeMetricValue = React83__default.useCallback(
+      const computeMetricValue = React82__default.useCallback(
         (metric, items) => {
           if (metric.value !== void 0) {
             return metric.value;
@@ -48029,7 +47983,7 @@ var init_StatCard = __esm({
         },
         []
       );
-      const schemaStats = React83__default.useMemo(() => {
+      const schemaStats = React82__default.useMemo(() => {
         if (!metrics || metrics.length === 0) return null;
         return metrics.map((metric) => ({
           label: metric.label,
@@ -48037,7 +47991,7 @@ var init_StatCard = __esm({
           format: metric.format
         }));
       }, [metrics, data, computeMetricValue]);
-      const calculatedTrend = React83__default.useMemo(() => {
+      const calculatedTrend = React82__default.useMemo(() => {
         if (manualTrend !== void 0) return manualTrend;
         if (previousValue === void 0 || currentValue === void 0)
           return void 0;
@@ -49003,7 +48957,7 @@ var init_Timeline = __esm({
     }) => {
       const { t } = useTranslate();
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React83__default.useMemo(() => {
+      const items = React82__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => {
@@ -49110,7 +49064,7 @@ var init_Timeline = __esm({
   }
 });
 function extractToastProps(children) {
-  if (!React83__default.isValidElement(children)) {
+  if (!React82__default.isValidElement(children)) {
     if (typeof children === "string") {
       return { message: children };
     }
@@ -49148,7 +49102,7 @@ var init_ToastSlot = __esm({
         eventBus.emit("UI:CLOSE");
       };
       if (!isVisible) return null;
-      const isCustomContent = React83__default.isValidElement(children) && !message;
+      const isCustomContent = React82__default.isValidElement(children) && !message;
       return /* @__PURE__ */ jsx(Box, { className: "fixed bottom-4 right-4 z-50", children: isCustomContent ? children : /* @__PURE__ */ jsx(
         Toast,
         {
@@ -50017,7 +49971,7 @@ var init_WorldMapTemplate = __esm({
   }
 });
 function lazyThree(name, loader) {
-  const Lazy = React83__default.lazy(
+  const Lazy = React82__default.lazy(
     () => loader().then((m) => {
       const Resolved = m[name];
       if (!Resolved) {
@@ -50029,13 +49983,13 @@ function lazyThree(name, loader) {
     })
   );
   function ThreeWrapper(props) {
-    return React83__default.createElement(
+    return React82__default.createElement(
       ThreeBoundary,
       { name },
-      React83__default.createElement(
-        React83__default.Suspense,
+      React82__default.createElement(
+        React82__default.Suspense,
         { fallback: null },
-        React83__default.createElement(Lazy, props)
+        React82__default.createElement(Lazy, props)
       )
     );
   }
@@ -50333,7 +50287,7 @@ var init_component_registry_generated = __esm({
     init_WorldMapBoard();
     init_WorldMapTemplate();
     init_XPBar();
-    ThreeBoundary = class extends React83__default.Component {
+    ThreeBoundary = class extends React82__default.Component {
       constructor() {
         super(...arguments);
         __publicField(this, "state", { failed: false });
@@ -50343,7 +50297,7 @@ var init_component_registry_generated = __esm({
       }
       render() {
         if (this.state.failed) {
-          return React83__default.createElement(
+          return React82__default.createElement(
             "div",
             {
               "data-testid": "three-unavailable",
@@ -50684,7 +50638,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React83__default.createElement(
+  return React82__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -51174,7 +51128,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
         const key = `${parentId}-${index}-trait:${traitName}`;
         return /* @__PURE__ */ jsx(TraitFrame, { traitName }, key);
       }
-      return /* @__PURE__ */ jsx(React83__default.Fragment, { children: child }, `${parentId}-${index}`);
+      return /* @__PURE__ */ jsx(React82__default.Fragment, { children: child }, `${parentId}-${index}`);
     }
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
@@ -51214,14 +51168,14 @@ function isPatternConfig(value) {
   if (value === null || value === void 0) return false;
   if (typeof value !== "object") return false;
   if (Array.isArray(value)) return false;
-  if (React83__default.isValidElement(value)) return false;
+  if (React82__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
   if (typeof value === "function") return false;
   const record = value;
   return "type" in record && typeof record.type === "string";
 }
 function isPlainConfigObject(value) {
-  if (React83__default.isValidElement(value)) return false;
+  if (React82__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
@@ -51560,9 +51514,6 @@ var init_UISlotRenderer = __esm({
   }
 });
 
-// providers/OrbitalProvider.tsx
-init_ThemeContext();
-
 // providers/EventBusProvider.tsx
 init_useEventBus();
 var busLog = createLogger("almadar:eventbus");
@@ -51714,7 +51665,7 @@ function EventBusProvider({ children, isolated = false }) {
 
 // providers/SelectionProvider.tsx
 init_useEventBus();
-var log3 = createLogger("almadar:ui:selection");
+var log2 = createLogger("almadar:ui:selection");
 var SelectionContext = createContext(null);
 var defaultCompareEntities = (a, b) => {
   if (a === b) return true;
@@ -51737,7 +51688,7 @@ function SelectionProvider({
     (entity) => {
       setSelectedState(entity);
       if (debug2) {
-        log3.debug("Selection set", () => ({
+        log2.debug("Selection set", () => ({
           hasEntity: entity !== null && entity !== void 0,
           entityId: entity && typeof entity === "object" ? String(entity.id ?? "") : ""
         }));
@@ -51748,7 +51699,7 @@ function SelectionProvider({
   const clearSelection = useCallback(() => {
     setSelectedState(null);
     if (debug2) {
-      log3.debug("Selection cleared");
+      log2.debug("Selection cleared");
     }
   }, [debug2]);
   const isSelected = useCallback(
@@ -51763,7 +51714,7 @@ function SelectionProvider({
       if (row) {
         setSelected(row);
         if (debug2) {
-          log3.debug("event received", () => ({
+          log2.debug("event received", () => ({
             type: event.type,
             rowId: row && typeof row === "object" ? String(row.id ?? "") : ""
           }));
@@ -51773,7 +51724,7 @@ function SelectionProvider({
     const handleDeselect = (event) => {
       clearSelection();
       if (debug2) {
-        log3.debug("event received - clearing selection", { type: event.type });
+        log2.debug("event received - clearing selection", { type: event.type });
       }
     };
     const unsubView = eventBus.on("UI:VIEW", handleSelect);
@@ -51815,7 +51766,7 @@ init_UISlotRenderer();
 // providers/VerificationProvider.tsx
 init_useEventBus();
 init_verificationRegistry();
-var log13 = createLogger("almadar:verify");
+var log12 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -51862,7 +51813,7 @@ function VerificationProvider({
     const verificationProviderLifecycleListener = (evt) => {
       const parsed = parseLifecycleEvent(evt.type);
       if (!parsed) return;
-      log13.debug("lifecycle:event", { kind: parsed.kind, traitName: parsed.traitName, event: parsed.event, type: evt.type });
+      log12.debug("lifecycle:event", { kind: parsed.kind, traitName: parsed.traitName, event: parsed.event, type: evt.type });
       const payload = evt.payload ?? {};
       if (parsed.kind === "dispatch") {
         const key = `${parsed.traitName}:${String(payload["event"] ?? "")}`;
@@ -51917,7 +51868,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
-        log13.debug("transition:success", { trait: parsed.traitName, event: parsed.event, from: pending?.from, to: newState, effectCount: effects.length });
+        log12.debug("transition:success", { trait: parsed.traitName, event: parsed.event, from: pending?.from, to: newState, effectCount: effects.length });
       } else if (parsed.kind === "error" && parsed.event) {
         const key = `${parsed.traitName}:${parsed.event}`;
         const pending = pendingRef.current.get(key);
@@ -51947,7 +51898,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
-        log13.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
+        log12.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     };
     Object.defineProperty(verificationProviderLifecycleListener, "name", {