@almadar/ui 5.158.0 → 5.160.0

package/dist/providers/index.d.ts

@@ -3,7 +3,7 @@ import { EntityRow, SExpr } from '@almadar/core';
 export { ANONYMOUS_USER } from '@almadar/core';
 import { U as UIThemeDefinition, j as UserData } from '../UserContext-g_LcDiGN.js';
 export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.js';
-export { E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-Bn3ePJQC.js';
+export { o as EntityBindingContext, E as EntityBindingSource, a as EntitySchemaContextValue, b as EntitySchemaProvider, c as EntitySchemaProviderProps, p as SendEventResult, d as ServerBridgeContextValue, e as ServerBridgeProvider, q as ServerBridgeProviderProps, S as ServerBridgeTransport, f as ServerClientEffect, r as ServerResponseMeta, T as TraitContext, g as TraitContextValue, h as TraitInstance, i as TraitProvider, j as TraitProviderProps, s as useEntityBindingSnapshot, u as useEntitySchema, k as useEntitySchemaOptional, l as useServerBridge, m as useTrait, n as useTraitContext } from '../EntityBindingContext-0Evn_LcT.js';
 import { j as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-QUdKOj7f.js';
 export { c as NavigationContextValue, d as NavigationProvider, e as NavigationProviderProps, f as NavigationState, k as comparePathSpecificity, m as extractRouteParams, n as findPageByName, o as findPageByPath, p as getAllPages, q as getDefaultPage, r as matchPath, s as matchPathAmong, t as pathMatches, u as useActivePage, v as useInitPayload, w as useNavigateTo, x as useNavigation, y as useNavigationId, z as useNavigationState } from '../offline-executor-QUdKOj7f.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';

package/dist/providers/index.js

@@ -15,7 +15,7 @@ import { useTranslate } from '@almadar/ui/hooks';
 import { useUISlots, ThemeProvider, useTheme } from '@almadar/ui/context';
 export { DesignThemeProvider, useDesignTheme } from '@almadar/ui/context';
 import { evaluate, createMinimalContext } from '@almadar/evaluator';
-import { wrapCallbackForEvent } from '@almadar/runtime/ui';
+import { wrapCallbackForEvent, perfStart, perfEnd } from '@almadar/runtime/ui';
 import { useLocation, useNavigate, Link, Outlet } from 'react-router-dom';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
@@ -286,7 +286,16 @@ function isPlainObject(value) {
   if (typeof value === "function") return false;
   return true;
 }
+function isEvaluatorResolvedData(value) {
+  return evaluatorResolvedData.has(value);
+}
+function brandResolved(value) {
+  if (value !== null && typeof value === "object" && !React87__default.isValidElement(value) && !(value instanceof Date)) {
+    resolvedMarkerFree.add(value);
+  }
+}
 function subtreeHasMarker(value) {
+  if (resolvedMarkerFree.has(value)) return false;
   const cached = markerPresenceCache.get(value);
   if (cached !== void 0) return cached;
   let found = false;
@@ -308,10 +317,23 @@ function subtreeHasMarker(value) {
 }
 function walkValue(value, scopeTrait, entity, config, state) {
   if (isRenderBindingMarker(value)) {
-    return { resolved: resolveMarkerExpression(value.expression, entity, config, state), changed: true };
+    const cached = markerResolutionCache.get(value);
+    if (cached !== void 0 && cached.entity === entity && cached.config === config && cached.state === state) {
+      return { resolved: cached.resolved, changed: false };
+    }
+    const resolved = resolveMarkerExpression(value.expression, entity, config, state);
+    markerResolutionCache.set(value, { entity, config, state, resolved });
+    if (resolved !== null && typeof resolved === "object" && !React87__default.isValidElement(resolved) && !(resolved instanceof Date)) {
+      resolvedMarkerFree.add(resolved);
+      evaluatorResolvedData.add(resolved);
+    }
+    return { resolved, changed: true };
   }
   if (Array.isArray(value)) {
-    if (!subtreeHasMarker(value)) return { resolved: value, changed: false };
+    if (!subtreeHasMarker(value)) {
+      brandResolved(value);
+      return { resolved: value, changed: false };
+    }
     const out = [];
     let changed = false;
     for (const item of value) {
@@ -326,10 +348,14 @@ function walkValue(value, scopeTrait, entity, config, state) {
       out.push(resolved);
       if (itemChanged) changed = true;
     }
+    brandResolved(out);
     return changed ? { resolved: out, changed: true } : { resolved: value, changed: false };
   }
   if (isPlainObject(value)) {
-    if (!subtreeHasMarker(value)) return { resolved: value, changed: false };
+    if (!subtreeHasMarker(value)) {
+      brandResolved(value);
+      return { resolved: value, changed: false };
+    }
     const sourceTrait = value._sourceTrait;
     if (typeof sourceTrait === "string" && sourceTrait !== scopeTrait) {
       return { resolved: value, changed: false };
@@ -341,11 +367,13 @@ function walkValue(value, scopeTrait, entity, config, state) {
       out[key] = resolved;
       if (itemChanged) changed = true;
     }
+    brandResolved(out);
     return changed ? { resolved: out, changed: true } : { resolved: value, changed: false };
   }
   return { resolved: value, changed: false };
 }
 function resolveRenderBindingMarkers(props, scopeTrait, entity, config, state) {
+  if (resolvedMarkerFree.has(props)) return props;
   const out = {};
   let changed = false;
   for (const [key, value] of Object.entries(props)) {
@@ -353,13 +381,17 @@ function resolveRenderBindingMarkers(props, scopeTrait, entity, config, state) {
     out[key] = resolved;
     if (propChanged) changed = true;
   }
+  brandResolved(out);
   return changed ? out : props;
 }
-var markerPresenceCache;
+var markerPresenceCache, markerResolutionCache, resolvedMarkerFree, evaluatorResolvedData;
 var init_resolve_render_bindings = __esm({
   "lib/resolve-render-bindings.ts"() {
     "use client";
     markerPresenceCache = /* @__PURE__ */ new WeakMap();
+    markerResolutionCache = /* @__PURE__ */ new WeakMap();
+    resolvedMarkerFree = /* @__PURE__ */ new WeakSet();
+    evaluatorResolvedData = /* @__PURE__ */ new WeakSet();
   }
 });
 function cn(...inputs) {
@@ -11793,6 +11825,10 @@ var init_molecules = __esm({
     init_puzzleObject();
   }
 });
+var init_perf = __esm({
+  "lib/perf.ts"() {
+  }
+});
 function themeBodyFont(el) {
   if (typeof getComputedStyle !== "function") return "system-ui, sans-serif";
   const v = getComputedStyle(el).getPropertyValue("--font-family-body").trim();
@@ -12141,6 +12177,7 @@ var init_LearningCanvas = __esm({
   "components/learning/atoms/LearningCanvas.tsx"() {
     "use client";
     init_cn();
+    init_perf();
     init_useEventBus();
     DASH_PATTERNS = { dashed: [6, 4], dotted: [2, 3] };
     TRACE_SERIES_COLORS = ["#2563eb", "#dc2626", "#16a34a", "#f59e0b"];
@@ -12184,6 +12221,7 @@ var init_LearningCanvas = __esm({
         return [...shapes, ...traceOut, ...readoutOut];
       }, [shapes, traces, readouts, width, height]);
       const draw = useCallback(() => {
+        const _perfT = perfStart("learningcanvas:paint");
         const canvas = canvasRef.current;
         if (!canvas) return;
         const ctx = canvas.getContext("2d");
@@ -12205,6 +12243,7 @@ var init_LearningCanvas = __esm({
         for (const shape of derivedShapes) {
           if (shape.type === "text") drawShape(ctx, shape, width, height, derivedShapes);
         }
+        perfEnd("learningcanvas:paint", _perfT);
       }, [width, height, backgroundColor, derivedShapes]);
       useEffect(() => {
         draw();
@@ -26501,8 +26540,8 @@ function DataGrid({
                         }
                         return /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center", children: [
                           field.icon && renderIconInput(field.icon, { size: "xs", className: "text-muted-foreground" }),
-                          /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", children: (field.label ?? fieldLabel2(field.name)) + ":" }),
-                          /* @__PURE__ */ jsx(Typography, { variant: "small", children: formatValue(value, field.format) })
+                          /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", className: "sr-only", children: (field.label ?? fieldLabel2(field.name)) + ":" }),
+                          /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: formatValue(value, field.format) })
                         ] }, field.name);
                       }) })
                     ] }) })
@@ -26930,7 +26969,11 @@ function DataList({
           Box,
           {
             className: cn(
-              "group flex items-center gap-4 transition-all duration-fast",
+              // items-start, not items-center: a multi-line row (title + meta +
+              // progress) centred its action cluster in the vertical middle, so
+              // the buttons floated between the meta fields instead of anchoring
+              // to the title they act on (U-DATALIST-ACTIONS-FLOAT-MID-ROW).
+              "group flex items-start gap-4 transition-all duration-fast",
               isCompact ? "px-4 py-2" : "px-6 py-4",
               "hover:bg-muted/80",
               !isCard && !isCompact && "rounded-lg border border-transparent hover:border-border"
@@ -26961,11 +27004,19 @@ function DataList({
                   if (value === void 0 || value === null || value === "") return null;
                   return /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center", children: [
                     field.icon && renderIconInput2(field.icon, { size: "xs", className: "text-muted-foreground" }),
-                    /* @__PURE__ */ jsxs(Typography, { variant: "caption", color: "secondary", children: [
-                      field.label ?? fieldLabel3(field.name),
-                      ":"
-                    ] }),
-                    /* @__PURE__ */ jsx(Typography, { variant: "small", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }) })
+                    /* @__PURE__ */ jsxs(
+                      Typography,
+                      {
+                        variant: "caption",
+                        color: "secondary",
+                        className: cn(field.format !== "boolean" && "sr-only"),
+                        children: [
+                          field.label ?? fieldLabel3(field.name),
+                          ":"
+                        ]
+                      }
+                    ),
+                    /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }) })
                   ] }, field.name);
                 }) }),
                 progressFields.map((field) => {
@@ -26984,7 +27035,7 @@ function DataList({
             ]
           }
         ),
-        isCard && !isLast && /* @__PURE__ */ jsx(Box, { className: "mx-6 border-b border-border/40" })
+        (isCard || isCompact) && !isLast && /* @__PURE__ */ jsx(Box, { className: cn("border-b border-border/40", isCompact ? "mx-4" : "mx-6") })
       ] }, id)
     );
   };
@@ -26994,7 +27045,13 @@ function DataList({
       {
         className: cn(
           isCard && "bg-card rounded-xl border border-border shadow-elevation-dialog overflow-hidden",
-          !isCard && gapClass,
+          // `gap-*` is inert on a block container, and Box only emits a display
+          // class when its `display` prop is set — so every non-card list had
+          // been asking for a gap that CSS silently dropped. flex-col makes it
+          // real. `compact` keeps gap-0 on purpose: it separates with the row
+          // divider above instead, never both (Almadar_UI_Beauty.md 6).
+          !isCard && "flex flex-col",
+          !isCard && !isCompact && gapClass,
           listLookStyles[look],
           className
         ),
@@ -30609,6 +30666,7 @@ var init_MathCanvas = __esm({
   "components/learning/molecules/MathCanvas.tsx"() {
     "use client";
     init_useEventBus();
+    init_perf();
     init_atoms();
     init_Stack();
     init_LearningCanvas();
@@ -30674,6 +30732,7 @@ var init_MathCanvas = __esm({
         };
       }, [stableKeyMap, stableKeyUpMap, eventBus]);
       const derivedShapes = useMemo(() => {
+        const _perfT = perfStart("mathcanvas:derive");
         const out = [];
         const margin = 24;
         const plotW = width - margin * 2;
@@ -30917,6 +30976,7 @@ var init_MathCanvas = __esm({
           }
         }
         out.push(...shapes);
+        perfEnd("mathcanvas:derive", _perfT);
         return out;
       }, [
         width,
@@ -32180,12 +32240,12 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect67, useRef: useRef64, useCallback: useCallback97, useState: useState95 } = React87__default;
+      const { useEffect: useEffect67, useRef: useRef65, useCallback: useCallback97, useState: useState95 } = React87__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 }) {
         const map = useMap();
-        const prevRef = useRef64({ centerLat, centerLng, zoom });
+        const prevRef = useRef65({ centerLat, centerLng, zoom });
         useEffect67(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
@@ -37270,7 +37330,7 @@ var init_RichBlockEditor = __esm({
         {
           variant: "bordered",
           padding: "none",
-          className: cn("flex flex-col", className),
+          className: cn("flex flex-col text-card-foreground", className),
           children: [
             enableBlocks && showToolbar && !readOnly && /* @__PURE__ */ jsx(
               Box,
@@ -42498,6 +42558,7 @@ var init_DetailPanel = __esm({
     "use client";
     init_atoms();
     init_Box();
+    init_Input();
     init_Stack();
     init_SimpleGrid();
     init_Menu();
@@ -42513,6 +42574,7 @@ var init_DetailPanel = __esm({
     ReactMarkdown2 = lazy(() => import('react-markdown'));
     DetailPanel = ({
       title: propTitle,
+      onTitleCommit,
       subtitle,
       status,
       avatar,
@@ -42534,6 +42596,7 @@ var init_DetailPanel = __esm({
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
+      const [titleDraft, setTitleDraft] = React87__default.useState(null);
       const isFieldDefArray = (arr) => {
         if (!arr || arr.length === 0) return false;
         const first = arr[0];
@@ -42754,6 +42817,50 @@ var init_DetailPanel = __esm({
         }),
         status && /* @__PURE__ */ jsx(Badge, { variant: status.variant ?? "default", children: status.label })
       ] });
+      const commitTitle = () => {
+        if (!onTitleCommit) return;
+        const next = (titleDraft ?? "").trim();
+        setTitleDraft(null);
+        if (!next || next === title) return;
+        onTitleCommit(next, normalizedData?.id !== void 0 ? String(normalizedData.id) : "");
+      };
+      const titleNode = onTitleCommit && titleDraft !== null ? /* @__PURE__ */ jsx(
+        Input,
+        {
+          value: titleDraft,
+          autoFocus: true,
+          "aria-label": t("common.title"),
+          className: "h-auto py-1 text-3xl font-bold tracking-tight",
+          onChange: (e) => setTitleDraft(e.target.value),
+          onBlur: commitTitle,
+          onKeyDown: (e) => {
+            if (e.key === "Enter") {
+              e.preventDefault();
+              commitTitle();
+            } else if (e.key === "Escape") {
+              e.preventDefault();
+              setTitleDraft(null);
+            }
+          },
+          "data-testid": "detail-title-input"
+        }
+      ) : onTitleCommit ? /* @__PURE__ */ jsx(
+        Box,
+        {
+          role: "button",
+          tabIndex: 0,
+          className: "cursor-text rounded px-1 -mx-1 transition-colors hover:bg-muted/40",
+          onClick: () => setTitleDraft(title ?? ""),
+          onKeyDown: (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+              e.preventDefault();
+              setTitleDraft(title ?? "");
+            }
+          },
+          "data-testid": "detail-title-editable",
+          children: /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" })
+        }
+      ) : /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" });
       const content = /* @__PURE__ */ jsx(Card, { variant: "elevated", children: /* @__PURE__ */ jsxs(VStack, { gap: "md", className: "p-6", children: [
         /* @__PURE__ */ jsxs(HStack, { justify: "between", align: "start", gap: "md", children: [
           /* @__PURE__ */ jsxs(HStack, { align: "start", gap: "sm", className: "min-w-0", children: [
@@ -42773,7 +42880,7 @@ var init_DetailPanel = __esm({
             avatar,
             /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "min-w-0", children: [
               /* @__PURE__ */ jsxs(HStack, { align: "center", gap: "sm", wrap: true, children: [
-                /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" }),
+                titleNode,
                 statusBadges
               ] }),
               subtitle && /* @__PURE__ */ jsx(Typography, { variant: "body", color: "secondary", children: subtitle })
@@ -42873,16 +42980,11 @@ var init_DetailPanel = __esm({
           footer
         ] })
       ] }) });
-      return /* @__PURE__ */ jsx(
-        Box,
-        {
-          className: cn(
-            slideOver && "fixed inset-y-0 right-0 w-full max-w-2xl bg-card shadow-lg z-50 overflow-y-auto p-6",
-            className
-          ),
-          children: content
-        }
-      );
+      if (!slideOver) {
+        return /* @__PURE__ */ jsx(Box, { className, children: content });
+      }
+      const panel = /* @__PURE__ */ jsx(Box, { className: cn("fixed inset-y-0 right-0 w-full max-w-2xl bg-card shadow-lg z-50 overflow-y-auto p-6", className), children: content });
+      return typeof document === "undefined" ? panel : createPortal(panel, document.body);
     };
     DetailPanel.displayName = "DetailPanel";
   }
@@ -43334,7 +43436,7 @@ var init_Form = __esm({
               });
               debug(
                 "forms",
-                `Calculation triggered: ${calc.variableName} = ${value}`
+                `Calculation triggered: ${calc.variableName} = ${String(value)}`
               );
             }
           });
@@ -49814,6 +49916,7 @@ function isPlainConfigObject(value) {
   return proto === Object.prototype || proto === null;
 }
 function subtreeHasTraitRef(value) {
+  if (isEvaluatorResolvedData(value)) return false;
   const cached = traitRefPresenceCache.get(value);
   if (cached !== void 0) return cached;
   let found = false;
@@ -49886,6 +49989,10 @@ function renderPatternProps(props, onDismiss, propsSchema) {
       };
       rendered[key] = /* @__PURE__ */ jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else if (Array.isArray(value)) {
+      if (!isEvaluatorResolvedData(value) && value.some((el) => isPatternConfig(el))) ; else if (!subtreeHasTraitRef(value)) {
+        rendered[key] = value;
+        continue;
+      }
       const isDataArray = propsSchema?.[key]?.items?.types?.includes("object") ?? false;
       rendered[key] = value.map((item, i) => {
         const el = item;
@@ -51327,6 +51434,53 @@ function useNavigationId2() {
 
 // providers/ServerBridge.tsx
 init_useEventBus();
+
+// lib/tick-send-relay.ts
+function createTickSendRelay(send) {
+  const lanes = /* @__PURE__ */ new Map();
+  const flush = (key, lane) => {
+    const next = lane.pending;
+    lane.pending = void 0;
+    if (next === void 0) {
+      lane.inFlight = false;
+      return;
+    }
+    lane.inFlight = true;
+    void send(key, next).catch(() => void 0).then(() => flush(key, lane));
+  };
+  return {
+    send(key, value) {
+      const lane = lanes.get(key) ?? { inFlight: false };
+      lanes.set(key, lane);
+      if (lane.inFlight) {
+        lane.pending = value;
+        return;
+      }
+      lane.pending = value;
+      flush(key, lane);
+    },
+    clear() {
+      for (const lane of lanes.values()) {
+        lane.pending = void 0;
+      }
+    }
+  };
+}
+
+// lib/command-send-pump.ts
+function createCommandSendPump() {
+  let tail = Promise.resolve();
+  return {
+    enqueue(job) {
+      const result = tail.then(job);
+      tail = result.then(
+        () => void 0,
+        () => void 0
+      );
+      return result;
+    }
+  };
+}
 var xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
 var serverBridgeLog = createLogger("almadar:ui:server-bridge");
 function reEmitServerEvent(eventBus, emitted, origin) {
@@ -51461,99 +51615,118 @@ function ServerBridgeProvider({
     async () => transport.unregister(),
     [transport]
   );
+  const tickRelay = useMemo(
+    () => createTickSendRelay(async (_key, snap) => {
+      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait);
+    }),
+    [transport]
+  );
+  useEffect(() => () => tickRelay.clear(), [tickRelay]);
+  const commandPump = useMemo(createCommandSendPump, []);
+  const disposedRef = useRef(false);
+  useEffect(() => {
+    disposedRef.current = false;
+    return () => {
+      disposedRef.current = true;
+    };
+  }, []);
   const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait) => {
     const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
-    try {
-      const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait);
-      const effects = [];
-      if (tick !== void 0) {
-        return { effects, meta: { ...emptyMeta, success: !!result.success, error: result.error } };
-      }
-      const responseData = result.data || {};
-      const dataEntities = {};
-      for (const [entityName, records] of Object.entries(responseData)) {
-        dataEntities[entityName] = Array.isArray(records) ? records.length : 0;
-      }
-      const meta = {
-        success: !!result.success,
-        clientEffects: result.clientEffects?.length ?? 0,
-        dataEntities,
-        data: responseData,
-        emittedEvents: result.emittedEvents?.map((e) => e.event) ?? [],
-        error: result.error
-      };
-      if (result.success) {
-        const tagged = result.clientEffectsByTrait;
-        const tuples = tagged ? tagged.map((entry) => ({ effect: entry.effect, traitName: entry.traitName })) : (result.clientEffects ?? []).map((eff) => ({ effect: eff }));
-        for (const { effect, traitName } of tuples) {
-          const effectType = effect[0];
-          if (effectType === "render-ui") {
-            const slot = effect[1];
-            const pattern = effect[2];
-            effects.push({
-              type: "render-ui",
-              slot,
-              pattern: pattern !== null && typeof pattern === "object" ? pattern : void 0,
-              traitName
-            });
-          } else if (effectType === "navigate") {
-            const route = effect[1];
-            const rawParams = effect[2];
-            const rawOptions = effect[3];
-            const optionsObj = rawOptions !== null && rawOptions !== void 0 && typeof rawOptions === "object" && !Array.isArray(rawOptions) ? rawOptions : void 0;
-            const crumb = typeof optionsObj?.crumb === "string" ? optionsObj.crumb : void 0;
-            effects.push({
-              type: "navigate",
-              route,
-              params: rawParams !== null && rawParams !== void 0 && typeof rawParams === "object" && !Array.isArray(rawParams) ? rawParams : void 0,
-              crumb,
-              traitName
-            });
-          } else if (effectType === "navigate-back") {
-            effects.push({ type: "navigate-back", traitName });
-          } else if (effectType === "notify") {
-            const message = effect[1];
-            effects.push({ type: "notify", message: typeof message === "string" ? message : void 0, traitName });
-          }
-        }
-        if (result.emittedEvents) {
-          for (const emitted of result.emittedEvents) {
-            if (emitted.event === event) continue;
-            reEmitServerEvent(
-              eventBus,
-              { ...emitted, source: { ...emitted.source, dispatched: true } },
-              orbitalName
-            );
+    if (tick !== void 0) {
+      tickRelay.send(`${orbitalName}:${event}`, { orbitalName, event, payload, tick, sourceTrait });
+      return { effects: [], meta: { ...emptyMeta, success: true } };
+    }
+    return commandPump.enqueue(async () => {
+      if (disposedRef.current) return { effects: [], meta: emptyMeta };
+      try {
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait);
+        const effects = [];
+        const responseData = result.data || {};
+        const dataEntities = {};
+        for (const [entityName, records] of Object.entries(responseData)) {
+          dataEntities[entityName] = Array.isArray(records) ? records.length : 0;
+        }
+        const meta = {
+          success: !!result.success,
+          clientEffects: result.clientEffects?.length ?? 0,
+          dataEntities,
+          data: responseData,
+          emittedEvents: result.emittedEvents?.map((e) => e.event) ?? [],
+          error: result.error
+        };
+        if (result.success) {
+          const tagged = result.clientEffectsByTrait;
+          const tuples = tagged ? tagged.map((entry) => ({ effect: entry.effect, traitName: entry.traitName })) : (result.clientEffects ?? []).map((eff) => ({ effect: eff }));
+          for (const { effect, traitName } of tuples) {
+            const effectType = effect[0];
+            if (effectType === "render-ui") {
+              const slot = effect[1];
+              const pattern = effect[2];
+              effects.push({
+                type: "render-ui",
+                slot,
+                pattern: pattern !== null && typeof pattern === "object" ? pattern : void 0,
+                traitName
+              });
+            } else if (effectType === "navigate") {
+              const route = effect[1];
+              const rawParams = effect[2];
+              const rawOptions = effect[3];
+              const optionsObj = rawOptions !== null && rawOptions !== void 0 && typeof rawOptions === "object" && !Array.isArray(rawOptions) ? rawOptions : void 0;
+              const crumb = typeof optionsObj?.crumb === "string" ? optionsObj.crumb : void 0;
+              effects.push({
+                type: "navigate",
+                route,
+                params: rawParams !== null && rawParams !== void 0 && typeof rawParams === "object" && !Array.isArray(rawParams) ? rawParams : void 0,
+                crumb,
+                traitName
+              });
+            } else if (effectType === "navigate-back") {
+              effects.push({ type: "navigate-back", traitName });
+            } else if (effectType === "notify") {
+              const message = effect[1];
+              effects.push({ type: "notify", message: typeof message === "string" ? message : void 0, traitName });
+            }
+          }
+          if (result.emittedEvents) {
+            for (const emitted of result.emittedEvents) {
+              if (emitted.event === event) continue;
+              reEmitServerEvent(
+                eventBus,
+                { ...emitted, source: { ...emitted.source, dispatched: true } },
+                orbitalName
+              );
+            }
           }
+        } else if (result.error) {
+          xOrbitalLog.warn("response:fail", {
+            orbital: orbitalName,
+            event,
+            error: result.error
+          });
         }
-      } else if (result.error) {
-        xOrbitalLog.warn("response:fail", {
-          orbital: orbitalName,
-          event,
-          error: result.error
-        });
-      }
-      return { effects, meta };
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      if (err instanceof TypeError) {
-        xOrbitalLog.warn("response:network", {
-          orbital: orbitalName,
-          event,
-          error: msg,
-          reason: "peer endpoint unreachable (expected in standalone single-orbital mode)"
-        });
-      } else {
-        xOrbitalLog.error("response:network", {
-          orbital: orbitalName,
-          event,
-          error: msg
-        });
+        return { effects, meta };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (err instanceof TypeError) {
+          xOrbitalLog.warn("response:network", {
+            orbital: orbitalName,
+            event,
+            error: msg,
+            reason: "peer endpoint unreachable (expected in standalone single-orbital mode)"
+          });
+        } else {
+          xOrbitalLog.error("response:network", {
+            orbital: orbitalName,
+            event,
+            error: msg
+          });
+        }
+        return { effects: [], meta: { ...emptyMeta, error: msg } };
       }
-      return { effects: [], meta: { ...emptyMeta, error: msg } };
-    }
-  }, [connected, transport, eventBus]);
+    });
+  }, [connected, transport, eventBus, tickRelay, commandPump]);
   useEffect(() => {
     if (!schema) return;
     let cancelled = false;