@almadar/ui 2.28.2 → 2.29.0

package/dist/providers/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var React113 = require('react');
+var React114 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var providers = require('@almadar/ui/providers');
 require('react-dom');
@@ -42,7 +42,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React113__namespace = /*#__PURE__*/_interopNamespace(React113);
+var React114__namespace = /*#__PURE__*/_interopNamespace(React114);
 var LucideIcons__namespace = /*#__PURE__*/_interopNamespace(LucideIcons);
 var L__default = /*#__PURE__*/_interopDefault(L);
 var ReactMarkdown__default = /*#__PURE__*/_interopDefault(ReactMarkdown);
@@ -154,7 +154,7 @@ var BUILT_IN_THEMES = [
     hasDarkMode: true
   }
 ];
-var ThemeContext = React113.createContext(void 0);
+var ThemeContext = React114.createContext(void 0);
 var THEME_STORAGE_KEY = "theme";
 var MODE_STORAGE_KEY = "theme-mode";
 function getSystemMode() {
@@ -174,14 +174,14 @@ var ThemeProvider = ({
   defaultMode = "system",
   targetRef
 }) => {
-  const availableThemes = React113.useMemo(() => {
+  const availableThemes = React114.useMemo(() => {
     const themeMap = /* @__PURE__ */ new Map();
     BUILT_IN_THEMES.forEach((t) => themeMap.set(t.name, t));
     themes.forEach((t) => themeMap.set(t.name, t));
     return Array.from(themeMap.values());
   }, [themes]);
   const isScoped = !!targetRef;
-  const [theme, setThemeState] = React113.useState(() => {
+  const [theme, setThemeState] = React114.useState(() => {
     if (isScoped || typeof window === "undefined") return defaultTheme;
     const stored = localStorage.getItem(THEME_STORAGE_KEY);
     const validThemes = [
@@ -193,7 +193,7 @@ var ThemeProvider = ({
     }
     return defaultTheme;
   });
-  const [mode, setModeState] = React113.useState(() => {
+  const [mode, setModeState] = React114.useState(() => {
     if (isScoped || typeof window === "undefined") return defaultMode;
     const stored = localStorage.getItem(MODE_STORAGE_KEY);
     if (stored === "light" || stored === "dark" || stored === "system") {
@@ -201,14 +201,14 @@ var ThemeProvider = ({
     }
     return defaultMode;
   });
-  const [resolvedMode, setResolvedMode] = React113.useState(
+  const [resolvedMode, setResolvedMode] = React114.useState(
     () => resolveMode(mode)
   );
-  const appliedTheme = React113.useMemo(
+  const appliedTheme = React114.useMemo(
     () => `${theme}-${resolvedMode}`,
     [theme, resolvedMode]
   );
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     const updateResolved = () => {
       setResolvedMode(resolveMode(mode));
     };
@@ -221,7 +221,7 @@ var ThemeProvider = ({
     }
     return void 0;
   }, [mode]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (isScoped) {
       if (targetRef?.current) {
         targetRef.current.setAttribute("data-theme", appliedTheme);
@@ -235,7 +235,7 @@ var ThemeProvider = ({
     root.classList.remove("light", "dark");
     root.classList.add(resolvedMode);
   }, [appliedTheme, resolvedMode, targetRef, isScoped]);
-  const setTheme = React113.useCallback(
+  const setTheme = React114.useCallback(
     (newTheme) => {
       const validTheme = availableThemes.find((t) => t.name === newTheme);
       if (validTheme) {
@@ -251,17 +251,17 @@ var ThemeProvider = ({
     },
     [availableThemes]
   );
-  const setMode = React113.useCallback((newMode) => {
+  const setMode = React114.useCallback((newMode) => {
     setModeState(newMode);
     if (!isScoped && typeof window !== "undefined") {
       localStorage.setItem(MODE_STORAGE_KEY, newMode);
     }
   }, []);
-  const toggleMode = React113.useCallback(() => {
+  const toggleMode = React114.useCallback(() => {
     const newMode = resolvedMode === "dark" ? "light" : "dark";
     setMode(newMode);
   }, [resolvedMode, setMode]);
-  const contextValue = React113.useMemo(
+  const contextValue = React114.useMemo(
     () => ({
       theme,
       mode,
@@ -285,6 +285,81 @@ var ThemeProvider = ({
   );
   return /* @__PURE__ */ jsxRuntime.jsx(ThemeContext.Provider, { value: contextValue, children });
 };
+var store = /* @__PURE__ */ new Map();
+var storeListeners = /* @__PURE__ */ new Set();
+var watchCallbacks = /* @__PURE__ */ new Map();
+function advance(entityType, data) {
+  const prev = store.get(entityType);
+  const oldData = prev?.data ?? [];
+  store.set(entityType, { data, version: (prev?.version ?? 0) + 1 });
+  for (const listener of storeListeners) {
+    listener();
+  }
+  const cbs = watchCallbacks.get(entityType);
+  if (cbs) {
+    for (const cb of cbs) {
+      try {
+        cb(oldData, data);
+      } catch {
+      }
+    }
+  }
+}
+function getSnapshot(entityType) {
+  return store.get(entityType)?.data ?? [];
+}
+function getVersion(entityType) {
+  return store.get(entityType)?.version ?? 0;
+}
+function subscribeToStore(listener) {
+  storeListeners.add(listener);
+  return () => {
+    storeListeners.delete(listener);
+  };
+}
+function addWatch(entityType, callback) {
+  let cbs = watchCallbacks.get(entityType);
+  if (!cbs) {
+    cbs = /* @__PURE__ */ new Set();
+    watchCallbacks.set(entityType, cbs);
+  }
+  cbs.add(callback);
+  return () => {
+    cbs.delete(callback);
+  };
+}
+function useEntityRef(entityType) {
+  const versionRef = React114.useRef(0);
+  const dataRef = React114.useRef([]);
+  const getSnapshotStable = React114__namespace.default.useCallback(() => {
+    const currentVersion = getVersion(entityType);
+    if (currentVersion !== versionRef.current) {
+      versionRef.current = currentVersion;
+      dataRef.current = getSnapshot(entityType);
+    }
+    return dataRef.current;
+  }, [entityType]);
+  return React114.useSyncExternalStore(subscribeToStore, getSnapshotStable, () => []);
+}
+function useEntityWatch(entityType, callback) {
+  const callbackRef = React114.useRef(callback);
+  callbackRef.current = callback;
+  React114.useEffect(() => {
+    return addWatch(entityType, (oldData, newData) => {
+      callbackRef.current(oldData, newData);
+    });
+  }, [entityType]);
+}
+var EntityStoreContext = React114.createContext({
+  advance,
+  getSnapshot
+});
+function useEntityStore() {
+  return React114.useContext(EntityStoreContext);
+}
+function EntityStoreProvider({ children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(EntityStoreContext.Provider, { value: { advance, getSnapshot }, children });
+}
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
     window.__kflowEventBus = bus;
@@ -357,15 +432,15 @@ var fallbackEventBus = {
   }
 };
 function useEventBus() {
-  const context = React113.useContext(providers.EventBusContext);
+  const context = React114.useContext(providers.EventBusContext);
   return context ?? getGlobalEventBus() ?? fallbackEventBus;
 }
-var EventBusContext2 = React113.createContext(null);
+var EventBusContext2 = React114.createContext(null);
 function EventBusProvider({ children, debug: debug2 = false }) {
-  const listenersRef = React113.useRef(/* @__PURE__ */ new Map());
-  const anyListenersRef = React113.useRef(/* @__PURE__ */ new Set());
-  const deprecationWarningShown = React113.useRef(false);
-  const getSelectedEntity = React113.useCallback(() => {
+  const listenersRef = React114.useRef(/* @__PURE__ */ new Map());
+  const anyListenersRef = React114.useRef(/* @__PURE__ */ new Set());
+  const deprecationWarningShown = React114.useRef(false);
+  const getSelectedEntity = React114.useCallback(() => {
     if (!deprecationWarningShown.current) {
       console.warn(
         "[EventBus] getSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
@@ -374,7 +449,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }
     return null;
   }, []);
-  const clearSelectedEntity = React113.useCallback(() => {
+  const clearSelectedEntity = React114.useCallback(() => {
     if (!deprecationWarningShown.current) {
       console.warn(
         "[EventBus] clearSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
@@ -382,7 +457,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       deprecationWarningShown.current = true;
     }
   }, []);
-  const emit = React113.useCallback((type, payload) => {
+  const emit = React114.useCallback((type, payload) => {
     const event = {
       type,
       payload,
@@ -416,7 +491,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       }
     }
   }, [debug2]);
-  const on = React113.useCallback((type, listener) => {
+  const on = React114.useCallback((type, listener) => {
     if (!listenersRef.current.has(type)) {
       listenersRef.current.set(type, /* @__PURE__ */ new Set());
     }
@@ -435,18 +510,18 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       }
     };
   }, [debug2]);
-  const once = React113.useCallback((type, listener) => {
+  const once = React114.useCallback((type, listener) => {
     const wrappedListener = (event) => {
       listenersRef.current.get(type)?.delete(wrappedListener);
       listener(event);
     };
     return on(type, wrappedListener);
   }, [on]);
-  const hasListeners = React113.useCallback((type) => {
+  const hasListeners = React114.useCallback((type) => {
     const listeners6 = listenersRef.current.get(type);
     return listeners6 !== void 0 && listeners6.size > 0;
   }, []);
-  const onAny = React113.useCallback((listener) => {
+  const onAny = React114.useCallback((listener) => {
     anyListenersRef.current.add(listener);
     if (debug2) {
       console.log(`[EventBus] onAny subscribed, total: ${anyListenersRef.current.size}`);
@@ -458,7 +533,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       }
     };
   }, [debug2]);
-  const contextValue = React113.useMemo(
+  const contextValue = React114.useMemo(
     () => ({
       emit,
       on,
@@ -470,7 +545,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }),
     [emit, on, once, hasListeners, onAny, getSelectedEntity, clearSelectedEntity]
   );
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     setGlobalEventBus(contextValue);
     return () => {
       setGlobalEventBus(null);
@@ -478,7 +553,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, [contextValue]);
   return /* @__PURE__ */ jsxRuntime.jsx(EventBusContext2.Provider, { value: contextValue, children });
 }
-var SelectionContext = React113.createContext(null);
+var SelectionContext = React114.createContext(null);
 var defaultCompareEntities = (a, b) => {
   if (a === b) return true;
   if (!a || !b) return false;
@@ -495,8 +570,8 @@ function SelectionProvider({
   compareEntities = defaultCompareEntities
 }) {
   const eventBus = useEventBus();
-  const [selected, setSelectedState] = React113.useState(null);
-  const setSelected = React113.useCallback(
+  const [selected, setSelectedState] = React114.useState(null);
+  const setSelected = React114.useCallback(
     (entity) => {
       setSelectedState(entity);
       if (debug2) {
@@ -505,19 +580,19 @@ function SelectionProvider({
     },
     [debug2]
   );
-  const clearSelection = React113.useCallback(() => {
+  const clearSelection = React114.useCallback(() => {
     setSelectedState(null);
     if (debug2) {
       console.log("[SelectionProvider] Selection cleared");
     }
   }, [debug2]);
-  const isSelected = React113.useCallback(
+  const isSelected = React114.useCallback(
     (entity) => {
       return compareEntities(selected, entity);
     },
     [selected, compareEntities]
   );
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     const handleSelect = (event) => {
       const row = event.payload?.row;
       if (row) {
@@ -555,14 +630,14 @@ function SelectionProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(SelectionContext.Provider, { value: contextValue, children });
 }
 function useSelection() {
-  const context = React113.useContext(SelectionContext);
+  const context = React114.useContext(SelectionContext);
   if (!context) {
     throw new Error("useSelection must be used within a SelectionProvider");
   }
   return context;
 }
 function useSelectionOptional() {
-  const context = React113.useContext(SelectionContext);
+  const context = React114.useContext(SelectionContext);
   return context;
 }
 function cn(...inputs) {
@@ -705,7 +780,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React113__namespace.default.forwardRef(
+var Box = React114__namespace.default.forwardRef(
   ({
     padding,
     paddingX,
@@ -734,20 +809,20 @@ var Box = React113__namespace.default.forwardRef(
     ...rest
   }, ref) => {
     const eventBus = useEventBus();
-    const handleClick = React113.useCallback((e) => {
+    const handleClick = React114.useCallback((e) => {
       if (action) {
         e.stopPropagation();
         eventBus.emit(`UI:${action}`, actionPayload ?? {});
       }
       onClick?.(e);
     }, [action, actionPayload, eventBus, onClick]);
-    const handleMouseEnter = React113.useCallback((e) => {
+    const handleMouseEnter = React114.useCallback((e) => {
       if (hoverEvent) {
         eventBus.emit(`UI:${hoverEvent}`, { hovered: true });
       }
       onMouseEnter?.(e);
     }, [hoverEvent, eventBus, onMouseEnter]);
-    const handleMouseLeave = React113.useCallback((e) => {
+    const handleMouseLeave = React114.useCallback((e) => {
       if (hoverEvent) {
         eventBus.emit(`UI:${hoverEvent}`, { hovered: false });
       }
@@ -976,7 +1051,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
-  if (React113__namespace.default.isValidElement(value)) {
+  if (React114__namespace.default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -985,7 +1060,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React113__namespace.default.forwardRef(
+var Button = React114__namespace.default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -1081,7 +1156,7 @@ var sizeStyles3 = {
   md: "px-2.5 py-1 text-sm",
   lg: "px-3 py-1.5 text-base"
 };
-var Badge = React113__namespace.default.forwardRef(
+var Badge = React114__namespace.default.forwardRef(
   ({ className, variant = "default", size = "sm", amount, label, icon, children, ...props }, ref) => {
     const iconSizes2 = { sm: "w-3 h-3", md: "w-3.5 h-3.5", lg: "w-4 h-4" };
     const resolvedIcon = typeof icon === "string" ? (() => {
@@ -1108,7 +1183,7 @@ var Badge = React113__namespace.default.forwardRef(
   }
 );
 Badge.displayName = "Badge";
-var Input = React113__namespace.default.forwardRef(
+var Input = React114__namespace.default.forwardRef(
   ({
     className,
     inputType,
@@ -1220,7 +1295,7 @@ var Input = React113__namespace.default.forwardRef(
   }
 );
 Input.displayName = "Input";
-var Label = React113__namespace.default.forwardRef(
+var Label = React114__namespace.default.forwardRef(
   ({ className, required, children, ...props }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsxs(
       "label",
@@ -1240,7 +1315,7 @@ var Label = React113__namespace.default.forwardRef(
   }
 );
 Label.displayName = "Label";
-var Textarea = React113__namespace.default.forwardRef(
+var Textarea = React114__namespace.default.forwardRef(
   ({ className, error, ...props }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "textarea",
@@ -1263,7 +1338,7 @@ var Textarea = React113__namespace.default.forwardRef(
   }
 );
 Textarea.displayName = "Textarea";
-var Select = React113__namespace.default.forwardRef(
+var Select = React114__namespace.default.forwardRef(
   ({ className, options, placeholder, error, ...props }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative", children: [
       /* @__PURE__ */ jsxRuntime.jsxs(
@@ -1299,7 +1374,7 @@ var Select = React113__namespace.default.forwardRef(
   }
 );
 Select.displayName = "Select";
-var Checkbox = React113__namespace.default.forwardRef(
+var Checkbox = React114__namespace.default.forwardRef(
   ({ className, label, id, ...props }, ref) => {
     const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
     return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center", children: [
@@ -1375,7 +1450,7 @@ var shadowStyles2 = {
   md: "shadow",
   lg: "shadow-lg"
 };
-var Card = React113__namespace.default.forwardRef(
+var Card = React114__namespace.default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -1411,9 +1486,9 @@ var Card = React113__namespace.default.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React113__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React114__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React113__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+var CardTitle = React114__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
   "h3",
   {
     ref,
@@ -1426,11 +1501,11 @@ var CardTitle = React113__namespace.default.forwardRef(({ className, ...props },
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React113__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React114__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React113__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+var CardFooter = React114__namespace.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
   "div",
   {
     ref,
@@ -1445,7 +1520,7 @@ var sizeStyles4 = {
   md: "h-6 w-6",
   lg: "h-8 w-8"
 };
-var Spinner = React113__namespace.default.forwardRef(
+var Spinner = React114__namespace.default.forwardRef(
   ({ className, size = "md", ...props }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "div",
@@ -1459,7 +1534,7 @@ var Spinner = React113__namespace.default.forwardRef(
   }
 );
 Spinner.displayName = "Spinner";
-var Radio = React113__namespace.default.forwardRef(
+var Radio = React114__namespace.default.forwardRef(
   ({
     label,
     helperText,
@@ -1563,7 +1638,7 @@ var Radio = React113__namespace.default.forwardRef(
   }
 );
 Radio.displayName = "Radio";
-var Switch = React113__namespace.forwardRef(
+var Switch = React114__namespace.forwardRef(
   ({
     checked,
     defaultChecked = false,
@@ -1574,10 +1649,10 @@ var Switch = React113__namespace.forwardRef(
     name,
     className
   }, ref) => {
-    const [isChecked, setIsChecked] = React113__namespace.useState(
+    const [isChecked, setIsChecked] = React114__namespace.useState(
       checked !== void 0 ? checked : defaultChecked
     );
-    React113__namespace.useEffect(() => {
+    React114__namespace.useEffect(() => {
       if (checked !== void 0) {
         setIsChecked(checked);
       }
@@ -1735,7 +1810,7 @@ var sizeStyles5 = {
   md: "w-2.5 h-2.5",
   lg: "w-3 h-3"
 };
-var StatusDot = React113__namespace.default.forwardRef(
+var StatusDot = React114__namespace.default.forwardRef(
   ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsx(
       "span",
@@ -1782,7 +1857,7 @@ var iconMap2 = {
   down: LucideIcons.TrendingDown,
   flat: LucideIcons.ArrowRight
 };
-var TrendIndicator = React113__namespace.default.forwardRef(
+var TrendIndicator = React114__namespace.default.forwardRef(
   ({
     className,
     value,
@@ -1841,7 +1916,7 @@ var thumbSizes = {
   md: "w-4 h-4",
   lg: "w-5 h-5"
 };
-var RangeSlider = React113__namespace.default.forwardRef(
+var RangeSlider = React114__namespace.default.forwardRef(
   ({
     className,
     min = 0,
@@ -1859,14 +1934,14 @@ var RangeSlider = React113__namespace.default.forwardRef(
     formatValue: formatValue5,
     ...props
   }, ref) => {
-    const [isDragging, setIsDragging] = React113.useState(false);
-    const [showTip, setShowTip] = React113.useState(false);
-    const inputRef = React113.useRef(null);
+    const [isDragging, setIsDragging] = React114.useState(false);
+    const [showTip, setShowTip] = React114.useState(false);
+    const inputRef = React114.useRef(null);
     const eventBus = useSafeEventBus();
     const percentage = max !== min ? (value - min) / (max - min) * 100 : 0;
     const bufferedPercentage = buffered !== void 0 ? Math.min(buffered, 100) : void 0;
     const displayValue = formatValue5 ? formatValue5(value) : String(value);
-    const handleChange = React113.useCallback(
+    const handleChange = React114.useCallback(
       (e) => {
         const newValue = Number(e.target.value);
         onChange?.(newValue);
@@ -2044,7 +2119,7 @@ var paddingClasses = {
   md: "py-16",
   lg: "py-24"
 };
-var ContentSection = React113__namespace.default.forwardRef(
+var ContentSection = React114__namespace.default.forwardRef(
   ({ children, background = "default", padding = "lg", id, className }, ref) => {
     return /* @__PURE__ */ jsxRuntime.jsx(
       Box,
@@ -2083,7 +2158,7 @@ var animatedStyles = {
   "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
   "none": {}
 };
-var AnimatedReveal = React113__namespace.default.forwardRef(
+var AnimatedReveal = React114__namespace.default.forwardRef(
   ({
     trigger = "scroll",
     animation = "fade-up",
@@ -2098,10 +2173,10 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
     style,
     ...props
   }, forwardedRef) => {
-    const [isAnimated, setIsAnimated] = React113.useState(false);
-    const internalRef = React113.useRef(null);
-    const hasAnimated = React113.useRef(false);
-    const setRef = React113.useCallback(
+    const [isAnimated, setIsAnimated] = React114.useState(false);
+    const internalRef = React114.useRef(null);
+    const hasAnimated = React114.useRef(false);
+    const setRef = React114.useCallback(
       (node) => {
         internalRef.current = node;
         if (typeof forwardedRef === "function") forwardedRef(node);
@@ -2109,7 +2184,7 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
       },
       [forwardedRef]
     );
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       if (trigger !== "scroll") return;
       const el = internalRef.current;
       if (!el) return;
@@ -2135,7 +2210,7 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
         setIsAnimated(false);
       }
     } : void 0;
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       if (trigger === "manual" && manualAnimate !== void 0) {
         setIsAnimated(manualAnimate);
       }
@@ -2165,9 +2240,9 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
 );
 AnimatedReveal.displayName = "AnimatedReveal";
 function useFetchedSvg(src) {
-  const [svg, setSvg] = React113.useState(null);
-  const cache = React113.useRef({});
-  React113.useEffect(() => {
+  const [svg, setSvg] = React114.useState(null);
+  const cache = React114.useRef({});
+  React114.useEffect(() => {
     if (!src) {
       setSvg(null);
       return;
@@ -2236,7 +2311,7 @@ function applyMorphAnimation(container, animate, duration, delay, easing) {
     el.style.opacity = animate ? "1" : "0";
   });
 }
-var AnimatedGraphic = React113__namespace.default.forwardRef(
+var AnimatedGraphic = React114__namespace.default.forwardRef(
   ({
     src,
     svgContent,
@@ -2255,11 +2330,11 @@ var AnimatedGraphic = React113__namespace.default.forwardRef(
     children,
     ...props
   }, ref) => {
-    const containerRef = React113.useRef(null);
+    const containerRef = React114.useRef(null);
     const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
     const resolvedSvg = svgContent ?? fetchedSvg;
-    const prevAnimateRef = React113.useRef(animate);
-    const setRef = React113__namespace.default.useCallback(
+    const prevAnimateRef = React114.useRef(animate);
+    const setRef = React114__namespace.default.useCallback(
       (node) => {
         containerRef.current = node;
         if (typeof ref === "function") ref(node);
@@ -2267,7 +2342,7 @@ var AnimatedGraphic = React113__namespace.default.forwardRef(
       },
       [ref]
     );
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       const el = containerRef.current;
       if (!el || !strokeColor) return;
       const paths = el.querySelectorAll("path, line, polyline, polygon, circle, ellipse, rect");
@@ -2275,7 +2350,7 @@ var AnimatedGraphic = React113__namespace.default.forwardRef(
         p2.style.stroke = strokeColor;
       });
     }, [resolvedSvg, strokeColor]);
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       const el = containerRef.current;
       if (!el || !resolvedSvg) return;
       if (animation === "draw" || animation === "fill") {
@@ -2300,7 +2375,7 @@ var AnimatedGraphic = React113__namespace.default.forwardRef(
         });
       }
     }, [resolvedSvg, animation]);
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       const el = containerRef.current;
       if (!el) return;
       const id = requestAnimationFrame(() => {
@@ -2456,7 +2531,7 @@ var en_default = {
 // hooks/useTranslate.ts
 var { $meta: _meta, ...coreMessages } = en_default;
 var coreLocale = coreMessages;
-var I18nContext = React113.createContext({
+var I18nContext = React114.createContext({
   locale: "en",
   direction: "ltr",
   t: (key) => coreLocale[key] ?? key
@@ -2465,7 +2540,7 @@ var I18nContext = React113.createContext({
 I18nContext.displayName = "I18nContext";
 I18nContext.Provider;
 function useTranslate() {
-  return React113.useContext(I18nContext);
+  return React114.useContext(I18nContext);
 }
 var ErrorState = ({
   title,
@@ -2501,7 +2576,7 @@ var ErrorState = ({
   );
 };
 ErrorState.displayName = "ErrorState";
-var ErrorBoundary = class extends React113__namespace.default.Component {
+var ErrorBoundary = class extends React114__namespace.default.Component {
   constructor(props) {
     super(props);
     __publicField(this, "reset", () => {
@@ -2600,7 +2675,7 @@ function executeNotify(message, options, config) {
 function executeEmit(event, payload, config) {
   config.eventBus.emit(event, payload);
 }
-var ClientEffectConfigContext = React113.createContext(null);
+var ClientEffectConfigContext = React114.createContext(null);
 ClientEffectConfigContext.Provider;
 var effectIdCounter = 0;
 function generateEffectId() {
@@ -2839,14 +2914,14 @@ var OfflineExecutor = class {
   }
 };
 function useOfflineExecutor(options) {
-  const executorRef = React113.useRef(null);
-  const [state, setState] = React113.useState({
+  const executorRef = React114.useRef(null);
+  const [state, setState] = React114.useState({
     isOffline: false,
     syncQueue: [],
     localEffectsProcessed: 0,
     effectsSynced: 0
   });
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     const executor = new OfflineExecutor({
       ...options,
       onQueueChange: (queue) => {
@@ -2861,7 +2936,7 @@ function useOfflineExecutor(options) {
       executorRef.current = null;
     };
   }, []);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!options.autoSync || !options.serverUrl) return;
     const handleOnline = async () => {
       if (executorRef.current) {
@@ -2875,13 +2950,13 @@ function useOfflineExecutor(options) {
     window.addEventListener("online", handleOnline);
     return () => window.removeEventListener("online", handleOnline);
   }, [options.autoSync, options.serverUrl, options.authToken]);
-  const executeEffects = React113.useCallback((effects) => {
+  const executeEffects = React114.useCallback((effects) => {
     executorRef.current?.executeClientEffects(effects);
     if (executorRef.current) {
       setState(executorRef.current.getState());
     }
   }, []);
-  const processEventOffline = React113.useCallback(
+  const processEventOffline = React114.useCallback(
     (event, payload, effects) => {
       const result = executorRef.current?.processEventOffline(event, payload, effects);
       if (executorRef.current) {
@@ -2891,7 +2966,7 @@ function useOfflineExecutor(options) {
     },
     []
   );
-  const sync = React113.useCallback(async () => {
+  const sync = React114.useCallback(async () => {
     if (!executorRef.current || !options.serverUrl) return 0;
     const count = await executorRef.current.syncPendingEffects(
       options.serverUrl,
@@ -2900,7 +2975,7 @@ function useOfflineExecutor(options) {
     setState(executorRef.current.getState());
     return count;
   }, [options.serverUrl, options.authToken]);
-  const clearQueue = React113.useCallback(() => {
+  const clearQueue = React114.useCallback(() => {
     executorRef.current?.clearQueue();
     if (executorRef.current) {
       setState(executorRef.current.getState());
@@ -2916,7 +2991,7 @@ function useOfflineExecutor(options) {
     clearQueue
   };
 }
-React113.createContext(null);
+React114.createContext(null);
 var defaultIcon = L__default.default.icon({
   iconUrl: "https://unpkg.com/leaflet@1.9.4/dist/images/marker-icon.png",
   iconRetinaUrl: "https://unpkg.com/leaflet@1.9.4/dist/images/marker-icon-2x.png",
@@ -3014,7 +3089,7 @@ function getSummary() {
     pending: allChecks.filter((c) => c.status === "pending").length
   };
 }
-function getSnapshot() {
+function getSnapshot2() {
   return {
     checks: getAllChecks(),
     transitions: getTransitions(),
@@ -3030,7 +3105,7 @@ function exposeOnWindow() {
   if (typeof window === "undefined") return;
   if (!window.__orbitalVerification) {
     window.__orbitalVerification = {
-      getSnapshot,
+      getSnapshot: getSnapshot2,
       getChecks: getAllChecks,
       getTransitions,
       getBridge: getBridgeHealth,
@@ -3094,7 +3169,7 @@ function bindTraitStateGetter(getter) {
   }
 }
 exposeOnWindow();
-var MarkdownContent = React113__namespace.default.memo(
+var MarkdownContent = React114__namespace.default.memo(
   ({ content, direction, className }) => {
     const { t: _t } = useTranslate();
     const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -3196,7 +3271,7 @@ var MarkdownContent = React113__namespace.default.memo(
   (prev, next) => prev.content === next.content && prev.className === next.className && prev.direction === next.direction
 );
 MarkdownContent.displayName = "MarkdownContent";
-var CodeBlock = React113__namespace.default.memo(
+var CodeBlock = React114__namespace.default.memo(
   ({
     code: rawCode,
     language = "text",
@@ -3208,20 +3283,20 @@ var CodeBlock = React113__namespace.default.memo(
     const code = typeof rawCode === "string" ? rawCode : String(rawCode ?? "");
     const eventBus = useEventBus();
     const { t: _t } = useTranslate();
-    const scrollRef = React113.useRef(null);
-    const savedScrollLeftRef = React113.useRef(0);
-    const [copied, setCopied] = React113.useState(false);
-    React113.useLayoutEffect(() => {
+    const scrollRef = React114.useRef(null);
+    const savedScrollLeftRef = React114.useRef(0);
+    const [copied, setCopied] = React114.useState(false);
+    React114.useLayoutEffect(() => {
       const el = scrollRef.current;
       return () => {
         if (el) savedScrollLeftRef.current = el.scrollLeft;
       };
     }, [language, code]);
-    React113.useLayoutEffect(() => {
+    React114.useLayoutEffect(() => {
       const el = scrollRef.current;
       if (el) el.scrollLeft = savedScrollLeftRef.current;
     }, [language, code]);
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       const el = scrollRef.current;
       if (!el) return;
       const handle = () => {
@@ -3307,18 +3382,18 @@ CodeBlock.displayName = "CodeBlock";
 
 // lib/debug.ts
 typeof window !== "undefined" && (localStorage.getItem("debug") === "true" || process.env.NODE_ENV === "development");
-React113.lazy(() => import('react-markdown'));
-var GameAudioContext = React113.createContext(null);
+React114.lazy(() => import('react-markdown'));
+var GameAudioContext = React114.createContext(null);
 GameAudioContext.displayName = "GameAudioContext";
 
 // components/organisms/component-registry.generated.ts
 function lazyThree(name, loader) {
-  const Lazy = React113__namespace.default.lazy(() => loader().then((m) => ({ default: m[name] })));
+  const Lazy = React114__namespace.default.lazy(() => loader().then((m) => ({ default: m[name] })));
   function ThreeWrapper(props) {
-    return React113__namespace.default.createElement(
-      React113__namespace.default.Suspense,
+    return React114__namespace.default.createElement(
+      React114__namespace.default.Suspense,
       { fallback: null },
-      React113__namespace.default.createElement(Lazy, props)
+      React114__namespace.default.createElement(Lazy, props)
     );
   }
   ThreeWrapper.displayName = `Lazy(${name})`;
@@ -3339,13 +3414,13 @@ lazyThree("PhysicsObject3D", () => import('@almadar/ui/components/organisms/game
 lazyThree("Scene3D", () => import('@almadar/ui/components/organisms/game/three'));
 lazyThree("TileRenderer", () => import('@almadar/ui/components/organisms/game/three'));
 lazyThree("UnitRenderer", () => import('@almadar/ui/components/organisms/game/three'));
-var SuspenseConfigContext = React113.createContext({ enabled: false });
-React113.createContext(false);
+var SuspenseConfigContext = React114.createContext({ enabled: false });
+React114.createContext(false);
 function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React113__namespace.default.createElement(
+  return React114__namespace.default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -3390,8 +3465,8 @@ function VerificationProvider({
 }) {
   const isEnabled = enabled ?? (typeof process !== "undefined" && process.env?.NODE_ENV !== "production");
   const eventBus = useEventBus();
-  const pendingRef = React113.useRef(/* @__PURE__ */ new Map());
-  React113.useEffect(() => {
+  const pendingRef = React114.useRef(/* @__PURE__ */ new Map());
+  React114.useEffect(() => {
     if (!isEnabled) return;
     if (!eventBus.onAny) return;
     const unsub = eventBus.onAny((evt) => {
@@ -3487,7 +3562,7 @@ function VerificationProvider({
     );
     return unsub;
   }, [isEnabled, eventBus]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!isEnabled) return;
     if (!runtimeManager) return;
     runtimeManager.setObserver({
@@ -3509,11 +3584,11 @@ function VerificationProvider({
       "pass"
     );
   }, [isEnabled, runtimeManager]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!isEnabled) return;
     bindEventBus(eventBus);
   }, [isEnabled, eventBus]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!isEnabled) return;
     if (traitStateGetter) {
       bindTraitStateGetter(traitStateGetter);
@@ -3537,11 +3612,11 @@ function OrbitalProvider({
   suspense = false,
   verification
 }) {
-  const suspenseConfig = React113.useMemo(
+  const suspenseConfig = React114.useMemo(
     () => ({ enabled: suspense }),
     [suspense]
   );
-  const inner = /* @__PURE__ */ jsxRuntime.jsx(EventBusProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsxRuntime.jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) });
+  const inner = /* @__PURE__ */ jsxRuntime.jsx(EntityStoreProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(EventBusProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsxRuntime.jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) }) });
   if (skipTheme) {
     return inner;
   }
@@ -3557,43 +3632,43 @@ function OrbitalProvider({
   );
 }
 OrbitalProvider.displayName = "OrbitalProvider";
-var FetchedDataContext = React113.createContext(null);
+var FetchedDataContext = React114.createContext(null);
 function FetchedDataProvider({
   initialData,
   children
 }) {
-  const [state, setState] = React113.useState(() => ({
+  const [state, setState] = React114.useState(() => ({
     data: initialData || {},
     fetchedAt: {},
     loading: false,
     error: null
   }));
-  const getData = React113.useCallback(
+  const getData = React114.useCallback(
     (entityName) => {
       return state.data[entityName] || [];
     },
     [state.data]
   );
-  const getById = React113.useCallback(
+  const getById = React114.useCallback(
     (entityName, id) => {
       const records = state.data[entityName];
       return records?.find((r) => r.id === id);
     },
     [state.data]
   );
-  const hasData = React113.useCallback(
+  const hasData = React114.useCallback(
     (entityName) => {
       return entityName in state.data && state.data[entityName].length > 0;
     },
     [state.data]
   );
-  const getFetchedAt = React113.useCallback(
+  const getFetchedAt = React114.useCallback(
     (entityName) => {
       return state.fetchedAt[entityName];
     },
     [state.fetchedAt]
   );
-  const setData = React113.useCallback((data) => {
+  const setData = React114.useCallback((data) => {
     const now = Date.now();
     setState((prev) => ({
       ...prev,
@@ -3612,14 +3687,14 @@ function FetchedDataProvider({
       error: null
     }));
   }, []);
-  const clearData = React113.useCallback(() => {
+  const clearData = React114.useCallback(() => {
     setState((prev) => ({
       ...prev,
       data: {},
       fetchedAt: {}
     }));
   }, []);
-  const clearEntity = React113.useCallback((entityName) => {
+  const clearEntity = React114.useCallback((entityName) => {
     setState((prev) => {
       const newData = { ...prev.data };
       const newFetchedAt = { ...prev.fetchedAt };
@@ -3632,13 +3707,13 @@ function FetchedDataProvider({
       };
     });
   }, []);
-  const setLoading = React113.useCallback((loading) => {
+  const setLoading = React114.useCallback((loading) => {
     setState((prev) => ({ ...prev, loading }));
   }, []);
-  const setError = React113.useCallback((error) => {
+  const setError = React114.useCallback((error) => {
     setState((prev) => ({ ...prev, error, loading: false }));
   }, []);
-  const contextValue = React113.useMemo(
+  const contextValue = React114.useMemo(
     () => ({
       getData,
       getById,
@@ -3669,10 +3744,10 @@ function FetchedDataProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(FetchedDataContext.Provider, { value: contextValue, children });
 }
 function useFetchedDataContext() {
-  return React113.useContext(FetchedDataContext);
+  return React114.useContext(FetchedDataContext);
 }
 function useFetchedData() {
-  const context = React113.useContext(FetchedDataContext);
+  const context = React114.useContext(FetchedDataContext);
   if (!context) {
     return {
       getData: () => [],
@@ -3712,15 +3787,15 @@ function useFetchedEntity(entityName) {
     error: context.error
   };
 }
-var OfflineModeContext = React113.createContext(null);
+var OfflineModeContext = React114.createContext(null);
 function OfflineModeProvider({
   children,
   ...executorOptions
 }) {
-  const [forceOffline, setForceOffline] = React113.useState(false);
+  const [forceOffline, setForceOffline] = React114.useState(false);
   const executor = useOfflineExecutor(executorOptions);
   const effectivelyOffline = executor.isOffline || forceOffline;
-  const contextValue = React113.useMemo(
+  const contextValue = React114.useMemo(
     () => ({
       ...executor,
       forceOffline,
@@ -3732,16 +3807,18 @@ function OfflineModeProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(OfflineModeContext.Provider, { value: contextValue, children });
 }
 function useOfflineMode() {
-  const context = React113.useContext(OfflineModeContext);
+  const context = React114.useContext(OfflineModeContext);
   if (!context) {
     throw new Error("useOfflineMode must be used within OfflineModeProvider");
   }
   return context;
 }
 function useOptionalOfflineMode() {
-  return React113.useContext(OfflineModeContext);
+  return React114.useContext(OfflineModeContext);
 }
 
+exports.EntityStoreContext = EntityStoreContext;
+exports.EntityStoreProvider = EntityStoreProvider;
 exports.EventBusContext = EventBusContext2;
 exports.EventBusProvider = EventBusProvider;
 exports.FetchedDataContext = FetchedDataContext;
@@ -3751,6 +3828,9 @@ exports.OrbitalProvider = OrbitalProvider;
 exports.SelectionContext = SelectionContext;
 exports.SelectionProvider = SelectionProvider;
 exports.VerificationProvider = VerificationProvider;
+exports.useEntityRef = useEntityRef;
+exports.useEntityStore = useEntityStore;
+exports.useEntityWatch = useEntityWatch;
 exports.useFetchedData = useFetchedData;
 exports.useFetchedDataContext = useFetchedDataContext;
 exports.useFetchedEntity = useFetchedEntity;