[michaelstonis]

Summary

InsertHyperlinkCommand.DisplayText was documented as the link's display text, but Execute never read it. It now works:

• DisplayText set: a link with that text is inserted at the caret. If text is selected, DisplayText replaces the selection and becomes the link, like the "Text to display" field in most editors. A DisplayText that is only spaces counts as empty.
• DisplayText empty: behaves as before. The selection becomes the link, or the URL is inserted as the link text when nothing is selected.
• Undo: each insert is one undo step, and the caret ends up after the link.

Also fixed: after undoing a link made from a selection, redo threw ArgumentOutOfRangeException, and the undo had already dropped the original text's formatting. InsertHyperlinkAction now saves the affected paragraphs before inserting and locates its range by character offsets, the same way DeleteRangeAction works. That fixes both problems and also restores paragraphs that a multi-paragraph selection merged. The existing 3-argument constructor and HyperlinkEngine.InsertHyperlink overload still work, and there is a new overload that takes displayText.

Testing

• 5 new tests in CommandTests, each also checking undo:
  • display text with no selection;
  • display text replacing a selection, with undo and redo;
  • display text replacing bold text, where undo brings the bold back;
  • no display text with a selection;
  • no display text and no selection, with both empty and spaces-only display text.
• Core.Tests and SkiaSharp.Tests pass. The SkiaSharp Release build has 0 warnings, and the MAUI shared code compiles cleanly.

Not included

• RemoveHyperlink is still not recorded for undo.
• Inserting a link inside a table cell throws.

Both are noted as follow-ups.

Checklist

• CHANGELOG entry under Unreleased → Fixed
• docs/images-hyperlinks.md updated

---

Generated by Claude Code

[Copilot]

🟡 Changes recommended

Unresolved insertion-boundary, snapshot-preservation, image-undo, and layout-cache issues can cause incorrect placement, content loss, or stale rendering.

4 open issues

• Caret insertion after non-text inlines uses wrong position · New
• Paragraph snapshots lose soft breaks and non-text hyperlink children · New
• Paragraph restoration breaks image action identity during undo/redo · New
• Undoing paragraph reinsertion leaves stale layout cache blocks · New

What changed in this PR

Makes hyperlink insertion honor DisplayText and updates undo/redo to restore selected text and formatting.

Changes:

• Adds display-text support while preserving existing overloads.
• Uses paragraph snapshots and character-offset anchors for undo/redo.
• Adds command tests and updates documentation.

File	Description
tests/​MintedTextEditor.Core.Tests/​CommandTests.cs	Tests display text, selection replacement, and undo.
src/​MintedTextEditor.Core/​Formatting/​HyperlinkEngine.cs	Adds a display-text overload.
src/​MintedTextEditor.Core/​Editing/​UndoableActions.cs	Adds snapshots and anchors for hyperlink undo/redo.
src/​MintedTextEditor.Core/​Commands/​HyperlinkCommands.cs	Passes DisplayText to the undoable action.
docs/​images-hyperlinks.md	Documents display-text behavior and overloads.
CHANGELOG.md	Records the hyperlink fixes.

_{Review effort: Balanced}