@acorex/platform 21.0.0-next.65 → 21.0.0-next.67

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

@@ -1,24 +1,24 @@
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPExecuteCommandResult, AXPMetaData, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPQueryRequest, AXPPagedListResult, AXPUserReference, AXPCategoryEntity as AXPCategoryEntity$1, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPMultiLanguageString, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPContextChangeEvent } from '@acorex/platform/core';
+import { AXPExecuteCommandResult, AXPMetaData, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPGridLayoutOptions, AXPMultiLanguageString, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPQueryRequest, AXPPagedListResult, AXPUserReference, AXPCategoryEntity as AXPCategoryEntity$1, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPFileListItem, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, 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 { AXPopoverComponent } from '@acorex/components/popover';
-import * as i3 from '@acorex/platform/layout/widget-core';
-import { AXPWidgetNode, AXPWidgetColumnNode, AXPWidgetCoreService, AXPColumnWidgetComponent, AXPValueWidgetComponent, AXPWidgetConfig, AXPWidgetRendererDirective } from '@acorex/platform/layout/widget-core';
-import { AXPPreloadFiltersApplyEvent, AXPColumnItemListItem, AXPDataSelectorAllowCreate, AXPCategoryTreeDataSource } from '@acorex/platform/layout/components';
+import * as i4 from '@acorex/platform/layout/widget-core';
+import { AXPWidgetNode, AXPWidgetColumnNode, AXPWidgetCoreService, AXPColumnWidgetComponent, AXPValueWidgetComponent, AXPWidgetConfig, AXPWidgetCoreElementAPI, AXPWidgetRendererDirective } 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 { AXStyleColorType, AXDataSource, AXDataSourceFilterOption, AXDataSourceSortOption, AXValueChangedEvent, AXClickEvent, AXFocusEvent, AXHtmlEvent } from '@acorex/cdk/common';
 import * as _acorex_platform_common from '@acorex/platform/common';
-import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPEntityPage, AXPQueryFilter } from '@acorex/platform/common';
+import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPCardField, AXPRelatedEntity, AXPEntitySectionView, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityMasterListLayoutType, AXPEntityMasterListDisplayMode, AXPEntityMasterListLayoutOption, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPEntityPage, AXPQueryFilter, AXCFileUploaderCapabilities, AXCFileUploaderAction } from '@acorex/platform/common';
 import * as i1 from '@angular/router';
 import { ResolveFn } from '@angular/router';
 import * as rxjs from 'rxjs';
 import { Subject } from 'rxjs';
 export { AXPEntityDefinitionCrudService, AXP_ENTITY_DEFINITION_CRUD_SERVICE } from '@acorex/platform/domain';
-import * as i2 from '@acorex/platform/workflow';
+import * as i3 from '@acorex/platform/workflow';
 import { AXPWorkflowService, AXPWorkflow, AXPWorkflowAction, AXPWorkflowContext } from '@acorex/platform/workflow';
-import * as i4 from '@acorex/platform/layout/builder';
+import * as i5 from '@acorex/platform/layout/builder';
 import { IActionBuilder, AXPDialogRef, IFormFieldBuilder } from '@acorex/platform/layout/builder';
 import { AXPSessionService } from '@acorex/platform/auth';
 import { AXTreeViewNode, AXTreeViewComponent, AXTreeViewNodeSelectEvent } from '@acorex/components/tree-view';
@@ -28,6 +28,8 @@ import { AXFormatService } from '@acorex/core/format';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
 import * as _acorex_core_translation from '@acorex/core/translation';
 import { AXTranslationService } from '@acorex/core/translation';
+import * as _acorex_platform_layout_entity from '@acorex/platform/layout/entity';
+import { AXFileService } from '@acorex/core/file';
 import { AXPProviderSelectWidgetEditBase, AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widgets';
 
 declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
@@ -314,6 +316,22 @@ declare class AXPEntityListViewColumnViewModel {
     width: '';
     node: _angular_core.Signal<AXPWidgetColumnNode>;
 }
+declare class AXPEntityListViewCardFieldViewModel {
+    readonly property: AXPEntityProperty;
+    readonly field: AXPCardField;
+    constructor(property: AXPEntityProperty, field: AXPCardField);
+    name: string;
+    title: string;
+    visible: string | boolean;
+    layout: _acorex_platform_common.AXPEntityPropertyLayoutConfig | undefined;
+    display: string;
+    isBadgeDisplay: boolean;
+    badgeColor: string | undefined;
+    isStatusWidget: boolean;
+    node: _angular_core.Signal<AXPWidgetColumnNode>;
+    /** Readonly column node for status fields shown as header badges. */
+    headerBadgeNode: _angular_core.Signal<AXPWidgetColumnNode>;
+}
 
 declare class AXPEntityDetailListViewModel {
     private injector;
@@ -498,6 +516,17 @@ interface AXPEntityMasterListViewSortPropViewModel {
     title: string;
     dir?: string;
 }
+/** Built-in card list row action that toggles multi-select mode via {@link AXPEntityMasterListViewModel.selectedItems}. */
+declare const AXPEntityMasterListCardSelectActionName = "axp-entity-card:select";
+interface AXPEntityMasterListCardSecondaryActionItem {
+    name: string;
+    title: string;
+    icon?: string;
+    color?: string;
+    disabled?: boolean | string;
+    divided?: boolean;
+    isCardSelect?: boolean;
+}
 declare class AXPEntityMasterListViewQueryViewModel {
     private entity;
     private section;
@@ -522,10 +551,12 @@ declare class AXPEntityMasterListViewModel {
     private readonly settings;
     private readonly widgetResolver;
     private readonly expressionEvaluator;
+    private readonly translation;
     private readonly commandService;
     private readonly eventService;
     private readonly queryExecutor;
     private readonly filterOperatorMiddleware;
+    private readonly entityDefinitionRegistry;
     private settingEntityKey;
     private readonly destroyed;
     private lastAppliedSortKey;
@@ -552,9 +583,72 @@ declare class AXPEntityMasterListViewModel {
      * if `indexCol` is omitted, visibility follows {@link AXPCommonSettings.ShowRowIndexColumn}.
      */
     showIndexColumn: _angular_core.Signal<boolean>;
+    /** Layouts enabled via `interfaces.master.list.layouts.*.enabled`. */
+    enabledListLayouts: _angular_core.Signal<AXPEntityMasterListLayoutType[]>;
+    /** True when the user can switch between multiple enabled layouts. */
+    canSwitchListLayout: _angular_core.Signal<boolean>;
+    /** Active list layout for the current view. */
+    activeListLayout: _angular_core.WritableSignal<AXPEntityMasterListLayoutType>;
+    tableLayout: _angular_core.Signal<{
+        enabled?: boolean;
+        columns: AXPEntityTableColumn[];
+    } | undefined>;
+    cardLayout: _angular_core.Signal<{
+        enabled?: boolean;
+        header: {
+            title?: string;
+            description?: string;
+            icon?: string;
+        };
+        fields: AXPCardField[];
+    } | undefined>;
+    /** Global expanded state for all card bodies in card layout. */
+    cardContentExpanded: _angular_core.WritableSignal<boolean>;
+    /** Current presentation mode (table, compact cards, or expanded cards). */
+    listDisplayMode: _angular_core.Signal<AXPEntityMasterListDisplayMode>;
+    /**
+     * Sets global card body visibility for card layout.
+     */
+    setCardContentExpanded(expanded: boolean): void;
+    /**
+     * Switches table vs compact/expanded card presentation.
+     */
+    setListDisplayMode(mode: AXPEntityMasterListDisplayMode): void;
+    /** Enabled layouts with display metadata for the title layout switcher. */
+    availableListLayouts: _angular_core.Signal<AXPEntityMasterListLayoutOption[]>;
+    /** Active layout option (for title icon and switcher selection state). */
+    currentListLayout: _angular_core.Signal<AXPEntityMasterListLayoutOption | null>;
+    private static readonly LAYOUT_META;
+    /**
+     * Switches to the given layout when it is enabled.
+     * Persists the choice at entity list level (shared across all views).
+     */
+    setListLayout(layout: AXPEntityMasterListLayoutType): void;
+    /**
+     * Cycles to the next enabled layout (table → card → table …).
+     * No-op when only one layout is enabled.
+     */
+    switchListLayout(): AXPEntityMasterListLayoutType;
+    private resolveActiveListLayout;
+    private applyListLayoutFromSettings;
     private createExpressionScope;
     private resolveCommandNameExpression;
     private resolveTitleExpression;
+    /**
+     * Resolves a card header value (title, description, icon) from a property path, expression, or literal.
+     * Supports multiple `{{ ... }}` segments in one string (e.g. `{{context.eval("a")}} - {{context.eval("b")}}`).
+     * Multi-language maps (e.g. `{ "en-US": "...", "fa-IR": "..." }`) are returned as-is for the translate pipe.
+     */
+    resolveCardHeaderValue(value: string | undefined, rowData: unknown): Promise<AXPMultiLanguageString>;
+    /**
+     * Keeps i18n payloads intact for `translate`; coerces only plain scalars to string.
+     */
+    private normalizeCardHeaderDisplayValue;
+    /**
+     * Resolves badge color for a card header field (semantic token or expression per row).
+     */
+    resolveCardBadgeColor(field: AXPEntityListViewCardFieldViewModel, rowData: unknown): Promise<AXStyleColorType>;
+    private resolveCardBadgeColorValue;
     private resolveTriggerName;
     setView(viewName?: string | null): Promise<void>;
     dataSource: AXDataSource<any>;
@@ -582,7 +676,7 @@ declare class AXPEntityMasterListViewModel {
      */
     updateExpandedRowId(rowId: string, expanded: boolean): void;
     handleRowExpandChange(rowData: Record<string, unknown>): void;
-    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize' | 'listPaging' | 'filters' | 'sorts' | 'expandedRows', data?: unknown): Promise<void>;
+    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize' | 'listPaging' | 'filters' | 'sorts' | 'expandedRows' | 'listLayout' | 'cardContentExpanded', data?: unknown): Promise<void>;
     selectedItems: _angular_core.WritableSignal<any[]>;
     /**
      * Selected category from the category sidebar (left panel).
@@ -617,6 +711,10 @@ declare class AXPEntityMasterListViewModel {
     selectedScopeActionsCount: _angular_core.Signal<number>;
     primaryRowActions: _angular_core.Signal<AXPEntityCommandTriggerViewModel[]>;
     secondaryRowActions(rowData: any): Promise<AXPEntityCommandTriggerViewModel[]>;
+    /**
+     * Secondary actions for card layout rows, with the built-in Select action last (divider above it).
+     */
+    cardSecondaryRowActions(rowData: unknown): Promise<AXPEntityMasterListCardSecondaryActionItem[]>;
     filterQueries: _angular_core.WritableSignal<AXPFilterQuery[]>;
     private static readonly URL_FILTER_OPERATOR_TYPES;
     get properties(): AXPEntityProperty[];
@@ -646,6 +744,20 @@ declare class AXPEntityMasterListViewModel {
     onColumnsChanged(columns: AXPEntityListViewColumnViewModel[]): Promise<void>;
     applyViewColumns(): void;
     onColumnsOrderChanged(event: any): void;
+    private mergeDisplayFieldWithColumn;
+    private buildVirtualDisplayProperty;
+    private normalizeRelatedColumnNames;
+    private findRelatedEntityForField;
+    private getRegisteredEntity;
+    private resolveRelatedEntityProperty;
+    private resolveRelatedEntityColumnDataPath;
+    private deriveDataPathFromLookupProperty;
+    private resolveParentDataPathForRelatedField;
+    private resolveDisplayFieldProperty;
+    private resolveCardField;
+    private allAvailableCardFields;
+    cardFields: _angular_core.WritableSignal<AXPEntityListViewCardFieldViewModel[]>;
+    applyCardFields(): void;
     sortableFields: () => {
         name: string;
         title: string;
@@ -875,6 +987,7 @@ declare class AXPEntityPreloadFiltersViewModel {
 }
 declare const AXPEntityPreloadFiltersViewModelResolver: ResolveFn<Promise<AXPEntityPreloadFiltersViewModel>>;
 
+type AXPEntityMasterListCardLayout = NonNullable<NonNullable<AXPEntityMasterListView['layouts']>['card']>;
 interface AXPEntityModifierContext {
     readonly entity: AXPEntity;
     plugins: {
@@ -971,6 +1084,12 @@ interface AXPEntityModifierContext {
             list: {
                 get(): AXPEntityMasterListView | undefined;
                 update(updater: (c: AXPEntityMasterListView | undefined) => AXPEntityMasterListView): AXPEntityModifierContext;
+                card: {
+                    get(): AXPEntityMasterListCardLayout | undefined;
+                    set(layout: AXPEntityMasterListCardLayout): AXPEntityModifierContext;
+                    update(updater: (layout: AXPEntityMasterListCardLayout | undefined) => AXPEntityMasterListCardLayout | undefined): AXPEntityModifierContext;
+                    remove(): AXPEntityModifierContext;
+                };
             };
         };
         detail: {
@@ -1501,9 +1620,67 @@ declare function getMasterInterfacePropertySortKey(interfaceRow: {
     layout?: AXPEntityPropertyLayoutConfig | undefined;
 } | undefined, indexInMasterInterfaceList: number): number;
 
+/** How to show attachments in entity single/create/update: as a section (default) or as a separate page. */
+type AttachmentsDisplayMode = 'section' | 'page';
+/** Component key used when display is 'page'. Register a page component with this key via AXP_PAGE_COMPONENT_PROVIDER. */
+declare const ATTACHMENTS_PAGE_COMPONENT_KEY = "entity-attachments-page";
+type AttachmentLocalizedText = string | Record<string, string>;
+type AttachmentSectionOptions = {
+    order?: number;
+    title?: AttachmentLocalizedText;
+};
+type AttachmentsEditDialogOptions = {
+    mode?: 'manual' | 'auto';
+    fields?: {
+        name?: boolean;
+        title?: boolean;
+        description?: boolean;
+    };
+};
+type AttachmentsPluginOptions = {
+    field?: string;
+    title?: AttachmentLocalizedText;
+    display?: AttachmentsDisplayMode;
+    accept?: string;
+    multiple?: boolean;
+    fileEditable?: boolean;
+    /** When true, attachments field and list action run in read-only mode (widget option `readonly`). */
+    'readonly'?: boolean;
+    /** When true (default), registers a list column for the attachments field. Set false to hide the column. */
+    showListColumn?: boolean;
+    /** When true (default), registers the list upload action. Set false to omit the action. */
+    showListAction?: boolean;
+    /** Section options when display is 'section'. */
+    section?: AttachmentSectionOptions;
+    /** File edit dialog options. */
+    editDialog?: AttachmentsEditDialogOptions;
+    plugins?: {
+        name: string;
+        options?: unknown;
+    }[];
+    /** Widget option `showBorder`. Default false for attachments (section and page). */
+    showBorder?: boolean;
+    /** Widget option `showAddItemButton`. Default false when display is `page`, true for section. */
+    showAddItemButton?: boolean;
+};
+/**
+ * Attachments plugin.
+ * - Always ensures an attachments group and property; when display is 'section' (default), adds a section to single/create/update layouts.
+ * - When display is 'page', adds a page to entity.pages with ATTACHMENTS_PAGE_COMPONENT_KEY; register a page component with that key via AXP_PAGE_COMPONENT_PROVIDER.
+ * - List column and list upload action can be turned off with `showListColumn` / `showListAction` (both default true).
+ * - Uses provided accept/multiple/fileEditable; others are fixed.
+ */
+declare const attachmentsPlugin: AXPEntityActionPlugin;
+
+declare class AXPAttachmentsPluginModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPAttachmentsPluginModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPAttachmentsPluginModule, never, never, never>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPAttachmentsPluginModule>;
+}
+
 declare class AXPEntityModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPEntityModule, never, [typeof i1.RouterModule, typeof i2.AXPWorkflowModule, typeof i3.AXPWidgetCoreModule, typeof i4.LayoutBuilderModule], never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPEntityModule, never, [typeof i1.RouterModule, typeof AXPAttachmentsPluginModule, typeof i3.AXPWorkflowModule, typeof i4.AXPWidgetCoreModule, typeof i5.LayoutBuilderModule], never>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPEntityModule>;
 }
 
@@ -1767,6 +1944,13 @@ declare const searchResultDescriptionMiddlewareProvider: AXPEntityModifierProvid
 declare const defaultMultiLanguageMiddleware: AXPEntityModifier;
 declare const defaultMultiLanguageMiddlewareProvider: AXPEntityModifierProvider;
 
+/**
+ * When an entity has no `interfaces.master.list.layouts.card`, creates a sensible default
+ * from list columns and property names (title, description, remaining columns as card fields).
+ */
+declare const defaultCardLayoutMiddleware: AXPEntityModifier;
+declare const defaultCardLayoutMiddlewareProvider: AXPEntityModifierProvider;
+
 /**
  * Registers entity CRUD commands and queries for the given entity keys.
  * Use in app/module providers; consumes AXPEntityService from this package.
@@ -2516,6 +2700,362 @@ declare class AXPTruncatedBreadcrumbComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTruncatedBreadcrumbComponent, "axp-truncated-breadcrumb", never, { "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "characterLimit": { "alias": "characterLimit"; "required": false; "isSignal": true; }; "sectionLimit": { "alias": "sectionLimit"; "required": false; "isSignal": true; }; "separatorIcon": { "alias": "separatorIcon"; "required": false; "isSignal": true; }; "ellipsisIcon": { "alias": "ellipsisIcon"; "required": false; "isSignal": true; }; "eyeIcon": { "alias": "eyeIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+declare class AXPEditFileUploaderCommand implements AXPCommand<{
+    file: AXPFileListItem;
+    plugins?: {
+        name: string;
+        options?: unknown;
+    }[];
+    excludePlugins?: string[];
+    enableTitleDescription?: boolean;
+    isNewFile?: boolean;
+}, AXPFileListItem> {
+    private readonly layoutBuilder;
+    private readonly translationService;
+    private readonly hooks;
+    execute(input: {
+        file: AXPFileListItem;
+        plugins?: {
+            name: string;
+            options?: unknown;
+        }[];
+        excludePlugins?: string[];
+        enableTitleDescription?: boolean;
+        isNewFile?: boolean;
+    }): Promise<AXPExecuteCommandResult<AXPFileListItem>>;
+    private showEditDialog;
+    /**
+     * Build form fields from hook items (old format parameters)
+     */
+    private buildFormFields;
+    /**
+     * Build groups/containers from hook groups (old format groups)
+     */
+    private buildGroups;
+    /**
+     * Apply widget configuration to field based on widget type
+     */
+    private applyWidget;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEditFileUploaderCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEditFileUploaderCommand>;
+}
+
+declare class AXPFileListComponent implements OnInit, OnDestroy {
+    private fileTypeService;
+    private fileStorageService;
+    private commandExecutor;
+    private hooks;
+    isLoading: _angular_core.WritableSignal<boolean>;
+    private fileTypes;
+    onRemove: _angular_core.OutputEmitterRef<AXPFileListItem>;
+    onRevert: _angular_core.OutputEmitterRef<AXPFileListItem>;
+    onRename: _angular_core.OutputEmitterRef<AXPFileListItem>;
+    readonly: _angular_core.InputSignal<boolean>;
+    fileEditable: _angular_core.InputSignal<boolean>;
+    /** When true, edit dialog shows name, title and description fields. Default false. */
+    enableTitleDescription: _angular_core.InputSignal<boolean>;
+    multiple: _angular_core.InputSignal<boolean>;
+    files: _angular_core.InputSignal<AXPFileListItem[]>;
+    plugins: _angular_core.InputSignal<{
+        name: string;
+        options?: unknown;
+    }[] | undefined>;
+    excludePlugins: _angular_core.InputSignal<string[] | undefined>;
+    capabilities: _angular_core.InputSignal<AXCFileUploaderCapabilities | undefined>;
+    /**
+     * All files should be displayed, even those with `deleted` status.
+     * The template will handle the visual differences based on the status.
+     */
+    displayFiles: _angular_core.Signal<AXPFileListItem[]>;
+    private fileIdToActions;
+    private globalActions;
+    private filesChangeEffect;
+    private getDefaultActions;
+    /** True when the widget is readonly or this file row is locked (`readOnly`). */
+    isItemInteractionLocked(file: AXPFileListItem): boolean;
+    actionsFor(file: AXPFileListItem, index: number): any[];
+    private loadActionsFor;
+    ngOnInit(): Promise<void>;
+    private loadGlobalActions;
+    protected getFileInfo(fileName: string): {
+        icon: string;
+        type: string;
+    };
+    handleFileDownload(event: AXClickEvent, file: AXPFileListItem): Promise<void>;
+    handleFileRemove(event: AXClickEvent, file: AXPFileListItem): Promise<void>;
+    /**
+     * Handle revert action – emit the file so parent components can update the status.
+     */
+    handleFileRevert(event: AXClickEvent, file: AXPFileListItem): void;
+    /**
+     * Handle file edit action – open rename popup
+     */
+    handleFileEdit(event: any, file: AXPFileListItem): Promise<void>;
+    ngOnDestroy(): void;
+    runAction(action: any): Promise<void>;
+    protected getActionColor(action: any): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileListComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPFileListComponent, "axp-file-list", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "fileEditable": { "alias": "fileEditable"; "required": false; "isSignal": true; }; "enableTitleDescription": { "alias": "enableTitleDescription"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "files": { "alias": "files"; "required": false; "isSignal": true; }; "plugins": { "alias": "plugins"; "required": false; "isSignal": true; }; "excludePlugins": { "alias": "excludePlugins"; "required": false; "isSignal": true; }; "capabilities": { "alias": "capabilities"; "required": false; "isSignal": true; }; }, { "onRemove": "onRemove"; "onRevert": "onRevert"; "onRename": "onRename"; }, never, never, true, never>;
+}
+
+/** Stable fingerprint for one file row; ignores Blob binary content. */
+declare function fingerprintAttachmentItem(item: unknown): string;
+/** Order-independent fingerprint for attachment lists. */
+declare function fingerprintAttachments(value: unknown): string;
+/** True when lists represent the same attachments regardless of blob vs fileId shape. */
+declare function attachmentsSemanticallyEqual(a: unknown, b: unknown): boolean;
+/** Attachment rows that remain after a successful save (drops soft-deleted rows). */
+declare function committedAttachments(value: unknown): AXPFileListItem[];
+/**
+ * Post-save attachment list: drops soft-deleted rows and promotes pending `attached` rows to `uploaded`
+ * so deferred-save pages get the same delete/revert behavior as after a full reload.
+ */
+declare function persistedAttachments(value: unknown): AXPFileListItem[];
+
+interface AXPFileUploaderEntityFilesScope {
+    name: string;
+    id: string;
+    field: string;
+}
+declare function isFileListItem(value: unknown): value is AXPFileListItem;
+/** Whether a list-row value represents one attachment (file item, id reference, or fileId source). */
+declare function isAttachmentListEntry(value: unknown): boolean;
+declare function attachmentFieldCount(fieldValue: unknown): number;
+declare function normalizeEntityFieldToFileList(fieldValue: unknown): AXPFileListItem[];
+declare function resolveFileUploaderEntityScope(options: Record<string, unknown>, rowData: Record<string, unknown> | undefined, fieldFallback?: string): AXPFileUploaderEntityFilesScope | undefined;
+
+interface AXPFileUploaderLoadFilesInput extends AXPFileUploaderEntityFilesScope {
+}
+interface AXPFileUploaderLoadFilesResult {
+    files: AXPFileListItem[];
+    /** Count including file-id references, not only hydrated AXPFileListItem rows. */
+    count: number;
+}
+declare class AXPFileUploaderLoadFilesQuery implements AXPQuery<AXPFileUploaderLoadFilesInput, AXPFileUploaderLoadFilesResult> {
+    private readonly injector;
+    fetch(input: AXPFileUploaderLoadFilesInput): Promise<AXPFileUploaderLoadFilesResult>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileUploaderLoadFilesQuery, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPFileUploaderLoadFilesQuery>;
+}
+
+interface AXPFileUploaderSaveFilesInput extends AXPFileUploaderEntityFilesScope {
+    files: AXPFileListItem[];
+}
+interface AXPFileUploaderSaveFilesResult {
+    entityData: Record<string, unknown>;
+}
+declare class AXPFileUploaderSaveFilesCommand implements AXPCommand<AXPFileUploaderSaveFilesInput, AXPFileUploaderSaveFilesResult> {
+    private readonly injector;
+    execute(input: AXPFileUploaderSaveFilesInput): Promise<AXPExecuteCommandResult<AXPFileUploaderSaveFilesResult>>;
+}
+
+/** Serializable upload action exposed via widget `api().getUploadActions()`. */
+interface AXPFileUploaderUploadActionDescriptor {
+    plugin: string;
+    text?: string;
+    textKey?: string;
+    icon?: string;
+}
+type AXPFileUploaderEditDialogMode = 'manual' | 'auto';
+interface AXPFileUploaderEditDialogFieldOptions {
+    name?: boolean;
+    title?: boolean;
+    description?: boolean;
+}
+interface AXPFileUploaderEditDialogOptions {
+    mode?: AXPFileUploaderEditDialogMode;
+    fields?: AXPFileUploaderEditDialogFieldOptions;
+}
+declare function resolveFileUploaderEditDialog(options?: Record<string, unknown>): AXPFileUploaderEditDialogOptions | undefined;
+declare function isFileUploaderEditDialogAuto(editDialog?: AXPFileUploaderEditDialogOptions): boolean;
+declare function hasFileUploaderTitleOrDescriptionFields(editDialog?: AXPFileUploaderEditDialogOptions): boolean;
+
+declare class AXPFileUploaderWidgetColumnComponent extends AXPColumnWidgetComponent<AXPFileListItem[]> {
+    protected fileCount: _angular_core.WritableSignal<number>;
+    private loadRequestId;
+    private fileService;
+    private queryExecutor;
+    constructor();
+    openFileList(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileUploaderWidgetColumnComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPFileUploaderWidgetColumnComponent, "axp-file-uploader-widget-column", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class AXPFileUploaderWidgetEditComponent extends AXPValueWidgetComponent<AXPFileListItem[] | undefined> {
+    protected readonly fileService: AXFileService;
+    private readonly hooks;
+    private readonly fileActionsService;
+    private readonly commandExecutor;
+    private readonly dirtyChangeSubject;
+    private readonly uploadActionsChangeSubject;
+    private readonly savedSnapshot;
+    private readonly baselineFingerprint;
+    private readonly baselinePendingReconcile;
+    private readonly isDirtySignal;
+    private skipDirtyEvaluation;
+    /** Status before soft-delete; used for restore when baseline was not synced (section layout). */
+    private readonly statusBeforeDelete;
+    private readonly autoBaselineSynced;
+    /** Sync baseline from context when not wired by a deferred-save page (section layout). */
+    private readonly baselineInitEffect;
+    protected multiple: _angular_core.Signal<boolean>;
+    private readonly acceptOverride;
+    protected accept: _angular_core.Signal<string>;
+    protected plugins: _angular_core.Signal<{
+        name: string;
+        options?: unknown;
+    }[]>;
+    protected pluginNames: _angular_core.Signal<string[]>;
+    protected excludePlugins: _angular_core.Signal<string[]>;
+    protected fileEditable: _angular_core.Signal<boolean>;
+    protected editDialog: _angular_core.Signal<_acorex_platform_layout_entity.AXPFileUploaderEditDialogOptions | undefined>;
+    protected enableTitleDescription: _angular_core.Signal<boolean>;
+    /** When mode is `auto`, show the edit dialog after each file select. */
+    protected showEditDialogAfterSelect: _angular_core.Signal<boolean>;
+    protected readonly: _angular_core.Signal<boolean>;
+    protected showBorder: _angular_core.Signal<boolean>;
+    protected showAddItemButton: _angular_core.Signal<boolean>;
+    protected maxFileSize: _angular_core.Signal<number>;
+    protected isDragOver: _angular_core.WritableSignal<boolean>;
+    private readonly innerActions;
+    protected readonly fileActions: _angular_core.Signal<AXCFileUploaderAction[]>;
+    ngOnInit(): void;
+    setValue(value: AXPFileListItem[] | null | undefined): void;
+    /** Align dirty baseline with persisted attachments (call when record loads or after discard remount). */
+    syncBaseline(saved: AXPFileListItem[] | undefined): void;
+    /** Mark current list as saved; clears dirty and drops soft-deleted rows from the UI. */
+    markSaved(): void;
+    /** Revert widget value to last saved baseline. */
+    discardToBaseline(): void;
+    api(): AXPWidgetCoreElementAPI;
+    /** Current upload actions for host pages (always read via api; list may change after plugins load). */
+    getUploadActionDescriptors(): AXPFileUploaderUploadActionDescriptor[];
+    runUploadActionByPlugin(plugin: string): Promise<void>;
+    private notifyUploadActionsChanged;
+    private evaluateDirty;
+    private setDirty;
+    private loadActions;
+    private configureFromHooks;
+    /**
+     * Process files from various sources (file picker, drag-drop, etc.)
+     * When showEditDialogAfterSelect is true, the edit dialog (with plugin hooks) is shown per file before adding; otherwise files are added and user can edit via Edit button.
+     */
+    private processFiles;
+    /**
+     * Show edit dialog per file and add only those submitted. Used when showEditDialogAfterSelect is true (both from zone and from dropdown actions).
+     */
+    private addFilesWithEditDialogAsync;
+    protected files: _angular_core.Signal<AXPFileListItem[]>;
+    handleFileRemove(file: AXPFileListItem): void;
+    removeFile(file: AXPFileListItem): void;
+    /**
+     * Revert a deleted file back to its pre-delete status.
+     */
+    handleFileRevert(file: AXPFileListItem): void;
+    private resolveRestoredStatus;
+    /**
+     * Handle file rename action. Persists name/title/description to file storage immediately when edited
+     * so they are saved even if the entity payload does not carry these fields.
+     */
+    handleFileRename(file: AXPFileListItem): void;
+    clear(): void;
+    protected readonly capabilities: AXCFileUploaderCapabilities;
+    onFileChange(event: {
+        event: Event;
+        files: File[];
+    }): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileUploaderWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPFileUploaderWidgetEditComponent, "axp-file-uploader-widget-edit", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPFileUploaderWidgetViewComponent extends AXPValueWidgetComponent<AXPFileListItem[]> {
+    protected files: _angular_core.Signal<AXPFileListItem[]>;
+    private get __class();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileUploaderWidgetViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPFileUploaderWidgetViewComponent, "axp-file-uploader-widget-view", never, {}, {}, never, never, true, never>;
+}
+
+declare const AXPFileUploaderWidget: AXPWidgetConfig;
+interface AXPFileUploaderWidgetDesignerOptions {
+    multiple?: boolean;
+    accept?: string;
+    plugins?: {
+        name: string;
+        options?: unknown;
+    }[];
+    excludePlugins?: string[];
+    readonly?: boolean;
+    fileEditable?: boolean;
+    maxFileSize?: number;
+    enableTitleDescription?: boolean;
+    showEditDialogAfterSelect?: boolean;
+    showBorder?: boolean;
+    showAddItemButton?: boolean;
+}
+interface AXPFileUploaderWidgetViewOptions {
+}
+interface AXPFileUploaderWidgetEditOptions {
+    multiple?: boolean;
+    accept?: string;
+    plugins?: {
+        name: string;
+        options?: unknown;
+    }[];
+    excludePlugins?: string[];
+    readonly?: boolean;
+    fileEditable?: boolean;
+    maxFileSize?: number;
+    enableTitleDescription?: boolean;
+    showEditDialogAfterSelect?: boolean;
+    showBorder?: boolean;
+    showAddItemButton?: boolean;
+}
+interface AXPFileUploaderWidgetColumnOptions {
+}
+interface AXPFileUploaderWidgetPrintOptions {
+}
+interface AXPFileUploaderWidgetOptions {
+    designer: AXPFileUploaderWidgetDesignerOptions;
+    view: AXPFileUploaderWidgetViewOptions;
+    edit: AXPFileUploaderWidgetEditOptions;
+    print: AXPFileUploaderWidgetPrintOptions;
+    column: AXPFileUploaderWidgetColumnOptions;
+}
+declare module '@acorex/platform/layout/widget-core' {
+    interface AXPWidgetTypesMap {
+        attachments: 'attachments';
+    }
+}
+
+interface AXPFileUploaderShowFileListEntityContext extends AXPFileUploaderEntityFilesScope {
+}
+interface AXPFileUploaderShowFileListOptions {
+    /** When set, files are loaded and saved via FileUploader:LoadFiles / FileUploader:SaveFiles. */
+    entity?: AXPFileUploaderShowFileListEntityContext;
+    /** Direct files (e.g. grid column preview); skips load/save commands. */
+    files?: AXPFileListItem[];
+    readonly?: boolean;
+    multiple?: boolean;
+    accept?: string;
+    fileEditable?: boolean;
+    maxFileSize?: number;
+    showAddItemButton?: boolean;
+    plugins?: {
+        name: string;
+        options?: unknown;
+    }[];
+    editDialog?: AXPFileUploaderEditDialogOptions;
+}
+declare class AXPFileUploaderWidgetService {
+    private popupService;
+    private translate;
+    private commandExecutor;
+    private queryExecutor;
+    showFileList(options?: AXPFileUploaderShowFileListOptions): Promise<AXPFileListItem[] | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPFileUploaderWidgetService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPFileUploaderWidgetService>;
+}
+
 declare const AXPEntityDefinitionProviderWidget: AXPWidgetConfig;
 declare module '@acorex/platform/layout/widget-core' {
     interface AXPWidgetTypesMap {
@@ -2802,6 +3342,18 @@ interface AXPLookupDisplayOptions {
     textField?: string;
     isMultiLanguage?: (value: unknown) => boolean;
 }
+/** Column list: entity detail popover when clicking a lookup value. */
+interface AXPLookupPopoverOptions {
+    /** When `false`, lookup values are not clickable and the detail popover does not open. Default `true`. */
+    enabled?: boolean;
+}
+/** Row actions to show in the lookup data selector popup (subset of entity list actions). */
+interface AXPLookupSelectorRowActionsConfig {
+    /** Primary icon buttons (e.g. preview). Match full command name or suffix such as `:Preview`. */
+    primary?: string[];
+    /** Secondary actions in the row dropdown menu. */
+    secondary?: string[];
+}
 interface AXPLookupWidgetOptions {
     disabled?: boolean | AXPExpression;
     readonly?: boolean | AXPExpression;
@@ -2810,8 +3362,12 @@ interface AXPLookupWidgetOptions {
     look?: AXPLookupWidgetLookType;
     allowClear?: boolean;
     displayFormat?: string;
+    /** Column list: entity detail popover behavior. */
+    popover?: AXPLookupPopoverOptions;
     /** Column list: lazy resolve and summary behavior. */
     columnResolve?: AXPLookupColumnResolveOptions;
+    /** Lookup selector popup: entity row actions to display. */
+    selectorRowActions?: AXPLookupSelectorRowActionsConfig;
 }
 
 /**
@@ -2860,10 +3416,101 @@ declare class AXPLookupWidgetViewComponent extends AXPValueWidgetComponent<any>
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetViewComponent, "axp-lookup-widget-view", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Selects which entity list row actions appear in the data selector.
+ * Match by full command name, action `name`, trigger name, or command suffix (e.g. `:Preview`).
+ */
+interface AXPEntityDataSelectorRowActionsConfig {
+    primary?: string[];
+    secondary?: string[];
+}
+declare class AXPEntityDataSelectorRowActionsService {
+    private readonly expressionEvaluator;
+    private readonly workflow;
+    private readonly commandService;
+    /**
+     * Build a row-actions handler for {@link AXPDataSelectorComponent} from entity list actions.
+     */
+    createHandler(entity: AXPEntity, config: AXPEntityDataSelectorRowActionsConfig): AXPDataSelectorRowActionsHandler | undefined;
+    private buildIndividualActions;
+    private filterActions;
+    private matchesActionFilter;
+    private getCommandNameFromTrigger;
+    private flattenActions;
+    private toRowCommandItems;
+    private evaluateActionsForRow;
+    private createExpressionScope;
+    private resolveTriggerName;
+    private resolveCommandNameExpression;
+    private resolveTitleExpression;
+    private executeCommand;
+    private evaluateActionOptions;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDataSelectorRowActionsService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDataSelectorRowActionsService>;
+}
+
+interface AXPEntityDataSelectorSelectionOptions {
+    multiple?: boolean;
+    selectedItemIds?: string[] | number[];
+    /** Allow confirming with no selection (clears the lookup value). Default: true. */
+    allowUnselect?: boolean;
+}
+interface AXPEntityDataSelectorGridOptions {
+    columns?: string[];
+    pageSize?: number;
+}
+interface AXPEntityDataSelectorFilterOptions {
+    value?: AXDataSourceFilterOption | null;
+    parent?: AXDataSourceFilterOption | null;
+}
+interface AXPEntityDataSelectorSearchOptions {
+    fields?: string[];
+    initial?: string;
+}
+interface AXPEntityDataSelectorSortOptions {
+    fields?: {
+        name: string;
+        dir: 'asc' | 'desc';
+    }[];
+}
+interface AXPEntityDataSelectorCategoryFilterOptions {
+    field: string;
+    operator?: 'equal' | 'contains' | 'in';
+}
+interface AXPEntityDataSelectorCategoryOptions {
+    /** When false, category sidebar is hidden. Default: true (auto-detect from entity plugin). */
+    enabled?: boolean;
+    title?: string;
+    width?: string;
+    filter?: AXPEntityDataSelectorCategoryFilterOptions;
+    dataSource?: AXPCategoryTreeDataSource;
+}
+interface AXPEntityDataSelectorCreateOptions {
+    mode?: AXPDataSelectorAllowCreate;
+}
+/** Nested options for {@link AXPEntityDataSelectorService.open}. */
+interface AXPEntityDataSelectorOpenOptions {
+    entity: AXPEntity;
+    title: string;
+    selection?: AXPEntityDataSelectorSelectionOptions;
+    grid?: AXPEntityDataSelectorGridOptions;
+    filter?: AXPEntityDataSelectorFilterOptions;
+    search?: AXPEntityDataSelectorSearchOptions;
+    sort?: AXPEntityDataSelectorSortOptions;
+    category?: AXPEntityDataSelectorCategoryOptions;
+    create?: AXPEntityDataSelectorCreateOptions;
+    /** Entity list row actions to expose in the selector grid (matched by command name). */
+    rowActions?: AXPEntityDataSelectorRowActionsConfig;
+}
+/**
+ * @deprecated Use {@link AXPEntityDataSelectorOpenOptions}. Will be removed in a future release.
+ */
 interface AXPEntityDataSelectorOptions {
     entity: AXPEntity;
     title: string;
     allowMultiple?: boolean;
+    /** Allow confirming with no selection (clears the lookup value). Default: true. */
+    allowUnselect?: boolean;
     filters?: AXDataSourceFilterOption | null;
     parentFilters?: AXDataSourceFilterOption | null;
     columns?: string[];
@@ -2883,20 +3530,39 @@ interface AXPEntityDataSelectorOptions {
         width?: string;
     };
     showCategoryFilter?: boolean;
+    rowActions?: AXPEntityDataSelectorRowActionsConfig;
 }
+type AXPEntityDataSelectorOpenInput = AXPEntityDataSelectorOpenOptions | AXPEntityDataSelectorOptions;
 interface AXPEntityDataSelectorResult {
     items: any[];
 }
+/**
+ * Returns true when flat (legacy) option fields are present on the input object.
+ */
+declare function isLegacyEntityDataSelectorOptions(options: AXPEntityDataSelectorOpenInput): options is AXPEntityDataSelectorOptions;
+/**
+ * Maps deprecated flat options to {@link AXPEntityDataSelectorOpenOptions}.
+ */
+declare function mapLegacyEntityDataSelectorOptions(legacy: AXPEntityDataSelectorOptions): AXPEntityDataSelectorOpenOptions;
+/**
+ * Normalizes legacy flat or nested options to {@link AXPEntityDataSelectorOpenOptions}.
+ * When both shapes are mixed, nested groups take precedence over mapped legacy values.
+ */
+declare function normalizeEntityDataSelectorOptions(options: AXPEntityDataSelectorOpenInput): AXPEntityDataSelectorOpenOptions;
 declare class AXPEntityDataSelectorService {
     private readonly dataSelectorService;
     private readonly filterOperatorMiddleware;
     private readonly widgetResolver;
     private readonly entityResolver;
     private readonly commandService;
+    private readonly categoryTreeService;
+    private readonly translationService;
+    private readonly rowActionsService;
     /**
-     * Open entity data selector popup
+     * Open entity data selector popup.
+     * Accepts nested {@link AXPEntityDataSelectorOpenOptions} or deprecated flat {@link AXPEntityDataSelectorOptions}.
      */
-    open(options: AXPEntityDataSelectorOptions): Promise<AXPEntityDataSelectorResult | null>;
+    open(options: AXPEntityDataSelectorOpenInput): Promise<AXPEntityDataSelectorResult | null>;
     /**
      * Execute Entity:Create and return created item.
      * Used by lookup widget and data selector for inline create.
@@ -2907,6 +3573,10 @@ declare class AXPEntityDataSelectorService {
      * Call this when receiving items from any source (create, API, selector).
      */
     normalizeItemContactArrays(item: any): any;
+    /**
+     * Apply category sidebar config from normalized options or entity plugin auto-detection.
+     */
+    private applyCategoryFilter;
     /**
      * Create data selector configuration from entity options
      */
@@ -2938,9 +3608,26 @@ declare class AXPEntityDataSelectorService {
      */
     private normalizeContactArrays;
     /**
-     * Create category tree data source from category entity key
+     * Create category tree data source from category entity key.
+     * Uses the same {@link AXPCategoryTreeService} as the entity master list category sidebar.
      */
     private createCategoryTreeDataSource;
+    /**
+     * Build category tree data source callbacks backed by shared category tree service.
+     */
+    private buildCategoryTreeDataSource;
+    /**
+     * Map a category entity row to {@link AXPCategoryEntity} for the reusable category tree component.
+     */
+    private mapCategoryItemToEntity;
+    /**
+     * Map a lazy-loaded tree node to {@link AXPCategoryEntity}.
+     */
+    private mapCategoryTreeNodeToEntity;
+    /**
+     * Resolve category display text, including multi-language titles.
+     */
+    private resolveCategoryText;
     /**
      * Merge custom and parent filters into data source query
      */
@@ -2985,9 +3672,11 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected placeholder: _angular_core.Signal<string>;
     protected filterMode: _angular_core.Signal<boolean>;
     protected multiple: _angular_core.Signal<boolean>;
+    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 selectorRowActions: _angular_core.Signal<AXPLookupSelectorRowActionsConfig | undefined>;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected conditions?: AXPQueryFilter[];
@@ -3048,6 +3737,7 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     protected columnResolve: _angular_core.Signal<AXPLookupColumnResolveOptions | undefined>;
     protected resolveStrategy: _angular_core.Signal<AXPLookupColumnResolveStrategy>;
     protected isHydratedStrategy: _angular_core.Signal<boolean>;
+    protected detailPopoverEnabled: _angular_core.Signal<boolean>;
     protected isMorePopoverOpen: _angular_core.WritableSignal<boolean>;
     protected selectedItemIndex: _angular_core.WritableSignal<number>;
     protected resolvedPopoverItems: _angular_core.WritableSignal<any[]>;
@@ -3745,5 +4435,5 @@ declare class AXPShowListViewAction extends AXPWorkflowAction {
 }
 declare const AXPShowListViewWorkflow: AXPWorkflow;
 
-export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPCreateEntityCommand, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntitiesListDataSourceDefinition, AXPEntityApplyUpdatesAction, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorService, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityEventsKeys, AXPEntityFormBuilderService, AXPEntityListPersistenceModeDefault, AXPEntityListTableService, AXPEntityListToolbarService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityPreloadFiltersContainerComponent, AXPEntityPreloadFiltersViewModel, AXPEntityPreloadFiltersViewModelResolver, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, 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, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, buildAXPRecordWorkflowInfo, canPersistEntityListState, cloneLayoutArrays, collectEntityQuickSearchFieldPaths, collectNestedCreateHiddenProperties, collectNestedFieldPathsFromEntityColumns, collectQuickSearchPathsFromSingleEntityDefinition, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, computeEntityAggregates, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, 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, formatLookupItemDisplay, getDataSourcePageIndex, getEntityListRowId, getMasterInterfacePropertySortKey, getRecordWorkflowCorrelationId, getRecordWorkflowInstanceId, isAXPMiddlewareAbortError, isCategoryEntity, isCategoryFilter, isUnresolvedLookupDisplayTemplate, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mergeForeignKeyFieldIntoCreateActions, normalizeEntityListPersistenceMode, normalizeListPaging, normalizeLookupDisplayTemplate, provideEntity, resolveEntityPluginDetailPageOrder, resolveLookupDisplayField, resolveLookupDisplayTemplate, restoreEntityListExpandedRows, runEntityQuery, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider, shouldLoadEntityListStateFromStorage, shouldResetEntityListStateOnRouteEntry };
-export type { AXPAuditEvent, AXPCollectEntityQuickSearchPathsResolver, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityAggregateMeasure, AXPEntityAggregateOptions, AXPEntityAggregateReducerType, AXPEntityAggregateRequest, AXPEntityAggregateResult, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListExpandRowRef, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListPagingState, AXPEntityListPersistenceMode, AXPEntityListToolbarConvertOptions, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityQueryAllOptions, AXPEntityQueryAllResult, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupDisplayOptions, AXPLookupWidgetLookType, AXPLookupWidgetOptions, 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, 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, collectNestedCreateHiddenProperties, collectNestedFieldPathsFromEntityColumns, collectQuickSearchPathsFromSingleEntityDefinition, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, 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, isUnresolvedLookupDisplayTemplate, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mapLegacyEntityDataSelectorOptions, mergeForeignKeyFieldIntoCreateActions, normalizeEntityDataSelectorOptions, normalizeEntityFieldToFileList, normalizeEntityListPersistenceMode, normalizeListPaging, normalizeLookupDisplayTemplate, 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, 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, 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 };