@almadar/ui 4.10.7 → 4.12.0

package/dist/runtime/index.js

@@ -37,6 +37,7 @@ import langGraphql from 'react-syntax-highlighter/dist/esm/languages/prism/graph
 import { isCircuitEvent, schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, isEntityCall, isInlineTrait } from '@almadar/core';
 import '@tanstack/react-query';
 import { StateMachineManager, createContextFromBindings, interpolateValue, createServerEffectHandlers, EffectExecutor, InMemoryPersistence } from '@almadar/runtime';
+import { OrbitalServerRuntime } from '@almadar/runtime/OrbitalServerRuntime';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -8184,13 +8185,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect68, useRef: useRef65, useCallback: useCallback110, useState: useState102 } = React115__default;
+      const { useEffect: useEffect69, useRef: useRef65, useCallback: useCallback110, useState: useState103 } = React115__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
         const prevRef = useRef65({ centerLat, centerLng, zoom });
-        useEffect68(() => {
+        useEffect69(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -8201,7 +8202,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect68(() => {
+        useEffect69(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -8228,7 +8229,7 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState102(null);
+        const [clickedPosition, setClickedPosition] = useState103(null);
         const handleMapClick = useCallback110((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
@@ -38928,6 +38929,78 @@ init_Box();
 init_Typography();
 init_UISlotRenderer();
 init_useEventBus();
+
+// runtime/embedded-traits.ts
+var TRAIT_BINDING_PREFIX = "@trait.";
+function collectTraitRefsFromValue(value, into) {
+  if (value === null || value === void 0) return;
+  if (typeof value === "string") {
+    if (value.startsWith(TRAIT_BINDING_PREFIX)) {
+      const rest = value.slice(TRAIT_BINDING_PREFIX.length);
+      const dot = rest.indexOf(".");
+      const traitName = dot === -1 ? rest : rest.slice(0, dot);
+      if (traitName.length > 0) into.add(traitName);
+    }
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const item of value) collectTraitRefsFromValue(item, into);
+    return;
+  }
+  if (typeof value === "object") {
+    for (const v of Object.values(value)) {
+      collectTraitRefsFromValue(v, into);
+    }
+  }
+}
+function collectTraitRefsFromEffects(effects, into) {
+  if (!effects) return;
+  for (const effect of effects) {
+    if (!Array.isArray(effect)) continue;
+    if (effect[0] === "render-ui" && effect.length >= 3) {
+      collectTraitRefsFromValue(effect[2], into);
+      continue;
+    }
+    for (let i = 1; i < effect.length; i++) {
+      const arg = effect[i];
+      if (Array.isArray(arg)) collectTraitRefsFromEffects([arg], into);
+      else collectTraitRefsFromValue(arg, into);
+    }
+  }
+}
+function collectEmbeddedTraits(schema) {
+  const out = /* @__PURE__ */ new Set();
+  if (!schema?.orbitals) return out;
+  for (const orbital of schema.orbitals) {
+    if (!orbital || typeof orbital !== "object") continue;
+    const traits2 = orbital.traits;
+    if (!Array.isArray(traits2)) continue;
+    for (const trait of traits2) {
+      if (!trait || typeof trait !== "object") continue;
+      const resolved = trait._resolved;
+      const target = resolved && typeof resolved === "object" ? resolved : trait;
+      const stateMachine = target.stateMachine;
+      const transitions = stateMachine?.transitions;
+      if (!Array.isArray(transitions)) continue;
+      for (const t of transitions) {
+        if (!t || typeof t !== "object") continue;
+        const effects = t.effects;
+        collectTraitRefsFromEffects(effects, out);
+      }
+      const initialEffects = target.initialEffects;
+      collectTraitRefsFromEffects(initialEffects, out);
+      const ticks2 = target.ticks;
+      if (Array.isArray(ticks2)) {
+        for (const tick of ticks2) {
+          collectTraitRefsFromEffects(tick?.effects, out);
+        }
+      }
+    }
+  }
+  return out;
+}
+
+// runtime/OrbPreview.tsx
 init_SlotsContext();
 init_EntitySchemaContext();
 
@@ -38935,6 +39008,38 @@ init_EntitySchemaContext();
 init_useEventBus();
 init_logger();
 var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
+function createHttpTransport(serverUrl) {
+  return {
+    register: async (schema) => {
+      try {
+        const res = await fetch(`${serverUrl}/register`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ schema })
+        });
+        const result = await res.json();
+        return !!result.success;
+      } catch (err) {
+        console.error("[ServerBridge] Registration failed:", err);
+        return false;
+      }
+    },
+    unregister: async () => {
+      try {
+        await fetch(`${serverUrl}/unregister`, { method: "DELETE" });
+      } catch {
+      }
+    },
+    sendEvent: async (orbitalName, event, payload) => {
+      const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ event, payload })
+      });
+      return res.json();
+    }
+  };
+}
 var ServerBridgeContext = createContext(null);
 function useServerBridge() {
   const ctx = useContext(ServerBridgeContext);
@@ -38947,40 +39052,34 @@ function useServerBridge() {
 function ServerBridgeProvider({
   schema,
   serverUrl,
+  transport: customTransport,
   children
 }) {
+  if (!serverUrl && !customTransport) {
+    throw new Error("ServerBridgeProvider requires either serverUrl or transport");
+  }
+  if (serverUrl && customTransport) {
+    throw new Error("ServerBridgeProvider accepts serverUrl OR transport, not both");
+  }
   const eventBus = useEventBus();
   const [connected, setConnected] = useState(false);
-  const registerSchema = useCallback(async () => {
-    try {
-      const res = await fetch(`${serverUrl}/register`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ schema })
-      });
-      const result = await res.json();
-      return !!result.success;
-    } catch (err) {
-      console.error("[ServerBridge] Registration failed:", err);
-      return false;
-    }
-  }, [schema, serverUrl]);
-  const unregisterSchema = useCallback(async () => {
-    try {
-      await fetch(`${serverUrl}/unregister`, { method: "DELETE" });
-    } catch {
-    }
-  }, [serverUrl]);
+  const transport = useMemo(
+    () => customTransport ?? createHttpTransport(serverUrl),
+    [serverUrl, customTransport]
+  );
+  const registerSchema = useCallback(
+    async () => transport.register(schema),
+    [schema, transport]
+  );
+  const unregisterSchema = useCallback(
+    async () => transport.unregister(),
+    [transport]
+  );
   const sendEvent = useCallback(async (orbitalName, event, payload) => {
     const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     try {
-      const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ event, payload })
-      });
-      const result = await res.json();
+      const result = await transport.sendEvent(orbitalName, event, payload);
       const effects = [];
       const responseData = result.data || {};
       const dataEntities = {};
@@ -39038,7 +39137,7 @@ function ServerBridgeProvider({
       console.error("[ServerBridge] Event send failed:", err);
       return { effects: [], meta: { ...emptyMeta, error: err instanceof Error ? err.message : String(err) } };
     }
-  }, [connected, serverUrl, eventBus]);
+  }, [connected, transport, eventBus]);
   useEffect(() => {
     if (!schema) return;
     let cancelled = false;
@@ -39225,32 +39324,49 @@ function SlotBridge() {
   }, [slots, render, clear]);
   return null;
 }
-function applyServerEffects(effects, uiSlots, onNavigate) {
+function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits) {
   for (const eff of effects) {
     if (eff.type === "render-ui" && eff.slot && eff.pattern) {
       const patternRecord = eff.pattern;
       const { type: patternType, children, ...inlineProps } = patternRecord;
       const normalizedChildren = Array.isArray(children) ? children.map((c) => normalizeChild(c)) : children;
-      xOrbitalLog3.info("slot-write", {
-        slot: eff.slot,
-        sourceTrait: eff.traitName ?? "server",
-        patternType: typeof patternType === "string" ? patternType : void 0
-      });
-      uiSlots.render({
-        target: eff.slot,
-        pattern: patternType,
-        props: {
-          ...inlineProps,
-          ...normalizedChildren !== void 0 ? { children: normalizedChildren } : {}
-        },
-        sourceTrait: eff.traitName ?? "server"
-      });
+      const sourceTrait = eff.traitName ?? "server";
+      const isEmbedded = embeddedTraits?.has(sourceTrait) ?? false;
+      const props = {
+        ...inlineProps,
+        ...normalizedChildren !== void 0 ? { children: normalizedChildren } : {}
+      };
+      if (isEmbedded) {
+        xOrbitalLog3.info("slot:embed-routed", {
+          sourceTrait,
+          slot: eff.slot,
+          patternType: typeof patternType === "string" ? patternType : void 0
+        });
+        uiSlots.updateTraitContent(sourceTrait, {
+          pattern: patternType,
+          props,
+          priority: 0,
+          animation: "fade"
+        });
+      } else {
+        xOrbitalLog3.info("slot-write", {
+          slot: eff.slot,
+          sourceTrait,
+          patternType: typeof patternType === "string" ? patternType : void 0
+        });
+        uiSlots.render({
+          target: eff.slot,
+          pattern: patternType,
+          props,
+          sourceTrait
+        });
+      }
     } else if (eff.type === "navigate" && eff.route && onNavigate) {
       onNavigate(eff.route, eff.params);
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
@@ -39266,9 +39382,9 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
     for (const name of targets) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
-      applyServerEffects(effects, uiSlots, onNavigate);
+      applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits);
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = useRef(false);
@@ -39308,13 +39424,13 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
           effects: effectTraces,
           timestamp: Date.now()
         });
-        applyServerEffects(effects, uiSlots, onNavigate);
+        applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, embeddedTraits]);
   return null;
 }
-function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLocalFallback, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavigate, onLocalFallback, persistence }) {
   const { traits: traits2, allEntities, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = useMemo(() => {
     if (pageName && traits2.length > 0) return traits2;
@@ -39417,6 +39533,9 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     }
     return map;
   }, [schema]);
+  const embeddedTraits = useMemo(() => {
+    return collectEmbeddedTraits(schema);
+  }, [schema]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(
     EntitySchemaProvider,
     {
@@ -39428,9 +39547,10 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           TraitInitializer,
           {
             traits: allPageTraits,
-            orbitalNames: serverUrl ? pageOrbitalNames : void 0,
+            orbitalNames: serverUrl || transport ? pageOrbitalNames : void 0,
             traitConfigsByName,
             orbitalsByTrait,
+            embeddedTraits,
             onNavigate,
             onLocalFallback,
             persistence
@@ -39441,8 +39561,8 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
       ]
     }
   ) }) });
-  if (serverUrl) {
-    return /* @__PURE__ */ jsx(ServerBridgeProvider, { schema, serverUrl, children: inner });
+  if (serverUrl || transport) {
+    return /* @__PURE__ */ jsx(ServerBridgeProvider, { schema, serverUrl, transport, children: inner });
   }
   return inner;
 }
@@ -39453,8 +39573,12 @@ function OrbPreview({
   height = "400px",
   className,
   serverUrl,
+  transport,
   initialPagePath
 }) {
+  if (serverUrl && transport) {
+    throw new Error("OrbPreview accepts serverUrl OR transport, not both");
+  }
   const [localFallback, setLocalFallback] = useState(false);
   const eventBus = useEventBus();
   const handleLocalFallback = useCallback(() => {
@@ -39476,21 +39600,21 @@ function OrbPreview({
     } else {
       parsed = schema;
     }
-    if (autoMock && !serverUrl) {
+    if (autoMock && !serverUrl && !transport) {
       const prepared = prepareSchemaForPreview(parsed);
       return { ok: true, schema: prepared.schema, mockData: prepared.mockData };
     }
     return { ok: true, schema: parsed, mockData: mockData ?? {} };
-  }, [schema, autoMock, serverUrl, mockData]);
+  }, [schema, autoMock, serverUrl, transport, mockData]);
   const parsedSchema = parseResult.ok ? parseResult.schema : null;
   const effectiveMockData = parseResult.ok ? parseResult.mockData : {};
   const persistence = useMemo(() => {
-    if (!parsedSchema || serverUrl) return void 0;
+    if (!parsedSchema || serverUrl || transport) return void 0;
     if (!autoMock) return void 0;
     const adapter = new InMemoryPersistence();
     adapter.seed(effectiveMockData);
     return adapter;
-  }, [parsedSchema, serverUrl, autoMock, effectiveMockData]);
+  }, [parsedSchema, serverUrl, transport, autoMock, effectiveMockData]);
   const pages = useMemo(() => {
     if (!parsedSchema) return [];
     try {
@@ -39552,6 +39676,7 @@ function OrbPreview({
           {
             schema: parsedSchema,
             serverUrl,
+            transport,
             mockData: effectiveMockData,
             pageName: currentPage,
             onNavigate: handleNavigate,
@@ -39564,5 +39689,47 @@ function OrbPreview({
   );
 }
 OrbPreview.displayName = "OrbPreview";
+function BrowserPlayground({
+  schema,
+  mode = "mock",
+  initialPagePath,
+  height,
+  className
+}) {
+  const [runtime] = useState(
+    () => new OrbitalServerRuntime({ mode, debug: false })
+  );
+  useEffect(() => {
+    void runtime.register(schema);
+    return () => {
+      runtime.unregisterAll();
+    };
+  }, [runtime, schema]);
+  const transport = useMemo(() => ({
+    register: async (s) => {
+      await runtime.register(s);
+      return true;
+    },
+    unregister: async () => {
+      runtime.unregisterAll();
+    },
+    sendEvent: async (orbitalName, event, payload) => {
+      return runtime.processOrbitalEvent(orbitalName, {
+        event,
+        payload
+      });
+    }
+  }), [runtime]);
+  return /* @__PURE__ */ jsx(
+    OrbPreview,
+    {
+      schema,
+      transport,
+      initialPagePath,
+      height,
+      className
+    }
+  );
+}
 
-export { EntitySchemaProvider, OrbPreview, ServerBridgeProvider, SlotsProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearSchemaCache, createClientEffectHandlers, prepareSchemaForPreview, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, useResolvedSchema, useServerBridge, useSlotContent, useSlots, useSlotsActions, useTrait, useTraitContext, useTraitStateMachine };
+export { BrowserPlayground, EntitySchemaProvider, OrbPreview, ServerBridgeProvider, SlotsProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearSchemaCache, createClientEffectHandlers, prepareSchemaForPreview, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, useResolvedSchema, useServerBridge, useSlotContent, useSlots, useSlotsActions, useTrait, useTraitContext, useTraitStateMachine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.10.7",
+  "version": "4.12.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -121,7 +121,7 @@
     "@almadar/core": "^7.0.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/patterns": ">=2.17.1",
-    "@almadar/runtime": "^5.5.0",
+    "@almadar/runtime": "^5.7.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",