@rafal.lemieszewski/tide-ui 0.36.1 → 0.38.0

package/dist/components/ui/data-table.d.ts

@@ -105,6 +105,37 @@ export interface DataTableProps<TData, TValue> {
     enableGrouping?: boolean;
     groupedColumnMode?: 'reorder' | 'remove' | false;
     enableManualGrouping?: boolean;
+    /**
+     * When grouping is enabled, specifies which column should be used to
+     * render the parent/group rows instead of the grouped column itself.
+     *
+     * Use case: Group by one field (e.g., "fixtureId") but display another
+     * field's aggregatedCell in parent rows (e.g., "orderId").
+     *
+     * The specified column should define an aggregatedCell in its columnDef
+     * to customize how the group header is rendered. If no aggregatedCell is
+     * defined, it will fall back to showing the value from the first row.
+     *
+     * @example
+     * grouping={["fixtureId"]}
+     * groupDisplayColumn="orderId"
+     * columnVisibility={{ fixtureId: false }}
+     */
+    groupDisplayColumn?: string;
+    /**
+     * When grouping is enabled, hides child rows for groups that contain
+     * only a single item. This flattens single-item groups to show only
+     * the parent row, reducing visual redundancy.
+     *
+     * When enabled:
+     * - Groups with 1 item: Only parent row shown (not expandable)
+     * - Groups with 2+ items: Parent + expandable children shown normally
+     *
+     * @default false
+     * @example
+     * hideChildrenForSingleItemGroups={true}
+     */
+    hideChildrenForSingleItemGroups?: boolean;
     enableRowPinning?: boolean;
     keepPinnedRows?: boolean;
     enableVirtualization?: boolean;
@@ -140,7 +171,7 @@ export interface DataTableProps<TData, TValue> {
     renderSectionHeaderRow?: (row: any) => React.ReactNode | null;
     autoExpandChildren?: boolean;
 }
-export declare function DataTable<TData, TValue>({ columns, data, searchKey, searchPlaceholder, title, className, stickyHeader, stickyFirstColumn, stickyLeftColumns, stickyRightColumns, enableResponsiveWrapper, showScrollIndicators, isLoading, loadingRowCount, borderStyle, enableGlobalSearch, globalSearchPlaceholder, enableGlobalFaceting, enableColumnResizing, columnResizeMode, enableColumnResizePersistence, storageKey, enableExpanding, getSubRows, enableGrouping, groupedColumnMode, enableManualGrouping, enableRowPinning, keepPinnedRows, enableVirtualization, nestedHeaders, enableNestedHeaders, enableColumnOrdering, enableRowSelection, showHeader, showPagination, onTableReady, initialState, sorting: controlledSorting, onSortingChange: onControlledSortingChange, columnVisibility: controlledColumnVisibility, onColumnVisibilityChange: onControlledColumnVisibilityChange, grouping: controlledGrouping, onGroupingChange: onControlledGroupingChange, columnOrder: controlledColumnOrder, onColumnOrderChange: onControlledColumnOrderChange, columnSizing: controlledColumnSizing, onColumnSizingChange: onControlledColumnSizingChange, renderSectionHeaderRow, autoExpandChildren, }: DataTableProps<TData, TValue>): import("react/jsx-runtime").JSX.Element;
+export declare function DataTable<TData, TValue>({ columns, data, searchKey, searchPlaceholder, title, className, stickyHeader, stickyFirstColumn, stickyLeftColumns, stickyRightColumns, enableResponsiveWrapper, showScrollIndicators, isLoading, loadingRowCount, borderStyle, enableGlobalSearch, globalSearchPlaceholder, enableGlobalFaceting, enableColumnResizing, columnResizeMode, enableColumnResizePersistence, storageKey, enableExpanding, getSubRows, enableGrouping, groupedColumnMode, enableManualGrouping, groupDisplayColumn, hideChildrenForSingleItemGroups, enableRowPinning, keepPinnedRows, enableVirtualization, nestedHeaders, enableNestedHeaders, enableColumnOrdering, enableRowSelection, showHeader, showPagination, onTableReady, initialState, sorting: controlledSorting, onSortingChange: onControlledSortingChange, columnVisibility: controlledColumnVisibility, onColumnVisibilityChange: onControlledColumnVisibilityChange, grouping: controlledGrouping, onGroupingChange: onControlledGroupingChange, columnOrder: controlledColumnOrder, onColumnOrderChange: onControlledColumnOrderChange, columnSizing: controlledColumnSizing, onColumnSizingChange: onControlledColumnSizingChange, renderSectionHeaderRow, autoExpandChildren, }: DataTableProps<TData, TValue>): import("react/jsx-runtime").JSX.Element;
 export { DataTableColumnHeader, DataTableFilter, DataTableToolbar, DataTablePagination, DataTableSkeleton, fuzzyFilter, multiSelectFilter };
 export { useReactTable } from '@tanstack/react-table';
 export type { SortingState, ColumnFiltersState, VisibilityState, ExpandedState, GroupingState, ColumnOrderState, FilterFn, ColumnResizeMode, } from '@tanstack/react-table';