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

package/layout/entity/index.d.ts

@@ -1,11 +1,11 @@
-import { AXPExecuteCommandResult, AXPMetaData, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPUserReference, AXPQueryRequest, AXPPagedListResult, AXPCategoryEntity as AXPCategoryEntity$1, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem } from '@acorex/platform/core';
+import { AXPExecuteCommandResult, AXPMetaData, AXPGridLayoutOptions, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPUserReference, AXPQueryRequest, AXPPagedListResult, AXPCategoryEntity as AXPCategoryEntity$1, AXPEntityOp, AXPMiddlewareErrorResponse, AXHighlightService, AXPExpression, AXPColumnQuery, AXPSortDefinition, AXPDeviceService, AXPBroadcastEventService, AXPActionMenuItem } from '@acorex/platform/core';
 import { AXPCommand, AXPQueryExecutor, AXPCommandService, AXPQuery } from '@acorex/platform/runtime';
 import * as _angular_core from '@angular/core';
 import { ElementRef, InjectionToken, Injector, Type, OnInit, ChangeDetectorRef, OnDestroy } from '@angular/core';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import * as i3 from '@acorex/platform/layout/widget-core';
 import { AXPWidgetNode, AXPWidgetColumnNode, AXPWidgetCoreService, AXPColumnWidgetComponent, AXPValueWidgetComponent, AXPWidgetConfig, AXPWidgetRendererDirective } from '@acorex/platform/layout/widget-core';
-import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption, AXValueChangedEvent, AXClickEvent, AXFocusEvent, AXHtmlEvent, AXDataSourceSortOption } from '@acorex/cdk/common';
+import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption, AXValueChangedEvent, AXClickEvent, AXFocusEvent, AXHtmlEvent } from '@acorex/cdk/common';
 import * as _acorex_platform_common from '@acorex/platform/common';
 import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPQueryFilter } from '@acorex/platform/common';
 import * as i1 from '@angular/router';
@@ -23,7 +23,7 @@ import { AXBasePageComponent } from '@acorex/components/page';
 import { AXFormatService } from '@acorex/core/format';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
 import { AXPDataListWidgetComponentOptions } from '@acorex/platform/layout/widgets';
-import { AXSelectBoxComponent } from '@acorex/components/select-box';
+import { AXPCategoryTreeDataSource } from '@acorex/platform/layout/components';
 
 declare class AXPCreateEntityCommand implements AXPCommand<any, any> {
     private entityForm;
@@ -89,6 +89,7 @@ declare class AXPEntityDetailPopoverComponent {
     textField: _angular_core.InputSignal<string>;
     valueField: _angular_core.InputSignal<string>;
     item: _angular_core.InputSignal<AXPMetaData | undefined>;
+    breadcrumb: _angular_core.InputSignal<string | null>;
     protected detailPopover: _angular_core.Signal<AXPopoverComponent | undefined>;
     protected entityDetails: _angular_core.WritableSignal<any>;
     protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
@@ -124,7 +125,7 @@ declare class AXPEntityDetailPopoverComponent {
         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>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDetailPopoverComponent, "axp-entity-detail-popover", never, { "entity": { "alias": "entity"; "required": true; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": true; "isSignal": true; }; "textField": { "alias": "textField"; "required": false; "isSignal": true; }; "valueField": { "alias": "valueField"; "required": false; "isSignal": true; }; "item": { "alias": "item"; "required": false; "isSignal": true; }; "breadcrumb": { "alias": "breadcrumb"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface AXPEntityDetailPopoverOptions {
@@ -133,6 +134,7 @@ interface AXPEntityDetailPopoverOptions {
     item: AXPMetaData;
     textField?: string;
     valueField?: string;
+    breadcrumb?: string;
 }
 declare class AXPEntityDetailPopoverService {
     private readonly applicationRef;
@@ -718,8 +720,6 @@ interface AXPEntityDefinitionPreloader {
 }
 declare class AXPEntityDefinitionRegistryService {
     private middleware;
-    private moduleProviderLoader;
-    private manifestRegistry;
     private onChanged;
     get onChanged$(): rxjs.Observable<{
         name: string;
@@ -769,12 +769,6 @@ declare class AXPEntityDefinitionRegistryService {
      */
     resolve(moduleName: string, entityName: string): Promise<AXPEntity>;
     exists(moduleName: string, entityName: string): Promise<boolean>;
-    /**
-     * Waits for module provider to be loaded if the module exists in manifest but provider isn't registered yet.
-     * This handles race conditions where entity resolution happens before module providers finish loading.
-     * Only waits for required modules or waits briefly for non-required modules (which may not be accessible to current user).
-     */
-    private waitForModuleProviderIfNeeded;
     /**
      * Creates a unique key for an entity based on its module and name.
      *
@@ -918,7 +912,6 @@ interface AXPEntityDefinitionLoader {
 declare const AXP_ENTITY_DEFINITION_LOADER: InjectionToken<AXPEntityDefinitionLoader>;
 declare class AXPEntityResolver {
     private providers;
-    private providerRegistry;
     get(moduleName: string, entityName: string): Promise<AXPEntity | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityResolver, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityResolver>;
@@ -1037,7 +1030,6 @@ 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;
@@ -1086,26 +1078,13 @@ declare function isAXPMiddlewareAbortError(error: unknown): error is AXPMiddlewa
 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.
+ * Entity modifier that applies column widths using the column width service
+ * Uses the generic column width resolution system from core library
+ * Note: inject() works here because modifiers are executed via runInInjectionContext()
  */
-declare const createColumnWidthMiddlewareProvider: (widths: ColumnWidthConfig, entityName?: string | RegExp) => AXPEntityModifierProvider;
+declare const columnWidthMiddleware: AXPEntityModifier;
 /**
- * Default provider registered with the default map.
+ * Default provider that applies column width middleware to all entities
  */
 declare const columnWidthMiddlewareProvider: AXPEntityModifierProvider;
 
@@ -1272,6 +1251,8 @@ interface IPropertyFilterStage {
     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: CompatFormFieldBuilder) => void): IPropertyFilterStage;
+    /** Build and return the widget node without showing dialog */
+    build(): Promise<AXPWidgetNode>;
     /** Show dialog */
     show(): Promise<AXPDialogRef>;
     mode(mode: 'edit' | 'view'): IPropertyFilterStage;
@@ -1281,6 +1262,13 @@ declare class AXPEntityFormBuilderService implements IEntitySelectorStage {
     private readonly layoutBuilder;
     private readonly deviceService;
     entity(fullName: string): IInterfaceSelectorStage;
+    /**
+     * Fetches a record by ID for the specified entity.
+     * @param fullName - Entity full name in "module.entity" format
+     * @param id - Record ID to fetch
+     * @returns Promise resolving to the record data, or empty object if not found
+     */
+    getRecordById(fullName: string, id: string): Promise<Record<string, any>>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityFormBuilderService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityFormBuilderService>;
 }
@@ -1584,6 +1572,7 @@ declare class AXPEntityCategoryWidgetColumnComponent extends AXPColumnWidgetComp
     protected getItemPath(item: any): string[];
     protected hasParent(item: any): boolean;
     protected getItemText(item: any): string;
+    protected joinPath(path: string[]): string;
     protected getItemId(item: any): string;
     private extractItemWithPath;
     /**
@@ -1700,109 +1689,49 @@ declare class AXPEntityCategoryWidgetViewComponent extends AXPValueWidgetCompone
 declare const AXPEntityCategoryWidget: AXPWidgetConfig;
 
 declare class AXPTruncatedBreadcrumbComponent implements OnDestroy {
-    /**
-     * Array of path sections to display
-     */
     sections: _angular_core.InputSignal<string[]>;
-    /**
-     * Maximum number of characters per section.
-     * Can be a number or 'auto' to calculate based on available space.
-     */
     characterLimit: _angular_core.InputSignal<number | "auto">;
-    /**
-     * Maximum number of sections to display before showing ellipsis.
-     * Can be a number or 'auto' to calculate based on available space.
-     */
     sectionLimit: _angular_core.InputSignal<number | "auto">;
-    /**
-     * Icon class for separator between sections
-     */
     separatorIcon: _angular_core.InputSignal<string>;
-    /**
-     * Icon class for ellipsis
-     */
     ellipsisIcon: _angular_core.InputSignal<string>;
-    /**
-     * Icon class for eye icon (collapse button)
-     */
     eyeIcon: _angular_core.InputSignal<string>;
     protected container: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
     protected isExpanded: _angular_core.WritableSignal<boolean>;
     private containerWidth;
     private resizeObserver;
-    /**
-     * Effective character limit (calculated if 'auto', otherwise uses input value)
-     */
     protected effectiveCharacterLimit: _angular_core.Signal<number>;
-    /**
-     * Effective section limit (calculated if 'auto', otherwise uses input value)
-     */
     protected effectiveSectionLimit: _angular_core.Signal<number>;
+    protected hasTruncatedText: _angular_core.Signal<boolean>;
+    protected hasHiddenSections: _angular_core.Signal<boolean>;
     /**
-     * All sections with truncated text (for collapsed display)
+     * canToggle: If this is false, NO Eye Icon and NO Click events will exist.
      */
-    protected allSections: _angular_core.Signal<{
+    protected canToggle: _angular_core.Signal<boolean>;
+    protected allSectionsTruncated: _angular_core.Signal<{
         text: string;
         original: string;
     }[]>;
-    /**
-     * All sections with full text (for expanded display)
-     */
-    protected allSectionsFull: _angular_core.Signal<string[]>;
-    /**
-     * Sections to display (first N sections) when collapsed
-     */
     protected displayedSections: _angular_core.Signal<{
         text: string;
         original: string;
     }[]>;
-    /**
-     * Last section (always shown if there are hidden sections)
-     */
     protected lastSection: _angular_core.Signal<{
         text: string;
         original: string;
     }>;
-    /**
-     * Check if there are hidden sections
-     */
-    protected hasHiddenSections: _angular_core.Signal<boolean>;
     constructor();
     ngOnDestroy(): void;
-    /**
-     * Handles click on separator icon to expand
-     */
     protected handleSeparatorClick(event: Event): void;
-    /**
-     * Handles click on ellipsis icon to expand
-     */
     protected handleEllipsisClick(event: Event): void;
-    /**
-     * Handles click on eye icon to collapse
-     */
     protected handleCollapseClick(event: Event): void;
-    /**
-     * Initializes ResizeObserver to track container width
-     */
     private initializeResizeObserver;
-    /**
-     * Calculates automatic character limit based on available space
-     */
-    private calculateAutoCharacterLimit;
-    /**
-     * Calculates automatic section limit based on available space
-     */
-    private calculateAutoSectionLimit;
-    /**
-     * Truncates text to character limit with ellipsis
-     */
-    private truncateText;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTruncatedBreadcrumbComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTruncatedBreadcrumbComponent, "axp-truncated-breadcrumb", never, { "sections": { "alias": "sections"; "required": false; "isSignal": true; }; "characterLimit": { "alias": "characterLimit"; "required": false; "isSignal": true; }; "sectionLimit": { "alias": "sectionLimit"; "required": false; "isSignal": true; }; "separatorIcon": { "alias": "separatorIcon"; "required": false; "isSignal": true; }; "ellipsisIcon": { "alias": "ellipsisIcon"; "required": false; "isSignal": true; }; "eyeIcon": { "alias": "eyeIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXPEntityListTableService {
     private readonly workflow;
+    private readonly commandService;
     private readonly expressionEvaluator;
     /**
      * Convert Entity to List Widget Options
@@ -2000,6 +1929,14 @@ interface AXPEntityDataSelectorOptions {
     searchFields?: string[];
     initialSearchTerm?: string;
     selectedItemIds?: string[] | number[];
+    categoryFilter?: {
+        title: string;
+        dataSource: AXPCategoryTreeDataSource;
+        filterField: string;
+        filterOperator?: 'equal' | 'contains' | 'in';
+        width?: string;
+    };
+    showCategoryFilter?: boolean;
 }
 interface AXPEntityDataSelectorResult {
     items: any[];
@@ -2008,20 +1945,11 @@ declare class AXPEntityDataSelectorService {
     private readonly dataSelectorService;
     private readonly filterOperatorMiddleware;
     private readonly widgetResolver;
+    private readonly entityResolver;
     /**
      * Open entity data selector popup
      */
     open(options: AXPEntityDataSelectorOptions): Promise<AXPEntityDataSelectorResult | null>;
-    /**
-     * Open entity data selector with category filter
-     */
-    openWithCategoryFilter(options: Omit<AXPEntityDataSelectorOptions, 'allowCreate'>, categoryFilterConfig: {
-        title: string;
-        dataSource: any;
-        filterField: string;
-        filterOperator?: 'equal' | 'contains' | 'in';
-        width?: string;
-    }): Promise<AXPEntityDataSelectorResult | null>;
     /**
      * Create data selector configuration from entity options
      */
@@ -2042,6 +1970,10 @@ declare class AXPEntityDataSelectorService {
      * Check if entity supports create operation
      */
     private canCreate;
+    /**
+     * Create category tree data source from category entity key
+     */
+    private createCategoryTreeDataSource;
     /**
      * Merge custom and parent filters into data source query
      */
@@ -2061,17 +1993,23 @@ interface AXPLookupWidgetOptions {
     displayFormat?: string;
 }
 
+/**
+ * Base interface for lookup widget look components
+ * All look components should implement this interface to ensure consistency
+ */
+declare abstract class LookupWidgetLookBase {
+    abstract refresh(): void;
+    abstract focus(): void;
+    abstract clear(): void;
+}
+
 declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any> {
     #private;
     protected readonly injector: Injector;
     protected readonly entityResolver: AXPEntityDefinitionRegistryService;
-    protected readonly formatService: AXFormatService;
-    protected readonly popupService: AXPopupService;
+    protected readonly entityService: AXPEntityService;
     protected readonly entityDataSelectorService: AXPEntityDataSelectorService;
-    private readonly translateService;
-    protected selectBox: _angular_core.Signal<AXSelectBoxComponent | undefined>;
-    protected tagBox: _angular_core.Signal<AXTagBoxComponent | undefined>;
-    private shouldFocus;
+    protected componentLook: _angular_core.Signal<LookupWidgetLookBase | undefined>;
     protected expose: _angular_core.Signal<string | any[] | undefined>;
     protected entity: _angular_core.Signal<string>;
     protected disabled: _angular_core.Signal<string>;
@@ -2084,43 +2022,28 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected allowClear: _angular_core.Signal<boolean>;
     protected defaultTextField: _angular_core.Signal<string>;
     protected displayField: _angular_core.Signal<string>;
-    protected selectedItemsText: _angular_core.Signal<string>;
     protected valueField: _angular_core.Signal<string>;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected conditions?: AXPQueryFilter[];
     protected filter: AXDataSourceFilterOption | null;
-    private entityDef;
-    /**
-     * Get default sort order from entity's first list view
-     */
-    protected defaultSorts: _angular_core.Signal<AXDataSourceSortOption[]>;
-    protected dataSource: _angular_core.Signal<AXDataSource<unknown> | null>;
-    protected searchTerm: _angular_core.WritableSignal<string | null>;
+    protected entityDef: _angular_core.WritableSignal<AXPEntity | null>;
     protected selectedItems: _angular_core.WritableSignal<any[]>;
-    textbox: _angular_core.Signal<AXTagBoxComponent | undefined>;
+    protected initialItems: _angular_core.WritableSignal<boolean>;
+    protected initialized: _angular_core.WritableSignal<boolean>;
+    protected previousValue: _angular_core.WritableSignal<any>;
     protected isLoading: _angular_core.WritableSignal<boolean>;
-    protected isOpen: _angular_core.WritableSignal<boolean>;
-    private placeholderUpdateToken;
+    private hasValue;
     private findByValue;
-    protected handleOnClick(e: AXClickEvent): void;
-    private showSelector;
-    protected selectBoxValueChange(e: AXValueChangedEvent): void;
-    protected handleValueChange(e: AXValueChangedEvent): void;
-    protected handleSearchInputChange(e: AXValueChangedEvent): void;
-    protected handleOnBlur(e: AXFocusEvent): void;
-    protected handleKeyUp(e: AXHtmlEvent): Promise<void>;
-    private setItems;
-    protected handleClearClick(): void;
-    refresh(): void;
-    clear(): void;
-    clearInput(): void;
-    protected getTagLabel(item: any): string;
-    private searchByValue;
-    private mergeFilter;
-    private singleOrMultiple;
+    protected handleComponentValueChanged(items: any[] | null): void;
+    protected setLoading: (loading: boolean) => void;
+    protected setItems: (items: any[]) => void;
     /**
-     * Public focus method to trigger focusing
+     * Update expose data for empty state
      */
+    private expoesItems;
+    private singleOrMultiple;
+    refresh(): void;
+    clear(): void;
     focus(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetEditComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetEditComponent, "axp-lookup-widget-edit", never, {}, {}, never, never, true, never>;
@@ -2160,6 +2083,331 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
 
 declare const AXPLookupWidget: AXPWidgetConfig;
 
+/**
+ * Unified reference format for all sources
+ */
+interface AXPMultiSourceRef {
+    /** Source identifier (e.g., 'site-location', 'inline-address', 'employee-user') */
+    sourceKey: string;
+    /** Entity ID if entity source (optional for inline sources) */
+    refId?: string;
+    /** Always present - used for display */
+    displayName: string;
+    /** Full data (for inline sources or denormalized entity data) */
+    data?: any;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Stored value type
+ * - Single: AXPMultiSourceRef
+ * - Multiple: AXPMultiSourceRef[]
+ */
+type AXPMultiSourceValue = AXPMultiSourceRef | AXPMultiSourceRef[];
+/**
+ * Source type
+ */
+declare enum AXPMultiSourceType {
+    Entity = "entity",
+    Inline = "inline"
+}
+/**
+ * Single source item definition
+ */
+interface AXPMultiSourceItem {
+    /** Unique identifier for this source */
+    key: string;
+    /** Display information */
+    title: string;
+    icon?: string;
+    badge?: string;
+    description?: string;
+    /** Source type */
+    type: AXPMultiSourceType;
+    /** For entity sources: entity name (e.g., 'LocationManagement.Location') */
+    entity?: string;
+    /** For inline sources: command key to execute for inline creation (e.g., 'Module.Entity:CreateInline') */
+    inlineCreateCommand?: string;
+    /** Optional: Filter/constraints for this source */
+    filters?: AXDataSourceFilterOption;
+    /** Optional: Custom search fields */
+    searchFields?: string[];
+    /** Display format template for results */
+    displayFormat?: string;
+    /** Value transformation (how to store this source) */
+    valueTransform?: (item: any) => AXPMultiSourceRef;
+}
+/**
+ * Complete source configuration (from provider)
+ */
+interface AXPMultiSourceDefinition {
+    /** Provider name */
+    name: string;
+    /** Display title */
+    title: string;
+    /** Sources array */
+    sources: AXPMultiSourceItem[];
+    /** Default search strategy */
+    searchStrategy: 'unified' | 'tabs' | 'grouped';
+    /** Default display format */
+    defaultDisplayFormat?: string;
+    /** Default multiple selection */
+    defaultMultiple?: boolean;
+}
+/**
+ * Widget options
+ */
+interface AXPMultiSourceSelectorWidgetOptions {
+    /** Provider name (required) */
+    providerName: string;
+    /** Override multiple selection (optional, uses provider default if not specified) */
+    multiple?: boolean;
+    /** Override display format (optional, uses provider default if not specified) */
+    displayFormat?: string;
+    /** Additional filters to apply to all sources */
+    filters?: AXDataSourceFilterOption;
+    /** Custom placeholder */
+    placeholder?: string;
+    /** Allow clear */
+    allowClear?: boolean;
+}
+
+/**
+ * Injection token for multi-source definition providers
+ */
+declare const AXP_MULTI_SOURCE_DEFINITION_PROVIDER: InjectionToken<AXPMultiSourceDefinitionProvider[]>;
+/**
+ * Provider context for building definitions
+ */
+declare class AXPMultiSourceDefinitionProviderContext {
+    private definitions;
+    addDefinition(definition: AXPMultiSourceDefinition): void;
+    getDefinitions(): AXPMultiSourceDefinition[];
+    findDefinition(name: string): AXPMultiSourceDefinition | undefined;
+}
+/**
+ * Provider interface
+ */
+interface AXPMultiSourceDefinitionProvider {
+    provide(context: AXPMultiSourceDefinitionProviderContext): Promise<void> | void;
+}
+/**
+ * Service for managing multi-source definitions
+ */
+declare class AXPMultiSourceDefinitionProviderService {
+    private readonly providers;
+    private cache;
+    private load;
+    /**
+     * Get definition by name
+     */
+    getDefinition(name: string): Promise<AXPMultiSourceDefinition>;
+    /**
+     * Reload definitions (clear cache)
+     */
+    reload(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceDefinitionProviderService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMultiSourceDefinitionProviderService>;
+}
+
+declare const AXPMultiSourceSelectorWidget: AXPWidgetConfig;
+
+/**
+ * Search result item with source information
+ */
+interface AXPMultiSourceSearchResultItem {
+    source: AXPMultiSourceItem;
+    item: any;
+}
+/**
+ * Search result
+ */
+interface AXPMultiSourceSearchResult {
+    items: AXPMultiSourceSearchResultItem[];
+    total: number;
+}
+declare class AXPMultiSourceFederatedSearchService {
+    private readonly entityResolver;
+    /**
+     * Search across all enabled sources
+     */
+    search(definition: AXPMultiSourceDefinition, searchTerm: string, filters?: AXDataSourceFilterOption): Promise<AXPMultiSourceSearchResult>;
+    /**
+     * Search single source
+     */
+    searchSource(source: AXPMultiSourceItem, searchTerm: string, filters?: AXDataSourceFilterOption): Promise<{
+        items: any[];
+        total: number;
+    }>;
+    /**
+     * Resolve entity from entity name string (e.g., 'LocationManagement.Location')
+     */
+    private resolveEntity;
+    /**
+     * Search entity using entity queries
+     */
+    private searchEntity;
+    /**
+     * Build search filters from search term
+     */
+    private buildSearchFilters;
+    /**
+     * Get default searchable fields from entity
+     */
+    private getDefaultSearchFields;
+    /**
+     * Merge multiple filters
+     */
+    private mergeFilters;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceFederatedSearchService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMultiSourceFederatedSearchService>;
+}
+
+/**
+ * Selector open configuration
+ */
+interface AXPMultiSourceSelectorOpenConfig {
+    definition: AXPMultiSourceDefinition;
+    multiple: boolean;
+    selectedValues?: AXPMultiSourceValue;
+    filters?: AXDataSourceFilterOption;
+    title?: string;
+}
+/**
+ * Selector result
+ */
+interface AXPMultiSourceSelectorResult {
+    items: AXPMultiSourceRef[];
+}
+declare class AXPMultiSourceSelectorService {
+    private readonly popupService;
+    private readonly definitionService;
+    /**
+     * Open selector popup by provider name
+     */
+    openByProviderName(providerName: string, config: {
+        multiple: boolean;
+        selectedValues?: AXPMultiSourceValue;
+        filters?: AXDataSourceFilterOption;
+        title?: string;
+    }): Promise<AXPMultiSourceSelectorResult | null>;
+    /**
+     * Open selector popup
+     */
+    open(config: AXPMultiSourceSelectorOpenConfig): Promise<AXPMultiSourceSelectorResult | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceSelectorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMultiSourceSelectorService>;
+}
+
+/**
+ * Multi-source selector popup component
+ */
+declare class AXPMultiSourceSelectorComponent extends AXBasePageComponent {
+    private readonly entityDataSelectorService;
+    private readonly entityResolver;
+    private readonly translationService;
+    protected config: _angular_core.WritableSignal<AXPMultiSourceSelectorOpenConfig>;
+    protected definition: _angular_core.Signal<AXPMultiSourceDefinition>;
+    protected activeTabKey: _angular_core.WritableSignal<string | null>;
+    protected activeSource: _angular_core.Signal<AXPMultiSourceItem | null>;
+    protected selectedItems: _angular_core.WritableSignal<AXPMultiSourceRef[]>;
+    protected readonly AXPMultiSourceType: typeof AXPMultiSourceType;
+    protected ngOnInit(): void;
+    protected handleTabClick(source: AXPMultiSourceItem): void;
+    protected handleSelectFromSource(source: AXPMultiSourceItem): Promise<void>;
+    protected handleCancel(): void;
+    protected handleConfirm(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceSelectorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMultiSourceSelectorComponent, "axp-multi-source-selector", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPMultiSourceSelectorWidgetEditComponent extends AXPValueWidgetComponent<any> {
+    protected readonly popupService: AXPopupService;
+    protected readonly definitionService: AXPMultiSourceDefinitionProviderService;
+    protected readonly selectorService: AXPMultiSourceSelectorService;
+    protected tagBox: _angular_core.Signal<AXTagBoxComponent | undefined>;
+    protected providerName: _angular_core.Signal<string>;
+    protected disabled: _angular_core.Signal<boolean>;
+    protected multiple: _angular_core.Signal<boolean>;
+    protected allowClear: _angular_core.Signal<boolean>;
+    protected placeholderText: _angular_core.Signal<string>;
+    protected searchTerm: _angular_core.WritableSignal<string | null>;
+    protected selectedItems: _angular_core.WritableSignal<AXPMultiSourceRef[]>;
+    protected isLoading: _angular_core.WritableSignal<boolean>;
+    protected isOpen: _angular_core.WritableSignal<boolean>;
+    protected definition: _angular_core.WritableSignal<AXPMultiSourceDefinition | null>;
+    private efProvider;
+    private efValue;
+    protected handleOnClick(e: AXClickEvent): void;
+    protected handleValueChange(e: AXValueChangedEvent): void;
+    protected handleSearchInputChange(e: AXValueChangedEvent): void;
+    protected handleOnBlur(e: AXFocusEvent): void;
+    protected handleKeyUp(e: AXHtmlEvent): Promise<void>;
+    protected handleClearClick(): void;
+    private findByValue;
+    private normalizeToRef;
+    private showSelector;
+    private setItems;
+    refresh(): void;
+    clear(): void;
+    private clearInput;
+    protected getTagLabel(item: AXPMultiSourceRef): string;
+    private singleOrMultiple;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceSelectorWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMultiSourceSelectorWidgetEditComponent, "axp-multi-source-selector-widget-edit", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPMultiSourceSelectorWidgetViewComponent extends AXPValueWidgetComponent<any> {
+    protected readonly formatService: AXFormatService;
+    protected readonly definitionService: AXPMultiSourceDefinitionProviderService;
+    protected providerName: _angular_core.Signal<string>;
+    protected multiple: _angular_core.Signal<boolean>;
+    protected badgeClass: _angular_core.Signal<string>;
+    protected displayFormat: _angular_core.Signal<string | undefined>;
+    protected loading: _angular_core.WritableSignal<boolean>;
+    private definition;
+    protected displayItems: _angular_core.WritableSignal<{
+        id: string;
+        text: string;
+    }[]>;
+    private efProvider;
+    private efDisplay;
+    private extractDisplayItem;
+    private getDisplayText;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceSelectorWidgetViewComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMultiSourceSelectorWidgetViewComponent, "axp-multi-source-selector-widget-view", never, {}, {}, never, never, true, never>;
+}
+
+declare class AXPMultiSourceSelectorWidgetColumnComponent extends AXPColumnWidgetComponent<any> {
+    private readonly formatService;
+    private readonly definitionService;
+    protected providerName: string;
+    protected columnName: string;
+    protected maxVisible: number;
+    protected displayFormat: _angular_core.Signal<string | undefined>;
+    private definition;
+    constructor();
+    protected displayItems: _angular_core.Signal<{
+        id: string;
+        text: string;
+    }[]>;
+    protected allItems: _angular_core.Signal<{
+        id: string;
+        text: string;
+    }[]>;
+    protected visibleItems: _angular_core.Signal<{
+        id: string;
+        text: string;
+    }[]>;
+    protected hasMoreItems: _angular_core.Signal<boolean>;
+    protected remainingItemsCount: _angular_core.Signal<number>;
+    private loadDefinition;
+    private extractDisplayItem;
+    private getDisplayText;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMultiSourceSelectorWidgetColumnComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMultiSourceSelectorWidgetColumnComponent, "axp-multi-source-selector-widget-column", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 declare const AXPEntityCreateEvent: {
     (payload: {
         entity: string;
@@ -2290,5 +2538,5 @@ declare class AXPShowListViewAction extends AXPWorkflowAction {
 }
 declare const AXPShowListViewWorkflow: AXPWorkflow;
 
-export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPCreateEntityCommand, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorService, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityEventsKeys, AXPEntityFormBuilderService, AXPEntityListTableService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPGetEntityDetailsQuery, AXPLookupFilterWidget, AXPLookupFilterWidgetEditComponent, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPOpenEntityDetailsCommand, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPViewEntityDetailsCommand, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, DEFAULT_COLUMN_WIDTHS, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, cloneLayoutArrays, columnWidthMiddlewareFactory, columnWidthMiddlewareProvider, createColumnWidthMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider };
-export type { AXPAuditEvent, AXPAuditInfo, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOp, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPOpenEntityDetailsCommandInput, AXPRecordOwnershipInfo, AXPRecordStateInfo, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, ColumnWidthConfig, SectionOrderConfig };
+export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPCreateEntityCommand, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorService, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityEventsKeys, AXPEntityFormBuilderService, AXPEntityListTableService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPGetEntityDetailsQuery, AXPLookupFilterWidget, AXPLookupFilterWidgetEditComponent, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPMultiSourceDefinitionProviderContext, AXPMultiSourceDefinitionProviderService, AXPMultiSourceFederatedSearchService, AXPMultiSourceSelectorComponent, AXPMultiSourceSelectorService, AXPMultiSourceSelectorWidget, AXPMultiSourceSelectorWidgetColumnComponent, AXPMultiSourceSelectorWidgetEditComponent, AXPMultiSourceSelectorWidgetViewComponent, AXPMultiSourceType, AXPOpenEntityDetailsCommand, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPViewEntityDetailsCommand, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_MULTI_SOURCE_DEFINITION_PROVIDER, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, cloneLayoutArrays, columnWidthMiddleware, columnWidthMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider };
+export type { AXPAuditEvent, AXPAuditInfo, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordOwnershipInfo, AXPRecordStateInfo, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, SectionOrderConfig };