Adds Repository Path to Mocha descriptions

src/Mocha/src/Mocha.Abstractions/DeclarationLocation.cs

@@ -6,15 +6,19 @@ namespace Mocha;
 /// the entire declaration from its start to its end.
 /// </summary>
 /// <param name="File">
-/// The source file path, relative to the project directory using forward slashes,
-/// or the file name alone when a project-relative path is not available.
+/// Name of the declaring source file.
+/// </param>
+/// <param name="Directory">
+/// Directory of the declaring source file relative to the repository root, empty when the file is
+/// at the repository root, or null when the build does not provide source root information.
 /// </param>
 /// <param name="StartLine">The 1-based line number where the declaration starts.</param>
 /// <param name="StartColumn">The 1-based column number where the declaration starts.</param>
 /// <param name="EndLine">The 1-based line number where the declaration ends.</param>
 /// <param name="EndColumn">The 1-based column number where the declaration ends.</param>
 public sealed record DeclarationLocation(
     string File,
+    string? Directory,
     int StartLine,
     int StartColumn,
     int EndLine,

src/Mocha/src/Mocha.Analyzers/MediatorGenerator.cs

@@ -129,14 +129,14 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
             static (options, _) =>
             {
                 options.GlobalOptions.TryGetValue("build_property.MochaEmitSourceMetadata", out var emit);
-                options.GlobalOptions.TryGetValue("build_property.ProjectDir", out var projectDir);
                 options.GlobalOptions.TryGetValue("build_property.RepositoryUrl", out var repositoryUrl);
                 options.GlobalOptions.TryGetValue("build_property.SourceRevisionId", out var commit);
+                options.GlobalOptions.TryGetValue("build_property._MochaSourceRoots", out var sourceRoots);
                 return new SourceMetadataOptionsInfo(
                     !string.Equals(emit, "false", StringComparison.OrdinalIgnoreCase),
-                    string.IsNullOrWhiteSpace(projectDir) ? null : projectDir,
                     string.IsNullOrWhiteSpace(repositoryUrl) ? null : repositoryUrl,
-                    string.IsNullOrWhiteSpace(commit) ? null : commit);
+                    string.IsNullOrWhiteSpace(commit) ? null : commit,
+                    string.IsNullOrWhiteSpace(sourceRoots) ? null : sourceRoots);
             });
 
         context.RegisterSourceOutput(

src/Mocha/src/Mocha.Analyzers/MessagingGenerator.cs

@@ -136,14 +136,14 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
         var sourceMetadataOptions = context.AnalyzerConfigOptionsProvider.Select(static (options, _) =>
         {
             options.GlobalOptions.TryGetValue("build_property.MochaEmitSourceMetadata", out var emit);
-            options.GlobalOptions.TryGetValue("build_property.ProjectDir", out var projectDir);
             options.GlobalOptions.TryGetValue("build_property.RepositoryUrl", out var repositoryUrl);
             options.GlobalOptions.TryGetValue("build_property.SourceRevisionId", out var commit);
+            options.GlobalOptions.TryGetValue("build_property._MochaSourceRoots", out var sourceRoots);
             return new SourceMetadataOptionsInfo(
                 !string.Equals(emit, "false", StringComparison.OrdinalIgnoreCase),
-                string.IsNullOrWhiteSpace(projectDir) ? null : projectDir,
                 string.IsNullOrWhiteSpace(repositoryUrl) ? null : repositoryUrl,
-                string.IsNullOrWhiteSpace(commit) ? null : commit);
+                string.IsNullOrWhiteSpace(commit) ? null : commit,
+                string.IsNullOrWhiteSpace(sourceRoots) ? null : sourceRoots);
         });
 
         var jsonSerializableInfos = context

src/Mocha/src/Mocha.Analyzers/Mocha.Analyzers.csproj

@@ -32,5 +32,6 @@
 
   <ItemGroup>
     <None Include="buildTransitive\Mocha.Analyzers.props" Pack="true" PackagePath="buildTransitive" Visible="false" />
+    <None Include="buildTransitive\Mocha.Analyzers.targets" Pack="true" PackagePath="buildTransitive" Visible="false" />
   </ItemGroup>
 </Project>

src/Mocha/src/Mocha.Analyzers/Models/SourceMetadataOptionsInfo.cs

@@ -1,32 +1,33 @@
 namespace Mocha.Analyzers;
 
 /// <summary>
-/// Carries the evaluated <c>MochaEmitSourceMetadata</c>, <c>ProjectDir</c>, <c>RepositoryUrl</c>,
-/// and <c>SourceRevisionId</c> MSBuild properties to source generators.
+/// Carries the evaluated <c>MochaEmitSourceMetadata</c>, <c>RepositoryUrl</c>,
+/// <c>SourceRevisionId</c>, and <c>_MochaSourceRoots</c> MSBuild properties to source generators.
 /// </summary>
 /// <param name="Emit">
 /// A value indicating whether <c>SourceMetadata</c> assignments are emitted into generated
 /// registration code.
 /// </param>
-/// <param name="ProjectDir">
-/// The MSBuild project directory used to relativize declaration file paths, or <see langword="null"/>
-/// when unavailable.
-/// </param>
 /// <param name="RepositoryUrl">
 /// The source repository URL supplied by the build, or <see langword="null"/> when unavailable.
 /// </param>
 /// <param name="Commit">
 /// The commit identifier supplied by the build, or <see langword="null"/> when unavailable.
 /// </param>
+/// <param name="SourceRoots">
+/// The flattened SourceLink source roots supplied by the build as a single string, or
+/// <see langword="null"/> when unavailable. Each record is
+/// <c>Identity&gt;MappedPath&gt;SourceControl</c> and records are separated by <c>|</c>.
+/// </param>
 public sealed record SourceMetadataOptionsInfo(
     bool Emit,
-    string? ProjectDir,
     string? RepositoryUrl,
-    string? Commit) : SyntaxInfo
+    string? Commit,
+    string? SourceRoots) : SyntaxInfo
 {
     /// <summary>
-    /// Gets the default options: metadata emission enabled and no project directory, repository URL,
-    /// or commit available.
+    /// Gets the default options: metadata emission enabled and no repository URL, commit, or source
+    /// roots available.
     /// </summary>
     public static SourceMetadataOptionsInfo Default { get; } = new(true, null, null, null);