html-validate 9.3.0 → 9.4.1

package/dist/es/core.js

@@ -2,7 +2,6 @@ import Ajv from 'ajv';
 import { e as entities$1, h as html5, b as bundledElements } from './elements.js';
 import betterAjvErrors from '@sidvind/better-ajv-errors';
 import { n as naturalJoin } from './utils/natural-join.js';
-import fs from 'node:fs';
 import kleur from 'kleur';
 import { stylish as stylish$1 } from '@html-validate/stylish';
 import semver from 'semver';
@@ -11513,6 +11512,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() {
@@ -11574,6 +11642,153 @@ class EventHandler {
   }
 }
 
+const name = "html-validate";
+const version = "9.4.1";
+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;
@@ -12173,165 +12388,26 @@ class Parser {
   }
 }
 
-function freeze(src) {
-  return {
-    ...src,
-    selector: src.selector()
-  };
-}
-function isThenableArray(value) {
-  if (value.length === 0) {
-    return false;
-  }
-  return isThenable(value[0]);
+let blockerCounter = 1;
+function createBlocker() {
+  const id = blockerCounter++;
+  return id;
 }
-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++;
-  return id;
-}
-
-class Engine {
-  report;
-  config;
-  ParserClass;
-  availableRules;
-  constructor(config, ParserClass) {
-    this.report = new Reporter();
-    this.config = config;
-    this.ParserClass = ParserClass;
-    const result = this.initPlugins(this.config);
-    this.availableRules = {
-      ...bundledRules,
-      ...result.availableRules
-    };
+
+class Engine {
+  report;
+  config;
+  ParserClass;
+  availableRules;
+  constructor(config, ParserClass) {
+    this.report = new Reporter();
+    this.config = config;
+    this.ParserClass = ParserClass;
+    const result = this.initPlugins(this.config);
+    this.availableRules = {
+      ...bundledRules,
+      ...result.availableRules
+    };
   }
   /**
    * Lint sources and return report
@@ -12647,75 +12723,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) {
@@ -12895,10 +12902,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.readFileSync(src, { encoding: "utf8" });
+  const output = fs.readFileSync(src, { encoding: "utf8" });
+  const data = typeof output === "string" ? output : output.toString("utf8");
   const source = {
     data,
     filename,
@@ -12909,10 +12917,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.readFileSync(src, { encoding: "utf8" });
+  const output = fs.readFileSync(src, { encoding: "utf8" });
+  const data = typeof output === "string" ? output : output.toString("utf8");
   const source = {
     data,
     filename,
@@ -12924,430 +12933,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.3.0";
-const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";
-
-function definePlugin(plugin) {
-  return plugin;
-}
-
 const entities = {
   ">": "&gt;",
   "<": "&lt;",
@@ -14455,5 +14040,5 @@ const engines = {
 
 var workerPath = "./jest-worker.js";
 
-export { Attribute as A, sliceLocation as B, Config as C, DOMNode as D, Reporter as E, definePlugin as F, ruleExists as G, HtmlValidate as H, walk as I, EventHandler as J, engines as K, compatibilityCheckImpl as L, MetaCopyableProperty as M, NodeClosed as N, isThenable as O, Parser as P, workerPath as Q, ResolvedConfig as R, Severity as S, TextNode as T, UserError as U, Validator as V, WrappedError as W, codeframe as X, name as Y, bugs as Z, ConfigError as a, ConfigLoader as b, defineConfig as c, deepmerge as d, ensureError as e, StaticConfigLoader as f, getFormatter as g, DOMTokenList as h, ignore as i, DOMTree as j, DynamicValue as k, HtmlElement as l, NodeType as m, NestedError as n, SchemaValidationError as o, presets as p, isUserError as q, MetaTable as r, staticResolver as s, TextContent$1 as t, Rule as u, version as v, ariaNaming as w, TextClassification as x, classifyNodeText as y, keywordPatternMatcher as z };
+export { compatibilityCheckImpl as $, Attribute as A, Reporter as B, Config as C, DOMNode as D, definePlugin as E, ruleExists as F, walk as G, HtmlElement as H, EventHandler as I, engines as J, normalizeSource as K, transformSource as L, MetaCopyableProperty as M, NodeClosed as N, Engine as O, Parser as P, transformSourceSync as Q, ResolvedConfig as R, Severity as S, TextNode as T, UserError as U, Validator as V, WrappedError as W, transformFilename as X, transformFilenameSync as Y, configurationSchema as Z, isThenable as _, ConfigError as a, workerPath as a0, codeframe as a1, name as a2, bugs as a3, ConfigLoader as b, defineConfig as c, deepmerge as d, ensureError as e, StaticConfigLoader as f, getFormatter as g, DOMTokenList as h, ignore as i, DOMTree as j, DynamicValue as k, NodeType as l, NestedError as m, SchemaValidationError as n, isUserError as o, presets as p, MetaTable as q, TextContent$1 as r, staticResolver as s, Rule as t, ariaNaming as u, version as v, TextClassification as w, classifyNodeText as x, keywordPatternMatcher as y, sliceLocation as z };
 //# sourceMappingURL=core.js.map