html-validate 7.11.0 → 7.11.1

package/dist/cjs/core.d.ts

@@ -2041,6 +2041,8 @@ declare class NestedError extends Error {
  * @public
  */
 declare class UserError extends NestedError {
+    constructor(message: string, nested?: Error);
+    prettyFormat(): string | undefined;
 }
 
 /**
@@ -2069,6 +2071,7 @@ declare class WrappedError<T> extends Error {
  * @public
  */
 declare class ConfigError extends UserError {
+    constructor(message: string, nested?: Error);
 }
 
 /**

package/dist/cjs/core.js

@@ -1672,6 +1672,7 @@ class NestedError extends Error {
     constructor(message, nested) {
         super(message);
         Error.captureStackTrace(this, NestedError);
+        this.name = NestedError.name;
         if (nested && nested.stack) {
             this.stack += `\nCaused by: ${nested.stack}`;
         }
@@ -1682,6 +1683,44 @@ class NestedError extends Error {
  * @public
  */
 class UserError extends NestedError {
+    constructor(message, nested) {
+        super(message, nested);
+        Error.captureStackTrace(this, UserError);
+        this.name = UserError.name;
+    }
+    prettyFormat() {
+        return undefined;
+    }
+}
+
+/**
+ * @internal
+ */
+class InheritError extends UserError {
+    constructor({ tagName, inherit }) {
+        const message = `Element <${tagName}> cannot inherit from <${inherit}>: no such element`;
+        super(message);
+        Error.captureStackTrace(this, InheritError);
+        this.name = InheritError.name;
+        this.tagName = tagName;
+        this.inherit = inherit;
+        this.filename = null;
+    }
+    prettyFormat() {
+        const { message, tagName, inherit } = this;
+        const source = this.filename
+            ? ["", "This error occurred when loading element metadata from:", `"${this.filename}"`, ""]
+            : [""];
+        return [
+            message,
+            ...source,
+            "This usually occurs when the elements are defined in the wrong order, try one of the following:",
+            "",
+            `  - Ensure the spelling of "${inherit}" is correct.`,
+            `  - Ensure the file containing "${inherit}" is loaded before the file containing "${tagName}".`,
+            `  - Move the definition of "${inherit}" above the definition for "${tagName}".`,
+        ].join("\n");
+    }
 }
 
 function getSummary(schema, obj, errors) {
@@ -2105,6 +2144,9 @@ const definitions = {
 						items: {
 							type: "string"
 						}
+					},
+					{
+						type: "null"
 					}
 				]
 			}
@@ -2415,6 +2457,10 @@ class MetaTable {
             this.loadFromObject(data, filename);
         }
         catch (err) {
+            if (err instanceof InheritError) {
+                err.filename = filename;
+                throw err;
+            }
             if (err instanceof SchemaValidationError) {
                 throw err;
             }
@@ -2467,7 +2513,10 @@ class MetaTable {
             const name = entry.inherit;
             parent = this.elements[name];
             if (!parent) {
-                throw new UserError(`Element <${tagName}> cannot inherit from <${name}>: no such element`);
+                throw new InheritError({
+                    tagName,
+                    inherit: name,
+                });
             }
         }
         /* merge all sources together */
@@ -3952,6 +4001,11 @@ class AriaLabelMisuse extends Rule {
  * @public
  */
 class ConfigError extends UserError {
+    constructor(message, nested) {
+        super(message, nested);
+        Error.captureStackTrace(this, ConfigError);
+        this.name = ConfigError.name;
+    }
 }
 
 const defaults$t = {
@@ -11201,7 +11255,7 @@ class HtmlValidate {
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "7.11.0";
+const version = "7.11.1";
 /** @public */
 const bugs = "https://gitlab.com/html-validate/html-validate/issues/new";