@almadar/ui 6.28.0 → 6.29.0

package/dist/providers/index.js

@@ -2263,6 +2263,13 @@ var init_slot_types = __esm({
     nextRefId = 1;
   }
 });
+var SlotContainedContext;
+var init_slotContained = __esm({
+  "lib/slotContained.ts"() {
+    "use client";
+    SlotContainedContext = createContext(false);
+  }
+});
 function buildForkPaths(x, y, branches, scale) {
   const inLength = 30 * scale;
   const outLength = 30 * scale;
@@ -35845,7 +35852,6 @@ function TableView({
   columns,
   fields,
   itemActions,
-  maxInlineActions,
   itemClickEvent = "",
   selectable = false,
   selectEvent,
@@ -35879,8 +35885,7 @@ function TableView({
   const [localSelected, setLocalSelected] = React89__default.useState(/* @__PURE__ */ new Set());
   const colDefs = (Array.isArray(columns) ? columns : void 0) ?? (Array.isArray(fields) ? fields : void 0) ?? [];
   const actionDefs = Array.isArray(itemActions) ? itemActions : [];
-  const inlineActions = maxInlineActions != null ? actionDefs.slice(0, maxInlineActions) : [];
-  const overflowActions = maxInlineActions != null ? actionDefs.slice(maxInlineActions) : actionDefs;
+  const overflowActions = actionDefs;
   const fireAction = (action, row) => eventBus.emit(`UI:${action.event}`, {
     id: row.id,
     row
@@ -36062,7 +36067,7 @@ function TableView({
             }
             return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx("span", { className: "truncate text-foreground", children: formatCell(raw, col.format, relationsData?.[col.field ?? col.key]) }) }, col.key);
           }),
-          hasActions && /* @__PURE__ */ jsxs(
+          hasActions && /* @__PURE__ */ jsx(
             HStack,
             {
               gap: "xs",
@@ -36076,38 +36081,20 @@ function TableView({
                 "border-l border-[var(--color-border)]",
                 lk.striped && index % 2 === 1 ? "bg-[var(--color-surface-subtle)]" : "bg-[var(--color-card)] group-hover:bg-[var(--color-surface-subtle)]"
               ),
-              children: [
-                inlineActions.map((action) => /* @__PURE__ */ jsxs(
-                  Button,
-                  {
-                    variant: action.variant ?? "ghost",
-                    size: "sm",
-                    onClick: () => fireAction(action, row),
-                    "data-testid": `action-${action.event}`,
-                    "data-row-id": String(row.id),
-                    className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
-                    children: [
-                      action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
-                      action.label
-                    ]
-                  },
-                  action.event
-                )),
-                overflowActions.length > 0 && /* @__PURE__ */ jsx(
-                  Menu,
-                  {
-                    position: "bottom-end",
-                    trigger: /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", "data-row-id": String(row.id), children: /* @__PURE__ */ jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
-                    items: overflowActions.map((action) => ({
-                      label: action.label,
-                      icon: action.icon,
-                      event: action.event,
-                      variant: action.variant === "danger" ? "danger" : "default",
-                      onClick: () => fireAction(action, row)
-                    }))
-                  }
-                )
-              ]
+              children: overflowActions.length > 0 && /* @__PURE__ */ jsx(
+                Menu,
+                {
+                  position: "bottom-end",
+                  trigger: /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", "data-row-id": String(row.id), children: /* @__PURE__ */ jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
+                  items: overflowActions.map((action) => ({
+                    label: action.label,
+                    icon: action.icon,
+                    event: action.event,
+                    variant: action.variant === "danger" ? "danger" : "default",
+                    onClick: () => fireAction(action, row)
+                  }))
+                }
+              )
             }
           )
         ]
@@ -45533,6 +45520,7 @@ var init_DetailPanel = __esm({
     init_EmptyState();
     init_cn();
     init_portalRoot();
+    init_slotContained();
     init_format();
     init_getNestedValue();
     init_relationLabel();
@@ -45564,6 +45552,7 @@ var init_DetailPanel = __esm({
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
+      const contained = useContext(SlotContainedContext);
       const [titleDraft, setTitleDraft] = React89__default.useState(null);
       const isFieldDefArray = (arr) => {
         if (!arr || arr.length === 0) return false;
@@ -45951,8 +45940,9 @@ var init_DetailPanel = __esm({
       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, getOrCreatePortalRoot());
+      const panel = /* @__PURE__ */ jsx(Box, { className: cn(contained ? "absolute" : "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 (contained || typeof document === "undefined") return panel;
+      return createPortal(panel, getOrCreatePortalRoot());
     };
     DetailPanel.displayName = "DetailPanel";
   }
@@ -52430,6 +52420,7 @@ var init_component_registry_generated = __esm({
 // components/core/organisms/UISlotRenderer.tsx
 var UISlotRenderer_exports = {};
 __export(UISlotRenderer_exports, {
+  SlotContainedContext: () => SlotContainedContext,
   SlotContentRenderer: () => SlotContentRenderer,
   SuspenseConfigProvider: () => SuspenseConfigProvider,
   UISlotComponent: () => UISlotComponent,
@@ -52602,6 +52593,25 @@ function renderContainedPortal(t, slot, content, onDismiss) {
         }
       );
     case "drawer":
+      if (content.pattern === "detail-panel" && content.props.slideOver === true) {
+        return /* @__PURE__ */ jsx(
+          Box,
+          {
+            id: slotId,
+            className: "absolute inset-0 z-50 overflow-hidden",
+            style: { backgroundColor: "rgba(0, 0, 0, 0.5)" },
+            onClick: onDismiss,
+            children: /* @__PURE__ */ jsx(
+              Box,
+              {
+                className: "absolute inset-y-0 right-0 pointer-events-auto",
+                onClick: (e) => e.stopPropagation(),
+                children: slotContent
+              }
+            )
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(
         Box,
         {
@@ -53453,7 +53463,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN, traitRefPresenceCache;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SLOT_SKELETON_MAP, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN, traitRefPresenceCache;
 var init_UISlotRenderer = __esm({
   "components/core/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -53468,6 +53478,7 @@ var init_UISlotRenderer = __esm({
     init_cn();
     init_format();
     init_portalRoot();
+    init_slotContained();
     init_ErrorBoundary();
     init_Skeleton();
     init_renderer();
@@ -53477,7 +53488,6 @@ var init_UISlotRenderer = __esm({
     scopeWrapLog = createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = createContext({ enabled: false });
-    SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
     SLOT_SKELETON_MAP = {
       main: "table",
@@ -54923,6 +54933,7 @@ function ServerBridgeProvider({
           clientEffects: result.clientEffects?.length ?? 0,
           dataEntities,
           data: responseData,
+          entityByTrait: result.entityByTrait,
           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,

package/dist/runtime/index.cjs

@@ -2936,6 +2936,13 @@ var init_slot_types = __esm({
     nextRefId = 1;
   }
 });
+var SlotContainedContext;
+var init_slotContained = __esm({
+  "lib/slotContained.ts"() {
+    "use client";
+    SlotContainedContext = React87.createContext(false);
+  }
+});
 function buildForkPaths(x, y, branches, scale) {
   const inLength = 30 * scale;
   const outLength = 30 * scale;
@@ -35697,7 +35704,6 @@ function TableView({
   columns,
   fields,
   itemActions,
-  maxInlineActions,
   itemClickEvent = "",
   selectable = false,
   selectEvent,
@@ -35731,8 +35737,7 @@ function TableView({
   const [localSelected, setLocalSelected] = React87__namespace.default.useState(/* @__PURE__ */ new Set());
   const colDefs = (Array.isArray(columns) ? columns : void 0) ?? (Array.isArray(fields) ? fields : void 0) ?? [];
   const actionDefs = Array.isArray(itemActions) ? itemActions : [];
-  const inlineActions = maxInlineActions != null ? actionDefs.slice(0, maxInlineActions) : [];
-  const overflowActions = maxInlineActions != null ? actionDefs.slice(maxInlineActions) : actionDefs;
+  const overflowActions = actionDefs;
   const fireAction = (action, row) => eventBus.emit(`UI:${action.event}`, {
     id: row.id,
     row
@@ -35914,7 +35919,7 @@ function TableView({
             }
             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(
+          hasActions && /* @__PURE__ */ jsxRuntime.jsx(
             HStack,
             {
               gap: "xs",
@@ -35928,38 +35933,20 @@ function TableView({
                 "border-l border-[var(--color-border)]",
                 lk.striped && index % 2 === 1 ? "bg-[var(--color-surface-subtle)]" : "bg-[var(--color-card)] group-hover:bg-[var(--color-surface-subtle)]"
               ),
-              children: [
-                inlineActions.map((action) => /* @__PURE__ */ jsxRuntime.jsxs(
-                  Button,
-                  {
-                    variant: action.variant ?? "ghost",
-                    size: "sm",
-                    onClick: () => fireAction(action, row),
-                    "data-testid": `action-${action.event}`,
-                    "data-row-id": String(row.id),
-                    className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
-                    children: [
-                      action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
-                      action.label
-                    ]
-                  },
-                  action.event
-                )),
-                overflowActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(
-                  Menu,
-                  {
-                    position: "bottom-end",
-                    trigger: /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", "data-row-id": String(row.id), children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
-                    items: overflowActions.map((action) => ({
-                      label: action.label,
-                      icon: action.icon,
-                      event: action.event,
-                      variant: action.variant === "danger" ? "danger" : "default",
-                      onClick: () => fireAction(action, row)
-                    }))
-                  }
-                )
-              ]
+              children: overflowActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(
+                Menu,
+                {
+                  position: "bottom-end",
+                  trigger: /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", "data-row-id": String(row.id), children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
+                  items: overflowActions.map((action) => ({
+                    label: action.label,
+                    icon: action.icon,
+                    event: action.event,
+                    variant: action.variant === "danger" ? "danger" : "default",
+                    onClick: () => fireAction(action, row)
+                  }))
+                }
+              )
             }
           )
         ]
@@ -45247,6 +45234,7 @@ var init_DetailPanel = __esm({
     init_EmptyState();
     init_cn();
     init_portalRoot();
+    init_slotContained();
     init_format();
     init_getNestedValue();
     init_relationLabel();
@@ -45278,6 +45266,7 @@ var init_DetailPanel = __esm({
     }) => {
       const eventBus = useEventBus();
       const { t } = hooks.useTranslate();
+      const contained = React87.useContext(SlotContainedContext);
       const [titleDraft, setTitleDraft] = React87__namespace.default.useState(null);
       const isFieldDefArray = (arr) => {
         if (!arr || arr.length === 0) return false;
@@ -45665,8 +45654,9 @@ var init_DetailPanel = __esm({
       if (!slideOver) {
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { className, children: content });
       }
-      const panel = /* @__PURE__ */ jsxRuntime.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 : reactDom.createPortal(panel, getOrCreatePortalRoot());
+      const panel = /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn(contained ? "absolute" : "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 (contained || typeof document === "undefined") return panel;
+      return reactDom.createPortal(panel, getOrCreatePortalRoot());
     };
     DetailPanel.displayName = "DetailPanel";
   }
@@ -52163,6 +52153,7 @@ var init_component_registry_generated = __esm({
 // components/core/organisms/UISlotRenderer.tsx
 var UISlotRenderer_exports = {};
 __export(UISlotRenderer_exports, {
+  SlotContainedContext: () => SlotContainedContext,
   SlotContentRenderer: () => SlotContentRenderer,
   SuspenseConfigProvider: () => SuspenseConfigProvider,
   UISlotComponent: () => UISlotComponent,
@@ -52335,6 +52326,25 @@ function renderContainedPortal(t, slot, content, onDismiss) {
         }
       );
     case "drawer":
+      if (content.pattern === "detail-panel" && content.props.slideOver === true) {
+        return /* @__PURE__ */ jsxRuntime.jsx(
+          Box,
+          {
+            id: slotId,
+            className: "absolute inset-0 z-50 overflow-hidden",
+            style: { backgroundColor: "rgba(0, 0, 0, 0.5)" },
+            onClick: onDismiss,
+            children: /* @__PURE__ */ jsxRuntime.jsx(
+              Box,
+              {
+                className: "absolute inset-y-0 right-0 pointer-events-auto",
+                onClick: (e) => e.stopPropagation(),
+                children: slotContent
+              }
+            )
+          }
+        );
+      }
       return /* @__PURE__ */ jsxRuntime.jsx(
         Box,
         {
@@ -53186,7 +53196,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN, traitRefPresenceCache;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SLOT_SKELETON_MAP, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN, traitRefPresenceCache;
 var init_UISlotRenderer = __esm({
   "components/core/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -53201,6 +53211,7 @@ var init_UISlotRenderer = __esm({
     init_cn();
     init_format();
     init_portalRoot();
+    init_slotContained();
     init_ErrorBoundary();
     init_Skeleton();
     init_renderer();
@@ -53210,7 +53221,6 @@ var init_UISlotRenderer = __esm({
     scopeWrapLog = logger.createLogger("almadar:ui:scope-wrap");
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
     SuspenseConfigContext = React87.createContext({ enabled: false });
-    SlotContainedContext = React87.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
     SLOT_SKELETON_MAP = {
       main: "table",
@@ -54678,6 +54688,9 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const normalizedEvent = normalizeEventKey(eventKey);
     return managerRef.current.canHandleEvent(traitName, normalizedEvent);
   }, []);
+  const commitServerEntity = React87.useCallback((traitName, entity) => {
+    traitFieldStatesRef.current.set(traitName, entity);
+  }, []);
   React87.useEffect(() => {
     const allEvents = /* @__PURE__ */ new Set();
     for (const binding of traitBindings) {
@@ -54841,7 +54854,8 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     sendEvent,
     getTraitState,
     canHandleEvent,
-    entityBindingSource
+    entityBindingSource,
+    commitServerEntity
   };
 }
 var resolvedSchemaLog = logger.createLogger("almadar:ui:resolved-schema");
@@ -55080,6 +55094,8 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = context.useUISlots();
+  const commitServerEntityRef = React87.useRef(() => {
+  });
   const onEventProcessed = React87.useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted, results, entityByTrait) => {
     if (!bridge.connected || !orbitalNames?.length) return;
     const targets = dispatchedOrbitals && dispatchedOrbitals.size > 0 ? orbitalNames.filter((n) => dispatchedOrbitals.has(n)) : orbitalNames;
@@ -55096,12 +55112,18 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
       }
       void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait, user ?? void 0).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
+        if (meta.entityByTrait) {
+          for (const [traitName, entity] of Object.entries(meta.entityByTrait)) {
+            commitServerEntityRef.current(traitName, entity);
+          }
+        }
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       });
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, user]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams };
-  const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
+  const { sendEvent, entityBindingSource, commitServerEntity } = useTraitStateMachine(traits2, uiSlots, opts);
+  commitServerEntityRef.current = commitServerEntity;
   const initSentRef = React87.useRef(false);
   const prevTraitsRef = React87.useRef(void 0);
   const paramsKey = JSON.stringify(routeParams ?? {});
@@ -55153,6 +55175,11 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
           user ?? void 0
         );
         recordServerResponse(name, "INIT", { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
+        if (meta.entityByTrait) {
+          for (const [traitName, entity] of Object.entries(meta.entityByTrait)) {
+            commitServerEntityRef.current(traitName, entity);
+          }
+        }
         const effectTraces = [
           { type: "fetch", args: [], status: "executed" },
           ...effects.map((eff) => ({

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-C6FgxdfG.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-UyeCfEBS.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-UyeCfEBS.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -30,6 +30,20 @@ interface TraitStateMachineResult {
     /** Live per-trait binding surface for `EntityBindingContext` — the
      * renderer resolves `RenderBindingMarker` prop leaves against it. */
     entityBindingSource: EntityBindingSource;
+    /**
+     * Commit a trait's authoritative entity row, as returned by a stateless
+     * server response's `entityByTrait[traitName]` (Fix C, the entity
+     * round-trip). The stateless deployment has no server-held memory
+     * across requests, so a `set`-only field a trait wrote on a PRIOR
+     * request would otherwise vanish on the next one (`traitFieldStatesRef`
+     * only ever reflects THIS client's own local writes) — replacing it
+     * here with the server's own post-effects row keeps the two in sync,
+     * the same way a fresh `getById` already does within a single request.
+     * A full replace, not a merge: the server sends the whole row after its
+     * own effects ran, the same authoritative shape a `fetch`/`getById`
+     * would return.
+     */
+    commitServerEntity: (traitName: string, entity: EntityRow) => void;
 }
 interface UseTraitStateMachineOptions {
     /**

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-C6FgxdfG.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-UyeCfEBS.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-UyeCfEBS.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -30,6 +30,20 @@ interface TraitStateMachineResult {
     /** Live per-trait binding surface for `EntityBindingContext` — the
      * renderer resolves `RenderBindingMarker` prop leaves against it. */
     entityBindingSource: EntityBindingSource;
+    /**
+     * Commit a trait's authoritative entity row, as returned by a stateless
+     * server response's `entityByTrait[traitName]` (Fix C, the entity
+     * round-trip). The stateless deployment has no server-held memory
+     * across requests, so a `set`-only field a trait wrote on a PRIOR
+     * request would otherwise vanish on the next one (`traitFieldStatesRef`
+     * only ever reflects THIS client's own local writes) — replacing it
+     * here with the server's own post-effects row keeps the two in sync,
+     * the same way a fresh `getById` already does within a single request.
+     * A full replace, not a merge: the server sends the whole row after its
+     * own effects ran, the same authoritative shape a `fetch`/`getById`
+     * would return.
+     */
+    commitServerEntity: (traitName: string, entity: EntityRow) => void;
 }
 interface UseTraitStateMachineOptions {
     /**