BREAKING CHANGE: NodeJS v22 or later is now required.

BREAKING CHANGES: Support for Jest v28 has been removed, if you use Jest with
HTML-Validate make sure to use v29 or later.

BREAKING CHANGES: Support for Vitest v1 and v2 has been removed, if you use
Vitest with HTML-Validate make sure to use v3 or later.

BREAKING CHANGE: This API was never meant for public consumption and has now
been removed from the public API surface. If you need this API file an issue
describing your use-case. There is no replacement API.

BREAKING CHANGE: The deprecated alias `nodejsResolver` has been removed. Use
`cjsResolver` instead.

BREAKING CHANGE: The deprecated `DOMTree.visitDepthFirst()` method has been
removed and is replaced by the `walk.depthFirst()` helper.

BREAKING CHANGE: The deprecated `DOMTree.find()` method has been removed and is
replaced by `DOMTree.querySelector()`.

(actually only hides it from the public api surface here as the vscode extension
still have to support both versions until v8.x is EOL, at which point we can
remove the method entirely)

BREAKING CHANGE: The deprecated `HtmlValidate.getRuleDocumentation()` and
`HtmlValidate.getRuleDocumentationSync()` methods has been removed and is
replaced with `HtmlValidate.getContextualDocumentation()` and
`HtmlValidate.getContextualDocumentationSync()`.

BREAKING CHANGE: The deprecated `implicitRole` meta property has been removed
and is replaced by `aria.implicitRole`. If you are using this property in your
custom element metadata update it with the new property:

```diff
-implicitRole: "button",
+aria: {
+  implicitRole: "button",
+}
```

BREAKING CHANGE: Remove support for unwrapped regular expressions as strings for pattern
rules. If you have configured one of the affected rules with a regular
expressing not wrapped with forward slashes `/` you need to wrap them. If you
passed in a named pattern or a `RegExp` object you do not have to change anything.

The affected rules are:

- `class-pattern`
- `id-pattern`
- `name-pattern`

```diff
 {
   "id-pattern": ["error", {
-    "pattern": ["foo-.+"]
+    "pattern": ["/foo-.+/"]
   }]
 }
```

BREAKING CHANGE: If you used the `NodeType` enum it has been replaced with
constants in a new `Node` object. This better mimics the DOM API.

```diff
-if (child.nodeType === NodeType.ELEMENT_NODE) {
+if (child.nodeType === Node.ELEMENT_NODE) {
```

BREAKING CHANGE: If you used the `NodeClosed` enum it has been replaced with
constants in a new `Node` object.

```diff
-if (node.nodeClosed === NodeClosed.EndTag) {
+if (child.nodeType === Node.CLOSED_END_TAG) {
```

breaking changes for v11

See merge request !1337

David Sveningsson authored May 11, 2026 and HTML-validate committed May 11, 2026

## 11.0.0 (2026-05-11)

### ⚠️ BREAKING CHANGES

* **api:** If you used the `NodeClosed` enum it has been replaced with
constants in a new `Node` object.

```diff
-if (node.nodeClosed === NodeClosed.EndTag) {
+if (child.nodeType === Node.CLOSED_END_TAG) {
```
* **api:** If you used the `NodeType` enum it has been replaced with
constants in a new `Node` object. This better mimics the DOM API.

```diff
-if (child.nodeType === NodeType.ELEMENT_NODE) {
+if (child.nodeType === Node.ELEMENT_NODE) {
```
* **config:** Remove support for unwrapped regular expressions as strings for pattern
rules. If you have configured one of the affected rules with a regular
expressing not wrapped with forward slashes `/` you need to wrap them. If you
passed in a named pattern or a `RegExp` object you do not have to change anything.

The affected rules are:

- `class-pattern`
- `id-pattern`
- `name-pattern`

```diff
 {
   "id-pattern": ["error", {
-    "pattern": ["foo-.+"]
+    "pattern": ["/foo-.+/"]
   }]
 }
```
* **meta:** The deprecated `implicitRole` meta property has been removed
and is replaced by `aria.implicitRole`. If you are using this property in your
custom element metadata update it with the new property:

```diff
-implicitRole: "button",
+aria: {
+  implicitRole: "button",
+}
```
* **api:** The deprecated `HtmlValidate.getRuleDocumentation()` and
`HtmlValidate.getRuleDocumentationSync()` methods has been removed and is
replaced with `HtmlValidate.getContextualDocumentation()` and
`HtmlValidate.getContextualDocumentationSync()`.
* **api:** The deprecated `DOMTree.find()` method has been removed and is
replaced by `DOMTree.querySelector()`.
* **api:** The deprecated `DOMTree.visitDepthFirst()` method has been
removed and is replaced by the `walk.depthFirst()` helper.
* **api:** The deprecated alias `nodejsResolver` has been removed. Use
`cjsResolver` instead.
* **api:** This API was never meant for public consumption and has now
been removed from the public API surface. If you need this API file an issue
describing your use-case. There is no replacement API.
* **deps:** drop support for vitest v1 and v2
* **deps:** drop support for jest v28
* **deps:** NodeJS v22 or later is now required.

### Features

* **api:** remove deprecated `DOMTree.find()` ([4451453a](4451453a))
* **api:** remove deprecated `DOMTree.visitDepthFirst()` ([b06710bd](b06710bd))
* **api:** remove deprecated `HtmlValidate.getRuleDocumentation()` method ([f5343c36](f5343c36))
* **api:** remove deprecated `nodejsResolver` alias ([ecacb8a5](ecacb8a5))
* **api:** replace `NodeClosed` enum with constants ([de55ed91](de55ed91))
* **api:** replace `NodeType` enum with named constants ([d33419cb](d33419cb))
* **api:** the `Validator` class is no longer exported ([f14de279](f14de279))
* **config:** remove support for raw custom pattern regex ([692d0747](692d0747))
* **deps:** drop support for jest v28 ([b1d9b0ee](b1d9b0ee))
* **deps:** drop support for vitest v1 and v2 ([29498638](29498638))
* **deps:** require nodejs v22 or later ([e16c27f4](e16c27f4))
* **meta:** remove deprecated `implicitRole` property ([63689b57](63689b57))

Signed-off-by: HTML-validate <gitlab@html-validate.org>

chore(deps): update dependency npm-pkg-lint to v5

See merge request !1336

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

feat(deps): replace dependency `glob` with native function

See merge request !1339

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

feat(deps): update dependency @html-validate/stylish to v6

See merge request !1340

Signed-off-by: HTML-validate <gitlab@html-validate.org>

feat(deps): update dependency @sidvind/better-ajv-errors to v6

See merge request html-validate/html-validate!1341

feat(deps): replace dependency `minimist` with native function

See merge request html-validate/html-validate!1342

David Sveningsson authored May 12, 2026 and HTML-validate committed May 12, 2026

## 11.1.0 (2026-05-12)

### Features

* **deps:** replace dependency `glob` with native function ([5a2be0d1](html-validate/html-validate@5a2be0d1))
* **deps:** replace dependency `minimist` with native function ([cfe3a57b](html-validate/html-validate@cfe3a57b))
* **deps:** update dependency @html-validate/stylish to v6 ([a8f6df1d](html-validate/html-validate@a8f6df1d))
* **deps:** update dependency @sidvind/better-ajv-errors to v6 ([1aca06cb](html-validate/html-validate@1aca06cb))

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

chore(deps): update dependency dgeni-front-matter to v6

See merge request html-validate/html-validate!1343

Signed-off-by: HTML-validate <gitlab@html-validate.org>

feat(deps): update dependency @sidvind/better-ajv-errors to v7

See merge request html-validate/html-validate!1344

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

separate jest internal matchers from the rest

See merge request html-validate/html-validate!1345

Signed-off-by: HTML-validate <gitlab@html-validate.org>

Signed-off-by: HTML-validate <gitlab@html-validate.org>

this was needed for backwards compatibility but now that all supported jest
versions have this we can simplify the implementation.

refactor: use `this.utils.diff()` directly instead of importing `diff()`

See merge request html-validate/html-validate!1346

refactor: fully detach vitest matchers from jest code

See merge request html-validate/html-validate!1347

feat(vitest): add `toMatchCodeframe()` and `toMatchInlineCodeframe()` matchers

See merge request html-validate/html-validate!1348

David Sveningsson authored May 17, 2026 and HTML-validate committed May 17, 2026

## 11.2.0 (2026-05-17)

### Features

* **deps:** update dependency @sidvind/better-ajv-errors to v7 ([a6f42426](a6f42426))
* **vitest:** add `toMatchCodeframe()` and `toMatchInlineCodeframe()` matchers ([5153c126](5153c126))