@bmsuisse/datagrid 0.39.0 → 0.41.0

package/dist/index.d.ts

@@ -1687,6 +1687,23 @@ interface DataGridProps<TRow> {
      */
     selectedIds?: ReadonlySet<string>;
     onSelectedIdsChange?: (ids: ReadonlySet<string>) => void;
+    /**
+     * `"multiple"` (default) renders a checkbox per row plus a select-all in the
+     * header. `"single"` renders a radio per row instead, selects exactly one
+     * row (choosing another replaces it; a radio can't be cleared by clicking
+     * it again), and leaves the header cell empty. Setting `"single"` shows the
+     * selection column even when neither `selectedIds` nor `headerActions` is
+     * supplied; the selection itself is still read through `selectedIds` /
+     * `onSelectedIdsChange`, which hold at most one id in this mode.
+     */
+    selectionMode?: "multiple" | "single";
+    /**
+     * Caps the height of the scroll container (px number or any CSS length such
+     * as `"65vh"`) without needing `virtualize` — the header stays sticky while
+     * the rows scroll under it. Ignored when `virtualize` is active, which uses
+     * `virtualize.maxBodyHeight` instead. Omit for a grid that grows with its rows.
+     */
+    maxHeight?: number | string;
     /**
      * Extra props (className, onClick, data-* attributes, etc.) spread onto a
      * row's own `<tr>`. Applied AFTER `<DataGrid>`'s own `data-testid`/
@@ -1838,7 +1855,7 @@ interface DataGridProps<TRow> {
  * (`"server"`). Column filter UI defaults to the type-appropriate widget
  * from `src/filter` unless a column supplies its own `cell` renderer.
  */
-declare function DataGrid<TRow extends RowData>({ columns, dataSource, getRowId, rowActions, headerActions, enableMultiSort, initialState, columnVisibility, renderDetail, enableColumnResizing, columnResizeMode, columnSizing: controlledColumnSizing, onColumnSizingChange, virtualize, showPagination, getRowProps, getRowTestId, gridState, onGridStateChange, selectedIds: controlledSelectedIds, onSelectedIdsChange, testId, loading: loadingProp, error, onRetry, statusLabels, groupBy, renderGroupHeader, defaultGroupsExpanded, expandedGroups: controlledExpandedGroups, onExpandedGroupsChange, zebra, showTotals, editing, cellEditing, filterLabels, }: DataGridProps<TRow>): ReactElement;
+declare function DataGrid<TRow extends RowData>({ columns, dataSource, getRowId, rowActions, headerActions, enableMultiSort, initialState, columnVisibility, renderDetail, enableColumnResizing, columnResizeMode, columnSizing: controlledColumnSizing, onColumnSizingChange, virtualize, showPagination, getRowProps, getRowTestId, gridState, onGridStateChange, selectedIds: controlledSelectedIds, onSelectedIdsChange, selectionMode, maxHeight, testId, loading: loadingProp, error, onRetry, statusLabels, groupBy, renderGroupHeader, defaultGroupsExpanded, expandedGroups: controlledExpandedGroups, onExpandedGroupsChange, zebra, showTotals, editing, cellEditing, filterLabels, }: DataGridProps<TRow>): ReactElement;
 
 interface GridStateController {
     state: GridState;
@@ -2235,6 +2252,20 @@ interface TreeDataGridProps<TRow> extends TreeAccessors<TRow> {
      * bottom) but neither requires the other. Defaults to false.
      */
     showTotals?: boolean;
+    /**
+     * Opt-in: defaults to false. Gives every header a drag handle (and
+     * ArrowLeft/ArrowRight keyboard resize) on its trailing edge, and switches
+     * the table to `table-layout: fixed` so a dragged width is exactly the
+     * rendered width. A column without an explicit `width` stays flexible and
+     * absorbs the leftover space until it is resized itself.
+     */
+    enableColumnResizing?: boolean;
+    /**
+     * Controlled column widths in px, keyed by column id. Both must be supplied
+     * together to control it — omit both for `<TreeDataGrid>` to own the state.
+     */
+    columnSizing?: ColumnSizingState;
+    onColumnSizingChange?: (sizing: ColumnSizingState) => void;
     /**
      * Enables the same built-in inline-editing workflow `<DataGrid>` has:
      * any column with `editable` set renders as an interactive editor
@@ -2263,7 +2294,7 @@ interface TreeDataGridProps<TRow> extends TreeAccessors<TRow> {
  * column's cell matches `treeColumnId` (defaults to `columns[0]`); every
  * other column renders exactly like it would in `<DataGrid>`.
  */
-declare function TreeDataGrid<TRow>({ columns, data, loading, error, onRetry, statusLabels, treeColumnId, columnVisibility, getRowId, getChildren, hasChildren, onLoadChildren, initialExpandedLevel, expanded: controlledExpanded, onExpandedChange, childrenMap: controlledChildrenMap, onChildrenMapChange, indentSize, getRowProps, getRowTestId, rowActions, virtualizeThreshold, estimatedRowHeight, maxBodyHeight, testId, selectedIds: controlledSelectedIds, onSelectedIdsChange, getRowSelectionState, isRowSelectionDisabled, groupBy, renderGroupHeader, defaultGroupsExpanded, expandedGroups: controlledExpandedGroups, onExpandedGroupsChange, zebra, showTotals, editing, }: TreeDataGridProps<TRow>): ReactElement;
+declare function TreeDataGrid<TRow>({ columns, data, loading, error, onRetry, statusLabels, treeColumnId, columnVisibility, getRowId, getChildren, hasChildren, onLoadChildren, initialExpandedLevel, expanded: controlledExpanded, onExpandedChange, childrenMap: controlledChildrenMap, onChildrenMapChange, indentSize, getRowProps, getRowTestId, rowActions, virtualizeThreshold, estimatedRowHeight, maxBodyHeight, testId, selectedIds: controlledSelectedIds, onSelectedIdsChange, getRowSelectionState, isRowSelectionDisabled, groupBy, renderGroupHeader, defaultGroupsExpanded, expandedGroups: controlledExpandedGroups, onExpandedGroupsChange, zebra, showTotals, editing, enableColumnResizing, columnSizing: controlledColumnSizing, onColumnSizingChange, }: TreeDataGridProps<TRow>): ReactElement;
 
 interface FlatTreeRow<TRow> {
     row: TRow;