@almadar/ui 2.28.2 → 2.30.0

package/dist/providers/index.d.ts

@@ -11,6 +11,8 @@ export { SelectionProvider, SelectionContext, useSelection, useSelectionOptional
 export type { SelectionContextType } from './SelectionProvider';
 export { FetchedDataProvider, FetchedDataContext, useFetchedDataContext, useFetchedData, useFetchedEntity, } from './FetchedDataProvider';
 export type { FetchedDataProviderProps, FetchedDataContextValue, FetchedDataState, EntityRecord, } from './FetchedDataProvider';
+export { EntityStoreProvider, EntityStoreContext, useEntityRef, useEntityWatch, useEntityStore, } from './EntityStoreProvider';
+export type { EntityStoreContextValue } from './EntityStoreProvider';
 export { VerificationProvider } from './VerificationProvider';
 export type { VerificationProviderProps } from './VerificationProvider';
 export { OfflineModeProvider, useOfflineMode, useOptionalOfflineMode, } from './OfflineModeProvider';

package/dist/providers/index.js

@@ -1,5 +1,5 @@
-import * as React113 from 'react';
-import React113__default, { createContext, useCallback, useState, useRef, useEffect, useLayoutEffect, lazy, useContext, useMemo } from 'react';
+import * as React114 from 'react';
+import React114__default, { createContext, useCallback, useState, useRef, useEffect, useLayoutEffect, lazy, useContext, useSyncExternalStore, useMemo } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { EventBusContext } from '@almadar/ui/providers';
 import 'react-dom';
@@ -255,6 +255,81 @@ var ThemeProvider = ({
   );
   return /* @__PURE__ */ jsx(ThemeContext.Provider, { value: contextValue, children });
 };
+var store = /* @__PURE__ */ new Map();
+var storeListeners = /* @__PURE__ */ new Set();
+var watchCallbacks = /* @__PURE__ */ new Map();
+function advance(entityType, data) {
+  const prev = store.get(entityType);
+  const oldData = prev?.data ?? [];
+  store.set(entityType, { data, version: (prev?.version ?? 0) + 1 });
+  for (const listener of storeListeners) {
+    listener();
+  }
+  const cbs = watchCallbacks.get(entityType);
+  if (cbs) {
+    for (const cb of cbs) {
+      try {
+        cb(oldData, data);
+      } catch {
+      }
+    }
+  }
+}
+function getSnapshot(entityType) {
+  return store.get(entityType)?.data ?? [];
+}
+function getVersion(entityType) {
+  return store.get(entityType)?.version ?? 0;
+}
+function subscribeToStore(listener) {
+  storeListeners.add(listener);
+  return () => {
+    storeListeners.delete(listener);
+  };
+}
+function addWatch(entityType, callback) {
+  let cbs = watchCallbacks.get(entityType);
+  if (!cbs) {
+    cbs = /* @__PURE__ */ new Set();
+    watchCallbacks.set(entityType, cbs);
+  }
+  cbs.add(callback);
+  return () => {
+    cbs.delete(callback);
+  };
+}
+function useEntityRef(entityType) {
+  const versionRef = useRef(0);
+  const dataRef = useRef([]);
+  const getSnapshotStable = React114__default.useCallback(() => {
+    const currentVersion = getVersion(entityType);
+    if (currentVersion !== versionRef.current) {
+      versionRef.current = currentVersion;
+      dataRef.current = getSnapshot(entityType);
+    }
+    return dataRef.current;
+  }, [entityType]);
+  return useSyncExternalStore(subscribeToStore, getSnapshotStable, () => []);
+}
+function useEntityWatch(entityType, callback) {
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+  useEffect(() => {
+    return addWatch(entityType, (oldData, newData) => {
+      callbackRef.current(oldData, newData);
+    });
+  }, [entityType]);
+}
+var EntityStoreContext = createContext({
+  advance,
+  getSnapshot
+});
+function useEntityStore() {
+  return useContext(EntityStoreContext);
+}
+function EntityStoreProvider({ children }) {
+  return /* @__PURE__ */ jsx(EntityStoreContext.Provider, { value: { advance, getSnapshot }, children });
+}
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
     window.__kflowEventBus = bus;
@@ -675,7 +750,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React113__default.forwardRef(
+var Box = React114__default.forwardRef(
   ({
     padding,
     paddingX,
@@ -946,7 +1021,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React113__default.isValidElement(value)) {
+  if (React114__default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -955,7 +1030,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React113__default.forwardRef(
+var Button = React114__default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -1051,7 +1126,7 @@ var sizeStyles3 = {
   md: "px-2.5 py-1 text-sm",
   lg: "px-3 py-1.5 text-base"
 };
-var Badge = React113__default.forwardRef(
+var Badge = React114__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" ? (() => {
@@ -1078,7 +1153,7 @@ var Badge = React113__default.forwardRef(
   }
 );
 Badge.displayName = "Badge";
-var Input = React113__default.forwardRef(
+var Input = React114__default.forwardRef(
   ({
     className,
     inputType,
@@ -1190,7 +1265,7 @@ var Input = React113__default.forwardRef(
   }
 );
 Input.displayName = "Input";
-var Label = React113__default.forwardRef(
+var Label = React114__default.forwardRef(
   ({ className, required, children, ...props }, ref) => {
     return /* @__PURE__ */ jsxs(
       "label",
@@ -1210,7 +1285,7 @@ var Label = React113__default.forwardRef(
   }
 );
 Label.displayName = "Label";
-var Textarea = React113__default.forwardRef(
+var Textarea = React114__default.forwardRef(
   ({ className, error, ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "textarea",
@@ -1233,7 +1308,7 @@ var Textarea = React113__default.forwardRef(
   }
 );
 Textarea.displayName = "Textarea";
-var Select = React113__default.forwardRef(
+var Select = React114__default.forwardRef(
   ({ className, options, placeholder, error, ...props }, ref) => {
     return /* @__PURE__ */ jsxs("div", { className: "relative", children: [
       /* @__PURE__ */ jsxs(
@@ -1269,7 +1344,7 @@ var Select = React113__default.forwardRef(
   }
 );
 Select.displayName = "Select";
-var Checkbox = React113__default.forwardRef(
+var Checkbox = React114__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: [
@@ -1345,7 +1420,7 @@ var shadowStyles2 = {
   md: "shadow",
   lg: "shadow-lg"
 };
-var Card = React113__default.forwardRef(
+var Card = React114__default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -1381,9 +1456,9 @@ var Card = React113__default.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React113__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React114__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React113__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardTitle = React114__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "h3",
   {
     ref,
@@ -1396,11 +1471,11 @@ var CardTitle = React113__default.forwardRef(({ className, ...props }, ref) => /
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React113__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React114__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React113__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardFooter = React114__default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "div",
   {
     ref,
@@ -1415,7 +1490,7 @@ var sizeStyles4 = {
   md: "h-6 w-6",
   lg: "h-8 w-8"
 };
-var Spinner = React113__default.forwardRef(
+var Spinner = React114__default.forwardRef(
   ({ className, size = "md", ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "div",
@@ -1429,7 +1504,7 @@ var Spinner = React113__default.forwardRef(
   }
 );
 Spinner.displayName = "Spinner";
-var Radio = React113__default.forwardRef(
+var Radio = React114__default.forwardRef(
   ({
     label,
     helperText,
@@ -1533,7 +1608,7 @@ var Radio = React113__default.forwardRef(
   }
 );
 Radio.displayName = "Radio";
-var Switch = React113.forwardRef(
+var Switch = React114.forwardRef(
   ({
     checked,
     defaultChecked = false,
@@ -1544,10 +1619,10 @@ var Switch = React113.forwardRef(
     name,
     className
   }, ref) => {
-    const [isChecked, setIsChecked] = React113.useState(
+    const [isChecked, setIsChecked] = React114.useState(
       checked !== void 0 ? checked : defaultChecked
     );
-    React113.useEffect(() => {
+    React114.useEffect(() => {
       if (checked !== void 0) {
         setIsChecked(checked);
       }
@@ -1705,7 +1780,7 @@ var sizeStyles5 = {
   md: "w-2.5 h-2.5",
   lg: "w-3 h-3"
 };
-var StatusDot = React113__default.forwardRef(
+var StatusDot = React114__default.forwardRef(
   ({ className, status = "offline", pulse = false, size = "md", label, ...props }, ref) => {
     return /* @__PURE__ */ jsx(
       "span",
@@ -1752,7 +1827,7 @@ var iconMap2 = {
   down: TrendingDown,
   flat: ArrowRight
 };
-var TrendIndicator = React113__default.forwardRef(
+var TrendIndicator = React114__default.forwardRef(
   ({
     className,
     value,
@@ -1811,7 +1886,7 @@ var thumbSizes = {
   md: "w-4 h-4",
   lg: "w-5 h-5"
 };
-var RangeSlider = React113__default.forwardRef(
+var RangeSlider = React114__default.forwardRef(
   ({
     className,
     min = 0,
@@ -2014,7 +2089,7 @@ var paddingClasses = {
   md: "py-16",
   lg: "py-24"
 };
-var ContentSection = React113__default.forwardRef(
+var ContentSection = React114__default.forwardRef(
   ({ children, background = "default", padding = "lg", id, className }, ref) => {
     return /* @__PURE__ */ jsx(
       Box,
@@ -2053,7 +2128,7 @@ var animatedStyles = {
   "scale-up": { opacity: 1, transform: "scale(1) translateY(0)" },
   "none": {}
 };
-var AnimatedReveal = React113__default.forwardRef(
+var AnimatedReveal = React114__default.forwardRef(
   ({
     trigger = "scroll",
     animation = "fade-up",
@@ -2206,7 +2281,7 @@ function applyMorphAnimation(container, animate, duration, delay, easing) {
     el.style.opacity = animate ? "1" : "0";
   });
 }
-var AnimatedGraphic = React113__default.forwardRef(
+var AnimatedGraphic = React114__default.forwardRef(
   ({
     src,
     svgContent,
@@ -2229,7 +2304,7 @@ var AnimatedGraphic = React113__default.forwardRef(
     const fetchedSvg = useFetchedSvg(svgContent ? void 0 : src);
     const resolvedSvg = svgContent ?? fetchedSvg;
     const prevAnimateRef = useRef(animate);
-    const setRef = React113__default.useCallback(
+    const setRef = React114__default.useCallback(
       (node) => {
         containerRef.current = node;
         if (typeof ref === "function") ref(node);
@@ -2471,7 +2546,7 @@ var ErrorState = ({
   );
 };
 ErrorState.displayName = "ErrorState";
-var ErrorBoundary = class extends React113__default.Component {
+var ErrorBoundary = class extends React114__default.Component {
   constructor(props) {
     super(props);
     __publicField(this, "reset", () => {
@@ -2984,7 +3059,7 @@ function getSummary() {
     pending: allChecks.filter((c) => c.status === "pending").length
   };
 }
-function getSnapshot() {
+function getSnapshot2() {
   return {
     checks: getAllChecks(),
     transitions: getTransitions(),
@@ -3000,7 +3075,7 @@ function exposeOnWindow() {
   if (typeof window === "undefined") return;
   if (!window.__orbitalVerification) {
     window.__orbitalVerification = {
-      getSnapshot,
+      getSnapshot: getSnapshot2,
       getChecks: getAllChecks,
       getTransitions,
       getBridge: getBridgeHealth,
@@ -3064,7 +3139,7 @@ function bindTraitStateGetter(getter) {
   }
 }
 exposeOnWindow();
-var MarkdownContent = React113__default.memo(
+var MarkdownContent = React114__default.memo(
   ({ content, direction, className }) => {
     const { t: _t } = useTranslate();
     const safeContent = typeof content === "string" ? content : String(content ?? "");
@@ -3166,7 +3241,7 @@ var MarkdownContent = React113__default.memo(
   (prev, next) => prev.content === next.content && prev.className === next.className && prev.direction === next.direction
 );
 MarkdownContent.displayName = "MarkdownContent";
-var CodeBlock = React113__default.memo(
+var CodeBlock = React114__default.memo(
   ({
     code: rawCode,
     language = "text",
@@ -3283,12 +3358,12 @@ GameAudioContext.displayName = "GameAudioContext";
 
 // components/organisms/component-registry.generated.ts
 function lazyThree(name, loader) {
-  const Lazy = React113__default.lazy(() => loader().then((m) => ({ default: m[name] })));
+  const Lazy = React114__default.lazy(() => loader().then((m) => ({ default: m[name] })));
   function ThreeWrapper(props) {
-    return React113__default.createElement(
-      React113__default.Suspense,
+    return React114__default.createElement(
+      React114__default.Suspense,
       { fallback: null },
-      React113__default.createElement(Lazy, props)
+      React114__default.createElement(Lazy, props)
     );
   }
   ThreeWrapper.displayName = `Lazy(${name})`;
@@ -3315,7 +3390,7 @@ function SuspenseConfigProvider({
   config,
   children
 }) {
-  return React113__default.createElement(
+  return React114__default.createElement(
     SuspenseConfigContext.Provider,
     { value: config },
     children
@@ -3511,7 +3586,7 @@ function OrbitalProvider({
     () => ({ enabled: suspense }),
     [suspense]
   );
-  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 }) }) }) });
+  const inner = /* @__PURE__ */ jsx(EntityStoreProvider, { 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 }) }) }) }) });
   if (skipTheme) {
     return inner;
   }
@@ -3712,4 +3787,4 @@ function useOptionalOfflineMode() {
   return useContext(OfflineModeContext);
 }
 
-export { EventBusContext2 as EventBusContext, EventBusProvider, FetchedDataContext, FetchedDataProvider, OfflineModeProvider, OrbitalProvider, SelectionContext, SelectionProvider, VerificationProvider, useFetchedData, useFetchedDataContext, useFetchedEntity, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional };
+export { EntityStoreContext, EntityStoreProvider, EventBusContext2 as EventBusContext, EventBusProvider, FetchedDataContext, FetchedDataProvider, OfflineModeProvider, OrbitalProvider, SelectionContext, SelectionProvider, VerificationProvider, useEntityRef, useEntityStore, useEntityWatch, useFetchedData, useFetchedDataContext, useFetchedEntity, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional };

package/dist/runtime/OrbPreview.d.ts

@@ -13,8 +13,8 @@
  */
 import React from 'react';
 export interface OrbPreviewProps {
-    /** The orbital schema. Accepts a JSON string or a parsed object. */
-    schema: string | Record<string, unknown>;
+    /** The orbital schema. Accepts a JSON string or an OrbitalSchema object. */
+    schema: string | import('@almadar/core').OrbitalSchema;
     /** Mock entity data keyed by entity name. */
     mockData?: Record<string, unknown[]>;
     /** Preview container height. Default: '400px'. */

package/dist/runtime/ServerBridge.d.ts

@@ -12,6 +12,8 @@ export interface ServerResponseMeta {
     success: boolean;
     clientEffects: number;
     dataEntities: Record<string, number>;
+    /** Raw entity data from server response (for EntityStore advancement) */
+    data?: Record<string, unknown[]>;
     emittedEvents: string[];
     error?: string;
 }

package/dist/runtime/createClientEffectHandlers.d.ts

@@ -18,6 +18,5 @@ export interface CreateClientEffectHandlersOptions {
     slotSetter: SlotSetter;
     navigate?: (path: string, params?: Record<string, unknown>) => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
-    enrichPattern?: (pattern: unknown) => unknown;
 }
 export declare function createClientEffectHandlers(options: CreateClientEffectHandlersOptions): EffectHandlers;