/// <summary>
///     Top-level representation of a parsed OpenAPI 3.0 specification.
/// </summary>
public sealed class OpenApiSpec
{
    /// <summary>API title from the info object.</summary>
    public string Title { get; set; } = "";
    /// <summary>API description from the info object.</summary>
    public string Description { get; set; } = "";
    /// <summary>API version string from the info object.</summary>
    public string Version { get; set; } = "";
    /// <summary>Base path extracted from the first server URL, if present.</summary>
    public string BasePath { get; set; } = "";
    /// <summary>All parsed endpoints grouped by their original path and method.</summary>
    public List<OpenApiEndpoint> Endpoints { get; } = [];
    /// <summary>Named schemas from the components/schemas section.</summary>
    public Dictionary<string, OpenApiSchema> Schemas { get; } = new(StringComparer.Ordinal);
    /// <summary>Distinct tag names found across all endpoints, in discovery order.</summary>
    public List<string> Tags { get; } = [];
}