@herb-tools/linter 0.7.5 → 0.8.0

package/src/rules/herb-disable-comment-valid-rule-name.ts

@@ -0,0 +1,62 @@
+import { ParserRule } from "../types.js"
+import { HerbDisableCommentParsedVisitor } from "./herb-disable-comment-base.js"
+
+import { didyoumean } from "@herb-tools/core"
+
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
+import type { ERBContentNode, ParseResult } from "@herb-tools/core"
+import type { HerbDisableComment } from "../herb-disable-comment-utils.js"
+
+class HerbDisableCommentValidRuleNameVisitor extends HerbDisableCommentParsedVisitor {
+  private validRuleNames: Set<string> = new Set()
+  private validRuleNamesList: string[] = []
+
+  constructor(ruleName: string, validRuleNames: string[], context?: Partial<LintContext>) {
+    super(ruleName, context)
+
+    this.validRuleNames = new Set([...validRuleNames, "all"])
+    this.validRuleNamesList = Array.from(this.validRuleNames)
+  }
+
+  protected checkParsedHerbDisable(node: ERBContentNode, _content: string, herbDisable: HerbDisableComment): void {
+    herbDisable.ruleNameDetails.forEach(ruleDetail => {
+      if (this.validRuleNames.has(ruleDetail.name)) return
+
+      const suggestion = didyoumean(ruleDetail.name, this.validRuleNamesList)
+      const message = suggestion
+        ? `Unknown rule \`${ruleDetail.name}\`. Did you mean \`${suggestion}\`?`
+        : `Unknown rule \`${ruleDetail.name}\`.`
+
+      const location = this.createRuleNameLocation(node, ruleDetail)
+      this.addOffenseWithFallback(message, location, node)
+    })
+  }
+}
+
+export class HerbDisableCommentValidRuleNameRule extends ParserRule {
+  name = "herb-disable-comment-valid-rule-name"
+
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "warning"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
+    const validRuleNames = context?.validRuleNames
+
+    if (!validRuleNames) return []
+    if (validRuleNames.length === 0) return []
+
+    const visitor = new HerbDisableCommentValidRuleNameVisitor(
+      this.name,
+      validRuleNames,
+      context
+    )
+
+    visitor.visit(result.value)
+
+    return visitor.offenses
+  }
+}

package/src/rules/html-anchor-require-href.ts

@@ -1,7 +1,7 @@
 import { BaseRuleVisitor, getTagName, hasAttribute } from "./rule-utils.js"
 
 import { ParserRule } from "../types.js"
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { HTMLOpenTagNode, ParseResult } from "@herb-tools/core"
 
 class AnchorRechireHrefVisitor extends BaseRuleVisitor {
@@ -21,7 +21,6 @@ class AnchorRechireHrefVisitor extends BaseRuleVisitor {
       this.addOffense(
         "Add an `href` attribute to `<a>` to ensure it is focusable and accessible.",
         node.tag_name!.location,
-        "error",
       )
     }
   }
@@ -30,7 +29,14 @@ class AnchorRechireHrefVisitor extends BaseRuleVisitor {
 export class HTMLAnchorRequireHrefRule extends ParserRule {
   name = "html-anchor-require-href"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AnchorRechireHrefVisitor(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-aria-attribute-must-be-valid.ts

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { ARIA_ATTRIBUTES, AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult, HTMLAttributeNode } from "@herb-tools/core"
 
 class AriaAttributeMustBeValid extends AttributeVisitorMixin {
@@ -20,7 +20,6 @@ class AriaAttributeMustBeValid extends AttributeVisitorMixin {
     this.addOffense(
       `The attribute \`${attributeName}\` is not a valid ARIA attribute. ARIA attributes must match the WAI-ARIA specification.`,
       attributeNode.location,
-      "error"
     )
   }
 }
@@ -28,7 +27,14 @@ class AriaAttributeMustBeValid extends AttributeVisitorMixin {
 export class HTMLAriaAttributeMustBeValid extends ParserRule {
   name = "html-aria-attribute-must-be-valid"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AriaAttributeMustBeValid(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-aria-label-is-well-formatted.ts

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult } from "@herb-tools/core"
 
 class AriaLabelIsWellFormattedVisitor extends AttributeVisitorMixin {
@@ -12,7 +12,6 @@ class AriaLabelIsWellFormattedVisitor extends AttributeVisitorMixin {
       this.addOffense(
         "The `aria-label` attribute value text should not contain line breaks. Use concise, single-line descriptions.",
         attributeNode.location,
-        "error"
       )
 
       return
@@ -22,7 +21,6 @@ class AriaLabelIsWellFormattedVisitor extends AttributeVisitorMixin {
       this.addOffense(
         "The `aria-label` attribute value should not be formatted like an ID. Use natural, sentence-case text instead.",
         attributeNode.location,
-        "error"
       )
 
       return
@@ -32,7 +30,6 @@ class AriaLabelIsWellFormattedVisitor extends AttributeVisitorMixin {
       this.addOffense(
         "The `aria-label` attribute value text should be formatted like visual text. Use sentence case (capitalize the first letter).",
         attributeNode.location,
-        "error"
       )
     }
   }
@@ -49,7 +46,14 @@ class AriaLabelIsWellFormattedVisitor extends AttributeVisitorMixin {
 export class HTMLAriaLabelIsWellFormattedRule extends ParserRule {
   name = "html-aria-label-is-well-formatted"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AriaLabelIsWellFormattedVisitor(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-aria-level-must-be-valid.ts

@@ -2,7 +2,7 @@ import { ParserRule } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams } from "./rule-utils.js"
 import { getValidatableStaticContent, hasERBOutput, filterLiteralNodes, filterERBContentNodes, isERBOutputNode } from "@herb-tools/core"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult, HTMLAttributeNode } from "@herb-tools/core"
 
 class HTMLAriaLevelMustBeValidVisitor extends AttributeVisitorMixin {
@@ -65,7 +65,14 @@ class HTMLAriaLevelMustBeValidVisitor extends AttributeVisitorMixin {
 export class HTMLAriaLevelMustBeValidRule extends ParserRule {
   name = "html-aria-level-must-be-valid"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new HTMLAriaLevelMustBeValidVisitor(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-aria-role-heading-requires-level.ts

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { AttributeVisitorMixin, getAttributeName, getAttributes, StaticAttributeStaticValueParams } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult } from "@herb-tools/core"
 
 class AriaRoleHeadingRequiresLevel extends AttributeVisitorMixin {
@@ -15,7 +15,6 @@ class AriaRoleHeadingRequiresLevel extends AttributeVisitorMixin {
     this.addOffense(
       `Element with \`role="heading"\` must have an \`aria-level\` attribute.`,
       attributeNode.location,
-      "error"
     )
   }
 }
@@ -23,7 +22,14 @@ class AriaRoleHeadingRequiresLevel extends AttributeVisitorMixin {
 export class HTMLAriaRoleHeadingRequiresLevelRule extends ParserRule {
   name = "html-aria-role-heading-requires-level"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AriaRoleHeadingRequiresLevel(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-aria-role-must-be-valid.ts

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { AttributeVisitorMixin, VALID_ARIA_ROLES, StaticAttributeStaticValueParams } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult } from "@herb-tools/core"
 
 class AriaRoleMustBeValid extends AttributeVisitorMixin {
@@ -13,7 +13,6 @@ class AriaRoleMustBeValid extends AttributeVisitorMixin {
     this.addOffense(
       `The \`role\` attribute must be a valid ARIA role. Role \`${attributeValue}\` is not recognized.`,
       attributeNode.location,
-      "error"
     )
   }
 }
@@ -21,7 +20,14 @@ class AriaRoleMustBeValid extends AttributeVisitorMixin {
 export class HTMLAriaRoleMustBeValidRule extends ParserRule {
   name = "html-aria-role-must-be-valid"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AriaRoleMustBeValid(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-attribute-double-quotes.ts

@@ -1,11 +1,16 @@
-import { ParserRule } from "../types.js"
+import { ParserRule, BaseAutofixContext, Mutable } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams, getAttributeValueQuoteType, hasAttributeValue } from "./rule-utils.js"
 import { filterLiteralNodes } from "@herb-tools/core"
 
-import type { LintOffense, LintContext } from "../types.js"
-import type { ParseResult } from "@herb-tools/core"
+import type { UnboundLintOffense, LintOffense, LintContext, FullRuleConfig } from "../types.js"
+import type { ParseResult, HTMLAttributeNode } from "@herb-tools/core"
 
-class AttributeDoubleQuotesVisitor extends AttributeVisitorMixin {
+interface AttributeDoubleQuotesAutofixContext extends BaseAutofixContext {
+  node: Mutable<HTMLAttributeNode>
+  valueContent: string
+}
+
+class AttributeDoubleQuotesVisitor extends AttributeVisitorMixin<AttributeDoubleQuotesAutofixContext> {
   protected checkStaticAttributeStaticValue({ attributeName, attributeValue, attributeNode }: StaticAttributeStaticValueParams) {
     if (!hasAttributeValue(attributeNode)) return
     if (getAttributeValueQuoteType(attributeNode) !== "single") return
@@ -14,7 +19,10 @@ class AttributeDoubleQuotesVisitor extends AttributeVisitorMixin {
     this.addOffense(
       `Attribute \`${attributeName}\` uses single quotes. Prefer double quotes for HTML attribute values: \`${attributeName}="${attributeValue}"\`.`,
       attributeNode.value!.location,
-      "warning"
+      {
+        node: attributeNode,
+        valueContent: attributeValue
+      }
     )
   }
 
@@ -26,19 +34,45 @@ class AttributeDoubleQuotesVisitor extends AttributeVisitorMixin {
     this.addOffense(
       `Attribute \`${attributeName}\` uses single quotes. Prefer double quotes for HTML attribute values: \`${attributeName}="${combinedValue}"\`.`,
       attributeNode.value!.location,
-      "warning"
+      {
+        node: attributeNode,
+        valueContent: combinedValue || ""
+      }
     )
   }
 }
 
-export class HTMLAttributeDoubleQuotesRule extends ParserRule {
+export class HTMLAttributeDoubleQuotesRule extends ParserRule<AttributeDoubleQuotesAutofixContext> {
+  static autocorrectable = true
   name = "html-attribute-double-quotes"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "warning"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<AttributeDoubleQuotesAutofixContext>[] {
     const visitor = new AttributeDoubleQuotesVisitor(this.name, context)
 
     visitor.visit(result.value)
 
     return visitor.offenses
   }
+
+  autofix(offense: LintOffense<AttributeDoubleQuotesAutofixContext>, result: ParseResult, _context?: Partial<LintContext>): ParseResult | null {
+    if (!offense.autofixContext) return null
+
+    const { node: { value } } = offense.autofixContext
+
+    if (!value) return null
+    if (!value.open_quote) return  null
+    if (!value.close_quote) return  null
+
+    value.open_quote.value = '"'
+    value.close_quote.value = '"'
+
+    return result
+  }
 }

package/src/rules/html-attribute-equals-spacing.ts

@@ -1,10 +1,14 @@
 import { BaseRuleVisitor } from "./rule-utils.js"
-import { ParserRule } from "../types.js"
+import { ParserRule, BaseAutofixContext, Mutable } from "../types.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { ParseResult, HTMLAttributeNode } from "@herb-tools/core"
 
-class HTMLAttributeEqualsSpacingVisitor extends BaseRuleVisitor {
+interface AttributeEqualsSpacingAutofixContext extends BaseAutofixContext {
+  node: Mutable<HTMLAttributeNode>
+}
+
+class HTMLAttributeEqualsSpacingVisitor extends BaseRuleVisitor<AttributeEqualsSpacingAutofixContext> {
   visitHTMLAttributeNode(attribute: HTMLAttributeNode): void {
     if (!attribute.equals || !attribute.name || !attribute.value) {
       return
@@ -14,7 +18,7 @@ class HTMLAttributeEqualsSpacingVisitor extends BaseRuleVisitor {
       this.addOffense(
         "Remove whitespace before `=` in HTML attribute",
         attribute.equals.location,
-        "error"
+        { node: attribute }
       )
     }
 
@@ -22,20 +26,40 @@ class HTMLAttributeEqualsSpacingVisitor extends BaseRuleVisitor {
       this.addOffense(
         "Remove whitespace after `=` in HTML attribute",
         attribute.equals.location,
-        "error"
+        { node: attribute }
       )
     }
   }
 }
 
-export class HTMLAttributeEqualsSpacingRule extends ParserRule {
+export class HTMLAttributeEqualsSpacingRule extends ParserRule<AttributeEqualsSpacingAutofixContext> {
+  static autocorrectable = true
   name = "html-attribute-equals-spacing"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<AttributeEqualsSpacingAutofixContext>[] {
     const visitor = new HTMLAttributeEqualsSpacingVisitor(this.name, context)
 
     visitor.visit(result.value)
 
     return visitor.offenses
   }
+
+  autofix(offense: LintOffense<AttributeEqualsSpacingAutofixContext>, result: ParseResult, _context?: Partial<LintContext>): ParseResult | null {
+    if (!offense.autofixContext) return null
+
+    const { node: { equals } } = offense.autofixContext
+
+    if (!equals) return null
+
+    equals.value = "="
+
+    return result
+  }
 }

package/src/rules/html-attribute-values-require-quotes.ts

@@ -1,10 +1,16 @@
-import { ParserRule } from "../types.js"
+import { Token, Location } from "@herb-tools/core"
+import { ParserRule, BaseAutofixContext, Mutable } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
-import type { HTMLAttributeNode, HTMLAttributeValueNode, ParseResult } from "@herb-tools/core"
+import type { UnboundLintOffense, LintOffense, LintContext, FullRuleConfig } from "../types.js"
+import type { HTMLAttributeNode, ParseResult,  } from "@herb-tools/core"
 
-class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin {
+interface AttributeValuesRequireQuotesAutofixContext extends BaseAutofixContext {
+  node: Mutable<HTMLAttributeNode>
+  unquotedValue: string
+}
+
+class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin<AttributeValuesRequireQuotesAutofixContext> {
   protected checkStaticAttributeStaticValue({ attributeName, attributeValue, attributeNode }: StaticAttributeStaticValueParams): void {
     if (this.hasAttributeValue(attributeNode)) return
     if (this.isQuoted(attributeNode)) return
@@ -12,7 +18,10 @@ class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin {
     this.addOffense(
       `Attribute value should be quoted: \`${attributeName}="${attributeValue}"\`. Always wrap attribute values in quotes.`,
       attributeNode.value!.location,
-      "error"
+      {
+        node: attributeNode,
+        unquotedValue: attributeValue
+      }
     )
   }
 
@@ -23,7 +32,10 @@ class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin {
     this.addOffense(
       `Attribute value should be quoted: \`${attributeName}="${combinedValue}"\`. Always wrap attribute values in quotes.`,
       attributeNode.value!.location,
-      "error"
+      {
+        node: attributeNode,
+        unquotedValue: combinedValue || ""
+      }
     )
   }
 
@@ -32,20 +44,54 @@ class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin {
   }
 
   private isQuoted(attributeNode: HTMLAttributeNode): boolean {
-    const valueNode = attributeNode.value as HTMLAttributeValueNode
+    const valueNode = attributeNode.value
 
-    return valueNode.quoted
+    return valueNode ? valueNode.quoted : false
   }
 }
 
-export class HTMLAttributeValuesRequireQuotesRule extends ParserRule {
+export class HTMLAttributeValuesRequireQuotesRule extends ParserRule<AttributeValuesRequireQuotesAutofixContext> {
+  static autocorrectable = true
   name = "html-attribute-values-require-quotes"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<AttributeValuesRequireQuotesAutofixContext>[] {
     const visitor = new AttributeValuesRequireQuotesVisitor(this.name, context)
 
     visitor.visit(result.value)
 
     return visitor.offenses
   }
+
+  autofix(offense: LintOffense<AttributeValuesRequireQuotesAutofixContext>, result: ParseResult, _context?: Partial<LintContext>): ParseResult | null {
+    if (!offense.autofixContext) return null
+
+    const { node: { value } } = offense.autofixContext
+
+    if (!value) return null
+
+    const quote = Token.from({ type: "TOKEN_QUOTE", value: '"', location: Location.zero, range: [0, 0] })
+
+    if (value.open_quote) {
+      value.open_quote.value = '"'
+    } else {
+      value.open_quote = quote
+    }
+
+    if (value.close_quote) {
+      value.close_quote.value = '"'
+    } else {
+      value.close_quote = quote
+    }
+
+    value.quoted = true
+
+    return result
+  }
 }

package/src/rules/html-avoid-both-disabled-and-aria-disabled.ts

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { BaseRuleVisitor, getTagName, hasAttribute, getAttributes, findAttributeByName } from "./rule-utils.js"
 
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { HTMLOpenTagNode, HTMLAttributeValueNode, ParseResult, Node } from "@herb-tools/core"
 
 const ELEMENTS_WITH_NATIVE_DISABLED_ATTRIBUTE_SUPPORT = new Set([
@@ -32,7 +32,6 @@ class AvoidBothDisabledAndAriaDisabledVisitor extends BaseRuleVisitor {
       this.addOffense(
         "aria-disabled may be used in place of native HTML disabled to allow tab-focus on an otherwise ignored element. Setting both attributes is contradictory and confusing. Choose either disabled or aria-disabled, not both.",
         node.tag_name!.location,
-        "error"
       )
     }
   }
@@ -56,7 +55,14 @@ class AvoidBothDisabledAndAriaDisabledVisitor extends BaseRuleVisitor {
 export class HTMLAvoidBothDisabledAndAriaDisabledRule extends ParserRule {
   name = "html-avoid-both-disabled-and-aria-disabled"
 
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new AvoidBothDisabledAndAriaDisabledVisitor(this.name, context)
 
     visitor.visit(result.value)

package/src/rules/html-body-only-elements.ts

@@ -0,0 +1,60 @@
+import { ParserRule } from "../types.js"
+import { BaseRuleVisitor, getTagName, isBodyOnlyTag } from "./rule-utils.js"
+
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
+import type { HTMLElementNode, ParseResult } from "@herb-tools/core"
+
+class HTMLBodyOnlyElementsVisitor extends BaseRuleVisitor {
+  private elementStack: string[] = []
+
+  visitHTMLElementNode(node: HTMLElementNode): void {
+    const tagName = getTagName(node.open_tag)?.toLowerCase()
+    if (!tagName) return
+
+    this.checkBodyOnlyElement(node, tagName)
+
+    this.elementStack.push(tagName)
+    this.visitChildNodes(node)
+    this.elementStack.pop()
+  }
+
+  private checkBodyOnlyElement(node: HTMLElementNode, tagName: string): void {
+    if (this.insideBody) return
+    if (!this.insideHead) return
+    if (!isBodyOnlyTag(tagName)) return
+
+    this.addOffense(
+      `Element \`<${tagName}>\` must be placed inside the \`<body>\` tag.`,
+      node.location,
+    )
+  }
+
+  private get insideBody(): boolean {
+    return this.elementStack.includes("body")
+  }
+
+  private get insideHead(): boolean {
+    return this.elementStack.includes("head")
+  }
+}
+
+export class HTMLBodyOnlyElementsRule extends ParserRule {
+  static autocorrectable = false
+  name = "html-body-only-elements"
+
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error",
+      exclude: ["**/*.xml", "**/*.xml.erb"]
+    }
+  }
+
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
+    const visitor = new HTMLBodyOnlyElementsVisitor(this.name, context)
+
+    visitor.visit(result.value)
+
+    return visitor.offenses
+  }
+}