@acorex/platform 20.9.9 → 20.9.10

package/package.json

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