npm - @herb-tools/linter - Versions diffs - 0.7.5 → 0.8.0 - Mend

@herb-tools/linter 0.7.5 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (394) hide show

package/src/rules/html-boolean-attributes-no-value.ts CHANGED Viewed

@@ -1,11 +1,15 @@
-import { ParserRule } from "../types.js"
+import { ParserRule, BaseAutofixContext, Mutable } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams, isBooleanAttribute, hasAttributeValue } from "./rule-utils.js"
 import { IdentityPrinter } from "@herb-tools/printer"
-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 BooleanAttributesNoValueVisitor extends AttributeVisitorMixin {
+interface BooleanAttributeAutofixContext extends BaseAutofixContext {
+  node: Mutable<HTMLAttributeNode>
+}
+class BooleanAttributesNoValueVisitor extends AttributeVisitorMixin<BooleanAttributeAutofixContext> {
   protected checkStaticAttributeStaticValue({ originalAttributeName, attributeNode }: StaticAttributeStaticValueParams) {
     this.checkAttribute(originalAttributeName, attributeNode)
   }
@@ -21,19 +25,40 @@ class BooleanAttributesNoValueVisitor extends AttributeVisitorMixin {
     this.addOffense(
       `Boolean attribute \`${IdentityPrinter.print(attributeNode.name)}\` should not have a value. Use \`${attributeName.toLowerCase()}\` instead of \`${IdentityPrinter.print(attributeNode)}\`.`,
       attributeNode.value!.location,
-      "error"
+      {
+        node: attributeNode
+      }
     )
   }
 }
-export class HTMLBooleanAttributesNoValueRule extends ParserRule {
+export class HTMLBooleanAttributesNoValueRule extends ParserRule<BooleanAttributeAutofixContext> {
+  static autocorrectable = true
   name = "html-boolean-attributes-no-value"
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<BooleanAttributeAutofixContext>[] {
     const visitor = new BooleanAttributesNoValueVisitor(this.name, context)
     visitor.visit(result.value)
     return visitor.offenses
   }
+  autofix(offense: LintOffense<BooleanAttributeAutofixContext>, result: ParseResult, _context?: Partial<LintContext>): ParseResult | null {
+    if (!offense.autofixContext) return null
+    const { node } = offense.autofixContext
+    node.equals = null
+    node.value = null
+    return result
+  }
 }

package/src/rules/html-head-only-elements.ts ADDED Viewed

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

package/src/rules/html-iframe-has-title.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { BaseRuleVisitor, getTagName, getAttribute, getAttributeValue } from "./rule-utils.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 IframeHasTitleVisitor extends BaseRuleVisitor {
@@ -31,7 +31,6 @@ class IframeHasTitleVisitor extends BaseRuleVisitor {
       this.addOffense(
         "`<iframe>` elements must have a `title` attribute that describes the content of the frame for screen reader users.",
         node.location,
-        "error"
       )
       return
@@ -43,7 +42,6 @@ class IframeHasTitleVisitor extends BaseRuleVisitor {
       this.addOffense(
         "`<iframe>` elements must have a `title` attribute that describes the content of the frame for screen reader users.",
         node.location,
-        "error"
       )
     }
   }
@@ -52,7 +50,14 @@ class IframeHasTitleVisitor extends BaseRuleVisitor {
 export class HTMLIframeHasTitleRule extends ParserRule {
   name = "html-iframe-has-title"
-  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 IframeHasTitleVisitor(this.name, context)
     visitor.visit(result.value)

package/src/rules/html-img-require-alt.ts CHANGED Viewed

@@ -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 ImgRequireAltVisitor extends BaseRuleVisitor {
@@ -20,8 +20,7 @@ class ImgRequireAltVisitor extends BaseRuleVisitor {
     if (!hasAttribute(node, "alt")) {
       this.addOffense(
         'Missing required `alt` attribute on `<img>` tag. Add `alt=""` for decorative images or `alt="description"` for informative images.',
-        node.tag_name!.location,
-        "error"
+        node.tag_name!.location
       )
     }
   }
@@ -30,7 +29,14 @@ class ImgRequireAltVisitor extends BaseRuleVisitor {
 export class HTMLImgRequireAltRule extends ParserRule {
   name = "html-img-require-alt"
-  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 ImgRequireAltVisitor(this.name, context)
     visitor.visit(result.value)
     return visitor.offenses

package/src/rules/html-input-require-autocomplete.ts ADDED Viewed

@@ -0,0 +1,85 @@
+import { getTagName } from "@herb-tools/core"
+import { BaseRuleVisitor, getAttribute, getAttributeValue, getStaticAttributeValueContent } from "./rule-utils.js"
+import { ParserRule } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
+import type { ParseResult, HTMLOpenTagNode } from "@herb-tools/core"
+class HTMLInputRequireAutocompleteVisitor extends BaseRuleVisitor {
+  readonly HTML_INPUT_TYPES_REQUIRING_AUTOCOMPLETE = new Set([
+    "color",
+    "date",
+    "datetime-local",
+    "email",
+    "month",
+    "number",
+    "password",
+    "range",
+    "search",
+    "tel",
+    "text",
+    "time",
+    "url",
+    "week",
+  ])
+  visitHTMLOpenTagNode(node: HTMLOpenTagNode): void {
+    this.checkInputTag(node)
+  }
+  private checkInputTag(node: HTMLOpenTagNode): void {
+    if (!this.isInputTag(node) || this.hasAutocomplete(node)) return
+    const typeAttribute = getAttribute(node, "type");
+    if (!typeAttribute) return
+    const typeValue = getStaticAttributeValueContent(typeAttribute)
+    if (!typeValue) return
+    if (!this.HTML_INPUT_TYPES_REQUIRING_AUTOCOMPLETE.has(typeValue)) return
+    this.addOffense(
+      "Add an `autocomplete` attribute to improve form accessibility. Use a specific value (e.g., `autocomplete=\"email\"`), `autocomplete=\"on\"` for defaults, or `autocomplete=\"off\"` to disable.",
+      node.location
+    )
+  }
+  private hasAutocomplete(node: HTMLOpenTagNode) {
+    const autocompleteAttribute = getAttribute(node, "autocomplete");
+    if (!autocompleteAttribute) return false
+    const autocompleteValue = getAttributeValue(autocompleteAttribute)
+    if (!autocompleteValue) return false
+    return true
+  }
+  private isInputTag(node: HTMLOpenTagNode) {
+    const tagName = getTagName(node);
+    if (tagName === "input") {
+      return true
+    } else {
+      return false
+    }
+  }
+}
+export class HTMLInputRequireAutocompleteRule extends ParserRule {
+  name = "html-input-require-autocomplete"
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
+    const visitor = new HTMLInputRequireAutocompleteVisitor(this.name, context)
+    visitor.visit(result.value)
+    return visitor.offenses
+  }
+}

package/src/rules/html-navigation-has-label.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { BaseRuleVisitor, getTagName, hasAttribute, getAttributeValue, findAttributeByName, getAttributes } from "./rule-utils.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 NavigationHasLabelVisitor extends BaseRuleVisitor {
@@ -32,7 +32,6 @@ class NavigationHasLabelVisitor extends BaseRuleVisitor {
       this.addOffense(
         message,
         node.tag_name!.location,
-        "error"
       )
     }
   }
@@ -54,7 +53,14 @@ class NavigationHasLabelVisitor extends BaseRuleVisitor {
 export class HTMLNavigationHasLabelRule extends ParserRule {
   name = "html-navigation-has-label"
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: false,
+      severity: "error"
+    }
+  }
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new NavigationHasLabelVisitor(this.name, context)
     visitor.visit(result.value)

package/src/rules/html-no-aria-hidden-on-focusable.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { BaseRuleVisitor, getTagName, hasAttribute, getAttributeValue, findAttributeByName, getAttributes } from "./rule-utils.js"
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { HTMLOpenTagNode, ParseResult } from "@herb-tools/core"
 const INTERACTIVE_ELEMENTS = new Set([
@@ -21,7 +21,6 @@ class NoAriaHiddenOnFocusableVisitor extends BaseRuleVisitor {
       this.addOffense(
         `Elements that are focusable should not have \`aria-hidden="true"\` because it will cause confusion for assistive technology users.`,
         node.tag_name!.location,
-        "error"
       )
     }
   }
@@ -80,7 +79,14 @@ class NoAriaHiddenOnFocusableVisitor extends BaseRuleVisitor {
 export class HTMLNoAriaHiddenOnFocusableRule extends ParserRule {
   name = "html-no-aria-hidden-on-focusable"
-  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 NoAriaHiddenOnFocusableVisitor(this.name, context)
     visitor.visit(result.value)

package/src/rules/html-no-block-inside-inline.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { BaseRuleVisitor, isInlineElement, isBlockElement } 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, HTMLElementNode, ParseResult } from "@herb-tools/core"
 class BlockInsideInlineVisitor extends BaseRuleVisitor {
@@ -26,7 +26,6 @@ class BlockInsideInlineVisitor extends BaseRuleVisitor {
     this.addOffense(
       `${elementType} element \`<${tagName}>\` cannot be placed inside inline element \`<${parentInline}>\`.`,
       openTag.tag_name!.location,
-      "error"
     )
   }
@@ -77,7 +76,14 @@ class BlockInsideInlineVisitor extends BaseRuleVisitor {
 export class HTMLNoBlockInsideInlineRule extends ParserRule {
   name = "html-no-block-inside-inline"
-  check(result: ParseResult, context?: Partial<LintContext>): LintOffense[] {
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: false,
+      severity: "error"
+    }
+  }
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
     const visitor = new BlockInsideInlineVisitor(this.name, context)
     visitor.visit(result.value)
     return visitor.offenses

package/src/rules/html-no-duplicate-attributes.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import { ParserRule } from "../types.js"
 import { AttributeVisitorMixin, StaticAttributeStaticValueParams, StaticAttributeDynamicValueParams } from "./rule-utils.js"
-import type { LintOffense, LintContext } from "../types.js"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js"
 import type { HTMLOpenTagNode, HTMLAttributeNode, ParseResult } from "@herb-tools/core"
 class NoDuplicateAttributesVisitor extends AttributeVisitorMixin {
@@ -39,7 +39,6 @@ class NoDuplicateAttributesVisitor extends AttributeVisitorMixin {
           this.addOffense(
             `Duplicate attribute \`${attributeName}\` found on tag. Remove the duplicate occurrence.`,
             attributeNode.name!.location,
-            "error"
           )
         }
       }
@@ -50,7 +49,14 @@ class NoDuplicateAttributesVisitor extends AttributeVisitorMixin {
 export class HTMLNoDuplicateAttributesRule extends ParserRule {
   name = "html-no-duplicate-attributes"
-  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 NoDuplicateAttributesVisitor(this.name, context)
     visitor.visit(result.value)

package/src/rules/html-no-duplicate-ids.ts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { ParserRule } from "../types"
+import { ParserRule, BaseAutofixContext } from "../types"
 import { ControlFlowTrackingVisitor, ControlFlowType } from "./rule-utils"
 import { LiteralNode } from "@herb-tools/core"
 import { Printer, IdentityPrinter } from "@herb-tools/printer"
@@ -6,7 +6,7 @@ import { Printer, IdentityPrinter } from "@herb-tools/printer"
 import { hasERBOutput, getValidatableStaticContent, isEffectivelyStatic, isNode, getStaticAttributeName, isERBOutputNode } from "@herb-tools/core"
 import type { ParseResult, HTMLAttributeNode, ERBContentNode } from "@herb-tools/core"
-import type { LintOffense, LintContext } from "../types"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types"
 interface ControlFlowState {
   previousBranchIds: Set<string>
@@ -29,7 +29,7 @@ class OutputPrinter extends Printer {
   }
 }
-class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<ControlFlowState, BranchState> {
+class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<BaseAutofixContext, ControlFlowState, BranchState> {
   private documentIds: Set<string> = new Set<string>()
   private currentBranchIds: Set<string> = new Set<string>()
   private controlFlowIds: Set<string> = new Set<string>()
@@ -180,7 +180,6 @@ class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<ControlFlowState,
     this.addOffense(
       `Duplicate ID \`${identifier}\` found. IDs must be unique within a document.`,
       location,
-      "error"
     )
   }
@@ -188,7 +187,6 @@ class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<ControlFlowState,
     this.addOffense(
       `Duplicate ID \`${identifier}\` found within the same loop iteration. IDs must be unique within the same loop iteration.`,
       location,
-      "error"
     )
   }
@@ -196,7 +194,6 @@ class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<ControlFlowState,
     this.addOffense(
       `Duplicate ID \`${identifier}\` found within the same control flow branch. IDs must be unique within the same control flow branch.`,
       location,
-      "error"
     )
   }
 }
@@ -204,7 +201,14 @@ class NoDuplicateIdsVisitor extends ControlFlowTrackingVisitor<ControlFlowState,
 export class HTMLNoDuplicateIdsRule extends ParserRule {
   name = "html-no-duplicate-ids"
-  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 NoDuplicateIdsVisitor(this.name, context)
     visitor.visit(result.value)

package/src/rules/html-no-duplicate-meta-names.ts ADDED Viewed

@@ -0,0 +1,188 @@
+import { isHTMLElementNode } from "@herb-tools/core"
+import { getTagName, getAttributeName, getAttributeValue, forEachAttribute } from "./rule-utils"
+import { ControlFlowTrackingVisitor, ControlFlowType } from "./rule-utils"
+import { ParserRule, BaseAutofixContext } from "../types"
+import type { ParseResult, HTMLElementNode, HTMLAttributeNode } from "@herb-tools/core"
+import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types"
+interface MetaTag {
+  node: HTMLElementNode
+  nameValue?: string
+  httpEquivValue?: string
+}
+interface ControlFlowState {
+  previousBranchMetas: MetaTag[]
+  previousControlFlowMetas: MetaTag[]
+}
+interface BranchState {
+  previousBranchMetas: MetaTag[]
+}
+class HTMLNoDuplicateMetaNamesVisitor extends ControlFlowTrackingVisitor<BaseAutofixContext, ControlFlowState, BranchState> {
+  private elementStack: string[] = []
+  private documentMetas: MetaTag[] = []
+  private currentBranchMetas: MetaTag[] = []
+  private controlFlowMetas: MetaTag[] = []
+  visitHTMLElementNode(node: HTMLElementNode): void {
+    const tagName = getTagName(node)?.toLowerCase()
+    if (!tagName) return
+    if (tagName === "head") {
+      this.documentMetas = []
+      this.currentBranchMetas = []
+      this.controlFlowMetas = []
+    } else if (tagName === "meta" && this.insideHead) {
+      this.collectAndCheckMetaTag(node)
+    }
+    this.elementStack.push(tagName)
+    this.visitChildNodes(node)
+    this.elementStack.pop()
+  }
+  protected onEnterControlFlow(_controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean): ControlFlowState {
+    const stateToRestore: ControlFlowState = {
+      previousBranchMetas: this.currentBranchMetas,
+      previousControlFlowMetas: this.controlFlowMetas
+    }
+    this.currentBranchMetas = []
+    if (!wasAlreadyInControlFlow) {
+      this.controlFlowMetas = []
+    }
+    return stateToRestore
+  }
+  protected onExitControlFlow(controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean, stateToRestore: ControlFlowState): void {
+    if (controlFlowType === ControlFlowType.CONDITIONAL && !wasAlreadyInControlFlow) {
+      this.controlFlowMetas.forEach(meta => this.documentMetas.push(meta))
+    }
+    this.currentBranchMetas = stateToRestore.previousBranchMetas
+    this.controlFlowMetas = stateToRestore.previousControlFlowMetas
+  }
+  protected onEnterBranch(): BranchState {
+    const stateToRestore: BranchState = {
+      previousBranchMetas: this.currentBranchMetas
+    }
+    if (this.isInControlFlow) {
+      this.currentBranchMetas = []
+    }
+    return stateToRestore
+  }
+  protected onExitBranch(_stateToRestore: BranchState): void {}
+  private get insideHead(): boolean {
+    return this.elementStack.includes("head")
+  }
+  private collectAndCheckMetaTag(node: HTMLElementNode): void {
+    const metaTag: MetaTag = { node }
+    this.extractAttributes(node, metaTag)
+    if (!metaTag.nameValue && !metaTag.httpEquivValue) return
+    if (this.isInControlFlow) {
+      this.handleControlFlowMeta(metaTag)
+    } else {
+      this.handleGlobalMeta(metaTag)
+    }
+    this.currentBranchMetas.push(metaTag)
+  }
+  private extractAttributes(node: HTMLElementNode, metaTag: MetaTag): void {
+    if (isHTMLElementNode(node) && node.open_tag) {
+      forEachAttribute(node.open_tag as any, (attributeNode: HTMLAttributeNode) => {
+        const name = getAttributeName(attributeNode)
+        const value = getAttributeValue(attributeNode)?.trim()
+        if (name === "name" && value) {
+          metaTag.nameValue = value
+        } else if (name === "http-equiv" && value) {
+          metaTag.httpEquivValue = value
+        }
+      })
+    }
+  }
+  private handleControlFlowMeta(metaTag: MetaTag): void {
+    if (this.currentControlFlowType === ControlFlowType.LOOP) {
+      this.checkAgainstMetaList(metaTag, this.currentBranchMetas, "within the same loop iteration")
+    } else {
+      this.checkAgainstMetaList(metaTag, this.currentBranchMetas, "within the same control flow branch")
+      this.checkAgainstMetaList(metaTag, this.documentMetas, "")
+      this.controlFlowMetas.push(metaTag)
+    }
+  }
+  private handleGlobalMeta(metaTag: MetaTag): void {
+    this.checkAgainstMetaList(metaTag, this.documentMetas, "")
+    this.documentMetas.push(metaTag)
+  }
+  private checkAgainstMetaList(metaTag: MetaTag, existingMetas: MetaTag[], context: string): void {
+    for (const existing of existingMetas) {
+      if (this.areMetaTagsDuplicate(metaTag, existing)) {
+        const attributeDescription = metaTag.nameValue
+          ? `\`name="${metaTag.nameValue}"\``
+          : `\`http-equiv="${metaTag.httpEquivValue}"\``
+        const attributeType = metaTag.nameValue ? "Meta names" : "`http-equiv` values"
+        const contextMsg = context ? ` ${context}` : ""
+        this.addOffense(
+          `Duplicate \`<meta>\` tag with ${attributeDescription}${contextMsg}. ${attributeType} should be unique within the \`<head>\` section.`,
+          metaTag.node.location,
+        )
+        return
+      }
+    }
+  }
+  private areMetaTagsDuplicate(meta1: MetaTag, meta2: MetaTag): boolean {
+    if (meta1.nameValue && meta2.nameValue) {
+      return meta1.nameValue.toLowerCase() === meta2.nameValue.toLowerCase()
+    }
+    if (meta1.httpEquivValue && meta2.httpEquivValue) {
+      return meta1.httpEquivValue.toLowerCase() === meta2.httpEquivValue.toLowerCase()
+    }
+    return false
+  }
+}
+export class HTMLNoDuplicateMetaNamesRule extends ParserRule {
+  static autocorrectable = false
+  name = "html-no-duplicate-meta-names"
+  get defaultConfig(): FullRuleConfig {
+    return {
+      enabled: true,
+      severity: "error"
+    }
+  }
+  check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[] {
+    const visitor = new HTMLNoDuplicateMetaNamesVisitor(this.name, context)
+    visitor.visit(result.value)
+    return visitor.offenses
+  }
+}