Add GeneratedFilesOutputDirectory to Solution APIs

[tmat]

Background and Motivation

Add APIs to the Project and Solution that expose the value of CompilerGeneratedFilesOutputPath msbuild property from the solution snapshot.

See https://github.com/dotnet/roslyn/issues/75387

Proposed API

public readonly struct CompilationOutputInfo
{
    public string? AssemblyPath { get; }

+   public string? GeneratedFilesOutputDirectory { get; }
+   public CompilationOutputInfo WithGeneratedFilesOutputDirectory(string? path);
}

Usage Examples

Alternative Designs

namespace Microsoft.CodeAnalysis;

public class Project
{
+    /// <summary>
+    /// The path to the root directory of source generated files, or null if it is not known.
+    /// </summary>
+    public string? GeneratedFilesOutputDirectory { get; }
}

public class ProjectInfo
{
+    public string? GeneratedFilesOutputDirectory;
+    public ProjectInfo WithGeneratedFilesOutputDirectory(string? path);
}

public class Solution
{
+    public Solution WithProjectGeneratedFilesOutputDirectory(ProjectId projectId, string? path);
}

public class Workspace
{
+    protected internal void OnGeneratedFilesOutputDirectoryChanged(ProjectId projectId, string? outputFilePath);
}

Risks

[333fred]

API Review

• This reflects the compiler generated files path and comes from the project system, not the compiler

Conclusion: API is approved