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

package/dist/features/column-faceting/createFacetedUniqueValues.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"createFacetedUniqueValues.cjs","names":["tableMemo","callMemoOrStaticFn","column_getFacetedRowModel"],"sources":["../../../src/features/column-faceting/createFacetedUniqueValues.ts"],"sourcesContent":["import { callMemoOrStaticFn, tableMemo } from '../../utils'\nimport { column_getFacetedRowModel } from './columnFacetingFeature.utils'\nimport type { Row } from '../../types/Row'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized faceted unique values helper for faceted filtering.\n *\n * The returned function derives facet data from the table row model and relevant filter state so filter UIs can display available values.\n */\nexport function createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (\n  table: Table<TFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number> {\n  return (_table, columnId) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'columnFacetingFeature',\n      table,\n      fnName: 'table.getFacetedUniqueValues',\n      memoDeps: () => {\n        const column = table.getColumn(columnId)\n        if (!column) return [table.getPreFilteredRowModel().flatRows]\n        return [\n          callMemoOrStaticFn(\n            column,\n            'getFacetedRowModel',\n            column_getFacetedRowModel,\n            table,\n          ).flatRows,\n        ]\n      },\n      fn: (flatRows) => _createFacetedUniqueValues(columnId, flatRows),\n    })\n  }\n}\n\nfunction _createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(columnId: string, flatRows: Array<Row<TFeatures, TData>>): Map<any, number> {\n  const facetedUniqueValues = new Map<any, number>()\n\n  for (let i = 0; i < flatRows.length; i++) {\n    const values = flatRows[i]!.getUniqueValues(columnId)\n\n    for (let j = 0; j < values.length; j++) {\n      const value = values[j]\n      if (facetedUniqueValues.has(value)) {\n        facetedUniqueValues.set(\n          value,\n          (facetedUniqueValues.get(value) ?? 0) + 1,\n        )\n      } else {\n        facetedUniqueValues.set(value, 1)\n      }\n    }\n  }\n\n  return facetedUniqueValues\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,4BAMY;CAC1B,QAAQ,QAAQ,aAAa;EAC3B,MAAM,QAAQ;EACd,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;IACd,MAAM,SAAS,MAAM,UAAU,QAAQ;IACvC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ;IAC5D,OAAO,CACLC,iCACE,QACA,sBACAC,+DACA,KACF,CAAC,CAAC,QACJ;GACF;GACA,KAAK,aAAa,2BAA2B,UAAU,QAAQ;EACjE,CAAC;CACH;AACF;AAEA,SAAS,2BAGP,UAAkB,UAA0D;CAC5E,MAAM,sCAAsB,IAAI,IAAiB;CAEjD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,EAAE,CAAE,gBAAgB,QAAQ;EAEpD,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAQ,OAAO;GACrB,IAAI,oBAAoB,IAAI,KAAK,GAC/B,oBAAoB,IAClB,QACC,oBAAoB,IAAI,KAAK,KAAK,KAAK,CAC1C;QAEA,oBAAoB,IAAI,OAAO,CAAC;EAEpC;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"createFacetedUniqueValues.cjs","names":["tableMemo","callMemoOrStaticFn","table_getGlobalFacetedRowModel","column_getFacetedRowModel","column_getCanGlobalFilter"],"sources":["../../../src/features/column-faceting/createFacetedUniqueValues.ts"],"sourcesContent":["import { callMemoOrStaticFn, tableMemo } from '../../utils'\nimport { column_getCanGlobalFilter } from '../global-filtering/globalFilteringFeature.utils'\nimport {\n  column_getFacetedRowModel,\n  table_getGlobalFacetedRowModel,\n} from './columnFacetingFeature.utils'\nimport type { Row } from '../../types/Row'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized faceted unique values helper for faceted filtering.\n *\n * The returned function derives facet data from the table row model and relevant filter state so filter UIs can display available values.\n */\nexport function createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (\n  table: Table<TFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number> {\n  return (_table, columnId) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'columnFacetingFeature',\n      table,\n      fnName: 'table.getFacetedUniqueValues',\n      memoDeps: () => {\n        if (columnId === '__global__') {\n          return [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ]\n        }\n        const column = table.getColumn(columnId)\n        if (!column) return [table.getPreFilteredRowModel().flatRows]\n        return [\n          callMemoOrStaticFn(\n            column,\n            'getFacetedRowModel',\n            column_getFacetedRowModel,\n            table,\n          ).flatRows,\n        ]\n      },\n      fn: (flatRows) => _createFacetedUniqueValues(table, columnId, flatRows),\n    })\n  }\n}\n\nfunction _createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n  flatRows: Array<Row<TFeatures, TData>>,\n): Map<any, number> {\n  // The global context aggregates unique values across every column that\n  // participates in global filtering\n  const columnIds =\n    columnId === '__global__'\n      ? table\n          .getAllLeafColumns()\n          .filter((column) => column_getCanGlobalFilter(column))\n          .map((column) => column.id)\n      : [columnId]\n\n  const facetedUniqueValues = new Map<any, number>()\n\n  for (let i = 0; i < flatRows.length; i++) {\n    for (let c = 0; c < columnIds.length; c++) {\n      // the declared return type is Array, but rows return undefined for\n      // columns without an accessor (e.g. display columns)\n      const values = flatRows[i]!.getUniqueValues(columnIds[c]!) as\n        | Array<unknown>\n        | undefined\n      if (!values) continue\n\n      for (let j = 0; j < values.length; j++) {\n        const value = values[j]\n        const previousValue = facetedUniqueValues.get(value)\n        facetedUniqueValues.set(\n          value,\n          previousValue === undefined ? 1 : previousValue + 1,\n        )\n      }\n    }\n  }\n\n  return facetedUniqueValues\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,4BAMY;CAC1B,QAAQ,QAAQ,aAAa;EAC3B,MAAM,QAAQ;EACd,OAAOA,wBAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;IACd,IAAI,aAAa,cACf,OAAO,CACLC,iCACE,OACA,4BACAC,kEACF,CAAC,CAAC,QACJ;IAEF,MAAM,SAAS,MAAM,UAAU,QAAQ;IACvC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ;IAC5D,OAAO,CACLD,iCACE,QACA,sBACAE,+DACA,KACF,CAAC,CAAC,QACJ;GACF;GACA,KAAK,aAAa,2BAA2B,OAAO,UAAU,QAAQ;EACxE,CAAC;CACH;AACF;AAEA,SAAS,2BAIP,OACA,UACA,UACkB;CAGlB,MAAM,YACJ,aAAa,eACT,MACG,kBAAkB,CAAC,CACnB,QAAQ,WAAWC,+DAA0B,MAAM,CAAC,CAAC,CACrD,KAAK,WAAW,OAAO,EAAE,IAC5B,CAAC,QAAQ;CAEf,MAAM,sCAAsB,IAAI,IAAiB;CAEjD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EAGzC,MAAM,SAAS,SAAS,EAAE,CAAE,gBAAgB,UAAU,EAAG;EAGzD,IAAI,CAAC,QAAQ;EAEb,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAQ,OAAO;GACrB,MAAM,gBAAgB,oBAAoB,IAAI,KAAK;GACnD,oBAAoB,IAClB,OACA,kBAAkB,SAAY,IAAI,gBAAgB,CACpD;EACF;CACF;CAGF,OAAO;AACT"}

package/dist/features/column-faceting/createFacetedUniqueValues.d.cts

@@ -1,6 +1,6 @@
 import { RowData } from "../../types/type-utils.cjs";
-import { TableFeatures } from "../../types/TableFeatures.cjs";
 import { Table } from "../../types/Table.cjs";
+import { TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/features/column-faceting/createFacetedUniqueValues.d.ts
 /**

package/dist/features/column-faceting/createFacetedUniqueValues.d.ts

@@ -1,6 +1,6 @@
 import { RowData } from "../../types/type-utils.js";
-import { TableFeatures } from "../../types/TableFeatures.js";
 import { Table } from "../../types/Table.js";
+import { TableFeatures } from "../../types/TableFeatures.js";
 
 //#region src/features/column-faceting/createFacetedUniqueValues.d.ts
 /**

package/dist/features/column-faceting/createFacetedUniqueValues.js

@@ -1,5 +1,6 @@
 import { callMemoOrStaticFn, tableMemo } from "../../utils.js";
-import { column_getFacetedRowModel } from "./columnFacetingFeature.utils.js";
+import { column_getFacetedRowModel, table_getGlobalFacetedRowModel } from "./columnFacetingFeature.utils.js";
+import { column_getCanGlobalFilter } from "../global-filtering/globalFilteringFeature.utils.js";
 
 //#region src/features/column-faceting/createFacetedUniqueValues.ts
 /**
@@ -15,22 +16,25 @@ function createFacetedUniqueValues() {
 			table,
 			fnName: "table.getFacetedUniqueValues",
 			memoDeps: () => {
+				if (columnId === "__global__") return [callMemoOrStaticFn(table, "getGlobalFacetedRowModel", table_getGlobalFacetedRowModel).flatRows];
 				const column = table.getColumn(columnId);
 				if (!column) return [table.getPreFilteredRowModel().flatRows];
 				return [callMemoOrStaticFn(column, "getFacetedRowModel", column_getFacetedRowModel, table).flatRows];
 			},
-			fn: (flatRows) => _createFacetedUniqueValues(columnId, flatRows)
+			fn: (flatRows) => _createFacetedUniqueValues(table, columnId, flatRows)
 		});
 	};
 }
-function _createFacetedUniqueValues(columnId, flatRows) {
+function _createFacetedUniqueValues(table, columnId, flatRows) {
+	const columnIds = columnId === "__global__" ? table.getAllLeafColumns().filter((column) => column_getCanGlobalFilter(column)).map((column) => column.id) : [columnId];
 	const facetedUniqueValues = /* @__PURE__ */ new Map();
-	for (let i = 0; i < flatRows.length; i++) {
-		const values = flatRows[i].getUniqueValues(columnId);
+	for (let i = 0; i < flatRows.length; i++) for (let c = 0; c < columnIds.length; c++) {
+		const values = flatRows[i].getUniqueValues(columnIds[c]);
+		if (!values) continue;
 		for (let j = 0; j < values.length; j++) {
 			const value = values[j];
-			if (facetedUniqueValues.has(value)) facetedUniqueValues.set(value, (facetedUniqueValues.get(value) ?? 0) + 1);
-			else facetedUniqueValues.set(value, 1);
+			const previousValue = facetedUniqueValues.get(value);
+			facetedUniqueValues.set(value, previousValue === void 0 ? 1 : previousValue + 1);
 		}
 	}
 	return facetedUniqueValues;

package/dist/features/column-faceting/createFacetedUniqueValues.js.map

@@ -1 +1 @@
-{"version":3,"file":"createFacetedUniqueValues.js","names":[],"sources":["../../../src/features/column-faceting/createFacetedUniqueValues.ts"],"sourcesContent":["import { callMemoOrStaticFn, tableMemo } from '../../utils'\nimport { column_getFacetedRowModel } from './columnFacetingFeature.utils'\nimport type { Row } from '../../types/Row'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized faceted unique values helper for faceted filtering.\n *\n * The returned function derives facet data from the table row model and relevant filter state so filter UIs can display available values.\n */\nexport function createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (\n  table: Table<TFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number> {\n  return (_table, columnId) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'columnFacetingFeature',\n      table,\n      fnName: 'table.getFacetedUniqueValues',\n      memoDeps: () => {\n        const column = table.getColumn(columnId)\n        if (!column) return [table.getPreFilteredRowModel().flatRows]\n        return [\n          callMemoOrStaticFn(\n            column,\n            'getFacetedRowModel',\n            column_getFacetedRowModel,\n            table,\n          ).flatRows,\n        ]\n      },\n      fn: (flatRows) => _createFacetedUniqueValues(columnId, flatRows),\n    })\n  }\n}\n\nfunction _createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(columnId: string, flatRows: Array<Row<TFeatures, TData>>): Map<any, number> {\n  const facetedUniqueValues = new Map<any, number>()\n\n  for (let i = 0; i < flatRows.length; i++) {\n    const values = flatRows[i]!.getUniqueValues(columnId)\n\n    for (let j = 0; j < values.length; j++) {\n      const value = values[j]\n      if (facetedUniqueValues.has(value)) {\n        facetedUniqueValues.set(\n          value,\n          (facetedUniqueValues.get(value) ?? 0) + 1,\n        )\n      } else {\n        facetedUniqueValues.set(value, 1)\n      }\n    }\n  }\n\n  return facetedUniqueValues\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,4BAMY;CAC1B,QAAQ,QAAQ,aAAa;EAC3B,MAAM,QAAQ;EACd,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;IACd,MAAM,SAAS,MAAM,UAAU,QAAQ;IACvC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ;IAC5D,OAAO,CACL,mBACE,QACA,sBACA,2BACA,KACF,CAAC,CAAC,QACJ;GACF;GACA,KAAK,aAAa,2BAA2B,UAAU,QAAQ;EACjE,CAAC;CACH;AACF;AAEA,SAAS,2BAGP,UAAkB,UAA0D;CAC5E,MAAM,sCAAsB,IAAI,IAAiB;CAEjD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,EAAE,CAAE,gBAAgB,QAAQ;EAEpD,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAQ,OAAO;GACrB,IAAI,oBAAoB,IAAI,KAAK,GAC/B,oBAAoB,IAClB,QACC,oBAAoB,IAAI,KAAK,KAAK,KAAK,CAC1C;QAEA,oBAAoB,IAAI,OAAO,CAAC;EAEpC;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"createFacetedUniqueValues.js","names":[],"sources":["../../../src/features/column-faceting/createFacetedUniqueValues.ts"],"sourcesContent":["import { callMemoOrStaticFn, tableMemo } from '../../utils'\nimport { column_getCanGlobalFilter } from '../global-filtering/globalFilteringFeature.utils'\nimport {\n  column_getFacetedRowModel,\n  table_getGlobalFacetedRowModel,\n} from './columnFacetingFeature.utils'\nimport type { Row } from '../../types/Row'\nimport type { Table, Table_Internal } from '../../types/Table'\nimport type { TableFeatures } from '../../types/TableFeatures'\nimport type { RowData } from '../../types/type-utils'\n\n/**\n * Creates a memoized faceted unique values helper for faceted filtering.\n *\n * The returned function derives facet data from the table row model and relevant filter state so filter UIs can display available values.\n */\nexport function createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(): (\n  table: Table<TFeatures, TData>,\n  columnId: string,\n) => () => Map<any, number> {\n  return (_table, columnId) => {\n    const table = _table as unknown as Table_Internal<TFeatures, TData>\n    return tableMemo({\n      feature: 'columnFacetingFeature',\n      table,\n      fnName: 'table.getFacetedUniqueValues',\n      memoDeps: () => {\n        if (columnId === '__global__') {\n          return [\n            callMemoOrStaticFn(\n              table,\n              'getGlobalFacetedRowModel',\n              table_getGlobalFacetedRowModel,\n            ).flatRows,\n          ]\n        }\n        const column = table.getColumn(columnId)\n        if (!column) return [table.getPreFilteredRowModel().flatRows]\n        return [\n          callMemoOrStaticFn(\n            column,\n            'getFacetedRowModel',\n            column_getFacetedRowModel,\n            table,\n          ).flatRows,\n        ]\n      },\n      fn: (flatRows) => _createFacetedUniqueValues(table, columnId, flatRows),\n    })\n  }\n}\n\nfunction _createFacetedUniqueValues<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  table: Table_Internal<TFeatures, TData>,\n  columnId: string,\n  flatRows: Array<Row<TFeatures, TData>>,\n): Map<any, number> {\n  // The global context aggregates unique values across every column that\n  // participates in global filtering\n  const columnIds =\n    columnId === '__global__'\n      ? table\n          .getAllLeafColumns()\n          .filter((column) => column_getCanGlobalFilter(column))\n          .map((column) => column.id)\n      : [columnId]\n\n  const facetedUniqueValues = new Map<any, number>()\n\n  for (let i = 0; i < flatRows.length; i++) {\n    for (let c = 0; c < columnIds.length; c++) {\n      // the declared return type is Array, but rows return undefined for\n      // columns without an accessor (e.g. display columns)\n      const values = flatRows[i]!.getUniqueValues(columnIds[c]!) as\n        | Array<unknown>\n        | undefined\n      if (!values) continue\n\n      for (let j = 0; j < values.length; j++) {\n        const value = values[j]\n        const previousValue = facetedUniqueValues.get(value)\n        facetedUniqueValues.set(\n          value,\n          previousValue === undefined ? 1 : previousValue + 1,\n        )\n      }\n    }\n  }\n\n  return facetedUniqueValues\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,4BAMY;CAC1B,QAAQ,QAAQ,aAAa;EAC3B,MAAM,QAAQ;EACd,OAAO,UAAU;GACf,SAAS;GACT;GACA,QAAQ;GACR,gBAAgB;IACd,IAAI,aAAa,cACf,OAAO,CACL,mBACE,OACA,4BACA,8BACF,CAAC,CAAC,QACJ;IAEF,MAAM,SAAS,MAAM,UAAU,QAAQ;IACvC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC,QAAQ;IAC5D,OAAO,CACL,mBACE,QACA,sBACA,2BACA,KACF,CAAC,CAAC,QACJ;GACF;GACA,KAAK,aAAa,2BAA2B,OAAO,UAAU,QAAQ;EACxE,CAAC;CACH;AACF;AAEA,SAAS,2BAIP,OACA,UACA,UACkB;CAGlB,MAAM,YACJ,aAAa,eACT,MACG,kBAAkB,CAAC,CACnB,QAAQ,WAAW,0BAA0B,MAAM,CAAC,CAAC,CACrD,KAAK,WAAW,OAAO,EAAE,IAC5B,CAAC,QAAQ;CAEf,MAAM,sCAAsB,IAAI,IAAiB;CAEjD,KAAK,IAAI,IAAI,GAAG,IAAI,SAAS,QAAQ,KACnC,KAAK,IAAI,IAAI,GAAG,IAAI,UAAU,QAAQ,KAAK;EAGzC,MAAM,SAAS,SAAS,EAAE,CAAE,gBAAgB,UAAU,EAAG;EAGzD,IAAI,CAAC,QAAQ;EAEb,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;GACtC,MAAM,QAAQ,OAAO;GACrB,MAAM,gBAAgB,oBAAoB,IAAI,KAAK;GACnD,oBAAoB,IAClB,OACA,kBAAkB,SAAY,IAAI,gBAAgB,CACpD;EACF;CACF;CAGF,OAAO;AACT"}

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

@@ -34,8 +34,8 @@ const columnFilteringFeature = {
 		});
 	},
 	initRowInstanceData: (row) => {
-		row.columnFilters = {};
-		row.columnFiltersMeta = {};
+		row.columnFilters = require_utils.makeObjectMap();
+		row.columnFiltersMeta = require_utils.makeObjectMap();
 	},
 	constructTableAPIs: (table) => {
 		require_utils.assignTableAPIs("columnFilteringFeature", table, {

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

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

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

@@ -1,4 +1,4 @@
-import { assignPrototypeAPIs, assignTableAPIs, makeStateUpdater } from "../../utils.js";
+import { assignPrototypeAPIs, assignTableAPIs, makeObjectMap, makeStateUpdater } from "../../utils.js";
 import { column_getAutoFilterFn, column_getCanFilter, column_getFilterFn, column_getFilterIndex, column_getFilterValue, column_getIsFiltered, column_setFilterValue, getDefaultColumnFiltersState, table_resetColumnFilters, table_setColumnFilters } from "./columnFilteringFeature.utils.js";
 
 //#region src/features/column-filtering/columnFilteringFeature.ts
@@ -34,8 +34,8 @@ const columnFilteringFeature = {
 		});
 	},
 	initRowInstanceData: (row) => {
-		row.columnFilters = {};
-		row.columnFiltersMeta = {};
+		row.columnFilters = makeObjectMap();
+		row.columnFiltersMeta = makeObjectMap();
 	},
 	constructTableAPIs: (table) => {
 		assignTableAPIs("columnFilteringFeature", table, {

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

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

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

@@ -1,13 +1,23 @@
-import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.cjs";
-import { BuiltInFilterFn } from "../../fns/filterFns.cjs";
-import { Column } from "../../types/Column.cjs";
+import { CellData, OnChangeFn, RowData, TransformDataValueFn, Updater } from "../../types/type-utils.cjs";
+import { BuiltInFilterFn } from "./filterFns.cjs";
 import { Row } from "../../types/Row.cjs";
-import { TableFeatures } from "../../types/TableFeatures.cjs";
-import { Table } from "../../types/Table.cjs";
 import { RowModel } from "../../core/row-models/coreRowModelsFeature.types.cjs";
+import { Column } from "../../types/Column.cjs";
+import { IsAny, TableFeatures } from "../../types/TableFeatures.cjs";
 
 //#region src/features/column-filtering/columnFilteringFeature.types.d.ts
 interface FilterMeta {}
+/**
+ * Resolves the type of the filter meta attached to rows for a feature set.
+ *
+ * When the features object declares a `filterMeta` type-only slot
+ * (`tableFeatures({ ..., filterMeta: {} as MyFilterMeta })`), that type wins.
+ * Otherwise this falls back to the global declaration-merged `FilterMeta`
+ * interface.
+ */
+type ExtractFilterMeta<TFeatures extends TableFeatures> = IsAny<TFeatures> extends true ? FilterMeta : TFeatures extends {
+  filterMeta: infer TFilterMeta extends object;
+} ? TFilterMeta : FilterMeta;
 interface FilterFns {}
 interface TableState_ColumnFiltering {
   columnFilters: ColumnFiltersState;
@@ -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.cts.map

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.