// 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.
 
using System.Diagnostics.CodeAnalysis;
 
namespace Microsoft.CodeAnalysis.PdbSourceDocument;
 
internal interface IImplementationAssemblyLookupService
{
    /// <summary>
    /// Uses various heuristics to try to find the implementation assembly for a reference assembly without
    /// loading 
    /// </summary>
    bool TryFindImplementationAssemblyPath(string referencedDllPath, [NotNullWhen(true)] out string? implementationDllPath);
 
    /// <summary>
    /// Given an implementation assembly path, follows any type forwards that might be in place
    /// for the containing type of <paramref name="symbol"/>, to ensure the right implementation
    /// assembly will be found.
    /// </summary>
    /// <remarks>
    /// To avoid mutiple reads of a single DLL this method caches all type forwards found in any
    /// DLL it loads.
    /// </remarks>
    string? FollowTypeForwards(ISymbol symbol, string dllPath, IPdbSourceDocumentLogger? logger);
 
    /// <summary>
    /// Clears any cached type forward information
    /// </summary>
    void Clear();
}