Replace using global mouse position with known position for context menus, dropdown menus and tooltips

[m-sasha]

We are currently using rememberCursorPositionProvider, and through it, the global mouse position state in three places:

1. DefaultContextMenuRepresentation
2. Positioning of CursorDropdownMenu.
3. Positioning of tooltips: TooltipPlacement.CursorPoint

We would like to instead use the position of the mouse event that triggered the displaying of each of these.

Proposed Changes

1. For DefaultContextMenuRepresentation, simply use the rect in the ContextMenuState.Status.Open it already has available. The modifier that changes the status to Open already places the mouse cursor position there.
2. For CursorDropdownMenu:

• Implement DropdownMenuState, a new state class, similar to ContextMenuState. Instead of a Rect, it will hold an IntOffset.
• Implement a new DropdownMenu overload that will take a DropdownMenuState and be controlled by it.
• Implement a Modifier.contextMenuOpenDetector(DropdownMenuState) that detects right-clicks and sets the state.status to Open(cursorPosition).
• The user is expected to combine the new DropdownMenu and contextMenuOpenDetector together with state hoisting to display the dropdown menu (example code below).

3. For TooltipArea:

• Add a new overload TooltipPlacement.positionProvider(cursorPosition: IntOffset) and have TooltipArea provide the cursor position to it when it wants to show the tooltip.
• TooltipPlacement.CursorPoint will use the new cursor position argument to position the tooltip popup.

Added utilities:

• (private) PopupPositionProviderAtOffset that takes all the necessary arguments to position the popup.
• Use the new PopupPositionProviderAtOffset from both rememberCursorPositionProvider and from a new popupPositionProviderAtPosition method.
• Modifier.contextMenuOpenDetector(onOpen) and Modifier.contextMenuOpenDetector(DropdownMenuState)

Example use of DropdownMenu:

fun main() = singleWindowApplication {
    val menuState = remember{ DropdownMenuState() }
    Column{
        Spacer(Modifier.height(100.dp))
        Box(
            modifier = Modifier
                .fillMaxSize()
                .background(Color.Red)
                .contextMenuOpenDetector(menuState)
        ) {
            DropdownMenu(
                state = menuState,
            ){
                DropdownMenuItem(onClick = {}){
                    Text("Item 1")
                }
                DropdownMenuItem(onClick = {}){
                    Text("Item 2")
                }
            }
        }
    }
}

Testing

Test: Manual testing

[MatkovIvan]

One test fails on CI now. It doesn't seem related, but anyway - please check this

[m-sasha]

One test fails on CI now. It doesn't seem related, but anyway - please check this

It's unrelated, but I'm looking at it separately.

[Walingar]

Awesome PR! I just provided some comments, please take a look

[igordmn]

Thanks! It makes API significantly better.

[m-sasha]

I've also renamed PopupPositionProviderAtOffset to PopupPositionProviderAtPosition and made it public, experimental API.