@almadar/ui 4.10.7 → 4.12.0

package/dist/avl/index.cjs

@@ -4492,6 +4492,16 @@ function useUISlotManager() {
     },
     []
   );
+  const updateTraitContent = React128.useCallback(
+    (traitName, content) => {
+      const id = generateId();
+      const fullContent = { ...content, id, sourceTrait: traitName };
+      indexTraitRender(traitName, fullContent);
+      notifyTraitSubscribers(traitName, fullContent);
+      return id;
+    },
+    [indexTraitRender, notifyTraitSubscribers]
+  );
   return {
     slots,
     render,
@@ -4503,7 +4513,8 @@ function useUISlotManager() {
     hasContent,
     getContent,
     getTraitContent,
-    subscribeTrait
+    subscribeTrait,
+    updateTraitContent
   };
 }
 var DEFAULT_SOURCE_KEY, MULTI_SOURCE_STACK_TRAIT, ALL_SLOTS, DEFAULT_SLOTS, DEFAULT_SOURCES, idCounter;
@@ -51542,6 +51553,76 @@ function useResolvedSchema(schema, pageName) {
   return result;
 }
 
+// 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;
+}
+
 // hooks/index.ts
 init_useEventBus();
 init_useUISlots();
@@ -52200,6 +52281,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 = React128.createContext(null);
 function useServerBridge() {
   const ctx = React128.useContext(ServerBridgeContext);
@@ -52212,40 +52325,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] = React128.useState(false);
-  const registerSchema = React128.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 = React128.useCallback(async () => {
-    try {
-      await fetch(`${serverUrl}/unregister`, { method: "DELETE" });
-    } catch {
-    }
-  }, [serverUrl]);
+  const transport = React128.useMemo(
+    () => customTransport ?? createHttpTransport(serverUrl),
+    [serverUrl, customTransport]
+  );
+  const registerSchema = React128.useCallback(
+    async () => transport.register(schema),
+    [schema, transport]
+  );
+  const unregisterSchema = React128.useCallback(
+    async () => transport.unregister(),
+    [transport]
+  );
   const sendEvent = React128.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 = {};
@@ -52303,7 +52410,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]);
   React128.useEffect(() => {
     if (!schema) return;
     let cancelled = false;
@@ -52490,32 +52597,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();
@@ -52531,9 +52655,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 = React128.useRef(false);
@@ -52573,13 +52697,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 = React128.useMemo(() => {
     if (pageName && traits2.length > 0) return traits2;
@@ -52682,6 +52806,9 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     }
     return map;
   }, [schema]);
+  const embeddedTraits = React128.useMemo(() => {
+    return collectEmbeddedTraits(schema);
+  }, [schema]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(
     EntitySchemaProvider,
     {
@@ -52693,9 +52820,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
@@ -52706,8 +52834,8 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
       ]
     }
   ) }) });
-  if (serverUrl) {
-    return /* @__PURE__ */ jsxRuntime.jsx(ServerBridgeProvider, { schema, serverUrl, children: inner });
+  if (serverUrl || transport) {
+    return /* @__PURE__ */ jsxRuntime.jsx(ServerBridgeProvider, { schema, serverUrl, transport, children: inner });
   }
   return inner;
 }
@@ -52718,8 +52846,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] = React128.useState(false);
   const eventBus = useEventBus();
   const handleLocalFallback = React128.useCallback(() => {
@@ -52741,21 +52873,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 = React128.useMemo(() => {
-    if (!parsedSchema || serverUrl) return void 0;
+    if (!parsedSchema || serverUrl || transport) return void 0;
     if (!autoMock) return void 0;
     const adapter = new runtime.InMemoryPersistence();
     adapter.seed(effectiveMockData);
     return adapter;
-  }, [parsedSchema, serverUrl, autoMock, effectiveMockData]);
+  }, [parsedSchema, serverUrl, transport, autoMock, effectiveMockData]);
   const pages = React128.useMemo(() => {
     if (!parsedSchema) return [];
     try {
@@ -52817,6 +52949,7 @@ function OrbPreview({
           {
             schema: parsedSchema,
             serverUrl,
+            transport,
             mockData: effectiveMockData,
             pageName: currentPage,
             onNavigate: handleNavigate,