@almadar/ui 4.6.14 → 4.8.0

package/dist/components/index.js

@@ -2,7 +2,7 @@ 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, SelectionContext } from '@almadar/ui/providers';
+import { EventBusContext } 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';
@@ -4852,6 +4852,7 @@ var init_SlotsContext = __esm({
   "runtime/ui/SlotsContext.tsx"() {
     init_logger();
     slotLog = createLogger("almadar:ui:slot-render");
+    createLogger("almadar:runtime:cross-orbital");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
     createContext({});
@@ -6266,7 +6267,7 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect66, useRef: useRef65, useCallback: useCallback115, useState: useState100 } = React111__default;
+      const { useEffect: useEffect66, useRef: useRef65, useCallback: useCallback115, useState: useState99 } = React111__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
@@ -6310,7 +6311,7 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState100(null);
+        const [clickedPosition, setClickedPosition] = useState99(null);
         const handleMapClick = useCallback115((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
@@ -17289,8 +17290,7 @@ function formatValue(value, format) {
 }
 function DataGrid({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   cols,
   gap = "md",
@@ -17311,7 +17311,6 @@ function DataGrid({
   const { t } = useTranslate();
   const [selectedIds, setSelectedIds] = useState(/* @__PURE__ */ new Set());
   const [visibleCount, setVisibleCount] = useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -17654,8 +17653,7 @@ function groupData(items, field) {
 }
 function DataList({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   gap = "none",
   variant = "default",
@@ -17684,7 +17682,6 @@ function DataList({
   const eventBus = useEventBus();
   const { t } = useTranslate();
   const [visibleCount, setVisibleCount] = React111__default.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -41078,87 +41075,58 @@ function useUISlotManager() {
 // hooks/useUIEvents.ts
 init_useEventBus();
 var UI_PREFIX = "UI:";
-function useUIEvents(dispatch, validEvents, eventBusInstance) {
+function useUIEvents(dispatch, traitName, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const validEventsKey = validEvents ? validEvents.slice().sort().join(",") : "";
+  const validEventsKey = validEvents.slice().sort().join(",");
   const stableValidEvents = useMemo(
     () => validEvents,
     [validEventsKey]
-    // intentional — validEventsKey is the stable dep, not validEvents array ref
+    // intentional — validEventsKey is the stable dep
   );
   useEffect(() => {
     const unsubscribes = [];
-    if (stableValidEvents) {
-      for (const smEvent of stableValidEvents) {
-        const prefixedHandler = (event) => {
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
-        const directHandler = (event) => {
-          if (event.source && event.source.fromBridge) {
-            return;
-          }
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(smEvent, directHandler));
-      }
-    }
-    const genericHandler = (event) => {
-      const eventName = event.payload?.event;
-      if (eventName) {
-        const smEvent = eventName;
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
-          dispatch(smEvent, event.payload);
+    for (const smEvent of stableValidEvents) {
+      const handler = (event) => {
+        if (event.source && event.source.fromBridge) {
+          return;
         }
-      }
-    };
-    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
+        dispatch(smEvent, event.payload);
+      };
+      unsubscribes.push(
+        eventBus.on(`${UI_PREFIX}${traitName}.${smEvent}`, handler)
+      );
+    }
     return () => {
       for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
       }
     };
-  }, [eventBus, dispatch, stableValidEvents]);
+  }, [eventBus, dispatch, traitName, stableValidEvents]);
 }
-function useSelectedEntity(eventBusInstance) {
+function useTraitListens(dispatch, listens, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const selectionContext = useSelectionContext();
-  const [localSelected, setLocalSelected] = useState(null);
-  const usingContext = selectionContext !== null;
+  const stableKey = listens.map((l) => `${l.sourceKey}->${l.trigger}`).sort().join("|");
+  const stableListens = useMemo(
+    () => listens,
+    [stableKey]
+    // intentional
+  );
   useEffect(() => {
-    if (usingContext) return;
-    const handleSelect = (event) => {
-      const row = event.payload?.row;
-      if (row) {
-        setLocalSelected(row);
-      }
-    };
-    const handleDeselect = () => {
-      setLocalSelected(null);
-    };
-    const unsubSelect = eventBus.on("UI:SELECT", handleSelect);
-    const unsubView = eventBus.on("UI:VIEW", handleSelect);
-    const unsubDeselect = eventBus.on("UI:DESELECT", handleDeselect);
-    const unsubClose = eventBus.on("UI:CLOSE", handleDeselect);
-    const unsubCancel = eventBus.on("UI:CANCEL", handleDeselect);
+    const unsubscribes = [];
+    for (const spec of stableListens) {
+      const handler = (event) => {
+        dispatch(spec.trigger, event.payload);
+      };
+      unsubscribes.push(eventBus.on(`${UI_PREFIX}${spec.sourceKey}`, handler));
+    }
     return () => {
-      [unsubSelect, unsubView, unsubDeselect, unsubClose, unsubCancel].forEach(
-        (unsub) => {
-          if (typeof unsub === "function") unsub();
-        }
-      );
+      for (const unsub of unsubscribes) {
+        if (typeof unsub === "function") unsub();
+      }
     };
-  }, [eventBus, usingContext]);
-  if (selectionContext) {
-    return [selectionContext.selected, selectionContext.setSelected];
-  }
-  return [localSelected, setLocalSelected];
-}
-function useSelectionContext() {
-  const context = useContext(SelectionContext);
-  return context;
+  }, [eventBus, dispatch, stableListens]);
 }
 
 // hooks/index.ts
@@ -41500,4 +41468,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, CodeBlock, CodeExample, CodeView, CodeViewer, CollapsibleSection, CombatLog, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ContentSection, ControlButton, CounterTemplate, CraftingRecipe, DEFAULT_SLOTS, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, DialogueBox, DialogueBubble, Divider, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LineChart2 as LineChart, List2 as List, LoadingState, MapView, MarkdownContent, MarketingStatCard, MasterDetail2 as MasterDetail, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, Navigation, NegotiatorBoard, NotifyListener, NumberStepper, ObjectRulePanel, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PhysicsManager, PlatformerCanvas, Popover, PowerupSlots, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PullToRefresh, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ResourceBar, ResourceCounter, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, SectionHeader, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Spinner, Split, SplitPane, SplitSection, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, StepFlow, StepFlowOrganism, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, Tabs, TagCloud, TeamCard, TeamOrganism, TerrainPalette, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, ViolationAlert, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, clearEntities, cn, combatAnimations, combatClasses, combatEffects, createInitialGameState, createTranslate, createUnitAnimationState, drawSprite, generateCombatMessage, getAllEntities, getByType, getCurrentFrame, getEntity, getSingleton, getTileDimensions, inferDirection, isoToScreen, mapBookData, parseQueryBinding, pendulum, projectileMotion, removeEntity, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, spawnEntity, springOscillator, tickAnimationState, transitionAnimation, updateEntity, updateSingleton, useAgentChat, useAuthContext, useBattleState, useCamera, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGameAudioContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePhysics2D, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSelectedEntity, useSingletonEntity, useSpriteAnimations, useSwipeGesture, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, ActionButtons, Card2 as ActionCard, ActionPalette, ActionTile, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, CanvasEffect, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, Checkbox, ChoiceButton, ClassifierBoard, CodeBlock, CodeExample, CodeView, CodeViewer, CollapsibleSection, CombatLog, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, Container, ContentRenderer, ContentSection, ControlButton, CounterTemplate, CraftingRecipe, DEFAULT_SLOTS, DIAMOND_TOP_Y, DPad, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, DialogueBox, DialogueBubble, Divider, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EnemyPlate, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCanvas2D, GameHud, GameMenu, GameOverScreen, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GraphCanvas, GraphView, Grid, HStack, Header, Heading, HealthBar, HealthPanel, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, InventoryPanel, IsometricCanvas, ItemSlot, JazariStateMachine, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LineChart2 as LineChart, List2 as List, LoadingState, MapView, MarkdownContent, MarketingStatCard, MasterDetail2 as MasterDetail, MediaGallery, Menu, Meter, MiniMap, Modal, ModalSlot, Navigation, NegotiatorBoard, NotifyListener, NumberStepper, ObjectRulePanel, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PhysicsManager, PlatformerCanvas, Popover, PowerupSlots, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PullToRefresh, QuestTracker, QuizBlock, Radio, RangeSlider, RelationSelect, RepeatableFormSection, ResourceBar, ResourceCounter, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreBoard, ScoreDisplay, SearchInput, Section, SectionHeader, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Spinner, Split, SplitPane, SplitSection, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, StepFlow, StepFlowOrganism, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, Table, Tabs, TagCloud, TeamCard, TeamOrganism, TerrainPalette, Text, TextHighlight, Textarea, ThemeSelector, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TurnPanel, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UnitCommandBar, UploadDropZone, VStack, VariablePanel, ViolationAlert, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, XPBar, applyTemporaryEffect, calculateAttackTargets, calculateDamage, calculateValidMoves, clearEntities, cn, combatAnimations, combatClasses, combatEffects, createInitialGameState, createTranslate, createUnitAnimationState, drawSprite, generateCombatMessage, getAllEntities, getByType, getCurrentFrame, getEntity, getSingleton, getTileDimensions, inferDirection, isoToScreen, mapBookData, parseQueryBinding, pendulum, projectileMotion, removeEntity, resolveFieldMap, resolveFrame, resolveSheetDirection, screenToIso, spawnEntity, springOscillator, tickAnimationState, transitionAnimation, updateEntity, updateSingleton, useAgentChat, useAuthContext, useBattleState, useCamera, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGameAudioContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePhysics2D, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSingletonEntity, useSpriteAnimations, useSwipeGesture, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/components/molecules/DataGrid.d.ts

@@ -57,8 +57,6 @@ export interface DataGridProps<T extends EntityRow = EntityRow> {
     entity: T | readonly T[];
     /** Field definitions for rendering each card */
     fields: readonly DataGridField[];
-    /** Alias for fields (compiler generates `columns` for field definitions) */
-    columns?: readonly DataGridField[];
     /** Per-item action buttons */
     itemActions?: readonly DataGridItemAction[];
     /** Number of columns (uses auto-fit if omitted) */
@@ -98,7 +96,7 @@ export interface DataGridProps<T extends EntityRow = EntityRow> {
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
 }
-export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields: fieldsProp, columns: columnsProp, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, }: DataGridProps<T>): import("react/jsx-runtime").JSX.Element;
 export declare namespace DataGrid {
     var displayName: string;
 }

package/dist/components/molecules/DataList.d.ts

@@ -47,8 +47,6 @@ export interface DataListProps<T extends EntityRow = EntityRow> {
     entity: T | readonly T[];
     /** Field definitions for rendering each row */
     fields: readonly DataListField[];
-    /** Alias for fields (compiler may generate `columns` for field definitions) */
-    columns?: readonly DataListField[];
     /** Per-item action buttons */
     itemActions?: readonly DataListItemAction[];
     /** Gap between rows */
@@ -112,7 +110,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> {
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
 }
-export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields: fieldsProp, columns: columnsProp, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, }: DataListProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, }: DataListProps<T>): import("react/jsx-runtime").JSX.Element;
 export declare namespace DataList {
     var displayName: string;
 }

package/dist/docs/index.d.cts

@@ -232,6 +232,8 @@ interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
     subtitle?: string;
     /** Shadow size override */
     shadow?: CardShadow;
+    /** Card content */
+    children?: React.ReactNode;
 }
 declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
 

package/dist/hooks/index.cjs

@@ -1333,87 +1333,58 @@ function useUISlotManager() {
   };
 }
 var UI_PREFIX = "UI:";
-function useUIEvents(dispatch, validEvents, eventBusInstance) {
+function useUIEvents(dispatch, traitName, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const validEventsKey = validEvents ? validEvents.slice().sort().join(",") : "";
+  const validEventsKey = validEvents.slice().sort().join(",");
   const stableValidEvents = react.useMemo(
     () => validEvents,
     [validEventsKey]
-    // intentional — validEventsKey is the stable dep, not validEvents array ref
+    // intentional — validEventsKey is the stable dep
   );
   react.useEffect(() => {
     const unsubscribes = [];
-    if (stableValidEvents) {
-      for (const smEvent of stableValidEvents) {
-        const prefixedHandler = (event) => {
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
-        const directHandler = (event) => {
-          if (event.source && event.source.fromBridge) {
-            return;
-          }
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(smEvent, directHandler));
-      }
-    }
-    const genericHandler = (event) => {
-      const eventName = event.payload?.event;
-      if (eventName) {
-        const smEvent = eventName;
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
-          dispatch(smEvent, event.payload);
+    for (const smEvent of stableValidEvents) {
+      const handler = (event) => {
+        if (event.source && event.source.fromBridge) {
+          return;
         }
-      }
-    };
-    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
+        dispatch(smEvent, event.payload);
+      };
+      unsubscribes.push(
+        eventBus.on(`${UI_PREFIX}${traitName}.${smEvent}`, handler)
+      );
+    }
     return () => {
       for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
       }
     };
-  }, [eventBus, dispatch, stableValidEvents]);
+  }, [eventBus, dispatch, traitName, stableValidEvents]);
 }
-function useSelectedEntity(eventBusInstance) {
+function useTraitListens(dispatch, listens, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const selectionContext = useSelectionContext();
-  const [localSelected, setLocalSelected] = react.useState(null);
-  const usingContext = selectionContext !== null;
+  const stableKey = listens.map((l) => `${l.sourceKey}->${l.trigger}`).sort().join("|");
+  const stableListens = react.useMemo(
+    () => listens,
+    [stableKey]
+    // intentional
+  );
   react.useEffect(() => {
-    if (usingContext) return;
-    const handleSelect = (event) => {
-      const row = event.payload?.row;
-      if (row) {
-        setLocalSelected(row);
-      }
-    };
-    const handleDeselect = () => {
-      setLocalSelected(null);
-    };
-    const unsubSelect = eventBus.on("UI:SELECT", handleSelect);
-    const unsubView = eventBus.on("UI:VIEW", handleSelect);
-    const unsubDeselect = eventBus.on("UI:DESELECT", handleDeselect);
-    const unsubClose = eventBus.on("UI:CLOSE", handleDeselect);
-    const unsubCancel = eventBus.on("UI:CANCEL", handleDeselect);
+    const unsubscribes = [];
+    for (const spec of stableListens) {
+      const handler = (event) => {
+        dispatch(spec.trigger, event.payload);
+      };
+      unsubscribes.push(eventBus.on(`${UI_PREFIX}${spec.sourceKey}`, handler));
+    }
     return () => {
-      [unsubSelect, unsubView, unsubDeselect, unsubClose, unsubCancel].forEach(
-        (unsub) => {
-          if (typeof unsub === "function") unsub();
-        }
-      );
+      for (const unsub of unsubscribes) {
+        if (typeof unsub === "function") unsub();
+      }
     };
-  }, [eventBus, usingContext]);
-  if (selectionContext) {
-    return [selectionContext.selected, selectionContext.setSelected];
-  }
-  return [localSelected, setLocalSelected];
-}
-function useSelectionContext() {
-  const context = react.useContext(providers.SelectionContext);
-  return context;
+  }, [eventBus, dispatch, stableListens]);
 }
 var queryStores = /* @__PURE__ */ new Map();
 function getOrCreateStore(query) {
@@ -2256,9 +2227,9 @@ exports.usePlayer = usePlayer;
 exports.usePreview = usePreview;
 exports.usePullToRefresh = usePullToRefresh;
 exports.useQuerySingleton = useQuerySingleton;
-exports.useSelectedEntity = useSelectedEntity;
 exports.useSingletonEntity = useSingletonEntity;
 exports.useSwipeGesture = useSwipeGesture;
+exports.useTraitListens = useTraitListens;
 exports.useTranslate = useTranslate;
 exports.useUIEvents = useUIEvents;
 exports.useUISlotManager = useUISlotManager;

package/dist/hooks/index.d.ts

@@ -13,7 +13,7 @@ export { useDeepAgentGeneration } from './useDeepAgentGeneration';
 export { useEventBus, useEventListener, useEmitEvent } from './useEventBus';
 export type { BusEvent, BusEventSource, EventListener, Unsubscribe, EventBusContextType, } from './event-bus-types';
 export { useUISlotManager, DEFAULT_SLOTS, type UISlot, type SlotAnimation, type SlotContent, type RenderUIConfig, type SlotChangeCallback, type UISlotManager, } from './useUISlots';
-export { useUIEvents, useSelectedEntity } from './useUIEvents';
+export { useUIEvents, useTraitListens, type TraitListenSpec } from './useUIEvents';
 export { useQuerySingleton, parseQueryBinding, type QueryState, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, } from './useQuerySingleton';
 export { useEntities, useEntity as useEntityById, useEntitiesByType, useSingletonEntity, usePlayer, usePhysics, useInput, spawnEntity, updateEntity, updateSingleton, removeEntity, clearEntities, getEntity, getByType, getAllEntities, getSingleton, type Entity, } from './useEntities';
 export { useTranslate, I18nProvider, createTranslate, type TranslateFunction, type I18nContextValue, } from './useTranslate';

package/dist/hooks/index.js

@@ -1,5 +1,5 @@
 import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
-import { EventBusContext, SelectionContext } from '@almadar/ui/providers';
+import { EventBusContext } from '@almadar/ui/providers';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 
 function useOrbitalHistory(options) {
@@ -1331,87 +1331,58 @@ function useUISlotManager() {
   };
 }
 var UI_PREFIX = "UI:";
-function useUIEvents(dispatch, validEvents, eventBusInstance) {
+function useUIEvents(dispatch, traitName, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const validEventsKey = validEvents ? validEvents.slice().sort().join(",") : "";
+  const validEventsKey = validEvents.slice().sort().join(",");
   const stableValidEvents = useMemo(
     () => validEvents,
     [validEventsKey]
-    // intentional — validEventsKey is the stable dep, not validEvents array ref
+    // intentional — validEventsKey is the stable dep
   );
   useEffect(() => {
     const unsubscribes = [];
-    if (stableValidEvents) {
-      for (const smEvent of stableValidEvents) {
-        const prefixedHandler = (event) => {
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
-        const directHandler = (event) => {
-          if (event.source && event.source.fromBridge) {
-            return;
-          }
-          dispatch(smEvent, event.payload);
-        };
-        unsubscribes.push(eventBus.on(smEvent, directHandler));
-      }
-    }
-    const genericHandler = (event) => {
-      const eventName = event.payload?.event;
-      if (eventName) {
-        const smEvent = eventName;
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
-          dispatch(smEvent, event.payload);
+    for (const smEvent of stableValidEvents) {
+      const handler = (event) => {
+        if (event.source && event.source.fromBridge) {
+          return;
         }
-      }
-    };
-    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
+        dispatch(smEvent, event.payload);
+      };
+      unsubscribes.push(
+        eventBus.on(`${UI_PREFIX}${traitName}.${smEvent}`, handler)
+      );
+    }
     return () => {
       for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
       }
     };
-  }, [eventBus, dispatch, stableValidEvents]);
+  }, [eventBus, dispatch, traitName, stableValidEvents]);
 }
-function useSelectedEntity(eventBusInstance) {
+function useTraitListens(dispatch, listens, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
-  const selectionContext = useSelectionContext();
-  const [localSelected, setLocalSelected] = useState(null);
-  const usingContext = selectionContext !== null;
+  const stableKey = listens.map((l) => `${l.sourceKey}->${l.trigger}`).sort().join("|");
+  const stableListens = useMemo(
+    () => listens,
+    [stableKey]
+    // intentional
+  );
   useEffect(() => {
-    if (usingContext) return;
-    const handleSelect = (event) => {
-      const row = event.payload?.row;
-      if (row) {
-        setLocalSelected(row);
-      }
-    };
-    const handleDeselect = () => {
-      setLocalSelected(null);
-    };
-    const unsubSelect = eventBus.on("UI:SELECT", handleSelect);
-    const unsubView = eventBus.on("UI:VIEW", handleSelect);
-    const unsubDeselect = eventBus.on("UI:DESELECT", handleDeselect);
-    const unsubClose = eventBus.on("UI:CLOSE", handleDeselect);
-    const unsubCancel = eventBus.on("UI:CANCEL", handleDeselect);
+    const unsubscribes = [];
+    for (const spec of stableListens) {
+      const handler = (event) => {
+        dispatch(spec.trigger, event.payload);
+      };
+      unsubscribes.push(eventBus.on(`${UI_PREFIX}${spec.sourceKey}`, handler));
+    }
     return () => {
-      [unsubSelect, unsubView, unsubDeselect, unsubClose, unsubCancel].forEach(
-        (unsub) => {
-          if (typeof unsub === "function") unsub();
-        }
-      );
+      for (const unsub of unsubscribes) {
+        if (typeof unsub === "function") unsub();
+      }
     };
-  }, [eventBus, usingContext]);
-  if (selectionContext) {
-    return [selectionContext.selected, selectionContext.setSelected];
-  }
-  return [localSelected, setLocalSelected];
-}
-function useSelectionContext() {
-  const context = useContext(SelectionContext);
-  return context;
+  }, [eventBus, dispatch, stableListens]);
 }
 var queryStores = /* @__PURE__ */ new Map();
 function getOrCreateStore(query) {
@@ -2208,4 +2179,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, clearEntities, createTranslate, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSelectedEntity, useSingletonEntity, useSwipeGesture, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, clearEntities, createTranslate, getAllEntities, getByType, getEntity, getSingleton, parseQueryBinding, removeEntity, spawnEntity, updateEntity, updateSingleton, useAgentChat, useAuthContext, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEntities, useEntitiesByType, useEntity as useEntityById, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useInput, useLongPress, useOrbitalHistory, usePhysics, usePinchZoom, usePlayer, usePreview, usePullToRefresh, useQuerySingleton, useSingletonEntity, useSwipeGesture, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/hooks/useUIEvents.d.ts

@@ -1,36 +1,41 @@
 import { useEventBus } from "./useEventBus";
 import type { EventPayload } from "@almadar/core";
 /**
- * Hook to bridge UI events to state machine dispatch
+ * Hook to bridge UI events to state machine dispatch.
  *
  * @param dispatch - The state machine dispatch function
- * @param validEvents - Optional array of valid event names (filters which events to handle)
- * @param eventBusInstance - Optional event bus instance (for testing, uses hook if not provided)
+ * @param traitName - Owning trait name; used to construct the qualified
+ *   subscription key `UI:{traitName}.{event}`. Required — bare-key
+ *   subscriptions were removed when the bus namespace unified on the
+ *   listens grammar (gap #13, Phase 4 of the cross-orbital plan).
+ * @param validEvents - Local event names (transition triggers) the
+ *   trait reacts to. The hook subscribes to `UI:{traitName}.{event}`
+ *   for each entry.
+ * @param eventBusInstance - Optional event bus instance (for testing)
  */
-export declare function useUIEvents<E extends string>(dispatch: (event: E, payload?: EventPayload) => void, validEvents?: readonly E[], eventBusInstance?: ReturnType<typeof useEventBus>): void;
+export declare function useUIEvents<E extends string>(dispatch: (event: E, payload?: EventPayload) => void, traitName: string, validEvents: readonly E[], eventBusInstance?: ReturnType<typeof useEventBus>): void;
 /**
- * Hook for selected entity tracking
- * Many list UIs need to track which item is selected.
+ * Hook to subscribe to cross-trait listens (gap #13, Phase 4 codegen).
  *
- * This hook uses SelectionProvider if available (preferred),
- * otherwise falls back to listening to events directly.
+ * The schema's `listens { Source EVENT -> TRIGGER }` block resolves at
+ * lower-time to a typed `ListenSource` enum (intra-orbital `Trait` or
+ * cross-orbital `Orbital.Trait`). Codegen materializes one
+ * `useTraitListens` call per trait, listing every `(sourceTrait,
+ * sourceEvent, localTrigger)` tuple from the listens block. The hook
+ * subscribes to the qualified bus key — `UI:Trait.EVENT` (intra-orbital)
+ * or `UI:Orbital.Trait.EVENT` (cross-orbital) — and dispatches the
+ * local trigger when the source fires.
  *
- * @example Using with SelectionProvider (recommended)
- * ```tsx
- * function MyPage() {
- *   return (
- *     <EventBusProvider>
- *       <SelectionProvider>
- *         <MyComponent />
- *       </SelectionProvider>
- *     </EventBusProvider>
- *   );
- * }
- *
- * function MyComponent() {
- *   const [selected, setSelected] = useSelectedEntity<Order>();
- *   // selected is automatically updated when UI:VIEW/UI:SELECT events fire
- * }
- * ```
+ * Replaces the old bare-event cross-trait fan-out that lived inside
+ * `useUIEvents`. Pre-unification, `useUIEvents` subscribed to bare
+ * `EVENT` keys and matched on `source.trait !== own`; post-unification,
+ * the qualified bus key carries the source identity directly, no
+ * `source` filtering needed.
  */
-export declare function useSelectedEntity<T>(eventBusInstance?: ReturnType<typeof useEventBus>): [T | null, (entity: T | null) => void];
+export interface TraitListenSpec<E extends string> {
+    /** Qualified `Trait.EVENT` or `Orbital.Trait.EVENT` source. */
+    sourceKey: string;
+    /** Local trigger event to dispatch when the source fires. */
+    trigger: E;
+}
+export declare function useTraitListens<E extends string>(dispatch: (event: E, payload?: EventPayload) => void, listens: readonly TraitListenSpec<E>[], eventBusInstance?: ReturnType<typeof useEventBus>): void;

package/dist/lib/index.cjs

@@ -703,9 +703,9 @@ function bindEventBus(eventBus) {
   log.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
-    window.__orbitalVerification.sendEvent = (event, payload) => {
-      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
-      log.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
+    window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
+      const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
+      log.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];

package/dist/lib/index.js

@@ -701,9 +701,9 @@ function bindEventBus(eventBus) {
   log.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
-    window.__orbitalVerification.sendEvent = (event, payload) => {
-      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
-      log.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
+    window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
+      const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
+      log.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];