html-validate 7.14.0 → 7.15.1

package/dist/cjs/core.js

@@ -293,6 +293,8 @@ class DynamicValue {
  *
  * Represents a HTML attribute. Can contain either a fixed static value or a
  * placeholder for dynamic values (e.g. interpolated).
+ *
+ * @public
  */
 class Attribute {
     /**
@@ -406,7 +408,7 @@ function sliceLocation(location, begin, end, wrap) {
             else {
                 break;
             }
-        } while (true); // eslint-disable-line no-constant-condition
+        } while (true); // eslint-disable-line no-constant-condition -- it will break out
     }
     return sliced;
 }
@@ -475,7 +477,10 @@ class Context {
     }
 }
 
-var TextContent$1;
+/**
+ * @public
+ */
+exports.TextContent = void 0;
 (function (TextContent) {
     /* forbid node to have text content, inter-element whitespace is ignored */
     TextContent["NONE"] = "none";
@@ -485,7 +490,7 @@ var TextContent$1;
     TextContent["REQUIRED"] = "required";
     /* node requires accessible text (hidden text is ignored, tries to get text from accessibility tree) */
     TextContent["ACCESSIBLE"] = "accessible";
-})(TextContent$1 || (TextContent$1 = {}));
+})(exports.TextContent || (exports.TextContent = {}));
 /**
  * Properties listed here can be copied (loaded) onto another element using
  * [[HtmlElement.loadMeta]].
@@ -519,16 +524,22 @@ function setMetaProperty(dst, key, value) {
     dst[key] = value;
 }
 
-var NodeType;
+/**
+ * @public
+ */
+exports.NodeType = void 0;
 (function (NodeType) {
     NodeType[NodeType["ELEMENT_NODE"] = 1] = "ELEMENT_NODE";
     NodeType[NodeType["TEXT_NODE"] = 3] = "TEXT_NODE";
     NodeType[NodeType["DOCUMENT_NODE"] = 9] = "DOCUMENT_NODE";
-})(NodeType || (NodeType = {}));
+})(exports.NodeType || (exports.NodeType = {}));
 
 const DOCUMENT_NODE_NAME = "#document";
 const TEXT_CONTENT = Symbol("textContent");
 let counter = 0;
+/**
+ * @public
+ */
 class DOMNode {
     /**
      * Create a new DOMNode.
@@ -552,6 +563,8 @@ class DOMNode {
      * Enable cache for this node.
      *
      * Should not be called before the node and all children are fully constructed.
+     *
+     * @internal
      */
     cacheEnable() {
         this.cache = new Map();
@@ -597,10 +610,12 @@ class DOMNode {
         this.childNodes.push(node);
     }
     isRootElement() {
-        return this.nodeType === NodeType.DOCUMENT_NODE;
+        return this.nodeType === exports.NodeType.DOCUMENT_NODE;
     }
     /**
      * Tests if two nodes are the same (references the same object).
+     *
+     * @since v4.11.0
      */
     isSameNode(otherNode) {
         return this.unique === otherNode.unique;
@@ -726,6 +741,9 @@ function parse(text, baseLocation) {
     }
     return { tokens, locations };
 }
+/**
+ * @public
+ */
 class DOMTokenList extends Array {
     constructor(value, location) {
         if (value && typeof value === "string") {
@@ -762,7 +780,7 @@ class DOMTokenList extends Array {
     }
     *iterator() {
         for (let index = 0; index < this.length; index++) {
-            /* eslint-disable @typescript-eslint/no-non-null-assertion */
+            /* eslint-disable @typescript-eslint/no-non-null-assertion -- as we loop over length this should always be set */
             const item = this.item(index);
             const location = this.location(index);
             /* eslint-enable @typescript-eslint/no-non-null-assertion */
@@ -1121,7 +1139,7 @@ const TEXT_NODE_NAME = "#text";
  * @public
  */
 function isTextNode(node) {
-    return Boolean(node && node.nodeType === NodeType.TEXT_NODE);
+    return Boolean(node && node.nodeType === exports.NodeType.TEXT_NODE);
 }
 /**
  * Represents a text in the HTML document.
@@ -1138,7 +1156,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(exports.NodeType.TEXT_NODE, TEXT_NODE_NAME, location);
         this.text = text;
     }
     /**
@@ -1178,7 +1196,7 @@ exports.NodeClosed = void 0;
  * @public
  */
 function isElementNode(node) {
-    return Boolean(node && node.nodeType === NodeType.ELEMENT_NODE);
+    return Boolean(node && node.nodeType === exports.NodeType.ELEMENT_NODE);
 }
 function isValidTagName(tagName) {
     return Boolean(tagName !== "" && tagName !== "*");
@@ -1188,7 +1206,7 @@ function isValidTagName(tagName) {
  */
 class HtmlElement extends DOMNode {
     constructor(tagName, parent, closed, meta, location) {
-        const nodeType = tagName ? NodeType.ELEMENT_NODE : NodeType.DOCUMENT_NODE;
+        const nodeType = tagName ? exports.NodeType.ELEMENT_NODE : exports.NodeType.DOCUMENT_NODE;
         super(nodeType, tagName, location);
         if (!isValidTagName(tagName)) {
             throw new Error(`The tag name provided ('${tagName || ""}') is not a valid name`);
@@ -1281,7 +1299,7 @@ class HtmlElement extends DOMNode {
      * Implementation of DOM specification of Element.closest(selectors).
      */
     closest(selectors) {
-        /* eslint-disable-next-line @typescript-eslint/no-this-alias */
+        /* eslint-disable-next-line @typescript-eslint/no-this-alias -- false positive*/
         let node = this;
         while (node) {
             if (node.matches(selectors)) {
@@ -1302,11 +1320,11 @@ class HtmlElement extends DOMNode {
         }
         const parts = [];
         let root;
-        /* eslint-disable-next-line @typescript-eslint/no-this-alias */
+        /* eslint-disable-next-line @typescript-eslint/no-this-alias -- false positive */
         for (root = this; root.parent; root = root.parent) {
             /* .. */
         }
-        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        // eslint-disable-next-line @typescript-eslint/no-this-alias -- false positive
         for (let cur = this; cur.parent; cur = cur.parent) {
             /* if a unique id is present, use it and short-circuit */
             if (cur.id) {
@@ -1390,7 +1408,7 @@ class HtmlElement extends DOMNode {
      */
     matches(selector) {
         /* find root element */
-        /* eslint-disable-next-line @typescript-eslint/no-this-alias */
+        /* eslint-disable-next-line @typescript-eslint/no-this-alias -- false positive */
         let root = this;
         while (root.parent) {
             root = root.parent;
@@ -1539,9 +1557,14 @@ class HtmlElement extends DOMNode {
         }, []);
     }
     querySelector(selector) {
-        var _a;
         const it = this.querySelectorImpl(selector);
-        return (_a = it.next().value) !== null && _a !== void 0 ? _a : null; // eslint-disable-line @typescript-eslint/no-unsafe-return
+        const next = it.next();
+        if (next.done) {
+            return null;
+        }
+        else {
+            return next.value;
+        }
     }
     querySelectorAll(selector) {
         const it = this.querySelectorImpl(selector);
@@ -1635,6 +1658,9 @@ function isClosed(endToken, meta) {
     return closed;
 }
 
+/**
+ * @public
+ */
 class DOMTree {
     constructor(location) {
         this.root = HtmlElement.rootNode(location);
@@ -1713,6 +1739,9 @@ function ensureError(value) {
     }
 }
 
+/**
+ * @public
+ */
 class NestedError extends Error {
     constructor(message, nested) {
         super(message);
@@ -2479,7 +2508,7 @@ class MetaTable {
     /**
      * Extend validation schema.
      *
-     * @internal
+     * @public
      */
     extendValidationSchema(patch) {
         if (patch.properties) {
@@ -2500,7 +2529,7 @@ class MetaTable {
     /**
      * Load metadata table from object.
      *
-     * @internal
+     * @public
      * @param obj - Object with metadata to load
      * @param filename - Optional filename used when presenting validation error
      */
@@ -2521,7 +2550,7 @@ class MetaTable {
     /**
      * Load metadata table from filename
      *
-     * @internal
+     * @public
      * @param filename - Filename to load
      */
     loadFromFile(filename) {
@@ -2684,7 +2713,7 @@ function expandRegexValue(value) {
     const match = value.match(/^\/\^?([^/$]*)\$?\/([i]*)$/);
     if (match) {
         const [, expr, flags] = match;
-        // eslint-disable-next-line security/detect-non-literal-regexp
+        // eslint-disable-next-line security/detect-non-literal-regexp -- expected to be regexp
         return new RegExp(`^${expr}$`, flags);
     }
     else {
@@ -2885,7 +2914,6 @@ class Validator {
      * @param rules - Element attribute metadta.
      * @returns `true` if attribute passes all tests.
      */
-    /* eslint-disable-next-line complexity */
     static validateAttribute(attr, rules) {
         const rule = rules[attr.key];
         if (!rule) {
@@ -2976,7 +3004,7 @@ class Validator {
      * @param category - Name of category with `@` prefix or tag name.
      * @param defaultMatch - The default return value when node categories is not known.
      */
-    // eslint-disable-next-line complexity
+    /* eslint-disable-next-line complexity -- rule does not like switch */
     static validatePermittedCategory(node, category, defaultMatch) {
         const [, rawCategory] = category.match(/^(@?.*?)([?*]?)$/);
         /* match tagName when an explicit name is given */
@@ -3183,7 +3211,8 @@ var configurationSchema = {
 	properties: properties
 };
 
-/* eslint-disable @typescript-eslint/no-non-null-assertion */
+/* eslint-disable @typescript-eslint/no-non-null-assertion -- declarations say
+ * location fields are optional but they are always present when `{loc: true}` */
 function joinTemplateLiteral(nodes) {
     let offset = nodes[0].start + 1;
     let output = "";
@@ -3404,7 +3433,7 @@ function parseSeverity(value) {
             return exports.Severity.DISABLED;
         /* istanbul ignore next: deprecated code which will be removed later */
         case "disable":
-            // eslint-disable-next-line no-console
+            // eslint-disable-next-line no-console -- expected to log
             console.warn(`Deprecated alias "disabled" will be removed, replace with severity "off"`);
             return exports.Severity.DISABLED;
         case 1:
@@ -3515,8 +3544,8 @@ class Rule {
         this.severity = severity;
     }
     /**
-     * Block this rule from generating errors. Pass in an id generated by {@link
-     * createBlocker}. Can be unblocked by {@link unblock}.
+     * Block this rule from generating errors. Pass in an id generated by
+     * `createBlocker`. Can be unblocked by {@link Rule.unblock}.
      *
      * A blocked rule is similar to disabling it but it will still receive parser
      * events. A list of all blockers is passed to the `rule:error` event.
@@ -3527,7 +3556,7 @@ class Rule {
         this.blockers.push(id);
     }
     /**
-     * Unblock a rule previously blocked by {@link block}.
+     * Unblock a rule previously blocked by {@link Rule.block}.
      *
      * @internal
      */
@@ -3745,12 +3774,20 @@ class Rule {
      * @returns Rule documentation and url with additional details or `null` if no
      * additional documentation is available.
      */
-    /* eslint-disable-next-line @typescript-eslint/no-unused-vars */
+    /* eslint-disable-next-line @typescript-eslint/no-unused-vars -- technical debt, prototype should be moved to interface */
     documentation(context) {
         return null;
     }
 }
 
+var Style$2;
+(function (Style) {
+    Style["EXTERNAL"] = "external";
+    Style["RELATIVE_BASE"] = "relative-base";
+    Style["RELATIVE_PATH"] = "relative-path";
+    Style["ABSOLUTE"] = "absolute";
+    Style["ANCHOR"] = "anchor";
+})(Style$2 || (Style$2 = {}));
 const defaults$w = {
     allowExternal: true,
     allowRelative: true,
@@ -3764,18 +3801,18 @@ const mapping$1 = {
     script: "src",
 };
 const description = {
-    ["external" /* Style.EXTERNAL */]: "External links are not allowed by current configuration.",
-    ["relative-base" /* Style.RELATIVE_BASE */]: "Links relative to <base> are not allowed by current configuration.",
-    ["relative-path" /* Style.RELATIVE_PATH */]: "Relative links are not allowed by current configuration.",
-    ["absolute" /* Style.ABSOLUTE */]: "Absolute links are not allowed by current configuration.",
-    ["anchor" /* Style.ANCHOR */]: null,
+    [Style$2.EXTERNAL]: "External links are not allowed by current configuration.",
+    [Style$2.RELATIVE_BASE]: "Links relative to <base> are not allowed by current configuration.",
+    [Style$2.RELATIVE_PATH]: "Relative links are not allowed by current configuration.",
+    [Style$2.ABSOLUTE]: "Absolute links are not allowed by current configuration.",
+    [Style$2.ANCHOR]: null,
 };
 function parseAllow(value) {
     if (typeof value === "boolean") {
         return value;
     }
     return {
-        /* eslint-disable security/detect-non-literal-regexp */
+        /* eslint-disable security/detect-non-literal-regexp -- expected to be regexp  */
         include: value.include ? value.include.map((it) => new RegExp(it)) : null,
         exclude: value.exclude ? value.exclude.map((it) => new RegExp(it)) : null,
         /* eslint-enable security/detect-non-literal-regexp */
@@ -3841,19 +3878,19 @@ class AllowedLinks extends Rule {
             const link = event.value.toString();
             const style = this.getStyle(link);
             switch (style) {
-                case "anchor" /* Style.ANCHOR */:
+                case Style$2.ANCHOR:
                     /* anchor links are always allowed by this rule */
                     break;
-                case "absolute" /* Style.ABSOLUTE */:
+                case Style$2.ABSOLUTE:
                     this.handleAbsolute(link, event, style);
                     break;
-                case "external" /* Style.EXTERNAL */:
+                case Style$2.EXTERNAL:
                     this.handleExternal(link, event, style);
                     break;
-                case "relative-base" /* Style.RELATIVE_BASE */:
+                case Style$2.RELATIVE_BASE:
                     this.handleRelativeBase(link, event, style);
                     break;
-                case "relative-path" /* Style.RELATIVE_PATH */:
+                case Style$2.RELATIVE_PATH:
                     this.handleRelativePath(link, event, style);
                     break;
             }
@@ -3871,21 +3908,21 @@ class AllowedLinks extends Rule {
     getStyle(value) {
         /* http://example.net or //example.net */
         if (value.match(/^([a-z]+:)?\/\//g)) {
-            return "external" /* Style.EXTERNAL */;
+            return Style$2.EXTERNAL;
         }
         switch (value[0]) {
             /* /foo/bar */
             case "/":
-                return "absolute" /* Style.ABSOLUTE */;
+                return Style$2.ABSOLUTE;
             /* ../foo/bar */
             case ".":
-                return "relative-path" /* Style.RELATIVE_PATH */;
+                return Style$2.RELATIVE_PATH;
             /* #foo */
             case "#":
-                return "anchor" /* Style.ANCHOR */;
+                return Style$2.ANCHOR;
             /* foo/bar */
             default:
-                return "relative-base" /* Style.RELATIVE_BASE */;
+                return Style$2.RELATIVE_BASE;
         }
     }
     handleAbsolute(target, event, style) {
@@ -4223,6 +4260,9 @@ class AttrCase extends Rule {
     }
 }
 
+/**
+ * @internal
+ */
 var TokenType;
 (function (TokenType) {
     TokenType[TokenType["UNICODE_BOM"] = 1] = "UNICODE_BOM";
@@ -4244,7 +4284,7 @@ var TokenType;
     TokenType[TokenType["EOF"] = 17] = "EOF";
 })(TokenType || (TokenType = {}));
 
-/* eslint-disable no-useless-escape */
+/* eslint-disable no-useless-escape -- false positives */
 const MATCH_UNICODE_BOM = /^\uFEFF/;
 const MATCH_WHITESPACE = /^(?:\r\n|\r|\n|[ \t]+(?:\r\n|\r|\n)?)/;
 const MATCH_DOCTYPE_OPEN = /^<!(DOCTYPE)\s/i;
@@ -4269,6 +4309,7 @@ const MATCH_STYLE_END = /^<(\/)(style)/;
 const MATCH_DIRECTIVE = /^(<!--\s*\[html-validate-)([a-z0-9-]+)(\s*)(.*?)(]?\s*-->)/;
 const MATCH_COMMENT = /^<!--([^]*?)-->/;
 const MATCH_CONDITIONAL = /^<!\[([^\]]*?)\]>/;
+/* eslint-enable no-useless-escape */
 class InvalidTokenError extends Error {
     constructor(location, message) {
         super(message);
@@ -4276,7 +4317,7 @@ class InvalidTokenError extends Error {
     }
 }
 class Lexer {
-    // eslint-disable-next-line complexity
+    /* eslint-disable-next-line complexity -- there isn't really a good way to refactor this while keeping readability */
     *tokenize(source) {
         const context = new Context(source);
         /* for sanity check */
@@ -4410,7 +4451,6 @@ class Lexer {
         ], "expected doctype name");
     }
     *tokenizeTag(context) {
-        /* eslint-disable-next-line consistent-return -- exhaustive switch handled by typescript */
         function nextState(token) {
             const tagCloseToken = token;
             switch (context.contentModel) {
@@ -4507,11 +4547,11 @@ const defaults$t = {
 };
 function generateRegexp(pattern) {
     if (Array.isArray(pattern)) {
-        /* eslint-disable-next-line security/detect-non-literal-regexp */
+        /* eslint-disable-next-line security/detect-non-literal-regexp -- expected to be regexp */
         return new RegExp(`^(${pattern.join("|")})$`, "i");
     }
     else {
-        /* eslint-disable-next-line security/detect-non-literal-regexp */
+        /* eslint-disable-next-line security/detect-non-literal-regexp -- expected to be regexp  */
         return new RegExp(`^${pattern}$`, "i");
     }
 }
@@ -5061,7 +5101,7 @@ function parsePattern(pattern) {
         case "underscore":
             return /^[a-z0-9_]+$/;
         default:
-            // eslint-disable-next-line security/detect-non-literal-regexp
+            /* eslint-disable-next-line security/detect-non-literal-regexp -- expected to be regexp */
             return new RegExp(pattern);
     }
 }
@@ -5477,7 +5517,7 @@ const defaults$l = {
 class ElementName extends Rule {
     constructor(options) {
         super({ ...defaults$l, ...options });
-        // eslint-disable-next-line security/detect-non-literal-regexp
+        /* eslint-disable-next-line security/detect-non-literal-regexp -- expected to be a regexp */
         this.pattern = new RegExp(this.options.pattern);
     }
     static schema() {
@@ -6485,7 +6525,7 @@ class IdPattern extends Rule {
     }
 }
 
-/* eslint-disable sonarjs/no-duplicate-string */
+/* eslint-disable sonarjs/no-duplicate-string -- wont be easier to read or manage with constants */
 const restricted = new Map([
     ["accept", ["file"]],
     ["alt", ["image"]],
@@ -7455,7 +7495,7 @@ class NoRawCharacters extends Rule {
             const node = event.target;
             /* only iterate over direct descendants */
             for (const child of node.childNodes) {
-                if (child.nodeType !== NodeType.TEXT_NODE) {
+                if (child.nodeType !== exports.NodeType.TEXT_NODE) {
                     continue;
                 }
                 /* workaround for templating <% ... %> etc */
@@ -8301,11 +8341,11 @@ function constructRegex(characters) {
     })
         .join("|");
     const pattern = `(${disallowed})`;
-    /* eslint-disable-next-line security/detect-non-literal-regexp */
+    /* eslint-disable-next-line security/detect-non-literal-regexp -- technical debt, should do more input sanitation */
     return new RegExp(pattern, "g");
 }
 function getText(node) {
-    /* eslint-disable-next-line @typescript-eslint/no-non-null-assertion */
+    /* eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- this will always match something, it cannot be null */
     const match = node.textContent.match(/^(\s*)(.*)$/);
     const [, leading, text] = match;
     return [leading.length, text.trimEnd()];
@@ -8314,15 +8354,11 @@ function getText(node) {
  * Node 12 does not support String.matchAll, this simulates it's behavior.
  */
 function matchAll(text, regexp) {
-    /* eslint-disable-next-line security/detect-non-literal-regexp */
+    /* eslint-disable-next-line security/detect-non-literal-regexp -- makes copy of existing one only */
     const copy = new RegExp(regexp);
     const matches = [];
-    /* eslint-disable-next-line no-constant-condition */
-    while (true) {
-        const match = copy.exec(text);
-        if (match === null) {
-            break;
-        }
+    let match;
+    while ((match = copy.exec(text))) {
         matches.push(match);
     }
     return matches;
@@ -8532,13 +8568,13 @@ class TextContent extends Rule {
         };
         if (context === null || context === void 0 ? void 0 : context.textContent) {
             switch (context.textContent) {
-                case TextContent$1.NONE:
+                case exports.TextContent.NONE:
                     doc.description = `The \`<${context.tagName}>\` element must not have textual content.`;
                     break;
-                case TextContent$1.REQUIRED:
+                case exports.TextContent.REQUIRED:
                     doc.description = `The \`<${context.tagName}>\` element must have textual content.`;
                     break;
-                case TextContent$1.ACCESSIBLE:
+                case exports.TextContent.ACCESSIBLE:
                     doc.description = `The \`<${context.tagName}>\` element must have accessible text.`;
                     break;
             }
@@ -8553,7 +8589,7 @@ class TextContent extends Rule {
         }
         /* skip elements without explicit and default textContent */
         const { textContent } = target.meta;
-        if (!textContent || textContent === TextContent$1.DEFAULT) {
+        if (!textContent || textContent === exports.TextContent.DEFAULT) {
             return false;
         }
         return true;
@@ -8563,13 +8599,13 @@ class TextContent extends Rule {
             const target = event.target;
             const { textContent } = target.meta;
             switch (textContent) {
-                case TextContent$1.NONE:
+                case exports.TextContent.NONE:
                     this.validateNone(target);
                     break;
-                case TextContent$1.REQUIRED:
+                case exports.TextContent.REQUIRED:
                     this.validateRequired(target);
                     break;
-                case TextContent$1.ACCESSIBLE:
+                case exports.TextContent.ACCESSIBLE:
                     this.validateAccessible(target);
                     break;
             }
@@ -8682,7 +8718,7 @@ class UnknownCharReference extends Rule {
             const node = event.target;
             /* only iterate over direct descendants */
             for (const child of node.childNodes) {
-                if (child.nodeType !== NodeType.TEXT_NODE) {
+                if (child.nodeType !== exports.NodeType.TEXT_NODE) {
                     continue;
                 }
                 this.findCharacterReferences(node, child.textContent, child.location, {
@@ -8708,43 +8744,46 @@ class UnknownCharReference extends Rule {
             return elements.entities;
         }
     }
-    /* eslint-disable-next-line complexity */
     findCharacterReferences(node, text, location, { isAttribute }) {
-        const { requireSemicolon } = this.options;
         const isQuerystring = isAttribute && text.includes("?");
-        for (const { match, entity, raw, terminated } of this.getMatches(text)) {
-            /* assume numeric entities are valid for now */
-            if (isNumerical(entity)) {
-                continue;
-            }
-            /* special case: when attributes use query parameters we skip checking
-             * unterminated attributes */
-            if (isQuerystring && !terminated) {
-                continue;
-            }
-            const found = this.entities.includes(entity);
-            /* ignore if this is a known character reference name */
-            if (found && (terminated || !requireSemicolon)) {
-                continue;
-            }
-            if (found && !terminated) {
-                const entityLocation = getLocation(location, entity, match);
-                const message = `Character reference "{{ entity }}" must be terminated by a semicolon`;
-                const context = {
-                    entity: raw,
-                    terminated: false,
-                };
-                this.report(node, message, entityLocation, context);
-                continue;
-            }
+        for (const match of this.getMatches(text)) {
+            this.validateCharacterReference(node, location, match, { isQuerystring });
+        }
+    }
+    validateCharacterReference(node, location, foobar, { isQuerystring }) {
+        const { requireSemicolon } = this.options;
+        const { match, entity, raw, terminated } = foobar;
+        /* assume numeric entities are valid for now */
+        if (isNumerical(entity)) {
+            return;
+        }
+        /* special case: when attributes use query parameters we skip checking
+         * unterminated attributes */
+        if (isQuerystring && !terminated) {
+            return;
+        }
+        const found = this.entities.includes(entity);
+        /* ignore if this is a known character reference name */
+        if (found && (terminated || !requireSemicolon)) {
+            return;
+        }
+        if (found && !terminated) {
             const entityLocation = getLocation(location, entity, match);
-            const message = `Unrecognized character reference "{{ entity }}"`;
+            const message = `Character reference "{{ entity }}" must be terminated by a semicolon`;
             const context = {
                 entity: raw,
-                terminated: true,
+                terminated: false,
             };
             this.report(node, message, entityLocation, context);
+            return;
         }
+        const entityLocation = getLocation(location, entity, match);
+        const message = `Unrecognized character reference "{{ entity }}"`;
+        const context = {
+            entity: raw,
+            terminated: true,
+        };
+        this.report(node, message, entityLocation, context);
     }
     *getMatches(text) {
         let match;
@@ -9608,6 +9647,8 @@ const presets = {
 /**
  * A resolved configuration is a normalized configuration with all extends,
  * plugins etc resolved.
+ *
+ * @public
  */
 class ResolvedConfig {
     constructor({ metaTable, plugins, rules, transformers }) {
@@ -9853,7 +9894,7 @@ class Config {
      * Must be called before trying to use config. Can safely be called multiple
      * times.
      *
-     * @internal
+     * @public
      */
     init() {
         if (this.initialized) {
@@ -9873,7 +9914,7 @@ class Config {
      * Returns a new configuration as a merge of the two. Entries from the passed
      * object takes priority over this object.
      *
-     * @internal
+     * @public
      * @param rhs - Configuration to merge with this one.
      */
     merge(rhs) {
@@ -9900,7 +9941,7 @@ class Config {
     /**
      * Get element metadata.
      */
-    /* eslint-disable-next-line complexity, sonarjs/cognitive-complexity */
+    /* eslint-disable-next-line complexity, sonarjs/cognitive-complexity -- technical debt, should be refactored */
     getMetaTable() {
         /* use cached table if it exists */
         if (this.metaTable) {
@@ -10073,7 +10114,7 @@ class Config {
      * A resolved configuration will merge all extended configs and load all
      * plugins and transformers, and normalize the rest of the configuration.
      *
-     * @internal
+     * @public
      */
     resolve() {
         return new ResolvedConfig(this.resolveData());
@@ -10102,7 +10143,7 @@ class Config {
                     throw new ConfigError(`Transformer uses API version ${version} but only version ${TRANSFORMER_API.VERSION} is supported`);
                 }
                 return {
-                    // eslint-disable-next-line security/detect-non-literal-regexp
+                    // eslint-disable-next-line security/detect-non-literal-regexp -- expected to be a regexp
                     pattern: new RegExp(pattern),
                     name,
                     fn,
@@ -10207,6 +10248,9 @@ class Config {
         /* set global instance */
         rootDirCache = value;
     }
+    /**
+     * @internal
+     */
     findRootDir() {
         const cache = this.rootDirCache;
         if (cache !== null) {
@@ -10214,7 +10258,7 @@ class Config {
         }
         /* try to locate package.json */
         let current = process.cwd();
-        // eslint-disable-next-line no-constant-condition
+        // eslint-disable-next-line no-constant-condition -- break outs when filesystem is traversed
         while (true) {
             const search = path__default.default.join(current, "package.json");
             if (fs__default.default.existsSync(search)) {
@@ -10259,7 +10303,7 @@ class ConfigLoader {
 }
 
 /**
- * @internal
+ * @public
  */
 class EventHandler {
     constructor() {
@@ -10307,7 +10351,6 @@ class EventHandler {
      * @param event - Event name.
      * @param data - Event data.
      */
-    /* eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types */
     trigger(event, data) {
         var _a, _b;
         const callbacks = [...((_a = this.listeners[event]) !== null && _a !== void 0 ? _a : []), ...((_b = this.listeners["*"]) !== null && _b !== void 0 ? _b : [])];
@@ -10352,12 +10395,13 @@ function isValidDirective(action) {
 /**
  * Parse HTML document into a DOM tree.
  *
- * @internal
+ * @public
  */
 class Parser {
     /**
      * Create a new parser instance.
      *
+     * @public
      * @param config - Configuration
      */
     constructor(config) {
@@ -10369,6 +10413,7 @@ class Parser {
     /**
      * Parse HTML markup.
      *
+     * @public
      * @param source - HTML markup.
      * @returns DOM tree representing the HTML markup.
      */
@@ -10459,7 +10504,10 @@ class Parser {
             return Boolean(active.parent && active.parent.is(tagName) && meta.includes(active.tagName));
         }
     }
-    /* eslint-disable-next-line complexity */
+    /**
+     * @internal
+     */
+    /* eslint-disable-next-line complexity -- there isn't really a good other way to structure this method (that is still readable) */
     consume(source, token, tokenStream) {
         switch (token.type) {
             case TokenType.UNICODE_BOM:
@@ -10496,7 +10544,10 @@ class Parser {
                 break;
         }
     }
-    /* eslint-disable-next-line complexity, sonarjs/cognitive-complexity */
+    /**
+     * @internal
+     */
+    /* eslint-disable-next-line complexity, sonarjs/cognitive-complexity -- technical debt, chould be refactored a bit */
     consumeTag(source, startToken, tokenStream) {
         const tokens = Array.from(this.consumeUntil(tokenStream, TokenType.TAG_CLOSE, startToken.location));
         const endToken = tokens.slice(-1)[0];
@@ -10561,6 +10612,9 @@ class Parser {
             this.discardForeignBody(source, node.tagName, tokenStream, startToken.location);
         }
     }
+    /**
+     * @internal
+     */
     closeElement(source, node, active, location) {
         /* call processElement hook */
         this.processElement(active, source);
@@ -10596,6 +10650,8 @@ class Parser {
     }
     /**
      * Discard tokens until the end tag for the foreign element is found.
+     *
+     * @internal
      */
     discardForeignBody(source, foreignTagName, tokenStream, errorLocation) {
         /* consume elements until the end tag for this foreign element is found */
@@ -10644,6 +10700,9 @@ class Parser {
         this.closeElement(source, node, active, endToken.location);
         this.dom.popActive();
     }
+    /**
+     * @internal
+     */
     consumeAttribute(source, node, token, next) {
         const keyLocation = this.getAttributeKeyLocation(token);
         const valueLocation = this.getAttributeValueLocation(next);
@@ -10734,6 +10793,9 @@ class Parser {
             offset: begin.offset,
         };
     }
+    /**
+     * @internal
+     */
     consumeDirective(token) {
         const [text, preamble, action, separator1, directive, postamble] = token.data;
         if (!postamble.startsWith("]")) {
@@ -10779,6 +10841,8 @@ class Parser {
      * Consumes conditional comment in tag form.
      *
      * See also the related [[consumeCommend]] method.
+     *
+     * @internal
      */
     consumeConditional(token) {
         const element = this.dom.getActive();
@@ -10793,6 +10857,8 @@ class Parser {
      *
      * Tries to find IE conditional comments and emits conditional token if
      * found. See also the related [[consumeConditional]] method.
+     *
+     * @internal
      */
     consumeComment(token) {
         const comment = token.data[0];
@@ -10807,6 +10873,8 @@ class Parser {
     }
     /**
      * Consumes doctype tokens. Emits doctype event.
+     *
+     * @internal
      */
     consumeDoctype(startToken, tokenStream) {
         const tokens = Array.from(this.consumeUntil(tokenStream, TokenType.DOCTYPE_CLOSE, startToken.location));
@@ -10824,6 +10892,7 @@ class Parser {
     /**
      * Return a list of tokens found until the expected token was found.
      *
+     * @internal
      * @param errorLocation - What location to use if an error occurs
      */
     *consumeUntil(tokenStream, search, errorLocation) {
@@ -10888,6 +10957,7 @@ class Parser {
     /**
      * Defer execution. Will call function sometime later.
      *
+     * @internal
      * @param cb - Callback to execute later.
      */
     defer(cb) {
@@ -10930,7 +11000,7 @@ function freeze(src) {
     };
 }
 /**
- * @internal
+ * @public
  */
 class Reporter {
     constructor() {
@@ -11122,7 +11192,6 @@ class Engine {
             };
             parser.trigger("config:ready", configEvent);
             /* trigger source ready event */
-            /* eslint-disable-next-line @typescript-eslint/no-unused-vars -- object destructured on purpose to remove property */
             const { hooks: _, ...sourceData } = source;
             const sourceEvent = {
                 location,
@@ -11217,8 +11286,7 @@ class Engine {
     /**
      * Get rule documentation.
      */
-    getRuleDocumentation(ruleId, context // eslint-disable-line @typescript-eslint/explicit-module-boundary-types
-    ) {
+    getRuleDocumentation(ruleId, context) {
         const rules = this.config.getRules();
         const ruleData = rules.get(ruleId);
         if (ruleData) {
@@ -11744,7 +11812,7 @@ class HtmlValidate {
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "7.14.0";
+const version = "7.15.1";
 /** @public */
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
@@ -11761,7 +11829,7 @@ const defaults$1 = {
     silent: false,
     version,
     logger(text) {
-        /* eslint-disable-next-line no-console */
+        /* eslint-disable-next-line no-console -- expected to log */
         console.error(kleur__default.default.red(text));
     },
 };
@@ -11906,7 +11974,7 @@ class FileSystemConfigLoader extends ConfigLoader {
         let found = false;
         let current = path__default.default.resolve(path__default.default.dirname(filename));
         let config = this.empty();
-        // eslint-disable-next-line no-constant-condition
+        // eslint-disable-next-line no-constant-condition -- it will break out when filesystem is traversed
         while (true) {
             /* search configuration files in current directory */
             for (const configFile of findConfigurationFiles(current)) {
@@ -11985,7 +12053,7 @@ function checkstyleFormatter(results) {
     output += "</checkstyle>\n";
     return output;
 }
-const formatter$4 = checkstyleFormatter;
+const formatter$3 = checkstyleFormatter;
 
 const defaults = {
     showLink: true,
@@ -12116,7 +12184,6 @@ function codeframe(results, options) {
     }
     return errors + warnings > 0 ? output : "";
 }
-const formatter$3 = codeframe;
 
 function jsonFormatter(results) {
     return JSON.stringify(results);
@@ -12176,8 +12243,8 @@ function textFormatter(results) {
 const formatter = textFormatter;
 
 const availableFormatters = {
-    checkstyle: formatter$4,
-    codeframe: formatter$3,
+    checkstyle: formatter$3,
+    codeframe,
     json: formatter$2,
     stylish: formatter$1,
     text: formatter,
@@ -12191,6 +12258,9 @@ exports.Attribute = Attribute;
 exports.Config = Config;
 exports.ConfigError = ConfigError;
 exports.ConfigLoader = ConfigLoader;
+exports.DOMNode = DOMNode;
+exports.DOMTokenList = DOMTokenList;
+exports.DOMTree = DOMTree;
 exports.DynamicValue = DynamicValue;
 exports.EventHandler = EventHandler;
 exports.FileSystemConfigLoader = FileSystemConfigLoader;
@@ -12201,6 +12271,7 @@ exports.MetaTable = MetaTable;
 exports.NestedError = NestedError;
 exports.Parser = Parser;
 exports.Reporter = Reporter;
+exports.ResolvedConfig = ResolvedConfig;
 exports.Rule = Rule;
 exports.SchemaValidationError = SchemaValidationError;
 exports.StaticConfigLoader = StaticConfigLoader;