Replace "file kind" strings with an enum (#11722)

Throughout the compiler and tooling Razor files have a "kind" that is
represented as a string. Prior to the Razor API being taken internal,
using a string made it theoretically possible for the compiler to be
extended to file types other than those that the Razor compiler already
knows about. With extensibility no longer a priority, file kinds can be
represented as an enum (`RazorFileKind`) that provides the values that
the compiler supports, e.g.. `Component`, `ComponentImport`, `Legacy`.
This makes checks for the file kind much cheaper, since they were all
string comparisons before.

There are a lot of files changed, but much of the work is mechanical.

> [!IMPORTANT]
> This is a breaking change for the RazorSDK. When the Razor compiler
flows to the .NET SDK, it will introduce build errors that can be fixed
by applying this commit:
dotnet/sdk@f33a5e7.

VS Test Insertion:
https://dev.azure.com/devdiv/DevDiv/_git/VS/pullrequest/626687

Author: DustinCampbell

src/Compiler/Microsoft.AspNetCore.Mvc.Razor.Extensions/test/CreateNewOnMetadataUpdateAttributePassTest.cs

@@ -57,7 +57,7 @@ public void Execute_NoOpsForBlazorComponents()
     {
         // Arrange
         var source = TestRazorSourceDocument.Create("Hello world", filePath: "ignored", relativePath: "Test.razor");
-        var codeDocument = ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(codeDocument);
 
         // Act

src/Compiler/Microsoft.AspNetCore.Mvc.Razor.Extensions/test/IntegrationTests/CodeGenerationIntegrationTest.cs

@@ -223,7 +223,7 @@ public void Basic_Runtime()
     public void BasicComponent_Runtime()
     {
         // Arrange
-        var projectItem = CreateProjectItemFromFile(fileKind: FileKinds.Component);
+        var projectItem = CreateProjectItemFromFile(fileKind: RazorFileKind.Component);
 
         // Act
         var compiled = CompileToAssembly(projectItem, designTime: false);
@@ -1137,7 +1137,7 @@ public void Basic_DesignTime()
     public void BasicComponent_DesignTime()
     {
         // Arrange
-        var projectItem = CreateProjectItemFromFile(fileKind: FileKinds.Component);
+        var projectItem = CreateProjectItemFromFile(fileKind: RazorFileKind.Component);
 
         // Act
         var compiled = CompileToAssembly(projectItem, designTime: true);

src/Compiler/Microsoft.AspNetCore.Razor.Language/legacyTest/Legacy/HtmlAttributeTest.cs

@@ -1,9 +1,6 @@
 // Licensed to the .NET Foundation under one or more agreements.
 // The .NET Foundation licenses this file to you under the MIT license.
 
-#nullable disable
-
-using System;
 using Xunit;
 
 namespace Microsoft.AspNetCore.Razor.Language.Legacy;
@@ -305,12 +302,12 @@ public void ConditionalAttributesWithWeirdSpacingAreDisabledForDataAttributesInD
     [Fact]
     public void ComponentFileKind_ParsesDirectiveAttributesAsMarkup()
     {
-        ParseDocumentTest("<span @class='@foo'></span>", fileKind: FileKinds.Component);
+        ParseDocumentTest("<span @class='@foo'></span>", RazorFileKind.Component);
     }
 
     [Fact]
     public void ComponentFileKind_ParsesDirectiveAttributesWithParameterAsMarkup()
     {
-        ParseDocumentTest("<span @class:param='@foo'></span>", fileKind: FileKinds.Component);
+        ParseDocumentTest("<span @class:param='@foo'></span>", RazorFileKind.Component);
     }
 }

src/Compiler/Microsoft.AspNetCore.Razor.Language/legacyTest/Legacy/TagHelperBlockRewriterTest.cs

@@ -2207,7 +2207,7 @@ public void FeatureDisabled_AddsErrorForMinimizedBooleanBoundAttributes()
         ];
 
         // Act & Assert
-        EvaluateData(descriptors, document, languageVersion: RazorLanguageVersion.Version_2_0, fileKind: FileKinds.Legacy);
+        EvaluateData(descriptors, document, languageVersion: RazorLanguageVersion.Version_2_0, fileKind: RazorFileKind.Legacy);
     }
 
     [Fact]

src/Compiler/Microsoft.AspNetCore.Razor.Language/legacyTest/Legacy/TagHelperParseTreeRewriterTest.cs

@@ -760,7 +760,7 @@ public void DoesntAllowSimpleHtmlCommentsAsChildrenWhenFeatureFlagIsOff()
             descriptors,
             document,
             languageVersion: RazorLanguageVersion.Version_2_0,
-            fileKind: FileKinds.Legacy);
+            fileKind: RazorFileKind.Legacy);
     }
 
     [Fact]

src/Compiler/Microsoft.AspNetCore.Razor.Language/legacyTest/Legacy/TagHelperRewritingTestBase.cs

@@ -39,7 +39,7 @@ internal void EvaluateData(
         string documentContent,
         string tagHelperPrefix = null,
         RazorLanguageVersion languageVersion = null,
-        string fileKind = null,
+        RazorFileKind? fileKind = null,
         Action<RazorParserOptions.Builder> configureParserOptions = null)
     {
         var syntaxTree = ParseDocument(languageVersion, documentContent, directives: null, fileKind: fileKind, configureParserOptions: configureParserOptions);

src/Compiler/Microsoft.AspNetCore.Razor.Language/test/Components/ComponentDocumentClassifierPassTest.cs

@@ -20,7 +20,7 @@ public void Execute_SetsDocumentKind()
     {
         // Arrange
         var source = TestRazorSourceDocument.Create("some-content", filePath: "Test.razor");
-        var codeDocument = ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(codeDocument);
 
         // Act
@@ -42,7 +42,7 @@ public void ComponentDocumentClassifierPass_SetsNamespace()
         });
 
         var source = TestRazorSourceDocument.Create("some-content", filePath: "/MyApp/Test.razor", relativePath: "Test.razor");
-        var codeDocument = projectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = projectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(projectEngine, codeDocument);
 
         // Act
@@ -65,7 +65,7 @@ public void ComponentDocumentClassifierPass_SetsClass()
         });
 
         var source = TestRazorSourceDocument.Create("some-content", filePath: "/MyApp/Test.razor", relativePath: "Test.razor");
-        var codeDocument = projectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = projectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(projectEngine, codeDocument);
 
         // Act
@@ -91,7 +91,7 @@ public void ComponentDocumentClassifierPass_UsesRelativePathToGenerateTypeNameAn
 
         var relativePath = "/Pages/Announcements/Banner.razor";
         var source = TestRazorSourceDocument.Create("some-content", filePath: $"/MyApp{relativePath}", relativePath: relativePath);
-        var codeDocument = projectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = projectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(projectEngine, codeDocument);
 
         // Act
@@ -116,7 +116,7 @@ public void ComponentDocumentClassifierPass_SanitizesClassName()
         });
 
         var source = TestRazorSourceDocument.Create("some-content", filePath: @"x:\My.+App\path.with+invalid-chars.razor", relativePath: "path.with+invalid-chars.razor");
-        var codeDocument = projectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = projectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(projectEngine, codeDocument);
 
         // Act
@@ -136,7 +136,7 @@ public void ComponentDocumentClassifierPass_SetsUpMainMethod()
     {
         // Arrange
         var source = TestRazorSourceDocument.Create("some-content", filePath: "Test.razor");
-        var codeDocument = ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        var codeDocument = ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
         var processor = CreateCodeDocumentProcessor(codeDocument);
 
         // Act

src/Compiler/Microsoft.AspNetCore.Razor.Language/test/Components/ComponentDuplicateAttributeDiagnosticPassTest.cs

@@ -164,7 +164,7 @@ private RazorCodeDocument CreateDocument(string content)
         content = content.Replace("\n", "\r\n");
 
         var source = RazorSourceDocument.Create(content, "test.cshtml");
-        return ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        return ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
     }
 
     private DocumentIntermediateNode Lower(RazorCodeDocument codeDocument)

src/Compiler/Microsoft.AspNetCore.Razor.Language/test/Components/ComponentMarkupBlockPassTest.cs

@@ -452,7 +452,7 @@ private RazorCodeDocument CreateDocument(string content)
         content = content.Replace("\n", "\r\n");
 
         var source = RazorSourceDocument.Create(content, "test.cshtml");
-        return ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        return ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
     }
 
     private DocumentIntermediateNode Lower(RazorCodeDocument codeDocument)

src/Compiler/Microsoft.AspNetCore.Razor.Language/test/Components/ComponentMarkupEncodingPassTest.cs

@@ -191,7 +191,7 @@ private RazorCodeDocument CreateDocument(string content)
         content = content.Replace("\n", "\r\n");
 
         var source = RazorSourceDocument.Create(content, "test.cshtml");
-        return ProjectEngine.CreateCodeDocument(source, FileKinds.Component);
+        return ProjectEngine.CreateCodeDocument(source, RazorFileKind.Component);
     }
 
     private DocumentIntermediateNode Lower(RazorCodeDocument codeDocument)