@almadar/ui 1.0.30 → 1.0.31

package/dist/{ThemeContext-lI5bo85E.d.ts → ThemeContext-D9xUORq5.d.ts}

@@ -56,6 +56,8 @@ interface ThemeProviderProps {
     defaultTheme?: string;
     /** Default color mode */
     defaultMode?: ColorMode;
+    /** Optional target element ref — when provided, theme attributes are applied to this element instead of document.documentElement */
+    targetRef?: React__default.RefObject<HTMLElement>;
 }
 /**
  * Unified ThemeProvider component

package/dist/{chunk-4UFNDD6B.js → chunk-LRI6C6UI.js}

@@ -118,7 +118,8 @@ var ThemeProvider = ({
   children,
   themes = [],
   defaultTheme = "wireframe",
-  defaultMode = "system"
+  defaultMode = "system",
+  targetRef
 }) => {
   const availableThemes = useMemo(() => {
     const themeMap = /* @__PURE__ */ new Map();
@@ -126,8 +127,9 @@ var ThemeProvider = ({
     themes.forEach((t) => themeMap.set(t.name, t));
     return Array.from(themeMap.values());
   }, [themes]);
+  const isScoped = !!targetRef;
   const [theme, setThemeState] = useState(() => {
-    if (typeof window === "undefined") return defaultTheme;
+    if (isScoped || typeof window === "undefined") return defaultTheme;
     const stored = localStorage.getItem(THEME_STORAGE_KEY);
     const validThemes = [
       ...BUILT_IN_THEMES.map((t) => t.name),
@@ -139,7 +141,7 @@ var ThemeProvider = ({
     return defaultTheme;
   });
   const [mode, setModeState] = useState(() => {
-    if (typeof window === "undefined") return defaultMode;
+    if (isScoped || typeof window === "undefined") return defaultMode;
     const stored = localStorage.getItem(MODE_STORAGE_KEY);
     if (stored === "light" || stored === "dark" || stored === "system") {
       return stored;
@@ -167,17 +169,25 @@ var ThemeProvider = ({
     return void 0;
   }, [mode]);
   useEffect(() => {
+    if (isScoped) {
+      if (targetRef?.current) {
+        targetRef.current.setAttribute("data-theme", appliedTheme);
+        targetRef.current.classList.remove("light", "dark");
+        targetRef.current.classList.add(resolvedMode);
+      }
+      return;
+    }
     const root = document.documentElement;
     root.setAttribute("data-theme", appliedTheme);
     root.classList.remove("light", "dark");
     root.classList.add(resolvedMode);
-  }, [appliedTheme, resolvedMode]);
+  }, [appliedTheme, resolvedMode, targetRef, isScoped]);
   const setTheme = useCallback(
     (newTheme) => {
       const validTheme = availableThemes.find((t) => t.name === newTheme);
       if (validTheme) {
         setThemeState(newTheme);
-        if (typeof window !== "undefined") {
+        if (!isScoped && typeof window !== "undefined") {
           localStorage.setItem(THEME_STORAGE_KEY, newTheme);
         }
       } else {
@@ -190,7 +200,7 @@ var ThemeProvider = ({
   );
   const setMode = useCallback((newMode) => {
     setModeState(newMode);
-    if (typeof window !== "undefined") {
+    if (!isScoped && typeof window !== "undefined") {
       localStorage.setItem(MODE_STORAGE_KEY, newMode);
     }
   }, []);

package/dist/chunk-RUGU4MSK.js

@@ -0,0 +1,186 @@
+import { createContext, useContext, useRef, useEffect, useCallback, useMemo } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// providers/EventBusProvider.tsx
+function setGlobalEventBus(bus) {
+  if (typeof window !== "undefined") {
+    window.__kflowEventBus = bus;
+  }
+}
+function getGlobalEventBus() {
+  if (typeof window !== "undefined") {
+    return window.__kflowEventBus ?? null;
+  }
+  return null;
+}
+var fallbackListeners = /* @__PURE__ */ new Map();
+var fallbackEventBus = {
+  emit: (type, payload) => {
+    const event = {
+      type,
+      payload,
+      timestamp: Date.now()
+    };
+    const handlers = fallbackListeners.get(type);
+    if (handlers) {
+      handlers.forEach((handler) => {
+        try {
+          handler(event);
+        } catch (error) {
+          console.error(`[EventBus] Error in listener for '${type}':`, error);
+        }
+      });
+    }
+  },
+  on: (type, listener) => {
+    if (!fallbackListeners.has(type)) {
+      fallbackListeners.set(type, /* @__PURE__ */ new Set());
+    }
+    fallbackListeners.get(type).add(listener);
+    return () => {
+      const handlers = fallbackListeners.get(type);
+      if (handlers) {
+        handlers.delete(listener);
+        if (handlers.size === 0) {
+          fallbackListeners.delete(type);
+        }
+      }
+    };
+  },
+  once: (type, listener) => {
+    const wrappedListener = (event) => {
+      fallbackListeners.get(type)?.delete(wrappedListener);
+      listener(event);
+    };
+    return fallbackEventBus.on(type, wrappedListener);
+  },
+  hasListeners: (type) => {
+    const handlers = fallbackListeners.get(type);
+    return handlers !== void 0 && handlers.size > 0;
+  }
+};
+function useEventBus() {
+  const context = useContext(EventBusContext);
+  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+}
+function useEventListener(event, handler) {
+  const eventBus = useEventBus();
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+  useEffect(() => {
+    const wrappedHandler = (evt) => {
+      handlerRef.current(evt);
+    };
+    const unsub = eventBus.on(event, wrappedHandler);
+    return () => {
+      if (typeof unsub === "function") unsub();
+    };
+  }, [event, eventBus]);
+}
+function useEmitEvent() {
+  const eventBus = useEventBus();
+  return useCallback(
+    (type, payload) => {
+      eventBus.emit(type, payload);
+    },
+    [eventBus]
+  );
+}
+var EventBusContext = createContext(null);
+function EventBusProvider({ children, debug = false }) {
+  const listenersRef = useRef(/* @__PURE__ */ new Map());
+  const deprecationWarningShown = useRef(false);
+  const getSelectedEntity = useCallback(() => {
+    if (!deprecationWarningShown.current) {
+      console.warn(
+        "[EventBus] getSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
+      );
+      deprecationWarningShown.current = true;
+    }
+    return null;
+  }, []);
+  const clearSelectedEntity = useCallback(() => {
+    if (!deprecationWarningShown.current) {
+      console.warn(
+        "[EventBus] clearSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
+      );
+      deprecationWarningShown.current = true;
+    }
+  }, []);
+  const emit = useCallback((type, payload) => {
+    const event = {
+      type,
+      payload,
+      timestamp: Date.now()
+    };
+    const listeners = listenersRef.current.get(type);
+    const listenerCount = listeners?.size ?? 0;
+    if (debug) {
+      if (listenerCount > 0) {
+        console.log(`[EventBus] Emit: ${type} \u2192 ${listenerCount} listener(s)`, payload);
+      } else {
+        console.warn(`[EventBus] Emit: ${type} (NO LISTENERS - event may be lost!)`, payload);
+      }
+    }
+    if (listeners) {
+      const listenersCopy = Array.from(listeners);
+      for (const listener of listenersCopy) {
+        try {
+          listener(event);
+        } catch (error) {
+          console.error(`[EventBus] Error in listener for '${type}':`, error);
+        }
+      }
+    }
+  }, [debug]);
+  const on = useCallback((type, listener) => {
+    if (!listenersRef.current.has(type)) {
+      listenersRef.current.set(type, /* @__PURE__ */ new Set());
+    }
+    const listeners = listenersRef.current.get(type);
+    listeners.add(listener);
+    if (debug) {
+      console.log(`[EventBus] Subscribed to '${type}', total: ${listeners.size}`);
+    }
+    return () => {
+      listeners.delete(listener);
+      if (debug) {
+        console.log(`[EventBus] Unsubscribed from '${type}', remaining: ${listeners.size}`);
+      }
+      if (listeners.size === 0) {
+        listenersRef.current.delete(type);
+      }
+    };
+  }, [debug]);
+  const once = useCallback((type, listener) => {
+    const wrappedListener = (event) => {
+      listenersRef.current.get(type)?.delete(wrappedListener);
+      listener(event);
+    };
+    return on(type, wrappedListener);
+  }, [on]);
+  const hasListeners = useCallback((type) => {
+    const listeners = listenersRef.current.get(type);
+    return listeners !== void 0 && listeners.size > 0;
+  }, []);
+  const contextValue = useMemo(
+    () => ({
+      emit,
+      on,
+      once,
+      hasListeners,
+      getSelectedEntity,
+      clearSelectedEntity
+    }),
+    [emit, on, once, hasListeners, getSelectedEntity, clearSelectedEntity]
+  );
+  useEffect(() => {
+    setGlobalEventBus(contextValue);
+    return () => {
+      setGlobalEventBus(null);
+    };
+  }, [contextValue]);
+  return /* @__PURE__ */ jsx(EventBusContext.Provider, { value: contextValue, children });
+}
+
+export { EventBusContext, EventBusProvider, useEmitEvent, useEventBus, useEventListener };

package/dist/{chunk-HY5EFCOK.js → chunk-VLWZZA6A.js}

@@ -1,193 +1,13 @@
-import React2, { createContext, useContext, useRef, useEffect, useCallback, useMemo, useState } from 'react';
+import { useEventBus } from './chunk-RUGU4MSK.js';
+import React, { createContext, useContext, useMemo, useState, useEffect, useCallback } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
-// providers/EventBusProvider.tsx
-function setGlobalEventBus(bus) {
-  if (typeof window !== "undefined") {
-    window.__kflowEventBus = bus;
-  }
-}
-function getGlobalEventBus() {
-  if (typeof window !== "undefined") {
-    return window.__kflowEventBus ?? null;
-  }
-  return null;
-}
-var fallbackListeners = /* @__PURE__ */ new Map();
-var fallbackEventBus = {
-  emit: (type, payload) => {
-    const event = {
-      type,
-      payload,
-      timestamp: Date.now()
-    };
-    const handlers = fallbackListeners.get(type);
-    if (handlers) {
-      handlers.forEach((handler) => {
-        try {
-          handler(event);
-        } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
-        }
-      });
-    }
-  },
-  on: (type, listener) => {
-    if (!fallbackListeners.has(type)) {
-      fallbackListeners.set(type, /* @__PURE__ */ new Set());
-    }
-    fallbackListeners.get(type).add(listener);
-    return () => {
-      const handlers = fallbackListeners.get(type);
-      if (handlers) {
-        handlers.delete(listener);
-        if (handlers.size === 0) {
-          fallbackListeners.delete(type);
-        }
-      }
-    };
-  },
-  once: (type, listener) => {
-    const wrappedListener = (event) => {
-      fallbackListeners.get(type)?.delete(wrappedListener);
-      listener(event);
-    };
-    return fallbackEventBus.on(type, wrappedListener);
-  },
-  hasListeners: (type) => {
-    const handlers = fallbackListeners.get(type);
-    return handlers !== void 0 && handlers.size > 0;
-  }
-};
-function useEventBus() {
-  const context = useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
-}
-function useEventListener(event, handler) {
-  const eventBus = useEventBus();
-  const handlerRef = useRef(handler);
-  handlerRef.current = handler;
-  useEffect(() => {
-    const wrappedHandler = (evt) => {
-      handlerRef.current(evt);
-    };
-    const unsub = eventBus.on(event, wrappedHandler);
-    return () => {
-      if (typeof unsub === "function") unsub();
-    };
-  }, [event, eventBus]);
-}
-function useEmitEvent() {
-  const eventBus = useEventBus();
-  return useCallback(
-    (type, payload) => {
-      eventBus.emit(type, payload);
-    },
-    [eventBus]
-  );
-}
-var EventBusContext = createContext(null);
-function EventBusProvider({ children, debug = false }) {
-  const listenersRef = useRef(/* @__PURE__ */ new Map());
-  const deprecationWarningShown = useRef(false);
-  const getSelectedEntity = useCallback(() => {
-    if (!deprecationWarningShown.current) {
-      console.warn(
-        "[EventBus] getSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
-      );
-      deprecationWarningShown.current = true;
-    }
-    return null;
-  }, []);
-  const clearSelectedEntity = useCallback(() => {
-    if (!deprecationWarningShown.current) {
-      console.warn(
-        "[EventBus] clearSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
-      );
-      deprecationWarningShown.current = true;
-    }
-  }, []);
-  const emit = useCallback((type, payload) => {
-    const event = {
-      type,
-      payload,
-      timestamp: Date.now()
-    };
-    const listeners = listenersRef.current.get(type);
-    const listenerCount = listeners?.size ?? 0;
-    if (debug) {
-      if (listenerCount > 0) {
-        console.log(`[EventBus] Emit: ${type} \u2192 ${listenerCount} listener(s)`, payload);
-      } else {
-        console.warn(`[EventBus] Emit: ${type} (NO LISTENERS - event may be lost!)`, payload);
-      }
-    }
-    if (listeners) {
-      const listenersCopy = Array.from(listeners);
-      for (const listener of listenersCopy) {
-        try {
-          listener(event);
-        } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
-        }
-      }
-    }
-  }, [debug]);
-  const on = useCallback((type, listener) => {
-    if (!listenersRef.current.has(type)) {
-      listenersRef.current.set(type, /* @__PURE__ */ new Set());
-    }
-    const listeners = listenersRef.current.get(type);
-    listeners.add(listener);
-    if (debug) {
-      console.log(`[EventBus] Subscribed to '${type}', total: ${listeners.size}`);
-    }
-    return () => {
-      listeners.delete(listener);
-      if (debug) {
-        console.log(`[EventBus] Unsubscribed from '${type}', remaining: ${listeners.size}`);
-      }
-      if (listeners.size === 0) {
-        listenersRef.current.delete(type);
-      }
-    };
-  }, [debug]);
-  const once = useCallback((type, listener) => {
-    const wrappedListener = (event) => {
-      listenersRef.current.get(type)?.delete(wrappedListener);
-      listener(event);
-    };
-    return on(type, wrappedListener);
-  }, [on]);
-  const hasListeners = useCallback((type) => {
-    const listeners = listenersRef.current.get(type);
-    return listeners !== void 0 && listeners.size > 0;
-  }, []);
-  const contextValue = useMemo(
-    () => ({
-      emit,
-      on,
-      once,
-      hasListeners,
-      getSelectedEntity,
-      clearSelectedEntity
-    }),
-    [emit, on, once, hasListeners, getSelectedEntity, clearSelectedEntity]
-  );
-  useEffect(() => {
-    setGlobalEventBus(contextValue);
-    return () => {
-      setGlobalEventBus(null);
-    };
-  }, [contextValue]);
-  return /* @__PURE__ */ jsx(EventBusContext.Provider, { value: contextValue, children });
-}
 var EntityDataContext = createContext(null);
 function EntityDataProvider({
   adapter,
   children
 }) {
-  return React2.createElement(
+  return React.createElement(
     EntityDataContext.Provider,
     { value: adapter },
     children
@@ -416,4 +236,4 @@ function useSelectionOptional() {
   return context;
 }
 
-export { EntityDataProvider, EventBusContext, EventBusProvider, SelectionContext, SelectionProvider, entityDataKeys, useEmitEvent, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, useEventBus, useEventListener, usePaginatedEntityList, useSelection, useSelectionOptional };
+export { EntityDataProvider, SelectionContext, SelectionProvider, entityDataKeys, useEntity, useEntityDataAdapter, useEntityDetail, useEntityList, usePaginatedEntityList, useSelection, useSelectionOptional };

package/dist/{chunk-7IYF4RUG.js → chunk-WRL6TBOL.js}

@@ -1,7 +1,8 @@
 import { apiClient } from './chunk-XSEDIUM6.js';
-import { useEventBus, SelectionContext, entityDataKeys } from './chunk-HY5EFCOK.js';
+import { SelectionContext, entityDataKeys } from './chunk-VLWZZA6A.js';
 import { subscribe, getSnapshot, clearEntities, removeEntity, updateSingleton, updateEntity, spawnEntity, getSingleton, getAllEntities, getByType, getEntity } from './chunk-N7MVUW4R.js';
-import { useCallback, useState, useEffect, useMemo, useContext, useSyncExternalStore } from 'react';
+import { useEventBus } from './chunk-RUGU4MSK.js';
+import { createContext, useCallback, useState, useEffect, useMemo, useContext, useSyncExternalStore } from 'react';
 import { useQueryClient, useMutation, useQuery } from '@tanstack/react-query';
 
 function useOrbitalHistory(options) {
@@ -1388,6 +1389,28 @@ function useInput() {
   }, [input?.id]);
   return { input, updateInput: update };
 }
+var I18nContext = createContext({
+  locale: "en",
+  direction: "ltr",
+  t: (key) => key
+  // passthrough fallback
+});
+I18nContext.displayName = "I18nContext";
+var I18nProvider = I18nContext.Provider;
+function useTranslate() {
+  return useContext(I18nContext);
+}
+function createTranslate(messages) {
+  return (key, params) => {
+    let msg = messages[key] ?? key;
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        msg = msg.split(`{{${k}}}`).join(String(v));
+      }
+    }
+    return msg;
+  };
+}
 
 // hooks/useAuthContext.ts
 function useAuthContext() {
@@ -1474,4 +1497,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ENTITY_EVENTS, parseQueryBinding, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useUIEvents, useUpdateEntity, useValidation };
+export { ENTITY_EVENTS, I18nProvider, createTranslate, parseQueryBinding, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useCreateEntity, useDeepAgentGeneration, useDeleteEntity, useDisconnectGitHub, useEntities, useEntitiesByType, useEntity, useEntityMutations, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInput, useOrbitalHistory, useOrbitalMutations, usePhysics, usePlayer, usePreview, useQuerySingleton, useSelectedEntity, useSendOrbitalEvent, useSingletonEntity, useTranslate, useUIEvents, useUpdateEntity, useValidation };