@herb-tools/linter 0.8.9 → 0.9.0

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

@@ -1,7 +1,7 @@
-import { Visitor, Location } from "@herb-tools/core";
-import type { HTMLAttributeNode, HTMLAttributeValueNode, HTMLElementNode, HTMLOpenTagNode, LexResult, Token, Node } from "@herb-tools/core";
+import { Visitor, Location, Position } from "@herb-tools/core";
+import type { HTMLAttributeNode, HTMLOpenTagNode, LexResult, Token, Node } from "@herb-tools/core";
 import type * as Nodes from "@herb-tools/core";
-import type { UnboundLintOffense, LintContext, BaseAutofixContext } from "../types.js";
+import type { UnboundLintOffense, LintContext, LintSeverity, BaseAutofixContext } from "../types.js";
 export declare enum ControlFlowType {
     CONDITIONAL = 0,
     LOOP = 1
@@ -18,11 +18,11 @@ export declare abstract class BaseRuleVisitor<TAutofixContext extends BaseAutofi
      * Helper method to create an unbound lint offense (without severity).
      * The Linter will bind severity based on the rule's config.
      */
-    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext): UnboundLintOffense<TAutofixContext>;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     /**
      * Helper method to add an offense to the offenses array
      */
-    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext): void;
+    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): void;
 }
 /**
  * Mixin that adds control flow tracking capabilities to rule visitors
@@ -59,77 +59,6 @@ export declare abstract class ControlFlowTrackingVisitor<TAutofixContext extends
     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: HTMLElementNode | HTMLOpenTagNode | null | undefined): 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, lowercase?: boolean): 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
- */
-export declare function getAttributeValue(attributeNode: HTMLAttributeNode): string | null;
-/**
- * Checks if an attribute has a value
- */
-export declare function hasAttributeValue(attributeNode: HTMLAttributeNode): boolean;
-/**
- * Gets the quote type used for an attribute value
- */
-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: Node[], attributeName: string): HTMLAttributeNode | null;
-/**
- * Checks if a tag has a specific attribute
- */
-export declare function hasAttribute(node: HTMLOpenTagNode | null | undefined, attributeName: string): boolean;
-/**
- * Checks if a tag has a specific attribute
- */
-export declare function getAttribute(node: HTMLOpenTagNode, attributeName: string): HTMLAttributeNode | null;
 /**
  * Common HTML element categorization
  */
@@ -148,6 +77,12 @@ 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>;
+/**
+ * Abstract ARIA roles used to support the WAI-ARIA Roles Model.
+ * Authors MUST NOT use abstract roles in content.
+ * @see https://www.w3.org/TR/wai-aria-1.0/roles#abstract_roles
+ */
+export declare const ABSTRACT_ARIA_ROLES: Set<string>;
 /**
  * Parameter types for AttributeVisitorMixin methods
  */
@@ -233,14 +168,6 @@ export declare abstract class AttributeVisitorMixin<TAutofixContext extends Base
      */
     protected checkDynamicAttributeDynamicValue(_params: DynamicAttributeDynamicValueParams): void;
 }
-/**
- * Checks if an attribute value is quoted
- */
-export declare function isAttributeValueQuoted(attributeNode: HTMLAttributeNode): boolean;
-/**
- * Iterates over all attributes of a tag node, calling the callback for each attribute
- */
-export declare function forEachAttribute(node: HTMLOpenTagNode, callback: (attributeNode: HTMLAttributeNode) => void): void;
 /**
  * Base lexer visitor class that provides common functionality for lexer-based rule visitors
  */
@@ -253,11 +180,11 @@ export declare abstract class BaseLexerRuleVisitor<TAutofixContext extends BaseA
      * Helper method to create an unbound lint offense (without severity).
      * The Linter will bind severity based on the rule's config.
      */
-    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext): UnboundLintOffense<TAutofixContext>;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     /**
      * Helper method to add an offense to the offenses array
      */
-    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext): void;
+    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): void;
     /**
      * Main entry point for lexer rule visitors
      * @param lexResult - The lexer result containing tokens and source
@@ -286,11 +213,11 @@ export declare abstract class BaseSourceRuleVisitor<TAutofixContext extends Base
      * Helper method to create an unbound lint offense (without severity).
      * The Linter will bind severity based on the rule's config.
      */
-    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext): UnboundLintOffense<TAutofixContext>;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     /**
      * Helper method to add an offense to the offenses array
      */
-    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext): void;
+    protected addOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): void;
     /**
      * Main entry point for source rule visitors
      * @param source - The raw source code
@@ -349,3 +276,23 @@ export declare function isHeadAndBodyTag(tagName: string): boolean;
 export declare function isBodyOnlyTag(tagName: string): boolean;
 export declare function isBodyTag(tagName: string): boolean;
 export declare function isHeadTag(tagName: string): boolean;
+/**
+ * Converts a character offset in a source string to a Position (line, column).
+ * Lines are 1-based, columns are 0-based.
+ */
+export declare function positionFromOffset(source: string, offset: number): Position;
+/**
+ * Creates a Location from a source string, a start offset, and a length.
+ */
+export declare function locationFromOffset(source: string, startOffset: number, length: number): Location;
+/**
+ * Finds a node in the AST that contains a specific position.
+ * Returns the deepest (most specific) node that matches the position and optional predicate.
+ *
+ * @param root - The root node to search from
+ * @param line - Line number (1-based)
+ * @param column - Column number (0-based)
+ * @param predicate - Optional predicate function to filter nodes
+ * @returns The matching node or null if not found
+ */
+export declare function findNodeAtPosition(root: Node, line: number, column: number, predicate?: (node: Node) => boolean): Node | null;

package/dist/types/rules/svg-tag-name-capitalization.d.ts

@@ -8,7 +8,7 @@ interface SVGTagNameCapitalizationAutofixContext extends BaseAutofixContext {
 }
 export declare class SVGTagNameCapitalizationRule extends ParserRule<SVGTagNameCapitalizationAutofixContext> {
     static autocorrectable: boolean;
-    name: string;
+    static ruleName: string;
     get defaultConfig(): FullRuleConfig;
     check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<SVGTagNameCapitalizationAutofixContext>[];
     autofix(offense: LintOffense<SVGTagNameCapitalizationAutofixContext>, result: ParseResult, _context?: Partial<LintContext>): ParseResult | null;

package/dist/types/{src/rules/html-aria-role-must-be-valid.d.ts → rules/turbo-permanent-require-id.d.ts}

@@ -1,8 +1,8 @@
 import { ParserRule } from "../types.js";
 import type { UnboundLintOffense, LintContext, FullRuleConfig } from "../types.js";
 import type { ParseResult } from "@herb-tools/core";
-export declare class HTMLAriaRoleMustBeValidRule extends ParserRule {
-    name: string;
+export declare class TurboPermanentRequireIdRule extends ParserRule {
+    static ruleName: string;
     get defaultConfig(): FullRuleConfig;
     check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense[];
 }

package/dist/types/types.d.ts

@@ -1,16 +1,17 @@
-import { Diagnostic, LexResult, ParseResult } from "@herb-tools/core";
+import { Diagnostic, LexResult, ParseResult, Location } from "@herb-tools/core";
 import type { rules } from "./rules.js";
-import type { Node } from "@herb-tools/core";
+import type { Node, ParserOptions } from "@herb-tools/core";
 import type { RuleConfig } from "@herb-tools/config";
 import type { Mutable } from "@herb-tools/rewriter";
 export type { Mutable } from "@herb-tools/rewriter";
 export type LintSeverity = "error" | "warning" | "info" | "hint";
+export declare const DEFAULT_LINTER_PARSER_OPTIONS: Partial<ParserOptions>;
 export type FullRuleConfig = Required<Pick<RuleConfig, 'enabled' | 'severity'>> & Omit<RuleConfig, 'enabled' | 'severity'>;
 /**
  * Automatically inferred union type of all available linter rule names.
- * This type extracts the 'name' property from each rule class instance.
+ * This type extracts the 'ruleName' property from each rule class.
  */
-export type LinterRule = InstanceType<typeof rules[number]>['name'];
+export type LinterRule = (typeof rules[number])['ruleName'];
 /**
  * Base context for autofix operations. Contains the offending node.
  * Rules can extend this interface to include rule-specific autofix data.
@@ -19,6 +20,8 @@ export type LinterRule = InstanceType<typeof rules[number]>['name'];
 export interface BaseAutofixContext {
     /** The AST node, token, or data structure that caused the offense (mutable) */
     node: Mutable<Node>;
+    /** If true, this fix requires --fix-unsafely to be applied */
+    unsafe?: boolean;
 }
 /**
  * A lint offense without severity bound. Rules produce these, and the Linter
@@ -28,6 +31,8 @@ export interface UnboundLintOffense<TAutofixContext extends BaseAutofixContext =
     rule: LinterRule;
     /** Context data for autofix, including the offending node and rule-specific data */
     autofixContext?: TAutofixContext;
+    /** If set, overrides rule-level severity for this specific offense */
+    severity?: LintSeverity;
 }
 /**
  * A lint offense with severity bound. The Linter produces these by binding
@@ -66,12 +71,17 @@ export declare const DEFAULT_RULE_CONFIG: FullRuleConfig;
  */
 export declare abstract class ParserRule<TAutofixContext extends BaseAutofixContext = BaseAutofixContext> {
     static type: "parser";
+    static ruleName: string;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable: boolean;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable: boolean;
-    abstract name: string;
+    /** Indicates whether the source should be re-indented after autofix. Defaults to false. */
+    static reindentAfterAutofix: boolean;
+    get ruleName(): string;
     get defaultConfig(): FullRuleConfig;
+    get parserOptions(): Partial<ParserOptions>;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     abstract check(result: ParseResult, context?: Partial<LintContext>): UnboundLintOffense<TAutofixContext>[];
     /**
      * Optional method to determine if this rule should run.
@@ -96,12 +106,14 @@ export declare abstract class ParserRule<TAutofixContext extends BaseAutofixCont
  */
 export declare abstract class LexerRule<TAutofixContext extends BaseAutofixContext = BaseAutofixContext> {
     static type: "lexer";
+    static ruleName: string;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable: boolean;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable: boolean;
-    abstract name: string;
+    get ruleName(): string;
     get defaultConfig(): FullRuleConfig;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     abstract check(lexResult: LexResult, context?: Partial<LintContext>): UnboundLintOffense<TAutofixContext>[];
     /**
      * Optional method to determine if this rule should run.
@@ -124,6 +136,7 @@ export declare abstract class LexerRule<TAutofixContext extends BaseAutofixConte
 export interface LexerRuleConstructor {
     type: "lexer";
     new (): LexerRule;
+    ruleName: string;
 }
 /**
  * Complete lint context with all properties defined.
@@ -141,12 +154,14 @@ export interface LintContext {
 export declare const DEFAULT_LINT_CONTEXT: LintContext;
 export declare abstract class SourceRule<TAutofixContext extends BaseAutofixContext = BaseAutofixContext> {
     static type: "source";
+    static ruleName: string;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable: boolean;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable: boolean;
-    abstract name: string;
+    get ruleName(): string;
     get defaultConfig(): FullRuleConfig;
+    protected createOffense(message: string, location: Location, autofixContext?: TAutofixContext, severity?: LintSeverity): UnboundLintOffense<TAutofixContext>;
     abstract check(source: string, context?: Partial<LintContext>): UnboundLintOffense<TAutofixContext>[];
     /**
      * Optional method to determine if this rule should run.
@@ -169,6 +184,7 @@ export declare abstract class SourceRule<TAutofixContext extends BaseAutofixCont
 export interface SourceRuleConstructor {
     type: "source";
     new (): SourceRule;
+    ruleName: string;
 }
 /**
  * Type representing a parser/AST rule class constructor.
@@ -177,6 +193,8 @@ export interface SourceRuleConstructor {
  */
 export type ParserRuleClass = (new () => ParserRule) & {
     type?: "parser";
+    ruleName: string;
+    reindentAfterAutofix?: boolean;
 };
 export type LexerRuleClass = LexerRuleConstructor;
 export type SourceRuleClass = SourceRuleConstructor;

package/dist/types/urls.d.ts

@@ -0,0 +1 @@
+export declare function ruleDocumentationUrl(ruleId: string): string;

package/dist/{src/types.js → types.js}

@@ -1,3 +1,6 @@
+export const DEFAULT_LINTER_PARSER_OPTIONS = {
+    track_whitespace: true,
+};
 /**
  * Default configuration for rules when defaultConfig is not specified.
  * Custom rules can omit defaultConfig and will use these defaults.
@@ -12,26 +15,61 @@ export const DEFAULT_RULE_CONFIG = {
  */
 export class ParserRule {
     static type = "parser";
+    static ruleName;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable = false;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable = false;
+    /** Indicates whether the source should be re-indented after autofix. Defaults to false. */
+    static reindentAfterAutofix = false;
+    get ruleName() {
+        return this.constructor.ruleName;
+    }
     get defaultConfig() {
         return DEFAULT_RULE_CONFIG;
     }
+    get parserOptions() {
+        return DEFAULT_LINTER_PARSER_OPTIONS;
+    }
+    createOffense(message, location, autofixContext, severity) {
+        return {
+            rule: this.ruleName,
+            code: this.ruleName,
+            source: "Herb Linter",
+            message,
+            location,
+            autofixContext,
+            severity,
+        };
+    }
 }
 /**
  * Base class for lexer rules.
  */
 export class LexerRule {
     static type = "lexer";
+    static ruleName;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable = false;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable = false;
+    get ruleName() {
+        return this.constructor.ruleName;
+    }
     get defaultConfig() {
         return DEFAULT_RULE_CONFIG;
     }
+    createOffense(message, location, autofixContext, severity) {
+        return {
+            rule: this.ruleName,
+            code: this.ruleName,
+            source: "Herb Linter",
+            message,
+            location,
+            autofixContext,
+            severity,
+        };
+    }
 }
 /**
  * Default context object with all keys defined but set to undefined
@@ -44,12 +82,27 @@ export const DEFAULT_LINT_CONTEXT = {
 };
 export class SourceRule {
     static type = "source";
+    static ruleName;
     /** Indicates whether this rule supports autofix. Defaults to false. */
     static autocorrectable = false;
     /** Indicates whether this rule supports unsafe autofix (requires --fix-unsafely). Defaults to false. */
     static unsafeAutocorrectable = false;
+    get ruleName() {
+        return this.constructor.ruleName;
+    }
     get defaultConfig() {
         return DEFAULT_RULE_CONFIG;
     }
+    createOffense(message, location, autofixContext, severity) {
+        return {
+            rule: this.ruleName,
+            code: this.ruleName,
+            source: "Herb Linter",
+            message,
+            location,
+            autofixContext,
+            severity,
+        };
+    }
 }
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,6BAA6B,GAA2B;IACnE,gBAAgB,EAAE,IAAI;CACvB,CAAA;AAiED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE,EAAE;CACZ,CAAA;AAED;;GAEG;AACH,MAAM,OAAgB,UAAU;IAC9B,MAAM,CAAC,IAAI,GAAG,QAAiB,CAAA;IAC/B,MAAM,CAAC,QAAQ,CAAQ;IACvB,uEAAuE;IACvE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAA;IAC9B,wGAAwG;IACxG,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAA;IACpC,2FAA2F;IAC3F,MAAM,CAAC,oBAAoB,GAAG,KAAK,CAAA;IAEnC,IAAI,QAAQ;QACV,OAAQ,IAAI,CAAC,WAAiC,CAAC,QAAQ,CAAA;IACzD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,6BAA6B,CAAA;IACtC,CAAC;IAES,aAAa,CAAC,OAAe,EAAE,QAAkB,EAAE,cAAgC,EAAE,QAAuB;QACpH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,MAAM,EAAE,aAAa;YACrB,OAAO;YACP,QAAQ;YACR,cAAc;YACd,QAAQ;SACT,CAAA;IACH,CAAC;;AAwBH;;GAEG;AACH,MAAM,OAAgB,SAAS;IAC7B,MAAM,CAAC,IAAI,GAAG,OAAgB,CAAA;IAC9B,MAAM,CAAC,QAAQ,CAAQ;IACvB,uEAAuE;IACvE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAA;IAC9B,wGAAwG;IACxG,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAA;IAEpC,IAAI,QAAQ;QACV,OAAQ,IAAI,CAAC,WAAgC,CAAC,QAAQ,CAAA;IACxD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAES,aAAa,CAAC,OAAe,EAAE,QAAkB,EAAE,cAAgC,EAAE,QAAuB;QACpH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,MAAM,EAAE,aAAa;YACrB,OAAO;YACP,QAAQ;YACR,cAAc;YACd,QAAQ;SACT,CAAA;IACH,CAAC;;AAyCH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,QAAQ,EAAE,SAAS;IACnB,cAAc,EAAE,SAAS;IACzB,qBAAqB,EAAE,SAAS;IAChC,qBAAqB,EAAE,SAAS;CACxB,CAAA;AAEV,MAAM,OAAgB,UAAU;IAC9B,MAAM,CAAC,IAAI,GAAG,QAAiB,CAAA;IAC/B,MAAM,CAAC,QAAQ,CAAQ;IACvB,uEAAuE;IACvE,MAAM,CAAC,eAAe,GAAG,KAAK,CAAA;IAC9B,wGAAwG;IACxG,MAAM,CAAC,qBAAqB,GAAG,KAAK,CAAA;IAEpC,IAAI,QAAQ;QACV,OAAQ,IAAI,CAAC,WAAiC,CAAC,QAAQ,CAAA;IACzD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAES,aAAa,CAAC,OAAe,EAAE,QAAkB,EAAE,cAAgC,EAAE,QAAuB;QACpH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,MAAM,EAAE,aAAa;YACrB,OAAO;YACP,QAAQ;YACR,cAAc;YACd,QAAQ;SACT,CAAA;IACH,CAAC"}

package/dist/urls.js

@@ -0,0 +1,5 @@
+const DOCS_BASE_URL = "https://herb-tools.dev/linter/rules";
+export function ruleDocumentationUrl(ruleId) {
+    return `${DOCS_BASE_URL}/${ruleId}`;
+}
+//# sourceMappingURL=urls.js.map

package/dist/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../src/urls.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,qCAAqC,CAAA;AAE3D,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,GAAG,aAAa,IAAI,MAAM,EAAE,CAAA;AACrC,CAAC"}

package/docs/rules/README.md

@@ -4,16 +4,32 @@ This page contains documentation for all Herb Linter rules.
 
 ## Available Rules
 
+- [`actionview-no-silent-helper`](./actionview-no-silent-helper.md) - Disallow silent ERB tags for Action View helpers
 - [`erb-comment-syntax`](./erb-comment-syntax.md) - Disallow Ruby comments immediately after ERB tags
 - [`erb-no-case-node-children`](./erb-no-case-node-children.md) - Don't use `children` for `case/when` and `case/in` nodes
+- [`erb-no-conditional-html-element`](./erb-no-conditional-html-element.md) - Disallow conditional HTML elements
+- [`erb-no-duplicate-branch-elements`](./erb-no-duplicate-branch-elements.md) - Disallow duplicate elements across conditional branches
 - [`erb-no-empty-tags`](./erb-no-empty-tags.md) - Disallow empty ERB tags
 - [`erb-no-extra-newline`](./erb-no-extra-newline.md) - Disallow extra newlines.
 - [`erb-no-extra-whitespace-inside-tags`](./erb-no-extra-whitespace-inside-tags.md) - Disallow multiple consecutive spaces inside ERB tags
+- [`erb-no-inline-case-conditions`](./erb-no-inline-case-conditions.md) - Disallow inline `case`/`when` and `case`/`in` conditions in a single ERB tag
+- [`erb-no-instance-variables-in-partials`](./erb-no-instance-variables-in-partials.md) - Disallow instance variables in partials
+- [`erb-no-interpolated-class-names`](./erb-no-interpolated-class-names.md) - Disallow ERB interpolation inside CSS class names
+- [`erb-no-javascript-tag-helper`](./erb-no-javascript-tag-helper.md) - Disallow `javascript_tag` helper
 - [`erb-no-output-control-flow`](./erb-no-output-control-flow.md) - Prevents outputting control flow blocks
+- [`erb-no-output-in-attribute-name`](./erb-no-output-in-attribute-name.md) - Disallow ERB output in attribute names
+- [`erb-no-output-in-attribute-position`](./erb-no-output-in-attribute-position.md) - Disallow ERB output in attribute position
+- [`erb-no-raw-output-in-attribute-value`](./erb-no-raw-output-in-attribute-value.md) - Disallow `<%==` in attribute values
 - [`erb-no-silent-tag-in-attribute-name`](./erb-no-silent-tag-in-attribute-name.md) - Disallow ERB silent tags in HTML attribute names
+- [`erb-no-statement-in-script`](./erb-no-statement-in-script.md) - Disallow ERB statements inside `<script>` tags
+- [`erb-no-then-in-control-flow`](./erb-no-then-in-control-flow.md) - Disallow `then` in ERB control flow expressions
+- [`erb-no-trailing-whitespace`](./erb-no-trailing-whitespace.md) - Disallow trailing whitespace at end of lines.
+- [`erb-no-unsafe-js-attribute`](./erb-no-unsafe-js-attribute.md) - Disallow unsafe ERB output in JavaScript attributes
+- [`erb-no-unsafe-raw`](./erb-no-unsafe-raw.md) - Disallow `raw()` and `.html_safe` in ERB output
+- [`erb-no-unsafe-script-interpolation`](./erb-no-unsafe-script-interpolation.md) - Disallow unsafe ERB output inside `<script>` tags
 - [`erb-prefer-image-tag-helper`](./erb-prefer-image-tag-helper.md) - Prefer `image_tag` helper over `<img>` with ERB expressions
-- [`erb-require-whitespace-inside-tags`](./erb-require-whitespace-inside-tags.md) - Requires whitespace around ERB tags
 - [`erb-require-trailing-newline`](./erb-require-trailing-newline.md) - Enforces that all HTML+ERB template files end with exactly one trailing newline character.
+- [`erb-require-whitespace-inside-tags`](./erb-require-whitespace-inside-tags.md) - Requires whitespace around ERB tags
 - [`erb-right-trim`](./erb-right-trim.md) - Enforce consistent right-trimming syntax.
 - [`erb-strict-locals-comment-syntax`](./erb-strict-locals-comment-syntax.md) - Enforce strict locals comment syntax.
 - [`herb-disable-comment-malformed`](./herb-disable-comment-malformed.md) - Detect malformed `herb:disable` comments.
@@ -22,6 +38,7 @@ This page contains documentation for all Herb Linter rules.
 - [`herb-disable-comment-no-redundant-all`](./herb-disable-comment-no-redundant-all.md) - Disallow redundant use of `all` in `herb:disable` comments.
 - [`herb-disable-comment-unnecessary`](./herb-disable-comment-unnecessary.md) - Detect unnecessary `herb:disable` comments.
 - [`herb-disable-comment-valid-rule-name`](./herb-disable-comment-valid-rule-name.md) - Validate rule names in `herb:disable` comments.
+- [`html-allowed-script-type`](./html-allowed-script-type.md) - Restrict allowed `type` attributes for `<script>` tags
 - [`html-anchor-require-href`](./html-anchor-require-href.md) - Requires an href attribute on anchor tags
 - [`html-aria-attribute-must-be-valid`](./html-aria-attribute-must-be-valid.md) - Disallow invalid or unknown `aria-*` attributes.
 - [`html-aria-label-is-well-formatted`](./html-aria-label-is-well-formatted.md) - `aria-label` must be well-formatted
@@ -33,12 +50,15 @@ This page contains documentation for all Herb Linter rules.
 - [`html-attribute-values-require-quotes`](./html-attribute-values-require-quotes.md) - Requires quotes around attribute values
 - [`html-avoid-both-disabled-and-aria-disabled`](./html-avoid-both-disabled-and-aria-disabled.md) - Avoid using both `disabled` and `aria-disabled` attributes
 - [`html-body-only-elements`](./html-body-only-elements.md) - Require content elements inside `<body>`.
+- [`html-details-has-summary`](./html-details-has-summary.md) - Require `<summary>` in `<details>` elements
 - [`html-boolean-attributes-no-value`](./html-boolean-attributes-no-value.md) - Prevents values on boolean attributes
 - [`html-head-only-elements`](./html-head-only-elements.md) - Require head-scoped elements inside `<head>`.
 - [`html-iframe-has-title`](./html-iframe-has-title.md) - `iframe` elements must have a `title` attribute
-- [`html-input-require-autocomplete`](./html-input-require-autocomplete.md) - Require `autocomplete` attributes on `<input>` tags.
 - [`html-img-require-alt`](./html-img-require-alt.md) - Requires `alt` attributes on `<img>` tags
+- [`html-input-require-autocomplete`](./html-input-require-autocomplete.md) - Require `autocomplete` attributes on `<input>` tags.
 - [`html-navigation-has-label`](./html-navigation-has-label.md) - Navigation landmarks must have accessible labels
+- [`html-no-abstract-roles`](./html-no-abstract-roles.md) - No abstract ARIA roles
+- [`html-no-aria-hidden-on-body`](./html-no-aria-hidden-on-body.md) - No `aria-hidden` on `<body>`
 - [`html-no-aria-hidden-on-focusable`](./html-no-aria-hidden-on-focusable.md) - Focusable elements should not have `aria-hidden="true"`
 - [`html-no-block-inside-inline`](./html-no-block-inside-inline.md) - Prevents block-level elements inside inline elements
 - [`html-no-duplicate-attributes`](./html-no-duplicate-attributes.md) - Prevents duplicate attributes on HTML elements
@@ -54,6 +74,7 @@ This page contains documentation for all Herb Linter rules.
 - [`html-tag-name-lowercase`](./html-tag-name-lowercase.md) - Enforces lowercase tag names in HTML
 - [`parser-no-errors`](./parser-no-errors.md) - Disallow parser errors in HTML+ERB documents
 - [`svg-tag-name-capitalization`](./svg-tag-name-capitalization.md) - Enforces proper camelCase capitalization for SVG elements
+- [`turbo-permanent-require-id`](./turbo-permanent-require-id.md) - Require `id` attribute on elements with `data-turbo-permanent`
 
 ## Contributing
 

package/docs/rules/actionview-no-silent-helper.md

@@ -0,0 +1,57 @@
+# Linter Rule: Disallow silent ERB tags for Action View helpers
+
+**Rule:** `actionview-no-silent-helper`
+
+## Description
+
+Action View helpers like `link_to`, `form_with`, and `content_tag` must use output ERB tags (`<%= %>`) so their rendered HTML is included in the page. Using silent ERB tags (`<% %>`) discards the helper's output entirely.
+
+## Rationale
+
+Action View helpers generate HTML that needs to be rendered into the template. When a helper is called with a silent ERB tag (`<% %>`), the return value is evaluated but silently discarded, meaning the generated HTML never appears in the output. This is almost always a mistake and can lead to confusing bugs where elements are missing from the page with no obvious cause. Using `<%= %>` ensures the helper's output is properly rendered.
+
+## Examples
+
+### ✅ Good
+
+```erb
+<%= link_to "Home", root_path %>
+```
+
+```erb
+<%= form_with model: @user do |f| %>
+  <%= f.text_field :name %>
+<% end %>
+```
+
+```erb
+<%= button_to "Delete", user_path(@user), method: :delete %>
+```
+
+```erb
+<%= content_tag :div, "Hello", class: "greeting" %>
+```
+
+### 🚫 Bad
+
+```erb
+<% link_to "Home", root_path %>
+```
+
+```erb
+<% form_with model: @user do |f| %>
+  <%= f.text_field :name %>
+<% end %>
+```
+
+```erb
+<% button_to "Delete", user_path(@user), method: :delete %>
+```
+
+```erb
+<% content_tag :div, "Hello", class: "greeting" %>
+```
+
+## References
+
+* [Rails Action View Helpers documentation](https://api.rubyonrails.org/classes/ActionView/Helpers.html)

package/docs/rules/erb-no-conditional-html-element.md

@@ -0,0 +1,90 @@
+# Linter Rule: Disallow conditional HTML elements
+
+**Rule:** `erb-no-conditional-html-element`
+
+## Description
+
+Disallow the pattern of opening an HTML tag in one conditional block and closing it in another conditional block with the same condition. This creates a "conditional element" where the element's existence depends on a runtime condition.
+
+## Rationale
+
+This pattern is difficult to read, maintain, and reason about. It can lead to confusion when trying to understand the document structure, and it makes the template harder to format, lint, and analyze. The opening and closing tags are visually separated, making it non-obvious that they form a matched pair.
+
+Instead, prefer using `capture` blocks with `content_tag` helpers, which make the conditional wrapping explicit and keeps the logic together.
+
+## Examples
+
+### ✅ Good
+
+Using a `capture` block to conditionally wrap content:
+
+```erb
+<% content = capture do %>
+  <div>Content</div>
+<% end %>
+
+<% if wrap_in_dialog? %>
+  <dialog><%= content %></dialog>
+<% else %>
+  <%= content %>
+<% end %>
+```
+
+```erb
+<% content = capture do %>
+  <div>Content</div>
+<% end %>
+
+<%= wrap_in_dialog? ? content_tag(:dialog, content) : content %>
+```
+
+Complete elements within conditional branches:
+
+```erb
+<% if some_condition %>
+  <div class="a">Content</div>
+<% else %>
+  <div class="b">Content</div>
+<% end %>
+```
+
+### 🚫 Bad
+
+Opening and closing tags in separate conditional blocks:
+
+```erb
+<% if wrap_in_dialog? %>
+  <dialog>
+<% end %>
+
+<div>Stuff</div>
+
+<% if wrap_in_dialog? %>
+  </dialog>
+<% end %>
+```
+
+```erb
+<% if @with_icon %>
+  <div class="icon">
+<% end %>
+  <span>Hello</span>
+<% if @with_icon %>
+  </div>
+<% end %>
+```
+
+```erb
+<% if @with_icon %>
+  <div class="icon">
+<% else %>
+  <div class="no-icon">
+<% end %>
+
+  <span>Hello</span>
+</div>
+```
+
+## References
+
+\-