@quadrel-enterprise-ui/framework 20.4.1 → 20.6.0

package/index.d.ts

@@ -17,7 +17,7 @@ import { Highlightable, ActiveDescendantKeyManager } from '@angular/cdk/a11y';
 import * as i39 from 'ngx-editor';
 import { Editor, Toolbar } from 'ngx-editor';
 import { Moment as Moment$1 } from 'moment';
-import * as i24 from '@ngrx/store';
+import * as i25 from '@ngrx/store';
 import * as i5$1 from '@angular/cdk/stepper';
 import { CdkStep, CdkStepper, StepState, CdkStepHeader } from '@angular/cdk/stepper';
 import * as rxjs_internal_scheduler_AsyncScheduler from 'rxjs/internal/scheduler/AsyncScheduler';
@@ -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.
      *
@@ -10904,6 +10941,7 @@ declare class QdFilterItemSelectCategoryComponent implements OnInit {
     filterId: string;
     categoryIndex: number;
     testId: string;
+    popoverDirective: QdPopoverOnClickDirective;
     open: boolean;
     type: 'singleSelect' | 'multiSelect';
     i18n: string;
@@ -10911,14 +10949,17 @@ declare class QdFilterItemSelectCategoryComponent implements OnInit {
     items: QdFilterItem[];
     dependsOn: string[];
     showSelectButton$: Observable<boolean>;
+    positionStrategy: ConnectedPosition[];
+    maxFlyoutHeight: number;
     private _destroyRef;
-    handleClickClose($event: MouseEvent): void;
     get closeButton(): boolean;
     get buttonClassName(): string;
-    get categoryClassName(): string;
+    get layerContentClassName(): string;
     get filterCategoryValue$(): Observable<string>;
     ngOnInit(): void;
-    toggleLayer(): void;
+    onLayerOpened(): void;
+    onLayerClosed(): void;
+    closeLayer(): void;
     close(itemIndex: string): void;
     changeValue($event: string): void;
     private initCategorySubscription;
@@ -10969,7 +11010,7 @@ declare class QdFilterItemSingleSelectComponent implements OnInit, OnDestroy {
 
 declare class QdFilterModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdFilterModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFilterModule, [typeof LocaleDatePipe, typeof QdFilterComponent, typeof QdFilterCategoryComponent, typeof QdFilterCategoryBooleanComponent, typeof QdFilterItemBooleanComponent, typeof QdFilterItemDateCategoryComponent, typeof QdFilterItemDateComponent, typeof QdFilterItemDateRangeCategoryComponent, typeof QdFilterItemDateRangeComponent, typeof QdFilterItemFreeTextCategoryComponent, typeof QdFilterItemFreeTextComponent, typeof QdFilterItemSelectCategoryComponent, typeof QdFilterItemMultiSelectComponent, typeof QdFilterItemSingleSelectComponent], [typeof i2.CommonModule, typeof i31.FormsModule, typeof i5.TranslateModule, typeof QdButtonModule, typeof QdChipModule, typeof QdCoreModule, typeof QdFormModule, typeof QdIconModule, typeof QdTooltipModule, typeof i24.StoreFeatureModule], [typeof QdFilterComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdFilterModule, [typeof LocaleDatePipe, typeof QdFilterComponent, typeof QdFilterCategoryComponent, typeof QdFilterCategoryBooleanComponent, typeof QdFilterItemBooleanComponent, typeof QdFilterItemDateCategoryComponent, typeof QdFilterItemDateComponent, typeof QdFilterItemDateRangeCategoryComponent, typeof QdFilterItemDateRangeComponent, typeof QdFilterItemFreeTextCategoryComponent, typeof QdFilterItemFreeTextComponent, typeof QdFilterItemSelectCategoryComponent, typeof QdFilterItemMultiSelectComponent, typeof QdFilterItemSingleSelectComponent], [typeof i2.CommonModule, typeof i31.FormsModule, typeof i5.TranslateModule, typeof QdButtonModule, typeof QdChipModule, typeof QdCoreModule, typeof QdFormModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdTooltipModule, typeof i25.StoreFeatureModule], [typeof QdFilterComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdFilterModule>;
 }
 
@@ -13796,7 +13837,7 @@ declare class QdSectionToolbarActionComponent implements OnInit, OnDestroy {
 
 declare class QdSearchModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdSearchModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdSearchModule, [typeof QdSearchComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i24.StoreFeatureModule, typeof QdButtonModule, typeof QdFormModule, typeof QdIconModule, typeof QdTooltipModule], [typeof QdSearchComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdSearchModule, [typeof QdSearchComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i25.StoreFeatureModule, typeof QdButtonModule, typeof QdFormModule, typeof QdIconModule, typeof QdTooltipModule], [typeof QdSearchComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdSearchModule>;
 }
 
@@ -13901,6 +13942,7 @@ interface QdTableState<T extends string> {
     requestState?: QdTableRequestState;
     connectors?: QdTableConnector[];
     connectorCriteria?: QdTableConnectorCriteria;
+    lastVisitedRowIdentifier?: QdTableRowIdentifier;
 }
 interface QdTablePaginatorCurrentPage {
     start: number;
@@ -14188,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.
      *
@@ -14605,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>;
@@ -14756,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;
@@ -14764,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 {
@@ -15013,13 +15062,13 @@ declare class QdTreeRowActionsSecondaryMenuComponent<T extends string> implement
 
 declare class QdTreeModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdTreeModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdTreeModule, [typeof QdTreeComponent, typeof QdTreeHeadComponent, typeof QdTreeBodyComponent, typeof QdTreeRowComponent, typeof QdTreeEmptyStateComponent, typeof QdTreeRowActionsSecondaryMenuComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i24.StoreFeatureModule, typeof QdButtonModule, typeof QdChipModule, typeof QdDataFacetsModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdStatusIndicatorModule, typeof QdSpinnerModule, typeof QdTooltipModule], [typeof QdTreeComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdTreeModule, [typeof QdTreeComponent, typeof QdTreeHeadComponent, typeof QdTreeBodyComponent, typeof QdTreeRowComponent, typeof QdTreeEmptyStateComponent, typeof QdTreeRowActionsSecondaryMenuComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i25.StoreFeatureModule, typeof QdButtonModule, typeof QdChipModule, typeof QdDataFacetsModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdStatusIndicatorModule, typeof QdSpinnerModule, typeof QdTooltipModule], [typeof QdTreeComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdTreeModule>;
 }
 
 declare class QdTableModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<QdTableModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<QdTableModule, [typeof QdScrollToPaginationDirective, typeof QdTableBodyComponent, typeof QdTableComponent, typeof QdTableEmptyStateComponent, typeof QdTableHeadComponent, typeof QdTablePaginatorComponent, typeof QdTablePaginatorPageSizeComponent, typeof QdTablePaginatorPageSizeDirective, typeof QdTableRowActionsSecondaryMenuComponent, typeof QdTableRowComponent, typeof QdTableRowSelectionComponent, typeof QdTableSortComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i24.StoreFeatureModule, typeof QdButtonModule, typeof QdChipModule, typeof QdDataFacetsModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdStatusIndicatorModule, typeof QdSpinnerModule, typeof QdTooltipModule, typeof QdTreeModule], [typeof QdTableComponent, typeof QdTreeComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<QdTableModule, [typeof QdScrollToPaginationDirective, typeof QdTableBodyComponent, typeof QdTableComponent, typeof QdTableEmptyStateComponent, typeof QdTableHeadComponent, typeof QdTablePaginatorComponent, typeof QdTablePaginatorPageSizeComponent, typeof QdTablePaginatorPageSizeDirective, typeof QdTableRowActionsSecondaryMenuComponent, typeof QdTableRowComponent, typeof QdTableRowSelectionComponent, typeof QdTableSortComponent], [typeof i2.CommonModule, typeof i5.TranslateModule, typeof i25.StoreFeatureModule, typeof QdButtonModule, typeof QdChipModule, typeof QdDataFacetsModule, typeof QdIconModule, typeof QdPopoverModule, typeof QdStatusIndicatorModule, typeof QdSpinnerModule, typeof QdTooltipModule, typeof QdTreeModule], [typeof QdTableComponent, typeof QdTreeComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<QdTableModule>;
 }
 

package/package.json

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

package/src/assets/styles/components/_components.all.scss

@@ -1,3 +1,4 @@
 @use "components.button";
+@use "components.filter" as components4;
 @use "components.dialog" as components2;
 @use "components.grid" as components3;

package/src/assets/styles/components/_components.filter.scss

@@ -0,0 +1,52 @@
+@use "../settings/settings.verticalRythm" as settings2;
+@use "../tools/tools.convertPxToRem" as tools;
+@use "../../../lib/filter/shared/filter.constants" as filter;
+
+.qd-filter__category-layer {
+  min-width: tools.to-rem(260);
+  max-width: tools.to-rem(900);
+  padding: settings2.$vertical-spacing-default 0 0;
+  border: filter.$filter-border-width solid filter.$filter-open-border-color;
+  background: white;
+  box-shadow: filter.$filter-category-box-shadow-color filter.$filter-category-box-shadow-size;
+
+  .qd-filter-form-items__filter {
+    margin-bottom: 0;
+  }
+
+  .qd-checkbox__label {
+    display: flex;
+    height: filter.$filter-item-line-height;
+  }
+
+  .qd-checkbox__indicator,
+  .qd-radio-buttons__indicator {
+    transform: translateY(-(tools.to-rem(1)));
+  }
+}
+
+.qd-filter__category-layer-items {
+  max-height: filter.$filter-flyout-items-max-height-no-search;
+  overflow-y: auto;
+}
+
+.qd-filter__category-layer--has-search .qd-filter__category-layer-items {
+  max-height: filter.$filter-flyout-items-max-height-with-search;
+}
+
+.qd-filter__category-layer-container {
+  position: relative;
+}
+
+.qd-filter__category-layer-close {
+  position: absolute;
+  top: settings2.$vertical-spacing-default;
+  right: filter.$filter-category-layer-horizontal-margin;
+  color: filter.$filter-button-color;
+  cursor: pointer;
+
+  &:hover,
+  &:focus {
+    color: filter.$filter-button-hover-color;
+  }
+}