@acorex-platform/framework-client 1.0.1 → 1.0.2

package/fesm2022/acorex-platform-framework-client-layout-views.mjs

@@ -14,7 +14,7 @@ import { AXDecoratorModule } from '@acorex/components/decorators';
 import * as i6 from '@acorex/components/dropdown';
 import { AXDropdownModule } from '@acorex/components/dropdown';
 import { AXDropdownButtonModule } from '@acorex/components/dropdown-button';
-import { AXPTabNavigationService, axpSplitCollapsedBreadcrumbs, AXPStickyDirective, AXPCommonSettings, AXPHomePageService, AXPSettingsService, AXPTabPreviewService, AXPUnsavedChangesConfirmService, AXPBrowserTitleService, AXPEntityDetailsNavTrailService, axpJoinTabTitleSegments, normalizeRouterUrl, AXP_HOME_TAB_KEY, axpResolveTabKey, axpIsEntityListPath, axpParseEntityListRoute, axpGetEntityListReturnUrl, axpIsEntityDetailsPath, axpParseEntityDetailsRoute, axpSetEntityDetailsPageQuery, axpIsEntityDetailsViewRoute, AXPNotFoundError, AXP_NOT_FOUND_ROUTE, AXPUnsavedChangesPopstateService, createUnsavedChangesCanDeactivateGuard } from '@acorex-platform/framework-client/common';
+import { AXPTabNavigationService, axpSplitCollapsedBreadcrumbs, AXPStickyDirective, AXPCommonSettings, AXPHomePageService, AXPSettingsService, AXPTabPreviewService, AXPUnsavedChangesConfirmService, AXPBrowserTitleService, AXPEntityDetailsNavTrailService, axpJoinTabTitleSegments, axpGetLeafRouteSnapshot, normalizeRouterUrl, AXP_HOME_TAB_KEY, axpResolveTabKey, axpIsEntityListPath, axpParseEntityListRoute, axpGetEntityListReturnUrl, axpIsEntityDetailsPath, axpParseEntityDetailsRoute, axpSetEntityDetailsPageQuery, axpIsEntityDetailsViewRoute, AXPNotFoundError, AXP_NOT_FOUND_ROUTE, AXPUnsavedChangesPopstateService, createUnsavedChangesCanDeactivateGuard } from '@acorex-platform/framework-client/common';
 import * as i9 from '@acorex-platform/framework-client/core';
 import { AXPDeviceService, AXPComponentSlotModule, AXPDebugService, OVERLAY_DETAILS_VIEW_TRACE_NS, AXPExpressionEvaluatorService, AXPContextEvalFactory, normalizeKeyboardShortcuts, AXPContextStore, AXPEntityBroadcastService, AXPKeyboardShortcutRegistry } from '@acorex-platform/framework-client/core';
 import * as i1 from '@acorex/cdk/drawer';
@@ -30,7 +30,7 @@ import { AXToastService } from '@acorex/components/toast';
 import { AXFormatService, AXFormatModule } from '@acorex/core/format';
 import { AXPSessionService } from '@acorex-platform/framework-client/auth';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
-import { Router, NavigationEnd, ActivatedRoute } from '@angular/router';
+import { Router, ActivatedRoute, NavigationEnd } from '@angular/router';
 import { isEmpty, cloneDeep, get } from 'lodash-es';
 import { filter } from 'rxjs/operators';
 import { AXBasePageComponent } from '@acorex/components/page';
@@ -263,6 +263,7 @@ class AXPPageLayoutBaseComponent {
         this.unsavedChangesConfirm = inject(AXPUnsavedChangesConfirmService);
         this.browserTitleService = inject(AXPBrowserTitleService);
         this.router = inject(Router);
+        this.pageLayoutRoute = inject(ActivatedRoute);
         this.navTrailService = inject(AXPEntityDetailsNavTrailService);
         this.pageLayoutDestroyRef = inject(DestroyRef);
         //#endregion
@@ -324,7 +325,7 @@ class AXPPageLayoutBaseComponent {
             this.title.set(await this.getPageTitle());
             const icon = await this.getPageIcon();
             this.titleIcon.set(icon);
-            if (this.tabNavigation.effectiveMode() === 'tabular') {
+            if (this.tabNavigation.effectiveMode() === 'tabular' && this.canPublishActiveTabChrome()) {
                 const tabKey = this.pageTabKey();
                 if (tabKey && icon) {
                     this.tabNavigation.syncTabIcon(tabKey, icon);
@@ -410,15 +411,30 @@ class AXPPageLayoutBaseComponent {
             if (isActiveForNavTrail && this.isActivePageForNavTrail()) {
                 this.navTrailService.setActiveTrail(breadCrumbs);
             }
-            if (this.tabNavigation.effectiveMode() === 'tabular') {
+            if (this.tabNavigation.effectiveMode() === 'tabular' && this.canPublishActiveTabChrome()) {
                 const tabKey = this.pageTabKey();
-                const tabTitleSegments = await this.resolveBreadcrumbTabTitleSegments(breadCrumbs);
-                let tabTitle = tabTitleSegments.length ? axpJoinTabTitleSegments(tabTitleSegments) : null;
-                if (!tabTitle) {
-                    tabTitle = await this.resolvePageTitleForTab();
+                const routeTabTitle = await Promise.resolve(this.getRouteTabTitle());
+                if (!tabKey || this.pageTabKey() !== tabKey || this.tabNavigation.activeKey() !== tabKey) {
+                    return;
+                }
+                if (typeof routeTabTitle === 'string' && routeTabTitle.trim()) {
+                    this.tabNavigation.syncTabTitle(tabKey, routeTabTitle.trim());
                 }
-                if (tabKey && tabTitle) {
-                    this.tabNavigation.syncTabTitle(tabKey, tabTitleSegments.length ? tabTitleSegments : tabTitle);
+                else if (Array.isArray(routeTabTitle) && routeTabTitle.length) {
+                    this.tabNavigation.syncTabTitle(tabKey, routeTabTitle);
+                }
+                else {
+                    const tabTitleSegments = await this.resolveBreadcrumbTabTitleSegments(breadCrumbs);
+                    let tabTitle = tabTitleSegments.length ? axpJoinTabTitleSegments(tabTitleSegments) : null;
+                    if (!tabTitle) {
+                        tabTitle = await this.resolvePageTitleForTab();
+                    }
+                    if (this.pageTabKey() !== tabKey || this.tabNavigation.activeKey() !== tabKey) {
+                        return;
+                    }
+                    if (tabTitle) {
+                        this.tabNavigation.syncTabTitle(tabKey, tabTitleSegments.length ? tabTitleSegments : tabTitle);
+                    }
                 }
             }
         }, /* @ts-ignore */
@@ -507,9 +523,35 @@ class AXPPageLayoutBaseComponent {
         this.router.events
             .pipe(filter((event) => event instanceof NavigationEnd), takeUntilDestroyed(this.pageLayoutDestroyRef))
             .subscribe(() => {
+            this.syncOwnedPageTabKey();
             void this.publishBrowserTitleIfActive();
         });
     }
+    /**
+     * Follows the scoped tab when this instance is the active route (settings scope changes).
+     * Cached background pages keep the key captured at init.
+     */
+    syncOwnedPageTabKey() {
+        if (this.tabNavigation.effectiveMode() !== 'tabular' || !this.isOwningActiveRoute()) {
+            return;
+        }
+        const nextKey = this.resolvePageTabKey();
+        if (nextKey !== this.pageTabKey()) {
+            this.pageTabKey.set(nextKey);
+        }
+    }
+    /** True when this page's route snapshot is in the active router tree. */
+    isOwningActiveRoute() {
+        const own = this.pageLayoutRoute.snapshot;
+        const leaf = axpGetLeafRouteSnapshot(this.router.routerState.snapshot.root);
+        return leaf.pathFromRoot.includes(own);
+    }
+    /** True when this page may publish chrome onto its route tab. */
+    canPublishActiveTabChrome() {
+        const pageKey = this.pageTabKey();
+        const activeKey = this.tabNavigation.activeKey();
+        return !!pageKey && !!activeKey && pageKey === activeKey;
+    }
     /** Maps the home-page route to the pinned home tab key instead of a path-based key. */
     resolvePageTabKey() {
         const homePath = this.homePageService.getCurrent().path;
@@ -632,6 +674,13 @@ class AXPPageLayoutBaseComponent {
     getPageBreadcrumbs() {
         return [];
     }
+    /**
+     * Route-tab label for this page. Return a scope title when child routes are internal
+     * (settings groups). Null keeps the breadcrumb / page-title fallback.
+     */
+    getRouteTabTitle() {
+        return null;
+    }
     /** Collects resolved breadcrumb labels (Home excluded upstream) for tab chrome. */
     async resolveBreadcrumbTabTitleSegments(pageBreadcrumbs) {
         const segments = [];
@@ -1123,6 +1172,14 @@ const AXPLayoutDetailsViewViewModel = signalStore(withState(() => {
         const page = router.parseUrl(router.url).queryParams['page'];
         return typeof page === 'string' && page.length > 0 ? page : null;
     };
+    /** Keep caller history state (for example related-list field hides) across in-page navigations. */
+    const callerNavigationState = () => {
+        if (typeof history === 'undefined' || history.state == null || typeof history.state !== 'object') {
+            return undefined;
+        }
+        const { navigationId: _navigationId, ...rest } = history.state;
+        return Object.keys(rest).length > 0 ? rest : undefined;
+    };
     /** Loads page data, context, and evaluated widgets for the target sidebar page. */
     const activatePageById = async (pageId, forceRefresh) => {
         const activation = pageActivationChain.then(() => runPageActivation(pageId, forceRefresh));
@@ -1391,6 +1448,7 @@ const AXPLayoutDetailsViewViewModel = signalStore(withState(() => {
                     queryParams: { page: resolvedPage.id },
                     queryParamsHandling: 'merge',
                     replaceUrl: true,
+                    ...(callerNavigationState() ? { state: callerNavigationState() } : {}),
                 });
             }
             await this.loadPage(pageId, forceRefresh);
@@ -1531,6 +1589,7 @@ const AXPLayoutDetailsViewViewModel = signalStore(withState(() => {
                             queryParams: { page: page.id, filters: null },
                             queryParamsHandling: 'merge',
                             replaceUrl: false,
+                            ...(callerNavigationState() ? { state: callerNavigationState() } : {}),
                         });
                     }
                     void activatePageById(page.id);
@@ -1549,6 +1608,7 @@ const AXPLayoutDetailsViewViewModel = signalStore(withState(() => {
                         queryParamsHandling: 'merge',
                         // Push history for desktop sidebar switches and mobile page-list picks.
                         replaceUrl: false,
+                        ...(callerNavigationState() ? { state: callerNavigationState() } : {}),
                     });
                     return;
                 }
@@ -1568,6 +1628,7 @@ const AXPLayoutDetailsViewViewModel = signalStore(withState(() => {
                         relativeTo: route,
                         queryParams: currentParams,
                         replaceUrl: true,
+                        ...(callerNavigationState() ? { state: callerNavigationState() } : {}),
                     });
                 }
             }