html-validate 8.1.0 → 8.3.0

package/dist/es/core.js

@@ -284,7 +284,7 @@ class NestedError extends Error {
         super(message);
         Error.captureStackTrace(this, NestedError);
         this.name = NestedError.name;
-        if (nested && nested.stack) {
+        if (nested === null || nested === void 0 ? void 0 : nested.stack) {
             this.stack += `\nCaused by: ${nested.stack}`;
         }
     }
@@ -1019,7 +1019,8 @@ function hasAttribute(node, attr) {
  * Matches attribute against value.
  */
 function matchAttribute(node, key, op, value) {
-    const nodeValue = (node.getAttributeValue(key) || "").toLowerCase();
+    var _a;
+    const nodeValue = ((_a = node.getAttributeValue(key)) !== null && _a !== void 0 ? _a : "").toLowerCase();
     switch (op) {
         case "!=":
             return nodeValue !== value;
@@ -1381,6 +1382,16 @@ class Attribute {
     get isDynamic() {
         return this.value instanceof DynamicValue;
     }
+    /**
+     * Test attribute value.
+     *
+     * @param pattern - Pattern to match value against. Can be a RegExp, literal
+     * string or an array of strings (returns true if any value matches the
+     * array).
+     * @param dynamicMatches - If true `DynamicValue` will always match, if false
+     * it never matches.
+     * @returns `true` if attribute value matches pattern.
+     */
     valueMatches(pattern, dynamicMatches = true) {
         if (this.value === null) {
             return false;
@@ -1766,7 +1777,7 @@ class DOMTokenList extends Array {
             this.value = value.expr;
         }
         else {
-            this.value = value || "";
+            this.value = value !== null && value !== void 0 ? value : "";
         }
     }
     item(n) {
@@ -1991,7 +2002,7 @@ class IdMatcher extends Matcher {
 class AttrMatcher extends Matcher {
     constructor(attr) {
         super();
-        const [, key, op, value] = attr.match(/^(.+?)(?:([~^$*|]?=)"([^"]+?)")?$/);
+        const [, key, op, value] = attr.match(/^(.+?)(?:([~^$*|]?=)"([^"]+?)")?$/); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- will always match
         this.key = key;
         this.op = op;
         this.value = value;
@@ -2028,11 +2039,11 @@ class PseudoClassMatcher extends Matcher {
 }
 class Pattern {
     constructor(pattern) {
-        const match = pattern.match(/^([~+\->]?)((?:[*]|[^.#[:]+)?)(.*)$/);
+        const match = pattern.match(/^([~+\->]?)((?:[*]|[^.#[:]+)?)(.*)$/); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- will always match
         match.shift(); /* remove full matched string */
         this.selector = pattern;
         this.combinator = parseCombinator(match.shift(), pattern);
-        this.tagName = match.shift() || "*";
+        this.tagName = match.shift() || "*"; // eslint-disable-line @typescript-eslint/prefer-nullish-coalescing -- empty string */
         this.pattern = Array.from(splitPattern(match[0]), (it) => this.createMatcher(it));
     }
     match(node, context) {
@@ -2206,6 +2217,21 @@ function isElementNode(node) {
 function isValidTagName(tagName) {
     return Boolean(tagName !== "" && tagName !== "*");
 }
+function createAdapter(node) {
+    return {
+        closest(selectors) {
+            var _a;
+            return (_a = node.closest(selectors)) === null || _a === void 0 ? void 0 : _a._adapter;
+        },
+        getAttribute(name) {
+            var _a;
+            return (_a = node.getAttribute(name)) === null || _a === void 0 ? void 0 : _a.value;
+        },
+        hasAttribute(name) {
+            return node.hasAttribute(name);
+        },
+    };
+}
 /**
  * @public
  */
@@ -2214,9 +2240,9 @@ class HtmlElement extends DOMNode {
         const nodeType = tagName ? NodeType.ELEMENT_NODE : NodeType.DOCUMENT_NODE;
         super(nodeType, tagName, location);
         if (!isValidTagName(tagName)) {
-            throw new Error(`The tag name provided ('${tagName || ""}') is not a valid name`);
+            throw new Error(`The tag name provided ('${tagName !== null && tagName !== void 0 ? tagName : ""}') is not a valid name`);
         }
-        this.tagName = tagName || "#document";
+        this.tagName = tagName !== null && tagName !== void 0 ? tagName : "#document";
         this.parent = parent !== null && parent !== void 0 ? parent : null;
         this.attr = {};
         this.metaElement = meta !== null && meta !== void 0 ? meta : null;
@@ -2224,6 +2250,7 @@ class HtmlElement extends DOMNode {
         this.voidElement = meta ? Boolean(meta.void) : false;
         this.depth = 0;
         this.annotation = null;
+        this._adapter = createAdapter(this);
         if (parent) {
             parent.childNodes.push(this);
             /* calculate depth in domtree */
@@ -2283,7 +2310,7 @@ class HtmlElement extends DOMNode {
      */
     get ariaLabelledby() {
         const attr = this.getAttribute("aria-labelledby");
-        if (!attr || !attr.value) {
+        if (!(attr === null || attr === void 0 ? void 0 : attr.value)) {
             return null;
         }
         if (attr.value instanceof DynamicValue) {
@@ -2401,6 +2428,7 @@ class HtmlElement extends DOMNode {
                 setMetaProperty(this.metaElement, key, value);
             }
             else {
+                /* eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- technical debt */
                 delete this.metaElement[key];
             }
         }
@@ -2676,11 +2704,12 @@ class DOMTree {
         this.active = node;
     }
     popActive() {
+        var _a;
         if (this.active.isRootElement()) {
             /* root element should never be popped, continue as if nothing happened */
             return;
         }
-        this.active = this.active.parent || this.root;
+        this.active = (_a = this.active.parent) !== null && _a !== void 0 ? _a : this.root;
     }
     getActive() {
         return this.active;
@@ -2716,6 +2745,7 @@ const allowedKeys = ["exclude"];
  *
  * @public
  */
+/* eslint-disable-next-line @typescript-eslint/no-extraneous-class -- technical debt, should probably be plain functions maybe in an object */
 class Validator {
     /**
      * Test if element is used in a proper context.
@@ -2757,7 +2787,7 @@ class Validator {
                 return false;
             }
             // Check if the rule has a quantifier
-            const [, category, quantifier] = rule.match(/^(@?.*?)([?*]?)$/);
+            const [, category, quantifier] = rule.match(/^(@?.*?)([?*]?)$/); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- will always match
             const limit = category && quantifier && parseQuantifier(quantifier);
             if (limit) {
                 const siblings = children.filter((cur) => Validator.validatePermittedCategory(cur, rule, true));
@@ -2803,6 +2833,7 @@ class Validator {
                  * In both of these cases no error should be reported. */
                 const orderSpecified = rules.find((cur) => Validator.validatePermittedCategory(node, cur, true));
                 if (orderSpecified) {
+                    /* eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- technical debt, should never happen */
                     cb(node, prev);
                     return false;
                 }
@@ -2943,7 +2974,7 @@ class Validator {
      */
     /* eslint-disable-next-line complexity -- rule does not like switch */
     static validatePermittedCategory(node, category, defaultMatch) {
-        const [, rawCategory] = category.match(/^(@?.*?)([?*]?)$/);
+        const [, rawCategory] = category.match(/^(@?.*?)([?*]?)$/); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- will always match
         /* match tagName when an explicit name is given */
         if (!rawCategory.startsWith("@")) {
             return node.tagName === rawCategory;
@@ -2968,9 +2999,9 @@ class Validator {
             case "@interactive":
                 return node.meta.interactive;
             case "@script":
-                return node.meta.scriptSupporting;
+                return Boolean(node.meta.scriptSupporting);
             case "@form":
-                return node.meta.form;
+                return Boolean(node.meta.form);
             default:
                 throw new Error(`Invalid content category "${category}"`);
         }
@@ -3155,10 +3186,12 @@ var configurationSchema = {
 	properties: properties
 };
 
-var TRANSFORMER_API;
-(function (TRANSFORMER_API) {
-    TRANSFORMER_API[TRANSFORMER_API["VERSION"] = 1] = "VERSION";
-})(TRANSFORMER_API || (TRANSFORMER_API = {}));
+/**
+ * @internal
+ */
+const TRANSFORMER_API = {
+    VERSION: 1,
+};
 
 /**
  * @public
@@ -3405,7 +3438,7 @@ function classifyNodeText(node, options = {}) {
     const { accessible = false, ignoreHiddenRoot = false } = options;
     const cacheKey = getCachekey(options);
     if (node.cacheExists(cacheKey)) {
-        return node.cacheGet(cacheKey);
+        return node.cacheGet(cacheKey); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- has/get combo
     }
     if (!ignoreHiddenRoot && isHTMLHidden(node)) {
         return node.cacheSet(cacheKey, TextClassification.EMPTY_TEXT);
@@ -3453,8 +3486,12 @@ function findTextNodes(node, options) {
 
 function hasAltText(image) {
     const alt = image.getAttribute("alt");
-    /* missing or boolean */
-    if (alt === null || alt.value === null) {
+    /* missing attribute */
+    if (!alt) {
+        return false;
+    }
+    /* (incorrectly) set as boolean value */
+    if (alt.value === null) {
         return false;
     }
     return alt.isDynamic || alt.value.toString() !== "";
@@ -3462,8 +3499,12 @@ function hasAltText(image) {
 
 function hasAriaLabel(node) {
     const label = node.getAttribute("aria-label");
-    /* missing or boolean */
-    if (label === null || label.value === null) {
+    /* missing attribute */
+    if (!label) {
+        return false;
+    }
+    /* (incorrectly) set as boolean value */
+    if (label.value === null) {
         return false;
     }
     return label.isDynamic || label.value.toString() !== "";
@@ -3544,7 +3585,7 @@ class Rule {
         this.options = options;
         this.enabled = true;
         this.blockers = [];
-        this.severity = 0;
+        this.severity = Severity.DISABLED;
         this.name = "";
     }
     getSeverity() {
@@ -3697,13 +3738,14 @@ class Rule {
         }
     }
     findLocation(src) {
+        var _a, _b;
         if (src.location) {
             return src.location;
         }
-        if (src.event && src.event.location) {
+        if ((_a = src.event) === null || _a === void 0 ? void 0 : _a.location) {
             return src.event.location;
         }
-        if (src.node && src.node.location) {
+        if ((_b = src.node) === null || _b === void 0 ? void 0 : _b.location) {
             return src.node.location;
         }
         return {};
@@ -3876,7 +3918,8 @@ class AllowedLinks extends Rule {
         };
     }
     documentation(context) {
-        const message = description[context] || "This link type is not allowed by current configuration";
+        var _a;
+        const message = (_a = description[context]) !== null && _a !== void 0 ? _a : "This link type is not allowed by current configuration";
         return {
             description: message,
             url: "https://html-validate.org/rules/allowed-links.html",
@@ -4140,7 +4183,7 @@ function isValidUsage(target, meta) {
         return true;
     }
     /* interactive and labelable elements are valid */
-    if (meta.interactive || meta.labelable) {
+    if (Boolean(meta.interactive) || Boolean(meta.labelable)) {
         return true;
     }
     return false;
@@ -4175,7 +4218,7 @@ class AriaLabelMisuse extends Rule {
     }
     validateElement(target) {
         const attr = target.getAttribute("aria-label");
-        if (!attr || !attr.value || attr.valueMatches("", false)) {
+        if (!(attr === null || attr === void 0 ? void 0 : attr.value) || attr.valueMatches("", false)) {
             return;
         }
         /* ignore elements without meta */
@@ -4906,7 +4949,7 @@ class AttributeAllowedValues extends Rule {
                 const meta = node.meta;
                 /* ignore rule if element has no meta or meta does not specify attribute
                  * allowed values */
-                if (!meta || !meta.attributes)
+                if (!(meta === null || meta === void 0 ? void 0 : meta.attributes))
                     return;
                 for (const attr of node.attributes) {
                     if (Validator.validateAttribute(attr, meta.attributes)) {
@@ -4974,7 +5017,7 @@ class AttributeBooleanStyle extends Rule {
                 const meta = node.meta;
                 /* ignore rule if element has no meta or meta does not specify attribute
                  * allowed values */
-                if (!meta || !meta.attributes)
+                if (!(meta === null || meta === void 0 ? void 0 : meta.attributes))
                     return;
                 /* check all boolean attributes */
                 for (const attr of node.attributes) {
@@ -5055,7 +5098,7 @@ class AttributeEmptyStyle extends Rule {
                 const meta = node.meta;
                 /* ignore rule if element has no meta or meta does not specify attribute
                  * allowed values */
-                if (!meta || !meta.attributes)
+                if (!(meta === null || meta === void 0 ? void 0 : meta.attributes))
                     return;
                 /* check all boolean attributes */
                 for (const attr of node.attributes) {
@@ -5143,10 +5186,10 @@ class AttributeMisuse extends Rule {
         });
     }
     validateAttr(node, attr, meta) {
-        if (!meta || !meta.allowed) {
+        if (!(meta === null || meta === void 0 ? void 0 : meta.allowed)) {
             return;
         }
-        const details = meta.allowed(node, attr);
+        const details = meta.allowed(node._adapter, attr.value);
         if (details) {
             this.report({
                 node,
@@ -5817,7 +5860,7 @@ class ElementPermittedOccurrences extends Rule {
         this.on("dom:ready", (event) => {
             const doc = event.document;
             doc.visitDepthFirst((node) => {
-                if (!node || !node.meta) {
+                if (!(node === null || node === void 0 ? void 0 : node.meta)) {
                     return;
                 }
                 const rules = node.meta.permittedContent;
@@ -6022,7 +6065,7 @@ class ElementRequiredAttributes extends Rule {
             const node = event.previous;
             const meta = node.meta;
             /* handle missing metadata and missing attributes */
-            if (!meta || !meta.attributes) {
+            if (!(meta === null || meta === void 0 ? void 0 : meta.attributes)) {
                 return;
             }
             for (const [key, attr] of Object.entries(meta.attributes)) {
@@ -6334,7 +6377,7 @@ class FormDupName extends Rule {
         const meta = this.getMetaFor(tagName);
         /* istanbul ignore if: the earlier check for getTagsWithProperty ensures
          * these will actually be set so this is just an untestable fallback */
-        if (!meta || !meta.formAssociated) {
+        if (!(meta === null || meta === void 0 ? void 0 : meta.formAssociated)) {
             return false;
         }
         return meta.formAssociated.listed;
@@ -6368,7 +6411,7 @@ const defaults$h = {
     minInitialRank: "h1",
     sectioningRoots: ["dialog", '[role="dialog"]', '[role="alertdialog"]'],
 };
-function isRelevant$3(event) {
+function isRelevant$4(event) {
     const node = event.target;
     return Boolean(node.meta && node.meta.heading);
 }
@@ -6436,7 +6479,7 @@ class HeadingLevel extends Rule {
         };
     }
     setup() {
-        this.on("tag:start", isRelevant$3, (event) => {
+        this.on("tag:start", isRelevant$4, (event) => {
             this.onTagStart(event);
         });
         this.on("tag:ready", (event) => {
@@ -6582,7 +6625,7 @@ class IdPattern extends Rule {
     }
     setup() {
         this.on("attr", (event) => {
-            var _a;
+            var _a, _b;
             if (event.key.toLowerCase() !== "id") {
                 return;
             }
@@ -6590,8 +6633,8 @@ class IdPattern extends Rule {
             if (event.value instanceof DynamicValue) {
                 return;
             }
-            if (!event.value || !event.value.match(this.pattern)) {
-                const value = (_a = event.value) !== null && _a !== void 0 ? _a : "";
+            if (!((_a = event.value) === null || _a === void 0 ? void 0 : _a.match(this.pattern))) {
+                const value = (_b = event.value) !== null && _b !== void 0 ? _b : "";
                 const pattern = this.pattern.toString();
                 const message = `ID "${value}" does not match required pattern "${pattern}"`;
                 this.report(event.target, message, event.valueLocation);
@@ -7019,7 +7062,7 @@ class MetaRefresh extends Rule {
             }
             /* ensure content attribute is set */
             const content = target.getAttribute("content");
-            if (!content || !content.value || content.isDynamic) {
+            if (!(content === null || content === void 0 ? void 0 : content.value) || content.isDynamic) {
                 return;
             }
             /* ensure content attribute is valid */
@@ -7096,7 +7139,7 @@ class MapDupName extends Rule {
     }
 }
 
-function isRelevant$2(event) {
+function isRelevant$3(event) {
     return event.target.is("map");
 }
 function hasStaticValue(attr) {
@@ -7110,7 +7153,7 @@ class MapIdName extends Rule {
         };
     }
     setup() {
-        this.on("tag:ready", isRelevant$2, (event) => {
+        this.on("tag:ready", isRelevant$3, (event) => {
             var _a;
             const { target } = event;
             const id = target.getAttribute("id");
@@ -7298,7 +7341,7 @@ class NoDeprecatedAttr extends Rule {
             if (meta === null) {
                 return;
             }
-            const metaAttribute = meta.attributes && meta.attributes[attr];
+            const metaAttribute = meta.attributes[attr];
             if (!metaAttribute) {
                 return;
             }
@@ -7374,11 +7417,11 @@ class NoDupID extends Rule {
             const { document } = event;
             const existing = new Set();
             const elements = document.querySelectorAll("[id]");
-            const relevant = elements.filter(isRelevant$1);
+            const relevant = elements.filter(isRelevant$2);
             for (const el of relevant) {
                 const attr = el.getAttribute("id");
                 /* istanbul ignore next: this has already been tested in isRelevant once but for type-safety it is checked again */
-                if (!attr || !attr.value) {
+                if (!(attr === null || attr === void 0 ? void 0 : attr.value)) {
                     continue;
                 }
                 const id = attr.value.toString();
@@ -7390,7 +7433,7 @@ class NoDupID extends Rule {
         });
     }
 }
-function isRelevant$1(element) {
+function isRelevant$2(element) {
     const attr = element.getAttribute("id");
     /* istanbul ignore next: can not really happen as querySelector will only return elements with id present */
     if (!attr) {
@@ -7407,6 +7450,41 @@ function isRelevant$1(element) {
     return true;
 }
 
+function isRelevant$1(event) {
+    return event.target.is("button");
+}
+class NoImplicitButtonType extends Rule {
+    documentation() {
+        return {
+            description: [
+                "`<button>` is missing required `type` attribute",
+                "",
+                "When the `type` attribute is omitted it defaults to `submit`.",
+                "Submit buttons are triggered when a keyboard user presses <kbd>Enter</kbd>.",
+                "",
+                "As this may or may not be inteded this rule enforces that the `type` attribute be explicitly set to one of the valid types:",
+                "",
+                "- `button` - a generic button.",
+                "- `submit` - a submit button.",
+                "- `reset`- a button to reset form fields.",
+            ].join("\n"),
+            url: "https://html-validate.org/rules/no-implicit-button-type.html",
+        };
+    }
+    setup() {
+        this.on("element:ready", isRelevant$1, (event) => {
+            const { target } = event;
+            const attr = target.getAttribute("type");
+            if (!attr) {
+                this.report({
+                    node: event.target,
+                    message: `<button> is missing required "type" attribute`,
+                });
+            }
+        });
+    }
+}
+
 class NoImplicitClose extends Rule {
     documentation() {
         return {
@@ -7512,11 +7590,12 @@ class NoInlineStyle extends Rule {
         });
     }
     isRelevant(event) {
+        var _a;
         if (event.key !== "style") {
             return false;
         }
         const { include, exclude } = this.options;
-        const key = event.originalAttribute || event.key;
+        const key = (_a = event.originalAttribute) !== null && _a !== void 0 ? _a : event.key;
         /* ignore attributes not present in "include" */
         if (include && !include.includes(key)) {
             return false;
@@ -7710,7 +7789,8 @@ class NoRawCharacters extends Rule {
             if (event.quote) {
                 return;
             }
-            this.findRawChars(event.target, event.value.toString(), event.valueLocation, unquotedAttrRegexp);
+            this.findRawChars(event.target, event.value.toString(), event.valueLocation, // eslint-disable-line @typescript-eslint/no-non-null-assertion -- technical debt, valueLocation is always set if a value is provided
+            unquotedAttrRegexp);
         });
     }
     /**
@@ -7924,7 +8004,7 @@ class NoSelfClosing extends Rule {
 function isRelevant(node, options) {
     /* tags in XML namespaces are relevant only if ignoreXml is false, in which
      * case assume all xml elements must not be self-closed */
-    if (node.tagName && node.tagName.match(xmlns)) {
+    if (node.tagName.match(xmlns)) {
         return !options.ignoreXML;
     }
     /* nodes with missing metadata is assumed relevant */
@@ -8130,16 +8210,12 @@ class PreferButton extends Rule {
         };
     }
     documentation(context) {
-        const doc = {
-            description: `Prefer to use the generic \`<button>\` element instead of \`<input>\`.`,
+        const src = `<input type="${context.type}">`;
+        const dst = replacement[context.type] || `<button>`;
+        return {
+            description: `Prefer to use \`${dst}\` instead of \`"${src}\`.`,
             url: "https://html-validate.org/rules/prefer-button.html",
         };
-        if (context) {
-            const src = `<input type="${context.type}">`;
-            const dst = replacement[context.type] || `<button>`;
-            doc.description = `Prefer to use \`${dst}\` instead of \`"${src}\`.`;
-        }
-        return doc;
     }
     setup() {
         this.on("attr", (event) => {
@@ -8238,14 +8314,10 @@ class PreferNativeElement extends Rule {
         };
     }
     documentation(context) {
-        const doc = {
-            description: `Instead of using WAI-ARIA roles prefer to use the native HTML elements.`,
+        return {
+            description: `Instead of using the WAI-ARIA role "${context.role}" prefer to use the native <${context.replacement}> element.`,
             url: "https://html-validate.org/rules/prefer-native-element.html",
         };
-        if (context) {
-            doc.description = `Instead of using the WAI-ARIA role "${context.role}" prefer to use the native <${context.replacement}> element.`;
-        }
-        return doc;
     }
     setup() {
         const { mapping } = this.options;
@@ -8286,7 +8358,7 @@ class PreferNativeElement extends Rule {
     }
     getLocation(event) {
         const begin = event.location;
-        const end = event.valueLocation;
+        const end = event.valueLocation; // eslint-disable-line @typescript-eslint/no-non-null-assertion -- technical debt, valueLocation will always be set when a value is provided
         const quote = event.quote ? 1 : 0;
         const size = end.offset + end.size - begin.offset + quote;
         return {
@@ -8360,7 +8432,7 @@ class RequireCSPNonce extends Rule {
             const { tags } = this.options;
             const node = event.previous;
             /* ignore other tags */
-            if (!node || !tags.includes(node.tagName)) {
+            if (!tags.includes(node.tagName)) {
                 return;
             }
             /* ignore if nonce is set to non-empty value (or dynamic) */
@@ -8452,7 +8524,10 @@ class RequireSri extends Rule {
     }
     needSri(node) {
         const attr = this.elementSourceAttr(node);
-        if (!attr || attr.value === null || attr.value === "" || attr.isDynamic) {
+        if (!attr) {
+            return false;
+        }
+        if (attr.value === null || attr.value === "" || attr.isDynamic) {
             return false;
         }
         const url = attr.value.toString();
@@ -8509,7 +8584,7 @@ class ScriptType extends Rule {
     setup() {
         this.on("tag:end", (event) => {
             const node = event.previous;
-            if (!node || node.tagName !== "script") {
+            if (node.tagName !== "script") {
                 return;
             }
             const attr = node.getAttribute("type");
@@ -8790,18 +8865,16 @@ class TextContent extends Rule {
             description: `The textual content for this element is not valid.`,
             url: "https://html-validate.org/rules/text-content.html",
         };
-        if (context === null || context === void 0 ? void 0 : context.textContent) {
-            switch (context.textContent) {
-                case TextContent$1.NONE:
-                    doc.description = `The \`<${context.tagName}>\` element must not have textual content.`;
-                    break;
-                case TextContent$1.REQUIRED:
-                    doc.description = `The \`<${context.tagName}>\` element must have textual content.`;
-                    break;
-                case TextContent$1.ACCESSIBLE:
-                    doc.description = `The \`<${context.tagName}>\` element must have accessible text.`;
-                    break;
-            }
+        switch (context.textContent) {
+            case TextContent$1.NONE:
+                doc.description = `The \`<${context.tagName}>\` element must not have textual content.`;
+                break;
+            case TextContent$1.REQUIRED:
+                doc.description = `The \`<${context.tagName}>\` element must have textual content.`;
+                break;
+            case TextContent$1.ACCESSIBLE:
+                doc.description = `The \`<${context.tagName}>\` element must have accessible text.`;
+                break;
         }
         return doc;
     }
@@ -9162,20 +9235,16 @@ class VoidStyle extends Rule {
         };
     }
     documentation(context) {
-        const doc = {
-            description: "The current configuration requires a specific style for ending void elements.",
+        const [desc, end] = styleDescription(context.style);
+        return {
+            description: `The current configuration requires void elements to ${desc}, use <${context.tagName}${end}> instead.`,
             url: "https://html-validate.org/rules/void-style.html",
         };
-        if (context) {
-            const [desc, end] = styleDescription(context.style);
-            doc.description = `The current configuration requires void elements to ${desc}, use <${context.tagName}${end}> instead.`;
-        }
-        return doc;
     }
     setup() {
         this.on("tag:end", (event) => {
             const active = event.previous; // The current active element (that is, the current element on the stack)
-            if (active && active.meta) {
+            if (active.meta) {
                 this.validateActive(active);
             }
         });
@@ -9412,7 +9481,8 @@ class H37 extends Rule {
                 return;
             }
             /* validate plain alt-attribute */
-            if (node.getAttributeValue("alt") || (node.hasAttribute("alt") && this.options.allowEmpty)) {
+            if (Boolean(node.getAttributeValue("alt")) ||
+                Boolean(node.hasAttribute("alt") && this.options.allowEmpty)) {
                 return;
             }
             /* validate if any non-empty alias is present */
@@ -9589,6 +9659,7 @@ const bundledRules = {
     "no-dup-attr": NoDupAttr,
     "no-dup-class": NoDupClass,
     "no-dup-id": NoDupID,
+    "no-implicit-button-type": NoImplicitButtonType,
     "no-implicit-close": NoImplicitClose,
     "no-inline-style": NoInlineStyle,
     "no-missing-references": NoMissingReferences,
@@ -9635,6 +9706,7 @@ const config$4 = {
         "multiple-labeled-controls": "error",
         "no-autoplay": ["error", { include: ["audio", "video"] }],
         "no-dup-id": "error",
+        "no-implicit-button-type": "error",
         "no-redundant-aria-label": "error",
         "no-redundant-for": "error",
         "no-redundant-role": "error",
@@ -9714,6 +9786,7 @@ const config$1 = {
         "no-dup-attr": "error",
         "no-dup-class": "error",
         "no-dup-id": "error",
+        "no-implicit-button-type": "error",
         "no-implicit-close": "error",
         "no-inline-style": "error",
         "no-multiple-main": "error",
@@ -9845,7 +9918,7 @@ class ResolvedConfig {
      * @returns A list of transformed sources ready for validation.
      */
     transformSource(source, filename) {
-        const transformer = this.findTransformer(filename || source.filename);
+        const transformer = this.findTransformer(filename !== null && filename !== void 0 ? filename : source.filename);
         const context = {
             hasChain: (filename) => {
                 return !!this.findTransformer(filename);
@@ -9857,9 +9930,10 @@ class ResolvedConfig {
         if (transformer) {
             try {
                 return Array.from(transformer.fn.call(context, source), (cur) => {
+                    var _a;
                     /* keep track of which transformers that has been run on this source
                      * by appending this entry to the transformedBy array */
-                    cur.transformedBy = cur.transformedBy || [];
+                    (_a = cur.transformedBy) !== null && _a !== void 0 ? _a : (cur.transformedBy = []);
                     cur.transformedBy.push(transformer.name);
                     return cur;
                 });
@@ -10031,7 +10105,7 @@ function mergeInternal(base, rhs) {
     }
     /* root property is merged with boolean "or" since it should always be truthy
      * if any config has it set. */
-    const root = base.root || rhs.root;
+    const root = Boolean(base.root) || Boolean(rhs.root);
     if (root) {
         dst.root = root;
     }
@@ -10118,7 +10192,7 @@ class Config {
      * @internal
      */
     constructor(resolvers, options) {
-        var _a;
+        var _a, _b;
         this.transformers = [];
         const initial = {
             extends: [],
@@ -10131,18 +10205,18 @@ class Config {
         this.initialized = false;
         this.resolvers = toArray(resolvers);
         /* load plugins */
-        this.plugins = this.loadPlugins(this.config.plugins || []);
+        this.plugins = this.loadPlugins((_a = this.config.plugins) !== null && _a !== void 0 ? _a : []);
         this.configurations = this.loadConfigurations(this.plugins);
         this.extendMeta(this.plugins);
         /* process extended configs */
-        this.config = this.extendConfig((_a = this.config.extends) !== null && _a !== void 0 ? _a : []);
+        this.config = this.extendConfig((_b = this.config.extends) !== null && _b !== void 0 ? _b : []);
         /* reset extends as we already processed them, this prevents the next config
          * from reapplying config from extended config as well as duplicate entries
          * when merging arrays */
         this.config.extends = [];
         /* rules explicitly set by passed options should have precedence over any
          * extended rules, not the other way around. */
-        if (options && options.rules) {
+        if (options === null || options === void 0 ? void 0 : options.rules) {
             this.config = mergeInternal(this.config, { rules: options.rules });
         }
     }
@@ -10155,11 +10229,12 @@ class Config {
      * @public
      */
     init() {
+        var _a;
         if (this.initialized) {
             return;
         }
         /* precompile transform patterns */
-        this.transformers = this.precompileTransformers(this.config.transform || {});
+        this.transformers = this.precompileTransformers((_a = this.config.transform) !== null && _a !== void 0 ? _a : {});
         this.initialized = true;
     }
     /**
@@ -10186,7 +10261,7 @@ class Config {
         for (const entry of entries) {
             let extended;
             if (this.configurations.has(entry)) {
-                extended = this.configurations.get(entry);
+                extended = this.configurations.get(entry); // eslint-disable-line @typescript-eslint/no-non-null-assertion -- map has/get combo
             }
             else {
                 extended = Config.fromFile(this.resolvers, entry).config;
@@ -10201,12 +10276,13 @@ class Config {
      * @internal
      */
     getMetaTable() {
+        var _a;
         /* use cached table if it exists */
         if (this.metaTable) {
             return this.metaTable;
         }
         const metaTable = new MetaTable();
-        const source = this.config.elements || ["html5"];
+        const source = (_a = this.config.elements) !== null && _a !== void 0 ? _a : ["html5"];
         /* extend validation schema from plugins */
         for (const plugin of this.getPlugins()) {
             if (plugin.elementSchema) {
@@ -10304,6 +10380,7 @@ class Config {
         });
     }
     loadConfigurations(plugins) {
+        var _a;
         const configs = new Map();
         /* builtin presets */
         for (const [name, config] of Object.entries(Presets)) {
@@ -10312,7 +10389,7 @@ class Config {
         }
         /* presets from plugins */
         for (const plugin of plugins) {
-            for (const [name, config] of Object.entries(plugin.configs || {})) {
+            for (const [name, config] of Object.entries((_a = plugin.configs) !== null && _a !== void 0 ? _a : {})) {
                 if (!config)
                     continue;
                 Config.validate(config, name);
@@ -10677,10 +10754,11 @@ class Parser {
      * stack when is allowed to omit.
      */
     closeOptional(token) {
+        var _a;
         /* if the element doesn't have metadata it cannot have optional end
          * tags. Period. */
         const active = this.dom.getActive();
-        if (!(active.meta && active.meta.implicitClosed)) {
+        if (!((_a = active.meta) === null || _a === void 0 ? void 0 : _a.implicitClosed)) {
             return false;
         }
         const tagName = token.data[2];
@@ -10832,9 +10910,10 @@ class Parser {
         }
     }
     processElement(node, source) {
+        var _a;
         /* enable cache on node now that it is fully constructed */
         node.cacheEnable();
-        if (source.hooks && source.hooks.processElement) {
+        if ((_a = source.hooks) === null || _a === void 0 ? void 0 : _a.processElement) {
             const processElement = source.hooks.processElement;
             const metaTable = this.metaTable;
             const context = {
@@ -10901,6 +10980,7 @@ class Parser {
      * @internal
      */
     consumeAttribute(source, node, token, next) {
+        var _a;
         const keyLocation = this.getAttributeKeyLocation(token);
         const valueLocation = this.getAttributeValueLocation(next);
         const location = this.getAttributeLocation(token, next);
@@ -10919,7 +10999,7 @@ class Parser {
          * data right away but a transformer may override it to allow aliasing
          * attributes, e.g ng-attr-foo or v-bind:foo */
         let processAttribute = (attr) => [attr];
-        if (source.hooks && source.hooks.processAttribute) {
+        if ((_a = source.hooks) === null || _a === void 0 ? void 0 : _a.processAttribute) {
             processAttribute = source.hooks.processAttribute;
         }
         /* handle deprecated callbacks */
@@ -11269,14 +11349,15 @@ class Reporter {
         const report = {
             valid: this.isValid(),
             results: Object.keys(this.result).map((filePath) => {
+                var _a;
                 const messages = Array.from(this.result[filePath], freeze).sort(messageSort);
-                const source = (sources || []).find((source) => { var _a; return filePath === ((_a = source.filename) !== null && _a !== void 0 ? _a : ""); });
+                const source = (sources !== null && sources !== void 0 ? sources : []).find((source) => { var _a; return filePath === ((_a = source.filename) !== null && _a !== void 0 ? _a : ""); });
                 return {
                     filePath,
                     messages,
                     errorCount: countErrors(messages),
                     warningCount: countWarnings(messages),
-                    source: source ? source.originalData || source.data : null,
+                    source: source ? (_a = source.originalData) !== null && _a !== void 0 ? _a : source.data : null,
                 };
             }),
             errorCount: 0,
@@ -11294,10 +11375,10 @@ class Reporter {
     }
 }
 function countErrors(messages) {
-    return messages.filter((m) => m.severity === Severity.ERROR).length;
+    return messages.filter((m) => m.severity === Number(Severity.ERROR)).length;
 }
 function countWarnings(messages) {
-    return messages.filter((m) => m.severity === Severity.WARN).length;
+    return messages.filter((m) => m.severity === Number(Severity.WARN)).length;
 }
 function sumErrors(results) {
     return results.reduce((sum, result) => {
@@ -11642,9 +11723,10 @@ class Engine {
      * between rule name and its constructor.
      */
     initRules(config) {
+        var _a;
         const availableRules = {};
         for (const plugin of config.getPlugins()) {
-            for (const [name, rule] of Object.entries(plugin.rules || {})) {
+            for (const [name, rule] of Object.entries((_a = plugin.rules) !== null && _a !== void 0 ? _a : {})) {
                 if (!rule)
                     continue;
                 availableRules[name] = rule;
@@ -11747,7 +11829,7 @@ class StaticConfigLoader extends ConfigLoader {
         }
     }
     getConfigFor(_handle, configOverride) {
-        const override = this.loadFromObject(configOverride || {});
+        const override = this.loadFromObject(configOverride !== null && configOverride !== void 0 ? configOverride : {});
         if (override.isRootFound()) {
             override.init();
             return override.resolve();
@@ -11791,6 +11873,7 @@ class HtmlValidate {
         const [loader, config] = arg instanceof ConfigLoader ? [arg, undefined] : [undefined, arg];
         this.configLoader = loader !== null && loader !== void 0 ? loader : new StaticConfigLoader(config);
     }
+    /* eslint-enable @typescript-eslint/unified-signatures */
     validateString(str, arg1, arg2, arg3) {
         const filename = typeof arg1 === "string" ? arg1 : "inline";
         const options = isConfigData(arg1) ? arg1 : isConfigData(arg2) ? arg2 : undefined;
@@ -11805,6 +11888,7 @@ class HtmlValidate {
         };
         return this.validateSource(source, options);
     }
+    /* eslint-enable @typescript-eslint/unified-signatures */
     validateStringSync(str, arg1, arg2, arg3) {
         const filename = typeof arg1 === "string" ? arg1 : "inline";
         const options = isConfigData(arg1) ? arg1 : isConfigData(arg2) ? arg2 : undefined;
@@ -12076,7 +12160,7 @@ class HtmlValidate {
      * contextual details and suggestions.
      */
     async getRuleDocumentation(ruleId, config = null, context = null) {
-        const c = config || this.getConfigFor("inline");
+        const c = config !== null && config !== void 0 ? config : this.getConfigFor("inline");
         const engine = new Engine(await c, Parser);
         return engine.getRuleDocumentation({ ruleId, context });
     }
@@ -12105,7 +12189,7 @@ class HtmlValidate {
      * contextual details and suggestions.
      */
     getRuleDocumentationSync(ruleId, config = null, context = null) {
-        const c = config || this.getConfigForSync("inline");
+        const c = config !== null && config !== void 0 ? config : this.getConfigForSync("inline");
         const engine = new Engine(c, Parser);
         return engine.getRuleDocumentation({ ruleId, context });
     }
@@ -12161,7 +12245,7 @@ class HtmlValidate {
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "8.1.0";
+const version = "8.3.0";
 /** @public */
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
 
@@ -12459,5 +12543,5 @@ function compatibilityCheckImpl(name, declared, options) {
     return false;
 }
 
-export { Attribute as A, codeframe as B, Config as C, DynamicValue as D, EventHandler as E, name as F, bugs as G, HtmlValidate as H, MetaTable as M, NodeClosed as N, Presets 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, ensureError as e, HtmlElement as f, getFormatter as g, DOMNode as h, DOMTree as i, NodeType as j, SchemaValidationError as k, NestedError as l, TextContent$1 as m, MetaCopyableProperty as n, Rule as o, TextClassification as p, classifyNodeText as q, keywordPatternMatcher as r, staticResolver as s, sliceLocation as t, Reporter as u, version as v, definePlugin as w, Parser as x, ruleExists as y, compatibilityCheckImpl as z };
+export { Attribute as A, codeframe as B, Config as C, DOMNode as D, EventHandler as E, name as F, bugs as G, HtmlValidate as H, MetaCopyableProperty as M, NodeClosed as N, Presets 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, ensureError as e, DOMTree as f, getFormatter as g, DynamicValue as h, HtmlElement as i, NodeType as j, NestedError as k, SchemaValidationError as l, MetaTable as m, TextContent$1 as n, Rule as o, TextClassification as p, classifyNodeText as q, keywordPatternMatcher as r, staticResolver as s, sliceLocation as t, Reporter as u, version as v, definePlugin as w, Parser as x, ruleExists as y, compatibilityCheckImpl as z };
 //# sourceMappingURL=core.js.map