@opencorestack/opengridx 2.0.3 → 2.0.4

package/CHANGELOG.md

@@ -5,6 +5,15 @@
 
 ---
 
+## [2.0.4] — 2026-09-10
+
+### Added
+
+- **Adaptive overscan based on scroll velocity** — `useGridScrollSync` now tracks scroll velocity (px/ms) on every scroll event and maps it to a dynamic overscan tier (3 / 5 / 12 / 20 / 30 rows). All three values (`scrollTop`, `scrollLeft`, `overscanRows`) are bundled into a single state update per RAF frame so `useGridVirtualization` recomputes exactly once per frame. 200 ms after scrolling stops, the overscan decays back to the floor set by `overscanRowCount`.
+- **`overscanRowCount` prop** — new `DataGridProps` field (`number`, default `3`). Sets the minimum overscan floor; the adaptive algorithm always produces a value ≥ this prop. Increasing it pre-renders more rows at rest; decreasing it saves idle memory.
+
+---
+
 ## [2.0.3] — 2026-09-10
 
 ### Documentation

package/dist/index.d.ts

@@ -102,6 +102,13 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     headerHeight?: number;
     /** If true, the grid height will adjust to match the total height of its rows. */
     autoHeight?: boolean;
+    /**
+     * Minimum number of rows to render outside the visible viewport (overscan buffer).
+     * The grid adapts this value upward automatically based on scroll velocity to prevent
+     * blank flashes during fast scrolling. This prop sets the floor — the buffer never
+     * drops below this value regardless of scroll speed. Defaults to `3`.
+     */
+    overscanRowCount?: number;
     /** Sorting mode: 'client' (default) or 'server'. */
     sortingMode?: 'client' | 'server';
     /** The current sorting model. */