@mui/x-virtualizer 0.2.9 → 0.2.11

package/CHANGELOG.md

@@ -5,6 +5,180 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.21.0
+
+_Dec 3, 2025_
+
+We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
+
+- ✨ Add [tick spacing property](https://mui.com/x/react-charts/axis/#tick-spacing) to charts axis to control the distance between ticks.
+
+The following team members contributed to this release:
+@alexfauquette, @bernardobelchior, @ElliottMiller, @Janpot, @JCQuintas, @romgrk, @sai6855, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.21.0`
+
+- [DataGrid] Fix autosizing header width calculation (#20323) @siriwatknp
+- [DataGrid] Virtualizer refactor (#19465) @romgrk
+
+#### `@mui/x-data-grid-pro@8.21.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@8.21.0`.
+
+#### `@mui/x-data-grid-premium@8.21.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@8.21.0`, plus:
+
+- [DataGridPremium] Prevent pasting to non-editable cells (#20333) @ElliottMiller
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.21.0`
+
+Internal changes.
+
+#### `@mui/x-date-pickers-pro@8.21.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@8.21.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.21.0`
+
+- [charts] Fix string measuring types (#20454) @bernardobelchior
+- [charts] Fix typo in performance note for CustomLineMarks demo (#20529) @sai6855
+- [charts] Introduce the notion of series with positions (#20461) @alexfauquette
+- [charts] Migrate from sinon to Vitest mocking utilities for x-charts\* packages (#20444) @Copilot
+- [charts] Move series-level values to series computed data in bar plot (#20467) @bernardobelchior
+- [charts] Refactor bar chart components in preparation for range bar chart (#20521) @bernardobelchior
+- [charts] Remove unnecessary `any` types (#20527) @sai6855
+- [charts] Remove unused `drawingArea` from `findClosestPoints` (#20471) @bernardobelchior
+- [charts] Revert `useIsHydrated` to default=false (#20511) @JCQuintas
+- [charts] Support tooltip anchor position for radar (#20422) @alexfauquette
+- [charts] Add tick spacing property (#20282) @bernardobelchior
+- [charts] Fix Vitest lint error (#20550) @bernardobelchior
+- [charts] Fix infinite loop when highlighting pie slices or scatter points (#20549) @bernardobelchior
+
+#### `@mui/x-charts-pro@8.21.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@8.21.0`, plus:
+
+- [charts-pro] Add support for `anchor="node"` on Sankey tooltip (#20462) @alexfauquette
+
+#### `@mui/x-charts-premium@8.21.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-charts-pro@8.21.0`.
+
+### Tree View
+
+#### `@mui/x-tree-view@8.21.0`
+
+Internal changes.
+
+#### `@mui/x-tree-view-pro@8.21.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@8.21.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.21.0`
+
+Internal changes.
+
+### Docs
+
+- [docs] Migrate to `next/font` for fonts loading (#20407) @Copilot
+
+### Core
+
+- [code-infra] Enable vitest eslint plugin (#20530) @Janpot
+- [code-infra] Fix missing font loading for local fonts (#20480) @Janpot
+- [internal] Performance: use raw `useSyncExternalStore` (#20447) @romgrk
+- [code-infra] Enable `vitest/expect-expect` and `vitest/no-standalone-expect` rules for x-charts packages (#20535) @Copilot
+
+### Miscellaneous
+
+- Bump @types/d3-sankey to ^0.12.5 (#20489) @renovate[bot]
+- Bump @types/react to 19.2.7 (#20490) @renovate[bot]
+- Bump @types/yargs to ^17.0.35 (#20491) @renovate[bot]
+- Bump Vite & Vitest to ^4.0.14 (#20500) @renovate[bot]
+- Bump csstype to ^3.2.3 (#20493) @renovate[bot]
+- Bump es-toolkit to ^1.42.0 (#20494) @renovate[bot]
+- Bump eslint to ^8.48.0 (#20495) @renovate[bot]
+- Bump lerna to ^9.0.3 (#20496) @renovate[bot]
+- Bump lucide-react to ^0.555.0 (#20502) @renovate[bot]
+- Bump playwright monorepo (#20503) @renovate[bot]
+- Bump pnpm to 10.24.0 (#20504) @renovate[bot]
+- Bump react monorepo (#20340) @renovate[bot]
+- Bump react-hook-form to ^7.66.1 (#20497) @renovate[bot]
+- Bump rimraf to ^6.1.2 (#20498) @renovate[bot]
+- Bump webpack-bundle-analyzer to ^5.0.1 (#20508) @renovate[bot]
+- Bump next to ^15.5.6 [SECURITY] (#20555) @renovate[bot]
+
+## 8.20.0
+
+_Nov 26, 2025_
+
+We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
+
+- 🔃 Data Grid tree data now supports row reordering. See the [Drag-and-drop tree data reordering](https://mui.com/x/react-data-grid/tree-data/#drag-and-drop-tree-data-reordering) section for more details.
+- 🐞 Bugfixes
+
+The following team members contributed to this release:
+@alexfauquette, @arminmeh, @bernardobelchior, @cherniavskii, @siriwatknp, @JCQuintas, @MBilalShafi, @prakhargupta1
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.20.0`
+
+- [DataGrid] Fix RTL virtualization to display columns when viewport width is larger than the grid (#20409) @siriwatknp
+- [DataGrid] Fix row range selection (#20442) @arminmeh
+- [DataGrid] Initialize data grid core packages (#20276) @cherniavskii
+- [DataGrid] Improve accessibility of the sort icon (#20430) @arminmeh
+- [DataGrid] Use `viewport` as a boundary for the `BasePopper` flip (#20311) @arminmeh
+
+#### `@mui/x-data-grid-pro@8.20.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@8.20.0`, plus:
+
+- [DataGridPro] Avoid automatic scroll back to the focused header filter after it leaves the viewport (#20416) @arminmeh
+- [DataGridPro] Tree data row reordering (#19401) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@8.20.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@8.20.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.20.0`
+
+- [charts] Fix item tooltip position with node anchor (#20421) @alexfauquette
+- [charts] Fix radar item tooltip closing bug (#20429) @alexfauquette
+- [charts] Move series processing to selector (#20388) @JCQuintas
+- [charts] Prevent pointer out from removing controlled highlight (#20385) @alexfauquette
+
+#### `@mui/x-charts-pro@8.20.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@8.20.0`, plus:
+
+- [charts-pro] Fix Content-Security-Policy nonce not being correctly set on export (#20395) @bernardobelchior
+- [charts-pro] Improve vertical zoom slider thumb on mobile (#20439) @bernardobelchior
+- [charts-pro] Provide arguments to the `AreaPlotRoot` styled component (#20414) @arminmeh
+- [charts-pro] Remove grid outside the drawing area (#20412) @alexfauquette
+
+#### `@mui/x-charts-premium@8.20.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-charts-pro@8.20.0`, plus:
+
+- [charts-premium] Add explicit return type to `ChartsRenderer` for better compatibility with React 18 (#20413) @arminmeh
+
+### Docs
+
+- [docs] Add `llms.txt` link to the sidebar (#20312) @siriwatknp
+- [docs] Add a line chart demo for the Overview section (#20239) @prakhargupta1
+
 ## 8.19.0
 
 _Nov 20, 2025_

package/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const DEFAULT_COLUMNS: {
+  field: string;
+}[];
+export declare const DEFAULT_PARAMS: {
+  resizeThrottleMs: number;
+  columns: {
+    field: string;
+  }[];
+  dimensions: {
+    autoHeight: boolean;
+    columnsTotalWidth: number;
+    leftPinnedWidth: number;
+    rightPinnedWidth: number;
+    topPinnedHeight: number;
+    bottomPinnedHeight: number;
+  };
+  virtualization: {
+    isRtl: boolean;
+    rowBufferPx: number;
+    columnBufferPx: number;
+  };
+};

package/constants.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_PARAMS = exports.DEFAULT_COLUMNS = void 0;
+const DEFAULT_COLUMNS = exports.DEFAULT_COLUMNS = [{
+  field: 'DEFAULT_COLUMN'
+}];
+const DEFAULT_PARAMS = exports.DEFAULT_PARAMS = {
+  resizeThrottleMs: 100,
+  columns: DEFAULT_COLUMNS,
+  dimensions: {
+    autoHeight: false,
+    columnsTotalWidth: 0,
+    leftPinnedWidth: 0,
+    rightPinnedWidth: 0,
+    topPinnedHeight: 0,
+    bottomPinnedHeight: 0
+  },
+  virtualization: {
+    isRtl: false,
+    rowBufferPx: 150,
+    columnBufferPx: 150
+  }
+};

package/esm/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const DEFAULT_COLUMNS: {
+  field: string;
+}[];
+export declare const DEFAULT_PARAMS: {
+  resizeThrottleMs: number;
+  columns: {
+    field: string;
+  }[];
+  dimensions: {
+    autoHeight: boolean;
+    columnsTotalWidth: number;
+    leftPinnedWidth: number;
+    rightPinnedWidth: number;
+    topPinnedHeight: number;
+    bottomPinnedHeight: number;
+  };
+  virtualization: {
+    isRtl: boolean;
+    rowBufferPx: number;
+    columnBufferPx: number;
+  };
+};

package/esm/constants.js

@@ -0,0 +1,20 @@
+export const DEFAULT_COLUMNS = [{
+  field: 'DEFAULT_COLUMN'
+}];
+export const DEFAULT_PARAMS = {
+  resizeThrottleMs: 100,
+  columns: DEFAULT_COLUMNS,
+  dimensions: {
+    autoHeight: false,
+    columnsTotalWidth: 0,
+    leftPinnedWidth: 0,
+    rightPinnedWidth: 0,
+    topPinnedHeight: 0,
+    bottomPinnedHeight: 0
+  },
+  virtualization: {
+    isRtl: false,
+    rowBufferPx: 150,
+    columnBufferPx: 150
+  }
+};

package/esm/features/colspan.d.ts

@@ -1,9 +1,9 @@
 import { Store } from '@mui/x-internals/store';
 import type { integer } from '@mui/x-internals/types';
-import type { BaseState, VirtualizerParams } from "../useVirtualizer.js";
+import type { BaseState, ParamsWithDefaults } from "../useVirtualizer.js";
 import type { ColumnWithWidth, RowId } from "../models/index.js";
 import type { CellColSpanInfo } from "../models/colspan.js";
-import { Virtualization } from "./virtualization.js";
+import { Virtualization } from "./virtualization/index.js";
 type ColumnIndex = number;
 type ColspanMap = Map<RowId, Record<ColumnIndex, CellColSpanInfo>>;
 export type ColspanParams = {
@@ -21,10 +21,10 @@ export declare namespace Colspan {
   };
   type API = ReturnType<typeof useColspan>;
 }
-declare function initializeState(_params: VirtualizerParams): {
+declare function initializeState(_params: ParamsWithDefaults): {
   colspanMap: Map<any, any>;
 };
-declare function useColspan(store: Store<BaseState & Colspan.State>, params: VirtualizerParams, api: Virtualization.API): {
+declare function useColspan(store: Store<BaseState & Colspan.State>, params: ParamsWithDefaults, api: Virtualization.API): {
   resetColSpan: () => void;
   getCellColSpanInfo: (rowId: RowId, columnIndex: integer) => CellColSpanInfo | undefined;
   calculateColSpan: (rowId: RowId, minFirstColumn: integer, maxLastColumn: integer, columns: ColumnWithWidth[]) => void;

package/esm/features/dimensions.d.ts

@@ -1,13 +1,15 @@
 import { Store } from '@mui/x-internals/store';
 import { ColumnWithWidth, DimensionsState, RowId, RowsMetaState, Size } from "../models/index.js";
-import type { BaseState, VirtualizerParams } from "../useVirtualizer.js";
+import type { BaseState, ParamsWithDefaults } from "../useVirtualizer.js";
 export type DimensionsParams = {
   rowHeight: number;
-  columnsTotalWidth: number;
-  leftPinnedWidth: number;
-  rightPinnedWidth: number;
-  topPinnedHeight: number;
-  bottomPinnedHeight: number;
+  columnsTotalWidth?: number;
+  leftPinnedWidth?: number;
+  rightPinnedWidth?: number;
+  topPinnedHeight?: number;
+  bottomPinnedHeight?: number;
+  autoHeight?: boolean;
+  minimalContentHeight?: number | string;
   scrollbarSize?: number;
 };
 export declare const Dimensions: {
@@ -17,8 +19,12 @@ export declare const Dimensions: {
     rootSize: (state: BaseState) => Size;
     dimensions: (state: BaseState) => DimensionsState;
     rowHeight: (state: BaseState) => number;
+    columnsTotalWidth: (state: BaseState) => number;
     contentHeight: (state: BaseState) => number;
+    autoHeight: (state: BaseState) => boolean;
+    minimalContentHeight: (state: BaseState) => string | number | undefined;
     rowsMeta: (state: BaseState) => RowsMetaState;
+    rowPositions: (state: BaseState) => number[];
     columnPositions: (_: any, columns: ColumnWithWidth[]) => number[];
     needsHorizontalScrollbar: (state: BaseState) => boolean;
   };
@@ -32,8 +38,8 @@ export declare namespace Dimensions {
   };
   type API = ReturnType<typeof useDimensions>;
 }
-declare function initializeState(params: VirtualizerParams): Dimensions.State;
-declare function useDimensions(store: Store<BaseState>, params: VirtualizerParams, _api: {}): {
+declare function initializeState(params: ParamsWithDefaults): Dimensions.State;
+declare function useDimensions(store: Store<BaseState>, params: ParamsWithDefaults, _api: {}): {
   updateDimensions: (firstUpdate?: boolean) => void;
   debouncedUpdateDimensions: (((firstUpdate?: boolean) => void) & import("@mui/x-internals/throttle").Cancelable) | undefined;
   rowsMeta: {

package/esm/features/dimensions.js

@@ -31,14 +31,20 @@ const EMPTY_DIMENSIONS = {
   leftPinnedWidth: 0,
   rightPinnedWidth: 0,
   topContainerHeight: 0,
-  bottomContainerHeight: 0
+  bottomContainerHeight: 0,
+  autoHeight: false,
+  minimalContentHeight: undefined
 };
 const selectors = {
   rootSize: state => state.rootSize,
   dimensions: state => state.dimensions,
   rowHeight: state => state.dimensions.rowHeight,
+  columnsTotalWidth: state => state.dimensions.columnsTotalWidth,
   contentHeight: state => state.dimensions.contentSize.height,
+  autoHeight: state => state.dimensions.autoHeight,
+  minimalContentHeight: state => state.dimensions.minimalContentHeight,
   rowsMeta: state => state.rowsMeta,
+  rowPositions: state => state.rowsMeta.positions,
   columnPositions: createSelectorMemoized((_, columns) => {
     const positions = [];
     let currentPosition = 0;
@@ -56,7 +62,10 @@ export const Dimensions = {
   selectors
 };
 function initializeState(params) {
-  const dimensions = _extends({}, EMPTY_DIMENSIONS, params.dimensions);
+  const dimensions = _extends({}, EMPTY_DIMENSIONS, params.dimensions, {
+    autoHeight: params.dimensions.autoHeight,
+    minimalContentHeight: params.dimensions.minimalContentHeight
+  });
   const {
     rowCount
   } = params;
@@ -82,7 +91,7 @@ function initializeState(params) {
 function useDimensions(store, params, _api) {
   const isFirstSizing = React.useRef(true);
   const {
-    refs,
+    layout,
     dimensions: {
       rowHeight,
       columnsTotalWidth,
@@ -100,7 +109,7 @@ function useDimensions(store, params, _api) {
     if (isFirstSizing.current) {
       return;
     }
-    const containerNode = refs.container.current;
+    const containerNode = layout.refs.container.current;
     const rootSize = selectors.rootSize(store.state);
     const rowsMeta = selectors.rowsMeta(store.state);
 
@@ -118,7 +127,7 @@ function useDimensions(store, params, _api) {
     let viewportInnerSize;
     let hasScrollX = false;
     let hasScrollY = false;
-    if (params.autoHeight) {
+    if (params.dimensions.autoHeight) {
       hasScrollY = false;
       hasScrollX = Math.round(columnsTotalWidth) > Math.round(rootSize.width);
       viewportOuterSize = {
@@ -185,7 +194,9 @@ function useDimensions(store, params, _api) {
       leftPinnedWidth,
       rightPinnedWidth,
       topContainerHeight,
-      bottomContainerHeight
+      bottomContainerHeight,
+      autoHeight: params.dimensions.autoHeight,
+      minimalContentHeight: params.dimensions.minimalContentHeight
     };
     const prevDimensions = store.state.dimensions;
     if (isDeepEqual(prevDimensions, newDimensions)) {
@@ -195,7 +206,7 @@ function useDimensions(store, params, _api) {
       dimensions: newDimensions
     });
     onResize?.(newDimensions.root);
-  }, [store, refs.container, params.dimensions.scrollbarSize, params.autoHeight, params.disableHorizontalScroll, params.disableVerticalScroll, onResize, rowHeight, columnsTotalWidth, leftPinnedWidth, rightPinnedWidth, topPinnedHeight, bottomPinnedHeight]);
+  }, [store, layout.refs.container, params.dimensions.scrollbarSize, params.dimensions.autoHeight, params.dimensions.minimalContentHeight, params.disableHorizontalScroll, params.disableVerticalScroll, onResize, rowHeight, columnsTotalWidth, leftPinnedWidth, rightPinnedWidth, topPinnedHeight, bottomPinnedHeight]);
   const {
     resizeThrottleMs
   } = params;
@@ -203,6 +214,14 @@ function useDimensions(store, params, _api) {
   const debouncedUpdateDimensions = React.useMemo(() => resizeThrottleMs > 0 ? throttle(updateDimensionCallback, resizeThrottleMs) : undefined, [resizeThrottleMs, updateDimensionCallback]);
   React.useEffect(() => debouncedUpdateDimensions?.clear, [debouncedUpdateDimensions]);
   useLayoutEffect(updateDimensions, [updateDimensions]);
+  useLayoutEffect(() => {
+    store.update({
+      dimensions: _extends({}, store.state.dimensions, {
+        autoHeight: params.dimensions.autoHeight,
+        minimalContentHeight: params.dimensions.minimalContentHeight
+      })
+    });
+  }, [store, params.dimensions.autoHeight, params.dimensions.minimalContentHeight]);
   const rowsMeta = useRowsMeta(store, params, updateDimensions);
   return {
     updateDimensions,

package/esm/features/index.d.ts

@@ -2,4 +2,4 @@ export * from "./colspan.js";
 export * from "./dimensions.js";
 export * from "./keyboard.js";
 export * from "./rowspan.js";
-export * from "./virtualization.js";
+export * from "./virtualization/index.js";

package/esm/features/index.js

@@ -2,4 +2,4 @@ export * from "./colspan.js";
 export * from "./dimensions.js";
 export * from "./keyboard.js";
 export * from "./rowspan.js";
-export * from "./virtualization.js";
+export * from "./virtualization/index.js";

package/esm/features/keyboard.d.ts

@@ -1,5 +1,5 @@
 import { Store } from '@mui/x-internals/store';
-import type { BaseState, VirtualizerParams } from "../useVirtualizer.js";
+import type { BaseState, ParamsWithDefaults } from "../useVirtualizer.js";
 export declare const Keyboard: {
   initialize: typeof initializeState;
   use: typeof useKeyboard;
@@ -9,8 +9,8 @@ export declare namespace Keyboard {
   type State = {};
   type API = ReturnType<typeof useKeyboard>;
 }
-declare function initializeState(_params: VirtualizerParams): Keyboard.State;
-declare function useKeyboard(store: Store<BaseState & Keyboard.State>, params: VirtualizerParams, _api: {}): {
+declare function initializeState(_params: ParamsWithDefaults): Keyboard.State;
+declare function useKeyboard(store: Store<BaseState & Keyboard.State>, params: ParamsWithDefaults, _api: {}): {
   getViewportPageSize: () => number;
 };
 export {};

package/esm/features/keyboard.js

@@ -1,5 +1,5 @@
 import { Dimensions } from "./dimensions.js";
-import { Virtualization } from "./virtualization.js";
+import { Virtualization } from "./virtualization/index.js";
 
 /* eslint-disable import/export, @typescript-eslint/no-redeclare */
 

package/esm/features/rowspan.d.ts

@@ -1,7 +1,7 @@
 import { Store } from '@mui/x-internals/store';
-import type { BaseState, VirtualizerParams } from "../useVirtualizer.js";
+import type { BaseState, ParamsWithDefaults } from "../useVirtualizer.js";
 import type { RowSpanningState } from "../models/rowspan.js";
-import { Virtualization } from "./virtualization.js";
+import { Virtualization } from "./virtualization/index.js";
 export declare const Rowspan: {
   initialize: typeof initializeState;
   use: typeof useRowspan;
@@ -18,8 +18,8 @@ export declare namespace Rowspan {
   };
   type API = ReturnType<typeof useRowspan>;
 }
-declare function initializeState(params: VirtualizerParams): Rowspan.State;
-declare function useRowspan(store: Store<BaseState & Rowspan.State>, _params: VirtualizerParams, _api: Virtualization.API): {
+declare function initializeState(params: ParamsWithDefaults): Rowspan.State;
+declare function useRowspan(store: Store<BaseState & Rowspan.State>, _params: ParamsWithDefaults, _api: Virtualization.API): {
   getHiddenCellsOrigin: () => Record<number, Record<number, number>>;
 };
 export {};

package/esm/features/virtualization/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./layout.js";
+export * from "./virtualization.js";

package/esm/features/virtualization/index.js

@@ -0,0 +1,2 @@
+export * from "./layout.js";
+export * from "./virtualization.js";

package/esm/features/virtualization/layout.d.ts

@@ -0,0 +1,129 @@
+import * as React from 'react';
+import { Store } from '@mui/x-internals/store';
+import { Dimensions } from "../dimensions.js";
+import { Virtualization, type VirtualizationLayoutParams } from "./virtualization.js";
+import type { BaseState, ParamsWithDefaults } from "../../useVirtualizer.js";
+type RequiredAPI = Dimensions.API;
+type BaseElements = {
+  scroller: React.RefObject<HTMLElement | null>;
+  container: React.RefObject<HTMLElement | null>;
+};
+type AnyElements = BaseElements & Record<string, React.RefObject<HTMLElement | null>>;
+export declare abstract class Layout<E extends AnyElements = AnyElements> {
+  static elements: readonly (keyof AnyElements)[];
+  refs: E;
+  constructor(refs: E);
+  abstract use(store: Store<BaseState>, params: ParamsWithDefaults, api: RequiredAPI, layoutParams: VirtualizationLayoutParams): any;
+  refSetter(name: keyof E): (node: HTMLDivElement | null) => void;
+}
+type DataGridElements = BaseElements & {
+  scrollbarVertical: React.RefObject<HTMLElement | null>;
+  scrollbarHorizontal: React.RefObject<HTMLElement | null>;
+};
+export declare class LayoutDataGrid extends Layout<DataGridElements> {
+  static elements: readonly ["scroller", "container", "content", "positioner", "scrollbarVertical", "scrollbarHorizontal"];
+  use(store: Store<BaseState>, _params: ParamsWithDefaults, _api: RequiredAPI, layoutParams: VirtualizationLayoutParams): void;
+  static selectors: {
+    containerProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      ref: any;
+    };
+    scrollerProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      ref: any;
+      style: {
+        overflowX: string | undefined;
+        overflowY: string | undefined;
+      };
+      role: string;
+      tabIndex: number | undefined;
+    };
+    contentProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      style: React.CSSProperties;
+      role: string;
+    };
+    positionerProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      style: {
+        transform: string;
+      };
+    };
+    scrollbarHorizontalProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      ref: any;
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+    scrollbarVerticalProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      ref: any;
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+    scrollAreaProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+  };
+}
+export declare class LayoutDataGridLegacy extends LayoutDataGrid {
+  use(store: Store<BaseState>, _params: ParamsWithDefaults, _api: RequiredAPI, layoutParams: VirtualizationLayoutParams): {
+    getContainerProps: () => {
+      ref: any;
+    };
+    getScrollerProps: () => {
+      ref: any;
+      style: {
+        overflowX: string | undefined;
+        overflowY: string | undefined;
+      };
+      role: string;
+      tabIndex: number | undefined;
+    };
+    getContentProps: () => {
+      style: React.CSSProperties;
+      role: string;
+    };
+    getPositionerProps: () => {
+      style: {
+        transform: string;
+      };
+    };
+    getScrollbarVerticalProps: () => {
+      ref: any;
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+    getScrollbarHorizontalProps: () => {
+      ref: any;
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+    getScrollAreaProps: () => {
+      scrollPosition: {
+        current: import("../../models/index.js").ScrollPosition;
+      };
+    };
+  };
+}
+type ListElements = BaseElements;
+export declare class LayoutList extends Layout<ListElements> {
+  static elements: readonly ["scroller", "container", "content", "positioner"];
+  use(store: Store<BaseState>, _params: ParamsWithDefaults, _api: RequiredAPI, layoutParams: VirtualizationLayoutParams): void;
+  static selectors: {
+    containerProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      ref: any;
+      style: React.CSSProperties;
+      role: string;
+      tabIndex: number | undefined;
+    };
+    contentProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      style: React.CSSProperties;
+      role: string;
+    };
+    positionerProps: (args_0: Virtualization.State<Layout<AnyElements>> & Dimensions.State) => {
+      style: React.CSSProperties;
+    };
+  };
+}
+export {};