// 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.Collections.Immutable;
using System.Threading;
using System.Threading.Tasks;

namespace Microsoft.CodeAnalysis.EditAndContinue;

internal interface IActiveStatementSpanFactory
{
    /// <summary>
    /// Returns base mapped active statement spans contained in each specified document projected to a given solution snapshot
    /// (i.e. the solution snapshot the base active statements are current for could be different from the given <paramref name="solution"/>).
    /// </summary>
    /// <returns>
    /// <see langword="default"/> if called outside of an edit session.
    /// The length of the returned array matches the length of <paramref name="documentIds"/> otherwise.
    /// </returns>
    /// <remarks>
    /// The document may be any text document.
    /// <paramref name="documentIds"/> may not correspond to any document in the given <paramref name="solution"/> (an empty array of spans is returned for such document).
    /// Returns <see cref="DocumentId"/> of the unmapped document containing the active statement (i.e. the document that has the #line directive mapping the statement to one of the specified <paramref name="documentIds"/>),
    /// or null the unmapped document has not been determined (the active statement has not changed from the baseline).
    /// </remarks>
    ValueTask<ImmutableArray<ImmutableArray<ActiveStatementSpan>>> GetBaseActiveStatementSpansAsync(Solution solution, ImmutableArray<DocumentId> documentIds, CancellationToken cancellationToken);

    /// <summary>
    /// Returns adjusted active statements in the specified mapped <paramref name="document"/> snapshot.
    /// </summary>
    /// <returns>
    /// <see langword="default"/> if called outside of an edit session, or active statements for the document can't be determined for some reason
    /// (e.g. the document has syntax errors or is out-of-sync).
    /// </returns>
    ValueTask<ImmutableArray<ActiveStatementSpan>> GetAdjustedActiveStatementSpansAsync(TextDocument document, ActiveStatementSpanProvider activeStatementSpanProvider, CancellationToken cancellationToken);
}