@almadar/ui 4.10.3 → 4.10.5

package/dist/avl/index.cjs

@@ -3145,13 +3145,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return React128.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -3183,7 +3196,7 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog2, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog2, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
@@ -3192,6 +3205,7 @@ var init_useEventBus = __esm({
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog2 = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -46676,7 +46690,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsxRuntime.jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
@@ -47161,7 +47183,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -47177,10 +47199,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = React128.createContext({ enabled: false });
     SlotContainedContext = React128.createContext(false);

package/dist/avl/index.js

@@ -3099,13 +3099,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -3137,7 +3150,7 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog2, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog2, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
@@ -3146,6 +3159,7 @@ var init_useEventBus = __esm({
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog2 = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -46630,7 +46644,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsx(Fragment, { children });
@@ -47115,7 +47137,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -47131,10 +47153,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);

package/dist/components/index.cjs

@@ -192,13 +192,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = providers.useTraitScope();
   return React111.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -230,13 +243,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37363,7 +37377,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
@@ -37848,7 +37870,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37862,10 +37884,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = React111.createContext({ enabled: false });
     SlotContainedContext = React111.createContext(false);

package/dist/components/index.js

@@ -147,13 +147,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -185,13 +198,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37318,7 +37332,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsx(Fragment, { children });
@@ -37803,7 +37825,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37817,10 +37839,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);

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

@@ -1427,6 +1427,7 @@ function createLogger(namespace) {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -1502,13 +1503,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = providers.useTraitScope();
   return React21.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

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

@@ -1403,6 +1403,7 @@ function createLogger(namespace) {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -1478,13 +1479,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/docs/index.cjs

@@ -2565,6 +2565,7 @@ function useTraitScope() {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog2 = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2640,13 +2641,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return React5.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/docs/index.js

@@ -2541,6 +2541,7 @@ function useTraitScope() {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog2 = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2616,13 +2617,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/hooks/index.cjs

@@ -919,6 +919,7 @@ function createLogger(namespace) {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -994,13 +995,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = providers.useTraitScope();
   return react.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/hooks/index.js

@@ -917,6 +917,7 @@ function createLogger(namespace) {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -992,13 +993,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/marketing/index.cjs

@@ -2565,6 +2565,7 @@ function useTraitScope() {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog2 = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2640,13 +2641,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return React6.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/marketing/index.js

@@ -2541,6 +2541,7 @@ function useTraitScope() {
 // hooks/useEventBus.ts
 var log = createLogger("almadar:eventbus");
 var subLog2 = createLogger("almadar:eventbus:subscribe");
+var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2616,13 +2617,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }

package/dist/providers/index.cjs

@@ -439,13 +439,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = providers.useTraitScope();
   return React116.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -477,13 +490,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37876,7 +37890,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
@@ -38361,7 +38383,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38375,10 +38397,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = React116.createContext({ enabled: false });
     SlotContainedContext = React116.createContext(false);

package/dist/providers/index.js

@@ -394,13 +394,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -432,13 +445,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37831,7 +37845,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsx(Fragment, { children });
@@ -38316,7 +38338,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38330,10 +38352,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);

package/dist/runtime/index.cjs

@@ -186,13 +186,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = providers.useTraitScope();
   return React115.useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -224,13 +237,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37563,7 +37577,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
@@ -38048,7 +38070,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38062,10 +38084,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = React115.createContext({ enabled: false });
     SlotContainedContext = React115.createContext(false);

package/dist/runtime/index.js

@@ -141,13 +141,26 @@ function useEventBus() {
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
   const scope = useTraitScope();
   return useMemo(() => {
-    if (!scope) return baseBus;
+    if (!scope) {
+      return {
+        ...baseBus,
+        emit: (type, payload, source) => {
+          if (typeof type === "string" && type.startsWith("UI:") && !type.slice(3).includes(".")) {
+            scopeLog.warn("emit:bare-key-no-scope", { type });
+          }
+          baseBus.emit(type, payload, source);
+        }
+      };
+    }
     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}`;
+          if (qualified !== type) {
+            scopeLog.info("emit:qualified", { from: type, to: qualified, scope });
+          }
           baseBus.emit(qualified, payload, source);
           return;
         }
@@ -179,13 +192,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var log, subLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
+var log, subLog, scopeLog, fallbackListeners, fallbackAnyListeners, fallbackEventBus, useEventSubscription, useEventBus_default;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_logger();
     log = createLogger("almadar:eventbus");
     subLog = createLogger("almadar:eventbus:subscribe");
+    scopeLog = createLogger("almadar:ui:trait-scope");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -37518,7 +37532,15 @@ function MaybeTraitScope({
 }) {
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
-  if (sourceTrait !== void 0 && orbital !== void 0) {
+  const wrap = sourceTrait !== void 0 && orbital !== void 0;
+  scopeWrapLog.info("decide", {
+    sourceTrait,
+    schemaCtxPresent: schemaCtx !== null,
+    orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
+    orbital,
+    wrap
+  });
+  if (wrap) {
     return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
   return /* @__PURE__ */ jsx(Fragment, { children });
@@ -38003,7 +38025,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -38017,10 +38039,12 @@ var init_UISlotRenderer = __esm({
     init_SlotsContext();
     init_cn();
     init_ErrorBoundary();
+    init_logger();
     init_Skeleton();
     init_renderer();
     init_TraitFrame();
     init_component_registry_generated();
+    scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);

package/package.json

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