@almadar/ui 5.14.1 → 5.15.0

package/dist/avl/index.cjs

@@ -5485,7 +5485,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;
@@ -56359,7 +56363,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -56390,8 +56394,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsxRuntime.jsx(
       SlotContentRenderer,
@@ -56507,7 +56514,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -56554,6 +56566,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -56566,6 +56585,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -60417,7 +60443,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     embeddedTraitsRef.current = options?.embeddedTraits;
   }, [options?.embeddedTraits]);
   const flushSlot = React98.useCallback(
-    (traitName, slot, patterns) => {
+    (traitName, slot, patterns, source) => {
       const slots = uiSlotsRef.current;
       const embedded = embeddedTraitsRef.current;
       if (patterns.length === 0) {
@@ -60446,7 +60472,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           pattern: patternType,
           props,
           priority: 0,
-          animation: "fade"
+          animation: "fade",
+          transitionEvent: source?.event,
+          fromState: source?.state,
+          entity: source?.entity
         });
         return;
       }
@@ -60460,7 +60489,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         target: slot,
         pattern: patternType,
         props,
-        sourceTrait: traitName
+        sourceTrait: traitName,
+        transitionEvent: source?.event,
+        fromState: source?.state,
+        entity: source?.entity
       });
     },
     []
@@ -60593,7 +60625,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     }
     for (const [slot, patterns] of pendingSlots) {
-      flushSlot(binding.trait.name, slot, patterns);
+      flushSlot(binding.trait.name, slot, patterns, {
+        event: `tick:${tick.name}`,
+        state: currentState,
+        entity: binding.linkedEntity
+      });
     }
   }, [flushSlot]);
   React98.useEffect(() => {
@@ -60845,7 +60881,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               transition: `${result.previousState}->${result.newState}`,
               cleared: patterns.length === 0
             });
-            flushSlot(traitName, slot, patterns);
+            flushSlot(traitName, slot, patterns, {
+              event: eventKey,
+              state: result.previousState,
+              entity: binding.linkedEntity
+            });
           }
         } catch (error) {
           stateLog.error("transition:effect-error", {

package/dist/avl/index.js

@@ -5436,7 +5436,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;
@@ -56310,7 +56314,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -56341,8 +56345,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsx(
       SlotContentRenderer,
@@ -56458,7 +56465,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -56505,6 +56517,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -56517,6 +56536,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -60368,7 +60394,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     embeddedTraitsRef.current = options?.embeddedTraits;
   }, [options?.embeddedTraits]);
   const flushSlot = useCallback(
-    (traitName, slot, patterns) => {
+    (traitName, slot, patterns, source) => {
       const slots = uiSlotsRef.current;
       const embedded = embeddedTraitsRef.current;
       if (patterns.length === 0) {
@@ -60397,7 +60423,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           pattern: patternType,
           props,
           priority: 0,
-          animation: "fade"
+          animation: "fade",
+          transitionEvent: source?.event,
+          fromState: source?.state,
+          entity: source?.entity
         });
         return;
       }
@@ -60411,7 +60440,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         target: slot,
         pattern: patternType,
         props,
-        sourceTrait: traitName
+        sourceTrait: traitName,
+        transitionEvent: source?.event,
+        fromState: source?.state,
+        entity: source?.entity
       });
     },
     []
@@ -60544,7 +60576,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     }
     for (const [slot, patterns] of pendingSlots) {
-      flushSlot(binding.trait.name, slot, patterns);
+      flushSlot(binding.trait.name, slot, patterns, {
+        event: `tick:${tick.name}`,
+        state: currentState,
+        entity: binding.linkedEntity
+      });
     }
   }, [flushSlot]);
   useEffect(() => {
@@ -60796,7 +60832,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               transition: `${result.previousState}->${result.newState}`,
               cleared: patterns.length === 0
             });
-            flushSlot(traitName, slot, patterns);
+            flushSlot(traitName, slot, patterns, {
+              event: eventKey,
+              state: result.previousState,
+              entity: binding.linkedEntity
+            });
           }
         } catch (error) {
           stateLog.error("transition:effect-error", {

package/dist/components/index.cjs

@@ -47599,7 +47599,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47630,8 +47630,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsxRuntime.jsx(
       SlotContentRenderer,
@@ -47747,7 +47750,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47794,6 +47802,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47806,6 +47821,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxRuntime.jsxs(exports.Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -50360,7 +50382,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/components/index.js

@@ -47550,7 +47550,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47581,8 +47581,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsx(
       SlotContentRenderer,
@@ -47698,7 +47701,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47745,6 +47753,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47757,6 +47772,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -50311,7 +50333,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/context/index.cjs

@@ -124,7 +124,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/context/index.js

@@ -122,7 +122,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/hooks/index.cjs

@@ -1131,7 +1131,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/hooks/index.js

@@ -1129,7 +1129,11 @@ function useUISlotManager() {
         priority: config.priority ?? 0,
         animation: config.animation ?? "fade",
         onDismiss: config.onDismiss,
-        sourceTrait: config.sourceTrait
+        sourceTrait: config.sourceTrait,
+        slot: config.target,
+        transitionEvent: config.transitionEvent,
+        fromState: config.fromState,
+        entity: config.entity
       };
       if (config.autoDismissMs && config.autoDismissMs > 0) {
         content.autoDismissAt = Date.now() + config.autoDismissMs;

package/dist/hooks/useUISlots.d.ts

@@ -95,6 +95,14 @@ export interface SlotContent {
     sourceTrait?: string;
     /** Stable node ID from the schema pattern tree (for edit mode overlay targeting) */
     nodeId?: string;
+    /** Slot this content was rendered into (= RenderUIConfig.target) — contextual-edit address. */
+    slot?: string;
+    /** Transition event key that produced this render (raw, as fired). */
+    transitionEvent?: string;
+    /** State the trait was in when this render fired (the from-state). */
+    fromState?: string;
+    /** linkedEntity of the source trait — contextual-edit address. */
+    entity?: string;
 }
 /**
  * Configuration for render_ui effect
@@ -116,6 +124,12 @@ export interface RenderUIConfig {
     onDismiss?: () => void;
     /** Source trait name */
     sourceTrait?: string;
+    /** Transition event key that produced this render (raw, as fired). */
+    transitionEvent?: string;
+    /** State the trait was in when this render fired (the from-state). */
+    fromState?: string;
+    /** linkedEntity of the source trait. */
+    entity?: string;
 }
 /**
  * Callback for slot changes

package/dist/providers/index.cjs

@@ -47666,7 +47666,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47697,8 +47697,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsxRuntime.jsx(
       SlotContentRenderer,
@@ -47814,7 +47817,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47861,6 +47869,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47873,6 +47888,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,

package/dist/providers/index.js

@@ -47617,7 +47617,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47648,8 +47648,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsx(
       SlotContentRenderer,
@@ -47765,7 +47768,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47812,6 +47820,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47824,6 +47839,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,

package/dist/runtime/index.cjs

@@ -47252,7 +47252,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47283,8 +47283,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsxRuntime.jsx(
       SlotContentRenderer,
@@ -47400,7 +47403,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47447,6 +47455,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsxRuntime.jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47459,6 +47474,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -47812,7 +47834,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     embeddedTraitsRef.current = options?.embeddedTraits;
   }, [options?.embeddedTraits]);
   const flushSlot = React85.useCallback(
-    (traitName, slot, patterns) => {
+    (traitName, slot, patterns, source) => {
       const slots = uiSlotsRef.current;
       const embedded = embeddedTraitsRef.current;
       if (patterns.length === 0) {
@@ -47841,7 +47863,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           pattern: patternType,
           props,
           priority: 0,
-          animation: "fade"
+          animation: "fade",
+          transitionEvent: source?.event,
+          fromState: source?.state,
+          entity: source?.entity
         });
         return;
       }
@@ -47855,7 +47880,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         target: slot,
         pattern: patternType,
         props,
-        sourceTrait: traitName
+        sourceTrait: traitName,
+        transitionEvent: source?.event,
+        fromState: source?.state,
+        entity: source?.entity
       });
     },
     []
@@ -47988,7 +48016,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     }
     for (const [slot, patterns] of pendingSlots) {
-      flushSlot(binding.trait.name, slot, patterns);
+      flushSlot(binding.trait.name, slot, patterns, {
+        event: `tick:${tick.name}`,
+        state: currentState,
+        entity: binding.linkedEntity
+      });
     }
   }, [flushSlot]);
   React85.useEffect(() => {
@@ -48240,7 +48272,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               transition: `${result.previousState}->${result.newState}`,
               cleared: patterns.length === 0
             });
-            flushSlot(traitName, slot, patterns);
+            flushSlot(traitName, slot, patterns, {
+              event: eventKey,
+              state: result.previousState,
+              entity: binding.linkedEntity
+            });
           }
         } catch (error) {
           stateLog.error("transition:effect-error", {

package/dist/runtime/index.js

@@ -47203,7 +47203,7 @@ function getToastPosition(position) {
       return "top-4 right-4";
   }
 }
-function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait) {
+function renderPatternChildren(children, onDismiss, parentId = "root", parentPath = "root", sourceTrait, orbCtx) {
   if (children === void 0 || children === null) return null;
   const childrenArray = Array.isArray(children) ? children : typeof children === "string" || typeof children === "object" && "type" in children ? [children] : [];
   if (childrenArray.length === 0) return null;
@@ -47234,8 +47234,11 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       nodeId: child._id,
       // Inherit sourceTrait from the parent slot so nested patterns
       // (e.g. form-section inside a stack) can resolve entityDef via
-      // the trait's linkedEntity for form-field enrichment.
-      ...sourceTrait !== void 0 && { sourceTrait }
+      // the trait's linkedEntity for form-field enrichment. The orbCtx
+      // (slot/transition/state/entity) propagates the same way so every
+      // nested node carries a complete contextual-edit address.
+      ...sourceTrait !== void 0 && { sourceTrait },
+      ...orbCtx ?? {}
     };
     return /* @__PURE__ */ jsx(
       SlotContentRenderer,
@@ -47351,7 +47354,12 @@ function SlotContentRenderer({
     const isSingleChild = typeof childrenConfig === "string" || typeof childrenConfig === "object" && childrenConfig !== null && !Array.isArray(childrenConfig) && "type" in childrenConfig;
     const hasChildren = PATTERNS_WITH_CHILDREN.has(content.pattern) || Array.isArray(childrenConfig) && childrenConfig.length > 0 || isSingleChild;
     const myPath = patternPath ?? "root";
-    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait) : void 0;
+    const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath, content.sourceTrait, {
+      slot: content.slot,
+      transitionEvent: content.transitionEvent,
+      fromState: content.fromState,
+      entity: content.entity
+    }) : void 0;
     const incomingChildren = content.props.children;
     const childrenIsRenderFn = typeof incomingChildren === "function";
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
@@ -47398,6 +47406,13 @@ function SlotContentRenderer({
         "data-pattern-path": myPath,
         "data-pattern-type": content.pattern,
         "data-accepts-children": acceptsChildren ? "true" : void 0,
+        "data-orb-trait": content.sourceTrait,
+        "data-orb-slot": content.slot,
+        "data-orb-transition": content.transitionEvent,
+        "data-orb-state": content.fromState,
+        "data-orb-entity": content.entity,
+        "data-orb-path": myPath,
+        "data-orb-pattern": content.pattern,
         children: renderedChildren !== void 0 ? /* @__PURE__ */ jsx(PatternComponent, { ...finalProps, children: renderedChildren }) : /* @__PURE__ */ jsx(PatternComponent, { ...finalProps })
       }
     );
@@ -47410,6 +47425,13 @@ function SlotContentRenderer({
       "data-id": content.id,
       "data-node-id": content.nodeId,
       "data-source-trait": content.sourceTrait,
+      "data-orb-trait": content.sourceTrait,
+      "data-orb-slot": content.slot,
+      "data-orb-transition": content.transitionEvent,
+      "data-orb-state": content.fromState,
+      "data-orb-entity": content.entity,
+      "data-orb-path": patternPath ?? "root",
+      "data-orb-pattern": content.pattern,
       children: content.props.children ?? /* @__PURE__ */ jsxs(Box, { className: "p-4 text-sm text-muted-foreground border border-dashed border-border rounded", children: [
         "Unknown pattern: ",
         content.pattern,
@@ -47763,7 +47785,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     embeddedTraitsRef.current = options?.embeddedTraits;
   }, [options?.embeddedTraits]);
   const flushSlot = useCallback(
-    (traitName, slot, patterns) => {
+    (traitName, slot, patterns, source) => {
       const slots = uiSlotsRef.current;
       const embedded = embeddedTraitsRef.current;
       if (patterns.length === 0) {
@@ -47792,7 +47814,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           pattern: patternType,
           props,
           priority: 0,
-          animation: "fade"
+          animation: "fade",
+          transitionEvent: source?.event,
+          fromState: source?.state,
+          entity: source?.entity
         });
         return;
       }
@@ -47806,7 +47831,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         target: slot,
         pattern: patternType,
         props,
-        sourceTrait: traitName
+        sourceTrait: traitName,
+        transitionEvent: source?.event,
+        fromState: source?.state,
+        entity: source?.entity
       });
     },
     []
@@ -47939,7 +47967,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     }
     for (const [slot, patterns] of pendingSlots) {
-      flushSlot(binding.trait.name, slot, patterns);
+      flushSlot(binding.trait.name, slot, patterns, {
+        event: `tick:${tick.name}`,
+        state: currentState,
+        entity: binding.linkedEntity
+      });
     }
   }, [flushSlot]);
   useEffect(() => {
@@ -48191,7 +48223,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               transition: `${result.previousState}->${result.newState}`,
               cleared: patterns.length === 0
             });
-            flushSlot(traitName, slot, patterns);
+            flushSlot(traitName, slot, patterns, {
+              event: eventKey,
+              state: result.previousState,
+              entity: binding.linkedEntity
+            });
           }
         } catch (error) {
           stateLog.error("transition:effect-error", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.14.1",
+  "version": "5.15.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [