feat: update columnfiltersadapter to handle grouping of column filters (#632)

[frano-m]

Closes #632.

This pull request enhances the flexibility of the TanStack table filter adapter by introducing support for category groups and improving how category filters are constructed. The main changes focus on allowing multiple category groups, making the system more extensible and modular.

Support for category groups and improved filter construction:

• Added ColumnFiltersTableMeta type to extend TanStack's TableMeta with optional categoryGroups, enabling the use of grouped category filters.
• Updated buildColumnFilters to check for categoryGroups in table meta; if present, it builds filters from groups, otherwise it falls back to a single group with all filterable columns.
• Introduced helper functions: buildCategoryConfigs, buildCategoryFilters, mapCategoryConfig, and mapCategoryFilter to modularize and clarify the process of mapping table columns to category configs and filters. [1] [2]
• Enhanced mapColumnToCategoryView to accept an optional categoryConfig and merge its properties, allowing for more customizable category views.

[Copilot]

Pull Request Overview

This PR enhances the TanStack table filter adapter to support grouped column filters, allowing for more flexible and modular filter organization. The changes introduce the ability to define multiple category groups through table metadata while maintaining backward compatibility.

• Added support for category groups through new ColumnFiltersTableMeta type extension
• Refactored filter building logic to handle both grouped and ungrouped scenarios
• Introduced helper functions to modularize the mapping between table columns and category configurations

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
utils.ts	Added category group support with new helper functions and refactored buildColumnFilters to handle both grouped and single-group scenarios
types.ts	Extended TanStack's TableMeta with optional categoryGroups property to enable grouped filtering

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

[nitpick] The function returns undefined when no category views are found, but the return type is 'CategoryFilter | undefined'. Consider explicitly returning undefined for clarity: 'return undefined;'

Suggested change

	if (categoryViews.length === 0) return;
	if (categoryViews.length === 0) return undefined;