html-validate 9.2.2 → 9.4.0

package/dist/cjs/core.js

@@ -4,7 +4,6 @@ var Ajv = require('ajv');
 var elements = require('./elements.js');
 var betterAjvErrors = require('@sidvind/better-ajv-errors');
 var utils_naturalJoin = require('./utils/natural-join.js');
-var fs = require('node:fs');
 var kleur = require('kleur');
 var stylish$1 = require('@html-validate/stylish');
 var semver = require('semver');
@@ -13,7 +12,6 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var Ajv__default = /*#__PURE__*/_interopDefault(Ajv);
 var betterAjvErrors__default = /*#__PURE__*/_interopDefault(betterAjvErrors);
-var fs__default = /*#__PURE__*/_interopDefault(fs);
 var kleur__default = /*#__PURE__*/_interopDefault(kleur);
 var semver__default = /*#__PURE__*/_interopDefault(semver);
 
@@ -6608,7 +6606,7 @@ const defaults$j = {
   minInitialRank: "h1",
   sectioningRoots: ["dialog", '[role="dialog"]', '[role="alertdialog"]']
 };
-function isRelevant$6(event) {
+function isRelevant$5(event) {
   const node = event.target;
   return Boolean(node.meta?.heading);
 }
@@ -6677,7 +6675,7 @@ class HeadingLevel extends Rule {
     };
   }
   setup() {
-    this.on("tag:start", isRelevant$6, (event) => {
+    this.on("tag:start", isRelevant$5, (event) => {
       this.onTagStart(event);
     });
     this.on("tag:ready", (event) => {
@@ -7333,7 +7331,7 @@ class MapDupName extends Rule {
   }
 }
 
-function isRelevant$5(event) {
+function isRelevant$4(event) {
   return event.target.is("map");
 }
 function hasStaticValue(attr) {
@@ -7347,7 +7345,7 @@ class MapIdName extends Rule {
     };
   }
   setup() {
-    this.on("tag:ready", isRelevant$5, (event) => {
+    this.on("tag:ready", isRelevant$4, (event) => {
       const { target } = event;
       const id = target.getAttribute("id");
       const name = target.getAttribute("name");
@@ -7471,7 +7469,7 @@ const abstractRoles = [
   "widget",
   "window"
 ];
-function isRelevant$4(event) {
+function isRelevant$3(event) {
   return event.key === "role";
 }
 class NoAbstractRole extends Rule {
@@ -7490,7 +7488,7 @@ class NoAbstractRole extends Rule {
     };
   }
   setup() {
-    this.on("attr", isRelevant$4, (event) => {
+    this.on("attr", isRelevant$3, (event) => {
       const roles = event.value;
       if (!roles || roles instanceof DynamicValue) {
         return;
@@ -7691,17 +7689,25 @@ class NoDupID extends Rule {
   setup() {
     this.on("dom:ready", (event) => {
       const { document } = event;
+      const rootExisting = getExisting(document.root, document.root);
+      const useRootExisting = !document.querySelector("template");
       const elements = document.querySelectorAll("[id]");
-      const relevant = elements.filter(isRelevant$3);
-      for (const el of relevant) {
+      for (const el of elements) {
         const attr = el.getAttribute("id");
-        if (!attr?.value) {
+        if (!attr) {
+          continue;
+        }
+        if (!attr.value) {
+          continue;
+        }
+        if (attr.isDynamic) {
           continue;
         }
         const id = attr.value.toString();
-        const existing = getExisting(el, document.root);
+        const existing = useRootExisting ? rootExisting : getExisting(el, document.root);
         if (existing.has(id)) {
           this.report(el, `Duplicate ID "${id}"`, attr.valueLocation);
+          continue;
         }
         existing.add(id);
       }
@@ -7718,19 +7724,6 @@ function getExisting(element, root) {
     return group.cacheSet(CACHE_KEY, existing2);
   }
 }
-function isRelevant$3(element) {
-  const attr = element.getAttribute("id");
-  if (!attr) {
-    return false;
-  }
-  if (!attr.value) {
-    return false;
-  }
-  if (attr.isDynamic) {
-    return false;
-  }
-  return true;
-}
 
 function isRelevant$2(event) {
   return event.target.is("button");
@@ -9971,14 +9964,15 @@ class ValidID extends Rule {
   }
   documentation(context) {
     const { relaxed } = this.options;
-    const message = this.messages[context].replace("id", "ID").replace(/^(.)/, (m) => m.toUpperCase());
+    const { kind, id } = context;
+    const message = this.messages[kind].replace(`"{{ id }}"`, "`{{ id }}`").replace("id", "ID").replace(/^(.)/, (m) => m.toUpperCase());
     const relaxedDescription = relaxed ? [] : [
       "  - ID must begin with a letter",
       "  - ID must only contain letters, digits, `-` and `_`"
     ];
     return {
       description: [
-        `${message}.`,
+        `${interpolate(message, { id })}.`,
         "",
         "Under the current configuration the following rules are applied:",
         "",
@@ -9996,13 +9990,13 @@ class ValidID extends Rule {
         return;
       }
       if (value === "") {
-        const context = 1 /* EMPTY */;
-        this.report(event.target, this.messages[context], event.location, context);
+        const context = { kind: 1 /* EMPTY */, id: value };
+        this.report(event.target, this.messages[context.kind], event.location, context);
         return;
       }
       if (value.match(/\s/)) {
-        const context = 2 /* WHITESPACE */;
-        this.report(event.target, this.messages[context], event.valueLocation, context);
+        const context = { kind: 2 /* WHITESPACE */, id: value };
+        this.report(event.target, this.messages[context.kind], event.valueLocation, context);
         return;
       }
       const { relaxed } = this.options;
@@ -10010,22 +10004,22 @@ class ValidID extends Rule {
         return;
       }
       if (value.match(/^[^\p{L}]/u)) {
-        const context = 3 /* LEADING_CHARACTER */;
-        this.report(event.target, this.messages[context], event.valueLocation, context);
+        const context = { kind: 3 /* LEADING_CHARACTER */, id: value };
+        this.report(event.target, this.messages[context.kind], event.valueLocation, context);
         return;
       }
       if (value.match(/[^\p{L}\p{N}_-]/u)) {
-        const context = 4 /* DISALLOWED_CHARACTER */;
-        this.report(event.target, this.messages[context], event.valueLocation, context);
+        const context = { kind: 4 /* DISALLOWED_CHARACTER */, id: value };
+        this.report(event.target, this.messages[context.kind], event.valueLocation, context);
       }
     });
   }
   get messages() {
     return {
-      [1 /* EMPTY */]: "element id must not be empty",
-      [2 /* WHITESPACE */]: "element id must not contain whitespace",
-      [3 /* LEADING_CHARACTER */]: "element id must begin with a letter",
-      [4 /* DISALLOWED_CHARACTER */]: "element id must only contain letters, digits, dash and underscore characters"
+      [1 /* EMPTY */]: `element id "{{ id }}" must not be empty`,
+      [2 /* WHITESPACE */]: `element id "{{ id }}" must not contain whitespace`,
+      [3 /* LEADING_CHARACTER */]: `element id "{{ id }}" must begin with a letter`,
+      [4 /* DISALLOWED_CHARACTER */]: `element id "{{ id }}" must only contain letters, digits, dash and underscore characters`
     };
   }
   isRelevant(event) {
@@ -10090,29 +10084,41 @@ class VoidStyle extends Rule {
     };
   }
   setup() {
+    const { style } = this;
+    const validateStyle = {
+      [1 /* AlwaysOmit */]: this.validateOmitted.bind(this),
+      [2 /* AlwaysSelfclose */]: this.validateSelfClosed.bind(this)
+    }[style];
     this.on("tag:end", (event) => {
       const active = event.previous;
       if (active.meta) {
-        this.validateActive(active);
+        validateStyle(active);
       }
     });
   }
-  validateActive(node) {
+  validateOmitted(node) {
     if (!node.voidElement) {
       return;
     }
-    if (this.shouldBeOmitted(node)) {
-      this.reportError(
-        node,
-        `Expected omitted end tag <${node.tagName}> instead of self-closing element <${node.tagName}/>`
-      );
+    if (node.closed !== NodeClosed.VoidSelfClosed) {
+      return;
     }
-    if (this.shouldBeSelfClosed(node)) {
-      this.reportError(
-        node,
-        `Expected self-closing element <${node.tagName}/> instead of omitted end-tag <${node.tagName}>`
-      );
+    this.reportError(
+      node,
+      `Expected omitted end tag <${node.tagName}> instead of self-closing element <${node.tagName}/>`
+    );
+  }
+  validateSelfClosed(node) {
+    if (!node.voidElement) {
+      return;
+    }
+    if (node.closed !== NodeClosed.VoidOmitted) {
+      return;
     }
+    this.reportError(
+      node,
+      `Expected self-closing element <${node.tagName}/> instead of omitted end-tag <${node.tagName}>`
+    );
   }
   reportError(node, message) {
     const context = {
@@ -10121,12 +10127,6 @@ class VoidStyle extends Rule {
     };
     super.report(node, message, null, context);
   }
-  shouldBeOmitted(node) {
-    return this.style === 1 /* AlwaysOmit */ && node.closed === NodeClosed.VoidSelfClosed;
-  }
-  shouldBeSelfClosed(node) {
-    return this.style === 2 /* AlwaysSelfclose */ && node.closed === NodeClosed.VoidOmitted;
-  }
 }
 function parseStyle(name) {
   switch (name) {
@@ -11521,6 +11521,75 @@ function defineConfig(config) {
   return config;
 }
 
+const defaultResolvers = [];
+function hasResolver(value) {
+  return Array.isArray(value[0]);
+}
+class StaticConfigLoader extends ConfigLoader {
+  constructor(...args) {
+    if (hasResolver(args)) {
+      const [resolvers, config] = args;
+      super(resolvers, config);
+    } else {
+      const [config] = args;
+      super(defaultResolvers, config);
+    }
+  }
+  /**
+   * Set a new configuration for this loader.
+   *
+   * @public
+   * @since 8.20.0
+   * @param config - New configuration to use.
+   */
+  setConfig(config) {
+    this.setConfigData(config);
+  }
+  getConfigFor(_handle, configOverride) {
+    const override = this.loadFromObject(configOverride ?? {});
+    if (isThenable(override)) {
+      return override.then((override2) => this._resolveConfig(override2));
+    } else {
+      return this._resolveConfig(override);
+    }
+  }
+  flushCache() {
+  }
+  defaultConfig() {
+    return this.loadFromObject({
+      extends: ["html-validate:recommended"],
+      elements: ["html5"]
+    });
+  }
+  _resolveConfig(override) {
+    if (override.isRootFound()) {
+      return override.resolve();
+    }
+    const globalConfig = this.getGlobalConfig();
+    if (isThenable(globalConfig)) {
+      return globalConfig.then((globalConfig2) => {
+        const merged = globalConfig2.merge(this.resolvers, override);
+        if (isThenable(merged)) {
+          return merged.then((merged2) => {
+            return merged2.resolve();
+          });
+        } else {
+          return merged.resolve();
+        }
+      });
+    } else {
+      const merged = globalConfig.merge(this.resolvers, override);
+      if (isThenable(merged)) {
+        return merged.then((merged2) => {
+          return merged2.resolve();
+        });
+      } else {
+        return merged.resolve();
+      }
+    }
+  }
+}
+
 class EventHandler {
   listeners;
   constructor() {
@@ -11582,6 +11651,153 @@ class EventHandler {
   }
 }
 
+const name = "html-validate";
+const version = "9.4.0";
+const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
+
+function freeze(src) {
+  return {
+    ...src,
+    selector: src.selector()
+  };
+}
+function isThenableArray(value) {
+  if (value.length === 0) {
+    return false;
+  }
+  return isThenable(value[0]);
+}
+class Reporter {
+  result;
+  constructor() {
+    this.result = {};
+  }
+  static merge(reports) {
+    if (isThenable(reports)) {
+      return reports.then((reports2) => this.merge(reports2));
+    }
+    if (isThenableArray(reports)) {
+      return Promise.all(reports).then((reports2) => this.merge(reports2));
+    }
+    const valid = reports.every((report) => report.valid);
+    const merged = {};
+    reports.forEach((report) => {
+      report.results.forEach((result) => {
+        const key = result.filePath;
+        if (key in merged) {
+          merged[key].messages = [...merged[key].messages, ...result.messages];
+        } else {
+          merged[key] = { ...result };
+        }
+      });
+    });
+    const results = Object.values(merged).map((result) => {
+      result.errorCount = countErrors(result.messages);
+      result.warningCount = countWarnings(result.messages);
+      return result;
+    });
+    return {
+      valid,
+      results,
+      errorCount: sumErrors(results),
+      warningCount: sumWarnings(results)
+    };
+  }
+  add(rule, message, severity, node, location, context) {
+    if (!(location.filename in this.result)) {
+      this.result[location.filename] = [];
+    }
+    const ruleUrl = rule.documentation(context)?.url;
+    const entry = {
+      ruleId: rule.name,
+      severity,
+      message,
+      offset: location.offset,
+      line: location.line,
+      column: location.column,
+      size: location.size || 0,
+      selector() {
+        return node ? node.generateSelector() : null;
+      }
+    };
+    if (ruleUrl) {
+      entry.ruleUrl = ruleUrl;
+    }
+    if (context) {
+      entry.context = context;
+    }
+    this.result[location.filename].push(entry);
+  }
+  addManual(filename, message) {
+    if (!(filename in this.result)) {
+      this.result[filename] = [];
+    }
+    this.result[filename].push(message);
+  }
+  save(sources) {
+    const report = {
+      valid: this.isValid(),
+      results: Object.keys(this.result).map((filePath) => {
+        const messages = Array.from(this.result[filePath], freeze).sort(messageSort);
+        const source = (sources ?? []).find((source2) => filePath === source2.filename);
+        return {
+          filePath,
+          messages,
+          errorCount: countErrors(messages),
+          warningCount: countWarnings(messages),
+          source: source ? source.originalData ?? source.data : null
+        };
+      }),
+      errorCount: 0,
+      warningCount: 0
+    };
+    report.errorCount = sumErrors(report.results);
+    report.warningCount = sumWarnings(report.results);
+    return report;
+  }
+  isValid() {
+    const numErrors = Object.values(this.result).reduce((sum, messages) => {
+      return sum + countErrors(messages);
+    }, 0);
+    return numErrors === 0;
+  }
+}
+function countErrors(messages) {
+  return messages.filter((m) => m.severity === Number(Severity.ERROR)).length;
+}
+function countWarnings(messages) {
+  return messages.filter((m) => m.severity === Number(Severity.WARN)).length;
+}
+function sumErrors(results) {
+  return results.reduce((sum, result) => {
+    return sum + result.errorCount;
+  }, 0);
+}
+function sumWarnings(results) {
+  return results.reduce((sum, result) => {
+    return sum + result.warningCount;
+  }, 0);
+}
+function messageSort(a, b) {
+  if (a.line < b.line) {
+    return -1;
+  }
+  if (a.line > b.line) {
+    return 1;
+  }
+  if (a.column < b.column) {
+    return -1;
+  }
+  if (a.column > b.column) {
+    return 1;
+  }
+  return 0;
+}
+
+function definePlugin(plugin) {
+  return plugin;
+}
+
 const regexp = /<!(?:--)?\[(.*?)\](?:--)?>/g;
 function* parseConditionalComment(comment, commentLocation) {
   let match;
@@ -12181,145 +12397,6 @@ class Parser {
   }
 }
 
-function freeze(src) {
-  return {
-    ...src,
-    selector: src.selector()
-  };
-}
-function isThenableArray(value) {
-  if (value.length === 0) {
-    return false;
-  }
-  return isThenable(value[0]);
-}
-class Reporter {
-  result;
-  constructor() {
-    this.result = {};
-  }
-  static merge(reports) {
-    if (isThenable(reports)) {
-      return reports.then((reports2) => this.merge(reports2));
-    }
-    if (isThenableArray(reports)) {
-      return Promise.all(reports).then((reports2) => this.merge(reports2));
-    }
-    const valid = reports.every((report) => report.valid);
-    const merged = {};
-    reports.forEach((report) => {
-      report.results.forEach((result) => {
-        const key = result.filePath;
-        if (key in merged) {
-          merged[key].messages = [...merged[key].messages, ...result.messages];
-        } else {
-          merged[key] = { ...result };
-        }
-      });
-    });
-    const results = Object.values(merged).map((result) => {
-      result.errorCount = countErrors(result.messages);
-      result.warningCount = countWarnings(result.messages);
-      return result;
-    });
-    return {
-      valid,
-      results,
-      errorCount: sumErrors(results),
-      warningCount: sumWarnings(results)
-    };
-  }
-  add(rule, message, severity, node, location, context) {
-    if (!(location.filename in this.result)) {
-      this.result[location.filename] = [];
-    }
-    const ruleUrl = rule.documentation(context)?.url;
-    const entry = {
-      ruleId: rule.name,
-      severity,
-      message,
-      offset: location.offset,
-      line: location.line,
-      column: location.column,
-      size: location.size || 0,
-      selector() {
-        return node ? node.generateSelector() : null;
-      }
-    };
-    if (ruleUrl) {
-      entry.ruleUrl = ruleUrl;
-    }
-    if (context) {
-      entry.context = context;
-    }
-    this.result[location.filename].push(entry);
-  }
-  addManual(filename, message) {
-    if (!(filename in this.result)) {
-      this.result[filename] = [];
-    }
-    this.result[filename].push(message);
-  }
-  save(sources) {
-    const report = {
-      valid: this.isValid(),
-      results: Object.keys(this.result).map((filePath) => {
-        const messages = Array.from(this.result[filePath], freeze).sort(messageSort);
-        const source = (sources ?? []).find((source2) => filePath === source2.filename);
-        return {
-          filePath,
-          messages,
-          errorCount: countErrors(messages),
-          warningCount: countWarnings(messages),
-          source: source ? source.originalData ?? source.data : null
-        };
-      }),
-      errorCount: 0,
-      warningCount: 0
-    };
-    report.errorCount = sumErrors(report.results);
-    report.warningCount = sumWarnings(report.results);
-    return report;
-  }
-  isValid() {
-    const numErrors = Object.values(this.result).reduce((sum, messages) => {
-      return sum + countErrors(messages);
-    }, 0);
-    return numErrors === 0;
-  }
-}
-function countErrors(messages) {
-  return messages.filter((m) => m.severity === Number(Severity.ERROR)).length;
-}
-function countWarnings(messages) {
-  return messages.filter((m) => m.severity === Number(Severity.WARN)).length;
-}
-function sumErrors(results) {
-  return results.reduce((sum, result) => {
-    return sum + result.errorCount;
-  }, 0);
-}
-function sumWarnings(results) {
-  return results.reduce((sum, result) => {
-    return sum + result.warningCount;
-  }, 0);
-}
-function messageSort(a, b) {
-  if (a.line < b.line) {
-    return -1;
-  }
-  if (a.line > b.line) {
-    return 1;
-  }
-  if (a.column < b.column) {
-    return -1;
-  }
-  if (a.column > b.column) {
-    return 1;
-  }
-  return 0;
-}
-
 let blockerCounter = 1;
 function createBlocker() {
   const id = blockerCounter++;
@@ -12655,75 +12732,6 @@ class Engine {
   }
 }
 
-const defaultResolvers = [];
-function hasResolver(value) {
-  return Array.isArray(value[0]);
-}
-class StaticConfigLoader extends ConfigLoader {
-  constructor(...args) {
-    if (hasResolver(args)) {
-      const [resolvers, config] = args;
-      super(resolvers, config);
-    } else {
-      const [config] = args;
-      super(defaultResolvers, config);
-    }
-  }
-  /**
-   * Set a new configuration for this loader.
-   *
-   * @public
-   * @since 8.20.0
-   * @param config - New configuration to use.
-   */
-  setConfig(config) {
-    this.setConfigData(config);
-  }
-  getConfigFor(_handle, configOverride) {
-    const override = this.loadFromObject(configOverride ?? {});
-    if (isThenable(override)) {
-      return override.then((override2) => this._resolveConfig(override2));
-    } else {
-      return this._resolveConfig(override);
-    }
-  }
-  flushCache() {
-  }
-  defaultConfig() {
-    return this.loadFromObject({
-      extends: ["html-validate:recommended"],
-      elements: ["html5"]
-    });
-  }
-  _resolveConfig(override) {
-    if (override.isRootFound()) {
-      return override.resolve();
-    }
-    const globalConfig = this.getGlobalConfig();
-    if (isThenable(globalConfig)) {
-      return globalConfig.then((globalConfig2) => {
-        const merged = globalConfig2.merge(this.resolvers, override);
-        if (isThenable(merged)) {
-          return merged.then((merged2) => {
-            return merged2.resolve();
-          });
-        } else {
-          return merged.resolve();
-        }
-      });
-    } else {
-      const merged = globalConfig.merge(this.resolvers, override);
-      if (isThenable(merged)) {
-        return merged.then((merged2) => {
-          return merged2.resolve();
-        });
-      } else {
-        return merged.resolve();
-      }
-    }
-  }
-}
-
 function getNamedTransformerFromPlugin(name, plugins, pluginName, key) {
   const plugin = plugins.find((cur) => cur.name === pluginName);
   if (!plugin) {
@@ -12903,10 +12911,11 @@ function transformSourceSync(resolvers, config, source, filename) {
   }
 }
 
-function transformFilename(resolvers, config, filename) {
+function transformFilename(resolvers, config, filename, fs) {
   const stdin = 0;
   const src = filename !== "/dev/stdin" ? filename : stdin;
-  const data = fs__default.default.readFileSync(src, { encoding: "utf8" });
+  const output = fs.readFileSync(src, { encoding: "utf8" });
+  const data = typeof output === "string" ? output : output.toString("utf8");
   const source = {
     data,
     filename,
@@ -12917,10 +12926,11 @@ function transformFilename(resolvers, config, filename) {
   };
   return transformSource(resolvers, config, source, filename);
 }
-function transformFilenameSync(resolvers, config, filename) {
+function transformFilenameSync(resolvers, config, filename, fs) {
   const stdin = 0;
   const src = filename !== "/dev/stdin" ? filename : stdin;
-  const data = fs__default.default.readFileSync(src, { encoding: "utf8" });
+  const output = fs.readFileSync(src, { encoding: "utf8" });
+  const data = typeof output === "string" ? output : output.toString("utf8");
   const source = {
     data,
     filename,
@@ -12932,430 +12942,6 @@ function transformFilenameSync(resolvers, config, filename) {
   return transformSourceSync(resolvers, config, source, filename);
 }
 
-function isSourceHooks(value) {
-  if (!value || typeof value === "string") {
-    return false;
-  }
-  return Boolean(value.processAttribute || value.processElement);
-}
-function isConfigData(value) {
-  if (!value || typeof value === "string") {
-    return false;
-  }
-  return !(value.processAttribute || value.processElement);
-}
-class HtmlValidate {
-  configLoader;
-  constructor(arg) {
-    const [loader, config] = arg instanceof ConfigLoader ? [arg, void 0] : [void 0, arg];
-    this.configLoader = loader ?? new StaticConfigLoader(config);
-  }
-  /* eslint-enable @typescript-eslint/unified-signatures */
-  validateString(str, arg1, arg2, arg3) {
-    const filename = typeof arg1 === "string" ? arg1 : "inline";
-    const options = isConfigData(arg1) ? arg1 : isConfigData(arg2) ? arg2 : void 0;
-    const hooks = isSourceHooks(arg1) ? arg1 : isSourceHooks(arg2) ? arg2 : arg3;
-    const source = {
-      data: str,
-      filename,
-      line: 1,
-      column: 1,
-      offset: 0,
-      hooks
-    };
-    return this.validateSource(source, options);
-  }
-  /* eslint-enable @typescript-eslint/unified-signatures */
-  validateStringSync(str, arg1, arg2, arg3) {
-    const filename = typeof arg1 === "string" ? arg1 : "inline";
-    const options = isConfigData(arg1) ? arg1 : isConfigData(arg2) ? arg2 : void 0;
-    const hooks = isSourceHooks(arg1) ? arg1 : isSourceHooks(arg2) ? arg2 : arg3;
-    const source = {
-      data: str,
-      filename,
-      line: 1,
-      column: 1,
-      offset: 0,
-      hooks
-    };
-    return this.validateSourceSync(source, options);
-  }
-  /**
-   * Parse and validate HTML from [[Source]].
-   *
-   * @public
-   * @param input - Source to parse.
-   * @returns Report output.
-   */
-  async validateSource(input, configOverride) {
-    const source = normalizeSource(input);
-    const config = await this.getConfigFor(source.filename, configOverride);
-    const resolvers = this.configLoader.getResolvers();
-    const transformedSource = await transformSource(resolvers, config, source);
-    const engine = new Engine(config, Parser);
-    return engine.lint(transformedSource);
-  }
-  /**
-   * Parse and validate HTML from [[Source]].
-   *
-   * @public
-   * @param input - Source to parse.
-   * @returns Report output.
-   */
-  validateSourceSync(input, configOverride) {
-    const source = normalizeSource(input);
-    const config = this.getConfigForSync(source.filename, configOverride);
-    const resolvers = this.configLoader.getResolvers();
-    const transformedSource = transformSourceSync(resolvers, config, source);
-    const engine = new Engine(config, Parser);
-    return engine.lint(transformedSource);
-  }
-  /**
-   * Parse and validate HTML from file.
-   *
-   * @public
-   * @param filename - Filename to read and parse.
-   * @returns Report output.
-   */
-  async validateFile(filename) {
-    const config = await this.getConfigFor(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const source = await transformFilename(resolvers, config, filename);
-    const engine = new Engine(config, Parser);
-    return Promise.resolve(engine.lint(source));
-  }
-  /**
-   * Parse and validate HTML from file.
-   *
-   * @public
-   * @param filename - Filename to read and parse.
-   * @returns Report output.
-   */
-  validateFileSync(filename) {
-    const config = this.getConfigForSync(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const source = transformFilenameSync(resolvers, config, filename);
-    const engine = new Engine(config, Parser);
-    return engine.lint(source);
-  }
-  /**
-   * Parse and validate HTML from multiple files. Result is merged together to a
-   * single report.
-   *
-   * @param filenames - Filenames to read and parse.
-   * @returns Report output.
-   */
-  async validateMultipleFiles(filenames) {
-    return Reporter.merge(filenames.map((filename) => this.validateFile(filename)));
-  }
-  /**
-   * Parse and validate HTML from multiple files. Result is merged together to a
-   * single report.
-   *
-   * @param filenames - Filenames to read and parse.
-   * @returns Report output.
-   */
-  validateMultipleFilesSync(filenames) {
-    return Reporter.merge(filenames.map((filename) => this.validateFileSync(filename)));
-  }
-  /**
-   * Returns true if the given filename can be validated.
-   *
-   * A file is considered to be validatable if the extension is `.html` or if a
-   * transformer matches the filename.
-   *
-   * This is mostly useful for tooling to determine whenever to validate the
-   * file or not. CLI tools will run on all the given files anyway.
-   */
-  async canValidate(filename) {
-    if (filename.toLowerCase().endsWith(".html")) {
-      return true;
-    }
-    const config = await this.getConfigFor(filename);
-    return config.canTransform(filename);
-  }
-  /**
-   * Returns true if the given filename can be validated.
-   *
-   * A file is considered to be validatable if the extension is `.html` or if a
-   * transformer matches the filename.
-   *
-   * This is mostly useful for tooling to determine whenever to validate the
-   * file or not. CLI tools will run on all the given files anyway.
-   */
-  canValidateSync(filename) {
-    if (filename.toLowerCase().endsWith(".html")) {
-      return true;
-    }
-    const config = this.getConfigForSync(filename);
-    return config.canTransform(filename);
-  }
-  /**
-   * Tokenize filename and output all tokens.
-   *
-   * Using CLI this is enabled with `--dump-tokens`. Mostly useful for
-   * debugging.
-   *
-   * @internal
-   * @param filename - Filename to tokenize.
-   */
-  async dumpTokens(filename) {
-    const config = await this.getConfigFor(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const source = await transformFilename(resolvers, config, filename);
-    const engine = new Engine(config, Parser);
-    return engine.dumpTokens(source);
-  }
-  /**
-   * Parse filename and output all events.
-   *
-   * Using CLI this is enabled with `--dump-events`. Mostly useful for
-   * debugging.
-   *
-   * @internal
-   * @param filename - Filename to dump events from.
-   */
-  async dumpEvents(filename) {
-    const config = await this.getConfigFor(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const source = await transformFilename(resolvers, config, filename);
-    const engine = new Engine(config, Parser);
-    return engine.dumpEvents(source);
-  }
-  /**
-   * Parse filename and output DOM tree.
-   *
-   * Using CLI this is enabled with `--dump-tree`. Mostly useful for
-   * debugging.
-   *
-   * @internal
-   * @param filename - Filename to dump DOM tree from.
-   */
-  async dumpTree(filename) {
-    const config = await this.getConfigFor(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const source = await transformFilename(resolvers, config, filename);
-    const engine = new Engine(config, Parser);
-    return engine.dumpTree(source);
-  }
-  /**
-   * Transform filename and output source data.
-   *
-   * Using CLI this is enabled with `--dump-source`. Mostly useful for
-   * debugging.
-   *
-   * @internal
-   * @param filename - Filename to dump source from.
-   */
-  async dumpSource(filename) {
-    const config = await this.getConfigFor(filename);
-    const resolvers = this.configLoader.getResolvers();
-    const sources = await transformFilename(resolvers, config, filename);
-    return sources.reduce((result, source) => {
-      const line = String(source.line);
-      const column = String(source.column);
-      const offset = String(source.offset);
-      result.push(`Source ${source.filename}@${line}:${column} (offset: ${offset})`);
-      if (source.transformedBy) {
-        result.push("Transformed by:");
-        result = result.concat(source.transformedBy.reverse().map((name) => ` - ${name}`));
-      }
-      if (source.hooks && Object.keys(source.hooks).length > 0) {
-        result.push("Hooks");
-        for (const [key, present] of Object.entries(source.hooks)) {
-          if (present) {
-            result.push(` - ${key}`);
-          }
-        }
-      }
-      result.push("---");
-      result = result.concat(source.data.split("\n"));
-      result.push("---");
-      return result;
-    }, []);
-  }
-  /**
-   * Get effective configuration schema.
-   */
-  getConfigurationSchema() {
-    return Promise.resolve(configurationSchema);
-  }
-  /**
-   * Get effective metadata element schema.
-   *
-   * If a filename is given the configured plugins can extend the
-   * schema. Filename must not be an existing file or a filetype normally
-   * handled by html-validate but the path will be used when resolving
-   * configuration. As a rule-of-thumb, set it to the elements json file.
-   */
-  async getElementsSchema(filename) {
-    const config = await this.getConfigFor(filename ?? "inline");
-    const metaTable = config.getMetaTable();
-    return metaTable.getJSONSchema();
-  }
-  /**
-   * Get effective metadata element schema.
-   *
-   * If a filename is given the configured plugins can extend the
-   * schema. Filename must not be an existing file or a filetype normally
-   * handled by html-validate but the path will be used when resolving
-   * configuration. As a rule-of-thumb, set it to the elements json file.
-   */
-  getElementsSchemaSync(filename) {
-    const config = this.getConfigForSync(filename ?? "inline");
-    const metaTable = config.getMetaTable();
-    return metaTable.getJSONSchema();
-  }
-  async getContextualDocumentation(message, filenameOrConfig = "inline") {
-    const config = typeof filenameOrConfig === "string" ? await this.getConfigFor(filenameOrConfig) : await filenameOrConfig;
-    const engine = new Engine(config, Parser);
-    return engine.getRuleDocumentation(message);
-  }
-  getContextualDocumentationSync(message, filenameOrConfig = "inline") {
-    const config = typeof filenameOrConfig === "string" ? this.getConfigForSync(filenameOrConfig) : filenameOrConfig;
-    const engine = new Engine(config, Parser);
-    return engine.getRuleDocumentation(message);
-  }
-  /**
-   * Get contextual documentation for the given rule.
-   *
-   * Typical usage:
-   *
-   * ```js
-   * const report = await htmlvalidate.validateFile("my-file.html");
-   * for (const result of report.results){
-   *   const config = await htmlvalidate.getConfigFor(result.filePath);
-   *   for (const message of result.messages){
-   *     const documentation = await htmlvalidate.getRuleDocumentation(message.ruleId, config, message.context);
-   *     // do something with documentation
-   *   }
-   * }
-   * ```
-   *
-   * @public
-   * @deprecated Deprecated since 8.0.0, use [[getContextualDocumentation]] instead.
-   * @param ruleId - Rule to get documentation for.
-   * @param config - If set it provides more accurate description by using the
-   * correct configuration for the file.
-   * @param context - If set to `Message.context` some rules can provide
-   * contextual details and suggestions.
-   */
-  async getRuleDocumentation(ruleId, config = null, context = null) {
-    const c = config ?? this.getConfigFor("inline");
-    const engine = new Engine(await c, Parser);
-    return engine.getRuleDocumentation({ ruleId, context });
-  }
-  /**
-   * Get contextual documentation for the given rule.
-   *
-   * Typical usage:
-   *
-   * ```js
-   * const report = htmlvalidate.validateFileSync("my-file.html");
-   * for (const result of report.results){
-   *   const config = htmlvalidate.getConfigForSync(result.filePath);
-   *   for (const message of result.messages){
-   *     const documentation = htmlvalidate.getRuleDocumentationSync(message.ruleId, config, message.context);
-   *     // do something with documentation
-   *   }
-   * }
-   * ```
-   *
-   * @public
-   * @deprecated Deprecated since 8.0.0, use [[getContextualDocumentationSync]] instead.
-   * @param ruleId - Rule to get documentation for.
-   * @param config - If set it provides more accurate description by using the
-   * correct configuration for the file.
-   * @param context - If set to `Message.context` some rules can provide
-   * contextual details and suggestions.
-   */
-  getRuleDocumentationSync(ruleId, config = null, context = null) {
-    const c = config ?? this.getConfigForSync("inline");
-    const engine = new Engine(c, Parser);
-    return engine.getRuleDocumentation({ ruleId, context });
-  }
-  /**
-   * Create a parser configured for given filename.
-   *
-   * @internal
-   * @param source - Source to use.
-   */
-  async getParserFor(source) {
-    const config = await this.getConfigFor(source.filename);
-    return new Parser(config);
-  }
-  /**
-   * Get configuration for given filename.
-   *
-   * See [[FileSystemConfigLoader]] for details.
-   *
-   * @public
-   * @param filename - Filename to get configuration for.
-   * @param configOverride - Configuration to apply last.
-   */
-  getConfigFor(filename, configOverride) {
-    const config = this.configLoader.getConfigFor(filename, configOverride);
-    return Promise.resolve(config);
-  }
-  /**
-   * Get configuration for given filename.
-   *
-   * See [[FileSystemConfigLoader]] for details.
-   *
-   * @public
-   * @param filename - Filename to get configuration for.
-   * @param configOverride - Configuration to apply last.
-   */
-  getConfigForSync(filename, configOverride) {
-    const config = this.configLoader.getConfigFor(filename, configOverride);
-    if (isThenable(config)) {
-      throw new UserError("Cannot use asynchronous config loader with synchronous api");
-    }
-    return config;
-  }
-  /**
-   * Get current configuration loader.
-   *
-   * @public
-   * @since %version%
-   * @returns Current configuration loader.
-   */
-  /* istanbul ignore next -- not testing setters/getters */
-  getConfigLoader() {
-    return this.configLoader;
-  }
-  /**
-   * Set configuration loader.
-   *
-   * @public
-   * @since %version%
-   * @param loader - New configuration loader to use.
-   */
-  /* istanbul ignore next -- not testing setters/getters */
-  setConfigLoader(loader) {
-    this.configLoader = loader;
-  }
-  /**
-   * Flush configuration cache. Clears full cache unless a filename is given.
-   *
-   * See [[FileSystemConfigLoader]] for details.
-   *
-   * @public
-   * @param filename - If set, only flush cache for given filename.
-   */
-  flushConfigCache(filename) {
-    this.configLoader.flushCache(filename);
-  }
-}
-
-const name = "html-validate";
-const version = "9.2.2";
-const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
-
-function definePlugin(plugin) {
-  return plugin;
-}
-
 const entities = {
   ">": "&gt;",
   "<": "&lt;",
@@ -14471,9 +14057,9 @@ exports.DOMNode = DOMNode;
 exports.DOMTokenList = DOMTokenList;
 exports.DOMTree = DOMTree;
 exports.DynamicValue = DynamicValue;
+exports.Engine = Engine;
 exports.EventHandler = EventHandler;
 exports.HtmlElement = HtmlElement;
-exports.HtmlValidate = HtmlValidate;
 exports.MetaCopyableProperty = MetaCopyableProperty;
 exports.MetaTable = MetaTable;
 exports.NestedError = NestedError;
@@ -14497,6 +14083,7 @@ exports.bugs = bugs;
 exports.classifyNodeText = classifyNodeText;
 exports.codeframe = codeframe;
 exports.compatibilityCheckImpl = compatibilityCheckImpl;
+exports.configurationSchema = configurationSchema;
 exports.deepmerge = deepmerge;
 exports.defineConfig = defineConfig;
 exports.definePlugin = definePlugin;
@@ -14508,10 +14095,15 @@ exports.isThenable = isThenable;
 exports.isUserError = isUserError;
 exports.keywordPatternMatcher = keywordPatternMatcher;
 exports.name = name;
+exports.normalizeSource = normalizeSource;
 exports.presets = presets;
 exports.ruleExists = ruleExists;
 exports.sliceLocation = sliceLocation;
 exports.staticResolver = staticResolver;
+exports.transformFilename = transformFilename;
+exports.transformFilenameSync = transformFilenameSync;
+exports.transformSource = transformSource;
+exports.transformSourceSync = transformSourceSync;
 exports.version = version;
 exports.walk = walk;
 exports.workerPath = workerPath;