@progress/kendo-angular-grid 24.0.0-develop.19 → 24.0.0-develop.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-grid",
-  "version": "24.0.0-develop.19",
+  "version": "24.0.0-develop.20",
   "description": "Kendo UI Grid for Angular - high performance data grid with paging, filtering, virtualization, CRUD, and more.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -94,7 +94,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1778145745,
+      "publishDate": 1778149554,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -107,32 +107,32 @@
     "@progress/kendo-data-query": "^1.7.3",
     "@progress/kendo-drawing": "^1.25.0",
     "@progress/kendo-licensing": "^1.11.0",
-    "@progress/kendo-angular-buttons": "24.0.0-develop.19",
-    "@progress/kendo-angular-common": "24.0.0-develop.19",
-    "@progress/kendo-angular-dateinputs": "24.0.0-develop.19",
-    "@progress/kendo-angular-layout": "24.0.0-develop.19",
-    "@progress/kendo-angular-navigation": "24.0.0-develop.19",
-    "@progress/kendo-angular-dropdowns": "24.0.0-develop.19",
-    "@progress/kendo-angular-excel-export": "24.0.0-develop.19",
-    "@progress/kendo-angular-icons": "24.0.0-develop.19",
-    "@progress/kendo-angular-indicators": "24.0.0-develop.19",
-    "@progress/kendo-angular-inputs": "24.0.0-develop.19",
-    "@progress/kendo-angular-conversational-ui": "24.0.0-develop.19",
-    "@progress/kendo-angular-intl": "24.0.0-develop.19",
-    "@progress/kendo-angular-l10n": "24.0.0-develop.19",
-    "@progress/kendo-angular-label": "24.0.0-develop.19",
-    "@progress/kendo-angular-menu": "24.0.0-develop.19",
-    "@progress/kendo-angular-pager": "24.0.0-develop.19",
-    "@progress/kendo-angular-pdf-export": "24.0.0-develop.19",
-    "@progress/kendo-angular-popup": "24.0.0-develop.19",
-    "@progress/kendo-angular-toolbar": "24.0.0-develop.19",
-    "@progress/kendo-angular-upload": "24.0.0-develop.19",
-    "@progress/kendo-angular-utils": "24.0.0-develop.19",
+    "@progress/kendo-angular-buttons": "24.0.0-develop.20",
+    "@progress/kendo-angular-common": "24.0.0-develop.20",
+    "@progress/kendo-angular-dateinputs": "24.0.0-develop.20",
+    "@progress/kendo-angular-layout": "24.0.0-develop.20",
+    "@progress/kendo-angular-navigation": "24.0.0-develop.20",
+    "@progress/kendo-angular-dropdowns": "24.0.0-develop.20",
+    "@progress/kendo-angular-excel-export": "24.0.0-develop.20",
+    "@progress/kendo-angular-icons": "24.0.0-develop.20",
+    "@progress/kendo-angular-indicators": "24.0.0-develop.20",
+    "@progress/kendo-angular-inputs": "24.0.0-develop.20",
+    "@progress/kendo-angular-conversational-ui": "24.0.0-develop.20",
+    "@progress/kendo-angular-intl": "24.0.0-develop.20",
+    "@progress/kendo-angular-l10n": "24.0.0-develop.20",
+    "@progress/kendo-angular-label": "24.0.0-develop.20",
+    "@progress/kendo-angular-menu": "24.0.0-develop.20",
+    "@progress/kendo-angular-pager": "24.0.0-develop.20",
+    "@progress/kendo-angular-pdf-export": "24.0.0-develop.20",
+    "@progress/kendo-angular-popup": "24.0.0-develop.20",
+    "@progress/kendo-angular-toolbar": "24.0.0-develop.20",
+    "@progress/kendo-angular-upload": "24.0.0-develop.20",
+    "@progress/kendo-angular-utils": "24.0.0-develop.20",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "24.0.0-develop.19",
+    "@progress/kendo-angular-schematics": "24.0.0-develop.20",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-file-saver": "^1.0.0",
     "@progress/kendo-csv": "^1.0.0"

package/rendering/cell.component.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { DoCheck, TemplateRef } from '@angular/core';
+import { DoCheck, OnInit, OnDestroy, TemplateRef, ElementRef, NgZone, Renderer2 } from '@angular/core';
 import { EditService } from '../editing/edit.service';
 import { CommandColumnComponent } from '../columns/command-column.component';
 import { ColumnComponent } from '../columns/column.component';
@@ -16,22 +16,28 @@ import { DetailsService } from './details/details.service';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { ContextMenuSelectEvent } from '@progress/kendo-angular-menu';
 import { RowPinService } from '../row-pinning/row-pin.service';
+import { ScrollSyncService } from '../scrolling/scroll-sync.service';
 import * as i0 from "@angular/core";
 /**
  * @hidden
  */
-export declare class CellComponent implements DoCheck {
+export declare class CellComponent implements DoCheck, OnInit, OnDestroy {
     private editService;
     private idService;
     private ctx;
     private detailsService;
     private localization;
+    private elementRef;
+    private ngZone;
+    private renderer;
     private rowPinService;
     private cellContext;
     private inPinContainer;
+    private scrollSyncService;
     get commandCellClass(): boolean;
     get dragHandleCellClass(): boolean;
     get dragRowHandleLabel(): string;
+    get rowPinLabel(): string;
     private pinContextMenu;
     private pinContextMenuTarget;
     column: any;
@@ -85,11 +91,17 @@ export declare class CellComponent implements DoCheck {
     private _templateContext;
     private _editTemplateContext;
     private _rowTemplateContext;
-    constructor(editService: EditService, idService: IdService, ctx: ContextService, detailsService: DetailsService, localization: LocalizationService, rowPinService: RowPinService, cellContext: CellContext, inPinContainer: boolean);
+    private keyDownSub;
+    private scrollCloseSub;
+    constructor(editService: EditService, idService: IdService, ctx: ContextService, detailsService: DetailsService, localization: LocalizationService, elementRef: ElementRef, ngZone: NgZone, renderer: Renderer2, rowPinService: RowPinService, cellContext: CellContext, inPinContainer: boolean, scrollSyncService: ScrollSyncService);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
     ngDoCheck(): void;
+    private subscribeToScrollClose;
+    private onHostKeydown;
     isCommand(column: any): column is CommandColumnComponent;
     private isFieldEditable;
     private updateCellContext;
-    static ɵfac: i0.ɵɵFactoryDeclaration<CellComponent, [null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CellComponent, [null, null, null, null, null, null, null, null, { optional: true; }, { optional: true; }, { optional: true; }, { optional: true; }]>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CellComponent, "[kendoGridCell]", never, { "column": { "alias": "column"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "columnIndex": { "alias": "columnIndex"; "required": false; }; "isNew": { "alias": "isNew"; "required": false; }; "isLoading": { "alias": "isLoading"; "required": false; }; "isVirtual": { "alias": "isVirtual"; "required": false; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; }; "detailTemplate": { "alias": "detailTemplate"; "required": false; }; "item": { "alias": "item"; "required": false; }; "rowIndex": { "alias": "rowIndex"; "required": false; }; "dataItem": { "alias": "dataItem"; "required": false; }; }, {}, never, never, true, never>;
 }

package/rendering/list.component.d.ts

@@ -33,6 +33,8 @@ import { ColumnInfoService } from '../common/column-info.service';
 import { GridSize } from '../common/size-options';
 import { ContextService } from '../common/provider.service';
 import { DataMappingService } from '../data/data-mapping.service';
+import { StickyGroupContainerComponent } from '../grouping/sticky-groups/sticky-group-container.component';
+import { StickyGroupsService } from '../grouping/sticky-groups/sticky-groups.service';
 import * as i0 from "@angular/core";
 /**
  * @hidden
@@ -62,6 +64,7 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
     private pdfService;
     private columnInfo;
     private dataMappingService;
+    private stickyGroupsService;
     hostClass: boolean;
     hostRole: string;
     data: Array<any>;
@@ -93,6 +96,15 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
     columnsStartIdx: number;
     allItems: any[];
     itemsToRender: any[];
+    stickyGroupHeaderColumns: any[];
+    private stickyNeedsUpdate;
+    private stickyWasEnabled;
+    private pendingToggleScroll;
+    private skipScrollerAdjust;
+    private suppressStickyUpdates;
+    private suppressFocusScrollAdjust;
+    get hasStickyHeaders(): boolean;
+    get hasStickyFooters(): boolean;
     get showFooter(): boolean;
     get totalWidth(): number;
     container: ElementRef;
@@ -100,6 +112,8 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
     lockedTable: ElementRef;
     table: ElementRef;
     resizeSensors: QueryList<ResizeSensorComponent>;
+    stickyHeaderContainer: StickyGroupContainerComponent;
+    stickyFooterContainer: StickyGroupContainerComponent;
     private scroller;
     private scrollerFactory;
     private subscriptions;
@@ -128,7 +142,7 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
     private minRowHeight;
     private handleSkipOnData;
     private scrollToIndex;
-    constructor(scrollerFactory: any, detailsService: DetailsService, changeNotification: ChangeNotificationService, suspendService: SuspendService, groupsService: GroupsService, ngZone: NgZone, renderer: Renderer2, scrollSyncService: ScrollSyncService, resizeService: ResizeService, editService: EditService, supportService: ScrollbarService, navigationService: NavigationService, scrollRequestService: ScrollRequestService, ctx: ContextService, columnResizingService: ColumnResizingService, changeDetector: ChangeDetectorRef, pdfService: PDFService, columnInfo: ColumnInfoService, dataMappingService: DataMappingService);
+    constructor(scrollerFactory: any, detailsService: DetailsService, changeNotification: ChangeNotificationService, suspendService: SuspendService, groupsService: GroupsService, ngZone: NgZone, renderer: Renderer2, scrollSyncService: ScrollSyncService, resizeService: ResizeService, editService: EditService, supportService: ScrollbarService, navigationService: NavigationService, scrollRequestService: ScrollRequestService, ctx: ContextService, columnResizingService: ColumnResizingService, changeDetector: ChangeDetectorRef, pdfService: PDFService, columnInfo: ColumnInfoService, dataMappingService: DataMappingService, stickyGroupsService: StickyGroupsService);
     ngOnInit(): void;
     ngOnChanges(changes: {
         [propertyName: string]: SimpleChange;
@@ -156,6 +170,13 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
      * @hidden
      */
     fillViewportAfterColumnChange(): void;
+    /**
+     * Recalculates the virtual page size after the scrollable container height changes
+     * due to pinned row containers appearing or disappearing. Expands itemsToRender
+     * if the new viewport can display more rows than currently rendered.
+     * @hidden
+     */
+    onPinnedContainerHeightChange(): void;
     /**
      * Checks if the virtual scroll state is out of sync with the expected position.
      * Used to determine if resetVirtualScroll should be called.
@@ -170,6 +191,50 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
      * @hidden
      */
     get isStacked(): boolean;
+    /**
+     * @hidden
+     * Updates sticky group header columns for the overlay. Called in ngDoCheck or on column changes.
+     */
+    updateStickyGroupHeaderColumns(): void;
+    /**
+     * Measures actual rendered row heights from the DOM and feeds them into
+     * RowHeightService so its offsets reflect reality. Called in ngAfterViewChecked
+     * when stickyNeedsUpdate is true (data changed or scroll-to-group requested).
+     */
+    private updateStickyRowHeights;
+    /**
+     * Handles sticky overlay header click: scrolls to the topmost sticky
+     * group header's real position so all overlay headers become visible
+     * real rows, then toggles the clicked group.
+     */
+    private handleStickyScrollAndToggle;
+    /**
+     * After toggle, fixes up the virtual page so the correct rows are rendered
+     * around the target scroll position that was set pre-toggle.
+     */
+    private applyPendingToggleScroll;
+    /**
+     * Scrolls the container so the real footer row at the pending flat index
+     * is visible at the bottom edge of the viewport.
+     */
+    private scrollToStickyFooterTarget;
+    /**
+     * Scrolls the real grid body until the requested row is rendered in the real
+     * tbody, then focuses the corresponding real grid cell.
+     */
+    private scrollToStickyRowTarget;
+    /**
+     * Focuses the rendered row requested from the sticky overlay.
+     */
+    private focusRenderedStickyRow;
+    private getStickyTargetTbody;
+    private findStickyTargetRow;
+    /**
+     * Converts a sticky overlay flat-index request into a logical grid cell
+     * position that NavigationService can focus.
+     */
+    private stickyTargetToLogicalCell;
+    private updateStickyGroups;
     resetNavigationViewport(): void;
     private detailExpand;
     private attachContainerScroll;
@@ -179,6 +244,7 @@ export declare class ListComponent implements OnInit, OnDestroy, AfterViewInit,
     private handleRowSync;
     private handleRowNavigationLocked;
     private scrollToVirtualRow;
+    private getStickyAdjustedScrollTop;
     private scrollTo;
     private scrollToItem;
     private cleanupScroller;

package/rendering/table-body.component.d.ts

@@ -77,6 +77,7 @@ export declare class TableBodyComponent implements OnInit, OnDestroy, OnChanges,
     hostClass: boolean;
     groupHeaderSlaveCellsCount: number;
     groupHeaderColumns: any[];
+    private cachedDataRows;
     private clickSubscription;
     private touchSubscription;
     private l10nSubscription;

package/row-pinning/pinned-row-tracking.service.d.ts

@@ -0,0 +1,64 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2026 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import * as i0 from "@angular/core";
+/**
+ * Tracks the relationship between pinned rows and their counterparts in the main data table.
+ * Use this service to find the main row index for a given pinned row data item,
+ * or to find the pinned counterpart of a main row.
+ *
+ * The service is updated automatically by the Grid when `pinnedTopRows`, `pinnedBottomRows`,
+ * or `data` changes. For reliable index resolution, pinned row data items must be
+ * reference-equal to the corresponding items in the main data array.
+ *
+ * @hidden
+ */
+export declare class PinnedRowTrackingService {
+    private topIndexMap;
+    private bottomIndexMap;
+    private mainIndexMap;
+    /**
+     * Updates the internal tracking maps based on the current pinned rows and main data.
+     * Called automatically by the Grid when relevant inputs change.
+     *
+     * @param topRows - The array of data items pinned to the top.
+     * @param bottomRows - The array of data items pinned to the bottom.
+     * @param data - The flat main data array for the current page.
+     * @param skip - The current page skip offset used to compute absolute row indices.
+     */
+    update(topRows: any[], bottomRows: any[], data: any[], skip: number): void;
+    /**
+     * Updates the internal tracking maps using a pre-built data-item-to-index map from the main view.
+     * This handles grouping, sorting, and pagination correctly.
+     *
+     * @param topRows - The array of data items pinned to the top.
+     * @param bottomRows - The array of data items pinned to the bottom.
+     * @param dataToIndex - A map from data item references to their absolute row indices in the main view.
+     */
+    updateFromIndexMap(topRows: any[], bottomRows: any[], dataToIndex: Map<any, number>): void;
+    /**
+     * Returns the absolute main row index for a pinned row data item, or `-1` if not found.
+     * The returned index matches the `index` property used by selection and editing services.
+     */
+    getMainRowIndex(dataItem: any): number;
+    /**
+     * Returns `true` if the given data item is currently pinned to the top or bottom.
+     */
+    isRowPinned(dataItem: any): boolean;
+    /**
+     * Returns the pin position (`'top'` or `'bottom'`) for the given data item,
+     * or `null` if the item is not pinned.
+     */
+    getPinnedPosition(dataItem: any): 'top' | 'bottom' | null;
+    /**
+     * Returns the pinned counterpart for a given main row index,
+     * or `null` if the main row has no pinned counterpart.
+     */
+    getPinnedCounterpart(mainIndex: number): {
+        dataItem: any;
+        position: 'top' | 'bottom';
+    } | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PinnedRowTrackingService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PinnedRowTrackingService>;
+}

package/row-pinning/row-pin-container.component.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2026 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { ElementRef, TrackByFunction, QueryList } from '@angular/core';
+import { AfterViewChecked, ElementRef, TrackByFunction, QueryList } from '@angular/core';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { GridItem } from '../data/grid-item.interface';
 import { ColumnsContainer } from '../columns/columns-container';
@@ -11,13 +11,16 @@ import { ColumnBase } from '../columns/column-base';
 import { GroupDescriptor } from '@progress/kendo-data-query';
 import { DetailTemplateDirective } from '../rendering/details/detail-template.directive';
 import { FilterableSettings } from '../filtering/filterable';
+import { GridSize } from '../common/size-options';
 import * as i0 from "@angular/core";
 /**
  * @hidden
  */
-export declare class RowPinContainerComponent {
-    private localization;
+export declare class RowPinContainerComponent implements AfterViewChecked {
+    private readonly localization;
     pinnedWrapper: ElementRef;
+    private readonly lockedTable;
+    private readonly pinnedTable;
     hostClass: boolean;
     get bottomClass(): boolean;
     leafColumns: any[];
@@ -41,8 +44,13 @@ export declare class RowPinContainerComponent {
     groups: Array<GroupDescriptor>;
     detailTemplate: DetailTemplateDirective;
     filterable: FilterableSettings;
+    rowHeight: number;
+    detailRowHeight: number;
+    loading: boolean;
+    size: GridSize;
     constructor(localization: LocalizationService);
+    ngAfterViewChecked(): void;
     get ariaLabel(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<RowPinContainerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RowPinContainerComponent, "kendo-grid-rowpin-container", never, { "leafColumns": { "alias": "leafColumns"; "required": false; }; "lockedLeafColumns": { "alias": "lockedLeafColumns"; "required": false; }; "nonLockedLeafColumns": { "alias": "nonLockedLeafColumns"; "required": false; }; "sort": { "alias": "sort"; "required": false; }; "position": { "alias": "position"; "required": false; }; "rowsToRender": { "alias": "rowsToRender"; "required": false; }; "totalColumns": { "alias": "totalColumns"; "required": false; }; "lockedWidth": { "alias": "lockedWidth"; "required": false; }; "nonLockedWidth": { "alias": "nonLockedWidth"; "required": false; }; "isLocked": { "alias": "isLocked"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "trackBy": { "alias": "trackBy"; "required": false; }; "groups": { "alias": "groups"; "required": false; }; "detailTemplate": { "alias": "detailTemplate"; "required": false; }; "filterable": { "alias": "filterable"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RowPinContainerComponent, "kendo-grid-rowpin-container", never, { "leafColumns": { "alias": "leafColumns"; "required": false; }; "lockedLeafColumns": { "alias": "lockedLeafColumns"; "required": false; }; "nonLockedLeafColumns": { "alias": "nonLockedLeafColumns"; "required": false; }; "sort": { "alias": "sort"; "required": false; }; "position": { "alias": "position"; "required": false; }; "rowsToRender": { "alias": "rowsToRender"; "required": false; }; "totalColumns": { "alias": "totalColumns"; "required": false; }; "lockedWidth": { "alias": "lockedWidth"; "required": false; }; "nonLockedWidth": { "alias": "nonLockedWidth"; "required": false; }; "isLocked": { "alias": "isLocked"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "trackBy": { "alias": "trackBy"; "required": false; }; "groups": { "alias": "groups"; "required": false; }; "detailTemplate": { "alias": "detailTemplate"; "required": false; }; "filterable": { "alias": "filterable"; "required": false; }; "rowHeight": { "alias": "rowHeight"; "required": false; }; "detailRowHeight": { "alias": "detailRowHeight"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "size": { "alias": "size"; "required": false; }; }, {}, never, never, true, never>;
 }

package/schematics/ngAdd/index.js

@@ -9,19 +9,19 @@ const schematics_1 = require("@angular-devkit/schematics");
 function default_1(options) {
     const finalOptions = Object.assign(Object.assign({}, options), { mainNgModule: 'GridModule', package: 'grid', peerDependencies: {
             // peer deps of the dropdowns
-            '@progress/kendo-angular-treeview': '24.0.0-develop.19',
-            '@progress/kendo-angular-navigation': '24.0.0-develop.19',
+            '@progress/kendo-angular-treeview': '24.0.0-develop.20',
+            '@progress/kendo-angular-navigation': '24.0.0-develop.20',
             // peer dependency of kendo-angular-inputs
-            '@progress/kendo-angular-dialog': '24.0.0-develop.19',
+            '@progress/kendo-angular-dialog': '24.0.0-develop.20',
             // peer dependency of kendo-angular-icons
             '@progress/kendo-svg-icons': '^4.0.0',
             // peer dependency of kendo-angular-layout
-            '@progress/kendo-angular-progressbar': '24.0.0-develop.19',
+            '@progress/kendo-angular-progressbar': '24.0.0-develop.20',
             // transitive peer dependencies from toolbar
-            '@progress/kendo-angular-indicators': '24.0.0-develop.19',
+            '@progress/kendo-angular-indicators': '24.0.0-develop.20',
             // transitive peer dependencies from conversational-ui
-            '@progress/kendo-angular-menu': '24.0.0-develop.19',
-            '@progress/kendo-angular-upload': '24.0.0-develop.19'
+            '@progress/kendo-angular-menu': '24.0.0-develop.20',
+            '@progress/kendo-angular-upload': '24.0.0-develop.20'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }