@almadar/ui 4.6.14 → 4.7.0

package/dist/avl/index.cjs

@@ -5374,13 +5374,23 @@ function SlotsProvider({ children }) {
   const setSlotPatterns = React127.useCallback((slot, patterns, source) => {
     const sourceKey = source?.trait ?? DEFAULT_SOURCE_KEY2;
     const entityProp = patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.entity : void 0;
+    const firstPatternType = patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.type : void 0;
     slotLog.debug("setSlotPatterns", {
       slot,
       sourceKey,
       patternCount: patterns.length,
-      firstPatternType: patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.type : void 0,
+      firstPatternType,
       entityRefId: refId(entityProp)
     });
+    if (source?.trait) {
+      xOrbitalLog.info("slot-set", {
+        slot,
+        sourceTrait: source.trait,
+        patternCount: patterns.length,
+        firstPatternType,
+        state: source.state
+      });
+    }
     setSlots((prev) => {
       const prevSlot = prev[slot] ?? {};
       return {
@@ -5402,6 +5412,7 @@ function SlotsProvider({ children }) {
     });
   }, []);
   const clearSlotForSource = React127.useCallback((slot, sourceTrait) => {
+    xOrbitalLog.info("slot-clear-source", { slot, sourceTrait });
     setSlots((prev) => {
       const existing = prev[slot];
       if (!existing || !(sourceTrait in existing)) return prev;
@@ -5438,11 +5449,12 @@ function useSlotsActions() {
   }
   return actions;
 }
-var slotLog, refIds, nextRefId, DEFAULT_SOURCE_KEY2, SlotsStateContext, SlotsActionsContext;
+var slotLog, xOrbitalLog, refIds, nextRefId, DEFAULT_SOURCE_KEY2, SlotsStateContext, SlotsActionsContext;
 var init_SlotsContext = __esm({
   "runtime/ui/SlotsContext.tsx"() {
     init_logger();
     slotLog = createLogger("almadar:ui:slot-render");
+    xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
     DEFAULT_SOURCE_KEY2 = "__default__";
@@ -11178,7 +11190,7 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect87, useRef: useRef87, useCallback: useCallback125, useState: useState125 } = React127__namespace.default;
+      const { useEffect: useEffect87, useRef: useRef87, useCallback: useCallback125, useState: useState124 } = React127__namespace.default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus3 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
@@ -11222,7 +11234,7 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus3();
-        const [clickedPosition, setClickedPosition] = useState125(null);
+        const [clickedPosition, setClickedPosition] = useState124(null);
         const handleMapClick = useCallback125((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
@@ -12323,9 +12335,9 @@ function bindEventBus(eventBus) {
   log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
-    window.__orbitalVerification.sendEvent = (event, payload) => {
-      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
-      log2.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
+    window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
+      const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
+      log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -51500,6 +51512,7 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
   const traitConfigsByName = options?.traitConfigsByName;
+  const orbitalsByTrait = options?.orbitalsByTrait;
   const manager = React127.useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new runtime.StateMachineManager(traitDefs);
@@ -51948,7 +51961,10 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
       for (const { traitName, result } of results) {
         if (!result.executed) continue;
-        eventBus.emit(normalizedEvent, payload, {
+        const orbitalName = orbitalsByTrait?.[traitName];
+        if (!orbitalName) continue;
+        eventBus.emit(`UI:${orbitalName}.${traitName}.${normalizedEvent}`, payload, {
+          orbital: orbitalName,
           trait: traitName,
           fromBridge: true
         });
@@ -51959,7 +51975,13 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     }
     const onEventProcessed = optionsRef.current?.onEventProcessed;
     if (onEventProcessed) {
-      await onEventProcessed(normalizedEvent, payload);
+      const dispatchedOrbitals = /* @__PURE__ */ new Set();
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        const orbital = orbitalsByTrait?.[traitName];
+        if (orbital) dispatchedOrbitals.add(orbital);
+      }
+      await onEventProcessed(normalizedEvent, payload, dispatchedOrbitals);
     }
   }, [entities, eventBus]);
   const drainEventQueue = React127.useCallback(async () => {
@@ -52003,26 +52025,34 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     }
     console.log("[TraitStateMachine] Subscribing to events:", Array.from(allEvents));
     const unsubscribes = [];
-    for (const eventKey of allEvents) {
-      if (eventKey === "INIT" || eventKey === "LOAD" || eventKey === "$MOUNT") {
-        continue;
+    for (const binding of traitBindings) {
+      const traitName = binding.trait.name;
+      const orbitalName = orbitalsByTrait?.[traitName];
+      if (!orbitalName) continue;
+      for (const transition of binding.trait.transitions) {
+        const eventKey = transition.event;
+        if (eventKey === "INIT" || eventKey === "LOAD" || eventKey === "$MOUNT") {
+          continue;
+        }
+        const unsub = eventBus.on(`UI:${orbitalName}.${traitName}.${eventKey}`, (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
+          enqueueAndDrain(eventKey, event.payload);
+        });
+        unsubscribes.push(unsub);
       }
-      const unsub = eventBus.on(`UI:${eventKey}`, (event) => {
-        console.log("[TraitStateMachine] Received event:", `UI:${eventKey}`, event);
-        enqueueAndDrain(eventKey, event.payload);
-      });
-      unsubscribes.push(unsub);
     }
     for (const binding of traitBindings) {
+      const ownOrbital = orbitalsByTrait?.[binding.trait.name];
       const listens = binding.trait.listens ?? [];
       for (const listen of listens) {
-        const expectedTrait = listen.source?.trait;
-        const unsub = eventBus.on(listen.event, (event) => {
-          if (expectedTrait) {
-            const emitTrait = event.source?.trait;
-            if (emitTrait !== expectedTrait) return;
-          }
-          console.log("[TraitStateMachine] listens", binding.trait.name, listen.event, "\u2192", listen.triggers, "from", event.source?.trait);
+        const sourceTrait = listen.source?.trait;
+        if (!sourceTrait) continue;
+        const sourceOrbital = listen.source?.orbital ?? ownOrbital;
+        if (!sourceOrbital) continue;
+        const busKey = `UI:${sourceOrbital}.${sourceTrait}.${listen.event}`;
+        const unsub = eventBus.on(busKey, (event) => {
           enqueueAndDrain(listen.triggers, event.payload);
         });
         unsubscribes.push(unsub);
@@ -52048,6 +52078,8 @@ init_EntitySchemaContext();
 
 // runtime/ServerBridge.tsx
 init_useEventBus();
+init_logger();
+var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
 var ServerBridgeContext = React127.createContext(null);
 function useServerBridge() {
   const ctx = React127.useContext(ServerBridgeContext);
@@ -52125,8 +52157,22 @@ function ServerBridgeProvider({
         }
         if (result.emittedEvents) {
           for (const emitted of result.emittedEvents) {
-            eventBus.emit(`UI:${emitted.event}`, emitted.payload);
-            eventBus.emit(emitted.event, emitted.payload);
+            const evTrait = emitted.source?.trait;
+            if (!evTrait) {
+              xOrbitalLog2.warn("emit:dropped-no-source", {
+                event: emitted.event,
+                dispatchOrbital: orbitalName
+              });
+              continue;
+            }
+            const key = emitted.source?.orbital ? `UI:${emitted.source.orbital}.${evTrait}.${emitted.event}` : `UI:${evTrait}.${emitted.event}`;
+            xOrbitalLog2.info("emit:rebroadcast", {
+              busKey: key,
+              sourceOrbital: emitted.source?.orbital,
+              sourceTrait: evTrait,
+              dispatchOrbital: orbitalName
+            });
+            eventBus.emit(key, emitted.payload);
           }
         }
       } else if (result.error) {
@@ -52247,6 +52293,10 @@ function prepareSchemaForPreview(input) {
   const schema = adjustSchemaForMockData(parsed, mockData);
   return { schema, mockData };
 }
+
+// runtime/OrbPreview.tsx
+init_logger();
+var xOrbitalLog3 = createLogger("almadar:runtime:cross-orbital");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -52326,6 +52376,11 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
       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,
@@ -52340,19 +52395,26 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
-  const onEventProcessed = React127.useCallback(async (event, payload) => {
+  const onEventProcessed = React127.useCallback(async (event, payload, dispatchedOrbitals) => {
     if (!bridge.connected || !orbitalNames?.length) return;
-    for (const name of orbitalNames) {
+    const targets = dispatchedOrbitals && dispatchedOrbitals.size > 0 ? orbitalNames.filter((n) => dispatchedOrbitals.has(n)) : orbitalNames;
+    xOrbitalLog3.info("TraitInitializer:fanout", {
+      event,
+      sentTo: targets,
+      skipped: orbitalNames.filter((n) => !targets.includes(n)),
+      dispatchedOrbitalsSize: dispatchedOrbitals?.size ?? 0
+    });
+    for (const name of targets) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = React127.useRef(false);
   React127.useEffect(() => {
@@ -52402,27 +52464,68 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
   const allPageTraits = React127.useMemo(() => {
     if (pageName && traits2.length > 0) return traits2;
     if (!ir?.pages || ir.pages.size <= 1) return traits2;
-    const combined = [];
+    const firstPage = ir.pages.values().next().value;
+    if (!firstPage) return traits2;
+    const firstPageTraits = [];
     const seen = /* @__PURE__ */ new Set();
-    for (const page of ir.pages.values()) {
-      for (const t of page.traits) {
-        const binding = t;
-        const traitObj = binding.trait;
-        const name = traitObj?.name ?? binding.name ?? "";
-        if (name && !seen.has(name)) {
-          seen.add(name);
-          combined.push(t);
-        }
+    for (const binding of firstPage.traits) {
+      const name = binding.trait.name;
+      if (name && !seen.has(name)) {
+        seen.add(name);
+        firstPageTraits.push(binding);
       }
     }
-    return combined.length > 0 ? combined : traits2;
+    return firstPageTraits.length > 0 ? firstPageTraits : traits2;
   }, [ir, traits2, pageName]);
-  const orbitalNames = React127.useMemo(() => {
+  React127.useMemo(() => {
     const parsed = schema;
     const orbitals = parsed?.orbitals;
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const orbitalsByTrait = React127.useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    if (!parsed?.orbitals) return map;
+    for (const orb of parsed.orbitals) {
+      for (const traitRef of orb.traits) {
+        let traitName;
+        if (typeof traitRef === "string") {
+          const parts = traitRef.split(".");
+          traitName = parts[parts.length - 1];
+        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
+          const parts = traitRef.ref.split(".");
+          traitName = traitRef.name ?? parts[parts.length - 1];
+        } else if ("name" in traitRef && typeof traitRef.name === "string") {
+          traitName = traitRef.name;
+        }
+        if (traitName) map[traitName] = orb.name;
+      }
+    }
+    return map;
+  }, [schema]);
+  const pageOrbitalNames = React127.useMemo(() => {
+    const set = /* @__PURE__ */ new Set();
+    for (const binding of allPageTraits) {
+      const orb = orbitalsByTrait[binding.trait.name];
+      if (orb) set.add(orb);
+    }
+    return Array.from(set);
+  }, [allPageTraits, orbitalsByTrait]);
+  React127.useEffect(() => {
+    const traitNames = allPageTraits.map((b) => b.trait.name);
+    const orbitalsByTraitForPage = {};
+    for (const name of traitNames) {
+      const orb = orbitalsByTrait[name];
+      if (orb) orbitalsByTraitForPage[name] = orb;
+    }
+    xOrbitalLog3.info("SchemaRunner:mount", {
+      pageName,
+      traitNames,
+      orbitalsByTraitForPage,
+      pageOrbitalNames: pageOrbitalNames.join(",")
+    });
+  }, [pageName, allPageTraits, orbitalsByTrait, pageOrbitalNames]);
   const traitConfigsByName = React127.useMemo(() => {
     const map = {};
     const parsed = schema;
@@ -52463,8 +52566,9 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           TraitInitializer,
           {
             traits: allPageTraits,
-            orbitalNames: serverUrl ? orbitalNames : void 0,
+            orbitalNames: serverUrl ? pageOrbitalNames : void 0,
             traitConfigsByName,
+            orbitalsByTrait,
             onNavigate,
             onLocalFallback,
             persistence
@@ -52486,7 +52590,8 @@ function OrbPreview({
   autoMock = false,
   height = "400px",
   className,
-  serverUrl
+  serverUrl,
+  initialPagePath
 }) {
   const [localFallback, setLocalFallback] = React127.useState(false);
   const eventBus = useEventBus();
@@ -52532,7 +52637,17 @@ function OrbPreview({
       return [];
     }
   }, [parsedSchema]);
-  const [currentPage, setCurrentPage] = React127.useState(void 0);
+  const initialPageName = React127.useMemo(() => {
+    if (!initialPagePath) return void 0;
+    const match = pages.find(({ page }) => page.path === initialPagePath);
+    return match?.page.name;
+  }, [pages, initialPagePath]);
+  const [currentPage, setCurrentPage] = React127.useState(initialPageName);
+  React127.useEffect(() => {
+    if (initialPageName && initialPageName !== currentPage) {
+      setCurrentPage(initialPageName);
+    }
+  }, [initialPageName, currentPage]);
   const handleNavigate = React127.useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
     if (match) {