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

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

@@ -1,16 +1,16 @@
+import { AXPEntityListFilterDefinition, AXPEntityListSortableField, AXPEntityAggregateRequest, AXPEntityDetailDto, AXPEntityModel, AXPEntityListItemDto, AXPEntityCreateDto, AXPEntityUpdateDto, AXPEntityQueryAllOptions, AXPEntityQueryAllResult, AXPEntityAggregateOptions, AXPEntityAggregateResult, AXPEntity as AXPEntity$1 } from '@acorex/platform/layout/entity-contracts';
+export * from '@acorex/platform/layout/entity-contracts';
+export { collectNestedCreateHiddenProperties, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, mergeForeignKeyFieldIntoCreateActions } from '@acorex/platform/layout/entity-contracts';
 import * as _acorex_platform_contracts from '@acorex/platform/contracts';
 import { AXPExecuteCommandResult, AXPMetaData, AXPGridLayoutOptions, AXPMultiLanguageString, AXPBreadcrumbItem, AXPFilterQuery, AXPExecuteCommand, AXPFilterDefinition, AXPPagedListResult, AXPCategoryEntity, AXPEntityOp, AXPMiddlewareErrorResponse, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPFileListItem } from '@acorex/platform/contracts';
 import { AXPCommand, AXPQueryExecutor, AXPCommandService, AXPQuery } from '@acorex/platform/runtime';
 import * as _angular_core from '@angular/core';
 import { ElementRef, InjectionToken, Injector, Type, EnvironmentProviders, OnInit, ChangeDetectorRef, OnDestroy } from '@angular/core';
-import { AXPEntityListFilterDefinition, AXPEntityAggregateRequest, AXPEntityDetailDto, AXPEntityModel, AXPEntityListItemDto, AXPEntityCreateDto, AXPEntityUpdateDto, AXPEntityQueryAllOptions, AXPEntityQueryAllResult, AXPEntityAggregateOptions, AXPEntityAggregateResult, AXPEntity as AXPEntity$1 } from '@acorex/platform/layout/entity-contracts';
-export * from '@acorex/platform/layout/entity-contracts';
-export { collectNestedCreateHiddenProperties, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, mergeForeignKeyFieldIntoCreateActions } from '@acorex/platform/layout/entity-contracts';
 import * as i4 from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPWidgetColumnNode, AXPWidgetCoreService, AXPColumnWidgetComponent, AXPValueWidgetComponent, AXPWidgetConfig, AXPWidgetRendererDirective, AXPWidgetCoreElementAPI } from '@acorex/platform/layout/widget-core';
 import { AXPPreloadFiltersApplyEvent, AXPColumnItemListItem, AXPDataSelectorRowActionsHandler, AXPCategoryTreeDataSource, AXPDataSelectorAllowCreate } from '@acorex/platform/layout/components';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
-import { AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPQueryRequest, AXHighlightService, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPExpressionEvaluatorService, AXPContextEvalFactory, AXPContextChangeEvent } from '@acorex/platform/core';
+import { AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPQueryRequest, AXHighlightService, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPContextData, AXPExpressionEvaluatorService, AXPContextEvalFactory, AXPContextStore, AXPContextChangeEvent } from '@acorex/platform/core';
 import * as _acorex_platform_common from '@acorex/platform/common';
 import { AXPRelatedEntity, AXPEntityPage, AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPCardField, AXPEntityPropertyLayoutConfig, AXPEntitySectionView, AXPEntityPropertyCreateView, AXPQueryView, AXPEntityMasterListLayoutType, AXPEntityMasterListDisplayMode, AXPEntityMasterListLayoutOption, AXPEntityPropertyView, AXPEntityCategoryPlugin, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXCFileUploaderCapabilities, AXCFileUploaderAction, AXPQueryFilter } from '@acorex/platform/common';
 export { AXPEntityDefinitionCrudService, AXP_ENTITY_DEFINITION_CRUD_SERVICE } from '@acorex/platform/domain';
@@ -43,6 +43,7 @@ declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
     private translationService;
     private settingsService;
     private openEntityDetailsCommand;
+    private workflowEventService;
     protected context: {};
     execute(input: any): Promise<AXPExecuteCommandResult<any>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPCreateEntityCommand, never>;
@@ -297,9 +298,9 @@ declare class AXPEntitiesListDataSourceDefinition implements AXPDataSourceDefini
 
 /**
  * Built-in entity detail tabs from plugins. Sidebar order (after related page-list / page-detail
- * tabs): meta-data-builder → attachments → documents → comments → history.
+ * tabs): meta-data-builder → attachments → documents → comments → dashboard → history.
  */
-type EntityDetailPluginPageSlot = 'meta-data-builder' | 'attachments' | 'documents' | 'comments' | 'history';
+type EntityDetailPluginPageSlot = 'meta-data-builder' | 'attachments' | 'documents' | 'comments' | 'dashboard' | 'history';
 /** Identifies an `entity.pages` entry when skipping its order during recomputation. */
 interface SkipEntityComponentPageRef {
     componentKey: string;
@@ -802,6 +803,10 @@ declare class AXPEntityMasterListViewModel {
      * Apply filters from query params
      */
     applyFiltersFromQueryParams(filtersJson: string | null): boolean;
+    /**
+     * Loads host and merge-detail related sortable field definitions (async registry resolution).
+     */
+    loadSortableFields(): Promise<void>;
     /**
      * Loads host and merge-detail related filter definitions (async registry resolution).
      */
@@ -811,6 +816,7 @@ declare class AXPEntityMasterListViewModel {
     applyViewFilters(): Promise<void>;
     resetFilters(): void;
     applyFilterAndSort(): Promise<void>;
+    private resolveMergeDetailProperty;
     private allAvailableColumns;
     visibleColumnCount: () => number;
     columns: _angular_core.WritableSignal<AXPEntityListViewColumnViewModel[]>;
@@ -832,6 +838,7 @@ declare class AXPEntityMasterListViewModel {
     private allAvailableCardFields;
     cardFields: _angular_core.WritableSignal<AXPEntityListViewCardFieldViewModel[]>;
     applyCardFields(): void;
+    sortableFieldDefinitions: _angular_core.WritableSignal<AXPEntityListSortableField[]>;
     sortableFields: () => {
         name: string;
         title: string;
@@ -1494,10 +1501,16 @@ declare class EntityDataAccessor<TKey = any, TDetailDto extends AXPEntityDetailD
     private entityRegistry;
     private queryExecutor;
     private commandService;
+    private injector;
     private crudService;
     private entityDef;
     private entityDefPromise;
-    constructor(module: string, entity: string, entityRegistry: AXPEntityDefinitionRegistryService, queryExecutor: AXPQueryExecutor, commandService: AXPCommandService);
+    constructor(module: string, entity: string, entityRegistry: AXPEntityDefinitionRegistryService, queryExecutor: AXPQueryExecutor, commandService: AXPCommandService, injector: Injector);
+    /**
+     * Lazily creates the CRUD fallback inside an injection context so {@link AXMEntityCrudServiceImpl}
+     * can resolve {@link AXPEntityStorageService} via `inject()`.
+     */
+    private ensureCrudService;
     /**
      * Resolves the entity definition lazily and caches it.
      * @returns The resolved entity definition
@@ -1548,9 +1561,10 @@ declare class EntityBuilder {
     private entityRegistry;
     private queryExecutor;
     private commandService;
+    private injector;
     readonly module: string;
     readonly entity: string;
-    constructor(module: string, entity: string, sessionService: AXPSessionService, entityRegistry: AXPEntityDefinitionRegistryService, queryExecutor: AXPQueryExecutor, commandService: AXPCommandService);
+    constructor(module: string, entity: string, sessionService: AXPSessionService, entityRegistry: AXPEntityDefinitionRegistryService, queryExecutor: AXPQueryExecutor, commandService: AXPCommandService, injector: Injector);
     /**
      * Creates a path for the entity.
      * @param path - The path segment (defaults to 'list')
@@ -1569,6 +1583,7 @@ declare class AXPEntityService {
     private entityRegistry;
     private queryExecutor;
     private commandService;
+    private injector;
     /**
      * @deprecated Use `withEntity(module, entity).createPath(path)` instead.
      * This method will be removed in a future version.
@@ -2633,7 +2648,7 @@ declare class AXPEntityListToolbarService {
     private createColumnDefinitions;
     /**
      * Create Sort Definitions for Toolbar.
-     * Includes entity.properties with sort enabled, plus enriched columns (dotted paths).
+     * Includes host properties and merge-detail related fields with sort enabled.
      */
     private createSortDefinitions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityListToolbarService, never>;
@@ -3166,6 +3181,16 @@ declare class AXPFileUploaderWidgetService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPFileUploaderWidgetService>;
 }
 
+interface AXPLookupWidgetCreateOptions {
+    enable?: boolean;
+    context?: AXPContextData;
+}
+interface ResolvedLookupCreateOptions {
+    enabled: boolean;
+    mode: 'none' | 'full' | 'quick';
+    context?: AXPContextData;
+}
+
 type AXPLookupWidgetLookType = 'select' | 'lookup';
 /**
  * How the lookup column resolves related items for display in entity lists.
@@ -3222,6 +3247,10 @@ interface AXPLookupWidgetOptions {
     expose?: string | string[];
     look?: AXPLookupWidgetLookType;
     allowClear?: boolean;
+    /** Inline entity create configuration. */
+    create?: AXPLookupWidgetCreateOptions;
+    /** @deprecated Use create.enable; still supported for create mode (quick/full). */
+    allowCreate?: 'none' | 'full' | 'quick';
     displayFormat?: string;
     /** Column list: entity detail popover behavior. */
     popover?: AXPLookupPopoverOptions;
@@ -3282,6 +3311,9 @@ declare class AXPLookupWidgetViewComponent extends AXPValueWidgetComponent<any>
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetViewComponent, "axp-lookup-widget-view", never, {}, {}, never, never, true, never>;
 }
 
+type AXPContextStoreInstance = InstanceType<typeof AXPContextStore>;
+type AXPLookupCreateContextStore = AXPContextStoreInstance;
+
 /**
  * Selects which entity list row actions appear in the data selector.
  * Match by full command name, action `name`, trigger name, or command suffix (e.g. `:Preview`).
@@ -3352,7 +3384,11 @@ interface AXPEntityDataSelectorCategoryOptions {
     dataSource?: AXPCategoryTreeDataSource;
 }
 interface AXPEntityDataSelectorCreateOptions {
+    enable?: boolean;
+    /** Create dialog mode when enabled. Legacy `allowCreate` maps here. */
     mode?: AXPDataSelectorAllowCreate;
+    /** Prefilled entity create form values; may use {{ context.eval() }} expressions. */
+    context?: AXPContextData;
 }
 /** Nested options for {@link AXPEntityDataSelectorService.open}. */
 interface AXPEntityDataSelectorOpenOptions {
@@ -3365,6 +3401,8 @@ interface AXPEntityDataSelectorOpenOptions {
     sort?: AXPEntityDataSelectorSortOptions;
     category?: AXPEntityDataSelectorCategoryOptions;
     create?: AXPEntityDataSelectorCreateOptions;
+    /** Form context store used to evaluate `create.context` expressions. Must come from the hosting form scope. */
+    contextStore?: AXPLookupCreateContextStore;
     /** Entity list row actions to expose in the selector grid (matched by command name). */
     rowActions?: AXPEntityDataSelectorRowActionsConfig;
 }
@@ -3384,7 +3422,10 @@ interface AXPEntityDataSelectorOptions {
         name: string;
         dir: 'asc' | 'desc';
     }[];
+    /** @deprecated Prefer nested `create`. Legacy allowCreate mode. */
     allowCreate?: AXPDataSelectorAllowCreate;
+    /** Form context store for evaluating create.context expressions. */
+    contextStore?: AXPLookupCreateContextStore;
     searchFields?: string[];
     initialSearchTerm?: string;
     selectedItemIds?: string[] | number[];
@@ -3424,6 +3465,11 @@ declare class AXPEntityDataSelectorService {
     private readonly categoryTreeService;
     private readonly translationService;
     private readonly rowActionsService;
+    private readonly expressionEvaluator;
+    /**
+     * Resolves lookup `create.context` templates using the provided form context store.
+     */
+    resolveCreateContext(template?: AXPContextData | null, contextStore?: AXPLookupCreateContextStore | null): Promise<Record<string, unknown>>;
     /**
      * Open entity data selector popup.
      * Accepts nested {@link AXPEntityDataSelectorOpenOptions} or deprecated flat {@link AXPEntityDataSelectorOptions}.
@@ -3433,7 +3479,7 @@ declare class AXPEntityDataSelectorService {
      * Execute Entity:Create and return created item.
      * Used by lookup widget and data selector for inline create.
      */
-    executeEntityCreate(entity: AXPEntity, mode: 'full' | 'quick'): Promise<any | null>;
+    executeEntityCreate(entity: AXPEntity, mode: 'full' | 'quick', initialData?: Record<string, unknown>): Promise<any | null>;
     /**
      * Normalize item's phones/emails for expose/display.
      * Call this when receiving items from any source (create, API, selector).
@@ -3541,7 +3587,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected allowUnselect: _angular_core.Signal<boolean>;
     protected look: _angular_core.Signal<AXPLookupWidgetLookType>;
     protected displayField: _angular_core.Signal<string>;
-    protected allowCreate: _angular_core.Signal<"full" | "none" | "quick">;
+    protected resolvedCreate: _angular_core.Signal<ResolvedLookupCreateOptions>;
     protected selectorRowActions: _angular_core.Signal<AXPLookupSelectorRowActionsConfig | undefined>;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
@@ -3567,6 +3613,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
      * so e.g. `{ person: { educationLevel: { id, title } } }` would replace the entire `person`
      * object and drop sibling fields like `person.educationLevelId`, causing a value/effect loop.
      */
+    private syncExposePathsToSavedBaseline;
     private expoesItems;
     outputs(): (string | {
         [name: string]: unknown;
@@ -3918,6 +3965,7 @@ declare class AXPMultiSourceSelectorComponent extends AXBasePageComponent {
     protected activeSource: _angular_core.Signal<AXPMultiSourceItem | null>;
     protected selectedItems: _angular_core.WritableSignal<AXPMultiSourceRef[]>;
     protected readonly AXPMultiSourceType: typeof AXPMultiSourceType;
+    constructor();
     protected ngOnInit(): void;
     protected handleTabClick(source: AXPMultiSourceItem): void;
     protected handleSelectFromSource(source: AXPMultiSourceItem): Promise<void>;
@@ -4202,6 +4250,7 @@ declare class AXPEntityCreatePopupAction extends AXPWorkflowAction {
     private factory;
     private config;
     private translateService;
+    private settingsService;
     execute(context: AXPWorkflowContext): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityCreatePopupAction, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityCreatePopupAction>;
@@ -4328,4 +4377,4 @@ declare class AXPShowListViewAction extends AXPWorkflowAction {
 declare const AXPShowListViewWorkflow: AXPWorkflow;
 
 export { ATTACHMENTS_PAGE_COMPONENT_KEY, AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPCreateEntityCommand, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEditFileUploaderCommand, AXPEntitiesListDataSourceDefinition, AXPEntityApplyUpdatesAction, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorRowActionsService, AXPEntityDataSelectorService, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityFormBuilderService, AXPEntityListPersistenceModeDefault, AXPEntityListTableService, AXPEntityListToolbarService, AXPEntityListViewCardFieldViewModel, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListCardSelectActionName, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityPreloadFiltersContainerComponent, AXPEntityPreloadFiltersViewModel, AXPEntityPreloadFiltersViewModelResolver, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPFileListComponent, AXPFileUploaderLoadFilesQuery, AXPFileUploaderSaveFilesCommand, AXPFileUploaderWidget, AXPFileUploaderWidgetColumnComponent, AXPFileUploaderWidgetEditComponent, AXPFileUploaderWidgetService, AXPFileUploaderWidgetViewComponent, AXPGetEntityDetailsQuery, AXPLayoutOrderingConfigService, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPMultiSourceDefinitionProviderContext, AXPMultiSourceDefinitionProviderService, AXPMultiSourceFederatedSearchService, AXPMultiSourceSelectorComponent, AXPMultiSourceSelectorService, AXPMultiSourceSelectorWidget, AXPMultiSourceSelectorWidgetColumnComponent, AXPMultiSourceSelectorWidgetEditComponent, AXPMultiSourceSelectorWidgetViewComponent, AXPMultiSourceType, AXPOpenEntityDetailsCommand, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPRelatedColumnEnrichmentService, AXPRelatedColumnMetadataResolver, AXPSelectorStructureWidget, AXPSelectorStructureWidgetColumnComponent, AXPSelectorStructureWidgetEditComponent, AXPSelectorStructureWidgetViewComponent, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPViewEntityDetailsCommand, AXP_CATEGORY_TREE_ROOT_TITLE_I18N_KEY, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_MULTI_SOURCE_DEFINITION_PROVIDER, DEFAULT_COLUMN_ORDER, DEFAULT_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, ENTITY_LIST_ROUTE_CONTEXT_SESSION_KEY, EntityBuilder, EntityDataAccessor, actionExists, applyDataSourcePagingWithoutLoad, attachmentFieldCount, attachmentsPlugin, attachmentsSemanticallyEqual, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, canPersistEntityListState, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, commandMessageTextForError, committedAttachments, computeEntityAggregates, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, defaultCardLayoutMiddleware, defaultCardLayoutMiddlewareProvider, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, eventDispatchMiddleware, filterSortEntityRows, findEntityListRowDataInTree, fingerprintAttachmentItem, fingerprintAttachments, formatLookupItemDisplay, formatLookupItemDisplayAsync, getDataSourcePageIndex, getEntityListRowId, getMasterInterfacePropertySortKey, hasFileUploaderTitleOrDescriptionFields, isAXPMiddlewareAbortError, isAttachmentListEntry, isCategoryEntity, isCategoryFilter, isFileListItem, isFileUploaderEditDialogAuto, isLegacyEntityDataSelectorOptions, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mapEntityStorageErrorToCommandResult, mapLegacyEntityDataSelectorOptions, normalizeEntityDataSelectorOptions, normalizeEntityFieldToFileList, normalizeEntityListPersistenceMode, normalizeListPaging, persistedAttachments, provideEntity, resolveEntityPluginDetailPageOrder, resolveFileUploaderEditDialog, resolveFileUploaderEntityScope, resolveLookupDisplayField, resolveLookupDisplayTemplate, restoreEntityListExpandedRows, runEntityQuery, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider, shouldLoadEntityListStateFromStorage, shouldResetEntityListStateOnRouteEntry };
-export type { AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityDataSelectorCategoryFilterOptions, AXPEntityDataSelectorCategoryOptions, AXPEntityDataSelectorCreateOptions, AXPEntityDataSelectorFilterOptions, AXPEntityDataSelectorGridOptions, AXPEntityDataSelectorOpenInput, AXPEntityDataSelectorOpenOptions, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDataSelectorRowActionsConfig, AXPEntityDataSelectorSearchOptions, AXPEntityDataSelectorSelectionOptions, AXPEntityDataSelectorSortOptions, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListExpandRowRef, AXPEntityListInput, AXPEntityListPagingState, AXPEntityListPersistenceMode, AXPEntityListToolbarConvertOptions, AXPEntityMasterListCardLayout, AXPEntityMasterListCardSecondaryActionItem, AXPEntityMasterListViewSortPropViewModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPFileListLook, AXPFileUploaderEditDialogFieldOptions, AXPFileUploaderEditDialogMode, AXPFileUploaderEditDialogOptions, AXPFileUploaderEntityFilesScope, AXPFileUploaderLoadFilesInput, AXPFileUploaderLoadFilesResult, AXPFileUploaderSaveFilesInput, AXPFileUploaderSaveFilesResult, AXPFileUploaderShowFileListEntityContext, AXPFileUploaderShowFileListOptions, AXPFileUploaderUploadActionDescriptor, AXPFileUploaderWidgetColumnOptions, AXPFileUploaderWidgetDesignerOptions, AXPFileUploaderWidgetEditOptions, AXPFileUploaderWidgetOptions, AXPFileUploaderWidgetPrintOptions, AXPFileUploaderWidgetViewOptions, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupDisplayEvalDeps, AXPLookupDisplayOptions, AXPLookupPopoverOptions, AXPLookupSelectorRowActionsConfig, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, AXPShowListViewCondition, AttachmentsDisplayMode, AttachmentsPluginOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, RunEntityQueryAdapters, SectionOrderConfig, SkipEntityComponentPageRef };
+export type { AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityDataSelectorCategoryFilterOptions, AXPEntityDataSelectorCategoryOptions, AXPEntityDataSelectorCreateOptions, AXPEntityDataSelectorFilterOptions, AXPEntityDataSelectorGridOptions, AXPEntityDataSelectorOpenInput, AXPEntityDataSelectorOpenOptions, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDataSelectorRowActionsConfig, AXPEntityDataSelectorSearchOptions, AXPEntityDataSelectorSelectionOptions, AXPEntityDataSelectorSortOptions, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListExpandRowRef, AXPEntityListInput, AXPEntityListPagingState, AXPEntityListPersistenceMode, AXPEntityListToolbarConvertOptions, AXPEntityMasterListCardLayout, AXPEntityMasterListCardSecondaryActionItem, AXPEntityMasterListViewSortPropViewModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPFileListLook, AXPFileUploaderEditDialogFieldOptions, AXPFileUploaderEditDialogMode, AXPFileUploaderEditDialogOptions, AXPFileUploaderEntityFilesScope, AXPFileUploaderLoadFilesInput, AXPFileUploaderLoadFilesResult, AXPFileUploaderSaveFilesInput, AXPFileUploaderSaveFilesResult, AXPFileUploaderShowFileListEntityContext, AXPFileUploaderShowFileListOptions, AXPFileUploaderUploadActionDescriptor, AXPFileUploaderWidgetColumnOptions, AXPFileUploaderWidgetDesignerOptions, AXPFileUploaderWidgetEditOptions, AXPFileUploaderWidgetOptions, AXPFileUploaderWidgetPrintOptions, AXPFileUploaderWidgetViewOptions, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupDisplayEvalDeps, AXPLookupDisplayOptions, AXPLookupPopoverOptions, AXPLookupSelectorRowActionsConfig, AXPLookupWidgetCreateOptions, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, AXPShowListViewCondition, AttachmentsDisplayMode, AttachmentsPluginOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, RunEntityQueryAdapters, SectionOrderConfig, SkipEntityComponentPageRef };

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

@@ -1,9 +1,9 @@
 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, AXPEntityCommandScope } from '@acorex/platform/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';
@@ -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;
@@ -166,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>;
@@ -179,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;
@@ -210,7 +214,9 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     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;
@@ -219,6 +225,8 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     ngOnInit(): Promise<void>;
     /** 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;
@@ -235,6 +243,10 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected getPageIcon(): string | null | Promise<string | null>;
     hasTitle: _angular_core.Signal<boolean>;
     hasTitleIcon: _angular_core.Signal<boolean>;
+    /** 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>;
@@ -242,7 +254,9 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     breadcrumbs: _angular_core.WritableSignal<AXPBreadcrumbItem[]>;
     hasBreadcrumbs: _angular_core.Signal<boolean>;
     protected getPageBreadcrumbs(): AXPBreadcrumbItem[] | Promise<AXPBreadcrumbItem[]>;
-    /** Joins all page breadcrumbs (Home is excluded upstream) as the tab label. */
+    /** 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>;
@@ -338,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>;
@@ -351,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;
@@ -407,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>;
@@ -420,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;
@@ -548,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>;
@@ -567,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>;
@@ -574,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;
@@ -601,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;
@@ -619,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>;
@@ -639,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;
@@ -673,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;
@@ -694,14 +731,26 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     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`. */
@@ -741,15 +790,27 @@ 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. */
@@ -792,6 +853,11 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     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. */
@@ -805,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;
@@ -834,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).
@@ -881,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 };