html-validate 8.1.0 → 8.3.0

package/dist/cjs/core.js

@@ -295,7 +295,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}`;
         }
     }
@@ -1030,7 +1030,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;
@@ -1392,6 +1393,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;
@@ -1777,7 +1788,7 @@ class DOMTokenList extends Array {
             this.value = value.expr;
         }
         else {
-            this.value = value || "";
+            this.value = value !== null && value !== void 0 ? value : "";
         }
     }
     item(n) {
@@ -2002,7 +2013,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;
@@ -2039,11 +2050,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) {
@@ -2217,6 +2228,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
  */
@@ -2225,9 +2251,9 @@ class HtmlElement extends DOMNode {
         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`);
+            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;
@@ -2235,6 +2261,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 */
@@ -2294,7 +2321,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) {
@@ -2412,6 +2439,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];
             }
         }
@@ -2687,11 +2715,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;
@@ -2727,6 +2756,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.
@@ -2768,7 +2798,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));
@@ -2814,6 +2844,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;
                 }
@@ -2954,7 +2985,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;
@@ -2979,9 +3010,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}"`);
         }
@@ -3166,10 +3197,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
@@ -3416,7 +3449,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, exports.TextClassification.EMPTY_TEXT);
@@ -3464,8 +3497,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() !== "";
@@ -3473,8 +3510,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() !== "";
@@ -3555,7 +3596,7 @@ class Rule {
         this.options = options;
         this.enabled = true;
         this.blockers = [];
-        this.severity = 0;
+        this.severity = exports.Severity.DISABLED;
         this.name = "";
     }
     getSeverity() {
@@ -3708,13 +3749,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 {};
@@ -3887,7 +3929,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",
@@ -4151,7 +4194,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;
@@ -4186,7 +4229,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 */
@@ -4917,7 +4960,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)) {
@@ -4985,7 +5028,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) {
@@ -5066,7 +5109,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) {
@@ -5154,10 +5197,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,
@@ -5828,7 +5871,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;
@@ -6033,7 +6076,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)) {
@@ -6345,7 +6388,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;
@@ -6379,7 +6422,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);
 }
@@ -6447,7 +6490,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) => {
@@ -6593,7 +6636,7 @@ class IdPattern extends Rule {
     }
     setup() {
         this.on("attr", (event) => {
-            var _a;
+            var _a, _b;
             if (event.key.toLowerCase() !== "id") {
                 return;
             }
@@ -6601,8 +6644,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);
@@ -7030,7 +7073,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 */
@@ -7107,7 +7150,7 @@ class MapDupName extends Rule {
     }
 }
 
-function isRelevant$2(event) {
+function isRelevant$3(event) {
     return event.target.is("map");
 }
 function hasStaticValue(attr) {
@@ -7121,7 +7164,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");
@@ -7309,7 +7352,7 @@ class NoDeprecatedAttr extends Rule {
             if (meta === null) {
                 return;
             }
-            const metaAttribute = meta.attributes && meta.attributes[attr];
+            const metaAttribute = meta.attributes[attr];
             if (!metaAttribute) {
                 return;
             }
@@ -7385,11 +7428,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();
@@ -7401,7 +7444,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) {
@@ -7418,6 +7461,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 {
@@ -7523,11 +7601,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;
@@ -7721,7 +7800,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);
         });
     }
     /**
@@ -7935,7 +8015,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 */
@@ -8141,16 +8221,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) => {
@@ -8249,14 +8325,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;
@@ -8297,7 +8369,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 {
@@ -8371,7 +8443,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) */
@@ -8463,7 +8535,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();
@@ -8520,7 +8595,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");
@@ -8801,18 +8876,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 exports.TextContent.NONE:
-                    doc.description = `The \`<${context.tagName}>\` element must not have textual content.`;
-                    break;
-                case exports.TextContent.REQUIRED:
-                    doc.description = `The \`<${context.tagName}>\` element must have textual content.`;
-                    break;
-                case exports.TextContent.ACCESSIBLE:
-                    doc.description = `The \`<${context.tagName}>\` element must have accessible text.`;
-                    break;
-            }
+        switch (context.textContent) {
+            case exports.TextContent.NONE:
+                doc.description = `The \`<${context.tagName}>\` element must not have textual content.`;
+                break;
+            case exports.TextContent.REQUIRED:
+                doc.description = `The \`<${context.tagName}>\` element must have textual content.`;
+                break;
+            case exports.TextContent.ACCESSIBLE:
+                doc.description = `The \`<${context.tagName}>\` element must have accessible text.`;
+                break;
         }
         return doc;
     }
@@ -9173,20 +9246,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);
             }
         });
@@ -9423,7 +9492,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 */
@@ -9600,6 +9670,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,
@@ -9646,6 +9717,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",
@@ -9725,6 +9797,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",
@@ -9856,7 +9929,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);
@@ -9868,9 +9941,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;
                 });
@@ -10042,7 +10116,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;
     }
@@ -10129,7 +10203,7 @@ class Config {
      * @internal
      */
     constructor(resolvers, options) {
-        var _a;
+        var _a, _b;
         this.transformers = [];
         const initial = {
             extends: [],
@@ -10142,18 +10216,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 });
         }
     }
@@ -10166,11 +10240,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;
     }
     /**
@@ -10197,7 +10272,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;
@@ -10212,12 +10287,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) {
@@ -10315,6 +10391,7 @@ class Config {
         });
     }
     loadConfigurations(plugins) {
+        var _a;
         const configs = new Map();
         /* builtin presets */
         for (const [name, config] of Object.entries(Presets)) {
@@ -10323,7 +10400,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);
@@ -10688,10 +10765,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];
@@ -10843,9 +10921,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 = {
@@ -10912,6 +10991,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);
@@ -10930,7 +11010,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 */
@@ -11280,14 +11360,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,
@@ -11305,10 +11386,10 @@ class Reporter {
     }
 }
 function countErrors(messages) {
-    return messages.filter((m) => m.severity === exports.Severity.ERROR).length;
+    return messages.filter((m) => m.severity === Number(exports.Severity.ERROR)).length;
 }
 function countWarnings(messages) {
-    return messages.filter((m) => m.severity === exports.Severity.WARN).length;
+    return messages.filter((m) => m.severity === Number(exports.Severity.WARN)).length;
 }
 function sumErrors(results) {
     return results.reduce((sum, result) => {
@@ -11653,9 +11734,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;
@@ -11758,7 +11840,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();
@@ -11802,6 +11884,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;
@@ -11816,6 +11899,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;
@@ -12087,7 +12171,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 });
     }
@@ -12116,7 +12200,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 });
     }
@@ -12172,7 +12256,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";