@tanstack/table-core 9.0.0-beta.9 → 9.0.0

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

@@ -1,13 +1,22 @@
-import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
-import { BuiltInFilterFn } from "../../fns/filterFns.js";
+import { CellData, OnChangeFn, RowData, TransformDataValueFn, Updater } from "../../types/type-utils.js";
+import { BuiltInFilterFn } from "./filterFns.js";
 import { Column } from "../../types/Column.js";
 import { Row } from "../../types/Row.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table } from "../../types/Table.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
-
+import { IsAny, TableFeatures } from "../../types/TableFeatures.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;
@@ -17,24 +26,82 @@ interface ColumnFilter {
   id: string;
   value: unknown;
 }
-interface ResolvedColumnFilter<TFeatures extends TableFeatures, TData extends RowData> {
+interface ResolvedColumnFilter<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   filterFn: FilterFn<TFeatures, TData>;
   id: string;
   resolvedValue: unknown;
 }
-interface RowModelFns_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
-  filterFns: Record<keyof FilterFns, FilterFn<TFeatures, RowData>>;
+interface RowModelFns_ColumnFiltering<in out TFeatures extends TableFeatures, in out 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: FilterMeta) => void): boolean;
+interface FilterFn<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  (row: Row<TFeatures, TData>, columnId: string, filterValue: any, addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void): boolean;
+  /**
+   * Removes the filter from `state.columnFilters` when the filter value fails
+   * this test (e.g. empty strings for text filters).
+   *
+   * When provided, this test is authoritative: values it keeps stay in filter
+   * state even when they are empty strings, which the default heuristic would
+   * otherwise remove. An `undefined` filter value always clears the filter
+   * regardless.
+   */
   autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>;
+  /**
+   * Normalizes the filter value before filtering runs.
+   *
+   * The table applies this once per filter (not per row) and passes the
+   * resolved value to the filter function as `filterValue`.
+   */
   resolveFilterValue?: TransformFilterValueFn<TFeatures, TData>;
+  /**
+   * Normalizes each row's value before it is compared against the filter
+   * value. Only honored by filter functions built with `constructFilterFn`
+   * (including all built-in filter functions).
+   */
+  resolveDataValue?: TransformDataValueFn;
+}
+/**
+ * The definition object accepted by `constructFilterFn`.
+ *
+ * `filter` is a value-level comparator: it receives the row's (resolved) data
+ * value and the (resolved) filter value instead of the whole row, so
+ * normalization concerns stay in `resolveDataValue`/`resolveFilterValue`.
+ */
+interface FilterFnDef<in out TFeatures extends TableFeatures, in out TData extends RowData> {
+  filter: (dataValue: any, filterValue: any, row: Row<TFeatures, TData>, columnId: string, addMeta?: (meta: ExtractFilterMeta<TFeatures>) => void) => boolean;
+  autoRemove?: (filterValue: any) => boolean;
+  resolveFilterValue?: (filterValue: any) => any;
+  resolveDataValue?: TransformDataValueFn;
+}
+/**
+ * The shape returned by `constructFilterFn`: a `FilterFn` with its definition
+ * attached, so variants can be built by spreading it into another
+ * `constructFilterFn` call.
+ *
+ * The call signature is generic so a created filter function can be used with
+ * any table's rows, regardless of the feature set it was defined against.
+ */
+interface CreatedFilterFn<in out TFeatures extends TableFeatures, in out TData extends RowData> extends FilterFnDef<TFeatures, TData> {
+  <TRowFeatures extends TableFeatures, TRowData extends RowData>(row: Row<TRowFeatures, TRowData>, columnId: string, filterValue: any, addMeta?: (meta: ExtractFilterMeta<TRowFeatures>) => void): boolean;
 }
 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, RowData>>;
-type FilterFnOption<TFeatures extends TableFeatures, TData extends RowData> = 'auto' | BuiltInFilterFn | keyof FilterFns | FilterFn<TFeatures, RowData>;
-interface ColumnDef_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+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<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Enables this column to participate in column-specific filtering.
    *
@@ -47,7 +114,7 @@ interface ColumnDef_ColumnFiltering<TFeatures extends TableFeatures, TData exten
    */
   filterFn?: FilterFnOption<TFeatures, TData>;
 }
-interface Column_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+interface Column_ColumnFiltering<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Returns an automatically calculated filter function for the column based off of the columns first known value.
    */
@@ -80,7 +147,7 @@ interface Column_ColumnFiltering<TFeatures extends TableFeatures, TData extends
    */
   setFilterValue: (updater: Updater<any>) => void;
 }
-interface Row_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+interface Row_ColumnFiltering<in out TFeatures extends TableFeatures, in out _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.
    */
@@ -88,9 +155,9 @@ interface Row_ColumnFiltering<TFeatures extends TableFeatures, TData extends Row
   /**
    * 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, FilterMeta>;
+  columnFiltersMeta: Record<string, ExtractFilterMeta<TFeatures>>;
 }
-interface TableOptions_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
+interface TableOptions_ColumnFiltering<in out _TFeatures extends TableFeatures, in out _TData extends RowData> {
   /**
    * Enables column-specific filtering for all columns that also allow it.
    */
@@ -110,9 +177,9 @@ interface TableOptions_ColumnFiltering<TFeatures extends TableFeatures, TData ex
    */
   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.
-     */
+   * 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
@@ -133,7 +200,7 @@ interface Table_ColumnFiltering {
    */
   setColumnFilters: (updater: Updater<ColumnFiltersState>) => void;
 }
-interface Table_RowModels_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+interface Table_RowModels_Filtered<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   /**
    * Resolves the row model after column and global filters have been applied.
    */
@@ -143,18 +210,8 @@ interface Table_RowModels_Filtered<TFeatures extends TableFeatures, TData extend
    */
   getPreFilteredRowModel: () => RowModel<TFeatures, TData>;
 }
-interface CreateRowModel_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * If provided, this factory is called once per table and should return a
-   * function that calculates the filtered row model.
-   * - 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, pass the exported `createFilteredRowModel()` or implement your own factory.
-   */
-  filteredRowModel?: (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
-}
-interface CachedRowModel_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
+interface CachedRowModel_Filtered<in out TFeatures extends TableFeatures, in out TData extends RowData> {
   filteredRowModel: () => RowModel<TFeatures, TData>;
 }
 //#endregion
-export { CachedRowModel_Filtered, ColumnDef_ColumnFiltering, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, Column_ColumnFiltering, CreateRowModel_Filtered, CustomFilterFns, 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
+export { CachedRowModel_Filtered, ColumnDef_ColumnFiltering, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, Column_ColumnFiltering, CreatedFilterFn, CustomFilterFns, ExtractFilterFnKeys, ExtractFilterMeta, FilterFn, FilterFnDef, FilterFnOption, FilterFns, FilterMeta, ResolvedColumnFilter, RowModelFns_ColumnFiltering, Row_ColumnFiltering, TableOptions_ColumnFiltering, TableState_ColumnFiltering, Table_ColumnFiltering, Table_RowModels_Filtered, TransformFilterValueFn };

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

@@ -1,9 +1,8 @@
 import { CellData, RowData, Updater } from "../../types/type-utils.js";
+import { Column } from "../../types/Column.js";
 import { ColumnFiltersState, FilterFn } from "./columnFilteringFeature.types.js";
-import { Column_Internal } from "../../types/Column.js";
+import { Table } from "../../types/Table.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
-
 //#region src/features/column-filtering/columnFilteringFeature.utils.d.ts
 /**
  * Creates the default column filter state.
@@ -21,15 +20,19 @@ declare function getDefaultColumnFiltersState(): ColumnFiltersState;
  * Chooses a built-in filter function from the column's first core row value.
  *
  * Strings use `includesString`, numbers use `inNumberRange`, booleans and
- * objects use `equals`, arrays use `arrIncludes`, and unknown values fall back
- * to `weakEquals`.
+ * objects use `equals`, dates use `inDateRange`, arrays use `arrIncludes`,
+ * and unknown values fall back to `weakEquals`.
+ *
+ * The chosen filter function is looked up in the table's `filterFns`
+ * registry. When it is not registered there, this returns `undefined` and
+ * warns in development instead of substituting a different filter function.
  *
  * @example
  * ```ts
  * const filterFn = column_getAutoFilterFn(column)
  * ```
  */
-declare function column_getAutoFilterFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): FilterFn<TFeatures, RowData> | undefined;
+declare function column_getAutoFilterFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): FilterFn<TFeatures, TData> | undefined;
 /**
  * Resolves the filter function configured for a column.
  *
@@ -42,7 +45,7 @@ declare function column_getAutoFilterFn<TFeatures extends TableFeatures, TData e
  * const filterFn = column_getFilterFn(column)
  * ```
  */
-declare function column_getFilterFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): FilterFn<TFeatures, TData> | undefined;
+declare function column_getFilterFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): FilterFn<TFeatures, TData> | undefined;
 /**
  * Checks whether column filtering is enabled for this accessor column.
  *
@@ -54,7 +57,7 @@ declare function column_getFilterFn<TFeatures extends TableFeatures, TData exten
  * const canFilter = column_getCanFilter(column)
  * ```
  */
-declare function column_getCanFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+declare function column_getCanFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): boolean;
 /**
  * Checks whether this column currently has an entry in `state.columnFilters`.
  *
@@ -66,7 +69,7 @@ declare function column_getCanFilter<TFeatures extends TableFeatures, TData exte
  * const isFiltered = column_getIsFiltered(column)
  * ```
  */
-declare function column_getIsFiltered<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): boolean;
+declare function column_getIsFiltered<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): boolean;
 /**
  * Reads this column's current filter value from `state.columnFilters`.
  *
@@ -77,7 +80,7 @@ declare function column_getIsFiltered<TFeatures extends TableFeatures, TData ext
  * const value = column_getFilterValue(column)
  * ```
  */
-declare function column_getFilterValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): unknown;
+declare function column_getFilterValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): unknown;
 /**
  * Finds this column's position in the ordered `state.columnFilters` array.
  *
@@ -88,7 +91,7 @@ declare function column_getFilterValue<TFeatures extends TableFeatures, TData ex
  * const index = column_getFilterIndex(column)
  * ```
  */
-declare function column_getFilterIndex<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>): number;
+declare function column_getFilterIndex<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>): number;
 /**
  * Adds, updates, or removes this column's filter value.
  *
@@ -100,7 +103,7 @@ declare function column_getFilterIndex<TFeatures extends TableFeatures, TData ex
  * column_setFilterValue(column, (old) => String(old ?? '').trim())
  * ```
  */
-declare function column_setFilterValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column_Internal<TFeatures, TData, TValue>, value: any): void;
+declare function column_setFilterValue<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(column: Column<TFeatures, TData, TValue>, value: any): void;
 /**
  * Routes a column filter updater through the table's filter change handler.
  *
@@ -113,7 +116,7 @@ declare function column_setFilterValue<TFeatures extends TableFeatures, TData ex
  * table_setColumnFilters(table, (old) => old.filter((filter) => filter.id !== 'age'))
  * ```
  */
-declare function table_setColumnFilters<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, updater: Updater<ColumnFiltersState>): void;
+declare function table_setColumnFilters<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, updater: Updater<ColumnFiltersState>): void;
 /**
  * Resets `columnFilters` to the configured initial state or feature default.
  *
@@ -126,18 +129,22 @@ declare function table_setColumnFilters<TFeatures extends TableFeatures, TData e
  * table_resetColumnFilters(table, true)
  * ```
  */
-declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
+declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData extends RowData>(table: Table<TFeatures, TData>, defaultState?: boolean): void;
 /**
  * Returns whether a filter value should be removed from filter state.
  *
- * This checks the filter function's `autoRemove` hook and built-in empty-value rules.
+ * `undefined` always removes: it is the universal "clear this filter"
+ * sentinel used by `setFilterValue(undefined)` and functional updaters. For
+ * any other value, a filter function's `autoRemove` hook is authoritative
+ * when provided, so custom filter functions can keep values (such as empty
+ * strings) that the default heuristic would drop. Without an `autoRemove`
+ * hook, empty strings are removed.
  *
  * @example
  * ```ts
  * const removeFilter = shouldAutoRemoveFilter(filterFn, value, column)
  * ```
  */
-declare function shouldAutoRemoveFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(filterFn?: FilterFn<TFeatures, TData>, value?: any, column?: Column_Internal<TFeatures, TData, TValue>): boolean;
+declare function shouldAutoRemoveFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(filterFn?: FilterFn<TFeatures, TData>, value?: any, column?: Column<TFeatures, TData, TValue>): boolean;
 //#endregion
-export { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, shouldAutoRemoveFilter, table_resetColumnFilters, table_setColumnFilters };
-//# sourceMappingURL=columnFilteringFeature.utils.d.ts.map
+export { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, shouldAutoRemoveFilter, table_resetColumnFilters, table_setColumnFilters };

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

@@ -19,8 +19,12 @@ function getDefaultColumnFiltersState() {
 * Chooses a built-in filter function from the column's first core row value.
 *
 * Strings use `includesString`, numbers use `inNumberRange`, booleans and
-* objects use `equals`, arrays use `arrIncludes`, and unknown values fall back
-* to `weakEquals`.
+* objects use `equals`, dates use `inDateRange`, arrays use `arrIncludes`,
+* and unknown values fall back to `weakEquals`.
+*
+* The chosen filter function is looked up in the table's `filterFns`
+* registry. When it is not registered there, this returns `undefined` and
+* warns in development instead of substituting a different filter function.
 *
 * @example
 * ```ts
@@ -29,14 +33,26 @@ function getDefaultColumnFiltersState() {
 */
 function column_getAutoFilterFn(column) {
 	const filterFns = column.table._rowModelFns.filterFns;
-	const firstRow = column.table.getCoreRowModel().flatRows[0];
-	const value = firstRow ? firstRow.getValue(column.id) : void 0;
-	if (typeof value === "string") return filterFns === null || filterFns === void 0 ? void 0 : filterFns.includesString;
-	if (typeof value === "number") return filterFns === null || filterFns === void 0 ? void 0 : filterFns.inNumberRange;
-	if (typeof value === "boolean") return filterFns === null || filterFns === void 0 ? void 0 : filterFns.equals;
-	if (value !== null && typeof value === "object") return filterFns === null || filterFns === void 0 ? void 0 : filterFns.equals;
-	if (Array.isArray(value)) return filterFns === null || filterFns === void 0 ? void 0 : filterFns.arrIncludes;
-	return filterFns === null || filterFns === void 0 ? void 0 : filterFns.weakEquals;
+	const rows = column.table.getCoreRowModel().flatRows;
+	let value;
+	for (let i = 0; i < rows.length; i++) {
+		const rowValue = rows[i].getValue(column.id);
+		if (rowValue !== null && rowValue !== void 0) {
+			value = rowValue;
+			break;
+		}
+	}
+	let filterFnName;
+	if (typeof value === "string") filterFnName = "includesString";
+	else if (typeof value === "number") filterFnName = "inNumberRange";
+	else if (typeof value === "boolean") filterFnName = "equals";
+	else if (Array.isArray(value)) filterFnName = "arrIncludes";
+	else if (Object.prototype.toString.call(value) === "[object Date]") filterFnName = "inDateRange";
+	else if (value !== null && typeof value === "object") filterFnName = "equals";
+	else filterFnName = "weakEquals";
+	const filterFn = filterFns?.[filterFnName];
+	if (process.env.NODE_ENV === "development" && !filterFn) console.warn(`filterFn '${filterFnName}' (auto) for column '${column.id}' is not registered`);
+	return filterFn;
 }
 /**
 * Resolves the filter function configured for a column.
@@ -53,9 +69,9 @@ function column_getAutoFilterFn(column) {
 function column_getFilterFn(column) {
 	let filterFn = null;
 	const filterFns = column.table._rowModelFns.filterFns;
-	filterFn = isFunction(column.columnDef.filterFn) ? column.columnDef.filterFn : column.columnDef.filterFn === "auto" ? column_getAutoFilterFn(column) : filterFns === null || filterFns === void 0 ? void 0 : filterFns[column.columnDef.filterFn];
-	if (process.env.NODE_ENV === "development" && !filterFn) console.warn(`Could not find a valid 'column.filterFn' for column with the ID: ${column.id}.`);
-	return filterFn;
+	filterFn = isFunction(column.columnDef.filterFn) ? column.columnDef.filterFn : column.columnDef.filterFn === "auto" ? column_getAutoFilterFn(column) : filterFns?.[column.columnDef.filterFn];
+	if (process.env.NODE_ENV === "development" && !filterFn && column.columnDef.filterFn !== "auto") console.warn(`filterFn '${String(column.columnDef.filterFn)}' for column '${column.id}' is not registered`);
+	return filterFn ?? void 0;
 }
 /**
 * Checks whether column filtering is enabled for this accessor column.
@@ -96,8 +112,7 @@ function column_getIsFiltered(column) {
 * ```
 */
 function column_getFilterValue(column) {
-	var _column$table$atoms$c;
-	return (_column$table$atoms$c = column.table.atoms.columnFilters) === null || _column$table$atoms$c === void 0 || (_column$table$atoms$c = _column$table$atoms$c.get()) === null || _column$table$atoms$c === void 0 || (_column$table$atoms$c = _column$table$atoms$c.find((d) => d.id === column.id)) === null || _column$table$atoms$c === void 0 ? void 0 : _column$table$atoms$c.value;
+	return column.table.atoms.columnFilters?.get()?.find((d) => d.id === column.id)?.value;
 }
 /**
 * Finds this column's position in the ordered `state.columnFilters` array.
@@ -110,8 +125,7 @@ function column_getFilterValue(column) {
 * ```
 */
 function column_getFilterIndex(column) {
-	var _column$table$atoms$c2;
-	return ((_column$table$atoms$c2 = column.table.atoms.columnFilters) === null || _column$table$atoms$c2 === void 0 || (_column$table$atoms$c2 = _column$table$atoms$c2.get()) === null || _column$table$atoms$c2 === void 0 ? void 0 : _column$table$atoms$c2.findIndex((d) => d.id === column.id)) ?? -1;
+	return column.table.atoms.columnFilters?.get()?.findIndex((d) => d.id === column.id) ?? -1;
 }
 /**
 * Adds, updates, or removes this column's filter value.
@@ -155,7 +169,6 @@ function column_setFilterValue(column, value) {
 * ```
 */
 function table_setColumnFilters(table, updater) {
-	var _table$options$onColu, _table$options;
 	const leafColumnsById = table.getAllLeafColumnsById();
 	const updateFn = (old) => {
 		return functionalUpdate(updater, old).filter((filter) => {
@@ -166,7 +179,7 @@ function table_setColumnFilters(table, updater) {
 			return true;
 		});
 	};
-	(_table$options$onColu = (_table$options = table.options).onColumnFiltersChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updateFn);
+	table.options.onColumnFiltersChange?.(updateFn);
 }
 /**
 * Resets `columnFilters` to the configured initial state or feature default.
@@ -186,7 +199,12 @@ function table_resetColumnFilters(table, defaultState) {
 /**
 * Returns whether a filter value should be removed from filter state.
 *
-* This checks the filter function's `autoRemove` hook and built-in empty-value rules.
+* `undefined` always removes: it is the universal "clear this filter"
+* sentinel used by `setFilterValue(undefined)` and functional updaters. For
+* any other value, a filter function's `autoRemove` hook is authoritative
+* when provided, so custom filter functions can keep values (such as empty
+* strings) that the default heuristic would drop. Without an `autoRemove`
+* hook, empty strings are removed.
 *
 * @example
 * ```ts
@@ -194,9 +212,10 @@ function table_resetColumnFilters(table, defaultState) {
 * ```
 */
 function shouldAutoRemoveFilter(filterFn, value, column) {
-	return (filterFn && filterFn.autoRemove ? filterFn.autoRemove(value, column) : false) || typeof value === "undefined" || typeof value === "string" && !value;
+	if (typeof value === "undefined") return true;
+	if (filterFn?.autoRemove) return !!filterFn.autoRemove(value, column);
+	return typeof value === "string" && !value;
 }
 
 //#endregion
-export { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, shouldAutoRemoveFilter, table_resetColumnFilters, table_setColumnFilters };
-//# sourceMappingURL=columnFilteringFeature.utils.js.map
+export { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, shouldAutoRemoveFilter, table_resetColumnFilters, table_setColumnFilters };

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

@@ -1,16 +1,20 @@
 import { RowData } from "../../types/type-utils.js";
-import { FilterFn, FilterFns } from "./columnFilteringFeature.types.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table } from "../../types/Table.js";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.js";
-
+import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
 //#region src/features/column-filtering/createFilteredRowModel.d.ts
 /**
  * Creates a memoized filtered row model factory.
  *
  * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+ *
+ * Register the filter functions you use with the `filterFns` slot on the
+ * `features` option:
+ * `tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), filterFns: { includesString: filterFn_includesString } })`.
+ * Importing individual `filterFn_*` functions keeps unused built-ins out of
+ * your bundle; filter functions passed directly to the `filterFn` column
+ * option need no registration at all.
  */
-declare function createFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(filterFns: Record<keyof FilterFns, FilterFn<TFeatures, RowData>>): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
+declare function createFilteredRowModel<TFeatures extends TableFeatures, TData extends RowData = any>(): (table: Table<TFeatures, TData>) => () => RowModel<TFeatures, TData>;
 //#endregion
-export { createFilteredRowModel };
-//# sourceMappingURL=createFilteredRowModel.d.ts.map
+export { createFilteredRowModel };

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

@@ -1,4 +1,4 @@
-import { tableMemo } from "../../utils.js";
+import { makeObjectMap, skipFirstRun, tableMemo } from "../../utils.js";
 import { table_getColumn } from "../../core/columns/coreColumnsFeature.utils.js";
 import { table_autoResetPageIndex } from "../row-pagination/rowPaginationFeature.utils.js";
 import { column_getFilterFn } from "./columnFilteringFeature.utils.js";
@@ -10,78 +10,82 @@ import { filterRows } from "./filterRowsUtils.js";
 * Creates a memoized filtered row model factory.
 *
 * The factory reads the relevant table state atoms and options, then returns a row model function used by the table row-model pipeline.
+*
+* Register the filter functions you use with the `filterFns` slot on the
+* `features` option:
+* `tableFeatures({ columnFilteringFeature, filteredRowModel: createFilteredRowModel(), filterFns: { includesString: filterFn_includesString } })`.
+* Importing individual `filterFn_*` functions keeps unused built-ins out of
+* your bundle; filter functions passed directly to the `filterFn` column
+* option need no registration at all.
 */
-function createFilteredRowModel(filterFns) {
+function createFilteredRowModel() {
 	return (_table) => {
 		const table = _table;
-		if (!table._rowModelFns.filterFns) table._rowModelFns.filterFns = filterFns;
 		return tableMemo({
 			feature: "columnFilteringFeature",
 			table,
 			fnName: "table.getFilteredRowModel",
-			memoDeps: () => {
-				var _table$atoms$columnFi, _table$atoms$globalFi;
-				return [
-					table.getPreFilteredRowModel(),
-					(_table$atoms$columnFi = table.atoms.columnFilters) === null || _table$atoms$columnFi === void 0 ? void 0 : _table$atoms$columnFi.get(),
-					(_table$atoms$globalFi = table.atoms.globalFilter) === null || _table$atoms$globalFi === void 0 ? void 0 : _table$atoms$globalFi.get()
-				];
-			},
+			memoDeps: () => [
+				table.getPreFilteredRowModel(),
+				table.atoms.columnFilters?.get(),
+				table.atoms.globalFilter?.get()
+			],
 			fn: () => _createFilteredRowModel(table),
-			onAfterUpdate: () => table_autoResetPageIndex(table)
+			onAfterUpdate: skipFirstRun(() => table_autoResetPageIndex(table))
 		});
 	};
 }
 function _createFilteredRowModel(table) {
-	var _table$atoms$columnFi2, _table$atoms$globalFi2;
 	const rowModel = table.getPreFilteredRowModel();
-	const columnFilters = (_table$atoms$columnFi2 = table.atoms.columnFilters) === null || _table$atoms$columnFi2 === void 0 ? void 0 : _table$atoms$columnFi2.get();
-	const globalFilter = (_table$atoms$globalFi2 = table.atoms.globalFilter) === null || _table$atoms$globalFi2 === void 0 ? void 0 : _table$atoms$globalFi2.get();
-	if (!rowModel.rows.length || !(columnFilters === null || columnFilters === void 0 ? void 0 : columnFilters.length) && !globalFilter) {
+	const columnFilters = table.atoms.columnFilters?.get();
+	const globalFilter = table.atoms.globalFilter?.get();
+	const hasGlobalFilter = globalFilter !== void 0 && globalFilter !== null && globalFilter !== "";
+	if (!rowModel.rows.length || !columnFilters?.length && !hasGlobalFilter) {
 		const flatRows = rowModel.flatRows;
 		for (let i = 0; i < flatRows.length; i++) {
 			const row = flatRows[i];
-			row.columnFilters = {};
-			row.columnFiltersMeta = {};
+			row.columnFilters = makeObjectMap();
+			row.columnFiltersMeta = makeObjectMap();
 		}
 		return rowModel;
 	}
 	const resolvedColumnFilters = [];
 	const resolvedGlobalFilters = [];
-	columnFilters === null || columnFilters === void 0 || columnFilters.forEach((columnFilter) => {
-		var _filterFn$resolveFilt;
+	columnFilters?.forEach((columnFilter) => {
 		const column = table_getColumn(table, columnFilter.id);
 		if (!column) return;
 		const filterFn = column_getFilterFn(column);
+		if (!filterFn) return;
 		resolvedColumnFilters.push({
 			id: columnFilter.id,
 			filterFn,
-			resolvedValue: ((_filterFn$resolveFilt = filterFn.resolveFilterValue) === null || _filterFn$resolveFilt === void 0 ? void 0 : _filterFn$resolveFilt.call(filterFn, columnFilter.value)) ?? columnFilter.value
+			resolvedValue: filterFn.resolveFilterValue?.(columnFilter.value) ?? columnFilter.value
 		});
 	});
-	const filterableIds = (columnFilters === null || columnFilters === void 0 ? void 0 : columnFilters.map((d) => d.id)) ?? [];
+	const filterableIds = columnFilters?.map((d) => d.id) ?? [];
 	const globalFilterFn = table_getGlobalFilterFn(table);
 	const globallyFilterableColumns = table.getAllLeafColumns().filter((column) => column_getCanGlobalFilter(column));
-	if (globalFilter && globalFilterFn && globallyFilterableColumns.length) {
+	if (hasGlobalFilter && globalFilterFn && globallyFilterableColumns.length) {
 		filterableIds.push("__global__");
 		globallyFilterableColumns.forEach((column) => {
-			var _globalFilterFn$resol;
 			resolvedGlobalFilters.push({
 				id: column.id,
 				filterFn: globalFilterFn,
-				resolvedValue: ((_globalFilterFn$resol = globalFilterFn.resolveFilterValue) === null || _globalFilterFn$resol === void 0 ? void 0 : _globalFilterFn$resol.call(globalFilterFn, globalFilter)) ?? globalFilter
+				resolvedValue: globalFilterFn.resolveFilterValue?.(globalFilter) ?? globalFilter
 			});
 		});
 	}
 	const flatRows = rowModel.flatRows;
 	for (let i = 0; i < flatRows.length; i++) {
 		const row = flatRows[i];
-		row.columnFilters = {};
+		row.columnFilters = makeObjectMap();
+		row.columnFiltersMeta = makeObjectMap();
 		if (resolvedColumnFilters.length) for (let j = 0; j < resolvedColumnFilters.length; j++) {
 			const currentColumnFilter = resolvedColumnFilters[j];
 			const id = currentColumnFilter.id;
 			row.columnFilters[id] = currentColumnFilter.filterFn(row, id, currentColumnFilter.resolvedValue, (filterMeta) => {
-				!row.columnFiltersMeta ? row.columnFiltersMeta = {} : row.columnFiltersMeta[id] = filterMeta;
+				if (!row.columnFiltersMeta) row.columnFiltersMeta = makeObjectMap();
+				row.columnFiltersMeta[id] = filterMeta;
 			});
 		}
 		if (resolvedGlobalFilters.length) {
@@ -89,7 +93,8 @@ function _createFilteredRowModel(table) {
 				const currentGlobalFilter = resolvedGlobalFilters[j];
 				const id = currentGlobalFilter.id;
 				if (currentGlobalFilter.filterFn(row, id, currentGlobalFilter.resolvedValue, (filterMeta) => {
-					!row.columnFiltersMeta ? row.columnFiltersMeta = {} : row.columnFiltersMeta[id] = filterMeta;
+					if (!row.columnFiltersMeta) row.columnFiltersMeta = makeObjectMap();
+					row.columnFiltersMeta[id] = filterMeta;
 				})) {
 					row.columnFilters.__global__ = true;
 					break;
@@ -106,5 +111,4 @@ function _createFilteredRowModel(table) {
 }
 
 //#endregion
-export { createFilteredRowModel };
-//# sourceMappingURL=createFilteredRowModel.js.map
+export { createFilteredRowModel };