html-validate 8.11.0 → 8.12.0

package/dist/cjs/tsdoc-metadata.json

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

package/dist/es/core.js

@@ -1953,6 +1953,55 @@ function factory$1(name, context) {
   }
 }
 
+const escapedCodepoints = ["9", "a", "d"];
+function* splitSelectorElements(selector) {
+  let begin = 0;
+  let end = 0;
+  function initialState(ch, p) {
+    if (ch === "\\") {
+      return 1 /* ESCAPED */;
+    }
+    if (ch === " ") {
+      end = p;
+      return 2 /* WHITESPACE */;
+    }
+    return 0 /* INITIAL */;
+  }
+  function escapedState(ch) {
+    if (escapedCodepoints.includes(ch)) {
+      return 1 /* ESCAPED */;
+    }
+    return 0 /* INITIAL */;
+  }
+  function* whitespaceState(ch, p) {
+    if (ch === " ") {
+      return 2 /* WHITESPACE */;
+    }
+    yield selector.slice(begin, end);
+    begin = p;
+    end = p;
+    return 0 /* INITIAL */;
+  }
+  let state = 0 /* INITIAL */;
+  for (let p = 0; p < selector.length; p++) {
+    const ch = selector[p];
+    switch (state) {
+      case 0 /* INITIAL */:
+        state = initialState(ch, p);
+        break;
+      case 1 /* ESCAPED */:
+        state = escapedState(ch);
+        break;
+      case 2 /* WHITESPACE */:
+        state = yield* whitespaceState(ch, p);
+        break;
+    }
+  }
+  if (begin !== selector.length) {
+    yield selector.slice(begin);
+  }
+}
+
 function stripslashes(value) {
   return value.replace(/\\(.)/g, "$1");
 }
@@ -2152,13 +2201,8 @@ class Selector {
   }
   static parse(selector) {
     selector = selector.replace(/([+~>]) /g, "$1");
-    let begin = 0;
-    const delimiter = /((?:[^\\\u0039\u0061\u0064]) +|$)/g;
-    return Array.from(selector.matchAll(delimiter), (match) => {
-      const end = match.index + 1;
-      const part = unescapeCodepoint(selector.slice(begin, end));
-      begin = end + 1;
-      return new Pattern(part);
+    return Array.from(splitSelectorElements(selector), (element) => {
+      return new Pattern(unescapeCodepoint(element));
     });
   }
   static findCandidates(root, pattern) {
@@ -6223,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);
 }
@@ -6290,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) => {
@@ -6930,7 +6974,7 @@ class MapDupName extends Rule {
   }
 }
 
-function isRelevant$4(event) {
+function isRelevant$5(event) {
   return event.target.is("map");
 }
 function hasStaticValue(attr) {
@@ -6944,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");
@@ -7019,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
@@ -9428,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,
@@ -9481,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",
@@ -9560,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",
@@ -9627,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",
@@ -11860,7 +11964,7 @@ class HtmlValidate {
 }
 
 const name = "html-validate";
-const version = "8.11.0";
+const version = "8.12.0";
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
 function definePlugin(plugin) {