@acorex/platform 21.0.0-beta.1 → 21.0.0-beta.10

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

@@ -1,5 +1,5 @@
 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, AXPMultiLanguageString, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem, AXPContextChangeEvent } 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, EnvironmentProviders, OnInit, ChangeDetectorRef, OnDestroy } from '@angular/core';
@@ -276,7 +276,7 @@ declare class AXPEntitiesListDataSourceDefinition implements AXPDataSourceDefini
 }
 
 declare class AXPEntityCommandTriggerViewModel {
-    priority: 'primary' | 'secondary';
+    priority: 'primary' | 'secondary' | 'none';
     order: number;
     color: AXStyleColorType;
     icon: string;
@@ -317,12 +317,19 @@ declare class AXPEntityDetailListViewModel {
     private filterOperatorMiddleware;
     private expressionEvaluator;
     private queryExecutor;
+    private readonly settingsService;
+    private readonly destroyed;
+    private readonly showRowIndexColumnEnabled;
+    /** Whether the row index column is shown (user setting). */
+    readonly showIndexColumn: _angular_core.Signal<boolean>;
     dataSource: AXDataSource<any>;
     parentKey: _angular_core.Signal<string | undefined>;
     constructor(injector: Injector, detailEntityConfig: AXPRelatedEntity, parent: {
         entity: AXPEntity;
         data: any;
     });
+    private syncShowRowIndexColumnSetting;
+    destroy(): void;
     initialize(): Promise<void>;
     selectedItems: _angular_core.WritableSignal<any[]>;
     hasSelectedItems: _angular_core.Signal<boolean>;
@@ -360,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
@@ -473,12 +523,27 @@ 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;
     }>;
     views: _angular_core.Signal<AXPEntityMasterListViewQueryViewModel[]>;
     view: _angular_core.WritableSignal<AXPEntityMasterListViewQueryViewModel>;
+    private readonly showRowIndexColumnEnabled;
+    /**
+     * Row index column: if the list view defines `indexCol` (true/false), that overrides the user setting;
+     * if `indexCol` is omitted, visibility follows {@link AXPCommonSettings.ShowRowIndexColumn}.
+     */
+    showIndexColumn: _angular_core.Signal<boolean>;
     private createExpressionScope;
     private resolveCommandNameExpression;
     private resolveTitleExpression;
@@ -486,8 +551,30 @@ declare class AXPEntityMasterListViewModel {
     setView(viewName?: string | null): Promise<void>;
     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).
@@ -715,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;
@@ -857,6 +961,7 @@ type AXPEntityModifier = (context: AXPEntityModifierContext) => void;
 interface AXPEntityModifierProvider {
     entityName: string | RegExp;
     modifier: AXPEntityModifier;
+    order?: number;
 }
 
 declare function ensureListActions(ctx: AXPEntityModifierContext): void;
@@ -897,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>;
@@ -980,6 +1087,77 @@ 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.
  *
@@ -1076,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;
@@ -1086,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;
@@ -1098,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>;
@@ -1130,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>;
 }
 
@@ -1351,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> {
@@ -1736,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>>;
@@ -2266,6 +2493,7 @@ declare class AXPEntityListTableService {
     private readonly workflow;
     private readonly commandService;
     private readonly expressionEvaluator;
+    private readonly settings;
     /**
      * Convert Entity to List Widget Options
      */
@@ -2367,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>;
@@ -2393,7 +2622,29 @@ 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).
      */
@@ -2634,7 +2885,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected look: _angular_core.Signal<AXPLookupWidgetLookType>;
     protected defaultTextField: _angular_core.Signal<string>;
     protected displayField: _angular_core.Signal<string>;
-    protected allowCreate: _angular_core.Signal<"full" | "none" | "quick">;
+    protected allowCreate: _angular_core.Signal<"none" | "full" | "quick">;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected conditions?: AXPQueryFilter[];
@@ -2659,6 +2910,9 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
      * object and drop sibling fields like `person.educationLevelId`, causing a value/effect loop.
      */
     private expoesItems;
+    outputs(): (string | {
+        [name: string]: unknown;
+    })[];
     private singleOrMultiple;
     refresh(): void;
     clear(): void;
@@ -3367,5 +3621,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_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, cloneLayoutArrays, collectNestedCreateHiddenProperties, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, 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, getMasterInterfacePropertySortKey, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mergeForeignKeyFieldIntoCreateActions, 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, AXPShowListViewCondition, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, 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, 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 };

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

@@ -888,6 +888,21 @@ declare class AXPWidgetColumnRendererComponent extends AXDataTableColumnComponen
     }): boolean;
     protected handleExpandRow(row: any): Promise<void>;
     get renderHeaderTemplate(): TemplateRef<unknown>;
+    /**
+     * Resolves `options.align`: string applies to header and cell; object uses optional `header` / `cell` (default start).
+     * Supports designer select values `{ id: 'center' }`.
+     */
+    protected getHeaderTextAlign(): 'start' | 'center' | 'end';
+    /**
+     * When true, the cell body uses flex so `justify-content` can place content on the main axis.
+     */
+    protected getCellUseFlexLayout(): boolean;
+    /**
+     * Flex `justify-content` for the cell wrapper; omit when not using flex layout.
+     */
+    protected getCellJustifyContent(): 'start' | 'center' | 'end' | null;
+    private resolveAlignForSide;
+    private normalizeColumnAlignment;
     get loadingEnabled(): boolean;
     get name(): string;
     private injector;