@mui/x-data-grid-premium 8.0.0-beta.3 → 8.0.0

package/modern/hooks/features/clipboard/useGridClipboardImport.js

@@ -1,335 +0,0 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
-import * as React from 'react';
-import { GRID_CHECKBOX_SELECTION_FIELD, gridFocusCellSelector, gridVisibleColumnFieldsSelector, useGridEventPriority, useGridEvent, gridPaginatedVisibleSortedGridRowIdsSelector, gridExpandedSortedRowIdsSelector, gridRowSelectionIdsSelector, gridRowSelectionCountSelector } from '@mui/x-data-grid';
-import { getRowIdFromRowModel, getActiveElement, useGridRegisterPipeProcessor, getPublicApiRef, isPasteShortcut, useGridLogger } from '@mui/x-data-grid/internals';
-import { warnOnce } from '@mui/x-internals/warning';
-import { GRID_DETAIL_PANEL_TOGGLE_FIELD, GRID_REORDER_COL_DEF } from '@mui/x-data-grid-pro';
-import { unstable_debounce as debounce } from '@mui/utils';
-const columnFieldsToExcludeFromPaste = [GRID_CHECKBOX_SELECTION_FIELD, GRID_REORDER_COL_DEF.field, GRID_DETAIL_PANEL_TOGGLE_FIELD];
-
-// Batches rows that are updated during clipboard paste to reduce `updateRows` calls
-function batchRowUpdates(func, wait) {
-  let rows = [];
-  const debounced = debounce(() => {
-    func(rows);
-    rows = [];
-  }, wait);
-  return row => {
-    rows.push(row);
-    debounced();
-  };
-}
-async function getTextFromClipboard(rootEl) {
-  return new Promise(resolve => {
-    const focusedCell = getActiveElement(document);
-    const el = document.createElement('input');
-    el.style.width = '0px';
-    el.style.height = '0px';
-    el.style.border = 'none';
-    el.style.margin = '0';
-    el.style.padding = '0';
-    el.style.outline = 'none';
-    el.style.position = 'absolute';
-    el.style.top = '0';
-    el.style.left = '0';
-    const handlePasteEvent = event => {
-      el.removeEventListener('paste', handlePasteEvent);
-      const text = event.clipboardData?.getData('text/plain');
-      if (focusedCell instanceof HTMLElement) {
-        focusedCell.focus({
-          preventScroll: true
-        });
-      }
-      el.remove();
-      resolve(text || '');
-    };
-    el.addEventListener('paste', handlePasteEvent);
-    rootEl.appendChild(el);
-    el.focus({
-      preventScroll: true
-    });
-  });
-}
-
-// Keeps track of updated rows during clipboard paste
-class CellValueUpdater {
-  constructor(options) {
-    this.rowsToUpdate = {};
-    this.updateRow = void 0;
-    this.options = void 0;
-    this.options = options;
-    this.updateRow = batchRowUpdates(options.apiRef.current.updateRows, 50);
-  }
-  updateCell({
-    rowId,
-    field,
-    pastedCellValue
-  }) {
-    if (pastedCellValue === undefined) {
-      return;
-    }
-    const {
-      apiRef,
-      getRowId
-    } = this.options;
-    const colDef = apiRef.current.getColumn(field);
-    if (!colDef || !colDef.editable) {
-      return;
-    }
-    const row = this.rowsToUpdate[rowId] || _extends({}, apiRef.current.getRow(rowId));
-    if (!row) {
-      return;
-    }
-    let parsedValue = pastedCellValue;
-    if (colDef.pastedValueParser) {
-      parsedValue = colDef.pastedValueParser(pastedCellValue, row, colDef, apiRef);
-    } else if (colDef.valueParser) {
-      parsedValue = colDef.valueParser(parsedValue, row, colDef, apiRef);
-    }
-    if (parsedValue === undefined) {
-      return;
-    }
-    let rowCopy = _extends({}, row);
-    if (typeof colDef.valueSetter === 'function') {
-      rowCopy = colDef.valueSetter(parsedValue, rowCopy, colDef, apiRef);
-    } else {
-      rowCopy[field] = parsedValue;
-    }
-    const newRowId = getRowIdFromRowModel(rowCopy, getRowId);
-    if (String(newRowId) !== String(rowId)) {
-      // We cannot update row id, so this cell value update should be ignored
-      return;
-    }
-    this.rowsToUpdate[rowId] = rowCopy;
-  }
-  applyUpdates() {
-    const {
-      apiRef,
-      processRowUpdate,
-      onProcessRowUpdateError
-    } = this.options;
-    const rowsToUpdate = this.rowsToUpdate;
-    const rowIdsToUpdate = Object.keys(rowsToUpdate);
-    if (rowIdsToUpdate.length === 0) {
-      apiRef.current.publishEvent('clipboardPasteEnd');
-      return;
-    }
-    const handleRowUpdate = async rowId => {
-      const newRow = rowsToUpdate[rowId];
-      if (typeof processRowUpdate === 'function') {
-        const handleError = errorThrown => {
-          if (onProcessRowUpdateError) {
-            onProcessRowUpdateError(errorThrown);
-          } else if (process.env.NODE_ENV !== 'production') {
-            warnOnce(['MUI X: A call to `processRowUpdate` threw an error which was not handled because `onProcessRowUpdateError` is missing.', 'To handle the error pass a callback to the `onProcessRowUpdateError` prop, for example `<DataGrid onProcessRowUpdateError={(error) => ...} />`.', 'For more detail, see https://mui.com/x/react-data-grid/editing/persistence/.'], 'error');
-          }
-        };
-        try {
-          const oldRow = apiRef.current.getRow(rowId);
-          const finalRowUpdate = await processRowUpdate(newRow, oldRow, {
-            rowId
-          });
-          this.updateRow(finalRowUpdate);
-        } catch (error) {
-          handleError(error);
-        }
-      } else {
-        this.updateRow(newRow);
-      }
-    };
-    const promises = rowIdsToUpdate.map(rowId => {
-      // Wrap in promise that always resolves to avoid Promise.all from stopping on first error.
-      // This is to avoid using `Promise.allSettled` that has worse browser support.
-      return new Promise(resolve => {
-        handleRowUpdate(rowId).then(resolve).catch(resolve);
-      });
-    });
-    Promise.all(promises).then(() => {
-      this.rowsToUpdate = {};
-      apiRef.current.publishEvent('clipboardPasteEnd');
-    });
-  }
-}
-function defaultPasteResolver({
-  pastedData,
-  apiRef,
-  updateCell,
-  pagination,
-  paginationMode
-}) {
-  const isSingleValuePasted = pastedData.length === 1 && pastedData[0].length === 1;
-  const cellSelectionModel = apiRef.current.getCellSelectionModel();
-  const selectedCellsArray = apiRef.current.getSelectedCellsAsArray();
-  if (cellSelectionModel && selectedCellsArray.length > 1) {
-    let lastRowId = selectedCellsArray[0].id;
-    let rowIndex = 0;
-    let colIndex = 0;
-    selectedCellsArray.forEach(({
-      id: rowId,
-      field
-    }) => {
-      if (rowId !== lastRowId) {
-        lastRowId = rowId;
-        rowIndex += 1;
-        colIndex = 0;
-      }
-      const rowDataArr = pastedData[isSingleValuePasted ? 0 : rowIndex];
-      const hasRowData = isSingleValuePasted ? true : rowDataArr !== undefined;
-      if (hasRowData) {
-        const cellValue = isSingleValuePasted ? rowDataArr[0] : rowDataArr[colIndex];
-        updateCell({
-          rowId,
-          field,
-          pastedCellValue: cellValue
-        });
-      }
-      colIndex += 1;
-    });
-    return;
-  }
-  const visibleColumnFields = gridVisibleColumnFieldsSelector(apiRef).filter(field => {
-    if (columnFieldsToExcludeFromPaste.includes(field)) {
-      return false;
-    }
-    return true;
-  });
-  if (gridRowSelectionCountSelector(apiRef) > 0 && !isSingleValuePasted) {
-    // Multiple values are pasted starting from the first and top-most cell
-    const pastedRowsDataCount = pastedData.length;
-    const selectedRows = gridRowSelectionIdsSelector(apiRef);
-
-    // There's no guarantee that the selected rows are in the same order as the pasted rows
-    selectedRows.forEach((row, rowId) => {
-      let rowData;
-      if (pastedRowsDataCount === 1) {
-        // If only one row is pasted - paste it to all selected rows
-        rowData = pastedData[0];
-      } else {
-        rowData = pastedData.shift();
-      }
-      if (rowData === undefined) {
-        return;
-      }
-      rowData.forEach((newCellValue, cellIndex) => {
-        updateCell({
-          rowId,
-          field: visibleColumnFields[cellIndex],
-          pastedCellValue: newCellValue
-        });
-      });
-    });
-    return;
-  }
-  let selectedCell = gridFocusCellSelector(apiRef);
-  if (!selectedCell && selectedCellsArray.length === 1) {
-    selectedCell = selectedCellsArray[0];
-  }
-  if (!selectedCell) {
-    return;
-  }
-  if (columnFieldsToExcludeFromPaste.includes(selectedCell.field)) {
-    return;
-  }
-  const selectedRowId = selectedCell.id;
-  const selectedRowIndex = apiRef.current.getRowIndexRelativeToVisibleRows(selectedRowId);
-  const visibleRowIds = pagination && paginationMode === 'client' ? gridPaginatedVisibleSortedGridRowIdsSelector(apiRef) : gridExpandedSortedRowIdsSelector(apiRef);
-  const selectedFieldIndex = visibleColumnFields.indexOf(selectedCell.field);
-  pastedData.forEach((rowData, index) => {
-    const rowId = visibleRowIds[selectedRowIndex + index];
-    if (typeof rowId === 'undefined') {
-      return;
-    }
-    for (let i = selectedFieldIndex; i < visibleColumnFields.length; i += 1) {
-      const field = visibleColumnFields[i];
-      const stringValue = rowData[i - selectedFieldIndex];
-      updateCell({
-        rowId,
-        field,
-        pastedCellValue: stringValue
-      });
-    }
-  });
-}
-export const useGridClipboardImport = (apiRef, props) => {
-  const processRowUpdate = props.processRowUpdate;
-  const onProcessRowUpdateError = props.onProcessRowUpdateError;
-  const getRowId = props.getRowId;
-  const enableClipboardPaste = !props.disableClipboardPaste;
-  const logger = useGridLogger(apiRef, 'useGridClipboardImport');
-  const splitClipboardPastedText = props.splitClipboardPastedText;
-  const {
-    pagination,
-    paginationMode,
-    onBeforeClipboardPasteStart
-  } = props;
-  const handlePaste = React.useCallback(async (params, event) => {
-    if (!enableClipboardPaste) {
-      return;
-    }
-    if (!isPasteShortcut(event)) {
-      return;
-    }
-    const focusedCell = gridFocusCellSelector(apiRef);
-    if (focusedCell !== null) {
-      const cellMode = apiRef.current.getCellMode(focusedCell.id, focusedCell.field);
-      if (cellMode === 'edit') {
-        // Do not paste data when the cell is in edit mode
-        return;
-      }
-    }
-    const rootEl = apiRef.current.rootElementRef?.current;
-    if (!rootEl) {
-      return;
-    }
-    const text = await getTextFromClipboard(rootEl);
-    if (!text) {
-      return;
-    }
-    const pastedData = splitClipboardPastedText(text);
-    if (!pastedData) {
-      return;
-    }
-    if (onBeforeClipboardPasteStart) {
-      try {
-        await onBeforeClipboardPasteStart({
-          data: pastedData
-        });
-      } catch (error) {
-        logger.debug('Clipboard paste operation cancelled');
-        return;
-      }
-    }
-    const cellUpdater = new CellValueUpdater({
-      apiRef,
-      processRowUpdate,
-      onProcessRowUpdateError,
-      getRowId
-    });
-    apiRef.current.publishEvent('clipboardPasteStart', {
-      data: pastedData
-    });
-    defaultPasteResolver({
-      pastedData,
-      apiRef: getPublicApiRef(apiRef),
-      updateCell: (...args) => {
-        cellUpdater.updateCell(...args);
-      },
-      pagination,
-      paginationMode
-    });
-    cellUpdater.applyUpdates();
-  }, [apiRef, processRowUpdate, onProcessRowUpdateError, getRowId, enableClipboardPaste, splitClipboardPastedText, pagination, paginationMode, onBeforeClipboardPasteStart, logger]);
-  const checkIfCanStartEditing = React.useCallback((initialValue, {
-    event
-  }) => {
-    if (isPasteShortcut(event) && enableClipboardPaste) {
-      // Do not enter cell edit mode on paste
-      return false;
-    }
-    return initialValue;
-  }, [enableClipboardPaste]);
-  useGridEvent(apiRef, 'cellKeyDown', handlePaste);
-  useGridEventPriority(apiRef, 'clipboardPasteStart', props.onClipboardPasteStart);
-  useGridEventPriority(apiRef, 'clipboardPasteEnd', props.onClipboardPasteEnd);
-  useGridRegisterPipeProcessor(apiRef, 'canStartEditing', checkIfCanStartEditing);
-};

package/modern/hooks/features/dataSource/models.d.ts

@@ -1,54 +0,0 @@
-import type { GridColDef, GridRowId, GridValidRowModel, GridDataSource, GridGetRowsResponse, GridGetRowsParams, GridDataSourceApiBase, GridDataSourcePrivateApi } from '@mui/x-data-grid-pro';
-import type { GridAggregationModel } from '../aggregation/gridAggregationInterfaces';
-export interface GridGetRowsResponsePremium extends GridGetRowsResponse {
-  /**
-   * Row to be used for aggregation footer row.
-   * It must provide the values for the aggregated columns passed in
-   * `GridGetRowsParams.aggregationModel`.
-   */
-  aggregateRow?: GridValidRowModel;
-}
-export interface GridGetRowsParamsPremium extends GridGetRowsParams {
-  /**
-   * List of aggregated columns.
-   */
-  aggregationModel?: GridAggregationModel;
-  /**
-   * List of grouped columns (only applicable with `rowGrouping`).
-   */
-  groupFields?: GridColDef['field'][];
-}
-export interface GridDataSourcePremium extends Omit<GridDataSource, 'getRows'> {
-  /**
-   * This method will be called when the grid needs to fetch some rows.
-   * @param {GridGetRowsParamsPremium} params The parameters required to fetch the rows.
-   * @returns {Promise<GridGetRowsResponsePremium>} A promise that resolves to the data of type [GridGetRowsResponsePremium].
-   */
-  getRows(params: GridGetRowsParamsPremium): Promise<GridGetRowsResponsePremium>;
-  /**
-   * Used to get the aggregated value for a parent row.
-   * @param {GridValidRowModel} row The row to extract the aggregated value from.
-   * @param {GridColDef['field']} field The field to extract the aggregated value for.
-   * @returns {string} The aggregated value for a specific aggregated column.
-   */
-  getAggregatedValue?: (row: GridValidRowModel, field: GridColDef['field']) => string;
-}
-export interface GridDataSourceApiBasePremium extends Omit<GridDataSourceApiBase, 'fetchRows'> {
-  /**
-   * Fetches the rows from the server.
-   * If no `parentId` option is provided, it fetches the root rows.
-   * Any missing parameter from `params` will be filled from the state (sorting, filtering, etc.).
-   * @param {GridRowId} parentId The id of the parent node (default: `GRID_ROOT_GROUP_ID`).
-   * @param {Partial<GridGetRowsParamsPremium>} params Request parameters override.
-   */
-  fetchRows: (parentId?: GridRowId, params?: Partial<GridGetRowsParamsPremium>) => void;
-}
-export interface GridDataSourceApiPremium {
-  /**
-   * The data source API.
-   */
-  dataSource: GridDataSourceApiBasePremium;
-}
-export interface GridDataSourcePremiumPrivateApi extends GridDataSourcePrivateApi {
-  resolveGroupAggregation: (groupId: GridRowId, field: string) => any;
-}

package/modern/hooks/features/dataSource/models.js

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

package/modern/hooks/features/dataSource/useGridDataSourcePremium.d.ts

@@ -1,4 +0,0 @@
-import { RefObject } from '@mui/x-internals/types';
-import { GridPrivateApiPremium } from "../../../models/gridApiPremium.js";
-import { DataGridPremiumProcessedProps } from "../../../models/dataGridPremiumProps.js";
-export declare const useGridDataSourcePremium: (apiRef: RefObject<GridPrivateApiPremium>, props: DataGridPremiumProcessedProps) => void;

package/modern/hooks/features/dataSource/useGridDataSourcePremium.js

@@ -1,59 +0,0 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
-import * as React from 'react';
-import { useGridEvent as addEventHandler, useGridApiMethod, GRID_ROOT_GROUP_ID } from '@mui/x-data-grid-pro';
-import { useGridDataSourceBasePro, useGridRegisterStrategyProcessor, useGridRegisterPipeProcessor } from '@mui/x-data-grid-pro/internals';
-function getKeyPremium(params) {
-  return JSON.stringify([params.filterModel, params.sortModel, params.groupKeys, params.groupFields, params.start, params.end, params.aggregationModel]);
-}
-const options = {
-  cacheOptions: {
-    getKey: getKeyPremium
-  }
-};
-export const useGridDataSourcePremium = (apiRef, props) => {
-  const {
-    api,
-    strategyProcessor,
-    events,
-    setStrategyAvailability
-  } = useGridDataSourceBasePro(apiRef, props, options);
-  const aggregateRowRef = React.useRef({});
-  const processDataSourceRows = React.useCallback(({
-    params,
-    response
-  }, applyRowHydration) => {
-    if (response.aggregateRow) {
-      aggregateRowRef.current = response.aggregateRow;
-    }
-    if (Object.keys(params.aggregationModel || {}).length > 0) {
-      if (applyRowHydration) {
-        apiRef.current.requestPipeProcessorsApplication('hydrateRows');
-      }
-      apiRef.current.applyAggregation();
-    }
-    return {
-      params,
-      response
-    };
-  }, [apiRef]);
-  const resolveGroupAggregation = React.useCallback((groupId, field) => {
-    if (groupId === GRID_ROOT_GROUP_ID) {
-      return props.dataSource?.getAggregatedValue?.(aggregateRowRef.current, field);
-    }
-    const row = apiRef.current.getRow(groupId);
-    return props.dataSource?.getAggregatedValue?.(row, field);
-  }, [apiRef, props.dataSource]);
-  const privateApi = _extends({}, api.private, {
-    resolveGroupAggregation
-  });
-  useGridApiMethod(apiRef, api.public, 'public');
-  useGridApiMethod(apiRef, privateApi, 'private');
-  useGridRegisterStrategyProcessor(apiRef, strategyProcessor.strategyName, strategyProcessor.group, strategyProcessor.processor);
-  useGridRegisterPipeProcessor(apiRef, 'processDataSourceRows', processDataSourceRows);
-  Object.entries(events).forEach(([event, handler]) => {
-    addEventHandler(apiRef, event, handler);
-  });
-  React.useEffect(() => {
-    setStrategyAvailability();
-  }, [setStrategyAvailability]);
-};

package/modern/hooks/features/export/gridExcelExportInterface.d.ts

@@ -1,71 +0,0 @@
-import type * as Excel from 'exceljs';
-import { GridFileExportOptions, GridExportFormat as GridExportFormatCommunity, GridExportExtension as GridExportExtensionCommunity } from '@mui/x-data-grid-pro';
-export type GridExportFormat = GridExportFormatCommunity | 'excel';
-export type GridExportExtension = GridExportExtensionCommunity | 'xlsx';
-export interface GridExceljsProcessInput {
-  workbook: Excel.Workbook;
-  worksheet: Excel.Worksheet;
-}
-export interface ColumnsStylesInterface {
-  [field: string]: Partial<Excel.Style>;
-}
-/**
- * The options to apply on the Excel export.
- * @demos
- *   - [Excel export](/x/react-data-grid/export/#excel-export)
- */
-export interface GridExcelExportOptions extends GridFileExportOptions {
-  /**
-   * Function to return the Worker instance to be called.
-   * @returns {() => Worker} A Worker instance.
-   */
-  worker?: () => Worker;
-  /**
-   * Name given to the worksheet containing the columns valueOptions.
-   * valueOptions are added to this worksheet if they are provided as an array.
-   */
-  valueOptionsSheetName?: string;
-  /**
-   * Method called before adding the rows to the workbook.
-   * Not supported when `worker` is set.
-   * To use with web workers, use the option in `setupExcelExportWebWorker`.
-   * @param {GridExceljsProcessInput} processInput object containing the workbook and the worksheet.
-   * @returns {Promise<void>} A promise which resolves after processing the input.
-   * */
-  exceljsPreProcess?: (processInput: GridExceljsProcessInput) => Promise<void>;
-  /**
-   * Method called after adding the rows to the workbook.
-   * Not supported when `worker` is set.
-   * To use with web workers, use the option in `setupExcelExportWebWorker`.
-   * @param {GridExceljsProcessInput} processInput object containing the workbook and the worksheet.
-   * @returns {Promise<void>} A promise which resolves after processing the input.
-   * */
-  exceljsPostProcess?: (processInput: GridExceljsProcessInput) => Promise<void>;
-  /**
-   * Object mapping column field to Exceljs style
-   * */
-  columnsStyles?: ColumnsStylesInterface;
-  /**
-   * If `true`, the headers of the column groups will be added into the file.
-   * @default true
-   */
-  includeColumnGroupsHeaders?: boolean;
-}
-/**
- * The excel export API interface that is available in the grid [[apiRef]].
- */
-export interface GridExcelExportApi {
-  /**
-   * Returns the grid data as an exceljs workbook.
-   * This method is used internally by `exportDataAsExcel`.
-   * @param {GridExcelExportOptions} options The options to apply on the export.
-   * @returns {Promise<Excel.Workbook>} The data in a exceljs workbook object.
-   */
-  getDataAsExcel: (options?: GridExcelExportOptions) => Promise<Excel.Workbook> | null;
-  /**
-   * Downloads and exports an Excel file of the grid's data.
-   * @param {GridExcelExportOptions} options The options to apply on the export.
-   * @returns {Promise<void>} A promise which resolves after exporting to Excel.
-   */
-  exportDataAsExcel: (options?: GridExcelExportOptions) => Promise<void>;
-}

package/modern/hooks/features/export/gridExcelExportInterface.js

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

package/modern/hooks/features/export/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./gridExcelExportInterface.js";
-export { setupExcelExportWebWorker } from "./serializer/setupExcelExportWebWorker.js";

package/modern/hooks/features/export/index.js

@@ -1,2 +0,0 @@
-export * from "./gridExcelExportInterface.js";
-export { setupExcelExportWebWorker } from "./serializer/setupExcelExportWebWorker.js";

package/modern/hooks/features/export/serializer/excelSerializer.d.ts

@@ -1,40 +0,0 @@
-import type * as Excel from 'exceljs';
-import { RefObject } from '@mui/x-internals/types';
-import { GridRowId, GridColDef } from '@mui/x-data-grid-pro';
-import { GridStateColDef } from '@mui/x-data-grid/internals';
-import { ColumnsStylesInterface, GridExcelExportOptions } from "../gridExcelExportInterface.js";
-import { GridPrivateApiPremium } from "../../../../models/gridApiPremium.js";
-import { SerializedColumns, SerializedRow, ValueOptionsData } from "./utils.js";
-export type { ExcelExportInitEvent } from './utils';
-/**
- * FIXME: This function mutates the colspan info, but colspan info assumes that the columns
- * passed to it are always consistent. In this case, the exported columns may differ from the
- * actual rendered columns.
- * The caller of this function MUST call `resetColSpan()` before and after usage.
- */
-export declare const serializeRowUnsafe: (id: GridRowId, columns: GridStateColDef[], apiRef: RefObject<GridPrivateApiPremium>, defaultValueOptionsFormulae: {
-  [field: string]: {
-    address: string;
-  };
-}, options: Pick<BuildExcelOptions, "escapeFormulas">) => SerializedRow;
-export declare const serializeColumn: (column: GridColDef, columnsStyles: ColumnsStylesInterface) => {
-  key: string;
-  headerText: string;
-  width: number;
-  style: {
-    numFmt?: string | undefined;
-    font?: Partial<Excel.Font> | undefined;
-    alignment?: Partial<Excel.Alignment> | undefined;
-    protection?: Partial<Excel.Protection> | undefined;
-    border?: Partial<Excel.Borders> | undefined;
-    fill?: Excel.Fill | undefined;
-  };
-};
-export declare function serializeColumns(columns: GridStateColDef[], styles: ColumnsStylesInterface): SerializedColumns;
-export declare function getDataForValueOptionsSheet(columns: GridStateColDef[], valueOptionsSheetName: string, api: GridPrivateApiPremium): Promise<ValueOptionsData>;
-interface BuildExcelOptions extends Pick<GridExcelExportOptions, 'exceljsPreProcess' | 'exceljsPostProcess'>, Pick<Required<GridExcelExportOptions>, 'valueOptionsSheetName' | 'includeHeaders' | 'includeColumnGroupsHeaders' | 'escapeFormulas'> {
-  columns: GridStateColDef[];
-  rowIds: GridRowId[];
-  columnsStyles?: ColumnsStylesInterface;
-}
-export declare function buildExcel(options: BuildExcelOptions, apiRef: RefObject<GridPrivateApiPremium>): Promise<Excel.Workbook>;