html-validate 6.7.1 → 6.9.1

package/dist/es/core.js

@@ -243,6 +243,42 @@ var ajvSchemaDraft = {
 }
 };
 
+function stringify(value) {
+    if (typeof value === "string") {
+        return String(value);
+    }
+    else {
+        return JSON.stringify(value);
+    }
+}
+/**
+ * Represents an `Error` created from arbitrary values.
+ *
+ * @public
+ */
+class WrappedError extends Error {
+    constructor(message) {
+        super(stringify(message));
+    }
+}
+
+/**
+ * Ensures the value is an Error.
+ *
+ * If the passed value is not an `Error` instance a [[WrappedError]] is
+ * constructed with the stringified value.
+ *
+ * @internal
+ */
+function ensureError(value) {
+    if (value instanceof Error) {
+        return value;
+    }
+    else {
+        return new WrappedError(value);
+    }
+}
+
 class NestedError extends Error {
     constructor(message, nested) {
         super(message);
@@ -931,7 +967,7 @@ class MetaTable {
             if (err instanceof SchemaValidationError) {
                 throw err;
             }
-            throw new UserError(`Failed to load element metadata from "${filename}"`, err);
+            throw new UserError(`Failed to load element metadata from "${filename}"`, ensureError(err));
         }
     }
     /**
@@ -1202,6 +1238,27 @@ class Attribute {
     }
 }
 
+function getCSSDeclarations(value) {
+    return value
+        .trim()
+        .split(";")
+        .filter(Boolean)
+        .map((it) => {
+        const [property, value] = it.split(":", 2);
+        return [property.trim(), value ? value.trim() : ""];
+    });
+}
+/**
+ * @internal
+ */
+function parseCssDeclaration(value) {
+    if (!value || value instanceof DynamicValue) {
+        return {};
+    }
+    const pairs = getCSSDeclarations(value);
+    return Object.fromEntries(pairs);
+}
+
 function sliceSize(size, begin, end) {
     if (typeof size !== "number") {
         return size;
@@ -1957,9 +2014,10 @@ class HtmlElement extends DOMNode {
             /* if a unique id is present, use it and short-circuit */
             if (cur.id) {
                 const escaped = escapeSelectorComponent(cur.id);
-                const matches = root.querySelectorAll(`#${escaped}`);
+                const selector = escaped.match(/^\d/) ? `[id="${escaped}"]` : `#${escaped}`;
+                const matches = root.querySelectorAll(selector);
                 if (matches.length === 1) {
-                    parts.push(`#${escaped}`);
+                    parts.push(selector);
                     break;
                 }
             }
@@ -2150,6 +2208,10 @@ class HtmlElement extends DOMNode {
     get id() {
         return this.getAttributeValue("id");
     }
+    get style() {
+        const attr = this.getAttribute("style");
+        return parseCssDeclaration(attr === null || attr === void 0 ? void 0 : attr.value);
+    }
     /**
      * Returns the first child element or null if there are no child elements.
      */
@@ -2955,7 +3017,7 @@ var TRANSFORMER_API;
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "6.7.1";
+const version = "6.9.1";
 /** @public */
 const homepage = "https://html-validate.org";
 /** @public */
@@ -3276,7 +3338,7 @@ function ruleDocumentationUrl(filename) {
     return `${homepage}/rules/${normalized}.html`;
 }
 
-const defaults$q = {
+const defaults$r = {
     allowExternal: true,
     allowRelative: true,
     allowAbsolute: true,
@@ -3320,7 +3382,7 @@ function matchList(value, list) {
 }
 class AllowedLinks extends Rule {
     constructor(options) {
-        super({ ...defaults$q, ...options });
+        super({ ...defaults$r, ...options });
         this.allowExternal = parseAllow(this.options.allowExternal);
         this.allowRelative = parseAllow(this.options.allowRelative);
         this.allowAbsolute = parseAllow(this.options.allowAbsolute);
@@ -3621,13 +3683,13 @@ class CaseStyle {
     }
 }
 
-const defaults$p = {
+const defaults$q = {
     style: "lowercase",
     ignoreForeign: true,
 };
 class AttrCase extends Rule {
     constructor(options) {
-        super({ ...defaults$p, ...options });
+        super({ ...defaults$q, ...options });
         this.style = new CaseStyle(this.options.style, "attr-case");
     }
     static schema() {
@@ -3943,9 +4005,6 @@ class Lexer {
 }
 
 const whitespace = /(\s+)/;
-function isRelevant$3(event) {
-    return event.type === TokenType.ATTR_VALUE;
-}
 class AttrDelimiter extends Rule {
     documentation() {
         return {
@@ -3954,8 +4013,12 @@ class AttrDelimiter extends Rule {
         };
     }
     setup() {
-        this.on("token", isRelevant$3, (event) => {
-            const delimiter = event.data[1];
+        this.on("token", (event) => {
+            const { token } = event;
+            if (token.type !== TokenType.ATTR_VALUE) {
+                return;
+            }
+            const delimiter = token.data[1];
             const match = whitespace.exec(delimiter);
             if (match) {
                 const location = sliceLocation(event.location, 0, delimiter.length);
@@ -3966,7 +4029,7 @@ class AttrDelimiter extends Rule {
 }
 
 const DEFAULT_PATTERN = "[a-z0-9-:]+";
-const defaults$o = {
+const defaults$p = {
     pattern: DEFAULT_PATTERN,
     ignoreForeign: true,
 };
@@ -4003,7 +4066,7 @@ function generateDescription(name, pattern) {
 }
 class AttrPattern extends Rule {
     constructor(options) {
-        super({ ...defaults$o, ...options });
+        super({ ...defaults$p, ...options });
         this.pattern = generateRegexp(this.options.pattern);
     }
     static schema() {
@@ -4063,13 +4126,13 @@ var QuoteStyle;
     QuoteStyle["DOUBLE_QUOTE"] = "\"";
     QuoteStyle["AUTO_QUOTE"] = "auto";
 })(QuoteStyle || (QuoteStyle = {}));
-const defaults$n = {
+const defaults$o = {
     style: "auto",
     unquoted: false,
 };
 class AttrQuotes extends Rule {
     constructor(options) {
-        super({ ...defaults$n, ...options });
+        super({ ...defaults$o, ...options });
         this.style = parseStyle$4(this.options.style);
     }
     static schema() {
@@ -4234,12 +4297,12 @@ class AttributeAllowedValues extends Rule {
     }
 }
 
-const defaults$m = {
+const defaults$n = {
     style: "omit",
 };
 class AttributeBooleanStyle extends Rule {
     constructor(options) {
-        super({ ...defaults$m, ...options });
+        super({ ...defaults$n, ...options });
         this.hasInvalidStyle = parseStyle$3(this.options.style);
     }
     static schema() {
@@ -4315,12 +4378,12 @@ function reportMessage$1(attr, style) {
     return "";
 }
 
-const defaults$l = {
+const defaults$m = {
     style: "omit",
 };
 class AttributeEmptyStyle extends Rule {
     constructor(options) {
-        super({ ...defaults$l, ...options });
+        super({ ...defaults$m, ...options });
         this.hasInvalidStyle = parseStyle$2(this.options.style);
     }
     static schema() {
@@ -4428,12 +4491,12 @@ function describePattern(pattern) {
     }
 }
 
-const defaults$k = {
+const defaults$l = {
     pattern: "kebabcase",
 };
 class ClassPattern extends Rule {
     constructor(options) {
-        super({ ...defaults$k, ...options });
+        super({ ...defaults$l, ...options });
         this.pattern = parsePattern(this.options.pattern);
     }
     static schema() {
@@ -4542,13 +4605,13 @@ class CloseOrder extends Rule {
     }
 }
 
-const defaults$j = {
+const defaults$k = {
     include: null,
     exclude: null,
 };
 class Deprecated extends Rule {
     constructor(options) {
-        super({ ...defaults$j, ...options });
+        super({ ...defaults$k, ...options });
     }
     static schema() {
         return {
@@ -4711,12 +4774,12 @@ class NoStyleTag$1 extends Rule {
     }
 }
 
-const defaults$i = {
+const defaults$j = {
     style: "uppercase",
 };
 class DoctypeStyle extends Rule {
     constructor(options) {
-        super({ ...defaults$i, ...options });
+        super({ ...defaults$j, ...options });
     }
     static schema() {
         return {
@@ -4748,12 +4811,12 @@ class DoctypeStyle extends Rule {
     }
 }
 
-const defaults$h = {
+const defaults$i = {
     style: "lowercase",
 };
 class ElementCase extends Rule {
     constructor(options) {
-        super({ ...defaults$h, ...options });
+        super({ ...defaults$i, ...options });
         this.style = new CaseStyle(this.options.style, "element-case");
     }
     static schema() {
@@ -4819,14 +4882,14 @@ class ElementCase extends Rule {
     }
 }
 
-const defaults$g = {
+const defaults$h = {
     pattern: "^[a-z][a-z0-9\\-._]*-[a-z0-9\\-._]*$",
     whitelist: [],
     blacklist: [],
 };
 class ElementName extends Rule {
     constructor(options) {
-        super({ ...defaults$g, ...options });
+        super({ ...defaults$h, ...options });
         // eslint-disable-next-line security/detect-non-literal-regexp
         this.pattern = new RegExp(this.options.pattern);
     }
@@ -4867,7 +4930,7 @@ class ElementName extends Rule {
                 ...context.blacklist.map((cur) => `- ${cur}`),
             ];
         }
-        if (context.pattern !== defaults$g.pattern) {
+        if (context.pattern !== defaults$h.pattern) {
             return [
                 `<${context.tagName}> is not a valid element name. This project is configured to only allow names matching the following regular expression:`,
                 "",
@@ -5269,7 +5332,7 @@ class EmptyTitle extends Rule {
     }
 }
 
-const defaults$f = {
+const defaults$g = {
     allowMultipleH1: false,
     minInitialRank: "h1",
     sectioningRoots: ["dialog", '[role="dialog"]'],
@@ -5300,7 +5363,7 @@ function parseMaxInitial(value) {
 }
 class HeadingLevel extends Rule {
     constructor(options) {
-        super({ ...defaults$f, ...options });
+        super({ ...defaults$g, ...options });
         this.stack = [];
         this.minInitialRank = parseMaxInitial(this.options.minInitialRank);
         this.sectionRoots = this.options.sectioningRoots.map((it) => new Pattern(it));
@@ -5458,12 +5521,12 @@ class HeadingLevel extends Rule {
     }
 }
 
-const defaults$e = {
+const defaults$f = {
     pattern: "kebabcase",
 };
 class IdPattern extends Rule {
     constructor(options) {
-        super({ ...defaults$e, ...options });
+        super({ ...defaults$f, ...options });
         this.pattern = parsePattern(this.options.pattern);
     }
     static schema() {
@@ -5814,12 +5877,12 @@ function findLabelByParent(el) {
     return [];
 }
 
-const defaults$d = {
+const defaults$e = {
     maxlength: 70,
 };
 class LongTitle extends Rule {
     constructor(options) {
-        super({ ...defaults$d, ...options });
+        super({ ...defaults$e, ...options });
         this.maxlength = this.options.maxlength;
     }
     static schema() {
@@ -5966,13 +6029,13 @@ class MultipleLabeledControls extends Rule {
     }
 }
 
-const defaults$c = {
+const defaults$d = {
     include: null,
     exclude: null,
 };
 class NoAutoplay extends Rule {
     constructor(options) {
-        super({ ...defaults$c, ...options });
+        super({ ...defaults$d, ...options });
     }
     documentation(context) {
         const tagName = context ? ` on <${context.tagName}>` : "";
@@ -6213,24 +6276,14 @@ Omitted end tags can be ambigious for humans to read and many editors have troub
     }
 }
 
-const defaults$b = {
+const defaults$c = {
     include: null,
     exclude: null,
     allowedProperties: ["display"],
 };
-function getCSSDeclarations(value) {
-    return value
-        .trim()
-        .split(";")
-        .filter(Boolean)
-        .map((it) => {
-        const [property, value] = it.split(":", 2);
-        return { property: property.trim(), value: value ? value.trim() : undefined };
-    });
-}
 class NoInlineStyle extends Rule {
     constructor(options) {
-        super({ ...defaults$b, ...options });
+        super({ ...defaults$c, ...options });
     }
     static schema() {
         return {
@@ -6308,18 +6361,15 @@ class NoInlineStyle extends Rule {
         return true;
     }
     allPropertiesAllowed(value) {
-        if (typeof value !== "string") {
-            return false;
-        }
         const allowProperties = this.options.allowedProperties;
         /* quick path: no properties are allowed, no need to check each one individually */
         if (allowProperties.length === 0) {
             return false;
         }
-        const declarations = getCSSDeclarations(value);
+        const declarations = Object.keys(parseCssDeclaration(value));
         return (declarations.length > 0 &&
             declarations.every((it) => {
-                return allowProperties.includes(it.property);
+                return allowProperties.includes(it);
             }));
     }
 }
@@ -6435,7 +6485,7 @@ class NoMultipleMain extends Rule {
     }
 }
 
-const defaults$a = {
+const defaults$b = {
     relaxed: false,
 };
 const textRegexp = /([<>]|&(?![a-zA-Z0-9#]+;))/g;
@@ -6452,7 +6502,7 @@ const replacementTable = {
 };
 class NoRawCharacters extends Rule {
     constructor(options) {
-        super({ ...defaults$a, ...options });
+        super({ ...defaults$b, ...options });
         this.relaxed = this.options.relaxed;
     }
     static schema() {
@@ -6630,13 +6680,13 @@ class NoRedundantRole extends Rule {
 }
 
 const xmlns = /^(.+):.+$/;
-const defaults$9 = {
+const defaults$a = {
     ignoreForeign: true,
     ignoreXML: true,
 };
 class NoSelfClosing extends Rule {
     constructor(options) {
-        super({ ...defaults$9, ...options });
+        super({ ...defaults$a, ...options });
     }
     static schema() {
         return {
@@ -6769,13 +6819,13 @@ const replacement = {
     reset: '<button type="reset">',
     image: '<button type="button">',
 };
-const defaults$8 = {
+const defaults$9 = {
     include: null,
     exclude: null,
 };
 class PreferButton extends Rule {
     constructor(options) {
-        super({ ...defaults$8, ...options });
+        super({ ...defaults$9, ...options });
     }
     static schema() {
         return {
@@ -6850,7 +6900,7 @@ class PreferButton extends Rule {
     }
 }
 
-const defaults$7 = {
+const defaults$8 = {
     mapping: {
         article: "article",
         banner: "header",
@@ -6880,7 +6930,7 @@ const defaults$7 = {
 };
 class PreferNativeElement extends Rule {
     constructor(options) {
-        super({ ...defaults$7, ...options });
+        super({ ...defaults$8, ...options });
     }
     static schema() {
         return {
@@ -7000,7 +7050,7 @@ class PreferTbody extends Rule {
     }
 }
 
-const defaults$6 = {
+const defaults$7 = {
     target: "all",
 };
 const crossorigin = new RegExp("^(\\w+://|//)"); /* e.g. https:// or // */
@@ -7010,7 +7060,7 @@ const supportSri = {
 };
 class RequireSri extends Rule {
     constructor(options) {
-        super({ ...defaults$6, ...options });
+        super({ ...defaults$7, ...options });
         this.target = this.options.target;
     }
     static schema() {
@@ -7138,12 +7188,13 @@ class SvgFocusable extends Rule {
     }
 }
 
-const defaults$5 = {
+const defaults$6 = {
     characters: [
         { pattern: " ", replacement: "&nbsp;", description: "non-breaking space" },
         { pattern: "-", replacement: "&#8209;", description: "non-breaking hyphen" },
     ],
     ignoreClasses: [],
+    ignoreStyle: true,
 };
 function constructRegex(characters) {
     const disallowed = characters
@@ -7180,7 +7231,7 @@ function matchAll(text, regexp) {
 }
 class TelNonBreaking extends Rule {
     constructor(options) {
-        super({ ...defaults$5, ...options });
+        super({ ...defaults$6, ...options });
         this.regex = constructRegex(this.options.characters);
     }
     static schema() {
@@ -7209,6 +7260,9 @@ class TelNonBreaking extends Rule {
                     type: "string",
                 },
             },
+            ignoreStyle: {
+                type: "boolean",
+            },
         };
     }
     documentation(context) {
@@ -7235,10 +7289,7 @@ class TelNonBreaking extends Rule {
     setup() {
         this.on("element:ready", this.isRelevant, (event) => {
             const { target } = event;
-            const { ignoreClasses } = this.options;
-            /* skip if element has a class in the ignore list */
-            const isIgnored = ignoreClasses.some((it) => target.classList.contains(it));
-            if (isIgnored) {
+            if (this.isIgnored(target)) {
                 return;
             }
             this.walk(target, target);
@@ -7257,6 +7308,25 @@ class TelNonBreaking extends Rule {
         }
         return true;
     }
+    isIgnoredClass(node) {
+        const { ignoreClasses } = this.options;
+        const { classList } = node;
+        return ignoreClasses.some((it) => classList.contains(it));
+    }
+    isIgnoredStyle(node) {
+        const { ignoreStyle } = this.options;
+        const { style } = node;
+        if (!ignoreStyle) {
+            return false;
+        }
+        if (style["white-space"] === "nowrap" || style["white-space"] === "pre") {
+            return true;
+        }
+        return false;
+    }
+    isIgnored(node) {
+        return this.isIgnoredClass(node) || this.isIgnoredStyle(node);
+    }
     walk(anchor, node) {
         for (const child of node.childNodes) {
             if (isTextNode(child)) {
@@ -9240,6 +9310,95 @@ class UnknownCharReference extends Rule {
     }
 }
 
+var RuleContext;
+(function (RuleContext) {
+    RuleContext[RuleContext["EMPTY"] = 1] = "EMPTY";
+    RuleContext[RuleContext["WHITESPACE"] = 2] = "WHITESPACE";
+    RuleContext[RuleContext["LEADING_CHARACTER"] = 3] = "LEADING_CHARACTER";
+    RuleContext[RuleContext["DISALLOWED_CHARACTER"] = 4] = "DISALLOWED_CHARACTER";
+})(RuleContext || (RuleContext = {}));
+const defaults$5 = {
+    relaxed: false,
+};
+class ValidID extends Rule {
+    constructor(options) {
+        super({ ...defaults$5, ...options });
+    }
+    static schema() {
+        return {
+            relaxed: {
+                type: "boolean",
+            },
+        };
+    }
+    documentation(context) {
+        const { relaxed } = this.options;
+        const message = context
+            ? this.messages[context].replace("id", "ID").replace(/^(.)/, (m) => m.toUpperCase())
+            : "Element ID is not valid";
+        const relaxedDescription = relaxed
+            ? []
+            : [
+                "  - ID must begin with a letter",
+                "  - ID must only contain alphanumerical characters, `-` and `_`",
+            ];
+        return {
+            description: [
+                `${message}.`,
+                "",
+                "Under the current configuration the following rules are applied:",
+                "",
+                "  - ID must not be empty",
+                "  - ID must not contain any whitespace characters",
+                ...relaxedDescription,
+            ].join("\n"),
+            url: ruleDocumentationUrl("@/rules/valid-id.ts"),
+        };
+    }
+    setup() {
+        this.on("attr", this.isRelevant, (event) => {
+            const { value } = event;
+            if (value === null || value instanceof DynamicValue) {
+                return;
+            }
+            if (value === "") {
+                const context = RuleContext.EMPTY;
+                this.report(event.target, this.messages[context], event.location, context);
+                return;
+            }
+            if (value.match(/\s/)) {
+                const context = RuleContext.WHITESPACE;
+                this.report(event.target, this.messages[context], event.valueLocation, context);
+                return;
+            }
+            const { relaxed } = this.options;
+            if (relaxed) {
+                return;
+            }
+            if (value.match(/^[^a-zA-Z]/)) {
+                const context = RuleContext.LEADING_CHARACTER;
+                this.report(event.target, this.messages[context], event.valueLocation, context);
+                return;
+            }
+            if (value.match(/[^a-zA-Z0-9-_]/)) {
+                const context = RuleContext.DISALLOWED_CHARACTER;
+                this.report(event.target, this.messages[context], event.valueLocation, context);
+            }
+        });
+    }
+    get messages() {
+        return {
+            [RuleContext.EMPTY]: "element id must not be empty",
+            [RuleContext.WHITESPACE]: "element id must not contain whitespace",
+            [RuleContext.LEADING_CHARACTER]: "element id must begin with a letter",
+            [RuleContext.DISALLOWED_CHARACTER]: "element id must only contain alphanumerical, dash and underscore characters",
+        };
+    }
+    isRelevant(event) {
+        return event.key === "id";
+    }
+}
+
 var Style$1;
 (function (Style) {
     Style[Style["Any"] = 0] = "Any";
@@ -9751,6 +9910,7 @@ const bundledRules = {
     "tel-non-breaking": TelNonBreaking,
     "text-content": TextContent,
     "unrecognized-char-ref": UnknownCharReference,
+    "valid-id": ValidID,
     void: Void,
     "void-content": VoidContent,
     "void-style": VoidStyle,
@@ -9848,6 +10008,7 @@ const config$1 = {
         "tel-non-breaking": "error",
         "text-content": "error",
         "unrecognized-char-ref": "error",
+        "valid-id": ["error", { relaxed: false }],
         void: "off",
         "void-content": "error",
         "void-style": "error",
@@ -9883,6 +10044,7 @@ const config = {
         "no-raw-characters": ["error", { relaxed: true }],
         "script-element": "error",
         "unrecognized-char-ref": "error",
+        "valid-id": ["error", { relaxed: true }],
         "void-content": "error",
     },
 };
@@ -9952,7 +10114,7 @@ class ResolvedConfig {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                throw new NestedError(`When transforming "${source.filename}": ${message}`, err);
+                throw new NestedError(`When transforming "${source.filename}": ${message}`, ensureError(err));
             }
         }
         else {
@@ -10024,7 +10186,7 @@ function loadFromFile(filename) {
         json = requireUncached(filename);
     }
     catch (err) {
-        throw new ConfigError(`Failed to read configuration from "${filename}"`, err);
+        throw new ConfigError(`Failed to read configuration from "${filename}"`, ensureError(err));
     }
     /* expand any relative paths */
     for (const key of ["extends", "elements", "plugins"]) {
@@ -10212,7 +10374,7 @@ class Config {
             }
             let filename;
             /* try searching builtin metadata */
-            filename = path.join(projectRoot, "elements", `${entry}.json`);
+            filename = path.join(projectRoot, "elements", `${entry}.js`);
             if (fs.existsSync(filename)) {
                 metaTable.loadFromFile(filename);
                 continue;
@@ -10229,7 +10391,7 @@ class Config {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                throw new ConfigError(`Failed to load elements from "${entry}": ${message}`, err);
+                throw new ConfigError(`Failed to load elements from "${entry}": ${message}`, ensureError(err));
             }
         }
         metaTable.init();
@@ -10306,7 +10468,7 @@ class Config {
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);
-                throw new ConfigError(`Failed to load plugin "${moduleName}": ${message}`, err);
+                throw new ConfigError(`Failed to load plugin "${moduleName}": ${message}`, ensureError(err));
             }
         });
     }
@@ -10399,7 +10561,7 @@ class Config {
                     throw new ConfigError(`Failed to load transformer "${name}": ${err.message}`, err);
                 }
                 else {
-                    throw new ConfigError(`Failed to load transformer "${name}"`, err);
+                    throw new ConfigError(`Failed to load transformer "${name}"`, ensureError(err));
                 }
             }
         });
@@ -11123,6 +11285,7 @@ class Parser {
                 location: token.location,
                 type: token.type,
                 data: Array.from(token.data),
+                token,
             });
         }
         return it;
@@ -11171,6 +11334,12 @@ class Parser {
     }
 }
 
+function freeze(src) {
+    return {
+        ...src,
+        selector: src.selector(),
+    };
+}
 /**
  * @internal
  */
@@ -11222,7 +11391,9 @@ class Reporter {
             line: location.line,
             column: location.column,
             size: location.size || 0,
-            selector: node ? node.generateSelector() : null,
+            selector() {
+                return node ? node.generateSelector() : null;
+            },
             context,
         });
     }
@@ -11236,7 +11407,7 @@ class Reporter {
         const report = {
             valid: this.isValid(),
             results: Object.keys(this.result).map((filePath) => {
-                const messages = Array.from(this.result[filePath]).sort(messageSort);
+                const messages = Array.from(this.result[filePath], freeze).sort(messageSort);
                 const source = (sources || []).find((source) => { var _a; return filePath === ((_a = source.filename) !== null && _a !== void 0 ? _a : ""); });
                 return {
                     filePath,
@@ -11433,8 +11604,9 @@ class Engine {
     getRuleDocumentation(ruleId, context // eslint-disable-line @typescript-eslint/explicit-module-boundary-types
     ) {
         const rules = this.config.getRules();
-        if (rules.has(ruleId)) {
-            const [, options] = rules.get(ruleId);
+        const ruleData = rules.get(ruleId);
+        if (ruleData) {
+            const [, options] = ruleData;
             const rule = this.instantiateRule(ruleId, options);
             return rule.documentation(context);
         }
@@ -11638,7 +11810,7 @@ class Engine {
             line: location.line,
             column: location.column,
             size: location.size || 0,
-            selector: null,
+            selector: () => null,
         });
     }
 }
@@ -12161,6 +12333,7 @@ const formatter$4 = checkstyleFormatter;
 const defaults = {
     showLink: true,
     showSummary: true,
+    showSelector: false,
 };
 /**
  * Codeframe formatter based on ESLint codeframe.
@@ -12216,6 +12389,7 @@ function getEndLocation(message, source) {
  * @returns The formatted output.
  */
 function formatMessage(message, parentResult, options) {
+    var _a;
     const type = message.severity === 2 ? kleur.red("error") : kleur.yellow("warning");
     const msg = `${kleur.bold(message.message.replace(/([^ ])\.$/, "$1"))}`;
     const ruleId = kleur.dim(`(${message.ruleId})`);
@@ -12238,6 +12412,9 @@ function formatMessage(message, parentResult, options) {
             end: getEndLocation(message, sourceCode),
         }, { highlightCode: false }));
     }
+    if (options.showSelector) {
+        result.push(`${kleur.bold("Selector:")} ${(_a = message.selector) !== null && _a !== void 0 ? _a : "-"}`);
+    }
     if (options.showLink && message.ruleUrl) {
         result.push(`${kleur.bold("Details:")} ${message.ruleUrl}`);
     }
@@ -12360,5 +12537,5 @@ function getFormatter(name) {
     return (_a = availableFormatters[name]) !== null && _a !== void 0 ? _a : null;
 }
 
-export { Config as C, DynamicValue as D, EventHandler as E, FileSystemConfigLoader as F, HtmlValidate as H, MetaTable as M, NodeClosed as N, Parser as P, Rule as R, Severity as S, TextNode as T, UserError as U, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, HtmlElement as d, SchemaValidationError as e, MetaCopyableProperty as f, Reporter as g, TemplateExtractor as h, getFormatter as i, compatibilityCheck as j, TokenType as k, legacyRequire as l, bugs as m, name as n, presets as p, ruleExists as r, version as v };
+export { Config as C, DynamicValue as D, EventHandler as E, FileSystemConfigLoader as F, HtmlValidate as H, MetaTable as M, NodeClosed as N, Parser as P, Rule as R, Severity as S, TextNode as T, UserError as U, WrappedError as W, ConfigError as a, ConfigLoader as b, StaticConfigLoader as c, HtmlElement as d, SchemaValidationError as e, NestedError as f, MetaCopyableProperty as g, Reporter as h, TemplateExtractor as i, getFormatter as j, ensureError as k, legacyRequire as l, compatibilityCheck as m, codeframe as n, name as o, presets as p, bugs as q, ruleExists as r, version as v };
 //# sourceMappingURL=core.js.map