Legacy editor shim layer

eng/Versions.props

@@ -124,6 +124,7 @@
     <MicrosoftVisualStudioLiveSharePackageVersion>0.3.1074</MicrosoftVisualStudioLiveSharePackageVersion>
     <MicrosoftVisualStudioProjectSystemSDKPackageVersion>17.7.294-pre</MicrosoftVisualStudioProjectSystemSDKPackageVersion>
     <MicrosoftVisualStudioShell150PackageVersion>$(MicrosoftVisualStudioShellPackagesVersion)</MicrosoftVisualStudioShell150PackageVersion>
+    <MicrosoftVisualStudioShellFrameworkPackageVersion>$(MicrosoftVisualStudioShellPackagesVersion)</MicrosoftVisualStudioShellFrameworkPackageVersion>
     <MicrosoftVisualStudioInteropPackageVersion>$(MicrosoftVisualStudioShellPackagesVersion)</MicrosoftVisualStudioInteropPackageVersion>
     <MicrosoftInternalVisualStudioInteropPackageVersion>$(MicrosoftVisualStudioShellPackagesVersion)</MicrosoftInternalVisualStudioInteropPackageVersion>
     <MicrosoftVisualStudioRpcContractsPackageVersion>17.7.5-preview</MicrosoftVisualStudioRpcContractsPackageVersion>
@@ -138,6 +139,7 @@
     <!-- NOTE: Keep O#-Roslyn's Microsoft.VisualStudio.Validation version in sync with the version below:
     https://github.com/OmniSharp/omnisharp-roslyn/blob/d7555ebfb6c4d7c6811c58370322d3b092c0abf6/build/Packages.props#L66 -->
     <MicrosoftVisualStudioValidationPackageVersion>17.6.11</MicrosoftVisualStudioValidationPackageVersion>
+    <MicrosoftVisualStudioComponentModelHostPackageVersion>17.7.124-preview</MicrosoftVisualStudioComponentModelHostPackageVersion>
     <MicrosoftWebToolsLanguagesHtmlPackageVersion>$(Tooling_HtmlEditorPackageVersion)</MicrosoftWebToolsLanguagesHtmlPackageVersion>
     <MicrosoftWebToolsLanguagesLanguageServerServerPackageVersion>$(Tooling_HtmlEditorPackageVersion)</MicrosoftWebToolsLanguagesLanguageServerServerPackageVersion>
     <MicrosoftWebToolsLanguagesSharedPackageVersion>$(Tooling_HtmlEditorPackageVersion)</MicrosoftWebToolsLanguagesSharedPackageVersion>

src/Compiler/Microsoft.AspNetCore.Razor.Language/src/Properties/AssemblyInfo.cs

@@ -39,3 +39,4 @@
 [assembly: InternalsVisibleTo("DynamicProxyGenAssembly2, PublicKey=0024000004800000940000000602000000240000525341310004000001000100c547cac37abd99c8db225ef2f6c8a3602f3b3606cc9891605d02baa56104f4cfc0734aa39b93bf7852f7d9266654753cc297e7d2edfe0bac1cdcf9f717241550e0a7b191195b7667bb4f64bcb8e2121380fd1d9d46ad2d92d2d15605093924cceaf74c4861eff62abf69b9291ed0a340e113be11e6a7d3113e92484cf7045cc7")]
 [assembly: InternalsVisibleTo("Microsoft.AspNetCore.Razor.Microbenchmarks.Compiler, PublicKey=0024000004800000940000000602000000240000525341310004000001000100f33a29044fa9d740c9b3213a93e57c84b472c84e0b8a0e1ae48e67a9f8f6de9d5f7f3d52ac23e48ac51801f1dc950abe901da34d2a9e3baadb141a17c77ef3c565dd5ee5054b91cf63bb3c6ab83f72ab3aafe93d0fc3c2348b764fafb0b1c0733de51459aeab46580384bf9d74c4e28164b7cde247f891ba07891c9d872ad2bb")]
 [assembly: InternalsVisibleTo("Microsoft.AspNetCore.Razor.Microbenchmarks, PublicKey=0024000004800000940000000602000000240000525341310004000001000100f33a29044fa9d740c9b3213a93e57c84b472c84e0b8a0e1ae48e67a9f8f6de9d5f7f3d52ac23e48ac51801f1dc950abe901da34d2a9e3baadb141a17c77ef3c565dd5ee5054b91cf63bb3c6ab83f72ab3aafe93d0fc3c2348b764fafb0b1c0733de51459aeab46580384bf9d74c4e28164b7cde247f891ba07891c9d872ad2bb")]
+[assembly: InternalsVisibleTo("Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor, PublicKey=0024000004800000940000000602000000240000525341310004000001000100f33a29044fa9d740c9b3213a93e57c84b472c84e0b8a0e1ae48e67a9f8f6de9d5f7f3d52ac23e48ac51801f1dc950abe901da34d2a9e3baadb141a17c77ef3c565dd5ee5054b91cf63bb3c6ab83f72ab3aafe93d0fc3c2348b764fafb0b1c0733de51459aeab46580384bf9d74c4e28164b7cde247f891ba07891c9d872ad2bb")]

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/AcceptedCharacters.cs

@@ -0,0 +1,19 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+[Flags]
+internal enum AcceptedCharacters
+{
+    None = 0,
+    NewLine = 1,
+    WhiteSpace = 2,
+
+    NonWhiteSpace = 4,
+
+    AllWhiteSpace = NewLine | WhiteSpace,
+    Any = AllWhiteSpace | NonWhiteSpace,
+
+    AnyExceptNewline = NonWhiteSpace | WhiteSpace
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/BlockKind.cs

@@ -0,0 +1,25 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal enum BlockKind
+{
+    // Code
+    Statement,
+    Directive,
+    Functions,
+    Expression,
+    Helper,
+
+    // Markup
+    Markup,
+    Section,
+    Template,
+
+    // Special
+    Comment,
+    Tag,
+
+    HtmlComment
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/ClassifiedSpan.cs

@@ -0,0 +1,11 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal readonly record struct ClassifiedSpan(
+    RazorSourceSpan Span,
+    RazorSourceSpan BlockSpan,
+    SpanKind SpanKind,
+    BlockKind BlockKind,
+    AcceptedCharacters AcceptedCharacters);

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/ContextChangeEventArgs.cs

@@ -0,0 +1,9 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal sealed class ContextChangeEventArgs(ContextChangeKind kind) : EventArgs
+{
+    public ContextChangeKind Kind { get; } = kind;
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/ContextChangeKind.cs

@@ -0,0 +1,12 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal enum ContextChangeKind
+{
+    ProjectChanged,
+    EditorSettingsChanged,
+    TagHelpersChanged,
+    ImportsChanged,
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/DocumentStructureChangedEventArgs.cs

@@ -0,0 +1,27 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using Microsoft.VisualStudio.Text;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal class DocumentStructureChangedEventArgs(
+    RazorSourceChange? change,
+    ITextSnapshot snapshot,
+    IRazorCodeDocument codeDocument) : EventArgs
+{
+    /// <summary>
+    /// The <see cref="RazorSourceChange"/> which triggered the re-parse.
+    /// </summary>
+    public RazorSourceChange? SourceChange { get; } = change;
+
+    /// <summary>
+    /// The text snapshot used in the re-parse.
+    /// </summary>
+    public ITextSnapshot Snapshot { get; } = snapshot ?? throw new ArgumentNullException(nameof(snapshot));
+
+    /// <summary>
+    /// The result of the parsing and code generation.
+    /// </summary>
+    public IRazorCodeDocument CodeDocument { get; } = codeDocument ?? throw new ArgumentNullException(nameof(codeDocument));
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/Extensions.cs

@@ -0,0 +1,23 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Diagnostics.CodeAnalysis;
+using Microsoft.VisualStudio.Editor.Razor;
+using Microsoft.VisualStudio.Utilities;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal static class Extensions
+{
+    public static bool TryGetRazorParser(this PropertyCollection properties, [NotNullWhen(true)] out IRazorParser? parser)
+    {
+        if (properties.TryGetProperty(typeof(VisualStudioRazorParser), out VisualStudioRazorParser obj))
+        {
+            parser = RazorWrapperFactory.WrapParser(obj);
+            return true;
+        }
+
+        parser = null;
+        return false;
+    }
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorBoundAttributeDescriptor.cs

@@ -0,0 +1,17 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorBoundAttributeDescriptor
+{
+    string Name { get; }
+    string DisplayName { get; }
+    string? Documentation { get; }
+    bool CaseSensitive { get; }
+    string? IndexerNamePrefix { get; }
+
+    ImmutableArray<IRazorBoundAttributeParameterDescriptor> BoundAttributeParameters { get; }
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorBoundAttributeParameterDescriptor.cs

@@ -0,0 +1,9 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorBoundAttributeParameterDescriptor
+{
+    string Name { get; }
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorCodeDocument.cs

@@ -0,0 +1,21 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+using Microsoft.VisualStudio.Text;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorCodeDocument
+{
+    ImmutableArray<ClassifiedSpan> GetClassifiedSpans();
+    ImmutableArray<TagHelperSpan> GetTagHelperSpans();
+
+    ImmutableArray<RazorSourceMapping> GetSourceMappings();
+    ImmutableArray<IRazorDiagnostic> GetDiagnostics();
+    IRazorTagHelperDocumentContext GetTagHelperContext();
+
+    int? GetDesiredIndentation(ITextSnapshot snapshot, ITextSnapshotLine line, int indentSize, int tabSize);
+
+    string GetGeneratedCode();
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorDiagnostic.cs

@@ -0,0 +1,11 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorDiagnostic
+{
+    RazorSourceSpan Span { get; }
+
+    string GetMessage(IFormatProvider? formatProvider);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorDocumentTracker.cs

@@ -0,0 +1,14 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+using Microsoft.VisualStudio.Text.Editor;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorDocumentTracker
+{
+    ImmutableArray<ITextView> TextViews { get; }
+
+    event EventHandler<ContextChangeEventArgs> ContextChanged;
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorEditorFactoryService.cs

@@ -0,0 +1,13 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Diagnostics.CodeAnalysis;
+using Microsoft.VisualStudio.Text;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorEditorFactoryService
+{
+    bool TryGetDocumentTracker(ITextBuffer textBuffer, [NotNullWhen(true)] out IRazorDocumentTracker? documentTracker);
+    bool TryGetParser(ITextBuffer textBuffer, [NotNullWhen(true)] out IRazorParser? parser);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorEditorSettingsManager.cs

@@ -0,0 +1,9 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorEditorSettingsManager
+{
+    void Update(bool indentWithTabs, int indentSize);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorElementCompletionContext.cs

@@ -0,0 +1,8 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorElementCompletionContext
+{
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorParser.cs

@@ -0,0 +1,13 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorParser
+{
+    bool HasPendingChanges { get; }
+
+    event EventHandler<DocumentStructureChangedEventArgs>? DocumentStructureChanged;
+
+    void QueueReparse();
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorRequiredAttributeDescriptor.cs

@@ -0,0 +1,10 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorRequiredAttributeDescriptor
+{
+    string Name { get; }
+    string DisplayName { get; }
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagHelperBinding.cs

@@ -0,0 +1,13 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagHelperBinding
+{
+    ImmutableArray<IRazorTagHelperDescriptor> Descriptors { get; }
+
+    ImmutableArray<IRazorTagMatchingRuleDescriptor> GetBoundRules(IRazorTagHelperDescriptor descriptor);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagHelperCompletionService.cs

@@ -0,0 +1,20 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagHelperCompletionService
+{
+    IRazorElementCompletionContext CreateContext(
+        IRazorTagHelperDocumentContext tagHelperContext,
+        IEnumerable<string>? existingCompletions,
+        string? containingTagName,
+        IEnumerable<KeyValuePair<string, string>> attributes,
+        string? containingParentTagName,
+        bool containingParentIsTagHelper,
+        Func<string, bool> inHTMLSchema);
+
+    ImmutableDictionary<string, ImmutableArray<IRazorTagHelperDescriptor>> GetElementCompletions(IRazorElementCompletionContext completionContext);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagHelperDescriptor.cs

@@ -0,0 +1,19 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagHelperDescriptor : IEquatable<IRazorTagHelperDescriptor>
+{
+    string DisplayName { get; }
+    string? Documentation { get; }
+    bool CaseSensitive { get; }
+    string? TagOutputHint { get; }
+
+    ImmutableArray<IRazorBoundAttributeDescriptor> BoundAttributes { get; }
+    ImmutableArray<IRazorTagMatchingRuleDescriptor> TagMatchingRules { get; }
+
+    bool IsComponentOrChildContentTagHelper();
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagHelperDocumentContext.cs

@@ -0,0 +1,12 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagHelperDocumentContext
+{
+    string Prefix { get; }
+    ImmutableArray<IRazorTagHelperDescriptor> TagHelpers { get; }
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagHelperFactsService.cs

@@ -0,0 +1,26 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagHelperFactsService
+{
+    IRazorTagHelperBinding? GetTagHelperBinding(
+        IRazorTagHelperDocumentContext documentContext,
+        string? tagName,
+        IEnumerable<KeyValuePair<string, string>> attributes,
+        string? parentTag,
+        bool parentIsTagHelper);
+
+    ImmutableArray<IRazorBoundAttributeDescriptor> GetBoundTagHelperAttributes(
+        IRazorTagHelperDocumentContext documentContext,
+        string attributeName,
+        IRazorTagHelperBinding binding);
+
+    ImmutableArray<IRazorTagHelperDescriptor> GetTagHelpersGivenTag(
+        IRazorTagHelperDocumentContext documentContext,
+        string tagName,
+        string? parentTag);
+}

src/Razor/src/Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor/IRazorTagMatchingRuleDescriptor.cs

@@ -0,0 +1,13 @@
+// Copyright (c) .NET Foundation. All rights reserved.
+// Licensed under the MIT license. See License.txt in the project root for license information.
+
+using System.Collections.Immutable;
+
+namespace Microsoft.AspNetCore.Razor.ExternalAccess.LegacyEditor;
+
+internal interface IRazorTagMatchingRuleDescriptor
+{
+    TagStructure TagStructure { get; }
+
+    ImmutableArray<IRazorRequiredAttributeDescriptor> Attributes { get; }
+}