@mui/x-data-grid 9.11.0 → 9.13.0

package/hooks/features/filter/useGridFilter.mjs

@@ -15,7 +15,7 @@ import { useFirstRender } from "../../utils/useFirstRender.mjs";
 import { gridRowsLookupSelector } from "../rows/index.mjs";
 import { useGridRegisterPipeProcessor } from "../../core/pipeProcessing/index.mjs";
 import { GRID_DEFAULT_STRATEGY, useGridRegisterStrategyProcessor } from "../../core/strategyProcessing/index.mjs";
-import { buildAggregatedFilterApplier, sanitizeFilterModel, mergeStateWithFilterModel, cleanFilterItem, passFilterLogic, shouldQuickFilterExcludeHiddenColumns, upsertFilterItemInModel, upsertFilterItemsInModel, deleteFilterItemFromModel, setFilterLogicOperatorInModel } from "./gridFilterUtils.mjs";
+import { buildAggregatedFilterApplier, sanitizeFilterModel, mergeStateWithFilterModel, cleanFilterItem, passFilterLogic, shouldQuickFilterExcludeHiddenColumns, upsertFilterItemInModel, upsertFilterItemsInModel, deleteFilterItemFromModel, setFilterLogicOperatorInModel, isFilterItemComplete } from "./gridFilterUtils.mjs";
 import { jsx as _jsx } from "react/jsx-runtime";
 export const filterStateInitializer = (state, props, apiRef) => {
   const filterModel = props.filterModel ?? props.initialState?.filter?.filterModel ?? getDefaultGridFilterModel();
@@ -94,27 +94,7 @@ export const useGridFilter = (apiRef, props, configuration) => {
     logger.debug('Displaying filter panel');
     if (targetColumnField) {
       const filterModel = gridFilterModelSelector(apiRef);
-      const filterItemsWithValue = filterModel.items.filter(item => {
-        if (item.value !== undefined) {
-          // Some filters like `isAnyOf` support array as `item.value`.
-          // If array is empty, we want to remove it from the filter model.
-          if (Array.isArray(item.value) && item.value.length === 0) {
-            return false;
-          }
-          return true;
-        }
-        const column = apiRef.current.getColumn(item.field);
-        const filterOperator = column?.filterOperators?.find(operator => operator.value === item.operator);
-        const requiresFilterValue = typeof filterOperator?.requiresFilterValue === 'undefined' ? true : filterOperator?.requiresFilterValue;
-
-        // Operators like `isEmpty` don't have and don't require `item.value`.
-        // So we don't want to remove them from the filter model if `item.value === undefined`.
-        // See https://github.com/mui/mui-x/issues/5402
-        if (requiresFilterValue) {
-          return false;
-        }
-        return true;
-      });
+      const filterItemsWithValue = filterModel.items.filter(item => isFilterItemComplete(item, apiRef.current.getColumn(item.field)));
       let newFilterItems;
       const filterItemOnTarget = filterItemsWithValue.find(item => item.field === targetColumnField);
       const targetColumn = apiRef.current.getColumn(targetColumnField);

package/hooks/features/headerFiltering/gridHeaderFilteringSelectors.js

@@ -7,7 +7,7 @@ exports.gridHeaderFilteringStateSelector = exports.gridHeaderFilteringMenuSelect
 var _createSelector = require("../../../utils/createSelector");
 const gridHeaderFilteringStateSelector = exports.gridHeaderFilteringStateSelector = (0, _createSelector.createRootSelector)(state => state.headerFiltering);
 const gridHeaderFilteringEnabledSelector = exports.gridHeaderFilteringEnabledSelector = (0, _createSelector.createSelector)(gridHeaderFilteringStateSelector,
-// No initialization in MIT, so we need to default to false to be used by `getTotalHeaderHeight`
+// The state is only initialized in Pro, so it is `undefined` on the MIT grid.
 headerFilteringState => headerFilteringState?.enabled ?? false);
 const gridHeaderFilteringEditFieldSelector = exports.gridHeaderFilteringEditFieldSelector = (0, _createSelector.createSelector)(gridHeaderFilteringStateSelector, headerFilteringState => headerFilteringState.editing);
 const gridHeaderFilteringMenuSelector = exports.gridHeaderFilteringMenuSelector = (0, _createSelector.createSelector)(gridHeaderFilteringStateSelector, headerFilteringState => headerFilteringState.menuOpen);

package/hooks/features/headerFiltering/gridHeaderFilteringSelectors.mjs

@@ -1,7 +1,7 @@
 import { createSelector, createRootSelector } from "../../../utils/createSelector.mjs";
 export const gridHeaderFilteringStateSelector = createRootSelector(state => state.headerFiltering);
 export const gridHeaderFilteringEnabledSelector = createSelector(gridHeaderFilteringStateSelector,
-// No initialization in MIT, so we need to default to false to be used by `getTotalHeaderHeight`
+// The state is only initialized in Pro, so it is `undefined` on the MIT grid.
 headerFilteringState => headerFilteringState?.enabled ?? false);
 export const gridHeaderFilteringEditFieldSelector = createSelector(gridHeaderFilteringStateSelector, headerFilteringState => headerFilteringState.editing);
 export const gridHeaderFilteringMenuSelector = createSelector(gridHeaderFilteringStateSelector, headerFilteringState => headerFilteringState.menuOpen);

package/hooks/features/pivoting/gridPivotingInterfaces.d.mts

@@ -1,10 +1,10 @@
-import type { GridRowModelUpdate } from '@mui/x-data-grid';
+import type { GridRowModelUpdate, GridRowModelReplace } from '@mui/x-data-grid';
 import type { GridColDef } from "../../../models/colDef/index.mjs";
 export interface GridPivotingStatePartial {
   active: boolean;
   initialColumns: Map<string, GridColDef> | undefined;
 }
 export interface GridPivotingPrivateApiCommunity {
-  updateNonPivotRows: (rows: readonly GridRowModelUpdate[], keepPreviousRows?: boolean) => void;
+  updateNonPivotRows: (rows: ReadonlyArray<GridRowModelUpdate | GridRowModelReplace>, keepPreviousRows?: boolean) => void;
   updateNonPivotColumns: (columns: readonly GridColDef[], keepPreviousColumns?: boolean) => void;
 }

package/hooks/features/pivoting/gridPivotingInterfaces.d.ts

@@ -1,10 +1,10 @@
-import type { GridRowModelUpdate } from '@mui/x-data-grid';
+import type { GridRowModelUpdate, GridRowModelReplace } from '@mui/x-data-grid';
 import type { GridColDef } from "../../../models/colDef/index.js";
 export interface GridPivotingStatePartial {
   active: boolean;
   initialColumns: Map<string, GridColDef> | undefined;
 }
 export interface GridPivotingPrivateApiCommunity {
-  updateNonPivotRows: (rows: readonly GridRowModelUpdate[], keepPreviousRows?: boolean) => void;
+  updateNonPivotRows: (rows: ReadonlyArray<GridRowModelUpdate | GridRowModelReplace>, keepPreviousRows?: boolean) => void;
   updateNonPivotColumns: (columns: readonly GridColDef[], keepPreviousColumns?: boolean) => void;
 }

package/hooks/features/rowSelection/useGridRowSelection.js

@@ -542,7 +542,7 @@ You need to upgrade to DataGridPro or DataGridPremium component to unlock multip
       handleSingleRowSelection(params.id, event);
       return;
     }
-    if (String.fromCharCode(event.keyCode) === 'A' && (event.ctrlKey || event.metaKey)) {
+    if ((0, _keyboardUtils.isSelectAllShortcut)(event)) {
       event.preventDefault();
       if (canHaveMultipleSelection) {
         toggleAllRows(true);

package/hooks/features/rowSelection/useGridRowSelection.mjs

@@ -15,7 +15,7 @@ import { gridFocusCellSelector } from "../focus/gridFocusStateSelector.mjs";
 import { gridExpandedSortedRowIdsSelector, gridFilteredRowsLookupSelector, gridFilterModelSelector, gridQuickFilterValuesSelector } from "../filter/gridFilterSelector.mjs";
 import { GRID_CHECKBOX_SELECTION_COL_DEF, GRID_ACTIONS_COLUMN_TYPE } from "../../../colDef/index.mjs";
 import { GridCellModes } from "../../../models/gridEditRowModel.mjs";
-import { isKeyboardEvent, isNavigationKey } from "../../../utils/keyboardUtils.mjs";
+import { isKeyboardEvent, isNavigationKey, isSelectAllShortcut } from "../../../utils/keyboardUtils.mjs";
 import { getVisibleRows } from "../../utils/useGridVisibleRows.mjs";
 import { GRID_DETAIL_PANEL_TOGGLE_FIELD } from "../../../internals/constants.mjs";
 import { gridClasses } from "../../../constants/gridClasses.mjs";
@@ -534,7 +534,7 @@ You need to upgrade to DataGridPro or DataGridPremium component to unlock multip
       handleSingleRowSelection(params.id, event);
       return;
     }
-    if (String.fromCharCode(event.keyCode) === 'A' && (event.ctrlKey || event.metaKey)) {
+    if (isSelectAllShortcut(event)) {
       event.preventDefault();
       if (canHaveMultipleSelection) {
         toggleAllRows(true);

package/hooks/features/rows/gridRowsUtils.d.mts

@@ -1,5 +1,5 @@
 import type { RefObject } from '@mui/x-internals/types';
-import type { GridAutoGeneratedGroupNode, GridAutoGeneratedPinnedRowNode, GridColDef, GridFooterNode, GridGroupNode, GridRowId, GridRowIdGetter, GridRowModel, GridRowModelUpdate, GridRowTreeConfig, GridSkeletonRowNode, GridTreeNode, GridValidRowModel } from "../../../models/index.mjs";
+import type { GridAutoGeneratedGroupNode, GridAutoGeneratedPinnedRowNode, GridColDef, GridFooterNode, GridGroupNode, GridRowId, GridRowIdGetter, GridRowModel, GridRowModelUpdate, GridRowModelReplace, GridRowTreeConfig, GridSkeletonRowNode, GridTreeNode, GridValidRowModel } from "../../../models/index.mjs";
 import type { DataGridProcessedProps } from "../../../models/props/DataGridProps.mjs";
 import type { GridApiCommunity, GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.mjs";
 import type { GridRowsInternalCache, GridRowsState, GridRowTreeCreationParams } from "./gridRowsInterfaces.mjs";
@@ -43,6 +43,40 @@ export declare const getRowsStateFromCache: ({
 export declare const isAutogeneratedRow: (row: GridRowModel) => boolean;
 export declare const isAutogeneratedRowNode: (rowNode: GridTreeNode) => rowNode is GridFooterNode | GridSkeletonRowNode | GridAutoGeneratedGroupNode | GridAutoGeneratedPinnedRowNode;
 export declare const getTreeNodeDescendants: (tree: GridRowTreeConfig, parentId: GridRowId, skipAutoGeneratedRows: boolean, directChildrenOnly?: boolean) => GridRowId[];
+export declare const isReplaceUpdate: (update: GridRowModelUpdate | GridRowModelReplace) => update is GridRowModelReplace;
+/**
+ * Extracts the replacement row from a `{ _action: 'replace', row }` update.
+ * The marker lives on the throwaway envelope, so the row object itself is never touched.
+ * @param {GridRowModelReplace} update The update provided to `updateRows()`.
+ * @returns {GridRowModel} The object to store as the row, verbatim.
+ */
+export declare const getReplaceRow: (update: GridRowModelReplace) => GridRowModel;
+/**
+ * Merges a partial update into the existing row.
+ * Prototype-preservation rules:
+ *   1. If partialRow is a class instance (non-plain object), use its prototype — the
+ *      caller is passing in a fully-constructed instance and owns the prototype chain.
+ *   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
+ *      that a partial-update object does not silently discard the existing row's class.
+ *   3. If both are plain objects the result is also a plain object (no-op).
+ *
+ * Note: private class fields (#field syntax) cannot be preserved through a spread-style
+ * merge because the brand check is tied to the original instance. Rows that rely on
+ * private fields must either supply a fully-constructed instance as partialRow (rule 1
+ * above) or use `_action: 'replace'` rather than a plain-object partial update.
+ * @param {GridRowModel} oldRow The row currently stored in the lookup.
+ * @param {GridRowModelUpdate} partialRow The update to merge into it.
+ * @returns {GridRowModel} The merged row.
+ */
+export declare const mergeRowUpdate: (oldRow: GridRowModel, partialRow: GridRowModelUpdate) => GridRowModel;
+/**
+ * Warns when a replace demotes a class instance to a plain object, which happens when the
+ * replacement was built with a spread instead of being passed as-is.
+ * Dev-only, does nothing in production.
+ * @param {GridRowModel | undefined} oldRow The row being replaced, if any.
+ * @param {GridRowModel} replacement The row provided in a `{ _action: 'replace', row }` update.
+ */
+export declare const warnIfReplaceLosesPrototype: (oldRow: GridRowModel | undefined, replacement: GridRowModel) => void;
 export declare const updateCacheWithNewRows: ({
   previousCache,
   getRowId,
@@ -51,10 +85,10 @@ export declare const updateCacheWithNewRows: ({
 }: {
   previousCache: GridRowsInternalCache;
   getRowId: DataGridProcessedProps['getRowId'];
-  updates: GridRowModelUpdate[];
+  updates: Array<GridRowModelUpdate | GridRowModelReplace>;
   groupKeys?: string[];
 }) => GridRowsInternalCache;
 export declare const minimalContentHeight = "var(--DataGrid-overlayHeight, calc(var(--height) * 2))";
-export declare function computeRowsUpdates(apiRef: RefObject<GridApiCommunity>, updates: GridRowModelUpdate[], getRowId: DataGridProcessedProps['getRowId']): GridRowModelUpdate[];
+export declare function computeRowsUpdates(apiRef: RefObject<GridApiCommunity>, updates: Array<GridRowModelUpdate | GridRowModelReplace>, getRowId: DataGridProcessedProps['getRowId']): (GridRowModelReplace<GridValidRowModel> | GridRowModelUpdate)[];
 export declare const getValidRowHeight: (rowHeightProp: any, defaultRowHeight: number, warningMessage: string) => number;
 export declare const rowHeightWarning: string;

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

@@ -1,5 +1,5 @@
 import type { RefObject } from '@mui/x-internals/types';
-import type { GridAutoGeneratedGroupNode, GridAutoGeneratedPinnedRowNode, GridColDef, GridFooterNode, GridGroupNode, GridRowId, GridRowIdGetter, GridRowModel, GridRowModelUpdate, GridRowTreeConfig, GridSkeletonRowNode, GridTreeNode, GridValidRowModel } from "../../../models/index.js";
+import type { GridAutoGeneratedGroupNode, GridAutoGeneratedPinnedRowNode, GridColDef, GridFooterNode, GridGroupNode, GridRowId, GridRowIdGetter, GridRowModel, GridRowModelUpdate, GridRowModelReplace, GridRowTreeConfig, GridSkeletonRowNode, GridTreeNode, GridValidRowModel } from "../../../models/index.js";
 import type { DataGridProcessedProps } from "../../../models/props/DataGridProps.js";
 import type { GridApiCommunity, GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
 import type { GridRowsInternalCache, GridRowsState, GridRowTreeCreationParams } from "./gridRowsInterfaces.js";
@@ -43,6 +43,40 @@ export declare const getRowsStateFromCache: ({
 export declare const isAutogeneratedRow: (row: GridRowModel) => boolean;
 export declare const isAutogeneratedRowNode: (rowNode: GridTreeNode) => rowNode is GridFooterNode | GridSkeletonRowNode | GridAutoGeneratedGroupNode | GridAutoGeneratedPinnedRowNode;
 export declare const getTreeNodeDescendants: (tree: GridRowTreeConfig, parentId: GridRowId, skipAutoGeneratedRows: boolean, directChildrenOnly?: boolean) => GridRowId[];
+export declare const isReplaceUpdate: (update: GridRowModelUpdate | GridRowModelReplace) => update is GridRowModelReplace;
+/**
+ * Extracts the replacement row from a `{ _action: 'replace', row }` update.
+ * The marker lives on the throwaway envelope, so the row object itself is never touched.
+ * @param {GridRowModelReplace} update The update provided to `updateRows()`.
+ * @returns {GridRowModel} The object to store as the row, verbatim.
+ */
+export declare const getReplaceRow: (update: GridRowModelReplace) => GridRowModel;
+/**
+ * Merges a partial update into the existing row.
+ * Prototype-preservation rules:
+ *   1. If partialRow is a class instance (non-plain object), use its prototype — the
+ *      caller is passing in a fully-constructed instance and owns the prototype chain.
+ *   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
+ *      that a partial-update object does not silently discard the existing row's class.
+ *   3. If both are plain objects the result is also a plain object (no-op).
+ *
+ * Note: private class fields (#field syntax) cannot be preserved through a spread-style
+ * merge because the brand check is tied to the original instance. Rows that rely on
+ * private fields must either supply a fully-constructed instance as partialRow (rule 1
+ * above) or use `_action: 'replace'` rather than a plain-object partial update.
+ * @param {GridRowModel} oldRow The row currently stored in the lookup.
+ * @param {GridRowModelUpdate} partialRow The update to merge into it.
+ * @returns {GridRowModel} The merged row.
+ */
+export declare const mergeRowUpdate: (oldRow: GridRowModel, partialRow: GridRowModelUpdate) => GridRowModel;
+/**
+ * Warns when a replace demotes a class instance to a plain object, which happens when the
+ * replacement was built with a spread instead of being passed as-is.
+ * Dev-only, does nothing in production.
+ * @param {GridRowModel | undefined} oldRow The row being replaced, if any.
+ * @param {GridRowModel} replacement The row provided in a `{ _action: 'replace', row }` update.
+ */
+export declare const warnIfReplaceLosesPrototype: (oldRow: GridRowModel | undefined, replacement: GridRowModel) => void;
 export declare const updateCacheWithNewRows: ({
   previousCache,
   getRowId,
@@ -51,10 +85,10 @@ export declare const updateCacheWithNewRows: ({
 }: {
   previousCache: GridRowsInternalCache;
   getRowId: DataGridProcessedProps['getRowId'];
-  updates: GridRowModelUpdate[];
+  updates: Array<GridRowModelUpdate | GridRowModelReplace>;
   groupKeys?: string[];
 }) => GridRowsInternalCache;
 export declare const minimalContentHeight = "var(--DataGrid-overlayHeight, calc(var(--height) * 2))";
-export declare function computeRowsUpdates(apiRef: RefObject<GridApiCommunity>, updates: GridRowModelUpdate[], getRowId: DataGridProcessedProps['getRowId']): GridRowModelUpdate[];
+export declare function computeRowsUpdates(apiRef: RefObject<GridApiCommunity>, updates: Array<GridRowModelUpdate | GridRowModelReplace>, getRowId: DataGridProcessedProps['getRowId']): (GridRowModelReplace<GridValidRowModel> | GridRowModelUpdate)[];
 export declare const getValidRowHeight: (rowHeightProp: any, defaultRowHeight: number, warningMessage: string) => number;
 export declare const rowHeightWarning: string;

package/hooks/features/rows/gridRowsUtils.js

@@ -7,9 +7,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.buildRootGroup = exports.GRID_ROOT_GROUP_ID = exports.GRID_ID_AUTOGENERATED = void 0;
 exports.checkGridRowIdIsValid = checkGridRowIdIsValid;
 exports.computeRowsUpdates = computeRowsUpdates;
-exports.updateCacheWithNewRows = exports.rowHeightWarning = exports.minimalContentHeight = exports.isAutogeneratedRowNode = exports.isAutogeneratedRow = exports.getValidRowHeight = exports.getTreeNodeDescendants = exports.getTopLevelRowCount = exports.getRowsStateFromCache = exports.getRowValue = exports.getRowIdFromRowModel = exports.createRowsInternalCache = void 0;
+exports.warnIfReplaceLosesPrototype = exports.updateCacheWithNewRows = exports.rowHeightWarning = exports.minimalContentHeight = exports.mergeRowUpdate = exports.isReplaceUpdate = exports.isAutogeneratedRowNode = exports.isAutogeneratedRow = exports.getValidRowHeight = exports.getTreeNodeDescendants = exports.getTopLevelRowCount = exports.getRowsStateFromCache = exports.getRowValue = exports.getRowIdFromRowModel = exports.getReplaceRow = exports.createRowsInternalCache = void 0;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
+var _warning = require("@mui/x-internals/warning");
 var _gridRowsSelector = require("./gridRowsSelector");
 const GRID_ROOT_GROUP_ID = exports.GRID_ROOT_GROUP_ID = `auto-generated-group-node-root`;
 const GRID_ID_AUTOGENERATED = exports.GRID_ID_AUTOGENERATED = Symbol('mui.id_autogenerated');
@@ -178,6 +179,83 @@ const getTreeNodeDescendants = (tree, parentId, skipAutoGeneratedRows, directChi
   return validDescendants;
 };
 exports.getTreeNodeDescendants = getTreeNodeDescendants;
+const isReplaceUpdate = update =>
+// eslint-disable-next-line no-underscore-dangle
+update._action === 'replace';
+
+/**
+ * Extracts the replacement row from a `{ _action: 'replace', row }` update.
+ * The marker lives on the throwaway envelope, so the row object itself is never touched.
+ * @param {GridRowModelReplace} update The update provided to `updateRows()`.
+ * @returns {GridRowModel} The object to store as the row, verbatim.
+ */
+exports.isReplaceUpdate = isReplaceUpdate;
+const getReplaceRow = update => {
+  const {
+    row
+  } = update;
+  if (row == null) {
+    throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Data Grid: A row update with \`_action: 'replace'\` was provided without a \`row\` property.
+Without it, the Data Grid does not know which object to store for that row.
+Provide the replacement object in the \`row\` property, for example \`updateRows([{ _action: 'replace', row }])\`.
+For more detail, see https://mui.com/x/react-data-grid/row-updates/.` : (0, _formatErrorMessage2.default)(304));
+  }
+  return row;
+};
+
+/**
+ * Merges a partial update into the existing row.
+ * Prototype-preservation rules:
+ *   1. If partialRow is a class instance (non-plain object), use its prototype — the
+ *      caller is passing in a fully-constructed instance and owns the prototype chain.
+ *   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
+ *      that a partial-update object does not silently discard the existing row's class.
+ *   3. If both are plain objects the result is also a plain object (no-op).
+ *
+ * Note: private class fields (#field syntax) cannot be preserved through a spread-style
+ * merge because the brand check is tied to the original instance. Rows that rely on
+ * private fields must either supply a fully-constructed instance as partialRow (rule 1
+ * above) or use `_action: 'replace'` rather than a plain-object partial update.
+ * @param {GridRowModel} oldRow The row currently stored in the lookup.
+ * @param {GridRowModelUpdate} partialRow The update to merge into it.
+ * @returns {GridRowModel} The merged row.
+ */
+exports.getReplaceRow = getReplaceRow;
+const mergeRowUpdate = (oldRow, partialRow) => {
+  const partialRowProto = Object.getPrototypeOf(partialRow);
+  const isPartialRowPlain = partialRowProto === Object.prototype || partialRowProto === null;
+  const proto = isPartialRowPlain ? Object.getPrototypeOf(oldRow) : partialRowProto;
+  const merged = Object.create(proto);
+  Object.assign(merged, oldRow, partialRow);
+  return merged;
+};
+
+/**
+ * Warns when a replace demotes a class instance to a plain object, which happens when the
+ * replacement was built with a spread instead of being passed as-is.
+ * Dev-only, does nothing in production.
+ * @param {GridRowModel | undefined} oldRow The row being replaced, if any.
+ * @param {GridRowModel} replacement The row provided in a `{ _action: 'replace', row }` update.
+ */
+exports.mergeRowUpdate = mergeRowUpdate;
+const warnIfReplaceLosesPrototype = (oldRow, replacement) => {
+  if (process.env.NODE_ENV === 'production' || !oldRow) {
+    return;
+  }
+  const replacementProto = Object.getPrototypeOf(replacement);
+  if (replacementProto !== Object.prototype && replacementProto !== null) {
+    return;
+  }
+  const oldRowProto = Object.getPrototypeOf(oldRow);
+  if (oldRowProto === Object.prototype || oldRowProto === null) {
+    return;
+  }
+
+  // The message must stay free of row-specific details: `warnOnce()` caches by message, so
+  // interpolating the id would log once per row and grow the cache with every update.
+  (0, _warning.warnOnce)(["MUI X Data Grid: A plain object was provided as the `row` of a `_action: 'replace'` update, but the row it replaces is a class instance.", "Building the replacement with a spread (`{ _action: 'replace', row: { ...row } }`) creates a plain object, dropping the prototype chain and the private fields that `_action: 'replace'` exists to preserve.", "Pass the instance itself instead, for example `{ _action: 'replace', row }`.", 'For more detail, see https://mui.com/x/react-data-grid/row-updates/.']);
+};
+exports.warnIfReplaceLosesPrototype = warnIfReplaceLosesPrototype;
 const updateCacheWithNewRows = ({
   previousCache,
   getRowId,
@@ -191,10 +269,28 @@ const updateCacheWithNewRows = ({
   // Remove duplicate updates.
   // A server can batch updates, and send several updates for the same row in one fn call.
   const uniqueUpdates = new Map();
+  // Ids whose accumulated update is stored as the row instead of being merged into the
+  // existing one. The flag lives outside the row object so that it is never mutated.
+  const replaceIds = new Set();
   updates.forEach(update => {
-    const id = getRowIdFromRowModel(update, getRowId, 'A row was provided without id when calling updateRows():');
-    if (uniqueUpdates.has(id)) {
-      uniqueUpdates.set(id, (0, _extends2.default)({}, uniqueUpdates.get(id), update));
+    // A replace is provided as a `{ _action: 'replace', row }` envelope: the marker stays
+    // on the throwaway envelope and the inner row is used verbatim, so that the object
+    // provided by the caller is the one that ends up in the lookup.
+    const isReplace = isReplaceUpdate(update);
+    const row = isReplace ? getReplaceRow(update) : update;
+    const id = getRowIdFromRowModel(row, getRowId, 'A row was provided without id when calling updateRows():');
+    if (isReplace) {
+      // A replace resets whatever has been accumulated for that id.
+      uniqueUpdates.set(id, row);
+      replaceIds.add(id);
+    } else if (uniqueUpdates.has(id)) {
+      const accumulatedUpdate = uniqueUpdates.get(id);
+      if (process.env.NODE_ENV !== 'production' && replaceIds.has(id)) {
+        (0, _warning.warnOnce)(["MUI X Data Grid: A row was provided with `_action: 'replace'` but it is not the last update for that row in this batch.", 'The remaining updates are merged onto the replacement, so the row keeps its prototype but is neither the same object nor carries its `#private` fields, which a merge cannot copy.', 'Make the replace the last update for that row if `apiRef.current.getRow(id)` must return the object you passed in.', 'For more detail, see https://mui.com/x/react-data-grid/row-updates/.']);
+      }
+      // The merge keeps the accumulated entry's prototype and the id stays in `replaceIds`,
+      // so the result is still applied as a replace.
+      uniqueUpdates.set(id, mergeRowUpdate(accumulatedUpdate, update));
     } else {
       uniqueUpdates.set(id, update);
     }
@@ -246,6 +342,15 @@ const updateCacheWithNewRows = ({
     }
     const oldRow = dataRowIdToModelLookup[id];
 
+    // Action === "replace"
+    // The bookkeeping is the same as for "modify" / "insert" below, only the way the row
+    // is stored differs: the object is stored as-is so that its prototype chain, private
+    // fields (#field) and reference identity are all preserved.
+    const isReplace = replaceIds.has(id);
+    if (isReplace) {
+      warnIfReplaceLosesPrototype(oldRow, partialRow);
+    }
+
     // Action === "modify"
     if (oldRow) {
       // If the data row has been removed since the last state update,
@@ -261,23 +366,7 @@ const updateCacheWithNewRows = ({
       }
 
       // Update the data row lookups.
-      // Prototype-preservation rules:
-      //   1. If partialRow is a class instance (non-plain object), use its prototype — the
-      //      caller is passing in a fully-constructed instance and owns the prototype chain.
-      //   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
-      //      that a partial-update object does not silently discard the existing row's class.
-      //   3. If both are plain objects the result is also a plain object (no-op).
-      //
-      // Note: private class fields (#field syntax) cannot be preserved through a spread-style
-      // merge because the brand check is tied to the original instance. Rows that rely on
-      // private fields must supply a fully-constructed instance as partialRow (rule 1 above)
-      // rather than a plain-object partial update.
-      const partialRowProto = Object.getPrototypeOf(partialRow);
-      const isPartialRowPlain = partialRowProto === Object.prototype || partialRowProto === null;
-      const proto = isPartialRowPlain ? Object.getPrototypeOf(oldRow) : partialRowProto;
-      const merged = Object.create(proto);
-      Object.assign(merged, oldRow, partialRow);
-      dataRowIdToModelLookup[id] = merged;
+      dataRowIdToModelLookup[id] = isReplace ? partialRow : mergeRowUpdate(oldRow, partialRow);
       return;
     }
 
@@ -319,16 +408,24 @@ const minimalContentHeight = exports.minimalContentHeight = 'var(--DataGrid-over
 function computeRowsUpdates(apiRef, updates, getRowId) {
   const nonPinnedRowsUpdates = [];
   updates.forEach(update => {
-    const id = getRowIdFromRowModel(update, getRowId, 'A row was provided without id when calling updateRows():');
+    const isReplace = isReplaceUpdate(update);
+    const row = isReplace ? getReplaceRow(update) : update;
+    const id = getRowIdFromRowModel(row, getRowId, 'A row was provided without id when calling updateRows():');
     const rowNode = (0, _gridRowsSelector.gridRowNodeSelector)(apiRef, id);
     if (rowNode?.type === 'pinnedRow') {
       // @ts-ignore because otherwise `release:build` doesn't work
       const pinnedRowsCache = apiRef.current.caches.pinnedRows;
       const prevModel = pinnedRowsCache.idLookup[id];
       if (prevModel) {
-        pinnedRowsCache.idLookup[id] = (0, _extends2.default)({}, prevModel, update);
+        if (isReplace) {
+          warnIfReplaceLosesPrototype(prevModel, row);
+          pinnedRowsCache.idLookup[id] = row;
+        } else {
+          pinnedRowsCache.idLookup[id] = mergeRowUpdate(prevModel, update);
+        }
       }
     } else {
+      // The envelope is passed through untouched, `updateCacheWithNewRows` unwraps it.
       nonPinnedRowsUpdates.push(update);
     }
   });

package/hooks/features/rows/gridRowsUtils.mjs

@@ -1,5 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _formatErrorMessage from "@mui/x-internals/formatErrorMessage";
+import { warnOnce } from '@mui/x-internals/warning';
 import { gridRowNodeSelector } from "./gridRowsSelector.mjs";
 export const GRID_ROOT_GROUP_ID = `auto-generated-group-node-root`;
 export const GRID_ID_AUTOGENERATED = Symbol('mui.id_autogenerated');
@@ -159,6 +160,79 @@ export const getTreeNodeDescendants = (tree, parentId, skipAutoGeneratedRows, di
   }
   return validDescendants;
 };
+export const isReplaceUpdate = update =>
+// eslint-disable-next-line no-underscore-dangle
+update._action === 'replace';
+
+/**
+ * Extracts the replacement row from a `{ _action: 'replace', row }` update.
+ * The marker lives on the throwaway envelope, so the row object itself is never touched.
+ * @param {GridRowModelReplace} update The update provided to `updateRows()`.
+ * @returns {GridRowModel} The object to store as the row, verbatim.
+ */
+export const getReplaceRow = update => {
+  const {
+    row
+  } = update;
+  if (row == null) {
+    throw new Error(process.env.NODE_ENV !== "production" ? `MUI X Data Grid: A row update with \`_action: 'replace'\` was provided without a \`row\` property.
+Without it, the Data Grid does not know which object to store for that row.
+Provide the replacement object in the \`row\` property, for example \`updateRows([{ _action: 'replace', row }])\`.
+For more detail, see https://mui.com/x/react-data-grid/row-updates/.` : _formatErrorMessage(304));
+  }
+  return row;
+};
+
+/**
+ * Merges a partial update into the existing row.
+ * Prototype-preservation rules:
+ *   1. If partialRow is a class instance (non-plain object), use its prototype — the
+ *      caller is passing in a fully-constructed instance and owns the prototype chain.
+ *   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
+ *      that a partial-update object does not silently discard the existing row's class.
+ *   3. If both are plain objects the result is also a plain object (no-op).
+ *
+ * Note: private class fields (#field syntax) cannot be preserved through a spread-style
+ * merge because the brand check is tied to the original instance. Rows that rely on
+ * private fields must either supply a fully-constructed instance as partialRow (rule 1
+ * above) or use `_action: 'replace'` rather than a plain-object partial update.
+ * @param {GridRowModel} oldRow The row currently stored in the lookup.
+ * @param {GridRowModelUpdate} partialRow The update to merge into it.
+ * @returns {GridRowModel} The merged row.
+ */
+export const mergeRowUpdate = (oldRow, partialRow) => {
+  const partialRowProto = Object.getPrototypeOf(partialRow);
+  const isPartialRowPlain = partialRowProto === Object.prototype || partialRowProto === null;
+  const proto = isPartialRowPlain ? Object.getPrototypeOf(oldRow) : partialRowProto;
+  const merged = Object.create(proto);
+  Object.assign(merged, oldRow, partialRow);
+  return merged;
+};
+
+/**
+ * Warns when a replace demotes a class instance to a plain object, which happens when the
+ * replacement was built with a spread instead of being passed as-is.
+ * Dev-only, does nothing in production.
+ * @param {GridRowModel | undefined} oldRow The row being replaced, if any.
+ * @param {GridRowModel} replacement The row provided in a `{ _action: 'replace', row }` update.
+ */
+export const warnIfReplaceLosesPrototype = (oldRow, replacement) => {
+  if (process.env.NODE_ENV === 'production' || !oldRow) {
+    return;
+  }
+  const replacementProto = Object.getPrototypeOf(replacement);
+  if (replacementProto !== Object.prototype && replacementProto !== null) {
+    return;
+  }
+  const oldRowProto = Object.getPrototypeOf(oldRow);
+  if (oldRowProto === Object.prototype || oldRowProto === null) {
+    return;
+  }
+
+  // The message must stay free of row-specific details: `warnOnce()` caches by message, so
+  // interpolating the id would log once per row and grow the cache with every update.
+  warnOnce(["MUI X Data Grid: A plain object was provided as the `row` of a `_action: 'replace'` update, but the row it replaces is a class instance.", "Building the replacement with a spread (`{ _action: 'replace', row: { ...row } }`) creates a plain object, dropping the prototype chain and the private fields that `_action: 'replace'` exists to preserve.", "Pass the instance itself instead, for example `{ _action: 'replace', row }`.", 'For more detail, see https://mui.com/x/react-data-grid/row-updates/.']);
+};
 export const updateCacheWithNewRows = ({
   previousCache,
   getRowId,
@@ -172,10 +246,28 @@ export const updateCacheWithNewRows = ({
   // Remove duplicate updates.
   // A server can batch updates, and send several updates for the same row in one fn call.
   const uniqueUpdates = new Map();
+  // Ids whose accumulated update is stored as the row instead of being merged into the
+  // existing one. The flag lives outside the row object so that it is never mutated.
+  const replaceIds = new Set();
   updates.forEach(update => {
-    const id = getRowIdFromRowModel(update, getRowId, 'A row was provided without id when calling updateRows():');
-    if (uniqueUpdates.has(id)) {
-      uniqueUpdates.set(id, _extends({}, uniqueUpdates.get(id), update));
+    // A replace is provided as a `{ _action: 'replace', row }` envelope: the marker stays
+    // on the throwaway envelope and the inner row is used verbatim, so that the object
+    // provided by the caller is the one that ends up in the lookup.
+    const isReplace = isReplaceUpdate(update);
+    const row = isReplace ? getReplaceRow(update) : update;
+    const id = getRowIdFromRowModel(row, getRowId, 'A row was provided without id when calling updateRows():');
+    if (isReplace) {
+      // A replace resets whatever has been accumulated for that id.
+      uniqueUpdates.set(id, row);
+      replaceIds.add(id);
+    } else if (uniqueUpdates.has(id)) {
+      const accumulatedUpdate = uniqueUpdates.get(id);
+      if (process.env.NODE_ENV !== 'production' && replaceIds.has(id)) {
+        warnOnce(["MUI X Data Grid: A row was provided with `_action: 'replace'` but it is not the last update for that row in this batch.", 'The remaining updates are merged onto the replacement, so the row keeps its prototype but is neither the same object nor carries its `#private` fields, which a merge cannot copy.', 'Make the replace the last update for that row if `apiRef.current.getRow(id)` must return the object you passed in.', 'For more detail, see https://mui.com/x/react-data-grid/row-updates/.']);
+      }
+      // The merge keeps the accumulated entry's prototype and the id stays in `replaceIds`,
+      // so the result is still applied as a replace.
+      uniqueUpdates.set(id, mergeRowUpdate(accumulatedUpdate, update));
     } else {
       uniqueUpdates.set(id, update);
     }
@@ -227,6 +319,15 @@ export const updateCacheWithNewRows = ({
     }
     const oldRow = dataRowIdToModelLookup[id];
 
+    // Action === "replace"
+    // The bookkeeping is the same as for "modify" / "insert" below, only the way the row
+    // is stored differs: the object is stored as-is so that its prototype chain, private
+    // fields (#field) and reference identity are all preserved.
+    const isReplace = replaceIds.has(id);
+    if (isReplace) {
+      warnIfReplaceLosesPrototype(oldRow, partialRow);
+    }
+
     // Action === "modify"
     if (oldRow) {
       // If the data row has been removed since the last state update,
@@ -242,23 +343,7 @@ export const updateCacheWithNewRows = ({
       }
 
       // Update the data row lookups.
-      // Prototype-preservation rules:
-      //   1. If partialRow is a class instance (non-plain object), use its prototype — the
-      //      caller is passing in a fully-constructed instance and owns the prototype chain.
-      //   2. If partialRow is a plain object (Object.prototype), prefer oldRow's prototype so
-      //      that a partial-update object does not silently discard the existing row's class.
-      //   3. If both are plain objects the result is also a plain object (no-op).
-      //
-      // Note: private class fields (#field syntax) cannot be preserved through a spread-style
-      // merge because the brand check is tied to the original instance. Rows that rely on
-      // private fields must supply a fully-constructed instance as partialRow (rule 1 above)
-      // rather than a plain-object partial update.
-      const partialRowProto = Object.getPrototypeOf(partialRow);
-      const isPartialRowPlain = partialRowProto === Object.prototype || partialRowProto === null;
-      const proto = isPartialRowPlain ? Object.getPrototypeOf(oldRow) : partialRowProto;
-      const merged = Object.create(proto);
-      Object.assign(merged, oldRow, partialRow);
-      dataRowIdToModelLookup[id] = merged;
+      dataRowIdToModelLookup[id] = isReplace ? partialRow : mergeRowUpdate(oldRow, partialRow);
       return;
     }
 
@@ -299,16 +384,24 @@ export const minimalContentHeight = 'var(--DataGrid-overlayHeight, calc(var(--he
 export function computeRowsUpdates(apiRef, updates, getRowId) {
   const nonPinnedRowsUpdates = [];
   updates.forEach(update => {
-    const id = getRowIdFromRowModel(update, getRowId, 'A row was provided without id when calling updateRows():');
+    const isReplace = isReplaceUpdate(update);
+    const row = isReplace ? getReplaceRow(update) : update;
+    const id = getRowIdFromRowModel(row, getRowId, 'A row was provided without id when calling updateRows():');
     const rowNode = gridRowNodeSelector(apiRef, id);
     if (rowNode?.type === 'pinnedRow') {
       // @ts-ignore because otherwise `release:build` doesn't work
       const pinnedRowsCache = apiRef.current.caches.pinnedRows;
       const prevModel = pinnedRowsCache.idLookup[id];
       if (prevModel) {
-        pinnedRowsCache.idLookup[id] = _extends({}, prevModel, update);
+        if (isReplace) {
+          warnIfReplaceLosesPrototype(prevModel, row);
+          pinnedRowsCache.idLookup[id] = row;
+        } else {
+          pinnedRowsCache.idLookup[id] = mergeRowUpdate(prevModel, update);
+        }
       }
     } else {
+      // The envelope is passed through untouched, `updateCacheWithNewRows` unwraps it.
       nonPinnedRowsUpdates.push(update);
     }
   });