// 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;
using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.Host;
using Microsoft.VisualStudio.Shell;
 
namespace Microsoft.VisualStudio.LanguageServices.Implementation;
 
/// <summary>
/// Maps from hierarchy items to project IDs.
/// </summary>
internal interface IHierarchyItemToProjectIdMap : IWorkspaceService
{
    /// <summary>
    /// Given an <see cref="IVsHierarchyItem"/> representing a project and an optional target framework moniker,
    /// returns the <see cref="ProjectId"/> of the equivalent Roslyn <see cref="Project"/>.
    /// </summary>
    /// <param name="hierarchyItem">An <see cref="IVsHierarchyItem"/> for the project root.</param>
    /// <param name="targetFrameworkMoniker">An optional string representing a TargetFrameworkMoniker.
    /// This is only useful in multi-targeting scenarios where there may be multiple Roslyn projects 
    /// (one per target framework) for a single project on disk.</param>
    /// <param name="projectId">The <see cref="ProjectId"/> of the found project, if any.</param>
    /// <returns>True if the desired project was found; false otherwise.</returns>
    bool TryGetProjectId(IVsHierarchyItem hierarchyItem, string? targetFrameworkMoniker, [NotNullWhen(true)] out ProjectId? projectId);
}