@almadar/ui 5.121.3 → 5.121.4

package/dist/hooks/index.cjs

@@ -952,9 +952,9 @@ var fallbackEventBus = {
 function useEventBus() {
   const context = react.useContext(providers.EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
-  const scope = providers.useTraitScope();
+  const chain = providers.useTraitScopeChain();
   return react.useMemo(() => {
-    if (!scope) {
+    if (chain.length === 0) {
       return {
         ...baseBus,
         emit: (type, payload, source) => {
@@ -970,22 +970,31 @@ function useEventBus() {
       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", {
+          const isQualified = tail.includes(".");
+          const event = isQualified ? tail.split(".").slice(2).join(".") : tail;
+          if (!event) {
+            baseBus.emit(type, payload, source);
+            return;
+          }
+          const keys = /* @__PURE__ */ new Set();
+          if (isQualified) keys.add(type);
+          for (const sc of chain) {
+            keys.add(`UI:${sc.orbital}.${sc.trait}.${event}`);
+          }
+          if (keys.size > 1) {
+            scopeLog.info("emit:fan-out", {
               from: type,
-              to: qualified,
-              scopeOrbital: scope.orbital,
-              scopeTrait: scope.trait
+              keys: Array.from(keys),
+              chainDepth: chain.length
             });
           }
-          baseBus.emit(qualified, payload, source);
+          for (const key of keys) baseBus.emit(key, payload, source);
           return;
         }
         baseBus.emit(type, payload, source);
       }
     };
-  }, [baseBus, scope]);
+  }, [baseBus, chain]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();
@@ -1457,6 +1466,16 @@ function useSharedEntityStore() {
   }
   return storeRef.current;
 }
+var SharedEntityStoreContext = react.createContext(null);
+function useSharedEntityStoreContext() {
+  const store = react.useContext(SharedEntityStoreContext);
+  if (!store) {
+    throw new Error(
+      "useSharedEntityStoreContext: no SharedEntityStoreContext.Provider found in the component tree"
+    );
+  }
+  return store;
+}
 function useSharedEntitySnapshot(store, entityId) {
   return react.useSyncExternalStore(
     (onStoreChange) => store.subscribe(entityId, onStoreChange),
@@ -2807,6 +2826,7 @@ function useGitHubBranches(owner, repo, enabled = true) {
 exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.DEFAULT_SLOTS = DEFAULT_SLOTS;
 exports.I18nProvider = I18nProvider;
+exports.SharedEntityStoreContext = SharedEntityStoreContext;
 exports.createSharedEntityStore = createSharedEntityStore;
 exports.createTranslate = createTranslate;
 exports.parseQueryBinding = parseQueryBinding;
@@ -2840,6 +2860,7 @@ exports.useQuerySingleton = useQuerySingleton;
 exports.useRenderInterpolation = useRenderInterpolation;
 exports.useSharedEntitySnapshot = useSharedEntitySnapshot;
 exports.useSharedEntityStore = useSharedEntityStore;
+exports.useSharedEntityStoreContext = useSharedEntityStoreContext;
 exports.useSwipeGesture = useSwipeGesture;
 exports.useTapReveal = useTapReveal;
 exports.useTraitListens = useTraitListens;

package/dist/hooks/index.d.cts

@@ -509,6 +509,22 @@ declare function createSharedEntityStore(): SharedEntityStore;
  * `useSharedEntitySnapshot`.
  */
 declare function useSharedEntityStore(): SharedEntityStore;
+/**
+ * Cross-component access to ONE `SharedEntityStore` instance. `useSharedEntityStore`
+ * is `useRef`-scoped to its own call site — correct for a single owner (the JS
+ * runtime path's `useTraitStateMachine` interprets a whole orbital in one hook
+ * call), but the compiled path (`orbital-rust`'s TS-shell codegen) generates one
+ * hook + component PER TRAIT, so several independent trait hooks bound to the
+ * SAME `[shared]` entity need the SAME store instance. A page-level owner calls
+ * `useSharedEntityStore()` once and provides it here; every trait hook on that
+ * page reads it back via `useSharedEntityStoreContext()` instead of creating its
+ * own disconnected store. Not used by the JS runtime path today — purely
+ * additive, zero effect on `useSharedEntityStore`'s existing single-caller
+ * behavior.
+ */
+declare const SharedEntityStoreContext: React$1.Context<SharedEntityStore | null>;
+/** Read the page-level `SharedEntityStore` provided by `SharedEntityStoreContext`. */
+declare function useSharedEntityStoreContext(): SharedEntityStore;
 /**
  * Bridge one entity's snapshot into React via `useSyncExternalStore` (the
  * codebase's established store->React bridge, see `lib/perf.ts`). The render
@@ -992,4 +1008,4 @@ declare function useGitHubBranches(owner: string, repo: string, enabled?: boolea
     branches: string[];
 }>, Error>;
 
-export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryChangeSummary, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderInterpolationHandle, type RenderInterpolationOptions, type RevertResult, type SelectedFile, type SharedEntityStore, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEventBus, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };
+export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryChangeSummary, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderInterpolationHandle, type RenderInterpolationOptions, type RevertResult, type SelectedFile, type SharedEntityStore, SharedEntityStoreContext, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEventBus, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };

package/dist/hooks/index.d.ts

@@ -509,6 +509,22 @@ declare function createSharedEntityStore(): SharedEntityStore;
  * `useSharedEntitySnapshot`.
  */
 declare function useSharedEntityStore(): SharedEntityStore;
+/**
+ * Cross-component access to ONE `SharedEntityStore` instance. `useSharedEntityStore`
+ * is `useRef`-scoped to its own call site — correct for a single owner (the JS
+ * runtime path's `useTraitStateMachine` interprets a whole orbital in one hook
+ * call), but the compiled path (`orbital-rust`'s TS-shell codegen) generates one
+ * hook + component PER TRAIT, so several independent trait hooks bound to the
+ * SAME `[shared]` entity need the SAME store instance. A page-level owner calls
+ * `useSharedEntityStore()` once and provides it here; every trait hook on that
+ * page reads it back via `useSharedEntityStoreContext()` instead of creating its
+ * own disconnected store. Not used by the JS runtime path today — purely
+ * additive, zero effect on `useSharedEntityStore`'s existing single-caller
+ * behavior.
+ */
+declare const SharedEntityStoreContext: React$1.Context<SharedEntityStore | null>;
+/** Read the page-level `SharedEntityStore` provided by `SharedEntityStoreContext`. */
+declare function useSharedEntityStoreContext(): SharedEntityStore;
 /**
  * Bridge one entity's snapshot into React via `useSyncExternalStore` (the
  * codebase's established store->React bridge, see `lib/perf.ts`). The render
@@ -992,4 +1008,4 @@ declare function useGitHubBranches(owner: string, repo: string, enabled?: boolea
     branches: string[];
 }>, Error>;
 
-export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryChangeSummary, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderInterpolationHandle, type RenderInterpolationOptions, type RevertResult, type SelectedFile, type SharedEntityStore, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEventBus, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };
+export { ALMADAR_DND_MIME, type AuthContextValue, type AuthUser, type CanvasGestureCallbacks, type CanvasGestureHandlers, type CompileResult, type CompileStage, type DragReorderResult, type DraggablePayload, type Extension, type ExtensionManifest, type FileSystemFile, type FileSystemStatus, type GitHubRepo, type GitHubStatus, type HistoryChangeSummary, type HistoryTimelineItem, type I18nContextValue, I18nProvider, type InfiniteScrollOptions, type InfiniteScrollResult, type LongPressHandlers, type LongPressOptions, type OpenFile, type Positioned, type PullToRefreshOptions, type PullToRefreshResult, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, type QueryState, type RenderInterpolationHandle, type RenderInterpolationOptions, type RevertResult, type SelectedFile, type SharedEntityStore, SharedEntityStoreContext, type SharedEntitySubscriber, type SharedEntityWriter, type SwipeGestureOptions, type SwipeGestureResult, type SwipeHandlers, type TapRevealOptions, type TapRevealResult, type TraitListenSpec, type TranslateFunction, type UseCanvasGesturesOptions, type UseCompileResult, type UseDraggableOptions, type UseDraggableResult, type UseDropZoneOptions, type UseDropZoneResult, type UseExtensionsOptions, type UseExtensionsResult, type UseFileEditorOptions, type UseFileEditorResult, type UseFileSystemResult, type UseOrbitalHistoryOptions, type UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEventBus, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation };

package/dist/hooks/index.js

@@ -1,6 +1,6 @@
 import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
 import { createLogger } from '@almadar/logger';
-import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScopeChain } from '@almadar/ui/providers';
 import { mergeEntityFrame } from '@almadar/core';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 
@@ -950,9 +950,9 @@ var fallbackEventBus = {
 function useEventBus() {
   const context = useContext(EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
-  const scope = useTraitScope();
+  const chain = useTraitScopeChain();
   return useMemo(() => {
-    if (!scope) {
+    if (chain.length === 0) {
       return {
         ...baseBus,
         emit: (type, payload, source) => {
@@ -968,22 +968,31 @@ function useEventBus() {
       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", {
+          const isQualified = tail.includes(".");
+          const event = isQualified ? tail.split(".").slice(2).join(".") : tail;
+          if (!event) {
+            baseBus.emit(type, payload, source);
+            return;
+          }
+          const keys = /* @__PURE__ */ new Set();
+          if (isQualified) keys.add(type);
+          for (const sc of chain) {
+            keys.add(`UI:${sc.orbital}.${sc.trait}.${event}`);
+          }
+          if (keys.size > 1) {
+            scopeLog.info("emit:fan-out", {
               from: type,
-              to: qualified,
-              scopeOrbital: scope.orbital,
-              scopeTrait: scope.trait
+              keys: Array.from(keys),
+              chainDepth: chain.length
             });
           }
-          baseBus.emit(qualified, payload, source);
+          for (const key of keys) baseBus.emit(key, payload, source);
           return;
         }
         baseBus.emit(type, payload, source);
       }
     };
-  }, [baseBus, scope]);
+  }, [baseBus, chain]);
 }
 function useEventListener(event, handler) {
   const eventBus = useEventBus();
@@ -1455,6 +1464,16 @@ function useSharedEntityStore() {
   }
   return storeRef.current;
 }
+var SharedEntityStoreContext = createContext(null);
+function useSharedEntityStoreContext() {
+  const store = useContext(SharedEntityStoreContext);
+  if (!store) {
+    throw new Error(
+      "useSharedEntityStoreContext: no SharedEntityStoreContext.Provider found in the component tree"
+    );
+  }
+  return store;
+}
 function useSharedEntitySnapshot(store, entityId) {
   return useSyncExternalStore(
     (onStoreChange) => store.subscribe(entityId, onStoreChange),
@@ -2802,4 +2821,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, SharedEntityStoreContext, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/lib/drawable/three/index.cjs

@@ -119,9 +119,9 @@ var fallbackEventBus = {
 function useEventBus() {
   const context = React3.useContext(providers.EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
-  const scope = providers.useTraitScope();
+  const chain = providers.useTraitScopeChain();
   return React3.useMemo(() => {
-    if (!scope) {
+    if (chain.length === 0) {
       return {
         ...baseBus,
         emit: (type, payload, source) => {
@@ -137,22 +137,31 @@ function useEventBus() {
       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", {
+          const isQualified = tail.includes(".");
+          const event = isQualified ? tail.split(".").slice(2).join(".") : tail;
+          if (!event) {
+            baseBus.emit(type, payload, source);
+            return;
+          }
+          const keys = /* @__PURE__ */ new Set();
+          if (isQualified) keys.add(type);
+          for (const sc of chain) {
+            keys.add(`UI:${sc.orbital}.${sc.trait}.${event}`);
+          }
+          if (keys.size > 1) {
+            scopeLog.info("emit:fan-out", {
               from: type,
-              to: qualified,
-              scopeOrbital: scope.orbital,
-              scopeTrait: scope.trait
+              keys: Array.from(keys),
+              chainDepth: chain.length
             });
           }
-          baseBus.emit(qualified, payload, source);
+          for (const key of keys) baseBus.emit(key, payload, source);
           return;
         }
         baseBus.emit(type, payload, source);
       }
     };
-  }, [baseBus, scope]);
+  }, [baseBus, chain]);
 }
 function useEmitEvent() {
   const eventBus = useEventBus();

package/dist/lib/drawable/three/index.js

@@ -1,5 +1,5 @@
 import React3, { forwardRef, useRef, useState, useEffect, useMemo, useImperativeHandle, useCallback, createContext, useContext, Component, useReducer } from 'react';
-import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScopeChain } from '@almadar/ui/providers';
 import { createLogger } from '@almadar/logger';
 import { Canvas, useThree, useFrame } from '@react-three/fiber';
 import * as THREE9 from 'three';
@@ -95,9 +95,9 @@ var fallbackEventBus = {
 function useEventBus() {
   const context = useContext(EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
-  const scope = useTraitScope();
+  const chain = useTraitScopeChain();
   return useMemo(() => {
-    if (!scope) {
+    if (chain.length === 0) {
       return {
         ...baseBus,
         emit: (type, payload, source) => {
@@ -113,22 +113,31 @@ function useEventBus() {
       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", {
+          const isQualified = tail.includes(".");
+          const event = isQualified ? tail.split(".").slice(2).join(".") : tail;
+          if (!event) {
+            baseBus.emit(type, payload, source);
+            return;
+          }
+          const keys = /* @__PURE__ */ new Set();
+          if (isQualified) keys.add(type);
+          for (const sc of chain) {
+            keys.add(`UI:${sc.orbital}.${sc.trait}.${event}`);
+          }
+          if (keys.size > 1) {
+            scopeLog.info("emit:fan-out", {
               from: type,
-              to: qualified,
-              scopeOrbital: scope.orbital,
-              scopeTrait: scope.trait
+              keys: Array.from(keys),
+              chainDepth: chain.length
             });
           }
-          baseBus.emit(qualified, payload, source);
+          for (const key of keys) baseBus.emit(key, payload, source);
           return;
         }
         baseBus.emit(type, payload, source);
       }
     };
-  }, [baseBus, scope]);
+  }, [baseBus, chain]);
 }
 function useEmitEvent() {
   const eventBus = useEventBus();

package/dist/lib/index.cjs

@@ -514,14 +514,29 @@ function recordTransition(trace) {
         "pass"
       );
     } else {
-      const hasRenderUI = entry.effects.some((e) => e.type === "render-ui");
-      if (hasRenderUI) {
-        registerCheck(
-          checkId,
-          `INIT transition for "${entry.traitName}" missing fetch effect`,
-          "fail",
-          "Entity-bound render-ui without a fetch effect will show empty data"
+      const rendersEntityData = entry.effects.some(
+        (e) => e.type === "render-ui" && JSON.stringify(e.args).includes("@entity.")
+      );
+      if (rendersEntityData) {
+        const siblingSeeds = getState().transitions.some(
+          (t) => t.event === "INIT" && t.effects.some(
+            (e) => e.type === "fetch" || e.type === "set" && typeof e.args[0] === "string" && e.args[0].startsWith("@entity.")
+          )
         );
+        if (siblingSeeds) {
+          registerCheck(
+            checkId,
+            `INIT transition for "${entry.traitName}" has sibling entity-seed (shared entity)`,
+            "pass"
+          );
+        } else {
+          registerCheck(
+            checkId,
+            `INIT transition for "${entry.traitName}" missing fetch effect`,
+            "fail",
+            "Entity-bound render-ui without a fetch effect will show empty data"
+          );
+        }
       }
     }
   }
@@ -687,19 +702,32 @@ function bindEventBus(eventBus) {
       log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
+    const MAX_EVENT_LOG = 5e3;
     const eventLog = [];
+    let eventLogDropped = 0;
+    const bumpEpoch = () => {
+      window.__orbitalVerification.eventLogEpoch = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    };
     window.__orbitalVerification.eventLog = eventLog;
+    window.__orbitalVerification.eventLogDropped = 0;
+    bumpEpoch();
     window.__orbitalVerification.clearEventLog = () => {
       eventLog.length = 0;
+      eventLogDropped = 0;
+      window.__orbitalVerification.eventLogDropped = 0;
+      bumpEpoch();
     };
     if (eventBus.onAny) {
       const verificationRegistryEventLogger = (event) => {
-        if (eventLog.length < 200) {
-          eventLog.push({
-            type: event.type,
-            payload: event.payload,
-            timestamp: Date.now()
-          });
+        eventLog.push({
+          type: event.type,
+          payload: event.payload,
+          timestamp: Date.now()
+        });
+        if (eventLog.length > MAX_EVENT_LOG) {
+          eventLog.shift();
+          eventLogDropped += 1;
+          window.__orbitalVerification.eventLogDropped = eventLogDropped;
         }
       };
       Object.defineProperty(verificationRegistryEventLogger, "name", {

package/dist/lib/index.js

@@ -512,14 +512,29 @@ function recordTransition(trace) {
         "pass"
       );
     } else {
-      const hasRenderUI = entry.effects.some((e) => e.type === "render-ui");
-      if (hasRenderUI) {
-        registerCheck(
-          checkId,
-          `INIT transition for "${entry.traitName}" missing fetch effect`,
-          "fail",
-          "Entity-bound render-ui without a fetch effect will show empty data"
+      const rendersEntityData = entry.effects.some(
+        (e) => e.type === "render-ui" && JSON.stringify(e.args).includes("@entity.")
+      );
+      if (rendersEntityData) {
+        const siblingSeeds = getState().transitions.some(
+          (t) => t.event === "INIT" && t.effects.some(
+            (e) => e.type === "fetch" || e.type === "set" && typeof e.args[0] === "string" && e.args[0].startsWith("@entity.")
+          )
         );
+        if (siblingSeeds) {
+          registerCheck(
+            checkId,
+            `INIT transition for "${entry.traitName}" has sibling entity-seed (shared entity)`,
+            "pass"
+          );
+        } else {
+          registerCheck(
+            checkId,
+            `INIT transition for "${entry.traitName}" missing fetch effect`,
+            "fail",
+            "Entity-bound render-ui without a fetch effect will show empty data"
+          );
+        }
       }
     }
   }
@@ -685,19 +700,32 @@ function bindEventBus(eventBus) {
       log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
+    const MAX_EVENT_LOG = 5e3;
     const eventLog = [];
+    let eventLogDropped = 0;
+    const bumpEpoch = () => {
+      window.__orbitalVerification.eventLogEpoch = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    };
     window.__orbitalVerification.eventLog = eventLog;
+    window.__orbitalVerification.eventLogDropped = 0;
+    bumpEpoch();
     window.__orbitalVerification.clearEventLog = () => {
       eventLog.length = 0;
+      eventLogDropped = 0;
+      window.__orbitalVerification.eventLogDropped = 0;
+      bumpEpoch();
     };
     if (eventBus.onAny) {
       const verificationRegistryEventLogger = (event) => {
-        if (eventLog.length < 200) {
-          eventLog.push({
-            type: event.type,
-            payload: event.payload,
-            timestamp: Date.now()
-          });
+        eventLog.push({
+          type: event.type,
+          payload: event.payload,
+          timestamp: Date.now()
+        });
+        if (eventLog.length > MAX_EVENT_LOG) {
+          eventLog.shift();
+          eventLogDropped += 1;
+          window.__orbitalVerification.eventLogDropped = eventLogDropped;
         }
       };
       Object.defineProperty(verificationRegistryEventLogger, "name", {

package/dist/marketing/index.cjs

@@ -2508,9 +2508,11 @@ function cn(...inputs) {
 logger.createLogger("almadar:eventbus");
 logger.createLogger("almadar:eventbus:subscribe");
 var EventBusContext = React12.createContext(null);
+var EMPTY_CHAIN = Object.freeze([]);
 var TraitScopeContext = React12.createContext(null);
-function useTraitScope() {
-  return React12.useContext(TraitScopeContext);
+function useTraitScopeChain() {
+  const chain = React12.useContext(TraitScopeContext);
+  return chain ?? EMPTY_CHAIN;
 }
 var log = logger.createLogger("almadar:eventbus");
 var subLog2 = logger.createLogger("almadar:eventbus:subscribe");
@@ -2588,9 +2590,9 @@ var fallbackEventBus = {
 function useEventBus() {
   const context = React12.useContext(EventBusContext);
   const baseBus = context ?? getGlobalEventBus() ?? fallbackEventBus;
-  const scope = useTraitScope();
+  const chain = useTraitScopeChain();
   return React12.useMemo(() => {
-    if (!scope) {
+    if (chain.length === 0) {
       return {
         ...baseBus,
         emit: (type, payload, source) => {
@@ -2606,22 +2608,31 @@ function useEventBus() {
       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", {
+          const isQualified = tail.includes(".");
+          const event = isQualified ? tail.split(".").slice(2).join(".") : tail;
+          if (!event) {
+            baseBus.emit(type, payload, source);
+            return;
+          }
+          const keys = /* @__PURE__ */ new Set();
+          if (isQualified) keys.add(type);
+          for (const sc of chain) {
+            keys.add(`UI:${sc.orbital}.${sc.trait}.${event}`);
+          }
+          if (keys.size > 1) {
+            scopeLog.info("emit:fan-out", {
               from: type,
-              to: qualified,
-              scopeOrbital: scope.orbital,
-              scopeTrait: scope.trait
+              keys: Array.from(keys),
+              chainDepth: chain.length
             });
           }
-          baseBus.emit(qualified, payload, source);
+          for (const key of keys) baseBus.emit(key, payload, source);
           return;
         }
         baseBus.emit(type, payload, source);
       }
     };
-  }, [baseBus, scope]);
+  }, [baseBus, chain]);
 }
 function useTapReveal(options = {}) {
   const { onReveal, onDismiss, refs, enabled = true } = options;
@@ -3218,13 +3229,13 @@ var Icon = ({
   style
 }) => {
   const directIcon = typeof icon === "string" ? void 0 : icon;
-  const effectiveName = typeof icon === "string" ? icon : name;
+  const effectiveName = typeof icon === "string" && icon !== "" ? icon : name;
+  const effectiveStrokeWidth = strokeWidth != null && strokeWidth > 0 ? strokeWidth : void 0;
   const family = useIconFamily();
   const RenderedComponent = React12__namespace.default.useMemo(() => {
     if (directIcon) return null;
     return effectiveName ? resolveIconForFamily(effectiveName) : null;
   }, [directIcon, effectiveName, family]);
-  const effectiveStrokeWidth = strokeWidth ?? void 0;
   const inlineStyle = {
     ...effectiveStrokeWidth === void 0 ? { strokeWidth: "var(--icon-stroke-width, 2)" } : {},
     ...style
@@ -5099,6 +5110,10 @@ var AnimatedCounter = ({
       setDisplayValue(String(value));
       return;
     }
+    if (window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) {
+      setDisplayValue(String(value));
+      return;
+    }
     const startTime = performance.now();
     const tick = (now) => {
       const elapsed = now - startTime;