@almadar/ui 5.49.0 → 5.50.0

package/dist/components/index.js

@@ -1,6 +1,6 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
-import * as React77 from 'react';
-import React77__default, { useContext, useMemo, useRef, useEffect, useCallback, useState, Suspense, lazy, createContext, useLayoutEffect, useId, forwardRef, useImperativeHandle, useSyncExternalStore, Component } from 'react';
+import * as React76 from 'react';
+import React76__default, { useContext, useMemo, useRef, useEffect, useCallback, useState, Suspense, lazy, createContext, useLayoutEffect, useId, forwardRef, useImperativeHandle, useSyncExternalStore, Component } from 'react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { EventBusContext, useTraitScope, TraitScopeProvider } from '@almadar/ui/providers';
@@ -9,6 +9,7 @@ import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X, List, Printer, ChevronRight, ChevronLeft, CheckCircle, XCircle, Wrench, RotateCcw, Send, Play, Terminal, Search, ChevronUp, ChevronDown, MoreHorizontal, Bug, Package, Calendar, Pencil, Eye, Image as Image$1, Upload, ZoomIn, ArrowRight, TrendingUp, TrendingDown, Minus, AlertCircle, Circle, Clock, CheckCircle2, Pause, SkipForward, Code, FileText, WrapText, Check, Copy, HelpCircle, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, GitBranch, Plus, Trash, ArrowLeft, Menu as Menu$1, AlertTriangle, Trash2, Eraser, ZoomOut, Download, Lightbulb, PauseCircle, Link2, Tag, User, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { useTranslate } from '@almadar/ui/hooks';
 export * from '@almadar/ui/hooks';
+import { useUISlots, useTheme } from '@almadar/ui/context';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
 import { createPortal } from 'react-dom';
 import { Link, Outlet, useLocation } from 'react-router-dom';
@@ -41,13 +42,12 @@ import { DndContext, useSensors, useSensor, PointerSensor, KeyboardSensor, useDr
 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 { useUISlots } from '@almadar/ui/context';
+import { Canvas, useLoader, useFrame, useThree } from '@react-three/fiber';
+import { Billboard, Grid as Grid$1, OrbitControls } from '@react-three/drei';
 import { getPatternDefinition as getPatternDefinition$1, getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
 
 var __defProp = Object.defineProperty;
@@ -233,7 +233,7 @@ var init_SvgFlow = __esm({
       width = 100,
       height = 100
     }) => {
-      const markerId = React77__default.useMemo(() => {
+      const markerId = React76__default.useMemo(() => {
         flowIdCounter += 1;
         return `almadar-flow-arrow-${flowIdCounter}`;
       }, []);
@@ -826,7 +826,7 @@ var init_SvgRing = __esm({
       width = 100,
       height = 100
     }) => {
-      const gradientId = React77__default.useMemo(() => {
+      const gradientId = React76__default.useMemo(() => {
         ringIdCounter += 1;
         return `almadar-ring-glow-${ringIdCounter}`;
       }, []);
@@ -1238,7 +1238,7 @@ function loadLib(key, importer) {
   return p2;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React77__default.lazy(async () => {
+  const Lazy = React76__default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -1248,7 +1248,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsx(
-    React77__default.Suspense,
+    React76__default.Suspense,
     {
       fallback: /* @__PURE__ */ jsx(
         "span",
@@ -1974,7 +1974,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 = React77__default.useMemo(() => {
+      const RenderedComponent = React76__default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -2033,7 +2033,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React77__default.isValidElement(value)) {
+  if (React76__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -2109,7 +2109,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    Button = React77__default.forwardRef(
+    Button = React76__default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -2176,7 +2176,7 @@ var init_Input = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Input = React77__default.forwardRef(
+    Input = React76__default.forwardRef(
       ({
         className,
         inputType,
@@ -2336,7 +2336,7 @@ var Label;
 var init_Label = __esm({
   "components/core/atoms/Label.tsx"() {
     init_cn();
-    Label = React77__default.forwardRef(
+    Label = React76__default.forwardRef(
       ({ className, required, children, ...props }, ref) => {
         return /* @__PURE__ */ jsxs(
           "label",
@@ -2363,7 +2363,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React77__default.forwardRef(
+    Textarea = React76__default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -2602,7 +2602,7 @@ var init_Select = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Select = React77__default.forwardRef(
+    Select = React76__default.forwardRef(
       (props, _ref) => {
         const { multiple, searchable, clearable } = props;
         if (multiple || searchable || clearable) {
@@ -2619,7 +2619,7 @@ var init_Checkbox = __esm({
   "components/core/atoms/Checkbox.tsx"() {
     init_cn();
     init_useEventBus();
-    Checkbox = React77__default.forwardRef(
+    Checkbox = React76__default.forwardRef(
       ({ className, label, id, onChange, ...props }, ref) => {
         const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
         const eventBus = useEventBus();
@@ -2673,7 +2673,7 @@ var init_Spinner = __esm({
       md: "h-6 w-6",
       lg: "h-8 w-8"
     };
-    Spinner = React77__default.forwardRef(
+    Spinner = React76__default.forwardRef(
       ({ className, size = "md", overlay, ...props }, ref) => {
         if (overlay) {
           return /* @__PURE__ */ jsx(
@@ -2763,7 +2763,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 = React77__default.forwardRef(
+    Card = React76__default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -2811,9 +2811,9 @@ var init_Card = __esm({
       }
     );
     Card.displayName = "Card";
-    CardHeader = React77__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React76__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React77__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardTitle = React76__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "h3",
       {
         ref,
@@ -2826,11 +2826,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React77__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React76__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React77__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardFooter = React76__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "div",
       {
         ref,
@@ -2883,7 +2883,7 @@ var init_Badge = __esm({
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React77__default.forwardRef(
+    Badge = React76__default.forwardRef(
       ({ className, variant = "default", size = "sm", amount, label, icon, children, onRemove, removeLabel, ...props }, ref) => {
         const iconSizes3 = {
           sm: "h-icon-default w-icon-default",
@@ -2976,7 +2976,7 @@ var init_FilterPill = __esm({
       md: "w-3.5 h-3.5",
       lg: "w-4 h-4"
     };
-    FilterPill = React77__default.forwardRef(
+    FilterPill = React76__default.forwardRef(
       ({
         className,
         variant = "default",
@@ -3105,8 +3105,8 @@ var init_Avatar = __esm({
       actionPayload
     }) => {
       const eventBus = useEventBus();
-      const [imgFailed, setImgFailed] = React77__default.useState(false);
-      React77__default.useEffect(() => {
+      const [imgFailed, setImgFailed] = React76__default.useState(false);
+      React76__default.useEffect(() => {
         setImgFailed(false);
       }, [src]);
       const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -3310,7 +3310,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    Box = React77__default.forwardRef(
+    Box = React76__default.forwardRef(
       ({
         padding,
         paddingX,
@@ -3360,7 +3360,7 @@ var init_Box = __esm({
           onMouseLeave?.(e);
         }, [hoverEvent, eventBus, onMouseLeave]);
         const isClickable = action || onClick;
-        return React77__default.createElement(
+        return React76__default.createElement(
           Component2,
           {
             ref,
@@ -3685,7 +3685,7 @@ var init_Radio = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    Radio = React77__default.forwardRef(
+    Radio = React76__default.forwardRef(
       ({
         label,
         helperText,
@@ -3702,12 +3702,12 @@ var init_Radio = __esm({
         onChange,
         ...props
       }, ref) => {
-        const reactId = React77__default.useId();
+        const reactId = React76__default.useId();
         const baseId = id || `radio-${reactId}`;
         const hasError = !!error;
         const eventBus = useEventBus();
-        const [selected, setSelected] = React77__default.useState(value);
-        React77__default.useEffect(() => {
+        const [selected, setSelected] = React76__default.useState(value);
+        React76__default.useEffect(() => {
           if (value !== void 0) setSelected(value);
         }, [value]);
         const pick = (next, e) => {
@@ -3889,7 +3889,7 @@ var init_Switch = __esm({
   "components/core/atoms/Switch.tsx"() {
     "use client";
     init_cn();
-    Switch = React77.forwardRef(
+    Switch = React76.forwardRef(
       ({
         checked,
         defaultChecked = false,
@@ -3900,10 +3900,10 @@ var init_Switch = __esm({
         name,
         className
       }, ref) => {
-        const [isChecked, setIsChecked] = React77.useState(
+        const [isChecked, setIsChecked] = React76.useState(
           checked !== void 0 ? checked : defaultChecked
         );
-        React77.useEffect(() => {
+        React76.useEffect(() => {
           if (checked !== void 0) {
             setIsChecked(checked);
           }
@@ -4277,188 +4277,12 @@ var init_Typography = __esm({
     Typography.displayName = "Typography";
   }
 });
-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 BUILT_IN_THEMES, ThemeContext;
-var init_ThemeContext = __esm({
-  "context/ThemeContext.tsx"() {
-    "use client";
-    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);
-  }
-});
 var sizeClasses4, iconSizes2, ThemeToggle;
 var init_ThemeToggle = __esm({
   "components/core/atoms/ThemeToggle.tsx"() {
     "use client";
     init_Icon();
     init_cn();
-    init_ThemeContext();
     sizeClasses4 = {
       sm: "p-1.5",
       md: "p-2",
@@ -4521,7 +4345,6 @@ var THEME_LABELS, ThemeSelector;
 var init_ThemeSelector = __esm({
   "components/core/atoms/ThemeSelector.tsx"() {
     "use client";
-    init_ThemeContext();
     THEME_LABELS = {
       wireframe: {
         label: "Wireframe",
@@ -4732,7 +4555,7 @@ var Dialog;
 var init_Dialog = __esm({
   "components/core/atoms/Dialog.tsx"() {
     init_cn();
-    Dialog = React77__default.forwardRef(
+    Dialog = React76__default.forwardRef(
       ({
         role = "dialog",
         "aria-modal": ariaModal = true,
@@ -4758,7 +4581,7 @@ var Aside;
 var init_Aside = __esm({
   "components/core/atoms/Aside.tsx"() {
     init_cn();
-    Aside = React77__default.forwardRef(
+    Aside = React76__default.forwardRef(
       ({ className, children, ...rest }, ref) => /* @__PURE__ */ jsx("aside", { ref, className: cn(className), ...rest, children })
     );
     Aside.displayName = "Aside";
@@ -4836,8 +4659,8 @@ var init_LawReferenceTooltip = __esm({
       className
     }) => {
       const { t } = useTranslate();
-      const [isVisible, setIsVisible] = React77__default.useState(false);
-      const timeoutRef = React77__default.useRef(null);
+      const [isVisible, setIsVisible] = React76__default.useState(false);
+      const timeoutRef = React76__default.useRef(null);
       const handleMouseEnter = () => {
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         timeoutRef.current = setTimeout(() => setIsVisible(true), 200);
@@ -4846,7 +4669,7 @@ var init_LawReferenceTooltip = __esm({
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         setIsVisible(false);
       };
-      React77__default.useEffect(() => {
+      React76__default.useEffect(() => {
         return () => {
           if (timeoutRef.current) clearTimeout(timeoutRef.current);
         };
@@ -5056,7 +4879,7 @@ var init_StatusDot = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    StatusDot = React77__default.forwardRef(
+    StatusDot = React76__default.forwardRef(
       ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
         return /* @__PURE__ */ jsx(
           "span",
@@ -5110,7 +4933,7 @@ var init_TrendIndicator = __esm({
       down: "trending-down",
       flat: "arrow-right"
     };
-    TrendIndicator = React77__default.forwardRef(
+    TrendIndicator = React76__default.forwardRef(
       ({
         className,
         value,
@@ -5177,7 +5000,7 @@ var init_RangeSlider = __esm({
       md: "w-4 h-4",
       lg: "w-5 h-5"
     };
-    RangeSlider = React77__default.forwardRef(
+    RangeSlider = React76__default.forwardRef(
       ({
         className,
         min = 0,
@@ -5773,7 +5596,7 @@ var init_ContentSection = __esm({
       md: "py-16",
       lg: "py-24"
     };
-    ContentSection = React77__default.forwardRef(
+    ContentSection = React76__default.forwardRef(
       ({ children, background = "default", padding = "lg", id, className }, ref) => {
         return /* @__PURE__ */ jsx(
           Box,
@@ -6307,7 +6130,7 @@ var init_AnimatedReveal = __esm({
       "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
       "none": {}
     };
-    AnimatedReveal = React77__default.forwardRef(
+    AnimatedReveal = React76__default.forwardRef(
       ({
         trigger = "scroll",
         animation = "fade-up",
@@ -6467,7 +6290,7 @@ var init_AnimatedGraphic = __esm({
   "components/marketing/atoms/AnimatedGraphic.tsx"() {
     "use client";
     init_cn();
-    AnimatedGraphic = React77__default.forwardRef(
+    AnimatedGraphic = React76__default.forwardRef(
       ({
         src,
         svgContent,
@@ -6490,7 +6313,7 @@ var init_AnimatedGraphic = __esm({
         const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
         const resolvedSvg = svgContent ?? fetchedSvg;
         const prevAnimateRef = useRef(animate);
-        const setRef = React77__default.useCallback(
+        const setRef = React76__default.useCallback(
           (node) => {
             containerRef.current = node;
             if (typeof ref === "function") ref(node);
@@ -7172,7 +6995,7 @@ var init_ErrorBoundary = __esm({
         }
       );
     };
-    ErrorBoundary = class extends React77__default.Component {
+    ErrorBoundary = class extends React76__default.Component {
       constructor(props) {
         super(props);
         __publicField(this, "reset", () => {
@@ -8292,9 +8115,9 @@ function ControlButton({
   className
 }) {
   const eventBus = useEventBus();
-  const [isPressed, setIsPressed] = React77.useState(false);
+  const [isPressed, setIsPressed] = React76.useState(false);
   const actualPressed = pressed ?? isPressed;
-  const handlePointerDown = React77.useCallback(
+  const handlePointerDown = React76.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -8304,7 +8127,7 @@ function ControlButton({
     },
     [disabled, pressEvent, eventBus, onPress]
   );
-  const handlePointerUp = React77.useCallback(
+  const handlePointerUp = React76.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -8314,7 +8137,7 @@ function ControlButton({
     },
     [disabled, releaseEvent, eventBus, onRelease]
   );
-  const handlePointerLeave = React77.useCallback(
+  const handlePointerLeave = React76.useCallback(
     (e) => {
       if (isPressed) {
         setIsPressed(false);
@@ -8402,8 +8225,8 @@ function ActionButtons({
   disabled
 }) {
   const eventBus = useEventBus();
-  const [activeButtons, setActiveButtons] = React77.useState(/* @__PURE__ */ new Set());
-  const handlePress = React77.useCallback(
+  const [activeButtons, setActiveButtons] = React76.useState(/* @__PURE__ */ new Set());
+  const handlePress = React76.useCallback(
     (id) => {
       setActiveButtons((prev) => new Set(prev).add(id));
       if (actionEvent) eventBus.emit(`UI:${actionEvent}`, { id, pressed: true });
@@ -8411,7 +8234,7 @@ function ActionButtons({
     },
     [actionEvent, eventBus, onAction]
   );
-  const handleRelease = React77.useCallback(
+  const handleRelease = React76.useCallback(
     (id) => {
       setActiveButtons((prev) => {
         const next = new Set(prev);
@@ -9342,7 +9165,7 @@ function getTraitSnapshots() {
     try {
       snapshots.push(getter());
     } catch (err) {
-      log4.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
+      log3.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
     }
   }
   return snapshots;
@@ -9420,10 +9243,10 @@ function updateAssetStatus(url, status) {
     window.__orbitalVerification.assetStatus[url] = status;
   }
 }
-var log4;
+var log3;
 var init_verificationRegistry = __esm({
   "lib/verificationRegistry.ts"() {
-    log4 = createLogger("almadar:bridge");
+    log3 = createLogger("almadar:bridge");
     exposeOnWindow();
   }
 });
@@ -9550,6 +9373,291 @@ var init_useCamera = __esm({
   }
 });
 
+// components/game/organisms/utils/spriteSheetConstants.ts
+var SHEET_COLUMNS, SPRITE_SHEET_LAYOUT;
+var init_spriteSheetConstants = __esm({
+  "components/game/organisms/utils/spriteSheetConstants.ts"() {
+    SHEET_COLUMNS = 8;
+    SPRITE_SHEET_LAYOUT = {
+      idle: { row: 0, frames: 4, frameRate: 6, loop: true },
+      walk: { row: 1, frames: 8, frameRate: 10, loop: true },
+      attack: { row: 2, frames: 6, frameRate: 12, loop: false },
+      hit: { row: 3, frames: 3, frameRate: 8, loop: false },
+      death: { row: 4, frames: 6, frameRate: 8, loop: false }
+    };
+  }
+});
+
+// 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 };
+}
+function getCurrentFrame(animName, elapsed) {
+  return getCurrentFrameFromDef(SPRITE_SHEET_LAYOUT[animName], elapsed);
+}
+function resolveFrame(sheetUrls, frameDims, animState) {
+  if (!sheetUrls) return null;
+  const { sheetDir, flipX } = resolveSheetDirection(animState.direction);
+  const sheetUrl = sheetUrls[sheetDir];
+  if (!sheetUrl) return null;
+  const def = SPRITE_SHEET_LAYOUT[animState.animation];
+  const { frame } = getCurrentFrame(animState.animation, animState.elapsed);
+  const rect = frameRect(frame, def.row, def.frames, frameDims.width, frameDims.height);
+  return {
+    sheetUrl,
+    sx: rect.sx,
+    sy: rect.sy,
+    sw: rect.sw,
+    sh: rect.sh,
+    flipX
+  };
+}
+function createUnitAnimationState(unitId) {
+  return {
+    unitId,
+    animation: "idle",
+    direction: "se",
+    frame: 0,
+    elapsed: 0,
+    queuedAnimation: null,
+    finished: false
+  };
+}
+function transitionAnimation(state, newAnim, direction) {
+  if (state.animation === "death" && state.finished) return state;
+  if (state.animation === newAnim && SPRITE_SHEET_LAYOUT[newAnim].loop) {
+    return direction ? { ...state, direction } : state;
+  }
+  return {
+    ...state,
+    animation: newAnim,
+    direction: direction ?? state.direction,
+    frame: 0,
+    elapsed: 0,
+    queuedAnimation: null,
+    finished: false
+  };
+}
+function tickAnimationState(state, deltaMs) {
+  const newElapsed = state.elapsed + deltaMs;
+  const { frame, finished } = getCurrentFrame(state.animation, newElapsed);
+  const def = SPRITE_SHEET_LAYOUT[state.animation];
+  if (finished && !def.loop && !state.finished) {
+    if (state.animation === "death") {
+      return { ...state, elapsed: newElapsed, frame, finished: true };
+    }
+    const nextAnim = state.queuedAnimation ?? "idle";
+    return {
+      ...state,
+      animation: nextAnim,
+      elapsed: 0,
+      frame: 0,
+      queuedAnimation: null,
+      finished: false
+    };
+  }
+  return { ...state, elapsed: newElapsed, frame, finished };
+}
+var init_spriteAnimation = __esm({
+  "components/game/organisms/utils/spriteAnimation.ts"() {
+    init_spriteSheetConstants();
+  }
+});
+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) {
   const scaledTileWidth = TILE_WIDTH * scale;
@@ -9663,6 +9771,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;
@@ -9746,9 +9858,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;
@@ -10036,7 +10149,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;
@@ -10146,7 +10259,7 @@ function IsometricCanvas({
     resolveTerrainSpriteUrl,
     resolveFeatureSpriteUrl,
     resolveUnitSpriteUrl,
-    resolveUnitFrame,
+    resolveFrameForUnit,
     getImage,
     gridWidth,
     gridHeight,
@@ -10178,7 +10291,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;
@@ -10194,7 +10307,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));
@@ -10339,6 +10452,7 @@ var init_IsometricCanvas = __esm({
     init_ErrorState();
     init_useImageCache();
     init_useCamera();
+    init_useUnitSpriteAtlas();
     init_verificationRegistry();
     init_isometric();
     IsometricCanvas.displayName = "IsometricCanvas";
@@ -11554,7 +11668,7 @@ var init_avl_elk_layout = __esm({
     elk = new ELK();
   }
 });
-var log5, SWIM_GUTTER, CENTER_W, BehaviorView;
+var log4, SWIM_GUTTER, CENTER_W, BehaviorView;
 var init_BehaviorView = __esm({
   "components/avl/molecules/BehaviorView.tsx"() {
     "use client";
@@ -11563,7 +11677,7 @@ var init_BehaviorView = __esm({
     init_AvlSwimLane();
     init_types();
     init_avl_elk_layout();
-    log5 = createLogger("almadar:ui:avl:behavior-view");
+    log4 = createLogger("almadar:ui:avl:behavior-view");
     SWIM_GUTTER = 120;
     CENTER_W = 360;
     BehaviorView = ({ data }) => {
@@ -11574,7 +11688,7 @@ var init_BehaviorView = __esm({
       const dataKey = useMemo(() => JSON.stringify(traitData), [traitData]);
       useEffect(() => {
         if (!traitData) return;
-        computeTraitLayout(traitData).then(setLayout).catch((err) => log5.error("compute-trait-layout-failed", { error: err instanceof Error ? err : String(err) }));
+        computeTraitLayout(traitData).then(setLayout).catch((err) => log4.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") });
@@ -11985,7 +12099,7 @@ function generateDiff(oldVal, newVal) {
   }
   return diff;
 }
-var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, log6, CODE_LANGUAGES, CODE_LANGUAGE_SET, DIFF_STYLES, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
+var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, log5, 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();
@@ -12068,7 +12182,7 @@ var init_CodeBlock = __esm({
       "lolo-op-async": { color: ORB_COLORS.dark.async }
     };
     loloStyle = { ...dark, ...loloStyleOverrides };
-    log6 = createLogger("almadar:ui:markdown-code");
+    log5 = createLogger("almadar:ui:markdown-code");
     CODE_LANGUAGES = [
       "text",
       "json",
@@ -12107,7 +12221,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    CodeBlock = React77__default.memo(
+    CodeBlock = React76__default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -12332,7 +12446,7 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: true });
             setTimeout(() => setCopied(false), 2e3);
           } catch (err) {
-            log6.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
+            log5.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
             eventBus.emit("UI:COPY_CODE", { language: activeLanguage, success: false });
           }
         };
@@ -12694,7 +12808,7 @@ var init_MarkdownContent = __esm({
     init_Box();
     init_CodeBlock();
     init_cn();
-    MarkdownContent = React77__default.memo(
+    MarkdownContent = React76__default.memo(
       ({ content, direction = "ltr", className }) => {
         const { t: _t } = useTranslate();
         const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -14011,7 +14125,7 @@ var init_StateMachineView = __esm({
                 style: { top: title ? 30 : 0 },
                 children: [
                   entity && /* @__PURE__ */ jsx(EntityBox, { entity, config }),
-                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React77__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
+                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React76__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
                     StateNode,
                     {
                       state,
@@ -16213,14 +16327,14 @@ function useSafeEventBus2() {
     } };
   }
 }
-var log7, lookStyles4, ButtonGroup;
+var log6, lookStyles4, ButtonGroup;
 var init_ButtonGroup = __esm({
   "components/core/molecules/ButtonGroup.tsx"() {
     "use client";
     init_cn();
     init_atoms2();
     init_useEventBus();
-    log7 = createLogger("almadar:ui:button-group");
+    log6 = 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",
@@ -16301,7 +16415,7 @@ var init_ButtonGroup = __esm({
           {
             variant: "ghost",
             onClick: () => {
-              log7.debug("Filter clicked", { field: filter.field });
+              log6.debug("Filter clicked", { field: filter.field });
             },
             children: filter.label
           },
@@ -20762,7 +20876,7 @@ function CraftingRecipe({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCraft = React77.useCallback(() => {
+  const handleCraft = React76.useCallback(() => {
     onCraft?.();
     if (craftEvent) {
       eventBus.emit(craftEvent, { output: output.label });
@@ -20779,7 +20893,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(React77.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React76.Fragment, { children: [
             /* @__PURE__ */ jsx(Box, { className: "relative", children: /* @__PURE__ */ jsx(
               ItemSlot,
               {
@@ -20851,8 +20965,8 @@ function DPad({
 }) {
   const eventBus = useEventBus();
   const sizes = sizeMap6[size];
-  const [activeDirections, setActiveDirections] = React77.useState(/* @__PURE__ */ new Set());
-  const handlePress = React77.useCallback(
+  const [activeDirections, setActiveDirections] = React76.useState(/* @__PURE__ */ new Set());
+  const handlePress = React76.useCallback(
     (direction) => {
       setActiveDirections((prev) => new Set(prev).add(direction));
       if (directionEvent) eventBus.emit(`UI:${directionEvent}`, { direction, pressed: true });
@@ -20860,7 +20974,7 @@ function DPad({
     },
     [directionEvent, eventBus, onDirection]
   );
-  const handleRelease = React77.useCallback(
+  const handleRelease = React76.useCallback(
     (direction) => {
       setActiveDirections((prev) => {
         const next = new Set(prev);
@@ -21731,8 +21845,8 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React77__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React77__default.cloneElement(
+      const triggerChild = React76__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
+      const triggerElement = React76__default.cloneElement(
         triggerChild,
         {
           ref: triggerRef,
@@ -21866,14 +21980,14 @@ function useDataDnd(args) {
   const isZone = Boolean(dragGroup || accepts || sortable);
   const enabled = isZone || Boolean(dndRoot);
   const eventBus = useEventBus();
-  const parentRoot = React77__default.useContext(RootCtx);
+  const parentRoot = React76__default.useContext(RootCtx);
   const isRoot = enabled && parentRoot === null;
-  const zoneId = React77__default.useId();
+  const zoneId = React76__default.useId();
   const ownGroup = dragGroup ?? accepts ?? zoneId;
-  const [optimisticOrders, setOptimisticOrders] = React77__default.useState(() => /* @__PURE__ */ new Map());
-  const optimisticOrdersRef = React77__default.useRef(optimisticOrders);
+  const [optimisticOrders, setOptimisticOrders] = React76__default.useState(() => /* @__PURE__ */ new Map());
+  const optimisticOrdersRef = React76__default.useRef(optimisticOrders);
   optimisticOrdersRef.current = optimisticOrders;
-  const clearOptimisticOrder = React77__default.useCallback((group) => {
+  const clearOptimisticOrder = React76__default.useCallback((group) => {
     setOptimisticOrders((prev) => {
       if (!prev.has(group)) return prev;
       const next = new Map(prev);
@@ -21898,7 +22012,7 @@ function useDataDnd(args) {
     const raw = it[dndItemIdField];
     return String(raw ?? `__idx_${idx}`);
   }).join("|");
-  const itemIds = React77__default.useMemo(
+  const itemIds = React76__default.useMemo(
     () => orderedItems.map((it, idx) => {
       const raw = it[dndItemIdField];
       return raw ?? `__idx_${idx}`;
@@ -21906,7 +22020,7 @@ function useDataDnd(args) {
     [itemIdsSignature]
   );
   const itemsContentSig = items.map((it, idx) => String(it[dndItemIdField] ?? `__${idx}`)).join("|");
-  React77__default.useEffect(() => {
+  React76__default.useEffect(() => {
     const root = isRoot ? null : parentRoot;
     if (root) {
       root.clearOptimisticOrder(ownGroup);
@@ -21914,20 +22028,20 @@ function useDataDnd(args) {
       clearOptimisticOrder(ownGroup);
     }
   }, [itemsContentSig, ownGroup]);
-  const zonesRef = React77__default.useRef(/* @__PURE__ */ new Map());
-  const registerZone = React77__default.useCallback((zoneId2, meta2) => {
+  const zonesRef = React76__default.useRef(/* @__PURE__ */ new Map());
+  const registerZone = React76__default.useCallback((zoneId2, meta2) => {
     zonesRef.current.set(zoneId2, meta2);
   }, []);
-  const unregisterZone = React77__default.useCallback((zoneId2) => {
+  const unregisterZone = React76__default.useCallback((zoneId2) => {
     zonesRef.current.delete(zoneId2);
   }, []);
-  const [activeDrag, setActiveDrag] = React77__default.useState(null);
-  const [overZoneGroup, setOverZoneGroup] = React77__default.useState(null);
-  const meta = React77__default.useMemo(
+  const [activeDrag, setActiveDrag] = React76__default.useState(null);
+  const [overZoneGroup, setOverZoneGroup] = React76__default.useState(null);
+  const meta = React76__default.useMemo(
     () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
     [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
-  React77__default.useEffect(() => {
+  React76__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
     if (!target) {
       zonesRef.current.set(zoneId, meta);
@@ -21946,7 +22060,7 @@ function useDataDnd(args) {
   }, [parentRoot, isRoot, zoneId, meta]);
   const sensors = useAlmadarDndSensors(true);
   const collisionDetection = almadarDndCollisionDetection;
-  const findZoneByItem = React77__default.useCallback(
+  const findZoneByItem = React76__default.useCallback(
     (id) => {
       for (const z of zonesRef.current.values()) {
         if (z.itemIds.includes(id)) return z;
@@ -21955,7 +22069,7 @@ function useDataDnd(args) {
     },
     []
   );
-  React77__default.useCallback(
+  React76__default.useCallback(
     (group) => {
       for (const z of zonesRef.current.values()) {
         if (z.group === group) return z;
@@ -21964,7 +22078,7 @@ function useDataDnd(args) {
     },
     []
   );
-  const handleDragEnd = React77__default.useCallback(
+  const handleDragEnd = React76__default.useCallback(
     (event) => {
       const { active, over } = event;
       const activeIdStr = String(active.id);
@@ -22055,8 +22169,8 @@ function useDataDnd(args) {
     },
     [eventBus]
   );
-  const sortableData = React77__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
-  const SortableItem = React77__default.useCallback(
+  const sortableData = React76__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
+  const SortableItem = React76__default.useCallback(
     ({ id, children }) => {
       const {
         attributes,
@@ -22096,7 +22210,7 @@ function useDataDnd(args) {
       id: droppableId,
       data: sortableData
     });
-    const ctx = React77__default.useContext(RootCtx);
+    const ctx = React76__default.useContext(RootCtx);
     const activeDrag2 = ctx?.activeDrag ?? null;
     const overZoneGroup2 = ctx?.overZoneGroup ?? null;
     const isThisZoneOver = overZoneGroup2 === ownGroup;
@@ -22111,7 +22225,7 @@ function useDataDnd(args) {
       showForeignPlaceholder,
       ctxAvailable: ctx != null
     });
-    React77__default.useEffect(() => {
+    React76__default.useEffect(() => {
       dndLog.info("dropzone:isOver:change", { droppableId, group: ownGroup, isOver, isThisZoneOver, showForeignPlaceholder, activeDragSourceGroup: activeDrag2?.sourceGroup ?? null });
     }, [droppableId, isOver, isThisZoneOver, showForeignPlaceholder]);
     return /* @__PURE__ */ jsx(
@@ -22125,11 +22239,11 @@ function useDataDnd(args) {
       }
     );
   };
-  const rootContextValue = React77__default.useMemo(
+  const rootContextValue = React76__default.useMemo(
     () => ({ registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder }),
     [registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder]
   );
-  const handleDragStart = React77__default.useCallback((event) => {
+  const handleDragStart = React76__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;
@@ -22148,7 +22262,7 @@ function useDataDnd(args) {
       isRoot
     });
   }, [findZoneByItem, isRoot, zoneId]);
-  const handleDragOver = React77__default.useCallback((event) => {
+  const handleDragOver = React76__default.useCallback((event) => {
     const { active, over } = event;
     const overData = over?.data?.current;
     const overGroup = overData?.dndGroup ?? null;
@@ -22218,7 +22332,7 @@ function useDataDnd(args) {
       return next;
     });
   }, []);
-  const handleDragCancel = React77__default.useCallback((event) => {
+  const handleDragCancel = React76__default.useCallback((event) => {
     setActiveDrag(null);
     setOverZoneGroup(null);
     dndLog.warn("dragCancel", {
@@ -22226,12 +22340,12 @@ function useDataDnd(args) {
       reason: "dnd-kit cancelled the drag (escape key, pointer interrupted, or external)"
     });
   }, []);
-  const handleDragEndWithCleanup = React77__default.useCallback((event) => {
+  const handleDragEndWithCleanup = React76__default.useCallback((event) => {
     handleDragEnd(event);
     setActiveDrag(null);
     setOverZoneGroup(null);
   }, [handleDragEnd]);
-  const wrapContainer = React77__default.useCallback(
+  const wrapContainer = React76__default.useCallback(
     (children) => {
       if (!enabled) return children;
       const strategy = layout === "grid" ? rectSortingStrategy : verticalListSortingStrategy;
@@ -22285,7 +22399,7 @@ var init_useDataDnd = __esm({
     init_useAlmadarDndCollision();
     init_Box();
     dndLog = createLogger("almadar:ui:dnd");
-    RootCtx = React77__default.createContext(null);
+    RootCtx = React76__default.createContext(null);
   }
 });
 function renderIconInput(icon, props) {
@@ -22811,7 +22925,7 @@ function DataList({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React77__default.useState(pageSize || Infinity);
+  const [visibleCount, setVisibleCount] = React76__default.useState(pageSize || Infinity);
   const fieldDefs = fields ?? columns ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -22830,7 +22944,7 @@ function DataList({
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
   const hasRenderProp = typeof children === "function";
-  React77__default.useEffect(() => {
+  React76__default.useEffect(() => {
     const renderItemTypeOf = typeof schemaRenderItem;
     const childrenTypeOf = typeof children;
     if (data.length > 0 && !hasRenderProp) {
@@ -22935,7 +23049,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(React77__default.Fragment, { children: [
+    return /* @__PURE__ */ jsx(VStack, { gap: "sm", className: cn("py-2", className), children: groups2.map((group, gi) => /* @__PURE__ */ jsxs(React76__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}`;
@@ -23076,7 +23190,7 @@ function DataList({
           className
         ),
         children: [
-          groups.map((group, gi) => /* @__PURE__ */ jsxs(React77__default.Fragment, { children: [
+          groups.map((group, gi) => /* @__PURE__ */ jsxs(React76__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)
@@ -23183,8 +23297,8 @@ function ScalarControl({
   }
   const numeric = typeof value === "number";
   const initial = value === null ? "" : String(value);
-  const [draft, setDraft] = React77__default.useState(initial);
-  React77__default.useEffect(() => setDraft(initial), [initial]);
+  const [draft, setDraft] = React76__default.useState(initial);
+  React76__default.useEffect(() => setDraft(initial), [initial]);
   const commit = () => {
     if (numeric) {
       const n = draft.trim() === "" ? 0 : Number(draft);
@@ -23252,8 +23366,8 @@ function Row({
   onRemove,
   readonly
 }) {
-  const [keyDraft, setKeyDraft] = React77__default.useState(rowKey);
-  React77__default.useEffect(() => setKeyDraft(rowKey), [rowKey]);
+  const [keyDraft, setKeyDraft] = React76__default.useState(rowKey);
+  React76__default.useEffect(() => setKeyDraft(rowKey), [rowKey]);
   const container = isObj(value) || isArr(value);
   return /* @__PURE__ */ jsxs(VStack, { gap: "none", className: "group w-max min-w-full", children: [
     /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", className: "py-0.5 w-max", children: [
@@ -23296,7 +23410,7 @@ function ContainerNode({
   depth,
   readonly
 }) {
-  const [open, setOpen] = React77__default.useState(depth < 2);
+  const [open, setOpen] = React76__default.useState(depth < 2);
   const array = isArr(value);
   const entries = array ? value.map((v, i) => [String(i), v]) : Object.entries(value);
   const setObjValue = (key, next) => {
@@ -23438,7 +23552,7 @@ var init_FormSection = __esm({
       columns = 1,
       className
     }) => {
-      const [collapsed, setCollapsed] = React77__default.useState(defaultCollapsed);
+      const [collapsed, setCollapsed] = React76__default.useState(defaultCollapsed);
       const { t } = useTranslate();
       const eventBus = useEventBus();
       const gridClass = {
@@ -23446,7 +23560,7 @@ var init_FormSection = __esm({
         2: "grid-cols-1 md:grid-cols-2",
         3: "grid-cols-1 md:grid-cols-2 lg:grid-cols-3"
       }[columns];
-      React77__default.useCallback(() => {
+      React76__default.useCallback(() => {
         if (collapsible) {
           setCollapsed((prev) => !prev);
           eventBus.emit("UI:TOGGLE_COLLAPSE", { collapsed: !collapsed });
@@ -23854,8 +23968,8 @@ function TextLikeControl({
   onCommit
 }) {
   const initial = value === void 0 || value === null ? "" : String(value);
-  const [draft, setDraft] = React77__default.useState(initial);
-  React77__default.useEffect(() => setDraft(initial), [initial]);
+  const [draft, setDraft] = React76__default.useState(initial);
+  React76__default.useEffect(() => setDraft(initial), [initial]);
   const commit = () => {
     if (numeric) {
       const n = draft.trim() === "" ? 0 : Number(draft);
@@ -24021,14 +24135,14 @@ var init_NodeSlotEditor = __esm({
     isObj2 = (v) => v !== null && v !== void 0 && typeof v === "object" && !Array.isArray(v);
     NodeSlotEditor = ({ value, onChange, className }) => {
       const { type, props, wasArray } = normalize(value);
-      const patterns = React77__default.useMemo(() => {
+      const patterns = React76__default.useMemo(() => {
         try {
           return [...getKnownPatterns()].sort();
         } catch {
           return [];
         }
       }, []);
-      const options = React77__default.useMemo(
+      const options = React76__default.useMemo(
         () => [{ value: "", label: "\u2014 none \u2014" }, ...patterns.map((p2) => ({ value: p2, label: p2 }))],
         [patterns]
       );
@@ -24040,7 +24154,7 @@ var init_NodeSlotEditor = __esm({
         const pattern = { type: nextType, ...nextProps };
         onChange(wasArray || value === void 0 ? [pattern] : pattern);
       };
-      const schemaEntries = React77__default.useMemo(() => {
+      const schemaEntries = React76__default.useMemo(() => {
         if (!type) return [];
         const def = getPatternDefinition(type);
         if (!def?.propsSchema) return [];
@@ -24934,7 +25048,7 @@ var init_Grid = __esm({
       as: Component2 = "div"
     }) => {
       const mergedStyle = rows2 ? { gridTemplateRows: `repeat(${rows2}, minmax(0, 1fr))`, ...style } : style;
-      return React77__default.createElement(
+      return React76__default.createElement(
         Component2,
         {
           className: cn(
@@ -25122,8 +25236,8 @@ var init_Popover = __esm({
         onMouseEnter: handleOpen,
         onMouseLeave: handleClose
       };
-      const childElement = React77__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const triggerElement = React77__default.cloneElement(
+      const childElement = React76__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const triggerElement = React76__default.cloneElement(
         childElement,
         {
           ref: triggerRef,
@@ -25429,9 +25543,9 @@ function debug(...args) {
   const [first, ...rest] = args;
   const message = typeof first === "string" ? first : "<debug>";
   if (rest.length === 0 && typeof first === "string") {
-    log8.debug(message);
+    log7.debug(message);
   } else {
-    log8.debug(message, { args: rest.length > 0 ? formatArgs(rest) : formatArgs([first]) });
+    log7.debug(message, { args: rest.length > 0 ? formatArgs(rest) : formatArgs([first]) });
   }
 }
 function debugGroup(label) {
@@ -25459,11 +25573,11 @@ function toLogMetaValue(v) {
   }
   return String(v);
 }
-var NAMESPACE, log8;
+var NAMESPACE, log7;
 var init_debug = __esm({
   "lib/debug.ts"() {
     NAMESPACE = "almadar:ui:debug";
-    log8 = createLogger(NAMESPACE);
+    log7 = createLogger(NAMESPACE);
     createLogger("almadar:ui:debug:input");
     createLogger("almadar:ui:debug:collision");
     createLogger("almadar:ui:debug:physics");
@@ -25963,8 +26077,8 @@ var init_Tooltip = __esm({
           if (hideTimeoutRef.current) clearTimeout(hideTimeoutRef.current);
         };
       }, []);
-      const triggerElement = React77__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const trigger = React77__default.cloneElement(triggerElement, {
+      const triggerElement = React76__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const trigger = React76__default.cloneElement(triggerElement, {
         ref: triggerRef,
         onMouseEnter: handleMouseEnter,
         onMouseLeave: handleMouseLeave,
@@ -26050,7 +26164,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(React77__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
               /* @__PURE__ */ jsx(
                 "button",
                 {
@@ -27095,9 +27209,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] = React77.useState(resolvedValue);
-  const [isAnimating, setIsAnimating] = React77.useState(false);
-  React77.useEffect(() => {
+  const [displayValue, setDisplayValue] = React76.useState(resolvedValue);
+  const [isAnimating, setIsAnimating] = React76.useState(false);
+  React76.useEffect(() => {
     if (!animated || displayValue === resolvedValue) {
       setDisplayValue(resolvedValue);
       return;
@@ -27268,7 +27382,7 @@ function InventoryGrid({
   const eventBus = useEventBus();
   const slotCount = totalSlots ?? items.length;
   const emptySlotCount = Math.max(0, slotCount - items.length);
-  const handleSelect = React77.useCallback(
+  const handleSelect = React76.useCallback(
     (id) => {
       onSelect?.(id);
       if (selectEvent) {
@@ -27584,31 +27698,31 @@ function GameCanvas2D({
   assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   className
 }) {
-  const canvasRef = React77.useRef(null);
-  const rafRef = React77.useRef(0);
-  const frameRef = React77.useRef(0);
-  const lastTimeRef = React77.useRef(0);
-  const imageCache = React77.useRef(/* @__PURE__ */ new Map());
+  const canvasRef = React76.useRef(null);
+  const rafRef = React76.useRef(0);
+  const frameRef = React76.useRef(0);
+  const lastTimeRef = React76.useRef(0);
+  const imageCache = React76.useRef(/* @__PURE__ */ new Map());
   const emit = useEmitEvent();
-  const onDrawRef = React77.useRef(onDraw);
+  const onDrawRef = React76.useRef(onDraw);
   onDrawRef.current = onDraw;
-  const onTickRef = React77.useRef(onTick);
+  const onTickRef = React76.useRef(onTick);
   onTickRef.current = onTick;
-  const tickEventRef = React77.useRef(tickEvent);
+  const tickEventRef = React76.useRef(tickEvent);
   tickEventRef.current = tickEvent;
-  const drawEventRef = React77.useRef(drawEvent);
+  const drawEventRef = React76.useRef(drawEvent);
   drawEventRef.current = drawEvent;
-  const emitRef = React77.useRef(emit);
+  const emitRef = React76.useRef(emit);
   emitRef.current = emit;
-  const assetBaseUrlRef = React77.useRef(assetBaseUrl);
+  const assetBaseUrlRef = React76.useRef(assetBaseUrl);
   assetBaseUrlRef.current = assetBaseUrl;
-  const backgroundImageRef = React77.useRef(backgroundImage);
+  const backgroundImageRef = React76.useRef(backgroundImage);
   backgroundImageRef.current = backgroundImage;
-  const widthRef = React77.useRef(width);
+  const widthRef = React76.useRef(width);
   widthRef.current = width;
-  const heightRef = React77.useRef(height);
+  const heightRef = React76.useRef(height);
   heightRef.current = height;
-  const loadImage = React77.useCallback((url) => {
+  const loadImage = React76.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;
@@ -27620,7 +27734,7 @@ function GameCanvas2D({
     }
     return null;
   }, []);
-  React77.useEffect(() => {
+  React76.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -27996,7 +28110,7 @@ function TurnPanel({
   className
 }) {
   const eventBus = useEventBus();
-  const handleAction = React77.useCallback(
+  const handleAction = React76.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { turn: currentTurn, phase, activeTeam });
@@ -28165,7 +28279,7 @@ function UnitCommandBar({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCommand = React77.useCallback(
+  const handleCommand = React76.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { unitId: selectedUnitId });
@@ -28679,7 +28793,7 @@ function GameMenu({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleOptionClick = React77.useCallback(
+  const handleOptionClick = React76.useCallback(
     (option) => {
       if (option.event && eventBus) {
         eventBus.emit(`UI:${option.event}`, { option });
@@ -28798,7 +28912,7 @@ function GameOverScreen({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleActionClick = React77.useCallback(
+  const handleActionClick = React76.useCallback(
     (action) => {
       if (action.event && eventBus) {
         eventBus.emit(`UI:${action.event}`, { action });
@@ -29709,12 +29823,12 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect80, useRef: useRef77, useCallback: useCallback120, useState: useState110 } = React77__default;
+      const { useEffect: useEffect80, useRef: useRef78, useCallback: useCallback120, useState: useState110 } = React76__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 = useRef77({ centerLat, centerLng, zoom });
+        const prevRef = useRef78({ centerLat, centerLng, zoom });
         useEffect80(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
@@ -30615,8 +30729,8 @@ function TableView({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React77__default.useState(pageSize > 0 ? pageSize : Infinity);
-  const [localSelected, setLocalSelected] = React77__default.useState(/* @__PURE__ */ new Set());
+  const [visibleCount, setVisibleCount] = React76__default.useState(pageSize > 0 ? pageSize : Infinity);
+  const [localSelected, setLocalSelected] = React76__default.useState(/* @__PURE__ */ new Set());
   const colDefs = columns ?? fields ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -30811,12 +30925,12 @@ function TableView({
         ]
       }
     );
-    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React77__default.Fragment, { children: rowInner }, id);
+    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React76__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(React77__default.Fragment, { children: [
+  const body = /* @__PURE__ */ jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxs(React76__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)) });
@@ -32173,7 +32287,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(React77__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(React76__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" })
@@ -32184,7 +32298,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(React77__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(React76__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 }),
@@ -33169,7 +33283,7 @@ var init_LikertScale = __esm({
       md: "text-base",
       lg: "text-lg"
     };
-    LikertScale = React77__default.forwardRef(
+    LikertScale = React76__default.forwardRef(
       ({
         question,
         options = DEFAULT_LIKERT_OPTIONS,
@@ -33181,7 +33295,7 @@ var init_LikertScale = __esm({
         variant = "radios",
         className
       }, ref) => {
-        const groupId = React77__default.useId();
+        const groupId = React76__default.useId();
         const eventBus = useEventBus();
         const handleSelect = useCallback(
           (next) => {
@@ -35463,7 +35577,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(React77__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsx(
                 Icon,
                 {
@@ -36332,7 +36446,7 @@ var init_MiniStateMachine = __esm({
           const x = 2 + i * (NODE_W + GAP2 + ARROW_W + GAP2);
           const tc = transitionCounts[s.name] ?? 0;
           const role = getStateRole(s.name, s.isInitial, s.isTerminal, tc, maxTC);
-          return /* @__PURE__ */ jsxs(React77__default.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
             /* @__PURE__ */ jsx(
               AvlState,
               {
@@ -36536,7 +36650,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(React77__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(React76__default.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: "/" }),
           crumb.href ? /* @__PURE__ */ jsx(
             "a",
@@ -37265,7 +37379,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(React77__default.Fragment, { children: [
+              return /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
                 /* @__PURE__ */ jsx(
                   Button,
                   {
@@ -39850,7 +39964,7 @@ var init_DialogueBubble = __esm({
   }
 });
 function extractTitle(children) {
-  if (!React77__default.isValidElement(children)) return void 0;
+  if (!React76__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -39975,7 +40089,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(React77__default.Fragment, { children: [
+      return /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
         i > 0 && /* @__PURE__ */ jsx(
           Typography,
           {
@@ -40925,12 +41039,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 = React77__default.useMemo(() => {
+      const normalizedInitialData = React76__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 = React77__default.useMemo(() => {
+      const entityDerivedFields = React76__default.useMemo(() => {
         if (fields && fields.length > 0) return void 0;
         if (!resolvedEntity) return void 0;
         return resolvedEntity.fields.map(
@@ -40950,16 +41064,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] = React77__default.useState(
+      const [formData, setFormData] = React76__default.useState(
         normalizedInitialData
       );
-      const [collapsedSections, setCollapsedSections] = React77__default.useState(
+      const [collapsedSections, setCollapsedSections] = React76__default.useState(
         /* @__PURE__ */ new Set()
       );
-      const [submitError, setSubmitError] = React77__default.useState(null);
-      const formRef = React77__default.useRef(null);
+      const [submitError, setSubmitError] = React76__default.useState(null);
+      const formRef = React76__default.useRef(null);
       const formMode = props.mode;
-      const mountedRef = React77__default.useRef(false);
+      const mountedRef = React76__default.useRef(false);
       if (!mountedRef.current) {
         mountedRef.current = true;
         debug("forms", "mount", {
@@ -40972,7 +41086,7 @@ var init_Form = __esm({
         });
       }
       const shouldShowCancel = showCancel ?? (fields && fields.length > 0);
-      const evalContext = React77__default.useMemo(
+      const evalContext = React76__default.useMemo(
         () => ({
           formValues: formData,
           globalVariables: externalContext?.globalVariables ?? {},
@@ -40981,7 +41095,7 @@ var init_Form = __esm({
         }),
         [formData, externalContext]
       );
-      React77__default.useEffect(() => {
+      React76__default.useEffect(() => {
         debug("forms", "initialData-sync", {
           mode: formMode,
           normalizedInitialData,
@@ -40992,7 +41106,7 @@ var init_Form = __esm({
           setFormData(normalizedInitialData);
         }
       }, [normalizedInitialData]);
-      const processCalculations = React77__default.useCallback(
+      const processCalculations = React76__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!hiddenCalculations.length) return;
           const context = {
@@ -41017,7 +41131,7 @@ var init_Form = __esm({
         },
         [hiddenCalculations, externalContext, eventBus]
       );
-      const checkViolations = React77__default.useCallback(
+      const checkViolations = React76__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!violationTriggers.length) return;
           const context = {
@@ -41055,7 +41169,7 @@ var init_Form = __esm({
         processCalculations(name, newFormData);
         checkViolations(name, newFormData);
       };
-      const isFieldVisible = React77__default.useCallback(
+      const isFieldVisible = React76__default.useCallback(
         (fieldName) => {
           const condition = conditionalFields[fieldName];
           if (!condition) return true;
@@ -41063,7 +41177,7 @@ var init_Form = __esm({
         },
         [conditionalFields, evalContext]
       );
-      const isSectionVisible = React77__default.useCallback(
+      const isSectionVisible = React76__default.useCallback(
         (section) => {
           if (!section.condition) return true;
           return Boolean(evaluateFormExpression(section.condition, evalContext));
@@ -41139,7 +41253,7 @@ var init_Form = __esm({
           eventBus.emit(`UI:${onCancel}`);
         }
       };
-      const renderField = React77__default.useCallback(
+      const renderField = React76__default.useCallback(
         (field) => {
           const fieldName = field.name || field.field;
           if (!fieldName) return null;
@@ -41160,7 +41274,7 @@ var init_Form = __esm({
         [formData, isFieldVisible, relationsData, relationsLoading, isLoading]
       );
       const effectiveFields = entityDerivedFields ?? fields;
-      const normalizedFields = React77__default.useMemo(() => {
+      const normalizedFields = React76__default.useMemo(() => {
         if (!effectiveFields || effectiveFields.length === 0) return [];
         return effectiveFields.map((field) => {
           if (typeof field === "string") {
@@ -41183,7 +41297,7 @@ var init_Form = __esm({
           return field;
         });
       }, [effectiveFields, resolvedEntity]);
-      const schemaFields = React77__default.useMemo(() => {
+      const schemaFields = React76__default.useMemo(() => {
         if (normalizedFields.length === 0) return null;
         if (isDebugEnabled()) {
           debugGroup(`Form: ${entityName || "unknown"}`);
@@ -41193,7 +41307,7 @@ var init_Form = __esm({
         }
         return normalizedFields.map(renderField).filter(Boolean);
       }, [normalizedFields, renderField, entityName, conditionalFields]);
-      const sectionElements = React77__default.useMemo(() => {
+      const sectionElements = React76__default.useMemo(() => {
         if (!sections || sections.length === 0) return null;
         return sections.map((section) => {
           if (!isSectionVisible(section)) {
@@ -41809,7 +41923,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();
@@ -41883,7 +41997,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;
@@ -41957,7 +42071,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());
@@ -42370,11 +42484,11 @@ var init_Canvas3DErrorBoundary = __esm({
   "components/game/molecules/three/components/Canvas3DErrorBoundary.css"() {
   }
 });
-var log9, Canvas3DErrorBoundary;
+var log8, Canvas3DErrorBoundary;
 var init_Canvas3DErrorBoundary2 = __esm({
   "components/game/molecules/three/components/Canvas3DErrorBoundary.tsx"() {
     init_Canvas3DErrorBoundary();
-    log9 = createLogger("almadar:ui:game:canvas3d:error-boundary");
+    log8 = createLogger("almadar:ui:game:canvas3d:error-boundary");
     Canvas3DErrorBoundary = class extends Component {
       constructor(props) {
         super(props);
@@ -42402,8 +42516,8 @@ var init_Canvas3DErrorBoundary2 = __esm({
       componentDidCatch(error, errorInfo) {
         this.setState({ errorInfo });
         this.props.onError?.(error, errorInfo);
-        log9.error("Error caught", { error });
-        log9.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
+        log8.error("Error caught", { error });
+        log8.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
       }
       render() {
         if (this.state.hasError) {
@@ -42466,7 +42580,7 @@ function useGLTFModel(url, resourceBasePath) {
       setState({ model: null, isLoading: false, error: null });
       return;
     }
-    log10.debug("Loading", { url });
+    log9.debug("Loading", { url });
     setState((prev) => ({ ...prev, isLoading: true, error: null }));
     const assetRoot = resourceBasePath || detectAssetRoot2(url);
     const loader = new GLTFLoader$1();
@@ -42474,7 +42588,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        log10.debug("Loaded", { url });
+        log9.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -42483,7 +42597,7 @@ function useGLTFModel(url, resourceBasePath) {
       },
       void 0,
       (err) => {
-        log10.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
+        log9.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
         setState({
           model: null,
           isLoading: false,
@@ -42513,7 +42627,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;
       }
@@ -42599,11 +42713,11 @@ function ModelLoader({
     }
   );
 }
-var log10;
+var log9;
 var init_ModelLoader = __esm({
   "components/game/molecules/three/components/ModelLoader.tsx"() {
     "use client";
-    log10 = createLogger("almadar:ui:game:model-loader");
+    log9 = createLogger("almadar:ui:game:model-loader");
   }
 });
 
@@ -42627,6 +42741,47 @@ function CameraController({
   }, [camera.position, onCameraChange]);
   return null;
 }
+function UnitSpriteBillboard({
+  sheetUrl,
+  resolveFrame: resolveFrame2,
+  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 = resolveFrame2();
+    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"() {
@@ -42637,6 +42792,7 @@ var init_GameCanvas3D2 = __esm({
     init_Canvas3DLoadingState2();
     init_Canvas3DErrorBoundary2();
     init_ModelLoader();
+    init_useUnitSpriteAtlas();
     init_cn();
     init_GameCanvas3D();
     DEFAULT_GRID_CONFIG = {
@@ -42693,8 +42849,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({
@@ -42753,7 +42911,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;
           },
@@ -42905,6 +43063,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",
               {
@@ -42916,7 +43076,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,
@@ -42970,7 +43139,7 @@ var init_GameCanvas3D2 = __esm({
               }
             );
           },
-          [selectedUnitId, handleUnitClick]
+          [selectedUnitId, handleUnitClick, resolveUnitFrame]
         );
         const DefaultFeatureRenderer = useCallback(
           ({
@@ -44037,7 +44206,7 @@ var init_List = __esm({
         if (entity && typeof entity === "object" && "id" in entity) return [entity];
         return [];
       }, [entity]);
-      const getItemActions = React77__default.useCallback(
+      const getItemActions = React76__default.useCallback(
         (item) => {
           if (!itemActions) return [];
           if (typeof itemActions === "function") {
@@ -44513,7 +44682,7 @@ var init_MediaGallery = __esm({
         [selectable, selectedItems, selectionEvent, eventBus]
       );
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React77__default.useMemo(() => {
+      const items = React76__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => ({
@@ -44683,9 +44852,9 @@ function MiniMap({
   viewportRect = DEFAULT_VIEWPORT,
   className
 }) {
-  const canvasRef = React77.useRef(null);
-  const frameRef = React77.useRef(0);
-  React77.useEffect(() => {
+  const canvasRef = React76.useRef(null);
+  const frameRef = React76.useRef(0);
+  React76.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -44782,7 +44951,7 @@ var init_MiniMap = __esm({
   }
 });
 function extractTitle2(children) {
-  if (!React77__default.isValidElement(children)) return void 0;
+  if (!React76__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -45853,7 +46022,7 @@ var init_debugRegistry = __esm({
   }
 });
 function useDebugData() {
-  const [data, setData] = React77.useState(() => ({
+  const [data, setData] = React76.useState(() => ({
     traits: [],
     ticks: [],
     guards: [],
@@ -45867,7 +46036,7 @@ function useDebugData() {
     },
     lastUpdate: Date.now()
   }));
-  React77.useEffect(() => {
+  React76.useEffect(() => {
     const updateData = () => {
       setData({
         traits: getAllTraits(),
@@ -45976,12 +46145,12 @@ function layoutGraph(states, transitions, initialState, width, height) {
   return positions;
 }
 function WalkMinimap() {
-  const [walkStep, setWalkStep] = React77.useState(null);
-  const [traits2, setTraits] = React77.useState([]);
-  const [coveredEdges, setCoveredEdges] = React77.useState([]);
-  const [completedTraits, setCompletedTraits] = React77.useState(/* @__PURE__ */ new Set());
-  const prevTraitRef = React77.useRef(null);
-  React77.useEffect(() => {
+  const [walkStep, setWalkStep] = React76.useState(null);
+  const [traits2, setTraits] = React76.useState([]);
+  const [coveredEdges, setCoveredEdges] = React76.useState([]);
+  const [completedTraits, setCompletedTraits] = React76.useState(/* @__PURE__ */ new Set());
+  const prevTraitRef = React76.useRef(null);
+  React76.useEffect(() => {
     const interval = setInterval(() => {
       const w = window;
       const step = w.__orbitalWalkStep;
@@ -46417,15 +46586,15 @@ var init_EntitiesTab = __esm({
 });
 function EventFlowTab({ events: events2 }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React77.useState("all");
-  const containerRef = React77.useRef(null);
-  const [autoScroll, setAutoScroll] = React77.useState(true);
-  React77.useEffect(() => {
+  const [filter, setFilter] = React76.useState("all");
+  const containerRef = React76.useRef(null);
+  const [autoScroll, setAutoScroll] = React76.useState(true);
+  React76.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
   }, [events2.length, autoScroll]);
-  const filteredEvents = React77.useMemo(() => {
+  const filteredEvents = React76.useMemo(() => {
     if (filter === "all") return events2;
     return events2.filter((e) => e.type === filter);
   }, [events2, filter]);
@@ -46541,7 +46710,7 @@ var init_EventFlowTab = __esm({
 });
 function GuardsPanel({ guards }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React77.useState("all");
+  const [filter, setFilter] = React76.useState("all");
   if (guards.length === 0) {
     return /* @__PURE__ */ jsx(
       EmptyState,
@@ -46554,7 +46723,7 @@ function GuardsPanel({ guards }) {
   }
   const passedCount = guards.filter((g) => g.result).length;
   const failedCount = guards.length - passedCount;
-  const filteredGuards = React77.useMemo(() => {
+  const filteredGuards = React76.useMemo(() => {
     if (filter === "all") return guards;
     if (filter === "passed") return guards.filter((g) => g.result);
     return guards.filter((g) => !g.result);
@@ -46717,10 +46886,10 @@ function EffectBadge({ effect }) {
 }
 function TransitionTimeline({ transitions }) {
   const { t } = useTranslate();
-  const containerRef = React77.useRef(null);
-  const [autoScroll, setAutoScroll] = React77.useState(true);
-  const [expandedId, setExpandedId] = React77.useState(null);
-  React77.useEffect(() => {
+  const containerRef = React76.useRef(null);
+  const [autoScroll, setAutoScroll] = React76.useState(true);
+  const [expandedId, setExpandedId] = React76.useState(null);
+  React76.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
@@ -47000,9 +47169,9 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [log11, setLog] = React77.useState([]);
-  const prevStatesRef = React77.useRef(/* @__PURE__ */ new Map());
-  React77.useEffect(() => {
+  const [log10, setLog] = React76.useState([]);
+  const prevStatesRef = React76.useRef(/* @__PURE__ */ new Map());
+  React76.useEffect(() => {
     for (const trait of traits2) {
       const prev = prevStatesRef.current.get(trait.id);
       if (prev && prev !== trait.currentState) {
@@ -47064,9 +47233,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)) })
     ] }),
-    log11.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log10.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: log11.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log10.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 }),
@@ -47171,10 +47340,10 @@ function VerifyModePanel({
   localCount
 }) {
   const { t } = useTranslate();
-  const [expanded, setExpanded] = React77.useState(true);
-  const scrollRef = React77.useRef(null);
-  const prevCountRef = React77.useRef(0);
-  React77.useEffect(() => {
+  const [expanded, setExpanded] = React76.useState(true);
+  const scrollRef = React76.useRef(null);
+  const prevCountRef = React76.useRef(0);
+  React76.useEffect(() => {
     if (expanded && transitions.length > prevCountRef.current && scrollRef.current) {
       scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
     }
@@ -47231,10 +47400,10 @@ function RuntimeDebugger({
   schema
 }) {
   const { t } = useTranslate();
-  const [isCollapsed, setIsCollapsed] = React77.useState(mode === "verify" ? true : defaultCollapsed);
-  const [isVisible, setIsVisible] = React77.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
+  const [isCollapsed, setIsCollapsed] = React76.useState(mode === "verify" ? true : defaultCollapsed);
+  const [isVisible, setIsVisible] = React76.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
   const debugData = useDebugData();
-  React77.useEffect(() => {
+  React76.useEffect(() => {
     if (mode === "inline") return;
     return onDebugToggle((enabled) => {
       setIsVisible(enabled);
@@ -47243,7 +47412,7 @@ function RuntimeDebugger({
       }
     });
   }, [mode]);
-  React77.useEffect(() => {
+  React76.useEffect(() => {
     if (mode === "inline") return;
     const handleKeyDown = (e) => {
       if (e.key === "`" && isVisible) {
@@ -47803,7 +47972,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(React77__default.Fragment, { children: [
+  return /* @__PURE__ */ jsx(HStack, { className: cn("items-center", className), gap: "sm", children: paddedSlots.map((slot, i) => /* @__PURE__ */ jsxs(React76__default.Fragment, { children: [
     i > 0 && /* @__PURE__ */ jsx(
       Typography,
       {
@@ -48674,12 +48843,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 = [
@@ -48737,8 +48902,7 @@ function drawSprite(ctx, image, props) {
     opacity = 1,
     columns = 16
   } = props;
-  const sourceX = frame % columns * frameWidth;
-  const sourceY = Math.floor(frame / columns) * frameHeight;
+  const { sx: sourceX, sy: sourceY } = frameRect(frame, Math.floor(frame / columns), columns, frameWidth, frameHeight);
   ctx.save();
   ctx.globalAlpha = opacity;
   ctx.translate(x + frameWidth / 2, y + frameHeight / 2);
@@ -48763,6 +48927,7 @@ var init_Sprite = __esm({
   "components/game/atoms/Sprite.tsx"() {
     "use client";
     init_useEventBus();
+    init_spriteAnimation();
   }
 });
 var StatCard;
@@ -48803,7 +48968,7 @@ var init_StatCard = __esm({
       const labelToUse = propLabel ?? propTitle;
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const handleActionClick = React77__default.useCallback(() => {
+      const handleActionClick = React76__default.useCallback(() => {
         if (action?.event) {
           eventBus.emit(`UI:${action.event}`, {});
         }
@@ -48814,7 +48979,7 @@ var init_StatCard = __esm({
       const data = Array.isArray(entity) ? entity : entity ? [entity] : [];
       const isLoading = externalLoading ?? false;
       const error = externalError;
-      const computeMetricValue = React77__default.useCallback(
+      const computeMetricValue = React76__default.useCallback(
         (metric, items) => {
           if (metric.value !== void 0) {
             return metric.value;
@@ -48853,7 +49018,7 @@ var init_StatCard = __esm({
         },
         []
       );
-      const schemaStats = React77__default.useMemo(() => {
+      const schemaStats = React76__default.useMemo(() => {
         if (!metrics || metrics.length === 0) return null;
         return metrics.map((metric) => ({
           label: metric.label,
@@ -48861,7 +49026,7 @@ var init_StatCard = __esm({
           format: metric.format
         }));
       }, [metrics, data, computeMetricValue]);
-      const calculatedTrend = React77__default.useMemo(() => {
+      const calculatedTrend = React76__default.useMemo(() => {
         if (manualTrend !== void 0) return manualTrend;
         if (previousValue === void 0 || currentValue2 === void 0)
           return void 0;
@@ -49911,7 +50076,7 @@ var init_Timeline = __esm({
     }) => {
       const { t } = useTranslate();
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React77__default.useMemo(() => {
+      const items = React76__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => {
@@ -50068,7 +50233,7 @@ var init_TimerDisplay = __esm({
   }
 });
 function extractToastProps(children) {
-  if (!React77__default.isValidElement(children)) {
+  if (!React76__default.isValidElement(children)) {
     if (typeof children === "string") {
       return { message: children };
     }
@@ -50106,7 +50271,7 @@ var init_ToastSlot = __esm({
         eventBus.emit("UI:CLOSE");
       };
       if (!isVisible) return null;
-      const isCustomContent = React77__default.isValidElement(children) && !message;
+      const isCustomContent = React76__default.isValidElement(children) && !message;
       return /* @__PURE__ */ jsx(Box, { className: "fixed bottom-4 right-4 z-50", children: isCustomContent ? children : /* @__PURE__ */ jsx(
         Toast,
         {
@@ -50985,8 +51150,8 @@ function XPBar({
 }) {
   const sizes = sizeMap18[size];
   const percentage = max > 0 ? Math.max(0, Math.min(100, current / max * 100)) : 0;
-  const [fillWidth, setFillWidth] = React77.useState(animated ? 0 : percentage);
-  React77.useEffect(() => {
+  const [fillWidth, setFillWidth] = React76.useState(animated ? 0 : percentage);
+  React76.useEffect(() => {
     if (!animated) {
       setFillWidth(percentage);
       return;
@@ -51059,7 +51224,7 @@ var init_XPBar = __esm({
   }
 });
 function lazyThree(name, loader) {
-  const Lazy = React77__default.lazy(
+  const Lazy = React76__default.lazy(
     () => loader().then((m) => {
       const Resolved = m[name];
       if (!Resolved) {
@@ -51071,13 +51236,13 @@ function lazyThree(name, loader) {
     })
   );
   function ThreeWrapper(props) {
-    return React77__default.createElement(
+    return React76__default.createElement(
       ThreeBoundary,
       { name },
-      React77__default.createElement(
-        React77__default.Suspense,
+      React76__default.createElement(
+        React76__default.Suspense,
         { fallback: null },
-        React77__default.createElement(Lazy, props)
+        React76__default.createElement(Lazy, props)
       )
     );
   }
@@ -51375,7 +51540,7 @@ var init_component_registry_generated = __esm({
     init_WorldMapBoard();
     init_WorldMapTemplate();
     init_XPBar();
-    ThreeBoundary = class extends React77__default.Component {
+    ThreeBoundary = class extends React76__default.Component {
       constructor() {
         super(...arguments);
         __publicField(this, "state", { failed: false });
@@ -51385,7 +51550,7 @@ var init_component_registry_generated = __esm({
       }
       render() {
         if (this.state.failed) {
-          return React77__default.createElement(
+          return React76__default.createElement(
             "div",
             {
               "data-testid": "three-unavailable",
@@ -51726,7 +51891,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React77__default.createElement(
+  return React76__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -52216,7 +52381,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
         const key = `${parentId}-${index}-trait:${traitName}`;
         return /* @__PURE__ */ jsx(TraitFrame, { traitName }, key);
       }
-      return /* @__PURE__ */ jsx(React77__default.Fragment, { children: child }, `${parentId}-${index}`);
+      return /* @__PURE__ */ jsx(React76__default.Fragment, { children: child }, `${parentId}-${index}`);
     }
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
@@ -52256,14 +52421,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 (React77__default.isValidElement(value)) return false;
+  if (React76__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 (React77__default.isValidElement(value)) return false;
+  if (React76__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
@@ -52770,121 +52935,15 @@ init_useGameAudio();
 init_useImageCache();
 init_useCamera();
 
-// components/game/organisms/utils/spriteSheetConstants.ts
-var SHEET_COLUMNS = 8;
-var SPRITE_SHEET_LAYOUT = {
-  idle: { row: 0, frames: 4, frameRate: 6, loop: true },
-  walk: { row: 1, frames: 8, frameRate: 10, loop: true },
-  attack: { row: 2, frames: 6, frameRate: 12, loop: false },
-  hit: { row: 3, frames: 3, frameRate: 8, loop: false },
-  death: { row: 4, frames: 6, frameRate: 8, loop: false }
-};
-
-// 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 getCurrentFrame(animName, elapsed) {
-  const def = SPRITE_SHEET_LAYOUT[animName];
-  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 };
-}
-function resolveFrame(sheetUrls, frameDims, animState) {
-  if (!sheetUrls) return null;
-  const { sheetDir, flipX } = resolveSheetDirection(animState.direction);
-  const sheetUrl = sheetUrls[sheetDir];
-  if (!sheetUrl) return null;
-  const def = SPRITE_SHEET_LAYOUT[animState.animation];
-  const { frame } = getCurrentFrame(animState.animation, animState.elapsed);
-  return {
-    sheetUrl,
-    sx: frame * frameDims.width,
-    sy: def.row * frameDims.height,
-    sw: frameDims.width,
-    sh: frameDims.height,
-    flipX
-  };
-}
-function createUnitAnimationState(unitId) {
-  return {
-    unitId,
-    animation: "idle",
-    direction: "se",
-    frame: 0,
-    elapsed: 0,
-    queuedAnimation: null,
-    finished: false
-  };
-}
-function transitionAnimation(state, newAnim, direction) {
-  if (state.animation === "death" && state.finished) return state;
-  if (state.animation === newAnim && SPRITE_SHEET_LAYOUT[newAnim].loop) {
-    return direction ? { ...state, direction } : state;
-  }
-  return {
-    ...state,
-    animation: newAnim,
-    direction: direction ?? state.direction,
-    frame: 0,
-    elapsed: 0,
-    queuedAnimation: null,
-    finished: false
-  };
-}
-function tickAnimationState(state, deltaMs) {
-  const newElapsed = state.elapsed + deltaMs;
-  const { frame, finished } = getCurrentFrame(state.animation, newElapsed);
-  const def = SPRITE_SHEET_LAYOUT[state.animation];
-  if (finished && !def.loop && !state.finished) {
-    if (state.animation === "death") {
-      return { ...state, elapsed: newElapsed, frame, finished: true };
-    }
-    const nextAnim = state.queuedAnimation ?? "idle";
-    return {
-      ...state,
-      animation: nextAnim,
-      elapsed: 0,
-      frame: 0,
-      queuedAnimation: null,
-      finished: false
-    };
-  }
-  return { ...state, elapsed: newElapsed, frame, finished };
-}
-
 // components/game/organisms/hooks/useSpriteAnimations.ts
+init_spriteAnimation();
 function useSpriteAnimations(getSheetUrls, getFrameDims, options = {}) {
   const speed = options.speed ?? 1;
   const animStatesRef = useRef(/* @__PURE__ */ new Map());
   const prevPositionsRef = useRef(/* @__PURE__ */ new Map());
   const unitDataRef = useRef(/* @__PURE__ */ new Map());
   const walkHoldRef = useRef(/* @__PURE__ */ new Map());
-  const WALK_HOLD_MS = 600;
+  const WALK_HOLD_MS2 = 600;
   const syncUnits = useCallback((units, deltaMs) => {
     const scaledDelta = deltaMs * speed;
     const states = animStatesRef.current;
@@ -52910,7 +52969,7 @@ function useSpriteAnimations(getSheetUrls, getFrameDims, options = {}) {
           const dir = inferDirection(dx, dy);
           if (state.animation !== "attack" && state.animation !== "hit" && state.animation !== "death") {
             state = transitionAnimation(state, "walk", dir);
-            walkHold.set(unit.id, WALK_HOLD_MS);
+            walkHold.set(unit.id, WALK_HOLD_MS2);
           }
         } else if (state.animation === "walk") {
           const remaining = (walkHold.get(unit.id) ?? 0) - scaledDelta;
@@ -53243,6 +53302,8 @@ function usePhysics2D(options = {}) {
 
 // components/game/organisms/index.ts
 init_isometric();
+init_spriteAnimation();
+init_spriteSheetConstants();
 init_BattleBoard();
 init_UncontrolledBattleBoard();
 init_useBattleState();