@almadar/ui 5.157.0 → 5.159.0

package/dist/runtime/index.js

@@ -1,8 +1,10 @@
 import * as React85 from 'react';
-import React85__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useSyncExternalStore, useLayoutEffect, lazy, useId } from 'react';
+import React85__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, useSyncExternalStore, Suspense, useState, useLayoutEffect, lazy, useId } from 'react';
 import { EventBusContext, useTraitScopeChain, RenderSlotProvider, useEntitySchemaOptional, useEntityBindingSnapshot, useTraitScope, useEntitySchema, getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, TraitScopeProvider, useNavStack, ServerBridgeProvider, useCurrentPagePath, useRenderSlot, useGameAudioContextOptional, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge, EntityBindingContext } from '@almadar/ui/providers';
 export { EntitySchemaProvider, ServerBridgeProvider, TraitContext, TraitProvider, useEntitySchema, useEntitySchemaOptional, useServerBridge, useTrait, useTraitContext } from '@almadar/ui/providers';
 import { createLogger, setNamespaceLevel, isLogLevelEnabled } from '@almadar/logger';
+import { perfStore, pushPerfEntry, wrapCallbackForEvent, perfStart, perfEnd, perfGauge, prepareSchemaForPreview, perfTimeAsync, collectTraitRefsFromResolvedTrait, buildOrbitalsByTrait, collectEmbeddedTraits } from '@almadar/runtime/ui';
+export { PERF_NAMESPACE, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import { StateMachineManager, collectDeclaredConfigDefaults, resolveCallSitePayloadCaptures, createServerEffectHandlers, EffectExecutor, createContextFromBindings, createTickScheduler, isValidCronExpression, parseDurationString, InMemoryPersistence, normalizeCallSiteConfigToValues, interpolateValue } from '@almadar/runtime';
 import { mergeEntityFrame, isCircuitEvent, applyListenPayloadMapping, schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, walkSExpr, buildResolvedTraitConfigs, isRenderBindingMarker, isFileValue, isInlineTrait, containsEntityBinding, isSExpr, isEventPayloadValue, RENDER_BINDING_MARKER, ANIMATION_NAMES } from '@almadar/core';
 import { clsx } from 'clsx';
@@ -14,8 +16,6 @@ import { createPortal } from 'react-dom';
 import { useTranslate } from '@almadar/ui/hooks';
 import { useUISlots, UISlotProvider, useTheme } from '@almadar/ui/context';
 import { evaluateGuard, evaluateListenPayloadExpr, evaluate, createMinimalContext, executeEffects } from '@almadar/evaluator';
-import { wrapCallbackForEvent, prepareSchemaForPreview, perfStore, pushPerfEntry, collectTraitRefsFromResolvedTrait, buildOrbitalsByTrait, collectEmbeddedTraits } from '@almadar/runtime/ui';
-export { PERF_NAMESPACE, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
@@ -793,6 +793,22 @@ var init_useTapReveal = __esm({
   "hooks/useTapReveal.ts"() {
   }
 });
+function usePerfBuffer() {
+  return useSyncExternalStore(perfStore.subscribe, perfStore.getSnapshot, perfStore.getSnapshot);
+}
+var profilerOnRender;
+var init_perf = __esm({
+  "lib/perf.ts"() {
+    profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
+      pushPerfEntry({
+        name: `profiler:${id}:${phase}`,
+        durationMs: actualDuration,
+        ts: commitTime,
+        detail: { baseDuration }
+      });
+    };
+  }
+});
 function resolveMarkerExpression(expression, entity, config, state) {
   const ctx = createContextFromBindings({
     entity,
@@ -810,11 +826,54 @@ function isPlainObject(value) {
   if (typeof value === "function") return false;
   return true;
 }
+function isEvaluatorResolvedData(value) {
+  return evaluatorResolvedData.has(value);
+}
+function brandResolved(value) {
+  if (value !== null && typeof value === "object" && !React85__default.isValidElement(value) && !(value instanceof Date)) {
+    resolvedMarkerFree.add(value);
+  }
+}
+function subtreeHasMarker(value) {
+  if (resolvedMarkerFree.has(value)) return false;
+  const cached = markerPresenceCache.get(value);
+  if (cached !== void 0) return cached;
+  let found = false;
+  const children = Array.isArray(value) ? value : Object.values(value);
+  for (const child of children) {
+    if (isRenderBindingMarker(child)) {
+      found = true;
+      break;
+    }
+    if (Array.isArray(child) || isPlainObject(child)) {
+      if (subtreeHasMarker(child)) {
+        found = true;
+        break;
+      }
+    }
+  }
+  markerPresenceCache.set(value, found);
+  return found;
+}
 function walkValue(value, scopeTrait, entity, config, state) {
   if (isRenderBindingMarker(value)) {
-    return { resolved: resolveMarkerExpression(value.expression, entity, config, state), changed: true };
+    const cached = markerResolutionCache.get(value);
+    if (cached !== void 0 && cached.entity === entity && cached.config === config && cached.state === state) {
+      return { resolved: cached.resolved, changed: false };
+    }
+    const resolved = resolveMarkerExpression(value.expression, entity, config, state);
+    markerResolutionCache.set(value, { entity, config, state, resolved });
+    if (resolved !== null && typeof resolved === "object" && !React85__default.isValidElement(resolved) && !(resolved instanceof Date)) {
+      resolvedMarkerFree.add(resolved);
+      evaluatorResolvedData.add(resolved);
+    }
+    return { resolved, changed: true };
   }
   if (Array.isArray(value)) {
+    if (!subtreeHasMarker(value)) {
+      brandResolved(value);
+      return { resolved: value, changed: false };
+    }
     const out = [];
     let changed = false;
     for (const item of value) {
@@ -829,9 +888,14 @@ function walkValue(value, scopeTrait, entity, config, state) {
       out.push(resolved);
       if (itemChanged) changed = true;
     }
+    brandResolved(out);
     return changed ? { resolved: out, changed: true } : { resolved: value, changed: false };
   }
   if (isPlainObject(value)) {
+    if (!subtreeHasMarker(value)) {
+      brandResolved(value);
+      return { resolved: value, changed: false };
+    }
     const sourceTrait = value._sourceTrait;
     if (typeof sourceTrait === "string" && sourceTrait !== scopeTrait) {
       return { resolved: value, changed: false };
@@ -843,11 +907,13 @@ function walkValue(value, scopeTrait, entity, config, state) {
       out[key] = resolved;
       if (itemChanged) changed = true;
     }
+    brandResolved(out);
     return changed ? { resolved: out, changed: true } : { resolved: value, changed: false };
   }
   return { resolved: value, changed: false };
 }
 function resolveRenderBindingMarkers(props, scopeTrait, entity, config, state) {
+  if (resolvedMarkerFree.has(props)) return props;
   const out = {};
   let changed = false;
   for (const [key, value] of Object.entries(props)) {
@@ -855,11 +921,17 @@ function resolveRenderBindingMarkers(props, scopeTrait, entity, config, state) {
     out[key] = resolved;
     if (propChanged) changed = true;
   }
+  brandResolved(out);
   return changed ? out : props;
 }
+var markerPresenceCache, markerResolutionCache, resolvedMarkerFree, evaluatorResolvedData;
 var init_resolve_render_bindings = __esm({
   "lib/resolve-render-bindings.ts"() {
     "use client";
+    markerPresenceCache = /* @__PURE__ */ new WeakMap();
+    markerResolutionCache = /* @__PURE__ */ new WeakMap();
+    resolvedMarkerFree = /* @__PURE__ */ new WeakSet();
+    evaluatorResolvedData = /* @__PURE__ */ new WeakSet();
   }
 });
 function cn(...inputs) {
@@ -12184,6 +12256,7 @@ var init_LearningCanvas = __esm({
   "components/learning/atoms/LearningCanvas.tsx"() {
     "use client";
     init_cn();
+    init_perf();
     init_useEventBus();
     DASH_PATTERNS = { dashed: [6, 4], dotted: [2, 3] };
     TRACE_SERIES_COLORS = ["#2563eb", "#dc2626", "#16a34a", "#f59e0b"];
@@ -12227,6 +12300,7 @@ var init_LearningCanvas = __esm({
         return [...shapes, ...traceOut, ...readoutOut];
       }, [shapes, traces, readouts, width, height]);
       const draw = useCallback(() => {
+        const _perfT = perfStart("learningcanvas:paint");
         const canvas = canvasRef.current;
         if (!canvas) return;
         const ctx = canvas.getContext("2d");
@@ -12248,6 +12322,7 @@ var init_LearningCanvas = __esm({
         for (const shape of derivedShapes) {
           if (shape.type === "text") drawShape(ctx, shape, width, height, derivedShapes);
         }
+        perfEnd("learningcanvas:paint", _perfT);
       }, [width, height, backgroundColor, derivedShapes]);
       useEffect(() => {
         draw();
@@ -26921,7 +26996,7 @@ function fileIcon(name) {
       return "file";
   }
 }
-var TreeNodeItem, FileTree;
+var TreeNodeItem, FlatTreeNodeItem, FileTree;
 var init_FileTree = __esm({
   "components/core/molecules/FileTree.tsx"() {
     "use client";
@@ -27006,14 +27081,101 @@ var init_FileTree = __esm({
         )) })
       ] });
     };
+    FlatTreeNodeItem = ({
+      item,
+      depth,
+      indent,
+      childrenByParent,
+      onNodeSelect,
+      defaultExpanded = false
+    }) => {
+      const [expanded, setExpanded] = useState(defaultExpanded || depth < 1);
+      const children = childrenByParent.get(item.id);
+      const hasChildren = !!children && children.length > 0;
+      const handleClick = useCallback(() => {
+        if (hasChildren) setExpanded((prev) => !prev);
+        onNodeSelect?.(item.id);
+      }, [hasChildren, item.id, onNodeSelect]);
+      return /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsxs(
+          Box,
+          {
+            className: "flex items-center gap-1.5 py-0.5 px-2 cursor-pointer rounded-sm transition-colors hover:bg-muted",
+            style: { paddingLeft: depth * indent + 8 },
+            onClick: handleClick,
+            role: "treeitem",
+            "aria-expanded": hasChildren ? expanded : void 0,
+            children: [
+              hasChildren ? /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  name: expanded ? "chevron-down" : "chevron-right",
+                  size: "xs",
+                  className: "text-[var(--color-muted-foreground)] flex-shrink-0"
+                }
+              ) : /* @__PURE__ */ jsx(Box, { style: { width: 12, flexShrink: 0 } }),
+              /* @__PURE__ */ jsx(
+                Icon,
+                {
+                  name: item.icon ?? (hasChildren ? expanded ? "folder-open" : "folder" : "file"),
+                  size: "xs",
+                  className: hasChildren ? "text-[var(--color-warning)]" : "text-[var(--color-muted-foreground)]"
+                }
+              ),
+              /* @__PURE__ */ jsx(Typography, { variant: "caption", className: "truncate font-mono text-xs", children: item.label })
+            ]
+          }
+        ),
+        hasChildren && expanded && /* @__PURE__ */ jsx(Box, { role: "group", children: children.map((child) => /* @__PURE__ */ jsx(
+          FlatTreeNodeItem,
+          {
+            item: child,
+            depth: depth + 1,
+            indent,
+            childrenByParent,
+            onNodeSelect
+          },
+          child.id
+        )) })
+      ] });
+    };
     FileTree = ({
       tree,
+      items,
       selectedPath,
       onFileSelect,
+      onNodeSelect,
       className,
       indent = 16
     }) => {
-      if (tree.length === 0) return null;
+      if (items) {
+        if (items.length === 0) return null;
+        const ids = new Set(items.map((node) => node.id));
+        const childrenByParent = /* @__PURE__ */ new Map();
+        const roots = [];
+        for (const item of items) {
+          if (item.parentId && ids.has(item.parentId)) {
+            const siblings = childrenByParent.get(item.parentId);
+            if (siblings) siblings.push(item);
+            else childrenByParent.set(item.parentId, [item]);
+          } else {
+            roots.push(item);
+          }
+        }
+        return /* @__PURE__ */ jsx(Box, { className: `py-1 overflow-y-auto ${className ?? ""}`, role: "tree", children: roots.map((item) => /* @__PURE__ */ jsx(
+          FlatTreeNodeItem,
+          {
+            item,
+            depth: 0,
+            indent,
+            childrenByParent,
+            onNodeSelect,
+            defaultExpanded: true
+          },
+          item.id
+        )) });
+      }
+      if (!tree || tree.length === 0) return null;
       return /* @__PURE__ */ jsx(Box, { className: `py-1 overflow-y-auto ${className ?? ""}`, role: "tree", children: tree.map((node) => /* @__PURE__ */ jsx(
         TreeNodeItem,
         {
@@ -28344,7 +28506,7 @@ var init_debug = __esm({
     createLogger("almadar:ui:debug:game-state");
   }
 });
-var isRelationsDebugEnabled, RelationSelect;
+var isRelationsDebugEnabled, MANY_CARDINALITIES, RelationSelect;
 var init_RelationSelect = __esm({
   "components/core/molecules/RelationSelect.tsx"() {
     "use client";
@@ -28358,6 +28520,11 @@ var init_RelationSelect = __esm({
     init_Typography();
     init_debug();
     isRelationsDebugEnabled = () => isDebugEnabled();
+    MANY_CARDINALITIES = [
+      "many",
+      "one-to-many",
+      "many-to-many"
+    ];
     RelationSelect = ({
       value,
       onChange,
@@ -29982,6 +30149,7 @@ var init_MathCanvas = __esm({
   "components/learning/molecules/MathCanvas.tsx"() {
     "use client";
     init_useEventBus();
+    init_perf();
     init_atoms();
     init_Stack();
     init_LearningCanvas();
@@ -30022,17 +30190,21 @@ var init_MathCanvas = __esm({
       error
     }) => {
       const eventBus = useEventBus();
+      const keyMapKey = keyMap ? JSON.stringify(keyMap) : null;
+      const keyUpMapKey = keyUpMap ? JSON.stringify(keyUpMap) : null;
+      const stableKeyMap = useMemo(() => keyMap, [keyMapKey]);
+      const stableKeyUpMap = useMemo(() => keyUpMap, [keyUpMapKey]);
       useEffect(() => {
-        if (!keyMap && !keyUpMap) return;
+        if (!stableKeyMap && !stableKeyUpMap) return;
         const onDown = (e) => {
-          const ev = keyMap?.[e.code];
+          const ev = stableKeyMap?.[e.code];
           if (ev) {
             eventBus.emit(`UI:${ev}`, {});
             e.preventDefault();
           }
         };
         const onUp = (e) => {
-          const ev = keyUpMap?.[e.code];
+          const ev = stableKeyUpMap?.[e.code];
           if (ev) eventBus.emit(`UI:${ev}`, {});
         };
         window.addEventListener("keydown", onDown);
@@ -30041,8 +30213,9 @@ var init_MathCanvas = __esm({
           window.removeEventListener("keydown", onDown);
           window.removeEventListener("keyup", onUp);
         };
-      }, [keyMap, keyUpMap, eventBus]);
+      }, [stableKeyMap, stableKeyUpMap, eventBus]);
       const derivedShapes = useMemo(() => {
+        const _perfT = perfStart("mathcanvas:derive");
         const out = [];
         const margin = 24;
         const plotW = width - margin * 2;
@@ -30286,6 +30459,7 @@ var init_MathCanvas = __esm({
           }
         }
         out.push(...shapes);
+        perfEnd("mathcanvas:derive", _perfT);
         return out;
       }, [
         width,
@@ -36501,7 +36675,7 @@ var init_RichBlockEditor = __esm({
         {
           variant: "bordered",
           padding: "none",
-          className: cn("flex flex-col", className),
+          className: cn("flex flex-col text-card-foreground", className),
           children: [
             enableBlocks && showToolbar && !readOnly && /* @__PURE__ */ jsx(
               Box,
@@ -41729,6 +41903,7 @@ var init_DetailPanel = __esm({
     "use client";
     init_atoms();
     init_Box();
+    init_Input();
     init_Stack();
     init_SimpleGrid();
     init_Menu();
@@ -41744,6 +41919,7 @@ var init_DetailPanel = __esm({
     ReactMarkdown2 = lazy(() => import('react-markdown'));
     DetailPanel = ({
       title: propTitle,
+      onTitleCommit,
       subtitle,
       status,
       avatar,
@@ -41765,6 +41941,7 @@ var init_DetailPanel = __esm({
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
+      const [titleDraft, setTitleDraft] = React85__default.useState(null);
       const isFieldDefArray = (arr) => {
         if (!arr || arr.length === 0) return false;
         const first = arr[0];
@@ -41985,6 +42162,50 @@ var init_DetailPanel = __esm({
         }),
         status && /* @__PURE__ */ jsx(Badge, { variant: status.variant ?? "default", children: status.label })
       ] });
+      const commitTitle = () => {
+        if (!onTitleCommit) return;
+        const next = (titleDraft ?? "").trim();
+        setTitleDraft(null);
+        if (!next || next === title) return;
+        onTitleCommit(next, normalizedData?.id !== void 0 ? String(normalizedData.id) : "");
+      };
+      const titleNode = onTitleCommit && titleDraft !== null ? /* @__PURE__ */ jsx(
+        Input,
+        {
+          value: titleDraft,
+          autoFocus: true,
+          "aria-label": t("common.title"),
+          className: "h-auto py-1 text-3xl font-bold tracking-tight",
+          onChange: (e) => setTitleDraft(e.target.value),
+          onBlur: commitTitle,
+          onKeyDown: (e) => {
+            if (e.key === "Enter") {
+              e.preventDefault();
+              commitTitle();
+            } else if (e.key === "Escape") {
+              e.preventDefault();
+              setTitleDraft(null);
+            }
+          },
+          "data-testid": "detail-title-input"
+        }
+      ) : onTitleCommit ? /* @__PURE__ */ jsx(
+        Box,
+        {
+          role: "button",
+          tabIndex: 0,
+          className: "cursor-text rounded px-1 -mx-1 transition-colors hover:bg-muted/40",
+          onClick: () => setTitleDraft(title ?? ""),
+          onKeyDown: (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+              e.preventDefault();
+              setTitleDraft(title ?? "");
+            }
+          },
+          "data-testid": "detail-title-editable",
+          children: /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" })
+        }
+      ) : /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" });
       const content = /* @__PURE__ */ jsx(Card, { variant: "elevated", children: /* @__PURE__ */ jsxs(VStack, { gap: "md", className: "p-6", children: [
         /* @__PURE__ */ jsxs(HStack, { justify: "between", align: "start", gap: "md", children: [
           /* @__PURE__ */ jsxs(HStack, { align: "start", gap: "sm", className: "min-w-0", children: [
@@ -42004,7 +42225,7 @@ var init_DetailPanel = __esm({
             avatar,
             /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "min-w-0", children: [
               /* @__PURE__ */ jsxs(HStack, { align: "center", gap: "sm", wrap: true, children: [
-                /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" }),
+                titleNode,
                 statusBadges
               ] }),
               subtitle && /* @__PURE__ */ jsx(Typography, { variant: "body", color: "secondary", children: subtitle })
@@ -42340,6 +42561,9 @@ function determineInputType(field) {
   if (field.type === "relation" || field.relation) {
     return "relation";
   }
+  if (field.type === "array") {
+    return "array";
+  }
   if (field.type === "enum" || field.values || getEnumOptions(field).length > 0) {
     return "select";
   }
@@ -42415,6 +42639,7 @@ var init_Form = __esm({
     init_Typography();
     init_Icon();
     init_RelationSelect();
+    init_TagInput();
     init_UploadDropZone();
     init_Alert();
     init_useEventBus();
@@ -42494,7 +42719,7 @@ var init_Form = __esm({
             values: "values" in f3 ? f3.values : void 0,
             min: f3.min,
             max: f3.max,
-            relation: "relation" in f3 ? { entity: f3.relation.entity } : void 0
+            relation: "relation" in f3 ? { entity: f3.relation.entity, cardinality: f3.relation.cardinality } : void 0
           })
         );
       }, [entity, fields]);
@@ -42561,7 +42786,7 @@ var init_Form = __esm({
               });
               debug(
                 "forms",
-                `Calculation triggered: ${calc.variableName} = ${value}`
+                `Calculation triggered: ${calc.variableName} = ${String(value)}`
               );
             }
           });
@@ -42729,7 +42954,7 @@ var init_Form = __esm({
                 values: "values" in entityField ? entityField.values : void 0,
                 min: entityField.min,
                 max: entityField.max,
-                relation: "relation" in entityField ? { entity: entityField.relation.entity } : void 0
+                relation: "relation" in entityField ? { entity: entityField.relation.entity, cardinality: entityField.relation.cardinality } : void 0
               };
             }
             return { name: field, type: "string" };
@@ -42841,6 +43066,22 @@ var init_Form = __esm({
           case "relation": {
             const relationOptions = relationsData[fieldName] || [];
             const relationLoading = relationsLoading[fieldName] || false;
+            if (field.relation?.cardinality !== void 0 && MANY_CARDINALITIES.includes(field.relation.cardinality)) {
+              const selectedValues = Array.isArray(currentValue) ? currentValue.map((v) => String(v)) : [];
+              return /* @__PURE__ */ jsx(
+                Select,
+                {
+                  ...commonProps,
+                  multiple: true,
+                  searchable: true,
+                  clearable: true,
+                  options: [...relationOptions],
+                  value: selectedValues,
+                  onValueChange: (value) => handleChange(fieldName, Array.isArray(value) ? value : [value]),
+                  placeholder: field.placeholder || `Select ${label}...`
+                }
+              );
+            }
             return /* @__PURE__ */ jsx(
               RelationSelect,
               {
@@ -42855,6 +43096,18 @@ var init_Form = __esm({
               }
             );
           }
+          case "array": {
+            const arrayValue = Array.isArray(currentValue) ? currentValue.map((v) => String(v)) : currentValue != null && currentValue !== "" ? [String(currentValue)] : [];
+            return /* @__PURE__ */ jsx(
+              TagInput,
+              {
+                placeholder: field.placeholder,
+                disabled: isLoading,
+                value: arrayValue,
+                onChange: (next) => handleChange(fieldName, [...next])
+              }
+            );
+          }
           case "number":
             return /* @__PURE__ */ jsx(
               Input,
@@ -48423,7 +48676,10 @@ function enrichFormFields(fields, entityDef) {
           enriched.values = entityField.enumValues;
         }
         if (entityField.relation) {
-          enriched.relation = entityField.relation.entity;
+          enriched.relation = {
+            entity: entityField.relation.entity,
+            cardinality: entityField.relation.cardinality
+          };
         }
         return enriched;
       }
@@ -48451,7 +48707,10 @@ function enrichFormFields(fields, entityDef) {
         }
       }
       if (!obj.relation && entityField.relation) {
-        enriched.relation = entityField.relation.entity;
+        enriched.relation = {
+          entity: entityField.relation.entity,
+          cardinality: entityField.relation.cardinality
+        };
       }
       return enriched;
     }
@@ -48466,7 +48725,12 @@ function enrichDetailFields(fields, entityDef) {
     const meta = { type: entityField.type };
     const values = entityField.values ?? entityField.enumValues;
     if (values && values.length > 0) meta.values = values;
-    if (entityField.relation) meta.relation = entityField.relation.entity;
+    if (entityField.relation) {
+      meta.relation = {
+        entity: entityField.relation.entity,
+        cardinality: entityField.relation.cardinality
+      };
+    }
     return meta;
   };
   return fields.map((field) => {
@@ -49020,6 +49284,33 @@ function isPlainConfigObject(value) {
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
 }
+function subtreeHasTraitRef(value) {
+  if (isEvaluatorResolvedData(value)) return false;
+  const cached = traitRefPresenceCache.get(value);
+  if (cached !== void 0) return cached;
+  let found = false;
+  const children = Array.isArray(value) ? value : Object.values(value);
+  for (const child of children) {
+    if (typeof child === "string" && TRAIT_BINDING_RE.test(child)) {
+      found = true;
+      break;
+    }
+    if (isRenderBindingMarker(child)) continue;
+    if (Array.isArray(child)) {
+      if (subtreeHasTraitRef(child)) {
+        found = true;
+        break;
+      }
+    } else if (child !== null && typeof child === "object" && isPlainConfigObject(child)) {
+      if (subtreeHasTraitRef(child)) {
+        found = true;
+        break;
+      }
+    }
+  }
+  traitRefPresenceCache.set(value, found);
+  return found;
+}
 function substituteTraitRefsDeep(value, pathKey) {
   if (isRenderBindingMarker(value)) return value;
   if (typeof value === "string") {
@@ -49034,11 +49325,13 @@ function substituteTraitRefsDeep(value, pathKey) {
     return value;
   }
   if (Array.isArray(value)) {
+    if (!subtreeHasTraitRef(value)) return value;
     return value.map(
       (item, i) => substituteTraitRefsDeep(item, `${pathKey}[${i}]`)
     );
   }
   if (typeof value === "object" && isPlainConfigObject(value)) {
+    if (!subtreeHasTraitRef(value)) return value;
     const out = {};
     for (const [k, v] of Object.entries(value)) {
       out[k] = substituteTraitRefsDeep(v, `${pathKey}.${k}`);
@@ -49065,6 +49358,10 @@ function renderPatternProps(props, onDismiss, propsSchema) {
       };
       rendered[key] = /* @__PURE__ */ jsx(SlotContentRenderer, { content: childContent, onDismiss });
     } else if (Array.isArray(value)) {
+      if (!isEvaluatorResolvedData(value) && value.some((el) => isPatternConfig(el))) ; else if (!subtreeHasTraitRef(value)) {
+        rendered[key] = value;
+        continue;
+      }
       const isDataArray = propsSchema?.[key]?.items?.types?.includes("object") ?? false;
       rendered[key] = value.map((item, i) => {
         const el = item;
@@ -49327,7 +49624,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, SELF_OVERLAY_PATTERNS, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN;
+var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, SELF_OVERLAY_PATTERNS, CONTENT_NODE_SLOTS, PATTERNS_WITH_CHILDREN, traitRefPresenceCache;
 var init_UISlotRenderer = __esm({
   "components/core/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -49401,6 +49698,7 @@ var init_UISlotRenderer = __esm({
       "alert",
       "dialog"
     ]);
+    traitRefPresenceCache = /* @__PURE__ */ new WeakMap();
     UISlotRenderer.displayName = "UISlotRenderer";
   }
 });
@@ -49528,6 +49826,23 @@ function createClientEffectHandlers(options) {
     })
   };
 }
+
+// lib/event-queue-coalesce.ts
+function enqueueEvent(queue, entry) {
+  if (entry.tick !== void 0) {
+    const pending = queue.find(
+      (e) => e.tick !== void 0 && e.eventKey === entry.eventKey && e.targetTrait === entry.targetTrait
+    );
+    if (pending !== void 0) {
+      pending.payload = entry.payload;
+      return;
+    }
+  }
+  queue.push(entry);
+}
+
+// hooks/useTraitStateMachine.ts
+init_perf();
 var lambdaLog = createLogger("almadar:ui:fn-form-lambda");
 function isOperatorCall(value) {
   const first = value[0];
@@ -50273,12 +50588,13 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       entityId
     };
     const emittedDuringExec = [];
+    const tickName = flushEvent.startsWith("tick:") ? flushEvent.slice(5) : void 0;
     const baseEmit = handlers.emit;
     const trackingHandlers = {
       ...handlers,
       emit: (event, eventPayload, source) => {
         emittedDuringExec.push(event);
-        baseEmit(event, eventPayload, source);
+        baseEmit(event, eventPayload, tickName !== void 0 ? { ...source, tick: tickName } : source);
       }
     };
     if (traitName === "Hero") {
@@ -50385,6 +50701,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   }, [eventBus]);
   useEffect(() => {
     const scheduler = createTickScheduler();
+    const timedTick = (key, fn) => () => perfTimeAsync(key, fn);
     const pureWriterTickKeys = /* @__PURE__ */ new Set();
     for (const group of sharedGroups.values()) {
       const ticksByInterval = /* @__PURE__ */ new Map();
@@ -50401,12 +50718,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
       for (const entries of ticksByInterval.values()) {
         const interval = entries[0].tick.interval;
-        const onDue = () => {
+        const onDue = timedTick(`tick:shared:${group.storeKey}@${String(interval)}`, () => {
           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") {
@@ -50424,21 +50741,23 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         if (sharedKey !== void 0 && pureWriterTickKeys.has(`${binding.trait.name}::${tick.name}`)) {
           continue;
         }
+        const tickKey = `tick:${binding.trait.name}::${tick.name}`;
         if (tick.interval === "frame") {
-          scheduler.add(0, () => runTickEffects(tick, binding));
+          scheduler.add(0, timedTick(tickKey, () => runTickEffects(tick, binding)));
         } else if (typeof tick.interval === "number") {
-          scheduler.add(tick.interval, () => runTickEffects(tick, binding));
+          scheduler.add(tick.interval, timedTick(tickKey, () => runTickEffects(tick, binding)));
         } else if (isValidCronExpression(tick.interval)) {
-          scheduler.addCron(tick.interval, () => runTickEffects(tick, binding));
+          scheduler.addCron(tick.interval, timedTick(tickKey, () => runTickEffects(tick, binding)));
         } else {
-          scheduler.add(parseDurationString(tick.interval), () => runTickEffects(tick, binding));
+          scheduler.add(parseDurationString(tick.interval), timedTick(tickKey, () => runTickEffects(tick, binding)));
         }
       }
     }
     return () => scheduler.stopAll();
   }, [traitBindings, runTickEffects, sharedGroups, sharedEntityStore, emitFromSharedWriter]);
-  const processEventQueued = useCallback(async (eventKey, payload, targetTrait) => {
+  const processEventQueued = useCallback(async (eventKey, payload, targetTrait, tick, sourceTrait) => {
     const normalizedEvent = normalizeEventKey(eventKey);
+    const _perfT0 = perfStart("processEvent:total");
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
     crossTraitLog.debug("processEvent:enter", () => ({
@@ -50462,6 +50781,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         entityByTrait[name] = { ...sharedEntityStore.getSnapshot(sharedKey) };
       }
     }
+    const _perfT1 = perfStart("processEvent:guardMatch");
     const results = currentManager.sendEvent(
       normalizedEvent,
       payload,
@@ -50470,6 +50790,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       void 0,
       targetTrait
     );
+    perfEnd("processEvent:guardMatch", _perfT1);
     crossTraitLog.debug("processEvent:results", {
       event: normalizedEvent,
       executedCount: results.length,
@@ -50519,6 +50840,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           transition: `${result.previousState} -> ${result.newState}`,
           effects: JSON.stringify(result.effects)
         }));
+        const _perfT2 = perfStart("processEvent:executeAll");
         const emittedDuringExec = await executeTransitionEffects({
           binding,
           // upstream gap: /runtime TransitionResult.effects is unknown[] — they are SExpr at runtime (see Almadar_UI_Gaps.md)
@@ -50530,6 +50852,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           syncOnly: false,
           log: stateLog
         });
+        perfEnd("processEvent:executeAll", _perfT2);
         emittedByTrait.set(traitName, emittedDuringExec);
         for (const emittedKey of emittedDuringExec) {
           bridgeEchoPendingRef.current.set(
@@ -50626,23 +50949,31 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         if (orbital) dispatchedOrbitals.add(orbital);
       }
       const relayPayload = targetTrait !== void 0 ? { ...payload ?? {}, _targetTrait: targetTrait } : payload;
-      await onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals);
+      void onEventProcessed(normalizedEvent, relayPayload, dispatchedOrbitals, tick, sourceTrait);
     }
+    perfEnd("processEvent:total", _perfT0);
+    perfEnd(`event:${normalizedEvent}`, _perfT0);
   }, [entities, eventBus, sharedEntityStore]);
   const drainEventQueue = useCallback(async () => {
     if (processingRef.current) return;
     processingRef.current = true;
+    const _perfT = perfStart("drain:pass");
+    let _perfN = 0;
     try {
       while (eventQueueRef.current.length > 0) {
         const entry = eventQueueRef.current.shift();
-        await processEventQueued(entry.eventKey, entry.payload, entry.targetTrait);
+        _perfN++;
+        await processEventQueued(entry.eventKey, entry.payload, entry.targetTrait, entry.tick, entry.sourceTrait);
       }
     } finally {
       processingRef.current = false;
+      perfEnd("drain:pass", _perfT);
+      perfGauge("drain:passEntries", _perfN);
     }
   }, [processEventQueued]);
-  const enqueueAndDrain = useCallback((eventKey, payload, targetTrait) => {
-    eventQueueRef.current.push({ eventKey, payload, targetTrait });
+  const enqueueAndDrain = useCallback((eventKey, payload, targetTrait, tick, sourceTrait) => {
+    enqueueEvent(eventQueueRef.current, { eventKey, payload, targetTrait, tick, sourceTrait });
+    perfGauge("queue:depthAtEnqueue", eventQueueRef.current.length);
     void drainEventQueue();
   }, [drainEventQueue]);
   useCallback((eventKey, payload) => {
@@ -50695,7 +51026,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             crossTraitLog.debug("self:fire-server-cascade", { traitName, busKey: selfBusKey, eventKey });
           }
           crossTraitLog.debug("self:fire", { traitName, busKey: selfBusKey, eventKey });
-          enqueueAndDrain(eventKey, event.payload, traitName);
+          enqueueAndDrain(eventKey, event.payload, traitName, event.source?.tick, event.source?.trait);
         });
         unsubscribes.push(() => {
           crossTraitLog.debug("self:unsubscribe", { traitName, busKey: selfBusKey, eventKey });
@@ -50713,7 +51044,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         const bareKey = `UI:${eventKey}`;
         const unsub = eventBus.on(bareKey, (event) => {
           crossTraitLog.debug("bare-cascade:fire", { bareKey, eventKey });
-          enqueueAndDrain(eventKey, event.payload);
+          enqueueAndDrain(eventKey, event.payload, void 0, event.source?.tick, event.source?.trait);
         });
         unsubscribes.push(() => {
           crossTraitLog.debug("bare-cascade:unsubscribe", { bareKey, eventKey });
@@ -50747,7 +51078,9 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           enqueueAndDrain(
             listen.triggers,
             applyListenPayloadMapping(listen.payloadMapping, event.payload, evaluateListenPayloadExpr),
-            binding.trait.name
+            binding.trait.name,
+            event.source?.tick,
+            event.source?.trait
           );
         });
         unsubscribes.push(() => {
@@ -51042,7 +51375,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     [serverActiveTraits]
   );
   const uiSlots = useUISlots();
-  const onEventProcessed = useCallback(async (event, payload, dispatchedOrbitals) => {
+  const onEventProcessed = useCallback((event, payload, dispatchedOrbitals, tick, sourceTrait) => {
     if (!bridge.connected || !orbitalNames?.length) return;
     const targets = dispatchedOrbitals && dispatchedOrbitals.size > 0 ? orbitalNames.filter((n) => dispatchedOrbitals.has(n)) : orbitalNames;
     xOrbitalLog.debug("TraitInitializer:fanout", () => ({
@@ -51052,9 +51385,14 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
       dispatchedOrbitalsSize: dispatchedOrbitals?.size ?? 0
     }));
     for (const name of targets) {
-      const { effects, meta } = await bridge.sendEvent(name, event, withActiveTraits(payload));
-      recordServerResponse(name, event, meta);
-      applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
+      if (tick !== void 0) {
+        void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
+        continue;
+      }
+      void bridge.sendEvent(name, event, withActiveTraits(payload)).then(({ effects, meta }) => {
+        recordServerResponse(name, event, meta);
+        applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
+      });
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams };
@@ -51372,14 +51710,15 @@ function OrbPreview({
     return pattern.replace(/:([A-Za-z0-9_]+)/g, (whole, key) => routeParams[key] ?? whole);
   }, [currentPagePath, routeParams]);
   const navStackRef = useRef(null);
-  const handleNavigate = useCallback((path) => {
+  const handleNavigate = useCallback((path, navState) => {
     const hit = matchPathAmong(pages, path, (entry) => entry.page.path);
     const match = hit?.candidate;
-    const params = hit?.params ?? {};
+    const params = { ...hit?.params ?? {}, ...navState ?? {} };
     navLog.debug("handleNavigate", () => ({
       path,
       matched: match?.page.name ?? null,
       params,
+      navState: navState ? JSON.stringify(navState) : void 0,
       availablePaths: pages.map((p) => p.page.path)
     }));
     if (match?.page.name) {
@@ -51394,9 +51733,9 @@ function OrbPreview({
     }
   }, [pages]);
   const handleNavigateEffect = useCallback(
-    (path, _params, crumb) => {
+    (path, params, crumb) => {
       navStackRef.current?.beginNavigate(path, crumb);
-      handleNavigate(path);
+      handleNavigate(path, params);
     },
     [handleNavigate]
   );
@@ -51527,11 +51866,13 @@ function BrowserPlayground({
     unregister: async () => {
       runtime.unregisterAll();
     },
-    sendEvent: async (orbitalName, event, payload) => {
+    sendEvent: async (orbitalName, event, payload, _clientId, tick, sourceTrait) => {
       await registrationReady;
       return runtime.processOrbitalEvent(orbitalName, {
         event,
-        payload
+        payload,
+        tick,
+        sourceTrait
         // @almadar/runtime OrbitalEventResponse.clientEffects uses a wider ClientEffectTuple than
         // ServerBridge's local definition — cast at this boundary (upstream fix queued).
       });
@@ -51549,16 +51890,8 @@ function BrowserPlayground({
     }
   );
 }
-function usePerfBuffer() {
-  return useSyncExternalStore(perfStore.subscribe, perfStore.getSnapshot, perfStore.getSnapshot);
-}
-var profilerOnRender = (id, phase, actualDuration, baseDuration, _startTime, commitTime) => {
-  pushPerfEntry({
-    name: `profiler:${id}:${phase}`,
-    durationMs: actualDuration,
-    ts: commitTime,
-    detail: { baseDuration }
-  });
-};
+
+// runtime/index.ts
+init_perf();
 
 export { BrowserPlayground, OrbPreview, clearSchemaCache, createClientEffectHandlers, profilerOnRender, usePerfBuffer, useResolvedSchema, useTraitStateMachine };