@acorex/platform 20.9.8 → 20.9.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "20.9.8",
+  "version": "20.9.10",
   "peerDependencies": {
     "@acorex/cdk": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0 || ^21.0.3-next.0",
     "@acorex/core": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0 || ^21.0.3-next.0",

package/types/acorex-platform-common.d.ts

@@ -781,6 +781,7 @@ interface AXPGroupSearchResult {
 interface AXPSettingsServiceInterface {
     load(): Promise<AXPSettingValue[]>;
     get<T = any>(key: string): Promise<T>;
+    peekCached(key: string): unknown | undefined;
     defaultValues(scope: AXPPlatformScope): Promise<Record<string, unknown>>;
     scope(scope: AXPPlatformScope): ScopedSettingService;
 }
@@ -802,6 +803,11 @@ declare class AXPSettingsService implements AXPSettingsServiceInterface {
      * it is not read at runtime—use it to document the expected result (e.g. `get<boolean>(key)`).
      */
     get<T = any>(key: string): Promise<T>;
+    /**
+     * Synchronous read from the in-memory scope cache (User → Tenant → Platform).
+     * Returns `undefined` when the key is not cached yet (e.g. before {@link load} completes).
+     */
+    peekCached(key: string): unknown | undefined;
     /**
      * Effective value (user → tenant → platform) when set; otherwise the definition default. Used for reads and coercion hints.
      */

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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnDestroy, OnInit, QueryList, Type, EventEmitter, WritableSignal } from '@angular/core';
+import { Signal, InjectionToken, InputSignal, TemplateRef, ElementRef, OnDestroy, OnInit, OnChanges, EventEmitter, QueryList, Type, WritableSignal } from '@angular/core';
 import * as _acorex_platform_contracts from '@acorex/platform/contracts';
 import { AXPSystemActionType, AXPCategoryEntity, AXPColumnQuery, AXPWidgetNode, AXPContextData, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPContextChangeEvent, AXPMultiLanguageString, AXPActionMenuItem, AXPExecuteCommand, AXPExecuteCommandResult, containsHtmlMarkup, AXPSortDefinition, AXPSortQuery, AXPMetaData, AXPViewQuery } from '@acorex/platform/contracts';
 import { AXPActivityLog } from '@acorex/platform/core';
@@ -10,7 +10,7 @@ import { AXPMenuItem } from '@acorex/platform/common';
 import { AXTreeViewLegacyComponent, AXTreeItemClickBaseEventLegacy } from '@acorex/components/tree-view-legacy';
 import { AXPopoverComponent } from '@acorex/components/popover';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXDataTableRowClick, AXRowCommandItemClickEvent } from '@acorex/components/data-table';
+import { AXDataTableComponent, AXRowCommandItem, AXDataTableRowDbClick, AXDataTableRowClick, AXRowCommandItemClickEvent, AXDataTableColumnComponent } from '@acorex/components/data-table';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
 import { AXTagBoxComponent } from '@acorex/components/tag-box';
@@ -712,6 +712,45 @@ declare class AXPDataSelectorService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPDataSelectorService>;
 }
 
+interface AXPTextCommandColumnClickEvent {
+    data: Record<string, unknown>;
+    textField: string;
+}
+/**
+ * Data-table column that renders a field value as a clickable text link and emits a command event on click.
+ */
+declare class AXPTextCommandColumnComponent extends AXDataTableColumnComponent implements OnInit, OnChanges {
+    caption: string;
+    /** Row field path used to resolve the link label. */
+    textField: string;
+    customWidth?: string;
+    columnFixed?: 'start' | 'end';
+    footerTemplate?: TemplateRef<unknown>;
+    sortEnabled: boolean;
+    headerSortDirection?: 'asc' | 'desc';
+    headerSortPriority?: number;
+    disabled: boolean;
+    emptyDisplay: string;
+    readonly commandClick: EventEmitter<AXPTextCommandColumnClickEvent>;
+    readonly sortToggle: EventEmitter<MouseEvent>;
+    headerTemplate: TemplateRef<unknown>;
+    cellTemplate: TemplateRef<unknown>;
+    private contentFooterTemplate;
+    get loadingEnabled(): boolean;
+    get name(): string;
+    get renderFooterTemplate(): TemplateRef<unknown>;
+    get renderHeaderTemplate(): TemplateRef<unknown>;
+    get renderCellTemplate(): TemplateRef<unknown>;
+    ngOnInit(): void;
+    ngOnChanges(): void;
+    protected resolveLabel(rowData: Record<string, unknown>): string | null;
+    protected handleClick(rowData: Record<string, unknown>): void;
+    protected onHeaderClick(event: MouseEvent): void;
+    private syncColumnState;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPTextCommandColumnComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPTextCommandColumnComponent, "axp-text-command-column", never, { "caption": { "alias": "caption"; "required": true; }; "textField": { "alias": "textField"; "required": true; }; "customWidth": { "alias": "customWidth"; "required": false; }; "columnFixed": { "alias": "columnFixed"; "required": false; }; "footerTemplate": { "alias": "footerTemplate"; "required": false; }; "sortEnabled": { "alias": "sortEnabled"; "required": false; }; "headerSortDirection": { "alias": "headerSortDirection"; "required": false; }; "headerSortPriority": { "alias": "headerSortPriority"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "emptyDisplay": { "alias": "emptyDisplay"; "required": false; }; }, { "commandClick": "commandClick"; "sortToggle": "sortToggle"; }, never, never, true, never>;
+}
+
 interface AXPDragDropListItem {
     id: string;
     content: string;
@@ -2406,7 +2445,7 @@ declare class AXPQuerySortsComponent {
     constructor();
     private emitActiveSortQueries;
     protected drop(event: CdkDragDrop<unknown[]>): void;
-    getSortDirection(item: AXPSortDefinition): "desc" | "asc" | undefined;
+    getSortDirection(item: AXPSortDefinition): "asc" | "desc" | undefined;
     protected changeItemSort(item: AXPSortDefinition): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPQuerySortsComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPQuerySortsComponent, "axp-query-sorts", never, { "sortDefinitions": { "alias": "sortDefinitions"; "required": false; "isSignal": true; }; "initialSortQueries": { "alias": "initialSortQueries"; "required": false; "isSignal": true; }; }, { "sortDefinitions": "sortDefinitionsChange"; "sortQueriesChange": "sortQueriesChange"; }, never, never, true, never>;
@@ -3362,5 +3401,5 @@ declare class AXPWidgetPropertyViewerService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPropertyViewerService>;
 }
 
-export { AXPActivityLogComponent, AXPAvatarComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPConditionBuilderComponent, AXPConditionBuilderConditionComponent, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPExpressionFieldDefinitions, AXPImageEditorPopupComponent, AXPImageEditorService, AXPItemConfiguratorComponent, AXPLayoutFloatingZoomBarComponent, AXPLayoutSideDetailPanelComponent, AXPLayoutSideDetailPanelSectionDirective, AXPLogoComponent, AXPMarkdownTemplateDirective, AXPMarkdownViewerComponent, AXPMenuBadgeHelper, AXPMenuCustomizerComponent, AXPMenuCustomizerService, AXPOutcomeResultsViewerComponent, AXPPageComponentRegistryService, AXPPreloadFiltersComponent, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPRepeaterRowsLayoutComponent, AXPResourceAppointmentBoardProvider, AXPResourceAppointmentComponent, AXPResourceAppointmentService, AXPSectionItemsBuilderComponent, AXPSignatureEditorService, AXPSpreadsheetComponent, AXPStandardSectionItemsBuilderComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTableColumnsEditorComponent, AXPTableColumnsEditorPopupComponent, AXPTableColumnsEditorService, AXPTableDataEditorComponent, AXPTableDataEditorPopupComponent, AXPTableDataEditorService, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPVirtualKeypadComponent, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_EXPRESSION_LOGIC_DEFINITIONS, AXP_EXPRESSION_OPERATION_DEFINITIONS, AXP_MENU_CUSTOMIZER_SERVICE, AXP_PAGE_COMPONENT_PROVIDER, AXP_RESOURCE_APPOINTMENT_PROVIDER, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, STANDARD_SECTION_ITEMS_SECTION_TABS, buildPropertyViewerInitialContextFromProperties, buildPropertyViewerTabsFromProperties, buildTableColumnsEditorLayout, getFieldDefinitions, getLogicDefinition, getOperationDefinition, isPropertyBindingExpressionFormValue, preparePropertyForViewer, preparePropertyViewerTabs, registerFieldDefinitions, withValidationsOnEditorNode };
-export type { AXPBuilderBadge, AXPBuilderBadgeVariant, AXPBuilderDefinition, AXPBuilderItem, AXPBuilderItemIconTone, AXPBuilderItemViewModel, AXPBuilderSection, AXPBuilderTexts, AXPBuilderValue, AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPDataSelectorAllowCreate, AXPDataSelectorCategoryConfig, AXPDataSelectorCategoryFilterConfig, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDataSelectorCreateConfig, AXPDataSelectorFilterConfig, AXPDataSelectorGridConfig, AXPDataSelectorRowActionItem, AXPDataSelectorRowActionsHandler, AXPDataSelectorSearchConfig, AXPDataSelectorSearchField, AXPDataSelectorSelectionConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPExpressionFieldDefinition, AXPExpressionGroupNode, AXPExpressionLogicDefinition, AXPExpressionLogicType, AXPExpressionNode, AXPExpressionNodeId, AXPExpressionOperationDefinition, AXPExpressionOperationNode, AXPExpressionOperationType, AXPExpressionTree, AXPExpressionValueOperand, AXPExpressionValueSourceType, AXPImageEditorOpenOptions, AXPLayoutSideDetailPanelEmptyState, AXPLayoutSideDetailPanelHeader, AXPLayoutSideDetailPanelHeaderIcon, AXPLayoutSideDetailPanelRow, AXPLayoutSideDetailPanelRowFormat, AXPLayoutSideDetailPanelSection, AXPMenuCustomizerAction, AXPMenuCustomizerItem, AXPMenuCustomizerItemType, AXPMenuCustomizerNodeData, AXPMenuCustomizerNodeMetadata, AXPMenuCustomizerState, AXPOutcomeResultRow, AXPOutcomeResultSection, AXPOutcomeResultValuePresentation, AXPOutcomeResultsViewModel, AXPPageComponentDefinition, AXPPageComponentProvider, AXPPreloadFiltersApplyEvent, AXPPropertyViewerActionRef, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPResourceAppointmentActionMenuItem, AXPResourceAppointmentBoardFilter, AXPResourceAppointmentItem, AXPResourceAppointmentResource, AXPResourceAppointmentStatus, AXPSignatureEditorAction, AXPSignatureEditorOpenOptions, AXPSignatureEditorResult, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPStandardSectionFormContext, AXPStandardSectionItemsBuilderConfig, AXPTableColumnDefinition, AXPTableColumnsEditorOpenOptions, AXPTableDataEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPVirtualKeypadAction, AXPVirtualKeypadKey, AXPVirtualKeypadLook, AXPVirtualKeypadPressEvent, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, ConditionBuilderSelectedField, IAXPPropertyViewerDialogBuilder, IAXPPropertyViewerRoot, IAXPWidgetPropertyViewerDialogBuilder, IAXPWidgetPropertyViewerRoot, ItemConfiguratorListItem, StateMode };
+export { AXPActivityLogComponent, AXPAvatarComponent, AXPCategoryTreeComponent, AXPColorPalettePickerComponent, AXPColumnItemListComponent, AXPCompareViewComponent, AXPConditionBuilderComponent, AXPConditionBuilderConditionComponent, AXPDataSelectorComponent, AXPDataSelectorService, AXPDragDropListComponent, AXPExpressionFieldDefinitions, AXPImageEditorPopupComponent, AXPImageEditorService, AXPItemConfiguratorComponent, AXPLayoutFloatingZoomBarComponent, AXPLayoutSideDetailPanelComponent, AXPLayoutSideDetailPanelSectionDirective, AXPLogoComponent, AXPMarkdownTemplateDirective, AXPMarkdownViewerComponent, AXPMenuBadgeHelper, AXPMenuCustomizerComponent, AXPMenuCustomizerService, AXPOutcomeResultsViewerComponent, AXPPageComponentRegistryService, AXPPreloadFiltersComponent, AXPPropertyViewerComponent, AXPPropertyViewerPopupComponent, AXPPropertyViewerService, AXPQueryColumnsComponent, AXPQueryFiltersComponent, AXPQuerySortsComponent, AXPQueryViewsComponent, AXPRepeaterRowsLayoutComponent, AXPResourceAppointmentBoardProvider, AXPResourceAppointmentComponent, AXPResourceAppointmentService, AXPSectionItemsBuilderComponent, AXPSignatureEditorService, AXPSpreadsheetComponent, AXPStandardSectionItemsBuilderComponent, AXPStateMessageComponent, AXPStopwatchComponent, AXPTableColumnsEditorComponent, AXPTableColumnsEditorPopupComponent, AXPTableColumnsEditorService, AXPTableDataEditorComponent, AXPTableDataEditorPopupComponent, AXPTableDataEditorService, AXPTaskBadgeDirective, AXPTaskBadgeProvider, AXPTaskBadgeService, AXPTemplateViewerComponent, AXPTemplateViewerService, AXPTextCommandColumnComponent, AXPThemeLayoutActionsComponent, AXPThemeLayoutBlockComponent, AXPThemeLayoutContainerComponent, AXPThemeLayoutEndSideComponent, AXPThemeLayoutFooterComponent, AXPThemeLayoutHeaderComponent, AXPThemeLayoutListComponent, AXPThemeLayoutListItemComponent, AXPThemeLayoutListItemsGroupComponent, AXPThemeLayoutPageHeaderComponent, AXPThemeLayoutPagePrimaryActionsComponent, AXPThemeLayoutPageSecondaryActionsComponent, AXPThemeLayoutSectionComponent, AXPThemeLayoutStartSideComponent, AXPThemeLayoutToolbarComponent, AXPUserAvatarComponent, AXPUserAvatarService, AXPVirtualKeypadComponent, AXPWidgetFieldConfiguratorComponent, AXPWidgetItemComponent, AXPWidgetPropertyViewerComponent, AXPWidgetPropertyViewerPopupComponent, AXPWidgetPropertyViewerService, AXP_EXPRESSION_LOGIC_DEFINITIONS, AXP_EXPRESSION_OPERATION_DEFINITIONS, AXP_MENU_CUSTOMIZER_SERVICE, AXP_PAGE_COMPONENT_PROVIDER, AXP_RESOURCE_APPOINTMENT_PROVIDER, AXP_TASK_BADGE_PROVIDERS, AXP_USER_AVATAR_PROVIDER, STANDARD_SECTION_ITEMS_SECTION_TABS, buildPropertyViewerInitialContextFromProperties, buildPropertyViewerTabsFromProperties, buildTableColumnsEditorLayout, getFieldDefinitions, getLogicDefinition, getOperationDefinition, isPropertyBindingExpressionFormValue, preparePropertyForViewer, preparePropertyViewerTabs, registerFieldDefinitions, withValidationsOnEditorNode };
+export type { AXPBuilderBadge, AXPBuilderBadgeVariant, AXPBuilderDefinition, AXPBuilderItem, AXPBuilderItemIconTone, AXPBuilderItemViewModel, AXPBuilderSection, AXPBuilderTexts, AXPBuilderValue, AXPCategoryTreeActions, AXPCategoryTreeConfig, AXPCategoryTreeDataSource, AXPCategoryTreeEvents, AXPCategoryTreeNode, AXPColumnItemListItem, AXPCompareViewField, AXPCompareViewInputs, AXPCompareViewMode, AXPCompareViewObject, AXPDataSelectorAllowCreate, AXPDataSelectorCategoryConfig, AXPDataSelectorCategoryFilterConfig, AXPDataSelectorColumn, AXPDataSelectorConfig, AXPDataSelectorCreateConfig, AXPDataSelectorFilterConfig, AXPDataSelectorGridConfig, AXPDataSelectorRowActionItem, AXPDataSelectorRowActionsHandler, AXPDataSelectorSearchConfig, AXPDataSelectorSearchField, AXPDataSelectorSelectionConfig, AXPDragDropListConfig, AXPDragDropListDropEvent, AXPDragDropListItem, AXPExpressionFieldDefinition, AXPExpressionGroupNode, AXPExpressionLogicDefinition, AXPExpressionLogicType, AXPExpressionNode, AXPExpressionNodeId, AXPExpressionOperationDefinition, AXPExpressionOperationNode, AXPExpressionOperationType, AXPExpressionTree, AXPExpressionValueOperand, AXPExpressionValueSourceType, AXPImageEditorOpenOptions, AXPLayoutSideDetailPanelEmptyState, AXPLayoutSideDetailPanelHeader, AXPLayoutSideDetailPanelHeaderIcon, AXPLayoutSideDetailPanelRow, AXPLayoutSideDetailPanelRowFormat, AXPLayoutSideDetailPanelSection, AXPMenuCustomizerAction, AXPMenuCustomizerItem, AXPMenuCustomizerItemType, AXPMenuCustomizerNodeData, AXPMenuCustomizerNodeMetadata, AXPMenuCustomizerState, AXPOutcomeResultRow, AXPOutcomeResultSection, AXPOutcomeResultValuePresentation, AXPOutcomeResultsViewModel, AXPPageComponentDefinition, AXPPageComponentProvider, AXPPreloadFiltersApplyEvent, AXPPropertyViewerActionRef, AXPPropertyViewerChangedEvent, AXPPropertyViewerConfig, AXPPropertyViewerGroup, AXPPropertyViewerResult, AXPPropertyViewerTab, AXPResourceAppointmentActionMenuItem, AXPResourceAppointmentBoardFilter, AXPResourceAppointmentItem, AXPResourceAppointmentResource, AXPResourceAppointmentStatus, AXPSignatureEditorAction, AXPSignatureEditorOpenOptions, AXPSignatureEditorResult, AXPSpreadsheetCellChangeEvent, AXPSpreadsheetCellValue, AXPSpreadsheetColumn, AXPSpreadsheetConfig, AXPSpreadsheetData, AXPSpreadsheetItem, AXPSpreadsheetRowChangeEvent, AXPSpreadsheetRowMode, AXPStandardSectionFormContext, AXPStandardSectionItemsBuilderConfig, AXPTableColumnDefinition, AXPTableColumnsEditorOpenOptions, AXPTableDataEditorOpenOptions, AXPTemplateViewerConfig, AXPTemplateViewerResult, AXPTextCommandColumnClickEvent, AXPUserAvatarData, AXPUserAvatarProvider, AXPUserAvatarSize, AXPUserAvatarStatus, AXPVirtualKeypadAction, AXPVirtualKeypadKey, AXPVirtualKeypadLook, AXPVirtualKeypadPressEvent, AXPWidgetItemClickEvent, AXPWidgetItemData, AXPWidgetPropertiesChangedEvent, AXPWidgetPropertyInjection, AXPWidgetPropertyViewerConfig, AXPWidgetPropertyViewerResult, ConditionBuilderSelectedField, IAXPPropertyViewerDialogBuilder, IAXPPropertyViewerRoot, IAXPWidgetPropertyViewerDialogBuilder, IAXPWidgetPropertyViewerRoot, ItemConfiguratorListItem, StateMode };

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

@@ -1825,14 +1825,16 @@ declare const layoutOrderingMiddlewareProvider: AXPEntityModifierProvider;
 /**
  * Provides synchronous access to the ApplyLayoutOrdering setting.
  * Used by layout ordering middleware to avoid async in the modifier and prevent startup deadlocks.
- * Value is updated on onLoaded/onChanged; first read can trigger a one-time background get (no await).
+ * Reads from the settings in-memory cache when available; refreshes entity definitions when the value changes.
  */
 declare class AXPLayoutOrderingConfigService {
     private readonly settingsService;
+    private readonly entityRegistry;
     private readonly _applyOrdering;
-    private syncScheduled;
+    private asyncWarmupScheduled;
     constructor();
     getApplyOrdering(): boolean;
+    private handleSettingsEvent;
     private syncFromSettings;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutOrderingConfigService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutOrderingConfigService>;

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

@@ -243,6 +243,11 @@ declare abstract class AXPDataListWidgetComponent extends AXPValueWidgetComponen
     private lastStringDataSourceRef;
     private buildRegistryQueryOptions;
     private rf;
+    /**
+     * Registry datasources are cached globally; each widget needs its own {@link AXDataSource}
+     * instance so per-widget filters (e.g. cascade parent id) do not leak across fields.
+     */
+    private isolateRegistryDataSource;
     /** Invalidates cached registry datasource and forces a reload on the next effect run. */
     protected refreshRegistryDataSource(): void;
     protected extractItem(item: unknown): Promise<any>;

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

@@ -5,6 +5,7 @@ import * as _angular_core from '@angular/core';
 import { OnInit, WritableSignal, InjectionToken, EventEmitter, Signal, AfterViewInit, OnDestroy, ElementRef, ChangeDetectorRef, ComponentRef } from '@angular/core';
 import * as _acorex_platform_contracts from '@acorex/platform/contracts';
 import { AXPWidgetNode, AXPContextChangeEvent, AXPFilterClause, AXPFilterDefinition, AXPValidationRule, AXPAddressMode, AXPAddressLabel, AXPAddressData, AXPFileListItem, AXPIntegrationProviderListItemDto, AXPSafeIntegrationConnectionDto, AXPStatusDefinition, AXPStatusTransition, AXPStatusProvider, AXPMultiLanguageString, AXPActionMenuItem } from '@acorex/platform/contracts';
+import * as _acorex_cdk_common from '@acorex/cdk/common';
 import { AXValueChangedEvent, AXDataSourceFilterOption, AXStyleColorType, AXClickEvent, AXStyleLookType, AXDataSource, AXDirection, AXButtonClickEvent, AXOrientation } from '@acorex/cdk/common';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXPDeviceService, AXPTag, AXPExpressionEvaluatorService, AXPDataSourceDefinition } from '@acorex/platform/core';
@@ -1622,6 +1623,7 @@ declare class AXPSelectBoxWidgetColumnComponent extends AXPColumnWidgetComponent
 
 declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent {
     #private;
+    private static readonly emptyDataSource;
     private selectBox;
     protected widgetsConfigs: StrategyConfig;
     private readonly filterOperatorMiddleware;
@@ -1630,6 +1632,9 @@ declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent
     private readonly destroyRef;
     /** Toggled to force ax-select-box to re-render after locale / language changes. */
     protected readonly selectBoxKey: _angular_core.WritableSignal<boolean>;
+    /** Registry list query runs only after the user interacts (not on form mount). */
+    private readonly listLoadEnabled;
+    private readonly isLazyRegistrySelect;
     private readonly selectBoxLocaleChanged;
     /**
      * Expose configuration similar to lookup widget. Can be:
@@ -1650,6 +1655,19 @@ declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent
     protected isItemTruncated: _angular_core.Signal<boolean>;
     protected filter: _angular_core.Signal<AXDataSourceFilterOption>;
     protected filterMode: _angular_core.Signal<boolean>;
+    /**
+     * True when a cascade/parent filter is configured but required values are still empty
+     * (e.g. state select before country is chosen).
+     */
+    protected hasPendingCascadeFilter: _angular_core.Signal<boolean>;
+    /**
+     * Registry-backed selects defer list loading until the user opens the dropdown.
+     * Existing values are still resolved via `byKey` in the base widget.
+     */
+    protected shouldDeferListLoad: _angular_core.Signal<boolean>;
+    /** Only swap datasource when cascade parent is missing; defer load via patched `load` instead. */
+    protected effectiveDataSource: _angular_core.Signal<_acorex_cdk_common.AXDataSource<any>>;
+    protected isSelectBoxDisabled: _angular_core.Signal<boolean>;
     /** For filter mode: display valueField from object to avoid [object Object] when value is stored as full item */
     protected selectFilterDisplayValue: _angular_core.Signal<any>;
     /**
@@ -1681,7 +1699,18 @@ declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent
      */
     private syncExposePathsToSavedBaseline;
     protected handleSearchValueChange(e: AXValueChangedEvent): void;
+    /** Normalized, middleware-ready filter for the current widget options (or null). */
+    private resolveActiveWidgetFilter;
+    /**
+     * Patches registry `load` to defer list fetch until the user opens the dropdown.
+     * Filtering is handled via {@link #filterEffect} on the datasource (lookup-select pattern).
+     */
+    private patchRegistryDataSourceLoad;
     refresh(): void;
+    /** Push the current widget filter onto the isolated datasource. */
+    private applyActiveFilterToDataSource;
+    /** Allow the patched datasource `load` before the dropdown panel opens. */
+    protected enableListLoad(): void;
     /** Re-mount ax-select-box so translate pipe picks up the active locale. */
     private rerenderSelectBox;
     clear(): void;
@@ -1695,6 +1724,11 @@ declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent
      * Return a single value for single-select, or the full list for multi-select
      */
     private singleOrMultiple;
+    /**
+     * Normalizes filter payloads for datasource queries: unwraps filter-mode values and
+     * reduces selected row objects to scalar keys (default `id`).
+     */
+    private normalizeDataSourceFilter;
     /**
      * In filterMode, widget context stores values as `{ value, operation, displayText }`.
      * DataSource filtering expects the raw scalar/array value, so unwrap `value.value`.