@almadar/ui 5.150.0 → 5.152.0

package/dist/runtime/index.js

@@ -4,11 +4,11 @@ import { EventBusContext, useTraitScopeChain, useEntitySchemaOptional, useEntity
 export { EntitySchemaProvider, ServerBridgeProvider, TraitContext, TraitProvider, useEntitySchema, useEntitySchemaOptional, useServerBridge, useTrait, useTraitContext } from '@almadar/ui/providers';
 import { createLogger, setNamespaceLevel, isLogLevelEnabled } from '@almadar/logger';
 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, isInlineTrait, containsEntityBinding, isSExpr, isEventPayloadValue, RENDER_BINDING_MARKER, ANIMATION_NAMES } from '@almadar/core';
+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';
 import { twMerge } from 'tailwind-merge';
 import * as LucideIcons2 from 'lucide-react';
-import { Loader2, X, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, Code, FileText, WrapText, Check, Copy, 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, ChevronUp, Tag, User, DollarSign } from 'lucide-react';
+import { Loader2, X, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, Code, FileText, WrapText, Check, Copy, RotateCcw, Play, Terminal, XCircle, AlertTriangle, Trash2, Link2, ArrowLeft, ZoomOut, ZoomIn, Download, DollarSign, ChevronDown, Menu as Menu$1, Package, Calendar, MoreHorizontal, Image as Image$1, Upload, HelpCircle, PauseCircle, Search, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, Minus, Eraser, TrendingUp, TrendingDown, AlertCircle, Circle, Clock, CheckCircle2, ChevronUp, Tag, User } from 'lucide-react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
 import { useTranslate } from '@almadar/ui/hooks';
@@ -77,7 +77,7 @@ import { CSS } from '@dnd-kit/utilities';
 import { ordered, lib } from 'emojilib';
 import { useNodeId, ReactFlowProvider, Handle, Position } from '@xyflow/react';
 import { forceSimulation, forceLink, forceManyBody, forceCollide, forceX, forceY } from 'd3-force';
-import { isDrawHostPattern, getPatternDefinition, getComponentForPattern as getComponentForPattern$1 } from '@almadar/core/patterns';
+import { isDrawHostPattern, getPatternDefinition, getPatternFieldsContract, getComponentForPattern as getComponentForPattern$1 } from '@almadar/core/patterns';
 import { isKnownStdOperator } from '@almadar/std/registry';
 import { OrbitalServerRuntime } from '@almadar/runtime/OrbitalServerRuntime';
 
@@ -13853,7 +13853,7 @@ var init_AlgoGraphCanvas = __esm({
         }
         const badgeGeoms = [];
         for (const g of nodeGeoms) {
-          if (!g.badge) continue;
+          if (!g.badge || g.badge.text === "") continue;
           const w = Math.min(42, Math.max(18, g.badge.text.length * 6 + 10));
           badgeGeoms.push({
             cx: g.x + g.radius * 0.75,
@@ -13919,7 +13919,7 @@ var init_AlgoGraphCanvas = __esm({
     };
   }
 });
-var DEFAULT_BAR_COLOR, DEFAULT_CELL_COLOR, DEFAULT_POINTER_COLOR, POINTER_BAND, TOP_PAD, PANEL_FAMILY_ORDER, RANGE_COLOR_DEFAULT, RANGE_FILL_OPACITY, BRACKET_TOP_OFFSET, BRACKET_ROW_H, BRACKET_TICK_H, BRACKET_LABEL_OFFSET, SLOT_EMPTY_FILL, SLOT_EMPTY_STROKE, SLOT_FILLED_STROKE, SLOT_HIGHLIGHT_DEFAULT, SLOT_VALUE_TEXT_COLOR, FRAME_ACTIVE_COLOR, FRAME_RETURNING_COLOR, FRAME_DONE_COLOR, FRAME_LABEL_COLOR, FRAME_DETAIL_COLOR, FRAME_TWO_LINE_MIN_H, BUCKET_INDEX_FILL, BUCKET_INDEX_STROKE, BUCKET_INDEX_TEXT, BUCKET_ENTRY_TEXT, BUCKET_ENTRY_DEFAULT, BUCKET_ENTRY_HIGHLIGHT, BUCKET_ENTRY_PROBING, BUCKET_ENTRY_MIN_W, BUCKET_ENTRY_MAX_W, AXIS_LABEL_COLOR, AXIS_LABEL_FONT_SIZE, CORNER_TEXT_COLOR, CORNER_FONT_SIZE, CORNER_MIN_CELL, CORNER_INSET_X, CORNER_INSET_Y, AUX_PRIMARY_RATIO, AUX_LABEL_BAND, AUX_BASELINE_PAD, AlgorithmCanvas;
+var DEFAULT_BAR_COLOR, DEFAULT_CELL_COLOR, DEFAULT_POINTER_COLOR, POINTER_BAND, TOP_PAD, PANEL_FAMILY_ORDER, RANGE_COLOR_DEFAULT, RANGE_FILL_OPACITY, BRACKET_TOP_OFFSET, BRACKET_ROW_H, BRACKET_TICK_H, BRACKET_LABEL_OFFSET, SLOT_EMPTY_FILL, SLOT_EMPTY_STROKE, SLOT_FILLED_STROKE, SLOT_HIGHLIGHT_DEFAULT, SLOT_VALUE_TEXT_COLOR, FRAME_ACTIVE_COLOR, FRAME_RETURNING_COLOR, FRAME_DONE_COLOR, FRAME_RIM_COLOR, FRAME_LABEL_COLOR, FRAME_DETAIL_COLOR, FRAME_TWO_LINE_MIN_H, FRAME_STRIP_H, FRAME_GAP, FRAME_BOTTOM_PAD, FRAME_MIN_H, BUCKET_INDEX_FILL, BUCKET_INDEX_STROKE, BUCKET_INDEX_TEXT, BUCKET_ENTRY_TEXT, BUCKET_ENTRY_DEFAULT, BUCKET_ENTRY_HIGHLIGHT, BUCKET_ENTRY_PROBING, BUCKET_ENTRY_MIN_W, BUCKET_ENTRY_MAX_W, AXIS_LABEL_COLOR, AXIS_LABEL_FONT_SIZE, CORNER_TEXT_COLOR, CORNER_FONT_SIZE, CORNER_MIN_CELL, CORNER_INSET_X, CORNER_INSET_Y, AUX_PRIMARY_RATIO, AUX_LABEL_BAND, AUX_BASELINE_PAD, AlgorithmCanvas;
 var init_AlgorithmCanvas = __esm({
   "components/learning/molecules/AlgorithmCanvas.tsx"() {
     "use client";
@@ -13946,9 +13946,18 @@ var init_AlgorithmCanvas = __esm({
     FRAME_ACTIVE_COLOR = "#3b82f6";
     FRAME_RETURNING_COLOR = "#f59e0b";
     FRAME_DONE_COLOR = "#94a3b8";
+    FRAME_RIM_COLOR = {
+      active: "#1d4ed8",
+      returning: "#b45309",
+      done: "#64748b"
+    };
     FRAME_LABEL_COLOR = "#ffffff";
     FRAME_DETAIL_COLOR = "#e2e8f0";
     FRAME_TWO_LINE_MIN_H = 22;
+    FRAME_STRIP_H = 44;
+    FRAME_GAP = 6;
+    FRAME_BOTTOM_PAD = 8;
+    FRAME_MIN_H = 12;
     BUCKET_INDEX_FILL = "#e2e8f0";
     BUCKET_INDEX_STROKE = "#9ca3af";
     BUCKET_INDEX_TEXT = "#374151";
@@ -14445,14 +14454,18 @@ var init_AlgorithmCanvas = __esm({
         if (frames.length > 0) {
           const panelYFrames = panelY.frames;
           const n = frames.length;
-          const frameH = panelHeight / n;
+          const maxStride = (panelHeight - FRAME_BOTTOM_PAD - TOP_PAD) / n;
+          const stride = Math.min(FRAME_STRIP_H + FRAME_GAP, maxStride);
+          const frameH = Math.max(FRAME_MIN_H, stride - FRAME_GAP);
           const x = 8;
           const w = width - 16;
+          const bottom = panelYFrames + panelHeight - FRAME_BOTTOM_PAD;
           frames.forEach((f3, i) => {
-            const y = panelYFrames + panelHeight - (i + 1) * frameH;
+            const y = bottom - i * stride - frameH;
             const state = f3.state ?? "active";
             const fill = state === "returning" ? f3.color ?? FRAME_RETURNING_COLOR : state === "done" ? f3.color ?? FRAME_DONE_COLOR : f3.color ?? FRAME_ACTIVE_COLOR;
-            out.push({ type: "rect", id: `frame-${i}`, x, y, width: w, height: frameH, color: fill, fill });
+            const rim = f3.color ?? FRAME_RIM_COLOR[state] ?? FRAME_RIM_COLOR.active;
+            out.push({ type: "rect", id: `frame-${i}`, x, y, width: w, height: frameH, color: rim, fill });
             if (frameH >= FRAME_TWO_LINE_MIN_H) {
               out.push({
                 type: "text",
@@ -14460,14 +14473,14 @@ var init_AlgorithmCanvas = __esm({
                 y: y + frameH * 0.35,
                 text: f3.label,
                 color: FRAME_LABEL_COLOR,
-                fontSize: 10,
+                fontSize: 11,
                 align: "left"
               });
               if (f3.detail) {
                 out.push({
                   type: "text",
                   x: 16,
-                  y: y + frameH * 0.7,
+                  y: y + frameH * 0.72,
                   text: f3.detail,
                   color: FRAME_DETAIL_COLOR,
                   fontSize: 10,
@@ -20930,8 +20943,6 @@ var init_ButtonGroup = __esm({
     ButtonGroup.displayName = "ButtonGroup";
   }
 });
-
-// lib/getNestedValue.ts
 function getNestedValue(obj, path) {
   if (obj === null || obj === void 0 || !path) {
     return void 0;
@@ -20952,6 +20963,15 @@ function getNestedValue(obj, path) {
   }
   return value;
 }
+function resolveImageUrl(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (isFileValue(value)) {
+    return value.url;
+  }
+  return void 0;
+}
 var init_getNestedValue = __esm({
   "lib/getNestedValue.ts"() {
   }
@@ -21589,8 +21609,8 @@ var init_CardGrid = __esm({
               actionPayload: { row: itemData },
               children: [
                 imageField && (() => {
-                  const imgUrl = getNestedValue(itemData, imageField);
-                  if (!imgUrl || typeof imgUrl !== "string") return null;
+                  const imgUrl = resolveImageUrl(getNestedValue(itemData, imageField));
+                  if (!imgUrl) return null;
                   return /* @__PURE__ */ jsx(Box, { className: "w-full aspect-video overflow-hidden rounded-t-lg", children: /* @__PURE__ */ jsx(
                     "img",
                     {
@@ -25606,8 +25626,8 @@ function DataGrid({
                   ),
                   children: [
                     imageField && (() => {
-                      const imgUrl = getNestedValue(itemData, imageField);
-                      if (!imgUrl || typeof imgUrl !== "string") return null;
+                      const imgUrl = resolveImageUrl(getNestedValue(itemData, imageField));
+                      if (!imgUrl) return null;
                       return /* @__PURE__ */ jsx(Box, { className: "w-full aspect-video overflow-hidden rounded-t-lg", children: /* @__PURE__ */ jsx(
                         "img",
                         {
@@ -28153,7 +28173,7 @@ var init_SearchInput = __esm({
         /* @__PURE__ */ jsx(
           Input,
           {
-            type: "text",
+            type: "search",
             value: searchValue,
             onChange: handleChange,
             placeholder: resolvedPlaceholder,
@@ -29479,6 +29499,7 @@ var MathCanvas;
 var init_MathCanvas = __esm({
   "components/learning/molecules/MathCanvas.tsx"() {
     "use client";
+    init_useEventBus();
     init_atoms();
     init_Stack();
     init_LearningCanvas();
@@ -29510,9 +29531,32 @@ var init_MathCanvas = __esm({
       interactive = false,
       animate = false,
       onShapeClick,
+      keyMap,
+      keyUpMap,
       isLoading,
       error
     }) => {
+      const eventBus = useEventBus();
+      useEffect(() => {
+        if (!keyMap && !keyUpMap) return;
+        const onDown = (e) => {
+          const ev = keyMap?.[e.code];
+          if (ev) {
+            eventBus.emit(`UI:${ev}`, {});
+            e.preventDefault();
+          }
+        };
+        const onUp = (e) => {
+          const ev = keyUpMap?.[e.code];
+          if (ev) eventBus.emit(`UI:${ev}`, {});
+        };
+        window.addEventListener("keydown", onDown);
+        window.addEventListener("keyup", onUp);
+        return () => {
+          window.removeEventListener("keydown", onDown);
+          window.removeEventListener("keyup", onUp);
+        };
+      }, [keyMap, keyUpMap, eventBus]);
       const derivedShapes = useMemo(() => {
         const out = [];
         const margin = 24;
@@ -29525,11 +29569,11 @@ var init_MathCanvas = __esm({
         if (showGrid) {
           for (let x = Math.ceil(xMin / gridStep) * gridStep; x <= xMax; x += gridStep) {
             const px = mapX(x);
-            out.push({ type: "line", x1: px, y1: margin, x2: px, y2: height - margin, color: "#e5e7eb", lineWidth: 1 });
+            out.push({ type: "line", x1: px, y1: margin, x2: px, y2: height - margin, color: "#9ca3af", opacity: 0.35, lineWidth: 1 });
           }
           for (let y = Math.ceil(yMin / gridStep) * gridStep; y <= yMax; y += gridStep) {
             const py = mapY(y);
-            out.push({ type: "line", x1: margin, y1: py, x2: width - margin, y2: py, color: "#e5e7eb", lineWidth: 1 });
+            out.push({ type: "line", x1: margin, y1: py, x2: width - margin, y2: py, color: "#9ca3af", opacity: 0.35, lineWidth: 1 });
           }
         }
         if (showTickLabels) {
@@ -31004,13 +31048,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect60, useRef: useRef63, useCallback: useCallback90, useState: useState92 } = React85__default;
+      const { useEffect: useEffect61, useRef: useRef63, useCallback: useCallback90, useState: useState92 } = React85__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 = useRef63({ centerLat, centerLng, zoom });
-        useEffect60(() => {
+        useEffect61(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -31021,7 +31065,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect60(() => {
+        useEffect61(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -37699,6 +37743,7 @@ var init_PageHeader = __esm({
       className
     }) => {
       const eventBus = useEventBus();
+      const statusBadge = typeof status === "string" ? status ? { label: status } : void 0 : status;
       const handleBack = () => {
         eventBus.emit(`UI:${backEvent}`);
       };
@@ -37746,15 +37791,15 @@ var init_PageHeader = __esm({
             /* @__PURE__ */ jsxs(Box, { children: [
               /* @__PURE__ */ jsxs(Box, { className: "flex items-center gap-3", children: [
                 /* @__PURE__ */ jsx(Typography, { variant: "h1", className: "text-2xl font-bold text-foreground", children: title != null ? String(title) : "" }),
-                status && /* @__PURE__ */ jsx(
+                statusBadge && /* @__PURE__ */ jsx(
                   Typography,
                   {
                     variant: "small",
                     className: cn(
                       "px-2.5 py-1 rounded-full text-xs font-medium",
-                      statusColors2[status.variant || "default"]
+                      statusColors2[statusBadge.variant || "default"]
                     ),
-                    children: status.label
+                    children: statusBadge.label
                   }
                 )
               ] }),
@@ -40983,7 +41028,7 @@ function formatFieldValue2(value, fieldName) {
   }
   return String(value);
 }
-function renderRichFieldValue(value, fieldName, fieldType) {
+function renderRichFieldValue(value, fieldName, fieldType, meta) {
   if (value === void 0 || value === null) return "\u2014";
   const str = String(value);
   switch (fieldType) {
@@ -41050,19 +41095,58 @@ function renderRichFieldValue(value, fieldName, fieldType) {
         }
       );
     case "date":
-    case "datetime": {
+    case "datetime":
+    case "timestamp": {
       const d = new Date(str);
       if (!isNaN(d.getTime())) {
         return d.toLocaleDateString(void 0, {
           year: "numeric",
           month: "long",
           day: "numeric",
-          ...fieldType === "datetime" ? { hour: "2-digit", minute: "2-digit" } : {}
+          ...fieldType !== "date" ? { hour: "2-digit", minute: "2-digit" } : {}
         });
       }
       return str;
     }
+    case "money": {
+      const n = typeof value === "number" ? value : Number(str);
+      if (!isNaN(n)) {
+        return new Intl.NumberFormat(void 0, {
+          style: "currency",
+          currency: "USD"
+        }).format(n);
+      }
+      return str;
+    }
+    case "relation": {
+      const match = meta?.options?.find((opt) => opt.value === str);
+      return match ? match.label : str;
+    }
+    case "file": {
+      if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        const file = value;
+        const label = typeof file.name === "string" && file.name ? file.name : "file";
+        const size = typeof file.sizeBytes === "number" ? ` \xB7 ${formatFileSize(file.sizeBytes)}` : "";
+        return /* @__PURE__ */ jsxs(
+          "a",
+          {
+            href: typeof file.url === "string" ? file.url : void 0,
+            download: label,
+            className: "inline-flex items-center gap-1.5 rounded-md border border-border bg-muted px-2 py-1 text-sm text-foreground no-underline hover:bg-accent",
+            children: [
+              /* @__PURE__ */ jsx(Icon, { icon: FileText, size: "sm", className: "text-muted-foreground" }),
+              label,
+              size && /* @__PURE__ */ jsx(Typography, { as: "span", variant: "caption", color: "muted", children: size })
+            ]
+          }
+        );
+      }
+      return str;
+    }
     default:
+      if (meta?.values && meta.values.length > 0 && meta.values.includes(str)) {
+        return /* @__PURE__ */ jsx(Badge, { variant: getBadgeVariant(fieldName, str), children: humanizeEnumValue(str) });
+      }
       return formatFieldValue2(value, fieldName);
   }
 }
@@ -41089,8 +41173,18 @@ function buildFieldTypeMap(fields) {
   const map = {};
   if (!fields) return map;
   for (const f3 of fields) {
-    if (typeof f3 === "object" && "name" in f3 && "type" in f3) {
-      map[f3.name] = f3.type;
+    if (typeof f3 === "object" && f3.type !== void 0) {
+      map["name" in f3 ? f3.name : f3.key] = f3.type;
+    }
+  }
+  return map;
+}
+function buildFieldMetaMap(fields) {
+  const map = {};
+  if (!fields) return map;
+  for (const f3 of fields) {
+    if (typeof f3 === "object" && (f3.type !== void 0 || f3.values !== void 0 || f3.relation !== void 0)) {
+      map["name" in f3 ? f3.name : f3.key] = { type: f3.type, values: f3.values, relation: f3.relation };
     }
   }
   return map;
@@ -41110,6 +41204,7 @@ var init_DetailPanel = __esm({
     init_format();
     init_getNestedValue();
     init_useEventBus();
+    init_UploadDropZone();
     formatFieldLabel = humanizeFieldName;
     ReactMarkdown2 = lazy(() => import('react-markdown'));
     DetailPanel = ({
@@ -41119,6 +41214,7 @@ var init_DetailPanel = __esm({
       avatar,
       sections: propSections,
       actions,
+      backAction,
       footer,
       slideOver = false,
       className,
@@ -41127,7 +41223,8 @@ var init_DetailPanel = __esm({
       fieldNames,
       initialData,
       isLoading = false,
-      error
+      error,
+      relationsData
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
@@ -41138,8 +41235,15 @@ var init_DetailPanel = __esm({
       };
       const effectiveFieldNames = isFieldDefArray(propFields) ? normalizeFieldDefs(propFields) : fieldNames;
       const fieldTypeMap = isFieldDefArray(propFields) ? buildFieldTypeMap(propFields) : {};
+      const fieldMetaMap = isFieldDefArray(propFields) ? buildFieldMetaMap(propFields) : {};
       const fieldLabelMap = isFieldDefArray(propFields) ? buildFieldLabelMap(propFields) : {};
       const labelFor = (field) => fieldLabelMap[field] ?? formatFieldLabel(field);
+      const metaFor = (field) => {
+        const base = fieldMetaMap[field];
+        const options = relationsData?.[field];
+        if (!base && !options) return void 0;
+        return { ...base, options };
+      };
       const handleActionClick = useCallback(
         (action, data2) => {
           if (action.navigatesTo) {
@@ -41218,7 +41322,7 @@ var init_DetailPanel = __esm({
             if (value !== void 0 && value !== null) {
               overviewFields.push({
                 label: labelFor(field),
-                value: renderRichFieldValue(value, field, fieldTypeMap[field]),
+                value: renderRichFieldValue(value, field, fieldTypeMap[field], metaFor(field)),
                 icon: getFieldIcon(field)
               });
             }
@@ -41234,7 +41338,7 @@ var init_DetailPanel = __esm({
             if (value !== void 0 && value !== null) {
               metricsFields.push({
                 label: labelFor(field),
-                value: renderRichFieldValue(value, field, fieldTypeMap[field]),
+                value: renderRichFieldValue(value, field, fieldTypeMap[field], metaFor(field)),
                 icon: getFieldIcon(field)
               });
             }
@@ -41250,7 +41354,7 @@ var init_DetailPanel = __esm({
             if (value !== void 0 && value !== null) {
               timelineFields.push({
                 label: labelFor(field),
-                value: renderRichFieldValue(value, field, fieldTypeMap[field]),
+                value: renderRichFieldValue(value, field, fieldTypeMap[field], metaFor(field)),
                 icon: getFieldIcon(field)
               });
             }
@@ -41266,7 +41370,7 @@ var init_DetailPanel = __esm({
             if (value !== void 0 && value !== null) {
               descFields.push({
                 label: labelFor(field),
-                value: renderRichFieldValue(value, field, fieldTypeMap[field]),
+                value: renderRichFieldValue(value, field, fieldTypeMap[field], metaFor(field)),
                 icon: getFieldIcon(field)
               });
             }
@@ -41314,7 +41418,7 @@ var init_DetailPanel = __esm({
               const value = normalizedData ? getNestedValue(normalizedData, field) : void 0;
               allFields.push({
                 label: labelFor(field),
-                value: renderRichFieldValue(value, field, fieldTypeMap[field]),
+                value: renderRichFieldValue(value, field, fieldTypeMap[field], metaFor(field)),
                 icon: getFieldIcon(field)
               });
             } else {
@@ -41329,34 +41433,49 @@ var init_DetailPanel = __esm({
       const otherActions = actions?.filter((a) => a !== closeAction) ?? [];
       const effectiveCloseAction = closeAction ?? { event: void 0};
       const content = /* @__PURE__ */ jsx(Card, { variant: "elevated", children: /* @__PURE__ */ jsxs(VStack, { gap: "md", className: "p-6", children: [
-        /* @__PURE__ */ jsxs(HStack, { justify: "end", align: "center", gap: "xs", children: [
-          otherActions.map((action, idx) => /* @__PURE__ */ jsx(
-            Button,
-            {
-              variant: action.variant || "secondary",
-              size: "sm",
-              action: action.navigatesTo ? void 0 : action.event,
-              actionPayload: { row: normalizedData },
-              onClick: action.navigatesTo ? () => handleActionClick(action, normalizedData) : void 0,
-              icon: action.icon,
-              "data-testid": action.event ? `action-${action.event}` : void 0,
-              "data-row-id": normalizedData?.id !== void 0 ? String(normalizedData.id) : void 0,
-              children: action.label
-            },
-            idx
-          )),
-          /* @__PURE__ */ jsx(
+        /* @__PURE__ */ jsxs(HStack, { justify: "between", align: "center", gap: "xs", children: [
+          /* @__PURE__ */ jsx(HStack, { align: "center", gap: "xs", children: backAction && /* @__PURE__ */ jsx(
             Button,
             {
-              variant: "ghost",
+              variant: backAction.variant || "ghost",
               size: "sm",
-              action: effectiveCloseAction.event,
+              action: backAction.navigatesTo ? void 0 : backAction.event,
               actionPayload: { row: normalizedData },
-              onClick: effectiveCloseAction.event ? void 0 : handleClose,
-              icon: X,
-              "data-testid": effectiveCloseAction.event ? `action-${effectiveCloseAction.event}` : "action-close"
+              onClick: backAction.navigatesTo ? () => handleActionClick(backAction, normalizedData) : void 0,
+              icon: backAction.icon ?? ArrowLeft,
+              "data-testid": backAction.event ? `action-${backAction.event}` : "action-back",
+              children: backAction.label
             }
-          )
+          ) }),
+          /* @__PURE__ */ jsxs(HStack, { justify: "end", align: "center", gap: "xs", children: [
+            otherActions.map((action, idx) => /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: action.variant || "secondary",
+                size: "sm",
+                action: action.navigatesTo ? void 0 : action.event,
+                actionPayload: { row: normalizedData },
+                onClick: action.navigatesTo ? () => handleActionClick(action, normalizedData) : void 0,
+                icon: action.icon,
+                "data-testid": action.event ? `action-${action.event}` : void 0,
+                "data-row-id": normalizedData?.id !== void 0 ? String(normalizedData.id) : void 0,
+                children: action.label
+              },
+              idx
+            )),
+            /* @__PURE__ */ jsx(
+              Button,
+              {
+                variant: "ghost",
+                size: "sm",
+                action: effectiveCloseAction.event,
+                actionPayload: { row: normalizedData },
+                onClick: effectiveCloseAction.event ? void 0 : handleClose,
+                icon: X,
+                "data-testid": effectiveCloseAction.event ? `action-${effectiveCloseAction.event}` : "action-close"
+              }
+            )
+          ] })
         ] }),
         avatar,
         /* @__PURE__ */ jsx(Typography, { variant: "h2", weight: "bold", children: title || "Details" }),
@@ -41671,6 +41790,10 @@ function determineInputType(field) {
       return "password";
     case "url":
       return "url";
+    case "file":
+      return "file";
+    case "money":
+      return "currency";
     case "number":
     case "integer":
     case "float":
@@ -41732,6 +41855,7 @@ var init_Form = __esm({
     init_Typography();
     init_Icon();
     init_RelationSelect();
+    init_UploadDropZone();
     init_Alert();
     init_useEventBus();
     init_debug();
@@ -41774,6 +41898,7 @@ var init_Form = __esm({
       cancelEvent = "CANCEL",
       relationsData = {},
       relationsLoading = {},
+      fieldOverrides,
       // Inspection form extensions - may come as boolean true from generated code (meaning enabled but config loaded separately)
       conditionalFields: conditionalFieldsRaw = {},
       hiddenCalculations: hiddenCalculationsRaw = [],
@@ -42020,7 +42145,8 @@ var init_Form = __esm({
               label,
               field.required && /* @__PURE__ */ jsx(Typography, { as: "span", color: "error", className: "ml-1", children: "*" })
             ] }),
-            renderFieldInput(field, fieldName, inputType, currentValue, label)
+            renderFieldInput(field, fieldName, inputType, currentValue, label),
+            field.hint && /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "muted", children: field.hint })
           ] }, fieldName);
         },
         [formData, isFieldVisible, relationsData, relationsLoading, isLoading]
@@ -42036,6 +42162,7 @@ var init_Form = __esm({
                 name: field,
                 type: entityField.type,
                 required: entityField.required,
+                hint: entityField.description,
                 // EntityField.default is typed `unknown` upstream — safe cast: schema defaults are always FieldValues.
                 defaultValue: entityField.default,
                 // EntityField is a discriminated union — `values` lives on Scalar/Enum, `relation` lives on Relation.
@@ -42048,8 +42175,18 @@ var init_Form = __esm({
             return { name: field, type: "string" };
           }
           return field;
+        }).map((field) => {
+          const fieldName = field.name || field.field;
+          const override = fieldOverrides?.find((o) => o.name === fieldName);
+          if (!override) return field;
+          return {
+            ...field,
+            ...override.label !== void 0 ? { label: override.label } : {},
+            ...override.placeholder !== void 0 ? { placeholder: override.placeholder } : {},
+            ...override.hint !== void 0 ? { hint: override.hint } : {}
+          };
         });
-      }, [effectiveFields, resolvedEntity]);
+      }, [effectiveFields, resolvedEntity, fieldOverrides]);
       const schemaFields = React85__default.useMemo(() => {
         if (normalizedFields.length === 0) return null;
         if (isDebugEnabled()) {
@@ -42173,6 +42310,44 @@ var init_Form = __esm({
                 max: field.max
               }
             );
+          case "currency":
+            return /* @__PURE__ */ jsx(
+              Input,
+              {
+                ...commonProps,
+                type: "number",
+                step: "0.01",
+                icon: DollarSign,
+                value: currentValue !== void 0 && currentValue !== "" ? String(currentValue) : "",
+                onChange: (e) => handleChange(
+                  fieldName,
+                  e.target.value ? Number(e.target.value) : void 0
+                ),
+                min: field.min,
+                max: field.max
+              }
+            );
+          case "file":
+            return /* @__PURE__ */ jsx(
+              UploadDropZone,
+              {
+                accept: field.pattern,
+                maxFiles: 1,
+                disabled: isLoading,
+                onFiles: (files) => {
+                  const f3 = files[0];
+                  if (!f3) return;
+                  const reader = new FileReader();
+                  reader.onload = () => handleChange(fieldName, {
+                    name: f3.name,
+                    mimeType: f3.type,
+                    sizeBytes: f3.size,
+                    url: typeof reader.result === "string" ? reader.result : ""
+                  });
+                  reader.readAsDataURL(f3);
+                }
+              }
+            );
           case "date":
             return /* @__PURE__ */ jsx(
               Input,
@@ -43205,6 +43380,7 @@ var COLUMN_CLASSES, ASPECT_CLASSES, MediaGallery;
 var init_MediaGallery = __esm({
   "components/core/organisms/MediaGallery.tsx"() {
     "use client";
+    init_getNestedValue();
     init_cn();
     init_atoms();
     init_Stack();
@@ -43273,9 +43449,9 @@ var init_MediaGallery = __esm({
         return entityData.map((record, idx) => {
           return {
             id: String(record.id ?? idx),
-            src: String(record.src ?? ("url" in record ? record.url : "") ?? ("image" in record ? record.image : "") ?? ""),
+            src: resolveImageUrl(record.src ?? ("url" in record ? record.url : void 0) ?? ("image" in record ? record.image : void 0)) ?? "",
             alt: record.alt ? String(record.alt) : void 0,
-            thumbnail: record.thumbnail ? String(record.thumbnail) : void 0,
+            thumbnail: resolveImageUrl(record.thumbnail),
             caption: record.caption ? String(record.caption) : "title" in record ? String(record.title) : void 0
           };
         });
@@ -47637,7 +47813,8 @@ __export(UISlotRenderer_exports, {
   SlotContentRenderer: () => SlotContentRenderer,
   SuspenseConfigProvider: () => SuspenseConfigProvider,
   UISlotComponent: () => UISlotComponent,
-  UISlotRenderer: () => UISlotRenderer
+  UISlotRenderer: () => UISlotRenderer,
+  renderPatternValue: () => renderPatternValue
 });
 function SuspenseConfigProvider({
   config,
@@ -47673,6 +47850,9 @@ function enrichFormFields(fields, entityDef) {
           type: entityField.type,
           required: entityField.required ?? false
         };
+        if (entityField.description) {
+          enriched.hint = entityField.description;
+        }
         if (entityField.values && entityField.values.length > 0) {
           enriched.values = entityField.values;
         } else if (entityField.enumValues && entityField.enumValues.length > 0) {
@@ -47696,6 +47876,9 @@ function enrichFormFields(fields, entityDef) {
       if (entityField.required && !("required" in obj)) {
         enriched.required = true;
       }
+      if (entityField.description && !obj.hint && !obj.help) {
+        enriched.hint = entityField.description;
+      }
       if (!obj.values && !obj.options) {
         if (entityField.values && entityField.values.length > 0) {
           enriched.values = entityField.values;
@@ -47711,6 +47894,32 @@ function enrichFormFields(fields, entityDef) {
     return field;
   });
 }
+function enrichDetailFields(fields, entityDef) {
+  const fieldMap = new Map(entityDef.fields.map((f3) => [f3.name, f3]));
+  const metaFor = (name) => {
+    const entityField = fieldMap.get(name);
+    if (!entityField) return void 0;
+    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;
+    return meta;
+  };
+  return fields.map((field) => {
+    if (typeof field === "string") {
+      const meta = metaFor(field);
+      return meta ? { key: field, ...meta } : field;
+    }
+    if (field && typeof field === "object" && !Array.isArray(field) && !React85__default.isValidElement(field) && !(field instanceof Date)) {
+      const obj = field;
+      const fieldName = typeof obj.key === "string" ? obj.key : typeof obj.name === "string" ? obj.name : void 0;
+      if (!fieldName || obj.type) return field;
+      const meta = metaFor(fieldName);
+      return meta ? { ...obj, ...meta } : field;
+    }
+    return field;
+  });
+}
 function renderContainedPortal(t, slot, content, onDismiss) {
   const slotContent = /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait: content.sourceTrait, children: /* @__PURE__ */ jsx(SlotContentRenderer, { content, onDismiss }) });
   const slotId = `slot-${slot}`;
@@ -48220,6 +48429,24 @@ function isPatternConfig(value) {
   const record = value;
   return "type" in record && typeof record.type === "string" && getComponentForPattern$1(record.type) !== null;
 }
+function renderPatternValue(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "boolean" || typeof value === "function") return null;
+  if (typeof value === "number") return value;
+  if (typeof value === "string") return renderPatternChildren(value, () => {
+  });
+  if (value instanceof Date) return value.toLocaleString();
+  if (React85__default.isValidElement(value)) return value;
+  if (Array.isArray(value)) {
+    return value.map((item, index) => /* @__PURE__ */ jsx(React85__default.Fragment, { children: renderPatternValue(item) }, index));
+  }
+  if (isPatternConfig(value)) {
+    const { type, ...props } = value;
+    return renderPatternChildren({ type, props }, () => {
+    });
+  }
+  return null;
+}
 function isPlainConfigObject(value) {
   if (React85__default.isValidElement(value)) return false;
   if (value instanceof Date) return false;
@@ -48421,9 +48648,9 @@ function SlotContentRenderer({
         finalProps.fields = keys.map((k, i) => ({ name: k, variant: i === 0 ? "h4" : "body" }));
       }
     }
-    const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
-    if (isFormPattern && entityDef && Array.isArray(finalProps.fields) && finalProps.fields[0] !== "fn") {
-      finalProps.fields = enrichFormFields([...finalProps.fields], entityDef);
+    const fieldsContract = getPatternFieldsContract(content.pattern) ?? (getPatternDefinition(content.pattern) === null && content.pattern.includes("form") ? "form" : void 0);
+    if (fieldsContract && entityDef && Array.isArray(finalProps.fields) && finalProps.fields[0] !== "fn") {
+      finalProps.fields = fieldsContract === "form" ? enrichFormFields([...finalProps.fields], entityDef) : enrichDetailFields([...finalProps.fields], entityDef);
     }
     const acceptsChildren = PATTERNS_WITH_CHILDREN.has(content.pattern);
     return /* @__PURE__ */ jsx(
@@ -48533,7 +48760,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var scopeWrapLog, TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, 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;
 var init_UISlotRenderer = __esm({
   "components/core/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -48564,12 +48791,6 @@ var init_UISlotRenderer = __esm({
       modal: "form",
       drawer: "form"
     };
-    FORM_PATTERNS = /* @__PURE__ */ new Set([
-      "form",
-      "form-section",
-      "inline-edit-form",
-      "wizard-step"
-    ]);
     SELF_OVERLAY_PATTERNS = /* @__PURE__ */ new Set(["modal", "confirm-dialog"]);
     CONTENT_NODE_SLOTS = /* @__PURE__ */ new Set([
       "logo",
@@ -50442,11 +50663,11 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, routeP
       for (const orb of schema.orbitals) {
         for (const pageRef of orb.pages ?? []) {
           const name = typeof pageRef === "object" && pageRef !== null ? pageRef.name : void 0;
-          if (name === pageName) return orb.theme;
+          if (name === pageName) return orb.theme ?? schema.theme;
         }
       }
     }
-    return schema.orbitals[0]?.theme;
+    return schema.orbitals[0]?.theme ?? schema.theme;
   }, [schema, pageName]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(
     EntitySchemaProvider,