namespace AvParser.Core.Parsing;

/// <summary>Read-only view over every registered text parser.</summary>
public interface IParserCatalog
{
    /// <summary>All registered parsers, ordered by <see cref="IParser{TInput,TOutput}.DisplayName"/>.</summary>
    IReadOnlyList<ITextParser> Parsers { get; }

    /// <summary>The parser used when nothing has been chosen yet.</summary>
    ITextParser DefaultParser { get; }

    /// <summary>Finds a parser by its stable id; <see langword="null"/> when unknown.</summary>
    ITextParser? Find(string? id);

    /// <summary>Finds a parser by id, falling back to <see cref="DefaultParser"/>.</summary>
    ITextParser FindOrDefault(string? id) => Find(id) ?? DefaultParser;
}