Minimap

[thecoolwinter]

Description

Adds a minimap to the editor.

Specific changes:

• Created a new MinimapView. This view acts as the container view for the entire minimap contents including the separator, text bubbles, and scroll view.
• New classes for the minimap:
  • MinimapContentView Displays the real contents of the minimap. The layout manager and selection manager place views and draw into this view.
  • MinimapLineRenderer uses the new layout overriding APIs to render small bubbles rather than text for the minimap. This delegates all bubble calculation and drawing to a custom view MinimapLineFragmentView.
  • MinimapLineFragmentView is a subclass of LineFragmentView that calculates and draws bubbles instead of text based on the foreground color of the line fragment it displays.
• Added a new showMinimap parameter to TextViewController and CodeEditSourceEditor types.
• Moved all content inset calculation to two methods.
  • updateContentInsets updates all relevant content insets for the scroll view, find panel, and minimap in one central place. This method is deterministic and builds on work @austincondiff and I discussed.
  • updateTextInsets updates the text view's insets.

Example app:

• Added minimap toggle
• Moved toggles and settings to it's own view, it was getting large.

Related Issues

• ✨ Minimap #33

Checklist

• Render minimap.
• Make minimap scrollable.
• Add 'visible pane' to minimap.
• Add selections to minimap.
• I read and understood the contributing guide as well as the code of conduct
• The issues this PR addresses are related to each other
• My changes generate no new warnings
• My code builds and runs on my machine
• My changes are all related to the related issue above
• I documented my code

Screenshots

Demo resizing & toggling minimap with selections being drawn and responding to scrolling.

Screen.Recording.2025-04-17.at.10.19.14.AM.mov

Demo scrolling a long document

minimap-long-demo.mp4

Demo editing text, with selections, dragging, and syntax highlighting. Note that syntax highlights haven't been updated to highlight the entire minimap visible region. That will be done, but adding to this PR I think will complicate this PR too much.

minimap-editing-demo.mp4

[thecoolwinter]

This is nearly ready, I've discovered some odd behavior when using the minimap in CodeEdit. I'm going to mark this as a draft again until I can resolve those.

[austincondiff]

Looks amazing! Can you also provide a screen recording of scrolling through a long file? Also, does the position update when opening the find panel?

[thecoolwinter]

Looks amazing! Can you also provide a screen recording of scrolling through a long file? Also, does the position update when opening the find panel?

Yes and yes!

[austincondiff]

Wow, very impressive! I can see a lot of consideration went into this. Great work!

There are just a few minor issues I have noted.

[thecoolwinter]

Alright @austincondiff now that CETV has been updated I think I've corrected everything you commented on.