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

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,28 @@ 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;
+    /** Cancels in-flight list selection bind when the sidebar page or widget tree changes. */
+    private pageListSelectionBindGeneration;
+    /** 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 +792,30 @@ 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>;
-    ngAfterViewInit(): Promise<void>;
+    /** Navigates to {@link AXPLayoutDetailsViewAdapter.exitUrl} when the open record was deleted. */
+    private handleEntityDeleted;
     ngOnDestroy(): void;
     private refreshFooterActions;
+    /** Whether the active page hosts a related-entity list (`page-list` widget). */
+    private pageHasEntityListWidget;
+    /** Subscribes to the live data-list selection stream for Selected-scope header actions. */
+    private attachSelectionToListWidget;
     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 +858,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 +876,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 +911,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 +968,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 };

package/types/acorex-platform-layout-widget-core.d.ts

@@ -1,11 +1,12 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, ComponentRef, OnInit, EventEmitter, OnChanges, TemplateRef, Injector, WritableSignal, SimpleChanges, Type } from '@angular/core';
+import { Signal, InjectionToken, OnInit, ComponentRef, EventEmitter, OnChanges, TemplateRef, Injector, WritableSignal, SimpleChanges, Type } from '@angular/core';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _acorex_platform_core from '@acorex/platform/core';
 import { AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
 import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { AXPOptionsData, AXPMultiLanguageString, AXPDefinitionCategory, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPProperty } from '@acorex/platform/contracts';
+import * as rxjs from 'rxjs';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { AXDataTableColumnComponent } from '@acorex/components/data-table';
 import * as i7 from '@acorex/core/translation';
@@ -18,18 +19,17 @@ import * as i6 from '@acorex/components/skeleton';
 declare enum AXPPageStatus {
     Idle = "idle",// The page is idle.
     Rendering = "rendering",// The page is being rendered.
-    Rendered = "rendered",// The rendering process is complete. should be renamed to idle
+    Rendered = "rendered",// The rendering process is complete.
     Processing = "processing",// The page is performing a task or interaction.
     Submitting = "submitting",// The form is being submitted.
     Submitted = "submitted",// Submission is completed.
     Validating = "validating",// The form is being validated.
-    Validated = "validated",// Validation is completed.  
+    Validated = "validated",// Validation is completed.
     Error = "error"
 }
 declare enum AXPWidgetStatus {
-    Rendering = "rendering",// The widget is being rendered.
-    Rendered = "rendered",// The rendering process is complete.
-    Processing = "processing",// The widget is performing a task or interaction.
+    Rendering = "rendering",// The widget is being mounted and bound.
+    Rendered = "rendered",// The widget shell is ready (async hydration may still run).
     Error = "error"
 }
 
@@ -52,6 +52,7 @@ type AXPWidgetCoreElementAction = {
 declare abstract class AXPWidgetCoreElement {
     abstract get id(): string | null;
     abstract get status(): Signal<AXPWidgetStatus>;
+    abstract get isHydrating(): Signal<boolean>;
     api(): AXPWidgetCoreElementAPI;
     actions(): AXPWidgetCoreElementAction[];
 }
@@ -61,18 +62,45 @@ declare class AXPWidgetCoreService {
     readonly onRefresh: Subject<void>;
     private widgets;
     private readonly onWidgetRegistered;
+    /** Fires whenever a widget registers, including re-registration after remount (same id, new instance). */
+    readonly widgetRegistered$: rxjs.Observable<{
+        id: string;
+        widget: AXPWidgetCoreElement;
+    }>;
+    /** Bumps when widget render/hydration state changes so aggregate computeds re-evaluate. */
+    private readonly widgetsRevision;
     private readonly status$;
     readonly status: Signal<AXPPageStatus>;
+    readonly registeredWidgetsCount: _angular_core.WritableSignal<number>;
+    readonly isRendering: Signal<boolean>;
+    readonly isHydrating: Signal<boolean>;
     readonly isBusy: Signal<boolean>;
-    registeredWidgetsCount: _angular_core.WritableSignal<number>;
+    readonly isStructureReady: Signal<boolean>;
     private readonly dirtyWidgetsRevision;
     readonly dirtyWidgetsRevisionSignal: Signal<number>;
+    constructor();
     get variables(): any;
     get functions(): {
         [key: string]: Function;
     };
+    /** Recomputes aggregate container state after a widget registers or changes status/hydration. */
+    notifyWidgetStateChanged(): void;
+    /** @deprecated Prefer {@link notifyWidgetStateChanged}. */
     updateStatus(): void;
-    private detectStatus;
+    /** Debug snapshot of registered widget render/hydration state. */
+    getWidgetStateSnapshot(): {
+        count: number;
+        isRendering: boolean;
+        isHydrating: boolean;
+        isStructureReady: boolean;
+        isBusy: boolean;
+        widgets: Array<{
+            id: string;
+            status: AXPWidgetStatus;
+            isHydrating: boolean;
+        }>;
+    };
+    private detectAggregateStatus;
     refresh(): void;
     setStatus(status: AXPPageStatus): void;
     setVariables(keysValues: any): void;
@@ -80,6 +108,8 @@ declare class AXPWidgetCoreService {
     setFunctions(keysValues: any): void;
     setFunctions(key: string, value: any): void;
     registerWidget(id: string, widget: AXPWidgetCoreElement): void;
+    unregisterWidget(id: string): void;
+    clearWidgets(): void;
     getWidget(id: string): AXPWidgetCoreElement | undefined;
     waitForWidget(id: string, timeoutMs?: number): Promise<AXPWidgetCoreElement | undefined>;
     listRegisteredWidgetNames(): string[];
@@ -381,7 +411,7 @@ interface AXPLayoutBuilderStatusChangedEvent {
 
 type AXPClassMap = Readonly<Record<string, boolean>>;
 type AXPStyleMap = Readonly<Record<string, string | number>>;
-declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, unknown> = AXPOptionsData> extends AXPWidgetCoreElement {
+declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, unknown> = AXPOptionsData> extends AXPWidgetCoreElement implements OnInit {
     #private;
     protected readonly token: AXPWidgetNodeToken<TOptions>;
     readonly host: HTMLDivElement;
@@ -391,12 +421,14 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        userEditedSinceCommit: _angular_core.Signal<boolean>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isSavedCommitted: _angular_core.Signal<boolean>;
+        hasUserEditedSinceCommit: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
@@ -405,6 +437,7 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
         changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
+        syncPathToSavedBaseline: (path: string, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
         revertToSaved: () => void;
         reset: () => void;
@@ -419,6 +452,7 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
         state: _acorex_platform_core.AXPContextState;
         savedSnapshot: _acorex_platform_core.AXPContextData;
         previousSnapshot: _acorex_platform_core.AXPContextData;
+        userEditedSinceCommit: boolean;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     readonly config: _acorex_platform_layout_widget_core.AXPWidgetConfig<any>;
@@ -435,6 +469,10 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
     private _status;
     status: _angular_core.Signal<AXPWidgetStatus>;
     readonly onStatusChanged: BehaviorSubject<AXPWidgetStatus>;
+    /** Depth counter so nested async hydration calls share one busy state. */
+    private hydrationDepth;
+    private _isHydrating;
+    isHydrating: _angular_core.Signal<boolean>;
     isBusy: _angular_core.Signal<boolean>;
     parent: AXPLayoutBaseWidgetComponent<any> | null | undefined;
     parentComponent: ComponentRef<any> | null | undefined;
@@ -447,6 +485,10 @@ declare abstract class AXPBaseWidgetComponent<TOptions extends Record<string, un
     })[];
     ngOnInit(): void;
     setStatus(status: AXPWidgetStatus): void;
+    /** Marks async data loading (lookup, select, file fetch, etc.). */
+    protected beginHydration(): void;
+    /** Clears hydration started by {@link beginHydration}. */
+    protected endHydration(): void;
     setOptions(values: Partial<TOptions>): void;
     output<T = any>(name: string): T;
     call(name: string, ...args: any[]): void;
@@ -478,6 +520,8 @@ declare abstract class AXPValueWidgetComponent<T = any | null, TOptions extends
     getValue: _angular_core.Signal<T>;
     protected validationRules: _angular_core.Signal<AXPValidationRules>;
     protected extractValue(path: string): any;
+    /** Applies schema default without marking the form as user-edited. */
+    protected applyDefaultValue(value: T | null | undefined): void;
     setValue(value: T | null | undefined): void;
     protected detectFullPath(): void;
     protected handleValueChanged(e: AXValueChangedEvent<T>): void;
@@ -785,12 +829,14 @@ declare class AXPWidgetContainerComponent {
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        userEditedSinceCommit: _angular_core.Signal<boolean>;
         lastChange: _ngrx_signals.DeepSignal<AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isSavedCommitted: _angular_core.Signal<boolean>;
+        hasUserEditedSinceCommit: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
@@ -799,6 +845,7 @@ declare class AXPWidgetContainerComponent {
         changeEvent: _angular_core.Signal<AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
+        syncPathToSavedBaseline: (path: string, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
         revertToSaved: () => void;
         reset: () => void;
@@ -813,12 +860,16 @@ declare class AXPWidgetContainerComponent {
         state: _acorex_platform_core.AXPContextState;
         savedSnapshot: _acorex_platform_core.AXPContextData;
         previousSnapshot: _acorex_platform_core.AXPContextData;
+        userEditedSinceCommit: boolean;
         lastChange: AXPContextChangeEvent;
     }>;
     readonly builderService: AXPWidgetCoreService;
+    private readonly debug;
     readonly onContextChanged: EventEmitter<AXPContextChangeEvent>;
     private lastEmittedFormDirty;
     private savedBaselineTimer?;
+    private settlePromise?;
+    private wasHydrating;
     set context(value: any);
     set functions(v: any);
     readonly isSavedCommitted: _angular_core.Signal<boolean>;
@@ -826,13 +877,20 @@ declare class AXPWidgetContainerComponent {
     constructor();
     status: _angular_core.Signal<_acorex_platform_layout_widget_core.AXPPageStatus>;
     isBusy: _angular_core.Signal<boolean>;
+    isHydrating: _angular_core.Signal<boolean>;
+    /** True when registered widgets exist and none are rendering or hydrating. */
+    isWidgetsReady: _angular_core.Signal<boolean>;
     refresh(): void;
     find(name: string): Promise<_acorex_platform_layout_widget_core.AXPWidgetCoreElement | undefined>;
     private syncExternalContext;
     /** Commits the current data as saved after widget hydration settles. */
     settleSavedBaseline(): Promise<void>;
+    /** Resolves when widgets stay registered, structure-ready, and idle for {@link FORM_SAVED_BASELINE_IDLE_MS}. */
+    waitUntilSettled(): Promise<void>;
     replaceContext(value: unknown): Promise<void>;
     revertAndSettle(): void;
+    /** Re-commits baseline after post-load hydration when the user has not edited the form. */
+    private scheduleRebaselineAfterHydration;
     private clearSavedBaselineTimer;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetContainerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPWidgetContainerComponent, "axp-widgets-container", never, { "context": { "alias": "context"; "required": false; }; "functions": { "alias": "functions"; "required": false; }; }, { "onContextChanged": "onContextChanged"; }, never, ["*"], false, never>;
@@ -1003,12 +1061,14 @@ declare class AXPWidgetRendererDirective {
         state: _angular_core.Signal<_acorex_platform_core.AXPContextState>;
         savedSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         previousSnapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
+        userEditedSinceCommit: _angular_core.Signal<boolean>;
         lastChange: _ngrx_signals.DeepSignal<_acorex_platform_core.AXPContextChangeEvent>;
         isChanged: _angular_core.Signal<boolean>;
         isReset: _angular_core.Signal<boolean>;
         isInitiated: _angular_core.Signal<boolean>;
         isEmpty: _angular_core.Signal<boolean>;
         isSavedCommitted: _angular_core.Signal<boolean>;
+        hasUserEditedSinceCommit: _angular_core.Signal<boolean>;
         isDirty: _angular_core.Signal<boolean>;
         snapshot: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
         saved: _angular_core.Signal<_acorex_platform_core.AXPContextData>;
@@ -1017,6 +1077,7 @@ declare class AXPWidgetRendererDirective {
         changeEvent: _angular_core.Signal<_acorex_platform_core.AXPContextChangeEvent>;
         update: (path: string, value: any, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         applyObjectPaths: (obj: Record<string, unknown>, options?: _acorex_platform_core.AXPContextUpdateOptions, prefix?: string) => void;
+        syncPathToSavedBaseline: (path: string, options?: _acorex_platform_core.AXPContextUpdateOptions) => void;
         patch: (context: Record<string, any>, options?: _acorex_platform_core.AXPContextPatchOptions) => void;
         revertToSaved: () => void;
         reset: () => void;
@@ -1031,6 +1092,7 @@ declare class AXPWidgetRendererDirective {
         state: _acorex_platform_core.AXPContextState;
         savedSnapshot: _acorex_platform_core.AXPContextData;
         previousSnapshot: _acorex_platform_core.AXPContextData;
+        userEditedSinceCommit: boolean;
         lastChange: _acorex_platform_core.AXPContextChangeEvent;
     }>;
     protected widgetRegistery: AXPWidgetRegistryService;