refactor: deprecate hascomponents api and provide alternatives

[ugur-vaadin]

Description

This PR

• deprecates all HasComponents API
• provides alternatives for removing items: removeItem and removeAllItems, which work the same way as before
• updates JavaDocs based on the deprecations

Part of #5532

Type of change

• Bugfix
• Feature
• Refactor

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.

[web-padawan]

Note that add() is used internally by addSeparator() and we probably should refactor that method:

flow-components/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenu.java

Lines 64 to 66 in 4e414bb

	public void addSeparator() {
	add(new Hr());
	}

[ugur-vaadin]

If I'm not mistaken, the add/remove methods in SubMenu are completely separate from the ones in ContextMenuBase. They are defined in SubMenuBase, which does not seem to extend ContextMenuBase or implement HasComponents.

[web-padawan]

My bad, I missed that. We probably could consider adding addSeparator() also to ContextMenu for consistency, there is currently an integration test explicitly covering this use case:

flow-components/vaadin-context-menu-flow-parent/vaadin-context-menu-flow-integration-tests/src/main/java/com/vaadin/flow/component/contextmenu/it/ContextMenuView.java

Lines 155 to 158 in 22d9c2b

	// Components can also be added to the overlay
	// without creating menu items with add()
	Component separator = new Hr();
	contextMenu.add(separator, new Label("This is not a menu item"));

[ugur-vaadin]

Would that qualify as a feature? Maybe we can leave that for another PR, what do you think?

[sonarqubecloud]

Quality Gate passed

Issues
4 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud