html-validate 10.16.0 → 11.0.0

package/dist/cjs/core.js

@@ -1155,7 +1155,7 @@ function normalizeAriaNaming(value) {
   return value;
 }
 function migrateElement(src) {
-  const implicitRole = normalizeAriaImplicitRole(src.implicitRole ?? src.aria?.implicitRole);
+  const implicitRole = normalizeAriaImplicitRole(src.aria?.implicitRole);
   const result = {
     ...src,
     formAssociated: void 0,
@@ -1571,12 +1571,21 @@ function sliceLocation(location, begin, end, wrap) {
   return sliced;
 }
 
-var NodeType = /* @__PURE__ */ ((NodeType2) => {
-  NodeType2[NodeType2["ELEMENT_NODE"] = 1] = "ELEMENT_NODE";
-  NodeType2[NodeType2["TEXT_NODE"] = 3] = "TEXT_NODE";
-  NodeType2[NodeType2["DOCUMENT_NODE"] = 9] = "DOCUMENT_NODE";
-  return NodeType2;
-})(NodeType || {});
+const Node = {
+  ELEMENT_NODE: 1,
+  TEXT_NODE: 3,
+  DOCUMENT_NODE: 9,
+  /** element wasn't closed */
+  CLOSED_OPEN: 0,
+  /** element closed with end tag <p>...</p> */
+  CLOSED_END_TAG: 1,
+  /** void element with omitted end tag <input> */
+  CLOSED_VOID_OMITTED: 2,
+  /** self-closed void element <input/> */
+  CLOSED_VOID_SELF_CLOSED: 3,
+  /** element with optional end tag <li>foo<li>bar */
+  CLOSED_IMPLICIT_CLOSED: 4
+};
 
 const DOCUMENT_NODE_NAME = "#document";
 const TEXT_CONTENT = /* @__PURE__ */ Symbol("textContent");
@@ -1703,7 +1712,7 @@ class DOMNode {
     }
   }
   isRootElement() {
-    return this.nodeType === NodeType.DOCUMENT_NODE;
+    return this.nodeType === Node.DOCUMENT_NODE;
   }
   /**
    * Tests if two nodes are the same (references the same object).
@@ -2360,7 +2369,7 @@ function parseSelector(selector) {
 
 const TEXT_NODE_NAME = "#text";
 function isTextNode(node) {
-  return node?.nodeType === NodeType.TEXT_NODE;
+  return node?.nodeType === Node.TEXT_NODE;
 }
 class TextNode extends DOMNode {
   text;
@@ -2370,7 +2379,7 @@ class TextNode extends DOMNode {
    * @param location - Source code location of this node.
    */
   constructor(text, location) {
-    super(NodeType.TEXT_NODE, TEXT_NODE_NAME, location);
+    super(Node.TEXT_NODE, TEXT_NODE_NAME, location);
     this.text = text;
   }
   /**
@@ -2396,16 +2405,8 @@ class TextNode extends DOMNode {
 const CHILD_ELEMENTS = /* @__PURE__ */ Symbol("childElements");
 const ROLE = /* @__PURE__ */ Symbol("role");
 const TABINDEX = /* @__PURE__ */ Symbol("tabindex");
-var NodeClosed = /* @__PURE__ */ ((NodeClosed2) => {
-  NodeClosed2[NodeClosed2["Open"] = 0] = "Open";
-  NodeClosed2[NodeClosed2["EndTag"] = 1] = "EndTag";
-  NodeClosed2[NodeClosed2["VoidOmitted"] = 2] = "VoidOmitted";
-  NodeClosed2[NodeClosed2["VoidSelfClosed"] = 3] = "VoidSelfClosed";
-  NodeClosed2[NodeClosed2["ImplicitClosed"] = 4] = "ImplicitClosed";
-  return NodeClosed2;
-})(NodeClosed || {});
 function isElementNode(node) {
-  return node?.nodeType === NodeType.ELEMENT_NODE;
+  return node?.nodeType === Node.ELEMENT_NODE;
 }
 function isInvalidTagName(tagName) {
   return tagName === "" || tagName === "*";
@@ -2439,7 +2440,7 @@ class HtmlElement extends DOMNode {
       nodeType,
       tagName,
       parent = null,
-      closed = 1 /* EndTag */,
+      closed = Node.CLOSED_END_TAG,
       meta = null,
       location
     } = details;
@@ -2480,9 +2481,9 @@ class HtmlElement extends DOMNode {
    * @param details - Additional element details.
    */
   static createElement(tagName, location, details = {}) {
-    const { closed = 1 /* EndTag */, meta = null, parent = null } = details;
+    const { closed = Node.CLOSED_END_TAG, meta = null, parent = null } = details;
     return new HtmlElement({
-      nodeType: NodeType.ELEMENT_NODE,
+      nodeType: Node.ELEMENT_NODE,
       tagName,
       parent,
       closed,
@@ -2495,7 +2496,7 @@ class HtmlElement extends DOMNode {
    */
   static rootNode(location) {
     const root = new HtmlElement({
-      nodeType: NodeType.DOCUMENT_NODE,
+      nodeType: Node.DOCUMENT_NODE,
       location
     });
     root.setAnnotation("#document");
@@ -2517,7 +2518,7 @@ class HtmlElement extends DOMNode {
     const closed = isClosed(endToken, meta);
     const location = sliceLocation(startToken.location, 1);
     return new HtmlElement({
-      nodeType: NodeType.ELEMENT_NODE,
+      nodeType: Node.ELEMENT_NODE,
       tagName,
       parent: open ? parent : null,
       closed,
@@ -2982,12 +2983,12 @@ class HtmlElement extends DOMNode {
   }
 }
 function isClosed(endToken, meta) {
-  let closed = 0 /* Open */;
+  let closed = Node.CLOSED_OPEN;
   if (meta?.void) {
-    closed = 2 /* VoidOmitted */;
+    closed = Node.CLOSED_VOID_OMITTED;
   }
   if (endToken.data[0] === "/>") {
-    closed = 3 /* VoidSelfClosed */;
+    closed = Node.CLOSED_VOID_SELF_CLOSED;
   }
   return closed;
 }
@@ -3074,18 +3075,6 @@ class DOMTree {
   getElementsByTagName(tagName) {
     return this.root.getElementsByTagName(tagName);
   }
-  /**
-   * @deprecated use utility function `walk.depthFirst(..)` instead (since 8.21.0).
-   */
-  visitDepthFirst(callback) {
-    walk.depthFirst(this, callback);
-  }
-  /**
-   * @deprecated use `querySelector(..)` instead (since 8.21.0)
-   */
-  find(callback) {
-    return this.root.find(callback);
-  }
   querySelector(selector) {
     return this.root.querySelector(selector);
   }
@@ -5737,14 +5726,12 @@ function parsePattern(pattern) {
     default: {
       if (pattern.startsWith("/") && pattern.endsWith("/")) {
         const regexpSource = pattern.slice(1, -1);
-        const regexp2 = new RegExp(regexpSource);
-        return { regexp: regexp2, description: regexp2.toString() };
+        const regexp = new RegExp(regexpSource);
+        return { regexp, description: regexp.toString() };
       }
-      console.warn(
-        `Custom pattern "${pattern}" should be wrapped in forward slashes, e.g., "/${pattern}/". Support for unwrapped patterns is deprecated and will be removed in a future version.`
+      throw new Error(
+        `Custom pattern "${pattern}" must be wrapped in forward slashes, i.e. "/${pattern}/"`
       );
-      const regexp = new RegExp(pattern);
-      return { regexp, description: regexp.toString() };
     }
   }
 }
@@ -5942,7 +5929,7 @@ class CloseOrder extends Rule {
       if (current.voidElement) {
         return;
       }
-      if (active.closed === NodeClosed.ImplicitClosed) {
+      if (active.closed === Node.CLOSED_IMPLICIT_CLOSED) {
         return;
       }
       if (active.isRootElement()) {
@@ -8371,7 +8358,7 @@ Omitted end tags can be ambigious for humans to read and many editors have troub
       if (!by) {
         return;
       }
-      if (closed.closed !== NodeClosed.ImplicitClosed) {
+      if (closed.closed !== Node.CLOSED_IMPLICIT_CLOSED) {
         return;
       }
       const parent = closed.parent;
@@ -8678,7 +8665,7 @@ class NoRawCharacters extends Rule {
         return;
       }
       for (const child of node.childNodes) {
-        if (child.nodeType !== NodeType.TEXT_NODE) {
+        if (child.nodeType !== Node.TEXT_NODE) {
           continue;
         }
         if (matchTemplate.test(child.textContent)) {
@@ -8909,7 +8896,7 @@ class NoSelfClosing extends Rule {
     });
   }
   validateElement(node) {
-    if (node.closed !== NodeClosed.VoidSelfClosed) {
+    if (node.closed !== Node.CLOSED_VOID_SELF_CLOSED) {
       return;
     }
     this.report(node, `<${node.tagName}> must not be self-closed`, null, node.tagName);
@@ -8981,6 +8968,55 @@ class NoTrailingWhitespace extends Rule {
   }
 }
 
+const skipPatterns = [
+  /^data-/i,
+  /^aria-/i,
+  /^on[a-z]/i,
+  /^xml(ns)?:/i,
+  /^:/,
+  /^@/,
+  /^ng-/i,
+  /^v-/i,
+  /^x-/i,
+  /^\[/
+];
+function isKnownDynamicAttr(attr) {
+  return skipPatterns.some((pattern) => pattern.test(attr));
+}
+class NoUnknownAttributes extends Rule {
+  documentation(context) {
+    return {
+      description: `The \`${context.attr}\` attribute is not a known attribute on \`<${context.tagName}>\`.`,
+      url: "https://html-validate.org/rules/no-unknown-attributes.html"
+    };
+  }
+  setup() {
+    this.on("attr", (event) => {
+      const node = event.target;
+      const meta = node.meta;
+      const attr = event.key.toLowerCase();
+      if (meta === null) {
+        return;
+      }
+      if (attr in meta.attributes) {
+        return;
+      }
+      if (isKnownDynamicAttr(attr)) {
+        return;
+      }
+      this.report({
+        node,
+        message: `Attribute "${event.key}" is not allowed on <${node.tagName}> element`,
+        location: event.keyLocation,
+        context: {
+          tagName: node.tagName,
+          attr: event.key
+        }
+      });
+    });
+  }
+}
+
 const defaults$b = {
   include: null,
   exclude: null
@@ -9493,7 +9529,7 @@ class ScriptElement extends Rule {
       if (node?.tagName !== "script") {
         return;
       }
-      if (node.closed !== NodeClosed.EndTag) {
+      if (node.closed !== Node.CLOSED_END_TAG) {
         this.report(node, `End tag for <${node.tagName}> must not be omitted`);
       }
     });
@@ -10036,7 +10072,7 @@ class UnknownCharReference extends Rule {
         return;
       }
       for (const child of node.childNodes) {
-        if (child.nodeType !== NodeType.TEXT_NODE) {
+        if (child.nodeType !== Node.TEXT_NODE) {
           continue;
         }
         this.findCharacterReferences(node, child.textContent, child.location, {
@@ -10773,7 +10809,7 @@ class VoidContent extends Rule {
       if (!node.voidElement) {
         return;
       }
-      if (node.closed === NodeClosed.EndTag) {
+      if (node.closed === Node.CLOSED_END_TAG) {
         this.report(
           null,
           `End tag for <${node.tagName}> must be omitted`,
@@ -10826,7 +10862,7 @@ class VoidStyle extends Rule {
     if (!node.voidElement) {
       return;
     }
-    if (node.closed !== NodeClosed.VoidSelfClosed) {
+    if (node.closed !== Node.CLOSED_VOID_SELF_CLOSED) {
       return;
     }
     this.reportError(
@@ -10838,7 +10874,7 @@ class VoidStyle extends Rule {
     if (!node.voidElement) {
       return;
     }
-    if (node.closed !== NodeClosed.VoidOmitted) {
+    if (node.closed !== Node.CLOSED_VOID_OMITTED) {
       return;
     }
     this.reportError(
@@ -11288,6 +11324,7 @@ const bundledRules = {
   "no-self-closing": NoSelfClosing,
   "no-style-tag": NoStyleTag,
   "no-trailing-whitespace": NoTrailingWhitespace,
+  "no-unknown-attributes": NoUnknownAttributes,
   "no-unknown-elements": NoUnknownElements,
   "no-unused-disable": NoUnusedDisable,
   "no-utf8-bom": NoUtf8Bom,
@@ -12602,7 +12639,7 @@ class EventHandler {
 }
 
 const name = "html-validate";
-const version = "10.16.0";
+const version = "11.0.0";
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
 function freeze(src) {
@@ -13017,7 +13054,7 @@ class Parser {
       if (matches) {
         const intermediaryMeta = this.metaTable.getMetaFor(entry.open);
         return HtmlElement.createElement(entry.open, token.location, {
-          closed: NodeClosed.Open,
+          closed: Node.CLOSED_OPEN,
           meta: intermediaryMeta,
           parent
         });
@@ -13100,11 +13137,11 @@ class Parser {
       this.metaTable,
       this.currentNamespace
     );
-    const isClosing = !isStartTag || node.closed !== NodeClosed.Open;
+    const isClosing = !isStartTag || node.closed !== Node.CLOSED_OPEN;
     const isForeign = node.meta?.foreign;
     while (this.closeOptional(startToken)) {
       const active = this.dom.getActive();
-      active.closed = NodeClosed.ImplicitClosed;
+      active.closed = Node.CLOSED_IMPLICIT_CLOSED;
       this.closeElement(source, node, active, startToken.location);
       this.dom.popActive();
     }
@@ -13145,7 +13182,7 @@ class Parser {
     if (isClosing) {
       const active = this.dom.getActive();
       if (!isStartTag) {
-        node.closed = NodeClosed.EndTag;
+        node.closed = Node.CLOSED_END_TAG;
       }
       this.closeElement(source, node, active, endToken.location);
       const mismatched = node.tagName !== active.tagName;
@@ -13168,7 +13205,7 @@ class Parser {
       location
     };
     this.trigger("tag:end", event);
-    if (node && node.tagName !== active.tagName && active.closed !== NodeClosed.ImplicitClosed) {
+    if (node && node.tagName !== active.tagName && active.closed !== Node.CLOSED_IMPLICIT_CLOSED) {
       return;
     }
     if (!active.isRootElement()) {
@@ -13525,7 +13562,7 @@ class Parser {
     let active = this.dom.getActive();
     while (!active.isRootElement()) {
       if (active.meta?.implicitClosed || active.meta?.optionalEnd) {
-        active.closed = NodeClosed.ImplicitClosed;
+        active.closed = Node.CLOSED_IMPLICIT_CLOSED;
         this.closeElement(source, documentElement, active, location);
       } else {
         this.closeElement(source, null, active, location);
@@ -15309,7 +15346,7 @@ var ignoreExports = /*@__PURE__*/ requireIgnore();
 var ignore = /*@__PURE__*/getDefaultExportFromCjs(ignoreExports);
 
 const engines = {
-	node: "^20.19.0 || ^22.16.0 || >= 24.0.0"
+	node: "^22.16.0 || >= 24.0.0"
 };
 
 var workerPath = "./jest-worker.js";
@@ -15328,8 +15365,7 @@ exports.HtmlElement = HtmlElement;
 exports.MetaCopyableProperty = MetaCopyableProperty;
 exports.MetaTable = MetaTable;
 exports.NestedError = NestedError;
-exports.NodeClosed = NodeClosed;
-exports.NodeType = NodeType;
+exports.Node = Node;
 exports.Parser = Parser;
 exports.PerformanceTracker = PerformanceTracker;
 exports.Reporter = Reporter;
@@ -15342,7 +15378,6 @@ exports.TextClassification = TextClassification;
 exports.TextContent = TextContent$1;
 exports.TextNode = TextNode;
 exports.UserError = UserError;
-exports.Validator = Validator;
 exports.WrappedError = WrappedError;
 exports.ariaNaming = ariaNaming;
 exports.bugs = bugs;