html-validate 6.7.1 → 6.8.0

package/dist/cjs/browser.d.ts

@@ -1,3 +1,3 @@
-export { A as AttributeData, X as AttributeEvent, Z as ConditionalEvent, C as Config, a as ConfigData, b as ConfigError, c as ConfigLoader, F as ConfigReadyEvent, a0 as DOMLoadEvent, a1 as DOMReadyEvent, _ as DirectiveEvent, $ as DoctypeEvent, D as DynamicValue, W as ElementReadyEvent, B as Event, z as EventCallback, E as EventDump, y as EventHandler, e as HtmlElement, H as HtmlValidate, a3 as ListenEventMap, L as Location, o as Message, j as MetaCopyableProperty, M as MetaData, h as MetaElement, i as MetaTable, N as NodeClosed, w as Parser, u as Plugin, P as ProcessElementContext, m as Report, n as Reporter, q as Result, R as Rule, k as RuleDocumentation, g as SchemaValidationError, S as Severity, l as Source, G as SourceReadyEvent, d as StaticConfigLoader, Q as TagCloseEvent, O as TagEndEvent, K as TagOpenEvent, V as TagReadyEvent, J as TagStartEvent, t as TemplateExtractor, T as TextNode, f as TokenDump, I as TokenEvent, r as TransformContext, s as Transformer, a2 as TriggerEventMap, U as UserError, Y as WhitespaceEvent, p as configPresets, x as ruleExists, v as version } from './core.js';
+export { A as AttributeData, Z as AttributeEvent, f as CSSStyleDeclaration, $ as ConditionalEvent, C as Config, a as ConfigData, b as ConfigError, c as ConfigLoader, I as ConfigReadyEvent, a2 as DOMLoadEvent, a3 as DOMReadyEvent, s as DeferredMessage, a0 as DirectiveEvent, a1 as DoctypeEvent, D as DynamicValue, Y as ElementReadyEvent, G as Event, F as EventCallback, E as EventDump, B as EventHandler, e as HtmlElement, H as HtmlValidate, a5 as ListenEventMap, L as Location, q as Message, k as MetaCopyableProperty, M as MetaData, i as MetaElement, j as MetaTable, N as NodeClosed, y as Parser, x as Plugin, P as ProcessElementContext, n as Report, o as Reporter, r as Result, R as Rule, l as RuleDocumentation, h as SchemaValidationError, S as Severity, m as Source, J as SourceReadyEvent, d as StaticConfigLoader, W as TagCloseEvent, V as TagEndEvent, Q as TagOpenEvent, X as TagReadyEvent, O as TagStartEvent, w as TemplateExtractor, T as TextNode, g as TokenDump, K as TokenEvent, t as TransformContext, u as Transformer, a4 as TriggerEventMap, U as UserError, _ as WhitespaceEvent, p as configPresets, z as ruleExists, v as version } from './core.js';
 import 'ajv';
 import 'ajv/dist/types';

package/dist/cjs/core.d.ts

@@ -215,6 +215,12 @@ interface Message {
      */
     context?: any;
 }
+/**
+ * @internal
+ */
+interface DeferredMessage extends Omit<Message, "selector"> {
+    selector: () => string | null;
+}
 /**
  * @public
  */
@@ -244,16 +250,14 @@ interface Report {
  * @internal
  */
 declare class Reporter {
-    protected result: {
-        [filename: string]: Message[];
-    };
+    protected result: Record<string, DeferredMessage[]>;
     constructor();
     /**
      * Merge two or more reports into a single one.
      */
     static merge(reports: Report[]): Report;
     add<ContextType, OptionsType>(rule: Rule<ContextType, OptionsType>, message: string, severity: number, node: DOMNode | null, location: Location, context?: ContextType): void;
-    addManual(filename: string, message: Message): void;
+    addManual(filename: string, message: DeferredMessage): void;
     save(sources?: Source[]): Report;
     protected isValid(): boolean;
 }
@@ -981,6 +985,10 @@ declare class Attribute {
     valueMatches(pattern: string, dynamicMatches?: boolean): boolean;
 }
 
+interface CSSStyleDeclaration {
+    [key: string]: string;
+}
+
 interface PermittedGroup {
     exclude?: string | string[];
 }
@@ -1362,6 +1370,7 @@ declare class HtmlElement extends DOMNode {
      * Get element ID if present.
      */
     get id(): string | null;
+    get style(): CSSStyleDeclaration;
     /**
      * Returns the first child element or null if there are no child elements.
      */
@@ -2310,4 +2319,4 @@ declare type Formatter = (results: Result[]) => string;
  */
 declare function getFormatter(name: string): Formatter | null;
 
-export { DoctypeEvent as $, AttributeData as A, Event as B, Config as C, DynamicValue as D, EventDump as E, ConfigReadyEvent as F, SourceReadyEvent as G, HtmlValidate as H, TokenEvent as I, TagStartEvent as J, TagOpenEvent as K, Location as L, MetaData as M, NodeClosed as N, TagEndEvent as O, ProcessElementContext as P, TagCloseEvent as Q, Rule as R, Severity as S, TextNode as T, UserError as U, TagReadyEvent as V, ElementReadyEvent as W, AttributeEvent as X, WhitespaceEvent as Y, ConditionalEvent as Z, DirectiveEvent as _, ConfigData as a, DOMLoadEvent as a0, DOMReadyEvent as a1, TriggerEventMap as a2, ListenEventMap as a3, FileSystemConfigLoader as a4, Formatter as a5, getFormatter as a6, compatibilityCheck as a7, CompatibilityOptions as a8, TokenType as a9, ConfigError as b, ConfigLoader as c, StaticConfigLoader as d, HtmlElement as e, TokenDump as f, SchemaValidationError as g, MetaElement as h, MetaTable as i, MetaCopyableProperty as j, RuleDocumentation as k, Source as l, Report as m, Reporter as n, Message as o, presets as p, Result as q, TransformContext as r, Transformer as s, TemplateExtractor as t, Plugin as u, version as v, Parser as w, ruleExists as x, EventHandler as y, EventCallback as z };
+export { ConditionalEvent as $, AttributeData as A, EventHandler as B, Config as C, DynamicValue as D, EventDump as E, EventCallback as F, Event as G, HtmlValidate as H, ConfigReadyEvent as I, SourceReadyEvent as J, TokenEvent as K, Location as L, MetaData as M, NodeClosed as N, TagStartEvent as O, ProcessElementContext as P, TagOpenEvent as Q, Rule as R, Severity as S, TextNode as T, UserError as U, TagEndEvent as V, TagCloseEvent as W, TagReadyEvent as X, ElementReadyEvent as Y, AttributeEvent as Z, WhitespaceEvent as _, ConfigData as a, DirectiveEvent as a0, DoctypeEvent as a1, DOMLoadEvent as a2, DOMReadyEvent as a3, TriggerEventMap as a4, ListenEventMap as a5, FileSystemConfigLoader as a6, Formatter as a7, getFormatter as a8, compatibilityCheck as a9, CompatibilityOptions as aa, ConfigError as b, ConfigLoader as c, StaticConfigLoader as d, HtmlElement as e, CSSStyleDeclaration as f, TokenDump as g, SchemaValidationError as h, MetaElement as i, MetaTable as j, MetaCopyableProperty as k, RuleDocumentation as l, Source as m, Report as n, Reporter as o, presets as p, Message as q, Result as r, DeferredMessage as s, TransformContext as t, Transformer as u, version as v, TemplateExtractor as w, Plugin as x, Parser as y, ruleExists as z };

package/dist/cjs/core.js

@@ -1233,6 +1233,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;
@@ -2181,6 +2202,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.
      */
@@ -2986,7 +3011,7 @@ var TRANSFORMER_API;
 /** @public */
 const name = "html-validate";
 /** @public */
-const version = "6.7.1";
+const version = "6.8.0";
 /** @public */
 const homepage = "https://html-validate.org";
 /** @public */
@@ -3720,7 +3745,7 @@ class AttrCase extends Rule {
     }
 }
 
-exports.TokenType = void 0;
+var TokenType;
 (function (TokenType) {
     TokenType[TokenType["UNICODE_BOM"] = 1] = "UNICODE_BOM";
     TokenType[TokenType["WHITESPACE"] = 2] = "WHITESPACE";
@@ -3739,7 +3764,7 @@ exports.TokenType = void 0;
     TokenType[TokenType["CONDITIONAL"] = 15] = "CONDITIONAL";
     TokenType[TokenType["DIRECTIVE"] = 16] = "DIRECTIVE";
     TokenType[TokenType["EOF"] = 17] = "EOF";
-})(exports.TokenType || (exports.TokenType = {}));
+})(TokenType || (TokenType = {}));
 
 /* eslint-disable no-useless-escape */
 const MATCH_UNICODE_BOM = /^\uFEFF/;
@@ -3818,7 +3843,7 @@ class Lexer {
             previousState = context.state;
             previousLength = context.string.length;
         }
-        yield this.token(context, exports.TokenType.EOF, []);
+        yield this.token(context, TokenType.EOF, []);
     }
     token(context, type, data) {
         const size = data.length > 0 ? data[0].length : 0;
@@ -3889,21 +3914,21 @@ class Lexer {
     }
     *tokenizeInitial(context) {
         yield* this.match(context, [
-            [MATCH_UNICODE_BOM, State.INITIAL, exports.TokenType.UNICODE_BOM],
+            [MATCH_UNICODE_BOM, State.INITIAL, TokenType.UNICODE_BOM],
             [MATCH_XML_TAG, State.INITIAL, false],
-            [MATCH_DOCTYPE_OPEN, State.DOCTYPE, exports.TokenType.DOCTYPE_OPEN],
-            [MATCH_WHITESPACE, State.INITIAL, exports.TokenType.WHITESPACE],
-            [MATCH_DIRECTIVE, State.INITIAL, exports.TokenType.DIRECTIVE],
-            [MATCH_CONDITIONAL, State.INITIAL, exports.TokenType.CONDITIONAL],
-            [MATCH_COMMENT, State.INITIAL, exports.TokenType.COMMENT],
+            [MATCH_DOCTYPE_OPEN, State.DOCTYPE, TokenType.DOCTYPE_OPEN],
+            [MATCH_WHITESPACE, State.INITIAL, TokenType.WHITESPACE],
+            [MATCH_DIRECTIVE, State.INITIAL, TokenType.DIRECTIVE],
+            [MATCH_CONDITIONAL, State.INITIAL, TokenType.CONDITIONAL],
+            [MATCH_COMMENT, State.INITIAL, TokenType.COMMENT],
             [false, State.TEXT, false],
         ], "expected doctype");
     }
     *tokenizeDoctype(context) {
         yield* this.match(context, [
-            [MATCH_WHITESPACE, State.DOCTYPE, exports.TokenType.WHITESPACE],
-            [MATCH_DOCTYPE_VALUE, State.DOCTYPE, exports.TokenType.DOCTYPE_VALUE],
-            [MATCH_DOCTYPE_CLOSE, State.TEXT, exports.TokenType.DOCTYPE_CLOSE],
+            [MATCH_WHITESPACE, State.DOCTYPE, TokenType.WHITESPACE],
+            [MATCH_DOCTYPE_VALUE, State.DOCTYPE, TokenType.DOCTYPE_VALUE],
+            [MATCH_DOCTYPE_CLOSE, State.TEXT, TokenType.DOCTYPE_CLOSE],
         ], "expected doctype name");
     }
     *tokenizeTag(context) {
@@ -3930,30 +3955,30 @@ class Lexer {
             }
         }
         yield* this.match(context, [
-            [MATCH_TAG_CLOSE, nextState, exports.TokenType.TAG_CLOSE],
-            [MATCH_ATTR_START, State.ATTR, exports.TokenType.ATTR_NAME],
-            [MATCH_WHITESPACE, State.TAG, exports.TokenType.WHITESPACE],
+            [MATCH_TAG_CLOSE, nextState, TokenType.TAG_CLOSE],
+            [MATCH_ATTR_START, State.ATTR, TokenType.ATTR_NAME],
+            [MATCH_WHITESPACE, State.TAG, TokenType.WHITESPACE],
         ], 'expected attribute, ">" or "/>"');
     }
     *tokenizeAttr(context) {
         yield* this.match(context, [
-            [MATCH_ATTR_SINGLE, State.TAG, exports.TokenType.ATTR_VALUE],
-            [MATCH_ATTR_DOUBLE, State.TAG, exports.TokenType.ATTR_VALUE],
-            [MATCH_ATTR_UNQUOTED, State.TAG, exports.TokenType.ATTR_VALUE],
+            [MATCH_ATTR_SINGLE, State.TAG, TokenType.ATTR_VALUE],
+            [MATCH_ATTR_DOUBLE, State.TAG, TokenType.ATTR_VALUE],
+            [MATCH_ATTR_UNQUOTED, State.TAG, TokenType.ATTR_VALUE],
             [false, State.TAG, false],
         ], 'expected attribute, ">" or "/>"');
     }
     *tokenizeText(context) {
         yield* this.match(context, [
-            [MATCH_WHITESPACE, State.TEXT, exports.TokenType.WHITESPACE],
+            [MATCH_WHITESPACE, State.TEXT, TokenType.WHITESPACE],
             [MATCH_CDATA_BEGIN, State.CDATA, false],
-            [MATCH_DIRECTIVE, State.TEXT, exports.TokenType.DIRECTIVE],
-            [MATCH_CONDITIONAL, State.TEXT, exports.TokenType.CONDITIONAL],
-            [MATCH_COMMENT, State.TEXT, exports.TokenType.COMMENT],
-            [MATCH_TEMPLATING, State.TEXT, exports.TokenType.TEMPLATING],
-            [MATCH_TAG_OPEN, State.TAG, exports.TokenType.TAG_OPEN],
-            [MATCH_TEXT, State.TEXT, exports.TokenType.TEXT],
-            [MATCH_TAG_LOOKAHEAD, State.TEXT, exports.TokenType.TEXT],
+            [MATCH_DIRECTIVE, State.TEXT, TokenType.DIRECTIVE],
+            [MATCH_CONDITIONAL, State.TEXT, TokenType.CONDITIONAL],
+            [MATCH_COMMENT, State.TEXT, TokenType.COMMENT],
+            [MATCH_TEMPLATING, State.TEXT, TokenType.TEMPLATING],
+            [MATCH_TAG_OPEN, State.TAG, TokenType.TAG_OPEN],
+            [MATCH_TEXT, State.TEXT, TokenType.TEXT],
+            [MATCH_TAG_LOOKAHEAD, State.TEXT, TokenType.TEXT],
         ], 'expected text or "<"');
     }
     *tokenizeCDATA(context) {
@@ -3961,21 +3986,21 @@ class Lexer {
     }
     *tokenizeScript(context) {
         yield* this.match(context, [
-            [MATCH_SCRIPT_END, State.TAG, exports.TokenType.TAG_OPEN],
-            [MATCH_SCRIPT_DATA, State.SCRIPT, exports.TokenType.SCRIPT],
+            [MATCH_SCRIPT_END, State.TAG, TokenType.TAG_OPEN],
+            [MATCH_SCRIPT_DATA, State.SCRIPT, TokenType.SCRIPT],
         ], "expected </script>");
     }
     *tokenizeStyle(context) {
         yield* this.match(context, [
-            [MATCH_STYLE_END, State.TAG, exports.TokenType.TAG_OPEN],
-            [MATCH_STYLE_DATA, State.STYLE, exports.TokenType.STYLE],
+            [MATCH_STYLE_END, State.TAG, TokenType.TAG_OPEN],
+            [MATCH_STYLE_DATA, State.STYLE, TokenType.STYLE],
         ], "expected </style>");
     }
 }
 
 const whitespace = /(\s+)/;
 function isRelevant$3(event) {
-    return event.type === exports.TokenType.ATTR_VALUE;
+    return event.type === TokenType.ATTR_VALUE;
 }
 class AttrDelimiter extends Rule {
     documentation() {
@@ -4179,7 +4204,7 @@ class AttrSpacing extends Rule {
     setup() {
         let previousToken;
         this.on("token", (event) => {
-            if (event.type === exports.TokenType.ATTR_NAME && previousToken !== exports.TokenType.WHITESPACE) {
+            if (event.type === TokenType.ATTR_NAME && previousToken !== TokenType.WHITESPACE) {
                 this.report(null, "No space between attributes", event.location);
             }
             previousToken = event.type;
@@ -6249,16 +6274,6 @@ const defaults$b = {
     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 });
@@ -6339,18 +6354,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);
             }));
     }
 }
@@ -6783,7 +6795,7 @@ class NoUtf8Bom extends Rule {
     }
     setup() {
         const unregister = this.on("token", (event) => {
-            if (event.type === exports.TokenType.UNICODE_BOM) {
+            if (event.type === TokenType.UNICODE_BOM) {
                 this.report(null, "File should be saved without UTF-8 BOM", event.location);
             }
             /* since the BOM must be the very first thing the rule can now be disabled for the rest of the run */
@@ -7175,6 +7187,7 @@ const defaults$5 = {
         { pattern: "-", replacement: "&#8209;", description: "non-breaking hyphen" },
     ],
     ignoreClasses: [],
+    ignoreStyle: true,
 };
 function constructRegex(characters) {
     const disallowed = characters
@@ -7240,6 +7253,9 @@ class TelNonBreaking extends Rule {
                     type: "string",
                 },
             },
+            ignoreStyle: {
+                type: "boolean",
+            },
         };
     }
     documentation(context) {
@@ -7266,10 +7282,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);
@@ -7288,6 +7301,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)) {
@@ -10243,7 +10275,7 @@ class Config {
             }
             let filename;
             /* try searching builtin metadata */
-            filename = path__default["default"].join(projectRoot, "elements", `${entry}.json`);
+            filename = path__default["default"].join(projectRoot, "elements", `${entry}.js`);
             if (fs__default["default"].existsSync(filename)) {
                 metaTable.loadFromFile(filename);
                 continue;
@@ -10657,7 +10689,7 @@ class ParserError extends Error {
 }
 
 function isAttrValueToken(token) {
-    return Boolean(token && token.type === exports.TokenType.ATTR_VALUE);
+    return Boolean(token && token.type === TokenType.ATTR_VALUE);
 }
 function svgShouldRetainTag(foreignTagName, tagName) {
     return foreignTagName === "svg" && ["title", "desc"].includes(tagName);
@@ -10765,43 +10797,43 @@ class Parser {
     /* eslint-disable-next-line complexity */
     consume(source, token, tokenStream) {
         switch (token.type) {
-            case exports.TokenType.UNICODE_BOM:
+            case TokenType.UNICODE_BOM:
                 /* ignore */
                 break;
-            case exports.TokenType.TAG_OPEN:
+            case TokenType.TAG_OPEN:
                 this.consumeTag(source, token, tokenStream);
                 break;
-            case exports.TokenType.WHITESPACE:
+            case TokenType.WHITESPACE:
                 this.trigger("whitespace", {
                     text: token.data[0],
                     location: token.location,
                 });
                 this.appendText(token.data[0], token.location);
                 break;
-            case exports.TokenType.DIRECTIVE:
+            case TokenType.DIRECTIVE:
                 this.consumeDirective(token);
                 break;
-            case exports.TokenType.CONDITIONAL:
+            case TokenType.CONDITIONAL:
                 this.consumeConditional(token);
                 break;
-            case exports.TokenType.COMMENT:
+            case TokenType.COMMENT:
                 this.consumeComment(token);
                 break;
-            case exports.TokenType.DOCTYPE_OPEN:
+            case TokenType.DOCTYPE_OPEN:
                 this.consumeDoctype(token, tokenStream);
                 break;
-            case exports.TokenType.TEXT:
-            case exports.TokenType.TEMPLATING:
+            case TokenType.TEXT:
+            case TokenType.TEMPLATING:
                 this.appendText(token.data[0], token.location);
                 break;
-            case exports.TokenType.EOF:
+            case TokenType.EOF:
                 this.closeTree(source, token.location);
                 break;
         }
     }
     /* eslint-disable-next-line complexity, sonarjs/cognitive-complexity */
     consumeTag(source, startToken, tokenStream) {
-        const tokens = Array.from(this.consumeUntil(tokenStream, exports.TokenType.TAG_CLOSE, startToken.location));
+        const tokens = Array.from(this.consumeUntil(tokenStream, TokenType.TAG_CLOSE, startToken.location));
         const endToken = tokens.slice(-1)[0];
         const closeOptional = this.closeOptional(startToken);
         const parent = closeOptional ? this.dom.getActive().parent : this.dom.getActive();
@@ -10827,9 +10859,9 @@ class Parser {
         for (let i = 0; i < tokens.length; i++) {
             const token = tokens[i];
             switch (token.type) {
-                case exports.TokenType.WHITESPACE:
+                case TokenType.WHITESPACE:
                     break;
-                case exports.TokenType.ATTR_NAME:
+                case TokenType.ATTR_NAME:
                     this.consumeAttribute(source, node, token, tokens[i + 1]);
                     break;
             }
@@ -10907,7 +10939,7 @@ class Parser {
         let endToken;
         do {
             /* search for tags */
-            const tokens = Array.from(this.consumeUntil(tokenStream, exports.TokenType.TAG_OPEN, errorLocation));
+            const tokens = Array.from(this.consumeUntil(tokenStream, TokenType.TAG_OPEN, errorLocation));
             const [last] = tokens.slice(-1);
             const [, tagClosed, tagName] = last.data;
             /* special case: svg <title> and <desc> should be intact as it affects accessibility */
@@ -10924,7 +10956,7 @@ class Parser {
                 continue;
             }
             /* locate end token and determine if this is a self-closed tag */
-            const endTokens = Array.from(this.consumeUntil(tokenStream, exports.TokenType.TAG_CLOSE, last.location));
+            const endTokens = Array.from(this.consumeUntil(tokenStream, TokenType.TAG_CLOSE, last.location));
             endToken = endTokens.slice(-1)[0];
             const selfClosed = endToken.data[0] === "/>";
             /* since foreign element may be nested keep a count for the number of
@@ -11010,7 +11042,7 @@ class Parser {
      *      ^^^          ^^^         ^^^    (null)   (null)
      */
     getAttributeValueLocation(token) {
-        if (!token || token.type !== exports.TokenType.ATTR_VALUE || token.data[2] === "") {
+        if (!token || token.type !== TokenType.ATTR_VALUE || token.data[2] === "") {
             return null;
         }
         const quote = token.data[3];
@@ -11028,7 +11060,7 @@ class Parser {
     getAttributeLocation(key, value) {
         var _a;
         const begin = key.location;
-        const end = value && value.type === exports.TokenType.ATTR_VALUE ? value.location : undefined;
+        const end = value && value.type === TokenType.ATTR_VALUE ? value.location : undefined;
         return {
             filename: begin.filename,
             line: begin.line,
@@ -11089,7 +11121,7 @@ class Parser {
      * Consumes doctype tokens. Emits doctype event.
      */
     consumeDoctype(startToken, tokenStream) {
-        const tokens = Array.from(this.consumeUntil(tokenStream, exports.TokenType.DOCTYPE_CLOSE, startToken.location));
+        const tokens = Array.from(this.consumeUntil(tokenStream, TokenType.DOCTYPE_CLOSE, startToken.location));
         /* first token is the doctype, second is the closing ">" */
         const doctype = tokens[0];
         const value = doctype.data[0];
@@ -11115,7 +11147,7 @@ class Parser {
                 return;
             it = this.next(tokenStream);
         }
-        throw new ParserError(errorLocation, `stream ended before ${exports.TokenType[search]} token was found`);
+        throw new ParserError(errorLocation, `stream ended before ${TokenType[search]} token was found`);
     }
     /**
      * Consumes tokens until a matching close-tag is found. Tags are appended to
@@ -11129,7 +11161,7 @@ class Parser {
         while (!it.done) {
             const token = it.value;
             this.consume(source, token, tokenStream);
-            if (token.type === exports.TokenType.TAG_OPEN) {
+            if (token.type === TokenType.TAG_OPEN) {
                 const [, close, tagName] = token.data;
                 if (tagName === searchTag) {
                     if (close) {
@@ -11202,6 +11234,12 @@ class Parser {
     }
 }
 
+function freeze(src) {
+    return {
+        ...src,
+        selector: src.selector(),
+    };
+}
 /**
  * @internal
  */
@@ -11253,7 +11291,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,
         });
     }
@@ -11267,7 +11307,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,
@@ -11420,7 +11460,7 @@ class Engine {
             for (const token of lexer.tokenize(src)) {
                 const data = (_a = token.data[0]) !== null && _a !== void 0 ? _a : "";
                 lines.push({
-                    token: exports.TokenType[token.type],
+                    token: TokenType[token.type],
                     data,
                     location: `${token.location.filename}:${token.location.line}:${token.location.column}`,
                 });
@@ -11669,7 +11709,7 @@ class Engine {
             line: location.line,
             column: location.column,
             size: location.size || 0,
-            selector: null,
+            selector: () => null,
         });
     }
 }
@@ -12192,6 +12232,7 @@ const formatter$4 = checkstyleFormatter;
 const defaults = {
     showLink: true,
     showSummary: true,
+    showSelector: false,
 };
 /**
  * Codeframe formatter based on ESLint codeframe.
@@ -12247,6 +12288,7 @@ function getEndLocation(message, source) {
  * @returns The formatted output.
  */
 function formatMessage(message, parentResult, options) {
+    var _a;
     const type = message.severity === 2 ? kleur__default["default"].red("error") : kleur__default["default"].yellow("warning");
     const msg = `${kleur__default["default"].bold(message.message.replace(/([^ ])\.$/, "$1"))}`;
     const ruleId = kleur__default["default"].dim(`(${message.ruleId})`);
@@ -12269,6 +12311,9 @@ function formatMessage(message, parentResult, options) {
             end: getEndLocation(message, sourceCode),
         }, { highlightCode: false }));
     }
+    if (options.showSelector) {
+        result.push(`${kleur__default["default"].bold("Selector:")} ${(_a = message.selector) !== null && _a !== void 0 ? _a : "-"}`);
+    }
     if (options.showLink && message.ruleUrl) {
         result.push(`${kleur__default["default"].bold("Details:")} ${message.ruleUrl}`);
     }
@@ -12410,6 +12455,7 @@ exports.TemplateExtractor = TemplateExtractor;
 exports.TextNode = TextNode;
 exports.UserError = UserError;
 exports.bugs = bugs;
+exports.codeframe = codeframe;
 exports.compatibilityCheck = compatibilityCheck;
 exports.getFormatter = getFormatter;
 exports.legacyRequire = legacyRequire;