// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.

namespace Microsoft.CodeAnalysis.Host;

/// <summary>
/// Provides a way to map from an assembly name to the actual path of the .NET Framework 
/// assembly with that name in the context of a specified project.  For example, if the 
/// assembly name is "System.Data" then a project targeting .NET 2.0 would resolve this
/// to a different path than a project targeting .NET 4.5.
/// </summary>
internal interface IFrameworkAssemblyPathResolver : IWorkspaceService
{
    /// <summary>
    /// Returns null if the assembly name could not be resolved.
    /// </summary>
    /// <param name="fullyQualifiedName">An optional type name for a type that must
    /// exist in the assembly.</param>
    /// <param name="projectId">The project context to search within.</param>
    /// <param name="assemblyName">The name of the assembly to try to resolve.</param>
    string? ResolveAssemblyPath(ProjectId projectId, string assemblyName, string? fullyQualifiedName);

    // bool CanResolveType(ProjectId projectId, string assemblyName, string fullyQualifiedTypeName);
}