Feature/hybrid cms filtering

[matthewcsimpson]

New Feature: [Feature Title]

Description

Adds a new CMS Filtering option, Hybrid.
Adds a new attribute which specifies items to be excluded from the filter-narrowing, effectively leaving some categories multi-select.

Changes Made

This pull request introduces and documents a new "hybrid" filtering mode for the CMSFilter Webflow script, which allows specific facets (like body type) to keep all relevant checkbox options visible for multi-select, while other facets behave as in advanced mode. The changes include new tests to verify hybrid behavior and comprehensive documentation updates explaining how to use the hybrid mode and its configuration.

Key changes:

Feature: Hybrid Filtering Mode

• Added a new "hybrid" filtering mode, controlled via the wt-cmsfilter-filtering="hybrid" attribute and configured with wt-cmsfilter-hybrid-categories to specify which facets retain all relevant options for multi-select. [1] [2]
• Updated documentation to describe hybrid mode usage, configuration, and how it differs from advanced mode, including example markup and guidance for multiple hybrid facets. [1] [2] [3] [4]

Testing: Hybrid Mode Behavior

• Added buildHybridScenarioDOM helper to the test suite to construct DOM scenarios for hybrid and advanced filtering modes.
• Added tests verifying that in hybrid mode, specified categories (like bodytype) keep all relevant options visible for multi-select, while other facets narrow as in advanced mode. Also tested hybrid mode with empty hybrid categories (behaves like advanced), and compared with advanced mode behavior.

Checklist

• Feature has been tested locally with all relevant use cases.
• Documentation has been updated (if necessary).
• PR does not match another non-stale PR currently opened
• PR name matches the format [ feature ]: Feature Name (versions separated by comma). More details here
• PR's base is the develop branch.
• Your Feature matches the standards laid out here

Additional Notes

Add any extra details or comments for reviewers.