@acorex/platform 20.9.37 → 20.9.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "20.9.37",
+  "version": "20.9.39",
   "peerDependencies": {
     "@acorex/cdk": "^19.0.0 || ^20.0.0 || ^22.0.0-next.0 || ^22.0.0-next.0",
     "@acorex/core": "^19.0.0 || ^20.0.0 || ^22.0.0-next.0 || ^22.0.0-next.0",

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

@@ -173,7 +173,11 @@ interface AXPEntityDisplayField {
         options?: Record<string, any>;
     };
     options?: {
-        /** When string, evaluate against parent detail context (e.g. related list). */
+        /**
+         * When string, evaluate as an expression:
+         * - master list: list scope (`list.view()`, `list.views()`, `context.eval(...)`)
+         * - related list: parent detail context
+         */
         visible?: boolean | string;
         /** Optional dataPath override for field binding. */
         dataPath?: string;
@@ -286,6 +290,10 @@ interface AXPQueryView {
     name: string;
     fixed: boolean;
     title: string;
+    /**
+     * Whitelist of entity column names for this view.
+     * Empty array = show all entity columns (still subject to each column's `options.visible`).
+     */
     columns: string[];
     conditions: AXPQueryFilter[];
     sorts: AXPQuerySort[];
@@ -974,10 +982,11 @@ declare function resolveLookupWidgetCreateOptions(options: {
     allowCreate?: 'none' | 'full' | 'quick';
 }): ResolvedLookupCreateOptions;
 
-/** Prefix for related-entity sidebar list widget nodes (`page-list` layout). */
+/** Prefix for related-entity sidebar list widget nodes and page ids (`page-list` layout). */
 declare const PAGE_LIST_WIDGET_NAME_PREFIX = "page-list-";
 /**
- * Builds a unique entity-list widget name for a related-entity `page-list` sidebar page.
+ * Builds a unique id/name for a related-entity `page-list` sidebar page (widget node + details `page` query).
+ * Must not equal the host overview page id (`entity.name`) so self-referential related lists can navigate.
  * Mirrors the `tab-list` pattern (`${entity}-tab-list`).
  */
 declare function buildPageListWidgetName(relatedEntityKey: string): string;

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

@@ -908,9 +908,18 @@ declare class AXPEntityMasterListViewModel {
     private allAvailableColumns;
     visibleColumnCount: () => number;
     columns: _angular_core.WritableSignal<AXPEntityListViewColumnViewModel[]>;
-    resetColumns(): void;
+    resetColumns(): Promise<void>;
     onColumnsChanged(columns: AXPEntityListViewColumnViewModel[]): Promise<void>;
-    applyViewColumns(): void;
+    /**
+     * Builds list columns for the active view:
+     * - `view.columns` is a whitelist (empty = all columns)
+     * - string `options.visible` is evaluated against the master-list scope
+     */
+    applyViewColumns(): Promise<void>;
+    /**
+     * Resolves column `options.visible` (boolean or expression) to a boolean for the current list scope.
+     */
+    private resolveColumnVisibleExpression;
     onColumnsOrderChanged(event: any): void;
     private mergeDisplayFieldWithColumn;
     private buildVirtualDisplayProperty;
@@ -2777,6 +2786,12 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
     protected selectedItems: _angular_core.WritableSignal<any[]>;
     protected toolbarNode: _angular_core.WritableSignal<AXPWidgetNode | null>;
     protected destroyed: Subject<void>;
+    /** Invalidates in-flight filter/refresh work on remount, rapid page switches, or destroy. */
+    private opGeneration;
+    private isViewDestroyed;
+    private initListTimeoutId;
+    /** Unpatched data-list refresh (hits the grid). Prefer this over the scoped patch to avoid recursion. */
+    private boundDataListRefresh;
     protected entitySource: _angular_core.Signal<any>;
     protected excludeColumns: _angular_core.Signal<string[]>;
     protected includeColumns: _angular_core.Signal<string[]>;
@@ -2805,6 +2820,7 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
     /**
      * Route `filters` apply only when the active details `page` matches this list's entity
      * (e.g. WorkOrder filters must not affect FailureRegister on the same asset layout).
+     * page-list sidebar pages use `page-list-{module.entity}` as their page id.
      */
     private shouldApplyRouteFilters;
     /**
@@ -2812,17 +2828,33 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
      */
     private mergeToolbarFilters;
     private getMergedToolbarFilters;
+    private beginOp;
+    private isOpStale;
+    private delay;
     /**
      * Applies merged route + parent-scope filters to the widget value and data source.
      */
     private applyMergedRouteFiltersToList;
-    /** Syncs toolbar filters to context and AXDataSource (retries until data-list is mounted). */
+    /**
+     * Syncs toolbar filters to context and AXDataSource (retries until data-list is mounted).
+     * Stale generations (destroy / newer op) exit without touching the grid.
+     */
     private reapplyScopedFiltersToDataSource;
     /**
      * Entity lists use `fetchDataMode: 'manual'`; after scoped filters reach the data source,
-     * the grid must be refreshed once (initial #effect may run before the data-list is ready).
+     * the grid must be refreshed once. Retries until the data-table view child accepts refresh
+     * so rapid relatedEntity page switches cannot leave the table on "no data loaded yet".
      */
     private triggerInitialLoadIfNeeded;
+    /**
+     * Calls the unpatched data-list refresh until the grid is ready or the op is stale.
+     */
+    private refreshWhenGridReady;
+    /**
+     * Prefer the bound original refresh (pre-patch). Falls back to an unpatched instance refresh.
+     */
+    private resolveDataListRefresh;
+    private refreshWhenGridReadyWith;
     /**
      * Re-evaluates related-entity list filters from the live dialog form context (e.g. after create saves the main row id).
      */
@@ -2845,6 +2877,10 @@ declare class AXPEntityListWidgetViewComponent extends AXPValueWidgetComponent {
      * Refreshes the embedded data list (toolbar / workflow). In wizard mode, `refresh` is patched to re-apply scoped filters first.
      */
     private refreshGridWithParentScopedFilters;
+    /**
+     * Re-applies parent-scoped filters then refreshes the grid, ignoring stale overlapping calls.
+     */
+    private runScopedDataListRefresh;
     protected queries: undefined;
     /**
      * Validates that all required dependencies are available

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

@@ -1718,9 +1718,17 @@ declare class AXPSelectBoxWidgetEditComponent extends AXPDataListWidgetComponent
     /**
      * Bind resolved row object(s) when available so ax-select-box can render textField labels.
      * Falls back to primitive key(s) while selectedItems are still loading.
+     * In filterMode, prefer stored `displayText` when byKey has not resolved a real label yet.
      * Label translation is handled by ax-select-box (`getDisplayText(item) | translate`).
      */
     protected selectBoxModel: _angular_core.Signal<any>;
+    /** Reads `displayText` from filterMode payload `{ value, operation, displayText }`. */
+    private getFilterDisplayText;
+    /**
+     * Ensures filterMode select shows a label: when selectedItems/byKey only have the raw key
+     * (or are missing), synthesize/enrich the model with stored `displayText`.
+     */
+    private withFilterDisplayText;
     protected searchValue: _angular_core.WritableSignal<string | undefined>;
     private lastDataSource;
     private hasSeenDataSource;
@@ -2487,7 +2495,11 @@ declare class AXPDataListWidgetViewComponent extends AXPValueWidgetComponent<any
         [name: string]: unknown;
     })[];
     api(): AXPWidgetCoreElementAPI;
-    refresh(): void;
+    /**
+     * Returns true when the data-table view child accepted the refresh.
+     * Callers must retry while this is false (grid may not be ready yet after remount).
+     */
+    refresh(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDataListWidgetViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDataListWidgetViewComponent, "axp-data-list-widget-view", never, {}, {}, never, never, true, never>;
 }