@herb-tools/linter 0.5.0 → 0.6.1

package/dist/types/rules/index.d.ts

@@ -1,19 +1,29 @@
 export * from "./erb-no-empty-tags.js";
 export * from "./erb-no-output-control-flow.js";
+export * from "./erb-no-silent-tag-in-attribute-name.js";
 export * from "./erb-prefer-image-tag-helper.js";
 export * from "./erb-requires-trailing-newline.js";
 export * from "./html-anchor-require-href.js";
+export * from "./html-aria-label-is-well-formatted.js";
 export * from "./html-aria-level-must-be-valid.js";
 export * from "./html-aria-role-heading-requires-level.js";
 export * from "./html-aria-role-must-be-valid.js";
 export * from "./html-attribute-double-quotes.js";
+export * from "./html-attribute-equals-spacing.js";
 export * from "./html-attribute-values-require-quotes.js";
+export * from "./html-avoid-both-disabled-and-aria-disabled.js";
 export * from "./html-boolean-attributes-no-value.js";
+export * from "./html-iframe-has-title.js";
 export * from "./html-img-require-alt.js";
+export * from "./html-navigation-has-label.js";
+export * from "./html-no-aria-hidden-on-focusable.js";
 export * from "./html-no-block-inside-inline.js";
 export * from "./html-no-duplicate-attributes.js";
 export * from "./html-no-duplicate-ids.js";
 export * from "./html-no-empty-headings.js";
 export * from "./html-no-nested-links.js";
+export * from "./html-no-positive-tab-index.js";
+export * from "./html-no-self-closing.js";
+export * from "./html-no-title-attribute.js";
 export * from "./html-tag-name-lowercase.js";
 export * from "./svg-tag-name-capitalization.js";

package/dist/types/rules/rule-utils.d.ts

@@ -1,6 +1,11 @@
 import { Visitor, Location } from "@herb-tools/core";
-import type { HTMLAttributeNode, HTMLOpenTagNode, HTMLSelfCloseTagNode, LexResult, Token } from "@herb-tools/core";
+import type { HTMLAttributeNode, HTMLAttributeValueNode, HTMLOpenTagNode, LexResult, Token, Node } from "@herb-tools/core";
+import type * as Nodes from "@herb-tools/core";
 import type { LintOffense, LintSeverity, LintContext } from "../types.js";
+export declare enum ControlFlowType {
+    CONDITIONAL = 0,
+    LOOP = 1
+}
 /**
  * Base visitor class that provides common functionality for rule visitors
  */
@@ -19,17 +24,86 @@ export declare abstract class BaseRuleVisitor extends Visitor {
     protected addOffense(message: string, location: Location, severity?: LintSeverity): void;
 }
 /**
- * Gets attributes from either an HTMLOpenTagNode or HTMLSelfCloseTagNode
+ * Mixin that adds control flow tracking capabilities to rule visitors
+ * This allows rules to track state across different control flow structures
+ * like if/else branches, loops, etc.
+ *
+ * @template TControlFlowState - Type for state passed between onEnterControlFlow and onExitControlFlow
+ * @template TBranchState - Type for state passed between onEnterBranch and onExitBranch
  */
-export declare function getAttributes(node: HTMLOpenTagNode | HTMLSelfCloseTagNode): any[];
+export declare abstract class ControlFlowTrackingVisitor<TControlFlowState = any, TBranchState = any> extends BaseRuleVisitor {
+    protected isInControlFlow: boolean;
+    protected currentControlFlowType: ControlFlowType | null;
+    /**
+     * Handle visiting a control flow node with proper scope management
+     */
+    protected handleControlFlowNode(node: Node, controlFlowType: ControlFlowType, visitChildren: () => void): void;
+    /**
+     * Handle visiting a branch node (like else, when) with proper scope management
+     */
+    protected startNewBranch(visitChildren: () => void): void;
+    visitERBIfNode(node: Nodes.ERBIfNode): void;
+    visitERBUnlessNode(node: Nodes.ERBUnlessNode): void;
+    visitERBCaseNode(node: Nodes.ERBCaseNode): void;
+    visitERBCaseMatchNode(node: Nodes.ERBCaseMatchNode): void;
+    visitERBWhileNode(node: Nodes.ERBWhileNode): void;
+    visitERBForNode(node: Nodes.ERBForNode): void;
+    visitERBUntilNode(node: Nodes.ERBUntilNode): void;
+    visitERBBlockNode(node: Nodes.ERBBlockNode): void;
+    visitERBElseNode(node: Nodes.ERBElseNode): void;
+    visitERBWhenNode(node: Nodes.ERBWhenNode): void;
+    protected abstract onEnterControlFlow(controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean): TControlFlowState;
+    protected abstract onExitControlFlow(controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean, stateToRestore: TControlFlowState): void;
+    protected abstract onEnterBranch(): TBranchState;
+    protected abstract onExitBranch(stateToRestore: TBranchState): void;
+}
+/**
+ * Gets attributes from an HTMLOpenTagNode
+ */
+export declare function getAttributes(node: HTMLOpenTagNode): HTMLAttributeNode[];
 /**
  * Gets the tag name from an HTML tag node (lowercased)
  */
-export declare function getTagName(node: HTMLOpenTagNode | HTMLSelfCloseTagNode): string | null;
+export declare function getTagName(node: HTMLOpenTagNode): string | null;
 /**
  * Gets the attribute name from an HTMLAttributeNode (lowercased)
+ * Returns null if the attribute name contains dynamic content (ERB)
  */
 export declare function getAttributeName(attributeNode: HTMLAttributeNode): string | null;
+/**
+ * Checks if an attribute has a dynamic (ERB-containing) name
+ */
+export declare function hasDynamicAttributeName(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the combined string representation of an attribute name (for debugging)
+ * This includes both static content and ERB syntax
+ */
+export declare function getCombinedAttributeNameString(attributeNode: HTMLAttributeNode): string;
+/**
+ * Checks if an attribute value contains only static content (no ERB)
+ */
+export declare function hasStaticAttributeValue(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Checks if an attribute value contains dynamic content (ERB)
+ */
+export declare function hasDynamicAttributeValue(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the static string value of an attribute (returns null if it contains ERB)
+ */
+export declare function getStaticAttributeValue(attributeNode: HTMLAttributeNode): string | null;
+/**
+ * Gets the value nodes array for dynamic inspection
+ */
+export declare function getAttributeValueNodes(attributeNode: HTMLAttributeNode): Node[];
+/**
+ * Checks if an attribute value contains any static content (for validation purposes)
+ */
+export declare function hasStaticAttributeValueContent(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the static content of an attribute value (all literal parts combined)
+ * Returns the concatenated literal content, or null if no literal nodes exist
+ */
+export declare function getStaticAttributeValueContent(attributeNode: HTMLAttributeNode): string | null;
 /**
  * Gets the attribute value content from an HTMLAttributeValueNode
  */
@@ -41,20 +115,25 @@ export declare function hasAttributeValue(attributeNode: HTMLAttributeNode): boo
 /**
  * Gets the quote type used for an attribute value
  */
-export declare function getAttributeValueQuoteType(attributeNode: HTMLAttributeNode): "single" | "double" | "none" | null;
+export declare function getAttributeValueQuoteType(nodeOrAttribute: HTMLAttributeNode | HTMLAttributeValueNode): "single" | "double" | "none" | null;
 /**
  * Finds an attribute by name in a list of attributes
  */
-export declare function findAttributeByName(attributes: any[], attributeName: string): HTMLAttributeNode | null;
+export declare function findAttributeByName(attributes: Node[], attributeName: string): HTMLAttributeNode | null;
+/**
+ * Checks if a tag has a specific attribute
+ */
+export declare function hasAttribute(node: HTMLOpenTagNode, attributeName: string): boolean;
 /**
  * Checks if a tag has a specific attribute
  */
-export declare function hasAttribute(node: HTMLOpenTagNode | HTMLSelfCloseTagNode, attributeName: string): boolean;
+export declare function getAttribute(node: HTMLOpenTagNode, attributeName: string): HTMLAttributeNode | null;
 /**
  * Common HTML element categorization
  */
 export declare const HTML_INLINE_ELEMENTS: Set<string>;
 export declare const HTML_BLOCK_ELEMENTS: Set<string>;
+export declare const HTML_VOID_ELEMENTS: Set<string>;
 export declare const HTML_BOOLEAN_ATTRIBUTES: Set<string>;
 export declare const HEADING_TAGS: Set<string>;
 /**
@@ -67,6 +146,37 @@ export declare const SVG_CAMEL_CASE_ELEMENTS: Set<string>;
  */
 export declare const SVG_LOWERCASE_TO_CAMELCASE: Map<string, string>;
 export declare const VALID_ARIA_ROLES: Set<string>;
+/**
+ * Parameter types for AttributeVisitorMixin methods
+ */
+export interface StaticAttributeStaticValueParams {
+    attributeName: string;
+    attributeValue: string;
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+}
+export interface StaticAttributeDynamicValueParams {
+    attributeName: string;
+    valueNodes: Node[];
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedValue?: string | null;
+}
+export interface DynamicAttributeStaticValueParams {
+    nameNodes: Node[];
+    attributeValue: string;
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedName?: string;
+}
+export interface DynamicAttributeDynamicValueParams {
+    nameNodes: Node[];
+    valueNodes: Node[];
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedName?: string;
+    combinedValue?: string | null;
+}
 export declare const ARIA_ATTRIBUTES: Set<string>;
 /**
  * Helper function to create a location at the end of the source with a 1-character range
@@ -80,21 +190,44 @@ export declare function isInlineElement(tagName: string): boolean;
  * Checks if an element is block-level
  */
 export declare function isBlockElement(tagName: string): boolean;
+/**
+ * Checks if an element is a void element
+ */
+export declare function isVoidElement(tagName: string): boolean;
 /**
  * Checks if an attribute is a boolean attribute
  */
 export declare function isBooleanAttribute(attributeName: string): boolean;
 /**
- * Abstract base class for rules that need to check individual attributes on HTML tags
- * Eliminates duplication of visitHTMLOpenTagNode/visitHTMLSelfCloseTagNode patterns
- * and attribute iteration logic. Provides simplified interface with extracted attribute info.
+ * Attribute visitor that provides granular processing based on both
+ * attribute name type (static/dynamic) and value type (static/dynamic)
+ *
+ * This gives you 4 distinct methods to override:
+ * - checkStaticAttributeStaticValue()   - name="class" value="foo"
+ * - checkStaticAttributeDynamicValue()  - name="class" value="<%= css_class %>"
+ * - checkDynamicAttributeStaticValue()  - name="data-<%= key %>" value="foo"
+ * - checkDynamicAttributeDynamicValue() - name="data-<%= key %>" value="<%= value %>"
  */
 export declare abstract class AttributeVisitorMixin extends BaseRuleVisitor {
     constructor(ruleName: string, context?: Partial<LintContext>);
     visitHTMLOpenTagNode(node: HTMLOpenTagNode): void;
-    visitHTMLSelfCloseTagNode(node: HTMLSelfCloseTagNode): void;
     private checkAttributesOnNode;
-    protected abstract checkAttribute(attributeName: string, attributeValue: string | null, attributeNode: HTMLAttributeNode, parentNode: HTMLOpenTagNode | HTMLSelfCloseTagNode): void;
+    /**
+     * Static attribute name with static value: class="container"
+     */
+    protected checkStaticAttributeStaticValue(params: StaticAttributeStaticValueParams): void;
+    /**
+     * Static attribute name with dynamic value: class="<%= css_class %>"
+     */
+    protected checkStaticAttributeDynamicValue(params: StaticAttributeDynamicValueParams): void;
+    /**
+     * Dynamic attribute name with static value: data-<%= key %>="foo"
+     */
+    protected checkDynamicAttributeStaticValue(params: DynamicAttributeStaticValueParams): void;
+    /**
+     * Dynamic attribute name with dynamic value: data-<%= key %>="<%= value %>"
+     */
+    protected checkDynamicAttributeDynamicValue(params: DynamicAttributeDynamicValueParams): void;
 }
 /**
  * Checks if an attribute value is quoted
@@ -103,7 +236,7 @@ export declare function isAttributeValueQuoted(attributeNode: HTMLAttributeNode)
 /**
  * Iterates over all attributes of a tag node, calling the callback for each attribute
  */
-export declare function forEachAttribute(node: HTMLOpenTagNode | HTMLSelfCloseTagNode, callback: (attributeNode: HTMLAttributeNode) => void): void;
+export declare function forEachAttribute(node: HTMLOpenTagNode, callback: (attributeNode: HTMLAttributeNode) => void): void;
 /**
  * Base lexer visitor class that provides common functionality for lexer-based rule visitors
  */

package/dist/types/src/rules/erb-no-silent-tag-in-attribute-name.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class ERBNoSilentTagInAttributeNameRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

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

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLAriaLabelIsWellFormattedRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-attribute-equals-spacing.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLAttributeEqualsSpacingRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

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

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLAvoidBothDisabledAndAriaDisabledRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-iframe-has-title.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLIframeHasTitleRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-navigation-has-label.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLNavigationHasLabelRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-no-aria-hidden-on-focusable.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLNoAriaHiddenOnFocusableRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-no-positive-tab-index.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLNoPositiveTabIndexRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-no-self-closing.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintContext, LintOffense } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLNoSelfClosingRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-no-title-attribute.d.ts

@@ -0,0 +1,7 @@
+import { ParserRule } from "../types.js";
+import type { LintOffense, LintContext } from "../types.js";
+import type { ParseResult } from "@herb-tools/core";
+export declare class HTMLNoTitleAttributeRule extends ParserRule {
+    name: string;
+    check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+}

package/dist/types/src/rules/html-tag-name-lowercase.d.ts

@@ -1,7 +1,8 @@
 import { ParserRule } from "../types.js";
+import { ParseResult } from "@herb-tools/core";
 import type { LintOffense, LintContext } from "../types.js";
-import type { ParseResult } from "@herb-tools/core";
 export declare class HTMLTagNameLowercaseRule extends ParserRule {
     name: string;
+    isEnabled(result: ParseResult, context?: Partial<LintContext>): boolean;
     check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
 }

package/dist/types/src/rules/index.d.ts

@@ -1,19 +1,29 @@
 export * from "./erb-no-empty-tags.js";
 export * from "./erb-no-output-control-flow.js";
+export * from "./erb-no-silent-tag-in-attribute-name.js";
 export * from "./erb-prefer-image-tag-helper.js";
 export * from "./erb-requires-trailing-newline.js";
 export * from "./html-anchor-require-href.js";
+export * from "./html-aria-label-is-well-formatted.js";
 export * from "./html-aria-level-must-be-valid.js";
 export * from "./html-aria-role-heading-requires-level.js";
 export * from "./html-aria-role-must-be-valid.js";
 export * from "./html-attribute-double-quotes.js";
+export * from "./html-attribute-equals-spacing.js";
 export * from "./html-attribute-values-require-quotes.js";
+export * from "./html-avoid-both-disabled-and-aria-disabled.js";
 export * from "./html-boolean-attributes-no-value.js";
+export * from "./html-iframe-has-title.js";
 export * from "./html-img-require-alt.js";
+export * from "./html-navigation-has-label.js";
+export * from "./html-no-aria-hidden-on-focusable.js";
 export * from "./html-no-block-inside-inline.js";
 export * from "./html-no-duplicate-attributes.js";
 export * from "./html-no-duplicate-ids.js";
 export * from "./html-no-empty-headings.js";
 export * from "./html-no-nested-links.js";
+export * from "./html-no-positive-tab-index.js";
+export * from "./html-no-self-closing.js";
+export * from "./html-no-title-attribute.js";
 export * from "./html-tag-name-lowercase.js";
 export * from "./svg-tag-name-capitalization.js";

package/dist/types/src/rules/rule-utils.d.ts

@@ -1,6 +1,11 @@
 import { Visitor, Location } from "@herb-tools/core";
-import type { HTMLAttributeNode, HTMLOpenTagNode, HTMLSelfCloseTagNode, LexResult, Token } from "@herb-tools/core";
+import type { HTMLAttributeNode, HTMLAttributeValueNode, HTMLOpenTagNode, LexResult, Token, Node } from "@herb-tools/core";
+import type * as Nodes from "@herb-tools/core";
 import type { LintOffense, LintSeverity, LintContext } from "../types.js";
+export declare enum ControlFlowType {
+    CONDITIONAL = 0,
+    LOOP = 1
+}
 /**
  * Base visitor class that provides common functionality for rule visitors
  */
@@ -19,17 +24,86 @@ export declare abstract class BaseRuleVisitor extends Visitor {
     protected addOffense(message: string, location: Location, severity?: LintSeverity): void;
 }
 /**
- * Gets attributes from either an HTMLOpenTagNode or HTMLSelfCloseTagNode
+ * Mixin that adds control flow tracking capabilities to rule visitors
+ * This allows rules to track state across different control flow structures
+ * like if/else branches, loops, etc.
+ *
+ * @template TControlFlowState - Type for state passed between onEnterControlFlow and onExitControlFlow
+ * @template TBranchState - Type for state passed between onEnterBranch and onExitBranch
  */
-export declare function getAttributes(node: HTMLOpenTagNode | HTMLSelfCloseTagNode): any[];
+export declare abstract class ControlFlowTrackingVisitor<TControlFlowState = any, TBranchState = any> extends BaseRuleVisitor {
+    protected isInControlFlow: boolean;
+    protected currentControlFlowType: ControlFlowType | null;
+    /**
+     * Handle visiting a control flow node with proper scope management
+     */
+    protected handleControlFlowNode(node: Node, controlFlowType: ControlFlowType, visitChildren: () => void): void;
+    /**
+     * Handle visiting a branch node (like else, when) with proper scope management
+     */
+    protected startNewBranch(visitChildren: () => void): void;
+    visitERBIfNode(node: Nodes.ERBIfNode): void;
+    visitERBUnlessNode(node: Nodes.ERBUnlessNode): void;
+    visitERBCaseNode(node: Nodes.ERBCaseNode): void;
+    visitERBCaseMatchNode(node: Nodes.ERBCaseMatchNode): void;
+    visitERBWhileNode(node: Nodes.ERBWhileNode): void;
+    visitERBForNode(node: Nodes.ERBForNode): void;
+    visitERBUntilNode(node: Nodes.ERBUntilNode): void;
+    visitERBBlockNode(node: Nodes.ERBBlockNode): void;
+    visitERBElseNode(node: Nodes.ERBElseNode): void;
+    visitERBWhenNode(node: Nodes.ERBWhenNode): void;
+    protected abstract onEnterControlFlow(controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean): TControlFlowState;
+    protected abstract onExitControlFlow(controlFlowType: ControlFlowType, wasAlreadyInControlFlow: boolean, stateToRestore: TControlFlowState): void;
+    protected abstract onEnterBranch(): TBranchState;
+    protected abstract onExitBranch(stateToRestore: TBranchState): void;
+}
+/**
+ * Gets attributes from an HTMLOpenTagNode
+ */
+export declare function getAttributes(node: HTMLOpenTagNode): HTMLAttributeNode[];
 /**
  * Gets the tag name from an HTML tag node (lowercased)
  */
-export declare function getTagName(node: HTMLOpenTagNode | HTMLSelfCloseTagNode): string | null;
+export declare function getTagName(node: HTMLOpenTagNode): string | null;
 /**
  * Gets the attribute name from an HTMLAttributeNode (lowercased)
+ * Returns null if the attribute name contains dynamic content (ERB)
  */
 export declare function getAttributeName(attributeNode: HTMLAttributeNode): string | null;
+/**
+ * Checks if an attribute has a dynamic (ERB-containing) name
+ */
+export declare function hasDynamicAttributeName(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the combined string representation of an attribute name (for debugging)
+ * This includes both static content and ERB syntax
+ */
+export declare function getCombinedAttributeNameString(attributeNode: HTMLAttributeNode): string;
+/**
+ * Checks if an attribute value contains only static content (no ERB)
+ */
+export declare function hasStaticAttributeValue(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Checks if an attribute value contains dynamic content (ERB)
+ */
+export declare function hasDynamicAttributeValue(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the static string value of an attribute (returns null if it contains ERB)
+ */
+export declare function getStaticAttributeValue(attributeNode: HTMLAttributeNode): string | null;
+/**
+ * Gets the value nodes array for dynamic inspection
+ */
+export declare function getAttributeValueNodes(attributeNode: HTMLAttributeNode): Node[];
+/**
+ * Checks if an attribute value contains any static content (for validation purposes)
+ */
+export declare function hasStaticAttributeValueContent(attributeNode: HTMLAttributeNode): boolean;
+/**
+ * Gets the static content of an attribute value (all literal parts combined)
+ * Returns the concatenated literal content, or null if no literal nodes exist
+ */
+export declare function getStaticAttributeValueContent(attributeNode: HTMLAttributeNode): string | null;
 /**
  * Gets the attribute value content from an HTMLAttributeValueNode
  */
@@ -41,20 +115,25 @@ export declare function hasAttributeValue(attributeNode: HTMLAttributeNode): boo
 /**
  * Gets the quote type used for an attribute value
  */
-export declare function getAttributeValueQuoteType(attributeNode: HTMLAttributeNode): "single" | "double" | "none" | null;
+export declare function getAttributeValueQuoteType(nodeOrAttribute: HTMLAttributeNode | HTMLAttributeValueNode): "single" | "double" | "none" | null;
 /**
  * Finds an attribute by name in a list of attributes
  */
-export declare function findAttributeByName(attributes: any[], attributeName: string): HTMLAttributeNode | null;
+export declare function findAttributeByName(attributes: Node[], attributeName: string): HTMLAttributeNode | null;
+/**
+ * Checks if a tag has a specific attribute
+ */
+export declare function hasAttribute(node: HTMLOpenTagNode, attributeName: string): boolean;
 /**
  * Checks if a tag has a specific attribute
  */
-export declare function hasAttribute(node: HTMLOpenTagNode | HTMLSelfCloseTagNode, attributeName: string): boolean;
+export declare function getAttribute(node: HTMLOpenTagNode, attributeName: string): HTMLAttributeNode | null;
 /**
  * Common HTML element categorization
  */
 export declare const HTML_INLINE_ELEMENTS: Set<string>;
 export declare const HTML_BLOCK_ELEMENTS: Set<string>;
+export declare const HTML_VOID_ELEMENTS: Set<string>;
 export declare const HTML_BOOLEAN_ATTRIBUTES: Set<string>;
 export declare const HEADING_TAGS: Set<string>;
 /**
@@ -67,6 +146,37 @@ export declare const SVG_CAMEL_CASE_ELEMENTS: Set<string>;
  */
 export declare const SVG_LOWERCASE_TO_CAMELCASE: Map<string, string>;
 export declare const VALID_ARIA_ROLES: Set<string>;
+/**
+ * Parameter types for AttributeVisitorMixin methods
+ */
+export interface StaticAttributeStaticValueParams {
+    attributeName: string;
+    attributeValue: string;
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+}
+export interface StaticAttributeDynamicValueParams {
+    attributeName: string;
+    valueNodes: Node[];
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedValue?: string | null;
+}
+export interface DynamicAttributeStaticValueParams {
+    nameNodes: Node[];
+    attributeValue: string;
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedName?: string;
+}
+export interface DynamicAttributeDynamicValueParams {
+    nameNodes: Node[];
+    valueNodes: Node[];
+    attributeNode: HTMLAttributeNode;
+    parentNode: HTMLOpenTagNode;
+    combinedName?: string;
+    combinedValue?: string | null;
+}
 export declare const ARIA_ATTRIBUTES: Set<string>;
 /**
  * Helper function to create a location at the end of the source with a 1-character range
@@ -80,21 +190,44 @@ export declare function isInlineElement(tagName: string): boolean;
  * Checks if an element is block-level
  */
 export declare function isBlockElement(tagName: string): boolean;
+/**
+ * Checks if an element is a void element
+ */
+export declare function isVoidElement(tagName: string): boolean;
 /**
  * Checks if an attribute is a boolean attribute
  */
 export declare function isBooleanAttribute(attributeName: string): boolean;
 /**
- * Abstract base class for rules that need to check individual attributes on HTML tags
- * Eliminates duplication of visitHTMLOpenTagNode/visitHTMLSelfCloseTagNode patterns
- * and attribute iteration logic. Provides simplified interface with extracted attribute info.
+ * Attribute visitor that provides granular processing based on both
+ * attribute name type (static/dynamic) and value type (static/dynamic)
+ *
+ * This gives you 4 distinct methods to override:
+ * - checkStaticAttributeStaticValue()   - name="class" value="foo"
+ * - checkStaticAttributeDynamicValue()  - name="class" value="<%= css_class %>"
+ * - checkDynamicAttributeStaticValue()  - name="data-<%= key %>" value="foo"
+ * - checkDynamicAttributeDynamicValue() - name="data-<%= key %>" value="<%= value %>"
  */
 export declare abstract class AttributeVisitorMixin extends BaseRuleVisitor {
     constructor(ruleName: string, context?: Partial<LintContext>);
     visitHTMLOpenTagNode(node: HTMLOpenTagNode): void;
-    visitHTMLSelfCloseTagNode(node: HTMLSelfCloseTagNode): void;
     private checkAttributesOnNode;
-    protected abstract checkAttribute(attributeName: string, attributeValue: string | null, attributeNode: HTMLAttributeNode, parentNode: HTMLOpenTagNode | HTMLSelfCloseTagNode): void;
+    /**
+     * Static attribute name with static value: class="container"
+     */
+    protected checkStaticAttributeStaticValue(params: StaticAttributeStaticValueParams): void;
+    /**
+     * Static attribute name with dynamic value: class="<%= css_class %>"
+     */
+    protected checkStaticAttributeDynamicValue(params: StaticAttributeDynamicValueParams): void;
+    /**
+     * Dynamic attribute name with static value: data-<%= key %>="foo"
+     */
+    protected checkDynamicAttributeStaticValue(params: DynamicAttributeStaticValueParams): void;
+    /**
+     * Dynamic attribute name with dynamic value: data-<%= key %>="<%= value %>"
+     */
+    protected checkDynamicAttributeDynamicValue(params: DynamicAttributeDynamicValueParams): void;
 }
 /**
  * Checks if an attribute value is quoted
@@ -103,7 +236,7 @@ export declare function isAttributeValueQuoted(attributeNode: HTMLAttributeNode)
 /**
  * Iterates over all attributes of a tag node, calling the callback for each attribute
  */
-export declare function forEachAttribute(node: HTMLOpenTagNode | HTMLSelfCloseTagNode, callback: (attributeNode: HTMLAttributeNode) => void): void;
+export declare function forEachAttribute(node: HTMLOpenTagNode, callback: (attributeNode: HTMLAttributeNode) => void): void;
 /**
  * Base lexer visitor class that provides common functionality for lexer-based rule visitors
  */

package/dist/types/src/types.d.ts

@@ -19,11 +19,27 @@ export declare abstract class ParserRule {
     static type: "parser";
     abstract name: string;
     abstract check(result: ParseResult, context?: Partial<LintContext>): LintOffense[];
+    /**
+     * Optional method to determine if this rule should run.
+     * If not implemented, rule is always enabled.
+     * @param result - The parse result to analyze
+     * @param context - Optional context for linting
+     * @returns true if rule should run, false to skip
+     */
+    isEnabled?(result: ParseResult, context?: Partial<LintContext>): boolean;
 }
 export declare abstract class LexerRule {
     static type: "lexer";
     abstract name: string;
     abstract check(lexResult: LexResult, context?: Partial<LintContext>): LintOffense[];
+    /**
+     * Optional method to determine if this rule should run.
+     * If not implemented, rule is always enabled.
+     * @param lexResult - The lex result to analyze
+     * @param context - Optional context for linting
+     * @returns true if rule should run, false to skip
+     */
+    isEnabled?(lexResult: LexResult, context?: Partial<LintContext>): boolean;
 }
 export interface LexerRuleConstructor {
     type: "lexer";
@@ -44,6 +60,14 @@ export declare abstract class SourceRule {
     static type: "source";
     abstract name: string;
     abstract check(source: string, context?: Partial<LintContext>): LintOffense[];
+    /**
+     * Optional method to determine if this rule should run.
+     * If not implemented, rule is always enabled.
+     * @param source - The source code to analyze
+     * @param context - Optional context for linting
+     * @returns true if rule should run, false to skip
+     */
+    isEnabled?(source: string, context?: Partial<LintContext>): boolean;
 }
 export interface SourceRuleConstructor {
     type: "source";