@almadar/ui 6.15.0 → 6.17.0

package/dist/providers/index.js

@@ -3388,7 +3388,7 @@ var init_Textarea = __esm({
     init_cn();
     init_useEventBus();
     Textarea = React89__default.forwardRef(
-      ({ className, error, onChange, ...props }, ref) => {
+      ({ className, error, onChange, action, onKeyDown, ...props }, ref) => {
         const eventBus = useEventBus();
         const handleChange = (e) => {
           if (typeof onChange === "string") {
@@ -3397,11 +3397,18 @@ var init_Textarea = __esm({
             onChange?.(e);
           }
         };
+        const handleKeyDown = (e) => {
+          onKeyDown?.(e);
+          if (!action || e.key !== "Enter" || !(e.metaKey || e.ctrlKey)) return;
+          e.preventDefault();
+          eventBus.emit(`UI:${action}`, { value: e.currentTarget.value });
+        };
         return /* @__PURE__ */ jsx(
           "textarea",
           {
             ref,
             onChange: handleChange,
+            onKeyDown: handleKeyDown,
             className: cn(
               "block w-full border-[length:var(--border-width)] shadow-sm",
               "px-3 py-2 text-sm text-foreground",
@@ -8936,6 +8943,29 @@ var init_useCanvasGestures = __esm({
   }
 });
 
+// lib/keyMapEvent.ts
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) return false;
+  const tag = target.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return true;
+  return target.isContentEditable || target.contentEditable === "true";
+}
+function keyMapCode(e) {
+  let code = e.code;
+  if (e.altKey) code = `Alt+${code}`;
+  if (e.shiftKey) code = `Shift+${code}`;
+  if (e.metaKey || e.ctrlKey) code = `Mod+${code}`;
+  return code;
+}
+function resolveKeyMapEvent(map, e) {
+  if (!map || isEditableTarget(e.target)) return void 0;
+  return map[keyMapCode(e)] ?? map[e.code];
+}
+var init_keyMapEvent = __esm({
+  "lib/keyMapEvent.ts"() {
+  }
+});
+
 // lib/imageCache.ts
 function startLoad(url, onReady, existing) {
   const img = new Image();
@@ -10861,14 +10891,14 @@ function Canvas2D({
   useEffect(() => {
     if (!keyMap && !keyUpMap) return;
     const onDown = (e) => {
-      const ev = keyMap?.[e.code];
+      const ev = resolveKeyMapEvent(keyMap, e);
       if (ev) {
         eventBus.emit(`UI:${ev}`, {});
         e.preventDefault();
       }
     };
     const onUp = (e) => {
-      const ev = keyUpMap?.[e.code];
+      const ev = resolveKeyMapEvent(keyUpMap, e);
       if (ev) eventBus.emit(`UI:${ev}`, {});
     };
     window.addEventListener("keydown", onDown);
@@ -10992,6 +11022,7 @@ var init_Canvas2D = __esm({
     init_useCamera();
     init_useCanvasGestures();
     init_verificationRegistry();
+    init_keyMapEvent();
     init_webPainter2d();
     init_projector();
     init_paintDispatch();
@@ -27430,6 +27461,40 @@ var init_DashboardLayout = __esm({
     NavLinkBottom.displayName = "NavLinkBottom";
   }
 });
+
+// lib/relationLabel.ts
+function relationLabel(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date)
+    return null;
+  for (const key of ["name", "title", "label"]) {
+    const candidate = value[key];
+    if (typeof candidate === "string" && candidate !== "") return candidate;
+  }
+  const id = value.id;
+  return id !== void 0 && id !== null ? String(id) : null;
+}
+function relationDisplayLabels(value, options) {
+  if (value === void 0 || value === null || value === "") return [];
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => relationDisplayLabels(item, options));
+  }
+  const hydrated = relationLabel(value);
+  if (hydrated !== null) return [hydrated];
+  const raw = String(value);
+  const match = options?.find((opt) => opt.value === raw);
+  return [match ? match.label : raw];
+}
+function resolveRelationCellDisplay(value, options) {
+  if (value === null || value === void 0 || value === "") return void 0;
+  const isObjectShaped = typeof value === "object" && !(value instanceof Date) || Array.isArray(value) && value.some((v) => v !== null && typeof v === "object" && !(v instanceof Date));
+  if (!isObjectShaped && !options) return void 0;
+  const labels = relationDisplayLabels(value, options);
+  return labels.length > 0 ? labels.join(", ") : void 0;
+}
+var init_relationLabel = __esm({
+  "lib/relationLabel.ts"() {
+  }
+});
 function downloadItemUrl(url, label) {
   const a = document.createElement("a");
   a.href = url;
@@ -28261,7 +28326,8 @@ function DataGrid({
   positionEvent,
   dndItemIdField,
   dndRoot,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
@@ -28451,6 +28517,10 @@ function DataGrid({
               );
             }
             const titleValue = getNestedValue(itemData, titleField?.name ?? "");
+            const titleDisplay = resolveRelationCellDisplay(
+              titleValue,
+              titleField ? relationsData?.[titleField.name] : void 0
+            ) ?? (titleValue !== void 0 && titleValue !== null ? String(titleValue) : void 0);
             return wrapDnd(
               /* @__PURE__ */ jsxs(
                 Box,
@@ -28475,7 +28545,7 @@ function DataGrid({
                         "img",
                         {
                           src: imgUrl,
-                          alt: titleValue !== void 0 ? String(titleValue) : "",
+                          alt: titleDisplay ?? "",
                           className: "w-full h-full object-cover",
                           loading: "lazy"
                         }
@@ -28490,18 +28560,18 @@ function DataGrid({
                           onChange: () => toggleSelection(id),
                           onClick: (e) => e.stopPropagation(),
                           className: "w-4 h-4 mt-1 flex-shrink-0 accent-primary",
-                          "aria-label": t("card.selectItem", { item: titleValue !== void 0 ? String(titleValue) : t("card.itemFallback") })
+                          "aria-label": t("card.selectItem", { item: titleDisplay ?? t("card.itemFallback") })
                         }
                       ),
                       /* @__PURE__ */ jsxs(VStack, { gap: "xs", className: "flex-1 min-w-0", children: [
-                        titleValue !== void 0 && titleValue !== null && /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center min-w-0", children: [
+                        titleDisplay !== void 0 && /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center min-w-0", children: [
                           titleField?.icon && renderIconInput(titleField.icon, { size: "sm", className: "text-primary flex-shrink-0" }),
                           /* @__PURE__ */ jsx(
                             Typography,
                             {
                               variant: titleField?.variant === "h3" ? "h3" : "h4",
                               className: "font-semibold truncate min-w-0",
-                              children: String(titleValue)
+                              children: titleDisplay
                             }
                           )
                         ] }),
@@ -28510,7 +28580,7 @@ function DataGrid({
                           if (val === void 0 || val === null || val === "") return null;
                           return /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center", children: [
                             field.icon && renderIconInput(field.icon, { size: "xs" }),
-                            /* @__PURE__ */ jsx(Badge, { variant: resolveBadgeVariant(field, String(val)), children: humanizeEnumValue(formatValue(val, field.format)) })
+                            /* @__PURE__ */ jsx(Badge, { variant: resolveBadgeVariant(field, String(val)), children: resolveRelationCellDisplay(val, relationsData?.[field.name]) ?? humanizeEnumValue(formatValue(val, field.format)) })
                           ] }, field.name);
                         }) })
                       ] }),
@@ -28549,7 +28619,7 @@ function DataGrid({
                       bodyFields.filter((f3) => f3.variant === "caption" && f3.format !== "boolean").map((field) => {
                         const value = getNestedValue(itemData, field.name);
                         if (value === void 0 || value === null || value === "") return null;
-                        return /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", className: "line-clamp-2", children: formatValue(value, field.format) }, field.name);
+                        return /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", className: "line-clamp-2", children: resolveRelationCellDisplay(value, relationsData?.[field.name]) ?? formatValue(value, field.format) }, field.name);
                       }),
                       /* @__PURE__ */ jsx(HStack, { gap: "md", className: "flex-wrap gap-y-1", children: bodyFields.filter((f3) => f3.variant !== "caption" || f3.format === "boolean").map((field) => {
                         const value = getNestedValue(itemData, field.name);
@@ -28564,7 +28634,7 @@ function DataGrid({
                         return /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center", children: [
                           field.icon && renderIconInput(field.icon, { size: "xs", className: "text-muted-foreground" }),
                           /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "secondary", className: "sr-only", children: (field.label ?? fieldLabel2(field.name)) + ":" }),
-                          /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: formatValue(value, field.format) })
+                          /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: resolveRelationCellDisplay(value, relationsData?.[field.name]) ?? formatValue(value, field.format) })
                         ] }, field.name);
                       }) })
                     ] }) })
@@ -28608,6 +28678,7 @@ var init_DataGrid = __esm({
     "use client";
     init_cn();
     init_format();
+    init_relationLabel();
     init_getNestedValue();
     init_useEventBus();
     init_Box();
@@ -28660,7 +28731,9 @@ function statusVariant3(value) {
   if (["new", "created", "scheduled", "queued", "info"].includes(v)) return "info";
   return "default";
 }
-function formatValue2(value, format, boolLabels) {
+function formatValue2(value, format, boolLabels, relationOptions) {
+  const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
+  if (relationDisplay !== void 0) return relationDisplay;
   if (value !== void 0 && value !== null && (format === "boolean" || typeof value === "boolean")) {
     const isNo = value === false || value === 0 || String(value) === "false";
     return isNo ? boolLabels?.no ?? "No" : boolLabels?.yes ?? "Yes";
@@ -28720,7 +28793,8 @@ function DataList({
   positionEvent,
   dndItemIdField,
   dndRoot,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
@@ -28908,13 +28982,13 @@ function DataList({
                       return f3.variant === "badge" ? (
                         // `format` applies here too — a boolean field badged
                         // without it renders the raw "false" instead of "No".
-                        /* @__PURE__ */ jsx(Badge, { variant: statusVariant3(String(v)), children: formatValue2(v, f3.format) }, f3.name)
+                        /* @__PURE__ */ jsx(Badge, { variant: statusVariant3(String(v)), children: formatValue2(v, f3.format, void 0, relationsData?.[f3.name]) }, f3.name)
                       ) : /* @__PURE__ */ jsx(
                         Typography,
                         {
                           variant: "caption",
                           className: cn("text-xs", isSent ? "opacity-70" : "text-muted-foreground"),
-                          children: formatValue2(v, f3.format)
+                          children: formatValue2(v, f3.format, void 0, relationsData?.[f3.name])
                         },
                         f3.name
                       );
@@ -28992,6 +29066,10 @@ function DataList({
     }
     const id = itemData.id || String(index);
     const titleValue = getNestedValue(itemData, titleField?.name ?? "");
+    const titleDisplay = resolveRelationCellDisplay(
+      titleValue,
+      titleField ? relationsData?.[titleField.name] : void 0
+    ) ?? (titleValue !== void 0 && titleValue !== null ? String(titleValue) : void 0);
     return wrapDnd(
       /* @__PURE__ */ jsxs(Box, { "data-entity-row": true, "data-entity-id": id, onClick: rowClickEvent ? handleRowClick(itemData) : void 0, className: cn(rowClickEvent && "cursor-pointer"), children: [
         /* @__PURE__ */ jsxs(
@@ -29016,7 +29094,7 @@ function DataList({
                     {
                       variant: titleField?.variant === "h3" ? "h3" : "h4",
                       className: cn("font-semibold truncate flex-1", isCompact && "text-sm"),
-                      children: String(titleValue)
+                      children: titleDisplay
                     }
                   ),
                   badgeFields.map((field) => {
@@ -29024,7 +29102,7 @@ function DataList({
                     if (val === void 0 || val === null) return null;
                     return /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "items-center flex-shrink-0", children: [
                       field.icon && renderIconInput2(field.icon, { size: "xs" }),
-                      /* @__PURE__ */ jsx(Badge, { variant: statusVariant3(String(val)), children: formatValue2(val, field.format) })
+                      /* @__PURE__ */ jsx(Badge, { variant: statusVariant3(String(val)), children: formatValue2(val, field.format, void 0, relationsData?.[field.name]) })
                     ] }, field.name);
                   })
                 ] }),
@@ -29045,7 +29123,7 @@ function DataList({
                         ]
                       }
                     ),
-                    /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }) })
+                    /* @__PURE__ */ jsx(Typography, { variant: "small", color: "secondary", children: formatValue2(value, field.format, { yes: t("common.yes"), no: t("common.no") }, relationsData?.[field.name]) })
                   ] }, field.name);
                 }) }),
                 progressFields.map((field) => {
@@ -29125,6 +29203,7 @@ var init_DataList = __esm({
     "use client";
     init_cn();
     init_format();
+    init_relationLabel();
     init_getNestedValue();
     init_useEventBus();
     init_Box();
@@ -32969,6 +33048,7 @@ var init_MathCanvas = __esm({
     "use client";
     init_useEventBus();
     init_perf();
+    init_keyMapEvent();
     init_atoms();
     init_Stack();
     init_gameFonts();
@@ -33022,14 +33102,14 @@ var init_MathCanvas = __esm({
       useEffect(() => {
         if (!stableKeyMap && !stableKeyUpMap) return;
         const onDown = (e) => {
-          const ev = stableKeyMap?.[e.code];
+          const ev = resolveKeyMapEvent(stableKeyMap, e);
           if (ev) {
             eventBus.emit(`UI:${ev}`, {});
             e.preventDefault();
           }
         };
         const onUp = (e) => {
-          const ev = stableKeyUpMap?.[e.code];
+          const ev = resolveKeyMapEvent(stableKeyUpMap, e);
           if (ev) eventBus.emit(`UI:${ev}`, {});
         };
         window.addEventListener("keydown", onDown);
@@ -35445,33 +35525,6 @@ var init_Lightbox = __esm({
     Lightbox.displayName = "Lightbox";
   }
 });
-
-// lib/relationLabel.ts
-function relationLabel(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date)
-    return null;
-  for (const key of ["name", "title", "label"]) {
-    const candidate = value[key];
-    if (typeof candidate === "string" && candidate !== "") return candidate;
-  }
-  const id = value.id;
-  return id !== void 0 && id !== null ? String(id) : null;
-}
-function relationDisplayLabels(value, options) {
-  if (value === void 0 || value === null || value === "") return [];
-  if (Array.isArray(value)) {
-    return value.flatMap((item) => relationDisplayLabels(item, options));
-  }
-  const hydrated = relationLabel(value);
-  if (hydrated !== null) return [hydrated];
-  const raw = String(value);
-  const match = options?.find((opt) => opt.value === raw);
-  return [match ? match.label : raw];
-}
-var init_relationLabel = __esm({
-  "lib/relationLabel.ts"() {
-  }
-});
 function renderIconInput3(icon, props) {
   return typeof icon === "string" ? /* @__PURE__ */ jsx(Icon, { name: icon, ...props }) : /* @__PURE__ */ jsx(Icon, { icon, ...props });
 }
@@ -35535,7 +35588,8 @@ function TableView({
   reorderEvent,
   positionEvent,
   dndItemIdField,
-  dndRoot
+  dndRoot,
+  relationsData
 }) {
   const eventBus = useEventBus();
   const { t } = useTranslate();
@@ -35620,7 +35674,7 @@ function TableView({
   const colFloors = React89__default.useMemo(
     () => colDefs.map((col) => {
       const longest = data.reduce((widest, row) => {
-        const cell = formatCell(asFieldValue(getNestedValue(row, col.field ?? col.key)), col.format);
+        const cell = formatCell(asFieldValue(getNestedValue(row, col.field ?? col.key)), col.format, relationsData?.[col.field ?? col.key]);
         return Math.max(widest, cell.length);
       }, columnLabel(col).length);
       const chrome = col.format === "badge" ? BADGE_CHROME_CH : 0;
@@ -35720,9 +35774,11 @@ function TableView({
               col.className
             );
             if (col.format === "badge" && raw != null && raw !== "") {
-              return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx(Badge, { variant: statusVariant4(String(raw)), size: "sm", className: "whitespace-nowrap", children: humanizeEnumValue(String(raw)) }) }, col.key);
+              const relationDisplay = resolveRelationCellDisplay(raw, relationsData?.[col.field ?? col.key]);
+              const label = relationDisplay ?? humanizeEnumValue(String(raw));
+              return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx(Badge, { variant: statusVariant4(String(raw)), size: "sm", className: "whitespace-nowrap", children: label }) }, col.key);
             }
-            return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx("span", { className: "truncate text-foreground", children: formatCell(raw, col.format) }) }, col.key);
+            return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx("span", { className: "truncate text-foreground", children: formatCell(raw, col.format, relationsData?.[col.field ?? col.key]) }) }, col.key);
           }),
           hasActions && /* @__PURE__ */ jsxs(
             HStack,
@@ -35824,11 +35880,9 @@ var init_TableView = __esm({
     init_Menu();
     init_useDataDnd();
     tableViewLog = createLogger("almadar:ui:table-view");
-    formatCell = (value, format) => {
-      if (value !== null && value !== void 0 && typeof value === "object" && !(value instanceof Date)) {
-        const labels = relationDisplayLabels(value);
-        if (labels.length > 0) return labels.join(", ");
-      }
+    formatCell = (value, format, relationOptions) => {
+      const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
+      if (relationDisplay !== void 0) return relationDisplay;
       return formatValue(value, format);
     };
     MAX_MEASURED_COL_CH = 32;
@@ -44538,7 +44592,8 @@ function DataTable({
   headerActions,
   showTotal = true,
   className,
-  look = "dense"
+  look = "dense",
+  relationsData
 }) {
   const [openActionMenu, setOpenActionMenu] = useState(
     null
@@ -44833,6 +44888,11 @@ function DataTable({
                       "data-column": String(col.key),
                       className: "px-4 py-3 text-sm text-foreground whitespace-nowrap sm:whitespace-normal",
                       children: col.render ? col.render(cellValue, row, rowIndex) : (() => {
+                        const relationDisplay = resolveRelationCellDisplay(
+                          cellValue,
+                          relationsData?.[String(col.key)]
+                        );
+                        if (relationDisplay !== void 0) return relationDisplay;
                         const boolVal = asBooleanValue2(cellValue);
                         if (boolVal !== null) {
                           return boolVal ? /* @__PURE__ */ jsx(Badge, { variant: "success", children: t("common.yes") }) : /* @__PURE__ */ jsx(Badge, { variant: "neutral", children: t("common.no") });
@@ -44921,6 +44981,7 @@ var init_DataTable = __esm({
     init_cn();
     init_format();
     init_getNestedValue();
+    init_relationLabel();
     init_atoms();
     init_Box();
     init_Stack();
@@ -54367,6 +54428,26 @@ function createCommandSendPump() {
     }
   };
 }
+
+// lib/cascadeEcho.ts
+function stampLocallyDeliveredEchoes(dispatchedEvent, emitted, locallyEmitted) {
+  const remainingLocal = /* @__PURE__ */ new Map();
+  for (const name of locallyEmitted) {
+    remainingLocal.set(name, (remainingLocal.get(name) ?? 0) + 1);
+  }
+  const result = [];
+  for (const entry of emitted) {
+    if (entry.event === dispatchedEvent) continue;
+    const remaining = remainingLocal.get(entry.event) ?? 0;
+    if (remaining > 0) {
+      remainingLocal.set(entry.event, remaining - 1);
+      result.push({ ...entry, source: { ...entry.source, dispatched: true } });
+    } else {
+      result.push(entry);
+    }
+  }
+  return result;
+}
 var xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
 var serverBridgeLog = createLogger("almadar:ui:server-bridge");
 function reEmitServerEvent(eventBus, emitted, origin) {
@@ -54523,7 +54604,7 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait) => {
+  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted) => {
     const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
@@ -54583,13 +54664,8 @@ function ServerBridgeProvider({
             }
           }
           if (result.emittedEvents) {
-            for (const emitted of result.emittedEvents) {
-              if (emitted.event === event) continue;
-              reEmitServerEvent(
-                eventBus,
-                { ...emitted, source: { ...emitted.source, dispatched: true } },
-                orbitalName
-              );
+            for (const emitted of stampLocallyDeliveredEchoes(event, result.emittedEvents, locallyEmitted ?? [])) {
+              reEmitServerEvent(eventBus, emitted, orbitalName);
             }
           }
         } else if (result.error) {