@html-eslint/eslint-plugin 0.46.1 → 0.47.0

package/lib/rules/index.js

@@ -52,6 +52,7 @@ const noEmptyHeadings = require("./no-empty-headings");
 const noInvalidEntity = require("./no-invalid-entity");
 const noDuplicateInHead = require("./no-duplicate-in-head");
 const noIneffectiveAttrs = require("./no-ineffective-attrs");
+const noRestrictedTags = require("./no-restricted-tags");
 // import new rule here ↑
 // DO NOT REMOVE THIS COMMENT
 
@@ -110,6 +111,7 @@ const rules = {
   "no-invalid-entity": noInvalidEntity,
   "no-duplicate-in-head": noDuplicateInHead,
   "no-ineffective-attrs": noIneffectiveAttrs,
+  "no-restricted-tags": noRestrictedTags,
   // export new rule here ↑
   // DO NOT REMOVE THIS COMMENT
 };

package/lib/rules/no-restricted-tags.js

@@ -0,0 +1,138 @@
+/**
+ * @import {StyleTag, Tag, ScriptTag} from "@html-eslint/types";
+ * @import {RuleModule} from "../types";
+ * @typedef {{tagPatterns: string[], message?: string}[]} Options
+ *
+ */
+
+const { NODE_TYPES } = require("@html-eslint/parser");
+const { RULE_CATEGORY } = require("../constants");
+const { createVisitors } = require("./utils/visitors");
+const { getRuleUrl } = require("./utils/rule");
+
+const MESSAGE_IDS = {
+  RESTRICTED: "restricted",
+};
+
+/**
+ * @type {RuleModule<Options>}
+ */
+module.exports = {
+  meta: {
+    type: "code",
+
+    docs: {
+      description: "Disallow specified tags",
+      category: RULE_CATEGORY.BEST_PRACTICE,
+      recommended: false,
+      url: getRuleUrl("no-restricted-tags"),
+    },
+
+    fixable: null,
+    schema: {
+      type: "array",
+
+      items: {
+        type: "object",
+        required: ["tagPatterns"],
+        properties: {
+          tagPatterns: {
+            type: "array",
+            items: {
+              type: "string",
+            },
+          },
+          message: {
+            type: "string",
+          },
+        },
+        additionalProperties: false,
+      },
+    },
+    messages: {
+      [MESSAGE_IDS.RESTRICTED]: "'{{tag}}' tag is restricted from being used.",
+    },
+  },
+
+  create(context) {
+    /**
+     * @type {Options}
+     */
+    const options = context.options;
+    const checkers = options.map((option) => new PatternChecker(option));
+
+    /**
+     * @param {Tag | StyleTag | ScriptTag} node
+     */
+    function check(node) {
+      const tagName =
+        node.type === NODE_TYPES.Tag
+          ? node.name
+          : node.type === NODE_TYPES.ScriptTag
+            ? "script"
+            : "style";
+
+      const matched = checkers.find((checker) => checker.test(tagName));
+
+      if (!matched) {
+        return;
+      }
+
+      /**
+       * @type {{node: Tag | StyleTag | ScriptTag, message: string, messageId?: string}}
+       */
+      const result = {
+        node: node,
+        message: "",
+      };
+
+      const customMessage = matched.getMessage();
+
+      if (customMessage) {
+        result.message = customMessage;
+      } else {
+        result.messageId = MESSAGE_IDS.RESTRICTED;
+      }
+
+      context.report({
+        ...result,
+        data: { tag: tagName },
+      });
+    }
+
+    return createVisitors(context, {
+      Tag: check,
+      StyleTag: check,
+      ScriptTag: check,
+    });
+  },
+};
+
+class PatternChecker {
+  /**
+   * @param {Options[number]} option
+   */
+  constructor(option) {
+    this.option = option;
+    this.tagRegExps = option.tagPatterns.map(
+      (pattern) => new RegExp(pattern, "u")
+    );
+    this.message = option.message;
+  }
+
+  /**
+   * @param {string} tagName
+   * @returns {boolean}
+   */
+  test(tagName) {
+    const result = this.tagRegExps.some((exp) => exp.test(tagName));
+    return result;
+  }
+
+  /**
+   * @returns {string}
+   */
+  getMessage() {
+    return this.message || "";
+  }
+}

package/lib/rules/utils/baseline.js

@@ -72,6 +72,7 @@ const elements = new Map([
   ["br", "10:2015"],
   ["button", "10:2015"],
   ["button.command", "0:"],
+  ["button.command.request-close", "0:"],
   ["button.commandfor", "0:"],
   ["button.disabled", "10:2015"],
   ["button.form", "10:2017"],
@@ -149,7 +150,7 @@ const elements = new Map([
   ["form.method", "10:2015"],
   ["form.name", "10:2015"],
   ["form.novalidate", "10:2017"],
-  ["form.rel", "5:2023"],
+  ["form.rel", "10:2023"],
   ["form.target", "10:2015"],
   ["h1", "10:2015"],
   ["h1.no_ua_styles_in_article_aside_nav_section", "0:"],
@@ -329,7 +330,7 @@ const elements = new Map([
   ["link.rel", "10:2015"],
   ["link.rel.alternate_stylesheet", "0:"],
   ["link.rel.compression-dictionary", "0:"],
-  ["link.rel.dns-prefetch", "0:"],
+  ["link.rel.dns-prefetch", "5:2025"],
   ["link.rel.expect", "0:"],
   ["link.rel.manifest", "0:"],
   ["link.rel.modulepreload", "5:2023"],
@@ -502,8 +503,8 @@ const elements = new Map([
   ["td.valign", "0:"],
   ["td.width", "0:"],
   ["template", "10:2015"],
-  ["template.shadowrootclonable", "0:"],
-  ["template.shadowrootdelegatesfocus", "0:"],
+  ["template.shadowrootclonable", "5:2024"],
+  ["template.shadowrootdelegatesfocus", "5:2024"],
   ["template.shadowrootmode", "5:2024"],
   ["template.shadowrootserializable", "0:"],
   ["textarea", "10:2015"],
@@ -577,6 +578,7 @@ const elements = new Map([
   ["video.height", "10:2015"],
   ["video.loop", "10:2015"],
   ["video.muted", "10:2015"],
+  ["video.playsinline", "0:"],
   ["video.poster", "10:2015"],
   ["video.preload", "10:2015"],
   ["video.src", "10:2015"],
@@ -608,7 +610,7 @@ const globalAttributes = new Map([
   ["tabindex", "10:2015"],
   ["title", "10:2015"],
   ["title.multi-line_titles", "10:2018"],
-  ["translate", "5:2023"],
+  ["translate", "10:2023"],
   ["virtualkeyboardpolicy", "0:"],
   ["writingsuggestions", "0:"],
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@html-eslint/eslint-plugin",
-  "version": "0.46.1",
+  "version": "0.47.0",
   "type": "commonjs",
   "description": "ESLint plugin for HTML",
   "author": "yeonjuan",
@@ -40,16 +40,16 @@
   ],
   "dependencies": {
     "@eslint/plugin-kit": "^0.3.1",
-    "@html-eslint/parser": "^0.46.0",
-    "@html-eslint/template-parser": "^0.46.0",
-    "@html-eslint/template-syntax-parser": "^0.46.0"
+    "@html-eslint/parser": "^0.47.0",
+    "@html-eslint/template-parser": "^0.47.0",
+    "@html-eslint/template-syntax-parser": "^0.47.0",
+    "@html-eslint/types": "^0.47.0"
   },
   "peerDependencies": {
     "eslint": "^8.0.0 || ^9.0.0"
   },
   "devDependencies": {
     "@eslint/core": "^0.14.0",
-    "@html-eslint/types": "^0.46.0",
     "@types/estree": "^0.0.47",
     "es-html-parser": "0.3.0",
     "eslint": "^9.27.0",
@@ -59,5 +59,5 @@
   "engines": {
     "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
   },
-  "gitHead": "30d2b2e4c8b4b69fade92dbe37cb2a178500207c"
+  "gitHead": "caaddba72ff95d1f3a0aa3e4896d797b94f0c079"
 }

package/types/rules/no-restricted-tags.d.ts

@@ -0,0 +1,11 @@
+declare namespace _exports {
+    export { Options };
+}
+declare const _exports: RuleModule<Options>;
+export = _exports;
+type Options = {
+    tagPatterns: string[];
+    message?: string;
+}[];
+import type { RuleModule } from "../types";
+//# sourceMappingURL=no-restricted-tags.d.ts.map

package/types/rules/no-restricted-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-restricted-tags.d.ts","sourceRoot":"","sources":["../../lib/rules/no-restricted-tags.js"],"names":[],"mappings":";;;wBAiBU,WAAW,OAAO,CAAC;;eAdhB;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,EAAE;gCAD3B,UAAU"}

package/types/rules/utils/baseline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../lib/rules/utils/baseline.js"],"names":[],"mappings":"AAOA,2CAikBG;AACH,mDA4BG;AArmBH;;GAEG;AACH,4BAAsB,EAAE,CAAC;AACzB,2BAAqB,CAAC,CAAC;AACvB,6BAAuB,CAAC,CAAC"}
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../../lib/rules/utils/baseline.js"],"names":[],"mappings":"AAOA,2CAmkBG;AACH,mDA4BG;AAvmBH;;GAEG;AACH,4BAAsB,EAAE,CAAC;AACzB,2BAAqB,CAAC,CAAC;AACvB,6BAAuB,CAAC,CAAC"}