feat: selection preservation mode api

[ugur-vaadin]

Description

This PR introduces new API to provide the following 3 selection preservation mode options:

• Preserve selection
• Preserve selected items that still exist after data change (not supported for lazy data providers)
• Discard selection

for the following 4 components:

• Grid (default mode: preserve all)
• MultiSelectListBox (default mode: discard)
• RadioButtonGroup (default mode: discard)
• CheckboxGroup (default mode: discard)

The default modes are the same as before in order to not cause breaking changes.

The API is on the component level, and is controlled by setting an enum SelectionPreservationMode using:

• setSelectionPreservationMode(SelectionPreservationMode)
• getSelectionPreservationMode

Fixes #5744

Type of change

• Bugfix
• Feature

Checklist

• I have read the contribution guide: https://vaadin.com/docs/latest/contributing/overview
• I have added a description following the guideline.
• The issue is created in the corresponding repository and I have referenced it.
• I have added tests to ensure my change is effective and works as intended.
• New and existing tests are passing locally with my change.
• I have performed self-review and corrected misspellings.

Additional for Feature type of change

• Enhancement / new feature was discussed in a corresponding GitHub issue and Acceptance Criteria were created.

[sonarcloud]

Quality Gate passed

The SonarCloud Quality Gate passed, but some issues were introduced.

7 New issues
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[vaadin-bot]

This ticket/PR has been released with Vaadin 24.4.0.alpha2 and is also targeting the upcoming stable 24.4.0 version.