@almadar/ui 5.153.0 → 5.154.0

package/dist/hooks/index.d.ts

@@ -4,6 +4,7 @@ import { a as useEventBus } from '../useEventBus-CQWyAWpK.js';
 export { u as useEmitEvent, b as useEventListener } from '../useEventBus-CQWyAWpK.js';
 export { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
 export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, b as SlotContent, c as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-GNwGLlW2.js';
+export { a as NavStackApi, u as useNavStack } from '../NavStackContext-BoVV9nWb.js';
 import * as React$1 from 'react';
 import React__default from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';

package/dist/hooks/index.js

@@ -1,6 +1,7 @@
 import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
 import { createLogger } from '@almadar/logger';
 import { EventBusContext, useTraitScopeChain } from '@almadar/ui/providers';
+export { useNavStack } from '@almadar/ui/providers';
 import { mergeEntityFrame } from '@almadar/core';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 

package/dist/providers/index.cjs

@@ -21400,17 +21400,27 @@ var init_Breadcrumb = __esm({
     init_useEventBus();
     Breadcrumb = ({
       items,
+      fromNavStack = false,
+      itemEvent,
       separator = "chevron-right",
       maxItems,
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = hooks.useTranslate();
-      const displayItems = maxItems && items.length > maxItems ? [
-        ...items.slice(0, 1),
+      const navStack = providers.useNavStack();
+      const sourceItems = fromNavStack ? navStack.entries.map((entry, i) => ({
+        label: entry.label,
+        path: entry.href,
+        isCurrent: i === navStack.entries.length - 1,
+        event: itemEvent
+      })) : items ?? [];
+      if (fromNavStack && sourceItems.length === 0) return null;
+      const displayItems = maxItems && sourceItems.length > maxItems ? [
+        ...sourceItems.slice(0, 1),
         { label: "...", isCurrent: false },
-        ...items.slice(-maxItems + 1)
-      ] : items;
+        ...sourceItems.slice(-maxItems + 1)
+      ] : sourceItems;
       return /* @__PURE__ */ jsxRuntime.jsx(
         "nav",
         {
@@ -21420,7 +21430,7 @@ var init_Breadcrumb = __esm({
             const isLast = index === displayItems.length - 1;
             const isEllipsis = item.label === "...";
             return /* @__PURE__ */ jsxRuntime.jsxs("li", { className: "flex items-center gap-2", children: [
-              isEllipsis ? /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "muted", children: item.label }) : item.href || item.path ? /* @__PURE__ */ jsxRuntime.jsxs(
+              isEllipsis ? /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "muted", children: item.label }) : (item.href || item.path) && !item.event && !fromNavStack ? /* @__PURE__ */ jsxRuntime.jsxs(
                 "a",
                 {
                   href: item.href || item.path,
@@ -21446,7 +21456,12 @@ var init_Breadcrumb = __esm({
                 {
                   type: "button",
                   onClick: () => {
-                    if (item.event) eventBus.emit(`UI:${item.event}`, { label: item.label });
+                    const href = item.path ?? item.href;
+                    if (item.event) {
+                      eventBus.emit(`UI:${item.event}`, { label: item.label, href, index });
+                    } else if (fromNavStack && href) {
+                      navStack.goTo(href);
+                    }
                     item.onClick?.();
                   },
                   className: cn(
@@ -32041,13 +32056,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect64, useRef: useRef63, useCallback: useCallback96, useState: useState94 } = React87__namespace.default;
+      const { useEffect: useEffect65, useRef: useRef64, useCallback: useCallback97, useState: useState95 } = React87__namespace.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 });
-        useEffect64(() => {
+        const prevRef = useRef64({ centerLat, centerLng, zoom });
+        useEffect65(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -32058,7 +32073,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect64(() => {
+        useEffect65(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -32086,8 +32101,8 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState94(null);
-        const handleMapClick = useCallback96((lat, lng) => {
+        const [clickedPosition, setClickedPosition] = useState95(null);
+        const handleMapClick = useCallback97((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -32096,7 +32111,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback96((marker) => {
+        const handleMarkerClick = useCallback97((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -42328,6 +42343,7 @@ var init_DetailPanel = __esm({
     init_Box();
     init_Stack();
     init_SimpleGrid();
+    init_Menu();
     init_LoadingState();
     init_ErrorState();
     init_EmptyState();
@@ -42345,6 +42361,7 @@ var init_DetailPanel = __esm({
       avatar,
       sections: propSections,
       actions,
+      maxInlineActions,
       backAction,
       footer,
       slideOver = false,
@@ -42579,7 +42596,7 @@ var init_DetailPanel = __esm({
             }
           ) }),
           /* @__PURE__ */ jsxRuntime.jsxs(HStack, { justify: "end", align: "center", gap: "xs", children: [
-            otherActions.map((action, idx) => /* @__PURE__ */ jsxRuntime.jsx(
+            (maxInlineActions != null ? otherActions.slice(0, maxInlineActions) : otherActions).map((action, idx) => /* @__PURE__ */ jsxRuntime.jsx(
               Button,
               {
                 variant: action.variant || "secondary",
@@ -42594,6 +42611,22 @@ var init_DetailPanel = __esm({
               },
               idx
             )),
+            maxInlineActions != null && otherActions.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: otherActions.slice(maxInlineActions).map((action) => ({
+                  // ONE firing path: onClick → handleActionClick (emits with
+                  // the {id, row} payload). Passing `event` too would make
+                  // Menu emit a second, payload-less copy of the same event.
+                  label: action.label,
+                  icon: action.icon,
+                  variant: action.variant === "danger" ? "danger" : "default",
+                  onClick: () => handleActionClick(action, normalizedData)
+                }))
+              }
+            ),
             /* @__PURE__ */ jsxRuntime.jsx(
               Button,
               {
@@ -51218,12 +51251,18 @@ function ServerBridgeProvider({
           } else if (effectType === "navigate") {
             const route = effect[1];
             const rawParams = effect[2];
+            const rawOptions = effect[3];
+            const optionsObj = rawOptions !== null && rawOptions !== void 0 && typeof rawOptions === "object" && !Array.isArray(rawOptions) ? rawOptions : void 0;
+            const crumb = typeof optionsObj?.crumb === "string" ? optionsObj.crumb : void 0;
             effects.push({
               type: "navigate",
               route,
               params: rawParams !== null && rawParams !== void 0 && typeof rawParams === "object" && !Array.isArray(rawParams) ? rawParams : void 0,
+              crumb,
               traitName
             });
+          } else if (effectType === "navigate-back") {
+            effects.push({ type: "navigate-back", traitName });
           } else if (effectType === "notify") {
             const message = effect[1];
             effects.push({ type: "notify", message: typeof message === "string" ? message : void 0, traitName });
@@ -51488,6 +51527,170 @@ function GameAudioProvider2({
   return /* @__PURE__ */ jsxRuntime.jsx(GameAudioContext2.Provider, { value, children });
 }
 GameAudioProvider2.displayName = "GameAudioProvider";
+function derivePageLabel(name) {
+  const stripped = name.endsWith("Page") && name.length > 4 ? name.slice(0, -4) : name;
+  return stripped.replace(/([a-z0-9])([A-Z])/g, "$1 $2");
+}
+function normalizePath(p) {
+  let normalized = p.trim();
+  if (!normalized.startsWith("/")) normalized = "/" + normalized;
+  if (normalized.length > 1 && normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  return normalized;
+}
+function matchNavPage(pages, path) {
+  const hit = providers.matchPathAmong(pages, path, (p) => p.path);
+  return hit ? hit.candidate : null;
+}
+function seedAncestors(pages, path) {
+  const segments = normalizePath(path).split("/").filter(Boolean);
+  const ancestors = [];
+  for (let depth = 1; depth < segments.length; depth++) {
+    const prefix = "/" + segments.slice(0, depth).join("/");
+    const page = matchNavPage(pages, prefix);
+    if (page) {
+      ancestors.push({ href: prefix, label: derivePageLabel(page.name) });
+    }
+  }
+  return ancestors;
+}
+function syncNavStack(state, pages, path, pending) {
+  const normalized = normalizePath(path);
+  const page = matchNavPage(pages, normalized);
+  if (!page) return { state, orbital: null };
+  const label = pending && normalizePath(pending.href) === normalized ? pending.crumb : derivePageLabel(page.name);
+  const prior = state[page.orbital];
+  const stack = prior && prior.length > 0 ? [...prior] : seedAncestors(pages, normalized);
+  const existing = stack.findIndex((e) => e.href === normalized);
+  if (existing >= 0) {
+    stack.length = existing + 1;
+    if (pending && normalizePath(pending.href) === normalized) {
+      stack[existing] = { href: normalized, label };
+    }
+  } else {
+    stack.push({ href: normalized, label });
+  }
+  return { state: { ...state, [page.orbital]: stack }, orbital: page.orbital };
+}
+function previousEntry(state, pages, path) {
+  const page = matchNavPage(pages, normalizePath(path));
+  if (!page) return null;
+  const stack = state[page.orbital] ?? [];
+  return stack.length >= 2 ? stack[stack.length - 2] : null;
+}
+function entriesFor(state, pages, path) {
+  const page = matchNavPage(pages, normalizePath(path));
+  if (!page) return [];
+  return state[page.orbital] ?? [];
+}
+var INERT_API = {
+  entries: [],
+  canGoBack: false,
+  beginNavigate: () => void 0,
+  back: () => void 0,
+  goTo: () => void 0
+};
+var NavStackContext = React87.createContext(INERT_API);
+function useNavStack2() {
+  return React87.useContext(NavStackContext);
+}
+function loadStored(storageKey) {
+  if (!storageKey) return {};
+  try {
+    const raw = window.sessionStorage.getItem(storageKey);
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
+function persistStored(storageKey, state) {
+  if (!storageKey) return;
+  try {
+    window.sessionStorage.setItem(storageKey, JSON.stringify(state));
+  } catch {
+  }
+}
+var NavStackProvider = ({
+  pages,
+  currentPath,
+  navigate,
+  storageKey,
+  children
+}) => {
+  const [state, setState] = React87.useState(() => loadStored(storageKey));
+  const pendingCrumbRef = React87.useRef(null);
+  const stateRef = React87.useRef(state);
+  stateRef.current = state;
+  React87.useEffect(() => {
+    const pending = pendingCrumbRef.current;
+    pendingCrumbRef.current = null;
+    setState((prev) => {
+      const next = syncNavStack(prev, pages, currentPath, pending);
+      if (next.state !== prev) persistStored(storageKey, next.state);
+      return next.state;
+    });
+  }, [currentPath, pages, storageKey]);
+  const beginNavigate = React87.useCallback((href, crumb) => {
+    pendingCrumbRef.current = crumb !== void 0 && crumb !== "" ? { href, crumb } : null;
+  }, []);
+  const back = React87.useCallback(() => {
+    const prev = previousEntry(stateRef.current, pages, currentPath);
+    if (prev) navigate(prev.href);
+  }, [pages, currentPath, navigate]);
+  const goTo = React87.useCallback(
+    (href) => {
+      navigate(href);
+    },
+    [navigate]
+  );
+  const entries = React87.useMemo(
+    () => entriesFor(state, pages, currentPath),
+    [state, pages, currentPath]
+  );
+  const api = React87.useMemo(
+    () => ({
+      entries,
+      canGoBack: previousEntry(state, pages, currentPath) !== null,
+      beginNavigate,
+      back,
+      goTo
+    }),
+    [entries, state, pages, currentPath, beginNavigate, back, goTo]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(NavStackContext.Provider, { value: api, children });
+};
+NavStackProvider.displayName = "NavStackProvider";
+var NavStackRouterBridge = ({
+  pages,
+  storageKey = "almadar:navstack",
+  children
+}) => {
+  const location = reactRouterDom.useLocation();
+  const routerNavigate = reactRouterDom.useNavigate();
+  const navigate = React87.useCallback(
+    (path) => {
+      routerNavigate(path);
+    },
+    [routerNavigate]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    NavStackProvider,
+    {
+      pages,
+      currentPath: location.pathname,
+      navigate,
+      storageKey,
+      children
+    }
+  );
+};
+NavStackRouterBridge.displayName = "NavStackRouterBridge";
 
 Object.defineProperty(exports, "ANONYMOUS_USER", {
   enumerable: true,
@@ -51509,6 +51712,8 @@ exports.EventBusContext = EventBusContext2;
 exports.EventBusProvider = EventBusProvider;
 exports.GameAudioContext = GameAudioContext2;
 exports.GameAudioProvider = GameAudioProvider2;
+exports.NavStackProvider = NavStackProvider;
+exports.NavStackRouterBridge = NavStackRouterBridge;
 exports.NavigationProvider = NavigationProvider2;
 exports.OfflineModeProvider = OfflineModeProvider;
 exports.OrbitalProvider = OrbitalProvider;
@@ -51541,6 +51746,7 @@ exports.useGameAudioContextOptional = useGameAudioContextOptional2;
 exports.useHasPermission = useHasPermission;
 exports.useHasRole = useHasRole;
 exports.useInitPayload = useInitPayload2;
+exports.useNavStack = useNavStack2;
 exports.useNavigateTo = useNavigateTo2;
 exports.useNavigation = useNavigation2;
 exports.useNavigationId = useNavigationId2;

package/dist/providers/index.d.cts

@@ -3,11 +3,12 @@ import { EntityRow, SExpr } from '@almadar/core';
 export { ANONYMOUS_USER } from '@almadar/core';
 import { U as UIThemeDefinition, j as UserData } from '../UserContext-g_LcDiGN.cjs';
 export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.cjs';
-export { E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CD9ZoXb4.cjs';
+export { E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-BfZGeDfX.cjs';
 import { U as UseOfflineExecutorResult, a as UseOfflineExecutorOptions } from '../offline-executor-Qz4b6GpF.cjs';
 export { N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, e as comparePathSpecificity, 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 } from '../offline-executor-Qz4b6GpF.cjs';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
 export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-CQAdPreB.cjs';
+export { N as NavPageDecl, a as NavStackApi, b as NavStackProvider, c as NavStackProviderProps, d as NavStackRouterBridge, e as NavStackRouterBridgeProps, u as useNavStack } from '../NavStackContext-BoVV9nWb.cjs';
 import '@almadar/core/patterns';
 import '../types-B3nHgnMG.cjs';
 

package/dist/providers/index.d.ts

@@ -3,11 +3,12 @@ import { EntityRow, SExpr } from '@almadar/core';
 export { ANONYMOUS_USER } from '@almadar/core';
 import { U as UIThemeDefinition, j as UserData } from '../UserContext-g_LcDiGN.js';
 export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.js';
-export { E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CD9ZoXb4.js';
+export { E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-BfZGeDfX.js';
 import { U as UseOfflineExecutorResult, a as UseOfflineExecutorOptions } from '../offline-executor-Qz4b6GpF.js';
 export { N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, e as comparePathSpecificity, 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 } from '../offline-executor-Qz4b6GpF.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
 export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-B48iXwz3.js';
+export { N as NavPageDecl, a as NavStackApi, b as NavStackProvider, c as NavStackProviderProps, d as NavStackRouterBridge, e as NavStackRouterBridgeProps, u as useNavStack } from '../NavStackContext-BoVV9nWb.js';
 import '@almadar/core/patterns';
 import '../types-B3nHgnMG.js';