[docs] Update GridCellParams value description

docs/data/data-grid/column-definition/RenderCellGrid.js

@@ -49,7 +49,8 @@ RenderDate.propTypes = {
    */
   hasFocus: PropTypes.bool.isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.instanceOf(Date),
 };

docs/data/data-grid/column-definition/RenderExpandCellGrid.js

@@ -119,7 +119,8 @@ renderCellExpand.propTypes = {
    */
   colDef: PropTypes.object.isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.string,
 };

docs/data/data-grid/editing-legacy/RenderRatingEditCellGrid.js

@@ -10,7 +10,8 @@ function renderRating(params) {
 
 renderRating.propTypes = {
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.number,
 };
@@ -65,7 +66,8 @@ RatingEditInputCell.propTypes = {
    */
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.number,
 };

docs/data/data-grid/editing/AutoStopEditComponent.js

@@ -38,7 +38,8 @@ SelectEditInputCell.propTypes = {
    */
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 };

docs/data/data-grid/editing/CustomEditComponent.js

@@ -10,7 +10,8 @@ function renderRating(params) {
 
 renderRating.propTypes = {
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.number,
 };
@@ -54,7 +55,8 @@ RatingEditInputCell.propTypes = {
    */
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.number,
 };

docs/data/data-grid/editing/EditingWithDatePickers.js

@@ -215,7 +215,8 @@ GridEditDateCell.propTypes = {
    */
   id: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.oneOfType([PropTypes.instanceOf(Date), PropTypes.string]),
 };

docs/data/data-grid/row-height/ExpandableCells.js

@@ -48,7 +48,8 @@ const ExpandableCell = ({ value }) => {
 
 ExpandableCell.propTypes = {
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 };

docs/pages/x/api/data-grid/grid-cell-params.md

@@ -14,17 +14,17 @@ import { GridCellParams } from '@mui/x-data-grid';
 
 ## Properties
 
-| Name                                                                                             | Type                                                                    | Description                                                      |
-| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- | :--------------------------------------------------------------- |
-| <span class="prop-name">cellMode</span>                                                          | <span class="prop-type">GridCellMode</span>                             | The mode of the cell.                                            |
-| <span class="prop-name">colDef</span>                                                            | <span class="prop-type">GridStateColDef</span>                          | The column of the row that the current cell belongs to.          |
-| <span class="prop-name">field</span>                                                             | <span class="prop-type">string</span>                                   | The column field of the cell that triggered the event.           |
-| <span class="prop-name optional">formattedValue<sup><abbr title="optional">?</abbr></sup></span> | <span class="prop-type">F \| undefined</span>                           | The cell value formatted with the column valueFormatter.         |
-| <span class="prop-name">getValue</span>                                                          | <span class="prop-type">(id: GridRowId, field: string) =&gt; any</span> | Get the cell value of a row and field.                           |
-| <span class="prop-name">hasFocus</span>                                                          | <span class="prop-type">boolean</span>                                  | If true, the cell is the active element.                         |
-| <span class="prop-name">id</span>                                                                | <span class="prop-type">GridRowId</span>                                | The grid row id.                                                 |
-| <span class="prop-name optional">isEditable<sup><abbr title="optional">?</abbr></sup></span>     | <span class="prop-type">boolean</span>                                  | If true, the cell is editable.                                   |
-| <span class="prop-name">row</span>                                                               | <span class="prop-type">GridRowModel&lt;R&gt;</span>                    | The row model of the row that the current cell belongs to.       |
-| <span class="prop-name">rowNode</span>                                                           | <span class="prop-type">GridRowTreeNodeConfig</span>                    | The node of the row that the current cell belongs to.            |
-| <span class="prop-name">tabIndex</span>                                                          | <span class="prop-type">0 \| -1</span>                                  | the tabIndex value.                                              |
-| <span class="prop-name optional">value<sup><abbr title="optional">?</abbr></sup></span>          | <span class="prop-type">V \| undefined</span>                           | The cell value, but if the column has valueGetter, use getValue. |
+| Name                                                                                             | Type                                                                    | Description                                                                                           |
+| :----------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------- |
+| <span class="prop-name">cellMode</span>                                                          | <span class="prop-type">GridCellMode</span>                             | The mode of the cell.                                                                                 |
+| <span class="prop-name">colDef</span>                                                            | <span class="prop-type">GridStateColDef</span>                          | The column of the row that the current cell belongs to.                                               |
+| <span class="prop-name">field</span>                                                             | <span class="prop-type">string</span>                                   | The column field of the cell that triggered the event.                                                |
+| <span class="prop-name optional">formattedValue<sup><abbr title="optional">?</abbr></sup></span> | <span class="prop-type">F \| undefined</span>                           | The cell value formatted with the column valueFormatter.                                              |
+| <span class="prop-name">getValue</span>                                                          | <span class="prop-type">(id: GridRowId, field: string) =&gt; any</span> | Get the cell value of a row and field.                                                                |
+| <span class="prop-name">hasFocus</span>                                                          | <span class="prop-type">boolean</span>                                  | If true, the cell is the active element.                                                              |
+| <span class="prop-name">id</span>                                                                | <span class="prop-type">GridRowId</span>                                | The grid row id.                                                                                      |
+| <span class="prop-name optional">isEditable<sup><abbr title="optional">?</abbr></sup></span>     | <span class="prop-type">boolean</span>                                  | If true, the cell is editable.                                                                        |
+| <span class="prop-name">row</span>                                                               | <span class="prop-type">GridRowModel&lt;R&gt;</span>                    | The row model of the row that the current cell belongs to.                                            |
+| <span class="prop-name">rowNode</span>                                                           | <span class="prop-type">GridRowTreeNodeConfig</span>                    | The node of the row that the current cell belongs to.                                                 |
+| <span class="prop-name">tabIndex</span>                                                          | <span class="prop-type">0 \| -1</span>                                  | the tabIndex value.                                                                                   |
+| <span class="prop-name optional">value<sup><abbr title="optional">?</abbr></sup></span>          | <span class="prop-type">V \| undefined</span>                           | The cell value.<br />If the column has `valueGetter`, use `params.row` to directly access the fields. |

packages/grid/x-data-grid-pro/src/components/GridDetailPanelToggleCell.tsx

@@ -125,7 +125,8 @@ GridDetailPanelToggleCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid-pro/src/components/GridTreeDataGroupingCell.tsx

@@ -164,7 +164,8 @@ GridTreeDataGroupingCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/cell/GridBooleanCell.tsx

@@ -139,7 +139,8 @@ GridBooleanCellRaw.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/cell/GridEditBooleanCell.tsx

@@ -179,7 +179,8 @@ GridEditBooleanCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/cell/GridEditDateCell.tsx

@@ -229,7 +229,8 @@ GridEditDateCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/cell/GridEditInputCell.tsx

@@ -193,7 +193,8 @@ GridEditInputCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]),
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/cell/GridEditSingleSelectCell.tsx

@@ -265,7 +265,8 @@ GridEditSingleSelectCell.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/components/columnSelection/GridCellCheckboxRenderer.tsx

@@ -191,7 +191,8 @@ GridCellCheckboxForwardRef.propTypes = {
    */
   tabIndex: PropTypes.oneOf([-1, 0]).isRequired,
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value: PropTypes.any,
 } as any;

packages/grid/x-data-grid/src/models/params/gridCellParams.ts

@@ -16,7 +16,8 @@ export interface GridCellParams<V = any, R extends GridValidRowModel = any, F =
    */
   field: string;
   /**
-   * The cell value, but if the column has valueGetter, use getValue.
+   * The cell value.
+   * If the column has `valueGetter`, use `params.row` to directly access the fields.
    */
   value?: V | undefined;
   /**
@@ -106,6 +107,10 @@ export interface GridValueGetterParams<V = any, R = any>
    * @deprecated Use the `apiRef` returned by `useGridApiContext` or `useGridApiRef` (only available in `@mui/x-data-grid-pro`)
    */
   api: any;
+  /**
+   * The default value for the cell that the `valueGetter` is overriding.
+   */
+  value: GridCellParams<V, R, any>['value'];
 }
 
 /**