[DataGrid] Change GridColDef methods signatures

[cherniavskii]

Closes #10741

Changelog

Breaking changes

• The signature of GridColDef['valueGetter'] has been changed for performance reasons:

  - valueGetter: ({ value, row }) => value,
  + valueGetter: (value, row, column, apiRef) => value,

  The GridValueGetterParams interface has been removed:

  - const customValueGetter = (params: GridValueGetterParams) => params.row.budget;
  + const customValueGetter: GridValueGetterFn = (value, row) => row.budget;

• The signature of GridColDef['valueFormatter'] has been changed for performance reasons:

  - valueFormatter: ({ value }) => value,
  + valueFormatter: (value, row, column, apiRef) => value,

  The GridValueFormatterParams interface has been removed:

  - const gridDateFormatter = ({ value, field, id }: GridValueFormatterParams<Date>) => value.toLocaleDateString();
  + const gridDateFormatter: GridValueFormatter = (value: Date) => value.toLocaleDateString();

• The signature of GridColDef['valueSetter'] has been changed for performance reasons:

  - valueSetter: (params) => {
  -   const [firstName, lastName] = params.value!.toString().split(' ');
  -   return { ...params.row, firstName, lastName };
  - }
  + valueSetter: (value, row) => {
  +   const [firstName, lastName] = value!.toString().split(' ');
  +   return { ...row, firstName, lastName };
  +}

  The GridValueSetterParams interface has been removed:

  - const setFullName = (params: GridValueSetterParams) => {
  -   const [firstName, lastName] = params.value!.toString().split(' ');
  -   return { ...params.row, firstName, lastName };
  - };
  + const setFullName: GridValueSetter<Row> = (value, row) => {
  +   const [firstName, lastName] = value!.toString().split(' ');
  +   return { ...row, firstName, lastName };
  + }

• The signature of GridColDef['valueParser'] has been changed for performance reasons:

  - valueParser: (value, params: GridCellParams) => value.toLowerCase(),
  + valueParser: (value, row, column, apiRef) => value.toLowerCase(),

• The signature of GridColDef['colSpan'] has been changed for performance reasons:

  - colSpan: ({ row, field, value }: GridCellParams) => (row.id === 'total' ? 2 : 1),
  + colSpan: (value, row, column, apiRef) => (row.id === 'total' ? 2 : 1),

• The signature of GridColDef['pastedValueParser'] has been changed for performance reasons:

  - pastedValueParser: (value, params) => new Date(value),
  + pastedValueParser: (value, row, column, apiRef) => new Date(value),

• The signature of GridColDef['groupingValueGetter'] has been changed for performance reasons:

  - groupingValueGetter: (params) => params.value.name,
  + groupingValueGetter: (value: { name: string }) => value.name,

[mui-bot]

Deploy preview: https://deploy-preview-11573--material-ui-x.netlify.app/

Updated pages:

• docs/data/data-grid/aggregation/aggregation.md
• docs/data/data-grid/column-definition/column-definition.md
• docs/data/data-grid/custom-columns/custom-columns.md
• docs/data/data-grid/editing/editing.md
• docs/data/data-grid/export/export.md

Generated by 🚫 dangerJS against 161d887

[github-actions]

This pull request has conflicts, please resolve those before we can evaluate the pull request.

[cherniavskii]

I have measured the performance impact of this PR on quick filtering by measuring the execution time of the applyFilters function after applying the quick filter that with no match (every column gets checked against the filtering value).
It's around 20-30% faster depending on the number of rows and columns.
Here are the detailed results:

	next	HEAD	diff
10k rows, 10 columns (no filter match)
Median (ms)	12.54	9.57	-23.72%
Mean (ms)	13.10	10.13	-22.71%
σ (for 20 runs)	1.64	1.76
100k rows, 29 columns (no filter match)
Median (ms)	883.76	636.38	-27.99%
Mean (ms)	909.49	643.40	-29.26%
σ (for 20 runs)	77.06	22.91

I'm not 100% if it's worth pushing forward, because:

• most end users won't feel the difference
• breaking changes will impact almost every user

@romgrk @joserodolfofreitas What do you think?

[romgrk]

I'm still for these changes because:

• It's 20-30% here, but they will also affect other parts of the grid wherever we use those functions.
• Quickfilters aren't usable for larger datasets, 800+ms is horribly long. And I imagine you run those numbers of your (fast) computer.
• The complexity of the change for users seems quite low.

[MBilalShafi]

Nice improvement 🚀
I think it makes sense to add these changes to the migration guide too

[quintonlucyk]

Is this documentation up to date? I'm encountering Module '"@mui/x-data-grid-premium"' has no exported member 'GridColDef'.

[romgrk]

Open a new issue for assistance.