@almadar/ui 5.101.0 → 5.104.0

package/dist/avl/index.js

@@ -10,7 +10,7 @@ import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X, Code, FileText, WrapText, Check, Copy, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, RotateCcw, Play, Terminal, XCircle, AlertTriangle, Trash2, Link2, ZoomOut, ZoomIn, Download, ChevronDown, Menu as Menu$1, Package, Calendar, MoreHorizontal, Image as Image$1, Upload, ArrowLeft, HelpCircle, PauseCircle, Search, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, Minus, Eraser, TrendingUp, TrendingDown, AlertCircle, Circle, Clock, CheckCircle2, Bug, Send, ChevronUp, Wrench, Tag, User, DollarSign } from 'lucide-react';
 import { createPortal } from 'react-dom';
 import { UISlotProvider, useUISlots, useTheme } from '@almadar/ui/context';
-import { evaluateGuard, evaluate, createMinimalContext } from '@almadar/evaluator';
+import { evaluateGuard, createMinimalContext, executeEffects, evaluate } from '@almadar/evaluator';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
 import dark from 'react-syntax-highlighter/dist/esm/styles/prism/vsc-dark-plus.js';
@@ -35,7 +35,7 @@ import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
 import remarkMath from 'remark-math';
 import rehypeKatex from 'rehype-katex';
-import { FieldTypeSchema, isInlineTrait, isPageReference, isEntityCall, schemaToIR, getPage, isCircuitEvent } from '@almadar/core';
+import { FieldTypeSchema, isInlineTrait, isPageReference, isEntityCall, schemaToIR, getPage, isCircuitEvent, walkSExpr, mergeEntityFrame } from '@almadar/core';
 import { useDroppable, useDraggable, DndContext, DragOverlay, useSensors, useSensor, PointerSensor, KeyboardSensor, pointerWithin, rectIntersection, closestCorners } from '@dnd-kit/core';
 import { sortableKeyboardCoordinates, useSortable, arrayMove, SortableContext, rectSortingStrategy, verticalListSortingStrategy } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
@@ -584,7 +584,7 @@ var init_AvlFieldType = __esm({
   }
 });
 
-// node_modules/clsx/dist/clsx.mjs
+// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -599,11 +599,11 @@ function clsx() {
   return n;
 }
 var init_clsx = __esm({
-  "node_modules/clsx/dist/clsx.mjs"() {
+  "node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs"() {
   }
 });
 
-// node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
 function twJoin() {
   let index = 0;
   let argument;
@@ -647,7 +647,7 @@ function createTailwindMerge(createConfigFirst, ...createConfigRest) {
 }
 var CLASS_PART_SEPARATOR, createClassGroupUtils, getGroupRecursive, arbitraryPropertyRegex, getGroupIdForArbitraryProperty, createClassMap, processClassesRecursively, getPart, isThemeGetter, getPrefixedClassGroupEntries, createLruCache, IMPORTANT_MODIFIER, createParseClassName, sortModifiers, createConfigUtils, SPLIT_CLASSES_REGEX, mergeClassList, toValue, fromTheme, arbitraryValueRegex, fractionRegex, stringLengths, tshirtUnitRegex, lengthUnitRegex, colorFunctionRegex, shadowRegex, imageRegex, isLength, isArbitraryLength, isNumber, isArbitraryNumber, isInteger, isPercent, isArbitraryValue, isTshirtSize, sizeLabels, isArbitrarySize, isArbitraryPosition, imageLabels, isArbitraryImage, isArbitraryShadow, isAny, getIsArbitraryValue, isLengthOnly, isNever, isShadow, isImage, getDefaultConfig, twMerge;
 var init_bundle_mjs = __esm({
-  "node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
+  "node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs"() {
     CLASS_PART_SEPARATOR = "-";
     createClassGroupUtils = (config) => {
       const classMap = createClassMap(config);
@@ -13957,6 +13957,9 @@ var init_useUnitSpriteAtlas = __esm({
     init_spriteAnimation();
   }
 });
+function normalizeBackdrop(bg) {
+  return typeof bg === "string" ? { url: bg, role: "decoration", category: "background" } : bg;
+}
 function SideView({
   player,
   platforms,
@@ -13966,7 +13969,7 @@ function SideView({
   canvasHeight,
   follow,
   bgColor,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   playerSprite,
   tileSprites,
   effects,
@@ -13974,6 +13977,7 @@ function SideView({
   keyUpMap,
   className
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
@@ -14265,7 +14269,7 @@ function Canvas2D({
   effects: _effectsPropRaw = [],
   platforms,
   player,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   // Interaction state
   selectedUnitId = null,
   validMoves = [],
@@ -14306,6 +14310,7 @@ function Canvas2D({
   // Remote asset loading
   assetManifest
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const isSide = projection === "side";
   const isFree = projection === "free";
   const flatLike = projection === "hex" || projection === "flat" || isFree;
@@ -20289,9 +20294,9 @@ var init_BiologyCanvas = __esm({
   }
 });
 
-// node_modules/katex/dist/katex.min.css
+// node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/katex/dist/katex.min.css"() {
+  "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
   }
 });
 var Tabs;
@@ -32497,8 +32502,9 @@ var init_LineChart = __esm({
       const safeData = data ?? [];
       const sortedData = useMemo(() => {
         if (safeData.length === 0) return [];
+        if (!safeData.some((d) => d.date != null)) return [...safeData];
         return [...safeData].sort(
-          (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
+          (a, b) => new Date(a.date ?? 0).getTime() - new Date(b.date ?? 0).getTime()
         );
       }, [safeData]);
       const points = useMemo(() => {
@@ -33249,12 +33255,12 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect71, useRef: useRef67, useCallback: useCallback104, useState: useState105 } = React105__default;
+      const { useEffect: useEffect71, useRef: useRef68, useCallback: useCallback104, useState: useState105 } = React105__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 = useRef67({ centerLat, centerLng, zoom });
+        const prevRef = useRef68({ centerLat, centerLng, zoom });
         useEffect71(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
@@ -46245,7 +46251,7 @@ function getAllEvents(traits2) {
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
-  const [log11, setLog] = React105.useState([]);
+  const [log12, setLog] = React105.useState([]);
   const prevStatesRef = React105.useRef(/* @__PURE__ */ new Map());
   React105.useEffect(() => {
     for (const trait of traits2) {
@@ -46309,9 +46315,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.otherEvents") }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log11.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log12.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: t("debug.recentTransitions") }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log11.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log12.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -53596,7 +53602,67 @@ function convertFnFormLambdasInProps(props) {
 
 // hooks/index.ts
 init_useEventBus();
-var log7 = createLogger("almadar:ui:effects:client-handlers");
+var log7 = createLogger("almadar:ui:shared-entity-store");
+var EMPTY_ENTITY_STATE = {};
+function createSharedEntityStore() {
+  const states = /* @__PURE__ */ new Map();
+  const subscribers2 = /* @__PURE__ */ new Map();
+  const getSnapshot2 = (entityId) => states.get(entityId) ?? EMPTY_ENTITY_STATE;
+  const subscribe = (entityId, callback) => {
+    let set = subscribers2.get(entityId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      subscribers2.set(entityId, set);
+    }
+    set.add(callback);
+    return () => {
+      const current = subscribers2.get(entityId);
+      if (!current) return;
+      current.delete(callback);
+      if (current.size === 0) {
+        subscribers2.delete(entityId);
+      }
+    };
+  };
+  const commit = (entityId, nextState) => {
+    states.set(entityId, nextState);
+    const set = subscribers2.get(entityId);
+    if (!set) return;
+    set.forEach((callback) => {
+      try {
+        callback();
+      } catch (error) {
+        log7.error("Shared entity subscriber error", {
+          entityId,
+          error: error instanceof Error ? error : String(error)
+        });
+      }
+    });
+  };
+  const seed = (entityId, initialState) => {
+    if (!states.has(entityId)) {
+      states.set(entityId, initialState);
+    }
+  };
+  return { getSnapshot: getSnapshot2, subscribe, commit, seed };
+}
+function useSharedEntityStore() {
+  const storeRef = useRef(null);
+  if (storeRef.current === null) {
+    storeRef.current = createSharedEntityStore();
+  }
+  return storeRef.current;
+}
+function runTickFrame(entityId, orderedWriters, store) {
+  let scratch = store.getSnapshot(entityId);
+  for (const writer of orderedWriters) {
+    const writes = writer(scratch);
+    scratch = mergeEntityFrame(scratch, writes);
+  }
+  store.commit(entityId, scratch);
+  return scratch;
+}
+var log8 = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
   return {
@@ -53605,12 +53671,12 @@ function createClientEffectHandlers(options) {
       eventBus.emit(prefixedEvent, payload);
     },
     persist: async () => {
-      log7.warn("persist is server-side only, ignored on client");
+      log8.warn("persist is server-side only, ignored on client");
     },
     // @almadar/runtime EffectHandlers.set types value:unknown — should be FieldValue (upstream fix queued)
     set: ((_entityId, field, value) => {
       if (!liveEntity) {
-        log7.warn("set is server-side only, ignored on client (no live entity)");
+        log8.warn("set is server-side only, ignored on client (no live entity)");
         return;
       }
       liveEntity[field] = value;
@@ -53642,10 +53708,10 @@ function createClientEffectHandlers(options) {
       slotSetter.addPattern(slot, pattern, props);
     },
     navigate: navigate ?? ((path) => {
-      log7.warn("No navigate handler, ignoring", { path });
+      log8.warn("No navigate handler, ignoring", { path });
     }),
     notify: notify ?? ((msg, type) => {
-      log7.debug("notify", { type, message: msg });
+      log8.debug("notify", { type, message: msg });
     })
   };
 }
@@ -53690,11 +53756,101 @@ function toTraitDefinition(binding) {
 function normalizeEventKey(eventKey) {
   return eventKey.startsWith("UI:") ? eventKey.slice(3) : eventKey;
 }
+var SHARED_ENTITY_WRITE_OPS = /* @__PURE__ */ new Set(["set"]);
+var SHARED_ENTITY_RENDER_OPS = /* @__PURE__ */ new Set(["render-ui", "render"]);
+function collectAllTraitEffects(trait) {
+  return [
+    ...trait.ticks.flatMap((t) => t.effects),
+    ...trait.transitions.flatMap((t) => t.effects)
+  ];
+}
+function effectsCallOp(effects, ops) {
+  for (const effect of effects) {
+    let found = false;
+    walkSExpr(effect, (node) => {
+      if (!found && Array.isArray(node) && typeof node[0] === "string" && ops.has(node[0])) {
+        found = true;
+      }
+    });
+    if (found) return true;
+  }
+  return false;
+}
+function createSharedEntityWriter(binding, tick, traitStatesRef, emit) {
+  return (scratch) => {
+    const traitName = binding.trait.name;
+    const currentState = traitStatesRef.current.get(traitName)?.currentState ?? "";
+    if (tick.appliesTo.length > 0 && !tick.appliesTo.includes(currentState)) return [];
+    const scratchEntity = { ...scratch };
+    const writes = [];
+    const ctx = createMinimalContext(scratchEntity, {}, currentState);
+    const declaredDefaults = collectDeclaredConfigDefaults(binding.trait);
+    const callSiteConfig = binding.config;
+    if (declaredDefaults || callSiteConfig) {
+      ctx.config = { ...declaredDefaults ?? {}, ...callSiteConfig ?? {} };
+    }
+    ctx.mutateEntity = (changes) => {
+      for (const [field, value] of Object.entries(changes)) {
+        const fieldValue = value;
+        scratchEntity[field] = fieldValue;
+        writes.push({ field, value: fieldValue });
+      }
+    };
+    ctx.emit = (event, payload) => {
+      emit(event, payload);
+    };
+    if (tick.guard !== void 0 && !evaluateGuard(tick.guard, ctx)) {
+      tickLog.debug("guard-blocked", { traitName, tick: tick.name, state: currentState });
+      return [];
+    }
+    executeEffects(tick.effects, ctx);
+    return writes;
+  };
+}
 function useTraitStateMachine(traitBindings, uiSlots, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
   const traitConfigsByName = options?.traitConfigsByName;
   const orbitalsByTrait = options?.orbitalsByTrait;
+  const sharedEntityStore = useSharedEntityStore();
+  const sharedGroups = useMemo(() => {
+    const groups = /* @__PURE__ */ new Map();
+    for (const binding of traitBindings) {
+      const linkedEntityName = binding.linkedEntity ?? binding.trait.linkedEntity;
+      if (!linkedEntityName) continue;
+      const entityDef = entities.get(linkedEntityName);
+      if (!entityDef?.shared) continue;
+      const orbitalName = orbitalsByTrait?.[binding.trait.name] ?? "";
+      const storeKey = `${orbitalName}::${linkedEntityName}`;
+      let group = groups.get(storeKey);
+      if (!group) {
+        let defaults;
+        for (const field of entityDef.fields) {
+          if (field.default !== void 0) {
+            (defaults ?? (defaults = {}))[field.name] = field.default;
+          }
+        }
+        group = { storeKey, entityName: linkedEntityName, writerBindings: [], renderBindings: [], defaults };
+        groups.set(storeKey, group);
+      }
+      const allEffects = collectAllTraitEffects(binding.trait);
+      if (effectsCallOp(allEffects, SHARED_ENTITY_WRITE_OPS)) group.writerBindings.push(binding);
+      if (effectsCallOp(allEffects, SHARED_ENTITY_RENDER_OPS)) group.renderBindings.push(binding);
+    }
+    return groups;
+  }, [traitBindings, entities, orbitalsByTrait]);
+  for (const group of sharedGroups.values()) {
+    if (group.defaults) sharedEntityStore.seed(group.storeKey, group.defaults);
+  }
+  const sharedKeyByTraitNameRef = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    const map = /* @__PURE__ */ new Map();
+    for (const group of sharedGroups.values()) {
+      for (const binding of group.writerBindings) map.set(binding.trait.name, group.storeKey);
+      for (const binding of group.renderBindings) map.set(binding.trait.name, group.storeKey);
+    }
+    sharedKeyByTraitNameRef.current = map;
+  }, [sharedGroups]);
   const manager = useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new StateMachineManager(traitDefs);
@@ -53877,14 +54033,21 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     };
   }, [traitBindings]);
   const executeTransitionEffects = useCallback(async (params) => {
-    const { binding, previousState, newState, payload, flushEvent, syncOnly, log: log11 } = params;
+    const { binding, previousState, newState, payload, flushEvent, syncOnly, log: log12 } = params;
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
-    let liveEntity = traitFieldStatesRef.current.get(traitName);
-    if (!liveEntity) {
-      liveEntity = {};
-      traitFieldStatesRef.current.set(traitName, liveEntity);
+    const sharedKey = sharedKeyByTraitNameRef.current.get(traitName);
+    let liveEntity;
+    if (sharedKey !== void 0) {
+      liveEntity = { ...sharedEntityStore.getSnapshot(sharedKey) };
+    } else {
+      let existing = traitFieldStatesRef.current.get(traitName);
+      if (!existing) {
+        existing = {};
+        traitFieldStatesRef.current.set(traitName, existing);
+      }
+      liveEntity = existing;
     }
     const effects = syncOnly ? params.effects.filter(
       (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
@@ -53966,7 +54129,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       ...handlers,
       set: async (targetId, field, value) => {
         if (baseSet) await baseSet(targetId, field, value);
-        log11.debug("set:write", {
+        log12.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
@@ -54006,17 +54169,20 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const executor = new EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
     try {
       await executor.executeAll(effects);
-      log11.debug("effects:executed", () => ({
+      if (sharedKey !== void 0) {
+        sharedEntityStore.commit(sharedKey, liveEntity);
+      }
+      log12.debug("effects:executed", () => ({
         traitName,
         transition: `${previousState}->${newState}`,
         event: flushEvent,
         effectCount: effects.length,
         emitted: emittedDuringExec.join(","),
-        entityAfter: JSON.stringify(traitFieldStatesRef.current.get(traitName) ?? {}),
+        entityAfter: JSON.stringify(liveEntity ?? {}),
         slotsTouched: Array.from(pendingSlots.keys()).join(",")
       }));
       for (const [slot, patterns] of pendingSlots) {
-        log11.debug("flush:slot", {
+        log12.debug("flush:slot", {
           traitName,
           slot,
           patternCount: patterns.length,
@@ -54031,7 +54197,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         });
       }
     } catch (error) {
-      log11.error("effects:error", {
+      log12.error("effects:error", {
         traitName,
         transition: `${previousState}->${newState}`,
         event: flushEvent,
@@ -54040,14 +54206,16 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       });
     }
     return emittedDuringExec;
-  }, [eventBus, flushSlot]);
+  }, [eventBus, flushSlot, sharedEntityStore]);
   const runTickEffects = useCallback((tick, binding) => {
     const traitName = binding.trait.name;
     const currentState = traitStatesRef.current.get(traitName)?.currentState ?? "";
     if (tick.appliesTo.length > 0 && !tick.appliesTo.includes(currentState)) return;
     if (tick.guard !== void 0) {
+      const sharedKey = sharedKeyByTraitNameRef.current.get(traitName);
+      const entity = sharedKey !== void 0 ? sharedEntityStore.getSnapshot(sharedKey) : traitFieldStatesRef.current.get(traitName) ?? {};
       const guardCtx = {
-        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        entity,
         payload: {},
         state: currentState
       };
@@ -54072,10 +54240,46 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       syncOnly: true,
       log: tickLog
     });
-  }, [executeTransitionEffects]);
+  }, [executeTransitionEffects, sharedEntityStore]);
+  const emitFromSharedWriter = useCallback((event, payload) => {
+    const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
+    eventBus.emit(prefixedEvent, payload);
+  }, [eventBus]);
   useEffect(() => {
     const scheduler = createTickScheduler();
+    const writerTraitNames = /* @__PURE__ */ new Set();
+    for (const group of sharedGroups.values()) {
+      const ticksByInterval = /* @__PURE__ */ new Map();
+      for (const binding of group.writerBindings) {
+        writerTraitNames.add(binding.trait.name);
+        for (const tick of binding.trait.ticks ?? []) {
+          const intervalKey = String(tick.interval);
+          const entries = ticksByInterval.get(intervalKey) ?? [];
+          entries.push({ binding, tick });
+          ticksByInterval.set(intervalKey, entries);
+        }
+      }
+      for (const entries of ticksByInterval.values()) {
+        const interval = entries[0].tick.interval;
+        const onDue = () => {
+          const writers = entries.map(
+            ({ binding, tick }) => createSharedEntityWriter(binding, tick, traitStatesRef, emitFromSharedWriter)
+          );
+          runTickFrame(group.storeKey, writers, sharedEntityStore);
+        };
+        if (interval === "frame") {
+          scheduler.add(0, onDue);
+        } else if (typeof interval === "number") {
+          scheduler.add(interval, onDue);
+        } else if (isValidCronExpression(interval)) {
+          scheduler.addCron(interval, onDue);
+        } else {
+          scheduler.add(parseDurationString(interval), onDue);
+        }
+      }
+    }
     for (const binding of traitBindings) {
+      if (writerTraitNames.has(binding.trait.name)) continue;
       for (const tick of binding.trait.ticks ?? []) {
         if (tick.interval === "frame") {
           scheduler.add(0, () => runTickEffects(tick, binding));
@@ -54089,7 +54293,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     }
     return () => scheduler.stopAll();
-  }, [traitBindings, runTickEffects]);
+  }, [traitBindings, runTickEffects, sharedGroups, sharedEntityStore, emitFromSharedWriter]);
   const processEventQueued = useCallback(async (eventKey, payload) => {
     const normalizedEvent = normalizeEventKey(eventKey);
     const bindings = traitBindingsRef.current;
@@ -54433,7 +54637,7 @@ function buildOrbitalsByTrait(schema, resolvedPages = []) {
 // runtime/OrbPreview.tsx
 init_verificationRegistry();
 var PERF_NAMESPACE = "almadar:perf:canvas";
-var log8 = createLogger(PERF_NAMESPACE);
+var log9 = createLogger(PERF_NAMESPACE);
 var RING_SIZE = 50;
 var ring = [];
 var writeIdx = 0;
@@ -54484,7 +54688,7 @@ function perfEnd(name, startToken, detail) {
     }
   }
   push({ name, durationMs, ts: endTs, detail });
-  log8.debug(name, () => ({ durationMs, ...detail ?? {} }));
+  log9.debug(name, () => ({ durationMs, ...detail ?? {} }));
 }
 var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
   if (!isEnabled()) return;
@@ -54494,7 +54698,7 @@ var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, com
     ts: commitTime,
     detail: { baseDuration }
   });
-  log8.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
+  log9.debug(`profiler:${id}:${phase}`, () => ({ actualDuration, baseDuration }));
 };
 
 // lib/prepareSchemaForPreview.ts
@@ -55136,7 +55340,7 @@ init_useEventBus();
 // components/avl/hooks/useCanvasDnd.tsx
 init_useEventBus();
 init_useAlmadarDndCollision();
-var log9 = createLogger("almadar:ui:canvas-dnd");
+var log10 = createLogger("almadar:ui:canvas-dnd");
 function useCanvasDraggable({
   id,
   payload,
@@ -55175,7 +55379,7 @@ function defaultEmit(eventBus, drop) {
   if (payload.kind === "pattern") {
     const patternType = payload.data["type"];
     if (typeof patternType !== "string") {
-      log9.warn("default-emit:pattern:missing-type");
+      log10.warn("default-emit:pattern:missing-type");
       return;
     }
     const out = { patternType, containerNode: target.containerNode };
@@ -55184,23 +55388,23 @@ function defaultEmit(eventBus, drop) {
       out.index = resolved.index;
     }
     eventBus.emit("UI:PATTERN_DROP", out);
-    log9.info("default-emit:pattern", { patternType, level: target.level });
+    log10.info("default-emit:pattern", { patternType, level: target.level });
     return;
   }
   if (payload.kind === "behavior") {
     const behaviorName = payload.data["name"];
     if (typeof behaviorName !== "string") {
-      log9.warn("default-emit:behavior:missing-name");
+      log10.warn("default-emit:behavior:missing-name");
       return;
     }
     eventBus.emit("UI:BEHAVIOR_DROP", {
       behaviorName,
       containerNode: target.containerNode
     });
-    log9.info("default-emit:behavior", { behaviorName, level: target.level });
+    log10.info("default-emit:behavior", { behaviorName, level: target.level });
     return;
   }
-  log9.debug("default-emit:unhandled-kind", { kind: payload.kind });
+  log10.debug("default-emit:unhandled-kind", { kind: payload.kind });
 }
 function CanvasDndProvider({
   children,
@@ -55216,9 +55420,9 @@ function CanvasDndProvider({
     if (payload) {
       setActivePayload(payload);
       eventBus.emit("UI:DRAG_START", { kind: payload.kind, data: payload.data });
-      log9.info("dragStart", { id: e.active.id, kind: payload.kind });
+      log10.info("dragStart", { id: e.active.id, kind: payload.kind });
     } else {
-      log9.warn("dragStart:missing-payload", { id: e.active.id });
+      log10.warn("dragStart:missing-payload", { id: e.active.id });
     }
   }, [eventBus]);
   const handleDragEnd = React105__default.useCallback((e) => {
@@ -55228,7 +55432,7 @@ function CanvasDndProvider({
     const overData = e.over?.data.current;
     const target = overData?.target;
     const accepts = overData?.accepts;
-    log9.info("dragEnd", {
+    log10.info("dragEnd", {
       activeId: e.active.id,
       overId: e.over?.id,
       hasPayload: !!payload,
@@ -55240,7 +55444,7 @@ function CanvasDndProvider({
     }
     if (!payload || !target) return;
     if (accepts && !accepts.includes(payload.kind)) {
-      log9.debug("dragEnd:rejected:kind", { kind: payload.kind, accepts: [...accepts] });
+      log10.debug("dragEnd:rejected:kind", { kind: payload.kind, accepts: [...accepts] });
       return;
     }
     const activator = e.activatorEvent;
@@ -55252,7 +55456,7 @@ function CanvasDndProvider({
   }, [eventBus, onDrop]);
   const handleDragCancel = React105__default.useCallback(() => {
     setActivePayload(null);
-    log9.info("dragCancel");
+    log10.info("dragCancel");
   }, []);
   return /* @__PURE__ */ jsxs(
     DndContext,
@@ -57085,7 +57289,7 @@ init_AvlTransitionLane();
 init_AvlSwimLane();
 init_avl_atom_types();
 init_avl_elk_layout();
-var log10 = createLogger("almadar:ui:avl:trait-scene");
+var log11 = createLogger("almadar:ui:avl:trait-scene");
 var SWIM_GUTTER2 = 120;
 var CENTER_W2 = 360;
 var AvlTraitScene = ({
@@ -57098,7 +57302,7 @@ var AvlTraitScene = ({
   const dataKey = useMemo(() => JSON.stringify(data), [data]);
   useEffect(() => {
     computeTraitLayout(data).then(setLayout).catch((error) => {
-      log10.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
+      log11.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
     });
   }, [dataKey]);
   if (!layout) {

package/dist/components/core/atoms/AtlasImage.d.ts

@@ -43,7 +43,7 @@ export interface AtlasPanelProps {
  * is cropped once to a dataURL; CSS border-image / background-repeat does the scaling. Falls back
  * to a plain container while the sheet/atlas load.
  */
-export declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function AtlasPanel({ asset, borderSlice, borderWidth, mode, className, style, children, 'aria-hidden': ariaHidden }: AtlasPanelProps): React.JSX.Element;
 export declare namespace AtlasPanel {
     var displayName: string;
 }
@@ -52,7 +52,7 @@ export declare namespace AtlasPanel {
  * sub-rect of the packed sheet into a canvas (never the whole sheet); otherwise it renders the
  * plain `<img>` path. `fill` + `fit` cover background/panel usage (GameShell, card frames).
  */
-export declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AtlasImage({ asset, size, width, height, fill, fit, alt, className, style, 'aria-hidden': ariaHidden, }: AtlasImageProps): React.JSX.Element | null;
 export declare namespace AtlasImage {
     var displayName: string;
 }

package/dist/components/core/atoms/FlipContainer.d.ts

@@ -16,6 +16,6 @@ export interface FlipContainerProps {
     onClick?: () => void;
 }
 export declare const FlipContainer: {
-    ({ flipped, className, children, onClick, }: FlipContainerProps): import("react/jsx-runtime").JSX.Element;
+    ({ flipped, className, children, onClick, }: FlipContainerProps): React.JSX.Element;
     displayName: string;
 };

package/dist/components/core/molecules/Card.d.ts

@@ -51,7 +51,7 @@ export interface CardProps {
 /**
  * Card component for displaying content in a contained box
  */
-export declare function Card({ title, subtitle, image, actions, children, onClick, className, action, longPressEvent, longPressPayload, }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare function Card({ title, subtitle, image, actions, children, onClick, className, action, longPressEvent, longPressPayload, }: CardProps): React.JSX.Element;
 export declare namespace Card {
     var displayName: string;
 }