@almadar/ui 3.5.5 → 3.7.0

package/dist/avl/index.cjs

@@ -51497,6 +51497,16 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         });
       }
     }
+    const LIFECYCLE_EVENTS = /* @__PURE__ */ new Set(["INIT", "LOAD", "$MOUNT", "$UNMOUNT", "$FRAME"]);
+    if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        eventBus.emit(normalizedEvent, payload, {
+          trait: traitName,
+          fromBridge: true
+        });
+      }
+    }
     if (results.length > 0) {
       setTraitStates(currentManager.getAllStates());
     }
@@ -51556,6 +51566,21 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       });
       unsubscribes.push(unsub);
     }
+    for (const binding of traitBindings) {
+      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);
+          enqueueAndDrain(listen.triggers, event.payload);
+        });
+        unsubscribes.push(unsub);
+      }
+    }
     return () => {
       for (const unsub of unsubscribes) {
         unsub();

package/dist/avl/index.js

@@ -51451,6 +51451,16 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         });
       }
     }
+    const LIFECYCLE_EVENTS = /* @__PURE__ */ new Set(["INIT", "LOAD", "$MOUNT", "$UNMOUNT", "$FRAME"]);
+    if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        eventBus.emit(normalizedEvent, payload, {
+          trait: traitName,
+          fromBridge: true
+        });
+      }
+    }
     if (results.length > 0) {
       setTraitStates(currentManager.getAllStates());
     }
@@ -51510,6 +51520,21 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       });
       unsubscribes.push(unsub);
     }
+    for (const binding of traitBindings) {
+      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);
+          enqueueAndDrain(listen.triggers, event.payload);
+        });
+        unsubscribes.push(unsub);
+      }
+    }
     return () => {
       for (const unsub of unsubscribes) {
         unsub();

package/dist/components/index.cjs

@@ -40894,6 +40894,9 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         };
         unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
         const directHandler = (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
           dispatch(smEvent, event.payload);
         };
         unsubscribes.push(eventBus.on(smEvent, directHandler));

package/dist/components/index.js

@@ -40849,6 +40849,9 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         };
         unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
         const directHandler = (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
           dispatch(smEvent, event.payload);
         };
         unsubscribes.push(eventBus.on(smEvent, directHandler));

package/dist/hooks/index.cjs

@@ -1254,6 +1254,9 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         };
         unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
         const directHandler = (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
           dispatch(smEvent, event.payload);
         };
         unsubscribes.push(eventBus.on(smEvent, directHandler));

package/dist/hooks/index.js

@@ -1248,6 +1248,9 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         };
         unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
         const directHandler = (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
           dispatch(smEvent, event.payload);
         };
         unsubscribes.push(eventBus.on(smEvent, directHandler));

package/dist/runtime/index.cjs

@@ -38293,6 +38293,16 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         });
       }
     }
+    const LIFECYCLE_EVENTS = /* @__PURE__ */ new Set(["INIT", "LOAD", "$MOUNT", "$UNMOUNT", "$FRAME"]);
+    if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        eventBus.emit(normalizedEvent, payload, {
+          trait: traitName,
+          fromBridge: true
+        });
+      }
+    }
     if (results.length > 0) {
       setTraitStates(currentManager.getAllStates());
     }
@@ -38352,6 +38362,21 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       });
       unsubscribes.push(unsub);
     }
+    for (const binding of traitBindings) {
+      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);
+          enqueueAndDrain(listen.triggers, event.payload);
+        });
+        unsubscribes.push(unsub);
+      }
+    }
     return () => {
       for (const unsub of unsubscribes) {
         unsub();

package/dist/runtime/index.js

@@ -38248,6 +38248,16 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         });
       }
     }
+    const LIFECYCLE_EVENTS = /* @__PURE__ */ new Set(["INIT", "LOAD", "$MOUNT", "$UNMOUNT", "$FRAME"]);
+    if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        eventBus.emit(normalizedEvent, payload, {
+          trait: traitName,
+          fromBridge: true
+        });
+      }
+    }
     if (results.length > 0) {
       setTraitStates(currentManager.getAllStates());
     }
@@ -38307,6 +38317,21 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
       });
       unsubscribes.push(unsub);
     }
+    for (const binding of traitBindings) {
+      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);
+          enqueueAndDrain(listen.triggers, event.payload);
+        });
+        unsubscribes.push(unsub);
+      }
+    }
     return () => {
       for (const unsub of unsubscribes) {
         unsub();

package/dist/runtime/types.d.ts

@@ -6,5 +6,32 @@
  *
  * @packageDocumentation
  */
-export type { TransitionFrom, ResolvedField, ResolvedEntity, ResolvedEntityBinding, ResolvedTraitState, ResolvedTraitEvent, ResolvedTraitTransition, ResolvedTraitGuard, ResolvedTraitTick, ResolvedTraitListener, ResolvedTraitDataEntity, ResolvedTraitUIBinding, ResolvedTrait, ResolvedTraitBinding, ResolvedPattern, ResolvedSectionEvent, ResolvedSection, ResolvedNavigation, ResolvedPage, ResolvedIR, } from '@almadar/core';
+export type { TransitionFrom, ResolvedField, ResolvedEntity, ResolvedEntityBinding, ResolvedTraitState, ResolvedTraitEvent, ResolvedTraitTransition, ResolvedTraitGuard, ResolvedTraitTick, ResolvedTraitDataEntity, ResolvedTraitUIBinding, ResolvedTrait, ResolvedTraitBinding, ResolvedPattern, ResolvedSectionEvent, ResolvedSection, ResolvedNavigation, ResolvedPage, ResolvedIR, } from '@almadar/core';
+import type { ResolvedTraitListener as CoreResolvedTraitListener } from '@almadar/core';
+/**
+ * Listen scope descriptor carried by the resolved orb at runtime.
+ *
+ * Emitted by the compiler in the `listens[i].source` field of each
+ * `ResolvedTraitListener`. Core's type doesn't declare this field yet
+ * (@almadar/core 5.7.0) even though the Rust compiler and .lolo parser
+ * both populate it. We declare it here in @almadar/ui (the consumer)
+ * rather than modify core.
+ *
+ * - `any`: accept emits from any trait
+ * - `trait`: only accept emits whose `BusEvent.source.trait` matches
+ * - `orbital`: only accept emits whose `source.orbital[.trait?]` matches
+ */
+export interface ListenSource {
+    kind?: 'any' | 'trait' | 'orbital';
+    trait?: string;
+    orbital?: string;
+}
+/**
+ * Extended `ResolvedTraitListener` carrying the runtime-only `source`
+ * scope descriptor that `@almadar/core`'s type hasn't picked up yet.
+ * Intended as a local shim until core publishes a version with `source`.
+ */
+export type ResolvedTraitListener = CoreResolvedTraitListener & {
+    source?: ListenSource;
+};
 export { createEmptyResolvedTrait, createEmptyResolvedPage, createResolvedField, inferTsType, isResolvedIR, } from '@almadar/core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "3.5.5",
+  "version": "3.7.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -118,7 +118,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": ">=5.6.1",
+    "@almadar/core": ">=5.7.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/patterns": ">=2.17.1",
     "@almadar/runtime": ">=4.3.0",