@opencorestack/opengridx 2.0.2 → 2.0.4

package/CHANGELOG.md

@@ -5,6 +5,28 @@
 
 ---
 
+## [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
+
+Comprehensive accuracy audit — 32 issues corrected across 19 files:
+
+- **Wrong defaults corrected**: `pageSizeOptions` (`[10,25,50]` → `[10,25,50,100]`), `pinCheckboxColumn`/`pinExpandColumn` (`false` → `true`), `noRowsLabel` (`'No rows'` → `'No Data'`) — in `API_REFERENCE.md`, `components/datagrid.md`, `features/sorting-pagination.md`, `features/selection.md`, `components/empty-state.md`
+- **Missing API surface added**: `getAllFilteredRows()` and `getGroupedExportRows()` added to `GridApi` table; `groupLabel` field added to `GridRowMeta`; `groupedRows` option added to `PdfExportOptions`; `'unique'` added to aggregation function type in `components/aggregation-footer.md`
+- **Non-existent API removed or corrected**: `'both'` is not a valid `getAggregationPosition` return (valid: `'inline' | 'footer' | null`); `disableColumnResize` DataGrid prop, `columnResizeHandle`/`columnVisibilityPanel`/`columnGroupHeader`/`tooltip` slots, `onColumnWidthChange` callback, `disableReorder` on `GridColDef`, `showQuickFilter` in `GridToolbarProps`, `toolbar`/`toolbarProps` DataGrid props — all documented as real but never existed; corrected throughout
+- **Stale content updated**: `use-grid-scroll-sync.md` and `use-grid-virtualization.md` params/returns updated from old `scrollPosRef`/`scrollTick` pattern to current `scrollTop`/`scrollLeft`; `grid-row-meta.md` updated from "will be removed in v2" to "was removed in v2"; `roadmap.md` column virtualization claim corrected; `virtualization.md` "Aui DataGrid" placeholder fixed and `density` prop section added; `upgrade-guide` version and slots API corrected
+
+---
+
 ## [2.0.2] — 2026-09-10
 
 ### Fixed

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. */