html-validate 5.3.0 → 6.0.0

package/dist/es/core.js

@@ -574,18 +574,63 @@ const definitions = {
 		type: "object",
 		patternProperties: {
 			"^.*$": {
-				type: "array",
-				uniqueItems: true,
-				items: {
-					anyOf: [
-						{
+				anyOf: [
+					{
+						type: "object",
+						additionalProperties: false,
+						properties: {
+							boolean: {
+								type: "boolean",
+								title: "Set to true if this is a boolean attribute"
+							},
+							deprecated: {
+								title: "Set to true or string if this attribute is deprecated",
+								oneOf: [
+									{
+										type: "boolean"
+									},
+									{
+										type: "string"
+									}
+								]
+							},
+							list: {
+								type: "boolean",
+								title: "Set to true if this attribute is a list of space-separated tokens, each which must be valid by itself"
+							},
+							"enum": {
+								type: "array",
+								title: "Exhaustive list of values (string or regex) this attribute accepts",
+								uniqueItems: true,
+								items: {
+									anyOf: [
+										{
+											type: "string"
+										},
+										{
+											regexp: true
+										}
+									]
+								}
+							},
+							omit: {
+								type: "boolean",
+								title: "Set to true if this attribute can optionally omit its value"
+							},
+							required: {
+								type: "boolean",
+								title: "Set to true if this attribute is required"
+							}
+						}
+					},
+					{
+						type: "array",
+						uniqueItems: true,
+						items: {
 							type: "string"
-						},
-						{
-							regexp: true
 						}
-					]
-				}
+					}
+				]
 			}
 		}
 	},
@@ -636,6 +681,111 @@ var schema = {
 	definitions: definitions
 };
 
+var TextContent$1;
+(function (TextContent) {
+    /* forbid node to have text content, inter-element whitespace is ignored */
+    TextContent["NONE"] = "none";
+    /* node can have text but not required too */
+    TextContent["DEFAULT"] = "default";
+    /* node requires text-nodes to be present (direct or by descendant) */
+    TextContent["REQUIRED"] = "required";
+    /* node requires accessible text (hidden text is ignored, tries to get text from accessibility tree) */
+    TextContent["ACCESSIBLE"] = "accessible";
+})(TextContent$1 || (TextContent$1 = {}));
+/**
+ * Properties listed here can be copied (loaded) onto another element using
+ * [[HtmlElement.loadMeta]].
+ */
+const MetaCopyableProperty = [
+    "metadata",
+    "flow",
+    "sectioning",
+    "heading",
+    "phrasing",
+    "embedded",
+    "interactive",
+    "transparent",
+    "form",
+    "labelable",
+    "attributes",
+    "permittedContent",
+    "permittedDescendants",
+    "permittedOrder",
+    "requiredAncestors",
+    "requiredContent",
+];
+/**
+ * @internal
+ */
+function setMetaProperty(dst, key, value) {
+    dst[key] = value;
+}
+
+function isSet(value) {
+    return typeof value !== "undefined";
+}
+function flag(value) {
+    return value ? true : undefined;
+}
+function stripUndefined(src) {
+    const entries = Object.entries(src).filter(([, value]) => isSet(value));
+    return Object.fromEntries(entries);
+}
+function migrateSingleAttribute(src, key) {
+    var _a, _b;
+    const result = {};
+    result.deprecated = flag((_a = src.deprecatedAttributes) === null || _a === void 0 ? void 0 : _a.includes(key));
+    result.required = flag((_b = src.requiredAttributes) === null || _b === void 0 ? void 0 : _b.includes(key));
+    result.omit = undefined;
+    const attr = src.attributes ? src.attributes[key] : undefined;
+    if (typeof attr === "undefined") {
+        return stripUndefined(result);
+    }
+    /* when the attribute is set to null we use a special property "delete" to
+     * flag it, if it is still set during merge (inheritance, overwriting, etc) the attribute will be removed */
+    if (attr === null) {
+        result.delete = true;
+        return stripUndefined(result);
+    }
+    if (Array.isArray(attr)) {
+        if (attr.length === 0) {
+            result.boolean = true;
+        }
+        else {
+            result.enum = attr.filter((it) => it !== "");
+            if (attr.includes("")) {
+                result.omit = true;
+            }
+        }
+        return stripUndefined(result);
+    }
+    else {
+        return stripUndefined({ ...result, ...attr });
+    }
+}
+function migrateAttributes(src) {
+    var _a, _b, _c;
+    const keys = [
+        ...Object.keys((_a = src.attributes) !== null && _a !== void 0 ? _a : {}),
+        ...((_b = src.requiredAttributes) !== null && _b !== void 0 ? _b : []),
+        ...((_c = src.deprecatedAttributes) !== null && _c !== void 0 ? _c : []),
+    ].sort();
+    const entries = keys.map((key) => {
+        return [key, migrateSingleAttribute(src, key)];
+    });
+    return Object.fromEntries(entries);
+}
+function migrateElement(src) {
+    const result = {
+        ...src,
+        attributes: migrateAttributes(src),
+    };
+    /* removed properties */
+    delete result.deprecatedAttributes;
+    delete result.requiredAttributes;
+    return result;
+}
+
 const dynamicKeys = [
     "metadata",
     "flow",
@@ -729,7 +879,7 @@ class MetaTable {
         for (const [key, value] of Object.entries(obj)) {
             if (key === "$schema")
                 continue;
-            this.addEntry(key, value);
+            this.addEntry(key, migrateElement(value));
         }
     }
     /**
@@ -757,7 +907,7 @@ class MetaTable {
      */
     getMetaFor(tagName) {
         tagName = tagName.toLowerCase();
-        return this.elements[tagName] ? Object.assign({}, this.elements[tagName]) : null;
+        return this.elements[tagName] ? { ...this.elements[tagName] } : null;
     }
     /**
      * Find all tags which has enabled given property.
@@ -786,7 +936,7 @@ class MetaTable {
             }
         }
         /* merge all sources together */
-        const expanded = deepmerge(parent, Object.assign(Object.assign({}, entry), { tagName }), { arrayMerge: overwriteMerge$1 });
+        const expanded = this.mergeElement(parent, { ...entry, tagName });
         expandRegex(expanded);
         this.elements[tagName] = expanded;
     }
@@ -820,11 +970,20 @@ class MetaTable {
         delete global.void;
         /* merge elements */
         for (const [tagName, entry] of Object.entries(this.elements)) {
-            this.elements[tagName] = this.mergeElement(entry, global);
+            this.elements[tagName] = this.mergeElement(global, entry);
         }
     }
     mergeElement(a, b) {
-        return deepmerge(a, b);
+        const merged = deepmerge(a, b, { arrayMerge: overwriteMerge$1 });
+        /* special handling when removing attributes by setting them to null
+         * resulting in the deletion flag being set */
+        const filteredAttrs = Object.entries(merged.attributes).filter(([, attr]) => {
+            const val = !attr.delete;
+            delete attr.delete;
+            return val;
+        });
+        merged.attributes = Object.fromEntries(filteredAttrs);
+        return merged;
     }
     resolve(node) {
         if (node.meta) {
@@ -836,7 +995,7 @@ function expandProperties(node, entry) {
     for (const key of dynamicKeys) {
         const property = entry[key];
         if (property && typeof property !== "boolean") {
-            entry[key] = evaluateProperty(node, property);
+            setMetaProperty(entry, key, evaluateProperty(node, property));
         }
     }
 }
@@ -862,14 +1021,9 @@ function expandRegexValue(value) {
  * Expand all regular expressions in strings ("/../"). This mutates the object.
  */
 function expandRegex(entry) {
-    if (!entry.attributes)
-        return;
     for (const [name, values] of Object.entries(entry.attributes)) {
-        if (values) {
-            entry.attributes[name] = values.map(expandRegexValue);
-        }
-        else {
-            delete entry.attributes[name];
+        if (values.enum) {
+            entry.attributes[name].enum = values.enum.map(expandRegexValue);
         }
     }
 }
@@ -925,41 +1079,6 @@ function matchAttribute(node, match) {
     }
 }
 
-var TextContent$1;
-(function (TextContent) {
-    /* forbid node to have text content, inter-element whitespace is ignored */
-    TextContent["NONE"] = "none";
-    /* node can have text but not required too */
-    TextContent["DEFAULT"] = "default";
-    /* node requires text-nodes to be present (direct or by descendant) */
-    TextContent["REQUIRED"] = "required";
-    /* node requires accessible text (hidden text is ignored, tries to get text from accessibility tree) */
-    TextContent["ACCESSIBLE"] = "accessible";
-})(TextContent$1 || (TextContent$1 = {}));
-/**
- * Properties listed here can be copied (loaded) onto another element using
- * [[HtmlElement.loadMeta]].
- */
-const MetaCopyableProperty = [
-    "metadata",
-    "flow",
-    "sectioning",
-    "heading",
-    "phrasing",
-    "embedded",
-    "interactive",
-    "transparent",
-    "form",
-    "labelable",
-    "requiredAttributes",
-    "attributes",
-    "permittedContent",
-    "permittedDescendants",
-    "permittedOrder",
-    "requiredAncestors",
-    "requiredContent",
-];
-
 class DynamicValue {
     constructor(expr) {
         this.expr = expr;
@@ -1330,6 +1449,15 @@ class DOMTokenList extends Array {
     contains(token) {
         return this.includes(token);
     }
+    *iterator() {
+        for (let index = 0; index < this.length; index++) {
+            /* eslint-disable @typescript-eslint/no-non-null-assertion */
+            const item = this.item(index);
+            const location = this.location(index);
+            /* eslint-enable @typescript-eslint/no-non-null-assertion */
+            yield { index, item, location };
+        }
+    }
 }
 
 var Combinator;
@@ -1802,8 +1930,9 @@ class HtmlElement extends DOMNode {
             this.metaElement = {};
         }
         for (const key of MetaCopyableProperty) {
-            if (typeof meta[key] !== "undefined") {
-                this.metaElement[key] = meta[key];
+            const value = meta[key];
+            if (typeof value !== "undefined") {
+                setMetaProperty(this.metaElement, key, value);
             }
             else {
                 delete this.metaElement[key];
@@ -2219,6 +2348,7 @@ 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) {
@@ -2232,19 +2362,34 @@ class Validator {
             return true;
         }
         const empty = value === null || value === "";
-        /* consider an empty array as being a boolean attribute */
-        if (rule.length === 0) {
+        /* if boolean is set the value can be either null, empty string or the
+         * attribute key (attribute-boolean-style regulates style) */
+        if (rule.boolean) {
             return empty || value === attr.key;
         }
-        /* if the empty string is present allow both "" and null
-         * (boolean-attribute-style will regulate which is allowed) */
-        if (rule.includes("") && empty) {
+        /* if omit is set the value can be either null or empty string
+         * (attribute-empty style regulates style) */
+        if (rule.omit && empty) {
+            return true;
+        }
+        /* validate each token when using list, all tokens must be valid */
+        if (rule.list) {
+            const tokens = new DOMTokenList(value, attr.valueLocation);
+            return tokens.every((token) => {
+                return this.validateAttributeValue(token, rule);
+            });
+        }
+        return this.validateAttributeValue(value, rule);
+    }
+    static validateAttributeValue(value, rule) {
+        /* skip attribute if it not have enumerated list */
+        if (!rule.enum) {
             return true;
         }
         if (value === null || value === undefined) {
             return false;
         }
-        return rule.some((entry) => {
+        return rule.enum.some((entry) => {
             if (entry instanceof RegExp) {
                 return !!value.match(entry);
             }
@@ -2510,12 +2655,12 @@ var configurationSchema = {
 const espree = legacyRequire("espree");
 const walk = legacyRequire("acorn-walk");
 function joinTemplateLiteral(nodes) {
-    let offset = nodes[0].start;
+    let offset = nodes[0].start + 1;
     let output = "";
     for (const node of nodes) {
-        output += " ".repeat(node.start - offset);
+        output += " ".repeat(node.start + 1 - offset);
         output += node.value.raw;
-        offset = node.end;
+        offset = node.end - 2;
     }
     return output;
 }
@@ -2707,7 +2852,7 @@ var TRANSFORMER_API;
 })(TRANSFORMER_API || (TRANSFORMER_API = {}));
 
 const name = "html-validate";
-const version = "5.3.0";
+const version = "6.0.0";
 const homepage = "https://html-validate.org";
 const bugs = {
 	url: "https://gitlab.com/html-validate/html-validate/issues/new"
@@ -2999,7 +3144,7 @@ const description = {
 };
 class AllowedLinks extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$p), options));
+        super({ ...defaults$p, ...options });
     }
     static schema() {
         return {
@@ -3247,7 +3392,7 @@ const defaults$o = {
 };
 class AttrCase extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$o), options));
+        super({ ...defaults$o, ...options });
         this.style = new CaseStyle(this.options.style, "attr-case");
     }
     static schema() {
@@ -3600,7 +3745,7 @@ function generateDescription(name, pattern) {
 }
 class AttrPattern extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$n), options));
+        super({ ...defaults$n, ...options });
         this.pattern = generateRegexp(this.options.pattern);
     }
     static schema() {
@@ -3666,7 +3811,7 @@ const defaults$m = {
 };
 class AttrQuotes extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$m), options));
+        super({ ...defaults$m, ...options });
         this.style = parseStyle$4(this.options.style);
     }
     static schema() {
@@ -3762,11 +3907,11 @@ class AttributeAllowedValues extends Rule {
         if (!context) {
             return docs;
         }
-        if (context.allowed.length > 0) {
-            const allowed = context.allowed.map((val) => `- \`${val}\``);
+        if (context.allowed.enum) {
+            const allowed = context.allowed.enum.map((val) => `- \`${val}\``);
             docs.description = `Element <${context.element}> does not allow attribute \`${context.attribute}\` to have the value \`"${context.value}"\`, it must match one of the following:\n\n${allowed.join("\n")}`;
         }
-        else {
+        else if (context.allowed.boolean) {
             docs.description = `Element <${context.element}> attribute \`${context.attribute}\` must be a boolean attribute, e.g. \`<${context.element} ${context.attribute}>\``;
         }
         return docs;
@@ -3822,7 +3967,7 @@ const defaults$l = {
 };
 class AttributeBooleanStyle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$l), options));
+        super({ ...defaults$l, ...options });
         this.hasInvalidStyle = parseStyle$3(this.options.style);
     }
     static schema() {
@@ -3867,7 +4012,8 @@ class AttributeBooleanStyle extends Rule {
         });
     }
     isBoolean(attr, rules) {
-        return rules[attr.key] && rules[attr.key].length === 0;
+        var _a;
+        return Boolean((_a = rules[attr.key]) === null || _a === void 0 ? void 0 : _a.boolean);
     }
 }
 function parseStyle$3(style) {
@@ -3902,7 +4048,7 @@ const defaults$k = {
 };
 class AttributeEmptyStyle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$k), options));
+        super({ ...defaults$k, ...options });
         this.hasInvalidStyle = parseStyle$2(this.options.style);
     }
     static schema() {
@@ -3951,7 +4097,8 @@ class AttributeEmptyStyle extends Rule {
     }
 }
 function allowsEmpty(attr, rules) {
-    return rules[attr.key] && rules[attr.key].includes("");
+    var _a;
+    return Boolean((_a = rules[attr.key]) === null || _a === void 0 ? void 0 : _a.omit);
 }
 function isEmptyValue(attr) {
     /* dynamic values are ignored, assumed to contain a value */
@@ -4014,7 +4161,7 @@ const defaults$j = {
 };
 class ClassPattern extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$j), options));
+        super({ ...defaults$j, ...options });
         this.pattern = parsePattern(this.options.pattern);
     }
     static schema() {
@@ -4127,7 +4274,7 @@ const defaults$i = {
 };
 class Deprecated extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$i), options));
+        super({ ...defaults$i, ...options });
     }
     static schema() {
         return {
@@ -4221,7 +4368,7 @@ class Deprecated extends Rule {
         this.report(node, message, location, context);
     }
     reportObject(deprecated, node, location) {
-        const context = Object.assign(Object.assign({}, deprecated), { tagName: node.tagName });
+        const context = { ...deprecated, tagName: node.tagName };
         const notice = deprecated.message ? `: ${deprecated.message}` : "";
         const message = `<${node.tagName}> is deprecated${notice}`;
         this.report(node, message, location, context);
@@ -4295,7 +4442,7 @@ const defaults$h = {
 };
 class DoctypeStyle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$h), options));
+        super({ ...defaults$h, ...options });
     }
     static schema() {
         return {
@@ -4332,7 +4479,7 @@ const defaults$g = {
 };
 class ElementCase extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$g), options));
+        super({ ...defaults$g, ...options });
         this.style = new CaseStyle(this.options.style, "element-case");
     }
     static schema() {
@@ -4402,7 +4549,7 @@ const defaults$f = {
 };
 class ElementName extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$f), options));
+        super({ ...defaults$f, ...options });
         // eslint-disable-next-line security/detect-non-literal-regexp
         this.pattern = new RegExp(this.options.pattern);
     }
@@ -4674,9 +4821,14 @@ class ElementRequiredAttributes extends Rule {
         this.on("tag:end", (event) => {
             const node = event.previous;
             const meta = node.meta;
-            if (!meta || !meta.requiredAttributes)
+            /* handle missing metadata and missing attributes */
+            if (!meta || !meta.attributes) {
                 return;
-            for (const key of meta.requiredAttributes) {
+            }
+            for (const [key, attr] of Object.entries(meta.attributes)) {
+                if (!attr.required) {
+                    continue;
+                }
                 if (node.hasAttribute(key))
                     continue;
                 const context = {
@@ -4830,6 +4982,7 @@ class EmptyTitle extends Rule {
 
 const defaults$e = {
     allowMultipleH1: false,
+    minInitialRank: "h1",
     sectioningRoots: ["dialog", '[role="dialog"]'],
 };
 function isRelevant$2(event) {
@@ -4845,10 +4998,22 @@ function extractLevel(node) {
         return null;
     }
 }
+function parseMaxInitial(value) {
+    if (value === false || value === "any") {
+        return 6;
+    }
+    const match = value.match(/^h(\d)$/);
+    /* istanbul ignore next: should never happen, schema validation should catch invalid values */
+    if (!match) {
+        return 1;
+    }
+    return parseInt(match[1], 10);
+}
 class HeadingLevel extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$e), options));
+        super({ ...defaults$e, ...options });
         this.stack = [];
+        this.minInitialRank = parseMaxInitial(this.options.minInitialRank);
         this.sectionRoots = this.options.sectioningRoots.map((it) => new Pattern(it));
         /* add a global sectioning root used by default */
         this.stack.push({
@@ -4862,6 +5027,9 @@ class HeadingLevel extends Rule {
             allowMultipleH1: {
                 type: "boolean",
             },
+            minInitialRank: {
+                enum: ["h1", "h2", "h3", "h4", "h5", "h6", "any", false],
+            },
             sectioningRoots: {
                 items: {
                     type: "string",
@@ -4872,7 +5040,8 @@ class HeadingLevel extends Rule {
     }
     documentation() {
         const text = [];
-        text.push("Headings must start at <h1> and can only increase one level at a time.");
+        const modality = this.minInitialRank > 1 ? "should" : "must";
+        text.push(`Headings ${modality} start at <h1> and can only increase one level at a time.`);
         text.push("The headings should form a table of contents and make sense on its own.");
         if (!this.options.allowMultipleH1) {
             text.push("");
@@ -4917,20 +5086,32 @@ class HeadingLevel extends Rule {
      */
     checkLevelIncrementation(root, event, level) {
         const expected = root.current + 1;
-        if (level !== expected) {
-            const location = sliceLocation(event.location, 1);
-            if (root.current > 0) {
-                const msg = `Heading level can only increase by one, expected <h${expected}> but got <h${level}>`;
-                this.report(event.target, msg, location);
-            }
-            else {
-                this.checkInitialLevel(event, location, level, expected);
-            }
+        /* check if the new level is the expected one (headings with higher ranks
+         * are skipped already) */
+        if (level === expected) {
+            return;
+        }
+        /* if this is the initial heading of the document it is compared to the
+         * minimal allowed (default h1) */
+        const isInitial = this.stack.length === 1 && expected === 1;
+        if (isInitial && level <= this.minInitialRank) {
+            return;
+        }
+        /* if we reach this far the heading level is not accepted */
+        const location = sliceLocation(event.location, 1);
+        if (root.current > 0) {
+            const msg = `Heading level can only increase by one, expected <h${expected}> but got <h${level}>`;
+            this.report(event.target, msg, location);
+        }
+        else {
+            this.checkInitialLevel(event, location, level, expected);
         }
     }
     checkInitialLevel(event, location, level, expected) {
         if (this.stack.length === 1) {
-            const msg = `Initial heading level must be <h${expected}> but got <h${level}>`;
+            const msg = this.minInitialRank > 1
+                ? `Initial heading level must be <h${this.minInitialRank}> or higher rank but got <h${level}>`
+                : `Initial heading level must be <h${expected}> but got <h${level}>`;
             this.report(event.target, msg, location);
         }
         else {
@@ -4993,7 +5174,7 @@ const defaults$d = {
 };
 class IdPattern extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$d), options));
+        super({ ...defaults$d, ...options });
         this.pattern = parsePattern(this.options.pattern);
     }
     static schema() {
@@ -5345,7 +5526,7 @@ const defaults$c = {
 };
 class LongTitle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$c), options));
+        super({ ...defaults$c, ...options });
         this.maxlength = this.options.maxlength;
     }
     static schema() {
@@ -5498,7 +5679,7 @@ const defaults$b = {
 };
 class NoAutoplay extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$b), options));
+        super({ ...defaults$b, ...options });
     }
     documentation(context) {
         const tagName = context ? ` on <${context.tagName}>` : "";
@@ -5594,8 +5775,12 @@ class NoDeprecatedAttr extends Rule {
             if (meta === null) {
                 return;
             }
-            const deprecated = meta.deprecatedAttributes || [];
-            if (deprecated.includes(attr)) {
+            const metaAttribute = meta.attributes && meta.attributes[attr];
+            if (!metaAttribute) {
+                return;
+            }
+            const deprecated = metaAttribute.deprecated;
+            if (deprecated) {
                 this.report(node, `Attribute "${event.key}" is deprecated on <${node.tagName}> element`, event.keyLocation);
             }
         });
@@ -5752,7 +5937,7 @@ function getCSSDeclarations(value) {
 }
 class NoInlineStyle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$a), options));
+        super({ ...defaults$a, ...options });
     }
     static schema() {
         return {
@@ -5846,7 +6031,20 @@ class NoInlineStyle extends Rule {
     }
 }
 
-const ARIA = ["aria-controls", "aria-describedby", "aria-labelledby"];
+const ARIA = [
+    { property: "aria-activedescendant", isList: false },
+    { property: "aria-controls", isList: true },
+    { property: "aria-describedby", isList: true },
+    { property: "aria-details", isList: false },
+    { property: "aria-errormessage", isList: false },
+    { property: "aria-flowto", isList: true },
+    { property: "aria-labelledby", isList: true },
+    { property: "aria-owns", isList: true },
+];
+function idMissing(document, id) {
+    const nodes = document.querySelectorAll(`[id="${id}"]`);
+    return nodes.length === 0;
+}
 class NoMissingReferences extends Rule {
     documentation(context) {
         if (context) {
@@ -5868,38 +6066,56 @@ class NoMissingReferences extends Rule {
             /* verify <label for=".."> */
             for (const node of document.querySelectorAll("label[for]")) {
                 const attr = node.getAttribute("for");
-                this.validateReference(document, node, attr);
+                this.validateReference(document, node, attr, false);
             }
             /* verify <input list=".."> */
             for (const node of document.querySelectorAll("input[list]")) {
                 const attr = node.getAttribute("list");
-                this.validateReference(document, node, attr);
+                this.validateReference(document, node, attr, false);
             }
             /* verify WAI-ARIA properties */
-            for (const property of ARIA) {
+            for (const { property, isList } of ARIA) {
                 for (const node of document.querySelectorAll(`[${property}]`)) {
                     const attr = node.getAttribute(property);
-                    this.validateReference(document, node, attr);
+                    this.validateReference(document, node, attr, isList);
                 }
             }
         });
     }
-    validateReference(document, node, attr) {
+    validateReference(document, node, attr, isList) {
         /* sanity check: querySelector should never return elements without the attribute */
         /* istanbul ignore next */
         if (!attr) {
             return;
         }
-        const id = attr.value;
-        if (id instanceof DynamicValue || id === null || id === "") {
+        /* skip dynamic and empty values */
+        const value = attr.value;
+        if (value instanceof DynamicValue || value === null || value === "") {
             return;
         }
-        const nodes = document.querySelectorAll(`[id="${id}"]`);
-        if (nodes.length === 0) {
+        if (isList) {
+            this.validateList(document, node, attr, value);
+        }
+        else {
+            this.validateSingle(document, node, attr, value);
+        }
+    }
+    validateSingle(document, node, attr, id) {
+        if (idMissing(document, id)) {
             const context = { key: attr.key, value: id };
             this.report(node, `Element references missing id "${id}"`, attr.valueLocation, context);
         }
     }
+    validateList(document, node, attr, values) {
+        const parsed = new DOMTokenList(values, attr.valueLocation);
+        for (const entry of parsed.iterator()) {
+            const id = entry.item;
+            if (idMissing(document, id)) {
+                const context = { key: attr.key, value: id };
+                this.report(node, `Element references missing id "${id}"`, entry.location, context);
+            }
+        }
+    }
 }
 
 class NoMultipleMain extends Rule {
@@ -5943,7 +6159,7 @@ const replacementTable = new Map([
 ]);
 class NoRawCharacters extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$9), options));
+        super({ ...defaults$9, ...options });
         this.relaxed = this.options.relaxed;
     }
     static schema() {
@@ -6128,7 +6344,7 @@ const defaults$8 = {
 };
 class NoSelfClosing extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$8), options));
+        super({ ...defaults$8, ...options });
     }
     static schema() {
         return {
@@ -6267,7 +6483,7 @@ const defaults$7 = {
 };
 class PreferButton extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$7), options));
+        super({ ...defaults$7, ...options });
     }
     static schema() {
         return {
@@ -6372,7 +6588,7 @@ const defaults$6 = {
 };
 class PreferNativeElement extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$6), options));
+        super({ ...defaults$6, ...options });
     }
     static schema() {
         return {
@@ -6502,7 +6718,7 @@ const supportSri = {
 };
 class RequireSri extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$5), options));
+        super({ ...defaults$5, ...options });
         this.target = this.options.target;
     }
     static schema() {
@@ -8597,7 +8813,7 @@ const defaults$4 = {
 };
 class Void extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$4), options));
+        super({ ...defaults$4, ...options });
         this.style = parseStyle$1(this.options.style);
     }
     get deprecated() {
@@ -8706,7 +8922,7 @@ const defaults$3 = {
 };
 class VoidStyle extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$3), options));
+        super({ ...defaults$3, ...options });
         this.style = parseStyle(this.options.style);
     }
     static schema() {
@@ -8909,7 +9125,7 @@ const defaults$2 = {
 };
 class H37 extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$2), options));
+        super({ ...defaults$2, ...options });
         /* ensure alias is array */
         if (!Array.isArray(this.options.alias)) {
             this.options.alias = [this.options.alias];
@@ -9036,7 +9252,73 @@ const bundledRules$1 = {
     "wcag/h71": H71,
 };
 
-const bundledRules = Object.assign({ "allowed-links": AllowedLinks, "aria-label-misuse": AriaLabelMisuse, "attr-case": AttrCase, "attr-delimiter": AttrDelimiter, "attr-pattern": AttrPattern, "attr-quotes": AttrQuotes, "attr-spacing": AttrSpacing, "attribute-allowed-values": AttributeAllowedValues, "attribute-boolean-style": AttributeBooleanStyle, "attribute-empty-style": AttributeEmptyStyle, "class-pattern": ClassPattern, "close-attr": CloseAttr, "close-order": CloseOrder, deprecated: Deprecated, "deprecated-rule": DeprecatedRule, "doctype-html": NoStyleTag$1, "doctype-style": DoctypeStyle, "element-case": ElementCase, "element-name": ElementName, "element-permitted-content": ElementPermittedContent, "element-permitted-occurrences": ElementPermittedOccurrences, "element-permitted-order": ElementPermittedOrder, "element-required-attributes": ElementRequiredAttributes, "element-required-content": ElementRequiredContent, "empty-heading": EmptyHeading, "empty-title": EmptyTitle, "heading-level": HeadingLevel, "id-pattern": IdPattern, "input-attributes": InputAttributes, "input-missing-label": InputMissingLabel, "long-title": LongTitle, "meta-refresh": MetaRefresh, "missing-doctype": MissingDoctype, "multiple-labeled-controls": MultipleLabeledControls, "no-autoplay": NoAutoplay, "no-conditional-comment": NoConditionalComment, "no-deprecated-attr": NoDeprecatedAttr, "no-dup-attr": NoDupAttr, "no-dup-class": NoDupClass, "no-dup-id": NoDupID, "no-implicit-close": NoImplicitClose, "no-inline-style": NoInlineStyle, "no-missing-references": NoMissingReferences, "no-multiple-main": NoMultipleMain, "no-raw-characters": NoRawCharacters, "no-redundant-for": NoRedundantFor, "no-redundant-role": NoRedundantRole, "no-self-closing": NoSelfClosing, "no-style-tag": NoStyleTag, "no-trailing-whitespace": NoTrailingWhitespace, "no-unknown-elements": NoUnknownElements, "no-utf8-bom": NoUtf8Bom, "prefer-button": PreferButton, "prefer-native-element": PreferNativeElement, "prefer-tbody": PreferTbody, "require-sri": RequireSri, "script-element": ScriptElement, "script-type": ScriptType, "svg-focusable": SvgFocusable, "text-content": TextContent, "unrecognized-char-ref": UnknownCharReference, void: Void, "void-content": VoidContent, "void-style": VoidStyle }, bundledRules$1);
+const bundledRules = {
+    "allowed-links": AllowedLinks,
+    "aria-label-misuse": AriaLabelMisuse,
+    "attr-case": AttrCase,
+    "attr-delimiter": AttrDelimiter,
+    "attr-pattern": AttrPattern,
+    "attr-quotes": AttrQuotes,
+    "attr-spacing": AttrSpacing,
+    "attribute-allowed-values": AttributeAllowedValues,
+    "attribute-boolean-style": AttributeBooleanStyle,
+    "attribute-empty-style": AttributeEmptyStyle,
+    "class-pattern": ClassPattern,
+    "close-attr": CloseAttr,
+    "close-order": CloseOrder,
+    deprecated: Deprecated,
+    "deprecated-rule": DeprecatedRule,
+    "doctype-html": NoStyleTag$1,
+    "doctype-style": DoctypeStyle,
+    "element-case": ElementCase,
+    "element-name": ElementName,
+    "element-permitted-content": ElementPermittedContent,
+    "element-permitted-occurrences": ElementPermittedOccurrences,
+    "element-permitted-order": ElementPermittedOrder,
+    "element-required-attributes": ElementRequiredAttributes,
+    "element-required-content": ElementRequiredContent,
+    "empty-heading": EmptyHeading,
+    "empty-title": EmptyTitle,
+    "heading-level": HeadingLevel,
+    "id-pattern": IdPattern,
+    "input-attributes": InputAttributes,
+    "input-missing-label": InputMissingLabel,
+    "long-title": LongTitle,
+    "meta-refresh": MetaRefresh,
+    "missing-doctype": MissingDoctype,
+    "multiple-labeled-controls": MultipleLabeledControls,
+    "no-autoplay": NoAutoplay,
+    "no-conditional-comment": NoConditionalComment,
+    "no-deprecated-attr": NoDeprecatedAttr,
+    "no-dup-attr": NoDupAttr,
+    "no-dup-class": NoDupClass,
+    "no-dup-id": NoDupID,
+    "no-implicit-close": NoImplicitClose,
+    "no-inline-style": NoInlineStyle,
+    "no-missing-references": NoMissingReferences,
+    "no-multiple-main": NoMultipleMain,
+    "no-raw-characters": NoRawCharacters,
+    "no-redundant-for": NoRedundantFor,
+    "no-redundant-role": NoRedundantRole,
+    "no-self-closing": NoSelfClosing,
+    "no-style-tag": NoStyleTag,
+    "no-trailing-whitespace": NoTrailingWhitespace,
+    "no-unknown-elements": NoUnknownElements,
+    "no-utf8-bom": NoUtf8Bom,
+    "prefer-button": PreferButton,
+    "prefer-native-element": PreferNativeElement,
+    "prefer-tbody": PreferTbody,
+    "require-sri": RequireSri,
+    "script-element": ScriptElement,
+    "script-type": ScriptType,
+    "svg-focusable": SvgFocusable,
+    "text-content": TextContent,
+    "unrecognized-char-ref": UnknownCharReference,
+    void: Void,
+    "void-content": VoidContent,
+    "void-style": VoidStyle,
+    ...bundledRules$1,
+};
 
 var defaultConfig = {};
 
@@ -9274,7 +9556,7 @@ function overwriteMerge(a, b) {
     return b;
 }
 function mergeInternal(base, rhs) {
-    const dst = deepmerge(base, Object.assign(Object.assign({}, rhs), { rules: {} }));
+    const dst = deepmerge(base, { ...rhs, rules: {} });
     /* rules need some special care, should overwrite arrays instead of
      * concaternation, i.e. ["error", {...options}] should not be merged by
      * appending to old value */
@@ -9499,7 +9781,7 @@ class Config {
      * @internal primary purpose is unittests
      */
     get() {
-        const config = Object.assign({}, this.config);
+        const config = { ...this.config };
         if (config.elements) {
             config.elements = config.elements.map((cur) => {
                 if (typeof cur === "string") {
@@ -9585,7 +9867,11 @@ class Config {
             if (!properties) {
                 continue;
             }
-            for (const [key, schema] of Object.entries(properties)) {
+            for (const [raw, schema] of Object.entries(properties)) {
+                /* at compile time this is a fixed list but the point of this method is
+                 * to augment the runtime with additional keys so it is a bit of lying
+                 * to typescript */
+                const key = raw;
                 if (schema.copyable && !MetaCopyableProperty.includes(key)) {
                     MetaCopyableProperty.push(key);
                 }
@@ -9781,31 +10067,6 @@ class ConfigLoader {
     }
 }
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-
-function __rest(s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) if (e.indexOf(p[i]) < 0)
-            t[p[i]] = s[p[i]];
-    return t;
-}
-
 class EventHandler {
     constructor() {
         this.listeners = {};
@@ -10379,7 +10640,7 @@ class Reporter {
                     merged[key].messages = [...merged[key].messages, ...result.messages];
                 }
                 else {
-                    merged[key] = Object.assign({}, result);
+                    merged[key] = { ...result };
                 }
             });
         });
@@ -10481,14 +10742,16 @@ function messageSort(a, b) {
 }
 
 class Engine {
-    constructor(config, configData, ParserClass) {
+    constructor(config, ParserClass) {
         this.report = new Reporter();
-        this.configData = configData;
         this.config = config;
         this.ParserClass = ParserClass;
         /* initialize plugins and rules */
         const result = this.initPlugins(this.config);
-        this.availableRules = Object.assign(Object.assign({}, bundledRules), result.availableRules);
+        this.availableRules = {
+            ...bundledRules,
+            ...result.availableRules,
+        };
     }
     /**
      * Lint sources and return report
@@ -10513,13 +10776,13 @@ class Engine {
             /* trigger configuration ready event */
             const configEvent = {
                 location,
-                config: this.configData,
+                config: this.config,
                 rules,
             };
             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 sourceData = __rest(source, ["hooks"]);
+            const { hooks: _, ...sourceData } = source;
             const sourceEvent = {
                 location,
                 source: sourceData,
@@ -10826,133 +11089,31 @@ class Engine {
 }
 
 /**
- * @internal
- */
-function findConfigurationFiles(directory) {
-    return ["json", "cjs", "js"]
-        .map((extension) => path.join(directory, `.htmlvalidate.${extension}`))
-        .filter((filePath) => fs.existsSync(filePath));
-}
-/**
- * Loads configuration by traversing filesystem.
- *
- * Configuration is read from three sources and in the following order:
- *
- * 1. Global configuration passed to constructor.
- * 2. Configuration files found when traversing the directory structure.
- * 3. Override passed to this function.
- *
- * The following configuration filenames are searched:
- *
- * - `.htmlvalidate.json`
- * - `.htmlvalidate.js`
- * - `.htmlvalidate.cjs`
- *
- * Global configuration is used when no configuration file is found. The
- * result is always merged with override if present.
- *
- * The `root` property set to `true` affects the configuration as following:
+ * The static configuration loader does not do any per-handle lookup. Only the
+ * global or per-call configuration is used.
  *
- * 1. If set in override the override is returned as-is.
- * 2. If set in the global config the override is merged into global and
- * returned. No configuration files are searched.
- * 3. Setting `root` in configuration file only stops directory traversal.
+ * In practice this means no configuration is fetch by traversing the
+ * filesystem.
  */
-class FileSystemConfigLoader extends ConfigLoader {
-    /**
-     * @param config - Global configuration
-     * @param configFactory - Optional configuration factory
-     */
-    constructor(config, configFactory = Config) {
-        super(config, configFactory);
-        this.cache = new Map();
-    }
-    /**
-     * Get configuration for given filename.
-     *
-     * @param filename - Filename to get configuration for.
-     * @param configOverride - Configuration to merge final result with.
-     */
-    getConfigFor(filename, configOverride) {
-        /* special case when the overridden configuration is marked as root, should
-         * not try to load any more configuration files */
+class StaticConfigLoader extends ConfigLoader {
+    getConfigFor(handle, configOverride) {
         const override = this.loadFromObject(configOverride || {});
         if (override.isRootFound()) {
             override.init();
             return override;
         }
-        /* special case when the global configuration is marked as root, should not
-         * try to load and more configuration files */
-        if (this.globalConfig.isRootFound()) {
-            const merged = this.globalConfig.merge(override);
-            merged.init();
-            return merged;
-        }
-        const config = this.fromFilename(filename);
-        const merged = config ? config.merge(override) : this.globalConfig.merge(override);
+        const merged = this.globalConfig.merge(override);
         merged.init();
         return merged;
     }
-    /**
-     * Flush configuration cache.
-     *
-     * @param filename - If given only the cache for that file is flushed.
-     */
-    flushCache(filename) {
-        if (filename) {
-            this.cache.delete(filename);
-        }
-        else {
-            this.cache.clear();
-        }
-    }
-    /**
-     * Load raw configuration from directory traversal.
-     *
-     * This configuration is not merged with global configuration and may return
-     * `null` if no configuration files are found.
-     */
-    fromFilename(filename) {
-        var _a;
-        if (filename === "inline") {
-            return null;
-        }
-        if (this.cache.has(filename)) {
-            return (_a = this.cache.get(filename)) !== null && _a !== void 0 ? _a : null;
-        }
-        let found = false;
-        let current = path.resolve(path.dirname(filename));
-        let config = this.empty();
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
-            /* search configuration files in current directory */
-            for (const configFile of findConfigurationFiles(current)) {
-                const local = this.loadFromFile(configFile);
-                found = true;
-                config = local.merge(config);
-            }
-            /* stop if a configuration with "root" is set to true */
-            if (config.isRootFound()) {
-                break;
-            }
-            /* get the parent directory */
-            const child = current;
-            current = path.dirname(current);
-            /* stop if this is the root directory */
-            if (current === child) {
-                break;
-            }
-        }
-        /* no config was found by loader, return null and let caller decide what to do */
-        if (!found) {
-            this.cache.set(filename, null);
-            return null;
-        }
-        this.cache.set(filename, config);
-        return config;
+    flushCache() {
+        /* do nothing */
     }
     defaultConfig() {
-        return this.configFactory.defaultConfig();
+        return this.loadFromObject({
+            extends: ["html-validate:recommended"],
+            elements: ["html5"],
+        });
     }
 }
 
@@ -10976,7 +11137,7 @@ function isConfigData(value) {
 class HtmlValidate {
     constructor(arg) {
         const [loader, config] = arg instanceof ConfigLoader ? [arg, undefined] : [undefined, arg];
-        this.configLoader = loader !== null && loader !== void 0 ? loader : new FileSystemConfigLoader(config);
+        this.configLoader = loader !== null && loader !== void 0 ? loader : new StaticConfigLoader(config);
     }
     validateString(str, arg1, arg2, arg3) {
         const filename = typeof arg1 === "string" ? arg1 : "inline";
@@ -11003,7 +11164,7 @@ class HtmlValidate {
         const config = this.getConfigFor(input.filename, configOverride);
         const resolved = config.resolve();
         const source = resolved.transformSource(input);
-        const engine = new Engine(resolved, config.get(), Parser);
+        const engine = new Engine(resolved, Parser);
         return engine.lint(source);
     }
     /**
@@ -11017,7 +11178,7 @@ class HtmlValidate {
         const config = this.getConfigFor(filename);
         const resolved = config.resolve();
         const source = resolved.transformFilename(filename);
-        const engine = new Engine(resolved, config.get(), Parser);
+        const engine = new Engine(resolved, Parser);
         return engine.lint(source);
     }
     /**
@@ -11062,7 +11223,7 @@ class HtmlValidate {
         const config = this.getConfigFor(filename);
         const resolved = config.resolve();
         const source = resolved.transformFilename(filename);
-        const engine = new Engine(resolved, config.get(), Parser);
+        const engine = new Engine(resolved, Parser);
         return engine.dumpTokens(source);
     }
     /**
@@ -11077,7 +11238,7 @@ class HtmlValidate {
         const config = this.getConfigFor(filename);
         const resolved = config.resolve();
         const source = resolved.transformFilename(filename);
-        const engine = new Engine(resolved, config.get(), Parser);
+        const engine = new Engine(resolved, Parser);
         return engine.dumpEvents(source);
     }
     /**
@@ -11092,7 +11253,7 @@ class HtmlValidate {
         const config = this.getConfigFor(filename);
         const resolved = config.resolve();
         const source = resolved.transformFilename(filename);
-        const engine = new Engine(resolved, config.get(), Parser);
+        const engine = new Engine(resolved, Parser);
         return engine.dumpTree(source);
     }
     /**
@@ -11170,7 +11331,7 @@ class HtmlValidate {
      */
     getRuleDocumentation(ruleId, config = null, context = null) {
         const c = config || this.getConfigFor("inline");
-        const engine = new Engine(c.resolve(), c.get(), Parser);
+        const engine = new Engine(c.resolve(), Parser);
         return engine.getRuleDocumentation(ruleId, context);
     }
     /**
@@ -11207,35 +11368,6 @@ class HtmlValidate {
     }
 }
 
-/**
- * The static configuration loader does not do any per-handle lookup. Only the
- * global or per-call configuration is used.
- *
- * In practice this means no configuration is fetch by traversing the
- * filesystem.
- */
-class StaticConfigLoader extends ConfigLoader {
-    getConfigFor(handle, configOverride) {
-        const override = this.loadFromObject(configOverride || {});
-        if (override.isRootFound()) {
-            override.init();
-            return override;
-        }
-        const merged = this.globalConfig.merge(override);
-        merged.init();
-        return merged;
-    }
-    flushCache() {
-        /* do nothing */
-    }
-    defaultConfig() {
-        return this.loadFromObject({
-            extends: ["html-validate:recommended"],
-            elements: ["html5"],
-        });
-    }
-}
-
 const defaults$1 = {
     silent: false,
     version,
@@ -11253,7 +11385,7 @@ const defaults$1 = {
  * @returns - `true` if version is compatible
  */
 function compatibilityCheck(name, declared, options) {
-    const { silent, version: current, logger } = Object.assign(Object.assign({}, defaults$1), options);
+    const { silent, version: current, logger } = { ...defaults$1, ...options };
     const valid = semver.satisfies(current, declared);
     if (valid || silent) {
         return valid;
@@ -11283,6 +11415,137 @@ function ruleExists(ruleId) {
     return ruleIds.has(ruleId);
 }
 
+/**
+ * @internal
+ */
+function findConfigurationFiles(directory) {
+    return ["json", "cjs", "js"]
+        .map((extension) => path.join(directory, `.htmlvalidate.${extension}`))
+        .filter((filePath) => fs.existsSync(filePath));
+}
+/**
+ * Loads configuration by traversing filesystem.
+ *
+ * Configuration is read from three sources and in the following order:
+ *
+ * 1. Global configuration passed to constructor.
+ * 2. Configuration files found when traversing the directory structure.
+ * 3. Override passed to this function.
+ *
+ * The following configuration filenames are searched:
+ *
+ * - `.htmlvalidate.json`
+ * - `.htmlvalidate.js`
+ * - `.htmlvalidate.cjs`
+ *
+ * Global configuration is used when no configuration file is found. The
+ * result is always merged with override if present.
+ *
+ * The `root` property set to `true` affects the configuration as following:
+ *
+ * 1. If set in override the override is returned as-is.
+ * 2. If set in the global config the override is merged into global and
+ * returned. No configuration files are searched.
+ * 3. Setting `root` in configuration file only stops directory traversal.
+ */
+class FileSystemConfigLoader extends ConfigLoader {
+    /**
+     * @param config - Global configuration
+     * @param configFactory - Optional configuration factory
+     */
+    constructor(config, configFactory = Config) {
+        super(config, configFactory);
+        this.cache = new Map();
+    }
+    /**
+     * Get configuration for given filename.
+     *
+     * @param filename - Filename to get configuration for.
+     * @param configOverride - Configuration to merge final result with.
+     */
+    getConfigFor(filename, configOverride) {
+        /* special case when the overridden configuration is marked as root, should
+         * not try to load any more configuration files */
+        const override = this.loadFromObject(configOverride || {});
+        if (override.isRootFound()) {
+            override.init();
+            return override;
+        }
+        /* special case when the global configuration is marked as root, should not
+         * try to load and more configuration files */
+        if (this.globalConfig.isRootFound()) {
+            const merged = this.globalConfig.merge(override);
+            merged.init();
+            return merged;
+        }
+        const config = this.fromFilename(filename);
+        const merged = config ? config.merge(override) : this.globalConfig.merge(override);
+        merged.init();
+        return merged;
+    }
+    /**
+     * Flush configuration cache.
+     *
+     * @param filename - If given only the cache for that file is flushed.
+     */
+    flushCache(filename) {
+        if (filename) {
+            this.cache.delete(filename);
+        }
+        else {
+            this.cache.clear();
+        }
+    }
+    /**
+     * Load raw configuration from directory traversal.
+     *
+     * This configuration is not merged with global configuration and may return
+     * `null` if no configuration files are found.
+     */
+    fromFilename(filename) {
+        var _a;
+        if (filename === "inline") {
+            return null;
+        }
+        if (this.cache.has(filename)) {
+            return (_a = this.cache.get(filename)) !== null && _a !== void 0 ? _a : null;
+        }
+        let found = false;
+        let current = path.resolve(path.dirname(filename));
+        let config = this.empty();
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            /* search configuration files in current directory */
+            for (const configFile of findConfigurationFiles(current)) {
+                const local = this.loadFromFile(configFile);
+                found = true;
+                config = local.merge(config);
+            }
+            /* stop if a configuration with "root" is set to true */
+            if (config.isRootFound()) {
+                break;
+            }
+            /* get the parent directory */
+            const child = current;
+            current = path.dirname(current);
+            /* stop if this is the root directory */
+            if (current === child) {
+                break;
+            }
+        }
+        /* no config was found by loader, return null and let caller decide what to do */
+        if (!found) {
+            this.cache.set(filename, null);
+            return null;
+        }
+        this.cache.set(filename, config);
+        return config;
+    }
+    defaultConfig() {
+        return this.configFactory.defaultConfig();
+    }
+}
+
 const entities = {
     ">": "&gt;",
     "<": "&lt;",
@@ -11433,7 +11696,7 @@ function formatSummary(errors, warnings) {
     return kleur[summaryColor]().bold(`${summary.join(" and ")} found.`);
 }
 function codeframe(results, options) {
-    const merged = Object.assign(Object.assign({}, defaults), options);
+    const merged = { ...defaults, ...options };
     let errors = 0;
     let warnings = 0;
     const resultsWithMessages = results.filter((result) => result.messages.length > 0);
@@ -11474,7 +11737,11 @@ function linkSummary(results) {
     return `\n${kleur.bold("More information")}:\n${lines.join("")}\n`;
 }
 function stylish(results) {
-    const errors = stylishImpl(results.map((it) => (Object.assign(Object.assign({}, it), { fixableErrorCount: 0, fixableWarningCount: 0 }))));
+    const errors = stylishImpl(results.map((it) => ({
+        ...it,
+        fixableErrorCount: 0,
+        fixableWarningCount: 0,
+    })));
     const links = linkSummary(results);
     return `${errors}${links}`;
 }
@@ -11525,5 +11792,5 @@ function getFormatter(name) {
     return (_a = availableFormatters[name]) !== null && _a !== void 0 ? _a : null;
 }
 
-export { 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, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, HtmlElement as d, SchemaValidationError as e, MetaCopyableProperty as f, Reporter as g, TemplateExtractor as h, getFormatter as i, compatibilityCheck as j, bugs as k, legacyRequire as l, TokenType as m, name as n, presets as p, ruleExists as r, version as v };
+export { 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, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, HtmlElement as d, SchemaValidationError as e, MetaCopyableProperty as f, Reporter as g, TemplateExtractor as h, getFormatter as i, compatibilityCheck as j, TokenType as k, legacyRequire as l, bugs as m, name as n, presets as p, ruleExists as r, version as v };
 //# sourceMappingURL=core.js.map