@tanstack/table-core 9.0.0-beta.5 → 9.0.0-beta.50

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

@@ -1,13 +1,23 @@
-import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.js";
-import { BuiltInFilterFn } from "../../fns/filterFns.js";
-import { Column } from "../../types/Column.js";
+import { CellData, OnChangeFn, RowData, TransformDataValueFn, Updater } from "../../types/type-utils.js";
+import { BuiltInFilterFn } from "./filterFns.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 { Column } from "../../types/Column.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 +27,77 @@ 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).
+   */
   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 +110,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 +143,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 +151,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.
    */
@@ -133,7 +196,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 +206,9 @@ 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 };
+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 };
 //# sourceMappingURL=columnFilteringFeature.types.d.ts.map

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

@@ -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
@@ -31,12 +35,17 @@ 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;
+	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 +62,9 @@ function column_getAutoFilterFn(column) {
 function column_getFilterFn(column) {
 	let filterFn = null;
 	const filterFns = column.table._rowModelFns.filterFns;
-	filterFn = require_utils.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 = require_utils.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 +105,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 +118,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 +162,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 require_utils.functionalUpdate(updater, old).filter((filter) => {
@@ -166,7 +172,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.

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

@@ -1 +1 @@
-{"version":3,"file":"columnFilteringFeature.utils.cjs","names":["isFunction","functionalUpdate","cloneState"],"sources":["../../../src/features/column-filtering/columnFilteringFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate, isFunction } from '../../utils'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Column_Internal } from '../../types/Column'\nimport type {\n  ColumnFiltersState,\n  FilterFn,\n} from './columnFilteringFeature.types'\n\n/**\n * Creates the default column filter state.\n *\n * The feature default is an empty array, meaning no column filters are active.\n * Reset APIs use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const filters = getDefaultColumnFiltersState()\n * ```\n */\nexport function getDefaultColumnFiltersState(): ColumnFiltersState {\n  return []\n}\n\n/**\n * Chooses a built-in filter function from the column's first core row value.\n *\n * Strings use `includesString`, numbers use `inNumberRange`, booleans and\n * objects use `equals`, arrays use `arrIncludes`, and unknown values fall back\n * to `weakEquals`.\n *\n * @example\n * ```ts\n * const filterFn = column_getAutoFilterFn(column)\n * ```\n */\nexport function column_getAutoFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const filterFns: Record<string, FilterFn<TFeatures, RowData>> | undefined =\n    column.table._rowModelFns.filterFns\n\n  const firstRow = column.table.getCoreRowModel().flatRows[0]\n\n  const value = firstRow ? firstRow.getValue(column.id) : undefined\n\n  if (typeof value === 'string') {\n    return filterFns?.includesString\n  }\n\n  if (typeof value === 'number') {\n    return filterFns?.inNumberRange\n  }\n\n  if (typeof value === 'boolean') {\n    return filterFns?.equals\n  }\n\n  if (value !== null && typeof value === 'object') {\n    return filterFns?.equals\n  }\n\n  if (Array.isArray(value)) {\n    return filterFns?.arrIncludes\n  }\n\n  return filterFns?.weakEquals\n}\n\n/**\n * Resolves the filter function configured for a column.\n *\n * Function-valued `columnDef.filterFn` is returned directly, `'auto'` delegates\n * to `column_getAutoFilterFn`, and string values are looked up in the table's\n * filter function registry.\n *\n * @example\n * ```ts\n * const filterFn = column_getFilterFn(column)\n * ```\n */\nexport function column_getFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n): FilterFn<TFeatures, TData> | undefined {\n  let filterFn = null\n  const filterFns: Record<string, FilterFn<TFeatures, RowData>> | undefined =\n    column.table._rowModelFns.filterFns\n  filterFn = isFunction(column.columnDef.filterFn)\n    ? column.columnDef.filterFn\n    : column.columnDef.filterFn === 'auto'\n      ? column_getAutoFilterFn(column)\n      : filterFns?.[column.columnDef.filterFn as string]\n\n  if (process.env.NODE_ENV === 'development' && !filterFn) {\n    console.warn(\n      `Could not find a valid 'column.filterFn' for column with the ID: ${column.id}.`,\n    )\n  }\n\n  return filterFn as FilterFn<TFeatures, TData> | undefined\n}\n\n/**\n * Checks whether column filtering is enabled for this accessor column.\n *\n * The column must have an accessor and filtering must be enabled by the column\n * definition, `enableColumnFilters`, and the table-wide `enableFilters` option.\n *\n * @example\n * ```ts\n * const canFilter = column_getCanFilter(column)\n * ```\n */\nexport function column_getCanFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    (column.columnDef.enableColumnFilter ?? true) &&\n    (column.table.options.enableColumnFilters ?? true) &&\n    (column.table.options.enableFilters ?? true) &&\n    !!column.accessorFn\n  )\n}\n\n/**\n * Checks whether this column currently has an entry in `state.columnFilters`.\n *\n * This only reflects filter state presence; it does not indicate whether the\n * filter removes any rows.\n *\n * @example\n * ```ts\n * const isFiltered = column_getIsFiltered(column)\n * ```\n */\nexport function column_getIsFiltered<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return column_getFilterIndex(column) > -1\n}\n\n/**\n * Reads this column's current filter value from `state.columnFilters`.\n *\n * Missing filter entries return `undefined`.\n *\n * @example\n * ```ts\n * const value = column_getFilterValue(column)\n * ```\n */\nexport function column_getFilterValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return column.table.atoms.columnFilters\n    ?.get()\n    ?.find((d) => d.id === column.id)?.value\n}\n\n/**\n * Finds this column's position in the ordered `state.columnFilters` array.\n *\n * The result is `-1` when the column has no active filter.\n *\n * @example\n * ```ts\n * const index = column_getFilterIndex(column)\n * ```\n */\nexport function column_getFilterIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): number {\n  return (\n    column.table.atoms.columnFilters\n      ?.get()\n      ?.findIndex((d) => d.id === column.id) ?? -1\n  )\n}\n\n/**\n * Adds, updates, or removes this column's filter value.\n *\n * The incoming value may be an updater. After resolution, `autoRemove` rules\n * decide whether the filter should be removed instead of stored.\n *\n * @example\n * ```ts\n * column_setFilterValue(column, (old) => String(old ?? '').trim())\n * ```\n */\nexport function column_setFilterValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>, value: any) {\n  table_setColumnFilters(column.table, (old) => {\n    const filterFn = column_getFilterFn(column)\n    const previousFilter = old.find((d) => d.id === column.id)\n\n    const newFilter = functionalUpdate(\n      value,\n      previousFilter ? previousFilter.value : undefined,\n    )\n\n    if (shouldAutoRemoveFilter(filterFn, newFilter, column)) {\n      return old.filter((d) => d.id !== column.id)\n    }\n\n    const newFilterObj = { id: column.id, value: newFilter }\n\n    if (previousFilter) {\n      return old.map((d) => {\n        if (d.id === column.id) {\n          return newFilterObj\n        }\n        return d\n      })\n    }\n\n    if (old.length) {\n      return [...old, newFilterObj]\n    }\n\n    return [newFilterObj]\n  })\n}\n\n/**\n * Routes a column filter updater through the table's filter change handler.\n *\n * The resolved filters are cleaned before they are emitted: filters for known\n * columns are removed when their filter function says the value should be\n * auto-removed.\n *\n * @example\n * ```ts\n * table_setColumnFilters(table, (old) => old.filter((filter) => filter.id !== 'age'))\n * ```\n */\nexport function table_setColumnFilters<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<ColumnFiltersState>,\n) {\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const updateFn = (old: ColumnFiltersState) => {\n    return functionalUpdate(updater, old).filter((filter) => {\n      const column = leafColumnsById[filter.id]\n\n      if (column) {\n        const filterFn = column_getFilterFn(column)\n\n        if (shouldAutoRemoveFilter(filterFn, filter.value, column)) {\n          return false\n        }\n      }\n\n      return true\n    })\n  }\n\n  table.options.onColumnFiltersChange?.(updateFn)\n}\n\n/**\n * Resets `columnFilters` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.columnFilters` when it\n * exists. Passing `true` ignores initial state and resets to `[]`.\n *\n * @example\n * ```ts\n * table_resetColumnFilters(table)\n * table_resetColumnFilters(table, true)\n * ```\n */\nexport function table_resetColumnFilters<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setColumnFilters(\n    table,\n    defaultState ? [] : cloneState(table.initialState.columnFilters ?? []),\n  )\n}\n\n/**\n * Returns whether a filter value should be removed from filter state.\n *\n * This checks the filter function's `autoRemove` hook and built-in empty-value rules.\n *\n * @example\n * ```ts\n * const removeFilter = shouldAutoRemoveFilter(filterFn, value, column)\n * ```\n */\nexport function shouldAutoRemoveFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  filterFn?: FilterFn<TFeatures, TData>,\n  value?: any,\n  column?: Column_Internal<TFeatures, TData, TValue>,\n) {\n  return (\n    (filterFn && filterFn.autoRemove\n      ? filterFn.autoRemove(value, column as Column_Internal<TFeatures, TData>)\n      : false) ||\n    typeof value === 'undefined' ||\n    (typeof value === 'string' && !value)\n  )\n}\n"],"mappings":"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"}
+{"version":3,"file":"columnFilteringFeature.utils.cjs","names":["isFunction","functionalUpdate","cloneState"],"sources":["../../../src/features/column-filtering/columnFilteringFeature.utils.ts"],"sourcesContent":["import { cloneState, functionalUpdate, isFunction } from '../../utils'\nimport type { CellData, RowData, Updater } from '../../types/type-utils'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { Table_Internal } from '../../types/Table'\nimport type { Column_Internal } from '../../types/Column'\nimport type {\n  ColumnFiltersState,\n  FilterFn,\n} from './columnFilteringFeature.types'\n\n/**\n * Creates the default column filter state.\n *\n * The feature default is an empty array, meaning no column filters are active.\n * Reset APIs use this value when `defaultState` is `true`.\n *\n * @example\n * ```ts\n * const filters = getDefaultColumnFiltersState()\n * ```\n */\nexport function getDefaultColumnFiltersState(): ColumnFiltersState {\n  return []\n}\n\n/**\n * Chooses a built-in filter function from the column's first core row value.\n *\n * Strings use `includesString`, numbers use `inNumberRange`, booleans and\n * objects use `equals`, dates use `inDateRange`, arrays use `arrIncludes`,\n * and unknown values fall back to `weakEquals`.\n *\n * The chosen filter function is looked up in the table's `filterFns`\n * registry. When it is not registered there, this returns `undefined` and\n * warns in development instead of substituting a different filter function.\n *\n * @example\n * ```ts\n * const filterFn = column_getAutoFilterFn(column)\n * ```\n */\nexport function column_getAutoFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  const filterFns: Record<string, FilterFn<TFeatures, TData>> | undefined =\n    column.table._rowModelFns.filterFns\n\n  const firstRow = column.table.getCoreRowModel().flatRows[0]\n\n  const value = firstRow ? firstRow.getValue(column.id) : undefined\n\n  let filterFnName: string\n\n  if (typeof value === 'string') {\n    filterFnName = 'includesString'\n  } else if (typeof value === 'number') {\n    filterFnName = 'inNumberRange'\n  } else if (typeof value === 'boolean') {\n    filterFnName = 'equals'\n  } else if (Array.isArray(value)) {\n    filterFnName = 'arrIncludes'\n  } else if (Object.prototype.toString.call(value) === '[object Date]') {\n    filterFnName = 'inDateRange'\n  } else if (value !== null && typeof value === 'object') {\n    filterFnName = 'equals'\n  } else {\n    filterFnName = 'weakEquals'\n  }\n\n  const filterFn = filterFns?.[filterFnName]\n\n  if (process.env.NODE_ENV === 'development' && !filterFn) {\n    console.warn(\n      `filterFn '${filterFnName}' (auto) for column '${column.id}' is not registered`,\n    )\n  }\n\n  return filterFn\n}\n\n/**\n * Resolves the filter function configured for a column.\n *\n * Function-valued `columnDef.filterFn` is returned directly, `'auto'` delegates\n * to `column_getAutoFilterFn`, and string values are looked up in the table's\n * filter function registry.\n *\n * @example\n * ```ts\n * const filterFn = column_getFilterFn(column)\n * ```\n */\nexport function column_getFilterFn<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  column: Column_Internal<TFeatures, TData, TValue>,\n): FilterFn<TFeatures, TData> | undefined {\n  let filterFn = null\n  const filterFns: Record<string, FilterFn<TFeatures, TData>> | undefined =\n    column.table._rowModelFns.filterFns\n  filterFn = isFunction(column.columnDef.filterFn)\n    ? column.columnDef.filterFn\n    : column.columnDef.filterFn === 'auto'\n      ? column_getAutoFilterFn(column)\n      : filterFns?.[column.columnDef.filterFn as string]\n\n  if (\n    process.env.NODE_ENV === 'development' &&\n    !filterFn &&\n    column.columnDef.filterFn !== 'auto' // the auto picker warns on its own\n  ) {\n    console.warn(\n      `filterFn '${String(column.columnDef.filterFn)}' for column '${column.id}' is not registered`,\n    )\n  }\n\n  return filterFn ?? undefined\n}\n\n/**\n * Checks whether column filtering is enabled for this accessor column.\n *\n * The column must have an accessor and filtering must be enabled by the column\n * definition, `enableColumnFilters`, and the table-wide `enableFilters` option.\n *\n * @example\n * ```ts\n * const canFilter = column_getCanFilter(column)\n * ```\n */\nexport function column_getCanFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return (\n    (column.columnDef.enableColumnFilter ?? true) &&\n    (column.table.options.enableColumnFilters ?? true) &&\n    (column.table.options.enableFilters ?? true) &&\n    !!column.accessorFn\n  )\n}\n\n/**\n * Checks whether this column currently has an entry in `state.columnFilters`.\n *\n * This only reflects filter state presence; it does not indicate whether the\n * filter removes any rows.\n *\n * @example\n * ```ts\n * const isFiltered = column_getIsFiltered(column)\n * ```\n */\nexport function column_getIsFiltered<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return column_getFilterIndex(column) > -1\n}\n\n/**\n * Reads this column's current filter value from `state.columnFilters`.\n *\n * Missing filter entries return `undefined`.\n *\n * @example\n * ```ts\n * const value = column_getFilterValue(column)\n * ```\n */\nexport function column_getFilterValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>) {\n  return column.table.atoms.columnFilters\n    ?.get()\n    ?.find((d) => d.id === column.id)?.value\n}\n\n/**\n * Finds this column's position in the ordered `state.columnFilters` array.\n *\n * The result is `-1` when the column has no active filter.\n *\n * @example\n * ```ts\n * const index = column_getFilterIndex(column)\n * ```\n */\nexport function column_getFilterIndex<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>): number {\n  return (\n    column.table.atoms.columnFilters\n      ?.get()\n      ?.findIndex((d) => d.id === column.id) ?? -1\n  )\n}\n\n/**\n * Adds, updates, or removes this column's filter value.\n *\n * The incoming value may be an updater. After resolution, `autoRemove` rules\n * decide whether the filter should be removed instead of stored.\n *\n * @example\n * ```ts\n * column_setFilterValue(column, (old) => String(old ?? '').trim())\n * ```\n */\nexport function column_setFilterValue<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(column: Column_Internal<TFeatures, TData, TValue>, value: any) {\n  table_setColumnFilters(column.table, (old) => {\n    const filterFn = column_getFilterFn(column)\n    const previousFilter = old.find((d) => d.id === column.id)\n\n    const newFilter = functionalUpdate(\n      value,\n      previousFilter ? previousFilter.value : undefined,\n    )\n\n    if (shouldAutoRemoveFilter(filterFn, newFilter, column)) {\n      return old.filter((d) => d.id !== column.id)\n    }\n\n    const newFilterObj = { id: column.id, value: newFilter }\n\n    if (previousFilter) {\n      return old.map((d) => {\n        if (d.id === column.id) {\n          return newFilterObj\n        }\n        return d\n      })\n    }\n\n    if (old.length) {\n      return [...old, newFilterObj]\n    }\n\n    return [newFilterObj]\n  })\n}\n\n/**\n * Routes a column filter updater through the table's filter change handler.\n *\n * The resolved filters are cleaned before they are emitted: filters for known\n * columns are removed when their filter function says the value should be\n * auto-removed.\n *\n * @example\n * ```ts\n * table_setColumnFilters(table, (old) => old.filter((filter) => filter.id !== 'age'))\n * ```\n */\nexport function table_setColumnFilters<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  updater: Updater<ColumnFiltersState>,\n) {\n  const leafColumnsById = table.getAllLeafColumnsById()\n\n  const updateFn = (old: ColumnFiltersState) => {\n    return functionalUpdate(updater, old).filter((filter) => {\n      const column = leafColumnsById[filter.id]\n\n      if (column) {\n        const filterFn = column_getFilterFn(column)\n\n        if (shouldAutoRemoveFilter(filterFn, filter.value, column)) {\n          return false\n        }\n      }\n\n      return true\n    })\n  }\n\n  table.options.onColumnFiltersChange?.(updateFn)\n}\n\n/**\n * Resets `columnFilters` to the configured initial state or feature default.\n *\n * With no argument, the reset clones `table.initialState.columnFilters` when it\n * exists. Passing `true` ignores initial state and resets to `[]`.\n *\n * @example\n * ```ts\n * table_resetColumnFilters(table)\n * table_resetColumnFilters(table, true)\n * ```\n */\nexport function table_resetColumnFilters<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean) {\n  table_setColumnFilters(\n    table,\n    defaultState ? [] : cloneState(table.initialState.columnFilters ?? []),\n  )\n}\n\n/**\n * Returns whether a filter value should be removed from filter state.\n *\n * This checks the filter function's `autoRemove` hook and built-in empty-value rules.\n *\n * @example\n * ```ts\n * const removeFilter = shouldAutoRemoveFilter(filterFn, value, column)\n * ```\n */\nexport function shouldAutoRemoveFilter<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n  TValue extends CellData = CellData,\n>(\n  filterFn?: FilterFn<TFeatures, TData>,\n  value?: any,\n  column?: Column_Internal<TFeatures, TData, TValue>,\n) {\n  return (\n    (filterFn && filterFn.autoRemove\n      ? filterFn.autoRemove(value, column as any)\n      : false) ||\n    typeof value === 'undefined' ||\n    (typeof value === 'string' && !value)\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;AAqBA,SAAgB,+BAAmD;CACjE,OAAO,CAAC;AACV;;;;;;;;;;;;;;;;;AAkBA,SAAgB,uBAId,QAAmD;CACnD,MAAM,YACJ,OAAO,MAAM,aAAa;CAE5B,MAAM,WAAW,OAAO,MAAM,gBAAgB,CAAC,CAAC,SAAS;CAEzD,MAAM,QAAQ,WAAW,SAAS,SAAS,OAAO,EAAE,IAAI;CAExD,IAAI;CAEJ,IAAI,OAAO,UAAU,UACnB,eAAe;MACV,IAAI,OAAO,UAAU,UAC1B,eAAe;MACV,IAAI,OAAO,UAAU,WAC1B,eAAe;MACV,IAAI,MAAM,QAAQ,KAAK,GAC5B,eAAe;MACV,IAAI,OAAO,UAAU,SAAS,KAAK,KAAK,MAAM,iBACnD,eAAe;MACV,IAAI,UAAU,QAAQ,OAAO,UAAU,UAC5C,eAAe;MAEf,eAAe;CAGjB,MAAM,WAAW,YAAY;CAE7B,IAAI,QAAQ,IAAI,aAAa,iBAAiB,CAAC,UAC7C,QAAQ,KACN,aAAa,aAAa,uBAAuB,OAAO,GAAG,oBAC7D;CAGF,OAAO;AACT;;;;;;;;;;;;;AAcA,SAAgB,mBAKd,QACwC;CACxC,IAAI,WAAW;CACf,MAAM,YACJ,OAAO,MAAM,aAAa;CAC5B,WAAWA,yBAAW,OAAO,UAAU,QAAQ,IAC3C,OAAO,UAAU,WACjB,OAAO,UAAU,aAAa,SAC5B,uBAAuB,MAAM,IAC7B,YAAY,OAAO,UAAU;CAEnC,IACE,QAAQ,IAAI,aAAa,iBACzB,CAAC,YACD,OAAO,UAAU,aAAa,QAE9B,QAAQ,KACN,aAAa,OAAO,OAAO,UAAU,QAAQ,EAAE,gBAAgB,OAAO,GAAG,oBAC3E;CAGF,OAAO,YAAY;AACrB;;;;;;;;;;;;AAaA,SAAgB,oBAId,QAAmD;CACnD,QACG,OAAO,UAAU,sBAAsB,UACvC,OAAO,MAAM,QAAQ,uBAAuB,UAC5C,OAAO,MAAM,QAAQ,iBAAiB,SACvC,CAAC,CAAC,OAAO;AAEb;;;;;;;;;;;;AAaA,SAAgB,qBAId,QAAmD;CACnD,OAAO,sBAAsB,MAAM,IAAI;AACzC;;;;;;;;;;;AAYA,SAAgB,sBAId,QAAmD;CACnD,OAAO,OAAO,MAAM,MAAM,eACtB,IAAI,CAAC,EACL,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE,CAAC,EAAE;AACvC;;;;;;;;;;;AAYA,SAAgB,sBAId,QAA2D;CAC3D,OACE,OAAO,MAAM,MAAM,eACf,IAAI,CAAC,EACL,WAAW,MAAM,EAAE,OAAO,OAAO,EAAE,KAAK;AAEhD;;;;;;;;;;;;AAaA,SAAgB,sBAId,QAAmD,OAAY;CAC/D,uBAAuB,OAAO,QAAQ,QAAQ;EAC5C,MAAM,WAAW,mBAAmB,MAAM;EAC1C,MAAM,iBAAiB,IAAI,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE;EAEzD,MAAM,YAAYC,+BAChB,OACA,iBAAiB,eAAe,QAAQ,MAC1C;EAEA,IAAI,uBAAuB,UAAU,WAAW,MAAM,GACpD,OAAO,IAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,EAAE;EAG7C,MAAM,eAAe;GAAE,IAAI,OAAO;GAAI,OAAO;EAAU;EAEvD,IAAI,gBACF,OAAO,IAAI,KAAK,MAAM;GACpB,IAAI,EAAE,OAAO,OAAO,IAClB,OAAO;GAET,OAAO;EACT,CAAC;EAGH,IAAI,IAAI,QACN,OAAO,CAAC,GAAG,KAAK,YAAY;EAG9B,OAAO,CAAC,YAAY;CACtB,CAAC;AACH;;;;;;;;;;;;;AAcA,SAAgB,uBAId,OACA,SACA;CACA,MAAM,kBAAkB,MAAM,sBAAsB;CAEpD,MAAM,YAAY,QAA4B;EAC5C,OAAOA,+BAAiB,SAAS,GAAG,CAAC,CAAC,QAAQ,WAAW;GACvD,MAAM,SAAS,gBAAgB,OAAO;GAEtC,IAAI,QAGF;QAAI,uBAFa,mBAAmB,MAEF,GAAG,OAAO,OAAO,MAAM,GACvD,OAAO;GACT;GAGF,OAAO;EACT,CAAC;CACH;CAEA,MAAM,QAAQ,wBAAwB,QAAQ;AAChD;;;;;;;;;;;;;AAcA,SAAgB,yBAGd,OAAyC,cAAwB;CACjE,uBACE,OACA,eAAe,CAAC,IAAIC,yBAAW,MAAM,aAAa,iBAAiB,CAAC,CAAC,CACvE;AACF;;;;;;;;;;;AAYA,SAAgB,uBAKd,UACA,OACA,QACA;CACA,QACG,YAAY,SAAS,aAClB,SAAS,WAAW,OAAO,MAAa,IACxC,UACJ,OAAO,UAAU,eAChB,OAAO,UAAU,YAAY,CAAC;AAEnC"}

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

@@ -1,8 +1,8 @@
 import { CellData, RowData, Updater } from "../../types/type-utils.cjs";
 import { ColumnFiltersState, FilterFn } from "./columnFilteringFeature.types.cjs";
-import { Column_Internal } from "../../types/Column.cjs";
+import { Table } from "../../types/Table.cjs";
+import { Column } from "../../types/Column.cjs";
 import { TableFeatures } from "../../types/TableFeatures.cjs";
-import { Table_Internal } from "../../types/Table.cjs";
 
 //#region src/features/column-filtering/columnFilteringFeature.utils.d.ts
 /**
@@ -21,15 +21,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 +46,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 +58,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 +70,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 +81,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 +92,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 +104,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 +117,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,7 +130,7 @@ 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.
  *
@@ -137,7 +141,7 @@ declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData
  * 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.cts.map

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

@@ -1,8 +1,8 @@
 import { CellData, RowData, Updater } from "../../types/type-utils.js";
 import { ColumnFiltersState, FilterFn } from "./columnFilteringFeature.types.js";
-import { Column_Internal } from "../../types/Column.js";
+import { Table } from "../../types/Table.js";
+import { Column } from "../../types/Column.js";
 import { TableFeatures } from "../../types/TableFeatures.js";
-import { Table_Internal } from "../../types/Table.js";
 
 //#region src/features/column-filtering/columnFilteringFeature.utils.d.ts
 /**
@@ -21,15 +21,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 +46,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 +58,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 +70,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 +81,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 +92,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 +104,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 +117,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,7 +130,7 @@ 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.
  *
@@ -137,7 +141,7 @@ declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData
  * 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