// 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.Threading;
using System.Threading.Tasks;
 
namespace Microsoft.CodeAnalysis.Completion
{
    /// <summary>
    /// Interface to implement if the provider want to sign up for notifacation when one of the items it provided
    /// is being committed by the host, since calling <see cref="CompletionProvider.GetChangeAsync"/> doesn't necessarily
    /// lead to commission.
    /// </summary>
    internal interface INotifyCommittingItemCompletionProvider
    {
        /// <summary>
        /// This is invoked when one of the items provided by this provider is being committed.
        /// </summary>
        /// <remarks>
        /// Host provides no guarantee when will this be called (i.e. pre or post document change), nor the text 
        /// change will actually happen at all (e.g. the commit operation might be cancelled due to cancellation/exception/etc.)
        /// </remarks>
        Task NotifyCommittingItemAsync(Document document, CompletionItem item, char? commitKey, CancellationToken cancellationToken);
    }
}