[Menu] Overhaul the component API

[michaldudak]

Closes #214
Closes #9
Closes #46
Closes #63
Closes #411

Preview

https://deploy-preview-468--base-ui.netlify.app/base-ui/react-menu/

To do

• [Menu] Closing the menu with Tab doesn't restore focus to the trigger element #411
• [Menu] Configure MenuItems not to close the Menu when clicked #46
• [Menu] Support opening the menu and selecting an item with one click #63
• [Menu] Menu click away is broken if transitionDuration CSS property is used #9
• Nested menus
• Animations
• Docs
• Configure Esc key behavior (close all/close one submenu level)
• keepMounted prop
• Configurable delay and open on hover

In separate PRs

• [Menu] Create the checkbox menu item #52
• [Menu] Create the radio menu item #53
• [Separator] Implement Separator #70

[atomiks]

Bug when traversing back to the submenu trigger, menu doesn't open

Screen.Recording.2024-07-25.at.11.33.36.PM.mov

[colmtuite]

@michaldudak Feedback based on our chat:

1. Add the Arrow component
2. Consider making focus looping configurable. I vote it should be.
3. Rename positionStrategy to positionMethod across all components.

[michaldudak]

@colmtuite I did 1 and 2. positionStrategy rename should be done on the other components first in a separate PR.

[colmtuite]

@michaldudak In this vid, the menu is initially opening above the trigger, then quickly repositioning itself below.
https://github.com/user-attachments/assets/dee98c5c-a19b-47ab-8f8b-2c2f07b0eb30

[michaldudak]

Bug when traversing back to the submenu trigger, menu doesn't open

@atomiks, Should be working OK now.

In this vid, the menu is initially opening above the trigger, then quickly repositioning itself below.

@colmtuite, could you prepare a reproduction on codesandbox?

[atomiks]

Looks great!