@acorex/platform 21.0.0-next.70 → 21.0.0-next.72

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

@@ -6,7 +6,7 @@ import { AXClickEvent } from '@acorex/cdk/common';
 import * as i1 from '@acorex/cdk/drawer';
 import { AXDrawerItemDirective } from '@acorex/cdk/drawer';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActionMenuItem, AXPBreadcrumbItem, AXPMultiLanguageString, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
+import { AXPActionMenuItem, AXPBreadcrumbItem, AXPMultiLanguageString, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPKeyboardShortcut, AXPExecuteCommandResult, 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';
@@ -14,12 +14,14 @@ import { AXTranslationService } from '@acorex/core/translation';
 import { AXToastService } from '@acorex/components/toast';
 import { AXFormatService } from '@acorex/core/format';
 import { AXPSessionService } from '@acorex/platform/auth';
-import { AXPHomePageService, AXPEntityCommandScope } from '@acorex/platform/common';
+import { AXPHomePageService, AXPSettingsService, AXPEntityCommandScope } from '@acorex/platform/common';
 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 {
@@ -47,6 +49,10 @@ declare abstract class AXPPageLayoutBase {
     abstract onBackButtonClick: () => void | Promise<void>;
     abstract startSideToggle: () => void | Promise<void>;
     abstract execute: (command: AXPExecuteCommand) => void | Promise<void>;
+    /** Whether the page has user-origin edits that are not yet persisted. */
+    abstract hasUnsavedChanges(): boolean;
+    /** Resolves the page title badge (used by host layouts for nested entity pages). */
+    abstract resolvePageBadge(): AXPBadge | null | Promise<AXPBadge | null>;
 }
 
 declare class AXPPageLayoutComponent {
@@ -65,6 +71,7 @@ declare class AXPPageLayoutComponent {
         overlayLoadingTaskCount: _angular_core.Signal<number>;
         navigationLoadingTaskCount: _angular_core.Signal<number>;
         sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        overlaySideMenuOpen: _angular_core.Signal<boolean>;
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -77,6 +84,7 @@ declare class AXPPageLayoutComponent {
         isOverlayLoading: _angular_core.Signal<boolean>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
@@ -101,6 +109,7 @@ declare class AXPPageLayoutComponent {
         overlayLoadingTaskCount: number;
         navigationLoadingTaskCount: number;
         sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        overlaySideMenuOpen: boolean;
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
@@ -118,6 +127,12 @@ declare class AXPPageLayoutComponent {
     protected handleBackdropClick(e: AXClickEvent): boolean;
     protected execute(command: AXPExecuteCommand): Promise<void>;
     protected handleOnBackdropClick(event: MouseEvent): void;
+    /**
+     * Breadcrumbs and other in-page `navigate` commands bypass `routerLink`, so prompt here
+     * when the hosted page implements {@link AXPUnsavedChangesCanDeactivate}.
+     * A successful confirm sets `leaveConfirmed` for the router guard on the subsequent navigation.
+     */
+    private canLeaveCurrentPage;
     protected getEntityData(): Record<string, any> | null;
     protected handleStatusTransition(transition: any): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPPageLayoutComponent, never>;
@@ -139,6 +154,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         overlayLoadingTaskCount: _angular_core.Signal<number>;
         navigationLoadingTaskCount: _angular_core.Signal<number>;
         sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        overlaySideMenuOpen: _angular_core.Signal<boolean>;
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -151,6 +167,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         isOverlayLoading: _angular_core.Signal<boolean>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
@@ -175,6 +192,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
         overlayLoadingTaskCount: number;
         navigationLoadingTaskCount: number;
         sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        overlaySideMenuOpen: boolean;
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
@@ -187,6 +205,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected readonly toastService: AXToastService;
     protected readonly homePageService: AXPHomePageService;
     protected readonly policyService: AXPPolicyEngineService;
+    protected readonly settingsService: AXPSettingsService;
     private _updateTrigger;
     protected updateTrigger: _angular_core.Signal<number>;
     protected recompute(): void;
@@ -206,7 +225,9 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected getPageBreadcrumbs(): AXPBreadcrumbItem[] | Promise<AXPBreadcrumbItem[]>;
     badge: _angular_core.WritableSignal<AXPBadge | null>;
     hasBadge: _angular_core.Signal<boolean>;
-    protected getPageBadge(): AXPBadge | null | Promise<AXPBadge | null>;
+    hasUnsavedChanges(): boolean;
+    protected getPageBadge(): Promise<AXPBadge | null>;
+    resolvePageBadge(): Promise<AXPBadge | null>;
     status: _angular_core.WritableSignal<AXPPageStatus | null>;
     hasStatus: _angular_core.Signal<boolean>;
     protected getPageStatus(): AXPPageStatus | null | Promise<AXPPageStatus | null>;
@@ -238,6 +259,15 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPPageLayoutBaseComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Builds the standard "Not Saved" page badge when the global show-page-badge setting is enabled.
+ */
+declare function buildNotSavedPageBadge(translateService: AXTranslationService, settingsService: AXPSettingsService): Promise<AXPBadge | null>;
+/**
+ * Whether a command name represents a discard/revert action on a details sub-page.
+ */
+declare function isDiscardCommand(commandName: string, rejectCommandName?: string | null): boolean;
+
 declare abstract class AXPPopupLayoutBase {
     abstract primaryMenuItems: Signal<AXPActionMenuItem[]>;
     abstract secondaryMenuItems: Signal<AXPActionMenuItem[]>;
@@ -267,6 +297,7 @@ declare class AXPPopupLayoutComponent {
         overlayLoadingTaskCount: _angular_core.Signal<number>;
         navigationLoadingTaskCount: _angular_core.Signal<number>;
         sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        overlaySideMenuOpen: _angular_core.Signal<boolean>;
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -279,6 +310,7 @@ declare class AXPPopupLayoutComponent {
         isOverlayLoading: _angular_core.Signal<boolean>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
@@ -303,6 +335,7 @@ declare class AXPPopupLayoutComponent {
         overlayLoadingTaskCount: number;
         navigationLoadingTaskCount: number;
         sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        overlaySideMenuOpen: boolean;
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
@@ -333,6 +366,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         overlayLoadingTaskCount: _angular_core.Signal<number>;
         navigationLoadingTaskCount: _angular_core.Signal<number>;
         sideMenuState: _angular_core.Signal<_acorex_platform_themes_shared.AXPSideMenuState>;
+        overlaySideMenuOpen: _angular_core.Signal<boolean>;
         sideMenuWidth: _angular_core.Signal<number>;
         sideMenuCompactWidth: _angular_core.Signal<number>;
         menuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
@@ -345,6 +379,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         isOverlayLoading: _angular_core.Signal<boolean>;
         isNavigationLoading: _angular_core.Signal<boolean>;
         isMenuHorizontal: _angular_core.Signal<boolean>;
+        effectiveMenuVerticalMode: _angular_core.Signal<_acorex_platform_themes_shared.AXPMenuVerticalMode>;
         sideMenuDrawerWidth: _angular_core.Signal<number>;
         changeThemeMode: (theme: _acorex_platform_themes_shared.AXPThemeMode) => void;
         openSideMenu: () => void;
@@ -369,6 +404,7 @@ declare abstract class AXPPopupLayoutBaseComponent extends AXBasePageComponent {
         overlayLoadingTaskCount: number;
         navigationLoadingTaskCount: number;
         sideMenuState: _acorex_platform_themes_shared.AXPSideMenuState;
+        overlaySideMenuOpen: boolean;
         sideMenuWidth: number;
         sideMenuCompactWidth: number;
         menuVerticalMode: _acorex_platform_themes_shared.AXPMenuVerticalMode;
@@ -451,6 +487,7 @@ interface AXPLayoutDetailsViewPage {
                 color: string;
                 visible?: string | boolean;
                 command: AXPExecuteCommand;
+                shortcuts?: AXPKeyboardShortcut[];
             };
             reject?: {
                 title: string;
@@ -458,6 +495,7 @@ interface AXPLayoutDetailsViewPage {
                 color: string;
                 visible?: string | boolean;
                 command: AXPExecuteCommand;
+                shortcuts?: AXPKeyboardShortcut[];
             };
         };
     };
@@ -490,12 +528,9 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     currentPage: _angular_core.Signal<AXPLayoutDetailsViewPage | null>;
     currentTab: _angular_core.Signal<AXPLayoutDetailsViewTabItem | null>;
     pageSelectedRows: _angular_core.Signal<any[]>;
-    renderedTabsCache: _angular_core.Signal<Record<string, {
-        tabId: string;
-        tab: AXPLayoutDetailsViewTabItem;
-    }[]>>;
     evaluatedPageContent: _angular_core.Signal<AXPWidgetNode[]>;
     evaluatedTabContentsById: _angular_core.Signal<Record<string, AXPWidgetNode[]>>;
+    formDirty: _angular_core.Signal<boolean>;
     icon: _angular_core.Signal<string | null>;
     content: _angular_core.Signal<_acorex_platform_layout_views.AXPPageContentItem[]>;
     showPages: _angular_core.Signal<boolean>;
@@ -503,17 +538,15 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     isBusy: _angular_core.Signal<boolean>;
     isSaving: _angular_core.Signal<boolean>;
     isDirty: _angular_core.Signal<boolean>;
-    changesCount: _angular_core.Signal<number>;
+    changesCount: _angular_core.Signal<1 | 0>;
     isLoaded: _angular_core.Signal<boolean>;
     currentPageSelectedRows: _angular_core.Signal<any[]>;
-    currentPageRenderedTabs: _angular_core.Signal<{
-        tabId: string;
-        tab: AXPLayoutDetailsViewTabItem;
-    }[]>;
+    activeTabContent: _angular_core.Signal<AXPWidgetNode[]>;
     loadAdapter: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
     loadPage: (pageId?: string, forceRefresh?: boolean) => Promise<void>;
     load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
     updateContext: (context: any) => void;
+    setFormDirty: (dirty: boolean) => void;
     updatePageSelectedRows: (rows: any[]) => void;
     currentPagePrimaryActions: () => Promise<any>;
     currentPageSecondaryActions: () => Promise<any>;
@@ -521,9 +554,6 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     currentPageTabs: () => AXPLayoutDetailsViewTabItem[] | undefined;
     setCurrentPage: (page: AXPLayoutDetailsViewPage | null) => void;
     setCurrentTab: (tab: AXPLayoutDetailsViewTabItem) => void;
-    getCurrentTabContent: () => AXPWidgetNode[];
-    getRenderedTabContent: (tabId: string) => AXPWidgetNode[];
-    clearPageTabCache: (pageId: string) => void;
     backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
     getPageTitle: () => Promise<AXPMultiLanguageString>;
     getPageDescription: () => Promise<AXPMultiLanguageString | null>;
@@ -538,8 +568,9 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
         icon?: string;
         command?: AXPExecuteCommand;
     }[]>;
+    applySavedState: (context: Record<string, unknown>) => void;
     discard: () => Promise<void>;
-    save: (command: AXPExecuteCommand, form: AXFormComponent) => Promise<void>;
+    save: (command: AXPExecuteCommand, form: AXFormComponent, liveContext?: Record<string, unknown>) => Promise<boolean>;
     goToListPage: () => void;
 } & _ngrx_signals.StateSource<{
     adapter: AXPLayoutDetailsViewAdapter | null;
@@ -551,12 +582,9 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     currentPage: AXPLayoutDetailsViewPage | null;
     currentTab: AXPLayoutDetailsViewTabItem | null;
     pageSelectedRows: any[];
-    renderedTabsCache: Record<string, Array<{
-        tabId: string;
-        tab: AXPLayoutDetailsViewTabItem;
-    }>>;
     evaluatedPageContent: AXPWidgetNode[];
     evaluatedTabContentsById: Record<string, AXPWidgetNode[]>;
+    formDirty: boolean;
 }>>;
 
 declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent implements OnInit, OnDestroy {
@@ -572,30 +600,25 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         currentPage: _angular_core.Signal<AXPLayoutDetailsViewPage | null>;
         currentTab: _angular_core.Signal<_acorex_platform_layout_views.AXPLayoutDetailsViewTabItem | null>;
         pageSelectedRows: _angular_core.Signal<any[]>;
-        renderedTabsCache: _angular_core.Signal<Record<string, {
-            tabId: string;
-            tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem;
-        }[]>>;
         evaluatedPageContent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetNode[]>;
         evaluatedTabContentsById: _angular_core.Signal<Record<string, _acorex_platform_layout_widget_core.AXPWidgetNode[]>>;
+        formDirty: _angular_core.Signal<boolean>;
         icon: _angular_core.Signal<string | null>;
-        content: _angular_core.Signal<_acorex_platform_layout_views.AXPPageContentItem[]>;
+        content: _angular_core.Signal<AXPPageContentItem[]>;
         showPages: _angular_core.Signal<boolean>;
         isLarge: _angular_core.Signal<boolean>;
         isBusy: _angular_core.Signal<boolean>;
         isSaving: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
-        changesCount: _angular_core.Signal<number>;
+        changesCount: _angular_core.Signal<1 | 0>;
         isLoaded: _angular_core.Signal<boolean>;
         currentPageSelectedRows: _angular_core.Signal<any[]>;
-        currentPageRenderedTabs: _angular_core.Signal<{
-            tabId: string;
-            tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem;
-        }[]>;
+        activeTabContent: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPWidgetNode[]>;
         loadAdapter: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
         loadPage: (pageId?: string, forceRefresh?: boolean) => Promise<void>;
         load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
         updateContext: (context: any) => void;
+        setFormDirty: (dirty: boolean) => void;
         updatePageSelectedRows: (rows: any[]) => void;
         currentPagePrimaryActions: () => Promise<any>;
         currentPageSecondaryActions: () => Promise<any>;
@@ -603,9 +626,6 @@ 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;
-        getCurrentTabContent: () => _acorex_platform_layout_widget_core.AXPWidgetNode[];
-        getRenderedTabContent: (tabId: string) => _acorex_platform_layout_widget_core.AXPWidgetNode[];
-        clearPageTabCache: (pageId: string) => void;
         backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
         getPageTitle: () => Promise<AXPMultiLanguageString>;
         getPageDescription: () => Promise<AXPMultiLanguageString | null>;
@@ -620,8 +640,9 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
             icon?: string;
             command?: AXPExecuteCommand;
         }[]>;
+        applySavedState: (context: Record<string, unknown>) => void;
         discard: () => Promise<void>;
-        save: (command: AXPExecuteCommand, form: AXFormComponent) => Promise<void>;
+        save: (command: AXPExecuteCommand, form: AXFormComponent, liveContext?: Record<string, unknown>) => Promise<boolean>;
         goToListPage: () => void;
     } & _ngrx_signals.StateSource<{
         adapter: AXPLayoutDetailsViewAdapter | null;
@@ -633,26 +654,63 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         currentPage: AXPLayoutDetailsViewPage | null;
         currentTab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem | null;
         pageSelectedRows: any[];
-        renderedTabsCache: Record<string, Array<{
-            tabId: string;
-            tab: _acorex_platform_layout_views.AXPLayoutDetailsViewTabItem;
-        }>>;
         evaluatedPageContent: _acorex_platform_layout_widget_core.AXPWidgetNode[];
         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 destroyRef;
+    private readonly elementRef;
     private onSelectionChangeSubscription?;
+    /** Prevents sidebar tab init events from pushing history before {@link ngOnInit} load completes. */
+    private detailsLayoutReady;
     private readonly destroyed$;
+    private footerActionsGeneration;
+    private keyboardShortcutRegistrationGeneration;
+    /** 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`. */
+    private static isTruthyActionFlag;
     protected form: _angular_core.Signal<AXFormComponent | undefined>;
     protected widgetContainer: _angular_core.Signal<AXPWidgetContainerComponent | undefined>;
+    private readonly sidebarTabs;
+    private sidebarTabChangeSuppressed;
     protected footerPrimaryActions: _angular_core.WritableSignal<AXPActionMenuItem[]>;
     protected footerSecondaryActions: _angular_core.WritableSignal<AXPActionMenuItem[]>;
     protected footerActions: _angular_core.Signal<AXPActionMenuItem[]>;
+    protected rejectFooterCommand: _angular_core.Signal<{
+        title: string;
+        icon?: string;
+        color: string;
+        visible?: string | boolean;
+        command: AXPExecuteCommand;
+        shortcuts?: _acorex_platform_core.AXPKeyboardShortcut[];
+    } | null>;
+    protected acceptFooterCommand: _angular_core.Signal<{
+        title: string;
+        icon?: string;
+        color: string;
+        visible?: string | boolean;
+        command: AXPExecuteCommand;
+        shortcuts?: _acorex_platform_core.AXPKeyboardShortcut[];
+    } | null>;
+    protected hasSaveDiscardFooterCommands: _angular_core.Signal<boolean>;
+    /** Entity save/discard — driven live by widget/container dirty state, not evaluated action metadata. */
+    protected showSaveDiscardFooter: _angular_core.Signal<boolean>;
+    /** Live dirty flag for widget-based entity forms (not component-hosted pages). */
+    protected liveFormIsDirty: _angular_core.Signal<boolean>;
     protected hasVisibleFooterPrimaryActions: _angular_core.Signal<boolean>;
     protected hasVisibleFooterSecondaryActions: _angular_core.Signal<boolean>;
+    protected isSaveDiscardFooterAction(action: AXPActionMenuItem): boolean;
+    protected isFooterActionVisible(action: AXPActionMenuItem): boolean;
+    protected isFooterActionDisabled(action: AXPActionMenuItem): boolean;
     protected hasFooter: _angular_core.Signal<boolean>;
     /**
      * Append timestamp query param to trigger router to re-run guards/resolvers
@@ -661,8 +719,17 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     ngOnInit(): Promise<void>;
     ngAfterViewInit(): Promise<void>;
     ngOnDestroy(): void;
+    private refreshFooterActions;
     protected handleOnContextChanged(e: AXPContextChangeEvent): void;
-    protected handleSelectPage(page: AXPLayoutDetailsViewPage): void;
+    private getLiveFormContext;
+    private finalizeSave;
+    private finalizeDiscard;
+    /**
+     * `ax-tabs` selects on click before we can confirm. Revert synchronously, then confirm + switch.
+     */
+    protected handleSidebarTabChanged(event: AXTabStripChangedEvent): void;
+    protected handleSelectPage(page: AXPLayoutDetailsViewPage): Promise<void>;
+    private completePageSwitch;
     protected getAllPrimaryActions(): Promise<AXPLayoutDetailsViewAction[]>;
     getPrimaryMenuItems(): Promise<AXPActionMenuItem[]>;
     protected getFooterPrimaryActions(): Promise<AXPActionMenuItem[]>;
@@ -680,12 +747,65 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
      */
     getEntityData(): Record<string, any> | null;
     onBackButtonClick(): Promise<void>;
+    /**
+     * Router guard hook — same unsaved-changes confirm as dialog builder {@link confirmCloseWhenDirty}.
+     */
+    canDeactivate(): 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;
+    /** Whether the active component-based entity page has unsaved edits. */
+    private isActivePageComponentDirty;
+    /** 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. */
+    private confirmLeaveIfDirty;
     execute(command: AXPExecuteCommand): Promise<void>;
-    protected handleKeyboardEvent(event: KeyboardEvent): Promise<void>;
+    /**
+     * After a component-based page command (e.g. custom discard/save), align view-model dirty
+     * state and widget context with the hosted page when it no longer reports unsaved changes.
+     */
+    private syncDirtyStateAfterPageComponentCommand;
+    /** Waits for builder/effect microtasks to finish after a component page command. */
+    private waitForComponentDirtySettle;
+    private refreshKeyboardShortcutRegistrations;
+    private collectActionShortcutEntries;
+    private isHeaderActionAvailable;
+    /** Whether save/discard core shortcuts are listed in the help dialog (page supports them). */
+    private isCoreSaveShortcutAvailable;
+    private isCoreDiscardShortcutAvailable;
+    private canExecuteSaveShortcut;
+    private canExecuteDiscardShortcut;
+    private executeDiscardViaShortcut;
+    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>;
 }
 
+type AXPDetailsViewActionShortcut = AXPKeyboardShortcutChord;
+/**
+ * Returns the base workflow/command name from a composite entity action command id (`cmd&actionName`).
+ */
+declare function getDetailsViewActionCommandBaseName(commandName: string | undefined): string;
+/**
+ * Resolves keyboard shortcuts for a header entity action.
+ * Explicit `shortcuts` wins; pass `[]` to disable. Otherwise known commands use platform defaults.
+ */
+declare function resolveDetailsViewActionShortcuts(commandBaseName: string, explicit?: readonly AXPKeyboardShortcut[]): AXPDetailsViewActionShortcut[] | undefined;
+/**
+ * Resolves save/discard footer command shortcuts from page settings.
+ */
+declare function resolveDetailsViewFooterCommandShortcuts(commandName: string, explicit?: readonly AXPKeyboardShortcut[]): AXPDetailsViewActionShortcut[] | undefined;
+
+/**
+ * Prompts for unsaved changes before leaving the entity details route (breadcrumbs, menu, back to list).
+ */
+declare const axpDetailsViewCanDeactivateGuard: _angular_router.CanDeactivateFn<AXPLayoutDetailsViewComponent>;
+
 /**
  * Registry of rendered page component instances by component key.
  * Used so page execute can delegate to the actual component instance in the view.
@@ -727,5 +847,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 };
-export type { AXPLayoutDetailsViewAction, AXPLayoutDetailsViewAdapter, AXPLayoutDetailsViewPage, AXPLayoutDetailsViewTabItem, AXPPageContentItem };
+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 };