Highlight unique components of overloaded declarations [alternate approach]

[mportiz08]

This implements the same rendering of highlighted tokens as #841 but using an alternate Render JSON schema where each token may possibly have a highlightDiff boolean flag instead of introducing a new token kind to represent highlights.

I'm not sure yet which approach the DocC team is going to decide on yet, so I'm opening a draft PR for both options and will close one depending on what they decide on.

Testing

Same instructions as #841 except make sure to use the older commit 33388c3c7987904e0aec58e4035fea14bcd19965 from the swift-docc branch when building DocC instead of the latest commit from the mentioned branch.

[marinaaisa]

The implementation here looks cleaner than in #841 in my opinion, but both are great.
I tested this one too and it works as expected.

I left a minor suggestion.
Thanks!

[QuietMisdreavus]

Dang, this does look a lot nicer than the highlightDiff span approach in #841. I think i was the last major holdout for that approach, on the assumption that it would make integration easier. 😅 Seeing this, i think i'd prefer this version of the implementation on the Swift-DocC side as well, since the text-splitting and -recombining code was a lot simpler on single tokens! Thanks for writing this!

[mportiz08]

RIP 🥲

[mportiz08]

@swift-ci test

[QuietMisdreavus]

@mportiz08 I've merged swiftlang/swift-docc#928 with the "highlight": "changed" field, so this PR can land whenever you're ready. Looks like there's a merge conflict now.

[mportiz08]

@mportiz08 I've merged apple/swift-docc#928 with the "highlight": "changed" field, so this PR can land whenever you're ready. Looks like there's a merge conflict now.

Sorry yes. We are anticipating needing to update this PR due to major refactoring of declaration components as part of #832 . I was hoping we could sync this change across both repos at the same time, but we can prioritize updating this PR now to try and avoid issues now that it has been merged in DocC.

[hqhhuang]

@mportiz08 FYI I'm working on resolving conflicts.

[mportiz08]

Replacing this PR with #875