html-validate 8.25.0 → 8.26.0

package/dist/cjs/tsdoc-metadata.json

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

package/dist/es/core.js

@@ -1743,7 +1743,31 @@ class DOMNode {
     return text;
   }
   append(node) {
+    const oldParent = node._setParent(this);
+    if (oldParent && this.isSameNode(oldParent)) {
+      return;
+    }
     this.childNodes.push(node);
+    if (oldParent) {
+      oldParent._removeChild(node);
+    }
+  }
+  /**
+   * Insert a node before a reference node.
+   *
+   * @internal
+   */
+  insertBefore(node, reference) {
+    const index = reference ? this.childNodes.findIndex((it) => it.isSameNode(reference)) : -1;
+    if (index >= 0) {
+      this.childNodes.splice(index, 0, node);
+    } else {
+      this.childNodes.push(node);
+    }
+    const oldParent = node._setParent(this);
+    if (oldParent) {
+      oldParent._removeChild(node);
+    }
   }
   isRootElement() {
     return this.nodeType === NodeType.DOCUMENT_NODE;
@@ -1770,6 +1794,14 @@ class DOMNode {
   get lastChild() {
     return this.childNodes[this.childNodes.length - 1] || null;
   }
+  /**
+   * @internal
+   */
+  removeChild(node) {
+    this._removeChild(node);
+    node._setParent(null);
+    return node;
+  }
   /**
    * Block a rule for this node.
    *
@@ -1844,6 +1876,22 @@ class DOMNode {
   generateSelector() {
     return null;
   }
+  /**
+   * @internal
+   *
+   * @returns Old parent, if set.
+   */
+  _setParent(_node) {
+    return null;
+  }
+  _removeChild(node) {
+    const index = this.childNodes.findIndex((it) => it.isSameNode(node));
+    if (index >= 0) {
+      this.childNodes.splice(index, 1);
+    } else {
+      throw new Error("DOMException: _removeChild(..) could not find child to remove");
+    }
+  }
 }
 
 function parse(text, baseLocation) {
@@ -2363,7 +2411,7 @@ class HtmlElement extends DOMNode {
       throw new Error(`The tag name provided ("${tagName}") is not a valid name`);
     }
     this.tagName = tagName ?? "#document";
-    this.parent = parent ?? null;
+    this._parent = null;
     this.attr = {};
     this.metaElement = meta ?? null;
     this.closed = closed;
@@ -2372,7 +2420,7 @@ class HtmlElement extends DOMNode {
     this.annotation = null;
     this._adapter = createAdapter(this);
     if (parent) {
-      parent.childNodes.push(this);
+      parent.append(this);
       let cur = parent;
       while (cur.parent) {
         this.depth++;
@@ -2596,6 +2644,9 @@ class HtmlElement extends DOMNode {
   get meta() {
     return this.metaElement;
   }
+  get parent() {
+    return this._parent;
+  }
   /**
    * Get current role for this element (explicit with `role` attribute or mapped
    * with implicit role).
@@ -2856,6 +2907,14 @@ class HtmlElement extends DOMNode {
     }
     return visit(this);
   }
+  /**
+   * @internal
+   */
+  _setParent(node) {
+    const oldParent = this._parent;
+    this._parent = node instanceof HtmlElement ? node : null;
+    return oldParent;
+  }
 }
 function isClosed(endToken, meta) {
   let closed = 0 /* Open */;
@@ -2880,20 +2939,22 @@ function dumpTree(root) {
     }
     return output;
   }
-  function writeNode(node, level, sibling) {
+  function writeNode(node, level, indent, sibling) {
+    const numSiblings = node.parent ? node.parent.childElements.length : 0;
+    const lastSibling = sibling === numSiblings - 1;
     if (node.parent) {
-      const indent = "  ".repeat(level - 1);
-      const l = node.childElements.length > 0 ? "\u252C" : "\u2500";
-      const b = sibling < node.parent.childElements.length - 1 ? "\u251C" : "\u2514";
-      lines.push(`${indent}${b}\u2500${l} ${node.tagName}${decoration(node)}`);
+      const b = lastSibling ? "\u2514" : "\u251C";
+      lines.push(`${indent}${b}\u2500\u2500 ${node.tagName}${decoration(node)}`);
     } else {
       lines.push("(root)");
     }
     node.childElements.forEach((child, index) => {
-      writeNode(child, level + 1, index);
+      const s = lastSibling ? " " : "\u2502";
+      const i = level > 0 ? `${indent}${s}   ` : "";
+      writeNode(child, level + 1, i, index);
     });
   }
-  writeNode(root, 0, 0);
+  writeNode(root, 0, "", 0);
   return lines;
 }
 
@@ -4988,6 +5049,27 @@ class CloseAttr extends Rule {
   }
 }
 
+function* ancestors(node) {
+  if (!node) {
+    return;
+  }
+  let ancestor = node;
+  while (ancestor && !ancestor.isRootElement()) {
+    yield ancestor;
+    ancestor = ancestor.parent;
+  }
+  if (ancestor) {
+    yield ancestor;
+  }
+}
+function findAncestor(node, predicate) {
+  for (const ancestor of ancestors(node)) {
+    if (predicate(ancestor)) {
+      return ancestor;
+    }
+  }
+  return null;
+}
 class CloseOrder extends Rule {
   documentation() {
     return {
@@ -4996,15 +5078,28 @@ class CloseOrder extends Rule {
     };
   }
   setup() {
+    let reported;
+    this.on("parse:begin", () => {
+      reported = /* @__PURE__ */ new Set();
+    });
+    this.on("tag:end", (event) => {
+      const current = event.target;
+      const active = event.previous;
+      if (current) {
+        return;
+      }
+      for (const ancestor of ancestors(active)) {
+        if (ancestor.isRootElement() || reported.has(ancestor.unique)) {
+          continue;
+        }
+        this.report(ancestor, `Unclosed element '<${ancestor.tagName}>'`, ancestor.location);
+        reported.add(ancestor.unique);
+      }
+    });
     this.on("tag:end", (event) => {
       const current = event.target;
       const active = event.previous;
       if (!current) {
-        this.report(
-          null,
-          `Missing close-tag, expected '</${active.tagName}>' but document ended before it was found.`,
-          event.location
-        );
         return;
       }
       if (current.voidElement) {
@@ -5021,15 +5116,32 @@ class CloseOrder extends Rule {
           offset: current.location.offset,
           size: current.tagName.length + 1
         };
-        this.report(null, "Unexpected close-tag, expected opening tag.", location);
+        this.report(null, `Stray end tag '</${current.tagName}>'`, location);
+        return;
+      }
+      if (current.tagName === active.tagName) {
         return;
       }
-      if (current.tagName !== active.tagName) {
+      const ancestor = findAncestor(active.parent, (node) => node.is(current.tagName));
+      if (ancestor && !ancestor.isRootElement()) {
+        for (const element of ancestors(active)) {
+          if (ancestor.isSameNode(element)) {
+            break;
+          }
+          if (reported.has(element.unique)) {
+            continue;
+          }
+          this.report(element, `Unclosed element '<${element.tagName}>'`, element.location);
+          reported.add(element.unique);
+        }
         this.report(
           null,
-          `Mismatched close-tag, expected '</${active.tagName}>' but found '</${current.tagName}>'.`,
+          `End tag '</${current.tagName}>' seen but there were open elements`,
           current.location
         );
+        reported.add(ancestor.unique);
+      } else {
+        this.report(null, `Stray end tag '</${current.tagName}>'`, current.location);
       }
     });
   }
@@ -7252,8 +7364,9 @@ Omitted end tags can be ambigious for humans to read and many editors have troub
       if (closed.closed !== NodeClosed.ImplicitClosed) {
         return;
       }
-      const closedByParent = closed.parent && closed.parent.tagName === by.tagName;
-      const closedByDocument = closedByParent && closed.parent.isRootElement();
+      const parent = closed.parent;
+      const closedByParent = parent && parent.tagName === by.tagName;
+      const closedByDocument = closedByParent && parent.isRootElement();
       const sameTag = closed.tagName === by.tagName;
       if (closedByDocument) {
         this.report(
@@ -11584,8 +11697,9 @@ class Parser {
         node.closed = NodeClosed.EndTag;
       }
       this.closeElement(source, node, active, endToken.location);
+      const mismatched = node.tagName !== active.tagName;
       const voidClosed = !isStartTag && node.voidElement;
-      if (!voidClosed) {
+      if (!voidClosed && !mismatched) {
         this.dom.popActive();
       }
     } else if (isForeign) {
@@ -11603,6 +11717,9 @@ class Parser {
       location
     };
     this.trigger("tag:end", event);
+    if (node && node.tagName !== active.tagName && active.closed !== NodeClosed.ImplicitClosed) {
+      return;
+    }
     if (!active.isRootElement()) {
       this.trigger("element:ready", {
         target: active,
@@ -12885,7 +13002,7 @@ class HtmlValidate {
 }
 
 const name = "html-validate";
-const version = "8.25.0";
+const version = "8.25.1";
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
 function definePlugin(plugin) {