@herb-tools/linter 0.4.0

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export * from "./linter.js";
+export * from "./rules/index.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/dist/src/linter.js

@@ -0,0 +1,39 @@
+import { defaultRules } from "./default-rules.js";
+export class Linter {
+    rules;
+    offenses;
+    /**
+     * Creates a new Linter instance.
+     * @param rules - Array of rule classes (not instances) to use. If not provided, uses default rules.
+     */
+    constructor(rules) {
+        this.rules = rules !== undefined ? rules : this.getDefaultRules();
+        this.offenses = [];
+    }
+    /**
+     * Returns the default set of rule classes used by the linter.
+     * @returns Array of rule classes
+     */
+    getDefaultRules() {
+        return defaultRules;
+    }
+    getRuleCount() {
+        return this.rules.length;
+    }
+    lint(document) {
+        this.offenses = [];
+        for (const Rule of this.rules) {
+            const rule = new Rule();
+            const ruleOffenses = rule.check(document);
+            this.offenses.push(...ruleOffenses);
+        }
+        const errors = this.offenses.filter(offense => offense.severity === "error").length;
+        const warnings = this.offenses.filter(offense => offense.severity === "warning").length;
+        return {
+            offenses: this.offenses,
+            errors,
+            warnings
+        };
+    }
+}
+//# sourceMappingURL=linter.js.map

package/dist/src/linter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../src/linter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKjD,MAAM,OAAO,MAAM;IACT,KAAK,CAAa;IAClB,QAAQ,CAAe;IAE/B;;;OAGG;IACH,YAAY,KAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAA;QACjE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;IACpB,CAAC;IAED;;;OAGG;IACK,eAAe;QACrB,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;IAC1B,CAAC;IAED,IAAI,CAAC,QAAsB;QACzB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;QAElB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAA;YACvB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAEzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;QACrC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAA;QACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;QAEvF,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,QAAQ;SACT,CAAA;IACH,CAAC;CACF"}

package/dist/src/rules/erb-no-empty-tags.js

@@ -0,0 +1,23 @@
+import { BaseRuleVisitor } from "./rule-utils.js";
+class ERBNoEmptyTagsVisitor extends BaseRuleVisitor {
+    visitERBContentNode(node) {
+        this.visitChildNodes(node);
+        const { content, tag_closing } = node;
+        if (!content)
+            return;
+        if (tag_closing?.value === "")
+            return;
+        if (content.value.trim().length > 0)
+            return;
+        this.addOffense("ERB tag should not be empty. Remove empty ERB tags or add content.", node.location, "error");
+    }
+}
+export class ERBNoEmptyTagsRule {
+    name = "erb-no-empty-tags";
+    check(node) {
+        const visitor = new ERBNoEmptyTagsVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=erb-no-empty-tags.js.map

package/dist/src/rules/erb-no-empty-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erb-no-empty-tags.js","sourceRoot":"","sources":["../../../src/rules/erb-no-empty-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAKjD,MAAM,qBAAsB,SAAQ,eAAe;IACjD,mBAAmB,CAAC,IAAoB;QACtC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAE1B,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;QAErC,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,WAAW,EAAE,KAAK,KAAK,EAAE;YAAE,OAAM;QACrC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAM;QAE3C,IAAI,CAAC,UAAU,CACb,oEAAoE,EACpE,IAAI,CAAC,QAAQ,EACb,OAAO,CACR,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,kBAAkB;IAC7B,IAAI,GAAG,mBAAmB,CAAA;IAE1B,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEpD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/erb-no-output-control-flow.js

@@ -0,0 +1,47 @@
+import { BaseRuleVisitor } from "./rule-utils.js";
+class ERBNoOutputControlFlowRuleVisitor extends BaseRuleVisitor {
+    visitERBIfNode(node) {
+        this.checkOutputControlFlow(node);
+        this.visitChildNodes(node);
+    }
+    visitERBUnlessNode(node) {
+        this.checkOutputControlFlow(node);
+        this.visitChildNodes(node);
+    }
+    visitERBElseNode(node) {
+        this.checkOutputControlFlow(node);
+        this.visitChildNodes(node);
+    }
+    visitERBEndNode(node) {
+        this.checkOutputControlFlow(node);
+        this.visitChildNodes(node);
+    }
+    checkOutputControlFlow(controlBlock) {
+        const openTag = controlBlock.tag_opening;
+        if (!openTag) {
+            return;
+        }
+        if (openTag.value === "<%=") {
+            let controlBlockType = controlBlock.type;
+            if (controlBlock.type === "AST_ERB_IF_NODE")
+                controlBlockType = "if";
+            if (controlBlock.type === "AST_ERB_ELSE_NODE")
+                controlBlockType = "else";
+            if (controlBlock.type === "AST_ERB_END_NODE")
+                controlBlockType = "end";
+            if (controlBlock.type === "AST_ERB_UNLESS_NODE")
+                controlBlockType = "unless";
+            this.addOffense(`Control flow statements like \`${controlBlockType}\` should not be used with output tags. Use \`<% ${controlBlockType} ... %>\` instead.`, openTag.location, "error");
+        }
+        return;
+    }
+}
+export class ERBNoOutputControlFlowRule {
+    name = "erb-no-output-control-flow";
+    check(node) {
+        const visitor = new ERBNoOutputControlFlowRuleVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=erb-no-output-control-flow.js.map

package/dist/src/rules/erb-no-output-control-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erb-no-output-control-flow.js","sourceRoot":"","sources":["../../../src/rules/erb-no-output-control-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAKjD,MAAM,iCAAkC,SAAQ,eAAe;IAC7D,cAAc,CAAC,IAAe;QAC5B,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,kBAAkB,CAAC,IAAmB;QACpC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,gBAAgB,CAAC,IAAiB;QAChC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,eAAe,CAAC,IAAgB;QAC9B,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5B,CAAC;IAEO,sBAAsB,CAAC,YAAkE;QAC/F,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAC,CAAC;YAC3B,IAAI,gBAAgB,GAAW,YAAY,CAAC,IAAI,CAAA;YAEhD,IAAI,YAAY,CAAC,IAAI,KAAK,iBAAiB;gBAAE,gBAAgB,GAAG,IAAI,CAAA;YACpE,IAAI,YAAY,CAAC,IAAI,KAAK,mBAAmB;gBAAE,gBAAgB,GAAG,MAAM,CAAA;YACxE,IAAI,YAAY,CAAC,IAAI,KAAK,kBAAkB;gBAAE,gBAAgB,GAAG,KAAK,CAAA;YACtE,IAAI,YAAY,CAAC,IAAI,KAAK,qBAAqB;gBAAE,gBAAgB,GAAG,QAAQ,CAAA;YAE5E,IAAI,CAAC,UAAU,CACb,kCAAkC,gBAAgB,oDAAoD,gBAAgB,oBAAoB,EAC1I,OAAO,CAAC,QAAQ,EAChB,OAAO,CACR,CAAA;QACH,CAAC;QAED,OAAM;IACR,CAAC;CACF;AAED,MAAM,OAAO,0BAA0B;IACrC,IAAI,GAAG,4BAA4B,CAAA;IACnC,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/erb-require-whitespace-inside-tags.js

@@ -0,0 +1,43 @@
+import { isERBNode } from "@herb-tools/core";
+import { BaseRuleVisitor } from "./rule-utils.js";
+class RequireWhitespaceInsideTags extends BaseRuleVisitor {
+    visitChildNodes(node) {
+        this.checkWhitespace(node);
+        super.visitChildNodes(node);
+    }
+    checkWhitespace(node) {
+        if (!isERBNode(node)) {
+            return;
+        }
+        const openTag = node.tag_opening;
+        const closeTag = node.tag_closing;
+        const content = node.content;
+        if (!openTag || !closeTag || !content) {
+            return;
+        }
+        const value = content.value;
+        this.checkOpenTagWhitespace(openTag, value);
+        this.checkCloseTagWhitespace(closeTag, value);
+    }
+    checkOpenTagWhitespace(openTag, content) {
+        if (content.startsWith(" ") || content.startsWith("\n")) {
+            return;
+        }
+        this.addOffense(`Add whitespace after \`${openTag.value}\`.`, openTag.location, "error");
+    }
+    checkCloseTagWhitespace(closeTag, content) {
+        if (content.endsWith(" ") || content.endsWith("\n")) {
+            return;
+        }
+        this.addOffense(`Add whitespace before \`${closeTag.value}\`.`, closeTag.location, "error");
+    }
+}
+export class ERBRequireWhitespaceRule {
+    name = "erb-require-whitespace-inside-tags";
+    check(node) {
+        const visitor = new RequireWhitespaceInsideTags(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=erb-require-whitespace-inside-tags.js.map

package/dist/src/rules/erb-require-whitespace-inside-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erb-require-whitespace-inside-tags.js","sourceRoot":"","sources":["../../../src/rules/erb-require-whitespace-inside-tags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,2BAA4B,SAAQ,eAAe;IAEvD,eAAe,CAAC,IAAU;QACxB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;QAC1B,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAEO,eAAe,CAAC,IAAU;QAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAA;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAA;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAE5B,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAE3B,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3C,IAAI,CAAC,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC/C,CAAC;IAEO,sBAAsB,CAAC,OAAc,EAAE,OAAc;QAC3D,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAM;QACR,CAAC;QACD,IAAI,CAAC,UAAU,CACb,0BAA0B,OAAO,CAAC,KAAK,KAAK,EAC5C,OAAO,CAAC,QAAQ,EAChB,OAAO,CACR,CAAA;IACH,CAAC;IAEO,uBAAuB,CAAC,QAAe,EAAE,OAAc;QAC7D,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,OAAM;QACR,CAAC;QACD,IAAI,CAAC,UAAU,CACb,2BAA2B,QAAQ,CAAC,KAAK,KAAK,EAC9C,QAAQ,CAAC,QAAQ,EACjB,OAAO,CACR,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IACnC,IAAI,GAAG,oCAAoC,CAAA;IAC3C,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-anchor-require-href.js

@@ -0,0 +1,25 @@
+import { BaseRuleVisitor, getTagName, hasAttribute } from "./rule-utils.js";
+class AnchorRechireHrefVisitor extends BaseRuleVisitor {
+    visitHTMLOpenTagNode(node) {
+        this.checkATag(node);
+        super.visitHTMLOpenTagNode(node);
+    }
+    checkATag(node) {
+        const tagName = getTagName(node);
+        if (tagName !== "a") {
+            return;
+        }
+        if (!hasAttribute(node, "href")) {
+            this.addOffense("Add an `href` attribute to `<a>` to ensure it is focusable and accessible.", node.tag_name.location, "error");
+        }
+    }
+}
+export class HTMLAnchorRequireHrefRule {
+    name = "html-anchor-require-href";
+    check(node) {
+        const visitor = new AnchorRechireHrefVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-anchor-require-href.js.map

package/dist/src/rules/html-anchor-require-href.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-anchor-require-href.js","sourceRoot":"","sources":["../../../src/rules/html-anchor-require-href.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAK3E,MAAM,wBAAyB,SAAQ,eAAe;IACpD,oBAAoB,CAAC,IAAqB;QACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACpB,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAEO,SAAS,CAAC,IAAqB;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,CACb,4EAA4E,EAC5E,IAAI,CAAC,QAAS,CAAC,QAAQ,EACvB,OAAO,CACR,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,yBAAyB;IACpC,IAAI,GAAG,0BAA0B,CAAA;IAEjC,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEvD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAEnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+import { AttributeVisitorMixin, getAttributeName, getAttributes } from "./rule-utils.js";
+class AriaRoleHeadingRequiresLevel extends AttributeVisitorMixin {
+    // We want to check 2 attributes here:
+    // 1. role="heading"
+    // 2. aria-level (which must be present if role="heading")
+    checkAttribute(attributeName, attributeValue, attributeNode, parentNode) {
+        if (!(attributeName === "role" && attributeValue === "heading")) {
+            return;
+        }
+        const allAttributes = getAttributes(parentNode);
+        // If we have a role="heading", we must check for aria-level
+        const ariaLevelAttr = allAttributes.find(attr => getAttributeName(attr) === "aria-level");
+        if (!ariaLevelAttr) {
+            this.addOffense(`Element with \`role="heading"\` must have an \`aria-level\` attribute.`, attributeNode.location, "error");
+        }
+    }
+}
+export class HTMLAriaRoleHeadingRequiresLevelRule {
+    name = "html-aria-role-heading-requires-level";
+    check(node) {
+        const visitor = new AriaRoleHeadingRequiresLevel(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-aria-role-heading-requires-level.js.map

package/dist/src/rules/html-aria-role-heading-requires-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-aria-role-heading-requires-level.js","sourceRoot":"","sources":["../../../src/rules/html-aria-role-heading-requires-level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKxF,MAAM,4BAA6B,SAAQ,qBAAqB;IAE9D,sCAAsC;IACtC,oBAAoB;IACpB,0DAA0D;IAC1D,cAAc,CACZ,aAAqB,EACrB,cAA6B,EAC7B,aAAgC,EAChC,UAAkD;QAGlD,IAAI,CAAC,CAAC,aAAa,KAAK,MAAM,IAAI,cAAc,KAAK,SAAS,CAAC,EAAE,CAAC;YAChE,OAAM;QACR,CAAC;QAED,MAAM,aAAa,GAAG,aAAa,CAAC,UAAU,CAAC,CAAA;QAE/C,4DAA4D;QAC5D,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,CAAA;QACzF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,IAAI,CAAC,UAAU,CACb,wEAAwE,EACxE,aAAa,CAAC,QAAQ,EACtB,OAAO,CACR,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,oCAAoC;IAC/C,IAAI,GAAG,uCAAuC,CAAA;IAE9C,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-attribute-double-quotes.js

@@ -0,0 +1,21 @@
+import { AttributeVisitorMixin, getAttributeValueQuoteType, hasAttributeValue } from "./rule-utils.js";
+class AttributeDoubleQuotesVisitor extends AttributeVisitorMixin {
+    checkAttribute(attributeName, attributeValue, attributeNode) {
+        if (!hasAttributeValue(attributeNode))
+            return;
+        if (getAttributeValueQuoteType(attributeNode) !== "single")
+            return;
+        if (attributeValue?.includes('"'))
+            return; // Single quotes acceptable when value contains double quotes
+        this.addOffense(`Attribute \`${attributeName}\` uses single quotes. Prefer double quotes for HTML attribute values: \`${attributeName}="value"\`.`, attributeNode.value.location, "warning");
+    }
+}
+export class HTMLAttributeDoubleQuotesRule {
+    name = "html-attribute-double-quotes";
+    check(node) {
+        const visitor = new AttributeDoubleQuotesVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-attribute-double-quotes.js.map

package/dist/src/rules/html-attribute-double-quotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-attribute-double-quotes.js","sourceRoot":"","sources":["../../../src/rules/html-attribute-double-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAKtG,MAAM,4BAA6B,SAAQ,qBAAqB;IACpD,cAAc,CAAC,aAAqB,EAAE,cAA6B,EAAE,aAAgC;QAC7G,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC;YAAE,OAAM;QAC7C,IAAI,0BAA0B,CAAC,aAAa,CAAC,KAAK,QAAQ;YAAE,OAAM;QAClE,IAAI,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAM,CAAC,6DAA6D;QAEvG,IAAI,CAAC,UAAU,CACb,eAAe,aAAa,4EAA4E,aAAa,aAAa,EAClI,aAAa,CAAC,KAAM,CAAC,QAAQ,EAC7B,SAAS,CACV,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,6BAA6B;IACxC,IAAI,GAAG,8BAA8B,CAAA;IAErC,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-attribute-values-require-quotes.js

@@ -0,0 +1,22 @@
+import { AttributeVisitorMixin } from "./rule-utils.js";
+class AttributeValuesRequireQuotesVisitor extends AttributeVisitorMixin {
+    checkAttribute(attributeName, _attributeValue, attributeNode) {
+        if (attributeNode.value?.type !== "AST_HTML_ATTRIBUTE_VALUE_NODE")
+            return;
+        const valueNode = attributeNode.value;
+        if (valueNode.quoted)
+            return;
+        this.addOffense(
+        // TODO: print actual attribute value in message
+        `Attribute value should be quoted: \`${attributeName}="value"\`. Always wrap attribute values in quotes.`, valueNode.location, "error");
+    }
+}
+export class HTMLAttributeValuesRequireQuotesRule {
+    name = "html-attribute-values-require-quotes";
+    check(node) {
+        const visitor = new AttributeValuesRequireQuotesVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-attribute-values-require-quotes.js.map

package/dist/src/rules/html-attribute-values-require-quotes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-attribute-values-require-quotes.js","sourceRoot":"","sources":["../../../src/rules/html-attribute-values-require-quotes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAKvD,MAAM,mCAAoC,SAAQ,qBAAqB;IAC3D,cAAc,CAAC,aAAqB,EAAE,eAA8B,EAAE,aAAgC;QAC9G,IAAI,aAAa,CAAC,KAAK,EAAE,IAAI,KAAK,+BAA+B;YAAE,OAAM;QAEzE,MAAM,SAAS,GAAG,aAAa,CAAC,KAA+B,CAAA;QAC/D,IAAI,SAAS,CAAC,MAAM;YAAE,OAAM;QAE5B,IAAI,CAAC,UAAU;QACb,gDAAgD;QAChD,uCAAuC,aAAa,qDAAqD,EACzG,SAAS,CAAC,QAAQ,EAClB,OAAO,CACR,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,oCAAoC;IAC/C,IAAI,GAAG,sCAAsC,CAAA;IAE7C,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-boolean-attributes-no-value.js

@@ -0,0 +1,19 @@
+import { AttributeVisitorMixin, isBooleanAttribute, hasAttributeValue } from "./rule-utils.js";
+class BooleanAttributesNoValueVisitor extends AttributeVisitorMixin {
+    checkAttribute(attributeName, _attributeValue, attributeNode) {
+        if (!isBooleanAttribute(attributeName))
+            return;
+        if (!hasAttributeValue(attributeNode))
+            return;
+        this.addOffense(`Boolean attribute \`${attributeName}\` should not have a value. Use \`${attributeName}\` instead of \`${attributeName}="${attributeName}"\`.`, attributeNode.value.location, "error");
+    }
+}
+export class HTMLBooleanAttributesNoValueRule {
+    name = "html-boolean-attributes-no-value";
+    check(node) {
+        const visitor = new BooleanAttributesNoValueVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-boolean-attributes-no-value.js.map

package/dist/src/rules/html-boolean-attributes-no-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-boolean-attributes-no-value.js","sourceRoot":"","sources":["../../../src/rules/html-boolean-attributes-no-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAK9F,MAAM,+BAAgC,SAAQ,qBAAqB;IACvD,cAAc,CAAC,aAAqB,EAAE,eAA8B,EAAE,aAAgC;QAC9G,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC;YAAE,OAAM;QAC9C,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC;YAAE,OAAM;QAE7C,IAAI,CAAC,UAAU,CACb,uBAAuB,aAAa,qCAAqC,aAAa,mBAAmB,aAAa,KAAK,aAAa,MAAM,EAC9I,aAAa,CAAC,KAAM,CAAC,QAAQ,EAC7B,OAAO,CACR,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,gCAAgC;IAC3C,IAAI,GAAG,kCAAkC,CAAA;IAEzC,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-img-require-alt.js

@@ -0,0 +1,29 @@
+import { BaseRuleVisitor, getTagName, hasAttribute } from "./rule-utils.js";
+class ImgRequireAltVisitor extends BaseRuleVisitor {
+    visitHTMLOpenTagNode(node) {
+        this.checkImgTag(node);
+        super.visitHTMLOpenTagNode(node);
+    }
+    visitHTMLSelfCloseTagNode(node) {
+        this.checkImgTag(node);
+        super.visitHTMLSelfCloseTagNode(node);
+    }
+    checkImgTag(node) {
+        const tagName = getTagName(node);
+        if (tagName !== "img") {
+            return;
+        }
+        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");
+        }
+    }
+}
+export class HTMLImgRequireAltRule {
+    name = "html-img-require-alt";
+    check(node) {
+        const visitor = new ImgRequireAltVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-img-require-alt.js.map

package/dist/src/rules/html-img-require-alt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-img-require-alt.js","sourceRoot":"","sources":["../../../src/rules/html-img-require-alt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAK3E,MAAM,oBAAqB,SAAQ,eAAe;IAChD,oBAAoB,CAAC,IAAqB;QACxC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACtB,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,yBAAyB,CAAC,IAA0B;QAClD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACtB,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAEO,WAAW,CAAC,IAA4C;QAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAEhC,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACtB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,UAAU,CACb,oIAAoI,EACpI,IAAI,CAAC,QAAS,CAAC,QAAQ,EACvB,OAAO,CACR,CAAA;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAChC,IAAI,GAAG,sBAAsB,CAAA;IAE7B,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-no-block-inside-inline.js

@@ -0,0 +1,59 @@
+import { BaseRuleVisitor, isInlineElement, isBlockElement } from "./rule-utils.js";
+class BlockInsideInlineVisitor extends BaseRuleVisitor {
+    inlineStack = [];
+    isValidHTMLOpenTag(node) {
+        return !!(node.open_tag && node.open_tag.type === "AST_HTML_OPEN_TAG_NODE");
+    }
+    getElementType(tagName) {
+        const isInline = isInlineElement(tagName);
+        const isBlock = isBlockElement(tagName);
+        const isUnknown = !isInline && !isBlock;
+        return { isInline, isBlock, isUnknown };
+    }
+    addViolationMessage(tagName, isBlock, openTag) {
+        const parentInline = this.inlineStack[this.inlineStack.length - 1];
+        const elementType = isBlock ? "Block-level" : "Unknown";
+        this.addOffense(`${elementType} element \`<${tagName}>\` cannot be placed inside inline element \`<${parentInline}>\`.`, openTag.tag_name.location, "error");
+    }
+    visitInlineElement(node, tagName) {
+        this.inlineStack.push(tagName);
+        super.visitHTMLElementNode(node);
+        this.inlineStack.pop();
+    }
+    visitBlockElement(node) {
+        const savedStack = [...this.inlineStack];
+        this.inlineStack = [];
+        super.visitHTMLElementNode(node);
+        this.inlineStack = savedStack;
+    }
+    visitHTMLElementNode(node) {
+        if (!this.isValidHTMLOpenTag(node)) {
+            super.visitHTMLElementNode(node);
+            return;
+        }
+        const openTag = node.open_tag;
+        const tagName = openTag.tag_name?.value.toLowerCase();
+        if (!tagName) {
+            super.visitHTMLElementNode(node);
+            return;
+        }
+        const { isInline, isBlock, isUnknown } = this.getElementType(tagName);
+        if ((isBlock || isUnknown) && this.inlineStack.length > 0) {
+            this.addViolationMessage(tagName, isBlock, openTag);
+        }
+        if (isInline) {
+            this.visitInlineElement(node, tagName);
+            return;
+        }
+        this.visitBlockElement(node);
+    }
+}
+export class HTMLNoBlockInsideInlineRule {
+    name = "html-no-block-inside-inline";
+    check(node) {
+        const visitor = new BlockInsideInlineVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-no-block-inside-inline.js.map

package/dist/src/rules/html-no-block-inside-inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-no-block-inside-inline.js","sourceRoot":"","sources":["../../../src/rules/html-no-block-inside-inline.ts"],"names":[],"mappings":"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"}

package/dist/src/rules/html-no-duplicate-attributes.js

@@ -0,0 +1,43 @@
+import { BaseRuleVisitor, forEachAttribute } from "./rule-utils.js";
+class NoDuplicateAttributesVisitor extends BaseRuleVisitor {
+    visitHTMLOpenTagNode(node) {
+        this.checkDuplicateAttributes(node);
+        super.visitHTMLOpenTagNode(node);
+    }
+    visitHTMLSelfCloseTagNode(node) {
+        this.checkDuplicateAttributes(node);
+        super.visitHTMLSelfCloseTagNode(node);
+    }
+    checkDuplicateAttributes(node) {
+        const attributeNames = new Map();
+        forEachAttribute(node, (attributeNode) => {
+            if (attributeNode.name?.type !== "AST_HTML_ATTRIBUTE_NAME_NODE")
+                return;
+            const nameNode = attributeNode.name;
+            if (!nameNode.name)
+                return;
+            const attributeName = nameNode.name.value.toLowerCase(); // HTML attributes are case-insensitive
+            if (!attributeNames.has(attributeName)) {
+                attributeNames.set(attributeName, []);
+            }
+            attributeNames.get(attributeName).push(nameNode);
+        });
+        for (const [attributeName, nameNodes] of attributeNames) {
+            if (nameNodes.length > 1) {
+                for (let i = 1; i < nameNodes.length; i++) {
+                    const nameNode = nameNodes[i];
+                    this.addOffense(`Duplicate attribute \`${attributeName}\` found on tag. Remove the duplicate occurrence.`, nameNode.location, "error");
+                }
+            }
+        }
+    }
+}
+export class HTMLNoDuplicateAttributesRule {
+    name = "html-no-duplicate-attributes";
+    check(node) {
+        const visitor = new NoDuplicateAttributesVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-no-duplicate-attributes.js.map

package/dist/src/rules/html-no-duplicate-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-no-duplicate-attributes.js","sourceRoot":"","sources":["../../../src/rules/html-no-duplicate-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAKnE,MAAM,4BAA6B,SAAQ,eAAe;IACxD,oBAAoB,CAAC,IAAqB;QACxC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAA;QACnC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,yBAAyB,CAAC,IAA0B;QAClD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAA;QACnC,KAAK,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAA;IACvC,CAAC;IAEO,wBAAwB,CAAC,IAA4C;QAC3E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmC,CAAA;QAEjE,gBAAgB,CAAC,IAAI,EAAE,CAAC,aAAa,EAAE,EAAE;YACvC,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,KAAK,8BAA8B;gBAAE,OAAM;YAEvE,MAAM,QAAQ,GAAG,aAAa,CAAC,IAA6B,CAAA;YAC5D,IAAI,CAAC,QAAQ,CAAC,IAAI;gBAAE,OAAM;YAE1B,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAA,CAAC,uCAAuC;YAE/F,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvC,cAAc,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;YACvC,CAAC;YAED,cAAc,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnD,CAAC,CAAC,CAAA;QAEF,KAAK,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,cAAc,EAAE,CAAC;YACxD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;oBAE7B,IAAI,CAAC,UAAU,CACb,yBAAyB,aAAa,mDAAmD,EACzF,QAAQ,CAAC,QAAQ,EACjB,OAAO,CACR,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,6BAA6B;IACxC,IAAI,GAAG,8BAA8B,CAAA;IAErC,KAAK,CAAC,IAAU;QACd,MAAM,OAAO,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACnB,OAAO,OAAO,CAAC,QAAQ,CAAA;IACzB,CAAC;CACF"}

package/dist/src/rules/html-no-empty-headings.js

@@ -0,0 +1,148 @@
+import { BaseRuleVisitor, getTagName, getAttributes, findAttributeByName, getAttributeValue, HEADING_TAGS } from "./rule-utils.js";
+class NoEmptyHeadingsVisitor extends BaseRuleVisitor {
+    visitHTMLElementNode(node) {
+        this.checkHeadingElement(node);
+        super.visitHTMLElementNode(node);
+    }
+    visitHTMLSelfCloseTagNode(node) {
+        this.checkSelfClosingHeading(node);
+        super.visitHTMLSelfCloseTagNode(node);
+    }
+    checkHeadingElement(node) {
+        if (!node.open_tag || node.open_tag.type !== "AST_HTML_OPEN_TAG_NODE") {
+            return;
+        }
+        const openTag = node.open_tag;
+        const tagName = getTagName(openTag);
+        if (!tagName) {
+            return;
+        }
+        const isStandardHeading = HEADING_TAGS.has(tagName);
+        const isAriaHeading = this.hasHeadingRole(openTag);
+        if (!isStandardHeading && !isAriaHeading) {
+            return;
+        }
+        if (this.isEmptyHeading(node)) {
+            const elementDescription = isStandardHeading
+                ? `\`<${tagName}>\``
+                : `\`<${tagName} role="heading">\``;
+            this.addOffense(`Heading element ${elementDescription} must not be empty. Provide accessible text content for screen readers and SEO.`, node.location, "error");
+        }
+    }
+    checkSelfClosingHeading(node) {
+        const tagName = getTagName(node);
+        if (!tagName) {
+            return;
+        }
+        // Check if it's a standard heading tag (h1-h6) or has role="heading"
+        const isStandardHeading = HEADING_TAGS.has(tagName);
+        const isAriaHeading = this.hasHeadingRole(node);
+        if (!isStandardHeading && !isAriaHeading) {
+            return;
+        }
+        // Self-closing headings are always empty
+        const elementDescription = isStandardHeading
+            ? `\`<${tagName}>\``
+            : `\`<${tagName} role="heading">\``;
+        this.addOffense(`Heading element ${elementDescription} must not be empty. Provide accessible text content for screen readers and SEO.`, node.tag_name.location, "error");
+    }
+    isEmptyHeading(node) {
+        if (!node.body || node.body.length === 0) {
+            return true;
+        }
+        // Check if all content is just whitespace or inaccessible
+        let hasAccessibleContent = false;
+        for (const child of node.body) {
+            if (child.type === "AST_LITERAL_NODE") {
+                const literalNode = child;
+                if (literalNode.content.trim().length > 0) {
+                    hasAccessibleContent = true;
+                    break;
+                }
+            }
+            else if (child.type === "AST_HTML_TEXT_NODE") {
+                const textNode = child;
+                if (textNode.content.trim().length > 0) {
+                    hasAccessibleContent = true;
+                    break;
+                }
+            }
+            else if (child.type === "AST_HTML_ELEMENT_NODE") {
+                const elementNode = child;
+                // Check if this element is accessible (not aria-hidden="true")
+                if (this.isElementAccessible(elementNode)) {
+                    hasAccessibleContent = true;
+                    break;
+                }
+            }
+            else {
+                // If there's any non-literal/non-text/non-element content (like ERB), consider it accessible
+                hasAccessibleContent = true;
+                break;
+            }
+        }
+        return !hasAccessibleContent;
+    }
+    hasHeadingRole(node) {
+        const attributes = getAttributes(node);
+        const roleAttribute = findAttributeByName(attributes, "role");
+        if (!roleAttribute) {
+            return false;
+        }
+        const roleValue = getAttributeValue(roleAttribute);
+        return roleValue === "heading";
+    }
+    isElementAccessible(node) {
+        // Check if the element has aria-hidden="true"
+        if (!node.open_tag || node.open_tag.type !== "AST_HTML_OPEN_TAG_NODE") {
+            return true;
+        }
+        const openTag = node.open_tag;
+        const attributes = getAttributes(openTag);
+        const ariaHiddenAttribute = findAttributeByName(attributes, "aria-hidden");
+        if (ariaHiddenAttribute) {
+            const ariaHiddenValue = getAttributeValue(ariaHiddenAttribute);
+            if (ariaHiddenValue === "true") {
+                return false;
+            }
+        }
+        // Recursively check if the element has any accessible content
+        if (!node.body || node.body.length === 0) {
+            return false;
+        }
+        for (const child of node.body) {
+            if (child.type === "AST_LITERAL_NODE") {
+                const literalNode = child;
+                if (literalNode.content.trim().length > 0) {
+                    return true;
+                }
+            }
+            else if (child.type === "AST_HTML_TEXT_NODE") {
+                const textNode = child;
+                if (textNode.content.trim().length > 0) {
+                    return true;
+                }
+            }
+            else if (child.type === "AST_HTML_ELEMENT_NODE") {
+                const elementNode = child;
+                if (this.isElementAccessible(elementNode)) {
+                    return true;
+                }
+            }
+            else {
+                // If there's any non-literal/non-text/non-element content (like ERB), consider it accessible
+                return true;
+            }
+        }
+        return false;
+    }
+}
+export class HTMLNoEmptyHeadingsRule {
+    name = "html-no-empty-headings";
+    check(node) {
+        const visitor = new NoEmptyHeadingsVisitor(this.name);
+        visitor.visit(node);
+        return visitor.offenses;
+    }
+}
+//# sourceMappingURL=html-no-empty-headings.js.map

package/dist/src/rules/html-no-empty-headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-no-empty-headings.js","sourceRoot":"","sources":["../../../src/rules/html-no-empty-headings.ts"],"names":[],"mappings":"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"}