Validate Document Registry Generation

Fix issue with Author missing
Fix issue with old path setup for markdown file path

Author: michael-hawker

CommunityToolkit.Tooling.SampleGen.Tests/Helpers/TestHelpers.Compilation.cs

@@ -50,7 +50,7 @@ internal static GeneratorDriver WithMarkdown(this GeneratorDriver driver, params
         {
             if (!string.IsNullOrWhiteSpace(markdown))
             {
-                var text = new InMemoryAdditionalText(@"C:\pathtorepo\components\experiment\samples\experiment.Samples\documentation.md", markdown);
+                var text = new InMemoryAdditionalText(@"C:\pathtorepo\components\experiment\samples\documentation.md", markdown);
                 driver = driver.AddAdditionalTexts(ImmutableArray.Create<AdditionalText>(text));
             }
         }

CommunityToolkit.Tooling.SampleGen.Tests/ToolkitSampleMetadataTests.Documentation.cs

@@ -141,7 +141,7 @@ public void DocumentationMissingSample()
     }
 
     [TestMethod]
-    public void DocumentationValid()
+    public void DocumentationValidNoDiagnostics()
     {
         string markdown = @"---
 title: Canvas Layout
@@ -216,4 +216,51 @@ public void DocumentationInvalidIssueId()
         result.AssertNoCompilationErrors();
         result.AssertDiagnosticsAre(DiagnosticDescriptors.MarkdownYAMLFrontMatterException, DiagnosticDescriptors.DocumentationHasNoSamples);
     }
+
+    [TestMethod]
+    public void DocumentationValidWithRegistry()
+    {
+        string markdown = @"---
+title: Canvas Layout
+author: mhawker
+description: A canvas-like VirtualizingLayout for use in an ItemsRepeater
+keywords: CanvasLayout, ItemsRepeater, VirtualizingLayout, Canvas, Layout, Panel, Arrange
+dev_langs:
+    - csharp
+category: Controls
+subcategory: Layout
+discussion-id: 0
+issue-id: 0
+icon: assets/icon.png
+---
+# This is some test documentation...
+Which is valid.
+> [!SAMPLE Sample]";
+
+        var sampleProjectAssembly = SimpleSource.ToSyntaxTree()
+            .CreateCompilation("MyApp.Samples")
+            .ToMetadataReference();
+
+        var headCompilation = string.Empty
+            .ToSyntaxTree()
+            .CreateCompilation("MyApp.Head")
+            .AddReferences(sampleProjectAssembly);
+
+        var result = headCompilation.RunSourceGenerator<ToolkitSampleMetadataGenerator>(markdown);
+
+        result.AssertNoCompilationErrors();
+
+        Assert.AreEqual(result.Compilation.GetFileContentsByName("ToolkitDocumentRegistry.g.cs"), """
+        #nullable enable
+        namespace CommunityToolkit.Tooling.SampleGen;
+
+        public static class ToolkitDocumentRegistry
+        {
+            public static System.Collections.Generic.IEnumerable<CommunityToolkit.Tooling.SampleGen.Metadata.ToolkitFrontMatter> Execute()
+            {
+                yield return new CommunityToolkit.Tooling.SampleGen.Metadata.ToolkitFrontMatter() { Title = "Canvas Layout", Author = "mhawker", Description = "A canvas-like VirtualizingLayout for use in an ItemsRepeater", Keywords = "CanvasLayout, ItemsRepeater, VirtualizingLayout, Canvas, Layout, Panel, Arrange", Category = ToolkitSampleCategory.Controls, Subcategory = ToolkitSampleSubcategory.Layout, DiscussionId = 0, IssueId = 0, Icon = @"experiment/samples/assets/icon.png", FilePath = @"experiment\samples\documentation.md", SampleIdReferences = new string[] { "Sample" } };
+            }
+        }
+        """, "Unexpected code generated");
+    }
 }

CommunityToolkit.Tooling.SampleGen/ToolkitSampleMetadataGenerator.Documentation.cs

@@ -19,6 +19,9 @@ public partial class ToolkitSampleMetadataGenerator
     private const string FrontMatterRegexTitleExpression = @"^title:\s*(?<title>.*)$";
     private static readonly Regex FrontMatterRegexTitle = new Regex(FrontMatterRegexTitleExpression, RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Multiline);
 
+    private const string FrontMatterRegexAuthorExpression = @"^author:\s*(?<author>.*)$";
+    private static readonly Regex FrontMatterRegexAuthor = new Regex(FrontMatterRegexAuthorExpression, RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Multiline);
+
     private const string FrontMatterRegexDescriptionExpression = @"^description:\s*(?<description>.*)$";
     private static readonly Regex FrontMatterRegexDescription = new Regex(FrontMatterRegexDescriptionExpression, RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Multiline);
 
@@ -110,6 +113,7 @@ private ImmutableArray<ToolkitFrontMatter> GatherDocumentFrontMatter(SourceProdu
 
                 // Grab all front matter fields using RegEx expressions.
                 var title = ParseYamlField(ref ctx, file.Path, ref frontmatter, FrontMatterRegexTitle, "title");
+                var author = ParseYamlField(ref ctx, file.Path, ref frontmatter, FrontMatterRegexAuthor, "author");
                 var description = ParseYamlField(ref ctx, file.Path, ref frontmatter, FrontMatterRegexDescription, "description");
                 var keywords = ParseYamlField(ref ctx, file.Path, ref frontmatter, FrontMatterRegexKeywords, "keywords");
 
@@ -204,6 +208,7 @@ private ImmutableArray<ToolkitFrontMatter> GatherDocumentFrontMatter(SourceProdu
                 return new ToolkitFrontMatter()
                 {
                     Title = title!,
+                    Author = author!,
                     Description = description!,
                     Keywords = keywords!,
                     Category = categoryValue,

CommunityToolkit.Tooling.SampleGen/ToolkitSampleMetadataGenerator.Sample.cs

@@ -38,7 +38,7 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
         var assemblyName = context.CompilationProvider.Select((x, _) => x.Assembly.Name);
 
         // Only generate diagnostics (sample projects)
-        // Skip creating the registry for symbols in the executing assembly. This would place an incomplete registry in each sample project and cause compiler erorrs.
+        // Skip creating the registry for symbols in the executing assembly. This would place an incomplete registry in each sample project and cause compiler errors.
         Execute(symbolsInExecutingAssembly, skipRegistry: true);
 
         // Only generate the registry (project head)