[CSL-2954] useFilter Hook Implementation

[Mudaafi]

Pull Request Checklist

Before you submit a pull request, please make sure you have to following:

• I have added or updated TypeScript types for my changes, ensuring they are compatible with the existing codebase.
• I have added JSDoc comments to my TypeScript definitions for improved documentation.
• I have added tests that prove my fix is effective or that my feature works.
• I have added any necessary documentation (if appropriate).
• I have made sure my PR is up-to-date with the main branch.

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no API changes)
• Documentation content changes
• TypeScript type definitions update
• Other... Please describe:

[linear]

CSL-2954 [MVP] Create a useFilters Hook (Only Search)

Business Outcome:

• As a Consumer I want Filters to be handled OOO so that I can fully port over my current implementation to use Constructor's OS UI Library

Definition of done:

• This hook should exist within the context of the PlpContext
• Takes in a Search Response object and returns the relevant fields and functions required to power filtering
• Tests
• Documentation

Additional notes:

• You can look at pagination story as an example here
• We want to handle both facets and groups

[esezen]

Would this apply multiple values properly or would it override the existing one?

[Mudaafi]

It would not, but I was thinking of having whatever is calling the applyFilter function take care of that (i.e. passing a range, array of values, etc). wdyt?

[esezen]

I think that's okay but I feel like we need to be more explicit with the name of the function and documentation. It might be just me but applyFilter makes me think this will append filters rather than replacing them. Maybe something like setFilter? Doesn't have to be set if we can come up with something better. Also side note now that I'm a Typescript nerd, is the facetValue really any or can we make it more strict?

[esezen]

LGTM! One small comment about a type now that I am a TS nerd 🤓

[esezen]

I think we can also change this any to PlpFilterValue, right?

[Mudaafi]

yessir, thanks for catching that