html-validate 5.3.0 → 6.0.0

package/dist/cjs/core.js

@@ -268,7 +268,7 @@ class UserError extends NestedError {
 }
 
 function getSummary(schema, obj, errors) {
-    const output = betterAjvErrors__default['default'](schema, obj, errors, {
+    const output = betterAjvErrors__default["default"](schema, obj, errors, {
         format: "js",
     });
     // istanbul ignore next: for safety only
@@ -285,15 +285,15 @@ class SchemaValidationError extends UserError {
     }
     prettyError() {
         const json = this.getRawJSON();
-        return betterAjvErrors__default['default'](this.schema, this.obj, this.errors, {
+        return betterAjvErrors__default["default"](this.schema, this.obj, this.errors, {
             format: "cli",
             indent: 2,
             json,
         });
     }
     getRawJSON() {
-        if (this.filename && fs__default['default'].existsSync(this.filename)) {
-            return fs__default['default'].readFileSync(this.filename, "utf-8");
+        if (this.filename && fs__default["default"].existsSync(this.filename)) {
+            return fs__default["default"].readFileSync(this.filename, "utf-8");
         }
         else {
             return null;
@@ -301,9 +301,9 @@ class SchemaValidationError extends UserError {
     }
 }
 
-const projectRoot = path__default['default'].resolve(__dirname, "../../");
+const projectRoot = path__default["default"].resolve(__dirname, "../../");
 			const legacyRequire = require;
-			const distFolder = path__default['default'].resolve(projectRoot, "dist/cjs");
+			const distFolder = path__default["default"].resolve(projectRoot, "dist/cjs");
 
 /**
  * Similar to `require(..)` but removes the cached copy first.
@@ -586,18 +586,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
 						}
-					]
-				}
+					}
+				]
 			}
 		}
 	},
@@ -648,6 +693,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",
@@ -710,7 +860,7 @@ class MetaTable {
      */
     extendValidationSchema(patch) {
         if (patch.properties) {
-            this.schema = jsonMergePatch__default['default'].apply(this.schema, {
+            this.schema = jsonMergePatch__default["default"].apply(this.schema, {
                 patternProperties: {
                     "^[^$].*$": {
                         properties: patch.properties,
@@ -719,7 +869,7 @@ class MetaTable {
             });
         }
         if (patch.definitions) {
-            this.schema = jsonMergePatch__default['default'].apply(this.schema, {
+            this.schema = jsonMergePatch__default["default"].apply(this.schema, {
                 definitions: patch.definitions,
             });
         }
@@ -741,7 +891,7 @@ class MetaTable {
         for (const [key, value] of Object.entries(obj)) {
             if (key === "$schema")
                 continue;
-            this.addEntry(key, value);
+            this.addEntry(key, migrateElement(value));
         }
     }
     /**
@@ -769,7 +919,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.
@@ -798,7 +948,7 @@ class MetaTable {
             }
         }
         /* merge all sources together */
-        const expanded = deepmerge__default['default'](parent, Object.assign(Object.assign({}, entry), { tagName }), { arrayMerge: overwriteMerge$1 });
+        const expanded = this.mergeElement(parent, { ...entry, tagName });
         expandRegex(expanded);
         this.elements[tagName] = expanded;
     }
@@ -806,7 +956,7 @@ class MetaTable {
      * Construct a new AJV schema validator.
      */
     getSchemaValidator() {
-        const ajv = new Ajv__default['default']({ strict: true, strictTuples: true, strictTypes: true });
+        const ajv = new Ajv__default["default"]({ strict: true, strictTuples: true, strictTypes: true });
         ajv.addMetaSchema(ajvSchemaDraft);
         ajv.addKeyword(ajvRegexpKeyword);
         ajv.addKeyword({ keyword: "copyable" });
@@ -832,11 +982,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__default['default'](a, b);
+        const merged = deepmerge__default["default"](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) {
@@ -848,7 +1007,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));
         }
     }
 }
@@ -874,14 +1033,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);
         }
     }
 }
@@ -937,41 +1091,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;
@@ -1342,6 +1461,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;
@@ -1814,8 +1942,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];
@@ -2231,6 +2360,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) {
@@ -2244,19 +2374,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);
             }
@@ -2522,12 +2667,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;
 }
@@ -2632,7 +2777,7 @@ class TemplateExtractor {
         this.data = data;
     }
     static fromFilename(filename) {
-        const source = fs__default['default'].readFileSync(filename, "utf-8");
+        const source = fs__default["default"].readFileSync(filename, "utf-8");
         const ast = espree.parse(source, {
             ecmaVersion: 2017,
             sourceType: "module",
@@ -2668,7 +2813,7 @@ class TemplateExtractor {
      * functions.
      */
     static createSource(filename) {
-        const data = fs__default['default'].readFileSync(filename, "utf-8");
+        const data = fs__default["default"].readFileSync(filename, "utf-8");
         return [
             {
                 column: 1,
@@ -2719,7 +2864,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"
@@ -2756,7 +2901,7 @@ const remapEvents = {
     "tag:open": "tag:start",
     "tag:close": "tag:end",
 };
-const ajv$1 = new Ajv__default['default']({ strict: true, strictTuples: true, strictTypes: true });
+const ajv$1 = new Ajv__default["default"]({ strict: true, strictTuples: true, strictTypes: true });
 ajv$1.addMetaSchema(ajvSchemaDraft);
 /**
  * Get (cached) schema validator for rule options.
@@ -2984,9 +3129,9 @@ function ruleDocumentationUrl(filename) {
      * folder and with the @/ prefix, by replacing the @ with the dist folder we
      * can resolve the path properly */
     filename = filename.replace("@", distFolder);
-    const p = path__default['default'].parse(filename);
-    const root = path__default['default'].join(distFolder, "rules");
-    const rel = path__default['default'].relative(root, path__default['default'].join(p.dir, p.name));
+    const p = path__default["default"].parse(filename);
+    const root = path__default["default"].join(distFolder, "rules");
+    const rel = path__default["default"].relative(root, path__default["default"].join(p.dir, p.name));
     return `${homepage}/rules/${rel}.html`;
 }
 
@@ -3011,7 +3156,7 @@ const description = {
 };
 class AllowedLinks extends Rule {
     constructor(options) {
-        super(Object.assign(Object.assign({}, defaults$p), options));
+        super({ ...defaults$p, ...options });
     }
     static schema() {
         return {
@@ -3259,7 +3404,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() {
@@ -3612,7 +3757,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() {
@@ -3678,7 +3823,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() {
@@ -3774,11 +3919,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;
@@ -3834,7 +3979,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() {
@@ -3879,7 +4024,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) {
@@ -3914,7 +4060,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() {
@@ -3963,7 +4109,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 */
@@ -4026,7 +4173,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() {
@@ -4139,7 +4286,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 {
@@ -4233,7 +4380,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);
@@ -4307,7 +4454,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 {
@@ -4344,7 +4491,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() {
@@ -4414,7 +4561,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);
     }
@@ -4686,9 +4833,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 = {
@@ -4842,6 +4994,7 @@ class EmptyTitle extends Rule {
 
 const defaults$e = {
     allowMultipleH1: false,
+    minInitialRank: "h1",
     sectioningRoots: ["dialog", '[role="dialog"]'],
 };
 function isRelevant$2(event) {
@@ -4857,10 +5010,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({
@@ -4874,6 +5039,9 @@ class HeadingLevel extends Rule {
             allowMultipleH1: {
                 type: "boolean",
             },
+            minInitialRank: {
+                enum: ["h1", "h2", "h3", "h4", "h5", "h6", "any", false],
+            },
             sectioningRoots: {
                 items: {
                     type: "string",
@@ -4884,7 +5052,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("");
@@ -4929,20 +5098,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 {
@@ -5005,7 +5186,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() {
@@ -5357,7 +5538,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() {
@@ -5510,7 +5691,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}>` : "";
@@ -5606,8 +5787,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);
             }
         });
@@ -5764,7 +5949,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 {
@@ -5858,7 +6043,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) {
@@ -5880,38 +6078,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 {
@@ -5955,7 +6171,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() {
@@ -6140,7 +6356,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 {
@@ -6279,7 +6495,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 {
@@ -6384,7 +6600,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 {
@@ -6514,7 +6730,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() {
@@ -8609,7 +8825,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() {
@@ -8718,7 +8934,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() {
@@ -8921,7 +9137,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];
@@ -9048,7 +9264,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 = {};
 
@@ -9254,7 +9536,7 @@ class ResolvedConfig {
      * @returns A list of transformed sources ready for validation.
      */
     transformFilename(filename) {
-        const data = fs__default['default'].readFileSync(filename, { encoding: "utf8" });
+        const data = fs__default["default"].readFileSync(filename, { encoding: "utf8" });
         const source = {
             data,
             filename,
@@ -9279,19 +9561,19 @@ class ResolvedConfig {
 }
 
 let rootDirCache = null;
-const ajv = new Ajv__default['default']({ strict: true, strictTuples: true, strictTypes: true });
+const ajv = new Ajv__default["default"]({ strict: true, strictTuples: true, strictTypes: true });
 ajv.addMetaSchema(ajvSchemaDraft);
 const validator = ajv.compile(configurationSchema);
 function overwriteMerge(a, b) {
     return b;
 }
 function mergeInternal(base, rhs) {
-    const dst = deepmerge__default['default'](base, Object.assign(Object.assign({}, rhs), { rules: {} }));
+    const dst = deepmerge__default["default"](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 */
     if (rhs.rules) {
-        dst.rules = deepmerge__default['default'](dst.rules, rhs.rules, { arrayMerge: overwriteMerge });
+        dst.rules = deepmerge__default["default"](dst.rules, rhs.rules, { arrayMerge: overwriteMerge });
     }
     /* root property is merged with boolean "or" since it should always be truthy
      * if any config has it set. */
@@ -9315,7 +9597,7 @@ function loadFromFile(filename) {
         if (!json[key])
             continue;
         json[key] = json[key].map((ref) => {
-            return Config.expandRelative(ref, path__default['default'].dirname(filename));
+            return Config.expandRelative(ref, path__default["default"].dirname(filename));
         });
     }
     return json;
@@ -9474,14 +9756,14 @@ class Config {
             }
             let filename;
             /* try searching builtin metadata */
-            filename = path__default['default'].join(projectRoot, "elements", `${entry}.json`);
-            if (fs__default['default'].existsSync(filename)) {
+            filename = path__default["default"].join(projectRoot, "elements", `${entry}.json`);
+            if (fs__default["default"].existsSync(filename)) {
                 metaTable.loadFromFile(filename);
                 continue;
             }
             /* try as regular file */
             filename = entry.replace("<rootDir>", this.rootDir);
-            if (fs__default['default'].existsSync(filename)) {
+            if (fs__default["default"].existsSync(filename)) {
                 metaTable.loadFromFile(filename);
                 continue;
             }
@@ -9501,7 +9783,7 @@ class Config {
      */
     static expandRelative(src, currentPath) {
         if (src[0] === ".") {
-            return path__default['default'].normalize(`${currentPath}/${src}`);
+            return path__default["default"].normalize(`${currentPath}/${src}`);
         }
         return src;
     }
@@ -9511,7 +9793,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") {
@@ -9597,7 +9879,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);
                 }
@@ -9751,13 +10037,13 @@ class Config {
         let current = process.cwd();
         // eslint-disable-next-line no-constant-condition
         while (true) {
-            const search = path__default['default'].join(current, "package.json");
-            if (fs__default['default'].existsSync(search)) {
+            const search = path__default["default"].join(current, "package.json");
+            if (fs__default["default"].existsSync(search)) {
                 return (this.rootDirCache = current);
             }
             /* get the parent directory */
             const child = current;
-            current = path__default['default'].dirname(current);
+            current = path__default["default"].dirname(current);
             /* stop if this is the root directory */
             if (current === child) {
                 break;
@@ -9793,31 +10079,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 = {};
@@ -10391,7 +10652,7 @@ class Reporter {
                     merged[key].messages = [...merged[key].messages, ...result.messages];
                 }
                 else {
-                    merged[key] = Object.assign({}, result);
+                    merged[key] = { ...result };
                 }
             });
         });
@@ -10493,14 +10754,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
@@ -10525,13 +10788,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,
@@ -10838,133 +11101,31 @@ class Engine {
 }
 
 /**
- * @internal
- */
-function findConfigurationFiles(directory) {
-    return ["json", "cjs", "js"]
-        .map((extension) => path__default['default'].join(directory, `.htmlvalidate.${extension}`))
-        .filter((filePath) => fs__default['default'].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__default['default'].resolve(path__default['default'].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__default['default'].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"],
+        });
     }
 }
 
@@ -10988,7 +11149,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";
@@ -11015,7 +11176,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);
     }
     /**
@@ -11029,7 +11190,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);
     }
     /**
@@ -11053,7 +11214,7 @@ class HtmlValidate {
      */
     canValidate(filename) {
         /* .html is always supported */
-        const extension = path__default['default'].extname(filename).toLowerCase();
+        const extension = path__default["default"].extname(filename).toLowerCase();
         if (extension === ".html") {
             return true;
         }
@@ -11074,7 +11235,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);
     }
     /**
@@ -11089,7 +11250,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);
     }
     /**
@@ -11104,7 +11265,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);
     }
     /**
@@ -11182,7 +11343,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);
     }
     /**
@@ -11219,41 +11380,12 @@ 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,
     logger(text) {
         /* eslint-disable-next-line no-console */
-        console.error(kleur__default['default'].red(text));
+        console.error(kleur__default["default"].red(text));
     },
 };
 /**
@@ -11265,8 +11397,8 @@ 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 valid = semver__default['default'].satisfies(current, declared);
+    const { silent, version: current, logger } = { ...defaults$1, ...options };
+    const valid = semver__default["default"].satisfies(current, declared);
     if (valid || silent) {
         return valid;
     }
@@ -11295,6 +11427,137 @@ function ruleExists(ruleId) {
     return ruleIds.has(ruleId);
 }
 
+/**
+ * @internal
+ */
+function findConfigurationFiles(directory) {
+    return ["json", "cjs", "js"]
+        .map((extension) => path__default["default"].join(directory, `.htmlvalidate.${extension}`))
+        .filter((filePath) => fs__default["default"].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__default["default"].resolve(path__default["default"].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__default["default"].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;",
@@ -11366,12 +11629,12 @@ function pluralize(word, count) {
  * @returns The formatted file path.
  */
 function formatFilePath(filePath, line, column) {
-    let relPath = path__default['default'].relative(process.cwd(), filePath);
+    let relPath = path__default["default"].relative(process.cwd(), filePath);
     /* istanbul ignore next: safety check from original implementation */
     if (line && column) {
         relPath += `:${line}:${column}`;
     }
-    return kleur__default['default'].green(relPath);
+    return kleur__default["default"].green(relPath);
 }
 function getStartLocation(message) {
     return {
@@ -11400,9 +11663,9 @@ function getEndLocation(message, source) {
  * @returns The formatted output.
  */
 function formatMessage(message, parentResult, options) {
-    const type = message.severity === 2 ? kleur__default['default'].red("error") : kleur__default['default'].yellow("warning");
-    const msg = `${kleur__default['default'].bold(message.message.replace(/([^ ])\.$/, "$1"))}`;
-    const ruleId = kleur__default['default'].dim(`(${message.ruleId})`);
+    const type = message.severity === 2 ? kleur__default["default"].red("error") : kleur__default["default"].yellow("warning");
+    const msg = `${kleur__default["default"].bold(message.message.replace(/([^ ])\.$/, "$1"))}`;
+    const ruleId = kleur__default["default"].dim(`(${message.ruleId})`);
     const filePath = formatFilePath(parentResult.filePath, message.line, message.column);
     const sourceCode = parentResult.source;
     /* istanbul ignore next: safety check from original implementation */
@@ -11423,7 +11686,7 @@ function formatMessage(message, parentResult, options) {
         }, { highlightCode: false }));
     }
     if (options.showLink && message.ruleUrl) {
-        result.push(`${kleur__default['default'].bold("Details:")} ${message.ruleUrl}`);
+        result.push(`${kleur__default["default"].bold("Details:")} ${message.ruleUrl}`);
     }
     return result.join("\n");
 }
@@ -11442,10 +11705,10 @@ function formatSummary(errors, warnings) {
     if (warnings > 0) {
         summary.push(`${warnings} ${pluralize("warning", warnings)}`);
     }
-    return kleur__default['default'][summaryColor]().bold(`${summary.join(" and ")} found.`);
+    return kleur__default["default"][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);
@@ -11483,10 +11746,14 @@ function linkSummary(results) {
         return "";
     }
     const lines = unique.map((url) => `  ${url}\n`);
-    return `\n${kleur__default['default'].bold("More information")}:\n${lines.join("")}\n`;
+    return `\n${kleur__default["default"].bold("More information")}:\n${lines.join("")}\n`;
 }
 function stylish(results) {
-    const errors = stylishImpl__default['default'](results.map((it) => (Object.assign(Object.assign({}, it), { fixableErrorCount: 0, fixableWarningCount: 0 }))));
+    const errors = stylishImpl__default["default"](results.map((it) => ({
+        ...it,
+        fixableErrorCount: 0,
+        fixableWarningCount: 0,
+    })));
     const links = linkSummary(results);
     return `${errors}${links}`;
 }