@mui/x-data-grid-premium 8.17.0 → 8.18.0

package/CHANGELOG.md

@@ -5,6 +5,106 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.18.0
+
+<!-- generated comparing v8.17.0..master -->
+
+_Nov 13, 2025_
+
+We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
+
+- Add `barLabelPlacement` property to customize the bar label position in bar charts, enabling labels to be placed above bars.
+
+  ![image](https://github.com/user-attachments/assets/4bc3a75b-74b8-4c6d-896b-5f5bf837bcda)
+
+- Add `source` property to the date/time picker lifecycle and event handler context, enabling clearer differentiation between changes initiated by the picker UI and those from direct field input.
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+Special thanks go out to these community members for their valuable contributions:
+@htollefsen, @sai6855, @Sigdriv
+
+The following team members contributed to this release:
+@arminmeh, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @JCQuintas, @michelengelen, @noraleonte, @prakhargupta1, @rita-codes, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.18.0`
+
+- [DataGrid] Allow default event in the column action cell item click event handler (#20272) @arminmeh
+- [DataGrid] Remove unnecessary generic from `useGridApiRef` (#20277) @cherniavskii
+
+#### `@mui/x-data-grid-pro@8.18.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.18.0`.
+
+#### `@mui/x-data-grid-premium@8.18.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.18.0`, plus:
+
+- [DataGridPremium] Return the correct `cellParams` value from the aggregation cells (#20224) @arminmeh
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.18.0`
+
+- [pickers] Keep invalid date state consistent (#20040) @michelengelen
+- [pickers] Adds new `source` property to `onChange` and `onAccept` context object (#20234) @michelengelen
+
+#### `@mui/x-date-pickers-pro@8.18.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.18.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.18.0`
+
+- [charts] Add prop for positioning a bar label (#20194) @Sigdriv
+- [charts] Fix applying dark mode styles in `ChartAxisZoomSliderThumb` (#20232) @sai6855
+
+#### `@mui/x-charts-pro@8.18.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.18.0`, plus:
+
+- [charts-pro] Allow specifying Content Security Policy nonce on export (#20053) @bernardobelchior
+- [charts-pro] Fix applying dark mode styles to slider (#20220) @sai6855
+- [charts-pro] Sankey should respect node order (#20065) @JCQuintas
+
+#### `@mui/x-charts-premium@8.18.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.18.0`.
+
+### Tree View
+
+#### `@mui/x-tree-view@8.18.0`
+
+- [tree view] Prepare tests for the new store structure (#20225) @flaviendelangle
+- [tree view] Prepare the item plugin files for the store migration (#20240) @flaviendelangle
+- [tree view] Use `TreeItemId` type instead of raw string (#20233) @flaviendelangle
+
+#### `@mui/x-tree-view-pro@8.18.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.18.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.18.0`
+
+Internal changes.
+
+### Docs
+
+- [charts] Add a demo for a custom tick label (#20073) @prakhargupta1
+- [charts] Create `useAxes()` hook documentation page (#20229) @JCQuintas
+- [charts] Fix logo alignment (#20228) @JCQuintas
+- [charts] Fixes typo in import example (#20236) @htollefsen
+- [Data Grid] Add recipe for cursor pagination with data source (#19700) @siriwatknp
+- [Data Grid] Add a demo for pinned rows aggregation (#20198) @cherniavskii
+
+### Core
+
+- [docs-infra] Use deployment config from docs-infra package (#20243) @brijeshb42
+
 ## 8.17.0
 
 _Nov 5, 2025_

package/DataGridPremium/DataGridPremium.js

@@ -50,7 +50,7 @@ const configuration = {
     useGridParamsOverridableMethods: _useGridParamsOverridableMethods.useGridParamsOverridableMethods
   }
 };
-const releaseInfo = "MTc2MjMwMDgwMDAwMA==";
+const releaseInfo = "MTc2Mjk5MjAwMDAwMA==";
 const watermark = /*#__PURE__*/(0, _jsxRuntime.jsx)(_xLicense.Watermark, {
   packageName: "x-data-grid-premium",
   releaseInfo: releaseInfo

package/esm/DataGridPremium/DataGridPremium.js

@@ -43,7 +43,7 @@ const configuration = {
     useGridParamsOverridableMethods
   }
 };
-const releaseInfo = "MTc2MjMwMDgwMDAwMA==";
+const releaseInfo = "MTc2Mjk5MjAwMDAwMA==";
 const watermark = /*#__PURE__*/_jsx(Watermark, {
   packageName: "x-data-grid-premium",
   releaseInfo: releaseInfo

package/esm/hooks/features/aggregation/createAggregationLookup.js

@@ -36,6 +36,9 @@ const getGroupAggregatedValue = (groupId, apiRef, aggregationRowsScope, aggregat
       continue;
     }
     const row = rowLookup[rowId];
+    if (!row) {
+      continue;
+    }
     for (let j = 0; j < aggregatedFields.length; j += 1) {
       const aggregatedField = aggregatedFields[j];
       const columnAggregationRules = aggregationRules[aggregatedField];
@@ -51,9 +54,6 @@ const getGroupAggregatedValue = (groupId, apiRef, aggregationRowsScope, aggregat
         // Since we know that pivoted fields are flat, we can use the row directly, and save lots of processing time
         value = row[field];
       } else {
-        if (!row) {
-          continue;
-        }
         const valueGetter = valueGetters[aggregatedField];
         value = valueGetter(row);
       }

package/esm/hooks/features/aiAssistant/useGridAiAssistant.js

@@ -74,10 +74,7 @@ export const useGridAiAssistant = (apiRef, props) => {
         length: Math.min(DEFAULT_SAMPLE_COUNT, rows.length)
       }).map(() => {
         const row = rows[Math.floor(Math.random() * rows.length)];
-        if (column.valueGetter) {
-          return column.valueGetter(row[column.field], row, column, apiRef);
-        }
-        return row[column.field];
+        return apiRef.current.getRowValue(row, column);
       });
     });
     return columnExamples;

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

@@ -12,10 +12,20 @@ export const useGridParamsOverridableMethods = 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]);
+  const getRowFormattedValue = React.useCallback((row, colDef) => {
+    const aggregationFormattedValue = gridCellAggregationResultSelector(apiRef, {
+      id: gridRowIdSelector(apiRef, row),
+      field: colDef.field
+    })?.formattedValue;
+    if (aggregationFormattedValue !== undefined) {
+      return aggregationFormattedValue;
+    }
+    const value = getRowValue(row, colDef);
+    if (!colDef || !colDef.valueFormatter) {
+      return value;
+    }
+    return colDef.valueFormatter(value, row, colDef, apiRef);
+  }, [apiRef, getRowValue]);
   return {
     getCellValue,
     getRowValue,

package/esm/hooks/utils/useGridApiRef.d.ts

@@ -1,4 +1,3 @@
 import { RefObject } from '@mui/x-internals/types';
-import { GridApiCommon } from '@mui/x-data-grid';
 import { GridApiPremium } from "../../models/gridApiPremium.js";
-export declare const useGridApiRef: <Api extends GridApiCommon = GridApiPremium>() => RefObject<Api | null>;
+export declare const useGridApiRef: () => RefObject<GridApiPremium | null>;

package/esm/index.js

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

package/hooks/features/aggregation/createAggregationLookup.js

@@ -43,6 +43,9 @@ const getGroupAggregatedValue = (groupId, apiRef, aggregationRowsScope, aggregat
       continue;
     }
     const row = rowLookup[rowId];
+    if (!row) {
+      continue;
+    }
     for (let j = 0; j < aggregatedFields.length; j += 1) {
       const aggregatedField = aggregatedFields[j];
       const columnAggregationRules = aggregationRules[aggregatedField];
@@ -58,9 +61,6 @@ const getGroupAggregatedValue = (groupId, apiRef, aggregationRowsScope, aggregat
         // Since we know that pivoted fields are flat, we can use the row directly, and save lots of processing time
         value = row[field];
       } else {
-        if (!row) {
-          continue;
-        }
         const valueGetter = valueGetters[aggregatedField];
         value = valueGetter(row);
       }

package/hooks/features/aiAssistant/useGridAiAssistant.js

@@ -82,10 +82,7 @@ const useGridAiAssistant = (apiRef, props) => {
         length: Math.min(DEFAULT_SAMPLE_COUNT, rows.length)
       }).map(() => {
         const row = rows[Math.floor(Math.random() * rows.length)];
-        if (column.valueGetter) {
-          return column.valueGetter(row[column.field], row, column, apiRef);
-        }
-        return row[column.field];
+        return apiRef.current.getRowValue(row, column);
       });
     });
     return columnExamples;

package/hooks/features/rows/useGridParamsOverridableMethods.js

@@ -19,10 +19,20 @@ const useGridParamsOverridableMethods = 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]);
+  const getRowFormattedValue = React.useCallback((row, colDef) => {
+    const aggregationFormattedValue = (0, _gridAggregationSelectors.gridCellAggregationResultSelector)(apiRef, {
+      id: (0, _xDataGridPro.gridRowIdSelector)(apiRef, row),
+      field: colDef.field
+    })?.formattedValue;
+    if (aggregationFormattedValue !== undefined) {
+      return aggregationFormattedValue;
+    }
+    const value = getRowValue(row, colDef);
+    if (!colDef || !colDef.valueFormatter) {
+      return value;
+    }
+    return colDef.valueFormatter(value, row, colDef, apiRef);
+  }, [apiRef, getRowValue]);
   return {
     getCellValue,
     getRowValue,

package/hooks/utils/useGridApiRef.d.ts

@@ -1,4 +1,3 @@
 import { RefObject } from '@mui/x-internals/types';
-import { GridApiCommon } from '@mui/x-data-grid';
 import { GridApiPremium } from "../../models/gridApiPremium.js";
-export declare const useGridApiRef: <Api extends GridApiCommon = GridApiPremium>() => RefObject<Api | null>;
+export declare const useGridApiRef: () => RefObject<GridApiPremium | null>;

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid-premium v8.17.0
+ * @mui/x-data-grid-premium v8.18.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.17.0",
+  "version": "8.18.0",
   "author": "MUI Team",
   "description": "The Premium plan edition of the MUI X Data Grid Components.",
   "license": "SEE LICENSE IN LICENSE",
@@ -34,14 +34,14 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.28.4",
-    "@mui/utils": "^7.3.3",
-    "@mui/x-internal-exceljs-fork": "^4.4.2",
+    "@mui/utils": "^7.3.5",
+    "@mui/x-internal-exceljs-fork": "^4.4.3",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
-    "@mui/x-data-grid": "8.17.0",
-    "@mui/x-data-grid-pro": "8.17.0",
-    "@mui/x-internals": "8.17.0",
-    "@mui/x-license": "8.17.0"
+    "@mui/x-internals": "8.18.0",
+    "@mui/x-data-grid": "8.18.0",
+    "@mui/x-license": "8.18.0",
+    "@mui/x-data-grid-pro": "8.18.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",