/// <summary>
///     Site metadata: title, description, base URL, branding.
/// </summary>
public sealed record SiteMetadata
{
    /// <summary>The site title displayed in the header and browser tab.</summary>
    public required string Title { get; init; }
    /// <summary>A short description of the site for meta tags.</summary>
    public string Description { get; init; } = "";
    /// <summary>The base URL where the site will be hosted.</summary>
    public string Url { get; init; } = "";
    /// <summary>
    ///     Resolved reference to the site logo. See <see cref = "SiteAssetReference"/> for
    ///     the supported yaml forms (relative to mokadocs.yaml dir, parent-dir escape with
    ///     <c>../</c>, absolute URL pass-through).
    /// </summary>
    public SiteAssetReference? Logo { get; init; }
    /// <summary>
    ///     Resolved reference to the site favicon. Same resolution rules as <see cref = "Logo"/>.
    /// </summary>
    public SiteAssetReference? Favicon { get; init; }
    /// <summary>Copyright notice for the footer.</summary>
    public string? Copyright { get; init; }
    /// <summary>Edit link configuration for "Edit this page" links.</summary>
    public EditLinkConfig? EditLink { get; init; }
}