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

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

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

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

@@ -1,160 +0,0 @@
-import { CellData, OnChangeFn, RowData, Updater } from "../../types/type-utils.cjs";
-import { BuiltInFilterFn } from "../../fns/filterFns.cjs";
-import { Column } from "../../types/Column.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";
-
-//#region src/features/column-filtering/columnFilteringFeature.types.d.ts
-interface FilterMeta {}
-interface FilterFns {}
-interface TableState_ColumnFiltering {
-  columnFilters: ColumnFiltersState;
-}
-type ColumnFiltersState = Array<ColumnFilter>;
-interface ColumnFilter {
-  id: string;
-  value: unknown;
-}
-interface ResolvedColumnFilter<TFeatures extends TableFeatures, TData extends RowData> {
-  filterFn: FilterFn<TFeatures, TData>;
-  id: string;
-  resolvedValue: unknown;
-}
-interface RowModelFns_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
-  filterFns: Record<keyof FilterFns, FilterFn<TFeatures, RowData>>;
-}
-interface FilterFn<TFeatures extends TableFeatures, TData extends RowData> {
-  (row: Row<TFeatures, TData>, columnId: string, filterValue: any, addMeta?: (meta: FilterMeta) => void): boolean;
-  autoRemove?: ColumnFilterAutoRemoveTestFn<TFeatures, TData>;
-  resolveFilterValue?: TransformFilterValueFn<TFeatures, TData>;
-}
-type TransformFilterValueFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => TValue;
-type ColumnFilterAutoRemoveTestFn<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData> = (value: any, column?: Column<TFeatures, TData, TValue>) => boolean;
-type CustomFilterFns<TFeatures extends TableFeatures, TData extends RowData> = Record<string, FilterFn<TFeatures, 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> {
-  /**
-   * Enables this column to participate in column-specific filtering.
-   *
-   * Defaults to `true`; table-level `enableColumnFilters` and `enableFilters`
-   * must also allow filtering.
-   */
-  enableColumnFilter?: boolean;
-  /**
-   * The filter function to use with this column. Can be the name of a built-in filter function or a custom filter function.
-   */
-  filterFn?: FilterFnOption<TFeatures, TData>;
-}
-interface Column_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * Returns an automatically calculated filter function for the column based off of the columns first known value.
-   */
-  getAutoFilterFn: () => FilterFn<TFeatures, TData>;
-  /**
-   * Checks whether this accessor column can currently be column-filtered.
-   */
-  getCanFilter: () => boolean;
-  /**
-   * Returns the filter function (either user-defined or automatic, depending on configuration) for the columnId specified.
-   */
-  getFilterFn: () => FilterFn<TFeatures, TData>;
-  /**
-   * Returns the index (including `-1`) of the column filter in the table's `state.columnFilters` array.
-   */
-  getFilterIndex: () => number;
-  /**
-   * Reads this column's current value from `state.columnFilters`.
-   */
-  getFilterValue: () => unknown;
-  /**
-   * Checks whether this column has an active entry in `state.columnFilters`.
-   */
-  getIsFiltered: () => boolean;
-  /**
-   * Adds, updates, or removes this column's filter value.
-   *
-   * Updater functions receive the previous filter value. Values that satisfy
-   * the filter function's `autoRemove` rule are removed from filter state.
-   */
-  setFilterValue: (updater: Updater<any>) => void;
-}
-interface Row_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * The column filters map for the row. This object tracks whether a row is passing/failing specific filters by their column ID.
-   */
-  columnFilters: Record<string, boolean>;
-  /**
-   * The column filters meta map for the row. This object tracks any filter meta for a row as optionally provided during the filtering process.
-   */
-  columnFiltersMeta: Record<string, FilterMeta>;
-}
-interface TableOptions_ColumnFiltering<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * Enables column-specific filtering for all columns that also allow it.
-   */
-  enableColumnFilters?: boolean;
-  /**
-   * Enables all filtering features for the table.
-   *
-   * Set this to `false` to disable both column filtering and global filtering.
-   */
-  enableFilters?: boolean;
-  /**
-   * By default, filtering is done from parent rows down (so if a parent row is filtered out, all of its children will be filtered out as well). Setting this option to `true` will cause filtering to be done from leaf rows up (which means parent rows will be included so long as one of their child or grand-child rows is also included).
-   */
-  filterFromLeafRows?: boolean;
-  /**
-   * Disables the `getFilteredRowModel` from being used to filter data. This may be useful if your table needs to dynamically support both client-side and server-side filtering.
-   */
-  manualFiltering?: boolean;
-  /**
-     * By default, filtering is done for all rows (max depth of 100), no matter if they are root level parent rows or the child leaf rows of a parent row. Setting this option to `0` will cause filtering to only be applied to the root level parent rows, with all sub-rows remaining unfiltered. Similarly, setting this option to `1` will cause filtering to only be applied to child leaf rows 1 level deep, and so on.
-        * This is useful for situations where you want a row's entire child hierarchy to be visible regardless of the applied filter.
-     */
-  maxLeafRowFilterDepth?: number;
-  /**
-   * Called with an updater when column filter state changes. Pair this with
-   * `state.columnFilters` when using external state; external atoms can own the
-   * slice without this callback.
-   */
-  onColumnFiltersChange?: OnChangeFn<ColumnFiltersState>;
-}
-interface Table_ColumnFiltering {
-  /**
-   * Resets `columnFilters` to `initialState.columnFilters`.
-   *
-   * Pass `true` to ignore initial state and reset to `[]`.
-   */
-  resetColumnFilters: (defaultState?: boolean) => void;
-  /**
-   * Updates column filter state with a next array or updater function.
-   */
-  setColumnFilters: (updater: Updater<ColumnFiltersState>) => void;
-}
-interface Table_RowModels_Filtered<TFeatures extends TableFeatures, TData extends RowData> {
-  /**
-   * Resolves the row model after column and global filters have been applied.
-   */
-  getFilteredRowModel: () => RowModel<TFeatures, TData>;
-  /**
-   * Reads the row model immediately before filtering.
-   */
-  getPreFilteredRowModel: () => RowModel<TFeatures, TData>;
-}
-interface 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> {
-  filteredRowModel: () => RowModel<TFeatures, TData>;
-}
-//#endregion
-export { CachedRowModel_Filtered, ColumnDef_ColumnFiltering, ColumnFilter, ColumnFilterAutoRemoveTestFn, ColumnFiltersState, Column_ColumnFiltering, CreateRowModel_Filtered, CustomFilterFns, FilterFn, FilterFnOption, FilterFns, FilterMeta, ResolvedColumnFilter, RowModelFns_ColumnFiltering, Row_ColumnFiltering, TableOptions_ColumnFiltering, TableState_ColumnFiltering, Table_ColumnFiltering, Table_RowModels_Filtered, TransformFilterValueFn };
-//# sourceMappingURL=columnFilteringFeature.types.d.cts.map

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

@@ -1,212 +0,0 @@
-const require_utils = require('../../utils.cjs');
-
-//#region src/features/column-filtering/columnFilteringFeature.utils.ts
-/**
-* Creates the default column filter state.
-*
-* The feature default is an empty array, meaning no column filters are active.
-* Reset APIs use this value when `defaultState` is `true`.
-*
-* @example
-* ```ts
-* const filters = getDefaultColumnFiltersState()
-* ```
-*/
-function getDefaultColumnFiltersState() {
-	return [];
-}
-/**
-* 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`.
-*
-* @example
-* ```ts
-* const filterFn = column_getAutoFilterFn(column)
-* ```
-*/
-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;
-}
-/**
-* Resolves the filter function configured for a column.
-*
-* Function-valued `columnDef.filterFn` is returned directly, `'auto'` delegates
-* to `column_getAutoFilterFn`, and string values are looked up in the table's
-* filter function registry.
-*
-* @example
-* ```ts
-* const filterFn = column_getFilterFn(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;
-}
-/**
-* Checks whether column filtering is enabled for this accessor column.
-*
-* The column must have an accessor and filtering must be enabled by the column
-* definition, `enableColumnFilters`, and the table-wide `enableFilters` option.
-*
-* @example
-* ```ts
-* const canFilter = column_getCanFilter(column)
-* ```
-*/
-function column_getCanFilter(column) {
-	return (column.columnDef.enableColumnFilter ?? true) && (column.table.options.enableColumnFilters ?? true) && (column.table.options.enableFilters ?? true) && !!column.accessorFn;
-}
-/**
-* Checks whether this column currently has an entry in `state.columnFilters`.
-*
-* This only reflects filter state presence; it does not indicate whether the
-* filter removes any rows.
-*
-* @example
-* ```ts
-* const isFiltered = column_getIsFiltered(column)
-* ```
-*/
-function column_getIsFiltered(column) {
-	return column_getFilterIndex(column) > -1;
-}
-/**
-* Reads this column's current filter value from `state.columnFilters`.
-*
-* Missing filter entries return `undefined`.
-*
-* @example
-* ```ts
-* const value = column_getFilterValue(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;
-}
-/**
-* Finds this column's position in the ordered `state.columnFilters` array.
-*
-* The result is `-1` when the column has no active filter.
-*
-* @example
-* ```ts
-* const index = column_getFilterIndex(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;
-}
-/**
-* Adds, updates, or removes this column's filter value.
-*
-* The incoming value may be an updater. After resolution, `autoRemove` rules
-* decide whether the filter should be removed instead of stored.
-*
-* @example
-* ```ts
-* column_setFilterValue(column, (old) => String(old ?? '').trim())
-* ```
-*/
-function column_setFilterValue(column, value) {
-	table_setColumnFilters(column.table, (old) => {
-		const filterFn = column_getFilterFn(column);
-		const previousFilter = old.find((d) => d.id === column.id);
-		const newFilter = require_utils.functionalUpdate(value, previousFilter ? previousFilter.value : void 0);
-		if (shouldAutoRemoveFilter(filterFn, newFilter, column)) return old.filter((d) => d.id !== column.id);
-		const newFilterObj = {
-			id: column.id,
-			value: newFilter
-		};
-		if (previousFilter) return old.map((d) => {
-			if (d.id === column.id) return newFilterObj;
-			return d;
-		});
-		if (old.length) return [...old, newFilterObj];
-		return [newFilterObj];
-	});
-}
-/**
-* Routes a column filter updater through the table's filter change handler.
-*
-* The resolved filters are cleaned before they are emitted: filters for known
-* columns are removed when their filter function says the value should be
-* auto-removed.
-*
-* @example
-* ```ts
-* table_setColumnFilters(table, (old) => old.filter((filter) => filter.id !== 'age'))
-* ```
-*/
-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) => {
-			const column = leafColumnsById[filter.id];
-			if (column) {
-				if (shouldAutoRemoveFilter(column_getFilterFn(column), filter.value, column)) return false;
-			}
-			return true;
-		});
-	};
-	(_table$options$onColu = (_table$options = table.options).onColumnFiltersChange) === null || _table$options$onColu === void 0 || _table$options$onColu.call(_table$options, updateFn);
-}
-/**
-* Resets `columnFilters` to the configured initial state or feature default.
-*
-* With no argument, the reset clones `table.initialState.columnFilters` when it
-* exists. Passing `true` ignores initial state and resets to `[]`.
-*
-* @example
-* ```ts
-* table_resetColumnFilters(table)
-* table_resetColumnFilters(table, true)
-* ```
-*/
-function table_resetColumnFilters(table, defaultState) {
-	table_setColumnFilters(table, defaultState ? [] : require_utils.cloneState(table.initialState.columnFilters ?? []));
-}
-/**
-* Returns whether a filter value should be removed from filter state.
-*
-* This checks the filter function's `autoRemove` hook and built-in empty-value rules.
-*
-* @example
-* ```ts
-* const removeFilter = shouldAutoRemoveFilter(filterFn, value, column)
-* ```
-*/
-function shouldAutoRemoveFilter(filterFn, value, column) {
-	return (filterFn && filterFn.autoRemove ? filterFn.autoRemove(value, column) : false) || typeof value === "undefined" || typeof value === "string" && !value;
-}
-
-//#endregion
-exports.column_getAutoFilterFn = column_getAutoFilterFn;
-exports.column_getCanFilter = column_getCanFilter;
-exports.column_getFilterFn = column_getFilterFn;
-exports.column_getFilterIndex = column_getFilterIndex;
-exports.column_getFilterValue = column_getFilterValue;
-exports.column_getIsFiltered = column_getIsFiltered;
-exports.column_setFilterValue = column_setFilterValue;
-exports.getDefaultColumnFiltersState = getDefaultColumnFiltersState;
-exports.shouldAutoRemoveFilter = shouldAutoRemoveFilter;
-exports.table_resetColumnFilters = table_resetColumnFilters;
-exports.table_setColumnFilters = table_setColumnFilters;
-//# sourceMappingURL=columnFilteringFeature.utils.cjs.map

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

@@ -1 +0,0 @@
-{"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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"}

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

@@ -1,143 +0,0 @@
-import { CellData, RowData, Updater } from "../../types/type-utils.cjs";
-import { ColumnFiltersState, FilterFn } from "./columnFilteringFeature.types.cjs";
-import { Column_Internal } 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
-/**
- * Creates the default column filter state.
- *
- * The feature default is an empty array, meaning no column filters are active.
- * Reset APIs use this value when `defaultState` is `true`.
- *
- * @example
- * ```ts
- * const filters = getDefaultColumnFiltersState()
- * ```
- */
-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`.
- *
- * @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;
-/**
- * Resolves the filter function configured for a column.
- *
- * Function-valued `columnDef.filterFn` is returned directly, `'auto'` delegates
- * to `column_getAutoFilterFn`, and string values are looked up in the table's
- * filter function registry.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Checks whether column filtering is enabled for this accessor column.
- *
- * The column must have an accessor and filtering must be enabled by the column
- * definition, `enableColumnFilters`, and the table-wide `enableFilters` option.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Checks whether this column currently has an entry in `state.columnFilters`.
- *
- * This only reflects filter state presence; it does not indicate whether the
- * filter removes any rows.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Reads this column's current filter value from `state.columnFilters`.
- *
- * Missing filter entries return `undefined`.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Finds this column's position in the ordered `state.columnFilters` array.
- *
- * The result is `-1` when the column has no active filter.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Adds, updates, or removes this column's filter value.
- *
- * The incoming value may be an updater. After resolution, `autoRemove` rules
- * decide whether the filter should be removed instead of stored.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Routes a column filter updater through the table's filter change handler.
- *
- * The resolved filters are cleaned before they are emitted: filters for known
- * columns are removed when their filter function says the value should be
- * auto-removed.
- *
- * @example
- * ```ts
- * 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;
-/**
- * Resets `columnFilters` to the configured initial state or feature default.
- *
- * With no argument, the reset clones `table.initialState.columnFilters` when it
- * exists. Passing `true` ignores initial state and resets to `[]`.
- *
- * @example
- * ```ts
- * table_resetColumnFilters(table)
- * table_resetColumnFilters(table, true)
- * ```
- */
-declare function table_resetColumnFilters<TFeatures extends TableFeatures, TData extends RowData>(table: Table_Internal<TFeatures, TData>, defaultState?: boolean): void;
-/**
- * Returns whether a filter value should be removed from filter state.
- *
- * This checks the filter function's `autoRemove` hook and built-in empty-value rules.
- *
- * @example
- * ```ts
- * const removeFilter = shouldAutoRemoveFilter(filterFn, value, column)
- * ```
- */
-declare function shouldAutoRemoveFilter<TFeatures extends TableFeatures, TData extends RowData, TValue extends CellData = CellData>(filterFn?: FilterFn<TFeatures, TData>, value?: any, column?: Column_Internal<TFeatures, TData, TValue>): boolean;
-//#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.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"columnFilteringFeature.utils.js","names":[],"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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"}