/// <summary>
///     Provides plugins with access to host services, configuration, and logging.
/// </summary>
public interface IPluginContext
{
    /// <summary>
    ///     The current site configuration.
    /// </summary>
    SiteConfig SiteConfig { get; }

    /// <summary>
    ///     Plugin-specific options from the <c>plugins[].options</c> section of mokadocs.yaml.
    /// </summary>
    IReadOnlyDictionary<string, object> Options { get; }

    /// <summary>
    ///     Resolves a service from the host DI container.
    /// </summary>
    /// <typeparam name = "T">The service type to resolve.</typeparam>
    /// <returns>The resolved service, or <c>null</c> if not registered.</returns>
    T? GetService<T>()
        where T : class;
    /// <summary>
    ///     Logs an informational message from the plugin.
    /// </summary>
    /// <param name = "message">The log message.</param>
    void LogInfo(string message);
    /// <summary>
    ///     Logs a warning message from the plugin.
    /// </summary>
    /// <param name = "message">The warning message.</param>
    void LogWarning(string message);
    /// <summary>
    ///     Logs an error message from the plugin.
    /// </summary>
    /// <param name = "message">The error message.</param>
    void LogError(string message);
}