@almadar/ui 6.14.0 → 6.15.0

package/dist/{EntityBindingContext-BMz9xiBa.d.cts → EntityBindingContext-EJoTtuTR.d.cts}

@@ -140,6 +140,13 @@ interface ServerClientEffect {
 /** Metadata about what the server returned, for debugger logging */
 interface ServerResponseMeta {
     success: boolean;
+    /** `OrbitalEventResponse.transitioned` — whether any arm accepted the event. */
+    transitioned: boolean;
+    /** Server-side emits with their evaluated payloads (`ServerResponseTrace.emitted`). */
+    emitted?: ReadonlyArray<{
+        event: string;
+        payload?: EventPayload;
+    }>;
     clientEffects: number;
     dataEntities: Record<string, number>;
     /** Raw entity data from server response (for EntityStore advancement) */

package/dist/{EntityBindingContext-BMz9xiBa.d.ts → EntityBindingContext-EJoTtuTR.d.ts}

@@ -140,6 +140,13 @@ interface ServerClientEffect {
 /** Metadata about what the server returned, for debugger logging */
 interface ServerResponseMeta {
     success: boolean;
+    /** `OrbitalEventResponse.transitioned` — whether any arm accepted the event. */
+    transitioned: boolean;
+    /** Server-side emits with their evaluated payloads (`ServerResponseTrace.emitted`). */
+    emitted?: ReadonlyArray<{
+        event: string;
+        payload?: EventPayload;
+    }>;
     clientEffects: number;
     dataEntities: Record<string, number>;
     /** Raw entity data from server response (for EntityStore advancement) */

package/dist/avl/index.cjs

@@ -59936,6 +59936,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const _perfT0 = ui.perfStart("processEvent:total");
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
+    if (sourceTrait === void 0 && tick === void 0) {
+      for (const snap of traitSnapshotDataRef.current.values()) {
+        snap.cascadeReceived = [];
+      }
+    }
     crossTraitLog.debug("processEvent:enter", () => ({
       event: normalizedEvent,
       payload: JSON.stringify(payload ?? null),
@@ -60111,6 +60116,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               // the verifier reads emittedEvents only.
               orbitalName: "",
               success: true,
+              transitioned: true,
               clientEffects: effectTraces.length,
               dataEntities: {},
               emittedEvents,

package/dist/avl/index.js

@@ -59860,6 +59860,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const _perfT0 = perfStart("processEvent:total");
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
+    if (sourceTrait === void 0 && tick === void 0) {
+      for (const snap of traitSnapshotDataRef.current.values()) {
+        snap.cascadeReceived = [];
+      }
+    }
     crossTraitLog.debug("processEvent:enter", () => ({
       event: normalizedEvent,
       payload: JSON.stringify(payload ?? null),
@@ -60035,6 +60040,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               // the verifier reads emittedEvents only.
               orbitalName: "",
               success: true,
+              transitioned: true,
               clientEffects: effectTraces.length,
               dataEntities: {},
               emittedEvents,

package/dist/providers/index.cjs

@@ -53620,6 +53620,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 +53634,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 +53665,7 @@ function VerificationProvider({
           serverResponse: {
             orbitalName: parsed.traitName,
             success: false,
+            transitioned: false,
             clientEffects: 0,
             dataEntities: {},
             emittedEvents: [],
@@ -54542,7 +54550,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;
@@ -54590,7 +54598,7 @@ function ServerBridgeProvider({
     };
   }, []);
   const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait) => {
-    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+    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 +54616,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
         };

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-EJoTtuTR.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-EJoTtuTR.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

@@ -53546,6 +53546,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,
@@ -53555,9 +53560,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()
@@ -53584,6 +53591,7 @@ function VerificationProvider({
           serverResponse: {
             orbitalName: parsed.traitName,
             success: false,
+            transitioned: false,
             clientEffects: 0,
             dataEntities: {},
             emittedEvents: [],
@@ -54468,7 +54476,7 @@ var ServerBridgeContext = createContext(null);
 function useServerBridge() {
   const ctx = 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;
@@ -54516,7 +54524,7 @@ function ServerBridgeProvider({
     };
   }, []);
   const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait) => {
-    const emptyMeta = { success: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
+    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 });
@@ -54534,10 +54542,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
         };

package/dist/runtime/index.cjs

@@ -54060,6 +54060,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const _perfT0 = ui.perfStart("processEvent:total");
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
+    if (sourceTrait === void 0 && tick === void 0) {
+      for (const snap of traitSnapshotDataRef.current.values()) {
+        snap.cascadeReceived = [];
+      }
+    }
     crossTraitLog.debug("processEvent:enter", () => ({
       event: normalizedEvent,
       payload: JSON.stringify(payload ?? null),
@@ -54235,6 +54240,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               // the verifier reads emittedEvents only.
               orbitalName: "",
               success: true,
+              transitioned: true,
               clientEffects: effectTraces.length,
               dataEntities: {},
               emittedEvents,

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, 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-BMz9xiBa.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-BMz9xiBa.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-EJoTtuTR.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-EJoTtuTR.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';

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, 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-BMz9xiBa.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-BMz9xiBa.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-EJoTtuTR.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-EJoTtuTR.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';

package/dist/runtime/index.js

@@ -53986,6 +53986,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const _perfT0 = perfStart("processEvent:total");
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
+    if (sourceTrait === void 0 && tick === void 0) {
+      for (const snap of traitSnapshotDataRef.current.values()) {
+        snap.cascadeReceived = [];
+      }
+    }
     crossTraitLog.debug("processEvent:enter", () => ({
       event: normalizedEvent,
       payload: JSON.stringify(payload ?? null),
@@ -54161,6 +54166,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
               // the verifier reads emittedEvents only.
               orbitalName: "",
               success: true,
+              transitioned: true,
               clientEffects: effectTraces.length,
               dataEntities: {},
               emittedEvents,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.14.0",
+  "version": "6.15.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -118,11 +118,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.90.0",
+    "@almadar/core": "^10.91.0",
     "@almadar/evaluator": "^2.45.0",
     "@almadar/logger": "^1.12.0",
-    "@almadar/runtime": "^6.75.0",
-    "@almadar/std": "^16.211.0",
+    "@almadar/runtime": "^6.76.0",
+    "@almadar/std": "^16.212.0",
     "@almadar/syntax": "^1.17.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",