@mui/x-data-grid 9.10.1 → 9.12.0

package/hooks/features/editing/useGridCellEditing.mjs

@@ -13,6 +13,7 @@ import useEnhancedEffect from '@mui/utils/useEnhancedEffect';
 import { isDeepEqual } from '@mui/x-internals/isDeepEqual';
 import { useGridEvent, useGridEventPriority } from "../../utils/useGridEvent.mjs";
 import { GridEditModes, GridCellModes } from "../../../models/gridEditRowModel.mjs";
+import { getPublicApiRef } from "../../../utils/getPublicApiRef.mjs";
 import { useGridApiMethod } from "../../utils/useGridApiMethod.mjs";
 import { gridEditRowsStateSelector } from "./gridEditingSelectors.mjs";
 import { isPrintableKey, isPasteShortcut } from "../../../utils/keyboardUtils.mjs";
@@ -188,7 +189,8 @@ export const useGridCellEditing = (apiRef, props) => {
     const isNewModelDifferentFromProp = newModel !== props.cellModesModel;
     if (onCellModesModelChange && isNewModelDifferentFromProp) {
       onCellModesModelChange(newModel, {
-        api: apiRef.current
+        api: apiRef.current,
+        apiRef: getPublicApiRef(apiRef)
       });
     }
     if (props.cellModesModel && isNewModelDifferentFromProp) {

package/hooks/features/editing/useGridRowEditing.js

@@ -18,6 +18,7 @@ var _warning = require("@mui/x-internals/warning");
 var _isDeepEqual = require("@mui/x-internals/isDeepEqual");
 var _useGridEvent = require("../../utils/useGridEvent");
 var _gridEditRowModel = require("../../../models/gridEditRowModel");
+var _getPublicApiRef = require("../../../utils/getPublicApiRef");
 var _useGridApiMethod = require("../../utils/useGridApiMethod");
 var _gridEditingSelectors = require("./gridEditingSelectors");
 var _keyboardUtils = require("../../../utils/keyboardUtils");
@@ -265,7 +266,8 @@ const useGridRowEditing = (apiRef, props) => {
     const isNewModelDifferentFromProp = newModel !== props.rowModesModel;
     if (onRowModesModelChange && isNewModelDifferentFromProp) {
       onRowModesModelChange(newModel, {
-        api: apiRef.current
+        api: apiRef.current,
+        apiRef: (0, _getPublicApiRef.getPublicApiRef)(apiRef)
       });
     }
     if (props.rowModesModel && isNewModelDifferentFromProp) {

package/hooks/features/editing/useGridRowEditing.mjs

@@ -13,6 +13,7 @@ import { warnOnce } from '@mui/x-internals/warning';
 import { isDeepEqual } from '@mui/x-internals/isDeepEqual';
 import { useGridEvent, useGridEventPriority } from "../../utils/useGridEvent.mjs";
 import { GridEditModes, GridRowModes } from "../../../models/gridEditRowModel.mjs";
+import { getPublicApiRef } from "../../../utils/getPublicApiRef.mjs";
 import { useGridApiMethod } from "../../utils/useGridApiMethod.mjs";
 import { gridEditRowsStateSelector, gridRowIsEditingSelector } from "./gridEditingSelectors.mjs";
 import { isPrintableKey, isPasteShortcut } from "../../../utils/keyboardUtils.mjs";
@@ -258,7 +259,8 @@ export const useGridRowEditing = (apiRef, props) => {
     const isNewModelDifferentFromProp = newModel !== props.rowModesModel;
     if (onRowModesModelChange && isNewModelDifferentFromProp) {
       onRowModesModelChange(newModel, {
-        api: apiRef.current
+        api: apiRef.current,
+        apiRef: getPublicApiRef(apiRef)
       });
     }
     if (props.rowModesModel && isNewModelDifferentFromProp) {

package/hooks/features/filter/gridFilterUtils.d.mts

@@ -4,6 +4,7 @@ import type { GridColDef, GridFilterItem, GridFilterModel, GridRowModel } from "
 import type { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.mjs";
 import type { GridStateCommunity } from "../../../models/gridStateCommunity.mjs";
 import type { GridAggregatedFilterItemApplier, GridFilterItemResult, GridQuickFilterValueResult } from "./gridFilterState.mjs";
+import type { GridColumnLookup } from "../columns/index.mjs";
 /**
  * Pure helpers computing a new filter model from an existing one.
  * Shared by the imperative `apiRef` methods (`useGridFilter`) and the controlled
@@ -15,6 +16,18 @@ export declare const upsertFilterItemInModel: (model: GridFilterModel, item: Gri
 export declare const upsertFilterItemsInModel: (model: GridFilterModel, itemsToUpsert: GridFilterItem[]) => GridFilterModel;
 export declare const deleteFilterItemFromModel: (model: GridFilterModel, itemToDelete: GridFilterItem) => GridFilterModel;
 export declare const setFilterLogicOperatorInModel: (model: GridFilterModel, logicOperator: GridLogicOperator) => GridFilterModel;
+/**
+ * Whether a filter item carries everything its operator needs to be applied.
+ * Operators declaring `requiresFilterValue: false` (`isEmpty`, `isNotEmpty`) stay complete
+ * without a value, see https://github.com/mui/mui-x/issues/5402
+ */
+export declare const isFilterItemComplete: (item: GridFilterItem, column: GridColDef | undefined) => boolean;
+/**
+ * Drops the filter items that cannot be applied, so incomplete items never reach a consumer
+ * that would treat them as a real constraint (`dataSource` sending them to a server, for one).
+ * Returns the same model reference when every item is complete.
+ */
+export declare const removeIncompleteFilterItems: (model: GridFilterModel, columnsLookup: GridColumnLookup) => GridFilterModel;
 /**
  * Adds default values to the optional fields of a filter items.
  * @param {GridFilterItem} item The raw filter item.

package/hooks/features/filter/gridFilterUtils.d.ts

@@ -4,6 +4,7 @@ import type { GridColDef, GridFilterItem, GridFilterModel, GridRowModel } from "
 import type { GridPrivateApiCommunity } from "../../../models/api/gridApiCommunity.js";
 import type { GridStateCommunity } from "../../../models/gridStateCommunity.js";
 import type { GridAggregatedFilterItemApplier, GridFilterItemResult, GridQuickFilterValueResult } from "./gridFilterState.js";
+import type { GridColumnLookup } from "../columns/index.js";
 /**
  * Pure helpers computing a new filter model from an existing one.
  * Shared by the imperative `apiRef` methods (`useGridFilter`) and the controlled
@@ -15,6 +16,18 @@ export declare const upsertFilterItemInModel: (model: GridFilterModel, item: Gri
 export declare const upsertFilterItemsInModel: (model: GridFilterModel, itemsToUpsert: GridFilterItem[]) => GridFilterModel;
 export declare const deleteFilterItemFromModel: (model: GridFilterModel, itemToDelete: GridFilterItem) => GridFilterModel;
 export declare const setFilterLogicOperatorInModel: (model: GridFilterModel, logicOperator: GridLogicOperator) => GridFilterModel;
+/**
+ * Whether a filter item carries everything its operator needs to be applied.
+ * Operators declaring `requiresFilterValue: false` (`isEmpty`, `isNotEmpty`) stay complete
+ * without a value, see https://github.com/mui/mui-x/issues/5402
+ */
+export declare const isFilterItemComplete: (item: GridFilterItem, column: GridColDef | undefined) => boolean;
+/**
+ * Drops the filter items that cannot be applied, so incomplete items never reach a consumer
+ * that would treat them as a real constraint (`dataSource` sending them to a server, for one).
+ * Returns the same model reference when every item is complete.
+ */
+export declare const removeIncompleteFilterItems: (model: GridFilterModel, columnsLookup: GridColumnLookup) => GridFilterModel;
 /**
  * Adds default values to the optional fields of a filter items.
  * @param {GridFilterItem} item The raw filter item.

package/hooks/features/filter/gridFilterUtils.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.upsertFilterItemsInModel = exports.upsertFilterItemInModel = exports.shouldQuickFilterExcludeHiddenColumns = exports.setFilterLogicOperatorInModel = exports.sanitizeFilterModel = exports.removeDiacritics = exports.passFilterLogic = exports.mergeStateWithFilterModel = exports.deleteFilterItemFromModel = exports.cleanFilterItem = exports.buildAggregatedFilterApplier = void 0;
+exports.upsertFilterItemsInModel = exports.upsertFilterItemInModel = exports.shouldQuickFilterExcludeHiddenColumns = exports.setFilterLogicOperatorInModel = exports.sanitizeFilterModel = exports.removeIncompleteFilterItems = exports.removeDiacritics = exports.passFilterLogic = exports.mergeStateWithFilterModel = exports.isFilterItemComplete = exports.deleteFilterItemFromModel = exports.cleanFilterItem = exports.buildAggregatedFilterApplier = void 0;
 var _formatErrorMessage2 = _interopRequireDefault(require("@mui/x-internals/formatErrorMessage"));
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _warning = require("@mui/x-internals/warning");
@@ -66,7 +66,38 @@ const setFilterLogicOperatorInModel = (model, logicOperator) => {
     logicOperator
   });
 };
+
+/**
+ * Whether a filter item carries everything its operator needs to be applied.
+ * Operators declaring `requiresFilterValue: false` (`isEmpty`, `isNotEmpty`) stay complete
+ * without a value, see https://github.com/mui/mui-x/issues/5402
+ */
 exports.setFilterLogicOperatorInModel = setFilterLogicOperatorInModel;
+const isFilterItemComplete = (item, column) => {
+  if (item.value !== undefined) {
+    // Some operators like `isAnyOf` take an array as `item.value`. An empty one filters nothing.
+    return !(Array.isArray(item.value) && item.value.length === 0);
+  }
+  const filterOperator = column?.filterOperators?.find(operator => operator.value === item.operator);
+  return filterOperator?.requiresFilterValue === false;
+};
+
+/**
+ * Drops the filter items that cannot be applied, so incomplete items never reach a consumer
+ * that would treat them as a real constraint (`dataSource` sending them to a server, for one).
+ * Returns the same model reference when every item is complete.
+ */
+exports.isFilterItemComplete = isFilterItemComplete;
+const removeIncompleteFilterItems = (model, columnsLookup) => {
+  const items = model.items.filter(item => isFilterItemComplete(item, columnsLookup[item.field]));
+  if (items.length === model.items.length) {
+    return model;
+  }
+  return (0, _extends2.default)({}, model, {
+    items
+  });
+};
+exports.removeIncompleteFilterItems = removeIncompleteFilterItems;
 let hasEval;
 function getHasEval() {
   if (hasEval !== undefined) {

package/hooks/features/filter/gridFilterUtils.mjs

@@ -5,7 +5,6 @@ import { GridLogicOperator } from "../../../models/index.mjs";
 import { getDefaultGridFilterModel } from "./gridFilterState.mjs";
 import { getPublicApiRef } from "../../../utils/getPublicApiRef.mjs";
 import { gridColumnFieldsSelector, gridColumnLookupSelector, gridColumnVisibilityModelSelector } from "../columns/index.mjs";
-
 /**
  * Pure helpers computing a new filter model from an existing one.
  * Shared by the imperative `apiRef` methods (`useGridFilter`) and the controlled
@@ -57,6 +56,35 @@ export const setFilterLogicOperatorInModel = (model, logicOperator) => {
     logicOperator
   });
 };
+
+/**
+ * Whether a filter item carries everything its operator needs to be applied.
+ * Operators declaring `requiresFilterValue: false` (`isEmpty`, `isNotEmpty`) stay complete
+ * without a value, see https://github.com/mui/mui-x/issues/5402
+ */
+export const isFilterItemComplete = (item, column) => {
+  if (item.value !== undefined) {
+    // Some operators like `isAnyOf` take an array as `item.value`. An empty one filters nothing.
+    return !(Array.isArray(item.value) && item.value.length === 0);
+  }
+  const filterOperator = column?.filterOperators?.find(operator => operator.value === item.operator);
+  return filterOperator?.requiresFilterValue === false;
+};
+
+/**
+ * Drops the filter items that cannot be applied, so incomplete items never reach a consumer
+ * that would treat them as a real constraint (`dataSource` sending them to a server, for one).
+ * Returns the same model reference when every item is complete.
+ */
+export const removeIncompleteFilterItems = (model, columnsLookup) => {
+  const items = model.items.filter(item => isFilterItemComplete(item, columnsLookup[item.field]));
+  if (items.length === model.items.length) {
+    return model;
+  }
+  return _extends({}, model, {
+    items
+  });
+};
 let hasEval;
 function getHasEval() {
   if (hasEval !== undefined) {

package/hooks/features/filter/useGridFilter.js

@@ -103,27 +103,7 @@ const useGridFilter = (apiRef, props, configuration) => {
     logger.debug('Displaying filter panel');
     if (targetColumnField) {
       const filterModel = (0, _gridFilterSelector.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 => (0, _gridFilterUtils.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/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/rows/gridRowsUtils.js

@@ -261,7 +261,23 @@ const updateCacheWithNewRows = ({
       }
 
       // Update the data row lookups.
-      dataRowIdToModelLookup[id] = (0, _extends2.default)({}, oldRow, partialRow);
+      // 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;
       return;
     }
 

package/hooks/features/rows/gridRowsUtils.mjs

@@ -242,7 +242,23 @@ export const updateCacheWithNewRows = ({
       }
 
       // Update the data row lookups.
-      dataRowIdToModelLookup[id] = _extends({}, oldRow, partialRow);
+      // 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;
       return;
     }
 

package/hooks/features/rows/useGridRowSpanning.js

@@ -15,6 +15,7 @@ var _useGridVisibleRows = require("../../utils/useGridVisibleRows");
 var _gridVirtualizationSelectors = require("../virtualization/gridVirtualizationSelectors");
 var _gridRowSpanningUtils = require("./gridRowSpanningUtils");
 var _useGridEvent = require("../../utils/useGridEvent");
+var _useGridApiMethod = require("../../utils/useGridApiMethod");
 var _utils = require("../../../utils/utils");
 var _useRunOncePerLoop = require("../../utils/useRunOncePerLoop");
 const EMPTY_CACHES = {
@@ -200,6 +201,10 @@ const useGridRowSpanning = (apiRef, props) => {
   (0, _useGridEvent.useGridEvent)(apiRef, 'filteredRowsSet', (0, _utils.runIf)(props.rowSpanning, resetRowSpanningState));
   (0, _useGridEvent.useGridEvent)(apiRef, 'columnsChange', (0, _utils.runIf)(props.rowSpanning, resetRowSpanningState));
   (0, _useGridEvent.useGridEvent)(apiRef, 'rowExpansionChange', (0, _utils.runIf)(props.rowSpanning, resetRowSpanningState));
+  const rowSpanningPrivateApi = {
+    resetRowSpanningState: (0, _utils.runIf)(props.rowSpanning, resetRowSpanningState)
+  };
+  (0, _useGridApiMethod.useGridApiMethod)(apiRef, rowSpanningPrivateApi, 'private');
   React.useEffect(() => {
     const store = apiRef.current.virtualizer?.store;
     if (!store) {

package/hooks/features/rows/useGridRowSpanning.mjs

@@ -8,6 +8,7 @@ import { getVisibleRows } from "../../utils/useGridVisibleRows.mjs";
 import { gridRenderContextSelector } from "../virtualization/gridVirtualizationSelectors.mjs";
 import { getUnprocessedRange, isRowContextInitialized, getCellValue } from "./gridRowSpanningUtils.mjs";
 import { useGridEvent } from "../../utils/useGridEvent.mjs";
+import { useGridApiMethod } from "../../utils/useGridApiMethod.mjs";
 import { runIf } from "../../../utils/utils.mjs";
 import { useRunOncePerLoop } from "../../utils/useRunOncePerLoop.mjs";
 const EMPTY_CACHES = {
@@ -192,6 +193,10 @@ export const useGridRowSpanning = (apiRef, props) => {
   useGridEvent(apiRef, 'filteredRowsSet', runIf(props.rowSpanning, resetRowSpanningState));
   useGridEvent(apiRef, 'columnsChange', runIf(props.rowSpanning, resetRowSpanningState));
   useGridEvent(apiRef, 'rowExpansionChange', runIf(props.rowSpanning, resetRowSpanningState));
+  const rowSpanningPrivateApi = {
+    resetRowSpanningState: runIf(props.rowSpanning, resetRowSpanningState)
+  };
+  useGridApiMethod(apiRef, rowSpanningPrivateApi, 'private');
   React.useEffect(() => {
     const store = apiRef.current.virtualizer?.store;
     if (!store) {

package/hooks/features/virtualization/gridVirtualizationSelectors.d.mts

@@ -34,7 +34,7 @@ export declare const gridVirtualizationRowEnabledSelector: (args_0: import("reac
  */
 export declare const gridVirtualizationLayoutModeSelector: (args_0: import("react").RefObject<{
   state: GridStateCommunity;
-} | null>) => "controlled" | "uncontrolled";
+} | null>) => "controlled" | "sticky" | "uncontrolled";
 /**
  * Get the render context
  * @category Virtualization

package/hooks/features/virtualization/gridVirtualizationSelectors.d.ts

@@ -34,7 +34,7 @@ export declare const gridVirtualizationRowEnabledSelector: (args_0: import("reac
  */
 export declare const gridVirtualizationLayoutModeSelector: (args_0: import("react").RefObject<{
   state: GridStateCommunity;
-} | null>) => "controlled" | "uncontrolled";
+} | null>) => "controlled" | "sticky" | "uncontrolled";
 /**
  * Get the render context
  * @category Virtualization

package/hooks/utils/useGridEvent.d.mts

@@ -4,8 +4,8 @@ import type { GridEventListener, GridEvents } from "../../models/events/index.mj
 import { TimerBasedCleanupTracking } from "../../utils/cleanupTracking/TimerBasedCleanupTracking.mjs";
 import { FinalizationRegistryBasedCleanupTracking } from "../../utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.mjs";
 import type { GridApiCommon } from "../../models/index.mjs";
-export declare function useGridEvent<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E>, options?: EventListenerOptions): void;
-export declare function useGridEventPriority<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E>): void;
+export declare function useGridEvent<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E, Api>, options?: EventListenerOptions): void;
+export declare function useGridEventPriority<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E, Api>): void;
 export declare function unstable_resetCleanupTracking(): void;
 export declare const internal_registryContainer: {
   current: FinalizationRegistryBasedCleanupTracking | TimerBasedCleanupTracking;

package/hooks/utils/useGridEvent.d.ts

@@ -4,8 +4,8 @@ import type { GridEventListener, GridEvents } from "../../models/events/index.js
 import { TimerBasedCleanupTracking } from "../../utils/cleanupTracking/TimerBasedCleanupTracking.js";
 import { FinalizationRegistryBasedCleanupTracking } from "../../utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.js";
 import type { GridApiCommon } from "../../models/index.js";
-export declare function useGridEvent<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E>, options?: EventListenerOptions): void;
-export declare function useGridEventPriority<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E>): void;
+export declare function useGridEvent<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E, Api>, options?: EventListenerOptions): void;
+export declare function useGridEventPriority<Api extends GridApiCommon, E extends GridEvents>(apiRef: RefObject<Api>, eventName: E, handler?: GridEventListener<E, Api>): void;
 export declare function unstable_resetCleanupTracking(): void;
 export declare const internal_registryContainer: {
   current: FinalizationRegistryBasedCleanupTracking | TimerBasedCleanupTracking;

package/hooks/utils/useGridEvent.js

@@ -32,6 +32,8 @@ function useGridEvent(apiRef, eventName, handler, options) {
   handlerRef.current = handler;
   const cleanupTokenRef = React.useRef(null);
   if (!subscription.current && handlerRef.current) {
+    // The event system is typed against `GridApiCommon`, while the handler can be typed
+    // against the package-specific API: `any` bridges the two at this single boundary.
     const enhancedHandler = (params, event, details) => {
       // Check for the existence of the event once more to avoid Safari 26 issue
       // https://github.com/mui/mui-x/issues/20159

package/hooks/utils/useGridEvent.mjs

@@ -23,6 +23,8 @@ export function useGridEvent(apiRef, eventName, handler, options) {
   handlerRef.current = handler;
   const cleanupTokenRef = React.useRef(null);
   if (!subscription.current && handlerRef.current) {
+    // The event system is typed against `GridApiCommon`, while the handler can be typed
+    // against the package-specific API: `any` bridges the two at this single boundary.
     const enhancedHandler = (params, event, details) => {
       // Check for the existence of the event once more to avoid Safari 26 issue
       // https://github.com/mui/mui-x/issues/20159

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid v9.10.1
+ * @mui/x-data-grid v9.12.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @mui/x-data-grid v9.10.1
+ * @mui/x-data-grid v9.12.0
  *
  * @license MIT
  * This source code is licensed under the MIT license found in the

package/internals/index.d.mts

@@ -101,8 +101,10 @@ export { DataSourceRowsUpdateStrategy } from "../hooks/features/dataSource/utils
 export { useGridDataSourceBase } from "../hooks/features/dataSource/useGridDataSourceBase.mjs";
 export { CacheChunkManager } from "../hooks/features/dataSource/utils.mjs";
 export { gridGetRowsParamsSelector } from "../hooks/features/dataSource/gridDataSourceSelector.mjs";
+export { useGridDataSourceFilterModelChange } from "../hooks/features/dataSource/useGridDataSourceFilterModelChange.mjs";
 export { getColumnsToExport, defaultGetRowsToExport } from "../hooks/features/export/utils.mjs";
 export * from "../utils/createControllablePromise.mjs";
+export * from "../utils/focusElement.mjs";
 export * from "../utils/rtlFlipSide.mjs";
 export { NotRendered } from "../utils/assert.mjs";
 export { createSelector, createRootSelector, createSelectorMemoized } from "../utils/createSelector.mjs";

package/internals/index.d.ts

@@ -101,8 +101,10 @@ export { DataSourceRowsUpdateStrategy } from "../hooks/features/dataSource/utils
 export { useGridDataSourceBase } from "../hooks/features/dataSource/useGridDataSourceBase.js";
 export { CacheChunkManager } from "../hooks/features/dataSource/utils.js";
 export { gridGetRowsParamsSelector } from "../hooks/features/dataSource/gridDataSourceSelector.js";
+export { useGridDataSourceFilterModelChange } from "../hooks/features/dataSource/useGridDataSourceFilterModelChange.js";
 export { getColumnsToExport, defaultGetRowsToExport } from "../hooks/features/export/utils.js";
 export * from "../utils/createControllablePromise.js";
+export * from "../utils/focusElement.js";
 export * from "../utils/rtlFlipSide.js";
 export { NotRendered } from "../utils/assert.js";
 export { createSelector, createRootSelector, createSelectorMemoized } from "../utils/createSelector.js";

package/internals/index.js

@@ -117,6 +117,7 @@ var _exportNames = {
   CacheChunkManager: true,
   useGridDataSourceBase: true,
   gridGetRowsParamsSelector: true,
+  useGridDataSourceFilterModelChange: true,
   getColumnsToExport: true,
   defaultGetRowsToExport: true,
   NotRendered: true,
@@ -736,6 +737,12 @@ Object.defineProperty(exports, "useGridDataSourceBase", {
     return _useGridDataSourceBase.useGridDataSourceBase;
   }
 });
+Object.defineProperty(exports, "useGridDataSourceFilterModelChange", {
+  enumerable: true,
+  get: function () {
+    return _useGridDataSourceFilterModelChange.useGridDataSourceFilterModelChange;
+  }
+});
 Object.defineProperty(exports, "useGridDensity", {
   enumerable: true,
   get: function () {
@@ -1108,6 +1115,7 @@ var _usePinnedScrollOffset = require("../hooks/utils/usePinnedScrollOffset");
 var _utils2 = require("../hooks/features/dataSource/utils");
 var _useGridDataSourceBase = require("../hooks/features/dataSource/useGridDataSourceBase");
 var _gridDataSourceSelector = require("../hooks/features/dataSource/gridDataSourceSelector");
+var _useGridDataSourceFilterModelChange = require("../hooks/features/dataSource/useGridDataSourceFilterModelChange");
 var _utils3 = require("../hooks/features/export/utils");
 var _createControllablePromise = require("../utils/createControllablePromise");
 Object.keys(_createControllablePromise).forEach(function (key) {
@@ -1121,6 +1129,18 @@ Object.keys(_createControllablePromise).forEach(function (key) {
     }
   });
 });
+var _focusElement = require("../utils/focusElement");
+Object.keys(_focusElement).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _focusElement[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _focusElement[key];
+    }
+  });
+});
 var _rtlFlipSide = require("../utils/rtlFlipSide");
 Object.keys(_rtlFlipSide).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/internals/index.mjs

@@ -79,8 +79,10 @@ export { DataSourceRowsUpdateStrategy } from "../hooks/features/dataSource/utils
 export { useGridDataSourceBase } from "../hooks/features/dataSource/useGridDataSourceBase.mjs";
 export { CacheChunkManager } from "../hooks/features/dataSource/utils.mjs";
 export { gridGetRowsParamsSelector } from "../hooks/features/dataSource/gridDataSourceSelector.mjs";
+export { useGridDataSourceFilterModelChange } from "../hooks/features/dataSource/useGridDataSourceFilterModelChange.mjs";
 export { getColumnsToExport, defaultGetRowsToExport } from "../hooks/features/export/utils.mjs";
 export * from "../utils/createControllablePromise.mjs";
+export * from "../utils/focusElement.mjs";
 export * from "../utils/rtlFlipSide.mjs";
 export { NotRendered } from "../utils/assert.mjs";
 export { createSelector, createRootSelector, createSelectorMemoized } from "../utils/createSelector.mjs";

package/locales/arSD.js

@@ -51,6 +51,11 @@ const arSDGrid = {
   // Toolbar AI Assistant button
   // toolbarAssistant: 'AI Assistant',
 
+  // Formula bar (Premium formulas)
+  // formulaBarLabel: 'Formula bar',
+  // formulaBarInputLabel: 'Formula',
+  // formulaBarAddressLabel: 'Active cell',
+
   // Columns management text
   columnsManagementSearchTitle: 'بحث',
   columnsManagementNoColumns: 'لا يوجد أعمدة',

package/locales/arSD.mjs

@@ -45,6 +45,11 @@ const arSDGrid = {
   // Toolbar AI Assistant button
   // toolbarAssistant: 'AI Assistant',
 
+  // Formula bar (Premium formulas)
+  // formulaBarLabel: 'Formula bar',
+  // formulaBarInputLabel: 'Formula',
+  // formulaBarAddressLabel: 'Active cell',
+
   // Columns management text
   columnsManagementSearchTitle: 'بحث',
   columnsManagementNoColumns: 'لا يوجد أعمدة',

package/locales/beBY.js

@@ -64,6 +64,11 @@ const beBYGrid = {
   // Toolbar AI Assistant button
   // toolbarAssistant: 'AI Assistant',
 
+  // Formula bar (Premium formulas)
+  // formulaBarLabel: 'Formula bar',
+  // formulaBarInputLabel: 'Formula',
+  // formulaBarAddressLabel: 'Active cell',
+
   // Columns management text
   // columnsManagementSearchTitle: 'Search',
   // columnsManagementNoColumns: 'No columns',

package/locales/beBY.mjs

@@ -58,6 +58,11 @@ const beBYGrid = {
   // Toolbar AI Assistant button
   // toolbarAssistant: 'AI Assistant',
 
+  // Formula bar (Premium formulas)
+  // formulaBarLabel: 'Formula bar',
+  // formulaBarInputLabel: 'Formula',
+  // formulaBarAddressLabel: 'Active cell',
+
   // Columns management text
   // columnsManagementSearchTitle: 'Search',
   // columnsManagementNoColumns: 'No columns',

package/locales/bgBG.js

@@ -50,6 +50,11 @@ const bgBGGrid = {
   // Toolbar AI Assistant button
   // toolbarAssistant: 'AI Assistant',
 
+  // Formula bar (Premium formulas)
+  // formulaBarLabel: 'Formula bar',
+  // formulaBarInputLabel: 'Formula',
+  // formulaBarAddressLabel: 'Active cell',
+
   // Columns management text
   columnsManagementSearchTitle: 'Търсене',
   columnsManagementNoColumns: 'Няма колони',