feat: add CheckboxTree component

[rohanm-crest]

Issue number: ADDON-76198

PR Type

What kind of change does this PR introduce?

• Feature
• Bug Fix
• Refactoring (no functional or API changes)
• Documentation Update
• Maintenance (dependency updates, CI, etc.)

Summary

Changes

A new component CheckboxTree has been introduced to define hierarchical checkbox structures with support of search functionality.

User experience

User can use the new component for handling the list of checkboxes with better UI including the expanding/collapsing, grouping and searching within the checkbox list.

Checklist

If an item doesn't apply to your changes, leave it unchecked.

• I have performed a self-review of this change according to the development guidelines
• Tests have been added/modified to cover the changes (testing doc)
• Changes are documented
• PR title and description follows the contributing principles

[soleksy-splunk]

still reviewing but will post just after adding, feel free to close if something seems like a bad/worse idea

[soleksy-splunk]

Some additional ideas/questions.

Generally looks good to me.

Seems like Viktor got a good point regarding those css-s, it might be useful to get rid of as much as we can. (I would say worth removing even if it will make feature looks a bit worse)

[vtsvetkov-splunk]

Suggested pull request title: feat: add CheckboxTree component for hierarchical checkbox management

Great work on implementing a new CheckboxTree component that provides a hierarchical structure for managing checkboxes! The implementation looks clean and well-organized, with proper testing and documentation in place.

I especially appreciate:

• The comprehensive unit test coverage with test cases covering various scenarios
• Clear documentation including examples in both markdown and Storybook
• Well-structured component architecture with separation of concerns
• Proper handling of accessibility through ARIA labels
• Support for both expandable and non-expandable groups
• Implementation of "Select All" and "Clear All" functionality

Here are a few suggestions for improvements:

1. Documentation:

• Add a brief section in the component documentation about accessibility features
• Include examples of keyboard navigation in the docs

2. Code Structure:

• Consider extracting some of the complex state management logic from CheckboxTree.tsx into custom hooks for better reusability
• The CheckboxSubTree component could potentially be split further if it grows more complex

3. Testing:

• Add more test cases for keyboard navigation
• Consider adding tests for various error states and edge cases
• Add integration tests for interaction between groups and individual checkboxes

4. Accessibility:

• Consider adding keyboard shortcuts for bulk actions (Select All/Clear All)
• Ensure proper focus management when expanding/collapsing groups

5. Performance:

• Consider memoizing more of the callback functions using useCallback
• Look into potential performance optimizations for large checkbox trees

Overall, this is a solid implementation that appears ready for merging after addressing these minor suggestions. The component will be a valuable addition to the UI framework.

This comment was added by our PR Review Assistant Bot. Please kindly acknowledge that
while we're doing our best to keep these comments up to very high standards, they may occasionally be
incorrect. Suggestions offered by the Bot are only intended as points for consideration and no statements
by this bot alone can be considered grounds for merging of any pull request. Remember to seek a review
from a human co-worker.

To reply to the review and engage Review Bot in further conversation, start your comment with the words Review bot:

[vtsvetkov-splunk]

LGTM, great work