@almadar/ui 5.124.0 → 5.125.0

package/dist/renderer/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MappedPattern, C as ClientEffect, q as ClientEffectExecutorConfig, r as NotifyOptions, D as DataContext, s as DataResolution, S as SlotDefinition } from '../offline-executor-aRuNznZx.cjs';
-export { E as EventResponse, N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, O as OfflineExecutor, t as OfflineExecutorConfig, v as OfflineExecutorState, P as PendingSyncEffect, w as SlotType, a as UseOfflineExecutorOptions, U as UseOfflineExecutorResult, x as createOfflineExecutor, e as extractRouteParams, f as findPageByName, g as findPageByPath, h as getAllPages, i as getDefaultPage, m as matchPath, p as pathMatches, u as useActivePage, j as useInitPayload, k as useNavigateTo, l as useNavigation, n as useNavigationId, o as useNavigationState, y as useOfflineExecutor } from '../offline-executor-aRuNznZx.cjs';
+import { M as MappedPattern, C as ClientEffect, s as ClientEffectExecutorConfig, t as NotifyOptions, D as DataContext, v as DataResolution, S as SlotDefinition } from '../offline-executor-Qz4b6GpF.cjs';
+export { E as EventResponse, N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, O as OfflineExecutor, w as OfflineExecutorConfig, x as OfflineExecutorState, P as PendingSyncEffect, y as SlotType, a as UseOfflineExecutorOptions, U as UseOfflineExecutorResult, e as comparePathSpecificity, z as createOfflineExecutor, f as extractRouteParams, g as findPageByName, h as findPageByPath, i as getAllPages, j as getDefaultPage, m as matchPath, k as matchPathAmong, p as pathMatches, u as useActivePage, l as useInitPayload, n as useNavigateTo, o as useNavigation, q as useNavigationId, r as useNavigationState, A as useOfflineExecutor } from '../offline-executor-Qz4b6GpF.cjs';
 import { PatternPropDef } from '@almadar/core/patterns';
 import { PatternConfig, FieldValue, EntityRow, UISlot } from '@almadar/core';
 export { PatternConfig, UISlot } from '@almadar/core';

package/dist/renderer/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MappedPattern, C as ClientEffect, q as ClientEffectExecutorConfig, r as NotifyOptions, D as DataContext, s as DataResolution, S as SlotDefinition } from '../offline-executor-aRuNznZx.js';
-export { E as EventResponse, N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, O as OfflineExecutor, t as OfflineExecutorConfig, v as OfflineExecutorState, P as PendingSyncEffect, w as SlotType, a as UseOfflineExecutorOptions, U as UseOfflineExecutorResult, x as createOfflineExecutor, e as extractRouteParams, f as findPageByName, g as findPageByPath, h as getAllPages, i as getDefaultPage, m as matchPath, p as pathMatches, u as useActivePage, j as useInitPayload, k as useNavigateTo, l as useNavigation, n as useNavigationId, o as useNavigationState, y as useOfflineExecutor } from '../offline-executor-aRuNznZx.js';
+import { M as MappedPattern, C as ClientEffect, s as ClientEffectExecutorConfig, t as NotifyOptions, D as DataContext, v as DataResolution, S as SlotDefinition } from '../offline-executor-Qz4b6GpF.js';
+export { E as EventResponse, N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, O as OfflineExecutor, w as OfflineExecutorConfig, x as OfflineExecutorState, P as PendingSyncEffect, y as SlotType, a as UseOfflineExecutorOptions, U as UseOfflineExecutorResult, e as comparePathSpecificity, z as createOfflineExecutor, f as extractRouteParams, g as findPageByName, h as findPageByPath, i as getAllPages, j as getDefaultPage, m as matchPath, k as matchPathAmong, p as pathMatches, u as useActivePage, l as useInitPayload, n as useNavigateTo, o as useNavigation, q as useNavigationId, r as useNavigationState, A as useOfflineExecutor } from '../offline-executor-Qz4b6GpF.js';
 import { PatternPropDef } from '@almadar/core/patterns';
 import { PatternConfig, FieldValue, EntityRow, UISlot } from '@almadar/core';
 export { PatternConfig, UISlot } from '@almadar/core';

package/dist/renderer/index.js

@@ -1,6 +1,6 @@
 import { createLogger } from '@almadar/logger';
 import { createContext, useRef, useCallback, useEffect, useContext, useState } from 'react';
-export { NavigationProvider, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, matchPath, pathMatches, useActivePage, useInitPayload, useNavigateTo, useNavigation, useNavigationId, useNavigationState } from '@almadar/ui/providers';
+export { NavigationProvider, comparePathSpecificity, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, matchPath, matchPathAmong, pathMatches, useActivePage, useInitPayload, useNavigateTo, useNavigation, useNavigationId, useNavigationState } from '@almadar/ui/providers';
 import { componentMapping as componentMapping$1, patternsRegistry } from '@almadar/core/patterns';
 
 var __defProp = Object.defineProperty;

package/dist/runtime/index.cjs

@@ -22869,13 +22869,13 @@ function DataGrid({
                         }
                       ),
                       /* @__PURE__ */ jsxRuntime.jsxs(VStack, { gap: "xs", className: "flex-1 min-w-0", children: [
-                        titleValue !== void 0 && titleValue !== null && /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "items-center", children: [
+                        titleValue !== void 0 && titleValue !== null && /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx(
                             Typography,
                             {
                               variant: titleField?.variant === "h3" ? "h3" : "h4",
-                              className: "font-semibold truncate",
+                              className: "font-semibold truncate min-w-0",
                               children: String(titleValue)
                             }
                           )
@@ -22933,7 +22933,7 @@ function DataGrid({
                         )
                       ] }, field.name);
                     }) }) }),
-                    primaryActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "px-4 py-3 mt-auto border-t border-border", children: /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "sm", className: "justify-end", children: [
+                    primaryActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "px-4 py-3 mt-auto border-t border-border", children: /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "sm", className: "justify-end flex-wrap", children: [
                       (maxInlineActions != null ? primaryActions.slice(0, maxInlineActions) : primaryActions).map((action, idx) => /* @__PURE__ */ jsxRuntime.jsxs(
                         Button,
                         {
@@ -27882,7 +27882,7 @@ function TableView({
             col.key
           );
         }),
-        hasActions && /* @__PURE__ */ jsxRuntime.jsx(Box, { "aria-hidden": true })
+        hasActions && /* @__PURE__ */ jsxRuntime.jsx(Box, { "aria-hidden": true, className: "sticky right-0 bg-[var(--color-surface-subtle)]" })
       ]
     }
   );
@@ -27926,41 +27926,54 @@ function TableView({
             }
             return /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate", children: formatCell(raw, col.format) }) }, col.key);
           }),
-          itemActions && itemActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", className: "justify-end flex-shrink-0 opacity-60 group-hover:opacity-100 transition-opacity", children: [
-            (maxInlineActions != null ? itemActions.slice(0, maxInlineActions) : itemActions).map((action, i) => /* @__PURE__ */ jsxRuntime.jsxs(
-              Button,
-              {
-                variant: action.variant ?? "ghost",
-                size: "sm",
-                onClick: handleActionClick(action, row),
-                "data-testid": `action-${action.event}`,
-                "data-row-id": String(row.id),
-                className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
-                children: [
-                  action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
-                  action.label
-                ]
-              },
-              i
-            )),
-            maxInlineActions != null && itemActions.length > maxInlineActions && /* @__PURE__ */ jsxRuntime.jsx(
-              Menu,
-              {
-                position: "bottom-end",
-                trigger: /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
-                items: itemActions.slice(maxInlineActions).map((action) => ({
-                  label: action.label,
-                  icon: action.icon,
-                  event: action.event,
-                  variant: action.variant === "danger" ? "danger" : "default",
-                  onClick: () => eventBus.emit(`UI:${action.event}`, {
-                    id: row.id,
-                    row
-                  })
-                }))
-              }
-            )
-          ] })
+          itemActions && itemActions.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs(
+            HStack,
+            {
+              gap: "xs",
+              className: cn(
+                // Pinned: the fixed column tracks routinely overflow the caller's
+                // scroll container, which used to leave the actions off-screen.
+                // Opaque so scrolled cells pass underneath it.
+                "justify-end flex-shrink-0 sticky right-0 z-[1] transition-colors",
+                lk.striped && index % 2 === 1 ? "bg-[var(--color-surface-subtle)]" : "bg-[var(--color-card)] group-hover:bg-[var(--color-surface-subtle)]"
+              ),
+              children: [
+                (maxInlineActions != null ? itemActions.slice(0, maxInlineActions) : itemActions).map((action, i) => /* @__PURE__ */ jsxRuntime.jsxs(
+                  Button,
+                  {
+                    variant: action.variant ?? "ghost",
+                    size: "sm",
+                    onClick: handleActionClick(action, row),
+                    "data-testid": `action-${action.event}`,
+                    "data-row-id": String(row.id),
+                    className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
+                    children: [
+                      action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
+                      action.label
+                    ]
+                  },
+                  i
+                )),
+                maxInlineActions != null && itemActions.length > maxInlineActions && /* @__PURE__ */ jsxRuntime.jsx(
+                  Menu,
+                  {
+                    position: "bottom-end",
+                    trigger: /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
+                    items: itemActions.slice(maxInlineActions).map((action) => ({
+                      label: action.label,
+                      icon: action.icon,
+                      event: action.event,
+                      variant: action.variant === "danger" ? "danger" : "default",
+                      onClick: () => eventBus.emit(`UI:${action.event}`, {
+                        id: row.id,
+                        row
+                      })
+                    }))
+                  }
+                )
+              ]
+            }
+          )
         ]
       }
     );
@@ -36557,6 +36570,16 @@ function normalizeFieldDefs(fields) {
     return String(f3);
   });
 }
+function buildFieldLabelMap(fields) {
+  const map = {};
+  if (!fields) return map;
+  for (const f3 of fields) {
+    if (typeof f3 === "object" && "key" in f3 && f3.header !== void 0 && f3.header !== "") {
+      map[f3.key] = f3.header;
+    }
+  }
+  return map;
+}
 function buildFieldTypeMap(fields) {
   const map = {};
   if (!fields) return map;
@@ -36608,6 +36631,8 @@ var init_DetailPanel = __esm({
       };
       const effectiveFieldNames = isFieldDefArray(propFields) ? normalizeFieldDefs(propFields) : fieldNames;
       const fieldTypeMap = isFieldDefArray(propFields) ? buildFieldTypeMap(propFields) : {};
+      const fieldLabelMap = isFieldDefArray(propFields) ? buildFieldLabelMap(propFields) : {};
+      const labelFor = (field) => fieldLabelMap[field] ?? formatFieldLabel(field);
       const handleActionClick = React82.useCallback(
         (action, data2) => {
           if (action.navigatesTo) {
@@ -36643,7 +36668,7 @@ var init_DetailPanel = __esm({
             if (typeof field === "string") {
               const value = getNestedValue(normalizedData, field);
               return {
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: formatFieldValue(value, field),
                 icon: getFieldIcon(field)
               };
@@ -36654,7 +36679,10 @@ var init_DetailPanel = __esm({
       }
       if (normalizedData && effectiveFieldNames) {
         const primaryField = effectiveFieldNames[0];
-        if (!title && primaryField && normalizedData[primaryField]) {
+        const titleDerivedFromPrimary = Boolean(
+          !title && primaryField && normalizedData[primaryField]
+        );
+        if (titleDerivedFromPrimary) {
           title = String(normalizedData[primaryField]);
         }
         const statusFields = effectiveFieldNames.filter(
@@ -36673,16 +36701,16 @@ var init_DetailPanel = __esm({
           (f3) => f3.toLowerCase().includes("description") || f3.toLowerCase().includes("note")
         );
         const otherFields = effectiveFieldNames.filter(
-          (f3) => f3 !== primaryField && !statusFields.includes(f3) && !progressFields.includes(f3) && !metricFields.includes(f3) && !dateFields.includes(f3) && !descriptionFields.includes(f3)
+          (f3) => (!titleDerivedFromPrimary || f3 !== primaryField) && !statusFields.includes(f3) && !progressFields.includes(f3) && !metricFields.includes(f3) && !dateFields.includes(f3) && !descriptionFields.includes(f3)
         );
         sections = [];
         if (statusFields.length > 0 || otherFields.length > 0) {
           const overviewFields = [];
-          [...statusFields, ...otherFields.slice(0, 3)].forEach((field) => {
+          [...statusFields, ...otherFields].forEach((field) => {
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               overviewFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36698,7 +36726,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               metricsFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36714,7 +36742,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               timelineFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36730,7 +36758,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               descFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36778,7 +36806,7 @@ var init_DetailPanel = __esm({
             if (typeof field === "string") {
               const value = normalizedData ? getNestedValue(normalizedData, field) : void 0;
               allFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -45908,11 +45936,9 @@ function OrbPreview({
   }, [parsedSchema]);
   const initialPageMatch = React82.useMemo(() => {
     if (!initialPagePath) return void 0;
-    for (const { page } of pages) {
-      const params = page.path ? providers.matchPath(page.path, initialPagePath) : null;
-      if (params !== null) return { name: page.name, params };
-    }
-    return void 0;
+    const hit = providers.matchPathAmong(pages, initialPagePath, (entry) => entry.page.path);
+    if (!hit) return void 0;
+    return { name: hit.candidate.page.name, params: hit.params };
   }, [pages, initialPagePath]);
   const initialPageName = initialPageMatch?.name;
   const [currentPage, setCurrentPage] = React82.useState(initialPageName);
@@ -45926,16 +45952,9 @@ function OrbPreview({
     }
   }, [initialPagePath, initialPageName, initialPageMatch]);
   const handleNavigate = React82.useCallback((path) => {
-    let match;
-    let params = {};
-    for (const entry of pages) {
-      const m = entry.page.path ? providers.matchPath(entry.page.path, path) : null;
-      if (m !== null) {
-        match = entry;
-        params = m;
-        break;
-      }
-    }
+    const hit = providers.matchPathAmong(pages, path, (entry) => entry.page.path);
+    const match = hit?.candidate;
+    const params = hit?.params ?? {};
     navLog.debug("handleNavigate", () => ({
       path,
       matched: match?.page.name ?? null,

package/dist/runtime/index.js

@@ -1,6 +1,6 @@
 import * as React82 from 'react';
 import React82__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useSyncExternalStore, useLayoutEffect, lazy, useId } from 'react';
-import { EventBusContext, useTraitScopeChain, useEntitySchemaOptional, useEntitySchema, getAllPages, matchPath, OrbitalProvider, TraitScopeProvider, ServerBridgeProvider, useCurrentPagePath, useGameAudioContextOptional, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScopeChain, useEntitySchemaOptional, useEntitySchema, getAllPages, matchPathAmong, OrbitalProvider, TraitScopeProvider, ServerBridgeProvider, useCurrentPagePath, useGameAudioContextOptional, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge } 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 { clsx } from 'clsx';
@@ -22795,13 +22795,13 @@ function DataGrid({
                         }
                       ),
                       /* @__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", children: [
+                        titleValue !== void 0 && titleValue !== null && /* @__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",
+                              className: "font-semibold truncate min-w-0",
                               children: String(titleValue)
                             }
                           )
@@ -22859,7 +22859,7 @@ function DataGrid({
                         )
                       ] }, field.name);
                     }) }) }),
-                    primaryActions.length > 0 && /* @__PURE__ */ jsx(Box, { className: "px-4 py-3 mt-auto border-t border-border", children: /* @__PURE__ */ jsxs(HStack, { gap: "sm", className: "justify-end", children: [
+                    primaryActions.length > 0 && /* @__PURE__ */ jsx(Box, { className: "px-4 py-3 mt-auto border-t border-border", children: /* @__PURE__ */ jsxs(HStack, { gap: "sm", className: "justify-end flex-wrap", children: [
                       (maxInlineActions != null ? primaryActions.slice(0, maxInlineActions) : primaryActions).map((action, idx) => /* @__PURE__ */ jsxs(
                         Button,
                         {
@@ -27808,7 +27808,7 @@ function TableView({
             col.key
           );
         }),
-        hasActions && /* @__PURE__ */ jsx(Box, { "aria-hidden": true })
+        hasActions && /* @__PURE__ */ jsx(Box, { "aria-hidden": true, className: "sticky right-0 bg-[var(--color-surface-subtle)]" })
       ]
     }
   );
@@ -27852,41 +27852,54 @@ function TableView({
             }
             return /* @__PURE__ */ jsx(Box, { role: "cell", className: cellBase, children: /* @__PURE__ */ jsx("span", { className: "truncate", children: formatCell(raw, col.format) }) }, col.key);
           }),
-          itemActions && itemActions.length > 0 && /* @__PURE__ */ jsxs(HStack, { gap: "xs", className: "justify-end flex-shrink-0 opacity-60 group-hover:opacity-100 transition-opacity", children: [
-            (maxInlineActions != null ? itemActions.slice(0, maxInlineActions) : itemActions).map((action, i) => /* @__PURE__ */ jsxs(
-              Button,
-              {
-                variant: action.variant ?? "ghost",
-                size: "sm",
-                onClick: handleActionClick(action, row),
-                "data-testid": `action-${action.event}`,
-                "data-row-id": String(row.id),
-                className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
-                children: [
-                  action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
-                  action.label
-                ]
-              },
-              i
-            )),
-            maxInlineActions != null && itemActions.length > maxInlineActions && /* @__PURE__ */ jsx(
-              Menu,
-              {
-                position: "bottom-end",
-                trigger: /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
-                items: itemActions.slice(maxInlineActions).map((action) => ({
-                  label: action.label,
-                  icon: action.icon,
-                  event: action.event,
-                  variant: action.variant === "danger" ? "danger" : "default",
-                  onClick: () => eventBus.emit(`UI:${action.event}`, {
-                    id: row.id,
-                    row
-                  })
-                }))
-              }
-            )
-          ] })
+          itemActions && itemActions.length > 0 && /* @__PURE__ */ jsxs(
+            HStack,
+            {
+              gap: "xs",
+              className: cn(
+                // Pinned: the fixed column tracks routinely overflow the caller's
+                // scroll container, which used to leave the actions off-screen.
+                // Opaque so scrolled cells pass underneath it.
+                "justify-end flex-shrink-0 sticky right-0 z-[1] transition-colors",
+                lk.striped && index % 2 === 1 ? "bg-[var(--color-surface-subtle)]" : "bg-[var(--color-card)] group-hover:bg-[var(--color-surface-subtle)]"
+              ),
+              children: [
+                (maxInlineActions != null ? itemActions.slice(0, maxInlineActions) : itemActions).map((action, i) => /* @__PURE__ */ jsxs(
+                  Button,
+                  {
+                    variant: action.variant ?? "ghost",
+                    size: "sm",
+                    onClick: handleActionClick(action, row),
+                    "data-testid": `action-${action.event}`,
+                    "data-row-id": String(row.id),
+                    className: cn(action.variant === "danger" && "text-error hover:bg-error/10"),
+                    children: [
+                      action.icon && renderIconInput3(action.icon, { size: "xs", className: "mr-1" }),
+                      action.label
+                    ]
+                  },
+                  i
+                )),
+                maxInlineActions != null && itemActions.length > maxInlineActions && /* @__PURE__ */ jsx(
+                  Menu,
+                  {
+                    position: "bottom-end",
+                    trigger: /* @__PURE__ */ jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
+                    items: itemActions.slice(maxInlineActions).map((action) => ({
+                      label: action.label,
+                      icon: action.icon,
+                      event: action.event,
+                      variant: action.variant === "danger" ? "danger" : "default",
+                      onClick: () => eventBus.emit(`UI:${action.event}`, {
+                        id: row.id,
+                        row
+                      })
+                    }))
+                  }
+                )
+              ]
+            }
+          )
         ]
       }
     );
@@ -36483,6 +36496,16 @@ function normalizeFieldDefs(fields) {
     return String(f3);
   });
 }
+function buildFieldLabelMap(fields) {
+  const map = {};
+  if (!fields) return map;
+  for (const f3 of fields) {
+    if (typeof f3 === "object" && "key" in f3 && f3.header !== void 0 && f3.header !== "") {
+      map[f3.key] = f3.header;
+    }
+  }
+  return map;
+}
 function buildFieldTypeMap(fields) {
   const map = {};
   if (!fields) return map;
@@ -36534,6 +36557,8 @@ var init_DetailPanel = __esm({
       };
       const effectiveFieldNames = isFieldDefArray(propFields) ? normalizeFieldDefs(propFields) : fieldNames;
       const fieldTypeMap = isFieldDefArray(propFields) ? buildFieldTypeMap(propFields) : {};
+      const fieldLabelMap = isFieldDefArray(propFields) ? buildFieldLabelMap(propFields) : {};
+      const labelFor = (field) => fieldLabelMap[field] ?? formatFieldLabel(field);
       const handleActionClick = useCallback(
         (action, data2) => {
           if (action.navigatesTo) {
@@ -36569,7 +36594,7 @@ var init_DetailPanel = __esm({
             if (typeof field === "string") {
               const value = getNestedValue(normalizedData, field);
               return {
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: formatFieldValue(value, field),
                 icon: getFieldIcon(field)
               };
@@ -36580,7 +36605,10 @@ var init_DetailPanel = __esm({
       }
       if (normalizedData && effectiveFieldNames) {
         const primaryField = effectiveFieldNames[0];
-        if (!title && primaryField && normalizedData[primaryField]) {
+        const titleDerivedFromPrimary = Boolean(
+          !title && primaryField && normalizedData[primaryField]
+        );
+        if (titleDerivedFromPrimary) {
           title = String(normalizedData[primaryField]);
         }
         const statusFields = effectiveFieldNames.filter(
@@ -36599,16 +36627,16 @@ var init_DetailPanel = __esm({
           (f3) => f3.toLowerCase().includes("description") || f3.toLowerCase().includes("note")
         );
         const otherFields = effectiveFieldNames.filter(
-          (f3) => f3 !== primaryField && !statusFields.includes(f3) && !progressFields.includes(f3) && !metricFields.includes(f3) && !dateFields.includes(f3) && !descriptionFields.includes(f3)
+          (f3) => (!titleDerivedFromPrimary || f3 !== primaryField) && !statusFields.includes(f3) && !progressFields.includes(f3) && !metricFields.includes(f3) && !dateFields.includes(f3) && !descriptionFields.includes(f3)
         );
         sections = [];
         if (statusFields.length > 0 || otherFields.length > 0) {
           const overviewFields = [];
-          [...statusFields, ...otherFields.slice(0, 3)].forEach((field) => {
+          [...statusFields, ...otherFields].forEach((field) => {
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               overviewFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36624,7 +36652,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               metricsFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36640,7 +36668,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               timelineFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36656,7 +36684,7 @@ var init_DetailPanel = __esm({
             const value = getNestedValue(normalizedData, field);
             if (value !== void 0 && value !== null) {
               descFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -36704,7 +36732,7 @@ var init_DetailPanel = __esm({
             if (typeof field === "string") {
               const value = normalizedData ? getNestedValue(normalizedData, field) : void 0;
               allFields.push({
-                label: formatFieldLabel(field),
+                label: labelFor(field),
                 value: renderRichFieldValue(value, field, fieldTypeMap[field]),
                 icon: getFieldIcon(field)
               });
@@ -45834,11 +45862,9 @@ function OrbPreview({
   }, [parsedSchema]);
   const initialPageMatch = useMemo(() => {
     if (!initialPagePath) return void 0;
-    for (const { page } of pages) {
-      const params = page.path ? matchPath(page.path, initialPagePath) : null;
-      if (params !== null) return { name: page.name, params };
-    }
-    return void 0;
+    const hit = matchPathAmong(pages, initialPagePath, (entry) => entry.page.path);
+    if (!hit) return void 0;
+    return { name: hit.candidate.page.name, params: hit.params };
   }, [pages, initialPagePath]);
   const initialPageName = initialPageMatch?.name;
   const [currentPage, setCurrentPage] = useState(initialPageName);
@@ -45852,16 +45878,9 @@ function OrbPreview({
     }
   }, [initialPagePath, initialPageName, initialPageMatch]);
   const handleNavigate = useCallback((path) => {
-    let match;
-    let params = {};
-    for (const entry of pages) {
-      const m = entry.page.path ? matchPath(entry.page.path, path) : null;
-      if (m !== null) {
-        match = entry;
-        params = m;
-        break;
-      }
-    }
+    const hit = matchPathAmong(pages, path, (entry) => entry.page.path);
+    const match = hit?.candidate;
+    const params = hit?.params ?? {};
     navLog.debug("handleNavigate", () => ({
       path,
       matched: match?.page.name ?? null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.124.0",
+  "version": "5.125.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -117,12 +117,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.33.0",
-    "@almadar/evaluator": "^2.34.0",
-    "@almadar/logger": "^1.9.0",
-    "@almadar/runtime": "^6.36.0",
-    "@almadar/std": "^16.143.0",
-    "@almadar/syntax": "^1.11.0",
+    "@almadar/core": "^10.34.0",
+    "@almadar/evaluator": "^2.35.0",
+    "@almadar/logger": "^1.10.0",
+    "@almadar/runtime": "^6.37.0",
+    "@almadar/std": "^16.144.0",
+    "@almadar/syntax": "^1.12.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -208,9 +208,10 @@
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",
     "turbo": "^2.8.17",
-    "typescript": "^5.4.0",
     "vite": "^5.2.0",
-    "vitest": "^3.2.6"
+    "vitest": "^3.2.6",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "typescript": "npm:@typescript/typescript6@^6.0.2"
   },
   "repository": {
     "type": "git",