File: BraceMatching\BraceHighlightingViewTaggerProvider.cs
Web Access
Project: src\src\EditorFeatures\Core\Microsoft.CodeAnalysis.EditorFeatures.csproj (Microsoft.CodeAnalysis.EditorFeatures)
// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
#nullable disable
 
using System.Collections.Immutable;
using System.ComponentModel.Composition;
using System.Diagnostics.CodeAnalysis;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.CodeAnalysis.Editor;
using Microsoft.CodeAnalysis.Editor.Shared.Tagging;
using Microsoft.CodeAnalysis.Editor.Tagging;
using Microsoft.CodeAnalysis.Internal.Log;
using Microsoft.CodeAnalysis.Options;
using Microsoft.CodeAnalysis.Shared.TestHooks;
using Microsoft.CodeAnalysis.Text.Shared.Extensions;
using Microsoft.VisualStudio.Text;
using Microsoft.VisualStudio.Text.Editor;
using Microsoft.VisualStudio.Text.Tagging;
using Microsoft.VisualStudio.Utilities;
 
namespace Microsoft.CodeAnalysis.BraceMatching;
 
[Export(typeof(IViewTaggerProvider))]
[ContentType(ContentTypeNames.RoslynContentType)]
[TagType(typeof(BraceHighlightTag))]
[method: ImportingConstructor]
[method: SuppressMessage("RoslynDiagnosticsReliability", "RS0033:Importing constructor should be [Obsolete]", Justification = "Used in test code: https://github.com/dotnet/roslyn/issues/42814")]
internal sealed class BraceHighlightingViewTaggerProvider(TaggerHost taggerHost, IBraceMatchingService braceMatcherService)
    : AsynchronousViewTaggerProvider<BraceHighlightTag>(taggerHost, FeatureAttribute.BraceHighlighting)
{
    private readonly IBraceMatchingService _braceMatcherService = braceMatcherService;
 
    protected sealed override ImmutableArray<IOption2> Options { get; } = [BraceMatchingOptionsStorage.BraceMatching];
 
    protected override TaggerDelay EventChangeDelay => TaggerDelay.NearImmediate;
 
    protected override ITaggerEventSource CreateEventSource(ITextView textView, ITextBuffer subjectBuffer)
    {
        return TaggerEventSources.Compose(
            TaggerEventSources.OnTextChanged(subjectBuffer),
            TaggerEventSources.OnCaretPositionChanged(textView, subjectBuffer),
            TaggerEventSources.OnParseOptionChanged(subjectBuffer));
    }
 
    protected override Task ProduceTagsAsync(
        TaggerContext<BraceHighlightTag> context, DocumentSnapshotSpan documentSnapshotSpan, int? caretPosition, CancellationToken cancellationToken)
    {
        var document = documentSnapshotSpan.Document;
        if (!caretPosition.HasValue || document == null)
        {
            return Task.CompletedTask;
        }
 
        var options = GlobalOptions.GetBraceMatchingOptions(document.Project.Language);
 
        return ProduceTagsAsync(
            context, document, documentSnapshotSpan.SnapshotSpan.Snapshot, caretPosition.Value, options, cancellationToken);
    }
 
    internal async Task ProduceTagsAsync(
        TaggerContext<BraceHighlightTag> context, Document document, ITextSnapshot snapshot, int position, BraceMatchingOptions options, CancellationToken cancellationToken)
    {
        using (Logger.LogBlock(FunctionId.Tagger_BraceHighlighting_TagProducer_ProduceTags, cancellationToken))
        {
            if (position >= 0 && position <= snapshot.Length)
            {
                var (bracesLeftOfPosition, bracesRightOfPosition) = await GetAllMatchingBracesAsync(
                    _braceMatcherService, document, position, options, cancellationToken).ConfigureAwait(false);
 
                AddBraces(context, snapshot, bracesLeftOfPosition);
                AddBraces(context, snapshot, bracesRightOfPosition);
            }
        }
    }
 
    /// <summary>
    /// Given code like   ()^()  (where ^ is the caret position), returns the two pairs of
    /// matching braces on the left and the right of the position.  Note: a brace matching
    /// pair is only returned if the position is on the left-side of hte start brace, or the
    /// right side of end brace.  So, for example, if you have (^()), then only the inner 
    /// braces are returned as the position is not on the right-side of the outer braces.
    /// 
    /// This function also works for multi-character braces i.e.  ([  ])   In this case,
    /// the rule is that the position has to be on the left side of the start brace, or 
    /// inside the start brace (but not at the end).  So,    ^([   ])  will return this
    /// as a brace match, as will  (^[    ]).  But   ([^   ])  will not.
    /// 
    /// The same goes for the braces on the the left of the caret.  i.e.:   ([   ])^
    /// will return the braces on the left, as will   ([   ]^).  But   ([   ^]) will not.
    /// </summary>
    private static async Task<(BraceMatchingResult? leftOfPosition, BraceMatchingResult? rightOfPosition)> GetAllMatchingBracesAsync(
        IBraceMatchingService service,
        Document document,
        int position,
        BraceMatchingOptions options,
        CancellationToken cancellationToken)
    {
        // These are the matching spans when checking the token to the right of the position.
        var rightOfPosition = await service.GetMatchingBracesAsync(document, position, options, cancellationToken).ConfigureAwait(false);
 
        // The braces to the right of the position should only be added if the position is 
        // actually within the span of the start brace.  Note that this is what we want for
        // single character braces as well as multi char braces.  i.e. if the user has:
        //
        //      ^{ }    // then { and } are matching braces.
        //      {^ }    // then { and } are not matching braces.
        //
        //      ^<@ @>  // then <@ and @> are matching braces.
        //      <^@ @>  // then <@ and @> are matching braces.
        //      <@^ @>  // then <@ and @> are not matching braces.
        if (rightOfPosition.HasValue &&
            !rightOfPosition.Value.LeftSpan.Contains(position))
        {
            // Not a valid match.  
            rightOfPosition = null;
        }
 
        if (position == 0)
        {
            // We're at the start of the document, can't find braces to the left of the position.
            return (leftOfPosition: null, rightOfPosition);
        }
 
        // See if we're touching the end of some construct.  i.e.:
        //
        //      { }^
        //      <@ @>^
        //      <@ @^>
        //
        // But not
        //
        //      { ^}
        //      <@ ^@>
 
        var leftOfPosition = await service.GetMatchingBracesAsync(document, position - 1, options, cancellationToken).ConfigureAwait(false);
 
        if (leftOfPosition.HasValue &&
            position <= leftOfPosition.Value.RightSpan.End &&
            position > leftOfPosition.Value.RightSpan.Start)
        {
            // Found a valid pair on the left of us.
            return (leftOfPosition, rightOfPosition);
        }
 
        // No valid pair of braces on the left of us.
        return (leftOfPosition: null, rightOfPosition);
    }
 
    private static void AddBraces(
        TaggerContext<BraceHighlightTag> context,
        ITextSnapshot snapshot,
        BraceMatchingResult? braces)
    {
        if (braces.HasValue)
        {
            context.AddTag(snapshot.GetTagSpan(braces.Value.LeftSpan.ToSpan(), BraceHighlightTag.StartTag));
            context.AddTag(snapshot.GetTagSpan(braces.Value.RightSpan.ToSpan(), BraceHighlightTag.EndTag));
        }
    }
 
    // Safe to directly compare as BraceHighlightTag uses singleton instances.
    protected override bool TagEquals(BraceHighlightTag tag1, BraceHighlightTag tag2)
        => tag1 == tag2;
}