@tanstack/table-core 8.1.4 → 8.2.2

package/build/types/index.d.ts

@@ -8,43 +8,43 @@
  *
  * @license MIT
  */
-declare type CoreCell<TData extends RowData> = {
+declare type CoreCell<TData extends RowData, TValue> = {
     id: string;
-    getValue: () => any;
-    renderValue: () => unknown;
+    getValue: <TTValue = TValue>() => TTValue;
+    renderValue: <TTValue = TValue>() => TTValue | null;
     row: Row<TData>;
-    column: Column<TData>;
+    column: Column<TData, TValue>;
     getContext: () => {
         table: Table<TData>;
-        column: Column<TData>;
+        column: Column<TData, TValue>;
         row: Row<TData>;
-        cell: Cell<TData>;
-        getValue: () => any;
-        renderValue: () => any;
+        cell: Cell<TData, TValue>;
+        getValue: <TTValue = TValue>() => TTValue;
+        renderValue: <TTValue = TValue>() => TTValue | null;
     };
 };
 
 declare type CoreHeaderGroup<TData extends RowData> = {
     id: string;
     depth: number;
-    headers: Header<TData>[];
+    headers: Header<TData, unknown>[];
 };
-declare type CoreHeader<TData extends RowData> = {
+declare type CoreHeader<TData extends RowData, TValue> = {
     id: string;
     index: number;
     depth: number;
-    column: Column<TData>;
+    column: Column<TData, TValue>;
     headerGroup: HeaderGroup<TData>;
-    subHeaders: Header<TData>[];
+    subHeaders: Header<TData, TValue>[];
     colSpan: number;
     rowSpan: number;
-    getLeafHeaders: () => Header<TData>[];
+    getLeafHeaders: () => Header<TData, unknown>[];
     isPlaceholder: boolean;
     placeholderId?: string;
     getContext: () => {
         table: Table<TData>;
-        header: Header<TData>;
-        column: Column<TData>;
+        header: Header<TData, TValue>;
+        column: Column<TData, TValue>;
     };
 };
 declare type HeadersInstance<TData extends RowData> = {
@@ -56,54 +56,54 @@ declare type HeadersInstance<TData extends RowData> = {
     getLeftFooterGroups: () => HeaderGroup<TData>[];
     getCenterFooterGroups: () => HeaderGroup<TData>[];
     getRightFooterGroups: () => HeaderGroup<TData>[];
-    getFlatHeaders: () => Header<TData>[];
-    getLeftFlatHeaders: () => Header<TData>[];
-    getCenterFlatHeaders: () => Header<TData>[];
-    getRightFlatHeaders: () => Header<TData>[];
-    getLeafHeaders: () => Header<TData>[];
-    getLeftLeafHeaders: () => Header<TData>[];
-    getCenterLeafHeaders: () => Header<TData>[];
-    getRightLeafHeaders: () => Header<TData>[];
+    getFlatHeaders: () => Header<TData, unknown>[];
+    getLeftFlatHeaders: () => Header<TData, unknown>[];
+    getCenterFlatHeaders: () => Header<TData, unknown>[];
+    getRightFlatHeaders: () => Header<TData, unknown>[];
+    getLeafHeaders: () => Header<TData, unknown>[];
+    getLeftLeafHeaders: () => Header<TData, unknown>[];
+    getCenterLeafHeaders: () => Header<TData, unknown>[];
+    getRightLeafHeaders: () => Header<TData, unknown>[];
 };
 declare const Headers: TableFeature;
-declare function buildHeaderGroups<TData extends RowData>(allColumns: Column<TData>[], columnsToGroup: Column<TData>[], table: Table<TData>, headerFamily?: 'center' | 'left' | 'right'): HeaderGroup<TData>[];
+declare function buildHeaderGroups<TData extends RowData>(allColumns: Column<TData, unknown>[], columnsToGroup: Column<TData, unknown>[], table: Table<TData>, headerFamily?: 'center' | 'left' | 'right'): HeaderGroup<TData>[];
 
 declare type CoreColumnDefType = 'data' | 'display' | 'group';
-declare type CoreColumnDefBase<TData extends RowData> = {
+declare type CoreColumnDefBase<TData extends RowData, TValue> = {
     columns?: ColumnDef<TData>[];
-    header?: ColumnDefTemplate<ReturnType<CoreHeader<TData>['getContext']>>;
-    footer?: ColumnDefTemplate<ReturnType<CoreHeader<TData>['getContext']>>;
-    cell?: ColumnDefTemplate<ReturnType<CoreCell<TData>['getContext']>>;
-    meta?: unknown;
+    header?: ColumnDefTemplate<ReturnType<CoreHeader<TData, TValue>['getContext']>>;
+    footer?: ColumnDefTemplate<ReturnType<CoreHeader<TData, TValue>['getContext']>>;
+    cell?: ColumnDefTemplate<ReturnType<CoreCell<TData, TValue>['getContext']>>;
+    meta?: ColumnMeta;
 };
-declare type CoreColumnDefDisplay<TData extends RowData> = CoreColumnDefBase<TData> & {
+declare type CoreColumnDefDisplay<TData extends RowData, TValue> = CoreColumnDefBase<TData, TValue> & {
     id: string;
 };
-declare type CoreColumnDefDisplayWithStringHeader<TData extends RowData> = CoreColumnDefBase<TData> & {
+declare type CoreColumnDefDisplayWithStringHeader<TData extends RowData, TValue> = CoreColumnDefBase<TData, TValue> & {
     header: string;
     id?: string;
 };
-declare type CoreColumnDefAccessorFn<TData extends RowData> = CoreColumnDefBase<TData> & {
-    accessorFn: AccessorFn<TData>;
+declare type CoreColumnDefAccessorFn<TData extends RowData, TValue = unknown> = CoreColumnDefBase<TData, TValue> & {
+    accessorFn: AccessorFn<TData, TValue>;
     id: string;
 };
-declare type CoreColumnDefAccessorKey<TData extends RowData> = CoreColumnDefBase<TData> & {
+declare type CoreColumnDefAccessorKey<TData extends RowData, TValue> = CoreColumnDefBase<TData, TValue> & {
     accessorKey: keyof TData;
     id?: string;
 };
-declare type CoreColumnDef<TData extends RowData> = CoreColumnDefDisplay<TData> | CoreColumnDefDisplayWithStringHeader<TData> | CoreColumnDefAccessorFn<TData> | CoreColumnDefAccessorKey<TData>;
-declare type CoreColumnDefResolved<TData extends RowData> = Partial<UnionToIntersection<CoreColumnDef<TData>>>;
-declare type CoreColumn<TData extends RowData> = {
+declare type CoreColumnDef<TData extends RowData, TValue> = CoreColumnDefDisplay<TData, TValue> | CoreColumnDefDisplayWithStringHeader<TData, TValue> | CoreColumnDefAccessorFn<TData> | CoreColumnDefAccessorKey<TData, TValue>;
+declare type CoreColumnDefResolved<TData extends RowData, TValue = unknown> = Partial<UnionToIntersection<CoreColumnDef<TData, TValue>>>;
+declare type CoreColumn<TData extends RowData, TValue> = {
     id: string;
     depth: number;
-    accessorFn?: AccessorFn<TData>;
+    accessorFn?: AccessorFn<TData, TValue>;
     columnDef: ColumnDef<TData>;
-    columns: Column<TData>[];
-    parent?: Column<TData>;
-    getFlatColumns: () => Column<TData>[];
-    getLeafColumns: () => Column<TData>[];
+    columns: Column<TData, TValue>[];
+    parent?: Column<TData, TValue>;
+    getFlatColumns: () => Column<TData, TValue>[];
+    getLeafColumns: () => Column<TData, TValue>[];
 };
-declare function createColumn<TData extends RowData>(table: Table<TData>, columnDef: ColumnDef<TData>, depth: number, parent?: Column<TData>): Column<TData>;
+declare function createColumn<TData extends RowData, TValue>(table: Table<TData>, columnDef: ColumnDef<TData>, depth: number, parent?: Column<TData, TValue>): Column<TData, TValue>;
 
 declare type VisibilityState = Record<string, boolean>;
 declare type VisibilityTableState = {
@@ -117,11 +117,11 @@ declare type VisibilityDefaultOptions = {
     onColumnVisibilityChange: OnChangeFn<VisibilityState>;
 };
 declare type VisibilityInstance<TData extends RowData> = {
-    getVisibleFlatColumns: () => Column<TData>[];
-    getVisibleLeafColumns: () => Column<TData>[];
-    getLeftVisibleLeafColumns: () => Column<TData>[];
-    getRightVisibleLeafColumns: () => Column<TData>[];
-    getCenterVisibleLeafColumns: () => Column<TData>[];
+    getVisibleFlatColumns: () => Column<TData, unknown>[];
+    getVisibleLeafColumns: () => Column<TData, unknown>[];
+    getLeftVisibleLeafColumns: () => Column<TData, unknown>[];
+    getRightVisibleLeafColumns: () => Column<TData, unknown>[];
+    getCenterVisibleLeafColumns: () => Column<TData, unknown>[];
     setColumnVisibility: (updater: Updater<VisibilityState>) => void;
     resetColumnVisibility: (defaultState?: boolean) => void;
     toggleAllColumnsVisible: (value?: boolean) => void;
@@ -133,8 +133,8 @@ declare type VisibilityColumnDef = {
     enableHiding?: boolean;
 };
 declare type VisibilityRow<TData extends RowData> = {
-    _getAllVisibleCells: () => Cell<TData>[];
-    getVisibleCells: () => Cell<TData>[];
+    _getAllVisibleCells: () => Cell<TData, unknown>[];
+    getVisibleCells: () => Cell<TData, unknown>[];
 };
 declare type VisibilityColumn = {
     getCanHide: () => boolean;
@@ -157,7 +157,7 @@ declare type ColumnOrderDefaultOptions = {
 declare type ColumnOrderInstance<TData extends RowData> = {
     setColumnOrder: (updater: Updater<ColumnOrderState>) => void;
     resetColumnOrder: (defaultState?: boolean) => void;
-    _getOrderColumnsFn: () => (columns: Column<TData>[]) => Column<TData>[];
+    _getOrderColumnsFn: () => (columns: Column<TData, unknown>[]) => Column<TData, unknown>[];
 };
 declare const Ordering: TableFeature;
 
@@ -186,17 +186,17 @@ declare type ColumnPinningColumn = {
     pin: (position: ColumnPinningPosition) => void;
 };
 declare type ColumnPinningRow<TData extends RowData> = {
-    getLeftVisibleCells: () => Cell<TData>[];
-    getCenterVisibleCells: () => Cell<TData>[];
-    getRightVisibleCells: () => Cell<TData>[];
+    getLeftVisibleCells: () => Cell<TData, unknown>[];
+    getCenterVisibleCells: () => Cell<TData, unknown>[];
+    getRightVisibleCells: () => Cell<TData, unknown>[];
 };
 declare type ColumnPinningInstance<TData extends RowData> = {
     setColumnPinning: (updater: Updater<ColumnPinningState>) => void;
     resetColumnPinning: (defaultState?: boolean) => void;
     getIsSomeColumnsPinned: (position?: ColumnPinningPosition) => boolean;
-    getLeftLeafColumns: () => Column<TData>[];
-    getRightLeafColumns: () => Column<TData>[];
-    getCenterLeafColumns: () => Column<TData>[];
+    getLeftLeafColumns: () => Column<TData, unknown>[];
+    getRightLeafColumns: () => Column<TData, unknown>[];
+    getCenterLeafColumns: () => Column<TData, unknown>[];
 };
 declare const Pinning: TableFeature;
 
@@ -228,12 +228,12 @@ declare type ResolvedColumnFilter<TData extends RowData> = {
     filterFn: FilterFn<TData>;
 };
 declare type FilterFn<TData extends RowData> = {
-    (row: Row<TData>, columnId: string, filterValue: any, addMeta: (meta: any) => void): boolean;
+    (row: Row<TData>, columnId: string, filterValue: any, addMeta: (meta: FilterMeta) => void): boolean;
     resolveFilterValue?: TransformFilterValueFn<TData>;
     autoRemove?: ColumnFilterAutoRemoveTestFn<TData>;
 };
-declare type TransformFilterValueFn<TData extends RowData> = (value: any, column?: Column<TData>) => unknown;
-declare type ColumnFilterAutoRemoveTestFn<TData extends RowData> = (value: any, column?: Column<TData>) => boolean;
+declare type TransformFilterValueFn<TData extends RowData> = (value: any, column?: Column<TData, unknown>) => unknown;
+declare type ColumnFilterAutoRemoveTestFn<TData extends RowData> = (value: any, column?: Column<TData, unknown>) => boolean;
 declare type CustomFilterFns<TData extends RowData> = Record<string, FilterFn<TData>>;
 declare type FilterFnOption<TData extends RowData> = 'auto' | BuiltInFilterFn | FilterFn<TData>;
 declare type FiltersColumnDef<TData extends RowData> = {
@@ -259,7 +259,7 @@ declare type FiltersColumn<TData extends RowData> = {
 };
 declare type FiltersRow<TData extends RowData> = {
     columnFilters: Record<string, boolean>;
-    columnFiltersMeta: Record<string, any>;
+    columnFiltersMeta: Record<string, FilterMeta>;
 };
 declare type FiltersOptions<TData extends RowData> = {
     enableFilters?: boolean;
@@ -271,7 +271,7 @@ declare type FiltersOptions<TData extends RowData> = {
     globalFilterFn?: FilterFnOption<TData>;
     onGlobalFilterChange?: OnChangeFn<any>;
     enableGlobalFilter?: boolean;
-    getColumnCanGlobalFilter?: (column: Column<TData>) => boolean;
+    getColumnCanGlobalFilter?: (column: Column<TData, unknown>) => boolean;
     getFacetedRowModel?: (table: Table<TData>, columnId: string) => () => RowModel<TData>;
     getFacetedUniqueValues?: (table: Table<TData>, columnId: string) => () => Map<any, number>;
     getFacetedMinMaxValues?: (table: Table<TData>, columnId: string) => () => undefined | [number, number];
@@ -294,7 +294,7 @@ declare type FiltersInstance<TData extends RowData> = {
     _getGlobalFacetedMinMaxValues?: () => undefined | [number, number];
 };
 declare const Filters: TableFeature;
-declare function shouldAutoRemoveFilter<TData extends RowData>(filterFn?: FilterFn<TData>, value?: any, column?: Column<TData>): boolean;
+declare function shouldAutoRemoveFilter<TData extends RowData>(filterFn?: FilterFn<TData>, value?: any, column?: Column<TData, unknown>): boolean;
 
 declare const reSplitAlphaNumeric: RegExp;
 declare const sortingFns: {
@@ -333,6 +333,7 @@ declare type SortingColumn<TData extends RowData> = {
     getAutoSortingFn: () => SortingFn<TData>;
     getAutoSortDir: () => SortDirection;
     getSortingFn: () => SortingFn<TData>;
+    getFirstSortDir: () => SortDirection;
     getNextSortingOrder: () => SortDirection | false;
     getCanSort: () => boolean;
     getCanMultiSort: () => boolean;
@@ -383,9 +384,9 @@ declare type GroupingTableState = {
 declare type AggregationFn<TData extends RowData> = (columnId: string, leafRows: Row<TData>[], childRows: Row<TData>[]) => any;
 declare type CustomAggregationFns = Record<string, AggregationFn<any>>;
 declare type AggregationFnOption<TData extends RowData> = 'auto' | BuiltInAggregationFn | AggregationFn<TData>;
-declare type GroupingColumnDef<TData extends RowData> = {
+declare type GroupingColumnDef<TData extends RowData, TValue> = {
     aggregationFn?: AggregationFnOption<TData>;
-    aggregatedCell?: ColumnDefTemplate<ReturnType<Cell<TData>['getContext']>>;
+    aggregatedCell?: ColumnDefTemplate<ReturnType<Cell<TData, TValue>['getContext']>>;
     enableGrouping?: boolean;
 };
 declare type GroupingColumn<TData extends RowData> = {
@@ -399,7 +400,7 @@ declare type GroupingColumn<TData extends RowData> = {
 };
 declare type GroupingRow = {
     groupingColumnId?: string;
-    groupingValue?: any;
+    groupingValue?: unknown;
     getIsGrouped: () => boolean;
     _groupingValuesCache: Record<string, any>;
 };
@@ -428,7 +429,7 @@ declare type GroupingInstance<TData extends RowData> = {
     _getGroupedRowModel?: () => RowModel<TData>;
 };
 declare const Grouping: TableFeature;
-declare function orderColumns<TData extends RowData>(leafColumns: Column<TData>[], grouping: string[], groupedColumnMode?: GroupingColumnMode): Column<TData>[];
+declare function orderColumns<TData extends RowData>(leafColumns: Column<TData, unknown>[], grouping: string[], groupedColumnMode?: GroupingColumnMode): Column<TData, unknown>[];
 
 declare type ExpandedStateList = Record<string, boolean>;
 declare type ExpandedState = true | Record<string, boolean>;
@@ -613,22 +614,28 @@ declare function isSubRowSelected<TData extends RowData>(row: Row<TData>, select
 declare type CoreRow<TData extends RowData> = {
     id: string;
     index: number;
-    original?: TData;
+    original: TData;
     depth: number;
-    _valuesCache: Record<string, any>;
-    getValue: (columnId: string) => any;
-    renderValue: (columnId: string) => unknown;
+    _valuesCache: Record<string, unknown>;
+    getValue: <TValue>(columnId: string) => TValue;
+    renderValue: <TValue>(columnId: string) => TValue;
     subRows: Row<TData>[];
     getLeafRows: () => Row<TData>[];
     originalSubRows?: TData[];
-    getAllCells: () => Cell<TData>[];
-    _getAllCellsByColumnId: () => Record<string, Cell<TData>>;
+    getAllCells: () => Cell<TData, unknown>[];
+    _getAllCellsByColumnId: () => Record<string, Cell<TData, unknown>>;
 };
-declare const createRow: <TData extends RowData>(table: Table<TData>, id: string, original: TData | undefined, rowIndex: number, depth: number, subRows?: Row<TData>[] | undefined) => Row<TData>;
+declare const createRow: <TData extends unknown>(table: Table<TData>, id: string, original: TData, rowIndex: number, depth: number, subRows?: Row<TData>[] | undefined) => Row<TData>;
 
+interface TableMeta {
+}
+interface ColumnMeta {
+}
+interface FilterMeta {
+}
 declare type Updater<T> = T | ((old: T) => T);
 declare type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void;
-declare type RowData = object | any[];
+declare type RowData = unknown | object | any[];
 declare type TableGenerics = {
     Row?: any;
     Value?: any;
@@ -642,20 +649,17 @@ declare type TableOptions<TData extends RowData> = PartialKeys<TableOptionsResol
 declare type TableState = CoreTableState & VisibilityTableState & ColumnOrderTableState & ColumnPinningTableState & FiltersTableState & SortingTableState & ExpandedTableState & GroupingTableState & ColumnSizingTableState & PaginationTableState & RowSelectionTableState;
 declare type InitialTableState = Partial<CoreTableState & VisibilityTableState & ColumnOrderTableState & ColumnPinningTableState & FiltersTableState & SortingTableState & ExpandedTableState & GroupingTableState & ColumnSizingTableState & PaginationInitialTableState & RowSelectionTableState>;
 declare type Row<TData extends RowData> = CoreRow<TData> & VisibilityRow<TData> & ColumnPinningRow<TData> & FiltersRow<TData> & GroupingRow & RowSelectionRow & ExpandedRow;
-declare type RowValues = {
-    [key: string]: any;
-};
 declare type RowModel<TData extends RowData> = {
     rows: Row<TData>[];
     flatRows: Row<TData>[];
     rowsById: Record<string, Row<TData>>;
 };
-declare type AccessorFn<TData extends RowData> = (originalRow: TData, index: number) => any;
+declare type AccessorFn<TData extends RowData, TValue = unknown> = (originalRow: TData, index: number) => TValue;
 declare type ColumnDefTemplate<TProps extends object> = string | ((props: TProps) => any);
-declare type ColumnDef<TData extends RowData> = CoreColumnDef<TData> & VisibilityColumnDef & ColumnPinningColumnDef & FiltersColumnDef<TData> & SortingColumnDef<TData> & GroupingColumnDef<TData> & ColumnSizingColumnDef;
-declare type Column<TData extends RowData> = CoreColumn<TData> & VisibilityColumn & ColumnPinningColumn & FiltersColumn<TData> & SortingColumn<TData> & GroupingColumn<TData> & ColumnSizingColumn;
-declare type Cell<TData extends RowData> = CoreCell<TData> & GroupingCell;
-declare type Header<TData extends RowData> = CoreHeader<TData> & ColumnSizingHeader;
+declare type ColumnDef<TData extends RowData, TValue extends any = unknown> = CoreColumnDef<TData, TValue> & VisibilityColumnDef & ColumnPinningColumnDef & FiltersColumnDef<TData> & SortingColumnDef<TData> & GroupingColumnDef<TData, TValue> & ColumnSizingColumnDef;
+declare type Column<TData extends RowData, TValue> = CoreColumn<TData, TValue> & VisibilityColumn & ColumnPinningColumn & FiltersColumn<TData> & SortingColumn<TData> & GroupingColumn<TData> & ColumnSizingColumn;
+declare type Cell<TData extends RowData, TValue> = CoreCell<TData, TValue> & GroupingCell;
+declare type Header<TData extends RowData, TValue> = CoreHeader<TData, TValue> & ColumnSizingHeader;
 declare type HeaderGroup<TData extends RowData> = CoreHeaderGroup<TData>;
 declare type NoInfer<A extends any> = [A][A extends any ? 0 : never];
 
@@ -701,7 +705,7 @@ declare type CoreOptions<TData extends RowData> = {
     initialState?: InitialTableState;
     autoResetAll?: boolean;
     mergeOptions?: (defaultOptions: TableOptions<TData>, options: Partial<TableOptions<TData>>) => TableOptions<TData>;
-    meta?: unknown;
+    meta?: TableMeta;
     getCoreRowModel: (table: Table<any>) => () => RowModel<any>;
     getSubRows?: (originalRow: TData, index: number) => undefined | TData[];
     getRowId?: (originalRow: TData, index: number, parent?: Row<TData>) => string;
@@ -725,11 +729,11 @@ declare type CoreInstance<TData extends RowData> = {
     getRow: (id: string) => Row<TData>;
     _getDefaultColumnDef: () => Partial<ColumnDef<TData>>;
     _getColumnDefs: () => ColumnDef<TData>[];
-    _getAllFlatColumnsById: () => Record<string, Column<TData>>;
-    getAllColumns: () => Column<TData>[];
-    getAllFlatColumns: () => Column<TData>[];
-    getAllLeafColumns: () => Column<TData>[];
-    getColumn: (columnId: string) => Column<TData>;
+    _getAllFlatColumnsById: () => Record<string, Column<TData, unknown>>;
+    getAllColumns: () => Column<TData, unknown>[];
+    getAllFlatColumns: () => Column<TData, unknown>[];
+    getAllLeafColumns: () => Column<TData, unknown>[];
+    getColumn: (columnId: string) => Column<TData, unknown>;
 };
 declare function createTable<TData extends RowData>(options: TableOptionsResolved<TData>): Table<TData>;
 
@@ -758,4 +762,4 @@ declare function getPaginationRowModel<TData extends RowData>(opts?: {
     initialSync: boolean;
 }): (table: Table<TData>) => () => RowModel<TData>;
 
-export { AccessorFn, AggregationFn, AggregationFnOption, AnyRender, BuiltInAggregationFn, BuiltInFilterFn, BuiltInSortingFn, Cell, Column, ColumnDef, ColumnDefTemplate, ColumnDefaultOptions, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, ColumnOrderDefaultOptions, ColumnOrderInstance, ColumnOrderOptions, ColumnOrderState, ColumnOrderTableState, ColumnPinningColumn, ColumnPinningColumnDef, ColumnPinningDefaultOptions, ColumnPinningInstance, ColumnPinningOptions, ColumnPinningPosition, ColumnPinningRow, ColumnPinningState, ColumnPinningTableState, ColumnResizeMode, ColumnSizing, ColumnSizingColumn, ColumnSizingColumnDef, ColumnSizingDefaultOptions, ColumnSizingHeader, ColumnSizingInfoState, ColumnSizingInstance, ColumnSizingOptions, ColumnSizingState, ColumnSizingTableState, ColumnSort, CoreColumn, CoreColumnDef, CoreColumnDefResolved, CoreColumnDefType, CoreHeader, CoreHeaderGroup, CoreInstance, CoreOptions, CoreRow, CoreTableState, CustomAggregationFns, CustomFilterFns, CustomSortingFns, ExpandedInstance, ExpandedOptions, ExpandedRow, ExpandedState, ExpandedStateList, ExpandedTableState, Expanding, FilterFn, FilterFnOption, Filters, FiltersColumn, FiltersColumnDef, FiltersInstance, FiltersOptions, FiltersRow, FiltersTableState, Grouping, GroupingCell, GroupingColumn, GroupingColumnDef, GroupingColumnMode, GroupingInstance, GroupingOptions, GroupingRow, GroupingState, GroupingTableState, Header, HeaderGroup, Headers, HeadersInstance, IfDefined, InitialTableState, NoInfer, OnChangeFn, Ordering, Overwrite, Pagination, PaginationDefaultOptions, PaginationInitialTableState, PaginationInstance, PaginationOptions, PaginationState, PaginationTableState, PartialKeys, Pinning, RequiredKeys, ResolvedColumnFilter, Row, RowData, RowModel, RowSelection, RowSelectionInstance, RowSelectionOptions, RowSelectionRow, RowSelectionState, RowSelectionTableState, RowValues, SortDirection, Sorting, SortingColumn, SortingColumnDef, SortingFn, SortingFnOption, SortingInstance, SortingOptions, SortingState, SortingTableState, Table, TableFeature, TableGenerics, TableOptions, TableOptionsResolved, TableState, TransformFilterValueFn, UnionToIntersection, Updater, Visibility, VisibilityColumn, VisibilityColumnDef, VisibilityDefaultOptions, VisibilityInstance, VisibilityOptions, VisibilityRow, VisibilityState, VisibilityTableState, aggregationFns, buildHeaderGroups, createColumn, createRow, createTable, defaultColumnSizing, expandRows, filterFns, flattenBy, functionalUpdate, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginationRowModel, getSortedRowModel, isFunction, isRowSelected, isSubRowSelected, makeStateUpdater, memo, noop, orderColumns, passiveEventSupported, reSplitAlphaNumeric, selectRowsFn, shouldAutoRemoveFilter, sortingFns };
+export { AccessorFn, AggregationFn, AggregationFnOption, AnyRender, BuiltInAggregationFn, BuiltInFilterFn, BuiltInSortingFn, Cell, Column, ColumnDef, ColumnDefTemplate, ColumnDefaultOptions, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, ColumnMeta, ColumnOrderDefaultOptions, ColumnOrderInstance, ColumnOrderOptions, ColumnOrderState, ColumnOrderTableState, ColumnPinningColumn, ColumnPinningColumnDef, ColumnPinningDefaultOptions, ColumnPinningInstance, ColumnPinningOptions, ColumnPinningPosition, ColumnPinningRow, ColumnPinningState, ColumnPinningTableState, ColumnResizeMode, ColumnSizing, ColumnSizingColumn, ColumnSizingColumnDef, ColumnSizingDefaultOptions, ColumnSizingHeader, ColumnSizingInfoState, ColumnSizingInstance, ColumnSizingOptions, ColumnSizingState, ColumnSizingTableState, ColumnSort, CoreColumn, CoreColumnDef, CoreColumnDefResolved, CoreColumnDefType, CoreHeader, CoreHeaderGroup, CoreInstance, CoreOptions, CoreRow, CoreTableState, CustomAggregationFns, CustomFilterFns, CustomSortingFns, ExpandedInstance, ExpandedOptions, ExpandedRow, ExpandedState, ExpandedStateList, ExpandedTableState, Expanding, FilterFn, FilterFnOption, FilterMeta, Filters, FiltersColumn, FiltersColumnDef, FiltersInstance, FiltersOptions, FiltersRow, FiltersTableState, Grouping, GroupingCell, GroupingColumn, GroupingColumnDef, GroupingColumnMode, GroupingInstance, GroupingOptions, GroupingRow, GroupingState, GroupingTableState, Header, HeaderGroup, Headers, HeadersInstance, IfDefined, InitialTableState, NoInfer, OnChangeFn, Ordering, Overwrite, Pagination, PaginationDefaultOptions, PaginationInitialTableState, PaginationInstance, PaginationOptions, PaginationState, PaginationTableState, PartialKeys, Pinning, RequiredKeys, ResolvedColumnFilter, Row, RowData, RowModel, RowSelection, RowSelectionInstance, RowSelectionOptions, RowSelectionRow, RowSelectionState, RowSelectionTableState, SortDirection, Sorting, SortingColumn, SortingColumnDef, SortingFn, SortingFnOption, SortingInstance, SortingOptions, SortingState, SortingTableState, Table, TableFeature, TableGenerics, TableMeta, TableOptions, TableOptionsResolved, TableState, TransformFilterValueFn, UnionToIntersection, Updater, Visibility, VisibilityColumn, VisibilityColumnDef, VisibilityDefaultOptions, VisibilityInstance, VisibilityOptions, VisibilityRow, VisibilityState, VisibilityTableState, aggregationFns, buildHeaderGroups, createColumn, createRow, createTable, defaultColumnSizing, expandRows, filterFns, flattenBy, functionalUpdate, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginationRowModel, getSortedRowModel, isFunction, isRowSelected, isSubRowSelected, makeStateUpdater, memo, noop, orderColumns, passiveEventSupported, reSplitAlphaNumeric, selectRowsFn, shouldAutoRemoveFilter, sortingFns };

package/build/umd/index.development.js

@@ -2353,7 +2353,12 @@
   };
 
   const datetime = (rowA, rowB, columnId) => {
-    return compareBasic(rowA.getValue(columnId).getTime(), rowB.getValue(columnId).getTime());
+    const a = rowA.getValue(columnId);
+    const b = rowB.getValue(columnId); // Can handle nullish values
+    // Use > and < because == (and ===) doesn't work with
+    // Date objects (would require calling getTime()).
+
+    return a > b ? 1 : a < b ? -1 : 0;
   };
 
   const basic = (rowA, rowB, columnId) => {
@@ -2514,18 +2519,17 @@
           // }
           // this needs to be outside of table.setSorting to be in sync with rerender
           const nextSortingOrder = column.getNextSortingOrder();
+          const hasManualValue = typeof desc !== 'undefined' && desc !== null;
           table.setSorting(old => {
-            var _table$options$enable, _table$options$enable2;
-
             // Find any existing sorting for this column
             const existingSorting = old == null ? void 0 : old.find(d => d.id === column.id);
             const existingIndex = old == null ? void 0 : old.findIndex(d => d.id === column.id);
-            const hasDescDefined = typeof desc !== 'undefined' && desc !== null;
             let newSorting = []; // What should we do with this sort action?
 
             let sortAction;
+            let nextDesc = hasManualValue ? desc : nextSortingOrder === 'desc'; // Multi-mode
 
-            if (column.getCanMultiSort() && multi) {
+            if (old != null && old.length && column.getCanMultiSort() && multi) {
               if (existingSorting) {
                 sortAction = 'toggle';
               } else {
@@ -2543,63 +2547,71 @@
             } // Handle toggle states that will remove the sorting
 
 
-            if (sortAction === 'toggle' && ( // Must be toggling
-            (_table$options$enable = table.options.enableSortingRemoval) != null ? _table$options$enable : true) && // If enableSortRemove, enable in general
-            !hasDescDefined && ( // Must not be setting desc
-            multi ? (_table$options$enable2 = table.options.enableMultiRemove) != null ? _table$options$enable2 : true : true) && // If multi, don't allow if enableMultiRemove
-            !nextSortingOrder // Finally, detect if it should indeed be removed
-            ) {
-              sortAction = 'remove';
+            if (sortAction === 'toggle') {
+              // If we are "actually" toggling (not a manual set value), should we remove the sorting?
+              if (!hasManualValue) {
+                // Is our intention to remove?
+                if (!nextSortingOrder) {
+                  sortAction = 'remove';
+                }
+              }
             }
 
-            if (sortAction === 'replace') {
-              newSorting = [{
-                id: column.id,
-                desc: hasDescDefined ? desc : nextSortingOrder === 'desc'
-              }];
-            } else if (sortAction === 'add' && old != null && old.length) {
+            if (sortAction === 'add') {
               var _table$options$maxMul;
 
               newSorting = [...old, {
                 id: column.id,
-                desc: hasDescDefined ? desc : nextSortingOrder === 'desc'
+                desc: nextDesc
               }]; // Take latest n columns
 
               newSorting.splice(0, newSorting.length - ((_table$options$maxMul = table.options.maxMultiSortColCount) != null ? _table$options$maxMul : Number.MAX_SAFE_INTEGER));
-            } else if (sortAction === 'toggle' && old != null && old.length) {
+            } else if (sortAction === 'toggle') {
               // This flips (or sets) the
               newSorting = old.map(d => {
                 if (d.id === column.id) {
                   return { ...d,
-                    desc: hasDescDefined ? desc : nextSortingOrder === 'desc'
+                    desc: nextDesc
                   };
                 }
 
                 return d;
               });
-            } else if (sortAction === 'remove' && old != null && old.length) {
+            } else if (sortAction === 'remove') {
               newSorting = old.filter(d => d.id !== column.id);
+            } else {
+              newSorting = [{
+                id: column.id,
+                desc: nextDesc
+              }];
             }
 
             return newSorting;
           });
         },
-        getNextSortingOrder: () => {
+        getFirstSortDir: () => {
           var _ref, _column$columnDef$sor;
 
           const sortDescFirst = (_ref = (_column$columnDef$sor = column.columnDef.sortDescFirst) != null ? _column$columnDef$sor : table.options.sortDescFirst) != null ? _ref : column.getAutoSortDir() === 'desc';
-          const firstSortDirection = sortDescFirst ? 'desc' : 'asc';
+          return sortDescFirst ? 'desc' : 'asc';
+        },
+        getNextSortingOrder: multi => {
+          var _table$options$enable, _table$options$enable2;
+
+          const firstSortDirection = column.getFirstSortDir();
           const isSorted = column.getIsSorted();
 
           if (!isSorted) {
             return firstSortDirection;
           }
 
-          if (isSorted === firstSortDirection) {
-            return isSorted === 'desc' ? 'asc' : 'desc';
-          } else {
+          if (isSorted !== firstSortDirection && ((_table$options$enable = table.options.enableSortingRemoval) != null ? _table$options$enable : true) && ( // If enableSortRemove, enable in general
+          multi ? (_table$options$enable2 = table.options.enableMultiRemove) != null ? _table$options$enable2 : true : true) // If multi, don't allow if enableMultiRemove))
+          ) {
             return false;
           }
+
+          return isSorted === 'desc' ? 'asc' : 'desc';
         },
         getCanSort: () => {
           var _column$columnDef$ena, _table$options$enable3;
@@ -2881,9 +2893,9 @@
           header: props => props.header.column.id,
           footer: props => props.header.column.id,
           cell: props => {
-            var _toString, _props$renderValue;
+            var _props$renderValue$to, _props$renderValue;
 
-            return (_toString = (_props$renderValue = props.renderValue()) == null ? void 0 : _props$renderValue.toString == null ? void 0 : _props$renderValue.toString()) != null ? _toString : null;
+            return (_props$renderValue$to = (_props$renderValue = props.renderValue()) == null ? void 0 : _props$renderValue.toString == null ? void 0 : _props$renderValue.toString()) != null ? _props$renderValue$to : null;
           },
           ...table._features.reduce((obj, feature) => {
             return Object.assign(obj, feature.getDefaultColumnDef == null ? void 0 : feature.getDefaultColumnDef());
@@ -3413,9 +3425,7 @@
       let facetedMinMaxValues = [firstValue, firstValue];
 
       for (let i = 0; i < facetedRowModel.flatRows.length; i++) {
-        var _facetedRowModel$flat2;
-
-        const value = (_facetedRowModel$flat2 = facetedRowModel.flatRows[i]) == null ? void 0 : _facetedRowModel$flat2.getValue(columnId);
+        const value = facetedRowModel.flatRows[i].getValue(columnId);
 
         if (value < facetedMinMaxValues[0]) {
           facetedMinMaxValues[0] = value;
@@ -3565,7 +3575,7 @@
           const subRows = groupUpRecursively(groupedRows, depth + 1, id); // Flatten the leaf rows of the rows in this group
 
           const leafRows = depth ? flattenBy(groupedRows, row => row.subRows) : groupedRows;
-          const row = createRow(table, id, undefined, index, depth);
+          const row = createRow(table, id, leafRows[0].original, index, depth);
           Object.assign(row, {
             groupingColumnId: columnId,
             groupingValue,