@acorex/platform 20.3.0-next.1 → 20.3.0-next.3

package/layout/entity/index.d.ts

@@ -1,17 +1,18 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Injector, EnvironmentProviders, Type } from '@angular/core';
+import { InjectionToken, Injector, Type } from '@angular/core';
 import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption } from '@acorex/cdk/common';
 import * as _acorex_platform_common from '@acorex/platform/common';
-import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPGridLayoutOptions, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityDetailListView, AXPQueryFilter } from '@acorex/platform/common';
+import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPGridLayoutOptions, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPQueryFilter } from '@acorex/platform/common';
 import { AXPMetaData, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPQueryRequest, AXPPagedListResult, AXPAppStartUpService } from '@acorex/platform/core';
 import * as i3 from '@acorex/platform/layout/builder';
 import { AXPWidgetColumnNode, AXPWidgetNode, AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
 import * as i1 from '@angular/router';
 import { ResolveFn } from '@angular/router';
+import * as rxjs from 'rxjs';
 import { Subject } from 'rxjs';
-import * as _acorex_platform_layout_entity from '@acorex/platform/layout/entity';
 import * as i2 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowContext, AXPWorkflow } from '@acorex/platform/workflow';
+import { AXPCommand, AXPQuery } from '@acorex/platform/runtime';
 
 interface AXPDataSeeder {
     seed(): Promise<void>;
@@ -41,8 +42,8 @@ declare class AXPEntityCommandTriggerViewModel {
     constructor(entity: AXPEntity, action: AXPEntityAction);
 }
 declare class AXPEntityListViewColumnViewModel {
-    private property;
-    private column;
+    readonly property: AXPEntityProperty;
+    readonly column: AXPEntityTableColumn;
     constructor(property: AXPEntityProperty, column: AXPEntityTableColumn);
     name: string;
     title: string;
@@ -185,9 +186,12 @@ declare class AXPEntityMasterListViewModel {
     private readonly settings;
     private readonly widgetResolver;
     private readonly expressionEvaluator;
+    private readonly commandService;
     private readonly filterOperatorMiddleware;
     private settingEntityKey;
     private readonly destroyed;
+    private lastAppliedSortKey;
+    private lastAppliedFilterKey;
     events$: Subject<{
         action: string;
         meta?: any;
@@ -198,7 +202,7 @@ declare class AXPEntityMasterListViewModel {
     dataSource: AXDataSource<unknown>;
     constructor(injector: Injector, config: AXPEntity);
     applySettings(): Promise<void>;
-    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize', data?: any): Promise<void>;
+    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize' | 'filters' | 'sorts', data?: any): Promise<void>;
     selectedItems: _angular_core.WritableSignal<any[]>;
     parentKey: _angular_core.Signal<string | undefined>;
     hasSelectedItems: _angular_core.Signal<boolean>;
@@ -260,7 +264,6 @@ declare class AXPEntityMasterSingleViewGroupViewModel {
     group: _acorex_platform_common.AXPEntityPropertyGroup;
     name: _angular_core.WritableSignal<string>;
     isLoading: _angular_core.WritableSignal<boolean>;
-    type: _angular_core.WritableSignal<"wrapper" | "section">;
     title: _angular_core.Signal<string>;
     description: _angular_core.Signal<string | null | undefined>;
     layout: _angular_core.Signal<AXPGridLayoutOptions>;
@@ -291,10 +294,14 @@ declare class AXPEntityMasterSingleViewModel {
     private readonly session;
     private readonly formatService;
     private readonly workflow;
+    private readonly commandService;
     private readonly destroyed;
     private translateService;
     private entityService;
     private expressionEvaluator;
+    private entityDefinitionRegistryService;
+    private _updateTrigger;
+    readonly updateTrigger: _angular_core.Signal<number>;
     constructor(injector: Injector, config: AXPEntity, entityData: any);
     context: _angular_core.WritableSignal<any>;
     private actions;
@@ -342,7 +349,6 @@ declare class AXPEntityMasterUpdateViewModel {
     private props;
     private entityDef;
     private workflow;
-    private lockService;
     private sessionService;
     private get moduleName();
     private get entityName();
@@ -354,7 +360,6 @@ declare class AXPEntityMasterUpdateViewModel {
     elements: _angular_core.Signal<AXPEntityMasterUpdateElementViewModel[]>;
     save(): Promise<any>;
     reset(): void;
-    unlock(): Promise<void>;
 }
 declare class AXPEntityMasterUpdateViewModelFactory {
     private entityService;
@@ -453,6 +458,10 @@ interface AXPEntityModifierContext {
                 get(): AXPEntityMasterSingleLayoutView | undefined;
                 update(updater: (c: AXPEntityMasterSingleLayoutView | undefined) => AXPEntityMasterSingleLayoutView): AXPEntityModifierContext;
             };
+            list: {
+                get(): AXPEntityMasterListView | undefined;
+                update(updater: (c: AXPEntityMasterListView | undefined) => AXPEntityMasterListView): AXPEntityModifierContext;
+            };
         };
         detail: {
             get(): NonNullable<AXPEntity['interfaces']>['detail'] | undefined;
@@ -467,16 +476,31 @@ interface AXPEntityModifierContext {
 }
 type AXPEntityModifier = (context: AXPEntityModifierContext) => void;
 interface AXPEntityModifierProvider {
-    entityName: string;
+    entityName: string | RegExp;
     modifier: AXPEntityModifier;
 }
 
+declare function ensureListActions(ctx: AXPEntityModifierContext): void;
+declare function actionExists(actions: any[] | undefined, commandName: string, name?: string): boolean;
+
+interface AXPEntityActionPlugin {
+    name: string;
+    order?: number;
+    apply: (ctx: AXPEntityModifierContext, options?: any) => Promise<void> | void;
+}
+declare const AXP_ENTITY_ACTION_PLUGIN: InjectionToken<AXPEntityActionPlugin[]>;
+
 declare class AXPEntityMiddleware {
-    private modifiers;
-    protected providedModifiers: _acorex_platform_layout_entity.AXPEntityModifierProvider[];
+    private exactModifiers;
+    private patternModifiers;
+    protected providedModifiers: AXPEntityModifierProvider[];
+    protected providedActionPlugins: AXPEntityActionPlugin[];
+    protected injector: Injector;
     constructor();
-    register(entityName: string, modifier: AXPEntityModifier): void;
-    process(entity: AXPEntity): AXPEntity;
+    register(entityName: string | RegExp, modifier: AXPEntityModifier): void;
+    process(entity: AXPEntity): Promise<AXPEntity>;
+    private wildcardToRegExp;
+    private normalizeRegExp;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMiddleware, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityMiddleware>;
 }
@@ -485,56 +509,6 @@ declare function createModifierContext(entity: AXPEntity): AXPEntityModifierCont
 
 declare const AXP_ENTITY_MODIFIER: InjectionToken<AXPEntityModifierProvider[]>;
 
-interface AXPEntityPreloadEntity {
-    module: string;
-    entity: string;
-}
-interface AXPEntityDefinitionPreloader {
-    preload(): AXPEntityPreloadEntity[];
-}
-declare class AXPEntityDefinitionRegistryService {
-    private providers;
-    private resolver;
-    private middleware;
-    preload(): Promise<void>;
-    private entities;
-    private entityResolver;
-    /**
-     * Registers a new entity configuration. Entities are identified uniquely by a combination
-     * of their module and name.
-     *
-     * @param config The configuration object of the entity to be registered.
-     */
-    register(config: AXPEntity): void;
-    /**
-     * Returns an array of all registered entity configurations.
-     *
-     * @returns An array of AXPEntity objects.
-     */
-    getAll(): AXPEntity[];
-    /**
-     * Resolves an entity configuration based on module and entity name. If the configuration
-     * is not already registered, attempts to load it dynamically. Throws an error if the
-     * entity cannot be found or loaded.
-     *
-     * @param moduleName The module name of the entity.
-     * @param entityName The name of the entity.
-     * @returns A promise resolving to the entity configuration.
-     * @throws Error if the entity configuration cannot be resolved.
-     */
-    resolve(moduleName: string, entityName: string): Promise<AXPEntity>;
-    /**
-     * Creates a unique key for an entity based on its module and name.
-     *
-     * @param moduleName The module name of the entity.
-     * @param entityName The name of the entity.
-     * @returns The unique key for the entity.
-     */
-    private createEntityKey;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionRegistryService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
-}
-
 interface AXPAuditable {
     createdAt?: Date;
     updatedAt?: Date;
@@ -557,6 +531,31 @@ interface AXPEntityDetailDto<Id> extends AXPEntityOutputDto<Id> {
 interface AXPEntityListItemDto<Id> extends AXPEntityOutputDto<Id> {
 }
 
+type AXPEntityOp = 'initial' | 'create' | 'update' | 'delete' | 'getOne' | 'getAll' | 'query';
+interface AXPEntityStorageContext<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
+    op: AXPEntityOp;
+    entityName: string;
+    id?: TKey;
+    data?: TCreateDto | Omit<Partial<TUpdateDto>, 'id'>;
+    request?: AXPQueryRequest;
+    previous?: TDetailDto;
+    result?: any;
+    locals: Map<string, unknown>;
+    backend: {
+        getOneRaw: (entityName: string, id: TKey) => Promise<TDetailDto>;
+        insertOneRaw: (entityName: string, entity: TCreateDto) => Promise<TKey>;
+    };
+}
+interface AXPEntityStorageMiddleware<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
+    target?: {
+        ops?: AXPEntityOp[];
+        entity?: string | RegExp;
+        predicate?: (ctx: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => boolean;
+        order?: number;
+    };
+    execute: (ctx: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, next: () => Promise<void>) => Promise<void>;
+}
+
 declare abstract class AXPEntityStorageService<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> {
     abstract get dbName(): string;
     abstract initial(entityName: string, collection: TCreateDto[], options?: {
@@ -623,295 +622,115 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
     get storageService(): AXPEntityStorageService<any, any, any, any, any>;
 }
 
-/**
- * Context object for entity storage operations
- */
-interface AXPEntityStorageContext<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
-    /** Operation type being performed */
-    operation: 'getOne' | 'getAll' | 'insertOne' | 'updateOne' | 'deleteOne' | 'query' | 'initial';
-    /** Entity name */
-    entityName: string;
-    /** Database name */
-    dbName: string;
-    /** Input parameters for the operation */
-    input: {
-        id?: TKey;
-        entity?: TCreateDto;
-        keyValues?: Omit<Partial<TUpdateDto>, 'id'>;
-        request?: AXPQueryRequest;
-        collection?: TCreateDto[];
-        options?: {
-            mergeType?: 'merge' | 'replace';
-            uniqueKeys?: string[];
-        };
-    };
-    /** Metadata for the operation */
-    metadata: {
-        startTime: number;
-        requestId: string;
-        user?: any;
-        [key: string]: any;
-    };
-}
-/**
- * Entity Storage Middleware function type
- */
-type AXPEntityStorageMiddleware<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any, TResult = any> = (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, next: (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>) => Promise<TResult>;
-/**
- * Compose entity storage middlewares into a pipeline
- */
-declare function composeEntityStorageMiddlewares<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any, TResult = any>(middlewares: AXPEntityStorageMiddleware<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto, TResult>[]): (handler: (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>) => (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>;
-/**
- * Helper function to generate unique request ID
- */
-declare function generateRequestId(): string;
-
-/**
- * Registry for managing entity storage middlewares
- */
-declare class AXPEntityStorageRegistry {
-    private globalMiddlewares;
-    private entitySpecificMiddlewares;
-    private operationSpecificMiddlewares;
-    /**
-     * Add a global middleware that applies to all operations
-     */
-    useGlobal(middleware: AXPEntityStorageMiddleware): void;
-    /**
-     * Add middleware for specific entity
-     */
-    useForEntity(entityName: string, middleware: AXPEntityStorageMiddleware): void;
-    /**
-     * Add middleware for specific operation (getOne, insertOne, etc.)
-     */
-    useForOperation(operation: string, middleware: AXPEntityStorageMiddleware): void;
-    /**
-     * Get all applicable middlewares for a given context
-     */
-    getMiddlewares(entityName: string, operation: string): AXPEntityStorageMiddleware[];
-    /**
-     * Get all global middlewares
-     */
-    getGlobalMiddlewares(): readonly AXPEntityStorageMiddleware[];
-    /**
-     * Remove middleware from global middlewares
-     */
-    removeGlobalMiddleware(middleware: AXPEntityStorageMiddleware): boolean;
-    /**
-     * Clear all middlewares
-     */
-    clear(): void;
-    /**
-     * Get registered entity names that have specific middlewares
-     */
-    getRegisteredEntityNames(): string[];
-    /**
-     * Get registered operation names that have specific middlewares
-     */
-    getRegisteredOperations(): string[];
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageRegistry, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageRegistry>;
-}
+declare const AXP_ENTITY_STORAGE_BACKEND: InjectionToken<AXPEntityStorageService<any, any, any, any, any>>;
+declare const AXP_ENTITY_STORAGE_MIDDLEWARE: InjectionToken<AXPEntityStorageMiddleware<any, any, any, any, any>[]>;
 
-/**
- * Executor that wraps entity storage operations with middleware pipeline
- */
-declare class AXPEntityStorageExecutor<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
-    private storageService;
+declare class AXPMiddlewareEntityStorageService<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> extends AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto> {
+    private readonly backend;
+    private readonly allMiddlewares;
     private readonly injector;
-    private readonly registry;
-    constructor(storageService: AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>);
-    /**
-     * Execute getOne operation with middleware pipeline
-     */
+    get dbName(): string;
+    private filterMiddlewares;
+    private compose;
+    private run;
+    private createCtx;
+    initial(entityName: string, collection: TCreateDto[], options?: {
+        mergeType?: 'merge' | 'replace';
+        uniqueKeys?: string[];
+    }): Promise<TCreateDto[]>;
     getOne(entityName: string, id: TKey): Promise<TDetailDto>;
-    /**
-     * Execute getAll operation with middleware pipeline
-     */
-    getAll(entityName: string): Promise<TListItemDto[]>;
-    /**
-     * Execute insertOne operation with middleware pipeline
-     */
-    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
-    /**
-     * Execute updateOne operation with middleware pipeline
-     */
     updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
-    /**
-     * Execute deleteOne operation with middleware pipeline
-     */
     deleteOne(entityName: string, id: TKey): Promise<void>;
-    /**
-     * Execute query operation with middleware pipeline
-     */
+    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
+    getAll(entityName: string): Promise<TListItemDto[]>;
     query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>>;
+}
+
+interface AXPEntityPreloadEntity {
+    module: string;
+    entity: string;
+}
+interface AXPEntityDefinitionPreloader {
+    preload(): AXPEntityPreloadEntity[];
+}
+declare class AXPEntityDefinitionRegistryService {
+    private providers;
+    private resolver;
+    private middleware;
+    private onChanged;
+    get onChanged$(): rxjs.Observable<{
+        name: string;
+    }>;
+    preload(): Promise<void>;
+    private entities;
+    private entityResolver;
     /**
-     * Execute initial operation with middleware pipeline
+     * Force re-load and re-process entity definitions, then re-register them.
+     * Overloads:
+     *  - refresh(): refresh all registered entities
+     *  - refresh(fullName: string): refresh by fully-qualified name `<module>.<entity>`
+     *  - refresh(moduleName: string, entityName: string): refresh by parts
      */
-    initial(entityName: string, collection: TCreateDto[], options?: {
-        mergeType?: 'merge' | 'replace';
-        uniqueKeys?: string[];
-    }): Promise<TCreateDto[]>;
+    refresh(): Promise<void>;
+    refresh(fullName: string): Promise<void>;
+    refresh(moduleName: string, entityName: string): Promise<void>;
+    /** Executes the actual refresh for a single entity */
+    private refreshOne;
     /**
-     * Execute operation with middleware pipeline
+     * Registers a new entity configuration. Entities are identified uniquely by a combination
+     * of their module and name.
+     *
+     * @param config The configuration object of the entity to be registered.
      */
-    private executeWithMiddleware;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageExecutor<any, any, any, any, any>, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageExecutor<any, any, any, any, any>>;
-}
-
-/**
- * Entity Storage Service with middleware support
- *
- * This service wraps the original AXPEntityStorageService and adds middleware pipeline support.
- * It delegates all operations to the middleware executor which applies the middleware chain.
- */
-declare class AXPEntityStorageWithMiddlewareService<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> extends AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto> {
-    private originalStorageService;
-    private registry;
-    private executor;
-    constructor(originalStorageService: AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, registry: AXPEntityStorageRegistry);
-    get dbName(): string;
+    register(config: AXPEntity): void;
     /**
-     * Add a global middleware that applies to all operations
+     * Returns an array of all registered entity configurations.
+     *
+     * @returns An array of AXPEntity objects.
      */
-    useGlobal(middleware: AXPEntityStorageMiddleware): void;
+    getAll(): AXPEntity[];
     /**
-     * Add middleware for specific entity
+     * Resolves an entity configuration based on module and entity name. If the configuration
+     * is not already registered, attempts to load it dynamically. Throws an error if the
+     * entity cannot be found or loaded.
+     *
+     * @param moduleName The module name of the entity.
+     * @param entityName The name of the entity.
+     * @returns A promise resolving to the entity configuration.
+     * @throws Error if the entity configuration cannot be resolved.
      */
-    useForEntity(entityName: string, middleware: AXPEntityStorageMiddleware): void;
+    resolve(moduleName: string, entityName: string): Promise<AXPEntity>;
     /**
-     * Add middleware for specific operation
+     * Creates a unique key for an entity based on its module and name.
+     *
+     * @param moduleName The module name of the entity.
+     * @param entityName The name of the entity.
+     * @returns The unique key for the entity.
      */
-    useForOperation(operation: string, middleware: AXPEntityStorageMiddleware): void;
-    initial(entityName: string, collection: TCreateDto[], options?: {
-        mergeType?: 'merge' | 'replace';
-        uniqueKeys?: string[];
-    }): Promise<TCreateDto[]>;
-    getOne(entityName: string, id: TKey): Promise<TDetailDto>;
-    updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
-    deleteOne(entityName: string, id: TKey): Promise<void>;
-    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
-    getAll(entityName: string): Promise<TListItemDto[]>;
-    query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
-    get originalService(): AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>;
-    get middlewareRegistry(): AXPEntityStorageRegistry;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageWithMiddlewareService<any, any, any, any, any>, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageWithMiddlewareService<any, any, any, any, any>>;
+    private createEntityKey;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionRegistryService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
 }
 
 /**
- * Injection token for entity storage middleware setup
+ * Entity Event Dispatcher - A wrapper for entity-specific events
+ * Handles pattern-based dispatching for entity operations with wildcard support
  */
-declare const AXP_ENTITY_STORAGE_MIDDLEWARE_SETUP: InjectionToken<void>;
-/**
- * Injection token for entity storage middleware extensions
- */
-declare const AXP_ENTITY_STORAGE_EXTENSION: InjectionToken<{
-    target: string | RegExp;
-    middleware: AXPEntityStorageMiddleware;
-}>;
-/**
- * Configuration for entity-specific middleware
- */
-interface AXPEntityStorageMiddlewareConfig {
-    /** Global middlewares that apply to all operations */
-    global?: AXPEntityStorageMiddleware[];
-    /** Entity-specific middlewares */
-    entities?: {
-        [entityName: string]: AXPEntityStorageMiddleware[];
-    };
-    /** Operation-specific middlewares */
-    operations?: {
-        [operation: string]: AXPEntityStorageMiddleware[];
-    };
-    /** Advanced middleware configurations with targets */
-    extensions?: {
-        target: string | RegExp;
-        middleware: AXPEntityStorageMiddleware;
-    }[];
+declare class AXPEntityEventDispatcherService {
+    private readonly eventService;
+    dispatchEntityEvent(operation: 'inserted' | 'updated' | 'deleted', entityName: string, data: any): Promise<void>;
+    private getAllMatchingEventKeys;
+    private findMatchingWildcardKeys;
+    private matchesEntityPattern;
+    private generateEventKeys;
+    dispatchInserted(entityName: string, data: any): Promise<void>;
+    dispatchUpdated(entityName: string, data: any): Promise<void>;
+    dispatchDeleted(entityName: string, data: any): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityEventDispatcherService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityEventDispatcherService>;
 }
-/**
- * Provide entity storage middleware configuration
- */
-declare function provideEntityStorageMiddleware(config: AXPEntityStorageMiddlewareConfig): EnvironmentProviders;
-/**
- * Simplified provider for global middleware only
- */
-declare function provideGlobalEntityStorageMiddleware(middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
-/**
- * Provider for entity-specific middlewares
- */
-declare function provideEntitySpecificMiddleware(entityName: string, middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
-/**
- * Provider for operation-specific middlewares
- */
-declare function provideOperationSpecificMiddleware(operation: string, middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
-
-/**
- * Logging middleware for entity storage operations
- */
-declare const loggingMiddleware: AXPEntityStorageMiddleware;
-/**
- * Performance monitoring middleware
- */
-declare const performanceMiddleware: AXPEntityStorageMiddleware;
-/**
- * Error handling middleware with retry logic
- */
-declare const errorHandlingMiddleware: AXPEntityStorageMiddleware;
-/**
- * Validation middleware
- */
-declare const validationMiddleware: AXPEntityStorageMiddleware;
-/**
- * Caching middleware (simple in-memory cache)
- */
-declare const cachingMiddleware: AXPEntityStorageMiddleware;
-
-/**
- * Audit trail entry interface
- */
-interface AXPAuditEntry {
-    id: string;
-    entityName: string;
-    operation: string;
-    entityId?: any;
-    changes?: any;
-    user?: string;
-    timestamp: Date;
-    requestId: string;
-    metadata?: any;
-}
-/**
- * Audit trail storage interface
- */
-interface AXPAuditStorage {
-    save(entry: AXPAuditEntry): Promise<void>;
-}
-/**
- * Simple in-memory audit storage (for demo purposes)
- */
-declare class InMemoryAuditStorage implements AXPAuditStorage {
-    private entries;
-    save(entry: AXPAuditEntry): Promise<void>;
-    getEntries(): AXPAuditEntry[];
-    getEntriesForEntity(entityName: string): AXPAuditEntry[];
-    clear(): void;
-}
-declare const auditStorage: InMemoryAuditStorage;
-/**
- * Audit middleware that tracks all entity operations
- */
-declare const auditMiddleware: AXPEntityStorageMiddleware;
-/**
- * User context middleware - adds user information to context
- */
-declare const userContextMiddleware: AXPEntityStorageMiddleware;
-/**
- * Data sanitization middleware - removes sensitive data from logs
- */
-declare const dataSanitizationMiddleware: AXPEntityStorageMiddleware;
 
 interface AXPEntityConfigs {
     viewers: {
@@ -921,6 +740,7 @@ interface AXPEntityConfigs {
         };
         master: {
             single: () => Type<any> | Promise<Type<any>>;
+            details: () => Type<any> | Promise<Type<any>>;
             create: () => Type<any> | Promise<Type<any>>;
             modify: () => Type<any> | Promise<Type<any>>;
             list: () => Type<any> | Promise<Type<any>>;
@@ -1082,6 +902,64 @@ declare class AXPShowListViewAction extends AXPWorkflowAction {
 }
 declare const AXPShowListViewWorkflow: AXPWorkflow;
 
+interface AXPOpenEntityDetailsCommandInput {
+    entity: string;
+    data: {
+        id: string;
+    };
+}
+interface AXPOpenEntityDetailsCommandResult {
+    success: boolean;
+}
+/**
+ * Generic command to open entity details view
+ * Can be used by any entity to navigate to its detail page
+ */
+declare class AXPOpenEntityDetailsCommand implements AXPCommand<AXPOpenEntityDetailsCommandInput, AXPOpenEntityDetailsCommandResult> {
+    private readonly router;
+    private readonly sessionService;
+    /**
+     * Execute the command to navigate to entity details
+     * @param input - Command input containing entity and data information
+     */
+    execute(input: AXPOpenEntityDetailsCommandInput): Promise<AXPOpenEntityDetailsCommandResult>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPOpenEntityDetailsCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPOpenEntityDetailsCommand>;
+}
+
+interface AXPGetEntityDetailsQueryInput {
+    entity: string;
+    id: string;
+}
+interface AXPGetEntityDetailsQueryResult {
+    success: boolean;
+    entityDefinition?: AXPEntity;
+    entityData?: any;
+    error?: string;
+}
+/**
+ * Generic query to get entity details including entity definition and entity data
+ * Can be used by any entity to retrieve its definition and data by ID
+ */
+declare class AXPGetEntityDetailsQuery implements AXPQuery<AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult> {
+    private readonly entityDefinitionRegistry;
+    private readonly injector;
+    /**
+     * Execute the query to fetch entity definition and data
+     * @param input - Query input containing entity and ID information
+     */
+    fetch(input: AXPGetEntityDetailsQueryInput): Promise<AXPGetEntityDetailsQueryResult>;
+    /**
+     * Get entity data using the entity's CRUD service
+     * @param entity - Full entity path (ModuleName.EntityName)
+     * @param id - Entity ID
+     * @returns Promise resolving to entity data
+     */
+    private getEntityData;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPGetEntityDetailsQuery, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPGetEntityDetailsQuery>;
+}
+
 declare function entityMasterCreateAction(): AXPEntityAction;
 declare function entityMasterBulkDeleteAction(): AXPEntityAction;
 declare function entityMasterViewAction(): AXPEntityAction;
@@ -1090,11 +968,52 @@ declare function entityMasterCrudActions(): AXPEntityAction[];
 declare function entityMasterRecordActions(): AXPEntityAction[];
 declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
 declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
-declare function entityDetailsReferenceCondition(): AXPQueryFilter[];
+declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
 declare function entityDetailsEditAction(): AXPEntityAction;
 declare function entityOverrideDetailsViewAction(): AXPEntityAction;
 declare function entityDetailsCrudActions(parentId: string): AXPEntityAction[];
-declare function entityDetailsReferenceCreateActions(): AXPEntityAction[];
+declare function entityDetailsReferenceCreateActions(type: string): AXPEntityAction[];
+type AXPEntityChangeSet = {
+    [key: string]: {
+        oldValue: any;
+        newValue: any;
+        added?: any[];
+        removed?: any[];
+    };
+};
+/**
+ * Computes a diff between two plain objects with array-aware semantics.
+ * - For arrays of objects with an id field, computes added/removed by id.
+ * - For arrays of primitives or objects without id, uses deep equality.
+ * - For scalars/objects, reports oldValue/newValue when changed.
+ */
+declare function detectEntityChanges(oldObj: any, newObj: any): AXPEntityChangeSet;
+
+declare const eventDispatchMiddleware: AXPEntityStorageMiddleware;
+
+/**
+ * Map of column name -> width value
+ * Example: { title: '300px', description: '300px' }
+ */
+type ColumnWidthConfig = Record<string, string | number>;
+/**
+ * Default widths for common text columns
+ */
+declare const DEFAULT_COLUMN_WIDTHS: ColumnWidthConfig;
+/**
+ * Factory to create a column width middleware using provided config map.
+ * Sets width for columns defined in the map if not already defined on the column.
+ */
+declare const columnWidthMiddlewareFactory: (widths: ColumnWidthConfig) => AXPEntityModifier;
+/**
+ * Helper to create a provider for the column width middleware.
+ * By default it applies to all entities using the '*' pattern.
+ */
+declare const createColumnWidthMiddlewareProvider: (widths: ColumnWidthConfig, entityName?: string | RegExp) => AXPEntityModifierProvider;
+/**
+ * Default provider registered with the default map.
+ */
+declare const columnWidthMiddlewareProvider: AXPEntityModifierProvider;
 
-export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageExecutor, AXPEntityStorageRegistry, AXPEntityStorageService, AXPEntityStorageWithMiddlewareService, AXPModifyEntitySectionWorkflow, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_EXTENSION, AXP_ENTITY_STORAGE_MIDDLEWARE_SETUP, auditMiddleware, auditStorage, cachingMiddleware, composeEntityStorageMiddlewares, createModifierContext, dataSanitizationMiddleware, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, errorHandlingMiddleware, generateRequestId, loggingMiddleware, performanceMiddleware, provideEntitySpecificMiddleware, provideEntityStorageMiddleware, provideGlobalEntityStorageMiddleware, provideOperationSpecificMiddleware, userContextMiddleware, validationMiddleware };
-export type { AXPAuditEntry, AXPAuditStorage, AXPAuditable, AXPDataSeeder, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityStorageMiddlewareConfig, AXPEntityUpdateDto };
+export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPGetEntityDetailsQuery, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPOpenEntityDetailsCommand, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, 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, DEFAULT_COLUMN_WIDTHS, actionExists, columnWidthMiddlewareFactory, columnWidthMiddlewareProvider, createColumnWidthMiddlewareProvider, createModifierContext, detectEntityChanges, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware };
+export type { AXPAuditable, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOp, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPOpenEntityDetailsCommandInput, AXPOpenEntityDetailsCommandResult, ColumnWidthConfig };