✨ Emphasis API for Highlighting Text Ranges

[tom-ludwig]

Description

This PR introduces the Emphasis API to highlight specific text ranges within a TextView. This functionality can be used in various scenarios, such as highlighting search results, emphasizing code symbols, or highlighting the code symbol that the mouse is hovering over.
This PR only introduces the Emphasis API and does not include any search functionality or text-range validation (e.g., checking if an already emphasized range has changed).

Note

To test the UI changes, you will likely need to use CESE and add CETE as a local package.
To experiment with the highlighting, add the following snippet to TextView+KeyDown at line 13 and change the ranges accordingly:

        let rangesToHighlight = [
            NSRange(location: 562, length: 7),
            NSRange(location: 651, length: 7),
            NSRange(location: 724, length: 7),
        ]

        if event.keyCode == kVK_F1 {
            emphasizeAPI?.emphasizeRanges(ranges: rangesToHighlight, activeIndex: 0)
            return
        }

        if event.keyCode == kVK_F2 {
            emphasizeAPI?.highlightNext()
            return
        }
        if event.keyCode == kVK_F3 {
            emphasizeAPI?.highlightPrevious()
            return
        }
        if event.keyCode == kVK_F4 {
            emphasizeAPI?.removeEmphasizeLayers()
            return
        }

Related Issues

• closes ✨ Emphasis API for Highlighting Text Ranges #61
• ✨ Find/Replace in Document #1

Checklist

• 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

Screen.Recording.2024-12-23.at.6.56.48.PM.mov

Multiline:

[thecoolwinter]

Just a spelling error and a file placement suggestion. That smooth path function is beautiful, awesome stuff.

[austincondiff]

Excellent work @tom-ludwig! It looks really good. Just a small detail—the animation looks a little off. Instead of scaling it, it seems to be translated from below and to the right. Can we fix this?

[tom-ludwig]

@austincondiff Yeah, it’s not what Xcode is using, but honestly, I’m not really a fan of Xcode’s approach. I’ll experiment with the animation to come up with something better.

[austincondiff]

Xcodes approach is a macOS standard found in many other apps. I’d like to first start with it and if we want to, later on adjust as needed.