@quadrel-enterprise-ui/framework 20.5.0 → 20.6.0

package/index.d.ts

@@ -1524,6 +1524,19 @@ interface QdTablePrimaryAction<T extends string> {
      * @description Refresh configuration for the table after the action completes.
      */
     refresh?: QdTableRefreshConfig;
+    /**
+     * @description Highlights the visited row when the user returns to the table.
+     *
+     * When enabled, the table remembers which row triggered this action.
+     * Upon revisiting the table, that row is briefly highlighted to help the user regain orientation.
+     *
+     * **Requirements:**
+     * - A `uid` must be set on the table configuration to persist the state across navigation.
+     * - Set `trackRowBy` on the table config or provide a `uid` on each row for reliable identification.
+     *
+     * @default false
+     */
+    highlightOnRevisit?: boolean;
 }
 /**
  * @description Defines a secondary action that is shown in the menu. Can be disabled.
@@ -1553,6 +1566,19 @@ interface QdTableSecondaryAction<T extends string> {
      * @description Refresh configuration for the table after the action completes.
      */
     refresh?: QdTableRefreshConfig;
+    /**
+     * @description Highlights the visited row when the user returns to the table.
+     *
+     * When enabled, the table remembers which row triggered this action.
+     * Upon revisiting the table, that row is briefly highlighted to help the user regain orientation.
+     *
+     * **Requirements:**
+     * - A `uid` must be set on the table configuration to persist the state across navigation.
+     * - Set `trackRowBy` on the table config or provide a `uid` on each row for reliable identification.
+     *
+     * @default false
+     */
+    highlightOnRevisit?: boolean;
     /**
      * @description Controls in which operation mode this action is shown. May be set by the Quadrel Framework ('edit' or 'view').
      *
@@ -1603,8 +1629,8 @@ interface QdTableConfigSelection<T extends string> {
      */
     type?: QdTableConfigSelectionType;
     /**
-     * @description Configure the rows that are initially selected. You can indicate a row by its uid or its index.
-     * The uids can be defined in the table data row objects.
+     * @description Configure the rows that are initially selected.
+     * Rows can be identified by the `trackRowBy` function result, `uid`, or index.
      *
      * * @default: []
      */
@@ -3981,6 +4007,17 @@ interface QdTableConfig<T extends string> {
      * additional events to ensure that the displayed data remains up-to-date.
      */
     refreshingEvents?: QdTableOptionalRefreshingEventTypes[];
+    /**
+     * @description Specifies a function to derive the row identity for features like selection and highlightOnRevisit.
+     *
+     * When set, the function is called with the row data to produce a unique identifier.
+     * The returned value **must be unique** across all rows in the table.
+     *
+     * Fallback chain: `trackRowBy(row)` → `row.uid` → `rowIndex`
+     *
+     * @example trackRowBy: row => row.reference
+     */
+    trackRowBy?: (row: QdTableDataRow<T>) => string | number;
     /**
      * @description Sets a unique identifier for the table. Used as key to hold in NgRx store.
      *
@@ -13905,6 +13942,7 @@ interface QdTableState<T extends string> {
     requestState?: QdTableRequestState;
     connectors?: QdTableConnector[];
     connectorCriteria?: QdTableConnectorCriteria;
+    lastVisitedRowIdentifier?: QdTableRowIdentifier;
 }
 interface QdTablePaginatorCurrentPage {
     start: number;
@@ -14192,6 +14230,7 @@ declare class QdTableComponent<T extends string> implements OnInit, OnChanges, O
     private initRefresh;
     private triggerRefresh;
     private validateConfig;
+    private hasHighlightOnRevisit;
     /**
      * @description Can be deleted when the property "mainColumnNotFillingWidth" is dropped.
      *
@@ -14609,17 +14648,22 @@ declare class QdScrollToPaginationDirective<T extends string> implements OnInit,
     static ɵdir: i0.ɵɵDirectiveDeclaration<QdScrollToPaginationDirective<any>, "[qdScrollToPagination]", never, {}, {}, never, never, false, never>;
 }
 
-declare class QdTableBodyComponent<T extends string> implements OnDestroy {
+declare class QdTableBodyComponent<T extends string> implements OnInit, OnDestroy {
     private tableStoreService;
     private resolverService;
+    private cdr;
     config: QdTableConfig<T>;
     data: QdTableDataRow<T>[];
     testId?: string;
     isLoading$: Observable<boolean>;
+    highlightedRowIdentifier: QdTableRowIdentifier | undefined;
     private _primaryActionRefreshSubscription?;
     constructor();
+    ngOnInit(): void;
     ngOnDestroy(): void;
+    isLastVisitedRow(rowData: QdTableDataRow<T>, rowIndex: number): boolean;
     primaryAction(rowData: QdTableDataRow<T>, index: number): void;
+    private initHighlight;
     private triggerRefresh;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdTableBodyComponent<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<QdTableBodyComponent<any>, "[qd-table-body]", never, { "config": { "alias": "config"; "required": false; }; "data": { "alias": "data"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, {}, never, never, false, never>;
@@ -14760,6 +14804,7 @@ declare class QdTableRowComponent<T extends string> implements OnInit {
 declare class QdTableRowSelectionComponent<T extends string> {
     private rowSelectionService;
     rowIndex: QdTableRowIndex;
+    rowData: QdTableDataRow<T>;
     testId: string;
     get dataTestId(): string;
     get selectionType(): string;
@@ -14768,7 +14813,7 @@ declare class QdTableRowSelectionComponent<T extends string> {
     stopPropagation(event: Event): void;
     handleChange(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<QdTableRowSelectionComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<QdTableRowSelectionComponent<any>, "[qd-table-row-selection]", never, { "rowIndex": { "alias": "rowIndex"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QdTableRowSelectionComponent<any>, "[qd-table-row-selection]", never, { "rowIndex": { "alias": "rowIndex"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; "testId": { "alias": "data-test-id"; "required": false; }; }, {}, never, never, false, never>;
 }
 
 declare class QdTableSortComponent<T extends string> implements OnInit, OnDestroy {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quadrel-enterprise-ui/framework",
-  "version": "20.5.0",
+  "version": "20.6.0",
   "exports": {
     "./jest-preset": "./jest-preset.js",
     "./package.json": {