@mui/x-data-grid 5.6.1 → 5.9.0

package/models/params/gridCellParams.d.ts

@@ -1,11 +1,12 @@
-import { GridCellMode, GridCellValue } from '../gridCell';
-import { GridRowId, GridRowModel, GridRowTreeNodeConfig } from '../gridRows';
+/// <reference types="react" />
+import { GridCellMode } from '../gridCell';
+import { GridRowId, GridRowModel, GridRowTreeNodeConfig, GridValidRowModel } from '../gridRows';
 import type { GridStateColDef } from '../colDef/gridColDef';
 import { GridEditCellProps } from '../gridEditRowModel';
 /**
  * Object passed as parameter in the column [[GridColDef]] cell renderer.
  */
-export interface GridCellParams<V = any, R = any, F = V> {
+export interface GridCellParams<V = any, R extends GridValidRowModel = any, F = V> {
     /**
      * The grid row id.
      */
@@ -17,11 +18,11 @@ export interface GridCellParams<V = any, R = any, F = V> {
     /**
      * The cell value, but if the column has valueGetter, use getValue.
      */
-    value: V;
+    value?: V | undefined;
     /**
      * The cell value formatted with the column valueFormatter.
      */
-    formattedValue: F;
+    formattedValue?: F | undefined;
     /**
      * The row model of the row that the current cell belongs to.
      */
@@ -54,25 +55,34 @@ export interface GridCellParams<V = any, R = any, F = V> {
      * Get the cell value of a row and field.
      * @param {GridRowId} id The row id.
      * @param {string} field The field.
-     * @returns {GridCellValue} The cell value.
+     * @returns {any} The cell value.
      * @deprecated Use `params.row` to directly access the fields you want instead.
      */
-    getValue: (id: GridRowId, field: string) => GridCellValue;
+    getValue: (id: GridRowId, field: string) => any;
+}
+export interface FocusElement {
+    focus(): void;
 }
 /**
  * GridCellParams containing api.
  */
-export interface GridRenderCellParams<V = any, R = any, F = V> extends GridCellParams<V, R, F> {
+export interface GridRenderCellParams<V = any, R extends GridValidRowModel = any, F = V> extends GridCellParams<V, R, F> {
     /**
      * GridApi that let you manipulate the grid.
      * @deprecated Use the `apiRef` returned by `useGridApiContext` or `useGridApiRef` (only available in `@mui/x-data-grid-pro`)
      */
     api: any;
+    /**
+     * A ref allowing to set imperative focus.
+     * It can be passed to the element that should receive focus.
+     * @ignore - do not document.
+     */
+    focusElementRef?: React.Ref<FocusElement>;
 }
 /**
  * GridEditCellProps containing api.
  */
-export interface GridRenderEditCellParams extends GridEditCellProps {
+export interface GridRenderEditCellParams<V = any, R extends GridValidRowModel = any, F = V> extends GridCellParams<V, R, F>, GridEditCellProps<V> {
     /**
      * GridApi that let you manipulate the grid.
      * @deprecated Use the `apiRef` returned by `useGridApiContext` or `useGridApiRef` (only available in `@mui/x-data-grid-pro`)
@@ -92,24 +102,24 @@ export interface GridValueGetterParams<V = any, R = any> extends Omit<GridCellPa
 /**
  * @deprecated Use `GridValueGetterParams` instead.
  */
-export declare type GridValueGetterFullParams<V = any, R = any> = GridValueGetterParams<V, R>;
+export declare type GridValueGetterFullParams<V = any, R extends GridValidRowModel = any> = GridValueGetterParams<V, R>;
 /**
  * Object passed as parameter in the column [[GridColDef]] value setter callback.
  */
-export interface GridValueSetterParams {
+export interface GridValueSetterParams<R extends GridValidRowModel = any, V = any> {
     /**
      * The new cell value.
      */
-    value: GridCellValue;
+    value: V;
     /**
      * The row that is being edited.
      */
-    row: GridRowModel;
+    row: R;
 }
 /**
  * Object passed as parameter in the column [[GridColDef]] value formatter callback.
  */
-export interface GridValueFormatterParams {
+export interface GridValueFormatterParams<V = any> {
     /**
      * The grid row id.
      * It is not available when the value formatter is called by the filter panel.
@@ -122,7 +132,7 @@ export interface GridValueFormatterParams {
     /**
      * The cell value, if the column has valueGetter it is the value returned by it.
      */
-    value: GridCellValue;
+    value: V;
     /**
      * GridApi that let you manipulate the grid.
      * @deprecated Use the `apiRef` returned by `useGridApiContext` or `useGridApiRef` (only available in `@mui/x-data-grid-pro`)
@@ -145,4 +155,13 @@ export interface GridPreProcessEditCellProps {
      * The edit cell props.
      */
     props: GridEditCellProps;
+    /**
+     * Whether the new value is different from the stored value or not.
+     */
+    hasChanged?: boolean;
+    /**
+     * Object containing the props of the other fields.
+     * Only available for row editing and when using the new editing API.
+     */
+    otherFieldsProps?: Record<string, GridEditCellProps>;
 }

package/models/params/gridColumnHeaderParams.d.ts

@@ -1,8 +1,9 @@
 import type { GridStateColDef } from '../colDef/gridColDef';
+import { GridValidRowModel } from '../gridRows';
 /**
  * Object passed as parameter in the column [[GridColDef]] header renderer.
  */
-export interface GridColumnHeaderParams {
+export interface GridColumnHeaderParams<V = any, R extends GridValidRowModel = GridValidRowModel, F = V> {
     /**
      * The column field of the column that triggered the event
      */
@@ -10,5 +11,5 @@ export interface GridColumnHeaderParams {
     /**
      * The column of the current header component.
      */
-    colDef: GridStateColDef;
+    colDef: GridStateColDef<R, V, F>;
 }

package/models/params/gridEditCellParams.d.ts

@@ -1,15 +1,30 @@
-import { GridCellValue } from '../gridCell';
 import { GridEditCellProps } from '../gridEditRowModel';
 import { GridRowId } from '../gridRows';
+import { GridCellParams } from './gridCellParams';
 export interface GridEditCellPropsParams {
     id: GridRowId;
     field: string;
     props: GridEditCellProps;
 }
+/**
+ * Params passed to `apiRef.current.setEditCellValue`.
+ */
 export interface GridEditCellValueParams {
+    /**
+     * The row id.
+     */
     id: GridRowId;
+    /**
+     * The field.
+     */
     field: string;
-    value: GridCellValue;
+    /**
+     * The new value for the cell.
+     */
+    value: any;
+    /**
+     * The debounce time in milliseconds.
+     */
     debounceMs?: number;
 }
 export interface GridCommitCellChangeParams {
@@ -19,5 +34,39 @@ export interface GridCommitCellChangeParams {
 export interface GridCellEditCommitParams {
     id: GridRowId;
     field: string;
-    value: GridCellValue;
+    value: any;
 }
+declare enum GridCellEditStartReasons {
+    enterKeyDown = "enterKeyDown",
+    cellDoubleClick = "cellDoubleClick",
+    printableKeyDown = "printableKeyDown",
+    deleteKeyDown = "deleteKeyDown"
+}
+/**
+ * Params passed to the `cellEditStart` event.
+ */
+export interface GridCellEditStartParams<V = any, R = any, F = V> extends GridCellParams<V, R, F> {
+    /**
+     * The reason for this event to be triggered.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    reason?: GridCellEditStartReasons;
+}
+declare enum GridCellEditStopReasons {
+    cellFocusOut = "cellFocusOut",
+    escapeKeyDown = "escapeKeyDown",
+    enterKeyDown = "enterKeyDown",
+    tabKeyDown = "tabKeyDown",
+    shiftTabKeyDown = "shiftTabKeyDown"
+}
+/**
+ * Params passed to the `cellEditStop event.
+ */
+export interface GridCellEditStopParams<V = any, R = any, F = V> extends GridCellParams<V, R, F> {
+    /**
+     * The reason for this event to be triggered.
+     * Only available if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    reason?: GridCellEditStopReasons;
+}
+export { GridCellEditStartReasons, GridCellEditStopReasons };

package/models/params/gridEditCellParams.js

@@ -1 +1,34 @@
-export {};
+// TODO v6 - remove
+
+/**
+ * Params passed to `apiRef.current.setEditCellValue`.
+ */
+// TODO v6 - remove
+// TODO v6 - remove
+var GridCellEditStartReasons;
+/**
+ * Params passed to the `cellEditStart` event.
+ */
+
+(function (GridCellEditStartReasons) {
+  GridCellEditStartReasons["enterKeyDown"] = "enterKeyDown";
+  GridCellEditStartReasons["cellDoubleClick"] = "cellDoubleClick";
+  GridCellEditStartReasons["printableKeyDown"] = "printableKeyDown";
+  GridCellEditStartReasons["deleteKeyDown"] = "deleteKeyDown";
+})(GridCellEditStartReasons || (GridCellEditStartReasons = {}));
+
+var GridCellEditStopReasons;
+/**
+ * Params passed to the `cellEditStop event.
+ */
+
+(function (GridCellEditStopReasons) {
+  GridCellEditStopReasons["cellFocusOut"] = "cellFocusOut";
+  GridCellEditStopReasons["escapeKeyDown"] = "escapeKeyDown";
+  GridCellEditStopReasons["enterKeyDown"] = "enterKeyDown";
+  GridCellEditStopReasons["tabKeyDown"] = "tabKeyDown";
+  GridCellEditStopReasons["shiftTabKeyDown"] = "shiftTabKeyDown";
+})(GridCellEditStopReasons || (GridCellEditStopReasons = {}));
+
+// https://github.com/mui/mui-x/pull/3738#discussion_r798504277
+export { GridCellEditStartReasons, GridCellEditStopReasons };

package/models/params/gridPreferencePanelParams.d.ts

@@ -0,0 +1,3 @@
+import { GridPreferencePanelState } from '../../hooks/features/preferencesPanel/gridPreferencePanelState';
+export interface GridPreferencePanelParams extends Omit<GridPreferencePanelState, 'open'> {
+}

package/models/params/gridPreferencePanelParams.js

@@ -0,0 +1 @@
+export {};

package/models/params/gridRowParams.d.ts

@@ -1,10 +1,9 @@
-import { GridCellValue } from '../gridCell';
-import { GridRowEntry, GridRowId, GridRowModel } from '../gridRows';
+import { GridValidRowModel, GridRowEntry, GridRowId } from '../gridRows';
 import type { GridColumns } from '../colDef/gridColDef';
 /**
  * Object passed as parameter in the row callbacks.
  */
-export interface GridRowParams<R extends GridRowModel = GridRowModel> {
+export interface GridRowParams<R extends GridValidRowModel = any> {
     /**
      * The grid row id.
      */
@@ -21,10 +20,10 @@ export interface GridRowParams<R extends GridRowModel = GridRowModel> {
      * Get the cell value of a row and field.
      * @param {GridRowId} id The row id.
      * @param {string} field The field.
-     * @returns {GridCellValue} The cell value.
+     * @returns {any} The cell value.
      * @deprecated Use `params.row` to directly access the fields you want instead.
      */
-    getValue: (id: GridRowId, field: string) => GridCellValue;
+    getValue: (id: GridRowId, field: string) => any;
 }
 interface GridRowVisibilityParams {
     /**
@@ -35,11 +34,16 @@ interface GridRowVisibilityParams {
      * Whether this row is the last visible or not.
      */
     isLastVisible: boolean;
+    /**
+     * Index of the row in the current page.
+     * If the pagination is disabled, it will be the index relative to all filtered rows.
+     */
+    indexRelativeToCurrentPage: number;
 }
 /**
  * Object passed as parameter in the row `getRowClassName` callback prop.
  */
-export interface GridRowClassNameParams extends GridRowParams, GridRowVisibilityParams {
+export interface GridRowClassNameParams<R extends GridValidRowModel = any> extends GridRowParams<R>, GridRowVisibilityParams {
 }
 /**
  * Object passed as parameter in the row `getRowHeight` callback prop.
@@ -54,6 +58,46 @@ export interface GridRowHeightParams extends GridRowEntry {
  * The getRowHeight return value.
  */
 export declare type GridRowHeightReturnValue = number | null | undefined;
+declare enum GridRowEditStartReasons {
+    enterKeyDown = "enterKeyDown",
+    cellDoubleClick = "cellDoubleClick",
+    printableKeyDown = "printableKeyDown",
+    deleteKeyDown = "deleteKeyDown"
+}
+/**
+ * Params passed to the `rowEditStart` event.
+ */
+export interface GridRowEditStartParams<R extends GridValidRowModel = any> extends GridRowParams<R> {
+    /**
+     * Which field triggered this event.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    field?: string;
+    /**
+     * The reason for this event to be triggered.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    reason?: GridRowEditStartReasons;
+}
+declare enum GridRowEditStopReasons {
+    rowFocusOut = "rowFocusOut",
+    escapeKeyDown = "escapeKeyDown",
+    enterKeyDown = "enterKeyDown",
+    tabKeyDown = "tabKeyDown",
+    shiftTabKeyDown = "shiftTabKeyDown"
+}
+export interface GridRowEditStopParams<R extends GridValidRowModel = any> extends GridRowParams<R> {
+    /**
+     * Which field triggered this event.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    field?: string;
+    /**
+     * The reason for this event to be triggered.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     */
+    reason?: GridRowEditStopReasons;
+}
 /**
  * Object passed as parameter in the row `getRowSpacing` callback prop.
  */
@@ -66,4 +110,4 @@ export interface GridRowSpacing {
     top?: number;
     bottom?: number;
 }
-export {};
+export { GridRowEditStartReasons, GridRowEditStopReasons };

package/models/params/gridRowParams.js

@@ -1 +1,39 @@
-export {};
+/**
+ * Object passed as parameter in the row callbacks.
+ */
+
+/**
+ * Object passed as parameter in the row `getRowClassName` callback prop.
+ */
+
+/**
+ * Object passed as parameter in the row `getRowHeight` callback prop.
+ */
+
+/**
+ * The getRowHeight return value.
+ */
+var GridRowEditStartReasons;
+/**
+ * Params passed to the `rowEditStart` event.
+ */
+
+(function (GridRowEditStartReasons) {
+  GridRowEditStartReasons["enterKeyDown"] = "enterKeyDown";
+  GridRowEditStartReasons["cellDoubleClick"] = "cellDoubleClick";
+  GridRowEditStartReasons["printableKeyDown"] = "printableKeyDown";
+  GridRowEditStartReasons["deleteKeyDown"] = "deleteKeyDown";
+})(GridRowEditStartReasons || (GridRowEditStartReasons = {}));
+
+var GridRowEditStopReasons;
+
+(function (GridRowEditStopReasons) {
+  GridRowEditStopReasons["rowFocusOut"] = "rowFocusOut";
+  GridRowEditStopReasons["escapeKeyDown"] = "escapeKeyDown";
+  GridRowEditStopReasons["enterKeyDown"] = "enterKeyDown";
+  GridRowEditStopReasons["tabKeyDown"] = "tabKeyDown";
+  GridRowEditStopReasons["shiftTabKeyDown"] = "shiftTabKeyDown";
+})(GridRowEditStopReasons || (GridRowEditStopReasons = {}));
+
+// https://github.com/mui/mui-x/pull/3738#discussion_r798504277
+export { GridRowEditStartReasons, GridRowEditStopReasons };

package/models/params/gridValueOptionsParams.d.ts

@@ -1,8 +1,8 @@
-import { GridRowModel, GridRowId } from '../gridRows';
+import { GridRowId, GridValidRowModel } from '../gridRows';
 /**
  * Object passed as parameter of the valueOptions function for singleSelect column.
  */
-export interface GridValueOptionsParams {
+export interface GridValueOptionsParams<R extends GridValidRowModel = any> {
     /**
      * The field of the column to which options will be provided
      */
@@ -14,5 +14,5 @@ export interface GridValueOptionsParams {
     /**
      * The row model of the row that the current cell belongs to.
      */
-    row?: GridRowModel;
+    row?: R;
 }

package/models/params/index.d.ts

@@ -10,3 +10,4 @@ export * from './gridHeaderSelectionCheckboxParams';
 export * from './gridValueOptionsParams';
 export * from './gridCellParams';
 export * from './gridSortModelParams';
+export * from './gridPreferencePanelParams';

package/models/params/index.js

@@ -9,4 +9,5 @@ export * from './gridRowSelectionCheckboxParams';
 export * from './gridHeaderSelectionCheckboxParams';
 export * from './gridValueOptionsParams';
 export * from './gridCellParams';
-export * from './gridSortModelParams';
+export * from './gridSortModelParams';
+export * from './gridPreferencePanelParams';

package/models/props/DataGridProps.d.ts

@@ -8,7 +8,7 @@ import { GridFeatureMode } from '../gridFeatureMode';
 import { Logger } from '../logger';
 import { GridSortDirection, GridSortModel } from '../gridSortModel';
 import { GridSlotsComponent } from '../gridSlotsComponent';
-import { GridRowIdGetter, GridRowsProp } from '../gridRows';
+import { GridRowIdGetter, GridRowsProp, GridValidRowModel } from '../gridRows';
 import { GridEventListener, GridEvents } from '../events';
 import { GridCallbackDetails, GridLocaleText } from '../api';
 import { GridApiCommunity } from '../api/gridApiCommunity';
@@ -27,6 +27,10 @@ export interface GridExperimentalFeatures {
      * Will be part of the premium-plan when fully ready.
      */
     preventCommitWhileValidating: boolean;
+    /**
+     * Enables the new API for cell editing and row editing.
+     */
+    newEditingApi: boolean;
     /**
      * Emits a warning if the cell receives focus without also syncing the focus state.
      * Only works if NODE_ENV=test.
@@ -36,13 +40,13 @@ export interface GridExperimentalFeatures {
 /**
  * The props users can give to the `DataGrid` component.
  */
-export declare type DataGridProps = Omit<Partial<DataGridPropsWithDefaultValues> & DataGridPropsWithComplexDefaultValueBeforeProcessing & DataGridPropsWithoutDefaultValue, DataGridForcedPropsKey> & {
+export declare type DataGridProps<R extends GridValidRowModel = any> = Omit<Partial<DataGridPropsWithDefaultValues> & DataGridPropsWithComplexDefaultValueBeforeProcessing & DataGridPropsWithoutDefaultValue<R>, DataGridForcedPropsKey> & {
     pagination?: true;
 };
 /**
  * The props of the `DataGrid` component after the pre-processing phase.
  */
-export interface DataGridProcessedProps extends DataGridPropsWithDefaultValues, DataGridPropsWithComplexDefaultValueAfterProcessing, DataGridPropsWithoutDefaultValue {
+export interface DataGridProcessedProps<R extends GridValidRowModel = any> extends DataGridPropsWithDefaultValues, DataGridPropsWithComplexDefaultValueAfterProcessing, DataGridPropsWithoutDefaultValue<R> {
 }
 /**
  * The props of the `DataGrid` component after the pre-processing phase that the user should not be able to override.
@@ -289,7 +293,7 @@ export interface DataGridPropsWithDefaultValues {
 /**
  * The `DataGrid` props with no default value.
  */
-export interface DataGridPropsWithoutDefaultValue extends CommonProps {
+export interface DataGridPropsWithoutDefaultValue<R extends GridValidRowModel = any> extends CommonProps {
     /**
      * The ref object that allows grid manipulation. Can be instantiated with [[useGridApiRef()]].
      * TODO: Remove `@internal` when opening `apiRef` to Community plan
@@ -324,13 +328,13 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
      * @param {GridCellParams} params With all properties from [[GridCellParams]].
      * @returns {string} The CSS class to apply to the cell.
      */
-    getCellClassName?: (params: GridCellParams) => string;
+    getCellClassName?: (params: GridCellParams<any, R>) => string;
     /**
      * Function that applies CSS classes dynamically on rows.
      * @param {GridRowClassNameParams} params With all properties from [[GridRowClassNameParams]].
      * @returns {string} The CSS class to apply to the row.
      */
-    getRowClassName?: (params: GridRowClassNameParams) => string;
+    getRowClassName?: (params: GridRowClassNameParams<R>) => string;
     /**
      * Function that sets the row height per row.
      * @param {GridRowHeightParams} params With all properties from [[GridRowHeightParams]].
@@ -348,25 +352,25 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
      * @param {GridRowParams} params With all properties from [[GridRowParams]].
      * @returns {JSX.Element} The row detail element.
      */
-    getDetailPanelContent?: (params: GridRowParams) => React.ReactNode;
+    getDetailPanelContent?: (params: GridRowParams<R>) => React.ReactNode;
     /**
      * Callback fired when a cell is rendered, returns true if the cell is editable.
      * @param {GridCellParams} params With all properties from [[GridCellParams]].
      * @returns {boolean} A boolean indicating if the cell is editable.
      */
-    isCellEditable?: (params: GridCellParams) => boolean;
+    isCellEditable?: (params: GridCellParams<any, R>) => boolean;
     /**
      * Determines if a row can be selected.
      * @param {GridRowParams} params With all properties from [[GridRowParams]].
      * @returns {boolean} A boolean indicating if the cell is selectable.
      */
-    isRowSelectable?: (params: GridRowParams) => boolean;
+    isRowSelectable?: (params: GridRowParams<R>) => boolean;
     /**
      * Callback fired when the edit cell value changes.
      * @param {GridEditCellPropsParams} params With all properties from [[GridEditCellPropsParams]].
      * @param {MuiEvent<React.SyntheticEvent>} event The event that caused this prop to be called.
      * @param {GridCallbackDetails} details Additional details for this callback.
-     * @deprecated use `preProcessEditCellProps` from the [`GridColDef`](/api/data-grid/grid-col-def/)
+     * @deprecated use `preProcessEditCellProps` from the [`GridColDef`](/x/api/data-grid/grid-col-def/)
      */
     onEditCellPropsChange?: GridEventListener<GridEvents.editCellPropsChange>;
     /**
@@ -552,6 +556,20 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
      * @param {GridCallbackDetails} details Additional details for this callback.
      */
     onPageSizeChange?: (pageSize: number, details: GridCallbackDetails) => void;
+    /**
+     * Callback fired when the preferences panel is closed.
+     * @param {GridPreferencePanelParams} params With all properties from [[GridPreferencePanelParams]].
+     * @param {MuiEvent<{}>} event The event object.
+     * @param {GridCallbackDetails} details Additional details for this callback.
+     */
+    onPreferencePanelClose?: GridEventListener<GridEvents.preferencePanelClose>;
+    /**
+     * Callback fired when the preferences panel is opened.
+     * @param {GridPreferencePanelParams} params With all properties from [[GridPreferencePanelParams]].
+     * @param {MuiEvent<{}>} event The event object.
+     * @param {GridCallbackDetails} details Additional details for this callback.
+     */
+    onPreferencePanelOpen?: GridEventListener<GridEvents.preferencePanelOpen>;
     /**
      * Set the edit rows model of the grid.
      */
@@ -614,7 +632,7 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
     /**
      * Set of columns of type [[GridColumns]].
      */
-    columns: GridColumns;
+    columns: GridColumns<R>;
     /**
      * An error that will turn the grid into its error state and display the error component.
      */
@@ -622,7 +640,7 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
     /**
      * Return the id of a given [[GridRowModel]].
      */
-    getRowId?: GridRowIdGetter;
+    getRowId?: GridRowIdGetter<R>;
     /**
      * If `true`, a  loading overlay is displayed.
      */
@@ -634,7 +652,7 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
     /**
      * Set of rows of type [[GridRowsProp]].
      */
-    rows: GridRowsProp;
+    rows: GridRowsProp<R>;
     /**
      * The initial state of the DataGrid.
      * The data in it will be set in the state on initialization but will not be controlled.
@@ -654,4 +672,18 @@ export interface DataGridPropsWithoutDefaultValue extends CommonProps {
      * For each feature, if the flag is not explicitly set to `true`, the feature will be fully disabled and any property / method call will not have any effect.
      */
     experimentalFeatures?: Partial<GridExperimentalFeatures>;
+    /**
+     * Callback called before updating a row with new values in the row and cell editing.
+     * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+     * @template R
+     * @param {R} newRow Row object with the new values.
+     * @param {R} oldRow Row object with the old values.
+     * @returns {Promise<R> | R} The final values to update the row.
+     */
+    processRowUpdate?: (newRow: R, oldRow: R) => Promise<R> | R;
+    /**
+     * Callback called when `processRowUpdate` throws an error or rejects.
+     * @param {any} error The error thrown.
+     */
+    onProcessRowUpdateError?: (error: any) => void;
 }

package/modern/DataGrid/DataGrid.js

@@ -183,6 +183,7 @@ DataGridRaw.propTypes = {
    * For each feature, if the flag is not explicitly set to `true`, the feature will be fully disabled and any property / method call will not have any effect.
    */
   experimentalFeatures: PropTypes.shape({
+    newEditingApi: PropTypes.bool,
     preventCommitWhileValidating: PropTypes.bool,
     warnIfFocusStateIsNotSynced: PropTypes.bool
   }),
@@ -457,7 +458,7 @@ DataGridRaw.propTypes = {
    * @param {GridEditCellPropsParams} params With all properties from [[GridEditCellPropsParams]].
    * @param {MuiEvent<React.SyntheticEvent>} event The event that caused this prop to be called.
    * @param {GridCallbackDetails} details Additional details for this callback.
-   * @deprecated use `preProcessEditCellProps` from the [`GridColDef`](/api/data-grid/grid-col-def/)
+   * @deprecated use `preProcessEditCellProps` from the [`GridColDef`](/x/api/data-grid/grid-col-def/)
    */
   onEditCellPropsChange: PropTypes.func,
 
@@ -497,6 +498,28 @@ DataGridRaw.propTypes = {
    */
   onPageSizeChange: PropTypes.func,
 
+  /**
+   * Callback fired when the preferences panel is closed.
+   * @param {GridPreferencePanelParams} params With all properties from [[GridPreferencePanelParams]].
+   * @param {MuiEvent<{}>} event The event object.
+   * @param {GridCallbackDetails} details Additional details for this callback.
+   */
+  onPreferencePanelClose: PropTypes.func,
+
+  /**
+   * Callback fired when the preferences panel is opened.
+   * @param {GridPreferencePanelParams} params With all properties from [[GridPreferencePanelParams]].
+   * @param {MuiEvent<{}>} event The event object.
+   * @param {GridCallbackDetails} details Additional details for this callback.
+   */
+  onPreferencePanelOpen: PropTypes.func,
+
+  /**
+   * Callback called when `processRowUpdate` throws an error or rejects.
+   * @param {any} error The error thrown.
+   */
+  onProcessRowUpdateError: PropTypes.func,
+
   /**
    * Callback fired when the grid is resized.
    * @param {ElementSize} containerSize With all properties from [[ElementSize]].
@@ -600,6 +623,16 @@ DataGridRaw.propTypes = {
    */
   paginationMode: PropTypes.oneOf(['client', 'server']),
 
+  /**
+   * Callback called before updating a row with new values in the row and cell editing.
+   * Only applied if `props.experimentalFeatures.newEditingApi: true`.
+   * @template R
+   * @param {R} newRow Row object with the new values.
+   * @param {R} oldRow Row object with the old values.
+   * @returns {Promise<R> | R} The final values to update the row.
+   */
+  processRowUpdate: PropTypes.func,
+
   /**
    * Number of extra rows to be rendered before/after the visible slice.
    * @default 3
@@ -621,7 +654,7 @@ DataGridRaw.propTypes = {
   /**
    * Set of rows of type [[GridRowsProp]].
    */
-  rows: PropTypes.arrayOf(PropTypes.object).isRequired,
+  rows: PropTypes.array.isRequired,
 
   /**
    * Sets the type of space between rows added by `getRowSpacing`.