@almadar/ui 5.76.1 → 5.76.4

package/dist/providers/index.js

@@ -1,6 +1,6 @@
-import * as React106 from 'react';
-import React106__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId, useSyncExternalStore } from 'react';
-import { EventBusContext, useTraitScope, useEntitySchemaOptional, TraitScopeProvider, useCurrentPagePath, useGameAudioContextOptional } from '@almadar/ui/providers';
+import * as React107 from 'react';
+import React107__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId, useSyncExternalStore } from 'react';
+import { EventBusContext, useTraitScope, useEntitySchemaOptional, TraitScopeProvider, useCurrentPagePath } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
@@ -10,7 +10,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
 import { useTranslate } from '@almadar/ui/hooks';
 import { useUISlots, ThemeProvider, useTheme } from '@almadar/ui/context';
-export { BUILT_IN_THEMES, DesignThemeProvider, default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, useDesignTheme, useSlotContent, useSlotHasContent, useTheme, useUISlots } from '@almadar/ui/context';
+export { DesignThemeProvider, useDesignTheme } from '@almadar/ui/context';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
 import { getPatternDefinition, getComponentForPattern } from '@almadar/patterns';
 import { Link, Outlet, useLocation } from 'react-router-dom';
@@ -388,7 +388,7 @@ var init_Box = __esm({
       fixed: "fixed",
       sticky: "sticky"
     };
-    Box = React106__default.forwardRef(
+    Box = React107__default.forwardRef(
       ({
         padding,
         paddingX,
@@ -453,7 +453,7 @@ var init_Box = __esm({
           onPointerDown?.(e);
         }, [hoverEvent, tapReveal, triggerProps, onPointerDown]);
         const isClickable = action || onClick;
-        return React106__default.createElement(
+        return React107__default.createElement(
           Component,
           {
             ref,
@@ -549,7 +549,7 @@ function loadLib(key, importer) {
   return p2;
 }
 function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
-  const Lazy = React106__default.lazy(async () => {
+  const Lazy = React107__default.lazy(async () => {
     const lib = await loadLib(libKey, importer);
     const Comp = pick(lib);
     if (!Comp) {
@@ -559,7 +559,7 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
     return { default: Comp };
   });
   const Wrapped = (props) => /* @__PURE__ */ jsx(
-    React106__default.Suspense,
+    React107__default.Suspense,
     {
       fallback: /* @__PURE__ */ jsx(
         "span",
@@ -1286,7 +1286,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 = React106__default.useMemo(() => {
+      const RenderedComponent = React107__default.useMemo(() => {
         if (directIcon) return null;
         return effectiveName ? resolveIconForFamily(effectiveName, family) : null;
       }, [directIcon, effectiveName, family]);
@@ -1348,7 +1348,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React106__default.isValidElement(value)) {
+  if (React107__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && isIconLike(value)) {
@@ -1424,7 +1424,7 @@ var init_Button = __esm({
       md: "h-icon-default w-icon-default",
       lg: "h-icon-default w-icon-default"
     };
-    Button = React106__default.forwardRef(
+    Button = React107__default.forwardRef(
       ({
         className,
         variant = "primary",
@@ -1490,7 +1490,7 @@ var Dialog;
 var init_Dialog = __esm({
   "components/core/atoms/Dialog.tsx"() {
     init_cn();
-    Dialog = React106__default.forwardRef(
+    Dialog = React107__default.forwardRef(
       ({
         role = "dialog",
         "aria-modal": ariaModal = true,
@@ -1608,7 +1608,7 @@ var init_Typography = __esm({
     }) => {
       const variant = variantProp ?? (level ? `h${level}` : "body1");
       const Component = as || defaultElements[variant];
-      return React106__default.createElement(
+      return React107__default.createElement(
         Component,
         {
           id,
@@ -2103,7 +2103,7 @@ var init_Badge = __esm({
       md: "px-2.5 py-1 text-sm",
       lg: "px-3 py-1.5 text-base"
     };
-    Badge = React106__default.forwardRef(
+    Badge = React107__default.forwardRef(
       ({ className, variant = "default", size = "sm", amount, label, icon, children, onRemove, removeLabel, ...props }, ref) => {
         const iconSizes3 = {
           sm: "h-icon-default w-icon-default",
@@ -2439,7 +2439,7 @@ var init_SvgFlow = __esm({
       width = 100,
       height = 100
     }) => {
-      const markerId = React106__default.useMemo(() => {
+      const markerId = React107__default.useMemo(() => {
         flowIdCounter += 1;
         return `almadar-flow-arrow-${flowIdCounter}`;
       }, []);
@@ -3032,7 +3032,7 @@ var init_SvgRing = __esm({
       width = 100,
       height = 100
     }) => {
-      const gradientId = React106__default.useMemo(() => {
+      const gradientId = React107__default.useMemo(() => {
         ringIdCounter += 1;
         return `almadar-ring-glow-${ringIdCounter}`;
       }, []);
@@ -3213,7 +3213,7 @@ var init_Input = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Input = React106__default.forwardRef(
+    Input = React107__default.forwardRef(
       ({
         className,
         inputType,
@@ -3373,7 +3373,7 @@ var Label;
 var init_Label = __esm({
   "components/core/atoms/Label.tsx"() {
     init_cn();
-    Label = React106__default.forwardRef(
+    Label = React107__default.forwardRef(
       ({ className, required, children, ...props }, ref) => {
         return /* @__PURE__ */ jsxs(
           "label",
@@ -3400,7 +3400,7 @@ var init_Textarea = __esm({
   "components/core/atoms/Textarea.tsx"() {
     init_cn();
     init_useEventBus();
-    Textarea = React106__default.forwardRef(
+    Textarea = React107__default.forwardRef(
       ({ className, error, onChange, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
@@ -3639,7 +3639,7 @@ var init_Select = __esm({
     init_cn();
     init_Icon();
     init_useEventBus();
-    Select = React106__default.forwardRef(
+    Select = React107__default.forwardRef(
       (props, _ref) => {
         const { multiple, searchable, clearable } = props;
         if (multiple || searchable || clearable) {
@@ -3656,7 +3656,7 @@ var init_Checkbox = __esm({
   "components/core/atoms/Checkbox.tsx"() {
     init_cn();
     init_useEventBus();
-    Checkbox = React106__default.forwardRef(
+    Checkbox = React107__default.forwardRef(
       ({ className, label, id, onChange, ...props }, ref) => {
         const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
         const eventBus = useEventBus();
@@ -3710,7 +3710,7 @@ var init_Spinner = __esm({
       md: "h-6 w-6",
       lg: "h-8 w-8"
     };
-    Spinner = React106__default.forwardRef(
+    Spinner = React107__default.forwardRef(
       ({ className, size = "md", overlay, ...props }, ref) => {
         if (overlay) {
           return /* @__PURE__ */ jsx(
@@ -3800,7 +3800,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 = React106__default.forwardRef(
+    Card = React107__default.forwardRef(
       ({
         className,
         variant = "bordered",
@@ -3848,9 +3848,9 @@ var init_Card = __esm({
       }
     );
     Card.displayName = "Card";
-    CardHeader = React106__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+    CardHeader = React107__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
     CardHeader.displayName = "CardHeader";
-    CardTitle = React106__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardTitle = React107__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "h3",
       {
         ref,
@@ -3863,11 +3863,11 @@ var init_Card = __esm({
       }
     ));
     CardTitle.displayName = "CardTitle";
-    CardContent = React106__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+    CardContent = React107__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
     CardContent.displayName = "CardContent";
     CardBody = CardContent;
     CardBody.displayName = "CardBody";
-    CardFooter = React106__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+    CardFooter = React107__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
       "div",
       {
         ref,
@@ -3922,7 +3922,7 @@ var init_FilterPill = __esm({
       md: "w-3.5 h-3.5",
       lg: "w-4 h-4"
     };
-    FilterPill = React106__default.forwardRef(
+    FilterPill = React107__default.forwardRef(
       ({
         className,
         variant = "default",
@@ -4051,8 +4051,8 @@ var init_Avatar = __esm({
       actionPayload
     }) => {
       const eventBus = useEventBus();
-      const [imgFailed, setImgFailed] = React106__default.useState(false);
-      React106__default.useEffect(() => {
+      const [imgFailed, setImgFailed] = React107__default.useState(false);
+      React107__default.useEffect(() => {
         setImgFailed(false);
       }, [src]);
       const initials = providedInitials ?? (name ? generateInitials(name) : void 0);
@@ -4165,7 +4165,7 @@ var init_Center = __esm({
       as: Component = "div"
     }) => {
       const mergedStyle = minHeight ? { minHeight, ...style } : style;
-      return React106__default.createElement(Component, {
+      return React107__default.createElement(Component, {
         className: cn(
           inline ? "inline-flex" : "flex",
           horizontal && "justify-center",
@@ -4433,7 +4433,7 @@ var init_Radio = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    Radio = React106__default.forwardRef(
+    Radio = React107__default.forwardRef(
       ({
         label,
         helperText,
@@ -4450,12 +4450,12 @@ var init_Radio = __esm({
         onChange,
         ...props
       }, ref) => {
-        const reactId = React106__default.useId();
+        const reactId = React107__default.useId();
         const baseId = id || `radio-${reactId}`;
         const hasError = !!error;
         const eventBus = useEventBus();
-        const [selected, setSelected] = React106__default.useState(value);
-        React106__default.useEffect(() => {
+        const [selected, setSelected] = React107__default.useState(value);
+        React107__default.useEffect(() => {
           if (value !== void 0) setSelected(value);
         }, [value]);
         const pick = (next, e) => {
@@ -4637,7 +4637,7 @@ var init_Switch = __esm({
   "components/core/atoms/Switch.tsx"() {
     "use client";
     init_cn();
-    Switch = React106.forwardRef(
+    Switch = React107.forwardRef(
       ({
         checked,
         defaultChecked = false,
@@ -4648,10 +4648,10 @@ var init_Switch = __esm({
         name,
         className
       }, ref) => {
-        const [isChecked, setIsChecked] = React106.useState(
+        const [isChecked, setIsChecked] = React107.useState(
           checked !== void 0 ? checked : defaultChecked
         );
-        React106.useEffect(() => {
+        React107.useEffect(() => {
           if (checked !== void 0) {
             setIsChecked(checked);
           }
@@ -4810,7 +4810,7 @@ var init_Stack = __esm({
       };
       const isHorizontal = direction === "horizontal";
       const directionClass = responsive && isHorizontal ? reverse ? "flex-col-reverse md:flex-row-reverse" : "flex-col md:flex-row" : isHorizontal ? reverse ? "flex-row-reverse" : "flex-row" : reverse ? "flex-col-reverse" : "flex-col";
-      return React106__default.createElement(
+      return React107__default.createElement(
         Component,
         {
           className: cn(
@@ -5010,7 +5010,7 @@ var Aside;
 var init_Aside = __esm({
   "components/core/atoms/Aside.tsx"() {
     init_cn();
-    Aside = React106__default.forwardRef(
+    Aside = React107__default.forwardRef(
       ({ className, children, ...rest }, ref) => /* @__PURE__ */ jsx("aside", { ref, className: cn(className), ...rest, children })
     );
     Aside.displayName = "Aside";
@@ -5089,9 +5089,9 @@ var init_LawReferenceTooltip = __esm({
       className
     }) => {
       const { t } = useTranslate();
-      const [isVisible, setIsVisible] = React106__default.useState(false);
-      const timeoutRef = React106__default.useRef(null);
-      const triggerRef = React106__default.useRef(null);
+      const [isVisible, setIsVisible] = React107__default.useState(false);
+      const timeoutRef = React107__default.useRef(null);
+      const triggerRef = React107__default.useRef(null);
       const handleMouseEnter = () => {
         if (timeoutRef.current) clearTimeout(timeoutRef.current);
         timeoutRef.current = setTimeout(() => setIsVisible(true), 200);
@@ -5102,7 +5102,7 @@ var init_LawReferenceTooltip = __esm({
       };
       const { revealed, triggerProps } = useTapReveal({ refs: [triggerRef] });
       const open = isVisible || revealed;
-      React106__default.useEffect(() => {
+      React107__default.useEffect(() => {
         return () => {
           if (timeoutRef.current) clearTimeout(timeoutRef.current);
         };
@@ -5312,7 +5312,7 @@ var init_StatusDot = __esm({
       md: "w-2.5 h-2.5",
       lg: "w-3 h-3"
     };
-    StatusDot = React106__default.forwardRef(
+    StatusDot = React107__default.forwardRef(
       ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
         return /* @__PURE__ */ jsx(
           "span",
@@ -5366,7 +5366,7 @@ var init_TrendIndicator = __esm({
       down: "trending-down",
       flat: "arrow-right"
     };
-    TrendIndicator = React106__default.forwardRef(
+    TrendIndicator = React107__default.forwardRef(
       ({
         className,
         value,
@@ -5433,7 +5433,7 @@ var init_RangeSlider = __esm({
       md: "w-4 h-4",
       lg: "w-5 h-5"
     };
-    RangeSlider = React106__default.forwardRef(
+    RangeSlider = React107__default.forwardRef(
       ({
         className,
         min = 0,
@@ -5939,7 +5939,7 @@ var init_ContentSection = __esm({
       md: "py-16",
       lg: "py-24"
     };
-    ContentSection = React106__default.forwardRef(
+    ContentSection = React107__default.forwardRef(
       ({ children, background = "default", padding = "lg", id, className }, ref) => {
         return /* @__PURE__ */ jsx(
           Box,
@@ -6473,7 +6473,7 @@ var init_AnimatedReveal = __esm({
       "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
       "none": {}
     };
-    AnimatedReveal = React106__default.forwardRef(
+    AnimatedReveal = React107__default.forwardRef(
       ({
         trigger = "scroll",
         animation = "fade-up",
@@ -6633,7 +6633,7 @@ var init_AnimatedGraphic = __esm({
   "components/marketing/atoms/AnimatedGraphic.tsx"() {
     "use client";
     init_cn();
-    AnimatedGraphic = React106__default.forwardRef(
+    AnimatedGraphic = React107__default.forwardRef(
       ({
         src,
         svgContent,
@@ -6656,7 +6656,7 @@ var init_AnimatedGraphic = __esm({
         const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
         const resolvedSvg = svgContent ?? fetchedSvg;
         const prevAnimateRef = useRef(animate);
-        const setRef = React106__default.useCallback(
+        const setRef = React107__default.useCallback(
           (node) => {
             containerRef.current = node;
             if (typeof ref === "function") ref(node);
@@ -8276,7 +8276,7 @@ function GameCard({
   className
 }) {
   const eventBus = useEventBus();
-  const handleClick = React106.useCallback(() => {
+  const handleClick = React107.useCallback(() => {
     if (disabled) return;
     onClick?.(id);
     if (clickEvent) eventBus.emit(`UI:${clickEvent}`, { cardId: id });
@@ -8548,9 +8548,9 @@ function ControlButton({
   className
 }) {
   const eventBus = useEventBus();
-  const [isPressed, setIsPressed] = React106.useState(false);
+  const [isPressed, setIsPressed] = React107.useState(false);
   const actualPressed = pressed ?? isPressed;
-  const handlePointerDown = React106.useCallback(
+  const handlePointerDown = React107.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -8560,7 +8560,7 @@ function ControlButton({
     },
     [disabled, pressEvent, eventBus, onPress]
   );
-  const handlePointerUp = React106.useCallback(
+  const handlePointerUp = React107.useCallback(
     (e) => {
       e.preventDefault();
       if (disabled) return;
@@ -8570,7 +8570,7 @@ function ControlButton({
     },
     [disabled, releaseEvent, eventBus, onRelease]
   );
-  const handlePointerLeave = React106.useCallback(
+  const handlePointerLeave = React107.useCallback(
     (e) => {
       if (isPressed) {
         setIsPressed(false);
@@ -9629,8 +9629,8 @@ function MiniMap({
   viewportRect = DEFAULT_VIEWPORT,
   className
 }) {
-  const canvasRef = React106.useRef(null);
-  React106.useEffect(() => {
+  const canvasRef = React107.useRef(null);
+  React107.useEffect(() => {
     const canvas = canvasRef.current;
     if (!canvas) return;
     const ctx = canvas.getContext("2d");
@@ -9780,8 +9780,8 @@ function ControlGrid({
   className
 }) {
   const eventBus = useEventBus();
-  const [active, setActive] = React106.useState(/* @__PURE__ */ new Set());
-  const handlePress = React106.useCallback(
+  const [active, setActive] = React107.useState(/* @__PURE__ */ new Set());
+  const handlePress = React107.useCallback(
     (id) => {
       setActive((prev) => new Set(prev).add(id));
       if (actionEvent) eventBus.emit(`UI:${actionEvent}`, { id, pressed: true });
@@ -9793,7 +9793,7 @@ function ControlGrid({
     },
     [kind, actionEvent, directionEvent, eventBus, onAction, onDirection]
   );
-  const handleRelease = React106.useCallback(
+  const handleRelease = React107.useCallback(
     (id) => {
       setActive((prev) => {
         const next = new Set(prev);
@@ -10054,7 +10054,7 @@ function InventoryGrid({
   const eventBus = useEventBus();
   const slotCount = totalSlots ?? items.length;
   const emptySlotCount = Math.max(0, slotCount - items.length);
-  const handleSelect = React106.useCallback(
+  const handleSelect = React107.useCallback(
     (id) => {
       onSelect?.(id);
       if (selectEvent) {
@@ -10257,7 +10257,7 @@ function GameMenu({
   } catch {
   }
   const eventBus = eventBusProp || eventBusFromHook;
-  const handleOptionClick = React106.useCallback(
+  const handleOptionClick = React107.useCallback(
     (option) => {
       if (option.event && eventBus) {
         eventBus.emit(`UI:${option.event}`, { option });
@@ -12100,6 +12100,329 @@ var init_useCanvasEffects = __esm({
     "use client";
   }
 });
+function pickPath(entry) {
+  if (Array.isArray(entry.path)) {
+    return entry.path[Math.floor(Math.random() * entry.path.length)];
+  }
+  return entry.path;
+}
+function useGameAudio({
+  manifest,
+  baseUrl = "",
+  initialMuted = false,
+  initialVolume = 1
+}) {
+  const [muted, setMutedState] = useState(initialMuted);
+  const [masterVolume, setMasterVolumeState] = useState(initialVolume);
+  const mutedRef = useRef(muted);
+  const volumeRef = useRef(masterVolume);
+  const manifestRef = useRef(manifest);
+  mutedRef.current = muted;
+  volumeRef.current = masterVolume;
+  manifestRef.current = manifest;
+  const poolsRef = useRef(/* @__PURE__ */ new Map());
+  const getOrCreateElement = useCallback((key) => {
+    const entry = manifestRef.current[key];
+    if (!entry) return null;
+    let pool = poolsRef.current.get(key);
+    if (!pool) {
+      pool = [];
+      poolsRef.current.set(key, pool);
+    }
+    const maxSize = entry.poolSize ?? 1;
+    for (const audio of pool) {
+      if (audio.paused && (audio.ended || audio.currentTime === 0)) {
+        return audio;
+      }
+    }
+    if (pool.length < maxSize) {
+      const src = baseUrl + pickPath(entry);
+      const audio = new Audio(src);
+      audio.loop = entry.loop ?? false;
+      pool.push(audio);
+      return audio;
+    }
+    if (!entry.loop) {
+      let oldest = pool[0];
+      for (const audio of pool) {
+        if (audio.currentTime > oldest.currentTime) {
+          oldest = audio;
+        }
+      }
+      oldest.pause();
+      oldest.currentTime = 0;
+      return oldest;
+    }
+    return null;
+  }, [baseUrl]);
+  const play = useCallback((key) => {
+    if (mutedRef.current) return;
+    const entry = manifestRef.current[key];
+    if (!entry) return;
+    const audio = getOrCreateElement(key);
+    if (!audio) return;
+    audio.volume = Math.min(1, (entry.volume ?? 1) * volumeRef.current);
+    if (!entry.loop) {
+      audio.currentTime = 0;
+    }
+    const promise = audio.play();
+    if (promise) {
+      promise.catch(() => {
+      });
+    }
+  }, [getOrCreateElement]);
+  const stop = useCallback((key) => {
+    const pool = poolsRef.current.get(key);
+    if (!pool) return;
+    for (const audio of pool) {
+      audio.pause();
+      audio.currentTime = 0;
+    }
+  }, []);
+  const currentMusicKeyRef = useRef(null);
+  const currentMusicElRef = useRef(null);
+  const musicFadeRef = useRef(null);
+  const pendingMusicKeyRef = useRef(null);
+  const clearMusicFade = useCallback(() => {
+    if (musicFadeRef.current) {
+      clearInterval(musicFadeRef.current);
+      musicFadeRef.current = null;
+    }
+  }, []);
+  const playMusic = useCallback((key) => {
+    if (key === currentMusicKeyRef.current) return;
+    pendingMusicKeyRef.current = key;
+    const entry = manifestRef.current[key];
+    if (!entry) return;
+    const fadeDurationMs = entry.crossfadeDurationMs ?? 1500;
+    const stepMs = 50;
+    const totalSteps = Math.max(1, fadeDurationMs / stepMs);
+    const targetVolume = Math.min(1, (entry.volume ?? 1) * volumeRef.current);
+    clearMusicFade();
+    const src = baseUrl + (Array.isArray(entry.path) ? entry.path[0] : entry.path);
+    const incoming = new Audio(src);
+    incoming.loop = true;
+    incoming.volume = 0;
+    const outgoing = currentMusicElRef.current;
+    const outgoingStartVol = outgoing?.volume ?? 0;
+    currentMusicKeyRef.current = key;
+    currentMusicElRef.current = incoming;
+    if (!mutedRef.current) {
+      incoming.play().catch(() => {
+        currentMusicKeyRef.current = null;
+        currentMusicElRef.current = outgoing;
+      });
+    }
+    let step = 0;
+    musicFadeRef.current = setInterval(() => {
+      step++;
+      const progress = Math.min(step / totalSteps, 1);
+      incoming.volume = Math.min(1, targetVolume * progress);
+      if (outgoing) {
+        outgoing.volume = Math.max(0, outgoingStartVol * (1 - progress));
+      }
+      if (progress >= 1) {
+        clearMusicFade();
+        if (outgoing) {
+          outgoing.pause();
+          outgoing.src = "";
+        }
+      }
+    }, stepMs);
+  }, [baseUrl, clearMusicFade]);
+  const stopMusic = useCallback((fadeDurationMs = 1e3) => {
+    const outgoing = currentMusicElRef.current;
+    if (!outgoing) return;
+    currentMusicKeyRef.current = null;
+    currentMusicElRef.current = null;
+    pendingMusicKeyRef.current = null;
+    clearMusicFade();
+    const startVolume = outgoing.volume;
+    const stepMs = 50;
+    const totalSteps = Math.max(1, fadeDurationMs / stepMs);
+    let step = 0;
+    musicFadeRef.current = setInterval(() => {
+      step++;
+      const progress = step / totalSteps;
+      outgoing.volume = Math.max(0, startVolume * (1 - progress));
+      if (progress >= 1) {
+        clearMusicFade();
+        outgoing.pause();
+        outgoing.src = "";
+      }
+    }, stepMs);
+  }, [clearMusicFade]);
+  const stopAll = useCallback(() => {
+    for (const pool of poolsRef.current.values()) {
+      for (const audio of pool) {
+        audio.pause();
+        audio.currentTime = 0;
+      }
+    }
+    stopMusic(0);
+  }, [stopMusic]);
+  const setMuted = useCallback((value) => {
+    setMutedState(value);
+    if (value) {
+      for (const [key, pool] of poolsRef.current.entries()) {
+        if (manifestRef.current[key]?.loop) {
+          for (const audio of pool) {
+            if (!audio.paused) audio.pause();
+          }
+        }
+      }
+      currentMusicElRef.current?.pause();
+    } else {
+      for (const [key, pool] of poolsRef.current.entries()) {
+        const entry = manifestRef.current[key];
+        if (entry?.loop && entry?.autostart) {
+          for (const audio of pool) {
+            if (audio.paused) audio.play().catch(() => {
+            });
+          }
+        }
+      }
+      const musicEl = currentMusicElRef.current;
+      if (musicEl) {
+        musicEl.play().catch(() => {
+        });
+      }
+    }
+  }, []);
+  const setMasterVolume = useCallback((volume) => {
+    const clamped = Math.max(0, Math.min(1, volume));
+    setMasterVolumeState(clamped);
+    for (const [key, pool] of poolsRef.current.entries()) {
+      const entryVol = manifestRef.current[key]?.volume ?? 1;
+      for (const audio of pool) {
+        audio.volume = Math.min(1, entryVol * clamped);
+      }
+    }
+    if (!musicFadeRef.current && currentMusicElRef.current) {
+      const key = currentMusicKeyRef.current;
+      const entryVol = key ? manifestRef.current[key]?.volume ?? 1 : 1;
+      currentMusicElRef.current.volume = Math.min(1, entryVol * clamped);
+    }
+  }, []);
+  const unlockedRef = useRef(false);
+  useEffect(() => {
+    const autoKeys = Object.keys(manifest).filter((k) => manifest[k].autostart);
+    const hasPendingMusic = () => pendingMusicKeyRef.current !== null;
+    const hasAutoStart = autoKeys.length > 0;
+    if (!hasAutoStart && !hasPendingMusic()) return;
+    const unlock = () => {
+      if (unlockedRef.current) return;
+      unlockedRef.current = true;
+      if (!mutedRef.current) {
+        for (const key of autoKeys) {
+          play(key);
+        }
+        const pending = pendingMusicKeyRef.current;
+        if (pending && pending !== currentMusicKeyRef.current) {
+          playMusic(pending);
+        }
+      }
+    };
+    document.addEventListener("click", unlock, { once: true });
+    document.addEventListener("keydown", unlock, { once: true });
+    document.addEventListener("touchstart", unlock, { once: true });
+    return () => {
+      document.removeEventListener("click", unlock);
+      document.removeEventListener("keydown", unlock);
+      document.removeEventListener("touchstart", unlock);
+    };
+  }, [manifest, play, playMusic]);
+  useEffect(() => {
+    return () => {
+      clearMusicFade();
+      for (const pool of poolsRef.current.values()) {
+        for (const audio of pool) {
+          audio.pause();
+          audio.src = "";
+        }
+      }
+      poolsRef.current.clear();
+      if (currentMusicElRef.current) {
+        currentMusicElRef.current.pause();
+        currentMusicElRef.current.src = "";
+        currentMusicElRef.current = null;
+      }
+    };
+  }, [clearMusicFade]);
+  return {
+    play,
+    stop,
+    stopAll,
+    playMusic,
+    stopMusic,
+    muted,
+    setMuted,
+    masterVolume,
+    setMasterVolume
+  };
+}
+var init_useGameAudio = __esm({
+  "components/game/shared/hooks/useGameAudio.ts"() {
+    "use client";
+    useGameAudio.displayName = "useGameAudio";
+  }
+});
+function useGameAudioContextOptional() {
+  return useContext(GameAudioContext);
+}
+function GameAudioProvider({
+  manifest,
+  baseUrl = "",
+  children,
+  initialMuted = false
+}) {
+  const eventBus = useEventBus();
+  const { play, stop, stopAll, playMusic, stopMusic, muted, setMuted, masterVolume, setMasterVolume } = useGameAudio({ manifest, baseUrl, initialMuted });
+  useEffect(() => {
+    const unsubPlay = eventBus.on("UI:PLAY_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) play(key);
+    });
+    const unsubStop = eventBus.on("UI:STOP_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        stop(key);
+      } else {
+        stopAll();
+      }
+    });
+    const unsubChangeMusic = eventBus.on("UI:CHANGE_MUSIC", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        playMusic(key);
+      } else {
+        stopMusic();
+      }
+    });
+    const unsubStopMusic = eventBus.on("UI:STOP_MUSIC", () => {
+      stopMusic();
+    });
+    return () => {
+      unsubPlay();
+      unsubStop();
+      unsubChangeMusic();
+      unsubStopMusic();
+    };
+  }, [eventBus, play, stop, stopAll, playMusic, stopMusic]);
+  const value = { muted, setMuted, masterVolume, setMasterVolume, play, playMusic, stopMusic };
+  return /* @__PURE__ */ jsx(GameAudioContext.Provider, { value, children });
+}
+var GameAudioContext;
+var init_GameAudioProvider = __esm({
+  "components/game/shared/providers/GameAudioProvider.tsx"() {
+    "use client";
+    init_useEventBus();
+    init_useGameAudio();
+    GameAudioContext = createContext(null);
+    GameAudioContext.displayName = "GameAudioContext";
+    GameAudioProvider.displayName = "GameAudioProvider";
+  }
+});
 function GameAudioToggle({
   size = "sm",
   className
@@ -12128,6 +12451,7 @@ var init_GameAudioToggle = __esm({
     "use client";
     init_atoms();
     init_cn();
+    init_GameAudioProvider();
     GameAudioToggle.displayName = "GameAudioToggle";
   }
 });
@@ -15795,7 +16119,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(React106__default.Fragment, { children: [
+      return /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
         i > 0 && /* @__PURE__ */ jsx(
           Typography,
           {
@@ -16323,7 +16647,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(React106__default.Fragment, { children: [
+  return /* @__PURE__ */ jsx(HStack, { className: cn("items-center", className), gap: "sm", children: paddedSlots.map((slot, i) => /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
     i > 0 && /* @__PURE__ */ jsx(
       Typography,
       {
@@ -18750,10 +19074,10 @@ function getSlotContentRenderer2() {
 }
 function resolveDescriptor(value, idPrefix) {
   if (value === null || value === void 0) return value;
-  if (React106__default.isValidElement(value)) return value;
+  if (React107__default.isValidElement(value)) return value;
   if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
   if (Array.isArray(value)) {
-    return value.map((item, i) => /* @__PURE__ */ jsx(React106__default.Fragment, { children: resolveDescriptor(item, `${idPrefix}-${i}`) }, i));
+    return value.map((item, i) => /* @__PURE__ */ jsx(React107__default.Fragment, { children: resolveDescriptor(item, `${idPrefix}-${i}`) }, i));
   }
   if (typeof value === "object") {
     const rec = value;
@@ -18889,7 +19213,7 @@ var init_GameTemplate = __esm({
   }
 });
 function asDescriptor(v) {
-  if (Array.isArray(v) || React106__default.isValidElement(v)) return null;
+  if (Array.isArray(v) || React107__default.isValidElement(v)) return null;
   const o = v;
   if (typeof o.type !== "string") return null;
   const props = o.props !== void 0 && typeof o.props === "object" && !Array.isArray(o.props) && o.props !== null ? o.props : void 0;
@@ -18904,10 +19228,10 @@ function getSlotContentRenderer3() {
 }
 function resolveDescriptor2(value, idPrefix) {
   if (value === null || value === void 0) return value;
-  if (React106__default.isValidElement(value)) return value;
+  if (React107__default.isValidElement(value)) return value;
   if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return value;
   if (Array.isArray(value)) {
-    return value.map((item, i) => /* @__PURE__ */ jsx(React106__default.Fragment, { children: resolveDescriptor2(item, `${idPrefix}-${i}`) }, i));
+    return value.map((item, i) => /* @__PURE__ */ jsx(React107__default.Fragment, { children: resolveDescriptor2(item, `${idPrefix}-${i}`) }, i));
   }
   if (typeof value === "object" && value !== null) {
     const desc = asDescriptor(value);
@@ -19791,6 +20115,8 @@ var init_CardBattlerTemplate = __esm({
     CardBattlerTemplate.displayName = "CardBattlerTemplate";
   }
 });
+
+// components/game/2d/molecules/index.ts
 var init_molecules = __esm({
   "components/game/2d/molecules/index.ts"() {
     init_shared();
@@ -19885,7 +20211,7 @@ var init_ErrorBoundary = __esm({
         }
       );
     };
-    ErrorBoundary = class extends React106__default.Component {
+    ErrorBoundary = class extends React107__default.Component {
       constructor(props) {
         super(props);
         __publicField(this, "reset", () => {
@@ -20550,7 +20876,7 @@ var init_Container = __esm({
       as: Component = "div"
     }) => {
       const resolvedSize = maxWidth ?? size ?? "lg";
-      return React106__default.createElement(
+      return React107__default.createElement(
         Component,
         {
           className: cn(
@@ -23158,7 +23484,7 @@ var init_CodeBlock = __esm({
     };
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
-    CodeBlock = React106__default.memo(
+    CodeBlock = React107__default.memo(
       ({
         code: rawCode,
         language = "text",
@@ -23745,7 +24071,7 @@ var init_MarkdownContent = __esm({
     init_Box();
     init_CodeBlock();
     init_cn();
-    MarkdownContent = React106__default.memo(
+    MarkdownContent = React107__default.memo(
       ({ content, direction = "ltr", className }) => {
         const { t: _t } = useTranslate();
         const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -25072,7 +25398,7 @@ var init_StateMachineView = __esm({
                 style: { top: title ? 30 : 0 },
                 children: [
                   entity && /* @__PURE__ */ jsx(EntityBox, { entity, config }),
-                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React106__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
+                  states.map((state) => renderStateNode ? /* @__PURE__ */ jsx(React107__default.Fragment, { children: renderStateNode(state, config) }, state.id) : /* @__PURE__ */ jsx(
                     StateNode2,
                     {
                       state,
@@ -30701,8 +31027,8 @@ var init_Menu = __esm({
         "bottom-end": "bottom-start"
       };
       const effectivePosition = direction === "rtl" ? rtlMirror[position] ?? position : position;
-      const triggerChild = React106__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
-      const triggerElement = React106__default.cloneElement(
+      const triggerChild = React107__default.isValidElement(trigger) ? trigger : /* @__PURE__ */ jsx(Typography, { variant: "small", as: "span", children: trigger });
+      const triggerElement = React107__default.cloneElement(
         triggerChild,
         {
           ref: triggerRef,
@@ -30797,14 +31123,14 @@ function useDataDnd(args) {
   const isZone = Boolean(dragGroup || accepts || sortable);
   const enabled = isZone || Boolean(dndRoot);
   const eventBus = useEventBus();
-  const parentRoot = React106__default.useContext(RootCtx);
+  const parentRoot = React107__default.useContext(RootCtx);
   const isRoot = enabled && parentRoot === null;
-  const zoneId = React106__default.useId();
+  const zoneId = React107__default.useId();
   const ownGroup = dragGroup ?? accepts ?? zoneId;
-  const [optimisticOrders, setOptimisticOrders] = React106__default.useState(() => /* @__PURE__ */ new Map());
-  const optimisticOrdersRef = React106__default.useRef(optimisticOrders);
+  const [optimisticOrders, setOptimisticOrders] = React107__default.useState(() => /* @__PURE__ */ new Map());
+  const optimisticOrdersRef = React107__default.useRef(optimisticOrders);
   optimisticOrdersRef.current = optimisticOrders;
-  const clearOptimisticOrder = React106__default.useCallback((group) => {
+  const clearOptimisticOrder = React107__default.useCallback((group) => {
     setOptimisticOrders((prev) => {
       if (!prev.has(group)) return prev;
       const next = new Map(prev);
@@ -30829,7 +31155,7 @@ function useDataDnd(args) {
     const raw = it[dndItemIdField];
     return raw != null ? String(raw) : `__idx_${idx}`;
   }).join("|");
-  const itemIds = React106__default.useMemo(
+  const itemIds = React107__default.useMemo(
     () => orderedItems.map((it, idx) => {
       const raw = it[dndItemIdField];
       return raw != null ? String(raw) : `__idx_${idx}`;
@@ -30840,7 +31166,7 @@ function useDataDnd(args) {
     const raw = it[dndItemIdField];
     return raw != null ? String(raw) : `__${idx}`;
   }).join("|");
-  React106__default.useEffect(() => {
+  React107__default.useEffect(() => {
     const root = isRoot ? null : parentRoot;
     if (root) {
       root.clearOptimisticOrder(ownGroup);
@@ -30848,20 +31174,20 @@ function useDataDnd(args) {
       clearOptimisticOrder(ownGroup);
     }
   }, [itemsContentSig, ownGroup]);
-  const zonesRef = React106__default.useRef(/* @__PURE__ */ new Map());
-  const registerZone = React106__default.useCallback((zoneId2, meta2) => {
+  const zonesRef = React107__default.useRef(/* @__PURE__ */ new Map());
+  const registerZone = React107__default.useCallback((zoneId2, meta2) => {
     zonesRef.current.set(zoneId2, meta2);
   }, []);
-  const unregisterZone = React106__default.useCallback((zoneId2) => {
+  const unregisterZone = React107__default.useCallback((zoneId2) => {
     zonesRef.current.delete(zoneId2);
   }, []);
-  const [activeDrag, setActiveDrag] = React106__default.useState(null);
-  const [overZoneGroup, setOverZoneGroup] = React106__default.useState(null);
-  const meta = React106__default.useMemo(
+  const [activeDrag, setActiveDrag] = React107__default.useState(null);
+  const [overZoneGroup, setOverZoneGroup] = React107__default.useState(null);
+  const meta = React107__default.useMemo(
     () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
     [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
-  React106__default.useEffect(() => {
+  React107__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
     if (!target) {
       zonesRef.current.set(zoneId, meta);
@@ -30880,7 +31206,7 @@ function useDataDnd(args) {
   }, [parentRoot, isRoot, zoneId, meta]);
   const sensors = useAlmadarDndSensors(true);
   const collisionDetection = almadarDndCollisionDetection;
-  const findZoneByItem = React106__default.useCallback(
+  const findZoneByItem = React107__default.useCallback(
     (id) => {
       for (const z of zonesRef.current.values()) {
         if (z.itemIds.includes(id)) return z;
@@ -30889,7 +31215,7 @@ function useDataDnd(args) {
     },
     []
   );
-  React106__default.useCallback(
+  React107__default.useCallback(
     (group) => {
       for (const z of zonesRef.current.values()) {
         if (z.group === group) return z;
@@ -30898,7 +31224,7 @@ function useDataDnd(args) {
     },
     []
   );
-  const handleDragEnd = React106__default.useCallback(
+  const handleDragEnd = React107__default.useCallback(
     (event) => {
       const { active, over } = event;
       const activeIdStr = String(active.id);
@@ -30989,8 +31315,8 @@ function useDataDnd(args) {
     },
     [eventBus]
   );
-  const sortableData = React106__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
-  const SortableItem = React106__default.useCallback(
+  const sortableData = React107__default.useMemo(() => ({ dndGroup: ownGroup }), [ownGroup]);
+  const SortableItem = React107__default.useCallback(
     ({ id, children }) => {
       const {
         attributes,
@@ -31030,7 +31356,7 @@ function useDataDnd(args) {
       id: droppableId,
       data: sortableData
     });
-    const ctx = React106__default.useContext(RootCtx);
+    const ctx = React107__default.useContext(RootCtx);
     const activeDrag2 = ctx?.activeDrag ?? null;
     const overZoneGroup2 = ctx?.overZoneGroup ?? null;
     const isThisZoneOver = overZoneGroup2 === ownGroup;
@@ -31045,7 +31371,7 @@ function useDataDnd(args) {
       showForeignPlaceholder,
       ctxAvailable: ctx != null
     });
-    React106__default.useEffect(() => {
+    React107__default.useEffect(() => {
       dndLog.info("dropzone:isOver:change", { droppableId, group: ownGroup, isOver, isThisZoneOver, showForeignPlaceholder, activeDragSourceGroup: activeDrag2?.sourceGroup ?? null });
     }, [droppableId, isOver, isThisZoneOver, showForeignPlaceholder]);
     return /* @__PURE__ */ jsx(
@@ -31059,11 +31385,11 @@ function useDataDnd(args) {
       }
     );
   };
-  const rootContextValue = React106__default.useMemo(
+  const rootContextValue = React107__default.useMemo(
     () => ({ registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder }),
     [registerZone, unregisterZone, activeDrag, overZoneGroup, optimisticOrders, clearOptimisticOrder]
   );
-  const handleDragStart = React106__default.useCallback((event) => {
+  const handleDragStart = React107__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;
@@ -31082,7 +31408,7 @@ function useDataDnd(args) {
       isRoot
     });
   }, [findZoneByItem, isRoot, zoneId]);
-  const handleDragOver = React106__default.useCallback((event) => {
+  const handleDragOver = React107__default.useCallback((event) => {
     const { active, over } = event;
     const overData = over?.data?.current;
     const overGroup = overData?.dndGroup ?? null;
@@ -31152,7 +31478,7 @@ function useDataDnd(args) {
       return next;
     });
   }, []);
-  const handleDragCancel = React106__default.useCallback((event) => {
+  const handleDragCancel = React107__default.useCallback((event) => {
     setActiveDrag(null);
     setOverZoneGroup(null);
     dndLog.warn("dragCancel", {
@@ -31160,12 +31486,12 @@ function useDataDnd(args) {
       reason: "dnd-kit cancelled the drag (escape key, pointer interrupted, or external)"
     });
   }, []);
-  const handleDragEndWithCleanup = React106__default.useCallback((event) => {
+  const handleDragEndWithCleanup = React107__default.useCallback((event) => {
     handleDragEnd(event);
     setActiveDrag(null);
     setOverZoneGroup(null);
   }, [handleDragEnd]);
-  const wrapContainer = React106__default.useCallback(
+  const wrapContainer = React107__default.useCallback(
     (children) => {
       if (!enabled) return children;
       const strategy = layout === "grid" ? rectSortingStrategy : verticalListSortingStrategy;
@@ -31219,7 +31545,7 @@ var init_useDataDnd = __esm({
     init_useAlmadarDndCollision();
     init_Box();
     dndLog = createLogger("almadar:ui:dnd");
-    RootCtx = React106__default.createContext(null);
+    RootCtx = React107__default.createContext(null);
   }
 });
 function renderIconInput(icon, props) {
@@ -31745,7 +32071,7 @@ function DataList({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React106__default.useState(pageSize || Infinity);
+  const [visibleCount, setVisibleCount] = React107__default.useState(pageSize || Infinity);
   const fieldDefs = fields ?? columns ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -31764,7 +32090,7 @@ function DataList({
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
   const hasRenderProp = typeof children === "function";
-  React106__default.useEffect(() => {
+  React107__default.useEffect(() => {
     const renderItemTypeOf = typeof schemaRenderItem;
     const childrenTypeOf = typeof children;
     if (data.length > 0 && !hasRenderProp) {
@@ -31868,7 +32194,7 @@ function DataList({
     const items2 = [...data];
     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(React106__default.Fragment, { children: [
+    return /* @__PURE__ */ jsx(VStack, { gap: "sm", className: cn("py-2", className), children: groups2.map((group, gi) => /* @__PURE__ */ jsxs(React107__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}`;
@@ -32009,7 +32335,7 @@ function DataList({
           className
         ),
         children: [
-          groups.map((group, gi) => /* @__PURE__ */ jsxs(React106__default.Fragment, { children: [
+          groups.map((group, gi) => /* @__PURE__ */ jsxs(React107__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)
@@ -32802,7 +33128,7 @@ var init_Flex = __esm({
           flexStyle.flexBasis = typeof basis === "number" ? `${basis}px` : basis;
         }
       }
-      return React106__default.createElement(Component, {
+      return React107__default.createElement(Component, {
         className: cn(
           inline ? "inline-flex" : "flex",
           directionStyles[direction],
@@ -32921,7 +33247,7 @@ var init_Grid = __esm({
       as: Component = "div"
     }) => {
       const mergedStyle = rows2 ? { gridTemplateRows: `repeat(${rows2}, minmax(0, 1fr))`, ...style } : style;
-      return React106__default.createElement(
+      return React107__default.createElement(
         Component,
         {
           className: cn(
@@ -33117,9 +33443,9 @@ var init_Popover = __esm({
         onMouseLeave: handleClose,
         onPointerDown: tapTriggerProps.onPointerDown
       };
-      const childElement = React106__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const childElement = React107__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
       const childPointerDown = childElement.props.onPointerDown;
-      const triggerElement = React106__default.cloneElement(
+      const triggerElement = React107__default.cloneElement(
         childElement,
         {
           ref: triggerRef,
@@ -33721,9 +34047,9 @@ var init_Tooltip = __esm({
           if (hideTimeoutRef.current) clearTimeout(hideTimeoutRef.current);
         };
       }, []);
-      const triggerElement = React106__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
+      const triggerElement = React107__default.isValidElement(children) ? children : /* @__PURE__ */ jsx("span", { children });
       const childPointerDown = triggerElement.props.onPointerDown;
-      const trigger = React106__default.cloneElement(triggerElement, {
+      const trigger = React107__default.cloneElement(triggerElement, {
         ref: triggerRef,
         onMouseEnter: handleMouseEnter,
         onMouseLeave: handleMouseLeave,
@@ -33813,7 +34139,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(React106__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
               /* @__PURE__ */ jsx(
                 "button",
                 {
@@ -35145,13 +35471,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect72, useRef: useRef75, useCallback: useCallback114, useState: useState105 } = React106__default;
+      const { useEffect: useEffect75, useRef: useRef76, useCallback: useCallback117, useState: useState108 } = React107__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef75({ centerLat, centerLng, zoom });
-        useEffect72(() => {
+        const prevRef = useRef76({ centerLat, centerLng, zoom });
+        useEffect75(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -35162,7 +35488,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect72(() => {
+        useEffect75(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -35190,8 +35516,8 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState105(null);
-        const handleMapClick = useCallback114((lat, lng) => {
+        const [clickedPosition, setClickedPosition] = useState108(null);
+        const handleMapClick = useCallback117((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -35200,7 +35526,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback114((marker) => {
+        const handleMarkerClick = useCallback117((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -36060,8 +36386,8 @@ function TableView({
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [visibleCount, setVisibleCount] = React106__default.useState(pageSize > 0 ? pageSize : Infinity);
-  const [localSelected, setLocalSelected] = React106__default.useState(/* @__PURE__ */ new Set());
+  const [visibleCount, setVisibleCount] = React107__default.useState(pageSize > 0 ? pageSize : Infinity);
+  const [localSelected, setLocalSelected] = React107__default.useState(/* @__PURE__ */ new Set());
   const colDefs = columns ?? fields ?? [];
   const allDataRaw = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const dnd = useDataDnd({
@@ -36256,12 +36582,12 @@ function TableView({
         ]
       }
     );
-    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React106__default.Fragment, { children: rowInner }, id);
+    return dnd.isZone ? /* @__PURE__ */ jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsx(React107__default.Fragment, { children: rowInner }, id);
   };
   const items = Array.from(data);
   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(React106__default.Fragment, { children: [
+  const body = /* @__PURE__ */ jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxs(React107__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)) });
@@ -37618,7 +37944,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(React106__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(React107__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" })
@@ -37629,7 +37955,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(React106__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(React107__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 }),
@@ -38614,7 +38940,7 @@ var init_LikertScale = __esm({
       md: "text-base",
       lg: "text-lg"
     };
-    LikertScale = React106__default.forwardRef(
+    LikertScale = React107__default.forwardRef(
       ({
         question,
         options = DEFAULT_LIKERT_OPTIONS,
@@ -38626,7 +38952,7 @@ var init_LikertScale = __esm({
         variant = "radios",
         className
       }, ref) => {
-        const groupId = React106__default.useId();
+        const groupId = React107__default.useId();
         const eventBus = useEventBus();
         const handleSelect = useCallback(
           (next) => {
@@ -40908,7 +41234,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(React106__default.Fragment, { children: [
+            return /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
               idx > 0 && /* @__PURE__ */ jsx(
                 Icon,
                 {
@@ -41777,7 +42103,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 ?? void 0, s.isTerminal ?? void 0, tc, maxTC);
-          return /* @__PURE__ */ jsxs(React106__default.Fragment, { children: [
+          return /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
             /* @__PURE__ */ jsx(
               AvlState,
               {
@@ -41981,7 +42307,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(React106__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(React107__default.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: "/" }),
           crumb.href ? /* @__PURE__ */ jsx(
             "a",
@@ -42339,7 +42665,7 @@ var init_Section = __esm({
       as: Component = "section"
     }) => {
       const hasHeader = title || description || action;
-      return React106__default.createElement(
+      return React107__default.createElement(
         Component,
         {
           className: cn(
@@ -42705,7 +43031,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(React106__default.Fragment, { children: [
+              return /* @__PURE__ */ jsxs(React107__default.Fragment, { children: [
                 /* @__PURE__ */ jsx(
                   Button,
                   {
@@ -45138,7 +45464,7 @@ var init_DetailPanel = __esm({
   }
 });
 function extractTitle(children) {
-  if (!React106__default.isValidElement(children)) return void 0;
+  if (!React107__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -45484,12 +45810,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 = React106__default.useMemo(() => {
+      const normalizedInitialData = React107__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 = React106__default.useMemo(() => {
+      const entityDerivedFields = React107__default.useMemo(() => {
         if (fields && fields.length > 0) return void 0;
         if (!resolvedEntity) return void 0;
         return resolvedEntity.fields.map(
@@ -45510,16 +45836,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] = React106__default.useState(
+      const [formData, setFormData] = React107__default.useState(
         normalizedInitialData
       );
-      const [collapsedSections, setCollapsedSections] = React106__default.useState(
+      const [collapsedSections, setCollapsedSections] = React107__default.useState(
         /* @__PURE__ */ new Set()
       );
-      const [submitError, setSubmitError] = React106__default.useState(null);
-      const formRef = React106__default.useRef(null);
+      const [submitError, setSubmitError] = React107__default.useState(null);
+      const formRef = React107__default.useRef(null);
       const formMode = props.mode;
-      const mountedRef = React106__default.useRef(false);
+      const mountedRef = React107__default.useRef(false);
       if (!mountedRef.current) {
         mountedRef.current = true;
         debug("forms", "mount", {
@@ -45532,7 +45858,7 @@ var init_Form = __esm({
         });
       }
       const shouldShowCancel = showCancel ?? (fields && fields.length > 0);
-      const evalContext = React106__default.useMemo(
+      const evalContext = React107__default.useMemo(
         () => ({
           formValues: formData,
           globalVariables: externalContext?.globalVariables ?? {},
@@ -45541,7 +45867,7 @@ var init_Form = __esm({
         }),
         [formData, externalContext]
       );
-      React106__default.useEffect(() => {
+      React107__default.useEffect(() => {
         debug("forms", "initialData-sync", {
           mode: formMode,
           normalizedInitialData,
@@ -45552,7 +45878,7 @@ var init_Form = __esm({
           setFormData(normalizedInitialData);
         }
       }, [normalizedInitialData]);
-      const processCalculations = React106__default.useCallback(
+      const processCalculations = React107__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!hiddenCalculations.length) return;
           const context = {
@@ -45577,7 +45903,7 @@ var init_Form = __esm({
         },
         [hiddenCalculations, externalContext, eventBus]
       );
-      const checkViolations = React106__default.useCallback(
+      const checkViolations = React107__default.useCallback(
         (changedFieldId, newFormData) => {
           if (!violationTriggers.length) return;
           const context = {
@@ -45615,7 +45941,7 @@ var init_Form = __esm({
         processCalculations(name, newFormData);
         checkViolations(name, newFormData);
       };
-      const isFieldVisible = React106__default.useCallback(
+      const isFieldVisible = React107__default.useCallback(
         (fieldName) => {
           const condition = conditionalFields[fieldName];
           if (!condition) return true;
@@ -45623,7 +45949,7 @@ var init_Form = __esm({
         },
         [conditionalFields, evalContext]
       );
-      const isSectionVisible = React106__default.useCallback(
+      const isSectionVisible = React107__default.useCallback(
         (section) => {
           if (!section.condition) return true;
           return Boolean(evaluateFormExpression(section.condition, evalContext));
@@ -45699,7 +46025,7 @@ var init_Form = __esm({
           eventBus.emit(`UI:${onCancel}`);
         }
       };
-      const renderField = React106__default.useCallback(
+      const renderField = React107__default.useCallback(
         (field) => {
           const fieldName = field.name || field.field;
           if (!fieldName) return null;
@@ -45720,7 +46046,7 @@ var init_Form = __esm({
         [formData, isFieldVisible, relationsData, relationsLoading, isLoading]
       );
       const effectiveFields = entityDerivedFields ?? fields;
-      const normalizedFields = React106__default.useMemo(() => {
+      const normalizedFields = React107__default.useMemo(() => {
         if (!effectiveFields || effectiveFields.length === 0) return [];
         return effectiveFields.map((field) => {
           if (typeof field === "string") {
@@ -45744,7 +46070,7 @@ var init_Form = __esm({
           return field;
         });
       }, [effectiveFields, resolvedEntity]);
-      const schemaFields = React106__default.useMemo(() => {
+      const schemaFields = React107__default.useMemo(() => {
         if (normalizedFields.length === 0) return null;
         if (isDebugEnabled()) {
           debugGroup(`Form: ${entityName || "unknown"}`);
@@ -45754,7 +46080,7 @@ var init_Form = __esm({
         }
         return normalizedFields.map(renderField).filter(Boolean);
       }, [normalizedFields, renderField, entityName, conditionalFields]);
-      const sectionElements = React106__default.useMemo(() => {
+      const sectionElements = React107__default.useMemo(() => {
         if (!sections || sections.length === 0) return null;
         return sections.map((section) => {
           if (!isSectionVisible(section)) {
@@ -46479,7 +46805,7 @@ var init_List = __esm({
         if (entity && typeof entity === "object" && "id" in entity) return [entity];
         return [];
       }, [entity]);
-      const getItemActions = React106__default.useCallback(
+      const getItemActions = React107__default.useCallback(
         (item) => {
           if (!itemActions) return [];
           if (typeof itemActions === "function") {
@@ -46954,7 +47280,7 @@ var init_MediaGallery = __esm({
         [selectable, selectedItems, selectionEvent, eventBus]
       );
       const entityData = Array.isArray(entity) ? entity : [];
-      const items = React106__default.useMemo(() => {
+      const items = React107__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => {
@@ -47117,7 +47443,7 @@ var init_MediaGallery = __esm({
   }
 });
 function extractTitle2(children) {
-  if (!React106__default.isValidElement(children)) return void 0;
+  if (!React107__default.isValidElement(children)) return void 0;
   const props = children.props;
   if (typeof props.title === "string") {
     return props.title;
@@ -47368,7 +47694,7 @@ var init_debugRegistry = __esm({
   }
 });
 function useDebugData() {
-  const [data, setData] = React106.useState(() => ({
+  const [data, setData] = React107.useState(() => ({
     traits: [],
     ticks: [],
     guards: [],
@@ -47382,7 +47708,7 @@ function useDebugData() {
     },
     lastUpdate: Date.now()
   }));
-  React106.useEffect(() => {
+  React107.useEffect(() => {
     const updateData = () => {
       setData({
         traits: getAllTraits(),
@@ -47491,12 +47817,12 @@ function layoutGraph(states, transitions, initialState, width, height) {
   return positions;
 }
 function WalkMinimap() {
-  const [walkStep, setWalkStep] = React106.useState(null);
-  const [traits2, setTraits] = React106.useState([]);
-  const [coveredEdges, setCoveredEdges] = React106.useState([]);
-  const [completedTraits, setCompletedTraits] = React106.useState(/* @__PURE__ */ new Set());
-  const prevTraitRef = React106.useRef(null);
-  React106.useEffect(() => {
+  const [walkStep, setWalkStep] = React107.useState(null);
+  const [traits2, setTraits] = React107.useState([]);
+  const [coveredEdges, setCoveredEdges] = React107.useState([]);
+  const [completedTraits, setCompletedTraits] = React107.useState(/* @__PURE__ */ new Set());
+  const prevTraitRef = React107.useRef(null);
+  React107.useEffect(() => {
     const interval = setInterval(() => {
       const w = window;
       const step = w.__orbitalWalkStep;
@@ -47932,15 +48258,15 @@ var init_EntitiesTab = __esm({
 });
 function EventFlowTab({ events: events2 }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React106.useState("all");
-  const containerRef = React106.useRef(null);
-  const [autoScroll, setAutoScroll] = React106.useState(true);
-  React106.useEffect(() => {
+  const [filter, setFilter] = React107.useState("all");
+  const containerRef = React107.useRef(null);
+  const [autoScroll, setAutoScroll] = React107.useState(true);
+  React107.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
   }, [events2.length, autoScroll]);
-  const filteredEvents = React106.useMemo(() => {
+  const filteredEvents = React107.useMemo(() => {
     if (filter === "all") return events2;
     return events2.filter((e) => e.type === filter);
   }, [events2, filter]);
@@ -48056,7 +48382,7 @@ var init_EventFlowTab = __esm({
 });
 function GuardsPanel({ guards }) {
   const { t } = useTranslate();
-  const [filter, setFilter] = React106.useState("all");
+  const [filter, setFilter] = React107.useState("all");
   if (guards.length === 0) {
     return /* @__PURE__ */ jsx(
       EmptyState,
@@ -48069,7 +48395,7 @@ function GuardsPanel({ guards }) {
   }
   const passedCount = guards.filter((g) => g.result).length;
   const failedCount = guards.length - passedCount;
-  const filteredGuards = React106.useMemo(() => {
+  const filteredGuards = React107.useMemo(() => {
     if (filter === "all") return guards;
     if (filter === "passed") return guards.filter((g) => g.result);
     return guards.filter((g) => !g.result);
@@ -48232,10 +48558,10 @@ function EffectBadge({ effect }) {
 }
 function TransitionTimeline({ transitions }) {
   const { t } = useTranslate();
-  const containerRef = React106.useRef(null);
-  const [autoScroll, setAutoScroll] = React106.useState(true);
-  const [expandedId, setExpandedId] = React106.useState(null);
-  React106.useEffect(() => {
+  const containerRef = React107.useRef(null);
+  const [autoScroll, setAutoScroll] = React107.useState(true);
+  const [expandedId, setExpandedId] = React107.useState(null);
+  React107.useEffect(() => {
     if (autoScroll && containerRef.current) {
       containerRef.current.scrollTop = containerRef.current.scrollHeight;
     }
@@ -48515,9 +48841,9 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [log11, setLog] = React106.useState([]);
-  const prevStatesRef = React106.useRef(/* @__PURE__ */ new Map());
-  React106.useEffect(() => {
+  const [log13, setLog] = React107.useState([]);
+  const prevStatesRef = React107.useRef(/* @__PURE__ */ new Map());
+  React107.useEffect(() => {
     for (const trait of traits2) {
       const prev = prevStatesRef.current.get(trait.id);
       if (prev && prev !== trait.currentState) {
@@ -48579,9 +48905,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.otherEvents") }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log11.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log13.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.recentTransitions") }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log11.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log13.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -48686,10 +49012,10 @@ function VerifyModePanel({
   localCount
 }) {
   const { t } = useTranslate();
-  const [expanded, setExpanded] = React106.useState(true);
-  const scrollRef = React106.useRef(null);
-  const prevCountRef = React106.useRef(0);
-  React106.useEffect(() => {
+  const [expanded, setExpanded] = React107.useState(true);
+  const scrollRef = React107.useRef(null);
+  const prevCountRef = React107.useRef(0);
+  React107.useEffect(() => {
     if (expanded && transitions.length > prevCountRef.current && scrollRef.current) {
       scrollRef.current.scrollTop = scrollRef.current.scrollHeight;
     }
@@ -48746,10 +49072,10 @@ function RuntimeDebugger({
   schema
 }) {
   const { t } = useTranslate();
-  const [isCollapsed, setIsCollapsed] = React106.useState(mode === "verify" ? true : defaultCollapsed);
-  const [isVisible, setIsVisible] = React106.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
+  const [isCollapsed, setIsCollapsed] = React107.useState(mode === "verify" ? true : defaultCollapsed);
+  const [isVisible, setIsVisible] = React107.useState(mode === "inline" || mode === "verify" || isDebugEnabled2());
   const debugData = useDebugData();
-  React106.useEffect(() => {
+  React107.useEffect(() => {
     if (mode === "inline") return;
     return onDebugToggle((enabled) => {
       setIsVisible(enabled);
@@ -48758,7 +49084,7 @@ function RuntimeDebugger({
       }
     });
   }, [mode]);
-  React106.useEffect(() => {
+  React107.useEffect(() => {
     if (mode === "inline") return;
     const handleKeyDown = (e) => {
       if (e.key === "`" && isVisible) {
@@ -49278,7 +49604,7 @@ var init_StatCard = __esm({
       const labelToUse = propLabel ?? propTitle;
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const handleActionClick = React106__default.useCallback(() => {
+      const handleActionClick = React107__default.useCallback(() => {
         if (action?.event) {
           eventBus.emit(`UI:${action.event}`, {});
         }
@@ -49289,7 +49615,7 @@ var init_StatCard = __esm({
       const data = Array.isArray(entity) ? entity : entity ? [entity] : [];
       const isLoading = externalLoading ?? false;
       const error = externalError;
-      const computeMetricValue = React106__default.useCallback(
+      const computeMetricValue = React107__default.useCallback(
         (metric, items) => {
           if (metric.value !== void 0) {
             return metric.value;
@@ -49328,7 +49654,7 @@ var init_StatCard = __esm({
         },
         []
       );
-      const schemaStats = React106__default.useMemo(() => {
+      const schemaStats = React107__default.useMemo(() => {
         if (!metrics || metrics.length === 0) return null;
         return metrics.map((metric) => ({
           label: metric.label,
@@ -49336,7 +49662,7 @@ var init_StatCard = __esm({
           format: metric.format
         }));
       }, [metrics, data, computeMetricValue]);
-      const calculatedTrend = React106__default.useMemo(() => {
+      const calculatedTrend = React107__default.useMemo(() => {
         if (manualTrend !== void 0) return manualTrend;
         if (previousValue === void 0 || currentValue === void 0)
           return void 0;
@@ -49976,8 +50302,8 @@ var init_SubagentTracePanel = __esm({
       ] });
     };
     InlineActivityStream = ({ activities, autoScroll = true, className }) => {
-      const endRef = React106__default.useRef(null);
-      React106__default.useEffect(() => {
+      const endRef = React107__default.useRef(null);
+      React107__default.useEffect(() => {
         if (!autoScroll) return;
         endRef.current?.scrollIntoView({ behavior: "smooth", block: "end" });
       }, [activities.length, autoScroll]);
@@ -50071,7 +50397,7 @@ var init_SubagentTracePanel = __esm({
     };
     SubagentRichCard = ({ subagent }) => {
       const { t } = useTranslate();
-      const activities = React106__default.useMemo(
+      const activities = React107__default.useMemo(
         () => subagentMessagesToActivities(subagent.messages),
         [subagent.messages]
       );
@@ -50148,8 +50474,8 @@ var init_SubagentTracePanel = __esm({
       ] });
     };
     CoordinatorConversation = ({ messages, autoScroll = true, className }) => {
-      const endRef = React106__default.useRef(null);
-      React106__default.useEffect(() => {
+      const endRef = React107__default.useRef(null);
+      React107__default.useEffect(() => {
         if (!autoScroll) return;
         endRef.current?.scrollIntoView({ behavior: "smooth", block: "end" });
       }, [messages.length, autoScroll]);
@@ -50579,7 +50905,7 @@ var init_Timeline = __esm({
     }) => {
       const { t } = useTranslate();
       const entityData = entity ?? [];
-      const items = React106__default.useMemo(() => {
+      const items = React107__default.useMemo(() => {
         if (propItems) return propItems;
         if (entityData.length === 0) return [];
         return entityData.map((record, idx) => {
@@ -50681,7 +51007,7 @@ var init_Timeline = __esm({
   }
 });
 function extractToastProps(children) {
-  if (!React106__default.isValidElement(children)) {
+  if (!React107__default.isValidElement(children)) {
     if (typeof children === "string") {
       return { message: children };
     }
@@ -50719,7 +51045,7 @@ var init_ToastSlot = __esm({
         eventBus.emit("UI:CLOSE");
       };
       if (!isVisible) return null;
-      const isCustomContent = React106__default.isValidElement(children) && !message;
+      const isCustomContent = React107__default.isValidElement(children) && !message;
       return /* @__PURE__ */ jsx(Box, { className: "fixed bottom-4 right-4 z-50", children: isCustomContent ? children : /* @__PURE__ */ jsx(
         Toast,
         {
@@ -50735,9 +51061,33 @@ var init_ToastSlot = __esm({
     ToastSlot.displayName = "ToastSlot";
   }
 });
-
-// components/core/organisms/component-registry.generated.ts
-var COMPONENT_REGISTRY;
+function lazyThree(name, loader) {
+  const Lazy = React107__default.lazy(
+    () => loader().then((m) => {
+      const Resolved = m[name];
+      if (!Resolved) {
+        throw new Error(
+          `[@almadar/ui] 3D component "${name}" was not found in the three subpath bundle.`
+        );
+      }
+      return { default: Resolved };
+    })
+  );
+  function ThreeWrapper(props) {
+    return React107__default.createElement(
+      ThreeBoundary,
+      { name },
+      React107__default.createElement(
+        React107__default.Suspense,
+        { fallback: null },
+        React107__default.createElement(Lazy, props)
+      )
+    );
+  }
+  ThreeWrapper.displayName = `Lazy(${name})`;
+  return ThreeWrapper;
+}
+var ThreeBoundary, GameBoard3D, GameCanvas3D, GameCanvas3DBattleTemplate, GameCanvas3DCastleTemplate, GameCanvas3DWorldMapTemplate, COMPONENT_REGISTRY;
 var init_component_registry_generated = __esm({
   "components/core/organisms/component-registry.generated.ts"() {
     init_AboutPageTemplate();
@@ -50848,9 +51198,11 @@ var init_component_registry_generated = __esm({
     init_Form();
     init_FormField();
     init_FormSectionHeader();
+    init_GameAudioProvider();
     init_GameAudioToggle();
     init_GameCard();
     init_GameHud();
+    init_GameIcon();
     init_GameMenu();
     init_GameShell();
     init_GameTemplate();
@@ -51035,6 +51387,33 @@ var init_component_registry_generated = __esm({
     init_WizardProgress();
     init_WorldMapBoard();
     init_WorldMapTemplate();
+    ThreeBoundary = class extends React107__default.Component {
+      constructor() {
+        super(...arguments);
+        __publicField(this, "state", { failed: false });
+      }
+      static getDerivedStateFromError() {
+        return { failed: true };
+      }
+      render() {
+        if (this.state.failed) {
+          return React107__default.createElement(
+            "div",
+            {
+              "data-testid": "three-unavailable",
+              style: { padding: 16, fontSize: 13, lineHeight: 1.5, opacity: 0.7 }
+            },
+            `3D pattern "${this.props.name}" requires three.js. Install the optional peers three + @react-three/fiber + @react-three/drei (matching the host React major) to render it.`
+          );
+        }
+        return this.props.children;
+      }
+    };
+    GameBoard3D = lazyThree("GameBoard3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3D = lazyThree("GameCanvas3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DBattleTemplate = lazyThree("GameCanvas3DBattleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DCastleTemplate = lazyThree("GameCanvas3DCastleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DWorldMapTemplate = lazyThree("GameCanvas3DWorldMapTemplate", () => import('@almadar/ui/components/molecules/game/three'));
     COMPONENT_REGISTRY = {
       "AboutPageTemplate": AboutPageTemplate,
       "Accordion": Accordion,
@@ -51150,9 +51529,16 @@ var init_component_registry_generated = __esm({
       "Form": Form,
       "FormField": FormField,
       "FormSectionHeader": FormSectionHeader,
+      "GameAudioProvider": GameAudioProvider,
       "GameAudioToggle": GameAudioToggle,
+      "GameBoard3D": GameBoard3D,
+      "GameCanvas3D": GameCanvas3D,
+      "GameCanvas3DBattleTemplate": GameCanvas3DBattleTemplate,
+      "GameCanvas3DCastleTemplate": GameCanvas3DCastleTemplate,
+      "GameCanvas3DWorldMapTemplate": GameCanvas3DWorldMapTemplate,
       "GameCard": GameCard,
       "GameHud": GameHud,
+      "GameIcon": GameIcon,
       "GameMenu": GameMenu,
       "GameShell": GameShell,
       "GameTemplate": GameTemplate,
@@ -51361,7 +51747,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React106__default.createElement(
+  return React107__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -51403,7 +51789,7 @@ function enrichFormFields(fields, entityDef) {
       }
       return { name: field, label: field.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/\b\w/g, (c) => c.toUpperCase()) };
     }
-    if (field && typeof field === "object" && !Array.isArray(field) && !React106__default.isValidElement(field) && !(field instanceof Date)) {
+    if (field && typeof field === "object" && !Array.isArray(field) && !React107__default.isValidElement(field) && !(field instanceof Date)) {
       const obj = field;
       const fieldName = typeof obj.name === "string" ? obj.name : typeof obj.field === "string" ? obj.field : void 0;
       if (!fieldName) return field;
@@ -51849,7 +52235,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
         const key = `${parentId}-${index}-trait:${traitName}`;
         return /* @__PURE__ */ jsx(TraitFrame, { traitName }, key);
       }
-      return /* @__PURE__ */ jsx(React106__default.Fragment, { children: child }, `${parentId}-${index}`);
+      return /* @__PURE__ */ jsx(React107__default.Fragment, { children: child }, `${parentId}-${index}`);
     }
     if (!child || typeof child !== "object") return null;
     const childId = `${parentId}-${index}`;
@@ -51889,14 +52275,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 (React106__default.isValidElement(value)) return false;
+  if (React107__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" && getComponentForPattern(record.type) !== null;
 }
 function isPlainConfigObject(value) {
-  if (React106__default.isValidElement(value)) return false;
+  if (React107__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
@@ -52022,7 +52408,7 @@ function SlotContentRenderer({
     for (const slotKey of CONTENT_NODE_SLOTS) {
       const slotVal = restProps[slotKey];
       if (slotVal === void 0 || slotVal === null) continue;
-      if (React106__default.isValidElement(slotVal) || typeof slotVal === "string" || typeof slotVal === "number" || typeof slotVal === "boolean") continue;
+      if (React107__default.isValidElement(slotVal) || typeof slotVal === "string" || typeof slotVal === "number" || typeof slotVal === "boolean") continue;
       if (Array.isArray(slotVal) || typeof slotVal === "object" && "type" in slotVal) {
         nodeSlotOverrides[slotKey] = renderPatternChildren(
           slotVal,
@@ -52071,7 +52457,7 @@ function SlotContentRenderer({
     const resolvedItems = Array.isArray(entityVal) && entityVal[0] !== "fn" ? entityVal : null;
     if (resolvedItems && resolvedItems.length > 0 && !finalProps.fields && !finalProps.columns) {
       const sample = resolvedItems[0];
-      if (sample && typeof sample === "object" && !Array.isArray(sample) && !React106__default.isValidElement(sample) && !(sample instanceof Date)) {
+      if (sample && typeof sample === "object" && !Array.isArray(sample) && !React107__default.isValidElement(sample) && !(sample instanceof Date)) {
         const keys = Object.keys(sample).filter((k) => k !== "id" && k !== "_id");
         finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
       }
@@ -53067,6 +53453,525 @@ function useUserForEvaluation() {
   const { user, isLoggedIn } = useUser();
   return isLoggedIn && user ? user : void 0;
 }
+var EntitySchemaContext = createContext(null);
+function EntitySchemaProvider({
+  entities,
+  traitLinkedEntities,
+  orbitalsByTrait,
+  children
+}) {
+  const entitiesMap = useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    for (const entity of entities) {
+      map.set(entity.name, entity);
+    }
+    return map;
+  }, [entities]);
+  const linkedMap = useMemo(() => {
+    return traitLinkedEntities ?? /* @__PURE__ */ new Map();
+  }, [traitLinkedEntities]);
+  const orbitalsMap = useMemo(() => {
+    return orbitalsByTrait ?? /* @__PURE__ */ new Map();
+  }, [orbitalsByTrait]);
+  const contextValue = useMemo(
+    () => ({
+      entities: entitiesMap,
+      traitLinkedEntities: linkedMap,
+      orbitalsByTrait: orbitalsMap
+    }),
+    [entitiesMap, linkedMap, orbitalsMap]
+  );
+  return /* @__PURE__ */ jsx(EntitySchemaContext.Provider, { value: contextValue, children });
+}
+function useEntitySchema() {
+  const context = useContext(EntitySchemaContext);
+  if (!context) {
+    throw new Error("useEntitySchema must be used within an EntitySchemaProvider");
+  }
+  return context;
+}
+function useEntitySchemaOptional3() {
+  return useContext(EntitySchemaContext);
+}
+var log11 = createLogger("almadar:ui:navigation");
+function matchPath2(pattern, path) {
+  const normalizeSegment = (p2) => {
+    let normalized = p2.trim();
+    if (!normalized.startsWith("/")) normalized = "/" + normalized;
+    if (normalized.length > 1 && normalized.endsWith("/")) {
+      normalized = normalized.slice(0, -1);
+    }
+    return normalized;
+  };
+  const normalizedPattern = normalizeSegment(pattern);
+  const normalizedPath = normalizeSegment(path);
+  const patternParts = normalizedPattern.split("/").filter(Boolean);
+  const pathParts = normalizedPath.split("/").filter(Boolean);
+  if (patternParts.length !== pathParts.length) {
+    return null;
+  }
+  const params = {};
+  for (let i = 0; i < patternParts.length; i++) {
+    const patternPart = patternParts[i];
+    const pathPart = pathParts[i];
+    if (patternPart.startsWith(":")) {
+      const paramName = patternPart.slice(1);
+      params[paramName] = decodeURIComponent(pathPart);
+    } else if (patternPart !== pathPart) {
+      return null;
+    }
+  }
+  return params;
+}
+function extractRouteParams2(pattern, path) {
+  return matchPath2(pattern, path) || {};
+}
+function pathMatches2(pattern, path) {
+  return matchPath2(pattern, path) !== null;
+}
+function isInlineOrbital(orbital) {
+  return "name" in orbital && typeof orbital.name === "string";
+}
+function isInlinePage(page) {
+  return typeof page === "object" && page !== null && "name" in page && typeof page.name === "string";
+}
+function findPageByPath2(schema, path) {
+  if (!schema.orbitals) return null;
+  for (const orbital of schema.orbitals) {
+    if (!isInlineOrbital(orbital)) continue;
+    if (!orbital.pages) continue;
+    for (const pageRef of orbital.pages) {
+      if (!isInlinePage(pageRef)) continue;
+      const page = pageRef;
+      const pagePath = page.path;
+      if (!pagePath) continue;
+      const params = matchPath2(pagePath, path);
+      if (params !== null) {
+        return { page, params, orbitalName: orbital.name };
+      }
+    }
+  }
+  return null;
+}
+function findPageByName2(schema, pageName) {
+  if (!schema.orbitals) return null;
+  for (const orbital of schema.orbitals) {
+    if (!isInlineOrbital(orbital)) continue;
+    if (!orbital.pages) continue;
+    for (const pageRef of orbital.pages) {
+      if (!isInlinePage(pageRef)) continue;
+      const page = pageRef;
+      if (page.name === pageName) {
+        return { page, orbitalName: orbital.name };
+      }
+    }
+  }
+  return null;
+}
+function getDefaultPage2(schema) {
+  if (!schema.orbitals) return null;
+  for (const orbital of schema.orbitals) {
+    if (!isInlineOrbital(orbital)) continue;
+    if (!orbital.pages) continue;
+    for (const pageRef of orbital.pages) {
+      if (isInlinePage(pageRef)) {
+        return { page: pageRef, orbitalName: orbital.name };
+      }
+    }
+  }
+  return null;
+}
+function getAllPages2(schema) {
+  const pages = [];
+  if (!schema.orbitals) return pages;
+  for (const orbital of schema.orbitals) {
+    if (!isInlineOrbital(orbital)) continue;
+    if (!orbital.pages) continue;
+    for (const pageRef of orbital.pages) {
+      if (isInlinePage(pageRef)) {
+        pages.push({ page: pageRef, orbitalName: orbital.name });
+      }
+    }
+  }
+  return pages;
+}
+var NavigationContext = createContext(null);
+function NavigationProvider2({
+  schema,
+  initialPage,
+  updateUrl = true,
+  onNavigate,
+  children
+}) {
+  const initialState = useMemo(() => {
+    let page = null;
+    let path = "/";
+    if (initialPage) {
+      const found = findPageByName2(schema, initialPage);
+      if (found) {
+        page = found.page;
+        path = page.path || "/";
+      }
+    }
+    if (!page) {
+      const defaultPage = getDefaultPage2(schema);
+      if (defaultPage) {
+        page = defaultPage.page;
+        path = page.path || "/";
+      }
+    }
+    return {
+      activePage: page?.name || "",
+      currentPath: path,
+      initPayload: {},
+      navigationId: 0
+    };
+  }, [schema, initialPage]);
+  const [state, setState] = useState(initialState);
+  const navigateTo = useCallback((path, payload) => {
+    const result = findPageByPath2(schema, path);
+    if (!result) {
+      log11.error("No page found for path", { path });
+      return;
+    }
+    const { page, params } = result;
+    const finalPayload = { ...params, ...payload };
+    log11.debug("Navigating to", () => ({
+      path,
+      page: page.name,
+      params,
+      payload: JSON.stringify(payload),
+      finalPayload: JSON.stringify(finalPayload)
+    }));
+    setState((prev) => ({
+      activePage: page.name,
+      currentPath: path,
+      initPayload: finalPayload,
+      navigationId: prev.navigationId + 1
+    }));
+    if (updateUrl && typeof window !== "undefined") {
+      try {
+        window.history.pushState(finalPayload, "", path);
+      } catch (e) {
+        log11.warn("Could not update URL", { error: e instanceof Error ? e : String(e) });
+      }
+    }
+    if (onNavigate) {
+      onNavigate(page.name, path, finalPayload);
+    }
+  }, [schema, updateUrl, onNavigate]);
+  const navigateToPage = useCallback((pageName, payload) => {
+    const result = findPageByName2(schema, pageName);
+    if (!result) {
+      log11.error("No page found with name", { pageName });
+      return;
+    }
+    const { page } = result;
+    const path = page.path || `/${pageName.toLowerCase()}`;
+    log11.debug("Navigating to page", () => ({
+      pageName,
+      path,
+      payload: JSON.stringify(payload)
+    }));
+    setState((prev) => ({
+      activePage: page.name,
+      currentPath: path,
+      initPayload: payload || {},
+      navigationId: prev.navigationId + 1
+    }));
+    if (updateUrl && typeof window !== "undefined") {
+      try {
+        window.history.pushState(payload || {}, "", path);
+      } catch (e) {
+        log11.warn("Could not update URL", { error: e instanceof Error ? e : String(e) });
+      }
+    }
+    if (onNavigate) {
+      onNavigate(page.name, path, payload || {});
+    }
+  }, [schema, updateUrl, onNavigate]);
+  const contextValue = useMemo(() => ({
+    state,
+    navigateTo,
+    navigateToPage,
+    schema,
+    isReady: !!state.activePage
+  }), [state, navigateTo, navigateToPage, schema]);
+  return /* @__PURE__ */ jsx(NavigationContext.Provider, { value: contextValue, children });
+}
+function useNavigation2() {
+  return useContext(NavigationContext);
+}
+function useNavigateTo2() {
+  const context = useContext(NavigationContext);
+  const noOp = useCallback((path, _payload) => {
+    log11.warn("navigateTo called outside NavigationProvider", { path });
+  }, []);
+  return context?.navigateTo || noOp;
+}
+function useNavigationState2() {
+  const context = useContext(NavigationContext);
+  return context?.state || null;
+}
+function useInitPayload2() {
+  const context = useContext(NavigationContext);
+  return context?.state.initPayload || {};
+}
+function useActivePage2() {
+  const context = useContext(NavigationContext);
+  return context?.state.activePage || null;
+}
+function useNavigationId2() {
+  const context = useContext(NavigationContext);
+  return context?.state.navigationId || 0;
+}
+
+// providers/ServerBridge.tsx
+init_useEventBus();
+var xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
+var serverBridgeLog = createLogger("almadar:ui:server-bridge");
+function createHttpTransport(serverUrl) {
+  return {
+    register: async (schema) => {
+      try {
+        const res = await fetch(`${serverUrl}/register`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ schema })
+        });
+        const result = await res.json();
+        return !!result.success;
+      } catch (err) {
+        if (err instanceof TypeError) {
+          serverBridgeLog.warn("Registration failed", { error: err.message });
+        } else {
+          serverBridgeLog.error("Registration failed", { error: err instanceof Error ? err : String(err) });
+        }
+        return false;
+      }
+    },
+    unregister: async () => {
+      try {
+        await fetch(`${serverUrl}/unregister`, { method: "DELETE" });
+      } catch {
+      }
+    },
+    sendEvent: async (orbitalName, event, payload) => {
+      const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ event, payload })
+      });
+      return res.json();
+    }
+  };
+}
+var ServerBridgeContext = createContext(null);
+function useServerBridge() {
+  const ctx = useContext(ServerBridgeContext);
+  if (!ctx) {
+    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+    return { connected: false, sendEvent: async () => ({ effects: [], meta: emptyMeta }) };
+  }
+  return ctx;
+}
+function ServerBridgeProvider({
+  schema,
+  serverUrl,
+  transport: customTransport,
+  children
+}) {
+  if (!serverUrl && !customTransport) {
+    throw new Error("ServerBridgeProvider requires either serverUrl or transport");
+  }
+  if (serverUrl && customTransport) {
+    throw new Error("ServerBridgeProvider accepts serverUrl OR transport, not both");
+  }
+  const eventBus = useEventBus();
+  const [connected, setConnected] = useState(false);
+  const transport = useMemo(
+    () => customTransport ?? createHttpTransport(serverUrl),
+    [serverUrl, customTransport]
+  );
+  const registerSchema = useCallback(
+    async () => transport.register(schema),
+    [schema, transport]
+  );
+  const unregisterSchema = useCallback(
+    async () => transport.unregister(),
+    [transport]
+  );
+  const sendEvent = useCallback(async (orbitalName, event, payload) => {
+    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+    if (!connected) return { effects: [], meta: emptyMeta };
+    try {
+      const result = await transport.sendEvent(orbitalName, event, payload);
+      const effects = [];
+      const responseData = result.data || {};
+      const dataEntities = {};
+      for (const [entityName, records] of Object.entries(responseData)) {
+        dataEntities[entityName] = Array.isArray(records) ? records.length : 0;
+      }
+      const meta = {
+        success: !!result.success,
+        clientEffects: result.clientEffects?.length ?? 0,
+        dataEntities,
+        data: responseData,
+        emittedEvents: result.emittedEvents?.map((e) => e.event) ?? [],
+        error: result.error
+      };
+      if (result.success) {
+        const tagged = result.clientEffectsByTrait;
+        const tuples = tagged ? tagged.map((entry) => ({ effect: entry.effect, traitName: entry.traitName })) : (result.clientEffects ?? []).map((eff) => ({ effect: eff }));
+        for (const { effect, traitName } of tuples) {
+          const effectType = effect[0];
+          if (effectType === "render-ui") {
+            const slot = effect[1];
+            const pattern = effect[2];
+            effects.push({
+              type: "render-ui",
+              slot,
+              pattern: pattern !== null && typeof pattern === "object" ? pattern : void 0,
+              traitName
+            });
+          } else if (effectType === "navigate") {
+            const route = effect[1];
+            const rawParams = effect[2];
+            effects.push({
+              type: "navigate",
+              route,
+              params: rawParams !== null && rawParams !== void 0 && typeof rawParams === "object" && !Array.isArray(rawParams) ? rawParams : void 0,
+              traitName
+            });
+          } else if (effectType === "notify") {
+            const message = effect[1];
+            effects.push({ type: "notify", message: typeof message === "string" ? message : void 0, traitName });
+          }
+        }
+        if (result.emittedEvents) {
+          for (const emitted of result.emittedEvents) {
+            const evTrait = emitted.source?.trait;
+            if (!evTrait) {
+              xOrbitalLog.warn("emit:dropped-no-source", {
+                event: emitted.event,
+                dispatchOrbital: orbitalName
+              });
+              continue;
+            }
+            const key = emitted.source?.orbital ? `UI:${emitted.source.orbital}.${evTrait}.${emitted.event}` : `UI:${evTrait}.${emitted.event}`;
+            xOrbitalLog.info("emit:rebroadcast", {
+              busKey: key,
+              sourceOrbital: emitted.source?.orbital,
+              sourceTrait: evTrait,
+              dispatchOrbital: orbitalName
+            });
+            eventBus.emit(key, emitted.payload);
+          }
+        }
+      } else if (result.error) {
+        xOrbitalLog.warn("response:fail", {
+          orbital: orbitalName,
+          event,
+          error: result.error
+        });
+      }
+      return { effects, meta };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (err instanceof TypeError) {
+        xOrbitalLog.warn("response:network", {
+          orbital: orbitalName,
+          event,
+          error: msg,
+          reason: "peer endpoint unreachable (expected in standalone single-orbital mode)"
+        });
+      } else {
+        xOrbitalLog.error("response:network", {
+          orbital: orbitalName,
+          event,
+          error: msg
+        });
+      }
+      return { effects: [], meta: { ...emptyMeta, error: msg } };
+    }
+  }, [connected, transport, eventBus]);
+  useEffect(() => {
+    if (!schema) return;
+    let cancelled = false;
+    registerSchema().then((ok) => {
+      if (!cancelled && ok) setConnected(true);
+    });
+    return () => {
+      cancelled = true;
+      setConnected(false);
+      unregisterSchema();
+    };
+  }, [schema, registerSchema, unregisterSchema]);
+  return /* @__PURE__ */ jsx(ServerBridgeContext.Provider, { value: { connected, sendEvent }, children });
+}
+var log12 = createLogger("almadar:ui:trait-provider");
+var TraitContext = createContext(null);
+function TraitProvider({
+  traits: traitBindings,
+  children
+}) {
+  const traitInstances = useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    for (const binding of traitBindings) {
+      const trait = binding.trait;
+      const initialState = trait.states.find((s) => s.isInitial);
+      const stateName = initialState?.name || trait.states[0]?.name || "idle";
+      const instance = {
+        name: trait.name,
+        currentState: stateName,
+        availableEvents: trait.transitions.filter((t) => t.from === stateName).map((t) => t.event),
+        dispatch: (eventKey, payload) => {
+          log12.debug("Dispatch", () => ({
+            trait: trait.name,
+            event: eventKey,
+            payloadKeys: payload ? Object.keys(payload) : []
+          }));
+        },
+        canDispatch: (eventKey) => {
+          return trait.transitions.some(
+            (t) => t.from === stateName && t.event === eventKey
+          );
+        },
+        trait
+      };
+      map.set(trait.name, instance);
+    }
+    return map;
+  }, [traitBindings]);
+  const contextValue = useMemo(() => {
+    return {
+      traits: traitInstances,
+      getTrait: (name) => traitInstances.get(name),
+      dispatchToTrait: (traitName, eventKey, payload) => {
+        const instance = traitInstances.get(traitName);
+        if (instance) {
+          instance.dispatch(eventKey, payload);
+        }
+      },
+      canDispatch: (traitName, eventKey) => {
+        const instance = traitInstances.get(traitName);
+        return instance?.canDispatch(eventKey) || false;
+      }
+    };
+  }, [traitInstances]);
+  return /* @__PURE__ */ jsx(TraitContext.Provider, { value: contextValue, children });
+}
+function useTraitContext() {
+  const context = useContext(TraitContext);
+  if (!context) {
+    throw new Error("useTraitContext must be used within a TraitProvider");
+  }
+  return context;
+}
+function useTrait(traitName) {
+  const context = useTraitContext();
+  return context.getTrait(traitName);
+}
 var TraitScopeContext = createContext(null);
 function TraitScopeProvider3({
   orbital,
@@ -53112,4 +54017,4 @@ function useOptionalOfflineMode() {
   return useContext(OfflineModeContext);
 }
 
-export { ANONYMOUS_USER, CurrentPagePathContext, CurrentPagePathProvider, EventBusContext2 as EventBusContext, EventBusProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, SelectionContext, SelectionProvider, TraitScopeProvider3 as TraitScopeProvider, UserContext, UserProvider, VerificationProvider, useCurrentPagePath2 as useCurrentPagePath, useHasPermission, useHasRole, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useTraitScope2 as useTraitScope, useUser, useUserForEvaluation };
+export { ANONYMOUS_USER, CurrentPagePathContext, CurrentPagePathProvider, EntitySchemaProvider, EventBusContext2 as EventBusContext, EventBusProvider, NavigationProvider2 as NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, TraitContext, TraitProvider, TraitScopeProvider3 as TraitScopeProvider, UserContext, UserProvider, VerificationProvider, extractRouteParams2 as extractRouteParams, findPageByName2 as findPageByName, findPageByPath2 as findPageByPath, getAllPages2 as getAllPages, getDefaultPage2 as getDefaultPage, matchPath2 as matchPath, pathMatches2 as pathMatches, useActivePage2 as useActivePage, useCurrentPagePath2 as useCurrentPagePath, useEntitySchema, useEntitySchemaOptional3 as useEntitySchemaOptional, useHasPermission, useHasRole, useInitPayload2 as useInitPayload, useNavigateTo2 as useNavigateTo, useNavigation2 as useNavigation, useNavigationId2 as useNavigationId, useNavigationState2 as useNavigationState, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useServerBridge, useTrait, useTraitContext, useTraitScope2 as useTraitScope, useUser, useUserForEvaluation };