/// <summary>
///     Context provided to the template engine for rendering a page.
/// </summary>
public sealed class ThemeRenderContext
{
    /// <summary>Site configuration.</summary>
    public required SiteConfig Config { get; init; }
    /// <summary>Navigation tree.</summary>
    public NavigationTree? Navigation { get; init; }
    /// <summary>Layout templates keyed by name.</summary>
    public required Dictionary<string, string> Templates { get; init; }
    /// <summary>Partial templates keyed by name.</summary>
    public required Dictionary<string, string> Partials { get; init; }
    /// <summary>CSS file paths relative to output root.</summary>
    public List<string> CssFiles { get; init; } = [];
    /// <summary>JS file paths relative to output root.</summary>
    public List<string> JsFiles { get; init; } = [];
    /// <summary>All pages in the site, used for prev/next navigation.</summary>
    public IReadOnlyList<DocPage> AllPages { get; init; } = [];
    /// <summary>All configured documentation versions.</summary>
    public IReadOnlyList<DocVersion> Versions { get; init; } = [];
    /// <summary>The current version being built, if versioning is enabled.</summary>
    public DocVersion? CurrentVersion { get; init; }
    /// <summary>Package metadata for NuGet install widget.</summary>
    public PackageMetadata? PackageInfo { get; init; }

    /// <summary>Gets a template by layout name.</summary>
    public string? GetTemplate(string layoutName) => Templates.GetValueOrDefault(layoutName);
}