@mui/x-data-grid 9.12.0 → 9.14.0

package/models/gridRows.d.ts

@@ -7,9 +7,36 @@ export type GridRowsProp<R extends GridValidRowModel = GridValidRowModel> = Read
  * The key value object representing the data of a row.
  */
 export type GridRowModel<R extends GridValidRowModel = GridValidRowModel> = R;
+/**
+ * @deprecated Use `GridRowModelUpdate` or `GridRowModelReplace` instead.
+ */
 export type GridUpdateAction = 'delete';
 export interface GridRowModelUpdate extends GridRowModel {
-  _action?: GridUpdateAction;
+  /**
+   * - `'delete'` removes the row.
+   * - `undefined` (default) performs a shallow, `Object.assign`-style partial merge into
+   *   the existing row, which produces a new object.
+   *
+   * To store an object as the row without merging, see [[GridRowModelReplace]].
+   */
+  _action?: 'delete';
+}
+/**
+ * A row update that stores `row` as-is instead of merging it into the existing row.
+ * Use this when the row is a class instance (e.g. one with `#private` fields) whose
+ * prototype chain and object identity must be preserved across the update:
+ * `apiRef.current.getRow(id)` then returns the very object provided in `row`.
+ * Any field missing from `row` is removed from the stored row, because a replace is
+ * never a merge.
+ * It can be passed to `updateRows()` or returned from `processRowUpdate()`.
+ */
+export interface GridRowModelReplace<R extends GridValidRowModel = GridValidRowModel> {
+  _action: 'replace';
+  /**
+   * The object stored as the new row, verbatim. Pass the instance itself — spreading it
+   * (`{ ...row }`) creates a plain object and defeats the purpose.
+   */
+  row: R;
 }
 /**
  * The grid rows total height and row positions.

package/models/props/DataGridProps.d.mts

@@ -8,7 +8,7 @@ import type { GridFeatureMode } from "../gridFeatureMode.mjs";
 import type { Logger } from "../logger.mjs";
 import type { GridSortDirection, GridSortModel } from "../gridSortModel.mjs";
 import type { GridSlotsComponent } from "../gridSlotsComponent.mjs";
-import type { GridRowId, GridRowIdGetter, GridRowsProp, GridValidRowModel } from "../gridRows.mjs";
+import type { GridRowId, GridRowIdGetter, GridRowModelReplace, GridRowsProp, GridValidRowModel } from "../gridRows.mjs";
 import type { GridEventListener } from "../events/index.mjs";
 import type { GridCallbackDetails, GridLocaleText } from "../api/index.mjs";
 import type { GridApiCommunity } from "../api/gridApiCommunity.mjs";
@@ -816,11 +816,11 @@ export interface DataGridPropsWithoutDefaultValue<R extends GridValidRowModel =
    * @param {R} newRow Row object with the new values.
    * @param {R} oldRow Row object with the old values.
    * @param {{ rowId: GridRowId }} params Additional parameters.
-   * @returns {Promise<R> | R} The final values to update the row.
+   * @returns {Promise<R | GridRowModelReplace<R>> | R | GridRowModelReplace<R>} The final values to update the row, or a `{ _action: 'replace', row }` update to store `row` as the new row without merging.
    */
   processRowUpdate?: (newRow: R, oldRow: R, params: {
     rowId: GridRowId;
-  }) => Promise<R> | R;
+  }) => Promise<R | GridRowModelReplace<R>> | R | GridRowModelReplace<R>;
   /**
    * Callback called when `processRowUpdate()` throws an error or rejects.
    * @param {any} error The error thrown.

package/models/props/DataGridProps.d.ts

@@ -8,7 +8,7 @@ import type { GridFeatureMode } from "../gridFeatureMode.js";
 import type { Logger } from "../logger.js";
 import type { GridSortDirection, GridSortModel } from "../gridSortModel.js";
 import type { GridSlotsComponent } from "../gridSlotsComponent.js";
-import type { GridRowId, GridRowIdGetter, GridRowsProp, GridValidRowModel } from "../gridRows.js";
+import type { GridRowId, GridRowIdGetter, GridRowModelReplace, GridRowsProp, GridValidRowModel } from "../gridRows.js";
 import type { GridEventListener } from "../events/index.js";
 import type { GridCallbackDetails, GridLocaleText } from "../api/index.js";
 import type { GridApiCommunity } from "../api/gridApiCommunity.js";
@@ -816,11 +816,11 @@ export interface DataGridPropsWithoutDefaultValue<R extends GridValidRowModel =
    * @param {R} newRow Row object with the new values.
    * @param {R} oldRow Row object with the old values.
    * @param {{ rowId: GridRowId }} params Additional parameters.
-   * @returns {Promise<R> | R} The final values to update the row.
+   * @returns {Promise<R | GridRowModelReplace<R>> | R | GridRowModelReplace<R>} The final values to update the row, or a `{ _action: 'replace', row }` update to store `row` as the new row without merging.
    */
   processRowUpdate?: (newRow: R, oldRow: R, params: {
     rowId: GridRowId;
-  }) => Promise<R> | R;
+  }) => Promise<R | GridRowModelReplace<R>> | R | GridRowModelReplace<R>;
   /**
    * Callback called when `processRowUpdate()` throws an error or rejects.
    * @param {any} error The error thrown.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-data-grid",
-  "version": "9.12.0",
+  "version": "9.14.0",
   "author": "MUI Team",
   "description": "The Community plan edition of the MUI X Data Grid components.",
   "license": "MIT",
@@ -38,13 +38,13 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.29.7",
-    "@base-ui/utils": "^0.3.1",
-    "@mui/utils": "^9.3.0",
+    "@base-ui/utils": "^0.3.2",
+    "@mui/utils": "^9.4.0",
+    "@mui/x-internals": "^9.14.0",
+    "@mui/x-virtualizer": "0.7.2",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
-    "use-sync-external-store": "^1.6.0",
-    "@mui/x-internals": "^9.12.0",
-    "@mui/x-virtualizer": "0.7.0"
+    "use-sync-external-store": "^1.7.0"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",

package/utils/keyboardUtils.d.mts

@@ -5,6 +5,7 @@ export declare const isKeyboardEvent: (event: any) => event is React.KeyboardEve
 export declare const isHideMenuKey: (key: React.KeyboardEvent['key']) => key is "Escape" | "Tab";
 export declare function isPasteShortcut(event: React.KeyboardEvent): boolean;
 export declare function isCopyShortcut(event: KeyboardEvent): boolean;
+export declare function isSelectAllShortcut(event: React.KeyboardEvent): boolean;
 export declare function isUndoShortcut(event: React.KeyboardEvent): boolean;
 export declare function isFillDownShortcut(event: React.KeyboardEvent): boolean;
 export declare function isFillRightShortcut(event: React.KeyboardEvent): boolean;

package/utils/keyboardUtils.d.ts

@@ -5,6 +5,7 @@ export declare const isKeyboardEvent: (event: any) => event is React.KeyboardEve
 export declare const isHideMenuKey: (key: React.KeyboardEvent['key']) => key is "Escape" | "Tab";
 export declare function isPasteShortcut(event: React.KeyboardEvent): boolean;
 export declare function isCopyShortcut(event: KeyboardEvent): boolean;
+export declare function isSelectAllShortcut(event: React.KeyboardEvent): boolean;
 export declare function isUndoShortcut(event: React.KeyboardEvent): boolean;
 export declare function isFillDownShortcut(event: React.KeyboardEvent): boolean;
 export declare function isFillRightShortcut(event: React.KeyboardEvent): boolean;

package/utils/keyboardUtils.js

@@ -10,6 +10,7 @@ exports.isNavigationKey = exports.isKeyboardEvent = exports.isHideMenuKey = void
 exports.isPasteShortcut = isPasteShortcut;
 exports.isPrintableKey = isPrintableKey;
 exports.isRedoShortcut = isRedoShortcut;
+exports.isSelectAllShortcut = isSelectAllShortcut;
 exports.isUndoShortcut = isUndoShortcut;
 // Non printable keys have a name, for example "ArrowRight", see the whole list:
 // https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_key_values
@@ -44,6 +45,11 @@ function isPasteShortcut(event) {
 function isCopyShortcut(event) {
   return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'C' && !event.shiftKey && !event.altKey;
 }
+
+// Checks if the keyboard event corresponds to the select-all shortcut (CTRL+A or CMD+A) across different localization keyboards.
+function isSelectAllShortcut(event) {
+  return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'A' && !event.shiftKey && !event.altKey;
+}
 function isUndoShortcut(event) {
   return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'Z' && !event.shiftKey && !event.altKey;
 }

package/utils/keyboardUtils.mjs

@@ -28,6 +28,11 @@ export function isPasteShortcut(event) {
 export function isCopyShortcut(event) {
   return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'C' && !event.shiftKey && !event.altKey;
 }
+
+// Checks if the keyboard event corresponds to the select-all shortcut (CTRL+A or CMD+A) across different localization keyboards.
+export function isSelectAllShortcut(event) {
+  return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'A' && !event.shiftKey && !event.altKey;
+}
 export function isUndoShortcut(event) {
   return (event.ctrlKey || event.metaKey) && String.fromCharCode(event.keyCode) === 'Z' && !event.shiftKey && !event.altKey;
 }