npm - @html-eslint/eslint-plugin - Versions diffs - 0.41.0 → 0.43.0 - Mend

@html-eslint/eslint-plugin 0.41.0 → 0.43.0

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

Files changed (195) hide show

package/lib/configs/recommended.js +1 -0
package/lib/data/entities.json +2299 -0
package/lib/languages/html-language.js +3 -3
package/lib/languages/html-source-code.js +9 -11
package/lib/languages/html-traversal-step.js +4 -3
package/lib/rules/attrs-newline.js +3 -4
package/lib/rules/element-newline.js +4 -14
package/lib/rules/id-naming-convention.js +3 -6
package/lib/rules/indent/indent-level.js +1 -1
package/lib/rules/indent/indent.js +18 -23
package/lib/rules/index.js +8 -0
package/lib/rules/lowercase.js +11 -10
package/lib/rules/max-element-depth.js +4 -6
package/lib/rules/no-abstract-roles.js +3 -5
package/lib/rules/no-accesskey-attrs.js +3 -5
package/lib/rules/no-aria-hidden-body.js +2 -2
package/lib/rules/no-aria-hidden-on-focusable.js +118 -0
package/lib/rules/no-duplicate-attrs.js +3 -7
package/lib/rules/no-duplicate-class.js +3 -6
package/lib/rules/no-duplicate-id.js +6 -9
package/lib/rules/no-duplicate-in-head.js +188 -0
package/lib/rules/no-empty-headings.js +121 -0
package/lib/rules/no-extra-spacing-attrs.js +4 -14
package/lib/rules/no-extra-spacing-text.js +4 -10
package/lib/rules/no-heading-inside-button.js +2 -2
package/lib/rules/no-inline-styles.js +2 -2
package/lib/rules/no-invalid-entity.js +107 -0
package/lib/rules/no-invalid-role.js +2 -2
package/lib/rules/no-multiple-empty-lines.js +10 -11
package/lib/rules/no-multiple-h1.js +3 -3
package/lib/rules/no-nested-interactive.js +3 -3
package/lib/rules/no-non-scalable-viewport.js +2 -2
package/lib/rules/no-obsolete-tags.js +2 -2
package/lib/rules/no-positive-tabindex.js +3 -5
package/lib/rules/no-restricted-attr-values.js +4 -6
package/lib/rules/no-restricted-attrs.js +4 -6
package/lib/rules/no-script-style-type.js +3 -5
package/lib/rules/no-skip-heading-levels.js +3 -3
package/lib/rules/no-target-blank.js +2 -2
package/lib/rules/no-trailing-spaces.js +10 -9
package/lib/rules/prefer-https.js +3 -6
package/lib/rules/quotes.js +25 -10
package/lib/rules/require-attrs.js +3 -8
package/lib/rules/require-button-type.js +3 -4
package/lib/rules/require-closing-tags.js +3 -3
package/lib/rules/require-doctype.js +2 -2
package/lib/rules/require-explicit-size.js +2 -5
package/lib/rules/require-form-method.js +2 -2
package/lib/rules/require-frame-title.js +2 -2
package/lib/rules/require-img-alt.js +40 -17
package/lib/rules/require-input-label.js +3 -3
package/lib/rules/require-lang.js +2 -2
package/lib/rules/require-li-container.js +2 -2
package/lib/rules/require-meta-charset.js +3 -4
package/lib/rules/require-meta-description.js +3 -4
package/lib/rules/require-meta-viewport.js +3 -4
package/lib/rules/require-open-graph-protocol.js +3 -6
package/lib/rules/require-title.js +3 -5
package/lib/rules/sort-attrs.js +4 -5
package/lib/rules/use-baseline.js +3 -6
package/lib/rules/utils/baseline.js +7 -4
package/lib/rules/utils/node.js +11 -26
package/lib/rules/utils/settings.js +4 -7
package/lib/rules/utils/source-code.js +2 -2
package/lib/rules/utils/template-literal.js +43 -0
package/lib/rules/utils/visitors.js +6 -7
package/package.json +6 -6
package/types/configs/recommended.d.ts +1 -0
package/types/index.d.ts +2 -0
package/types/index.d.ts.map +1 -1
package/types/languages/html-language.d.ts +0 -5
package/types/languages/html-language.d.ts.map +1 -1
package/types/languages/html-source-code.d.ts +13 -14
package/types/languages/html-source-code.d.ts.map +1 -1
package/types/languages/html-traversal-step.d.ts +5 -5
package/types/languages/html-traversal-step.d.ts.map +1 -1
package/types/rules/attrs-newline.d.ts +3 -4
package/types/rules/attrs-newline.d.ts.map +1 -1
package/types/rules/element-newline.d.ts +5 -13
package/types/rules/element-newline.d.ts.map +1 -1
package/types/rules/id-naming-convention.d.ts +3 -6
package/types/rules/id-naming-convention.d.ts.map +1 -1
package/types/rules/indent/indent-level.d.ts +3 -3
package/types/rules/indent/indent-level.d.ts.map +1 -1
package/types/rules/indent/indent.d.ts +5 -18
package/types/rules/indent/indent.d.ts.map +1 -1
package/types/rules/lowercase.d.ts +2 -8
package/types/rules/lowercase.d.ts.map +1 -1
package/types/rules/max-element-depth.d.ts +3 -6
package/types/rules/max-element-depth.d.ts.map +1 -1
package/types/rules/no-abstract-roles.d.ts +2 -8
package/types/rules/no-abstract-roles.d.ts.map +1 -1
package/types/rules/no-accesskey-attrs.d.ts +2 -8
package/types/rules/no-accesskey-attrs.d.ts.map +1 -1
package/types/rules/no-aria-hidden-body.d.ts +2 -5
package/types/rules/no-aria-hidden-body.d.ts.map +1 -1
package/types/rules/no-aria-hidden-on-focusable.d.ts +4 -0
package/types/rules/no-aria-hidden-on-focusable.d.ts.map +1 -0
package/types/rules/no-duplicate-attrs.d.ts +2 -10
package/types/rules/no-duplicate-attrs.d.ts.map +1 -1
package/types/rules/no-duplicate-class.d.ts +3 -7
package/types/rules/no-duplicate-class.d.ts.map +1 -1
package/types/rules/no-duplicate-id.d.ts +2 -9
package/types/rules/no-duplicate-id.d.ts.map +1 -1
package/types/rules/no-duplicate-in-head.d.ts +4 -0
package/types/rules/no-duplicate-in-head.d.ts.map +1 -0
package/types/rules/no-empty-headings.d.ts +4 -0
package/types/rules/no-empty-headings.d.ts.map +1 -0
package/types/rules/no-extra-spacing-attrs.d.ts +3 -14
package/types/rules/no-extra-spacing-attrs.d.ts.map +1 -1
package/types/rules/no-extra-spacing-text.d.ts +3 -9
package/types/rules/no-extra-spacing-text.d.ts.map +1 -1
package/types/rules/no-heading-inside-button.d.ts +2 -5
package/types/rules/no-heading-inside-button.d.ts.map +1 -1
package/types/rules/no-inline-styles.d.ts +2 -5
package/types/rules/no-inline-styles.d.ts.map +1 -1
package/types/rules/no-invalid-entity.d.ts +11 -0
package/types/rules/no-invalid-entity.d.ts.map +1 -0
package/types/rules/no-invalid-role.d.ts +2 -5
package/types/rules/no-invalid-role.d.ts.map +1 -1
package/types/rules/no-multiple-empty-lines.d.ts +3 -7
package/types/rules/no-multiple-empty-lines.d.ts.map +1 -1
package/types/rules/no-multiple-h1.d.ts +2 -6
package/types/rules/no-multiple-h1.d.ts.map +1 -1
package/types/rules/no-nested-interactive.d.ts +2 -6
package/types/rules/no-nested-interactive.d.ts.map +1 -1
package/types/rules/no-non-scalable-viewport.d.ts +2 -5
package/types/rules/no-non-scalable-viewport.d.ts.map +1 -1
package/types/rules/no-obsolete-tags.d.ts +2 -5
package/types/rules/no-obsolete-tags.d.ts.map +1 -1
package/types/rules/no-positive-tabindex.d.ts +2 -8
package/types/rules/no-positive-tabindex.d.ts.map +1 -1
package/types/rules/no-restricted-attr-values.d.ts +3 -7
package/types/rules/no-restricted-attr-values.d.ts.map +1 -1
package/types/rules/no-restricted-attrs.d.ts +3 -7
package/types/rules/no-restricted-attrs.d.ts.map +1 -1
package/types/rules/no-script-style-type.d.ts +2 -8
package/types/rules/no-script-style-type.d.ts.map +1 -1
package/types/rules/no-skip-heading-levels.d.ts +2 -6
package/types/rules/no-skip-heading-levels.d.ts.map +1 -1
package/types/rules/no-target-blank.d.ts +2 -5
package/types/rules/no-target-blank.d.ts.map +1 -1
package/types/rules/no-trailing-spaces.d.ts +2 -7
package/types/rules/no-trailing-spaces.d.ts.map +1 -1
package/types/rules/prefer-https.d.ts +2 -9
package/types/rules/prefer-https.d.ts.map +1 -1
package/types/rules/quotes.d.ts +7 -9
package/types/rules/quotes.d.ts.map +1 -1
package/types/rules/require-attrs.d.ts +3 -8
package/types/rules/require-attrs.d.ts.map +1 -1
package/types/rules/require-button-type.d.ts +2 -7
package/types/rules/require-button-type.d.ts.map +1 -1
package/types/rules/require-closing-tags.d.ts +3 -4
package/types/rules/require-closing-tags.d.ts.map +1 -1
package/types/rules/require-doctype.d.ts +2 -5
package/types/rules/require-doctype.d.ts.map +1 -1
package/types/rules/require-explicit-size.d.ts +3 -5
package/types/rules/require-explicit-size.d.ts.map +1 -1
package/types/rules/require-form-method.d.ts +2 -5
package/types/rules/require-form-method.d.ts.map +1 -1
package/types/rules/require-frame-title.d.ts +2 -5
package/types/rules/require-frame-title.d.ts.map +1 -1
package/types/rules/require-img-alt.d.ts +3 -4
package/types/rules/require-img-alt.d.ts.map +1 -1
package/types/rules/require-input-label.d.ts +2 -6
package/types/rules/require-input-label.d.ts.map +1 -1
package/types/rules/require-lang.d.ts +2 -5
package/types/rules/require-lang.d.ts.map +1 -1
package/types/rules/require-li-container.d.ts +2 -5
package/types/rules/require-li-container.d.ts.map +1 -1
package/types/rules/require-meta-charset.d.ts +2 -7
package/types/rules/require-meta-charset.d.ts.map +1 -1
package/types/rules/require-meta-description.d.ts +2 -7
package/types/rules/require-meta-description.d.ts.map +1 -1
package/types/rules/require-meta-viewport.d.ts +2 -7
package/types/rules/require-meta-viewport.d.ts.map +1 -1
package/types/rules/require-open-graph-protocol.d.ts +3 -5
package/types/rules/require-open-graph-protocol.d.ts.map +1 -1
package/types/rules/require-title.d.ts +2 -8
package/types/rules/require-title.d.ts.map +1 -1
package/types/rules/sort-attrs.d.ts +3 -6
package/types/rules/sort-attrs.d.ts.map +1 -1
package/types/rules/use-baseline.d.ts +3 -7
package/types/rules/use-baseline.d.ts.map +1 -1
package/types/rules/utils/baseline.d.ts.map +1 -1
package/types/rules/utils/node.d.ts +25 -29
package/types/rules/utils/node.d.ts.map +1 -1
package/types/rules/utils/settings.d.ts +7 -9
package/types/rules/utils/settings.d.ts.map +1 -1
package/types/rules/utils/source-code.d.ts +4 -4
package/types/rules/utils/source-code.d.ts.map +1 -1
package/types/rules/utils/template-literal.d.ts +18 -0
package/types/rules/utils/template-literal.d.ts.map +1 -0
package/types/rules/utils/visitors.d.ts +4 -4
package/types/rules/utils/visitors.d.ts.map +1 -1

package/lib/rules/no-duplicate-in-head.js ADDED Viewed

@@ -0,0 +1,188 @@
+/**
+ * @import {Tag} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
+ */
+const { parseTemplateLiteral } = require("./utils/template-literal");
+const { RULE_CATEGORY } = require("../constants");
+const { findAttr } = require("./utils/node");
+const {
+  shouldCheckTaggedTemplateExpression,
+  shouldCheckTemplateLiteral,
+} = require("./utils/settings");
+const { getSourceCode } = require("./utils/source-code");
+const { getRuleUrl } = require("./utils/rule");
+const MESSAGE_IDS = {
+  DUPLICATE_TAG: "duplicateTag",
+};
+/**
+ * Returns a formatted string representing a tag's key detail.
+ * E.g., meta[charset=UTF-8], meta[name=viewport], link[rel=canonical]
+ * @param {Tag} node
+ * @returns {string | null}
+ */
+function getTrackingKey(node) {
+  const tagName = node.name.toLowerCase();
+  if (["title", "base"].includes(tagName)) {
+    return tagName;
+  }
+  if (tagName === "meta") {
+    const charsetAttr = findAttr(node, "charset");
+    if (charsetAttr) {
+      return "meta[charset]";
+    }
+    const nameAttr = findAttr(node, "name");
+    if (nameAttr && nameAttr.value && nameAttr.value.value === "viewport") {
+      return "meta[name=viewport]";
+    }
+  }
+  if (tagName === "link") {
+    const relAttr = findAttr(node, "rel");
+    const hrefAttr = findAttr(node, "href");
+    if (
+      relAttr &&
+      relAttr.value &&
+      relAttr.value.value === "canonical" &&
+      hrefAttr
+    ) {
+      return "link[rel=canonical]";
+    }
+  }
+  return null;
+}
+/**
+ * @type {RuleModule<[]>}
+ */
+module.exports = {
+  meta: {
+    type: "code",
+    docs: {
+      description: "Disallow duplicate tags in `<head>`",
+      category: RULE_CATEGORY.BEST_PRACTICE,
+      recommended: false,
+      url: getRuleUrl("no-duplicate-in-head"),
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      [MESSAGE_IDS.DUPLICATE_TAG]: "Duplicate <{{tag}}> tag in <head>.",
+    },
+  },
+  create(context) {
+    const htmlTagsMap = new Map();
+    let headCount = 0;
+    /**
+     * @param {Map<string, Tag[]>} map
+     * @param {{count: number}|null} headCountRef
+     */
+    function createTagVisitor(map, headCountRef = null) {
+      return {
+        /**
+         * @param {Tag} node
+         */
+        Tag(node) {
+          const tagName = node.name.toLowerCase();
+          if (tagName === "head") {
+            if (headCountRef !== null) {
+              headCountRef.count++;
+            } else {
+              headCount++;
+            }
+            return;
+          }
+          const currentHeadCount =
+            headCountRef !== null ? headCountRef.count : headCount;
+          if (currentHeadCount === 0) return;
+          const trackingKey = getTrackingKey(node);
+          if (typeof trackingKey !== "string") return;
+          if (!map.has(trackingKey)) {
+            map.set(trackingKey, []);
+          }
+          const nodes = map.get(trackingKey);
+          if (nodes) {
+            nodes.push(node);
+          }
+        },
+        /**
+         * @param {Tag} node
+         */
+        "Tag:exit"(node) {
+          const tagName = node.name.toLowerCase();
+          if (tagName === "head") {
+            if (headCountRef !== null) {
+              headCountRef.count--;
+            } else {
+              headCount--;
+            }
+          }
+        },
+      };
+    }
+    /**
+     * @param {Map<string, Tag[]>} map
+     */
+    function report(map) {
+      map.forEach((tags, tagKey) => {
+        if (Array.isArray(tags) && tags.length > 1) {
+          tags.slice(1).forEach((tag) => {
+            context.report({
+              node: tag,
+              data: { tag: tagKey },
+              messageId: MESSAGE_IDS.DUPLICATE_TAG,
+            });
+          });
+        }
+      });
+    }
+    const htmlVisitor = createTagVisitor(htmlTagsMap);
+    return {
+      Tag: htmlVisitor.Tag,
+      "Tag:exit": htmlVisitor["Tag:exit"],
+      "Document:exit"() {
+        report(htmlTagsMap);
+      },
+      TaggedTemplateExpression(node) {
+        const tagsMap = new Map();
+        const headCountRef = { count: 0 };
+        if (shouldCheckTaggedTemplateExpression(node, context)) {
+          const visitor = createTagVisitor(tagsMap, headCountRef);
+          parseTemplateLiteral(node.quasi, getSourceCode(context), visitor);
+          report(tagsMap);
+        }
+      },
+      TemplateLiteral(node) {
+        const tagsMap = new Map();
+        const headCountRef = { count: 0 };
+        if (shouldCheckTemplateLiteral(node, context)) {
+          const visitor = createTagVisitor(tagsMap, headCountRef);
+          parseTemplateLiteral(node, getSourceCode(context), visitor);
+          report(tagsMap);
+        }
+      },
+    };
+  },
+};

package/lib/rules/no-empty-headings.js ADDED Viewed

@@ -0,0 +1,121 @@
+/**
+ * @import {Tag, Text} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
+ */
+const { RULE_CATEGORY } = require("../constants");
+const { findAttr, isTag, isText } = require("./utils/node");
+const { createVisitors } = require("./utils/visitors");
+const { getRuleUrl } = require("./utils/rule");
+const MESSAGE_IDS = {
+  EMPTY_HEADING: "emptyHeading",
+  INACCESSIBLE_HEADING: "inaccessibleHeading",
+};
+const HEADING_NAMES = new Set(["h1", "h2", "h3", "h4", "h5", "h6"]);
+/**
+ * @param {Tag} node
+ */
+function isAriaHidden(node) {
+  const ariaHiddenAttr = findAttr(node, "aria-hidden");
+  return (
+    ariaHiddenAttr &&
+    ariaHiddenAttr.value &&
+    ariaHiddenAttr.value.value === "true"
+  );
+}
+/**
+ * @param {Tag} node
+ * @returns {boolean}
+ */
+function isRoleHeading(node) {
+  const roleAttr = findAttr(node, "role");
+  return !!roleAttr && !!roleAttr.value && roleAttr.value.value === "heading";
+}
+/**
+ * @param {Text | Tag} node
+ * @returns {string}
+ */
+function getAllText(node) {
+  if (!isTag(node) || !node.children.length) return "";
+  let text = "";
+  for (const child of node.children) {
+    if (isText(child)) {
+      text += child.value.trim();
+    } else if (isTag(child)) {
+      text += getAllText(child);
+    }
+  }
+  return text;
+}
+/**
+ * @param {Text | Tag} node
+ * @returns {string}
+ */
+function getAccessibleText(node) {
+  if (!isTag(node) || !node.children.length) return "";
+  let text = "";
+  for (const child of node.children) {
+    if (isText(child)) {
+      text += child.value.trim();
+    } else if (isTag(child) && !isAriaHidden(child)) {
+      text += getAccessibleText(child);
+    }
+  }
+  return text;
+}
+/**
+ * @type {RuleModule<[]>}
+ */
+module.exports = {
+  meta: {
+    type: "code",
+    docs: {
+      description: "Disallow empty or inaccessible headings.",
+      category: RULE_CATEGORY.ACCESSIBILITY,
+      recommended: false,
+      url: getRuleUrl("no-empty-headings"),
+    },
+    fixable: null,
+    schema: [],
+    messages: {
+      [MESSAGE_IDS.EMPTY_HEADING]: "Headings must not be empty.",
+      [MESSAGE_IDS.INACCESSIBLE_HEADING]:
+        "Heading text is inaccessible to assistive technology.",
+    },
+  },
+  create(context) {
+    return createVisitors(context, {
+      Tag(node) {
+        const tagName = node.name.toLowerCase();
+        const isHeadingTag = HEADING_NAMES.has(tagName);
+        const isRoleHeadingEl = isRoleHeading(node);
+        if (!isHeadingTag && !isRoleHeadingEl) return;
+        // Gather all text (including aria-hidden)
+        const allText = getAllText(node);
+        if (!allText) {
+          context.report({
+            node,
+            messageId: MESSAGE_IDS.EMPTY_HEADING,
+          });
+          return;
+        }
+        // Gather accessible text (not aria-hidden)
+        const accessibleText = getAccessibleText(node);
+        if (!accessibleText) {
+          context.report({
+            node,
+            messageId: MESSAGE_IDS.INACCESSIBLE_HEADING,
+          });
+        }
+      },
+    });
+  },
+};

package/lib/rules/no-extra-spacing-attrs.js CHANGED Viewed

@@ -1,22 +1,11 @@
 /**
- * @typedef { import("@html-eslint/types").Attribute } Attribute
- * @typedef { import("@html-eslint/types").OpenTagEnd } OpenTagEnd
- * @typedef { import("@html-eslint/types").OpenScriptTagEnd } OpenScriptTagEnd
- * @typedef { import("@html-eslint/types").OpenStyleTagEnd } OpenStyleTagEnd
- * @typedef { import("@html-eslint/types").OpenScriptTagStart } OpenScriptTagStart
- * @typedef { import("@html-eslint/types").OpenTagStart } OpenTagStart
- * @typedef { import("@html-eslint/types").OpenStyleTagStart } OpenStyleTagStart
- * @typedef { import("@html-eslint/types").Tag } Tag
- * @typedef { import("@html-eslint/types").StyleTag } StyleTag
- * @typedef { import("@html-eslint/types").ScriptTag } ScriptTag
- * @typedef { import("@html-eslint/types").AnyNode } AnyNode
- *
+ * @import {Attribute, OpenScriptTagStart, OpenTagStart, OpenStyleTagStart, Tag, StyleTag, ScriptTag, AnyNode} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  * @typedef {Object} Option
  * @property {boolean} [Option.disallowInAssignment]
  * @property {boolean} [Option.disallowMissing]
  * @property {boolean} [Option.disallowTabs]
  * @property {boolean} [Option.enforceBeforeSelfClose]
- * @typedef { import("../types").RuleModule<[Option]> } RuleModule
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -40,7 +29,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[Option]>}
  */
 module.exports = {
   meta: {
@@ -71,6 +60,7 @@ module.exports = {
             type: "boolean",
           },
         },
+        additionalProperties: false,
       },
     ],
     messages: {

package/lib/rules/no-extra-spacing-text.js CHANGED Viewed

@@ -1,14 +1,8 @@
 /**
- * @typedef { import("@html-eslint/types").CommentContent } CommentContent
- * @typedef { import("@html-eslint/types").Tag } Tag
- * @typedef { import("@html-eslint/types").Comment } Comment
- * @typedef { import("@html-eslint/types").Text } Text
- * @typedef { import("../types").Line } Line
- * @typedef { import("eslint").AST.Range } Range
- *
+ * @import {CommentContent, Tag, Comment, Text} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  * @typedef {Object} Option
  * @property {string[]} [Option.skip]
- * @typedef { import("../types").RuleModule<[Option]> } RuleModule
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -22,7 +16,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[Option]>}
  */
 module.exports = {
   meta: {
@@ -30,7 +24,7 @@ module.exports = {
     docs: {
       description: "Disallow unnecessary consecutive spaces",
-      category: RULE_CATEGORY.BEST_PRACTICE,
+      category: RULE_CATEGORY.STYLE,
       recommended: false,
       url: getRuleUrl("no-extra-spacing-text"),
     },

package/lib/rules/no-heading-inside-button.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -14,7 +14,7 @@ const MESSAGE_IDS = {
 const HEADING_NAMES = new Set(["h1", "h2", "h3", "h4", "h5", "h6"]);
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-inline-styles.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -12,7 +12,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-invalid-entity.js ADDED Viewed

@@ -0,0 +1,107 @@
+/**
+ * @import {RuleModule} from "../types";
+ * @import {Text} from "@html-eslint/types";
+ */
+// Define the type for entities.json
+/**
+ * @typedef {Object} EntityData
+ * @property {number[]} codepoints
+ * @property {string} characters
+ */
+/** @type {{ [key: string]: EntityData }} */
+const entities = require("../data/entities.json");
+const { RULE_CATEGORY } = require("../constants");
+const { createVisitors } = require("./utils/visitors");
+const { getRuleUrl } = require("./utils/rule");
+const MESSAGE_IDS = {
+  INVALID_ENTITY: "invalidEntity",
+};
+/**
+ * @type {RuleModule<[]>}
+ */
+module.exports = {
+  meta: {
+    type: "code",
+    docs: {
+      description: "Disallows the use of invalid HTML entities",
+      category: RULE_CATEGORY.BEST_PRACTICE,
+      recommended: false,
+      url: getRuleUrl("no-invalid-entity"),
+    },
+    fixable: null,
+    hasSuggestions: false,
+    schema: [],
+    messages: {
+      [MESSAGE_IDS.INVALID_ENTITY]: "Invalid HTML entity '{{entity}}' used.",
+    },
+  },
+  create(context) {
+    /**
+     * @param {Text} node
+     */
+    function check(node) {
+      const text = node.value;
+      // Regular expression to match named and numeric entities
+      const entityRegex = /&([a-zA-Z]+|#[0-9]+|#x[0-9a-fA-F]+|[#][^;]+);/g;
+      let match;
+      while ((match = entityRegex.exec(text)) !== null) {
+        const entity = match[0];
+        const entityName = match[1];
+        // Check named entities
+        if (!entityName.startsWith("#")) {
+          const fullEntity = `&${entityName};`;
+          if (!Object.prototype.hasOwnProperty.call(entities, fullEntity)) {
+            context.report({
+              node,
+              messageId: MESSAGE_IDS.INVALID_ENTITY,
+              data: { entity },
+            });
+          }
+        }
+        // Check numeric entities
+        else {
+          const isHex = entityName[1] === "x";
+          const numStr = isHex ? entityName.slice(2) : entityName.slice(1);
+          const num = isHex ? parseInt(numStr, 16) : parseInt(numStr, 10);
+          // If the number is not a valid integer, report an error
+          if (isNaN(num)) {
+            context.report({
+              node,
+              messageId: MESSAGE_IDS.INVALID_ENTITY,
+              data: { entity },
+            });
+            continue;
+          }
+          // Check if the numeric entity is valid (exists in entities.json or within valid Unicode range)
+          const entityKey = Object.keys(entities).find((key) => {
+            const codepoints = entities[key].codepoints;
+            return codepoints.length === 1 && codepoints[0] === num;
+          });
+          if (!entityKey && (num < 0 || num > 0x10ffff)) {
+            context.report({
+              node,
+              messageId: MESSAGE_IDS.INVALID_ENTITY,
+              data: { entity },
+            });
+          }
+        }
+      }
+    }
+    return createVisitors(context, {
+      Text: check,
+    });
+  },
+};

package/lib/rules/no-invalid-role.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
+ * @import {RuleModule} from "../types";
  */
 const { NODE_TYPES } = require("@html-eslint/parser");
@@ -227,7 +227,7 @@ const ELEMENTS_DISALLOWING_PRESENTATION_OR_NONE_ROLE = new Set([
 ]);
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-multiple-empty-lines.js CHANGED Viewed

@@ -1,15 +1,12 @@
 /**
- * @typedef { import("@html-eslint/types").AnyToken } AnyToken
- * @typedef { import("@html-eslint/types").Document } Document
- * @typedef { import("@html-eslint/types").CommentContent } CommentContent
- * @typedef { import("@html-eslint/types").Text } Text
+ * @import {CommentContent, Text} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  *
  * @typedef {Object} Option
  * @property {number} Option.max
- * @typedef { import("../types").RuleModule<[Option]> } RuleModule
  */
-const { parse } = require("@html-eslint/template-parser");
+const { parseTemplateLiteral } = require("./utils/template-literal");
 const { RULE_CATEGORY } = require("../constants");
 const {
   shouldCheckTaggedTemplateExpression,
@@ -28,7 +25,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[Option]>}
  */
 module.exports = {
   meta: {
@@ -120,10 +117,9 @@ module.exports = {
       },
       TaggedTemplateExpression(node) {
         if (shouldCheckTaggedTemplateExpression(node, context)) {
-          const { html, tokens } = parse(
+          const { html, tokens } = parseTemplateLiteral(
             node.quasi,
-            getSourceCode(context),
-            {}
+            getSourceCode(context)
           );
           const lines = codeToLines(html);
           check(
@@ -136,7 +132,10 @@ module.exports = {
       },
       TemplateLiteral(node) {
         if (shouldCheckTemplateLiteral(node, context)) {
-          const { html, tokens } = parse(node, getSourceCode(context), {});
+          const { html, tokens } = parseTemplateLiteral(
+            node,
+            getSourceCode(context)
+          );
           const lines = codeToLines(html);
           check(
             lines,

package/lib/rules/no-multiple-h1.js CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
- * @typedef { import("@html-eslint/types").Tag } Tag
+ * @import {Tag} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -11,7 +11,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-nested-interactive.js CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
- * @typedef { import("@html-eslint/types").Tag } Tag
+ * @import {Tag} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -56,7 +56,7 @@ function isInteractive(tag) {
 }
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-non-scalable-viewport.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -11,7 +11,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-obsolete-tags.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY, OBSOLETE_TAGS } = require("../constants");
@@ -13,7 +13,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {

package/lib/rules/no-positive-tabindex.js CHANGED Viewed

@@ -1,8 +1,6 @@
 /**
- * @typedef { import("../types").RuleModule<[]> } RuleModule
- * @typedef { import("@html-eslint/types").Tag } Tag
- * @typedef { import("@html-eslint/types").StyleTag } StyleTag
- * @typedef { import("@html-eslint/types").ScriptTag } ScriptTag
+ * @import {Tag, StyleTag,ScriptTag } from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
  */
 const { RULE_CATEGORY } = require("../constants");
@@ -15,7 +13,7 @@ const MESSAGE_IDS = {
 };
 /**
- * @type {RuleModule}
+ * @type {RuleModule<[]>}
  */
 module.exports = {
   meta: {