@almadar/ui 2.20.0 → 2.20.6

package/dist/providers/index.js

@@ -1,5 +1,5 @@
-import * as React110 from 'react';
-import React110__default, { createContext, useCallback, useState, useRef, useLayoutEffect, useEffect, lazy, useContext, useMemo } from 'react';
+import * as React108 from 'react';
+import React108__default, { createContext, useCallback, useState, useRef, useLayoutEffect, useEffect, lazy, useContext, useMemo } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { EventBusContext } from '@almadar/ui/providers';
 import 'react-dom';
@@ -534,172 +534,6 @@ function useSelectionOptional() {
   const context = useContext(SelectionContext);
   return context;
 }
-var FetchedDataContext = createContext(null);
-function FetchedDataProvider({
-  initialData,
-  children
-}) {
-  const [state, setState] = useState(() => ({
-    data: initialData || {},
-    fetchedAt: {},
-    loading: false,
-    error: null
-  }));
-  const getData = useCallback(
-    (entityName) => {
-      return state.data[entityName] || [];
-    },
-    [state.data]
-  );
-  const getById = useCallback(
-    (entityName, id) => {
-      const records = state.data[entityName];
-      return records?.find((r) => r.id === id);
-    },
-    [state.data]
-  );
-  const hasData = useCallback(
-    (entityName) => {
-      return entityName in state.data && state.data[entityName].length > 0;
-    },
-    [state.data]
-  );
-  const getFetchedAt = useCallback(
-    (entityName) => {
-      return state.fetchedAt[entityName];
-    },
-    [state.fetchedAt]
-  );
-  const setData = useCallback((data) => {
-    const now = Date.now();
-    setState((prev) => ({
-      ...prev,
-      data: {
-        ...prev.data,
-        ...data
-      },
-      fetchedAt: {
-        ...prev.fetchedAt,
-        ...Object.keys(data).reduce(
-          (acc, key) => ({ ...acc, [key]: now }),
-          {}
-        )
-      },
-      loading: false,
-      error: null
-    }));
-  }, []);
-  const clearData = useCallback(() => {
-    setState((prev) => ({
-      ...prev,
-      data: {},
-      fetchedAt: {}
-    }));
-  }, []);
-  const clearEntity = useCallback((entityName) => {
-    setState((prev) => {
-      const newData = { ...prev.data };
-      const newFetchedAt = { ...prev.fetchedAt };
-      delete newData[entityName];
-      delete newFetchedAt[entityName];
-      return {
-        ...prev,
-        data: newData,
-        fetchedAt: newFetchedAt
-      };
-    });
-  }, []);
-  const setLoading = useCallback((loading) => {
-    setState((prev) => ({ ...prev, loading }));
-  }, []);
-  const setError = useCallback((error) => {
-    setState((prev) => ({ ...prev, error, loading: false }));
-  }, []);
-  const contextValue = useMemo(
-    () => ({
-      getData,
-      getById,
-      hasData,
-      getFetchedAt,
-      setData,
-      clearData,
-      clearEntity,
-      loading: state.loading,
-      setLoading,
-      error: state.error,
-      setError
-    }),
-    [
-      getData,
-      getById,
-      hasData,
-      getFetchedAt,
-      setData,
-      clearData,
-      clearEntity,
-      state.loading,
-      setLoading,
-      state.error,
-      setError
-    ]
-  );
-  return /* @__PURE__ */ jsx(FetchedDataContext.Provider, { value: contextValue, children });
-}
-function useFetchedDataContext() {
-  return useContext(FetchedDataContext);
-}
-function useFetchedData() {
-  const context = useContext(FetchedDataContext);
-  if (!context) {
-    return {
-      getData: () => [],
-      getById: () => void 0,
-      hasData: () => false,
-      getFetchedAt: () => void 0,
-      setData: () => {
-      },
-      clearData: () => {
-      },
-      clearEntity: () => {
-      },
-      loading: false,
-      setLoading: () => {
-      },
-      error: null,
-      setError: () => {
-      }
-    };
-  }
-  return context;
-}
-function useFetchedEntity(entityName) {
-  const context = useFetchedData();
-  return {
-    /** All fetched records for this entity */
-    records: context.getData(entityName),
-    /** Get a record by ID */
-    getById: (id) => context.getById(entityName, id),
-    /** Whether data has been fetched for this entity */
-    hasData: context.hasData(entityName),
-    /** When data was last fetched */
-    fetchedAt: context.getFetchedAt(entityName),
-    /** Whether data is loading */
-    loading: context.loading,
-    /** Current error */
-    error: context.error
-  };
-}
-var EntityDataContext = createContext(null);
-function EntityDataProvider({
-  adapter,
-  children
-}) {
-  return React110__default.createElement(
-    EntityDataContext.Provider,
-    { value: adapter },
-    children
-  );
-}
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
@@ -840,7 +674,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React110__default.forwardRef(
+var Box = React108__default.forwardRef(
   ({
     padding,
     paddingX,
@@ -1110,7 +944,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React110__default.isValidElement(value)) {
+  if (React108__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -1119,7 +953,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React110__default.forwardRef(
+var Button = React108__default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -1214,7 +1048,7 @@ var sizeStyles3 = {
   md: "px-2.5 py-1 text-sm",
   lg: "px-3 py-1.5 text-base"
 };
-var Badge = React110__default.forwardRef(
+var Badge = React108__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" ? (() => {
@@ -1241,7 +1075,7 @@ var Badge = React110__default.forwardRef(
   }
 );
 Badge.displayName = "Badge";
-var Input = React110__default.forwardRef(
+var Input = React108__default.forwardRef(
   ({
     className,
     inputType,
@@ -1353,7 +1187,7 @@ var Input = React110__default.forwardRef(
   }
 );
 Input.displayName = "Input";
-var Label = React110__default.forwardRef(
+var Label = React108__default.forwardRef(
   ({ className, required, children, ...props }, ref) => {
     return /* @__PURE__ */ jsxs(
       "label",
@@ -1373,7 +1207,7 @@ var Label = React110__default.forwardRef(
   }
 );
 Label.displayName = "Label";
-var Textarea = React110__default.forwardRef(
+var Textarea = React108__default.forwardRef(
   ({ className, error, ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "textarea",
@@ -1396,7 +1230,7 @@ var Textarea = React110__default.forwardRef(
   }
 );
 Textarea.displayName = "Textarea";
-var Select = React110__default.forwardRef(
+var Select = React108__default.forwardRef(
   ({ className, options, placeholder, error, ...props }, ref) => {
     return /* @__PURE__ */ jsxs("div", { className: "relative", children: [
       /* @__PURE__ */ jsxs(
@@ -1432,7 +1266,7 @@ var Select = React110__default.forwardRef(
   }
 );
 Select.displayName = "Select";
-var Checkbox = React110__default.forwardRef(
+var Checkbox = React108__default.forwardRef(
   ({ className, label, id, ...props }, ref) => {
     const inputId = id || `checkbox-${Math.random().toString(36).substr(2, 9)}`;
     return /* @__PURE__ */ jsxs("div", { className: "flex items-center", children: [
@@ -1506,7 +1340,7 @@ var shadowStyles2 = {
   md: "shadow-[var(--shadow-main)]",
   lg: "shadow-[var(--shadow-lg)]"
 };
-var Card = React110__default.forwardRef(
+var Card = React108__default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -1542,9 +1376,9 @@ var Card = React110__default.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React110__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React108__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React110__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardTitle = React108__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "h3",
   {
     ref,
@@ -1557,11 +1391,11 @@ var CardTitle = React110__default.forwardRef(({ className, ...props }, ref) => /
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React110__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React108__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React110__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardFooter = React108__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "div",
   {
     ref,
@@ -1576,7 +1410,7 @@ var sizeStyles4 = {
   md: "h-6 w-6",
   lg: "h-8 w-8"
 };
-var Spinner = React110__default.forwardRef(
+var Spinner = React108__default.forwardRef(
   ({ className, size = "md", ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "div",
@@ -1590,7 +1424,7 @@ var Spinner = React110__default.forwardRef(
   }
 );
 Spinner.displayName = "Spinner";
-var Radio = React110__default.forwardRef(
+var Radio = React108__default.forwardRef(
   ({
     label,
     helperText,
@@ -1694,7 +1528,7 @@ var Radio = React110__default.forwardRef(
   }
 );
 Radio.displayName = "Radio";
-var Switch = React110.forwardRef(
+var Switch = React108.forwardRef(
   ({
     checked,
     defaultChecked = false,
@@ -1705,10 +1539,10 @@ var Switch = React110.forwardRef(
     name,
     className
   }, ref) => {
-    const [isChecked, setIsChecked] = React110.useState(
+    const [isChecked, setIsChecked] = React108.useState(
       checked !== void 0 ? checked : defaultChecked
     );
-    React110.useEffect(() => {
+    React108.useEffect(() => {
       if (checked !== void 0) {
         setIsChecked(checked);
       }
@@ -1866,7 +1700,7 @@ var sizeStyles5 = {
   md: "w-2.5 h-2.5",
   lg: "w-3 h-3"
 };
-var StatusDot = React110__default.forwardRef(
+var StatusDot = React108__default.forwardRef(
   ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "span",
@@ -1913,7 +1747,7 @@ var iconMap2 = {
   down: TrendingDown,
   flat: ArrowRight
 };
-var TrendIndicator = React110__default.forwardRef(
+var TrendIndicator = React108__default.forwardRef(
   ({
     className,
     value,
@@ -1972,7 +1806,7 @@ var thumbSizes = {
   md: "w-4 h-4",
   lg: "w-5 h-5"
 };
-var RangeSlider = React110__default.forwardRef(
+var RangeSlider = React108__default.forwardRef(
   ({
     className,
     min = 0,
@@ -2175,7 +2009,7 @@ var paddingClasses = {
   md: "py-16",
   lg: "py-24"
 };
-var ContentSection = React110__default.forwardRef(
+var ContentSection = React108__default.forwardRef(
   ({ children, background = "default", padding = "lg", id, className }, ref) => {
     return /* @__PURE__ */ jsx(
       Box,
@@ -2349,7 +2183,7 @@ var ErrorState = ({
   );
 };
 ErrorState.displayName = "ErrorState";
-var ErrorBoundary = class extends React110__default.Component {
+var ErrorBoundary = class extends React108__default.Component {
   constructor(props) {
     super(props);
     __publicField(this, "reset", () => {
@@ -2929,7 +2763,7 @@ function bindTraitStateGetter(getter) {
   }
 }
 exposeOnWindow();
-var MarkdownContent = React110__default.memo(
+var MarkdownContent = React108__default.memo(
   ({ content, direction, className }) => {
     const { t: _t } = useTranslate();
     return /* @__PURE__ */ jsx(
@@ -3030,7 +2864,7 @@ var MarkdownContent = React110__default.memo(
   (prev, next) => prev.content === next.content && prev.className === next.className && prev.direction === next.direction
 );
 MarkdownContent.displayName = "MarkdownContent";
-var CodeBlock = React110__default.memo(
+var CodeBlock = React108__default.memo(
   ({
     code,
     language = "text",
@@ -3146,12 +2980,12 @@ GameAudioContext.displayName = "GameAudioContext";
 
 // components/organisms/component-registry.generated.ts
 function lazyThree(name, loader) {
-  const Lazy = React110__default.lazy(() => loader().then((m) => ({ default: m[name] })));
+  const Lazy = React108__default.lazy(() => loader().then((m) => ({ default: m[name] })));
   function ThreeWrapper(props) {
-    return React110__default.createElement(
-      React110__default.Suspense,
+    return React108__default.createElement(
+      React108__default.Suspense,
       { fallback: null },
-      React110__default.createElement(Lazy, props)
+      React108__default.createElement(Lazy, props)
     );
   }
   ThreeWrapper.displayName = `Lazy(${name})`;
@@ -3178,7 +3012,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React110__default.createElement(
+  return React108__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -3323,16 +3157,6 @@ function VerificationProvider({
   return /* @__PURE__ */ jsx(Fragment, { children });
 }
 VerificationProvider.displayName = "VerificationProvider";
-function FetchedDataBridge({ children }) {
-  const fetchedData = useFetchedData();
-  const adapter = useMemo(() => ({
-    getData: (entity) => fetchedData.getData(entity),
-    getById: (entity, id) => fetchedData.getById(entity, id),
-    isLoading: fetchedData.loading,
-    error: fetchedData.error
-  }), [fetchedData.getData, fetchedData.getById, fetchedData.loading, fetchedData.error]);
-  return /* @__PURE__ */ jsx(EntityDataProvider, { adapter, children });
-}
 function OrbitalProvider({
   children,
   themes,
@@ -3349,7 +3173,7 @@ function OrbitalProvider({
     () => ({ enabled: suspense }),
     [suspense]
   );
-  const inner = /* @__PURE__ */ jsx(FetchedDataProvider, { initialData, children: /* @__PURE__ */ jsx(FetchedDataBridge, { children: /* @__PURE__ */ jsx(EventBusProvider, { debug: debug2, children: /* @__PURE__ */ jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) }) }) });
+  const inner = /* @__PURE__ */ jsx(EventBusProvider, { debug: debug2, children: /* @__PURE__ */ jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) });
   if (skipTheme) {
     return inner;
   }
@@ -3365,6 +3189,161 @@ function OrbitalProvider({
   );
 }
 OrbitalProvider.displayName = "OrbitalProvider";
+var FetchedDataContext = createContext(null);
+function FetchedDataProvider({
+  initialData,
+  children
+}) {
+  const [state, setState] = useState(() => ({
+    data: initialData || {},
+    fetchedAt: {},
+    loading: false,
+    error: null
+  }));
+  const getData = useCallback(
+    (entityName) => {
+      return state.data[entityName] || [];
+    },
+    [state.data]
+  );
+  const getById = useCallback(
+    (entityName, id) => {
+      const records = state.data[entityName];
+      return records?.find((r) => r.id === id);
+    },
+    [state.data]
+  );
+  const hasData = useCallback(
+    (entityName) => {
+      return entityName in state.data && state.data[entityName].length > 0;
+    },
+    [state.data]
+  );
+  const getFetchedAt = useCallback(
+    (entityName) => {
+      return state.fetchedAt[entityName];
+    },
+    [state.fetchedAt]
+  );
+  const setData = useCallback((data) => {
+    const now = Date.now();
+    setState((prev) => ({
+      ...prev,
+      data: {
+        ...prev.data,
+        ...data
+      },
+      fetchedAt: {
+        ...prev.fetchedAt,
+        ...Object.keys(data).reduce(
+          (acc, key) => ({ ...acc, [key]: now }),
+          {}
+        )
+      },
+      loading: false,
+      error: null
+    }));
+  }, []);
+  const clearData = useCallback(() => {
+    setState((prev) => ({
+      ...prev,
+      data: {},
+      fetchedAt: {}
+    }));
+  }, []);
+  const clearEntity = useCallback((entityName) => {
+    setState((prev) => {
+      const newData = { ...prev.data };
+      const newFetchedAt = { ...prev.fetchedAt };
+      delete newData[entityName];
+      delete newFetchedAt[entityName];
+      return {
+        ...prev,
+        data: newData,
+        fetchedAt: newFetchedAt
+      };
+    });
+  }, []);
+  const setLoading = useCallback((loading) => {
+    setState((prev) => ({ ...prev, loading }));
+  }, []);
+  const setError = useCallback((error) => {
+    setState((prev) => ({ ...prev, error, loading: false }));
+  }, []);
+  const contextValue = useMemo(
+    () => ({
+      getData,
+      getById,
+      hasData,
+      getFetchedAt,
+      setData,
+      clearData,
+      clearEntity,
+      loading: state.loading,
+      setLoading,
+      error: state.error,
+      setError
+    }),
+    [
+      getData,
+      getById,
+      hasData,
+      getFetchedAt,
+      setData,
+      clearData,
+      clearEntity,
+      state.loading,
+      setLoading,
+      state.error,
+      setError
+    ]
+  );
+  return /* @__PURE__ */ jsx(FetchedDataContext.Provider, { value: contextValue, children });
+}
+function useFetchedDataContext() {
+  return useContext(FetchedDataContext);
+}
+function useFetchedData() {
+  const context = useContext(FetchedDataContext);
+  if (!context) {
+    return {
+      getData: () => [],
+      getById: () => void 0,
+      hasData: () => false,
+      getFetchedAt: () => void 0,
+      setData: () => {
+      },
+      clearData: () => {
+      },
+      clearEntity: () => {
+      },
+      loading: false,
+      setLoading: () => {
+      },
+      error: null,
+      setError: () => {
+      }
+    };
+  }
+  return context;
+}
+function useFetchedEntity(entityName) {
+  const context = useFetchedData();
+  return {
+    /** All fetched records for this entity */
+    records: context.getData(entityName),
+    /** Get a record by ID */
+    getById: (id) => context.getById(entityName, id),
+    /** Whether data has been fetched for this entity */
+    hasData: context.hasData(entityName),
+    /** When data was last fetched */
+    fetchedAt: context.getFetchedAt(entityName),
+    /** Whether data is loading */
+    loading: context.loading,
+    /** Current error */
+    error: context.error
+  };
+}
 var OfflineModeContext = createContext(null);
 function OfflineModeProvider({
   children,

package/dist/runtime/OrbPreview.d.ts

@@ -2,11 +2,12 @@
  * OrbPreview Component
  *
  * Renders a live preview of an Orbital schema (.orb program).
- * Lazily loads the full runtime stack (providers, context, state machines)
- * and renders the schema's UI via UISlotRenderer.
+ * Uses static imports (no lazy loading) to ensure all providers,
+ * hooks, and components share the same module instances.
  *
  * Usage:
  *   <OrbPreview schema={orbJsonStringOrObject} />
+ *   <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  *
  * @packageDocumentation
  */
@@ -20,20 +21,22 @@ export interface OrbPreviewProps {
     height?: string;
     /** CSS class for the outer container. */
     className?: string;
+    /** Server URL for dual execution (e.g. "/api/orbitals"). When set, events are forwarded to the server. */
+    serverUrl?: string;
 }
 /**
  * Renders a live preview of an Orbital schema.
  *
- * Lazily loads the full Almadar runtime (providers, state machines, slot system)
- * and renders the schema's UI. Suitable for documentation sites, playgrounds,
- * and any context where you want to show a running .orb program.
+ * Uses static imports for all runtime components to ensure providers
+ * and hooks share the same module instances (no context duplication).
  *
  * @example
  * ```tsx
  * <OrbPreview schema={orbJsonString} height="300px" />
+ * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-export declare function OrbPreview({ schema, mockData, height, className, }: OrbPreviewProps): React.ReactElement;
+export declare function OrbPreview({ schema, mockData, height, className, serverUrl, }: OrbPreviewProps): React.ReactElement;
 export declare namespace OrbPreview {
     var displayName: string;
 }

package/dist/runtime/ServerBridge.d.ts

@@ -0,0 +1,23 @@
+import type { ReactNode } from 'react';
+export interface ServerClientEffect {
+    type: 'render-ui' | 'navigate' | 'notify';
+    slot?: string;
+    pattern?: Record<string, unknown>;
+    route?: string;
+    params?: Record<string, unknown>;
+    message?: string;
+}
+export interface ServerBridgeContextValue {
+    connected: boolean;
+    sendEvent: (orbitalName: string, event: string, payload?: Record<string, unknown>) => Promise<ServerClientEffect[]>;
+}
+/**
+ * Access the server bridge. Returns a no-op stub when outside the provider.
+ */
+export declare function useServerBridge(): ServerBridgeContextValue;
+export interface ServerBridgeProviderProps {
+    schema: unknown;
+    serverUrl: string;
+    children: ReactNode;
+}
+export declare function ServerBridgeProvider({ schema, serverUrl, children, }: ServerBridgeProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/runtime/enrichFromResponse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * enrichFromResponse
+ *
+ * Walks a pattern tree from a server response and injects entity data
+ * into entity-aware patterns. Uses isEntityAwarePattern() from
+ * @almadar/patterns (registry-driven, not a hardcoded list).
+ *
+ * This is the single place where entity data meets UI patterns.
+ * Called by ServerBridge/ServerBridgeProvider when processing
+ * clientEffects from the server response.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Enrich a pattern tree with entity data from a server response.
+ *
+ * @param node - Pattern config node (from server clientEffects)
+ * @param data - Entity records keyed by entity name (from server response.data)
+ * @returns Enriched pattern with entity arrays injected
+ */
+export declare function enrichFromResponse(node: Record<string, unknown>, data: Record<string, unknown[]>): Record<string, unknown>;