@mui/x-data-grid-premium 8.12.0 → 8.13.0

package/CHANGELOG.md

@@ -5,6 +5,151 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.13.0
+
+_Oct 1, 2025_
+
+We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
+
+- 📊 The chart zoom now supports the `tapAndDrag` gesture. Zoom in/out by tapping twice and dragging vertically.
+- 🔎 Charts now allow [fine-grained control for zoom interactions](https://mui.com/x/react-charts/zoom-and-pan/#zoom-interactions-configuration).
+  ```jsx
+  <BarChartPro
+    zoomInteractionConfig={{
+      // Only zoom when Control key is pressed
+      zoom: [{ type: 'wheel', keys: ['Control'] }],
+      // Only pan when Shift key is pressed
+      pan: [{ type: 'drag', keys: ['Shift'] }],
+    }}
+  />
+  ```
+- ➡️ Data Grid grouping rows now persist their expansion state when the rows are updated.
+- 📜 Updated Data Grid vertical scrollbar to include pinned rows and aggregation sections.
+- 📌 Improved the appearance of [pinned columns](https://mui.com/x/react-data-grid/column-pinning/#pinned-columns-appearance) and [pinned rows](https://mui.com/x/react-data-grid/row-pinning/#pinned-rows-appearance) sections in the Data Grid.
+- 🚀 Tree View now fetches the children of expanded items on mount when using lazy loading.
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+Special thanks go out to the community members for their valuable contributions:
+@sai6855
+
+The following are all team members who have contributed to this release:
+@alexfauquette, @arminmeh, @bernardobelchior, @flaviendelangle, @hasdfa, @Janpot, @JCQuintas, @KenanYusuf, @mapache-salvaje, @MBilalShafi, @mnajdova, @rita-codes, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.13.0`
+
+- [DataGrid] Add scroll shadows and fix scrollbar overlap (#16476) @KenanYusuf
+- [DataGrid] Fix row spanning stale state issue (#19733) @MBilalShafi
+- [DataGrid] Fix toolbar `slotProps` not being applied (#19769) @sai6855
+- [DataGrid] Skip calling `fetchRows()` when strategy is not initialized (#19728) @MBilalShafi
+
+#### `@mui/x-data-grid-pro@8.13.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.13.0`, plus:
+
+- [DataGridPro] Retain expansion state on rows update (#19697) @MBilalShafi
+
+#### `@mui/x-data-grid-premium@8.13.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.13.0`, plus:
+
+- [DataGridPremium] Add `metadata.referenceId` to AI assistant prompt resolver (#19695) @hasdfa
+- [DataGridPremium] Fix aggregation value retrieval (#19724) @arminmeh
+- [DataGridPremium] Get correct active chart id while rebuilding data (#19720) @arminmeh
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.12.0`
+
+Internal changes.
+
+#### `@mui/x-date-pickers-pro@8.12.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.12.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.13.0`
+
+- [charts] Add `tapAndDrag` zoom gesture (#19727) @JCQuintas
+- [charts] Add arc focus indicator that follows the arc form (#19696) @mnajdova
+- [charts] Fix outline color (#19752) @alexfauquette
+- [charts] Improve tooltip doc (#19731) @JCQuintas
+- [charts] Make axis highlight reflect the keyboard interaction (#19631) @alexfauquette
+- [charts] Prevent horizontal scroll on keyboard navigation (#19704) @alexfauquette
+- [charts] Simplify gestures by removing bindings (#19767) @JCQuintas
+
+#### `@mui/x-charts-pro@8.13.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.13.0`, plus:
+
+- [charts-pro] Allow zoom interactions to be configured (#18646) @JCQuintas
+- [charts-pro] Fix zoom preview having wrong domain in some cases (#19723) @bernardobelchior
+
+#### `@mui/x-charts-premium@8.13.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.13.0`.
+
+### Tree View
+
+#### `@mui/x-tree-view@8.13.0`
+
+- [tree view] Export the `apiRef` type of each Tree View component (#19543) @flaviendelangle
+- [tree view] Fix indeterminate checkbox state (#19544) @flaviendelangle
+- [tree view] Improve the lazy loading initial expansion (#19284) @flaviendelangle
+- [tree view] Use Base UI utils whenever possible (#19502) @flaviendelangle
+
+#### `@mui/x-tree-view-pro@8.13.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.13.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.12.0`
+
+Internal changes.
+
+### Docs
+
+- [docs] Add a recipe to customize editing component with Autocomplete (#19651) @siriwatknp
+- [docs] Refine the electricity scatter tooltip (#19689) @alexfauquette
+- [docs] Revise the Axis doc (#19052) @mapache-salvaje
+- [docs] Remove reference to nonexistent `FocusedMark` API page (#19773) @bernardobelchior
+
+### Core
+
+- [code-infra] Change charts codspeed integration to use walltime (#19729) @JCQuintas
+- [code-infra] Port stylelint from core repo (#19633) @Janpot
+- [code-infra] Stabilize fake timers in regression tests (#19719) @Janpot
+- [code-infra] Stabilize size for bundles with `releaseInfo` (#19674) @Janpot
+- [code-infra] Fix `pnpm-lock.yaml` broken lockfile (#19755) @bernardobelchior
+
+## 8.12.1
+
+_Sep 25, 2025_
+
+Release highlight ✨:
+
+- 🐞 Hotfix for Grid-Charts integration issue with aggregated values
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.12.1`
+
+Internal changes.
+
+#### `@mui/x-data-grid-pro@8.12.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.12.1`.
+
+#### `@mui/x-data-grid-premium@8.12.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.12.1`, plus:
+
+- [DataGridPremium] Collect aggregated values properly for the charts integration context (#19714) @arminmeh
+
 ## 8.12.0
 
 _Sep 25, 2025_

package/DataGridPremium/DataGridPremium.js

@@ -23,6 +23,7 @@ var _useGridRowAriaAttributes = require("../hooks/features/rows/useGridRowAriaAt
 var _gridAggregationSelectors = require("../hooks/features/aggregation/gridAggregationSelectors");
 var _useGridApiContext = require("../hooks/utils/useGridApiContext");
 var _useGridRowsOverridableMethods = require("../hooks/features/rows/useGridRowsOverridableMethods");
+var _useGridParamsOverridableMethods = require("../hooks/features/rows/useGridParamsOverridableMethods");
 var _sidebar2 = require("../hooks/features/sidebar");
 var _jsxRuntime = require("react/jsx-runtime");
 const configuration = {
@@ -37,23 +38,17 @@ const configuration = {
         field
       });
     },
-    useSortValueGetter: apiRef => (id, field) => (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
-      id,
-      field
-    })?.value ?? apiRef.current.getCellValue(id, field),
     useFilterValueGetter: (apiRef, props) => (row, column) => {
-      if (props.aggregationRowsScope === 'filtered') {
+      if (props.aggregationRowsScope === 'all') {
         return apiRef.current.getRowValue(row, column);
       }
-      return (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
-        id: (0, _xDataGridPro.gridRowIdSelector)(apiRef, row),
-        field: column.field
-      })?.value ?? apiRef.current.getRowValue(row, column);
+      return (0, _internals.getRowValue)(row, column, apiRef);
     },
-    useGridRowsOverridableMethods: _useGridRowsOverridableMethods.useGridRowsOverridableMethods
+    useGridRowsOverridableMethods: _useGridRowsOverridableMethods.useGridRowsOverridableMethods,
+    useGridParamsOverridableMethods: _useGridParamsOverridableMethods.useGridParamsOverridableMethods
   }
 };
-const releaseInfo = "MTc1ODc1MTIwMDAwMA==";
+const releaseInfo = "MTc1OTI3NjgwMDAwMA==";
 const watermark = /*#__PURE__*/(0, _jsxRuntime.jsx)(_xLicense.Watermark, {
   packageName: "x-data-grid-premium",
   releaseInfo: releaseInfo
@@ -1099,6 +1094,11 @@ process.env.NODE_ENV !== "production" ? DataGridPremiumRaw.propTypes = {
    * The column fields to display pinned to left or right.
    */
   pinnedColumns: _propTypes.default.object,
+  /**
+   * Sets the type of separator between pinned columns and non-pinned columns.
+   * @default 'border-and-shadow'
+   */
+  pinnedColumnsSectionSeparator: _propTypes.default.oneOf(['border-and-shadow', 'border', 'shadow']),
   /**
    * Rows data to pin on top or bottom.
    */
@@ -1106,6 +1106,11 @@ process.env.NODE_ENV !== "production" ? DataGridPremiumRaw.propTypes = {
     bottom: _propTypes.default.arrayOf(_propTypes.default.object),
     top: _propTypes.default.arrayOf(_propTypes.default.object)
   }),
+  /**
+   * Sets the type of separator between pinned rows and non-pinned rows.
+   * @default 'border-and-shadow'
+   */
+  pinnedRowsSectionSeparator: _propTypes.default.oneOf(['border-and-shadow', 'border']),
   /**
    * If `true`, the data grid will show data in pivot mode using the `pivotModel`.
    * @default false

package/DataGridPremium/useDataGridPremiumComponent.js

@@ -115,7 +115,7 @@ const useDataGridPremiumComponent = (apiRef, inProps, configuration) => {
   (0, _internals.useGridColumns)(apiRef, props);
   (0, _internals.useGridRows)(apiRef, props, configuration);
   (0, _internals.useGridRowSpanning)(apiRef, props);
-  (0, _internals.useGridParamsApi)(apiRef, props);
+  (0, _internals.useGridParamsApi)(apiRef, props, configuration);
   (0, _internals.useGridDetailPanel)(apiRef, props);
   (0, _internals.useGridColumnSpanning)(apiRef);
   (0, _internals.useGridColumnGrouping)(apiRef, props);
@@ -124,7 +124,7 @@ const useDataGridPremiumComponent = (apiRef, inProps, configuration) => {
   (0, _internals.useGridFocus)(apiRef, props);
   (0, _internals.useGridPreferencesPanel)(apiRef, props);
   (0, _internals.useGridFilter)(apiRef, props, configuration);
-  (0, _internals.useGridSorting)(apiRef, props, configuration);
+  (0, _internals.useGridSorting)(apiRef, props);
   (0, _internals.useGridDensity)(apiRef, props);
   (0, _internals.useGridColumnReorder)(apiRef, props);
   (0, _internals.useGridColumnResize)(apiRef, props);

package/esm/DataGridPremium/DataGridPremium.js

@@ -4,8 +4,8 @@ import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
 import PropTypes from 'prop-types';
 import { useLicenseVerifier, Watermark } from '@mui/x-license';
-import { GridRoot, GridContextProvider, useGridSelector, gridRowIdSelector } from '@mui/x-data-grid-pro';
-import { propValidatorsDataGrid, propValidatorsDataGridPro, validateProps, useGridApiInitialization } from '@mui/x-data-grid-pro/internals';
+import { GridRoot, GridContextProvider, useGridSelector } from '@mui/x-data-grid-pro';
+import { propValidatorsDataGrid, propValidatorsDataGridPro, validateProps, useGridApiInitialization, getRowValue } from '@mui/x-data-grid-pro/internals';
 import { useMaterialCSSVariables } from '@mui/x-data-grid/material';
 import { forwardRef } from '@mui/x-internals/forwardRef';
 import { useDataGridPremiumComponent } from "./useDataGridPremiumComponent.js";
@@ -16,6 +16,7 @@ import { useGridRowAriaAttributesPremium } from "../hooks/features/rows/useGridR
 import { gridCellAggregationResultSelector } from "../hooks/features/aggregation/gridAggregationSelectors.js";
 import { useGridApiContext } from "../hooks/utils/useGridApiContext.js";
 import { useGridRowsOverridableMethods } from "../hooks/features/rows/useGridRowsOverridableMethods.js";
+import { useGridParamsOverridableMethods } from "../hooks/features/rows/useGridParamsOverridableMethods.js";
 import { gridSidebarOpenSelector } from "../hooks/features/sidebar/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const configuration = {
@@ -30,23 +31,17 @@ const configuration = {
         field
       });
     },
-    useSortValueGetter: apiRef => (id, field) => gridCellAggregationResultSelector(apiRef, {
-      id,
-      field
-    })?.value ?? apiRef.current.getCellValue(id, field),
     useFilterValueGetter: (apiRef, props) => (row, column) => {
-      if (props.aggregationRowsScope === 'filtered') {
+      if (props.aggregationRowsScope === 'all') {
         return apiRef.current.getRowValue(row, column);
       }
-      return gridCellAggregationResultSelector(apiRef, {
-        id: gridRowIdSelector(apiRef, row),
-        field: column.field
-      })?.value ?? apiRef.current.getRowValue(row, column);
+      return getRowValue(row, column, apiRef);
     },
-    useGridRowsOverridableMethods
+    useGridRowsOverridableMethods,
+    useGridParamsOverridableMethods
   }
 };
-const releaseInfo = "MTc1ODc1MTIwMDAwMA==";
+const releaseInfo = "MTc1OTI3NjgwMDAwMA==";
 const watermark = /*#__PURE__*/_jsx(Watermark, {
   packageName: "x-data-grid-premium",
   releaseInfo: releaseInfo
@@ -1092,6 +1087,11 @@ process.env.NODE_ENV !== "production" ? DataGridPremiumRaw.propTypes = {
    * The column fields to display pinned to left or right.
    */
   pinnedColumns: PropTypes.object,
+  /**
+   * Sets the type of separator between pinned columns and non-pinned columns.
+   * @default 'border-and-shadow'
+   */
+  pinnedColumnsSectionSeparator: PropTypes.oneOf(['border-and-shadow', 'border', 'shadow']),
   /**
    * Rows data to pin on top or bottom.
    */
@@ -1099,6 +1099,11 @@ process.env.NODE_ENV !== "production" ? DataGridPremiumRaw.propTypes = {
     bottom: PropTypes.arrayOf(PropTypes.object),
     top: PropTypes.arrayOf(PropTypes.object)
   }),
+  /**
+   * Sets the type of separator between pinned rows and non-pinned rows.
+   * @default 'border-and-shadow'
+   */
+  pinnedRowsSectionSeparator: PropTypes.oneOf(['border-and-shadow', 'border']),
   /**
    * If `true`, the data grid will show data in pivot mode using the `pivotModel`.
    * @default false

package/esm/DataGridPremium/useDataGridPremiumComponent.js

@@ -107,7 +107,7 @@ export const useDataGridPremiumComponent = (apiRef, inProps, configuration) => {
   useGridColumns(apiRef, props);
   useGridRows(apiRef, props, configuration);
   useGridRowSpanning(apiRef, props);
-  useGridParamsApi(apiRef, props);
+  useGridParamsApi(apiRef, props, configuration);
   useGridDetailPanel(apiRef, props);
   useGridColumnSpanning(apiRef);
   useGridColumnGrouping(apiRef, props);
@@ -116,7 +116,7 @@ export const useDataGridPremiumComponent = (apiRef, inProps, configuration) => {
   useGridFocus(apiRef, props);
   useGridPreferencesPanel(apiRef, props);
   useGridFilter(apiRef, props, configuration);
-  useGridSorting(apiRef, props, configuration);
+  useGridSorting(apiRef, props);
   useGridDensity(apiRef, props);
   useGridColumnReorder(apiRef, props);
   useGridColumnResize(apiRef, props);

package/esm/hooks/features/aiAssistant/gridAiAssistantInterfaces.d.ts

@@ -59,6 +59,15 @@ export type PromptResolverOptions = {
    * Additional context to make the processing results more accurate.
    */
   additionalContext?: string;
+  /**
+   * Additional metadata to track the usage for each unique user.
+   */
+  metadata?: {
+    /**
+     * The reference ID that would be stored for you to identify the entity that made the request and then to be able to track the usage for each unique user/entity.
+     */
+    referenceId?: string;
+  };
 };
 /**
  * The prompt API interface that is available in the grid [[apiRef]].

package/esm/hooks/features/chartsIntegration/useGridChartsIntegration.d.ts

@@ -3,6 +3,6 @@ import { GridStateInitializer } from '@mui/x-data-grid-pro/internals';
 import type { DataGridPremiumProcessedProps } from "../../../models/dataGridPremiumProps.js";
 import { GridPrivateApiPremium } from "../../../models/gridApiPremium.js";
 import { ChartState } from "../../../models/gridChartsIntegration.js";
-export declare const chartsIntegrationStateInitializer: GridStateInitializer<Pick<DataGridPremiumProcessedProps, 'chartsIntegration' | 'initialState' | 'activeChartId' | 'rowGroupingModel' | 'pivotModel' | 'experimentalFeatures'>, GridPrivateApiPremium>;
 export declare const EMPTY_CHART_INTEGRATION_CONTEXT_STATE: ChartState;
+export declare const chartsIntegrationStateInitializer: GridStateInitializer<Pick<DataGridPremiumProcessedProps, 'chartsIntegration' | 'initialState' | 'activeChartId' | 'rowGroupingModel' | 'pivotModel' | 'experimentalFeatures'>, GridPrivateApiPremium>;
 export declare const useGridChartsIntegration: (apiRef: RefObject<GridPrivateApiPremium>, props: Pick<DataGridPremiumProcessedProps, "chartsIntegration" | "activeChartId" | "onActiveChartIdChange" | "initialState" | "slots" | "slotProps" | "aggregationFunctions" | "dataSource" | "experimentalFeatures">) => void;

package/esm/hooks/features/chartsIntegration/useGridChartsIntegration.js

@@ -15,6 +15,17 @@ import { getAggregationFunctionLabel, getAvailableAggregationFunctions } from ".
 import { gridAggregationModelSelector } from "../aggregation/gridAggregationSelectors.js";
 import { gridPivotModelSelector } from "../pivoting/gridPivotingSelectors.js";
 import { jsx as _jsx } from "react/jsx-runtime";
+const EMPTY_CHART_INTEGRATION_CONTEXT = {
+  chartStateLookup: {},
+  setChartState: () => {}
+};
+export const EMPTY_CHART_INTEGRATION_CONTEXT_STATE = {
+  synced: true,
+  dimensions: [],
+  values: [],
+  type: '',
+  configuration: {}
+};
 export const chartsIntegrationStateInitializer = (state, props) => {
   if (!props.chartsIntegration || !props.experimentalFeatures?.charts) {
     return _extends({}, state, {
@@ -44,17 +55,6 @@ export const chartsIntegrationStateInitializer = (state, props) => {
     }
   });
 };
-const EMPTY_CHART_INTEGRATION_CONTEXT = {
-  chartStateLookup: {},
-  setChartState: () => {}
-};
-export const EMPTY_CHART_INTEGRATION_CONTEXT_STATE = {
-  synced: true,
-  dimensions: [],
-  values: [],
-  type: '',
-  configuration: {}
-};
 export const useGridChartsIntegration = (apiRef, props) => {
   const visibleDimensions = React.useRef({});
   const visibleValues = React.useRef({});
@@ -173,7 +173,8 @@ export const useGridChartsIntegration = (apiRef, props) => {
     const rowGroupingModel = gridRowGroupingSanitizedModelSelector(apiRef);
     const rowTree = gridRowTreeSelector(apiRef);
     const rowsPerDepth = gridFilteredSortedDepthRowEntriesSelector(apiRef);
-    const defaultDepth = Math.max(0, (visibleDimensions.current[activeChartId]?.length ?? 0) - 1);
+    const currentChartId = gridChartsIntegrationActiveChartIdSelector(apiRef);
+    const defaultDepth = Math.max(0, (visibleDimensions.current[currentChartId]?.length ?? 0) - 1);
     const rowsAtDefaultDepth = (rowsPerDepth[defaultDepth] ?? []).length;
 
     // keep only unique columns and transform the grouped column to carry the correct field name to get the grouped value
@@ -225,7 +226,7 @@ export const useGridChartsIntegration = (apiRef, props) => {
         }))
       });
     });
-  }, [apiRef, activeChartId, orderedFields, getColumnName, getValueDatasetLabel, setChartState]);
+  }, [apiRef, orderedFields, getColumnName, getValueDatasetLabel, setChartState]);
   const debouncedHandleRowDataUpdate = React.useMemo(() => debounce(handleRowDataUpdate, 0), [handleRowDataUpdate]);
   const handleColumnDataUpdate = React.useCallback((chartIds, updatedChartStateLookup) => {
     // if there are no charts, skip the data processing

package/esm/hooks/features/rows/useGridParamsOverridableMethods.d.ts

@@ -0,0 +1,7 @@
+import type { RefObject } from '@mui/x-internals/types';
+import type { GridPrivateApiPremium } from "../../../models/gridApiPremium.js";
+export declare const useGridParamsOverridableMethods: (apiRef: RefObject<GridPrivateApiPremium>) => {
+  getCellValue: <V = any>(id: import("@mui/x-data-grid").GridRowId, field: string) => V;
+  getRowValue: <V = any>(row: import("@mui/x-data-grid").GridRowModel, colDef: import("@mui/x-data-grid").GridColDef) => V;
+  getRowFormattedValue: <V = any>(row: import("@mui/x-data-grid").GridRowModel, colDef: import("@mui/x-data-grid").GridColDef) => V;
+};

package/esm/hooks/features/rows/useGridParamsOverridableMethods.js

@@ -0,0 +1,24 @@
+import * as React from 'react';
+import { gridRowIdSelector } from '@mui/x-data-grid-pro';
+import { useGridParamsOverridableMethods as useGridParamsOverridableMethodsCommunity } from '@mui/x-data-grid-pro/internals';
+import { gridCellAggregationResultSelector } from "../aggregation/gridAggregationSelectors.js";
+export const useGridParamsOverridableMethods = apiRef => {
+  const communityMethods = useGridParamsOverridableMethodsCommunity(apiRef);
+  const getCellValue = React.useCallback((id, field) => gridCellAggregationResultSelector(apiRef, {
+    id,
+    field
+  })?.value ?? communityMethods.getCellValue(id, field), [apiRef, communityMethods]);
+  const getRowValue = React.useCallback((row, colDef) => gridCellAggregationResultSelector(apiRef, {
+    id: gridRowIdSelector(apiRef, row),
+    field: colDef.field
+  })?.value ?? communityMethods.getRowValue(row, colDef), [apiRef, communityMethods]);
+  const getRowFormattedValue = React.useCallback((row, colDef) => gridCellAggregationResultSelector(apiRef, {
+    id: gridRowIdSelector(apiRef, row),
+    field: colDef.field
+  })?.formattedValue ?? communityMethods.getRowFormattedValue(row, colDef), [apiRef, communityMethods]);
+  return {
+    getCellValue,
+    getRowValue,
+    getRowFormattedValue
+  };
+};

package/esm/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid-premium v8.12.0
+ * @mui/x-data-grid-premium v8.13.0
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the

package/hooks/features/aiAssistant/gridAiAssistantInterfaces.d.ts

@@ -59,6 +59,15 @@ export type PromptResolverOptions = {
    * Additional context to make the processing results more accurate.
    */
   additionalContext?: string;
+  /**
+   * Additional metadata to track the usage for each unique user.
+   */
+  metadata?: {
+    /**
+     * The reference ID that would be stored for you to identify the entity that made the request and then to be able to track the usage for each unique user/entity.
+     */
+    referenceId?: string;
+  };
 };
 /**
  * The prompt API interface that is available in the grid [[apiRef]].

package/hooks/features/chartsIntegration/useGridChartsIntegration.d.ts

@@ -3,6 +3,6 @@ import { GridStateInitializer } from '@mui/x-data-grid-pro/internals';
 import type { DataGridPremiumProcessedProps } from "../../../models/dataGridPremiumProps.js";
 import { GridPrivateApiPremium } from "../../../models/gridApiPremium.js";
 import { ChartState } from "../../../models/gridChartsIntegration.js";
-export declare const chartsIntegrationStateInitializer: GridStateInitializer<Pick<DataGridPremiumProcessedProps, 'chartsIntegration' | 'initialState' | 'activeChartId' | 'rowGroupingModel' | 'pivotModel' | 'experimentalFeatures'>, GridPrivateApiPremium>;
 export declare const EMPTY_CHART_INTEGRATION_CONTEXT_STATE: ChartState;
+export declare const chartsIntegrationStateInitializer: GridStateInitializer<Pick<DataGridPremiumProcessedProps, 'chartsIntegration' | 'initialState' | 'activeChartId' | 'rowGroupingModel' | 'pivotModel' | 'experimentalFeatures'>, GridPrivateApiPremium>;
 export declare const useGridChartsIntegration: (apiRef: RefObject<GridPrivateApiPremium>, props: Pick<DataGridPremiumProcessedProps, "chartsIntegration" | "activeChartId" | "onActiveChartIdChange" | "initialState" | "slots" | "slotProps" | "aggregationFunctions" | "dataSource" | "experimentalFeatures">) => void;

package/hooks/features/chartsIntegration/useGridChartsIntegration.js

@@ -22,6 +22,17 @@ var _gridAggregationUtils = require("../aggregation/gridAggregationUtils");
 var _gridAggregationSelectors = require("../aggregation/gridAggregationSelectors");
 var _gridPivotingSelectors = require("../pivoting/gridPivotingSelectors");
 var _jsxRuntime = require("react/jsx-runtime");
+const EMPTY_CHART_INTEGRATION_CONTEXT = {
+  chartStateLookup: {},
+  setChartState: () => {}
+};
+const EMPTY_CHART_INTEGRATION_CONTEXT_STATE = exports.EMPTY_CHART_INTEGRATION_CONTEXT_STATE = {
+  synced: true,
+  dimensions: [],
+  values: [],
+  type: '',
+  configuration: {}
+};
 const chartsIntegrationStateInitializer = (state, props) => {
   if (!props.chartsIntegration || !props.experimentalFeatures?.charts) {
     return (0, _extends2.default)({}, state, {
@@ -52,17 +63,6 @@ const chartsIntegrationStateInitializer = (state, props) => {
   });
 };
 exports.chartsIntegrationStateInitializer = chartsIntegrationStateInitializer;
-const EMPTY_CHART_INTEGRATION_CONTEXT = {
-  chartStateLookup: {},
-  setChartState: () => {}
-};
-const EMPTY_CHART_INTEGRATION_CONTEXT_STATE = exports.EMPTY_CHART_INTEGRATION_CONTEXT_STATE = {
-  synced: true,
-  dimensions: [],
-  values: [],
-  type: '',
-  configuration: {}
-};
 const useGridChartsIntegration = (apiRef, props) => {
   const visibleDimensions = React.useRef({});
   const visibleValues = React.useRef({});
@@ -181,7 +181,8 @@ const useGridChartsIntegration = (apiRef, props) => {
     const rowGroupingModel = (0, _gridRowGroupingSelector.gridRowGroupingSanitizedModelSelector)(apiRef);
     const rowTree = (0, _xDataGridPro.gridRowTreeSelector)(apiRef);
     const rowsPerDepth = (0, _internals.gridFilteredSortedDepthRowEntriesSelector)(apiRef);
-    const defaultDepth = Math.max(0, (visibleDimensions.current[activeChartId]?.length ?? 0) - 1);
+    const currentChartId = (0, _gridChartsIntegrationSelectors.gridChartsIntegrationActiveChartIdSelector)(apiRef);
+    const defaultDepth = Math.max(0, (visibleDimensions.current[currentChartId]?.length ?? 0) - 1);
     const rowsAtDefaultDepth = (rowsPerDepth[defaultDepth] ?? []).length;
 
     // keep only unique columns and transform the grouped column to carry the correct field name to get the grouped value
@@ -233,7 +234,7 @@ const useGridChartsIntegration = (apiRef, props) => {
         }))
       });
     });
-  }, [apiRef, activeChartId, orderedFields, getColumnName, getValueDatasetLabel, setChartState]);
+  }, [apiRef, orderedFields, getColumnName, getValueDatasetLabel, setChartState]);
   const debouncedHandleRowDataUpdate = React.useMemo(() => (0, _debounce.default)(handleRowDataUpdate, 0), [handleRowDataUpdate]);
   const handleColumnDataUpdate = React.useCallback((chartIds, updatedChartStateLookup) => {
     // if there are no charts, skip the data processing

package/hooks/features/rows/useGridParamsOverridableMethods.d.ts

@@ -0,0 +1,7 @@
+import type { RefObject } from '@mui/x-internals/types';
+import type { GridPrivateApiPremium } from "../../../models/gridApiPremium.js";
+export declare const useGridParamsOverridableMethods: (apiRef: RefObject<GridPrivateApiPremium>) => {
+  getCellValue: <V = any>(id: import("@mui/x-data-grid").GridRowId, field: string) => V;
+  getRowValue: <V = any>(row: import("@mui/x-data-grid").GridRowModel, colDef: import("@mui/x-data-grid").GridColDef) => V;
+  getRowFormattedValue: <V = any>(row: import("@mui/x-data-grid").GridRowModel, colDef: import("@mui/x-data-grid").GridColDef) => V;
+};

package/hooks/features/rows/useGridParamsOverridableMethods.js

@@ -0,0 +1,32 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useGridParamsOverridableMethods = void 0;
+var React = _interopRequireWildcard(require("react"));
+var _xDataGridPro = require("@mui/x-data-grid-pro");
+var _internals = require("@mui/x-data-grid-pro/internals");
+var _gridAggregationSelectors = require("../aggregation/gridAggregationSelectors");
+const useGridParamsOverridableMethods = apiRef => {
+  const communityMethods = (0, _internals.useGridParamsOverridableMethods)(apiRef);
+  const getCellValue = React.useCallback((id, field) => (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
+    id,
+    field
+  })?.value ?? communityMethods.getCellValue(id, field), [apiRef, communityMethods]);
+  const getRowValue = React.useCallback((row, colDef) => (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
+    id: (0, _xDataGridPro.gridRowIdSelector)(apiRef, row),
+    field: colDef.field
+  })?.value ?? communityMethods.getRowValue(row, colDef), [apiRef, communityMethods]);
+  const getRowFormattedValue = React.useCallback((row, colDef) => (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
+    id: (0, _xDataGridPro.gridRowIdSelector)(apiRef, row),
+    field: colDef.field
+  })?.formattedValue ?? communityMethods.getRowFormattedValue(row, colDef), [apiRef, communityMethods]);
+  return {
+    getCellValue,
+    getRowValue,
+    getRowFormattedValue
+  };
+};
+exports.useGridParamsOverridableMethods = useGridParamsOverridableMethods;

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid-premium v8.12.0
+ * @mui/x-data-grid-premium v8.13.0
  *
  * @license SEE LICENSE IN LICENSE
  * This source code is licensed under the SEE LICENSE IN LICENSE license found in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-data-grid-premium",
-  "version": "8.12.0",
+  "version": "8.13.0",
   "author": "MUI Team",
   "description": "The Premium plan edition of the MUI X Data Grid Components.",
   "license": "SEE LICENSE IN LICENSE",
@@ -33,16 +33,16 @@
     "directory": "packages/x-data-grid-premium"
   },
   "dependencies": {
-    "@babel/runtime": "^7.28.2",
+    "@babel/runtime": "^7.28.4",
     "@mui/utils": "^7.3.2",
     "@types/format-util": "^1.0.4",
     "clsx": "^2.1.1",
     "exceljs": "^4.4.0",
     "prop-types": "^15.8.1",
-    "@mui/x-data-grid": "8.12.0",
-    "@mui/x-data-grid-pro": "8.12.0",
+    "@mui/x-data-grid": "8.13.0",
+    "@mui/x-internals": "8.12.0",
     "@mui/x-license": "8.12.0",
-    "@mui/x-internals": "8.12.0"
+    "@mui/x-data-grid-pro": "8.13.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",