Document MenuBar and ContextMenu

[ogoffart]

And don't mark them as experimental.

Which also enable the muda dependency by default on mac and windows

[tronical]

I have the feeling that we might revisit these semantics in the API review ;-)

[ogoffart]

ok, feel free to let me know what feels wrong there.

[tronical]

My guts feeling is that we may be better off accepting absolute coordinates, to disambiguate the API.

The relative coordinates make sense when ContextMenu surrounds the area that provides the context menu, but I'm not sure one would call show() then and instead rely on the automatic support for the right click?

And when it's not surrounding, the relative coordinates require additional steps:

ctx := ContextMenu { MenuItem { ... } MenuItem { ... } }

canvas := SomeCanvasOfThings {
    something-selected-via-right-click(pos) => {
        ctx.show({x: pos.x - canvas.x + ctx.x, y: pos.y - canvas.y + ctx.y}); // Is this correct?
    }
}

As opposed to just taking absolute coordinates:

ctx := ContextMenu { MenuItem { ... } MenuItem { ... } }

canvas := SomeCanvasOfThings {
    something-selected-via-right-click(pos) => {
        ctx.show({x: pos.x + canvas.absolute-position.x, y: pos.y + canvas.absolute-position.y});
    }
}