@mui/x-data-grid 5.5.1 → 5.7.0

package/hooks/core/preProcessing/useGridPreProcessing.js

@@ -0,0 +1,53 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _toPropertyKey from "@babel/runtime/helpers/esm/toPropertyKey";
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { useGridApiMethod } from '../../utils/useGridApiMethod';
+import { GridEvents } from '../../../models/events';
+/**
+ * TODO: Rename `useGridPipProcessing`
+ */
+
+export const useGridPreProcessing = apiRef => {
+  const preProcessorsRef = React.useRef({});
+  const registerPreProcessor = React.useCallback((group, id, callback) => {
+    if (!preProcessorsRef.current[group]) {
+      preProcessorsRef.current[group] = {};
+    }
+
+    const preProcessors = preProcessorsRef.current[group];
+    const oldCallback = preProcessors[id];
+
+    if (oldCallback !== callback) {
+      preProcessorsRef.current[group] = _extends({}, preProcessors, {
+        [id]: callback
+      });
+      apiRef.current.publishEvent(GridEvents.preProcessorRegister, group);
+    }
+
+    return () => {
+      const _ref = preProcessorsRef.current[group],
+            otherProcessors = _objectWithoutPropertiesLoose(_ref, [id].map(_toPropertyKey));
+
+      preProcessorsRef.current[group] = otherProcessors;
+      apiRef.current.publishEvent(GridEvents.preProcessorUnregister, group);
+    };
+  }, [apiRef]);
+  const applyPreProcessors = React.useCallback((...args) => {
+    const [group, value, params] = args;
+
+    if (!preProcessorsRef.current[group]) {
+      return value;
+    }
+
+    const preProcessors = Object.values(preProcessorsRef.current[group]);
+    return preProcessors.reduce((acc, preProcessor) => {
+      return preProcessor(acc, params);
+    }, value);
+  }, []);
+  const preProcessingApi = {
+    unstable_registerPreProcessor: registerPreProcessor,
+    unstable_applyPreProcessors: applyPreProcessors
+  };
+  useGridApiMethod(apiRef, preProcessingApi, 'GridPreProcessing');
+};

package/hooks/core/preProcessing/useGridRegisterPreProcessor.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { GridApiCommon } from '../../../models/api/gridApiCommon';
+import { GridPreProcessor } from './gridPreProcessingApi';
+/**
+ * TODO: Rename `useGridRegisterPipeProcessor`
+ */
+export declare const useGridRegisterPreProcessor: <Api extends GridApiCommon, G extends keyof import("./gridPreProcessingApi").GridPreProcessingGroupLookup>(apiRef: React.MutableRefObject<Api>, group: G, callback: GridPreProcessor<G>) => void;

package/hooks/core/preProcessing/useGridRegisterPreProcessor.js

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import { useFirstRender } from '../../utils/useFirstRender';
+
+/**
+ * TODO: Rename `useGridRegisterPipeProcessor`
+ */
+export const useGridRegisterPreProcessor = (apiRef, group, callback) => {
+  const cleanup = React.useRef();
+  const id = React.useRef(`mui-${Math.round(Math.random() * 1e9)}`);
+  const registerPreProcessor = React.useCallback(() => {
+    cleanup.current = apiRef.current.unstable_registerPreProcessor(group, id.current, callback);
+  }, [apiRef, callback, group]);
+  useFirstRender(() => {
+    registerPreProcessor();
+  });
+  const isFirstRender = React.useRef(true);
+  React.useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+    } else {
+      registerPreProcessor();
+    }
+
+    return () => {
+      if (cleanup.current) {
+        cleanup.current();
+        cleanup.current = null;
+      }
+    };
+  }, [registerPreProcessor]);
+};

package/hooks/core/strategyProcessing/gridStrategyProcessingApi.d.ts

@@ -0,0 +1,58 @@
+import { GridRowTreeCreationParams, GridRowTreeCreationValue } from '../../features/rows/gridRowsState';
+import { GridFilteringMethodParams, GridFilteringMethodValue } from '../../features/filter/gridFilterState';
+import { GridSortingMethodParams, GridSortingMethodValue } from '../../features/sorting/gridSortingState';
+export declare type GridStrategyProcessorName = keyof GridStrategyProcessingLookup;
+export declare type GridStrategyGroup = GridStrategyProcessingLookup[keyof GridStrategyProcessingLookup]['group'];
+export interface GridStrategyProcessingLookup {
+    rowTreeCreation: {
+        group: 'rowTree';
+        params: GridRowTreeCreationParams;
+        value: GridRowTreeCreationValue;
+    };
+    filtering: {
+        group: 'rowTree';
+        params: GridFilteringMethodParams;
+        value: GridFilteringMethodValue;
+    };
+    sorting: {
+        group: 'rowTree';
+        params: GridSortingMethodParams;
+        value: GridSortingMethodValue;
+    };
+}
+export declare type GridStrategyProcessor<P extends GridStrategyProcessorName> = (params: GridStrategyProcessingLookup[P]['params']) => GridStrategyProcessingLookup[P]['value'];
+export interface GridStrategyProcessingApi {
+    /**
+     * Registers a strategy processor.
+     * If the strategy is active, it emits an event to notify the agents to re-apply the processor.
+     * @template P
+     * @param {string} strategyName The name of the strategy on which this processor should be applied.
+     * @param {GridStrategyProcessorName} processorName The name of the processor.
+     * @param {GridStrategyProcessor<P>} processor The processor to register.
+     * @returns {() => void} A function to unregister the processor.
+     * @ignore - do not document.
+     */
+    unstable_registerStrategyProcessor: <P extends GridStrategyProcessorName>(strategyName: string, processorName: P, callback: GridStrategyProcessor<P>) => () => void;
+    /**
+     * Set a callback to know if a strategy is available.
+     * @param {string} strategyName The name of the strategy.
+     * @param {boolean} callback A callback to know if this strategy is available.
+     * @ignore - do not document.
+     */
+    unstable_setStrategyAvailability: (strategyGroup: GridStrategyGroup, strategyName: string, callback: () => boolean) => void;
+    /**
+     * Returns the name of the active strategy of a given strategy group
+     * @param {GridStrategyGroup} strategyGroup The group from which we want the active strategy.
+     * @returns {string} The name of the active strategy.
+     * @ignore - do not document.
+     */
+    unstable_getActiveStrategy: (strategyGroup: GridStrategyGroup) => string;
+    /**
+     * Run the processor registered for the active strategy.
+     * @param {GridStrategyProcessorName} processorName The name of the processor to run.
+     * @param {GridStrategyProcessingLookup[P]['params']} params Additional params to pass to the processor.
+     * @returns {GridStrategyProcessingLookup[P]['value']} The value returned by the processor.
+     * @ignore - do not document.
+     */
+    unstable_applyStrategyProcessor: <P extends GridStrategyProcessorName>(processorName: P, params: GridStrategyProcessingLookup[P]['params']) => GridStrategyProcessingLookup[P]['value'];
+}

package/hooks/core/strategyProcessing/gridStrategyProcessingApi.js

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

package/hooks/core/strategyProcessing/index.d.ts

@@ -0,0 +1,3 @@
+export * from './gridStrategyProcessingApi';
+export * from './useGridRegisterStrategyProcessor';
+export * from './useGridStrategyProcessing';

package/hooks/core/strategyProcessing/index.js

@@ -0,0 +1,3 @@
+export * from './gridStrategyProcessingApi';
+export * from './useGridRegisterStrategyProcessor';
+export * from './useGridStrategyProcessing';

package/hooks/core/strategyProcessing/useGridRegisterStrategyProcessor.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { GridApiCommon } from '../../../models/api/gridApiCommon';
+import { GridStrategyProcessor } from './gridStrategyProcessingApi';
+export declare const useGridRegisterStrategyProcessor: <Api extends GridApiCommon, G extends keyof import("./gridStrategyProcessingApi").GridStrategyProcessingLookup>(apiRef: React.MutableRefObject<Api>, strategyName: string, group: G, processor: GridStrategyProcessor<G>) => void;

package/hooks/core/strategyProcessing/useGridRegisterStrategyProcessor.js

@@ -0,0 +1,18 @@
+import * as React from 'react';
+import { useFirstRender } from '../../utils/useFirstRender';
+export const useGridRegisterStrategyProcessor = (apiRef, strategyName, group, processor) => {
+  const registerPreProcessor = React.useCallback(() => {
+    apiRef.current.unstable_registerStrategyProcessor(strategyName, group, processor);
+  }, [apiRef, processor, group, strategyName]);
+  useFirstRender(() => {
+    registerPreProcessor();
+  });
+  const isFirstRender = React.useRef(true);
+  React.useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+    } else {
+      registerPreProcessor();
+    }
+  }, [registerPreProcessor]);
+};

package/hooks/core/strategyProcessing/useGridStrategyProcessing.d.ts

@@ -0,0 +1,37 @@
+import * as React from 'react';
+import { GridApiCommunity } from '../../../models/api/gridApiCommunity';
+import { GridStrategyProcessorName, GridStrategyProcessingLookup } from './gridStrategyProcessingApi';
+export declare const GRID_DEFAULT_STRATEGY = "none";
+export declare const GRID_STRATEGIES_PROCESSORS: {
+    [P in GridStrategyProcessorName]: GridStrategyProcessingLookup[P]['group'];
+};
+/**
+ * Implements a variant of the Strategy Pattern (see https://en.wikipedia.org/wiki/Strategy_pattern)
+ *
+ * Some plugins contain custom logic that must only be run if the right strategy is active.
+ * For instance, the tree data plugin has:
+ * - custom row tree creation algorithm.
+ * - custom sorting algorithm.
+ * - custom filtering algorithm.
+ *
+ * These plugins must use:
+ * - `apiRef.current.unstable_registerStrategyProcessor` to register their processors.
+ * - `apiRef.current.unstable_setStrategyAvailability` to tell if their strategy can be used.
+ *
+ * Some hooks need to run the custom logic of the active strategy.
+ * For instance, the `useGridFiltering` wants to run:
+ * - the tree data filtering if the tree data is the current way of grouping rows.
+ * - the row grouping filtering if the row grouping is the current way of grouping rows.
+ * - the flat filtering if there is no grouping of the rows (equivalent to the "none" strategy).
+ *
+ * These hooks must use:
+ * - `apiRef.current.unstable_applyStrategyProcessor` to run a processor.
+ * - `GridEvents.strategyAvailabilityChange` to update something when the active strategy changes.
+ *    Warning: Be careful not to apply the processor several times.
+ *    For instance `GridEvents.rowsSet` is fired by `useGridRows` whenever the active strategy changes.
+ *    So listening to both would most likely run your logic twice.
+ * - `GridEvents.activeStrategyProcessorChange` to update something when the processor of the active strategy changes
+ *
+ * Each processor name is part of a strategy group which can only have one active strategy at the time.
+ */
+export declare const useGridStrategyProcessing: (apiRef: React.MutableRefObject<GridApiCommunity>) => void;

package/hooks/core/strategyProcessing/useGridStrategyProcessing.js

@@ -0,0 +1,114 @@
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+import _toPropertyKey from "@babel/runtime/helpers/esm/toPropertyKey";
+import * as React from 'react';
+import { useGridApiMethod } from '../../utils/useGridApiMethod';
+import { GridEvents } from '../../../models/events';
+export const GRID_DEFAULT_STRATEGY = 'none';
+export const GRID_STRATEGIES_PROCESSORS = {
+  rowTreeCreation: 'rowTree',
+  filtering: 'rowTree',
+  sorting: 'rowTree'
+};
+
+/**
+ * Implements a variant of the Strategy Pattern (see https://en.wikipedia.org/wiki/Strategy_pattern)
+ *
+ * Some plugins contain custom logic that must only be run if the right strategy is active.
+ * For instance, the tree data plugin has:
+ * - custom row tree creation algorithm.
+ * - custom sorting algorithm.
+ * - custom filtering algorithm.
+ *
+ * These plugins must use:
+ * - `apiRef.current.unstable_registerStrategyProcessor` to register their processors.
+ * - `apiRef.current.unstable_setStrategyAvailability` to tell if their strategy can be used.
+ *
+ * Some hooks need to run the custom logic of the active strategy.
+ * For instance, the `useGridFiltering` wants to run:
+ * - the tree data filtering if the tree data is the current way of grouping rows.
+ * - the row grouping filtering if the row grouping is the current way of grouping rows.
+ * - the flat filtering if there is no grouping of the rows (equivalent to the "none" strategy).
+ *
+ * These hooks must use:
+ * - `apiRef.current.unstable_applyStrategyProcessor` to run a processor.
+ * - `GridEvents.strategyAvailabilityChange` to update something when the active strategy changes.
+ *    Warning: Be careful not to apply the processor several times.
+ *    For instance `GridEvents.rowsSet` is fired by `useGridRows` whenever the active strategy changes.
+ *    So listening to both would most likely run your logic twice.
+ * - `GridEvents.activeStrategyProcessorChange` to update something when the processor of the active strategy changes
+ *
+ * Each processor name is part of a strategy group which can only have one active strategy at the time.
+ */
+export const useGridStrategyProcessing = apiRef => {
+  const availableStrategies = React.useRef(new Map());
+  const strategiesCache = React.useRef({});
+  const registerStrategyProcessor = React.useCallback((strategyName, processorName, processor) => {
+    const cleanup = () => {
+      const _ref = strategiesCache.current[processorName],
+            otherProcessors = _objectWithoutPropertiesLoose(_ref, [strategyName].map(_toPropertyKey));
+
+      strategiesCache.current[processorName] = otherProcessors;
+    };
+
+    if (!strategiesCache.current[processorName]) {
+      strategiesCache.current[processorName] = {};
+    }
+
+    const groupPreProcessors = strategiesCache.current[processorName];
+    const previousProcessor = groupPreProcessors[strategyName];
+    groupPreProcessors[strategyName] = processor;
+
+    if (!previousProcessor || previousProcessor === processor) {
+      return cleanup;
+    }
+
+    if (strategyName === apiRef.current.unstable_getActiveStrategy(GRID_STRATEGIES_PROCESSORS[processorName])) {
+      apiRef.current.publishEvent(GridEvents.activeStrategyProcessorChange, processorName);
+    }
+
+    return cleanup;
+  }, [apiRef]);
+  const applyStrategyProcessor = React.useCallback((processorName, params) => {
+    const activeStrategy = apiRef.current.unstable_getActiveStrategy(GRID_STRATEGIES_PROCESSORS[processorName]);
+
+    if (activeStrategy == null) {
+      throw new Error("Can't apply a strategy processor before defining an active strategy");
+    }
+
+    const groupCache = strategiesCache.current[processorName];
+
+    if (!groupCache || !groupCache[activeStrategy]) {
+      throw new Error(`No processor found for processor "${processorName}" on strategy "${activeStrategy}"`);
+    }
+
+    const processor = groupCache[activeStrategy];
+    return processor(params);
+  }, [apiRef]);
+  const getActiveStrategy = React.useCallback(strategyGroup => {
+    var _availableStrategyEnt;
+
+    const strategyEntries = Array.from(availableStrategies.current.entries());
+    const availableStrategyEntry = strategyEntries.find(([, strategy]) => {
+      if (strategy.group !== strategyGroup) {
+        return false;
+      }
+
+      return strategy.isAvailable();
+    });
+    return (_availableStrategyEnt = availableStrategyEntry == null ? void 0 : availableStrategyEntry[0]) != null ? _availableStrategyEnt : GRID_DEFAULT_STRATEGY;
+  }, []);
+  const setStrategyAvailability = React.useCallback((strategyGroup, strategyName, isAvailable) => {
+    availableStrategies.current.set(strategyName, {
+      group: strategyGroup,
+      isAvailable
+    });
+    apiRef.current.publishEvent(GridEvents.strategyAvailabilityChange);
+  }, [apiRef]);
+  const strategyProcessingApi = {
+    unstable_registerStrategyProcessor: registerStrategyProcessor,
+    unstable_applyStrategyProcessor: applyStrategyProcessor,
+    unstable_getActiveStrategy: getActiveStrategy,
+    unstable_setStrategyAvailability: setStrategyAvailability
+  };
+  useGridApiMethod(apiRef, strategyProcessingApi, 'GridStrategyProcessing');
+};

package/hooks/core/useGridApiInitialization.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+import { GridApiCommon } from '../../models';
+export declare function useGridApiInitialization<Api extends GridApiCommon>(inputApiRef: React.MutableRefObject<Api> | undefined, props: Pick<DataGridProcessedProps, 'signature'>): React.MutableRefObject<Api>;

package/hooks/core/useGridApiInitialization.js

@@ -0,0 +1,60 @@
+import * as React from 'react';
+import { GridEvents } from '../../models/events';
+import { useGridApiMethod } from '../utils/useGridApiMethod';
+import { GridSignature } from '../utils/useGridApiEventHandler';
+import { EventManager } from '../../utils/EventManager';
+
+const isSyntheticEvent = event => {
+  return event.isPropagationStopped !== undefined;
+};
+
+let globalId = 0;
+export function useGridApiInitialization(inputApiRef, props) {
+  const apiRef = React.useRef();
+
+  if (!apiRef.current) {
+    apiRef.current = {
+      unstable_eventManager: new EventManager(),
+      state: {},
+      instanceId: globalId
+    };
+    globalId += 1;
+  }
+
+  React.useImperativeHandle(inputApiRef, () => apiRef.current, [apiRef]);
+  const publishEvent = React.useCallback((...args) => {
+    const [name, params, event = {}] = args;
+    event.defaultMuiPrevented = false;
+
+    if (isSyntheticEvent(event) && event.isPropagationStopped()) {
+      return;
+    }
+
+    const details = props.signature === GridSignature.DataGridPro ? {
+      api: apiRef.current
+    } : {};
+    apiRef.current.unstable_eventManager.emit(name, params, event, details);
+  }, [apiRef, props.signature]);
+  const subscribeEvent = React.useCallback((event, handler, options) => {
+    apiRef.current.unstable_eventManager.on(event, handler, options);
+    const api = apiRef.current;
+    return () => {
+      api.unstable_eventManager.removeListener(event, handler);
+    };
+  }, [apiRef]);
+  const showError = React.useCallback(args => {
+    apiRef.current.publishEvent(GridEvents.componentError, args);
+  }, [apiRef]);
+  useGridApiMethod(apiRef, {
+    subscribeEvent,
+    publishEvent,
+    showError
+  }, 'GridCoreApi');
+  React.useEffect(() => {
+    const api = apiRef.current;
+    return () => {
+      api.publishEvent(GridEvents.unmount);
+    };
+  }, [apiRef]);
+  return apiRef;
+}

package/hooks/core/useGridErrorHandler.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { GridApiCommunity } from '../../models/api/gridApiCommunity';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+export declare function useGridErrorHandler(apiRef: React.MutableRefObject<GridApiCommunity>, props: Pick<DataGridProcessedProps, 'error'>): void;

package/hooks/core/useGridErrorHandler.js

@@ -0,0 +1,16 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+import { GridEvents } from '../../models/events';
+import { useGridApiEventHandler } from '../utils/useGridApiEventHandler';
+export function useGridErrorHandler(apiRef, props) {
+  const handleError = React.useCallback(args => {
+    // We are handling error here, to set up the handler as early as possible and be able to catch error thrown at init time.
+    apiRef.current.setState(state => _extends({}, state, {
+      error: args
+    }));
+  }, [apiRef]);
+  React.useEffect(() => {
+    handleError(props.error);
+  }, [handleError, props.error]);
+  useGridApiEventHandler(apiRef, GridEvents.componentError, handleError);
+}

package/hooks/core/useGridInitialization.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import type { GridApiCommon } from '../../models/api/gridApiCommon';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+/**
+ * Initialize the technical pieces of the DataGrid (logger, state, ...) that any DataGrid implementation needs
+ */
+export declare const useGridInitialization: <Api extends GridApiCommon>(inputApiRef: React.MutableRefObject<Api> | undefined, props: Pick<DataGridProcessedProps, 'signature' | 'logger' | 'logLevel' | 'error' | 'localeText'>) => React.MutableRefObject<Api>;

package/hooks/core/useGridInitialization.js

@@ -0,0 +1,21 @@
+import { useGridLoggerFactory } from './useGridLoggerFactory';
+import { useGridApiInitialization } from './useGridApiInitialization';
+import { useGridErrorHandler } from './useGridErrorHandler';
+import { useGridLocaleText } from './useGridLocaleText';
+import { useGridPreProcessing } from './preProcessing';
+import { useGridStrategyProcessing } from './strategyProcessing';
+import { useGridStateInitialization } from './useGridStateInitialization';
+/**
+ * Initialize the technical pieces of the DataGrid (logger, state, ...) that any DataGrid implementation needs
+ */
+
+export const useGridInitialization = (inputApiRef, props) => {
+  const apiRef = useGridApiInitialization(inputApiRef, props);
+  useGridLoggerFactory(apiRef, props);
+  useGridErrorHandler(apiRef, props);
+  useGridStateInitialization(apiRef, props);
+  useGridPreProcessing(apiRef);
+  useGridStrategyProcessing(apiRef);
+  useGridLocaleText(apiRef, props);
+  return apiRef;
+};

package/hooks/core/useGridLocaleText.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { GridApiCommunity } from '../../models/api/gridApiCommunity';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+export declare const useGridLocaleText: (apiRef: React.MutableRefObject<GridApiCommunity>, props: Pick<DataGridProcessedProps, 'localeText'>) => void;

package/hooks/core/useGridLocaleText.js

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { useGridApiMethod } from '../utils/useGridApiMethod';
+export const useGridLocaleText = (apiRef, props) => {
+  const getLocaleText = React.useCallback(key => {
+    if (props.localeText[key] == null) {
+      throw new Error(`Missing translation for key ${key}.`);
+    }
+
+    return props.localeText[key];
+  }, [props.localeText]);
+  const localeTextApi = {
+    getLocaleText
+  };
+  useGridApiMethod(apiRef, localeTextApi, 'LocaleTextApi');
+};

package/hooks/core/useGridLoggerFactory.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { GridApiCommunity } from '../../models/api/gridApiCommunity';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+export declare const useGridLoggerFactory: (apiRef: React.MutableRefObject<GridApiCommunity>, props: Pick<DataGridProcessedProps, 'logger' | 'logLevel'>) => void;

package/hooks/core/useGridLoggerFactory.js

@@ -0,0 +1,49 @@
+import * as React from 'react';
+import { localStorageAvailable } from '../../utils/utils';
+const forceDebug = localStorageAvailable() && window.localStorage.getItem('DEBUG') != null;
+
+const noop = () => {};
+
+const noopLogger = {
+  debug: noop,
+  info: noop,
+  warn: noop,
+  error: noop
+};
+const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+
+function getAppender(name, logLevel, appender = console) {
+  const minLogLevelIdx = LOG_LEVELS.indexOf(logLevel);
+
+  if (minLogLevelIdx === -1) {
+    throw new Error(`MUI: Log level ${logLevel} not recognized.`);
+  }
+
+  const logger = LOG_LEVELS.reduce((loggerObj, method, idx) => {
+    if (idx >= minLogLevelIdx) {
+      loggerObj[method] = (...args) => {
+        const [message, ...other] = args;
+        appender[method](`MUI: ${name} - ${message}`, ...other);
+      };
+    } else {
+      loggerObj[method] = noop;
+    }
+
+    return loggerObj;
+  }, {});
+  return logger;
+}
+
+export const useGridLoggerFactory = (apiRef, props) => {
+  apiRef.current.getLogger = React.useCallback(name => {
+    if (forceDebug) {
+      return getAppender(name, 'debug', props.logger);
+    }
+
+    if (!props.logLevel) {
+      return noopLogger;
+    }
+
+    return getAppender(name, props.logLevel.toString(), props.logger);
+  }, [props.logLevel, props.logger]);
+};

package/hooks/core/useGridStateInitialization.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+import { DataGridProcessedProps } from '../../models/props/DataGridProps';
+import { GridApiCommon } from '../../models/api/gridApiCommon';
+export declare const useGridStateInitialization: <Api extends GridApiCommon>(apiRef: React.MutableRefObject<Api>, props: Pick<DataGridProcessedProps, 'signature'>) => void;

package/hooks/core/useGridStateInitialization.js

@@ -0,0 +1,102 @@
+import _extends from "@babel/runtime/helpers/esm/extends";
+import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
+const _excluded = ["stateId"];
+import * as React from 'react';
+import { GridSignature } from '../utils/useGridApiEventHandler';
+import { GridEvents } from '../../models/events';
+import { useGridApiMethod } from '../utils';
+import { isFunction } from '../../utils/utils';
+export const useGridStateInitialization = (apiRef, props) => {
+  const controlStateMapRef = React.useRef({});
+  const [, rawForceUpdate] = React.useState();
+  const updateControlState = React.useCallback(controlStateItem => {
+    const {
+      stateId
+    } = controlStateItem,
+          others = _objectWithoutPropertiesLoose(controlStateItem, _excluded);
+
+    controlStateMapRef.current[stateId] = _extends({}, others, {
+      stateId
+    });
+  }, []);
+  const setState = React.useCallback(state => {
+    let newState;
+
+    if (isFunction(state)) {
+      newState = state(apiRef.current.state);
+    } else {
+      newState = state;
+    }
+
+    if (apiRef.current.state === newState) {
+      return false;
+    }
+
+    let ignoreSetState = false; // Apply the control state constraints
+
+    const updatedControlStateIds = [];
+    Object.keys(controlStateMapRef.current).forEach(stateId => {
+      const controlState = controlStateMapRef.current[stateId];
+      const oldSubState = controlState.stateSelector(apiRef.current.state, apiRef.current.instanceId);
+      const newSubState = controlState.stateSelector(newState, apiRef.current.instanceId);
+
+      if (newSubState === oldSubState) {
+        return;
+      }
+
+      updatedControlStateIds.push({
+        stateId: controlState.stateId,
+        hasPropChanged: newSubState !== controlState.propModel
+      }); // The state is controlled, the prop should always win
+
+      if (controlState.propModel !== undefined && newSubState !== controlState.propModel) {
+        ignoreSetState = true;
+      }
+    });
+
+    if (updatedControlStateIds.length > 1) {
+      // Each hook modify its own state, and it should not leak
+      // Events are here to forward to other hooks and apply changes.
+      // You are trying to update several states in a no isolated way.
+      throw new Error(`You're not allowed to update several sub-state in one transaction. You already updated ${updatedControlStateIds[0].stateId}, therefore, you're not allowed to update ${updatedControlStateIds.map(el => el.stateId).join(', ')} in the same transaction.`);
+    }
+
+    if (!ignoreSetState) {
+      // We always assign it as we mutate rows for perf reason.
+      apiRef.current.state = newState;
+
+      if (apiRef.current.publishEvent) {
+        apiRef.current.publishEvent(GridEvents.stateChange, newState);
+      }
+    }
+
+    if (updatedControlStateIds.length === 1) {
+      const {
+        stateId,
+        hasPropChanged
+      } = updatedControlStateIds[0];
+      const controlState = controlStateMapRef.current[stateId];
+      const model = controlState.stateSelector(newState, apiRef.current.instanceId);
+
+      if (controlState.propOnChange && hasPropChanged) {
+        const details = props.signature === GridSignature.DataGridPro ? {
+          api: apiRef.current
+        } : {};
+        controlState.propOnChange(model, details);
+      }
+
+      if (!ignoreSetState) {
+        apiRef.current.publishEvent(controlState.changeEvent, model);
+      }
+    }
+
+    return !ignoreSetState;
+  }, [apiRef, props.signature]);
+  const forceUpdate = React.useCallback(() => rawForceUpdate(() => apiRef.current.state), [apiRef]);
+  const stateApi = {
+    setState,
+    forceUpdate,
+    unstable_updateControlState: updateControlState
+  };
+  useGridApiMethod(apiRef, stateApi, 'GridStateApi');
+};

package/hooks/features/clipboard/useGridClipboard.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+import { GridApiCommunity } from '../../../models/api/gridApiCommunity';
+/**
+ * @requires useGridCsvExport (method)
+ * @requires useGridSelection (method)
+ */
+export declare const useGridClipboard: (apiRef: React.MutableRefObject<GridApiCommunity>) => void;