defmodule NLdoc.Validation.Rules.EmptyHeading do
  @moduledoc """
  This rule validates that a heading must always contain discernible text.
  """

  alias NLdoc.Spec.{Content, Heading}
  alias NLdoc.Validation.Severity

  use NLdoc.Validation.Rule,
    severity: Severity.error(),
    rule: "empty-heading",
    ruleset: "https://dequeuniversity.com/rules/axe/html",
    ruleset_version: "4.10",
    validates: [Heading]

  @impl true
  def valid?(resource = %Heading{}, _),
    do: resource |> Content.discernible_text?()
end