@cauca-911/datagrid 21.3.0 → 21.3.1

package/fesm2022/cauca-911-datagrid.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { ViewChild, HostBinding, Input, Optional, ViewEncapsulation, Component, EventEmitter, input, Output, Injectable, InjectionToken, signal, ContentChild, ContentChildren, Inject, ChangeDetectionStrategy, QueryList, inject, output, TemplateRef, forwardRef, computed, model } from '@angular/core';
+import { ViewChild, HostBinding, Input, Optional, ViewEncapsulation, Component, EventEmitter, input, Output, Injectable, InjectionToken, signal, ContentChild, ContentChildren, Inject, ChangeDetectionStrategy, QueryList, inject, output, TemplateRef, DestroyRef, makeEnvironmentProviders, provideAppInitializer, forwardRef, computed, model } from '@angular/core';
 import * as i1 from '@angular/material/table';
 import { MatColumnDef, MatCellDef, MatHeaderCellDef, MatFooterCellDef, MatTable, MatHeaderRowDef, MatFooterRowDef, MatNoDataRow, MatRowDef, MatTableDataSource, MatHeaderCell, MatFooterCell, MatRow, MatHeaderRow, MatFooterRow, MatCell } from '@angular/material/table';
 import { CDK_DRAG_CONFIG, moveItemInArray, CdkDropList, CdkDrag, CdkDragHandle } from '@angular/cdk/drag-drop';
@@ -16,7 +16,7 @@ import { MatInputModule } from '@angular/material/input';
 import { IconButtonComponent, RaisedButtonComponent, BasicButtonComponent, StrokedButtonComponent, MenuItemComponent, StatusMessageComponent, IconComponent, Iso8601TimeSpanPipe } from '@cauca-911/material';
 import * as i1$3 from '@ngx-translate/core';
 import { TranslatePipe } from '@ngx-translate/core';
-import { Subject, debounceTime, takeUntil, BehaviorSubject, of, distinctUntilChanged } from 'rxjs';
+import { Subject, debounceTime, takeUntil, BehaviorSubject, of, distinctUntilChanged, filter } from 'rxjs';
 import { MatSort, MatSortHeader } from '@angular/material/sort';
 import { CdkConnectedOverlay, CdkOverlayOrigin } from '@angular/cdk/overlay';
 import * as i1$4 from '@angular/material/card';
@@ -28,10 +28,11 @@ import { MatMenuModule } from '@angular/material/menu';
 import { NgTemplateOutlet, NgStyle, NgClass, DatePipe } from '@angular/common';
 import * as i1$5 from '@angular/material/progress-spinner';
 import { MatProgressSpinnerModule } from '@angular/material/progress-spinner';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+import { Router, ActivatedRoute, NavigationEnd, RouterLink } from '@angular/router';
 import { ODataDataSource } from 'odata-data-source';
 import * as i1$6 from '@angular/common/http';
 import { MatTooltip } from '@angular/material/tooltip';
-import { RouterLink } from '@angular/router';
 import dayjs from 'dayjs';
 
 class DataGridRowDropEvent {
@@ -821,21 +822,133 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                 }]
         }], ctorParameters: () => [{ type: i1$6.HttpClient }] });
 
+const PARAM_BASE_NAMES = {
+    filter: 'filter',
+    sort: 'sort',
+    direction: 'dir',
+    pageIndex: 'page',
+    pageSize: 'size',
+};
+/**
+ * Builds the query param name for a given base name and optional grid state key.
+ * With a key, the scheme is `<key><CapitalizedBaseName>` (e.g. key "alerts" + base "filter" -> "alertsFilter").
+ * Without a key, the plain base name is used (e.g. "filter").
+ */
+function paramName(baseName, key) {
+    if (!key) {
+        return baseName;
+    }
+    return `${key}${baseName.charAt(0).toUpperCase()}${baseName.slice(1)}`;
+}
+function toQueryParams(state, key = '') {
+    const params = {};
+    if (state.filter) {
+        params[paramName(PARAM_BASE_NAMES.filter, key)] = state.filter;
+    }
+    if (state.sort) {
+        params[paramName(PARAM_BASE_NAMES.sort, key)] = state.sort;
+    }
+    if (state.direction) {
+        params[paramName(PARAM_BASE_NAMES.direction, key)] = state.direction;
+    }
+    if (state.pageIndex) {
+        params[paramName(PARAM_BASE_NAMES.pageIndex, key)] = state.pageIndex;
+    }
+    if (state.pageSize) {
+        params[paramName(PARAM_BASE_NAMES.pageSize, key)] = state.pageSize;
+    }
+    return params;
+}
+function fromQueryParams(map, key = '') {
+    const state = {};
+    const filter = map.get(paramName(PARAM_BASE_NAMES.filter, key));
+    if (filter) {
+        state.filter = filter;
+    }
+    const sort = map.get(paramName(PARAM_BASE_NAMES.sort, key));
+    if (sort) {
+        state.sort = sort;
+    }
+    const direction = map.get(paramName(PARAM_BASE_NAMES.direction, key));
+    if (direction === 'asc' || direction === 'desc') {
+        state.direction = direction;
+    }
+    const pageIndex = parsePositiveInteger(map.get(paramName(PARAM_BASE_NAMES.pageIndex, key)));
+    if (pageIndex !== undefined) {
+        state.pageIndex = pageIndex;
+    }
+    const pageSize = parsePositiveInteger(map.get(paramName(PARAM_BASE_NAMES.pageSize, key)));
+    if (pageSize !== undefined) {
+        state.pageSize = pageSize;
+    }
+    return state;
+}
+/**
+ * Returns a Params object with every grid-state param name mapped to `null` for the given key.
+ * Combined with `queryParamsHandling: 'merge'`, this lets the grid explicitly clear stale
+ * params (e.g. a previously-set filter) instead of leaving them stuck in the URL.
+ */
+function emptyQueryParams(key = '') {
+    const params = {};
+    Object.values(PARAM_BASE_NAMES).forEach((baseName) => {
+        params[paramName(baseName, key)] = null;
+    });
+    return params;
+}
+function paramsEqual(a, b) {
+    const aKeys = Object.keys(a).filter((paramKey) => a[paramKey] !== null && a[paramKey] !== undefined);
+    const bKeys = Object.keys(b).filter((paramKey) => b[paramKey] !== null && b[paramKey] !== undefined);
+    if (aKeys.length !== bKeys.length) {
+        return false;
+    }
+    return aKeys.every((paramKey) => String(a[paramKey]) === String(b[paramKey]));
+}
+function parsePositiveInteger(value) {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (Number.isNaN(parsed) || parsed < 0) {
+        return undefined;
+    }
+    return parsed;
+}
+
 class OdataGridComponent extends BaseDataGridComponent {
     constructor(translateService, listing) {
         super(translateService, inject(PREFERENCE_SERVICE_TOKEN));
         this.listing = listing;
         this.showTableHeader = input(true, ...(ngDevMode ? [{ debugName: "showTableHeader" }] : []));
+        /** Master switch: when true, the grid's filter/sort/page are synced with the URL query params and restored when returning from a detail page. Off by default. */
+        this.persistState = input(false, ...(ngDevMode ? [{ debugName: "persistState" }] : []));
+        /** Optional prefix for the persisted query params, so two independent grids on the same route don't collide (e.g. "alerts" -> "alertsFilter"). */
+        this.stateKey = input('', ...(ngDevMode ? [{ debugName: "stateKey" }] : []));
         this.showHeader = true;
         this.idField = 'id';
         this.itemClick = new EventEmitter();
         this.refreshRequested = new EventEmitter();
         this.showRefreshButton = false;
         this.baseUrl = inject(CaucaCoreService).getConfig().apiUrl;
+        this.router = inject(Router, { optional: true });
+        this.route = inject(ActivatedRoute, { optional: true });
+        this.destroyRef = inject(DestroyRef);
+        this.lastWrittenParams = {};
     }
     ngOnDestroy() {
         this.listing.destroy();
     }
+    ngAfterViewInit() {
+        if (!this.canPersistState() || !this.header) {
+            return;
+        }
+        if (this.pendingRestoredFilter !== undefined) {
+            this.header.filterControl.setValue(this.pendingRestoredFilter, { emitEvent: false });
+            this.header.showClearButton = !!this.pendingRestoredFilter;
+        }
+        this.header.filterChange
+            .pipe(takeUntilDestroyed(this.destroyRef))
+            .subscribe(() => this.writeCurrentUrlState());
+    }
     refreshData() {
         this.listing.refresh();
         this.refreshRequested.emit();
@@ -856,18 +969,25 @@ class OdataGridComponent extends BaseDataGridComponent {
     }
     refreshFilter() {
         if (this.filterPredicate) {
-            this.listing.updateFilters(this.filterPredicate(toLowerCaseAndWithoutDiacritics(this.header.filterControl?.value)));
+            this.listing.updateFilters(this.filterPredicate(toLowerCaseAndWithoutDiacritics(this.header?.filterControl?.value)));
         }
     }
     setUpFilterPredicate() {
+        let filters = this.filterPredicate?.('') ?? [];
+        if (this.canPersistState()) {
+            filters = this.restoreStateBeforeInitialLoad() ?? filters;
+        }
         this.listing.initialize({
             baseUrl: this.baseUrl,
             resourceName: this.resourceName,
             paginator: this.paginator,
             sort: this.sort,
             initialSort: this.baseSort,
-            filters: this.filterPredicate?.('') ?? [],
+            filters,
         });
+        if (this.canPersistState()) {
+            this.setUpUrlStatePersistence();
+        }
     }
     setUpSort(sort) {
         this.sort = sort;
@@ -900,8 +1020,89 @@ class OdataGridComponent extends BaseDataGridComponent {
         }
         this.allDisplayedColumns.set([...columns]);
     }
+    canPersistState() {
+        return this.persistState() && !!this.router && !!this.route;
+    }
+    restoreStateBeforeInitialLoad() {
+        this.defaultPageSize = this.paginator?.pageSize;
+        const restoredState = fromQueryParams(this.route.snapshot.queryParamMap, this.stateKey());
+        this.applySortAndPage(restoredState);
+        this.pendingRestoredFilter = restoredState.filter;
+        if (restoredState.filter === undefined || !this.filterPredicate) {
+            return undefined;
+        }
+        return this.filterPredicate(toLowerCaseAndWithoutDiacritics(restoredState.filter));
+    }
+    setUpUrlStatePersistence() {
+        this.lastWrittenParams = toQueryParams(fromQueryParams(this.route.snapshot.queryParamMap, this.stateKey()), this.stateKey());
+        this.sort?.sortChange
+            .pipe(takeUntilDestroyed(this.destroyRef))
+            .subscribe(() => this.writeCurrentUrlState());
+        this.paginator?.page
+            .pipe(takeUntilDestroyed(this.destroyRef))
+            .subscribe(() => this.writeCurrentUrlState());
+        this.route.queryParamMap
+            .pipe(takeUntilDestroyed(this.destroyRef))
+            .subscribe((paramMap) => this.reactToExternalUrlStateChange(paramMap));
+    }
+    applySortAndPage(state) {
+        if (state.sort && this.sort) {
+            this.sort.active = state.sort;
+            this.sort.direction = state.direction ?? '';
+        }
+        if (this.paginator) {
+            if (state.pageIndex !== undefined) {
+                this.paginator.pageIndex = state.pageIndex;
+            }
+            if (state.pageSize !== undefined) {
+                this.paginator.pageSize = state.pageSize;
+            }
+        }
+    }
+    currentUrlState() {
+        const pageSize = this.paginator?.pageSize;
+        return {
+            filter: this.header?.filterControl.value || undefined,
+            sort: this.sort?.active || undefined,
+            direction: this.sort?.direction || undefined,
+            pageIndex: this.paginator?.pageIndex,
+            pageSize: pageSize !== undefined && pageSize !== this.defaultPageSize ? pageSize : undefined,
+        };
+    }
+    writeCurrentUrlState() {
+        const params = toQueryParams(this.currentUrlState(), this.stateKey());
+        if (paramsEqual(params, this.lastWrittenParams)) {
+            return;
+        }
+        this.lastWrittenParams = params;
+        this.router.navigate([], {
+            relativeTo: this.route,
+            queryParams: { ...emptyQueryParams(this.stateKey()), ...params },
+            queryParamsHandling: 'merge',
+            replaceUrl: true,
+        });
+    }
+    reactToExternalUrlStateChange(paramMap) {
+        const state = fromQueryParams(paramMap, this.stateKey());
+        const params = toQueryParams(state, this.stateKey());
+        if (paramsEqual(params, this.lastWrittenParams)) {
+            return;
+        }
+        this.lastWrittenParams = params;
+        this.applySortAndPage(state);
+        if (this.header) {
+            this.header.filterControl.setValue(state.filter ?? '', { emitEvent: false });
+            this.header.showClearButton = !!state.filter;
+        }
+        if (this.filterPredicate) {
+            this.refreshFilter();
+        }
+        else {
+            this.listing.forceReloadFilter();
+        }
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: OdataGridComponent, deps: [{ token: i1$3.TranslateService }, { token: OdataListingService }], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: OdataGridComponent, isStandalone: true, selector: "cauca-odata-grid", inputs: { showTableHeader: { classPropertyName: "showTableHeader", publicName: "showTableHeader", isSignal: true, isRequired: false, transformFunction: null }, baseSort: { classPropertyName: "baseSort", publicName: "baseSort", isSignal: false, isRequired: false, transformFunction: null }, filterPredicate: { classPropertyName: "filterPredicate", publicName: "filterPredicate", isSignal: false, isRequired: false, transformFunction: null }, showHeader: { classPropertyName: "showHeader", publicName: "showHeader", isSignal: false, isRequired: false, transformFunction: null }, selectedRowId: { classPropertyName: "selectedRowId", publicName: "selectedRowId", isSignal: false, isRequired: false, transformFunction: null }, idField: { classPropertyName: "idField", publicName: "idField", isSignal: false, isRequired: false, transformFunction: null }, showRefreshButton: { classPropertyName: "showRefreshButton", publicName: "showRefreshButton", isSignal: false, isRequired: false, transformFunction: null } }, outputs: { itemClick: "itemClick", refreshRequested: "refreshRequested" }, providers: [OdataListingService], queries: [{ propertyName: "rowDetailTemplate", first: true, predicate: TemplateRef, descendants: true }], viewQueries: [{ propertyName: "paginator", first: true, predicate: MatPaginator, descendants: true, static: true }], usesInheritance: true, usesOnChanges: true, ngImport: i0, template: "@if (showHeader) {\n  <cauca-data-grid-header\n    [disableAddButton]=\"disableAddButton()\"\n    [showRefreshButton]=\"showRefreshButton\" (refreshRequest)=\"refreshData()\"\n    [showAddButton]=\"showAddButton\"\n    [addButtonLabel]=\"addButtonLabel || defaultAddButtonLabel\"\n    (addButtonClick)=\"addButtonClick.emit($event)\" (filterChange)=\"applyFilter($event)\">\n    <ng-content select=\"[filterRow]\" ngProjectAs=\"[filterRow]\" />\n  </cauca-data-grid-header>\n}\n\n<ng-content select=\"[customHeader]\" ngProjectAs=\"[customHeader]\" />\n\n@if (showTableOptions) {\n  <cauca-data-grid-table-options [showColumnViewer]=\"showColumnViewer\" [gridName]=\"resourceName\" (densityChanged)=\"onDensityChanged($event)\" (columnsChanged)=\"onColumnsChanged($event)\" [allColumns]=\"regularColumns\">\n    <ng-content select=\"[customFilter]\" ngProjectAs=\"[customFilter]\" />\n  </cauca-data-grid-table-options>\n}\n\n<div class=\"relative\">\n  <table mat-table [dataSource]=\"listing.dataSource\" aria-describedby=\"Data Grid\" multiTemplateDataRows>\n    @if (showExpandButton()) {\n      <ng-container matColumnDef=\"expand\">\n        <th mat-header-cell *matHeaderCellDef></th>\n        <td mat-cell *matCellDef=\"let row\">\n          <div class=\"align-commands\">\n            <cauca-icon-button (buttonClick)=\"onExpand(row)\" color=\"primary\" class=\"button-icon\" [icon]=\"row === expandedElement() ? 'keyboard_arrow_up' : 'keyboard_arrow_down'\" />\n          </div>\n        </td>\n      </ng-container>\n    }\n\n    <ng-content></ng-content>\n    @if(showTableHeader()) {\n      <tr mat-header-row *matHeaderRowDef=\"allDisplayedColumns(); sticky: true\"></tr>\n    }\n\n    <tr mat-row *matRowDef=\"let row; columns: allDisplayedColumns()\"\n      [class.showClick]=\"itemClick.observers.length > 0\"\n      [class.compact]=\"preference.gridDensity === density.Compact\"\n      [class.standard]=\"preference.gridDensity === density.Standard\"\n      [class.comfortable]=\"preference.gridDensity === density.Comfortable\"\n      [class.selected]=\"selectedRowId === row[idField]\"\n      (click)=\"itemClick.emit(row)\"\n      onkeypress=\"itemClick.emit(row)\">\n    </tr>\n\n    <ng-container matColumnDef=\"expandedDetail\">\n      <td mat-cell *matCellDef=\"let row\" [attr.colspan]=\"allDisplayedColumns().length\">\n        <div class=\"grid-element-detail-wrapper\" [class.grid-element-detail-wrapper-expanded]=\"row === expandedElement()\">\n          <div class=\"grid-element-detail\">\n            @if (row === expandedElement()) {\n              <template [ngTemplateOutlet]=\"rowDetailTemplate\" [ngTemplateOutletContext]=\"{ row: expandedElement() }\"></template>\n            }\n          </div>\n        </div>\n      </td>\n    </ng-container>\n\n    <tr mat-row *matRowDef=\"let row; columns: ['expandedDetail']\" class=\"grid-detail-row\"></tr>\n\n    <ng-container *matNoDataRow>\n      @if(listing.loading() === false) {\n        <ng-container>\n          <tr class=\"mat-row\">\n            @if (listing.error() === false) {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"noData\" />\n              </th>\n            } @else {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"error\" />\n              </th>\n            }\n          </tr>\n        </ng-container>\n      }\n    </ng-container>\n  </table>\n\n  <cauca-data-grid-progress-spiner [useBackground]=\"false\" [isLoading]=\"listing.loading()\" />\n\n</div>\n\n<mat-paginator [hidePageSize]=\"hidePageSize()\" [pageSizeOptions]=\"[5, 10, 25, 50]\" [pageSize]=\"10\" />\n", styles: ["table{width:100%;table-layout:fixed;--mat-table-header-container-height: 52px;--mat-table-footer-container-height: 48px;--mat-table-row-item-container-height: 48px;--mat-table-header-container-height: 56px}.relative{position:relative}.mat-column-expand{width:72px}cauca-data-grid-progress-spiner{left:50%;top:50%;transform:translate(-50%,-50%);position:absolute;z-index:101}tr.mat-mdc-row{transition:background-color .2s ease-out .1s}tr.mat-mdc-row:hover{background:#f5f5f5}tr.mat-mdc-row.selected{background:#249edb14}tr.mat-mdc-row.selected:hover{background:#249edb1a}cauca-data-grid-header{margin:16px}.compact{line-height:48px!important}.standard{line-height:56px!important}.comfortable{line-height:62px!important}.showClick{cursor:pointer}tr.grid-detail-row{height:0}.grid-element-row td{border-bottom-width:0;background-color:#fafafa}.mat-column-expandedDetail{background-color:#fafafa}.grid-element-detail-wrapper{overflow:hidden;display:grid;grid-template-rows:0fr;grid-template-columns:100%;transition:grid-template-rows 225ms cubic-bezier(.4,0,.2,1)}.grid-element-detail-wrapper-expanded{grid-template-rows:1fr}.grid-element-detail{display:flex;min-height:0}\n"], dependencies: [{ kind: "directive", type: NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "component", type: 
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.0", type: OdataGridComponent, isStandalone: true, selector: "cauca-odata-grid", inputs: { showTableHeader: { classPropertyName: "showTableHeader", publicName: "showTableHeader", isSignal: true, isRequired: false, transformFunction: null }, persistState: { classPropertyName: "persistState", publicName: "persistState", isSignal: true, isRequired: false, transformFunction: null }, stateKey: { classPropertyName: "stateKey", publicName: "stateKey", isSignal: true, isRequired: false, transformFunction: null }, baseSort: { classPropertyName: "baseSort", publicName: "baseSort", isSignal: false, isRequired: false, transformFunction: null }, filterPredicate: { classPropertyName: "filterPredicate", publicName: "filterPredicate", isSignal: false, isRequired: false, transformFunction: null }, showHeader: { classPropertyName: "showHeader", publicName: "showHeader", isSignal: false, isRequired: false, transformFunction: null }, selectedRowId: { classPropertyName: "selectedRowId", publicName: "selectedRowId", isSignal: false, isRequired: false, transformFunction: null }, idField: { classPropertyName: "idField", publicName: "idField", isSignal: false, isRequired: false, transformFunction: null }, showRefreshButton: { classPropertyName: "showRefreshButton", publicName: "showRefreshButton", isSignal: false, isRequired: false, transformFunction: null } }, outputs: { itemClick: "itemClick", refreshRequested: "refreshRequested" }, providers: [OdataListingService], queries: [{ propertyName: "rowDetailTemplate", first: true, predicate: TemplateRef, descendants: true }], viewQueries: [{ propertyName: "paginator", first: true, predicate: MatPaginator, descendants: true, static: true }], usesInheritance: true, usesOnChanges: true, ngImport: i0, template: "@if (showHeader) {\n  <cauca-data-grid-header\n    [disableAddButton]=\"disableAddButton()\"\n    [showRefreshButton]=\"showRefreshButton\" (refreshRequest)=\"refreshData()\"\n    [showAddButton]=\"showAddButton\"\n    [addButtonLabel]=\"addButtonLabel || defaultAddButtonLabel\"\n    (addButtonClick)=\"addButtonClick.emit($event)\" (filterChange)=\"applyFilter($event)\">\n    <ng-content select=\"[filterRow]\" ngProjectAs=\"[filterRow]\" />\n  </cauca-data-grid-header>\n}\n\n<ng-content select=\"[customHeader]\" ngProjectAs=\"[customHeader]\" />\n\n@if (showTableOptions) {\n  <cauca-data-grid-table-options [showColumnViewer]=\"showColumnViewer\" [gridName]=\"resourceName\" (densityChanged)=\"onDensityChanged($event)\" (columnsChanged)=\"onColumnsChanged($event)\" [allColumns]=\"regularColumns\">\n    <ng-content select=\"[customFilter]\" ngProjectAs=\"[customFilter]\" />\n  </cauca-data-grid-table-options>\n}\n\n<div class=\"relative\">\n  <table mat-table [dataSource]=\"listing.dataSource\" aria-describedby=\"Data Grid\" multiTemplateDataRows>\n    @if (showExpandButton()) {\n      <ng-container matColumnDef=\"expand\">\n        <th mat-header-cell *matHeaderCellDef></th>\n        <td mat-cell *matCellDef=\"let row\">\n          <div class=\"align-commands\">\n            <cauca-icon-button (buttonClick)=\"onExpand(row)\" color=\"primary\" class=\"button-icon\" [icon]=\"row === expandedElement() ? 'keyboard_arrow_up' : 'keyboard_arrow_down'\" />\n          </div>\n        </td>\n      </ng-container>\n    }\n\n    <ng-content></ng-content>\n    @if(showTableHeader()) {\n      <tr mat-header-row *matHeaderRowDef=\"allDisplayedColumns(); sticky: true\"></tr>\n    }\n\n    <tr mat-row *matRowDef=\"let row; columns: allDisplayedColumns()\"\n      [class.showClick]=\"itemClick.observers.length > 0\"\n      [class.compact]=\"preference.gridDensity === density.Compact\"\n      [class.standard]=\"preference.gridDensity === density.Standard\"\n      [class.comfortable]=\"preference.gridDensity === density.Comfortable\"\n      [class.selected]=\"selectedRowId === row[idField]\"\n      (click)=\"itemClick.emit(row)\"\n      onkeypress=\"itemClick.emit(row)\">\n    </tr>\n\n    <ng-container matColumnDef=\"expandedDetail\">\n      <td mat-cell *matCellDef=\"let row\" [attr.colspan]=\"allDisplayedColumns().length\">\n        <div class=\"grid-element-detail-wrapper\" [class.grid-element-detail-wrapper-expanded]=\"row === expandedElement()\">\n          <div class=\"grid-element-detail\">\n            @if (row === expandedElement()) {\n              <template [ngTemplateOutlet]=\"rowDetailTemplate\" [ngTemplateOutletContext]=\"{ row: expandedElement() }\"></template>\n            }\n          </div>\n        </div>\n      </td>\n    </ng-container>\n\n    <tr mat-row *matRowDef=\"let row; columns: ['expandedDetail']\" class=\"grid-detail-row\"></tr>\n\n    <ng-container *matNoDataRow>\n      @if(listing.loading() === false) {\n        <ng-container>\n          <tr class=\"mat-row\">\n            @if (listing.error() === false) {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"noData\" />\n              </th>\n            } @else {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"error\" />\n              </th>\n            }\n          </tr>\n        </ng-container>\n      }\n    </ng-container>\n  </table>\n\n  <cauca-data-grid-progress-spiner [useBackground]=\"false\" [isLoading]=\"listing.loading()\" />\n\n</div>\n\n<mat-paginator [hidePageSize]=\"hidePageSize()\" [pageSizeOptions]=\"[5, 10, 25, 50]\" [pageSize]=\"10\" />\n", styles: ["table{width:100%;table-layout:fixed;--mat-table-header-container-height: 52px;--mat-table-footer-container-height: 48px;--mat-table-row-item-container-height: 48px;--mat-table-header-container-height: 56px}.relative{position:relative}.mat-column-expand{width:72px}cauca-data-grid-progress-spiner{left:50%;top:50%;transform:translate(-50%,-50%);position:absolute;z-index:101}tr.mat-mdc-row{transition:background-color .2s ease-out .1s}tr.mat-mdc-row:hover{background:#f5f5f5}tr.mat-mdc-row.selected{background:#249edb14}tr.mat-mdc-row.selected:hover{background:#249edb1a}cauca-data-grid-header{margin:16px}.compact{line-height:48px!important}.standard{line-height:56px!important}.comfortable{line-height:62px!important}.showClick{cursor:pointer}tr.grid-detail-row{height:0}.grid-element-row td{border-bottom-width:0;background-color:#fafafa}.mat-column-expandedDetail{background-color:#fafafa}.grid-element-detail-wrapper{overflow:hidden;display:grid;grid-template-rows:0fr;grid-template-columns:100%;transition:grid-template-rows 225ms cubic-bezier(.4,0,.2,1)}.grid-element-detail-wrapper-expanded{grid-template-rows:1fr}.grid-element-detail{display:flex;min-height:0}\n"], dependencies: [{ kind: "directive", type: NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "component", type: 
                 // Material table structure:
                 MatTable, selector: "mat-table, table[mat-table]", exportAs: ["matTable"] }, { kind: "directive", type: MatColumnDef, selector: "[matColumnDef]", inputs: ["matColumnDef"] }, { kind: "directive", type: MatHeaderCell, selector: "mat-header-cell, th[mat-header-cell]" }, { kind: "directive", type: MatHeaderCellDef, selector: "[matHeaderCellDef]" }, { kind: "directive", type: MatCell, selector: "mat-cell, td[mat-cell]" }, { kind: "directive", type: MatCellDef, selector: "[matCellDef]" }, { kind: "component", type: MatHeaderRow, selector: "mat-header-row, tr[mat-header-row]", exportAs: ["matHeaderRow"] }, { kind: "directive", type: MatHeaderRowDef, selector: "[matHeaderRowDef]", inputs: ["matHeaderRowDef", "matHeaderRowDefSticky"] }, { kind: "component", type: MatRow, selector: "mat-row, tr[mat-row]", exportAs: ["matRow"] }, { kind: "directive", type: MatRowDef, selector: "[matRowDef]", inputs: ["matRowDefColumns", "matRowDefWhen"] }, { kind: "directive", type: MatNoDataRow, selector: "ng-template[matNoDataRow]" }, { kind: "component", type: 
                 // Material extras
@@ -927,7 +1128,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                         DataGridProgressSpinerComponent,
                         StatusMessageComponent,
                     ], template: "@if (showHeader) {\n  <cauca-data-grid-header\n    [disableAddButton]=\"disableAddButton()\"\n    [showRefreshButton]=\"showRefreshButton\" (refreshRequest)=\"refreshData()\"\n    [showAddButton]=\"showAddButton\"\n    [addButtonLabel]=\"addButtonLabel || defaultAddButtonLabel\"\n    (addButtonClick)=\"addButtonClick.emit($event)\" (filterChange)=\"applyFilter($event)\">\n    <ng-content select=\"[filterRow]\" ngProjectAs=\"[filterRow]\" />\n  </cauca-data-grid-header>\n}\n\n<ng-content select=\"[customHeader]\" ngProjectAs=\"[customHeader]\" />\n\n@if (showTableOptions) {\n  <cauca-data-grid-table-options [showColumnViewer]=\"showColumnViewer\" [gridName]=\"resourceName\" (densityChanged)=\"onDensityChanged($event)\" (columnsChanged)=\"onColumnsChanged($event)\" [allColumns]=\"regularColumns\">\n    <ng-content select=\"[customFilter]\" ngProjectAs=\"[customFilter]\" />\n  </cauca-data-grid-table-options>\n}\n\n<div class=\"relative\">\n  <table mat-table [dataSource]=\"listing.dataSource\" aria-describedby=\"Data Grid\" multiTemplateDataRows>\n    @if (showExpandButton()) {\n      <ng-container matColumnDef=\"expand\">\n        <th mat-header-cell *matHeaderCellDef></th>\n        <td mat-cell *matCellDef=\"let row\">\n          <div class=\"align-commands\">\n            <cauca-icon-button (buttonClick)=\"onExpand(row)\" color=\"primary\" class=\"button-icon\" [icon]=\"row === expandedElement() ? 'keyboard_arrow_up' : 'keyboard_arrow_down'\" />\n          </div>\n        </td>\n      </ng-container>\n    }\n\n    <ng-content></ng-content>\n    @if(showTableHeader()) {\n      <tr mat-header-row *matHeaderRowDef=\"allDisplayedColumns(); sticky: true\"></tr>\n    }\n\n    <tr mat-row *matRowDef=\"let row; columns: allDisplayedColumns()\"\n      [class.showClick]=\"itemClick.observers.length > 0\"\n      [class.compact]=\"preference.gridDensity === density.Compact\"\n      [class.standard]=\"preference.gridDensity === density.Standard\"\n      [class.comfortable]=\"preference.gridDensity === density.Comfortable\"\n      [class.selected]=\"selectedRowId === row[idField]\"\n      (click)=\"itemClick.emit(row)\"\n      onkeypress=\"itemClick.emit(row)\">\n    </tr>\n\n    <ng-container matColumnDef=\"expandedDetail\">\n      <td mat-cell *matCellDef=\"let row\" [attr.colspan]=\"allDisplayedColumns().length\">\n        <div class=\"grid-element-detail-wrapper\" [class.grid-element-detail-wrapper-expanded]=\"row === expandedElement()\">\n          <div class=\"grid-element-detail\">\n            @if (row === expandedElement()) {\n              <template [ngTemplateOutlet]=\"rowDetailTemplate\" [ngTemplateOutletContext]=\"{ row: expandedElement() }\"></template>\n            }\n          </div>\n        </div>\n      </td>\n    </ng-container>\n\n    <tr mat-row *matRowDef=\"let row; columns: ['expandedDetail']\" class=\"grid-detail-row\"></tr>\n\n    <ng-container *matNoDataRow>\n      @if(listing.loading() === false) {\n        <ng-container>\n          <tr class=\"mat-row\">\n            @if (listing.error() === false) {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"noData\" />\n              </th>\n            } @else {\n              <th class=\"mat-cell data-grid-message\"\n                [attr.colspan]=\"allDisplayedColumns().length\">\n                <cauca-status-message type=\"error\" />\n              </th>\n            }\n          </tr>\n        </ng-container>\n      }\n    </ng-container>\n  </table>\n\n  <cauca-data-grid-progress-spiner [useBackground]=\"false\" [isLoading]=\"listing.loading()\" />\n\n</div>\n\n<mat-paginator [hidePageSize]=\"hidePageSize()\" [pageSizeOptions]=\"[5, 10, 25, 50]\" [pageSize]=\"10\" />\n", styles: ["table{width:100%;table-layout:fixed;--mat-table-header-container-height: 52px;--mat-table-footer-container-height: 48px;--mat-table-row-item-container-height: 48px;--mat-table-header-container-height: 56px}.relative{position:relative}.mat-column-expand{width:72px}cauca-data-grid-progress-spiner{left:50%;top:50%;transform:translate(-50%,-50%);position:absolute;z-index:101}tr.mat-mdc-row{transition:background-color .2s ease-out .1s}tr.mat-mdc-row:hover{background:#f5f5f5}tr.mat-mdc-row.selected{background:#249edb14}tr.mat-mdc-row.selected:hover{background:#249edb1a}cauca-data-grid-header{margin:16px}.compact{line-height:48px!important}.standard{line-height:56px!important}.comfortable{line-height:62px!important}.showClick{cursor:pointer}tr.grid-detail-row{height:0}.grid-element-row td{border-bottom-width:0;background-color:#fafafa}.mat-column-expandedDetail{background-color:#fafafa}.grid-element-detail-wrapper{overflow:hidden;display:grid;grid-template-rows:0fr;grid-template-columns:100%;transition:grid-template-rows 225ms cubic-bezier(.4,0,.2,1)}.grid-element-detail-wrapper-expanded{grid-template-rows:1fr}.grid-element-detail{display:flex;min-height:0}\n"] }]
-        }], ctorParameters: () => [{ type: i1$3.TranslateService }, { type: OdataListingService }], propDecorators: { showTableHeader: [{ type: i0.Input, args: [{ isSignal: true, alias: "showTableHeader", required: false }] }], baseSort: [{
+        }], ctorParameters: () => [{ type: i1$3.TranslateService }, { type: OdataListingService }], propDecorators: { showTableHeader: [{ type: i0.Input, args: [{ isSignal: true, alias: "showTableHeader", required: false }] }], persistState: [{ type: i0.Input, args: [{ isSignal: true, alias: "persistState", required: false }] }], stateKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "stateKey", required: false }] }], baseSort: [{
                 type: Input
             }], filterPredicate: [{
                 type: Input
@@ -951,6 +1152,84 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
                 args: [MatPaginator, { static: true }]
             }] } });
 
+/**
+ * Re-injects a list page's remembered grid query params (filter/sort/page, written by
+ * `OdataGridComponent` when `persistState` is enabled) when the user navigates back to that
+ * list page from one of its own descendant (detail) routes. Any other way of reaching the
+ * list page (menu, bookmark, direct link, refresh) leaves it clean, because the previous URL
+ * won't be a descendant of the list path.
+ */
+class GridStateRestorationService {
+    constructor() {
+        this.router = inject(Router);
+        this.rememberedParamsByPath = new Map();
+        this.previousPath = null;
+        this.router.events
+            .pipe(filter((event) => event instanceof NavigationEnd))
+            .subscribe((event) => this.onNavigationEnd(event));
+    }
+    onNavigationEnd(event) {
+        const currentPath = this.pathOnly(event.urlAfterRedirects);
+        const currentParams = this.parseParams(event.urlAfterRedirects);
+        const previousPath = this.previousPath;
+        this.previousPath = currentPath;
+        if (Object.keys(currentParams).length > 0) {
+            this.rememberedParamsByPath.set(currentPath, currentParams);
+            return;
+        }
+        if (this.restoreIfReturningFromDescendant(currentPath, previousPath)) {
+            return;
+        }
+        this.rememberedParamsByPath.delete(currentPath);
+    }
+    restoreIfReturningFromDescendant(currentPath, previousPath) {
+        if (!previousPath || !previousPath.startsWith(`${currentPath}/`)) {
+            return false;
+        }
+        const remembered = this.rememberedParamsByPath.get(currentPath);
+        if (!remembered) {
+            return false;
+        }
+        this.router.navigate([currentPath], { queryParams: remembered, replaceUrl: true });
+        return true;
+    }
+    pathOnly(url) {
+        return url.split('?')[0].split('#')[0];
+    }
+    parseParams(url) {
+        const queryString = url.split('?')[1]?.split('#')[0];
+        if (!queryString) {
+            return {};
+        }
+        const params = {};
+        new URLSearchParams(queryString).forEach((value, key) => {
+            params[key] = value;
+        });
+        return params;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: GridStateRestorationService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: GridStateRestorationService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImport: i0, type: GridStateRestorationService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Activates the grid list-state restoration feature for the whole application. Add this once
+ * in the app's root providers; it has no effect on pages whose grids don't opt in via
+ * `[persistState]="true"`.
+ */
+function provideGridStateRestoration() {
+    return makeEnvironmentProviders([
+        provideAppInitializer(() => {
+            inject(GridStateRestorationService);
+        }),
+    ]);
+}
+
 class ColorDataGridColumnComponent extends BaseGridColumnComponent {
     constructor(odata, grid) {
         super((grid ?? odata)?.table);
@@ -1429,5 +1708,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.0", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { BaseGridColumnComponent, ColorDataGridColumnComponent, DataGridCheckColumnComponent, DataGridColumnComponent, DataGridCommandIconColumnComponent, DataGridCommandsColumnComponent, DataGridComponent, DataGridHeaderComponent, DataGridIconColumnComponent, DataGridMenuColumnComponent, DataGridRowDropEvent, DateGridColumnComponent, Density, GridConfiguration, OdataGridComponent, OdataListingService, PREFERENCE_SERVICE_TOKEN, Preference, SortableDataGridCheckColumnComponent, SortableDataGridColumnComponent, TimeSpanDataGridColumnComponent, TranslationGridColumnComponent, provideCaucaGrid };
+export { BaseGridColumnComponent, ColorDataGridColumnComponent, DataGridCheckColumnComponent, DataGridColumnComponent, DataGridCommandIconColumnComponent, DataGridCommandsColumnComponent, DataGridComponent, DataGridHeaderComponent, DataGridIconColumnComponent, DataGridMenuColumnComponent, DataGridRowDropEvent, DateGridColumnComponent, Density, GridConfiguration, GridStateRestorationService, OdataGridComponent, OdataListingService, PREFERENCE_SERVICE_TOKEN, Preference, SortableDataGridCheckColumnComponent, SortableDataGridColumnComponent, TimeSpanDataGridColumnComponent, TranslationGridColumnComponent, emptyQueryParams, fromQueryParams, paramsEqual, provideCaucaGrid, provideGridStateRestoration, toQueryParams };
 //# sourceMappingURL=cauca-911-datagrid.mjs.map