using Nuuru.Server.DTOs.BBCode;

namespace Nuuru.Server.Services.BBCode
{
    /// <summary>
    /// Result of parsing BBCode that includes both HTML and extracted mentions
    /// </summary>
    public record ParseResult(string Html, List<Guid> MentionedUserIds, List<int> QuotedForumPostIds);

    public interface IBBCodeService
    {
        /// <summary>
        /// Parses BBCode to sanitized HTML
        /// </summary>
        string Parse(string bbcode);

        /// <summary>
        /// Parses BBCode to sanitized HTML with context
        /// </summary>
        string Parse(string bbcode, BBCodeContext context);

        /// <summary>
        /// Parses BBCode to sanitized HTML and extracts mentioned user IDs
        /// </summary>
        ParseResult ParseWithMentions(string bbcode);

        /// <summary>
        /// Parses BBCode to sanitized HTML and extracts mentioned user IDs with context
        /// </summary>
        ParseResult ParseWithMentions(string bbcode, BBCodeContext context);

        /// <summary>
        /// Parses BBCode to sanitized HTML and extracts mentioned user IDs, with avatar lookup for quote headers
        /// </summary>
        ParseResult ParseWithMentions(string bbcode, Func<string, string?>? lookupAvatar);

        /// <summary>
        /// Parses BBCode to sanitized HTML and extracts mentioned user IDs with context and avatar lookup
        /// </summary>
        ParseResult ParseWithMentions(string bbcode, BBCodeContext context, Func<string, string?>? lookupAvatar);

        /// <summary>
        /// Parses BBCode to sanitized HTML with quote verification support
        /// </summary>
        string Parse(string bbcode, Func<string, string, QuoteSourceInfo>? lookupSource);

        /// <summary>
        /// Parses BBCode to sanitized HTML with quote verification and context
        /// </summary>
        string Parse(string bbcode, Func<string, string, QuoteSourceInfo>? lookupSource, BBCodeContext context);

        /// <summary>
        /// Parses BBCode to an AST for frontend consumption
        /// </summary>
        List<BbNodeDto> ParseToAst(string bbcode);

        /// <summary>
        /// Parses BBCode to an AST for frontend consumption with context
        /// </summary>
        List<BbNodeDto> ParseToAst(string bbcode, BBCodeContext context);

        /// <summary>
        /// Validates BBCode and returns any errors
        /// </summary>
        bool Validate(string bbcode, out List<string> errors);

        /// <summary>
        /// Extracts plain text content from BBCode, stripping all tags
        /// </summary>
        string ExtractPlainText(string bbcode);

        /// <summary>
        /// Extracts plain text content from BBCode with context, stripping all tags
        /// </summary>
        string ExtractPlainText(string bbcode, BBCodeContext context);

        /// <summary>
        /// Extracts plain text content from BBCode, excluding text inside quote blocks
        /// </summary>
        string ExtractPlainTextExcludingQuotes(string bbcode, BBCodeContext context = BBCodeContext.Comment);
    }
}