@acorex/platform 20.8.8 → 20.8.10

package/{layout/entity/index.d.ts → types/acorex-platform-layout-entity.d.ts}

@@ -1,31 +1,33 @@
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPExecuteCommandResult, AXPMetaData, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPUserReference, AXPQueryRequest, AXPPagedListResult, AXPCategoryEntity as AXPCategoryEntity$1, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem } 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 { AXPCommand, AXPQueryExecutor, AXPCommandService, AXPQuery } from '@acorex/platform/runtime';
 import * as _angular_core from '@angular/core';
-import { ElementRef, InjectionToken, Injector, Type, OnInit, ChangeDetectorRef, OnDestroy } 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, AXPCategoryTreeDataSource } from '@acorex/platform/layout/components';
+import { AXPPreloadFiltersApplyEvent, AXPColumnItemListItem, AXPDataSelectorAllowCreate, AXPCategoryTreeDataSource } from '@acorex/platform/layout/components';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
-import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption, AXValueChangedEvent, AXClickEvent, AXFocusEvent, AXHtmlEvent } from '@acorex/cdk/common';
+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, AXPQueryFilter } 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 * 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 { AXPWorkflowService, AXPWorkflow, AXPWorkflowAction, AXPWorkflowContext } from '@acorex/platform/workflow';
+import * as i4 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';
-import { AXTranslationService } from '@acorex/core/translation';
 import { AXPopupSizeType, AXPopupService } from '@acorex/components/popup';
-import { IActionBuilder, AXPDialogRef, IFormFieldBuilder } from '@acorex/platform/layout/builder';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXFormatService } from '@acorex/core/format';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
-import { AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widgets';
+import * as _acorex_core_translation from '@acorex/core/translation';
+import { AXPProviderSelectWidgetEditBase, AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widgets';
 
 declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
     private entityForm;
@@ -40,6 +42,70 @@ declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPCreateEntityCommand>;
 }
 
+/**
+ * Merged into AI/tool payloads for `Entity:Create` so post-create navigation does not run from agent flows.
+ * Applied in the AI module when normalizing tool arguments (not in the generic command executor).
+ */
+declare const axpCreateEntityAiToolInputDefaults: {
+    readonly __context__: {
+        readonly options: {
+            readonly process: {
+                readonly redirect: false;
+            };
+        };
+    };
+};
+declare const axpCreateEntityCommandDefinition: {
+    key: string;
+    title: string;
+    description: string;
+    executionMode: "frontend";
+    inputs: ({
+        name: string;
+        title: string;
+        description: string;
+        interface: {
+            name: string;
+        };
+        validations?: undefined;
+    } | {
+        name: string;
+        title: string;
+        description: string;
+        interface: {
+            name: string;
+        };
+        validations: {
+            rule: string;
+        }[];
+    })[];
+    outcomes: {
+        mode: "dynamic";
+        summary: string;
+        derivesFrom: string;
+    };
+    capabilities: "ai"[];
+    ai: {
+        shortDescription: string;
+        usage: {
+            whenToUse: string[];
+            avoidWhen: string[];
+            followUpTools: string[];
+        };
+        tags: string[];
+        toolInputDefaults: {
+            __context__: {
+                readonly options: {
+                    readonly process: {
+                        readonly redirect: false;
+                    };
+                };
+            };
+        };
+    };
+    categories: _acorex_platform_core.AXPDefinitionCategory[];
+};
+
 declare class AXPUpdateEntityCommand implements AXPCommand<any, any> {
     private readonly entityForm;
     private readonly settingsService;
@@ -96,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
      */
@@ -121,11 +196,12 @@ 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).
+     */
+    private resolveDataPath;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDetailPopoverComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDetailPopoverComponent, "axp-entity-detail-popover", never, { "entity": { "alias": "entity"; "required": true; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": true; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "item": { "alias": "item"; "required": false; "isSignal": true; }; "breadcrumb": { "alias": "breadcrumb"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -200,7 +276,7 @@ declare class AXPEntitiesListDataSourceDefinition implements AXPDataSourceDefini
 }
 
 declare class AXPEntityCommandTriggerViewModel {
-    priority: 'primary' | 'secondary';
+    priority: 'primary' | 'secondary' | 'none';
     order: number;
     color: AXStyleColorType;
     icon: string;
@@ -214,7 +290,9 @@ declare class AXPEntityCommandTriggerViewModel {
     options: any;
     metadata?: AXPMetaData;
     default?: boolean;
-    constructor(entity: AXPEntity, action: AXPEntityAction);
+    items?: AXPEntityCommandTriggerViewModel[];
+    isChild?: boolean;
+    constructor(entity: AXPEntity, action: AXPEntityAction, isChild?: boolean);
 }
 declare class AXPEntityListViewColumnViewModel {
     readonly property: AXPEntityProperty;
@@ -289,6 +367,49 @@ declare const AXPEntityEventsKeys: {
     REFRESH_DATA: string;
 };
 
+interface AXPEntityListExpandRowRef {
+    data: Record<string, unknown>;
+}
+/**
+ * Resolves a stable row id from entity list row data.
+ */
+declare function getEntityListRowId(data: Record<string, unknown>, key?: string): string;
+/**
+ * Finds row data in a hierarchical grid tree (root rows and nested children).
+ */
+declare function findEntityListRowDataInTree(items: unknown[], id: string, key: string): Record<string, unknown> | null;
+/**
+ * Restores expanded rows after data load (parents before children).
+ */
+declare function restoreEntityListExpandedRows(options: {
+    expandedRowIds: string[];
+    rowKey: string;
+    getDisplayedRows: () => unknown[];
+    expandRow: (row: AXPEntityListExpandRowRef) => Promise<void>;
+}): Promise<void>;
+
+interface AXPEntityListPagingState {
+    take: number;
+    skip: number;
+}
+/**
+ * Applies take/skip to the data source without triggering {@link AXDataSource.load}.
+ */
+declare function applyDataSourcePagingWithoutLoad(dataSource: AXDataSource, paging: AXPEntityListPagingState): void;
+declare function getDataSourcePageIndex(dataSource: AXDataSource): number;
+declare function normalizeListPaging(paging: Partial<AXPEntityListPagingState> | undefined, defaultTake: number): AXPEntityListPagingState;
+
+/** How entity list UI state (columns, filters, paging, etc.) is persisted for the user. */
+type AXPEntityListPersistenceMode = 'none' | 'persistent' | 'route';
+declare const AXPEntityListPersistenceModeDefault: AXPEntityListPersistenceMode;
+declare function normalizeEntityListPersistenceMode(value: unknown): AXPEntityListPersistenceMode;
+declare function canPersistEntityListState(mode: AXPEntityListPersistenceMode): boolean;
+/** `none` never reads list state from user settings. */
+declare function shouldLoadEntityListStateFromStorage(mode: AXPEntityListPersistenceMode): boolean;
+/** `route` clears stored list state when the route entity (module + name) changes. */
+declare function shouldResetEntityListStateOnRouteEntry(mode: AXPEntityListPersistenceMode): boolean;
+declare const ENTITY_LIST_ROUTE_CONTEXT_SESSION_KEY = "axp-entity-list-route-context";
+
 /**
  * Entity Event Dispatcher - A wrapper for entity-specific events
  * Handles pattern-based dispatching for entity operations with wildcard support
@@ -402,6 +523,15 @@ declare class AXPEntityMasterListViewModel {
     private lastAppliedSortKey;
     private lastAppliedFilterKey;
     private hasQueryParamsFilters;
+    /** Persisted expanded row ids for hierarchical lists (per view). */
+    private readonly expandedRowIds;
+    /** When true, row expand/collapse is not written to user settings (restore in progress). */
+    skipExpandedRowPersistence: boolean;
+    /** Resolved take/skip for the current view (null until loaded from settings). */
+    private readonly resolvedListPaging;
+    /** When true, pager changes are not persisted (programmatic UI sync). */
+    skipListPagingPersistence: boolean;
+    private listPersistenceMode;
     events$: Subject<{
         action: string;
         meta?: any;
@@ -422,8 +552,29 @@ declare class AXPEntityMasterListViewModel {
     dataSource: AXDataSource<any>;
     constructor(injector: Injector, config: AXPEntity);
     private syncShowRowIndexColumnSetting;
+    /**
+     * Applies {@link AXPCommonSettings.EntityListPersistenceMode} for this list instance.
+     * Call once when the list view model is created (before loading list UI state).
+     */
+    initializeListPersistence(): Promise<void>;
+    getListPersistenceMode(): Promise<AXPEntityListPersistenceMode>;
+    shouldLoadPersistedListState(): Promise<boolean>;
+    shouldPersistListState(): Promise<boolean>;
+    private clearEntityListSettings;
     applySettings(): Promise<void>;
-    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize' | 'filters' | 'sorts', data?: any): Promise<void>;
+    ensureListPagingResolved(): Promise<void>;
+    getResolvedListPaging(): AXPEntityListPagingState;
+    applyPagingToDataSourceWithoutLoad(): void;
+    saveListPaging(take: number, skip: number): void;
+    resetListPagingSkip(): void;
+    private loadListPagingFromViewSettings;
+    getExpandedRowIds(): string[];
+    /**
+     * Updates persisted expanded row ids when the user expands or collapses a tree row.
+     */
+    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>;
     selectedItems: _angular_core.WritableSignal<any[]>;
     /**
      * Selected category from the category sidebar (left panel).
@@ -451,6 +602,8 @@ declare class AXPEntityMasterListViewModel {
     hasInlineFilters: _angular_core.Signal<boolean>;
     beardcrumbs: _angular_core.Signal<AXPBreadcrumbItem[]>;
     private allActions;
+    /** Flattened actions including children for execute lookup */
+    private flattenedActions;
     getPrimaryActions(): Promise<AXPEntityCommandTriggerViewModel[]>;
     getSecondaryActions(): Promise<AXPEntityCommandTriggerViewModel[]>;
     selectedScopeActionsCount: _angular_core.Signal<number>;
@@ -504,6 +657,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;
@@ -644,6 +802,23 @@ declare class AXPEntityMasterUpdateViewModelFactory {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityMasterUpdateViewModelFactory>;
 }
 
+type AXPCollectEntityQuickSearchPathsResolver = (moduleName: string, entityName: string) => Promise<AXPEntity | null>;
+/**
+ * Lodash-get paths for quick search from a single entity definition: string-like property names
+ * plus lookup `expose[].target` paths (e.g. `brand.title`).
+ */
+declare function collectQuickSearchPathsFromSingleEntityDefinition(entity: AXPEntity | null | undefined): string[];
+/**
+ * Adds dotted paths from master columns (`name` or `options.dataPath`), e.g. `person.fullName`, `jobDefinition.title`.
+ */
+declare function collectNestedFieldPathsFromEntityColumns(entity: AXPEntity | null | undefined): string[];
+/**
+ * Collects lodash-get field paths used for mock/API quick search (`contains` / OR filters):
+ * host properties and lookup expose targets, dotted column paths, and merge-detail related entities
+ * prefixed with the related entity merge `persistence.dataPath` (e.g. `person.firstName`).
+ */
+declare function collectEntityQuickSearchFieldPaths(entity: AXPEntity | null | undefined, resolveRelatedDefinition: AXPCollectEntityQuickSearchPathsResolver): Promise<string[]>;
+
 declare class AXPEntityPreloadFiltersViewModel {
     private injector;
     private config;
@@ -786,6 +961,7 @@ type AXPEntityModifier = (context: AXPEntityModifierContext) => void;
 interface AXPEntityModifierProvider {
     entityName: string | RegExp;
     modifier: AXPEntityModifier;
+    order?: number;
 }
 
 declare function ensureListActions(ctx: AXPEntityModifierContext): void;
@@ -826,8 +1002,10 @@ declare class AXPEntityMiddleware {
     protected providedActionPlugins: AXPEntityActionPlugin[];
     protected injector: Injector;
     constructor();
-    register(entityName: string | RegExp, modifier: AXPEntityModifier): void;
+    register(entityName: string | RegExp, modifier: AXPEntityModifier, order?: number): void;
     process(entity: AXPEntity): Promise<AXPEntity>;
+    private createModifierStep;
+    private createPluginStep;
     private wildcardToRegExp;
     private normalizeRegExp;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMiddleware, never>;
@@ -847,6 +1025,7 @@ interface AXPEntityDefinitionPreloader {
 }
 declare class AXPEntityDefinitionRegistryService {
     private middleware;
+    private columnEnrichment;
     private onChanged;
     get onChanged$(): rxjs.Observable<{
         name: string;
@@ -908,28 +1087,142 @@ declare class AXPEntityDefinitionRegistryService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
 }
 
+type AXPEntityAggregateReducerType = 'count' | 'sum' | 'min' | 'max' | 'avg';
+interface AXPEntityAggregateMeasure {
+    reducer: AXPEntityAggregateReducerType;
+    /** Required for sum, min, max, and avg. Ignored for count (rows per group). */
+    field?: string;
+    /** Result column name; defaults are derived from the reducer and field. */
+    alias?: string;
+}
+/**
+ * Aggregate stored rows after the same filter/sort pipeline as {@link AXPQueryRequest}.
+ * Group keys use dotted field paths (same as lodash-style getters).
+ */
+interface AXPEntityAggregateRequest extends Pick<AXPQueryRequest, 'filter' | 'sort'> {
+    groupBy: string[];
+    measures: AXPEntityAggregateMeasure[];
+}
+interface AXPEntityAggregateResult {
+    rows: Record<string, unknown>[];
+}
+interface AXPEntityQueryAllOptions {
+    /**
+     * Page size for backends that read page-by-page (HTTP API).
+     * In-memory backends load the filtered set once and ignore this.
+     */
+    pageSize?: number;
+    /** Maximum rows to return or scan (safety cap). */
+    maxRows?: number;
+}
+interface AXPEntityQueryAllResult<T> {
+    items: T[];
+    /** Row count matching filter/sort before applying maxRows. */
+    total: number;
+    /** True when maxRows prevented returning every matching row. */
+    truncated: boolean;
+}
+interface AXPEntityAggregateOptions {
+    /** Maximum rows to load for aggregation when the backend pages remotely (default 50_000). */
+    maxRows?: number;
+    /** Page size for remote paging during aggregate (default 500). */
+    pageSize?: number;
+}
+
+/**
+ * Pure aggregation over already-filtered plain rows (e.g. outputs of {@link filterSortEntityRows}).
+ */
+declare function computeEntityAggregates<T extends Record<string, unknown>>(rows: T[], request: AXPEntityAggregateRequest): Record<string, unknown>[];
+
+interface RunEntityQueryAdapters<T = unknown> {
+    getRawAll(entityName: string): Promise<T[]>;
+    getDirectChildCount(categoryId: string, entityName: string): Promise<number>;
+    getAllChildCategoryIds(categoryId: string, entityName: string): Promise<string[]>;
+}
+/**
+ * Check if the entity is a category entity (ends with 'Category').
+ */
+declare function isCategoryEntity(entityName: string): boolean;
+/**
+ * Check if the filter is a category filter (contains operator on categoryIds field).
+ * Handles both simple filters and compound filters.
+ */
+declare function isCategoryFilter(filter: any): boolean;
+/**
+ * Loads raw rows for an entity and applies the same sorting and filtering as {@link runEntityQuery},
+ * without pagination.
+ */
+declare function filterSortEntityRows<T = unknown>(entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>, adapters: RunEntityQueryAdapters<T>): Promise<T[]>;
+/**
+ * Shared entity query logic: sort, filter (including recursive category filter), childrenCount, pagination.
+ */
+declare function runEntityQuery<T = unknown>(entityName: string, request: AXPQueryRequest, adapters: RunEntityQueryAdapters<T>): Promise<AXPPagedListResult<T>>;
+
+/**
+ * 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;
@@ -961,6 +1254,14 @@ declare abstract class AXPEntityStorageService<TKey, TDetailDto extends AXPEntit
     abstract insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
     abstract getAll(entityName: string): Promise<TListItemDto[]>;
     abstract query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
+    abstract count(entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
+    abstract queryAll(entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
+    abstract getMany(entityName: string, ids: TKey[]): Promise<(TListItemDto | null)[]>;
+    abstract exists(entityName: string, id: TKey): Promise<boolean>;
+    abstract upsertOne(entityName: string, entity: TCreateDto, options?: {
+        merge?: boolean;
+    }): Promise<TKey>;
+    abstract aggregate(entityName: string, request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions): Promise<AXPEntityAggregateResult>;
 }
 declare abstract class AXPEntityDataProvider<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> {
     abstract get entityName(): string;
@@ -971,6 +1272,14 @@ declare abstract class AXPEntityDataProvider<TKey, TDetailDto extends AXPEntityD
     abstract deleteOne(id: TKey): Promise<void>;
     abstract insertOne(entity: TCreateDto): Promise<TKey>;
     abstract query(request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
+    abstract count(request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
+    abstract queryAll(request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
+    abstract getMany(ids: TKey[]): Promise<(TListItemDto | null)[]>;
+    abstract exists(id: TKey): Promise<boolean>;
+    abstract upsertOne(entity: TCreateDto, options?: {
+        merge?: boolean;
+    }): Promise<TKey>;
+    abstract aggregate(request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions): Promise<AXPEntityAggregateResult>;
 }
 declare class AXPEntityDataProviderImpl<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> implements AXPEntityDataProvider<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto> {
     private storageService;
@@ -983,6 +1292,14 @@ declare class AXPEntityDataProviderImpl<TKey, TDetailDto extends AXPEntityDetail
     updateOne(id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
     deleteOne(id: TKey): Promise<void>;
     insertOne(entity: TCreateDto): Promise<TKey>;
+    count(request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
+    queryAll(request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
+    getMany(ids: TKey[]): Promise<(TListItemDto | null)[]>;
+    exists(id: TKey): Promise<boolean>;
+    upsertOne(entity: TCreateDto, options?: {
+        merge?: boolean;
+    }): Promise<TKey>;
+    aggregate(request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions): Promise<AXPEntityAggregateResult>;
 }
 declare abstract class AXMEntityCrudService<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> {
     abstract insertOne(request: TCreateDto): Promise<TKey>;
@@ -1015,6 +1332,14 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
     }): Promise<AXPPagedListResult<TListItemDto>>;
     getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity$1<TKey>>>;
     get storageService(): AXPEntityStorageService<any, any, any, any, any>;
+    count(request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
+    queryAll(request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
+    getMany(ids: TKey[]): Promise<(TListItemDto | null)[]>;
+    exists(id: TKey): Promise<boolean>;
+    upsertOne(entity: TCreateDto, options?: {
+        merge?: boolean;
+    }): Promise<TKey>;
+    aggregate(request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions): Promise<AXPEntityAggregateResult>;
     custom<Req, Res>(request: Req): Promise<void>;
 }
 
@@ -1060,9 +1385,59 @@ declare class AXPEntityResolver {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityResolver>;
 }
 
+/**
+ * Built-in entity detail tabs from plugins. Sidebar order (after related page-list / page-detail
+ * tabs): meta-data-builder → attachments → documents → comments → history.
+ */
+type EntityDetailPluginPageSlot = 'meta-data-builder' | 'attachments' | 'documents' | 'comments' | 'history';
+/** Identifies an `entity.pages` entry when skipping its order during recomputation. */
+interface SkipEntityComponentPageRef {
+    componentKey: string;
+    /** When set, only the page with this `field` is skipped (e.g. attachments / meta-data per field). */
+    field?: string;
+}
+interface ResolveEntityPluginDetailPageOrderOptions {
+    /** Component key of the page being added or updated (used to count sibling tabs in the same slot). */
+    componentKey: string;
+    /**
+     * Ignore this page when counting siblings / recomputing (the page currently being updated).
+     */
+    skipPage?: SkipEntityComponentPageRef;
+    /**
+     * Field name for multi-page slots (`attachments`, `meta-data-builder`). Omit for single-tab slots.
+     */
+    field?: string;
+    /** Gap between auto-assigned related tab orders. Default: 10. */
+    relatedOrderStep?: number;
+    /** Minimum start of the plugin zone (after related tabs). Default: 100_000. */
+    pluginZoneFloor?: number;
+}
+/**
+ * Resolves `layout.order` for a built-in plugin detail tab (`entity.pages`).
+ *
+ * 1. Assigns finite `layout.order` values to related `page-list` / `page-detail` rows that omit
+ *    `order` (the composer otherwise treats them as +Infinity).
+ * 2. Places plugin tabs in a fixed relative order: meta-data-builder → attachments → documents →
+ *    comments → history, after all related tabs.
+ */
+declare function resolveEntityPluginDetailPageOrder(input: {
+    relatedEntities?: AXPRelatedEntity[];
+    pages?: Array<AXPEntityPage & {
+        field?: string;
+    }>;
+}, 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], never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<AXPEntityModule, never, [typeof i1.RouterModule, typeof i2.AXPWorkflowModule, typeof i3.AXPWidgetCoreModule, typeof i4.LayoutBuilderModule], never>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXPEntityModule>;
 }
 
@@ -1186,7 +1561,16 @@ interface AXPEntityStorageContext<TKey = any, TDetailDto extends AXPEntityDetail
         getOne: (entityName: string, id: TKey) => Promise<TDetailDto>;
         insertOne: (entityName: string, entity: TCreateDto) => Promise<TKey>;
         query: (entityName: string, request: AXPQueryRequest) => Promise<AXPPagedListResult<TListItemDto>>;
-        updateOne: (entityName: string, id: TKey, data: Partial<TUpdateDto>) => Promise<void>;
+        updateOne: (entityName: string, id: TKey, data: Partial<TUpdateDto>) => Promise<TDetailDto>;
+        deleteOne: (entityName: string, id: TKey) => Promise<void>;
+        count: (entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>) => Promise<number>;
+        queryAll: (entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions) => Promise<AXPEntityQueryAllResult<TListItemDto>>;
+        getMany: (entityName: string, ids: TKey[]) => Promise<(TListItemDto | null)[]>;
+        exists: (entityName: string, id: TKey) => Promise<boolean>;
+        upsertOne: (entityName: string, entity: TCreateDto, options?: {
+            merge?: boolean;
+        }) => Promise<TKey>;
+        aggregate: (entityName: string, request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions) => Promise<AXPEntityAggregateResult>;
     };
 }
 interface AXPEntityStorageMiddleware<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
@@ -1232,41 +1616,57 @@ declare const columnWidthMiddleware: AXPEntityModifier;
 declare const columnWidthMiddlewareProvider: AXPEntityModifierProvider;
 
 /**
- * Configuration for section ordering
+ * Default order for common list view columns.
+ * Lower numbers appear first. Columns not in this map get order 500 (middle).
+ * Use high numbers (990+) for columns that should appear at the end.
+ */
+declare const DEFAULT_COLUMN_ORDER: Record<string, number>;
+/**
+ * Entity modifier that sorts list view columns by default order.
+ * Similar to layout-ordering for sections/properties, but for list columns.
+ */
+declare const columnOrderingMiddleware: AXPEntityModifier;
+/**
+ * Factory to create a column ordering middleware with custom order config
+ */
+declare const createColumnOrderingMiddlewareProvider: (columnOrder?: Record<string, number>, entityName?: string | RegExp) => AXPEntityModifierProvider;
+/**
+ * Default provider that applies column ordering to all entities
+ */
+declare const columnOrderingMiddlewareProvider: AXPEntityModifierProvider;
+
+/**
+ * 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;
 
 /**
@@ -1285,6 +1685,28 @@ declare class AXPLayoutOrderingConfigService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutOrderingConfigService>;
 }
 
+/**
+ * Ensures all entities have a searchResult.description.
+ * Uses @{i18nScope}:module.title when missing (guaranteed to exist in i18n).
+ */
+declare const searchResultDescriptionMiddleware: AXPEntityModifier;
+declare const searchResultDescriptionMiddlewareProvider: AXPEntityModifierProvider;
+
+/**
+ * When enabled in regional settings ({@link AXPRegionalSetting.MultiLanguageSupport}), walks each
+ * property's `schema.interface` widget tree and sets `options.multiLanguage` on matching text-like
+ * editors (including nested GridLayout leaves such as `pre.content` / `post.summaryContent`), unless
+ * the node already specifies `multiLanguage` (including explicit false to opt out).
+ */
+declare const defaultMultiLanguageMiddleware: AXPEntityModifier;
+declare const defaultMultiLanguageMiddlewareProvider: AXPEntityModifierProvider;
+
+/**
+ * Registers entity CRUD commands and queries for the given entity keys.
+ * Use in app/module providers; consumes AXPEntityService from this package.
+ */
+declare function provideEntity(entityKeys: string[]): EnvironmentProviders;
+
 interface AXPGetEntityDetailsQueryInput {
     entity: string;
     id: string;
@@ -1318,9 +1740,14 @@ declare class AXPGetEntityDetailsQuery implements AXPQuery<AXPGetEntityDetailsQu
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPGetEntityDetailsQuery>;
 }
 
+/**
+ * i18n key for the synthetic root node ("all categories"). Resolve in templates with the translate pipe.
+ */
+declare const AXP_CATEGORY_TREE_ROOT_TITLE_I18N_KEY = "@general:terms.interface.selection.all-items";
 interface CategoryQueryEvent {
     skip: number;
     take: number;
+    sort?: AXDataSourceSortOption[];
     filter?: {
         field?: string;
         value?: unknown;
@@ -1350,7 +1777,14 @@ interface CategoryTreeNodeData {
 }
 declare class AXPCategoryTreeService {
     protected readonly entityResolver: AXPEntityDefinitionRegistryService;
-    protected readonly translate: AXTranslationService;
+    private readonly translation;
+    /** Sort field for list queries (backend); matches configured category display field. */
+    private getAlphabeticalSortOptions;
+    /**
+     * Sort tree nodes by resolved display title (locale-aware).
+     * Ensures correct order for multi-language titles when storage order differs from UI order.
+     */
+    private sortTreeNodesByDisplayTitle;
     /**
      * Initialize category tree data source
      */
@@ -1388,6 +1822,48 @@ declare class AXPCategoryTreeService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPCategoryTreeService>;
 }
 
+declare class AXPRelatedColumnEnrichmentService {
+    private readonly metadataResolver;
+    /**
+     * Enriches entity columns with:
+     * 1. dataPath for FK columns (e.g. fromPersonId) derived from lookup property schema
+     * 2. title and showAs from related entity properties for dotted paths (e.g. person.firstName)
+     */
+    enrich(entity: AXPEntity): Promise<AXPEntity>;
+    /**
+     * Derives dataPath for FK columns from lookup property schema.
+     * Uses expose.target where source matches textField (default 'title').
+     */
+    private deriveDataPathForFkColumn;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRelatedColumnEnrichmentService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPRelatedColumnEnrichmentService>;
+}
+
+interface AXPRelatedColumnMetadata {
+    title?: string;
+    showAs?: AXPEntityTableColumn['showAs'];
+}
+declare class AXPRelatedColumnMetadataResolver {
+    private readonly entityLoader;
+    /**
+     * Resolves title and showAs for a column that references a related entity property via dotted path.
+     * Uses relatedEntities when available; falls back to lookup expose when not.
+     */
+    resolve(entity: AXPEntity, columnName: string): Promise<AXPRelatedColumnMetadata | null>;
+    /**
+     * Finds a lookup property whose expose target matches the dotted path.
+     * Returns the lookup's entity string (e.g. 'PersonCore.Person') or null.
+     */
+    private findLookupEntityByExposeTarget;
+    /**
+     * Derives showAs from source property schema.
+     * Passes through the full interface (type, options, children) for column display.
+     */
+    private deriveShowAs;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRelatedColumnMetadataResolver, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPRelatedColumnMetadataResolver>;
+}
+
 interface IEntitySelectorStage {
     /** Select target entity using "module.entity" format */
     entity(fullName: string): IInterfaceSelectorStage;
@@ -1405,6 +1881,8 @@ interface IPropertyFilterStage {
     include(...propertyNames: string[]): IPropertyFilterStage;
     /** Exclude provided property names (by AXPEntityProperty.name). Ignored if include() was already set. */
     exclude(...propertyNames: string[]): IPropertyFilterStage;
+    /** Mark provided property names as readonly. Overrides property schema for display. */
+    readonlyProperties(...propertyNames: string[]): IPropertyFilterStage;
     /** Optionally override dialog title */
     title(text: string): IPropertyFilterStage;
     /** Provide initial dialog context/model data */
@@ -1433,6 +1911,7 @@ declare class AXPEntityFormBuilderService implements IEntitySelectorStage {
     private readonly entityRegistry;
     private readonly layoutBuilder;
     private readonly deviceService;
+    private readonly expressionEvaluator;
     entity(fullName: string): IInterfaceSelectorStage;
     /**
      * Fetches a record by ID for the specified entity.
@@ -1476,6 +1955,14 @@ declare class AXPMiddlewareEntityStorageService<TKey = any, TDetailDto extends A
     insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
     getAll(entityName: string): Promise<TListItemDto[]>;
     query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
+    count(entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>): Promise<number>;
+    queryAll(entityName: string, request: Pick<AXPQueryRequest, 'filter' | 'sort'>, options?: AXPEntityQueryAllOptions): Promise<AXPEntityQueryAllResult<TListItemDto>>;
+    getMany(entityName: string, ids: TKey[]): Promise<(TListItemDto | null)[]>;
+    exists(entityName: string, id: TKey): Promise<boolean>;
+    upsertOne(entityName: string, entity: TCreateDto, options?: {
+        merge?: boolean;
+    }): Promise<TKey>;
+    aggregate(entityName: string, request: AXPEntityAggregateRequest, options?: AXPEntityAggregateOptions): Promise<AXPEntityAggregateResult>;
     private runWithDedup;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>>;
@@ -1494,12 +1981,23 @@ declare function entityMasterCrudActions(options?: {
 }): AXPEntityAction[];
 declare function entityMasterRecordActions(): AXPEntityAction[];
 declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
+/**
+ * Type-level Create with empty `process.data`; the FK is supplied from `relatedEntity.persistence.foreignKeyField`
+ * when the related list is built (see `mergeForeignKeyFieldIntoCreateActions`).
+ */
+declare function entityDetailsCreateActionsDeferredParent(): AXPEntityAction;
+/**
+ * Ensures each type-level `Entity:Create` action includes `process.data[foreignKeyField]` bound to the parent row id.
+ */
+declare function mergeForeignKeyFieldIntoCreateActions(foreignKeyField: string | undefined, actions: AXPEntityAction[] | undefined): AXPEntityAction[];
+/** Property names hidden on nested Create from a related list (`excludeProperties` plus `foreignKeyField` when set). */
+declare function collectNestedCreateHiddenProperties(relatedEntity: AXPRelatedEntity): string[] | undefined;
 declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
 declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
 declare function entityDetailsEditAction(): AXPEntityAction;
 declare function entityDetailsNewEditAction(): AXPEntityAction;
 declare function entityOverrideDetailsViewAction(): AXPEntityAction;
-declare function entityDetailsCrudActions(parentId: string, options?: {
+declare function entityDetailsCrudActions(parentId?: string, options?: {
     create?: boolean;
     delete?: boolean;
     view?: boolean;
@@ -1524,6 +2022,8 @@ declare function detectEntityChanges(oldObj: any, newObj: any): AXPEntityChangeS
 
 declare class AXPEntityCategoryTreeSelectorComponent extends AXBasePageComponent implements OnInit {
     protected readonly categoryTreeService: AXPCategoryTreeService;
+    /** 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;
     protected readonly highlightService: AXHighlightService;
     private readonly changeDetectorRef;
@@ -1863,14 +2363,14 @@ declare class AXPEntityCategoryWidgetEditComponent extends AXPValueWidgetCompone
     private singleOrMultiple;
     protected getItemLabel(item: any): string;
     /**
-     * Get item path as array for breadcrumb component
+     * Get item path as array for breadcrumb component (raw MLS or string per segment).
      */
-    protected getItemPath(item: any): string[];
+    protected getItemPath(item: any): AXPMultiLanguageString[];
     /**
      * Join path array with separator.
      * Override this method to customize the separator (e.g., " > ", " -> ", " / ")
      */
-    protected joinPath(path: string[]): string;
+    protected joinPath(path: unknown[]): string;
     protected getItemId(item: any): string;
     /**
      * Calculate the full path from root to the item.
@@ -1882,7 +2382,6 @@ declare class AXPEntityCategoryWidgetEditComponent extends AXPValueWidgetCompone
 }
 
 declare class AXPEntityCategoryWidgetViewComponent extends AXPValueWidgetComponent<any> {
-    protected readonly formatService: AXFormatService;
     protected readonly entityResolver: AXPEntityDefinitionRegistryService;
     protected entity: _angular_core.Signal<string>;
     protected multiple: _angular_core.Signal<boolean>;
@@ -1894,12 +2393,11 @@ declare class AXPEntityCategoryWidgetViewComponent extends AXPValueWidgetCompone
     private entityDef;
     protected displayItems: _angular_core.WritableSignal<{
         id: string;
-        text: string;
+        titleRaw: AXPMultiLanguageString | null | undefined;
     }[]>;
     private efEntity;
     private efDisplay;
     private extractItem;
-    private getDisplayText;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityCategoryWidgetViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityCategoryWidgetViewComponent, "axp-entity-category-widget-view", never, {}, {}, never, never, true, never>;
 }
@@ -1907,7 +2405,9 @@ declare class AXPEntityCategoryWidgetViewComponent extends AXPValueWidgetCompone
 declare const AXPEntityCategoryWidget: AXPWidgetConfig;
 
 declare class AXPTruncatedBreadcrumbComponent implements OnDestroy {
-    sections: _angular_core.InputSignal<string[]>;
+    private readonly mlsResolver;
+    /** Plain string or locale map per segment; truncation uses resolved text (see {@link resolvedSectionTexts}). */
+    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>;
@@ -1917,6 +2417,8 @@ declare class AXPTruncatedBreadcrumbComponent implements OnDestroy {
     protected isExpanded: _angular_core.WritableSignal<boolean>;
     private containerWidth;
     private resizeObserver;
+    /** Resolved display strings for length / ellipsis (same rules as the pipe). */
+    protected resolvedSectionTexts: _angular_core.Signal<string[]>;
     protected effectiveCharacterLimit: _angular_core.Signal<number>;
     protected effectiveSectionLimit: _angular_core.Signal<number>;
     protected hasTruncatedText: _angular_core.Signal<boolean>;
@@ -1948,6 +2450,45 @@ 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 const AXPEntityDefinitionProviderWidget: AXPWidgetConfig;
+declare module '@acorex/platform/layout/widget-core' {
+    interface AXPWidgetTypesMap {
+        entityDefinitionProvider: 'entity-definition-provider-editor';
+    }
+}
+
+declare class AXPEntityDefinitionProviderWidgetEditComponent extends AXPProviderSelectWidgetEditBase {
+    private readonly entityRegistry;
+    /**
+     * Last applied module filter (from context) to avoid redundant reloads.
+     */
+    private readonly lastModuleFilterKey;
+    /**
+     * Reloads entity options when `filterModuleField` changes in form context (not only via `widget.refresh()`).
+     */
+    private readonly reloadWhenModuleContextChanges;
+    /**
+     * Options:
+     * - `filterModuleField`: sibling context field name (e.g. `entityListModule`); when set, only entities in that module are listed.
+     * - `valueFormat`: `fullKey` (`module.name`, default) or `entityName` (short name only, for menus that store `entityListRef.entity`).
+     */
+    protected loadDataSourceRows(): Promise<Array<{
+        value: string;
+        title: string;
+    }>>;
+    refresh(): void;
+    /**
+     * Reads sibling field from context store data (same shape as `lodash/get` paths).
+     */
+    private readModuleFromContext;
+    /**
+     * Resolves a sibling field path relative to the current widget's parent path.
+     */
+    private resolveSiblingContextPath;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionProviderWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDefinitionProviderWidgetEditComponent, "axp-entity-definition-provider-widget-edit", never, {}, {}, never, never, true, never>;
+}
+
 declare class AXPEntityListTableService {
     private readonly workflow;
     private readonly commandService;
@@ -1988,6 +2529,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
      */
@@ -2026,11 +2572,13 @@ declare class AXPEntityListToolbarService {
      */
     private createFilterDefinitions;
     /**
-     * Create Column Definitions for Toolbar
+     * Create Column Definitions for Toolbar.
+     * Includes both entity.properties and enriched columns (e.g. person.firstName with showAs).
      */
     private createColumnDefinitions;
     /**
-     * Create Sort Definitions for Toolbar
+     * Create Sort Definitions for Toolbar.
+     * Includes entity.properties with sort enabled, plus enriched columns (dotted paths).
      */
     private createSortDefinitions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityListToolbarService, never>;
@@ -2047,6 +2595,7 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
     protected commandService: AXPCommandService;
     protected eventService: AXPBroadcastEventService;
     private readonly expressionEvaluator;
+    private readonly route;
     protected isMounted: _angular_core.WritableSignal<boolean>;
     readonly entity: _angular_core.WritableSignal<AXPEntity | null>;
     protected listNode: _angular_core.WritableSignal<AXPWidgetNode | null>;
@@ -2073,7 +2622,46 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
     protected handleActionClick(item: AXPActionMenuItem): void;
     protected handleSecondaryActionClick(item: AXPActionMenuItem): void;
     protected execute(commandName: string, _data: unknown): Promise<void>;
+    /**
+     * Resolves toolbar commands including nested dropdown (`items`) actions.
+     */
+    private findToolbarAction;
     private evaluateToolbarExpressions;
+    /**
+     * Parses the `filters` query param (same shape as standalone entity list routes).
+     */
+    private parseFiltersFromRoute;
+    /**
+     * Route `filters` apply only when the active details `page` matches this list's entity
+     * (e.g. WorkOrder filters must not affect FailureRegister on the same asset layout).
+     */
+    private shouldApplyRouteFilters;
+    /**
+     * Merges route filters into related-entity toolbar filters (route wins per field).
+     */
+    private mergeToolbarFilters;
+    private getMergedToolbarFilters;
+    /**
+     * Applies merged route + parent-scope filters to the widget value and data source.
+     */
+    private applyMergedRouteFiltersToList;
+    /**
+     * Re-evaluates related-entity list filters from the live dialog form context (e.g. after create saves the main row id).
+     */
+    private applyRelatedFiltersFromContext;
+    /**
+     * Pushes current toolbar filters to the embedded list data source when both exist.
+     * Returns false while data-list is still mounting (see deferred listNode.set in ngOnInit).
+     */
+    private pushToolbarFiltersToDataSource;
+    /**
+     * Writes toolbar filters from specs and pushes them onto the data source so refresh/reload keeps the parent scope.
+     */
+    private applyRelatedFiltersFromContextAndDatasource;
+    /**
+     * Refreshes the embedded data list (toolbar / workflow). In wizard mode, `refresh` is patched to re-apply scoped filters first.
+     */
+    private refreshGridWithParentScopedFilters;
     protected queries: undefined;
     /**
      * Validates that all required dependencies are available
@@ -2127,7 +2715,7 @@ declare class AXPLookupWidgetViewComponent extends AXPValueWidgetComponent<any>
     private efEntity;
     private efDisplay;
     private extractItem;
-    private getDisplayText;
+    private getDisplayRaw;
     private get __class();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetViewComponent, "axp-lookup-widget-view", never, {}, {}, never, never, true, never>;
@@ -2144,7 +2732,7 @@ interface AXPEntityDataSelectorOptions {
         name: string;
         dir: 'asc' | 'desc';
     }[];
-    allowCreate?: boolean;
+    allowCreate?: AXPDataSelectorAllowCreate;
     searchFields?: string[];
     initialSearchTerm?: string;
     selectedItemIds?: string[] | number[];
@@ -2165,10 +2753,21 @@ declare class AXPEntityDataSelectorService {
     private readonly filterOperatorMiddleware;
     private readonly widgetResolver;
     private readonly entityResolver;
+    private readonly commandService;
     /**
      * Open entity data selector popup
      */
     open(options: AXPEntityDataSelectorOptions): Promise<AXPEntityDataSelectorResult | null>;
+    /**
+     * Execute Entity:Create and return created item.
+     * Used by lookup widget and data selector for inline create.
+     */
+    executeEntityCreate(entity: AXPEntity, mode: 'full' | 'quick'): Promise<any | null>;
+    /**
+     * Normalize item's phones/emails for expose/display.
+     * Call this when receiving items from any source (create, API, selector).
+     */
+    normalizeItemContactArrays(item: any): any;
     /**
      * Create data selector configuration from entity options
      */
@@ -2186,9 +2785,19 @@ declare class AXPEntityDataSelectorService {
      */
     private getSearchFields;
     /**
-     * Check if entity supports create operation
+     * Get allowCreate mode from entity
+     */
+    private getAllowCreate;
+    /**
+     * Execute Entity:Create and return created item
+     */
+    private executeCreate;
+    /**
+     * Normalize phones/emails from repeater form to plain arrays of { value: string }.
+     * Repeater/ContactBox can return nested structure: { value: { label: "", value: "101010" } }
+     * Contact widget expects: { value: "101010", label?: string }
      */
-    private canCreate;
+    private normalizeContactArrays;
     /**
      * Create category tree data source from category entity key
      */
@@ -2212,6 +2821,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;
@@ -2220,6 +2860,8 @@ interface AXPLookupWidgetOptions {
     look?: AXPLookupWidgetLookType;
     allowClear?: boolean;
     displayFormat?: string;
+    /** Column list: lazy resolve and summary behavior. */
+    columnResolve?: AXPLookupColumnResolveOptions;
 }
 
 declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any> {
@@ -2228,6 +2870,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected readonly entityResolver: AXPEntityDefinitionRegistryService;
     protected readonly entityService: AXPEntityService;
     protected readonly entityDataSelectorService: AXPEntityDataSelectorService;
+    private readonly mlsResolver;
     protected componentLook: _angular_core.Signal<LookupWidgetLookBase | undefined>;
     protected expose: _angular_core.Signal<string | any[] | undefined>;
     protected entity: _angular_core.Signal<string>;
@@ -2236,11 +2879,13 @@ 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>;
     protected defaultTextField: _angular_core.Signal<string>;
     protected displayField: _angular_core.Signal<string>;
+    protected allowCreate: _angular_core.Signal<"none" | "full" | "quick">;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected conditions?: AXPQueryFilter[];
@@ -2254,10 +2899,15 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     private hasValue;
     private findByValue;
     protected handleComponentValueChanged(items: any[] | null): void;
+    protected handleCreateClick(_e: AXClickEvent): Promise<void>;
+    private executeCreate;
     protected setLoading: (loading: boolean) => void;
     protected setItems: (items: any[]) => void;
     /**
-     * Update expose data for empty state
+     * Writes expose targets into context using per-path updates.
+     * Avoids `contextService.patch()` with nested objects: patch shallow-merges top-level keys only,
+     * so e.g. `{ person: { educationLevel: { id, title } } }` would replace the entire `person`
+     * object and drop sibling fields like `person.educationLevelId`, causing a value/effect loop.
      */
     private expoesItems;
     outputs(): (string | {
@@ -2273,8 +2923,12 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
 
 declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<any> {
     private readonly entityDetailPopoverService;
+    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;
@@ -2284,21 +2938,51 @@ 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 getDisplayText(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>;
 }
@@ -2630,6 +3314,174 @@ declare class AXPMultiSourceSelectorWidgetColumnComponent extends AXPColumnWidge
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMultiSourceSelectorWidgetColumnComponent, "axp-multi-source-selector-widget-column", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+declare class AXPSelectorStructureWidgetColumnComponent extends AXPValueWidgetComponent {
+    protected identityField: _angular_core.Signal<string>;
+    protected textField: _angular_core.Signal<string>;
+    protected valueField: _angular_core.Signal<string>;
+    protected previewIcon: _angular_core.Signal<string>;
+    protected cellText: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPSelectorStructureWidgetColumnComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPSelectorStructureWidgetColumnComponent, "axp-selector-structure-widget-column", never, {}, {}, never, never, true, never>;
+}
+
+type AXPSelectorStructureSelectorMode = 'select' | 'lookup';
+type AXPSelectorStructureStructureMode = 'schema' | 'freeform';
+type AXPSelectorStructureIdentityDisplay = 'readonly' | 'hidden';
+/** UI layout: standard = global multi-select + collapse rows; compactPanel = per-row select (address-style). */
+type AXPSelectorStructurePresentationMode = 'standard' | 'compactPanel';
+interface AXPSelectorStructureFieldDef {
+    name: string;
+    title: string;
+    widgetType: string;
+    options?: Record<string, unknown>;
+}
+declare const AXPSelectorStructureWidget: AXPWidgetConfig;
+interface AXPSelectorStructureWidgetDesignerOptions {
+    selectorMode?: AXPSelectorStructureSelectorMode;
+    structureMode?: AXPSelectorStructureStructureMode;
+    presentation?: AXPSelectorStructurePresentationMode;
+    previewIcon?: string;
+    placeholder?: string;
+    contextSiblingPath?: string;
+    identityField?: string;
+    identityDisplay?: AXPSelectorStructureIdentityDisplay;
+    valueField?: string;
+    textField?: string;
+    dataSource?: unknown;
+    multiple?: boolean;
+    lookup?: {
+        entity?: string;
+        look?: 'select' | 'lookup';
+        filter?: unknown;
+        hasClearButton?: boolean;
+    };
+    structureFields?: AXPSelectorStructureFieldDef[];
+    freeformPath?: string;
+}
+interface AXPSelectorStructureWidgetViewOptions extends AXPSelectorStructureWidgetDesignerOptions {
+}
+interface AXPSelectorStructureWidgetEditOptions extends AXPSelectorStructureWidgetDesignerOptions {
+}
+interface AXPSelectorStructureWidgetColumnOptions {
+    identityField?: string;
+    textField?: string;
+    previewIcon?: string;
+}
+interface AXPSelectorStructureWidgetPrintOptions {
+}
+interface AXPSelectorStructureWidgetOptions {
+    designer: AXPSelectorStructureWidgetDesignerOptions;
+    view: AXPSelectorStructureWidgetViewOptions;
+    edit: AXPSelectorStructureWidgetEditOptions;
+    print: AXPSelectorStructureWidgetPrintOptions;
+    column: AXPSelectorStructureWidgetColumnOptions;
+}
+
+declare class AXPSelectorStructureWidgetEditComponent extends AXPValueWidgetComponent {
+    #private;
+    private readonly entityRegistry;
+    protected selectorMode: _angular_core.Signal<"select" | "lookup">;
+    protected structureMode: _angular_core.Signal<"schema" | "freeform">;
+    protected contextSiblingPath: _angular_core.Signal<string>;
+    protected identityField: _angular_core.Signal<string>;
+    protected identityDisplay: _angular_core.Signal<"readonly" | "hidden">;
+    protected valueField: _angular_core.Signal<string>;
+    protected textField: _angular_core.Signal<string>;
+    protected multiple: _angular_core.Signal<boolean>;
+    protected freeformPath: _angular_core.Signal<string>;
+    protected lookupEntityKey: _angular_core.Signal<string | undefined>;
+    protected lookupHasClearButton: _angular_core.Signal<boolean>;
+    protected lookupCustomFilter: _angular_core.Signal<AXDataSourceFilterOption | undefined>;
+    protected disabled: _angular_core.Signal<boolean>;
+    protected presentationMode: _angular_core.Signal<"standard" | "compactPanel">;
+    /** Compact panel (address-style) applies only to sibling select mode; lookup falls back to standard layout. */
+    protected useCompactLayout: _angular_core.Signal<boolean>;
+    protected previewIcon: _angular_core.Signal<string>;
+    protected placeholder: _angular_core.Signal<string>;
+    protected compactSelectPlaceholder: _angular_core.Signal<string>;
+    protected addCompactItemLabel: _angular_core.Signal<string>;
+    protected clearRowTitle: _angular_core.Signal<string>;
+    protected removeRowTitle: _angular_core.Signal<string>;
+    protected resolvedSiblingPath(): string;
+    /**
+     * Items shown in the selector: sibling context array when path is set, otherwise optional static `dataSource` array.
+     */
+    protected contextItems: _angular_core.Signal<unknown[]>;
+    protected contextSelectDataSource: _angular_core.Signal<AXDataSource<unknown>>;
+    protected selectedSourceItems: _angular_core.WritableSignal<unknown[]>;
+    protected compactRowDataSources: _angular_core.Signal<AXDataSource<unknown>[]>;
+    protected compactRowSelectedItems: _angular_core.Signal<unknown[][]>;
+    protected lookupEntityDef: _angular_core.WritableSignal<AXPEntity | null>;
+    protected defaultLookupSorts: _angular_core.Signal<AXDataSourceSortOption[]>;
+    protected lookupDataSource: _angular_core.Signal<AXDataSource<unknown> | null>;
+    protected lookupTextField: _angular_core.Signal<string>;
+    protected lookupSelectedItems: _angular_core.WritableSignal<unknown[]>;
+    protected rows: _angular_core.Signal<Record<string, unknown>[]>;
+    protected structureFields: _angular_core.Signal<AXPSelectorStructureFieldDef[]>;
+    protected structureFieldNodes: _angular_core.Signal<{
+        name: string;
+        title: string;
+        node: AXPWidgetNode;
+    }[]>;
+    protected identityLabel: _angular_core.Signal<string>;
+    protected identityNode: _angular_core.Signal<AXPWidgetNode | null>;
+    protected freeformHeading: _angular_core.Signal<string>;
+    protected keyPlaceholder: _angular_core.Signal<string>;
+    protected valuePlaceholder: _angular_core.Signal<string>;
+    protected addPairLabel: _angular_core.Signal<string>;
+    protected removePairTitle: _angular_core.Signal<string>;
+    protected disabledHint: _angular_core.Signal<string>;
+    protected trackRow(row: Record<string, unknown>): unknown;
+    protected rowCaption(row: Record<string, unknown>): string;
+    protected isDraftRow(row: Record<string, unknown>): boolean;
+    protected isRowSelectLocked(row: Record<string, unknown>): boolean;
+    /**
+     * Items available for row `index`: all source items minus keys already chosen on other committed rows;
+     * always includes the current row's selected item so the select can display it.
+     */
+    protected exclusiveItemsForRow(index: number): unknown[];
+    private newRowUid;
+    protected handleCompactSelectChange(index: number, e: AXValueChangedEvent): void;
+    protected applyCompactRowFromItem(index: number, rawItem: unknown | undefined): void;
+    protected clearCompactRow(index: number): void;
+    protected removeCompactRow(index: number): void;
+    protected addCompactRow(): void;
+    protected handleSelectValueChange(e: AXValueChangedEvent): void;
+    protected handleLookupValueChange(e: AXValueChangedEvent): void;
+    protected applyRowsFromSourceItems(items: unknown[]): void;
+    protected handleSchemaContextChange(rowKey: unknown, e: AXPContextChangeEvent): void;
+    protected freeformEntries(row: Record<string, unknown>): {
+        key: string;
+        value: string;
+        index: number;
+    }[];
+    private serializeFreeformValue;
+    protected onFreeformKeyInput(row: Record<string, unknown>, entry: {
+        key: string;
+        value: string;
+        index: number;
+    }, nextKey: string): void;
+    protected patchFreeformValue(row: Record<string, unknown>, key: string, raw: string): void;
+    protected removeFreeformKey(row: Record<string, unknown>, key: string): void;
+    protected addFreeformPair(row: Record<string, unknown>): void;
+    private renameFreeformKey;
+    private patchFreeformMap;
+    private tryParseFreeformString;
+    private mergeListFilter;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPSelectorStructureWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPSelectorStructureWidgetEditComponent, "axp-selector-structure-widget-edit", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPSelectorStructureWidgetViewComponent extends AXPValueWidgetComponent {
+    protected identityField: _angular_core.Signal<string>;
+    protected textField: _angular_core.Signal<string>;
+    protected valueField: _angular_core.Signal<string>;
+    protected previewIcon: _angular_core.Signal<string>;
+    protected summaries: _angular_core.Signal<string[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPSelectorStructureWidgetViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPSelectorStructureWidgetViewComponent, "axp-selector-structure-widget-view", never, {}, {}, never, never, true, never>;
+}
+
 declare const AXPEntityCreateEvent: {
     (payload: {
         entity: string;
@@ -2751,14 +3603,23 @@ declare class AXPShowDetailViewAction extends AXPWorkflowAction {
 }
 declare const AXPShowDetailsViewWorkflow: AXPWorkflow;
 
+/** Optional list filters passed into `show-list-view` (e.g. from `Entity:List` with `conditions`). */
+interface AXPShowListViewCondition {
+    name?: string;
+    field?: string;
+    operator?: {
+        type: string;
+    };
+    value?: unknown;
+}
 declare class AXPShowListViewAction extends AXPWorkflowAction {
     private navigation;
     private sessionService;
-    execute(context?: any): Promise<void>;
+    execute(context: AXPWorkflowContext): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPShowListViewAction, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPShowListViewAction>;
 }
 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, 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, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPViewEntityDetailsCommand, 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_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, cloneLayoutArrays, columnWidthMiddleware, columnWidthMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider };
-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, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, SectionOrderConfig };
+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, 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, 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, getDataSourcePageIndex, getEntityListRowId, getMasterInterfacePropertySortKey, isAXPMiddlewareAbortError, isCategoryEntity, isCategoryFilter, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mergeForeignKeyFieldIntoCreateActions, normalizeEntityListPersistenceMode, normalizeListPaging, provideEntity, resolveEntityPluginDetailPageOrder, 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, 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, AXPShowListViewCondition, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, RunEntityQueryAdapters, SectionOrderConfig, SkipEntityComponentPageRef };