// 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;
using Microsoft.CodeAnalysis.CodeCleanup.Providers;
using Microsoft.CodeAnalysis.Formatting;
using Microsoft.CodeAnalysis.Host;
using Microsoft.CodeAnalysis.Text;

namespace Microsoft.CodeAnalysis.CodeCleanup;

/// <summary>
/// Internal code cleanup service interface.
/// 
/// This is not supposed to be used directly. It just provides a way to get the right service from each language.
/// </summary>
internal interface ICodeCleanerService : ILanguageService
{
    /// <summary>
    /// Returns the default code cleaners.
    /// </summary>
    ImmutableArray<ICodeCleanupProvider> GetDefaultProviders();

    /// <summary>
    /// This will run all provided code cleaners in an order that is given to the method.
    /// </summary>
    Task<Document> CleanupAsync(Document document, ImmutableArray<TextSpan> spans, CodeCleanupOptions options, ImmutableArray<ICodeCleanupProvider> providers, CancellationToken cancellationToken);

    /// <summary>
    /// This will run all provided code cleaners in an order that is given to the method.
    /// 
    /// This will do cleanups that don't require any semantic information.
    /// </summary>
    Task<SyntaxNode> CleanupAsync(SyntaxNode root, ImmutableArray<TextSpan> spans, SyntaxFormattingOptions options, SolutionServices services, ImmutableArray<ICodeCleanupProvider> providers, CancellationToken cancellationToken);
}