@tanstack/table-core 9.0.0-alpha.8 → 9.0.0-beta.10

package/dist/features/column-filtering/columnFilteringFeature.cjs

@@ -0,0 +1,50 @@
+const require_utils = require('../../utils.cjs');
+const require_columnFilteringFeature_utils = require('./columnFilteringFeature.utils.cjs');
+
+//#region src/features/column-filtering/columnFilteringFeature.ts
+/**
+* Feature that adds per-column filtering state, options, and column/table filter APIs.
+*/
+const columnFilteringFeature = {
+	getInitialState: (initialState) => {
+		return {
+			columnFilters: require_columnFilteringFeature_utils.getDefaultColumnFiltersState(),
+			...initialState
+		};
+	},
+	getDefaultColumnDef: () => {
+		return { filterFn: "auto" };
+	},
+	getDefaultTableOptions: (table) => {
+		return {
+			onColumnFiltersChange: require_utils.makeStateUpdater("columnFilters", table),
+			filterFromLeafRows: false,
+			maxLeafRowFilterDepth: 100
+		};
+	},
+	assignColumnPrototype: (prototype, table) => {
+		require_utils.assignPrototypeAPIs("columnFilteringFeature", prototype, table, {
+			column_getAutoFilterFn: { fn: (column) => require_columnFilteringFeature_utils.column_getAutoFilterFn(column) },
+			column_getFilterFn: { fn: (column) => require_columnFilteringFeature_utils.column_getFilterFn(column) },
+			column_getCanFilter: { fn: (column) => require_columnFilteringFeature_utils.column_getCanFilter(column) },
+			column_getIsFiltered: { fn: (column) => require_columnFilteringFeature_utils.column_getIsFiltered(column) },
+			column_getFilterValue: { fn: (column) => require_columnFilteringFeature_utils.column_getFilterValue(column) },
+			column_getFilterIndex: { fn: (column) => require_columnFilteringFeature_utils.column_getFilterIndex(column) },
+			column_setFilterValue: { fn: (column, value) => require_columnFilteringFeature_utils.column_setFilterValue(column, value) }
+		});
+	},
+	initRowInstanceData: (row) => {
+		row.columnFilters = {};
+		row.columnFiltersMeta = {};
+	},
+	constructTableAPIs: (table) => {
+		require_utils.assignTableAPIs("columnFilteringFeature", table, {
+			table_setColumnFilters: { fn: (updater) => require_columnFilteringFeature_utils.table_setColumnFilters(table, updater) },
+			table_resetColumnFilters: { fn: (defaultState) => require_columnFilteringFeature_utils.table_resetColumnFilters(table, defaultState) }
+		});
+	}
+};
+
+//#endregion
+exports.columnFilteringFeature = columnFilteringFeature;
+//# sourceMappingURL=columnFilteringFeature.cjs.map

package/dist/features/column-filtering/columnFilteringFeature.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnFilteringFeature.cjs","names":["getDefaultColumnFiltersState","makeStateUpdater","column_getAutoFilterFn","column_getFilterFn","column_getCanFilter","column_getIsFiltered","column_getFilterValue","column_getFilterIndex","column_setFilterValue","table_setColumnFilters","table_resetColumnFilters"],"sources":["../../../src/features/column-filtering/columnFilteringFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  column_getAutoFilterFn,\n  column_getCanFilter,\n  column_getFilterFn,\n  column_getFilterIndex,\n  column_getFilterValue,\n  column_getIsFiltered,\n  column_setFilterValue,\n  getDefaultColumnFiltersState,\n  table_resetColumnFilters,\n  table_setColumnFilters,\n} from './columnFilteringFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds per-column filtering state, options, and column/table filter APIs.\n */\nexport const columnFilteringFeature: TableFeature = {\n  getInitialState: (initialState) => {\n    return {\n      columnFilters: getDefaultColumnFiltersState(),\n      ...initialState,\n    }\n  },\n\n  getDefaultColumnDef: () => {\n    return {\n      filterFn: 'auto',\n    }\n  },\n\n  getDefaultTableOptions: (table) => {\n    return {\n      onColumnFiltersChange: makeStateUpdater('columnFilters', table),\n      filterFromLeafRows: false,\n      maxLeafRowFilterDepth: 100,\n    }\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnFilteringFeature', prototype, table, {\n      column_getAutoFilterFn: {\n        fn: (column) => column_getAutoFilterFn(column),\n      },\n      column_getFilterFn: {\n        fn: (column) => column_getFilterFn(column),\n      },\n      column_getCanFilter: {\n        fn: (column) => column_getCanFilter(column),\n      },\n      column_getIsFiltered: {\n        fn: (column) => column_getIsFiltered(column),\n      },\n      column_getFilterValue: {\n        fn: (column) => column_getFilterValue(column),\n      },\n      column_getFilterIndex: {\n        fn: (column) => column_getFilterIndex(column),\n      },\n      column_setFilterValue: {\n        fn: (column, value) => column_setFilterValue(column, value),\n      },\n    })\n  },\n\n  initRowInstanceData: (row) => {\n    ;(row as any).columnFilters = {}\n    ;(row as any).columnFiltersMeta = {}\n  },\n\n  constructTableAPIs: (table) => {\n    assignTableAPIs('columnFilteringFeature', table, {\n      table_setColumnFilters: {\n        fn: (updater) => table_setColumnFilters(table, updater),\n      },\n      table_resetColumnFilters: {\n        fn: (defaultState) => table_resetColumnFilters(table, defaultState),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAsBA,MAAa,yBAAuC;CAClD,kBAAkB,iBAAiB;EACjC,OAAO;GACL,eAAeA,kEAA6B;GAC5C,GAAG;EACL;CACF;CAEA,2BAA2B;EACzB,OAAO,EACL,UAAU,OACZ;CACF;CAEA,yBAAyB,UAAU;EACjC,OAAO;GACL,uBAAuBC,+BAAiB,iBAAiB,KAAK;GAC9D,oBAAoB;GACpB,uBAAuB;EACzB;CACF;CAEA,wBAAwB,WAAW,UAAU;EAC3C,kCAAoB,0BAA0B,WAAW,OAAO;GAC9D,wBAAwB,EACtB,KAAK,WAAWC,4DAAuB,MAAM,EAC/C;GACA,oBAAoB,EAClB,KAAK,WAAWC,wDAAmB,MAAM,EAC3C;GACA,qBAAqB,EACnB,KAAK,WAAWC,yDAAoB,MAAM,EAC5C;GACA,sBAAsB,EACpB,KAAK,WAAWC,0DAAqB,MAAM,EAC7C;GACA,uBAAuB,EACrB,KAAK,WAAWC,2DAAsB,MAAM,EAC9C;GACA,uBAAuB,EACrB,KAAK,WAAWC,2DAAsB,MAAM,EAC9C;GACA,uBAAuB,EACrB,KAAK,QAAQ,UAAUC,2DAAsB,QAAQ,KAAK,EAC5D;EACF,CAAC;CACH;CAEA,sBAAsB,QAAQ;EAC3B,AAAC,IAAY,gBAAgB,CAAC;EAC9B,AAAC,IAAY,oBAAoB,CAAC;CACrC;CAEA,qBAAqB,UAAU;EAC7B,8BAAgB,0BAA0B,OAAO;GAC/C,wBAAwB,EACtB,KAAK,YAAYC,4DAAuB,OAAO,OAAO,EACxD;GACA,0BAA0B,EACxB,KAAK,iBAAiBC,8DAAyB,OAAO,YAAY,EACpE;EACF,CAAC;CACH;AACF"}

package/dist/features/column-filtering/columnFilteringFeature.d.cts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.cjs";
+
+//#region src/features/column-filtering/columnFilteringFeature.d.ts
+/**
+ * Feature that adds per-column filtering state, options, and column/table filter APIs.
+ */
+declare const columnFilteringFeature: TableFeature;
+//#endregion
+export { columnFilteringFeature };
+//# sourceMappingURL=columnFilteringFeature.d.cts.map

package/dist/features/column-filtering/columnFilteringFeature.d.ts

@@ -0,0 +1,10 @@
+import { TableFeature } from "../../types/TableFeatures.js";
+
+//#region src/features/column-filtering/columnFilteringFeature.d.ts
+/**
+ * Feature that adds per-column filtering state, options, and column/table filter APIs.
+ */
+declare const columnFilteringFeature: TableFeature;
+//#endregion
+export { columnFilteringFeature };
+//# sourceMappingURL=columnFilteringFeature.d.ts.map

package/dist/features/column-filtering/columnFilteringFeature.js

@@ -0,0 +1,50 @@
+import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
+import { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, table_resetColumnFilters, table_setColumnFilters } from "./columnFilteringFeature.utils.js";
+
+//#region src/features/column-filtering/columnFilteringFeature.ts
+/**
+* Feature that adds per-column filtering state, options, and column/table filter APIs.
+*/
+const columnFilteringFeature = {
+	getInitialState: (initialState) => {
+		return {
+			columnFilters: getDefaultColumnFiltersState(),
+			...initialState
+		};
+	},
+	getDefaultColumnDef: () => {
+		return { filterFn: "auto" };
+	},
+	getDefaultTableOptions: (table) => {
+		return {
+			onColumnFiltersChange: makeStateUpdater("columnFilters", table),
+			filterFromLeafRows: false,
+			maxLeafRowFilterDepth: 100
+		};
+	},
+	assignColumnPrototype: (prototype, table) => {
+		assignPrototypeAPIs("columnFilteringFeature", prototype, table, {
+			column_getAutoFilterFn: { fn: (column) => column_getAutoFilterFn(column) },
+			column_getFilterFn: { fn: (column) => column_getFilterFn(column) },
+			column_getCanFilter: { fn: (column) => column_getCanFilter(column) },
+			column_getIsFiltered: { fn: (column) => column_getIsFiltered(column) },
+			column_getFilterValue: { fn: (column) => column_getFilterValue(column) },
+			column_getFilterIndex: { fn: (column) => column_getFilterIndex(column) },
+			column_setFilterValue: { fn: (column, value) => column_setFilterValue(column, value) }
+		});
+	},
+	initRowInstanceData: (row) => {
+		row.columnFilters = {};
+		row.columnFiltersMeta = {};
+	},
+	constructTableAPIs: (table) => {
+		assignTableAPIs("columnFilteringFeature", table, {
+			table_setColumnFilters: { fn: (updater) => table_setColumnFilters(table, updater) },
+			table_resetColumnFilters: { fn: (defaultState) => table_resetColumnFilters(table, defaultState) }
+		});
+	}
+};
+
+//#endregion
+export { columnFilteringFeature };
+//# sourceMappingURL=columnFilteringFeature.js.map

package/dist/features/column-filtering/columnFilteringFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columnFilteringFeature.js","names":[],"sources":["../../../src/features/column-filtering/columnFilteringFeature.ts"],"sourcesContent":["import {\n  assignPrototypeAPIs,\n  assignTableAPIs,\n  makeStateUpdater,\n} from '../../utils'\nimport {\n  column_getAutoFilterFn,\n  column_getCanFilter,\n  column_getFilterFn,\n  column_getFilterIndex,\n  column_getFilterValue,\n  column_getIsFiltered,\n  column_setFilterValue,\n  getDefaultColumnFiltersState,\n  table_resetColumnFilters,\n  table_setColumnFilters,\n} from './columnFilteringFeature.utils'\nimport type { TableFeature } from '../../types/TableFeatures'\n\n/**\n * Feature that adds per-column filtering state, options, and column/table filter APIs.\n */\nexport const columnFilteringFeature: TableFeature = {\n  getInitialState: (initialState) => {\n    return {\n      columnFilters: getDefaultColumnFiltersState(),\n      ...initialState,\n    }\n  },\n\n  getDefaultColumnDef: () => {\n    return {\n      filterFn: 'auto',\n    }\n  },\n\n  getDefaultTableOptions: (table) => {\n    return {\n      onColumnFiltersChange: makeStateUpdater('columnFilters', table),\n      filterFromLeafRows: false,\n      maxLeafRowFilterDepth: 100,\n    }\n  },\n\n  assignColumnPrototype: (prototype, table) => {\n    assignPrototypeAPIs('columnFilteringFeature', prototype, table, {\n      column_getAutoFilterFn: {\n        fn: (column) => column_getAutoFilterFn(column),\n      },\n      column_getFilterFn: {\n        fn: (column) => column_getFilterFn(column),\n      },\n      column_getCanFilter: {\n        fn: (column) => column_getCanFilter(column),\n      },\n      column_getIsFiltered: {\n        fn: (column) => column_getIsFiltered(column),\n      },\n      column_getFilterValue: {\n        fn: (column) => column_getFilterValue(column),\n      },\n      column_getFilterIndex: {\n        fn: (column) => column_getFilterIndex(column),\n      },\n      column_setFilterValue: {\n        fn: (column, value) => column_setFilterValue(column, value),\n      },\n    })\n  },\n\n  initRowInstanceData: (row) => {\n    ;(row as any).columnFilters = {}\n    ;(row as any).columnFiltersMeta = {}\n  },\n\n  constructTableAPIs: (table) => {\n    assignTableAPIs('columnFilteringFeature', table, {\n      table_setColumnFilters: {\n        fn: (updater) => table_setColumnFilters(table, updater),\n      },\n      table_resetColumnFilters: {\n        fn: (defaultState) => table_resetColumnFilters(table, defaultState),\n      },\n    })\n  },\n}\n"],"mappings":";;;;;;;AAsBA,MAAa,yBAAuC;CAClD,kBAAkB,iBAAiB;EACjC,OAAO;GACL,eAAe,6BAA6B;GAC5C,GAAG;EACL;CACF;CAEA,2BAA2B;EACzB,OAAO,EACL,UAAU,OACZ;CACF;CAEA,yBAAyB,UAAU;EACjC,OAAO;GACL,uBAAuB,iBAAiB,iBAAiB,KAAK;GAC9D,oBAAoB;GACpB,uBAAuB;EACzB;CACF;CAEA,wBAAwB,WAAW,UAAU;EAC3C,oBAAoB,0BAA0B,WAAW,OAAO;GAC9D,wBAAwB,EACtB,KAAK,WAAW,uBAAuB,MAAM,EAC/C;GACA,oBAAoB,EAClB,KAAK,WAAW,mBAAmB,MAAM,EAC3C;GACA,qBAAqB,EACnB,KAAK,WAAW,oBAAoB,MAAM,EAC5C;GACA,sBAAsB,EACpB,KAAK,WAAW,qBAAqB,MAAM,EAC7C;GACA,uBAAuB,EACrB,KAAK,WAAW,sBAAsB,MAAM,EAC9C;GACA,uBAAuB,EACrB,KAAK,WAAW,sBAAsB,MAAM,EAC9C;GACA,uBAAuB,EACrB,KAAK,QAAQ,UAAU,sBAAsB,QAAQ,KAAK,EAC5D;EACF,CAAC;CACH;CAEA,sBAAsB,QAAQ;EAC3B,AAAC,IAAY,gBAAgB,CAAC;EAC9B,AAAC,IAAY,oBAAoB,CAAC;CACrC;CAEA,qBAAqB,UAAU;EAC7B,gBAAgB,0BAA0B,OAAO;GAC/C,wBAAwB,EACtB,KAAK,YAAY,uBAAuB,OAAO,OAAO,EACxD;GACA,0BAA0B,EACxB,KAAK,iBAAiB,yBAAyB,OAAO,YAAY,EACpE;EACF,CAAC;CACH;AACF"}

package/dist/features/column-filtering/columnFilteringFeature.types.d.cts

@@ -0,0 +1,174 @@
+import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.cjs";
+import { Column } from "../../types/Column.cjs";
+import { Row } from "../../types/Row.cjs";
+import { BuiltInFilterFn } from "../../fns/filterFns.cjs";
+import { IsAny, TableFeatures } from "../../types/TableFeatures.cjs";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+
+//#region src/features/column-filtering/columnFilteringFeature.types.d.ts
+interface FilterMeta {}
+/**
+ * Resolves the type of the filter meta attached to rows for a feature set.
+ *
+ * When the features object declares a `filterMeta` type-only slot
+ * (`tableFeatures({ ..., filterMeta: {} as MyFilterMeta })`), that type wins.
+ * Otherwise this falls back to the global declaration-merged `FilterMeta`
+ * interface.
+ */
+type ExtractFilterMeta<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? FilterMeta : TFeatures extends {
+  filterMeta: infer TFilterMeta extends object;
+} ? TFilterMeta : FilterMeta;
+interface FilterFns {}
+interface TableState_ColumnFiltering {
+  columnFilters: ColumnFiltersState;
+}
+type ColumnFiltersState = Array<ColumnFilter>;
+interface ColumnFilter {
+  id: string;
+  value: unknown;
+}
+interface ResolvedColumnFilter<TFeatures extends TableFeatures, TData extends RowData> {
+  filterFn: FilterFn<TFeatures, TData>;
+  id: string;
+  resolvedValue: unknown;
+}
+interface RowModelFns_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  filterFns: Record<string, FilterFn<TFeatures, TData>>;
+}
+interface FilterFn<TFeatures extends TableFeatures, TData extends RowData> {
+  (row: Row<TFeatures, TData>, columnId: string, filterValue: any, addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void): boolean;
+  autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>;
+  resolveFilterValue?: TransformFilterValueFn<TFeatures, TData>;
+}
+type TransformFilterValueFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => TValue;
+type ColumnFilterAutoRemoveTestFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => boolean;
+type CustomFilterFns<TFeatures extends TableFeatures, TData extends RowData> = Record<string, FilterFn<TFeatures, TData>>;
+/**
+ * Resolves the valid string names for `columnDef.filterFn` and
+ * `options.globalFilterFn` for a feature set.
+ *
+ * When the features object declares a `filterFns` registry
+ * (`tableFeatures({ ..., filterFns })`), its keys are the only valid names; a
+ * name is only assignable if a filter function is actually registered for it.
+ * Otherwise this falls back to the global declaration-merged `FilterFns`
+ * interface.
+ */
+type ExtractFilterFnKeys<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? keyof FilterFns | BuiltInFilterFn : TFeatures extends {
+  filterFns: infer TFilterFns extends object;
+} ? Extract<keyof TFilterFns, string> : keyof FilterFns;
+type FilterFnOption<TFeatures extends TableFeatures, TData extends RowData> = 'auto' | ExtractFilterFnKeys<TFeatures> | FilterFn<TFeatures, TData>;
+interface ColumnDef_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Enables this column to participate in column-specific filtering.
+   *
+   * Defaults to `true`; table-level `enableColumnFilters` and `enableFilters`
+   * must also allow 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.
+   */
+  filterFn?: FilterFnOption<TFeatures, TData>;
+}
+interface Column_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Returns an automatically calculated filter function for the column based off of the columns first known value.
+   */
+  getAutoFilterFn: () => FilterFn<TFeatures, TData>;
+  /**
+   * Checks whether this accessor column can currently be column-filtered.
+   */
+  getCanFilter: () => boolean;
+  /**
+   * Returns the filter function (either user-defined or automatic, depending on configuration) for the columnId specified.
+   */
+  getFilterFn: () => FilterFn<TFeatures, TData>;
+  /**
+   * Returns the index (including `-1`) of the column filter in the table's `state.columnFilters` array.
+   */
+  getFilterIndex: () => number;
+  /**
+   * Reads this column's current value from `state.columnFilters`.
+   */
+  getFilterValue: () => unknown;
+  /**
+   * Checks whether this column has an active entry in `state.columnFilters`.
+   */
+  getIsFiltered: () => boolean;
+  /**
+   * Adds, updates, or removes this column's filter value.
+   *
+   * Updater functions receive the previous filter value. Values that satisfy
+   * the filter function's `autoRemove` rule are removed from filter state.
+   */
+  setFilterValue: (updater: Updater<any>) => void;
+}
+interface Row_ColumnFiltering<TFeatures extends TableFeatures, 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.
+   */
+  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.
+   */
+  columnFiltersMeta: Record<string, ExtractFilterMeta<TFeatures>>;
+}
+interface TableOptions_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Enables column-specific filtering for all columns that also allow it.
+   */
+  enableColumnFilters?: boolean;
+  /**
+   * Enables all filtering features for the table.
+   *
+   * Set this to `false` to disable both column filtering and global 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).
+   */
+  filterFromLeafRows?: boolean;
+  /**
+   * 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.
+   */
+  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.
+     */
+  maxLeafRowFilterDepth?: number;
+  /**
+   * Called with an updater when column filter state changes. Pair this with
+   * `state.columnFilters` when using external state; external atoms can own the
+   * slice without this callback.
+   */
+  onColumnFiltersChange?: OnChangeFn<ColumnFiltersState>;
+}
+interface Table_ColumnFiltering {
+  /**
+   * Resets `columnFilters` to `initialState.columnFilters`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
+   */
+  resetColumnFilters: (defaultState?: boolean) => void;
+  /**
+   * Updates column filter state with a next array or updater function.
+   */
+  setColumnFilters: (updater: Updater<ColumnFiltersState>) => void;
+}
+interface Table_RowModels_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resolves the row model after column and global filters have been applied.
+   */
+  getFilteredRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Reads the row model immediately before filtering.
+   */
+  getPreFilteredRowModel: () => RowModel<TFeatures, TData>;
+}
+interface CachedRowModel_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+  filteredRowModel: () => RowModel<TFeatures, TData>;
+}
+//#endregion
+export { CachedRowModel_Filtered, ColumnDef_ColumnFiltering, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, Column_ColumnFiltering, CustomFilterFns, ExtractFilterFnKeys, ExtractFilterMeta, FilterFn, FilterFnOption, FilterFns, FilterMeta, ResolvedColumnFilter, RowModelFns_ColumnFiltering, Row_ColumnFiltering, TableOptions_ColumnFiltering, TableState_ColumnFiltering, Table_ColumnFiltering, Table_RowModels_Filtered, TransformFilterValueFn };
+//# sourceMappingURL=columnFilteringFeature.types.d.cts.map

package/dist/features/column-filtering/columnFilteringFeature.types.d.ts

@@ -0,0 +1,174 @@
+import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
+import { Row } from "../../types/Row.js";
+import { BuiltInFilterFn } from "../../fns/filterFns.js";
+import { IsAny, TableFeatures } from "../../types/TableFeatures.js";
+import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
+
+//#region src/features/column-filtering/columnFilteringFeature.types.d.ts
+interface FilterMeta {}
+/**
+ * Resolves the type of the filter meta attached to rows for a feature set.
+ *
+ * When the features object declares a `filterMeta` type-only slot
+ * (`tableFeatures({ ..., filterMeta: {} as MyFilterMeta })`), that type wins.
+ * Otherwise this falls back to the global declaration-merged `FilterMeta`
+ * interface.
+ */
+type ExtractFilterMeta<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? FilterMeta : TFeatures extends {
+  filterMeta: infer TFilterMeta extends object;
+} ? TFilterMeta : FilterMeta;
+interface FilterFns {}
+interface TableState_ColumnFiltering {
+  columnFilters: ColumnFiltersState;
+}
+type ColumnFiltersState = Array<ColumnFilter>;
+interface ColumnFilter {
+  id: string;
+  value: unknown;
+}
+interface ResolvedColumnFilter<TFeatures extends TableFeatures, TData extends RowData> {
+  filterFn: FilterFn<TFeatures, TData>;
+  id: string;
+  resolvedValue: unknown;
+}
+interface RowModelFns_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  filterFns: Record<string, FilterFn<TFeatures, TData>>;
+}
+interface FilterFn<TFeatures extends TableFeatures, TData extends RowData> {
+  (row: Row<TFeatures, TData>, columnId: string, filterValue: any, addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void): boolean;
+  autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>;
+  resolveFilterValue?: TransformFilterValueFn<TFeatures, TData>;
+}
+type TransformFilterValueFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => TValue;
+type ColumnFilterAutoRemoveTestFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => boolean;
+type CustomFilterFns<TFeatures extends TableFeatures, TData extends RowData> = Record<string, FilterFn<TFeatures, TData>>;
+/**
+ * Resolves the valid string names for `columnDef.filterFn` and
+ * `options.globalFilterFn` for a feature set.
+ *
+ * When the features object declares a `filterFns` registry
+ * (`tableFeatures({ ..., filterFns })`), its keys are the only valid names; a
+ * name is only assignable if a filter function is actually registered for it.
+ * Otherwise this falls back to the global declaration-merged `FilterFns`
+ * interface.
+ */
+type ExtractFilterFnKeys<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? keyof FilterFns | BuiltInFilterFn : TFeatures extends {
+  filterFns: infer TFilterFns extends object;
+} ? Extract<keyof TFilterFns, string> : keyof FilterFns;
+type FilterFnOption<TFeatures extends TableFeatures, TData extends RowData> = 'auto' | ExtractFilterFnKeys<TFeatures> | FilterFn<TFeatures, TData>;
+interface ColumnDef_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Enables this column to participate in column-specific filtering.
+   *
+   * Defaults to `true`; table-level `enableColumnFilters` and `enableFilters`
+   * must also allow 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.
+   */
+  filterFn?: FilterFnOption<TFeatures, TData>;
+}
+interface Column_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Returns an automatically calculated filter function for the column based off of the columns first known value.
+   */
+  getAutoFilterFn: () => FilterFn<TFeatures, TData>;
+  /**
+   * Checks whether this accessor column can currently be column-filtered.
+   */
+  getCanFilter: () => boolean;
+  /**
+   * Returns the filter function (either user-defined or automatic, depending on configuration) for the columnId specified.
+   */
+  getFilterFn: () => FilterFn<TFeatures, TData>;
+  /**
+   * Returns the index (including `-1`) of the column filter in the table's `state.columnFilters` array.
+   */
+  getFilterIndex: () => number;
+  /**
+   * Reads this column's current value from `state.columnFilters`.
+   */
+  getFilterValue: () => unknown;
+  /**
+   * Checks whether this column has an active entry in `state.columnFilters`.
+   */
+  getIsFiltered: () => boolean;
+  /**
+   * Adds, updates, or removes this column's filter value.
+   *
+   * Updater functions receive the previous filter value. Values that satisfy
+   * the filter function's `autoRemove` rule are removed from filter state.
+   */
+  setFilterValue: (updater: Updater<any>) => void;
+}
+interface Row_ColumnFiltering<TFeatures extends TableFeatures, 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.
+   */
+  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.
+   */
+  columnFiltersMeta: Record<string, ExtractFilterMeta<TFeatures>>;
+}
+interface TableOptions_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Enables column-specific filtering for all columns that also allow it.
+   */
+  enableColumnFilters?: boolean;
+  /**
+   * Enables all filtering features for the table.
+   *
+   * Set this to `false` to disable both column filtering and global 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).
+   */
+  filterFromLeafRows?: boolean;
+  /**
+   * 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.
+   */
+  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.
+     */
+  maxLeafRowFilterDepth?: number;
+  /**
+   * Called with an updater when column filter state changes. Pair this with
+   * `state.columnFilters` when using external state; external atoms can own the
+   * slice without this callback.
+   */
+  onColumnFiltersChange?: OnChangeFn<ColumnFiltersState>;
+}
+interface Table_ColumnFiltering {
+  /**
+   * Resets `columnFilters` to `initialState.columnFilters`.
+   *
+   * Pass `true` to ignore initial state and reset to `[]`.
+   */
+  resetColumnFilters: (defaultState?: boolean) => void;
+  /**
+   * Updates column filter state with a next array or updater function.
+   */
+  setColumnFilters: (updater: Updater<ColumnFiltersState>) => void;
+}
+interface Table_RowModels_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+  /**
+   * Resolves the row model after column and global filters have been applied.
+   */
+  getFilteredRowModel: () => RowModel<TFeatures, TData>;
+  /**
+   * Reads the row model immediately before filtering.
+   */
+  getPreFilteredRowModel: () => RowModel<TFeatures, TData>;
+}
+interface CachedRowModel_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+  filteredRowModel: () => RowModel<TFeatures, TData>;
+}
+//#endregion
+export { CachedRowModel_Filtered, ColumnDef_ColumnFiltering, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, Column_ColumnFiltering, CustomFilterFns, ExtractFilterFnKeys, ExtractFilterMeta, FilterFn, FilterFnOption, FilterFns, FilterMeta, ResolvedColumnFilter, RowModelFns_ColumnFiltering, Row_ColumnFiltering, TableOptions_ColumnFiltering, TableState_ColumnFiltering, Table_ColumnFiltering, Table_RowModels_Filtered, TransformFilterValueFn };
+//# sourceMappingURL=columnFilteringFeature.types.d.ts.map