@almadar/ui 4.22.1 → 4.22.3

package/dist/avl/index.cjs

@@ -10268,6 +10268,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -47070,6 +47089,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -47091,6 +47111,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = patterns.getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -47217,6 +47251,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/avl/index.js

@@ -5,7 +5,7 @@ import React127__default, { createContext, useContext, useRef, useState, useCall
 import * as LucideIcons from 'lucide-react';
 import { Loader2, ChevronDown, X, Check, Copy, AlertTriangle, Info, AlertCircle, CheckCircle, List, Printer, ChevronRight, ChevronLeft, Code, FileText, WrapText, Trash2, Settings, Menu as Menu$1, Search, Bell, LogOut, ZoomOut, ZoomIn, Download, FileQuestion, Inbox, XCircle, Filter, Plus, Pause, Play, RotateCcw, Package, Calendar, Pencil, Eye, MoreHorizontal, Image as Image$1, Upload, Minus, ArrowLeft, HelpCircle, ChevronUp, Eraser, Star, TrendingUp, TrendingDown, ArrowUp, ArrowDown, MoreVertical, Sun, Moon, Circle, Clock, CheckCircle2, ArrowRight, FileWarning, SkipForward, Bug, Send, Wrench, User, Tag, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
-import { getComponentForPattern as getComponentForPattern$1, getPatternDefinition, isEntityAwarePattern } from '@almadar/patterns';
+import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1, isEntityAwarePattern } from '@almadar/patterns';
 import { createPortal } from 'react-dom';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ReactMarkdown from 'react-markdown';
@@ -10222,6 +10222,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -47024,6 +47043,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -47045,6 +47065,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -47171,6 +47205,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/components/atoms/Badge.d.ts

@@ -6,8 +6,10 @@ export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
     size?: BadgeSize;
     /** Numeric count or amount to display in badge */
     amount?: number;
-    /** Badge label text (alternative to children for schema-driven rendering) */
-    label?: string;
+    /** Badge label text (alternative to children for schema-driven rendering).
+     *  Numeric values are auto-coerced to string for rendering — common case
+     *  is unread counts, error counts, status codes, etc. */
+    label?: string | number;
     /** Icon name (Lucide icon string) or React node */
     icon?: React.ReactNode;
 }

package/dist/components/index.cjs

@@ -5425,6 +5425,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3; exports.Alert = void 0;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -37816,6 +37835,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -37837,6 +37857,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = patterns.getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -37961,6 +37995,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/components/index.js

@@ -7,7 +7,7 @@ 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';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
-import { getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
+import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
 import { createPortal } from 'react-dom';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ReactMarkdown from 'react-markdown';
@@ -5380,6 +5380,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -37771,6 +37790,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -37792,6 +37812,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -37916,6 +37950,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/marketing/index.d.cts

@@ -195,8 +195,10 @@ interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
     size?: BadgeSize;
     /** Numeric count or amount to display in badge */
     amount?: number;
-    /** Badge label text (alternative to children for schema-driven rendering) */
-    label?: string;
+    /** Badge label text (alternative to children for schema-driven rendering).
+     *  Numeric values are auto-coerced to string for rendering — common case
+     *  is unread counts, error counts, status codes, etc. */
+    label?: string | number;
     /** Icon name (Lucide icon string) or React node */
     icon?: React.ReactNode;
 }

package/dist/providers/index.cjs

@@ -7063,6 +7063,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -38336,6 +38355,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -38357,6 +38377,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = patterns.getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -38481,6 +38515,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/providers/index.js

@@ -8,7 +8,7 @@ import * as LucideIcons from 'lucide-react';
 import { X, AlertTriangle, Info, AlertCircle, CheckCircle, Loader2, List, Printer, ChevronRight, ChevronLeft, Check, Copy, Code, FileText, WrapText, Trash2, Settings, Menu as Menu$1, Search, Bell, ChevronDown, LogOut, ZoomOut, ZoomIn, Download, FileQuestion, Inbox, XCircle, Filter, Plus, Pause, Play, RotateCcw, Package, Calendar, Pencil, Eye, MoreHorizontal, Image as Image$1, Upload, Minus, ArrowLeft, HelpCircle, ChevronUp, Eraser, Star, TrendingUp, TrendingDown, ArrowUp, ArrowDown, MoreVertical, Sun, Moon, Circle, Clock, CheckCircle2, ArrowRight, FileWarning, SkipForward, Bug, Send, Wrench, User, Tag, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
 import { useUISlots } from '@almadar/ui/context';
-import { getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
+import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
 import { createPortal } from 'react-dom';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ReactMarkdown from 'react-markdown';
@@ -7018,6 +7018,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -38291,6 +38310,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -38312,6 +38332,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -38436,6 +38470,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");

package/dist/runtime/index.cjs

@@ -6958,6 +6958,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -37929,6 +37948,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -37950,6 +37970,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = patterns.getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -38074,6 +38108,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");
@@ -39153,6 +39188,9 @@ function useTrait(traitName) {
   return context.getTrait(traitName);
 }
 
+// runtime/index.ts
+init_wrapCallbackForEvent();
+
 // runtime/OrbPreview.tsx
 init_Box();
 init_Typography();
@@ -39931,3 +39969,4 @@ exports.useServerBridge = useServerBridge;
 exports.useTrait = useTrait;
 exports.useTraitContext = useTraitContext;
 exports.useTraitStateMachine = useTraitStateMachine;
+exports.wrapCallbackForEvent = wrapCallbackForEvent;

package/dist/runtime/index.d.ts

@@ -11,6 +11,7 @@ export { useResolvedSchema, type ResolvedSchemaResult, clearSchemaCache } from '
 export { EntitySchemaProvider, useEntitySchema, useEntityDefinition, useEntitySchemaOptional, type EntitySchemaContextValue, type EntitySchemaProviderProps, } from './EntitySchemaContext';
 export { TraitProvider, TraitContext, useTraitContext, useTrait, type TraitContextValue, type TraitInstance, type TraitProviderProps, } from './TraitProvider';
 export type { SlotPatternEntry, SlotSource } from './ui/slot-types';
+export { wrapCallbackForEvent } from './wrapCallbackForEvent';
 export { createClientEffectHandlers, type ClientEventBus, type SlotSetter, type CreateClientEffectHandlersOptions, } from './createClientEffectHandlers';
 export { OrbPreview, type OrbPreviewProps } from './OrbPreview';
 export { BrowserPlayground, type BrowserPlaygroundProps } from './BrowserPlayground';

package/dist/runtime/index.js

@@ -8,7 +8,7 @@ import * as LucideIcons from 'lucide-react';
 import { X, AlertTriangle, Info, AlertCircle, CheckCircle, Loader2, List, Printer, ChevronRight, ChevronLeft, Check, Copy, Code, FileText, WrapText, Trash2, Settings, Menu as Menu$1, Search, Bell, ChevronDown, LogOut, ZoomOut, ZoomIn, Download, FileQuestion, Inbox, XCircle, Filter, Plus, Pause, Play, RotateCcw, Package, Calendar, Pencil, Eye, MoreHorizontal, Image as Image$1, Upload, Minus, ArrowLeft, HelpCircle, ChevronUp, Eraser, Star, TrendingUp, TrendingDown, ArrowUp, ArrowDown, MoreVertical, Sun, Moon, Circle, Clock, CheckCircle2, ArrowRight, FileWarning, SkipForward, Bug, Send, Wrench, User, Tag, DollarSign, Zap, Sword, Move, Heart, Shield } from 'lucide-react';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
 import { useUISlots, UISlotProvider } from '@almadar/ui/context';
-import { getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
+import { getPatternDefinition, getComponentForPattern as getComponentForPattern$1 } from '@almadar/patterns';
 import { createPortal } from 'react-dom';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ReactMarkdown from 'react-markdown';
@@ -6913,6 +6913,25 @@ var init_renderer = __esm({
     init_init();
   }
 });
+
+// runtime/wrapCallbackForEvent.ts
+function wrapCallbackForEvent(qualifiedEvent, callbackArgs, emit) {
+  const argNames = (callbackArgs ?? []).map((a) => a.name);
+  if (argNames.length === 0) {
+    return () => emit(qualifiedEvent);
+  }
+  return (...args) => {
+    const payload = {};
+    for (let i = 0; i < argNames.length; i += 1) {
+      payload[argNames[i]] = args[i];
+    }
+    emit(qualifiedEvent, payload);
+  };
+}
+var init_wrapCallbackForEvent = __esm({
+  "runtime/wrapCallbackForEvent.ts"() {
+  }
+});
 var variantBorderClasses, variantIconColors, iconMap3, Alert;
 var init_Alert = __esm({
   "components/molecules/Alert.tsx"() {
@@ -37884,6 +37903,7 @@ function SlotContentRenderer({
       );
     }
   }
+  const eventBus = useEventBus();
   const schemaCtx = useEntitySchemaOptional();
   let entityDef;
   if (typeof entityProp === "string" && entityProp.length > 0 && schemaCtx) {
@@ -37905,6 +37925,20 @@ function SlotContentRenderer({
     const { children: _childrenConfig, ...restPropsNoChildren } = content.props;
     const restProps = childrenIsRenderFn ? { ...restPropsNoChildren, children: incomingChildren } : restPropsNoChildren;
     const renderedProps = renderPatternProps(restProps, onDismiss);
+    const patternDef = getPatternDefinition(content.pattern);
+    const propsSchema = patternDef?.propsSchema;
+    if (propsSchema) {
+      for (const [propKey, propValue] of Object.entries(renderedProps)) {
+        if (typeof propValue !== "string") continue;
+        const propDef = propsSchema[propKey];
+        if (!propDef || propDef.kind !== "callback") continue;
+        renderedProps[propKey] = wrapCallbackForEvent(
+          `UI:${propValue}`,
+          propDef.callbackArgs,
+          (eventKey, payload) => eventBus.emit(eventKey, payload)
+        );
+      }
+    }
     const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
@@ -38029,6 +38063,7 @@ var init_UISlotRenderer = __esm({
     init_logger();
     init_Skeleton();
     init_renderer();
+    init_wrapCallbackForEvent();
     init_TraitFrame();
     init_component_registry_generated();
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");
@@ -39108,6 +39143,9 @@ function useTrait(traitName) {
   return context.getTrait(traitName);
 }
 
+// runtime/index.ts
+init_wrapCallbackForEvent();
+
 // runtime/OrbPreview.tsx
 init_Box();
 init_Typography();
@@ -39867,4 +39905,4 @@ function BrowserPlayground({
   );
 }
 
-export { BrowserPlayground, EntitySchemaProvider, OrbPreview, ServerBridgeProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearSchemaCache, createClientEffectHandlers, prepareSchemaForPreview, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, useResolvedSchema, useServerBridge, useTrait, useTraitContext, useTraitStateMachine };
+export { BrowserPlayground, EntitySchemaProvider, OrbPreview, ServerBridgeProvider, TraitContext, TraitProvider, adjustSchemaForMockData, buildMockData, clearSchemaCache, createClientEffectHandlers, prepareSchemaForPreview, useEntityDefinition, useEntitySchema, useEntitySchemaOptional, useResolvedSchema, useServerBridge, useTrait, useTraitContext, useTraitStateMachine, wrapCallbackForEvent };

package/dist/runtime/wrapCallbackForEvent.d.ts

@@ -0,0 +1,16 @@
+import type { PatternCallbackArg } from '@almadar/patterns';
+import type { EventPayload, EventPayloadValue } from '@almadar/core';
+/**
+ * Build the runtime wrapper that turns a string-typed callback prop
+ * (e.g. `onTabChange: "TAB_CHANGED"`) into a function the component can
+ * invoke. The wrapper consumes the component's positional callback args
+ * by name and dispatches an OBJECT payload `{ argName: value, ... }` so
+ * the bus carries the trait's declared event payload, not a raw
+ * positional spread. Mirrors the codegen wrapper in
+ * `orbital-shell-typescript/src/codegen/pattern.rs` (C2 compiled path).
+ *
+ * Single-sourcing this logic across runtime and codegen (shared shape,
+ * not shared code — codegen emits string source) is what keeps the two
+ * paths from silently diverging on payload shape.
+ */
+export declare function wrapCallbackForEvent(qualifiedEvent: string, callbackArgs: PatternCallbackArg[] | undefined, emit: (eventKey: string, payload?: EventPayload) => void): (...args: EventPayloadValue[]) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.22.1",
+  "version": "4.22.3",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -120,7 +120,7 @@
   "dependencies": {
     "@almadar/core": "^7.10.0",
     "@almadar/evaluator": ">=2.9.2",
-    "@almadar/patterns": ">=2.17.1",
+    "@almadar/patterns": "^2.20.2",
     "@almadar/runtime": "^6.0.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",