@almadar/ui 4.8.0 → 4.9.0

package/dist/components/index.cjs

@@ -189,7 +189,23 @@ function getGlobalEventBus() {
 }
 function useEventBus() {
   const context = React111.useContext(providers.EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = providers.useTraitScope();
+  return React111.useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();
@@ -37341,6 +37357,17 @@ function renderContainedPortal(slot, content, onDismiss) {
       return /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { id: slotId, children: slotContent });
   }
 }
+function MaybeTraitScope({
+  sourceTrait,
+  children
+}) {
+  const schemaCtx = useEntitySchemaOptional();
+  const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+  if (sourceTrait !== void 0 && orbital !== void 0) {
+    return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: sourceTrait, children });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+}
 function UISlotComponent({
   slot,
   portal = false,
@@ -37368,11 +37395,11 @@ function UISlotComponent({
             className: cn("ui-slot", `ui-slot-${slot}`, className),
             "data-pattern": pattern,
             "data-source-trait": sourceTrait,
-            children
+            children: /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait, children })
           }
         );
       }
-      return /* @__PURE__ */ jsxRuntime.jsx(CompiledPortal, { slot, className, pattern, sourceTrait, children });
+      return /* @__PURE__ */ jsxRuntime.jsx(CompiledPortal, { slot, className, pattern, sourceTrait, children: /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait, children }) });
     }
     return /* @__PURE__ */ jsxRuntime.jsx(
       exports.Box,
@@ -37381,7 +37408,7 @@ function UISlotComponent({
         className: cn("ui-slot", `ui-slot-${slot}`, className),
         "data-pattern": pattern,
         "data-source-trait": sourceTrait,
-        children
+        children: /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait, children })
       }
     );
   }
@@ -37427,7 +37454,7 @@ function UISlotComponent({
       className: cn("ui-slot", `ui-slot-${slot}`, className),
       "data-pattern": content.pattern,
       "data-source-trait": content.sourceTrait,
-      children: wrappedContent
+      children: /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait: content.sourceTrait, children: wrappedContent })
     }
   );
 }
@@ -37535,7 +37562,7 @@ function SlotPortal({
   });
   if (!portalRoot) return null;
   const slotId = `slot-${slot}`;
-  const slotContent = /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss });
+  const slotContent = /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait: content.sourceTrait, children: /* @__PURE__ */ jsxRuntime.jsx(SlotContentRenderer, { content, onDismiss }) });
   let wrapper;
   switch (slot) {
     case "modal":

package/dist/components/index.js

@@ -1,8 +1,8 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import * as React111 from 'react';
-import React111__default, { useContext, useRef, useEffect, useCallback, createContext, useState, Suspense, useMemo, lazy, useSyncExternalStore, useLayoutEffect, useId } from 'react';
-import { EventBusContext } from '@almadar/ui/providers';
+import React111__default, { useContext, useMemo, useRef, useEffect, useCallback, createContext, useState, Suspense, lazy, useSyncExternalStore, useLayoutEffect, useId } from 'react';
+import { EventBusContext, useTraitScope, TraitScopeProvider } from '@almadar/ui/providers';
 import * as LucideIcons from 'lucide-react';
 import { Loader2, X, AlertTriangle, Info, AlertCircle, CheckCircle, ChevronDown, List, Printer, ChevronRight, ChevronLeft, XCircle, Wrench, RotateCcw, Send, Code, FileText, WrapText, Check, Copy, Zap, Sword, Move, Heart, Shield, Trash2, Settings, Menu as Menu$1, Search, Bell, LogOut, ChevronUp, MoreHorizontal, Bug, ZoomOut, ZoomIn, Download, Pause, Play, Package, Calendar, Pencil, Eye, Image as Image$1, Upload, ArrowRight, ArrowLeft, Eraser, SkipForward, TrendingUp, TrendingDown, Minus, ArrowUp, ArrowDown, MoreVertical, Circle, Clock, CheckCircle2, HelpCircle, FileQuestion, Inbox, Plus, User, Filter, Star, FileWarning, Tag, DollarSign, Sun, Moon } from 'lucide-react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -144,7 +144,23 @@ function getGlobalEventBus() {
 }
 function useEventBus() {
   const context = useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = useTraitScope();
+  return useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();
@@ -37296,6 +37312,17 @@ function renderContainedPortal(slot, content, onDismiss) {
       return /* @__PURE__ */ jsx(Box, { id: slotId, children: slotContent });
   }
 }
+function MaybeTraitScope({
+  sourceTrait,
+  children
+}) {
+  const schemaCtx = useEntitySchemaOptional();
+  const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
+  if (sourceTrait !== void 0 && orbital !== void 0) {
+    return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
 function UISlotComponent({
   slot,
   portal = false,
@@ -37323,11 +37350,11 @@ function UISlotComponent({
             className: cn("ui-slot", `ui-slot-${slot}`, className),
             "data-pattern": pattern,
             "data-source-trait": sourceTrait,
-            children
+            children: /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait, children })
           }
         );
       }
-      return /* @__PURE__ */ jsx(CompiledPortal, { slot, className, pattern, sourceTrait, children });
+      return /* @__PURE__ */ jsx(CompiledPortal, { slot, className, pattern, sourceTrait, children: /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait, children }) });
     }
     return /* @__PURE__ */ jsx(
       Box,
@@ -37336,7 +37363,7 @@ function UISlotComponent({
         className: cn("ui-slot", `ui-slot-${slot}`, className),
         "data-pattern": pattern,
         "data-source-trait": sourceTrait,
-        children
+        children: /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait, children })
       }
     );
   }
@@ -37382,7 +37409,7 @@ function UISlotComponent({
       className: cn("ui-slot", `ui-slot-${slot}`, className),
       "data-pattern": content.pattern,
       "data-source-trait": content.sourceTrait,
-      children: wrappedContent
+      children: /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait: content.sourceTrait, children: wrappedContent })
     }
   );
 }
@@ -37490,7 +37517,7 @@ function SlotPortal({
   });
   if (!portalRoot) return null;
   const slotId = `slot-${slot}`;
-  const slotContent = /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss });
+  const slotContent = /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait: content.sourceTrait, children: /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss }) });
   let wrapper;
   switch (slot) {
     case "modal":

package/dist/components/organisms/game/three/index.cjs

@@ -1499,7 +1499,23 @@ var fallbackEventBus = {
 };
 function useEventBus() {
   const context = React21.useContext(providers.EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = providers.useTraitScope();
+  return React21.useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEmitEvent() {
   const eventBus = useEventBus();

package/dist/components/organisms/game/three/index.js

@@ -8,7 +8,7 @@ import { GLTFLoader as GLTFLoader$1 } from 'three/examples/jsm/loaders/GLTFLoade
 import { OrbitControls as OrbitControls$1 } from 'three/examples/jsm/controls/OrbitControls.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
-import { EventBusContext } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';
@@ -1475,7 +1475,23 @@ var fallbackEventBus = {
 };
 function useEventBus() {
   const context = useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = useTraitScope();
+  return useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEmitEvent() {
   const eventBus = useEventBus();

package/dist/docs/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var React4 = require('react');
+var React5 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var LucideIcons = require('lucide-react');
 
@@ -24,7 +24,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React4__default = /*#__PURE__*/_interopDefault(React4);
+var React5__default = /*#__PURE__*/_interopDefault(React5);
 var LucideIcons__namespace = /*#__PURE__*/_interopNamespace(LucideIcons);
 
 // node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
@@ -2556,7 +2556,11 @@ function createLogger(namespace) {
 }
 createLogger("almadar:eventbus");
 createLogger("almadar:eventbus:subscribe");
-var EventBusContext = React4.createContext(null);
+var EventBusContext = React5.createContext(null);
+var TraitScopeContext = React5.createContext(null);
+function useTraitScope() {
+  return React5.useContext(TraitScopeContext);
+}
 
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
@@ -2632,8 +2636,24 @@ var fallbackEventBus = {
   }
 };
 function useEventBus() {
-  const context = React4.useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const context = React5.useContext(EventBusContext);
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = useTraitScope();
+  return React5.useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 var paddingStyles = {
   none: "p-0",
@@ -2737,7 +2757,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React4__default.default.forwardRef(
+var Box = React5__default.default.forwardRef(
   ({
     padding,
     paddingX,
@@ -2767,20 +2787,20 @@ var Box = React4__default.default.forwardRef(
     ...rest
   }, ref) => {
     const eventBus = useEventBus();
-    const handleClick = React4.useCallback((e) => {
+    const handleClick = React5.useCallback((e) => {
       if (action) {
         e.stopPropagation();
         eventBus.emit(`UI:${action}`, actionPayload ?? {});
       }
       onClick?.(e);
     }, [action, actionPayload, eventBus, onClick]);
-    const handleMouseEnter = React4.useCallback((e) => {
+    const handleMouseEnter = React5.useCallback((e) => {
       if (hoverEvent) {
         eventBus.emit(`UI:${hoverEvent}`, { hovered: true });
       }
       onMouseEnter?.(e);
     }, [hoverEvent, eventBus, onMouseEnter]);
-    const handleMouseLeave = React4.useCallback((e) => {
+    const handleMouseLeave = React5.useCallback((e) => {
       if (hoverEvent) {
         eventBus.emit(`UI:${hoverEvent}`, { hovered: false });
       }
@@ -3166,7 +3186,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsxRuntime.jsx(IconComp, { className: sizeClass });
   }
-  if (React4__default.default.isValidElement(value)) {
+  if (React5__default.default.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -3175,7 +3195,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React4__default.default.forwardRef(
+var Button = React5__default.default.forwardRef(
   ({
     className,
     variant = "primary",
@@ -3278,7 +3298,7 @@ var shadowStyles2 = {
   md: "shadow",
   lg: "shadow-lg"
 };
-var Card = React4__default.default.forwardRef(
+var Card = React5__default.default.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -3314,9 +3334,9 @@ var Card = React4__default.default.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React4__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React5__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React4__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+var CardTitle = React5__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
   "h3",
   {
     ref,
@@ -3329,11 +3349,11 @@ var CardTitle = React4__default.default.forwardRef(({ className, ...props }, ref
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React4__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React5__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React4__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
+var CardFooter = React5__default.default.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsxRuntime.jsx(
   "div",
   {
     ref,
@@ -3412,7 +3432,7 @@ var Divider = ({
   );
 };
 Divider.displayName = "Divider";
-var Input = React4__default.default.forwardRef(
+var Input = React5__default.default.forwardRef(
   ({
     className,
     inputType,
@@ -3525,7 +3545,7 @@ var Input = React4__default.default.forwardRef(
 );
 Input.displayName = "Input";
 var DocSidebarCategory = ({ item, depth }) => {
-  const [expanded, setExpanded] = React4.useState(
+  const [expanded, setExpanded] = React5.useState(
     () => item.items?.some(function hasActive(child) {
       if (child.active) return true;
       return child.items?.some(hasActive) ?? false;
@@ -3680,7 +3700,7 @@ var DocBreadcrumb = ({
       "aria-label": "Breadcrumb",
       children: /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "xs", align: "center", wrap: true, children: items.map((item, idx) => {
         const isLast = idx === items.length - 1;
-        return /* @__PURE__ */ jsxRuntime.jsxs(React4__default.default.Fragment, { children: [
+        return /* @__PURE__ */ jsxRuntime.jsxs(React5__default.default.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsxRuntime.jsx(
             Icon,
             {
@@ -3732,8 +3752,8 @@ function DocCodeBlock({
   showLineNumbers = false,
   className
 }) {
-  const [copied, setCopied] = React4.useState(false);
-  const handleCopy = React4.useCallback(() => {
+  const [copied, setCopied] = React5.useState(false);
+  const handleCopy = React5.useCallback(() => {
     void navigator.clipboard.writeText(code).then(() => {
       setCopied(true);
       setTimeout(() => setCopied(false), 2e3);
@@ -3898,13 +3918,13 @@ function DocSearch({
   onSearch,
   className
 }) {
-  const [query, setQuery] = React4.useState("");
-  const [results, setResults] = React4.useState([]);
-  const [isOpen, setIsOpen] = React4.useState(false);
-  const [activeIndex, setActiveIndex] = React4.useState(-1);
-  const containerRef = React4.useRef(null);
-  const debounceRef = React4.useRef(void 0);
-  React4.useEffect(() => {
+  const [query, setQuery] = React5.useState("");
+  const [results, setResults] = React5.useState([]);
+  const [isOpen, setIsOpen] = React5.useState(false);
+  const [activeIndex, setActiveIndex] = React5.useState(-1);
+  const containerRef = React5.useRef(null);
+  const debounceRef = React5.useRef(void 0);
+  React5.useEffect(() => {
     function handleClickOutside(e) {
       if (containerRef.current && !containerRef.current.contains(e.target)) {
         setIsOpen(false);
@@ -3913,7 +3933,7 @@ function DocSearch({
     document.addEventListener("mousedown", handleClickOutside);
     return () => document.removeEventListener("mousedown", handleClickOutside);
   }, []);
-  const performSearch = React4.useCallback(
+  const performSearch = React5.useCallback(
     (value) => {
       if (!onSearch || !value.trim()) {
         setResults([]);
@@ -3935,7 +3955,7 @@ function DocSearch({
     },
     [onSearch]
   );
-  const handleChange = React4.useCallback(
+  const handleChange = React5.useCallback(
     (e) => {
       const value = e.target.value;
       setQuery(value);
@@ -3948,18 +3968,18 @@ function DocSearch({
     },
     [performSearch]
   );
-  const handleFocus = React4.useCallback(() => {
+  const handleFocus = React5.useCallback(() => {
     if (results.length > 0) {
       setIsOpen(true);
     }
   }, [results]);
-  const navigateTo = React4.useCallback((href) => {
+  const navigateTo = React5.useCallback((href) => {
     setIsOpen(false);
     setQuery("");
     setResults([]);
     window.location.href = href;
   }, []);
-  const handleKeyDown = React4.useCallback(
+  const handleKeyDown = React5.useCallback(
     (e) => {
       if (e.key === "Escape") {
         setIsOpen(false);
@@ -3986,7 +4006,7 @@ function DocSearch({
     },
     [isOpen, results, activeIndex, navigateTo]
   );
-  React4.useEffect(() => {
+  React5.useEffect(() => {
     return () => {
       if (debounceRef.current) {
         clearTimeout(debounceRef.current);

package/dist/docs/index.js

@@ -1,4 +1,4 @@
-import React4, { createContext, useCallback, useContext, useState, useRef, useEffect } from 'react';
+import React5, { createContext, useCallback, useContext, useMemo, useState, useRef, useEffect } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import * as LucideIcons from 'lucide-react';
 import { Loader2, ChevronDown, X } from 'lucide-react';
@@ -2533,6 +2533,10 @@ function createLogger(namespace) {
 createLogger("almadar:eventbus");
 createLogger("almadar:eventbus:subscribe");
 var EventBusContext = createContext(null);
+var TraitScopeContext = createContext(null);
+function useTraitScope() {
+  return useContext(TraitScopeContext);
+}
 
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
@@ -2609,7 +2613,23 @@ var fallbackEventBus = {
 };
 function useEventBus() {
   const context = useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = useTraitScope();
+  return useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 var paddingStyles = {
   none: "p-0",
@@ -2713,7 +2733,7 @@ var positionStyles = {
   fixed: "fixed",
   sticky: "sticky"
 };
-var Box = React4.forwardRef(
+var Box = React5.forwardRef(
   ({
     padding,
     paddingX,
@@ -3142,7 +3162,7 @@ function resolveIconProp(value, sizeClass) {
     const IconComp = value;
     return /* @__PURE__ */ jsx(IconComp, { className: sizeClass });
   }
-  if (React4.isValidElement(value)) {
+  if (React5.isValidElement(value)) {
     return value;
   }
   if (typeof value === "object" && value !== null && "render" in value) {
@@ -3151,7 +3171,7 @@ function resolveIconProp(value, sizeClass) {
   }
   return value;
 }
-var Button = React4.forwardRef(
+var Button = React5.forwardRef(
   ({
     className,
     variant = "primary",
@@ -3254,7 +3274,7 @@ var shadowStyles2 = {
   md: "shadow",
   lg: "shadow-lg"
 };
-var Card = React4.forwardRef(
+var Card = React5.forwardRef(
   ({
     className,
     variant = "bordered",
@@ -3290,9 +3310,9 @@ var Card = React4.forwardRef(
   }
 );
 Card.displayName = "Card";
-var CardHeader = React4.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
+var CardHeader = React5.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("mb-4", className), ...props }));
 CardHeader.displayName = "CardHeader";
-var CardTitle = React4.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardTitle = React5.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "h3",
   {
     ref,
@@ -3305,11 +3325,11 @@ var CardTitle = React4.forwardRef(({ className, ...props }, ref) => /* @__PURE__
   }
 ));
 CardTitle.displayName = "CardTitle";
-var CardContent = React4.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
+var CardContent = React5.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx("div", { ref, className: cn("", className), ...props }));
 CardContent.displayName = "CardContent";
 var CardBody = CardContent;
 CardBody.displayName = "CardBody";
-var CardFooter = React4.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
+var CardFooter = React5.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ jsx(
   "div",
   {
     ref,
@@ -3388,7 +3408,7 @@ var Divider = ({
   );
 };
 Divider.displayName = "Divider";
-var Input = React4.forwardRef(
+var Input = React5.forwardRef(
   ({
     className,
     inputType,
@@ -3656,7 +3676,7 @@ var DocBreadcrumb = ({
       "aria-label": "Breadcrumb",
       children: /* @__PURE__ */ jsx(HStack, { gap: "xs", align: "center", wrap: true, children: items.map((item, idx) => {
         const isLast = idx === items.length - 1;
-        return /* @__PURE__ */ jsxs(React4.Fragment, { children: [
+        return /* @__PURE__ */ jsxs(React5.Fragment, { children: [
           idx > 0 && /* @__PURE__ */ jsx(
             Icon,
             {

package/dist/hooks/index.cjs

@@ -991,7 +991,23 @@ var fallbackEventBus = {
 };
 function useEventBus() {
   const context = react.useContext(providers.EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = providers.useTraitScope();
+  return react.useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();

package/dist/hooks/index.js

@@ -1,5 +1,5 @@
 import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
-import { EventBusContext } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 
 function useOrbitalHistory(options) {
@@ -989,7 +989,23 @@ var fallbackEventBus = {
 };
 function useEventBus() {
   const context = useContext(EventBusContext);
-  return context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
+  const scope = useTraitScope();
+  return useMemo(() => {
+    if (!scope) return baseBus;
+    return {
+      ...baseBus,
+      emit: (type, payload, source) => {
+        if (typeof type === "string" && type.startsWith("UI:")) {
+          const tail = type.slice(3);
+          const qualified = tail.includes(".") ? type : `UI:${scope.orbital}.${scope.trait}.${tail}`;
+          baseBus.emit(qualified, payload, source);
+          return;
+        }
+        baseBus.emit(type, payload, source);
+      }
+    };
+  }, [baseBus, scope]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();