@almadar/ui 5.14.0 → 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

@@ -23981,11 +23981,13 @@ var init_Coachmark = __esm({
       onSecondary,
       secondaryLabel,
       showBeacon = false,
+      fallbackCentered = false,
       className
     }) => {
       const cardRef = React80.useRef(null);
       const rect = useAnchorRect(anchor, open);
       const [pos, setPos] = React80.useState(null);
+      const centered = open && !rect && fallbackCentered;
       React80.useLayoutEffect(() => {
         if (!open || !rect || !cardRef.current) {
           setPos(null);
@@ -23997,8 +23999,18 @@ var init_Coachmark = __esm({
         };
         setPos(placeCard(placement, rect, size));
       }, [open, rect, placement, children, title]);
-      if (!open || !rect || typeof document === "undefined") return null;
+      React80.useEffect(() => {
+        if (!open) return;
+        const onKey = (e) => {
+          if (e.key === "Escape") onDismiss();
+        };
+        window.addEventListener("keydown", onKey);
+        return () => window.removeEventListener("keydown", onKey);
+      }, [open, onDismiss]);
+      if (!open || typeof document === "undefined") return null;
+      if (!rect && !centered) return null;
       const hasFooter = Boolean(onPrimary || onSecondary);
+      const cardStyle = centered ? { top: "50%", left: "50%", transform: "translate(-50%, -50%)" } : pos ? { top: pos.top, left: pos.left } : { top: -9999, left: -9999 };
       const card = /* @__PURE__ */ jsxRuntime.jsxs(
         exports.Box,
         {
@@ -24012,10 +24024,10 @@ var init_Coachmark = __esm({
           "aria-label": title,
           className: cn(
             "fixed z-50 max-w-xs w-72 transition-opacity duration-150",
-            pos ? "opacity-100" : "opacity-0",
+            centered || pos ? "opacity-100" : "opacity-0",
             className
           ),
-          style: pos ? { top: pos.top, left: pos.left } : { top: -9999, left: -9999 },
+          style: cardStyle,
           children: [
             /* @__PURE__ */ jsxRuntime.jsx(
               "button",
@@ -24036,7 +24048,7 @@ var init_Coachmark = __esm({
           ]
         }
       );
-      const beacon = showBeacon ? /* @__PURE__ */ jsxRuntime.jsx(
+      const beacon = showBeacon && rect ? /* @__PURE__ */ jsxRuntime.jsx(
         "div",
         {
           className: "fixed z-50 pointer-events-none",
@@ -24102,6 +24114,7 @@ var init_OnboardingSpotlight = __esm({
             open: true,
             anchor: step.anchor,
             placement: step.placement ?? "bottom",
+            fallbackCentered: true,
             title: step.title,
             onDismiss: onSkip,
             onSecondary: onSkip,
@@ -47586,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;
@@ -47617,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,
@@ -47734,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;
@@ -47781,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 })
       }
     );
@@ -47793,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,
@@ -50347,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

@@ -23932,11 +23932,13 @@ var init_Coachmark = __esm({
       onSecondary,
       secondaryLabel,
       showBeacon = false,
+      fallbackCentered = false,
       className
     }) => {
       const cardRef = useRef(null);
       const rect = useAnchorRect(anchor, open);
       const [pos, setPos] = useState(null);
+      const centered = open && !rect && fallbackCentered;
       useLayoutEffect(() => {
         if (!open || !rect || !cardRef.current) {
           setPos(null);
@@ -23948,8 +23950,18 @@ var init_Coachmark = __esm({
         };
         setPos(placeCard(placement, rect, size));
       }, [open, rect, placement, children, title]);
-      if (!open || !rect || typeof document === "undefined") return null;
+      useEffect(() => {
+        if (!open) return;
+        const onKey = (e) => {
+          if (e.key === "Escape") onDismiss();
+        };
+        window.addEventListener("keydown", onKey);
+        return () => window.removeEventListener("keydown", onKey);
+      }, [open, onDismiss]);
+      if (!open || typeof document === "undefined") return null;
+      if (!rect && !centered) return null;
       const hasFooter = Boolean(onPrimary || onSecondary);
+      const cardStyle = centered ? { top: "50%", left: "50%", transform: "translate(-50%, -50%)" } : pos ? { top: pos.top, left: pos.left } : { top: -9999, left: -9999 };
       const card = /* @__PURE__ */ jsxs(
         Box,
         {
@@ -23963,10 +23975,10 @@ var init_Coachmark = __esm({
           "aria-label": title,
           className: cn(
             "fixed z-50 max-w-xs w-72 transition-opacity duration-150",
-            pos ? "opacity-100" : "opacity-0",
+            centered || pos ? "opacity-100" : "opacity-0",
             className
           ),
-          style: pos ? { top: pos.top, left: pos.left } : { top: -9999, left: -9999 },
+          style: cardStyle,
           children: [
             /* @__PURE__ */ jsx(
               "button",
@@ -23987,7 +23999,7 @@ var init_Coachmark = __esm({
           ]
         }
       );
-      const beacon = showBeacon ? /* @__PURE__ */ jsx(
+      const beacon = showBeacon && rect ? /* @__PURE__ */ jsx(
         "div",
         {
           className: "fixed z-50 pointer-events-none",
@@ -24053,6 +24065,7 @@ var init_OnboardingSpotlight = __esm({
             open: true,
             anchor: step.anchor,
             placement: step.placement ?? "bottom",
+            fallbackCentered: true,
             title: step.title,
             onDismiss: onSkip,
             onSecondary: onSkip,
@@ -47537,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;
@@ -47568,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,
@@ -47685,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;
@@ -47732,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 })
       }
     );
@@ -47744,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,
@@ -50298,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/components/molecules/Coachmark.d.ts

@@ -29,6 +29,13 @@ export interface CoachmarkProps {
     secondaryLabel?: string;
     /** Render a pulsing beacon dot over the anchor (keystone hints). */
     showBeacon?: boolean;
+    /**
+     * If the anchor can't be resolved, render the card centered in the viewport
+     * instead of hiding it. Guarantees the card (and its dismiss/skip) is always
+     * reachable — used by OnboardingSpotlight so a missing anchor never traps the
+     * user behind a dimmed backdrop. Default false: a missing anchor hides the card.
+     */
+    fallbackCentered?: boolean;
     className?: string;
 }
 /**

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.0",
+  "version": "5.15.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [