@acorex/platform 21.0.0-next.37 → 21.0.0-next.40

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

@@ -3,12 +3,12 @@ import * as _angular_core from '@angular/core';
 import { EventEmitter, OnChanges, OnDestroy, WritableSignal, NgZone, ComponentRef, SimpleChanges } from '@angular/core';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXTabStripChangedEvent } from '@acorex/components/tabs';
-import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
-import { AXPWidgetConfig, AXPWidgetCategory, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent } from '@acorex/platform/layout/widget-core';
+import { AXPMultiLanguageString, AXPDefinitionCategory, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXPWidgetItemData, AXPWidgetItemClickEvent } from '@acorex/platform/layout/components';
+import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
+import { AXPWidgetConfig, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent } from '@acorex/platform/layout/widget-core';
 import { AXMenuItem } from '@acorex/components/menu';
 import { Subject } from 'rxjs';
-import { AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import { AXPClipBoardService, AXPSettingsService } from '@acorex/platform/common';
 
@@ -72,53 +72,93 @@ declare class AXPDesignerGridDrawerComponent {
 interface AXPDisplayWidgetConfig extends AXPWidgetConfig {
     pinned: boolean;
 }
+interface AXPWidgetPickerSection {
+    trackKey: string;
+    title: AXPMultiLanguageString | null;
+    widgetItems: AXPWidgetItemData[];
+}
 declare class AXPDesignerWidgetPickerComponent extends AXBasePageComponent {
+    private readonly injector;
     private settingsService;
     private readonly mlResolver;
     private readonly pinnedSettingKey;
+    /** Keeps the line indicator in sync when the selected index is set programmatically (e.g. restored tab). */
+    private readonly tabsHost;
+    constructor();
     protected readonly i18n: {
         readonly searchPlaceholder: "@form-template-management:designer.components.widget-picker.search-placeholder";
         readonly selectedCount: "@form-template-management:designer.components.widget-picker.selected-count";
         readonly tabAll: "@form-template-management:designer.components.widget-picker.tab-all";
+        readonly pinnedSectionTitle: "@form-template-management:designer.components.widget-picker.pinned-section-title";
     };
     protected searchTerm: _angular_core.ModelSignal<string>;
+    /** Populated by popup `data.tabPersistenceContext` (optional for tests). */
+    tabPersistenceContext?: string;
     private widgets;
     private allWidgets;
     private pinnedWidgets;
-    private displayWidgets;
     protected selectedWidgets: _angular_core.WritableSignal<AXPDisplayWidgetConfig[]>;
+    protected currentTabIndex: _angular_core.WritableSignal<number>;
+    /** Avoid persisting spurious tab events before restore + first paint complete. */
+    private allowTabPersistence;
+    private displayWidgets;
     private orderedList;
     protected pinnedList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected regularList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected pinnedWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected regularWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected categories: _angular_core.Signal<AXPWidgetCategory[]>;
-    protected tabs: _angular_core.Signal<AXPWidgetCategory[]>;
+    protected regularGroupedSections: _angular_core.Signal<AXPWidgetPickerSection[]>;
+    protected categories: _angular_core.Signal<AXPDefinitionCategory[]>;
+    protected tabs: _angular_core.Signal<AXPDefinitionCategory[]>;
     protected maxVisibleWidgets: _angular_core.Signal<number>;
-    protected currentTabIndex: _angular_core.WritableSignal<number>;
-    protected selectedTab: _angular_core.Signal<AXPWidgetCategory>;
+    protected selectedTab: _angular_core.Signal<AXPDefinitionCategory>;
+    protected pickerShellClass: _angular_core.Signal<string>;
     protected ngOnInit(): Promise<void>;
-    protected handleTabChange(event: AXTabStripChangedEvent): void;
+    private lastTabSettingKey;
+    private restoreLastTabFromSettings;
+    /**
+     * `ax-tab-item` [active] updates labels, but `ax-tabs` keeps the underline from its own index until `select` runs.
+     */
+    private syncTabsStripToIndex;
+    private persistTabSelection;
+    /**
+     * Picks the primary parent category for the "All" tab (lowest `order` wins).
+     */
+    private primaryCategory;
+    private buildAllTabSections;
+    private buildCategoryTabSections;
+    protected handleTabChange(event: AXTabStripChangedEvent): Promise<void>;
     protected handleWidgetClick(clickEvent: AXPWidgetItemClickEvent): void;
     protected handleWidgetPinClick(clickEvent: AXPWidgetItemClickEvent): Promise<void>;
+    protected handleConfirmSelection(): void;
     protected isWidgetSelected(widget: AXPDisplayWidgetConfig): boolean;
     protected isWidgetItemSelected(widgetItem: AXPWidgetItemData): boolean;
-    protected handleConfirmSelection(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDesignerWidgetPickerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDesignerWidgetPickerComponent, "ng-component", never, { "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
 }
 
+interface AXPWidgetPickerShowOptions {
+    groups: AXPWidgetGroupEnum[];
+    /** User-scoped last tab; unique per picker host (use `AXP_WIDGET_PICKER_TAB_CONTEXT`). */
+    tabPersistenceContext: string;
+}
 declare class AXPWidgetPickerService {
     private popupService;
     private widgetRegistryService;
     private translationService;
-    showPicker(options: {
-        groups: AXPWidgetGroupEnum[];
-    }): Promise<AXPWidgetNode[]>;
+    showPicker(options: AXPWidgetPickerShowOptions): Promise<AXPWidgetNode[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPickerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPickerService>;
 }
 
+/**
+ * Suffixes for `forms:widgets:picker:last-tab:{id}` user settings keys.
+ * Use one id per distinct widget-picker host (different tab strips / widget sets).
+ */
+declare const AXP_WIDGET_PICKER_TAB_CONTEXT: {
+    readonly layoutDesignerFormElements: "layout-designer-form-elements";
+    readonly dashboardHome: "dashboard-home";
+};
+
 type AXPDesignerMode = {
     id: 'designer';
     title: 'Designer';
@@ -424,5 +464,5 @@ declare class AXPLayoutDesignerPreviewComponent extends AXBasePageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDesignerPreviewComponent, "axp-layout-preview", never, {}, {}, never, never, true, never>;
 }
 
-export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, cloneWidgetMenu };
-export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig };
+export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, AXP_WIDGET_PICKER_TAB_CONTEXT, cloneWidgetMenu };
+export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig, AXPWidgetPickerShowOptions };

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

@@ -26,6 +26,7 @@ import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXFormatService } from '@acorex/core/format';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
+import * as _acorex_core_translation from '@acorex/core/translation';
 import { AXPProviderSelectWidgetEditBase, AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widgets';
 
 declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
@@ -83,6 +84,7 @@ declare const axpCreateEntityCommandDefinition: {
         summary: string;
         derivesFrom: string;
     };
+    capabilities: "ai"[];
     ai: {
         shortDescription: string;
         usage: {
@@ -101,6 +103,7 @@ declare const axpCreateEntityCommandDefinition: {
             };
         };
     };
+    categories: _acorex_platform_core.AXPDefinitionCategory[];
 };
 
 declare class AXPUpdateEntityCommand implements AXPCommand<any, any> {
@@ -159,6 +162,15 @@ declare class AXPEntityDetailPopoverComponent {
     protected entityDetails: _angular_core.WritableSignal<any>;
     protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
     protected isDetailPopoverOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * 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.
+     */
+    protected readonly entityPropertiesWithWidgets: _angular_core.Signal<{
+        name: string;
+        title: string;
+        node: AXPWidgetNode;
+    }[]>;
     /**
      * Show the entity detail popover
      */
@@ -184,11 +196,7 @@ declare class AXPEntityDetailPopoverComponent {
      * Name priority MUST come before widget-type priority.
      */
     private getNameImportanceScore;
-    protected getEntityPropertiesWithWidgets(): Array<{
-        name: string;
-        title: string;
-        node: AXPWidgetNode;
-    }>;
+    private buildEntityPropertiesWithWidgets;
     /**
      * Resolves the data path for a property. For lookups with expose, returns the expanded path
      * when data has it (e.g. personTitle). Otherwise returns property name (e.g. personTitleId).
@@ -471,6 +479,10 @@ declare class AXPEntityMasterListViewModel {
     }>;
     views: _angular_core.Signal<AXPEntityMasterListViewQueryViewModel[]>;
     view: _angular_core.WritableSignal<AXPEntityMasterListViewQueryViewModel>;
+    private createExpressionScope;
+    private resolveCommandNameExpression;
+    private resolveTitleExpression;
+    private resolveTriggerName;
     setView(viewName?: string | null): Promise<void>;
     dataSource: AXDataSource<any>;
     constructor(injector: Injector, config: AXPEntity);
@@ -558,6 +570,11 @@ declare class AXPEntityMasterListViewModel {
      * pre-fills categoryIds and categories for the create form.
      */
     private mergeDefaultCategoryForCreate;
+    /**
+     * Seeds create payloads with fixed list-view conditions (e.g. scope=T on the tenant dashboards view)
+     * so new rows match the view context and downstream queries (such as home dashboard) can find them.
+     */
+    private mergeViewConditionsForCreate;
     private evaluateExpressions;
     execute(command: AXPExecuteCommand): Promise<void>;
     destroy(): void;
@@ -729,6 +746,15 @@ declare const AXPEntityPreloadFiltersViewModelResolver: ResolveFn<Promise<AXPEnt
 
 interface AXPEntityModifierContext {
     readonly entity: AXPEntity;
+    plugins: {
+        list(): NonNullable<AXPEntity['plugins']>;
+        add(...items: NonNullable<AXPEntity['plugins']>): AXPEntityModifierContext;
+        remove(predicate: (p: NonNullable<AXPEntity['plugins']>[number]) => boolean): AXPEntityModifierContext;
+        find(name: string): {
+            get(): NonNullable<AXPEntity['plugins']>[number] | undefined;
+            update(updater: (p: NonNullable<AXPEntity['plugins']>[number]) => NonNullable<AXPEntity['plugins']>[number]): AXPEntityModifierContext;
+        };
+    };
     title: {
         get(): string;
         set(newTitle: string): AXPEntityModifierContext;
@@ -954,28 +980,71 @@ declare class AXPEntityDefinitionRegistryService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
 }
 
+/**
+ * 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;
 }
+/**
+ * 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`, and `ownershipInfo` when the backend sends them.
+ */
 interface AXPEntityModel<Id> {
     id: Id;
     auditInfo?: AXPRecordAuditInfo;
@@ -1148,6 +1217,14 @@ declare function resolveEntityPluginDetailPageOrder(input: {
     }>;
 }, slot: EntityDetailPluginPageSlot, options: ResolveEntityPluginDetailPageOrderOptions): number;
 
+/**
+ * Sort key for entries in `interfaces.master.{create|update|single}.properties`.
+ * Uses `layout.order` when set and finite; otherwise the property index in that list.
+ */
+declare function getMasterInterfacePropertySortKey(interfaceRow: {
+    layout?: AXPEntityPropertyLayoutConfig | undefined;
+} | undefined, indexInMasterInterfaceList: number): number;
+
 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>;
@@ -1340,41 +1417,37 @@ declare const createColumnOrderingMiddlewareProvider: (columnOrder?: Record<stri
 declare const columnOrderingMiddlewareProvider: AXPEntityModifierProvider;
 
 /**
- * Configuration for section ordering
+ * Default colSpans for two properties in one section (`md` / `lg`).
+ * Missing `positions[*].colSpan` are filled only; entities keep full control.
  */
+interface PairSpanRule {
+    first: string;
+    second: string;
+    /** Col span applied to {@link first} */
+    firstSpan: number;
+    /** Col span applied to {@link second} */
+    secondSpan: number;
+    breakpoints?: readonly ('sm' | 'md' | 'lg')[];
+}
 interface SectionOrderConfig {
-    /**
-     * Default order for common sections
-     * Lower numbers appear first
-     */
     sections: Record<string, number>;
+    properties: Record<string, number>;
     /**
-     * Default order for properties within sections
-     * Key format: 'sectionId.propertyName' or just 'propertyName' for any section
+     * Defaults for pairing two columns (e.g. code + title). Replace or extend defaults.
+     * - `undefined`: use {@link DEFAULT_PAIR_SPAN_RULES}
+     * - `false`: do not apply any pair spans
+     * - `[...]` + spread `DEFAULT_PAIR_SPAN_RULES` when you want to append custom pairs
      */
-    properties: Record<string, number>;
+    pairSpanRules?: PairSpanRule[] | false;
 }
 /**
- * Default order for common sections
+ * Default shipped rules: narrow identifier + wider title on `md` / `lg`.
  */
+declare const DEFAULT_PAIR_SPAN_RULES: readonly PairSpanRule[];
 declare const DEFAULT_SECTION_ORDER: Record<string, number>;
-/**
- * Default order for common properties
- * Format: 'sectionId.propertyName' for section-specific or 'propertyName' for any section
- */
 declare const DEFAULT_PROPERTY_ORDER: Record<string, number>;
-/**
- * Factory to create a layout ordering middleware
- */
 declare const layoutOrderingMiddlewareFactory: (config: SectionOrderConfig) => AXPEntityModifier;
-/**
- * Helper to create a provider for the layout ordering middleware
- * By default it applies to all entities using the '*' pattern
- */
 declare const createLayoutOrderingMiddlewareProvider: (config?: Partial<SectionOrderConfig>, entityName?: string | RegExp) => AXPEntityModifierProvider;
-/**
- * Default provider registered with the default configuration
- */
 declare const layoutOrderingMiddlewareProvider: AXPEntityModifierProvider;
 
 /**
@@ -1713,7 +1786,6 @@ declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent
     /** i18n key for the synthetic "all items" root row; resolved in the template with the translate pipe. */
     protected readonly categoryTreeRootTitleI18nKey = "@general:terms.interface.selection.all-items";
     private readonly translationService;
-    private readonly mlsResolver;
     protected readonly highlightService: AXHighlightService;
     private readonly changeDetectorRef;
     entityKey: _angular_core.WritableSignal<string>;
@@ -2096,7 +2168,7 @@ declare const AXPEntityCategoryWidget: AXPWidgetConfig;
 declare class AXPTruncatedBreadcrumbComponent implements OnDestroy {
     private readonly mlsResolver;
     /** Plain string or locale map per segment; truncation uses resolved text (see {@link resolvedSectionTexts}). */
-    sections: _angular_core.InputSignal<readonly (AXPMultiLanguageString | null | undefined)[]>;
+    sections: _angular_core.InputSignal<readonly (_acorex_core_translation.AXMultiLanguageString | null | undefined)[]>;
     characterLimit: _angular_core.InputSignal<number | "auto">;
     sectionLimit: _angular_core.InputSignal<number | "auto">;
     separatorIcon: _angular_core.InputSignal<string>;
@@ -2217,6 +2289,11 @@ declare class AXPEntityListTableService {
      * Handle execution of a row command (shared by double-click and command handlers)
      */
     private handleRowCommand;
+    /**
+     * When a related entity list declares `excludeProperties`, row commands bypass the details page
+     * `execute()` merge — apply the same exclusions for embedded create/update commands.
+     */
+    private mergeRelatedListFormOptions;
     /**
      * Create default events
      */
@@ -2358,9 +2435,6 @@ declare class AXPLookupWidgetViewComponent extends AXPValueWidgetComponent<any>
     private efEntity;
     private efDisplay;
     private extractItem;
-    /**
-     * Raw label for {@link AXPResolveMultiLanguageStringPipe} (handles {@link AXPMultiLanguageString} and plain strings).
-     */
     private getDisplayRaw;
     private get __class();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetViewComponent, never>;
@@ -2467,6 +2541,37 @@ declare abstract class LookupWidgetLookBase {
 }
 
 type AXPLookupWidgetLookType = 'select' | 'lookup';
+/**
+ * How the lookup column resolves related items for display in entity lists.
+ * - `hydrated`: titles (and optional ids) are already on the row; inline preview + overflow popover use row data only.
+ * - `idsWithCount`: ids and optional count live on the row; the cell shows a count summary and loads titles via entity `byKey` when the popover opens.
+ * - `countOnly`: only a count is on the row; the popover loads ids/titles via a registered `AXPQuery` when opened.
+ */
+type AXPLookupColumnResolveStrategy = 'hydrated' | 'idsWithCount' | 'countOnly';
+/**
+ * Column list only: controls how the lookup column loads and displays related items in grids.
+ * Omitted or empty strategy defaults to `hydrated` at runtime.
+ */
+interface AXPLookupColumnResolveOptions {
+    /** Default `hydrated` when omitted. */
+    strategy?: AXPLookupColumnResolveStrategy;
+    /** Lodash-style path on `rowData` for the displayed count (e.g. `rolesCount`). */
+    countFieldPath?: string;
+    /** Lodash-style path on `rowData` for the related id list (`idsWithCount`). If omitted, the column `rawValue` is used. */
+    idsPath?: string;
+    /** Registered query key for `AXPQueryExecutor.fetch` when using `countOnly`. */
+    queryKey?: string;
+    /**
+     * Maps query input property names to lodash-style paths on `rowData` (e.g. `{ "userId": "id" }`).
+     * May be a JSON string when set from the layout designer text field.
+     */
+    queryParams?: Record<string, string> | string;
+    /**
+     * Dot path into the named query result for the items array. Defaults to `items` when the result is an object.
+     * If the query returns an array directly, leave unset and handle at runtime.
+     */
+    queryResultItemsPath?: string;
+}
 interface AXPLookupWidgetOptions {
     disabled?: boolean | AXPExpression;
     readonly?: boolean | AXPExpression;
@@ -2475,6 +2580,8 @@ interface AXPLookupWidgetOptions {
     look?: AXPLookupWidgetLookType;
     allowClear?: boolean;
     displayFormat?: string;
+    /** Column list: lazy resolve and summary behavior. */
+    columnResolve?: AXPLookupColumnResolveOptions;
 }
 
 declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any> {
@@ -2492,6 +2599,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected textField: _angular_core.Signal<string>;
     protected hasClearButton: _angular_core.Signal<boolean>;
     protected customFilter: _angular_core.Signal<AXDataSourceFilterOption>;
+    protected placeholder: _angular_core.Signal<string>;
     protected filterMode: _angular_core.Signal<boolean>;
     protected multiple: _angular_core.Signal<boolean>;
     protected look: _angular_core.Signal<AXPLookupWidgetLookType>;
@@ -2529,9 +2637,12 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
 
 declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<any> {
     private readonly entityDetailPopoverService;
-    private readonly mlResolver;
+    private readonly translation;
     private readonly formatService;
+    private readonly entityService;
+    private readonly queryExecutor;
     protected moreButton: _angular_core.Signal<ElementRef<any> | undefined>;
+    protected lazyTrigger: _angular_core.Signal<ElementRef<any> | undefined>;
     protected morePopover: _angular_core.Signal<AXPopoverComponent | undefined>;
     protected host: ElementRef<any>;
     protected valueField: string;
@@ -2541,21 +2652,50 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     protected maxVisible: number;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected displayField: _angular_core.Signal<string>;
+    protected columnResolve: _angular_core.Signal<AXPLookupColumnResolveOptions | undefined>;
+    protected resolveStrategy: _angular_core.Signal<AXPLookupColumnResolveStrategy>;
+    protected isHydratedStrategy: _angular_core.Signal<boolean>;
     protected isMorePopoverOpen: _angular_core.WritableSignal<boolean>;
     protected selectedItemIndex: _angular_core.WritableSignal<number>;
+    protected resolvedPopoverItems: _angular_core.WritableSignal<any[]>;
+    protected resolveStatus: _angular_core.WritableSignal<"error" | "idle" | "loading" | "ready">;
+    protected resolveError: _angular_core.WritableSignal<string | null>;
+    protected summaryLabel: _angular_core.WritableSignal<string>;
+    protected popoverHeader: _angular_core.WritableSignal<string>;
     protected displayItems: _angular_core.Signal<any[]>;
     protected allItems: _angular_core.Signal<any[]>;
     protected visibleItems: _angular_core.Signal<any[]>;
     protected hasMoreItems: _angular_core.Signal<boolean>;
-    protected remainingItemsCount: _angular_core.Signal<number>;
+    protected idsFromRow: _angular_core.Signal<any[]>;
+    protected displayCount: _angular_core.Signal<number>;
+    protected popoverListItems: _angular_core.Signal<any[]>;
+    /** Avoid resetting lazy cache on every CD when `rowData` is a new object reference for the same row. */
+    private previousLazyRowId;
+    constructor();
     protected showMoreItems(): void;
-    protected onMorePopoverOpenChange(event: any): void;
+    protected openLazyPopover(): void;
+    protected onPopoverOpenChange(event: unknown): void;
     protected showItemDetail(item: any, index: number): Promise<void>;
     protected handleItemClick(index: number): void;
-    private openMorePopover;
+    protected handleResolvedItemClick(index: number): void;
+    protected handlePopoverItemClick(index: number): void;
+    protected getDisplayRaw(item: any): string;
+    private refreshSummaryLabel;
+    private refreshPopoverHeader;
+    private resetLazyState;
+    private openPopoverFromRef;
     private closeMorePopover;
+    private ensureLazyItemsLoaded;
+    /**
+     * ax-popover may emit a boolean, CustomEvent with detail, or a DOM Event depending on version.
+     */
+    private coercePopoverOpenEvent;
+    private loadByIds;
+    private loadByNamedQuery;
+    private buildNamedQueryInput;
+    private parseQueryParamsMap;
+    private extractItemsFromQueryResult;
     private extractItem;
-    protected getDisplayRaw(item: any): string;
     private resolveDisplayValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetColumnComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetColumnComponent, "ng-component", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
@@ -3186,5 +3326,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, 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, DEFAULT_COLUMN_ORDER, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, provideEntity, resolveEntityPluginDetailPageOrder, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider };
-export type { AXPAuditEvent, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListToolbarConvertOptions, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, ResolveEntityPluginDetailPageOrderOptions, SectionOrderConfig, SkipEntityComponentPageRef };
+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, 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, DEFAULT_COLUMN_ORDER, DEFAULT_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, getMasterInterfacePropertySortKey, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, provideEntity, resolveEntityPluginDetailPageOrder, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider };
+export type { AXPAuditEvent, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListToolbarConvertOptions, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, SectionOrderConfig, SkipEntityComponentPageRef };