html-validate 8.11.1 → 8.12.0

package/dist/cjs/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.41.0"
+      "packageVersion": "7.42.2"
     }
   ]
 }

package/dist/es/core.js

@@ -6267,7 +6267,7 @@ const defaults$h = {
   minInitialRank: "h1",
   sectioningRoots: ["dialog", '[role="dialog"]', '[role="alertdialog"]']
 };
-function isRelevant$5(event) {
+function isRelevant$6(event) {
   const node = event.target;
   return Boolean(node.meta && node.meta.heading);
 }
@@ -6334,7 +6334,7 @@ class HeadingLevel extends Rule {
     };
   }
   setup() {
-    this.on("tag:start", isRelevant$5, (event) => {
+    this.on("tag:start", isRelevant$6, (event) => {
       this.onTagStart(event);
     });
     this.on("tag:ready", (event) => {
@@ -6974,7 +6974,7 @@ class MapDupName extends Rule {
   }
 }
 
-function isRelevant$4(event) {
+function isRelevant$5(event) {
   return event.target.is("map");
 }
 function hasStaticValue(attr) {
@@ -6988,7 +6988,7 @@ class MapIdName extends Rule {
     };
   }
   setup() {
-    this.on("tag:ready", isRelevant$4, (event) => {
+    this.on("tag:ready", isRelevant$5, (event) => {
       const { target } = event;
       const id = target.getAttribute("id");
       const name = target.getAttribute("name");
@@ -7063,6 +7063,62 @@ class MultipleLabeledControls extends Rule {
   }
 }
 
+const abstractRoles = [
+  "command",
+  "composite",
+  "input",
+  "landmark",
+  "range",
+  "roletype",
+  "section",
+  "sectionhead",
+  "select",
+  "structure",
+  "widget",
+  "window"
+];
+function isRelevant$4(event) {
+  return event.key === "role";
+}
+class NoAbstractRole extends Rule {
+  documentation(context) {
+    return {
+      description: [
+        `Role \`"${context.role}"\` is abstract and must not be used.`,
+        "",
+        "WAI-ARIA defines a list of [abstract roles](https://www.w3.org/TR/wai-aria-1.2/#abstract_roles) which cannot be used by authors:",
+        "",
+        ...abstractRoles.map((it) => `- \`"${it}"\``),
+        "",
+        `Use one of the defined subclass roles for \`"${context.role}"\` instead.`
+      ].join("\n"),
+      url: "https://html-validate.org/rules/no-abstract-role.html"
+    };
+  }
+  setup() {
+    this.on("attr", isRelevant$4, (event) => {
+      const roles = event.value;
+      if (!roles || roles instanceof DynamicValue) {
+        return;
+      }
+      const tokens = new DOMTokenList(roles, event.valueLocation);
+      for (const { item: role, location } of tokens.iterator()) {
+        if (!abstractRoles.includes(role)) {
+          continue;
+        }
+        this.report({
+          node: event.target,
+          message: `Role "{{ role }}" is abstract and must not be used`,
+          location,
+          context: {
+            role
+          }
+        });
+      }
+    });
+  }
+}
+
 const defaults$e = {
   include: null,
   exclude: null
@@ -9472,6 +9528,7 @@ const bundledRules = {
   "meta-refresh": MetaRefresh,
   "missing-doctype": MissingDoctype,
   "multiple-labeled-controls": MultipleLabeledControls,
+  "no-abstract-role": NoAbstractRole,
   "no-autoplay": NoAutoplay,
   "no-conditional-comment": NoConditionalComment,
   "no-deprecated-attr": NoDeprecatedAttr,
@@ -9525,6 +9582,7 @@ const config$4 = {
     "hidden-focusable": "error",
     "meta-refresh": "error",
     "multiple-labeled-controls": "error",
+    "no-abstract-role": "error",
     "no-autoplay": ["error", { include: ["audio", "video"] }],
     "no-dup-id": "error",
     "no-implicit-button-type": "error",
@@ -9604,6 +9662,7 @@ const config$1 = {
     "map-id-name": "error",
     "meta-refresh": "error",
     "multiple-labeled-controls": "error",
+    "no-abstract-role": "error",
     "no-autoplay": ["error", { include: ["audio", "video"] }],
     "no-conditional-comment": "error",
     "no-deprecated-attr": "error",
@@ -9671,6 +9730,7 @@ const config = {
     "map-dup-name": "error",
     "map-id-name": "error",
     "multiple-labeled-controls": "error",
+    "no-abstract-role": "error",
     "no-deprecated-attr": "error",
     "no-dup-attr": "error",
     "no-dup-id": "error",
@@ -11904,7 +11964,7 @@ class HtmlValidate {
 }
 
 const name = "html-validate";
-const version = "8.11.1";
+const version = "8.12.0";
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
 function definePlugin(plugin) {