@tanstack/table-core 8.14.0 → 8.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "8.14.0",
+  "version": "8.15.1",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",

package/src/core/table.ts

@@ -30,6 +30,7 @@ import { ColumnOrdering } from '../features/ColumnOrdering'
 import { ColumnPinning } from '../features/ColumnPinning'
 import { ColumnSizing } from '../features/ColumnSizing'
 import { ColumnVisibility } from '../features/ColumnVisibility'
+import { GlobalFaceting } from '../features/GlobalFaceting'
 import { GlobalFiltering } from '../features/GlobalFiltering'
 import { RowExpanding } from '../features/RowExpanding'
 import { RowPagination } from '../features/RowPagination'
@@ -44,7 +45,8 @@ const builtInFeatures = [
   ColumnPinning,
   ColumnFaceting,
   ColumnFiltering,
-  GlobalFiltering, //depends on ColumnFiltering and ColumnFaceting
+  GlobalFaceting, //depends on ColumnFaceting
+  GlobalFiltering, //depends on ColumnFiltering
   RowSorting,
   ColumnGrouping, //depends on RowSorting
   RowExpanding,

package/src/features/ColumnFaceting.ts

@@ -8,22 +8,22 @@ export interface FacetedColumn<TData extends RowData> {
   /**
    * A function that **computes and returns** a min/max tuple derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
    * > ⚠️ Requires that you pass a valid `getFacetedMinMaxValues` function to `options.getFacetedMinMaxValues`. A default implementation is provided via the exported `getFacetedMinMaxValues` function.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfacetedminmaxvalues)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-faceting#getfacetedminmaxvalues)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-faceting)
    */
   getFacetedMinMaxValues: () => undefined | [number, number]
   /**
    * Returns the row model with all other column filters applied, excluding its own filter. Useful for displaying faceted result counts.
    * > ⚠️ Requires that you pass a valid `getFacetedRowModel` function to `options.facetedRowModel`. A default implementation is provided via the exported `getFacetedRowModel` function.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfacetedrowmodel)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-faceting#getfacetedrowmodel)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-faceting)
    */
   getFacetedRowModel: () => RowModel<TData>
   /**
    * A function that **computes and returns** a `Map` of unique values and their occurrences derived from `column.getFacetedRowModel`. Useful for displaying faceted result values.
    * > ⚠️ Requires that you pass a valid `getFacetedUniqueValues` function to `options.getFacetedUniqueValues`. A default implementation is provided via the exported `getFacetedUniqueValues` function.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfaceteduniquevalues)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-faceting#getfaceteduniquevalues)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-faceting)
    */
   getFacetedUniqueValues: () => Map<any, number>
 }

package/src/features/ColumnFiltering.ts

@@ -65,14 +65,14 @@ export type FilterFnOption<TData extends RowData> =
 export interface ColumnFiltersColumnDef<TData extends RowData> {
   /**
    * Enables/disables the **column** filter for this column.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#enablecolumnfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#enablecolumnfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   enableColumnFilter?: boolean
   /**
    * The filter function to use with this column. Can be the name of a built-in filter function or a custom filter function.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#filterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#filterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   filterFn?: FilterFnOption<TData>
 }
@@ -80,44 +80,44 @@ export interface ColumnFiltersColumnDef<TData extends RowData> {
 export interface ColumnFiltersColumn<TData extends RowData> {
   /**
    * Returns an automatically calculated filter function for the column based off of the columns first known value.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getautofilterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getautofilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getAutoFilterFn: () => FilterFn<TData> | undefined
   /**
    * Returns whether or not the column can be **column** filtered.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getcanfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getcanfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getCanFilter: () => boolean
   /**
    * Returns the filter function (either user-defined or automatic, depending on configuration) for the columnId specified.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfilterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getfilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getFilterFn: () => FilterFn<TData> | undefined
   /**
    * Returns the index (including `-1`) of the column filter in the table's `state.columnFilters` array.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfilterindex)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getfilterindex)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getFilterIndex: () => number
   /**
    * Returns the current filter value for the column.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfiltervalue)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getfiltervalue)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getFilterValue: () => unknown
   /**
    * Returns whether or not the column is currently filtered.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getisfiltered)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getisfiltered)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getIsFiltered: () => boolean
   /**
    * A function that sets the current filter value for the column. You can pass it a value or an updater function for immutability-safe operations on existing values.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#setfiltervalue)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#setfiltervalue)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   setFilterValue: (updater: Updater<any>) => void
 }
@@ -125,14 +125,14 @@ export interface ColumnFiltersColumn<TData extends RowData> {
 export interface ColumnFiltersRow<TData extends RowData> {
   /**
    * The column filters map for the row. This object tracks whether a row is passing/failing specific filters by their column ID.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#columnfilters)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#columnfilters)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   columnFilters: Record<string, boolean>
   /**
    * The column filters meta map for the row. This object tracks any filter meta for a row as optionally provided during the filtering process.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#columnfiltersmeta)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#columnfiltersmeta)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   columnFiltersMeta: Record<string, FilterMeta>
 }
@@ -140,48 +140,48 @@ export interface ColumnFiltersRow<TData extends RowData> {
 interface ColumnFiltersOptionsBase<TData extends RowData> {
   /**
    * Enables/disables **column** filtering for all columns.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#enablecolumnfilters)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#enablecolumnfilters)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   enableColumnFilters?: boolean
   /**
    * Enables/disables all filtering for the table.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#enablefilters)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#enablefilters)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   enableFilters?: boolean
   /**
    * By default, filtering is done from parent rows down (so if a parent row is filtered out, all of its children will be filtered out as well). Setting this option to `true` will cause filtering to be done from leaf rows up (which means parent rows will be included so long as one of their child or grand-child rows is also included).
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#filterfromleafrows)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#filterfromleafrows)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   filterFromLeafRows?: boolean
   /**
    * If provided, this function is called **once** per table and should return a **new function** which will calculate and return the row model for the table when it's filtered.
    * - For server-side filtering, this function is unnecessary and can be ignored since the server should already return the filtered row model.
    * - For client-side filtering, this function is required. A default implementation is provided via any table adapter's `{ getFilteredRowModel }` export.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfilteredrowmodel)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getfilteredrowmodel)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getFilteredRowModel?: (table: Table<any>) => () => RowModel<any>
   /**
    * Disables the `getFilteredRowModel` from being used to filter data. This may be useful if your table needs to dynamically support both client-side and server-side filtering.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#manualfiltering)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#manualfiltering)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   manualFiltering?: boolean
   /**
    * By default, filtering is done for all rows (max depth of 100), no matter if they are root level parent rows or the child leaf rows of a parent row. Setting this option to `0` will cause filtering to only be applied to the root level parent rows, with all sub-rows remaining unfiltered. Similarly, setting this option to `1` will cause filtering to only be applied to child leaf rows 1 level deep, and so on.
 
    * This is useful for situations where you want a row's entire child hierarchy to be visible regardless of the applied filter.
-    * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#maxleafrowfilterdepth)
-    * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+    * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#maxleafrowfilterdepth)
+    * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   maxLeafRowFilterDepth?: number
   /**
    * If provided, this function will be called with an `updaterFn` when `state.columnFilters` changes. This overrides the default internal state management, so you will need to persist the state change either fully or partially outside of the table.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#oncolumnfilterschange)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#oncolumnfilterschange)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   onColumnFiltersChange?: OnChangeFn<ColumnFiltersState>
 }
@@ -202,38 +202,38 @@ export interface ColumnFiltersInstance<TData extends RowData> {
   _getFilteredRowModel?: () => RowModel<TData>
   /**
    * Returns the row model for the table after **column** filtering has been applied.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getfilteredrowmodel)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getfilteredrowmodel)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getFilteredRowModel: () => RowModel<TData>
   /**
    * Returns the row model for the table before any **column** filtering has been applied.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getprefilteredrowmodel)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#getprefilteredrowmodel)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   getPreFilteredRowModel: () => RowModel<TData>
   /**
    * Resets the **columnFilters** state to `initialState.columnFilters`, or `true` can be passed to force a default blank state reset to `[]`.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#resetcolumnfilters)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#resetcolumnfilters)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   resetColumnFilters: (defaultState?: boolean) => void
   /**
    * Resets the **globalFilter** state to `initialState.globalFilter`, or `true` can be passed to force a default blank state reset to `undefined`.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#resetglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#resetglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   resetGlobalFilter: (defaultState?: boolean) => void
   /**
    * Sets or updates the `state.columnFilters` state.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#setcolumnfilters)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#setcolumnfilters)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   setColumnFilters: (updater: Updater<ColumnFiltersState>) => void
   /**
    * Sets or updates the `state.globalFilter` state.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#setglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/column-filtering#setglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/column-filtering)
    */
   setGlobalFilter: (updater: Updater<any>) => void
 }

package/src/features/GlobalFaceting.ts

@@ -0,0 +1,66 @@
+import { RowModel } from '..'
+import { Table, RowData, TableFeature } from '../types'
+
+export interface GlobalFacetingInstance<TData extends RowData> {
+  _getGlobalFacetedMinMaxValues?: () => undefined | [number, number]
+  _getGlobalFacetedRowModel?: () => RowModel<TData>
+  _getGlobalFacetedUniqueValues?: () => Map<any, number>
+  /**
+   * Currently, this function returns the built-in `includesString` filter function. In future releases, it may return more dynamic filter functions based on the nature of the data provided.
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-faceting#getglobalautofilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-faceting)
+   */
+  getGlobalFacetedMinMaxValues: () => undefined | [number, number]
+  /**
+   * Returns the row model for the table after **global** filtering has been applied.
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-faceting#getglobalfacetedrowmodel)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-faceting)
+   */
+  getGlobalFacetedRowModel: () => RowModel<TData>
+  /**
+   * Returns the faceted unique values for the global filter.
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-faceting#getglobalfaceteduniquevalues)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-faceting)
+   */
+  getGlobalFacetedUniqueValues: () => Map<any, number>
+}
+
+//
+
+export const GlobalFaceting: TableFeature = {
+  createTable: <TData extends RowData>(table: Table<TData>): void => {
+    table._getGlobalFacetedRowModel =
+      table.options.getFacetedRowModel &&
+      table.options.getFacetedRowModel(table, '__global__')
+
+    table.getGlobalFacetedRowModel = () => {
+      if (table.options.manualFiltering || !table._getGlobalFacetedRowModel) {
+        return table.getPreFilteredRowModel()
+      }
+
+      return table._getGlobalFacetedRowModel()
+    }
+
+    table._getGlobalFacetedUniqueValues =
+      table.options.getFacetedUniqueValues &&
+      table.options.getFacetedUniqueValues(table, '__global__')
+    table.getGlobalFacetedUniqueValues = () => {
+      if (!table._getGlobalFacetedUniqueValues) {
+        return new Map()
+      }
+
+      return table._getGlobalFacetedUniqueValues()
+    }
+
+    table._getGlobalFacetedMinMaxValues =
+      table.options.getFacetedMinMaxValues &&
+      table.options.getFacetedMinMaxValues(table, '__global__')
+    table.getGlobalFacetedMinMaxValues = () => {
+      if (!table._getGlobalFacetedMinMaxValues) {
+        return
+      }
+
+      return table._getGlobalFacetedMinMaxValues()
+    }
+  },
+}

package/src/features/GlobalFiltering.ts

@@ -1,4 +1,4 @@
-import { FilterFn, FilterFnOption, RowModel } from '..'
+import { FilterFn, FilterFnOption } from '..'
 import { BuiltInFilterFn, filterFns } from '../filterFns'
 import {
   Column,
@@ -17,8 +17,8 @@ export interface GlobalFilterTableState {
 export interface GlobalFilterColumnDef {
   /**
    * Enables/disables the **global** filter for this column.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#enableglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#enableglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   enableGlobalFilter?: boolean
 }
@@ -26,8 +26,8 @@ export interface GlobalFilterColumnDef {
 export interface GlobalFilterColumn {
   /**
    * Returns whether or not the column can be **globally** filtered. Set to `false` to disable a column from being scanned during global filtering.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getcanglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#getcanglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   getCanGlobalFilter: () => boolean
 }
@@ -35,16 +35,16 @@ export interface GlobalFilterColumn {
 export interface GlobalFilterOptions<TData extends RowData> {
   /**
    * Enables/disables **global** filtering for all columns.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#enableglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#enableglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   enableGlobalFilter?: boolean
   /**
    * If provided, this function will be called with the column and should return `true` or `false` to indicate whether this column should be used for global filtering.
    *
    * This is useful if the column can contain data that is not `string` or `number` (i.e. `undefined`).
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getcolumncanglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#getcolumncanglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   getColumnCanGlobalFilter?: (column: Column<TData, unknown>) => boolean
   /**
@@ -52,62 +52,41 @@ export interface GlobalFilterOptions<TData extends RowData> {
    * - A `string` referencing a built-in filter function
    * - A `string` that references a custom filter functions provided via the `tableOptions.filterFns` option
    * - A custom filter function
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#globalfilterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#globalfilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   globalFilterFn?: FilterFnOption<TData>
   /**
    * If provided, this function will be called with an `updaterFn` when `state.globalFilter` changes. This overrides the default internal state management, so you will need to persist the state change either fully or partially outside of the table.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#onglobalfilterchange)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#onglobalfilterchange)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   onGlobalFilterChange?: OnChangeFn<any>
 }
 
 export interface GlobalFilterInstance<TData extends RowData> {
-  _getGlobalFacetedMinMaxValues?: () => undefined | [number, number]
-  _getGlobalFacetedRowModel?: () => RowModel<TData>
-  _getGlobalFacetedUniqueValues?: () => Map<any, number>
   /**
    * Currently, this function returns the built-in `includesString` filter function. In future releases, it may return more dynamic filter functions based on the nature of the data provided.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getglobalautofilterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#getglobalautofilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   getGlobalAutoFilterFn: () => FilterFn<TData> | undefined
-  /**
-   * Returns the faceted min and max values for the global filter.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getglobalfacetedminmaxvalues)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
-   */
-  getGlobalFacetedMinMaxValues: () => undefined | [number, number]
-  /**
-   * Returns the row model for the table after **global** filtering has been applied.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getglobalfacetedrowmodel)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
-   */
-  getGlobalFacetedRowModel: () => RowModel<TData>
-  /**
-   * Returns the faceted unique values for the global filter.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getglobalfaceteduniquevalues)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
-   */
-  getGlobalFacetedUniqueValues: () => Map<any, number>
   /**
    * Returns the filter function (either user-defined or automatic, depending on configuration) for the global filter.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#getglobalfilterfn)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#getglobalfilterfn)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   getGlobalFilterFn: () => FilterFn<TData> | undefined
   /**
    * Resets the **globalFilter** state to `initialState.globalFilter`, or `true` can be passed to force a default blank state reset to `undefined`.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#resetglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#resetglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   resetGlobalFilter: (defaultState?: boolean) => void
   /**
    * Sets or updates the `state.globalFilter` state.
-   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/filters#setglobalfilter)
-   * @link [Guide](https://tanstack.com/table/v8/docs/guide/filters)
+   * @link [API Docs](https://tanstack.com/table/v8/docs/api/features/global-filtering#setglobalfilter)
+   * @link [Guide](https://tanstack.com/table/v8/docs/guide/global-filtering)
    */
   setGlobalFilter: (updater: Updater<any>) => void
 }
@@ -166,8 +145,7 @@ export const GlobalFiltering: TableFeature = {
         ? globalFilterFn
         : globalFilterFn === 'auto'
           ? table.getGlobalAutoFilterFn()
-          : // @ts-ignore
-            table.options.filterFns?.[globalFilterFn as string] ??
+          : table.options.filterFns?.[globalFilterFn as string] ??
             filterFns[globalFilterFn as BuiltInFilterFn]
     }
 
@@ -180,39 +158,5 @@ export const GlobalFiltering: TableFeature = {
         defaultState ? undefined : table.initialState.globalFilter
       )
     }
-
-    table._getGlobalFacetedRowModel =
-      table.options.getFacetedRowModel &&
-      table.options.getFacetedRowModel(table, '__global__')
-
-    table.getGlobalFacetedRowModel = () => {
-      if (table.options.manualFiltering || !table._getGlobalFacetedRowModel) {
-        return table.getPreFilteredRowModel()
-      }
-
-      return table._getGlobalFacetedRowModel()
-    }
-
-    table._getGlobalFacetedUniqueValues =
-      table.options.getFacetedUniqueValues &&
-      table.options.getFacetedUniqueValues(table, '__global__')
-    table.getGlobalFacetedUniqueValues = () => {
-      if (!table._getGlobalFacetedUniqueValues) {
-        return new Map()
-      }
-
-      return table._getGlobalFacetedUniqueValues()
-    }
-
-    table._getGlobalFacetedMinMaxValues =
-      table.options.getFacetedMinMaxValues &&
-      table.options.getFacetedMinMaxValues(table, '__global__')
-    table.getGlobalFacetedMinMaxValues = () => {
-      if (!table._getGlobalFacetedMinMaxValues) {
-        return
-      }
-
-      return table._getGlobalFacetedMinMaxValues()
-    }
   },
 }

package/src/index.ts

@@ -17,6 +17,7 @@ export * from './features/ColumnOrdering'
 export * from './features/ColumnPinning'
 export * from './features/ColumnSizing'
 export * from './features/ColumnVisibility'
+export * from './features/GlobalFaceting'
 export * from './features/GlobalFiltering'
 export * from './features/RowExpanding'
 export * from './features/RowPagination'

package/src/types.ts

@@ -34,6 +34,7 @@ import {
   HeadersInstance,
 } from './core/headers'
 import { FacetedColumn, FacetedOptions } from './features/ColumnFaceting'
+import { GlobalFacetingInstance } from './features/GlobalFaceting'
 import {
   ColumnFiltersColumn,
   ColumnFiltersColumnDef,
@@ -142,6 +143,7 @@ export interface Table<TData extends RowData>
     RowPinningInstance<TData>,
     ColumnFiltersInstance<TData>,
     GlobalFilterInstance<TData>,
+    GlobalFacetingInstance<TData>,
     SortingInstance<TData>,
     GroupingInstance<TData>,
     ColumnSizingInstance,
@@ -291,8 +293,10 @@ export type GroupColumnDef<
   TValue = unknown,
 > = GroupColumnDefBase<TData, TValue> & ColumnIdentifiers<TData, TValue>
 
-interface AccessorFnColumnDefBase<TData extends RowData, TValue = unknown>
-  extends ColumnDefBase<TData, TValue> {
+export interface AccessorFnColumnDefBase<
+  TData extends RowData,
+  TValue = unknown,
+> extends ColumnDefBase<TData, TValue> {
   accessorFn: AccessorFn<TData, TValue>
 }