@acorex/platform 20.3.0-next.0 → 20.3.0-next.10

package/layout/entity/index.d.ts

@@ -1,18 +1,121 @@
+import { AXPCommand, AXPQuery } from '@acorex/platform/runtime';
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Injector, Type } from '@angular/core';
+import { ElementRef, InjectionToken, Injector, Type } from '@angular/core';
+import { AXPopoverComponent } from '@acorex/components/popover';
+import { AXPMetaData, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPUserReference, AXPQueryRequest, AXPPagedListResult, AXPCategoryEntity as AXPCategoryEntity$1, AXPAppStartUpService, AXPMiddlewareErrorResponse } from '@acorex/platform/core';
+import * as i3 from '@acorex/platform/layout/builder';
+import { AXPWidgetNode, AXPWidgetColumnNode, AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
 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, 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 i2 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowContext, AXPWorkflow } from '@acorex/platform/workflow';
-import { AXPCommand } from '@acorex/platform/runtime';
+import { AXPopupSizeType } from '@acorex/components/popup';
+import { IActionBuilder, IFieldBuilder, AXPDialogRef } from '@acorex/platform/layout/components';
+
+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>;
+}
+
+declare class AXPEntityDetailPopoverComponent {
+    private readonly commandService;
+    private readonly queryService;
+    entity: _angular_core.InputSignal<string>;
+    entityId: _angular_core.InputSignal<string | number>;
+    textField: _angular_core.InputSignal<string>;
+    valueField: _angular_core.InputSignal<string>;
+    item: _angular_core.InputSignal<AXPMetaData | undefined>;
+    protected detailPopover: _angular_core.Signal<AXPopoverComponent | undefined>;
+    protected entityDetails: _angular_core.WritableSignal<any>;
+    protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
+    protected isDetailPopoverOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * Show the entity detail popover
+     */
+    show(target: ElementRef | HTMLElement): Promise<void>;
+    /**
+     * Hide the entity detail popover
+     */
+    hide(): void;
+    protected onDetailPopoverOpenChange(event: any): void;
+    protected navigateToDetails(): Promise<void>;
+    /**
+     * Returns true if a value is meaningful for display (non-empty/non-null).
+     */
+    private hasMeaningfulValue;
+    /**
+     * Calculates an importance score for a property based on its widget type,
+     * whether it currently has a meaningful value, and metadata like title.
+     */
+    private getPropertyImportanceScore;
+    /**
+     * Calculates a name-based importance score to prioritize common key fields
+     * like title, description, status, and important dates.
+     * Name priority MUST come before widget-type priority.
+     */
+    private getNameImportanceScore;
+    protected getEntityPropertiesWithWidgets(): Array<{
+        name: string;
+        title: string;
+        node: AXPWidgetNode;
+    }>;
+    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; }; }, {}, never, never, true, never>;
+}
+
+interface AXPEntityDetailPopoverOptions {
+    entity: string;
+    id: string | number;
+    item: AXPMetaData;
+    textField?: string;
+    valueField?: string;
+}
+declare class AXPEntityDetailPopoverService {
+    private readonly applicationRef;
+    private readonly environmentInjector;
+    private activePopoverRef;
+    /**
+     * Show entity detail popover
+     * @param target - The target element to position the popover
+     * @param options - Configuration options for the popover
+     */
+    show(target: ElementRef | HTMLElement, options: AXPEntityDetailPopoverOptions): Promise<void>;
+    /**
+     * Hide the active popover
+     */
+    hide(): void;
+    /**
+     * Check if a popover is currently active
+     */
+    get isActive(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDetailPopoverService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDetailPopoverService>;
+}
 
 interface AXPDataSeeder {
     seed(): Promise<void>;
@@ -101,6 +204,24 @@ declare class AXPEntityDetailListViewModel {
     getSecondaryActions(): Promise<AXPEntityCommandTriggerViewModel[]>;
 }
 
+/**
+ * Entity Event Dispatcher - A wrapper for entity-specific events
+ * Handles pattern-based dispatching for entity operations with wildcard support
+ */
+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>;
+}
+
 declare class AXPEntityCreateViewSectionViewModel {
     private entity;
     private section;
@@ -230,6 +351,7 @@ declare class AXPEntityMasterListViewModel {
     resetColumns(): void;
     onColumnsChanged(columns: AXPEntityListViewColumnViewModel[]): Promise<void>;
     applyViewColumns(): void;
+    onColumnsOrderChanged(event: any): void;
     sortableFields: () => {
         name: string;
         title: string;
@@ -330,6 +452,17 @@ declare class AXPEntityDetailViewModelFactory {
 }
 declare const AXPEntityDetailViewModelResolver: ResolveFn<Promise<AXPEntityMasterSingleViewModel>>;
 
+declare class AXPEntityUpdateViewSectionViewModel {
+    private entity;
+    private section;
+    constructor(entity: AXPEntity, section: AXPEntitySectionView);
+    group: _acorex_platform_common.AXPEntityPropertyGroup;
+    name: _angular_core.WritableSignal<string>;
+    title: _angular_core.Signal<string>;
+    description: _angular_core.Signal<string | null | undefined>;
+    layout: _angular_core.Signal<AXPGridLayoutOptions>;
+    elements: _angular_core.Signal<AXPEntityMasterUpdateElementViewModel[]>;
+}
 declare class AXPEntityMasterUpdateElementViewModel {
     private entity;
     private property;
@@ -358,6 +491,7 @@ declare class AXPEntityMasterUpdateViewModel {
     isInProgress: _angular_core.WritableSignal<boolean>;
     context: _angular_core.WritableSignal<any>;
     elements: _angular_core.Signal<AXPEntityMasterUpdateElementViewModel[]>;
+    sections: _angular_core.Signal<AXPEntityUpdateViewSectionViewModel[]>;
     save(): Promise<any>;
     reset(): void;
 }
@@ -384,10 +518,6 @@ interface AXPEntityModifierContext {
         get(): string;
         set(newName: string): AXPEntityModifierContext;
     };
-    source: {
-        get(): string;
-        set(newSource: string): AXPEntityModifierContext;
-    };
     parentKey: {
         get(): string | undefined;
         set(newKey: string | undefined): AXPEntityModifierContext;
@@ -509,14 +639,101 @@ 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;
+    private onChanged;
+    get onChanged$(): rxjs.Observable<{
+        name: string;
+    }>;
+    preload(): Promise<void>;
+    private entities;
+    private entityResolver;
+    /**
+     * 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
+     */
+    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;
+    /**
+     * 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;
-    createdBy?: string;
-    updatedBy?: string;
+    created?: {
+        at?: Date;
+        by?: AXPUserReference;
+    };
+    updated?: {
+        at?: Date;
+        by?: AXPUserReference;
+    };
+    deleted?: {
+        at?: Date;
+        by?: AXPUserReference;
+    };
 }
-interface AXPEntityModel<Id> extends AXPAuditable {
+interface AXPRecordControl {
+    isReadOnly?: boolean;
+    isHidden?: boolean;
+    isSystem?: boolean;
+    isImmutable?: boolean;
+}
+interface AXPRecordOwnership {
+    tenantId?: string;
+    ownerId?: string;
+}
+interface AXPEntityModel<Id> {
     id: Id;
+    auditInfo?: AXPAuditable;
+    stateInfo?: AXPRecordControl;
+    ownershipInfo?: AXPRecordOwnership;
 }
 interface AXPEntityCreateDto {
 }
@@ -531,31 +748,6 @@ 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?: {
@@ -603,6 +795,7 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
     private _storageService;
     private entityRegistery;
     private _entityDataProvider;
+    private _entityCategoryDataProvider;
     constructor(entityName: string);
     insertOne(request: TCreateDto): Promise<TKey>;
     getOne(id: TKey): Promise<TDetailDto>;
@@ -619,119 +812,10 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
         categoryId: TKey;
         categoryKey?: string;
     }): Promise<AXPPagedListResult<TListItemDto>>;
+    getCategoriesList(request?: AXPQueryRequest): Promise<AXPPagedListResult<AXPCategoryEntity$1<TKey>>>;
     get storageService(): AXPEntityStorageService<any, any, any, any, any>;
 }
 
-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>[]>;
-
-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;
-    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>;
-    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>>;
-    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;
-    /**
-     * 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
-     */
-    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;
-    /**
-     * 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>;
-}
-
-/**
- * Entity Event Dispatcher - A wrapper for entity-specific events
- * Handles pattern-based dispatching for entity operations with wildcard support
- */
-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>;
-}
-
 interface AXPEntityConfigs {
     viewers: {
         root: () => Type<any> | Promise<Type<any>>;
@@ -773,6 +857,208 @@ declare class AXPEntityService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityService>;
 }
 
+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: {
+        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>;
+    };
+}
+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>;
+}
+/**
+ * Error type that can be thrown by middlewares to abort the chain with a structured payload.
+ */
+declare class AXPMiddlewareAbortError extends Error {
+    readonly message: string;
+    readonly options: {
+        code?: string;
+        status?: number;
+        details?: any;
+    };
+    constructor(message: string, options?: {
+        code?: string;
+        status?: number;
+        details?: any;
+    });
+    toResponse(): AXPMiddlewareErrorResponse;
+}
+/** Type guard for AXPMiddlewareAbortError */
+declare function isAXPMiddlewareAbortError(error: unknown): error is AXPMiddlewareAbortError;
+
+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;
+
+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>;
+}
+
+interface IEntitySelectorStage {
+    /** Select target entity using "module.entity" format */
+    entity(fullName: string): IInterfaceSelectorStage;
+}
+interface IInterfaceSelectorStage {
+    /** Use master.create interface */
+    create(): IPropertyFilterStage;
+    /** Use master.update interface */
+    update(id: string): IPropertyFilterStage;
+}
+interface IPropertyFilterStage {
+    /** Only include provided property names (by AXPEntityProperty.name). Mutually exclusive with exclude(). */
+    include(...propertyNames: string[]): IPropertyFilterStage;
+    /** Exclude provided property names (by AXPEntityProperty.name). Ignored if include() was already set. */
+    exclude(...propertyNames: string[]): IPropertyFilterStage;
+    /** Optionally override dialog title */
+    title(text: string): IPropertyFilterStage;
+    /** Provide initial dialog context/model data */
+    context(context: any): IPropertyFilterStage;
+    /** Override dialog size (e.g., 'sm' | 'md' | 'lg' | 'xl' | 'full') */
+    size(size: AXPopupSizeType): IPropertyFilterStage;
+    /** Configure footer actions (cancel/submit/custom). If not called, defaults to cancel+submit. */
+    actions(delegate: (a: IActionBuilder) => void): IPropertyFilterStage;
+    /** Add an extra field into a specific group, using the original field builder API */
+    field(groupId: string, path: string, delegate?: (field: IFieldBuilder) => void): IPropertyFilterStage;
+    /** Show dialog */
+    show(): Promise<AXPDialogRef>;
+}
+declare class AXPEntityDynamicFormDialogService implements IEntitySelectorStage {
+    private readonly entityRegistry;
+    private readonly formBuilder;
+    private readonly layoutTheme;
+    entity(fullName: string): IInterfaceSelectorStage;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDynamicFormDialogService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDynamicFormDialogService>;
+}
+
+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>[]>;
+
+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;
+    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>;
+    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>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>>;
+}
+
+declare function entityMasterCreateAction(): AXPEntityAction;
+declare function entityMasterBulkDeleteAction(): AXPEntityAction;
+declare function entityMasterViewAction(): AXPEntityAction;
+declare function entityMasterDeleteAction(): AXPEntityAction;
+declare function entityMasterCrudActions(options?: {
+    create?: boolean;
+    delete?: boolean;
+    view?: boolean;
+    edit?: boolean;
+}): AXPEntityAction[];
+declare function entityMasterRecordActions(): AXPEntityAction[];
+declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
+declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
+declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
+declare function entityDetailsEditAction(): AXPEntityAction;
+declare function entityOverrideDetailsViewAction(): AXPEntityAction;
+declare function entityDetailsCrudActions(parentId: string): 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 AXPEntityCreateEvent: {
     (payload: {
         entity: string;
@@ -902,85 +1188,5 @@ 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 navigation;
-    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>;
-}
-
-declare function entityMasterCreateAction(): AXPEntityAction;
-declare function entityMasterBulkDeleteAction(): AXPEntityAction;
-declare function entityMasterViewAction(): AXPEntityAction;
-declare function entityMasterDeleteAction(): AXPEntityAction;
-declare function entityMasterCrudActions(): AXPEntityAction[];
-declare function entityMasterRecordActions(): AXPEntityAction[];
-declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
-declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
-declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
-declare function entityDetailsEditAction(): AXPEntityAction;
-declare function entityOverrideDetailsViewAction(): AXPEntityAction;
-declare function entityDetailsCrudActions(parentId: string): 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, AXPEntityEventDispatcherService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, 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, AXPOpenEntityDetailsCommandInput, AXPOpenEntityDetailsCommandResult, ColumnWidthConfig };
+export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityDynamicFormDialogService, AXPEntityEventDispatcherService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPGetEntityDetailsQuery, AXPMiddlewareAbortError, 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, isAXPMiddlewareAbortError };
+export type { AXPAuditable, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOp, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPOpenEntityDetailsCommandInput, AXPOpenEntityDetailsCommandResult, AXPRecordControl, AXPRecordOwnership, ColumnWidthConfig };