@almadar/ui 6.52.0 → 6.53.1

package/dist/avl/index.d.ts

@@ -1,7 +1,7 @@
 import { OperatorCategory } from '@almadar/std';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { FieldType, EntityPersistence, SExpr, EvalTrace, A11yProps, EventEmit, Expression, UISlot, OrbitalSchema, EntityData, EditFocus, EventPayload, DomainQuestion, DomainQuestionAnswer, ThemeDefinition, CircuitStepResult, GuardEvaluation, EffectTrace } from '@almadar/core';
+import { FieldType, EntityPersistence, SExpr, EvalTrace, A11yProps, EventEmit, Expression, UISlot, OrbitalSchema, EntityData, EditFocus, EventPayload, AriaRole, DomainQuestion, DomainQuestionAnswer, ThemeDefinition, CircuitStepResult, GuardEvaluation, EffectTrace } from '@almadar/core';
 import { A as AvlNodeData, F as FileTreeItem } from '../FileTree-DUi7e7Z8.js';
 export { a as AvlEdgeData, b as AvlStateMachine, c as AvlStateMachineProps, B as BehaviorView, M as ModuleCard, s as schemaToFlowGraph } from '../FileTree-DUi7e7Z8.js';
 import { T as TraitLevelData, d as TraitTransitionInfo, c as TransitionLevelData } from '../avl-schema-parser-C0wnAp5x.js';
@@ -1213,7 +1213,10 @@ interface UseCanvasDraggableArgs {
 }
 interface UseCanvasDraggableResult {
     setNodeRef: (node: HTMLElement | null) => void;
-    attributes: ReturnType<typeof useDraggable>['attributes'];
+    /** dnd-kit's attributes, with `role` narrowed to a declared ARIA role so they spread onto a core `Box`. */
+    attributes: Omit<ReturnType<typeof useDraggable>['attributes'], 'role'> & {
+        role?: AriaRole;
+    };
     listeners: ReturnType<typeof useDraggable>['listeners'];
     isDragging: boolean;
     /** Spread on the tile — live transform + grab cursor + touch-action. */

package/dist/avl/index.js

@@ -1,28 +1,29 @@
-import { BrowserPlayground, collectEmbeddedTraits } from '../chunk-QWDKMVLX.js';
-import { zoomReducer, initialZoomState, getBreadcrumbs } from '../chunk-5GCI6C7J.js';
-import { useTranslate as useTranslate$1 } from '../chunk-NCNP2RKZ.js';
-import '../chunk-DQTV6QVS.js';
-import '../chunk-2QB2PXOO.js';
+import { zoomReducer, initialZoomState, getBreadcrumbs } from '../chunk-FUQASYEW.js';
+import { JsonTreeEditor } from '../chunk-UOTYAPV5.js';
+import { useTranslate as useTranslate$1 } from '../chunk-E37BYSXY.js';
 import { spacingTokenOf, positionOf, withPosition, snapToSpacingStep, defaultSpacingStepPx, spacingOf, withSizing, withSpacing, layoutOf, withLayout, sizingOf, DESIGN_COLOR_TOKENS, DESIGN_RADIUS_TOKENS, DESIGN_SPACING_SCALE, sizeLimitOf, withSizeLimit, isArbitraryClass, tokenOfDesignClass } from '../chunk-ERXIHZW3.js';
-import { Popover, Button, Icon, Select, Badge, IconButton, AvlStateMachine, Input, AvlFieldType, AvlEffect, AvlState, AvlPage, AvlEntity, useContainerWidth, useAlmadarDndSensors, almadarDndCollisionDetection, TagInput, Checkbox, Switch, CodeBlock, FileTree, Card, JsonTreeEditor, Accordion, RangeSlider, computeTraitLayout, edgePath, FormField, Radio, useCompactLayout, ButtonGroup, roundedEdgePath } from '../chunk-EERAGPBW.js';
-export { AvlEffect, AvlEntity, AvlFieldType, AvlPage, AvlState, AvlStateMachine, BehaviorView, FIELD_TYPE_SHAPES, MiniStateMachine, ModuleCard, computeTraitLayout, edgePath } from '../chunk-EERAGPBW.js';
-import { avlSeries, STATE_COLORS, Box, HStack, VStack, avlTint, CONNECTION_COLORS, parseTraitLevel, OPERATOR_CATEGORY_COLORS, AVL_INK, AVL_FONT, parseApplicationLevel, parseOrbitalLevel, getStateRole, effectCategoryOf, EFFECT_CATEGORY_COLORS, pressableProps, traitTransitionRenderUi, traitEventWires, effectZoneOf, avlBlend } from '../chunk-BHZG4PDZ.js';
-export { CONNECTION_COLORS, EFFECT_CATEGORY_COLORS, OPERATOR_CATEGORY_COLORS, STATE_COLORS, effectCategoryOf, getStateRole, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, traitLevelFromTrait } from '../chunk-BHZG4PDZ.js';
-import { Typography, INLINE_TEXT_ATTR } from '../chunk-CLSLVFSP.js';
-import { usePrefersReducedMotion, useMediaQuery } from '../chunk-TWHYH25Q.js';
+import { BrowserPlayground, collectEmbeddedTraits } from '../chunk-53VTY5CC.js';
+import '../chunk-DQTV6QVS.js';
+import '../chunk-VHTJRS2N.js';
+import { Popover, Button, Icon, Select, Badge, IconButton, AvlStateMachine, Input, AvlFieldType, AvlEffect, AvlState, AvlPage, AvlEntity, useContainerWidth, useAlmadarDndSensors, almadarDndCollisionDetection, TagInput, Checkbox, Switch, CodeBlock, FileTree, Card, Accordion, RangeSlider, computeTraitLayout, edgePath, FormField, Radio, useCompactLayout, ButtonGroup, roundedEdgePath } from '../chunk-HUG25TT3.js';
+export { AvlEffect, AvlEntity, AvlFieldType, AvlPage, AvlState, AvlStateMachine, BehaviorView, FIELD_TYPE_SHAPES, MiniStateMachine, ModuleCard, computeTraitLayout, edgePath } from '../chunk-HUG25TT3.js';
+import '../chunk-PQKU62LK.js';
+import { avlSeries, STATE_COLORS, Box, HStack, VStack, avlTint, CONNECTION_COLORS, parseTraitLevel, OPERATOR_CATEGORY_COLORS, AVL_INK, AVL_FONT, parseApplicationLevel, parseOrbitalLevel, getStateRole, effectCategoryOf, EFFECT_CATEGORY_COLORS, pressableProps, traitTransitionRenderUi, traitEventWires, effectZoneOf, avlBlend } from '../chunk-7LM6I3NA.js';
+export { CONNECTION_COLORS, EFFECT_CATEGORY_COLORS, OPERATOR_CATEGORY_COLORS, STATE_COLORS, effectCategoryOf, getStateRole, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, traitLevelFromTrait } from '../chunk-7LM6I3NA.js';
+import { Typography, INLINE_TEXT_ATTR } from '../chunk-HB4C27KU.js';
+import { usePrefersReducedMotion, useMediaQuery } from '../chunk-JRW33U35.js';
 import '../chunk-XJTHMW4G.js';
 import { useEventBus } from '../chunk-6EV3OEBQ.js';
-import { profilerOnRender, perfStart, perfEnd } from '../chunk-G4GMXYMY.js';
+import '../chunk-PEST66PN.js';
+import { profilerOnRender, perfStart, perfEnd } from '../chunk-KQXXO42S.js';
 import { isEditableTarget } from '../chunk-O7OLVVBR.js';
-import { domPassthrough, cn } from '../chunk-IN3BVW2Z.js';
-import '../chunk-V5AGW2JN.js';
-import '../chunk-WB2A6V3I.js';
-import '../chunk-PQKU62LK.js';
-import '../chunk-YHY5K2Y7.js';
+import { domPassthrough, cn } from '../chunk-64WACXM7.js';
+import '../chunk-QVXLKFUQ.js';
+import '../chunk-7KSLPY56.js';
 import '../chunk-QPXIAUJD.js';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import React19, { createContext, useContext, useState, useRef, useCallback, useMemo, useEffect, useLayoutEffect, Profiler, useReducer } from 'react';
-import { FieldTypeSchema, EFFECT_OPERATORS, isInlineTrait, isPageReference, navigatePatternPath, formatSExpr, answerToMutations, isBinding } from '@almadar/core';
+import { FieldTypeSchema, EFFECT_OPERATORS, isInlineTrait, isPageReference, navigatePatternPath, isAriaRole, formatSExpr, answerToMutations, isBinding } from '@almadar/core';
 import { operatorVisualForm, getStdOperatorMeta } from '@almadar/std/registry';
 import { useTranslate } from '@almadar/ui/hooks';
 import { MarkerType, Handle, Position, useReactFlow, NodeResizeControl, ResizeControlVariant, getBezierPath, EdgeLabelRenderer, BaseEdge, ReactFlow, Controls, Background, BackgroundVariant, ReactFlowProvider, useNodesState, useEdgesState, useNodesInitialized } from '@xyflow/react';
@@ -3475,13 +3476,18 @@ function stateOptionsFor(schema, orbitalName, entityName, transitions, view, moc
     const key = `${s.entry.traitName}|${s.entry.transition.to}`;
     stateUses.set(key, (stateUses.get(key) ?? 0) + 1);
   }
+  const armsSeen = /* @__PURE__ */ new Map();
   return screens.map(({ entry, enteredBy }) => {
     const t = entry.transition;
     const from = String(t.from);
     const state = view === "screens" ? (stateUses.get(`${entry.traitName}|${t.to}`) ?? 0) > 1 ? `${t.to} \xB7 ${t.event}` : t.to : `${t.event}: ${from} \u2192 ${t.to}`;
-    const label = manyTraits ? `${entry.traitName} \xB7 ${state}` : state;
+    const baseId = `${entry.traitName}:${t.event}:${from}:${t.to}`;
+    const arm = (armsSeen.get(baseId) ?? 0) + 1;
+    armsSeen.set(baseId, arm);
+    const named = manyTraits ? `${entry.traitName} \xB7 ${state}` : state;
+    const label = arm > 1 ? `${named} (guard ${arm})` : named;
     return {
-      id: `${entry.traitName}:${t.event}:${from}:${t.to}`,
+      id: arm > 1 ? `${baseId}#${arm}` : baseId,
       label,
       hint: view === "screens" ? enteredBy.join(" \xB7 ") : entry.traitName,
       data: {
@@ -4516,7 +4522,14 @@ function useCanvasDraggable({
     opacity: isDragging ? 0.5 : 1,
     touchAction: "none"
   };
-  return { setNodeRef, attributes, listeners, isDragging, style };
+  const { role, ...ariaAttributes } = attributes;
+  return {
+    setNodeRef,
+    attributes: { ...ariaAttributes, ...isAriaRole(role) ? { role } : {} },
+    listeners,
+    isDragging,
+    style
+  };
 }
 var DEFAULT_ACCEPTS = ["pattern", "behavior"];
 function useCanvasDroppable({

package/dist/{chunk-XUSSAWKL.js → chunk-2LFBQ4IS.js}

@@ -1,4 +1,4 @@
-import { beginPending, endPending } from './chunk-TWHYH25Q.js';
+import { beginPending, endPending } from './chunk-JRW33U35.js';
 import { useEventBus } from './chunk-6EV3OEBQ.js';
 import { useState, useCallback, useEffect, useMemo, useRef } from 'react';
 import { createLogger } from '@almadar/logger';

package/dist/{chunk-QWDKMVLX.js → chunk-53VTY5CC.js}

@@ -1,18 +1,18 @@
 import { runTickFrame } from './chunk-DQTV6QVS.js';
-import { ALL_SLOTS } from './chunk-2QB2PXOO.js';
-import { UISlotRenderer } from './chunk-EERAGPBW.js';
-import { Box } from './chunk-BHZG4PDZ.js';
-import { Typography } from './chunk-CLSLVFSP.js';
-import { beginPending, endPending } from './chunk-TWHYH25Q.js';
+import { ALL_SLOTS } from './chunk-VHTJRS2N.js';
+import { UISlotRenderer } from './chunk-HUG25TT3.js';
+import { Box } from './chunk-7LM6I3NA.js';
+import { Typography } from './chunk-HB4C27KU.js';
+import { beginPending, endPending } from './chunk-JRW33U35.js';
 import { useEventBus } from './chunk-6EV3OEBQ.js';
-import { registerTrait, unregisterTrait, perfTimeAsync } from './chunk-G4GMXYMY.js';
+import { isNotificationSlot } from './chunk-PEST66PN.js';
+import { registerTrait, unregisterTrait, perfTimeAsync } from './chunk-KQXXO42S.js';
 import { bindTraitStateGetter, registerTraitSnapshot, recordTransition, recordingTransport, recordServerResponse } from './chunk-O7OLVVBR.js';
-import { isNotificationSlot } from './chunk-YHY5K2Y7.js';
 import React, { useState, useMemo, useEffect, useRef, useCallback, useSyncExternalStore } from 'react';
 import { schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, applyListenPayloadMapping, buildResolvedTraitConfigs, collectCallsiteCaptureChildren, walkSExpr, isRenderBindingMarker, containsEntityBinding, isSExpr, isEventPayloadValue, RENDER_BINDING_MARKER } from '@almadar/core';
 import { createLogger } from '@almadar/logger';
-import { LIFECYCLE_EVENTS, InMemoryPersistence, createInProcessTransport, buildTraitIndex, createMemoryCircuitStore, createIndexStageRunner, evaluateOrbitalEvent, createClientKernel, collectListenerTargets, createTickScheduler, isValidCronExpression, parseDurationString, UNMOUNT_EVENT, createClientEffectHandlers, EffectExecutor, isSExpression, collectDeclaredConfigDefaults, createContextFromBindings, normalizeCallSiteConfigToValues } from '@almadar/runtime';
-import { useUser, useArbitraryClassStyles, getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, useNavStack, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, ServerBridgeProvider, useServerBridge, EntityBindingContext } from '@almadar/ui/providers';
+import { collectListenerTargets, LIFECYCLE_EVENTS, InMemoryPersistence, createInProcessTransport, buildTraitIndex, createMemoryCircuitStore, createIndexStageRunner, evaluateOrbitalEvent, createClientKernel, createTickScheduler, isValidCronExpression, parseDurationString, UNMOUNT_EVENT, createClientEffectHandlers, EffectExecutor, isSExpression, collectDeclaredConfigDefaults, createContextFromBindings, normalizeCallSiteConfigToValues } from '@almadar/runtime';
+import { useUser, useArbitraryClassStyles, getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, useNavStack, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, ServerBridgeProvider, useServerBridge, EntityBindingContext, AwaitingSkeletonContext } from '@almadar/ui/providers';
 import { evaluateListenPayloadExpr, evaluate, createMinimalContext, evaluateGuard, executeEffects } from '@almadar/evaluator';
 import { getPatternDefinition } from '@almadar/core/patterns';
 import { isKnownStdOperator } from '@almadar/std/registry';
@@ -270,6 +270,18 @@ function useCircuitKernel(traitBindings, options) {
     [baseTransport]
   );
   const orbitalName = options.orbitals[0]?.name ?? "";
+  const topology = useMemo(() => {
+    let resolve = () => void 0;
+    const promise = new Promise((r) => {
+      resolve = r;
+    });
+    return { promise, resolve };
+  }, [effectiveTransport]);
+  const awaitTopology = options.awaitTopology === true;
+  const confirmedCarries = options.carriesCircuitState ?? false;
+  useEffect(() => {
+    if (!awaitTopology) topology.resolve({ carriesCircuitState: confirmedCarries });
+  }, [awaitTopology, confirmedCarries, topology]);
   const rawKernel = useMemo(() => createClientKernel({
     orbitalName,
     traitIndex,
@@ -282,7 +294,8 @@ function useCircuitKernel(traitBindings, options) {
     ...options.contextExtensions !== void 0 ? { contextExtensions: options.contextExtensions } : {},
     ...options.debug !== void 0 ? { debug: options.debug } : {},
     ...options.logContext !== void 0 ? { logContext: options.logContext } : {},
-    carriesCircuitState: options.carriesCircuitState ?? false,
+    carriesCircuitState: false,
+    topology: topology.promise,
     ...effectiveTransport !== void 0 ? { transport: effectiveTransport } : {}
   }), [
     orbitalName,
@@ -296,50 +309,16 @@ function useCircuitKernel(traitBindings, options) {
     options.contextExtensions,
     options.debug,
     options.logContext,
-    options.carriesCircuitState,
+    topology,
     effectiveTransport
   ]);
-  const rawKernelRef = useRef(rawKernel);
-  rawKernelRef.current = rawKernel;
-  const awaitTopology = options.awaitTopology === true;
-  const holdRef = useRef(awaitTopology);
-  holdRef.current = awaitTopology;
-  const heldRef = useRef([]);
-  useEffect(() => {
-    if (awaitTopology) return;
-    const held = heldRef.current;
-    heldRef.current = [];
-    for (const release of held) release();
-  }, [awaitTopology, rawKernel]);
   const kernel = useMemo(() => ({
     store: rawKernel.store,
-    dispatch: (request) => {
-      const stamped = request.clientId !== void 0 ? request : { ...request, clientId: getTabClientId() };
-      if (!holdRef.current) return rawKernel.dispatch(stamped);
-      return new Promise((resolve, reject) => {
-        heldRef.current.push(() => {
-          rawKernelRef.current.dispatch(stamped).then(resolve, reject);
-        });
-      });
-    }
+    dispatch: (request, hooks) => rawKernel.dispatch(request.clientId !== void 0 ? request : { ...request, clientId: getTabClientId() }, hooks),
+    dispatchMount: (seeds, hooks, base = {}) => rawKernel.dispatchMount(seeds, hooks, base.clientId !== void 0 ? base : { ...base, clientId: getTabClientId() }),
+    dispatchProgress: (request) => rawKernel.dispatchProgress(request.clientId !== void 0 ? request : { ...request, clientId: getTabClientId() })
   }), [rawKernel]);
-  const kernelRef = useRef(kernel);
-  kernelRef.current = kernel;
-  useEffect(() => {
-    if (!effectiveTransport?.subscribe) return;
-    return effectiveTransport.subscribe((emitted) => {
-      const targets = collectListenerTargets(traitIndex, emitted.source, emitted.event, emitted.payload);
-      for (const target of targets) {
-        void kernelRef.current.dispatch({
-          event: target.triggers,
-          ...target.payload !== void 0 ? { payload: target.payload } : {},
-          ...target.entityId !== void 0 ? { entityId: target.entityId } : {},
-          targetTrait: target.listenerTrait
-        });
-      }
-    }, { clientId: getTabClientId() });
-  }, [effectiveTransport, traitIndex]);
-  return { kernel, store, traitIndex };
+  return { kernel, store, traitIndex, transport: effectiveTransport };
 }
 var log2 = createLogger("almadar:ui:circuit:bus-ingress");
 function useBusIngress(traitBindings, traitIndex, settle, eventBus) {
@@ -519,7 +498,7 @@ function resolveLambdaBindings(body, params, item, index) {
   return body;
 }
 var LazySlotContentRenderer = React.lazy(
-  () => import('./UISlotRenderer-CR7SCAMR.js').then((m) => ({ default: m.SlotContentRenderer }))
+  () => import('./UISlotRenderer-P7A4SZSK.js').then((m) => ({ default: m.SlotContentRenderer }))
 );
 function deferLambdaEntityExprs(value) {
   if (typeof value === "string") {
@@ -1131,6 +1110,25 @@ function sameFields(a, b) {
   }
   return true;
 }
+function useAwaitingSkeletonSource(store, traitIndex, embeddedTraits) {
+  return useMemo(() => {
+    const activeRenders = () => {
+      const renders = [];
+      for (const awaiting of store.awaiting.list()) {
+        const transitions = traitIndex.byName.get(awaiting.trait)?.irTrait.stateMachine?.transitions ?? [];
+        const taken = transitions.find((t) => t.event === awaiting.event && t.from === awaiting.from);
+        if (taken?.awaitRender) renders.push(...taken.awaitRender);
+      }
+      return renders;
+    };
+    return {
+      forSlot: (slot) => activeRenders().find((r) => r.slot === slot && !(embeddedTraits?.has(r.trait) ?? false))?.skeleton,
+      forTrait: (traitName) => activeRenders().find((r) => r.trait === traitName)?.skeleton,
+      subscribe: (callback) => store.awaiting.subscribeAll(callback),
+      getVersion: () => store.awaiting.getVersion()
+    };
+  }, [store, traitIndex, embeddedTraits]);
+}
 
 // hooks/useTraitStateMachine.ts
 var stateLog = createLogger("almadar:ui:state-transitions");
@@ -1149,7 +1147,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   const { user: contextViewer } = useUser();
   const userContext = options.user ?? contextViewer ?? void 0;
   const observer = useMemo(() => createCircuitVerificationObserver(), []);
-  const { kernel, store, traitIndex } = useCircuitKernel(traitBindings, {
+  const { kernel, store, traitIndex, transport } = useCircuitKernel(traitBindings, {
     orbitals: options.orbitals,
     ...options.traitConfigsByName !== void 0 ? { traitConfigsByName: options.traitConfigsByName } : {},
     ...options.transport !== void 0 ? { transport: options.transport } : {},
@@ -1179,6 +1177,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     ...userContext !== void 0 ? { user: userContext } : {}
   });
   const entityBindingSource = useEntityBindingSource(store, traitIndex);
+  const awaitingSkeletonSource = useAwaitingSkeletonSource(store, traitIndex, options.embeddedTraits);
   const activeTraitNamesRef = useRef(/* @__PURE__ */ new Set());
   useEffect(() => {
     activeTraitNamesRef.current = new Set(traitIndex.byName.keys());
@@ -1226,6 +1225,35 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       for (const unreg of snapshotUnregs) unreg();
     };
   }, [traitBindings, store, traitIndex]);
+  const afterSettle = useCallback(async (traitName, eventKey, payload, transitioned, repaints, composedBefore) => {
+    if (transitioned) {
+      const entityByTrait = {};
+      for (const [name, entry] of traitIndex.byName) {
+        const row = store.frames.get(entry.frameKey);
+        if (row !== void 0) entityByTrait[name] = row;
+      }
+      const repainted = new Set(repaints.map((e) => e.traitName));
+      const serverComposed = new Set([...store.callsitePayloads].filter(([child, composed]) => composedBefore.get(child) !== composed).map(([child]) => child));
+      await reRenderCallsiteCaptureChildren(traitName, payload ?? {}, entityByTrait, repainted, serverComposed);
+    }
+    options.onEventProcessed?.(eventKey, payload);
+  }, [traitIndex, store, reRenderCallsiteCaptureChildren, options.onEventProcessed]);
+  const settleOutcome = useCallback(async (traitName, eventKey, payload, outcome, composedBefore) => {
+    recordDispatchVerdict(traitIndex.byName.get(traitName)?.orbitalName ?? traitName, eventKey, { response: outcome.response });
+    const settledEffects = outcome.localPainted && outcome.serverEffects !== void 0 ? outcome.serverEffects : outcome.response;
+    slotFlush.applyClientEffects(
+      settledEffects.clientEffects ?? [],
+      settledEffects.clientEffectsByTrait,
+      options.navigate,
+      options.navigateBack,
+      activeTraitNamesRef.current
+    );
+    for (const emitted of outcome.response.emittedEvents) {
+      eventBus.emit(`UI:${emitted.event}`, emitted.payload, { ...emitted.source ?? {}, dispatched: true });
+    }
+    stateLog.debug("dispatch:settled", { traitName, eventKey, mode: outcome.mode, transitioned: outcome.response.transitioned });
+    await afterSettle(traitName, eventKey, payload, outcome.response.transitioned, outcome.response.clientEffectsByTrait ?? [], composedBefore);
+  }, [slotFlush, traitIndex, eventBus, options.navigate, options.navigateBack, afterSettle]);
   const dispatchAndSettle = useCallback(async (traitName, eventKey, payload, tick) => {
     const entityId = typeof payload?.entityId === "string" ? payload.entityId : void 0;
     const orbitalName = traitIndex.byName.get(traitName)?.orbitalName ?? traitName;
@@ -1256,34 +1284,63 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       recordDispatchVerdict(orbitalName, eventKey, { error: err instanceof Error ? err : String(err) });
       throw err;
     }
-    recordDispatchVerdict(orbitalName, eventKey, { response: outcome.response });
     if (outcome.localPainted && !outcome.response.success && beforeLocalPaint !== void 0) {
       slotFlush.rollback(beforeLocalPaint);
     }
-    const settledEffects = outcome.localPainted && outcome.serverEffects !== void 0 ? outcome.serverEffects : outcome.response;
-    slotFlush.applyClientEffects(
-      settledEffects.clientEffects ?? [],
-      settledEffects.clientEffectsByTrait,
-      options.navigate,
-      options.navigateBack,
-      activeTraitNamesRef.current
-    );
-    for (const emitted of outcome.response.emittedEvents) {
-      eventBus.emit(`UI:${emitted.event}`, emitted.payload, { ...emitted.source ?? {}, dispatched: true });
-    }
-    stateLog.debug("dispatch:settled", { traitName, eventKey, mode: outcome.mode, transitioned: outcome.response.transitioned });
-    if (outcome.response.transitioned) {
-      const entityByTrait = {};
-      for (const [name, entry] of traitIndex.byName) {
-        const row = store.frames.get(entry.frameKey);
-        if (row !== void 0) entityByTrait[name] = row;
+    await settleOutcome(traitName, eventKey, payload, outcome, composedBefore);
+  }, [kernel, slotFlush, traitIndex, store, options.navigate, options.navigateBack, settleOutcome]);
+  const progressAndSettle = useCallback(async (traitName, eventKey, payload) => {
+    const entityId = typeof payload?.entityId === "string" ? payload.entityId : void 0;
+    const composedBefore = new Map(store.callsitePayloads);
+    const outcome = await kernel.dispatchProgress({
+      event: eventKey,
+      ...payload !== void 0 ? { payload } : {},
+      ...entityId !== void 0 ? { entityId } : {},
+      targetTrait: traitName
+    });
+    await settleOutcome(traitName, eventKey, payload, outcome, composedBefore);
+  }, [kernel, store, settleOutcome]);
+  useEffect(() => {
+    if (!transport?.subscribe) return;
+    return transport.subscribe((emitted, target) => {
+      for (const t of collectListenerTargets(traitIndex, emitted.source, emitted.event, emitted.payload)) {
+        void (target === "origin" ? progressAndSettle(t.listenerTrait, t.triggers, t.payload) : dispatchAndSettle(t.listenerTrait, t.triggers, t.payload));
       }
-      const repainted = new Set((outcome.response.clientEffectsByTrait ?? []).map((e) => e.traitName));
-      const serverComposed = new Set([...store.callsitePayloads].filter(([child, composed]) => composedBefore.get(child) !== composed).map(([child]) => child));
-      await reRenderCallsiteCaptureChildren(traitName, payload ?? {}, entityByTrait, repainted, serverComposed);
+    }, { clientId: getTabClientId() });
+  }, [transport, traitIndex, progressAndSettle, dispatchAndSettle]);
+  const mountAndSettle = useCallback(async (seeds, payload) => {
+    const composedBefore = new Map(store.callsitePayloads);
+    let beforeLocalPaint;
+    let outcome;
+    try {
+      outcome = await kernel.dispatchMount(seeds, {
+        onLocal: (_trait, local) => {
+          if (beforeLocalPaint === void 0) beforeLocalPaint = slotFlush.checkpoint();
+          slotFlush.applyClientEffects(local.clientEffects ?? [], local.clientEffectsByTrait, options.navigate, options.navigateBack, activeTraitNamesRef.current);
+        }
+      }, { payload });
+    } catch (err) {
+      if (beforeLocalPaint !== void 0) slotFlush.rollback(beforeLocalPaint);
+      for (const seed of seeds) {
+        recordDispatchVerdict(traitIndex.byName.get(seed.trait)?.orbitalName ?? seed.trait, seed.event, { error: err instanceof Error ? err : String(err) });
+      }
+      throw err;
     }
-    options.onEventProcessed?.(eventKey, payload);
-  }, [kernel, slotFlush, traitIndex, store, eventBus, reRenderCallsiteCaptureChildren, options.navigate, options.navigateBack, options.onEventProcessed]);
+    if (!outcome.success && beforeLocalPaint !== void 0) slotFlush.rollback(beforeLocalPaint);
+    slotFlush.applyClientEffects(outcome.serverEffects.clientEffects ?? [], outcome.serverEffects.clientEffectsByTrait, options.navigate, options.navigateBack, activeTraitNamesRef.current);
+    const emitted = [...outcome.seeds.flatMap((seed) => seed.local.emittedEvents), ...outcome.emittedEvents];
+    for (const e of emitted) {
+      eventBus.emit(`UI:${e.event}`, e.payload, { ...e.source ?? {}, dispatched: true });
+    }
+    const serverRepaints = outcome.serverEffects.clientEffectsByTrait ?? [];
+    for (const seed of outcome.seeds) {
+      recordDispatchVerdict(traitIndex.byName.get(seed.trait)?.orbitalName ?? seed.trait, seed.event, {
+        response: { ...seed.local, success: outcome.success, ...outcome.error !== void 0 ? { error: outcome.error } : {} }
+      });
+      stateLog.debug("mount:settled", { traitName: seed.trait, eventKey: seed.event, mode: seed.mode, transitioned: seed.local.transitioned });
+      await afterSettle(seed.trait, seed.event, payload, seed.local.transitioned, [...seed.local.clientEffectsByTrait ?? [], ...serverRepaints], composedBefore);
+    }
+  }, [kernel, slotFlush, traitIndex, store, eventBus, options.navigate, options.navigateBack, afterSettle]);
   useBusIngress(traitBindings, traitIndex, dispatchAndSettle, eventBus);
   const sendEvent = useCallback((eventKey, payload) => {
     const normalized = normalizeEventKey(eventKey);
@@ -1324,17 +1381,19 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       if (mount.initialized.has(traitName)) continue;
       mount.initialized.add(traitName);
       const lifecycleEvent = LIFECYCLE_EVENTS.find((evt) => store.manager.canHandleEvent(traitName, evt));
-      if (lifecycleEvent !== void 0) entering.push({ traitName, lifecycleEvent });
+      if (lifecycleEvent !== void 0) entering.push({ trait: traitName, event: lifecycleEvent });
     }
-    store.mount.mounting(entering.map((e) => e.traitName));
-    for (const { traitName, lifecycleEvent } of entering) {
-      void dispatchAndSettle(traitName, lifecycleEvent, { ...options.initPayload ?? {} });
+    store.mount.mounting(entering.map((e) => e.trait));
+    if (entering.length > 0) {
+      void mountAndSettle(entering, { ...options.initPayload ?? {} }).catch((err) => {
+        stateLog.warn("mount:failed", { traits: entering.map((e) => e.trait), error: String(err) });
+      });
     }
     mountedRef.current = mount;
-  }, [traitBindings, store, dispatchAndSettle, mountKey]);
+  }, [traitBindings, store, mountAndSettle, mountKey]);
   useSyncExternalStore(store.subscribe, store.getVersion, store.getVersion);
   const traitStates = useMemo(() => store.manager.getAllStates(), [store, store.getVersion()]);
-  return { traitStates, sendEvent, getTraitState, canHandleEvent, entityBindingSource };
+  return { traitStates, sendEvent, getTraitState, canHandleEvent, entityBindingSource, awaitingSkeletonSource };
 }
 
 // runtime/fitContent.ts
@@ -1405,7 +1464,7 @@ function TraitInitializer({ traits, routeParams, mountKey, orbitals, onNavigate,
     }, localFallbackTimeoutMs ?? 5e3);
     return () => clearTimeout(timer);
   }, [hasBridge, bridge.connected, onLocalFallback, localFallbackTimeoutMs]);
-  const { entityBindingSource } = useTraitStateMachine(traits, uiSlots, {
+  const { entityBindingSource, awaitingSkeletonSource } = useTraitStateMachine(traits, uiSlots, {
     orbitals,
     ...onNavigate !== void 0 ? { navigate: onNavigate } : {},
     ...onNavigateBack !== void 0 ? { navigateBack: onNavigateBack } : {},
@@ -1416,7 +1475,7 @@ function TraitInitializer({ traits, routeParams, mountKey, orbitals, onNavigate,
     ...mountKey !== void 0 ? { mountKey } : {},
     ...hasBridge ? { transport: bridge.transport, carriesCircuitState: bridge.carriesCircuitState, awaitTopology: !bridge.topologyKnown } : { persistence }
   });
-  return /* @__PURE__ */ jsx(EntityBindingContext.Provider, { value: entityBindingSource, children });
+  return /* @__PURE__ */ jsx(EntityBindingContext.Provider, { value: entityBindingSource, children: /* @__PURE__ */ jsx(AwaitingSkeletonContext.Provider, { value: awaitingSkeletonSource, children }) });
 }
 var CONTENT_STAGE_WIDTH = 480;
 function FitToBox({ children, mode = "box" }) {

package/dist/{chunk-MSBMVG3B.js → chunk-6O37FCX4.js}

@@ -267,6 +267,7 @@ function emitMotion(m, vars) {
   if (m.entry?.default !== void 0) vars["--motion-enter-default"] = enterKeyframe(m.entry.default);
   if (m.entry?.stagger !== void 0) vars["--motion-enter-stagger"] = m.entry.stagger;
   if (m.busyDelay !== void 0) vars["--motion-busy-delay"] = m.busyDelay;
+  if (m.awaitingSkeleton !== void 0) vars["--awaiting-skeleton-display"] = m.awaitingSkeleton ? "block" : "none";
 }
 function enterKeyframe(enter) {
   return enter === "none" ? "none" : `almadar-enter-${enter}`;

package/dist/{chunk-WB2A6V3I.js → chunk-7KSLPY56.js}

@@ -115,6 +115,7 @@ var en_default = {
   "aria.removeFilter": "Remove filter",
   "aria.closeDrawer": "Close drawer",
   "aria.closePanel": "Close panel",
+  "aria.dockPanel": "Side panel",
   "aria.previousImage": "Previous image",
   "aria.nextImage": "Next image",
   "aria.dismiss": "Dismiss",
@@ -136,6 +137,7 @@ var en_default = {
   "aria.openMenu": "Open menu",
   "aria.closeMenu": "Close menu",
   "aria.openSidebar": "Open sidebar",
+  "aria.openRow": "Open item {{position}}",
   "sidebar.expand": "Expand sidebar",
   "sidebar.collapse": "Collapse sidebar",
   "sidebar.close": "Close sidebar",
@@ -1181,7 +1183,53 @@ var en_default = {
   "aria.walkTraitDone": "completed",
   "aria.walkTraitPending": "pending",
   "aria.walkGraph": "State graph for {{trait}}: {{from}} to {{to}}",
-  "aria.loading": "Loading"
+  "aria.loading": "Loading",
+  "agentActivity.toolCall": "Called {{tool}}",
+  "agentActivity.toolResult": "{{tool}} returned",
+  "agentActivity.toolRows": "{{count}} rows",
+  "agentActivity.thinking": "Thinking\u2026",
+  "agentActivity.analyzed": "Analyzed your request \u2014 {{organism}}",
+  "agentActivity.renamed": "Rename {{from}} \u2192 {{to}}",
+  "agentActivity.deleted": "Remove {{orbitalName}}",
+  "agentActivity.roster": "Planning {{count}} orbitals",
+  "agentActivity.orbitalStarted": "Working on {{orbitalName}}\u2026",
+  "agentActivity.orbitalStartedSettled": "Started {{orbitalName}}",
+  "agentActivity.orbitalDone": "{{orbitalName}} ready",
+  "agentActivity.orbitalCounts": "{{traitCount}} traits, {{transitionCount}} transitions",
+  "agentActivity.change.orbital-added": "Added {{orbitalName}}",
+  "agentActivity.change.orbital-removed": "Removed {{orbitalName}}",
+  "agentActivity.change.entity-fields-changed": "Changed the data fields of {{orbitalName}}",
+  "agentActivity.change.trait-added": "Added a behavior to {{orbitalName}}",
+  "agentActivity.change.trait-removed": "Removed a behavior from {{orbitalName}}",
+  "agentActivity.change.state-machine-changed": "Changed the flow of {{orbitalName}}",
+  "agentActivity.change.guard-changed": "Changed a rule in {{orbitalName}}",
+  "agentActivity.change.effect-changed": "Changed what {{orbitalName}} does",
+  "agentActivity.change.render-ui-changed": "Changed the design of {{orbitalName}}",
+  "agentActivity.change.event-wiring-changed": "Changed the connections of {{orbitalName}}",
+  "agentActivity.change.page-changed": "Changed the pages of {{orbitalName}}",
+  "agentActivity.change.behavior-composed": "Composed a behavior into {{orbitalName}}",
+  "agentActivity.done": "Done \u2014 {{count}} orbitals ready",
+  "agentActivity.cancelled": "Cancelled",
+  "agentActivity.jump": "Show",
+  "agentActivity.emptyTitle": "No activity yet",
+  "agentActivity.emptyDescription": "Send a message and the agent's work shows up here.",
+  "agentActivity.fileOperation": "{{operation}}",
+  "agentActivity.schemaDiff": "Edited {{filePath}}",
+  "agentActivity.coordinatorDecision": "Chose {{organism}}",
+  "agentActivity.change.trait-config-changed": "Changed the settings of {{orbitalName}}",
+  "agentActivity.change.theme-changed": "Changed the theme of {{orbitalName}}",
+  "agentActivity.llmResponse": "Raw LLM response",
+  "agentActivity.llmDuration": "{{seconds}}s",
+  "agentActivity.llmTokens": "{{prompt}} in / {{completion}} out tokens",
+  "agentActivity.llmResponseLabel": "Response",
+  "agentActivity.llmSystemPrompt": "System prompt",
+  "agentActivity.llmUserPrompt": "User prompt",
+  "agentActivity.llmToolCalls": "Tool calls",
+  "agentActivity.showRawLlm": "Raw LLM",
+  "agentActivity.earlierConversations": "Earlier conversations ({{count}})",
+  "agentActivity.earlierActivity": "Earlier activity",
+  "tabs.scrollStart": "Scroll tabs back",
+  "tabs.scrollEnd": "Scroll tabs forward"
 };
 
 export { en_default };