@almadar/ui 5.153.0 → 5.155.0

package/dist/avl/index.js

@@ -1,7 +1,7 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as React94 from 'react';
 import React94__default, { createContext, useState, useMemo, useRef, useEffect, useContext, useCallback, Suspense, useLayoutEffect, Profiler, useReducer, useSyncExternalStore, lazy, useId } from 'react';
-import { getAllPages, matchPathAmong, CurrentPagePathProvider, OrbitalProvider, EventBusContext, useTraitScopeChain, ServerBridgeProvider, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge, EntityBindingContext, useEntitySchema, useEntitySchemaOptional, useEntityBindingSnapshot, TraitScopeProvider, useTraitScope, useCurrentPagePath, useGameAudioContextOptional } from '@almadar/ui/providers';
+import { getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, EventBusContext, useTraitScopeChain, useNavStack, ServerBridgeProvider, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge, EntityBindingContext, useEntitySchema, useEntitySchemaOptional, useEntityBindingSnapshot, TraitScopeProvider, useTraitScope, useCurrentPagePath, useGameAudioContextOptional } from '@almadar/ui/providers';
 import { createLogger, setNamespaceLevel, isLogLevelEnabled } from '@almadar/logger';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import { MarkerType, useReactFlow, Handle, Position, getBezierPath, EdgeLabelRenderer, useNodeId, ReactFlowProvider, BaseEdge, useNodesState, useEdgesState, ReactFlow, Controls, Background, BackgroundVariant } from '@xyflow/react';
@@ -23589,17 +23589,27 @@ var init_Breadcrumb = __esm({
     init_useEventBus();
     Breadcrumb = ({
       items,
+      fromNavStack = false,
+      itemEvent,
       separator = "chevron-right",
       maxItems,
       className
     }) => {
       const eventBus = useEventBus();
       const { t } = useTranslate();
-      const displayItems = maxItems && items.length > maxItems ? [
-        ...items.slice(0, 1),
+      const navStack = 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__ */ jsx(
         "nav",
         {
@@ -23609,7 +23619,7 @@ var init_Breadcrumb = __esm({
             const isLast = index === displayItems.length - 1;
             const isEllipsis = item.label === "...";
             return /* @__PURE__ */ jsxs("li", { className: "flex items-center gap-2", children: [
-              isEllipsis ? /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: item.label }) : item.href || item.path ? /* @__PURE__ */ jsxs(
+              isEllipsis ? /* @__PURE__ */ jsx(Typography, { variant: "small", color: "muted", children: item.label }) : (item.href || item.path) && !item.event && !fromNavStack ? /* @__PURE__ */ jsxs(
                 "a",
                 {
                   href: item.href || item.path,
@@ -23635,7 +23645,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(
@@ -44108,6 +44123,7 @@ var init_DetailPanel = __esm({
     init_Box();
     init_Stack();
     init_SimpleGrid();
+    init_Menu();
     init_LoadingState();
     init_ErrorState();
     init_EmptyState();
@@ -44125,6 +44141,7 @@ var init_DetailPanel = __esm({
       avatar,
       sections: propSections,
       actions,
+      maxInlineActions,
       backAction,
       footer,
       slideOver = false,
@@ -44359,7 +44376,7 @@ var init_DetailPanel = __esm({
             }
           ) }),
           /* @__PURE__ */ jsxs(HStack, { justify: "end", align: "center", gap: "xs", children: [
-            otherActions.map((action, idx) => /* @__PURE__ */ jsx(
+            (maxInlineActions != null ? otherActions.slice(0, maxInlineActions) : otherActions).map((action, idx) => /* @__PURE__ */ jsx(
               Button,
               {
                 variant: action.variant || "secondary",
@@ -44374,6 +44391,22 @@ var init_DetailPanel = __esm({
               },
               idx
             )),
+            maxInlineActions != null && otherActions.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: 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__ */ jsx(
               Button,
               {
@@ -55364,7 +55397,7 @@ function runTickFrame(entityId, orderedWriters, store) {
 }
 var log8 = 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}`;
@@ -55414,6 +55447,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 });
     })
@@ -55883,6 +55919,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
@@ -55944,6 +55981,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         emit: clientHandlers.emit,
         renderUI: clientHandlers.renderUI,
         navigate: clientHandlers.navigate,
+        navigateBack: clientHandlers.navigateBack,
         notify: clientHandlers.notify
       };
     }
@@ -56563,7 +56601,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)) {
@@ -56609,7 +56647,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();
     }
   }
 }
@@ -56632,7 +56672,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 = useNavStack();
+  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 = useServerBridge();
   const activeTraitNames = useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -56658,10 +56708,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 = useRef(false);
   const prevTraitsRef = useRef(void 0);
@@ -56720,13 +56770,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__ */ jsx(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 = useMemo(() => {
     let base;
@@ -56874,6 +56924,7 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, routeP
           embeddedTraits,
           serverActiveTraits,
           onNavigate,
+          onNavigateBack,
           onLocalFallback,
           persistence,
           children: /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
@@ -56966,6 +57017,15 @@ function OrbPreview({
     const resolved = pages.find((p) => p.page.name === activePageName)?.page.path;
     return resolved ?? initialPagePath;
   }, [pages, currentPage, initialPagePath]);
+  const navPages = 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 = useMemo(() => {
+    const pattern = currentPagePath ?? "/";
+    return pattern.replace(/:([A-Za-z0-9_]+)/g, (whole, key) => routeParams[key] ?? whole);
+  }, [currentPagePath, routeParams]);
+  const navStackRef = useRef(null);
   const handleNavigate = useCallback((path) => {
     const hit = matchPathAmong(pages, path, (entry) => entry.page.path);
     const match = hit?.candidate;
@@ -56987,6 +57047,16 @@ function OrbPreview({
       }
     }
   }, [pages]);
+  const handleNavigateEffect = useCallback(
+    (path, _params, crumb) => {
+      navStackRef.current?.beginNavigate(path, crumb);
+      handleNavigate(path);
+    },
+    [handleNavigate]
+  );
+  const handleNavigateBack = useCallback(() => {
+    navStackRef.current?.back();
+  }, []);
   useEffect(() => {
     const unsubscribe = eventBus.on("UI:NAVIGATE", (event) => {
       const url = event.payload?.url;
@@ -57039,20 +57109,33 @@ function OrbPreview({
       style: { height },
       children: [
         localFallback && /* @__PURE__ */ 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__ */ 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__ */ jsx(CurrentPagePathProvider, { value: currentPagePath, children: /* @__PURE__ */ jsx(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, children: /* @__PURE__ */ jsx(UISlotProvider, { children: /* @__PURE__ */ jsx(
-          SchemaRunner,
-          {
-            schema: parseResult.schema,
-            serverUrl,
-            transport,
-            mockData: effectiveMockData,
-            pageName: currentPage,
-            routeParams,
-            onNavigate: handleNavigate,
-            onLocalFallback: handleLocalFallback,
-            persistence
-          }
-        ) }) }) })
+        /* @__PURE__ */ jsx(CurrentPagePathProvider, { value: currentPagePath, children: /* @__PURE__ */ jsxs(
+          NavStackProvider,
+          {
+            pages: navPages,
+            currentPath: concreteCurrentPath,
+            navigate: handleNavigate,
+            storageKey: `almadar:navstack:${parseResult.schema.name ?? "preview"}`,
+            children: [
+              /* @__PURE__ */ jsx(NavStackRefBridge, { apiRef: navStackRef }),
+              /* @__PURE__ */ jsx(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, children: /* @__PURE__ */ jsx(UISlotProvider, { children: /* @__PURE__ */ jsx(
+                SchemaRunner,
+                {
+                  schema: parseResult.schema,
+                  serverUrl,
+                  transport,
+                  mockData: effectiveMockData,
+                  pageName: currentPage,
+                  routeParams,
+                  onNavigate: handleNavigateEffect,
+                  onNavigateBack: handleNavigateBack,
+                  onLocalFallback: handleLocalFallback,
+                  persistence
+                }
+              ) }) })
+            ]
+          }
+        ) })
       ]
     }
   );

package/dist/components/index.cjs

@@ -16201,17 +16201,27 @@ var init_Breadcrumb = __esm({
     init_useEventBus();
     exports.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",
         {
@@ -16221,7 +16231,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(exports.Typography, { variant: "small", color: "muted", children: item.label }) : item.href || item.path ? /* @__PURE__ */ jsxRuntime.jsxs(
+              isEllipsis ? /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "small", color: "muted", children: item.label }) : (item.href || item.path) && !item.event && !fromNavStack ? /* @__PURE__ */ jsxRuntime.jsxs(
                 "a",
                 {
                   href: item.href || item.path,
@@ -16247,7 +16257,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(
@@ -43588,6 +43603,7 @@ var init_DetailPanel = __esm({
     init_Box();
     init_Stack();
     init_SimpleGrid();
+    init_Menu();
     init_LoadingState();
     init_ErrorState();
     init_EmptyState();
@@ -43605,6 +43621,7 @@ var init_DetailPanel = __esm({
       avatar,
       sections: propSections,
       actions,
+      maxInlineActions,
       backAction,
       footer,
       slideOver = false,
@@ -43839,7 +43856,7 @@ var init_DetailPanel = __esm({
             }
           ) }),
           /* @__PURE__ */ jsxRuntime.jsxs(exports.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(
               exports.Button,
               {
                 variant: action.variant || "secondary",
@@ -43854,6 +43871,22 @@ var init_DetailPanel = __esm({
               },
               idx
             )),
+            maxInlineActions != null && otherActions.length > maxInlineActions && /* @__PURE__ */ jsxRuntime.jsx(
+              exports.Menu,
+              {
+                position: "bottom-end",
+                trigger: /* @__PURE__ */ jsxRuntime.jsx(exports.Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsxRuntime.jsx(exports.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(
               exports.Button,
               {
@@ -53701,6 +53734,10 @@ Object.defineProperty(exports, "useGameAudioContext", {
   enumerable: true,
   get: function () { return providers.useGameAudioContext; }
 });
+Object.defineProperty(exports, "useNavStack", {
+  enumerable: true,
+  get: function () { return providers.useNavStack; }
+});
 exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.ActionCard = Card2;
 exports.ActionPalette = ActionPalette;

package/dist/components/index.d.cts

@@ -18,6 +18,7 @@ export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as S
 export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.cjs';
 export { u as useEmitEvent, a as useEventBus, b as useEventListener } from '../useEventBus-Ckr4wqW3.cjs';
 export { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
+export { a as NavStackApi, u as useNavStack } from '../NavStackContext-BoVV9nWb.cjs';
 import 'three';
 import 'clsx';
 import '@tanstack/react-query';
@@ -482,7 +483,8 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** When set, renders a small X button on the right of the badge that
      *  invokes this handler — turns the badge into a removable chip.
      *  Used by the TagInput molecule and other "list of removable values"
-     *  surfaces. */
+     *  surfaces.
+     *  @offByDefault */
     onRemove?: () => void;
     /** Accessible label for the remove button. Defaults to "Remove". */
     removeLabel?: string;
@@ -596,7 +598,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     label?: string | number;
     /** Lucide icon component or canonical kebab-case icon name string */
     icon?: IconInput;
-    /** Called when the user clicks the remove (×) button */
+    /** Called when the user clicks the remove (×) button
+     *  @offByDefault */
     onRemove?: () => void;
     /** Disable the remove button (renders without × control) */
     removable?: boolean;
@@ -606,7 +609,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     clickEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
-    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label } */
+    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
@@ -2923,13 +2927,15 @@ interface TraitSlotProps {
     feedback?: 'correct' | 'wrong' | null;
     /** Click handler */
     onClick?: () => void;
-    /** Remove handler */
+    /** Remove handler
+     *  @offByDefault */
     onRemove?: () => void;
     /** Emits UI:{clickEvent} with { slotNumber } */
     clickEvent?: EventEmit<{
         slotNumber: number;
     }>;
-    /** Emits UI:{removeEvent} with { slotNumber } */
+    /** Emits UI:{removeEvent} with { slotNumber }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         slotNumber: number;
     }>;
@@ -3966,13 +3972,27 @@ interface BreadcrumbItem {
      */
     isCurrent?: boolean;
     /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
 }
 interface BreadcrumbProps {
     /**
-     * Breadcrumb items
+     * Breadcrumb items. Omit together with `fromNavStack` to render the
+     * orbital-scoped navigation stack instead of an authored trail.
+     */
+    items?: BreadcrumbItem[];
+    /**
+     * Render the current orbital's navigation stack (NavStackProvider) as the
+     * trail: one crumb per visited/declared level, last entry current. The
+     * stack is client-session state both execution paths maintain; outside a
+     * provider this renders nothing.
+     */
+    fromNavStack?: boolean;
+    /**
+     * Event emitted when a non-current crumb is clicked, with payload
+     * `{ label, href, index }` — the trait handles it with
+     * `(navigate ?href)`. Without it, stack crumbs navigate directly.
      */
-    items: BreadcrumbItem[];
+    itemEvent?: EventKey;
     /**
      * Separator icon (canonical kebab-case name or LucideIcon component)
      */
@@ -10750,6 +10770,8 @@ interface DetailPanelProps extends DisplayStateProps {
     sections?: readonly DetailSection[];
     /** Unified actions array - first action with variant='primary' is the main action */
     actions?: readonly DetailPanelAction[];
+    /** Max inline action buttons before the rest collapse into a "⋯" overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline. */
+    maxInlineActions?: number;
     /**
      * Navigation-back affordance. Renders top-LEFT before the title (OS/back
      * convention — Almadar_UX §8.4), spatially separated from the right-aligned

package/dist/components/index.d.ts

@@ -18,6 +18,7 @@ export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as S
 export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
 export { u as useEmitEvent, a as useEventBus, b as useEventListener } from '../useEventBus-CQWyAWpK.js';
 export { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
+export { a as NavStackApi, u as useNavStack } from '../NavStackContext-BoVV9nWb.js';
 import 'three';
 import 'clsx';
 import '@tanstack/react-query';
@@ -482,7 +483,8 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** When set, renders a small X button on the right of the badge that
      *  invokes this handler — turns the badge into a removable chip.
      *  Used by the TagInput molecule and other "list of removable values"
-     *  surfaces. */
+     *  surfaces.
+     *  @offByDefault */
     onRemove?: () => void;
     /** Accessible label for the remove button. Defaults to "Remove". */
     removeLabel?: string;
@@ -596,7 +598,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     label?: string | number;
     /** Lucide icon component or canonical kebab-case icon name string */
     icon?: IconInput;
-    /** Called when the user clicks the remove (×) button */
+    /** Called when the user clicks the remove (×) button
+     *  @offByDefault */
     onRemove?: () => void;
     /** Disable the remove button (renders without × control) */
     removable?: boolean;
@@ -606,7 +609,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     clickEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
-    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label } */
+    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
@@ -2923,13 +2927,15 @@ interface TraitSlotProps {
     feedback?: 'correct' | 'wrong' | null;
     /** Click handler */
     onClick?: () => void;
-    /** Remove handler */
+    /** Remove handler
+     *  @offByDefault */
     onRemove?: () => void;
     /** Emits UI:{clickEvent} with { slotNumber } */
     clickEvent?: EventEmit<{
         slotNumber: number;
     }>;
-    /** Emits UI:{removeEvent} with { slotNumber } */
+    /** Emits UI:{removeEvent} with { slotNumber }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         slotNumber: number;
     }>;
@@ -3966,13 +3972,27 @@ interface BreadcrumbItem {
      */
     isCurrent?: boolean;
     /** Event name to emit when clicked (for trait state machine integration) */
-    event?: string;
+    event?: EventKey;
 }
 interface BreadcrumbProps {
     /**
-     * Breadcrumb items
+     * Breadcrumb items. Omit together with `fromNavStack` to render the
+     * orbital-scoped navigation stack instead of an authored trail.
+     */
+    items?: BreadcrumbItem[];
+    /**
+     * Render the current orbital's navigation stack (NavStackProvider) as the
+     * trail: one crumb per visited/declared level, last entry current. The
+     * stack is client-session state both execution paths maintain; outside a
+     * provider this renders nothing.
+     */
+    fromNavStack?: boolean;
+    /**
+     * Event emitted when a non-current crumb is clicked, with payload
+     * `{ label, href, index }` — the trait handles it with
+     * `(navigate ?href)`. Without it, stack crumbs navigate directly.
      */
-    items: BreadcrumbItem[];
+    itemEvent?: EventKey;
     /**
      * Separator icon (canonical kebab-case name or LucideIcon component)
      */
@@ -10750,6 +10770,8 @@ interface DetailPanelProps extends DisplayStateProps {
     sections?: readonly DetailSection[];
     /** Unified actions array - first action with variant='primary' is the main action */
     actions?: readonly DetailPanelAction[];
+    /** Max inline action buttons before the rest collapse into a "⋯" overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline. */
+    maxInlineActions?: number;
     /**
      * Navigation-back affordance. Renders top-LEFT before the title (OS/back
      * convention — Almadar_UX §8.4), spatially separated from the right-aligned