@almadar/ui 5.153.0 → 5.154.0

package/dist/{EntityBindingContext-CD9ZoXb4.d.cts → EntityBindingContext-BfZGeDfX.d.cts}

@@ -84,7 +84,7 @@ declare function useEntitySchema(): EntitySchemaContextValue;
 declare function useEntitySchemaOptional(): EntitySchemaContextValue | null;
 
 /** Wire-format client effect tuple from the server response. */
-type ClientEffectTuple = ['render-ui', string, AnyPatternConfig | null, ...SExpr[]] | ['navigate', string, ...SExpr[]] | ['notify', string, ...SExpr[]];
+type ClientEffectTuple = ['render-ui', string, AnyPatternConfig | null, ...SExpr[]] | ['navigate', string, ...SExpr[]] | ['navigate-back'] | ['notify', string, ...SExpr[]];
 interface OrbitalEventResponse {
     success: boolean;
     transitioned: boolean;
@@ -114,11 +114,13 @@ interface OrbitalEventResponse {
     error?: string;
 }
 interface ServerClientEffect {
-    type: 'render-ui' | 'navigate' | 'notify';
+    type: 'render-ui' | 'navigate' | 'navigate-back' | 'notify';
     slot?: string;
     pattern?: AnyPatternConfig;
     route?: string;
     params?: EventPayload;
+    /** Nav-stack entry label carried by the navigate effect's options. */
+    crumb?: string;
     message?: string;
     /**
      * Trait that emitted this effect. Used by `<TraitFrame>` to resolve

package/dist/{EntityBindingContext-CD9ZoXb4.d.ts → EntityBindingContext-BfZGeDfX.d.ts}

@@ -84,7 +84,7 @@ declare function useEntitySchema(): EntitySchemaContextValue;
 declare function useEntitySchemaOptional(): EntitySchemaContextValue | null;
 
 /** Wire-format client effect tuple from the server response. */
-type ClientEffectTuple = ['render-ui', string, AnyPatternConfig | null, ...SExpr[]] | ['navigate', string, ...SExpr[]] | ['notify', string, ...SExpr[]];
+type ClientEffectTuple = ['render-ui', string, AnyPatternConfig | null, ...SExpr[]] | ['navigate', string, ...SExpr[]] | ['navigate-back'] | ['notify', string, ...SExpr[]];
 interface OrbitalEventResponse {
     success: boolean;
     transitioned: boolean;
@@ -114,11 +114,13 @@ interface OrbitalEventResponse {
     error?: string;
 }
 interface ServerClientEffect {
-    type: 'render-ui' | 'navigate' | 'notify';
+    type: 'render-ui' | 'navigate' | 'navigate-back' | 'notify';
     slot?: string;
     pattern?: AnyPatternConfig;
     route?: string;
     params?: EventPayload;
+    /** Nav-stack entry label carried by the navigate effect's options. */
+    crumb?: string;
     message?: string;
     /**
      * Trait that emitted this effect. Used by `<TraitFrame>` to resolve

package/dist/NavStackContext-BoVV9nWb.d.cts

@@ -0,0 +1,83 @@
+import React__default from 'react';
+import { NavStackEntry } from '@almadar/core';
+
+/**
+ * Navigation-stack core — the pure logic behind the orbital-scoped
+ * client-session navigation stack both execution paths share.
+ *
+ * The stack is what detail-page breadcrumb bands and the `navigate-back`
+ * effect read. It lives client-side only (per browser tab): the runtime
+ * path's OrbPreview and the compiled app's App.tsx both mount
+ * `NavStackProvider` (providers/NavStackContext.tsx), which drives this
+ * module on every route change.
+ *
+ * Semantics (deterministic):
+ * - One stack per ORBITAL, keyed by the orbital owning the current page.
+ * - On route change: an entry with the same href already in the stack
+ *   truncates back to it (revisit); otherwise the new entry is pushed.
+ * - Cold load (deep link): the stack seeds from the declared page-path
+ *   hierarchy — every declared page whose pattern matches a strict prefix
+ *   of the concrete path becomes an ancestor entry — so the trail is never
+ *   empty and back always has a target on nested paths.
+ * - Entry label = the `crumb` carried by the navigate effect when one was
+ *   staged for this href, else the page's declared name humanized.
+ */
+
+/** One declared page as the nav stack needs it: path pattern + name + owning orbital. */
+interface NavPageDecl {
+    path: string;
+    name: string;
+    orbital: string;
+}
+
+/**
+ * NavStackProvider — the orbital-scoped client-session navigation stack.
+ *
+ * One provider instance per app host. Both execution paths mount it:
+ * - Runtime path: OrbPreview supplies `currentPath` + `navigate` explicitly.
+ * - Compiled path: the emitted App.tsx mounts `NavStackRouterBridge`, which
+ *   reads react-router's location/navigate and renders this provider.
+ *
+ * Pure stack semantics live in lib/navStack.ts (one owner for both paths).
+ * State persists to sessionStorage (per-tab) so a compiled app's full page
+ * reload keeps the trail; every storage access is guarded with an in-memory
+ * fallback.
+ */
+
+interface NavStackApi {
+    /** Stack of the current page's orbital, root-first (empty when no declared page matches). */
+    entries: readonly NavStackEntry[];
+    /** True when a previous entry exists for the current page's orbital. */
+    canGoBack: boolean;
+    /** Stage the crumb label for the entry the target page will record, then call navigate yourself. */
+    beginNavigate: (href: string, crumb?: string) => void;
+    /** Pop the current orbital's stack: navigate to the previous entry (no-op without one). */
+    back: () => void;
+    /** Navigate to an arbitrary stack entry (breadcrumb click). */
+    goTo: (href: string) => void;
+}
+declare function useNavStack(): NavStackApi;
+interface NavStackProviderProps {
+    pages: readonly NavPageDecl[];
+    /** Concrete current path (route params substituted), e.g. /contracts/42. */
+    currentPath: string;
+    /** Host navigation function (SPA route change). */
+    navigate: (path: string) => void;
+    /** sessionStorage key; omit to keep the stack in memory only. */
+    storageKey?: string;
+    children: React__default.ReactNode;
+}
+declare const NavStackProvider: React__default.FC<NavStackProviderProps>;
+interface NavStackRouterBridgeProps {
+    pages: readonly NavPageDecl[];
+    storageKey?: string;
+    children: React__default.ReactNode;
+}
+/**
+ * Compiled-path host: binds NavStackProvider to react-router. Must render
+ * inside a Router (the emitted App.tsx mounts it directly under
+ * BrowserRouter).
+ */
+declare const NavStackRouterBridge: React__default.FC<NavStackRouterBridgeProps>;
+
+export { type NavPageDecl as N, type NavStackApi as a, NavStackProvider as b, type NavStackProviderProps as c, NavStackRouterBridge as d, type NavStackRouterBridgeProps as e, useNavStack as u };

package/dist/NavStackContext-BoVV9nWb.d.ts

@@ -0,0 +1,83 @@
+import React__default from 'react';
+import { NavStackEntry } from '@almadar/core';
+
+/**
+ * Navigation-stack core — the pure logic behind the orbital-scoped
+ * client-session navigation stack both execution paths share.
+ *
+ * The stack is what detail-page breadcrumb bands and the `navigate-back`
+ * effect read. It lives client-side only (per browser tab): the runtime
+ * path's OrbPreview and the compiled app's App.tsx both mount
+ * `NavStackProvider` (providers/NavStackContext.tsx), which drives this
+ * module on every route change.
+ *
+ * Semantics (deterministic):
+ * - One stack per ORBITAL, keyed by the orbital owning the current page.
+ * - On route change: an entry with the same href already in the stack
+ *   truncates back to it (revisit); otherwise the new entry is pushed.
+ * - Cold load (deep link): the stack seeds from the declared page-path
+ *   hierarchy — every declared page whose pattern matches a strict prefix
+ *   of the concrete path becomes an ancestor entry — so the trail is never
+ *   empty and back always has a target on nested paths.
+ * - Entry label = the `crumb` carried by the navigate effect when one was
+ *   staged for this href, else the page's declared name humanized.
+ */
+
+/** One declared page as the nav stack needs it: path pattern + name + owning orbital. */
+interface NavPageDecl {
+    path: string;
+    name: string;
+    orbital: string;
+}
+
+/**
+ * NavStackProvider — the orbital-scoped client-session navigation stack.
+ *
+ * One provider instance per app host. Both execution paths mount it:
+ * - Runtime path: OrbPreview supplies `currentPath` + `navigate` explicitly.
+ * - Compiled path: the emitted App.tsx mounts `NavStackRouterBridge`, which
+ *   reads react-router's location/navigate and renders this provider.
+ *
+ * Pure stack semantics live in lib/navStack.ts (one owner for both paths).
+ * State persists to sessionStorage (per-tab) so a compiled app's full page
+ * reload keeps the trail; every storage access is guarded with an in-memory
+ * fallback.
+ */
+
+interface NavStackApi {
+    /** Stack of the current page's orbital, root-first (empty when no declared page matches). */
+    entries: readonly NavStackEntry[];
+    /** True when a previous entry exists for the current page's orbital. */
+    canGoBack: boolean;
+    /** Stage the crumb label for the entry the target page will record, then call navigate yourself. */
+    beginNavigate: (href: string, crumb?: string) => void;
+    /** Pop the current orbital's stack: navigate to the previous entry (no-op without one). */
+    back: () => void;
+    /** Navigate to an arbitrary stack entry (breadcrumb click). */
+    goTo: (href: string) => void;
+}
+declare function useNavStack(): NavStackApi;
+interface NavStackProviderProps {
+    pages: readonly NavPageDecl[];
+    /** Concrete current path (route params substituted), e.g. /contracts/42. */
+    currentPath: string;
+    /** Host navigation function (SPA route change). */
+    navigate: (path: string) => void;
+    /** sessionStorage key; omit to keep the stack in memory only. */
+    storageKey?: string;
+    children: React__default.ReactNode;
+}
+declare const NavStackProvider: React__default.FC<NavStackProviderProps>;
+interface NavStackRouterBridgeProps {
+    pages: readonly NavPageDecl[];
+    storageKey?: string;
+    children: React__default.ReactNode;
+}
+/**
+ * Compiled-path host: binds NavStackProvider to react-router. Must render
+ * inside a Router (the emitted App.tsx mounts it directly under
+ * BrowserRouter).
+ */
+declare const NavStackRouterBridge: React__default.FC<NavStackRouterBridgeProps>;
+
+export { type NavPageDecl as N, type NavStackApi as a, NavStackProvider as b, type NavStackProviderProps as c, NavStackRouterBridge as d, type NavStackRouterBridgeProps as e, useNavStack as u };

package/dist/avl/index.cjs

@@ -23665,17 +23665,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",
         {
@@ -23685,7 +23695,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,
@@ -23711,7 +23721,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(
@@ -44184,6 +44199,7 @@ var init_DetailPanel = __esm({
     init_Box();
     init_Stack();
     init_SimpleGrid();
+    init_Menu();
     init_LoadingState();
     init_ErrorState();
     init_EmptyState();
@@ -44201,6 +44217,7 @@ var init_DetailPanel = __esm({
       avatar,
       sections: propSections,
       actions,
+      maxInlineActions,
       backAction,
       footer,
       slideOver = false,
@@ -44435,7 +44452,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",
@@ -44450,6 +44467,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,
               {
@@ -55440,7 +55473,7 @@ function runTickFrame(entityId, orderedWriters, store) {
 }
 var log8 = logger.createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
+  const { eventBus, slotSetter, navigate, navigateBack, notify, callService, liveEntity } = options;
   return {
     emit: (event, payload, source) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -55490,6 +55523,9 @@ function createClientEffectHandlers(options) {
       }
       log8.warn("No navigate handler, ignoring", { path });
     }),
+    navigateBack: navigateBack ?? (() => {
+      log8.warn("No navigate-back handler, ignoring");
+    }),
     notify: notify ?? ((msg, type) => {
       log8.debug("notify", { type, message: msg });
     })
@@ -55959,6 +55995,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         }
       },
       navigate: optionsRef.current?.navigate,
+      navigateBack: optionsRef.current?.navigateBack,
       notify: optionsRef.current?.notify,
       callService: optionsRef.current?.callService,
       // The canonical client `set` writes `(set @entity.X)` straight into
@@ -56020,6 +56057,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         emit: clientHandlers.emit,
         renderUI: clientHandlers.renderUI,
         navigate: clientHandlers.navigate,
+        navigateBack: clientHandlers.navigateBack,
         notify: clientHandlers.notify
       };
     }
@@ -56639,7 +56677,7 @@ function normalizeChild(child) {
     props: { ...rest, ...normalizedChildren !== void 0 ? { children: normalizedChildren } : {} }
   };
 }
-function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraits) {
+function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraits, onNavigateBack) {
   for (const eff of effects) {
     if (eff.type === "render-ui" && eff.slot && eff.pattern) {
       if (eff.traitName && activeTraits && !activeTraits.has(eff.traitName)) {
@@ -56685,7 +56723,9 @@ function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, active
         });
       }
     } else if (eff.type === "navigate" && eff.route && onNavigate) {
-      onNavigate(eff.route, eff.params);
+      onNavigate(eff.route, eff.params, eff.crumb);
+    } else if (eff.type === "navigate-back" && onNavigateBack) {
+      onNavigateBack();
     }
   }
 }
@@ -56708,7 +56748,17 @@ function collectServerActiveTraits(ir, allTraits, mountedTraitNames) {
   }
   return active;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, serverActiveTraits, children }) {
+function NavStackRefBridge({ apiRef }) {
+  const api = providers.useNavStack();
+  React94.useEffect(() => {
+    apiRef.current = api;
+    return () => {
+      apiRef.current = null;
+    };
+  }, [api, apiRef]);
+  return null;
+}
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, serverActiveTraits, children }) {
   const bridge = providers.useServerBridge();
   const activeTraitNames = React94.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -56734,10 +56784,10 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     for (const name of targets) {
       const { effects, meta } = await bridge.sendEvent(name, event, withActiveTraits(payload));
       recordServerResponse(name, event, meta);
-      applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames);
+      applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, embeddedTraits, activeTraitNames, withActiveTraits]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams };
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, initPayload: routeParams };
   const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
   const initSentRef = React94.useRef(false);
   const prevTraitsRef = React94.useRef(void 0);
@@ -56796,13 +56846,13 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
           effects: effectTraces,
           timestamp: Date.now()
         });
-        applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames);
+        applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNames, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
   return /* @__PURE__ */ jsxRuntime.jsx(providers.EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
-function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, routeParams, onNavigate, onLocalFallback, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, persistence }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React94.useMemo(() => {
     let base;
@@ -56950,6 +57000,7 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, routeP
           embeddedTraits,
           serverActiveTraits,
           onNavigate,
+          onNavigateBack,
           onLocalFallback,
           persistence,
           children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
@@ -57042,6 +57093,15 @@ function OrbPreview({
     const resolved = pages.find((p) => p.page.name === activePageName)?.page.path;
     return resolved ?? initialPagePath;
   }, [pages, currentPage, initialPagePath]);
+  const navPages = React94.useMemo(
+    () => pages.filter((p) => typeof p.page.path === "string" && p.page.path.length > 0).map((p) => ({ path: p.page.path, name: p.page.name, orbital: p.orbitalName })),
+    [pages]
+  );
+  const concreteCurrentPath = React94.useMemo(() => {
+    const pattern = currentPagePath ?? "/";
+    return pattern.replace(/:([A-Za-z0-9_]+)/g, (whole, key) => routeParams[key] ?? whole);
+  }, [currentPagePath, routeParams]);
+  const navStackRef = React94.useRef(null);
   const handleNavigate = React94.useCallback((path) => {
     const hit = providers.matchPathAmong(pages, path, (entry) => entry.page.path);
     const match = hit?.candidate;
@@ -57063,6 +57123,16 @@ function OrbPreview({
       }
     }
   }, [pages]);
+  const handleNavigateEffect = React94.useCallback(
+    (path, _params, crumb) => {
+      navStackRef.current?.beginNavigate(path, crumb);
+      handleNavigate(path);
+    },
+    [handleNavigate]
+  );
+  const handleNavigateBack = React94.useCallback(() => {
+    navStackRef.current?.back();
+  }, []);
   React94.useEffect(() => {
     const unsubscribe = eventBus.on("UI:NAVIGATE", (event) => {
       const url = event.payload?.url;
@@ -57115,20 +57185,33 @@ function OrbPreview({
       style: { height },
       children: [
         localFallback && /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "px-3 py-2 bg-[var(--color-warning)] bg-opacity-10 border-b border-[var(--color-warning)] flex items-center gap-2", children: /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "caption", className: "text-[var(--color-warning-foreground)] flex-1", children: "Preview server unreachable \u2014 running locally. Server-side state and persistence are disabled." }) }),
-        /* @__PURE__ */ jsxRuntime.jsx(providers.CurrentPagePathProvider, { value: currentPagePath, children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, children: /* @__PURE__ */ jsxRuntime.jsx(context.UISlotProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(
-          SchemaRunner,
-          {
-            schema: parseResult.schema,
-            serverUrl,
-            transport,
-            mockData: effectiveMockData,
-            pageName: currentPage,
-            routeParams,
-            onNavigate: handleNavigate,
-            onLocalFallback: handleLocalFallback,
-            persistence
-          }
-        ) }) }) })
+        /* @__PURE__ */ jsxRuntime.jsx(providers.CurrentPagePathProvider, { value: currentPagePath, children: /* @__PURE__ */ jsxRuntime.jsxs(
+          providers.NavStackProvider,
+          {
+            pages: navPages,
+            currentPath: concreteCurrentPath,
+            navigate: handleNavigate,
+            storageKey: `almadar:navstack:${parseResult.schema.name ?? "preview"}`,
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(NavStackRefBridge, { apiRef: navStackRef }),
+              /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, children: /* @__PURE__ */ jsxRuntime.jsx(context.UISlotProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(
+                SchemaRunner,
+                {
+                  schema: parseResult.schema,
+                  serverUrl,
+                  transport,
+                  mockData: effectiveMockData,
+                  pageName: currentPage,
+                  routeParams,
+                  onNavigate: handleNavigateEffect,
+                  onNavigateBack: handleNavigateBack,
+                  onLocalFallback: handleLocalFallback,
+                  persistence
+                }
+              ) }) })
+            ]
+          }
+        ) })
       ]
     }
   );