@omerdlw/base-framework 2.0.1 → 3.0.1

package/dist/{chunk-A5RE3F6O.js → chunk-WVRMABDN.js}

@@ -1,9 +1,10 @@
+import { NAVIGATION_STATUS, createNavigator } from './chunk-HLL5EHXC.js';
 import { Z_INDEX } from './chunk-QI3ALLIB.js';
 import { useNotificationVisible } from './chunk-SYAVGTOX.js';
 import { useOptionalMediaState, useOptionalMediaActions } from './chunk-R2YGFJDJ.js';
-import { useOptionalLoadingActions, useOptionalLoadingState } from './chunk-XASQT4CQ.js';
+import { useOptionalLoadingActions, useOptionalLoadingState } from './chunk-66EYJBIP.js';
 import { defineThemeSpec, useModuleMotion, useTheme, cssTransition, staggerDelay, gpuTransform, useOptionalModuleMotion } from './chunk-7TAVYJ3A.js';
-import { getOrCreateGlobalContext, defineModule, useRegistryEntries, useModuleRegistration } from './chunk-GF7TUX5I.js';
+import { getOrCreateGlobalContext, defineModule, useModule, useRegistryEntries, useModuleRegistration } from './chunk-GF7TUX5I.js';
 import { createStore, cn, isImageIconSource, clamp, useIsomorphicLayoutEffect, isObject, isPlainObject, trimToNull, shallowEqual, useGlobalEvent, useRequiredContext, globalEvents, toArray, useIsFullscreenStateActive, useClickOutside, report, normalizePath, useStore, createScheduler, EVENT_TYPES, toUserMessage } from './chunk-TV3WEF5G.js';
 import { Tooltip, Icon, Button, Spinner } from './chunk-3BUP64Q6.js';
 import React, { createContext, memo, createElement, isValidElement, cloneElement, Suspense, useEffect, useState, useCallback, useMemo, use, useSyncExternalStore, useRef, useLayoutEffect, useReducer, lazy, useContext, useId } from 'react';
@@ -409,54 +410,21 @@ var DOCK_SURFACE_PHASE = Object.freeze({
 });
 var VIEWPORT_MARGIN = 24;
 var DOCK_CARD_DIMENSIONS = Object.freeze({
-  expandedY: -72,
   chromeHeight: 20,
-  collapsedY: -10,
-  extensionShelfY: -42,
-  extensionShelfScale: 0.94,
   extensionShelfHeight: 45,
   hudHeight: 52,
   actionGap: 10,
   height: 68
 });
 var DOCK_CARD_LAYOUT = Object.freeze({
-  collapsed: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.collapsedY,
-    scale: 0.88
-  }),
-  expanded: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.expandedY,
-    scale: 1
-  }),
-  extensionShelfY: DOCK_CARD_DIMENSIONS.extensionShelfY,
-  extensionShelfScale: DOCK_CARD_DIMENSIONS.extensionShelfScale,
   extensionShelfHeight: DOCK_CARD_DIMENSIONS.extensionShelfHeight,
   chromeHeight: DOCK_CARD_DIMENSIONS.chromeHeight,
   hudHeight: DOCK_CARD_DIMENSIONS.hudHeight,
   actionGap: DOCK_CARD_DIMENSIONS.actionGap,
   baseHeight: DOCK_CARD_DIMENSIONS.height
 });
-var DOCK_TRANSACTION_EVENTS = Object.freeze({
-  START: "START",
-  COMPLETE: "COMPLETE",
-  CANCEL: "CANCEL",
-  FAIL: "FAIL",
-  TIME_OUT: "TIME_OUT"
-});
-var DOCK_TRANSACTION_STATUS = Object.freeze({
-  PENDING: "pending",
-  COMPLETED: "completed",
-  CANCELLED: "cancelled",
-  FAILED: "failed",
-  TIMED_OUT: "timed-out"
-});
-var DOCK_TRANSACTION_REASON = Object.freeze({
-  GUARD: "guard",
-  SUPERSEDED: "superseded",
-  TIME_OUT: "time-out"
-});
-var DOCK_TRANSACTION_TIMEOUT_MS = 15e3;
 var DOCK_PREFETCH_INTENT_DELAY_MS = 90;
+var DOCK_PENDING_ROUTE_HOLD_MS = 2500;
 var DOCK_CONTINUITY_EVENTS = Object.freeze({
   CLEAR: "CLEAR",
   CONSUME_RETURN: "CONSUME_RETURN",
@@ -517,7 +485,6 @@ var STATUS_CLEAR_DURATION = 4500;
 var API_ERROR_BATCH_DELAY = 300;
 var DOCK_HEIGHT_BUFFER = 16;
 var HEIGHT_EPSILON = 0.5;
-var MAX_VISIBLE_STACKED_CARDS = 3;
 var dockTheme = defineThemeSpec("dock");
 var DockContext = getOrCreateGlobalContext(
   "DockContext",
@@ -1616,10 +1583,6 @@ var DOCK_SURFACE_DRAG_CONSTRAINTS = Object.freeze({
   top: 0,
   bottom: 0
 });
-var DOCK_SURFACE_DRAG_THRESHOLDS = Object.freeze({
-  DISMISS_OFFSET_Y: 65,
-  DISMISS_VELOCITY_Y: 400
-});
 function toGpuTransform(y = 0, scale = 1, x = 0) {
   return gpuTransform(y, scale, x);
 }
@@ -1655,42 +1618,37 @@ function getDockMediaVolumeThumbAnimateProps(motion2, { isDragging = false } = {
 function getDockMediaVolumeThumbPositionTransition(motion2, { isDragging = false } = {}) {
   return isDragging ? "none" : cssTransition("left", motion2.transitions.mediaVolume);
 }
-function getDockSurfaceStackScale(motion2, surfacePhase) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION) {
-    return motion2.deck.compress.open;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.deck.compress.close;
-  }
-  return 1;
+var SURFACE_PHASE_KEYS = Object.freeze({
+  [DOCK_SURFACE_PHASE.IDLE]: "idle",
+  [DOCK_SURFACE_PHASE.DISMISSING_ACTION]: "dismissAction",
+  [DOCK_SURFACE_PHASE.EXPANDING_BODY]: "expandBody",
+  [DOCK_SURFACE_PHASE.OPEN]: "open",
+  [DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION]: "anticipation",
+  [DOCK_SURFACE_PHASE.COLLAPSING_BODY]: "collapseBody",
+  [DOCK_SURFACE_PHASE.RESTORING_HEADER]: "restoreHeader"
+});
+function getDockPhaseMotion(motion2, surfacePhase) {
+  const key = surfacePhase && SURFACE_PHASE_KEYS[surfacePhase] || "idle";
+  return motion2.phases[key];
 }
 function getDockStackTransformTransition(motion2, surfacePhase, fallbackTransition) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY) {
-    return motion2.transitions.surfaceArrival;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION || surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.transitions.anticipation;
-  }
-  return fallbackTransition;
+  return getDockPhaseMotion(motion2, surfacePhase).transform ?? fallbackTransition;
 }
 function getDockStackTransition(motion2, {
   expanded = false,
   resizeDistance = 0,
   surfacePhase = null
 } = {}) {
-  if (surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY) {
-    return motion2.transitions.expand;
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.OPEN || surfacePhase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION) {
-    return motion2.transitions.surfaceResize(
-      resizeDistance > 0 ? resizeDistance : 260
-    );
-  }
-  if (surfacePhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY || surfacePhase === DOCK_SURFACE_PHASE.RESTORING_HEADER) {
-    return motion2.transitions.expand;
+  const { deck } = getDockPhaseMotion(motion2, surfacePhase);
+  if (typeof deck === "function") {
+    return deck(resizeDistance > 0 ? resizeDistance : motion2.deck.resizeFallback);
   }
+  if (deck) return deck;
   return expanded ? motion2.transitions.expand : motion2.transitions.stack;
 }
+function getDockLayoutTransition(motion2) {
+  return { layout: motion2.transitions.layout };
+}
 function getDockStackAnimateProps(motion2, {
   width,
   height,
@@ -1701,7 +1659,7 @@ function getDockStackAnimateProps(motion2, {
 }) {
   const safeWidth = Number(width);
   const safeHeight = Number(height);
-  const liftAmount = isBreadcrumbsVisible ? -44 : 0;
+  const liftAmount = isBreadcrumbsVisible ? motion2.deck.breadcrumbOffset : 0;
   return {
     width: Math.max(0, Math.round(Number.isFinite(safeWidth) ? safeWidth : 0)),
     height: Math.max(
@@ -1710,9 +1668,9 @@ function getDockStackAnimateProps(motion2, {
     ),
     transform: toGpuTransform(
       liftAmount,
-      getDockSurfaceStackScale(motion2, surfacePhase)
+      getDockPhaseMotion(motion2, surfacePhase).scale
     ),
-    opacity: isFullscreen ? 0 : 1,
+    opacity: isFullscreen ? motion2.deck.fullscreenOpacity : 1,
     boxShadow: isSurfaceActive ? motion2.deck.elevation.elevated : motion2.deck.elevation.rest,
     pointerEvents: isFullscreen ? "none" : "auto"
   };
@@ -1777,7 +1735,7 @@ function getDockItemExitValues(motion2, {
   return motion2.deck.exit({
     position: safePosition,
     scale: motionValues && Number.isFinite(motionValues.scale) ? motionValues.scale : null,
-    y: motionValues && Number.isFinite(motionValues.y) ? motionValues.y : safePosition * DOCK_CARD_DIMENSIONS.collapsedY
+    y: motionValues && Number.isFinite(motionValues.y) ? motionValues.y : safePosition * motion2.deck.stacking.collapsed.offsetY
   });
 }
 function getDockCardContentAnimateProps(motion2, {
@@ -2221,7 +2179,8 @@ function useDockSurfaceShellModel({
   const handleDragEnd = (_event, info) => {
     if (!isActive || !allowSwipeDismiss || typeof onClose !== "function" || !isFullyOpen)
       return;
-    if (info.offset.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_OFFSET_Y || info.velocity.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_VELOCITY_Y) {
+    const { dismiss } = dockMotion.drag;
+    if (info.offset.y > dismiss.offset || info.velocity.y > dismiss.velocity) {
       onClose();
     }
   };
@@ -2246,12 +2205,12 @@ function useDockSurfaceShellModel({
   const resolvedSurfaceId = surfaceId || "active";
   const bodyVariants = useMemo(() => {
     const { surfaceBody } = dockMotion.variants;
-    const { surfaceEnter, surfaceExit, surfaceStep } = dockMotion.transitions;
+    const { surfaceExit } = dockMotion.transitions;
     return {
       hidden: surfaceBody.hidden,
       visible: {
         ...surfaceBody.visible,
-        transition: surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY ? surfaceEnter : surfaceStep
+        transition: getDockPhaseMotion(dockMotion, surfacePhase).body
       },
       exit: {
         ...surfaceBody.exit,
@@ -2347,11 +2306,12 @@ function getDockItemCardProps({
   hasExtensions = false,
   isAnchoredToBottom,
   position,
+  stacking,
   theme,
-  visibleCount = 3
+  visibleCount = stacking.visible.stack
 }) {
-  const { offsetY: collapsedOffsetY, scale: collapsedScale } = DOCK_CARD_LAYOUT.collapsed;
-  const { offsetY: expandedOffsetY } = DOCK_CARD_LAYOUT.expanded;
+  const { offsetY: collapsedOffsetY, scale: collapsedScale } = stacking.collapsed;
+  const { offsetY: expandedOffsetY } = stacking.expanded;
   const safeCardStyle = { ...cardStyle };
   delete safeCardStyle.scale;
   delete safeCardStyle.className;
@@ -2359,10 +2319,12 @@ function getDockItemCardProps({
   const isShelf = !expanded && position === 1 && hasExtensions;
   const isHeavyBlur = position < visibleCount || expanded || isShelf;
   const collapsedScaleValue = collapsedScale ** position;
-  const y = expanded ? position * expandedOffsetY : isShelf ? DOCK_CARD_LAYOUT.extensionShelfY : position * collapsedOffsetY;
-  const shelfScale = DOCK_CARD_LAYOUT.extensionShelfScale ?? 0.94;
-  const scale = expanded ? cardScale || 1 : isShelf ? shelfScale : collapsedScaleValue;
-  const collapsedOpacity = Math.max(0.1, +(1 - position * 0.2).toFixed(2));
+  const y = expanded ? position * expandedOffsetY : isShelf ? stacking.shelf.offsetY : position * collapsedOffsetY;
+  const scale = expanded ? cardScale || 1 : isShelf ? stacking.shelf.scale : collapsedScaleValue;
+  const collapsedOpacity = Math.max(
+    stacking.collapsed.opacityMin,
+    +(1 - position * stacking.collapsed.opacityStep).toFixed(2)
+  );
   const opacity = expanded || isShelf ? 1 : position < visibleCount ? collapsedOpacity : 0;
   return {
     className: cn(theme.slots.card, cardStyle?.className),
@@ -2644,6 +2606,10 @@ function removeInactiveLoadingItems(items = [], activeItem = null) {
     (item) => !item?.isLoading || isSameItem(item, activeItem)
   );
 }
+function stackRank(item) {
+  if (typeof item.stackOrder === "number") return item.stackOrder;
+  return item.path === "/" ? Number.POSITIVE_INFINITY : 0;
+}
 function reorderItemsWithActiveFirst(items, activeIndex) {
   if (activeIndex === -1) return items;
   const active = items[activeIndex];
@@ -2651,7 +2617,7 @@ function reorderItemsWithActiveFirst(items, activeIndex) {
     ...items.slice(0, activeIndex),
     ...items.slice(activeIndex + 1)
   ];
-  rest.sort((a, b) => a.path === "/" ? 1 : b.path === "/" ? -1 : 0);
+  rest.sort((a, b) => stackRank(a) - stackRank(b));
   return [active, ...rest];
 }
 function shouldRenderInlineAction({
@@ -3027,210 +2993,6 @@ function openDockGuardConfirmation({
     }
   });
 }
-function createDockTransactionState() {
-  return { active: null, last: null };
-}
-function createDockTransaction({
-  from = "",
-  id,
-  source = "dock",
-  startedAt = Date.now(),
-  to = ""
-}) {
-  return {
-    from: String(from || ""),
-    id,
-    source,
-    startedAt,
-    status: DOCK_TRANSACTION_STATUS.PENDING,
-    to: String(to || "")
-  };
-}
-function settleDockTransaction(transaction, action, status) {
-  return {
-    ...transaction,
-    endedAt: action.endedAt ?? Date.now(),
-    error: action.error ?? null,
-    reason: action.reason ?? null,
-    status
-  };
-}
-var TRANSACTION_STATUS_MAP = Object.freeze({
-  [DOCK_TRANSACTION_EVENTS.COMPLETE]: DOCK_TRANSACTION_STATUS.COMPLETED,
-  [DOCK_TRANSACTION_EVENTS.CANCEL]: DOCK_TRANSACTION_STATUS.CANCELLED,
-  [DOCK_TRANSACTION_EVENTS.FAIL]: DOCK_TRANSACTION_STATUS.FAILED,
-  [DOCK_TRANSACTION_EVENTS.TIME_OUT]: DOCK_TRANSACTION_STATUS.TIMED_OUT
-});
-function dockTransactionReducer(state, action) {
-  if (action?.type === DOCK_TRANSACTION_EVENTS.START) {
-    const nextTransaction = action.transaction;
-    if (nextTransaction?.id == null) return state;
-    const supersededTransaction = state.active ? settleDockTransaction(
-      state.active,
-      { reason: DOCK_TRANSACTION_REASON.SUPERSEDED },
-      DOCK_TRANSACTION_STATUS.CANCELLED
-    ) : state.last;
-    return { active: nextTransaction, last: supersededTransaction };
-  }
-  const newStatus = action ? TRANSACTION_STATUS_MAP[action.type] : void 0;
-  if (newStatus && action && state.active && state.active.id === action.id) {
-    return {
-      active: null,
-      last: settleDockTransaction(state.active, action, newStatus)
-    };
-  }
-  return state;
-}
-function useDockTransactions({
-  onTransactionEvent = null,
-  onTimeout = null,
-  timeoutMs = DOCK_TRANSACTION_TIMEOUT_MS
-} = {}) {
-  const [state, dispatch] = useReducer(
-    dockTransactionReducer,
-    void 0,
-    createDockTransactionState
-  );
-  const activeTransactionRef = useRef(null);
-  const nextTransactionIdRef = useRef(0);
-  const timeoutRef = useRef(null);
-  const onTimeoutRef = useRef(onTimeout);
-  const onTransactionEventRef = useRef(onTransactionEvent);
-  useEffect(() => {
-    onTimeoutRef.current = onTimeout;
-  }, [onTimeout]);
-  useEffect(() => {
-    onTransactionEventRef.current = onTransactionEvent;
-  }, [onTransactionEvent]);
-  const clearTransactionTimeout = useCallback(() => {
-    if (timeoutRef.current !== null) {
-      clearTimeout(timeoutRef.current);
-      timeoutRef.current = null;
-    }
-  }, []);
-  const settleTransaction = useCallback(
-    (id, type, details = {}) => {
-      const activeTransaction = activeTransactionRef.current;
-      if (!activeTransaction || activeTransaction.id !== id) return false;
-      clearTransactionTimeout();
-      activeTransactionRef.current = null;
-      const event = { ...details, endedAt: Date.now(), id, type };
-      const settledTransaction = settleDockTransaction(
-        activeTransaction,
-        event,
-        TRANSACTION_STATUS_MAP[type] || DOCK_TRANSACTION_STATUS.TIMED_OUT
-      );
-      dispatch(event);
-      onTransactionEventRef.current?.({
-        transaction: settledTransaction,
-        type
-      });
-      return true;
-    },
-    [clearTransactionTimeout]
-  );
-  const beginTransaction = useCallback(
-    ({
-      from,
-      source,
-      to
-    } = {}) => {
-      const activeTransaction = activeTransactionRef.current;
-      if (activeTransaction) {
-        settleTransaction(
-          activeTransaction.id,
-          DOCK_TRANSACTION_EVENTS.CANCEL,
-          { reason: DOCK_TRANSACTION_REASON.SUPERSEDED }
-        );
-      }
-      const transaction = createDockTransaction({
-        from,
-        id: ++nextTransactionIdRef.current,
-        source,
-        to
-      });
-      activeTransactionRef.current = transaction;
-      dispatch({ transaction, type: DOCK_TRANSACTION_EVENTS.START });
-      onTransactionEventRef.current?.({
-        transaction,
-        type: DOCK_TRANSACTION_EVENTS.START
-      });
-      const safeTimeout = Number(timeoutMs);
-      if (Number.isFinite(safeTimeout) && safeTimeout > 0) {
-        timeoutRef.current = setTimeout(() => {
-          if (!settleTransaction(
-            transaction.id,
-            DOCK_TRANSACTION_EVENTS.TIME_OUT,
-            { reason: DOCK_TRANSACTION_REASON.TIME_OUT }
-          ))
-            return;
-          onTimeoutRef.current?.(transaction);
-        }, safeTimeout);
-      }
-      return transaction;
-    },
-    [settleTransaction, timeoutMs]
-  );
-  const completeTransaction = useCallback(
-    (id) => settleTransaction(id, DOCK_TRANSACTION_EVENTS.COMPLETE),
-    [settleTransaction]
-  );
-  const cancelTransaction = useCallback(
-    (id, reason = null) => settleTransaction(id, DOCK_TRANSACTION_EVENTS.CANCEL, { reason }),
-    [settleTransaction]
-  );
-  const cancelActiveTransaction = useCallback(
-    (reason = null) => activeTransactionRef.current ? cancelTransaction(activeTransactionRef.current.id, reason) : false,
-    [cancelTransaction]
-  );
-  const failTransaction = useCallback(
-    (id, error) => settleTransaction(id, DOCK_TRANSACTION_EVENTS.FAIL, { error }),
-    [settleTransaction]
-  );
-  const completeTransactionForPath = useCallback(
-    (pathname) => {
-      const activeTransaction = activeTransactionRef.current;
-      if (!activeTransaction || !isSamePath(activeTransaction.to, pathname))
-        return false;
-      return completeTransaction(activeTransaction.id);
-    },
-    [completeTransaction]
-  );
-  const isTransactionCurrent = useCallback(
-    (id) => activeTransactionRef.current?.id === id,
-    []
-  );
-  useEffect(() => {
-    return () => {
-      clearTransactionTimeout();
-      activeTransactionRef.current = null;
-    };
-  }, [clearTransactionTimeout]);
-  return useMemo(
-    () => ({
-      activeTransaction: state.active,
-      beginTransaction,
-      cancelActiveTransaction,
-      cancelTransaction,
-      completeTransaction,
-      completeTransactionForPath,
-      failTransaction,
-      isTransactionCurrent,
-      lastTransaction: state.last
-    }),
-    [
-      state.active,
-      state.last,
-      beginTransaction,
-      cancelActiveTransaction,
-      cancelTransaction,
-      completeTransaction,
-      completeTransactionForPath,
-      failTransaction,
-      isTransactionCurrent
-    ]
-  );
-}
 
 // src/modules/dock/routing/navigation.ts
 function getRoutePolicyOverrides(item) {
@@ -3305,7 +3067,8 @@ function createDockTopology(items = [], { pathname = "" } = {}) {
   };
 }
 function useRoutePrefetch(router, {
-  intentDelayMs = DOCK_PREFETCH_INTENT_DELAY_MS
+  intentDelayMs = DOCK_PREFETCH_INTENT_DELAY_MS,
+  navigator: navigator2 = null
 } = {}) {
   const routeStatesRef = useRef(/* @__PURE__ */ new Map());
   const cancelRoutePrefetch = useCallback((href) => {
@@ -3317,7 +3080,7 @@ function useRoutePrefetch(router, {
   }, []);
   const prefetchRoute = useCallback(
     (href, { immediate = false } = {}) => {
-      if (!isSafeInternalHref(href) || typeof router?.prefetch !== "function")
+      if (!isSafeInternalHref(href) || !navigator2 && typeof router?.prefetch !== "function")
         return false;
       const routeState = routeStatesRef.current.get(href);
       if (routeState?.isPrefetched || routeState?.timeoutId != null)
@@ -3326,6 +3089,11 @@ function useRoutePrefetch(router, {
         const currentState = routeStatesRef.current.get(href);
         if (!currentState) return;
         currentState.timeoutId = null;
+        if (navigator2) {
+          routeStatesRef.current.delete(href);
+          navigator2.prefetch(href);
+          return;
+        }
         currentState.isPrefetched = true;
         try {
           router.prefetch(href, {
@@ -3352,7 +3120,7 @@ function useRoutePrefetch(router, {
       else nextState.timeoutId = setTimeout(startPrefetch, delay);
       return true;
     },
-    [intentDelayMs, router]
+    [intentDelayMs, navigator2, router]
   );
   useEffect(() => {
     const routeStates = routeStatesRef.current;
@@ -3430,6 +3198,25 @@ function emitDockEvent(eventType, data = {}) {
     ...data
   });
 }
+function useDockNavigator(router) {
+  const shared = useModule("navigation");
+  const [own] = useState(
+    () => shared ? null : createNavigator({ router })
+  );
+  useEffect(() => {
+    own?.setRouter(router);
+  }, [own, router]);
+  useEffect(() => own ? () => own.dispose() : void 0, [own]);
+  return useMemo(
+    () => own ?? { ...shared.actions, dispose: () => {
+    }, store: shared.store },
+    [own, shared]
+  );
+}
+var selectTrips = (state) => ({
+  active: state.active,
+  last: state.last
+});
 function useDockNavigation() {
   const pathname = usePathname();
   const { locationKey, syncLocationKey } = useDockLocationKey();
@@ -3446,95 +3233,78 @@ function useDockNavigation() {
     "useDockNavigation",
     "DockProvider"
   );
+  const navigator2 = useDockNavigator(router);
+  const { active: activeTransaction, last: lastTransaction } = useStore(
+    navigator2.store,
+    selectTrips,
+    shallowEqual
+  );
   const previousLocationKeyRef = useRef(locationKey);
-  const handleTransactionTimeout = useCallback(() => {
-    clearPreparedRouteReset();
-    stopLoading();
-  }, [clearPreparedRouteReset, stopLoading]);
-  const {
-    activeTransaction,
-    beginTransaction,
-    cancelActiveTransaction,
-    cancelTransaction,
-    completeTransactionForPath,
-    failTransaction,
-    isTransactionCurrent,
-    lastTransaction
-  } = useDockTransactions({
-    onTimeout: handleTransactionTimeout
-  });
+  const settledTripRef = useRef(lastTransaction);
+  useEffect(() => {
+    if (settledTripRef.current === lastTransaction) return;
+    settledTripRef.current = lastTransaction;
+    if (!lastTransaction) return;
+    if (lastTransaction.status === NAVIGATION_STATUS.COMPLETED) {
+      syncLocationKey();
+    } else if (lastTransaction.status === NAVIGATION_STATUS.TIMED_OUT || lastTransaction.status === NAVIGATION_STATUS.FAILED) {
+      clearPreparedRouteReset();
+      stopLoading();
+    }
+  }, [clearPreparedRouteReset, lastTransaction, stopLoading, syncLocationKey]);
   const cancelDock = useCallback(
     (reason = "guard") => {
-      cancelActiveTransaction(reason);
+      navigator2.cancel(reason);
       clearPreparedRouteReset();
       closeSurface({ cancelled: true, reason, success: false });
     },
-    [cancelActiveTransaction, clearPreparedRouteReset, closeSurface]
+    [clearPreparedRouteReset, closeSurface, navigator2]
   );
   const commitDock = useCallback(
-    ({
+    async ({
+      force = false,
       from,
       href,
+      item,
       routePolicy,
-      source = "dock",
-      transaction = null
+      source = "dock"
     }) => {
-      const activeRouteTransaction = transaction || beginTransaction({ from, source, to: href });
-      if (!isTransactionCurrent(activeRouteTransaction.id)) return false;
-      try {
-        continuity?.remember?.(from);
+      const result = await navigator2.navigate(href, {
+        force,
+        guard: guards.count() > 0 ? () => guards.check(href, from) : void 0,
+        onCommit: () => {
+          continuity?.remember?.(from);
+          blurActiveElement();
+          prepareRouteReset(routePolicy);
+          emitDockEvent(DOCK_EVENTS.NAVIGATE_START, { from, to: href });
+        },
+        source
+      });
+      if (result.ok) {
+        emitDockEvent(DOCK_EVENTS.NAVIGATE, { from, item, to: href });
+        return true;
+      }
+      if (result.blocked) {
         blurActiveElement();
-        prepareRouteReset(routePolicy);
-        emitDockEvent(DOCK_EVENTS.NAVIGATE_START, { from, to: href });
-        router.push(href);
-        emitDockEvent(DOCK_EVENTS.NAVIGATE, {
+        openDockGuardConfirmation({
+          closeSurface,
+          commit: (confirmed) => void commitDock({ ...confirmed, force: true }).catch(
+            (error) => report("Dock route transition", error)
+          ),
           from,
-          item: void 0,
-          to: href
+          href,
+          message: result.blocked.message,
+          routePolicy
         });
-        if (typeof window !== "undefined") {
-          const currentUrl = new URL(window.location.href);
-          const destinationUrl = new URL(href, window.location.origin);
-          if (normalizePath(currentUrl.pathname) === normalizePath(destinationUrl.pathname)) {
-            window.requestAnimationFrame(() => {
-              const currentLocKey = getDockLocationKey({
-                hash: window.location.hash,
-                pathname: window.location.pathname,
-                search: window.location.search
-              });
-              if (!isSamePath(currentLocKey, href) || !completeTransactionForPath(currentLocKey))
-                return;
-              emitDockEvent(DOCK_EVENTS.NAVIGATE_END, {
-                duration: void 0,
-                from,
-                to: currentLocKey
-              });
-              previousLocationKeyRef.current = currentLocKey;
-              syncLocationKey();
-              stopLoading();
-            });
-          }
-        }
-        return true;
-      } catch (error) {
-        clearPreparedRouteReset();
-        failTransaction(activeRouteTransaction.id, error);
-        stopLoading();
-        report("Dock route transition", error);
-        return false;
       }
+      return false;
     },
     [
-      beginTransaction,
-      clearPreparedRouteReset,
-      completeTransactionForPath,
+      closeSurface,
       continuity,
-      failTransaction,
-      isTransactionCurrent,
-      prepareRouteReset,
-      router,
-      stopLoading,
-      syncLocationKey
+      guards,
+      navigator2,
+      prepareRouteReset
     ]
   );
   const navigate = useCallback(
@@ -3550,62 +3320,27 @@ function useDockNavigation() {
         return false;
       }
       if (isSamePath(href, from)) return false;
-      const transaction = beginTransaction({ from, source, to: href });
       try {
-        if (!force && guards.count() > 0) {
-          const guardResult = await guards.check(href, from);
-          if (!isTransactionCurrent(transaction.id)) return false;
-          if (guardResult.blocked) {
-            cancelTransaction(transaction.id, "guard");
-            blurActiveElement();
-            openDockGuardConfirmation({
-              closeSurface,
-              commit: commitDock,
-              from,
-              href,
-              message: guardResult.message,
-              routePolicy
-            });
-            return false;
-          }
-        }
-        return commitDock({
-          from,
-          href,
-          routePolicy,
-          source,
-          transaction
-        });
+        return await commitDock({ force, from, href, routePolicy, source });
       } catch (error) {
-        failTransaction(transaction.id, error);
         stopLoading();
-        report("Dock navigation guard", error);
+        report("Dock navigation", error);
         return false;
       }
     },
-    [
-      guards,
-      beginTransaction,
-      cancelTransaction,
-      commitDock,
-      failTransaction,
-      isTransactionCurrent,
-      closeSurface,
-      locationKey,
-      stopLoading
-    ]
+    [commitDock, locationKey, stopLoading]
   );
   useEffect(() => {
+    navigator2.arrive(locationKey);
     if (previousLocationKeyRef.current === locationKey) return;
     emitDockEvent(DOCK_EVENTS.NAVIGATE_END, {
       duration: void 0,
       from: previousLocationKeyRef.current,
       to: locationKey
     });
-    completeTransactionForPath(locationKey);
     previousLocationKeyRef.current = locationKey;
     stopLoading();
-  }, [completeTransactionForPath, locationKey, stopLoading]);
+  }, [locationKey, navigator2, stopLoading]);
   return {
     activeTransaction,
     cancelDock,
@@ -3902,7 +3637,10 @@ function useDockCardItemModel({
   const [isHovered, setIsHovered] = useState(false);
   const pathname = usePathname();
   const router = useRouter();
-  const { cancelRoutePrefetch, prefetchRoute } = useRoutePrefetch(router);
+  const navigation = useModule("navigation");
+  const { cancelRoutePrefetch, prefetchRoute } = useRoutePrefetch(router, {
+    navigator: navigation?.actions
+  });
   const hasMedia = useDockHasMedia();
   const isTopHudActive = Boolean(isTop && isHudActive);
   const isCurrentActive = Boolean(
@@ -3984,7 +3722,7 @@ function useDockCardItemModel({
       hidden: headerRestore.hidden,
       visible: {
         ...visible,
-        transition: item.surfacePhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY ? dockMotion.transitions.surfaceEnter : visible.transition
+        transition: getDockPhaseMotion(dockMotion, item.surfacePhase).headerReturn ?? visible.transition
       },
       exit: headerRestore.exit
     };
@@ -4048,7 +3786,7 @@ function useDockCardItemModel({
     !expanded && position > 0 && !isExtensionShelf
   );
   const isCollapsedGhostCard = Boolean(
-    !expanded && position >= MAX_VISIBLE_STACKED_CARDS && !isExtensionShelf
+    !expanded && position >= dockMotion.deck.stacking.visible.stack && !isExtensionShelf
   );
   const {
     className: cardClassName,
@@ -4062,7 +3800,8 @@ function useDockCardItemModel({
     cardScale: itemStyle.scale,
     theme,
     isAnchoredToBottom: item.isSurface,
-    visibleCount: item.isStatus && !isStackHovered ? 1 : hasExtensions && !expanded ? 2 : 3,
+    stacking: dockMotion.deck.stacking,
+    visibleCount: item.isStatus && !isStackHovered ? dockMotion.deck.stacking.visible.status : hasExtensions && !expanded ? dockMotion.deck.stacking.visible.extensions : dockMotion.deck.stacking.visible.stack,
     hasExtensions
   });
   const cardDelay = useMemo(
@@ -6053,27 +5792,31 @@ function buildDockItems({
     return filterDockItems(flattenedItems, searchQuery);
   return flattenedItems;
 }
-function resolveBaseActiveItem({
+function resolveBaseActiveItemMatch({
   rawItems,
   dockItems,
   pathname,
   isNotFoundPage
 }) {
   const normalizedPathname = normalizePath(pathname);
+  const matched = (item) => ({
+    item,
+    isFallback: false
+  });
   const selectedDataSource = dockItems.find(
     (item) => item.isDataSource && item.isSelected
   );
-  if (selectedDataSource) return selectedDataSource;
+  if (selectedDataSource) return matched(selectedDataSource);
   if (isNotFoundPage)
-    return rawItems.find(isNotFoundItem) || rawItems[0] || null;
+    return matched(rawItems.find(isNotFoundItem) || rawItems[0] || null);
   const matchInDock = dockItems.find(
     (item) => isSamePath(item.path, normalizedPathname) || item.targetPath && isSamePath(item.targetPath, normalizedPathname)
   );
-  if (matchInDock) return matchInDock;
+  if (matchInDock) return matched(matchInDock);
   const matchInRaw = rawItems.find(
     (item) => isSamePath(item.path, normalizedPathname) || item.targetPath && isSamePath(item.targetPath, normalizedPathname)
   );
-  if (matchInRaw) return matchInRaw;
+  if (matchInRaw) return matched(matchInRaw);
   let prefixMatchedRawItem = null;
   let longestPrefixLength = -1;
   for (let i = 0; i < rawItems.length; i++) {
@@ -6084,11 +5827,65 @@ function resolveBaseActiveItem({
     }
   }
   if (prefixMatchedRawItem) {
-    return dockItems.find(
+    const item = dockItems.find(
       (entry) => isSamePath(entry?.path, prefixMatchedRawItem?.path) || entry?.name && entry.name === prefixMatchedRawItem?.name
     ) || prefixMatchedRawItem;
+    return {
+      item,
+      isFallback: normalizePath(prefixMatchedRawItem.path) === "/"
+    };
   }
-  return rawItems[0] || null;
+  return { item: rawItems[0] || null, isFallback: true };
+}
+function selectPendingRouteItem({
+  match,
+  heldItem,
+  pathname,
+  isHolding
+}) {
+  if (!match.isFallback || !isHolding || !heldItem) return match.item;
+  if (heldItem.path && isSamePath(heldItem.path, pathname)) return match.item;
+  return heldItem;
+}
+function usePendingRouteHold(pathname, match, {
+  holdMs = DOCK_PENDING_ROUTE_HOLD_MS,
+  isNavigating = false
+} = {}) {
+  const normalizedPathname = normalizePath(pathname);
+  const [lastMatched, setLastMatched] = useState(
+    () => match.isFallback ? null : match.item
+  );
+  const [hold, setHold] = useState(() => ({
+    isOpen: false,
+    pathname: normalizedPathname
+  }));
+  if (!match.isFallback && match.item !== lastMatched) {
+    setLastMatched(match.item);
+  }
+  if (hold.pathname !== normalizedPathname) {
+    setHold({ isOpen: true, pathname: normalizedPathname });
+  }
+  useEffect(() => {
+    if (!hold.isOpen || isNavigating) return;
+    const timer = setTimeout(
+      () => setHold(
+        (current) => current.pathname === hold.pathname ? { ...current, isOpen: false } : current
+      ),
+      holdMs
+    );
+    return () => clearTimeout(timer);
+  }, [hold, holdMs, isNavigating]);
+  const selected = selectPendingRouteItem({
+    heldItem: lastMatched,
+    isHolding: hold.isOpen && hold.pathname === normalizedPathname,
+    match,
+    pathname: normalizedPathname
+  });
+  const isHeld = selected !== match.item;
+  return useMemo(
+    () => isHeld && selected ? { ...selected, isRoutePending: true } : selected,
+    [isHeld, selected]
+  );
 }
 function resolveActiveItem({
   rawItems,
@@ -6103,14 +5900,15 @@ function resolveActiveItem({
   actionStackClass,
   surfaceActions,
   isPageLoading,
-  attention
+  attention,
+  baseActiveItem: resolvedBaseActiveItem
 }) {
-  const baseActiveItem = resolveBaseActiveItem({
+  const baseActiveItem = resolvedBaseActiveItem !== void 0 ? resolvedBaseActiveItem : resolveBaseActiveItemMatch({
     rawItems,
     dockItems,
     pathname,
     isNotFoundPage
-  });
+  }).item;
   if (!baseActiveItem) return null;
   if (attention?.kind === DOCK_ATTENTION_KIND.SURFACE)
     return applySurfaceToDockItem(
@@ -6162,7 +5960,7 @@ function useDockItems() {
   );
   return { rawItems };
 }
-function useDockDisplay(overridePathname) {
+function useDockDisplay(overridePathname, { isNavigating = false } = {}) {
   const routerPathname = usePathname();
   const pathname = overridePathname || routerPathname;
   const loadingState = useDockLoadingState();
@@ -6242,8 +6040,21 @@ function useDockDisplay(overridePathname) {
     () => buildDockItems({ rawItems, expanded, searchQuery, isNotFoundPage }),
     [rawItems, expanded, searchQuery, isNotFoundPage]
   );
+  const baseMatch = useMemo(
+    () => resolveBaseActiveItemMatch({
+      rawItems,
+      dockItems,
+      pathname,
+      isNotFoundPage
+    }),
+    [rawItems, dockItems, pathname, isNotFoundPage]
+  );
+  const baseActiveItem = usePendingRouteHold(pathname, baseMatch, {
+    isNavigating
+  });
   const activeItem = useMemo(
     () => resolveActiveItem({
+      baseActiveItem,
       rawItems,
       dockItems,
       pathname,
@@ -6268,6 +6079,7 @@ function useDockDisplay(overridePathname) {
       attention
     }),
     [
+      baseActiveItem,
       rawItems,
       dockItems,
       pathname,
@@ -6320,8 +6132,15 @@ function useDockLayout({
   const routePathname = usePathname();
   const pathname = overridePathname || routePathname;
   const { displayItems, displayActiveIndex } = useMemo(() => {
-    const items = dockItems || [];
-    const activeIndex = findDockItemIndex(items, activeItem ?? null, pathname);
+    const registeredItems = dockItems || [];
+    const registeredIndex = findDockItemIndex(
+      registeredItems,
+      activeItem ?? null,
+      pathname
+    );
+    const isHeldOutsideStack = registeredIndex === -1 && Boolean(activeItem?.isRoutePending);
+    const items = isHeldOutsideStack ? [activeItem, ...registeredItems] : registeredItems;
+    const activeIndex = isHeldOutsideStack ? 0 : registeredIndex;
     const itemsWithActiveItem = replaceActiveItem(
       items,
       activeIndex,
@@ -6346,8 +6165,7 @@ function useDockLayout({
   }, [pathname, dockItems, activeItem]);
   return {
     displayItems,
-    activeIndex: displayActiveIndex,
-    MAX_VISIBLE_STACKED_CARDS
+    activeIndex: displayActiveIndex
   };
 }
 function useDock() {
@@ -6376,7 +6194,9 @@ function useDock() {
     pathname
   } = core;
   const effectivePathname = activeTransaction?.to ? normalizePath(activeTransaction.to) : pathname;
-  const display = useDockDisplay(effectivePathname);
+  const display = useDockDisplay(effectivePathname, {
+    isNavigating: Boolean(activeTransaction)
+  });
   const { dockItems, activeItem, statusState, attention, topology } = display;
   const isHudModeActive = attention?.kind === DOCK_ATTENTION_KIND.HUD || attention?.kind === DOCK_ATTENTION_KIND.OPERATION;
   const isSurfaceActive = Boolean(activeItem?.isSurface);
@@ -6829,7 +6649,7 @@ var DockCardBanner = memo(function DockCardBanner2({
   const resolvedPosition = bannerPosition || bannerObj?.position || bannerObj?.bannerPosition || "center 45%";
   const resolvedSize = bannerSize || bannerObj?.size || bannerObj?.bannerSize || "cover";
   const resolvedRepeat = bannerRepeat || bannerObj?.repeat || bannerObj?.bannerRepeat || "no-repeat";
-  const resolvedOpacity = bannerOpacity ?? bannerObj?.opacity ?? bannerObj?.bannerOpacity ?? 0.95;
+  const resolvedOpacity = bannerOpacity ?? bannerObj?.opacity ?? bannerObj?.bannerOpacity ?? dockMotion.opacity.banner;
   return /* @__PURE__ */ jsxs(
     motion.div,
     {
@@ -6971,9 +6791,9 @@ var DockDescription = memo(function DockDescription2({
   const theme = useDockTheme();
   if (text == null || text === "") return null;
   const { className, inlineStyle } = splitStyle(style);
-  const { opacity = 0.7, ...restStyle } = inlineStyle;
+  const { opacity = dockMotion.opacity.description, ...restStyle } = inlineStyle;
   const isMultiline = Number(maxLines) > 1;
-  const targetOpacity = typeof opacity === "number" ? opacity : 0.7;
+  const targetOpacity = typeof opacity === "number" ? opacity : dockMotion.opacity.description;
   const sharedClass = cn(theme.slots.descriptionText, className);
   const sharedStyle = {
     opacity: targetOpacity,
@@ -7537,7 +7357,7 @@ var DockSurfaceControls = memo(function DockSurfaceControls2({
   const isControlsVisible = Boolean(
     isBodyVisible && (activeItem ? activeItem.isSurface !== false : true) && activeControlKeys.length > 0
   );
-  const targetY = hasExtensions ? DOCK_CARD_LAYOUT.extensionShelfY - DOCK_CARD_LAYOUT.collapsed.offsetY : 0;
+  const targetY = hasExtensions ? dockMotion.deck.stacking.shelf.offsetY - dockMotion.deck.stacking.collapsed.offsetY : 0;
   return /* @__PURE__ */ jsx(AnimatePresence, { children: isControlsVisible && /* @__PURE__ */ jsx(
     motion.div,
     {
@@ -7606,6 +7426,7 @@ var DockSurfaceControls = memo(function DockSurfaceControls2({
           motion.div,
           {
             layout: "position",
+            transition: getDockLayoutTransition(dockMotion),
             variants: dockMotion.variants.controlsClose,
             initial: "hidden",
             animate: "visible",
@@ -8180,7 +8001,7 @@ var DockCardItem = memo(function DockCardItem2({
                 initial: "hidden",
                 animate: item.surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION ? "hidden" : "visible",
                 exit: layerExit,
-                transition: item.surfacePhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION ? dockMotion.transitions.anticipation : dockMotion.transitions.headerSwap,
+                transition: getDockPhaseMotion(dockMotion, item.surfacePhase).header,
                 style: { ...DOCK_COMPOSITOR_STYLE, willChange: "transform" },
                 className: theme.slots.cardStandard,
                 children: item.isLoading ? /* @__PURE__ */ jsx(LoadingItemContent, {}) : /* @__PURE__ */ jsx(
@@ -8417,6 +8238,7 @@ var DockBreadcrumbsCard = memo(function DockBreadcrumbsCard2({
           motion.div,
           {
             layout: "position",
+            transition: getDockLayoutTransition(dockMotion),
             className: theme.slots.breadcrumbsItem,
             children: [
               isLast ? /* @__PURE__ */ jsx("span", { className: theme.slots.breadcrumbsCurrent, children: crumb.title }) : /* @__PURE__ */ jsx(
@@ -8496,7 +8318,7 @@ function Dock() {
         "data-controls-hidden": expanded || activeItem?.isSurface ? "true" : "false",
         style: {
           ...theme.styles.stack,
-          transformOrigin: "50% 100%"
+          transformOrigin: dockMotion.deck.origin
         },
         initial: false,
         animate: getDockStackAnimateProps(dockMotion, {
@@ -9885,7 +9707,7 @@ var dockModule = defineModule({
   context: DockContext,
   Provider: DockModuleProvider,
   Overlay: Dock,
-  uses: ["loading", "media", "notification"],
+  uses: ["loading", "media", "navigation", "notification"],
   registry: {
     cleanupDelayMs: 600,
     keyPolicy: "path",
@@ -9901,5 +9723,5 @@ var dockModule = defineModule({
 });
 
 export { DOCK_EVENTS, DOCK_HUD_PRIORITY, DOCK_HUD_RENDER_MODE, DOCK_HUD_VARIANT, Dock, DockCardBanner, DockCardHeader, DockDescription, DockIcon, DockProvider, DockSurfaceAction, DockSurfaceExtension, DockSurfaceHeaderButton, DockTitle, ErrorActions, GuardActions, createDockGuardRegistry, createErrorStatus, createGuardStatus, createInlineSurfaceEntry, createSurfaceEntryDefinition, createSurfaceFlowBuilder, defineBreadcrumb, defineDockAction, defineHud, defineStepSurface, defineSurface, dockModule, dockTheme, isValidBannerUrl, useDock, useDockActionClass, useDockActions, useDockBanner, useDockConfig, useDockContextActions, useDockDimensions, useDockGuard, useDockHeight, useDockHud, useDockMotion, useDockRegistration, useDockSelector, useDockState, useDockTheme, useHud, useOptionalDockActions, useOptionalDockState, useSurface, useSurfaceAction, useSurfaceDimensions, useSurfaceFlow, useSurfaceHeader, useSurfaceId, useSurfaceReturn, useSurfaceStep };
-//# sourceMappingURL=chunk-A5RE3F6O.js.map
-//# sourceMappingURL=chunk-A5RE3F6O.js.map
+//# sourceMappingURL=chunk-WVRMABDN.js.map
+//# sourceMappingURL=chunk-WVRMABDN.js.map