@almadar/ui 2.42.0 → 2.45.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');
@@ -58,7 +58,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);
@@ -186,7 +186,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() {
@@ -206,14 +206,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 = [
@@ -225,7 +225,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") {
@@ -233,14 +233,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));
     };
@@ -253,7 +253,7 @@ var ThemeProvider = ({
     }
     return void 0;
   }, [mode]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (isScoped) {
       if (targetRef?.current) {
         targetRef.current.setAttribute("data-theme", appliedTheme);
@@ -267,7 +267,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) {
@@ -283,17 +283,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 contextValue2 = React114.useMemo(
     () => ({
       theme,
       mode,
@@ -315,30 +315,97 @@ var ThemeProvider = ({
       appliedTheme
     ]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(ThemeContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(ThemeContext.Provider, { value: contextValue2, 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 });
+function extractId(record) {
+  const r = record;
+  return String(r.id ?? r._id ?? r.key ?? "");
+}
+function materialize(snap) {
+  return snap.ids.map((id) => snap.entities.get(id));
+}
+function notifyListeners(entityType, prev) {
   for (const listener of storeListeners) {
     listener();
   }
   const cbs = watchCallbacks.get(entityType);
   if (cbs) {
+    const oldData = prev ? materialize(prev) : [];
+    const cur = store.get(entityType);
+    const newData = cur ? materialize(cur) : [];
     for (const cb of cbs) {
       try {
-        cb(oldData, data);
+        cb(oldData, newData);
       } catch {
       }
     }
   }
 }
+function setAll(entityType, records) {
+  const entities = /* @__PURE__ */ new Map();
+  const ids = [];
+  for (const r of records) {
+    const rec = r;
+    const id = extractId(rec);
+    if (id) {
+      entities.set(id, rec);
+      ids.push(id);
+    }
+  }
+  const prev = store.get(entityType);
+  store.set(entityType, { entities, ids, version: (prev?.version ?? 0) + 1 });
+  notifyListeners(entityType, prev);
+}
+function upsertOne(entityType, record) {
+  const id = extractId(record);
+  if (!id) return;
+  const prev = store.get(entityType);
+  const snapshot = prev ? { entities: new Map(prev.entities), ids: [...prev.ids], version: prev.version } : { entities: /* @__PURE__ */ new Map(), ids: [], version: 0 };
+  snapshot.entities.set(id, record);
+  if (!snapshot.ids.includes(id)) snapshot.ids.push(id);
+  snapshot.version++;
+  store.set(entityType, snapshot);
+  notifyListeners(entityType, prev);
+}
+function addOne(entityType, record) {
+  upsertOne(entityType, record);
+}
+function updateOne(entityType, id, changes) {
+  const prev = store.get(entityType);
+  if (!prev?.entities.has(id)) return;
+  const snapshot = {
+    entities: new Map(prev.entities),
+    ids: [...prev.ids],
+    version: prev.version
+  };
+  snapshot.entities.set(id, { ...snapshot.entities.get(id), ...changes });
+  snapshot.version++;
+  store.set(entityType, snapshot);
+  notifyListeners(entityType, prev);
+}
+function removeOne(entityType, id) {
+  const prev = store.get(entityType);
+  if (!prev) return;
+  const snapshot = {
+    entities: new Map(prev.entities),
+    ids: prev.ids.filter((i) => i !== id),
+    version: prev.version
+  };
+  snapshot.entities.delete(id);
+  snapshot.version++;
+  store.set(entityType, snapshot);
+  notifyListeners(entityType, prev);
+}
 function getSnapshot(entityType) {
-  return store.get(entityType)?.data ?? [];
+  const snap = store.get(entityType);
+  if (!snap) return [];
+  return materialize(snap);
+}
+function getById(entityType, id) {
+  return store.get(entityType)?.entities.get(id) ?? null;
 }
 function getVersion(entityType) {
   return store.get(entityType)?.version ?? 0;
@@ -361,9 +428,9 @@ function addWatch(entityType, callback) {
   };
 }
 function useEntityRef(entityType) {
-  const versionRef = React113.useRef(0);
-  const dataRef = React113.useRef([]);
-  const getSnapshotStable = React113__namespace.default.useCallback(() => {
+  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;
@@ -371,26 +438,46 @@ function useEntityRef(entityType) {
     }
     return dataRef.current;
   }, [entityType]);
-  return React113.useSyncExternalStore(subscribeToStore, getSnapshotStable, () => []);
+  return React114.useSyncExternalStore(subscribeToStore, getSnapshotStable, () => []);
+}
+function useEntityById(entityType, id) {
+  const versionRef = React114.useRef(0);
+  const dataRef = React114.useRef(null);
+  const getSnapshotStable = React114__namespace.default.useCallback(() => {
+    if (!id) return null;
+    const currentVersion = getVersion(entityType);
+    if (currentVersion !== versionRef.current) {
+      versionRef.current = currentVersion;
+      dataRef.current = getById(entityType, id);
+    }
+    return dataRef.current;
+  }, [entityType, id]);
+  return React114.useSyncExternalStore(subscribeToStore, getSnapshotStable, () => null);
 }
 function useEntityWatch(entityType, callback) {
-  const callbackRef = React113.useRef(callback);
+  const callbackRef = React114.useRef(callback);
   callbackRef.current = callback;
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     return addWatch(entityType, (oldData, newData) => {
       callbackRef.current(oldData, newData);
     });
   }, [entityType]);
 }
-var EntityStoreContext = React113.createContext({
-  advance,
-  getSnapshot
-});
+var contextValue = {
+  setAll,
+  upsertOne,
+  addOne,
+  updateOne,
+  removeOne,
+  getSnapshot,
+  getById
+};
+var EntityStoreContext = React114.createContext(contextValue);
 function useEntityStore() {
-  return React113.useContext(EntityStoreContext);
+  return React114.useContext(EntityStoreContext);
 }
 function EntityStoreProvider({ children }) {
-  return /* @__PURE__ */ jsxRuntime.jsx(EntityStoreContext.Provider, { value: { advance, getSnapshot }, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(EntityStoreContext.Provider, { value: contextValue, children });
 }
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
@@ -464,15 +551,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."
@@ -481,7 +568,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."
@@ -489,7 +576,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,
@@ -523,7 +610,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());
     }
@@ -542,18 +629,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}`);
@@ -565,7 +652,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       }
     };
   }, [debug2]);
-  const contextValue = React113.useMemo(
+  const contextValue2 = React114.useMemo(
     () => ({
       emit,
       on,
@@ -577,15 +664,15 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }),
     [emit, on, once, hasListeners, onAny, getSelectedEntity, clearSelectedEntity]
   );
-  React113.useEffect(() => {
-    setGlobalEventBus(contextValue);
+  React114.useEffect(() => {
+    setGlobalEventBus(contextValue2);
     return () => {
       setGlobalEventBus(null);
     };
-  }, [contextValue]);
-  return /* @__PURE__ */ jsxRuntime.jsx(EventBusContext2.Provider, { value: contextValue, children });
+  }, [contextValue2]);
+  return /* @__PURE__ */ jsxRuntime.jsx(EventBusContext2.Provider, { value: contextValue2, 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;
@@ -602,8 +689,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) {
@@ -612,19 +699,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) {
@@ -653,25 +740,26 @@ function SelectionProvider({
       unsubCancel();
     };
   }, [eventBus, setSelected, clearSelection, debug2]);
-  const contextValue = {
+  const contextValue2 = {
     selected,
     setSelected,
     clearSelection,
     isSelected
   };
-  return /* @__PURE__ */ jsxRuntime.jsx(SelectionContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(SelectionContext.Provider, { value: contextValue2, 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;
 }
+React114.createContext(null);
 function cn(...inputs) {
   return tailwindMerge.twMerge(clsx.clsx(inputs));
 }
@@ -812,7 +900,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React113__namespace.default.forwardRef(
+var Box = React114__namespace.default.forwardRef(
   ({
     padding,
     paddingX,
@@ -841,20 +929,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 });
       }
@@ -1083,7 +1171,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) {
@@ -1092,7 +1180,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React113__namespace.default.forwardRef(
+var Button = React114__namespace.default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -1188,7 +1276,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" ? (() => {
@@ -1215,7 +1303,7 @@ var Badge = React113__namespace.default.forwardRef(
   }
 );
 Badge.displayName = "Badge";
-var Input = React113__namespace.default.forwardRef(
+var Input = React114__namespace.default.forwardRef(
   ({
     className,
     inputType,
@@ -1327,7 +1415,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",
@@ -1347,7 +1435,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",
@@ -1370,7 +1458,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(
@@ -1406,7 +1494,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: [
@@ -1482,7 +1570,7 @@ var shadowStyles2 = {
   md: "shadow",
   lg: "shadow-lg"
 };
-var Card = React113__namespace.default.forwardRef(
+var Card = React114__namespace.default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -1518,9 +1606,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,
@@ -1533,11 +1621,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,
@@ -1552,7 +1640,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",
@@ -1566,7 +1654,7 @@ var Spinner = React113__namespace.default.forwardRef(
   }
 );
 Spinner.displayName = "Spinner";
-var Radio = React113__namespace.default.forwardRef(
+var Radio = React114__namespace.default.forwardRef(
   ({
     label,
     helperText,
@@ -1670,7 +1758,7 @@ var Radio = React113__namespace.default.forwardRef(
   }
 );
 Radio.displayName = "Radio";
-var Switch = React113__namespace.forwardRef(
+var Switch = React114__namespace.forwardRef(
   ({
     checked,
     defaultChecked = false,
@@ -1681,10 +1769,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);
       }
@@ -1842,7 +1930,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",
@@ -1889,7 +1977,7 @@ var iconMap2 = {
   down: LucideIcons.TrendingDown,
   flat: LucideIcons.ArrowRight
 };
-var TrendIndicator = React113__namespace.default.forwardRef(
+var TrendIndicator = React114__namespace.default.forwardRef(
   ({
     className,
     value,
@@ -1948,7 +2036,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,
@@ -1966,14 +2054,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);
@@ -2151,7 +2239,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,
@@ -2190,7 +2278,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",
@@ -2205,10 +2293,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);
@@ -2216,7 +2304,7 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
       },
       [forwardedRef]
     );
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       if (trigger !== "scroll") return;
       const el = internalRef.current;
       if (!el) return;
@@ -2242,7 +2330,7 @@ var AnimatedReveal = React113__namespace.default.forwardRef(
         setIsAnimated(false);
       }
     } : void 0;
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       if (trigger === "manual" && manualAnimate !== void 0) {
         setIsAnimated(manualAnimate);
       }
@@ -2272,9 +2360,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;
@@ -2343,7 +2431,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,
@@ -2362,11 +2450,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);
@@ -2374,7 +2462,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");
@@ -2382,7 +2470,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") {
@@ -2407,7 +2495,7 @@ var AnimatedGraphic = React113__namespace.default.forwardRef(
         });
       }
     }, [resolvedSvg, animation]);
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       const el = containerRef.current;
       if (!el) return;
       const id = requestAnimationFrame(() => {
@@ -2563,7 +2651,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
@@ -2572,7 +2660,7 @@ var I18nContext = React113.createContext({
 I18nContext.displayName = "I18nContext";
 I18nContext.Provider;
 function useTranslate() {
-  return React113.useContext(I18nContext);
+  return React114.useContext(I18nContext);
 }
 var ErrorState = ({
   title,
@@ -2608,7 +2696,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", () => {
@@ -2707,7 +2795,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() {
@@ -2946,14 +3034,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) => {
@@ -2968,7 +3056,7 @@ function useOfflineExecutor(options) {
       executorRef.current = null;
     };
   }, []);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!options.autoSync || !options.serverUrl) return;
     const handleOnline = async () => {
       if (executorRef.current) {
@@ -2982,13 +3070,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) {
@@ -2998,7 +3086,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,
@@ -3007,7 +3095,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());
@@ -3023,7 +3111,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",
@@ -3052,13 +3140,13 @@ function getState() {
   }
   return { checks: /* @__PURE__ */ new Map(), transitions: [], bridgeHealth: null, listeners: /* @__PURE__ */ new Set() };
 }
-function notifyListeners() {
+function notifyListeners2() {
   getState().listeners.forEach((l) => l());
   exposeOnWindow();
 }
 function registerCheck(id, label, status = "pending", details) {
   getState().checks.set(id, { id, label, status, details, updatedAt: Date.now() });
-  notifyListeners();
+  notifyListeners2();
 }
 function getAllChecks() {
   return Array.from(getState().checks.values());
@@ -3102,7 +3190,7 @@ function recordTransition(trace) {
       failedEffects.map((e) => `${e.type}: ${e.error}`).join("; ")
     );
   }
-  notifyListeners();
+  notifyListeners2();
 }
 function getTransitions() {
   return [...getState().transitions];
@@ -3201,7 +3289,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 ?? "");
@@ -3267,7 +3355,7 @@ var MarkdownContent = React113__namespace.default.memo(
                   "th",
                   {
                     ...props,
-                    className: "border border-gray-300 dark:border-gray-600 bg-gray-100 dark:bg-gray-800 px-4 py-2 text-left font-semibold",
+                    className: "border border-gray-300 dark:border-gray-600 bg-[var(--color-muted)] px-4 py-2 text-left font-semibold",
                     children
                   }
                 );
@@ -3348,13 +3436,50 @@ var orbStyleOverrides = {
   "orb-op-async": { color: syntax.ORB_COLORS.dark.async }
 };
 var orbStyle = { ...dark__default.default, ...orbStyleOverrides };
-var CodeBlock = React113__namespace.default.memo(
+function computeFoldRegions(code) {
+  const lines = code.split("\n");
+  const regions = [];
+  const stack = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    let inString = false;
+    for (let j = 0; j < line.length; j++) {
+      const ch = line[j];
+      if (ch === "\\" && inString) {
+        j++;
+        continue;
+      }
+      if (ch === '"') {
+        inString = !inString;
+        continue;
+      }
+      if (inString) continue;
+      if (ch === "{" || ch === "[") {
+        stack.push({ line: i, bracket: ch });
+      } else if (ch === "}" || ch === "]") {
+        const open = stack.pop();
+        if (open && open.line < i) {
+          regions.push({
+            start: open.line,
+            end: i,
+            closeBracket: ch
+          });
+        }
+      }
+    }
+  }
+  return regions.sort((a, b) => a.start - b.start);
+}
+var LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
+var HIDDEN_LINE_NUMBERS = { display: "none" };
+var CodeBlock = React114__namespace.default.memo(
   ({
     code: rawCode,
     language = "text",
     showCopyButton = true,
     showLanguageBadge = true,
     maxHeight = "60vh",
+    foldable: foldableProp,
     className
   }) => {
     const code = typeof rawCode === "string" ? rawCode : String(rawCode ?? "");
@@ -3362,20 +3487,126 @@ var CodeBlock = React113__namespace.default.memo(
     const activeStyle = isOrb ? orbStyle : dark__default.default;
     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 codeRef = React114.useRef(null);
+    const savedScrollLeftRef = React114.useRef(0);
+    const [copied, setCopied] = React114.useState(false);
+    const isFoldable = foldableProp ?? (language === "orb" || language === "json");
+    const [collapsed, setCollapsed] = React114.useState(() => /* @__PURE__ */ new Set());
+    const foldRegions = React114.useMemo(
+      () => isFoldable ? computeFoldRegions(code) : [],
+      [code, isFoldable]
+    );
+    const foldStartMap = React114.useMemo(() => {
+      const m = /* @__PURE__ */ new Map();
+      for (const r of foldRegions) m.set(r.start, r);
+      return m;
+    }, [foldRegions]);
+    const hiddenLines = React114.useMemo(() => {
+      const h = /* @__PURE__ */ new Set();
+      for (const r of foldRegions) {
+        if (!collapsed.has(r.start)) continue;
+        for (let i = r.start + 1; i <= r.end; i++) h.add(i);
+      }
+      return h;
+    }, [foldRegions, collapsed]);
+    const collapsedRef = React114.useRef(collapsed);
+    collapsedRef.current = collapsed;
+    const foldStartMapRef = React114.useRef(foldStartMap);
+    foldStartMapRef.current = foldStartMap;
+    const toggleFold = React114.useCallback((lineNum) => {
+      setCollapsed((prev) => {
+        const next = new Set(prev);
+        if (next.has(lineNum)) next.delete(lineNum);
+        else next.add(lineNum);
+        return next;
+      });
+    }, []);
+    const toggleFoldRef = React114.useRef(toggleFold);
+    toggleFoldRef.current = toggleFold;
+    React114.useEffect(() => {
+      setCollapsed(/* @__PURE__ */ new Set());
+    }, [code]);
+    const highlightedElement = React114.useMemo(
+      () => /* @__PURE__ */ jsxRuntime.jsx(
+        SyntaxHighlighter__default.default,
+        {
+          PreTag: "div",
+          language,
+          style: activeStyle,
+          wrapLines: true,
+          showLineNumbers: true,
+          showInlineLineNumbers: false,
+          lineNumberContainerStyle: HIDDEN_LINE_NUMBERS,
+          lineProps: LINE_PROPS_FN,
+          customStyle: {
+            backgroundColor: "transparent",
+            borderRadius: 0,
+            padding: 0,
+            margin: 0,
+            whiteSpace: "pre",
+            minWidth: "100%"
+          },
+          children: code
+        }
+      ),
+      [code, language, activeStyle]
+    );
+    React114.useLayoutEffect(() => {
+      const container = codeRef.current;
+      if (!container) return;
+      container.querySelectorAll(".fold-toggle, .fold-summary").forEach((el) => el.remove());
+      const lineEls = container.querySelectorAll("[data-line]");
+      if (!isFoldable || foldRegions.length === 0) {
+        lineEls.forEach((el) => {
+          el.style.display = "";
+          el.style.position = "";
+          el.style.paddingLeft = "";
+        });
+        return;
+      }
+      lineEls.forEach((el) => {
+        const num = parseInt(el.getAttribute("data-line") ?? "-1", 10);
+        if (hiddenLines.has(num)) {
+          el.style.display = "none";
+          return;
+        }
+        el.style.display = "";
+        el.style.position = "relative";
+        el.style.paddingLeft = "1.2em";
+        const region = foldStartMap.get(num);
+        if (!region) return;
+        const isCollapsed = collapsed.has(num);
+        const toggle = document.createElement("span");
+        toggle.className = "fold-toggle";
+        toggle.textContent = isCollapsed ? "\u25B6" : "\u25BC";
+        toggle.style.cssText = "position:absolute;left:0;top:0;width:1.2em;text-align:center;cursor:pointer;color:#858585;font-size:10px;user-select:none;line-height:inherit;height:100%";
+        toggle.addEventListener("click", (e) => {
+          e.stopPropagation();
+          toggleFoldRef.current(num);
+        });
+        el.insertBefore(toggle, el.firstChild);
+        if (isCollapsed) {
+          const summary = document.createElement("span");
+          summary.className = "fold-summary";
+          summary.style.cssText = "color:#858585;font-style:italic";
+          const count = region.end - region.start - 1;
+          summary.textContent = ` ... ${count} line${count !== 1 ? "s" : ""} ${region.closeBracket}`;
+          el.appendChild(summary);
+        }
+      });
+    }, [collapsed, hiddenLines, foldStartMap, foldRegions, isFoldable]);
+    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 = () => {
@@ -3395,13 +3626,14 @@ var CodeBlock = React113__namespace.default.memo(
         eventBus.emit("UI:COPY_CODE", { language, success: false });
       }
     };
+    const hasHeader = showLanguageBadge || showCopyButton;
     return /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: `relative group ${className || ""}`, children: [
-      (showLanguageBadge || showCopyButton) && /* @__PURE__ */ jsxRuntime.jsxs(
+      hasHeader && /* @__PURE__ */ jsxRuntime.jsxs(
         HStack,
         {
           justify: "between",
           align: "center",
-          className: "px-3 py-2 bg-gray-800 rounded-t-lg border-b border-gray-700",
+          className: "px-3 py-2 bg-[var(--color-card)] rounded-t-lg border-b border-gray-700",
           children: [
             showLanguageBadge && /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "default", size: "sm", children: language }),
             showCopyButton && /* @__PURE__ */ jsxRuntime.jsx(
@@ -3431,48 +3663,31 @@ var CodeBlock = React113__namespace.default.memo(
             touchAction: "pan-x pan-y",
             contain: "paint",
             backgroundColor: "#1e1e1e",
-            borderRadius: showLanguageBadge || showCopyButton ? "0 0 0.5rem 0.5rem" : "0.5rem",
-            padding: "1rem"
+            borderRadius: hasHeader ? "0 0 0.5rem 0.5rem" : "0.5rem"
           },
-          children: /* @__PURE__ */ jsxRuntime.jsx(
-            SyntaxHighlighter__default.default,
-            {
-              PreTag: "div",
-              language,
-              style: activeStyle,
-              customStyle: {
-                backgroundColor: "transparent",
-                borderRadius: 0,
-                padding: 0,
-                margin: 0,
-                whiteSpace: "pre",
-                minWidth: "100%"
-              },
-              children: code
-            }
-          )
+          children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: codeRef, style: { padding: "1rem" }, children: highlightedElement })
         }
       )
     ] });
   },
-  (prev, next) => prev.language === next.language && prev.code === next.code && prev.showCopyButton === next.showCopyButton && prev.maxHeight === next.maxHeight
+  (prev, next) => prev.language === next.language && prev.code === next.code && prev.showCopyButton === next.showCopyButton && prev.maxHeight === next.maxHeight && prev.foldable === next.foldable
 );
 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})`;
@@ -3493,13 +3708,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
@@ -3544,8 +3759,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) => {
@@ -3641,7 +3856,7 @@ function VerificationProvider({
     );
     return unsub;
   }, [isEnabled, eventBus]);
-  React113.useEffect(() => {
+  React114.useEffect(() => {
     if (!isEnabled) return;
     if (!runtimeManager) return;
     runtimeManager.setObserver({
@@ -3663,11 +3878,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);
@@ -3691,7 +3906,7 @@ function OrbitalProvider({
   suspense = false,
   verification
 }) {
-  const suspenseConfig = React113.useMemo(
+  const suspenseConfig = React114.useMemo(
     () => ({ enabled: suspense }),
     [suspense]
   );
@@ -3711,43 +3926,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 getById2 = 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,
@@ -3766,14 +3981,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 };
@@ -3786,16 +4001,16 @@ 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 contextValue2 = React114.useMemo(
     () => ({
       getData,
-      getById,
+      getById: getById2,
       hasData,
       getFetchedAt,
       setData,
@@ -3808,7 +4023,7 @@ function FetchedDataProvider({
     }),
     [
       getData,
-      getById,
+      getById2,
       hasData,
       getFetchedAt,
       setData,
@@ -3820,13 +4035,13 @@ function FetchedDataProvider({
       setError
     ]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(FetchedDataContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(FetchedDataContext.Provider, { value: contextValue2, 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: () => [],
@@ -3866,15 +4081,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 contextValue2 = React114.useMemo(
     () => ({
       ...executor,
       forceOffline,
@@ -3883,17 +4098,17 @@ function OfflineModeProvider({
     }),
     [executor, forceOffline, effectivelyOffline]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(OfflineModeContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(OfflineModeContext.Provider, { value: contextValue2, 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;
@@ -3907,6 +4122,7 @@ exports.OrbitalProvider = OrbitalProvider;
 exports.SelectionContext = SelectionContext;
 exports.SelectionProvider = SelectionProvider;
 exports.VerificationProvider = VerificationProvider;
+exports.useEntityById = useEntityById;
 exports.useEntityRef = useEntityRef;
 exports.useEntityStore = useEntityStore;
 exports.useEntityWatch = useEntityWatch;