feat: add isDesc to sortingFn

Author: tychenjiajun

docs/api/features/sorting.md

@@ -201,7 +201,7 @@ Returns whether this column is sorted.
 
 ### `getFirstSortDir`
 
-```tsx 
+```tsx
 getFirstSortDir: () => SortDirection
 ```
 
@@ -256,7 +256,7 @@ const column = columnHelper.data('key', {
 const table = useReactTable({
   columns: [column],
   sortingFns: {
-    myCustomSorting: (rowA: any, rowB: any, columnId: any): number =>
+    myCustomSorting: (rowA: any, rowB: any, columnId: any, isDesc: boolean): number =>
       rowA.getValue(columnId).value < rowB.getValue(columnId).value ? 1 : -1,
   },
 })

docs/guide/sorting.md

@@ -199,8 +199,8 @@ const table = useReactTable({
   getCoreRowModel: getCoreRowModel(),
   getSortedRowModel: getSortedRowModel(),
   sortingFns: { //add a custom sorting function
-    myCustomSortingFn: (rowA, rowB, columnId) => {
-      return rowA.original[columnId] > rowB.original[columnId] ? 1 : rowA.original[columnId] < rowB.original[columnId] ? -1 : 0 
+    myCustomSortingFn: (rowA, rowB, columnId, isDesc) => {
+      return rowA.original[columnId] > rowB.original[columnId] ? 1 : rowA.original[columnId] < rowB.original[columnId] ? -1 : 0
     },
   },
 })
@@ -302,7 +302,7 @@ const columns = [
 
 By default, the ability to remove sorting while cycling through the sorting states for a column is enabled. You can disable this behavior using the `enableSortingRemoval` table option. This behavior is useful if you want to ensure that at least one column is always sorted.
 
-The default behavior when using either the `getToggleSortingHandler` or `toggleSorting` APIs is to cycle through the sorting states like this: 
+The default behavior when using either the `getToggleSortingHandler` or `toggleSorting` APIs is to cycle through the sorting states like this:
 
 `'none' -> 'desc' -> 'asc' -> 'none' -> 'desc' -> 'asc' -> ...`
 

packages/table-core/src/features/Sorting.ts

@@ -32,7 +32,7 @@ export interface SortingTableState {
 }
 
 export interface SortingFn<TData extends RowData> {
-  (rowA: Row<TData>, rowB: Row<TData>, columnId: string): number
+  (rowA: Row<TData>, rowB: Row<TData>, columnId: string, isDesc?: boolean): number
 }
 
 export type CustomSortingFns<TData extends RowData> = Record<

packages/table-core/src/utils/getSortedRowModel.ts

@@ -74,7 +74,7 @@ export function getSortedRowModel<TData extends RowData>(): (
               }
 
               if (sortInt === 0) {
-                sortInt = columnInfo.sortingFn(rowA, rowB, sortEntry.id)
+                sortInt = columnInfo.sortingFn(rowA, rowB, sortEntry.id, isDesc)
               }
 
               // If sorting is non-zero, take care of desc and inversion