@acorex/platform 21.0.0-next.85 → 21.0.0-next.89

package/types/acorex-platform-layout-views.d.ts

@@ -1,28 +1,28 @@
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _angular_core from '@angular/core';
-import { Signal, OnInit, OnDestroy } from '@angular/core';
+import { Signal, InjectionToken, OnInit, OnDestroy } from '@angular/core';
 import * as _acorex_platform_themes_shared from '@acorex/platform/themes/shared';
 import { AXClickEvent } from '@acorex/cdk/common';
+import { AXPTabNavigationService, AXPHomePageService, AXPSettingsService, AXPTabPreviewService, AXPUnsavedChangesConfirmService, AXPBrowserTitleService, AXPEntityCommandScope } from '@acorex/platform/common';
 import * as i1 from '@acorex/cdk/drawer';
 import { AXDrawerItemDirective } from '@acorex/cdk/drawer';
+import { AXPBreadcrumbItem, AXPMultiLanguageString, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPExecuteCommandResult } from '@acorex/platform/contracts';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActionMenuItem, AXPBreadcrumbItem, AXPMultiLanguageString, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPKeyboardShortcut, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent, AXPKeyboardShortcutChord } from '@acorex/platform/core';
+import { AXPActionMenuItem, AXPDeviceService, AXPKeyboardShortcut, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent, AXPKeyboardShortcutChord } from '@acorex/platform/core';
 import { AXPCommandService, AXPPolicyEngineService } from '@acorex/platform/runtime';
 import { AXPWorkflowService } from '@acorex/platform/workflow';
-import * as _acorex_core_translation from '@acorex/core/translation';
-import { AXTranslationService } from '@acorex/core/translation';
 import { AXToastService } from '@acorex/components/toast';
 import { AXFormatService } from '@acorex/core/format';
+import { AXTranslationService } from '@acorex/core/translation';
 import { AXPSessionService } from '@acorex/platform/auth';
-import { AXPHomePageService, AXPSettingsService, AXPEntityCommandScope } from '@acorex/platform/common';
+import * as _angular_router from '@angular/router';
+import { Router, ActivatedRoute } from '@angular/router';
 import { AXBasePageComponent } from '@acorex/components/page';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPPageStatus as AXPPageStatus$1, AXPWidgetContainerComponent } from '@acorex/platform/layout/widget-core';
 import * as _acorex_platform_layout_views from '@acorex/platform/layout/views';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXTabStripChangedEvent } from '@acorex/components/tabs';
-import * as _angular_router from '@angular/router';
-import { Router, ActivatedRoute } from '@angular/router';
 
 declare abstract class AXPPageLayoutBase {
     abstract primaryMenuItems: Signal<AXPActionMenuItem[]>;
@@ -82,6 +82,7 @@ declare class AXPPageLayoutComponent {
         isSystemMode: _angular_core.Signal<boolean>;
         isSideMenuOpen: _angular_core.Signal<boolean>;
         isOverlayLoading: _angular_core.Signal<boolean>;
+        overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -95,6 +96,7 @@ declare class AXPPageLayoutComponent {
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
+        clearOverlayLoading: () => void;
         loadSettings: () => Promise<void>;
     } & _ngrx_signals.StateSource<{
         currentMode: _acorex_platform_themes_shared.AXPThemeMode;
@@ -117,6 +119,7 @@ declare class AXPPageLayoutComponent {
         isPrinting: boolean;
     }>;
     protected deviceService: AXPDeviceService;
+    protected tabNavigation: AXPTabNavigationService;
     protected startSideDrawer: _angular_core.Signal<AXDrawerItemDirective | undefined>;
     protected workflow: AXPWorkflowService;
     protected commandService: AXPCommandService;
@@ -165,6 +168,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         isSystemMode: _angular_core.Signal<boolean>;
         isSideMenuOpen: _angular_core.Signal<boolean>;
         isOverlayLoading: _angular_core.Signal<boolean>;
+        overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -178,6 +182,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
+        clearOverlayLoading: () => void;
         loadSettings: () => Promise<void>;
     } & _ngrx_signals.StateSource<{
         currentMode: _acorex_platform_themes_shared.AXPThemeMode;
@@ -206,26 +211,65 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected readonly homePageService: AXPHomePageService;
     protected readonly policyService: AXPPolicyEngineService;
     protected readonly settingsService: AXPSettingsService;
+    protected readonly tabNavigation: AXPTabNavigationService;
+    protected readonly tabPreviewService: AXPTabPreviewService;
+    protected readonly unsavedChangesConfirm: AXPUnsavedChangesConfirmService;
+    protected readonly browserTitleService: AXPBrowserTitleService;
+    protected readonly router: Router;
+    private readonly pageLayoutDestroyRef;
     private _updateTrigger;
+    /** Tab key captured at page init — stable while the route instance is cached. */
+    private readonly pageTabKey;
     protected updateTrigger: _angular_core.Signal<number>;
     protected recompute(): void;
     ngOnInit(): Promise<void>;
-    title: _angular_core.WritableSignal<_acorex_core_translation.AXMultiLanguageString>;
+    /** Maps the home-page route to the pinned home tab key instead of a path-based key. */
+    private resolvePageTabKey;
+    /** Stable tab key for this cached page instance (tabular mode). */
+    protected getPageTabKey(): string | null;
+    protected publishTabStructuredPreview(tabKey: string, input: {
+        titleValue: AXPMultiLanguageString;
+        descriptionValue: AXPMultiLanguageString | null;
+        icon: string | null;
+        breadcrumbItems: AXPBreadcrumbItem[];
+        isDirty: boolean;
+    }): Promise<void>;
+    protected resolveMultiLanguageText(value: AXPMultiLanguageString | null | undefined, fallback: string): Promise<string>;
+    /** Resolves i18n keys (`@scope:key`); returns plain text unchanged. */
+    protected translateTextIfKey(text: string): Promise<string>;
+    title: _angular_core.WritableSignal<AXPMultiLanguageString>;
     titleIcon: _angular_core.WritableSignal<string | null>;
     protected getPageTitle(): AXPMultiLanguageString | Promise<AXPMultiLanguageString>;
     protected getPageIcon(): string | null | Promise<string | null>;
     hasTitle: _angular_core.Signal<boolean>;
     hasTitleIcon: _angular_core.Signal<boolean>;
-    description: _angular_core.WritableSignal<_acorex_core_translation.AXMultiLanguageString | null>;
+    /** Publishes the page title to the browser tab when this instance is the active route. */
+    protected publishBrowserTitleIfActive(): Promise<void>;
+    /** True when this cached page instance matches the current router location. */
+    protected isActivePageForBrowserTitle(): boolean;
+    description: _angular_core.WritableSignal<AXPMultiLanguageString | null>;
     hasDescription: _angular_core.Signal<boolean>;
     protected getPageDescription(): AXPMultiLanguageString | null | Promise<AXPMultiLanguageString | null>;
     private defaultBreadCrumbs;
     breadcrumbs: _angular_core.WritableSignal<AXPBreadcrumbItem[]>;
     hasBreadcrumbs: _angular_core.Signal<boolean>;
     protected getPageBreadcrumbs(): AXPBreadcrumbItem[] | Promise<AXPBreadcrumbItem[]>;
+    /** Collects resolved breadcrumb labels (Home excluded upstream) for tab chrome. */
+    protected resolveBreadcrumbTabTitleSegments(pageBreadcrumbs: AXPBreadcrumbItem[]): Promise<string[]>;
+    /** Joins breadcrumb segments as the stored tab title string. */
+    protected resolveBreadcrumbTabTitle(pageBreadcrumbs: AXPBreadcrumbItem[]): Promise<string | null>;
+    /** Resolves a breadcrumb label the same way as page chrome (`t(item.title)`). */
+    protected resolveBreadcrumbItemTitle(item: AXPBreadcrumbItem | undefined): Promise<string | null>;
+    /** Fallback tab label from the page title when breadcrumbs are not ready yet. */
+    protected resolvePageTitleForTab(): Promise<string | null>;
     badge: _angular_core.WritableSignal<AXPBadge | null>;
     hasBadge: _angular_core.Signal<boolean>;
     hasUnsavedChanges(): boolean;
+    /**
+     * Confirms closing this page as a background tab (no router navigation).
+     * Override when dirty detection differs from {@link hasUnsavedChanges}.
+     */
+    onBeforeTabClose(): boolean | Promise<boolean>;
     protected getPageBadge(): Promise<AXPBadge | null>;
     resolvePageBadge(): Promise<AXPBadge | null>;
     status: _angular_core.WritableSignal<AXPPageStatus | null>;
@@ -308,6 +352,7 @@ declare class AXPPopupLayoutComponent {
         isSystemMode: _angular_core.Signal<boolean>;
         isSideMenuOpen: _angular_core.Signal<boolean>;
         isOverlayLoading: _angular_core.Signal<boolean>;
+        overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -321,6 +366,7 @@ declare class AXPPopupLayoutComponent {
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
+        clearOverlayLoading: () => void;
         loadSettings: () => Promise<void>;
     } & _ngrx_signals.StateSource<{
         currentMode: _acorex_platform_themes_shared.AXPThemeMode;
@@ -377,6 +423,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         isSystemMode: _angular_core.Signal<boolean>;
         isSideMenuOpen: _angular_core.Signal<boolean>;
         isOverlayLoading: _angular_core.Signal<boolean>;
+        overlayTaskCount: _angular_core.Signal<number>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
         effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -390,6 +437,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         toggleSideMenu: () => void;
         setNavigationLoading: (value: boolean, delay?: number) => void;
         setOverlayLoading: (value: boolean, delay?: number) => void;
+        clearOverlayLoading: () => void;
         loadSettings: () => Promise<void>;
     } & _ngrx_signals.StateSource<{
         currentMode: _acorex_platform_themes_shared.AXPThemeMode;
@@ -518,9 +566,20 @@ interface AXPLayoutDetailsViewAdapter {
     getPageStatus?: (context: Record<string, unknown>, currentPage: AXPLayoutDetailsViewPage | null) => Promise<AXPPageStatus | null>;
 }
 
+interface AXPLayoutDetailsViewRouteParams {
+    moduleName: string;
+    entityName: string;
+    id: string;
+}
+interface AXPLayoutDetailsViewAdapterLoader {
+    load(params: AXPLayoutDetailsViewRouteParams): Promise<AXPLayoutDetailsViewAdapter>;
+}
+declare const AXP_LAYOUT_DETAILS_VIEW_ADAPTER_LOADER: InjectionToken<AXPLayoutDetailsViewAdapterLoader>;
+
 declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     adapter: _angular_core.Signal<AXPLayoutDetailsViewAdapter | null>;
     rootContext: _angular_core.Signal<Record<string, any>>;
+    savedContext: _angular_core.Signal<Record<string, any>>;
     previousContext: _angular_core.Signal<Record<string, any>>;
     context: _angular_core.Signal<Record<string, any>>;
     scope: _angular_core.Signal<AXPExpressionEvaluatorScope | null>;
@@ -537,6 +596,8 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     isLarge: _angular_core.Signal<boolean>;
     isBusy: _angular_core.Signal<boolean>;
     isSaving: _angular_core.Signal<boolean>;
+    isOverlayBusy: _angular_core.Signal<boolean>;
+    isPageReady: _angular_core.Signal<boolean>;
     isDirty: _angular_core.Signal<boolean>;
     changesCount: _angular_core.Signal<1 | 0>;
     isLoaded: _angular_core.Signal<boolean>;
@@ -544,7 +605,8 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     activeTabContent: _angular_core.Signal<AXPWidgetNode[]>;
     loadAdapter: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
     loadPage: (pageId?: string, forceRefresh?: boolean) => Promise<void>;
-    load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
+    load: (adapter: AXPLayoutDetailsViewAdapter, forceRefresh?: boolean, pageIdFromUrl?: string) => Promise<void>;
+    loadFromRoute: (forceRefresh?: boolean) => Promise<void>;
     updateContext: (context: any) => void;
     setFormDirty: (dirty: boolean) => void;
     updatePageSelectedRows: (rows: any[]) => void;
@@ -554,7 +616,7 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     currentPageTabs: () => AXPLayoutDetailsViewTabItem[] | undefined;
     setCurrentPage: (page: AXPLayoutDetailsViewPage | null) => void;
     setCurrentTab: (tab: AXPLayoutDetailsViewTabItem) => void;
-    backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
+    backButtonTitle: () => AXPMultiLanguageString;
     getPageTitle: () => Promise<AXPMultiLanguageString>;
     getPageDescription: () => Promise<AXPMultiLanguageString | null>;
     getBackButton: () => Promise<AXPBackButton | null>;
@@ -563,7 +625,7 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     primaryActions: () => Promise<any>;
     secondaryActions: () => Promise<any>;
     breadcrumbs: () => Promise<{
-        title: _acorex_core_translation.AXMultiLanguageString;
+        title: AXPMultiLanguageString;
         name?: string;
         icon?: string;
         command?: AXPExecuteCommand;
@@ -571,10 +633,11 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     applySavedState: (context: Record<string, unknown>) => void;
     discard: () => Promise<void>;
     save: (command: AXPExecuteCommand, form: AXFormComponent, liveContext?: Record<string, unknown>) => Promise<boolean>;
-    goToListPage: () => void;
+    goToListPage: () => Promise<void>;
 } & _ngrx_signals.StateSource<{
     adapter: AXPLayoutDetailsViewAdapter | null;
     rootContext: Record<string, any>;
+    savedContext: Record<string, any>;
     previousContext: Record<string, any>;
     context: Record<string, any>;
     scope: AXPExpressionEvaluatorScope | null;
@@ -589,10 +652,10 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
 
 declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent implements OnInit, OnDestroy {
     #private;
-    adapter: _angular_core.InputSignal<AXPLayoutDetailsViewAdapter>;
     protected vm: {
-        adapter: _angular_core.Signal<AXPLayoutDetailsViewAdapter | null>;
+        adapter: _angular_core.Signal<_acorex_platform_layout_views.AXPLayoutDetailsViewAdapter | null>;
         rootContext: _angular_core.Signal<Record<string, any>>;
+        savedContext: _angular_core.Signal<Record<string, any>>;
         previousContext: _angular_core.Signal<Record<string, any>>;
         context: _angular_core.Signal<Record<string, any>>;
         scope: _angular_core.Signal<_acorex_platform_core.AXPExpressionEvaluatorScope | null>;
@@ -609,14 +672,17 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         isLarge: _angular_core.Signal<boolean>;
         isBusy: _angular_core.Signal<boolean>;
         isSaving: _angular_core.Signal<boolean>;
+        isOverlayBusy: _angular_core.Signal<boolean>;
+        isPageReady: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
         changesCount: _angular_core.Signal<1 | 0>;
         isLoaded: _angular_core.Signal<boolean>;
         currentPageSelectedRows: _angular_core.Signal<any[]>;
         activeTabContent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetNode[]>;
-        loadAdapter: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
+        loadAdapter: (adapter: _acorex_platform_layout_views.AXPLayoutDetailsViewAdapter) => Promise<void>;
         loadPage: (pageId?: string, forceRefresh?: boolean) => Promise<void>;
-        load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
+        load: (adapter: _acorex_platform_layout_views.AXPLayoutDetailsViewAdapter, forceRefresh?: boolean, pageIdFromUrl?: string) => Promise<void>;
+        loadFromRoute: (forceRefresh?: boolean) => Promise<void>;
         updateContext: (context: any) => void;
         setFormDirty: (dirty: boolean) => void;
         updatePageSelectedRows: (rows: any[]) => void;
@@ -626,7 +692,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         currentPageTabs: () => _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem[] | undefined;
         setCurrentPage: (page: AXPLayoutDetailsViewPage | null) => void;
         setCurrentTab: (tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem) => void;
-        backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
+        backButtonTitle: () => AXPMultiLanguageString;
         getPageTitle: () => Promise<AXPMultiLanguageString>;
         getPageDescription: () => Promise<AXPMultiLanguageString | null>;
         getBackButton: () => Promise<AXPBackButton | null>;
@@ -635,7 +701,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         primaryActions: () => Promise<any>;
         secondaryActions: () => Promise<any>;
         breadcrumbs: () => Promise<{
-            title: _acorex_core_translation.AXMultiLanguageString;
+            title: AXPMultiLanguageString;
             name?: string;
             icon?: string;
             command?: AXPExecuteCommand;
@@ -643,10 +709,11 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         applySavedState: (context: Record<string, unknown>) => void;
         discard: () => Promise<void>;
         save: (command: AXPExecuteCommand, form: AXFormComponent, liveContext?: Record<string, unknown>) => Promise<boolean>;
-        goToListPage: () => void;
+        goToListPage: () => Promise<void>;
     } & _ngrx_signals.StateSource<{
-        adapter: AXPLayoutDetailsViewAdapter | null;
+        adapter: _acorex_platform_layout_views.AXPLayoutDetailsViewAdapter | null;
         rootContext: Record<string, any>;
+        savedContext: Record<string, any>;
         previousContext: Record<string, any>;
         context: Record<string, any>;
         scope: _acorex_platform_core.AXPExpressionEvaluatorScope | null;
@@ -658,22 +725,32 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         evaluatedTabContentsById: Record<string, _acorex_platform_layout_widget_core.AXPWidgetNode[]>;
         formDirty: boolean;
     }>;
-    protected router: Router;
     protected route: ActivatedRoute;
     protected eventService: AXPBroadcastEventService;
     protected deviceService: AXPDeviceService;
-    private readonly unsavedChangesConfirm;
     private readonly unsavedChangesPopstate;
     private readonly pageComponentInstanceRegistry;
     private readonly shortcutRegistry;
+    private readonly workflowService;
     private readonly destroyRef;
     private readonly elementRef;
+    private readonly debug;
     private onSelectionChangeSubscription?;
-    /** Prevents sidebar tab init events from pushing history before {@link ngOnInit} load completes. */
-    private detailsLayoutReady;
+    /** Prevents sidebar tab init events from pushing history before the first page activation completes. */
+    private readonly detailsLayoutReady;
     private readonly destroyed$;
     private footerActionsGeneration;
     private keyboardShortcutRegistrationGeneration;
+    private overlayFallbackTimer?;
+    /** Page id the overlay release logic is bound to; reset on sidebar/page switch. */
+    private overlayTargetPageId;
+    /** After a page switch, wait for widget registry to clear before accepting remounted widgets. */
+    private overlaySawZeroWidgetsAfterPageChange;
+    /** Cancels in-flight overlay release when the page changes. */
+    private overlayReleaseGeneration;
+    private overlayReleasePromise?;
+    /** Safety cap when widget ready detection does not settle. */
+    private static readonly overlayMaxWaitMs;
     /** Header actions with resolved shortcut chords, keyed by command name. */
     private readonly actionShortcutEntries;
     /** Save/discard use live {@link AXPLayoutDetailsViewViewModel.isDirty}; other actions use evaluated `visible`. */
@@ -713,17 +790,31 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     protected isFooterActionDisabled(action: AXPActionMenuItem): boolean;
     protected hasFooter: _angular_core.Signal<boolean>;
     /**
-     * Append timestamp query param to trigger router to re-run guards/resolvers
+     * Re-fetches the entity adapter and reloads the active page.
      */
     protected refreshLayout(): Promise<void>;
     ngOnInit(): Promise<void>;
+    /** Navigates to {@link AXPLayoutDetailsViewAdapter.exitUrl} when the open record was deleted. */
+    private handleEntityDeleted;
     ngAfterViewInit(): Promise<void>;
     ngOnDestroy(): void;
     private refreshFooterActions;
     protected handleOnContextChanged(e: AXPContextChangeEvent): void;
     private getLiveFormContext;
+    /** Whether the active page renders widget nodes (not only hosted components). */
+    private pageHasWidgetNodes;
+    /** Clears all overlay loading tasks once the page (or hosted view) is ready. */
+    private clearPageOverlay;
+    private scheduleOverlayFallback;
+    private clearOverlayFallback;
+    /**
+     * Hides overlay after the widget container reports continuous idle (same gate as saved baseline).
+     */
+    private requestOverlayRelease;
     private finalizeSave;
     private finalizeDiscard;
+    /** Reverts widget form state and view-model context to the last saved baseline. */
+    private discardUnsavedChanges;
     /**
      * `ax-tabs` selects on click before we can confirm. Revert synchronously, then confirm + switch.
      */
@@ -740,6 +831,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     protected getPageTitle(): Promise<AXPMultiLanguageString>;
     getPageDescription(): Promise<AXPMultiLanguageString | null>;
     getBackButton(): Promise<AXPBackButton | null>;
+    hasUnsavedChanges(): boolean;
     getPageBadge(): Promise<AXPBadge | null>;
     getPageStatus(): Promise<AXPPageStatus | null>;
     /**
@@ -751,13 +843,21 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
      * Router guard hook — same unsaved-changes confirm as dialog builder {@link confirmCloseWhenDirty}.
      */
     canDeactivate(): Promise<boolean>;
+    /** Background tab close — confirm without discarding (the cached instance is destroyed). */
+    onBeforeTabClose(): Promise<boolean>;
     /** Active entity component page instance, when the current details sub-page is component-based. */
     private getActivePageComponentInstance;
     /** Component key for the current details sub-page, when content is component-based. */
     private getActivePageComponentKey;
     private static isComponentPageContent;
+    protected pageContentTrackKey(item: AXPPageContentItem, index: number): string;
     /** Whether the active component-based entity page has unsaved edits. */
     private isActivePageComponentDirty;
+    /**
+     * Widget-form dirty state for leave guards (popstate, canDeactivate).
+     * Unlike {@link liveFormIsDirty}, does not suppress dirty while overlay is busy.
+     */
+    private hasWidgetFormUnsavedChanges;
     /** Whether the current details page has user-origin unsaved edits (form or component page). */
     private shouldPromptLeave;
     /** Single gate for leaving the page or switching details sub-pages when dirty. */
@@ -771,19 +871,25 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     /** Waits for builder/effect microtasks to finish after a component page command. */
     private waitForComponentDirtySettle;
     private refreshKeyboardShortcutRegistrations;
+    /** i18n scope label for the active details sub-page shortcut group in the help dialog. */
+    private getKeyboardShortcutScope;
+    /** Primary overview page backed by the entity widget form (not a component-hosted sub-page). */
+    private isWidgetFormPrimaryPage;
+    private registerDetailsViewShortcutScope;
     private collectActionShortcutEntries;
-    private isHeaderActionAvailable;
-    /** Whether save/discard core shortcuts are listed in the help dialog (page supports them). */
+    private isShortcutActionAvailable;
+    /** Whether save/discard core shortcuts are listed in the help dialog (widget overview page only). */
     private isCoreSaveShortcutAvailable;
     private isCoreDiscardShortcutAvailable;
     private canExecuteSaveShortcut;
     private canExecuteDiscardShortcut;
     private executeDiscardViaShortcut;
+    private executeActionShortcut;
     private isActionShortcutActive;
     private registerCoreKeyboardShortcuts;
     private registerActionKeyboardShortcuts;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutDetailsViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDetailsViewComponent, "axp-layout-details-view", never, { "adapter": { "alias": "adapter"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDetailsViewComponent, "axp-layout-details-view", never, {}, {}, never, never, true, never>;
 }
 
 type AXPDetailsViewActionShortcut = AXPKeyboardShortcutChord;
@@ -800,6 +906,16 @@ declare function resolveDetailsViewActionShortcuts(commandBaseName: string, expl
  * Resolves save/discard footer command shortcuts from page settings.
  */
 declare function resolveDetailsViewFooterCommandShortcuts(commandName: string, explicit?: readonly AXPKeyboardShortcut[]): AXPDetailsViewActionShortcut[] | undefined;
+/**
+ * Platform defaults for component-page footer save/discard commands (e.g. `MetaDataBuilder:Save`).
+ */
+declare function resolvePageFooterActionDefaultShortcuts(commandName: string): AXPDetailsViewActionShortcut[] | undefined;
+declare function isSaveFooterCommand(commandName: string): boolean;
+declare function isDiscardFooterCommand(commandName: string): boolean;
+/**
+ * Resolves keyboard shortcuts for a footer action on entity detail sub-pages.
+ */
+declare function resolvePageFooterActionShortcuts(commandName: string, explicit?: readonly AXPKeyboardShortcut[]): AXPDetailsViewActionShortcut[] | undefined;
 
 /**
  * Prompts for unsaved changes before leaving the entity details route (breadcrumbs, menu, back to list).
@@ -847,5 +963,5 @@ declare class AXPPageComponentRendererDirective implements OnInit, OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXPPageComponentRendererDirective, "[axp-page-component-renderer]", never, { "componentKey": { "alias": "componentKey"; "required": true; "isSignal": true; }; "rootContext": { "alias": "rootContext"; "required": false; "isSignal": true; }; "pageConfig": { "alias": "pageConfig"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; }, { "componentReady": "componentReady"; }, never, never, true, never>;
 }
 
-export { AXPLayoutDetailsViewComponent, AXPLayoutDetailsViewViewModel, AXPPageComponentInstanceRegistryService, AXPPageComponentRendererDirective, AXPPageLayoutBase, AXPPageLayoutBaseComponent, AXPPageLayoutComponent, AXPPopupLayoutBase, AXPPopupLayoutBaseComponent, AXPPopupLayoutComponent, axpDetailsViewCanDeactivateGuard, buildNotSavedPageBadge, getDetailsViewActionCommandBaseName, isDiscardCommand, resolveDetailsViewActionShortcuts, resolveDetailsViewFooterCommandShortcuts };
-export type { AXPDetailsViewActionShortcut, AXPLayoutDetailsViewAction, AXPLayoutDetailsViewAdapter, AXPLayoutDetailsViewPage, AXPLayoutDetailsViewTabItem, AXPPageContentItem };
+export { AXPLayoutDetailsViewComponent, AXPLayoutDetailsViewViewModel, AXPPageComponentInstanceRegistryService, AXPPageComponentRendererDirective, AXPPageLayoutBase, AXPPageLayoutBaseComponent, AXPPageLayoutComponent, AXPPopupLayoutBase, AXPPopupLayoutBaseComponent, AXPPopupLayoutComponent, AXP_LAYOUT_DETAILS_VIEW_ADAPTER_LOADER, axpDetailsViewCanDeactivateGuard, buildNotSavedPageBadge, getDetailsViewActionCommandBaseName, isDiscardCommand, isDiscardFooterCommand, isSaveFooterCommand, resolveDetailsViewActionShortcuts, resolveDetailsViewFooterCommandShortcuts, resolvePageFooterActionDefaultShortcuts, resolvePageFooterActionShortcuts };
+export type { AXPDetailsViewActionShortcut, AXPLayoutDetailsViewAction, AXPLayoutDetailsViewAdapter, AXPLayoutDetailsViewAdapterLoader, AXPLayoutDetailsViewPage, AXPLayoutDetailsViewRouteParams, AXPLayoutDetailsViewTabItem, AXPPageContentItem };