@almadar/ui 5.49.0 → 5.50.0

package/dist/avl/index.js

@@ -1,6 +1,6 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import * as React91 from 'react';
-import React91__default, { createContext, useState, useMemo, useRef, useEffect, useContext, useCallback, Suspense, useLayoutEffect, Profiler, useReducer, useSyncExternalStore, lazy, useId, forwardRef, useImperativeHandle, Component } from 'react';
+import * as React90 from 'react';
+import React90__default, { createContext, useState, useMemo, useRef, useEffect, useContext, useCallback, Suspense, useLayoutEffect, Profiler, useReducer, useSyncExternalStore, lazy, useId, forwardRef, useImperativeHandle, Component } from 'react';
 import { OrbitalProvider, EventBusContext, useTraitScope, VerificationProvider, TraitScopeProvider } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import ELK from 'elkjs/lib/elk.bundled.js';
@@ -9,8 +9,8 @@ import { useTranslate, useEventBus as useEventBus$1 } from '@almadar/ui/hooks';
 import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X, Code, FileText, WrapText, Check, Copy, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, RotateCcw, Play, Terminal, XCircle, AlertTriangle, Trash2, Link2, ZoomOut, ZoomIn, Download, Menu as Menu$1, Package, Calendar, MoreHorizontal, Image as Image$1, Upload, ArrowLeft, HelpCircle, PauseCircle, Search, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, Minus, Eraser, TrendingUp, TrendingDown, AlertCircle, Circle, Clock, CheckCircle2, Bug, Send, ChevronUp, ChevronDown, Wrench, Tag, User, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { createPortal } from 'react-dom';
+import { UISlotProvider, useUISlots, useTheme } from '@almadar/ui/context';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
-import { UISlotProvider, useUISlots } from '@almadar/ui/context';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
 import dark from 'react-syntax-highlighter/dist/esm/styles/prism/vsc-dark-plus.js';
@@ -39,15 +39,15 @@ import { FieldTypeSchema, isInlineTrait, isPageReference, isEntityCall, schemaTo
 import { useDroppable, useDraggable, DndContext, DragOverlay, useSensors, useSensor, PointerSensor, KeyboardSensor, pointerWithin, rectIntersection, closestCorners } from '@dnd-kit/core';
 import { sortableKeyboardCoordinates, useSortable, arrayMove, SortableContext, rectSortingStrategy, verticalListSortingStrategy } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
-import * as THREE from 'three';
+import * as THREE3 from 'three';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
 import { GLTFLoader as GLTFLoader$1 } from 'three/examples/jsm/loaders/GLTFLoader';
-import { Canvas, useThree } from '@react-three/fiber';
-import { Grid as Grid$1, OrbitControls } from '@react-three/drei';
+import { Canvas, useLoader, useFrame, useThree } from '@react-three/fiber';
+import { Billboard, Grid as Grid$1, OrbitControls } from '@react-three/drei';
 import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1, isEntityAwarePattern } from '@almadar/patterns';
 import { OrbitalServerRuntime } from '@almadar/runtime/OrbitalServerRuntime';
-import { InMemoryPersistence, StateMachineManager, createContextFromBindings, interpolateValue, collectDeclaredConfigDefaults, createServerEffectHandlers, EffectExecutor } from '@almadar/runtime';
+import { InMemoryPersistence, StateMachineManager, collectDeclaredConfigDefaults, createServerEffectHandlers, EffectExecutor, interpolateValue, createContextFromBindings } from '@almadar/runtime';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -3470,7 +3470,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    Box = React91__default.forwardRef(
+    Box = React90__default.forwardRef(
       ({
         padding,
         paddingX,
@@ -3520,7 +3520,7 @@ var init_Box = __esm({
           onMouseLeave?.(e);
         }, [hoverEvent, eventBus, onMouseLeave]);
         const isClickable = action || onClick;
-        return React91__default.createElement(
+        return React90__default.createElement(
           Component2,
           {
             ref,
@@ -4110,7 +4110,7 @@ var init_MiniStateMachine = __esm({
           const x = 2 + i * (NODE_W + GAP + ARROW_W + GAP);
           const tc = transitionCounts[s.name] ?? 0;
           const role = getStateRole(s.name, s.isInitial, s.isTerminal, tc, maxTC);
-          return /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
             /* @__PURE__ */ jsx(
               AvlState,
               {
@@ -4485,7 +4485,7 @@ function loadLib(key, importer) {
   return p2;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React91__default.lazy(async () => {
+  const Lazy = React90__default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -4495,7 +4495,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsx(
-    React91__default.Suspense,
+    React90__default.Suspense,
     {
       fallback: /* @__PURE__ */ jsx(
         "span",
@@ -5221,7 +5221,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 = React91__default.useMemo(() => {
+      const RenderedComponent = React90__default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -5280,7 +5280,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React91__default.isValidElement(value)) {
+  if (React90__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -5356,7 +5356,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    Button = React91__default.forwardRef(
+    Button = React90__default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -5421,7 +5421,7 @@ var Dialog;
 var init_Dialog = __esm({
   "components/core/atoms/Dialog.tsx"() {
     init_cn();
-    Dialog = React91__default.forwardRef(
+    Dialog = React90__default.forwardRef(
       ({
         role = "dialog",
         "aria-modal": ariaModal = true,
@@ -5916,7 +5916,7 @@ var init_Badge = __esm({
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React91__default.forwardRef(
+    Badge = React90__default.forwardRef(
       ({ className, variant = "default", size = "sm", amount, label, icon, children, onRemove, removeLabel, ...props }, ref) => {
         const iconSizes3 = {
           sm: "h-icon-default w-icon-default",
@@ -6252,7 +6252,7 @@ var init_SvgFlow = __esm({
       width = 100,
       height = 100
     }) => {
-      const markerId = React91__default.useMemo(() => {
+      const markerId = React90__default.useMemo(() => {
         flowIdCounter += 1;
         return `almadar-flow-arrow-${flowIdCounter}`;
       }, []);
@@ -6845,7 +6845,7 @@ var init_SvgRing = __esm({
       width = 100,
       height = 100
     }) => {
-      const gradientId = React91__default.useMemo(() => {
+      const gradientId = React90__default.useMemo(() => {
         ringIdCounter += 1;
         return `almadar-ring-glow-${ringIdCounter}`;
       }, []);
@@ -7026,7 +7026,7 @@ var init_Input = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Input = React91__default.forwardRef(
+    Input = React90__default.forwardRef(
       ({
         className,
         inputType,
@@ -7186,7 +7186,7 @@ var Label;
 var init_Label = __esm({
   "components/core/atoms/Label.tsx"() {
     init_cn();
-    Label = React91__default.forwardRef(
+    Label = React90__default.forwardRef(
       ({ className, required, children, ...props }, ref) => {
         return /* @__PURE__ */ jsxs(
           "label",
@@ -7213,7 +7213,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React91__default.forwardRef(
+    Textarea = React90__default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -7452,7 +7452,7 @@ var init_Select = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Select = React91__default.forwardRef(
+    Select = React90__default.forwardRef(
       (props, _ref) => {
         const { multiple, searchable, clearable } = props;
         if (multiple || searchable || clearable) {
@@ -7469,7 +7469,7 @@ var init_Checkbox = __esm({
   "components/core/atoms/Checkbox.tsx"() {
     init_cn();
     init_useEventBus();
-    Checkbox = React91__default.forwardRef(
+    Checkbox = React90__default.forwardRef(
       ({ className, label, id, onChange, ...props }, ref) => {
         const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
         const eventBus = useEventBus();
@@ -7523,7 +7523,7 @@ var init_Spinner = __esm({
       md: "h-6 w-6",
       lg: "h-8 w-8"
     };
-    Spinner = React91__default.forwardRef(
+    Spinner = React90__default.forwardRef(
       ({ className, size = "md", overlay, ...props }, ref) => {
         if (overlay) {
           return /* @__PURE__ */ jsx(
@@ -7613,7 +7613,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 = React91__default.forwardRef(
+    Card = React90__default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -7661,9 +7661,9 @@ var init_Card = __esm({
       }
     );
     Card.displayName = "Card";
-    CardHeader = React91__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React90__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React91__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardTitle = React90__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "h3",
       {
         ref,
@@ -7676,11 +7676,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React91__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React90__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React91__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardFooter = React90__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "div",
       {
         ref,
@@ -7735,7 +7735,7 @@ var init_FilterPill = __esm({
       md: "w-3.5 h-3.5",
       lg: "w-4 h-4"
     };
-    FilterPill = React91__default.forwardRef(
+    FilterPill = React90__default.forwardRef(
       ({
         className,
         variant = "default",
@@ -7864,8 +7864,8 @@ var init_Avatar = __esm({
       actionPayload
     }) => {
       const eventBus = useEventBus();
-      const [imgFailed, setImgFailed] = React91__default.useState(false);
-      React91__default.useEffect(() => {
+      const [imgFailed, setImgFailed] = React90__default.useState(false);
+      React90__default.useEffect(() => {
         setImgFailed(false);
       }, [src]);
       const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -8250,7 +8250,7 @@ var init_Radio = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    Radio = React91__default.forwardRef(
+    Radio = React90__default.forwardRef(
       ({
         label,
         helperText,
@@ -8267,12 +8267,12 @@ var init_Radio = __esm({
         onChange,
         ...props
       }, ref) => {
-        const reactId = React91__default.useId();
+        const reactId = React90__default.useId();
         const baseId = id || `radio-${reactId}`;
         const hasError = !!error;
         const eventBus = useEventBus();
-        const [selected, setSelected] = React91__default.useState(value);
-        React91__default.useEffect(() => {
+        const [selected, setSelected] = React90__default.useState(value);
+        React90__default.useEffect(() => {
           if (value !== void 0) setSelected(value);
         }, [value]);
         const pick = (next, e) => {
@@ -8454,7 +8454,7 @@ var init_Switch = __esm({
   "components/core/atoms/Switch.tsx"() {
     "use client";
     init_cn();
-    Switch = React91.forwardRef(
+    Switch = React90.forwardRef(
       ({
         checked,
         defaultChecked = false,
@@ -8465,10 +8465,10 @@ var init_Switch = __esm({
         name,
         className
       }, ref) => {
-        const [isChecked, setIsChecked] = React91.useState(
+        const [isChecked, setIsChecked] = React90.useState(
           checked !== void 0 ? checked : defaultChecked
         );
-        React91.useEffect(() => {
+        React90.useEffect(() => {
           if (checked !== void 0) {
             setIsChecked(checked);
           }
@@ -8637,188 +8637,12 @@ var init_TextHighlight = __esm({
     TextHighlight.displayName = "TextHighlight";
   }
 });
-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 sizeClasses5, iconSizes2, ThemeToggle;
 var init_ThemeToggle = __esm({
   "components/core/atoms/ThemeToggle.tsx"() {
     "use client";
     init_Icon();
     init_cn();
-    init_ThemeContext();
     sizeClasses5 = {
       sm: "p-1.5",
       md: "p-2",
@@ -8913,7 +8737,7 @@ var Aside;
 var init_Aside = __esm({
   "components/core/atoms/Aside.tsx"() {
     init_cn();
-    Aside = React91__default.forwardRef(
+    Aside = React90__default.forwardRef(
       ({ className, children, ...rest }, ref) => /* @__PURE__ */ jsx("aside", { ref, className: cn(className), ...rest, children })
     );
     Aside.displayName = "Aside";
@@ -8991,8 +8815,8 @@ var init_LawReferenceTooltip = __esm({
       className
     }) => {
       const { t } = useTranslate();
-      const [isVisible, setIsVisible] = React91__default.useState(false);
-      const timeoutRef = React91__default.useRef(null);
+      const [isVisible, setIsVisible] = React90__default.useState(false);
+      const timeoutRef = React90__default.useRef(null);
       const handleMouseEnter = () => {
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         timeoutRef.current = setTimeout(() => setIsVisible(true), 200);
@@ -9001,7 +8825,7 @@ var init_LawReferenceTooltip = __esm({
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         setIsVisible(false);
       };
-      React91__default.useEffect(() => {
+      React90__default.useEffect(() => {
         return () => {
           if (timeoutRef.current) clearTimeout(timeoutRef.current);
         };
@@ -9211,7 +9035,7 @@ var init_StatusDot = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    StatusDot = React91__default.forwardRef(
+    StatusDot = React90__default.forwardRef(
       ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
         return /* @__PURE__ */ jsx(
           "span",
@@ -9265,7 +9089,7 @@ var init_TrendIndicator = __esm({
       down: "trending-down",
       flat: "arrow-right"
     };
-    TrendIndicator = React91__default.forwardRef(
+    TrendIndicator = React90__default.forwardRef(
       ({
         className,
         value,
@@ -9332,7 +9156,7 @@ var init_RangeSlider = __esm({
       md: "w-4 h-4",
       lg: "w-5 h-5"
     };
-    RangeSlider = React91__default.forwardRef(
+    RangeSlider = React90__default.forwardRef(
       ({
         className,
         min = 0,
@@ -9840,7 +9664,7 @@ var init_ContentSection = __esm({
       md: "py-16",
       lg: "py-24"
     };
-    ContentSection = React91__default.forwardRef(
+    ContentSection = React90__default.forwardRef(
       ({ children, background = "default", padding = "lg", id, className }, ref) => {
         return /* @__PURE__ */ jsx(
           Box,
@@ -10374,7 +10198,7 @@ var init_AnimatedReveal = __esm({
       "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
       "none": {}
     };
-    AnimatedReveal = React91__default.forwardRef(
+    AnimatedReveal = React90__default.forwardRef(
       ({
         trigger = "scroll",
         animation = "fade-up",
@@ -10534,7 +10358,7 @@ var init_AnimatedGraphic = __esm({
   "components/marketing/atoms/AnimatedGraphic.tsx"() {
     "use client";
     init_cn();
-    AnimatedGraphic = React91__default.forwardRef(
+    AnimatedGraphic = React90__default.forwardRef(
       ({
         src,
         svgContent,
@@ -10557,7 +10381,7 @@ var init_AnimatedGraphic = __esm({
         const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
         const resolvedSvg = svgContent ?? fetchedSvg;
         const prevAnimateRef = useRef(animate);
-        const setRef = React91__default.useCallback(
+        const setRef = React90__default.useCallback(
           (node) => {
             containerRef.current = node;
             if (typeof ref === "function") ref(node);
@@ -10783,9 +10607,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] = React91.useState(resolvedValue);
-  const [isAnimating, setIsAnimating] = React91.useState(false);
-  React91.useEffect(() => {
+  const [displayValue, setDisplayValue] = React90.useState(resolvedValue);
+  const [isAnimating, setIsAnimating] = React90.useState(false);
+  React90.useEffect(() => {
     if (!animated || displayValue === resolvedValue) {
       setDisplayValue(resolvedValue);
       return;
@@ -10868,9 +10692,9 @@ function ControlButton({
   className
 }) {
   const eventBus = useEventBus();
-  const [isPressed, setIsPressed] = React91.useState(false);
+  const [isPressed, setIsPressed] = React90.useState(false);
   const actualPressed = pressed ?? isPressed;
-  const handlePointerDown = React91.useCallback(
+  const handlePointerDown = React90.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -10880,7 +10704,7 @@ function ControlButton({
     },
     [disabled, pressEvent, eventBus, onPress]
   );
-  const handlePointerUp = React91.useCallback(
+  const handlePointerUp = React90.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -10890,7 +10714,7 @@ function ControlButton({
     },
     [disabled, releaseEvent, eventBus, onRelease]
   );
-  const handlePointerLeave = React91.useCallback(
+  const handlePointerLeave = React90.useCallback(
     (e) => {
       if (isPressed) {
         setIsPressed(false);
@@ -10968,6 +10792,52 @@ var init_ControlButton = __esm({
     ControlButton.displayName = "ControlButton";
   }
 });
+
+// components/game/organisms/utils/spriteAnimation.ts
+function inferDirection(dx, dy) {
+  if (dx === 0 && dy === 0) return "se";
+  if (dx >= 0 && dy >= 0) return "se";
+  if (dx <= 0 && dy >= 0) return "sw";
+  if (dx >= 0 && dy <= 0) return "ne";
+  return "nw";
+}
+function resolveSheetDirection(facing) {
+  switch (facing) {
+    case "se":
+      return { sheetDir: "se", flipX: false };
+    case "sw":
+      return { sheetDir: "sw", flipX: false };
+    case "ne":
+      return { sheetDir: "sw", flipX: true };
+    case "nw":
+      return { sheetDir: "se", flipX: true };
+  }
+}
+function frameRect(frame, row, columns, frameWidth, frameHeight) {
+  return {
+    sx: frame % columns * frameWidth,
+    sy: row * frameHeight,
+    sw: frameWidth,
+    sh: frameHeight
+  };
+}
+function getCurrentFrameFromDef(def, elapsed) {
+  const frameDuration = 1e3 / def.frameRate;
+  const totalDuration = def.frames * frameDuration;
+  if (def.loop) {
+    const frame2 = Math.floor(elapsed % totalDuration / frameDuration);
+    return { frame: frame2, finished: false };
+  }
+  if (elapsed >= totalDuration) {
+    return { frame: def.frames - 1, finished: true };
+  }
+  const frame = Math.floor(elapsed / frameDuration);
+  return { frame, finished: false };
+}
+var init_spriteAnimation = __esm({
+  "components/game/organisms/utils/spriteAnimation.ts"() {
+  }
+});
 function Sprite({
   spritesheet = "https://almadar-kflow-assets.web.app/shared/isometric-blocks/Spritesheet/allTiles_sheet.png",
   frameWidth = 64,
@@ -10988,12 +10858,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 = [
@@ -11041,6 +10907,7 @@ var init_Sprite = __esm({
   "components/game/atoms/Sprite.tsx"() {
     "use client";
     init_useEventBus();
+    init_spriteAnimation();
   }
 });
 function StateIndicator({
@@ -11468,8 +11335,8 @@ function XPBar({
 }) {
   const sizes = sizeMap9[size];
   const percentage = max > 0 ? Math.max(0, Math.min(100, current / max * 100)) : 0;
-  const [fillWidth, setFillWidth] = React91.useState(animated ? 0 : percentage);
-  React91.useEffect(() => {
+  const [fillWidth, setFillWidth] = React90.useState(animated ? 0 : percentage);
+  React90.useEffect(() => {
     if (!animated) {
       setFillWidth(percentage);
       return;
@@ -11957,9 +11824,9 @@ function MiniMap({
   viewportRect = DEFAULT_VIEWPORT,
   className
 }) {
-  const canvasRef = React91.useRef(null);
-  const frameRef = React91.useRef(0);
-  React91.useEffect(() => {
+  const canvasRef = React90.useRef(null);
+  const frameRef = React90.useRef(0);
+  React90.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -12148,7 +12015,7 @@ var init_ErrorBoundary = __esm({
         }
       );
     };
-    ErrorBoundary = class extends React91__default.Component {
+    ErrorBoundary = class extends React90__default.Component {
       constructor(props) {
         super(props);
         __publicField(this, "reset", () => {
@@ -13183,8 +13050,8 @@ function ActionButtons({
   disabled
 }) {
   const eventBus = useEventBus();
-  const [activeButtons, setActiveButtons] = React91.useState(/* @__PURE__ */ new Set());
-  const handlePress = React91.useCallback(
+  const [activeButtons, setActiveButtons] = React90.useState(/* @__PURE__ */ new Set());
+  const handlePress = React90.useCallback(
     (id) => {
       setActiveButtons((prev) => new Set(prev).add(id));
       if (actionEvent) eventBus.emit(`UI:${actionEvent}`, { id, pressed: true });
@@ -13192,7 +13059,7 @@ function ActionButtons({
     },
     [actionEvent, eventBus, onAction]
   );
-  const handleRelease = React91.useCallback(
+  const handleRelease = React90.useCallback(
     (id) => {
       setActiveButtons((prev) => {
         const next = new Set(prev);
@@ -14104,7 +13971,7 @@ function recordTransition(trace) {
     ...trace,
     id: `t-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`
   };
-  log5.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
+  log4.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
   getState().transitions.push(entry);
   if (getState().transitions.length > MAX_TRANSITIONS) {
     getState().transitions.shift();
@@ -14203,7 +14070,7 @@ function getTraitSnapshots() {
     try {
       snapshots.push(getter());
     } catch (err) {
-      log5.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
+      log4.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
     }
   }
   return snapshots;
@@ -14302,10 +14169,10 @@ function updateAssetStatus(url, status) {
     window.__orbitalVerification.assetStatus[url] = status;
   }
 }
-var log5, MAX_TRANSITIONS;
+var log4, MAX_TRANSITIONS;
 var init_verificationRegistry = __esm({
   "lib/verificationRegistry.ts"() {
-    log5 = createLogger("almadar:bridge");
+    log4 = createLogger("almadar:bridge");
     MAX_TRANSITIONS = 500;
     exposeOnWindow();
   }
@@ -14432,6 +14299,163 @@ var init_useCamera = __esm({
     "use client";
   }
 });
+function unitAtlasUrl(unit) {
+  if (unit.spriteSheet) return unit.spriteSheet;
+  const sprite = unit.sprite;
+  if (!sprite) return null;
+  const match = /^(.*-sprite-sheet)(?:-(?:se|sw))?(?:-v\d+)?\.png$/.exec(sprite);
+  if (!match) return null;
+  return `${match[1]}.json`;
+}
+function resolveSheetUrl(atlasUrl, relativeSheetPath) {
+  try {
+    return new URL(relativeSheetPath, atlasUrl).toString();
+  } catch {
+    const base = atlasUrl.slice(0, atlasUrl.lastIndexOf("/") + 1);
+    return `${base}${relativeSheetPath.replace(/^\.\//, "")}`;
+  }
+}
+function useUnitSpriteAtlas(units) {
+  const atlasCacheRef = useRef(/* @__PURE__ */ new Map());
+  const loadingRef = useRef(/* @__PURE__ */ new Set());
+  const [pendingCount, setPendingCount] = useState(0);
+  const [, forceTick] = useState(0);
+  const animStatesRef = useRef(/* @__PURE__ */ new Map());
+  const lastTickRef = useRef(0);
+  const rafRef = useRef(0);
+  const atlasUrls = useMemo(() => {
+    const set = /* @__PURE__ */ new Set();
+    for (const unit of units) {
+      const url = unitAtlasUrl(unit);
+      if (url) set.add(url);
+    }
+    return [...set];
+  }, [units]);
+  useEffect(() => {
+    const cache = atlasCacheRef.current;
+    const loading = loadingRef.current;
+    const toLoad = atlasUrls.filter((url) => !cache.has(url) && !loading.has(url));
+    if (toLoad.length === 0) return;
+    let cancelled = false;
+    setPendingCount((prev) => prev + toLoad.length);
+    for (const url of toLoad) {
+      loading.add(url);
+      fetch(url).then((res) => res.ok ? res.json() : Promise.reject(new Error(String(res.status)))).then((atlas) => {
+        if (cancelled) return;
+        cache.set(url, atlas);
+      }).catch(() => {
+      }).finally(() => {
+        if (cancelled) return;
+        loading.delete(url);
+        setPendingCount((prev) => Math.max(0, prev - 1));
+        forceTick((n) => n + 1);
+      });
+    }
+    return () => {
+      cancelled = true;
+    };
+  }, [atlasUrls]);
+  const sheetUrls = useMemo(() => {
+    const urls = /* @__PURE__ */ new Set();
+    for (const unit of units) {
+      const atlasUrl = unitAtlasUrl(unit);
+      if (!atlasUrl) continue;
+      const atlas = atlasCacheRef.current.get(atlasUrl);
+      if (!atlas) continue;
+      for (const rel of Object.values(atlas.sheets)) {
+        if (rel) urls.add(resolveSheetUrl(atlasUrl, rel));
+      }
+    }
+    return [...urls];
+  }, [units, pendingCount]);
+  useEffect(() => {
+    const hasAtlasUnits = units.some((u) => unitAtlasUrl(u) !== null);
+    if (!hasAtlasUnits) return;
+    let running = true;
+    const tick = (ts) => {
+      if (!running) return;
+      const last = lastTickRef.current || ts;
+      const delta = ts - last;
+      lastTickRef.current = ts;
+      const states = animStatesRef.current;
+      const currentIds = /* @__PURE__ */ new Set();
+      for (const unit of units) {
+        if (unitAtlasUrl(unit) === null) continue;
+        currentIds.add(unit.id);
+        let state = states.get(unit.id);
+        if (!state) {
+          state = { animation: "idle", direction: "se", elapsed: 0, walkHold: 0, prev: null };
+          states.set(unit.id, state);
+        }
+        const posX = unit.position?.x ?? unit.x ?? 0;
+        const posY = unit.position?.y ?? unit.y ?? 0;
+        if (state.prev) {
+          const dx = posX - state.prev.x;
+          const dy = posY - state.prev.y;
+          if (dx !== 0 || dy !== 0) {
+            state.animation = "walk";
+            state.direction = inferDirection(dx, dy);
+            state.walkHold = WALK_HOLD_MS;
+          } else if (state.animation === "walk") {
+            state.walkHold -= delta;
+            if (state.walkHold <= 0) state.animation = "idle";
+          }
+        }
+        state.prev = { x: posX, y: posY };
+        state.elapsed += delta;
+      }
+      for (const id of states.keys()) {
+        if (!currentIds.has(id)) states.delete(id);
+      }
+      rafRef.current = requestAnimationFrame(tick);
+    };
+    rafRef.current = requestAnimationFrame(tick);
+    return () => {
+      running = false;
+      cancelAnimationFrame(rafRef.current);
+      lastTickRef.current = 0;
+    };
+  }, [units]);
+  const resolveUnitFrame = useCallback((unitId) => {
+    const unit = units.find((u) => u.id === unitId);
+    if (!unit) return null;
+    const atlasUrl = unitAtlasUrl(unit);
+    if (!atlasUrl) return null;
+    const atlas = atlasCacheRef.current.get(atlasUrl);
+    if (!atlas) return null;
+    const state = animStatesRef.current.get(unitId);
+    const animation = state?.animation ?? "idle";
+    const direction = state?.direction ?? "se";
+    const elapsed = state?.elapsed ?? 0;
+    const def = atlas.animations[animation] ?? atlas.animations.idle;
+    if (!def) return null;
+    const { sheetDir, flipX } = resolveSheetDirection(direction);
+    const rel = atlas.sheets[sheetDir] ?? atlas.sheets.se ?? atlas.sheets.sw;
+    if (!rel) return null;
+    const sheetUrl = resolveSheetUrl(atlasUrl, rel);
+    const isIdle = animation === "idle";
+    const frame = isIdle ? 0 : getCurrentFrameFromDef(def, elapsed).frame;
+    const rect = frameRect(frame, def.row, atlas.columns, atlas.frameWidth, atlas.frameHeight);
+    return {
+      sheetUrl,
+      sx: rect.sx,
+      sy: rect.sy,
+      sw: rect.sw,
+      sh: rect.sh,
+      flipX,
+      applyBreathing: isIdle
+    };
+  }, [units]);
+  return { sheetUrls, resolveUnitFrame, pendingCount };
+}
+var WALK_HOLD_MS;
+var init_useUnitSpriteAtlas = __esm({
+  "components/game/molecules/useUnitSpriteAtlas.ts"() {
+    "use client";
+    init_spriteAnimation();
+    WALK_HOLD_MS = 600;
+  }
+});
 
 // components/game/organisms/utils/isometric.ts
 function isoToScreen(tileX, tileY, scale, baseOffsetX) {
@@ -14546,6 +14570,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;
@@ -14629,9 +14657,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;
@@ -14918,7 +14947,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;
@@ -15028,7 +15057,7 @@ function IsometricCanvas({
     resolveTerrainSpriteUrl,
     resolveFeatureSpriteUrl,
     resolveUnitSpriteUrl,
-    resolveUnitFrame,
+    resolveFrameForUnit,
     getImage,
     gridWidth,
     gridHeight,
@@ -15060,7 +15089,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;
@@ -15076,7 +15105,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));
@@ -15221,6 +15250,7 @@ var init_IsometricCanvas = __esm({
     init_ErrorState();
     init_useImageCache();
     init_useCamera();
+    init_useUnitSpriteAtlas();
     init_verificationRegistry();
     init_isometric();
     IsometricCanvas.displayName = "IsometricCanvas";
@@ -16038,7 +16068,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();
@@ -16121,7 +16151,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",
@@ -16160,7 +16190,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    CodeBlock = React91__default.memo(
+    CodeBlock = React90__default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -16385,7 +16415,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 });
           }
         };
@@ -16747,7 +16777,7 @@ var init_MarkdownContent = __esm({
     init_Box();
     init_CodeBlock();
     init_cn();
-    MarkdownContent = React91__default.memo(
+    MarkdownContent = React90__default.memo(
       ({ content, direction = "ltr", className }) => {
         const { t: _t } = useTranslate();
         const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -18064,7 +18094,7 @@ var init_StateMachineView = __esm({
                 style: { top: title ? 30 : 0 },
                 children: [
                   entity && /* @__PURE__ */ jsx(EntityBox, { entity, config }),
-                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React91__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
+                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React90__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
                     StateNode,
                     {
                       state,
@@ -20266,14 +20296,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",
@@ -20354,7 +20384,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
           },
@@ -24605,7 +24635,7 @@ function CraftingRecipe({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCraft = React91.useCallback(() => {
+  const handleCraft = React90.useCallback(() => {
     onCraft?.();
     if (craftEvent) {
       eventBus.emit(craftEvent, { output: output.label });
@@ -24622,7 +24652,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(React91.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React90.Fragment, { children: [
             /* @__PURE__ */ jsx(Box, { className: "relative", children: /* @__PURE__ */ jsx(
               ItemSlot,
               {
@@ -24694,8 +24724,8 @@ function DPad({
 }) {
   const eventBus = useEventBus();
   const sizes = sizeMap15[size];
-  const [activeDirections, setActiveDirections] = React91.useState(/* @__PURE__ */ new Set());
-  const handlePress = React91.useCallback(
+  const [activeDirections, setActiveDirections] = React90.useState(/* @__PURE__ */ new Set());
+  const handlePress = React90.useCallback(
     (direction) => {
       setActiveDirections((prev) => new Set(prev).add(direction));
       if (directionEvent) eventBus.emit(`UI:${directionEvent}`, { direction, pressed: true });
@@ -24703,7 +24733,7 @@ function DPad({
     },
     [directionEvent, eventBus, onDirection]
   );
-  const handleRelease = React91.useCallback(
+  const handleRelease = React90.useCallback(
     (direction) => {
       setActiveDirections((prev) => {
         const next = new Set(prev);
@@ -25510,8 +25540,8 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React91__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React91__default.cloneElement(
+      const triggerChild = React90__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
+      const triggerElement = React90__default.cloneElement(
         triggerChild,
         {
           ref: triggerRef,
@@ -25645,14 +25675,14 @@ function useDataDnd(args) {
   const isZone = Boolean(dragGroup || accepts || sortable);
   const enabled = isZone || Boolean(dndRoot);
   const eventBus = useEventBus();
-  const parentRoot = React91__default.useContext(RootCtx);
+  const parentRoot = React90__default.useContext(RootCtx);
   const isRoot = enabled && parentRoot === null;
-  const zoneId = React91__default.useId();
+  const zoneId = React90__default.useId();
   const ownGroup = dragGroup ?? accepts ?? zoneId;
-  const [optimisticOrders, setOptimisticOrders] = React91__default.useState(() => /* @__PURE__ */ new Map());
-  const optimisticOrdersRef = React91__default.useRef(optimisticOrders);
+  const [optimisticOrders, setOptimisticOrders] = React90__default.useState(() => /* @__PURE__ */ new Map());
+  const optimisticOrdersRef = React90__default.useRef(optimisticOrders);
   optimisticOrdersRef.current = optimisticOrders;
-  const clearOptimisticOrder = React91__default.useCallback((group) => {
+  const clearOptimisticOrder = React90__default.useCallback((group) => {
     setOptimisticOrders((prev) => {
       if (!prev.has(group)) return prev;
       const next = new Map(prev);
@@ -25677,7 +25707,7 @@ function useDataDnd(args) {
     const raw = it[dndItemIdField];
     return String(raw ?? `__idx_${idx}`);
   }).join("|");
-  const itemIds = React91__default.useMemo(
+  const itemIds = React90__default.useMemo(
     () => orderedItems.map((it, idx) => {
       const raw = it[dndItemIdField];
       return raw ?? `__idx_${idx}`;
@@ -25685,7 +25715,7 @@ function useDataDnd(args) {
     [itemIdsSignature]
   );
   const itemsContentSig = items.map((it, idx) => String(it[dndItemIdField] ?? `__${idx}`)).join("|");
-  React91__default.useEffect(() => {
+  React90__default.useEffect(() => {
     const root = isRoot ? null : parentRoot;
     if (root) {
       root.clearOptimisticOrder(ownGroup);
@@ -25693,20 +25723,20 @@ function useDataDnd(args) {
       clearOptimisticOrder(ownGroup);
     }
   }, [itemsContentSig, ownGroup]);
-  const zonesRef = React91__default.useRef(/* @__PURE__ */ new Map());
-  const registerZone = React91__default.useCallback((zoneId2, meta2) => {
+  const zonesRef = React90__default.useRef(/* @__PURE__ */ new Map());
+  const registerZone = React90__default.useCallback((zoneId2, meta2) => {
     zonesRef.current.set(zoneId2, meta2);
   }, []);
-  const unregisterZone = React91__default.useCallback((zoneId2) => {
+  const unregisterZone = React90__default.useCallback((zoneId2) => {
     zonesRef.current.delete(zoneId2);
   }, []);
-  const [activeDrag, setActiveDrag] = React91__default.useState(null);
-  const [overZoneGroup, setOverZoneGroup] = React91__default.useState(null);
-  const meta = React91__default.useMemo(
+  const [activeDrag, setActiveDrag] = React90__default.useState(null);
+  const [overZoneGroup, setOverZoneGroup] = React90__default.useState(null);
+  const meta = React90__default.useMemo(
     () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
     [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
-  React91__default.useEffect(() => {
+  React90__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
     if (!target) {
       zonesRef.current.set(zoneId, meta);
@@ -25725,7 +25755,7 @@ function useDataDnd(args) {
   }, [parentRoot, isRoot, zoneId, meta]);
   const sensors = useAlmadarDndSensors(true);
   const collisionDetection = almadarDndCollisionDetection;
-  const findZoneByItem = React91__default.useCallback(
+  const findZoneByItem = React90__default.useCallback(
     (id) => {
       for (const z of zonesRef.current.values()) {
         if (z.itemIds.includes(id)) return z;
@@ -25734,7 +25764,7 @@ function useDataDnd(args) {
     },
     []
   );
-  React91__default.useCallback(
+  React90__default.useCallback(
     (group) => {
       for (const z of zonesRef.current.values()) {
         if (z.group === group) return z;
@@ -25743,7 +25773,7 @@ function useDataDnd(args) {
     },
     []
   );
-  const handleDragEnd = React91__default.useCallback(
+  const handleDragEnd = React90__default.useCallback(
     (event) => {
       const { active, over } = event;
       const activeIdStr = String(active.id);
@@ -25834,8 +25864,8 @@ function useDataDnd(args) {
     },
     [eventBus]
   );
-  const sortableData = React91__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
-  const SortableItem = React91__default.useCallback(
+  const sortableData = React90__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
+  const SortableItem = React90__default.useCallback(
     ({ id, children }) => {
       const {
         attributes,
@@ -25875,7 +25905,7 @@ function useDataDnd(args) {
       id: droppableId,
       data: sortableData
     });
-    const ctx = React91__default.useContext(RootCtx);
+    const ctx = React90__default.useContext(RootCtx);
     const activeDrag2 = ctx?.activeDrag ?? null;
     const overZoneGroup2 = ctx?.overZoneGroup ?? null;
     const isThisZoneOver = overZoneGroup2 === ownGroup;
@@ -25890,7 +25920,7 @@ function useDataDnd(args) {
       showForeignPlaceholder,
       ctxAvailable: ctx != null
     });
-    React91__default.useEffect(() => {
+    React90__default.useEffect(() => {
       dndLog.info("dropzone:isOver:change", { droppableId, group: ownGroup, isOver, isThisZoneOver, showForeignPlaceholder, activeDragSourceGroup: activeDrag2?.sourceGroup ?? null });
     }, [droppableId, isOver, isThisZoneOver, showForeignPlaceholder]);
     return /* @__PURE__ */ jsx(
@@ -25904,11 +25934,11 @@ function useDataDnd(args) {
       }
     );
   };
-  const rootContextValue = React91__default.useMemo(
+  const rootContextValue = React90__default.useMemo(
     () => ({ registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder }),
     [registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder]
   );
-  const handleDragStart = React91__default.useCallback((event) => {
+  const handleDragStart = React90__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;
@@ -25927,7 +25957,7 @@ function useDataDnd(args) {
       isRoot
     });
   }, [findZoneByItem, isRoot, zoneId]);
-  const handleDragOver = React91__default.useCallback((event) => {
+  const handleDragOver = React90__default.useCallback((event) => {
     const { active, over } = event;
     const overData = over?.data?.current;
     const overGroup = overData?.dndGroup ?? null;
@@ -25997,7 +26027,7 @@ function useDataDnd(args) {
       return next;
     });
   }, []);
-  const handleDragCancel = React91__default.useCallback((event) => {
+  const handleDragCancel = React90__default.useCallback((event) => {
     setActiveDrag(null);
     setOverZoneGroup(null);
     dndLog.warn("dragCancel", {
@@ -26005,12 +26035,12 @@ function useDataDnd(args) {
       reason: "dnd-kit cancelled the drag (escape key, pointer interrupted, or external)"
     });
   }, []);
-  const handleDragEndWithCleanup = React91__default.useCallback((event) => {
+  const handleDragEndWithCleanup = React90__default.useCallback((event) => {
     handleDragEnd(event);
     setActiveDrag(null);
     setOverZoneGroup(null);
   }, [handleDragEnd]);
-  const wrapContainer = React91__default.useCallback(
+  const wrapContainer = React90__default.useCallback(
     (children) => {
       if (!enabled) return children;
       const strategy = layout === "grid" ? rectSortingStrategy : verticalListSortingStrategy;
@@ -26064,7 +26094,7 @@ var init_useDataDnd = __esm({
     init_useAlmadarDndCollision();
     init_Box();
     dndLog = createLogger("almadar:ui:dnd");
-    RootCtx = React91__default.createContext(null);
+    RootCtx = React90__default.createContext(null);
   }
 });
 function renderIconInput(icon, props) {
@@ -26590,7 +26620,7 @@ function DataList({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React91__default.useState(pageSize || Infinity);
+  const [visibleCount, setVisibleCount] = React90__default.useState(pageSize || Infinity);
   const fieldDefs = fields ?? columns ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -26609,7 +26639,7 @@ function DataList({
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
   const hasRenderProp = typeof children === "function";
-  React91__default.useEffect(() => {
+  React90__default.useEffect(() => {
     const renderItemTypeOf = typeof schemaRenderItem;
     const childrenTypeOf = typeof children;
     if (data.length > 0 && !hasRenderProp) {
@@ -26714,7 +26744,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(React91__default.Fragment, { children: [
+    return /* @__PURE__ */ jsx(VStack, { gap: "sm", className: cn("py-2", className), children: groups2.map((group, gi) => /* @__PURE__ */ jsxs(React90__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}`;
@@ -26855,7 +26885,7 @@ function DataList({
           className
         ),
         children: [
-          groups.map((group, gi) => /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+          groups.map((group, gi) => /* @__PURE__ */ jsxs(React90__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)
@@ -27771,7 +27801,7 @@ var init_Grid = __esm({
       as: Component2 = "div"
     }) => {
       const mergedStyle = rows2 ? { gridTemplateRows: `repeat(${rows2}, minmax(0, 1fr))`, ...style } : style;
-      return React91__default.createElement(
+      return React90__default.createElement(
         Component2,
         {
           className: cn(
@@ -27959,8 +27989,8 @@ var init_Popover = __esm({
         onMouseEnter: handleOpen,
         onMouseLeave: handleClose
       };
-      const childElement = React91__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const triggerElement = React91__default.cloneElement(
+      const childElement = React90__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const triggerElement = React90__default.cloneElement(
         childElement,
         {
           ref: triggerRef,
@@ -28016,9 +28046,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) {
@@ -28046,11 +28076,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");
@@ -28550,8 +28580,8 @@ var init_Tooltip = __esm({
           if (hideTimeoutRef.current) clearTimeout(hideTimeoutRef.current);
         };
       }, []);
-      const triggerElement = React91__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
-      const trigger = React91__default.cloneElement(triggerElement, {
+      const triggerElement = React90__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const trigger = React90__default.cloneElement(triggerElement, {
         ref: triggerRef,
         onMouseEnter: handleMouseEnter,
         onMouseLeave: handleMouseLeave,
@@ -28637,7 +28667,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(React91__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
               /* @__PURE__ */ jsx(
                 "button",
                 {
@@ -29701,7 +29731,7 @@ function InventoryGrid({
   const eventBus = useEventBus();
   const slotCount = totalSlots ?? items.length;
   const emptySlotCount = Math.max(0, slotCount - items.length);
-  const handleSelect = React91.useCallback(
+  const handleSelect = React90.useCallback(
     (id) => {
       onSelect?.(id);
       if (selectEvent) {
@@ -29935,31 +29965,31 @@ function GameCanvas2D({
   assetBaseUrl = "https://almadar-kflow-assets.web.app/shared/",
   className
 }) {
-  const canvasRef = React91.useRef(null);
-  const rafRef = React91.useRef(0);
-  const frameRef = React91.useRef(0);
-  const lastTimeRef = React91.useRef(0);
-  const imageCache = React91.useRef(/* @__PURE__ */ new Map());
+  const canvasRef = React90.useRef(null);
+  const rafRef = React90.useRef(0);
+  const frameRef = React90.useRef(0);
+  const lastTimeRef = React90.useRef(0);
+  const imageCache = React90.useRef(/* @__PURE__ */ new Map());
   const emit = useEmitEvent();
-  const onDrawRef = React91.useRef(onDraw);
+  const onDrawRef = React90.useRef(onDraw);
   onDrawRef.current = onDraw;
-  const onTickRef = React91.useRef(onTick);
+  const onTickRef = React90.useRef(onTick);
   onTickRef.current = onTick;
-  const tickEventRef = React91.useRef(tickEvent);
+  const tickEventRef = React90.useRef(tickEvent);
   tickEventRef.current = tickEvent;
-  const drawEventRef = React91.useRef(drawEvent);
+  const drawEventRef = React90.useRef(drawEvent);
   drawEventRef.current = drawEvent;
-  const emitRef = React91.useRef(emit);
+  const emitRef = React90.useRef(emit);
   emitRef.current = emit;
-  const assetBaseUrlRef = React91.useRef(assetBaseUrl);
+  const assetBaseUrlRef = React90.useRef(assetBaseUrl);
   assetBaseUrlRef.current = assetBaseUrl;
-  const backgroundImageRef = React91.useRef(backgroundImage);
+  const backgroundImageRef = React90.useRef(backgroundImage);
   backgroundImageRef.current = backgroundImage;
-  const widthRef = React91.useRef(width);
+  const widthRef = React90.useRef(width);
   widthRef.current = width;
-  const heightRef = React91.useRef(height);
+  const heightRef = React90.useRef(height);
   heightRef.current = height;
-  const loadImage = React91.useCallback((url) => {
+  const loadImage = React90.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;
@@ -29971,7 +30001,7 @@ function GameCanvas2D({
     }
     return null;
   }, []);
-  React91.useEffect(() => {
+  React90.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -30283,7 +30313,7 @@ function TurnPanel({
   className
 }) {
   const eventBus = useEventBus();
-  const handleAction = React91.useCallback(
+  const handleAction = React90.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { turn: currentTurn, phase, activeTeam });
@@ -30452,7 +30482,7 @@ function UnitCommandBar({
   className
 }) {
   const eventBus = useEventBus();
-  const handleCommand = React91.useCallback(
+  const handleCommand = React90.useCallback(
     (event) => {
       if (event) {
         eventBus.emit(event, { unitId: selectedUnitId });
@@ -30966,7 +30996,7 @@ function GameMenu({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleOptionClick = React91.useCallback(
+  const handleOptionClick = React90.useCallback(
     (option) => {
       if (option.event && eventBus) {
         eventBus.emit(`UI:${option.event}`, { option });
@@ -31085,7 +31115,7 @@ function GameOverScreen({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleActionClick = React91.useCallback(
+  const handleActionClick = React90.useCallback(
     (action) => {
       if (action.event && eventBus) {
         eventBus.emit(`UI:${action.event}`, { action });
@@ -31974,13 +32004,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect84, useRef: useRef76, useCallback: useCallback124, useState: useState120 } = React91__default;
+      const { useEffect: useEffect85, useRef: useRef77, useCallback: useCallback125, useState: useState121 } = React90__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus4 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef76({ centerLat, centerLng, zoom });
-        useEffect84(() => {
+        const prevRef = useRef77({ centerLat, centerLng, zoom });
+        useEffect85(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -31991,7 +32021,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect84(() => {
+        useEffect85(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -32019,8 +32049,8 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus4();
-        const [clickedPosition, setClickedPosition] = useState120(null);
-        const handleMapClick = useCallback124((lat, lng) => {
+        const [clickedPosition, setClickedPosition] = useState121(null);
+        const handleMapClick = useCallback125((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -32029,7 +32059,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback124((marker) => {
+        const handleMarkerClick = useCallback125((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -32880,8 +32910,8 @@ function TableView({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React91__default.useState(pageSize > 0 ? pageSize : Infinity);
-  const [localSelected, setLocalSelected] = React91__default.useState(/* @__PURE__ */ new Set());
+  const [visibleCount, setVisibleCount] = React90__default.useState(pageSize > 0 ? pageSize : Infinity);
+  const [localSelected, setLocalSelected] = React90__default.useState(/* @__PURE__ */ new Set());
   const colDefs = columns ?? fields ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -33076,12 +33106,12 @@ function TableView({
         ]
       }
     );
-    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React91__default.Fragment, { children: rowInner }, id);
+    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React90__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(React91__default.Fragment, { children: [
+  const body = /* @__PURE__ */ jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxs(React90__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)) });
@@ -34438,7 +34468,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(React91__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(React90__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" })
@@ -34449,7 +34479,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(React91__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(React90__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 }),
@@ -35434,7 +35464,7 @@ var init_LikertScale = __esm({
       md: "text-base",
       lg: "text-lg"
     };
-    LikertScale = React91__default.forwardRef(
+    LikertScale = React90__default.forwardRef(
       ({
         question,
         options = DEFAULT_LIKERT_OPTIONS,
@@ -35446,7 +35476,7 @@ var init_LikertScale = __esm({
         variant = "radios",
         className
       }, ref) => {
-        const groupId = React91__default.useId();
+        const groupId = React90__default.useId();
         const eventBus = useEventBus();
         const handleSelect = useCallback(
           (next) => {
@@ -37728,7 +37758,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(React91__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsx(
                 Icon,
                 {
@@ -38392,7 +38422,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(React91__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(React90__default.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: "/" }),
           crumb.href ? /* @__PURE__ */ jsx(
             "a",
@@ -39121,7 +39151,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(React91__default.Fragment, { children: [
+              return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
                 /* @__PURE__ */ jsx(
                   Button,
                   {
@@ -41456,7 +41486,7 @@ var init_DetailPanel = __esm({
   }
 });
 function extractTitle(children) {
-  if (!React91__default.isValidElement(children)) return void 0;
+  if (!React90__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -41511,7 +41541,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(React91__default.Fragment, { children: [
+      return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
         i > 0 && /* @__PURE__ */ jsx(
           Typography,
           {
@@ -42461,12 +42491,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 = React91__default.useMemo(() => {
+      const normalizedInitialData = React90__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 = React91__default.useMemo(() => {
+      const entityDerivedFields = React90__default.useMemo(() => {
         if (fields && fields.length > 0) return void 0;
         if (!resolvedEntity) return void 0;
         return resolvedEntity.fields.map(
@@ -42486,16 +42516,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] = React91__default.useState(
+      const [formData, setFormData] = React90__default.useState(
         normalizedInitialData
       );
-      const [collapsedSections, setCollapsedSections] = React91__default.useState(
+      const [collapsedSections, setCollapsedSections] = React90__default.useState(
         /* @__PURE__ */ new Set()
       );
-      const [submitError, setSubmitError] = React91__default.useState(null);
-      const formRef = React91__default.useRef(null);
+      const [submitError, setSubmitError] = React90__default.useState(null);
+      const formRef = React90__default.useRef(null);
       const formMode = props.mode;
-      const mountedRef = React91__default.useRef(false);
+      const mountedRef = React90__default.useRef(false);
       if (!mountedRef.current) {
         mountedRef.current = true;
         debug("forms", "mount", {
@@ -42508,7 +42538,7 @@ var init_Form = __esm({
         });
       }
       const shouldShowCancel = showCancel ?? (fields && fields.length > 0);
-      const evalContext = React91__default.useMemo(
+      const evalContext = React90__default.useMemo(
         () => ({
           formValues: formData,
           globalVariables: externalContext?.globalVariables ?? {},
@@ -42517,7 +42547,7 @@ var init_Form = __esm({
         }),
         [formData, externalContext]
       );
-      React91__default.useEffect(() => {
+      React90__default.useEffect(() => {
         debug("forms", "initialData-sync", {
           mode: formMode,
           normalizedInitialData,
@@ -42528,7 +42558,7 @@ var init_Form = __esm({
           setFormData(normalizedInitialData);
         }
       }, [normalizedInitialData]);
-      const processCalculations = React91__default.useCallback(
+      const processCalculations = React90__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!hiddenCalculations.length) return;
           const context = {
@@ -42553,7 +42583,7 @@ var init_Form = __esm({
         },
         [hiddenCalculations, externalContext, eventBus]
       );
-      const checkViolations = React91__default.useCallback(
+      const checkViolations = React90__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!violationTriggers.length) return;
           const context = {
@@ -42591,7 +42621,7 @@ var init_Form = __esm({
         processCalculations(name, newFormData);
         checkViolations(name, newFormData);
       };
-      const isFieldVisible = React91__default.useCallback(
+      const isFieldVisible = React90__default.useCallback(
         (fieldName) => {
           const condition = conditionalFields[fieldName];
           if (!condition) return true;
@@ -42599,7 +42629,7 @@ var init_Form = __esm({
         },
         [conditionalFields, evalContext]
       );
-      const isSectionVisible = React91__default.useCallback(
+      const isSectionVisible = React90__default.useCallback(
         (section) => {
           if (!section.condition) return true;
           return Boolean(evaluateFormExpression(section.condition, evalContext));
@@ -42675,7 +42705,7 @@ var init_Form = __esm({
           eventBus.emit(`UI:${onCancel}`);
         }
       };
-      const renderField = React91__default.useCallback(
+      const renderField = React90__default.useCallback(
         (field) => {
           const fieldName = field.name || field.field;
           if (!fieldName) return null;
@@ -42696,7 +42726,7 @@ var init_Form = __esm({
         [formData, isFieldVisible, relationsData, relationsLoading, isLoading]
       );
       const effectiveFields = entityDerivedFields ?? fields;
-      const normalizedFields = React91__default.useMemo(() => {
+      const normalizedFields = React90__default.useMemo(() => {
         if (!effectiveFields || effectiveFields.length === 0) return [];
         return effectiveFields.map((field) => {
           if (typeof field === "string") {
@@ -42719,7 +42749,7 @@ var init_Form = __esm({
           return field;
         });
       }, [effectiveFields, resolvedEntity]);
-      const schemaFields = React91__default.useMemo(() => {
+      const schemaFields = React90__default.useMemo(() => {
         if (normalizedFields.length === 0) return null;
         if (isDebugEnabled()) {
           debugGroup(`Form: ${entityName || "unknown"}`);
@@ -42729,7 +42759,7 @@ var init_Form = __esm({
         }
         return normalizedFields.map(renderField).filter(Boolean);
       }, [normalizedFields, renderField, entityName, conditionalFields]);
-      const sectionElements = React91__default.useMemo(() => {
+      const sectionElements = React90__default.useMemo(() => {
         if (!sections || sections.length === 0) return null;
         return sections.map((section) => {
           if (!isSectionVisible(section)) {
@@ -43338,7 +43368,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();
@@ -43412,7 +43442,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;
@@ -43486,7 +43516,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());
@@ -43899,11 +43929,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);
@@ -43931,8 +43961,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) {
@@ -43995,7 +44025,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();
@@ -44003,7 +44033,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        log10.debug("Loaded", { url });
+        log9.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -44012,7 +44042,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,
@@ -44042,7 +44072,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;
       }
@@ -44128,11 +44158,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");
   }
 });
 
@@ -44156,6 +44186,47 @@ function CameraController({
   }, [camera.position, onCameraChange]);
   return null;
 }
+function UnitSpriteBillboard({
+  sheetUrl,
+  resolveFrame,
+  height = 1.2
+}) {
+  const texture = useLoader(THREE3.TextureLoader, sheetUrl);
+  const meshRef = useRef(null);
+  const matRef = useRef(null);
+  const [aspect, setAspect] = useState(1);
+  useFrame(() => {
+    const frame = resolveFrame();
+    if (!frame || !texture.image) return;
+    const imgW = texture.image.width;
+    const imgH = texture.image.height;
+    if (!imgW || !imgH) return;
+    texture.repeat.set((frame.flipX ? -1 : 1) * (frame.sw / imgW), frame.sh / imgH);
+    texture.offset.set(
+      frame.flipX ? (frame.sx + frame.sw) / imgW : frame.sx / imgW,
+      1 - (frame.sy + frame.sh) / imgH
+    );
+    texture.magFilter = THREE3.NearestFilter;
+    texture.minFilter = THREE3.NearestFilter;
+    texture.needsUpdate = true;
+    const nextAspect = frame.sw / frame.sh;
+    if (Math.abs(nextAspect - aspect) > 1e-3) setAspect(nextAspect);
+    if (matRef.current) matRef.current.needsUpdate = true;
+  });
+  return /* @__PURE__ */ jsxs("mesh", { ref: meshRef, position: [0, height / 2, 0], children: [
+    /* @__PURE__ */ jsx("planeGeometry", { args: [height * aspect, height] }),
+    /* @__PURE__ */ jsx(
+      "meshBasicMaterial",
+      {
+        ref: matRef,
+        map: texture,
+        transparent: true,
+        alphaTest: 0.1,
+        side: THREE3.DoubleSide
+      }
+    )
+  ] });
+}
 var DEFAULT_GRID_CONFIG, GameCanvas3D;
 var init_GameCanvas3D2 = __esm({
   "components/game/molecules/GameCanvas3D.tsx"() {
@@ -44166,6 +44237,7 @@ var init_GameCanvas3D2 = __esm({
     init_Canvas3DLoadingState2();
     init_Canvas3DErrorBoundary2();
     init_ModelLoader();
+    init_useUnitSpriteAtlas();
     init_cn();
     init_GameCanvas3D();
     DEFAULT_GRID_CONFIG = {
@@ -44222,8 +44294,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({
@@ -44282,7 +44356,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;
           },
@@ -44434,6 +44508,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",
               {
@@ -44445,7 +44521,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,
@@ -44499,7 +44584,7 @@ var init_GameCanvas3D2 = __esm({
               }
             );
           },
-          [selectedUnitId, handleUnitClick]
+          [selectedUnitId, handleUnitClick, resolveUnitFrame]
         );
         const DefaultFeatureRenderer = useCallback(
           ({
@@ -45566,7 +45651,7 @@ var init_List = __esm({
         if (entity && typeof entity === "object" && "id" in entity) return [entity];
         return [];
       }, [entity]);
-      const getItemActions = React91__default.useCallback(
+      const getItemActions = React90__default.useCallback(
         (item) => {
           if (!itemActions) return [];
           if (typeof itemActions === "function") {
@@ -46042,7 +46127,7 @@ var init_MediaGallery = __esm({
         [selectable, selectedItems, selectionEvent, eventBus]
       );
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React91__default.useMemo(() => {
+      const items = React90__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => ({
@@ -46203,7 +46288,7 @@ var init_MediaGallery = __esm({
   }
 });
 function extractTitle2(children) {
-  if (!React91__default.isValidElement(children)) return void 0;
+  if (!React90__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -47227,7 +47312,7 @@ var init_debugRegistry = __esm({
   }
 });
 function useDebugData() {
-  const [data, setData] = React91.useState(() => ({
+  const [data, setData] = React90.useState(() => ({
     traits: [],
     ticks: [],
     guards: [],
@@ -47241,7 +47326,7 @@ function useDebugData() {
     },
     lastUpdate: Date.now()
   }));
-  React91.useEffect(() => {
+  React90.useEffect(() => {
     const updateData = () => {
       setData({
         traits: getAllTraits(),
@@ -47350,12 +47435,12 @@ function layoutGraph(states, transitions, initialState, width, height) {
   return positions;
 }
 function WalkMinimap() {
-  const [walkStep, setWalkStep] = React91.useState(null);
-  const [traits2, setTraits] = React91.useState([]);
-  const [coveredEdges, setCoveredEdges] = React91.useState([]);
-  const [completedTraits, setCompletedTraits] = React91.useState(/* @__PURE__ */ new Set());
-  const prevTraitRef = React91.useRef(null);
-  React91.useEffect(() => {
+  const [walkStep, setWalkStep] = React90.useState(null);
+  const [traits2, setTraits] = React90.useState([]);
+  const [coveredEdges, setCoveredEdges] = React90.useState([]);
+  const [completedTraits, setCompletedTraits] = React90.useState(/* @__PURE__ */ new Set());
+  const prevTraitRef = React90.useRef(null);
+  React90.useEffect(() => {
     const interval = setInterval(() => {
       const w = window;
       const step = w.__orbitalWalkStep;
@@ -47791,15 +47876,15 @@ var init_EntitiesTab = __esm({
 });
 function EventFlowTab({ events: events2 }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React91.useState("all");
-  const containerRef = React91.useRef(null);
-  const [autoScroll, setAutoScroll] = React91.useState(true);
-  React91.useEffect(() => {
+  const [filter, setFilter] = React90.useState("all");
+  const containerRef = React90.useRef(null);
+  const [autoScroll, setAutoScroll] = React90.useState(true);
+  React90.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
   }, [events2.length, autoScroll]);
-  const filteredEvents = React91.useMemo(() => {
+  const filteredEvents = React90.useMemo(() => {
     if (filter === "all") return events2;
     return events2.filter((e) => e.type === filter);
   }, [events2, filter]);
@@ -47915,7 +48000,7 @@ var init_EventFlowTab = __esm({
 });
 function GuardsPanel({ guards }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React91.useState("all");
+  const [filter, setFilter] = React90.useState("all");
   if (guards.length === 0) {
     return /* @__PURE__ */ jsx(
       EmptyState,
@@ -47928,7 +48013,7 @@ function GuardsPanel({ guards }) {
   }
   const passedCount = guards.filter((g) => g.result).length;
   const failedCount = guards.length - passedCount;
-  const filteredGuards = React91.useMemo(() => {
+  const filteredGuards = React90.useMemo(() => {
     if (filter === "all") return guards;
     if (filter === "passed") return guards.filter((g) => g.result);
     return guards.filter((g) => !g.result);
@@ -48091,10 +48176,10 @@ function EffectBadge({ effect }) {
 }
 function TransitionTimeline({ transitions }) {
   const { t } = useTranslate();
-  const containerRef = React91.useRef(null);
-  const [autoScroll, setAutoScroll] = React91.useState(true);
-  const [expandedId, setExpandedId] = React91.useState(null);
-  React91.useEffect(() => {
+  const containerRef = React90.useRef(null);
+  const [autoScroll, setAutoScroll] = React90.useState(true);
+  const [expandedId, setExpandedId] = React90.useState(null);
+  React90.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
@@ -48374,9 +48459,9 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [log15, setLog] = React91.useState([]);
-  const prevStatesRef = React91.useRef(/* @__PURE__ */ new Map());
-  React91.useEffect(() => {
+  const [log15, setLog] = React90.useState([]);
+  const prevStatesRef = React90.useRef(/* @__PURE__ */ new Map());
+  React90.useEffect(() => {
     for (const trait of traits2) {
       const prev = prevStatesRef.current.get(trait.id);
       if (prev && prev !== trait.currentState) {
@@ -48545,10 +48630,10 @@ function VerifyModePanel({
   localCount
 }) {
   const { t } = useTranslate();
-  const [expanded, setExpanded] = React91.useState(true);
-  const scrollRef = React91.useRef(null);
-  const prevCountRef = React91.useRef(0);
-  React91.useEffect(() => {
+  const [expanded, setExpanded] = React90.useState(true);
+  const scrollRef = React90.useRef(null);
+  const prevCountRef = React90.useRef(0);
+  React90.useEffect(() => {
     if (expanded && transitions.length > prevCountRef.current && scrollRef.current) {
       scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
     }
@@ -48605,10 +48690,10 @@ function RuntimeDebugger({
   schema
 }) {
   const { t } = useTranslate();
-  const [isCollapsed, setIsCollapsed] = React91.useState(mode === "verify" ? true : defaultCollapsed);
-  const [isVisible, setIsVisible] = React91.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
+  const [isCollapsed, setIsCollapsed] = React90.useState(mode === "verify" ? true : defaultCollapsed);
+  const [isVisible, setIsVisible] = React90.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
   const debugData = useDebugData();
-  React91.useEffect(() => {
+  React90.useEffect(() => {
     if (mode === "inline") return;
     return onDebugToggle((enabled) => {
       setIsVisible(enabled);
@@ -48617,7 +48702,7 @@ function RuntimeDebugger({
       }
     });
   }, [mode]);
-  React91.useEffect(() => {
+  React90.useEffect(() => {
     if (mode === "inline") return;
     const handleKeyDown = (e) => {
       if (e.key === "`" && isVisible) {
@@ -49177,7 +49262,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(React91__default.Fragment, { children: [
+  return /* @__PURE__ */ jsx(HStack, { className: cn("items-center", className), gap: "sm", children: paddedSlots.map((slot, i) => /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
     i > 0 && /* @__PURE__ */ jsx(
       Typography,
       {
@@ -50066,7 +50151,7 @@ var init_StatCard = __esm({
       const labelToUse = propLabel ?? propTitle;
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const handleActionClick = React91__default.useCallback(() => {
+      const handleActionClick = React90__default.useCallback(() => {
         if (action?.event) {
           eventBus.emit(`UI:${action.event}`, {});
         }
@@ -50077,7 +50162,7 @@ var init_StatCard = __esm({
       const data = Array.isArray(entity) ? entity : entity ? [entity] : [];
       const isLoading = externalLoading ?? false;
       const error = externalError;
-      const computeMetricValue = React91__default.useCallback(
+      const computeMetricValue = React90__default.useCallback(
         (metric, items) => {
           if (metric.value !== void 0) {
             return metric.value;
@@ -50116,7 +50201,7 @@ var init_StatCard = __esm({
         },
         []
       );
-      const schemaStats = React91__default.useMemo(() => {
+      const schemaStats = React90__default.useMemo(() => {
         if (!metrics || metrics.length === 0) return null;
         return metrics.map((metric) => ({
           label: metric.label,
@@ -50124,7 +50209,7 @@ var init_StatCard = __esm({
           format: metric.format
         }));
       }, [metrics, data, computeMetricValue]);
-      const calculatedTrend = React91__default.useMemo(() => {
+      const calculatedTrend = React90__default.useMemo(() => {
         if (manualTrend !== void 0) return manualTrend;
         if (previousValue === void 0 || currentValue === void 0)
           return void 0;
@@ -51090,7 +51175,7 @@ var init_Timeline = __esm({
     }) => {
       const { t } = useTranslate();
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React91__default.useMemo(() => {
+      const items = React90__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => {
@@ -51197,7 +51282,7 @@ var init_Timeline = __esm({
   }
 });
 function extractToastProps(children) {
-  if (!React91__default.isValidElement(children)) {
+  if (!React90__default.isValidElement(children)) {
     if (typeof children === "string") {
       return { message: children };
     }
@@ -51235,7 +51320,7 @@ var init_ToastSlot = __esm({
         eventBus.emit("UI:CLOSE");
       };
       if (!isVisible) return null;
-      const isCustomContent = React91__default.isValidElement(children) && !message;
+      const isCustomContent = React90__default.isValidElement(children) && !message;
       return /* @__PURE__ */ jsx(Box, { className: "fixed bottom-4 right-4 z-50", children: isCustomContent ? children : /* @__PURE__ */ jsx(
         Toast,
         {
@@ -52104,7 +52189,7 @@ var init_WorldMapTemplate = __esm({
   }
 });
 function lazyThree(name, loader) {
-  const Lazy = React91__default.lazy(
+  const Lazy = React90__default.lazy(
     () => loader().then((m) => {
       const Resolved = m[name];
       if (!Resolved) {
@@ -52116,13 +52201,13 @@ function lazyThree(name, loader) {
     })
   );
   function ThreeWrapper(props) {
-    return React91__default.createElement(
+    return React90__default.createElement(
       ThreeBoundary,
       { name },
-      React91__default.createElement(
-        React91__default.Suspense,
+      React90__default.createElement(
+        React90__default.Suspense,
         { fallback: null },
-        React91__default.createElement(Lazy, props)
+        React90__default.createElement(Lazy, props)
       )
     );
   }
@@ -52420,7 +52505,7 @@ var init_component_registry_generated = __esm({
     init_WorldMapBoard();
     init_WorldMapTemplate();
     init_XPBar();
-    ThreeBoundary = class extends React91__default.Component {
+    ThreeBoundary = class extends React90__default.Component {
       constructor() {
         super(...arguments);
         __publicField(this, "state", { failed: false });
@@ -52430,7 +52515,7 @@ var init_component_registry_generated = __esm({
       }
       render() {
         if (this.state.failed) {
-          return React91__default.createElement(
+          return React90__default.createElement(
             "div",
             {
               "data-testid": "three-unavailable",
@@ -52771,7 +52856,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React91__default.createElement(
+  return React90__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -53261,7 +53346,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
         const key = `${parentId}-${index}-trait:${traitName}`;
         return /* @__PURE__ */ jsx(TraitFrame, { traitName }, key);
       }
-      return /* @__PURE__ */ jsx(React91__default.Fragment, { children: child }, `${parentId}-${index}`);
+      return /* @__PURE__ */ jsx(React90__default.Fragment, { children: child }, `${parentId}-${index}`);
     }
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
@@ -53301,14 +53386,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 (React91__default.isValidElement(value)) return false;
+  if (React90__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 (React91__default.isValidElement(value)) return false;
+  if (React90__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
@@ -53815,7 +53900,7 @@ var AvlTransition = ({
   opacity = 1,
   className
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlTransitionId += 1;
     return { arrow: `avl-tr-${avlTransitionId}-arrow` };
   }, []);
@@ -54376,7 +54461,7 @@ var AvlStateMachine = ({
   color = "var(--color-primary)",
   animated = false
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlSmId += 1;
     const base = `avl-sm-${avlSmId}`;
     return { glow: `${base}-glow`, grad: `${base}-grad` };
@@ -54575,7 +54660,7 @@ var AvlOrbitalUnit = ({
   color = "var(--color-primary)",
   animated = false
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlOuId += 1;
     const base = `avl-ou-${avlOuId}`;
     return { glow: `${base}-glow`, grad: `${base}-grad` };
@@ -54671,7 +54756,7 @@ var AvlClosedCircuit = ({
   color = "var(--color-primary)",
   animated = false
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlCcId += 1;
     const base = `avl-cc-${avlCcId}`;
     return { glow: `${base}-glow`, grad: `${base}-grad`, arrow: `${base}-arrow` };
@@ -54826,7 +54911,7 @@ var AvlEmitListen = ({
   color = "var(--color-primary)",
   animated = false
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlElId += 1;
     const base = `avl-el-${avlElId}`;
     return { arrow: `${base}-arrow`, grad: `${base}-grad` };
@@ -55100,7 +55185,7 @@ function renderNode(node, color, glowId) {
   const baseR = node.type === "operator" ? 20 : 16;
   const r2 = Math.max(baseR, labelLen * 3.5 + 6);
   const nc = nodeColor(node.type, color);
-  return /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+  return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
     node.children.map((child, i) => {
       const childR = Math.max(
         child.type === "operator" ? 20 : 16,
@@ -55157,7 +55242,7 @@ var AvlExprTree = ({
   className,
   color = "var(--color-primary)"
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlEtId += 1;
     return { glow: `avl-et-${avlEtId}-glow` };
   }, []);
@@ -55981,7 +56066,7 @@ var SystemNode = ({ data }) => {
           stateChain.length > 0 && /* @__PURE__ */ jsx("svg", { width: stateChain.length * 14 + 2, height: 10, viewBox: `0 0 ${stateChain.length * 14 + 2} 10`, children: stateChain.map((s, i) => {
             const tc = transitionCounts[s.name] ?? 0;
             const role = getStateRole(s.name, s.isInitial, s.isTerminal, tc, maxTC);
-            return /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
               /* @__PURE__ */ jsx(AvlState, { x: i * 14 + 1, y: 1, width: 10, height: 8, name: "", role, isInitial: s.isInitial, isTerminal: s.isTerminal }),
               i < stateChain.length - 1 && /* @__PURE__ */ jsx("line", { x1: i * 14 + 12, y1: 5, x2: i * 14 + 15, y2: 5, stroke: "var(--color-border)", strokeWidth: 0.5 })
             ] }, s.name);
@@ -57133,7 +57218,7 @@ function resolveLambdaBindings(body, params, item, index) {
   if (Array.isArray(body)) {
     return body.map((b) => recur(b));
   }
-  if (body !== null && typeof body === "object" && !React91__default.isValidElement(body) && !(body instanceof Date) && typeof body !== "function") {
+  if (body !== null && typeof body === "object" && !React90__default.isValidElement(body) && !(body instanceof Date) && typeof body !== "function") {
     const out = {};
     for (const [k, v] of Object.entries(body)) {
       out[k] = recur(v);
@@ -57152,7 +57237,7 @@ function getSlotContentRenderer2() {
 function makeLambdaFn(params, lambdaBody, callerKey) {
   return (item, index) => {
     const resolvedBody = resolveLambdaBindings(lambdaBody, params, item, index);
-    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody) || typeof resolvedBody === "function" || React91__default.isValidElement(resolvedBody) || resolvedBody instanceof Date) {
+    if (resolvedBody === null || typeof resolvedBody !== "object" || Array.isArray(resolvedBody) || typeof resolvedBody === "function" || React90__default.isValidElement(resolvedBody) || resolvedBody instanceof Date) {
       return null;
     }
     const record = resolvedBody;
@@ -57171,7 +57256,7 @@ function makeLambdaFn(params, lambdaBody, callerKey) {
       props: childProps,
       priority: 0
     };
-    return React91__default.createElement(SlotContentRenderer2, { content: childContent });
+    return React90__default.createElement(SlotContentRenderer2, { content: childContent });
   };
 }
 function convertNode(node, callerKey) {
@@ -57190,7 +57275,7 @@ function convertNode(node, callerKey) {
     });
     return anyChanged ? mapped : node;
   }
-  if (typeof node === "object" && !React91__default.isValidElement(node) && !(node instanceof Date)) {
+  if (typeof node === "object" && !React90__default.isValidElement(node) && !(node instanceof Date)) {
     return convertObjectProps(node);
   }
   return node;
@@ -57217,7 +57302,7 @@ function convertObjectProps(props) {
 function convertFnFormLambdasInProps(props) {
   return convertObjectProps(props);
 }
-var log11 = createLogger("almadar:ui:effects:client-handlers");
+var log10 = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
@@ -57226,10 +57311,10 @@ function createClientEffectHandlers(options) {
       eventBus.emit(prefixedEvent, payload);
     },
     persist: async () => {
-      log11.warn("persist is server-side only, ignored on client");
+      log10.warn("persist is server-side only, ignored on client");
     },
     set: () => {
-      log11.warn("set is server-side only, ignored on client");
+      log10.warn("set is server-side only, ignored on client");
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -57258,10 +57343,10 @@ function createClientEffectHandlers(options) {
       slotSetter.addPattern(slot, pattern, props);
     },
     navigate: navigate ?? ((path) => {
-      log11.warn("No navigate handler, ignoring", { path });
+      log10.warn("No navigate handler, ignoring", { path });
     }),
     notify: notify ?? ((msg, type) => {
-      log11.debug("notify", { type, message: msg });
+      log10.debug("notify", { type, message: msg });
     })
   };
 }
@@ -57273,6 +57358,27 @@ init_verificationRegistry();
 var crossTraitLog = createLogger("almadar:ui:cross-trait");
 var flushLog = createLogger("almadar:ui:slot-flush");
 var stateLog = createLogger("almadar:ui:state-transitions");
+var tickLog = createLogger("almadar:ui:tick-effects");
+var SYNC_TICK_OPERATORS = /* @__PURE__ */ new Set([
+  "set",
+  "emit",
+  "render-ui",
+  "render",
+  "navigate",
+  "notify",
+  "log",
+  // Synchronous structural forms that wrap sync effects. A tick authored as
+  // a single top-level `(let ((..)) (do (set ..) (render-ui ..)))` or
+  // `(if cond (set ..) ..)` is one of these at its head — the EffectExecutor
+  // resolves the binding values / condition through the canonical evaluator
+  // and runs the wrapped sync effects. Without these in the allow-list the
+  // whole tick is filtered out (its head op isn't `set`/`emit`/...), so the
+  // physics/gameflow/AI tick never runs.
+  "let",
+  "if",
+  "do",
+  "when"
+]);
 function toTraitDefinition(binding) {
   return {
     name: binding.trait.name,
@@ -57469,50 +57575,196 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       for (const unreg of snapshotUnregs) unreg();
     };
   }, [traitBindings]);
-  const runTickEffects = useCallback((tick, binding) => {
-    const currentState = traitStatesRef.current.get(binding.trait.name)?.currentState ?? "";
-    if (tick.appliesTo.length > 0 && !tick.appliesTo.includes(currentState)) return;
-    const bindingCtx = { entity: {}, payload: {}, state: currentState };
-    if (binding.config) {
-      bindingCtx.config = binding.config;
-    }
-    const evalCtx = createContextFromBindings(bindingCtx);
-    if (tick.guard !== void 0) {
-      const passed = interpolateValue(tick.guard, evalCtx);
-      if (!passed) return;
-    }
+  const executeTransitionEffects = useCallback(async (params) => {
+    const { binding, previousState, newState, payload, flushEvent, syncOnly, log: log15 } = params;
+    const traitName = binding.trait.name;
+    const linkedEntity = binding.linkedEntity || "";
+    const entityId = payload?.entityId;
+    const effects = syncOnly ? params.effects.filter(
+      (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
+    ) : params.effects;
+    if (effects.length === 0) return [];
     const pendingSlots = /* @__PURE__ */ new Map();
     ({
-      trait: binding.trait.name,
-      transition: `${currentState}->tick:${tick.name}`,
-      effects: tick.effects,
       traitDefinition: binding.trait
     });
-    for (const effect of tick.effects) {
-      if (!Array.isArray(effect)) continue;
-      const op = effect[0];
-      if (op === "render-ui" || op === "render") {
-        const slot = effect[1];
-        const rawPattern = effect[2];
-        if (rawPattern === null || rawPattern === void 0) {
+    const clientHandlers = createClientEffectHandlers({
+      eventBus,
+      slotSetter: {
+        addPattern: (slot, pattern, props) => {
+          const existing = pendingSlots.get(slot) || [];
+          existing.push({ pattern, props: props || {} });
+          pendingSlots.set(slot, existing);
+        },
+        clearSlot: (slot) => {
           pendingSlots.set(slot, []);
-          continue;
         }
-        const updatedCtx = createContextFromBindings(bindingCtx);
-        const resolved = interpolateValue(rawPattern, updatedCtx);
-        const existing = pendingSlots.get(slot) ?? [];
-        existing.push({ pattern: resolved, props: {} });
-        pendingSlots.set(slot, existing);
+      },
+      navigate: optionsRef.current?.navigate,
+      notify: optionsRef.current?.notify,
+      callService: optionsRef.current?.callService
+    });
+    const persistence = syncOnly ? void 0 : optionsRef.current?.persistence;
+    let handlers = clientHandlers;
+    if (persistence) {
+      const sharedBindings = {
+        // Seed `@entity` from the trait's scalar field state (a real
+        // EntityRow), the same source the executor's own bindingCtx
+        // uses below. `@payload.*` resolves from `payload` separately,
+        // so dropping the prior `payload as EntityRow` cast loses
+        // nothing — it just stops mislabelling the payload as an entity.
+        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        payload: payload || {},
+        state: previousState
+      };
+      const sharedDeclared = collectDeclaredConfigDefaults(binding.trait);
+      const sharedCallSite = binding.config;
+      if (sharedDeclared || sharedCallSite) {
+        sharedBindings.config = {
+          ...sharedDeclared ?? {},
+          ...sharedCallSite ?? {}
+        };
+      }
+      const serverHandlers = createServerEffectHandlers({
+        persistence,
+        eventBus,
+        entityType: linkedEntity,
+        entityId,
+        bindings: sharedBindings,
+        context: {
+          traitName,
+          state: previousState,
+          transition: `${previousState}->${newState}`,
+          linkedEntity,
+          entityId
+        },
+        source: { trait: traitName },
+        callService: optionsRef.current?.callService
+      });
+      handlers = {
+        ...serverHandlers,
+        emit: clientHandlers.emit,
+        renderUI: clientHandlers.renderUI,
+        navigate: clientHandlers.navigate,
+        notify: clientHandlers.notify
+      };
+    }
+    const baseSet = handlers.set;
+    handlers = {
+      ...handlers,
+      set: async (targetId, field, value) => {
+        let fieldState = traitFieldStatesRef.current.get(traitName);
+        if (!fieldState) {
+          fieldState = {};
+          traitFieldStatesRef.current.set(traitName, fieldState);
+        }
+        fieldState[field] = value;
+        log15.debug("set:write", {
+          traitName,
+          field,
+          value: JSON.stringify(value),
+          transition: `${previousState}->${newState}`
+        });
+        if (baseSet) await baseSet(targetId, field, value);
       }
+    };
+    const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
+    const bindingCtx = {
+      entity: entityForBinding,
+      payload: payload || {},
+      state: previousState
+    };
+    const declaredDefaults = collectDeclaredConfigDefaults(binding.trait);
+    const callSiteConfig = binding.config;
+    if (declaredDefaults || callSiteConfig) {
+      bindingCtx.config = {
+        ...declaredDefaults ?? {},
+        ...callSiteConfig ?? {}
+      };
     }
-    for (const [slot, patterns] of pendingSlots) {
-      flushSlot(binding.trait.name, slot, patterns, {
-        event: `tick:${tick.name}`,
-        state: currentState,
-        entity: binding.linkedEntity
+    const effectContext = {
+      traitName,
+      state: previousState,
+      transition: `${previousState}->${newState}`,
+      linkedEntity,
+      entityId
+    };
+    const emittedDuringExec = [];
+    const baseEmit = handlers.emit;
+    const trackingHandlers = {
+      ...handlers,
+      emit: (event, eventPayload, source) => {
+        emittedDuringExec.push(event);
+        baseEmit(event, eventPayload, source);
+      }
+    };
+    const executor = new EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
+    try {
+      await executor.executeAll(effects);
+      log15.debug("effects:executed", () => ({
+        traitName,
+        transition: `${previousState}->${newState}`,
+        event: flushEvent,
+        effectCount: effects.length,
+        emitted: emittedDuringExec.join(","),
+        entityAfter: JSON.stringify(traitFieldStatesRef.current.get(traitName) ?? {}),
+        slotsTouched: Array.from(pendingSlots.keys()).join(",")
+      }));
+      for (const [slot, patterns] of pendingSlots) {
+        log15.debug("flush:slot", {
+          traitName,
+          slot,
+          patternCount: patterns.length,
+          event: flushEvent,
+          transition: `${previousState}->${newState}`,
+          cleared: patterns.length === 0
+        });
+        flushSlot(traitName, slot, patterns, {
+          event: flushEvent,
+          state: previousState,
+          entity: binding.linkedEntity
+        });
+      }
+    } catch (error) {
+      log15.error("effects:error", {
+        traitName,
+        transition: `${previousState}->${newState}`,
+        event: flushEvent,
+        error: error instanceof Error ? error.message : String(error),
+        effectCount: effects.length
       });
     }
-  }, [flushSlot]);
+    return emittedDuringExec;
+  }, [eventBus, flushSlot]);
+  const runTickEffects = useCallback((tick, binding) => {
+    const traitName = binding.trait.name;
+    const currentState = traitStatesRef.current.get(traitName)?.currentState ?? "";
+    if (tick.appliesTo.length > 0 && !tick.appliesTo.includes(currentState)) return;
+    if (tick.guard !== void 0) {
+      const guardCtx = {
+        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        payload: {},
+        state: currentState
+      };
+      if (binding.config) {
+        guardCtx.config = binding.config;
+      }
+      const passed = interpolateValue(tick.guard, createContextFromBindings(guardCtx));
+      if (!passed) {
+        tickLog.debug("guard-blocked", { traitName, tick: tick.name, state: currentState });
+        return;
+      }
+    }
+    void executeTransitionEffects({
+      binding,
+      effects: tick.effects,
+      previousState: currentState,
+      newState: currentState,
+      flushEvent: `tick:${tick.name}`,
+      syncOnly: true,
+      log: tickLog
+    });
+  }, [executeTransitionEffects]);
   useEffect(() => {
     const hasFrameTicks = traitBindingsRef.current.some(
       (b) => b.trait.ticks?.some((t) => t.interval === "frame")
@@ -57623,161 +57875,17 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           transition: `${result.previousState} -> ${result.newState}`,
           effects: JSON.stringify(result.effects)
         }));
-        const linkedEntity = binding.linkedEntity || "";
-        const entityId = payload?.entityId;
-        const pendingSlots = /* @__PURE__ */ new Map();
-        const slotSource = {
-          trait: binding.trait.name,
-          state: result.previousState,
-          transition: `${result.previousState}->${result.newState}`,
+        const emittedDuringExec = await executeTransitionEffects({
+          binding,
           effects: result.effects,
-          traitDefinition: binding.trait
-        };
-        const clientHandlers = createClientEffectHandlers({
-          eventBus,
-          slotSetter: {
-            addPattern: (slot, pattern, props) => {
-              const existing = pendingSlots.get(slot) || [];
-              existing.push({ pattern, props: props || {} });
-              pendingSlots.set(slot, existing);
-            },
-            clearSlot: (slot) => {
-              pendingSlots.set(slot, []);
-            }
-          },
-          navigate: optionsRef.current?.navigate,
-          notify: optionsRef.current?.notify,
-          callService: optionsRef.current?.callService
+          previousState: result.previousState,
+          newState: result.newState,
+          payload,
+          flushEvent: eventKey,
+          syncOnly: false,
+          log: stateLog
         });
-        const persistence = optionsRef.current?.persistence;
-        let handlers = clientHandlers;
-        if (persistence) {
-          const sharedBindings = {
-            entity: payload ?? {},
-            payload: payload || {},
-            state: result.previousState
-          };
-          const sharedDeclared = collectDeclaredConfigDefaults(
-            binding.trait
-          );
-          const sharedCallSite = binding.config;
-          if (sharedDeclared || sharedCallSite) {
-            sharedBindings.config = {
-              ...sharedDeclared ?? {},
-              ...sharedCallSite ?? {}
-            };
-          }
-          const serverHandlers = createServerEffectHandlers({
-            persistence,
-            eventBus,
-            entityType: linkedEntity,
-            entityId,
-            bindings: sharedBindings,
-            context: {
-              traitName: binding.trait.name,
-              state: result.previousState,
-              transition: `${result.previousState}->${result.newState}`,
-              linkedEntity,
-              entityId
-            },
-            source: { trait: binding.trait.name },
-            callService: optionsRef.current?.callService
-          });
-          handlers = {
-            ...serverHandlers,
-            // Client handlers own UI + emit: keep the slot setter
-            // and pre-prefixed UI:* emit path intact.
-            emit: clientHandlers.emit,
-            renderUI: clientHandlers.renderUI,
-            navigate: clientHandlers.navigate,
-            notify: clientHandlers.notify
-          };
-        }
-        const baseSet = handlers.set;
-        handlers = {
-          ...handlers,
-          set: async (targetId, field, value) => {
-            let fieldState = traitFieldStatesRef.current.get(traitName);
-            if (!fieldState) {
-              fieldState = {};
-              traitFieldStatesRef.current.set(traitName, fieldState);
-            }
-            fieldState[field] = value;
-            if (baseSet) await baseSet(targetId, field, value);
-          }
-        };
-        const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
-        const bindingCtx = {
-          entity: entityForBinding,
-          payload: payload || {},
-          state: result.previousState
-        };
-        const declaredDefaults = collectDeclaredConfigDefaults(
-          binding.trait
-        );
-        const callSiteConfig = binding.config;
-        if (declaredDefaults || callSiteConfig) {
-          bindingCtx.config = {
-            ...declaredDefaults ?? {},
-            ...callSiteConfig ?? {}
-          };
-        }
-        const effectContext = {
-          traitName: binding.trait.name,
-          state: result.previousState,
-          transition: `${result.previousState}->${result.newState}`,
-          linkedEntity,
-          entityId
-        };
-        const emittedDuringExec = [];
         emittedByTrait.set(traitName, emittedDuringExec);
-        const baseEmit = handlers.emit;
-        const trackingHandlers = {
-          ...handlers,
-          emit: (event, eventPayload, source) => {
-            emittedDuringExec.push(event);
-            baseEmit(event, eventPayload, source);
-          }
-        };
-        const executor = new EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
-        try {
-          await executor.executeAll(result.effects);
-          stateLog.debug("transition:render-ui-dispatched", () => ({
-            traitName,
-            fromState: result.previousState,
-            toState: result.newState,
-            event: eventKey,
-            slotsTouched: Array.from(pendingSlots.keys()).join(","),
-            patternTypes: Array.from(pendingSlots.entries()).map(
-              ([slot, patterns]) => `${slot}:[${patterns.map((p2) => p2.pattern?.type ?? "null").join(",")}]`
-            ).join(";")
-          }));
-          void slotSource;
-          for (const [slot, patterns] of pendingSlots) {
-            stateLog.debug("flush:slot", {
-              traitName,
-              slot,
-              patternCount: patterns.length,
-              event: eventKey,
-              transition: `${result.previousState}->${result.newState}`,
-              cleared: patterns.length === 0
-            });
-            flushSlot(traitName, slot, patterns, {
-              event: eventKey,
-              state: result.previousState,
-              entity: binding.linkedEntity
-            });
-          }
-        } catch (error) {
-          stateLog.error("transition:effect-error", {
-            traitName,
-            fromState: result.previousState,
-            toState: result.newState,
-            event: eventKey,
-            error: error instanceof Error ? error.message : String(error),
-            effectCount: result.effects.length
-          });
-        }
       } else if (!result.executed) {
         if (result.guardResult === false) {
           stateLog.debug("guard-blocked-transition", {
@@ -58185,9 +58293,175 @@ function ServerBridgeProvider({
   }, [schema, registerSchema, unregisterSchema]);
   return /* @__PURE__ */ jsx(ServerBridgeContext.Provider, { value: { connected, sendEvent }, children });
 }
-
-// context/OrbitalThemeProvider.tsx
-init_ThemeContext();
+createLogger("almadar:ui:theme");
+var 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
+  }
+];
+var ThemeContext = createContext(void 0);
+function useTheme2() {
+  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;
+}
 
 // context/themeTokens.ts
 function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
@@ -58406,7 +58680,7 @@ function resolveThemeForRuntime(theme) {
 }
 function OrbitalThemeProvider({ theme, children }) {
   const resolved = resolveThemeForRuntime(theme);
-  const { resolvedMode } = useTheme();
+  const { resolvedMode } = useTheme2();
   if (!resolved) {
     return /* @__PURE__ */ jsx(Fragment, { children });
   }
@@ -59203,8 +59477,8 @@ function CanvasDndProvider({
 }) {
   const eventBus = useEventBus();
   const sensors = useAlmadarDndSensors(false);
-  const [activePayload, setActivePayload] = React91__default.useState(null);
-  const handleDragStart = React91__default.useCallback((e) => {
+  const [activePayload, setActivePayload] = React90__default.useState(null);
+  const handleDragStart = React90__default.useCallback((e) => {
     const data = e.active.data.current;
     const payload = data?.payload;
     if (payload) {
@@ -59215,7 +59489,7 @@ function CanvasDndProvider({
       log13.warn("dragStart:missing-payload", { id: e.active.id });
     }
   }, [eventBus]);
-  const handleDragEnd = React91__default.useCallback((e) => {
+  const handleDragEnd = React90__default.useCallback((e) => {
     setActivePayload(null);
     const activeData = e.active.data.current;
     const payload = activeData?.payload;
@@ -59244,7 +59518,7 @@ function CanvasDndProvider({
     const suppressed = onDrop ? onDrop(drop) === true : false;
     if (!suppressed) defaultEmit(eventBus, drop);
   }, [eventBus, onDrop]);
-  const handleDragCancel = React91__default.useCallback(() => {
+  const handleDragCancel = React90__default.useCallback(() => {
     setActivePayload(null);
     log13.info("dragCancel");
   }, []);
@@ -59998,7 +60272,7 @@ var OrbPreviewNodeInner = (props) => {
     }
   );
 };
-var OrbPreviewNode = React91__default.memo(OrbPreviewNodeInner);
+var OrbPreviewNode = React90__default.memo(OrbPreviewNodeInner);
 OrbPreviewNode.displayName = "OrbPreviewNode";
 orbPreviewLog.debug("export-resolved", () => ({
   type: typeof OrbPreviewNode,
@@ -60103,7 +60377,7 @@ var EventFlowEdgeInner = (props) => {
     ) })
   ] });
 };
-var EventFlowEdge = React91__default.memo(EventFlowEdgeInner);
+var EventFlowEdge = React90__default.memo(EventFlowEdgeInner);
 EventFlowEdge.displayName = "EventFlowEdge";
 
 // components/avl/molecules/BehaviorComposeNode.tsx
@@ -60250,7 +60524,7 @@ var BehaviorComposeNodeInner = (props) => {
     }
   );
 };
-var BehaviorComposeNode = React91__default.memo(BehaviorComposeNodeInner);
+var BehaviorComposeNode = React90__default.memo(BehaviorComposeNodeInner);
 BehaviorComposeNode.displayName = "BehaviorComposeNode";
 
 // components/avl/molecules/avl-behavior-compose-converter.ts
@@ -61262,7 +61536,7 @@ var TraitCardNodeInner = (props) => {
     }
   );
 };
-var TraitCardNode = React91__default.memo(TraitCardNodeInner);
+var TraitCardNode = React90__default.memo(TraitCardNodeInner);
 TraitCardNode.displayName = "TraitCardNode";
 
 // components/avl/organisms/FlowCanvas.tsx
@@ -61335,7 +61609,7 @@ function FlowCanvasInner({
     initialOrbital
   );
   const [expandedBehaviorAlias, setExpandedBehaviorAlias] = useState(void 0);
-  const screenSizeUserOverrideRef = React91__default.useRef(false);
+  const screenSizeUserOverrideRef = React90__default.useRef(false);
   const [screenSize, setScreenSize] = useState(
     () => typeof window === "undefined" ? "laptop" : detectScreenSize(window.innerWidth)
   );
@@ -61719,7 +61993,7 @@ var ZoomBreadcrumb = ({
   if (eventName && band === "detail") {
     segments.push({ icon: "\u26A1", label: eventName });
   }
-  return /* @__PURE__ */ jsx("div", { className: "absolute top-2 left-2 z-10 flex items-center gap-1 px-2 py-1 rounded-md bg-card/90 border border-border text-xs text-muted-foreground backdrop-blur-sm", children: segments.map((seg, i) => /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+  return /* @__PURE__ */ jsx("div", { className: "absolute top-2 left-2 z-10 flex items-center gap-1 px-2 py-1 rounded-md bg-card/90 border border-border text-xs text-muted-foreground backdrop-blur-sm", children: segments.map((seg, i) => /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
     i > 0 && /* @__PURE__ */ jsx("span", { className: "opacity-40", children: ">" }),
     /* @__PURE__ */ jsx("span", { className: "opacity-60", children: seg.icon }),
     /* @__PURE__ */ jsx("span", { children: seg.label })
@@ -62060,7 +62334,7 @@ var EventWireOverlay = ({
   containerW,
   containerH
 }) => {
-  const ids = React91__default.useMemo(() => {
+  const ids = React90__default.useMemo(() => {
     avlOczWireId += 1;
     return { arrow: `avl-ocz-wire-${avlOczWireId}-arrow` };
   }, []);
@@ -62427,7 +62701,7 @@ var AvlOrbitalsCosmicZoom = ({
               borderRadius: 6,
               border: `1px solid ${color}`
             },
-            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React91__default.Fragment, { children: [
+            children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", children: breadcrumbs.map((crumb, i) => /* @__PURE__ */ jsxs(React90__default.Fragment, { children: [
               i > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", style: { opacity: 0.5, color }, children: "/" }),
               i < breadcrumbs.length - 1 ? /* @__PURE__ */ jsx(
                 Box,