@almadar/ui 4.6.9 → 4.6.11

package/dist/avl/index.cjs

@@ -51499,10 +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);
-    return new runtime.StateMachineManager(traitDefs);
-  }, [traitBindings]);
+    const m = new runtime.StateMachineManager(traitDefs);
+    for (const binding of traitBindings) {
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
+      }
+    }
+    return m;
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = React127.useState(() => {
     return manager.getAllStates();
   });
@@ -52332,7 +52340,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();
@@ -52344,7 +52352,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(() => {
@@ -52415,6 +52423,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,
     {
@@ -52438,6 +52464,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,10 +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);
-    return new StateMachineManager(traitDefs);
-  }, [traitBindings]);
+    const m = new StateMachineManager(traitDefs);
+    for (const binding of traitBindings) {
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
+      }
+    }
+    return m;
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
   });
@@ -52286,7 +52294,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();
@@ -52298,7 +52306,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(() => {
@@ -52369,6 +52377,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,
     {
@@ -52392,6 +52418,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,10 +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);
-    return new runtime.StateMachineManager(traitDefs);
-  }, [traitBindings]);
+    const m = new runtime.StateMachineManager(traitDefs);
+    for (const binding of traitBindings) {
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
+      }
+    }
+    return m;
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = React115.useState(() => {
     return manager.getAllStates();
   });
@@ -39132,7 +39140,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();
@@ -39144,7 +39152,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(() => {
@@ -39215,6 +39223,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,
     {
@@ -39238,6 +39264,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,10 +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);
-    return new StateMachineManager(traitDefs);
-  }, [traitBindings]);
+    const m = new StateMachineManager(traitDefs);
+    for (const binding of traitBindings) {
+      const cfg = binding.config ?? traitConfigsByName?.[binding.trait.name];
+      if (cfg !== void 0) {
+        m.setTraitConfig(binding.trait.name, cfg);
+      }
+    }
+    return m;
+  }, [traitBindings, traitConfigsByName]);
   const [traitStates, setTraitStates] = useState(() => {
     return manager.getAllStates();
   });
@@ -39087,7 +39095,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();
@@ -39099,7 +39107,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(() => {
@@ -39170,6 +39178,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,
     {
@@ -39193,6 +39219,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.9",
+  "version": "4.6.11",
   "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": "^4.11.1",
+    "@almadar/runtime": "^5.3.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",