@acorex/platform 21.0.0-next.75 → 21.0.0-next.76

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

@@ -1,15 +1,17 @@
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPExecuteCommandResult, AXPQueryRequest, AXPUserReference, AXPMetaData, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPGridLayoutOptions, AXPMultiLanguageString, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPPagedListResult, AXPCategoryEntity as AXPCategoryEntity$1, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPFileListItem, AXPContextChangeEvent } from '@acorex/platform/core';
+import { AXPExecuteCommandResult, AXPQueryRequest, AXPMetaData, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPGridLayoutOptions, AXPMultiLanguageString, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPPagedListResult, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPFileListItem, AXPExpressionEvaluatorService, AXPContextEvalFactory, AXPContextChangeEvent } from '@acorex/platform/core';
 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 * as _acorex_platform_contracts from '@acorex/platform/contracts';
+import { AXPRecordWorkflowInfo, AXPEntityDetailDto, AXPEntityModel, AXPEntityListItemDto, AXPEntityCreateDto, AXPEntityUpdateDto, AXPCategoryEntity } from '@acorex/platform/contracts';
+export { AXPAuditEvent, AXPEntityCreateDto, AXPEntityDataSourceKeys, AXPEntityDetailDto, AXPEntityListItemDto, AXPEntityModel, AXPEntityOutputDto, AXPEntityUpdateDto, AXPMockDto, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRecordWorkflowInfo, collectNestedCreateHiddenProperties, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, mergeForeignKeyFieldIntoCreateActions } from '@acorex/platform/contracts';
 import { AXPopoverComponent } from '@acorex/components/popover';
 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 * 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, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPQueryFilter, AXCFileUploaderCapabilities, AXCFileUploaderAction } 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';
 import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption, AXDataSourceSortOption, AXValueChangedEvent, AXClickEvent, AXFocusEvent, AXHtmlEvent } from '@acorex/cdk/common';
 import * as i1 from '@angular/router';
@@ -115,6 +117,9 @@ declare class AXPUpdateEntityCommand implements AXPCommand<any, any> {
     private readonly entityService;
     private readonly toastService;
     private readonly translationService;
+    private readonly formatService;
+    private readonly expressionEvaluator;
+    private readonly contextEvalFactory;
     private readonly eventService;
     execute(input: any): Promise<AXPExecuteCommandResult<any>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPUpdateEntityCommand, never>;
@@ -125,7 +130,11 @@ declare class AXPViewEntityDetailsCommand implements AXPCommand<any, any> {
     private readonly entityForm;
     private readonly entityService;
     private readonly translationService;
+    private readonly expressionEvaluator;
+    private readonly contextEvalFactory;
     execute(input: any): Promise<AXPExecuteCommandResult<any>>;
+    private resolveDialogTitle;
+    private loadRecordContext;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPViewEntityDetailsCommand, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPViewEntityDetailsCommand>;
 }
@@ -152,11 +161,6 @@ declare class AXPOpenEntityDetailsCommand implements AXPCommand<AXPOpenEntityDet
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPOpenEntityDetailsCommand>;
 }
 
-/** Platform entity layout datasource registry names. */
-declare const AXPEntityDataSourceKeys: {
-    readonly Entities: "entities";
-};
-
 declare const AXPEntityEventsKeys: {
     REFRESH_LAYOUT: string;
     REFRESH_DATA: string;
@@ -204,80 +208,6 @@ interface AXPEntityAggregateOptions {
     pageSize?: number;
 }
 
-/**
- * One audit point in time for a record lifecycle event.
- *
- * Used inside {@link AXPRecordAuditInfo} (`created`, `updated`, `deleted`).
- * Backends and mock middleware typically set `at` and `by`; `reason` and `source`
- * (for example `api`, `system`, `import`) are optional diagnostic fields.
- */
-interface AXPAuditEvent {
-    at?: Date;
-    by?: AXPUserReference;
-    /** Optional business or technical reason for the event. */
-    reason?: string;
-    /** Optional origin of the change (for example `api`, `system`, `import`). */
-    source?: string;
-}
-/**
- * Aggregated audit trail for a persisted row.
- *
- * Filled by APIs or connectivity mock middleware when creating, updating, or
- * soft-deleting records. UI surfaces may show these via the history plugin or
- * custom columns. Version snapshot pipelines often **omit** this object from
- * stored snapshots while still applying it to live payloads.
- *
- * @remarks Fields are optional today; callers should tolerate partial data.
- */
-interface AXPRecordAuditInfo {
-    created?: AXPAuditEvent;
-    updated?: AXPAuditEvent;
-    deleted?: AXPAuditEvent;
-}
-/**
- * Cross-cutting flags that are not part of the domain schema but affect how a
- * row is shown or edited (visibility, built-in/system rows, immutability).
- *
- * Module entity models sometimes expose only this slice (for example
- * `stateInfo` on business units) when the rest of the row uses a bespoke shape.
- *
- * @remarks Entity list/detail flows should honor these flags where applicable.
- */
-interface AXPRecordStateInfo {
-    isHidden?: boolean;
-    isSystem?: boolean;
-    isImmutable?: boolean;
-    /** @deprecated Prefer explicit domain modeling over this flag. */
-    isDistributed?: boolean;
-}
-/**
- * Tenancy and actor scope for a row in a multi-tenant application.
- *
- * Used to associate a record with a tenant, application instance, or owning
- * user when the API returns ownership metadata alongside domain fields.
- */
-interface AXPRecordOwnershipInfo {
-    tenantId?: string;
-    applicationId?: string;
-    userId?: string;
-}
-/**
- * Workflow linkage for a domain record (set when a run is started or bound).
- *
- * Populated by workflow engine, middleware, or integration — not declared as
- * entity definition properties. Entities with the `workflow` plugin may carry
- * this object when a {@link WorkflowManagement.WorkflowInstance} drives the row.
- */
-interface AXPRecordWorkflowInfo {
-    /** Workflow instance id for this record's active or last run. */
-    instanceId?: string | null;
-    /** Logical workflow definition id (same as WorkflowInstance.definitionId). */
-    definitionId?: string | null;
-    /** Correlation id for idempotent start and related-run lookup (same as WorkflowInstance.correlationId). */
-    correlationId?: string | null;
-    /** When set, pins the run to a workflow definition version; omit for current default. */
-    pinnedVersion?: number | null;
-}
 /** Entity query filter field for {@link AXPRecordWorkflowInfo.instanceId}. */
 declare const AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD: "workflowInfo.instanceId";
 /** Entity query filter field for {@link AXPRecordWorkflowInfo.correlationId}. */
@@ -299,41 +229,14 @@ declare function buildAXPRecordWorkflowInfo(params: {
     correlationId?: string | null;
     pinnedVersion?: number | null;
 }): AXPRecordWorkflowInfo;
-/**
- * Base shape for **entity row** TypeScript models across modules: a stable
- * identifier plus optional platform metadata.
- *
- * Module-specific interfaces extend this with domain properties
- * (`extends AXPEntityModel<string>` / `AXPEntityModel<Id>`) while reusing
- * `auditInfo`, `stateInfo`, `ownershipInfo`, and `workflowInfo` when the backend sends them.
- */
-interface AXPEntityModel<Id> {
-    id: Id;
-    auditInfo?: AXPRecordAuditInfo;
-    stateInfo?: AXPRecordStateInfo;
-    ownershipInfo?: AXPRecordOwnershipInfo;
-    workflowInfo?: AXPRecordWorkflowInfo;
-}
-interface AXPEntityCreateDto {
-}
-interface AXPEntityUpdateDto<Id> {
-    id: Id;
-}
-interface AXPEntityOutputDto<Id> {
-    id: Id;
-}
-interface AXPEntityDetailDto<Id> extends AXPEntityOutputDto<Id> {
-}
-interface AXPEntityListItemDto<Id> extends AXPEntityOutputDto<Id> {
-}
-interface AXPMockDto<Id> extends AXPEntityModel<Id> {
-}
 
 declare class AXPEntityDetailPopoverComponent {
     private readonly commandService;
     private readonly queryService;
     private readonly formatService;
     private readonly translation;
+    private readonly expressionEvaluator;
+    private readonly contextEvalFactory;
     entity: _angular_core.InputSignal<string>;
     entityId: _angular_core.InputSignal<string | number>;
     textField: _angular_core.InputSignal<string>;
@@ -345,9 +248,11 @@ declare class AXPEntityDetailPopoverComponent {
     protected entityDetails: _angular_core.WritableSignal<any>;
     protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
     protected isDetailPopoverOpen: _angular_core.WritableSignal<boolean>;
+    private headerTitleVersion;
     /** Placeholder rows for the loading skeleton (matches typical property count). */
     protected readonly loadingSkeletonRows: readonly [1, 2, 3, 4, 5];
-    protected readonly headerTitle: _angular_core.Signal<string>;
+    protected readonly headerTitle: _angular_core.WritableSignal<string>;
+    constructor();
     /**
      * Stable list of property widgets for the template. Must be a signal (computed), not a method:
      * calling a method from the template rebuilds nodes every CD cycle and can make the widget renderer loop.
@@ -367,7 +272,8 @@ declare class AXPEntityDetailPopoverComponent {
     hide(): void;
     protected onDetailPopoverOpenChange(event: any): void;
     protected navigateToDetails(): Promise<void>;
-    private resolveLookupDisplayLabel;
+    private resolveHeaderTitle;
+    private resolveLookupDisplayLabelAsync;
     /**
      * Returns true if a value is meaningful for display (non-empty/non-null).
      */
@@ -426,12 +332,11 @@ declare class AXPEntityDetailPopoverService {
 
 declare class AXPEntityPreloadFiltersContainerComponent extends AXPPageLayoutBaseComponent {
     private readonly route;
-    private readonly router;
     private readonly entityService;
     private readonly filterOperatorMiddleware;
     protected readonly noMatchText: _angular_core.WritableSignal<string | null>;
     private vm;
-    preloadFiltersDef: _angular_core.Signal<_acorex_platform_core.AXPFilterDefinition[]>;
+    preloadFiltersDef: _angular_core.Signal<_acorex_platform_contracts.AXPFilterDefinition[]>;
     hasNoRequiredFilters: _angular_core.Signal<boolean>;
     protected getPageTitle(): string;
     protected getPageDescription(): string | null;
@@ -543,7 +448,7 @@ declare class AXPEntityListViewCardFieldViewModel {
     name: string;
     title: string;
     visible: string | boolean;
-    layout: _acorex_platform_common.AXPEntityPropertyLayoutConfig | undefined;
+    layout: _acorex_platform_contracts.AXPEntityPropertyLayoutConfig | undefined;
     display: string;
     isBadgeDisplay: boolean;
     badgeColor: string | undefined;
@@ -681,7 +586,7 @@ declare class AXPEntityCreateViewSectionViewModel {
     private entity;
     private section;
     constructor(entity: AXPEntity, section: AXPEntitySectionView);
-    group: _acorex_platform_common.AXPEntityPropertyGroup;
+    group: _acorex_platform_contracts.AXPEntityPropertyGroup;
     name: _angular_core.WritableSignal<string>;
     title: _angular_core.Signal<string>;
     description: _angular_core.Signal<string | null | undefined>;
@@ -757,9 +662,9 @@ declare class AXPEntityMasterListViewQueryViewModel {
     constructor(entity: AXPEntity, section: AXPEntityMasterListViewModel, view: AXPQueryView);
     name: string;
     title: string;
-    sorts: _acorex_platform_common.AXPQuerySort[];
+    sorts: _acorex_platform_contracts.AXPQuerySort[];
     columns: string[];
-    conditions: _acorex_platform_common.AXPQueryFilter[];
+    conditions: _acorex_platform_contracts.AXPQueryFilter[];
     indexCol: boolean | undefined;
     pageSize: number | undefined;
 }
@@ -774,6 +679,7 @@ declare class AXPEntityMasterListViewModel {
     private readonly settings;
     private readonly widgetResolver;
     private readonly expressionEvaluator;
+    private readonly contextEvalFactory;
     private readonly translation;
     private readonly commandService;
     private readonly eventService;
@@ -854,7 +760,8 @@ declare class AXPEntityMasterListViewModel {
     switchListLayout(): AXPEntityMasterListLayoutType;
     private resolveActiveListLayout;
     private applyListLayoutFromSettings;
-    private createExpressionScope;
+    private createLogicExpressionScope;
+    private createDisplayExpressionScope;
     private resolveCommandNameExpression;
     private resolveTitleExpression;
     /**
@@ -1042,7 +949,7 @@ declare class AXPEntityMasterSingleViewGroupViewModel {
     private entity;
     private section;
     constructor(entity: AXPEntity, section: AXPEntitySectionView);
-    group: _acorex_platform_common.AXPEntityPropertyGroup;
+    group: _acorex_platform_contracts.AXPEntityPropertyGroup;
     name: _angular_core.WritableSignal<string>;
     isLoading: _angular_core.WritableSignal<boolean>;
     title: _angular_core.Signal<string>;
@@ -1115,7 +1022,7 @@ declare class AXPEntityUpdateViewSectionViewModel {
     private entity;
     private section;
     constructor(entity: AXPEntity, section: AXPEntitySectionView);
-    group: _acorex_platform_common.AXPEntityPropertyGroup;
+    group: _acorex_platform_contracts.AXPEntityPropertyGroup;
     name: _angular_core.WritableSignal<string>;
     title: _angular_core.Signal<string>;
     description: _angular_core.Signal<string | null | undefined>;
@@ -1193,8 +1100,8 @@ interface AXPEntityModifierContext {
         set(newKey: string | undefined): AXPEntityModifierContext;
     };
     category: {
-        get(): AXPCategoryEntity | undefined;
-        update(updater: (cat: AXPCategoryEntity | undefined) => AXPCategoryEntity): AXPEntityModifierContext;
+        get(): AXPEntityCategoryPlugin | undefined;
+        update(updater: (cat: AXPEntityCategoryPlugin | undefined) => AXPEntityCategoryPlugin): AXPEntityModifierContext;
     };
     properties: {
         list(): AXPEntityProperty[];
@@ -1487,10 +1394,7 @@ declare function runEntityQuery<T = unknown>(entityName: string, request: AXPQue
 
 declare abstract class AXPEntityStorageService<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> {
     abstract get dbName(): string;
-    abstract initial(entityName: string, collection: TCreateDto[], options?: {
-        mergeType?: 'merge' | 'replace';
-        uniqueKeys?: string[];
-    }): Promise<TCreateDto[]>;
+    abstract initial(entityName: string, collection: TCreateDto[]): Promise<TCreateDto[]>;
     abstract getOne(entityName: string, id: TKey): Promise<TDetailDto>;
     abstract updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
     abstract deleteOne(entityName: string, id: TKey): Promise<void>;
@@ -1573,7 +1477,7 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
         categoryId: TKey;
         categoryKey?: string;
     }): Promise<AXPPagedListResult<TListItemDto>>;
-    getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity$1<TKey>>>;
+    getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity<TKey>>>;
     get storageService(): AXPEntityStorageService<any, any, any, any, any>;
     count(request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
     queryAll(request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
@@ -1685,7 +1589,7 @@ declare class EntityDataAccessor<TKey = any, TDetailDto extends AXPEntityDetailD
      * Queries category entities linked to this entity (`{module}.{entity}Category`).
      * Falls back to CRUD category storage (same as {@link AXMEntityCrudServiceImpl.getCategoriesList}).
      */
-    getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity$1<TKey>>>;
+    getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity<TKey>>>;
     /**
      * Creates a new entity.
      * @param data - The entity data to create
@@ -2216,10 +2120,7 @@ declare class AXPMiddlewareEntityStorageService<TKey = any, TDetailDto extends A
     private compose;
     private run;
     private createCtx;
-    initial(entityName: string, collection: TCreateDto[], options?: {
-        mergeType?: 'merge' | 'replace';
-        uniqueKeys?: string[];
-    }): Promise<TCreateDto[]>;
+    initial(entityName: string, collection: TCreateDto[]): Promise<TCreateDto[]>;
     getOne(entityName: string, id: TKey): Promise<TDetailDto>;
     updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
     deleteOne(entityName: string, id: TKey): Promise<void>;
@@ -2239,42 +2140,6 @@ declare class AXPMiddlewareEntityStorageService<TKey = any, TDetailDto extends A
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>>;
 }
 
-declare function entityMasterCreateAction(): AXPEntityAction;
-declare function entityMasterEditAction(): AXPEntityAction;
-declare function entityMasterBulkDeleteAction(): AXPEntityAction;
-declare function entityMasterViewAction(): AXPEntityAction;
-declare function entityMasterDeleteAction(): AXPEntityAction;
-declare function entityMasterCrudActions(options?: {
-    create?: boolean;
-    delete?: boolean;
-    view?: boolean;
-    edit?: boolean;
-}): AXPEntityAction[];
-declare function entityMasterRecordActions(): AXPEntityAction[];
-declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
-/**
- * Type-level Create with empty `process.data`; the FK is supplied from `relatedEntity.persistence.foreignKeyField`
- * when the related list is built (see `mergeForeignKeyFieldIntoCreateActions`).
- */
-declare function entityDetailsCreateActionsDeferredParent(): AXPEntityAction;
-/**
- * Ensures each type-level `Entity:Create` action includes `process.data[foreignKeyField]` bound to the parent row id.
- */
-declare function mergeForeignKeyFieldIntoCreateActions(foreignKeyField: string | undefined, actions: AXPEntityAction[] | undefined): AXPEntityAction[];
-/** Property names hidden on nested Create from a related list (`excludeProperties` plus `foreignKeyField` when set). */
-declare function collectNestedCreateHiddenProperties(relatedEntity: AXPRelatedEntity): string[] | undefined;
-declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
-declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
-declare function entityDetailsEditAction(): AXPEntityAction;
-declare function entityDetailsNewEditAction(): AXPEntityAction;
-declare function entityOverrideDetailsViewAction(): AXPEntityAction;
-declare function entityDetailsCrudActions(parentId?: string, options?: {
-    create?: boolean;
-    delete?: boolean;
-    view?: boolean;
-    edit?: boolean;
-}): AXPEntityAction[];
-declare function entityDetailsReferenceCreateActions(type: string): AXPEntityAction[];
 type AXPEntityChangeSet = {
     [key: string]: {
         oldValue: any;
@@ -3446,14 +3311,26 @@ declare function resolveLookupDisplayTemplate(entity: AXPEntity | null | undefin
  * Priority: explicit `textField` → entity `formats.lookup` (simple path) → common property names.
  */
 declare function resolveLookupDisplayField(entity: AXPEntity | null | undefined, options: AXPLookupDisplayOptions): string;
+interface AXPLookupDisplayEvalDeps {
+    expressionEvaluator: AXPExpressionEvaluatorService;
+    contextEvalFactory: AXPContextEvalFactory;
+    translationService: AXTranslationService;
+    locale: string;
+}
 /**
- * Formats a lookup row for display using template and/or field resolution.
+ * Formats a lookup row for display using template and/or field resolution (display tier).
+ */
+declare function formatLookupItemDisplayAsync(item: unknown, entity: AXPEntity | null | undefined, options: AXPLookupDisplayOptions, formatService: AXFormatService, displayDeps: AXPLookupDisplayEvalDeps, resolveMultiLanguage?: (value: AXPMultiLanguageString) => string): Promise<string>;
+/**
+ * @deprecated Prefer {@link formatLookupItemDisplayAsync} for expression templates with `context.eval`.
  */
 declare function formatLookupItemDisplay(item: unknown, entity: AXPEntity | null | undefined, options: AXPLookupDisplayOptions, formatService: AXFormatService, resolveMultiLanguage?: (value: AXPMultiLanguageString) => string): string | AXPMultiLanguageString;
 
 declare class AXPLookupWidgetViewComponent extends AXPValueWidgetComponent<any> {
     protected readonly formatService: AXFormatService;
     protected readonly translation: AXTranslationService;
+    protected readonly expressionEvaluator: AXPExpressionEvaluatorService;
+    protected readonly contextEvalFactory: AXPContextEvalFactory;
     protected readonly entityResolver: AXPEntityDefinitionRegistryService;
     protected entity: _angular_core.Signal<string>;
     protected multiple: _angular_core.Signal<boolean>;
@@ -3733,7 +3610,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<"none" | "full" | "quick">;
+    protected allowCreate: _angular_core.Signal<"full" | "none" | "quick">;
     protected selectorRowActions: _angular_core.Signal<AXPLookupSelectorRowActionsConfig | undefined>;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
@@ -3778,6 +3655,8 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     private readonly entityService;
     private readonly entityResolver;
     private readonly queryExecutor;
+    private readonly expressionEvaluator;
+    private readonly contextEvalFactory;
     protected moreButton: _angular_core.Signal<ElementRef<any> | undefined>;
     protected lazyTrigger: _angular_core.Signal<ElementRef<any> | undefined>;
     protected morePopover: _angular_core.Signal<AXPopoverComponent | undefined>;
@@ -3804,9 +3683,14 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     protected resolveError: _angular_core.WritableSignal<string | null>;
     protected summaryLabel: _angular_core.WritableSignal<string>;
     protected popoverHeader: _angular_core.WritableSignal<string>;
+    protected mainItemLabels: _angular_core.WritableSignal<string[]>;
+    protected lazyPopoverItemLabels: _angular_core.WritableSignal<string[]>;
     private entityDef;
     private hydratedDisplayItems;
     private hydrateRequestId;
+    private mainLabelsVersion;
+    private lazyPopoverLabelsVersion;
+    protected popoverItemLabels: _angular_core.Signal<string[]>;
     protected displayItems: _angular_core.Signal<any[]>;
     protected allItems: _angular_core.Signal<any[]>;
     protected visibleItems: _angular_core.Signal<any[]>;
@@ -3829,7 +3713,10 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
      * Uses textField / expose targets on the row — not merely whether column dataPath differs from columnName.
      */
     protected hasPreresolvedDisplay(): boolean;
-    protected getDisplayRaw(item: any): string;
+    protected getItemLabel(index: number): string;
+    protected getPopoverItemLabel(index: number): string;
+    private resolveLabelsForItems;
+    private resolveItemLabel;
     private refreshSummaryLabel;
     private refreshPopoverHeader;
     private resetLazyState;
@@ -3852,7 +3739,6 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     private getRowDisplayTextFromTextField;
     private getExposeTargets;
     private hasDisplayTextOnLookupValue;
-    private renderLookupLabel;
     private formatDisplayValue;
     /** True when a scalar cell value is a stored entity key (uuid/numeric), not pre-resolved display text. */
     private isLikelyEntityId;
@@ -4421,6 +4307,9 @@ declare class AXPQuickEntityModifyPopupAction extends AXPWorkflowAction {
     private popupService;
     private platform;
     private translateService;
+    private formatService;
+    private expressionEvaluator;
+    private contextEvalFactory;
     private entityRegistery;
     private config;
     private factory;
@@ -4453,6 +4342,9 @@ declare class AXPEntityModifySectionPopupAction extends AXPWorkflowAction {
     private popupService;
     private platform;
     private translateService;
+    private formatService;
+    private expressionEvaluator;
+    private contextEvalFactory;
     private entityRegistery;
     private config;
     private factory;
@@ -4494,5 +4386,5 @@ 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, AXPEntityDataSourceKeys, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityEventsKeys, 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, AXP_RECORD_WORKFLOW_INFO_CORRELATION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_DEFINITION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD, 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, buildAXPRecordWorkflowInfo, canPersistEntityListState, cloneLayoutArrays, collectEntityQuickSearchFieldPaths, collectNestedCreateHiddenProperties, collectNestedFieldPathsFromEntityColumns, collectQuickSearchPathsFromSingleEntityDefinition, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, commandMessageTextForError, committedAttachments, computeEntityAggregates, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, defaultCardLayoutMiddleware, defaultCardLayoutMiddlewareProvider, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, filterSortEntityRows, findEntityListRowDataInTree, fingerprintAttachmentItem, fingerprintAttachments, formatLookupItemDisplay, getDataSourcePageIndex, getEntityListRowId, getMasterInterfacePropertySortKey, getRecordWorkflowCorrelationId, getRecordWorkflowInstanceId, hasFileUploaderTitleOrDescriptionFields, isAXPMiddlewareAbortError, isAttachmentListEntry, isCategoryEntity, isCategoryFilter, isFileListItem, isFileUploaderEditDialogAuto, isLegacyEntityDataSelectorOptions, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mapEntityStorageErrorToCommandResult, mapLegacyEntityDataSelectorOptions, mergeForeignKeyFieldIntoCreateActions, normalizeEntityDataSelectorOptions, normalizeEntityFieldToFileList, normalizeEntityListPersistenceMode, normalizeListPaging, persistedAttachments, provideEntity, resolveEntityPluginDetailPageOrder, resolveFileUploaderEditDialog, resolveFileUploaderEntityScope, resolveLookupDisplayField, resolveLookupDisplayTemplate, restoreEntityListExpandedRows, runEntityQuery, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider, shouldLoadEntityListStateFromStorage, shouldResetEntityListStateOnRouteEntry };
-export type { AXPAuditEvent, AXPCollectEntityQuickSearchPathsResolver, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityAggregateMeasure, AXPEntityAggregateOptions, AXPEntityAggregateReducerType, AXPEntityAggregateRequest, AXPEntityAggregateResult, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorCategoryFilterOptions, AXPEntityDataSelectorCategoryOptions, AXPEntityDataSelectorCreateOptions, AXPEntityDataSelectorFilterOptions, AXPEntityDataSelectorGridOptions, AXPEntityDataSelectorOpenInput, AXPEntityDataSelectorOpenOptions, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDataSelectorRowActionsConfig, AXPEntityDataSelectorSearchOptions, AXPEntityDataSelectorSelectionOptions, AXPEntityDataSelectorSortOptions, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListExpandRowRef, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListPagingState, AXPEntityListPersistenceMode, AXPEntityListToolbarConvertOptions, AXPEntityMasterListCardLayout, AXPEntityMasterListCardSecondaryActionItem, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityQueryAllOptions, AXPEntityQueryAllResult, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPFileListLook, AXPFileUploaderEditDialogFieldOptions, AXPFileUploaderEditDialogMode, AXPFileUploaderEditDialogOptions, AXPFileUploaderEntityFilesScope, AXPFileUploaderLoadFilesInput, AXPFileUploaderLoadFilesResult, AXPFileUploaderSaveFilesInput, AXPFileUploaderSaveFilesResult, AXPFileUploaderShowFileListEntityContext, AXPFileUploaderShowFileListOptions, AXPFileUploaderUploadActionDescriptor, AXPFileUploaderWidgetColumnOptions, AXPFileUploaderWidgetDesignerOptions, AXPFileUploaderWidgetEditOptions, AXPFileUploaderWidgetOptions, AXPFileUploaderWidgetPrintOptions, AXPFileUploaderWidgetViewOptions, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupDisplayOptions, AXPLookupPopoverOptions, AXPLookupSelectorRowActionsConfig, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMockDto, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRecordWorkflowInfo, 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 { 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, AXPEntityEventsKeys, 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, AXP_RECORD_WORKFLOW_INFO_CORRELATION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_DEFINITION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD, 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, buildAXPRecordWorkflowInfo, canPersistEntityListState, cloneLayoutArrays, collectEntityQuickSearchFieldPaths, collectNestedFieldPathsFromEntityColumns, collectQuickSearchPathsFromSingleEntityDefinition, 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, getRecordWorkflowCorrelationId, getRecordWorkflowInstanceId, 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 { AXPCollectEntityQuickSearchPathsResolver, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityAggregateMeasure, AXPEntityAggregateOptions, AXPEntityAggregateReducerType, AXPEntityAggregateRequest, AXPEntityAggregateResult, 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, AXPEntityQueryAllOptions, AXPEntityQueryAllResult, 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 };

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

@@ -3,6 +3,7 @@ import * as _angular_core from '@angular/core';
 import { Signal, 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 * as i1 from '@acorex/cdk/drawer';
 import { AXDrawerItemDirective } from '@acorex/cdk/drawer';
 import * as _acorex_platform_core from '@acorex/platform/core';
@@ -14,15 +15,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, AXPSettingsService, AXPEntityCommandScope } from '@acorex/platform/common';
+import * as _angular_router from '@angular/router';
+import { Router, ActivatedRoute } from '@angular/router';
 import { AXBasePageComponent } from '@acorex/components/page';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPPageStatus as AXPPageStatus$1, AXPWidgetContainerComponent } from '@acorex/platform/layout/widget-core';
 import * as _acorex_platform_layout_views from '@acorex/platform/layout/views';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXTabStripChangedEvent } from '@acorex/components/tabs';
-import * as _angular_router from '@angular/router';
-import { Router, ActivatedRoute } from '@angular/router';
 
 declare abstract class AXPPageLayoutBase {
     abstract primaryMenuItems: Signal<AXPActionMenuItem[]>;
@@ -117,6 +117,7 @@ declare class AXPPageLayoutComponent {
         isPrinting: boolean;
     }>;
     protected deviceService: AXPDeviceService;
+    protected tabNavigation: AXPTabNavigationService;
     protected startSideDrawer: _angular_core.Signal<AXDrawerItemDirective | undefined>;
     protected workflow: AXPWorkflowService;
     protected commandService: AXPCommandService;
@@ -206,10 +207,28 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected readonly homePageService: AXPHomePageService;
     protected readonly policyService: AXPPolicyEngineService;
     protected readonly settingsService: AXPSettingsService;
+    protected readonly tabNavigation: AXPTabNavigationService;
+    protected readonly tabPreviewService: AXPTabPreviewService;
+    protected readonly unsavedChangesConfirm: AXPUnsavedChangesConfirmService;
+    protected readonly router: Router;
     private _updateTrigger;
+    /** Tab key captured at page init — stable while the route instance is cached. */
+    private readonly pageTabKey;
     protected updateTrigger: _angular_core.Signal<number>;
     protected recompute(): void;
     ngOnInit(): Promise<void>;
+    /** Maps the home-page route to the pinned home tab key instead of a path-based key. */
+    private resolvePageTabKey;
+    protected publishTabStructuredPreview(tabKey: string, input: {
+        titleValue: AXPMultiLanguageString;
+        descriptionValue: AXPMultiLanguageString | null;
+        icon: string | null;
+        breadcrumbItems: AXPBreadcrumbItem[];
+        isDirty: boolean;
+    }): Promise<void>;
+    protected resolveMultiLanguageText(value: AXPMultiLanguageString | null | undefined, fallback: string): Promise<string>;
+    /** Resolves i18n keys (`@scope:key`); returns plain text unchanged. */
+    protected translateTextIfKey(text: string): Promise<string>;
     title: _angular_core.WritableSignal<_acorex_core_translation.AXMultiLanguageString>;
     titleIcon: _angular_core.WritableSignal<string | null>;
     protected getPageTitle(): AXPMultiLanguageString | Promise<AXPMultiLanguageString>;
@@ -223,9 +242,20 @@ 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. */
+    protected resolveBreadcrumbTabTitle(pageBreadcrumbs: AXPBreadcrumbItem[]): Promise<string | null>;
+    /** Resolves a breadcrumb label the same way as page chrome (`t(item.title)`). */
+    protected resolveBreadcrumbItemTitle(item: AXPBreadcrumbItem | undefined): Promise<string | null>;
+    /** Fallback tab label from the page title when breadcrumbs are not ready yet. */
+    protected resolvePageTitleForTab(): Promise<string | null>;
     badge: _angular_core.WritableSignal<AXPBadge | null>;
     hasBadge: _angular_core.Signal<boolean>;
     hasUnsavedChanges(): boolean;
+    /**
+     * Confirms closing this page as a background tab (no router navigation).
+     * Override when dirty detection differs from {@link hasUnsavedChanges}.
+     */
+    onBeforeTabClose(): boolean | Promise<boolean>;
     protected getPageBadge(): Promise<AXPBadge | null>;
     resolvePageBadge(): Promise<AXPBadge | null>;
     status: _angular_core.WritableSignal<AXPPageStatus | null>;
@@ -658,11 +688,9 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         evaluatedTabContentsById: Record<string, _acorex_platform_layout_widget_core.AXPWidgetNode[]>;
         formDirty: boolean;
     }>;
-    protected router: Router;
     protected route: ActivatedRoute;
     protected eventService: AXPBroadcastEventService;
     protected deviceService: AXPDeviceService;
-    private readonly unsavedChangesConfirm;
     private readonly unsavedChangesPopstate;
     private readonly pageComponentInstanceRegistry;
     private readonly shortcutRegistry;
@@ -724,6 +752,8 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     private getLiveFormContext;
     private finalizeSave;
     private finalizeDiscard;
+    /** Reverts widget form state and view-model context to the last saved baseline. */
+    private discardUnsavedChanges;
     /**
      * `ax-tabs` selects on click before we can confirm. Revert synchronously, then confirm + switch.
      */
@@ -740,6 +770,7 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     protected getPageTitle(): Promise<AXPMultiLanguageString>;
     getPageDescription(): Promise<AXPMultiLanguageString | null>;
     getBackButton(): Promise<AXPBackButton | null>;
+    hasUnsavedChanges(): boolean;
     getPageBadge(): Promise<AXPBadge | null>;
     getPageStatus(): Promise<AXPPageStatus | null>;
     /**
@@ -751,11 +782,14 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
      * Router guard hook — same unsaved-changes confirm as dialog builder {@link confirmCloseWhenDirty}.
      */
     canDeactivate(): Promise<boolean>;
+    /** Background tab close — confirm without discarding (the cached instance is destroyed). */
+    onBeforeTabClose(): Promise<boolean>;
     /** Active entity component page instance, when the current details sub-page is component-based. */
     private getActivePageComponentInstance;
     /** Component key for the current details sub-page, when content is component-based. */
     private getActivePageComponentKey;
     private static isComponentPageContent;
+    protected pageContentTrackKey(item: AXPPageContentItem, index: number): string;
     /** Whether the active component-based entity page has unsaved edits. */
     private isActivePageComponentDirty;
     /** Whether the current details page has user-origin unsaved edits (form or component page). */