@mui/x-virtualizer 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -5,6 +5,102 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.10.1
+
+_Aug 15, 2025_
+
+We'd like to extend a big thank you to the 8 contributors who made this release possible. Here are some highlights ✨:
+
+- 📊 Y-axes can now be grouped by category when using `band` and `point` scales.
+- 📚 Documentation improvements
+
+The following are all team members who have contributed to this release:
+@alexfauquette, @bernardobelchior, @Janpot, @JCQuintas, @mnajdova, @oliviertassinari, @prakhargupta1, @romgrk
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.10.1`
+
+- [DataGrid] Fix scroll jumping (#19156) @romgrk
+- [DataGrid] Fix scroll restoration (#19182) @romgrk
+- [DataGrid] Fix "no row with id" error (#19193) @romgrk
+
+#### `@mui/x-data-grid-pro@8.10.1` [![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.10.1`.
+
+#### `@mui/x-data-grid-premium@8.10.1` [![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.10.1`.
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.10.0`
+
+Internal changes.
+
+#### `@mui/x-date-pickers-pro@8.10.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.10.0`.
+
+### Charts
+
+- Axes can now be grouped by category when using `band` and `point` scales
+
+  <img width="643" height="455" alt="Bar chart with y-axis grouped per categories" src="https://github.com/user-attachments/assets/59044afe-bcc5-4152-8bf1-225db0635025" />
+
+#### `@mui/x-charts@8.10.1`
+
+- [charts] Allow y-axis to be grouped (#19081) @JCQuintas
+- [charts] Fix default axis highlight for axes without data attribute (#18985) @alexfauquette
+- [charts] Fix tooltip mark unexpected wrapping in mobile (#19122) @bernardobelchior
+- [charts] Prevent overflow on charts tooltip (#19123) @bernardobelchior
+
+#### `@mui/x-charts-pro@8.10.1` [![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.10.1`.
+
+### Tree View
+
+#### `@mui/x-tree-view@8.10.1`
+
+Internal changes.
+
+#### `@mui/x-tree-view-pro@8.10.1` [![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.10.1`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.10.1`
+
+Internal changes.
+
+### Docs
+
+- [docs] Add all planned charts on the overview page (#19077) @prakhargupta1
+- [docs] Add future charts components link in the sidebar (#19140) @prakhargupta1
+- [docs] Fix Heatmap docs duplicate text (#19138) @JCQuintas
+- [docs] Remove preview from Toolbar & Funnel (#19131) @mnajdova
+- [docs] Reproduce npm sparkline (#19089) @alexfauquette
+
+### Core
+
+- [core] Fix licensing model name (#19025) @oliviertassinari
+- [core] Fix usage of `:catalog` for `@babel/runtime` (#19028) @oliviertassinari
+- [core] Refactor virtualizer API (#18995) @romgrk
+
+### Miscellaneous
+
+- [code-infra] Remove namespaces (#19071) @Janpot
+- [code-infra] Fix `fs-extra` removal from `formattedTSDemos` script (#19132) @bernardobelchior
+- [code-infra] Remove unused code and dependency (#19139) @bernardobelchior
+- [code-infra] Replace `fs-extra` with `node:fs` where possible (#19127) @bernardobelchior
+- [internal] Edit, keep `lockFileMaintenance` simple @oliviertassinari
+- [internal] Fix writing style action name @oliviertassinari
+- [internal] Make it clear that `lockFileMaintenance` is enabled @oliviertassinari
+- [support-infra] Remove default issue label (#19104) @oliviertassinari
+
 ## 8.10.0
 
 _Aug 8, 2025_

package/esm/features/colspan.d.ts

@@ -6,6 +6,10 @@ import type { CellColSpanInfo } from "../models/colspan.js";
 import { Virtualization } from "./virtualization.js";
 type ColumnIndex = number;
 type ColspanMap = Map<RowId, Record<ColumnIndex, CellColSpanInfo>>;
+export type ColspanParams = {
+  enabled: boolean;
+  getColspan: (rowId: RowId, column: ColumnWithWidth, columnIndex: integer) => integer;
+};
 export declare const Colspan: {
   initialize: typeof initializeState;
   use: typeof useColspan;

package/esm/features/colspan.js

@@ -14,6 +14,7 @@ function initializeState(_params) {
   };
 }
 function useColspan(store, params, api) {
+  const getColspan = params.colspan?.getColspan;
   const resetColSpan = () => {
     store.state.colspanMap = new Map();
   };
@@ -22,14 +23,14 @@ function useColspan(store, params, api) {
   };
 
   // Calculate `colSpan` for each cell in the row
-  const calculateColSpan = useEventCallback((rowId, minFirstColumn, maxLastColumn, columns) => {
+  const calculateColSpan = useEventCallback(getColspan ? (rowId, minFirstColumn, maxLastColumn, columns) => {
     for (let i = minFirstColumn; i < maxLastColumn; i += 1) {
-      const cellProps = calculateCellColSpan(store.state.colspanMap, i, rowId, minFirstColumn, maxLastColumn, columns, params.getColspan);
+      const cellProps = calculateCellColSpan(store.state.colspanMap, i, rowId, minFirstColumn, maxLastColumn, columns, getColspan);
       if (cellProps.colSpan > 1) {
         i += cellProps.colSpan - 1;
       }
     }
-  });
+  } : () => {});
   api.calculateColSpan = calculateColSpan;
   return {
     resetColSpan,

package/esm/features/dimensions.d.ts

@@ -1,6 +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";
+export type DimensionsParams = {
+  rowHeight: number;
+  columnsTotalWidth: number;
+  leftPinnedWidth: number;
+  rightPinnedWidth: number;
+  topPinnedHeight: number;
+  bottomPinnedHeight: number;
+  scrollbarSize?: number;
+};
 export declare const Dimensions: {
   initialize: typeof initializeState;
   use: typeof useDimensions;
@@ -8,6 +17,7 @@ export declare const Dimensions: {
     rootSize: (state: BaseState) => Size;
     dimensions: (state: BaseState) => DimensionsState;
     rowHeight: (state: BaseState) => number;
+    contentHeight: (state: BaseState) => number;
     rowsMeta: (state: BaseState) => RowsMetaState;
     columnPositions: (_: any, columns: ColumnWithWidth[]) => number[];
     needsHorizontalScrollbar: (state: BaseState) => boolean;

package/esm/features/dimensions.js

@@ -9,8 +9,9 @@ import useEventCallback from '@mui/utils/useEventCallback';
 import { throttle } from '@mui/x-internals/throttle';
 import { isDeepEqual } from '@mui/x-internals/isDeepEqual';
 import { roundToDecimalPlaces } from '@mui/x-internals/math';
-import { useStore, useStoreEffect, createSelectorMemoized } from '@mui/x-internals/store';
+import { useStore, createSelectorMemoized } from '@mui/x-internals/store';
 import { Size } from "../models/index.js";
+
 /* eslint-disable import/export, @typescript-eslint/no-redeclare */
 /* eslint-disable no-underscore-dangle */
 
@@ -24,15 +25,11 @@ const EMPTY_DIMENSIONS = {
   hasScrollX: false,
   hasScrollY: false,
   scrollbarSize: 0,
-  headerHeight: 0,
-  groupHeaderHeight: 0,
-  headerFilterHeight: 0,
   rowWidth: 0,
   rowHeight: 0,
   columnsTotalWidth: 0,
   leftPinnedWidth: 0,
   rightPinnedWidth: 0,
-  headersTotalHeight: 0,
   topContainerHeight: 0,
   bottomContainerHeight: 0
 };
@@ -40,6 +37,7 @@ const selectors = {
   rootSize: state => state.rootSize,
   dimensions: state => state.dimensions,
   rowHeight: state => state.dimensions.rowHeight,
+  contentHeight: state => state.dimensions.contentSize.height,
   rowsMeta: state => state.rowsMeta,
   columnPositions: createSelectorMemoized((_, columns) => {
     const positions = [];
@@ -87,15 +85,15 @@ function useDimensions(store, params, _api) {
     refs,
     dimensions: {
       rowHeight,
-      headerHeight,
       columnsTotalWidth,
-      groupHeaderHeight,
-      headerFilterHeight,
-      headersTotalHeight,
       leftPinnedWidth,
-      rightPinnedWidth
-    }
+      rightPinnedWidth,
+      topPinnedHeight,
+      bottomPinnedHeight
+    },
+    onResize
   } = params;
+  const containerNode = refs.container.current;
   const updateDimensions = React.useCallback(() => {
     if (isFirstSizing.current) {
       return;
@@ -106,9 +104,9 @@ function useDimensions(store, params, _api) {
     // All the floating point dimensions should be rounded to .1 decimal places to avoid subpixel rendering issues
     // https://github.com/mui/mui-x/issues/9550#issuecomment-1619020477
     // https://github.com/mui/mui-x/issues/15721
-    const scrollbarSize = measureScrollbarSize(params.refs.container.current, params.scrollbarSize);
-    const topContainerHeight = headersTotalHeight + rowsMeta.pinnedTopRowsTotalHeight;
-    const bottomContainerHeight = rowsMeta.pinnedBottomRowsTotalHeight;
+    const scrollbarSize = measureScrollbarSize(containerNode, params.dimensions.scrollbarSize);
+    const topContainerHeight = topPinnedHeight + rowsMeta.pinnedTopRowsTotalHeight;
+    const bottomContainerHeight = bottomPinnedHeight + rowsMeta.pinnedBottomRowsTotalHeight;
     const contentSize = {
       width: columnsTotalWidth,
       height: roundToDecimalPlaces(rowsMeta.currentPageTotalHeight, 1)
@@ -172,15 +170,11 @@ function useDimensions(store, params, _api) {
       hasScrollX,
       hasScrollY,
       scrollbarSize,
-      headerHeight,
-      groupHeaderHeight,
-      headerFilterHeight,
       rowWidth,
       rowHeight,
       columnsTotalWidth,
       leftPinnedWidth,
       rightPinnedWidth,
-      headersTotalHeight,
       topContainerHeight,
       bottomContainerHeight
     };
@@ -191,21 +185,16 @@ function useDimensions(store, params, _api) {
     store.update({
       dimensions: newDimensions
     });
-  }, [store, params.refs.container, params.scrollbarSize, params.autoHeight, rowHeight, headerHeight, groupHeaderHeight, headerFilterHeight, columnsTotalWidth, headersTotalHeight, leftPinnedWidth, rightPinnedWidth]);
+    onResize?.(newDimensions.root);
+  }, [store, containerNode, params.dimensions.scrollbarSize, params.autoHeight, onResize, rowHeight, columnsTotalWidth, leftPinnedWidth, rightPinnedWidth, topPinnedHeight, bottomPinnedHeight]);
   const {
-    resizeThrottleMs,
-    onResize
+    resizeThrottleMs
   } = params;
   const updateDimensionCallback = useEventCallback(updateDimensions);
-  const debouncedUpdateDimensions = React.useMemo(() => resizeThrottleMs > 0 ? throttle(() => {
-    updateDimensionCallback();
-    onResize?.(store.state.rootSize);
-  }, resizeThrottleMs) : undefined, [resizeThrottleMs, onResize, store, updateDimensionCallback]);
+  const debouncedUpdateDimensions = React.useMemo(() => resizeThrottleMs > 0 ? throttle(updateDimensionCallback, resizeThrottleMs) : undefined, [resizeThrottleMs, updateDimensionCallback]);
   React.useEffect(() => debouncedUpdateDimensions?.clear, [debouncedUpdateDimensions]);
-  useLayoutEffect(() => observeRootNode(refs.container.current, store), [refs, store]);
-  useLayoutEffect(updateDimensions, [updateDimensions]);
-  useStoreEffect(store, selectors.rootSize, (_, size) => {
-    params.onResize?.(size);
+  const setRootSize = useEventCallback(rootSize => {
+    store.state.rootSize = rootSize;
     if (isFirstSizing.current || !debouncedUpdateDimensions) {
       // We want to initialize the grid dimensions as soon as possible to avoid flickering
       isFirstSizing.current = false;
@@ -214,6 +203,8 @@ function useDimensions(store, params, _api) {
       debouncedUpdateDimensions();
     }
   });
+  useLayoutEffect(() => observeRootNode(containerNode, store, setRootSize), [containerNode, store, setRootSize]);
+  useLayoutEffect(updateDimensions, [updateDimensions]);
   const rowsMeta = useRowsMeta(store, params, updateDimensions);
   return {
     updateDimensions,
@@ -250,7 +241,6 @@ function useRowsMeta(store, params, updateDimensions) {
     return entry;
   });
   const {
-    rowIdToIndexMap,
     applyRowHeight
   } = params;
   const processHeightEntry = React.useCallback(row => {
@@ -282,12 +272,7 @@ function useRowsMeta(store, params, updateDimensions) {
       }
     }
     if (getRowSpacing) {
-      const indexRelativeToCurrentPage = rowIdToIndexMap.get(row.id) ?? -1;
-      const spacing = getRowSpacing(row, {
-        isFirstVisible: indexRelativeToCurrentPage === 0,
-        isLastVisible: indexRelativeToCurrentPage === rows.length - 1,
-        indexRelativeToCurrentPage
-      });
+      const spacing = getRowSpacing(row);
       entry.spacingTop = spacing.top ?? 0;
       entry.spacingBottom = spacing.bottom ?? 0;
     } else {
@@ -296,17 +281,17 @@ function useRowsMeta(store, params, updateDimensions) {
     }
     applyRowHeight?.(entry, row);
     return entry;
-  }, [store, rows, getRowHeightProp, getRowHeightEntry, getEstimatedRowHeight, rowHeight, getRowSpacing, rowIdToIndexMap, applyRowHeight]);
+  }, [store, getRowHeightProp, getRowHeightEntry, getEstimatedRowHeight, rowHeight, getRowSpacing, applyRowHeight]);
   const hydrateRowsMeta = React.useCallback(() => {
     hasRowWithAutoHeight.current = false;
-    const pinnedTopRowsTotalHeight = pinnedRows.top.reduce((acc, row) => {
+    const pinnedTopRowsTotalHeight = pinnedRows?.top.reduce((acc, row) => {
       const entry = processHeightEntry(row);
       return acc + entry.content + entry.spacingTop + entry.spacingBottom + entry.detail;
-    }, 0);
-    const pinnedBottomRowsTotalHeight = pinnedRows.bottom.reduce((acc, row) => {
+    }, 0) ?? 0;
+    const pinnedBottomRowsTotalHeight = pinnedRows?.bottom.reduce((acc, row) => {
       const entry = processHeightEntry(row);
       return acc + entry.content + entry.spacingTop + entry.spacingBottom + entry.detail;
-    }, 0);
+    }, 0) ?? 0;
     const positions = [];
     const currentPageTotalHeight = rows.reduce((acc, row) => {
       positions.push(acc);
@@ -362,7 +347,7 @@ function useRowsMeta(store, params, updateDimensions) {
       const entry = entries[i];
       const height = entry.borderBoxSize && entry.borderBoxSize.length > 0 ? entry.borderBoxSize[0].blockSize : entry.contentRect.height;
       const rowId = entry.target.__mui_id;
-      const focusedVirtualRowId = params.focusedVirtualCell()?.id;
+      const focusedVirtualRowId = params.focusedVirtualCell?.()?.id;
       if (focusedVirtualRowId === rowId && height === 0) {
         // Focused virtual row has 0 height.
         // We don't want to store it to avoid scroll jumping.
@@ -401,7 +386,7 @@ function useRowsMeta(store, params, updateDimensions) {
     resetRowHeights
   };
 }
-function observeRootNode(node, store) {
+function observeRootNode(node, store, setRootSize) {
   if (!node) {
     return undefined;
   }
@@ -411,9 +396,7 @@ function observeRootNode(node, store) {
     height: roundToDecimalPlaces(bounds.height, 1)
   };
   if (store.state.rootSize === Size.EMPTY || !Size.equals(initialSize, store.state.rootSize)) {
-    store.update({
-      rootSize: initialSize
-    });
+    setRootSize(initialSize);
   }
   if (typeof ResizeObserver === 'undefined') {
     return undefined;
@@ -427,9 +410,7 @@ function observeRootNode(node, store) {
       height: roundToDecimalPlaces(entry.contentRect.height, 1)
     };
     if (!Size.equals(rootSize, store.state.rootSize)) {
-      store.update({
-        rootSize
-      });
+      setRootSize(rootSize);
     }
   });
   observer.observe(node);

package/esm/features/virtualization.d.ts

@@ -5,6 +5,16 @@ import type { CellColSpanInfo } from "../models/colspan.js";
 import { Dimensions } from "./dimensions.js";
 import type { BaseState, VirtualizerParams } from "../useVirtualizer.js";
 import { PinnedRowPosition, RenderContext, ColumnsRenderContext, ColumnWithWidth, RowId, RowEntry } from "../models/index.js";
+export type VirtualizationParams = {
+  /** @default false */
+  isRtl?: boolean;
+  /** The row buffer in pixels to render before and after the viewport.
+   * @default 150 */
+  rowBufferPx?: number;
+  /** The column buffer in pixels to render before and after the viewport.
+   * @default 150 */
+  columnBufferPx?: number;
+};
 export type VirtualizationState = {
   enabled: boolean;
   enabledForRows: boolean;
@@ -44,16 +54,16 @@ type RequiredAPI = Dimensions.API & AbstractAPI;
 declare function useVirtualization(store: Store<BaseState>, params: VirtualizerParams, api: RequiredAPI): {
   getters: {
     setPanels: React.Dispatch<React.SetStateAction<Readonly<Map<any, React.ReactNode>>>>;
-    getRows: (rowParams: {
+    getRows: (rowParams?: {
       rows?: RowEntry[];
       position?: PinnedRowPosition;
       renderContext?: RenderContext;
-    } | undefined, unstable_rowTree: Record<RowId, any>) => React.ReactNode[];
+    }, unstable_rowTree?: Record<RowId, any>) => React.ReactNode[];
     getContainerProps: () => {
-      ref: React.RefObject<HTMLDivElement | null>;
+      ref: (node: HTMLDivElement | null) => void;
     };
     getScrollerProps: () => {
-      ref: React.RefObject<HTMLDivElement | null>;
+      ref: (node: HTMLDivElement | null) => void;
       onScroll: () => void;
       onWheel: ((event: React.WheelEvent) => void) | undefined;
       onTouchMove: ((event: React.TouchEvent) => void) | undefined;
@@ -62,22 +72,19 @@ declare function useVirtualization(store: Store<BaseState>, params: VirtualizerP
       tabIndex: number | undefined;
     };
     getContentProps: () => {
-      style: React.CSSProperties;
-      role: string;
       ref: (node: HTMLDivElement | null) => void;
-    };
-    getRenderZoneProps: () => {
+      style: React.CSSProperties;
       role: string;
     };
     getScrollbarVerticalProps: () => {
-      ref: React.RefObject<HTMLDivElement | null>;
+      ref: (node: HTMLDivElement | null) => void;
       scrollPosition: React.RefObject<{
         top: number;
         left: number;
       }>;
     };
     getScrollbarHorizontalProps: () => {
-      ref: React.RefObject<HTMLDivElement | null>;
+      ref: (node: HTMLDivElement | null) => void;
       scrollPosition: React.RefObject<{
         top: number;
         left: number;