@almadar/ui 6.14.0 → 6.16.0

package/dist/providers/index.cjs

@@ -3462,7 +3462,7 @@ var init_Textarea = __esm({
     init_cn();
     init_useEventBus();
     Textarea = React89__namespace.default.forwardRef(
-      ({ className, error, onChange, ...props }, ref) => {
+      ({ className, error, onChange, action, onKeyDown, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
           if (typeof onChange === "string") {
@@ -3471,11 +3471,18 @@ var init_Textarea = __esm({
             onChange?.(e);
           }
         };
+        const handleKeyDown = (e) => {
+          onKeyDown?.(e);
+          if (!action || e.key !== "Enter" || !(e.metaKey || e.ctrlKey)) return;
+          e.preventDefault();
+          eventBus.emit(`UI:${action}`, { value: e.currentTarget.value });
+        };
         return /* @__PURE__ */ jsxRuntime.jsx(
           "textarea",
           {
             ref,
             onChange: handleChange,
+            onKeyDown: handleKeyDown,
             className: cn(
               "block w-full border-[length:var(--border-width)] shadow-sm",
               "px-3 py-2 text-sm text-foreground",
@@ -9010,6 +9017,29 @@ var init_useCanvasGestures = __esm({
   }
 });
 
+// lib/keyMapEvent.ts
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  const tag = target.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
+  return target.isContentEditable || target.contentEditable === "true";
+}
+function keyMapCode(e) {
+  let code = e.code;
+  if (e.altKey) code = `Alt+${code}`;
+  if (e.shiftKey) code = `Shift+${code}`;
+  if (e.metaKey || e.ctrlKey) code = `Mod+${code}`;
+  return code;
+}
+function resolveKeyMapEvent(map, e) {
+  if (!map || isEditableTarget(e.target)) return void 0;
+  return map[keyMapCode(e)] ?? map[e.code];
+}
+var init_keyMapEvent = __esm({
+  "lib/keyMapEvent.ts"() {
+  }
+});
+
 // lib/imageCache.ts
 function startLoad(url, onReady, existing) {
   const img = new Image();
@@ -10935,14 +10965,14 @@ function Canvas2D({
   React89.useEffect(() => {
     if (!keyMap && !keyUpMap) return;
     const onDown = (e) => {
-      const ev = keyMap?.[e.code];
+      const ev = resolveKeyMapEvent(keyMap, e);
       if (ev) {
         eventBus.emit(`UI:${ev}`, {});
         e.preventDefault();
       }
     };
     const onUp = (e) => {
-      const ev = keyUpMap?.[e.code];
+      const ev = resolveKeyMapEvent(keyUpMap, e);
       if (ev) eventBus.emit(`UI:${ev}`, {});
     };
     window.addEventListener("keydown", onDown);
@@ -11066,6 +11096,7 @@ var init_Canvas2D = __esm({
     init_useCamera();
     init_useCanvasGestures();
     init_verificationRegistry();
+    init_keyMapEvent();
     init_webPainter2d();
     init_projector();
     init_paintDispatch();
@@ -27504,6 +27535,40 @@ var init_DashboardLayout = __esm({
     NavLinkBottom.displayName = "NavLinkBottom";
   }
 });
+
+// lib/relationLabel.ts
+function relationLabel(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date)
+    return null;
+  for (const key of ["name", "title", "label"]) {
+    const candidate = value[key];
+    if (typeof candidate === "string" && candidate !== "") return candidate;
+  }
+  const id = value.id;
+  return id !== void 0 && id !== null ? String(id) : null;
+}
+function relationDisplayLabels(value, options) {
+  if (value === void 0 || value === null || value === "") return [];
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => relationDisplayLabels(item, options));
+  }
+  const hydrated = relationLabel(value);
+  if (hydrated !== null) return [hydrated];
+  const raw = String(value);
+  const match = options?.find((opt) => opt.value === raw);
+  return [match ? match.label : raw];
+}
+function resolveRelationCellDisplay(value, options) {
+  if (value === null || value === void 0 || value === "") return void 0;
+  const isObjectShaped = typeof value === "object" && !(value instanceof Date) || Array.isArray(value) && value.some((v) => v !== null && typeof v === "object" && !(v instanceof Date));
+  if (!isObjectShaped && !options) return void 0;
+  const labels = relationDisplayLabels(value, options);
+  return labels.length > 0 ? labels.join(", ") : void 0;
+}
+var init_relationLabel = __esm({
+  "lib/relationLabel.ts"() {
+  }
+});
 function downloadItemUrl(url, label) {
   const a = document.createElement("a");
   a.href = url;
@@ -28335,7 +28400,8 @@ function DataGrid({
   positionEvent,
   dndItemIdField,
   dndRoot,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = hooks.useTranslate();
@@ -28525,6 +28591,10 @@ function DataGrid({
               );
             }
             const titleValue = core.getNestedValue(itemData, titleField?.name ?? "");
+            const titleDisplay = resolveRelationCellDisplay(
+              titleValue,
+              titleField ? relationsData?.[titleField.name] : void 0
+            ) ?? (titleValue !== void 0 && titleValue !== null ? String(titleValue) : void 0);
             return wrapDnd(
               /* @__PURE__ */ jsxRuntime.jsxs(
                 Box,
@@ -28549,7 +28619,7 @@ function DataGrid({
                         "img",
                         {
                           src: imgUrl,
-                          alt: titleValue !== void 0 ? String(titleValue) : "",
+                          alt: titleDisplay ?? "",
                           className: "w-full h-full object-cover",
                           loading: "lazy"
                         }
@@ -28564,18 +28634,18 @@ function DataGrid({
                           onChange: () => toggleSelection(id),
                           onClick: (e) => e.stopPropagation(),
                           className: "w-4 h-4 mt-1 flex-shrink-0 accent-primary",
-                          "aria-label": t("card.selectItem", { item: titleValue !== void 0 ? String(titleValue) : t("card.itemFallback") })
+                          "aria-label": t("card.selectItem", { item: titleDisplay ?? t("card.itemFallback") })
                         }
                       ),
                       /* @__PURE__ */ jsxRuntime.jsxs(VStack, { gap: "xs", className: "flex-1 min-w-0", children: [
-                        titleValue !== void 0 && titleValue !== null && /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center min-w-0", children: [
+                        titleDisplay !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center min-w-0", children: [
                           titleField?.icon && renderIconInput(titleField.icon, { size: "sm", className: "text-primary flex-shrink-0" }),
                           /* @__PURE__ */ jsxRuntime.jsx(
                             Typography,
                             {
                               variant: titleField?.variant === "h3" ? "h3" : "h4",
                               className: "font-semibold truncate min-w-0",
-                              children: String(titleValue)
+                              children: titleDisplay
                             }
                           )
                         ] }),
@@ -28584,7 +28654,7 @@ function DataGrid({
                           if (val === void 0 || val === null || val === "") return null;
                           return /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center", children: [
                             field.icon && renderIconInput(field.icon, { size: "xs" }),
-                            /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: resolveBadgeVariant(field, String(val)), children: humanizeEnumValue(formatValue(val, field.format)) })
+                            /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: resolveBadgeVariant(field, String(val)), children: resolveRelationCellDisplay(val, relationsData?.[field.name]) ?? humanizeEnumValue(formatValue(val, field.format)) })
                           ] }, field.name);
                         }) })
                       ] }),
@@ -28623,7 +28693,7 @@ function DataGrid({
                       bodyFields.filter((f3) => f3.variant === "caption" && f3.format !== "boolean").map((field) => {
                         const value = core.getNestedValue(itemData, field.name);
                         if (value === void 0 || value === null || value === "") return null;
-                        return /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", className: "line-clamp-2", children: formatValue(value, field.format) }, field.name);
+                        return /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", className: "line-clamp-2", children: resolveRelationCellDisplay(value, relationsData?.[field.name]) ?? formatValue(value, field.format) }, field.name);
                       }),
                       /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "md", className: "flex-wrap gap-y-1", children: bodyFields.filter((f3) => f3.variant !== "caption" || f3.format === "boolean").map((field) => {
                         const value = core.getNestedValue(itemData, field.name);
@@ -28638,7 +28708,7 @@ function DataGrid({
                         return /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center", children: [
                           field.icon && renderIconInput(field.icon, { size: "xs", className: "text-muted-foreground" }),
                           /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "caption", color: "secondary", className: "sr-only", children: (field.label ?? fieldLabel2(field.name)) + ":" }),
-                          /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", children: formatValue(value, field.format) })
+                          /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", children: resolveRelationCellDisplay(value, relationsData?.[field.name]) ?? formatValue(value, field.format) })
                         ] }, field.name);
                       }) })
                     ] }) })
@@ -28682,6 +28752,7 @@ var init_DataGrid = __esm({
     "use client";
     init_cn();
     init_format();
+    init_relationLabel();
     init_getNestedValue();
     init_useEventBus();
     init_Box();
@@ -28734,7 +28805,9 @@ function statusVariant3(value) {
   if (["new", "created", "scheduled", "queued", "info"].includes(v)) return "info";
   return "default";
 }
-function formatValue2(value, format, boolLabels) {
+function formatValue2(value, format, boolLabels, relationOptions) {
+  const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
+  if (relationDisplay !== void 0) return relationDisplay;
   if (value !== void 0 && value !== null && (format === "boolean" || typeof value === "boolean")) {
     const isNo = value === false || value === 0 || String(value) === "false";
     return isNo ? boolLabels?.no ?? "No" : boolLabels?.yes ?? "Yes";
@@ -28794,7 +28867,8 @@ function DataList({
   positionEvent,
   dndItemIdField,
   dndRoot,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = hooks.useTranslate();
@@ -28982,13 +29056,13 @@ function DataList({
                       return f3.variant === "badge" ? (
                         // `format` applies here too — a boolean field badged
                         // without it renders the raw "false" instead of "No".
-                        /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant3(String(v)), children: formatValue2(v, f3.format) }, f3.name)
+                        /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant3(String(v)), children: formatValue2(v, f3.format, void 0, relationsData?.[f3.name]) }, f3.name)
                       ) : /* @__PURE__ */ jsxRuntime.jsx(
                         Typography,
                         {
                           variant: "caption",
                           className: cn("text-xs", isSent ? "opacity-70" : "text-muted-foreground"),
-                          children: formatValue2(v, f3.format)
+                          children: formatValue2(v, f3.format, void 0, relationsData?.[f3.name])
                         },
                         f3.name
                       );
@@ -29066,6 +29140,10 @@ function DataList({
     }
     const id = itemData.id || String(index);
     const titleValue = core.getNestedValue(itemData, titleField?.name ?? "");
+    const titleDisplay = resolveRelationCellDisplay(
+      titleValue,
+      titleField ? relationsData?.[titleField.name] : void 0
+    ) ?? (titleValue !== void 0 && titleValue !== null ? String(titleValue) : void 0);
     return wrapDnd(
       /* @__PURE__ */ jsxRuntime.jsxs(Box, { "data-entity-row": true, "data-entity-id": id, onClick: rowClickEvent ? handleRowClick(itemData) : void 0, className: cn(rowClickEvent && "cursor-pointer"), children: [
         /* @__PURE__ */ jsxRuntime.jsxs(
@@ -29090,7 +29168,7 @@ function DataList({
                     {
                       variant: titleField?.variant === "h3" ? "h3" : "h4",
                       className: cn("font-semibold truncate flex-1", isCompact && "text-sm"),
-                      children: String(titleValue)
+                      children: titleDisplay
                     }
                   ),
                   badgeFields.map((field) => {
@@ -29098,7 +29176,7 @@ function DataList({
                     if (val === void 0 || val === null) return null;
                     return /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center flex-shrink-0", children: [
                       field.icon && renderIconInput2(field.icon, { size: "xs" }),
-                      /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant3(String(val)), children: formatValue2(val, field.format) })
+                      /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant3(String(val)), children: formatValue2(val, field.format, void 0, relationsData?.[field.name]) })
                     ] }, field.name);
                   })
                 ] }),
@@ -29119,7 +29197,7 @@ function DataList({
                         ]
                       }
                     ),
-                    /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }) })
+                    /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "secondary", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }, relationsData?.[field.name]) })
                   ] }, field.name);
                 }) }),
                 progressFields.map((field) => {
@@ -29199,6 +29277,7 @@ var init_DataList = __esm({
     "use client";
     init_cn();
     init_format();
+    init_relationLabel();
     init_getNestedValue();
     init_useEventBus();
     init_Box();
@@ -33043,6 +33122,7 @@ var init_MathCanvas = __esm({
     "use client";
     init_useEventBus();
     init_perf();
+    init_keyMapEvent();
     init_atoms();
     init_Stack();
     init_gameFonts();
@@ -33096,14 +33176,14 @@ var init_MathCanvas = __esm({
       React89.useEffect(() => {
         if (!stableKeyMap && !stableKeyUpMap) return;
         const onDown = (e) => {
-          const ev = stableKeyMap?.[e.code];
+          const ev = resolveKeyMapEvent(stableKeyMap, e);
           if (ev) {
             eventBus.emit(`UI:${ev}`, {});
             e.preventDefault();
           }
         };
         const onUp = (e) => {
-          const ev = stableKeyUpMap?.[e.code];
+          const ev = resolveKeyMapEvent(stableKeyUpMap, e);
           if (ev) eventBus.emit(`UI:${ev}`, {});
         };
         window.addEventListener("keydown", onDown);
@@ -35519,33 +35599,6 @@ var init_Lightbox = __esm({
     Lightbox.displayName = "Lightbox";
   }
 });
-
-// lib/relationLabel.ts
-function relationLabel(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date)
-    return null;
-  for (const key of ["name", "title", "label"]) {
-    const candidate = value[key];
-    if (typeof candidate === "string" && candidate !== "") return candidate;
-  }
-  const id = value.id;
-  return id !== void 0 && id !== null ? String(id) : null;
-}
-function relationDisplayLabels(value, options) {
-  if (value === void 0 || value === null || value === "") return [];
-  if (Array.isArray(value)) {
-    return value.flatMap((item) => relationDisplayLabels(item, options));
-  }
-  const hydrated = relationLabel(value);
-  if (hydrated !== null) return [hydrated];
-  const raw = String(value);
-  const match = options?.find((opt) => opt.value === raw);
-  return [match ? match.label : raw];
-}
-var init_relationLabel = __esm({
-  "lib/relationLabel.ts"() {
-  }
-});
 function renderIconInput3(icon, props) {
   return typeof icon === "string" ? /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, ...props }) : /* @__PURE__ */ jsxRuntime.jsx(Icon, { icon, ...props });
 }
@@ -35609,7 +35662,8 @@ function TableView({
   reorderEvent,
   positionEvent,
   dndItemIdField,
-  dndRoot
+  dndRoot,
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = hooks.useTranslate();
@@ -35694,7 +35748,7 @@ function TableView({
   const colFloors = React89__namespace.default.useMemo(
     () => colDefs.map((col) => {
       const longest = data.reduce((widest, row) => {
-        const cell = formatCell(asFieldValue(core.getNestedValue(row, col.field ?? col.key)), col.format);
+        const cell = formatCell(asFieldValue(core.getNestedValue(row, col.field ?? col.key)), col.format, relationsData?.[col.field ?? col.key]);
         return Math.max(widest, cell.length);
       }, columnLabel(col).length);
       const chrome = col.format === "badge" ? BADGE_CHROME_CH : 0;
@@ -35794,9 +35848,11 @@ function TableView({
               col.className
             );
             if (col.format === "badge" && raw != null && raw !== "") {
-              return /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant4(String(raw)), size: "sm", className: "whitespace-nowrap", children: humanizeEnumValue(String(raw)) }) }, col.key);
+              const relationDisplay = resolveRelationCellDisplay(raw, relationsData?.[col.field ?? col.key]);
+              const label = relationDisplay ?? humanizeEnumValue(String(raw));
+              return /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: statusVariant4(String(raw)), size: "sm", className: "whitespace-nowrap", children: label }) }, col.key);
             }
-            return /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-foreground", children: formatCell(raw, col.format) }) }, col.key);
+            return /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-foreground", children: formatCell(raw, col.format, relationsData?.[col.field ?? col.key]) }) }, col.key);
           }),
           hasActions && /* @__PURE__ */ jsxRuntime.jsxs(
             HStack,
@@ -35898,11 +35954,9 @@ var init_TableView = __esm({
     init_Menu();
     init_useDataDnd();
     tableViewLog = logger.createLogger("almadar:ui:table-view");
-    formatCell = (value, format) => {
-      if (value !== null && value !== void 0 && typeof value === "object" && !(value instanceof Date)) {
-        const labels = relationDisplayLabels(value);
-        if (labels.length > 0) return labels.join(", ");
-      }
+    formatCell = (value, format, relationOptions) => {
+      const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
+      if (relationDisplay !== void 0) return relationDisplay;
       return formatValue(value, format);
     };
     MAX_MEASURED_COL_CH = 32;
@@ -44612,7 +44666,8 @@ function DataTable({
   headerActions,
   showTotal = true,
   className,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const [openActionMenu, setOpenActionMenu] = React89.useState(
     null
@@ -44907,6 +44962,11 @@ function DataTable({
                       "data-column": String(col.key),
                       className: "px-4 py-3 text-sm text-foreground whitespace-nowrap sm:whitespace-normal",
                       children: col.render ? col.render(cellValue, row, rowIndex) : (() => {
+                        const relationDisplay = resolveRelationCellDisplay(
+                          cellValue,
+                          relationsData?.[String(col.key)]
+                        );
+                        if (relationDisplay !== void 0) return relationDisplay;
                         const boolVal = asBooleanValue2(cellValue);
                         if (boolVal !== null) {
                           return boolVal ? /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "success", children: t("common.yes") }) : /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "neutral", children: t("common.no") });
@@ -44995,6 +45055,7 @@ var init_DataTable = __esm({
     init_cn();
     init_format();
     init_getNestedValue();
+    init_relationLabel();
     init_atoms();
     init_Box();
     init_Stack();
@@ -53620,6 +53681,11 @@ function VerificationProvider({
         }
         const emittedEventsRaw = Array.isArray(payload["emittedEvents"]) ? payload["emittedEvents"] : [];
         const emittedEvents = emittedEventsRaw.map((e) => typeof e.event === "string" ? e.event : null).filter((e) => e !== null);
+        const emitted = emittedEventsRaw.flatMap((e) => {
+          if (typeof e.event !== "string") return [];
+          const p = e["payload"];
+          return [{ event: e.event, ...p !== null && typeof p === "object" && !Array.isArray(p) && { payload: p } }];
+        });
         recordTransition({
           traitName: parsed.traitName,
           from: pending?.from ?? payload["currentState"] ?? newState,
@@ -53629,9 +53695,11 @@ function VerificationProvider({
           serverResponse: {
             orbitalName: parsed.traitName,
             success: true,
+            ...typeof payload["transitioned"] === "boolean" && { transitioned: payload["transitioned"] },
             clientEffects: clientEffectsArr.length,
             dataEntities,
             emittedEvents,
+            emitted,
             timestamp: Date.now()
           },
           timestamp: Date.now()
@@ -53658,6 +53726,7 @@ function VerificationProvider({
           serverResponse: {
             orbitalName: parsed.traitName,
             success: false,
+            transitioned: false,
             clientEffects: 0,
             dataEntities: {},
             emittedEvents: [],
@@ -54433,6 +54502,26 @@ function createCommandSendPump() {
     }
   };
 }
+
+// lib/cascadeEcho.ts
+function stampLocallyDeliveredEchoes(dispatchedEvent, emitted, locallyEmitted) {
+  const remainingLocal = /* @__PURE__ */ new Map();
+  for (const name of locallyEmitted) {
+    remainingLocal.set(name, (remainingLocal.get(name) ?? 0) + 1);
+  }
+  const result = [];
+  for (const entry of emitted) {
+    if (entry.event === dispatchedEvent) continue;
+    const remaining = remainingLocal.get(entry.event) ?? 0;
+    if (remaining > 0) {
+      remainingLocal.set(entry.event, remaining - 1);
+      result.push({ ...entry, source: { ...entry.source, dispatched: true } });
+    } else {
+      result.push(entry);
+    }
+  }
+  return result;
+}
 var xOrbitalLog = logger.createLogger("almadar:runtime:cross-orbital");
 var serverBridgeLog = logger.createLogger("almadar:ui:server-bridge");
 function reEmitServerEvent(eventBus, emitted, origin) {
@@ -54542,7 +54631,7 @@ var ServerBridgeContext = React89.createContext(null);
 function useServerBridge() {
   const ctx = React89.useContext(ServerBridgeContext);
   if (!ctx) {
-    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+    const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     return { connected: false, sendEvent: async () => ({ effects: [], meta: emptyMeta }) };
   }
   return ctx;
@@ -54589,8 +54678,8 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait) => {
-    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted) => {
+    const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
       tickRelay.send(`${orbitalName}:${event}`, { orbitalName, event, payload, tick, sourceTrait });
@@ -54608,10 +54697,12 @@ function ServerBridgeProvider({
         }
         const meta = {
           success: !!result.success,
+          transitioned: result.transitioned === true,
           clientEffects: result.clientEffects?.length ?? 0,
           dataEntities,
           data: responseData,
           emittedEvents: result.emittedEvents?.map((e) => e.event) ?? [],
+          emitted: result.emittedEvents?.map((e) => ({ event: e.event, ...e.payload !== void 0 && { payload: e.payload } })) ?? [],
           effectResults: result.effectResults,
           error: result.error
         };
@@ -54647,13 +54738,8 @@ function ServerBridgeProvider({
             }
           }
           if (result.emittedEvents) {
-            for (const emitted of result.emittedEvents) {
-              if (emitted.event === event) continue;
-              reEmitServerEvent(
-                eventBus,
-                { ...emitted, source: { ...emitted.source, dispatched: true } },
-                orbitalName
-              );
+            for (const emitted of stampLocallyDeliveredEchoes(event, result.emittedEvents, locallyEmitted ?? [])) {
+              reEmitServerEvent(eventBus, emitted, orbitalName);
             }
           }
         } else if (result.error) {

package/dist/providers/index.d.cts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.cjs';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.cjs';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
-export { A as AccessTokenProvider, 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-BMz9xiBa.cjs';
+export { A as AccessTokenProvider, 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-Dglbi9ks.cjs';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.cjs';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';

package/dist/providers/index.d.ts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.js';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
-export { A as AccessTokenProvider, 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-BMz9xiBa.js';
+export { A as AccessTokenProvider, 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-Dglbi9ks.js';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.js';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.js';
 import '../verificationRegistry-Cwa52VyK.js';