@ionic/react-router 8.8.1-dev.11774029927.130994f5 → 8.8.1-dev.11774384072.1e807ca8

package/dist/index.js

@@ -1556,6 +1556,26 @@ class StackManager extends React.PureComponent {
         this.forceUpdate();
         return true;
     }
+    /**
+     * Handles root navigation by unmounting all non-entering views in this outlet.
+     * Fires ionViewWillLeave / ionViewDidLeave only on views that are currently visible.
+     * Views that are mounted but not visible (e.g., pages earlier in the back stack)
+     * are silently unmounted without lifecycle events, consistent with the behavior
+     * of out-of-scope outlet cleanup.
+     */
+    handleRootNavigation(enteringViewItem) {
+        const allViewsInOutlet = this.context.getViewItemsForOutlet(this.id);
+        allViewsInOutlet.forEach((viewItem) => {
+            if (viewItem === enteringViewItem) {
+                return;
+            }
+            if (viewItem.ionPageElement && isViewVisible(viewItem.ionPageElement)) {
+                viewItem.ionPageElement.dispatchEvent(new CustomEvent('ionViewWillLeave', { bubbles: false, cancelable: false }));
+                viewItem.ionPageElement.dispatchEvent(new CustomEvent('ionViewDidLeave', { bubbles: false, cancelable: false }));
+            }
+            this.context.unMountViewItem(viewItem);
+        });
+    }
     /**
      * Handles nested outlet with relative routes but no parent path. Returns true to abort.
      */
@@ -2044,14 +2064,20 @@ class StackManager extends React.PureComponent {
         // Find entering and leaving view items
         const viewItems = this.findViewItems(routeInfo);
         let enteringViewItem = viewItems.enteringViewItem;
-        const leavingViewItem = viewItems.leavingViewItem;
-        const shouldUnmountLeavingViewItem = this.shouldUnmountLeavingView(routeInfo, enteringViewItem, leavingViewItem);
+        let leavingViewItem = viewItems.leavingViewItem;
+        let shouldUnmountLeavingViewItem = this.shouldUnmountLeavingView(routeInfo, enteringViewItem, leavingViewItem);
         // Get parent path for nested outlets
         const parentPath = this.getParentPath();
         // Handle out-of-scope outlet (route outside mount path)
         if (this.handleOutOfScopeOutlet(routeInfo)) {
             return;
         }
+        // Handle root navigation: unmount all non-entering views
+        if (routeInfo.routeDirection === 'root') {
+            this.handleRootNavigation(enteringViewItem);
+            leavingViewItem = undefined;
+            shouldUnmountLeavingViewItem = false;
+        }
         // Clear any pending out-of-scope unmount timeout
         if (this.outOfScopeUnmountTimeout) {
             clearTimeout(this.outOfScopeUnmountTimeout);
@@ -2769,34 +2795,14 @@ const IonRouter = ({ children, registerHistoryListener }) => {
      * @param action The action that triggered the history change.
      */
     const handleHistoryChange = (location, action) => {
-        var _a, _b, _c, _d, _e;
-        let leavingLocationInfo;
+        var _a, _b, _c, _d;
         /**
-         * A programmatic navigation was triggered.
-         * e.g., `<Navigate />`, `navigate()`, or `handleNavigate()`
+         * The leaving location is always the current route, for both programmatic
+         * and external navigations. Using `previous()` for replace actions was
+         * incorrect: it caused the equality check below to skip navigation when
+         * the replace destination matched the entry two slots back in history.
          */
-        if (incomingRouteParams.current) {
-            /**
-             * The current history entry is overwritten, so the previous entry
-             * is the one we are leaving.
-             */
-            if (((_a = incomingRouteParams.current) === null || _a === void 0 ? void 0 : _a.routeAction) === 'replace') {
-                leavingLocationInfo = locationHistory.current.previous();
-            }
-            else {
-                // If the action is 'push' or 'pop', we want to use the current route.
-                leavingLocationInfo = locationHistory.current.current();
-            }
-        }
-        else {
-            /**
-             * An external navigation was triggered
-             * e.g., browser back/forward button or direct link
-             *
-             * The leaving location is the current route.
-             */
-            leavingLocationInfo = locationHistory.current.current();
-        }
+        const leavingLocationInfo = locationHistory.current.current();
         const leavingUrl = leavingLocationInfo.pathname + leavingLocationInfo.search;
         if (leavingUrl !== location.pathname + location.search) {
             if (!incomingRouteParams.current) {
@@ -2898,7 +2904,7 @@ const IonRouter = ({ children, registerHistoryListener }) => {
              * An existing id indicates that it's re-activating an existing route.
              * e.g., tab switching or navigating back to a previous route
              */
-            if ((_b = incomingRouteParams.current) === null || _b === void 0 ? void 0 : _b.id) {
+            if ((_a = incomingRouteParams.current) === null || _a === void 0 ? void 0 : _a.id) {
                 routeInfo = Object.assign(Object.assign({}, incomingRouteParams.current), { lastPathname: leavingLocationInfo.pathname });
                 locationHistory.current.add(routeInfo);
                 /**
@@ -2907,9 +2913,9 @@ const IonRouter = ({ children, registerHistoryListener }) => {
                  */
             }
             else {
-                const isPushed = ((_c = incomingRouteParams.current) === null || _c === void 0 ? void 0 : _c.routeAction) === 'push' &&
+                const isPushed = ((_b = incomingRouteParams.current) === null || _b === void 0 ? void 0 : _b.routeAction) === 'push' &&
                     incomingRouteParams.current.routeDirection === 'forward';
-                routeInfo = Object.assign(Object.assign({ id: generateId('routeInfo') }, incomingRouteParams.current), { lastPathname: leavingLocationInfo.pathname, pathname: location.pathname, search: location.search, params: ((_d = incomingRouteParams.current) === null || _d === void 0 ? void 0 : _d.params)
+                routeInfo = Object.assign(Object.assign({ id: generateId('routeInfo') }, incomingRouteParams.current), { lastPathname: leavingLocationInfo.pathname, pathname: location.pathname, search: location.search, params: ((_c = incomingRouteParams.current) === null || _c === void 0 ? void 0 : _c.params)
                         ? filterUndefinedParams(incomingRouteParams.current.params)
                         : {}, prevRouteLastPathname: leavingLocationInfo.lastPathname });
                 if (isPushed) {
@@ -2949,7 +2955,7 @@ const IonRouter = ({ children, registerHistoryListener }) => {
                         routeInfo.pushedByRoute = lastRoute === null || lastRoute === void 0 ? void 0 : lastRoute.pushedByRoute;
                     }
                     else {
-                        routeInfo.pushedByRoute = (_e = lastRoute === null || lastRoute === void 0 ? void 0 : lastRoute.pushedByRoute) !== null && _e !== void 0 ? _e : leavingLocationInfo.pathname;
+                        routeInfo.pushedByRoute = (_d = lastRoute === null || lastRoute === void 0 ? void 0 : lastRoute.pushedByRoute) !== null && _d !== void 0 ? _d : leavingLocationInfo.pathname;
                     }
                     // Triggered by `navigate()` with replace or a `<Navigate />` component, etc.
                 }
@@ -3058,6 +3064,7 @@ const IonRouter = ({ children, registerHistoryListener }) => {
      *
      * @param tab The tab to set as active.
      */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const handleSetCurrentTab = (tab, _routeInfo) => {
         currentTab.current = tab;
         const current = locationHistory.current.current();
@@ -3090,9 +3097,9 @@ const IonRouter = ({ children, registerHistoryListener }) => {
      * @param routeAnimation A custom animation builder to override the
      * default "back" animation.
      */
-    const handleNavigateBack = (defaultHref = '/', routeAnimation) => {
+    const handleNavigateBack = (defaultHref, routeAnimation) => {
         const config = getConfig();
-        defaultHref = defaultHref ? defaultHref : config && config.get('backButtonDefaultHref');
+        defaultHref = defaultHref !== null && defaultHref !== void 0 ? defaultHref : (config && config.get('backButtonDefaultHref'));
         const routeInfo = locationHistory.current.current();
         // It's a linear navigation.
         if (routeInfo && routeInfo.pushedByRoute) {
@@ -3131,18 +3138,19 @@ const IonRouter = ({ children, registerHistoryListener }) => {
                  * the history stack.
                  */
             }
-            else {
+            else if (defaultHref) {
                 handleNavigate(defaultHref, 'pop', 'back', routeAnimation);
             }
             /**
              * No `pushedByRoute` (e.g., initial page load or tab root).
-             * Tabs with no back history should not navigate.
+             * Navigate to defaultHref so the back button works on direct
+             * deep-link loads (e.g., loading /tab1/child directly).
+             * Only navigate when defaultHref is explicitly set. The core
+             * back-button component hides itself when no defaultHref is
+             * provided, so a click here means the user set one intentionally.
              */
         }
-        else {
-            if (routeInfo && routeInfo.tab) {
-                return;
-            }
+        else if (defaultHref) {
             handleNavigate(defaultHref, 'pop', 'back', routeAnimation);
         }
     };
@@ -3196,6 +3204,24 @@ const IonRouter = ({ children, registerHistoryListener }) => {
             routeAnimation, tab: navigationTab });
         navigate(path, { replace: routeAction !== 'push' });
     };
+    /**
+     * Navigates to a new root path, clearing Ionic's navigation history so that
+     * canGoBack() returns false after the transition. All previously mounted views
+     * are unmounted. Useful for post-login / post-logout root navigation.
+     *
+     * @param pathname The path to navigate to.
+     * @param routeAnimation An optional custom animation builder.
+     */
+    const handleNavigateRoot = (pathname, routeAnimation) => {
+        currentTab.current = undefined;
+        forwardStack.current = [];
+        incomingRouteParams.current = {
+            routeAction: 'replace',
+            routeDirection: 'root',
+            routeAnimation,
+        };
+        navigate(pathname, { replace: true });
+    };
     const routeMangerContextValue = {
         canGoBack: () => locationHistory.current.canGoBack(),
         clearOutlet: viewStack.current.clear,
@@ -3210,7 +3236,7 @@ const IonRouter = ({ children, registerHistoryListener }) => {
         unMountViewItem: viewStack.current.remove,
     };
     return (React.createElement(RouteManagerContext.Provider, { value: routeMangerContextValue },
-        React.createElement(NavManager, { ionRoute: IonRouteInner, stackManager: StackManager, routeInfo: routeInfo, onNativeBack: handleNativeBack, onNavigateBack: handleNavigateBack, onNavigate: handleNavigate, onSetCurrentTab: handleSetCurrentTab, onChangeTab: handleChangeTab, onResetTab: handleResetTab, locationHistory: locationHistory.current }, children)));
+        React.createElement(NavManager, { ionRoute: IonRouteInner, stackManager: StackManager, routeInfo: routeInfo, onNativeBack: handleNativeBack, onNavigateBack: handleNavigateBack, onNavigate: handleNavigate, onNavigateRoot: handleNavigateRoot, onSetCurrentTab: handleSetCurrentTab, onChangeTab: handleChangeTab, onResetTab: handleResetTab, locationHistory: locationHistory.current }, children)));
 };
 IonRouter.displayName = 'IonRouter';