@almadar/ui 6.18.0 → 6.20.0

package/dist/{EntityBindingContext-Dglbi9ks.d.cts → EntityBindingContext-DoK8Xq71.d.cts}

@@ -2,7 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
-import { ServerEffectResult } from '@almadar/runtime';
+import { ServerEffectResult, TransitionResult } from '@almadar/runtime';
 
 /**
  * EntitySchemaContext
@@ -162,7 +162,14 @@ interface SendEventResult {
 }
 interface ServerBridgeContextValue {
     connected: boolean;
-    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, tick?: string, sourceTrait?: string, locallyEmitted?: readonly string[]) => Promise<SendEventResult>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, tick?: string, sourceTrait?: string, locallyEmitted?: readonly string[], 
+    /** Part G: traits the client's own local dispatch already executed for this event. */
+    results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, 
+    /** Part G: the client's own current entity snapshot per trait. */
+    entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<SendEventResult>;
 }
 /**
  * Transport adapter for ServerBridgeProvider. Decouples the bridge's
@@ -190,7 +197,10 @@ interface ServerBridgeTransport {
      * tick-originated latest-state broadcast: the server coalesces these
      * newest-per-key and relays them to other tabs at snapshot rate.
      */
-    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string) => Promise<OrbitalEventResponse>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/{EntityBindingContext-Dglbi9ks.d.ts → EntityBindingContext-DoK8Xq71.d.ts}

@@ -2,7 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
-import { ServerEffectResult } from '@almadar/runtime';
+import { ServerEffectResult, TransitionResult } from '@almadar/runtime';
 
 /**
  * EntitySchemaContext
@@ -162,7 +162,14 @@ interface SendEventResult {
 }
 interface ServerBridgeContextValue {
     connected: boolean;
-    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, tick?: string, sourceTrait?: string, locallyEmitted?: readonly string[]) => Promise<SendEventResult>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, tick?: string, sourceTrait?: string, locallyEmitted?: readonly string[], 
+    /** Part G: traits the client's own local dispatch already executed for this event. */
+    results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, 
+    /** Part G: the client's own current entity snapshot per trait. */
+    entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<SendEventResult>;
 }
 /**
  * Transport adapter for ServerBridgeProvider. Decouples the bridge's
@@ -190,7 +197,10 @@ interface ServerBridgeTransport {
      * tick-originated latest-state broadcast: the server coalesces these
      * newest-per-key and relays them to other tabs at snapshot rate.
      */
-    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string) => Promise<OrbitalEventResponse>;
+    sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/avl/index.cjs

@@ -60208,7 +60208,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
       const relayPayload = targetTrait !== void 0 ? { ...payload ?? {}, _targetTrait: targetTrait } : payload;
       const locallyEmitted = Array.from(emittedByTrait.values()).flat();
-      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted);
+      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted, results, entityByTrait);
     }
     ui.perfEnd("processEvent:total", _perfT0);
     ui.perfEnd(`event:${normalizedEvent}`, _perfT0);
@@ -60543,7 +60543,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = context.useUISlots();
-  const onEventProcessed = React96.useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted) => {
+  const onEventProcessed = React96.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;
     xOrbitalLog.debug("TraitInitializer:fanout", () => ({
@@ -60557,7 +60557,7 @@ 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).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
       });

package/dist/avl/index.js

@@ -60132,7 +60132,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
       const relayPayload = targetTrait !== void 0 ? { ...payload ?? {}, _targetTrait: targetTrait } : payload;
       const locallyEmitted = Array.from(emittedByTrait.values()).flat();
-      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted);
+      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted, results, entityByTrait);
     }
     perfEnd("processEvent:total", _perfT0);
     perfEnd(`event:${normalizedEvent}`, _perfT0);
@@ -60467,7 +60467,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = useUISlots();
-  const onEventProcessed = useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted) => {
+  const onEventProcessed = 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;
     xOrbitalLog.debug("TraitInitializer:fanout", () => ({
@@ -60481,7 +60481,7 @@ 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).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
       });

package/dist/providers/index.cjs

@@ -54627,8 +54627,28 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait) => {
-      const body = { event, payload, clientId, tick, sourceTrait };
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+      const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
+      const body = {
+        event,
+        payload,
+        clientId,
+        tick,
+        sourceTrait,
+        // `results === undefined` (as opposed to an explicit, possibly-empty
+        // array) distinguishes two genuinely different cases a stateless
+        // server must tell apart: the mount-time INIT dispatch (OrbPreview's
+        // "Server INIT when bridge connects" effect) calls this WITHOUT ever
+        // running a local dispatch first — by design, the server is
+        // authoritative for that one case — so there is no local `traits`
+        // list to send at all; a command-class dispatch (via
+        // `onEventProcessed`) always supplies `results`, even as `[]` when
+        // local dispatch genuinely matched nothing. Collapsing both to "omit
+        // `traits`" would make the mount-time case indistinguishable from
+        // "do nothing" and break every organism's INIT on the stateless path.
+        ...results !== void 0 ? { traits: traits2 ?? [] } : {},
+        ...entityByTrait ? { entityByTrait } : {}
+      };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
         headers: await authHeaders(getAccessToken),
@@ -54689,7 +54709,7 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted) => {
+  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait) => {
     const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
@@ -54699,7 +54719,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};

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-Dglbi9ks.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-DoK8Xq71.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-Dglbi9ks.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-DoK8Xq71.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';

package/dist/providers/index.js

@@ -54553,8 +54553,28 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait) => {
-      const body = { event, payload, clientId, tick, sourceTrait };
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+      const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
+      const body = {
+        event,
+        payload,
+        clientId,
+        tick,
+        sourceTrait,
+        // `results === undefined` (as opposed to an explicit, possibly-empty
+        // array) distinguishes two genuinely different cases a stateless
+        // server must tell apart: the mount-time INIT dispatch (OrbPreview's
+        // "Server INIT when bridge connects" effect) calls this WITHOUT ever
+        // running a local dispatch first — by design, the server is
+        // authoritative for that one case — so there is no local `traits`
+        // list to send at all; a command-class dispatch (via
+        // `onEventProcessed`) always supplies `results`, even as `[]` when
+        // local dispatch genuinely matched nothing. Collapsing both to "omit
+        // `traits`" would make the mount-time case indistinguishable from
+        // "do nothing" and break every organism's INIT on the stateless path.
+        ...results !== void 0 ? { traits: traits2 ?? [] } : {},
+        ...entityByTrait ? { entityByTrait } : {}
+      };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
         headers: await authHeaders(getAccessToken),
@@ -54615,7 +54635,7 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted) => {
+  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait) => {
     const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
@@ -54625,7 +54645,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};

package/dist/runtime/index.cjs

@@ -54332,7 +54332,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
       const relayPayload = targetTrait !== void 0 ? { ...payload ?? {}, _targetTrait: targetTrait } : payload;
       const locallyEmitted = Array.from(emittedByTrait.values()).flat();
-      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted);
+      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted, results, entityByTrait);
     }
     ui.perfEnd("processEvent:total", _perfT0);
     ui.perfEnd(`event:${normalizedEvent}`, _perfT0);
@@ -54770,7 +54770,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = context.useUISlots();
-  const onEventProcessed = React87.useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted) => {
+  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;
     xOrbitalLog.debug("TraitInitializer:fanout", () => ({
@@ -54784,7 +54784,7 @@ 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).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
       });

package/dist/runtime/index.d.cts

@@ -1,12 +1,12 @@
 import * as _almadar_core from '@almadar/core';
-import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
+import { EventPayload, EntityRow, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityData } from '@almadar/core';
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 import * as _almadar_runtime from '@almadar/runtime';
-import { TraitState, EffectHandlers } 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-Dglbi9ks.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-Dglbi9ks.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.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-DoK8Xq71.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';
@@ -54,7 +54,27 @@ interface UseTraitStateMachineOptions {
      */
     tick?: string, sourceTrait?: string, 
     /** Every event name this dispatch's local effect execution emitted, one entry per emit (multiplicity matters — see `stampLocallyDeliveredEchoes`). */
-    locallyEmitted?: readonly string[]) => void | Promise<void>;
+    locallyEmitted?: readonly string[], 
+    /**
+     * Every trait whose LOCAL dispatch actually executed a transition
+     * for this event (Part G, stateless dual-execution) — always a
+     * subset of successfully-transitioned traits, never filtered
+     * further here. A stateless server consults this instead of
+     * rediscovering "which traits match this event" against its own
+     * shared state.
+     */
+    results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, 
+    /**
+     * The client's own current entity snapshot per trait (built the
+     * same way as the `entityByTrait` already passed to
+     * `currentManager.sendEvent` above) — the input a stateless server
+     * needs for `[runtime]`-persistence entities, which have nowhere
+     * else to live.
+     */
+    entityByTrait?: Readonly<Record<string, EntityRow>>) => void | Promise<void>;
     /** Router navigate function for navigate effects. `crumb` labels the
      * target page's navigation-stack entry (from the effect's options). */
     navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;

package/dist/runtime/index.d.ts

@@ -1,12 +1,12 @@
 import * as _almadar_core from '@almadar/core';
-import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
+import { EventPayload, EntityRow, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityData } from '@almadar/core';
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 import * as _almadar_runtime from '@almadar/runtime';
-import { TraitState, EffectHandlers } 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-Dglbi9ks.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-Dglbi9ks.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.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-DoK8Xq71.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';
@@ -54,7 +54,27 @@ interface UseTraitStateMachineOptions {
      */
     tick?: string, sourceTrait?: string, 
     /** Every event name this dispatch's local effect execution emitted, one entry per emit (multiplicity matters — see `stampLocallyDeliveredEchoes`). */
-    locallyEmitted?: readonly string[]) => void | Promise<void>;
+    locallyEmitted?: readonly string[], 
+    /**
+     * Every trait whose LOCAL dispatch actually executed a transition
+     * for this event (Part G, stateless dual-execution) — always a
+     * subset of successfully-transitioned traits, never filtered
+     * further here. A stateless server consults this instead of
+     * rediscovering "which traits match this event" against its own
+     * shared state.
+     */
+    results?: ReadonlyArray<{
+        traitName: string;
+        result: TransitionResult;
+    }>, 
+    /**
+     * The client's own current entity snapshot per trait (built the
+     * same way as the `entityByTrait` already passed to
+     * `currentManager.sendEvent` above) — the input a stateless server
+     * needs for `[runtime]`-persistence entities, which have nowhere
+     * else to live.
+     */
+    entityByTrait?: Readonly<Record<string, EntityRow>>) => void | Promise<void>;
     /** Router navigate function for navigate effects. `crumb` labels the
      * target page's navigation-stack entry (from the effect's options). */
     navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;

package/dist/runtime/index.js

@@ -54258,7 +54258,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
       const relayPayload = targetTrait !== void 0 ? { ...payload ?? {}, _targetTrait: targetTrait } : payload;
       const locallyEmitted = Array.from(emittedByTrait.values()).flat();
-      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted);
+      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted, results, entityByTrait);
     }
     perfEnd("processEvent:total", _perfT0);
     perfEnd(`event:${normalizedEvent}`, _perfT0);
@@ -54696,7 +54696,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = useUISlots();
-  const onEventProcessed = useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait, locallyEmitted) => {
+  const onEventProcessed = 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;
     xOrbitalLog.debug("TraitInitializer:fanout", () => ({
@@ -54710,7 +54710,7 @@ 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).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.18.0",
+  "version": "6.20.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -121,8 +121,8 @@
     "@almadar/core": "^10.92.0",
     "@almadar/evaluator": "^2.45.0",
     "@almadar/logger": "^1.12.0",
-    "@almadar/runtime": "^6.78.0",
-    "@almadar/std": "^16.214.0",
+    "@almadar/runtime": "^6.79.0",
+    "@almadar/std": "^16.217.0",
     "@almadar/syntax": "^1.17.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",

package/themes/index.css

@@ -83,6 +83,18 @@
     border-color: var(--color-border, #e5e7eb);
 }
 
+/**
+ * currentColor anchor. A nested [data-theme] container re-scopes every
+ * var-based color utility, but the raw `color` property inherits straight
+ * through from the outer theme — `text-current` icons painted the outer
+ * theme's foreground on the inner theme's surface (white-on-white when a
+ * behavior pins a light theme inside a dark shell). Re-anchor `color` to
+ * the innermost theme's foreground so currentColor always matches.
+ */
+[data-theme] {
+    color: var(--color-foreground, inherit);
+}
+
 /**
  * Font inheritance for headings.
  *