@elliemae/ds-datagrids 3.16.0-next.2 → 3.16.0-next.20

package/dist/cjs/DSDataGrid.js

@@ -18,6 +18,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -33,16 +37,19 @@ module.exports = __toCommonJS(DSDataGrid_exports);
 var React = __toESM(require("react"));
 var import_jsx_runtime = require("react/jsx-runtime");
 var import_ds_utilities = require("@elliemae/ds-utilities");
+var import_ds_props_helpers = require("@elliemae/ds-props-helpers");
 var import_ds_truncated_tooltip_text = require("@elliemae/ds-truncated-tooltip-text");
-var import_DataGridImpl = require("./DataGridImpl");
-var import_rowSizes = require("./rowSizes");
+var import_DataGridImpl = require("./DataGridImpl.js");
+var import_rowSizes = require("./rowSizes.js");
 const DSDataGrids = ({
   containerProps = {},
   instanceRef,
   className = "",
+  // data
   columns = [],
   rows = [],
   rowKey = "id",
+  // features
   infiniteScrolling = false,
   editable = false,
   sortable = false,
@@ -55,8 +62,11 @@ const DSDataGrids = ({
   dragAndDropColumns = false,
   useTreeData = false,
   autoScrollToId,
+  // virtualization props
   overscanCount = 10,
+  // feature state
   selectAll = false,
+  // todo: change to isAllSelected
   selectedRows = [],
   filters = void 0,
   onAddFilter = () => null,
@@ -72,6 +82,7 @@ const DSDataGrids = ({
   aggregations = {},
   groupingColumn = void 0,
   sortingColumns = {},
+  // pagination
   minPerPage = 0,
   maxPerPage = 50,
   onPerPageChange = () => null,
@@ -81,6 +92,7 @@ const DSDataGrids = ({
     page: 1,
     perPage: 10
   },
+  // visual
   showHeader = true,
   fixedHeader = true,
   wrapText = false,
@@ -88,21 +100,26 @@ const DSDataGrids = ({
   minColumnWidth = 100,
   showRowsLoader = false,
   visibleColumns = void 0,
+  // this enforces visibility of columns
   showSelectHighlight = false,
   showSelectColumn = true,
   selectColumnSortable = true,
   selectColumnFilterable = false,
   selectionColumnDefinition = {},
   filterBarOptions = void 0,
+  // searchGrid = false,
   renderToolbar = void 0,
   toolbarDelayClose = 400,
   renderFilterToolbar = void 0,
   multiSelectComponent = void 0,
+  // todo: deprecate this
   noResultsRender,
   noResultsPlaceholder,
   fluidHeight = false,
   customHandlers = {},
+  // grouping feature
   groupedBy = void 0,
+  // callbacks
   onDefaultFiltersLoad = () => null,
   onReorder = () => null,
   onMoveRowEnd = () => null,
@@ -124,14 +141,17 @@ const DSDataGrids = ({
   onFilterMenuClose = () => null,
   onFilterMenuOpen = () => null,
   getData = void 0,
+  // todo: change to onGetMoreData
   serverSideData = false,
   isDataSorted = false,
   isDataFiltered = false,
   virtualized = true,
   numRowsVisible = void 0,
   isColumnEditable = (column) => column.editable,
+  // grouped props
   groupedRows = false,
   groupedRowsRenderHeader = void 0,
+  // expandable props
   renderExpandedDetails = () => null,
   detailColumns,
   expandable = false,
@@ -150,289 +170,420 @@ const DSDataGrids = ({
   noColumnsPlaceholder,
   plugins = [],
   normalizeDataKeys = false
-}) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ds_truncated_tooltip_text.TooltipTextProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  import_DataGridImpl.DataGridImpl,
-  {
-    aggregations,
-    autoHeight: autoHeight && !fluidHeight,
-    autoScrollToId,
-    bindColumnsSizeTo,
-    bindRowSizeTo,
-    className,
-    columns,
-    containerProps,
-    customHandlers,
-    detailColumns,
-    dragAndDropColumns,
-    dragAndDropRows,
-    editable,
-    expandable,
-    expandableSubrowsVisible,
-    expandedRows,
-    filterBarOptions,
-    filters,
-    fixedHeader,
-    fluidHeight,
-    getChildrenRows,
-    getData,
-    getExpandedRowMinSize,
-    getExpandedRowSize,
-    groupedBy,
-    groupedRows,
-    groupedRowsRenderHeader,
-    groupingColumn,
-    height,
-    infiniteScrolling,
-    instanceRef,
-    isColumnEditable,
-    isDataFiltered,
-    isDataSorted,
-    maxPerPage,
-    minColumnWidth,
-    minPerPage,
-    multiSelectComponent,
-    multiSelectFilterLabel,
-    multiSelectFilterLabels,
-    multiSelectFilterOptions,
-    noColumnsPlaceholder,
-    noResultsPlaceholder,
-    noResultsRender,
-    normalizeDataKeys,
-    numRowsVisible,
-    onAddFilter,
-    onColumnResize,
-    onColumnRowEdit,
-    onColumnRowEdited,
-    onExpandRow,
-    onExpandChange,
-    onFilter,
-    onFiltersChange,
-    onFilterMenuClose,
-    onFilterMenuOpen,
-    onDefaultFiltersLoad,
-    onInfiniteScrolling,
-    onMoveColumnEnd,
-    onMoveColumnOver,
-    onMoveColumnStart,
-    onMoveRowEnd,
-    onMoveRowStart,
-    onPageChange,
-    onPerPageChange,
-    onRemoveFilter,
-    onReorder,
-    onSelectAll,
-    onSelectRow,
-    onSort,
-    onToggleExpand,
-    onToggleShowAllRows,
-    overscanCount,
-    paginated,
-    pagination,
-    paginationStep,
-    plugins,
-    renderExpandedDetails,
-    renderFilterToolbar,
-    renderRowDetails,
-    renderToolbar,
-    resizeableColumns,
-    rowKey,
-    rows,
-    rowSize,
-    searchFilters,
-    selectable,
-    selectAll,
-    selectColumnFilterable,
-    selectColumnSortable,
-    selectedRows,
-    selectionColumnDefinition,
-    serverSideData,
-    showFilterBar,
-    showHeader,
-    showRowsLoader,
-    showSelectColumn,
-    showSelectHighlight,
-    sortable,
-    sortEmptyLast,
-    sortingColumns,
-    subrowSize: subRowSize,
-    toolbarDelayClose,
-    useTreeData,
-    virtualized,
-    visibleColumns,
-    wrapText
-  }
-) });
+}) => {
+  (0, import_ds_utilities.useDeprecateComponent)({ componentName: "ds-datagrids", version: "3.x Date: 2023 Q1" });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_ds_truncated_tooltip_text.TooltipTextProvider, { children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    import_DataGridImpl.DataGridImpl,
+    {
+      aggregations,
+      autoHeight: autoHeight && !fluidHeight,
+      autoScrollToId,
+      bindColumnsSizeTo,
+      bindRowSizeTo,
+      className,
+      columns,
+      containerProps,
+      customHandlers,
+      detailColumns,
+      dragAndDropColumns,
+      dragAndDropRows,
+      editable,
+      expandable,
+      expandableSubrowsVisible,
+      expandedRows,
+      filterBarOptions,
+      filters,
+      fixedHeader,
+      fluidHeight,
+      getChildrenRows,
+      getData,
+      getExpandedRowMinSize,
+      getExpandedRowSize,
+      groupedBy,
+      groupedRows,
+      groupedRowsRenderHeader,
+      groupingColumn,
+      height,
+      infiniteScrolling,
+      instanceRef,
+      isColumnEditable,
+      isDataFiltered,
+      isDataSorted,
+      maxPerPage,
+      minColumnWidth,
+      minPerPage,
+      multiSelectComponent,
+      multiSelectFilterLabel,
+      multiSelectFilterLabels,
+      multiSelectFilterOptions,
+      noColumnsPlaceholder,
+      noResultsPlaceholder,
+      noResultsRender,
+      normalizeDataKeys,
+      numRowsVisible,
+      onAddFilter,
+      onColumnResize,
+      onColumnRowEdit,
+      onColumnRowEdited,
+      onExpandRow,
+      onExpandChange,
+      onFilter,
+      onFiltersChange,
+      onFilterMenuClose,
+      onFilterMenuOpen,
+      onDefaultFiltersLoad,
+      onInfiniteScrolling,
+      onMoveColumnEnd,
+      onMoveColumnOver,
+      onMoveColumnStart,
+      onMoveRowEnd,
+      onMoveRowStart,
+      onPageChange,
+      onPerPageChange,
+      onRemoveFilter,
+      onReorder,
+      onSelectAll,
+      onSelectRow,
+      onSort,
+      onToggleExpand,
+      onToggleShowAllRows,
+      overscanCount,
+      paginated,
+      pagination,
+      paginationStep,
+      plugins,
+      renderExpandedDetails,
+      renderFilterToolbar,
+      renderRowDetails,
+      renderToolbar,
+      resizeableColumns,
+      rowKey,
+      rows,
+      rowSize,
+      searchFilters,
+      selectable,
+      selectAll,
+      selectColumnFilterable,
+      selectColumnSortable,
+      selectedRows,
+      selectionColumnDefinition,
+      serverSideData,
+      showFilterBar,
+      showHeader,
+      showRowsLoader,
+      showSelectColumn,
+      showSelectHighlight,
+      sortable,
+      sortEmptyLast,
+      sortingColumns,
+      subrowSize: subRowSize,
+      toolbarDelayClose,
+      useTreeData,
+      virtualized,
+      visibleColumns,
+      wrapText
+    }
+  ) });
+};
 const props = {
-  instanceRef: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.func, import_ds_utilities.PropTypes.shape({ current: import_ds_utilities.PropTypes.any })]).description(
+  /** ref to the instance of the datagrid, handle it imperatively */
+  instanceRef: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.func, import_ds_props_helpers.PropTypes.shape({ current: import_ds_props_helpers.PropTypes.any })]).description(
     "ref to the instance of the datagrid, handle it imperatively"
   ),
-  className: import_ds_utilities.PropTypes.string.description("class for data grid wrapper"),
-  containerProps: import_ds_utilities.PropTypes.object.description("inject props to datagrid wrapper"),
-  filterBarOptions: import_ds_utilities.PropTypes.shape({
-    minWidth: import_ds_utilities.PropTypes.number,
-    maxWidth: import_ds_utilities.PropTypes.number
+  /** class for data grid wrapper */
+  className: import_ds_props_helpers.PropTypes.string.description("class for data grid wrapper"),
+  /** inject props to datagrid wrapper */
+  containerProps: import_ds_props_helpers.PropTypes.object.description("inject props to datagrid wrapper"),
+  /** FilterBar props passed down to FilterBar */
+  filterBarOptions: import_ds_props_helpers.PropTypes.shape({
+    minWidth: import_ds_props_helpers.PropTypes.number,
+    maxWidth: import_ds_props_helpers.PropTypes.number
   }).description("FilterBar props passed down to FilterBar"),
-  columns: import_ds_utilities.PropTypes.arrayOf(
-    import_ds_utilities.PropTypes.shape({
-      property: import_ds_utilities.PropTypes.string.isRequired,
-      label: import_ds_utilities.PropTypes.string,
-      width: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.number, import_ds_utilities.PropTypes.string]),
-      minWidth: import_ds_utilities.PropTypes.number,
-      customEditor: import_ds_utilities.PropTypes.func,
-      customRenderer: import_ds_utilities.PropTypes.func,
-      searchable: import_ds_utilities.PropTypes.bool,
-      sortable: import_ds_utilities.PropTypes.bool,
-      resizable: import_ds_utilities.PropTypes.bool,
-      editable: import_ds_utilities.PropTypes.bool,
-      visible: import_ds_utilities.PropTypes.bool
+  /** datagrid columns */
+  columns: import_ds_props_helpers.PropTypes.arrayOf(
+    import_ds_props_helpers.PropTypes.shape({
+      /** Column property as an identifier */
+      property: import_ds_props_helpers.PropTypes.string.isRequired,
+      /** Label in the header */
+      label: import_ds_props_helpers.PropTypes.string,
+      /** Defines the width of the column, can be a string with percentages ("50%"), if not defined the width is flexible */
+      width: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.number, import_ds_props_helpers.PropTypes.string]),
+      /** Min width for this column. NOTE: Has prevalence over the general minColumnWidth */
+      minWidth: import_ds_props_helpers.PropTypes.number,
+      /** Function returning a custom editor for that cell ({ value, onValue, rowData }) => Element */
+      customEditor: import_ds_props_helpers.PropTypes.func,
+      /** Function returning an element to render in the cell ({ value, customHandlers, metaData: { rowData } }) => Element */
+      customRenderer: import_ds_props_helpers.PropTypes.func,
+      /** Activates 'searchable' feature for this column */
+      searchable: import_ds_props_helpers.PropTypes.bool,
+      /** Activates 'sortable' feature for this column */
+      sortable: import_ds_props_helpers.PropTypes.bool,
+      /** Activates 'resizable' feature for this column */
+      resizable: import_ds_props_helpers.PropTypes.bool,
+      /** Activates 'editable' feature for this column */
+      editable: import_ds_props_helpers.PropTypes.bool,
+      /** Whether this column is visible or not */
+      visible: import_ds_props_helpers.PropTypes.bool
     })
   ).description("datagrid columns"),
-  rows: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.object).description("datagrid rows"),
-  rowKey: import_ds_utilities.PropTypes.string.description("key for each row"),
-  infiniteScrolling: import_ds_utilities.PropTypes.bool.description("toggle infinite scroll loading behavior"),
-  overscanCount: import_ds_utilities.PropTypes.number.description(
+  /** datagrid rows */
+  rows: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.object).description("datagrid rows"),
+  /** key for each row */
+  rowKey: import_ds_props_helpers.PropTypes.string.description("key for each row"),
+  /** toggle infinite scroll loading behavior */
+  infiniteScrolling: import_ds_props_helpers.PropTypes.bool.description("toggle infinite scroll loading behavior"),
+  /** Activates 'editable' feature on the DataGrid NOTE: needs to be activated in the column definition as well */
+  overscanCount: import_ds_props_helpers.PropTypes.number.description(
     "Activates 'editable' feature on the DataGrid NOTE: needs to be activated in the column definition as well"
   ),
-  editable: import_ds_utilities.PropTypes.bool.description("turn datagrid to editable mode"),
-  sortable: import_ds_utilities.PropTypes.bool.description(
+  /** turn datagrid to editable mode */
+  editable: import_ds_props_helpers.PropTypes.bool.description("turn datagrid to editable mode"),
+  /** Activates 'sortable' feature on the GataGrid NOTE: needs to be activated in the column definition as well */
+  sortable: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'sortable' feature on the GataGrid NOTE: needs to be activated in the column definition as well"
   ),
-  sortEmptyLast: import_ds_utilities.PropTypes.bool.description("Put empty values always last on the column after sorting"),
-  paginated: import_ds_utilities.PropTypes.bool.description(
+  /** Put empty values always last on the column after sorting */
+  sortEmptyLast: import_ds_props_helpers.PropTypes.bool.description("Put empty values always last on the column after sorting"),
+  /** Activates 'pagination' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  paginated: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'pagination' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  paginationStep: import_ds_utilities.PropTypes.number.description("Pagination step for clicking the next pages"),
-  dragAndDropRows: import_ds_utilities.PropTypes.bool.description(
+  /** Pagination step for clicking the next pages */
+  paginationStep: import_ds_props_helpers.PropTypes.number.description("Pagination step for clicking the next pages"),
+  /** Activates 'drag and drop rows' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  dragAndDropRows: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'drag and drop rows' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  selectable: import_ds_utilities.PropTypes.bool.description(
+  /** Activates 'selection' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  selectable: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'selection' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  resizeableColumns: import_ds_utilities.PropTypes.bool.description(
+  /** Activates 'resize' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  resizeableColumns: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'resize' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  noResultsPlaceholder: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.string, import_ds_utilities.PropTypes.element]).description(
+  /** Placeholder rendered when no rows are visible */
+  noResultsPlaceholder: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.string, import_ds_props_helpers.PropTypes.element]).description(
     "Placeholder rendered when no rows are visible"
   ),
-  searchFilters: import_ds_utilities.PropTypes.bool.description(
+  /** Activates 'filtering' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  searchFilters: import_ds_props_helpers.PropTypes.bool.description(
     "activates 'filtering' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  dragAndDropColumns: import_ds_utilities.PropTypes.bool.description(
+  /** Activates 'drag and drop columns' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  dragAndDropColumns: import_ds_props_helpers.PropTypes.bool.description(
     "Activates 'drag and drop columns' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  useTreeData: import_ds_utilities.PropTypes.bool.description(
+  /** Activates 'grouping and tree data' feature on the datagrid NOTE: needs to be activated in the column definition as well */
+  useTreeData: import_ds_props_helpers.PropTypes.bool.description(
     "activates 'grouping and tree data' feature on the datagrid NOTE: needs to be activated in the column definition as well"
   ),
-  autoScrollToId: import_ds_utilities.PropTypes.any.description("AutoScroll to row ID"),
-  selectAll: import_ds_utilities.PropTypes.bool.description("Whether all rows are selected or not"),
-  selectedRows: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.object).description(" Defines the selected rows"),
-  filters: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.object).description("Filters to be applied to the grid"),
-  onExpandRow: import_ds_utilities.PropTypes.func.description("Handler when user expands a row"),
-  onExpandChange: import_ds_utilities.PropTypes.func.description("Handler when user expands a row with full expand state"),
-  onToggleExpand: import_ds_utilities.PropTypes.func.description("Handler when user expands a row (old API)"),
-  onAddFilter: import_ds_utilities.PropTypes.func.description("Handler when user adds a filter"),
-  onRemoveFilter: import_ds_utilities.PropTypes.func.description("Handler when user removes a filter"),
-  onFiltersChange: import_ds_utilities.PropTypes.func.description("Handler when the filters state has changed "),
-  onDefaultFiltersLoad: import_ds_utilities.PropTypes.func.description("Handler when the default filters load. Returns the rows rendered"),
-  onMoveColumnOver: import_ds_utilities.PropTypes.func.description("Handler when column move is over another column"),
-  onMoveColumnStart: import_ds_utilities.PropTypes.func.description(" Handler when column move starts"),
-  onMoveColumnEnd: import_ds_utilities.PropTypes.func.description("Handler when column move ends"),
-  showFilterBar: import_ds_utilities.PropTypes.bool.description("Whether to show the filter bar or not"),
-  multiSelectFilterOptions: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.object).description(
+  /** AutoScroll to row ID */
+  autoScrollToId: import_ds_props_helpers.PropTypes.any.description("AutoScroll to row ID"),
+  /** Whether all rows are selected or not */
+  selectAll: import_ds_props_helpers.PropTypes.bool.description("Whether all rows are selected or not"),
+  /** Defines the selected rows */
+  selectedRows: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.object).description(" Defines the selected rows"),
+  /** Filters to be applied to the grid */
+  filters: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.object).description("Filters to be applied to the grid"),
+  // todo: define params for handlers
+  /** Handler when user expands a row */
+  onExpandRow: import_ds_props_helpers.PropTypes.func.description("Handler when user expands a row"),
+  /** Handler when user expands a row with full expand state */
+  onExpandChange: import_ds_props_helpers.PropTypes.func.description("Handler when user expands a row with full expand state"),
+  /** Handler when user expands a row (old API) */
+  onToggleExpand: import_ds_props_helpers.PropTypes.func.description("Handler when user expands a row (old API)"),
+  /** Handler when user adds a filter */
+  onAddFilter: import_ds_props_helpers.PropTypes.func.description("Handler when user adds a filter"),
+  /** Handler when user removes a filter */
+  onRemoveFilter: import_ds_props_helpers.PropTypes.func.description("Handler when user removes a filter"),
+  /** Handler when the filters state has changed */
+  onFiltersChange: import_ds_props_helpers.PropTypes.func.description("Handler when the filters state has changed "),
+  /** Handler when the default filters load. Returns the rows rendered */
+  onDefaultFiltersLoad: import_ds_props_helpers.PropTypes.func.description("Handler when the default filters load. Returns the rows rendered"),
+  /** Handler when column move is over another column */
+  onMoveColumnOver: import_ds_props_helpers.PropTypes.func.description("Handler when column move is over another column"),
+  /** Handler when column move starts */
+  onMoveColumnStart: import_ds_props_helpers.PropTypes.func.description(" Handler when column move starts"),
+  /** Handler when column move ends */
+  onMoveColumnEnd: import_ds_props_helpers.PropTypes.func.description("Handler when column move ends"),
+  /** Whether to show the filter bar or not */
+  showFilterBar: import_ds_props_helpers.PropTypes.bool.description("Whether to show the filter bar or not"),
+  /** Custom option for the header with multi select */
+  multiSelectFilterOptions: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.object).description(
     "Custom option for the header with multi select"
   ),
-  multiSelectFilterLabel: import_ds_utilities.PropTypes.string.description("Label to the header column for multi select"),
-  multiSelectFilterLabels: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.string).description("Labels for multi selects"),
-  aggregations: import_ds_utilities.PropTypes.object.description("").deprecated(""),
-  groupingColumn: import_ds_utilities.PropTypes.string.description("Column which rows would be grouped by").deprecated(""),
-  groupedBy: import_ds_utilities.PropTypes.string.description("group by"),
-  sortingColumns: import_ds_utilities.PropTypes.objectOf(
-    import_ds_utilities.PropTypes.shape({
-      direction: import_ds_utilities.PropTypes.oneOf(["asc", "desc"]),
-      position: import_ds_utilities.PropTypes.number
+  /** Label to the header column for multi select */
+  multiSelectFilterLabel: import_ds_props_helpers.PropTypes.string.description("Label to the header column for multi select"),
+  /** Labels for multi selects */
+  multiSelectFilterLabels: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.string).description("Labels for multi selects"),
+  /** unstable */
+  aggregations: import_ds_props_helpers.PropTypes.object.description("").deprecated(""),
+  /** unstable */
+  /** Column which rows would be grouped by */
+  groupingColumn: import_ds_props_helpers.PropTypes.string.description("Column which rows would be grouped by").deprecated(""),
+  /** group by */
+  groupedBy: import_ds_props_helpers.PropTypes.string.description("group by"),
+  /** Defines the sorting state */
+  sortingColumns: import_ds_props_helpers.PropTypes.objectOf(
+    import_ds_props_helpers.PropTypes.shape({
+      // eslint-disable-next-line react/no-unused-prop-types
+      direction: import_ds_props_helpers.PropTypes.oneOf(["asc", "desc"]),
+      // eslint-disable-next-line react/no-unused-prop-types
+      position: import_ds_props_helpers.PropTypes.number
     })
   ).description("Defines the sorting state"),
-  visibleColumns: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.string).description("Visible columns property"),
-  minPerPage: import_ds_utilities.PropTypes.string.description("Pagination: Minimum number of rows per page"),
-  maxPerPage: import_ds_utilities.PropTypes.string.description("Pagination: Maximum number of rows per page"),
-  onPerPageChange: import_ds_utilities.PropTypes.string.description("Pagination: Handler when user changes the amount of rows per page"),
-  onPageChange: import_ds_utilities.PropTypes.string.description("Pagination: Handler when user changes the page"),
-  pagination: import_ds_utilities.PropTypes.shape({
-    page: import_ds_utilities.PropTypes.number,
-    perPage: import_ds_utilities.PropTypes.number
+  /** Visible columns property */
+  visibleColumns: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.string).description("Visible columns property"),
+  /** Pagination: Minimum number of rows per page */
+  minPerPage: import_ds_props_helpers.PropTypes.string.description("Pagination: Minimum number of rows per page"),
+  /** Pagination: Maximum number of rows per page */
+  maxPerPage: import_ds_props_helpers.PropTypes.string.description("Pagination: Maximum number of rows per page"),
+  /** Pagination: Handler when user changes the amount of rows per page */
+  onPerPageChange: import_ds_props_helpers.PropTypes.string.description("Pagination: Handler when user changes the amount of rows per page"),
+  /** Pagination: Handler when user changes the page */
+  onPageChange: import_ds_props_helpers.PropTypes.string.description("Pagination: Handler when user changes the page"),
+  /** Pagination state */
+  pagination: import_ds_props_helpers.PropTypes.shape({
+    // eslint-disable-next-line react/no-unused-prop-types
+    page: import_ds_props_helpers.PropTypes.number,
+    // eslint-disable-next-line react/no-unused-prop-types
+    perPage: import_ds_props_helpers.PropTypes.number
   }).description("pagination state"),
-  showHeader: import_ds_utilities.PropTypes.bool.description("Whether to show the header or not"),
-  fixedHeader: import_ds_utilities.PropTypes.bool.description("Whether to header is fixed or not"),
-  height: import_ds_utilities.PropTypes.number.description("Defines the height of the DataGrid"),
-  minColumnWidth: import_ds_utilities.PropTypes.number.description("General min column width for all the columns "),
-  showRowsLoader: import_ds_utilities.PropTypes.bool.description("Whether to show a loader instead of the rows or not"),
-  showSelectHighlight: import_ds_utilities.PropTypes.bool.description("When a user selects a row, that row get highlighted"),
-  showSelectColumn: import_ds_utilities.PropTypes.bool.description(
+  /** Whether to show the header or not */
+  showHeader: import_ds_props_helpers.PropTypes.bool.description("Whether to show the header or not"),
+  /** Whether to header is fixed or not */
+  fixedHeader: import_ds_props_helpers.PropTypes.bool.description("Whether to header is fixed or not"),
+  /** Defines the height of the DataGrid */
+  height: import_ds_props_helpers.PropTypes.number.description("Defines the height of the DataGrid"),
+  /** General min column width for all the columns */
+  minColumnWidth: import_ds_props_helpers.PropTypes.number.description("General min column width for all the columns "),
+  /** Whether to show a loader instead of the rows or not */
+  showRowsLoader: import_ds_props_helpers.PropTypes.bool.description("Whether to show a loader instead of the rows or not"),
+  /** When a user selects a row, that row get highlighted */
+  showSelectHighlight: import_ds_props_helpers.PropTypes.bool.description("When a user selects a row, that row get highlighted"),
+  /** Whether to show the select column when the selection feature is active */
+  showSelectColumn: import_ds_props_helpers.PropTypes.bool.description(
     "Whether to show the select column when the selection feature is active"
   ),
-  selectColumnSortable: import_ds_utilities.PropTypes.bool.description("activates sortable feature to selection column"),
-  selectColumnFilterable: import_ds_utilities.PropTypes.bool.description("Activates filterable feature to selection column"),
-  selectionColumnDefinition: import_ds_utilities.PropTypes.object.description("Define the definition for the selection column"),
-  renderToolbar: import_ds_utilities.PropTypes.func.description("Function that returns a toolbar to show when the user hovers the row"),
-  toolbarDelayClose: import_ds_utilities.PropTypes.number.description(" Timeout to close the toolbar"),
-  renderFilterToolbar: import_ds_utilities.PropTypes.func.description("Function that returns a toolbar in the FilterBar component"),
-  multiSelectComponent: import_ds_utilities.PropTypes.element.description("Custom component for the selection"),
-  normalizeDataKeys: import_ds_utilities.PropTypes.bool.description("Normalize the keys of the data received and the columns"),
-  noResultsRender: import_ds_utilities.PropTypes.func.description("Function that returns an Element when there are no rows"),
-  fluidHeight: import_ds_utilities.PropTypes.bool.description("The height of the DataGrid will expand to its container"),
-  customHandlers: import_ds_utilities.PropTypes.object.description("").deprecated(""),
-  onFilterMenuClose: import_ds_utilities.PropTypes.func.description("Handler when user closes the filter menu"),
-  onFilterMenuOpen: import_ds_utilities.PropTypes.func.description("Handler when user opens the filter menu"),
-  onReorder: import_ds_utilities.PropTypes.func.description("handler when user drags a row "),
-  onMoveRowEnd: import_ds_utilities.PropTypes.func.description("Handler when user stops dragging a row "),
-  onMoveRowStart: import_ds_utilities.PropTypes.func.description("Handler when user starts dragging a row"),
-  onColumnResize: import_ds_utilities.PropTypes.func.description("Handler when user has resized a column"),
-  onFilter: import_ds_utilities.PropTypes.func.description("Handler when user filters by a column"),
-  onSort: import_ds_utilities.PropTypes.func.description("Handler when user sorts by a column "),
-  onColumnRowEdited: import_ds_utilities.PropTypes.func.description("Handler when user has edited a cell row"),
-  onColumnRowEdit: import_ds_utilities.PropTypes.func.description(" Handler when user activates the cell row editing functionality"),
-  onSelectRow: import_ds_utilities.PropTypes.func.description("Handler when user selects a row"),
-  onSelectAll: import_ds_utilities.PropTypes.func.description("Handler when user checks the selection header controller"),
-  getData: import_ds_utilities.PropTypes.func.description("Handler to get more data when infinite scroll is activated"),
-  onInfiniteScrolling: import_ds_utilities.PropTypes.func.description(
+  /** Activates sortable feature to selection column */
+  selectColumnSortable: import_ds_props_helpers.PropTypes.bool.description("activates sortable feature to selection column"),
+  /** Activates filterable feature to selection column */
+  selectColumnFilterable: import_ds_props_helpers.PropTypes.bool.description("Activates filterable feature to selection column"),
+  /** Define the definition for the selection column */
+  selectionColumnDefinition: import_ds_props_helpers.PropTypes.object.description("Define the definition for the selection column"),
+  /** Function that returns a toolbar to show when the user hovers the row */
+  renderToolbar: import_ds_props_helpers.PropTypes.func.description("Function that returns a toolbar to show when the user hovers the row"),
+  /** Timeout to close the toolbar */
+  toolbarDelayClose: import_ds_props_helpers.PropTypes.number.description(" Timeout to close the toolbar"),
+  /** Function that returns a toolbar in the FilterBar component */
+  renderFilterToolbar: import_ds_props_helpers.PropTypes.func.description("Function that returns a toolbar in the FilterBar component"),
+  /** Custom component for the selection */
+  multiSelectComponent: import_ds_props_helpers.PropTypes.element.description("Custom component for the selection"),
+  /** Normalize the keys of the data received and the columns */
+  normalizeDataKeys: import_ds_props_helpers.PropTypes.bool.description("Normalize the keys of the data received and the columns"),
+  /** Function that returns an Element when there are no rows */
+  noResultsRender: import_ds_props_helpers.PropTypes.func.description("Function that returns an Element when there are no rows"),
+  /** The height of the DataGrid will expand to its container */
+  fluidHeight: import_ds_props_helpers.PropTypes.bool.description("The height of the DataGrid will expand to its container"),
+  /** @deprecated */
+  customHandlers: import_ds_props_helpers.PropTypes.object.description("").deprecated(""),
+  /** Handler when user closes the filter menu */
+  onFilterMenuClose: import_ds_props_helpers.PropTypes.func.description("Handler when user closes the filter menu"),
+  /** Handler when user opens the filter menu */
+  onFilterMenuOpen: import_ds_props_helpers.PropTypes.func.description("Handler when user opens the filter menu"),
+  /** Handler when user drags a row */
+  onReorder: import_ds_props_helpers.PropTypes.func.description("handler when user drags a row "),
+  /** Handler when user stops dragging a row */
+  onMoveRowEnd: import_ds_props_helpers.PropTypes.func.description("Handler when user stops dragging a row "),
+  /** Handler when user starts dragging a row */
+  onMoveRowStart: import_ds_props_helpers.PropTypes.func.description("Handler when user starts dragging a row"),
+  /** Handler when user has resized a column */
+  onColumnResize: import_ds_props_helpers.PropTypes.func.description("Handler when user has resized a column"),
+  /** Handler when user filters by a column */
+  onFilter: import_ds_props_helpers.PropTypes.func.description("Handler when user filters by a column"),
+  /** Handler when user sorts by a column */
+  onSort: import_ds_props_helpers.PropTypes.func.description("Handler when user sorts by a column "),
+  /** Handler when user has edited a cell row */
+  onColumnRowEdited: import_ds_props_helpers.PropTypes.func.description("Handler when user has edited a cell row"),
+  /** Handler when user activates the cell row editing functionality */
+  onColumnRowEdit: import_ds_props_helpers.PropTypes.func.description(" Handler when user activates the cell row editing functionality"),
+  /** Handler when user selects a row */
+  onSelectRow: import_ds_props_helpers.PropTypes.func.description("Handler when user selects a row"),
+  /** Handler when user checks the selection header controller */
+  onSelectAll: import_ds_props_helpers.PropTypes.func.description("Handler when user checks the selection header controller"),
+  /** Handler to get more data when infinite scroll is activated */
+  getData: import_ds_props_helpers.PropTypes.func.description("Handler to get more data when infinite scroll is activated"),
+  /** Handler to get more data when infinite scroll is activated without side-effect */
+  onInfiniteScrolling: import_ds_props_helpers.PropTypes.func.description(
     "Handler to get more data when infinite scroll is activated without side-effect"
   ),
-  serverSideData: import_ds_utilities.PropTypes.bool.description("Flag to override empty sort when data is from server"),
-  virtualized: import_ds_utilities.PropTypes.bool.description("Flag to force virtualization. Not used"),
-  numRowsVisible: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.number, import_ds_utilities.PropTypes.oneOf(["all"])]).description("Number of rows visible. Not used"),
-  isColumnEditable: import_ds_utilities.PropTypes.func.description("Callback to check if column is editable"),
-  groupedRows: import_ds_utilities.PropTypes.bool.description("Flag for groupedRows"),
-  groupedRowsRenderHeader: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.func, import_ds_utilities.PropTypes.element]).description("Header for grouped rows"),
-  isDataSorted: import_ds_utilities.PropTypes.bool.description("Once activated will disable the internal logic for sorting"),
-  isDataFiltered: import_ds_utilities.PropTypes.bool.description("Once activated will disable the internal logic for filtering"),
-  rowSize: import_ds_utilities.PropTypes.oneOf(import_rowSizes.RowSizesOptionsArr).description("Change row size"),
-  wrapText: import_ds_utilities.PropTypes.bool.description("Whether to wrap the text of the data grid or not"),
-  renderExpandedDetails: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.func, import_ds_utilities.PropTypes.element]).description(
+  /** Flag to override empty sort when data is from server */
+  serverSideData: import_ds_props_helpers.PropTypes.bool.description("Flag to override empty sort when data is from server"),
+  /** Flag to force virtualization. Not used */
+  virtualized: import_ds_props_helpers.PropTypes.bool.description("Flag to force virtualization. Not used"),
+  /** Number of rows visible. Not used */
+  numRowsVisible: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.number, import_ds_props_helpers.PropTypes.oneOf(["all"])]).description(
+    "Number of rows visible. Not used"
+  ),
+  /** Callback to check if column is editable */
+  isColumnEditable: import_ds_props_helpers.PropTypes.func.description("Callback to check if column is editable"),
+  /** Flag for groupedRows */
+  groupedRows: import_ds_props_helpers.PropTypes.bool.description("Flag for groupedRows"),
+  /** Header for grouped rows */
+  groupedRowsRenderHeader: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.func, import_ds_props_helpers.PropTypes.element]).description(
+    "Header for grouped rows"
+  ),
+  /** Once activated will disable the internal logic for sorting */
+  isDataSorted: import_ds_props_helpers.PropTypes.bool.description("Once activated will disable the internal logic for sorting"),
+  /** Once activated will disable the internal logic for filtering */
+  isDataFiltered: import_ds_props_helpers.PropTypes.bool.description("Once activated will disable the internal logic for filtering"),
+  /** Change row size */
+  rowSize: import_ds_props_helpers.PropTypes.oneOf(import_rowSizes.RowSizesOptionsArr).description("Change row size"),
+  /** Whether to wrap the text of the data grid or not */
+  wrapText: import_ds_props_helpers.PropTypes.bool.description("Whether to wrap the text of the data grid or not"),
+  /** Element to render expanded details */
+  renderExpandedDetails: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.func, import_ds_props_helpers.PropTypes.element]).description(
     "Element to render expanded details"
   ),
-  detailColumns: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.object).description("Columns to render on the details of an expanded row"),
-  expandable: import_ds_utilities.PropTypes.bool.description("Flag to enable the expandable feature "),
-  getChildrenRows: import_ds_utilities.PropTypes.func.description("Callback to get the row children"),
-  expandableSubrowsVisible: import_ds_utilities.PropTypes.number.description("Number of rows visible on the details of an expanded row"),
-  renderRowDetails: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.func, import_ds_utilities.PropTypes.element]).description(
+  /** Columns to render on the details of an expanded row */
+  detailColumns: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.object).description("Columns to render on the details of an expanded row"),
+  /** Flag to enable the expandable feature */
+  expandable: import_ds_props_helpers.PropTypes.bool.description("Flag to enable the expandable feature "),
+  /** Callback to get the row children */
+  getChildrenRows: import_ds_props_helpers.PropTypes.func.description("Callback to get the row children"),
+  /** Number of rows visible on the details of an expanded row */
+  expandableSubrowsVisible: import_ds_props_helpers.PropTypes.number.description("Number of rows visible on the details of an expanded row"),
+  /** Element to render inside expanded row */
+  renderRowDetails: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.func, import_ds_props_helpers.PropTypes.element]).description(
     "Element to render inside expanded row"
   ),
-  getExpandedRowSize: import_ds_utilities.PropTypes.func.description("Callback to get the expanded row size"),
-  getExpandedRowMinSize: import_ds_utilities.PropTypes.func.description("Callback to get the expanded row minimum size"),
-  subRowSize: import_ds_utilities.PropTypes.oneOf(import_rowSizes.RowSizesOptionsArr).description("Change expanded/details rows size"),
-  bindColumnsSizeTo: import_ds_utilities.PropTypes.string.description("Bind the column size to another grid instance"),
-  bindRowSizeTo: import_ds_utilities.PropTypes.string.description("Bind the row size to another grid instance"),
-  onToggleShowAllRows: import_ds_utilities.PropTypes.func.description("Handler when toggle show all is clicked"),
-  expandedRows: import_ds_utilities.PropTypes.object.description("Expanded row state"),
-  autoHeight: import_ds_utilities.PropTypes.bool.description("Flag to enable autoheight"),
-  noColumnsPlaceholder: import_ds_utilities.PropTypes.oneOfType([import_ds_utilities.PropTypes.string, import_ds_utilities.PropTypes.element]).description(
+  /** Callback to get the expanded row size */
+  getExpandedRowSize: import_ds_props_helpers.PropTypes.func.description("Callback to get the expanded row size"),
+  /** Callback to get the expanded row minimum size */
+  getExpandedRowMinSize: import_ds_props_helpers.PropTypes.func.description("Callback to get the expanded row minimum size"),
+  /** Change expanded/details rows size */
+  subRowSize: import_ds_props_helpers.PropTypes.oneOf(import_rowSizes.RowSizesOptionsArr).description("Change expanded/details rows size"),
+  /** Bind the column size to another grid instance */
+  bindColumnsSizeTo: import_ds_props_helpers.PropTypes.string.description("Bind the column size to another grid instance"),
+  /** Bind the row size to another grid instance */
+  bindRowSizeTo: import_ds_props_helpers.PropTypes.string.description("Bind the row size to another grid instance"),
+  /** Handler when toggle show all is clicked  */
+  onToggleShowAllRows: import_ds_props_helpers.PropTypes.func.description("Handler when toggle show all is clicked"),
+  /** Expanded row state */
+  expandedRows: import_ds_props_helpers.PropTypes.object.description("Expanded row state"),
+  /** Flag to enable autoheight */
+  autoHeight: import_ds_props_helpers.PropTypes.bool.description("Flag to enable autoheight"),
+  /** Placeholder rendered when no columns are visible */
+  noColumnsPlaceholder: import_ds_props_helpers.PropTypes.oneOfType([import_ds_props_helpers.PropTypes.string, import_ds_props_helpers.PropTypes.element]).description(
     "Placeholder rendered when no columns are visible"
   ),
-  plugins: import_ds_utilities.PropTypes.arrayOf(import_ds_utilities.PropTypes.any).description("Plugin additional array")
+  /** Plugin additional array */
+  plugins: import_ds_props_helpers.PropTypes.arrayOf(import_ds_props_helpers.PropTypes.any).description("Plugin additional array")
 };
 DSDataGrids.propTypes = props;
 DSDataGrids.displayName = "DSDataGrids";
-const DSDataGridsWithSchema = (0, import_ds_utilities.describe)(DSDataGrids);
+const DSDataGridsWithSchema = (0, import_ds_props_helpers.describe)(DSDataGrids);
 DSDataGridsWithSchema.propTypes = props;
 var DSDataGrid_default = DSDataGrids;
 //# sourceMappingURL=DSDataGrid.js.map