@almadar/ui 6.27.0 → 6.29.0

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");
@@ -55062,7 +55076,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, user, children }) {
   const bridge = providers.useServerBridge();
   const activeTraitNames = React87.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -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;
@@ -55094,14 +55110,20 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
         continue;
       }
-      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
+      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]);
+  }, [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 ?? {});
@@ -55141,8 +55163,23 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     initSentRef.current = true;
     (async () => {
       for (const name of orbitalNames) {
-        const { effects, meta } = await bridge.sendEvent(name, "INIT", withActiveTraits({ ...routeParams ?? {} }));
+        const { effects, meta } = await bridge.sendEvent(
+          name,
+          "INIT",
+          withActiveTraits({ ...routeParams ?? {} }),
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          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) => ({
@@ -55162,7 +55199,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams, user]);
   return /* @__PURE__ */ jsxRuntime.jsx(providers.EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
 function FitToBox({ children }) {
@@ -55189,7 +55226,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, user }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React87.useMemo(() => {
     let base;
@@ -55354,6 +55391,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onLocalFallback,
           localFallbackTimeoutMs,
           persistence,
+          user,
           children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
       )
@@ -55560,7 +55598,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
                 SchemaRunner,
@@ -55576,7 +55615,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) })
             ]

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-CTZw2DbY.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-CTZw2DbY.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-CTZw2DbY.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-CTZw2DbY.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 {
     /**