@opencorestack/opengridx 0.1.9 → 1.0.1

package/CHANGELOG.md

@@ -5,6 +5,57 @@
 
 ---
 
+## [1.0.1] — July 30, 2026 📚
+
+### Fixed
+- **Bundled documentation accuracy**: All doc files shipped inside the npm package (`docs/`) have been corrected to match the actual v1.0.0 API. Key fixes: removed non-existent `pageSize` standalone prop (correct API is `paginationModel` + `pageSizeOptions`), fixed `height` type to `number | string`, corrected `onColumnOrderChange` params shape, removed non-existent `isRowSelectable` and `reorderable` props, fixed `GridFilterModel.items` type, added missing `GridApi` methods (`getFilterModel`, `getAllColumns`, `setPageSize`, `getAggregationResult`, `getAggregationModel`, `copySelectedRows`), and corrected `GridInitialState` persisted state fields. AI agents (Cursor, Copilot, Windsurf) reading bundled docs will now generate accurate code.
+- **README API reference**: Same prop and type corrections applied — complete `apiRef` method list, new prop tables for Events, Columns, Pinning, Inline Editing, Row Reordering, and updated comparison table.
+
+---
+
+## [1.0.0] — July 30, 2026 🚀
+
+First stable public release. All 32 demo pages ship with a live source viewer. npm publish workflow is live.
+
+### Added
+- **npm publish workflow**: GitHub Actions workflow (`.github/workflows/npm-publish.yml`) triggers on any `v*.*.*` tag push — runs lint, build, then `npm publish`. The package is now publicly available as `@opencorestack/opengridx` on the npm registry.
+- **Source viewer on all 32 demos**: Every demo page now uses `DocsLayout` with a collapsible "View Source" tab showing the full component source code. Previously only 7 of 32 demos had this; the remaining 25 have been migrated.
+
+### Changed
+- **Version**: `0.1.x` pre-release series → `1.0.0` stable. The public API (`DataGridProps`, `GridColDef`, `GridApi`, all hooks and types) is now considered stable.
+- **Demo consistency**: All 32 demos share the same `DocsLayout` shell — consistent title, description, live preview, and source viewer. Inline `<h1>` / `<h2>` + `<p>` manual headers removed from every migrated demo.
+
+### Fixed (during migration)
+- `PivotModeDemo` — `apiRef: any`, `fallbackRows: any[]`, `props: any` toolbar → fully typed
+- `InfiniteScrollDemo` — introduced `PersonRow` interface, all `any` in data source and sort params replaced
+- `ServerSideAggregationDemo` — `(a as any)[field]` field access → `keyof Employee` keyed access
+- `AggregationFooter` + `ServerSideAggregationDemo` — `valueFormatter: { value: any }` → `unknown` with narrowing
+- `SlotsDemo` — added `EmployeeRow` interface, `renderCell: (params: any)` × 2 replaced
+- `CRUDTutorial` — `renderCell: (params: any)` → `GridRenderCellParams<User>`
+- `RealEstatePortfolio` — `useState<any>` for pinnedColumns → `useState<GridColumnPinning>`
+- `ExportDemo` — `apiRef: any` → `ReturnType<typeof useGridApiRef>`, `rowsToPrint: any[]` → typed
+- `CustomPagination` — `(props: any)` component signature → explicit typed interface
+- `Editing` — `handleProcessRowUpdate = (newRow: any)` → `MockRow` inferred from data
+
+---
+
+## [0.1.10] — July 30, 2026 🐛🔒
+
+### Fixed
+- **`onRowClick` never fired when `onCellClick` was registered**: `Cell.tsx` was calling `e.stopPropagation()` inside its click handler whenever `onCellClick` was provided. This silently ate the event before it could bubble to the row's `onClick` handler, making `onRowClick` permanently unreachable from cell clicks. Removed the stopPropagation — both callbacks now fire in the natural bubble order (cell first, then row), matching standard data grid behavior.
+- **Column visibility panel list not updating after column reorder**: The toolbar was receiving `effectiveColumns` (the pre-ordering array, in original definition order) instead of `orderedColumns` (the reordered array). After a drag-reorder in the panel, the grid columns reordered correctly but the panel list stayed frozen in definition order. Fixed `toolbarProps.columns` to use `orderedColumns`.
+- **Reset button ignoring column sequence**: The Reset button in the column visibility panel called `onShowAll` only (restoring visibility), leaving any user-reordered sequence in place. Added `onColumnOrderReset` prop threaded from `ColumnVisibilityPanel` → `ColumnsPanelWrapper` → `GridToolbar` → `DataGrid`. DataGrid provides `() => setInternalColumnOrder(columns.map(c => c.field))` to restore original definition order on reset.
+- **`FilterPanelDemo` filter panel inaccessible**: The demo had no `slots={{ toolbar: GridToolbar }}`, so the toolbar never rendered and the filter icon never appeared. Added the toolbar slot and rewrote the demo to use `DocsLayout` (consistent with all other demos).
+- **`EventsDemo` event handlers never fired**: `onRowClick` was broken by the stopPropagation bug above. `onFilterModelChange` and `onColumnOrderChange` were dead — no toolbar existed to trigger them. Fixed by adding `slots={{ toolbar: GridToolbar }}`. Also replaced three `any`-typed handler signatures with `GridSortItem[]`, `GridFilterModel`, and `GridColumnOrderChangeParams`.
+- **`FilterPanel` debounce stale-closure bug**: The 300 ms debounce `useEffect` read `item`, `col.field`, and `currentOperator` directly from closure (stale values after operator or field changes), suppressed with `eslint-disable-next-line`. Replaced with a refs-sync pattern (`useLayoutEffect` writing `itemRef`, `colFieldRef`, `operatorRef` each render) so the effect reads current values without the lint suppression and without stale closures.
+
+### Changed
+- **Type safety — full `any` elimination**: Every `any` across `lib/` replaced with explicit types or `unknown`. Key changes: `GridRowModel` index signature `any → unknown` (with explicit internal row fields added to the type), all cell/value/error params typed as `unknown`, aggregation functions typed as `(values: unknown[]) => unknown`, `GridAggregationResult` typed as `Record<string, unknown>`, slot component types use `Record<string, unknown>`, export utilities narrowed with `instanceof Error` guards.
+- **No more lint suppressions**: Removed all `eslint-disable-next-line react-hooks/exhaustive-deps` comments — every case fixed at the root cause rather than suppressed. Methods include: state refactors (`scrollTick` anti-pattern → `scrollTop`/`scrollLeft` state), ref patterns for stable callbacks, and correct dep arrays.
+- **DataGrid.tsx continued decomposition**: Further hooks and components extracted — `useGridScrollSync` (RAF-batched scroll state), `useGridVirtualization`, `useGridVisibleRows`, `useGridColumns`, `GridAggregationFooter`, `GridEmptyState`, `GridErrorOverlay`, `GridVirtualRows`, `GridPinnedRows`, `GridStandaloneColumnPanel`, `GridListView`. Each module has a single clear responsibility and typed params/return interface.
+
+---
+
 ## [0.1.9] — July 29, 2026 🛠️✨
 
 ### Added

package/README.md

@@ -40,14 +40,14 @@ const columns: GridColDef[] = [
   { field: 'name',       headerName: 'Name',        width: 180 },
   { field: 'role',       headerName: 'Role',        width: 150 },
   { field: 'salary',     headerName: 'Salary',      width: 120, type: 'number',
-    valueFormatter: ({ value }) => `$${value.toLocaleString()}` },
+    valueFormatter: ({ value }) => `$${(value as number).toLocaleString()}` },
   { field: 'department', headerName: 'Department',  width: 160 },
 ];
 
 const rows = [
-  { id: 1, name: 'Jon Snow',       role: 'Engineer',  salary: 95000,  department: 'Defense' },
-  { id: 2, name: 'Cersei Lannister', role: 'Manager', salary: 140000, department: 'Management' },
-  { id: 3, name: 'Arya Stark',     role: 'Analyst',   salary: 65000,  department: 'Special Ops' },
+  { id: 1, name: 'Jon Snow',         role: 'Engineer',  salary: 95000,  department: 'Defense' },
+  { id: 2, name: 'Cersei Lannister', role: 'Manager',   salary: 140000, department: 'Management' },
+  { id: 3, name: 'Arya Stark',       role: 'Analyst',   salary: 65000,  department: 'Special Ops' },
 ];
 
 export default function App() {
@@ -77,18 +77,23 @@ export default function App() {
 - **Clipboard**: `Ctrl+C` / `Cmd+C` copies selected rows as TSV for Excel/Sheets.
 - **Accessibility**: WCAG 2.1 AA — full ARIA roles and keyboard navigation.
 - **Theming**: CSS variable API with 5 built-in themes + custom theme support.
+- **Column & Row Reordering**: Drag-and-drop column reordering and row reordering.
+- **Inline Cell Editing**: Full inline editing with `processRowUpdate` validation.
+- **State Persistence**: Save and restore grid state (sort, filter, columns) via `useGridStateStorage`.
 - **AI-Native Integration**: Shipped with raw `lib/` source and `docs/` inside the npm package, allowing AI agents (Cursor, Copilot, Windsurf) to flawlessly implement features by "seeing" the internal logic.
 
 ---
 
 ## 🤖 AI-Powered Implementation
 
-OpenGridX is built for the era of AI-native development. When you install `@opencorestack/opengridx`, we include the full raw source code and markdown documentation in your `node_modules`. 
+OpenGridX is built for the era of AI-native development. When you install `@opencorestack/opengridx`, we include the full raw source code and markdown documentation in your `node_modules`.
 
 This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agents can read the actual implementation patterns and docs to accurately help you build complex features like server-side tree data or pivot tables without guessing.
 
 > **Tip for Cursor/Copilot users:** If your AI is struggling, tell it to "Read the docs and source in `./node_modules/@opencorestack/opengridx/docs`" for instant context.
 
+---
+
 ## 📐 API Reference
 
 ### Core Props
@@ -97,14 +102,21 @@ This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agent
 | :--- | :--- | :--- | :--- |
 | `rows` | `GridRowModel[]` | — | **Required.** Array of data rows. |
 | `columns` | `GridColDef[]` | — | **Required.** Column definitions. |
-| `height` | `number` | `500` | Grid height in pixels. |
+| `height` | `number \| string` | `500` | Grid height in pixels or CSS string (e.g. `'100%'`). |
+| `autoHeight` | `boolean` | `false` | Expands grid height to fit all rows. |
 | `loading` | `boolean` | `false` | Shows skeleton loader when `true`. |
+| `density` | `'compact' \| 'standard' \| 'comfortable'` | `'standard'` | Visual row density. |
 | `checkboxSelection` | `boolean` | `false` | Enables checkbox column for row selection. |
 | `pagination` | `boolean` | `false` | Enables client-side pagination. |
-| `pageSize` | `number` | `25` | Rows per page. |
+| `paginationModel` | `{ page: number; pageSize: number }` | — | Controlled pagination state. |
+| `onPaginationModelChange` | `(model) => void` | — | Fires on page or page size change. |
+| `pageSizeOptions` | `number[]` | `[10, 25, 50]` | Available page size options. |
 | `getRowId` | `(row) => GridRowId` | `row.id` | Custom row ID accessor. |
 | `rowHeight` | `number` | `52` | Row height in pixels. |
 | `headerHeight` | `number` | `56` | Header height in pixels. |
+| `noRowsLabel` | `string` | — | Custom empty-state message. |
+| `className` | `string` | — | Custom CSS class on the grid container. |
+| `style` | `React.CSSProperties` | — | Custom inline styles on the grid container. |
 
 ### Selection
 
@@ -113,17 +125,37 @@ This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agent
 | `rowSelectionModel` | `GridRowId[]` | Controlled selected row IDs. |
 | `onRowSelectionModelChange` | `(model: GridRowId[]) => void` | Fires on selection change. |
 | `disableRowSelectionOnClick` | `boolean` | Prevent row click from toggling selection. |
+| `disableMultipleRowSelection` | `boolean` | Restrict to single-row selection. |
+| `pinCheckboxColumn` | `boolean` | Keeps the checkbox column visible during horizontal scroll. |
 
 ### Sorting & Filtering
 
 | Prop | Type | Description |
 | :--- | :--- | :--- |
 | `sortModel` | `GridSortItem[]` | Controlled sort model. |
-| `onSortModelChange` | `(model) => void` | Fires on sort change. |
+| `onSortModelChange` | `(model: GridSortItem[]) => void` | Fires on sort change. |
 | `filterModel` | `GridFilterModel` | Controlled filter model. |
-| `onFilterModelChange` | `(model) => void` | Fires on filter change. |
+| `onFilterModelChange` | `(model: GridFilterModel) => void` | Fires on filter change. |
 | `disableColumnFilter` | `boolean` | Disables column-level filtering. |
 
+### Columns
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `columnVisibilityModel` | `GridColumnVisibilityModel` | Controlled column visibility. |
+| `onColumnVisibilityModelChange` | `(model) => void` | Fires when column visibility changes. |
+| `columnOrder` | `string[]` | Controlled column field order. |
+| `onColumnOrderChange` | `(params) => void` | Fires when columns are reordered. |
+| `disableColumnReorder` | `boolean` | Disables drag-and-drop column reordering. |
+
+### Events
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `onRowClick` | `(params: GridRowParams) => void` | Fires when a row is clicked. |
+| `onCellClick` | `(params: GridCellParams) => void` | Fires when a cell is clicked. |
+| `onRowsScrollEnd` | `(params: GridRowScrollEndParams) => void` | Fires when scrolling reaches the bottom. |
+
 ### Server-Side
 
 | Prop | Type | Description |
@@ -134,11 +166,60 @@ This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agent
 | `dataSource` | `GridDataSource` | Server-side data adapter. |
 | `rowCount` | `number` | Total rows for server-side pagination. |
 
+### Pinning
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `pinnedColumns` | `GridColumnPinning` | Pin columns to `left` or `right`. |
+| `onPinnedColumnsChange` | `(model) => void` | Fires when column pinning changes. |
+| `pinnedRows` | `GridRowPinning` | Pin rows to `top` or `bottom`. |
+| `onPinnedRowsChange` | `(model) => void` | Fires when row pinning changes. |
+
+### Inline Editing
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `isCellEditable` | `(params: GridCellParams) => boolean` | Per-cell editability predicate. |
+| `processRowUpdate` | `(newRow, oldRow) => R \| Promise<R>` | Handles row save; supports async validation. |
+| `onProcessRowUpdateError` | `(error: unknown) => void` | Fires if `processRowUpdate` throws. |
+
+### Row Reordering
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `rowReordering` | `boolean` | Enables drag-and-drop row reordering. |
+| `onRowOrderChange` | `(params) => void` | Fires when rows are reordered. |
+
+### Advanced Features
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `treeData` | `boolean` | Enables hierarchical tree data display. |
+| `getTreeDataPath` | `(row) => string[]` | Returns the path array for each row in tree mode. |
+| `groupingColDef` | `GridColDef` | Overrides the auto-generated grouping column. |
+| `defaultGroupingExpansionDepth` | `number` | Initial expansion depth for tree data. |
+| `rowGroupingModel` | `GridRowGroupingModel` | Controlled row grouping state. |
+| `onRowGroupingModelChange` | `(model) => void` | Fires when grouping changes. |
+| `aggregationModel` | `GridAggregationModel` | Controlled aggregation state (e.g. `{ salary: 'sum' }`). |
+| `onAggregationModelChange` | `(model) => void` | Fires when aggregation changes. |
+| `pivotMode` | `boolean` | Switches the grid to multidimensional pivot mode. |
+| `pivotModel` | `GridPivotModel` | Controlled pivot configuration (rows, columns, values). |
+| `onPivotModelChange` | `(model) => void` | Fires when pivot model changes. |
+
+### Master-Detail
+
+| Prop | Type | Description |
+| :--- | :--- | :--- |
+| `getDetailPanelContent` | `(params) => ReactNode` | Renders the expandable detail panel. |
+| `getDetailPanelHeight` | `(params) => number \| 'auto'` | Controls detail panel height. |
+| `detailPanelExpandedRowIds` | `Set<GridRowId>` | Controlled expanded rows. |
+| `onDetailPanelExpandedRowIdsChange` | `(ids) => void` | Fires when expanded rows change. |
+
 ### Customization
 
 | Prop | Type | Description |
 | :--- | :--- | :--- |
-| `slots` | `GridSlots` | Replace built-in components (toolbar, pagination, overlays). |
+| `slots` | `GridSlots` | Replace built-in components (toolbar, pagination, overlays, footer). |
 | `slotProps` | `GridSlotProps` | Pass custom props to slot components. |
 | `getRowClassName` | `(params) => string` | Add custom CSS class to rows. |
 | `getCellClassName` | `(params) => string` | Add custom CSS class to cells. |
@@ -150,14 +231,42 @@ This means that **Cursor**, **GitHub Copilot**, **Windsurf**, and other AI agent
 const apiRef = useGridApiRef();
 <DataGrid apiRef={apiRef} ... />
 
-// Usage
+// Rows
+apiRef.current.getRow(id)              // → GridRowModel | null
+apiRef.current.getAllRows()            // → GridRowModel[]
+apiRef.current.getVisibleRows()        // → GridRowModel[] (post-filter/sort)
+
+// Columns
+apiRef.current.getColumn(field)        // → GridColDef | null
+apiRef.current.getAllColumns()         // → GridColDef[]
+apiRef.current.getVisibleColumns()     // → GridColDef[]
+
+// Selection
+apiRef.current.selectRow(id, true)
+apiRef.current.selectRows([id1, id2], true)
 apiRef.current.getSelectedRows()       // → GridRowId[]
-apiRef.current.copySelectedRows()      // → Promise<void>
-apiRef.current.selectRow(id, true)     // select a row
-apiRef.current.setFilterModel(model)   // programmatic filter
+
+// Sorting
 apiRef.current.sortColumn('name', 'asc')
+apiRef.current.getSortModel()          // → GridSortItem[]
+
+// Filtering
+apiRef.current.setFilterModel(model)
+apiRef.current.getFilterModel()        // → GridFilterModel
+
+// Pagination
 apiRef.current.setPage(2)
-apiRef.current.getVisibleRows()        // → GridRowModel[]
+apiRef.current.setPageSize(50)
+
+// Scroll
+apiRef.current.scrollToIndexes({ rowIndex: 100, colIndex: 3 })
+
+// Clipboard
+apiRef.current.copySelectedRows()      // → Promise<void>
+
+// Aggregation
+apiRef.current.getAggregationResult()  // → Record<string, unknown> | null
+apiRef.current.getAggregationModel()   // → GridAggregationModel | null
 ```
 
 ---
@@ -186,6 +295,20 @@ Replace any built-in component with your own:
 />
 ```
 
+### Built-in Toolbar
+
+```tsx
+import { DataGrid, GridToolbar } from '@opencorestack/opengridx';
+
+<DataGrid
+  rows={rows}
+  columns={columns}
+  slots={{ toolbar: GridToolbar }}
+/>
+```
+
+`GridToolbar` provides global search, column visibility panel, filter panel, and export controls out of the box.
+
 ### Export Functionality
 
 OpenGridX has **two tiers of Excel export**:
@@ -214,6 +337,21 @@ printGrid(rows, columns, 'Report Title');
 > npm install exceljs
 > ```
 
+### State Persistence
+
+```tsx
+import { useGridStateStorage } from '@opencorestack/opengridx';
+
+const { initialState, onStateChange } = useGridStateStorage('my-grid-key');
+
+<DataGrid
+  rows={rows}
+  columns={columns}
+  initialState={initialState}
+  onStateChange={onStateChange}
+/>
+```
+
 ### Theming
 
 ```tsx
@@ -232,11 +370,11 @@ Built-in themes: `darkTheme`, `roseTheme`, `emeraldTheme`, `amberTheme`, `compac
 
 | Artifact | Minified | Gzipped | Notes |
 | :--- | :--- | :--- | :--- |
-| **Core ES Module** (`opengridx.es.js`) | 220 KB | **52 KB** | Use this — tree-shakeable |
-| **Core UMD** (`opengridx.umd.js`) | 146 KB | **44 KB** | CommonJS / CDN compat |
-| **Styles** (`opengridx.css`) | 57 KB | **9 KB** | Auto-included |
+| **Core ES Module** (`opengridx.es.js`) | 242 KB | **58 KB** | Use this — tree-shakeable |
+| **Core UMD** (`opengridx.umd.js`) | 164 KB | **48 KB** | CommonJS / CDN compat |
+| **Styles** (`opengridx.css`) | 62 KB | **10 KB** | Auto-included |
 | **ExcelJS** (optional peer dep) | — | — | `npm install exceljs` |
-| **npm package download** | — | **400 KB** | Total compressed tarball |
+| **npm package download** | — | **613 KB** | Total compressed tarball |
 
 - **Tree-shaking Ready**: ES Module build — bundlers (Vite, Webpack) only include what you use.
 - **Zero UI Dependencies**: No MUI, Ant Design, or Radix. Pure React + vanilla CSS.
@@ -252,6 +390,8 @@ Full documentation at 👉 **[opencorestack.github.io/OpenGridX](https://opencor
 ### 🏛️ Components
 - **[DataGrid](docs/components/datagrid.md)** — Main component props and slots
 - **[Toolbar & Pagination](docs/components/toolbar.md)** — Supplemental UI components
+- **[Filter Panel](docs/components/filter-panel.md)** — Advanced filter panel component
+- **[Column Visibility](docs/components/column-visibility.md)** — Column show/hide panel
 
 ### 🚀 Features
 - **[Virtualization](docs/features/virtualization.md)** — 60fps rendering for 100k+ rows
@@ -264,6 +404,7 @@ Full documentation at 👉 **[opencorestack.github.io/OpenGridX](https://opencor
 - **[Infinite Scroll](docs/features/infinite-scroll.md)** — Seamless lazy-loading
 - **[Export Guide](docs/features/export-guide.md)** — Excel, CSV, and Print
 - **[Data Source](docs/features/data-source.md)** — Server-side integration
+- **[Loading States](docs/features/loading-states.md)** — Skeleton and shimmer overlays
 
 ### 📊 Advanced Data
 - **[Aggregation & Pivot](docs/features/aggregation-pivot.md)** — Summary totals
@@ -292,6 +433,8 @@ Most React grids gatekeep essential features like **Row Grouping**, **Excel Expo
 | Advanced Filtering | ❌ | ✅ | ❌ | ✅ |
 | Aggregation | ❌ | ✅ | ❌ | ✅ |
 | Pivot Mode | ❌ | ✅ | ❌ | ✅ |
+| Inline Cell Editing | ❌ | ✅ | ✅ | ✅ |
+| State Persistence | ❌ | ✅ | ❌ | ✅ |
 | **Price** | Free | **$$$** | Free (limited) | **Free** |
 
 ---

package/dist/index.d.ts

@@ -34,9 +34,9 @@ declare function CellImpl<R extends GridRowModel = GridRowModel>(props: CellProp
 
 declare interface CellProps<R extends GridRowModel = GridRowModel> {
     onCellClick?: (params: GridCellParams<R>) => void;
-    onCellEditStart?: (field: string, value: any) => void;
-    onCellValueChange?: (field: string, newValue: any) => void;
-    value: any;
+    onCellEditStart?: (field: string, value: unknown) => void;
+    onCellValueChange?: (field: string, newValue: unknown) => void;
+    value: unknown;
     row: R;
     colDef: GridColDef<R>;
     rowIndex: number;
@@ -52,7 +52,7 @@ declare interface CellProps<R extends GridRowModel = GridRowModel> {
     isEditing?: boolean;
     onEditStart?: () => void;
     onEditStop?: (cancel?: boolean) => void;
-    onValueChange?: (newValue: any) => void;
+    onValueChange?: (newValue: unknown) => void;
     colSpanInfo?: CellColSpanInfo;
     rowSpan?: number;
     isHiddenByRowSpan?: boolean;
@@ -75,7 +75,7 @@ export declare interface CsvExportOptions {
     includeHeaders?: boolean;
     delimiter?: string;
     selectedRows?: (string | number)[];
-    aggregationResult?: Record<string, any> | null;
+    aggregationResult?: Record<string, unknown> | null;
     aggregationModel?: GridAggregationModel | null;
 }
 
@@ -218,7 +218,7 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     /** Callback to process an updated row after inline editing. Supports promises and validation. */
     processRowUpdate?: (newRow: R, oldRow: R) => R | Promise<R>;
     /** Callback fired if `processRowUpdate` throws or rejects. */
-    onProcessRowUpdateError?: (error: any) => void;
+    onProcessRowUpdateError?: (error: unknown) => void;
     /** Interface for connecting the grid to an external (server-side) data source. */
     dataSource?: GridDataSource<R>;
     /** Callback fired when scrolling reaches the bottom of the grid viewport. */
@@ -228,23 +228,23 @@ export declare interface DataGridProps<R extends GridRowModel = GridRowModel> {
     /** Custom components to replace internal grid parts. */
     slots?: {
         /** Component rendered as the grid toolbar. */
-        toolbar?: React.ComponentType<any>;
+        toolbar?: React.ComponentType<Record<string, unknown>>;
         /** Component rendered as the pagination control. */
-        pagination?: React.ComponentType<any>;
+        pagination?: React.ComponentType<Record<string, unknown>>;
         /** Component rendered when the grid is empty. */
-        noRowsOverlay?: React.ComponentType<any>;
+        noRowsOverlay?: React.ComponentType<Record<string, unknown>>;
         /** Component rendered during loading states. */
-        loadingOverlay?: React.ComponentType<any>;
+        loadingOverlay?: React.ComponentType<Record<string, unknown>>;
         /** Component rendered at the very bottom of the grid. */
-        footer?: React.ComponentType<any>;
+        footer?: React.ComponentType<Record<string, unknown>>;
     };
     /** Properties passed directly to custom slots. */
     slotProps?: {
-        toolbar?: any;
-        pagination?: any;
-        noRowsOverlay?: any;
-        loadingOverlay?: any;
-        footer?: any;
+        toolbar?: Record<string, unknown>;
+        pagination?: Record<string, unknown>;
+        noRowsOverlay?: Record<string, unknown>;
+        loadingOverlay?: Record<string, unknown>;
+        footer?: Record<string, unknown>;
     };
     /** When true, renders the grid as a single-column list of cards. Perfect for mobile/responsive views. */
     listView?: boolean;
@@ -293,7 +293,7 @@ export declare interface ExcelAdvancedExportOptions {
     /** Body font size (default: 10) */
     bodyFontSize?: number;
     /** Current aggregation result */
-    aggregationResult?: Record<string, any> | null;
+    aggregationResult?: Record<string, unknown> | null;
     /** Current aggregation model */
     aggregationModel?: GridAggregationModel | null;
     /** Currently selected row IDs */
@@ -325,7 +325,7 @@ export declare interface ExcelExportOptions {
     sheetName?: string;
     includeHeaders?: boolean;
     selectedRows?: (string | number)[];
-    aggregationResult?: Record<string, any> | null;
+    aggregationResult?: Record<string, unknown> | null;
     aggregationModel?: GridAggregationModel | null;
 }
 
@@ -373,13 +373,13 @@ declare interface FilterPanelProps {
     onFilterModelChange: (model: GridFilterModel) => void;
 }
 
-export declare function formatAggregationValue(value: any, fnName: string): string;
+export declare function formatAggregationValue(value: unknown, fnName: string): string;
 
 export declare interface GridAggregationModel {
     [field: string]: string;
 }
 
-export declare type GridAggregationResult = Record<string, any>;
+export declare type GridAggregationResult = Record<string, unknown>;
 
 export declare type GridAlignment = 'left' | 'center' | 'right';
 
@@ -398,7 +398,7 @@ export declare interface GridApi {
     /** Returns all rows currently visible after filtering and sorting. */
     getVisibleRows: () => GridRowModel[];
     /** Returns the current aggregation results. */
-    getAggregationResult: () => Record<string, any> | null;
+    getAggregationResult: () => Record<string, unknown> | null;
     /** Returns the active aggregation configuration. */
     getAggregationModel: () => GridAggregationModel | null;
     /** Returns the column definition for the given field. */
@@ -453,7 +453,7 @@ export declare interface GridApi {
 export declare interface GridCellParams<R extends GridRowModel = GridRowModel> {
     row: R;
     field: string;
-    value: any;
+    value: unknown;
     colDef: GridColDef<R>;
     rowIndex: number;
     colIndex: number;
@@ -498,15 +498,17 @@ export declare interface GridColDef<R extends GridRowModel = GridRowModel> {
     hideable?: boolean;
     /** If false, the column cannot be pinned. */
     pinnable?: boolean;
+    /** Internal: marks this column as a virtual spacer used for horizontal virtualization. */
+    isSpacer?: boolean;
     /** Type used to determine default operators and formatting logic. */
     type?: 'string' | 'number' | 'date' | 'boolean' | 'singleSelect' | 'image';
     /** Options used for 'singleSelect' type. */
     valueOptions?: Array<string | number | {
-        value: any;
+        value: unknown;
         label: string;
     }>;
     /** Function to compute a cell value from raw row data. */
-    valueGetter?: (params: GridValueGetterParams<R>) => any;
+    valueGetter?: (params: GridValueGetterParams<R>) => unknown;
     /** Function to format a value into a human-readable string. */
     valueFormatter?: (params: GridValueFormatterParams<R>) => string;
     /** Custom component or element to render in the cell. */
@@ -615,12 +617,12 @@ export declare interface GridDataSource<R extends GridRowModel = GridRowModel> {
     /**
      * Optional: Fetches aggregation results for the entire dataset.
      */
-    getAggregations?: (params: Omit<GridGetRowsParams, 'startRow' | 'endRow'>) => Promise<Record<string, any>>;
+    getAggregations?: (params: Omit<GridGetRowsParams, 'startRow' | 'endRow'>) => Promise<Record<string, unknown>>;
 }
 
 declare interface GridDataSourceState {
     loading: boolean;
-    error?: any;
+    error?: unknown;
 }
 
 export declare interface GridDensityState {
@@ -654,7 +656,7 @@ export declare interface GridFilterItem {
     /** The comparison operator. */
     operator: GridFilterOperator;
     /** The value to compare against. */
-    value?: any;
+    value?: unknown;
 }
 
 /** The overall state of grid filtering. */
@@ -685,7 +687,7 @@ export declare interface GridGetRowsParams {
 export declare interface GridGetRowsResponse<R extends GridRowModel = GridRowModel> {
     rows: R[];
     rowCount?: number;
-    aggregationResults?: Record<string, any>;
+    aggregationResults?: Record<string, unknown>;
 }
 
 export declare type GridInitialState = GridState;
@@ -725,7 +727,7 @@ export declare interface GridPivotValueField {
 /** Parameters passed to the `renderCell` function. */
 export declare interface GridRenderCellParams<R extends GridRowModel = GridRowModel> {
     /** The current cell value. */
-    value: any;
+    value: unknown;
     /** The row object. */
     row: R;
     /** The field name and unique ID. */
@@ -753,8 +755,24 @@ export declare type GridRowId = string | number;
 export declare interface GridRowModel {
     /** Uniquely identifies the row. */
     id: GridRowId;
+    /** Internal: row has child nodes (tree data / row grouping). */
+    _hasChildren?: boolean;
+    /** Internal: row is a skeleton placeholder during infinite-scroll loading. */
+    _isSkeleton?: boolean;
+    /** Internal: depth in the tree or grouping hierarchy. */
+    _treeDepth?: number;
+    /** Internal: whether the group/tree node is currently expanded. */
+    _isExpanded?: boolean;
+    /** Internal: field used for grouping at this level. */
+    _groupingField?: string;
+    /** Internal: grouping field value at this level. */
+    _groupingValue?: unknown;
+    /** Internal: total descendant count for tree/grouping nodes. */
+    _descendantCount?: number;
+    /** Internal: server-reported child count for lazy-loaded tree nodes. */
+    serverChildrenCount?: number;
     /** Any other dynamic row properties. */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 
 export declare interface GridRowOrderChangeParams<R extends GridRowModel = GridRowModel> {
@@ -958,7 +976,7 @@ export declare interface GridThemeTypography {
     fontSizeXl?: string;
 }
 
-export declare function GridToolbar({ columns, baseColumns, aggregationModel, onAggregationModelChange, pivotModel, onPivotModelChange, filterModel, onFilterModelChange, columnVisibilityModel, onColumnVisibilityModelChange, onColumnReorder, forceColumnsOpen, onColumnsPanelClose, children, rightContent, style, }: GridToolbarProps): JSX.Element;
+export declare function GridToolbar({ columns, baseColumns, aggregationModel, onAggregationModelChange, pivotModel, onPivotModelChange, filterModel, onFilterModelChange, columnVisibilityModel, onColumnVisibilityModelChange, onColumnReorder, onColumnOrderReset, forceColumnsOpen, onColumnsPanelClose, children, rightContent, style, }: GridToolbarProps): JSX.Element;
 
 export declare interface GridToolbarProps {
     columns?: GridColDef[];
@@ -976,6 +994,7 @@ export declare interface GridToolbarProps {
     columnVisibilityModel?: Record<string, boolean>;
     onColumnVisibilityModelChange?: (model: Record<string, boolean>) => void;
     onColumnReorder?: (fromField: string, toField: string) => void;
+    onColumnOrderReset?: () => void;
     forceColumnsOpen?: boolean;
     onColumnsPanelClose?: () => void;
     children?: default_2.ReactNode;
@@ -1006,9 +1025,9 @@ export declare interface GridTreeNode {
     /** The field this node is grouping by. */
     groupingField?: string;
     /** The actual value being grouped. */
-    groupingValue?: any;
+    groupingValue?: unknown;
     /** Computed aggregation results for this group. */
-    aggregatedValues?: Record<string, any>;
+    aggregatedValues?: Record<string, unknown>;
     /** Position of the aggregation row relative to the group. */
     aggregationPosition?: 'inline' | 'footer' | null;
     /** Current expansion state. */
@@ -1026,7 +1045,7 @@ export declare interface GridTreeNode {
 /** Parameters passed to the `valueFormatter` function. */
 export declare interface GridValueFormatterParams<R extends GridRowModel = GridRowModel> {
     /** The raw value to format. */
-    value: any;
+    value: unknown;
     /** The row object. */
     row: R;
     /** The field name. */
@@ -1040,7 +1059,7 @@ export declare interface GridValueGetterParams<R extends GridRowModel = GridRowM
     /** The field name. */
     field: string;
     /** The raw value from the row object. */
-    value: any;
+    value: unknown;
 }
 
 export declare function Header<R extends GridRowModel = GridRowModel>(props: HeaderProps<R>): JSX.Element;
@@ -1095,7 +1114,7 @@ export declare interface JsonExportOptions {
     fileName?: string;
     pretty?: boolean;
     selectedRows?: (string | number)[];
-    aggregationResult?: Record<string, any> | null;
+    aggregationResult?: Record<string, unknown> | null;
     aggregationModel?: GridAggregationModel | null;
 }
 
@@ -1107,7 +1126,7 @@ export declare function printGrid<R extends GridRowModel>(rows: R[], columns: Gr
 export declare interface PrintOptions {
     title?: string;
     selectedRows?: (string | number)[];
-    aggregationResult?: Record<string, any> | null;
+    aggregationResult?: Record<string, unknown> | null;
     aggregationModel?: GridAggregationModel | null;
 }
 
@@ -1144,12 +1163,12 @@ declare interface RowProps<R extends GridRowModel = GridRowModel> {
     editingCell?: {
         id: GridRowId;
         field: string;
-        value: any;
+        value: unknown;
     } | null;
     onEditStart?: (params: {
         id: GridRowId;
         field: string;
-        value: any;
+        value: unknown;
     }) => void;
     onEditStop?: (params?: {
         cancel?: boolean;
@@ -1157,7 +1176,7 @@ declare interface RowProps<R extends GridRowModel = GridRowModel> {
     onEditCellValueChange?: (params: {
         id: GridRowId;
         field: string;
-        value: any;
+        value: unknown;
     }) => void;
     focusedCellField?: string | null;
     isFocusVisible?: boolean;
@@ -1194,7 +1213,7 @@ export declare interface UseAggregationParams<R extends GridRowModel> {
 export declare interface UseAggregationReturn {
     aggregationResult: GridAggregationResult;
     isLoading: boolean;
-    error: any;
+    error: unknown;
 }
 
 /**