html-validate 9.3.0 → 9.4.1

package/dist/cjs/html-validate.js

@@ -11,10 +11,10 @@ require('./elements.js');
 require('./meta-helper.js');
 require('./utils/natural-join.js');
 require('@sidvind/better-ajv-errors');
-require('node:fs');
 require('@html-validate/stylish');
 require('semver');
 require('./core-nodejs.js');
+require('node:fs');
 require('node:fs/promises');
 require('node:url');
 require('node:path/posix');

package/dist/cjs/index.js

@@ -4,8 +4,8 @@ var coreNodejs = require('./core-nodejs.js');
 var core = require('./core.js');
 var cli = require('./cli.js');
 var metaHelper = require('./meta-helper.js');
-require('node:path');
 require('node:fs');
+require('node:path');
 require('node:fs/promises');
 require('node:url');
 require('kleur');
@@ -23,6 +23,7 @@ require('prompts');
 
 
 exports.FileSystemConfigLoader = coreNodejs.FileSystemConfigLoader;
+exports.HtmlValidate = coreNodejs.HtmlValidate;
 exports.cjsResolver = coreNodejs.cjsResolver;
 exports.compatibilityCheck = coreNodejs.compatibilityCheck;
 exports.esmResolver = coreNodejs.esmResolver;
@@ -37,7 +38,6 @@ exports.DOMTree = core.DOMTree;
 exports.DynamicValue = core.DynamicValue;
 exports.EventHandler = core.EventHandler;
 exports.HtmlElement = core.HtmlElement;
-exports.HtmlValidate = core.HtmlValidate;
 exports.MetaCopyableProperty = core.MetaCopyableProperty;
 exports.MetaTable = core.MetaTable;
 exports.NestedError = core.NestedError;

package/dist/cjs/jest-worker.js

@@ -2,19 +2,19 @@
 
 var node_worker_threads = require('node:worker_threads');
 var coreNodejs = require('./core-nodejs.js');
-var core = require('./core.js');
-require('node:path');
 require('node:fs');
-require('node:fs/promises');
-require('node:url');
-require('kleur');
+require('./core.js');
 require('ajv');
 require('./elements.js');
 require('./meta-helper.js');
 require('./utils/natural-join.js');
 require('@sidvind/better-ajv-errors');
+require('kleur');
 require('@html-validate/stylish');
 require('semver');
+require('node:path');
+require('node:fs/promises');
+require('node:url');
 
 function runAsWorker(fn) {
   if (!node_worker_threads.workerData) {
@@ -55,7 +55,7 @@ function validateString(markup, filename, config) {
   const loader = new coreNodejs.FileSystemConfigLoader({
     extends: ["html-validate:recommended"]
   });
-  const htmlvalidate = new core.HtmlValidate(loader);
+  const htmlvalidate = new coreNodejs.HtmlValidate(loader);
   return htmlvalidate.validateString(markup, filename, config);
 }
 runAsWorker(validateString);

package/dist/cjs/jest-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"jest-worker.js","sources":["../../src/jest/worker/worker.ts"],"sourcesContent":["import { type MessagePort, parentPort, workerData } from \"node:worker_threads\";\nimport { type ConfigData } from \"../../config\";\nimport { FileSystemConfigLoader } from \"../../config/loaders/file-system\";\nimport { HtmlValidate } from \"../../htmlvalidate\";\nimport { type Report } from \"../../reporter\";\nimport {\n\ttype AnyAsyncFn,\n\ttype MainToWorkerCommandMessage,\n\ttype MainToWorkerMessage,\n\ttype WorkerToMainMessage,\n} from \"./types\";\n\ninterface WorkerData {\n\tsharedBuffer: SharedArrayBuffer;\n\tworkerPort: MessagePort;\n}\n\nfunction runAsWorker<R = unknown, T extends AnyAsyncFn<R> = AnyAsyncFn<R>>(fn: T): void {\n\tif (!workerData) {\n\t\treturn;\n\t}\n\n\tconst { workerPort, sharedBuffer } = workerData as WorkerData;\n\tconst sharedBufferView = new Int32Array(sharedBuffer, 0, 1);\n\n\t/* eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- better crash at runtime if not set */\n\tparentPort!.on(\"message\", ({ id, args }: MainToWorkerMessage<Parameters<T>>) => {\n\t\tasync function inner(): Promise<void> {\n\t\t\tlet isAborted = false;\n\t\t\tconst handleAbortMessage = (msg: MainToWorkerCommandMessage): void => {\n\t\t\t\tif (msg.id === id && msg.cmd === \"abort\") {\n\t\t\t\t\tisAborted = true;\n\t\t\t\t}\n\t\t\t};\n\t\t\tworkerPort.on(\"message\", handleAbortMessage);\n\t\t\tlet msg: WorkerToMainMessage<R>;\n\t\t\ttry {\n\t\t\t\tmsg = { id, result: await fn(...args) };\n\t\t\t} catch (error: unknown) {\n\t\t\t\tmsg = {\n\t\t\t\t\tid,\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t};\n\t\t\t}\n\t\t\tworkerPort.off(\"message\", handleAbortMessage);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- modified by handleAbortMessage\n\t\t\tif (isAborted) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tworkerPort.postMessage(msg);\n\t\t\tAtomics.add(sharedBufferView, 0, 1);\n\t\t\tAtomics.notify(sharedBufferView, 0);\n\t\t}\n\t\t// eslint-disable-next-line @typescript-eslint/no-floating-promises -- should not happen\n\t\tinner();\n\t});\n}\n\nfunction validateString(markup: string, filename: string, config: ConfigData): Promise<Report> {\n\tconst loader = new FileSystemConfigLoader({\n\t\textends: [\"html-validate:recommended\"],\n\t});\n\tconst htmlvalidate = new HtmlValidate(loader);\n\treturn htmlvalidate.validateString(markup, filename, config);\n}\n\nexport type ValidateStringFn = typeof validateString;\n\nrunAsWorker(validateString);\n"],"names":["workerData","parentPort","msg","FileSystemConfigLoader","HtmlValidate"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAS,YAAkE,EAAa,EAAA;AACvF,EAAA,IAAI,CAACA,8BAAY,EAAA;AAChB,IAAA;AAAA;AAGD,EAAM,MAAA,EAAE,UAAY,EAAA,YAAA,EAAiB,GAAAA,8BAAA;AACrC,EAAA,MAAM,gBAAmB,GAAA,IAAI,UAAW,CAAA,YAAA,EAAc,GAAG,CAAC,CAAA;AAG1D,EAAAC,8BAAA,CAAY,GAAG,SAAW,EAAA,CAAC,EAAE,EAAA,EAAI,MAA+C,KAAA;AAC/E,IAAA,eAAe,KAAuB,GAAA;AACrC,MAAA,IAAI,SAAY,GAAA,KAAA;AAChB,MAAM,MAAA,kBAAA,GAAqB,CAACC,IAA0C,KAAA;AACrE,QAAA,IAAIA,IAAI,CAAA,EAAA,KAAO,EAAMA,IAAAA,IAAAA,CAAI,QAAQ,OAAS,EAAA;AACzC,UAAY,SAAA,GAAA,IAAA;AAAA;AACb,OACD;AACA,MAAW,UAAA,CAAA,EAAA,CAAG,WAAW,kBAAkB,CAAA;AAC3C,MAAI,IAAA,GAAA;AACJ,MAAI,IAAA;AACH,QAAA,GAAA,GAAM,EAAE,EAAI,EAAA,MAAA,EAAQ,MAAM,EAAG,CAAA,GAAG,IAAI,CAAE,EAAA;AAAA,eAC9B,KAAgB,EAAA;AACxB,QAAM,GAAA,GAAA;AAAA,UACL,EAAA;AAAA,UACA,OAAO,KAAiB,YAAA,KAAA,GAAQ,KAAM,CAAA,OAAA,GAAU,OAAO,KAAK;AAAA,SAC7D;AAAA;AAED,MAAW,UAAA,CAAA,GAAA,CAAI,WAAW,kBAAkB,CAAA;AAE5C,MAAA,IAAI,SAAW,EAAA;AACd,QAAA;AAAA;AAED,MAAA,UAAA,CAAW,YAAY,GAAG,CAAA;AAC1B,MAAQ,OAAA,CAAA,GAAA,CAAI,gBAAkB,EAAA,CAAA,EAAG,CAAC,CAAA;AAClC,MAAQ,OAAA,CAAA,MAAA,CAAO,kBAAkB,CAAC,CAAA;AAAA;AAGnC,IAAM,KAAA,EAAA;AAAA,GACN,CAAA;AACF;AAEA,SAAS,cAAA,CAAe,MAAgB,EAAA,QAAA,EAAkB,MAAqC,EAAA;AAC9F,EAAM,MAAA,MAAA,GAAS,IAAIC,iCAAuB,CAAA;AAAA,IACzC,OAAA,EAAS,CAAC,2BAA2B;AAAA,GACrC,CAAA;AACD,EAAM,MAAA,YAAA,GAAe,IAAIC,iBAAA,CAAa,MAAM,CAAA;AAC5C,EAAA,OAAO,YAAa,CAAA,cAAA,CAAe,MAAQ,EAAA,QAAA,EAAU,MAAM,CAAA;AAC5D;AAIA,WAAA,CAAY,cAAc,CAAA;;"}
+{"version":3,"file":"jest-worker.js","sources":["../../src/jest/worker/worker.ts"],"sourcesContent":["import { type MessagePort, parentPort, workerData } from \"node:worker_threads\";\nimport { type ConfigData } from \"../../config\";\nimport { FileSystemConfigLoader } from \"../../config/loaders/file-system\";\nimport { HtmlValidate } from \"../../htmlvalidate\";\nimport { type Report } from \"../../reporter\";\nimport {\n\ttype AnyAsyncFn,\n\ttype MainToWorkerCommandMessage,\n\ttype MainToWorkerMessage,\n\ttype WorkerToMainMessage,\n} from \"./types\";\n\ninterface WorkerData {\n\tsharedBuffer: SharedArrayBuffer;\n\tworkerPort: MessagePort;\n}\n\nfunction runAsWorker<R = unknown, T extends AnyAsyncFn<R> = AnyAsyncFn<R>>(fn: T): void {\n\tif (!workerData) {\n\t\treturn;\n\t}\n\n\tconst { workerPort, sharedBuffer } = workerData as WorkerData;\n\tconst sharedBufferView = new Int32Array(sharedBuffer, 0, 1);\n\n\t/* eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- better crash at runtime if not set */\n\tparentPort!.on(\"message\", ({ id, args }: MainToWorkerMessage<Parameters<T>>) => {\n\t\tasync function inner(): Promise<void> {\n\t\t\tlet isAborted = false;\n\t\t\tconst handleAbortMessage = (msg: MainToWorkerCommandMessage): void => {\n\t\t\t\tif (msg.id === id && msg.cmd === \"abort\") {\n\t\t\t\t\tisAborted = true;\n\t\t\t\t}\n\t\t\t};\n\t\t\tworkerPort.on(\"message\", handleAbortMessage);\n\t\t\tlet msg: WorkerToMainMessage<R>;\n\t\t\ttry {\n\t\t\t\tmsg = { id, result: await fn(...args) };\n\t\t\t} catch (error: unknown) {\n\t\t\t\tmsg = {\n\t\t\t\t\tid,\n\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t};\n\t\t\t}\n\t\t\tworkerPort.off(\"message\", handleAbortMessage);\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- modified by handleAbortMessage\n\t\t\tif (isAborted) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tworkerPort.postMessage(msg);\n\t\t\tAtomics.add(sharedBufferView, 0, 1);\n\t\t\tAtomics.notify(sharedBufferView, 0);\n\t\t}\n\t\t// eslint-disable-next-line @typescript-eslint/no-floating-promises -- should not happen\n\t\tinner();\n\t});\n}\n\nfunction validateString(markup: string, filename: string, config: ConfigData): Promise<Report> {\n\tconst loader = new FileSystemConfigLoader({\n\t\textends: [\"html-validate:recommended\"],\n\t});\n\tconst htmlvalidate = new HtmlValidate(loader);\n\treturn htmlvalidate.validateString(markup, filename, config);\n}\n\nexport type ValidateStringFn = typeof validateString;\n\nrunAsWorker(validateString);\n"],"names":["workerData","parentPort","msg","FileSystemConfigLoader","HtmlValidate"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,SAAS,YAAkE,EAAa,EAAA;AACvF,EAAA,IAAI,CAACA,8BAAY,EAAA;AAChB,IAAA;AAAA;AAGD,EAAM,MAAA,EAAE,UAAY,EAAA,YAAA,EAAiB,GAAAA,8BAAA;AACrC,EAAA,MAAM,gBAAmB,GAAA,IAAI,UAAW,CAAA,YAAA,EAAc,GAAG,CAAC,CAAA;AAG1D,EAAAC,8BAAA,CAAY,GAAG,SAAW,EAAA,CAAC,EAAE,EAAA,EAAI,MAA+C,KAAA;AAC/E,IAAA,eAAe,KAAuB,GAAA;AACrC,MAAA,IAAI,SAAY,GAAA,KAAA;AAChB,MAAM,MAAA,kBAAA,GAAqB,CAACC,IAA0C,KAAA;AACrE,QAAA,IAAIA,IAAI,CAAA,EAAA,KAAO,EAAMA,IAAAA,IAAAA,CAAI,QAAQ,OAAS,EAAA;AACzC,UAAY,SAAA,GAAA,IAAA;AAAA;AACb,OACD;AACA,MAAW,UAAA,CAAA,EAAA,CAAG,WAAW,kBAAkB,CAAA;AAC3C,MAAI,IAAA,GAAA;AACJ,MAAI,IAAA;AACH,QAAA,GAAA,GAAM,EAAE,EAAI,EAAA,MAAA,EAAQ,MAAM,EAAG,CAAA,GAAG,IAAI,CAAE,EAAA;AAAA,eAC9B,KAAgB,EAAA;AACxB,QAAM,GAAA,GAAA;AAAA,UACL,EAAA;AAAA,UACA,OAAO,KAAiB,YAAA,KAAA,GAAQ,KAAM,CAAA,OAAA,GAAU,OAAO,KAAK;AAAA,SAC7D;AAAA;AAED,MAAW,UAAA,CAAA,GAAA,CAAI,WAAW,kBAAkB,CAAA;AAE5C,MAAA,IAAI,SAAW,EAAA;AACd,QAAA;AAAA;AAED,MAAA,UAAA,CAAW,YAAY,GAAG,CAAA;AAC1B,MAAQ,OAAA,CAAA,GAAA,CAAI,gBAAkB,EAAA,CAAA,EAAG,CAAC,CAAA;AAClC,MAAQ,OAAA,CAAA,MAAA,CAAO,kBAAkB,CAAC,CAAA;AAAA;AAGnC,IAAM,KAAA,EAAA;AAAA,GACN,CAAA;AACF;AAEA,SAAS,cAAA,CAAe,MAAgB,EAAA,QAAA,EAAkB,MAAqC,EAAA;AAC9F,EAAM,MAAA,MAAA,GAAS,IAAIC,iCAAuB,CAAA;AAAA,IACzC,OAAA,EAAS,CAAC,2BAA2B;AAAA,GACrC,CAAA;AACD,EAAM,MAAA,YAAA,GAAe,IAAIC,uBAAA,CAAa,MAAM,CAAA;AAC5C,EAAA,OAAO,YAAa,CAAA,cAAA,CAAe,MAAQ,EAAA,QAAA,EAAU,MAAM,CAAA;AAC5D;AAIA,WAAA,CAAY,cAAc,CAAA;;"}

package/dist/cjs/jest.js

@@ -11,12 +11,12 @@ require('./elements.js');
 require('./meta-helper.js');
 require('./utils/natural-join.js');
 require('@sidvind/better-ajv-errors');
-require('node:fs');
 require('@html-validate/stylish');
 require('semver');
 require('./matcher-utils.js');
 require('node:worker_threads');
 require('./core-nodejs.js');
+require('node:fs');
 require('node:path');
 require('node:fs/promises');
 require('node:url');

package/dist/cjs/vitest.js

@@ -5,17 +5,17 @@ var matchers = require('./matchers.js');
 require('./matcher-utils.js');
 require('node:worker_threads');
 require('./core-nodejs.js');
-require('node:path');
+require('node:fs');
 require('./core.js');
 require('ajv');
 require('./elements.js');
 require('./meta-helper.js');
 require('./utils/natural-join.js');
 require('@sidvind/better-ajv-errors');
-require('node:fs');
 require('kleur');
 require('@html-validate/stylish');
 require('semver');
+require('node:path');
 require('node:fs/promises');
 require('node:url');
 

package/dist/es/browser.js

@@ -1,11 +1,10 @@
-export { c as compatibilityCheck, e as esmResolver } from './core-browser.js';
-export { A as Attribute, C as Config, a as ConfigError, b as ConfigLoader, D as DOMNode, h as DOMTokenList, j as DOMTree, k as DynamicValue, J as EventHandler, l as HtmlElement, H as HtmlValidate, M as MetaCopyableProperty, r as MetaTable, n as NestedError, N as NodeClosed, m as NodeType, P as Parser, E as Reporter, R as ResolvedConfig, u as Rule, o as SchemaValidationError, S as Severity, f as StaticConfigLoader, x as TextClassification, t as TextContent, T as TextNode, U as UserError, V as Validator, W as WrappedError, w as ariaNaming, y as classifyNodeText, p as configPresets, c as defineConfig, F as definePlugin, q as isUserError, z as keywordPatternMatcher, G as ruleExists, B as sliceLocation, s as staticResolver, v as version, I as walk } from './core.js';
+export { H as HtmlValidate, c as compatibilityCheck, e as esmResolver } from './core-browser.js';
+export { A as Attribute, C as Config, a as ConfigError, b as ConfigLoader, D as DOMNode, h as DOMTokenList, j as DOMTree, k as DynamicValue, I as EventHandler, H as HtmlElement, M as MetaCopyableProperty, q as MetaTable, m as NestedError, N as NodeClosed, l as NodeType, P as Parser, B as Reporter, R as ResolvedConfig, t as Rule, n as SchemaValidationError, S as Severity, f as StaticConfigLoader, w as TextClassification, r as TextContent, T as TextNode, U as UserError, V as Validator, W as WrappedError, u as ariaNaming, x as classifyNodeText, p as configPresets, c as defineConfig, E as definePlugin, o as isUserError, y as keywordPatternMatcher, F as ruleExists, z as sliceLocation, s as staticResolver, v as version, G as walk } from './core.js';
 export { d as defineMetadata, m as metadataHelper } from './meta-helper.js';
 import 'ajv';
 import './elements.js';
 import '@sidvind/better-ajv-errors';
 import './utils/natural-join.js';
-import 'node:fs';
 import 'kleur';
 import '@html-validate/stylish';
 import 'semver';

package/dist/es/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"browser.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/es/cli.js

@@ -1,5 +1,5 @@
-import { l as legacyRequire, F as FileSystemConfigLoader, e as esmResolver } from './core-nodejs.js';
-import { g as getFormatter$1, U as UserError, e as ensureError, i as ignore, d as deepmerge, H as HtmlValidate, K as engines, E as Reporter } from './core.js';
+import { l as legacyRequire, F as FileSystemConfigLoader, e as esmResolver, H as HtmlValidate } from './core-nodejs.js';
+import { g as getFormatter$1, U as UserError, e as ensureError, i as ignore, d as deepmerge, J as engines, B as Reporter } from './core.js';
 import path$1 from 'node:path/posix';
 import fs from 'fs';
 import path from 'node:path';

package/dist/es/core-browser.js

@@ -1,4 +1,420 @@
-import { U as UserError, L as compatibilityCheckImpl, v as version } from './core.js';
+import { f as StaticConfigLoader, K as normalizeSource, L as transformSource, O as Engine, P as Parser, Q as transformSourceSync, X as transformFilename, Y as transformFilenameSync, B as Reporter, Z as configurationSchema, _ as isThenable, U as UserError, b as ConfigLoader, $ as compatibilityCheckImpl, v as version } from './core.js';
+
+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, fs) {
+    const config = await this.getConfigFor(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const source = await transformFilename(resolvers, config, filename, fs);
+    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, fs) {
+    const config = this.getConfigForSync(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const source = transformFilenameSync(resolvers, config, filename, fs);
+    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, fs) {
+    return Reporter.merge(filenames.map((filename) => this.validateFile(filename, fs)));
+  }
+  /**
+   * 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, fs) {
+    return Reporter.merge(filenames.map((filename) => this.validateFileSync(filename, fs)));
+  }
+  /**
+   * 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, fs) {
+    const config = await this.getConfigFor(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const source = await transformFilename(resolvers, config, filename, fs);
+    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, fs) {
+    const config = await this.getConfigFor(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const source = await transformFilename(resolvers, config, filename, fs);
+    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, fs) {
+    const config = await this.getConfigFor(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const source = await transformFilename(resolvers, config, filename, fs);
+    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, fs) {
+    const config = await this.getConfigFor(filename);
+    const resolvers = this.configLoader.getResolvers();
+    const sources = await transformFilename(resolvers, config, filename, fs);
+    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);
+  }
+}
 
 function importFunction(id) {
   return import(id);
@@ -43,5 +459,5 @@ function compatibilityCheck(name, declared, options) {
   });
 }
 
-export { compatibilityCheck as c, esmResolver as e };
+export { HtmlValidate as H, compatibilityCheck as c, esmResolver as e };
 //# sourceMappingURL=core-browser.js.map