@progress/kendo-react-grid 16.2.0-develop.2 → 16.2.0-develop.20

package/index.d.mts

@@ -64,7 +64,8 @@ import { GridNoRecords } from './components/noRecords/GridNoRecords.js';
 import { GridNoRecordsProps } from './interfaces/GridNoRecordsProps';
 import { GridSortSettings } from './interfaces/GridSortSettings';
 import { GridScrollableSettings } from './interfaces/GridScrollableSettings';
-import { GridPagerSettings } from './paging/GridPagerSettings.js';
+import { GridPagerSettings, GridPagerType } from './paging/GridPagerSettings.js';
+import { Page as GridPage } from './paging/Page';
 import { GridGroupableSettings, GridGroupingMode } from './interfaces/GridGroupableSettings';
 import { GridGroupColumnFn, GridGroupColumnSettings } from './interfaces/GridGroupColumnSettings';
 import { GridColumnMenuGroupBaseProps } from './interfaces/GridColumnMenuGroupBaseProps';
@@ -97,6 +98,6 @@ export * from './GridSearchBox.js';
 export * from './GridPdfExportButton.js';
 export * from './GridCsvExportButton.js';
 export * from './toolbar-tools/smartbox/index.js';
-export { CompositeHighlightDescriptor, Grid, GridHandle, GridHighlightDescriptor, GridProps, GridColumn, GridColumnProps, GridColSpanProps, GridEditDialogProps, GridColumnChildrenProps, GridCellProps, GridColumnType, GridRowReorderEvent, GridDataType, GridRowReorderSettings, GridCell, GridEditCell, GridGroupCell, GridHierarchyCell, GridDetailRow, GridDetailRowProps, GridRow, GridRowProps, GridFilterCell, GridFilterCellProps, GridHeaderCell, GridHeaderCellProps, GridSelectionCell, GridColumnMenuProps, GridReorderDropPosition, GridColumnMenuSort, GridColumnMenuFilter, GridColumnMenuGroup, GridColumnMenuItem, GridColumnMenuItemContent, GridColumnMenuItemGroup, GridColumnMenuFilterUI, GridColumnMenuFilterUIProps, GridColumnMenuFilterCell, GridColumnMenuFilterCellProps, GridColumnMenuCheckboxFilter, GridColumnMenuCheckboxFilterProps, GridColumnMenuColumnsList, GridColumnMenuColumnsListProps, GridColumnMenuColumnsChooser, GridColumnMenuColumnsChooserProps, GridColumnMenuColumnProps, GridColumnState, GridRowType, GridToolbar, GridToolbarProps, GridToolbarAIAssistant, GridToolbarAIAssistantHandle, GridToolbarAIAssistantProps, GridToolbarAIAssistantRequestData, GridAIAssistantCommand, GridAICommands, GridAIPrompt, GridAIPromptProps, GridToolbarSpacer, GridToolbarSpacerProps, GridToolbarSeparator, GridToolbarSeparatorProps, GridToolbarCheckboxFilter, GridToolbarCheckboxFilterProps, GridToolbarColumnsChooser, GridToolbarColumnsChooserProps, GridToolbarFilter, GridToolbarFilterProps, GridToolbarSort, GridToolbarSortProps, GridToolbarGroup, GridToolbarGroupProps, GridNoRecords, GridNoRecordsProps, GridSortSettings, GridScrollableSettings, GridPagerSettings, GridGroupableSettings, GridGroupingMode, GridGroupColumnFn, GridGroupColumnSettings, GridColumnMenuGroupBaseProps, GridFooterCellProps, GridSelectableMode, GridSelectableSettings, GridFilterOperators, GridFilterOperator, GridColumnMenuWrapper, GridColumnMenuWrapperProps, getSelectedState, setSelectedState, getSelectedStateFromKeyDown, GRID_COL_INDEX_ATTRIBUTE, GRID_ROW_INDEX_ATTRIBUTE, GRID_PREVENT_SELECTION_ELEMENT, GridCommonDragLogic, rootFilterOrDefault, filterGroupByField, isColumnMenuSortActive, isColumnMenuFilterActive, GridColumnMenuFilterProps, cellBoolDropdownChange, cellInputChange, cellOperatorChange, booleanFilterValues, operators, combineSmartFilters, parseFilterDates, GridRowSpannableSettings, handleAIResponse, GridAIState, GridAIResponseResult, GridCSVExportOptions, useGridAIRequest, GridAIRequestData, UseGridAIRequestOptions, UseGridAIRequestReturn, GridRowPinChangeEvent, GridWebMcpProps, GridWebMcpToolsCallback, GridWebMcpToolsHelpers, McpToolOption, GridAIRequestConfig, GridAIResponse, GridAIHttpClient, createAxiosAIClient };
+export { CompositeHighlightDescriptor, Grid, GridHandle, GridHighlightDescriptor, GridProps, GridColumn, GridColumnProps, GridColSpanProps, GridEditDialogProps, GridColumnChildrenProps, GridCellProps, GridColumnType, GridRowReorderEvent, GridDataType, GridRowReorderSettings, GridCell, GridEditCell, GridGroupCell, GridHierarchyCell, GridDetailRow, GridDetailRowProps, GridRow, GridRowProps, GridFilterCell, GridFilterCellProps, GridHeaderCell, GridHeaderCellProps, GridSelectionCell, GridColumnMenuProps, GridReorderDropPosition, GridColumnMenuSort, GridColumnMenuFilter, GridColumnMenuGroup, GridColumnMenuItem, GridColumnMenuItemContent, GridColumnMenuItemGroup, GridColumnMenuFilterUI, GridColumnMenuFilterUIProps, GridColumnMenuFilterCell, GridColumnMenuFilterCellProps, GridColumnMenuCheckboxFilter, GridColumnMenuCheckboxFilterProps, GridColumnMenuColumnsList, GridColumnMenuColumnsListProps, GridColumnMenuColumnsChooser, GridColumnMenuColumnsChooserProps, GridColumnMenuColumnProps, GridColumnState, GridRowType, GridToolbar, GridToolbarProps, GridToolbarAIAssistant, GridToolbarAIAssistantHandle, GridToolbarAIAssistantProps, GridToolbarAIAssistantRequestData, GridAIAssistantCommand, GridAICommands, GridAIPrompt, GridAIPromptProps, GridToolbarSpacer, GridToolbarSpacerProps, GridToolbarSeparator, GridToolbarSeparatorProps, GridToolbarCheckboxFilter, GridToolbarCheckboxFilterProps, GridToolbarColumnsChooser, GridToolbarColumnsChooserProps, GridToolbarFilter, GridToolbarFilterProps, GridToolbarSort, GridToolbarSortProps, GridToolbarGroup, GridToolbarGroupProps, GridNoRecords, GridNoRecordsProps, GridSortSettings, GridScrollableSettings, GridPagerSettings, GridPagerType, GridPage, GridGroupableSettings, GridGroupingMode, GridGroupColumnFn, GridGroupColumnSettings, GridColumnMenuGroupBaseProps, GridFooterCellProps, GridSelectableMode, GridSelectableSettings, GridFilterOperators, GridFilterOperator, GridColumnMenuWrapper, GridColumnMenuWrapperProps, getSelectedState, setSelectedState, getSelectedStateFromKeyDown, GRID_COL_INDEX_ATTRIBUTE, GRID_ROW_INDEX_ATTRIBUTE, GRID_PREVENT_SELECTION_ELEMENT, GridCommonDragLogic, rootFilterOrDefault, filterGroupByField, isColumnMenuSortActive, isColumnMenuFilterActive, GridColumnMenuFilterProps, cellBoolDropdownChange, cellInputChange, cellOperatorChange, booleanFilterValues, operators, combineSmartFilters, parseFilterDates, GridRowSpannableSettings, handleAIResponse, GridAIState, GridAIResponseResult, GridCSVExportOptions, useGridAIRequest, GridAIRequestData, UseGridAIRequestOptions, UseGridAIRequestReturn, GridRowPinChangeEvent, GridWebMcpProps, GridWebMcpToolsCallback, GridWebMcpToolsHelpers, McpToolOption, GridAIRequestConfig, GridAIResponse, GridAIHttpClient, createAxiosAIClient };
 export { GridPinCell, GridHeaderPinCell };
 export * from './interfaces/GridStackedLayoutSettings';

package/index.d.ts

@@ -64,7 +64,8 @@ import { GridNoRecords } from './components/noRecords/GridNoRecords.js';
 import { GridNoRecordsProps } from './interfaces/GridNoRecordsProps';
 import { GridSortSettings } from './interfaces/GridSortSettings';
 import { GridScrollableSettings } from './interfaces/GridScrollableSettings';
-import { GridPagerSettings } from './paging/GridPagerSettings.js';
+import { GridPagerSettings, GridPagerType } from './paging/GridPagerSettings.js';
+import { Page as GridPage } from './paging/Page';
 import { GridGroupableSettings, GridGroupingMode } from './interfaces/GridGroupableSettings';
 import { GridGroupColumnFn, GridGroupColumnSettings } from './interfaces/GridGroupColumnSettings';
 import { GridColumnMenuGroupBaseProps } from './interfaces/GridColumnMenuGroupBaseProps';
@@ -97,6 +98,6 @@ export * from './GridSearchBox.js';
 export * from './GridPdfExportButton.js';
 export * from './GridCsvExportButton.js';
 export * from './toolbar-tools/smartbox/index.js';
-export { CompositeHighlightDescriptor, Grid, GridHandle, GridHighlightDescriptor, GridProps, GridColumn, GridColumnProps, GridColSpanProps, GridEditDialogProps, GridColumnChildrenProps, GridCellProps, GridColumnType, GridRowReorderEvent, GridDataType, GridRowReorderSettings, GridCell, GridEditCell, GridGroupCell, GridHierarchyCell, GridDetailRow, GridDetailRowProps, GridRow, GridRowProps, GridFilterCell, GridFilterCellProps, GridHeaderCell, GridHeaderCellProps, GridSelectionCell, GridColumnMenuProps, GridReorderDropPosition, GridColumnMenuSort, GridColumnMenuFilter, GridColumnMenuGroup, GridColumnMenuItem, GridColumnMenuItemContent, GridColumnMenuItemGroup, GridColumnMenuFilterUI, GridColumnMenuFilterUIProps, GridColumnMenuFilterCell, GridColumnMenuFilterCellProps, GridColumnMenuCheckboxFilter, GridColumnMenuCheckboxFilterProps, GridColumnMenuColumnsList, GridColumnMenuColumnsListProps, GridColumnMenuColumnsChooser, GridColumnMenuColumnsChooserProps, GridColumnMenuColumnProps, GridColumnState, GridRowType, GridToolbar, GridToolbarProps, GridToolbarAIAssistant, GridToolbarAIAssistantHandle, GridToolbarAIAssistantProps, GridToolbarAIAssistantRequestData, GridAIAssistantCommand, GridAICommands, GridAIPrompt, GridAIPromptProps, GridToolbarSpacer, GridToolbarSpacerProps, GridToolbarSeparator, GridToolbarSeparatorProps, GridToolbarCheckboxFilter, GridToolbarCheckboxFilterProps, GridToolbarColumnsChooser, GridToolbarColumnsChooserProps, GridToolbarFilter, GridToolbarFilterProps, GridToolbarSort, GridToolbarSortProps, GridToolbarGroup, GridToolbarGroupProps, GridNoRecords, GridNoRecordsProps, GridSortSettings, GridScrollableSettings, GridPagerSettings, GridGroupableSettings, GridGroupingMode, GridGroupColumnFn, GridGroupColumnSettings, GridColumnMenuGroupBaseProps, GridFooterCellProps, GridSelectableMode, GridSelectableSettings, GridFilterOperators, GridFilterOperator, GridColumnMenuWrapper, GridColumnMenuWrapperProps, getSelectedState, setSelectedState, getSelectedStateFromKeyDown, GRID_COL_INDEX_ATTRIBUTE, GRID_ROW_INDEX_ATTRIBUTE, GRID_PREVENT_SELECTION_ELEMENT, GridCommonDragLogic, rootFilterOrDefault, filterGroupByField, isColumnMenuSortActive, isColumnMenuFilterActive, GridColumnMenuFilterProps, cellBoolDropdownChange, cellInputChange, cellOperatorChange, booleanFilterValues, operators, combineSmartFilters, parseFilterDates, GridRowSpannableSettings, handleAIResponse, GridAIState, GridAIResponseResult, GridCSVExportOptions, useGridAIRequest, GridAIRequestData, UseGridAIRequestOptions, UseGridAIRequestReturn, GridRowPinChangeEvent, GridWebMcpProps, GridWebMcpToolsCallback, GridWebMcpToolsHelpers, McpToolOption, GridAIRequestConfig, GridAIResponse, GridAIHttpClient, createAxiosAIClient };
+export { CompositeHighlightDescriptor, Grid, GridHandle, GridHighlightDescriptor, GridProps, GridColumn, GridColumnProps, GridColSpanProps, GridEditDialogProps, GridColumnChildrenProps, GridCellProps, GridColumnType, GridRowReorderEvent, GridDataType, GridRowReorderSettings, GridCell, GridEditCell, GridGroupCell, GridHierarchyCell, GridDetailRow, GridDetailRowProps, GridRow, GridRowProps, GridFilterCell, GridFilterCellProps, GridHeaderCell, GridHeaderCellProps, GridSelectionCell, GridColumnMenuProps, GridReorderDropPosition, GridColumnMenuSort, GridColumnMenuFilter, GridColumnMenuGroup, GridColumnMenuItem, GridColumnMenuItemContent, GridColumnMenuItemGroup, GridColumnMenuFilterUI, GridColumnMenuFilterUIProps, GridColumnMenuFilterCell, GridColumnMenuFilterCellProps, GridColumnMenuCheckboxFilter, GridColumnMenuCheckboxFilterProps, GridColumnMenuColumnsList, GridColumnMenuColumnsListProps, GridColumnMenuColumnsChooser, GridColumnMenuColumnsChooserProps, GridColumnMenuColumnProps, GridColumnState, GridRowType, GridToolbar, GridToolbarProps, GridToolbarAIAssistant, GridToolbarAIAssistantHandle, GridToolbarAIAssistantProps, GridToolbarAIAssistantRequestData, GridAIAssistantCommand, GridAICommands, GridAIPrompt, GridAIPromptProps, GridToolbarSpacer, GridToolbarSpacerProps, GridToolbarSeparator, GridToolbarSeparatorProps, GridToolbarCheckboxFilter, GridToolbarCheckboxFilterProps, GridToolbarColumnsChooser, GridToolbarColumnsChooserProps, GridToolbarFilter, GridToolbarFilterProps, GridToolbarSort, GridToolbarSortProps, GridToolbarGroup, GridToolbarGroupProps, GridNoRecords, GridNoRecordsProps, GridSortSettings, GridScrollableSettings, GridPagerSettings, GridPagerType, GridPage, GridGroupableSettings, GridGroupingMode, GridGroupColumnFn, GridGroupColumnSettings, GridColumnMenuGroupBaseProps, GridFooterCellProps, GridSelectableMode, GridSelectableSettings, GridFilterOperators, GridFilterOperator, GridColumnMenuWrapper, GridColumnMenuWrapperProps, getSelectedState, setSelectedState, getSelectedStateFromKeyDown, GRID_COL_INDEX_ATTRIBUTE, GRID_ROW_INDEX_ATTRIBUTE, GRID_PREVENT_SELECTION_ELEMENT, GridCommonDragLogic, rootFilterOrDefault, filterGroupByField, isColumnMenuSortActive, isColumnMenuFilterActive, GridColumnMenuFilterProps, cellBoolDropdownChange, cellInputChange, cellOperatorChange, booleanFilterValues, operators, combineSmartFilters, parseFilterDates, GridRowSpannableSettings, handleAIResponse, GridAIState, GridAIResponseResult, GridCSVExportOptions, useGridAIRequest, GridAIRequestData, UseGridAIRequestOptions, UseGridAIRequestReturn, GridRowPinChangeEvent, GridWebMcpProps, GridWebMcpToolsCallback, GridWebMcpToolsHelpers, McpToolOption, GridAIRequestConfig, GridAIResponse, GridAIHttpClient, createAxiosAIClient };
 export { GridPinCell, GridHeaderPinCell };
 export * from './interfaces/GridStackedLayoutSettings';

package/interfaces/GridCellsSettings.d.ts

@@ -180,6 +180,38 @@ export interface GridCustomHeaderCellProps extends GridHeaderCellProps {
      * The index of the column.
      */
     index?: number;
+    /**
+     * The default column title element (`<span class="k-column-title">` with the column title text).
+     *
+     * Render this inside your custom header cell to reuse the built-in title styling and the
+     * grouping-row text class instead of rebuilding the title span yourself. Combine it with
+     * additional custom content (icons, badges, etc.) to keep the default appearance while
+     * extending it.
+     */
+    titleElement?: React.ReactNode;
+    /**
+     * The default sort direction icon and sort-order badge for the column.
+     *
+     * `null` when the column is not currently sorted. Render this inside your custom header cell
+     * to keep the built-in sort indicator without reimplementing sort icon rendering. The
+     * click-to-sort behavior remains attached to the `onClick` prop.
+     */
+    sortIcon?: React.ReactNode;
+    /**
+     * The default column menu / filter button wrapper for the column.
+     *
+     * `null` when the column has no column menu configured. Render this inside your custom
+     * header cell to preserve the built-in filter popup, column menu, and their keyboard and
+     * accessibility behavior.
+     */
+    columnMenu?: React.ReactNode;
+    /**
+     * The default column resize handle.
+     *
+     * Render this inside your custom header cell (typically as the last child) to preserve the
+     * built-in column resizing behavior.
+     */
+    resizer?: React.ReactNode;
 }
 /**
  * The settings of the cells prop options.

package/interfaces/GridScrollableSettings.d.ts

@@ -23,11 +23,20 @@ export interface GridScrollableSettings {
      * Controls the scrollbar rendering style.
      *
      * - `default`—Uses the native browser scrollbar (default).
-     * - `proxied`—Renders a custom overlay scrollbar on top of the content area.
-     *   The overlay appears on hover or scroll and hides when idle,
+     * - `proxied`—Renders a native scrollbar-based overlay on top of the content area,
      *   eliminating the white-space flash during virtual scrolling jumps.
      *
      * @default 'default'
      */
     scrollbar?: 'default' | 'proxied';
+    /**
+     * Multiplies the scrolling distance reported by mouse-wheel and trackpad input.
+     * Applies to the `scrollable` and `virtual` modes with both scrollbar styles.
+     *
+     * Must be a positive, finite number. Values that are zero, negative, `NaN`, or `Infinity`
+     * fall back to the default.
+     *
+     * @default 1
+     */
+    wheelMultiplier?: number;
 }

package/interfaces/VirtualScrollInterface.d.ts

@@ -6,7 +6,7 @@
  *-------------------------------------------------------------------------------------------
  */
 import { Page } from '../paging/Page';
-import { SyntheticEvent } from 'react';
+import { RefObject, SyntheticEvent } from 'react';
 import { RowHeightService } from '@progress/kendo-react-common';
 /**
  * @hidden
@@ -24,6 +24,7 @@ export interface VirtualScrollInterface {
     tableTransform: string;
     rowHeightService?: RowHeightService;
     scrollbarOverlaySpacerElement: HTMLDivElement | null;
+    overlaySyncingRef: RefObject<boolean> | null;
     reset: () => void;
     scrollHandler(e: SyntheticEvent<HTMLDivElement>): void;
     scrollToPosition(scrollTop: number, e: SyntheticEvent<HTMLDivElement>, deferTranslate?: boolean): void;

package/package-metadata.js

@@ -5,4 +5,4 @@
  * Licensed under commercial license. See LICENSE.md in the package root for more information
  *-------------------------------------------------------------------------------------------
  */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-grid",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1789037042,version:"16.2.0-develop.2",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({name:"@progress/kendo-react-grid",productName:"KendoReact",productCode:"KENDOUIREACT",productCodes:["KENDOUIREACT"],publishDate: 1791301644,version:"16.2.0-develop.20",licensingDocsUrl:"https://www.telerik.com/kendo-react-ui/components/my-license/"});exports.packageMetadata=e;

package/package-metadata.mjs

@@ -7,7 +7,7 @@ export const packageMetadata = Object.freeze({
     productName: 'KendoReact',
     productCode: 'KENDOUIREACT',
     productCodes: ['KENDOUIREACT'],
-    publishDate: 1789037042,
-    version: '16.2.0-develop.2',
+    publishDate: 1791301644,
+    version: '16.2.0-develop.20',
     licensingDocsUrl: 'https://www.telerik.com/kendo-react-ui/components/my-license/'
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-grid",
-  "version": "16.2.0-develop.2",
+  "version": "16.2.0-develop.20",
   "description": "React Data Grid (Table) provides 100+ ready-to-use data grid features. KendoReact Grid package",
   "author": "Progress",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -30,21 +30,21 @@
     "@progress/kendo-drawing": "^1.25.5",
     "@progress/kendo-file-saver": "^1.1.1",
     "@progress/kendo-licensing": "^1.7.2",
-    "@progress/kendo-react-animation": "16.2.0-develop.2",
-    "@progress/kendo-react-buttons": "16.2.0-develop.2",
-    "@progress/kendo-react-common": "16.2.0-develop.2",
-    "@progress/kendo-react-data-tools": "16.2.0-develop.2",
-    "@progress/kendo-react-dateinputs": "16.2.0-develop.2",
-    "@progress/kendo-react-indicators": "16.2.0-develop.2",
-    "@progress/kendo-react-form": "16.2.0-develop.2",
-    "@progress/kendo-react-labels": "16.2.0-develop.2",
-    "@progress/kendo-react-dialogs": "16.2.0-develop.2",
-    "@progress/kendo-react-dropdowns": "16.2.0-develop.2",
-    "@progress/kendo-react-inputs": "16.2.0-develop.2",
-    "@progress/kendo-react-intl": "16.2.0-develop.2",
-    "@progress/kendo-react-popup": "16.2.0-develop.2",
-    "@progress/kendo-react-layout": "16.2.0-develop.2",
-    "@progress/kendo-react-conversational-ui": "16.2.0-develop.2",
+    "@progress/kendo-react-animation": "16.2.0-develop.20",
+    "@progress/kendo-react-buttons": "16.2.0-develop.20",
+    "@progress/kendo-react-common": "16.2.0-develop.20",
+    "@progress/kendo-react-data-tools": "16.2.0-develop.20",
+    "@progress/kendo-react-dateinputs": "16.2.0-develop.20",
+    "@progress/kendo-react-indicators": "16.2.0-develop.20",
+    "@progress/kendo-react-form": "16.2.0-develop.20",
+    "@progress/kendo-react-labels": "16.2.0-develop.20",
+    "@progress/kendo-react-dialogs": "16.2.0-develop.20",
+    "@progress/kendo-react-dropdowns": "16.2.0-develop.20",
+    "@progress/kendo-react-inputs": "16.2.0-develop.20",
+    "@progress/kendo-react-intl": "16.2.0-develop.20",
+    "@progress/kendo-react-popup": "16.2.0-develop.20",
+    "@progress/kendo-react-layout": "16.2.0-develop.20",
+    "@progress/kendo-react-conversational-ui": "16.2.0-develop.20",
     "@progress/kendo-svg-icons": "^4.9.0 || ^5.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
@@ -155,7 +155,7 @@
     "package": {
       "productName": "KendoReact",
       "productCode": "KENDOUIREACT",
-      "publishDate": 1789037042,
+      "publishDate": 1791301644,
       "licensingDocsUrl": "https://www.telerik.com/kendo-react-ui/components/my-license/"
     }
   },
@@ -165,10 +165,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/telerik/kendo-react.git"
-  },
-  "peerDependenciesMeta": {
-    "@progress/kendo-svg-icons": {
-      "optional": true
-    }
   }
 }

package/utils/proxiedScrollOverlay.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { GridScrollableSettings } from '../interfaces/GridScrollableSettings';
+import { ScrollMode } from '../ScrollMode';
+/**
+ * @hidden
+ */
+export interface ScrollableOverlaySettings {
+    overlayScrollbar: boolean;
+    wheelMultiplier: number;
+}
+/**
+ * @hidden
+ */
+export declare function getScrollableOverlaySettings(scrollable: ScrollMode | GridScrollableSettings | undefined): ScrollableOverlaySettings;
+/**
+ * @hidden
+ * Reports whether the proxied scrollbar overlay is currently scrolled to its bottom edge.
+ * Must be called BEFORE the overlay's spacer height is updated for a new page — its
+ * `scrollHeight` reflects the size from the PREVIOUS render, which is what "was it at the
+ * bottom" needs to check against. Only reports true when the page being applied is genuinely
+ * the last page — the overlay's own scrollTop can still read "at bottom" from a stale prior
+ * position (e.g. right after scrolling back up), which would otherwise incorrectly snap the
+ * content back down.
+ */
+export declare function isOverlayAtBottom(scrollbarOverlaySpacerElement: HTMLDivElement | null, isLastPageLoad: boolean): boolean;
+/**
+ * @hidden
+ */
+export interface OverlayBottomPin {
+    scrollbarOverlay: HTMLDivElement;
+    overlayScrollTop: number;
+    contentScrollTop: number;
+}
+/**
+ * @hidden
+ * Computes the scrollTop values needed to keep the proxied scrollbar overlay pinned to the
+ * bottom, or `null` when there's no overlay/container to pin. Must be called AFTER the
+ * overlay's spacer height has been updated for the new page, so `scrollHeight` reflects the
+ * new size — pair with `isOverlayAtBottom()` (called before the resize) to decide whether to
+ * apply the result.
+ */
+export declare function getOverlayBottomPin(scrollbarOverlaySpacerElement: HTMLDivElement | null, container: HTMLDivElement | null): OverlayBottomPin | null;

package/utils/proxiedScrollOverlay.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function e(i){const o=typeof i=="object"?i:void 0,t=o==null?void 0:o.wheelMultiplier;return{overlayScrollbar:(o==null?void 0:o.scrollbar)==="proxied",wheelMultiplier:typeof t=="number"&&Number.isFinite(t)&&t>0?t:1}}function l(i,o){const t=i==null?void 0:i.parentElement;return o&&!!t&&t.scrollHeight-t.clientHeight-t.scrollTop<=1}function n(i,o){const t=i==null?void 0:i.parentElement;return!t||!o?null:{scrollbarOverlay:t,overlayScrollTop:t.scrollHeight-t.clientHeight,contentScrollTop:o.scrollHeight-o.clientHeight}}exports.getOverlayBottomPin=n;exports.getScrollableOverlaySettings=e;exports.isOverlayAtBottom=l;

package/utils/proxiedScrollOverlay.mjs

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+function n(i) {
+  const o = typeof i == "object" ? i : void 0, t = o == null ? void 0 : o.wheelMultiplier;
+  return {
+    overlayScrollbar: (o == null ? void 0 : o.scrollbar) === "proxied",
+    wheelMultiplier: typeof t == "number" && Number.isFinite(t) && t > 0 ? t : 1
+  };
+}
+function u(i, o) {
+  const t = i == null ? void 0 : i.parentElement;
+  return o && !!t && t.scrollHeight - t.clientHeight - t.scrollTop <= 1;
+}
+function l(i, o) {
+  const t = i == null ? void 0 : i.parentElement;
+  return !t || !o ? null : {
+    scrollbarOverlay: t,
+    overlayScrollTop: t.scrollHeight - t.clientHeight,
+    contentScrollTop: o.scrollHeight - o.clientHeight
+  };
+}
+export {
+  l as getOverlayBottomPin,
+  n as getScrollableOverlaySettings,
+  u as isOverlayAtBottom
+};

package/utils/wheelTouchScroll.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export interface WheelTouchScrollOptions {
+    wheelMultiplier: number;
+    overlayRequiresCustomWheel: boolean;
+}
+/**
+ * @hidden
+ * Attaches native (non-React) wheel/touch listeners so the grid can apply `wheelMultiplier` and/or
+ * restore scrolling when the proxied overlay hides native overflow. Always scrolls `container`;
+ * pass `wheelListenerTarget` (the shared ancestor of `container` and the overlay) to also catch
+ * wheel events bubbling from the overlay. Returns a cleanup function.
+ */
+export declare function attachWheelTouchScroll(container: HTMLDivElement, options: WheelTouchScrollOptions, wheelListenerTarget?: HTMLElement | null): () => void;

package/utils/wheelTouchScroll.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const W=16,b=1,F=2,S=.95,d=.1;function N(e,M,_){const{wheelMultiplier:m,overlayRequiresCustomWheel:Y}=M;let f;const y=()=>{var t;if(f===void 0){const i=(t=e.ownerDocument.defaultView)==null?void 0:t.getComputedStyle(e).lineHeight;f=Number.parseFloat(i||"")||W}return f},L=t=>{if(t.ctrlKey||t.metaKey||!t.deltaY&&!t.deltaX)return;const i=e.scrollTop,r=e.scrollLeft;let l=t.deltaX,s=t.deltaY;if(t.shiftKey&&!l&&(l=s,s=0),t.deltaMode===b){const c=y();l*=c,s*=c}else t.deltaMode===F&&(l*=e.clientWidth,s*=e.clientHeight);e.scrollTop+=s*m,e.scrollLeft+=l*m,(e.scrollTop!==i||e.scrollLeft!==r)&&t.preventDefault()},T=_||e;T.addEventListener("wheel",L,{passive:!1});let h;if(Y){let t=0,i=0,r=0,l=0,s=0,c;const p=()=>{c!==void 0&&(cancelAnimationFrame(c),c=void 0)},E=()=>{e.scrollTop+=s,e.scrollLeft+=l,s*=S,l*=S,Math.abs(s)>d||Math.abs(l)>d?c=requestAnimationFrame(E):c=void 0},n=o=>{o.touches.length===1&&(p(),l=0,s=0,t=o.touches[0].clientX,i=o.touches[0].clientY,r=o.timeStamp)},v=o=>{if(o.touches.length!==1)return;const a=o.touches[0],g=t-a.clientX,H=i-a.clientY,I=Math.min(Math.max(o.timeStamp-r,1),100),A=e.scrollTop,X=e.scrollLeft;e.scrollTop+=H,e.scrollLeft+=g,s=H/I*(1e3/60),l=g/I*(1e3/60),t=a.clientX,i=a.clientY,r=o.timeStamp,(e.scrollTop!==A||e.scrollLeft!==X)&&o.preventDefault()},u=o=>{o.touches.length>0||(Math.abs(s)>d||Math.abs(l)>d)&&(c=requestAnimationFrame(E))};e.addEventListener("touchstart",n,{passive:!0}),e.addEventListener("touchmove",v,{passive:!1}),e.addEventListener("touchend",u,{passive:!0}),e.addEventListener("touchcancel",u,{passive:!0}),h=()=>{p(),e.removeEventListener("touchstart",n),e.removeEventListener("touchmove",v),e.removeEventListener("touchend",u),e.removeEventListener("touchcancel",u)}}return()=>{T.removeEventListener("wheel",L),h==null||h()}}exports.attachWheelTouchScroll=N;

package/utils/wheelTouchScroll.mjs

@@ -0,0 +1,57 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+function Y(e, N, v) {
+  const { wheelMultiplier: a, overlayRequiresCustomWheel: A } = N;
+  let u;
+  const C = () => {
+    var t;
+    if (u === void 0) {
+      const i = (t = e.ownerDocument.defaultView) == null ? void 0 : t.getComputedStyle(e).lineHeight;
+      u = Number.parseFloat(i || "") || 16;
+    }
+    return u;
+  }, L = (t) => {
+    if (t.ctrlKey || t.metaKey || !t.deltaY && !t.deltaX)
+      return;
+    const i = e.scrollTop, h = e.scrollLeft;
+    let l = t.deltaX, s = t.deltaY;
+    if (t.shiftKey && !l && (l = s, s = 0), t.deltaMode === 1) {
+      const c = C();
+      l *= c, s *= c;
+    } else t.deltaMode === 2 && (l *= e.clientWidth, s *= e.clientHeight);
+    e.scrollTop += s * a, e.scrollLeft += l * a, (e.scrollTop !== i || e.scrollLeft !== h) && t.preventDefault();
+  }, I = v || e;
+  I.addEventListener("wheel", L, { passive: !1 });
+  let r;
+  if (A) {
+    let t = 0, i = 0, h = 0, l = 0, s = 0, c;
+    const d = () => {
+      c !== void 0 && (cancelAnimationFrame(c), c = void 0);
+    }, _ = () => {
+      e.scrollTop += s, e.scrollLeft += l, s *= 0.95, l *= 0.95, Math.abs(s) > 0.1 || Math.abs(l) > 0.1 ? c = requestAnimationFrame(_) : c = void 0;
+    }, f = (o) => {
+      o.touches.length === 1 && (d(), l = 0, s = 0, t = o.touches[0].clientX, i = o.touches[0].clientY, h = o.timeStamp);
+    }, m = (o) => {
+      if (o.touches.length !== 1)
+        return;
+      const E = o.touches[0], p = t - E.clientX, n = i - E.clientY, H = Math.min(Math.max(o.timeStamp - h, 1), 100), O = e.scrollTop, M = e.scrollLeft;
+      e.scrollTop += n, e.scrollLeft += p, s = n / H * (1e3 / 60), l = p / H * (1e3 / 60), t = E.clientX, i = E.clientY, h = o.timeStamp, (e.scrollTop !== O || e.scrollLeft !== M) && o.preventDefault();
+    }, T = (o) => {
+      o.touches.length > 0 || (Math.abs(s) > 0.1 || Math.abs(l) > 0.1) && (c = requestAnimationFrame(_));
+    };
+    e.addEventListener("touchstart", f, { passive: !0 }), e.addEventListener("touchmove", m, { passive: !1 }), e.addEventListener("touchend", T, { passive: !0 }), e.addEventListener("touchcancel", T, { passive: !0 }), r = () => {
+      d(), e.removeEventListener("touchstart", f), e.removeEventListener("touchmove", m), e.removeEventListener("touchend", T), e.removeEventListener("touchcancel", T);
+    };
+  }
+  return () => {
+    I.removeEventListener("wheel", L), r == null || r();
+  };
+}
+export {
+  Y as attachWheelTouchScroll
+};