@almadar/ui 6.22.0 → 6.24.0

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

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     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>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

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

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     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>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/avl/index.cjs

@@ -37340,13 +37340,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect71, useRef: useRef70, useCallback: useCallback101, useState: useState109 } = React96__namespace.default;
+      const { useEffect: useEffect72, useRef: useRef71, useCallback: useCallback102, useState: useState110 } = React96__namespace.default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef70({ centerLat, centerLng, zoom });
-        useEffect71(() => {
+        const prevRef = useRef71({ centerLat, centerLng, zoom });
+        useEffect72(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -37357,7 +37357,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect71(() => {
+        useEffect72(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -37385,8 +37385,8 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState109(null);
-        const handleMapClick = useCallback101((lat, lng) => {
+        const [clickedPosition, setClickedPosition] = useState110(null);
+        const handleMapClick = useCallback102((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -37395,7 +37395,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback101((marker) => {
+        const handleMarkerClick = useCallback102((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -51711,7 +51711,7 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = hooks.useTranslate();
-  const [log12, setLog] = React96__namespace.useState([]);
+  const [log13, setLog] = React96__namespace.useState([]);
   const prevStatesRef = React96__namespace.useRef(/* @__PURE__ */ new Map());
   React96__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -51775,9 +51775,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-muted-foreground mb-1", children: t("debug.otherEvents") }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log12.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    log13.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-muted-foreground mb-1", children: t("debug.recentTransitions") }),
-      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log12.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log13.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-primary", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground", children: entry.from }),
@@ -59072,7 +59072,25 @@ function convertFnFormLambdasInProps(props) {
 
 // hooks/index.ts
 init_useEventBus();
-var log8 = logger.createLogger("almadar:ui:shared-entity-store");
+logger.createLogger("almadar:ui:ui-slots");
+var ALL_SLOTS2 = core.UI_SLOTS.filter(
+  (slot) => !slot.includes(".") && slot !== "hud" && slot !== "screen"
+);
+ALL_SLOTS2.reduce(
+  (acc, slot) => {
+    acc[slot] = null;
+    return acc;
+  },
+  {}
+);
+ALL_SLOTS2.reduce(
+  (acc, slot) => {
+    acc[slot] = {};
+    return acc;
+  },
+  {}
+);
+var log9 = logger.createLogger("almadar:ui:shared-entity-store");
 var EMPTY_ENTITY_STATE = {};
 function createSharedEntityStore() {
   const states = /* @__PURE__ */ new Map();
@@ -59102,7 +59120,7 @@ function createSharedEntityStore() {
       try {
         callback();
       } catch (error) {
-        log8.error("Shared entity subscriber error", {
+        log9.error("Shared entity subscriber error", {
           entityId,
           error: error instanceof Error ? error : String(error)
         });
@@ -59133,7 +59151,7 @@ function runTickFrame(entityId, orderedWriters, store) {
   store.commit(entityId, scratch);
   return scratch;
 }
-var log9 = logger.createLogger("almadar:ui:effects:client-handlers");
+var log10 = logger.createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, navigateBack, callService, liveEntity, persistDelegated, callServiceDelegated } = options;
   return {
@@ -59142,7 +59160,7 @@ function createClientEffectHandlers(options) {
       eventBus.emit(prefixedEvent, payload, source);
     },
     persist: async () => {
-      log9.debug("persist is server-side only, ignored on client");
+      log10.debug("persist is server-side only, ignored on client");
     },
     // Bridge mode: the server runs every persist and the response
     // carries its outcome — tell the executor so the placeholder above is
@@ -59152,7 +59170,7 @@ function createClientEffectHandlers(options) {
     // @almadar/runtime EffectHandlers.set types value:unknown — should be FieldValue (upstream fix queued)
     set: ((_entityId, field, value) => {
       if (!liveEntity) {
-        log9.warn("set is server-side only, ignored on client (no live entity)");
+        log10.warn("set is server-side only, ignored on client (no live entity)");
         return;
       }
       liveEntity[field] = value;
@@ -59188,10 +59206,10 @@ function createClientEffectHandlers(options) {
         window.location.href = path;
         return;
       }
-      log9.warn("No navigate handler, ignoring", { path });
+      log10.warn("No navigate handler, ignoring", { path });
     }),
     navigateBack: navigateBack ?? (() => {
-      log9.warn("No navigate-back handler, ignoring");
+      log10.warn("No navigate-back handler, ignoring");
     })
   };
 }
@@ -59273,6 +59291,13 @@ function effectsCallOp(effects, ops) {
   }
   return false;
 }
+function diffDroppedTraitNames(prev, next) {
+  const dropped = [];
+  for (const name of prev) {
+    if (!next.has(name)) dropped.push(name);
+  }
+  return dropped;
+}
 function classifySharedTick(tick) {
   const writes = effectsCallOp(tick.effects, SHARED_ENTITY_WRITE_OPS);
   const renders = effectsCallOp(tick.effects, SHARED_ENTITY_RENDER_OPS);
@@ -59475,6 +59500,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   const uiSlotsRef = React96.useRef(uiSlots);
   const embeddedTraitsRef = React96.useRef(options?.embeddedTraits);
   const optionsRef = React96.useRef(options);
+  const prevActiveTraitNamesRef = React96.useRef(/* @__PURE__ */ new Set());
   React96.useEffect(() => {
     traitBindingsRef.current = traitBindings;
   }, [traitBindings]);
@@ -59603,6 +59629,18 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     };
   }, [traitBindings]);
   React96.useEffect(() => {
+    const nextActiveTraitNames = new Set(
+      traitBindings.map((b) => b.trait.name).filter((n) => !!n)
+    );
+    const dropped = diffDroppedTraitNames(prevActiveTraitNamesRef.current, nextActiveTraitNames);
+    if (dropped.length > 0) {
+      for (const traitName of dropped) {
+        for (const slot of ALL_SLOTS2) {
+          uiSlotsRef.current.clearBySource(slot, traitName);
+        }
+      }
+    }
+    prevActiveTraitNamesRef.current = nextActiveTraitNames;
     const newManager = managerRef.current;
     newManager.resetAll();
     setTraitStates(newManager.getAllStates());
@@ -59650,7 +59688,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     };
   }, [traitBindings]);
   const executeTransitionEffects = React96.useCallback(async (params) => {
-    const { binding, previousState, newState, payload, flushEvent, syncOnly, log: log12, callsitePayload } = params;
+    const { binding, previousState, newState, payload, flushEvent, syncOnly, log: log13, callsitePayload } = params;
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
@@ -59787,7 +59825,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         if (sharedKey !== void 0) {
           sharedWrites.push({ field, value });
         }
-        log12.debug("set:write", {
+        log13.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
@@ -59859,7 +59897,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           core.mergeEntityFrame(sharedEntityStore.getSnapshot(sharedKey), sharedWrites)
         );
       }
-      log12.debug("effects:executed", () => ({
+      log13.debug("effects:executed", () => ({
         traitName,
         transition: `${previousState}->${newState}`,
         event: flushEvent,
@@ -59869,7 +59907,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         slotsTouched: Array.from(pendingSlots.keys()).join(",")
       }));
       for (const [slot, patterns] of pendingSlots) {
-        log12.debug("flush:slot", {
+        log13.debug("flush:slot", {
           traitName,
           slot,
           patternCount: patterns.length,
@@ -59887,7 +59925,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         publishBindingSnapshot(traitName, liveEntity);
       }
     } catch (error) {
-      log12.error("effects:error", {
+      log13.error("effects:error", {
         traitName,
         transition: `${previousState}->${newState}`,
         event: flushEvent,
@@ -59897,7 +59935,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     }
     return { emitted: emittedDuringExec, serverEffectResults };
   }, [eventBus, flushSlot, sharedEntityStore, publishBindingSnapshot, orbitalsByTrait, viewer]);
-  const reRenderCallsiteCaptureChildren = React96.useCallback(async (traitName, callsitePayload, entityByTrait, log12, visited = /* @__PURE__ */ new Set()) => {
+  const reRenderCallsiteCaptureChildren = React96.useCallback(async (traitName, callsitePayload, entityByTrait, log13, visited = /* @__PURE__ */ new Set()) => {
     const children = callsiteCaptureChildrenByTrait?.get(traitName);
     if (!children || children.size === 0) return;
     const mgr = managerRef.current;
@@ -59911,7 +59949,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       if (lifecycleEvent === void 0) continue;
       const [entry] = mgr.sendEvent(lifecycleEvent, {}, void 0, entityByTrait, void 0, childName);
       if (!entry || !entry.result.executed) continue;
-      log12.debug("callsite-capture-child:rerender", {
+      log13.debug("callsite-capture-child:rerender", {
         referrer: traitName,
         child: childName,
         lifecycleEvent,
@@ -59925,10 +59963,10 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         payload: {},
         flushEvent: lifecycleEvent,
         syncOnly: false,
-        log: log12,
+        log: log13,
         callsitePayload
       });
-      await reRenderCallsiteCaptureChildren(childName, callsitePayload, entityByTrait, log12, visited);
+      await reRenderCallsiteCaptureChildren(childName, callsitePayload, entityByTrait, log13, visited);
     }
   }, [callsiteCaptureChildrenByTrait, executeTransitionEffects]);
   const runTickEffects = React96.useCallback((tick, binding) => {
@@ -61152,7 +61190,7 @@ init_useEventBus();
 // components/avl/hooks/useCanvasDnd.tsx
 init_useEventBus();
 init_useAlmadarDndCollision();
-var log10 = logger.createLogger("almadar:ui:canvas-dnd");
+var log11 = logger.createLogger("almadar:ui:canvas-dnd");
 function useCanvasDraggable({
   id,
   payload,
@@ -61190,7 +61228,7 @@ function defaultEmit(eventBus, drop) {
   if (payload.kind === "pattern") {
     const patternType = payload.data["type"];
     if (typeof patternType !== "string") {
-      log10.warn("default-emit:pattern:missing-type");
+      log11.warn("default-emit:pattern:missing-type");
       return;
     }
     const out = { patternType, containerNode: target.containerNode };
@@ -61199,26 +61237,26 @@ function defaultEmit(eventBus, drop) {
       out.index = resolved.index;
     }
     eventBus.emit("UI:PATTERN_DROP", out);
-    log10.info("default-emit:pattern", { patternType, level: target.level });
+    log11.info("default-emit:pattern", { patternType, level: target.level });
     return;
   }
   if (payload.kind === "behavior") {
     const behaviorName = payload.data["name"];
     if (typeof behaviorName !== "string") {
-      log10.warn("default-emit:behavior:missing-name");
+      log11.warn("default-emit:behavior:missing-name");
       return;
     }
     eventBus.emit("UI:BEHAVIOR_DROP", {
       behaviorName,
       containerNode: target.containerNode
     });
-    log10.info("default-emit:behavior", { behaviorName, level: target.level });
+    log11.info("default-emit:behavior", { behaviorName, level: target.level });
     return;
   }
   if (payload.kind === "pattern-instance") {
     const fromPath = payload.data["fromPath"];
     if (typeof fromPath !== "string") {
-      log10.warn("default-emit:pattern-instance:missing-fromPath");
+      log11.warn("default-emit:pattern-instance:missing-fromPath");
       return;
     }
     const out = { fromPath, loc: payload.data["loc"] };
@@ -61227,10 +61265,10 @@ function defaultEmit(eventBus, drop) {
       out.toIndex = resolved.index;
     }
     eventBus.emit("UI:PATTERN_MOVE", out);
-    log10.info("default-emit:pattern-instance", { fromPath, level: target.level });
+    log11.info("default-emit:pattern-instance", { fromPath, level: target.level });
     return;
   }
-  log10.debug("default-emit:unhandled-kind", { kind: payload.kind });
+  log11.debug("default-emit:unhandled-kind", { kind: payload.kind });
 }
 function CanvasDndProvider({
   children,
@@ -61253,9 +61291,9 @@ function CanvasDndProvider({
     if (payload) {
       setActivePayload(payload);
       eventBus.emit("UI:DRAG_START", { kind: payload.kind, data: payload.data });
-      log10.info("dragStart", { id: e.active.id, kind: payload.kind });
+      log11.info("dragStart", { id: e.active.id, kind: payload.kind });
     } else {
-      log10.warn("dragStart:missing-payload", { id: e.active.id });
+      log11.warn("dragStart:missing-payload", { id: e.active.id });
     }
   }, [eventBus, trackPointer]);
   const handleDragEnd = React96__namespace.default.useCallback((e) => {
@@ -61266,7 +61304,7 @@ function CanvasDndProvider({
     const overData = e.over?.data.current;
     const target = overData?.target;
     const accepts = overData?.accepts;
-    log10.info("dragEnd", {
+    log11.info("dragEnd", {
       activeId: e.active.id,
       overId: e.over?.id,
       hasPayload: !!payload,
@@ -61278,12 +61316,12 @@ function CanvasDndProvider({
     }
     if (!payload || !target) return;
     if (accepts && !accepts.includes(payload.kind)) {
-      log10.debug("dragEnd:rejected:kind", { kind: payload.kind, accepts: [...accepts] });
+      log11.debug("dragEnd:rejected:kind", { kind: payload.kind, accepts: [...accepts] });
       return;
     }
     const cursor = lastPointerRef.current;
     const resolved = target.resolvePath && cursor ? target.resolvePath(cursor) : null;
-    log10.debug("dragEnd:resolve", {
+    log11.debug("dragEnd:resolve", {
       hasResolver: !!target.resolvePath,
       cursorX: cursor?.x,
       cursorY: cursor?.y,
@@ -61297,7 +61335,7 @@ function CanvasDndProvider({
   const handleDragCancel = React96__namespace.default.useCallback(() => {
     setActivePayload(null);
     document.removeEventListener("pointermove", trackPointer);
-    log10.info("dragCancel");
+    log11.info("dragCancel");
   }, [trackPointer]);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     core$1.DndContext,
@@ -63356,7 +63394,7 @@ init_AvlTransitionLane();
 init_AvlSwimLane();
 init_avl_atom_types();
 init_avl_elk_layout();
-var log11 = logger.createLogger("almadar:ui:avl:trait-scene");
+var log12 = logger.createLogger("almadar:ui:avl:trait-scene");
 var SWIM_GUTTER2 = 120;
 var CENTER_W2 = 360;
 var AvlTraitScene = ({
@@ -63369,7 +63407,7 @@ var AvlTraitScene = ({
   const dataKey = React96.useMemo(() => JSON.stringify(data), [data]);
   React96.useEffect(() => {
     computeTraitLayout(data).then(setLayout).catch((error) => {
-      log11.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
+      log12.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
     });
   }, [dataKey]);
   if (!layout) {