@acorex/platform 20.9.9 → 20.9.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "20.9.9",
+  "version": "20.9.11",
   "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-core.d.ts

@@ -1869,25 +1869,52 @@ declare class AXHighlightService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXHighlightService>;
 }
 
+/**
+ * Instantiates a class inside an injection context.
+ * Use when a lazy provider manually calls `new` on a nested class that relies on `inject()`.
+ *
+ * @example
+ * ```typescript
+ * export class AXMAuthDataSourceProvider implements AXPDataSourceDefinitionProvider {
+ *   constructor(private readonly injector: Injector) {}
+ *
+ *   async items() {
+ *     const userActivity = instantiateWithInjectionContext(
+ *       this.injector,
+ *       AXMUserActivityDataSourceDefinition,
+ *     );
+ *     return [...(await userActivity.items())];
+ *   }
+ * }
+ * ```
+ */
+declare function instantiateWithInjectionContext<T>(injector: Injector, type: new (injector?: Injector) => T): T;
 /**
  * Creates a provider instance within an injection context.
- * Handles dynamic import, injector resolution, and provider instantiation.
+ * The injector must be captured synchronously from the useFactory injection context.
  *
+ * @param injector - Injector resolved synchronously inside `useFactory`
  * @param loader - Function that returns a promise resolving to the provider class
  * @returns Promise that resolves to the provider instance
  *
  * @example
  * ```typescript
- * useFactory: () => createProviderWithInjectionContext(() =>
- *   import('./settings.provider').then(m => m.AXMSettingProvider)
- * )
+ * useFactory: () => {
+ *   const injector = inject(Injector);
+ *   return createProviderWithInjectionContext(injector, () =>
+ *     import('./settings.provider').then((m) => m.AXMSettingProvider),
+ *   );
+ * }
  * ```
  */
-declare function createProviderWithInjectionContext<T>(loader: () => Promise<new () => T>): Promise<T>;
+declare function createProviderWithInjectionContext<T>(injector: Injector, loader: () => Promise<new (injector?: Injector) => T>): Promise<T>;
 /**
  * Creates a provider configuration for lazy-loaded providers with injection context.
  * Simplifies provider registration in NgModule providers array.
  *
+ * Captures `Injector` synchronously in `useFactory` (before any `await`) so injection
+ * context is reliable after dynamic import and cache rebuilds.
+ *
  * @param token - The injection token to provide
  * @param loader - Function that returns a promise resolving to the provider class
  * @param multi - Optional. Whether the provider is a multi-provider (array of values). Defaults to `true`. Pass `false` for a single provider.
@@ -1909,7 +1936,7 @@ declare function createProviderWithInjectionContext<T>(loader: () => Promise<new
  * )
  * ```
  */
-declare function provideLazyProvider<TProvider>(token: InjectionToken<any>, loader: () => Promise<new () => TProvider>, multi?: boolean): Provider;
+declare function provideLazyProvider<TProvider>(token: InjectionToken<any>, loader: () => Promise<new (injector?: Injector) => TProvider>, multi?: boolean): Provider;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextDefinitionProviderService, AXPContextEvalFactory, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDataSourceQueryService, AXPDblClickDirective, AXPDebugService, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPIdleSchedulerService, AXPImageUrlLogoConfig, AXPKeyboardShortcutRegistry, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPScreenSize, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS, DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS, FORM_DIRTY_TRACE_NS, OVERLAY_DETAILS_VIEW_TRACE_NS, OVERLAY_LAYOUT_TRACE_NS, OVERLAY_ROOT_LAYOUT_TRACE_NS, OVERLAY_WIDGET_SETTLE_TRACE_NS, applyContextEvalPipes, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, chordToKbdItemKeys, contextEvalWithPipes, createProviderWithInjectionContext, defaultColumnWidthProvider, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, isDialogShortcutAllowedInEditableField, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isMacPlatform, isVisibleOverlayElement, matchesDialogActionShortcut, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeContextEvalPipes, normalizeDialogActionShortcutChord, normalizeExpressionTemplate, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseDialogActionShortcut, parseKeyboardShortcutChord, provideLazyProvider, registerPopupFooterKeyboardShortcuts, resolveConfiguredFooterActionShortcuts, resolveDialogActionShortcuts, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolveSemanticDirectionalKey, setupPopupFooterKeyboardShortcuts, shouldDeferEscapeToOpenOverlay, shouldTriggerDialogActionShortcut };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextDefinitionProviderService, AXPContextEvalFactory, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDataSourceQueryService, AXPDblClickDirective, AXPDebugService, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPIdleSchedulerService, AXPImageUrlLogoConfig, AXPKeyboardShortcutRegistry, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPScreenSize, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, DEFAULT_CANCEL_DIALOG_ACTION_SHORTCUTS, DEFAULT_SUBMIT_DIALOG_ACTION_SHORTCUTS, FORM_DIRTY_TRACE_NS, OVERLAY_DETAILS_VIEW_TRACE_NS, OVERLAY_LAYOUT_TRACE_NS, OVERLAY_ROOT_LAYOUT_TRACE_NS, OVERLAY_WIDGET_SETTLE_TRACE_NS, applyContextEvalPipes, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, chordToKbdItemKeys, contextEvalWithPipes, createProviderWithInjectionContext, defaultColumnWidthProvider, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, instantiateWithInjectionContext, isDialogShortcutAllowedInEditableField, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isMacPlatform, isVisibleOverlayElement, matchesDialogActionShortcut, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeContextEvalPipes, normalizeDialogActionShortcutChord, normalizeExpressionTemplate, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseDialogActionShortcut, parseKeyboardShortcutChord, provideLazyProvider, registerPopupFooterKeyboardShortcuts, resolveConfiguredFooterActionShortcuts, resolveDialogActionShortcuts, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolveSemanticDirectionalKey, setupPopupFooterKeyboardShortcuts, shouldDeferEscapeToOpenOverlay, shouldTriggerDialogActionShortcut };
 export type { AXPActivityLog, AXPActivityLogChange, AXPCatalogScopeDefinition, AXPCatalogScopeDefinitionProvider, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContextDefinition, AXPContextDefinitionAiHints, AXPContextDefinitionProvider, AXPContextEvalFn, AXPContextEvalOptions, AXPContextEvalPipe, AXPContextEvalPipeName, AXPContextEvalPipeSpec, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceQueryOptions, AXPDataSourceQueryResult, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDebugData, AXPDebugDataFactory, AXPDebugDataInput, AXPDialogActionOptions, AXPDialogActionShortcut, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPISessionService, AXPIdleSchedulerEnqueueOptions, AXPIdleSchedulerWaitOptions, AXPKeyboardShortcutFormatOptions, AXPKeyboardShortcutRegisterOptions, AXPLazyDataSource, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPPopupFooterKeyboardShortcutsOptions, AXPPopupFooterKeyboardShortcutsSetupConfig, AXPPopupFooterShortcutAction, AXPStartUpTask, AXPTag, AXPTagFilterOptions, AXPValueTransformerFunction, AXPValueTransformerFunctions, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };

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`.