html-validate 7.14.0 → 7.15.1

package/dist/es/core.js

@@ -261,6 +261,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 {
     /**
@@ -374,7 +376,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;
 }
@@ -443,6 +445,9 @@ class Context {
     }
 }
 
+/**
+ * @public
+ */
 var TextContent$1;
 (function (TextContent) {
     /* forbid node to have text content, inter-element whitespace is ignored */
@@ -487,6 +492,9 @@ function setMetaProperty(dst, key, value) {
     dst[key] = value;
 }
 
+/**
+ * @public
+ */
 var NodeType;
 (function (NodeType) {
     NodeType[NodeType["ELEMENT_NODE"] = 1] = "ELEMENT_NODE";
@@ -497,6 +505,9 @@ var NodeType;
 const DOCUMENT_NODE_NAME = "#document";
 const TEXT_CONTENT = Symbol("textContent");
 let counter = 0;
+/**
+ * @public
+ */
 class DOMNode {
     /**
      * Create a new DOMNode.
@@ -520,6 +531,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();
@@ -569,6 +582,8 @@ class DOMNode {
     }
     /**
      * Tests if two nodes are the same (references the same object).
+     *
+     * @since v4.11.0
      */
     isSameNode(otherNode) {
         return this.unique === otherNode.unique;
@@ -694,6 +709,9 @@ function parse(text, baseLocation) {
     }
     return { tokens, locations };
 }
+/**
+ * @public
+ */
 class DOMTokenList extends Array {
     constructor(value, location) {
         if (value && typeof value === "string") {
@@ -730,7 +748,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 */
@@ -1249,7 +1267,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)) {
@@ -1270,11 +1288,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) {
@@ -1358,7 +1376,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;
@@ -1507,9 +1525,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);
@@ -1603,6 +1626,9 @@ function isClosed(endToken, meta) {
     return closed;
 }
 
+/**
+ * @public
+ */
 class DOMTree {
     constructor(location) {
         this.root = HtmlElement.rootNode(location);
@@ -1681,6 +1707,9 @@ function ensureError(value) {
     }
 }
 
+/**
+ * @public
+ */
 class NestedError extends Error {
     constructor(message, nested) {
         super(message);
@@ -2447,7 +2476,7 @@ class MetaTable {
     /**
      * Extend validation schema.
      *
-     * @internal
+     * @public
      */
     extendValidationSchema(patch) {
         if (patch.properties) {
@@ -2468,7 +2497,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
      */
@@ -2489,7 +2518,7 @@ class MetaTable {
     /**
      * Load metadata table from filename
      *
-     * @internal
+     * @public
      * @param filename - Filename to load
      */
     loadFromFile(filename) {
@@ -2652,7 +2681,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 {
@@ -2853,7 +2882,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) {
@@ -2944,7 +2972,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 */
@@ -3151,7 +3179,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 = "";
@@ -3372,7 +3401,7 @@ function parseSeverity(value) {
             return 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 Severity.DISABLED;
         case 1:
@@ -3483,8 +3512,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.
@@ -3495,7 +3524,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
      */
@@ -3713,12 +3742,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,
@@ -3732,18 +3769,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 */
@@ -3809,19 +3846,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;
             }
@@ -3839,21 +3876,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) {
@@ -4191,6 +4228,9 @@ class AttrCase extends Rule {
     }
 }
 
+/**
+ * @internal
+ */
 var TokenType;
 (function (TokenType) {
     TokenType[TokenType["UNICODE_BOM"] = 1] = "UNICODE_BOM";
@@ -4212,7 +4252,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;
@@ -4237,6 +4277,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);
@@ -4244,7 +4285,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 */
@@ -4378,7 +4419,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) {
@@ -4475,11 +4515,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");
     }
 }
@@ -5029,7 +5069,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);
     }
 }
@@ -5445,7 +5485,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() {
@@ -6453,7 +6493,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"]],
@@ -8269,11 +8309,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()];
@@ -8282,15 +8322,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;
@@ -8676,43 +8712,46 @@ class UnknownCharReference extends Rule {
             return entities$1;
         }
     }
-    /* 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;
@@ -9576,6 +9615,8 @@ const presets = {
 /**
  * A resolved configuration is a normalized configuration with all extends,
  * plugins etc resolved.
+ *
+ * @public
  */
 class ResolvedConfig {
     constructor({ metaTable, plugins, rules, transformers }) {
@@ -9821,7 +9862,7 @@ class Config {
      * Must be called before trying to use config. Can safely be called multiple
      * times.
      *
-     * @internal
+     * @public
      */
     init() {
         if (this.initialized) {
@@ -9841,7 +9882,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) {
@@ -9868,7 +9909,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) {
@@ -10041,7 +10082,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());
@@ -10070,7 +10111,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,
@@ -10175,6 +10216,9 @@ class Config {
         /* set global instance */
         rootDirCache = value;
     }
+    /**
+     * @internal
+     */
     findRootDir() {
         const cache = this.rootDirCache;
         if (cache !== null) {
@@ -10182,7 +10226,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.join(current, "package.json");
             if (fs.existsSync(search)) {
@@ -10227,7 +10271,7 @@ class ConfigLoader {
 }
 
 /**
- * @internal
+ * @public
  */
 class EventHandler {
     constructor() {
@@ -10275,7 +10319,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 : [])];
@@ -10320,12 +10363,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) {
@@ -10337,6 +10381,7 @@ class Parser {
     /**
      * Parse HTML markup.
      *
+     * @public
      * @param source - HTML markup.
      * @returns DOM tree representing the HTML markup.
      */
@@ -10427,7 +10472,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:
@@ -10464,7 +10512,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];
@@ -10529,6 +10580,9 @@ class Parser {
             this.discardForeignBody(source, node.tagName, tokenStream, startToken.location);
         }
     }
+    /**
+     * @internal
+     */
     closeElement(source, node, active, location) {
         /* call processElement hook */
         this.processElement(active, source);
@@ -10564,6 +10618,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 */
@@ -10612,6 +10668,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);
@@ -10702,6 +10761,9 @@ class Parser {
             offset: begin.offset,
         };
     }
+    /**
+     * @internal
+     */
     consumeDirective(token) {
         const [text, preamble, action, separator1, directive, postamble] = token.data;
         if (!postamble.startsWith("]")) {
@@ -10747,6 +10809,8 @@ class Parser {
      * Consumes conditional comment in tag form.
      *
      * See also the related [[consumeCommend]] method.
+     *
+     * @internal
      */
     consumeConditional(token) {
         const element = this.dom.getActive();
@@ -10761,6 +10825,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];
@@ -10775,6 +10841,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));
@@ -10792,6 +10860,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) {
@@ -10856,6 +10925,7 @@ class Parser {
     /**
      * Defer execution. Will call function sometime later.
      *
+     * @internal
      * @param cb - Callback to execute later.
      */
     defer(cb) {
@@ -10898,7 +10968,7 @@ function freeze(src) {
     };
 }
 /**
- * @internal
+ * @public
  */
 class Reporter {
     constructor() {
@@ -11090,7 +11160,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,
@@ -11185,8 +11254,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) {
@@ -11712,7 +11780,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";
 
@@ -11729,7 +11797,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.red(text));
     },
 };
@@ -11874,7 +11942,7 @@ class FileSystemConfigLoader extends ConfigLoader {
         let found = false;
         let current = path.resolve(path.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)) {
@@ -11953,7 +12021,7 @@ function checkstyleFormatter(results) {
     output += "</checkstyle>\n";
     return output;
 }
-const formatter$4 = checkstyleFormatter;
+const formatter$3 = checkstyleFormatter;
 
 const defaults = {
     showLink: true,
@@ -12084,7 +12152,6 @@ function codeframe(results, options) {
     }
     return errors + warnings > 0 ? output : "";
 }
-const formatter$3 = codeframe;
 
 function jsonFormatter(results) {
     return JSON.stringify(results);
@@ -12144,8 +12211,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,
@@ -12155,5 +12222,5 @@ function getFormatter(name) {
     return (_a = availableFormatters[name]) !== null && _a !== void 0 ? _a : null;
 }
 
-export { Attribute as A, Config as C, DynamicValue as D, EventHandler as E, FileSystemConfigLoader as F, HtmlValidate as H, MetaTable as M, NodeClosed as N, Parser as P, Rule as R, Severity as S, TextNode as T, UserError as U, Validator as V, WrappedError as W, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, HtmlElement as d, SchemaValidationError as e, NestedError as f, MetaCopyableProperty as g, Reporter as h, TemplateExtractor as i, definePlugin as j, getFormatter as k, legacyRequire as l, ensureError as m, configDataFromFile as n, compatibilityCheck as o, presets as p, codeframe as q, ruleExists as r, sliceLocation as s, isTextNode as t, isElementNode as u, version as v, generateIdSelector as w, name as x, bugs as y };
+export { Attribute as A, isTextNode as B, Config as C, DynamicValue as D, EventHandler as E, FileSystemConfigLoader as F, isElementNode as G, HtmlValidate as H, generateIdSelector as I, name as J, bugs as K, MetaTable as M, NodeClosed as N, Parser as P, ResolvedConfig as R, Severity as S, TextNode as T, UserError as U, Validator as V, WrappedError as W, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, DOMTokenList as d, HtmlElement as e, DOMNode as f, DOMTree as g, NodeType as h, SchemaValidationError as i, NestedError as j, TextContent$1 as k, MetaCopyableProperty as l, Rule as m, Reporter as n, TemplateExtractor as o, presets as p, definePlugin as q, ruleExists as r, sliceLocation as s, getFormatter as t, legacyRequire as u, version as v, ensureError as w, configDataFromFile as x, compatibilityCheck as y, codeframe as z };
 //# sourceMappingURL=core.js.map