[michaelstonis]

Summary

Core already had ContextMenuModel/ContextMenuRenderer and the theme defined context-menu colours, but the control never showed a menu. Now it does.

Opening it:

• Right-click: opens the menu on the canvas. Windows and Mac Catalyst also get a secondary-button TapGestureRecognizer, because Mac Catalyst doesn't report right-clicks as canvas touches; a guard stops Windows opening the menu twice. If you right-click outside the selection, the caret moves to that spot first.
• Long-press rule:
  • Long-press on the selection: opens the menu and keeps the selection.
  • Long-press and release without moving: places the caret and opens the menu (for Paste).
  • Long-press and drag: caret drag with the magnifier, as before.

Using it:

• Choosing an item: tap, click or hover; Up/Down/Enter also work. Escape closes the menu, and any other key closes it and is then handled as normal.
• Closing: a press outside the menu, the mouse wheel, ScrollTo, a document change, focus loss or turning on read-only all close it.
• Item actions: Cut, Copy and Paste use the same clipboard path as the keyboard shortcuts, so Cut can be undone. Insert Hyperlink, Image and Table prompt the same way the toolbar does. Edit Hyperlink, which is new, prompts with the current URL.
• New API: IsContextMenuEnabled (default true) and a ContextMenuItemsRequested event for customising the items. The event's args type already existed but was never raised.
• Colours: taken from the theme's context-menu colours.

Core changes:

• ContextMenuRenderer gets colour properties, ApplyStyle and Bounds. Keyboard and hit-testing skip disabled items.
• ContextMenuFactory now offers the hyperlink items when the caret is on a link. Before, they needed a non-empty selection, so a long press on a link never showed them.

Testing

• 18 new tests in ContextMenuTests cover the menu contents for different selection states, hit testing, bounds and clamping, keyboard navigation and theme colours.
• Core.Tests pass (812) and SkiaSharp.Tests pass (29). The SkiaSharp Release build has 0 warnings, and the MAUI shared code compiles cleanly.
• Not tested on a device: right-click and long-press have only been compiled. They need checking on Android, iOS, Mac Catalyst and Windows, especially that the long-press rule doesn't get in the way of caret drag.

Not included

• Menu icons are not drawn.
• No Shift+F10 / Menu-key shortcut, because EditorKey has no such keys.
• Paste is always enabled, without checking the clipboard.
• Menu labels are localised in the separate EditorStrings PR.

Checklist

• CHANGELOG Added/Changed entries
• docs (commands-events, getting-started, theming, architecture) and README updated

---

Generated by Claude Code

[Copilot]

🟡 Changes recommended

Input routing, menu overflow, hyperlink undo and custom-command handling have unresolved correctness issues.

5 open issues

• Ignore dismissed pointer contacts until release or cancellation · New
• Constrain popup size and support scrolling within the viewport · New
• Preserve configured InsertTableCommand dimensions · New
• Record hyperlink URL edits as undoable actions · New
• Route Android newline commits to menu activation · New

What changed in this PR

Connects the existing Core context-menu system to MintedEditorView for right-click and long-press interaction.

Changes:

• Adds menu gestures, keyboard handling, clipboard actions and customization.
• Adds theme support and disabled-item navigation.
• Expands tests and documents the public API.

File	Description
tests/​MintedTextEditor.Core.Tests/​MockDrawingContext.cs	Records additional drawing calls.
tests/​MintedTextEditor.Core.Tests/​ContextMenuTests.cs	Tests menu contents, navigation, layout and colors.
src/​MintedTextEditor.Maui/​MintedEditorView.cs	Integrates menu input, rendering and actions.
src/​MintedTextEditor.Core/​ContextMenu/​ContextMenuRenderer.cs	Adds theming, bounds and enabled-item navigation.
src/​MintedTextEditor.Core/​ContextMenu/​ContextMenuModel.cs	Detects hyperlinks at the caret.
README.md	Introduces context-menu support.
docs/​theming.md	Documents menu colors.
docs/​getting-started.md	Documents configuration and gestures.
docs/​commands-events.md	Explains actions and customization.
docs/​architecture.md	Describes menu integration.
CHANGELOG.md	Records the new functionality.

_{Review effort: Balanced}