@almadar/ui 4.6.10 → 4.6.12

package/dist/avl/index.cjs

@@ -51499,16 +51499,18 @@ function normalizeEventKey(eventKey) {
 function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
+  const traitConfigsByName = options?.traitConfigsByName;
   const manager = React127.useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new runtime.StateMachineManager(traitDefs);
     for (const binding of traitBindings) {
-      if (binding.config !== void 0) {
-        m.setTraitConfig(binding.trait.name, binding.config);
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
       }
     }
     return m;
-  }, [traitBindings]);
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = React127.useState(() => {
     return manager.getAllStates();
   });
@@ -51710,6 +51712,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     const actions = slotsActionsRef.current;
     console.log("[TraitStateMachine] Processing event:", normalizedEvent, "payload:", payload);
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
+    for (const traitName of bindingMap.keys()) {
+      const traitState = currentManager.getState(traitName);
+      eventBus.emit(`${traitName}:DISPATCH`, {
+        event: normalizedEvent,
+        payload,
+        currentState: traitState?.currentState
+      });
+    }
     const results = currentManager.sendEvent(normalizedEvent, payload);
     const emittedByTrait = /* @__PURE__ */ new Map();
     for (const { traitName, result } of results) {
@@ -51892,6 +51902,15 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         }
       }
     }
+    for (const { traitName, result } of results) {
+      const suffix = result.executed ? "SUCCESS" : "ERROR";
+      eventBus.emit(`${traitName}:${normalizedEvent}:${suffix}`, {
+        event: normalizedEvent,
+        payload,
+        newState: result.newState,
+        currentState: result.previousState
+      });
+    }
     for (const { traitName, result } of results) {
       if (result.executed) {
         updateTraitState(traitName, result.newState);
@@ -52338,7 +52357,7 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
@@ -52350,7 +52369,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate, persistence };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = React127.useRef(false);
   React127.useEffect(() => {
@@ -52421,6 +52440,24 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const traitConfigsByName = React127.useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    const orbitals = parsed?.orbitals;
+    if (!orbitals) return map;
+    for (const orb of orbitals) {
+      const traits3 = orb.traits;
+      if (!traits3) continue;
+      for (const t of traits3) {
+        const name = t.name ?? t.ref;
+        const config = t.config;
+        if (typeof name === "string" && config !== void 0) {
+          map[name] = config;
+        }
+      }
+    }
+    return map;
+  }, [schema]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(
     EntitySchemaProvider,
     {
@@ -52444,6 +52481,7 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           {
             traits: allPageTraits,
             orbitalNames: serverUrl ? orbitalNames : void 0,
+            traitConfigsByName,
             onNavigate,
             onLocalFallback,
             persistence

package/dist/avl/index.js

@@ -51453,16 +51453,18 @@ function normalizeEventKey(eventKey) {
 function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
+  const traitConfigsByName = options?.traitConfigsByName;
   const manager = useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new StateMachineManager(traitDefs);
     for (const binding of traitBindings) {
-      if (binding.config !== void 0) {
-        m.setTraitConfig(binding.trait.name, binding.config);
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
       }
     }
     return m;
-  }, [traitBindings]);
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
   });
@@ -51664,6 +51666,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     const actions = slotsActionsRef.current;
     console.log("[TraitStateMachine] Processing event:", normalizedEvent, "payload:", payload);
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
+    for (const traitName of bindingMap.keys()) {
+      const traitState = currentManager.getState(traitName);
+      eventBus.emit(`${traitName}:DISPATCH`, {
+        event: normalizedEvent,
+        payload,
+        currentState: traitState?.currentState
+      });
+    }
     const results = currentManager.sendEvent(normalizedEvent, payload);
     const emittedByTrait = /* @__PURE__ */ new Map();
     for (const { traitName, result } of results) {
@@ -51846,6 +51856,15 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         }
       }
     }
+    for (const { traitName, result } of results) {
+      const suffix = result.executed ? "SUCCESS" : "ERROR";
+      eventBus.emit(`${traitName}:${normalizedEvent}:${suffix}`, {
+        event: normalizedEvent,
+        payload,
+        newState: result.newState,
+        currentState: result.previousState
+      });
+    }
     for (const { traitName, result } of results) {
       if (result.executed) {
         updateTraitState(traitName, result.newState);
@@ -52292,7 +52311,7 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
@@ -52304,7 +52323,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate, persistence };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = useRef(false);
   useEffect(() => {
@@ -52375,6 +52394,24 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const traitConfigsByName = useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    const orbitals = parsed?.orbitals;
+    if (!orbitals) return map;
+    for (const orb of orbitals) {
+      const traits3 = orb.traits;
+      if (!traits3) continue;
+      for (const t of traits3) {
+        const name = t.name ?? t.ref;
+        const config = t.config;
+        if (typeof name === "string" && config !== void 0) {
+          map[name] = config;
+        }
+      }
+    }
+    return map;
+  }, [schema]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(
     EntitySchemaProvider,
     {
@@ -52398,6 +52435,7 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           {
             traits: allPageTraits,
             orbitalNames: serverUrl ? orbitalNames : void 0,
+            traitConfigsByName,
             onNavigate,
             onLocalFallback,
             persistence

package/dist/runtime/index.cjs

@@ -38178,16 +38178,18 @@ function normalizeEventKey(eventKey) {
 function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
+  const traitConfigsByName = options?.traitConfigsByName;
   const manager = React115.useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new runtime.StateMachineManager(traitDefs);
     for (const binding of traitBindings) {
-      if (binding.config !== void 0) {
-        m.setTraitConfig(binding.trait.name, binding.config);
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
       }
     }
     return m;
-  }, [traitBindings]);
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = React115.useState(() => {
     return manager.getAllStates();
   });
@@ -38389,6 +38391,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     const actions = slotsActionsRef.current;
     console.log("[TraitStateMachine] Processing event:", normalizedEvent, "payload:", payload);
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
+    for (const traitName of bindingMap.keys()) {
+      const traitState = currentManager.getState(traitName);
+      eventBus.emit(`${traitName}:DISPATCH`, {
+        event: normalizedEvent,
+        payload,
+        currentState: traitState?.currentState
+      });
+    }
     const results = currentManager.sendEvent(normalizedEvent, payload);
     const emittedByTrait = /* @__PURE__ */ new Map();
     for (const { traitName, result } of results) {
@@ -38571,6 +38581,15 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         }
       }
     }
+    for (const { traitName, result } of results) {
+      const suffix = result.executed ? "SUCCESS" : "ERROR";
+      eventBus.emit(`${traitName}:${normalizedEvent}:${suffix}`, {
+        event: normalizedEvent,
+        payload,
+        newState: result.newState,
+        currentState: result.previousState
+      });
+    }
     for (const { traitName, result } of results) {
       if (result.executed) {
         updateTraitState(traitName, result.newState);
@@ -39138,7 +39157,7 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = context.useUISlots();
@@ -39150,7 +39169,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate, persistence };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = React115.useRef(false);
   React115.useEffect(() => {
@@ -39221,6 +39240,24 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const traitConfigsByName = React115.useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    const orbitals = parsed?.orbitals;
+    if (!orbitals) return map;
+    for (const orb of orbitals) {
+      const traits3 = orb.traits;
+      if (!traits3) continue;
+      for (const t of traits3) {
+        const name = t.name ?? t.ref;
+        const config = t.config;
+        if (typeof name === "string" && config !== void 0) {
+          map[name] = config;
+        }
+      }
+    }
+    return map;
+  }, [schema]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(providers.VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(
     EntitySchemaProvider,
     {
@@ -39244,6 +39281,7 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           {
             traits: allPageTraits,
             orbitalNames: serverUrl ? orbitalNames : void 0,
+            traitConfigsByName,
             onNavigate,
             onLocalFallback,
             persistence

package/dist/runtime/index.js

@@ -38133,16 +38133,18 @@ function normalizeEventKey(eventKey) {
 function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
+  const traitConfigsByName = options?.traitConfigsByName;
   const manager = useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new StateMachineManager(traitDefs);
     for (const binding of traitBindings) {
-      if (binding.config !== void 0) {
-        m.setTraitConfig(binding.trait.name, binding.config);
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
       }
     }
     return m;
-  }, [traitBindings]);
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
   });
@@ -38344,6 +38346,14 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     const actions = slotsActionsRef.current;
     console.log("[TraitStateMachine] Processing event:", normalizedEvent, "payload:", payload);
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
+    for (const traitName of bindingMap.keys()) {
+      const traitState = currentManager.getState(traitName);
+      eventBus.emit(`${traitName}:DISPATCH`, {
+        event: normalizedEvent,
+        payload,
+        currentState: traitState?.currentState
+      });
+    }
     const results = currentManager.sendEvent(normalizedEvent, payload);
     const emittedByTrait = /* @__PURE__ */ new Map();
     for (const { traitName, result } of results) {
@@ -38526,6 +38536,15 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
         }
       }
     }
+    for (const { traitName, result } of results) {
+      const suffix = result.executed ? "SUCCESS" : "ERROR";
+      eventBus.emit(`${traitName}:${normalizedEvent}:${suffix}`, {
+        event: normalizedEvent,
+        payload,
+        newState: result.newState,
+        currentState: result.previousState
+      });
+    }
     for (const { traitName, result } of results) {
       if (result.executed) {
         updateTraitState(traitName, result.newState);
@@ -39093,7 +39112,7 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
@@ -39105,7 +39124,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate, persistence };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = useRef(false);
   useEffect(() => {
@@ -39176,6 +39195,24 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const traitConfigsByName = useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    const orbitals = parsed?.orbitals;
+    if (!orbitals) return map;
+    for (const orb of orbitals) {
+      const traits3 = orb.traits;
+      if (!traits3) continue;
+      for (const t of traits3) {
+        const name = t.name ?? t.ref;
+        const config = t.config;
+        if (typeof name === "string" && config !== void 0) {
+          map[name] = config;
+        }
+      }
+    }
+    return map;
+  }, [schema]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(
     EntitySchemaProvider,
     {
@@ -39199,6 +39236,7 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           {
             traits: allPageTraits,
             orbitalNames: serverUrl ? orbitalNames : void 0,
+            traitConfigsByName,
             onNavigate,
             onLocalFallback,
             persistence

package/dist/runtime/useTraitStateMachine.d.ts

@@ -49,6 +49,14 @@ export interface UseTraitStateMachineOptions {
     persistence?: import('@almadar/runtime').PersistenceAdapter;
     /** Optional consumer `call-service` hook forwarded to the mock server handlers. */
     callService?: (service: string, action: string, params: unknown) => Promise<unknown>;
+    /**
+     * Trait configs keyed by trait name. Threaded into setTraitConfig so
+     * `@config.X` resolves inside guard expressions on the client. Page-level
+     * `ResolvedTraitBinding`s often arrive without a config (the orbital-level
+     * config doesn't propagate through `@almadar/core`'s page resolver), so the
+     * caller assembles this map from the orbital schema directly.
+     */
+    traitConfigsByName?: Record<string, import('@almadar/core').TraitConfig>;
 }
 /**
  * useTraitStateMachine - Manages state machines for multiple traits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.6.10",
+  "version": "4.6.12",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",